@ellipsis-dev/sdk 0.30.0 → 0.32.0

package/dist/index.js

@@ -29,58 +29,67 @@ var Page = class {
 };
 
 // src/core/sessionHandle.ts
-var TERMINAL_STATUSES = /* @__PURE__ */ new Set([
-  "closed",
-  "idle",
+var FINAL_TURN_STATUSES = /* @__PURE__ */ new Set([
+  "completed",
   "failed",
-  "cancelled",
-  "stopped"
+  "stopped",
+  "cancelled"
 ]);
-var DEFAULT_POLL_INTERVAL_MS = 3e3;
-function isSettled(session) {
-  return session.lifecycle.conversation === "closed" || TERMINAL_STATUSES.has(session.lifecycle.status);
+function isTurnFinal(status) {
+  return FINAL_TURN_STATUSES.has(status);
 }
+var DEFAULT_POLL_INTERVAL_MS = 3e3;
 var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 var SessionHandle = class {
   constructor(sessions, session) {
     this.sessions = sessions;
     this.id = session.id;
     this.session = session;
+    this.turnId = session.turn?.id ?? null;
   }
   sessions;
   id;
   // The latest session snapshot this handle saw.
   session;
+  // The turn `wait()` waits on: the session's turn after `run()`, then the
+  // turn each `send()` creates. Null until the session has a message.
+  turnId;
   async refresh() {
     this.session = (await this.sessions.get(this.id)).session;
     return this.session;
   }
-  // Poll until the session settles (terminal status, or a parked
-  // conversation: state idle/closed).
+  // Poll until the awaited turn reaches a final status (completed, failed,
+  // stopped, cancelled) or the conversation closes, and return that turn.
+  // Returns null at once when the session has no turn to wait on.
   async wait(options = {}) {
     const pollIntervalMs = options.pollIntervalMs ?? DEFAULT_POLL_INTERVAL_MS;
     const deadline = options.timeoutMs == null ? null : Date.now() + options.timeoutMs;
     for (; ; ) {
       const session = await this.refresh();
-      if (isSettled(session)) return session;
+      const turnId = this.turnId;
+      if (turnId == null) return null;
+      const turn = session.turn?.id === turnId ? session.turn : (await this.sessions.turns.get(this.id, turnId)).turn;
+      if (isTurnFinal(turn.status) || session.conversation.state === "closed")
+        return turn;
       if (deadline != null && Date.now() >= deadline) {
         throw new Error(
-          `session ${this.id} not terminal after ${options.timeoutMs}ms`
+          `turn ${turnId} of session ${this.id} not final after ${options.timeoutMs}ms`
         );
       }
       await sleep(pollIntervalMs);
     }
   }
-  // Post into the session's inbox (delivered at the next turn boundary;
-  // wakes a parked session). `images` ride the message as content blocks the
-  // model sees on that turn — a paste into Claude Code.
+  // Post a message into the session. The returned turn is the one that will
+  // answer it, and the one `wait()` waits on from now. `images` ride the
+  // message as content blocks the model sees on that turn.
   async send(message, options = {}) {
     const response = await this.sessions.sendMessage(this.id, {
       message,
       images: options.images,
       idempotency_key: options.idempotencyKey
     });
-    return response.message;
+    this.turnId = response.turn.id;
+    return response;
   }
   async stop() {
     this.session = (await this.sessions.stop(this.id)).session;
@@ -259,7 +268,7 @@ var EllipsisAccountApiKeys = class {
    * Required permissions: write:tokens.
    * API key: Requires a CLI user token belonging to an account administrator.
    * CLI user token: Requires an account administrator.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async create(options) {
@@ -273,7 +282,7 @@ var EllipsisAccountApiKeys = class {
    * Required permissions: read:tokens.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async list() {
@@ -288,7 +297,7 @@ var EllipsisAccountApiKeys = class {
    * Required permissions: delete:tokens.
    * API key: Requires a CLI user token belonging to an account administrator.
    * CLI user token: Requires an account administrator.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async revoke(api_key_id) {
@@ -312,7 +321,7 @@ var EllipsisAccountBillingAutoRecharge = class {
    * Required permissions: read:account.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async get() {
@@ -324,7 +333,7 @@ var EllipsisAccountBillingAutoRecharge = class {
    *
    * Set your automatic credit recharge policy.
    *
-   * Requires a human account administrator; API keys and sandbox tokens
+   * Requires a human account administrator; API keys and session tokens
    * cannot change this policy. Supply enabled explicitly. Saving amounts
    * with enabled=false keeps recharge off; enabling requires a saved card.
    * A recharge buys amount_cents of credit and charges the platform fee
@@ -333,7 +342,7 @@ var EllipsisAccountBillingAutoRecharge = class {
    * Required permissions: write:account.
    * API key: Requires a CLI user token belonging to an account administrator.
    * CLI user token: Requires an account administrator.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async set(options) {
@@ -361,7 +370,7 @@ var EllipsisAccountBilling = class {
    * Required permissions: write:account.
    * API key: Requires a CLI user token belonging to an account administrator.
    * CLI user token: Requires an account administrator.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async cardSetup() {
@@ -381,7 +390,7 @@ var EllipsisAccountBilling = class {
    * Required permissions: write:account.
    * API key: Requires a CLI user token belonging to an account administrator.
    * CLI user token: Requires an account administrator.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async checkout(options) {
@@ -400,7 +409,7 @@ var EllipsisAccountBilling = class {
    * Required permissions: write:account.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async claimSignupCredit() {
@@ -415,7 +424,7 @@ var EllipsisAccountBilling = class {
    * Required permissions: read:account.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async feeSchedule() {
@@ -433,7 +442,7 @@ var EllipsisAccountBilling = class {
    * Required permissions: read:account.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async grants() {
@@ -451,7 +460,7 @@ var EllipsisAccountBilling = class {
    * Required permissions: read:account.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async purchase(checkout_id) {
@@ -469,7 +478,7 @@ var EllipsisAccountBilling = class {
    * Required permissions: read:account.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async purchaseOptions() {
@@ -482,13 +491,13 @@ var EllipsisAccountBilling = class {
    * Explain whether your account can start sessions.
    *
    * Uses the same account gate as session admission, including credit,
-   * contact email, and personal Claude subscription eligibility. Scoped
+   * contact email, and personal subscription eligibility. Scoped
    * spend limits are reported separately by /v1/account/budget.
    *
    * Required permissions: read:account.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async status() {
@@ -507,18 +516,16 @@ var EllipsisAccountModels = class {
    * List selectable agent models.
    *
    * Grouped by manufacturer and model family, newest versions first
-   * within each family, with the organization's default model
-   * flagged (`is_default_agent_model`: the `default_model` of
-   * `GET /v1/account/settings`).
+   * within each family.
    *
    * Reads the same registry as the dashboard's rate table, so a
    * client's model picker can never drift from what's offered. The
-   * selectable set is global; only the flag is account-scoped.
+   * selectable set is global.
    *
    * Required permissions: read:templates.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async list() {
@@ -541,7 +548,7 @@ var EllipsisAccountNotifications = class {
    * Required permissions: write:account.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async testEmail(options) {
@@ -563,7 +570,7 @@ var EllipsisAccountOnboarding = class {
    * Required permissions: read:account.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async get() {
@@ -579,150 +586,22 @@ var EllipsisAccountOnboarding = class {
    * Saving use cases requires a valid organization work email and at
    * least one choice. When Other is the only choice, describe it.
    * Personal accounts save a null work email. This does not change the
-   * billing contact email. Sandbox credentials cannot update answers.
+   * billing contact email. Session tokens cannot update answers.
    * Supplying an organization work email requires a human user and sends
    * a Slack Connect invitation. Slack failures do not undo saved answers.
    *
    * Required permissions: write:account.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async update(options = {}) {
     const path = "/v1/account/onboarding";
-    const body = buildBody({ other_use_case: options.other_use_case, use_cases: options.use_cases, work_email: options.work_email });
+    const body = buildBody({ finished: options.finished, other_use_case: options.other_use_case, use_cases: options.use_cases, work_email: options.work_email });
     return await this.transport.request("PATCH", path, { body });
   }
 };
-var EllipsisAccountProvidersAnthropic = class {
-  constructor(transport) {
-    this.transport = transport;
-  }
-  transport;
-  /**
-   * Delete Anthropic Config
-   *
-   * Required permissions: delete:account.
-   * API key: Supported.
-   * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
-   * Higher permission levels include lower levels: read < write < delete.
-   */
-  async delete() {
-    const path = "/v1/account/providers/anthropic";
-    await this.transport.request("DELETE", path);
-  }
-  /**
-   * Get Anthropic Config
-   *
-   * Required permissions: read:account.
-   * API key: Supported.
-   * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
-   * Higher permission levels include lower levels: read < write < delete.
-   */
-  async get() {
-    const path = "/v1/account/providers/anthropic";
-    return await this.transport.request("GET", path);
-  }
-  /**
-   * Put Anthropic Config
-   *
-   * Required permissions: write:account.
-   * API key: Supported.
-   * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
-   * Higher permission levels include lower levels: read < write < delete.
-   */
-  async set(options) {
-    const path = "/v1/account/providers/anthropic";
-    const body = buildBody({ api_key: options.api_key });
-    return await this.transport.request("PUT", path, { body });
-  }
-  /**
-   * Validate Anthropic Config
-   *
-   * Required permissions: write:account.
-   * API key: Supported.
-   * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
-   * Higher permission levels include lower levels: read < write < delete.
-   */
-  async validate() {
-    const path = "/v1/account/providers/anthropic/validate";
-    return await this.transport.request("POST", path);
-  }
-};
-var EllipsisAccountProvidersBedrock = class {
-  constructor(transport) {
-    this.transport = transport;
-  }
-  transport;
-  /**
-   * Delete Bedrock Config
-   *
-   * Required permissions: delete:account.
-   * API key: Supported.
-   * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
-   * Higher permission levels include lower levels: read < write < delete.
-   */
-  async delete() {
-    const path = "/v1/account/providers/bedrock";
-    await this.transport.request("DELETE", path);
-  }
-  /**
-   * Get Bedrock Config
-   *
-   * Required permissions: read:account.
-   * API key: Supported.
-   * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
-   * Higher permission levels include lower levels: read < write < delete.
-   */
-  async get() {
-    const path = "/v1/account/providers/bedrock";
-    return await this.transport.request("GET", path);
-  }
-  /**
-   * Put Bedrock Config
-   *
-   * Required permissions: write:account.
-   * API key: Supported.
-   * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
-   * Higher permission levels include lower levels: read < write < delete.
-   */
-  async set(options) {
-    const path = "/v1/account/providers/bedrock";
-    const body = buildBody({ model_map: options.model_map, region: options.region, role_arn: options.role_arn });
-    return await this.transport.request("PUT", path, { body });
-  }
-  /**
-   * Validate Bedrock Config
-   *
-   * Required permissions: write:account.
-   * API key: Supported.
-   * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
-   * Higher permission levels include lower levels: read < write < delete.
-   */
-  async validate() {
-    const path = "/v1/account/providers/bedrock/validate";
-    return await this.transport.request("POST", path);
-  }
-};
-var EllipsisAccountProviders = class {
-  constructor(transport) {
-    this.transport = transport;
-    this.anthropic = new EllipsisAccountProvidersAnthropic(transport);
-    this.bedrock = new EllipsisAccountProvidersBedrock(transport);
-  }
-  transport;
-  anthropic;
-  bedrock;
-};
 var EllipsisAccountSettings = class {
   constructor(transport) {
     this.transport = transport;
@@ -733,14 +612,14 @@ var EllipsisAccountSettings = class {
    *
    * Get the organization settings.
    *
-   * Session model and budget defaults, code review and mention behavior,
-   * analytics, retention, and notification contacts. PATCH replaces
-   * supplied sections; PUT preserves its model-and-budget-only behavior.
+   * Session budget ceiling, mention behavior, analytics,
+   * retention, and notification contacts. PATCH replaces
+   * supplied sections; PUT sets the budget ceiling only.
    *
    * Required permissions: read:defaults.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async get() {
@@ -752,23 +631,20 @@ var EllipsisAccountSettings = class {
    *
    * Set the organization settings.
    *
-   * Replaces both: `default_model` accepts an alias or canonical id
-   * and is stored canonical, and cannot be cleared (it is the only
-   * default a session's model resolves against);
    * `budget_ceiling.session` is in US dollars, at most the platform
    * ceiling, and null clears it.
-   * Refused for sandbox tokens (potentially prompt-injected code must
-   * not repoint the organization's defaults).
+   * Refused for session tokens (potentially prompt-injected code must
+   * not raise the organization's ceiling).
    *
    * Required permissions: write:defaults.
    * API key: Requires a CLI user token belonging to an account administrator.
    * CLI user token: Requires an account administrator.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
-  async set(options) {
+  async set(options = {}) {
     const path = "/v1/account/settings";
-    const body = buildBody({ budget_ceiling: options.budget_ceiling, default_model: options.default_model });
+    const body = buildBody({ budget_ceiling: options.budget_ceiling });
     return await this.transport.request("PUT", path, { body });
   }
   /**
@@ -776,17 +652,17 @@ var EllipsisAccountSettings = class {
    *
    * Replace supplied settings sections without changing omitted sections.
    *
-   * Changes to model or budget defaults require a GitHub administrator.
+   * Changes to the budget ceiling require a GitHub administrator.
    *
    * Required permissions: write:defaults.
-   * API key: Cannot set budget_ceiling, default_model to a non-null value; those changes require a CLI user token belonging to an account administrator.
-   * CLI user token: Requires an account administrator when setting budget_ceiling, default_model to a non-null value.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * API key: Cannot set budget_ceiling to a non-null value; those changes require a CLI user token belonging to an account administrator.
+   * CLI user token: Requires an account administrator when setting budget_ceiling to a non-null value.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async update(options = {}) {
     const path = "/v1/account/settings";
-    const body = buildBody({ analytics: options.analytics, budget_ceiling: options.budget_ceiling, code_review: options.code_review, data_retention: options.data_retention, default_model: options.default_model, notifications: options.notifications });
+    const body = buildBody({ analytics: options.analytics, budget_ceiling: options.budget_ceiling, data_retention: options.data_retention, notifications: options.notifications });
     return await this.transport.request("PATCH", path, { body });
   }
 };
@@ -798,7 +674,6 @@ var EllipsisAccount = class {
     this.models = new EllipsisAccountModels(transport);
     this.notifications = new EllipsisAccountNotifications(transport);
     this.onboarding = new EllipsisAccountOnboarding(transport);
-    this.providers = new EllipsisAccountProviders(transport);
     this.settings = new EllipsisAccountSettings(transport);
   }
   transport;
@@ -807,7 +682,6 @@ var EllipsisAccount = class {
   models;
   notifications;
   onboarding;
-  providers;
   settings;
   /**
    * Get Customer Activity
@@ -819,7 +693,7 @@ var EllipsisAccount = class {
    * Required permissions: read:account.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async activity() {
@@ -832,7 +706,7 @@ var EllipsisAccount = class {
    * Required permissions: read:account.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async auditLog() {
@@ -853,7 +727,7 @@ var EllipsisAccount = class {
    * Required permissions: read:account.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async budget() {
@@ -866,12 +740,12 @@ var EllipsisAccount = class {
    * Required permissions: write:account.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async update(options = {}) {
     const path = "/v1/account";
-    const body = buildBody({ can_start_job_runs: options.can_start_job_runs, contact_email: options.contact_email });
+    const body = buildBody({ can_start_sessions: options.can_start_sessions, contact_email: options.contact_email });
     return await this.transport.request("PATCH", path, { body });
   }
   /**
@@ -883,14 +757,14 @@ var EllipsisAccount = class {
    * preserved. Set policy.developer_defaults to null to disable developer
    * limits. Null override windows inherit their default. API keys use
    * their stable ID, not their secret. Changes apply to the next paid
-   * request, including sessions already running. API keys and sandbox
-   * credentials cannot edit budgets. The session ceiling remains at
+   * request, including sessions already running. API keys and session
+   * tokens cannot edit budgets. The session ceiling remains at
    * /account/settings; purchasing credits is separate from budget policy.
    *
    * Required permissions: write:defaults.
    * API key: Requires a CLI user token belonging to an account administrator.
    * CLI user token: Requires an account administrator.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async updateBudget(options = {}) {
@@ -905,14 +779,14 @@ var EllipsisAccount = class {
    *
    * Omit period_start for the current UTC month; select a period returned
    * in billing_periods to view history. Credit debits are distinct from
-   * rated token usage through BYOK, customer Bedrock, or a developer's
-   * Claude subscription. Rated usage estimates are not provider invoices.
+   * rated token usage through a developer's Claude or Codex
+   * subscription. Rated usage estimates are not provider invoices.
    * Pending and unresolved requests identify missing measurements.
    *
    * Required permissions: read:account.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async usage(options = {}) {
@@ -938,7 +812,7 @@ var EllipsisAgents = class {
    * Required permissions: write:configs.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -959,7 +833,7 @@ var EllipsisAgents = class {
    * Required permissions: write:configs.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -975,7 +849,7 @@ var EllipsisAgents = class {
    * Required permissions: read:configs.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -996,7 +870,7 @@ var EllipsisAgents = class {
    * Required permissions: write:configs.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -1013,7 +887,7 @@ var EllipsisAgents = class {
    * Required permissions: read:configs.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -1035,7 +909,7 @@ var EllipsisAgents = class {
    * Required permissions: read:configs.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -1046,28 +920,30 @@ var EllipsisAgents = class {
   /**
    * Start Agent Session
    *
-   * Invoke an agent.
+   * Start an agent session.
    *
-   * Runs a certified agent with its configured instructions, model,
-   * environment, permissions, skills, and budget, and returns
-   * the session it started. The session runs once and does not accept
-   * follow-up messages. If the agent declares input.json_schema,
-   * send only `input` for its initial message. Otherwise send a non-empty
-   * `prompt`, which becomes the initial message verbatim. Both fields
-   * together, neither field, and input that renders an empty message are
-   * rejected with 422. An optional `budget` lowers the session cap;
-   * `metadata` tags the session. Codex invocations are not supported.
+   * Starts a session from the agent's saved `session` settings and
+   * returns it. The body takes the fields of POST /v1/sessions, all
+   * optional: each field you send replaces the agent's value for that
+   * field, and each field you leave out keeps it. `metadata` is merged
+   * into the agent's key by key, and a `null` value removes a key.
+   * Other lists and maps, and `environment`, are replaced whole;
+   * naming the other harness replaces the agent's. An empty body starts
+   * the agent as written. If the agent declares input.json_schema, send
+   * `input`; its rendered message is added after the prompt. A run-once
+   * session needs a prompt or `input` from the agent or the request, or
+   * the call is a 400.
    *
    * Required permissions: write:sessions.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
-  async run(agent_id, options = {}) {
+  async start(agent_id, options = {}) {
     const path = `/v1/agents/${enc(agent_id)}/sessions`;
-    const body = buildBody({ budget: options.budget, input: options.input, metadata: options.metadata, prompt: options.prompt });
+    const body = buildBody({ budget: options.budget, claude_code: options.claude_code, codex: options.codex, conversation: options.conversation, environment: options.environment, force_rebuild: options.force_rebuild, images: options.images, input: options.input, metadata: options.metadata, output: options.output, permissions: options.permissions, skills: options.skills });
     return await this.transport.request("POST", path, { body });
   }
   /**
@@ -1076,7 +952,7 @@ var EllipsisAgents = class {
    * Required permissions: read:configs.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -1096,7 +972,7 @@ var EllipsisAgents = class {
    * Required permissions: write:configs.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -1117,7 +993,7 @@ var EllipsisAgents = class {
    * Required permissions: write:configs.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -1142,7 +1018,7 @@ var EllipsisAlerts = class {
    * Required permissions: write:alerts.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async dismiss(alert_id) {
@@ -1159,7 +1035,7 @@ var EllipsisAlerts = class {
    * Required permissions: read:alerts.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async get(alert_id) {
@@ -1179,7 +1055,7 @@ var EllipsisAlerts = class {
    * Required permissions: read:alerts.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async list(options = {}) {
@@ -1214,7 +1090,7 @@ var EllipsisAnalytics = class {
    * Required permissions: read:account.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async metrics(options = {}) {
@@ -1233,7 +1109,7 @@ var EllipsisAnalytics = class {
    * Required permissions: read:account.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async pullRequests(options = {}) {
@@ -1244,7 +1120,7 @@ var EllipsisAnalytics = class {
   /**
    * Get Analytics Reviews
    *
-   * Return code-review analytics.
+   * Return pull request review analytics.
    *
    * account_type scopes reviewers (bot|user|all) — e.g. "what apps
    * review the most PRs?" is the reviewer facets here with
@@ -1254,7 +1130,7 @@ var EllipsisAnalytics = class {
    * Required permissions: read:account.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async reviews(options = {}) {
@@ -1323,7 +1199,7 @@ var EllipsisEnvironments = class {
    * Required permissions: write:environments.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async create(options) {
@@ -1345,7 +1221,7 @@ var EllipsisEnvironments = class {
    * Required permissions: delete:environments.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async delete(environment_id) {
@@ -1360,7 +1236,7 @@ var EllipsisEnvironments = class {
    * Required permissions: read:environments.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async get(environment_id) {
@@ -1375,7 +1251,7 @@ var EllipsisEnvironments = class {
    * Required permissions: read:environments.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async list() {
@@ -1395,7 +1271,7 @@ var EllipsisEnvironments = class {
    * Required permissions: write:environments.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async update(environment_id, options) {
@@ -1404,113 +1280,6 @@ var EllipsisEnvironments = class {
     return await this.transport.request("PUT", path, { body });
   }
 };
-var EllipsisFiles = class {
-  constructor(transport) {
-    this.transport = transport;
-  }
-  transport;
-  /**
-   * Create File
-   *
-   * Upload a file that outlives the sandbox.
-   *
-   * v1: PNG images only, base64 in the JSON body, 10 MiB cap. The
-   * primary caller is the in-sandbox `agent file upload` CLI (an
-   * agent persisting a screenshot to link on a PR), but all
-   * credential types work. Returns the org-membership-gated
-   * dashboard URL so callers never hard-code URL shapes.
-   *
-   * Required permissions: write:files.
-   * API key: Supported.
-   * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
-   * Higher permission levels include lower levels: read < write < delete.
-   * Grant match patterns can further restrict access to individual resources.
-   */
-  async create(options) {
-    const path = "/v1/files";
-    const body = buildBody({ content_type: options.content_type, data_b64: options.data_b64, filename: options.filename });
-    return await this.transport.request("POST", path, { body });
-  }
-  /**
-   * Delete File
-   *
-   * Delete a file.
-   *
-   * A foreign, missing, or already-deleted id is an
-   * indistinguishable 404, so ids can't be enumerated. Sandbox
-   * tokens get a 403 (a sandbox token sits next to
-   * potentially-untrusted code and must not be able to destroy the
-   * account's files — uploading is fine, destruction is not); API
-   * keys and user tokens may delete.
-   *
-   * Required permissions: delete:files.
-   * API key: Supported.
-   * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
-   * Higher permission levels include lower levels: read < write < delete.
-   * Grant match patterns can further restrict access to individual resources.
-   */
-  async delete(file_id) {
-    const path = `/v1/files/${enc(file_id)}`;
-    await this.transport.request("DELETE", path);
-  }
-  /**
-   * Get File
-   *
-   * Return one file's metadata and download link.
-   *
-   * Includes the gated dashboard URL and a short-lived presigned
-   * `download_url`, plus the owning account's GitHub login.
-   *
-   * Signed-in dashboard users are checked against the file's owning
-   * account, regardless of their selected organization. API keys,
-   * CLI user tokens, and sandbox tokens remain restricted to their
-   * own account. Missing, deleted, and inaccessible files return 404.
-   *
-   * To fetch the bytes locally, call this and then GET download_url
-   * immediately — the JSON API never carries the file. The CLI's
-   * `agent file get` wraps exactly that two-step.
-   *
-   * Required permissions: read:files.
-   * API key: Supported.
-   * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
-   * Higher permission levels include lower levels: read < write < delete.
-   * Grant match patterns can further restrict access to individual resources.
-   */
-  async get(file_id) {
-    const path = `/v1/files/${enc(file_id)}`;
-    return await this.transport.request("GET", path);
-  }
-  /**
-   * List Files
-   *
-   * List uploaded files, newest first.
-   *
-   * Metadata only by default. Set include_download_urls=true to get
-   * a download_urls map keyed by file id for thumbnails or batch
-   * downloads. URLs expire within about a minute. session_id scopes
-   * the list to one session's uploads.
-   *
-   * Required permissions: read:files.
-   * API key: Supported.
-   * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
-   * Higher permission levels include lower levels: read < write < delete.
-   * Grant match patterns can further restrict access to individual resources.
-   */
-  async list(options = {}) {
-    const path = "/v1/files";
-    const query = buildQuery({ session_id: options.session_id, limit: options.limit, cursor: options.cursor, include_download_urls: options.include_download_urls });
-    const response = await this.transport.request("GET", path, { query });
-    return new Page(
-      response,
-      "files",
-      (cursor) => this.list({ ...options, cursor })
-    );
-  }
-};
 var EllipsisHandlers = class {
   constructor(transport) {
     this.transport = transport;
@@ -1527,12 +1296,12 @@ var EllipsisHandlers = class {
    * state without fetching GitHub or triggering synchronization.
    *
    * Requires configs:read; scoped grants match handlers/{service}.
-   * Sandbox credentials with that grant may read handlers.
+   * Session tokens with that grant may read handlers.
    *
    * Required permissions: read:configs.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -1546,8 +1315,8 @@ var EllipsisHandlers = class {
    * Return session counts and accumulated spend for a saved handler.
    *
    * Filters only by session creation time. Omitted bounds include all
-   * history. Counts use the current conversation outcome, so an idle
-   * session remains active. Spend includes the selected sessions' full
+   * history. Counts use the current turn and conversation state, so an open
+   * conversation awaiting another message remains active. Spend includes the selected sessions' full
    * accumulated cost, including activity after the creation-time window.
    * Only sessions carrying this exact saved handler id are counted;
    * legacy sessions without handler provenance are excluded.
@@ -1557,12 +1326,12 @@ var EllipsisHandlers = class {
    * Those windows use usage timestamps and are independent of start/end.
    *
    * Requires configs:read matching handlers/{service} and unrestricted
-   * sessions:read. Sandbox tokens with both grants may read metrics.
+   * sessions:read. Session tokens with both grants may read metrics.
    *
    * Required permissions: read:sessions, read:configs.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -1591,7 +1360,7 @@ var EllipsisIntegrationsGithub = class {
    * Required permissions: read:integrations.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async members() {
@@ -1606,7 +1375,7 @@ var EllipsisIntegrationsGithub = class {
    * Required permissions: read:integrations.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async repos() {
@@ -1619,7 +1388,7 @@ var EllipsisIntegrationsGithub = class {
    * Required permissions: write:integrations.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async uninstall(options) {
@@ -1639,7 +1408,7 @@ var EllipsisIntegrationsLinear = class {
    * Required permissions: delete:integrations.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async delete() {
@@ -1654,7 +1423,7 @@ var EllipsisIntegrationsLinear = class {
    * Required permissions: read:integrations.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async teams() {
@@ -1667,12 +1436,12 @@ var EllipsisIntegrationsLinear = class {
    * Required permissions: write:integrations.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async updateSettings(options) {
     const path = "/v1/integrations/linear/settings";
-    const body = buildBody({ mcp_inclusion: options.mcp_inclusion, teams: options.teams });
+    const body = buildBody({ teams: options.teams });
     return await this.transport.request("PUT", path, { body });
   }
 };
@@ -1687,7 +1456,7 @@ var EllipsisIntegrationsSentry = class {
    * Required permissions: delete:integrations.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async delete(integration_id) {
@@ -1702,7 +1471,7 @@ var EllipsisIntegrationsSentry = class {
    * Required permissions: read:integrations.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async organizations() {
@@ -1724,7 +1493,7 @@ var EllipsisIntegrationsSlack = class {
    * Required permissions: read:integrations.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async channels() {
@@ -1737,7 +1506,7 @@ var EllipsisIntegrationsSlack = class {
    * Required permissions: write:integrations.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async createOperationsChannel() {
@@ -1750,7 +1519,7 @@ var EllipsisIntegrationsSlack = class {
    * Required permissions: delete:integrations.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async delete() {
@@ -1766,27 +1535,13 @@ var EllipsisIntegrationsSlack = class {
    * Required permissions: read:integrations.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async members() {
     const path = "/v1/integrations/slack/members";
     return await this.transport.request("GET", path);
   }
-  /**
-   * Update Slack Settings
-   *
-   * Required permissions: write:integrations.
-   * API key: Supported.
-   * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
-   * Higher permission levels include lower levels: read < write < delete.
-   */
-  async updateSettings(options) {
-    const path = "/v1/integrations/slack/settings";
-    const body = buildBody({ mcp_inclusion: options.mcp_inclusion });
-    return await this.transport.request("PUT", path, { body });
-  }
 };
 var EllipsisIntegrations = class {
   constructor(transport) {
@@ -1810,13 +1565,13 @@ var EllipsisIntegrations = class {
    * config can learn which repositories, channels, teams, and
    * organizations it may name before POST /agents.
    *
-   * Available to all credential types including sandbox tokens: the
+   * Available to all credential types including session tokens: the
    * responses never include OAuth tokens or any other secret.
    *
    * Required permissions: read:integrations.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async list() {
@@ -1824,183 +1579,43 @@ var EllipsisIntegrations = class {
     return await this.transport.request("GET", path);
   }
 };
-var EllipsisMemories = class {
+var EllipsisReviewsConfigs = class {
   constructor(transport) {
     this.transport = transport;
   }
   transport;
   /**
-   * Create Memory
-   *
-   * Save a memory for future agent sessions.
-   *
-   * Memories are durable lessons shared across the whole
-   * organization — conventions, past decisions, known gotchas that an
-   * agent cannot derive from the repository itself. One concise fact
-   * per memory; the description is what a reader sees in the index.
-   *
-   * Creating never overwrites: a path that already exists is a 409, so
-   * correcting an existing memory is an explicit edit.
-   *
-   * Required permissions: write:memories.
-   * API key: Supported.
-   * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
-   * Higher permission levels include lower levels: read < write < delete.
-   * Grant match patterns can further restrict access to individual resources.
-   */
-  async create(options) {
-    const path = "/v1/memories";
-    const body = buildBody({ content: options.content, description: options.description, path: options.path });
-    return await this.transport.request("POST", path, { body });
-  }
-  /**
-   * Delete Memory
-   *
-   * Delete a memory that is no longer true.
-   *
-   * Available to every credential type, agents included — a wrong
-   * memory is worse than a missing one. The deleted content is kept in
-   * the memory's history for forensics, not for an undo API.
-   *
-   * Required permissions: delete:memories.
-   * API key: Supported.
-   * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
-   * Higher permission levels include lower levels: read < write < delete.
-   * Grant match patterns can further restrict access to individual resources.
-   */
-  async delete(memory_id, options = {}) {
-    const path = `/v1/memories/${enc(memory_id)}`;
-    const query = buildQuery({ if_sha256: options.if_sha256 });
-    await this.transport.request("DELETE", path, { query });
-  }
-  /**
-   * Edit Memory
-   *
-   * Correct an existing memory in place.
-   *
-   * Pass description, content, or both. This never creates a memory (an
-   * unknown id is a 404) and never moves one — the path is immutable, so
-   * relocating a memory is a delete plus a create.
-   *
-   * Pass `if_sha256` (from a previous read) to make a concurrent write
-   * a 409 instead of silently overwriting it.
-   *
-   * Required permissions: write:memories.
-   * API key: Supported.
-   * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
-   * Higher permission levels include lower levels: read < write < delete.
-   * Grant match patterns can further restrict access to individual resources.
-   */
-  async edit(memory_id, options = {}) {
-    const path = `/v1/memories/${enc(memory_id)}`;
-    const body = buildBody({ content: options.content, description: options.description, if_sha256: options.if_sha256 });
-    return await this.transport.request("PUT", path, { body });
-  }
-  /**
-   * Get Memory
-   *
-   * Read one memory's full content.
+   * List Review Configs
    *
-   * The id comes from the index returned by listing memories.
+   * List code review configs: every kind: code_review file synced from a repository, newest first.
    *
-   * Required permissions: read:memories.
+   * Required permissions: read:reviews.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
-   * Grant match patterns can further restrict access to individual resources.
    */
-  async get(memory_id) {
-    const path = `/v1/memories/${enc(memory_id)}`;
+  async list() {
+    const path = "/v1/reviews/configs";
     return await this.transport.request("GET", path);
   }
-  /**
-   * List Memories
-   *
-   * List the organization's memories as a readable index.
-   *
-   * Returns the memories rendered as a markdown index (one line per
-   * memory, carrying its id, path, and description) plus the same
-   * entries structured, each with every field except `content`. Read
-   * the index, then fetch the ids whose content you want.
-   *
-   * Required permissions: read:memories.
-   * API key: Supported.
-   * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
-   * Higher permission levels include lower levels: read < write < delete.
-   * Grant match patterns can further restrict access to individual resources.
-   */
-  async list(options = {}) {
-    const path = "/v1/memories";
-    const query = buildQuery({ prefix: options.prefix });
-    return await this.transport.request("GET", path, { query });
-  }
 };
 var EllipsisReviews = class {
   constructor(transport) {
     this.transport = transport;
+    this.configs = new EllipsisReviewsConfigs(transport);
   }
   transport;
-  /**
-   * List Review Configs
-   *
-   * Required permissions: read:reviews.
-   * API key: Supported.
-   * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
-   * Higher permission levels include lower levels: read < write < delete.
-   */
-  async configs() {
-    const path = "/v1/reviews/configs";
-    return await this.transport.request("GET", path);
-  }
-  /**
-   * Create Review
-   *
-   * Run a code review on demand.
-   *
-   * Reviews an open pull request. Which pipeline runs is not a
-   * parameter: it resolves from the repository's files exactly as
-   * it does for a push, so an on-demand review never disagrees with
-   * the automatic one.
-   *
-   * A review is one pipeline run over one commit range, with one
-   * agent session per stage: `review.id` is the run id, and
-   * `stages[].session_id` is where a client streams
-   * (/sessions/{id}/stream on a stage session), since the review
-   * itself is a pipeline rather than one process.
-   *
-   * Required permissions: write:reviews.
-   * API key: Supported.
-   * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
-   * Higher permission levels include lower levels: read < write < delete.
-   */
-  async create(options) {
-    const path = "/v1/reviews";
-    const body = buildBody({ owner: options.owner, post: options.post, pull_request_number: options.pull_request_number, repo: options.repo, scope: options.scope });
-    return await this.transport.request("POST", path, { body });
-  }
+  configs;
   /**
    * Get Review
    *
-   * Return one review with findings and outcome.
-   *
-   * Includes its scope, the per-stage sessions, the parsed findings,
-   * the finding counters, and the posting outcome.
-   *
-   * Findings only exist after a stage session finalizes — a running
-   * review honestly reports [] / null, which is why a client
-   * streams a stage session and then re-fetches the review.
+   * Get a code review: its reviewers and every comment they returned, posted or held back.
    *
    * Required permissions: read:reviews.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async get(review_id) {
@@ -2012,18 +1627,10 @@ var EllipsisReviews = class {
    *
    * List code reviews, newest first.
    *
-   * `findings` and `configuration` are omitted (counters only). Each
-   * filter is a set: repeat `repository`, `pull_request_number`, or
-   * `status` to match any of several values. `start` and `end` bound
-   * the review's creation time.
-   *
-   * Webhook-created reviews appear here too, so this answers "show
-   * me every review on this PR".
-   *
    * Required permissions: read:reviews.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async list(options = {}) {
@@ -2047,13 +1654,13 @@ var EllipsisSecrets = class {
    *
    * Delete a secret by name.
    *
-   * Refused for sandbox tokens; mutations require an API key or
+   * Refused for session tokens; mutations require an API key or
    * user token.
    *
    * Required permissions: delete:secrets.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -2072,7 +1679,7 @@ var EllipsisSecrets = class {
    * Required permissions: read:secrets.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -2086,14 +1693,14 @@ var EllipsisSecrets = class {
    * Upsert secrets.
    *
    * Returns only the secrets this call wrote, names and timestamps
-   * only — values are write-only. Refused for sandbox tokens (held by
-   * potentially-untrusted in-sandbox code); mutations require an
-   * API key or user token.
+   * only — values are write-only. Refused for session tokens (held by
+   * potentially-untrusted code running inside a session); mutations
+   * require an API key or user token.
    *
    * Required permissions: write:secrets.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -2103,11 +1710,58 @@ var EllipsisSecrets = class {
     return await this.transport.request("PUT", path, { body });
   }
 };
+var EllipsisSessionsTurns = class {
+  constructor(transport) {
+    this.transport = transport;
+  }
+  transport;
+  /**
+   * Get Session Turn
+   *
+   * Return one turn.
+   *
+   * Poll this after sending a message: the message is answered when
+   * the turn's status is completed, failed, stopped, or cancelled.
+   *
+   * Required permissions: read:sessions.
+   * API key: Supported.
+   * CLI user token: Supported.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Higher permission levels include lower levels: read < write < delete.
+   * Grant match patterns can further restrict access to individual resources.
+   */
+  async get(session_id, turn_id) {
+    const path = `/v1/sessions/${enc(session_id)}/turns/${enc(turn_id)}`;
+    return await this.transport.request("GET", path);
+  }
+  /**
+   * Get Session Turns
+   *
+   * Return the session's turns and messages, oldest first.
+   *
+   * One turn per message: pending until the agent starts on it,
+   * running while it works, then completed, failed, stopped, or
+   * cancelled.
+   *
+   * Required permissions: read:sessions.
+   * API key: Supported.
+   * CLI user token: Supported.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Higher permission levels include lower levels: read < write < delete.
+   * Grant match patterns can further restrict access to individual resources.
+   */
+  async list(session_id) {
+    const path = `/v1/sessions/${enc(session_id)}/turns`;
+    return await this.transport.request("GET", path);
+  }
+};
 var EllipsisSessions = class {
   constructor(transport) {
     this.transport = transport;
+    this.turns = new EllipsisSessionsTurns(transport);
   }
   transport;
+  turns;
   /**
    * Get Session Analytics
    *
@@ -2115,16 +1769,16 @@ var EllipsisSessions = class {
    *
    * Token lanes use the request's saved rates. Content attribution
    * apportions input/cache spend by text size, counting carried context
-   * on every request. It is an estimate, not a tool execution fee.
+   * on every request. It is an estimate, not a tool call fee.
    * Only the latest 200 retained request bodies are inspected; missing
    * or unsupported context remains explicitly unattributed. No raw
-   * prompts or tool results are returned. Sandbox tokens may read only
+   * prompts or tool results are returned. Session tokens may read only
    * their own session's analytics.
    *
    * Required permissions: read:sessions.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own session.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own session.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -2138,15 +1792,15 @@ var EllipsisSessions = class {
    * Return the session's uncommitted changes as a patch.
    *
    * One unified-diff section per changed file, captured from the
-   * sandbox's working tree when the session ended. The per-file
+   * environment's working tree when the session ended. The per-file
    * counts ride on the session itself (`git.repos[].files`); this
    * is the text behind them. Empty when the tree was clean. A
-   * sandbox token may read only its own session's diff.
+   * session token may read only its own session's diff.
    *
    * Required permissions: read:sessions.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own session.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own session.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -2160,7 +1814,7 @@ var EllipsisSessions = class {
    * Download the complete session history.
    *
    * The complete, ordered history of the session (agent output, tool calls, thinking,
-   * lifecycle events, sandbox output, message events) as an ordered
+   * lifecycle events, environment output, message events) as an ordered
    * manifest of presigned segment URLs.
    *
    * Segments are gzip members: download in order and concatenate
@@ -2171,7 +1825,7 @@ var EllipsisSessions = class {
    * Required permissions: read:sessions.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -2179,35 +1833,14 @@ var EllipsisSessions = class {
     const path = `/v1/sessions/${enc(session_id)}/download`;
     return await this.transport.request("GET", path);
   }
-  /**
-   * List Session Executions
-   *
-   * Return the session's execution attempts, oldest first.
-   *
-   * Includes the selected harness, model, resolved instructions, initial
-   * query, and common result summary. Complete native outputs remain in
-   * the session's records. Internal launch options and checkpoint storage
-   * references are excluded.
-   *
-   * Required permissions: read:sessions.
-   * API key: Supported.
-   * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
-   * Higher permission levels include lower levels: read < write < delete.
-   * Grant match patterns can further restrict access to individual resources.
-   */
-  async executions(session_id) {
-    const path = `/v1/sessions/${enc(session_id)}/executions`;
-    return await this.transport.request("GET", path);
-  }
   /**
    * Get Session
    *
    * Return one session.
    *
-   * The public wire shape — the same shape the stream's session
-   * frames carry, with attribution, stop, and archive actors resolved
-   * at read time.
+   * The public wire shape, the same shape the stream's session frames
+   * carry, with attribution, stop, and archive actors resolved at read
+   * time. `turn` is the turn in progress or the latest one.
    *
    * The heavy near-static blobs (config snapshot, input/output)
    * live on the detail endpoints, not here.
@@ -2215,7 +1848,7 @@ var EllipsisSessions = class {
    * Required permissions: read:sessions.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -2234,7 +1867,7 @@ var EllipsisSessions = class {
    * Required permissions: read:sessions.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -2247,15 +1880,16 @@ var EllipsisSessions = class {
    *
    * Append transcript lines to a session's record.
    *
-   * The in-sandbox tailer for interactive sessions.
+   *             The transcript tailer running inside the session's environment, for
+   * interactive sessions.
    *
-   * A sandbox token may only push its own session's transcript.
-   * Idempotent by transcript line uuid; tolerant of malformed lines.
+   *             A session token may only push its own session's transcript.
+   *             Idempotent by transcript line uuid; tolerant of malformed lines.
    *
    * Required permissions: write:sessions.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own session.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own session.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -2276,13 +1910,13 @@ var EllipsisSessions = class {
    * Required permissions: read:sessions.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
   async list(options = {}) {
     const path = "/v1/sessions";
-    const query = buildQuery({ agent: options.agent, source: options.source, service: options.service, handler: options.handler, days: options.days, start: options.start, end: options.end, limit: options.limit, cursor: options.cursor, author_id: options.author_id, repo: options.repo, unfinished: options.unfinished, exclude_code_review: options.exclude_code_review });
+    const query = buildQuery({ agent: options.agent, source: options.source, service: options.service, handler: options.handler, days: options.days, start: options.start, end: options.end, limit: options.limit, cursor: options.cursor, author_id: options.author_id, repo: options.repo, unfinished: options.unfinished });
     const response = await this.transport.request("GET", path, { query });
     return new Page(
       response,
@@ -2291,25 +1925,22 @@ var EllipsisSessions = class {
     );
   }
   /**
-   * Get Session Output
+   * Get Session Metrics
    *
-   * Return the session's typed output.
+   * List the CPU, memory, swap, and disk readings of every VM the
+   * session ran on, oldest first.
    *
-   * The payload the agent submitted through its config-declared
-   * output.json_schema, as the raw JSON body with no envelope. 404
-   * while the session is still running (poll GET /v1/sessions/{id}),
-   * when the agent declares no output block, or when no execution
-   * produced output.
+   * A reading is taken every 5 seconds while the session runs.
    *
    * Required permissions: read:sessions.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own session.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
-  async output(session_id) {
-    const path = `/v1/sessions/${enc(session_id)}/output`;
+  async metrics(session_id) {
+    const path = `/v1/sessions/${enc(session_id)}/metrics`;
     return await this.transport.request("GET", path);
   }
   /**
@@ -2318,7 +1949,7 @@ var EllipsisSessions = class {
    * Return the session's stored transcript records, oldest first.
    *
    * Pagination is opt-in (cursor/limit); a bare call returns the
-   * full retained transcript. Available to sandbox tokens too: an
+   * full retained transcript. Available to session tokens too: an
    * agent answering "did X look into Y?" needs to read the sessions
    * it finds, and any org member sees the same transcript in the
    * dashboard.
@@ -2326,7 +1957,7 @@ var EllipsisSessions = class {
    * Required permissions: read:sessions.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -2346,7 +1977,7 @@ var EllipsisSessions = class {
    * Required permissions: read:sessions.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -2360,15 +1991,14 @@ var EllipsisSessions = class {
    *
    * Send a message to a session.
    *
-   * 409 for react/cron, non-interactive, and closed sessions.
-   * Returns the created message so the caller can track it by id; a
-   * retried send with the same idempotency_key returns the original
-   * message.
+   * 409 for mention, non-interactive, closed, and out-of-budget
+   * sessions. Returns the created message and its turn; a retried send
+   * with the same idempotency_key returns the original ones.
    *
    * Required permissions: write:sessions.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -2383,7 +2013,7 @@ var EllipsisSessions = class {
    * Required permissions: read:sessions.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -2397,41 +2027,43 @@ var EllipsisSessions = class {
    * Start a cloud agent session.
    *
    * The daily driver: a prompt, optionally where to run it
-   * (`environment`) and the run's own settings, in the AgentConfig
+   * (`environment`) and the session's own settings, in the AgentConfig
    * vocabulary. What you send is what runs: omit `environment` and the
-   * session runs in the built-in basic sandbox. A missing model or
+   * session runs in the built-in basic environment. A missing model or
    * budget comes from the organization's settings, so
    * `{"claude_code": {"prompt": "..."}}` is a complete request.
    * Set exactly one of `claude_code` or `codex`. Its `prompt` is the
-   * first message; omit the prompt and the session starts idle, waiting for
-   * one. 400 when `lifecycle.interactive` is false and there is no prompt, or
-   * when `budget` exceeds the organization's per-session ceiling. To
-   * run a saved agent, use POST /v1/agents/{agent_id}/sessions.
+   * first message; omit the prompt and the session starts with no
+   * turn, waiting for one. 400 when `conversation.interactive` is false
+   * and there is no prompt, or when `budget.session` exceeds the
+   * organization's per-session ceiling. To start a session from a saved
+   * agent, use POST /v1/agents/{agent_id}/sessions.
    *
    * Required permissions: write:sessions.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
   async start(options = {}) {
     const path = "/v1/sessions";
-    const body = buildBody({ budget: options.budget, claude_code: options.claude_code, codex: options.codex, environment: options.environment, force_rebuild: options.force_rebuild, images: options.images, lifecycle: options.lifecycle, metadata: options.metadata, output: options.output, permissions: options.permissions, repositories: options.repositories, skills: options.skills });
+    const body = buildBody({ budget: options.budget, claude_code: options.claude_code, codex: options.codex, conversation: options.conversation, environment: options.environment, force_rebuild: options.force_rebuild, images: options.images, metadata: options.metadata, output: options.output, permissions: options.permissions, skills: options.skills });
     return await this.transport.request("POST", path, { body });
   }
   /**
    * Stop Session
    *
-   * Stop an in-flight session and return it.
+   * Stop the turn in progress and return the session.
    *
-   * stopped_by is recorded only when the caller's credential maps
-   * to a GitHub account.
+   * The turn ends `stopped`; the conversation stays open. 409 when no
+   * turn is pending or running. The stopping user is recorded only
+   * when the caller's credential maps to a GitHub account.
    *
    * Required permissions: write:sessions.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -2445,7 +2077,7 @@ var EllipsisSessions = class {
    * Required permissions: read:sessions.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -2469,7 +2101,7 @@ var EllipsisSessions = class {
    * Required permissions: write:sessions.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    * Grant match patterns can further restrict access to individual resources.
    */
@@ -2501,7 +2133,7 @@ var EllipsisSupportSlack = class {
    * Required permissions: write:account.
    * API key: Requires a CLI user token.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async create(options) {
@@ -2515,7 +2147,7 @@ var EllipsisSupportSlack = class {
    * Required permissions: read:account.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async get() {
@@ -2528,7 +2160,7 @@ var EllipsisSupportSlack = class {
    * Required permissions: write:account.
    * API key: Requires a CLI user token.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async invite(options) {
@@ -2558,7 +2190,7 @@ var EllipsisTemplates = class {
    * Required permissions: read:templates.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async get(template_id) {
@@ -2576,7 +2208,7 @@ var EllipsisTemplates = class {
    * Required permissions: read:templates.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async list() {
@@ -2600,7 +2232,7 @@ var EllipsisUserSubscriptionTokens = class {
    * Required permissions: delete:user.
    * API key: Requires a CLI user token.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async delete(provider) {
@@ -2618,7 +2250,7 @@ var EllipsisUserSubscriptionTokens = class {
    * Required permissions: read:user.
    * API key: Requires a CLI user token.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async get(provider) {
@@ -2637,7 +2269,7 @@ var EllipsisUserSubscriptionTokens = class {
    * Required permissions: read:user.
    * API key: Requires a CLI user token.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async list() {
@@ -2658,7 +2290,7 @@ var EllipsisUserSubscriptionTokens = class {
    * Required permissions: write:user.
    * API key: Requires a CLI user token.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async set(provider, options) {
@@ -2680,7 +2312,7 @@ var EllipsisUserSubscriptionTokens = class {
    * Required permissions: read:user.
    * API key: Requires a CLI user token.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async usage(provider) {
@@ -2702,7 +2334,7 @@ var EllipsisUserSubscriptionTokens = class {
    * Required permissions: write:user.
    * API key: Requires a CLI user token.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async verify(provider) {
@@ -2721,7 +2353,7 @@ var EllipsisUserTokens = class {
    * Required permissions: read:user.
    * API key: Requires a CLI user token.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async list() {
@@ -2734,7 +2366,7 @@ var EllipsisUserTokens = class {
    * Required permissions: delete:user.
    * API key: Requires a CLI user token.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async revoke(token_id) {
@@ -2763,7 +2395,7 @@ var EllipsisVmExecutions = class {
    * Required permissions: read:environments.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own sandbox.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own sandbox.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async get(vm_execution_id) {
@@ -2776,7 +2408,7 @@ var EllipsisVmExecutions = class {
    * Required permissions: read:environments.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own sandbox.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own sandbox.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async list() {
@@ -2789,7 +2421,7 @@ var EllipsisVmExecutions = class {
    * Required permissions: read:environments.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own sandbox.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own sandbox.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async streamTicket(vm_execution_id) {
@@ -2810,7 +2442,7 @@ var EllipsisVmImages = class {
    * Required permissions: read:environments.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async get(image_id) {
@@ -2827,7 +2459,7 @@ var EllipsisVmImages = class {
    * Required permissions: read:environments.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async list(options = {}) {
@@ -2849,7 +2481,7 @@ var EllipsisVms = class {
    * Required permissions: read:environments.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own VM.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own VM.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async get(vm_id) {
@@ -2866,7 +2498,7 @@ var EllipsisVms = class {
    * Required permissions: read:environments.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own VM.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own VM.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async list(options = {}) {
@@ -2874,6 +2506,24 @@ var EllipsisVms = class {
     const query = buildQuery({ limit: options.limit, offset: options.offset });
     return await this.transport.request("GET", path, { query });
   }
+  /**
+   * List Vm Metrics
+   *
+   * List a VM's CPU, memory, swap, and disk readings, oldest first.
+   *
+   * A reading is taken every 5 seconds while a session runs on the VM.
+   *
+   * Required permissions: read:environments.
+   * API key: Supported.
+   * CLI user token: Supported.
+   * Session token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration. Only the token's own VM.
+   * Higher permission levels include lower levels: read < write < delete.
+   */
+  async metrics(vm_id, options = {}) {
+    const path = `/v1/vms/${enc(vm_id)}/metrics`;
+    const query = buildQuery({ start: options.start, end: options.end });
+    return await this.transport.request("GET", path, { query });
+  }
 };
 var EllipsisWebhooksDeliveries = class {
   constructor(transport) {
@@ -2891,7 +2541,7 @@ var EllipsisWebhooksDeliveries = class {
    * Required permissions: read:webhooks.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async get(delivery_id) {
@@ -2909,7 +2559,7 @@ var EllipsisWebhooksDeliveries = class {
    * Required permissions: read:webhooks.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async list(options = {}) {
@@ -2943,7 +2593,7 @@ var EllipsisWebhooks = class {
    * Required permissions: write:webhooks.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async create(options) {
@@ -2962,7 +2612,7 @@ var EllipsisWebhooks = class {
    * Required permissions: delete:webhooks.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async delete(webhook_id) {
@@ -2977,7 +2627,7 @@ var EllipsisWebhooks = class {
    * Required permissions: read:webhooks.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async get(webhook_id) {
@@ -2992,7 +2642,7 @@ var EllipsisWebhooks = class {
    * Required permissions: read:webhooks.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async list() {
@@ -3012,7 +2662,7 @@ var EllipsisWebhooks = class {
    * Required permissions: write:webhooks.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async ping(webhook_id) {
@@ -3031,7 +2681,7 @@ var EllipsisWebhooks = class {
    * Required permissions: write:webhooks.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Not supported by sandbox tokens, even with permissions.ellipsis enabled.
+   * Session token: Not supported by session tokens, even with permissions.ellipsis enabled.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async update(webhook_id, options) {
@@ -3048,10 +2698,8 @@ var Ellipsis = class {
   analytics;
   auth;
   environments;
-  files;
   handlers;
   integrations;
-  memories;
   reviews;
   secrets;
   sessions;
@@ -3070,10 +2718,8 @@ var Ellipsis = class {
     this.analytics = new EllipsisAnalytics(this.transport);
     this.auth = new EllipsisAuth(this.transport);
     this.environments = new EllipsisEnvironments(this.transport);
-    this.files = new EllipsisFiles(this.transport);
     this.handlers = new EllipsisHandlers(this.transport);
     this.integrations = new EllipsisIntegrations(this.transport);
-    this.memories = new EllipsisMemories(this.transport);
     this.reviews = new EllipsisReviews(this.transport);
     this.secrets = new EllipsisSecrets(this.transport);
     this.sessions = new EllipsisSessions(this.transport);
@@ -3090,10 +2736,12 @@ var Ellipsis = class {
    *
    * Return the identity behind the caller's credential.
    *
-   * Required permissions: read:account.
+   * Any valid credential may call this; no permission grant is needed.
+   *
+   * Required permissions: none; any valid credential.
    * API key: Supported.
    * CLI user token: Supported.
-   * Sandbox token: Requires the ellipsis:api scope and the required grants in the token's permissions.ellipsis configuration.
+   * Session token: Requires the ellipsis:api scope; no permissions.ellipsis grant is needed.
    * Higher permission levels include lower levels: read < write < delete.
    */
   async identity() {
@@ -3114,9 +2762,8 @@ export {
   RateLimitError,
   ServerError,
   SessionHandle,
-  TERMINAL_STATUSES,
   Transport,
   TransportError,
   UnprocessableError,
-  isSettled
+  isTurnFinal
 };