@ellipsis-dev/sdk 0.12.0 → 0.13.0

package/schema/openapi.v1.json

@@ -1028,6 +1028,21 @@
         "title": "AgentConfigSkill",
         "type": "object"
       },
+      "AgentConfigSource": {
+        "description": "Where a session's config came from. Total: every session has exactly one\nsource, including the ones that never touch defaults resolution.\n\nNot derivable from the row \u2014 `agent_config_id` says WHICH saved config, not\nhow it was chosen, and is null for inline, platform-default, and built-in\nconfigs alike \u2014 so it is persisted for audit and the published wire.",
+        "enum": [
+          "explicit",
+          "inline",
+          "template",
+          "repo_default",
+          "account_default",
+          "platform_default",
+          "trigger",
+          "builtin"
+        ],
+        "title": "AgentConfigSource",
+        "type": "string"
+      },
       "AgentConfigSourceGithub": {
         "description": "Identifies the file a GitHub-sourced agent config is synced from.\n\nKeyed on the repository ID (not owner/name) so repository and org renames\ndon't orphan the config; resolve display names from gh_repositories at\nread time.",
         "properties": {
@@ -1094,50 +1109,10 @@
         "title": "AgentConfigsListResponse",
         "type": "object"
       },
-      "AgentDefault": {
-        "description": "A default-agent setting: which agent config serves sessions started\nwithout an explicit config, for the whole account or for one repository.",
+      "AgentDefaults": {
+        "description": "Which agent config serves sessions started without an explicit config:\none account-wide rung, plus a rung per repository.\n\nValues are config ids \u2014 stable across renames, unlike the agent's name.\nA repo rung whose repository this installation can no longer see is absent\nfrom `repositories`; its row is left in place, so re-installing the repo\nbrings the rung back.",
         "properties": {
-          "broken": {
-            "anyOf": [
-              {
-                "enum": [
-                  "config_deleted",
-                  "config_disabled",
-                  "config_pending_pr",
-                  "repo_inaccessible"
-                ],
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Why this default cannot serve sessions, or null when it is healthy.",
-            "title": "Broken"
-          },
-          "config_id": {
-            "description": "The agent config this default points at.",
-            "title": "Config Id",
-            "type": "string"
-          },
-          "config_name": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "The pointed-at config's name; null when the config no longer exists.",
-            "title": "Config Name"
-          },
-          "id": {
-            "description": "The default's unique identifier.",
-            "title": "Id",
-            "type": "string"
-          },
-          "repository": {
+          "account": {
             "anyOf": [
               {
                 "type": "string"
@@ -1146,54 +1121,20 @@
                 "type": "null"
               }
             ],
-            "description": "The repository this default applies to, as \"owner/name\", or null for the account-wide default.",
-            "title": "Repository"
+            "description": "Config id serving sessions with no repository context, or null when no account default is set.",
+            "title": "Account"
           },
-          "updated_at": {
-            "description": "When the default was last changed.",
-            "format": "date-time",
-            "title": "Updated At",
-            "type": "string"
-          }
-        },
-        "required": [
-          "id",
-          "config_id",
-          "updated_at"
-        ],
-        "title": "AgentDefault",
-        "type": "object"
-      },
-      "AgentDefaultResponse": {
-        "description": "One default-agent setting.",
-        "properties": {
-          "default": {
-            "$ref": "#/components/schemas/AgentDefault",
-            "description": "The default-agent setting."
-          }
-        },
-        "required": [
-          "default"
-        ],
-        "title": "AgentDefaultResponse",
-        "type": "object"
-      },
-      "AgentDefaultsListResponse": {
-        "description": "The account's default-agent settings.",
-        "properties": {
-          "defaults": {
-            "description": "The configured defaults.",
-            "items": {
-              "$ref": "#/components/schemas/AgentDefault"
+          "repositories": {
+            "additionalProperties": {
+              "type": "string"
             },
-            "title": "Defaults",
-            "type": "array"
+            "default": {},
+            "description": "Config id per repository, keyed \"owner/name\". A repository with no default set is absent.",
+            "title": "Repositories",
+            "type": "object"
           }
         },
-        "required": [
-          "defaults"
-        ],
-        "title": "AgentDefaultsListResponse",
+        "title": "AgentDefaults",
         "type": "object"
       },
       "AgentTemplate": {
@@ -2283,16 +2224,6 @@
         "title": "CreateReviewRequest",
         "type": "object"
       },
-      "DefaultResolution": {
-        "description": "How a session that arrived with no explicit config source resolved its\nconfig (documents/eng/DEFAULT_CONFIGS.md \u00a74). Persisted on the session so\naudit and clients can say \"ran under X (repo default)\". A session started\nwith an explicit config/config_id/template_id never enters resolution and\nstores None.",
-        "enum": [
-          "repo_default",
-          "account_default",
-          "none"
-        ],
-        "title": "DefaultResolution",
-        "type": "string"
-      },
       "DurationPercentiles": {
         "description": "Percentiles of a duration distribution, in hours. p0 = fastest,\np100 = slowest; the spread shows how merge latency varies.",
         "properties": {
@@ -2417,7 +2348,7 @@
       "ErrorInfo": {
         "properties": {
           "code": {
-            "description": "Stable machine-readable error code. Open vocabulary \u2014 handle unknown codes by HTTP status. Known values: account_blocked, conflict, default_config_broken, failed_dependency, file_quota_exceeded, forbidden, internal_error, invalid_request, not_found, rate_limited, review_in_flight, session_closed, session_ephemeral_trigger, session_finished, session_harness_single_turn, session_laptop, session_mention_surface, session_non_interactive, unauthorized, unavailable.",
+            "description": "Stable machine-readable error code. Open vocabulary \u2014 handle unknown codes by HTTP status. Known values: account_blocked, conflict, contact_email_required, failed_dependency, file_quota_exceeded, forbidden, internal_error, invalid_request, not_found, rate_limited, review_in_flight, session_closed, session_ephemeral_trigger, session_finished, session_harness_single_turn, session_mention_surface, session_non_interactive, unauthorized, unavailable.",
             "title": "Code",
             "type": "string"
           },
@@ -3626,45 +3557,6 @@
         "title": "HTTPValidationError",
         "type": "object"
       },
-      "HandoffAgentSessionParams": {
-        "description": "Laptop-to-cloud handoff parameters (`agent session handoff`): start a\nfresh session on the built-in handoff config, chained to the handed-off\nsession. Mutually exclusive with config_id / config / template_id \u2014 the\nhandoff config is platform-owned.",
-        "properties": {
-          "parent_session_id": {
-            "description": "The session being handed off (usually a laptop-synced session).",
-            "title": "Parent Session Id",
-            "type": "string"
-          },
-          "ref": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Where the WIP commit was pushed (refs/ellipsis/handoff/<short>); recorded as a metadata breadcrumb.",
-            "title": "Ref"
-          },
-          "repo": {
-            "description": "\"owner/name\" (or a bare name under the caller's account).",
-            "title": "Repo",
-            "type": "string"
-          },
-          "sha": {
-            "description": "The work-in-progress commit the CLI pushed (a commit of the dirty working tree) \u2014 becomes the sandbox checkout target.",
-            "title": "Sha",
-            "type": "string"
-          }
-        },
-        "required": [
-          "parent_session_id",
-          "repo",
-          "sha"
-        ],
-        "title": "HandoffAgentSessionParams",
-        "type": "object"
-      },
       "Harness": {
         "enum": [
           "claude_code",
@@ -4151,7 +4043,7 @@
         "type": "object"
       },
       "ModelManufacturer": {
-        "description": "Who BUILT a model. Never who serves it.\n\nServing path is irrelevant here. Anthropic built every Claude model, so all of\nthem are ANTHROPIC whether we reach them through the first-party Anthropic API\nor through Bedrock -- a choice made per request by the llm_providers chain, so\nit is not even a fixed property of the model. Likewise the `gpt-5.6-*` rows\nare OPENAI (OpenAI's models, served by AWS via bedrock-mantle), and GLM is ZAI\n(Z.ai's model, served by Concentrate).\n\nSo this is deliberately NOT derived from `EgressRoute.provider`: routing is an\ninfrastructure fact that changes when we move a model between providers, while\nthe manufacturer is a property of the model itself and never changes.\n\nThe frontend renders a vendor logo per model, which is why it needs the maker.\nKeying that UI off the egress provider would put an AWS logo on a GPT model and\nan OpenAI logo on GLM.",
+        "description": "Who BUILT a model. Never who serves it.\n\nServing path is irrelevant here. Anthropic built every Claude model, so all of\nthem are ANTHROPIC whether we reach them through the first-party Anthropic API\nor through Bedrock -- a choice made per request by the llm_providers chain, so\nit is not even a fixed property of the model. Likewise the `gpt-5.6-*` rows\nare OPENAI (OpenAI's models, served by AWS via bedrock-mantle), and GLM is ZAI\n(Z.ai's model, served by DeepInfra via OpenRouter).\n\nSo this is deliberately NOT derived from `EgressRoute.provider`: routing is an\ninfrastructure fact that changes when we move a model between providers, while\nthe manufacturer is a property of the model itself and never changes.\n\nThe frontend renders a vendor logo per model, which is why it needs the maker.\nKeying that UI off the egress provider would put an AWS logo on a GPT model and\nan OpenAI logo on GLM.",
         "enum": [
           "anthropic",
           "openai",
@@ -4265,10 +4157,9 @@
         "type": "string"
       },
       "ParentKind": {
-        "description": "How a session relates to its predecessor (parent_agent_session_id) \u2014\nthe ONE \"preceded-by\" chain for every predecessor relationship. Routing\nreads this when the distinction matters.\n\nCONTINUATION \u2014 a follow-up in the same conversation surface (e.g. a Slack\nthread reply spawning a fresh session on the same thread).\nHANDOFF \u2014 a session started to take over work from another surface (e.g.\nlaptop \u2192 cloud handoff; later phase).\nRESUME \u2014 a conversation re-hosted on a new box after its sandbox was torn\ndown (interactive platform; later phase).",
+        "description": "How a session relates to its predecessor (parent_agent_session_id) \u2014\nthe ONE \"preceded-by\" chain for every predecessor relationship. Routing\nreads this when the distinction matters.\n\nCONTINUATION \u2014 a follow-up in the same conversation surface (e.g. a Slack\nthread reply spawning a fresh session on the same thread).\nRESUME \u2014 a conversation re-hosted on a new box after its sandbox was torn\ndown (interactive platform; later phase).",
         "enum": [
           "continuation",
-          "handoff",
           "resume"
         ],
         "title": "ParentKind",
@@ -4308,8 +4199,7 @@
           "ephemeral_trigger",
           "non_interactive",
           "harness_single_turn",
-          "closed",
-          "laptop"
+          "closed"
         ],
         "title": "PromptBlockedReason",
         "type": "string"
@@ -5106,7 +4996,7 @@
                 "type": "null"
               }
             ],
-            "description": "Optional partial-config override merged onto the chosen config and re-validated \u2014 e.g. {\"claude\": {\"model\": \"claude-opus-4-8\"}} to replay the run on a different model, or {\"limits\": {\"run\": 5.0}} to raise its budget. Mutually exclusive with config_override_yaml.",
+            "description": "Optional partial-config override merged onto the chosen config and re-validated \u2014 e.g. {\"claude\": {\"model\": \"claude-opus-4-8\"}} to replay the run on a different model, or {\"budget\": {\"session\": 5.0}} to raise its budget. Mutually exclusive with config_override_yaml.",
             "title": "Config Override"
           },
           "config_override_yaml": {
@@ -6739,6 +6629,10 @@
       "Session": {
         "description": "An agent session: one conversation with an agent, from trigger to\nterminal state. Returned by `GET /v1/sessions/{id}` and carried by the\nsession stream's `session`/`snapshot` frames \u2014 REST and stream never\ndisagree about what a session looks like.",
         "properties": {
+          "agent": {
+            "$ref": "#/components/schemas/SessionAgent",
+            "description": "The agent that ran: the config the session executed, where that config came from, and any override merged into it."
+          },
           "attribution": {
             "$ref": "#/components/schemas/SessionAttribution",
             "description": "The principal this session is attributed to."
@@ -6747,18 +6641,6 @@
             "$ref": "#/components/schemas/SessionBudget",
             "description": "The spend budget enforced for this session."
           },
-          "config_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Identifier of the saved agent config the session ran on, if any.",
-            "title": "Config Id"
-          },
           "context_repository": {
             "anyOf": [
               {
@@ -6781,17 +6663,6 @@
             "title": "Created At",
             "type": "string"
           },
-          "default_resolution": {
-            "anyOf": [
-              {
-                "$ref": "#/components/schemas/DefaultResolution"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "How the session's config was resolved from the account's defaults, when no explicit config was given."
-          },
           "exit_status": {
             "anyOf": [
               {
@@ -6838,18 +6709,6 @@
             "description": "When the session last received a message.",
             "title": "Last Message At"
           },
-          "live_summary": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "A live summary of the session's progress while it runs.",
-            "title": "Live Summary"
-          },
           "metadata": {
             "additionalProperties": {
               "type": "string"
@@ -6907,7 +6766,7 @@
           },
           "source": {
             "$ref": "#/components/schemas/SessionSource",
-            "description": "Where the session came from (e.g. react, manual, api, cli, mention, cron, laptop)."
+            "description": "Where the session came from (e.g. react, manual, api, cli, mention, cron)."
           },
           "status": {
             "$ref": "#/components/schemas/SessionStatus",
@@ -6929,6 +6788,17 @@
             "$ref": "#/components/schemas/SessionStopped",
             "description": "The stop request, if the session was stopped."
           },
+          "summary": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/SessionSummary"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The latest live summary of the session's progress while it runs, and when it was generated."
+          },
           "surface": {
             "anyOf": [
               {
@@ -6938,7 +6808,7 @@
                 "type": "null"
               }
             ],
-            "description": "The public status projection; null for laptop-synced sessions."
+            "description": "The public status projection; null on list/search responses, which do not derive it."
           },
           "tokens": {
             "$ref": "#/components/schemas/SessionTokens",
@@ -6958,11 +6828,56 @@
           "harness",
           "source",
           "status",
-          "prompting"
+          "prompting",
+          "agent"
         ],
         "title": "Session",
         "type": "object"
       },
+      "SessionAgent": {
+        "description": "The agent this session ran: the config it actually executed, where that\nconfig came from, and the diff that was merged in \u2014 the same\neffective-value-plus-provenance shape `SessionBudget` uses.\n\n`config` is the snapshot frozen when the session was created; `config_id`\npoints at the saved config as it exists NOW. They diverge legitimately: a\nYAML edit after the session started, or any `override`, leaves the pointer\ndescribing something the session never ran.",
+        "properties": {
+          "config": {
+            "$ref": "#/components/schemas/AgentConfig",
+            "description": "The agent config the session actually ran, frozen when the session was created."
+          },
+          "config_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Identifier of the saved config this session's snapshot was taken from. Null for inline, platform-default, and built-in configs. Points at the config as it exists now, which may have changed since.",
+            "title": "Config Id"
+          },
+          "override": {
+            "anyOf": [
+              {
+                "additionalProperties": true,
+                "type": "object"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The partial-config override merged into `config` for this session, or null when the config ran unmodified. `config` is the merged result; this is the diff.",
+            "title": "Override"
+          },
+          "source": {
+            "$ref": "#/components/schemas/AgentConfigSource",
+            "description": "How this session's config was chosen."
+          }
+        },
+        "required": [
+          "config",
+          "source"
+        ],
+        "title": "SessionAgent",
+        "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": {
@@ -7193,6 +7108,8 @@
           "missing_repo_access",
           "missing_token_permissions",
           "missing_sandbox_variables",
+          "blocked",
+          "contact_email_required",
           "cancelled",
           "interrupted",
           "error",
@@ -7838,8 +7755,7 @@
           "api",
           "cli",
           "mention",
-          "cron",
-          "laptop"
+          "cron"
         ],
         "title": "SessionSource",
         "type": "string"
@@ -7911,8 +7827,36 @@
         "title": "SessionStopped",
         "type": "object"
       },
+      "SessionSummary": {
+        "description": "A live one-line summary of what the session is working on, refreshed\nevery few steps while it runs.",
+        "properties": {
+          "created_at": {
+            "anyOf": [
+              {
+                "format": "date-time",
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "When this summary line was generated. Null on summaries written before generation time was tracked.",
+            "title": "Created At"
+          },
+          "description": {
+            "description": "One-line description of what the session is working on.",
+            "title": "Description",
+            "type": "string"
+          }
+        },
+        "required": [
+          "description"
+        ],
+        "title": "SessionSummary",
+        "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.",
+        "description": "The three fields we expose.\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": {
           "run": {
             "anyOf": [
@@ -8287,7 +8231,7 @@
                 "type": "null"
               }
             ],
-            "description": "Optional partial-config override merged onto the chosen config and re-validated (e.g. {\"limits\": {\"run\": 5.0}} to raise just this run's budget). Merged onto config_id/template_id or the platform default; with an inline config, set fields directly instead. Mutually exclusive with config_override_yaml.",
+            "description": "Optional partial-config override merged onto the chosen config and re-validated (e.g. {\"budget\": {\"session\": 5.0}} to raise just this session's budget). Merged onto config_id/template_id or the platform default; with an inline config, set fields directly instead. Mutually exclusive with config_override_yaml.",
             "title": "Config Override"
           },
           "config_override_yaml": {
@@ -8308,20 +8252,9 @@
             "title": "Force Rebuild",
             "type": "boolean"
           },
-          "handoff": {
-            "anyOf": [
-              {
-                "$ref": "#/components/schemas/HandoffAgentSessionParams"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Laptop-to-cloud handoff parameters. When set, the built-in handoff config is used and config_id/config/template_id must be omitted."
-          },
           "idle_start": {
             "default": false,
-            "description": "Start the session with no initial message: the sandbox spins up, the agent starts idle at the prompt, and the first message sent to the session opens turn 0. Mutually exclusive with prompt and handoff. Ignored when the resolved config is not interactive (an ephemeral run keeps its kickoff \u2014 it can never receive a message).",
+            "description": "Start the session with no initial message: the sandbox spins up, the agent starts idle at the prompt, and the first message sent to the session opens turn 0. Mutually exclusive with prompt. Ignored when the resolved config is not interactive (an ephemeral run keeps its kickoff \u2014 it can never receive a message).",
             "title": "Idle Start",
             "type": "boolean"
           },
@@ -8356,7 +8289,7 @@
                 "type": "null"
               }
             ],
-            "description": "Per-run instructions appended to the initial query after the config's shared system prompt. Applies regardless of which config source is used. For a handoff, this is the developer's handoff note.",
+            "description": "Per-run instructions appended to the initial query after the config's shared system prompt. Applies regardless of which config source is used.",
             "title": "Prompt"
           },
           "repository": {
@@ -8387,43 +8320,6 @@
         "title": "StartAgentSessionRequest",
         "type": "object"
       },
-      "StartAgentSessionResponse": {
-        "description": "The started session, plus explicit fields describing how its config\nwas resolved.",
-        "properties": {
-          "resolution_source": {
-            "anyOf": [
-              {
-                "$ref": "#/components/schemas/DefaultResolution"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Which rung of the defaults ladder chose the config (repo_default | account_default | none). Null when an explicit config/config_id/template_id (or a handoff) bypassed resolution."
-          },
-          "resolved_config_name": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "The name of the config the session runs under.",
-            "title": "Resolved Config Name"
-          },
-          "session": {
-            "$ref": "#/components/schemas/Session",
-            "description": "The started session."
-          }
-        },
-        "required": [
-          "session"
-        ],
-        "title": "StartAgentSessionResponse",
-        "type": "object"
-      },
       "StartCliAuthResponse": {
         "description": "A freshly minted device-code flow: show the user code (or open the\ncomplete URI) and poll with the device code.",
         "properties": {
@@ -8469,106 +8365,6 @@
         "title": "StartCliAuthResponse",
         "type": "object"
       },
-      "SyncAgentSessionRequest": {
-        "description": "One hook-driven transcript sync from a developer laptop. The CLI reads\nthe live on-disk Claude Code transcript, redacts it client-side, gzips\nit, and POSTs it here \u2014 once per turn and at termination.",
-        "properties": {
-          "cc_session_id": {
-            "description": "The Claude Code session uuid (from the hook payload's session_id).",
-            "title": "Cc Session Id",
-            "type": "string"
-          },
-          "cwd": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "The laptop working directory.",
-            "title": "Cwd"
-          },
-          "git_branch": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "The checked-out git branch.",
-            "title": "Git Branch"
-          },
-          "reason": {
-            "default": "stop",
-            "description": "Which hook fired the sync: \"stop\" (mid-session, once per turn) or \"session_end\" (the Claude Code process terminated).",
-            "enum": [
-              "stop",
-              "session_end"
-            ],
-            "title": "Reason",
-            "type": "string"
-          },
-          "repo": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "The enrolled repository (\"owner/name\", from the working directory's git remote).",
-            "title": "Repo"
-          },
-          "transcript_gzip_b64": {
-            "description": "The redacted transcript JSONL, gzipped then base64-encoded.",
-            "title": "Transcript Gzip B64",
-            "type": "string"
-          }
-        },
-        "required": [
-          "cc_session_id",
-          "transcript_gzip_b64"
-        ],
-        "title": "SyncAgentSessionRequest",
-        "type": "object"
-      },
-      "SyncAgentSessionResponse": {
-        "description": "The outcome of a laptop transcript sync.",
-        "properties": {
-          "accepted": {
-            "description": "False when the stored snapshot was already at least as long (longest snapshot wins) \u2014 acknowledged, nothing written.",
-            "title": "Accepted",
-            "type": "boolean"
-          },
-          "event_count": {
-            "description": "The number of transcript events in the stored snapshot.",
-            "title": "Event Count",
-            "type": "integer"
-          },
-          "process_id": {
-            "description": "The synced Claude Code process id.",
-            "title": "Process Id",
-            "type": "string"
-          },
-          "session_id": {
-            "description": "The platform session the sync mapped to.",
-            "title": "Session Id",
-            "type": "string"
-          }
-        },
-        "required": [
-          "session_id",
-          "process_id",
-          "event_count",
-          "accepted"
-        ],
-        "title": "SyncAgentSessionResponse",
-        "type": "object"
-      },
       "TokensInfo": {
         "additionalProperties": false,
         "description": "Token/cost usage, per record (one API call's counts, aggregate fields at\ntheir zero defaults) or aggregated per execution/session\n(compute_spend_from_records derives num_turns and cost_usd).\n\nStrict on purpose: this is our own persisted schema, so an unknown key is a\nwriter bug (the num_turns=0 bug shipped because a Claude Code usage dict\nvalidated leniently against this model, silently zeroing every\nnon-overlapping field). Legacy keys were dropped from persisted blobs by\nthe 2026-07-26 tokens_info migration; per-model usage lives on\n`execution.model_usage` (CC's modelUsage, verbatim).",
@@ -9704,7 +9500,7 @@
         "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.",
+        "description": "Get the default agent configs.\n\nThe account-wide default and the per-repository defaults, as config\nids. Repo rungs are keyed \"owner/name\"; a repository this\ninstallation can no longer see is omitted.",
         "operationId": "list_agent_defaults",
         "parameters": [
           {
@@ -9729,7 +9525,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/AgentDefaultsListResponse"
+                  "$ref": "#/components/schemas/AgentDefaults"
                 }
               }
             },
@@ -9778,7 +9574,7 @@
         "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\"); 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.",
+        "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. Returns the full resulting ladder.\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": [
           {
@@ -9813,7 +9609,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/AgentDefaultResponse"
+                  "$ref": "#/components/schemas/AgentDefaults"
                 }
               }
             },
@@ -13620,7 +13416,7 @@
             }
           },
           {
-            "description": "\"owner/name\" (exact) or a bare repo name, matched the same way as on GET /v1/sessions/search. Sessions whose repository is named only inside their agent config \u2014 dashboard starts, cron, handoffs \u2014 do not match.",
+            "description": "\"owner/name\" (exact) or a bare repo name, matched the same way as on GET /v1/sessions/search. Sessions whose repository is named only inside their agent config \u2014 dashboard starts, cron \u2014 do not match.",
             "in": "query",
             "name": "repo",
             "required": false,
@@ -13633,7 +13429,7 @@
                   "type": "null"
                 }
               ],
-              "description": "\"owner/name\" (exact) or a bare repo name, matched the same way as on GET /v1/sessions/search. Sessions whose repository is named only inside their agent config \u2014 dashboard starts, cron, handoffs \u2014 do not match.",
+              "description": "\"owner/name\" (exact) or a bare repo name, matched the same way as on GET /v1/sessions/search. Sessions whose repository is named only inside their agent config \u2014 dashboard starts, cron \u2014 do not match.",
               "title": "Repo"
             }
           },
@@ -13720,7 +13516,7 @@
         "x-ellipsis-sdk-method": "sessions.list"
       },
       "post": {
-        "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.",
+        "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 or input. 422 when the agent declares an\ninput schema and the request's input is absent or invalid.",
         "operationId": "start_agent_session",
         "parameters": [
           {
@@ -13755,7 +13551,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/StartAgentSessionResponse"
+                  "$ref": "#/components/schemas/SessionResponse"
                 }
               }
             },
@@ -13769,7 +13565,7 @@
                 }
               }
             },
-            "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."
+            "description": "The request combines incompatible fields (multiple config sources, idle_start with prompt/input, or both override forms), or the config override is invalid."
           },
           "401": {
             "content": {
@@ -13799,7 +13595,7 @@
                 }
               }
             },
-            "description": "The named agent, template, or handoff parent session does not exist in your account."
+            "description": "The named agent or template does not exist in your account."
           },
           "409": {
             "content": {
@@ -14101,112 +13897,6 @@
         "x-ellipsis-sdk-method": "sessions.search"
       }
     },
-    "/v1/sessions/sync": {
-      "post": {
-        "description": "Sync a local Claude Code session to Ellipsis.\n\nRequires a user token (device-flow `agent login`): the user is\npart of the sync's idempotency key, so API keys and sandbox\ntokens are rejected with a 403 rather than silently attributed.",
-        "operationId": "sync_agent_session",
-        "parameters": [
-          {
-            "in": "header",
-            "name": "user-agent",
-            "required": false,
-            "schema": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "title": "User-Agent"
-            }
-          }
-        ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/SyncAgentSessionRequest"
-              }
-            }
-          },
-          "required": true
-        },
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/SyncAgentSessionResponse"
-                }
-              }
-            },
-            "description": "Successful Response"
-          },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "The transcript payload is empty, or is not valid base64/gzip."
-          },
-          "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."
-          },
-          "413": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "The transcript exceeds the size limit (compressed or decompressed)."
-          },
-          "422": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/HTTPValidationError"
-                }
-              }
-            },
-            "description": "Validation Error"
-          }
-        },
-        "security": [
-          {
-            "HTTPBearer": []
-          }
-        ],
-        "summary": "Sync Agent Session",
-        "tags": [
-          "v1"
-        ],
-        "x-ellipsis-sdk-method": "sessions.sync"
-      }
-    },
     "/v1/sessions/{session_id}": {
       "get": {
         "description": "Return one session.\n\nThe public wire shape \u2014 the same shape the stream's session\nframes carry, with attributed_user and stopped_by_user resolved\nat read time.\n\nThe heavy near-static blobs (config snapshot, input/output)\nlive on the detail endpoints, not here.",
@@ -14592,7 +14282,7 @@
                 }
               }
             },
-            "description": "The session cannot be messaged: it is closed, non-interactive, laptop-synced, or steered from its triggering surface (mention/react/cron)."
+            "description": "The session cannot be messaged: it is closed, non-interactive, or steered from its triggering surface (mention/react/cron)."
           },
           "422": {
             "content": {
@@ -14714,7 +14404,7 @@
     },
     "/v1/sessions/{session_id}/records": {
       "get": {
-        "description": "Return the session's stored transcript records, oldest first.\n\nPagination is opt-in (cursor/limit); a bare call returns the\nfull retained transcript. Available to sandbox tokens too: an\nagent answering \"did X look into Y?\" needs to read the session\nit found via /sessions/search, and any org member sees the same\ntranscript in the dashboard (laptop transcripts are redacted\nclient-side before they are ever uploaded).",
+        "description": "Return the session's stored transcript records, oldest first.\n\nPagination is opt-in (cursor/limit); a bare call returns the\nfull retained transcript. Available to sandbox tokens too: an\nagent answering \"did X look into Y?\" needs to read the session\nit found via /sessions/search, and any org member sees the same\ntranscript in the dashboard.",
         "operationId": "get_agent_session_records",
         "parameters": [
           {
@@ -14901,7 +14591,7 @@
                 }
               }
             },
-            "description": "The session is a laptop session (not replayable), the named config does not exist, or the config override is invalid."
+            "description": "The named config does not exist, or the config override is invalid."
           },
           "401": {
             "content": {
@@ -14998,16 +14688,6 @@
             },
             "description": "Successful Response"
           },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "The session runs on a developer laptop and cannot be stopped from the cloud."
-          },
           "401": {
             "content": {
               "application/json": {