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.edit — LLM-driven node/edge mutations

Single command for all structural graph mutations (add/remove/rename node, add/remove edge, edit metadata). Per-call budget: 1 500 in / 500 out / $0.025. Requires confirmation token for destructive ops.

field.key.label
graph.edit — LLM-driven node/edge mutations
field.version.label
field.type.label
field.title.label
graph.edit — LLM-driven node/edge mutations
field.description.label

Single command for all structural graph mutations (add/remove/rename node, add/remove edge, edit metadata). Per-call budget: 1 500 in / 500 out / $0.025. Requires confirmation token for destructive ops.

field.tags.label
automation,agent,execution,graph,ai,edit,mutation,m5
field.owners.label
field.stability.label
public

Executes a batch of structural graph mutations in a single LLM tool call.

Supported ops (discriminated by `type`)

| type | Description | |---|---| | `add_node` | Insert node (id, label?, kind?, metadata?) | | `remove_node` | Delete node + all incident edges | | `rename_node` | Update node label | | `edit_metadata` | Patch metadata on node or edge | | `add_edge` | Insert directed edge (id, from, to, label?, kind?) | | `remove_edge` | Delete edge |

Max **20 ops per call** to stay within the token budget.

Confirmation requirement

Destructive ops (`remove_node`, `remove_edge`) require a `confirmationToken` issued by the AI suggestion confirmation UX (W7.4). The command returns `CONFIRMATION_REQUIRED` (403) when the token is absent or invalid.

Budget (M5 P2/W2.1)

maxInputTokens=1 500 · maxOutputTokens=500 · hardCapUsd=$0.025