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

graph.compose — build a graph from a NL spec

Generates a GraphConstruction[] mutation sequence from a natural-language description. Supports dry-run preview. Budget: 2 500 in / 1 200 out / $0.030.

field.key.label
graph.compose — build a graph from a NL spec
field.version.label
field.type.label
field.title.label
graph.compose — build a graph from a NL spec
field.description.label

Generates a GraphConstruction[] mutation sequence from a natural-language description. Supports dry-run preview. Budget: 2 500 in / 1 200 out / $0.030.

field.tags.label
automation,agent,execution,graph,ai,compose,generation,m5
field.owners.label
field.stability.label
public

Translates a natural-language description into a `GraphConstruction[]` mutation sequence that the graph runtime can apply to create or extend a graph.

Construction types

`create_node`

{ "type": "create_node", "nodeId": "n1", "label": "Build", "kind": "task", "metadata": {} }

`create_edge`

{ "type": "create_edge", "edgeId": "e1", "from": "n1", "to": "n2", "label": "triggers", "kind": "flow" }

`set_metadata`

{ "type": "set_metadata", "nodeId": "n1", "metadata": { "owner": "ci-team" } }

Style hints

•

`workflow` — linear/branching task sequence

•

`sequence` — time-ordered event chain

•

`hierarchy` — parent/child containment tree

•

`dependency` — directed dependency graph

•

`freeform` — no structural bias (default)

Dry run

Pass `dryRun: true` to preview the construction without applying it. `applied` is `false` in the response; no state is mutated.

Budget (M5 P2/W2.3)

maxInputTokens=2 500 · maxOutputTokens=1 200 · hardCapUsd=$0.030