@ellipsis-dev/sdk 0.8.1 → 0.9.0

package/schema/openapi.v1.json

@@ -54,6 +54,16 @@
               "variables": []
             }
           },
+          "input": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/AgentConfigInput"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
           "llm": {
             "$ref": "#/components/schemas/AgentConfigLlm",
             "default": {}
@@ -73,6 +83,16 @@
             "title": "Mcp Servers",
             "type": "array"
           },
+          "output": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/AgentConfigOutput"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          },
           "permissions": {
             "$ref": "#/components/schemas/AgentConfigPermissions",
             "default": {
@@ -88,16 +108,6 @@
             "title": "Skills",
             "type": "array"
           },
-          "structured_output": {
-            "anyOf": [
-              {
-                "$ref": "#/components/schemas/AgentConfigStructuredOutput"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
           "trigger": {
             "anyOf": [
               {
@@ -645,6 +655,37 @@
         "title": "AgentConfigGithubPermissions",
         "type": "object"
       },
+      "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`).",
+        "properties": {
+          "json_schema": {
+            "anyOf": [
+              {
+                "additionalProperties": true,
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Json Schema"
+          },
+          "message": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Message"
+          }
+        },
+        "title": "AgentConfigInput",
+        "type": "object"
+      },
       "AgentConfigLlm": {
         "additionalProperties": false,
         "description": "Where this agent's completions go.\n\nDefaults to Ellipsis's own LLM proxy (our Anthropic/Bedrock account, or the\naccount-wide BYO provider if one is enabled). Setting `proxy` to the id of a\nproxy registered on the models settings page routes THIS agent's\ncompletions through that gateway instead.\n\nOpt-in per agent by design: registering a proxy does not silently move any\nexisting agent's traffic. The id is account-scoped, so naming another\naccount's id is a terminal config error, not a route.",
@@ -765,6 +806,22 @@
         "title": "AgentConfigMetadata",
         "type": "object"
       },
+      "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.",
+        "properties": {
+          "json_schema": {
+            "additionalProperties": true,
+            "title": "Json Schema",
+            "type": "object"
+          }
+        },
+        "required": [
+          "json_schema"
+        ],
+        "title": "AgentConfigOutput",
+        "type": "object"
+      },
       "AgentConfigPermissions": {
         "additionalProperties": false,
         "description": "What the agent is allowed to touch, per credential the platform mints\ninto its sandbox. Distinct from `environment:`, which is where the agent\nruns; this is what it may do from there.\n\n`ellipsis` scopes the sandbox's Ellipsis API token\n(`ELLIPSIS_API_TOKEN`, what the in-sandbox `agent` CLI authenticates\nwith). Only full access exists today \u2014 `true` or the string `all`, both\nmeaning the token may call any Ellipsis API a sandbox token can. The key\nis declarative for now; it reserves the spot for narrowing later, and\nanything other than true/`all` (including `false`) fails validation.\n\n`github` scopes the sandbox's GitHub installation token (`GH_TOKEN`) \u2014\nsee `AgentConfigGithubPermissions`. GitHub enforces it at mint time.",
@@ -982,27 +1039,6 @@
         "title": "AgentConfigSourceGithub",
         "type": "object"
       },
-      "AgentConfigStructuredOutput": {
-        "additionalProperties": false,
-        "properties": {
-          "json_schema": {
-            "additionalProperties": true,
-            "title": "Json Schema",
-            "type": "object"
-          },
-          "type": {
-            "const": "json_schema",
-            "default": "json_schema",
-            "title": "Type",
-            "type": "string"
-          }
-        },
-        "required": [
-          "json_schema"
-        ],
-        "title": "AgentConfigStructuredOutput",
-        "type": "object"
-      },
       "AgentConfigSystemFileRef": {
         "additionalProperties": false,
         "properties": {
@@ -1137,98 +1173,6 @@
         "title": "AgentDefaultsListResponse",
         "type": "object"
       },
-      "AgentSessionExitStatus": {
-        "description": "Why a terminal agent session ended \u2014 a finer-grained reason than `status`.\n\n`status` (AgentSessionStatus) is the lifecycle state: COMPLETED / ERROR /\nCANCELLED. `exit_status` explains *why* a run reached that terminal state, so\nthe UI and metrics can tell a budget cutoff apart from a crashed tool call or\na deliberate cancellation. It is None until the run reaches a terminal state.",
-        "enum": [
-          "completed",
-          "budget_hit",
-          "payment_required",
-          "tool_call_failed",
-          "lifecycle_hook_failed",
-          "missing_repo_access",
-          "missing_token_permissions",
-          "missing_sandbox_variables",
-          "cancelled",
-          "interrupted",
-          "error",
-          "stopped"
-        ],
-        "title": "AgentSessionExitStatus",
-        "type": "string"
-      },
-      "AgentSessionPr": {
-        "description": "A pull request this session created, denormalized at capture time so\nsession surfaces render a labeled link without joining gh_prs. Live PR\nstate (open/merged/closed) is not stored here \u2014 read it from gh_prs where\na view needs it.",
-        "properties": {
-          "gh_pr_id": {
-            "anyOf": [
-              {
-                "type": "integer"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Gh Pr Id"
-          },
-          "number": {
-            "title": "Number",
-            "type": "integer"
-          },
-          "repo_full_name": {
-            "title": "Repo Full Name",
-            "type": "string"
-          },
-          "title": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Title"
-          },
-          "url": {
-            "title": "Url",
-            "type": "string"
-          }
-        },
-        "required": [
-          "repo_full_name",
-          "number",
-          "url"
-        ],
-        "title": "AgentSessionPr",
-        "type": "object"
-      },
-      "AgentSessionSource": {
-        "enum": [
-          "react",
-          "manual",
-          "api",
-          "cli",
-          "mention",
-          "cron",
-          "laptop"
-        ],
-        "title": "AgentSessionSource",
-        "type": "string"
-      },
-      "AgentSessionStatus": {
-        "enum": [
-          "scheduled",
-          "creating_sandbox",
-          "running",
-          "retrying",
-          "completed",
-          "error",
-          "cancelled",
-          "stopped"
-        ],
-        "title": "AgentSessionStatus",
-        "type": "string"
-      },
       "AgentTemplate": {
         "description": "A built-in agent template: a ready-to-use agent config plus the\nmetadata that describes it in the template gallery.",
         "properties": {
@@ -1915,6 +1859,18 @@
             "title": "Created At",
             "type": "string"
           },
+          "display_name": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The raw ellipsis.name display text from the config file.",
+            "title": "Display Name"
+          },
           "edited_by": {
             "anyOf": [
               {
@@ -1980,6 +1936,18 @@
             "description": "The last commit the config was synced from.",
             "title": "Last Synced Commit Sha"
           },
+          "name": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The agent's customer-unique addressable name (a slug of its display name); usable anywhere an agent is referenced, interchangeably with the id.",
+            "title": "Name"
+          },
           "pending_pull_request_url": {
             "anyOf": [
               {
@@ -1992,6 +1960,11 @@
             "description": "The open pull request that adds this config's file. Non-null means the agent is not live yet: it starts running once the pull request merges and syncs.",
             "title": "Pending Pull Request Url"
           },
+          "sha": {
+            "description": "The config's content identity: the version fingerprint frozen onto each session that runs it.",
+            "title": "Sha",
+            "type": "string"
+          },
           "updated_at": {
             "description": "When the config was last updated.",
             "format": "date-time",
@@ -2001,6 +1974,7 @@
         },
         "required": [
           "id",
+          "sha",
           "created_at",
           "updated_at",
           "agent_config"
@@ -4499,7 +4473,7 @@
         "description": "Parameters for setting a default agent config, at either the account\nor the repository level.",
         "properties": {
           "config_id": {
-            "description": "The saved config to make the default.",
+            "description": "The config to make the default: a config id, or the agent's customer-unique `ellipsis.name`.",
             "title": "Config Id",
             "type": "string"
           },
@@ -4924,7 +4898,7 @@
             "anyOf": [
               {
                 "items": {
-                  "$ref": "#/components/schemas/AgentSessionPr"
+                  "$ref": "#/components/schemas/SessionPr"
                 },
                 "type": "array"
               },
@@ -4948,7 +4922,7 @@
           "session_source": {
             "anyOf": [
               {
-                "$ref": "#/components/schemas/AgentSessionSource"
+                "$ref": "#/components/schemas/SessionSource"
               },
               {
                 "type": "null"
@@ -4959,7 +4933,7 @@
           "session_status": {
             "anyOf": [
               {
-                "$ref": "#/components/schemas/AgentSessionStatus"
+                "$ref": "#/components/schemas/SessionStatus"
               },
               {
                 "type": "null"
@@ -6764,7 +6738,7 @@
           "exit_status": {
             "anyOf": [
               {
-                "$ref": "#/components/schemas/AgentSessionExitStatus"
+                "$ref": "#/components/schemas/SessionExitStatus"
               },
               {
                 "type": "null"
@@ -6832,7 +6806,7 @@
             "anyOf": [
               {
                 "items": {
-                  "$ref": "#/components/schemas/AgentSessionPr"
+                  "$ref": "#/components/schemas/SessionPr"
                 },
                 "type": "array"
               },
@@ -6939,11 +6913,11 @@
             "description": "Lifecycle state of the durable conversation, or null for sessions without one."
           },
           "source": {
-            "$ref": "#/components/schemas/AgentSessionSource",
+            "$ref": "#/components/schemas/SessionSource",
             "description": "Where the session came from (e.g. react, manual, api, cli, mention, cron, laptop)."
           },
           "status": {
-            "$ref": "#/components/schemas/AgentSessionStatus",
+            "$ref": "#/components/schemas/SessionStatus",
             "description": "Execution status of the session."
           },
           "status_reason": {
@@ -7209,6 +7183,25 @@
         "title": "SessionExecutionsListResponse",
         "type": "object"
       },
+      "SessionExitStatus": {
+        "description": "Why a terminal agent session ended \u2014 a finer-grained reason than `status`.\n\n`status` (SessionStatus) is the lifecycle state: COMPLETED / ERROR /\nCANCELLED. `exit_status` explains *why* a run reached that terminal state, so\nthe UI and metrics can tell a budget cutoff apart from a crashed tool call or\na deliberate cancellation. It is None until the run reaches a terminal state.",
+        "enum": [
+          "completed",
+          "budget_hit",
+          "payment_required",
+          "tool_call_failed",
+          "lifecycle_hook_failed",
+          "missing_repo_access",
+          "missing_token_permissions",
+          "missing_sandbox_variables",
+          "cancelled",
+          "interrupted",
+          "error",
+          "stopped"
+        ],
+        "title": "SessionExitStatus",
+        "type": "string"
+      },
       "SessionLiveness": {
         "description": "The durable conversation axis (backs the surfaced `session` field).",
         "enum": [
@@ -7397,6 +7390,52 @@
         "title": "SessionMessageStatus",
         "type": "string"
       },
+      "SessionPr": {
+        "description": "A pull request this session created, denormalized at capture time so\nsession surfaces render a labeled link without joining gh_prs. Live PR\nstate (open/merged/closed) is not stored here \u2014 read it from gh_prs where\na view needs it.",
+        "properties": {
+          "gh_pr_id": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Gh Pr Id"
+          },
+          "number": {
+            "title": "Number",
+            "type": "integer"
+          },
+          "repo_full_name": {
+            "title": "Repo Full Name",
+            "type": "string"
+          },
+          "title": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Title"
+          },
+          "url": {
+            "title": "Url",
+            "type": "string"
+          }
+        },
+        "required": [
+          "repo_full_name",
+          "number",
+          "url"
+        ],
+        "title": "SessionPr",
+        "type": "object"
+      },
       "SessionPrompting": {
         "description": "The prompt-affordance projection. `enabled` answers \"would a send work\",\nand when it wouldn't, `blocked_reason` + `detail` say why.\n\n`surface_name` is set only for MENTION_SURFACE, naming where to reply.",
         "properties": {
@@ -7751,16 +7790,43 @@
         "title": "SessionSearchScope",
         "type": "string"
       },
-      "SessionState": {
-        "description": "Lifecycle of a keyed (multi-turn) session \u2014 the durable conversation.\nDistinct from AgentSessionStatus, which is per-execution (one turn's run) and\nmoves to agent_turns in a later slice. IDLE: alive, waiting for the next\nmessage. RUNNING: a turn is executing. CLOSED: the conversation is done and\nits sandbox/snapshots are torn down.",
+      "SessionSource": {
         "enum": [
-          "idle",
-          "running",
-          "closed"
-        ],
+          "react",
+          "manual",
+          "api",
+          "cli",
+          "mention",
+          "cron",
+          "laptop"
+        ],
+        "title": "SessionSource",
+        "type": "string"
+      },
+      "SessionState": {
+        "description": "Lifecycle of a keyed (multi-turn) session \u2014 the durable conversation.\nDistinct from SessionStatus, which is per-execution (one turn's run) and\nmoves to agent_turns in a later slice. IDLE: alive, waiting for the next\nmessage. RUNNING: a turn is executing. CLOSED: the conversation is done and\nits sandbox/snapshots are torn down.",
+        "enum": [
+          "idle",
+          "running",
+          "closed"
+        ],
         "title": "SessionState",
         "type": "string"
       },
+      "SessionStatus": {
+        "enum": [
+          "scheduled",
+          "creating_sandbox",
+          "running",
+          "retrying",
+          "completed",
+          "error",
+          "cancelled",
+          "stopped"
+        ],
+        "title": "SessionStatus",
+        "type": "string"
+      },
       "SessionSurface": {
         "description": "The three fields we expose. All `None` for an un-keyed (laptop) session.\n\n`use_enum_values=True` (from CustomBaseModel) stores the members as their\nstring values, so this serializes to `{\"session\": \"alive\", \"run\": \"waiting\",\n\"status\": \"waiting\"}` \u2014 a plain object, not enum names.",
         "properties": {
@@ -8081,7 +8147,7 @@
                 "type": "null"
               }
             ],
-            "description": "A saved agent config id to run under.",
+            "description": "A saved agent config to run under: its id, or the agent's customer-unique `ellipsis.name`.",
             "title": "Config Id"
           },
           "config_override": {
@@ -8132,6 +8198,19 @@
             "title": "Idle Start",
             "type": "boolean"
           },
+          "input": {
+            "anyOf": [
+              {
+                "additionalProperties": true,
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The typed payload for an agent that declares input.json_schema: validated against the effective config's schema (422 on mismatch), rendered into the session's initial message (the agent's input.message template, or a JSON block). Required when the agent declares a schema; rejected when it does not.",
+            "title": "Input"
+          },
           "metadata": {
             "additionalProperties": {
               "type": "string"
@@ -8746,10 +8825,11 @@
         "summary": "List Agent Configs",
         "tags": [
           "v1"
-        ]
+        ],
+        "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.\n\nAccepts an inline config or a gallery template slug.",
+        "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.",
         "operationId": "create_agent_config",
         "parameters": [
           {
@@ -8838,17 +8918,17 @@
                 }
               }
             },
-            "description": "Another agent is already synced from that path, or a file already exists there."
+            "description": "An agent with that name already exists, another agent is already synced from that path, or a file already exists there."
           },
           "422": {
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/HTTPValidationError"
+                  "$ref": "#/components/schemas/ErrorResponse"
                 }
               }
             },
-            "description": "Validation Error"
+            "description": "The agent's name contains no usable characters."
           }
         },
         "security": [
@@ -8859,12 +8939,13 @@
         "summary": "Create Agent Config",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "agents.configs.create"
       }
     },
     "/agents/configs/{config_id}": {
       "get": {
-        "description": "Return one saved agent config by id.",
+        "description": "Return one saved agent config, by id or by the agent's name.",
         "operationId": "get_agent_config",
         "parameters": [
           {
@@ -8953,7 +9034,8 @@
         "summary": "Get Agent Config",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "agents.configs.get"
       }
     },
     "/agents/defaults": {
@@ -9049,7 +9131,8 @@
         "summary": "Delete Agent Default",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "agents.defaults.delete"
       },
       "get": {
         "description": "List default agent configs.\n\nThe account default and any per-repository defaults.\n\nDefaults are addressed by rung: the account rung is repository\nomitted, a repo rung is \"owner/name\" \u2014 never by row id.",
@@ -9122,10 +9205,11 @@
         "summary": "List Agent Defaults",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "agents.defaults.list"
       },
       "put": {
-        "description": "Set a default agent config.\n\nAddressed by rung: the account rung (repository omitted) or a\nrepository rung (\"owner/name\").\n\nRefused for sandbox tokens (potentially prompt-injected code\nmust not repoint the account's ambient default); an unknown or\nforeign repository is a 404.",
+        "description": "Set a default agent config.\n\nAddressed by rung: the account rung (repository omitted) or a\nrepository rung (\"owner/name\"); the config by id or by the\nagent's name.\n\nRefused for sandbox tokens (potentially prompt-injected code\nmust not repoint the account's ambient default); an unknown or\nforeign repository is a 404.",
         "operationId": "put_agent_default",
         "parameters": [
           {
@@ -9225,7 +9309,8 @@
         "summary": "Put Agent Default",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "agents.defaults.set"
       }
     },
     "/agents/templates": {
@@ -9300,7 +9385,8 @@
         "summary": "List Agent Templates",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "agents.templates.list"
       }
     },
     "/agents/templates/{template_id}": {
@@ -9394,7 +9480,8 @@
         "summary": "Get Agent Template",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "agents.templates.get"
       }
     },
     "/alerts": {
@@ -9529,7 +9616,8 @@
         "summary": "List Alerts",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "alerts.list"
       }
     },
     "/alerts/{alert_id}": {
@@ -9623,7 +9711,8 @@
         "summary": "Get Alert",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "alerts.get"
       }
     },
     "/alerts/{alert_id}/dismiss": {
@@ -9727,7 +9816,8 @@
         "summary": "Dismiss Alert",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "alerts.dismiss"
       }
     },
     "/analytics/metrics": {
@@ -9935,7 +10025,8 @@
         "summary": "Get Analytics Metrics",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "analytics.metrics"
       }
     },
     "/analytics/pull-requests": {
@@ -10146,7 +10237,8 @@
         "summary": "Get Analytics Pull Requests",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "analytics.pull_requests"
       }
     },
     "/analytics/reviews": {
@@ -10350,7 +10442,8 @@
         "summary": "Get Analytics Reviews",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "analytics.reviews"
       }
     },
     "/auth/cli/poll": {
@@ -10422,7 +10515,8 @@
         "summary": "Cli Auth Poll",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "auth.cli.poll"
       }
     },
     "/auth/cli/start": {
@@ -10464,7 +10558,8 @@
         "summary": "Cli Auth Start",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "auth.cli.start"
       }
     },
     "/budget": {
@@ -10539,7 +10634,8 @@
         "summary": "Get Budget",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "budget"
       }
     },
     "/files": {
@@ -10658,7 +10754,8 @@
         "summary": "List Files",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "files.list"
       },
       "post": {
         "description": "Upload a file that outlives the sandbox.\n\nv1: PNG images only, base64 in the JSON body, 10 MiB cap. The\nprimary caller is the in-sandbox `agent file upload` CLI (an\nagent persisting a screenshot to link on a PR), but all\ncredential types work. Returns the org-membership-gated\ndashboard URL so callers never hard-code URL shapes.",
@@ -10761,7 +10858,8 @@
         "summary": "Create File",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "files.create"
       }
     },
     "/files/{file_id}": {
@@ -10848,7 +10946,8 @@
         "summary": "Delete File",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "files.delete"
       },
       "get": {
         "description": "Return one file's metadata and download link.\n\nIncludes the gated dashboard URL and a short-lived presigned\n`download_url`.\n\nTo fetch the bytes locally, call this and then GET download_url\nimmediately \u2014 the JSON API never carries the file. The CLI's\n`agent file get` wraps exactly that two-step.",
@@ -10940,7 +11039,8 @@
         "summary": "Get File",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "files.get"
       }
     },
     "/integrations": {
@@ -11015,7 +11115,8 @@
         "summary": "Get Integrations",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "integrations.list"
       }
     },
     "/integrations/github/members": {
@@ -11090,7 +11191,8 @@
         "summary": "List Github Members",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "integrations.github.members"
       }
     },
     "/integrations/github/repos": {
@@ -11165,7 +11267,8 @@
         "summary": "List Github Repositories",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "integrations.github.repos"
       }
     },
     "/integrations/linear/teams": {
@@ -11250,7 +11353,8 @@
         "summary": "List Linear Teams",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "integrations.linear.teams"
       }
     },
     "/integrations/sentry/organizations": {
@@ -11325,7 +11429,8 @@
         "summary": "List Sentry Organizations",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "integrations.sentry.organizations"
       }
     },
     "/integrations/slack/channels": {
@@ -11410,7 +11515,8 @@
         "summary": "List Slack Channels",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "integrations.slack.channels"
       }
     },
     "/integrations/slack/members": {
@@ -11495,7 +11601,8 @@
         "summary": "List Slack Members",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "integrations.slack.members"
       }
     },
     "/me": {
@@ -11570,7 +11677,8 @@
         "summary": "Whoami",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "me"
       }
     },
     "/memories": {
@@ -11663,7 +11771,8 @@
         "summary": "List Memories",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "memories.list"
       },
       "post": {
         "description": "Save a memory for future agent sessions.\n\nMemories are durable lessons shared across the whole\norganization \u2014 conventions, past decisions, known gotchas that an\nagent cannot derive from the repository itself. One concise fact\nper memory; the description is what a reader sees in the index.\n\nCreating never overwrites: a path that already exists is a 409, so\ncorrecting an existing memory is an explicit edit.",
@@ -11756,7 +11865,8 @@
         "summary": "Create Memory",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "memories.create"
       }
     },
     "/memories/{memory_id}": {
@@ -11871,7 +11981,8 @@
         "summary": "Delete Memory",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "memories.delete"
       },
       "get": {
         "description": "Read one memory's full content.\n\nThe id comes from the index returned by listing memories.",
@@ -11963,7 +12074,8 @@
         "summary": "Get Memory",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "memories.get"
       },
       "put": {
         "description": "Correct an existing memory in place.\n\nPass description, content, or both. This never creates a memory (an\nunknown id is a 404) and never moves one \u2014 the path is immutable, so\nrelocating a memory is a delete plus a create.\n\nPass `if_sha256` (from a previous read) to make a concurrent write\na 409 instead of silently overwriting it.",
@@ -12075,7 +12187,8 @@
         "summary": "Edit Memory",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "memories.edit"
       }
     },
     "/models": {
@@ -12150,7 +12263,8 @@
         "summary": "List Supported Models",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "models.list"
       }
     },
     "/reviews": {
@@ -12337,7 +12451,8 @@
         "summary": "List Reviews",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "reviews.list"
       },
       "post": {
         "description": "Run a code review on demand.\n\nReviews an existing PR or a pushed branch (for a branch, the\nplatform finds or creates a draft PR for it, since a code\nreview is structurally about a PR).\n\nA review is one pipeline run over one commit range, with one\nagent session per stage: `review.id` is the run id, and\n`stages[].session_id` is where a client streams\n(/sessions/{id}/stream on a stage session), since the review\nitself is a pipeline rather than one process.",
@@ -12450,7 +12565,8 @@
         "summary": "Create Review",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "reviews.create"
       }
     },
     "/reviews/{review_id}": {
@@ -12544,7 +12660,8 @@
         "summary": "Get Review",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "reviews.get"
       }
     },
     "/secrets": {
@@ -12619,7 +12736,8 @@
         "summary": "List Secrets",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "secrets.list"
       },
       "put": {
         "description": "Upsert secrets.\n\nReturns only the secrets this call wrote, names and timestamps\nonly \u2014 values are write-only. Refused for sandbox tokens (held by\npotentially-untrusted in-sandbox code); mutations require an\nAPI key or user token.",
@@ -12712,7 +12830,8 @@
         "summary": "Put Secrets",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "secrets.set"
       }
     },
     "/secrets/{name}": {
@@ -12789,15 +12908,17 @@
         "summary": "Delete Secret",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "secrets.delete"
       }
     },
     "/sessions": {
       "get": {
-        "description": "List cloud agent sessions, newest first.\n\nOptionally filtered by config, source, time window, attributed\nauthor, repository, and whether the session is still going.",
+        "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",
         "parameters": [
           {
+            "description": "A saved config id, or the agent's `ellipsis.name`.",
             "in": "query",
             "name": "config_id",
             "required": false,
@@ -12810,6 +12931,7 @@
                   "type": "null"
                 }
               ],
+              "description": "A saved config id, or the agent's `ellipsis.name`.",
               "title": "Config Id"
             }
           },
@@ -12821,7 +12943,7 @@
               "anyOf": [
                 {
                   "items": {
-                    "$ref": "#/components/schemas/AgentSessionSource"
+                    "$ref": "#/components/schemas/SessionSource"
                   },
                   "type": "array"
                 },
@@ -13025,10 +13147,11 @@
         "summary": "List Agent Sessions",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "sessions.list"
       },
       "post": {
-        "description": "Start a cloud agent session.\n\nProvide at most one of config_id, config, or template_id; with\nnone, the account's default-config ladder resolves the config.\n400 when idle_start is combined with prompt or handoff, or when\na handoff is combined with any config source or override.",
+        "description": "Start a cloud agent session.\n\nProvide at most one of config_id (an id or an agent name),\nconfig, or\ntemplate_id; with none, the account's default-config ladder\nresolves the config. 400 when idle_start is combined with\nprompt, input, or handoff, or when a handoff is combined with\nany config source or override. 422 when the agent declares an\ninput schema and the request's input is absent or invalid.",
         "operationId": "start_agent_session",
         "parameters": [
           {
@@ -13077,7 +13200,7 @@
                 }
               }
             },
-            "description": "The request combines incompatible fields (multiple config sources, idle_start with prompt/handoff, a handoff with a config source, or both override forms), or the config override / handoff repo/sha is invalid."
+            "description": "The request combines incompatible fields (multiple config sources, idle_start with prompt/input/handoff, a handoff with a config source, or both override forms), or the config override / handoff repo/sha is invalid."
           },
           "401": {
             "content": {
@@ -13107,7 +13230,7 @@
                 }
               }
             },
-            "description": "The named config, template, or handoff parent session does not exist in your account."
+            "description": "The named agent, template, or handoff parent session does not exist in your account."
           },
           "409": {
             "content": {
@@ -13123,11 +13246,11 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/HTTPValidationError"
+                  "$ref": "#/components/schemas/ErrorResponse"
                 }
               }
             },
-            "description": "Validation Error"
+            "description": "The agent requires 'input' matching its input schema (missing or failed validation), or declares no input schema and 'input' was sent."
           }
         },
         "security": [
@@ -13138,7 +13261,8 @@
         "summary": "Start Agent Session",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "sessions.start"
       }
     },
     "/sessions/search": {
@@ -13172,7 +13296,7 @@
               "anyOf": [
                 {
                   "items": {
-                    "$ref": "#/components/schemas/AgentSessionSource"
+                    "$ref": "#/components/schemas/SessionSource"
                   },
                   "type": "array"
                 },
@@ -13270,7 +13394,7 @@
               "anyOf": [
                 {
                   "items": {
-                    "$ref": "#/components/schemas/AgentSessionStatus"
+                    "$ref": "#/components/schemas/SessionStatus"
                   },
                   "type": "array"
                 },
@@ -13404,7 +13528,8 @@
         "summary": "Search Sessions",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "sessions.search"
       }
     },
     "/sessions/sync": {
@@ -13509,7 +13634,8 @@
         "summary": "Sync Agent Session",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "sessions.sync"
       }
     },
     "/sessions/{session_id}": {
@@ -13603,7 +13729,8 @@
         "summary": "Get Agent Session",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "sessions.get"
       }
     },
     "/sessions/{session_id}/executions": {
@@ -13697,13 +13824,14 @@
         "summary": "Get Agent Session Executions",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "sessions.executions"
       }
     },
-    "/sessions/{session_id}/ide": {
+    "/sessions/{session_id}/export": {
       "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",
+        "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",
         "parameters": [
           {
             "in": "path",
@@ -13736,7 +13864,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/GetSessionIdeResponse"
+                  "$ref": "#/components/schemas/GetSessionLogResponse"
                 }
               }
             },
@@ -13772,16 +13900,6 @@
             },
             "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": {
@@ -13798,16 +13916,17 @@
             "HTTPBearer": []
           }
         ],
-        "summary": "Get Agent Session Ide",
+        "summary": "Export Agent Session",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "sessions.export"
       }
     },
-    "/sessions/{session_id}/log": {
+    "/sessions/{session_id}/ide": {
       "get": {
-        "description": "Download the complete session log.\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": "get_agent_session_log",
+        "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",
@@ -13840,7 +13959,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/GetSessionLogResponse"
+                  "$ref": "#/components/schemas/GetSessionIdeResponse"
                 }
               }
             },
@@ -13876,6 +13995,16 @@
             },
             "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": {
@@ -13892,10 +14021,11 @@
             "HTTPBearer": []
           }
         ],
-        "summary": "Get Agent Session Log",
+        "summary": "Get Agent Session Ide",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "sessions.ide"
       }
     },
     "/sessions/{session_id}/messages": {
@@ -14019,7 +14149,103 @@
         "summary": "Send Agent Session Message",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "sessions.send_message"
+      }
+    },
+    "/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.",
+        "operationId": "get_agent_session_output",
+        "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": {
+                  "type": "object"
+                }
+              }
+            },
+            "description": "The session's typed output, exactly as the agent submitted it \u2014 the shape is the agent's own output.json_schema, with no envelope."
+          },
+          "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, the agent declares no output schema, the session has not completed, or it produced no output."
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            },
+            "description": "Validation Error"
+          }
+        },
+        "security": [
+          {
+            "HTTPBearer": []
+          }
+        ],
+        "summary": "Get Agent Session Output",
+        "tags": [
+          "v1"
+        ],
+        "x-ellipsis-sdk-method": "sessions.output"
       }
     },
     "/sessions/{session_id}/ports/{port}": {
@@ -14132,7 +14358,8 @@
         "summary": "Get Agent Session Port",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "sessions.port"
       }
     },
     "/sessions/{session_id}/records": {
@@ -14260,7 +14487,8 @@
         "summary": "Get Agent Session Records",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "sessions.records"
       }
     },
     "/sessions/{session_id}/replay": {
@@ -14374,7 +14602,8 @@
         "summary": "Replay Agent Session",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "sessions.replay"
       }
     },
     "/sessions/{session_id}/stop": {
@@ -14488,7 +14717,8 @@
         "summary": "Stop Agent Session",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "sessions.stop"
       }
     },
     "/sessions/{session_id}/transcript": {
@@ -14602,7 +14832,8 @@
         "summary": "Ingest Agent Session Transcript",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "sessions.ingest_transcript"
       }
     },
     "/usage": {
@@ -14677,7 +14908,8 @@
         "summary": "Get Usage Endpoint",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "usage"
       }
     }
   },