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

GraphConversation — AI session history buffer

Ordered turn history + capacity ceiling for AI graph agent sessions. Session identity via sessionId.

field.key.label
GraphConversation — AI session history buffer
field.version.label
field.type.label
field.title.label
GraphConversation — AI session history buffer
field.description.label

Ordered turn history + capacity ceiling for AI graph agent sessions. Session identity via sessionId.

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

Session history buffer for the AI graph agent. Holds up to `capacity` turns (default 20, max 50).

Cost alignment

Capacity is bounded to keep context-window token costs within the per-session $0.50 ceiling defined in `m3-p0-ai-cost-ceiling.md`.

Fields

| field | description | |-------|-------------| | `sessionId` | Stable session identifier | | `history` | Ordered AiTurnState array (oldest first) | | `capacity` | Max retained turns before eviction | | `createdAt` | ISO 8601 timestamp when the session was created |