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

AiAgentEditor — graph editing session contract

Composes GraphConversation with graphOps capability refs for the AiPairPanel editing session.

field.key.label
AiAgentEditor — graph editing session contract
field.version.label
field.type.label
field.title.label
AiAgentEditor — graph editing session contract
field.description.label

Composes GraphConversation with graphOps capability refs for the AiPairPanel editing session.

field.tags.label
automation,agent,execution,graph,ai,conversation,m5
field.owners.label
platform.ai
field.stability.label
public

Session contract that wires a `GraphConversation` to the set of graph operations available to the AI agent in this editing context.

Key invariants

•

`autoCommit` must default to `false` (W7.4 suggestion-confirmation UX)

•

`availableOps` defaults to all graphOps + `graph.edit`

•

`contextGraphId` matches the `contextGraphId` accepted by all graphOps commands

Composition

`AiAgentEditor` is the session state held by `AiPairPanel` (M5 P3/W3.1). Each user interaction advances `conversation.history` and may trigger one or more graphOps/edit tool calls.