@ellipsis-dev/sdk 0.11.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,
@@ -1859,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"
           }
@@ -2149,7 +2124,7 @@
                 "type": "null"
               }
             ],
-            "description": "A gallery template slug (see GET /agents/templates).",
+            "description": "A gallery template slug (see GET /v1/agents/templates).",
             "title": "Template Id"
           }
         },
@@ -2835,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": {
@@ -2911,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": {
@@ -4212,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",
@@ -6798,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",
@@ -6808,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": [
               {
@@ -6832,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": [
               {
@@ -6980,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": [
               {
@@ -7059,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": [
@@ -8152,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"
             },
@@ -8919,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": {
@@ -9027,7 +8873,7 @@
   },
   "openapi": "3.1.0",
   "paths": {
-    "/agents/configs": {
+    "/v1/agents/configs": {
       "get": {
         "description": "List saved agent configs.",
         "operationId": "list_agent_configs",
@@ -9217,7 +9063,7 @@
         "x-ellipsis-sdk-method": "agents.configs.create"
       }
     },
-    "/agents/configs/{config_id}": {
+    "/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",
@@ -9531,7 +9377,7 @@
         "x-ellipsis-sdk-method": "agents.configs.update"
       }
     },
-    "/agents/configs/{config_id}/link": {
+    "/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",
@@ -9656,7 +9502,7 @@
         "x-ellipsis-sdk-method": "agents.configs.link"
       }
     },
-    "/agents/configs/{config_id}/unlink": {
+    "/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",
@@ -9761,7 +9607,7 @@
         "x-ellipsis-sdk-method": "agents.configs.unlink"
       }
     },
-    "/agents/defaults": {
+    "/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",
@@ -10036,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",
@@ -10112,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",
@@ -10207,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",
@@ -10343,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",
@@ -10438,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",
@@ -10543,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",
@@ -10752,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",
@@ -10964,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",
@@ -11169,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",
@@ -11242,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",
@@ -11285,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",
@@ -11361,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",
@@ -11585,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",
@@ -11766,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",
@@ -11842,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",
@@ -11918,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",
@@ -11994,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",
@@ -12080,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",
@@ -12156,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",
@@ -12242,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",
@@ -12328,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",
@@ -12404,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",
@@ -12592,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",
@@ -12914,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",
@@ -12990,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",
@@ -13292,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",
@@ -13387,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",
@@ -13557,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",
@@ -13635,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",
@@ -13988,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",
@@ -14255,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",
@@ -14361,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",
@@ -14456,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",
@@ -14551,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",
@@ -14646,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",
@@ -14876,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": [
           {
@@ -14971,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",
@@ -15214,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",
@@ -15329,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",
@@ -15444,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",
@@ -15559,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",