{ "components": { "headers": { "X-GC-Request-Id": { "description": "Opaque per-response identifier assigned by the server for log correlation. Every response carries this header.", "schema": { "description": "Opaque per-response identifier assigned by the server for log correlation. Every response carries this header.", "type": "string" } } }, "schemas": { "AdapterCapabilities": { "additionalProperties": false, "properties": { "MaxMessageLength": { "format": "int64", "type": "integer" }, "SupportsAttachments": { "type": "boolean" }, "SupportsChildConversations": { "type": "boolean" } }, "required": [ "SupportsChildConversations", "SupportsAttachments", "MaxMessageLength" ], "type": "object" }, "AdapterEventPayload": { "additionalProperties": false, "properties": { "account_id": { "type": "string" }, "provider": { "type": "string" } }, "required": [ "provider", "account_id" ], "type": "object" }, "AgentCreateInputBody": { "additionalProperties": false, "properties": { "dir": { "description": "Working directory (rig name).", "type": "string" }, "name": { "description": "Agent name.", "examples": [ "deacon-1" ], "minLength": 1, "type": "string" }, "provider": { "description": "Provider name.", "examples": [ "claude" ], "minLength": 1, "type": "string" }, "scope": { "description": "Agent scope.", "type": "string" } }, "required": [ "name", "provider" ], "type": "object" }, "AgentCreatedOutputBody": { "additionalProperties": false, "properties": { "agent": { "description": "Created agent name.", "type": "string" }, "status": { "description": "Operation result.", "examples": [ "created" ], "type": "string" } }, "required": [ "status", "agent" ], "type": "object" }, "AgentMapping": { "additionalProperties": false, "properties": { "agent_id": { "type": "string" }, "parent_tool_use_id": { "type": "string" } }, "required": [ "agent_id", "parent_tool_use_id" ], "type": "object" }, "AgentOutputResponse": { "additionalProperties": false, "properties": { "agent": { "type": "string" }, "format": { "type": "string" }, "pagination": { "$ref": "#/components/schemas/PaginationInfo" }, "turns": { "items": { "$ref": "#/components/schemas/OutputTurn" }, "type": [ "array", "null" ] } }, "required": [ "agent", "format", "turns" ], "type": "object" }, "AgentPatch": { "additionalProperties": false, "properties": { "AppendFragments": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "Args": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "AssignedWorkDeferLimit": { "format": "int64", "type": [ "integer", "null" ] }, "Attach": { "type": [ "boolean", "null" ] }, "AutoReclaimStaleClaims": { "type": [ "boolean", "null" ] }, "ContextAdvisory": { "$ref": "#/components/schemas/ContextAdvisory" }, "DefaultSlingFormula": { "type": [ "string", "null" ] }, "DependsOn": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "Dir": { "type": "string" }, "Env": { "additionalProperties": { "type": "string" }, "type": "object" }, "EnvRemove": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "HooksInstalled": { "type": [ "boolean", "null" ] }, "IdleTimeout": { "type": [ "string", "null" ] }, "InjectAssignedSkills": { "type": [ "boolean", "null" ] }, "InjectFragments": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "InjectFragmentsAppend": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "InstallAgentHooks": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "InstallAgentHooksAppend": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "Lifecycle": { "type": [ "string", "null" ] }, "MCP": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "MCPAppend": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "MaxActiveSessions": { "format": "int64", "type": [ "integer", "null" ] }, "MaxSessionAge": { "type": [ "string", "null" ] }, "MaxSessionAgeJitter": { "type": [ "string", "null" ] }, "MinActiveSessions": { "format": "int64", "type": [ "integer", "null" ] }, "MouseMode": { "type": [ "string", "null" ] }, "Name": { "type": "string" }, "Nudge": { "type": [ "string", "null" ] }, "OptionDefaults": { "additionalProperties": { "type": "string" }, "type": "object" }, "OverlayDir": { "type": [ "string", "null" ] }, "Pool": { "$ref": "#/components/schemas/PoolOverride" }, "PreStart": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "PreStartAppend": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "PromptTemplate": { "type": [ "string", "null" ] }, "Provider": { "type": [ "string", "null" ] }, "ResumeCommand": { "type": [ "string", "null" ] }, "Rig": { "type": "string" }, "ScaleCheck": { "type": [ "string", "null" ] }, "Scope": { "type": [ "string", "null" ] }, "Session": { "type": [ "string", "null" ] }, "SessionLive": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "SessionLiveAppend": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "SessionSetup": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "SessionSetupAppend": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "SessionSetupScript": { "type": [ "string", "null" ] }, "Skills": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "SkillsAppend": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "SleepAfterIdle": { "type": [ "string", "null" ] }, "StartCommand": { "type": [ "string", "null" ] }, "Suspended": { "type": [ "boolean", "null" ] }, "TmuxAlias": { "type": [ "string", "null" ] }, "Upstream": { "type": [ "string", "null" ] }, "WakeMode": { "type": [ "string", "null" ] }, "WorkDir": { "type": [ "string", "null" ] } }, "required": [ "Dir", "Rig", "Name", "WorkDir", "TmuxAlias", "Scope", "Suspended", "Pool", "Env", "EnvRemove", "PreStart", "PromptTemplate", "Session", "Provider", "ContextAdvisory", "Upstream", "Args", "StartCommand", "Lifecycle", "Nudge", "IdleTimeout", "MaxSessionAge", "MaxSessionAgeJitter", "AssignedWorkDeferLimit", "SleepAfterIdle", "AutoReclaimStaleClaims", "InstallAgentHooks", "Skills", "MCP", "SkillsAppend", "MCPAppend", "HooksInstalled", "InjectAssignedSkills", "SessionSetup", "SessionSetupScript", "SessionLive", "OverlayDir", "DefaultSlingFormula", "InjectFragments", "AppendFragments", "Attach", "DependsOn", "ResumeCommand", "WakeMode", "MouseMode", "PreStartAppend", "SessionSetupAppend", "SessionLiveAppend", "InstallAgentHooksAppend", "InjectFragmentsAppend", "MaxActiveSessions", "MinActiveSessions", "ScaleCheck", "OptionDefaults" ], "type": "object" }, "AgentPatchSetInputBody": { "additionalProperties": false, "properties": { "dir": { "description": "Agent directory scope (legacy targeting key; prefer rig).", "type": "string" }, "env": { "additionalProperties": { "type": "string" }, "description": "Override environment variables.", "type": "object" }, "name": { "description": "Agent name.", "type": "string" }, "provider": { "description": "Override the agent's provider.", "type": "string" }, "rig": { "description": "Rig targeting key. \"*\" matches the agent name across all rigs and city. Mutually exclusive with dir.", "type": "string" }, "scope": { "description": "Override agent scope.", "type": "string" }, "suspended": { "description": "Override suspended state.", "type": "boolean" }, "tmux_alias": { "description": "Override tmux session name template.", "type": "string" }, "work_dir": { "description": "Override session working directory.", "type": "string" } }, "type": "object" }, "AgentResponse": { "additionalProperties": false, "properties": { "active_bead": { "type": "string" }, "activity": { "type": "string" }, "available": { "type": "boolean" }, "context_pct": { "format": "int64", "type": "integer" }, "context_window": { "format": "int64", "type": "integer" }, "description": { "type": "string" }, "display_name": { "type": "string" }, "last_output": { "type": "string" }, "model": { "type": "string" }, "name": { "type": "string" }, "pack": { "type": "string" }, "pack_derived": { "type": "boolean" }, "pool": { "description": "Qualified name of the configured pool this row belongs to. Equals name on the row for an on-demand pool that has no live session.", "type": "string" }, "pool_limits": { "$ref": "#/components/schemas/PoolLimits", "description": "Configured session limits of the agent (or of its pool)." }, "provider": { "type": "string" }, "rig": { "type": "string" }, "running": { "type": "boolean" }, "session": { "$ref": "#/components/schemas/SessionInfo" }, "state": { "type": "string" }, "suspended": { "type": "boolean" }, "unavailable_reason": { "type": "string" } }, "required": [ "name", "running", "suspended", "pack_derived", "state", "available" ], "type": "object" }, "AgentUpdateInputBody": { "additionalProperties": false, "properties": { "provider": { "description": "Provider name.", "type": "string" }, "scope": { "description": "Agent scope.", "type": "string" }, "suspended": { "description": "Whether agent is suspended.", "type": "boolean" } }, "type": "object" }, "AgentUpdateQualifiedInputBody": { "additionalProperties": false, "properties": { "provider": { "description": "Provider name.", "type": "string" }, "scope": { "description": "Agent scope.", "type": "string" }, "suspended": { "description": "Whether agent is suspended.", "type": "boolean" } }, "type": "object" }, "AnnotatedAgentResponse": { "additionalProperties": false, "properties": { "dir": { "type": "string" }, "is_pool": { "type": "boolean" }, "name": { "type": "string" }, "origin": { "description": "Agent origin: inline or pack-derived.", "type": "string" }, "provider": { "type": "string" }, "scope": { "type": "string" }, "suspended": { "type": "boolean" } }, "required": [ "name", "suspended", "origin" ], "type": "object" }, "AnnotatedProviderResponse": { "additionalProperties": false, "properties": { "acp_args": { "items": { "type": "string" }, "type": "array" }, "acp_command": { "type": "string" }, "args": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "command": { "type": "string" }, "display_name": { "type": "string" }, "env": { "additionalProperties": { "type": "string" }, "type": "object" }, "origin": { "description": "Provider origin: builtin, city, or builtin+city.", "type": "string" }, "prompt_flag": { "type": "string" }, "prompt_mode": { "type": "string" }, "ready_delay_ms": { "format": "int64", "type": "integer" } }, "required": [ "origin" ], "type": "object" }, "AsyncAcceptedBody": { "additionalProperties": false, "properties": { "event_cursor": { "description": "City event-stream sequence captured before the async request was accepted. Pass this value as after_seq to /v0/city/{cityName}/events/stream to receive the request result without replaying unrelated historical backlog. A value of 0 can also mean no event provider is configured or the event log is empty.", "type": "string" }, "request_id": { "description": "Correlation ID. Watch the city event stream for request.result.session.create, request.result.session.message, request.result.session.submit, or request.failed with this request_id.", "type": "string" }, "status": { "description": "Async request status.", "examples": [ "accepted" ], "type": "string" } }, "required": [ "status", "request_id", "event_cursor" ], "type": "object" }, "AsyncAcceptedResponse": { "additionalProperties": false, "properties": { "event_cursor": { "description": "Supervisor event-stream cursor captured before the async request was accepted. Pass this value as after_cursor to /v0/events/stream to receive the request result. A populated cursor resumes each city at its exact per-city position, so no unrelated historical backlog is replayed. The value 0 is returned only when no event provider is registered at capture time; passing 0 back requests a replay from zero for every provider present at resume time, which still delivers this request result because no provider predates the capture boundary.", "type": "string" }, "request_id": { "description": "Correlation ID. Watch /v0/events/stream for request.result.city.create, request.result.city.unregister, or request.failed with this request_id.", "type": "string" } }, "required": [ "request_id", "event_cursor" ], "type": "object" }, "BackendCredentialResolvedPayload": { "additionalProperties": false, "properties": { "backend": { "type": "string" }, "host": { "type": "string" }, "port": { "type": "string" }, "scope_kind": { "type": "string" }, "scope_name": { "type": "string" }, "source": { "type": "string" }, "user": { "type": "string" } }, "required": [ "backend", "scope_kind", "scope_name", "source", "host", "port", "user" ], "type": "object" }, "Bead": { "additionalProperties": false, "properties": { "assignee": { "type": "string" }, "close_reason": { "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "defer_until": { "format": "date-time", "type": "string" }, "dependencies": { "items": { "$ref": "#/components/schemas/Dep" }, "type": [ "array", "null" ] }, "description": { "type": "string" }, "ephemeral": { "type": "boolean" }, "from": { "type": "string" }, "id": { "type": "string" }, "is_blocked": { "type": "boolean" }, "issue_type": { "type": "string" }, "labels": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "metadata": { "additionalProperties": { "type": "string" }, "type": "object" }, "needs": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "no_history": { "type": "boolean" }, "parent": { "type": "string" }, "priority": { "format": "int64", "type": "integer" }, "ref": { "type": "string" }, "status": { "type": "string" }, "title": { "type": "string" }, "updated_at": { "format": "date-time", "type": "string" } }, "required": [ "id", "title", "status", "issue_type", "created_at" ], "type": "object" }, "BeadAssignInputBody": { "additionalProperties": false, "properties": { "assignee": { "description": "Assignee name.", "type": "string" } }, "type": "object" }, "BeadClaimRejectedPayload": { "additionalProperties": false, "properties": { "attempted_claimant": { "type": "string" }, "bead_id": { "type": "string" }, "existing_claimant": { "type": "string" } }, "required": [ "bead_id", "existing_claimant", "attempted_claimant" ], "type": "object" }, "BeadClaimReleasedPayload": { "additionalProperties": false, "properties": { "assignee": { "type": "string" }, "bead_id": { "type": "string" }, "reason": { "type": "string" } }, "required": [ "bead_id", "assignee", "reason" ], "type": "object" }, "BeadCloseBody": { "additionalProperties": false, "properties": { "reason": { "description": "Why the bead is being closed. Recorded as the bead's close_reason (bd close --reason). Blank means no reason.", "type": "string" } }, "type": "object" }, "BeadCreateInputBody": { "additionalProperties": false, "properties": { "assignee": { "description": "Assigned agent.", "type": "string" }, "defer_until": { "description": "Hide the bead from ready views until this time.", "format": "date-time", "type": "string" }, "description": { "description": "Bead description.", "type": "string" }, "labels": { "description": "Bead labels.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "metadata": { "additionalProperties": { "type": "string" }, "description": "Metadata key-value pairs to set at create time.", "type": "object" }, "parent": { "description": "Parent bead ID.", "type": "string" }, "priority": { "description": "Bead priority.", "format": "int64", "type": "integer" }, "rig": { "description": "Rig name.", "type": "string" }, "title": { "description": "Bead title.", "minLength": 1, "type": "string" }, "type": { "description": "Bead type.", "type": "string" } }, "required": [ "title" ], "type": "object" }, "BeadDeadAssigneeReopenedPayload": { "additionalProperties": false, "properties": { "bead_id": { "description": "ID of the reopened work bead (also the envelope Subject).", "type": "string" }, "dead_assignee": { "description": "The assignee identity that resolved to no open session bead, cleared by the reopen.", "type": "string" }, "routed_to": { "description": "The gc.routed_to target the bead stays routed to after the reopen, when set.", "type": "string" } }, "required": [ "bead_id" ], "type": "object" }, "BeadDepsResponse": { "additionalProperties": false, "properties": { "children": { "items": { "$ref": "#/components/schemas/Bead" }, "type": [ "array", "null" ] } }, "required": [ "children" ], "type": "object" }, "BeadEventPayload": { "additionalProperties": false, "properties": { "bead": { "$ref": "#/components/schemas/Bead" } }, "required": [ "bead" ], "type": "object" }, "BeadGraphResponse": { "additionalProperties": false, "properties": { "beads": { "items": { "$ref": "#/components/schemas/Bead" }, "type": [ "array", "null" ] }, "deps": { "items": { "$ref": "#/components/schemas/WorkflowDepResponse" }, "type": [ "array", "null" ] }, "membership": { "description": "Rule that decided which beads are in Beads: the root, everything carrying gc.root_bead_id == root, plus the root's convoy members when the root is a convoy, and then the transitive parent-child closure taken over all of those — a convoy member brings its own subtree. Both storage tiers are in scope, so a wisp molecule (whose beads are all ephemeral) returns its members rather than reading as empty. Never dependency reachability, which drops dependency-isolated members such as gc.kind=spec sidecars.", "enum": [ "direct-root-id+parent-closure", "direct-root-id+parent-closure+convoy-members" ], "type": "string" }, "root": { "$ref": "#/components/schemas/Bead" } }, "required": [ "root", "beads", "deps", "membership" ], "type": "object" }, "BeadUpdateBody": { "additionalProperties": false, "properties": { "assignee": { "description": "Assigned agent.", "type": "string" }, "description": { "description": "Bead description.", "type": "string" }, "labels": { "description": "Bead labels.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "metadata": { "additionalProperties": { "type": "string" }, "description": "Metadata key-value pairs to set.", "type": "object" }, "parent": { "description": "Parent bead ID. Use null or an empty string to clear.", "type": [ "string", "null" ] }, "priority": { "description": "Bead priority.", "format": "int64", "type": "integer" }, "remove_labels": { "description": "Labels to remove.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "status": { "description": "Bead status.", "type": "string" }, "title": { "description": "Bead title.", "type": "string" }, "type": { "description": "Bead type.", "type": "string" } }, "type": "object" }, "BeadWorktreeReapSkippedPayload": { "additionalProperties": false, "properties": { "bead_id": { "type": "string" }, "path": { "type": "string" }, "reason": { "type": "string" }, "rig": { "type": "string" } }, "required": [ "bead_id", "path", "rig", "reason" ], "type": "object" }, "BeadWorktreeReapedPayload": { "additionalProperties": false, "properties": { "bead_id": { "type": "string" }, "branch": { "type": "string" }, "path": { "type": "string" }, "rig": { "type": "string" } }, "required": [ "bead_id", "path", "rig", "branch" ], "type": "object" }, "BeadsDiagnostic": { "additionalProperties": false, "properties": { "beads_store": { "type": "string" }, "native_store_eligible": { "type": "boolean" }, "preflight_gate": { "type": "string" }, "preflight_reason": { "type": "string" }, "proxied": { "$ref": "#/components/schemas/ProxiedDiagnostic" } }, "required": [ "beads_store", "native_store_eligible" ], "type": "object" }, "BindingStatus": { "description": "Lifecycle state of a session binding.", "enum": [ "active", "ended" ], "type": "string" }, "BlockedRecomputedPayload": { "additionalProperties": false, "properties": { "bd_version": { "type": "string" }, "rows_corrected": { "format": "int64", "type": "integer" }, "scope": { "type": "string" } }, "required": [ "scope", "rows_corrected", "bd_version" ], "type": "object" }, "BoundEventPayload": { "additionalProperties": false, "properties": { "agent_name": { "type": "string" }, "conversation_id": { "type": "string" }, "provider": { "type": "string" }, "session_id": { "type": "string" } }, "required": [ "provider", "conversation_id", "session_id" ], "type": "object" }, "CityCreateRequest": { "additionalProperties": false, "properties": { "bootstrap_profile": { "description": "Optional bootstrap profile.", "enum": [ "k8s-cell", "kubernetes", "kubernetes-cell", "single-host-compat" ], "type": "string" }, "dir": { "description": "Directory to create the city in. Absolute or relative to $HOME.", "minLength": 1, "type": "string" }, "provider": { "description": "Provider name for the city's default session template. Mutually exclusive with start_command.", "minLength": 1, "type": "string" }, "start_command": { "description": "Custom workspace start command for the city's default session template. Mutually exclusive with provider.", "type": "string" } }, "required": [ "dir" ], "type": "object" }, "CityCreateSucceededPayload": { "additionalProperties": false, "properties": { "name": { "description": "Resolved city name.", "type": "string" }, "path": { "description": "Resolved absolute city directory path.", "type": "string" }, "request_id": { "description": "Correlation ID from the 202 response.", "type": "string" } }, "required": [ "request_id", "name", "path" ], "type": "object" }, "CityGetResponse": { "additionalProperties": false, "properties": { "agent_count": { "format": "int64", "type": "integer" }, "name": { "type": "string" }, "path": { "type": "string" }, "provider": { "type": "string" }, "rig_count": { "format": "int64", "type": "integer" }, "session_template": { "type": "string" }, "suspended": { "type": "boolean" }, "uptime_sec": { "format": "int64", "type": "integer" }, "version": { "type": "string" } }, "required": [ "name", "path", "suspended", "uptime_sec", "agent_count", "rig_count" ], "type": "object" }, "CityInfo": { "additionalProperties": false, "properties": { "error": { "type": "string" }, "name": { "type": "string" }, "path": { "type": "string" }, "phases_completed": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "running": { "type": "boolean" }, "status": { "type": "string" } }, "required": [ "name", "path", "running" ], "type": "object" }, "CityLifecyclePayload": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "path": { "type": "string" } }, "required": [ "name", "path" ], "type": "object" }, "CityPatchInputBody": { "additionalProperties": false, "properties": { "suspended": { "description": "Whether the city is suspended.", "type": "boolean" } }, "type": "object" }, "CityPendingEntry": { "additionalProperties": false, "properties": { "kind": { "description": "Pending interaction kind (e.g. tool-approval, prompt-for-input).", "type": "string" }, "request_id": { "description": "Pending interaction request ID.", "type": "string" }, "session_id": { "description": "Session ID awaiting a human decision.", "type": "string" } }, "required": [ "session_id", "request_id", "kind" ], "type": "object" }, "CityUnregisterSucceededPayload": { "additionalProperties": false, "properties": { "name": { "description": "City name that was unregistered.", "type": "string" }, "path": { "description": "Absolute city directory path.", "type": "string" }, "request_id": { "description": "Correlation ID from the 202 response.", "type": "string" } }, "required": [ "request_id", "name", "path" ], "type": "object" }, "ConditionalWritesDegradedPayload": { "additionalProperties": false, "properties": { "bd_version": { "type": "string" }, "mode": { "type": "string" }, "origin": { "type": "string" }, "reason": { "type": "string" }, "store_id": { "type": "string" }, "store_kind": { "type": "string" } }, "required": [ "store_id", "store_kind", "mode", "origin", "reason" ], "type": "object" }, "ConfigAgentResponse": { "additionalProperties": false, "properties": { "dir": { "type": "string" }, "is_pool": { "type": "boolean" }, "name": { "type": "string" }, "provider": { "type": "string" }, "scope": { "type": "string" }, "suspended": { "type": "boolean" } }, "required": [ "name", "suspended" ], "type": "object" }, "ConfigExplainPatches": { "additionalProperties": false, "properties": { "agents": { "format": "int64", "type": "integer" }, "providers": { "format": "int64", "type": "integer" }, "rigs": { "format": "int64", "type": "integer" } }, "required": [ "agents", "rigs", "providers" ], "type": "object" }, "ConfigExplainResponse": { "additionalProperties": false, "properties": { "agents": { "items": { "$ref": "#/components/schemas/AnnotatedAgentResponse" }, "type": [ "array", "null" ] }, "patches": { "$ref": "#/components/schemas/ConfigExplainPatches" }, "providers": { "additionalProperties": { "$ref": "#/components/schemas/AnnotatedProviderResponse" }, "type": "object" } }, "required": [ "agents", "providers", "patches" ], "type": "object" }, "ConfigPatchesResponse": { "additionalProperties": false, "properties": { "agent_count": { "format": "int64", "type": "integer" }, "provider_count": { "format": "int64", "type": "integer" }, "rig_count": { "format": "int64", "type": "integer" } }, "required": [ "agent_count", "rig_count", "provider_count" ], "type": "object" }, "ConfigResponse": { "additionalProperties": false, "properties": { "agents": { "items": { "$ref": "#/components/schemas/ConfigAgentResponse" }, "type": [ "array", "null" ] }, "effective_api_url": { "type": "string" }, "patches": { "$ref": "#/components/schemas/ConfigPatchesResponse" }, "providers": { "additionalProperties": { "$ref": "#/components/schemas/ProviderSpecJSON" }, "type": "object" }, "rigs": { "items": { "$ref": "#/components/schemas/ConfigRigResponse" }, "type": [ "array", "null" ] }, "workspace": { "$ref": "#/components/schemas/WorkspaceResponse" } }, "required": [ "workspace", "agents", "rigs" ], "type": "object" }, "ConfigRigResponse": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "path": { "type": "string" }, "prefix": { "type": "string" }, "suspended": { "type": "boolean" } }, "required": [ "name", "path", "suspended" ], "type": "object" }, "ConfigValidateOutputBody": { "additionalProperties": false, "properties": { "errors": { "description": "Validation errors.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "valid": { "description": "Whether the configuration is valid.", "type": "boolean" }, "warnings": { "description": "Validation warnings.", "items": { "type": "string" }, "type": [ "array", "null" ] } }, "required": [ "valid", "errors", "warnings" ], "type": "object" }, "ContextAdvisory": { "additionalProperties": false, "properties": { "Enabled": { "type": [ "boolean", "null" ] }, "Tiers": { "items": { "$ref": "#/components/schemas/ContextAdvisoryTier" }, "type": [ "array", "null" ] }, "WindowTokens": { "format": "int64", "type": [ "integer", "null" ] } }, "required": [ "Enabled", "WindowTokens", "Tiers" ], "type": "object" }, "ContextAdvisoryTier": { "additionalProperties": false, "properties": { "Enabled": { "type": [ "boolean", "null" ] }, "Message": { "type": [ "string", "null" ] }, "Threshold": { "format": "int64", "type": [ "integer", "null" ] } }, "required": [ "Threshold", "Message", "Enabled" ], "type": "object" }, "ControlDispatcherScopeGapPayload": { "additionalProperties": false, "properties": { "rig_context": { "type": "string" }, "sample_bead_id": { "type": "string" }, "scope_label": { "type": "string" }, "store_ref": { "type": "string" }, "suppressed_count": { "format": "int64", "type": "integer" } }, "required": [ "scope_label", "suppressed_count" ], "type": "object" }, "ControlRootSettleFailedPayload": { "additionalProperties": false, "properties": { "error": { "type": "string" }, "error_class": { "type": "string" }, "finalizer_bead_id": { "type": "string" }, "follow_up_bead_id": { "type": "string" }, "root_bead_id": { "type": "string" }, "store_path": { "type": "string" } }, "required": [ "root_bead_id", "finalizer_bead_id", "error_class", "error" ], "type": "object" }, "ControlStalledPayload": { "additionalProperties": false, "properties": { "attempts": { "format": "int64", "type": "integer" }, "bead_id": { "type": "string" }, "error": { "type": "string" }, "error_class": { "type": "string" }, "first_seen": { "type": "string" }, "kind": { "type": "string" }, "order_name": { "type": "string" }, "root_bead_id": { "type": "string" }, "store_path": { "type": "string" } }, "required": [ "bead_id", "error_class", "first_seen", "attempts", "error" ], "type": "object" }, "ConversationGroupParticipant": { "additionalProperties": false, "properties": { "GroupID": { "type": "string" }, "Handle": { "type": "string" }, "ID": { "type": "string" }, "Metadata": { "additionalProperties": { "type": "string" }, "type": "object" }, "Public": { "type": "boolean" }, "SessionID": { "type": "string" }, "SessionName": { "type": "string" } }, "required": [ "ID", "GroupID", "Handle", "SessionID", "SessionName", "Public", "Metadata" ], "type": "object" }, "ConversationGroupRecord": { "additionalProperties": false, "properties": { "DefaultHandle": { "type": "string" }, "FanoutPolicy": { "$ref": "#/components/schemas/FanoutPolicy" }, "ID": { "type": "string" }, "LastAddressedHandle": { "type": "string" }, "Metadata": { "additionalProperties": { "type": "string" }, "type": "object" }, "Mode": { "type": "string" }, "RootConversation": { "$ref": "#/components/schemas/ConversationRef" }, "SchemaVersion": { "format": "int64", "type": "integer" } }, "required": [ "ID", "SchemaVersion", "RootConversation", "Mode", "DefaultHandle", "LastAddressedHandle", "FanoutPolicy", "Metadata" ], "type": "object" }, "ConversationKind": { "description": "Shape of a conversation.", "enum": [ "dm", "room", "thread" ], "type": "string" }, "ConversationRef": { "additionalProperties": false, "properties": { "account_id": { "type": "string" }, "conversation_id": { "type": "string" }, "kind": { "$ref": "#/components/schemas/ConversationKind" }, "parent_conversation_id": { "type": "string" }, "provider": { "type": "string" }, "scope_id": { "type": "string" } }, "required": [ "scope_id", "provider", "account_id", "conversation_id", "kind" ], "type": "object" }, "ConversationTranscriptRecord": { "additionalProperties": false, "properties": { "Actor": { "$ref": "#/components/schemas/ExternalActor" }, "Attachments": { "items": { "$ref": "#/components/schemas/ExternalAttachment" }, "type": [ "array", "null" ] }, "Conversation": { "$ref": "#/components/schemas/ConversationRef" }, "CreatedAt": { "format": "date-time", "type": "string" }, "ExplicitTarget": { "type": "string" }, "ID": { "type": "string" }, "Kind": { "$ref": "#/components/schemas/TranscriptMessageKind" }, "Metadata": { "additionalProperties": { "type": "string" }, "type": "object" }, "Provenance": { "$ref": "#/components/schemas/TranscriptProvenance" }, "ProviderMessageID": { "type": "string" }, "ReplyToMessageID": { "type": "string" }, "SchemaVersion": { "format": "int64", "type": "integer" }, "Sequence": { "format": "int64", "type": "integer" }, "SourceSessionID": { "type": "string" }, "Text": { "type": "string" } }, "required": [ "ID", "SchemaVersion", "Conversation", "Sequence", "Kind", "Provenance", "ProviderMessageID", "Actor", "Text", "ExplicitTarget", "ReplyToMessageID", "Attachments", "SourceSessionID", "CreatedAt", "Metadata" ], "type": "object" }, "ConvoyAddInputBody": { "additionalProperties": false, "properties": { "items": { "description": "Bead IDs to add.", "items": { "type": "string" }, "type": [ "array", "null" ] } }, "type": "object" }, "ConvoyCheckResponse": { "additionalProperties": false, "properties": { "closed": { "description": "Closed child bead count.", "format": "int64", "type": "integer" }, "complete": { "description": "True when all child beads are closed and total \u003e 0.", "type": "boolean" }, "convoy_id": { "description": "Convoy ID.", "type": "string" }, "total": { "description": "Total child bead count.", "format": "int64", "type": "integer" } }, "required": [ "convoy_id", "total", "closed", "complete" ], "type": "object" }, "ConvoyCreateInputBody": { "additionalProperties": false, "properties": { "items": { "description": "Bead IDs to include.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "rig": { "description": "Rig name.", "type": "string" }, "title": { "description": "Convoy title.", "minLength": 1, "type": "string" } }, "required": [ "title" ], "type": "object" }, "ConvoyGetResponse": { "additionalProperties": false, "properties": { "children": { "description": "Direct child beads (non-workflow case).", "items": { "$ref": "#/components/schemas/Bead" }, "type": [ "array", "null" ] }, "convoy": { "$ref": "#/components/schemas/Bead", "description": "Simple convoy bead (non-workflow case)." }, "progress": { "$ref": "#/components/schemas/ConvoyProgress", "description": "Child bead progress (non-workflow case)." } }, "type": "object" }, "ConvoyProgress": { "additionalProperties": false, "properties": { "closed": { "description": "Closed child bead count.", "format": "int64", "type": "integer" }, "total": { "description": "Total child bead count.", "format": "int64", "type": "integer" } }, "required": [ "total", "closed" ], "type": "object" }, "ConvoyRemoveInputBody": { "additionalProperties": false, "properties": { "items": { "description": "Bead IDs to remove.", "items": { "type": "string" }, "type": [ "array", "null" ] } }, "type": "object" }, "Cursors": { "additionalProperties": false, "properties": { "ignored": { "format": "int64", "type": "integer" }, "main": { "format": "int64", "type": "integer" } }, "required": [ "main", "ignored" ], "type": "object" }, "DeliveryContextRecord": { "additionalProperties": false, "properties": { "BindingGeneration": { "format": "int64", "type": "integer" }, "Conversation": { "$ref": "#/components/schemas/ConversationRef" }, "ID": { "type": "string" }, "LastMessageID": { "type": "string" }, "LastPublishedAt": { "format": "date-time", "type": "string" }, "Metadata": { "additionalProperties": { "type": "string" }, "type": "object" }, "SchemaVersion": { "format": "int64", "type": "integer" }, "SessionID": { "type": "string" }, "SourceSessionID": { "type": "string" } }, "required": [ "ID", "SchemaVersion", "SessionID", "Conversation", "BindingGeneration", "LastPublishedAt", "LastMessageID", "SourceSessionID", "Metadata" ], "type": "object" }, "Dep": { "additionalProperties": false, "properties": { "depends_on_id": { "type": "string" }, "issue_id": { "type": "string" }, "type": { "type": "string" } }, "required": [ "issue_id", "depends_on_id", "type" ], "type": "object" }, "ErrorDetail": { "additionalProperties": false, "properties": { "location": { "description": "Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'", "type": "string" }, "message": { "description": "Error message text", "type": "string" }, "value": { "description": "The value at the given location" } }, "type": "object" }, "ErrorModel": { "additionalProperties": false, "properties": { "code": { "description": "Stable machine-readable error code (the final segment of the type URN).", "type": "string" }, "detail": { "description": "A human-readable explanation specific to this occurrence of the problem.", "examples": [ "Property foo is required but is missing." ], "type": "string" }, "errors": { "description": "Optional list of individual error details", "items": { "$ref": "#/components/schemas/ErrorDetail" }, "type": [ "array", "null" ] }, "instance": { "description": "A URI reference that identifies the specific occurrence of the problem.", "examples": [ "https://example.com/error-log/abc123" ], "format": "uri", "type": "string" }, "status": { "description": "HTTP status code", "examples": [ 400 ], "format": "int64", "type": "integer" }, "title": { "description": "A short, human-readable summary of the problem type. This value should not change between occurrences of the error.", "examples": [ "Bad Request" ], "type": "string" }, "type": { "default": "about:blank", "description": "A URI reference to human-readable documentation for the error.", "examples": [ "https://example.com/errors/example", "urn:gascity:error:agent-not-found", "urn:gascity:error:ambiguous-reference", "urn:gascity:error:bad-gateway", "urn:gascity:error:bead-not-found", "urn:gascity:error:city-not-found", "urn:gascity:error:conflict-concurrent-delete", "urn:gascity:error:conflict-concurrent-modify", "urn:gascity:error:conflict-wrong-state", "urn:gascity:error:convoy-not-found", "urn:gascity:error:demand-only-singleton", "urn:gascity:error:extmsg-group-not-found", "urn:gascity:error:forbidden", "urn:gascity:error:formula-not-found", "urn:gascity:error:gateway-timeout", "urn:gascity:error:idempotency-in-flight", "urn:gascity:error:idempotency-mismatch", "urn:gascity:error:internal", "urn:gascity:error:invalid-cursor", "urn:gascity:error:invalid-request", "urn:gascity:error:mail-not-found", "urn:gascity:error:method-not-allowed", "urn:gascity:error:not-implemented", "urn:gascity:error:operation-in-progress", "urn:gascity:error:order-not-found", "urn:gascity:error:pack-credential-required", "urn:gascity:error:pack-not-found", "urn:gascity:error:patch-not-found", "urn:gascity:error:provider-not-found", "urn:gascity:error:rig-not-found", "urn:gascity:error:run-not-found", "urn:gascity:error:scope-not-found", "urn:gascity:error:service-not-found", "urn:gascity:error:service-unavailable", "urn:gascity:error:session-conflict", "urn:gascity:error:session-not-found", "urn:gascity:error:sling-cross-rig", "urn:gascity:error:sling-cross-store-route", "urn:gascity:error:sling-missing-bead", "urn:gascity:error:sling-source-workflow-conflict", "urn:gascity:error:store-unavailable", "urn:gascity:error:transcript-cursor-invalidated", "urn:gascity:error:validation-failed", "urn:gascity:error:wait-not-found", "urn:gascity:error:wake-will-not-start", "urn:gascity:error:webhook-rejected", "urn:gascity:error:workflow-not-found" ], "format": "uri", "type": "string", "x-gascity-problem-types": [ "urn:gascity:error:agent-not-found", "urn:gascity:error:ambiguous-reference", "urn:gascity:error:bad-gateway", "urn:gascity:error:bead-not-found", "urn:gascity:error:city-not-found", "urn:gascity:error:conflict-concurrent-delete", "urn:gascity:error:conflict-concurrent-modify", "urn:gascity:error:conflict-wrong-state", "urn:gascity:error:convoy-not-found", "urn:gascity:error:demand-only-singleton", "urn:gascity:error:extmsg-group-not-found", "urn:gascity:error:forbidden", "urn:gascity:error:formula-not-found", "urn:gascity:error:gateway-timeout", "urn:gascity:error:idempotency-in-flight", "urn:gascity:error:idempotency-mismatch", "urn:gascity:error:internal", "urn:gascity:error:invalid-cursor", "urn:gascity:error:invalid-request", "urn:gascity:error:mail-not-found", "urn:gascity:error:method-not-allowed", "urn:gascity:error:not-implemented", "urn:gascity:error:operation-in-progress", "urn:gascity:error:order-not-found", "urn:gascity:error:pack-credential-required", "urn:gascity:error:pack-not-found", "urn:gascity:error:patch-not-found", "urn:gascity:error:provider-not-found", "urn:gascity:error:rig-not-found", "urn:gascity:error:run-not-found", "urn:gascity:error:scope-not-found", "urn:gascity:error:service-not-found", "urn:gascity:error:service-unavailable", "urn:gascity:error:session-conflict", "urn:gascity:error:session-not-found", "urn:gascity:error:sling-cross-rig", "urn:gascity:error:sling-cross-store-route", "urn:gascity:error:sling-missing-bead", "urn:gascity:error:sling-source-workflow-conflict", "urn:gascity:error:store-unavailable", "urn:gascity:error:transcript-cursor-invalidated", "urn:gascity:error:validation-failed", "urn:gascity:error:wait-not-found", "urn:gascity:error:wake-will-not-start", "urn:gascity:error:webhook-rejected", "urn:gascity:error:workflow-not-found" ] } }, "type": "object" }, "EventEmitOutputBody": { "additionalProperties": false, "properties": { "status": { "description": "Operation result.", "examples": [ "recorded" ], "type": "string" } }, "required": [ "status" ], "type": "object" }, "EventEmitRequest": { "additionalProperties": false, "properties": { "actor": { "description": "Actor that produced the event.", "minLength": 1, "type": "string" }, "message": { "description": "Event message.", "type": "string" }, "subject": { "description": "Event subject.", "type": "string" }, "type": { "description": "Event type.", "minLength": 1, "type": "string" } }, "required": [ "type", "actor" ], "type": "object" }, "EventPayload": { "oneOf": [ { "$ref": "#/components/schemas/AdapterEventPayload" }, { "$ref": "#/components/schemas/BackendCredentialResolvedPayload" }, { "$ref": "#/components/schemas/BeadClaimRejectedPayload" }, { "$ref": "#/components/schemas/BeadClaimReleasedPayload" }, { "$ref": "#/components/schemas/BeadDeadAssigneeReopenedPayload" }, { "$ref": "#/components/schemas/BeadEventPayload" }, { "$ref": "#/components/schemas/BeadWorktreeReapSkippedPayload" }, { "$ref": "#/components/schemas/BeadWorktreeReapedPayload" }, { "$ref": "#/components/schemas/BlockedRecomputedPayload" }, { "$ref": "#/components/schemas/BoundEventPayload" }, { "$ref": "#/components/schemas/CityCreateSucceededPayload" }, { "$ref": "#/components/schemas/CityLifecyclePayload" }, { "$ref": "#/components/schemas/CityUnregisterSucceededPayload" }, { "$ref": "#/components/schemas/ConditionalWritesDegradedPayload" }, { "$ref": "#/components/schemas/ControlDispatcherScopeGapPayload" }, { "$ref": "#/components/schemas/ControlRootSettleFailedPayload" }, { "$ref": "#/components/schemas/ControlStalledPayload" }, { "$ref": "#/components/schemas/ExecutionClaimWindowExpiredPayload" }, { "$ref": "#/components/schemas/ExecutionStepStalledPayload" }, { "$ref": "#/components/schemas/GroupCreatedEventPayload" }, { "$ref": "#/components/schemas/HookClaimReclaimedStalePayload" }, { "$ref": "#/components/schemas/InboundEventPayload" }, { "$ref": "#/components/schemas/MailEventPayload" }, { "$ref": "#/components/schemas/MoleculeResolvedPayload" }, { "$ref": "#/components/schemas/NoPayload" }, { "$ref": "#/components/schemas/OrderSkippedPayload" }, { "$ref": "#/components/schemas/OrderSuppressedPayload" }, { "$ref": "#/components/schemas/OutboundChannelMismatchPayload" }, { "$ref": "#/components/schemas/OutboundEventPayload" }, { "$ref": "#/components/schemas/ProjectIdentityStampedPayload" }, { "$ref": "#/components/schemas/Record" }, { "$ref": "#/components/schemas/RequestFailedPayload" }, { "$ref": "#/components/schemas/RigCreateSucceededPayload" }, { "$ref": "#/components/schemas/RigProvisionProgressPayload" }, { "$ref": "#/components/schemas/RotatedPayload" }, { "$ref": "#/components/schemas/SessionCreateSucceededPayload" }, { "$ref": "#/components/schemas/SessionDemandClaimDivergencePayload" }, { "$ref": "#/components/schemas/SessionDrainAckedWithAssignedWorkPayload" }, { "$ref": "#/components/schemas/SessionLifecyclePayload" }, { "$ref": "#/components/schemas/SessionMessageSucceededPayload" }, { "$ref": "#/components/schemas/SessionPendingClearedPayload" }, { "$ref": "#/components/schemas/SessionPendingPayload" }, { "$ref": "#/components/schemas/SessionPoolSlotRetiredAtDrainDeadlinePayload" }, { "$ref": "#/components/schemas/SessionResetStalledPayload" }, { "$ref": "#/components/schemas/SessionStrandedPayload" }, { "$ref": "#/components/schemas/SessionSubmitSucceededPayload" }, { "$ref": "#/components/schemas/SessionUnknownStatePayload" }, { "$ref": "#/components/schemas/SessionWakeRefusedPayload" }, { "$ref": "#/components/schemas/StorageBindingOutcomePayload" }, { "$ref": "#/components/schemas/StoreDiskCriticalPayload" }, { "$ref": "#/components/schemas/StoreDiskWarnPayload" }, { "$ref": "#/components/schemas/StoreMaintenanceDonePayload" }, { "$ref": "#/components/schemas/StoreMaintenanceFailedPayload" }, { "$ref": "#/components/schemas/SupervisorFSPressureSkippedTickPayload" }, { "$ref": "#/components/schemas/SupervisorRequestPayload" }, { "$ref": "#/components/schemas/SupervisorShutdownPayload" }, { "$ref": "#/components/schemas/SupervisorStartedPayload" }, { "$ref": "#/components/schemas/UnboundEventPayload" }, { "$ref": "#/components/schemas/WebhookReceivedPayload" }, { "$ref": "#/components/schemas/WebhookRejectedPayload" }, { "$ref": "#/components/schemas/WorkerOperationEventPayload" } ] }, "EventRotateAnchor": { "additionalProperties": false, "properties": { "seq": { "description": "Anchor event sequence.", "format": "int64", "minimum": 0, "type": "integer" }, "ts": { "description": "Anchor event timestamp.", "format": "date-time", "type": "string" }, "type": { "description": "Anchor event type.", "examples": [ "events.rotated" ], "type": "string" } }, "required": [ "seq", "type", "ts" ], "type": "object" }, "EventRotateArchive": { "additionalProperties": false, "properties": { "compression_status": { "description": "Archive compression status.", "enum": [ "pending", "complete" ], "type": "string" }, "first_seq": { "description": "First event sequence included in the archive.", "format": "int64", "minimum": 0, "type": "integer" }, "last_seq": { "description": "Last event sequence included in the archive.", "format": "int64", "minimum": 0, "type": "integer" }, "path": { "description": "Absolute path to the archive.", "type": "string" } }, "required": [ "path", "first_seq", "last_seq", "compression_status" ], "type": "object" }, "EventRotateResponse": { "additionalProperties": false, "properties": { "anchor_event": { "$ref": "#/components/schemas/EventRotateAnchor", "description": "Anchor event metadata when rotated is true." }, "archive": { "$ref": "#/components/schemas/EventRotateArchive", "description": "Archive metadata when rotated is true." }, "reason": { "description": "No-op reason when rotated is false.", "type": "string" }, "rotated": { "description": "Whether an archive was produced.", "type": "boolean" } }, "required": [ "rotated" ], "type": "object" }, "EventStreamEnvelope": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/EventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor" ], "type": "object" }, "ExecutionClaimWindowExpiredPayload": { "additionalProperties": false, "properties": { "bead_id": { "type": "string" }, "invocation_age_ms": { "format": "int64", "type": "integer" }, "parent_alive": { "type": "boolean" } }, "required": [ "bead_id", "invocation_age_ms", "parent_alive" ], "type": "object" }, "ExecutionStepStalledPayload": { "additionalProperties": false, "properties": { "attempts": { "format": "int64", "type": "integer" }, "bead_id": { "type": "string" }, "root_bead_id": { "type": "string" }, "session_id": { "type": "string" } }, "required": [ "bead_id", "session_id", "attempts" ], "type": "object" }, "ExtMsgAdapterRegisterInputBody": { "additionalProperties": false, "properties": { "account_id": { "description": "Account ID.", "minLength": 1, "type": "string" }, "callback_url": { "description": "Callback URL for outbound messages.", "type": "string" }, "capabilities": { "$ref": "#/components/schemas/AdapterCapabilities", "description": "Adapter capabilities." }, "name": { "description": "Adapter display name.", "type": "string" }, "provider": { "description": "Provider name.", "minLength": 1, "type": "string" } }, "required": [ "provider", "account_id" ], "type": "object" }, "ExtMsgAdapterRegisterOutputBody": { "additionalProperties": false, "properties": { "account_id": { "description": "Account ID.", "type": "string" }, "name": { "description": "Adapter name.", "type": "string" }, "provider": { "description": "Provider name.", "type": "string" }, "status": { "description": "Operation result.", "examples": [ "registered" ], "type": "string" } }, "required": [ "status", "provider", "account_id", "name" ], "type": "object" }, "ExtMsgAdapterUnregisterInputBody": { "additionalProperties": false, "properties": { "account_id": { "description": "Account ID.", "minLength": 1, "type": "string" }, "provider": { "description": "Provider name.", "minLength": 1, "type": "string" } }, "required": [ "provider", "account_id" ], "type": "object" }, "ExtMsgBindInputBody": { "additionalProperties": false, "properties": { "agent_name": { "description": "Configured agent identity to bind; its live session is resolved at delivery time, cold-waking one when none is live (mutually exclusive with session_id).", "type": "string" }, "conversation": { "$ref": "#/components/schemas/ConversationRef", "description": "Conversation to bind." }, "metadata": { "additionalProperties": { "type": "string" }, "description": "Optional binding metadata.", "type": "object" }, "replace": { "description": "Rebind (handoff) a conversation whose active binding targets someone else instead of returning a conflict.", "type": "boolean" }, "session_id": { "description": "Session ID to bind (mutually exclusive with agent_name).", "type": "string" } }, "type": "object" }, "ExtMsgGroupEnsureInputBody": { "additionalProperties": false, "properties": { "default_handle": { "description": "Default handle for the group.", "type": "string" }, "metadata": { "additionalProperties": { "type": "string" }, "description": "Group metadata.", "type": "object" }, "mode": { "description": "Group mode (launcher, etc.).", "type": "string" }, "root_conversation": { "$ref": "#/components/schemas/ConversationRef", "description": "Root conversation reference." } }, "type": "object" }, "ExtMsgInboundInputBody": { "additionalProperties": false, "properties": { "account_id": { "description": "Account ID for raw payloads (required when message is absent).", "type": "string" }, "message": { "$ref": "#/components/schemas/ExternalInboundMessage", "description": "Pre-normalized inbound message." }, "payload": { "contentEncoding": "base64", "description": "Raw payload bytes.", "type": "string" }, "provider": { "description": "Provider name for raw payloads (required when message is absent).", "type": "string" } }, "type": "object" }, "ExtMsgOutboundInputBody": { "additionalProperties": false, "properties": { "conversation": { "$ref": "#/components/schemas/ConversationRef", "description": "Target conversation." }, "idempotency_key": { "description": "Idempotency key.", "type": "string" }, "reply_to_message_id": { "description": "Message ID to reply to.", "type": "string" }, "session_id": { "description": "Session ID.", "minLength": 1, "type": "string" }, "text": { "description": "Message text.", "type": "string" } }, "required": [ "session_id" ], "type": "object" }, "ExtMsgParticipantRemoveInputBody": { "additionalProperties": false, "properties": { "group_id": { "description": "Group ID.", "minLength": 1, "type": "string" }, "handle": { "description": "Participant handle.", "minLength": 1, "type": "string" } }, "required": [ "group_id", "handle" ], "type": "object" }, "ExtMsgParticipantUpsertInputBody": { "additionalProperties": false, "properties": { "group_id": { "description": "Group ID.", "minLength": 1, "type": "string" }, "handle": { "description": "Participant handle.", "minLength": 1, "type": "string" }, "metadata": { "additionalProperties": { "type": "string" }, "description": "Participant metadata.", "type": "object" }, "public": { "description": "Whether participant is public.", "type": "boolean" }, "session_id": { "description": "Session ID.", "minLength": 1, "type": "string" } }, "required": [ "group_id", "handle", "session_id" ], "type": "object" }, "ExtMsgTranscriptAckInputBody": { "additionalProperties": false, "properties": { "conversation": { "$ref": "#/components/schemas/ConversationRef", "description": "Conversation to acknowledge." }, "sequence": { "description": "Sequence number to acknowledge up to.", "format": "int64", "type": "integer" }, "session_id": { "description": "Session ID.", "minLength": 1, "type": "string" } }, "required": [ "session_id" ], "type": "object" }, "ExtMsgUnbindBody": { "additionalProperties": false, "properties": { "unbound": { "description": "Bindings that were removed.", "items": { "$ref": "#/components/schemas/SessionBindingRecord" }, "type": [ "array", "null" ] } }, "required": [ "unbound" ], "type": "object" }, "ExtMsgUnbindInputBody": { "additionalProperties": false, "properties": { "agent_name": { "description": "Configured agent identity to unbind.", "type": "string" }, "conversation": { "$ref": "#/components/schemas/ConversationRef", "description": "Conversation to unbind (nil = filter by session_id/agent_name)." }, "session_id": { "description": "Session ID to unbind.", "type": "string" } }, "type": "object" }, "ExternalActor": { "additionalProperties": false, "properties": { "display_name": { "type": "string" }, "id": { "type": "string" }, "is_bot": { "type": "boolean" } }, "required": [ "id", "display_name", "is_bot" ], "type": "object" }, "ExternalAttachment": { "additionalProperties": false, "properties": { "mime_type": { "type": "string" }, "provider_id": { "type": "string" }, "url": { "type": "string" } }, "required": [ "provider_id", "url", "mime_type" ], "type": "object" }, "ExternalInboundMessage": { "additionalProperties": false, "properties": { "actor": { "$ref": "#/components/schemas/ExternalActor" }, "attachments": { "items": { "$ref": "#/components/schemas/ExternalAttachment" }, "type": [ "array", "null" ] }, "conversation": { "$ref": "#/components/schemas/ConversationRef" }, "dedup_key": { "type": "string" }, "explicit_target": { "type": "string" }, "provider_message_id": { "type": "string" }, "received_at": { "format": "date-time", "type": "string" }, "reply_to_message_id": { "type": "string" }, "text": { "type": "string" } }, "required": [ "provider_message_id", "conversation", "actor", "text", "received_at" ], "type": "object" }, "ExtmsgAdapterInfo": { "additionalProperties": false, "properties": { "account_id": { "description": "Adapter account ID.", "type": "string" }, "name": { "description": "Adapter display name.", "type": "string" }, "provider": { "description": "Adapter provider key.", "type": "string" } }, "required": [ "provider", "account_id", "name" ], "type": "object" }, "FanoutPolicy": { "additionalProperties": false, "properties": { "AllowUntargetedPublication": { "type": "boolean" }, "Enabled": { "type": "boolean" }, "MaxPeerTriggeredPublishes": { "format": "int64", "type": "integer" }, "MaxTotalPeerDeliveries": { "format": "int64", "type": "integer" } }, "required": [ "Enabled", "AllowUntargetedPublication", "MaxPeerTriggeredPublishes", "MaxTotalPeerDeliveries" ], "type": "object" }, "FormulaDetailResponse": { "additionalProperties": false, "properties": { "deps": { "items": { "$ref": "#/components/schemas/FormulaPreviewEdgeResponse" }, "type": [ "array", "null" ] }, "description": { "type": "string" }, "name": { "type": "string" }, "preview": { "$ref": "#/components/schemas/FormulaPreviewResponse" }, "steps": { "items": { "$ref": "#/components/schemas/FormulaStepResponse" }, "type": [ "array", "null" ] }, "var_defs": { "items": { "$ref": "#/components/schemas/FormulaVarDefResponse" }, "type": [ "array", "null" ] } }, "required": [ "name", "description", "var_defs", "steps", "deps", "preview" ], "type": "object" }, "FormulaFeedBody": { "additionalProperties": false, "properties": { "items": { "items": { "$ref": "#/components/schemas/MonitorFeedItemResponse" }, "type": [ "array", "null" ] }, "partial": { "type": "boolean" }, "partial_errors": { "items": { "type": "string" }, "type": [ "array", "null" ] } }, "required": [ "items", "partial" ], "type": "object" }, "FormulaListBody": { "additionalProperties": false, "properties": { "items": { "description": "Formula summaries.", "items": { "$ref": "#/components/schemas/FormulaSummaryResponse" }, "type": [ "array", "null" ] }, "partial": { "description": "Whether the list is partial.", "type": "boolean" }, "total": { "description": "Total number of formulas in the list.", "format": "int64", "type": "integer" } }, "required": [ "items", "total", "partial" ], "type": "object" }, "FormulaPreviewBody": { "additionalProperties": false, "properties": { "scope_kind": { "description": "Scope kind (city or rig).", "type": "string" }, "scope_ref": { "description": "Scope reference.", "type": "string" }, "target": { "description": "Preview target: a bead or convoy ID, or a configured agent identity (for example a workflow root's gc.routed_to value).", "minLength": 1, "type": "string" }, "vars": { "additionalProperties": { "type": "string" }, "description": "Variable name-to-value overrides applied to the compiled preview.", "type": "object" } }, "required": [ "target" ], "type": "object" }, "FormulaPreviewEdgeResponse": { "additionalProperties": false, "properties": { "from": { "type": "string" }, "kind": { "type": "string" }, "to": { "type": "string" } }, "required": [ "from", "to" ], "type": "object" }, "FormulaPreviewNodeResponse": { "additionalProperties": false, "properties": { "id": { "type": "string" }, "kind": { "type": "string" }, "scope_ref": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "title", "kind" ], "type": "object" }, "FormulaPreviewResponse": { "additionalProperties": false, "properties": { "edges": { "items": { "$ref": "#/components/schemas/FormulaPreviewEdgeResponse" }, "type": [ "array", "null" ] }, "nodes": { "items": { "$ref": "#/components/schemas/FormulaPreviewNodeResponse" }, "type": [ "array", "null" ] } }, "required": [ "nodes", "edges" ], "type": "object" }, "FormulaRecentRunResponse": { "additionalProperties": false, "properties": { "started_at": { "type": "string" }, "status": { "type": "string" }, "target": { "type": "string" }, "updated_at": { "type": "string" }, "workflow_id": { "type": "string" } }, "required": [ "workflow_id", "status", "target", "started_at", "updated_at" ], "type": "object" }, "FormulaRunsResponse": { "additionalProperties": false, "properties": { "formula": { "type": "string" }, "partial": { "type": "boolean" }, "partial_errors": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "recent_runs": { "items": { "$ref": "#/components/schemas/FormulaRecentRunResponse" }, "type": [ "array", "null" ] }, "run_count": { "format": "int64", "type": "integer" } }, "required": [ "formula", "run_count", "recent_runs", "partial" ], "type": "object" }, "FormulaSourceOutputBody": { "additionalProperties": false, "properties": { "name": { "description": "Formula name.", "type": "string" }, "source": { "description": "Raw formula TOML source.", "type": "string" } }, "required": [ "name", "source" ], "type": "object" }, "FormulaStepResponse": { "additionalProperties": false, "properties": { "assignee": { "type": "string" }, "id": { "type": "string" }, "kind": { "type": "string" }, "labels": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "metadata": { "additionalProperties": { "type": "string" }, "type": "object" }, "title": { "type": "string" }, "type": { "type": "string" } }, "required": [ "id", "title", "kind" ], "type": "object" }, "FormulaSummaryResponse": { "additionalProperties": false, "properties": { "description": { "type": "string" }, "name": { "type": "string" }, "recent_runs": { "items": { "$ref": "#/components/schemas/FormulaRecentRunResponse" }, "type": [ "array", "null" ] }, "run_count": { "format": "int64", "type": "integer" }, "var_defs": { "items": { "$ref": "#/components/schemas/FormulaVarDefResponse" }, "type": [ "array", "null" ] } }, "required": [ "name", "description", "var_defs", "run_count", "recent_runs" ], "type": "object" }, "FormulaValidateOutputBody": { "additionalProperties": false, "properties": { "errors": { "description": "Validation errors, if any.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "valid": { "description": "Whether the formula source is valid.", "type": "boolean" } }, "required": [ "valid" ], "type": "object" }, "FormulaVarDefResponse": { "additionalProperties": false, "properties": { "default": {}, "description": { "type": "string" }, "enum": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "name": { "type": "string" }, "pattern": { "type": "string" }, "required": { "type": "boolean" }, "type": { "type": "string" } }, "required": [ "name", "type" ], "type": "object" }, "GitStatus": { "additionalProperties": false, "properties": { "ahead": { "format": "int64", "type": "integer" }, "behind": { "format": "int64", "type": "integer" }, "branch": { "type": "string" }, "changed_files": { "format": "int64", "type": "integer" }, "clean": { "type": "boolean" } }, "required": [ "branch", "clean", "changed_files", "ahead", "behind" ], "type": "object" }, "GroupCreatedEventPayload": { "additionalProperties": false, "properties": { "conversation_id": { "type": "string" }, "mode": { "type": "string" }, "provider": { "type": "string" } }, "required": [ "provider", "conversation_id", "mode" ], "type": "object" }, "GroupRouteDecision": { "additionalProperties": false, "properties": { "Match": { "type": "string" }, "TargetSessionID": { "type": "string" }, "UpdateCursor": { "type": "boolean" } }, "required": [ "Match", "TargetSessionID", "UpdateCursor" ], "type": "object" }, "HealthOutputBody": { "additionalProperties": false, "properties": { "city": { "description": "City name.", "type": "string" }, "status": { "description": "Health status.", "examples": [ "ok" ], "type": "string" }, "uptime_sec": { "description": "Server uptime in seconds.", "format": "int64", "type": "integer" }, "version": { "description": "Server version.", "type": "string" } }, "required": [ "status", "uptime_sec" ], "type": "object" }, "HeartbeatEvent": { "additionalProperties": false, "properties": { "timestamp": { "description": "ISO 8601 timestamp when the heartbeat was sent.", "type": "string" } }, "required": [ "timestamp" ], "type": "object" }, "HookClaimReclaimedStalePayload": { "additionalProperties": false, "properties": { "bead_id": { "type": "string" }, "new_assignee": { "type": "string" }, "previous_owner": { "type": "string" } }, "required": [ "bead_id", "previous_owner", "new_assignee" ], "type": "object" }, "InboundEventPayload": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "conversation_id": { "type": "string" }, "provider": { "type": "string" }, "target_agent": { "type": "string" }, "target_session": { "type": "string" } }, "required": [ "provider", "conversation_id", "actor", "target_session" ], "type": "object" }, "InboundResult": { "additionalProperties": false, "properties": { "Binding": { "$ref": "#/components/schemas/SessionBindingRecord" }, "GroupRoute": { "$ref": "#/components/schemas/GroupRouteDecision" }, "Message": { "$ref": "#/components/schemas/ExternalInboundMessage" }, "TargetAgentName": { "type": "string" }, "TargetSessionID": { "type": "string" }, "TranscriptEntry": { "$ref": "#/components/schemas/ConversationTranscriptRecord" } }, "required": [ "Message", "Binding", "GroupRoute", "TranscriptEntry", "TargetSessionID", "TargetAgentName" ], "type": "object" }, "ListBodyAgentPatch": { "additionalProperties": false, "properties": { "items": { "description": "The list of items.", "items": { "$ref": "#/components/schemas/AgentPatch" }, "type": [ "array", "null" ] }, "next_cursor": { "description": "Cursor for the next page of results.", "type": "string" }, "partial": { "description": "True when one or more backends failed and the list is incomplete.", "type": "boolean" }, "partial_errors": { "description": "Human-readable errors from backends that failed during aggregation.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "total": { "description": "Total number of items matching the query.", "format": "int64", "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "ListBodyAgentResponse": { "additionalProperties": false, "properties": { "items": { "description": "The list of items.", "items": { "$ref": "#/components/schemas/AgentResponse" }, "type": [ "array", "null" ] }, "next_cursor": { "description": "Cursor for the next page of results.", "type": "string" }, "partial": { "description": "True when one or more backends failed and the list is incomplete.", "type": "boolean" }, "partial_errors": { "description": "Human-readable errors from backends that failed during aggregation.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "total": { "description": "Total number of items matching the query.", "format": "int64", "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "ListBodyBead": { "additionalProperties": false, "properties": { "items": { "description": "The list of items.", "items": { "$ref": "#/components/schemas/Bead" }, "type": [ "array", "null" ] }, "next_cursor": { "description": "Cursor for the next page of results.", "type": "string" }, "partial": { "description": "True when one or more backends failed and the list is incomplete.", "type": "boolean" }, "partial_errors": { "description": "Human-readable errors from backends that failed during aggregation.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "total": { "description": "Total number of items matching the query.", "format": "int64", "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "ListBodyCityPendingEntry": { "additionalProperties": false, "properties": { "items": { "description": "The list of items.", "items": { "$ref": "#/components/schemas/CityPendingEntry" }, "type": [ "array", "null" ] }, "next_cursor": { "description": "Cursor for the next page of results.", "type": "string" }, "partial": { "description": "True when one or more backends failed and the list is incomplete.", "type": "boolean" }, "partial_errors": { "description": "Human-readable errors from backends that failed during aggregation.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "total": { "description": "Total number of items matching the query.", "format": "int64", "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "ListBodyConversationTranscriptRecord": { "additionalProperties": false, "properties": { "items": { "description": "The list of items.", "items": { "$ref": "#/components/schemas/ConversationTranscriptRecord" }, "type": [ "array", "null" ] }, "next_cursor": { "description": "Cursor for the next page of results.", "type": "string" }, "partial": { "description": "True when one or more backends failed and the list is incomplete.", "type": "boolean" }, "partial_errors": { "description": "Human-readable errors from backends that failed during aggregation.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "total": { "description": "Total number of items matching the query.", "format": "int64", "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "ListBodyExtmsgAdapterInfo": { "additionalProperties": false, "properties": { "items": { "description": "The list of items.", "items": { "$ref": "#/components/schemas/ExtmsgAdapterInfo" }, "type": [ "array", "null" ] }, "next_cursor": { "description": "Cursor for the next page of results.", "type": "string" }, "partial": { "description": "True when one or more backends failed and the list is incomplete.", "type": "boolean" }, "partial_errors": { "description": "Human-readable errors from backends that failed during aggregation.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "total": { "description": "Total number of items matching the query.", "format": "int64", "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "ListBodyProviderPatch": { "additionalProperties": false, "properties": { "items": { "description": "The list of items.", "items": { "$ref": "#/components/schemas/ProviderPatch" }, "type": [ "array", "null" ] }, "next_cursor": { "description": "Cursor for the next page of results.", "type": "string" }, "partial": { "description": "True when one or more backends failed and the list is incomplete.", "type": "boolean" }, "partial_errors": { "description": "Human-readable errors from backends that failed during aggregation.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "total": { "description": "Total number of items matching the query.", "format": "int64", "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "ListBodyProviderResponse": { "additionalProperties": false, "properties": { "items": { "description": "The list of items.", "items": { "$ref": "#/components/schemas/ProviderResponse" }, "type": [ "array", "null" ] }, "next_cursor": { "description": "Cursor for the next page of results.", "type": "string" }, "partial": { "description": "True when one or more backends failed and the list is incomplete.", "type": "boolean" }, "partial_errors": { "description": "Human-readable errors from backends that failed during aggregation.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "total": { "description": "Total number of items matching the query.", "format": "int64", "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "ListBodyRigPatch": { "additionalProperties": false, "properties": { "items": { "description": "The list of items.", "items": { "$ref": "#/components/schemas/RigPatch" }, "type": [ "array", "null" ] }, "next_cursor": { "description": "Cursor for the next page of results.", "type": "string" }, "partial": { "description": "True when one or more backends failed and the list is incomplete.", "type": "boolean" }, "partial_errors": { "description": "Human-readable errors from backends that failed during aggregation.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "total": { "description": "Total number of items matching the query.", "format": "int64", "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "ListBodyRigResponse": { "additionalProperties": false, "properties": { "items": { "description": "The list of items.", "items": { "$ref": "#/components/schemas/RigResponse" }, "type": [ "array", "null" ] }, "next_cursor": { "description": "Cursor for the next page of results.", "type": "string" }, "partial": { "description": "True when one or more backends failed and the list is incomplete.", "type": "boolean" }, "partial_errors": { "description": "Human-readable errors from backends that failed during aggregation.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "total": { "description": "Total number of items matching the query.", "format": "int64", "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "ListBodySessionBindingRecord": { "additionalProperties": false, "properties": { "items": { "description": "The list of items.", "items": { "$ref": "#/components/schemas/SessionBindingRecord" }, "type": [ "array", "null" ] }, "next_cursor": { "description": "Cursor for the next page of results.", "type": "string" }, "partial": { "description": "True when one or more backends failed and the list is incomplete.", "type": "boolean" }, "partial_errors": { "description": "Human-readable errors from backends that failed during aggregation.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "total": { "description": "Total number of items matching the query.", "format": "int64", "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "ListBodySessionResponse": { "additionalProperties": false, "properties": { "items": { "description": "The list of items.", "items": { "$ref": "#/components/schemas/SessionResponse" }, "type": [ "array", "null" ] }, "next_cursor": { "description": "Cursor for the next page of results.", "type": "string" }, "partial": { "description": "True when one or more backends failed and the list is incomplete.", "type": "boolean" }, "partial_errors": { "description": "Human-readable errors from backends that failed during aggregation.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "total": { "description": "Total number of items matching the query.", "format": "int64", "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "ListBodyStatus": { "additionalProperties": false, "properties": { "items": { "description": "The list of items.", "items": { "$ref": "#/components/schemas/Status" }, "type": [ "array", "null" ] }, "next_cursor": { "description": "Cursor for the next page of results.", "type": "string" }, "partial": { "description": "True when one or more backends failed and the list is incomplete.", "type": "boolean" }, "partial_errors": { "description": "Human-readable errors from backends that failed during aggregation.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "total": { "description": "Total number of items matching the query.", "format": "int64", "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "ListBodyWireEvent": { "additionalProperties": false, "properties": { "items": { "description": "The list of items.", "items": { "$ref": "#/components/schemas/TypedEventStreamEnvelope" }, "type": [ "array", "null" ] }, "next_cursor": { "description": "Cursor for the next page of results.", "type": "string" }, "partial": { "description": "True when one or more backends failed and the list is incomplete.", "type": "boolean" }, "partial_errors": { "description": "Human-readable errors from backends that failed during aggregation.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "total": { "description": "Total number of items matching the query.", "format": "int64", "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "LogicalNode": { "additionalProperties": false, "type": "object" }, "MailCountOutputBody": { "additionalProperties": false, "properties": { "partial": { "description": "True when one or more rig providers failed and the counts are not authoritative.", "type": "boolean" }, "partial_errors": { "description": "Per-provider errors when partial is true.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "total": { "description": "Total message count.", "format": "int64", "type": "integer" }, "unread": { "description": "Unread message count.", "format": "int64", "type": "integer" } }, "required": [ "total", "unread" ], "type": "object" }, "MailEventPayload": { "additionalProperties": false, "properties": { "message": { "$ref": "#/components/schemas/Message" }, "rig": { "type": "string" } }, "required": [ "rig" ], "type": "object" }, "MailListBody": { "additionalProperties": false, "properties": { "items": { "description": "The list of messages.", "items": { "$ref": "#/components/schemas/Message" }, "type": [ "array", "null" ] }, "next_cursor": { "description": "Cursor for the next page of results.", "type": "string" }, "partial": { "description": "True when one or more rig providers failed and the list is not authoritative.", "type": "boolean" }, "partial_errors": { "description": "Per-provider errors when partial is true.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "total": { "description": "Total number of messages matching the query.", "format": "int64", "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "MailReplyInputBody": { "additionalProperties": false, "properties": { "body": { "description": "Reply body.", "type": "string" }, "from": { "description": "Sender name.", "type": "string" }, "subject": { "description": "Reply subject.", "type": "string" } }, "type": "object" }, "MailSendInputBody": { "additionalProperties": false, "properties": { "body": { "description": "Message body.", "type": "string" }, "from": { "description": "Sender name.", "type": "string" }, "rig": { "description": "Rig name.", "type": "string" }, "subject": { "description": "Message subject.", "minLength": 1, "type": "string" }, "to": { "description": "Recipient name.", "minLength": 1, "type": "string" } }, "required": [ "to", "subject" ], "type": "object" }, "MaintenanceRunBody": { "additionalProperties": false, "properties": { "after_bytes": { "description": "Store size in bytes after the run (0 when not measured).", "format": "int64", "type": "integer" }, "before_bytes": { "description": "Store size in bytes before the run (0 when not measured).", "format": "int64", "type": "integer" }, "duration_s": { "description": "Elapsed wall-clock seconds between started_at and finished_at.", "format": "double", "type": "number" }, "err": { "description": "Error message when Stage names a failing phase; empty on success.", "type": "string" }, "finished_at": { "description": "RFC3339 timestamp when the run completed.", "type": "string" }, "snapshot_path": { "description": "Absolute path to the snapshot directory created for this run.", "type": "string" }, "stage": { "description": "Outcome stage: 'done' on success or 'backup'/'gc'/'smoke-test'/'prune' on failure.", "type": "string" }, "started_at": { "description": "RFC3339 timestamp when the run began.", "type": "string" } }, "required": [ "started_at", "finished_at", "stage", "before_bytes", "after_bytes", "duration_s" ], "type": "object" }, "MaintenanceStatusBody": { "additionalProperties": false, "properties": { "enabled": { "description": "Whether [maintenance.dolt] enabled=true in city.toml.", "type": "boolean" }, "history": { "description": "Bounded ring of recent run outcomes (oldest first).", "items": { "$ref": "#/components/schemas/MaintenanceRunBody" }, "type": [ "array", "null" ] }, "in_flight": { "description": "True when a maintenance cycle is currently running.", "type": "boolean" }, "in_flight_start": { "description": "RFC3339 start time of the in-flight run.", "type": "string" }, "interval_seconds": { "description": "Configured scheduling interval in seconds (0 when disabled).", "format": "int64", "type": "integer" }, "last_run": { "$ref": "#/components/schemas/MaintenanceRunBody", "description": "Most recent completed run, or null when none." }, "next_scheduled": { "description": "RFC3339 approximate next scheduled run time.", "type": "string" } }, "required": [ "enabled", "interval_seconds", "in_flight", "history" ], "type": "object" }, "MaintenanceTriggerBody": { "additionalProperties": false, "properties": { "accepted": { "description": "True when the supervisor accepted the trigger (202) or completed it (200).", "type": "boolean" }, "run": { "$ref": "#/components/schemas/MaintenanceRunBody", "description": "Full run summary, populated when the caller set ?wait=true." }, "started_at": { "description": "RFC3339 start time of the triggered run; doubles as a run identifier for async callers.", "type": "string" } }, "required": [ "accepted" ], "type": "object" }, "Message": { "additionalProperties": false, "properties": { "body": { "type": "string" }, "cc": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "created_at": { "format": "date-time", "type": "string" }, "from": { "type": "string" }, "id": { "type": "string" }, "priority": { "format": "int64", "type": "integer" }, "read": { "type": "boolean" }, "reply_to": { "type": "string" }, "rig": { "type": "string" }, "subject": { "type": "string" }, "thread_id": { "type": "string" }, "to": { "type": "string" } }, "required": [ "id", "from", "to", "subject", "body", "created_at", "read" ], "type": "object" }, "MoleculeResolvedPayload": { "additionalProperties": false, "properties": { "actor": { "description": "Identity that triggered the close (eventActor).", "type": "string" }, "close_reason": { "description": "close_reason stamped on the root.", "type": "string" }, "from_status": { "description": "Root status captured before the close mutated it.", "type": "string" }, "issue_id": { "description": "Molecule root bead ID that resolved.", "type": "string" }, "session_id": { "description": "Resolving session ID from gc.session_id. Empty if unstamped.", "type": "string" }, "session_name": { "description": "Resolving session name from gc.session_name. Empty if unstamped.", "type": "string" }, "to_status": { "description": "Terminal status after resolution. Always \"closed\".", "type": "string" }, "ts": { "description": "Resolution timestamp (UTC).", "format": "date-time", "type": "string" }, "work_dir": { "description": "Resolving session work dir from gc.work_dir. Empty if unstamped.", "type": "string" } }, "required": [ "issue_id", "from_status", "to_status", "actor", "ts" ], "type": "object" }, "MonitorFeedItemResponse": { "additionalProperties": false, "properties": { "attached_bead_id": { "type": "string" }, "bead_id": { "type": "string" }, "detail_available": { "type": "boolean" }, "id": { "type": "string" }, "logical_bead_id": { "type": "string" }, "root_bead_id": { "type": "string" }, "root_store_ref": { "type": "string" }, "run_detail_available": { "type": "boolean" }, "scope_kind": { "type": "string" }, "scope_ref": { "type": "string" }, "started_at": { "type": "string" }, "status": { "type": "string" }, "store_ref": { "type": "string" }, "target": { "type": "string" }, "title": { "type": "string" }, "type": { "type": "string" }, "updated_at": { "type": "string" }, "workflow_id": { "type": "string" } }, "required": [ "id", "type", "status", "title", "scope_kind", "scope_ref", "target", "started_at", "updated_at" ], "type": "object" }, "NoPayload": { "additionalProperties": false, "type": "object" }, "OKResponseBody": { "additionalProperties": false, "properties": { "status": { "description": "Operation result.", "examples": [ "ok" ], "type": "string" } }, "required": [ "status" ], "type": "object" }, "OKWithIDResponseBody": { "additionalProperties": false, "properties": { "id": { "description": "Resource ID.", "type": "string" }, "status": { "description": "Operation result.", "examples": [ "ok" ], "type": "string" } }, "required": [ "status" ], "type": "object" }, "OptionChoiceDTO": { "additionalProperties": false, "properties": { "label": { "type": "string" }, "value": { "type": "string" } }, "required": [ "value", "label" ], "type": "object" }, "OrderCheckListBody": { "additionalProperties": false, "properties": { "checks": { "description": "Order trigger evaluations.", "items": { "$ref": "#/components/schemas/OrderCheckResponse" }, "type": [ "array", "null" ] } }, "required": [ "checks" ], "type": "object" }, "OrderCheckResponse": { "additionalProperties": false, "properties": { "due": { "type": "boolean" }, "last_run": { "type": "string" }, "last_run_outcome": { "type": "string" }, "name": { "type": "string" }, "reason": { "type": "string" }, "rig": { "type": "string" }, "scoped_name": { "type": "string" } }, "required": [ "name", "scoped_name", "due", "reason" ], "type": "object" }, "OrderHistoryDetailResponse": { "additionalProperties": false, "properties": { "bead_id": { "type": "string" }, "created_at": { "type": "string" }, "labels": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "output": { "type": "string" }, "store_ref": { "type": "string" } }, "required": [ "bead_id", "store_ref", "created_at", "labels", "output" ], "type": "object" }, "OrderHistoryEntry": { "additionalProperties": false, "properties": { "bead_id": { "type": "string" }, "capture_output": { "type": "boolean" }, "created_at": { "type": "string" }, "duration_ms": { "type": "string" }, "error": { "type": "string" }, "exit_code": { "type": "string" }, "has_output": { "type": "boolean" }, "labels": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "name": { "type": "string" }, "rig": { "type": "string" }, "scoped_name": { "type": "string" }, "signal": { "type": "string" }, "store_ref": { "type": "string" }, "wisp_root_id": { "type": "string" } }, "required": [ "bead_id", "store_ref", "name", "scoped_name", "created_at", "labels", "capture_output", "has_output" ], "type": "object" }, "OrderHistoryListBody": { "additionalProperties": false, "properties": { "entries": { "description": "Order history entries.", "items": { "$ref": "#/components/schemas/OrderHistoryEntry" }, "type": [ "array", "null" ] } }, "required": [ "entries" ], "type": "object" }, "OrderListBody": { "additionalProperties": false, "properties": { "orders": { "description": "Registered orders.", "items": { "$ref": "#/components/schemas/OrderResponse" }, "type": [ "array", "null" ] } }, "required": [ "orders" ], "type": "object" }, "OrderResponse": { "additionalProperties": false, "properties": { "capture_output": { "type": "boolean" }, "check": { "type": "string" }, "check_timeout": { "type": "string" }, "check_timeout_ms": { "format": "int64", "type": "integer" }, "description": { "type": "string" }, "enabled": { "type": "boolean" }, "env": { "additionalProperties": { "type": "string" }, "type": "object" }, "exec": { "type": "string" }, "formula": { "type": "string" }, "gate": { "deprecated": true, "type": "string" }, "interval": { "type": "string" }, "name": { "type": "string" }, "on": { "type": "string" }, "pool": { "type": "string" }, "rig": { "type": "string" }, "schedule": { "type": "string" }, "scoped_name": { "type": "string" }, "timeout": { "type": "string" }, "timeout_ms": { "format": "int64", "type": "integer" }, "trigger": { "type": "string" }, "type": { "type": "string" } }, "required": [ "name", "scoped_name", "type", "timeout_ms", "enabled", "capture_output" ], "type": "object" }, "OrderRunInputBody": { "additionalProperties": false, "properties": { "vars": { "additionalProperties": { "type": "string" }, "description": "Declared [order.params] as key/value dispatch args (parity with 'gc order run --var'). Namespaced into the exec env under GC_WEBHOOK_ARG_ before overlay (R4).", "type": "object" } }, "type": "object" }, "OrderRunOutputBody": { "additionalProperties": false, "properties": { "scoped_name": { "description": "Rig-qualified name of the fired order.", "type": "string" }, "status": { "description": "\"dispatched\" when the order fired.", "type": "string" }, "tracking_id": { "description": "Tracking bead id for the dispatch.", "type": "string" } }, "required": [ "status" ], "type": "object" }, "OrderSkippedPayload": { "additionalProperties": false, "properties": { "order_name": { "type": "string" }, "outcome": { "type": "string" }, "reason": { "type": "string" }, "scopes": { "items": { "$ref": "#/components/schemas/OrderSkippedScope" }, "type": [ "array", "null" ] } }, "required": [ "order_name", "outcome", "reason", "scopes" ], "type": "object" }, "OrderSkippedScope": { "additionalProperties": false, "properties": { "reason": { "type": "string" }, "scope": { "type": "string" } }, "required": [ "scope", "reason" ], "type": "object" }, "OrderSuppressedPayload": { "additionalProperties": false, "properties": { "consecutive": { "format": "int64", "type": "integer" }, "first_suppressed": { "type": "string" }, "order_name": { "type": "string" }, "suppressed_for_ms": { "format": "int64", "type": "integer" } }, "required": [ "order_name", "consecutive", "first_suppressed", "suppressed_for_ms" ], "type": "object" }, "OrdersFeedBody": { "additionalProperties": false, "properties": { "items": { "items": { "$ref": "#/components/schemas/MonitorFeedItemResponse" }, "type": [ "array", "null" ] }, "partial": { "type": "boolean" }, "partial_errors": { "items": { "type": "string" }, "type": [ "array", "null" ] } }, "required": [ "items", "partial" ], "type": "object" }, "OutboundChannelMismatchPayload": { "additionalProperties": false, "properties": { "conversation_id": { "type": "string" }, "owner_session": { "type": "string" }, "posting_session": { "type": "string" }, "provider": { "type": "string" } }, "required": [ "provider", "conversation_id", "posting_session", "owner_session" ], "type": "object" }, "OutboundEventPayload": { "additionalProperties": false, "properties": { "conversation_id": { "type": "string" }, "message_id": { "type": "string" }, "provider": { "type": "string" }, "session": { "type": "string" } }, "required": [ "provider", "conversation_id", "session", "message_id" ], "type": "object" }, "OutboundResult": { "additionalProperties": false, "properties": { "DeliveryContext": { "$ref": "#/components/schemas/DeliveryContextRecord" }, "Receipt": { "$ref": "#/components/schemas/PublishReceipt" }, "TranscriptEntry": { "$ref": "#/components/schemas/ConversationTranscriptRecord" } }, "required": [ "Receipt", "DeliveryContext", "TranscriptEntry" ], "type": "object" }, "OutputTurn": { "additionalProperties": false, "properties": { "role": { "type": "string" }, "text": { "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "role", "text" ], "type": "object" }, "PackAddInputBody": { "additionalProperties": false, "properties": { "name": { "description": "Optional local binding name override; derived from the source when omitted.", "type": "string" }, "source": { "description": "Pack source: a remote git URL or registry ref (a sub-path of a repo is allowed).", "examples": [ "https://github.com/org/repo/tree/main/packs/review" ], "minLength": 1, "type": "string" }, "version": { "description": "Optional semver constraint for a git-backed pack.", "examples": [ "^1.2.0" ], "type": "string" } }, "required": [ "source" ], "type": "object" }, "PackAddedOutputBody": { "additionalProperties": false, "properties": { "git_backed": { "description": "Whether the resolved source is git-backed (has a lock entry).", "type": "boolean" }, "name": { "description": "The local binding name written to [imports.\u003cname\u003e].", "type": "string" }, "source": { "description": "The canonical source string written to the manifest.", "type": "string" }, "version": { "description": "The version constraint written, if any.", "type": "string" } }, "required": [ "name", "source", "git_backed" ], "type": "object" }, "PackListBody": { "additionalProperties": false, "properties": { "packs": { "description": "Registered packs.", "items": { "$ref": "#/components/schemas/PackResponse" }, "type": [ "array", "null" ] } }, "required": [ "packs" ], "type": "object" }, "PackRemovedOutputBody": { "additionalProperties": false, "properties": { "name": { "description": "The binding name removed.", "type": "string" } }, "required": [ "name" ], "type": "object" }, "PackResponse": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "source": { "type": "string" }, "version": { "type": "string" } }, "required": [ "name" ], "type": "object" }, "PaginationInfo": { "additionalProperties": false, "properties": { "has_newer_messages": { "type": "boolean" }, "has_older_messages": { "type": "boolean" }, "returned_message_count": { "format": "int64", "type": "integer" }, "total_compactions": { "format": "int64", "type": "integer" }, "total_message_count": { "format": "int64", "type": "integer" }, "truncated_before_message": { "type": "string" } }, "required": [ "has_older_messages", "total_message_count", "returned_message_count", "total_compactions" ], "type": "object" }, "PatchDeletedResponseBody": { "additionalProperties": false, "properties": { "agent_patch": { "description": "Agent patch qualified name.", "type": "string" }, "provider_patch": { "description": "Provider patch name.", "type": "string" }, "rig_patch": { "description": "Rig patch name.", "type": "string" }, "status": { "description": "Operation result.", "examples": [ "deleted" ], "type": "string" } }, "required": [ "status" ], "type": "object" }, "PatchOKResponseBody": { "additionalProperties": false, "properties": { "agent_patch": { "description": "Agent patch qualified name.", "type": "string" }, "provider_patch": { "description": "Provider patch name.", "type": "string" }, "rig_patch": { "description": "Rig patch name.", "type": "string" }, "status": { "description": "Operation result.", "examples": [ "ok" ], "type": "string" } }, "required": [ "status" ], "type": "object" }, "PendingInteraction": { "additionalProperties": false, "properties": { "kind": { "type": "string" }, "metadata": { "additionalProperties": { "type": "string" }, "type": "object" }, "options": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "prompt": { "type": "string" }, "request_id": { "type": "string" } }, "required": [ "request_id", "kind" ], "type": "object" }, "PoolLimits": { "additionalProperties": false, "properties": { "max": { "description": "Maximum concurrent sessions; -1 means unlimited.", "format": "int64", "type": "integer" }, "min": { "description": "Minimum concurrent sessions kept running.", "format": "int64", "type": "integer" } }, "required": [ "min", "max" ], "type": "object" }, "PoolOverride": { "additionalProperties": false, "properties": { "Check": { "type": [ "string", "null" ] }, "DrainTimeout": { "type": [ "string", "null" ] }, "Max": { "format": "int64", "type": [ "integer", "null" ] }, "Min": { "format": "int64", "type": [ "integer", "null" ] }, "OnBoot": { "type": [ "string", "null" ] }, "OnDeath": { "type": [ "string", "null" ] } }, "required": [ "Min", "Max", "Check", "DrainTimeout", "OnDeath", "OnBoot" ], "type": "object" }, "ProjectIdentityStampedPayload": { "additionalProperties": false, "properties": { "layer": { "type": "string" }, "new_id": { "type": "string" }, "old_id": { "type": "string" }, "scope_root": { "type": "string" }, "source": { "type": "string" } }, "required": [ "scope_root", "source", "layer", "new_id" ], "type": "object" }, "ProviderCreateInputBody": { "additionalProperties": false, "properties": { "acp_args": { "description": "ACP transport command arguments override.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "acp_command": { "description": "ACP transport command binary override.", "type": "string" }, "args": { "description": "Command arguments.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "args_append": { "description": "Arguments appended after inherited/base args.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "base": { "description": "Optional provider base for inheritance.", "type": "string" }, "command": { "description": "Provider command binary. Omit for base-only descendants.", "type": "string" }, "display_name": { "description": "Human-readable display name.", "type": "string" }, "env": { "additionalProperties": { "type": "string" }, "description": "Environment variables.", "type": "object" }, "name": { "description": "Provider name.", "minLength": 1, "type": "string" }, "option_defaults": { "additionalProperties": { "type": "string" }, "description": "Provider option defaults (e.g. model). Keys are merged on update.", "type": "object" }, "options_schema_merge": { "description": "Options schema merge mode across inheritance chain.", "type": "string" }, "prompt_flag": { "description": "Flag for prompt delivery.", "type": "string" }, "prompt_mode": { "description": "Prompt delivery mode.", "type": "string" }, "ready_delay_ms": { "description": "Milliseconds to wait before probing readiness.", "format": "int64", "type": "integer" } }, "required": [ "name" ], "type": "object" }, "ProviderCreatedOutputBody": { "additionalProperties": false, "properties": { "provider": { "description": "Created provider name.", "type": "string" }, "status": { "description": "Operation result.", "examples": [ "created" ], "type": "string" } }, "required": [ "status", "provider" ], "type": "object" }, "ProviderOptionDTO": { "additionalProperties": false, "properties": { "choices": { "items": { "$ref": "#/components/schemas/OptionChoiceDTO" }, "type": [ "array", "null" ] }, "default": { "type": "string" }, "key": { "type": "string" }, "label": { "type": "string" }, "type": { "type": "string" } }, "required": [ "key", "label", "type", "default", "choices" ], "type": "object" }, "ProviderPatch": { "additionalProperties": false, "properties": { "ACPArgs": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "ACPCommand": { "type": [ "string", "null" ] }, "AcceptStartupDialogs": { "type": [ "boolean", "null" ] }, "Args": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "ArgsAppend": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "Base": { "type": [ "string", "null" ] }, "Command": { "type": [ "string", "null" ] }, "Env": { "additionalProperties": { "type": "string" }, "type": "object" }, "EnvRemove": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "Name": { "type": "string" }, "OptionsSchemaMerge": { "type": [ "string", "null" ] }, "PromptFlag": { "type": [ "string", "null" ] }, "PromptMode": { "type": [ "string", "null" ] }, "ReadyDelayMs": { "format": "int64", "type": [ "integer", "null" ] }, "Replace": { "type": "boolean" } }, "required": [ "Name", "Base", "Command", "ACPCommand", "Args", "ACPArgs", "ArgsAppend", "OptionsSchemaMerge", "PromptMode", "PromptFlag", "ReadyDelayMs", "AcceptStartupDialogs", "Env", "EnvRemove", "Replace" ], "type": "object" }, "ProviderPatchSetInputBody": { "additionalProperties": false, "properties": { "accept_startup_dialogs": { "description": "Override startup dialog acceptance behavior.", "type": "boolean" }, "acp_args": { "description": "Override ACP transport command arguments.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "acp_command": { "description": "Override ACP transport command binary.", "type": "string" }, "args": { "description": "Override command arguments.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "command": { "description": "Override command binary.", "type": "string" }, "env": { "additionalProperties": { "type": "string" }, "description": "Override environment variables.", "type": "object" }, "name": { "description": "Provider name.", "type": "string" }, "prompt_flag": { "description": "Override prompt flag.", "type": "string" }, "prompt_mode": { "description": "Override prompt delivery mode.", "type": "string" }, "ready_delay_ms": { "description": "Override ready delay in milliseconds.", "format": "int64", "type": "integer" } }, "type": "object" }, "ProviderPublicListBody": { "additionalProperties": false, "properties": { "items": { "description": "The list of browser-safe provider summaries.", "items": { "$ref": "#/components/schemas/ProviderPublicResponse" }, "type": [ "array", "null" ] }, "next_cursor": { "description": "Cursor for the next page of results.", "type": "string" }, "total": { "description": "Total number of providers in the list.", "format": "int64", "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "ProviderPublicResponse": { "additionalProperties": false, "properties": { "builtin": { "type": "boolean" }, "city_level": { "type": "boolean" }, "display_name": { "type": "string" }, "effective_defaults": { "additionalProperties": { "type": "string" }, "type": "object" }, "name": { "type": "string" }, "options_schema": { "items": { "$ref": "#/components/schemas/ProviderOptionDTO" }, "type": [ "array", "null" ] } }, "required": [ "name", "builtin", "city_level" ], "type": "object" }, "ProviderReadiness": { "additionalProperties": false, "properties": { "detail": { "type": "string" }, "display_name": { "type": "string" }, "status": { "type": "string" } }, "required": [ "display_name", "status" ], "type": "object" }, "ProviderReadinessResponse": { "additionalProperties": false, "properties": { "providers": { "additionalProperties": { "$ref": "#/components/schemas/ProviderReadiness" }, "type": "object" } }, "required": [ "providers" ], "type": "object" }, "ProviderResponse": { "additionalProperties": false, "properties": { "acp_args": { "items": { "type": "string" }, "type": "array" }, "acp_command": { "type": "string" }, "args": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "builtin": { "type": "boolean" }, "city_level": { "type": "boolean" }, "command": { "type": "string" }, "display_name": { "type": "string" }, "env": { "additionalProperties": { "type": "string" }, "type": "object" }, "name": { "type": "string" }, "prompt_flag": { "type": "string" }, "prompt_mode": { "type": "string" }, "ready_delay_ms": { "format": "int64", "type": "integer" } }, "required": [ "name", "builtin", "city_level" ], "type": "object" }, "ProviderSpecJSON": { "additionalProperties": false, "properties": { "acp_args": { "items": { "type": "string" }, "type": "array" }, "acp_command": { "type": "string" }, "args": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "command": { "type": "string" }, "display_name": { "type": "string" }, "env": { "additionalProperties": { "type": "string" }, "type": "object" }, "prompt_flag": { "type": "string" }, "prompt_mode": { "type": "string" }, "ready_delay_ms": { "format": "int64", "type": "integer" } }, "type": "object" }, "ProviderUpdateInputBody": { "additionalProperties": false, "properties": { "acp_args": { "description": "ACP transport command arguments override.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "acp_command": { "description": "ACP transport command binary override.", "type": "string" }, "args": { "description": "Command arguments.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "args_append": { "description": "Arguments appended after inherited/base args.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "base": { "description": "Provider base for inheritance.", "type": "string" }, "command": { "description": "Provider command binary.", "type": "string" }, "display_name": { "description": "Human-readable display name.", "type": "string" }, "env": { "additionalProperties": { "type": "string" }, "description": "Environment variables.", "type": "object" }, "option_defaults": { "additionalProperties": { "type": "string" }, "description": "Provider option defaults (e.g. model). Keys are merged on update.", "type": "object" }, "options_schema_merge": { "description": "Options schema merge mode across inheritance chain.", "type": "string" }, "prompt_flag": { "description": "Flag for prompt delivery.", "type": "string" }, "prompt_mode": { "description": "Prompt delivery mode.", "type": "string" }, "ready_delay_ms": { "description": "Milliseconds to wait before probing readiness.", "format": "int64", "type": "integer" } }, "type": "object" }, "ProxiedDiagnostic": { "additionalProperties": false, "properties": { "cursors": { "$ref": "#/components/schemas/Cursors" }, "demoted": { "type": "boolean" }, "detail": { "type": "string" }, "endpoint": { "$ref": "#/components/schemas/ProxiedEndpointStamp" }, "evidence": { "type": "string" }, "idle_policy": { "type": "string" }, "verdict": { "type": "string" } }, "required": [ "endpoint", "cursors" ], "type": "object" }, "ProxiedEndpointStamp": { "additionalProperties": false, "properties": { "generation": { "type": "string" }, "pid": { "format": "int64", "type": "integer" }, "port": { "format": "int64", "type": "integer" } }, "type": "object" }, "PublishReceipt": { "additionalProperties": false, "properties": { "Conversation": { "$ref": "#/components/schemas/ConversationRef" }, "Delivered": { "type": "boolean" }, "FailureKind": { "type": "string" }, "MessageID": { "type": "string" }, "Metadata": { "additionalProperties": { "type": "string" }, "type": "object" }, "RetryAfter": { "format": "int64", "type": "integer" } }, "required": [ "MessageID", "Conversation", "Delivered", "FailureKind", "RetryAfter", "Metadata" ], "type": "object" }, "ReadinessItem": { "additionalProperties": false, "properties": { "detail": { "type": "string" }, "display_name": { "type": "string" }, "kind": { "type": "string" }, "name": { "type": "string" }, "status": { "type": "string" } }, "required": [ "name", "kind", "display_name", "status" ], "type": "object" }, "ReadinessResponse": { "additionalProperties": false, "properties": { "items": { "additionalProperties": { "$ref": "#/components/schemas/ReadinessItem" }, "type": "object" } }, "required": [ "items" ], "type": "object" }, "Record": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "created_at": { "format": "date-time", "type": "string" }, "hostname": { "type": "string" }, "id": { "type": "string" }, "message": { "type": "string" }, "metadata": { "additionalProperties": { "type": "string" }, "type": "object" }, "ref_bead": { "type": "string" }, "severity": { "type": "string" }, "source_path": { "type": "string" }, "source_pid": { "format": "int64", "type": "integer" } }, "required": [ "id", "severity", "actor", "message", "created_at" ], "type": "object" }, "RequestFailedPayload": { "additionalProperties": false, "properties": { "error_code": { "description": "Machine-readable error code.", "type": "string" }, "error_message": { "description": "Human-readable error description.", "type": "string" }, "operation": { "description": "Which operation failed.", "enum": [ "city.create", "city.unregister", "session.create", "session.message", "session.submit", "rig.create" ], "type": "string" }, "request_id": { "description": "Correlation ID from the 202 response.", "type": "string" } }, "required": [ "request_id", "operation", "error_code", "error_message" ], "type": "object" }, "RigActionBody": { "additionalProperties": false, "properties": { "action": { "description": "Action that was performed.", "type": "string" }, "failed": { "description": "Agents that failed to stop (restart only).", "items": { "type": "string" }, "type": [ "array", "null" ] }, "killed": { "description": "Agents that were killed (restart only).", "items": { "type": "string" }, "type": [ "array", "null" ] }, "rig": { "description": "Rig name.", "type": "string" }, "status": { "description": "Operation result (ok, partial, failed).", "examples": [ "ok" ], "type": "string" } }, "required": [ "status", "action", "rig" ], "type": "object" }, "RigCreateBody": { "additionalProperties": false, "properties": { "default_branch": { "description": "Mainline branch (e.g. main, master). Auto-detected when omitted.", "type": "string" }, "git_url": { "description": "Git URL to clone (triggers async provisioning).", "type": "string" }, "name": { "description": "Rig name.", "minLength": 1, "type": "string" }, "path": { "description": "Filesystem path (server-derived for git_url clones).", "type": "string" }, "prefix": { "description": "Session name prefix.", "type": "string" }, "request_id": { "description": "Client-supplied idempotency key; reuse across retries.", "type": "string" } }, "required": [ "name" ], "type": "object" }, "RigCreateResponseBody": { "additionalProperties": false, "properties": { "default_branch": { "description": "Resolved mainline branch (created/exists).", "type": "string" }, "event_cursor": { "description": "City event-stream cursor captured before accept (202 only); pass as after_seq to the events stream to receive request.result.rig.create / rig.provision.progress / request.failed without replaying unrelated backlog.", "type": "string" }, "prefix": { "description": "Resolved session-name prefix (created/exists).", "type": "string" }, "request_id": { "description": "Correlation ID; echo of the request's request_id, or a server-minted id on 202.", "type": "string" }, "rig": { "description": "Rig name (created/exists).", "type": "string" }, "status": { "description": "created (201 sync), accepted (202 async provisioning), exists (200 idempotent replay).", "enum": [ "created", "accepted", "exists" ], "type": "string" } }, "required": [ "status" ], "type": "object" }, "RigCreateSucceededPayload": { "additionalProperties": false, "properties": { "default_branch": { "description": "Resolved mainline branch.", "type": "string" }, "prefix": { "description": "Resolved session-name prefix.", "type": "string" }, "request_id": { "description": "Correlation ID from the 202 response.", "type": "string" }, "rig": { "description": "Rig name that was provisioned.", "type": "string" } }, "required": [ "request_id", "rig", "prefix", "default_branch" ], "type": "object" }, "RigPatch": { "additionalProperties": false, "properties": { "BeadsProxiedIdleTimeout": { "type": [ "string", "null" ] }, "DefaultBranch": { "type": [ "string", "null" ] }, "DefaultMergeStrategy": { "type": [ "string", "null" ] }, "FormulaVars": { "additionalProperties": { "type": "string" }, "type": "object" }, "Name": { "type": "string" }, "Path": { "type": [ "string", "null" ] }, "Prefix": { "type": [ "string", "null" ] }, "Suspended": { "type": [ "boolean", "null" ] }, "SuspendedOnStart": { "type": [ "boolean", "null" ] } }, "required": [ "Name", "Path", "Prefix", "DefaultBranch", "DefaultMergeStrategy", "Suspended", "SuspendedOnStart", "FormulaVars", "BeadsProxiedIdleTimeout" ], "type": "object" }, "RigPatchSetInputBody": { "additionalProperties": false, "properties": { "default_branch": { "description": "Override mainline branch.", "type": "string" }, "name": { "description": "Rig name.", "type": "string" }, "path": { "description": "Override filesystem path.", "type": "string" }, "prefix": { "description": "Override bead ID prefix.", "type": "string" }, "suspended": { "description": "Override suspended state.", "type": "boolean" } }, "type": "object" }, "RigProvisionProgressPayload": { "additionalProperties": false, "properties": { "detail": { "description": "Human-readable step detail.", "type": "string" }, "request_id": { "description": "Correlation ID from the 202 response (empty on sync 201 provisions).", "type": "string" }, "rig": { "description": "Rig name being provisioned.", "type": "string" }, "step": { "description": "Provisioning step that completed (clone, beads-init, packs, config, routes, …).", "type": "string" }, "warn": { "description": "True when the step reports a warn-and-continue condition.", "type": "boolean" } }, "required": [ "rig", "step" ], "type": "object" }, "RigResponse": { "additionalProperties": false, "properties": { "agent_count": { "format": "int64", "type": "integer" }, "default_branch": { "description": "Mainline branch (e.g. main, master).", "type": "string" }, "default_sling_target": { "description": "Agent qualified name that targetless gc sling routes this rig's work to.", "type": "string" }, "default_sling_targets": { "description": "Agents targetless gc sling picks from at random; takes precedence over default_sling_target when set.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "git": { "$ref": "#/components/schemas/GitStatus" }, "last_activity": { "format": "date-time", "type": "string" }, "name": { "type": "string" }, "path": { "type": "string" }, "prefix": { "description": "Effective bead ID prefix: the configured prefix, or the one derived from the rig name.", "type": "string" }, "running_count": { "format": "int64", "type": "integer" }, "suspended": { "type": "boolean" } }, "required": [ "name", "path", "suspended", "agent_count", "running_count" ], "type": "object" }, "RigUpdateInputBody": { "additionalProperties": false, "properties": { "default_branch": { "description": "Mainline branch (e.g. main, master).", "type": "string" }, "path": { "description": "Filesystem path.", "type": "string" }, "prefix": { "description": "Session name prefix.", "type": "string" }, "suspended": { "description": "Whether rig is suspended.", "type": "boolean" } }, "type": "object" }, "RotatedPayload": { "additionalProperties": false, "properties": { "prior_archive": { "type": "string" }, "prior_first_seq": { "format": "int64", "minimum": 0, "type": "integer" }, "prior_last_seq": { "format": "int64", "minimum": 0, "type": "integer" } }, "required": [ "prior_archive", "prior_first_seq", "prior_last_seq" ], "type": "object" }, "Run": { "additionalProperties": false, "properties": { "formula": { "description": "Formula name driving the run, when known.", "type": "string" }, "last_error": { "$ref": "#/components/schemas/RunLastError", "description": "Structured failure reason for a terminal run." }, "run_id": { "description": "Stable run identifier (the run root bead id).", "type": "string" }, "scope": { "$ref": "#/components/schemas/RunScope", "description": "Resolved run scope." }, "started_at": { "description": "RFC3339 run start time (root creation).", "type": "string" }, "status": { "$ref": "#/components/schemas/RunStatus", "description": "Closed lifecycle status." }, "target": { "description": "Where the run is routed (rig/target), when known.", "type": "string" }, "title": { "description": "Human-readable run title.", "type": "string" }, "updated_at": { "description": "RFC3339 time of the run's most recent activity.", "type": "string" } }, "required": [ "run_id", "title", "status", "scope" ], "type": "object" }, "RunCancelOutputBody": { "additionalProperties": false, "properties": { "closed": { "description": "Count of the run's beads closed by the cancel.", "format": "int64", "type": "integer" }, "run_id": { "description": "The canceled run.", "type": "string" }, "status": { "$ref": "#/components/schemas/RunStatus", "description": "Run status after the cancel wind-down." } }, "required": [ "run_id", "status", "closed" ], "type": "object" }, "RunLastError": { "additionalProperties": false, "properties": { "code": { "description": "Machine-readable outcome code (e.g. fail, skipped, canceled).", "type": "string" }, "message": { "description": "Human-readable failure detail, when available.", "type": "string" } }, "required": [ "code" ], "type": "object" }, "RunRef": { "additionalProperties": false, "properties": { "kind": { "description": "Launch mechanism that produced the run.", "enum": [ "sling", "order" ], "type": "string" }, "run_id": { "description": "Run identifier; GET /v0/city/{cityName}/runs/{run_id} for detail.", "type": "string" }, "status": { "$ref": "#/components/schemas/RunStatus", "description": "Closed lifecycle status at response time (a just-launched run is pending)." } }, "required": [ "run_id", "kind", "status" ], "type": "object" }, "RunScope": { "additionalProperties": false, "properties": { "kind": { "description": "Scope kind (city or rig), when resolved.", "type": "string" }, "ref": { "description": "Scope reference within the kind, when resolved.", "type": "string" } }, "type": "object" }, "RunStatus": { "description": "Closed lifecycle state of a run.", "enum": [ "pending", "active", "waiting", "canceling", "completed", "failed", "canceled", "skipped" ], "type": "string" }, "RunStatusCounts": { "additionalProperties": false, "properties": { "active": { "description": "Runs with work in progress.", "format": "int64", "type": "integer" }, "canceled": { "description": "Runs terminated by cancellation.", "format": "int64", "type": "integer" }, "canceling": { "description": "Runs winding down after cancellation.", "format": "int64", "type": "integer" }, "completed": { "description": "Runs completed successfully.", "format": "int64", "type": "integer" }, "failed": { "description": "Runs completed with failure.", "format": "int64", "type": "integer" }, "pending": { "description": "Runs created but not yet started.", "format": "int64", "type": "integer" }, "skipped": { "description": "Runs completed as a no-op or skip.", "format": "int64", "type": "integer" }, "waiting": { "description": "Runs waiting on a dependency or gate.", "format": "int64", "type": "integer" } }, "required": [ "pending", "active", "waiting", "canceling", "completed", "failed", "canceled", "skipped" ], "type": "object" }, "RunStep": { "additionalProperties": false, "properties": { "assignee": { "description": "Current assignee, when set.", "type": "string" }, "id": { "description": "Step (child bead) identifier.", "type": "string" }, "kind": { "description": "Step kind (bead type).", "type": "string" }, "status": { "$ref": "#/components/schemas/RunStepStatus", "description": "Closed step lifecycle status." }, "title": { "description": "Step title.", "type": "string" } }, "required": [ "id", "title", "status" ], "type": "object" }, "RunStepStatus": { "description": "Closed lifecycle state of a run step.", "enum": [ "pending", "active", "blocked", "completed", "failed", "skipped", "canceled" ], "type": "string" }, "RunStepsOutputBody": { "additionalProperties": false, "properties": { "run_id": { "description": "Run identifier the steps belong to.", "type": "string" }, "steps": { "description": "Steps of the run.", "items": { "$ref": "#/components/schemas/RunStep" }, "type": [ "array", "null" ] } }, "required": [ "run_id", "steps" ], "type": "object" }, "RunsCensusOutputBody": { "additionalProperties": false, "properties": { "partial": { "description": "True when the incremental projection is incomplete.", "type": "boolean" }, "partial_errors": { "description": "Sanitized reasons the census may be incomplete.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "status_counts": { "$ref": "#/components/schemas/RunStatusCounts", "description": "Every projected run by canonical lifecycle state." } }, "required": [ "status_counts" ], "type": "object" }, "RunsListOutputBody": { "additionalProperties": false, "properties": { "partial": { "description": "True when some runs could not be fully projected.", "type": "boolean" }, "partial_errors": { "description": "Reasons the projection was partial.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "runs": { "description": "Runs in the city, newest activity first.", "items": { "$ref": "#/components/schemas/Run" }, "type": [ "array", "null" ] }, "status_counts": { "$ref": "#/components/schemas/RunStatusCounts", "description": "All projected runs by canonical lifecycle state; not truncated by the row limit." } }, "required": [ "runs", "status_counts" ], "type": "object" }, "ScopeGroup": { "additionalProperties": false, "type": "object" }, "ServiceRestartOutputBody": { "additionalProperties": false, "properties": { "action": { "description": "Action performed.", "examples": [ "restart" ], "type": "string" }, "service": { "description": "Service name.", "type": "string" }, "status": { "description": "Operation result.", "examples": [ "ok" ], "type": "string" } }, "required": [ "status", "action", "service" ], "type": "object" }, "SessionActivityEvent": { "additionalProperties": false, "properties": { "activity": { "description": "Session activity state: 'idle' or 'in-turn'.", "examples": [ "idle" ], "type": "string" } }, "required": [ "activity" ], "type": "object" }, "SessionAgentGetResponse": { "additionalProperties": false, "properties": { "messages": { "items": {}, "type": [ "array", "null" ] }, "status": { "type": "string" } }, "required": [ "messages" ], "type": "object" }, "SessionAgentListResponse": { "additionalProperties": false, "properties": { "agents": { "items": { "$ref": "#/components/schemas/AgentMapping" }, "type": [ "array", "null" ] } }, "required": [ "agents" ], "type": "object" }, "SessionBindingRecord": { "additionalProperties": false, "properties": { "AgentName": { "type": "string" }, "BindingGeneration": { "format": "int64", "type": "integer" }, "BoundAt": { "format": "date-time", "type": "string" }, "Conversation": { "$ref": "#/components/schemas/ConversationRef" }, "ExpiresAt": { "format": "date-time", "type": [ "string", "null" ] }, "ID": { "type": "string" }, "Metadata": { "additionalProperties": { "type": "string" }, "type": "object" }, "SchemaVersion": { "format": "int64", "type": "integer" }, "SessionID": { "type": "string" }, "SessionName": { "type": "string" }, "Status": { "$ref": "#/components/schemas/BindingStatus" } }, "required": [ "ID", "SchemaVersion", "Conversation", "SessionID", "SessionName", "AgentName", "Status", "BoundAt", "ExpiresAt", "BindingGeneration", "Metadata" ], "type": "object" }, "SessionCreateBody": { "additionalProperties": false, "properties": { "alias": { "description": "Optional session alias.", "type": "string" }, "async": { "description": "Create session asynchronously (agent only).", "type": "boolean" }, "kind": { "description": "Session target kind: agent or provider.", "type": "string" }, "message": { "description": "Initial message to send to the session.", "type": "string" }, "name": { "description": "Agent or provider name.", "type": "string" }, "options": { "additionalProperties": { "type": "string" }, "description": "Provider/agent option overrides.", "type": "object" }, "project_id": { "description": "Opaque project context identifier.", "type": "string" }, "session_name": { "description": "Deprecated: use alias.", "type": "string" }, "title": { "description": "Session title.", "type": "string" } }, "type": "object" }, "SessionCreateSucceededPayload": { "additionalProperties": false, "properties": { "request_id": { "description": "Correlation ID from the 202 response.", "type": "string" }, "session": { "$ref": "#/components/schemas/SessionResponse", "description": "Full session state as returned by GET /session/{id}. For session.create, this result is emitted only after the session has left creating and can accept normal metadata and lifecycle commands." } }, "required": [ "request_id", "session" ], "type": "object" }, "SessionDemandClaimDivergencePayload": { "additionalProperties": false, "properties": { "classification": { "type": "string" }, "drain_reason": { "type": "string" }, "session_id": { "type": "string" }, "template": { "type": "string" }, "trigger_bead_id": { "type": "string" }, "trigger_status_at_drain": { "type": "string" } }, "required": [ "session_id", "template", "drain_reason", "classification" ], "type": "object" }, "SessionDrainAckedWithAssignedWorkPayload": { "additionalProperties": false, "properties": { "bead_id": { "description": "ID of the work bead still holding this session as its assignee.", "type": "string" }, "bead_status": { "description": "Status of the stranded bead at emission time (typically 'in_progress' for cap-hit, 'open' if recovery races claim).", "type": "string" }, "reason": { "description": "Short diagnostic context. Today both emission sites pass 'drain_acked_with_assigned_work'; reserved for finer-grained shape discriminators if later Shape-N variants land.", "type": "string" }, "session_id": { "description": "Canonical session bead ID for the session that drain-acked.", "type": "string" }, "template": { "description": "Pool template name when known at the emission site.", "type": "string" } }, "required": [ "session_id", "bead_id" ], "type": "object" }, "SessionInfo": { "additionalProperties": false, "properties": { "attached": { "type": "boolean" }, "last_activity": { "format": "date-time", "type": "string" }, "name": { "type": "string" } }, "required": [ "name", "attached" ], "type": "object" }, "SessionLifecyclePayload": { "additionalProperties": false, "properties": { "reason": { "description": "Short human-readable reason.", "type": "string" }, "session_id": { "description": "Canonical session bead ID. Always present.", "type": "string" }, "template": { "description": "Session template name when known at the emission site.", "type": "string" } }, "required": [ "session_id" ], "type": "object" }, "SessionMessageInputBody": { "additionalProperties": false, "properties": { "message": { "description": "Message text to send.", "minLength": 1, "pattern": "\\S", "type": "string" }, "resume": { "description": "Start or resume the session here if it is not running (an operator's own message; it consumes an operator's hold). Without it, a message to a session that is not running is queued for its next run (expiring after 24h) and the controller is asked to start it; the result's will_start says whether it will.", "type": "boolean" } }, "required": [ "message" ], "type": "object" }, "SessionMessageSucceededPayload": { "additionalProperties": false, "properties": { "queued": { "description": "True when the message was queued rather than delivered: the session is held (or not running) and the message waits for its next run, expiring after 24h.", "type": "boolean" }, "request_id": { "description": "Correlation ID from the 202 response.", "type": "string" }, "session_id": { "description": "Session ID that received the message.", "type": "string" }, "will_not_start_reason": { "description": "Why the controller will not start the session for a queued message, with the remedy.", "type": "string" }, "will_start": { "description": "Present when the message was queued because the session is not running: whether the controller will start it to deliver the message. False means it will not (see will_not_start_reason); resend with resume: true to start it now.", "type": "boolean" } }, "required": [ "request_id", "session_id", "queued" ], "type": "object" }, "SessionPatchBody": { "additionalProperties": false, "properties": { "alias": { "description": "Session alias. Empty string clears the alias.", "type": "string" }, "title": { "description": "Session title. If provided, must be non-empty.", "minLength": 1, "type": "string" } }, "type": "object" }, "SessionPendingClearedEvent": { "additionalProperties": false, "properties": { "request_id": { "description": "Request ID of the interaction that was cleared.", "type": "string" } }, "required": [ "request_id" ], "type": "object" }, "SessionPendingClearedPayload": { "additionalProperties": false, "properties": { "kind": { "description": "Interaction kind from the matching session.pending.", "type": "string" }, "reason": { "description": "Why it cleared: resolved (answered or withdrawn), replaced (a different interaction is now pending; its session.pending follows), or session_gone (the session is no longer active).", "enum": [ "resolved", "replaced", "session_gone" ], "type": "string" }, "request_id": { "description": "Request ID from the matching session.pending.", "type": "string" }, "session_id": { "description": "Session bead ID from the matching session.pending.", "type": "string" } }, "required": [ "session_id", "request_id", "kind", "reason" ], "type": "object" }, "SessionPendingPayload": { "additionalProperties": false, "properties": { "alias": { "description": "Session alias, when set.", "type": "string" }, "kind": { "description": "Interaction kind (e.g. approval).", "type": "string" }, "metadata": { "additionalProperties": { "type": "string" }, "description": "Provider metadata (e.g. tool_name, source).", "type": "object" }, "options": { "description": "Answer options as the session shows them.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "prompt": { "description": "Human-readable prompt.", "type": "string" }, "request_id": { "description": "Pending interaction request ID. Pass it to POST .../session/{id}/respond.", "type": "string" }, "session_id": { "description": "Session bead ID awaiting a decision.", "type": "string" }, "template": { "description": "Session template, when known.", "type": "string" } }, "required": [ "session_id", "request_id", "kind" ], "type": "object" }, "SessionPendingResponse": { "additionalProperties": false, "properties": { "pending": { "$ref": "#/components/schemas/PendingInteraction" }, "supported": { "type": "boolean" } }, "required": [ "supported" ], "type": "object" }, "SessionPermissionModeBody": { "additionalProperties": false, "properties": { "permission_mode": { "description": "Provider schema value for the permission_mode option.", "minLength": 1, "pattern": "\\S", "type": "string" } }, "required": [ "permission_mode" ], "type": "object" }, "SessionPoolSlotRetiredAtDrainDeadlinePayload": { "additionalProperties": false, "properties": { "drain_age_seconds": { "description": "Whole seconds the seat spent in drain before the deadline retired it. Always at least the retire deadline.", "format": "int64", "type": "integer" }, "drain_at": { "description": "RFC3339 instant the seat entered drain (the drain_at metadata). Empty only if the marker was unreadable, in which case no retirement occurs.", "type": "string" }, "session_id": { "description": "Canonical session bead ID for the retired pool seat.", "type": "string" }, "session_name": { "description": "Runtime session name the seat held. This is the name the pool could not route around until the retirement freed it.", "type": "string" }, "template": { "description": "Pool template name when known at the emission site.", "type": "string" } }, "required": [ "session_id", "drain_age_seconds" ], "type": "object" }, "SessionRawMessageFrame": { "description": "Provider-native transcript frame. Gas City forwards the exact JSON the provider wrote to its session log, so the shape is provider-specific and can be any JSON value. The producing provider is identified by the Provider field on the enclosing envelope; consumers dispatch per-provider frame parsing keyed by that identifier.", "title": "Session raw transcript frame" }, "SessionRenameInputBody": { "additionalProperties": false, "properties": { "title": { "description": "New session title.", "minLength": 1, "type": "string" } }, "required": [ "title" ], "type": "object" }, "SessionResetStalledPayload": { "additionalProperties": false, "properties": { "elapsed_s": { "format": "int64", "type": "integer" }, "reset_committed_at": { "type": "string" }, "session_name": { "type": "string" }, "template": { "type": "string" } }, "required": [ "session_name", "template", "reset_committed_at", "elapsed_s" ], "type": "object" }, "SessionRespondInputBody": { "additionalProperties": false, "properties": { "action": { "description": "Response action (e.g. allow, deny).", "minLength": 1, "type": "string" }, "metadata": { "additionalProperties": { "type": "string" }, "description": "Optional response metadata.", "type": "object" }, "request_id": { "description": "Pending interaction request ID (optional).", "type": "string" }, "text": { "description": "Optional response text.", "type": "string" } }, "required": [ "action" ], "type": "object" }, "SessionRespondOutputBody": { "additionalProperties": false, "properties": { "id": { "description": "Session ID.", "type": "string" }, "status": { "description": "Operation result.", "examples": [ "accepted" ], "type": "string" } }, "required": [ "status", "id" ], "type": "object" }, "SessionResponse": { "additionalProperties": false, "properties": { "active_bead": { "type": "string" }, "activity": { "type": "string" }, "agent_kind": { "type": "string" }, "alias": { "type": "string" }, "attached": { "type": "boolean" }, "configured_named_session": { "type": "boolean" }, "context_pct": { "format": "int64", "type": "integer" }, "context_window": { "format": "int64", "type": "integer" }, "created_at": { "type": "string" }, "display_name": { "type": "string" }, "id": { "type": "string" }, "kind": { "type": "string" }, "last_active": { "type": "string" }, "last_nudge_delivered_at": { "type": "string" }, "last_output": { "type": "string" }, "metadata": { "additionalProperties": { "type": "string" }, "type": "object" }, "model": { "type": "string" }, "options": { "additionalProperties": { "type": "string" }, "type": "object" }, "pool": { "type": "string" }, "provider": { "type": "string" }, "reason": { "type": "string" }, "rig": { "type": "string" }, "running": { "type": "boolean" }, "session_name": { "type": "string" }, "state": { "type": "string" }, "submission_capabilities": { "$ref": "#/components/schemas/SubmissionCapabilities" }, "template": { "type": "string" }, "title": { "type": "string" }, "work_dir": { "type": "string" } }, "required": [ "id", "template", "state", "title", "provider", "session_name", "created_at", "attached", "running" ], "type": "object" }, "SessionStrandedPayload": { "additionalProperties": false, "properties": { "session_id": { "description": "Canonical session bead ID for the stranded pool session (also the envelope Subject).", "type": "string" }, "session_name": { "description": "Runtime session name from the session bead metadata, when set.", "type": "string" }, "template": { "description": "Pool template name when known at the emission site.", "type": "string" }, "work_bead_ids": { "description": "IDs of the open/in-progress work beads still assigned to the session. Never truncated, unlike the envelope Message. Empty when the work-collection query failed at emission time.", "items": { "type": "string" }, "type": [ "array", "null" ] } }, "required": [ "session_id" ], "type": "object" }, "SessionStreamCommonEvent": { "description": "Non-message events emitted on the session SSE stream: activity transitions, pending-interaction lifecycle updates, and keepalive heartbeats. The concrete variant is identified by the SSE event name.", "oneOf": [ { "$ref": "#/components/schemas/SessionActivityEvent" }, { "$ref": "#/components/schemas/PendingInteraction" }, { "$ref": "#/components/schemas/SessionPendingClearedEvent" }, { "$ref": "#/components/schemas/HeartbeatEvent" } ], "title": "Session stream lifecycle event" }, "SessionStreamMessageEvent": { "additionalProperties": false, "properties": { "format": { "type": "string" }, "id": { "type": "string" }, "pagination": { "$ref": "#/components/schemas/PaginationInfo" }, "provider": { "description": "Producing provider identifier (claude, codex, gemini, opencode, etc.).", "type": "string" }, "template": { "type": "string" }, "turns": { "items": { "$ref": "#/components/schemas/OutputTurn" }, "type": [ "array", "null" ] } }, "required": [ "id", "template", "provider", "format", "turns" ], "type": "object" }, "SessionStreamRawMessageEvent": { "additionalProperties": false, "properties": { "format": { "type": "string" }, "id": { "type": "string" }, "messages": { "description": "Provider-native transcript frames, emitted verbatim as the provider wrote them.", "items": { "$ref": "#/components/schemas/SessionRawMessageFrame" }, "type": [ "array", "null" ] }, "pagination": { "$ref": "#/components/schemas/PaginationInfo" }, "provider": { "description": "Producing provider identifier (claude, codex, gemini, opencode, etc.). Consumers use this to dispatch per-provider frame parsing.", "type": "string" }, "template": { "type": "string" } }, "required": [ "id", "template", "provider", "format", "messages" ], "type": "object" }, "SessionStreamStructuredMessageEvent": { "additionalProperties": false, "description": "Provider-neutral structured transcript update with explicit snapshot, upsert, or reset application semantics.", "properties": { "format": { "const": "structured", "description": "Always structured for this event.", "type": "string" }, "history": { "$ref": "#/components/schemas/SessionStructuredHistory", "description": "Normalized worker-history envelope for this snapshot or stream batch." }, "id": { "type": "string" }, "operation": { "description": "How the client applies this structured frame: replace from a snapshot/reset or merge an upsert.", "enum": [ "snapshot", "upsert", "reset" ], "type": "string" }, "pagination": { "$ref": "#/components/schemas/PaginationInfo" }, "provider": { "description": "Producing provider identifier (claude, codex, gemini, opencode, etc.).", "type": "string" }, "reset_reason": { "description": "Present if and only if operation is reset; absent for snapshot and upsert. Identifies why the reset replaced the client transcript.", "enum": [ "resume_invalid", "stream_changed", "cursor_invalidated", "history_rewritten" ], "type": "string" }, "schema_version": { "const": "session.structured.v1", "description": "Structured session transcript schema version.", "type": "string" }, "structured_messages": { "description": "Provider-normalized structured messages.", "items": { "$ref": "#/components/schemas/SessionStructuredMessage" }, "type": "array" }, "template": { "type": "string" } }, "required": [ "id", "template", "provider", "format", "schema_version", "operation", "history", "structured_messages" ], "title": "Structured session stream message", "type": "object" }, "SessionStructuredArgument": { "additionalProperties": false, "properties": { "name": { "type": "string" }, "value": { "type": "string" } }, "required": [ "name", "value" ], "type": "object" }, "SessionStructuredBlock": { "description": "Provider-normalized transcript block discriminated by its closed block type vocabulary.", "discriminator": { "mapping": { "image": "#/components/schemas/SessionStructuredBlockImage", "interaction": "#/components/schemas/SessionStructuredBlockInteraction", "text": "#/components/schemas/SessionStructuredBlockText", "thinking": "#/components/schemas/SessionStructuredBlockThinking", "tool_result": "#/components/schemas/SessionStructuredBlockToolResult", "tool_use": "#/components/schemas/SessionStructuredBlockToolUse", "unknown": "#/components/schemas/SessionStructuredBlockUnknown" }, "propertyName": "type" }, "oneOf": [ { "$ref": "#/components/schemas/SessionStructuredBlockText" }, { "$ref": "#/components/schemas/SessionStructuredBlockThinking" }, { "$ref": "#/components/schemas/SessionStructuredBlockToolUse" }, { "$ref": "#/components/schemas/SessionStructuredBlockToolResult" }, { "$ref": "#/components/schemas/SessionStructuredBlockInteraction" }, { "$ref": "#/components/schemas/SessionStructuredBlockImage" }, { "$ref": "#/components/schemas/SessionStructuredBlockUnknown" } ], "title": "Structured transcript block" }, "SessionStructuredBlockImage": { "additionalProperties": false, "properties": { "file_path": { "type": "string" }, "image_url": { "type": "string" }, "mime_type": { "type": "string" }, "text": { "type": "string" }, "type": { "const": "image", "type": "string" } }, "required": [ "type" ], "title": "SessionStructuredBlockImage", "type": "object" }, "SessionStructuredBlockInteraction": { "additionalProperties": false, "properties": { "interaction": { "$ref": "#/components/schemas/SessionStructuredInteraction" }, "type": { "const": "interaction", "type": "string" } }, "required": [ "type" ], "title": "SessionStructuredBlockInteraction", "type": "object" }, "SessionStructuredBlockText": { "additionalProperties": false, "properties": { "text": { "type": "string" }, "type": { "const": "text", "type": "string" } }, "required": [ "type" ], "title": "SessionStructuredBlockText", "type": "object" }, "SessionStructuredBlockThinking": { "additionalProperties": false, "properties": { "signature": { "type": "string" }, "thinking": { "type": "string" }, "type": { "const": "thinking", "type": "string" } }, "required": [ "type" ], "title": "SessionStructuredBlockThinking", "type": "object" }, "SessionStructuredBlockToolResult": { "additionalProperties": false, "properties": { "content": { "type": "string" }, "file_path": { "type": "string" }, "is_error": { "type": "boolean" }, "name": { "type": "string" }, "structured": { "$ref": "#/components/schemas/SessionStructuredToolResult" }, "tool_call_id": { "type": "string" }, "type": { "const": "tool_result", "type": "string" } }, "required": [ "type" ], "title": "SessionStructuredBlockToolResult", "type": "object" }, "SessionStructuredBlockToolUse": { "additionalProperties": false, "properties": { "file_path": { "type": "string" }, "id": { "type": "string" }, "input": { "$ref": "#/components/schemas/SessionStructuredToolInput" }, "name": { "type": "string" }, "type": { "const": "tool_use", "type": "string" } }, "required": [ "type" ], "title": "SessionStructuredBlockToolUse", "type": "object" }, "SessionStructuredBlockUnknown": { "additionalProperties": false, "properties": { "content": { "type": "string" }, "file_path": { "type": "string" }, "id": { "type": "string" }, "image_url": { "type": "string" }, "input": { "$ref": "#/components/schemas/SessionStructuredToolInput" }, "interaction": { "$ref": "#/components/schemas/SessionStructuredInteraction" }, "is_error": { "type": "boolean" }, "mime_type": { "type": "string" }, "name": { "type": "string" }, "signature": { "type": "string" }, "structured": { "$ref": "#/components/schemas/SessionStructuredToolResult" }, "text": { "type": "string" }, "thinking": { "type": "string" }, "tool_call_id": { "type": "string" }, "type": { "const": "unknown", "type": "string" } }, "required": [ "type" ], "title": "SessionStructuredBlockUnknown", "type": "object" }, "SessionStructuredContinuity": { "additionalProperties": false, "properties": { "compaction_count": { "format": "int64", "type": "integer" }, "has_branches": { "type": "boolean" }, "note": { "type": "string" }, "status": { "type": "string" } }, "required": [ "status" ], "type": "object" }, "SessionStructuredCursor": { "additionalProperties": false, "properties": { "after_entry_id": { "type": "string" }, "resume_token": { "description": "Opaque cursor for an exact structured REST-to-SSE handoff or SSE reconnect.", "type": "string" } }, "required": [ "resume_token" ], "type": "object" }, "SessionStructuredDiagnostic": { "additionalProperties": false, "properties": { "code": { "type": "string" }, "count": { "format": "int64", "type": "integer" }, "message": { "type": "string" } }, "required": [ "code" ], "type": "object" }, "SessionStructuredGeneration": { "additionalProperties": false, "properties": { "id": { "type": "string" }, "observed_at": { "type": "string" } }, "required": [ "id" ], "type": "object" }, "SessionStructuredHistory": { "additionalProperties": false, "properties": { "continuity": { "$ref": "#/components/schemas/SessionStructuredContinuity" }, "cursor": { "$ref": "#/components/schemas/SessionStructuredCursor" }, "diagnostics": { "items": { "$ref": "#/components/schemas/SessionStructuredDiagnostic" }, "type": [ "array", "null" ] }, "gc_session_id": { "type": "string" }, "generation": { "$ref": "#/components/schemas/SessionStructuredGeneration" }, "logical_conversation_id": { "type": "string" }, "provider_session_id": { "type": "string" }, "tail_state": { "$ref": "#/components/schemas/SessionStructuredTailState" }, "transcript_stream_id": { "type": "string" } }, "required": [ "transcript_stream_id", "generation", "cursor", "continuity", "tail_state" ], "type": "object" }, "SessionStructuredIDESelection": { "additionalProperties": false, "properties": { "text": { "type": "string" } }, "type": "object" }, "SessionStructuredInteraction": { "additionalProperties": false, "properties": { "action": { "type": "string" }, "kind": { "type": "string" }, "options": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "prompt": { "type": "string" }, "request_id": { "type": "string" }, "state": { "type": "string" } }, "required": [ "state" ], "type": "object" }, "SessionStructuredMessage": { "description": "Provider-normalized transcript message discriminated by its closed role vocabulary.", "discriminator": { "mapping": { "assistant": "#/components/schemas/SessionStructuredMessageAssistant", "system": "#/components/schemas/SessionStructuredMessageSystem", "tool": "#/components/schemas/SessionStructuredMessageTool", "unknown": "#/components/schemas/SessionStructuredMessageUnknown", "user": "#/components/schemas/SessionStructuredMessageUser" }, "propertyName": "role" }, "oneOf": [ { "$ref": "#/components/schemas/SessionStructuredMessageUnknown" }, { "$ref": "#/components/schemas/SessionStructuredMessageUser" }, { "$ref": "#/components/schemas/SessionStructuredMessageAssistant" }, { "$ref": "#/components/schemas/SessionStructuredMessageSystem" }, { "$ref": "#/components/schemas/SessionStructuredMessageTool" } ], "title": "Structured transcript message" }, "SessionStructuredMessageAssistant": { "additionalProperties": false, "properties": { "blocks": { "items": { "$ref": "#/components/schemas/SessionStructuredBlock" }, "type": "array" }, "id": { "type": "string" }, "model": { "type": "string" }, "provider": { "type": "string" }, "role": { "const": "assistant", "type": "string" }, "status": { "enum": [ "unknown", "final", "partial", "superseded" ], "type": "string" }, "stop_reason": { "type": "string" }, "timestamp": { "type": "string" }, "usage": { "$ref": "#/components/schemas/SessionStructuredUsage" } }, "required": [ "role", "id", "status", "blocks" ], "title": "SessionStructuredMessageAssistant", "type": "object" }, "SessionStructuredMessageSystem": { "additionalProperties": false, "properties": { "blocks": { "items": { "$ref": "#/components/schemas/SessionStructuredBlock" }, "type": "array" }, "id": { "type": "string" }, "provider": { "type": "string" }, "role": { "const": "system", "type": "string" }, "status": { "enum": [ "unknown", "final", "partial", "superseded" ], "type": "string" }, "system_event": { "$ref": "#/components/schemas/SessionStructuredSystemEvent" }, "timestamp": { "type": "string" } }, "required": [ "role", "id", "status", "blocks" ], "title": "SessionStructuredMessageSystem", "type": "object" }, "SessionStructuredMessageTool": { "additionalProperties": false, "properties": { "blocks": { "items": { "$ref": "#/components/schemas/SessionStructuredBlock" }, "type": "array" }, "id": { "type": "string" }, "provider": { "type": "string" }, "role": { "const": "tool", "type": "string" }, "status": { "enum": [ "unknown", "final", "partial", "superseded" ], "type": "string" }, "timestamp": { "type": "string" } }, "required": [ "role", "id", "status", "blocks" ], "title": "SessionStructuredMessageTool", "type": "object" }, "SessionStructuredMessageUnknown": { "additionalProperties": false, "properties": { "blocks": { "items": { "$ref": "#/components/schemas/SessionStructuredBlock" }, "type": "array" }, "id": { "type": "string" }, "model": { "type": "string" }, "provider": { "type": "string" }, "role": { "const": "unknown", "type": "string" }, "status": { "enum": [ "unknown", "final", "partial", "superseded" ], "type": "string" }, "stop_reason": { "type": "string" }, "system_event": { "$ref": "#/components/schemas/SessionStructuredSystemEvent" }, "timestamp": { "type": "string" }, "usage": { "$ref": "#/components/schemas/SessionStructuredUsage" }, "user_prompt": { "$ref": "#/components/schemas/SessionStructuredUserPrompt" } }, "required": [ "role", "id", "status", "blocks" ], "title": "SessionStructuredMessageUnknown", "type": "object" }, "SessionStructuredMessageUser": { "additionalProperties": false, "properties": { "blocks": { "items": { "$ref": "#/components/schemas/SessionStructuredBlock" }, "type": "array" }, "id": { "type": "string" }, "provider": { "type": "string" }, "role": { "const": "user", "type": "string" }, "status": { "enum": [ "unknown", "final", "partial", "superseded" ], "type": "string" }, "timestamp": { "type": "string" }, "user_prompt": { "$ref": "#/components/schemas/SessionStructuredUserPrompt" } }, "required": [ "role", "id", "status", "blocks" ], "title": "SessionStructuredMessageUser", "type": "object" }, "SessionStructuredPatchHunk": { "additionalProperties": false, "properties": { "file_path": { "type": "string" }, "lines": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "new_lines": { "format": "int64", "type": "integer" }, "new_start": { "format": "int64", "type": "integer" }, "old_lines": { "format": "int64", "type": "integer" }, "old_start": { "format": "int64", "type": "integer" } }, "type": "object" }, "SessionStructuredPlanStep": { "additionalProperties": false, "properties": { "status": { "type": "string" }, "step": { "type": "string" } }, "type": "object" }, "SessionStructuredQuestion": { "additionalProperties": false, "properties": { "header": { "type": "string" }, "multi_select": { "type": "boolean" }, "options": { "items": { "$ref": "#/components/schemas/SessionStructuredQuestionOption" }, "type": [ "array", "null" ] }, "question": { "type": "string" } }, "type": "object" }, "SessionStructuredQuestionOption": { "additionalProperties": false, "properties": { "description": { "type": "string" }, "label": { "type": "string" } }, "type": "object" }, "SessionStructuredSearchResultItem": { "additionalProperties": false, "properties": { "snippet": { "type": "string" }, "title": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "SessionStructuredSystemEvent": { "additionalProperties": false, "properties": { "category": { "type": "string" }, "code": { "type": "string" }, "kind": { "type": "string" }, "message": { "type": "string" } }, "type": "object" }, "SessionStructuredTailState": { "additionalProperties": false, "properties": { "activity": { "type": "string" }, "degraded": { "type": "boolean" }, "degraded_reason": { "type": "string" }, "last_entry_id": { "type": "string" }, "open_tool_call_ids": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "pending_interaction_ids": { "items": { "type": "string" }, "type": [ "array", "null" ] } }, "required": [ "activity" ], "type": "object" }, "SessionStructuredTodoItem": { "additionalProperties": false, "properties": { "active_form": { "type": "string" }, "content": { "type": "string" }, "id": { "type": "string" }, "priority": { "type": "string" }, "status": { "type": "string" } }, "type": "object" }, "SessionStructuredToolError": { "additionalProperties": false, "properties": { "category": { "description": "Provider-neutral category: user_rejection, user_rejection_with_reason, command_failure, file_error, validation_error, timeout, network_error, or unknown.", "enum": [ "user_rejection", "user_rejection_with_reason", "command_failure", "file_error", "validation_error", "timeout", "network_error", "unknown" ], "type": "string" }, "message": { "type": "string" }, "user_reason": { "type": "string" } }, "required": [ "category" ], "type": "object" }, "SessionStructuredToolInput": { "description": "Provider-neutral tool input discriminated by its closed kind vocabulary.", "discriminator": { "mapping": { "arguments": "#/components/schemas/SessionStructuredToolInputArguments", "code": "#/components/schemas/SessionStructuredToolInputCode", "command": "#/components/schemas/SessionStructuredToolInputCommand", "fetch": "#/components/schemas/SessionStructuredToolInputFetch", "file": "#/components/schemas/SessionStructuredToolInputFile", "glob": "#/components/schemas/SessionStructuredToolInputGlob", "patch": "#/components/schemas/SessionStructuredToolInputPatch", "plan": "#/components/schemas/SessionStructuredToolInputPlan", "question": "#/components/schemas/SessionStructuredToolInputQuestion", "search": "#/components/schemas/SessionStructuredToolInputSearch", "stdin": "#/components/schemas/SessionStructuredToolInputStdin", "task": "#/components/schemas/SessionStructuredToolInputTask", "text": "#/components/schemas/SessionStructuredToolInputText", "todo": "#/components/schemas/SessionStructuredToolInputTodo", "unknown": "#/components/schemas/SessionStructuredToolInputUnknown", "write": "#/components/schemas/SessionStructuredToolInputWrite" }, "propertyName": "kind" }, "oneOf": [ { "$ref": "#/components/schemas/SessionStructuredToolInputUnknown" }, { "$ref": "#/components/schemas/SessionStructuredToolInputCommand" }, { "$ref": "#/components/schemas/SessionStructuredToolInputStdin" }, { "$ref": "#/components/schemas/SessionStructuredToolInputCode" }, { "$ref": "#/components/schemas/SessionStructuredToolInputPatch" }, { "$ref": "#/components/schemas/SessionStructuredToolInputWrite" }, { "$ref": "#/components/schemas/SessionStructuredToolInputGlob" }, { "$ref": "#/components/schemas/SessionStructuredToolInputFetch" }, { "$ref": "#/components/schemas/SessionStructuredToolInputSearch" }, { "$ref": "#/components/schemas/SessionStructuredToolInputFile" }, { "$ref": "#/components/schemas/SessionStructuredToolInputTodo" }, { "$ref": "#/components/schemas/SessionStructuredToolInputPlan" }, { "$ref": "#/components/schemas/SessionStructuredToolInputQuestion" }, { "$ref": "#/components/schemas/SessionStructuredToolInputTask" }, { "$ref": "#/components/schemas/SessionStructuredToolInputText" }, { "$ref": "#/components/schemas/SessionStructuredToolInputArguments" } ], "title": "Structured tool input" }, "SessionStructuredToolInputArguments": { "additionalProperties": false, "properties": { "arguments": { "items": { "$ref": "#/components/schemas/SessionStructuredArgument" }, "type": "array" }, "kind": { "const": "arguments", "description": "Provider-neutral input kind such as command, code, patch, glob, fetch, search, file, arguments, or text.", "type": "string" } }, "required": [ "kind", "arguments" ], "title": "SessionStructuredToolInputArguments", "type": "object" }, "SessionStructuredToolInputCode": { "additionalProperties": false, "properties": { "code": { "type": "string" }, "kind": { "const": "code", "description": "Provider-neutral input kind such as command, code, patch, glob, fetch, search, file, arguments, or text.", "type": "string" }, "language": { "type": "string" } }, "required": [ "kind", "code" ], "title": "SessionStructuredToolInputCode", "type": "object" }, "SessionStructuredToolInputCommand": { "additionalProperties": false, "properties": { "arguments": { "items": { "$ref": "#/components/schemas/SessionStructuredArgument" }, "type": [ "array", "null" ] }, "command": { "type": "string" }, "kind": { "const": "command", "description": "Provider-neutral input kind such as command, code, patch, glob, fetch, search, file, arguments, or text.", "type": "string" } }, "required": [ "kind", "command" ], "title": "SessionStructuredToolInputCommand", "type": "object" }, "SessionStructuredToolInputFetch": { "additionalProperties": false, "properties": { "kind": { "const": "fetch", "description": "Provider-neutral input kind such as command, code, patch, glob, fetch, search, file, arguments, or text.", "type": "string" }, "prompt": { "type": "string" }, "url": { "type": "string" } }, "required": [ "kind" ], "title": "SessionStructuredToolInputFetch", "type": "object" }, "SessionStructuredToolInputFile": { "additionalProperties": false, "properties": { "command": { "type": "string" }, "file_path": { "type": "string" }, "kind": { "const": "file", "description": "Provider-neutral input kind such as command, code, patch, glob, fetch, search, file, arguments, or text.", "type": "string" }, "language": { "type": "string" } }, "required": [ "kind", "file_path" ], "title": "SessionStructuredToolInputFile", "type": "object" }, "SessionStructuredToolInputGlob": { "additionalProperties": false, "properties": { "arguments": { "items": { "$ref": "#/components/schemas/SessionStructuredArgument" }, "type": [ "array", "null" ] }, "file_path": { "type": "string" }, "kind": { "const": "glob", "description": "Provider-neutral input kind such as command, code, patch, glob, fetch, search, file, arguments, or text.", "type": "string" }, "pattern": { "type": "string" }, "query": { "type": "string" } }, "required": [ "kind" ], "title": "SessionStructuredToolInputGlob", "type": "object" }, "SessionStructuredToolInputPatch": { "additionalProperties": false, "properties": { "file_path": { "type": "string" }, "kind": { "const": "patch", "description": "Provider-neutral input kind such as command, code, patch, glob, fetch, search, file, arguments, or text.", "type": "string" }, "language": { "type": "string" }, "patch": { "type": "string" } }, "required": [ "kind", "patch" ], "title": "SessionStructuredToolInputPatch", "type": "object" }, "SessionStructuredToolInputPlan": { "additionalProperties": false, "properties": { "explanation": { "type": "string" }, "kind": { "const": "plan", "description": "Provider-neutral input kind such as command, code, patch, glob, fetch, search, file, arguments, or text.", "type": "string" }, "plan": { "type": "string" }, "steps": { "items": { "$ref": "#/components/schemas/SessionStructuredPlanStep" }, "type": [ "array", "null" ] } }, "required": [ "kind" ], "title": "SessionStructuredToolInputPlan", "type": "object" }, "SessionStructuredToolInputQuestion": { "additionalProperties": false, "properties": { "kind": { "const": "question", "description": "Provider-neutral input kind such as command, code, patch, glob, fetch, search, file, arguments, or text.", "type": "string" }, "options": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "question": { "type": "string" } }, "required": [ "kind" ], "title": "SessionStructuredToolInputQuestion", "type": "object" }, "SessionStructuredToolInputSearch": { "additionalProperties": false, "properties": { "arguments": { "items": { "$ref": "#/components/schemas/SessionStructuredArgument" }, "type": [ "array", "null" ] }, "command": { "type": "string" }, "file_path": { "type": "string" }, "kind": { "const": "search", "description": "Provider-neutral input kind such as command, code, patch, glob, fetch, search, file, arguments, or text.", "type": "string" }, "pattern": { "type": "string" }, "query": { "type": "string" } }, "required": [ "kind" ], "title": "SessionStructuredToolInputSearch", "type": "object" }, "SessionStructuredToolInputStdin": { "additionalProperties": false, "properties": { "kind": { "const": "stdin", "description": "Provider-neutral input kind such as command, code, patch, glob, fetch, search, file, arguments, or text.", "type": "string" }, "linked_command": { "type": "string" }, "task_id": { "type": "string" }, "text": { "type": "string" } }, "required": [ "kind" ], "title": "SessionStructuredToolInputStdin", "type": "object" }, "SessionStructuredToolInputTask": { "additionalProperties": false, "properties": { "description": { "type": "string" }, "kind": { "const": "task", "description": "Provider-neutral input kind such as command, code, patch, glob, fetch, search, file, arguments, or text.", "type": "string" }, "prompt": { "type": "string" }, "task_id": { "type": "string" }, "task_status": { "type": "string" }, "task_type": { "type": "string" } }, "required": [ "kind" ], "title": "SessionStructuredToolInputTask", "type": "object" }, "SessionStructuredToolInputText": { "additionalProperties": false, "properties": { "kind": { "const": "text", "description": "Provider-neutral input kind such as command, code, patch, glob, fetch, search, file, arguments, or text.", "type": "string" }, "text": { "type": "string" } }, "required": [ "kind", "text" ], "title": "SessionStructuredToolInputText", "type": "object" }, "SessionStructuredToolInputTodo": { "additionalProperties": false, "properties": { "kind": { "const": "todo", "description": "Provider-neutral input kind such as command, code, patch, glob, fetch, search, file, arguments, or text.", "type": "string" }, "todos": { "items": { "$ref": "#/components/schemas/SessionStructuredTodoItem" }, "type": [ "array", "null" ] } }, "required": [ "kind" ], "title": "SessionStructuredToolInputTodo", "type": "object" }, "SessionStructuredToolInputUnknown": { "additionalProperties": false, "properties": { "arguments": { "items": { "$ref": "#/components/schemas/SessionStructuredArgument" }, "type": [ "array", "null" ] }, "code": { "type": "string" }, "command": { "type": "string" }, "description": { "type": "string" }, "explanation": { "type": "string" }, "file_path": { "type": "string" }, "kind": { "const": "unknown", "description": "Provider-neutral input kind such as command, code, patch, glob, fetch, search, file, arguments, or text.", "type": "string" }, "language": { "type": "string" }, "linked_command": { "type": "string" }, "options": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "patch": { "type": "string" }, "pattern": { "type": "string" }, "plan": { "type": "string" }, "prompt": { "type": "string" }, "query": { "type": "string" }, "question": { "type": "string" }, "steps": { "items": { "$ref": "#/components/schemas/SessionStructuredPlanStep" }, "type": [ "array", "null" ] }, "task_id": { "type": "string" }, "task_status": { "type": "string" }, "task_type": { "type": "string" }, "text": { "type": "string" }, "todos": { "items": { "$ref": "#/components/schemas/SessionStructuredTodoItem" }, "type": [ "array", "null" ] }, "url": { "type": "string" } }, "required": [ "kind" ], "title": "SessionStructuredToolInputUnknown", "type": "object" }, "SessionStructuredToolInputWrite": { "additionalProperties": false, "properties": { "file_path": { "type": "string" }, "kind": { "const": "write", "description": "Provider-neutral input kind such as command, code, patch, glob, fetch, search, file, arguments, or text.", "type": "string" }, "language": { "type": "string" }, "text": { "type": "string" } }, "required": [ "kind" ], "title": "SessionStructuredToolInputWrite", "type": "object" }, "SessionStructuredToolResult": { "description": "Provider-neutral tool result discriminated by its closed kind vocabulary.", "discriminator": { "mapping": { "bash": "#/components/schemas/SessionStructuredToolResultBash", "edit": "#/components/schemas/SessionStructuredToolResultEdit", "fetch": "#/components/schemas/SessionStructuredToolResultFetch", "glob": "#/components/schemas/SessionStructuredToolResultGlob", "grep": "#/components/schemas/SessionStructuredToolResultGrep", "plan": "#/components/schemas/SessionStructuredToolResultPlan", "python": "#/components/schemas/SessionStructuredToolResultPython", "question": "#/components/schemas/SessionStructuredToolResultQuestion", "read": "#/components/schemas/SessionStructuredToolResultRead", "search": "#/components/schemas/SessionStructuredToolResultSearch", "stdin": "#/components/schemas/SessionStructuredToolResultStdin", "task": "#/components/schemas/SessionStructuredToolResultTask", "text": "#/components/schemas/SessionStructuredToolResultText", "todo": "#/components/schemas/SessionStructuredToolResultTodo", "unknown": "#/components/schemas/SessionStructuredToolResultUnknown", "write": "#/components/schemas/SessionStructuredToolResultWrite" }, "propertyName": "kind" }, "oneOf": [ { "$ref": "#/components/schemas/SessionStructuredToolResultUnknown" }, { "$ref": "#/components/schemas/SessionStructuredToolResultBash" }, { "$ref": "#/components/schemas/SessionStructuredToolResultPython" }, { "$ref": "#/components/schemas/SessionStructuredToolResultRead" }, { "$ref": "#/components/schemas/SessionStructuredToolResultGlob" }, { "$ref": "#/components/schemas/SessionStructuredToolResultGrep" }, { "$ref": "#/components/schemas/SessionStructuredToolResultSearch" }, { "$ref": "#/components/schemas/SessionStructuredToolResultFetch" }, { "$ref": "#/components/schemas/SessionStructuredToolResultTodo" }, { "$ref": "#/components/schemas/SessionStructuredToolResultPlan" }, { "$ref": "#/components/schemas/SessionStructuredToolResultQuestion" }, { "$ref": "#/components/schemas/SessionStructuredToolResultStdin" }, { "$ref": "#/components/schemas/SessionStructuredToolResultTask" }, { "$ref": "#/components/schemas/SessionStructuredToolResultWrite" }, { "$ref": "#/components/schemas/SessionStructuredToolResultEdit" }, { "$ref": "#/components/schemas/SessionStructuredToolResultText" } ], "title": "Structured tool result" }, "SessionStructuredToolResultBash": { "additionalProperties": false, "properties": { "command": { "type": "string" }, "content": { "type": "string" }, "error": { "$ref": "#/components/schemas/SessionStructuredToolError" }, "exit_code": { "format": "int64", "type": "integer" }, "interrupted": { "type": "boolean" }, "is_image": { "type": "boolean" }, "kind": { "const": "bash", "type": "string" }, "num_lines": { "format": "int64", "type": "integer" }, "stderr": { "type": "string" }, "stderr_lines": { "format": "int64", "type": "integer" }, "stdout": { "type": "string" }, "stdout_lines": { "format": "int64", "type": "integer" }, "task_id": { "type": "string" }, "task_status": { "type": "string" }, "text": { "type": "string" }, "timestamp": { "type": "string" }, "truncated": { "type": "boolean" } }, "required": [ "kind" ], "title": "SessionStructuredToolResultBash", "type": "object" }, "SessionStructuredToolResultEdit": { "additionalProperties": false, "properties": { "content": { "type": "string" }, "error": { "$ref": "#/components/schemas/SessionStructuredToolError" }, "file_path": { "type": "string" }, "file_paths": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "kind": { "const": "edit", "type": "string" }, "new_string": { "type": "string" }, "old_string": { "type": "string" }, "original_file": { "type": "string" }, "patch": { "type": "string" }, "patch_hunks": { "items": { "$ref": "#/components/schemas/SessionStructuredPatchHunk" }, "type": [ "array", "null" ] }, "replace_all": { "type": "boolean" }, "user_modified": { "type": "boolean" } }, "required": [ "kind" ], "title": "SessionStructuredToolResultEdit", "type": "object" }, "SessionStructuredToolResultFetch": { "additionalProperties": false, "properties": { "bytes": { "format": "int64", "type": "integer" }, "content": { "type": "string" }, "duration_ms": { "format": "int64", "type": "integer" }, "error": { "$ref": "#/components/schemas/SessionStructuredToolError" }, "kind": { "const": "fetch", "type": "string" }, "num_lines": { "format": "int64", "type": "integer" }, "status_code": { "format": "int64", "type": "integer" }, "status_text": { "type": "string" }, "text": { "type": "string" }, "url": { "type": "string" } }, "required": [ "kind" ], "title": "SessionStructuredToolResultFetch", "type": "object" }, "SessionStructuredToolResultGlob": { "additionalProperties": false, "properties": { "content": { "type": "string" }, "duration_ms": { "format": "int64", "type": "integer" }, "error": { "$ref": "#/components/schemas/SessionStructuredToolError" }, "filenames": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "kind": { "const": "glob", "type": "string" }, "num_files": { "format": "int64", "type": "integer" }, "num_lines": { "format": "int64", "type": "integer" }, "truncated": { "type": "boolean" } }, "required": [ "kind" ], "title": "SessionStructuredToolResultGlob", "type": "object" }, "SessionStructuredToolResultGrep": { "additionalProperties": false, "properties": { "applied_limit": { "format": "int64", "type": "integer" }, "content": { "type": "string" }, "counts": { "items": { "$ref": "#/components/schemas/SessionStructuredArgument" }, "type": [ "array", "null" ] }, "duration_ms": { "format": "int64", "type": "integer" }, "error": { "$ref": "#/components/schemas/SessionStructuredToolError" }, "filenames": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "kind": { "const": "grep", "type": "string" }, "mode": { "type": "string" }, "num_files": { "format": "int64", "type": "integer" }, "num_lines": { "format": "int64", "type": "integer" }, "num_results": { "format": "int64", "type": "integer" }, "query": { "type": "string" }, "result_items": { "items": { "$ref": "#/components/schemas/SessionStructuredSearchResultItem" }, "type": [ "array", "null" ] } }, "required": [ "kind" ], "title": "SessionStructuredToolResultGrep", "type": "object" }, "SessionStructuredToolResultPlan": { "additionalProperties": false, "properties": { "content": { "type": "string" }, "error": { "$ref": "#/components/schemas/SessionStructuredToolError" }, "explanation": { "type": "string" }, "kind": { "const": "plan", "type": "string" }, "plan": { "type": "string" }, "steps": { "items": { "$ref": "#/components/schemas/SessionStructuredPlanStep" }, "type": [ "array", "null" ] }, "text": { "type": "string" } }, "required": [ "kind" ], "title": "SessionStructuredToolResultPlan", "type": "object" }, "SessionStructuredToolResultPython": { "additionalProperties": false, "properties": { "code": { "type": "string" }, "error": { "$ref": "#/components/schemas/SessionStructuredToolError" }, "exit_code": { "format": "int64", "type": "integer" }, "interrupted": { "type": "boolean" }, "is_image": { "type": "boolean" }, "kind": { "const": "python", "type": "string" }, "stderr": { "type": "string" }, "stdout": { "type": "string" }, "text": { "type": "string" }, "truncated": { "type": "boolean" } }, "required": [ "kind" ], "title": "SessionStructuredToolResultPython", "type": "object" }, "SessionStructuredToolResultQuestion": { "additionalProperties": false, "properties": { "answer": { "type": "string" }, "answers": { "items": { "$ref": "#/components/schemas/SessionStructuredArgument" }, "type": [ "array", "null" ] }, "content": { "type": "string" }, "error": { "$ref": "#/components/schemas/SessionStructuredToolError" }, "kind": { "const": "question", "type": "string" }, "options": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "question": { "type": "string" }, "questions": { "items": { "$ref": "#/components/schemas/SessionStructuredQuestion" }, "type": [ "array", "null" ] }, "text": { "type": "string" } }, "required": [ "kind" ], "title": "SessionStructuredToolResultQuestion", "type": "object" }, "SessionStructuredToolResultRead": { "additionalProperties": false, "properties": { "content": { "type": "string" }, "error": { "$ref": "#/components/schemas/SessionStructuredToolError" }, "file_path": { "type": "string" }, "kind": { "const": "read", "type": "string" }, "language": { "type": "string" }, "num_lines": { "format": "int64", "type": "integer" }, "start_line": { "format": "int64", "type": "integer" }, "total_lines": { "format": "int64", "type": "integer" } }, "required": [ "kind" ], "title": "SessionStructuredToolResultRead", "type": "object" }, "SessionStructuredToolResultSearch": { "additionalProperties": false, "properties": { "applied_limit": { "format": "int64", "type": "integer" }, "content": { "type": "string" }, "counts": { "items": { "$ref": "#/components/schemas/SessionStructuredArgument" }, "type": [ "array", "null" ] }, "duration_ms": { "format": "int64", "type": "integer" }, "error": { "$ref": "#/components/schemas/SessionStructuredToolError" }, "filenames": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "kind": { "const": "search", "type": "string" }, "mode": { "type": "string" }, "num_files": { "format": "int64", "type": "integer" }, "num_lines": { "format": "int64", "type": "integer" }, "num_results": { "format": "int64", "type": "integer" }, "query": { "type": "string" }, "result_items": { "items": { "$ref": "#/components/schemas/SessionStructuredSearchResultItem" }, "type": [ "array", "null" ] } }, "required": [ "kind" ], "title": "SessionStructuredToolResultSearch", "type": "object" }, "SessionStructuredToolResultStdin": { "additionalProperties": false, "properties": { "content": { "type": "string" }, "error": { "$ref": "#/components/schemas/SessionStructuredToolError" }, "kind": { "const": "stdin", "type": "string" }, "num_lines": { "format": "int64", "type": "integer" }, "task_id": { "type": "string" }, "text": { "type": "string" } }, "required": [ "kind" ], "title": "SessionStructuredToolResultStdin", "type": "object" }, "SessionStructuredToolResultTask": { "additionalProperties": false, "properties": { "content": { "type": "string" }, "description": { "type": "string" }, "error": { "$ref": "#/components/schemas/SessionStructuredToolError" }, "exit_code": { "format": "int64", "type": "integer" }, "kind": { "const": "task", "type": "string" }, "output": { "type": "string" }, "stderr": { "type": "string" }, "stdout": { "type": "string" }, "task_id": { "type": "string" }, "task_status": { "type": "string" }, "task_type": { "type": "string" }, "text": { "type": "string" }, "total_duration_ms": { "format": "int64", "type": "integer" }, "total_tokens": { "format": "int64", "type": "integer" }, "total_tool_use_count": { "format": "int64", "type": "integer" } }, "required": [ "kind" ], "title": "SessionStructuredToolResultTask", "type": "object" }, "SessionStructuredToolResultText": { "additionalProperties": false, "properties": { "content": { "type": "string" }, "error": { "$ref": "#/components/schemas/SessionStructuredToolError" }, "kind": { "const": "text", "type": "string" }, "text": { "type": "string" } }, "required": [ "kind" ], "title": "SessionStructuredToolResultText", "type": "object" }, "SessionStructuredToolResultTodo": { "additionalProperties": false, "properties": { "content": { "type": "string" }, "error": { "$ref": "#/components/schemas/SessionStructuredToolError" }, "kind": { "const": "todo", "type": "string" }, "new_todos": { "items": { "$ref": "#/components/schemas/SessionStructuredTodoItem" }, "type": [ "array", "null" ] }, "old_todos": { "items": { "$ref": "#/components/schemas/SessionStructuredTodoItem" }, "type": [ "array", "null" ] }, "text": { "type": "string" } }, "required": [ "kind" ], "title": "SessionStructuredToolResultTodo", "type": "object" }, "SessionStructuredToolResultUnknown": { "additionalProperties": false, "properties": { "answer": { "type": "string" }, "answers": { "items": { "$ref": "#/components/schemas/SessionStructuredArgument" }, "type": [ "array", "null" ] }, "applied_limit": { "format": "int64", "type": "integer" }, "bytes": { "format": "int64", "type": "integer" }, "code": { "type": "string" }, "command": { "type": "string" }, "content": { "type": "string" }, "counts": { "items": { "$ref": "#/components/schemas/SessionStructuredArgument" }, "type": [ "array", "null" ] }, "description": { "type": "string" }, "duration_ms": { "format": "int64", "type": "integer" }, "error": { "$ref": "#/components/schemas/SessionStructuredToolError" }, "exit_code": { "format": "int64", "type": "integer" }, "explanation": { "type": "string" }, "file_path": { "type": "string" }, "file_paths": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "filenames": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "interrupted": { "type": "boolean" }, "is_image": { "type": "boolean" }, "kind": { "const": "unknown", "type": "string" }, "language": { "type": "string" }, "mode": { "type": "string" }, "new_string": { "type": "string" }, "new_todos": { "items": { "$ref": "#/components/schemas/SessionStructuredTodoItem" }, "type": [ "array", "null" ] }, "num_files": { "format": "int64", "type": "integer" }, "num_lines": { "format": "int64", "type": "integer" }, "num_results": { "format": "int64", "type": "integer" }, "old_string": { "type": "string" }, "old_todos": { "items": { "$ref": "#/components/schemas/SessionStructuredTodoItem" }, "type": [ "array", "null" ] }, "options": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "original_file": { "type": "string" }, "output": { "type": "string" }, "patch": { "type": "string" }, "patch_hunks": { "items": { "$ref": "#/components/schemas/SessionStructuredPatchHunk" }, "type": [ "array", "null" ] }, "plan": { "type": "string" }, "query": { "type": "string" }, "question": { "type": "string" }, "questions": { "items": { "$ref": "#/components/schemas/SessionStructuredQuestion" }, "type": [ "array", "null" ] }, "replace_all": { "type": "boolean" }, "result_items": { "items": { "$ref": "#/components/schemas/SessionStructuredSearchResultItem" }, "type": [ "array", "null" ] }, "start_line": { "format": "int64", "type": "integer" }, "status_code": { "format": "int64", "type": "integer" }, "status_text": { "type": "string" }, "stderr": { "type": "string" }, "stderr_lines": { "format": "int64", "type": "integer" }, "stdout": { "type": "string" }, "stdout_lines": { "format": "int64", "type": "integer" }, "steps": { "items": { "$ref": "#/components/schemas/SessionStructuredPlanStep" }, "type": [ "array", "null" ] }, "task_id": { "type": "string" }, "task_status": { "type": "string" }, "task_type": { "type": "string" }, "text": { "type": "string" }, "timestamp": { "type": "string" }, "total_duration_ms": { "format": "int64", "type": "integer" }, "total_lines": { "format": "int64", "type": "integer" }, "total_tokens": { "format": "int64", "type": "integer" }, "total_tool_use_count": { "format": "int64", "type": "integer" }, "truncated": { "type": "boolean" }, "url": { "type": "string" }, "user_modified": { "type": "boolean" } }, "required": [ "kind" ], "title": "SessionStructuredToolResultUnknown", "type": "object" }, "SessionStructuredToolResultWrite": { "additionalProperties": false, "properties": { "content": { "type": "string" }, "error": { "$ref": "#/components/schemas/SessionStructuredToolError" }, "file_path": { "type": "string" }, "file_paths": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "kind": { "const": "write", "type": "string" }, "language": { "type": "string" }, "num_lines": { "format": "int64", "type": "integer" }, "patch": { "type": "string" }, "patch_hunks": { "items": { "$ref": "#/components/schemas/SessionStructuredPatchHunk" }, "type": [ "array", "null" ] }, "start_line": { "format": "int64", "type": "integer" }, "text": { "type": "string" }, "total_lines": { "format": "int64", "type": "integer" } }, "required": [ "kind" ], "title": "SessionStructuredToolResultWrite", "type": "object" }, "SessionStructuredUploadedFile": { "additionalProperties": false, "properties": { "file_path": { "type": "string" }, "mime_type": { "type": "string" }, "original_name": { "type": "string" }, "preview_url": { "type": "string" }, "size": { "type": "string" } }, "type": "object" }, "SessionStructuredUsage": { "additionalProperties": false, "properties": { "cache_creation_tokens": { "format": "int64", "type": "integer" }, "cache_read_tokens": { "format": "int64", "type": "integer" }, "context_percent": { "format": "int64", "type": "integer" }, "context_used_tokens": { "format": "int64", "type": "integer" }, "context_window_tokens": { "format": "int64", "type": "integer" }, "input_tokens": { "format": "int64", "type": "integer" }, "output_tokens": { "format": "int64", "type": "integer" }, "reasoning_tokens": { "format": "int64", "type": "integer" } }, "type": "object" }, "SessionStructuredUserPrompt": { "additionalProperties": false, "properties": { "opened_files": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "selections": { "items": { "$ref": "#/components/schemas/SessionStructuredIDESelection" }, "type": [ "array", "null" ] }, "text": { "type": "string" }, "uploaded_files": { "items": { "$ref": "#/components/schemas/SessionStructuredUploadedFile" }, "type": [ "array", "null" ] } }, "type": "object" }, "SessionSubmitInputBody": { "additionalProperties": false, "properties": { "intent": { "$ref": "#/components/schemas/SubmitIntent", "description": "Submit intent; empty defaults to \"default\".", "enum": [ "default", "follow_up", "interrupt_now" ] }, "message": { "description": "Message text to submit.", "minLength": 1, "pattern": "\\S", "type": "string" }, "resume": { "description": "Start or resume the session here if it is not running (an operator's own message; it consumes an operator's hold). Without it, a message to a session that is not running is queued for its next run (expiring after 24h) and the controller is asked to start it; the result's will_start says whether it will.", "type": "boolean" } }, "required": [ "message" ], "type": "object" }, "SessionSubmitSucceededPayload": { "additionalProperties": false, "properties": { "intent": { "description": "Resolved submit intent (default, follow_up, interrupt_now).", "type": "string" }, "queued": { "description": "Whether the message was queued for later delivery.", "type": "boolean" }, "request_id": { "description": "Correlation ID from the 202 response.", "type": "string" }, "session_id": { "description": "Session ID that received the submission.", "type": "string" }, "will_not_start_reason": { "description": "Why the controller will not start the session for a queued message, with the remedy.", "type": "string" }, "will_start": { "description": "Present when the message was queued because the session is not running: whether the controller will start it to deliver the message. False means it will not (see will_not_start_reason); resend with resume: true to start it now.", "type": "boolean" } }, "required": [ "request_id", "session_id", "queued", "intent" ], "type": "object" }, "SessionTranscriptConversationResponse": { "additionalProperties": false, "properties": { "format": { "description": "Conversation or text transcript format.", "enum": [ "conversation", "text" ], "type": "string" }, "id": { "type": "string" }, "pagination": { "$ref": "#/components/schemas/PaginationInfo" }, "provider": { "description": "Producing provider identifier (claude, codex, gemini, opencode, etc.).", "type": "string" }, "template": { "type": "string" }, "turns": { "description": "Conversation/text transcript turns.", "items": { "$ref": "#/components/schemas/OutputTurn" }, "type": [ "array", "null" ] } }, "required": [ "id", "template", "provider", "format" ], "type": "object" }, "SessionTranscriptGetResponse": { "description": "Discriminated union of session transcript response shapes. Raw provider-native frames are available only on the raw branch; structured responses contain only provider-neutral typed data.", "discriminator": { "mapping": { "conversation": "#/components/schemas/SessionTranscriptConversationResponse", "raw": "#/components/schemas/SessionTranscriptRawResponse", "structured": "#/components/schemas/SessionTranscriptStructuredResponse", "text": "#/components/schemas/SessionTranscriptConversationResponse" }, "propertyName": "format" }, "oneOf": [ { "$ref": "#/components/schemas/SessionTranscriptConversationResponse" }, { "$ref": "#/components/schemas/SessionTranscriptRawResponse" }, { "$ref": "#/components/schemas/SessionTranscriptStructuredResponse" } ], "title": "Session transcript response" }, "SessionTranscriptRawResponse": { "additionalProperties": false, "properties": { "format": { "description": "Raw provider-native transcript format.", "enum": [ "raw" ], "type": "string" }, "id": { "type": "string" }, "messages": { "description": "Provider-native transcript frames emitted only for raw format.", "items": { "$ref": "#/components/schemas/SessionRawMessageFrame" }, "type": [ "array", "null" ] }, "pagination": { "$ref": "#/components/schemas/PaginationInfo" }, "provider": { "description": "Producing provider identifier (claude, codex, gemini, opencode, etc.). Consumers use this to dispatch per-provider frame parsing.", "type": "string" }, "template": { "type": "string" } }, "required": [ "id", "template", "provider", "format", "messages" ], "type": "object" }, "SessionTranscriptStructuredResponse": { "additionalProperties": false, "description": "Provider-neutral structured transcript snapshot.", "properties": { "format": { "const": "structured", "description": "Structured provider-neutral transcript format.", "type": "string" }, "history": { "$ref": "#/components/schemas/SessionStructuredHistory", "description": "Normalized worker-history envelope when format is structured." }, "id": { "type": "string" }, "operation": { "const": "snapshot", "description": "Always snapshot for a REST structured transcript.", "type": "string" }, "pagination": { "$ref": "#/components/schemas/PaginationInfo" }, "provider": { "description": "Producing provider identifier (claude, codex, gemini, opencode, etc.).", "type": "string" }, "schema_version": { "const": "session.structured.v1", "description": "Structured session transcript schema version.", "type": "string" }, "structured_messages": { "description": "Provider-normalized structured messages.", "items": { "$ref": "#/components/schemas/SessionStructuredMessage" }, "type": "array" }, "template": { "type": "string" } }, "required": [ "id", "template", "provider", "format", "schema_version", "operation", "history", "structured_messages" ], "title": "Structured session transcript response", "type": "object" }, "SessionUnknownStatePayload": { "additionalProperties": false, "properties": { "escalated": { "description": "False on the first-sight emission; true when re-emitted after the bead has sat unrecognized past the escalation threshold.", "type": "boolean" }, "first_seen": { "description": "RFC3339 timestamp the reconciler first observed this unrecognized state; the escalation clock counts from here.", "type": "string" }, "session_id": { "description": "Canonical session bead ID for the unrecognized-state session (also the envelope Subject).", "type": "string" }, "session_name": { "description": "Runtime session name from the session bead metadata, when set.", "type": "string" }, "state": { "description": "The raw, unrecognized metadata state value the reconciler skipped.", "type": "string" } }, "required": [ "session_id", "state", "escalated" ], "type": "object" }, "SessionWakeRefusedPayload": { "additionalProperties": false, "properties": { "attempts": { "description": "wake_attempts recorded after this refusal.", "format": "int64", "type": "integer" }, "reason": { "description": "Refusal reason: held, quarantined, or idle-sleep.", "type": "string" }, "session_id": { "description": "Session bead ID.", "type": "string" }, "session_name": { "description": "Session display name, if known.", "type": "string" }, "template": { "description": "Resolved session template.", "type": "string" }, "wake_request": { "description": "The wake_request metadata value that triggered this check (explicit).", "type": "string" } }, "required": [ "session_id", "reason", "wake_request", "attempts" ], "type": "object" }, "SlingBatchSummary": { "additionalProperties": false, "properties": { "container_type": { "description": "Container bead type, e.g. convoy.", "type": "string" }, "failed": { "description": "Children whose routing failed.", "format": "int64", "type": "integer" }, "idempotent": { "description": "Children skipped because they were already routed to the target.", "format": "int64", "type": "integer" }, "routed": { "description": "Children routed by this sling.", "format": "int64", "type": "integer" }, "skipped": { "description": "Children skipped: already routed, or not open.", "format": "int64", "type": "integer" }, "total": { "description": "Children tracked by the container.", "format": "int64", "type": "integer" } }, "required": [ "total", "routed", "failed", "skipped", "idempotent" ], "type": "object" }, "SlingInputBody": { "additionalProperties": false, "properties": { "attached_bead_id": { "description": "Bead or convoy ID to attach formula to, in place of bead (gc sling --on).", "type": "string" }, "bead": { "description": "Bead or convoy ID to sling, like gc sling \u003ctarget\u003e \u003cbead\u003e. The target's default formula is cooked onto the bead unless no_formula is set; a convoy's open children are routed one by one.", "type": "string" }, "force": { "description": "Bypass cross-rig guards; for direct bead routes, also bypass missing-bead validation. Formula-backed graph routes may replace existing live workflow roots but still require the source bead to exist.", "type": "boolean" }, "formula": { "description": "Formula name. Alone, it launches the formula standalone (gc sling --formula). With attached_bead_id, it is attached to that bead (gc sling \u003ctarget\u003e \u003cbead\u003e --on \u003cformula\u003e).", "type": "string" }, "merge": { "description": "Merge strategy: direct, mr, or local.", "type": "string" }, "no_convoy": { "description": "Do not create an auto-convoy for the routed bead.", "type": "boolean" }, "no_formula": { "description": "Suppress the target's default_sling_formula and route the raw bead (gc sling --no-formula).", "type": "boolean" }, "owned": { "description": "Mark the routed bead as owned by the target.", "type": "boolean" }, "reassign": { "description": "Clear any existing human assignee on the bead before routing, so a bead claimed via bd update --claim is handed to the target's pool.", "type": "boolean" }, "rig": { "description": "Rig name.", "type": "string" }, "scope_kind": { "description": "Scope kind (city or rig).", "type": "string" }, "scope_ref": { "description": "Scope reference.", "type": "string" }, "target": { "description": "Target agent or pool.", "minLength": 1, "type": "string" }, "title": { "description": "Workflow title (gc sling --title), for an explicit or default formula.", "type": "string" }, "vars": { "additionalProperties": { "type": "string" }, "description": "Formula variables (gc sling --var), for an explicit or default formula.", "type": "object" } }, "required": [ "target" ], "type": "object" }, "SlingResponse": { "additionalProperties": false, "properties": { "attached_bead_id": { "type": "string" }, "batch": { "$ref": "#/components/schemas/SlingBatchSummary", "description": "Per-child outcome counts, present only when the bead was a convoy whose open children were routed one by one (as gc sling does). Matches gc sling --json batch." }, "bead": { "type": "string" }, "convoy_id": { "description": "Auto-convoy tracking the routed bead, when one was created or reused. Matches gc sling --json convoy_id.", "type": "string" }, "dashboard_url": { "description": "Absolute dashboard deep link for the slung work: the run detail view when a graph workflow was launched, otherwise the runs list. Present only when the serving process also hosts the dashboard (the supervisor listener); the standalone controller API omits it.", "type": "string" }, "formula": { "type": "string" }, "mode": { "type": "string" }, "molecule_id": { "description": "Root of the formula wisp attached to the bead, when a non-graph (v1) formula was attached. Matches gc sling --json molecule_id.", "type": "string" }, "root_bead_id": { "type": "string" }, "run": { "$ref": "#/components/schemas/RunRef", "description": "Reference to the launched run resource, present only when a graph workflow was launched (the same run the Location header addresses)." }, "status": { "type": "string" }, "target": { "type": "string" }, "warnings": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "workflow_id": { "type": "string" } }, "required": [ "status", "target" ], "type": "object" }, "Status": { "additionalProperties": false, "properties": { "allow_websockets": { "type": "boolean" }, "hostname": { "type": "string" }, "kind": { "type": "string" }, "local_state": { "type": "string" }, "mount_path": { "type": "string" }, "publication_state": { "type": "string" }, "publish_mode": { "type": "string" }, "reason": { "type": "string" }, "service_name": { "type": "string" }, "state": { "type": "string" }, "state_root": { "type": "string" }, "updated_at": { "format": "date-time", "type": "string" }, "url": { "type": "string" }, "visibility": { "type": "string" }, "workflow_contract": { "type": "string" } }, "required": [ "service_name", "mount_path", "publish_mode", "state_root", "local_state", "publication_state", "updated_at" ], "type": "object" }, "StatusAgentCounts": { "additionalProperties": false, "properties": { "quarantined": { "description": "Number of quarantined agents.", "format": "int64", "type": "integer" }, "running": { "description": "Number of running agents.", "format": "int64", "type": "integer" }, "suspended": { "description": "Number of suspended agents.", "format": "int64", "type": "integer" }, "total": { "description": "Total number of agents.", "format": "int64", "type": "integer" } }, "required": [ "total", "running", "suspended", "quarantined" ], "type": "object" }, "StatusAgentDetail": { "additionalProperties": false, "properties": { "draining": { "description": "True when the pool is draining this instance.", "type": "boolean" }, "expanded": { "description": "True when this row is a pool-expanded instance (renderer indents differently).", "type": "boolean" }, "group_name": { "description": "Pool group label for expanded rows; same as QualifiedName for singletons.", "type": "string" }, "name": { "description": "Unqualified agent name (for pool instances, the per-instance short name like 'polecat-1').", "type": "string" }, "qualified_name": { "description": "Rig-qualified name when applicable, else the bare agent name.", "type": "string" }, "running": { "description": "Observed running state of the agent's session.", "type": "boolean" }, "scale_label": { "description": "'scaled (min=N, max=M)' header emitted once per pool group.", "type": "string" }, "scope": { "description": "city or rig.", "type": "string" }, "session_name": { "description": "tmux session name CLI drain-ops key on.", "type": "string" }, "suspended": { "description": "Whether the agent (or its rig) is suspended.", "type": "boolean" } }, "required": [ "name", "qualified_name", "scope", "running", "suspended" ], "type": "object" }, "StatusBody": { "additionalProperties": false, "properties": { "agent_count": { "description": "Total agent count (deprecated, use agents.total).", "format": "int64", "type": "integer" }, "agent_details": { "description": "Per-agent state (for CLI status views). Empty when none.", "items": { "$ref": "#/components/schemas/StatusAgentDetail" }, "type": [ "array", "null" ] }, "agents": { "$ref": "#/components/schemas/StatusAgentCounts", "description": "Agent state counts." }, "beads": { "$ref": "#/components/schemas/BeadsDiagnostic", "description": "Bead store selection diagnostic. Omitted when unavailable." }, "beads_version": { "description": "Version of the bd (beads) CLI the supervisor drives. Omitted when the probe failed or the binary is unavailable.", "type": "string" }, "conditional_writes": { "$ref": "#/components/schemas/StatusConditionalWrites", "description": "Conditional-writes (CAS) rollout state: the daemon's boot-latched mode plus per-store capability verdicts. Omitted when the server predates the surface." }, "dolt_version": { "description": "Version of the dolt engine binary the supervisor drives. Omitted when the probe failed or the binary is unavailable.", "type": "string" }, "mail": { "$ref": "#/components/schemas/StatusMailCounts", "description": "Mail counts." }, "name": { "description": "City name.", "type": "string" }, "named_session_details": { "description": "Per-named-session detail. Empty when none configured.", "items": { "$ref": "#/components/schemas/StatusNamedSessionDetail" }, "type": [ "array", "null" ] }, "partial": { "description": "True when one or more status backing reads returned incomplete data.", "type": "boolean" }, "partial_errors": { "description": "Human-readable errors from incomplete status backing reads.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "path": { "description": "City directory path.", "type": "string" }, "rig_count": { "description": "Total rig count (deprecated, use rigs.total).", "format": "int64", "type": "integer" }, "rig_details": { "description": "Per-rig detail (for CLI status views). Empty when none.", "items": { "$ref": "#/components/schemas/StatusRigDetail" }, "type": [ "array", "null" ] }, "rigs": { "$ref": "#/components/schemas/StatusRigCounts", "description": "Rig state counts." }, "running": { "description": "Number of running agent processes.", "format": "int64", "type": "integer" }, "session_counts_detail": { "$ref": "#/components/schemas/StatusSessionCountsDetail", "description": "Active/suspended session counts. Omitted when unavailable." }, "store_health": { "$ref": "#/components/schemas/StatusStoreHealth", "description": "Dolt bead store health summary. Omitted when unavailable." }, "stores_not_read": { "description": "True when the city is suspended: the body was built without reading any bead store (a read would restart its retired bd proxy), so work, mail, session-count and store-health figures are absent.", "type": "boolean" }, "suspended": { "description": "Whether the city is suspended.", "type": "boolean" }, "uptime_sec": { "description": "Server uptime in seconds.", "format": "int64", "type": "integer" }, "version": { "description": "Server version.", "type": "string" }, "work": { "$ref": "#/components/schemas/StatusWorkCounts", "description": "Work item counts." } }, "required": [ "name", "path", "uptime_sec", "suspended", "agent_count", "rig_count", "running", "agents", "rigs", "work", "mail" ], "type": "object" }, "StatusConditionalWriteStoreVerdict": { "additionalProperties": false, "properties": { "capable": { "description": "What the write path uses today: false only on a definitive incapable verdict.", "type": "boolean" }, "kind": { "description": "Store kind in the degraded-event wire vocabulary (bd, native, caching, mem, file).", "type": "string" }, "latch": { "description": "Runtime unsupported latch: incapable after the store rejected a real fenced write; cleared only by restart.", "enum": [ "incapable", "unlatched" ], "type": "string" }, "probe": { "description": "Memoized capability-probe verdict. unprobed means no fenced write has exercised this store yet.", "enum": [ "capable", "incapable", "unprobed" ], "type": "string" }, "reason": { "description": "Incapable cause, verbatim from the probe or latch.", "type": "string" }, "store_id": { "description": "Store scope: city, or rig/\u003cname\u003e.", "type": "string" } }, "required": [ "store_id", "kind", "probe", "latch", "capable" ], "type": "object" }, "StatusConditionalWrites": { "additionalProperties": false, "properties": { "effective": { "description": "Aggregate verdict: off (gate off), active (every store capable), degraded (auto with at least one incapable store), fail_closed (require with at least one incapable store — fenced writes on it refuse), pending_restart (on-disk config drifted from the latched mode).", "enum": [ "off", "active", "degraded", "fail_closed", "pending_restart" ], "type": "string" }, "mode": { "description": "Boot-latched beads.conditional_writes mode.", "enum": [ "off", "auto", "require" ], "type": "string" }, "notices": { "description": "Retained rollout notices (env overrides, drift, invalid spellings).", "items": { "$ref": "#/components/schemas/StatusRolloutNotice" }, "type": [ "array", "null" ] }, "origin": { "description": "Where the latched mode came from.", "enum": [ "builtin", "config", "env" ], "type": "string" }, "stores": { "description": "Per-store verdicts, one row per controller-owned store.", "items": { "$ref": "#/components/schemas/StatusConditionalWriteStoreVerdict" }, "type": [ "array", "null" ] } }, "required": [ "mode", "origin", "effective" ], "type": "object" }, "StatusMailCounts": { "additionalProperties": false, "properties": { "total": { "description": "Total number of messages.", "format": "int64", "type": "integer" }, "unread": { "description": "Number of unread messages.", "format": "int64", "type": "integer" } }, "required": [ "unread", "total" ], "type": "object" }, "StatusNamedSessionDetail": { "additionalProperties": false, "properties": { "identity": { "description": "Qualified named-session identity.", "type": "string" }, "mode": { "description": "Named-session mode (on-demand, always, etc.).", "type": "string" }, "status": { "description": "Lifecycle status string (materialized, reserved-unmaterialized, etc.).", "type": "string" } }, "required": [ "identity", "status", "mode" ], "type": "object" }, "StatusRigCounts": { "additionalProperties": false, "properties": { "suspended": { "description": "Number of suspended rigs.", "format": "int64", "type": "integer" }, "total": { "description": "Total number of rigs.", "format": "int64", "type": "integer" } }, "required": [ "total", "suspended" ], "type": "object" }, "StatusRigDetail": { "additionalProperties": false, "properties": { "name": { "description": "Rig name.", "type": "string" }, "path": { "description": "Rig directory path.", "type": "string" }, "suspended": { "description": "Whether the rig is suspended (either explicitly or because all its agents are suspended).", "type": "boolean" } }, "required": [ "name", "path", "suspended" ], "type": "object" }, "StatusRolloutNotice": { "additionalProperties": false, "properties": { "config_value": { "description": "Raw config spelling; empty when unset.", "type": "string" }, "env_value": { "description": "Raw env spelling as found.", "type": "string" }, "env_var": { "description": "Environment variable involved, when env-related.", "type": "string" }, "flag_key": { "description": "Rollout gate key the notice is about.", "type": "string" }, "kind": { "description": "Notice kind (env_overrides_config, pending_restart, invalid_value, ...).", "type": "string" }, "message": { "description": "Human-readable line carrying the gate and the outcome.", "type": "string" } }, "required": [ "kind", "flag_key", "message" ], "type": "object" }, "StatusSessionCountsDetail": { "additionalProperties": false, "properties": { "active": { "description": "Number of active sessions.", "format": "int64", "type": "integer" }, "suspended": { "description": "Number of suspended sessions.", "format": "int64", "type": "integer" } }, "required": [ "active", "suspended" ], "type": "object" }, "StatusStoreHealth": { "additionalProperties": false, "properties": { "last_gc_at": { "description": "RFC3339 timestamp of last maintenance run.", "type": "string" }, "last_gc_status": { "description": "Status of last maintenance run ('success' or 'failed').", "type": "string" }, "live_rows": { "description": "Retained bead row count used as the denominator, including open and closed beads. Meaningless unless rows_measured is true.", "format": "int64", "type": "integer" }, "path": { "description": "On-disk path of the Dolt store.", "type": "string" }, "ratio_mb_per_row": { "description": "Derived megabytes per retained row, including open and closed beads. Zero and meaningless unless rows_measured is true.", "format": "double", "type": "number" }, "rows_measured": { "description": "True when live_rows is a real count. False means the count failed, timed out, or was never taken, and both live_rows and ratio_mb_per_row are meaningless.", "type": "boolean" }, "size_bytes": { "description": "Total bytes of the store directory.", "format": "int64", "type": "integer" }, "threshold_mb_per_row": { "description": "Ratio threshold; a ratio above this trips warning.", "format": "double", "type": "number" }, "warning": { "description": "True when maintenance is overdue. Meaningless unless rows_measured is true.", "type": "boolean" } }, "required": [ "path", "size_bytes", "live_rows", "rows_measured", "ratio_mb_per_row", "warning", "threshold_mb_per_row" ], "type": "object" }, "StatusWorkCounts": { "additionalProperties": false, "properties": { "in_progress": { "description": "Number of in-progress work items.", "format": "int64", "type": "integer" }, "open": { "description": "Number of open work items.", "format": "int64", "type": "integer" }, "ready": { "description": "Number of ready work items.", "format": "int64", "type": "integer" }, "suspended_rigs_excluded": { "description": "Number of suspended rigs left out of these counts: a suspended rig's store is not read.", "format": "int64", "type": "integer" } }, "required": [ "in_progress", "ready", "open" ], "type": "object" }, "StorageBindingOutcomePayload": { "additionalProperties": false, "properties": { "binding": { "type": "string" }, "database": { "type": "string" }, "invariant": { "type": "string" }, "lost_cross_edges": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "outcome": { "type": "string" }, "proven_beads": { "format": "int64", "type": "integer" } }, "required": [ "binding", "database", "outcome", "proven_beads", "invariant" ], "type": "object" }, "StoreDiskCriticalPayload": { "additionalProperties": false, "properties": { "data_dir": { "type": "string" }, "floor_bytes": { "format": "int64", "type": "integer" }, "free_bytes": { "format": "int64", "type": "integer" } }, "required": [ "free_bytes", "floor_bytes", "data_dir" ], "type": "object" }, "StoreDiskWarnPayload": { "additionalProperties": false, "properties": { "data_dir": { "type": "string" }, "floor_bytes": { "format": "int64", "type": "integer" }, "free_bytes": { "format": "int64", "type": "integer" }, "warn_bytes": { "format": "int64", "type": "integer" } }, "required": [ "free_bytes", "warn_bytes", "floor_bytes", "data_dir" ], "type": "object" }, "StoreMaintenanceDonePayload": { "additionalProperties": false, "properties": { "after_bytes": { "format": "int64", "type": "integer" }, "before_bytes": { "format": "int64", "type": "integer" }, "duration_s": { "format": "double", "type": "number" }, "snapshot_path": { "type": "string" } }, "required": [ "duration_s", "before_bytes", "after_bytes", "snapshot_path" ], "type": "object" }, "StoreMaintenanceFailedPayload": { "additionalProperties": false, "properties": { "duration_s": { "format": "double", "type": "number" }, "error_msg": { "type": "string" }, "snapshot_path": { "type": "string" }, "stage": { "type": "string" } }, "required": [ "stage", "error_msg", "duration_s" ], "type": "object" }, "SubmissionCapabilities": { "additionalProperties": false, "properties": { "supports_follow_up": { "type": "boolean" }, "supports_interrupt_now": { "type": "boolean" } }, "required": [ "supports_follow_up", "supports_interrupt_now" ], "type": "object" }, "SubmitIntent": { "description": "Semantic delivery choice for a user message on a session submit request.", "enum": [ "default", "follow_up", "interrupt_now" ], "type": "string" }, "SupervisorCitiesOutputBody": { "additionalProperties": false, "properties": { "items": { "description": "Managed cities with status info.", "items": { "$ref": "#/components/schemas/CityInfo" }, "type": [ "array", "null" ] }, "total": { "description": "Total count.", "format": "int64", "type": "integer" } }, "required": [ "items", "total" ], "type": "object" }, "SupervisorEventListOutputBody": { "additionalProperties": false, "properties": { "event_cursor": { "description": "Supervisor event-stream cursor captured before the history snapshot was listed. Pass this value as after_cursor to /v0/events/stream to receive events emitted after the snapshot boundary. A populated cursor resumes each city at its exact per-city position, so no unrelated historical backlog is replayed. The value 0 is returned only when no event provider is registered at capture time; passing 0 back requests a replay from zero for every provider present at resume time.", "type": "string" }, "items": { "items": { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelope" }, "type": [ "array", "null" ] }, "total": { "format": "int64", "type": "integer" } }, "required": [ "event_cursor", "items", "total" ], "type": "object" }, "SupervisorFSPressureSkippedTickPayload": { "additionalProperties": false, "properties": { "avg60": { "description": "The Linux PSI some avg60 value observed for filesystem IO pressure.", "format": "double", "type": "number" }, "consecutive_skips": { "description": "Number of consecutive pressure skips including this tick.", "format": "int64", "type": "integer" }, "max_consecutive_skips": { "description": "Maximum consecutive skips before the supervisor forces one reconciliation tick.", "format": "int64", "type": "integer" }, "outcome": { "description": "The pressure decision outcome: skipped for a shed tick or forced for the bounded liveness tick.", "type": "string" }, "threshold": { "description": "The configured avg60 threshold that triggered the skip.", "format": "double", "type": "number" }, "trigger": { "description": "The daemon tick trigger, such as patrol or poke.", "type": "string" } }, "required": [ "avg60", "threshold", "consecutive_skips", "max_consecutive_skips", "outcome" ], "type": "object" }, "SupervisorHealthOutputBody": { "additionalProperties": false, "properties": { "build_id": { "description": "Build identity (typically a short git commit hash, with \"-dirty\" suffix when built from an unclean tree). Empty when unavailable.", "type": "string" }, "cities_running": { "description": "Cities currently running.", "format": "int64", "type": "integer" }, "cities_total": { "description": "Total managed cities.", "format": "int64", "type": "integer" }, "packs_lock_sha256": { "description": "SHA-256 hex digest of the first managed city's packs.lock contents, for single-city deployments (mirrors the startup field's first-city semantics). Drift checkers compare this against the committed lockfile copy. Omitted when no city is registered, the city has no packs.lock, or the lockfile is unreadable (read error logged server-side) — treat absence as unknown, not as proof there is no lockfile.", "type": "string" }, "startup": { "$ref": "#/components/schemas/SupervisorStartup", "description": "First-city startup info for single-city deployments." }, "status": { "description": "Health status (\"ok\").", "type": "string" }, "uptime_sec": { "description": "Supervisor uptime in seconds.", "format": "int64", "type": "integer" }, "version": { "description": "Supervisor version.", "type": "string" } }, "required": [ "status", "version", "uptime_sec", "cities_total", "cities_running" ], "type": "object" }, "SupervisorRequestPayload": { "additionalProperties": false, "properties": { "duration_ms": { "description": "Handler duration in milliseconds.", "format": "int64", "type": "integer" }, "host": { "description": "Canonical Host header without port.", "type": "string" }, "method": { "description": "HTTP method.", "type": "string" }, "origin_allowed": { "description": "Whether the Origin header, if present, matched CORS policy.", "type": "boolean" }, "path": { "description": "Request path with query string omitted and length bounded.", "type": "string" }, "phase": { "description": "Audit phase. Long-lived event streams emit a start record immediately after Host validation, then a complete record when the handler returns. Non-stream requests emit complete only.", "enum": [ "start", "complete" ], "type": "string" }, "remote_addr_class": { "description": "Network class of the remote address, not the raw address.", "enum": [ "loopback", "private", "public", "unknown" ], "type": "string" }, "request_id": { "description": "The server-minted X-GC-Request-Id echoed to the client, so a client can correlate a failed request with this audit record and the api: log line.", "type": "string" }, "status": { "description": "HTTP response status code. Start-phase records use 0 before the final response status is known.", "format": "int64", "type": "integer" } }, "required": [ "method", "path", "status", "duration_ms", "remote_addr_class", "origin_allowed", "phase" ], "type": "object" }, "SupervisorShutdownPayload": { "additionalProperties": false, "properties": { "client_addr": { "description": "For source=socket_stop, the address reported by the connecting client. Typically empty for unix-socket peers.", "type": "string" }, "mode": { "description": "Resulting shutdown mode.", "enum": [ "destructive", "preserve_sessions", "unknown" ], "type": "string" }, "signal": { "description": "For source=signal, the human-readable signal name (e.g. \"terminated\", \"interrupt\"). Empty for socket_stop.", "type": "string" }, "source": { "description": "Which path triggered the shutdown.", "enum": [ "signal", "socket_stop" ], "type": "string" } }, "required": [ "source", "mode" ], "type": "object" }, "SupervisorStartedPayload": { "additionalProperties": false, "properties": { "previous_exit": { "description": "How the previous supervisor instance exited: clean (it completed its STOPPING path and left the shutdown handoff token), crash (a prior instance ran but left no token), or unknown (no evidence of a prior instance).", "enum": [ "clean", "crash", "unknown" ], "type": "string" } }, "required": [ "previous_exit" ], "type": "object" }, "SupervisorStartup": { "additionalProperties": false, "properties": { "phase": { "description": "Current phase (when not ready).", "type": "string" }, "phases_completed": { "description": "Phases completed so far.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "ready": { "description": "True when the city is running.", "type": "boolean" } }, "required": [ "ready" ], "type": "object" }, "TaggedEventStreamEnvelope": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/EventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "city" ], "type": "object" }, "TranscriptMessageKind": { "description": "Direction of a transcript entry.", "enum": [ "inbound", "outbound" ], "type": "string" }, "TranscriptProvenance": { "description": "Provenance of a transcript entry (freshly observed vs. replayed from persisted history).", "enum": [ "live", "hydrated" ], "type": "string" }, "TypedEventStreamEnvelope": { "description": "Discriminated union of city event stream envelopes. Each variant constrains the envelope type and payload schema together.", "discriminator": { "mapping": { "backend.credential_resolved": "#/components/schemas/TypedEventStreamEnvelopeBackendCredentialResolved", "bead.claim_rejected": "#/components/schemas/TypedEventStreamEnvelopeBeadClaimRejected", "bead.claim_released": "#/components/schemas/TypedEventStreamEnvelopeBeadClaimReleased", "bead.closed": "#/components/schemas/TypedEventStreamEnvelopeBeadClosed", "bead.created": "#/components/schemas/TypedEventStreamEnvelopeBeadCreated", "bead.dead_assignee_reopened": "#/components/schemas/TypedEventStreamEnvelopeBeadDeadAssigneeReopened", "bead.deleted": "#/components/schemas/TypedEventStreamEnvelopeBeadDeleted", "bead.updated": "#/components/schemas/TypedEventStreamEnvelopeBeadUpdated", "bead.worktree.reap_skipped": "#/components/schemas/TypedEventStreamEnvelopeBeadWorktreeReapSkipped", "bead.worktree.reaped": "#/components/schemas/TypedEventStreamEnvelopeBeadWorktreeReaped", "beads.blocked.recomputed": "#/components/schemas/TypedEventStreamEnvelopeBeadsBlockedRecomputed", "beads.conditional_writes.degraded": "#/components/schemas/TypedEventStreamEnvelopeBeadsConditionalWritesDegraded", "city.created": "#/components/schemas/TypedEventStreamEnvelopeCityCreated", "city.resumed": "#/components/schemas/TypedEventStreamEnvelopeCityResumed", "city.suspended": "#/components/schemas/TypedEventStreamEnvelopeCitySuspended", "city.unregister_requested": "#/components/schemas/TypedEventStreamEnvelopeCityUnregisterRequested", "control.dispatcher_scope_gap": "#/components/schemas/TypedEventStreamEnvelopeControlDispatcherScopeGap", "control.root_settle_failed": "#/components/schemas/TypedEventStreamEnvelopeControlRootSettleFailed", "control.stalled": "#/components/schemas/TypedEventStreamEnvelopeControlStalled", "controller.started": "#/components/schemas/TypedEventStreamEnvelopeControllerStarted", "controller.stopped": "#/components/schemas/TypedEventStreamEnvelopeControllerStopped", "convoy.closed": "#/components/schemas/TypedEventStreamEnvelopeConvoyClosed", "convoy.created": "#/components/schemas/TypedEventStreamEnvelopeConvoyCreated", "emergency.acked": "#/components/schemas/TypedEventStreamEnvelopeEmergencyAcked", "emergency.signaled": "#/components/schemas/TypedEventStreamEnvelopeEmergencySignaled", "events.rotated": "#/components/schemas/TypedEventStreamEnvelopeEventsRotated", "execution.claim_window_expired": "#/components/schemas/TypedEventStreamEnvelopeExecutionClaimWindowExpired", "execution.run_anchored": "#/components/schemas/TypedEventStreamEnvelopeExecutionRunAnchored", "execution.step_completed": "#/components/schemas/TypedEventStreamEnvelopeExecutionStepCompleted", "execution.step_defined": "#/components/schemas/TypedEventStreamEnvelopeExecutionStepDefined", "execution.step_stalled": "#/components/schemas/TypedEventStreamEnvelopeExecutionStepStalled", "execution.step_started": "#/components/schemas/TypedEventStreamEnvelopeExecutionStepStarted", "execution.work_associated": "#/components/schemas/TypedEventStreamEnvelopeExecutionWorkAssociated", "extmsg.adapter_added": "#/components/schemas/TypedEventStreamEnvelopeExtmsgAdapterAdded", "extmsg.adapter_removed": "#/components/schemas/TypedEventStreamEnvelopeExtmsgAdapterRemoved", "extmsg.bound": "#/components/schemas/TypedEventStreamEnvelopeExtmsgBound", "extmsg.group_created": "#/components/schemas/TypedEventStreamEnvelopeExtmsgGroupCreated", "extmsg.inbound": "#/components/schemas/TypedEventStreamEnvelopeExtmsgInbound", "extmsg.outbound": "#/components/schemas/TypedEventStreamEnvelopeExtmsgOutbound", "extmsg.outbound_channel_mismatch": "#/components/schemas/TypedEventStreamEnvelopeExtmsgOutboundChannelMismatch", "extmsg.unbound": "#/components/schemas/TypedEventStreamEnvelopeExtmsgUnbound", "gc.store.disk_critical": "#/components/schemas/TypedEventStreamEnvelopeGcStoreDiskCritical", "gc.store.disk_warn": "#/components/schemas/TypedEventStreamEnvelopeGcStoreDiskWarn", "gc.store.maintenance.done": "#/components/schemas/TypedEventStreamEnvelopeGcStoreMaintenanceDone", "gc.store.maintenance.failed": "#/components/schemas/TypedEventStreamEnvelopeGcStoreMaintenanceFailed", "hook.claim.reclaimed_stale": "#/components/schemas/TypedEventStreamEnvelopeHookClaimReclaimedStale", "mail.archived": "#/components/schemas/TypedEventStreamEnvelopeMailArchived", "mail.deleted": "#/components/schemas/TypedEventStreamEnvelopeMailDeleted", "mail.marked_read": "#/components/schemas/TypedEventStreamEnvelopeMailMarkedRead", "mail.marked_unread": "#/components/schemas/TypedEventStreamEnvelopeMailMarkedUnread", "mail.read": "#/components/schemas/TypedEventStreamEnvelopeMailRead", "mail.replied": "#/components/schemas/TypedEventStreamEnvelopeMailReplied", "mail.sent": "#/components/schemas/TypedEventStreamEnvelopeMailSent", "molecule.resolved": "#/components/schemas/TypedEventStreamEnvelopeMoleculeResolved", "order.completed": "#/components/schemas/TypedEventStreamEnvelopeOrderCompleted", "order.failed": "#/components/schemas/TypedEventStreamEnvelopeOrderFailed", "order.fired": "#/components/schemas/TypedEventStreamEnvelopeOrderFired", "order.skipped": "#/components/schemas/TypedEventStreamEnvelopeOrderSkipped", "order.suppressed": "#/components/schemas/TypedEventStreamEnvelopeOrderSuppressed", "project.identity.stamped": "#/components/schemas/TypedEventStreamEnvelopeProjectIdentityStamped", "provider.swapped": "#/components/schemas/TypedEventStreamEnvelopeProviderSwapped", "request.failed": "#/components/schemas/TypedEventStreamEnvelopeRequestFailed", "request.result.city.create": "#/components/schemas/TypedEventStreamEnvelopeRequestResultCityCreate", "request.result.city.unregister": "#/components/schemas/TypedEventStreamEnvelopeRequestResultCityUnregister", "request.result.rig.create": "#/components/schemas/TypedEventStreamEnvelopeRequestResultRigCreate", "request.result.session.create": "#/components/schemas/TypedEventStreamEnvelopeRequestResultSessionCreate", "request.result.session.message": "#/components/schemas/TypedEventStreamEnvelopeRequestResultSessionMessage", "request.result.session.submit": "#/components/schemas/TypedEventStreamEnvelopeRequestResultSessionSubmit", "rig.provision.progress": "#/components/schemas/TypedEventStreamEnvelopeRigProvisionProgress", "session.cold_start_timeout": "#/components/schemas/TypedEventStreamEnvelopeSessionColdStartTimeout", "session.crashed": "#/components/schemas/TypedEventStreamEnvelopeSessionCrashed", "session.demand_claim_divergence": "#/components/schemas/TypedEventStreamEnvelopeSessionDemandClaimDivergence", "session.drain_acked_with_assigned_work": "#/components/schemas/TypedEventStreamEnvelopeSessionDrainAckedWithAssignedWork", "session.drain_fence_unavailable": "#/components/schemas/TypedEventStreamEnvelopeSessionDrainFenceUnavailable", "session.drain_stop_escalated": "#/components/schemas/TypedEventStreamEnvelopeSessionDrainStopEscalated", "session.draining": "#/components/schemas/TypedEventStreamEnvelopeSessionDraining", "session.idle_killed": "#/components/schemas/TypedEventStreamEnvelopeSessionIdleKilled", "session.max_age_killed": "#/components/schemas/TypedEventStreamEnvelopeSessionMaxAgeKilled", "session.pending": "#/components/schemas/TypedEventStreamEnvelopeSessionPending", "session.pending_cleared": "#/components/schemas/TypedEventStreamEnvelopeSessionPendingCleared", "session.pool_slot_retired_at_drain_deadline": "#/components/schemas/TypedEventStreamEnvelopeSessionPoolSlotRetiredAtDrainDeadline", "session.quarantined": "#/components/schemas/TypedEventStreamEnvelopeSessionQuarantined", "session.reset_stalled": "#/components/schemas/TypedEventStreamEnvelopeSessionResetStalled", "session.stopped": "#/components/schemas/TypedEventStreamEnvelopeSessionStopped", "session.stranded": "#/components/schemas/TypedEventStreamEnvelopeSessionStranded", "session.suspended": "#/components/schemas/TypedEventStreamEnvelopeSessionSuspended", "session.undrained": "#/components/schemas/TypedEventStreamEnvelopeSessionUndrained", "session.unknown_state": "#/components/schemas/TypedEventStreamEnvelopeSessionUnknownState", "session.updated": "#/components/schemas/TypedEventStreamEnvelopeSessionUpdated", "session.wake_refused": "#/components/schemas/TypedEventStreamEnvelopeSessionWakeRefused", "session.woke": "#/components/schemas/TypedEventStreamEnvelopeSessionWoke", "session.work_query_failed": "#/components/schemas/TypedEventStreamEnvelopeSessionWorkQueryFailed", "storage.binding.converged": "#/components/schemas/TypedEventStreamEnvelopeStorageBindingConverged", "storage.binding.genesis": "#/components/schemas/TypedEventStreamEnvelopeStorageBindingGenesis", "storage.binding.not_configured": "#/components/schemas/TypedEventStreamEnvelopeStorageBindingNotConfigured", "storage.binding.uncheckable": "#/components/schemas/TypedEventStreamEnvelopeStorageBindingUncheckable", "storage.binding.unconverged": "#/components/schemas/TypedEventStreamEnvelopeStorageBindingUnconverged", "supervisor.fs_pressure.skipped_tick": "#/components/schemas/TypedEventStreamEnvelopeSupervisorFsPressureSkippedTick", "supervisor.request": "#/components/schemas/TypedEventStreamEnvelopeSupervisorRequest", "supervisor.shutdown_requested": "#/components/schemas/TypedEventStreamEnvelopeSupervisorShutdownRequested", "supervisor.started": "#/components/schemas/TypedEventStreamEnvelopeSupervisorStarted", "webhook.received": "#/components/schemas/TypedEventStreamEnvelopeWebhookReceived", "webhook.rejected": "#/components/schemas/TypedEventStreamEnvelopeWebhookRejected", "worker.operation": "#/components/schemas/TypedEventStreamEnvelopeWorkerOperation" }, "propertyName": "type" }, "oneOf": [ { "$ref": "#/components/schemas/TypedEventStreamEnvelopeBackendCredentialResolved" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeBeadClaimRejected" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeBeadClaimReleased" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeBeadClosed" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeBeadCreated" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeBeadDeadAssigneeReopened" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeBeadDeleted" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeBeadUpdated" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeBeadWorktreeReapSkipped" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeBeadWorktreeReaped" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeBeadsBlockedRecomputed" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeBeadsConditionalWritesDegraded" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeCityCreated" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeCityResumed" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeCitySuspended" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeCityUnregisterRequested" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeControlDispatcherScopeGap" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeControlRootSettleFailed" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeControlStalled" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeControllerStarted" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeControllerStopped" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeConvoyClosed" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeConvoyCreated" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeEmergencyAcked" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeEmergencySignaled" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeEventsRotated" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeExecutionClaimWindowExpired" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeExecutionRunAnchored" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeExecutionStepCompleted" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeExecutionStepDefined" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeExecutionStepStalled" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeExecutionStepStarted" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeExecutionWorkAssociated" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeExtmsgAdapterAdded" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeExtmsgAdapterRemoved" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeExtmsgBound" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeExtmsgGroupCreated" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeExtmsgInbound" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeExtmsgOutbound" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeExtmsgOutboundChannelMismatch" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeExtmsgUnbound" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeGcStoreDiskCritical" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeGcStoreDiskWarn" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeGcStoreMaintenanceDone" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeGcStoreMaintenanceFailed" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeHookClaimReclaimedStale" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeMailArchived" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeMailDeleted" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeMailMarkedRead" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeMailMarkedUnread" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeMailRead" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeMailReplied" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeMailSent" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeMoleculeResolved" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeOrderCompleted" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeOrderFailed" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeOrderFired" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeOrderSkipped" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeOrderSuppressed" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeProjectIdentityStamped" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeProviderSwapped" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeRequestFailed" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeRequestResultCityCreate" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeRequestResultCityUnregister" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeRequestResultRigCreate" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeRequestResultSessionCreate" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeRequestResultSessionMessage" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeRequestResultSessionSubmit" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeRigProvisionProgress" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSessionColdStartTimeout" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSessionCrashed" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSessionDemandClaimDivergence" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSessionDrainAckedWithAssignedWork" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSessionDrainFenceUnavailable" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSessionDrainStopEscalated" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSessionDraining" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSessionIdleKilled" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSessionMaxAgeKilled" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSessionPending" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSessionPendingCleared" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSessionPoolSlotRetiredAtDrainDeadline" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSessionQuarantined" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSessionResetStalled" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSessionStopped" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSessionStranded" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSessionSuspended" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSessionUndrained" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSessionUnknownState" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSessionUpdated" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSessionWakeRefused" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSessionWoke" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSessionWorkQueryFailed" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeStorageBindingConverged" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeStorageBindingGenesis" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeStorageBindingNotConfigured" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeStorageBindingUncheckable" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeStorageBindingUnconverged" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSupervisorFsPressureSkippedTick" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSupervisorRequest" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSupervisorShutdownRequested" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeSupervisorStarted" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeWebhookReceived" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeWebhookRejected" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeWorkerOperation" }, { "$ref": "#/components/schemas/TypedEventStreamEnvelopeCustom" } ], "title": "Typed city event stream envelope" }, "TypedEventStreamEnvelopeBackendCredentialResolved": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/BackendCredentialResolvedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "backend.credential_resolved", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope backend.credential_resolved", "type": "object" }, "TypedEventStreamEnvelopeBeadClaimRejected": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/BeadClaimRejectedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "bead.claim_rejected", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope bead.claim_rejected", "type": "object" }, "TypedEventStreamEnvelopeBeadClaimReleased": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/BeadClaimReleasedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "bead.claim_released", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope bead.claim_released", "type": "object" }, "TypedEventStreamEnvelopeBeadClosed": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/BeadEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "bead.closed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope bead.closed", "type": "object" }, "TypedEventStreamEnvelopeBeadCreated": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/BeadEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "bead.created", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope bead.created", "type": "object" }, "TypedEventStreamEnvelopeBeadDeadAssigneeReopened": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/BeadDeadAssigneeReopenedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "bead.dead_assignee_reopened", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope bead.dead_assignee_reopened", "type": "object" }, "TypedEventStreamEnvelopeBeadDeleted": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/BeadEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "bead.deleted", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope bead.deleted", "type": "object" }, "TypedEventStreamEnvelopeBeadUpdated": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/BeadEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "bead.updated", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope bead.updated", "type": "object" }, "TypedEventStreamEnvelopeBeadWorktreeReapSkipped": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/BeadWorktreeReapSkippedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "bead.worktree.reap_skipped", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope bead.worktree.reap_skipped", "type": "object" }, "TypedEventStreamEnvelopeBeadWorktreeReaped": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/BeadWorktreeReapedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "bead.worktree.reaped", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope bead.worktree.reaped", "type": "object" }, "TypedEventStreamEnvelopeBeadsBlockedRecomputed": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/BlockedRecomputedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "beads.blocked.recomputed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope beads.blocked.recomputed", "type": "object" }, "TypedEventStreamEnvelopeBeadsConditionalWritesDegraded": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/ConditionalWritesDegradedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "beads.conditional_writes.degraded", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope beads.conditional_writes.degraded", "type": "object" }, "TypedEventStreamEnvelopeCityCreated": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/CityLifecyclePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "city.created", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope city.created", "type": "object" }, "TypedEventStreamEnvelopeCityResumed": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "city.resumed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope city.resumed", "type": "object" }, "TypedEventStreamEnvelopeCitySuspended": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "city.suspended", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope city.suspended", "type": "object" }, "TypedEventStreamEnvelopeCityUnregisterRequested": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/CityLifecyclePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "city.unregister_requested", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope city.unregister_requested", "type": "object" }, "TypedEventStreamEnvelopeControlDispatcherScopeGap": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/ControlDispatcherScopeGapPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "control.dispatcher_scope_gap", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope control.dispatcher_scope_gap", "type": "object" }, "TypedEventStreamEnvelopeControlRootSettleFailed": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/ControlRootSettleFailedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "control.root_settle_failed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope control.root_settle_failed", "type": "object" }, "TypedEventStreamEnvelopeControlStalled": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/ControlStalledPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "control.stalled", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope control.stalled", "type": "object" }, "TypedEventStreamEnvelopeControllerStarted": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "controller.started", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope controller.started", "type": "object" }, "TypedEventStreamEnvelopeControllerStopped": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "controller.stopped", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope controller.stopped", "type": "object" }, "TypedEventStreamEnvelopeConvoyClosed": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "convoy.closed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope convoy.closed", "type": "object" }, "TypedEventStreamEnvelopeConvoyCreated": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "convoy.created", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope convoy.created", "type": "object" }, "TypedEventStreamEnvelopeCustom": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": {}, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "not": { "enum": [ "session.woke", "session.stopped", "session.crashed", "session.draining", "session.undrained", "session.quarantined", "session.idle_killed", "session.max_age_killed", "session.suspended", "session.updated", "session.drain_acked_with_assigned_work", "session.drain_stop_escalated", "session.stranded", "session.pool_slot_retired_at_drain_deadline", "session.unknown_state", "session.wake_refused", "session.reset_stalled", "session.work_query_failed", "session.drain_fence_unavailable", "session.demand_claim_divergence", "session.cold_start_timeout", "session.pending", "session.pending_cleared", "bead.created", "bead.closed", "bead.deleted", "bead.updated", "bead.worktree.reaped", "bead.worktree.reap_skipped", "bead.claim_rejected", "bead.claim_released", "hook.claim.reclaimed_stale", "bead.dead_assignee_reopened", "execution.work_associated", "execution.run_anchored", "execution.step_defined", "execution.step_started", "execution.step_completed", "execution.claim_window_expired", "execution.step_stalled", "mail.sent", "mail.read", "mail.archived", "mail.marked_read", "mail.marked_unread", "mail.replied", "mail.deleted", "convoy.created", "convoy.closed", "controller.started", "controller.stopped", "control.stalled", "control.root_settle_failed", "control.dispatcher_scope_gap", "city.suspended", "city.resumed", "request.result.city.create", "request.result.city.unregister", "request.result.session.create", "request.result.session.message", "request.result.session.submit", "request.result.rig.create", "request.failed", "rig.provision.progress", "city.created", "city.unregister_requested", "order.fired", "order.completed", "order.failed", "order.suppressed", "order.skipped", "provider.swapped", "worker.operation", "project.identity.stamped", "supervisor.fs_pressure.skipped_tick", "molecule.resolved", "supervisor.started", "supervisor.shutdown_requested", "supervisor.request", "extmsg.bound", "extmsg.unbound", "extmsg.group_created", "extmsg.adapter_added", "extmsg.adapter_removed", "extmsg.inbound", "extmsg.outbound", "extmsg.outbound_channel_mismatch", "webhook.received", "webhook.rejected", "events.rotated", "gc.store.maintenance.done", "gc.store.maintenance.failed", "gc.store.disk_warn", "gc.store.disk_critical", "backend.credential_resolved", "emergency.signaled", "emergency.acked", "beads.conditional_writes.degraded", "beads.blocked.recomputed", "storage.binding.converged", "storage.binding.genesis", "storage.binding.unconverged", "storage.binding.uncheckable", "storage.binding.not_configured" ] }, "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope custom", "type": "object" }, "TypedEventStreamEnvelopeEmergencyAcked": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/Record" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "emergency.acked", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope emergency.acked", "type": "object" }, "TypedEventStreamEnvelopeEmergencySignaled": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/Record" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "emergency.signaled", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope emergency.signaled", "type": "object" }, "TypedEventStreamEnvelopeEventsRotated": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/RotatedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "events.rotated", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope events.rotated", "type": "object" }, "TypedEventStreamEnvelopeExecutionClaimWindowExpired": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/ExecutionClaimWindowExpiredPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "execution.claim_window_expired", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope execution.claim_window_expired", "type": "object" }, "TypedEventStreamEnvelopeExecutionRunAnchored": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "execution.run_anchored", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope execution.run_anchored", "type": "object" }, "TypedEventStreamEnvelopeExecutionStepCompleted": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "execution.step_completed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope execution.step_completed", "type": "object" }, "TypedEventStreamEnvelopeExecutionStepDefined": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "execution.step_defined", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope execution.step_defined", "type": "object" }, "TypedEventStreamEnvelopeExecutionStepStalled": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/ExecutionStepStalledPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "execution.step_stalled", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope execution.step_stalled", "type": "object" }, "TypedEventStreamEnvelopeExecutionStepStarted": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "execution.step_started", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope execution.step_started", "type": "object" }, "TypedEventStreamEnvelopeExecutionWorkAssociated": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "execution.work_associated", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope execution.work_associated", "type": "object" }, "TypedEventStreamEnvelopeExtmsgAdapterAdded": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/AdapterEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "extmsg.adapter_added", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope extmsg.adapter_added", "type": "object" }, "TypedEventStreamEnvelopeExtmsgAdapterRemoved": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/AdapterEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "extmsg.adapter_removed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope extmsg.adapter_removed", "type": "object" }, "TypedEventStreamEnvelopeExtmsgBound": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/BoundEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "extmsg.bound", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope extmsg.bound", "type": "object" }, "TypedEventStreamEnvelopeExtmsgGroupCreated": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/GroupCreatedEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "extmsg.group_created", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope extmsg.group_created", "type": "object" }, "TypedEventStreamEnvelopeExtmsgInbound": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/InboundEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "extmsg.inbound", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope extmsg.inbound", "type": "object" }, "TypedEventStreamEnvelopeExtmsgOutbound": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/OutboundEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "extmsg.outbound", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope extmsg.outbound", "type": "object" }, "TypedEventStreamEnvelopeExtmsgOutboundChannelMismatch": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/OutboundChannelMismatchPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "extmsg.outbound_channel_mismatch", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope extmsg.outbound_channel_mismatch", "type": "object" }, "TypedEventStreamEnvelopeExtmsgUnbound": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/UnboundEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "extmsg.unbound", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope extmsg.unbound", "type": "object" }, "TypedEventStreamEnvelopeGcStoreDiskCritical": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/StoreDiskCriticalPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "gc.store.disk_critical", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope gc.store.disk_critical", "type": "object" }, "TypedEventStreamEnvelopeGcStoreDiskWarn": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/StoreDiskWarnPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "gc.store.disk_warn", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope gc.store.disk_warn", "type": "object" }, "TypedEventStreamEnvelopeGcStoreMaintenanceDone": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/StoreMaintenanceDonePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "gc.store.maintenance.done", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope gc.store.maintenance.done", "type": "object" }, "TypedEventStreamEnvelopeGcStoreMaintenanceFailed": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/StoreMaintenanceFailedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "gc.store.maintenance.failed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope gc.store.maintenance.failed", "type": "object" }, "TypedEventStreamEnvelopeHookClaimReclaimedStale": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/HookClaimReclaimedStalePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "hook.claim.reclaimed_stale", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope hook.claim.reclaimed_stale", "type": "object" }, "TypedEventStreamEnvelopeMailArchived": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/MailEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "mail.archived", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope mail.archived", "type": "object" }, "TypedEventStreamEnvelopeMailDeleted": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/MailEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "mail.deleted", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope mail.deleted", "type": "object" }, "TypedEventStreamEnvelopeMailMarkedRead": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/MailEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "mail.marked_read", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope mail.marked_read", "type": "object" }, "TypedEventStreamEnvelopeMailMarkedUnread": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/MailEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "mail.marked_unread", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope mail.marked_unread", "type": "object" }, "TypedEventStreamEnvelopeMailRead": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/MailEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "mail.read", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope mail.read", "type": "object" }, "TypedEventStreamEnvelopeMailReplied": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/MailEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "mail.replied", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope mail.replied", "type": "object" }, "TypedEventStreamEnvelopeMailSent": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/MailEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "mail.sent", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope mail.sent", "type": "object" }, "TypedEventStreamEnvelopeMoleculeResolved": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/MoleculeResolvedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "molecule.resolved", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope molecule.resolved", "type": "object" }, "TypedEventStreamEnvelopeOrderCompleted": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "order.completed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope order.completed", "type": "object" }, "TypedEventStreamEnvelopeOrderFailed": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "order.failed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope order.failed", "type": "object" }, "TypedEventStreamEnvelopeOrderFired": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "order.fired", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope order.fired", "type": "object" }, "TypedEventStreamEnvelopeOrderSkipped": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/OrderSkippedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "order.skipped", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope order.skipped", "type": "object" }, "TypedEventStreamEnvelopeOrderSuppressed": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/OrderSuppressedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "order.suppressed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope order.suppressed", "type": "object" }, "TypedEventStreamEnvelopeProjectIdentityStamped": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/ProjectIdentityStampedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "project.identity.stamped", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope project.identity.stamped", "type": "object" }, "TypedEventStreamEnvelopeProviderSwapped": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "provider.swapped", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope provider.swapped", "type": "object" }, "TypedEventStreamEnvelopeRequestFailed": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/RequestFailedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "request.failed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope request.failed", "type": "object" }, "TypedEventStreamEnvelopeRequestResultCityCreate": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/CityCreateSucceededPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "request.result.city.create", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope request.result.city.create", "type": "object" }, "TypedEventStreamEnvelopeRequestResultCityUnregister": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/CityUnregisterSucceededPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "request.result.city.unregister", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope request.result.city.unregister", "type": "object" }, "TypedEventStreamEnvelopeRequestResultRigCreate": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/RigCreateSucceededPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "request.result.rig.create", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope request.result.rig.create", "type": "object" }, "TypedEventStreamEnvelopeRequestResultSessionCreate": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionCreateSucceededPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "request.result.session.create", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope request.result.session.create", "type": "object" }, "TypedEventStreamEnvelopeRequestResultSessionMessage": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionMessageSucceededPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "request.result.session.message", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope request.result.session.message", "type": "object" }, "TypedEventStreamEnvelopeRequestResultSessionSubmit": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionSubmitSucceededPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "request.result.session.submit", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope request.result.session.submit", "type": "object" }, "TypedEventStreamEnvelopeRigProvisionProgress": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/RigProvisionProgressPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "rig.provision.progress", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope rig.provision.progress", "type": "object" }, "TypedEventStreamEnvelopeSessionColdStartTimeout": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.cold_start_timeout", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope session.cold_start_timeout", "type": "object" }, "TypedEventStreamEnvelopeSessionCrashed": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionLifecyclePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.crashed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope session.crashed", "type": "object" }, "TypedEventStreamEnvelopeSessionDemandClaimDivergence": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionDemandClaimDivergencePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.demand_claim_divergence", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope session.demand_claim_divergence", "type": "object" }, "TypedEventStreamEnvelopeSessionDrainAckedWithAssignedWork": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionDrainAckedWithAssignedWorkPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.drain_acked_with_assigned_work", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope session.drain_acked_with_assigned_work", "type": "object" }, "TypedEventStreamEnvelopeSessionDrainFenceUnavailable": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionLifecyclePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.drain_fence_unavailable", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope session.drain_fence_unavailable", "type": "object" }, "TypedEventStreamEnvelopeSessionDrainStopEscalated": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionLifecyclePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.drain_stop_escalated", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope session.drain_stop_escalated", "type": "object" }, "TypedEventStreamEnvelopeSessionDraining": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.draining", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope session.draining", "type": "object" }, "TypedEventStreamEnvelopeSessionIdleKilled": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.idle_killed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope session.idle_killed", "type": "object" }, "TypedEventStreamEnvelopeSessionMaxAgeKilled": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.max_age_killed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope session.max_age_killed", "type": "object" }, "TypedEventStreamEnvelopeSessionPending": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionPendingPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.pending", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope session.pending", "type": "object" }, "TypedEventStreamEnvelopeSessionPendingCleared": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionPendingClearedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.pending_cleared", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope session.pending_cleared", "type": "object" }, "TypedEventStreamEnvelopeSessionPoolSlotRetiredAtDrainDeadline": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionPoolSlotRetiredAtDrainDeadlinePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.pool_slot_retired_at_drain_deadline", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope session.pool_slot_retired_at_drain_deadline", "type": "object" }, "TypedEventStreamEnvelopeSessionQuarantined": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.quarantined", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope session.quarantined", "type": "object" }, "TypedEventStreamEnvelopeSessionResetStalled": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionResetStalledPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.reset_stalled", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope session.reset_stalled", "type": "object" }, "TypedEventStreamEnvelopeSessionStopped": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionLifecyclePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.stopped", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope session.stopped", "type": "object" }, "TypedEventStreamEnvelopeSessionStranded": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionStrandedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.stranded", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope session.stranded", "type": "object" }, "TypedEventStreamEnvelopeSessionSuspended": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.suspended", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope session.suspended", "type": "object" }, "TypedEventStreamEnvelopeSessionUndrained": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.undrained", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope session.undrained", "type": "object" }, "TypedEventStreamEnvelopeSessionUnknownState": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionUnknownStatePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.unknown_state", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope session.unknown_state", "type": "object" }, "TypedEventStreamEnvelopeSessionUpdated": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.updated", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope session.updated", "type": "object" }, "TypedEventStreamEnvelopeSessionWakeRefused": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionWakeRefusedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.wake_refused", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope session.wake_refused", "type": "object" }, "TypedEventStreamEnvelopeSessionWoke": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.woke", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope session.woke", "type": "object" }, "TypedEventStreamEnvelopeSessionWorkQueryFailed": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionLifecyclePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.work_query_failed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope session.work_query_failed", "type": "object" }, "TypedEventStreamEnvelopeStorageBindingConverged": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/StorageBindingOutcomePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "storage.binding.converged", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope storage.binding.converged", "type": "object" }, "TypedEventStreamEnvelopeStorageBindingGenesis": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/StorageBindingOutcomePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "storage.binding.genesis", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope storage.binding.genesis", "type": "object" }, "TypedEventStreamEnvelopeStorageBindingNotConfigured": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/StorageBindingOutcomePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "storage.binding.not_configured", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope storage.binding.not_configured", "type": "object" }, "TypedEventStreamEnvelopeStorageBindingUncheckable": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/StorageBindingOutcomePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "storage.binding.uncheckable", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope storage.binding.uncheckable", "type": "object" }, "TypedEventStreamEnvelopeStorageBindingUnconverged": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/StorageBindingOutcomePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "storage.binding.unconverged", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope storage.binding.unconverged", "type": "object" }, "TypedEventStreamEnvelopeSupervisorFsPressureSkippedTick": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SupervisorFSPressureSkippedTickPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "supervisor.fs_pressure.skipped_tick", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope supervisor.fs_pressure.skipped_tick", "type": "object" }, "TypedEventStreamEnvelopeSupervisorRequest": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SupervisorRequestPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "supervisor.request", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope supervisor.request", "type": "object" }, "TypedEventStreamEnvelopeSupervisorShutdownRequested": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SupervisorShutdownPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "supervisor.shutdown_requested", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope supervisor.shutdown_requested", "type": "object" }, "TypedEventStreamEnvelopeSupervisorStarted": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SupervisorStartedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "supervisor.started", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope supervisor.started", "type": "object" }, "TypedEventStreamEnvelopeWebhookReceived": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/WebhookReceivedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "webhook.received", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope webhook.received", "type": "object" }, "TypedEventStreamEnvelopeWebhookRejected": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/WebhookRejectedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "webhook.rejected", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope webhook.rejected", "type": "object" }, "TypedEventStreamEnvelopeWorkerOperation": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/WorkerOperationEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "worker.operation", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload" ], "title": "TypedEventStreamEnvelope worker.operation", "type": "object" }, "TypedTaggedEventStreamEnvelope": { "description": "Discriminated union of supervisor event stream envelopes. Each variant constrains the envelope type and payload schema together and includes the source city.", "discriminator": { "mapping": { "backend.credential_resolved": "#/components/schemas/TypedTaggedEventStreamEnvelopeBackendCredentialResolved", "bead.claim_rejected": "#/components/schemas/TypedTaggedEventStreamEnvelopeBeadClaimRejected", "bead.claim_released": "#/components/schemas/TypedTaggedEventStreamEnvelopeBeadClaimReleased", "bead.closed": "#/components/schemas/TypedTaggedEventStreamEnvelopeBeadClosed", "bead.created": "#/components/schemas/TypedTaggedEventStreamEnvelopeBeadCreated", "bead.dead_assignee_reopened": "#/components/schemas/TypedTaggedEventStreamEnvelopeBeadDeadAssigneeReopened", "bead.deleted": "#/components/schemas/TypedTaggedEventStreamEnvelopeBeadDeleted", "bead.updated": "#/components/schemas/TypedTaggedEventStreamEnvelopeBeadUpdated", "bead.worktree.reap_skipped": "#/components/schemas/TypedTaggedEventStreamEnvelopeBeadWorktreeReapSkipped", "bead.worktree.reaped": "#/components/schemas/TypedTaggedEventStreamEnvelopeBeadWorktreeReaped", "beads.blocked.recomputed": "#/components/schemas/TypedTaggedEventStreamEnvelopeBeadsBlockedRecomputed", "beads.conditional_writes.degraded": "#/components/schemas/TypedTaggedEventStreamEnvelopeBeadsConditionalWritesDegraded", "city.created": "#/components/schemas/TypedTaggedEventStreamEnvelopeCityCreated", "city.resumed": "#/components/schemas/TypedTaggedEventStreamEnvelopeCityResumed", "city.suspended": "#/components/schemas/TypedTaggedEventStreamEnvelopeCitySuspended", "city.unregister_requested": "#/components/schemas/TypedTaggedEventStreamEnvelopeCityUnregisterRequested", "control.dispatcher_scope_gap": "#/components/schemas/TypedTaggedEventStreamEnvelopeControlDispatcherScopeGap", "control.root_settle_failed": "#/components/schemas/TypedTaggedEventStreamEnvelopeControlRootSettleFailed", "control.stalled": "#/components/schemas/TypedTaggedEventStreamEnvelopeControlStalled", "controller.started": "#/components/schemas/TypedTaggedEventStreamEnvelopeControllerStarted", "controller.stopped": "#/components/schemas/TypedTaggedEventStreamEnvelopeControllerStopped", "convoy.closed": "#/components/schemas/TypedTaggedEventStreamEnvelopeConvoyClosed", "convoy.created": "#/components/schemas/TypedTaggedEventStreamEnvelopeConvoyCreated", "emergency.acked": "#/components/schemas/TypedTaggedEventStreamEnvelopeEmergencyAcked", "emergency.signaled": "#/components/schemas/TypedTaggedEventStreamEnvelopeEmergencySignaled", "events.rotated": "#/components/schemas/TypedTaggedEventStreamEnvelopeEventsRotated", "execution.claim_window_expired": "#/components/schemas/TypedTaggedEventStreamEnvelopeExecutionClaimWindowExpired", "execution.run_anchored": "#/components/schemas/TypedTaggedEventStreamEnvelopeExecutionRunAnchored", "execution.step_completed": "#/components/schemas/TypedTaggedEventStreamEnvelopeExecutionStepCompleted", "execution.step_defined": "#/components/schemas/TypedTaggedEventStreamEnvelopeExecutionStepDefined", "execution.step_stalled": "#/components/schemas/TypedTaggedEventStreamEnvelopeExecutionStepStalled", "execution.step_started": "#/components/schemas/TypedTaggedEventStreamEnvelopeExecutionStepStarted", "execution.work_associated": "#/components/schemas/TypedTaggedEventStreamEnvelopeExecutionWorkAssociated", "extmsg.adapter_added": "#/components/schemas/TypedTaggedEventStreamEnvelopeExtmsgAdapterAdded", "extmsg.adapter_removed": "#/components/schemas/TypedTaggedEventStreamEnvelopeExtmsgAdapterRemoved", "extmsg.bound": "#/components/schemas/TypedTaggedEventStreamEnvelopeExtmsgBound", "extmsg.group_created": "#/components/schemas/TypedTaggedEventStreamEnvelopeExtmsgGroupCreated", "extmsg.inbound": "#/components/schemas/TypedTaggedEventStreamEnvelopeExtmsgInbound", "extmsg.outbound": "#/components/schemas/TypedTaggedEventStreamEnvelopeExtmsgOutbound", "extmsg.outbound_channel_mismatch": "#/components/schemas/TypedTaggedEventStreamEnvelopeExtmsgOutboundChannelMismatch", "extmsg.unbound": "#/components/schemas/TypedTaggedEventStreamEnvelopeExtmsgUnbound", "gc.store.disk_critical": "#/components/schemas/TypedTaggedEventStreamEnvelopeGcStoreDiskCritical", "gc.store.disk_warn": "#/components/schemas/TypedTaggedEventStreamEnvelopeGcStoreDiskWarn", "gc.store.maintenance.done": "#/components/schemas/TypedTaggedEventStreamEnvelopeGcStoreMaintenanceDone", "gc.store.maintenance.failed": "#/components/schemas/TypedTaggedEventStreamEnvelopeGcStoreMaintenanceFailed", "hook.claim.reclaimed_stale": "#/components/schemas/TypedTaggedEventStreamEnvelopeHookClaimReclaimedStale", "mail.archived": "#/components/schemas/TypedTaggedEventStreamEnvelopeMailArchived", "mail.deleted": "#/components/schemas/TypedTaggedEventStreamEnvelopeMailDeleted", "mail.marked_read": "#/components/schemas/TypedTaggedEventStreamEnvelopeMailMarkedRead", "mail.marked_unread": "#/components/schemas/TypedTaggedEventStreamEnvelopeMailMarkedUnread", "mail.read": "#/components/schemas/TypedTaggedEventStreamEnvelopeMailRead", "mail.replied": "#/components/schemas/TypedTaggedEventStreamEnvelopeMailReplied", "mail.sent": "#/components/schemas/TypedTaggedEventStreamEnvelopeMailSent", "molecule.resolved": "#/components/schemas/TypedTaggedEventStreamEnvelopeMoleculeResolved", "order.completed": "#/components/schemas/TypedTaggedEventStreamEnvelopeOrderCompleted", "order.failed": "#/components/schemas/TypedTaggedEventStreamEnvelopeOrderFailed", "order.fired": "#/components/schemas/TypedTaggedEventStreamEnvelopeOrderFired", "order.skipped": "#/components/schemas/TypedTaggedEventStreamEnvelopeOrderSkipped", "order.suppressed": "#/components/schemas/TypedTaggedEventStreamEnvelopeOrderSuppressed", "project.identity.stamped": "#/components/schemas/TypedTaggedEventStreamEnvelopeProjectIdentityStamped", "provider.swapped": "#/components/schemas/TypedTaggedEventStreamEnvelopeProviderSwapped", "request.failed": "#/components/schemas/TypedTaggedEventStreamEnvelopeRequestFailed", "request.result.city.create": "#/components/schemas/TypedTaggedEventStreamEnvelopeRequestResultCityCreate", "request.result.city.unregister": "#/components/schemas/TypedTaggedEventStreamEnvelopeRequestResultCityUnregister", "request.result.rig.create": "#/components/schemas/TypedTaggedEventStreamEnvelopeRequestResultRigCreate", "request.result.session.create": "#/components/schemas/TypedTaggedEventStreamEnvelopeRequestResultSessionCreate", "request.result.session.message": "#/components/schemas/TypedTaggedEventStreamEnvelopeRequestResultSessionMessage", "request.result.session.submit": "#/components/schemas/TypedTaggedEventStreamEnvelopeRequestResultSessionSubmit", "rig.provision.progress": "#/components/schemas/TypedTaggedEventStreamEnvelopeRigProvisionProgress", "session.cold_start_timeout": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionColdStartTimeout", "session.crashed": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionCrashed", "session.demand_claim_divergence": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionDemandClaimDivergence", "session.drain_acked_with_assigned_work": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionDrainAckedWithAssignedWork", "session.drain_fence_unavailable": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionDrainFenceUnavailable", "session.drain_stop_escalated": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionDrainStopEscalated", "session.draining": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionDraining", "session.idle_killed": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionIdleKilled", "session.max_age_killed": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionMaxAgeKilled", "session.pending": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionPending", "session.pending_cleared": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionPendingCleared", "session.pool_slot_retired_at_drain_deadline": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionPoolSlotRetiredAtDrainDeadline", "session.quarantined": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionQuarantined", "session.reset_stalled": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionResetStalled", "session.stopped": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionStopped", "session.stranded": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionStranded", "session.suspended": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionSuspended", "session.undrained": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionUndrained", "session.unknown_state": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionUnknownState", "session.updated": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionUpdated", "session.wake_refused": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionWakeRefused", "session.woke": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionWoke", "session.work_query_failed": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionWorkQueryFailed", "storage.binding.converged": "#/components/schemas/TypedTaggedEventStreamEnvelopeStorageBindingConverged", "storage.binding.genesis": "#/components/schemas/TypedTaggedEventStreamEnvelopeStorageBindingGenesis", "storage.binding.not_configured": "#/components/schemas/TypedTaggedEventStreamEnvelopeStorageBindingNotConfigured", "storage.binding.uncheckable": "#/components/schemas/TypedTaggedEventStreamEnvelopeStorageBindingUncheckable", "storage.binding.unconverged": "#/components/schemas/TypedTaggedEventStreamEnvelopeStorageBindingUnconverged", "supervisor.fs_pressure.skipped_tick": "#/components/schemas/TypedTaggedEventStreamEnvelopeSupervisorFsPressureSkippedTick", "supervisor.request": "#/components/schemas/TypedTaggedEventStreamEnvelopeSupervisorRequest", "supervisor.shutdown_requested": "#/components/schemas/TypedTaggedEventStreamEnvelopeSupervisorShutdownRequested", "supervisor.started": "#/components/schemas/TypedTaggedEventStreamEnvelopeSupervisorStarted", "webhook.received": "#/components/schemas/TypedTaggedEventStreamEnvelopeWebhookReceived", "webhook.rejected": "#/components/schemas/TypedTaggedEventStreamEnvelopeWebhookRejected", "worker.operation": "#/components/schemas/TypedTaggedEventStreamEnvelopeWorkerOperation" }, "propertyName": "type" }, "oneOf": [ { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeBackendCredentialResolved" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeBeadClaimRejected" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeBeadClaimReleased" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeBeadClosed" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeBeadCreated" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeBeadDeadAssigneeReopened" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeBeadDeleted" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeBeadUpdated" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeBeadWorktreeReapSkipped" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeBeadWorktreeReaped" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeBeadsBlockedRecomputed" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeBeadsConditionalWritesDegraded" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeCityCreated" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeCityResumed" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeCitySuspended" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeCityUnregisterRequested" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeControlDispatcherScopeGap" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeControlRootSettleFailed" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeControlStalled" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeControllerStarted" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeControllerStopped" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeConvoyClosed" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeConvoyCreated" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeEmergencyAcked" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeEmergencySignaled" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeEventsRotated" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeExecutionClaimWindowExpired" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeExecutionRunAnchored" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeExecutionStepCompleted" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeExecutionStepDefined" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeExecutionStepStalled" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeExecutionStepStarted" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeExecutionWorkAssociated" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeExtmsgAdapterAdded" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeExtmsgAdapterRemoved" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeExtmsgBound" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeExtmsgGroupCreated" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeExtmsgInbound" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeExtmsgOutbound" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeExtmsgOutboundChannelMismatch" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeExtmsgUnbound" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeGcStoreDiskCritical" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeGcStoreDiskWarn" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeGcStoreMaintenanceDone" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeGcStoreMaintenanceFailed" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeHookClaimReclaimedStale" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeMailArchived" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeMailDeleted" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeMailMarkedRead" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeMailMarkedUnread" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeMailRead" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeMailReplied" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeMailSent" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeMoleculeResolved" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeOrderCompleted" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeOrderFailed" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeOrderFired" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeOrderSkipped" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeOrderSuppressed" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeProjectIdentityStamped" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeProviderSwapped" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeRequestFailed" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeRequestResultCityCreate" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeRequestResultCityUnregister" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeRequestResultRigCreate" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeRequestResultSessionCreate" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeRequestResultSessionMessage" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeRequestResultSessionSubmit" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeRigProvisionProgress" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionColdStartTimeout" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionCrashed" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionDemandClaimDivergence" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionDrainAckedWithAssignedWork" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionDrainFenceUnavailable" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionDrainStopEscalated" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionDraining" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionIdleKilled" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionMaxAgeKilled" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionPending" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionPendingCleared" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionPoolSlotRetiredAtDrainDeadline" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionQuarantined" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionResetStalled" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionStopped" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionStranded" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionSuspended" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionUndrained" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionUnknownState" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionUpdated" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionWakeRefused" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionWoke" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSessionWorkQueryFailed" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeStorageBindingConverged" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeStorageBindingGenesis" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeStorageBindingNotConfigured" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeStorageBindingUncheckable" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeStorageBindingUnconverged" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSupervisorFsPressureSkippedTick" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSupervisorRequest" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSupervisorShutdownRequested" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeSupervisorStarted" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeWebhookReceived" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeWebhookRejected" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeWorkerOperation" }, { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelopeCustom" } ], "title": "Typed supervisor event stream envelope" }, "TypedTaggedEventStreamEnvelopeBackendCredentialResolved": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/BackendCredentialResolvedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "backend.credential_resolved", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope backend.credential_resolved", "type": "object" }, "TypedTaggedEventStreamEnvelopeBeadClaimRejected": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/BeadClaimRejectedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "bead.claim_rejected", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope bead.claim_rejected", "type": "object" }, "TypedTaggedEventStreamEnvelopeBeadClaimReleased": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/BeadClaimReleasedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "bead.claim_released", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope bead.claim_released", "type": "object" }, "TypedTaggedEventStreamEnvelopeBeadClosed": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/BeadEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "bead.closed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope bead.closed", "type": "object" }, "TypedTaggedEventStreamEnvelopeBeadCreated": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/BeadEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "bead.created", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope bead.created", "type": "object" }, "TypedTaggedEventStreamEnvelopeBeadDeadAssigneeReopened": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/BeadDeadAssigneeReopenedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "bead.dead_assignee_reopened", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope bead.dead_assignee_reopened", "type": "object" }, "TypedTaggedEventStreamEnvelopeBeadDeleted": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/BeadEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "bead.deleted", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope bead.deleted", "type": "object" }, "TypedTaggedEventStreamEnvelopeBeadUpdated": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/BeadEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "bead.updated", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope bead.updated", "type": "object" }, "TypedTaggedEventStreamEnvelopeBeadWorktreeReapSkipped": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/BeadWorktreeReapSkippedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "bead.worktree.reap_skipped", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope bead.worktree.reap_skipped", "type": "object" }, "TypedTaggedEventStreamEnvelopeBeadWorktreeReaped": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/BeadWorktreeReapedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "bead.worktree.reaped", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope bead.worktree.reaped", "type": "object" }, "TypedTaggedEventStreamEnvelopeBeadsBlockedRecomputed": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/BlockedRecomputedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "beads.blocked.recomputed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope beads.blocked.recomputed", "type": "object" }, "TypedTaggedEventStreamEnvelopeBeadsConditionalWritesDegraded": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/ConditionalWritesDegradedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "beads.conditional_writes.degraded", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope beads.conditional_writes.degraded", "type": "object" }, "TypedTaggedEventStreamEnvelopeCityCreated": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/CityLifecyclePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "city.created", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope city.created", "type": "object" }, "TypedTaggedEventStreamEnvelopeCityResumed": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "city.resumed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope city.resumed", "type": "object" }, "TypedTaggedEventStreamEnvelopeCitySuspended": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "city.suspended", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope city.suspended", "type": "object" }, "TypedTaggedEventStreamEnvelopeCityUnregisterRequested": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/CityLifecyclePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "city.unregister_requested", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope city.unregister_requested", "type": "object" }, "TypedTaggedEventStreamEnvelopeControlDispatcherScopeGap": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/ControlDispatcherScopeGapPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "control.dispatcher_scope_gap", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope control.dispatcher_scope_gap", "type": "object" }, "TypedTaggedEventStreamEnvelopeControlRootSettleFailed": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/ControlRootSettleFailedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "control.root_settle_failed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope control.root_settle_failed", "type": "object" }, "TypedTaggedEventStreamEnvelopeControlStalled": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/ControlStalledPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "control.stalled", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope control.stalled", "type": "object" }, "TypedTaggedEventStreamEnvelopeControllerStarted": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "controller.started", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope controller.started", "type": "object" }, "TypedTaggedEventStreamEnvelopeControllerStopped": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "controller.stopped", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope controller.stopped", "type": "object" }, "TypedTaggedEventStreamEnvelopeConvoyClosed": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "convoy.closed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope convoy.closed", "type": "object" }, "TypedTaggedEventStreamEnvelopeConvoyCreated": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "convoy.created", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope convoy.created", "type": "object" }, "TypedTaggedEventStreamEnvelopeCustom": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": {}, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "not": { "enum": [ "session.woke", "session.stopped", "session.crashed", "session.draining", "session.undrained", "session.quarantined", "session.idle_killed", "session.max_age_killed", "session.suspended", "session.updated", "session.drain_acked_with_assigned_work", "session.drain_stop_escalated", "session.stranded", "session.pool_slot_retired_at_drain_deadline", "session.unknown_state", "session.wake_refused", "session.reset_stalled", "session.work_query_failed", "session.drain_fence_unavailable", "session.demand_claim_divergence", "session.cold_start_timeout", "session.pending", "session.pending_cleared", "bead.created", "bead.closed", "bead.deleted", "bead.updated", "bead.worktree.reaped", "bead.worktree.reap_skipped", "bead.claim_rejected", "bead.claim_released", "hook.claim.reclaimed_stale", "bead.dead_assignee_reopened", "execution.work_associated", "execution.run_anchored", "execution.step_defined", "execution.step_started", "execution.step_completed", "execution.claim_window_expired", "execution.step_stalled", "mail.sent", "mail.read", "mail.archived", "mail.marked_read", "mail.marked_unread", "mail.replied", "mail.deleted", "convoy.created", "convoy.closed", "controller.started", "controller.stopped", "control.stalled", "control.root_settle_failed", "control.dispatcher_scope_gap", "city.suspended", "city.resumed", "request.result.city.create", "request.result.city.unregister", "request.result.session.create", "request.result.session.message", "request.result.session.submit", "request.result.rig.create", "request.failed", "rig.provision.progress", "city.created", "city.unregister_requested", "order.fired", "order.completed", "order.failed", "order.suppressed", "order.skipped", "provider.swapped", "worker.operation", "project.identity.stamped", "supervisor.fs_pressure.skipped_tick", "molecule.resolved", "supervisor.started", "supervisor.shutdown_requested", "supervisor.request", "extmsg.bound", "extmsg.unbound", "extmsg.group_created", "extmsg.adapter_added", "extmsg.adapter_removed", "extmsg.inbound", "extmsg.outbound", "extmsg.outbound_channel_mismatch", "webhook.received", "webhook.rejected", "events.rotated", "gc.store.maintenance.done", "gc.store.maintenance.failed", "gc.store.disk_warn", "gc.store.disk_critical", "backend.credential_resolved", "emergency.signaled", "emergency.acked", "beads.conditional_writes.degraded", "beads.blocked.recomputed", "storage.binding.converged", "storage.binding.genesis", "storage.binding.unconverged", "storage.binding.uncheckable", "storage.binding.not_configured" ] }, "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope custom", "type": "object" }, "TypedTaggedEventStreamEnvelopeEmergencyAcked": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/Record" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "emergency.acked", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope emergency.acked", "type": "object" }, "TypedTaggedEventStreamEnvelopeEmergencySignaled": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/Record" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "emergency.signaled", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope emergency.signaled", "type": "object" }, "TypedTaggedEventStreamEnvelopeEventsRotated": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/RotatedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "events.rotated", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope events.rotated", "type": "object" }, "TypedTaggedEventStreamEnvelopeExecutionClaimWindowExpired": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/ExecutionClaimWindowExpiredPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "execution.claim_window_expired", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope execution.claim_window_expired", "type": "object" }, "TypedTaggedEventStreamEnvelopeExecutionRunAnchored": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "execution.run_anchored", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope execution.run_anchored", "type": "object" }, "TypedTaggedEventStreamEnvelopeExecutionStepCompleted": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "execution.step_completed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope execution.step_completed", "type": "object" }, "TypedTaggedEventStreamEnvelopeExecutionStepDefined": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "execution.step_defined", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope execution.step_defined", "type": "object" }, "TypedTaggedEventStreamEnvelopeExecutionStepStalled": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/ExecutionStepStalledPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "execution.step_stalled", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope execution.step_stalled", "type": "object" }, "TypedTaggedEventStreamEnvelopeExecutionStepStarted": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "execution.step_started", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope execution.step_started", "type": "object" }, "TypedTaggedEventStreamEnvelopeExecutionWorkAssociated": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "execution.work_associated", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope execution.work_associated", "type": "object" }, "TypedTaggedEventStreamEnvelopeExtmsgAdapterAdded": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/AdapterEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "extmsg.adapter_added", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope extmsg.adapter_added", "type": "object" }, "TypedTaggedEventStreamEnvelopeExtmsgAdapterRemoved": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/AdapterEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "extmsg.adapter_removed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope extmsg.adapter_removed", "type": "object" }, "TypedTaggedEventStreamEnvelopeExtmsgBound": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/BoundEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "extmsg.bound", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope extmsg.bound", "type": "object" }, "TypedTaggedEventStreamEnvelopeExtmsgGroupCreated": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/GroupCreatedEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "extmsg.group_created", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope extmsg.group_created", "type": "object" }, "TypedTaggedEventStreamEnvelopeExtmsgInbound": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/InboundEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "extmsg.inbound", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope extmsg.inbound", "type": "object" }, "TypedTaggedEventStreamEnvelopeExtmsgOutbound": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/OutboundEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "extmsg.outbound", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope extmsg.outbound", "type": "object" }, "TypedTaggedEventStreamEnvelopeExtmsgOutboundChannelMismatch": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/OutboundChannelMismatchPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "extmsg.outbound_channel_mismatch", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope extmsg.outbound_channel_mismatch", "type": "object" }, "TypedTaggedEventStreamEnvelopeExtmsgUnbound": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/UnboundEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "extmsg.unbound", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope extmsg.unbound", "type": "object" }, "TypedTaggedEventStreamEnvelopeGcStoreDiskCritical": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/StoreDiskCriticalPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "gc.store.disk_critical", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope gc.store.disk_critical", "type": "object" }, "TypedTaggedEventStreamEnvelopeGcStoreDiskWarn": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/StoreDiskWarnPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "gc.store.disk_warn", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope gc.store.disk_warn", "type": "object" }, "TypedTaggedEventStreamEnvelopeGcStoreMaintenanceDone": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/StoreMaintenanceDonePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "gc.store.maintenance.done", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope gc.store.maintenance.done", "type": "object" }, "TypedTaggedEventStreamEnvelopeGcStoreMaintenanceFailed": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/StoreMaintenanceFailedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "gc.store.maintenance.failed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope gc.store.maintenance.failed", "type": "object" }, "TypedTaggedEventStreamEnvelopeHookClaimReclaimedStale": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/HookClaimReclaimedStalePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "hook.claim.reclaimed_stale", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope hook.claim.reclaimed_stale", "type": "object" }, "TypedTaggedEventStreamEnvelopeMailArchived": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/MailEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "mail.archived", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope mail.archived", "type": "object" }, "TypedTaggedEventStreamEnvelopeMailDeleted": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/MailEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "mail.deleted", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope mail.deleted", "type": "object" }, "TypedTaggedEventStreamEnvelopeMailMarkedRead": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/MailEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "mail.marked_read", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope mail.marked_read", "type": "object" }, "TypedTaggedEventStreamEnvelopeMailMarkedUnread": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/MailEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "mail.marked_unread", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope mail.marked_unread", "type": "object" }, "TypedTaggedEventStreamEnvelopeMailRead": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/MailEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "mail.read", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope mail.read", "type": "object" }, "TypedTaggedEventStreamEnvelopeMailReplied": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/MailEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "mail.replied", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope mail.replied", "type": "object" }, "TypedTaggedEventStreamEnvelopeMailSent": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/MailEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "mail.sent", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope mail.sent", "type": "object" }, "TypedTaggedEventStreamEnvelopeMoleculeResolved": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/MoleculeResolvedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "molecule.resolved", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope molecule.resolved", "type": "object" }, "TypedTaggedEventStreamEnvelopeOrderCompleted": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "order.completed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope order.completed", "type": "object" }, "TypedTaggedEventStreamEnvelopeOrderFailed": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "order.failed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope order.failed", "type": "object" }, "TypedTaggedEventStreamEnvelopeOrderFired": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "order.fired", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope order.fired", "type": "object" }, "TypedTaggedEventStreamEnvelopeOrderSkipped": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/OrderSkippedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "order.skipped", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope order.skipped", "type": "object" }, "TypedTaggedEventStreamEnvelopeOrderSuppressed": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/OrderSuppressedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "order.suppressed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope order.suppressed", "type": "object" }, "TypedTaggedEventStreamEnvelopeProjectIdentityStamped": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/ProjectIdentityStampedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "project.identity.stamped", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope project.identity.stamped", "type": "object" }, "TypedTaggedEventStreamEnvelopeProviderSwapped": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "provider.swapped", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope provider.swapped", "type": "object" }, "TypedTaggedEventStreamEnvelopeRequestFailed": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/RequestFailedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "request.failed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope request.failed", "type": "object" }, "TypedTaggedEventStreamEnvelopeRequestResultCityCreate": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/CityCreateSucceededPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "request.result.city.create", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope request.result.city.create", "type": "object" }, "TypedTaggedEventStreamEnvelopeRequestResultCityUnregister": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/CityUnregisterSucceededPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "request.result.city.unregister", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope request.result.city.unregister", "type": "object" }, "TypedTaggedEventStreamEnvelopeRequestResultRigCreate": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/RigCreateSucceededPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "request.result.rig.create", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope request.result.rig.create", "type": "object" }, "TypedTaggedEventStreamEnvelopeRequestResultSessionCreate": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionCreateSucceededPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "request.result.session.create", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope request.result.session.create", "type": "object" }, "TypedTaggedEventStreamEnvelopeRequestResultSessionMessage": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionMessageSucceededPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "request.result.session.message", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope request.result.session.message", "type": "object" }, "TypedTaggedEventStreamEnvelopeRequestResultSessionSubmit": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionSubmitSucceededPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "request.result.session.submit", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope request.result.session.submit", "type": "object" }, "TypedTaggedEventStreamEnvelopeRigProvisionProgress": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/RigProvisionProgressPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "rig.provision.progress", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope rig.provision.progress", "type": "object" }, "TypedTaggedEventStreamEnvelopeSessionColdStartTimeout": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.cold_start_timeout", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope session.cold_start_timeout", "type": "object" }, "TypedTaggedEventStreamEnvelopeSessionCrashed": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionLifecyclePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.crashed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope session.crashed", "type": "object" }, "TypedTaggedEventStreamEnvelopeSessionDemandClaimDivergence": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionDemandClaimDivergencePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.demand_claim_divergence", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope session.demand_claim_divergence", "type": "object" }, "TypedTaggedEventStreamEnvelopeSessionDrainAckedWithAssignedWork": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionDrainAckedWithAssignedWorkPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.drain_acked_with_assigned_work", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope session.drain_acked_with_assigned_work", "type": "object" }, "TypedTaggedEventStreamEnvelopeSessionDrainFenceUnavailable": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionLifecyclePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.drain_fence_unavailable", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope session.drain_fence_unavailable", "type": "object" }, "TypedTaggedEventStreamEnvelopeSessionDrainStopEscalated": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionLifecyclePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.drain_stop_escalated", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope session.drain_stop_escalated", "type": "object" }, "TypedTaggedEventStreamEnvelopeSessionDraining": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.draining", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope session.draining", "type": "object" }, "TypedTaggedEventStreamEnvelopeSessionIdleKilled": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.idle_killed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope session.idle_killed", "type": "object" }, "TypedTaggedEventStreamEnvelopeSessionMaxAgeKilled": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.max_age_killed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope session.max_age_killed", "type": "object" }, "TypedTaggedEventStreamEnvelopeSessionPending": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionPendingPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.pending", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope session.pending", "type": "object" }, "TypedTaggedEventStreamEnvelopeSessionPendingCleared": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionPendingClearedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.pending_cleared", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope session.pending_cleared", "type": "object" }, "TypedTaggedEventStreamEnvelopeSessionPoolSlotRetiredAtDrainDeadline": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionPoolSlotRetiredAtDrainDeadlinePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.pool_slot_retired_at_drain_deadline", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope session.pool_slot_retired_at_drain_deadline", "type": "object" }, "TypedTaggedEventStreamEnvelopeSessionQuarantined": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.quarantined", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope session.quarantined", "type": "object" }, "TypedTaggedEventStreamEnvelopeSessionResetStalled": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionResetStalledPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.reset_stalled", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope session.reset_stalled", "type": "object" }, "TypedTaggedEventStreamEnvelopeSessionStopped": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionLifecyclePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.stopped", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope session.stopped", "type": "object" }, "TypedTaggedEventStreamEnvelopeSessionStranded": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionStrandedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.stranded", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope session.stranded", "type": "object" }, "TypedTaggedEventStreamEnvelopeSessionSuspended": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.suspended", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope session.suspended", "type": "object" }, "TypedTaggedEventStreamEnvelopeSessionUndrained": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.undrained", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope session.undrained", "type": "object" }, "TypedTaggedEventStreamEnvelopeSessionUnknownState": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionUnknownStatePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.unknown_state", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope session.unknown_state", "type": "object" }, "TypedTaggedEventStreamEnvelopeSessionUpdated": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.updated", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope session.updated", "type": "object" }, "TypedTaggedEventStreamEnvelopeSessionWakeRefused": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionWakeRefusedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.wake_refused", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope session.wake_refused", "type": "object" }, "TypedTaggedEventStreamEnvelopeSessionWoke": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/NoPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.woke", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope session.woke", "type": "object" }, "TypedTaggedEventStreamEnvelopeSessionWorkQueryFailed": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SessionLifecyclePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "session.work_query_failed", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope session.work_query_failed", "type": "object" }, "TypedTaggedEventStreamEnvelopeStorageBindingConverged": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/StorageBindingOutcomePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "storage.binding.converged", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope storage.binding.converged", "type": "object" }, "TypedTaggedEventStreamEnvelopeStorageBindingGenesis": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/StorageBindingOutcomePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "storage.binding.genesis", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope storage.binding.genesis", "type": "object" }, "TypedTaggedEventStreamEnvelopeStorageBindingNotConfigured": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/StorageBindingOutcomePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "storage.binding.not_configured", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope storage.binding.not_configured", "type": "object" }, "TypedTaggedEventStreamEnvelopeStorageBindingUncheckable": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/StorageBindingOutcomePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "storage.binding.uncheckable", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope storage.binding.uncheckable", "type": "object" }, "TypedTaggedEventStreamEnvelopeStorageBindingUnconverged": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/StorageBindingOutcomePayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "storage.binding.unconverged", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope storage.binding.unconverged", "type": "object" }, "TypedTaggedEventStreamEnvelopeSupervisorFsPressureSkippedTick": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SupervisorFSPressureSkippedTickPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "supervisor.fs_pressure.skipped_tick", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope supervisor.fs_pressure.skipped_tick", "type": "object" }, "TypedTaggedEventStreamEnvelopeSupervisorRequest": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SupervisorRequestPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "supervisor.request", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope supervisor.request", "type": "object" }, "TypedTaggedEventStreamEnvelopeSupervisorShutdownRequested": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SupervisorShutdownPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "supervisor.shutdown_requested", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope supervisor.shutdown_requested", "type": "object" }, "TypedTaggedEventStreamEnvelopeSupervisorStarted": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/SupervisorStartedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "supervisor.started", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope supervisor.started", "type": "object" }, "TypedTaggedEventStreamEnvelopeWebhookReceived": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/WebhookReceivedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "webhook.received", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope webhook.received", "type": "object" }, "TypedTaggedEventStreamEnvelopeWebhookRejected": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/WebhookRejectedPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "webhook.rejected", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope webhook.rejected", "type": "object" }, "TypedTaggedEventStreamEnvelopeWorkerOperation": { "additionalProperties": false, "properties": { "actor": { "type": "string" }, "city": { "type": "string" }, "depends_on_step_ids": { "items": { "type": "string" }, "type": "array" }, "message": { "type": "string" }, "payload": { "$ref": "#/components/schemas/WorkerOperationEventPayload" }, "run_id": { "type": "string" }, "seq": { "format": "int64", "minimum": 0, "type": "integer" }, "session_id": { "type": "string" }, "step_id": { "type": "string" }, "subject": { "type": "string" }, "ts": { "format": "date-time", "type": "string" }, "type": { "const": "worker.operation", "type": "string" }, "workflow": { "$ref": "#/components/schemas/WorkflowEventProjection" } }, "required": [ "seq", "type", "ts", "actor", "payload", "city" ], "title": "TypedTaggedEventStreamEnvelope worker.operation", "type": "object" }, "UnboundEventPayload": { "additionalProperties": false, "properties": { "count": { "format": "int64", "type": "integer" }, "session_id": { "type": "string" } }, "required": [ "session_id", "count" ], "type": "object" }, "UsageBody": { "additionalProperties": false, "properties": { "available": { "description": "True when this city is configured to record local usage estimates.", "type": "boolean" }, "last_24h": { "$ref": "#/components/schemas/UsageTotals", "description": "Usage over the trailing 24 hours; a rolling window that survives the local-midnight reset of today. Omitted by servers or proxies that predate the field." }, "observed_from": { "description": "RFC3339 timestamp of the oldest fact included in this bounded read.", "type": "string" }, "partial": { "description": "True when the bounded reader skipped history or malformed records.", "type": "boolean" }, "partial_reasons": { "description": "Path-sanitized reasons the aggregate may be incomplete.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "recent": { "$ref": "#/components/schemas/UsageTotals", "description": "Usage in the trailing recent window." }, "recent_by_session": { "description": "Recent model usage per session, largest token volume first.", "items": { "$ref": "#/components/schemas/UsageSessionRecent" }, "type": [ "array", "null" ] }, "recent_window_secs": { "description": "Length of the recent window in seconds.", "format": "int64", "type": "integer" }, "recording": { "description": "True when new facts are currently being written to the local estimate log.", "type": "boolean" }, "source": { "description": "Source of this usage reading.", "enum": [ "local_estimate", "unavailable" ], "type": "string" }, "today": { "$ref": "#/components/schemas/UsageTotals", "description": "Usage since local midnight on the supervisor host." }, "updated_at": { "description": "RFC3339 time at which the aggregate was built.", "type": "string" } }, "required": [ "available", "recording", "source", "today", "recent", "recent_window_secs", "updated_at" ], "type": "object" }, "UsageSessionRecent": { "additionalProperties": false, "properties": { "cache_creation_tokens": { "description": "Prompt-cache creation tokens in the window.", "format": "int64", "type": "integer" }, "cache_read_tokens": { "description": "Prompt-cache read tokens in the window.", "format": "int64", "type": "integer" }, "cost_usd_estimate": { "description": "List-price estimate for the window.", "format": "double", "type": "number" }, "input_tokens": { "description": "Prompt tokens in the window.", "format": "int64", "type": "integer" }, "output_tokens": { "description": "Completion tokens in the window.", "format": "int64", "type": "integer" }, "session": { "description": "Session (worker) name the facts were attributed to.", "type": "string" }, "session_id": { "description": "Session bead id, when attributed.", "type": "string" }, "unpriced": { "description": "Facts in this window whose price is unknown.", "format": "int64", "type": "integer" } }, "required": [ "session", "input_tokens", "output_tokens", "cache_read_tokens", "cache_creation_tokens", "cost_usd_estimate", "unpriced" ], "type": "object" }, "UsageTotals": { "additionalProperties": false, "properties": { "cache_creation_tokens": { "description": "Prompt-cache creation tokens.", "format": "int64", "type": "integer" }, "cache_read_tokens": { "description": "Prompt-cache read tokens.", "format": "int64", "type": "integer" }, "compute_facts": { "description": "Compute (wall-clock) facts in the window.", "format": "int64", "type": "integer" }, "cost_usd_estimate": { "description": "List-price estimate; decision-support only, never an authoritative charge.", "format": "double", "type": "number" }, "input_tokens": { "description": "Prompt tokens.", "format": "int64", "type": "integer" }, "invocations": { "description": "Model facts (LLM invocations) in the window.", "format": "int64", "type": "integer" }, "output_tokens": { "description": "Completion tokens.", "format": "int64", "type": "integer" }, "unpriced": { "description": "Facts with unknown pricing; their cost is not included in the estimate.", "format": "int64", "type": "integer" }, "wall_seconds": { "description": "Compute wall-clock seconds.", "format": "double", "type": "number" } }, "required": [ "invocations", "compute_facts", "input_tokens", "output_tokens", "cache_read_tokens", "cache_creation_tokens", "wall_seconds", "cost_usd_estimate", "unpriced" ], "type": "object" }, "WaitListBody": { "additionalProperties": false, "properties": { "capped": { "description": "True when the lookup hit the per-scope cap and the list is partial.", "type": "boolean" }, "partial": { "description": "True when a backing store returned a partial result and the list may be incomplete.", "type": "boolean" }, "partial_errors": { "description": "Human-readable errors from the degraded wait lookup when partial is true.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "waits": { "description": "Durable session waits, newest first.", "items": { "$ref": "#/components/schemas/WaitView" }, "type": [ "array", "null" ] } }, "required": [ "waits", "capped" ], "type": "object" }, "WaitView": { "additionalProperties": false, "properties": { "created_at": { "description": "Bead creation time (RFC3339, UTC).", "type": "string" }, "delivery_attempt": { "description": "Current delivery attempt counter.", "type": "string" }, "dep_ids": { "description": "Dependency bead IDs the wait watches.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "dep_mode": { "description": "all or any.", "type": "string" }, "expires_at": { "description": "Raw RFC3339 expiry string, kept verbatim.", "type": "string" }, "id": { "description": "Wait bead ID.", "type": "string" }, "kind": { "description": "Wait kind, e.g. deps.", "type": "string" }, "labels": { "description": "Bead labels.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "note": { "description": "Reminder text delivered when the wait is satisfied.", "type": "string" }, "nudge_id": { "description": "Shadow wait-nudge ID once dispatched.", "type": "string" }, "registered_epoch": { "description": "Session continuation epoch at registration.", "type": "string" }, "session_id": { "description": "Session bead ID the wait is registered against.", "type": "string" }, "session_name": { "description": "Runtime session name recorded at registration.", "type": "string" }, "state": { "description": "Wait lifecycle state (pending/ready/closed/...).", "type": "string" }, "status": { "description": "Persisted bead status (open/closed).", "type": "string" } }, "required": [ "id", "session_id", "kind", "state", "status" ], "type": "object" }, "WebhookReceivedPayload": { "additionalProperties": false, "properties": { "body_size": { "description": "Raw request body size in bytes (never the body itself).", "format": "int64", "type": "integer" }, "dedup_id": { "description": "Provider delivery id used for dedup (or a body hash when the scheme carries none).", "type": "string" }, "deduped": { "description": "True when this delivery was a duplicate and was NOT dispatched.", "type": "boolean" }, "dispatched": { "description": "True when an order was launched for this delivery.", "type": "boolean" }, "event_type": { "description": "Provider event type surfaced by the scheme (e.g. pull_request).", "type": "string" }, "matched": { "description": "True when a [[webhook.rule]] matched the delivery.", "type": "boolean" }, "order": { "description": "Target order name when a rule matched.", "type": "string" }, "rig": { "description": "Target rig when the matched rule scoped one.", "type": "string" }, "rule_index": { "description": "Matched rule index, or -1 when no rule matched.", "format": "int64", "type": "integer" }, "scheme": { "description": "Verifier scheme (github-hmac-sha256, slack-v0, …).", "type": "string" }, "scoped_name": { "description": "Rig-qualified name of the fired order.", "type": "string" }, "tracking_id": { "description": "Tracking bead id for the dispatch, when fired.", "type": "string" }, "webhook": { "description": "Configured webhook name that received the delivery.", "type": "string" } }, "required": [ "webhook", "deduped", "matched", "dispatched", "rule_index", "body_size" ], "type": "object" }, "WebhookRejectedPayload": { "additionalProperties": false, "properties": { "body_size": { "description": "Raw request body size in bytes, when the body was read.", "format": "int64", "type": "integer" }, "dedup_id": { "description": "Provider delivery id, when known.", "type": "string" }, "event_type": { "description": "Provider event type, when known at the rejection point.", "type": "string" }, "reason": { "description": "Rejection reason enum (perimeter_denied, read_only, rate_limited, operator_fault, verify_failed, bad_payload, dispatch_refused, …).", "type": "string" }, "scheme": { "description": "Verifier scheme, when the webhook resolved.", "type": "string" }, "status": { "description": "HTTP status returned to the sender.", "format": "int64", "type": "integer" }, "webhook": { "description": "Configured webhook name (empty only for unresolved routes, which are not evented).", "type": "string" } }, "required": [ "webhook", "reason" ], "type": "object" }, "WorkerOperationEventPayload": { "additionalProperties": false, "properties": { "agent_name": { "description": "Qualified agent identity (best-effort, absent if the session has no agent_name metadata or alias).", "type": "string" }, "bead_id": { "description": "Work bead this operation is acting on (best-effort, may be absent for non-bead-scoped ops).", "type": "string" }, "cache_creation_tokens": { "description": "Input tokens written into the prompt cache (best-effort, currently always absent).", "format": "int64", "type": "integer" }, "cache_read_tokens": { "description": "Cached input tokens read (best-effort, currently always absent).", "format": "int64", "type": "integer" }, "completion_tokens": { "description": "Output tokens (best-effort, currently always absent).", "format": "int64", "type": "integer" }, "cost_usd_estimate": { "description": "Estimated invocation cost in USD (best-effort, currently always absent; see #1255 for pricing seam).", "format": "double", "type": "number" }, "delivered": { "type": "boolean" }, "duration_ms": { "format": "int64", "type": "integer" }, "error": { "type": "string" }, "finished_at": { "format": "date-time", "type": "string" }, "latency_ms": { "description": "LLM invocation wall-clock latency (best-effort, currently always absent — no source).", "format": "int64", "type": "integer" }, "model": { "description": "LLM model identifier (best-effort, may be absent until follow-up wiring lands).", "type": "string" }, "op_id": { "type": "string" }, "operation": { "type": "string" }, "prompt_sha": { "description": "SHA-256 of the rendered prompt (best-effort, currently always absent; #1256 follow-up).", "type": "string" }, "prompt_tokens": { "description": "Non-cached input tokens (best-effort, currently always absent; treat zero as 'not measured', not 'free').", "format": "int64", "type": "integer" }, "prompt_version": { "description": "Template version frontmatter (best-effort, currently always absent; #1256 follow-up).", "type": "string" }, "provider": { "type": "string" }, "queued": { "type": "boolean" }, "result": { "type": "string" }, "run_id": { "description": "Run-root identifier for rolling this operation up to a workflow/molecule/chat run (best-effort).", "type": "string" }, "session_id": { "type": "string" }, "session_name": { "type": "string" }, "started_at": { "format": "date-time", "type": "string" }, "template": { "type": "string" }, "transport": { "type": "string" }, "unpriced": { "description": "True when tokens were observed but no price resolved (best-effort tri-state; absent = not evaluated).", "type": "boolean" } }, "required": [ "op_id", "operation", "result", "started_at", "finished_at", "duration_ms" ], "type": "object" }, "WorkflowAttemptSummary": { "additionalProperties": false, "properties": { "active_attempt": { "format": "int64", "type": "integer" }, "attempt_count": { "format": "int64", "type": "integer" }, "max_attempts": { "format": "int64", "type": "integer" } }, "required": [ "attempt_count", "active_attempt" ], "type": "object" }, "WorkflowBeadResponse": { "additionalProperties": false, "properties": { "assignee": { "type": "string" }, "attempt": { "format": "int64", "type": "integer" }, "id": { "type": "string" }, "kind": { "type": "string" }, "logical_bead_id": { "type": "string" }, "metadata": { "additionalProperties": { "type": "string" }, "type": "object" }, "scope_ref": { "type": "string" }, "status": { "type": "string" }, "step_ref": { "type": "string" }, "title": { "type": "string" } }, "required": [ "id", "title", "status", "kind", "metadata" ], "type": "object" }, "WorkflowDeleteResponse": { "additionalProperties": false, "properties": { "closed": { "description": "Number of beads closed.", "format": "int64", "type": "integer" }, "deleted": { "description": "Number of beads deleted.", "format": "int64", "type": "integer" }, "partial": { "description": "True when one or more teardown steps failed; Closed/Deleted still reflect what succeeded.", "type": "boolean" }, "partial_errors": { "description": "Human-readable errors from failed teardown steps.", "items": { "type": "string" }, "type": [ "array", "null" ] }, "workflow_id": { "description": "Workflow ID.", "type": "string" } }, "required": [ "workflow_id", "closed", "deleted" ], "type": "object" }, "WorkflowDepResponse": { "additionalProperties": false, "properties": { "from": { "type": "string" }, "kind": { "type": "string" }, "to": { "type": "string" } }, "required": [ "from", "to" ], "type": "object" }, "WorkflowEventProjection": { "additionalProperties": false, "properties": { "attempt_summary": { "$ref": "#/components/schemas/WorkflowAttemptSummary" }, "bead": { "$ref": "#/components/schemas/WorkflowBeadResponse" }, "changed_fields": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "event_seq": { "format": "int64", "minimum": 0, "type": "integer" }, "event_ts": { "type": "string" }, "event_type": { "type": "string" }, "logical_node_id": { "type": "string" }, "requires_resync": { "type": "boolean" }, "root_bead_id": { "type": "string" }, "root_store_ref": { "type": "string" }, "scope_kind": { "type": "string" }, "scope_ref": { "type": "string" }, "type": { "type": "string" }, "watch_generation": { "type": "string" }, "workflow_id": { "type": "string" }, "workflow_seq": { "format": "int64", "minimum": 0, "type": "integer" } }, "required": [ "type", "workflow_id", "root_bead_id", "root_store_ref", "scope_kind", "scope_ref", "watch_generation", "event_seq", "workflow_seq", "event_ts", "event_type", "bead", "changed_fields", "logical_node_id" ], "type": "object" }, "WorkflowSnapshotResponse": { "additionalProperties": false, "properties": { "beads": { "items": { "$ref": "#/components/schemas/WorkflowBeadResponse" }, "type": [ "array", "null" ] }, "deps": { "items": { "$ref": "#/components/schemas/WorkflowDepResponse" }, "type": [ "array", "null" ] }, "logical_edges": { "items": { "$ref": "#/components/schemas/WorkflowDepResponse" }, "type": [ "array", "null" ] }, "logical_nodes": { "items": { "$ref": "#/components/schemas/LogicalNode" }, "type": [ "array", "null" ] }, "partial": { "type": "boolean" }, "resolved_root_store": { "type": "string" }, "root_bead_id": { "type": "string" }, "root_store_ref": { "type": "string" }, "scope_groups": { "items": { "$ref": "#/components/schemas/ScopeGroup" }, "type": [ "array", "null" ] }, "scope_kind": { "type": "string" }, "scope_ref": { "type": "string" }, "snapshot_event_seq": { "format": "int64", "minimum": 0, "type": "integer" }, "snapshot_version": { "format": "int64", "minimum": 0, "type": "integer" }, "stores_scanned": { "items": { "type": "string" }, "type": [ "array", "null" ] }, "workflow_id": { "type": "string" } }, "required": [ "workflow_id", "root_bead_id", "root_store_ref", "scope_kind", "scope_ref", "beads", "deps", "logical_nodes", "logical_edges", "scope_groups", "partial", "resolved_root_store", "stores_scanned", "snapshot_version" ], "type": "object" }, "WorkspaceResponse": { "additionalProperties": false, "properties": { "declared_name": { "type": "string" }, "declared_prefix": { "type": "string" }, "max_active_sessions": { "format": "int64", "type": "integer" }, "name": { "type": "string" }, "prefix": { "type": "string" }, "provider": { "type": "string" }, "session_template": { "type": "string" }, "suspended": { "type": "boolean" } }, "required": [ "name", "suspended" ], "type": "object" } } }, "info": { "title": "Gas City Supervisor API", "version": "0.1.0" }, "openapi": "3.1.0", "paths": { "/health": { "get": { "operationId": "get-health", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupervisorHealthOutputBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get health" } }, "/v0/cities": { "get": { "operationId": "get-v0-cities", "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupervisorCitiesOutputBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 cities" } }, "/v0/city": { "post": { "operationId": "post-v0-city", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "Idempotency key for safe retries.", "in": "header", "name": "Idempotency-Key", "schema": { "description": "Idempotency key for safe retries.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CityCreateRequest" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AsyncAcceptedResponse" } } }, "description": "Accepted", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city" } }, "/v0/city/{cityName}": { "get": { "operationId": "get-v0-city-by-city-name", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CityGetResponse" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name" }, "patch": { "operationId": "patch-v0-city-by-city-name", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/CityPatchInputBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Patch v0 city by city name" } }, "/v0/city/{cityName}/agent/{base}": { "delete": { "operationId": "delete-v0-city-by-city-name-agent-by-base", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Agent name (unqualified).", "in": "path", "name": "base", "required": true, "schema": { "description": "Agent name (unqualified).", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Delete v0 city by city name agent by base" }, "get": { "operationId": "get-v0-city-by-city-name-agent-by-base", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Agent name (unqualified, no rig).", "in": "path", "name": "base", "required": true, "schema": { "description": "Agent name (unqualified, no rig).", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentResponse" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name agent by base" }, "patch": { "operationId": "patch-v0-city-by-city-name-agent-by-base", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Agent name (unqualified).", "in": "path", "name": "base", "required": true, "schema": { "description": "Agent name (unqualified).", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentUpdateInputBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Patch v0 city by city name agent by base" } }, "/v0/city/{cityName}/agent/{base}/output": { "get": { "operationId": "get-v0-city-by-city-name-agent-by-base-output", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Number of recent compaction segments to return. This API parameter keeps compaction-segment semantics even though gc session logs --tail counts displayed transcript entries. Omit for the endpoint default (usually 1); 0 returns all segments; N\u003e0 returns the last N.", "explode": false, "in": "query", "name": "tail", "schema": { "description": "Number of recent compaction segments to return. This API parameter keeps compaction-segment semantics even though gc session logs --tail counts displayed transcript entries. Omit for the endpoint default (usually 1); 0 returns all segments; N\u003e0 returns the last N.", "type": "string" } }, { "description": "Agent base name.", "in": "path", "name": "base", "required": true, "schema": { "description": "Agent base name.", "type": "string" } }, { "description": "Message UUID cursor for loading older messages.", "explode": false, "in": "query", "name": "before", "schema": { "description": "Message UUID cursor for loading older messages.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentOutputResponse" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name agent by base output" } }, "/v0/city/{cityName}/agent/{base}/output/stream": { "get": { "description": "Server-Sent Events stream of agent output (session log tail or tmux pane polling).", "operationId": "stream-agent-output", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Agent base name.", "in": "path", "name": "base", "required": true, "schema": { "description": "Agent base name.", "type": "string" } } ], "responses": { "200": { "content": { "text/event-stream": { "schema": { "description": "Each oneOf object represents one possible SSE message.", "items": { "oneOf": [ { "properties": { "data": { "$ref": "#/components/schemas/HeartbeatEvent" }, "event": { "const": "heartbeat", "description": "The event name.", "type": "string" }, "id": { "description": "The event ID.", "type": "integer" }, "retry": { "description": "The retry time in milliseconds.", "type": "integer" } }, "required": [ "data", "event" ], "title": "Event heartbeat", "type": "object" }, { "properties": { "data": { "$ref": "#/components/schemas/AgentOutputResponse" }, "event": { "const": "turn", "description": "The event name.", "type": "string" }, "id": { "description": "The event ID.", "type": "integer" }, "retry": { "description": "The retry time in milliseconds.", "type": "integer" } }, "required": [ "data", "event" ], "title": "Event turn", "type": "object" } ] }, "title": "Server Sent Events", "type": "array" } } }, "description": "OK", "headers": { "GC-Agent-Status": { "description": "Agent runtime status at the time streaming began. Emitted as \"stopped\" when the agent is not running (the stream then serves replayed transcript from the session log).", "schema": { "description": "Agent runtime status at the time streaming began. Emitted as \"stopped\" when the agent is not running (the stream then serves replayed transcript from the session log).", "type": "string" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Stream agent output in real time" } }, "/v0/city/{cityName}/agent/{base}/{action}": { "post": { "operationId": "post-v0-city-by-city-name-agent-by-base-by-action", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Agent name (unqualified).", "in": "path", "name": "base", "required": true, "schema": { "description": "Agent name (unqualified).", "type": "string" } }, { "description": "Action to perform.", "in": "path", "name": "action", "required": true, "schema": { "description": "Action to perform.", "enum": [ "suspend", "resume" ], "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name agent by base by action" } }, "/v0/city/{cityName}/agent/{dir}/{base}": { "delete": { "operationId": "delete-v0-city-by-city-name-agent-by-dir-by-base", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Agent directory (rig name).", "in": "path", "name": "dir", "required": true, "schema": { "description": "Agent directory (rig name).", "type": "string" } }, { "description": "Agent base name.", "in": "path", "name": "base", "required": true, "schema": { "description": "Agent base name.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Delete v0 city by city name agent by dir by base" }, "get": { "operationId": "get-v0-city-by-city-name-agent-by-dir-by-base", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Agent directory (rig name).", "in": "path", "name": "dir", "required": true, "schema": { "description": "Agent directory (rig name).", "type": "string" } }, { "description": "Agent base name.", "in": "path", "name": "base", "required": true, "schema": { "description": "Agent base name.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentResponse" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name agent by dir by base" }, "patch": { "operationId": "patch-v0-city-by-city-name-agent-by-dir-by-base", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Agent directory (rig name).", "in": "path", "name": "dir", "required": true, "schema": { "description": "Agent directory (rig name).", "type": "string" } }, { "description": "Agent base name.", "in": "path", "name": "base", "required": true, "schema": { "description": "Agent base name.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentUpdateQualifiedInputBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Patch v0 city by city name agent by dir by base" } }, "/v0/city/{cityName}/agent/{dir}/{base}/output": { "get": { "operationId": "get-v0-city-by-city-name-agent-by-dir-by-base-output", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Number of recent compaction segments to return. This API parameter keeps compaction-segment semantics even though gc session logs --tail counts displayed transcript entries. Omit for the endpoint default (usually 1); 0 returns all segments; N\u003e0 returns the last N.", "explode": false, "in": "query", "name": "tail", "schema": { "description": "Number of recent compaction segments to return. This API parameter keeps compaction-segment semantics even though gc session logs --tail counts displayed transcript entries. Omit for the endpoint default (usually 1); 0 returns all segments; N\u003e0 returns the last N.", "type": "string" } }, { "description": "Agent directory (rig name).", "in": "path", "name": "dir", "required": true, "schema": { "description": "Agent directory (rig name).", "type": "string" } }, { "description": "Agent base name.", "in": "path", "name": "base", "required": true, "schema": { "description": "Agent base name.", "type": "string" } }, { "description": "Message UUID cursor for loading older messages.", "explode": false, "in": "query", "name": "before", "schema": { "description": "Message UUID cursor for loading older messages.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentOutputResponse" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name agent by dir by base output" } }, "/v0/city/{cityName}/agent/{dir}/{base}/output/stream": { "get": { "description": "Server-Sent Events stream of agent output for qualified (rig-prefixed) agent names.", "operationId": "stream-agent-output-qualified", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Agent directory (rig name).", "in": "path", "name": "dir", "required": true, "schema": { "description": "Agent directory (rig name).", "type": "string" } }, { "description": "Agent base name.", "in": "path", "name": "base", "required": true, "schema": { "description": "Agent base name.", "type": "string" } } ], "responses": { "200": { "content": { "text/event-stream": { "schema": { "description": "Each oneOf object represents one possible SSE message.", "items": { "oneOf": [ { "properties": { "data": { "$ref": "#/components/schemas/HeartbeatEvent" }, "event": { "const": "heartbeat", "description": "The event name.", "type": "string" }, "id": { "description": "The event ID.", "type": "integer" }, "retry": { "description": "The retry time in milliseconds.", "type": "integer" } }, "required": [ "data", "event" ], "title": "Event heartbeat", "type": "object" }, { "properties": { "data": { "$ref": "#/components/schemas/AgentOutputResponse" }, "event": { "const": "turn", "description": "The event name.", "type": "string" }, "id": { "description": "The event ID.", "type": "integer" }, "retry": { "description": "The retry time in milliseconds.", "type": "integer" } }, "required": [ "data", "event" ], "title": "Event turn", "type": "object" } ] }, "title": "Server Sent Events", "type": "array" } } }, "description": "OK", "headers": { "GC-Agent-Status": { "description": "Agent runtime status at the time streaming began. Emitted as \"stopped\" when the agent is not running (the stream then serves replayed transcript from the session log).", "schema": { "description": "Agent runtime status at the time streaming began. Emitted as \"stopped\" when the agent is not running (the stream then serves replayed transcript from the session log).", "type": "string" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Stream agent output in real time (qualified name)" } }, "/v0/city/{cityName}/agent/{dir}/{base}/{action}": { "post": { "operationId": "post-v0-city-by-city-name-agent-by-dir-by-base-by-action", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Agent directory (rig name).", "in": "path", "name": "dir", "required": true, "schema": { "description": "Agent directory (rig name).", "type": "string" } }, { "description": "Agent base name.", "in": "path", "name": "base", "required": true, "schema": { "description": "Agent base name.", "type": "string" } }, { "description": "Action to perform.", "in": "path", "name": "action", "required": true, "schema": { "description": "Action to perform.", "enum": [ "suspend", "resume" ], "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name agent by dir by base by action" } }, "/v0/city/{cityName}/agents": { "get": { "operationId": "get-v0-city-by-city-name-agents", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Event sequence number; when provided, blocks until a newer event arrives.", "explode": false, "in": "query", "name": "index", "schema": { "description": "Event sequence number; when provided, blocks until a newer event arrives.", "type": "string" } }, { "description": "How long to block waiting for changes (Go duration string, e.g. 30s). Default 30s, max 2m.", "explode": false, "in": "query", "name": "wait", "schema": { "description": "How long to block waiting for changes (Go duration string, e.g. 30s). Default 30s, max 2m.", "type": "string" } }, { "description": "Filter by pool name.", "explode": false, "in": "query", "name": "pool", "schema": { "description": "Filter by pool name.", "type": "string" } }, { "description": "Filter by rig name.", "explode": false, "in": "query", "name": "rig", "schema": { "description": "Filter by rig name.", "type": "string" } }, { "description": "Filter by running state. Omit to return all agents.", "explode": false, "in": "query", "name": "running", "schema": { "description": "Filter by running state. Omit to return all agents.", "enum": [ "true", "false" ], "type": "string" } }, { "description": "Include last output preview.", "explode": false, "in": "query", "name": "peek", "schema": { "description": "Include last output preview.", "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListBodyAgentResponse" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name agents" }, "post": { "description": "Creates an agent and waits until it is visible to immediate follow-up operations. If the agent is durably created but visibility confirmation is canceled or times out, the retryable 503/504 response includes a Retry-After header.", "operationId": "create-agent", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Idempotency key for safe retries.", "in": "header", "name": "Idempotency-Key", "schema": { "description": "Idempotency key for safe retries.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentCreateInputBody" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentCreatedOutputBody" } } }, "description": "Created", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "504": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Gateway Timeout", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Create an agent" } }, "/v0/city/{cityName}/bead/{id}": { "delete": { "description": "Closes the bead. This is a soft delete: the bead remains readable and retains its history, with status \"closed\". The API exposes no hard delete, so a caller that needs the record actually removed must not rely on this endpoint.", "operationId": "delete-v0-city-by-city-name-bead-by-id", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Bead ID.", "in": "path", "name": "id", "required": true, "schema": { "description": "Bead ID.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Delete v0 city by city name bead by ID" }, "get": { "operationId": "get-v0-city-by-city-name-bead-by-id", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Bead ID.", "in": "path", "name": "id", "required": true, "schema": { "description": "Bead ID.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Bead" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name bead by ID" }, "patch": { "operationId": "patch-v0-city-by-city-name-bead-by-id", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Bead ID.", "in": "path", "name": "id", "required": true, "schema": { "description": "Bead ID.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BeadUpdateBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Patch v0 city by city name bead by ID" } }, "/v0/city/{cityName}/bead/{id}/assign": { "post": { "operationId": "post-v0-city-by-city-name-bead-by-id-assign", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Bead ID.", "in": "path", "name": "id", "required": true, "schema": { "description": "Bead ID.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BeadAssignInputBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "additionalProperties": { "type": "string" }, "type": "object" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name bead by ID assign" } }, "/v0/city/{cityName}/bead/{id}/close": { "post": { "operationId": "post-v0-city-by-city-name-bead-by-id-close", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Bead ID.", "in": "path", "name": "id", "required": true, "schema": { "description": "Bead ID.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BeadCloseBody" } } } }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name bead by ID close" } }, "/v0/city/{cityName}/bead/{id}/deps": { "get": { "operationId": "get-v0-city-by-city-name-bead-by-id-deps", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Bead ID.", "in": "path", "name": "id", "required": true, "schema": { "description": "Bead ID.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BeadDepsResponse" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name bead by ID deps" } }, "/v0/city/{cityName}/bead/{id}/reopen": { "post": { "operationId": "post-v0-city-by-city-name-bead-by-id-reopen", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Bead ID.", "in": "path", "name": "id", "required": true, "schema": { "description": "Bead ID.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name bead by ID reopen" } }, "/v0/city/{cityName}/bead/{id}/update": { "post": { "operationId": "post-v0-city-by-city-name-bead-by-id-update", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Bead ID.", "in": "path", "name": "id", "required": true, "schema": { "description": "Bead ID.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BeadUpdateBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name bead by ID update" } }, "/v0/city/{cityName}/beads": { "get": { "description": "Results are ordered (created_at DESC, id DESC) — newest beads first. A truncated response always carries next_cursor; passing it back returns the next page in the same order. Invalid or legacy cursors are rejected with a typed 400 (invalid-cursor).", "operationId": "get-v0-city-by-city-name-beads", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Event sequence number; when provided, blocks until a newer event arrives.", "explode": false, "in": "query", "name": "index", "schema": { "description": "Event sequence number; when provided, blocks until a newer event arrives.", "type": "string" } }, { "description": "How long to block waiting for changes (Go duration string, e.g. 30s). Default 30s, max 2m.", "explode": false, "in": "query", "name": "wait", "schema": { "description": "How long to block waiting for changes (Go duration string, e.g. 30s). Default 30s, max 2m.", "type": "string" } }, { "description": "Opaque keyset pagination token from a previous response's next_cursor field. Invalid or legacy tokens are rejected with a typed 400 (invalid-cursor); re-fetch the first page.", "explode": false, "in": "query", "name": "cursor", "schema": { "description": "Opaque keyset pagination token from a previous response's next_cursor field. Invalid or legacy tokens are rejected with a typed 400 (invalid-cursor); re-fetch the first page.", "type": "string" } }, { "description": "Maximum number of results to return. Omitted or 0 = server default (100). Values above 1000 are rejected.", "explode": false, "in": "query", "name": "limit", "schema": { "default": 100, "description": "Maximum number of results to return. Omitted or 0 = server default (100). Values above 1000 are rejected.", "format": "int64", "maximum": 1000, "minimum": 0, "type": "integer" } }, { "description": "Filter by bead status.", "explode": false, "in": "query", "name": "status", "schema": { "description": "Filter by bead status.", "type": "string" } }, { "description": "Filter by bead type.", "explode": false, "in": "query", "name": "type", "schema": { "description": "Filter by bead type.", "type": "string" } }, { "description": "Filter by label.", "explode": false, "in": "query", "name": "label", "schema": { "description": "Filter by label.", "type": "string" } }, { "description": "Filter by assignee.", "explode": false, "in": "query", "name": "assignee", "schema": { "description": "Filter by assignee.", "type": "string" } }, { "description": "Filter by rig.", "explode": false, "in": "query", "name": "rig", "schema": { "description": "Filter by rig.", "type": "string" } }, { "description": "Include closed beads.", "explode": false, "in": "query", "name": "all", "schema": { "description": "Include closed beads.", "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListBodyBead" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name beads" }, "post": { "operationId": "create-bead", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Idempotency key for safe retries.", "in": "header", "name": "Idempotency-Key", "schema": { "description": "Idempotency key for safe retries.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BeadCreateInputBody" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Bead" } } }, "description": "Created", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Create a bead" } }, "/v0/city/{cityName}/beads/graph/{rootID}": { "get": { "operationId": "get-v0-city-by-city-name-beads-graph-by-root-id", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Root bead ID for the graph.", "in": "path", "name": "rootID", "required": true, "schema": { "description": "Root bead ID for the graph.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BeadGraphResponse" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name beads graph by root ID" } }, "/v0/city/{cityName}/beads/ready": { "get": { "operationId": "get-v0-city-by-city-name-beads-ready", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Event sequence number; when provided, blocks until a newer event arrives.", "explode": false, "in": "query", "name": "index", "schema": { "description": "Event sequence number; when provided, blocks until a newer event arrives.", "type": "string" } }, { "description": "How long to block waiting for changes (Go duration string, e.g. 30s). Default 30s, max 2m.", "explode": false, "in": "query", "name": "wait", "schema": { "description": "How long to block waiting for changes (Go duration string, e.g. 30s). Default 30s, max 2m.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListBodyBead" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name beads ready" } }, "/v0/city/{cityName}/config": { "get": { "operationId": "get-v0-city-by-city-name-config", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigResponse" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name config" } }, "/v0/city/{cityName}/config/defaults": { "get": { "operationId": "get-v0-city-by-city-name-config-defaults", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigResponse" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name config defaults" } }, "/v0/city/{cityName}/config/explain": { "get": { "operationId": "get-v0-city-by-city-name-config-explain", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigExplainResponse" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name config explain" } }, "/v0/city/{cityName}/config/validate": { "get": { "operationId": "get-v0-city-by-city-name-config-validate", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConfigValidateOutputBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name config validate" } }, "/v0/city/{cityName}/convoy/{id}": { "delete": { "operationId": "delete-v0-city-by-city-name-convoy-by-id", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Convoy ID.", "in": "path", "name": "id", "required": true, "schema": { "description": "Convoy ID.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Delete v0 city by city name convoy by ID" }, "get": { "operationId": "get-v0-city-by-city-name-convoy-by-id", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Convoy ID.", "in": "path", "name": "id", "required": true, "schema": { "description": "Convoy ID.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConvoyGetResponse" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name convoy by ID" } }, "/v0/city/{cityName}/convoy/{id}/add": { "post": { "operationId": "post-v0-city-by-city-name-convoy-by-id-add", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Convoy ID.", "in": "path", "name": "id", "required": true, "schema": { "description": "Convoy ID.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConvoyAddInputBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name convoy by ID add" } }, "/v0/city/{cityName}/convoy/{id}/check": { "get": { "operationId": "get-v0-city-by-city-name-convoy-by-id-check", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Convoy ID.", "in": "path", "name": "id", "required": true, "schema": { "description": "Convoy ID.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConvoyCheckResponse" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name convoy by ID check" } }, "/v0/city/{cityName}/convoy/{id}/close": { "post": { "operationId": "post-v0-city-by-city-name-convoy-by-id-close", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Convoy ID.", "in": "path", "name": "id", "required": true, "schema": { "description": "Convoy ID.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name convoy by ID close" } }, "/v0/city/{cityName}/convoy/{id}/remove": { "post": { "operationId": "post-v0-city-by-city-name-convoy-by-id-remove", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Convoy ID.", "in": "path", "name": "id", "required": true, "schema": { "description": "Convoy ID.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConvoyRemoveInputBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name convoy by ID remove" } }, "/v0/city/{cityName}/convoys": { "get": { "description": "Results are ordered (created_at DESC, id DESC) — newest convoys first. A truncated response always carries next_cursor; passing it back returns the next page in the same order. Invalid or legacy cursors are rejected with a typed 400 (invalid-cursor).", "operationId": "get-v0-city-by-city-name-convoys", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Event sequence number; when provided, blocks until a newer event arrives.", "explode": false, "in": "query", "name": "index", "schema": { "description": "Event sequence number; when provided, blocks until a newer event arrives.", "type": "string" } }, { "description": "How long to block waiting for changes (Go duration string, e.g. 30s). Default 30s, max 2m.", "explode": false, "in": "query", "name": "wait", "schema": { "description": "How long to block waiting for changes (Go duration string, e.g. 30s). Default 30s, max 2m.", "type": "string" } }, { "description": "Opaque keyset pagination token from a previous response's next_cursor field. Invalid or legacy tokens are rejected with a typed 400 (invalid-cursor); re-fetch the first page.", "explode": false, "in": "query", "name": "cursor", "schema": { "description": "Opaque keyset pagination token from a previous response's next_cursor field. Invalid or legacy tokens are rejected with a typed 400 (invalid-cursor); re-fetch the first page.", "type": "string" } }, { "description": "Maximum number of results to return. Omitted or 0 = server default (100). Values above 1000 are rejected.", "explode": false, "in": "query", "name": "limit", "schema": { "default": 100, "description": "Maximum number of results to return. Omitted or 0 = server default (100). Values above 1000 are rejected.", "format": "int64", "maximum": 1000, "minimum": 0, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListBodyBead" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name convoys" }, "post": { "operationId": "create-convoy", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Idempotency key for safe retries.", "in": "header", "name": "Idempotency-Key", "schema": { "description": "Idempotency key for safe retries.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConvoyCreateInputBody" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Bead" } } }, "description": "Created", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Create a convoy" } }, "/v0/city/{cityName}/events": { "get": { "description": "Results are ordered seq DESC — newest events first. A truncated response always carries next_cursor; passing it back returns the next page in the same order. Invalid or legacy cursors are rejected with a typed 400 (invalid-cursor).", "operationId": "get-v0-city-by-city-name-events", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Event sequence number; when provided, blocks until a newer event arrives.", "explode": false, "in": "query", "name": "index", "schema": { "description": "Event sequence number; when provided, blocks until a newer event arrives.", "type": "string" } }, { "description": "How long to block waiting for changes (Go duration string, e.g. 30s). Default 30s, max 2m.", "explode": false, "in": "query", "name": "wait", "schema": { "description": "How long to block waiting for changes (Go duration string, e.g. 30s). Default 30s, max 2m.", "type": "string" } }, { "description": "Opaque keyset pagination token from a previous response's next_cursor field. Invalid or legacy tokens are rejected with a typed 400 (invalid-cursor); re-fetch the first page.", "explode": false, "in": "query", "name": "cursor", "schema": { "description": "Opaque keyset pagination token from a previous response's next_cursor field. Invalid or legacy tokens are rejected with a typed 400 (invalid-cursor); re-fetch the first page.", "type": "string" } }, { "description": "Maximum number of results to return. Omitted or 0 = server default (100). Values above 1000 are rejected.", "explode": false, "in": "query", "name": "limit", "schema": { "default": 100, "description": "Maximum number of results to return. Omitted or 0 = server default (100). Values above 1000 are rejected.", "format": "int64", "maximum": 1000, "minimum": 0, "type": "integer" } }, { "description": "Filter by event type.", "explode": false, "in": "query", "name": "type", "schema": { "description": "Filter by event type.", "type": "string" } }, { "description": "Filter by actor.", "explode": false, "in": "query", "name": "actor", "schema": { "description": "Filter by actor.", "type": "string" } }, { "description": "Filter events since duration ago (Go duration string, e.g. 5m).", "explode": false, "in": "query", "name": "since", "schema": { "description": "Filter events since duration ago (Go duration string, e.g. 5m).", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListBodyWireEvent" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name events" }, "post": { "operationId": "emit-event", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Idempotency key for safe retries.", "in": "header", "name": "Idempotency-Key", "schema": { "description": "Idempotency key for safe retries.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventEmitRequest" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventEmitOutputBody" } } }, "description": "Created", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Emit an event" } }, "/v0/city/{cityName}/events/rotate": { "post": { "operationId": "rotate-events", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Wait for archive compression to complete before returning.", "explode": false, "in": "query", "name": "wait", "schema": { "description": "Wait for archive compression to complete before returning.", "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/EventRotateResponse" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "405": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Method Not Allowed", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Force rotate the city event log" } }, "/v0/city/{cityName}/events/stream": { "get": { "description": "Server-Sent Events stream of city events with optional workflow projections. Supports reconnection via Last-Event-ID header or after_seq query param; omitting both starts at the current city event head.", "operationId": "stream-events", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Reconnect position: only deliver events after this sequence number. Omit after_seq and Last-Event-ID to start at the current city event head.", "explode": false, "in": "query", "name": "after_seq", "schema": { "description": "Reconnect position: only deliver events after this sequence number. Omit after_seq and Last-Event-ID to start at the current city event head.", "type": "string" } }, { "description": "SSE reconnect position from the last received event ID. Omit Last-Event-ID and after_seq to start at the current city event head.", "in": "header", "name": "Last-Event-ID", "schema": { "description": "SSE reconnect position from the last received event ID. Omit Last-Event-ID and after_seq to start at the current city event head.", "type": "string" } } ], "responses": { "200": { "content": { "text/event-stream": { "schema": { "description": "Each oneOf object represents one possible SSE message.", "items": { "oneOf": [ { "properties": { "data": { "$ref": "#/components/schemas/TypedEventStreamEnvelope" }, "event": { "const": "event", "description": "The event name.", "type": "string" }, "id": { "description": "The event ID.", "type": "integer" }, "retry": { "description": "The retry time in milliseconds.", "type": "integer" } }, "required": [ "data", "event" ], "title": "Event event", "type": "object" }, { "properties": { "data": { "$ref": "#/components/schemas/HeartbeatEvent" }, "event": { "const": "heartbeat", "description": "The event name.", "type": "string" }, "id": { "description": "The event ID.", "type": "integer" }, "retry": { "description": "The retry time in milliseconds.", "type": "integer" } }, "required": [ "data", "event" ], "title": "Event heartbeat", "type": "object" } ] }, "title": "Server Sent Events", "type": "array" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Stream city events in real time" } }, "/v0/city/{cityName}/extmsg/adapters": { "delete": { "operationId": "delete-v0-city-by-city-name-extmsg-adapters", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExtMsgAdapterUnregisterInputBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Delete v0 city by city name extmsg adapters" }, "get": { "operationId": "get-v0-city-by-city-name-extmsg-adapters", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListBodyExtmsgAdapterInfo" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name extmsg adapters" }, "post": { "operationId": "register-extmsg-adapter", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Idempotency key for safe retries.", "in": "header", "name": "Idempotency-Key", "schema": { "description": "Idempotency key for safe retries.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExtMsgAdapterRegisterInputBody" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExtMsgAdapterRegisterOutputBody" } } }, "description": "Created", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Register an external messaging adapter" } }, "/v0/city/{cityName}/extmsg/bind": { "post": { "operationId": "post-v0-city-by-city-name-extmsg-bind", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExtMsgBindInputBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionBindingRecord" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name extmsg bind" } }, "/v0/city/{cityName}/extmsg/bindings": { "get": { "operationId": "get-v0-city-by-city-name-extmsg-bindings", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Session ID to list bindings for.", "explode": false, "in": "query", "name": "session_id", "schema": { "description": "Session ID to list bindings for.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListBodySessionBindingRecord" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name extmsg bindings" } }, "/v0/city/{cityName}/extmsg/groups": { "get": { "operationId": "get-v0-city-by-city-name-extmsg-groups", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Scope ID.", "explode": false, "in": "query", "name": "scope_id", "schema": { "description": "Scope ID.", "type": "string" } }, { "description": "Provider name.", "explode": false, "in": "query", "name": "provider", "schema": { "description": "Provider name.", "type": "string" } }, { "description": "Account ID.", "explode": false, "in": "query", "name": "account_id", "schema": { "description": "Account ID.", "type": "string" } }, { "description": "Conversation ID.", "explode": false, "in": "query", "name": "conversation_id", "schema": { "description": "Conversation ID.", "type": "string" } }, { "description": "Conversation kind.", "explode": false, "in": "query", "name": "kind", "schema": { "description": "Conversation kind.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConversationGroupRecord" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name extmsg groups" }, "post": { "operationId": "ensure-extmsg-group", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExtMsgGroupEnsureInputBody" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConversationGroupRecord" } } }, "description": "Created", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Ensure an external messaging group exists" } }, "/v0/city/{cityName}/extmsg/inbound": { "post": { "operationId": "post-v0-city-by-city-name-extmsg-inbound", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExtMsgInboundInputBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/InboundResult" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name extmsg inbound" } }, "/v0/city/{cityName}/extmsg/outbound": { "post": { "operationId": "post-v0-city-by-city-name-extmsg-outbound", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExtMsgOutboundInputBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OutboundResult" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name extmsg outbound" } }, "/v0/city/{cityName}/extmsg/participants": { "delete": { "operationId": "delete-v0-city-by-city-name-extmsg-participants", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExtMsgParticipantRemoveInputBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Delete v0 city by city name extmsg participants" }, "post": { "operationId": "post-v0-city-by-city-name-extmsg-participants", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExtMsgParticipantUpsertInputBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ConversationGroupParticipant" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name extmsg participants" } }, "/v0/city/{cityName}/extmsg/transcript": { "get": { "operationId": "get-v0-city-by-city-name-extmsg-transcript", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Scope ID.", "explode": false, "in": "query", "name": "scope_id", "schema": { "description": "Scope ID.", "type": "string" } }, { "description": "Provider name.", "explode": false, "in": "query", "name": "provider", "schema": { "description": "Provider name.", "type": "string" } }, { "description": "Account ID.", "explode": false, "in": "query", "name": "account_id", "schema": { "description": "Account ID.", "type": "string" } }, { "description": "Conversation ID.", "explode": false, "in": "query", "name": "conversation_id", "schema": { "description": "Conversation ID.", "type": "string" } }, { "description": "Parent conversation ID.", "explode": false, "in": "query", "name": "parent_conversation_id", "schema": { "description": "Parent conversation ID.", "type": "string" } }, { "description": "Conversation kind.", "explode": false, "in": "query", "name": "kind", "schema": { "description": "Conversation kind.", "type": "string" } }, { "description": "Return entries with sequence greater than this cursor (default 0).", "explode": false, "in": "query", "name": "after_sequence", "schema": { "description": "Return entries with sequence greater than this cursor (default 0).", "format": "int64", "type": "integer" } }, { "description": "Maximum number of entries to return (default 100, max 500).", "explode": false, "in": "query", "name": "limit", "schema": { "description": "Maximum number of entries to return (default 100, max 500).", "format": "int64", "type": "integer" } }, { "description": "Sort order by sequence: asc (oldest-first, default) or desc (newest-first).", "explode": false, "in": "query", "name": "order", "schema": { "description": "Sort order by sequence: asc (oldest-first, default) or desc (newest-first).", "enum": [ "asc", "desc" ], "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListBodyConversationTranscriptRecord" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name extmsg transcript" } }, "/v0/city/{cityName}/extmsg/transcript/ack": { "post": { "operationId": "post-v0-city-by-city-name-extmsg-transcript-ack", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExtMsgTranscriptAckInputBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name extmsg transcript ack" } }, "/v0/city/{cityName}/extmsg/unbind": { "post": { "operationId": "post-v0-city-by-city-name-extmsg-unbind", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExtMsgUnbindInputBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ExtMsgUnbindBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name extmsg unbind" } }, "/v0/city/{cityName}/formula/{name}": { "get": { "operationId": "get-v0-city-by-city-name-formula-by-name", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Formula name.", "in": "path", "name": "name", "required": true, "schema": { "description": "Formula name.", "type": "string" } }, { "description": "Scope kind (city or rig).", "explode": false, "in": "query", "name": "scope_kind", "schema": { "description": "Scope kind (city or rig).", "type": "string" } }, { "description": "Scope reference.", "explode": false, "in": "query", "name": "scope_ref", "schema": { "description": "Scope reference.", "type": "string" } }, { "description": "Preview target: a bead or convoy ID, or a configured agent identity (for example a workflow root's gc.routed_to value).", "explode": false, "in": "query", "name": "target", "required": true, "schema": { "description": "Preview target: a bead or convoy ID, or a configured agent identity (for example a workflow root's gc.routed_to value).", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FormulaDetailResponse" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name formula by name" } }, "/v0/city/{cityName}/formulas": { "get": { "operationId": "get-v0-city-by-city-name-formulas", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Scope kind (city or rig).", "explode": false, "in": "query", "name": "scope_kind", "schema": { "description": "Scope kind (city or rig).", "type": "string" } }, { "description": "Scope reference.", "explode": false, "in": "query", "name": "scope_ref", "schema": { "description": "Scope reference.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FormulaListBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name formulas" } }, "/v0/city/{cityName}/formulas/feed": { "get": { "operationId": "get-v0-city-by-city-name-formulas-feed", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Scope kind (city or rig).", "explode": false, "in": "query", "name": "scope_kind", "schema": { "description": "Scope kind (city or rig).", "type": "string" } }, { "description": "Scope reference.", "explode": false, "in": "query", "name": "scope_ref", "schema": { "description": "Scope reference.", "type": "string" } }, { "description": "Maximum number of feed items to return. 0 = default.", "explode": false, "in": "query", "name": "limit", "schema": { "description": "Maximum number of feed items to return. 0 = default.", "format": "int64", "minimum": 0, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FormulaFeedBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name formulas feed" } }, "/v0/city/{cityName}/formulas/{name}": { "delete": { "operationId": "delete-v0-city-by-city-name-formulas-by-name", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Formula name.", "in": "path", "name": "name", "required": true, "schema": { "description": "Formula name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Delete v0 city by city name formulas by name" }, "get": { "operationId": "get-v0-city-by-city-name-formulas-by-name", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Formula name.", "in": "path", "name": "name", "required": true, "schema": { "description": "Formula name.", "type": "string" } }, { "description": "Scope kind (city or rig).", "explode": false, "in": "query", "name": "scope_kind", "schema": { "description": "Scope kind (city or rig).", "type": "string" } }, { "description": "Scope reference.", "explode": false, "in": "query", "name": "scope_ref", "schema": { "description": "Scope reference.", "type": "string" } }, { "description": "Preview target: a bead or convoy ID, or a configured agent identity (for example a workflow root's gc.routed_to value).", "explode": false, "in": "query", "name": "target", "required": true, "schema": { "description": "Preview target: a bead or convoy ID, or a configured agent identity (for example a workflow root's gc.routed_to value).", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FormulaDetailResponse" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name formulas by name" }, "put": { "operationId": "put-v0-city-by-city-name-formulas-by-name", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Formula name.", "in": "path", "name": "name", "required": true, "schema": { "description": "Formula name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "requestBody": { "content": { "application/octet-stream": { "schema": { "contentMediaType": "application/octet-stream", "format": "binary", "type": "string" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "413": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Request Entity Too Large", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Put v0 city by city name formulas by name" } }, "/v0/city/{cityName}/formulas/{name}/preview": { "post": { "operationId": "post-v0-city-by-city-name-formulas-by-name-preview", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Formula name.", "in": "path", "name": "name", "required": true, "schema": { "description": "Formula name.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FormulaPreviewBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FormulaDetailResponse" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name formulas by name preview" } }, "/v0/city/{cityName}/formulas/{name}/runs": { "get": { "operationId": "get-v0-city-by-city-name-formulas-by-name-runs", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Formula name.", "in": "path", "name": "name", "required": true, "schema": { "description": "Formula name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Scope kind (city or rig).", "explode": false, "in": "query", "name": "scope_kind", "schema": { "description": "Scope kind (city or rig).", "type": "string" } }, { "description": "Scope reference.", "explode": false, "in": "query", "name": "scope_ref", "schema": { "description": "Scope reference.", "type": "string" } }, { "description": "Maximum number of recent runs to return. 0 = default.", "explode": false, "in": "query", "name": "limit", "schema": { "description": "Maximum number of recent runs to return. 0 = default.", "format": "int64", "minimum": 0, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FormulaRunsResponse" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name formulas by name runs" } }, "/v0/city/{cityName}/formulas/{name}/source": { "get": { "operationId": "get-v0-city-by-city-name-formulas-by-name-source", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Formula name.", "in": "path", "name": "name", "required": true, "schema": { "description": "Formula name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FormulaSourceOutputBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name formulas by name source" } }, "/v0/city/{cityName}/formulas/{name}/validate": { "post": { "operationId": "post-v0-city-by-city-name-formulas-by-name-validate", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Formula name.", "in": "path", "name": "name", "required": true, "schema": { "description": "Formula name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "requestBody": { "content": { "application/octet-stream": { "schema": { "contentMediaType": "application/octet-stream", "format": "binary", "type": "string" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/FormulaValidateOutputBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "413": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Request Entity Too Large", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name formulas by name validate" } }, "/v0/city/{cityName}/health": { "get": { "operationId": "get-v0-city-by-city-name-health", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/HealthOutputBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name health" } }, "/v0/city/{cityName}/mail": { "get": { "description": "Results are ordered (created_at DESC, id DESC) — newest messages first. A truncated response always carries next_cursor; passing it back returns the next page in the same order. Invalid or legacy cursors are rejected with a typed 400 (invalid-cursor).", "operationId": "get-v0-city-by-city-name-mail", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Event sequence number; when provided, blocks until a newer event arrives.", "explode": false, "in": "query", "name": "index", "schema": { "description": "Event sequence number; when provided, blocks until a newer event arrives.", "type": "string" } }, { "description": "How long to block waiting for changes (Go duration string, e.g. 30s). Default 30s, max 2m.", "explode": false, "in": "query", "name": "wait", "schema": { "description": "How long to block waiting for changes (Go duration string, e.g. 30s). Default 30s, max 2m.", "type": "string" } }, { "description": "Opaque keyset pagination token from a previous response's next_cursor field. Invalid or legacy tokens are rejected with a typed 400 (invalid-cursor); re-fetch the first page.", "explode": false, "in": "query", "name": "cursor", "schema": { "description": "Opaque keyset pagination token from a previous response's next_cursor field. Invalid or legacy tokens are rejected with a typed 400 (invalid-cursor); re-fetch the first page.", "type": "string" } }, { "description": "Maximum number of results to return. Omitted or 0 = server default (100). Values above 1000 are rejected.", "explode": false, "in": "query", "name": "limit", "schema": { "default": 100, "description": "Maximum number of results to return. Omitted or 0 = server default (100). Values above 1000 are rejected.", "format": "int64", "maximum": 1000, "minimum": 0, "type": "integer" } }, { "description": "Filter by agent name.", "explode": false, "in": "query", "name": "agent", "schema": { "description": "Filter by agent name.", "type": "string" } }, { "description": "Filter by status (unread, all).", "explode": false, "in": "query", "name": "status", "schema": { "description": "Filter by status (unread, all).", "type": "string" } }, { "description": "Filter by rig name.", "explode": false, "in": "query", "name": "rig", "schema": { "description": "Filter by rig name.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailListBody" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name mail" }, "post": { "operationId": "send-mail", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Idempotency key for safe retries.", "in": "header", "name": "Idempotency-Key", "schema": { "description": "Idempotency key for safe retries.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailSendInputBody" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Message" } } }, "description": "Created", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Send a mail message" } }, "/v0/city/{cityName}/mail/count": { "get": { "operationId": "get-v0-city-by-city-name-mail-count", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Filter by agent name.", "explode": false, "in": "query", "name": "agent", "schema": { "description": "Filter by agent name.", "type": "string" } }, { "description": "Filter by rig name.", "explode": false, "in": "query", "name": "rig", "schema": { "description": "Filter by rig name.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailCountOutputBody" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name mail count" } }, "/v0/city/{cityName}/mail/thread/{id}": { "get": { "operationId": "get-v0-city-by-city-name-mail-thread-by-id", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Thread ID, or any message ID in the thread.", "in": "path", "name": "id", "required": true, "schema": { "description": "Thread ID, or any message ID in the thread.", "type": "string" } }, { "description": "Filter by rig.", "explode": false, "in": "query", "name": "rig", "schema": { "description": "Filter by rig.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailListBody" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name mail thread by ID" } }, "/v0/city/{cityName}/mail/{id}": { "delete": { "operationId": "delete-v0-city-by-city-name-mail-by-id", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Message ID.", "in": "path", "name": "id", "required": true, "schema": { "description": "Message ID.", "type": "string" } }, { "description": "Rig hint.", "explode": false, "in": "query", "name": "rig", "schema": { "description": "Rig hint.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Delete v0 city by city name mail by ID" }, "get": { "operationId": "get-v0-city-by-city-name-mail-by-id", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Message ID.", "in": "path", "name": "id", "required": true, "schema": { "description": "Message ID.", "type": "string" } }, { "description": "Rig hint for O(1) lookup.", "explode": false, "in": "query", "name": "rig", "schema": { "description": "Rig hint for O(1) lookup.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Message" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name mail by ID" } }, "/v0/city/{cityName}/mail/{id}/archive": { "post": { "operationId": "post-v0-city-by-city-name-mail-by-id-archive", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Message ID.", "in": "path", "name": "id", "required": true, "schema": { "description": "Message ID.", "type": "string" } }, { "description": "Rig hint.", "explode": false, "in": "query", "name": "rig", "schema": { "description": "Rig hint.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name mail by ID archive" } }, "/v0/city/{cityName}/mail/{id}/mark-unread": { "post": { "operationId": "post-v0-city-by-city-name-mail-by-id-mark-unread", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Message ID.", "in": "path", "name": "id", "required": true, "schema": { "description": "Message ID.", "type": "string" } }, { "description": "Rig hint.", "explode": false, "in": "query", "name": "rig", "schema": { "description": "Rig hint.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name mail by ID mark unread" } }, "/v0/city/{cityName}/mail/{id}/read": { "post": { "operationId": "post-v0-city-by-city-name-mail-by-id-read", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Message ID.", "in": "path", "name": "id", "required": true, "schema": { "description": "Message ID.", "type": "string" } }, { "description": "Rig hint.", "explode": false, "in": "query", "name": "rig", "schema": { "description": "Rig hint.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name mail by ID read" } }, "/v0/city/{cityName}/mail/{id}/reply": { "post": { "operationId": "reply-mail", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Message ID.", "in": "path", "name": "id", "required": true, "schema": { "description": "Message ID.", "type": "string" } }, { "description": "Rig hint.", "explode": false, "in": "query", "name": "rig", "schema": { "description": "Rig hint.", "type": "string" } }, { "description": "Idempotency key for safe retries.", "in": "header", "name": "Idempotency-Key", "schema": { "description": "Idempotency key for safe retries.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MailReplyInputBody" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Message" } } }, "description": "Created", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Reply to a mail message" } }, "/v0/city/{cityName}/maintenance/dolt-gc": { "post": { "description": "Trigger a one-off maintenance cycle (dolt backup + CALL DOLT_GC + smoke test). Default async (202); ?wait=true blocks until completion (200). Returns 409 when a run is already in flight.", "operationId": "trigger-maintenance-dolt-gc", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "When true, the handler blocks until the run completes and returns 200 with the full Run. When false (default), the handler returns 202 Accepted immediately.", "explode": false, "in": "query", "name": "wait", "schema": { "description": "When true, the handler blocks until the run completes and returns 200 with the full Run. When false (default), the handler returns 202 Accepted immediately.", "type": "boolean" } } ], "responses": { "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceTriggerBody" } } }, "description": "Accepted", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Trigger a Dolt store maintenance run" } }, "/v0/city/{cityName}/maintenance/status": { "get": { "operationId": "get-v0-city-by-city-name-maintenance-status", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/MaintenanceStatusBody" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "format": "double", "type": "number" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name maintenance status" } }, "/v0/city/{cityName}/order/history/{bead_id}": { "get": { "operationId": "get-v0-city-by-city-name-order-history-by-bead-id", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Bead ID for the order run.", "in": "path", "name": "bead_id", "required": true, "schema": { "description": "Bead ID for the order run.", "type": "string" } }, { "description": "Store reference for disambiguating store-local bead IDs.", "explode": false, "in": "query", "name": "store_ref", "schema": { "description": "Store reference for disambiguating store-local bead IDs.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderHistoryDetailResponse" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name order history by bead ID" } }, "/v0/city/{cityName}/order/{name}": { "get": { "operationId": "get-v0-city-by-city-name-order-by-name", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Order name or scoped name.", "in": "path", "name": "name", "required": true, "schema": { "description": "Order name or scoped name.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderResponse" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name order by name" } }, "/v0/city/{cityName}/order/{name}/disable": { "post": { "operationId": "post-v0-city-by-city-name-order-by-name-disable", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Order name or scoped name.", "in": "path", "name": "name", "required": true, "schema": { "description": "Order name or scoped name.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name order by name disable" } }, "/v0/city/{cityName}/order/{name}/enable": { "post": { "operationId": "post-v0-city-by-city-name-order-by-name-enable", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Order name or scoped name.", "in": "path", "name": "name", "required": true, "schema": { "description": "Order name or scoped name.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name order by name enable" } }, "/v0/city/{cityName}/order/{name}/run": { "post": { "operationId": "post-v0-city-by-city-name-order-by-name-run", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Order name or scoped name of a trigger=\"webhook\" order.", "in": "path", "name": "name", "required": true, "schema": { "description": "Order name or scoped name of a trigger=\"webhook\" order.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderRunInputBody" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderRunOutputBody" } } }, "description": "Accepted", "headers": { "Location": { "schema": { "description": "Runs-list URL. An order dispatches asynchronously, so no single run root is known at response time; the dispatched run appears in the list once it materializes.", "type": "string" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name order by name run" } }, "/v0/city/{cityName}/orders": { "get": { "operationId": "get-v0-city-by-city-name-orders", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderListBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name orders" } }, "/v0/city/{cityName}/orders/check": { "get": { "operationId": "get-v0-city-by-city-name-orders-check", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Bypass cached order-check responses and cached order history.", "explode": false, "in": "query", "name": "fresh", "schema": { "description": "Bypass cached order-check responses and cached order history.", "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderCheckListBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name orders check" } }, "/v0/city/{cityName}/orders/feed": { "get": { "operationId": "get-v0-city-by-city-name-orders-feed", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Scope kind (city or rig).", "explode": false, "in": "query", "name": "scope_kind", "schema": { "description": "Scope kind (city or rig).", "type": "string" } }, { "description": "Scope reference.", "explode": false, "in": "query", "name": "scope_ref", "schema": { "description": "Scope reference.", "type": "string" } }, { "description": "Maximum number of feed items to return.", "explode": false, "in": "query", "name": "limit", "schema": { "description": "Maximum number of feed items to return.", "format": "int64", "minimum": 0, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrdersFeedBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name orders feed" } }, "/v0/city/{cityName}/orders/history": { "get": { "operationId": "get-v0-city-by-city-name-orders-history", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Scoped order name.", "explode": false, "in": "query", "name": "scoped_name", "required": true, "schema": { "description": "Scoped order name.", "minLength": 1, "type": "string" } }, { "description": "Maximum number of history entries. 0 = default.", "explode": false, "in": "query", "name": "limit", "schema": { "description": "Maximum number of history entries. 0 = default.", "format": "int64", "minimum": 0, "type": "integer" } }, { "description": "Return entries before this RFC3339 timestamp.", "explode": false, "in": "query", "name": "before", "schema": { "description": "Return entries before this RFC3339 timestamp.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OrderHistoryListBody" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name orders history" } }, "/v0/city/{cityName}/packs": { "get": { "operationId": "get-v0-city-by-city-name-packs", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PackListBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name packs" }, "post": { "description": "Imports a pack into the city by source (a remote git URL or registry ref), resolving + installing it so its templates compose into the city.", "operationId": "add-pack", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Idempotency key for safe retries.", "in": "header", "name": "Idempotency-Key", "schema": { "description": "Idempotency key for safe retries.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PackAddInputBody" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PackAddedOutputBody" } } }, "description": "Created", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "502": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Gateway", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Add a pack" } }, "/v0/city/{cityName}/packs/{name}": { "delete": { "operationId": "delete-v0-city-by-city-name-packs-by-name", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "The import binding name to remove (the [imports.\u003cname\u003e] key).", "in": "path", "name": "name", "required": true, "schema": { "description": "The import binding name to remove (the [imports.\u003cname\u003e] key).", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PackRemovedOutputBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Delete v0 city by city name packs by name" } }, "/v0/city/{cityName}/patches/agent/{base}": { "delete": { "operationId": "delete-v0-city-by-city-name-patches-agent-by-base", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Agent patch name (unqualified).", "in": "path", "name": "base", "required": true, "schema": { "description": "Agent patch name (unqualified).", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchDeletedResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Delete v0 city by city name patches agent by base" }, "get": { "operationId": "get-v0-city-by-city-name-patches-agent-by-base", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Agent patch name (unqualified).", "in": "path", "name": "base", "required": true, "schema": { "description": "Agent patch name (unqualified).", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentPatch" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name patches agent by base" } }, "/v0/city/{cityName}/patches/agent/{dir}/{base}": { "delete": { "operationId": "delete-v0-city-by-city-name-patches-agent-by-dir-by-base", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Agent directory (rig name).", "in": "path", "name": "dir", "required": true, "schema": { "description": "Agent directory (rig name).", "type": "string" } }, { "description": "Agent base name.", "in": "path", "name": "base", "required": true, "schema": { "description": "Agent base name.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchDeletedResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Delete v0 city by city name patches agent by dir by base" }, "get": { "operationId": "get-v0-city-by-city-name-patches-agent-by-dir-by-base", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Agent directory (rig name).", "in": "path", "name": "dir", "required": true, "schema": { "description": "Agent directory (rig name).", "type": "string" } }, { "description": "Agent base name.", "in": "path", "name": "base", "required": true, "schema": { "description": "Agent base name.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentPatch" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name patches agent by dir by base" } }, "/v0/city/{cityName}/patches/agents": { "get": { "operationId": "get-v0-city-by-city-name-patches-agents", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListBodyAgentPatch" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name patches agents" }, "put": { "operationId": "put-v0-city-by-city-name-patches-agents", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AgentPatchSetInputBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchOKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Put v0 city by city name patches agents" } }, "/v0/city/{cityName}/patches/provider/{name}": { "delete": { "operationId": "delete-v0-city-by-city-name-patches-provider-by-name", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Provider patch name.", "in": "path", "name": "name", "required": true, "schema": { "description": "Provider patch name.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchDeletedResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Delete v0 city by city name patches provider by name" }, "get": { "operationId": "get-v0-city-by-city-name-patches-provider-by-name", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Provider patch name.", "in": "path", "name": "name", "required": true, "schema": { "description": "Provider patch name.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProviderPatch" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name patches provider by name" } }, "/v0/city/{cityName}/patches/providers": { "get": { "operationId": "get-v0-city-by-city-name-patches-providers", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListBodyProviderPatch" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name patches providers" }, "put": { "operationId": "put-v0-city-by-city-name-patches-providers", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProviderPatchSetInputBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchOKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Put v0 city by city name patches providers" } }, "/v0/city/{cityName}/patches/rig/{name}": { "delete": { "operationId": "delete-v0-city-by-city-name-patches-rig-by-name", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Rig patch name.", "in": "path", "name": "name", "required": true, "schema": { "description": "Rig patch name.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchDeletedResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Delete v0 city by city name patches rig by name" }, "get": { "operationId": "get-v0-city-by-city-name-patches-rig-by-name", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Rig patch name.", "in": "path", "name": "name", "required": true, "schema": { "description": "Rig patch name.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RigPatch" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name patches rig by name" } }, "/v0/city/{cityName}/patches/rigs": { "get": { "operationId": "get-v0-city-by-city-name-patches-rigs", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListBodyRigPatch" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name patches rigs" }, "put": { "operationId": "put-v0-city-by-city-name-patches-rigs", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RigPatchSetInputBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/PatchOKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Put v0 city by city name patches rigs" } }, "/v0/city/{cityName}/pending": { "get": { "operationId": "get-v0-city-by-city-name-pending", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListBodyCityPendingEntry" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name pending" } }, "/v0/city/{cityName}/provider-readiness": { "get": { "operationId": "get-v0-city-by-city-name-provider-readiness", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Comma-separated provider names to check (default: claude,codex,gemini).", "explode": false, "in": "query", "name": "providers", "schema": { "description": "Comma-separated provider names to check (default: claude,codex,gemini).", "type": "string" } }, { "description": "Force fresh probe, bypassing cache.", "explode": false, "in": "query", "name": "fresh", "schema": { "description": "Force fresh probe, bypassing cache.", "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProviderReadinessResponse" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name provider readiness" } }, "/v0/city/{cityName}/provider/{name}": { "delete": { "operationId": "delete-v0-city-by-city-name-provider-by-name", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Provider name.", "in": "path", "name": "name", "required": true, "schema": { "description": "Provider name.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Delete v0 city by city name provider by name" }, "get": { "operationId": "get-v0-city-by-city-name-provider-by-name", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Provider name.", "in": "path", "name": "name", "required": true, "schema": { "description": "Provider name.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProviderResponse" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name provider by name" }, "patch": { "operationId": "patch-v0-city-by-city-name-provider-by-name", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Provider name.", "in": "path", "name": "name", "required": true, "schema": { "description": "Provider name.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProviderUpdateInputBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Patch v0 city by city name provider by name" } }, "/v0/city/{cityName}/providers": { "get": { "operationId": "get-v0-city-by-city-name-providers", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListBodyProviderResponse" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name providers" }, "post": { "operationId": "create-provider", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Idempotency key for safe retries.", "in": "header", "name": "Idempotency-Key", "schema": { "description": "Idempotency key for safe retries.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProviderCreateInputBody" } } }, "required": true }, "responses": { "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProviderCreatedOutputBody" } } }, "description": "Created", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Create a provider" } }, "/v0/city/{cityName}/providers/public": { "get": { "operationId": "get-v0-city-by-city-name-providers-public", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProviderPublicListBody" } } }, "description": "OK", "headers": { "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name providers public" } }, "/v0/city/{cityName}/readiness": { "get": { "operationId": "get-v0-city-by-city-name-readiness", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Comma-separated readiness items to check (default: claude,codex,gemini,github_cli).", "explode": false, "in": "query", "name": "items", "schema": { "description": "Comma-separated readiness items to check (default: claude,codex,gemini,github_cli).", "type": "string" } }, { "description": "Force fresh probe, bypassing cache.", "explode": false, "in": "query", "name": "fresh", "schema": { "description": "Force fresh probe, bypassing cache.", "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReadinessResponse" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name readiness" } }, "/v0/city/{cityName}/rig/{name}": { "delete": { "operationId": "delete-v0-city-by-city-name-rig-by-name", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Rig name.", "in": "path", "name": "name", "required": true, "schema": { "description": "Rig name.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Delete v0 city by city name rig by name" }, "get": { "operationId": "get-v0-city-by-city-name-rig-by-name", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Rig name.", "in": "path", "name": "name", "required": true, "schema": { "description": "Rig name.", "type": "string" } }, { "description": "Include git status.", "explode": false, "in": "query", "name": "git", "schema": { "description": "Include git status.", "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RigResponse" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name rig by name" }, "patch": { "operationId": "patch-v0-city-by-city-name-rig-by-name", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Rig name.", "in": "path", "name": "name", "required": true, "schema": { "description": "Rig name.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RigUpdateInputBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Patch v0 city by city name rig by name" } }, "/v0/city/{cityName}/rig/{name}/{action}": { "post": { "operationId": "post-v0-city-by-city-name-rig-by-name-by-action", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Rig name.", "in": "path", "name": "name", "required": true, "schema": { "description": "Rig name.", "type": "string" } }, { "description": "Action to perform.", "in": "path", "name": "action", "required": true, "schema": { "description": "Action to perform.", "enum": [ "suspend", "resume", "restart" ], "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RigActionBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name rig by name by action" } }, "/v0/city/{cityName}/rigs": { "get": { "operationId": "get-v0-city-by-city-name-rigs", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Event sequence number; when provided, blocks until a newer event arrives.", "explode": false, "in": "query", "name": "index", "schema": { "description": "Event sequence number; when provided, blocks until a newer event arrives.", "type": "string" } }, { "description": "How long to block waiting for changes (Go duration string, e.g. 30s). Default 30s, max 2m.", "explode": false, "in": "query", "name": "wait", "schema": { "description": "How long to block waiting for changes (Go duration string, e.g. 30s). Default 30s, max 2m.", "type": "string" } }, { "description": "Include git status.", "explode": false, "in": "query", "name": "git", "schema": { "description": "Include git status.", "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListBodyRigResponse" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name rigs" }, "post": { "description": "Create a rig. Without git_url, appends the rig to city.toml synchronously (201). With git_url, clones and provisions asynchronously: returns 202 with an event_cursor — watch the city event stream for request.result.rig.create, rig.provision.progress, or request.failed carrying the request_id — or 200 for an idempotent replay of a succeeded create.", "operationId": "create-rig", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Idempotency key for safe retries (synchronous create).", "in": "header", "name": "Idempotency-Key", "schema": { "description": "Idempotency key for safe retries (synchronous create).", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RigCreateBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RigCreateResponseBody" } } }, "description": "Rig already exists — idempotent request_id replay of a succeeded async create.", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "201": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RigCreateResponseBody" } } }, "description": "Created", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RigCreateResponseBody" } } }, "description": "Provisioning accepted; watch the city event stream from event_cursor for request.result.rig.create, rig.provision.progress, or request.failed with this request_id.", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Create a rig" } }, "/v0/city/{cityName}/runs": { "get": { "operationId": "get-v0-city-by-city-name-runs", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Maximum runs to return (0 uses the server default).", "explode": false, "in": "query", "name": "limit", "schema": { "description": "Maximum runs to return (0 uses the server default).", "format": "int64", "minimum": 0, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunsListOutputBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name runs" } }, "/v0/city/{cityName}/runs/census": { "get": { "operationId": "get-v0-city-by-city-name-runs-census", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunsCensusOutputBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name runs census" } }, "/v0/city/{cityName}/runs/{run_id}": { "get": { "operationId": "get-v0-city-by-city-name-runs-by-run-id", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Run identifier.", "in": "path", "name": "run_id", "required": true, "schema": { "description": "Run identifier.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Run" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name runs by run ID" } }, "/v0/city/{cityName}/runs/{run_id}/cancel": { "post": { "operationId": "post-v0-city-by-city-name-runs-by-run-id-cancel", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Run identifier.", "in": "path", "name": "run_id", "required": true, "schema": { "description": "Run identifier.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "responses": { "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunCancelOutputBody" } } }, "description": "Accepted", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name runs by run ID cancel" } }, "/v0/city/{cityName}/runs/{run_id}/steps": { "get": { "operationId": "get-v0-city-by-city-name-runs-by-run-id-steps", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Run identifier.", "in": "path", "name": "run_id", "required": true, "schema": { "description": "Run identifier.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/RunStepsOutputBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name runs by run ID steps" } }, "/v0/city/{cityName}/service/{name}": { "get": { "operationId": "get-v0-city-by-city-name-service-by-name", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Service name.", "in": "path", "name": "name", "required": true, "schema": { "description": "Service name.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Status" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name service by name" } }, "/v0/city/{cityName}/service/{name}/restart": { "post": { "operationId": "post-v0-city-by-city-name-service-by-name-restart", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Service name.", "in": "path", "name": "name", "required": true, "schema": { "description": "Service name.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ServiceRestartOutputBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name service by name restart" } }, "/v0/city/{cityName}/services": { "get": { "operationId": "get-v0-city-by-city-name-services", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListBodyStatus" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name services" } }, "/v0/city/{cityName}/session/{id}": { "get": { "operationId": "get-v0-city-by-city-name-session-by-id", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Session ID, alias, or runtime session_name.", "in": "path", "name": "id", "required": true, "schema": { "description": "Session ID, alias, or runtime session_name.", "type": "string" } }, { "description": "Include last output preview.", "explode": false, "in": "query", "name": "peek", "schema": { "description": "Include last output preview.", "type": "boolean" } }, { "description": "Number of lines to include in the last output preview when peek=true. Defaults to 5.", "explode": false, "in": "query", "name": "peek_lines", "schema": { "description": "Number of lines to include in the last output preview when peek=true. Defaults to 5.", "format": "int64", "maximum": 10000, "minimum": 0, "type": "integer" } }, { "description": "Resolve {id} as an exact session bead id only: a single point read that also finds closed sessions and answers 404 when no bead has that id. Skips the alias, runtime session_name, configured-name and closed-session name lookups. For callers holding a durable id.", "explode": false, "in": "query", "name": "exact_id", "schema": { "description": "Resolve {id} as an exact session bead id only: a single point read that also finds closed sessions and answers 404 when no bead has that id. Skips the alias, runtime session_name, configured-name and closed-session name lookups. For callers holding a durable id.", "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionResponse" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name session by ID" }, "patch": { "operationId": "patch-v0-city-by-city-name-session-by-id", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Session ID, alias, or runtime session_name.", "in": "path", "name": "id", "required": true, "schema": { "description": "Session ID, alias, or runtime session_name.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionPatchBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionResponse" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Patch v0 city by city name session by ID" } }, "/v0/city/{cityName}/session/{id}/agents": { "get": { "operationId": "get-v0-city-by-city-name-session-by-id-agents", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Session ID, alias, or runtime session_name.", "in": "path", "name": "id", "required": true, "schema": { "description": "Session ID, alias, or runtime session_name.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionAgentListResponse" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name session by ID agents" } }, "/v0/city/{cityName}/session/{id}/agents/{agentId}": { "get": { "operationId": "get-v0-city-by-city-name-session-by-id-agents-by-agent-id", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Session ID, alias, or runtime session_name.", "in": "path", "name": "id", "required": true, "schema": { "description": "Session ID, alias, or runtime session_name.", "type": "string" } }, { "description": "Subagent ID within the session.", "in": "path", "name": "agentId", "required": true, "schema": { "description": "Subagent ID within the session.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionAgentGetResponse" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name session by ID agents by agent ID" } }, "/v0/city/{cityName}/session/{id}/close": { "post": { "operationId": "post-v0-city-by-city-name-session-by-id-close", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Session ID, alias, or runtime session_name.", "in": "path", "name": "id", "required": true, "schema": { "description": "Session ID, alias, or runtime session_name.", "type": "string" } }, { "description": "Permanently delete bead after closing.", "explode": false, "in": "query", "name": "delete", "schema": { "description": "Permanently delete bead after closing.", "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name session by ID close" } }, "/v0/city/{cityName}/session/{id}/kill": { "post": { "operationId": "post-v0-city-by-city-name-session-by-id-kill", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Session ID, alias, or runtime session_name.", "in": "path", "name": "id", "required": true, "schema": { "description": "Session ID, alias, or runtime session_name.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKWithIDResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name session by ID kill" } }, "/v0/city/{cityName}/session/{id}/messages": { "post": { "operationId": "send-session-message", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Session ID, alias, or runtime session_name.", "in": "path", "name": "id", "required": true, "schema": { "description": "Session ID, alias, or runtime session_name.", "type": "string" } }, { "description": "Idempotency key for safe retries.", "in": "header", "name": "Idempotency-Key", "schema": { "description": "Idempotency key for safe retries.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionMessageInputBody" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AsyncAcceptedBody" } } }, "description": "Accepted", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Send a message to a session" } }, "/v0/city/{cityName}/session/{id}/pending": { "get": { "operationId": "get-v0-city-by-city-name-session-by-id-pending", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Session ID, alias, or runtime session_name.", "in": "path", "name": "id", "required": true, "schema": { "description": "Session ID, alias, or runtime session_name.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionPendingResponse" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name session by ID pending" } }, "/v0/city/{cityName}/session/{id}/permission-mode": { "post": { "operationId": "post-v0-city-by-city-name-session-by-id-permission-mode", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Session ID, alias, or runtime session_name.", "in": "path", "name": "id", "required": true, "schema": { "description": "Session ID, alias, or runtime session_name.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionPermissionModeBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionResponse" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name session by ID permission mode" } }, "/v0/city/{cityName}/session/{id}/rename": { "post": { "operationId": "post-v0-city-by-city-name-session-by-id-rename", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Session ID, alias, or runtime session_name.", "in": "path", "name": "id", "required": true, "schema": { "description": "Session ID, alias, or runtime session_name.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionRenameInputBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionResponse" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name session by ID rename" } }, "/v0/city/{cityName}/session/{id}/reset": { "post": { "description": "Requests a fresh restart of an existing session: the session bead is kept, and the controller restarts the runtime on the next continuation epoch, so the provider starts a new conversation instead of resuming the previous one. The call records the request and pokes the controller; it returns before the restart happens. A closed session returns 409. For a named session, the controller clears a tripped respawn circuit breaker when its next tick consumes the restart request through the restart path. Unlike `gc session reset`, this endpoint does not clear the breaker synchronously, so the clear does not happen if the controller never processes the request, and it also does not happen when a session drain-acks in the same window: the drain-ack path consumes the restart request without touching the breaker. Use `gc session reset` when clearing the breaker is itself the goal. This endpoint always requests an in-place restart. Unlike `gc session reset`, it never rolls back an unfinished create, so a session wedged mid-create is retried in place instead of being replaced; use `gc session reset` to roll one back.", "operationId": "post-v0-city-by-city-name-session-by-id-reset", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Session ID, alias, or runtime session_name.", "in": "path", "name": "id", "required": true, "schema": { "description": "Session ID, alias, or runtime session_name.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKWithIDResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name session by ID reset" } }, "/v0/city/{cityName}/session/{id}/respond": { "post": { "operationId": "respond-session", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Session ID, alias, or runtime session_name.", "in": "path", "name": "id", "required": true, "schema": { "description": "Session ID, alias, or runtime session_name.", "type": "string" } }, { "description": "Idempotency key for safe retries.", "in": "header", "name": "Idempotency-Key", "schema": { "description": "Idempotency key for safe retries.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionRespondInputBody" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionRespondOutputBody" } } }, "description": "Accepted", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "501": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Implemented", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Respond to a pending interaction" } }, "/v0/city/{cityName}/session/{id}/stop": { "post": { "operationId": "post-v0-city-by-city-name-session-by-id-stop", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Session ID, alias, or runtime session_name.", "in": "path", "name": "id", "required": true, "schema": { "description": "Session ID, alias, or runtime session_name.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKWithIDResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name session by ID stop" } }, "/v0/city/{cityName}/session/{id}/stream": { "get": { "description": "Server-Sent Events stream of session transcript updates. Streams turns (conversation format), raw messages (JSONL format), or structured messages based on the format query parameter. Emits activity and pending events for tool approval prompts.", "operationId": "stream-session", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Session ID, alias, or runtime session_name.", "in": "path", "name": "id", "required": true, "schema": { "description": "Session ID, alias, or runtime session_name.", "type": "string" } }, { "description": "Transcript format: conversation (default), raw, or structured.", "explode": false, "in": "query", "name": "format", "schema": { "description": "Transcript format: conversation (default), raw, or structured.", "enum": [ "conversation", "raw", "structured" ], "type": "string" } }, { "description": "Include thinking block text and signature in structured stream frames. Defaults to false; both are redacted otherwise.", "explode": false, "in": "query", "name": "include_thinking", "schema": { "description": "Include thinking block text and signature in structured stream frames. Defaults to false; both are redacted otherwise.", "type": "boolean" } }, { "description": "Opaque structured transcript resume cursor from the REST snapshot. Last-Event-ID takes precedence on automatic SSE reconnect.", "explode": false, "in": "query", "name": "after_cursor", "schema": { "description": "Opaque structured transcript resume cursor from the REST snapshot. Last-Event-ID takes precedence on automatic SSE reconnect.", "maxLength": 2048, "type": "string" } }, { "description": "Opaque structured transcript resume cursor from the last received SSE frame. Takes precedence over after_cursor.", "in": "header", "name": "Last-Event-ID", "schema": { "description": "Opaque structured transcript resume cursor from the last received SSE frame. Takes precedence over after_cursor.", "maxLength": 2048, "type": "string" } } ], "responses": { "200": { "content": { "text/event-stream": { "schema": { "description": "Each oneOf object represents one possible SSE message.", "items": { "oneOf": [ { "properties": { "data": { "$ref": "#/components/schemas/SessionActivityEvent" }, "event": { "const": "activity", "description": "The event name.", "type": "string" }, "id": { "description": "The event resume cursor.", "type": "string" }, "retry": { "description": "The retry time in milliseconds.", "type": "integer" } }, "required": [ "data", "event" ], "title": "Event activity", "type": "object" }, { "properties": { "data": { "$ref": "#/components/schemas/HeartbeatEvent" }, "event": { "const": "heartbeat", "description": "The event name.", "type": "string" }, "id": { "description": "The event resume cursor.", "type": "string" }, "retry": { "description": "The retry time in milliseconds.", "type": "integer" } }, "required": [ "data", "event" ], "title": "Event heartbeat", "type": "object" }, { "properties": { "data": { "$ref": "#/components/schemas/SessionStreamRawMessageEvent" }, "event": { "const": "message", "description": "The event name.", "type": "string" }, "id": { "description": "The event resume cursor.", "type": "string" }, "retry": { "description": "The retry time in milliseconds.", "type": "integer" } }, "required": [ "data" ], "title": "Event message", "type": "object" }, { "properties": { "data": { "$ref": "#/components/schemas/PendingInteraction" }, "event": { "const": "pending", "description": "The event name.", "type": "string" }, "id": { "description": "The event resume cursor.", "type": "string" }, "retry": { "description": "The retry time in milliseconds.", "type": "integer" } }, "required": [ "data", "event" ], "title": "Event pending", "type": "object" }, { "properties": { "data": { "$ref": "#/components/schemas/SessionPendingClearedEvent" }, "event": { "const": "pending_cleared", "description": "The event name.", "type": "string" }, "id": { "description": "The event resume cursor.", "type": "string" }, "retry": { "description": "The retry time in milliseconds.", "type": "integer" } }, "required": [ "data", "event" ], "title": "Event pending_cleared", "type": "object" }, { "properties": { "data": { "$ref": "#/components/schemas/SessionStreamStructuredMessageEvent" }, "event": { "const": "structured", "description": "The event name.", "type": "string" }, "id": { "description": "The event resume cursor.", "type": "string" }, "retry": { "description": "The retry time in milliseconds.", "type": "integer" } }, "required": [ "data", "event" ], "title": "Event structured", "type": "object" }, { "properties": { "data": { "$ref": "#/components/schemas/SessionStreamMessageEvent" }, "event": { "const": "turn", "description": "The event name.", "type": "string" }, "id": { "description": "The event resume cursor.", "type": "string" }, "retry": { "description": "The retry time in milliseconds.", "type": "integer" } }, "required": [ "data", "event" ], "title": "Event turn", "type": "object" } ] }, "title": "Server Sent Events", "type": "array" } } }, "description": "OK", "headers": { "GC-Session-State": { "description": "Session state at the time streaming began (e.g. active, closed).", "schema": { "description": "Session state at the time streaming began (e.g. active, closed).", "type": "string" } }, "GC-Session-Status": { "description": "Runtime status at the time streaming began. Emitted as \"stopped\" when the session's underlying process is not running.", "schema": { "description": "Runtime status at the time streaming began. Emitted as \"stopped\" when the session's underlying process is not running.", "type": "string" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Stream session output in real time" } }, "/v0/city/{cityName}/session/{id}/submit": { "post": { "operationId": "submit-session", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Session ID, alias, or runtime session_name.", "in": "path", "name": "id", "required": true, "schema": { "description": "Session ID, alias, or runtime session_name.", "type": "string" } }, { "description": "Idempotency key for safe retries.", "in": "header", "name": "Idempotency-Key", "schema": { "description": "Idempotency key for safe retries.", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionSubmitInputBody" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AsyncAcceptedBody" } } }, "description": "Accepted", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Submit a message to a session" } }, "/v0/city/{cityName}/session/{id}/suspend": { "post": { "operationId": "post-v0-city-by-city-name-session-by-id-suspend", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Session ID, alias, or runtime session_name.", "in": "path", "name": "id", "required": true, "schema": { "description": "Session ID, alias, or runtime session_name.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name session by ID suspend" } }, "/v0/city/{cityName}/session/{id}/transcript": { "get": { "operationId": "get-v0-city-by-city-name-session-by-id-transcript", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Number of recent compaction segments to return. This API parameter keeps compaction-segment semantics even though gc session logs --tail counts displayed transcript entries. Omit for the endpoint default (usually 1); 0 returns all segments; N\u003e0 returns the last N.", "explode": false, "in": "query", "name": "tail", "schema": { "description": "Number of recent compaction segments to return. This API parameter keeps compaction-segment semantics even though gc session logs --tail counts displayed transcript entries. Omit for the endpoint default (usually 1); 0 returns all segments; N\u003e0 returns the last N.", "type": "string" } }, { "description": "Session ID, alias, or runtime session_name.", "in": "path", "name": "id", "required": true, "schema": { "description": "Session ID, alias, or runtime session_name.", "type": "string" } }, { "description": "Transcript format: conversation (default), raw, or structured.", "explode": false, "in": "query", "name": "format", "schema": { "description": "Transcript format: conversation (default), raw, or structured.", "enum": [ "conversation", "raw", "structured" ], "type": "string" } }, { "description": "Include thinking block text and signature in structured responses. Defaults to false; both are redacted otherwise.", "explode": false, "in": "query", "name": "include_thinking", "schema": { "description": "Include thinking block text and signature in structured responses. Defaults to false; both are redacted otherwise.", "type": "boolean" } }, { "description": "Pagination cursor: return entries before this stable transcript entry ID.", "explode": false, "in": "query", "name": "before", "schema": { "description": "Pagination cursor: return entries before this stable transcript entry ID.", "type": "string" } }, { "description": "Pagination cursor: return entries after this stable transcript entry ID.", "explode": false, "in": "query", "name": "after", "schema": { "description": "Pagination cursor: return entries after this stable transcript entry ID.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionTranscriptGetResponse" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name session by ID transcript" } }, "/v0/city/{cityName}/session/{id}/wake": { "post": { "description": "Records an explicit wake and asks the controller to start the session; the API never starts the runtime itself. 409 wake-will-not-start means the wake is recorded but the controller will not act on it (no runnable template, a dependency-only or drained pool session, a suspended city, rig or agent, a demand-only singleton, an abandoned create, an open circuit breaker, a startup-health quarantine, or an idle latch); the detail names the remedy. `gc session wake` applies the same rules.", "operationId": "post-v0-city-by-city-name-session-by-id-wake", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Session ID, alias, or runtime session_name.", "in": "path", "name": "id", "required": true, "schema": { "description": "Session ID, alias, or runtime session_name.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/OKWithIDResponseBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name session by ID wake" } }, "/v0/city/{cityName}/sessions": { "get": { "description": "Results are ordered (created_at DESC, id DESC) — newest sessions first. A truncated response always carries next_cursor; passing it back returns the next page in the same order. Invalid or legacy cursors are rejected with a typed 400 (invalid-cursor).", "operationId": "get-v0-city-by-city-name-sessions", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Opaque keyset pagination token from a previous response's next_cursor field. Invalid or legacy tokens are rejected with a typed 400 (invalid-cursor); re-fetch the first page.", "explode": false, "in": "query", "name": "cursor", "schema": { "description": "Opaque keyset pagination token from a previous response's next_cursor field. Invalid or legacy tokens are rejected with a typed 400 (invalid-cursor); re-fetch the first page.", "type": "string" } }, { "description": "Maximum number of results to return. Omitted or 0 = server default (100). Values above 1000 are rejected.", "explode": false, "in": "query", "name": "limit", "schema": { "default": 100, "description": "Maximum number of results to return. Omitted or 0 = server default (100). Values above 1000 are rejected.", "format": "int64", "maximum": 1000, "minimum": 0, "type": "integer" } }, { "description": "Filter by session state (e.g. active, closed).", "explode": false, "in": "query", "name": "state", "schema": { "description": "Filter by session state (e.g. active, closed).", "type": "string" } }, { "description": "Filter by session template (agent qualified name).", "explode": false, "in": "query", "name": "template", "schema": { "description": "Filter by session template (agent qualified name).", "type": "string" } }, { "description": "Include last output preview.", "explode": false, "in": "query", "name": "peek", "schema": { "description": "Include last output preview.", "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ListBodySessionResponse" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name sessions" }, "post": { "operationId": "create-session", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SessionCreateBody" } } }, "required": true }, "responses": { "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AsyncAcceptedBody" } } }, "description": "Accepted", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Create a session" } }, "/v0/city/{cityName}/sling": { "post": { "operationId": "post-v0-city-by-city-name-sling", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } } ], "requestBody": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SlingInputBody" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SlingResponse" } } }, "description": "OK", "headers": { "Location": { "schema": { "description": "Canonical Run resource URL: the specific run when a graph workflow was launched, otherwise the runs list.", "type": "string" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "409": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Conflict", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name sling" } }, "/v0/city/{cityName}/status": { "get": { "operationId": "get-v0-city-by-city-name-status", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Event sequence number; when provided, blocks until a newer event arrives.", "explode": false, "in": "query", "name": "index", "schema": { "description": "Event sequence number; when provided, blocks until a newer event arrives.", "type": "string" } }, { "description": "How long to block waiting for changes (Go duration string, e.g. 30s). Default 30s, max 2m.", "explode": false, "in": "query", "name": "wait", "schema": { "description": "How long to block waiting for changes (Go duration string, e.g. 30s). Default 30s, max 2m.", "type": "string" } }, { "description": "When true, omit the expensive store-health, session-count, and work-count blocks for low-cost dashboard polls.", "explode": false, "in": "query", "name": "lite", "schema": { "description": "When true, omit the expensive store-health, session-count, and work-count blocks for low-cost dashboard polls.", "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/StatusBody" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name status" } }, "/v0/city/{cityName}/unregister": { "post": { "operationId": "post-v0-city-by-city-name-unregister", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "Supervisor-registered city name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "Supervisor-registered city name.", "type": "string" } } ], "responses": { "202": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AsyncAcceptedResponse" } } }, "description": "Accepted", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Post v0 city by city name unregister" } }, "/v0/city/{cityName}/usage": { "get": { "operationId": "get-v0-city-by-city-name-usage", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Omit the per-session breakdown and return city-level totals only.", "explode": false, "in": "query", "name": "aggregate_only", "schema": { "description": "Omit the per-session breakdown and return city-level totals only.", "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/UsageBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name usage" } }, "/v0/city/{cityName}/wait/{id}": { "get": { "operationId": "get-v0-city-by-city-name-wait-by-id", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Wait bead ID.", "in": "path", "name": "id", "required": true, "schema": { "description": "Wait bead ID.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WaitView" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name wait by ID" } }, "/v0/city/{cityName}/waits": { "get": { "operationId": "get-v0-city-by-city-name-waits", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Filter by wait state.", "explode": false, "in": "query", "name": "state", "schema": { "description": "Filter by wait state.", "type": "string" } }, { "description": "Filter by session ID.", "explode": false, "in": "query", "name": "session", "schema": { "description": "Filter by session ID.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WaitListBody" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "503": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Service Unavailable", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name waits" } }, "/v0/city/{cityName}/workflow/{workflow_id}": { "delete": { "operationId": "delete-v0-city-by-city-name-workflow-by-workflow-id", "parameters": [ { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "in": "header", "name": "X-GC-Request", "required": true, "schema": { "description": "Anti-CSRF header required on mutation requests. Any non-empty value is accepted; the header's presence is what the server checks.", "minLength": 1, "type": "string" } }, { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Workflow (convoy) ID.", "in": "path", "name": "workflow_id", "required": true, "schema": { "description": "Workflow (convoy) ID.", "type": "string" } }, { "description": "Scope kind (city or rig).", "explode": false, "in": "query", "name": "scope_kind", "schema": { "description": "Scope kind (city or rig).", "type": "string" } }, { "description": "Scope reference.", "explode": false, "in": "query", "name": "scope_ref", "schema": { "description": "Scope reference.", "type": "string" } }, { "description": "Permanently delete beads from store.", "explode": false, "in": "query", "name": "delete", "schema": { "description": "Permanently delete beads from store.", "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkflowDeleteResponse" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "401": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unauthorized", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "403": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Forbidden", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Delete v0 city by city name workflow by workflow ID" }, "get": { "operationId": "get-v0-city-by-city-name-workflow-by-workflow-id", "parameters": [ { "description": "City name.", "in": "path", "name": "cityName", "required": true, "schema": { "description": "City name.", "minLength": 1, "pattern": "\\S", "type": "string" } }, { "description": "Workflow (convoy) ID.", "in": "path", "name": "workflow_id", "required": true, "schema": { "description": "Workflow (convoy) ID.", "type": "string" } }, { "description": "Scope kind (city or rig).", "explode": false, "in": "query", "name": "scope_kind", "schema": { "description": "Scope kind (city or rig).", "type": "string" } }, { "description": "Scope reference.", "explode": false, "in": "query", "name": "scope_ref", "schema": { "description": "Scope reference.", "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/WorkflowSnapshotResponse" } } }, "description": "OK", "headers": { "X-GC-Cache-Age-S": { "schema": { "description": "Age in seconds of the CachingStore snapshot that served this response (0 if not applicable).", "format": "double", "type": "number" } }, "X-GC-Index": { "schema": { "description": "Latest event sequence number.", "format": "int64", "minimum": 0, "type": "integer" } }, "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "400": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Bad Request", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "404": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Not Found", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "422": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Unprocessable Entity", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "500": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Internal Server Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 city by city name workflow by workflow ID" } }, "/v0/events": { "get": { "operationId": "get-v0-events", "parameters": [ { "description": "Filter by event type.", "explode": false, "in": "query", "name": "type", "schema": { "description": "Filter by event type.", "type": "string" } }, { "description": "Filter by actor.", "explode": false, "in": "query", "name": "actor", "schema": { "description": "Filter by actor.", "type": "string" } }, { "description": "Filter to events within the last Go duration (e.g. \"5m\").", "explode": false, "in": "query", "name": "since", "schema": { "description": "Filter to events within the last Go duration (e.g. \"5m\").", "type": "string" } }, { "description": "Maximum number of trailing events to return. 0 = no limit. Used by 'gc events --seq' to compute the head cursor cheaply.", "explode": false, "in": "query", "name": "limit", "schema": { "description": "Maximum number of trailing events to return. 0 = no limit. Used by 'gc events --seq' to compute the head cursor cheaply.", "format": "int64", "minimum": 0, "type": "integer" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SupervisorEventListOutputBody" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 events" } }, "/v0/events/stream": { "get": { "description": "Server-Sent Events stream of supervisor-tagged events. Supports reconnection via Last-Event-ID header or after_cursor query param; omitting both starts at the current supervisor event head.", "operationId": "stream-supervisor-events", "parameters": [ { "description": "Reconnect cursor (composite per-city cursor). Omit Last-Event-ID and after_cursor to start at the current supervisor event head.", "in": "header", "name": "Last-Event-ID", "schema": { "description": "Reconnect cursor (composite per-city cursor). Omit Last-Event-ID and after_cursor to start at the current supervisor event head.", "type": "string" } }, { "description": "Alternative to Last-Event-ID for browsers that can't set custom headers. Omit after_cursor and Last-Event-ID to start at the current supervisor event head.", "explode": false, "in": "query", "name": "after_cursor", "schema": { "description": "Alternative to Last-Event-ID for browsers that can't set custom headers. Omit after_cursor and Last-Event-ID to start at the current supervisor event head.", "type": "string" } } ], "responses": { "200": { "content": { "text/event-stream": { "schema": { "description": "Each oneOf object represents one possible SSE message.", "items": { "oneOf": [ { "properties": { "data": { "$ref": "#/components/schemas/HeartbeatEvent" }, "event": { "const": "heartbeat", "description": "The event name.", "type": "string" }, "id": { "description": "The event resume cursor.", "type": "string" }, "retry": { "description": "The retry time in milliseconds.", "type": "integer" } }, "required": [ "data", "event" ], "title": "Event heartbeat", "type": "object" }, { "properties": { "data": { "$ref": "#/components/schemas/TypedTaggedEventStreamEnvelope" }, "event": { "const": "tagged_event", "description": "The event name.", "type": "string" }, "id": { "description": "The event resume cursor.", "type": "string" }, "retry": { "description": "The retry time in milliseconds.", "type": "integer" } }, "required": [ "data", "event" ], "title": "Event tagged_event", "type": "object" } ] }, "title": "Server Sent Events", "type": "array" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Stream tagged events from all running cities." } }, "/v0/provider-readiness": { "get": { "operationId": "get-v0-provider-readiness", "parameters": [ { "description": "Comma-separated list of providers to probe.", "explode": false, "in": "query", "name": "providers", "schema": { "description": "Comma-separated list of providers to probe.", "type": "string" } }, { "description": "Force fresh probe, bypassing cache.", "explode": false, "in": "query", "name": "fresh", "schema": { "description": "Force fresh probe, bypassing cache.", "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProviderReadinessResponse" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 provider readiness" } }, "/v0/readiness": { "get": { "operationId": "get-v0-readiness", "parameters": [ { "description": "Comma-separated list of readiness items to check.", "explode": false, "in": "query", "name": "items", "schema": { "description": "Comma-separated list of readiness items to check.", "type": "string" } }, { "description": "Force fresh probe, bypassing cache.", "explode": false, "in": "query", "name": "fresh", "schema": { "description": "Force fresh probe, bypassing cache.", "type": "boolean" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ReadinessResponse" } } }, "description": "OK", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } }, "default": { "content": { "application/problem+json": { "schema": { "$ref": "#/components/schemas/ErrorModel" } } }, "description": "Error", "headers": { "X-GC-Request-Id": { "$ref": "#/components/headers/X-GC-Request-Id" } } } }, "summary": "Get v0 readiness" } } } }