@ellipsis-dev/sdk 0.8.1 → 0.10.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": [
               {
@@ -470,6 +480,37 @@
         "title": "AgentConfigEllipsis",
         "type": "object"
       },
+      "AgentConfigEllipsisPermissions": {
+        "additionalProperties": {
+          "anyOf": [
+            {
+              "$ref": "#/components/schemas/Level"
+            },
+            {
+              "$ref": "#/components/schemas/EllipsisGrant"
+            },
+            {
+              "items": {
+                "anyOf": [
+                  {
+                    "$ref": "#/components/schemas/Level"
+                  },
+                  {
+                    "$ref": "#/components/schemas/EllipsisGrant"
+                  }
+                ]
+              },
+              "type": "array"
+            }
+          ]
+        },
+        "description": "`permissions.ellipsis` as a map: resource \u2192 level | grant | list of\ngrants. Levels are hierarchical (read < write < delete), so `write`\nincludes `read`. An unlisted resource is denied. The whole block is\nintersected with the platform's sandbox ceiling at token mint \u2014 it can\nnarrow what a sandbox token may do, never exceed it.",
+        "propertyNames": {
+          "$ref": "#/components/schemas/Resource"
+        },
+        "title": "AgentConfigEllipsisPermissions",
+        "type": "object"
+      },
       "AgentConfigEnvironment": {
         "additionalProperties": false,
         "description": "Everything about the environment (the sandbox) the agent runs in: which\n`repositories` are cloned into it, which environment `variables` it gets,\nits `compute` sizing, how its `image` is customized, and lifecycle `hooks`.\nWhat the agent may *do* from that environment is the top-level\n`permissions:` block, not this one.\n\nEach `variables` entry names a variable to inject; with an inline `value` it\nis hardcoded, without one it is resolved from the account's sandbox-secrets\nstore. Only the named variables reach this agent; the rest of the account's\nstored variables never do. This is how a config brings in the config and\ncredentials a custom CLI needs.",
@@ -645,6 +686,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,16 +837,39 @@
         "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.",
+        "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). `true` / the string `all` (the default) grant the full sandbox\nceiling \u2014 everything a sandbox token can ever do. A map narrows it per\nresource (see `AgentConfigEllipsisPermissions`); the minted token carries\nthe intersection, so a config can only ever reduce access. `false` fails\nvalidation \u2014 an agent with no API token cannot report its own progress.\n\n`github` scopes the sandbox's GitHub installation token (`GH_TOKEN`) \u2014\nsee `AgentConfigGithubPermissions`. GitHub enforces it at mint time.",
         "properties": {
           "ellipsis": {
-            "default": true,
-            "enum": [
-              true,
-              "all"
+            "anyOf": [
+              {
+                "enum": [
+                  true,
+                  "all"
+                ]
+              },
+              {
+                "$ref": "#/components/schemas/AgentConfigEllipsisPermissions"
+              }
             ],
+            "default": true,
             "title": "Ellipsis"
           },
           "github": {
@@ -982,27 +1077,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 +1211,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 +1897,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 +1974,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 +1998,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 +2012,7 @@
         },
         "required": [
           "id",
+          "sha",
           "created_at",
           "updated_at",
           "agent_config"
@@ -2359,6 +2371,34 @@
         "title": "EffortLevel",
         "type": "string"
       },
+      "EllipsisGrant": {
+        "additionalProperties": false,
+        "description": "One grant entry: a level, optionally narrowed to instances whose\nnatural key (a file's name, a memory's path, a secret's name, a config's\nname, a session's id) matches any of the `match` globs.",
+        "properties": {
+          "level": {
+            "$ref": "#/components/schemas/Level"
+          },
+          "match": {
+            "anyOf": [
+              {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Match"
+          }
+        },
+        "required": [
+          "level"
+        ],
+        "title": "EllipsisGrant",
+        "type": "object"
+      },
       "ErrorInfo": {
         "properties": {
           "code": {
@@ -3702,6 +3742,16 @@
         "title": "JiraIntegrationSummary",
         "type": "object"
       },
+      "Level": {
+        "description": "What may be done to a resource. Strictly ordered: a grant at one level\nincludes every level below it (write-only would be a phantom capability \u2014\nno real client can create what it cannot read back).",
+        "enum": [
+          "read",
+          "write",
+          "delete"
+        ],
+        "title": "Level",
+        "type": "string"
+      },
       "LinearIntegrationSummary": {
         "description": "The account's connected Linear organization and its teams.",
         "properties": {
@@ -4499,7 +4549,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 +4974,7 @@
             "anyOf": [
               {
                 "items": {
-                  "$ref": "#/components/schemas/AgentSessionPr"
+                  "$ref": "#/components/schemas/SessionPr"
                 },
                 "type": "array"
               },
@@ -4948,7 +4998,7 @@
           "session_source": {
             "anyOf": [
               {
-                "$ref": "#/components/schemas/AgentSessionSource"
+                "$ref": "#/components/schemas/SessionSource"
               },
               {
                 "type": "null"
@@ -4959,7 +5009,7 @@
           "session_status": {
             "anyOf": [
               {
-                "$ref": "#/components/schemas/AgentSessionStatus"
+                "$ref": "#/components/schemas/SessionStatus"
               },
               {
                 "type": "null"
@@ -5153,6 +5203,25 @@
         "title": "ResolvedReviewScope",
         "type": "object"
       },
+      "Resource": {
+        "description": "Everything a credential can be granted access to, one value per /v1\nresource family. `TOKENS` is reserved for the future token-management\nroutes; nothing maps to it yet.",
+        "enum": [
+          "account",
+          "alerts",
+          "sessions",
+          "files",
+          "memories",
+          "reviews",
+          "configs",
+          "defaults",
+          "secrets",
+          "templates",
+          "integrations",
+          "tokens"
+        ],
+        "title": "Resource",
+        "type": "string"
+      },
       "Review": {
         "description": "One code review: one pipeline iteration over one commit range of a pull\nrequest.\n\n`review_body`, `findings`, and `counters` are produced as each stage\nsession finishes \u2014 while a review is running they are null/empty. Stream a\nstage's session to follow it live, then re-fetch the review.",
         "properties": {
@@ -6638,53 +6707,27 @@
       "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.",
         "properties": {
-          "attributed_user": {
+          "attribution": {
+            "$ref": "#/components/schemas/SessionAttribution",
+            "description": "The principal this session is attributed to."
+          },
+          "budget": {
+            "$ref": "#/components/schemas/SessionBudget",
+            "description": "The spend budget enforced for this session."
+          },
+          "client_version": {
             "anyOf": [
               {
-                "$ref": "#/components/schemas/GithubAccountSnippet"
+                "type": "string"
               },
               {
                 "type": "null"
               }
             ],
-            "description": "The GitHub user the session is attributed to, when the attribution is a GitHub user."
+            "description": "Version of the client that started the session, if reported.",
+            "title": "Client Version"
           },
-          "attribution_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Identifier of the principal the session is attributed to.",
-            "title": "Attribution Id"
-          },
-          "attribution_type": {
-            "anyOf": [
-              {
-                "$ref": "#/components/schemas/AttributionType"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Kind of principal the session is attributed to (e.g. a GitHub user or an API key)."
-          },
-          "client_version": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Version of the client that started the session, if reported.",
-            "title": "Client Version"
-          },
-          "config_id": {
+          "config_id": {
             "anyOf": [
               {
                 "type": "string"
@@ -6721,28 +6764,9 @@
             "description": "The \"owner/name\" repository context the session was started in, if any.",
             "title": "Context Repository"
           },
-          "cost_fee": {
-            "default": 0,
-            "description": "Platform fee in millicents.",
-            "title": "Cost Fee",
-            "type": "integer"
-          },
-          "cost_sandbox_cpu": {
-            "default": 0,
-            "description": "Sandbox CPU spend in millicents.",
-            "title": "Cost Sandbox Cpu",
-            "type": "integer"
-          },
-          "cost_sandbox_memory": {
-            "default": 0,
-            "description": "Sandbox memory spend in millicents.",
-            "title": "Cost Sandbox Memory",
-            "type": "integer"
-          },
-          "cost_tokens": {
-            "description": "Token spend in millicents. The session's grand total cost is the sum of cost_tokens, cost_sandbox_cpu, cost_sandbox_memory, and cost_fee.",
-            "title": "Cost Tokens",
-            "type": "integer"
+          "cost": {
+            "$ref": "#/components/schemas/SessionCost",
+            "description": "What the session cost, in millicents, broken down by leg and carrying its own total."
           },
           "created_at": {
             "description": "When the session was created.",
@@ -6764,7 +6788,7 @@
           "exit_status": {
             "anyOf": [
               {
-                "$ref": "#/components/schemas/AgentSessionExitStatus"
+                "$ref": "#/components/schemas/SessionExitStatus"
               },
               {
                 "type": "null"
@@ -6832,7 +6856,7 @@
             "anyOf": [
               {
                 "items": {
-                  "$ref": "#/components/schemas/AgentSessionPr"
+                  "$ref": "#/components/schemas/SessionPr"
                 },
                 "type": "array"
               },
@@ -6843,28 +6867,9 @@
             "description": "Pull requests the session created or updated.",
             "title": "Output Prs"
           },
-          "parent_kind": {
-            "anyOf": [
-              {
-                "$ref": "#/components/schemas/ParentKind"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "How this session relates to its parent session, if any."
-          },
-          "parent_session_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Identifier of the parent session that spawned this one, if any.",
-            "title": "Parent Session Id"
+          "parent": {
+            "$ref": "#/components/schemas/SessionParent",
+            "description": "What preceded this session, if anything."
           },
           "prompt": {
             "anyOf": [
@@ -6882,27 +6887,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."
           },
-          "replayed_from_session_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Identifier of the original session this one was replayed from, if it was started via replay.",
-            "title": "Replayed From Session Id"
-          },
-          "resolved_budget_cents": {
-            "description": "The spend budget resolved for this session, in cents.",
-            "title": "Resolved Budget Cents",
-            "type": "integer"
-          },
-          "resolved_budget_source": {
-            "$ref": "#/components/schemas/BudgetSource",
-            "description": "Where the resolved budget came from."
-          },
           "sandbox_id": {
             "anyOf": [
               {
@@ -6939,11 +6923,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": {
@@ -6958,41 +6942,9 @@
             "description": "Human-readable reason for the current status, when there is one.",
             "title": "Status Reason"
           },
-          "stopped_at": {
-            "anyOf": [
-              {
-                "format": "date-time",
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "When a stop was requested, if one was.",
-            "title": "Stopped At"
-          },
-          "stopped_by": {
-            "anyOf": [
-              {
-                "type": "integer"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "GitHub account id of the user who stopped the session, if known.",
-            "title": "Stopped By"
-          },
-          "stopped_by_user": {
-            "anyOf": [
-              {
-                "$ref": "#/components/schemas/GithubAccountSnippet"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "The GitHub user who stopped the session, if it was stopped."
+          "stopped": {
+            "$ref": "#/components/schemas/SessionStopped",
+            "description": "The stop request, if the session was stopped."
           },
           "surface": {
             "anyOf": [
@@ -7005,40 +6957,9 @@
             ],
             "description": "The public status projection; null for laptop-synced sessions."
           },
-          "tokens_cache_creation": {
-            "default": 0,
-            "description": "Tokens written to the prompt cache.",
-            "title": "Tokens Cache Creation",
-            "type": "integer"
-          },
-          "tokens_cache_read": {
-            "default": 0,
-            "description": "Tokens read from the prompt cache.",
-            "title": "Tokens Cache Read",
-            "type": "integer"
-          },
-          "tokens_input": {
-            "default": 0,
-            "description": "Input tokens used.",
-            "title": "Tokens Input",
-            "type": "integer"
-          },
-          "tokens_model": {
-            "description": "The model the token counts are attributed to.",
-            "title": "Tokens Model",
-            "type": "string"
-          },
-          "tokens_output": {
-            "default": 0,
-            "description": "Output tokens used.",
-            "title": "Tokens Output",
-            "type": "integer"
-          },
-          "tokens_total": {
-            "default": 0,
-            "description": "Total tokens used by the session.",
-            "title": "Tokens Total",
-            "type": "integer"
+          "tokens": {
+            "$ref": "#/components/schemas/SessionTokens",
+            "description": "The tokens the session spent and the model they went to. `total` includes the prompt-cache lanes."
           },
           "updated_at": {
             "description": "When the session was last updated.",
@@ -7076,16 +6997,108 @@
           "updated_at",
           "harness",
           "source",
-          "cost_tokens",
-          "tokens_model",
-          "resolved_budget_cents",
-          "resolved_budget_source",
           "status",
           "prompting"
         ],
         "title": "Session",
         "type": "object"
       },
+      "SessionAttribution": {
+        "description": "The principal a session is attributed to: what kind, its id, and \u2014 when\nthe kind is a GitHub user \u2014 the resolved display snippet.",
+        "properties": {
+          "id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Identifier of the principal the session is attributed to.",
+            "title": "Id"
+          },
+          "type": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/AttributionType"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Kind of principal the session is attributed to (e.g. a GitHub user or an API key)."
+          },
+          "user": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/GithubAccountSnippet"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The GitHub user the session is attributed to, resolved at read time. Null when the attribution is not a GitHub user."
+          }
+        },
+        "title": "SessionAttribution",
+        "type": "object"
+      },
+      "SessionBudget": {
+        "description": "The spend budget actually enforced for this session, and which layer of\nthe cascade set it.",
+        "properties": {
+          "cents": {
+            "default": 0,
+            "description": "The spend budget resolved for this session, in cents.",
+            "title": "Cents",
+            "type": "integer"
+          },
+          "source": {
+            "$ref": "#/components/schemas/BudgetSource",
+            "default": "account",
+            "description": "Where the resolved budget came from."
+          }
+        },
+        "title": "SessionBudget",
+        "type": "object"
+      },
+      "SessionCost": {
+        "description": "What a session (or one turn of it) cost, in millicents.\n\n`llm` is deliberately NOT called `tokens`: it would sit beside the `tokens`\nobject and read as \"the token count's cost\" rather than \"the cost of the\nLLM leg\".",
+        "properties": {
+          "fee": {
+            "default": 0,
+            "description": "Platform fee in millicents.",
+            "title": "Fee",
+            "type": "integer"
+          },
+          "llm": {
+            "default": 0,
+            "description": "LLM spend in millicents.",
+            "title": "Llm",
+            "type": "integer"
+          },
+          "sandbox_cpu": {
+            "default": 0,
+            "description": "Sandbox CPU spend in millicents.",
+            "title": "Sandbox Cpu",
+            "type": "integer"
+          },
+          "sandbox_memory": {
+            "default": 0,
+            "description": "Sandbox memory spend in millicents.",
+            "title": "Sandbox Memory",
+            "type": "integer"
+          },
+          "total": {
+            "default": 0,
+            "description": "The grand total in millicents: llm + sandbox_cpu + sandbox_memory + fee.",
+            "title": "Total",
+            "type": "integer"
+          }
+        },
+        "title": "SessionCost",
+        "type": "object"
+      },
       "SessionExecution": {
         "description": "One runtime attempt of a session \u2014 the initial start, a cold wake of a\ndurable conversation, or an infrastructure retry \u2014 including the launch\ncontext the model was actually given.",
         "properties": {
@@ -7209,6 +7222,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 +7429,94 @@
         "title": "SessionMessageStatus",
         "type": "string"
       },
+      "SessionParent": {
+        "description": "The ONE \"preceded-by\" chain: the predecessor session and how this one\nrelates to it. Not a parent that orchestrates children \u2014 a session never\nspawns sub-sessions.",
+        "properties": {
+          "kind": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/ParentKind"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "How this session relates to its parent session, if any."
+          },
+          "replayed_from_session_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Identifier of the original session this one was replayed from, if it was started via replay.",
+            "title": "Replayed From Session Id"
+          },
+          "session_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Identifier of the parent session that spawned this one, if any.",
+            "title": "Session Id"
+          }
+        },
+        "title": "SessionParent",
+        "type": "object"
+      },
+      "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,8 +7871,21 @@
         "title": "SessionSearchScope",
         "type": "string"
       },
+      "SessionSource": {
+        "enum": [
+          "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 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.",
+        "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",
@@ -7761,6 +7894,63 @@
         "title": "SessionState",
         "type": "string"
       },
+      "SessionStatus": {
+        "enum": [
+          "scheduled",
+          "creating_sandbox",
+          "running",
+          "retrying",
+          "completed",
+          "error",
+          "cancelled",
+          "stopped"
+        ],
+        "title": "SessionStatus",
+        "type": "string"
+      },
+      "SessionStopped": {
+        "description": "The stop request, if there was one: when, by which GitHub account id,\nand that account resolved to a display snippet.",
+        "properties": {
+          "at": {
+            "anyOf": [
+              {
+                "format": "date-time",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "When a stop was requested, if one was.",
+            "title": "At"
+          },
+          "by": {
+            "anyOf": [
+              {
+                "type": "integer"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "GitHub account id of the user who stopped the session, if known.",
+            "title": "By"
+          },
+          "by_user": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/GithubAccountSnippet"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The GitHub user who stopped the session, resolved at read time."
+          }
+        },
+        "title": "SessionStopped",
+        "type": "object"
+      },
       "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": {
@@ -7796,12 +7986,55 @@
             "title": "Status"
           }
         },
-        "required": [
-          "session",
-          "run",
-          "status"
-        ],
-        "title": "SessionSurface",
+        "required": [
+          "session",
+          "run",
+          "status"
+        ],
+        "title": "SessionSurface",
+        "type": "object"
+      },
+      "SessionTokens": {
+        "description": "The token counts a session (or turn) spent, and the model they went to.\n\n`total` INCLUDES the cache lanes, unlike the old flat `tokens_total` which\ncounted input+output+thinking only and left callers to add cache reads and\nwrites back themselves (the deleted `tokensTotalAll` helper). Cache tokens\ndominate an agent run's token bill, so a \"total\" that omits them is the\nwrong default and produced two competing totals in the dashboard.",
+        "properties": {
+          "cache_creation": {
+            "default": 0,
+            "description": "Tokens written to the prompt cache.",
+            "title": "Cache Creation",
+            "type": "integer"
+          },
+          "cache_read": {
+            "default": 0,
+            "description": "Tokens read from the prompt cache.",
+            "title": "Cache Read",
+            "type": "integer"
+          },
+          "input": {
+            "default": 0,
+            "description": "Input tokens used.",
+            "title": "Input",
+            "type": "integer"
+          },
+          "model": {
+            "default": "",
+            "description": "The model the token counts are attributed to.",
+            "title": "Model",
+            "type": "string"
+          },
+          "output": {
+            "default": 0,
+            "description": "Output tokens used.",
+            "title": "Output",
+            "type": "integer"
+          },
+          "total": {
+            "default": 0,
+            "description": "Total tokens consumed, INCLUDING the prompt-cache reads and writes \u2014 the same basis the token cost is priced on.",
+            "title": "Total",
+            "type": "integer"
+          }
+        },
+        "title": "SessionTokens",
         "type": "object"
       },
       "SessionsListResponse": {
@@ -8081,7 +8314,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 +8365,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 +8992,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 +9085,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 +9106,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 +9201,8 @@
         "summary": "Get Agent Config",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "agents.configs.get"
       }
     },
     "/agents/defaults": {
@@ -9049,7 +9298,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 +9372,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 +9476,8 @@
         "summary": "Put Agent Default",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "agents.defaults.set"
       }
     },
     "/agents/templates": {
@@ -9300,7 +9552,8 @@
         "summary": "List Agent Templates",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "agents.templates.list"
       }
     },
     "/agents/templates/{template_id}": {
@@ -9394,7 +9647,8 @@
         "summary": "Get Agent Template",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "agents.templates.get"
       }
     },
     "/alerts": {
@@ -9529,7 +9783,8 @@
         "summary": "List Alerts",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "alerts.list"
       }
     },
     "/alerts/{alert_id}": {
@@ -9623,7 +9878,8 @@
         "summary": "Get Alert",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "alerts.get"
       }
     },
     "/alerts/{alert_id}/dismiss": {
@@ -9727,7 +9983,8 @@
         "summary": "Dismiss Alert",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "alerts.dismiss"
       }
     },
     "/analytics/metrics": {
@@ -9935,7 +10192,8 @@
         "summary": "Get Analytics Metrics",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "analytics.metrics"
       }
     },
     "/analytics/pull-requests": {
@@ -10146,7 +10404,8 @@
         "summary": "Get Analytics Pull Requests",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "analytics.pull_requests"
       }
     },
     "/analytics/reviews": {
@@ -10350,7 +10609,8 @@
         "summary": "Get Analytics Reviews",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "analytics.reviews"
       }
     },
     "/auth/cli/poll": {
@@ -10422,7 +10682,8 @@
         "summary": "Cli Auth Poll",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "auth.cli.poll"
       }
     },
     "/auth/cli/start": {
@@ -10464,7 +10725,8 @@
         "summary": "Cli Auth Start",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "auth.cli.start"
       }
     },
     "/budget": {
@@ -10539,7 +10801,8 @@
         "summary": "Get Budget",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "budget"
       }
     },
     "/files": {
@@ -10658,7 +10921,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 +11025,8 @@
         "summary": "Create File",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "files.create"
       }
     },
     "/files/{file_id}": {
@@ -10848,7 +11113,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 +11206,8 @@
         "summary": "Get File",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "files.get"
       }
     },
     "/integrations": {
@@ -11015,7 +11282,8 @@
         "summary": "Get Integrations",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "integrations.list"
       }
     },
     "/integrations/github/members": {
@@ -11090,7 +11358,8 @@
         "summary": "List Github Members",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "integrations.github.members"
       }
     },
     "/integrations/github/repos": {
@@ -11165,7 +11434,8 @@
         "summary": "List Github Repositories",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "integrations.github.repos"
       }
     },
     "/integrations/linear/teams": {
@@ -11250,7 +11520,8 @@
         "summary": "List Linear Teams",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "integrations.linear.teams"
       }
     },
     "/integrations/sentry/organizations": {
@@ -11325,7 +11596,8 @@
         "summary": "List Sentry Organizations",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "integrations.sentry.organizations"
       }
     },
     "/integrations/slack/channels": {
@@ -11410,7 +11682,8 @@
         "summary": "List Slack Channels",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "integrations.slack.channels"
       }
     },
     "/integrations/slack/members": {
@@ -11495,7 +11768,8 @@
         "summary": "List Slack Members",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "integrations.slack.members"
       }
     },
     "/me": {
@@ -11570,7 +11844,8 @@
         "summary": "Whoami",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "me"
       }
     },
     "/memories": {
@@ -11663,7 +11938,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 +12032,8 @@
         "summary": "Create Memory",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "memories.create"
       }
     },
     "/memories/{memory_id}": {
@@ -11871,7 +12148,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 +12241,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 +12354,8 @@
         "summary": "Edit Memory",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "memories.edit"
       }
     },
     "/models": {
@@ -12150,7 +12430,8 @@
         "summary": "List Supported Models",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "models.list"
       }
     },
     "/reviews": {
@@ -12337,7 +12618,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 +12732,8 @@
         "summary": "Create Review",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "reviews.create"
       }
     },
     "/reviews/{review_id}": {
@@ -12544,7 +12827,8 @@
         "summary": "Get Review",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "reviews.get"
       }
     },
     "/secrets": {
@@ -12619,7 +12903,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 +12997,8 @@
         "summary": "Put Secrets",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "secrets.set"
       }
     },
     "/secrets/{name}": {
@@ -12789,15 +13075,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 +13098,7 @@
                   "type": "null"
                 }
               ],
+              "description": "A saved config id, or the agent's `ellipsis.name`.",
               "title": "Config Id"
             }
           },
@@ -12821,7 +13110,7 @@
               "anyOf": [
                 {
                   "items": {
-                    "$ref": "#/components/schemas/AgentSessionSource"
+                    "$ref": "#/components/schemas/SessionSource"
                   },
                   "type": "array"
                 },
@@ -13025,10 +13314,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 +13367,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 +13397,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 +13413,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 +13428,8 @@
         "summary": "Start Agent Session",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "sessions.start"
       }
     },
     "/sessions/search": {
@@ -13172,7 +13463,7 @@
               "anyOf": [
                 {
                   "items": {
-                    "$ref": "#/components/schemas/AgentSessionSource"
+                    "$ref": "#/components/schemas/SessionSource"
                   },
                   "type": "array"
                 },
@@ -13270,7 +13561,7 @@
               "anyOf": [
                 {
                   "items": {
-                    "$ref": "#/components/schemas/AgentSessionStatus"
+                    "$ref": "#/components/schemas/SessionStatus"
                   },
                   "type": "array"
                 },
@@ -13404,7 +13695,8 @@
         "summary": "Search Sessions",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "sessions.search"
       }
     },
     "/sessions/sync": {
@@ -13509,7 +13801,8 @@
         "summary": "Sync Agent Session",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "sessions.sync"
       }
     },
     "/sessions/{session_id}": {
@@ -13603,7 +13896,8 @@
         "summary": "Get Agent Session",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "sessions.get"
       }
     },
     "/sessions/{session_id}/executions": {
@@ -13697,13 +13991,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 +14031,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/GetSessionIdeResponse"
+                  "$ref": "#/components/schemas/GetSessionLogResponse"
                 }
               }
             },
@@ -13772,16 +14067,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 +14083,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 +14126,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/GetSessionLogResponse"
+                  "$ref": "#/components/schemas/GetSessionIdeResponse"
                 }
               }
             },
@@ -13876,6 +14162,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 +14188,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 +14316,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 +14525,8 @@
         "summary": "Get Agent Session Port",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "sessions.port"
       }
     },
     "/sessions/{session_id}/records": {
@@ -14260,7 +14654,8 @@
         "summary": "Get Agent Session Records",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "sessions.records"
       }
     },
     "/sessions/{session_id}/replay": {
@@ -14374,7 +14769,8 @@
         "summary": "Replay Agent Session",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "sessions.replay"
       }
     },
     "/sessions/{session_id}/stop": {
@@ -14488,7 +14884,8 @@
         "summary": "Stop Agent Session",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "sessions.stop"
       }
     },
     "/sessions/{session_id}/transcript": {
@@ -14602,7 +14999,8 @@
         "summary": "Ingest Agent Session Transcript",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "sessions.ingest_transcript"
       }
     },
     "/usage": {
@@ -14677,7 +15075,8 @@
         "summary": "Get Usage Endpoint",
         "tags": [
           "v1"
-        ]
+        ],
+        "x-ellipsis-sdk-method": "usage"
       }
     }
   },