@ellipsis-dev/sdk 0.16.0 → 0.17.0

package/schema/openapi.v1.json

@@ -29,7 +29,6 @@
             "$ref": "#/components/schemas/AgentConfigEllipsis",
             "default": {
               "enabled": true,
-              "interactive": true,
               "metadata": {
                 "annotations": {},
                 "labels": []
@@ -38,14 +37,23 @@
             }
           },
           "environment": {
-            "$ref": "#/components/schemas/AgentConfigEnvironment",
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "$ref": "#/components/schemas/AgentConfigEnvironment"
+              }
+            ],
             "default": {
               "compute": {},
               "hooks": {},
               "image": {},
+              "mcp_servers": [],
               "repositories": [],
               "variables": []
-            }
+            },
+            "title": "Environment"
           },
           "input": {
             "anyOf": [
@@ -57,21 +65,6 @@
               }
             ]
           },
-          "mcp_servers": {
-            "default": [],
-            "items": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "$ref": "#/components/schemas/AgentConfigMcpServer"
-                }
-              ]
-            },
-            "title": "Mcp Servers",
-            "type": "array"
-          },
           "output": {
             "anyOf": [
               {
@@ -414,7 +407,7 @@
       },
       "AgentConfigEllipsis": {
         "additionalProperties": false,
-        "description": "The Ellipsis product namespace for a config file: which schema this is\n(`version`), the human-facing identity (`name`/`description`), freeform\norganizational `metadata`, whether the agent is `enabled`, and the\nhuman-access flag `interactive`. The presence of a top-level `ellipsis:`\nmapping is what marks a YAML file as an Ellipsis agent config (vs arbitrary\nYAML that merely lives under a config directory) \u2014 see\n`yaml_is_ellipsis_config`.\n\n`enabled`/`interactive` are agent behavior, not freeform metadata, so they\nstay inside the config `sha` (only `metadata` is sha-excluded).\n`interactive` lets a human `agent session connect` to a live session (CLI\nrelay). It does not decide whether a session is ephemeral or durable \u2014 that\nis the trigger's job.",
+        "description": "The Ellipsis product namespace for a config file: which schema this is\n(`version`), the human-facing identity (`name`/`description`), freeform\norganizational `metadata`, and whether the agent is `enabled`. The\npresence of a top-level `ellipsis:` mapping is what marks a YAML file as\nan Ellipsis agent config (vs arbitrary YAML that merely lives under a\nconfig directory) \u2014 see `yaml_is_ellipsis_config`.\n\n`enabled` is agent behavior, not freeform metadata, so it stays inside\nthe config `sha` (only `metadata` is sha-excluded). Whether a session\naccepts messages is a per-run choice (POST /v1/sessions `interactive`),\nnot a config one.",
         "properties": {
           "description": {
             "anyOf": [
@@ -432,11 +425,6 @@
             "title": "Enabled",
             "type": "boolean"
           },
-          "interactive": {
-            "default": true,
-            "title": "Interactive",
-            "type": "boolean"
-          },
           "metadata": {
             "$ref": "#/components/schemas/AgentConfigMetadata",
             "default": {
@@ -511,6 +499,27 @@
             "$ref": "#/components/schemas/AgentConfigEnvironmentImage",
             "default": {}
           },
+          "mcp_servers": {
+            "default": [],
+            "items": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "$ref": "#/components/schemas/AgentConfigMcpServer"
+                },
+                {
+                  "$ref": "#/components/schemas/AgentConfigMcpStdioServer"
+                },
+                {
+                  "$ref": "#/components/schemas/AgentConfigMcpRemoteServer"
+                }
+              ]
+            },
+            "title": "Mcp Servers",
+            "type": "array"
+          },
           "repositories": {
             "default": [],
             "items": {
@@ -688,9 +697,37 @@
         "title": "AgentConfigInput",
         "type": "object"
       },
+      "AgentConfigMcpRemoteServer": {
+        "additionalProperties": false,
+        "description": "A bring-your-own remote MCP server: the harness talks HTTP to `url`.\nNothing runs in the sandbox image. `headers` carry static auth (e.g.\n`Authorization: Bearer ${TOKEN}`); values may embed `${NAME}` secret\nreferences, resolved at run time from the account's secrets store.",
+        "properties": {
+          "headers": {
+            "additionalProperties": {
+              "type": "string"
+            },
+            "default": {},
+            "title": "Headers",
+            "type": "object"
+          },
+          "name": {
+            "title": "Name",
+            "type": "string"
+          },
+          "url": {
+            "title": "Url",
+            "type": "string"
+          }
+        },
+        "required": [
+          "name",
+          "url"
+        ],
+        "title": "AgentConfigMcpRemoteServer",
+        "type": "object"
+      },
       "AgentConfigMcpServer": {
         "additionalProperties": false,
-        "description": "One built-in MCP server this agent opts into by name (`linear`/`slack`).\nThis is a name reference over the connected built-in set, NOT a custom-server\ndefinition \u2014 there is no command/url/headers shape (that was the old,\nremoved field, and Ellipsis does not support bring-your-own MCP servers).\nIt only matters when the named integration is set to `opt_in` inclusion; an\nintegration in the default `all_sessions` mode is added regardless.",
+        "description": "One built-in MCP server this agent opts into by name (`linear`/`slack`).\nA name reference over the connected built-in set \u2014 the platform manages the\nserver's transport and credentials. It only matters when the named\nintegration is set to `opt_in` inclusion; an integration in the default\n`all_sessions` mode is added regardless. For a server the platform does not\nprovide, define it instead (`AgentConfigMcpStdioServer` /\n`AgentConfigMcpRemoteServer`).",
         "properties": {
           "name": {
             "title": "Name",
@@ -703,6 +740,42 @@
         "title": "AgentConfigMcpServer",
         "type": "object"
       },
+      "AgentConfigMcpStdioServer": {
+        "additionalProperties": false,
+        "description": "A bring-your-own stdio MCP server: the harness spawns `command` inside\nthe sandbox and speaks JSON-RPC over its stdin/stdout. The command must be\nrunnable in the sandbox image \u2014 install its runtime via `image.setup` /\n`image.dockerfile_append` if the base image lacks it.\n\n`env` values may embed `${NAME}` references, resolved at run time from the\naccount's secrets store (see `mcp_secret_refs`); everything else is passed\nliterally.",
+        "properties": {
+          "args": {
+            "default": [],
+            "items": {
+              "type": "string"
+            },
+            "title": "Args",
+            "type": "array"
+          },
+          "command": {
+            "title": "Command",
+            "type": "string"
+          },
+          "env": {
+            "additionalProperties": {
+              "type": "string"
+            },
+            "default": {},
+            "title": "Env",
+            "type": "object"
+          },
+          "name": {
+            "title": "Name",
+            "type": "string"
+          }
+        },
+        "required": [
+          "name",
+          "command"
+        ],
+        "title": "AgentConfigMcpStdioServer",
+        "type": "object"
+      },
       "AgentConfigMemorySize": {
         "additionalProperties": false,
         "description": "A memory size as explicit units, summed (binary: 1GB = 1024MB = 1024MiB).\nSet any of `gb`/`mb` (at least one). The alternative to the `8GB`-style\nshorthand string.",
@@ -3032,95 +3105,31 @@
         "type": "object"
       },
       "CreateAgentConfigRequest": {
-        "description": "Parameters for creating an agent config. Exactly one of config or\ntemplate_id must be set.",
+        "description": "Parameters for creating an agent config.",
         "properties": {
           "config": {
-            "anyOf": [
-              {
-                "$ref": "#/components/schemas/AgentConfig"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "An inline agent config."
-          },
-          "path": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "File path within the repo, when a repository is named. Omit for the default agents/<slug>.yaml; if set it must be a location the config sync scans (a .yaml/.yml file under agents/, .agents/, ellipsis/, or .ellipsis/ at any depth).",
-            "title": "Path"
-          },
-          "repository": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "Define the agent as a file in this repository: Ellipsis opens a pull request adding it, and the agent goes live when that merges. Repository name within the caller's account; the owner is always the account, so pass a bare name (e.g. \"my-service\"), not \"owner/my-service\". Omit to create the agent through the API alone, with no file and live immediately.",
-            "title": "Repository"
-          },
-          "template_id": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "A gallery template slug (see GET /v1/agents/templates).",
-            "title": "Template Id"
+            "$ref": "#/components/schemas/AgentConfig",
+            "description": "The agent's definition."
           }
         },
+        "required": [
+          "config"
+        ],
         "title": "CreateAgentConfigRequest",
         "type": "object"
       },
-      "CreateAgentConfigResponse": {
-        "description": "The created agent config, plus the pull request that adds its file when\none was opened.",
+      "CreateEnvironmentRequest": {
+        "description": "Parameters for creating an environment.",
         "properties": {
-          "config": {
-            "$ref": "#/components/schemas/Config",
-            "description": "The created agent config."
-          },
-          "path": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "The file path the config was written to, or null when the agent has no file.",
-            "title": "Path"
-          },
-          "pull_request_url": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "The pull request that adds the config file. The agent becomes live once it merges and syncs. Null when no repository was named: the agent is already live.",
-            "title": "Pull Request Url"
+          "environment": {
+            "$ref": "#/components/schemas/EnvironmentConfig",
+            "description": "The environment's definition."
           }
         },
         "required": [
-          "config"
+          "environment"
         ],
-        "title": "CreateAgentConfigResponse",
+        "title": "CreateEnvironmentRequest",
         "type": "object"
       },
       "CreateFileRequest": {
@@ -3358,86 +3367,36 @@
         "title": "EllipsisGrant",
         "type": "object"
       },
-      "ErrorInfo": {
+      "Environment": {
+        "description": "A saved environment: the machine agents run in (repositories,\nvariables, MCP servers, image, compute, hooks), defined once and\nreferenced by name or id from agent configs and session starts.",
         "properties": {
-          "code": {
-            "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_limit_exceeded, 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"
-          },
-          "message": {
-            "description": "Human-readable explanation. Wording may change at any time; switch on `code`, never on this text.",
-            "title": "Message",
+          "created_at": {
+            "description": "When the environment was created.",
+            "format": "date-time",
+            "title": "Created At",
             "type": "string"
           },
-          "request_id": {
+          "edited_by": {
             "anyOf": [
               {
-                "type": "string"
+                "$ref": "#/components/schemas/GithubAccountSnippet"
               },
               {
                 "type": "null"
               }
             ],
-            "description": "Present on internal server errors: quote it when contacting support to identify the exact failure.",
-            "title": "Request Id"
-          }
-        },
-        "required": [
-          "code",
-          "message"
-        ],
-        "title": "ErrorInfo",
-        "type": "object"
-      },
-      "ErrorResponse": {
-        "description": "The error envelope every /v1 error returns.",
-        "properties": {
-          "error": {
-            "$ref": "#/components/schemas/ErrorInfo"
-          }
-        },
-        "required": [
-          "error"
-        ],
-        "title": "ErrorResponse",
-        "type": "object"
-      },
-      "ExecutionStatus": {
-        "description": "Per-execution status ladder (was AgentProcessStatus). Distinct from the\nsession's durable `session_state` and from `agent_sessions.status`, which\nremains the atomic claim/dispatch guard.",
-        "enum": [
-          "running",
-          "failed",
-          "done"
-        ],
-        "title": "ExecutionStatus",
-        "type": "string"
-      },
-      "File": {
-        "description": "A file's metadata \u2014 the file itself is fetched via a separate\ndownload URL.",
-        "properties": {
-          "content_type": {
-            "description": "The file's MIME type.",
-            "title": "Content Type",
-            "type": "string"
+            "description": "The GitHub account that last edited the environment, when known."
           },
-          "created_at": {
-            "description": "When the file was uploaded.",
-            "format": "date-time",
-            "title": "Created At",
-            "type": "string"
-          },
-          "filename": {
-            "description": "The original file basename, for display.",
-            "title": "Filename",
-            "type": "string"
+          "environment": {
+            "$ref": "#/components/schemas/EnvironmentConfig",
+            "description": "The environment definition itself, as parsed from its YAML."
           },
           "id": {
-            "description": "The file's unique identifier.",
+            "description": "Unique identifier of the environment.",
             "title": "Id",
             "type": "string"
           },
-          "session_id": {
+          "last_sync_error": {
             "anyOf": [
               {
                 "type": "string"
@@ -3446,24 +3405,351 @@
                 "type": "null"
               }
             ],
-            "description": "The agent session that produced this file, when it was uploaded from a sandbox. Null for uploads made outside an agent session.",
-            "title": "Session Id"
+            "description": "The parse or validation error from the most recent sync attempt, or null when it succeeded. A non-null value means sessions run the last good definition, not the YAML currently on the branch.",
+            "title": "Last Sync Error"
           },
-          "size_bytes": {
-            "description": "The size of the stored file in bytes.",
-            "title": "Size Bytes",
-            "type": "integer"
-          }
-        },
-        "required": [
-          "id",
-          "filename",
-          "content_type",
-          "size_bytes",
-          "created_at"
-        ],
-        "title": "File",
-        "type": "object"
+          "last_synced_commit_sha": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The last commit the environment was synced from.",
+            "title": "Last Synced Commit Sha"
+          },
+          "managed_by": {
+            "$ref": "#/components/schemas/ConfigManagedBy",
+            "description": "\"github\" environments are defined by a file in a repository and are changed by editing that file; \"api\" environments have no file and are changed through this API."
+          },
+          "name": {
+            "description": "The environment's customer-unique addressable name; usable anywhere an environment is referenced, interchangeably with the id.",
+            "title": "Name",
+            "type": "string"
+          },
+          "sha": {
+            "description": "The environment's content identity fingerprint.",
+            "title": "Sha",
+            "type": "string"
+          },
+          "source_details": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/AgentConfigSourceGithub"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The repository, path, and branch the environment syncs from. Null for environments managed through the API."
+          },
+          "updated_at": {
+            "description": "When the environment was last updated.",
+            "format": "date-time",
+            "title": "Updated At",
+            "type": "string"
+          }
+        },
+        "required": [
+          "id",
+          "name",
+          "sha",
+          "created_at",
+          "updated_at",
+          "managed_by",
+          "environment"
+        ],
+        "title": "Environment",
+        "type": "object"
+      },
+      "EnvironmentConfig": {
+        "additionalProperties": false,
+        "description": "A parsed environment document: identity plus the environment body.\n\nThe body fields are flattened to the top level of the file (not nested\nunder an `environment:` key) \u2014 the file *is* the environment, so nesting\nwould be ceremony. `to_environment()` projects the body for substitution\ninto an agent config.",
+        "properties": {
+          "compute": {
+            "$ref": "#/components/schemas/AgentConfigCompute",
+            "default": {}
+          },
+          "ellipsis": {
+            "$ref": "#/components/schemas/EnvironmentConfigEllipsis"
+          },
+          "hooks": {
+            "$ref": "#/components/schemas/AgentConfigEnvironmentHooks",
+            "default": {}
+          },
+          "image": {
+            "$ref": "#/components/schemas/AgentConfigEnvironmentImage",
+            "default": {}
+          },
+          "mcp_servers": {
+            "default": [],
+            "items": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "$ref": "#/components/schemas/AgentConfigMcpServer"
+                },
+                {
+                  "$ref": "#/components/schemas/AgentConfigMcpStdioServer"
+                },
+                {
+                  "$ref": "#/components/schemas/AgentConfigMcpRemoteServer"
+                }
+              ]
+            },
+            "title": "Mcp Servers",
+            "type": "array"
+          },
+          "repositories": {
+            "default": [],
+            "items": {
+              "$ref": "#/components/schemas/AgentConfigRepository"
+            },
+            "title": "Repositories",
+            "type": "array"
+          },
+          "variables": {
+            "default": [],
+            "items": {
+              "$ref": "#/components/schemas/AgentConfigEnvironmentVariable"
+            },
+            "title": "Variables",
+            "type": "array"
+          }
+        },
+        "required": [
+          "ellipsis"
+        ],
+        "title": "EnvironmentConfig",
+        "type": "object"
+      },
+      "EnvironmentConfigEllipsis": {
+        "additionalProperties": false,
+        "description": "The Ellipsis namespace of an environment file. `kind: environment` is\nwhat routes a synced YAML here instead of to the agent-config parser \u2014\nan agent config carries no `kind` (or `kind: agent`, tolerated nowhere:\nabsence is the agent marker).",
+        "properties": {
+          "description": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Description"
+          },
+          "kind": {
+            "const": "environment",
+            "title": "Kind",
+            "type": "string"
+          },
+          "metadata": {
+            "$ref": "#/components/schemas/AgentConfigMetadata",
+            "default": {
+              "annotations": {},
+              "labels": []
+            }
+          },
+          "name": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Name"
+          }
+        },
+        "required": [
+          "kind"
+        ],
+        "title": "EnvironmentConfigEllipsis",
+        "type": "object"
+      },
+      "EnvironmentDefaults": {
+        "description": "Which environment serves sessions whose config carries no environment\nof its own: one account-wide rung, plus a rung per repository. Values are\nenvironment ids \u2014 stable across renames, unlike names.",
+        "properties": {
+          "account": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Environment id serving sessions with no repository context, or null when no account default is set.",
+            "title": "Account"
+          },
+          "repositories": {
+            "additionalProperties": {
+              "type": "string"
+            },
+            "default": {},
+            "description": "Environment id per repository, keyed \"owner/name\". A repository with no default set is absent.",
+            "title": "Repositories",
+            "type": "object"
+          }
+        },
+        "title": "EnvironmentDefaults",
+        "type": "object"
+      },
+      "EnvironmentResponse": {
+        "description": "One saved environment.",
+        "properties": {
+          "environment": {
+            "$ref": "#/components/schemas/Environment",
+            "description": "The saved environment."
+          }
+        },
+        "required": [
+          "environment"
+        ],
+        "title": "EnvironmentResponse",
+        "type": "object"
+      },
+      "EnvironmentSource": {
+        "description": "How a session's environment was chosen. None (the field is nullable)\nwhen the config carried an inline environment block and no resolution ran \u2014\nan inline environment is not a reference, so there is nothing to record.\n\nNot derivable from the row: `environment_id` says WHICH environment, not\nhow it was chosen, and is null for the built-in basic sandbox.",
+        "enum": [
+          "request",
+          "agent_config",
+          "repo_default",
+          "account_default",
+          "platform_default"
+        ],
+        "title": "EnvironmentSource",
+        "type": "string"
+      },
+      "EnvironmentsListResponse": {
+        "description": "The caller's saved environments.",
+        "properties": {
+          "environments": {
+            "description": "Saved environments.",
+            "items": {
+              "$ref": "#/components/schemas/Environment"
+            },
+            "title": "Environments",
+            "type": "array"
+          }
+        },
+        "required": [
+          "environments"
+        ],
+        "title": "EnvironmentsListResponse",
+        "type": "object"
+      },
+      "ErrorInfo": {
+        "properties": {
+          "code": {
+            "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_limit_exceeded, 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"
+          },
+          "message": {
+            "description": "Human-readable explanation. Wording may change at any time; switch on `code`, never on this text.",
+            "title": "Message",
+            "type": "string"
+          },
+          "request_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Present on internal server errors: quote it when contacting support to identify the exact failure.",
+            "title": "Request Id"
+          }
+        },
+        "required": [
+          "code",
+          "message"
+        ],
+        "title": "ErrorInfo",
+        "type": "object"
+      },
+      "ErrorResponse": {
+        "description": "The error envelope every /v1 error returns.",
+        "properties": {
+          "error": {
+            "$ref": "#/components/schemas/ErrorInfo"
+          }
+        },
+        "required": [
+          "error"
+        ],
+        "title": "ErrorResponse",
+        "type": "object"
+      },
+      "ExecutionStatus": {
+        "description": "Per-execution status ladder (was AgentProcessStatus). Distinct from the\nsession's durable `session_state` and from `agent_sessions.status`, which\nremains the atomic claim/dispatch guard.",
+        "enum": [
+          "running",
+          "failed",
+          "done"
+        ],
+        "title": "ExecutionStatus",
+        "type": "string"
+      },
+      "File": {
+        "description": "A file's metadata \u2014 the file itself is fetched via a separate\ndownload URL.",
+        "properties": {
+          "content_type": {
+            "description": "The file's MIME type.",
+            "title": "Content Type",
+            "type": "string"
+          },
+          "created_at": {
+            "description": "When the file was uploaded.",
+            "format": "date-time",
+            "title": "Created At",
+            "type": "string"
+          },
+          "filename": {
+            "description": "The original file basename, for display.",
+            "title": "Filename",
+            "type": "string"
+          },
+          "id": {
+            "description": "The file's unique identifier.",
+            "title": "Id",
+            "type": "string"
+          },
+          "session_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The agent session that produced this file, when it was uploaded from a sandbox. Null for uploads made outside an agent session.",
+            "title": "Session Id"
+          },
+          "size_bytes": {
+            "description": "The size of the stored file in bytes.",
+            "title": "Size Bytes",
+            "type": "integer"
+          }
+        },
+        "required": [
+          "id",
+          "filename",
+          "content_type",
+          "size_bytes",
+          "created_at"
+        ],
+        "title": "File",
+        "type": "object"
       },
       "FilesListResponse": {
         "description": "A page of the calling account's files, newest first. Metadata only \u2014\nfetch an individual file to get a download URL.",
@@ -5657,6 +5943,33 @@
         "title": "PutAgentDefaultRequest",
         "type": "object"
       },
+      "PutEnvironmentDefaultRequest": {
+        "description": "Parameters for setting a default environment, at either the account or\nthe repository level.",
+        "properties": {
+          "environment": {
+            "description": "The environment to make the default: an environment id, or its customer-unique name.",
+            "title": "Environment",
+            "type": "string"
+          },
+          "repository": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "The rung to set: \"owner/name\" for a repo default; omit to set the account default. An unknown or foreign repo is a 404.",
+            "title": "Repository"
+          }
+        },
+        "required": [
+          "environment"
+        ],
+        "title": "PutEnvironmentDefaultRequest",
+        "type": "object"
+      },
       "PutSecretsRequest": {
         "description": "Store secrets for the account's sandboxes. Each secret is upserted by\nname: existing names are overwritten.",
         "properties": {
@@ -6145,7 +6458,7 @@
             "description": "A saved config to replay against. By default the original run's frozen config snapshot is reused.",
             "title": "Config Id"
           },
-          "config_override": {
+          "override": {
             "anyOf": [
               {
                 "additionalProperties": true,
@@ -6155,20 +6468,8 @@
                 "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 {\"budget\": {\"session\": 5.0}} to raise its budget. Mutually exclusive with config_override_yaml.",
-            "title": "Config Override"
-          },
-          "config_override_yaml": {
-            "anyOf": [
-              {
-                "type": "string"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "description": "The same partial-config override as a YAML/JSON string (e.g. read from a file). Mutually exclusive with config_override.",
-            "title": "Config Override Yaml"
+            "description": "Optional partial patch on the replayed config, applied last \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.",
+            "title": "Override"
           },
           "prompt": {
             "anyOf": [
@@ -6295,6 +6596,7 @@
           "reviews",
           "configs",
           "defaults",
+          "environments",
           "secrets",
           "templates",
           "integrations",
@@ -8507,6 +8809,10 @@
             "title": "Created At",
             "type": "string"
           },
+          "environment": {
+            "$ref": "#/components/schemas/SessionEnvironment",
+            "description": "The environment the session resolved: the saved environment's id and how it was chosen. The environment's frozen body is inside agent.config.environment."
+          },
           "exit_status": {
             "anyOf": [
               {
@@ -8814,6 +9120,36 @@
         "title": "SessionCost",
         "type": "object"
       },
+      "SessionEnvironment": {
+        "description": "The environment this session resolved: which saved environment (as it\nexists now) and how it was chosen. The environment's frozen BODY rides\ninside `agent.config.environment` \u2014 substitution happens before the config\nsnapshot freezes \u2014 so this object is provenance, not payload.",
+        "properties": {
+          "environment_id": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "Identifier of the saved environment the session's config resolved. Null for an inline environment block or the built-in basic sandbox.",
+            "title": "Environment Id"
+          },
+          "source": {
+            "anyOf": [
+              {
+                "$ref": "#/components/schemas/EnvironmentSource"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "description": "How the environment was chosen (request, agent_config, repo_default, account_default, platform_default). Null when the config carried its own inline environment."
+          }
+        },
+        "title": "SessionEnvironment",
+        "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": {
@@ -10018,7 +10354,7 @@
                 "type": "null"
               }
             ],
-            "description": "An inline agent config to run under."
+            "description": "An inline agent config to run under. At most one of config_id or config may be set; if neither is, the run resolves the account's default-config ladder (repo default, then account default, then the platform default config)."
           },
           "config_id": {
             "anyOf": [
@@ -10032,20 +10368,7 @@
             "description": "A saved agent config to run under: its id, or the agent's customer-unique `ellipsis.name`.",
             "title": "Config Id"
           },
-          "config_override": {
-            "anyOf": [
-              {
-                "additionalProperties": true,
-                "type": "object"
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "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": {
+          "environment": {
             "anyOf": [
               {
                 "type": "string"
@@ -10054,8 +10377,8 @@
                 "type": "null"
               }
             ],
-            "description": "The same partial-config override as a YAML/JSON string (e.g. read from a file). Mutually exclusive with config_override.",
-            "title": "Config Override Yaml"
+            "description": "The environment to run in: a saved environment's id (`env_...`) or its customer-unique name. Only for sessions with no explicit config (the agent config decides its own environment; 400 when combined with config/config_id). Omitted, the default-environment ladder resolves: repo default, then account default, then the built-in basic sandbox.",
+            "title": "Environment"
           },
           "force_rebuild": {
             "default": false,
@@ -10063,12 +10386,6 @@
             "title": "Force Rebuild",
             "type": "boolean"
           },
-          "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. 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"
-          },
           "input": {
             "anyOf": [
               {
@@ -10082,6 +10399,12 @@
             "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"
           },
+          "interactive": {
+            "default": true,
+            "description": "Whether the session stays open for messages after its first turn. Set false for a one-shot run that does its job and closes without holding a warm sandbox; a one-shot run must carry a prompt (or input), since nothing can ever be sent to it later. Agents on the Codex harness are one-shot regardless.",
+            "title": "Interactive",
+            "type": "boolean"
+          },
           "metadata": {
             "additionalProperties": {
               "type": "string"
@@ -10091,19 +10414,20 @@
             "title": "Metadata",
             "type": "object"
           },
-          "prompt": {
+          "override": {
             "anyOf": [
               {
-                "type": "string"
+                "additionalProperties": true,
+                "type": "object"
               },
               {
                 "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.",
-            "title": "Prompt"
+            "description": "Optional partial patch on the RESOLVED session config, applied last \u2014 after the config and environment are chosen and the environment is substituted in. Nested objects merge key by key; scalars and arrays replace. E.g. {\"environment\": {\"compute\": {\"memory\": \"16GB\"}}} for just this session, or {\"claude\": {\"model\": \"claude-opus-4-8\"}}. It cannot swap in a different saved environment (it patches the resolved document; it never re-runs resolution).",
+            "title": "Override"
           },
-          "repository": {
+          "prompt": {
             "anyOf": [
               {
                 "type": "string"
@@ -10112,10 +10436,10 @@
                 "type": "null"
               }
             ],
-            "description": "The \"owner/name\" repository the client is standing in (the CLI's detected git remote). Selects the repo rung of the defaults ladder, and is merged into the sandbox repository set (cloned at its default branch) regardless of which config source is used. An unknown or foreign repo is ignored.",
-            "title": "Repository"
+            "description": "The session's first message. Omit it and the session starts idle: the sandbox spins up, the agent waits at the prompt, and the first message you send opens turn 0.",
+            "title": "Prompt"
           },
-          "template_id": {
+          "repository": {
             "anyOf": [
               {
                 "type": "string"
@@ -10124,8 +10448,8 @@
                 "type": "null"
               }
             ],
-            "description": "A maintained run-on-demand template slug (e.g. \"ellipsis-helper\"), resolved server-side to its config. At most one of config_id, config, or template_id may be set; if none is, the run resolves the account's default-config ladder (repo default, then account default, then the platform default config).",
-            "title": "Template Id"
+            "description": "The \"owner/name\" repository the client is standing in (the CLI's detected git remote). Selects the repo rung of the defaults ladder, and is merged into the sandbox repository set (cloned at its default branch) regardless of which config source is used. An unknown or foreign repo is ignored.",
+            "title": "Repository"
           }
         },
         "title": "StartAgentSessionRequest",
@@ -10256,6 +10580,20 @@
         "title": "UpdateAgentConfigRequest",
         "type": "object"
       },
+      "UpdateEnvironmentRequest": {
+        "description": "A replacement definition for an environment managed through the API.",
+        "properties": {
+          "environment": {
+            "$ref": "#/components/schemas/EnvironmentConfig",
+            "description": "The environment's new definition. Replaces the previous one wholesale \u2014 this is not a partial update."
+          }
+        },
+        "required": [
+          "environment"
+        ],
+        "title": "UpdateEnvironmentRequest",
+        "type": "object"
+      },
       "UsageDailyPoint": {
         "description": "One day's usage: tokens split by type, and cost split into the four\nbilled categories. `tokens` is the sum of the four token types.",
         "properties": {
@@ -10556,7 +10894,7 @@
         "x-ellipsis-sdk-method": "agents.configs.list"
       },
       "post": {
-        "description": "Create an agent config.\n\nName a repository and Ellipsis opens a pull request adding the\nconfig file to agents/ there; the agent goes live when it\nmerges. Omit it and the agent is created here, with no file,\nlive immediately \u2014 and every file reference in it must name the\nrepository it lives in.\n\nAccepts an inline config or a gallery template slug. 409 when\nanother live agent already holds the name.",
+        "description": "Create an agent config, managed through the API: no file, live\nimmediately. To put its definition in a repository instead, create\nit here and then POST /v1/agents/configs/{config_id}/link.\n\n409 when another live agent already holds the name.",
         "operationId": "create_agent_config",
         "parameters": [
           {
@@ -10587,11 +10925,11 @@
           "required": true
         },
         "responses": {
-          "200": {
+          "201": {
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/CreateAgentConfigResponse"
+                  "$ref": "#/components/schemas/AgentConfigResponse"
                 }
               }
             },
@@ -10605,7 +10943,7 @@
                 }
               }
             },
-            "description": "Provide exactly one of config or template_id; or the config, path, or target branch is invalid."
+            "description": "The config is invalid."
           },
           "401": {
             "content": {
@@ -10615,19 +10953,9 @@
                 }
               }
             },
-            "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."
+            "description": "The bearer token is missing, invalid, or revoked."
           },
-          "404": {
+          "403": {
             "content": {
               "application/json": {
                 "schema": {
@@ -10635,7 +10963,7 @@
                 }
               }
             },
-            "description": "The template or repository was not found in your account."
+            "description": "The credential may not perform this action, or the account is blocked."
           },
           "409": {
             "content": {
@@ -10645,7 +10973,7 @@
                 }
               }
             },
-            "description": "An agent with that name already exists, another agent is already synced from that path, or a file already exists there."
+            "description": "An agent with that name already exists."
           },
           "422": {
             "content": {
@@ -11311,9 +11639,275 @@
         "x-ellipsis-sdk-method": "agents.defaults.delete"
       },
       "get": {
-        "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",
+        "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": [
+          {
+            "in": "header",
+            "name": "user-agent",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "User-Agent"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AgentDefaults"
+                }
+              }
+            },
+            "description": "Successful Response"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The bearer token is missing, invalid, or revoked."
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The credential may not perform this action, or the account is blocked."
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            },
+            "description": "Validation Error"
+          }
+        },
+        "security": [
+          {
+            "HTTPBearer": []
+          }
+        ],
+        "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\"); 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": [
+          {
+            "in": "header",
+            "name": "user-agent",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "User-Agent"
+            }
+          }
+        ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/PutAgentDefaultRequest"
+              }
+            }
+          },
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AgentDefaults"
+                }
+              }
+            },
+            "description": "Successful Response"
+          },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The config is not eligible as a default: its pull request has not merged, or it is disabled."
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The bearer token is missing, invalid, or revoked."
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The credential may not perform this action, or the account is blocked."
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The config or repository was not found in your account."
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            },
+            "description": "Validation Error"
+          }
+        },
+        "security": [
+          {
+            "HTTPBearer": []
+          }
+        ],
+        "summary": "Put Agent Default",
+        "tags": [
+          "v1"
+        ],
+        "x-ellipsis-sdk-method": "agents.defaults.set"
+      }
+    },
+    "/v1/agents/templates": {
+      "get": {
+        "description": "List the built-in starter agent templates.\n\nBehind auth but not account-scoped \u2014 the data is static\nproduct content shared by the dashboard, landing site, and CLI.",
+        "operationId": "list_agent_templates",
+        "parameters": [
+          {
+            "in": "header",
+            "name": "user-agent",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "User-Agent"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/AgentTemplatesListResponse"
+                }
+              }
+            },
+            "description": "Successful Response"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The bearer token is missing, invalid, or revoked."
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The credential may not perform this action, or the account is blocked."
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            },
+            "description": "Validation Error"
+          }
+        },
+        "security": [
+          {
+            "HTTPBearer": []
+          }
+        ],
+        "summary": "List Agent Templates",
+        "tags": [
+          "v1"
+        ],
+        "x-ellipsis-sdk-method": "agents.templates.list",
+        "x-ellipsis-undocumented": true
+      }
+    },
+    "/v1/agents/templates/{template_id}": {
+      "get": {
+        "description": "Return one built-in agent template by slug.",
+        "operationId": "get_agent_template",
         "parameters": [
+          {
+            "in": "path",
+            "name": "template_id",
+            "required": true,
+            "schema": {
+              "title": "Template Id",
+              "type": "string"
+            }
+          },
           {
             "in": "header",
             "name": "user-agent",
@@ -11336,7 +11930,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/AgentDefaults"
+                  "$ref": "#/components/schemas/AgentTemplate"
                 }
               }
             },
@@ -11362,6 +11956,16 @@
             },
             "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 template."
+          },
           "422": {
             "content": {
               "application/json": {
@@ -11378,16 +11982,79 @@
             "HTTPBearer": []
           }
         ],
-        "summary": "List Agent Defaults",
+        "summary": "Get Agent Template",
         "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\"); 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",
+        "x-ellipsis-sdk-method": "agents.templates.get",
+        "x-ellipsis-undocumented": true
+      }
+    },
+    "/v1/alerts": {
+      "get": {
+        "description": "List budget alerts for the organization, newest first.\n\nOptionally filtered by status and source.\n\nAvailable to all credential types, so an agent can check \"is\nthis org near budget?\" mid-task.",
+        "operationId": "list_alerts",
         "parameters": [
+          {
+            "in": "query",
+            "name": "status",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "$ref": "#/components/schemas/AlertStatus"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Status"
+            }
+          },
+          {
+            "in": "query",
+            "name": "source",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "$ref": "#/components/schemas/AlertSource"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Source"
+            }
+          },
+          {
+            "in": "query",
+            "name": "limit",
+            "required": false,
+            "schema": {
+              "default": 100,
+              "maximum": 200,
+              "minimum": 1,
+              "title": "Limit",
+              "type": "integer"
+            }
+          },
+          {
+            "in": "query",
+            "name": "cursor",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Cursor"
+            }
+          },
           {
             "in": "header",
             "name": "user-agent",
@@ -11405,37 +12072,17 @@
             }
           }
         ],
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/PutAgentDefaultRequest"
-              }
-            }
-          },
-          "required": true
-        },
         "responses": {
           "200": {
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/AgentDefaults"
+                  "$ref": "#/components/schemas/AlertsListResponse"
                 }
               }
             },
             "description": "Successful Response"
           },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "The config is not eligible as a default: its pull request has not merged, or it is disabled."
-          },
           "401": {
             "content": {
               "application/json": {
@@ -11456,16 +12103,6 @@
             },
             "description": "The credential may not perform this action, or the account is blocked."
           },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "The config or repository was not found in your account."
-          },
           "422": {
             "content": {
               "application/json": {
@@ -11482,18 +12119,28 @@
             "HTTPBearer": []
           }
         ],
-        "summary": "Put Agent Default",
+        "summary": "List Alerts",
         "tags": [
           "v1"
         ],
-        "x-ellipsis-sdk-method": "agents.defaults.set"
+        "x-ellipsis-sdk-method": "alerts.list",
+        "x-ellipsis-undocumented": true
       }
     },
-    "/v1/agents/templates": {
+    "/v1/alerts/{alert_id}": {
       "get": {
-        "description": "List the built-in starter agent templates.\n\nBehind auth but not account-scoped \u2014 the data is static\nproduct content shared by the dashboard, landing site, and CLI.",
-        "operationId": "list_agent_templates",
+        "description": "Return one alert by id.\n\n404 if it doesn't exist or belongs to another organization.",
+        "operationId": "get_alert",
         "parameters": [
+          {
+            "in": "path",
+            "name": "alert_id",
+            "required": true,
+            "schema": {
+              "title": "Alert Id",
+              "type": "string"
+            }
+          },
           {
             "in": "header",
             "name": "user-agent",
@@ -11516,7 +12163,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/AgentTemplatesListResponse"
+                  "$ref": "#/components/schemas/AlertResponse"
                 }
               }
             },
@@ -11542,6 +12189,16 @@
             },
             "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 alert in your account."
+          },
           "422": {
             "content": {
               "application/json": {
@@ -11558,24 +12215,25 @@
             "HTTPBearer": []
           }
         ],
-        "summary": "List Agent Templates",
+        "summary": "Get Alert",
         "tags": [
           "v1"
         ],
-        "x-ellipsis-sdk-method": "agents.templates.list"
+        "x-ellipsis-sdk-method": "alerts.get",
+        "x-ellipsis-undocumented": true
       }
     },
-    "/v1/agents/templates/{template_id}": {
-      "get": {
-        "description": "Return one built-in agent template by slug.",
-        "operationId": "get_agent_template",
+    "/v1/alerts/{alert_id}/dismiss": {
+      "post": {
+        "description": "Dismiss an open alert and return it.\n\n409 when the alert is not open; 404 when it doesn't exist.",
+        "operationId": "dismiss_alert",
         "parameters": [
           {
             "in": "path",
-            "name": "template_id",
+            "name": "alert_id",
             "required": true,
             "schema": {
-              "title": "Template Id",
+              "title": "Alert Id",
               "type": "string"
             }
           },
@@ -11601,7 +12259,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/AgentTemplate"
+                  "$ref": "#/components/schemas/AlertResponse"
                 }
               }
             },
@@ -11635,7 +12293,17 @@
                 }
               }
             },
-            "description": "No such template."
+            "description": "No such alert in your account."
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The alert is not open."
           },
           "422": {
             "content": {
@@ -11653,76 +12321,140 @@
             "HTTPBearer": []
           }
         ],
-        "summary": "Get Agent Template",
+        "summary": "Dismiss Alert",
         "tags": [
           "v1"
         ],
-        "x-ellipsis-sdk-method": "agents.templates.get"
+        "x-ellipsis-sdk-method": "alerts.dismiss",
+        "x-ellipsis-undocumented": true
       }
     },
-    "/v1/alerts": {
+    "/v1/analytics/metrics": {
       "get": {
-        "description": "List budget alerts for the organization, newest first.\n\nOptionally filtered by status and source.\n\nAvailable to all credential types, so an agent can check \"is\nthis org near budget?\" mid-task.",
-        "operationId": "list_alerts",
+        "description": "Return PR and review analytics metrics.\n\nThe same data as the analytics dashboard.\n\nWindowing: pass explicit start/end, or days (default: the last\n30 days). account_type in all|user|bot scopes the authors (bot =\nthe apps/agents). Available to all credential types: the\nresponses expose the organization's own GitHub PR/review activity,\nno secrets.",
+        "operationId": "get_analytics_metrics",
         "parameters": [
           {
             "in": "query",
-            "name": "status",
+            "name": "days",
             "required": false,
             "schema": {
               "anyOf": [
                 {
-                  "$ref": "#/components/schemas/AlertStatus"
+                  "type": "integer"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Days"
+            }
+          },
+          {
+            "in": "query",
+            "name": "start",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Start"
+            }
+          },
+          {
+            "in": "query",
+            "name": "end",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "End"
+            }
+          },
+          {
+            "description": "Filter to repositories by \"owner/name\".",
+            "in": "query",
+            "name": "repo",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
                 },
                 {
                   "type": "null"
                 }
               ],
-              "title": "Status"
+              "description": "Filter to repositories by \"owner/name\".",
+              "title": "Repo"
             }
           },
           {
+            "description": "Filter by PR-author login(s).",
             "in": "query",
-            "name": "source",
+            "name": "author",
             "required": false,
             "schema": {
               "anyOf": [
                 {
-                  "$ref": "#/components/schemas/AlertSource"
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
                 },
                 {
                   "type": "null"
                 }
               ],
-              "title": "Source"
+              "description": "Filter by PR-author login(s).",
+              "title": "Author"
             }
           },
           {
             "in": "query",
-            "name": "limit",
+            "name": "account_type",
             "required": false,
             "schema": {
-              "default": 100,
-              "maximum": 200,
-              "minimum": 1,
-              "title": "Limit",
-              "type": "integer"
+              "default": "all",
+              "title": "Account Type",
+              "type": "string"
             }
           },
           {
+            "description": "Filter by parent-PR status (open|draft|merged|closed).",
             "in": "query",
-            "name": "cursor",
+            "name": "status",
             "required": false,
             "schema": {
               "anyOf": [
                 {
-                  "type": "string"
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
                 },
                 {
                   "type": "null"
                 }
               ],
-              "title": "Cursor"
+              "description": "Filter by parent-PR status (open|draft|merged|closed).",
+              "title": "Status"
             }
           },
           {
@@ -11747,12 +12479,22 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/AlertsListResponse"
+                  "$ref": "#/components/schemas/GetAnalyticsMetricsResponse"
                 }
               }
             },
             "description": "Successful Response"
           },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The time window is invalid: days combined with start, a non-positive days, or end not after start."
+          },
           "401": {
             "content": {
               "application/json": {
@@ -11789,120 +12531,143 @@
             "HTTPBearer": []
           }
         ],
-        "summary": "List Alerts",
+        "summary": "Get Analytics Metrics",
         "tags": [
           "v1"
         ],
-        "x-ellipsis-sdk-method": "alerts.list"
+        "x-ellipsis-sdk-method": "analytics.metrics",
+        "x-ellipsis-undocumented": true
       }
     },
-    "/v1/alerts/{alert_id}": {
+    "/v1/analytics/pull-requests": {
       "get": {
-        "description": "Return one alert by id.\n\n404 if it doesn't exist or belongs to another organization.",
-        "operationId": "get_alert",
+        "description": "Return pull-request analytics.\n\nWindowing: pass explicit start/end, or days (default: the last\n30 days).",
+        "operationId": "get_analytics_pull_requests",
         "parameters": [
           {
-            "in": "path",
-            "name": "alert_id",
-            "required": true,
+            "in": "query",
+            "name": "days",
+            "required": false,
             "schema": {
-              "title": "Alert Id",
-              "type": "string"
+              "anyOf": [
+                {
+                  "type": "integer"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Days"
             }
           },
           {
-            "in": "header",
-            "name": "user-agent",
+            "in": "query",
+            "name": "start",
             "required": false,
             "schema": {
               "anyOf": [
                 {
+                  "format": "date-time",
                   "type": "string"
                 },
                 {
                   "type": "null"
                 }
               ],
-              "title": "User-Agent"
+              "title": "Start"
             }
-          }
-        ],
-        "responses": {
-          "200": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/AlertResponse"
-                }
-              }
-            },
-            "description": "Successful Response"
           },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
+          {
+            "in": "query",
+            "name": "end",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "format": "date-time",
+                  "type": "string"
+                },
+                {
+                  "type": "null"
                 }
-              }
-            },
-            "description": "The bearer token is missing, invalid, or revoked."
+              ],
+              "title": "End"
+            }
           },
-          "403": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
+          {
+            "in": "query",
+            "name": "account_type",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                {
+                  "type": "null"
                 }
-              }
-            },
-            "description": "The credential may not perform this action, or the account is blocked."
+              ],
+              "title": "Account Type"
+            }
           },
-          "404": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
+          {
+            "in": "query",
+            "name": "repository_id",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "items": {
+                    "type": "integer"
+                  },
+                  "type": "array"
+                },
+                {
+                  "type": "null"
                 }
-              }
-            },
-            "description": "No such alert in your account."
+              ],
+              "title": "Repository Id"
+            }
           },
-          "422": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/HTTPValidationError"
-                }
-              }
-            },
-            "description": "Validation Error"
-          }
-        },
-        "security": [
           {
-            "HTTPBearer": []
-          }
-        ],
-        "summary": "Get Alert",
-        "tags": [
-          "v1"
-        ],
-        "x-ellipsis-sdk-method": "alerts.get"
-      }
-    },
-    "/v1/alerts/{alert_id}/dismiss": {
-      "post": {
-        "description": "Dismiss an open alert and return it.\n\n409 when the alert is not open; 404 when it doesn't exist.",
-        "operationId": "dismiss_alert",
-        "parameters": [
+            "in": "query",
+            "name": "author_id",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "items": {
+                    "type": "integer"
+                  },
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Author Id"
+            }
+          },
           {
-            "in": "path",
-            "name": "alert_id",
-            "required": true,
+            "in": "query",
+            "name": "status",
+            "required": false,
             "schema": {
-              "title": "Alert Id",
-              "type": "string"
+              "anyOf": [
+                {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "Status"
             }
           },
           {
@@ -11927,23 +12692,13 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/AlertResponse"
+                  "$ref": "#/components/schemas/GetAnalyticsPullRequestsResponse"
                 }
               }
             },
             "description": "Successful Response"
           },
-          "401": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "The bearer token is missing, invalid, or revoked."
-          },
-          "403": {
+          "400": {
             "content": {
               "application/json": {
                 "schema": {
@@ -11951,9 +12706,9 @@
                 }
               }
             },
-            "description": "The credential may not perform this action, or the account is blocked."
+            "description": "The time window is invalid: days combined with start, a non-positive days, or end not after start."
           },
-          "404": {
+          "401": {
             "content": {
               "application/json": {
                 "schema": {
@@ -11961,9 +12716,9 @@
                 }
               }
             },
-            "description": "No such alert in your account."
+            "description": "The bearer token is missing, invalid, or revoked."
           },
-          "409": {
+          "403": {
             "content": {
               "application/json": {
                 "schema": {
@@ -11971,7 +12726,7 @@
                 }
               }
             },
-            "description": "The alert is not open."
+            "description": "The credential may not perform this action, or the account is blocked."
           },
           "422": {
             "content": {
@@ -11989,17 +12744,18 @@
             "HTTPBearer": []
           }
         ],
-        "summary": "Dismiss Alert",
+        "summary": "Get Analytics Pull Requests",
         "tags": [
           "v1"
         ],
-        "x-ellipsis-sdk-method": "alerts.dismiss"
+        "x-ellipsis-sdk-method": "analytics.pull_requests",
+        "x-ellipsis-undocumented": true
       }
     },
-    "/v1/analytics/metrics": {
+    "/v1/analytics/reviews": {
       "get": {
-        "description": "Return PR and review analytics metrics.\n\nThe same data as the analytics dashboard.\n\nWindowing: pass explicit start/end, or days (default: the last\n30 days). account_type in all|user|bot scopes the authors (bot =\nthe apps/agents). Available to all credential types: the\nresponses expose the organization's own GitHub PR/review activity,\nno secrets.",
-        "operationId": "get_analytics_metrics",
+        "description": "Return code-review analytics.\n\naccount_type scopes reviewers (bot|user|all) \u2014 e.g. \"what apps\nreview the most PRs?\" is the reviewer facets here with\naccount_type=bot. Windowing: pass explicit start/end, or days\n(default: the last 30 days).",
+        "operationId": "get_analytics_reviews",
         "parameters": [
           {
             "in": "query",
@@ -12052,7 +12808,6 @@
             }
           },
           {
-            "description": "Filter to repositories by \"owner/name\".",
             "in": "query",
             "name": "repo",
             "required": false,
@@ -12068,12 +12823,11 @@
                   "type": "null"
                 }
               ],
-              "description": "Filter to repositories by \"owner/name\".",
               "title": "Repo"
             }
           },
           {
-            "description": "Filter by PR-author login(s).",
+            "description": "Filter by reviewer login(s).",
             "in": "query",
             "name": "author",
             "required": false,
@@ -12089,7 +12843,7 @@
                   "type": "null"
                 }
               ],
-              "description": "Filter by PR-author login(s).",
+              "description": "Filter by reviewer login(s).",
               "title": "Author"
             }
           },
@@ -12104,9 +12858,8 @@
             }
           },
           {
-            "description": "Filter by parent-PR status (open|draft|merged|closed).",
             "in": "query",
-            "name": "status",
+            "name": "review_state",
             "required": false,
             "schema": {
               "anyOf": [
@@ -12120,8 +12873,7 @@
                   "type": "null"
                 }
               ],
-              "description": "Filter by parent-PR status (open|draft|merged|closed).",
-              "title": "Status"
+              "title": "Review State"
             }
           },
           {
@@ -12146,7 +12898,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/GetAnalyticsMetricsResponse"
+                  "$ref": "#/components/schemas/GetAnalyticsReviewsResponse"
                 }
               }
             },
@@ -12198,144 +12950,287 @@
             "HTTPBearer": []
           }
         ],
-        "summary": "Get Analytics Metrics",
+        "summary": "Get Analytics Reviews",
         "tags": [
           "v1"
         ],
-        "x-ellipsis-sdk-method": "analytics.metrics"
+        "x-ellipsis-sdk-method": "analytics.reviews",
+        "x-ellipsis-undocumented": true
       }
     },
-    "/v1/analytics/pull-requests": {
-      "get": {
-        "description": "Return pull-request analytics.\n\nWindowing: pass explicit start/end, or days (default: the last\n30 days).",
-        "operationId": "get_analytics_pull_requests",
-        "parameters": [
-          {
-            "in": "query",
-            "name": "days",
-            "required": false,
-            "schema": {
-              "anyOf": [
-                {
-                  "type": "integer"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "title": "Days"
+    "/v1/auth/cli/poll": {
+      "post": {
+        "description": "Poll a device-code auth flow for its token.\n\nUnauthenticated; the device code identifies the flow.",
+        "operationId": "cli_auth_poll",
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CliAuthPollRequest"
+              }
             }
           },
-          {
-            "in": "query",
-            "name": "start",
-            "required": false,
-            "schema": {
-              "anyOf": [
-                {
-                  "format": "date-time",
-                  "type": "string"
-                },
-                {
-                  "type": "null"
+          "required": true
+        },
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/PollCliAuthResponse"
                 }
-              ],
-              "title": "Start"
-            }
+              }
+            },
+            "description": "Successful Response"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The bearer token is missing, invalid, or revoked."
+          },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The credential may not perform this action, or the account is blocked."
+          },
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "Unknown device code."
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            },
+            "description": "Validation Error"
+          }
+        },
+        "summary": "Cli Auth Poll",
+        "tags": [
+          "v1"
+        ],
+        "x-ellipsis-sdk-method": "auth.cli.poll",
+        "x-ellipsis-undocumented": true
+      }
+    },
+    "/v1/auth/cli/start": {
+      "post": {
+        "description": "Start a device-code auth flow for the CLI.\n\nUnauthenticated: the CLI has no credential yet \u2014 that's what\nit's obtaining. The human authorizes out-of-band in the\ndashboard.",
+        "operationId": "cli_auth_start",
+        "responses": {
+          "201": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/StartCliAuthResponse"
+                }
+              }
+            },
+            "description": "Successful Response"
+          },
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The bearer token is missing, invalid, or revoked."
           },
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The credential may not perform this action, or the account is blocked."
+          }
+        },
+        "summary": "Cli Auth Start",
+        "tags": [
+          "v1"
+        ],
+        "x-ellipsis-sdk-method": "auth.cli.start",
+        "x-ellipsis-undocumented": true
+      }
+    },
+    "/v1/budget": {
+      "get": {
+        "description": "Return the caller's current budget summary.",
+        "operationId": "get_budget",
+        "parameters": [
           {
-            "in": "query",
-            "name": "end",
+            "in": "header",
+            "name": "user-agent",
             "required": false,
             "schema": {
               "anyOf": [
                 {
-                  "format": "date-time",
                   "type": "string"
                 },
                 {
                   "type": "null"
                 }
               ],
-              "title": "End"
+              "title": "User-Agent"
             }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/BudgetSummary"
+                }
+              }
+            },
+            "description": "Successful Response"
           },
-          {
-            "in": "query",
-            "name": "account_type",
-            "required": false,
-            "schema": {
-              "anyOf": [
-                {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                {
-                  "type": "null"
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
                 }
-              ],
-              "title": "Account Type"
-            }
+              }
+            },
+            "description": "The bearer token is missing, invalid, or revoked."
           },
-          {
-            "in": "query",
-            "name": "repository_id",
-            "required": false,
-            "schema": {
-              "anyOf": [
-                {
-                  "items": {
-                    "type": "integer"
-                  },
-                  "type": "array"
-                },
-                {
-                  "type": "null"
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
                 }
-              ],
-              "title": "Repository Id"
-            }
+              }
+            },
+            "description": "The credential may not perform this action, or the account is blocked."
           },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            },
+            "description": "Validation Error"
+          }
+        },
+        "security": [
+          {
+            "HTTPBearer": []
+          }
+        ],
+        "summary": "Get Budget",
+        "tags": [
+          "v1"
+        ],
+        "x-ellipsis-sdk-method": "budget"
+      }
+    },
+    "/v1/environments": {
+      "get": {
+        "description": "List saved environments.",
+        "operationId": "list_environments",
+        "parameters": [
           {
-            "in": "query",
-            "name": "author_id",
+            "in": "header",
+            "name": "user-agent",
             "required": false,
             "schema": {
               "anyOf": [
                 {
-                  "items": {
-                    "type": "integer"
-                  },
-                  "type": "array"
+                  "type": "string"
                 },
                 {
                   "type": "null"
                 }
               ],
-              "title": "Author Id"
+              "title": "User-Agent"
             }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/EnvironmentsListResponse"
+                }
+              }
+            },
+            "description": "Successful Response"
           },
-          {
-            "in": "query",
-            "name": "status",
-            "required": false,
-            "schema": {
-              "anyOf": [
-                {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                {
-                  "type": "null"
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
                 }
-              ],
-              "title": "Status"
-            }
+              }
+            },
+            "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."
           },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            },
+            "description": "Validation Error"
+          }
+        },
+        "security": [
+          {
+            "HTTPBearer": []
+          }
+        ],
+        "summary": "List Environments",
+        "tags": [
+          "v1"
+        ],
+        "x-ellipsis-sdk-method": "environments.list"
+      },
+      "post": {
+        "description": "Create an environment, managed through the API: no file, live\nimmediately. To define it in a repository instead, commit a\n`kind: environment` YAML under an agents directory.\n\n409 when another live environment already holds the name.",
+        "operationId": "create_environment",
+        "parameters": [
           {
             "in": "header",
             "name": "user-agent",
@@ -12353,12 +13248,22 @@
             }
           }
         ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/CreateEnvironmentRequest"
+              }
+            }
+          },
+          "required": true
+        },
         "responses": {
-          "200": {
+          "201": {
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/GetAnalyticsPullRequestsResponse"
+                  "$ref": "#/components/schemas/EnvironmentResponse"
                 }
               }
             },
@@ -12372,7 +13277,7 @@
                 }
               }
             },
-            "description": "The time window is invalid: days combined with start, a non-positive days, or end not after start."
+            "description": "The environment is invalid."
           },
           "401": {
             "content": {
@@ -12394,15 +13299,25 @@
             },
             "description": "The credential may not perform this action, or the account is blocked."
           },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "An environment with that name already exists."
+          },
           "422": {
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/HTTPValidationError"
+                  "$ref": "#/components/schemas/ErrorResponse"
                 }
               }
             },
-            "description": "Validation Error"
+            "description": "The environment's name is missing or malformed."
           }
         },
         "security": [
@@ -12410,137 +13325,113 @@
             "HTTPBearer": []
           }
         ],
-        "summary": "Get Analytics Pull Requests",
+        "summary": "Create Environment",
         "tags": [
           "v1"
         ],
-        "x-ellipsis-sdk-method": "analytics.pull_requests"
+        "x-ellipsis-sdk-method": "environments.create"
       }
     },
-    "/v1/analytics/reviews": {
-      "get": {
-        "description": "Return code-review analytics.\n\naccount_type scopes reviewers (bot|user|all) \u2014 e.g. \"what apps\nreview the most PRs?\" is the reviewer facets here with\naccount_type=bot. Windowing: pass explicit start/end, or days\n(default: the last 30 days).",
-        "operationId": "get_analytics_reviews",
+    "/v1/environments/defaults": {
+      "delete": {
+        "description": "Clear a default environment.\n\nAddressed by rung: the account rung (repository omitted) or a\nrepository rung. Refused for sandbox tokens.",
+        "operationId": "delete_environment_default",
         "parameters": [
           {
+            "description": "Repo rung to clear (\"owner/name\"); omit to clear the account default.",
             "in": "query",
-            "name": "days",
-            "required": false,
-            "schema": {
-              "anyOf": [
-                {
-                  "type": "integer"
-                },
-                {
-                  "type": "null"
-                }
-              ],
-              "title": "Days"
-            }
-          },
-          {
-            "in": "query",
-            "name": "start",
+            "name": "repository",
             "required": false,
             "schema": {
               "anyOf": [
                 {
-                  "format": "date-time",
                   "type": "string"
                 },
                 {
                   "type": "null"
                 }
               ],
-              "title": "Start"
+              "description": "Repo rung to clear (\"owner/name\"); omit to clear the account default.",
+              "title": "Repository"
             }
           },
           {
-            "in": "query",
-            "name": "end",
+            "in": "header",
+            "name": "user-agent",
             "required": false,
             "schema": {
               "anyOf": [
                 {
-                  "format": "date-time",
                   "type": "string"
                 },
                 {
                   "type": "null"
                 }
               ],
-              "title": "End"
+              "title": "User-Agent"
             }
+          }
+        ],
+        "responses": {
+          "204": {
+            "description": "Successful Response"
           },
-          {
-            "in": "query",
-            "name": "repo",
-            "required": false,
-            "schema": {
-              "anyOf": [
-                {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                {
-                  "type": "null"
+          "401": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
                 }
-              ],
-              "title": "Repo"
-            }
+              }
+            },
+            "description": "The bearer token is missing, invalid, or revoked."
           },
-          {
-            "description": "Filter by reviewer login(s).",
-            "in": "query",
-            "name": "author",
-            "required": false,
-            "schema": {
-              "anyOf": [
-                {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                {
-                  "type": "null"
+          "403": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
                 }
-              ],
-              "description": "Filter by reviewer login(s).",
-              "title": "Author"
-            }
-          },
-          {
-            "in": "query",
-            "name": "account_type",
-            "required": false,
-            "schema": {
-              "default": "all",
-              "title": "Account Type",
-              "type": "string"
-            }
+              }
+            },
+            "description": "The credential may not perform this action, or the account is blocked."
           },
-          {
-            "in": "query",
-            "name": "review_state",
-            "required": false,
-            "schema": {
-              "anyOf": [
-                {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                {
-                  "type": "null"
+          "404": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
                 }
-              ],
-              "title": "Review State"
-            }
+              }
+            },
+            "description": "No default is set at that rung, or the repository was not found in your account."
           },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            },
+            "description": "Validation Error"
+          }
+        },
+        "security": [
+          {
+            "HTTPBearer": []
+          }
+        ],
+        "summary": "Delete Environment Default",
+        "tags": [
+          "v1"
+        ],
+        "x-ellipsis-sdk-method": "environments.defaults.delete"
+      },
+      "get": {
+        "description": "Get the default environments.\n\nThe account-wide default and the per-repository defaults, as\nenvironment ids. Repo rungs are keyed \"owner/name\".",
+        "operationId": "list_environment_defaults",
+        "parameters": [
           {
             "in": "header",
             "name": "user-agent",
@@ -12563,22 +13454,12 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/GetAnalyticsReviewsResponse"
+                  "$ref": "#/components/schemas/EnvironmentDefaults"
                 }
               }
             },
             "description": "Successful Response"
           },
-          "400": {
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/ErrorResponse"
-                }
-              }
-            },
-            "description": "The time window is invalid: days combined with start, a non-positive days, or end not after start."
-          },
           "401": {
             "content": {
               "application/json": {
@@ -12615,22 +13496,38 @@
             "HTTPBearer": []
           }
         ],
-        "summary": "Get Analytics Reviews",
+        "summary": "List Environment Defaults",
         "tags": [
           "v1"
         ],
-        "x-ellipsis-sdk-method": "analytics.reviews"
-      }
-    },
-    "/v1/auth/cli/poll": {
-      "post": {
-        "description": "Poll a device-code auth flow for its token.\n\nUnauthenticated; the device code identifies the flow.",
-        "operationId": "cli_auth_poll",
+        "x-ellipsis-sdk-method": "environments.defaults.list"
+      },
+      "put": {
+        "description": "Set a default environment.\n\nAddressed by rung: the account rung (repository omitted) or a\nrepository rung (\"owner/name\"); the environment by id or name.\nReturns the full resulting ladder. Refused for sandbox tokens.",
+        "operationId": "put_environment_default",
+        "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/CliAuthPollRequest"
+                "$ref": "#/components/schemas/PutEnvironmentDefaultRequest"
               }
             }
           },
@@ -12641,7 +13538,7 @@
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/PollCliAuthResponse"
+                  "$ref": "#/components/schemas/EnvironmentDefaults"
                 }
               }
             },
@@ -12675,7 +13572,7 @@
                 }
               }
             },
-            "description": "Unknown device code."
+            "description": "The environment or repository was not found in your account."
           },
           "422": {
             "content": {
@@ -12688,23 +13585,151 @@
             "description": "Validation Error"
           }
         },
-        "summary": "Cli Auth Poll",
+        "security": [
+          {
+            "HTTPBearer": []
+          }
+        ],
+        "summary": "Put Environment Default",
         "tags": [
           "v1"
         ],
-        "x-ellipsis-sdk-method": "auth.cli.poll"
+        "x-ellipsis-sdk-method": "environments.defaults.set"
       }
     },
-    "/v1/auth/cli/start": {
-      "post": {
-        "description": "Start a device-code auth flow for the CLI.\n\nUnauthenticated: the CLI has no credential yet \u2014 that's what\nit's obtaining. The human authorizes out-of-band in the\ndashboard.",
-        "operationId": "cli_auth_start",
+    "/v1/environments/{environment_id}": {
+      "delete": {
+        "description": "Delete an environment, by id or by name.\n\nAlways succeeds, even while agents still reference it \u2014 their next\nsession start fails with a clear error naming the missing\nenvironment. Past sessions remain readable. Only for environments\nmanaged through this API \u2014 delete the file to remove one defined\nby a repository.",
+        "operationId": "delete_environment",
+        "parameters": [
+          {
+            "in": "path",
+            "name": "environment_id",
+            "required": true,
+            "schema": {
+              "title": "Environment Id",
+              "type": "string"
+            }
+          },
+          {
+            "in": "header",
+            "name": "user-agent",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "User-Agent"
+            }
+          }
+        ],
         "responses": {
-          "201": {
+          "204": {
+            "description": "Successful Response"
+          },
+          "401": {
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/StartCliAuthResponse"
+                  "$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 environment in your account."
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The environment is defined by a file in a repository; delete that file instead."
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            },
+            "description": "Validation Error"
+          }
+        },
+        "security": [
+          {
+            "HTTPBearer": []
+          }
+        ],
+        "summary": "Delete Environment",
+        "tags": [
+          "v1"
+        ],
+        "x-ellipsis-sdk-method": "environments.delete"
+      },
+      "get": {
+        "description": "Return one saved environment, by id or by name.",
+        "operationId": "get_environment",
+        "parameters": [
+          {
+            "in": "path",
+            "name": "environment_id",
+            "required": true,
+            "schema": {
+              "title": "Environment Id",
+              "type": "string"
+            }
+          },
+          {
+            "in": "header",
+            "name": "user-agent",
+            "required": false,
+            "schema": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "type": "null"
+                }
+              ],
+              "title": "User-Agent"
+            }
+          }
+        ],
+        "responses": {
+          "200": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/EnvironmentResponse"
                 }
               }
             },
@@ -12729,20 +13754,52 @@
               }
             },
             "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 environment in your account."
+          },
+          "422": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/HTTPValidationError"
+                }
+              }
+            },
+            "description": "Validation Error"
           }
         },
-        "summary": "Cli Auth Start",
+        "security": [
+          {
+            "HTTPBearer": []
+          }
+        ],
+        "summary": "Get Environment",
         "tags": [
           "v1"
         ],
-        "x-ellipsis-sdk-method": "auth.cli.start"
-      }
-    },
-    "/v1/budget": {
-      "get": {
-        "description": "Return the caller's current budget summary.",
-        "operationId": "get_budget",
+        "x-ellipsis-sdk-method": "environments.get"
+      },
+      "put": {
+        "description": "Replace an environment's definition, by id or by name.\n\nThe whole definition is replaced, live at once \u2014 future sessions\nresolve the new body; running sessions keep the one frozen at\ntheir start. Only for environments managed through this API: one\ndefined by a repository file is a 409.",
+        "operationId": "update_environment",
         "parameters": [
+          {
+            "in": "path",
+            "name": "environment_id",
+            "required": true,
+            "schema": {
+              "title": "Environment Id",
+              "type": "string"
+            }
+          },
           {
             "in": "header",
             "name": "user-agent",
@@ -12760,17 +13817,37 @@
             }
           }
         ],
+        "requestBody": {
+          "content": {
+            "application/json": {
+              "schema": {
+                "$ref": "#/components/schemas/UpdateEnvironmentRequest"
+              }
+            }
+          },
+          "required": true
+        },
         "responses": {
           "200": {
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/BudgetSummary"
+                  "$ref": "#/components/schemas/EnvironmentResponse"
                 }
               }
             },
             "description": "Successful Response"
           },
+          "400": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The environment is invalid."
+          },
           "401": {
             "content": {
               "application/json": {
@@ -12791,15 +13868,35 @@
             },
             "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 environment in your account."
+          },
+          "409": {
+            "content": {
+              "application/json": {
+                "schema": {
+                  "$ref": "#/components/schemas/ErrorResponse"
+                }
+              }
+            },
+            "description": "The environment is defined by a file in a repository, or another live environment already holds the new name."
+          },
           "422": {
             "content": {
               "application/json": {
                 "schema": {
-                  "$ref": "#/components/schemas/HTTPValidationError"
+                  "$ref": "#/components/schemas/ErrorResponse"
                 }
               }
             },
-            "description": "Validation Error"
+            "description": "The environment's name is missing or malformed."
           }
         },
         "security": [
@@ -12807,11 +13904,11 @@
             "HTTPBearer": []
           }
         ],
-        "summary": "Get Budget",
+        "summary": "Update Environment",
         "tags": [
           "v1"
         ],
-        "x-ellipsis-sdk-method": "budget"
+        "x-ellipsis-sdk-method": "environments.update"
       }
     },
     "/v1/files": {
@@ -13948,7 +15045,8 @@
         "tags": [
           "v1"
         ],
-        "x-ellipsis-sdk-method": "memories.list"
+        "x-ellipsis-sdk-method": "memories.list",
+        "x-ellipsis-undocumented": true
       },
       "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.",
@@ -14042,7 +15140,8 @@
         "tags": [
           "v1"
         ],
-        "x-ellipsis-sdk-method": "memories.create"
+        "x-ellipsis-sdk-method": "memories.create",
+        "x-ellipsis-undocumented": true
       }
     },
     "/v1/memories/{memory_id}": {
@@ -14158,7 +15257,8 @@
         "tags": [
           "v1"
         ],
-        "x-ellipsis-sdk-method": "memories.delete"
+        "x-ellipsis-sdk-method": "memories.delete",
+        "x-ellipsis-undocumented": true
       },
       "get": {
         "description": "Read one memory's full content.\n\nThe id comes from the index returned by listing memories.",
@@ -14251,7 +15351,8 @@
         "tags": [
           "v1"
         ],
-        "x-ellipsis-sdk-method": "memories.get"
+        "x-ellipsis-sdk-method": "memories.get",
+        "x-ellipsis-undocumented": true
       },
       "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.",
@@ -14364,7 +15465,8 @@
         "tags": [
           "v1"
         ],
-        "x-ellipsis-sdk-method": "memories.edit"
+        "x-ellipsis-sdk-method": "memories.edit",
+        "x-ellipsis-undocumented": true
       }
     },
     "/v1/models": {
@@ -15327,7 +16429,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 or input. 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) or\nconfig; with neither, the account's default-config ladder\nresolves the config. `prompt` is the first message; omit it and\nthe session starts idle, waiting for one. 400 when\ninteractive=false and there is no prompt or input. 422 when the\nagent declares an input schema and the request's input is absent\nor invalid.",
         "operationId": "start_agent_session",
         "parameters": [
           {
@@ -15376,7 +16478,7 @@
                 }
               }
             },
-            "description": "The request combines incompatible fields (multiple config sources, idle_start with prompt/input, or both override forms), or the config override is invalid."
+            "description": "The request combines incompatible fields (both config sources, or a one-shot run with no prompt or input), or the config override is invalid."
           },
           "401": {
             "content": {
@@ -15406,7 +16508,7 @@
                 }
               }
             },
-            "description": "The named agent or template does not exist in your account."
+            "description": "The named agent does not exist in your account."
           },
           "409": {
             "content": {
@@ -16674,7 +17776,8 @@
         "tags": [
           "v1"
         ],
-        "x-ellipsis-sdk-method": "sessions.ingest_transcript"
+        "x-ellipsis-sdk-method": "sessions.ingest_transcript",
+        "x-ellipsis-undocumented": true
       }
     },
     "/v1/usage": {