{ "openapi": "3.1.0", "info": { "title": "agentide-engine", "summary": "Validates intents, plans effects, obtains authority, journals, dispatches, and projects sessions.", "description": "The HTTP surface of `agentide-engine`, one of the components of `agentide` v1.\n\nEvery path here is one semantic command, so the method is always POST and the path is the command's wire name under its domain's: a command is not a resource, and this document does not invent one. A status code is the outcome the specification declares — 202 for a branch that was taken, 422 for a refusal the input decides, 502 for a refusal decided outside the request — and the `outcome` property of every response body names the branch. Events emitted by a branch are published to consumers through the event transport; they are not returned here.\n\nThis component declares `reached_by: network`, so its callers are not deployed with it and this contract is the surface they reach it through. That declaration is also why the views its domains declare have paths here: a GET under `views` per projection, answering every row it holds. There is no page size, no cursor, no ordering and no filter parameter, because the specification states none — a view's filter is part of the projection, not of the request.", "version": "v1", "x-ess-provenance": { "system": "agentide", "specification_version": "v1", "source_digest": "509495079a366d767a747dbfcd22e419c28040b7ff32d15a1f284393168d16ab", "contract_digest": "ed3593ffb7cb447522ffa77d7557ff51fe62a095924f66547513eb2541be2a45" }, "x-ess-reached-by": "network" }, "tags": [ { "name": "coding", "description": "Semantic observation, change, execution, collaboration, evidence, and delivery intents." }, { "name": "coordination", "description": "Durable hosted collaboration references stored by Service SDK without project file bytes." }, { "name": "sessions", "description": "The durable identity and observable projection of one coding session." }, { "name": "surface", "description": "A renderer-neutral virtual workbench shared by agents, the browser, CLI snapshots, and the console TUI." } ], "paths": { "/coding/commands/agent-delegate": { "post": { "operationId": "agentide.coding.DelegateAgent", "summary": "Delegate to agent", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.DelegateAgent` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.DelegateAgent.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.DelegateAgent.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.DelegateAgent.refused.Response" } } } } } } }, "/coding/commands/agent-message": { "post": { "operationId": "agentide.coding.MessageAgent", "summary": "Message agent", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.MessageAgent` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.MessageAgent.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.MessageAgent.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.MessageAgent.refused.Response" } } } } } } }, "/coding/commands/agent-observe": { "post": { "operationId": "agentide.coding.ObserveAgents", "summary": "Observe agents", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.ObserveAgents` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.ObserveAgents.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.ObserveAgents.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.ObserveAgents.refused.Response" } } } } } } }, "/coding/commands/agent-wait": { "post": { "operationId": "agentide.coding.WaitAgent", "summary": "Wait for agents", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.WaitAgent` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.WaitAgent.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.WaitAgent.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.WaitAgent.refused.Response" } } } } } } }, "/coding/commands/code-changes": { "post": { "operationId": "agentide.coding.ObserveChanges", "summary": "Observe code changes", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.ObserveChanges` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.ObserveChanges.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.ObserveChanges.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.ObserveChanges.refused.Response" } } } } } } }, "/coding/commands/code-create": { "post": { "operationId": "agentide.coding.CreateCode", "summary": "Create code", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.CreateCode` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.CreateCode.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.CreateCode.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.CreateCode.refused.Response" } } } } } } }, "/coding/commands/code-delete": { "post": { "operationId": "agentide.coding.DeleteCode", "summary": "Delete code", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.DeleteCode` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.DeleteCode.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.DeleteCode.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.DeleteCode.refused.Response" } } } } } } }, "/coding/commands/code-edit": { "post": { "operationId": "agentide.coding.EditCode", "summary": "Edit code", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.EditCode` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.EditCode.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.EditCode.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.EditCode.refused.Response" } } } } } } }, "/coding/commands/code-publish": { "post": { "operationId": "agentide.coding.PublishCode", "summary": "Publish code", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.PublishCode` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.PublishCode.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.PublishCode.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.PublishCode.refused.Response" } } } } } } }, "/coding/commands/code-read": { "post": { "operationId": "agentide.coding.ReadCode", "summary": "Read code", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.ReadCode` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.ReadCode.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.ReadCode.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.ReadCode.refused.Response" } } } } } } }, "/coding/commands/code-rename": { "post": { "operationId": "agentide.coding.RenameCode", "summary": "Rename code", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.RenameCode` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.RenameCode.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.RenameCode.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.RenameCode.refused.Response" } } } } } } }, "/coding/commands/code-search": { "post": { "operationId": "agentide.coding.SearchCode", "summary": "Search code", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.SearchCode` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.SearchCode.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.SearchCode.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.SearchCode.refused.Response" } } } } } } }, "/coding/commands/code-verify": { "post": { "operationId": "agentide.coding.VerifyCode", "summary": "Verify code", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.VerifyCode` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.VerifyCode.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.VerifyCode.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.VerifyCode.refused.Response" } } } } } } }, "/coding/commands/deployment-apply": { "post": { "operationId": "agentide.coding.ApplyDeployment", "summary": "Apply deployment", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.ApplyDeployment` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.ApplyDeployment.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.ApplyDeployment.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.ApplyDeployment.refused.Response" } } } } } } }, "/coding/commands/deployment-observe": { "post": { "operationId": "agentide.coding.ObserveDeployment", "summary": "Observe deployment", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.ObserveDeployment` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.ObserveDeployment.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.ObserveDeployment.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.ObserveDeployment.refused.Response" } } } } } } }, "/coding/commands/evidence-record": { "post": { "operationId": "agentide.coding.RecordEvidence", "summary": "Record evidence", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.RecordEvidence` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.RecordEvidence.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.RecordEvidence.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.RecordEvidence.refused.Response" } } } } } } }, "/coding/commands/interactive-terminal": { "post": { "operationId": "agentide.coding.OpenInteractiveTerminal", "summary": "Open interactive terminal", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.OpenInteractiveTerminal` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.OpenInteractiveTerminal.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.OpenInteractiveTerminal.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.OpenInteractiveTerminal.refused.Response" } } } } } } }, "/coding/commands/process-cancel": { "post": { "operationId": "agentide.coding.CancelProcess", "summary": "Cancel process", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.CancelProcess` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.CancelProcess.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.CancelProcess.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.CancelProcess.refused.Response" } } } } } } }, "/coding/commands/process-input": { "post": { "operationId": "agentide.coding.InputProcess", "summary": "Write process input", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.InputProcess` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.InputProcess.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.InputProcess.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.InputProcess.refused.Response" } } } } } } }, "/coding/commands/process-observe": { "post": { "operationId": "agentide.coding.ObserveProcess", "summary": "Observe process", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.ObserveProcess` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.ObserveProcess.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.ObserveProcess.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.ObserveProcess.refused.Response" } } } } } } }, "/coding/commands/process-start": { "post": { "operationId": "agentide.coding.StartProcess", "summary": "Start process", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.StartProcess` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.StartProcess.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.StartProcess.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.StartProcess.refused.Response" } } } } } } }, "/coding/commands/process-wait": { "post": { "operationId": "agentide.coding.WaitProcess", "summary": "Wait for process", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.WaitProcess` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.WaitProcess.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.WaitProcess.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.WaitProcess.refused.Response" } } } } } } }, "/coding/commands/release-cut": { "post": { "operationId": "agentide.coding.CutRelease", "summary": "Cut release", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.CutRelease` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.CutRelease.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.CutRelease.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.CutRelease.refused.Response" } } } } } } }, "/coding/commands/terminal-list": { "post": { "operationId": "agentide.coding.ListTerminals", "summary": "List terminals", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.ListTerminals` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.ListTerminals.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.ListTerminals.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.ListTerminals.refused.Response" } } } } } } }, "/coding/commands/terminal-terminate": { "post": { "operationId": "agentide.coding.TerminateTerminal", "summary": "Terminate terminal", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.TerminateTerminal` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.TerminateTerminal.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.TerminateTerminal.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.TerminateTerminal.refused.Response" } } } } } } }, "/coding/commands/worktree-create": { "post": { "operationId": "agentide.coding.CreateWorktree", "summary": "Create worktree", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.CreateWorktree` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.CreateWorktree.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.CreateWorktree.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.CreateWorktree.refused.Response" } } } } } } }, "/coding/commands/worktree-finish": { "post": { "operationId": "agentide.coding.FinishWorktree", "summary": "Finish worktree", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.FinishWorktree` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.FinishWorktree.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.FinishWorktree.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.FinishWorktree.refused.Response" } } } } } } }, "/coding/commands/worktree-status": { "post": { "operationId": "agentide.coding.ObserveWorktree", "summary": "Observe worktree", "tags": [ "coding" ], "x-ess-may-invoke": [ "agentide.coding.CodingAgent" ], "requestBody": { "description": "The input `agentide.coding.ObserveWorktree` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.ObserveWorktree.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.ObserveWorktree.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coding.ObserveWorktree.refused.Response" } } } } } } }, "/coordination/commands/approval-checkpoint-approve": { "post": { "operationId": "agentide.coordination.ApproveCheckpoint", "summary": "Approve exact checkpoint", "tags": [ "coordination" ], "x-ess-may-invoke": [ "agentide.coordination.SessionOwner" ], "requestBody": { "description": "The input `agentide.coordination.ApproveCheckpoint` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.ApproveCheckpoint.Input" } } } }, "responses": { "202": { "description": "Outcome `approved`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.ApproveCheckpoint.approved.Response" } } } }, "409": { "description": "Outcome `wrong-state`: the input was acceptable and the subject is in a state this command does not act from. Resending the same request changes nothing until something else moves it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.ApproveCheckpoint.wrong-state.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.ApproveCheckpoint.refused.Response" } } } } } } }, "/coordination/commands/approval-checkpoint-deny": { "post": { "operationId": "agentide.coordination.DenyCheckpoint", "summary": "Deny exact checkpoint", "tags": [ "coordination" ], "x-ess-may-invoke": [ "agentide.coordination.SessionOwner" ], "requestBody": { "description": "The input `agentide.coordination.DenyCheckpoint` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.DenyCheckpoint.Input" } } } }, "responses": { "202": { "description": "Outcome `denied`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.DenyCheckpoint.denied.Response" } } } }, "409": { "description": "Outcome `wrong-state`: the input was acceptable and the subject is in a state this command does not act from. Resending the same request changes nothing until something else moves it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.DenyCheckpoint.wrong-state.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.DenyCheckpoint.refused.Response" } } } } } } }, "/coordination/commands/approval-checkpoint-record": { "post": { "operationId": "agentide.coordination.RecordApprovalCheckpoint", "summary": "Record approval checkpoint", "tags": [ "coordination" ], "x-ess-may-invoke": [ "agentide.coordination.TaskAuthority" ], "requestBody": { "description": "The input `agentide.coordination.RecordApprovalCheckpoint` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.RecordApprovalCheckpoint.Input" } } } }, "responses": { "202": { "description": "Outcome `recorded`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.RecordApprovalCheckpoint.recorded.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.RecordApprovalCheckpoint.refused.Response" } } } } } } }, "/coordination/commands/context-pin": { "post": { "operationId": "agentide.coordination.PinContext", "summary": "Pin context reference", "tags": [ "coordination" ], "x-ess-may-invoke": [ "agentide.coordination.SessionExecutor", "agentide.coordination.SessionOwner" ], "requestBody": { "description": "The input `agentide.coordination.PinContext` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.PinContext.Input" } } } }, "responses": { "202": { "description": "Outcome `pinned`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.PinContext.pinned.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.PinContext.refused.Response" } } } } } } }, "/coordination/commands/context-unpin": { "post": { "operationId": "agentide.coordination.RemoveContextPin", "summary": "Remove context pin", "tags": [ "coordination" ], "x-ess-may-invoke": [ "agentide.coordination.SessionExecutor", "agentide.coordination.SessionOwner" ], "requestBody": { "description": "The input `agentide.coordination.RemoveContextPin` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.RemoveContextPin.Input" } } } }, "responses": { "202": { "description": "Outcome `removed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.RemoveContextPin.removed.Response" } } } }, "409": { "description": "Outcome `wrong-state`: the input was acceptable and the subject is in a state this command does not act from. Resending the same request changes nothing until something else moves it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.RemoveContextPin.wrong-state.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.RemoveContextPin.refused.Response" } } } } } } }, "/coordination/commands/grant-create": { "post": { "operationId": "agentide.coordination.CreateGrant", "summary": "Create authority grant", "tags": [ "coordination" ], "x-ess-may-invoke": [ "agentide.coordination.SessionOwner" ], "requestBody": { "description": "The input `agentide.coordination.CreateGrant` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.CreateGrant.Input" } } } }, "responses": { "202": { "description": "Outcome `created`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.CreateGrant.created.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.CreateGrant.refused.Response" } } } } } } }, "/coordination/commands/grant-revoke": { "post": { "operationId": "agentide.coordination.RevokeGrant", "summary": "Revoke authority grant", "tags": [ "coordination" ], "x-ess-may-invoke": [ "agentide.coordination.SessionOwner" ], "requestBody": { "description": "The input `agentide.coordination.RevokeGrant` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.RevokeGrant.Input" } } } }, "responses": { "202": { "description": "Outcome `revoked`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.RevokeGrant.revoked.Response" } } } }, "409": { "description": "Outcome `wrong-state`: the input was acceptable and the subject is in a state this command does not act from. Resending the same request changes nothing until something else moves it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.RevokeGrant.wrong-state.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.RevokeGrant.refused.Response" } } } } } } }, "/coordination/views/ApprovalCheckpointSnapshot": { "get": { "operationId": "agentide.coordination.ApprovalCheckpointSnapshot", "summary": "ApprovalCheckpointSnapshot", "tags": [ "coordination" ], "x-ess-consistency": "read_your_writes", "responses": { "200": { "description": "Every row of `agentide.coordination.ApprovalCheckpointSnapshot`, a projection of `agentide.coordination.ApprovalCheckpoint`. Contains every instance. Read-your-writes: a caller that has just issued a command sees its effect here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.ApprovalCheckpointSnapshot.Response" } } } } } } }, "/coordination/views/ContextPinSnapshot": { "get": { "operationId": "agentide.coordination.ContextPinSnapshot", "summary": "ContextPinSnapshot", "tags": [ "coordination" ], "x-ess-consistency": "read_your_writes", "responses": { "200": { "description": "Every row of `agentide.coordination.ContextPinSnapshot`, a projection of `agentide.coordination.ContextPin`. Contains every instance. Read-your-writes: a caller that has just issued a command sees its effect here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.ContextPinSnapshot.Response" } } } } } } }, "/coordination/views/GrantSnapshot": { "get": { "operationId": "agentide.coordination.GrantSnapshot", "summary": "GrantSnapshot", "tags": [ "coordination" ], "x-ess-consistency": "read_your_writes", "responses": { "200": { "description": "Every row of `agentide.coordination.GrantSnapshot`, a projection of `agentide.coordination.AuthorityGrant`. Contains every instance. Read-your-writes: a caller that has just issued a command sees its effect here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.coordination.GrantSnapshot.Response" } } } } } } }, "/sessions/commands/event-read": { "post": { "operationId": "agentide.session.ReadEvents", "summary": "Read session events", "tags": [ "sessions" ], "x-ess-may-invoke": [ "agentide.session.CodingAgent" ], "requestBody": { "description": "The input `agentide.session.ReadEvents` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.session.ReadEvents.Input" } } } }, "responses": { "202": { "description": "Outcome `observed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.session.ReadEvents.observed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.session.ReadEvents.refused.Response" } } } } } } }, "/sessions/commands/hosted-session-ensure": { "post": { "operationId": "agentide.session.EnsureHostedSession", "summary": "Ensure hosted session", "tags": [ "sessions" ], "x-ess-may-invoke": [ "agentide.session.Operator" ], "requestBody": { "description": "The input `agentide.session.EnsureHostedSession` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.session.EnsureHostedSession.Input" } } } }, "responses": { "202": { "description": "Outcome `started`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.session.EnsureHostedSession.started.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.session.EnsureHostedSession.refused.Response" } } } } } } }, "/sessions/commands/session-close": { "post": { "operationId": "agentide.session.CloseSession", "summary": "Close session", "tags": [ "sessions" ], "x-ess-may-invoke": [ "agentide.session.Operator" ], "requestBody": { "description": "The input `agentide.session.CloseSession` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.session.CloseSession.Input" } } } }, "responses": { "202": { "description": "Outcome `closed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.session.CloseSession.closed.Response" } } } }, "409": { "description": "Outcome `wrong-state`: the input was acceptable and the subject is in a state this command does not act from. Resending the same request changes nothing until something else moves it.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.session.CloseSession.wrong-state.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.session.CloseSession.refused.Response" } } } } } } }, "/sessions/commands/session-snapshot": { "post": { "operationId": "agentide.session.SnapshotSession", "summary": "Snapshot session", "tags": [ "sessions" ], "x-ess-may-invoke": [ "agentide.session.CodingAgent" ], "requestBody": { "description": "The input `agentide.session.SnapshotSession` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.session.SnapshotSession.Input" } } } }, "responses": { "202": { "description": "Outcome `observed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.session.SnapshotSession.observed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.session.SnapshotSession.refused.Response" } } } } } } }, "/sessions/commands/session-start": { "post": { "operationId": "agentide.session.StartSession", "summary": "Start session", "tags": [ "sessions" ], "x-ess-may-invoke": [ "agentide.session.Operator" ], "requestBody": { "description": "The input `agentide.session.StartSession` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.session.StartSession.Input" } } } }, "responses": { "202": { "description": "Outcome `started`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.session.StartSession.started.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.session.StartSession.refused.Response" } } } } } } }, "/sessions/views/snapshot": { "get": { "operationId": "agentide.session.SessionSnapshot", "summary": "Session snapshot", "tags": [ "sessions" ], "x-ess-consistency": "read_your_writes", "responses": { "200": { "description": "Every row of `agentide.session.SessionSnapshot`, a projection of `agentide.session.CodingSession`. Contains every instance. Read-your-writes: a caller that has just issued a command sees its effect here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.session.SessionSnapshot.Response" } } } } } } }, "/surface/commands/cursor-move": { "post": { "operationId": "agentide.surface.MoveCursor", "summary": "Move editor cursor", "tags": [ "surface" ], "x-ess-may-invoke": [ "agentide.surface.CodingAgent" ], "requestBody": { "description": "The input `agentide.surface.MoveCursor` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.surface.MoveCursor.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.surface.MoveCursor.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.surface.MoveCursor.refused.Response" } } } } } } }, "/surface/commands/diff-show": { "post": { "operationId": "agentide.surface.ShowDiff", "summary": "Show diff", "tags": [ "surface" ], "x-ess-may-invoke": [ "agentide.surface.CodingAgent" ], "requestBody": { "description": "The input `agentide.surface.ShowDiff` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.surface.ShowDiff.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.surface.ShowDiff.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.surface.ShowDiff.refused.Response" } } } } } } }, "/surface/commands/file-close": { "post": { "operationId": "agentide.surface.CloseFile", "summary": "Close file", "tags": [ "surface" ], "x-ess-may-invoke": [ "agentide.surface.CodingAgent" ], "requestBody": { "description": "The input `agentide.surface.CloseFile` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.surface.CloseFile.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.surface.CloseFile.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.surface.CloseFile.refused.Response" } } } } } } }, "/surface/commands/file-open": { "post": { "operationId": "agentide.surface.OpenFile", "summary": "Open file", "tags": [ "surface" ], "x-ess-may-invoke": [ "agentide.surface.CodingAgent" ], "requestBody": { "description": "The input `agentide.surface.OpenFile` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.surface.OpenFile.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.surface.OpenFile.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.surface.OpenFile.refused.Response" } } } } } } }, "/surface/commands/pane-close": { "post": { "operationId": "agentide.surface.ClosePane", "summary": "Close pane", "tags": [ "surface" ], "x-ess-may-invoke": [ "agentide.surface.CodingAgent" ], "requestBody": { "description": "The input `agentide.surface.ClosePane` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.surface.ClosePane.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.surface.ClosePane.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.surface.ClosePane.refused.Response" } } } } } } }, "/surface/commands/pane-focus": { "post": { "operationId": "agentide.surface.FocusPane", "summary": "Focus pane", "tags": [ "surface" ], "x-ess-may-invoke": [ "agentide.surface.CodingAgent" ], "requestBody": { "description": "The input `agentide.surface.FocusPane` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.surface.FocusPane.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.surface.FocusPane.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.surface.FocusPane.refused.Response" } } } } } } }, "/surface/commands/pane-open": { "post": { "operationId": "agentide.surface.OpenPane", "summary": "Open pane", "tags": [ "surface" ], "x-ess-may-invoke": [ "agentide.surface.CodingAgent" ], "requestBody": { "description": "The input `agentide.surface.OpenPane` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.surface.OpenPane.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.surface.OpenPane.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.surface.OpenPane.refused.Response" } } } } } } }, "/surface/commands/surface-snapshot": { "post": { "operationId": "agentide.surface.SnapshotSurface", "summary": "Snapshot workspace surface", "tags": [ "surface" ], "x-ess-may-invoke": [ "agentide.surface.CodingAgent" ], "requestBody": { "description": "The input `agentide.surface.SnapshotSurface` declares.", "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.surface.SnapshotSurface.Input" } } } }, "responses": { "202": { "description": "Outcome `completed`: the branch the specification declares for this input. Events this branch emits are published to consumers, not returned here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.surface.SnapshotSurface.completed.Response" } } } }, "502": { "description": "Outcome `refused`: something outside the request refused. The input was acceptable, so the caller has nothing to correct and a retry is meaningful.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.surface.SnapshotSurface.refused.Response" } } } } } } }, "/surface/views/workbench": { "get": { "operationId": "agentide.surface.WorkbenchSnapshot", "summary": "Workbench snapshot", "tags": [ "surface" ], "x-ess-consistency": "read_your_writes", "responses": { "200": { "description": "Every row of `agentide.surface.WorkbenchSnapshot`, a projection of `agentide.surface.Workbench`. Contains every instance. Read-your-writes: a caller that has just issued a command sees its effect here.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/agentide.surface.WorkbenchSnapshot.Response" } } } } } } } }, "components": { "schemas": { "agentide.coding.AgentId": { "title": "AgentId", "x-ess-name": "agentide.coding.AgentId", "x-ess-kind": "newtype", "type": "string" }, "agentide.coding.ApplyDeployment.Input": { "title": "Apply deployment input", "x-ess-name": "agentide.coding.ApplyDeployment", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "operation_id": { "$ref": "#/components/schemas/agentide.coding.OperationId" }, "environment": { "type": "string" }, "revision": { "$ref": "#/components/schemas/agentide.coding.ExpectedDigest" } }, "required": [ "session_id", "request_id", "operation_id", "environment", "revision" ], "additionalProperties": false }, "agentide.coding.ApplyDeployment.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.ApplyDeployment.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.CancelProcess.Input": { "title": "Cancel process input", "x-ess-name": "agentide.coding.CancelProcess", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "operation_id": { "$ref": "#/components/schemas/agentide.coding.OperationId" }, "process_id": { "$ref": "#/components/schemas/agentide.coding.ProcessId" }, "signal": { "$ref": "#/components/schemas/agentide.coding.Signal" } }, "required": [ "session_id", "request_id", "operation_id", "process_id", "signal" ], "additionalProperties": false }, "agentide.coding.CancelProcess.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.CancelProcess.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.CreateCode.Input": { "title": "Create code input", "x-ess-name": "agentide.coding.CreateCode", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "operation_id": { "$ref": "#/components/schemas/agentide.coding.OperationId" }, "path": { "$ref": "#/components/schemas/agentide.coding.Path" }, "content": { "type": "string" }, "expected_absent": { "type": "boolean" } }, "required": [ "session_id", "request_id", "operation_id", "path", "content", "expected_absent" ], "additionalProperties": false }, "agentide.coding.CreateCode.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.CreateCode.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.CreateWorktree.Input": { "title": "Create worktree input", "x-ess-name": "agentide.coding.CreateWorktree", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "operation_id": { "$ref": "#/components/schemas/agentide.coding.OperationId" }, "purpose": { "type": "string" }, "base": { "type": "string" } }, "required": [ "session_id", "request_id", "operation_id", "purpose" ], "additionalProperties": false }, "agentide.coding.CreateWorktree.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.CreateWorktree.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.CutRelease.Input": { "title": "Cut release input", "x-ess-name": "agentide.coding.CutRelease", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "operation_id": { "$ref": "#/components/schemas/agentide.coding.OperationId" }, "version": { "type": "string" }, "expected_head": { "$ref": "#/components/schemas/agentide.coding.ExpectedDigest" } }, "required": [ "session_id", "request_id", "operation_id", "version", "expected_head" ], "additionalProperties": false }, "agentide.coding.CutRelease.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.CutRelease.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.DelegateAgent.Input": { "title": "Delegate to agent input", "x-ess-name": "agentide.coding.DelegateAgent", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "operation_id": { "$ref": "#/components/schemas/agentide.coding.OperationId" }, "task": { "type": "string" } }, "required": [ "session_id", "request_id", "operation_id", "task" ], "additionalProperties": false }, "agentide.coding.DelegateAgent.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.DelegateAgent.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.DeleteCode.Input": { "title": "Delete code input", "x-ess-name": "agentide.coding.DeleteCode", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "operation_id": { "$ref": "#/components/schemas/agentide.coding.OperationId" }, "path": { "$ref": "#/components/schemas/agentide.coding.Path" }, "expected_sha256": { "$ref": "#/components/schemas/agentide.coding.ExpectedDigest" } }, "required": [ "session_id", "request_id", "operation_id", "path", "expected_sha256" ], "additionalProperties": false }, "agentide.coding.DeleteCode.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.DeleteCode.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.EditCode.Input": { "title": "Edit code input", "x-ess-name": "agentide.coding.EditCode", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "operation_id": { "$ref": "#/components/schemas/agentide.coding.OperationId" }, "path": { "$ref": "#/components/schemas/agentide.coding.Path" }, "content": { "type": "string" }, "expected_sha256": { "$ref": "#/components/schemas/agentide.coding.ExpectedDigest" } }, "required": [ "session_id", "request_id", "operation_id", "path", "content" ], "additionalProperties": false }, "agentide.coding.EditCode.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.EditCode.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.ExpectedDigest": { "title": "ExpectedDigest", "x-ess-name": "agentide.coding.ExpectedDigest", "x-ess-kind": "newtype", "type": "string" }, "agentide.coding.FinishWorktree.Input": { "title": "Finish worktree input", "x-ess-name": "agentide.coding.FinishWorktree", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "operation_id": { "$ref": "#/components/schemas/agentide.coding.OperationId" } }, "required": [ "session_id", "request_id", "operation_id" ], "additionalProperties": false }, "agentide.coding.FinishWorktree.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.FinishWorktree.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.InputProcess.Input": { "title": "Write process input input", "x-ess-name": "agentide.coding.InputProcess", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "operation_id": { "$ref": "#/components/schemas/agentide.coding.OperationId" }, "process_id": { "$ref": "#/components/schemas/agentide.coding.ProcessId" }, "content": { "type": "string" } }, "required": [ "session_id", "request_id", "operation_id", "process_id", "content" ], "additionalProperties": false }, "agentide.coding.InputProcess.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.InputProcess.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.IntentFailure.Error": { "title": "IntentFailure payload", "description": "The intent was refused or failed without claiming the requested effect happened.", "x-ess-name": "agentide.coding.IntentFailure", "x-ess-kind": "error-payload", "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryable": { "type": "boolean" } }, "required": [ "code", "message", "retryable" ], "additionalProperties": false }, "agentide.coding.ListTerminals.Input": { "title": "List terminals input", "x-ess-name": "agentide.coding.ListTerminals", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" } }, "required": [ "session_id", "request_id" ], "additionalProperties": false }, "agentide.coding.ListTerminals.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.ListTerminals.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.MessageAgent.Input": { "title": "Message agent input", "x-ess-name": "agentide.coding.MessageAgent", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "operation_id": { "$ref": "#/components/schemas/agentide.coding.OperationId" }, "agent_id": { "$ref": "#/components/schemas/agentide.coding.AgentId" }, "message": { "type": "string" } }, "required": [ "session_id", "request_id", "operation_id", "agent_id", "message" ], "additionalProperties": false }, "agentide.coding.MessageAgent.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.MessageAgent.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.ObserveAgents.Input": { "title": "Observe agents input", "x-ess-name": "agentide.coding.ObserveAgents", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" } }, "required": [ "session_id", "request_id" ], "additionalProperties": false }, "agentide.coding.ObserveAgents.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.ObserveAgents.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.ObserveChanges.Input": { "title": "Observe code changes input", "x-ess-name": "agentide.coding.ObserveChanges", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" } }, "required": [ "session_id", "request_id" ], "additionalProperties": false }, "agentide.coding.ObserveChanges.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.ObserveChanges.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.ObserveDeployment.Input": { "title": "Observe deployment input", "x-ess-name": "agentide.coding.ObserveDeployment", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "environment": { "type": "string" } }, "required": [ "session_id", "request_id", "environment" ], "additionalProperties": false }, "agentide.coding.ObserveDeployment.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.ObserveDeployment.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.ObserveProcess.Input": { "title": "Observe process input", "x-ess-name": "agentide.coding.ObserveProcess", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "process_id": { "$ref": "#/components/schemas/agentide.coding.ProcessId" } }, "required": [ "session_id", "request_id", "process_id" ], "additionalProperties": false }, "agentide.coding.ObserveProcess.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.ObserveProcess.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.ObserveWorktree.Input": { "title": "Observe worktree input", "x-ess-name": "agentide.coding.ObserveWorktree", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" } }, "required": [ "session_id", "request_id" ], "additionalProperties": false }, "agentide.coding.ObserveWorktree.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.ObserveWorktree.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.OpenInteractiveTerminal.Input": { "title": "Open interactive terminal input", "x-ess-name": "agentide.coding.OpenInteractiveTerminal", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "operation_id": { "$ref": "#/components/schemas/agentide.coding.OperationId" }, "profile": { "$ref": "#/components/schemas/agentide.coding.TerminalProfile" }, "working_directory": { "$ref": "#/components/schemas/agentide.coding.Path" } }, "required": [ "session_id", "request_id", "operation_id", "profile", "working_directory" ], "additionalProperties": false }, "agentide.coding.OpenInteractiveTerminal.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.OpenInteractiveTerminal.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.OperationId": { "title": "OperationId", "x-ess-name": "agentide.coding.OperationId", "x-ess-kind": "newtype", "type": "string" }, "agentide.coding.Path": { "title": "Path", "x-ess-name": "agentide.coding.Path", "x-ess-kind": "newtype", "type": "string" }, "agentide.coding.Pattern": { "title": "Pattern", "x-ess-name": "agentide.coding.Pattern", "x-ess-kind": "newtype", "type": "string" }, "agentide.coding.ProcessId": { "title": "ProcessId", "x-ess-name": "agentide.coding.ProcessId", "x-ess-kind": "newtype", "type": "string" }, "agentide.coding.ProcessProfile": { "title": "ProcessProfile", "x-ess-name": "agentide.coding.ProcessProfile", "x-ess-kind": "newtype", "type": "string" }, "agentide.coding.PublishCode.Input": { "title": "Publish code input", "x-ess-name": "agentide.coding.PublishCode", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "operation_id": { "$ref": "#/components/schemas/agentide.coding.OperationId" }, "expected_head": { "$ref": "#/components/schemas/agentide.coding.ExpectedDigest" }, "summary": { "type": "string" }, "evidence": { "type": "array", "items": { "type": "string" } } }, "required": [ "session_id", "request_id", "operation_id", "expected_head", "summary", "evidence" ], "additionalProperties": false }, "agentide.coding.PublishCode.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.PublishCode.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.ReadCode.Input": { "title": "Read code input", "x-ess-name": "agentide.coding.ReadCode", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "path": { "$ref": "#/components/schemas/agentide.coding.Path" }, "offset": { "type": "integer" }, "limit_bytes": { "type": "integer" } }, "required": [ "session_id", "request_id", "path", "offset", "limit_bytes" ], "additionalProperties": false }, "agentide.coding.ReadCode.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.ReadCode.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.RecordEvidence.Input": { "title": "Record evidence input", "x-ess-name": "agentide.coding.RecordEvidence", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "operation_id": { "$ref": "#/components/schemas/agentide.coding.OperationId" }, "subject": { "type": "string" }, "kind": { "type": "string" }, "source": { "type": "string" }, "reference": { "type": "string" } }, "required": [ "session_id", "request_id", "operation_id", "subject", "kind", "source" ], "additionalProperties": false }, "agentide.coding.RecordEvidence.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.RecordEvidence.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.RenameCode.Input": { "title": "Rename code input", "x-ess-name": "agentide.coding.RenameCode", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "operation_id": { "$ref": "#/components/schemas/agentide.coding.OperationId" }, "path": { "$ref": "#/components/schemas/agentide.coding.Path" }, "destination": { "$ref": "#/components/schemas/agentide.coding.Path" }, "expected_sha256": { "$ref": "#/components/schemas/agentide.coding.ExpectedDigest" }, "destination_expected_absent": { "type": "boolean" } }, "required": [ "session_id", "request_id", "operation_id", "path", "destination", "expected_sha256", "destination_expected_absent" ], "additionalProperties": false }, "agentide.coding.RenameCode.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.RenameCode.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.SearchCode.Input": { "title": "Search code input", "x-ess-name": "agentide.coding.SearchCode", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "pattern": { "$ref": "#/components/schemas/agentide.coding.Pattern" }, "paths": { "type": "array", "items": { "$ref": "#/components/schemas/agentide.coding.Path" } } }, "required": [ "session_id", "request_id", "pattern", "paths" ], "additionalProperties": false }, "agentide.coding.SearchCode.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.SearchCode.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.Signal": { "title": "Signal", "x-ess-name": "agentide.coding.Signal", "x-ess-kind": "enum", "type": "string", "enum": [ "Interrupt", "Terminate", "Kill" ] }, "agentide.coding.StartProcess.Input": { "title": "Start process input", "x-ess-name": "agentide.coding.StartProcess", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "operation_id": { "$ref": "#/components/schemas/agentide.coding.OperationId" }, "profile": { "$ref": "#/components/schemas/agentide.coding.ProcessProfile" } }, "required": [ "session_id", "request_id", "operation_id", "profile" ], "additionalProperties": false }, "agentide.coding.StartProcess.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.StartProcess.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.TerminalId": { "title": "TerminalId", "x-ess-name": "agentide.coding.TerminalId", "x-ess-kind": "newtype", "type": "string" }, "agentide.coding.TerminalProfile": { "title": "TerminalProfile", "x-ess-name": "agentide.coding.TerminalProfile", "x-ess-kind": "newtype", "type": "string" }, "agentide.coding.TerminateTerminal.Input": { "title": "Terminate terminal input", "x-ess-name": "agentide.coding.TerminateTerminal", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "operation_id": { "$ref": "#/components/schemas/agentide.coding.OperationId" }, "terminal_id": { "$ref": "#/components/schemas/agentide.coding.TerminalId" }, "signal": { "$ref": "#/components/schemas/agentide.coding.Signal" } }, "required": [ "session_id", "request_id", "operation_id", "terminal_id", "signal" ], "additionalProperties": false }, "agentide.coding.TerminateTerminal.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.TerminateTerminal.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.VerificationLevel": { "title": "VerificationLevel", "x-ess-name": "agentide.coding.VerificationLevel", "x-ess-kind": "enum", "type": "string", "enum": [ "Focused", "Full", "Release" ] }, "agentide.coding.VerifyCode.Input": { "title": "Verify code input", "x-ess-name": "agentide.coding.VerifyCode", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "operation_id": { "$ref": "#/components/schemas/agentide.coding.OperationId" }, "level": { "$ref": "#/components/schemas/agentide.coding.VerificationLevel" } }, "required": [ "session_id", "request_id", "operation_id", "level" ], "additionalProperties": false }, "agentide.coding.VerifyCode.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.VerifyCode.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.WaitAgent.Input": { "title": "Wait for agents input", "x-ess-name": "agentide.coding.WaitAgent", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "agent_ids": { "type": "array", "items": { "$ref": "#/components/schemas/agentide.coding.AgentId" } } }, "required": [ "session_id", "request_id", "agent_ids" ], "additionalProperties": false }, "agentide.coding.WaitAgent.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.WaitAgent.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coding.WaitProcess.Input": { "title": "Wait for process input", "x-ess-name": "agentide.coding.WaitProcess", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "process_id": { "$ref": "#/components/schemas/agentide.coding.ProcessId" }, "timeout_ms": { "type": "integer" } }, "required": [ "session_id", "request_id", "process_id", "timeout_ms" ], "additionalProperties": false }, "agentide.coding.WaitProcess.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `IntentCompleted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coding.WaitProcess.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the selected implementation cannot admit or complete the intent.", "properties": { "error": { "const": "agentide.coding.IntentFailure", "description": "The intent was refused or failed without claiming the requested effect happened.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coding.IntentFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coordination.ApprovalCheckpoint.State": { "title": "State", "x-ess-name": "agentide.coordination.ApprovalCheckpoint.State", "x-ess-kind": "enum", "type": "string", "enum": [ "Approved", "Denied", "Pending" ] }, "agentide.coordination.ApprovalCheckpointSnapshot.Response": { "additionalProperties": false, "description": "The rows of `agentide.coordination.ApprovalCheckpointSnapshot`.", "properties": { "rows": { "description": "Every row the projection holds, in the order it holds them.", "items": { "$ref": "#/components/schemas/agentide.coordination.ApprovalCheckpointSnapshot.Row" }, "type": "array" } }, "required": [ "rows" ], "type": "object" }, "agentide.coordination.ApprovalCheckpointSnapshot.Row": { "title": "ApprovalCheckpointSnapshot row", "x-ess-name": "agentide.coordination.ApprovalCheckpointSnapshot", "x-ess-kind": "view-row", "type": "object", "properties": { "checkpoint_id": { "$ref": "#/components/schemas/agentide.coordination.CheckpointId" }, "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "attempt_ref": { "$ref": "#/components/schemas/agentide.coordination.OpaqueRef" }, "plan_digest": { "$ref": "#/components/schemas/agentide.coordination.Digest" }, "checkpoint_ref": { "$ref": "#/components/schemas/agentide.coordination.OpaqueRef" }, "owner": { "type": "string" }, "scopes": { "$ref": "#/components/schemas/agentide.session.SessionScopes" }, "state": { "$ref": "#/components/schemas/agentide.coordination.ApprovalCheckpoint.State" } }, "required": [ "checkpoint_id", "session_id", "attempt_ref", "plan_digest", "checkpoint_ref", "owner", "scopes", "state" ], "additionalProperties": false }, "agentide.coordination.ApproveCheckpoint.Input": { "title": "Approve exact checkpoint input", "x-ess-name": "agentide.coordination.ApproveCheckpoint", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "checkpoint_id": { "$ref": "#/components/schemas/agentide.coordination.CheckpointId" } }, "required": [ "session_id", "request_id", "checkpoint_id" ], "additionalProperties": false }, "agentide.coordination.ApproveCheckpoint.approved.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. A `agentide.coordination.ApprovalCheckpoint` has moved to `Approved`, along `approve`. The instance is the one `checkpoint_id` names. Emits `ApprovalCheckpointApproved`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "approved", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coordination.ApproveCheckpoint.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: durable state is unavailable.", "properties": { "error": { "const": "agentide.coordination.CoordinationRefusal", "description": "The durable coordination mutation was refused.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coordination.CoordinationRefusal.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coordination.ApproveCheckpoint.wrong-state.Response": { "additionalProperties": false, "description": "Taken when the subject is in a state none of this command's declared moves start from. Which states those are is the lifecycle's answer, not this command's.", "properties": { "error": { "const": "agentide.coordination.CoordinationStateConflict", "description": "The selected record is no longer in the required lifecycle state.", "type": "string" }, "outcome": { "const": "wrong-state", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coordination.CoordinationStateConflict.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coordination.AuthorityGrant.State": { "title": "State", "x-ess-name": "agentide.coordination.AuthorityGrant.State", "x-ess-kind": "enum", "type": "string", "enum": [ "Active", "Revoked" ] }, "agentide.coordination.CheckpointId": { "title": "CheckpointId", "x-ess-name": "agentide.coordination.CheckpointId", "x-ess-kind": "newtype", "type": "string" }, "agentide.coordination.ContextKind": { "title": "ContextKind", "x-ess-name": "agentide.coordination.ContextKind", "x-ess-kind": "enum", "type": "string", "enum": [ "Editor", "DiffHunk", "Terminal", "Process", "Evidence" ] }, "agentide.coordination.ContextPin.State": { "title": "State", "x-ess-name": "agentide.coordination.ContextPin.State", "x-ess-kind": "enum", "type": "string", "enum": [ "Active", "Removed" ] }, "agentide.coordination.ContextPinId": { "title": "ContextPinId", "x-ess-name": "agentide.coordination.ContextPinId", "x-ess-kind": "newtype", "type": "string" }, "agentide.coordination.ContextPinSnapshot.Response": { "additionalProperties": false, "description": "The rows of `agentide.coordination.ContextPinSnapshot`.", "properties": { "rows": { "description": "Every row the projection holds, in the order it holds them.", "items": { "$ref": "#/components/schemas/agentide.coordination.ContextPinSnapshot.Row" }, "type": "array" } }, "required": [ "rows" ], "type": "object" }, "agentide.coordination.ContextPinSnapshot.Row": { "title": "ContextPinSnapshot row", "x-ess-name": "agentide.coordination.ContextPinSnapshot", "x-ess-kind": "view-row", "type": "object", "properties": { "pin_id": { "$ref": "#/components/schemas/agentide.coordination.ContextPinId" }, "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "kind": { "$ref": "#/components/schemas/agentide.coordination.ContextKind" }, "reference": { "$ref": "#/components/schemas/agentide.coordination.OpaqueRef" }, "start_line": { "type": "integer" }, "end_line": { "type": "integer" }, "sha256": { "$ref": "#/components/schemas/agentide.coordination.Digest" }, "owner": { "type": "string" }, "scopes": { "$ref": "#/components/schemas/agentide.session.SessionScopes" }, "state": { "$ref": "#/components/schemas/agentide.coordination.ContextPin.State" } }, "required": [ "pin_id", "session_id", "kind", "reference", "sha256", "owner", "scopes", "state" ], "additionalProperties": false }, "agentide.coordination.CoordinationRefusal.Error": { "title": "CoordinationRefusal payload", "description": "The durable coordination mutation was refused.", "x-ess-name": "agentide.coordination.CoordinationRefusal", "x-ess-kind": "error-payload", "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryable": { "type": "boolean" } }, "required": [ "code", "message", "retryable" ], "additionalProperties": false }, "agentide.coordination.CoordinationStateConflict.Error": { "title": "CoordinationStateConflict payload", "description": "The selected record is no longer in the required lifecycle state.", "x-ess-name": "agentide.coordination.CoordinationStateConflict", "x-ess-kind": "error-payload", "type": "object", "properties": { "state": { "type": "string" } }, "required": [ "state" ], "additionalProperties": false }, "agentide.coordination.CreateGrant.Input": { "title": "Create authority grant input", "x-ess-name": "agentide.coordination.CreateGrant", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "grantee": { "$ref": "#/components/schemas/agentide.coordination.SubjectRef" }, "allowed_intents": { "type": "array", "items": { "$ref": "#/components/schemas/agentide.coordination.IntentRef" } }, "path_prefixes": { "type": "array", "items": { "$ref": "#/components/schemas/agentide.coordination.PathPrefix" } }, "maximum_risk": { "$ref": "#/components/schemas/agentide.coordination.GrantRisk" }, "expires_at": { "type": "string" }, "revision": { "type": "integer" } }, "required": [ "session_id", "request_id", "grantee", "allowed_intents", "path_prefixes", "maximum_risk", "revision" ], "additionalProperties": false }, "agentide.coordination.CreateGrant.created.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. A `agentide.coordination.AuthorityGrant` now exists, in `Active`. Its identity is published as `grant_id` on `agentide.coordination.GrantCreated`. Emits `GrantCreated`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "created", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coordination.CreateGrant.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: authority or durable state is unavailable.", "properties": { "error": { "const": "agentide.coordination.CoordinationRefusal", "description": "The durable coordination mutation was refused.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coordination.CoordinationRefusal.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coordination.DenyCheckpoint.Input": { "title": "Deny exact checkpoint input", "x-ess-name": "agentide.coordination.DenyCheckpoint", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "checkpoint_id": { "$ref": "#/components/schemas/agentide.coordination.CheckpointId" } }, "required": [ "session_id", "request_id", "checkpoint_id" ], "additionalProperties": false }, "agentide.coordination.DenyCheckpoint.denied.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. A `agentide.coordination.ApprovalCheckpoint` has moved to `Denied`, along `deny`. The instance is the one `checkpoint_id` names. Emits `ApprovalCheckpointDenied`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "denied", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coordination.DenyCheckpoint.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: durable state is unavailable.", "properties": { "error": { "const": "agentide.coordination.CoordinationRefusal", "description": "The durable coordination mutation was refused.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coordination.CoordinationRefusal.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coordination.DenyCheckpoint.wrong-state.Response": { "additionalProperties": false, "description": "Taken when the subject is in a state none of this command's declared moves start from. Which states those are is the lifecycle's answer, not this command's.", "properties": { "error": { "const": "agentide.coordination.CoordinationStateConflict", "description": "The selected record is no longer in the required lifecycle state.", "type": "string" }, "outcome": { "const": "wrong-state", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coordination.CoordinationStateConflict.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coordination.Digest": { "title": "Digest", "x-ess-name": "agentide.coordination.Digest", "x-ess-kind": "newtype", "type": "string" }, "agentide.coordination.GrantId": { "title": "GrantId", "x-ess-name": "agentide.coordination.GrantId", "x-ess-kind": "newtype", "type": "string" }, "agentide.coordination.GrantRisk": { "title": "GrantRisk", "x-ess-name": "agentide.coordination.GrantRisk", "x-ess-kind": "enum", "type": "string", "enum": [ "Low", "Medium" ] }, "agentide.coordination.GrantSnapshot.Response": { "additionalProperties": false, "description": "The rows of `agentide.coordination.GrantSnapshot`.", "properties": { "rows": { "description": "Every row the projection holds, in the order it holds them.", "items": { "$ref": "#/components/schemas/agentide.coordination.GrantSnapshot.Row" }, "type": "array" } }, "required": [ "rows" ], "type": "object" }, "agentide.coordination.GrantSnapshot.Row": { "title": "GrantSnapshot row", "x-ess-name": "agentide.coordination.GrantSnapshot", "x-ess-kind": "view-row", "type": "object", "properties": { "grant_id": { "$ref": "#/components/schemas/agentide.coordination.GrantId" }, "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "grantee": { "$ref": "#/components/schemas/agentide.coordination.SubjectRef" }, "allowed_intents": { "type": "array", "items": { "$ref": "#/components/schemas/agentide.coordination.IntentRef" } }, "path_prefixes": { "type": "array", "items": { "$ref": "#/components/schemas/agentide.coordination.PathPrefix" } }, "maximum_risk": { "$ref": "#/components/schemas/agentide.coordination.GrantRisk" }, "expires_at": { "type": "string" }, "revision": { "type": "integer" }, "owner": { "type": "string" }, "scopes": { "$ref": "#/components/schemas/agentide.session.SessionScopes" }, "state": { "$ref": "#/components/schemas/agentide.coordination.AuthorityGrant.State" } }, "required": [ "grant_id", "session_id", "grantee", "allowed_intents", "path_prefixes", "maximum_risk", "revision", "owner", "scopes", "state" ], "additionalProperties": false }, "agentide.coordination.IntentRef": { "title": "IntentRef", "x-ess-name": "agentide.coordination.IntentRef", "x-ess-kind": "newtype", "type": "string" }, "agentide.coordination.OpaqueRef": { "title": "OpaqueRef", "x-ess-name": "agentide.coordination.OpaqueRef", "x-ess-kind": "newtype", "type": "string" }, "agentide.coordination.PathPrefix": { "title": "PathPrefix", "x-ess-name": "agentide.coordination.PathPrefix", "x-ess-kind": "newtype", "type": "string" }, "agentide.coordination.PinContext.Input": { "title": "Pin context reference input", "x-ess-name": "agentide.coordination.PinContext", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "kind": { "$ref": "#/components/schemas/agentide.coordination.ContextKind" }, "reference": { "$ref": "#/components/schemas/agentide.coordination.OpaqueRef" }, "start_line": { "type": "integer" }, "end_line": { "type": "integer" }, "sha256": { "$ref": "#/components/schemas/agentide.coordination.Digest" } }, "required": [ "session_id", "request_id", "kind", "reference", "sha256" ], "additionalProperties": false }, "agentide.coordination.PinContext.pinned.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. A `agentide.coordination.ContextPin` now exists, in `Active`. Its identity is published as `pin_id` on `agentide.coordination.ContextPinned`. Emits `ContextPinned`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "pinned", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coordination.PinContext.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the reference cannot be admitted or durable state is unavailable.", "properties": { "error": { "const": "agentide.coordination.CoordinationRefusal", "description": "The durable coordination mutation was refused.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coordination.CoordinationRefusal.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coordination.RecordApprovalCheckpoint.Input": { "title": "Record approval checkpoint input", "x-ess-name": "agentide.coordination.RecordApprovalCheckpoint", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "checkpoint_id": { "$ref": "#/components/schemas/agentide.coordination.CheckpointId" }, "attempt_ref": { "$ref": "#/components/schemas/agentide.coordination.OpaqueRef" }, "plan_digest": { "$ref": "#/components/schemas/agentide.coordination.Digest" }, "checkpoint_ref": { "$ref": "#/components/schemas/agentide.coordination.OpaqueRef" } }, "required": [ "session_id", "request_id", "checkpoint_id", "attempt_ref", "plan_digest", "checkpoint_ref" ], "additionalProperties": false }, "agentide.coordination.RecordApprovalCheckpoint.recorded.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. A `agentide.coordination.ApprovalCheckpoint` now exists, in `Pending`. Its identity is published as `checkpoint_id` on `agentide.coordination.ApprovalCheckpointRecorded`. Emits `ApprovalCheckpointRecorded`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "recorded", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coordination.RecordApprovalCheckpoint.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: durable state is unavailable.", "properties": { "error": { "const": "agentide.coordination.CoordinationRefusal", "description": "The durable coordination mutation was refused.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coordination.CoordinationRefusal.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coordination.RemoveContextPin.Input": { "title": "Remove context pin input", "x-ess-name": "agentide.coordination.RemoveContextPin", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "pin_id": { "$ref": "#/components/schemas/agentide.coordination.ContextPinId" } }, "required": [ "session_id", "request_id", "pin_id" ], "additionalProperties": false }, "agentide.coordination.RemoveContextPin.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: durable state is unavailable.", "properties": { "error": { "const": "agentide.coordination.CoordinationRefusal", "description": "The durable coordination mutation was refused.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coordination.CoordinationRefusal.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coordination.RemoveContextPin.removed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. A `agentide.coordination.ContextPin` has moved to `Removed`, along `remove`. The instance is the one `pin_id` names. Emits `ContextPinRemoved`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "removed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coordination.RemoveContextPin.wrong-state.Response": { "additionalProperties": false, "description": "Taken when the subject is in a state none of this command's declared moves start from. Which states those are is the lifecycle's answer, not this command's.", "properties": { "error": { "const": "agentide.coordination.CoordinationStateConflict", "description": "The selected record is no longer in the required lifecycle state.", "type": "string" }, "outcome": { "const": "wrong-state", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coordination.CoordinationStateConflict.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coordination.RevokeGrant.Input": { "title": "Revoke authority grant input", "x-ess-name": "agentide.coordination.RevokeGrant", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "grant_id": { "$ref": "#/components/schemas/agentide.coordination.GrantId" } }, "required": [ "session_id", "request_id", "grant_id" ], "additionalProperties": false }, "agentide.coordination.RevokeGrant.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: durable state is unavailable.", "properties": { "error": { "const": "agentide.coordination.CoordinationRefusal", "description": "The durable coordination mutation was refused.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coordination.CoordinationRefusal.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coordination.RevokeGrant.revoked.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. A `agentide.coordination.AuthorityGrant` has moved to `Revoked`, along `revoke`. The instance is the one `grant_id` names. Emits `GrantRevoked`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "revoked", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.coordination.RevokeGrant.wrong-state.Response": { "additionalProperties": false, "description": "Taken when the subject is in a state none of this command's declared moves start from. Which states those are is the lifecycle's answer, not this command's.", "properties": { "error": { "const": "agentide.coordination.CoordinationStateConflict", "description": "The selected record is no longer in the required lifecycle state.", "type": "string" }, "outcome": { "const": "wrong-state", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.coordination.CoordinationStateConflict.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.coordination.SubjectRef": { "title": "SubjectRef", "x-ess-name": "agentide.coordination.SubjectRef", "x-ess-kind": "newtype", "type": "string" }, "agentide.session.CloseSession.Input": { "title": "Close session input", "x-ess-name": "agentide.session.CloseSession", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" } }, "required": [ "session_id", "request_id" ], "additionalProperties": false }, "agentide.session.CloseSession.closed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. A `agentide.session.CodingSession` has moved to `Closed`, along `close`. The instance is the one `session_id` names. Emits `SessionClosed`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "closed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.session.CloseSession.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: durable state cannot be updated.", "properties": { "error": { "const": "agentide.session.SessionRefusal", "description": "The session operation was not admitted or could not be observed exactly.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.session.SessionRefusal.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.session.CloseSession.wrong-state.Response": { "additionalProperties": false, "description": "Taken when the subject is in a state none of this command's declared moves start from. Which states those are is the lifecycle's answer, not this command's.", "properties": { "error": { "const": "agentide.session.SessionStateConflict", "description": "The session is not in a state this command acts from.", "type": "string" }, "outcome": { "const": "wrong-state", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.session.SessionStateConflict.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.session.CodingSession.State": { "title": "State", "x-ess-name": "agentide.session.CodingSession.State", "x-ess-kind": "enum", "type": "string", "enum": [ "Active", "Closed" ] }, "agentide.session.Cursor": { "title": "Cursor", "x-ess-name": "agentide.session.Cursor", "x-ess-kind": "newtype", "type": "integer" }, "agentide.session.EnsureHostedSession.Input": { "title": "Ensure hosted session input", "x-ess-name": "agentide.session.EnsureHostedSession", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "workspace_root": { "$ref": "#/components/schemas/agentide.session.WorkspaceRoot" }, "objective": { "type": "string" }, "project_id": { "$ref": "#/components/schemas/agentide.session.ProjectId" }, "source_revision": { "$ref": "#/components/schemas/agentide.session.SourceRevision" }, "workspace_session_id": { "$ref": "#/components/schemas/agentide.session.WorkspaceSessionId" }, "manifest_digest": { "$ref": "#/components/schemas/agentide.session.ManifestDigest" }, "scopes": { "$ref": "#/components/schemas/agentide.session.SessionScopes" } }, "required": [ "session_id", "workspace_root", "objective", "project_id", "source_revision", "workspace_session_id", "manifest_digest", "scopes" ], "additionalProperties": false }, "agentide.session.EnsureHostedSession.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the hosted workspace or durable coordination binding is unavailable.", "properties": { "error": { "const": "agentide.session.SessionRefusal", "description": "The session operation was not admitted or could not be observed exactly.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.session.SessionRefusal.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.session.EnsureHostedSession.started.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. A `agentide.session.CodingSession` now exists, in `Active`. Its identity is published as `session_id` on `agentide.session.SessionStarted`. Emits `SessionStarted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "started", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.session.EventLimit": { "title": "EventLimit", "x-ess-name": "agentide.session.EventLimit", "x-ess-kind": "newtype", "type": "integer" }, "agentide.session.ManifestDigest": { "title": "ManifestDigest", "x-ess-name": "agentide.session.ManifestDigest", "x-ess-kind": "newtype", "type": "string" }, "agentide.session.ProjectId": { "title": "ProjectId", "x-ess-name": "agentide.session.ProjectId", "x-ess-kind": "newtype", "type": "string" }, "agentide.session.ReadEvents.Input": { "title": "Read session events input", "x-ess-name": "agentide.session.ReadEvents", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "after": { "$ref": "#/components/schemas/agentide.session.Cursor" }, "limit": { "$ref": "#/components/schemas/agentide.session.EventLimit" } }, "required": [ "session_id", "request_id", "limit" ], "additionalProperties": false }, "agentide.session.ReadEvents.observed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `SessionObserved`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "observed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.session.ReadEvents.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the requested event window cannot be represented.", "properties": { "error": { "const": "agentide.session.SessionRefusal", "description": "The session operation was not admitted or could not be observed exactly.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.session.SessionRefusal.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.session.RequestId": { "title": "RequestId", "x-ess-name": "agentide.session.RequestId", "x-ess-kind": "newtype", "type": "string" }, "agentide.session.SessionId": { "title": "SessionId", "x-ess-name": "agentide.session.SessionId", "x-ess-kind": "newtype", "type": "string" }, "agentide.session.SessionRefusal.Error": { "title": "SessionRefusal payload", "description": "The session operation was not admitted or could not be observed exactly.", "x-ess-name": "agentide.session.SessionRefusal", "x-ess-kind": "error-payload", "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryable": { "type": "boolean" } }, "required": [ "code", "message", "retryable" ], "additionalProperties": false }, "agentide.session.SessionScopes": { "title": "SessionScopes", "x-ess-name": "agentide.session.SessionScopes", "x-ess-kind": "struct", "type": "object", "properties": { "principal": { "type": "string" }, "team": { "type": "string" }, "project": { "type": "string" } }, "additionalProperties": false }, "agentide.session.SessionSnapshot.Response": { "additionalProperties": false, "description": "The rows of `agentide.session.SessionSnapshot`.", "properties": { "rows": { "description": "Every row the projection holds, in the order it holds them.", "items": { "$ref": "#/components/schemas/agentide.session.SessionSnapshot.Row" }, "type": "array" } }, "required": [ "rows" ], "type": "object" }, "agentide.session.SessionSnapshot.Row": { "title": "Session snapshot row", "x-ess-name": "agentide.session.SessionSnapshot", "x-ess-kind": "view-row", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "workspace_root": { "$ref": "#/components/schemas/agentide.session.WorkspaceRoot" }, "objective": { "type": "string" }, "project_id": { "$ref": "#/components/schemas/agentide.session.ProjectId" }, "source_revision": { "$ref": "#/components/schemas/agentide.session.SourceRevision" }, "workspace_session_id": { "$ref": "#/components/schemas/agentide.session.WorkspaceSessionId" }, "manifest_digest": { "$ref": "#/components/schemas/agentide.session.ManifestDigest" }, "owner": { "type": "string" }, "scopes": { "$ref": "#/components/schemas/agentide.session.SessionScopes" }, "state": { "$ref": "#/components/schemas/agentide.session.CodingSession.State" } }, "required": [ "session_id", "workspace_root", "objective", "owner", "scopes", "state" ], "additionalProperties": false }, "agentide.session.SessionStateConflict.Error": { "title": "SessionStateConflict payload", "description": "The session is not in a state this command acts from.", "x-ess-name": "agentide.session.SessionStateConflict", "x-ess-kind": "error-payload", "type": "object", "properties": { "state": { "$ref": "#/components/schemas/agentide.session.CodingSession.State" } }, "required": [ "state" ], "additionalProperties": false }, "agentide.session.SnapshotSession.Input": { "title": "Snapshot session input", "x-ess-name": "agentide.session.SnapshotSession", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" } }, "required": [ "session_id", "request_id" ], "additionalProperties": false }, "agentide.session.SnapshotSession.observed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. Emits `SessionObserved`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "observed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.session.SnapshotSession.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the durable session cannot be read exactly.", "properties": { "error": { "const": "agentide.session.SessionRefusal", "description": "The session operation was not admitted or could not be observed exactly.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.session.SessionRefusal.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.session.SourceRevision": { "title": "SourceRevision", "x-ess-name": "agentide.session.SourceRevision", "x-ess-kind": "newtype", "type": "string" }, "agentide.session.StartSession.Input": { "title": "Start session input", "x-ess-name": "agentide.session.StartSession", "x-ess-kind": "command-input", "type": "object", "properties": { "workspace_root": { "$ref": "#/components/schemas/agentide.session.WorkspaceRoot" }, "objective": { "type": "string" }, "project_id": { "$ref": "#/components/schemas/agentide.session.ProjectId" }, "source_revision": { "$ref": "#/components/schemas/agentide.session.SourceRevision" }, "workspace_session_id": { "$ref": "#/components/schemas/agentide.session.WorkspaceSessionId" }, "manifest_digest": { "$ref": "#/components/schemas/agentide.session.ManifestDigest" }, "scopes": { "$ref": "#/components/schemas/agentide.session.SessionScopes" } }, "required": [ "workspace_root", "objective", "scopes" ], "additionalProperties": false }, "agentide.session.StartSession.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the workspace or standalone binding is unavailable.", "properties": { "error": { "const": "agentide.session.SessionRefusal", "description": "The session operation was not admitted or could not be observed exactly.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.session.SessionRefusal.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.session.StartSession.started.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. A `agentide.session.CodingSession` now exists, in `Active`. Its identity is published as `session_id` on `agentide.session.SessionStarted`. Emits `SessionStarted`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "started", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.session.WorkspaceRoot": { "title": "WorkspaceRoot", "x-ess-name": "agentide.session.WorkspaceRoot", "x-ess-kind": "newtype", "type": "string" }, "agentide.session.WorkspaceSessionId": { "title": "WorkspaceSessionId", "x-ess-name": "agentide.session.WorkspaceSessionId", "x-ess-kind": "newtype", "type": "string" }, "agentide.surface.CloseFile.Input": { "title": "Close file input", "x-ess-name": "agentide.surface.CloseFile", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "path": { "$ref": "#/components/schemas/agentide.coding.Path" }, "panes": { "type": "array", "items": { "$ref": "#/components/schemas/agentide.surface.PaneSnapshot" } }, "focused_pane": { "$ref": "#/components/schemas/agentide.surface.PaneId" }, "open_files": { "type": "array", "items": { "$ref": "#/components/schemas/agentide.coding.Path" } } }, "required": [ "session_id", "request_id", "path", "panes", "open_files" ], "additionalProperties": false }, "agentide.surface.CloseFile.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. A `agentide.surface.Workbench` has changed, and its state is unchanged. The instance is the one `session_id` names. Emits `FileClosed`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.surface.CloseFile.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the requested surface state is unavailable.", "properties": { "error": { "const": "agentide.surface.SurfaceFailure", "description": "The requested virtual-surface transition was refused or could not be projected.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.surface.SurfaceFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.surface.ClosePane.Input": { "title": "Close pane input", "x-ess-name": "agentide.surface.ClosePane", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "pane_id": { "$ref": "#/components/schemas/agentide.surface.PaneId" }, "panes": { "type": "array", "items": { "$ref": "#/components/schemas/agentide.surface.PaneSnapshot" } }, "focused_pane": { "$ref": "#/components/schemas/agentide.surface.PaneId" }, "open_files": { "type": "array", "items": { "$ref": "#/components/schemas/agentide.coding.Path" } } }, "required": [ "session_id", "request_id", "pane_id", "panes", "open_files" ], "additionalProperties": false }, "agentide.surface.ClosePane.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. A `agentide.surface.Workbench` has changed, and its state is unchanged. The instance is the one `session_id` names. Emits `PaneClosed`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.surface.ClosePane.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the requested surface state is unavailable.", "properties": { "error": { "const": "agentide.surface.SurfaceFailure", "description": "The requested virtual-surface transition was refused or could not be projected.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.surface.SurfaceFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.surface.FocusPane.Input": { "title": "Focus pane input", "x-ess-name": "agentide.surface.FocusPane", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "pane_id": { "$ref": "#/components/schemas/agentide.surface.PaneId" }, "panes": { "type": "array", "items": { "$ref": "#/components/schemas/agentide.surface.PaneSnapshot" } }, "focused_pane": { "$ref": "#/components/schemas/agentide.surface.PaneId" }, "open_files": { "type": "array", "items": { "$ref": "#/components/schemas/agentide.coding.Path" } } }, "required": [ "session_id", "request_id", "pane_id", "panes", "open_files" ], "additionalProperties": false }, "agentide.surface.FocusPane.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. A `agentide.surface.Workbench` has changed, and its state is unchanged. The instance is the one `session_id` names. Emits `PaneFocused`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.surface.FocusPane.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the requested surface state is unavailable.", "properties": { "error": { "const": "agentide.surface.SurfaceFailure", "description": "The requested virtual-surface transition was refused or could not be projected.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.surface.SurfaceFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.surface.MoveCursor.Input": { "title": "Move editor cursor input", "x-ess-name": "agentide.surface.MoveCursor", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "pane_id": { "$ref": "#/components/schemas/agentide.surface.PaneId" }, "path": { "$ref": "#/components/schemas/agentide.coding.Path" }, "line": { "type": "integer" }, "column": { "type": "integer" }, "panes": { "type": "array", "items": { "$ref": "#/components/schemas/agentide.surface.PaneSnapshot" } }, "focused_pane": { "$ref": "#/components/schemas/agentide.surface.PaneId" }, "open_files": { "type": "array", "items": { "$ref": "#/components/schemas/agentide.coding.Path" } } }, "required": [ "session_id", "request_id", "pane_id", "path", "line", "column", "panes", "open_files" ], "additionalProperties": false }, "agentide.surface.MoveCursor.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. A `agentide.surface.Workbench` has changed, and its state is unchanged. The instance is the one `session_id` names. Emits `CursorMoved`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.surface.MoveCursor.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the requested surface state is unavailable.", "properties": { "error": { "const": "agentide.surface.SurfaceFailure", "description": "The requested virtual-surface transition was refused or could not be projected.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.surface.SurfaceFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.surface.OpenFile.Input": { "title": "Open file input", "x-ess-name": "agentide.surface.OpenFile", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "path": { "$ref": "#/components/schemas/agentide.coding.Path" }, "line": { "type": "integer" }, "pane_id": { "$ref": "#/components/schemas/agentide.surface.PaneId" }, "panes": { "type": "array", "items": { "$ref": "#/components/schemas/agentide.surface.PaneSnapshot" } }, "focused_pane": { "$ref": "#/components/schemas/agentide.surface.PaneId" }, "open_files": { "type": "array", "items": { "$ref": "#/components/schemas/agentide.coding.Path" } } }, "required": [ "session_id", "request_id", "path", "panes", "open_files" ], "additionalProperties": false }, "agentide.surface.OpenFile.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. A `agentide.surface.Workbench` has changed, and its state is unchanged. The instance is the one `session_id` names. Emits `FileOpened`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.surface.OpenFile.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the requested surface state is unavailable.", "properties": { "error": { "const": "agentide.surface.SurfaceFailure", "description": "The requested virtual-surface transition was refused or could not be projected.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.surface.SurfaceFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.surface.OpenPane.Input": { "title": "Open pane input", "x-ess-name": "agentide.surface.OpenPane", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "pane_id": { "$ref": "#/components/schemas/agentide.surface.PaneId" }, "kind": { "$ref": "#/components/schemas/agentide.surface.PaneKind" }, "split": { "$ref": "#/components/schemas/agentide.surface.SplitDirection" }, "panes": { "type": "array", "items": { "$ref": "#/components/schemas/agentide.surface.PaneSnapshot" } }, "focused_pane": { "$ref": "#/components/schemas/agentide.surface.PaneId" }, "open_files": { "type": "array", "items": { "$ref": "#/components/schemas/agentide.coding.Path" } } }, "required": [ "session_id", "request_id", "pane_id", "kind", "panes", "open_files" ], "additionalProperties": false }, "agentide.surface.OpenPane.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. A `agentide.surface.Workbench` has changed, and its state is unchanged. The instance is the one `session_id` names. Emits `PaneOpened`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.surface.OpenPane.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the requested surface state is unavailable.", "properties": { "error": { "const": "agentide.surface.SurfaceFailure", "description": "The requested virtual-surface transition was refused or could not be projected.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.surface.SurfaceFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.surface.PaneId": { "title": "PaneId", "x-ess-name": "agentide.surface.PaneId", "x-ess-kind": "newtype", "type": "string" }, "agentide.surface.PaneKind": { "title": "PaneKind", "x-ess-name": "agentide.surface.PaneKind", "x-ess-kind": "enum", "type": "string", "enum": [ "Editor", "Diff", "Terminal", "Chat", "Timeline", "Agents", "Approvals", "Evidence" ] }, "agentide.surface.PaneSnapshot": { "title": "PaneSnapshot", "x-ess-name": "agentide.surface.PaneSnapshot", "x-ess-kind": "struct", "type": "object", "properties": { "id": { "$ref": "#/components/schemas/agentide.surface.PaneId" }, "kind": { "$ref": "#/components/schemas/agentide.surface.PaneKind" }, "title": { "type": "string" }, "path": { "$ref": "#/components/schemas/agentide.coding.Path" }, "line": { "type": "integer" }, "column": { "type": "integer" } }, "required": [ "id", "kind", "title" ], "additionalProperties": false }, "agentide.surface.ShowDiff.Input": { "title": "Show diff input", "x-ess-name": "agentide.surface.ShowDiff", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "pane_id": { "$ref": "#/components/schemas/agentide.surface.PaneId" }, "path": { "$ref": "#/components/schemas/agentide.coding.Path" }, "base": { "type": "string" }, "panes": { "type": "array", "items": { "$ref": "#/components/schemas/agentide.surface.PaneSnapshot" } }, "focused_pane": { "$ref": "#/components/schemas/agentide.surface.PaneId" }, "open_files": { "type": "array", "items": { "$ref": "#/components/schemas/agentide.coding.Path" } } }, "required": [ "session_id", "request_id", "panes", "open_files" ], "additionalProperties": false }, "agentide.surface.ShowDiff.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. A `agentide.surface.Workbench` has changed, and its state is unchanged. The instance is the one `session_id` names. Emits `DiffShown`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.surface.ShowDiff.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the requested surface state is unavailable.", "properties": { "error": { "const": "agentide.surface.SurfaceFailure", "description": "The requested virtual-surface transition was refused or could not be projected.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.surface.SurfaceFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.surface.SnapshotSurface.Input": { "title": "Snapshot workspace surface input", "x-ess-name": "agentide.surface.SnapshotSurface", "x-ess-kind": "command-input", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "request_id": { "$ref": "#/components/schemas/agentide.session.RequestId" }, "panes": { "type": "array", "items": { "$ref": "#/components/schemas/agentide.surface.PaneSnapshot" } }, "focused_pane": { "$ref": "#/components/schemas/agentide.surface.PaneId" }, "open_files": { "type": "array", "items": { "$ref": "#/components/schemas/agentide.coding.Path" } } }, "required": [ "session_id", "request_id", "panes", "open_files" ], "additionalProperties": false }, "agentide.surface.SnapshotSurface.completed.Response": { "additionalProperties": false, "description": "Taken when no other outcome's condition matched. A `agentide.surface.Workbench` now exists, in `Active`. Its identity is published as `session_id` on `agentide.surface.SurfaceObserved`. Emits `SurfaceObserved`, published to consumers rather than returned here.", "properties": { "outcome": { "const": "completed", "description": "Which declared outcome the command took." } }, "required": [ "outcome" ], "type": "object" }, "agentide.surface.SnapshotSurface.refused.Response": { "additionalProperties": false, "description": "Decided outside the request: the requested surface state is unavailable.", "properties": { "error": { "const": "agentide.surface.SurfaceFailure", "description": "The requested virtual-surface transition was refused or could not be projected.", "type": "string" }, "outcome": { "const": "refused", "description": "Which declared outcome the command took." }, "payload": { "$ref": "#/components/schemas/agentide.surface.SurfaceFailure.Error" } }, "required": [ "outcome", "error", "payload" ], "type": "object" }, "agentide.surface.SplitDirection": { "title": "SplitDirection", "x-ess-name": "agentide.surface.SplitDirection", "x-ess-kind": "enum", "type": "string", "enum": [ "Horizontal", "Vertical" ] }, "agentide.surface.SurfaceFailure.Error": { "title": "SurfaceFailure payload", "description": "The requested virtual-surface transition was refused or could not be projected.", "x-ess-name": "agentide.surface.SurfaceFailure", "x-ess-kind": "error-payload", "type": "object", "properties": { "code": { "type": "string" }, "message": { "type": "string" }, "retryable": { "type": "boolean" } }, "required": [ "code", "message", "retryable" ], "additionalProperties": false }, "agentide.surface.WorkbenchSnapshot.Response": { "additionalProperties": false, "description": "The rows of `agentide.surface.WorkbenchSnapshot`.", "properties": { "rows": { "description": "Every row the projection holds, in the order it holds them.", "items": { "$ref": "#/components/schemas/agentide.surface.WorkbenchSnapshot.Row" }, "type": "array" } }, "required": [ "rows" ], "type": "object" }, "agentide.surface.WorkbenchSnapshot.Row": { "title": "Workbench snapshot row", "x-ess-name": "agentide.surface.WorkbenchSnapshot", "x-ess-kind": "view-row", "type": "object", "properties": { "session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "coding_session_id": { "$ref": "#/components/schemas/agentide.session.SessionId" }, "panes": { "type": "array", "items": { "$ref": "#/components/schemas/agentide.surface.PaneSnapshot" } }, "focused_pane": { "$ref": "#/components/schemas/agentide.surface.PaneId" }, "open_files": { "type": "array", "items": { "$ref": "#/components/schemas/agentide.coding.Path" } }, "owner": { "type": "string" }, "scopes": { "$ref": "#/components/schemas/agentide.session.SessionScopes" } }, "required": [ "session_id", "coding_session_id", "panes", "open_files", "owner", "scopes" ], "additionalProperties": false } } }, "x-ess-entities": { "agentide.coding.Path": { "title": "Path", "x-ess-name": "agentide.coding.Path", "x-ess-kind": "newtype", "type": "string" }, "agentide.coordination.ApprovalCheckpoint": { "title": "ApprovalCheckpoint", "x-ess-name": "agentide.coordination.ApprovalCheckpoint", "x-ess-kind": "entity", "type": "object", "properties": { "checkpoint_id": { "$ref": "#/x-ess-entities/agentide.coordination.CheckpointId" }, "session_id": { "$ref": "#/x-ess-entities/agentide.session.SessionId" }, "attempt_ref": { "$ref": "#/x-ess-entities/agentide.coordination.OpaqueRef" }, "plan_digest": { "$ref": "#/x-ess-entities/agentide.coordination.Digest" }, "checkpoint_ref": { "$ref": "#/x-ess-entities/agentide.coordination.OpaqueRef" }, "owner": { "type": "string" }, "scopes": { "$ref": "#/x-ess-entities/agentide.session.SessionScopes" }, "state": { "$ref": "#/x-ess-entities/agentide.coordination.ApprovalCheckpoint.State" } }, "required": [ "checkpoint_id", "session_id", "attempt_ref", "plan_digest", "checkpoint_ref", "owner", "scopes", "state" ], "additionalProperties": false }, "agentide.coordination.ApprovalCheckpoint.State": { "title": "State", "x-ess-name": "agentide.coordination.ApprovalCheckpoint.State", "x-ess-kind": "enum", "type": "string", "enum": [ "Approved", "Denied", "Pending" ] }, "agentide.coordination.AuthorityGrant": { "title": "AuthorityGrant", "x-ess-name": "agentide.coordination.AuthorityGrant", "x-ess-kind": "entity", "type": "object", "properties": { "grant_id": { "$ref": "#/x-ess-entities/agentide.coordination.GrantId" }, "session_id": { "$ref": "#/x-ess-entities/agentide.session.SessionId" }, "grantee": { "$ref": "#/x-ess-entities/agentide.coordination.SubjectRef" }, "allowed_intents": { "type": "array", "items": { "$ref": "#/x-ess-entities/agentide.coordination.IntentRef" } }, "path_prefixes": { "type": "array", "items": { "$ref": "#/x-ess-entities/agentide.coordination.PathPrefix" } }, "maximum_risk": { "$ref": "#/x-ess-entities/agentide.coordination.GrantRisk" }, "expires_at": { "type": "string" }, "revision": { "type": "integer" }, "owner": { "type": "string" }, "scopes": { "$ref": "#/x-ess-entities/agentide.session.SessionScopes" }, "state": { "$ref": "#/x-ess-entities/agentide.coordination.AuthorityGrant.State" } }, "required": [ "grant_id", "session_id", "grantee", "allowed_intents", "path_prefixes", "maximum_risk", "revision", "owner", "scopes", "state" ], "additionalProperties": false }, "agentide.coordination.AuthorityGrant.State": { "title": "State", "x-ess-name": "agentide.coordination.AuthorityGrant.State", "x-ess-kind": "enum", "type": "string", "enum": [ "Active", "Revoked" ] }, "agentide.coordination.CheckpointId": { "title": "CheckpointId", "x-ess-name": "agentide.coordination.CheckpointId", "x-ess-kind": "newtype", "type": "string" }, "agentide.coordination.ContextKind": { "title": "ContextKind", "x-ess-name": "agentide.coordination.ContextKind", "x-ess-kind": "enum", "type": "string", "enum": [ "Editor", "DiffHunk", "Terminal", "Process", "Evidence" ] }, "agentide.coordination.ContextPin": { "title": "ContextPin", "x-ess-name": "agentide.coordination.ContextPin", "x-ess-kind": "entity", "type": "object", "properties": { "pin_id": { "$ref": "#/x-ess-entities/agentide.coordination.ContextPinId" }, "session_id": { "$ref": "#/x-ess-entities/agentide.session.SessionId" }, "kind": { "$ref": "#/x-ess-entities/agentide.coordination.ContextKind" }, "reference": { "$ref": "#/x-ess-entities/agentide.coordination.OpaqueRef" }, "start_line": { "type": "integer" }, "end_line": { "type": "integer" }, "sha256": { "$ref": "#/x-ess-entities/agentide.coordination.Digest" }, "owner": { "type": "string" }, "scopes": { "$ref": "#/x-ess-entities/agentide.session.SessionScopes" }, "state": { "$ref": "#/x-ess-entities/agentide.coordination.ContextPin.State" } }, "required": [ "pin_id", "session_id", "kind", "reference", "sha256", "owner", "scopes", "state" ], "additionalProperties": false }, "agentide.coordination.ContextPin.State": { "title": "State", "x-ess-name": "agentide.coordination.ContextPin.State", "x-ess-kind": "enum", "type": "string", "enum": [ "Active", "Removed" ] }, "agentide.coordination.ContextPinId": { "title": "ContextPinId", "x-ess-name": "agentide.coordination.ContextPinId", "x-ess-kind": "newtype", "type": "string" }, "agentide.coordination.Digest": { "title": "Digest", "x-ess-name": "agentide.coordination.Digest", "x-ess-kind": "newtype", "type": "string" }, "agentide.coordination.GrantId": { "title": "GrantId", "x-ess-name": "agentide.coordination.GrantId", "x-ess-kind": "newtype", "type": "string" }, "agentide.coordination.GrantRisk": { "title": "GrantRisk", "x-ess-name": "agentide.coordination.GrantRisk", "x-ess-kind": "enum", "type": "string", "enum": [ "Low", "Medium" ] }, "agentide.coordination.IntentRef": { "title": "IntentRef", "x-ess-name": "agentide.coordination.IntentRef", "x-ess-kind": "newtype", "type": "string" }, "agentide.coordination.OpaqueRef": { "title": "OpaqueRef", "x-ess-name": "agentide.coordination.OpaqueRef", "x-ess-kind": "newtype", "type": "string" }, "agentide.coordination.PathPrefix": { "title": "PathPrefix", "x-ess-name": "agentide.coordination.PathPrefix", "x-ess-kind": "newtype", "type": "string" }, "agentide.coordination.SubjectRef": { "title": "SubjectRef", "x-ess-name": "agentide.coordination.SubjectRef", "x-ess-kind": "newtype", "type": "string" }, "agentide.session.CodingSession": { "title": "CodingSession", "x-ess-name": "agentide.session.CodingSession", "x-ess-kind": "entity", "type": "object", "properties": { "session_id": { "$ref": "#/x-ess-entities/agentide.session.SessionId" }, "workspace_root": { "$ref": "#/x-ess-entities/agentide.session.WorkspaceRoot" }, "objective": { "type": "string" }, "project_id": { "$ref": "#/x-ess-entities/agentide.session.ProjectId" }, "source_revision": { "$ref": "#/x-ess-entities/agentide.session.SourceRevision" }, "workspace_session_id": { "$ref": "#/x-ess-entities/agentide.session.WorkspaceSessionId" }, "manifest_digest": { "$ref": "#/x-ess-entities/agentide.session.ManifestDigest" }, "owner": { "type": "string" }, "scopes": { "$ref": "#/x-ess-entities/agentide.session.SessionScopes" }, "state": { "$ref": "#/x-ess-entities/agentide.session.CodingSession.State" } }, "required": [ "session_id", "workspace_root", "objective", "owner", "scopes", "state" ], "additionalProperties": false }, "agentide.session.CodingSession.State": { "title": "State", "x-ess-name": "agentide.session.CodingSession.State", "x-ess-kind": "enum", "type": "string", "enum": [ "Active", "Closed" ] }, "agentide.session.ManifestDigest": { "title": "ManifestDigest", "x-ess-name": "agentide.session.ManifestDigest", "x-ess-kind": "newtype", "type": "string" }, "agentide.session.ProjectId": { "title": "ProjectId", "x-ess-name": "agentide.session.ProjectId", "x-ess-kind": "newtype", "type": "string" }, "agentide.session.SessionId": { "title": "SessionId", "x-ess-name": "agentide.session.SessionId", "x-ess-kind": "newtype", "type": "string" }, "agentide.session.SessionScopes": { "title": "SessionScopes", "x-ess-name": "agentide.session.SessionScopes", "x-ess-kind": "struct", "type": "object", "properties": { "principal": { "type": "string" }, "team": { "type": "string" }, "project": { "type": "string" } }, "additionalProperties": false }, "agentide.session.SourceRevision": { "title": "SourceRevision", "x-ess-name": "agentide.session.SourceRevision", "x-ess-kind": "newtype", "type": "string" }, "agentide.session.WorkspaceRoot": { "title": "WorkspaceRoot", "x-ess-name": "agentide.session.WorkspaceRoot", "x-ess-kind": "newtype", "type": "string" }, "agentide.session.WorkspaceSessionId": { "title": "WorkspaceSessionId", "x-ess-name": "agentide.session.WorkspaceSessionId", "x-ess-kind": "newtype", "type": "string" }, "agentide.surface.PaneId": { "title": "PaneId", "x-ess-name": "agentide.surface.PaneId", "x-ess-kind": "newtype", "type": "string" }, "agentide.surface.PaneKind": { "title": "PaneKind", "x-ess-name": "agentide.surface.PaneKind", "x-ess-kind": "enum", "type": "string", "enum": [ "Editor", "Diff", "Terminal", "Chat", "Timeline", "Agents", "Approvals", "Evidence" ] }, "agentide.surface.PaneSnapshot": { "title": "PaneSnapshot", "x-ess-name": "agentide.surface.PaneSnapshot", "x-ess-kind": "struct", "type": "object", "properties": { "id": { "$ref": "#/x-ess-entities/agentide.surface.PaneId" }, "kind": { "$ref": "#/x-ess-entities/agentide.surface.PaneKind" }, "title": { "type": "string" }, "path": { "$ref": "#/x-ess-entities/agentide.coding.Path" }, "line": { "type": "integer" }, "column": { "type": "integer" } }, "required": [ "id", "kind", "title" ], "additionalProperties": false }, "agentide.surface.Workbench": { "title": "Workbench", "x-ess-name": "agentide.surface.Workbench", "x-ess-kind": "entity", "type": "object", "properties": { "session_id": { "$ref": "#/x-ess-entities/agentide.session.SessionId" }, "coding_session_id": { "$ref": "#/x-ess-entities/agentide.session.SessionId", "x-ess-relation": { "name": "session", "kind": "references", "source": "agentide.surface.Workbench", "target": "agentide.session.CodingSession", "cardinality": "one", "via": "coding_session_id", "$ref": "#/x-ess-entities/agentide.session.CodingSession" } }, "panes": { "type": "array", "items": { "$ref": "#/x-ess-entities/agentide.surface.PaneSnapshot" } }, "focused_pane": { "$ref": "#/x-ess-entities/agentide.surface.PaneId" }, "open_files": { "type": "array", "items": { "$ref": "#/x-ess-entities/agentide.coding.Path" } }, "owner": { "type": "string" }, "scopes": { "$ref": "#/x-ess-entities/agentide.session.SessionScopes" }, "state": { "$ref": "#/x-ess-entities/agentide.surface.Workbench.State" } }, "required": [ "session_id", "coding_session_id", "panes", "open_files", "owner", "scopes", "state" ], "additionalProperties": false }, "agentide.surface.Workbench.State": { "title": "State", "x-ess-name": "agentide.surface.Workbench.State", "x-ess-kind": "enum", "type": "string", "enum": [ "Active" ] } } }