TAI42 — the OS for AI tools

Manage the subject-keyed state store.

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

`tai states apply`

Apply an ordered op batch to a subject’s document.

$ tai states apply [OPTIONS] {name}

Argument	Description
`name`	The state name. (required)

Option	Description
`--target-kind` `<str>`	The subject’s conversation-target kind (agent/tool). (required)
`--target-name` `<str>`	The subject’s conversation-target name. (required)
`--kind` `<str>`	The subject kind (e.g. person, thread). (required)
`--key` `<str>`	The subject key within its kind. (required)
`--data` `<str>`	A JSON array of ops (or {ops, op_id}).
`--file` `<path>`	A file holding the ops JSON.
`--op-id` `<str>`	An idempotency key for the batch.
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai states attach`

Attach a template on a state at a path with its parameters and declarations.

$ tai states attach [OPTIONS] {name} {template}

Argument	Description
`name`	The state name. (required)
`template`	The template name. (required)

Option	Description
`--data` `<str>`	The attach body JSON (path/parameters/declarations).
`--file` `<path>`	A file holding the attach body JSON.
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai states attachment-referees`

List what still binds a template on a state: everything a detach would strand, one per row.

$ tai states attachment-referees [OPTIONS] {name} {template}

Argument	Description
`name`	The state name. (required)
`template`	The template name. (required)

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

`tai states attachments`

List the templates attached on a state.

$ tai states attachments [OPTIONS] {name}

Argument	Description
`name`	The state name. (required)

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

`tai states check`

Page a state’s stored records that do not fit its current effective schema.

$ tai states check [OPTIONS] {name}

Argument	Description
`name`	The state name. (required)

Option	Description
`--kind` `<str>`	Restrict to one subject kind.
`--limit` `<int>`	Page size.
`--cursor` `<str>`	A keyset cursor from a prior page.
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai states consumers`

List everything that binds a state — hooks, schedules, agents, presets and plugin consumers.

$ tai states consumers [OPTIONS] {name}

Argument	Description
`name`	The state name. (required)

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

`tai states delete`

Delete a state with its records, attachments and aliases.

$ tai states delete [OPTIONS] {name}

Argument	Description
`name`	The state name. (required)

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

`tai states detach`

Detach a template from a state.

$ tai states detach [OPTIONS] {name} {template}

Argument	Description
`name`	The state name. (required)
`template`	The template name. (required)

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

`tai states erase`

Erase a subject’s record.

$ tai states erase [OPTIONS] {name}

Argument	Description
`name`	The state name. (required)

Option	Description
`--target-kind` `<str>`	The subject’s conversation-target kind (agent/tool). (required)
`--target-name` `<str>`	The subject’s conversation-target name. (required)
`--kind` `<str>`	The subject kind (e.g. person, thread). (required)
`--key` `<str>`	The subject key within its kind. (required)
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai states fold`

Fold this subject’s record into another canonical subject.

$ tai states fold [OPTIONS] {name}

Argument	Description
`name`	The state name. (required)

Option	Description
`--target-kind` `<str>`	The subject’s conversation-target kind (agent/tool). (required)
`--target-name` `<str>`	The subject’s conversation-target name. (required)
`--kind` `<str>`	The subject kind (e.g. person, thread). (required)
`--key` `<str>`	The subject key within its kind. (required)
`--into` `<str>`	The canonical subject JSON {target_kind,target_name,kind,key}. (required)
`--mode` `<str>`	The fold mode. (required)
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai states get`

Show a state’s declaration, effective schema, attachments and regimes.

$ tai states get [OPTIONS] {name}

Argument	Description
`name`	The state name. (required)

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

`tai states get-attachment`

Read one template’s attachment on a state (404 when it is not attached).

$ tai states get-attachment [OPTIONS] {name} {template}

Argument	Description
`name`	The state name. (required)
`template`	The template name. (required)

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

`tai states list`

List every declared state.

$ tai states list [OPTIONS]

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

`tai states merge`

Shallow-merge a patch into a subject’s document.

$ tai states merge [OPTIONS] {name}

Argument	Description
`name`	The state name. (required)

Option	Description
`--target-kind` `<str>`	The subject’s conversation-target kind (agent/tool). (required)
`--target-name` `<str>`	The subject’s conversation-target name. (required)
`--kind` `<str>`	The subject kind (e.g. person, thread). (required)
`--key` `<str>`	The subject key within its kind. (required)
`--data` `<str>`	The patch JSON.
`--file` `<path>`	A file holding the patch JSON.
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai states pending-saves`

List, retry or discard pending state saves.

$ tai states pending-saves [OPTIONS] COMMAND [ARGS]...

`tai states pending-saves discard`

Discard a failed pending save for good, releasing its subjects.

$ tai states pending-saves discard [OPTIONS] {ID}

Argument	Description
`ID`	The failed pending save’s id. (required)

Option	Description
`--yes`	Confirm: its writes and calls are never applied. (default: `False`)
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai states pending-saves list`

List the outstanding pending state saves, newest first.

$ tai states pending-saves list [OPTIONS]

Option	Description
`--status` `<str>`	’outstanding’ (every save) or ‘failed’ (the failed ones).
`--limit` `<int>`	Page size.
`--cursor` `<str>`	A keyset cursor from a prior page.
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai states pending-saves retry`

Retry a failed pending save: requeue it and apply its records now.

$ tai states pending-saves retry [OPTIONS] {ID}

Argument	Description
`ID`	The failed pending save’s id. (required)

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

`tai states prune`

Prune every record past its state’s retention horizon.

$ tai states prune [OPTIONS]

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

`tai states put`

Create or re-declare a state from a declaration document.

$ tai states put [OPTIONS] {name}

Argument	Description
`name`	The state name. (required)

Option	Description
`--data` `<str>`	The declaration JSON object.
`--file` `<path>`	A file holding the declaration JSON.
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai states read`

Read a subject’s record (null when none exists).

$ tai states read [OPTIONS] {name}

Argument	Description
`name`	The state name. (required)

Option	Description
`--target-kind` `<str>`	The subject’s conversation-target kind (agent/tool). (required)
`--target-name` `<str>`	The subject’s conversation-target name. (required)
`--kind` `<str>`	The subject kind (e.g. person, thread). (required)
`--key` `<str>`	The subject key within its kind. (required)
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai states replace`

Replace a subject’s whole document.

$ tai states replace [OPTIONS] {name}

Argument	Description
`name`	The state name. (required)

Option	Description
`--target-kind` `<str>`	The subject’s conversation-target kind (agent/tool). (required)
`--target-name` `<str>`	The subject’s conversation-target name. (required)
`--kind` `<str>`	The subject kind (e.g. person, thread). (required)
`--key` `<str>`	The subject key within its kind. (required)
`--data` `<str>`	The document JSON.
`--file` `<path>`	A file holding the document JSON.
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai states search`

Search a state’s records by document containment.

$ tai states search [OPTIONS] {name}

Argument	Description
`name`	The state name. (required)

Option	Description
`--filters` `<str>`	A JSON object the record document must contain. (required)
`--limit` `<int>`	Page size.
`--cursor` `<str>`	A keyset cursor from a prior page.
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai states stats`

Show a state’s record counts (total and per subject kind).

$ tai states stats [OPTIONS] {name}

Argument	Description
`name`	The state name. (required)

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

`tai states subjects`

Page the subjects holding a record for a state.

$ tai states subjects [OPTIONS] {name}

Argument	Description
`name`	The state name. (required)

Option	Description
`--kind` `<str>`	Restrict to one subject kind.
`--limit` `<int>`	Page size.
`--cursor` `<str>`	A keyset cursor from a prior page.
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai states template-jq`

Evaluate/apply a state’s template_jq programs.

$ tai states template-jq [OPTIONS] COMMAND [ARGS]...

`tai states template-jq apply`

Apply an update-purpose template_jq program to a subject’s record.

$ tai states template-jq apply [OPTIONS] {name} {program}

Argument	Description
`name`	The state name. (required)
`program`	The template_jq program name (or <template>.<name>). (required)

Option	Description
`--target-kind` `<str>`	The subject’s conversation-target kind (agent/tool). (required)
`--target-name` `<str>`	The subject’s conversation-target name. (required)
`--kind` `<str>`	The subject kind (e.g. person, thread). (required)
`--key` `<str>`	The subject key within its kind. (required)
`--input` `<str>`	The program’s input as JSON, or @<file> to read it from a file.
`--op-id` `<str>`	An idempotency key for the apply.
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai states template-jq eval`

Evaluate an input-purpose template_jq program for a subject.

$ tai states template-jq eval [OPTIONS] {name} {program}

Argument	Description
`name`	The state name. (required)
`program`	The template_jq program name (or <template>.<name>). (required)

Option	Description
`--target-kind` `<str>`	The subject’s conversation-target kind (agent/tool). (required)
`--target-name` `<str>`	The subject’s conversation-target name. (required)
`--kind` `<str>`	The subject kind (e.g. person, thread). (required)
`--key` `<str>`	The subject key within its kind. (required)
`--param` `<str>`	An input-program parameter as key=<json> (repeatable).
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai states update-attachment`

Replace an attachment’s static declaration values, with optional reconcile options.

$ tai states update-attachment [OPTIONS] {name} {template}

Argument	Description
`name`	The state name. (required)
`template`	The template name. (required)

Option	Description
`--declarations` `<str>`	The attachment declaration values JSON object. (required)
`--options` `<str>`	The reconcile options JSON object passed to attach reconcilers.
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai states validate`

Check a candidate document against a state’s effective schema without storing it.

$ tai states validate [OPTIONS] {name}

Argument	Description
`name`	The state name. (required)

Option	Description
`--data` `<str>`	The candidate document JSON.
`--file` `<path>`	A file holding the candidate document JSON.
`--json` / `--no-json`	Emit raw JSON instead of human tables.

`tai states writes`

Page a subject’s write audit trail.

$ tai states writes [OPTIONS] {name}

Argument	Description
`name`	The state name. (required)

Option	Description
`--target-kind` `<str>`	The subject’s conversation-target kind (agent/tool). (required)
`--target-name` `<str>`	The subject’s conversation-target name. (required)
`--kind` `<str>`	The subject kind (e.g. person, thread). (required)
`--key` `<str>`	The subject key within its kind. (required)
`--limit` `<int>`	Page size.
`--cursor` `<str>`	A keyset cursor from a prior page.
`--json` / `--no-json`	Emit raw JSON instead of human tables.

HTTP API

CLI

Settings

Capability map

Conversation bridge

Python SDK

Studio SDK

tai states

`tai states apply`

`tai states attach`

`tai states attachment-referees`

`tai states attachments`

`tai states check`

`tai states consumers`

`tai states delete`

`tai states detach`

`tai states erase`

`tai states fold`

`tai states get`

`tai states get-attachment`

`tai states list`

`tai states merge`

`tai states pending-saves`

`tai states pending-saves discard`

`tai states pending-saves list`

`tai states pending-saves retry`

`tai states prune`

`tai states put`

`tai states read`

`tai states replace`

`tai states search`

`tai states stats`

`tai states subjects`

`tai states template-jq`

`tai states template-jq apply`

`tai states template-jq eval`

`tai states update-attachment`

`tai states validate`

`tai states writes`

​tai states apply

​tai states attach

​tai states attachment-referees

​tai states attachments

​tai states check

​tai states consumers

​tai states delete

​tai states detach

​tai states erase

​tai states fold

​tai states get

​tai states get-attachment

​tai states list

​tai states merge

​tai states pending-saves

​tai states pending-saves discard

​tai states pending-saves list

​tai states pending-saves retry

​tai states prune

​tai states put

​tai states read

​tai states replace

​tai states search

​tai states stats

​tai states subjects

​tai states template-jq

​tai states template-jq apply

​tai states template-jq eval

​tai states update-attachment

​tai states validate

​tai states writes

`tai states apply`

`tai states attach`

`tai states attachment-referees`

`tai states attachments`

`tai states check`

`tai states consumers`

`tai states delete`

`tai states detach`

`tai states erase`

`tai states fold`

`tai states get`

`tai states get-attachment`

`tai states list`

`tai states merge`

`tai states pending-saves`

`tai states pending-saves discard`

`tai states pending-saves list`

`tai states pending-saves retry`

`tai states prune`

`tai states put`

`tai states read`

`tai states replace`

`tai states search`

`tai states stats`

`tai states subjects`

`tai states template-jq`

`tai states template-jq apply`

`tai states template-jq eval`

`tai states update-attachment`

`tai states validate`

`tai states writes`