ContractSpec docs

OSS-first docs

These docs teach the open system first: contracts, generated surfaces, runtimes, governance, and incremental adoption. Studio shows up as the operating layer on top, not as the source of truth.

AI index

SharedTask + TaskEntity — Cross-Context Task (A9 Invariant)

SharedTask carries both dependsOn? (workflow DAG) and parent? (agent tree) as optional. Validators enforce mutual exclusion per A9. TaskEntity is the Layer-1 contract registration.

field.key.label
SharedTask + TaskEntity — Cross-Context Task (A9 Invariant)
field.version.label
field.type.label
field.title.label
SharedTask + TaskEntity — Cross-Context Task (A9 Invariant)
field.description.label

SharedTask carries both dependsOn? (workflow DAG) and parent? (agent tree) as optional. Validators enforce mutual exclusion per A9. TaskEntity is the Layer-1 contract registration.

field.tags.label
tech,contracts,shared-entities,task,a9,workflow,agent
field.owners.label
field.stability.label
public

A9 Invariant

| Field | Context | Validator rejects | |-------|---------|------------------| | `dependsOn?` | Workflow DAG | Agent validator | | `parent?` | Agent tree | Workflow validator |

Both `undefined` → root task (valid in either context).

V2 Execution Fields (Path B parity)

•

`type`: `automation` (default) | `human` | `decision`

•

`operation?: OpRef` — dispatched by the V2 runner's OperationExecutor

•

`guard?` — expression or policy guard evaluated before execution; task skipped on false

•

`retry?` — fixed/exponential backoff with configurable attempts, delay, and cap

•

`timeoutMs?` — per-task timeout; raises `WorkflowExecutionError('timeout')`

•

`requiredIntegrations?` — slot IDs checked during pre-flight

•

`requiredCapabilities?` — CapabilityRefs checked during pre-flight