inputs:
  text/email:
    required@bool: yes
    default: you@example.com
    type: email

required:

default:

description:

A sentence describing what the value is for.

This is what an AI agent reads when the automation answers an agent tool, since an agent.tool script's inputs: block is the schema the model is shown.

allowed_values:

A list restricting the input to a fixed set of values.

inputs:
  text/priority:
    description: How urgent the request is
    required@bool: yes
    allowed_values@list:
      low
      normal
      high

type: