TAI42 — the OS for AI tools

Manage preset tools and their versions.

$ tai presets [OPTIONS] COMMAND [ARGS]...

`tai presets create`

Create a versioned preset (or an authored agent, when the base tool is an agent). Example: tai presets create greet --base-tool echo --description 'Greet a user' --kwargs '{"prefix":"hi"}' Example: tai presets create g --base-tool echo --description d --input-schema-file s.json --input-map-file m.jq

$ tai presets create [OPTIONS] {name}

Argument	Description
`name`	Preset name. (required)

Option	Description
`--base-tool` `<str>`	The registered non-preset tool the preset wraps. (required)
`--description` `<str>`	The preset’s LLM-facing description (required, non-empty). (required)
`--kwargs` `<str>`	Baked fixed kwargs as a JSON object. A string value written ’!ENV ${VAR}’ is a secret reference the server resolves from that environment variable at run time, storing only the reference.
`--kwargs-file` `<str>`	Read the fixed kwargs JSON object from a file, or from stdin when the path is ’-’, instead of putting a secret on the command line (a value on argv leaks via ps and shell history). Mutually exclusive with —kwargs.
`--extensions` `<str>`	Extension combos as a JSON array of combos. Each combo is a non-empty array of elements, and an element is an extension name (‘“chain”’) or a {“name”,“config”} object binding config to it (e.g. ’[[{“name”:“output_schema”,“config”:{“schema”:{“type”:“object”}}}]]’).
`--output-schema` `<str>`	A JSON Schema object, or a template reference object.
`--output-schema-file` `<str>`	Read the JSON object from a file, or from stdin when the path is ’-’.
`--input-schema` `<str>`	A JSON Schema object, or a template reference object.
`--input-schema-file` `<str>`	Read the JSON object from a file, or from stdin when the path is ’-’.
`--state-binding` `<str>`	The preset’s state binding as a JSON object: {“states”: […]}.
`--state-binding-file` `<str>`	Read the JSON object from a file, or from stdin when the path is ’-’.
`--input-map` `<str>`	A jq program that turns the caller’s input (.) into the base tool’s arguments; $fixed holds the preset’s fixed kwargs. Needs —input-schema.
`--input-map-file` `<str>`	Read the program text from a file, or from stdin when the path is ’-’.
`--input-map-template` `<str>`	The program as a template object (JSON), e.g. {“id”: ”…”, “kwargs”: {}}.
`--output-map` `<str>`	A jq program that reshapes the base tool’s result (.) before the output schema is checked.
`--output-map-file` `<str>`	Read the program text from a file, or from stdin when the path is ’-’.
`--output-map-template` `<str>`	The program as a template object (JSON), e.g. {“id”: ”…”, “kwargs”: {}}.
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai presets delete`

Delete a preset. Example: tai presets delete my_preset

$ tai presets delete [OPTIONS] {name}

Argument	Description
`name`	Preset name. (required)

Option	Description
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai presets get`

Get a store-backed preset’s record and active body. Example: tai presets get my_preset

$ tai presets get [OPTIONS] {name}

Argument	Description
`name`	Preset name. (required)

Option	Description
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai presets get-version`

Get a specific preset version. Example: tai presets get-version my_preset 3

$ tai presets get-version [OPTIONS] {name} {version}

Argument	Description
`name`	Preset name. (required)
`version`	Version number. (required)

Option	Description
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai presets list`

List the store-backed (versioned) presets. Example: tai presets list

$ tai presets list [OPTIONS]

Option	Description
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai presets referees`

List what holds this preset: everything the given action would strand, one per row. Example: tai presets referees my_preset --action rename

$ tai presets referees [OPTIONS] {name}

Argument	Description
`name`	Preset name. (required)

Option	Description
`--action` `<rename\|delete>`	The action to preview: rename or delete. (required)
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai presets rename`

Rename a preset — its name is its live tool name, so the tool is rebound. Example: tai presets rename old_name new_name

$ tai presets rename [OPTIONS] {name} {new_name}

Argument	Description
`name`	Current preset name. (required)
`new_name`	New preset name. (required)

Option	Description
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai presets rollback`

Roll a preset back to a prior version. Example: tai presets rollback my_preset 2

$ tai presets rollback [OPTIONS] {name} {version}

Argument	Description
`name`	Preset name. (required)
`version`	Target version to make active. (required)

Option	Description
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai presets save-version`

Save a new preset version. Omitted fields carry forward; --extensions '[]' sends the explicit clear sentinel and each --clear-* option sends its field as null. Example: tai presets save-version my_preset --kwargs '{"n":2}' Example: tai presets save-version greet --output-schema-file schema.json --clear-output-map

$ tai presets save-version [OPTIONS] {name}

Argument	Description
`name`	Preset name. (required)

Option	Description
`--kwargs` `<str>`	New fixed kwargs (JSON object); omit to carry forward. A string value written ’!ENV ${VAR}’ is a secret reference the server resolves from that environment variable at run time, storing only the reference.
`--kwargs-file` `<str>`	Read the fixed kwargs JSON object from a file, or from stdin when the path is ’-’, instead of putting a secret on the command line (a value on argv leaks via ps and shell history). Mutually exclusive with —kwargs.
`--description` `<str>`	New description (non-empty); omit to carry the active one forward.
`--extensions` `<str>`	Extension combos as a JSON array of combos. Each combo is a non-empty array of elements, and an element is an extension name (‘“chain”’) or a {“name”,“config”} object binding config to it (e.g. ’[[{“name”:“output_schema”,“config”:{“schema”:{“type”:“object”}}}]]’). ’[]’ clears them.
`--output-schema` `<str>`	A JSON Schema object, or a template reference object.
`--output-schema-file` `<str>`	Read the JSON object from a file, or from stdin when the path is ’-’.
`--input-schema` `<str>`	A JSON Schema object, or a template reference object.
`--input-schema-file` `<str>`	Read the JSON object from a file, or from stdin when the path is ’-’.
`--state-binding` `<str>`	The preset’s state binding as a JSON object: {“states”: […]}.
`--state-binding-file` `<str>`	Read the JSON object from a file, or from stdin when the path is ’-’.
`--input-map` `<str>`	A jq program that turns the caller’s input (.) into the base tool’s arguments; $fixed holds the preset’s fixed kwargs. Needs —input-schema.
`--input-map-file` `<str>`	Read the program text from a file, or from stdin when the path is ’-’.
`--input-map-template` `<str>`	The program as a template object (JSON), e.g. {“id”: ”…”, “kwargs”: {}}.
`--output-map` `<str>`	A jq program that reshapes the base tool’s result (.) before the output schema is checked.
`--output-map-file` `<str>`	Read the program text from a file, or from stdin when the path is ’-’.
`--output-map-template` `<str>`	The program as a template object (JSON), e.g. {“id”: ”…”, “kwargs”: {}}.
`--clear-output-schema`	Remove the field on this version (sent as null). (default: `False`)
`--clear-input-schema`	Remove the field on this version (sent as null). (default: `False`)
`--clear-state-binding`	Remove the field on this version (sent as null). (default: `False`)
`--clear-input-map`	Remove the field on this version (sent as null). (default: `False`)
`--clear-output-map`	Remove the field on this version (sent as null). (default: `False`)
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai presets set-version-tags`

Replace a preset version’s tags (labels only — no rebind). Zero tag arguments clears them to []. Example: tai presets set-version-tags my_preset 2 stable reviewed

$ tai presets set-version-tags [OPTIONS] {name} {version} [tags]...

Argument	Description
`name`	Preset name. (required)
`version`	Version number. (required)
`tags...`	The tags to set; none clears them to []. (optional)

Option	Description
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai presets validate`

Dry-run a preset draft without writing anything. Reports whether it would be accepted as a create (a new name) or a new version (an existing name). On an existing name each --clear-* option checks the draft with that field removed. Example: tai presets validate greet --base-tool echo --description 'Greet' --kwargs '{"prefix":"hi"}' Example: tai presets validate greet --output-map '{answer: .}' --clear-input-map

$ tai presets validate [OPTIONS] {name}

Argument	Description
`name`	Preset name. (required)

Option	Description
`--base-tool` `<str>`	The base tool (required for a new preset).
`--kwargs` `<str>`	Baked fixed kwargs as a JSON object. A string value written ’!ENV ${VAR}’ is a secret reference the server resolves from that environment variable at run time, storing only the reference.
`--kwargs-file` `<str>`	Read the fixed kwargs JSON object from a file, or from stdin when the path is ’-’, instead of putting a secret on the command line (a value on argv leaks via ps and shell history). Mutually exclusive with —kwargs.
`--description` `<str>`	The preset’s LLM-facing description.
`--extensions` `<str>`	Extension combos as a JSON array of combos. Each combo is a non-empty array of elements, and an element is an extension name (‘“chain”’) or a {“name”,“config”} object binding config to it (e.g. ’[[{“name”:“output_schema”,“config”:{“schema”:{“type”:“object”}}}]]’).
`--output-schema` `<str>`	A JSON Schema object, or a template reference object.
`--output-schema-file` `<str>`	Read the JSON object from a file, or from stdin when the path is ’-’.
`--input-schema` `<str>`	A JSON Schema object, or a template reference object.
`--input-schema-file` `<str>`	Read the JSON object from a file, or from stdin when the path is ’-’.
`--state-binding` `<str>`	The preset’s state binding as a JSON object: {“states”: […]}.
`--state-binding-file` `<str>`	Read the JSON object from a file, or from stdin when the path is ’-’.
`--input-map` `<str>`	A jq program that turns the caller’s input (.) into the base tool’s arguments; $fixed holds the preset’s fixed kwargs. Needs —input-schema.
`--input-map-file` `<str>`	Read the program text from a file, or from stdin when the path is ’-’.
`--input-map-template` `<str>`	The program as a template object (JSON), e.g. {“id”: ”…”, “kwargs”: {}}.
`--output-map` `<str>`	A jq program that reshapes the base tool’s result (.) before the output schema is checked.
`--output-map-file` `<str>`	Read the program text from a file, or from stdin when the path is ’-’.
`--output-map-template` `<str>`	The program as a template object (JSON), e.g. {“id”: ”…”, “kwargs”: {}}.
`--clear-output-schema`	Remove the field on this version (sent as null). (default: `False`)
`--clear-input-schema`	Remove the field on this version (sent as null). (default: `False`)
`--clear-state-binding`	Remove the field on this version (sent as null). (default: `False`)
`--clear-input-map`	Remove the field on this version (sent as null). (default: `False`)
`--clear-output-map`	Remove the field on this version (sent as null). (default: `False`)
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai presets versions`

List a preset’s version history. Example: tai presets versions my_preset

$ tai presets versions [OPTIONS] {name}

Argument	Description
`name`	Preset name. (required)

Option	Description
`--json` / `--no-json`	Emit raw JSON instead of human tables.

HTTP API

CLI

Settings

Capability map

Conversation bridge

Python SDK

Studio SDK

tai presets

`tai presets create`

`tai presets delete`

`tai presets get`

`tai presets get-version`

`tai presets list`

`tai presets referees`

`tai presets rename`

`tai presets rollback`

`tai presets save-version`

`tai presets set-version-tags`

`tai presets validate`

`tai presets versions`

​tai presets create

​tai presets delete

​tai presets get

​tai presets get-version

​tai presets list

​tai presets referees

​tai presets rename

​tai presets rollback

​tai presets save-version

​tai presets set-version-tags

​tai presets validate

​tai presets versions

`tai presets create`

`tai presets delete`

`tai presets get`

`tai presets get-version`

`tai presets list`

`tai presets referees`

`tai presets rename`

`tai presets rollback`

`tai presets save-version`

`tai presets set-version-tags`

`tai presets validate`

`tai presets versions`