@ellipsis-dev/sdk 0.10.0 → 0.12.0

package/schema/openapi.v1.json

@@ -29,7 +29,6 @@
             "$ref": "#/components/schemas/AgentConfigEllipsis",
             "default": {
               "enabled": true,
-              "ide": true,
               "interactive": true,
               "metadata": {
                 "annotations": {},
@@ -44,12 +43,6 @@
               "compute": {},
               "hooks": {},
               "image": {},
-              "ports": [
-                3000,
-                5173,
-                8000,
-                8080
-              ],
               "repositories": [],
               "variables": []
             }
@@ -277,7 +270,7 @@
         "description": "The `codex:` block \u2014 run this agent on OpenAI's Codex CLI instead of\nClaude Code. Declaring the block at all is what selects the harness\n(`AgentConfig.harness`).\n\nDeliberately a small subset of `AgentConfigClaude`: the fields omitted here\nare ones Codex has no equivalent for (`effort`, `fallback_model`,\n`settings`) or that the platform does not yet wire through for this harness\n(`max_turns`, `skills`, MCP servers). They are omitted rather than\naccepted-and-ignored, because `StrictConfigModel` forbids extra keys \u2014 so a\nconfig that sets one fails loudly at parse time instead of silently not doing\nit. The budget still bounds a run regardless.",
         "properties": {
           "model": {
-            "default": "bedrock-gpt-5.6-terra",
+            "default": "gpt-5.6-terra",
             "title": "Model",
             "type": "string"
           },
@@ -425,7 +418,7 @@
       },
       "AgentConfigEllipsis": {
         "additionalProperties": false,
-        "description": "The Ellipsis product namespace for a config file: which schema this is\n(`version`), the human-facing identity (`name`/`description`), freeform\norganizational `metadata`, whether the agent is `enabled`, and the two\nhuman-access flags (`interactive`/`ide`). The presence of a top-level\n`ellipsis:` mapping is what marks a YAML file as an Ellipsis agent config (vs\narbitrary YAML that merely lives under a config directory) \u2014 see\n`yaml_is_ellipsis_config`.\n\n`enabled`/`interactive`/`ide` are agent behavior, not freeform metadata, so\nthey stay inside the config `sha` (only `metadata` is sha-excluded).\n`interactive` and `ide` are sibling human-access flags: `interactive` lets a\nhuman `agent session connect` to a live session (CLI relay); `ide` lets a\nhuman open an editor / a port URL into the sandbox. Neither decides whether a\nsession is ephemeral or durable \u2014 that is the trigger's job.",
+        "description": "The Ellipsis product namespace for a config file: which schema this is\n(`version`), the human-facing identity (`name`/`description`), freeform\norganizational `metadata`, whether the agent is `enabled`, and the\nhuman-access flag `interactive`. The presence of a top-level `ellipsis:`\nmapping is what marks a YAML file as an Ellipsis agent config (vs arbitrary\nYAML that merely lives under a config directory) \u2014 see\n`yaml_is_ellipsis_config`.\n\n`enabled`/`interactive` are agent behavior, not freeform metadata, so they\nstay inside the config `sha` (only `metadata` is sha-excluded).\n`interactive` lets a human `agent session connect` to a live session (CLI\nrelay). It does not decide whether a session is ephemeral or durable \u2014 that\nis the trigger's job.",
         "properties": {
           "description": {
             "anyOf": [
@@ -443,11 +436,6 @@
             "title": "Enabled",
             "type": "boolean"
           },
-          "ide": {
-            "default": true,
-            "title": "Ide",
-            "type": "boolean"
-          },
           "interactive": {
             "default": true,
             "title": "Interactive",
@@ -527,19 +515,6 @@
             "$ref": "#/components/schemas/AgentConfigEnvironmentImage",
             "default": {}
           },
-          "ports": {
-            "default": [
-              3000,
-              5173,
-              8000,
-              8080
-            ],
-            "items": {
-              "type": "integer"
-            },
-            "title": "Ports",
-            "type": "array"
-          },
           "repositories": {
             "default": [],
             "items": {
@@ -622,7 +597,7 @@
       },
       "AgentConfigEnvironmentVariable": {
         "additionalProperties": false,
-        "description": "One environment variable injected into the agent's sandbox.\n\n`value`, when set, is a literal injected as-is \u2014 use it for non-secret\nconfig (LOG_LEVEL, an API base URL). When `value` is omitted the value is\nresolved at run time from the account's sandbox-secrets store (dashboard\n/ `PUT /secrets`) by `name`, so a secret can be injected without\never putting it in the config file. Either way the variable only reaches\nagents that name it.",
+        "description": "One environment variable injected into the agent's sandbox.\n\n`value`, when set, is a literal injected as-is \u2014 use it for non-secret\nconfig (LOG_LEVEL, an API base URL). When `value` is omitted the value is\nresolved at run time from the account's sandbox-secrets store (dashboard\n/ `PUT /v1/secrets`) by `name`, so a secret can be injected without\never putting it in the config file. Either way the variable only reaches\nagents that name it.",
         "properties": {
           "name": {
             "title": "Name",
@@ -688,7 +663,7 @@
       },
       "AgentConfigInput": {
         "additionalProperties": false,
-        "description": "The typed input contract: what goes INTO a session (the trigger is\nwhen it happens; this is what goes in).\n\n`json_schema` types the payload a caller-started session takes\n(`POST /sessions` `input`, validated at the door; required when\ndeclared). It is illegal on a react-triggered agent \u2014 react payloads are\nplatform-shaped (the published surface field sets), not caller-shaped.\n\n`message` is the initial-message template: exact `{{path}}` substitution\nover the caller payload (or, on a react agent, over the surface's\npublished fields), no conditionals/loops/filters. Refs are validated at\ndeploy time against the governing field set (see AgentConfig's\n`_check_input`).",
+        "description": "The typed input contract: what goes INTO a session (the trigger is\nwhen it happens; this is what goes in).\n\n`json_schema` types the payload a caller-started session takes\n(`POST /v1/sessions` `input`, validated at the door; required when\ndeclared). It is illegal on a react-triggered agent \u2014 react payloads are\nplatform-shaped (the published surface field sets), not caller-shaped.\n\n`message` is the initial-message template: exact `{{path}}` substitution\nover the caller payload (or, on a react agent, over the surface's\npublished fields), no conditionals/loops/filters. Refs are validated at\ndeploy time against the governing field set (see AgentConfig's\n`_check_input`).",
         "properties": {
           "json_schema": {
             "anyOf": [
@@ -839,7 +814,7 @@
       },
       "AgentConfigOutput": {
         "additionalProperties": false,
-        "description": "The typed output contract: the JSON Schema the agent must exit through\n(the StructuredOutput exit tool). Read back via\nGET /sessions/{id}/output.",
+        "description": "The typed output contract: the JSON Schema the agent must exit through\n(the StructuredOutput exit tool). Read back via\nGET /v1/sessions/{id}/output.",
         "properties": {
           "json_schema": {
             "additionalProperties": true,
@@ -1083,6 +1058,16 @@
           "file": {
             "title": "File",
             "type": "string"
+          },
+          "repository": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/AgentConfigRepository"
+              },
+              {
+                "type": "null"
+              }
+            ]
           }
         },
         "required": [
@@ -1849,7 +1834,7 @@
         "description": "A device-flow poll from the CLI.",
         "properties": {
           "device_code": {
-            "description": "The device code returned by POST /auth/cli/start.",
+            "description": "The device code returned by POST /v1/auth/cli/start.",
             "title": "Device Code",
             "type": "string"
           }
@@ -1974,6 +1959,10 @@
             "description": "The last commit the config was synced from.",
             "title": "Last Synced Commit Sha"
           },
+          "managed_by": {
+            "$ref": "#/components/schemas/ConfigManagedBy",
+            "description": "Which writer owns this agent. \"github\" agents are defined by a file in a repository and are changed by editing that file; \"api\" agents have no file and are changed through this API."
+          },
           "name": {
             "anyOf": [
               {
@@ -2015,11 +2004,21 @@
           "sha",
           "created_at",
           "updated_at",
+          "managed_by",
           "agent_config"
         ],
         "title": "Config",
         "type": "object"
       },
+      "ConfigManagedBy": {
+        "description": "Which writer owns an agent: the repository file it is defined in, or\nthis API. Every agent has exactly one owner, fixed when it is created and\nchanged only by linking or unlinking it.",
+        "enum": [
+          "github",
+          "api"
+        ],
+        "title": "ConfigManagedBy",
+        "type": "string"
+      },
       "ContributorUsage": {
         "description": "An author who merged a pull request in the window. The pull-request and\nline counts cover their merged pull requests; `reviews` counts reviews this\nperson also submitted.",
         "properties": {
@@ -2079,7 +2078,7 @@
         "type": "object"
       },
       "CreateAgentConfigRequest": {
-        "description": "Parameters for creating an agent config via a pull request. Exactly\none of config or template_id must be set.",
+        "description": "Parameters for creating an agent config. Exactly one of config or\ntemplate_id must be set.",
         "properties": {
           "config": {
             "anyOf": [
@@ -2101,13 +2100,20 @@
                 "type": "null"
               }
             ],
-            "description": "File path within the repo. Omit for the default agents/<slug>.yaml; if set it must be a location the config sync scans (a .yaml/.yml file under agents/, .agents/, ellipsis/, or .ellipsis/ at any depth).",
+            "description": "File path within the repo, when a repository is named. Omit for the default agents/<slug>.yaml; if set it must be a location the config sync scans (a .yaml/.yml file under agents/, .agents/, ellipsis/, or .ellipsis/ at any depth).",
             "title": "Path"
           },
           "repository": {
-            "description": "Target repository name within the caller's account; the owner is always the account, so pass a bare name (e.g. \"my-service\"), not \"owner/my-service\".",
-            "title": "Repository",
-            "type": "string"
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Define the agent as a file in this repository: Ellipsis opens a pull request adding it, and the agent goes live when that merges. Repository name within the caller's account; the owner is always the account, so pass a bare name (e.g. \"my-service\"), not \"owner/my-service\". Omit to create the agent through the API alone, with no file and live immediately.",
+            "title": "Repository"
           },
           "template_id": {
             "anyOf": [
@@ -2118,38 +2124,47 @@
                 "type": "null"
               }
             ],
-            "description": "A gallery template slug (see GET /agents/templates).",
+            "description": "A gallery template slug (see GET /v1/agents/templates).",
             "title": "Template Id"
           }
         },
-        "required": [
-          "repository"
-        ],
         "title": "CreateAgentConfigRequest",
         "type": "object"
       },
       "CreateAgentConfigResponse": {
-        "description": "The created agent config and the pull request that adds its file.",
+        "description": "The created agent config, plus the pull request that adds its file when\none was opened.",
         "properties": {
           "config": {
             "$ref": "#/components/schemas/Config",
             "description": "The created agent config."
           },
           "path": {
-            "description": "The file path the config was written to.",
-            "title": "Path",
-            "type": "string"
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The file path the config was written to, or null when the agent has no file.",
+            "title": "Path"
           },
           "pull_request_url": {
-            "description": "The pull request that adds the config file. The agent becomes live once it merges and syncs.",
-            "title": "Pull Request Url",
-            "type": "string"
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The pull request that adds the config file. The agent becomes live once it merges and syncs. Null when no repository was named: the agent is already live.",
+            "title": "Pull Request Url"
           }
         },
         "required": [
-          "config",
-          "path",
-          "pull_request_url"
+          "config"
         ],
         "title": "CreateAgentConfigResponse",
         "type": "object"
@@ -2795,21 +2810,6 @@
         "title": "GetIntegrationsResponse",
         "type": "object"
       },
-      "GetSessionIdeResponse": {
-        "description": "The IDE link for a session's live sandbox.",
-        "properties": {
-          "url": {
-            "description": "The membership-gated dashboard page for the session's sandbox. The page performs the proxy handoff itself, so the URL carries no credential \u2014 safe to share with any org member, in a transcript, or in a Slack message.",
-            "title": "Url",
-            "type": "string"
-          }
-        },
-        "required": [
-          "url"
-        ],
-        "title": "GetSessionIdeResponse",
-        "type": "object"
-      },
       "GetSessionLogResponse": {
         "description": "The session log manifest: the complete, ordered, downloadable history\nof the session \u2014 every record (agent output, tool calls, thinking,\nlifecycle events, sandbox output, message events), archived into\nseq-ranged segments. For a running session `latest_feed_seq` may exceed\n`archived_through_feed_seq`; `has_more` tells the client whether the\nmanifest is the whole story yet.",
         "properties": {
@@ -2871,27 +2871,6 @@
         "title": "GetSessionLogResponse",
         "type": "object"
       },
-      "GetSessionPortResponse": {
-        "description": "A preview link for a port in a session's live sandbox.",
-        "properties": {
-          "port": {
-            "description": "The sandbox port the link previews.",
-            "title": "Port",
-            "type": "integer"
-          },
-          "url": {
-            "description": "The same membership-gated dashboard page as the IDE URL, deep-linked to a preview port (a dev server the agent or the IDE user started).",
-            "title": "Url",
-            "type": "string"
-          }
-        },
-        "required": [
-          "url",
-          "port"
-        ],
-        "title": "GetSessionPortResponse",
-        "type": "object"
-      },
       "GetUsageDashboardResponse": {
         "description": "The account's usage over a period: token and cost totals, a per-day\nseries, and a per-model breakdown. Costs are in millicents (1000 = $0.01);\ntoken counts include cache reads and writes \u2014 everything the runs were\ncharged for.",
         "properties": {
@@ -3846,6 +3825,59 @@
         "title": "LinearTeamsListResponse",
         "type": "object"
       },
+      "LinkAgentConfigRequest": {
+        "description": "Where to put the config file of an agent being moved into a repository.",
+        "properties": {
+          "path": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "File path within the repo. Omit for the default agents/<slug>.yaml; if set it must be a location the config sync scans (a .yaml/.yml file under agents/, .agents/, ellipsis/, or .ellipsis/ at any depth).",
+            "title": "Path"
+          },
+          "repository": {
+            "description": "Repository name within the caller's account; the owner is always the account, so pass a bare name (e.g. \"my-service\"), not \"owner/my-service\".",
+            "title": "Repository",
+            "type": "string"
+          }
+        },
+        "required": [
+          "repository"
+        ],
+        "title": "LinkAgentConfigRequest",
+        "type": "object"
+      },
+      "LinkAgentConfigResponse": {
+        "description": "The agent and the pull request that would put it in a repository.",
+        "properties": {
+          "config": {
+            "$ref": "#/components/schemas/Config",
+            "description": "The agent, still managed through the API until the pull request merges."
+          },
+          "path": {
+            "description": "The file path the config will be written to.",
+            "title": "Path",
+            "type": "string"
+          },
+          "pull_request_url": {
+            "description": "The pull request that adds the config file. The agent becomes managed by that file once it merges.",
+            "title": "Pull Request Url",
+            "type": "string"
+          }
+        },
+        "required": [
+          "config",
+          "path",
+          "pull_request_url"
+        ],
+        "title": "LinkAgentConfigResponse",
+        "type": "object"
+      },
       "LinkedGithubIdentity": {
         "description": "The GitHub identity linked to a Slack member.",
         "properties": {
@@ -4119,7 +4151,7 @@
         "type": "object"
       },
       "ModelManufacturer": {
-        "description": "Who BUILT a model. Never who serves it.\n\nServing path is irrelevant here. Anthropic built every Claude model, so all of\nthem are ANTHROPIC whether we reach them through the first-party Anthropic API\nor through Bedrock -- a choice made per request by the llm_providers chain, so\nit is not even a fixed property of the model. Likewise the `bedrock-gpt-5.6-*`\nrows are OPENAI (OpenAI's models, served by AWS), and GLM is ZAI (Z.ai's model,\nserved by Concentrate).\n\nSo this is deliberately NOT derived from `EgressRoute.provider`: routing is an\ninfrastructure fact that changes when we move a model between providers, while\nthe manufacturer is a property of the model itself and never changes.\n\nThe frontend renders a vendor logo per model, which is why it needs the maker.\nKeying that UI off the egress provider would put an AWS logo on a GPT model and\nan OpenAI logo on GLM.",
+        "description": "Who BUILT a model. Never who serves it.\n\nServing path is irrelevant here. Anthropic built every Claude model, so all of\nthem are ANTHROPIC whether we reach them through the first-party Anthropic API\nor through Bedrock -- a choice made per request by the llm_providers chain, so\nit is not even a fixed property of the model. Likewise the `gpt-5.6-*` rows\nare OPENAI (OpenAI's models, served by AWS via bedrock-mantle), and GLM is ZAI\n(Z.ai's model, served by Concentrate).\n\nSo this is deliberately NOT derived from `EgressRoute.provider`: routing is an\ninfrastructure fact that changes when we move a model between providers, while\nthe manufacturer is a property of the model itself and never changes.\n\nThe frontend renders a vendor logo per model, which is why it needs the maker.\nKeying that UI off the egress provider would put an AWS logo on a GPT model and\nan OpenAI logo on GLM.",
         "enum": [
           "anthropic",
           "openai",
@@ -6705,7 +6737,7 @@
         "type": "object"
       },
       "Session": {
-        "description": "An agent session: one conversation with an agent, from trigger to\nterminal state. Returned by `GET /sessions/{id}` and carried by the\nsession stream's `session`/`snapshot` frames \u2014 REST and stream never\ndisagree about what a session looks like.",
+        "description": "An agent session: one conversation with an agent, from trigger to\nterminal state. Returned by `GET /v1/sessions/{id}` and carried by the\nsession stream's `session`/`snapshot` frames \u2014 REST and stream never\ndisagree about what a session looks like.",
         "properties": {
           "attribution": {
             "$ref": "#/components/schemas/SessionAttribution",
@@ -6715,18 +6747,6 @@
             "$ref": "#/components/schemas/SessionBudget",
             "description": "The spend budget enforced for this session."
           },
-          "client_version": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Version of the client that started the session, if reported.",
-            "title": "Client Version"
-          },
           "config_id": {
             "anyOf": [
               {
@@ -6739,19 +6759,6 @@
             "description": "Identifier of the saved agent config the session ran on, if any.",
             "title": "Config Id"
           },
-          "config_override": {
-            "anyOf": [
-              {
-                "additionalProperties": true,
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "The partial-config diff applied for this run; null when the config was unmodified.",
-            "title": "Config Override"
-          },
           "context_repository": {
             "anyOf": [
               {
@@ -6887,30 +6894,6 @@
             "$ref": "#/components/schemas/SessionPrompting",
             "description": "Whether a client may send this session a message and, when it may not, the reason to show instead of a composer."
           },
-          "sandbox_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Identifier of the sandbox the session runs in, if any.",
-            "title": "Sandbox Id"
-          },
-          "session_key": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Key identifying the durable conversation this session belongs to, or null for single-shot sessions.",
-            "title": "Session Key"
-          },
           "session_state": {
             "anyOf": [
               {
@@ -6966,29 +6949,6 @@
             "format": "date-time",
             "title": "Updated At",
             "type": "string"
-          },
-          "webhook_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Identifier of the webhook event that triggered the session, if any.",
-            "title": "Webhook Id"
-          },
-          "webhook_type": {
-            "anyOf": [
-              {
-                "$ref": "#/components/schemas/WebhookType"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Type of the webhook event that triggered the session, if any."
           }
         },
         "required": [
@@ -8059,7 +8019,7 @@
             "title": "Next Cursor"
           },
           "sessions": {
-            "description": "Lean wire rows \u2014 the same shape GET /sessions/{id} and the stream's session frames carry. The heavy blobs (config snapshot, input/output) live on the detail endpoints.",
+            "description": "Lean wire rows \u2014 the same shape GET /v1/sessions/{id} and the stream's session frames carry. The heavy blobs (config snapshot, input/output) live on the detail endpoints.",
             "items": {
               "$ref": "#/components/schemas/Session"
             },
@@ -8675,6 +8635,20 @@
         "title": "TranscriptIngestResult",
         "type": "object"
       },
+      "UpdateAgentConfigRequest": {
+        "description": "A replacement definition for an agent managed through the API.",
+        "properties": {
+          "config": {
+            "$ref": "#/components/schemas/AgentConfig",
+            "description": "The agent's new definition. Replaces the previous one wholesale \u2014 this is not a partial update."
+          }
+        },
+        "required": [
+          "config"
+        ],
+        "title": "UpdateAgentConfigRequest",
+        "type": "object"
+      },
       "UsageDailyPoint": {
         "description": "One day's usage: tokens split by type, and cost split into the four\nbilled categories. `tokens` is the sum of the four token types.",
         "properties": {
@@ -8812,27 +8786,6 @@
         "title": "ValidationError",
         "type": "object"
       },
-      "WebhookType": {
-        "enum": [
-          "github.issue",
-          "github.issue_comment",
-          "github.push",
-          "github.pull_request",
-          "github.pull_request_comment",
-          "github.pull_request_review",
-          "github.pull_request_review_comment",
-          "slack.app_mention",
-          "slack.message",
-          "slack.channel_created",
-          "linear.issue",
-          "linear.issue_comment",
-          "sentry.event_alert",
-          "sentry.metric_alert",
-          "user.message"
-        ],
-        "title": "WebhookType",
-        "type": "string"
-      },
       "WhoAmIResponse": {
         "description": "The identity behind the caller's credential.",
         "properties": {
@@ -8920,7 +8873,7 @@
   },
   "openapi": "3.1.0",
   "paths": {
-    "/agents/configs": {
+    "/v1/agents/configs": {
       "get": {
         "description": "List saved agent configs.",
         "operationId": "list_agent_configs",
@@ -8996,7 +8949,7 @@
         "x-ellipsis-sdk-method": "agents.configs.list"
       },
       "post": {
-        "description": "Create an agent config via pull request.\n\nThe PR adds the config file to agents/ on the target\nrepository; the agent goes live when it merges.\n\nAccepts an inline config or a gallery template slug. 409 when\nanother live agent already holds the name.",
+        "description": "Create an agent config.\n\nName a repository and Ellipsis opens a pull request adding the\nconfig file to agents/ there; the agent goes live when it\nmerges. Omit it and the agent is created here, with no file,\nlive immediately \u2014 and every file reference in it must name the\nrepository it lives in.\n\nAccepts an inline config or a gallery template slug. 409 when\nanother live agent already holds the name.",
         "operationId": "create_agent_config",
         "parameters": [
           {
@@ -9095,7 +9048,7 @@
                 }
               }
             },
-            "description": "The agent's name contains no usable characters."
+            "description": "The agent's name contains no usable characters, or a file reference names no repository."
           }
         },
         "security": [
@@ -9110,10 +9063,10 @@
         "x-ellipsis-sdk-method": "agents.configs.create"
       }
     },
-    "/agents/configs/{config_id}": {
-      "get": {
-        "description": "Return one saved agent config, by id or by the agent's name.",
-        "operationId": "get_agent_config",
+    "/v1/agents/configs/{config_id}": {
+      "delete": {
+        "description": "Delete an agent, by id or by the agent's name.\n\nThe agent stops running and its name is freed immediately; its\npast sessions remain readable. Only for agents managed through\nthis API \u2014 delete the file to remove one defined by a\nrepository.",
+        "operationId": "delete_agent_config",
         "parameters": [
           {
             "in": "path",
@@ -9142,14 +9095,7 @@
           }
         ],
         "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/AgentConfigResponse"
-                }
-              }
-            },
+          "204": {
             "description": "Successful Response"
           },
           "401": {
@@ -9182,6 +9128,16 @@
             },
             "description": "No such config in your account."
           },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The agent is defined by a file in a repository; delete that file instead."
+          },
           "422": {
             "content": {
               "application/json": {
@@ -9198,22 +9154,28 @@
             "HTTPBearer": []
           }
         ],
-        "summary": "Get Agent Config",
+        "summary": "Delete Agent Config",
         "tags": [
           "v1"
         ],
-        "x-ellipsis-sdk-method": "agents.configs.get"
-      }
-    },
-    "/agents/defaults": {
-      "delete": {
-        "description": "Clear a default agent config.\n\nAddressed by rung: the account rung (repository omitted) or a\nrepository rung.\n\nRefused for sandbox tokens.",
-        "operationId": "delete_agent_default",
+        "x-ellipsis-sdk-method": "agents.configs.delete"
+      },
+      "get": {
+        "description": "Return one saved agent config, by id or by the agent's name.",
+        "operationId": "get_agent_config",
         "parameters": [
           {
-            "description": "Repo rung to clear (\"owner/name\"); omit to clear the account default.",
-            "in": "query",
-            "name": "repository",
+            "in": "path",
+            "name": "config_id",
+            "required": true,
+            "schema": {
+              "title": "Config Id",
+              "type": "string"
+            }
+          },
+          {
+            "in": "header",
+            "name": "user-agent",
             "required": false,
             "schema": {
               "anyOf": [
@@ -9224,10 +9186,450 @@
                   "type": "null"
                 }
               ],
-              "description": "Repo rung to clear (\"owner/name\"); omit to clear the account default.",
-              "title": "Repository"
+              "title": "User-Agent"
             }
-          },
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AgentConfigResponse"
+                }
+              }
+            },
+            "description": "Successful Response"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The bearer token is missing, invalid, or revoked."
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The credential may not perform this action, or the account is blocked."
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "No such config in your account."
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            },
+            "description": "Validation Error"
+          }
+        },
+        "security": [
+          {
+            "HTTPBearer": []
+          }
+        ],
+        "summary": "Get Agent Config",
+        "tags": [
+          "v1"
+        ],
+        "x-ellipsis-sdk-method": "agents.configs.get"
+      },
+      "put": {
+        "description": "Replace an agent's definition, by id or by the agent's name.\n\nThe whole definition is replaced, and the change is live at\nonce. Only for agents managed through this API: one defined by a\nrepository file is a 409, since the next push to that file would\nrevert the change \u2014 unlink it first to take ownership.",
+        "operationId": "update_agent_config",
+        "parameters": [
+          {
+            "in": "path",
+            "name": "config_id",
+            "required": true,
+            "schema": {
+              "title": "Config Id",
+              "type": "string"
+            }
+          },
+          {
+            "in": "header",
+            "name": "user-agent",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "User-Agent"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/UpdateAgentConfigRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AgentConfigResponse"
+                }
+              }
+            },
+            "description": "Successful Response"
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The config is invalid (for example an unschedulable cron expression)."
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The bearer token is missing, invalid, or revoked."
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The credential may not perform this action, or the account is blocked."
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "No such config in your account."
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The agent is defined by a file in a repository, or another live agent already holds the new name."
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The agent's name is missing or malformed, or a file reference names no repository."
+          }
+        },
+        "security": [
+          {
+            "HTTPBearer": []
+          }
+        ],
+        "summary": "Update Agent Config",
+        "tags": [
+          "v1"
+        ],
+        "x-ellipsis-sdk-method": "agents.configs.update"
+      }
+    },
+    "/v1/agents/configs/{config_id}/link": {
+      "post": {
+        "description": "Move an agent into a repository, by id or by the agent's name.\n\nOpens a pull request adding the agent's config file. The agent\nkeeps running unchanged meanwhile; merging hands it over to the\nfile, after which the file is what changes it. Nothing happens\nif the pull request is never merged.",
+        "operationId": "link_agent_config",
+        "parameters": [
+          {
+            "in": "path",
+            "name": "config_id",
+            "required": true,
+            "schema": {
+              "title": "Config Id",
+              "type": "string"
+            }
+          },
+          {
+            "in": "header",
+            "name": "user-agent",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "User-Agent"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/LinkAgentConfigRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/LinkAgentConfigResponse"
+                }
+              }
+            },
+            "description": "Successful Response"
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The path is not a synced config location, or the repository has no commits."
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The bearer token is missing, invalid, or revoked."
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The credential may not perform this action, or the account is blocked."
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The config or repository was not found in your account."
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The agent is already defined by a file, a link is already open for it, a file already exists at that path, or another agent syncs from it."
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "GitHub rejected the pull request."
+          }
+        },
+        "security": [
+          {
+            "HTTPBearer": []
+          }
+        ],
+        "summary": "Link Agent Config",
+        "tags": [
+          "v1"
+        ],
+        "x-ellipsis-sdk-method": "agents.configs.link"
+      }
+    },
+    "/v1/agents/configs/{config_id}/unlink": {
+      "post": {
+        "description": "Take over an agent from its file, by id or by the agent's name.\n\nThe file stops governing the agent immediately and further\nchanges go through this API. The file is left in place, inert \u2014\ndelete it whenever you like.",
+        "operationId": "unlink_agent_config",
+        "parameters": [
+          {
+            "in": "path",
+            "name": "config_id",
+            "required": true,
+            "schema": {
+              "title": "Config Id",
+              "type": "string"
+            }
+          },
+          {
+            "in": "header",
+            "name": "user-agent",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "User-Agent"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AgentConfigResponse"
+                }
+              }
+            },
+            "description": "Successful Response"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The bearer token is missing, invalid, or revoked."
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The credential may not perform this action, or the account is blocked."
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "No such config in your account."
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The agent is already managed through the API."
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The config has a file reference that names no repository, so it cannot resolve without its source repository."
+          }
+        },
+        "security": [
+          {
+            "HTTPBearer": []
+          }
+        ],
+        "summary": "Unlink Agent Config",
+        "tags": [
+          "v1"
+        ],
+        "x-ellipsis-sdk-method": "agents.configs.unlink"
+      }
+    },
+    "/v1/agents/defaults": {
+      "delete": {
+        "description": "Clear a default agent config.\n\nAddressed by rung: the account rung (repository omitted) or a\nrepository rung.\n\nRefused for sandbox tokens.",
+        "operationId": "delete_agent_default",
+        "parameters": [
+          {
+            "description": "Repo rung to clear (\"owner/name\"); omit to clear the account default.",
+            "in": "query",
+            "name": "repository",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "description": "Repo rung to clear (\"owner/name\"); omit to clear the account default.",
+              "title": "Repository"
+            }
+          },
           {
             "in": "header",
             "name": "user-agent",
@@ -9480,7 +9882,7 @@
         "x-ellipsis-sdk-method": "agents.defaults.set"
       }
     },
-    "/agents/templates": {
+    "/v1/agents/templates": {
       "get": {
         "description": "List the built-in starter agent templates.\n\nBehind auth but not account-scoped \u2014 the data is static\nproduct content shared by the dashboard, landing site, and CLI.",
         "operationId": "list_agent_templates",
@@ -9556,7 +9958,7 @@
         "x-ellipsis-sdk-method": "agents.templates.list"
       }
     },
-    "/agents/templates/{template_id}": {
+    "/v1/agents/templates/{template_id}": {
       "get": {
         "description": "Return one built-in agent template by slug.",
         "operationId": "get_agent_template",
@@ -9651,7 +10053,7 @@
         "x-ellipsis-sdk-method": "agents.templates.get"
       }
     },
-    "/alerts": {
+    "/v1/alerts": {
       "get": {
         "description": "List budget alerts for the organization, newest first.\n\nOptionally filtered by status and source.\n\nAvailable to all credential types, so an agent can check \"is\nthis org near budget?\" mid-task.",
         "operationId": "list_alerts",
@@ -9787,7 +10189,7 @@
         "x-ellipsis-sdk-method": "alerts.list"
       }
     },
-    "/alerts/{alert_id}": {
+    "/v1/alerts/{alert_id}": {
       "get": {
         "description": "Return one alert by id.\n\n404 if it doesn't exist or belongs to another organization.",
         "operationId": "get_alert",
@@ -9882,7 +10284,7 @@
         "x-ellipsis-sdk-method": "alerts.get"
       }
     },
-    "/alerts/{alert_id}/dismiss": {
+    "/v1/alerts/{alert_id}/dismiss": {
       "post": {
         "description": "Dismiss an open alert and return it.\n\n409 when the alert is not open; 404 when it doesn't exist.",
         "operationId": "dismiss_alert",
@@ -9987,7 +10389,7 @@
         "x-ellipsis-sdk-method": "alerts.dismiss"
       }
     },
-    "/analytics/metrics": {
+    "/v1/analytics/metrics": {
       "get": {
         "description": "Return PR and review analytics metrics.\n\nThe same data as the analytics dashboard.\n\nWindowing: pass explicit start/end, or days (default: the last\n30 days). account_type in all|user|bot scopes the authors (bot =\nthe apps/agents). Available to all credential types: the\nresponses expose the organization's own GitHub PR/review activity,\nno secrets.",
         "operationId": "get_analytics_metrics",
@@ -10196,7 +10598,7 @@
         "x-ellipsis-sdk-method": "analytics.metrics"
       }
     },
-    "/analytics/pull-requests": {
+    "/v1/analytics/pull-requests": {
       "get": {
         "description": "Return pull-request analytics.\n\nWindowing: pass explicit start/end, or days (default: the last\n30 days).",
         "operationId": "get_analytics_pull_requests",
@@ -10408,7 +10810,7 @@
         "x-ellipsis-sdk-method": "analytics.pull_requests"
       }
     },
-    "/analytics/reviews": {
+    "/v1/analytics/reviews": {
       "get": {
         "description": "Return code-review analytics.\n\naccount_type scopes reviewers (bot|user|all) \u2014 e.g. \"what apps\nreview the most PRs?\" is the reviewer facets here with\naccount_type=bot. Windowing: pass explicit start/end, or days\n(default: the last 30 days).",
         "operationId": "get_analytics_reviews",
@@ -10613,7 +11015,7 @@
         "x-ellipsis-sdk-method": "analytics.reviews"
       }
     },
-    "/auth/cli/poll": {
+    "/v1/auth/cli/poll": {
       "post": {
         "description": "Poll a device-code auth flow for its token.\n\nUnauthenticated; the device code identifies the flow.",
         "operationId": "cli_auth_poll",
@@ -10686,7 +11088,7 @@
         "x-ellipsis-sdk-method": "auth.cli.poll"
       }
     },
-    "/auth/cli/start": {
+    "/v1/auth/cli/start": {
       "post": {
         "description": "Start a device-code auth flow for the CLI.\n\nUnauthenticated: the CLI has no credential yet \u2014 that's what\nit's obtaining. The human authorizes out-of-band in the\ndashboard.",
         "operationId": "cli_auth_start",
@@ -10729,7 +11131,7 @@
         "x-ellipsis-sdk-method": "auth.cli.start"
       }
     },
-    "/budget": {
+    "/v1/budget": {
       "get": {
         "description": "Return the caller's current budget summary.",
         "operationId": "get_budget",
@@ -10805,7 +11207,7 @@
         "x-ellipsis-sdk-method": "budget"
       }
     },
-    "/files": {
+    "/v1/files": {
       "get": {
         "description": "List uploaded files, newest first.\n\nMetadata only \u2014 download URLs are minted per explicit GET, not\nper row. session_id scopes the list to one run's uploads.",
         "operationId": "list_files",
@@ -11029,7 +11431,7 @@
         "x-ellipsis-sdk-method": "files.create"
       }
     },
-    "/files/{file_id}": {
+    "/v1/files/{file_id}": {
       "delete": {
         "description": "Delete a file.\n\nA foreign, missing, or already-deleted id is an\nindistinguishable 404, so ids can't be enumerated. Sandbox\ntokens get a 403 (a sandbox token sits next to\npotentially-untrusted code and must not be able to destroy the\naccount's files \u2014 uploading is fine, destruction is not); API\nkeys and user tokens may delete.",
         "operationId": "delete_file",
@@ -11210,7 +11612,7 @@
         "x-ellipsis-sdk-method": "files.get"
       }
     },
-    "/integrations": {
+    "/v1/integrations": {
       "get": {
         "description": "List connected integrations.\n\nA read-only view, so an agent authoring another agent's\nconfig can learn which repositories, channels, teams, and\norganizations it may name before POST /agents/configs.\n\nAvailable to all credential types including sandbox tokens: the\nresponses never include OAuth tokens or any other secret.",
         "operationId": "get_integrations",
@@ -11286,7 +11688,7 @@
         "x-ellipsis-sdk-method": "integrations.list"
       }
     },
-    "/integrations/github/members": {
+    "/v1/integrations/github/members": {
       "get": {
         "description": "List the GitHub organization roster.\n\n(Or the account itself for a personal workspace) \u2014 the universe of author_id values for\n/sessions and /sessions/search.\n\nMembers carry their linked Slack identity when a Slack-GitHub\nlink exists, and /slack/members carries the reverse link.",
         "operationId": "list_github_members",
@@ -11362,7 +11764,7 @@
         "x-ellipsis-sdk-method": "integrations.github.members"
       }
     },
-    "/integrations/github/repos": {
+    "/v1/integrations/github/repos": {
       "get": {
         "description": "List GitHub repositories connected to the installation.",
         "operationId": "list_github_repositories",
@@ -11438,7 +11840,7 @@
         "x-ellipsis-sdk-method": "integrations.github.repos"
       }
     },
-    "/integrations/linear/teams": {
+    "/v1/integrations/linear/teams": {
       "get": {
         "description": "List the teams of the connected Linear workspace.",
         "operationId": "list_linear_teams",
@@ -11524,7 +11926,7 @@
         "x-ellipsis-sdk-method": "integrations.linear.teams"
       }
     },
-    "/integrations/sentry/organizations": {
+    "/v1/integrations/sentry/organizations": {
       "get": {
         "description": "List the connected Sentry organizations.",
         "operationId": "list_sentry_organizations",
@@ -11600,7 +12002,7 @@
         "x-ellipsis-sdk-method": "integrations.sentry.organizations"
       }
     },
-    "/integrations/slack/channels": {
+    "/v1/integrations/slack/channels": {
       "get": {
         "description": "List the channels of the connected Slack workspace, fetched\nlive from the Slack API.",
         "operationId": "list_slack_channels",
@@ -11686,7 +12088,7 @@
         "x-ellipsis-sdk-method": "integrations.slack.channels"
       }
     },
-    "/integrations/slack/members": {
+    "/v1/integrations/slack/members": {
       "get": {
         "description": "List the members of the connected Slack workspace, fetched\nlive from the Slack API.",
         "operationId": "list_slack_members",
@@ -11772,7 +12174,7 @@
         "x-ellipsis-sdk-method": "integrations.slack.members"
       }
     },
-    "/me": {
+    "/v1/me": {
       "get": {
         "description": "Return the identity behind the caller's credential.",
         "operationId": "whoami",
@@ -11848,7 +12250,7 @@
         "x-ellipsis-sdk-method": "me"
       }
     },
-    "/memories": {
+    "/v1/memories": {
       "get": {
         "description": "List the organization's memories as a readable index.\n\nReturns the memories rendered as a markdown index (one line per\nmemory, carrying its id, path, and description) plus the same\nentries structured, each with every field except `content`. Read\nthe index, then fetch the ids whose content you want.",
         "operationId": "list_memories",
@@ -12036,7 +12438,7 @@
         "x-ellipsis-sdk-method": "memories.create"
       }
     },
-    "/memories/{memory_id}": {
+    "/v1/memories/{memory_id}": {
       "delete": {
         "description": "Delete a memory that is no longer true.\n\nAvailable to every credential type, agents included \u2014 a wrong\nmemory is worse than a missing one. The deleted content is kept in\nthe memory's history for forensics, not for an undo API.",
         "operationId": "delete_memory",
@@ -12358,7 +12760,7 @@
         "x-ellipsis-sdk-method": "memories.edit"
       }
     },
-    "/models": {
+    "/v1/models": {
       "get": {
         "description": "List selectable agent models.\n\nMost expensive first, with the platform default flagged.\n\nReads the same registry as the dashboard's rate table, so a\nclient's model picker can never drift from what's offered.\nBehind auth but not account-scoped \u2014 the selectable set is\nglobal.",
         "operationId": "list_supported_models",
@@ -12434,7 +12836,7 @@
         "x-ellipsis-sdk-method": "models.list"
       }
     },
-    "/reviews": {
+    "/v1/reviews": {
       "get": {
         "description": "List code reviews, newest first.\n\n`findings` is omitted (counters only).\n\nWebhook-created reviews appear here too, so this answers \"show\nme every review on this PR\".",
         "operationId": "list_reviews",
@@ -12736,7 +13138,7 @@
         "x-ellipsis-sdk-method": "reviews.create"
       }
     },
-    "/reviews/{review_id}": {
+    "/v1/reviews/{review_id}": {
       "get": {
         "description": "Return one review with findings and outcome.\n\nIncludes its scope, the per-stage sessions, the parsed findings,\nthe finding counters, and the posting outcome.\n\nFindings only exist after a stage session finalizes \u2014 a running\nreview honestly reports [] / null, which is why a client\nstreams a stage session and then re-fetches the review.",
         "operationId": "get_review",
@@ -12831,7 +13233,7 @@
         "x-ellipsis-sdk-method": "reviews.get"
       }
     },
-    "/secrets": {
+    "/v1/secrets": {
       "get": {
         "description": "List secrets.\n\nValues are write-only: the response carries only names and\ntimestamps, never the stored value.",
         "operationId": "list_secrets",
@@ -13001,7 +13403,7 @@
         "x-ellipsis-sdk-method": "secrets.set"
       }
     },
-    "/secrets/{name}": {
+    "/v1/secrets/{name}": {
       "delete": {
         "description": "Delete a secret by name.\n\nRefused for sandbox tokens; mutations require an API key or\nuser token.",
         "operationId": "delete_secret",
@@ -13079,7 +13481,7 @@
         "x-ellipsis-sdk-method": "secrets.delete"
       }
     },
-    "/sessions": {
+    "/v1/sessions": {
       "get": {
         "description": "List cloud agent sessions, newest first.\n\nOptionally filtered by config (id or `ellipsis.name`), source, time\nwindow, attributed author, repository, and whether the session is\nstill going.",
         "operationId": "list_agent_sessions",
@@ -13432,7 +13834,7 @@
         "x-ellipsis-sdk-method": "sessions.start"
       }
     },
-    "/sessions/search": {
+    "/v1/sessions/search": {
       "get": {
         "description": "Search sessions over steps, recaps, and pull requests.\n\nGrouped by session, over everything a session left behind: step text, recap text, created\nPRs, and recap-embedding similarity.\n\nThis is how an agent answers \"did Tony look into X?\": resolve\nthe author via /github/members, search, then read the winning\nsession via /sessions/{id} (recap) and /sessions/{id}/records\n(transcript).",
         "operationId": "search_sessions",
@@ -13699,7 +14101,7 @@
         "x-ellipsis-sdk-method": "sessions.search"
       }
     },
-    "/sessions/sync": {
+    "/v1/sessions/sync": {
       "post": {
         "description": "Sync a local Claude Code session to Ellipsis.\n\nRequires a user token (device-flow `agent login`): the user is\npart of the sync's idempotency key, so API keys and sandbox\ntokens are rejected with a 403 rather than silently attributed.",
         "operationId": "sync_agent_session",
@@ -13805,7 +14207,7 @@
         "x-ellipsis-sdk-method": "sessions.sync"
       }
     },
-    "/sessions/{session_id}": {
+    "/v1/sessions/{session_id}": {
       "get": {
         "description": "Return one session.\n\nThe public wire shape \u2014 the same shape the stream's session\nframes carry, with attributed_user and stopped_by_user resolved\nat read time.\n\nThe heavy near-static blobs (config snapshot, input/output)\nlive on the detail endpoints, not here.",
         "operationId": "get_agent_session",
@@ -13900,7 +14302,7 @@
         "x-ellipsis-sdk-method": "sessions.get"
       }
     },
-    "/sessions/{session_id}/executions": {
+    "/v1/sessions/{session_id}/executions": {
       "get": {
         "description": "Return the session's executions and launch context.\n\nMost notably system_prompt_append, the text Ellipsis appends to\nClaude Code's default system prompt (platform section + response\ninstructions + the config's own instructions).\n\nPer execution because each cold wake persists its own launch\nconfig (a config edit or replay override between wakes changes\nit).",
         "operationId": "get_agent_session_executions",
@@ -13995,7 +14397,7 @@
         "x-ellipsis-sdk-method": "sessions.executions"
       }
     },
-    "/sessions/{session_id}/export": {
+    "/v1/sessions/{session_id}/export": {
       "get": {
         "description": "Export the complete session history.\n\nThe complete, ordered history of the session (agent output, tool calls, thinking,\nlifecycle events, sandbox output, message events) as an ordered\nmanifest of presigned segment URLs.\n\nSegments are gzip members: download in order and concatenate\nfor one file. The JSON API never carries the bytes (same\ntwo-step as files). /records is the paged live view of the\nsame data.",
         "operationId": "export_agent_session",
@@ -14090,112 +14492,7 @@
         "x-ellipsis-sdk-method": "sessions.export"
       }
     },
-    "/sessions/{session_id}/ide": {
-      "get": {
-        "description": "Return the IDE link for the session's sandbox.\n\nThe membership-gated dashboard page, which performs the sandbox\nproxy handoff itself.\n\nNo credential is minted here \u2014 the URL grants nothing by\npossession. 409 when the sandbox isn't running (send the\nsession a message to wake it first). Backs the `agent session\nide` CLI verb.",
-        "operationId": "get_agent_session_ide",
-        "parameters": [
-          {
-            "in": "path",
-            "name": "session_id",
-            "required": true,
-            "schema": {
-              "title": "Session Id",
-              "type": "string"
-            }
-          },
-          {
-            "in": "header",
-            "name": "user-agent",
-            "required": false,
-            "schema": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "title": "User-Agent"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/GetSessionIdeResponse"
-                }
-              }
-            },
-            "description": "Successful Response"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "The bearer token is missing, invalid, or revoked."
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "The credential may not perform this action, or the account is blocked."
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "No such session in your account."
-          },
-          "409": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "The session's sandbox is not running; send it a message to wake it first."
-          },
-          "422": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/HTTPValidationError"
-                }
-              }
-            },
-            "description": "Validation Error"
-          }
-        },
-        "security": [
-          {
-            "HTTPBearer": []
-          }
-        ],
-        "summary": "Get Agent Session Ide",
-        "tags": [
-          "v1"
-        ],
-        "x-ellipsis-sdk-method": "sessions.ide"
-      }
-    },
-    "/sessions/{session_id}/messages": {
+    "/v1/sessions/{session_id}/messages": {
       "post": {
         "description": "Send a message to a session.\n\n409 for react/cron, non-interactive, and closed sessions.\nReturns the created message so the caller can track it by id; a\nretried send with the same idempotency_key returns the original\nmessage.",
         "operationId": "send_agent_session_message",
@@ -14320,9 +14617,9 @@
         "x-ellipsis-sdk-method": "sessions.send_message"
       }
     },
-    "/sessions/{session_id}/output": {
+    "/v1/sessions/{session_id}/output": {
       "get": {
-        "description": "Return the session's typed output.\n\nThe payload the agent submitted through its config-declared\noutput.json_schema, as the raw JSON body with no envelope. 404\nwhile the session is still running (poll GET /sessions/{id}),\nwhen the agent declares no output block, or when no execution\nproduced output.",
+        "description": "Return the session's typed output.\n\nThe payload the agent submitted through its config-declared\noutput.json_schema, as the raw JSON body with no envelope. 404\nwhile the session is still running (poll GET /v1/sessions/{id}),\nwhen the agent declares no output block, or when no execution\nproduced output.",
         "operationId": "get_agent_session_output",
         "parameters": [
           {
@@ -14415,121 +14712,7 @@
         "x-ellipsis-sdk-method": "sessions.output"
       }
     },
-    "/sessions/{session_id}/ports/{port}": {
-      "get": {
-        "description": "Return a preview link for a sandbox port.\n\nFor a dev server running in the session's live sandbox: the\nsame dashboard page as the IDE, deep-linked to the port.\n\nBacks `agent session port`.",
-        "operationId": "get_agent_session_port",
-        "parameters": [
-          {
-            "in": "path",
-            "name": "session_id",
-            "required": true,
-            "schema": {
-              "title": "Session Id",
-              "type": "string"
-            }
-          },
-          {
-            "in": "path",
-            "name": "port",
-            "required": true,
-            "schema": {
-              "title": "Port",
-              "type": "integer"
-            }
-          },
-          {
-            "in": "header",
-            "name": "user-agent",
-            "required": false,
-            "schema": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "title": "User-Agent"
-            }
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/GetSessionPortResponse"
-                }
-              }
-            },
-            "description": "Successful Response"
-          },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "The bearer token is missing, invalid, or revoked."
-          },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "The credential may not perform this action, or the account is blocked."
-          },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "No such session in your account, or the port is not a valid TCP port."
-          },
-          "409": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "The session's sandbox is not running; send it a message to wake it first."
-          },
-          "422": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/HTTPValidationError"
-                }
-              }
-            },
-            "description": "Validation Error"
-          }
-        },
-        "security": [
-          {
-            "HTTPBearer": []
-          }
-        ],
-        "summary": "Get Agent Session Port",
-        "tags": [
-          "v1"
-        ],
-        "x-ellipsis-sdk-method": "sessions.port"
-      }
-    },
-    "/sessions/{session_id}/records": {
+    "/v1/sessions/{session_id}/records": {
       "get": {
         "description": "Return the session's stored transcript records, oldest first.\n\nPagination is opt-in (cursor/limit); a bare call returns the\nfull retained transcript. Available to sandbox tokens too: an\nagent answering \"did X look into Y?\" needs to read the session\nit found via /sessions/search, and any org member sees the same\ntranscript in the dashboard (laptop transcripts are redacted\nclient-side before they are ever uploaded).",
         "operationId": "get_agent_session_records",
@@ -14658,7 +14841,7 @@
         "x-ellipsis-sdk-method": "sessions.records"
       }
     },
-    "/sessions/{session_id}/replay": {
+    "/v1/sessions/{session_id}/replay": {
       "post": {
         "description": "Replay a session as a new session.\n\nReuses the original config snapshot unless config_id is given,\nand accepts the same config_override as session start \u2014 e.g.\n{\"claude\": {\"model\": ...}} to replay the same input on a\ndifferent model.",
         "operationId": "replay_agent_session",
@@ -14773,7 +14956,7 @@
         "x-ellipsis-sdk-method": "sessions.replay"
       }
     },
-    "/sessions/{session_id}/stop": {
+    "/v1/sessions/{session_id}/stop": {
       "post": {
         "description": "Stop an in-flight session and return it.\n\nstopped_by is recorded only when the caller's credential maps\nto a GitHub account.",
         "operationId": "stop_agent_session",
@@ -14888,7 +15071,7 @@
         "x-ellipsis-sdk-method": "sessions.stop"
       }
     },
-    "/sessions/{session_id}/transcript": {
+    "/v1/sessions/{session_id}/transcript": {
       "post": {
         "description": "Append transcript lines to a session's record.\n\nThe in-sandbox tailer for interactive sessions.\n\nA sandbox token may only push its own session's transcript.\nIdempotent by transcript line uuid; tolerant of malformed lines.",
         "operationId": "ingest_agent_session_transcript",
@@ -15003,7 +15186,7 @@
         "x-ellipsis-sdk-method": "sessions.ingest_transcript"
       }
     },
-    "/usage": {
+    "/v1/usage": {
       "get": {
         "description": "Return the caller's usage dashboard data.",
         "operationId": "get_usage_endpoint",