{
  "id": "shared-context-spec:agent-mux-gateway-frame-session-start",
  "_kind": "SharedContextSpec",
  "_file": "extensions/shared-context-specs/agent-mux-gateway-protocol-frames.yaml",
  "_cluster": "extensions",
  "attributes": {
    "displayName": "SessionStartFrame (client→server, request/response)",
    "contextKind": "websocket-frame-client",
    "typescriptInterface": "SessionStartFrame",
    "producerIface": "@a5c-ai/agent-mux-gateway client",
    "consumerIfaces": [
      "handleRequestFrame 'session.start' (server.ts:742-774)"
    ],
    "fieldSchema": [
      "type:literal<session.start>:required:Frame discriminator",
      "agent:string:required:Adapter agent name (must be runnable / available)",
      "prompt:string:required:Initial prompt text",
      "model:string:optional:Override model id",
      "attachments:list<Attachment>:optional:Attachments lifted via sanitizeAttachments (filePath | url | base64 + mimeType + name)",
      "approvalMode:enum<yolo|prompt|deny>:optional:Tool-approval policy for the session",
      "sessionId:string:optional:Reuse an existing session id",
      "runId:string:optional:Caller-supplied Crockford-base32 26-char run id (else generated)",
      "cwd:string:optional:Working directory override",
      "workspaceId:string:optional:Workspace context id",
      "forkSessionId:string:optional:Source session id when forking"
    ],
    "sourceCitation": "packages/agent-mux/gateway/src/protocol/v1.ts:46-58; frames.ts:47-59"
  },
  "outgoingEdges": [],
  "incomingEdges": [
    {
      "from": "package:a5c-ai-agent-mux-gateway",
      "to": "shared-context-spec:agent-mux-gateway-frame-session-start",
      "kind": "has_payload_schema",
      "attributes": {}
    }
  ]
}