docs/mesh-commands.mdx
Rama main · réplica de lectura del repositorio original.
---
title: Mesh command catalog
description: Built-in endpoint command declarations, capabilities, targeting modes and JSON schemas.
kind: "Reference (informative)"
audience: developers integrating with Cotal
---
This catalog is generated from the built-in Manager, auth and registry cluster contracts in this source revision. It lists every command those three contracts declare, with its complete input and output JSON schemas. Dynamic extension endpoints, including MCP bridges, are discovered from their running service. Reserved protocol verbs such as `describe` are defined in [SPEC §13](../SPEC.md#13-endpoint-control-surface-v04), not in these cluster tables.
## Discover before calling
A published catalog does not establish that a service is running or that a caller has authority. Resolve the live endpoint before invoking it; [discovery](control-discovery.mdx#service-discovery) verifies the registered contract digests. Installed versions may differ from this page. Capability names classify commands; they are not grants. Target modes and instance routing remain enforced by the broker and service.
For an already authorized space, these examples inspect the Manager and make a read-only status call. Choose the Manager instance explicitly where required by your deployment. They do not create a grant or start a service.
```sh
cotal describe manager --space <space> --on <instance>
cotal invoke manager status --args 'null' --space <space> --on <instance>
```
The [CLI endpoint reference](cli-endpoints.mdx) explains discovery, target selection and invocation. Agent sessions use `cotal_describe` followed by `cotal_invoke`; see the [tool catalog](mcp-tools.mdx). Do not substitute an identity field in command arguments for the authenticated target.
## Request failures
The output schemas below describe successful command results, not the protocol error envelope. Input validation refuses before publication. A received `error.outcome` of `not-executed` proves the command did not run; an unknown or absent outcome does not. Check the affected state before repeating a mutation. Commands may also return domain refusal states inside a successful result, as their output schema specifies. See [request outcomes](control-discovery.mdx#request-outcomes) and [SPEC §13](../SPEC.md#13-endpoint-control-surface-v04) for errors, deadlines and retry rules. The cluster documents do not declare an exhaustive per-command error-code list.
## manager
Cluster `ai.cotal.manager`, revision 47. 43 commands.
| Command | Capability | Class | Target modes |
| --------------------------------------------------------- | ------------------- | --------- | ------------ |
| [`vitals`](#manager-vitals) | `manager.vitals` | ephemeral | untargeted |
| [`status`](#manager-status) | `manager.read` | ephemeral | untargeted |
| [`ps`](#manager-ps) | `manager.read` | ephemeral | untargeted |
| [`inspect`](#manager-inspect) | `manager.read` | ephemeral | untargeted |
| [`slots`](#manager-slots) | `manager.read` | ephemeral | untargeted |
| [`models`](#manager-models) | `manager.read` | ephemeral | untargeted |
| [`resolve-cwd`](#manager-resolve-cwd) | `manager.spawn` | ephemeral | untargeted |
| [`resolve-agent`](#manager-resolve-agent) | `manager.spawn` | ephemeral | untargeted |
| [`spawn`](#manager-spawn) | `manager.spawn` | ephemeral | untargeted |
| [`despawn`](#manager-despawn) | `manager.lifecycle` | ephemeral | owner, any |
| [`attach`](#manager-attach) | `manager.lifecycle` | ephemeral | owner, any |
| [`input`](#manager-input) | `manager.lifecycle` | ephemeral | owner, any |
| [`turn`](#manager-turn) | `manager.lifecycle` | ephemeral | owner, any |
| [`turn-participate`](#manager-turn-participate) | `manager.self` | ephemeral | self |
| [`turn-pending`](#manager-turn-pending) | `manager.self` | ephemeral | self |
| [`turn-yield`](#manager-turn-yield) | `manager.self` | ephemeral | self |
| [`turn-unconfirmed`](#manager-turn-unconfirmed) | `manager.self` | ephemeral | self |
| [`cancel`](#manager-cancel) | `manager.lifecycle` | ephemeral | untargeted |
| [`stop`](#manager-stop) | `manager.self` | ephemeral | self |
| [`run-start`](#manager-run-start) | `manager.run` | ephemeral | untargeted |
| [`run-start-keyed`](#manager-run-start-keyed) | `manager.run` | ephemeral | untargeted |
| [`run-submission-status`](#manager-run-submission-status) | `manager.run` | ephemeral | untargeted |
| [`run-resume`](#manager-run-resume) | `manager.run` | ephemeral | untargeted |
| [`run-cancel`](#manager-run-cancel) | `manager.run` | ephemeral | untargeted |
| [`run-answer`](#manager-run-answer) | `manager.run` | ephemeral | self |
| [`run-status`](#manager-run-status) | `manager.read` | ephemeral | untargeted |
| [`run-ps`](#manager-run-ps) | `manager.read` | ephemeral | untargeted |
| [`goal-result`](#manager-goal-result) | `manager.read` | ephemeral | untargeted |
| [`define-persona`](#manager-define-persona) | `manager.persona` | ephemeral | untargeted |
| [`remove-persona`](#manager-remove-persona) | `manager.persona` | ephemeral | untargeted |
| [`chat-session-open`](#manager-chat-session-open) | `manager.chat` | ephemeral | untargeted |
| [`chat-session-retire`](#manager-chat-session-retire) | `manager.chat` | ephemeral | untargeted |
| [`list-personas`](#manager-list-personas) | `manager.read` | ephemeral | untargeted |
| [`show-persona`](#manager-show-persona) | `manager.read` | ephemeral | untargeted |
| [`purge`](#manager-purge) | `manager.admin` | ephemeral | untargeted |
| [`launch`](#manager-launch) | `manager.admin` | ephemeral | untargeted |
| [`resume-preserved`](#manager-resume-preserved) | `manager.admin` | ephemeral | untargeted |
| [`commit-resume`](#manager-commit-resume) | `manager.admin` | ephemeral | untargeted |
| [`finalize-resume`](#manager-finalize-resume) | `manager.admin` | ephemeral | untargeted |
| [`prepare-preservation`](#manager-prepare-preservation) | `manager.admin` | ephemeral | untargeted |
| [`commit-preservation`](#manager-commit-preservation) | `manager.admin` | ephemeral | untargeted |
| [`abort-preservation`](#manager-abort-preservation) | `manager.admin` | ephemeral | untargeted |
| [`transcript-receive`](#manager-transcript-receive) | `manager.admin` | ephemeral | untargeted |
### manager vitals
Registered declaration:
```json
{
"name": "vitals",
"class": "ephemeral",
"targeted": false,
"capability": "manager.vitals",
"inputDigest": "sha256:1db0472aaee8e6b9d8d3d430ee021a1b6efc559ab7c0b99186898c972c53dd2d",
"outputDigest": "sha256:2e2481b4e4fde9392355035231323b1468873ffa47038e89f003eb9806f1f5ab"
}
```
Input schema:
```json
{
"type": "null"
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"sampledAt",
"cpu",
"memory",
"filesystems"
],
"properties": {
"sampledAt": {
"type": "string",
"format": "date-time"
},
"cpu": {
"type": "object",
"additionalProperties": false,
"required": [
"logicalCount",
"load1",
"load5",
"load15"
],
"properties": {
"logicalCount": {
"type": "integer",
"minimum": 1
},
"load1": {
"type": "number",
"minimum": 0
},
"load5": {
"type": "number",
"minimum": 0
},
"load15": {
"type": "number",
"minimum": 0
}
}
},
"memory": {
"type": "object",
"additionalProperties": false,
"required": [
"totalBytes",
"availableBytes"
],
"properties": {
"totalBytes": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"availableBytes": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
}
},
"filesystems": {
"type": "array",
"maxItems": 128,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"mount",
"totalBytes",
"freeBytes"
],
"properties": {
"mount": {
"type": "string",
"minLength": 1,
"maxLength": 1024,
"pattern": "^[^\\u0000-\\u001f\\u007f-\\u009f]+$"
},
"totalBytes": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"freeBytes": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
}
}
}
}
}
}
```
### manager status
Registered declaration:
```json
{
"name": "status",
"class": "ephemeral",
"targeted": false,
"capability": "manager.read",
"inputDigest": "sha256:1db0472aaee8e6b9d8d3d430ee021a1b6efc559ab7c0b99186898c972c53dd2d",
"outputDigest": "sha256:20fcd4978ef14fa010b0da9c704fc0289d9cc8b4ee290ac388d47cb09db81362"
}
```
Input schema:
```json
{
"type": "null"
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"instanceId",
"execution",
"runtime",
"custody",
"runHosting",
"terminalSessions",
"agentCount",
"uptimeMs",
"connectors",
"classSpawn",
"staticReconciliation"
],
"properties": {
"instanceId": {
"type": "string"
},
"host": {
"type": "string"
},
"version": {
"type": "string"
},
"lifecycleUid": {
"type": "string"
},
"execution": {
"enum": [
"runtime",
"none"
]
},
"runtime": {
"type": "string"
},
"custody": {
"enum": [
"legacy",
"custodied",
"none"
]
},
"runHosting": {
"type": "boolean"
},
"terminalSessions": {
"type": "boolean"
},
"agentCount": {
"type": "integer",
"minimum": 0
},
"uptimeMs": {
"type": "integer",
"minimum": 0
},
"classSpawn": {
"type": "boolean"
},
"connectors": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"agent",
"state",
"binaries",
"eventPlane"
],
"properties": {
"agent": {
"type": "string"
},
"state": {
"enum": [
"available",
"unavailable"
]
},
"binaries": {
"type": "object",
"additionalProperties": {
"type": "string"
}
},
"eventPlane": {
"type": "boolean"
},
"reason": {
"type": "string"
}
}
}
},
"stopImpact": {
"type": "object",
"additionalProperties": false,
"required": [
"agentScope",
"observedAt",
"maintenance",
"resumeRequired",
"stopping",
"lifecycleInFlight",
"reservedLaunches",
"retirementsPending",
"deprovisioningInFlight",
"staticReconciliationInFlight",
"agents"
],
"properties": {
"agentScope": {
"enum": [
"manager",
"owner-filtered"
]
},
"observedAt": {
"type": "string"
},
"maintenance": {
"enum": [
"active",
"preserving",
"preserved"
]
},
"resumeRequired": {
"type": "boolean"
},
"stopping": {
"type": "boolean"
},
"lifecycleInFlight": {
"type": "integer",
"minimum": 0
},
"reservedLaunches": {
"type": "integer",
"minimum": 0
},
"retirementsPending": {
"type": "integer",
"minimum": 0
},
"deprovisioningInFlight": {
"type": "integer",
"minimum": 0
},
"staticReconciliationInFlight": {
"type": "integer",
"minimum": 0
},
"agents": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"name",
"id",
"lifecycleUid",
"mode",
"defaultAction",
"withAgentsAction"
],
"properties": {
"name": {
"type": "string"
},
"id": {
"type": "string"
},
"lifecycleUid": {
"type": "string"
},
"mode": {
"type": "string"
},
"defaultAction": {
"enum": [
"release-custody",
"stop",
"stop-retaining-state"
]
},
"withAgentsAction": {
"enum": [
"stop",
"stop-retaining-state"
]
}
}
}
},
"preservation": {
"type": "object",
"additionalProperties": false,
"required": [
"attemptId",
"inventorySha256"
],
"properties": {
"attemptId": {
"type": "string",
"pattern": "^[A-Za-z0-9][A-Za-z0-9_-]{0,127}$"
},
"inventorySha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
}
}
}
}
},
"staticReconciliation": {
"type": "object",
"additionalProperties": false,
"required": [
"state",
"failures"
],
"properties": {
"state": {
"enum": [
"idle",
"running",
"retry-wait",
"retrying",
"recovered",
"failed"
]
},
"lastSweep": {
"type": "object",
"additionalProperties": false,
"required": [
"kind",
"startedAt",
"attempted",
"succeeded",
"failed"
],
"properties": {
"kind": {
"enum": [
"startup",
"post-adoption"
]
},
"startedAt": {
"type": "string"
},
"completedAt": {
"type": "string"
},
"attempted": {
"type": "integer",
"minimum": 0
},
"succeeded": {
"type": "integer",
"minimum": 0
},
"failed": {
"type": "integer",
"minimum": 0
},
"error": {
"type": "string"
}
}
},
"failures": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"alias",
"actor",
"lifecycleUid",
"phase",
"attempts",
"maxAttempts",
"disposition"
],
"properties": {
"alias": {
"type": "string"
},
"actor": {
"type": "string"
},
"lifecycleUid": {
"type": "string"
},
"phase": {
"enum": [
"provisioning",
"active",
"terminalizing",
"retired"
]
},
"attempts": {
"type": "integer",
"minimum": 0
},
"maxAttempts": {
"type": "integer",
"minimum": 1
},
"disposition": {
"enum": [
"retry-scheduled",
"retrying",
"recovered",
"refused",
"refused-foreign",
"retry-exhausted"
]
},
"lastError": {
"type": "string"
},
"nextRetryAt": {
"type": "string"
},
"recoveredAt": {
"type": "string"
},
"remedy": {
"type": "string"
}
}
}
}
}
}
}
}
```
### manager ps
Registered declaration:
```json
{
"name": "ps",
"class": "ephemeral",
"targeted": false,
"capability": "manager.read",
"inputDigest": "sha256:1db0472aaee8e6b9d8d3d430ee021a1b6efc559ab7c0b99186898c972c53dd2d",
"outputDigest": "sha256:d5d9fbb35faf16c8f4ff7992dcf7d30bd6b25cd44c41f46985cde237279699b4"
}
```
Input schema:
```json
{
"type": "null"
}
```
Output schema:
```json
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"name",
"id",
"agent",
"space",
"mode",
"status",
"uptimeMs",
"mesh",
"lifecycleUid"
],
"properties": {
"name": {
"type": "string"
},
"id": {
"type": "string"
},
"role": {
"type": "string"
},
"agent": {
"type": "string"
},
"space": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"uptimeMs": {
"type": "integer",
"minimum": 0
},
"mesh": {
"type": "string"
},
"joinHealth": {
"type": "object",
"additionalProperties": false,
"required": [
"state",
"reason"
],
"properties": {
"state": {
"type": "string",
"const": "degraded"
},
"reason": {
"type": "string"
}
}
},
"condition": {
"type": "object",
"additionalProperties": false,
"required": [
"code"
],
"properties": {
"code": {
"type": "string"
},
"source": {
"type": "string"
},
"message": {
"type": "string"
},
"since": {
"type": "number"
}
}
},
"startupNotice": {
"type": "string",
"minLength": 1,
"maxLength": 1024
},
"activeAt": {
"type": "number"
},
"meshView": {
"type": "string",
"enum": [
"current",
"stale",
"unpopulated"
]
},
"presenceIdentityVerified": {
"type": "boolean"
},
"presenceObservedAt": {
"type": "integer",
"minimum": 0
},
"offlineSince": {
"type": "integer",
"minimum": 0
},
"lifecycleUid": {
"type": "string"
},
"authHealth": {
"type": "string"
},
"authReason": {
"type": "string"
},
"model": {
"type": "string"
},
"variant": {
"type": "string"
},
"provider": {
"type": "string"
},
"cwd": {
"type": "string"
},
"pid": {
"type": "integer",
"minimum": 1
},
"spawner": {
"type": "string"
},
"instanceId": {
"type": "string"
},
"host": {
"type": "string"
},
"resume": {
"type": "object",
"additionalProperties": false,
"required": [
"source"
],
"properties": {
"source": {
"type": "string"
},
"title": {
"type": "string"
},
"transcriptSha256": {
"type": "string"
},
"host": {
"type": "string"
},
"transferredAt": {
"type": "string"
}
}
}
}
}
}
```
### manager inspect
Registered declaration:
```json
{
"name": "inspect",
"class": "ephemeral",
"targeted": false,
"capability": "manager.read",
"inputDigest": "sha256:c74bfe6c0426cf31f56796a48992639eb08a46c36f7dd7205b497cf2c83a8382",
"outputDigest": "sha256:a3cda221ec4afbdf90578b619232bd5c4ab4af2872a12df1ad8cd7ef58ab0aa2"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 1
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"name",
"id",
"agent",
"space",
"mode",
"status",
"uptimeMs",
"mesh",
"lifecycleUid"
],
"properties": {
"name": {
"type": "string"
},
"id": {
"type": "string"
},
"role": {
"type": "string"
},
"agent": {
"type": "string"
},
"space": {
"type": "string"
},
"mode": {
"type": "string"
},
"status": {
"type": "string"
},
"uptimeMs": {
"type": "integer",
"minimum": 0
},
"mesh": {
"type": "string"
},
"joinHealth": {
"type": "object",
"additionalProperties": false,
"required": [
"state",
"reason"
],
"properties": {
"state": {
"type": "string",
"const": "degraded"
},
"reason": {
"type": "string"
}
}
},
"condition": {
"type": "object",
"additionalProperties": false,
"required": [
"code"
],
"properties": {
"code": {
"type": "string"
},
"source": {
"type": "string"
},
"message": {
"type": "string"
},
"since": {
"type": "number"
}
}
},
"startupNotice": {
"type": "string",
"minLength": 1,
"maxLength": 1024
},
"activeAt": {
"type": "number"
},
"meshView": {
"type": "string",
"enum": [
"current",
"stale",
"unpopulated"
]
},
"presenceIdentityVerified": {
"type": "boolean"
},
"presenceObservedAt": {
"type": "integer",
"minimum": 0
},
"offlineSince": {
"type": "integer",
"minimum": 0
},
"lifecycleUid": {
"type": "string"
},
"authHealth": {
"type": "string"
},
"authReason": {
"type": "string"
},
"model": {
"type": "string"
},
"variant": {
"type": "string"
},
"provider": {
"type": "string"
},
"cwd": {
"type": "string"
},
"pid": {
"type": "integer",
"minimum": 1
},
"spawner": {
"type": "string"
},
"instanceId": {
"type": "string"
},
"host": {
"type": "string"
},
"resume": {
"type": "object",
"additionalProperties": false,
"required": [
"source"
],
"properties": {
"source": {
"type": "string"
},
"title": {
"type": "string"
},
"transcriptSha256": {
"type": "string"
},
"host": {
"type": "string"
},
"transferredAt": {
"type": "string"
}
}
}
}
}
```
### manager slots
Registered declaration:
```json
{
"name": "slots",
"class": "ephemeral",
"targeted": false,
"capability": "manager.read",
"inputDigest": "sha256:60ec4285f99501ea9b3419ff63645f517f4c95edb43faa53ac2d8a1502ba4c7d",
"outputDigest": "sha256:da5feb93000530a54705e4699c81390bbb3e1d3acd4ebfbab0349544b75f47a9"
}
```
Input schema:
```json
{
"anyOf": [
{
"type": "null"
},
{
"type": "object",
"additionalProperties": false,
"properties": {
"names": {
"type": "array",
"minItems": 1,
"maxItems": 100,
"uniqueItems": true,
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$",
"maxLength": 200
}
},
"includeRetired": {
"type": "boolean"
}
}
}
]
}
```
Output schema:
```json
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"name",
"owner",
"actor",
"slotLifecycleUid",
"slotPhase",
"slotRevision",
"readOrder",
"consistency",
"live",
"managerInstanceId"
],
"properties": {
"name": {
"type": "string"
},
"owner": {
"type": "string"
},
"actor": {
"type": "string"
},
"slotLifecycleUid": {
"type": "string"
},
"slotPhase": {
"type": "string",
"enum": [
"provisioning",
"active",
"terminalizing",
"retired"
]
},
"cleanupComplete": {
"type": "boolean"
},
"slotRevision": {
"type": "integer",
"minimum": 0
},
"headState": {
"type": "string",
"enum": [
"active",
"retiring",
"retired"
]
},
"headOp": {
"type": "object",
"additionalProperties": false,
"required": [
"opId",
"kind"
],
"properties": {
"opId": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"retirement"
]
}
}
},
"headLifecycleUid": {
"type": "string"
},
"headRevision": {
"type": "integer",
"minimum": 0
},
"readOrder": {
"type": "array",
"items": {
"type": "string",
"enum": [
"slot",
"head"
]
},
"minItems": 2,
"maxItems": 2
},
"consistency": {
"type": "string",
"enum": [
"ordered-not-atomic"
]
},
"live": {
"type": "boolean"
},
"managerInstanceId": {
"type": "string"
}
}
}
}
```
### manager models
Registered declaration:
```json
{
"name": "models",
"class": "ephemeral",
"targeted": false,
"capability": "manager.read",
"inputDigest": "sha256:edcf1dcdeede38991ec59b6bf2a44fc2a36bb6252fce5d80e399717ec85df88c",
"outputDigest": "sha256:66c9c24fef33a9cf69afdb59324a37591e600ce8106ed61e71b46dddcbc124f6"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"properties": {
"agent": {
"type": "string"
},
"refresh": {
"type": "boolean"
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"catalogs"
],
"properties": {
"catalogs": {
"type": "array",
"items": {
"type": "object",
"required": [
"agent",
"supported",
"models"
],
"properties": {
"agent": {
"type": "string"
},
"supported": {
"type": "boolean"
},
"models": {
"type": "array"
},
"error": {
"type": "string"
}
}
}
}
}
}
```
### manager resolve-cwd
Registered declaration:
```json
{
"name": "resolve-cwd",
"class": "ephemeral",
"targeted": false,
"capability": "manager.spawn",
"inputDigest": "sha256:ea591334a950e26e492ad4be32c44ac5687ba73c01929064c41e7ae59efa3d22",
"outputDigest": "sha256:5c3dc3539b27d9a7c95379984bb8e9eba33d0bffb68817681f014d4b0646ef79"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"cwd"
],
"properties": {
"cwd": {
"type": "string",
"minLength": 1
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"cwd",
"host"
],
"properties": {
"cwd": {
"type": "string"
},
"host": {
"type": "string"
}
}
}
```
### manager resolve-agent
Registered declaration:
```json
{
"name": "resolve-agent",
"class": "ephemeral",
"targeted": false,
"capability": "manager.spawn",
"inputDigest": "sha256:4e082d960896c6bfffe62657e42a56694a1e371fa9aaf9fb4dee5e0a93713db9",
"outputDigest": "sha256:bd5150fceb1ed179f0cb3db78c67e4adba7be6501db228a619556c355474a295"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 1
},
"config": {
"type": "string",
"pattern": "^\\s*\\S"
},
"agent": {
"type": "string",
"pattern": "^\\s*\\S"
},
"defaultAgent": {
"type": "string",
"pattern": "^\\s*\\S"
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"agent"
],
"properties": {
"agent": {
"type": "string"
}
}
}
```
### manager spawn
Registered declaration:
```json
{
"name": "spawn",
"class": "ephemeral",
"targeted": false,
"capability": "manager.spawn",
"inputDigest": "sha256:64c597ae615c7f036549ac9e7e6aa6e2c629a90c8965cc7eceb0bb4eac53766d",
"outputDigest": "sha256:d883a9f97f7c034772c7cbc28b22d63cf69870ba072d470c2f7b104f455e2e83"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 1
},
"agent": {
"type": "string",
"pattern": "^\\s*\\S"
},
"defaultAgent": {
"type": "string",
"pattern": "^\\s*\\S"
},
"role": {
"type": "string",
"pattern": "^\\s*\\S"
},
"config": {
"type": "string",
"pattern": "^\\s*\\S"
},
"identity": {
"type": "string",
"pattern": "^\\s*\\S"
},
"model": {
"type": "string",
"pattern": "^\\s*\\S"
},
"variant": {
"type": "string",
"pattern": "^\\s*\\S"
},
"launchOptions": {
"type": "object"
},
"resume": {
"type": "string",
"pattern": "^\\s*\\S"
},
"resumeClaim": {
"type": "string",
"pattern": "^\\s*\\S"
},
"resumeAgent": {
"type": "string",
"pattern": "^\\s*\\S"
},
"events": {
"type": "boolean"
},
"cwd": {
"type": "string",
"pattern": "^\\s*\\S"
},
"prompt": {
"type": "string",
"pattern": "^\\s*\\S"
},
"persona": {
"type": "object",
"additionalProperties": false,
"required": [
"prompt"
],
"properties": {
"prompt": {
"type": "string",
"pattern": "^\\s*\\S"
},
"role": {
"type": "string",
"pattern": "^\\s*\\S"
},
"model": {
"type": "string",
"pattern": "^\\s*\\S"
},
"variant": {
"type": "string",
"pattern": "^\\s*\\S"
},
"description": {
"type": "string",
"pattern": "^\\s*\\S"
},
"subscribe": {
"type": "array",
"items": {
"type": "string"
}
},
"allowSubscribe": {
"type": "array",
"items": {
"type": "string"
}
},
"allowPublish": {
"type": "array",
"items": {
"type": "string"
}
},
"capabilities": {
"type": "array",
"items": {
"type": "string"
}
},
"endpoints": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"endpoint",
"commands"
],
"properties": {
"endpoint": {
"type": "string"
},
"commands": {
"type": "array",
"items": {
"type": "string"
}
},
"instanceId": {
"type": "string"
}
}
}
},
"save": {
"type": "boolean"
}
}
},
"runId": {
"type": "string",
"pattern": "^\\s*\\S"
},
"subscribe": {
"type": "array",
"items": {
"type": "string"
}
},
"allowSubscribe": {
"type": "array",
"items": {
"type": "string"
}
},
"allowPublish": {
"type": "array",
"items": {
"type": "string"
}
},
"join": {
"type": "array",
"items": {
"type": "string"
}
},
"callerAcl": {
"type": "object",
"additionalProperties": false,
"required": [
"allowSubscribe",
"allowPublish"
],
"properties": {
"allowSubscribe": {
"type": "array",
"items": {
"type": "string"
}
},
"allowPublish": {
"type": "array",
"items": {
"type": "string"
}
}
}
},
"shareTools": {
"type": "array",
"items": {
"type": "string"
}
},
"runtime": {
"type": "string",
"pattern": "^\\s*\\S"
},
"supervise": {
"type": "object",
"additionalProperties": false,
"required": [
"restarts",
"windowMs"
],
"properties": {
"restarts": {
"type": "integer",
"minimum": 1
},
"windowMs": {
"type": "integer",
"minimum": 1
}
}
},
"once": {
"type": "object",
"additionalProperties": false,
"properties": {
"deadlineMs": {
"anyOf": [
{
"const": -1
},
{
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
]
}
}
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"name",
"owner",
"actor",
"uid",
"goalId",
"fingerprint",
"executor"
],
"properties": {
"name": {
"type": "string"
},
"owner": {
"type": "string"
},
"actor": {
"type": "string"
},
"uid": {
"type": "string"
},
"goalId": {
"type": "string"
},
"fingerprint": {
"type": "string"
},
"readinessDeadlineMs": {
"type": "integer",
"minimum": 1
},
"executor": {
"type": "object",
"additionalProperties": false,
"required": [
"lifecycleUid",
"epoch"
],
"properties": {
"lifecycleUid": {
"type": "string"
},
"epoch": {
"type": "integer",
"minimum": 0
}
}
}
}
}
```
### manager despawn
Registered declaration:
```json
{
"name": "despawn",
"class": "ephemeral",
"targeted": true,
"modes": [
"owner",
"any"
],
"capability": "manager.lifecycle",
"inputDigest": "sha256:2fde1dce4a65d3dad7991113b4b98f51f10b94109898f049154759bc456567ef",
"outputDigest": "sha256:7ec7cf7c8d9011fc57022db68577851eb1fb57cdbef94766e4d6ca26bc70131e"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"properties": {
"graceful": {
"type": "boolean"
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"name",
"stopped",
"graceful"
],
"properties": {
"name": {
"type": "string"
},
"stopped": {
"type": "boolean"
},
"graceful": {
"type": "boolean"
}
}
}
```
### manager attach
Registered declaration:
```json
{
"name": "attach",
"class": "ephemeral",
"targeted": true,
"modes": [
"owner",
"any"
],
"capability": "manager.lifecycle",
"inputDigest": "sha256:1db0472aaee8e6b9d8d3d430ee021a1b6efc559ab7c0b99186898c972c53dd2d",
"outputDigest": "sha256:db9b6af74cba69ac9d3a08c9d313b3f65dca9df6e19ad19cc1753956dcf937c3"
}
```
Input schema:
```json
{
"type": "null"
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"grant"
],
"properties": {
"grant": {
"type": "object"
},
"resumedFrom": {
"type": "object",
"additionalProperties": false,
"required": [
"host",
"source"
],
"properties": {
"host": {
"type": "string"
},
"source": {
"type": "string"
}
}
}
}
}
```
### manager input
Registered declaration:
```json
{
"name": "input",
"class": "ephemeral",
"targeted": true,
"modes": [
"owner",
"any"
],
"capability": "manager.lifecycle",
"inputDigest": "sha256:31b92d1926fc84652ca043f8b9a2c443ed272932e99935b64ab35e24d88c0052",
"outputDigest": "sha256:165c6b378b4731d23598bf42d390998da55afeac3690cfdad700820b0ad5b126"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"text"
],
"properties": {
"text": {
"type": "string",
"minLength": 1,
"maxLength": 65536
},
"enter": {
"type": "boolean"
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"name",
"bytes"
],
"properties": {
"name": {
"type": "string"
},
"bytes": {
"type": "integer",
"minimum": 0
}
}
}
```
### manager turn
Registered declaration:
```json
{
"name": "turn",
"class": "ephemeral",
"targeted": true,
"modes": [
"owner",
"any"
],
"capability": "manager.lifecycle",
"inputDigest": "sha256:89dfd09e59fbbef6db68f62f6ab2bbeb8ba7223ea89be008cb327b25723754e7",
"outputDigest": "sha256:b9d570154853a000e00e612c8051b21aaedaf96586b4ccca76bf4572b24b050d"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"payload"
],
"oneOf": [
{
"required": [
"deadlineMs"
]
},
{
"required": [
"deadlineAt"
]
}
],
"properties": {
"payload": {
"type": "string",
"minLength": 1,
"maxLength": 65536
},
"deadlineMs": {
"type": "integer",
"minimum": 1
},
"deadlineAt": {
"type": "integer",
"minimum": 1
},
"handoffFrom": {
"type": "string",
"minLength": 1,
"maxLength": 200
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"name",
"owner",
"actor",
"uid",
"goalId",
"fingerprint",
"deadlineAt",
"executor"
],
"properties": {
"name": {
"type": "string"
},
"owner": {
"type": "string"
},
"actor": {
"type": "string"
},
"uid": {
"type": "string"
},
"goalId": {
"type": "string"
},
"fingerprint": {
"type": "string"
},
"deadlineAt": {
"type": "integer",
"minimum": 1
},
"executor": {
"type": "object",
"additionalProperties": false,
"required": [
"lifecycleUid",
"epoch"
],
"properties": {
"lifecycleUid": {
"type": "string"
},
"epoch": {
"type": "integer",
"minimum": 0
}
}
}
}
}
```
### manager turn-participate
Registered declaration:
```json
{
"name": "turn-participate",
"class": "ephemeral",
"targeted": true,
"modes": [
"self"
],
"capability": "manager.self",
"inputDigest": "sha256:1db0472aaee8e6b9d8d3d430ee021a1b6efc559ab7c0b99186898c972c53dd2d",
"outputDigest": "sha256:4afc76abda2042d3792fcaea09a7b0fbb39298bd98b46d1b1f10723e77570ef8"
}
```
Input schema:
```json
{
"type": "null"
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"owner",
"actor",
"lifecycleUid",
"name",
"managerInstanceId",
"expiresAt"
],
"properties": {
"owner": {
"type": "string",
"minLength": 1
},
"actor": {
"type": "string",
"minLength": 1
},
"lifecycleUid": {
"type": "string",
"minLength": 1
},
"name": {
"type": "string",
"minLength": 1
},
"managerInstanceId": {
"type": "string",
"minLength": 1
},
"expiresAt": {
"type": "integer",
"minimum": 1
}
}
}
```
### manager turn-pending
Registered declaration:
```json
{
"name": "turn-pending",
"class": "ephemeral",
"targeted": true,
"modes": [
"self"
],
"capability": "manager.self",
"inputDigest": "sha256:1db0472aaee8e6b9d8d3d430ee021a1b6efc559ab7c0b99186898c972c53dd2d",
"outputDigest": "sha256:36938254cd92614ab832a2c410cdd9f48b2498d8da36b53f9aa565e280328490"
}
```
Input schema:
```json
{
"type": "null"
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"turns"
],
"properties": {
"notices": {
"const": true
},
"stop": {
"const": true
},
"turns": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"goalId",
"payload",
"acceptedAt"
],
"properties": {
"goalId": {
"type": "string"
},
"payload": {
"type": "string"
},
"acceptedAt": {
"type": "integer",
"minimum": 0
},
"deadlineAt": {
"type": "integer",
"minimum": 1
},
"once": {
"const": true
}
}
}
}
}
}
```
### manager turn-yield
Registered declaration:
```json
{
"name": "turn-yield",
"class": "ephemeral",
"targeted": true,
"modes": [
"self"
],
"capability": "manager.self",
"inputDigest": "sha256:dc992f7975be5cec5c3f90153288ad6821380867fe004056fbcf8eb227656542",
"outputDigest": "sha256:63909e8274cd7febd74f46b4932af8e1a27d6d5b7c16dd5d8dbd2955142bd013"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"goalId",
"status"
],
"properties": {
"goalId": {
"type": "string",
"minLength": 1
},
"status": {
"enum": [
"done",
"blocked",
"handoff"
]
},
"to": {
"type": "string",
"minLength": 1
},
"note": {
"type": "string",
"maxLength": 4096
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"goalId",
"state"
],
"properties": {
"goalId": {
"type": "string"
},
"state": {
"enum": [
"succeeded",
"failed",
"cancelled",
"expired",
"uncertain"
]
}
}
}
```
### manager turn-unconfirmed
Registered declaration:
```json
{
"name": "turn-unconfirmed",
"class": "ephemeral",
"targeted": true,
"modes": [
"self"
],
"capability": "manager.self",
"inputDigest": "sha256:d85c21db12518b997058347762cabad0a41f6f63d32a9b487abbeae49a51ecd1",
"outputDigest": "sha256:63909e8274cd7febd74f46b4932af8e1a27d6d5b7c16dd5d8dbd2955142bd013"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"goalId"
],
"properties": {
"goalId": {
"type": "string",
"minLength": 1
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"goalId",
"state"
],
"properties": {
"goalId": {
"type": "string"
},
"state": {
"enum": [
"succeeded",
"failed",
"cancelled",
"expired",
"uncertain"
]
}
}
}
```
### manager cancel
Registered declaration:
```json
{
"name": "cancel",
"class": "ephemeral",
"targeted": false,
"capability": "manager.lifecycle",
"inputDigest": "sha256:57768d63b61c55c1590cf549cba7e0b4ee1b4de62dc711ec036eea8576511583",
"outputDigest": "sha256:63909e8274cd7febd74f46b4932af8e1a27d6d5b7c16dd5d8dbd2955142bd013"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"goalId"
],
"properties": {
"goalId": {
"type": "string",
"minLength": 1
},
"mode": {
"enum": [
"graceful",
"terminate"
]
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"goalId",
"state"
],
"properties": {
"goalId": {
"type": "string"
},
"state": {
"enum": [
"succeeded",
"failed",
"cancelled",
"expired",
"uncertain"
]
}
}
}
```
### manager stop
Registered declaration:
```json
{
"name": "stop",
"class": "ephemeral",
"targeted": true,
"modes": [
"self"
],
"capability": "manager.self",
"inputDigest": "sha256:2fde1dce4a65d3dad7991113b4b98f51f10b94109898f049154759bc456567ef",
"outputDigest": "sha256:7ec7cf7c8d9011fc57022db68577851eb1fb57cdbef94766e4d6ca26bc70131e"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"properties": {
"graceful": {
"type": "boolean"
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"name",
"stopped",
"graceful"
],
"properties": {
"name": {
"type": "string"
},
"stopped": {
"type": "boolean"
},
"graceful": {
"type": "boolean"
}
}
}
```
### manager run-start
Registered declaration:
```json
{
"name": "run-start",
"class": "ephemeral",
"targeted": false,
"capability": "manager.run",
"inputDigest": "sha256:8e362b51f48d3895be78889490dcc402d3dad77f8f444c7041a5f38a770ce8d5",
"outputDigest": "sha256:137ba8c3bf03a825cce5b1f3958db9a9f7a8788ee4fb1f1137cb98b34a04578c"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"source"
],
"properties": {
"source": {
"type": "string",
"minLength": 1
},
"file": {
"type": "string",
"minLength": 1
},
"timeout": {
"type": "string",
"minLength": 1
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"runId"
],
"properties": {
"runId": {
"type": "string"
}
}
}
```
### manager run-start-keyed
Registered declaration:
```json
{
"name": "run-start-keyed",
"class": "ephemeral",
"targeted": false,
"capability": "manager.run",
"inputDigest": "sha256:8e362b51f48d3895be78889490dcc402d3dad77f8f444c7041a5f38a770ce8d5",
"outputDigest": "sha256:23f2d21f7cd2876c8739e17986e07c1042194d3e4e967b64995c81a951039b66"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"source"
],
"properties": {
"source": {
"type": "string",
"minLength": 1
},
"file": {
"type": "string",
"minLength": 1
},
"timeout": {
"type": "string",
"minLength": 1
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"submissionId",
"state",
"instanceId",
"processEpoch"
],
"properties": {
"submissionId": {
"type": "string"
},
"state": {
"type": "string",
"enum": [
"unbound",
"binding-only",
"admitted",
"activated",
"indeterminate"
]
},
"instanceId": {
"type": "string"
},
"processEpoch": {
"type": "integer",
"minimum": 0
},
"runId": {
"type": "string"
},
"fingerprint": {
"type": "string"
},
"callbackDeadline": {
"type": "integer",
"minimum": 1
},
"reason": {
"type": "string"
}
}
}
```
### manager run-submission-status
Registered declaration:
```json
{
"name": "run-submission-status",
"class": "ephemeral",
"targeted": false,
"capability": "manager.run",
"inputDigest": "sha256:f1d18fe0ca475aa2308a6c333eeb3ad5c2e6490df8ff3d00048e35327ca3c86f",
"outputDigest": "sha256:23f2d21f7cd2876c8739e17986e07c1042194d3e4e967b64995c81a951039b66"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"submissionId"
],
"properties": {
"submissionId": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"pattern": "^[A-Za-z0-9_-]+$"
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"submissionId",
"state",
"instanceId",
"processEpoch"
],
"properties": {
"submissionId": {
"type": "string"
},
"state": {
"type": "string",
"enum": [
"unbound",
"binding-only",
"admitted",
"activated",
"indeterminate"
]
},
"instanceId": {
"type": "string"
},
"processEpoch": {
"type": "integer",
"minimum": 0
},
"runId": {
"type": "string"
},
"fingerprint": {
"type": "string"
},
"callbackDeadline": {
"type": "integer",
"minimum": 1
},
"reason": {
"type": "string"
}
}
}
```
### manager run-resume
Registered declaration:
```json
{
"name": "run-resume",
"class": "ephemeral",
"targeted": false,
"capability": "manager.run",
"inputDigest": "sha256:caf250696cca5065b7bf9056decccba83775b1ff3d8941d285350b6575c0dfe1",
"outputDigest": "sha256:137ba8c3bf03a825cce5b1f3958db9a9f7a8788ee4fb1f1137cb98b34a04578c"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"runId"
],
"properties": {
"runId": {
"type": "string",
"minLength": 1
},
"timeout": {
"type": "string",
"minLength": 1
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"runId"
],
"properties": {
"runId": {
"type": "string"
}
}
}
```
### manager run-cancel
Registered declaration:
```json
{
"name": "run-cancel",
"class": "ephemeral",
"targeted": false,
"capability": "manager.run",
"inputDigest": "sha256:81f3d6efcfe85e94b0b99a9fa37c1594715149ef28a287a977928f47bef1d100",
"outputDigest": "sha256:690ac1173589459bbfa9d694754deb01933b47b0487c8c2e35d5ff8447cfdee4"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"runId",
"reason"
],
"properties": {
"runId": {
"type": "string",
"minLength": 1
},
"reason": {
"type": "string",
"minLength": 1,
"maxLength": 512
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"runId",
"duplicate",
"authority",
"observed"
],
"properties": {
"runId": {
"type": "string"
},
"duplicate": {
"type": [
"boolean",
"null"
]
},
"authority": {
"enum": [
"original",
"owner-interactive",
"admin"
]
},
"revocation": {
"type": "object",
"additionalProperties": false,
"required": [
"by",
"reason",
"revokedAt"
],
"properties": {
"by": {
"type": "string"
},
"reason": {
"type": "string"
},
"revokedAt": {
"type": "integer"
}
}
},
"observed": {
"type": "object",
"additionalProperties": false,
"required": [
"processEpoch",
"phase"
],
"properties": {
"processEpoch": {
"type": "integer",
"minimum": 0
},
"phase": {
"enum": [
"terminal",
"launch-abandoned",
"stop-requested",
"stopped",
"not-driven-here"
]
},
"recordedState": {
"enum": [
"running",
"released",
"completed",
"failed"
]
},
"runEpoch": {
"type": "integer",
"minimum": 0
},
"fencingToken": {
"type": "integer",
"minimum": 0
},
"holder": {
"type": "string"
},
"driveOutcome": {
"anyOf": [
{
"type": "object",
"additionalProperties": false,
"required": [
"status",
"steps"
],
"properties": {
"status": {
"const": "completed"
},
"steps": {
"type": "integer",
"minimum": 0
},
"value": {}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"status",
"reason"
],
"properties": {
"status": {
"const": "released"
},
"reason": {
"type": "object",
"additionalProperties": false,
"required": [
"name",
"message"
],
"properties": {
"name": {
"type": "string"
},
"message": {
"type": "string"
}
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"status",
"error"
],
"properties": {
"status": {
"const": "failed"
},
"error": {
"type": "object",
"additionalProperties": false,
"required": [
"name",
"message"
],
"properties": {
"name": {
"type": "string"
},
"message": {
"type": "string"
},
"code": {
"type": "string"
}
}
}
}
}
]
}
}
}
}
}
```
### manager run-answer
Registered declaration:
```json
{
"name": "run-answer",
"class": "ephemeral",
"targeted": true,
"modes": [
"self"
],
"capability": "manager.run",
"inputDigest": "sha256:6866b0ca9769bce89c5d1a20e1bfaa8615631ca3aeb305bfc984a6b723521830",
"outputDigest": "sha256:25a531f5a7cdb8ae96563e0af24afbcb18edd63b72bd769c530a07f90221a235"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"runId",
"stepKey"
],
"properties": {
"runId": {
"type": "string",
"minLength": 1
},
"endpoint": {
"type": "string",
"minLength": 1
},
"stepKey": {
"type": "string",
"minLength": 1
},
"value": {},
"artifact": {
"type": "string",
"minLength": 1
},
"amend": {
"type": "boolean"
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"token",
"answerId"
],
"properties": {
"token": {
"type": "string"
},
"answerId": {
"type": "string"
},
"settle": {
"type": "object"
},
"supersedes": {
"type": "string"
}
}
}
```
### manager run-status
Registered declaration:
```json
{
"name": "run-status",
"class": "ephemeral",
"targeted": false,
"capability": "manager.read",
"inputDigest": "sha256:67695dbcf54a9f34a8d1fdf88c46da0808c5cc3a045e14b8a55cad725944999d",
"outputDigest": "sha256:b0979319b29095b917451e3de9b8a9d80827e07cad3cba44047acd30c05c827f"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"runId"
],
"properties": {
"runId": {
"type": "string",
"minLength": 1
},
"endpoint": {
"type": "string",
"minLength": 1
},
"journal": {
"type": "object",
"additionalProperties": false,
"required": [
"offset"
],
"properties": {
"offset": {
"type": "integer",
"minimum": 0
}
}
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"runId",
"endpoint",
"spec",
"journal"
],
"properties": {
"runId": {
"type": "string"
},
"endpoint": {
"type": "string"
},
"revoked": {
"type": "object",
"additionalProperties": false,
"required": [
"by",
"reason"
],
"properties": {
"by": {
"type": "string"
},
"reason": {
"type": "string"
}
}
},
"revocationUnreadable": {
"type": "string"
},
"programHash": {
"type": "string"
},
"programUnreadable": {
"type": "string"
},
"spec": {
"type": "object"
},
"status": {
"type": "object"
},
"journal": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"n",
"kind"
],
"properties": {
"n": {
"type": "integer",
"minimum": 0
},
"kind": {
"type": "string",
"enum": [
"activation",
"step"
]
},
"holder": {
"type": "string"
},
"epoch": {
"type": "integer",
"minimum": 0
},
"replayedTo": {
"type": "integer",
"minimum": 0
},
"step": {
"type": "string"
},
"effect": {
"type": "string"
},
"name": {
"type": "string"
},
"state": {
"type": "string",
"enum": [
"pending",
"settled"
]
},
"outcome": {
"type": "string"
},
"status": {
"type": "string"
},
"errorCode": {
"type": "string"
},
"errorMessage": {
"type": "string"
},
"startedAt": {
"type": "number"
},
"endedAt": {
"type": "number"
},
"winner": {
"type": "string"
},
"lostRace": {
"type": "string"
},
"asks": {
"type": "string"
},
"schema": {},
"addressee": {
"type": "string"
},
"deadlineAt": {
"type": "number"
},
"onExpiry": {
"type": "string"
},
"answer": {
"type": "object",
"additionalProperties": false,
"required": [
"answerId"
],
"properties": {
"answerId": {
"type": "string"
},
"value": {},
"by": {
"type": "string"
},
"artifact": {
"type": "string"
},
"at": {
"type": "number"
}
}
},
"amendments": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"answerId",
"supersedes",
"by",
"at"
],
"properties": {
"answerId": {
"type": "string"
},
"supersedes": {
"type": "string"
},
"value": {},
"by": {
"type": "string"
},
"artifact": {
"type": "string"
},
"at": {
"type": "number"
}
}
}
}
}
}
},
"journalTotal": {
"type": "integer",
"minimum": 0
}
}
}
```
### manager run-ps
Registered declaration:
```json
{
"name": "run-ps",
"class": "ephemeral",
"targeted": false,
"capability": "manager.read",
"inputDigest": "sha256:dffa73003c2d1326c8b5f388133795b1413a51859d792f54faa88247951f5f4c",
"outputDigest": "sha256:b8fb0446dd0c7f7656a874b6e703aa1130702642dc9ee646682a0440c3fa0237"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"properties": {
"endpoint": {
"type": "string",
"minLength": 1
},
"page": {
"type": "object",
"additionalProperties": false,
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 16
},
"cursor": {
"type": "string",
"minLength": 1,
"maxLength": 3072,
"pattern": "^[A-Za-z0-9_-]+$"
}
}
}
}
}
```
Output schema:
```json
{
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"runId",
"endpoint"
],
"properties": {
"runId": {
"type": "string"
},
"endpoint": {
"type": "string"
},
"state": {
"type": "string",
"enum": [
"running",
"released",
"completed",
"failed"
]
},
"holder": {
"type": "string"
},
"epoch": {
"type": "integer",
"minimum": 0
},
"journalHigh": {
"type": "integer",
"minimum": -1
},
"failure": {
"type": "object",
"additionalProperties": false,
"required": [
"message"
],
"properties": {
"code": {
"type": "string",
"pattern": "^L[0-9]{4}$"
},
"message": {
"type": "string"
}
}
},
"startedAt": {
"type": "number"
},
"programHash": {
"type": "string"
},
"forkedFrom": {
"type": "object",
"additionalProperties": false,
"required": [
"run",
"step"
],
"properties": {
"run": {
"type": "string"
},
"step": {
"type": "string"
}
}
},
"revoked": {
"type": "object",
"additionalProperties": false,
"required": [
"by",
"reason"
],
"properties": {
"by": {
"type": "string"
},
"reason": {
"type": "string"
}
}
},
"revocationUnreadable": {
"type": "string"
}
}
}
},
{
"type": "object",
"additionalProperties": false,
"required": [
"v",
"semantics",
"space",
"endpointFilter",
"responder",
"cutSeq",
"nextSeq",
"items",
"endObserved",
"stopReason",
"storageReads"
],
"properties": {
"v": {
"const": 1
},
"semantics": {
"const": "diagnostic"
},
"space": {
"type": "string"
},
"endpointFilter": {
"anyOf": [
{
"type": "null"
},
{
"type": "string",
"minLength": 1,
"maxLength": 64
}
]
},
"responder": {
"type": "object",
"additionalProperties": false,
"required": [
"instanceId",
"epoch"
],
"properties": {
"instanceId": {
"type": "string",
"pattern": "^[a-z0-9]{26,32}$"
},
"epoch": {
"type": "integer",
"minimum": 0
}
}
},
"cutSeq": {
"type": "integer",
"minimum": 0,
"maximum": 9007199254740990
},
"nextSeq": {
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"items": {
"type": "array",
"maxItems": 16,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"endpoint",
"runId",
"specRevision",
"startedAt",
"observedAt",
"status",
"revocation"
],
"properties": {
"endpoint": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"runId": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$"
},
"specRevision": {
"type": "integer",
"minimum": 1
},
"startedAt": {
"type": "number",
"minimum": 0
},
"observedAt": {
"type": "number",
"minimum": 0
},
"status": {
"anyOf": [
{
"type": "null"
},
{
"type": "object",
"additionalProperties": false,
"required": [
"v",
"observedSpecRevision",
"state",
"holder",
"epoch",
"fencingToken",
"journalHigh",
"at",
"statusRevision",
"staleProjection"
],
"properties": {
"v": {
"const": 1
},
"observedSpecRevision": {
"type": "integer",
"minimum": 0
},
"state": {
"type": "string",
"enum": [
"running",
"released",
"completed",
"failed"
]
},
"holder": {
"type": "string"
},
"epoch": {
"type": "integer",
"minimum": 0
},
"fencingToken": {
"type": "integer",
"minimum": 0
},
"journalHigh": {
"type": "integer",
"minimum": -1
},
"at": {
"type": "number",
"minimum": 0
},
"statusRevision": {
"type": "integer",
"minimum": 1
},
"staleProjection": {
"type": "boolean"
}
}
}
]
},
"revocation": {
"enum": [
"present",
"not-observed"
]
}
}
}
},
"nextCursor": {
"type": "string",
"minLength": 1,
"maxLength": 3072,
"pattern": "^[A-Za-z0-9_-]+$"
},
"endObserved": {
"type": "boolean"
},
"stopReason": {
"enum": [
"end",
"rows",
"bytes",
"read-budget"
]
},
"storageReads": {
"type": "integer",
"minimum": 0,
"maximum": 64
}
}
}
]
}
```
### manager goal-result
Registered declaration:
```json
{
"name": "goal-result",
"class": "ephemeral",
"targeted": false,
"capability": "manager.read",
"inputDigest": "sha256:d85c21db12518b997058347762cabad0a41f6f63d32a9b487abbeae49a51ecd1",
"outputDigest": "sha256:df1e8e4a9c3b5865f022b39638db4fc6ef9199a924ea5e70f82a165beb022d46"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"goalId"
],
"properties": {
"goalId": {
"type": "string",
"minLength": 1
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"goalId"
],
"properties": {
"goalId": {
"type": "string",
"minLength": 1
},
"result": {
"type": "object"
}
}
}
```
### manager define-persona
Registered declaration:
```json
{
"name": "define-persona",
"class": "ephemeral",
"targeted": false,
"capability": "manager.persona",
"inputDigest": "sha256:b1aa72d7b2aa88cde94bde2e97e3fd612dfada752b52e8c9b0acbae5f528dea4",
"outputDigest": "sha256:a121baba27357c3710b20023422927b0c11d4d1d58a542f909efd7ad1152751c"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"name",
"persona"
],
"properties": {
"name": {
"type": "string",
"minLength": 1
},
"persona": {
"type": "string",
"minLength": 1
},
"model": {
"type": "string",
"pattern": "^\\s*\\S"
},
"role": {
"type": "string",
"pattern": "^\\s*\\S"
},
"agent": {
"type": "string",
"pattern": "^\\s*\\S"
},
"subscribe": {
"type": "array",
"items": {
"type": "string"
}
},
"allowSubscribe": {
"type": "array",
"items": {
"type": "string"
}
},
"allowPublish": {
"type": "array",
"items": {
"type": "string"
}
},
"capabilities": {
"type": "array",
"items": {
"type": "string"
}
},
"endpoints": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"endpoint",
"commands"
],
"properties": {
"endpoint": {
"type": "string"
},
"commands": {
"type": "array",
"items": {
"type": "string"
}
},
"instanceId": {
"type": "string"
}
}
}
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"name",
"path"
],
"properties": {
"name": {
"type": "string"
},
"path": {
"type": "string"
}
}
}
```
### manager remove-persona
Registered declaration:
```json
{
"name": "remove-persona",
"class": "ephemeral",
"targeted": false,
"capability": "manager.persona",
"inputDigest": "sha256:f73163e07e3006cd60057db30a9a73f97922c4933307ac3eff25940fc7bc5c2b",
"outputDigest": "sha256:e1786e14b9f948f90ccd31cae7b7b535f77a5d86e88f5ccea0030347f660e7f7"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]+$"
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
}
}
}
```
### manager chat-session-open
Registered declaration:
```json
{
"name": "chat-session-open",
"class": "ephemeral",
"targeted": false,
"capability": "manager.chat",
"inputDigest": "sha256:372937ec2609c503be78ec18b88ab69171560fb513f4e086d35929f154024897",
"outputDigest": "sha256:d06af8eb81792c588149d46884195f7e969e6b588bc452ff6890e0a1ec848b96"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"label",
"ttl",
"sealTo"
],
"properties": {
"subscribe": {
"type": "array",
"maxItems": 64,
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1
}
},
"allowSubscribe": {
"type": "array",
"maxItems": 64,
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1
}
},
"allowPublish": {
"type": "array",
"maxItems": 64,
"uniqueItems": true,
"items": {
"type": "string",
"minLength": 1
}
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"ttl": {
"type": "integer",
"minimum": 1,
"maximum": 900
},
"sealTo": {
"type": "string",
"pattern": "^X[A-Z2-7]{55}$"
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"alias",
"actor",
"lifecycleUid",
"expiresAt",
"sealer",
"sealed"
],
"properties": {
"alias": {
"type": "string",
"pattern": "^chat_[a-z2-7]{26}$"
},
"actor": {
"type": "string",
"minLength": 1
},
"lifecycleUid": {
"type": "string",
"minLength": 1
},
"expiresAt": {
"type": "integer",
"minimum": 0
},
"sealer": {
"type": "string",
"pattern": "^X[A-Z2-7]{55}$"
},
"sealed": {
"type": "string",
"minLength": 1
}
}
}
```
### manager chat-session-retire
Registered declaration:
```json
{
"name": "chat-session-retire",
"class": "ephemeral",
"targeted": false,
"capability": "manager.chat",
"inputDigest": "sha256:090530663f13f4091fd291e08c8680a6dc50bf07f9978308ce704eab07178353",
"outputDigest": "sha256:4f7241c6c87230f843a0fd9b85f38d148384c914faecdab8299a10a8a3ab83d2"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"alias",
"actor",
"lifecycleUid"
],
"properties": {
"alias": {
"type": "string",
"pattern": "^chat_[a-z2-7]{26}$"
},
"actor": {
"type": "string",
"minLength": 1
},
"lifecycleUid": {
"type": "string",
"minLength": 1
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"outcome"
],
"properties": {
"outcome": {
"enum": [
"retired",
"alreadyRetired",
"failed"
]
},
"reason": {
"type": "string"
}
}
}
```
### manager list-personas
Registered declaration:
```json
{
"name": "list-personas",
"class": "ephemeral",
"targeted": false,
"capability": "manager.read",
"inputDigest": "sha256:1db0472aaee8e6b9d8d3d430ee021a1b6efc559ab7c0b99186898c972c53dd2d",
"outputDigest": "sha256:bb37634698c67b4468dd1c85dfbcfa0c13125f91aed9fd0769ee813438048c49"
}
```
Input schema:
```json
{
"type": "null"
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"personas"
],
"properties": {
"personas": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"role": {
"type": "string"
},
"model": {
"type": "string"
},
"description": {
"type": "string"
},
"owner": {
"type": "string"
},
"error": {
"type": "string"
}
}
}
}
}
}
```
### manager show-persona
Registered declaration:
```json
{
"name": "show-persona",
"class": "ephemeral",
"targeted": false,
"capability": "manager.read",
"inputDigest": "sha256:c74bfe6c0426cf31f56796a48992639eb08a46c36f7dd7205b497cf2c83a8382",
"outputDigest": "sha256:45118d9dfc9803469c095dc2d34d8f6bec6b48eec90d8017f4617acc9d6fb7d2"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"minLength": 1
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"name"
],
"properties": {
"name": {
"type": "string"
},
"role": {
"type": "string"
},
"model": {
"type": "string"
},
"description": {
"type": "string"
},
"owner": {
"type": "string"
},
"persona": {
"type": "string"
},
"error": {
"type": "string"
}
}
}
```
### manager purge
Registered declaration:
```json
{
"name": "purge",
"class": "ephemeral",
"targeted": false,
"capability": "manager.admin",
"inputDigest": "sha256:fc7eb2289bcdc583558efe1127c5f8ab988649ecbe0a0e950dd175c512b4cd86",
"outputDigest": "sha256:dc91365525849af1bd5dfacedd4b5b6fbdc611db99c2478a803ee8995191ee4e"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"properties": {
"includeDms": {
"type": "boolean"
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"chat"
],
"properties": {
"chat": {
"type": "integer",
"minimum": 0
},
"dm": {
"type": "integer",
"minimum": 0
}
}
}
```
### manager launch
Registered declaration:
```json
{
"name": "launch",
"class": "ephemeral",
"targeted": false,
"capability": "manager.admin",
"inputDigest": "sha256:dc33bfbeba9027bba4e06e0d96ea5ea0bdb2f412899707288ba0e534d88dc565",
"outputDigest": "sha256:d883a9f97f7c034772c7cbc28b22d63cf69870ba072d470c2f7b104f455e2e83"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"runId",
"name"
],
"properties": {
"runId": {
"type": "string",
"minLength": 1
},
"name": {
"type": "string",
"minLength": 1
},
"spec": {
"type": "object"
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"name",
"owner",
"actor",
"uid",
"goalId",
"fingerprint",
"executor"
],
"properties": {
"name": {
"type": "string"
},
"owner": {
"type": "string"
},
"actor": {
"type": "string"
},
"uid": {
"type": "string"
},
"goalId": {
"type": "string"
},
"fingerprint": {
"type": "string"
},
"readinessDeadlineMs": {
"type": "integer",
"minimum": 1
},
"executor": {
"type": "object",
"additionalProperties": false,
"required": [
"lifecycleUid",
"epoch"
],
"properties": {
"lifecycleUid": {
"type": "string"
},
"epoch": {
"type": "integer",
"minimum": 0
}
}
}
}
}
```
### manager resume-preserved
Registered declaration:
```json
{
"name": "resume-preserved",
"class": "ephemeral",
"targeted": false,
"capability": "manager.admin",
"inputDigest": "sha256:204aa0baa9794e9c0183cf62666928f0a8a04811aa92b4ce73e5c12a0574b5b9",
"outputDigest": "sha256:241df3a8f87af62ea53beb2267ab5309af830a357180952924a0fca26e748efb"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"attemptId",
"inventory"
],
"properties": {
"attemptId": {
"type": "string",
"minLength": 1
},
"inventory": {
"type": "object"
}
}
}
```
Output schema:
```json
{
"type": "object"
}
```
### manager commit-resume
Registered declaration:
```json
{
"name": "commit-resume",
"class": "ephemeral",
"targeted": false,
"capability": "manager.admin",
"inputDigest": "sha256:b863e0912fbf9344b346a1f69179a1039254fad2a5dec27cb691fd7812617976",
"outputDigest": "sha256:b89dc03ca8afa323c4e36ad54e8af032fa084aba04e0c3f6b27ef5df4788f46c"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"attemptId"
],
"properties": {
"attemptId": {
"type": "string",
"minLength": 1
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"attemptId",
"state",
"durableCommitToken"
],
"properties": {
"attemptId": {
"type": "string"
},
"state": {
"type": "string"
},
"durableCommitToken": {
"type": "string"
}
}
}
```
### manager finalize-resume
Registered declaration:
```json
{
"name": "finalize-resume",
"class": "ephemeral",
"targeted": false,
"capability": "manager.admin",
"inputDigest": "sha256:7df6373748333f8c0907dc38eaca8596714aad3a05cf11974bef97cd328f238c",
"outputDigest": "sha256:959dbd34809db2f410c4f983b1cb0bf7a7fbf24d275ceb5fd097979e46e1fee7"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"attemptId",
"durableCommitToken"
],
"properties": {
"attemptId": {
"type": "string",
"minLength": 1
},
"durableCommitToken": {
"type": "string",
"minLength": 1
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"attemptId",
"state"
],
"properties": {
"attemptId": {
"type": "string"
},
"state": {
"type": "string"
}
}
}
```
### manager prepare-preservation
Registered declaration:
```json
{
"name": "prepare-preservation",
"class": "ephemeral",
"targeted": false,
"capability": "manager.admin",
"inputDigest": "sha256:b863e0912fbf9344b346a1f69179a1039254fad2a5dec27cb691fd7812617976",
"outputDigest": "sha256:241df3a8f87af62ea53beb2267ab5309af830a357180952924a0fca26e748efb"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"attemptId"
],
"properties": {
"attemptId": {
"type": "string",
"minLength": 1
}
}
}
```
Output schema:
```json
{
"type": "object"
}
```
### manager commit-preservation
Registered declaration:
```json
{
"name": "commit-preservation",
"class": "ephemeral",
"targeted": false,
"capability": "manager.admin",
"inputDigest": "sha256:b863e0912fbf9344b346a1f69179a1039254fad2a5dec27cb691fd7812617976",
"outputDigest": "sha256:241df3a8f87af62ea53beb2267ab5309af830a357180952924a0fca26e748efb"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"attemptId"
],
"properties": {
"attemptId": {
"type": "string",
"minLength": 1
}
}
}
```
Output schema:
```json
{
"type": "object"
}
```
### manager abort-preservation
Registered declaration:
```json
{
"name": "abort-preservation",
"class": "ephemeral",
"targeted": false,
"capability": "manager.admin",
"inputDigest": "sha256:b863e0912fbf9344b346a1f69179a1039254fad2a5dec27cb691fd7812617976",
"outputDigest": "sha256:959dbd34809db2f410c4f983b1cb0bf7a7fbf24d275ceb5fd097979e46e1fee7"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"attemptId"
],
"properties": {
"attemptId": {
"type": "string",
"minLength": 1
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"attemptId",
"state"
],
"properties": {
"attemptId": {
"type": "string"
},
"state": {
"type": "string"
}
}
}
```
### manager transcript-receive
Registered declaration:
```json
{
"name": "transcript-receive",
"class": "ephemeral",
"targeted": false,
"capability": "manager.admin",
"inputDigest": "sha256:af7e6146da1d67b985d06171139d1cba1e8bd812ac2f96b1b481db9ef1918e1f",
"outputDigest": "sha256:1ee2030f621873f348aee7f7daca6411f1814e4ad4bdbe1065377c8030d4afa8"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"sha256",
"size",
"source",
"sourceHost"
],
"properties": {
"sha256": {
"type": "string",
"pattern": "^[0-9a-f]{64}$"
},
"size": {
"type": "integer",
"minimum": 0
},
"source": {
"type": "string",
"minLength": 1
},
"sourceHost": {
"type": "string",
"minLength": 1
},
"title": {
"type": "string"
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"state"
],
"properties": {
"state": {
"type": "string",
"enum": [
"upload",
"staged"
]
},
"claim": {
"type": "string"
},
"fetched": {
"type": "boolean"
}
}
}
```
## auth
Cluster `ai.cotal.auth`, revision 1. 1 commands.
| Command | Capability | Class | Target modes |
| -------------------------------------------- | ------------ | --------- | ------------ |
| [`retire-lifecycle`](#auth-retire-lifecycle) | `auth.admin` | ephemeral | exact |
### auth retire-lifecycle
Registered declaration:
```json
{
"name": "retire-lifecycle",
"class": "ephemeral",
"targeted": true,
"modes": [
"exact"
],
"capability": "auth.admin",
"inputDigest": "sha256:6d87fc4ef53998c80e6670eba5e0dfb44988421e25cc40fe5b57c69fd39b02db",
"outputDigest": "sha256:1d166387571a054df00aab485bc3ae5daa80c32830212ee3701a9a3fcfaafbec"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"opId",
"serveEndpoint",
"serveInstanceId",
"serveEpoch"
],
"properties": {
"opId": {
"type": "string"
},
"serveEndpoint": {
"type": "string"
},
"serveInstanceId": {
"type": "string"
},
"serveEpoch": {
"type": "integer",
"minimum": 0
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"retired",
"lifecycleUid",
"opId",
"evictedPrincipals"
],
"properties": {
"retired": {
"type": "boolean"
},
"lifecycleUid": {
"type": "string"
},
"opId": {
"type": "string"
},
"evictedPrincipals": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
```
## registry
Cluster `ai.cotal.registry`, revision 1. 1 commands.
| Command | Capability | Class | Target modes |
| ---------------------------------- | -------------------- | --------- | ------------ |
| [`endpoints`](#registry-endpoints) | `registry.endpoints` | ephemeral | untargeted |
### registry endpoints
Registered declaration:
```json
{
"name": "endpoints",
"class": "ephemeral",
"targeted": false,
"capability": "registry.endpoints",
"inputDigest": "sha256:dbad33c4a2b77079ceca72beb1a9645dcc35757932a80349c8ae6ddc97dbda5a",
"outputDigest": "sha256:d41895936172446a6b7f82e53cacb477b3459a0458be98a8cc3e47945a0868f1"
}
```
Input schema:
```json
{
"type": "object",
"additionalProperties": false,
"properties": {
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100
},
"after": {
"type": "string",
"minLength": 1,
"maxLength": 128
}
}
}
```
Output schema:
```json
{
"type": "object",
"additionalProperties": false,
"required": [
"rows",
"source"
],
"properties": {
"rows": {
"type": "array",
"maxItems": 100,
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"endpoint",
"instances",
"commands"
],
"properties": {
"endpoint": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"instances": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"instanceId",
"state",
"artifacts"
],
"properties": {
"instanceId": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"state": {
"type": [
"string",
"null"
],
"maxLength": 64
},
"artifacts": {
"enum": [
"verified",
"missing",
"invalid"
]
}
}
}
},
"commands": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"name",
"class",
"forms"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"class": {
"enum": [
"ephemeral",
"journal"
]
},
"forms": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": false,
"required": [
"rail",
"literals",
"covered"
],
"properties": {
"rail": {
"enum": [
"ep",
"ep.v1",
"epj"
]
},
"route": {
"enum": [
"one",
"all",
"inst"
]
},
"mode": {
"type": "string",
"minLength": 1,
"maxLength": 64
},
"literals": {
"type": "object",
"additionalProperties": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
}
},
"covered": {
"type": "array",
"items": {
"type": "object",
"additionalProperties": {
"type": [
"string",
"null"
],
"maxLength": 64
}
}
}
}
}
},
"instances": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
}
}
}
},
"unprojected": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
}
}
}
},
"next": {
"type": "string",
"minLength": 1,
"maxLength": 128
},
"source": {
"enum": [
"recorded-ceiling",
"no-permission-system"
]
}
}
}
```
## Regeneration
Run `pnpm gen:meshdocs` from the repository root. The generator reads the service contract modules and verifies each schema closure against its declared digest. `pnpm check:meshdocs` checks the generated entries and schemas against those contracts without writing the page. The docs-bundle check also detects stale generated bytes.