casedev 0.22.1 → 0.23.0

package/resources/agent/v1/chat.js

@@ -5,6 +5,9 @@ exports.Chat = void 0;
 const resource_1 = require("../../../core/resource.js");
 const headers_1 = require("../../../internal/headers.js");
 const path_1 = require("../../../internal/utils/path.js");
+/**
+ * Create, manage, and execute AI agents with tool access, sandbox environments, and async run workflows
+ */
 class Chat extends resource_1.APIResource {
     /**
      * Creates a persistent OpenCode chat session in a Modal sandbox. Session state is
@@ -39,26 +42,44 @@ class Chat extends resource_1.APIResource {
         });
     }
     /**
-     * Streams a single assistant turn as normalized state events with stable turn,
-     * message, and part ids. Emits session.usage before turn.completed when token data
-     * is available.
+     * Streams a single assistant turn as normalized SSE events with stable turn,
+     * message, and part IDs. Emits events: `turn.started`, `turn.status`,
+     * `message.created`, `message.part.updated`, `message.completed`, `session.usage`,
+     * `turn.completed`.
+     *
+     * **When to use this endpoint:** Recommended for building custom chat UIs that
+     * need real-time streaming progress. This is the primary streaming endpoint for
+     * new integrations.
+     *
+     * **Alternatives:**
+     *
+     * - `POST /chat/:id/message` — synchronous, returns complete response as JSON
+     *   (best for server-to-server)
      */
-    respond(id, params, options) {
-        const { body } = params;
+    respond(id, body, options) {
         return this._client.post((0, path_1.path) `/agent/v1/chat/${id}/respond`, {
-            body: body,
+            body,
             ...options,
             headers: (0, headers_1.buildHeaders)([{ Accept: 'text/event-stream' }, options?.headers]),
             stream: true,
         });
     }
     /**
-     * Proxies a message to the OpenCode session bound to this chat.
+     * Sends a message and returns the complete response as a single JSON body. Blocks
+     * until the agent turn completes.
+     *
+     * **When to use this endpoint:** Best for server-to-server integrations,
+     * background processing, or any context where you want the full response in one
+     * call without managing an SSE stream.
+     *
+     * **Alternatives:**
+     *
+     * - `POST /chat/:id/respond` — streaming SSE with normalized events (recommended
+     *   for custom chat UIs)
      */
-    sendMessage(id, params, options) {
-        const { body } = params;
+    sendMessage(id, body, options) {
         return this._client.post((0, path_1.path) `/agent/v1/chat/${id}/message`, {
-            body: body,
+            body,
             ...options,
             headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
         });
@@ -75,19 +96,6 @@ class Chat extends resource_1.APIResource {
             stream: true,
         });
     }
-    /**
-     * Streams a single assistant turn as AI SDK UIMessageChunk SSE events for direct
-     * client rendering.
-     */
-    uiStream(id, params, options) {
-        const { body } = params;
-        return this._client.post((0, path_1.path) `/agent/v1/chat/${id}/ui-stream`, {
-            body: body,
-            ...options,
-            headers: (0, headers_1.buildHeaders)([{ Accept: 'text/event-stream' }, options?.headers]),
-            stream: true,
-        });
-    }
 }
 exports.Chat = Chat;
 //# sourceMappingURL=chat.js.map

package/resources/agent/v1/chat.js.map

@@ -1 +1 @@
-{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../../src/resources/agent/v1/chat.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"chat.js","sourceRoot":"","sources":["../../../src/resources/agent/v1/chat.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AAGrD,0DAAyD;AAEzD,0DAAoD;AAEpD;;GAEG;AACH,MAAa,IAAK,SAAQ,sBAAW;IACnC;;;OAGG;IACH,MAAM,CACJ,OAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAA,WAAI,EAAA,kBAAkB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,kBAAkB,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IAED;;;OAGG;IACH,eAAe,CACb,SAAiB,EACjB,MAAiC,EACjC,OAAwB;QAExB,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,kBAAkB,EAAE,aAAa,SAAS,QAAQ,EAAE;YAC/E,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,OAAO,CACL,EAAU,EACV,IAAuB,EACvB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,kBAAkB,EAAE,UAAU,EAAE;YAC3D,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1E,MAAM,EAAE,IAAI;SACb,CAA4C,CAAC;IAChD,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,EAAU,EAAE,IAA2B,EAAE,OAAwB;QAC3E,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,kBAAkB,EAAE,UAAU,EAAE;YAC3D,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,MAAM,CACJ,EAAU,EACV,QAAsC,EAAE,EACxC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,kBAAkB,EAAE,SAAS,EAAE;YACzD,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,IAAA,sBAAY,EAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1E,MAAM,EAAE,IAAI;SACb,CAA2C,CAAC;IAC/C,CAAC;CACF;AA7GD,oBA6GC"}

package/resources/agent/v1/chat.mjs

@@ -2,6 +2,9 @@
 import { APIResource } from "../../../core/resource.mjs";
 import { buildHeaders } from "../../../internal/headers.mjs";
 import { path } from "../../../internal/utils/path.mjs";
+/**
+ * Create, manage, and execute AI agents with tool access, sandbox environments, and async run workflows
+ */
 export class Chat extends APIResource {
     /**
      * Creates a persistent OpenCode chat session in a Modal sandbox. Session state is
@@ -36,26 +39,44 @@ export class Chat extends APIResource {
         });
     }
     /**
-     * Streams a single assistant turn as normalized state events with stable turn,
-     * message, and part ids. Emits session.usage before turn.completed when token data
-     * is available.
+     * Streams a single assistant turn as normalized SSE events with stable turn,
+     * message, and part IDs. Emits events: `turn.started`, `turn.status`,
+     * `message.created`, `message.part.updated`, `message.completed`, `session.usage`,
+     * `turn.completed`.
+     *
+     * **When to use this endpoint:** Recommended for building custom chat UIs that
+     * need real-time streaming progress. This is the primary streaming endpoint for
+     * new integrations.
+     *
+     * **Alternatives:**
+     *
+     * - `POST /chat/:id/message` — synchronous, returns complete response as JSON
+     *   (best for server-to-server)
      */
-    respond(id, params, options) {
-        const { body } = params;
+    respond(id, body, options) {
         return this._client.post(path `/agent/v1/chat/${id}/respond`, {
-            body: body,
+            body,
             ...options,
             headers: buildHeaders([{ Accept: 'text/event-stream' }, options?.headers]),
             stream: true,
         });
     }
     /**
-     * Proxies a message to the OpenCode session bound to this chat.
+     * Sends a message and returns the complete response as a single JSON body. Blocks
+     * until the agent turn completes.
+     *
+     * **When to use this endpoint:** Best for server-to-server integrations,
+     * background processing, or any context where you want the full response in one
+     * call without managing an SSE stream.
+     *
+     * **Alternatives:**
+     *
+     * - `POST /chat/:id/respond` — streaming SSE with normalized events (recommended
+     *   for custom chat UIs)
      */
-    sendMessage(id, params, options) {
-        const { body } = params;
+    sendMessage(id, body, options) {
         return this._client.post(path `/agent/v1/chat/${id}/message`, {
-            body: body,
+            body,
             ...options,
             headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
         });
@@ -72,18 +93,5 @@ export class Chat extends APIResource {
             stream: true,
         });
     }
-    /**
-     * Streams a single assistant turn as AI SDK UIMessageChunk SSE events for direct
-     * client rendering.
-     */
-    uiStream(id, params, options) {
-        const { body } = params;
-        return this._client.post(path `/agent/v1/chat/${id}/ui-stream`, {
-            body: body,
-            ...options,
-            headers: buildHeaders([{ Accept: 'text/event-stream' }, options?.headers]),
-            stream: true,
-        });
-    }
 }
 //# sourceMappingURL=chat.mjs.map

package/resources/agent/v1/chat.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"chat.mjs","sourceRoot":"","sources":["../../../src/resources/agent/v1/chat.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"chat.mjs","sourceRoot":"","sources":["../../../src/resources/agent/v1/chat.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OAGf,EAAE,YAAY,EAAE;OAEhB,EAAE,IAAI,EAAE;AAEf;;GAEG;AACH,MAAM,OAAO,IAAK,SAAQ,WAAW;IACnC;;;OAGG;IACH,MAAM,CACJ,OAA4C,EAAE,EAC9C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACnE,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAA,kBAAkB,EAAE,EAAE,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,EAAU,EAAE,OAAwB;QACzC,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,kBAAkB,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;IACvE,CAAC;IAED;;;OAGG;IACH,eAAe,CACb,SAAiB,EACjB,MAAiC,EACjC,OAAwB;QAExB,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QAC/B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,kBAAkB,EAAE,aAAa,SAAS,QAAQ,EAAE;YAC/E,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;;;;OAcG;IACH,OAAO,CACL,EAAU,EACV,IAAuB,EACvB,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,kBAAkB,EAAE,UAAU,EAAE;YAC3D,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1E,MAAM,EAAE,IAAI;SACb,CAA4C,CAAC;IAChD,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,EAAU,EAAE,IAA2B,EAAE,OAAwB;QAC3E,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAA,kBAAkB,EAAE,UAAU,EAAE;YAC3D,IAAI;YACJ,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;SAC7D,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,MAAM,CACJ,EAAU,EACV,QAAsC,EAAE,EACxC,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAA,kBAAkB,EAAE,SAAS,EAAE;YACzD,KAAK;YACL,GAAG,OAAO;YACV,OAAO,EAAE,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;YAC1E,MAAM,EAAE,IAAI;SACb,CAA2C,CAAC;IAC/C,CAAC;CACF"}

package/resources/agent/v1/execute.d.mts

@@ -1,17 +1,28 @@
 import { APIResource } from "../../../core/resource.mjs";
 import { APIPromise } from "../../../core/api-promise.mjs";
 import { RequestOptions } from "../../../internal/request-options.mjs";
+/**
+ * Create, manage, and execute AI agents with tool access, sandbox environments, and async run workflows
+ */
 export declare class Execute extends APIResource {
     /**
      * Creates an ephemeral agent and immediately executes a run. Returns the run ID
      * for polling status and results. This is the fastest way to run an agent without
      * managing agent lifecycle.
+     *
+     * **Ephemeral agent lifecycle:** The agent created by this endpoint is
+     * automatically soft-deleted and its scoped API key revoked when the run completes
+     * (whether it succeeds, fails, or times out). Ephemeral agents do not appear in
+     * GET /agent/v1/agents listings. The returned agentId is valid only for the
+     * duration of the run — do not store it for reuse. For persistent, reusable
+     * agents, use POST /agent/v1/agents instead.
      */
     create(body: ExecuteCreateParams, options?: RequestOptions): APIPromise<ExecuteCreateResponse>;
 }
 export interface ExecuteCreateResponse {
     /**
-     * Ephemeral agent ID (auto-created)
+     * Ephemeral agent ID (auto-created). This agent is soft-deleted when the run
+     * completes and should not be stored for reuse.
      */
     agentId?: string;
     message?: string;
@@ -27,11 +38,13 @@ export interface ExecuteCreateParams {
      */
     prompt: string;
     /**
-     * Denylist of tools the agent cannot use
+     * Denylist of tools the agent cannot use. Mutually exclusive with enabledTools —
+     * set one or the other, not both.
      */
     disabledTools?: Array<string> | null;
     /**
-     * Allowlist of tools the agent can use
+     * Allowlist of tools the agent can use. Mutually exclusive with disabledTools —
+     * set one or the other, not both.
      */
     enabledTools?: Array<string> | null;
     /**

package/resources/agent/v1/execute.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"execute.d.mts","sourceRoot":"","sources":["../../../src/resources/agent/v1/execute.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,qBAAqB,CAAC;CAG/F;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAErC;;OAEG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAEjC;;OAEG;IACH,OAAO,CAAC,EAAE,mBAAmB,CAAC,OAAO,GAAG,IAAI,CAAC;IAE7C;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CACjC;AAED,yBAAiB,mBAAmB,CAAC;IACnC;;OAEG;IACH,UAAiB,OAAO;QACtB;;WAEG;QACH,GAAG,CAAC,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;CACF;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,CAAC;CACH"}
+{"version":3,"file":"execute.d.mts","sourceRoot":"","sources":["../../../src/resources/agent/v1/execute.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB;;GAEG;AACH,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,qBAAqB,CAAC;CAG/F;AAED,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAErC;;;OAGG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAEjC;;OAEG;IACH,OAAO,CAAC,EAAE,mBAAmB,CAAC,OAAO,GAAG,IAAI,CAAC;IAE7C;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CACjC;AAED,yBAAiB,mBAAmB,CAAC;IACnC;;OAEG;IACH,UAAiB,OAAO;QACtB;;WAEG;QACH,GAAG,CAAC,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;CACF;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,CAAC;CACH"}

package/resources/agent/v1/execute.d.ts

@@ -1,17 +1,28 @@
 import { APIResource } from "../../../core/resource.js";
 import { APIPromise } from "../../../core/api-promise.js";
 import { RequestOptions } from "../../../internal/request-options.js";
+/**
+ * Create, manage, and execute AI agents with tool access, sandbox environments, and async run workflows
+ */
 export declare class Execute extends APIResource {
     /**
      * Creates an ephemeral agent and immediately executes a run. Returns the run ID
      * for polling status and results. This is the fastest way to run an agent without
      * managing agent lifecycle.
+     *
+     * **Ephemeral agent lifecycle:** The agent created by this endpoint is
+     * automatically soft-deleted and its scoped API key revoked when the run completes
+     * (whether it succeeds, fails, or times out). Ephemeral agents do not appear in
+     * GET /agent/v1/agents listings. The returned agentId is valid only for the
+     * duration of the run — do not store it for reuse. For persistent, reusable
+     * agents, use POST /agent/v1/agents instead.
      */
     create(body: ExecuteCreateParams, options?: RequestOptions): APIPromise<ExecuteCreateResponse>;
 }
 export interface ExecuteCreateResponse {
     /**
-     * Ephemeral agent ID (auto-created)
+     * Ephemeral agent ID (auto-created). This agent is soft-deleted when the run
+     * completes and should not be stored for reuse.
      */
     agentId?: string;
     message?: string;
@@ -27,11 +38,13 @@ export interface ExecuteCreateParams {
      */
     prompt: string;
     /**
-     * Denylist of tools the agent cannot use
+     * Denylist of tools the agent cannot use. Mutually exclusive with enabledTools —
+     * set one or the other, not both.
      */
     disabledTools?: Array<string> | null;
     /**
-     * Allowlist of tools the agent can use
+     * Allowlist of tools the agent can use. Mutually exclusive with disabledTools —
+     * set one or the other, not both.
      */
     enabledTools?: Array<string> | null;
     /**

package/resources/agent/v1/execute.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/resources/agent/v1/execute.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,qBAAqB,CAAC;CAG/F;AAED,MAAM,WAAW,qBAAqB;IACpC;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAErC;;OAEG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAEjC;;OAEG;IACH,OAAO,CAAC,EAAE,mBAAmB,CAAC,OAAO,GAAG,IAAI,CAAC;IAE7C;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CACjC;AAED,yBAAiB,mBAAmB,CAAC;IACnC;;OAEG;IACH,UAAiB,OAAO;QACtB;;WAEG;QACH,GAAG,CAAC,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;CACF;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,CAAC;CACH"}
+{"version":3,"file":"execute.d.ts","sourceRoot":"","sources":["../../../src/resources/agent/v1/execute.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB;;GAEG;AACH,qBAAa,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAI,EAAE,mBAAmB,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,qBAAqB,CAAC;CAG/F;AAED,MAAM,WAAW,qBAAqB;IACpC;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,MAAM,CAAC,EAAE,SAAS,CAAC;CACpB;AAED,MAAM,WAAW,mBAAmB;IAClC;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,aAAa,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAErC;;;OAGG;IACH,YAAY,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAEpC;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAEzB;;;OAGG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;OAGG;IACH,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IAEjC;;OAEG;IACH,OAAO,CAAC,EAAE,mBAAmB,CAAC,OAAO,GAAG,IAAI,CAAC;IAE7C;;OAEG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CACjC;AAED,yBAAiB,mBAAmB,CAAC;IACnC;;OAEG;IACH,UAAiB,OAAO;QACtB;;WAEG;QACH,GAAG,CAAC,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB;CACF;AAED,MAAM,CAAC,OAAO,WAAW,OAAO,CAAC;IAC/B,OAAO,EACL,KAAK,qBAAqB,IAAI,qBAAqB,EACnD,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,CAAC;CACH"}

package/resources/agent/v1/execute.js

@@ -3,11 +3,21 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Execute = void 0;
 const resource_1 = require("../../../core/resource.js");
+/**
+ * Create, manage, and execute AI agents with tool access, sandbox environments, and async run workflows
+ */
 class Execute extends resource_1.APIResource {
     /**
      * Creates an ephemeral agent and immediately executes a run. Returns the run ID
      * for polling status and results. This is the fastest way to run an agent without
      * managing agent lifecycle.
+     *
+     * **Ephemeral agent lifecycle:** The agent created by this endpoint is
+     * automatically soft-deleted and its scoped API key revoked when the run completes
+     * (whether it succeeds, fails, or times out). Ephemeral agents do not appear in
+     * GET /agent/v1/agents listings. The returned agentId is valid only for the
+     * duration of the run — do not store it for reuse. For persistent, reusable
+     * agents, use POST /agent/v1/agents instead.
      */
     create(body, options) {
         return this._client.post('/agent/v1/execute', { body, ...options });

package/resources/agent/v1/execute.js.map

@@ -1 +1 @@
-{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../../src/resources/agent/v1/execute.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AAIrD,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;;;OAIG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;CACF;AATD,0BASC"}
+{"version":3,"file":"execute.js","sourceRoot":"","sources":["../../../src/resources/agent/v1/execute.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,wDAAqD;AAIrD;;GAEG;AACH,MAAa,OAAQ,SAAQ,sBAAW;IACtC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;CACF;AAhBD,0BAgBC"}

package/resources/agent/v1/execute.mjs

@@ -1,10 +1,20 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 import { APIResource } from "../../../core/resource.mjs";
+/**
+ * Create, manage, and execute AI agents with tool access, sandbox environments, and async run workflows
+ */
 export class Execute extends APIResource {
     /**
      * Creates an ephemeral agent and immediately executes a run. Returns the run ID
      * for polling status and results. This is the fastest way to run an agent without
      * managing agent lifecycle.
+     *
+     * **Ephemeral agent lifecycle:** The agent created by this endpoint is
+     * automatically soft-deleted and its scoped API key revoked when the run completes
+     * (whether it succeeds, fails, or times out). Ephemeral agents do not appear in
+     * GET /agent/v1/agents listings. The returned agentId is valid only for the
+     * duration of the run — do not store it for reuse. For persistent, reusable
+     * agents, use POST /agent/v1/agents instead.
      */
     create(body, options) {
         return this._client.post('/agent/v1/execute', { body, ...options });

package/resources/agent/v1/execute.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"execute.mjs","sourceRoot":"","sources":["../../../src/resources/agent/v1/execute.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAItB,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC;;;;OAIG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;CACF"}
+{"version":3,"file":"execute.mjs","sourceRoot":"","sources":["../../../src/resources/agent/v1/execute.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;AAItB;;GAEG;AACH,MAAM,OAAO,OAAQ,SAAQ,WAAW;IACtC;;;;;;;;;;;OAWG;IACH,MAAM,CAAC,IAAyB,EAAE,OAAwB;QACxD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACtE,CAAC;CACF"}

package/resources/agent/v1/index.d.mts

@@ -1,6 +1,6 @@
-export { Agents, type AgentCreateResponse, type AgentRetrieveResponse, type AgentUpdateResponse, type AgentListResponse, type AgentDeleteResponse, type AgentCreateParams, type AgentUpdateParams, } from "./agents.mjs";
-export { Chat, type ChatCreateResponse, type ChatDeleteResponse, type ChatCancelResponse, type ChatRespondResponse, type ChatStreamResponse, type ChatUiStreamResponse, type ChatCreateParams, type ChatReplyToQuestionParams, type ChatRespondParams, type ChatSendMessageParams, type ChatStreamParams, type ChatUiStreamParams, } from "./chat.mjs";
+export { Agents, type AgentCreateResponse, type AgentRetrieveResponse, type AgentUpdateResponse, type AgentListResponse, type AgentDeleteResponse, type AgentCreateParams, type AgentUpdateParams, type AgentListParams, } from "./agents.mjs";
+export { Chat, type ChatCreateResponse, type ChatDeleteResponse, type ChatCancelResponse, type ChatRespondResponse, type ChatStreamResponse, type ChatCreateParams, type ChatReplyToQuestionParams, type ChatRespondParams, type ChatSendMessageParams, type ChatStreamParams, } from "./chat.mjs";
 export { Execute, type ExecuteCreateResponse, type ExecuteCreateParams } from "./execute.mjs";
-export { Run, type RunCreateResponse, type RunCancelResponse, type RunEventsResponse, type RunExecResponse, type RunGetDetailsResponse, type RunGetStatusResponse, type RunWatchResponse, type RunCreateParams, type RunEventsParams, type RunWatchParams, } from "./run.mjs";
+export { Run, type RunCreateResponse, type RunListResponse, type RunCancelResponse, type RunEventsResponse, type RunExecResponse, type RunGetDetailsResponse, type RunGetStatusResponse, type RunWatchResponse, type RunCreateParams, type RunListParams, type RunEventsParams, type RunWatchParams, } from "./run.mjs";
 export { V1 } from "./v1.mjs";
 //# sourceMappingURL=index.d.mts.map

package/resources/agent/v1/index.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/resources/agent/v1/index.ts"],"names":[],"mappings":"OAEO,EACL,MAAM,EACN,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB;OACM,EACL,IAAI,EACJ,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB;OACM,EAAE,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,mBAAmB,EAAE;OACjE,EACL,GAAG,EACH,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB;OACM,EAAE,EAAE,EAAE"}
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../../src/resources/agent/v1/index.ts"],"names":[],"mappings":"OAEO,EACL,MAAM,EACN,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB;OACM,EACL,IAAI,EACJ,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB;OACM,EAAE,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,mBAAmB,EAAE;OACjE,EACL,GAAG,EACH,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB;OACM,EAAE,EAAE,EAAE"}

package/resources/agent/v1/index.d.ts

@@ -1,6 +1,6 @@
-export { Agents, type AgentCreateResponse, type AgentRetrieveResponse, type AgentUpdateResponse, type AgentListResponse, type AgentDeleteResponse, type AgentCreateParams, type AgentUpdateParams, } from "./agents.js";
-export { Chat, type ChatCreateResponse, type ChatDeleteResponse, type ChatCancelResponse, type ChatRespondResponse, type ChatStreamResponse, type ChatUiStreamResponse, type ChatCreateParams, type ChatReplyToQuestionParams, type ChatRespondParams, type ChatSendMessageParams, type ChatStreamParams, type ChatUiStreamParams, } from "./chat.js";
+export { Agents, type AgentCreateResponse, type AgentRetrieveResponse, type AgentUpdateResponse, type AgentListResponse, type AgentDeleteResponse, type AgentCreateParams, type AgentUpdateParams, type AgentListParams, } from "./agents.js";
+export { Chat, type ChatCreateResponse, type ChatDeleteResponse, type ChatCancelResponse, type ChatRespondResponse, type ChatStreamResponse, type ChatCreateParams, type ChatReplyToQuestionParams, type ChatRespondParams, type ChatSendMessageParams, type ChatStreamParams, } from "./chat.js";
 export { Execute, type ExecuteCreateResponse, type ExecuteCreateParams } from "./execute.js";
-export { Run, type RunCreateResponse, type RunCancelResponse, type RunEventsResponse, type RunExecResponse, type RunGetDetailsResponse, type RunGetStatusResponse, type RunWatchResponse, type RunCreateParams, type RunEventsParams, type RunWatchParams, } from "./run.js";
+export { Run, type RunCreateResponse, type RunListResponse, type RunCancelResponse, type RunEventsResponse, type RunExecResponse, type RunGetDetailsResponse, type RunGetStatusResponse, type RunWatchResponse, type RunCreateParams, type RunListParams, type RunEventsParams, type RunWatchParams, } from "./run.js";
 export { V1 } from "./v1.js";
 //# sourceMappingURL=index.d.ts.map

package/resources/agent/v1/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resources/agent/v1/index.ts"],"names":[],"mappings":"OAEO,EACL,MAAM,EACN,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,GACvB;OACM,EACL,IAAI,EACJ,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB;OACM,EAAE,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,mBAAmB,EAAE;OACjE,EACL,GAAG,EACH,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB;OACM,EAAE,EAAE,EAAE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/resources/agent/v1/index.ts"],"names":[],"mappings":"OAEO,EACL,MAAM,EACN,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,eAAe,GACrB;OACM,EACL,IAAI,EACJ,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,yBAAyB,EAC9B,KAAK,iBAAiB,EACtB,KAAK,qBAAqB,EAC1B,KAAK,gBAAgB,GACtB;OACM,EAAE,OAAO,EAAE,KAAK,qBAAqB,EAAE,KAAK,mBAAmB,EAAE;OACjE,EACL,GAAG,EACH,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,oBAAoB,EACzB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,cAAc,GACpB;OACM,EAAE,EAAE,EAAE"}

package/resources/agent/v1/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resources/agent/v1/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,sCASkB;AARhB,gGAAA,MAAM,OAAA;AASR,kCAcgB;AAbd,4FAAA,IAAI,OAAA;AAcN,wCAA0F;AAAjF,kGAAA,OAAO,OAAA;AAChB,gCAYe;AAXb,0FAAA,GAAG,OAAA;AAYL,8BAA0B;AAAjB,wFAAA,EAAE,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/resources/agent/v1/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,sCAUkB;AAThB,gGAAA,MAAM,OAAA;AAUR,kCAYgB;AAXd,4FAAA,IAAI,OAAA;AAYN,wCAA0F;AAAjF,kGAAA,OAAO,OAAA;AAChB,gCAce;AAbb,0FAAA,GAAG,OAAA;AAcL,8BAA0B;AAAjB,wFAAA,EAAE,OAAA"}

package/resources/agent/v1/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/resources/agent/v1/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EACL,MAAM,GAQP;OACM,EACL,IAAI,GAaL;OACM,EAAE,OAAO,EAAwD;OACjE,EACL,GAAG,GAWJ;OACM,EAAE,EAAE,EAAE"}
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../../src/resources/agent/v1/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EACL,MAAM,GASP;OACM,EACL,IAAI,GAWL;OACM,EAAE,OAAO,EAAwD;OACjE,EACL,GAAG,GAaJ;OACM,EAAE,EAAE,EAAE"}

package/resources/agent/v1/run.d.mts

@@ -2,12 +2,20 @@ import { APIResource } from "../../../core/resource.mjs";
 import { APIPromise } from "../../../core/api-promise.mjs";
 import { Stream } from "../../../core/streaming.mjs";
 import { RequestOptions } from "../../../internal/request-options.mjs";
+/**
+ * Create, manage, and execute AI agents with tool access, sandbox environments, and async run workflows
+ */
 export declare class Run extends APIResource {
     /**
      * Creates a run in queued state. Call POST /agent/v1/run/:id/exec to start
      * execution.
      */
     create(body: RunCreateParams, options?: RequestOptions): APIPromise<RunCreateResponse>;
+    /**
+     * Lists agent runs for the authenticated organization. Supports filtering by
+     * agent, status, and cursor-based pagination.
+     */
+    list(query?: RunListParams | null | undefined, options?: RequestOptions): APIPromise<RunListResponse>;
     /**
      * Cancels a running or queued run. Idempotent — cancelling a finished run returns
      * its current status.
@@ -45,6 +53,29 @@ export interface RunCreateResponse {
     objectIds?: Array<string> | null;
     status?: 'queued';
 }
+export interface RunListResponse {
+    hasMore?: boolean;
+    /**
+     * Pass as cursor to fetch the next page
+     */
+    nextCursor?: string | null;
+    runs?: Array<RunListResponse.Run>;
+}
+export declare namespace RunListResponse {
+    interface Run {
+        id?: string;
+        agentId?: string;
+        completedAt?: string | null;
+        createdAt?: string;
+        model?: string | null;
+        /**
+         * Truncated to first 200 characters
+         */
+        prompt?: string;
+        startedAt?: string | null;
+        status?: 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
+    }
+}
 export interface RunCancelResponse {
     id?: string;
     /**
@@ -199,6 +230,12 @@ export interface RunCreateParams {
      * Task prompt for the agent
      */
     prompt: string;
+    /**
+     * HTTPS callback URL to receive a notification when the run completes. Registered
+     * atomically with the run — eliminates the race condition of calling /watch after
+     * /exec. Additional watchers can still be added via POST /run/:id/watch.
+     */
+    callbackUrl?: string | null;
     /**
      * Additional guidance for this run
      */
@@ -213,6 +250,25 @@ export interface RunCreateParams {
      */
     objectIds?: Array<string> | null;
 }
+export interface RunListParams {
+    /**
+     * Filter by agent ID
+     */
+    agentId?: string;
+    /**
+     * Pagination cursor (run ID from previous page). Returns runs created before this
+     * run.
+     */
+    cursor?: string;
+    /**
+     * Maximum number of runs to return (default 50, max 250)
+     */
+    limit?: number;
+    /**
+     * Filter by run status
+     */
+    status?: 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
+}
 export interface RunEventsParams {
     /**
      * Replay events after this sequence number
@@ -226,6 +282,6 @@ export interface RunWatchParams {
     callbackUrl: string;
 }
 export declare namespace Run {
-    export { type RunCreateResponse as RunCreateResponse, type RunCancelResponse as RunCancelResponse, type RunEventsResponse as RunEventsResponse, type RunExecResponse as RunExecResponse, type RunGetDetailsResponse as RunGetDetailsResponse, type RunGetStatusResponse as RunGetStatusResponse, type RunWatchResponse as RunWatchResponse, type RunCreateParams as RunCreateParams, type RunEventsParams as RunEventsParams, type RunWatchParams as RunWatchParams, };
+    export { type RunCreateResponse as RunCreateResponse, type RunListResponse as RunListResponse, type RunCancelResponse as RunCancelResponse, type RunEventsResponse as RunEventsResponse, type RunExecResponse as RunExecResponse, type RunGetDetailsResponse as RunGetDetailsResponse, type RunGetStatusResponse as RunGetStatusResponse, type RunWatchResponse as RunWatchResponse, type RunCreateParams as RunCreateParams, type RunListParams as RunListParams, type RunEventsParams as RunEventsParams, type RunWatchParams as RunWatchParams, };
 }
 //# sourceMappingURL=run.d.mts.map

package/resources/agent/v1/run.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"run.d.mts","sourceRoot":"","sources":["../../../src/resources/agent/v1/run.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run.d.mts","sourceRoot":"","sources":["../../../src/resources/agent/v1/run.ts"],"names":[],"mappings":"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"}

package/resources/agent/v1/run.d.ts

@@ -2,12 +2,20 @@ import { APIResource } from "../../../core/resource.js";
 import { APIPromise } from "../../../core/api-promise.js";
 import { Stream } from "../../../core/streaming.js";
 import { RequestOptions } from "../../../internal/request-options.js";
+/**
+ * Create, manage, and execute AI agents with tool access, sandbox environments, and async run workflows
+ */
 export declare class Run extends APIResource {
     /**
      * Creates a run in queued state. Call POST /agent/v1/run/:id/exec to start
      * execution.
      */
     create(body: RunCreateParams, options?: RequestOptions): APIPromise<RunCreateResponse>;
+    /**
+     * Lists agent runs for the authenticated organization. Supports filtering by
+     * agent, status, and cursor-based pagination.
+     */
+    list(query?: RunListParams | null | undefined, options?: RequestOptions): APIPromise<RunListResponse>;
     /**
      * Cancels a running or queued run. Idempotent — cancelling a finished run returns
      * its current status.
@@ -45,6 +53,29 @@ export interface RunCreateResponse {
     objectIds?: Array<string> | null;
     status?: 'queued';
 }
+export interface RunListResponse {
+    hasMore?: boolean;
+    /**
+     * Pass as cursor to fetch the next page
+     */
+    nextCursor?: string | null;
+    runs?: Array<RunListResponse.Run>;
+}
+export declare namespace RunListResponse {
+    interface Run {
+        id?: string;
+        agentId?: string;
+        completedAt?: string | null;
+        createdAt?: string;
+        model?: string | null;
+        /**
+         * Truncated to first 200 characters
+         */
+        prompt?: string;
+        startedAt?: string | null;
+        status?: 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
+    }
+}
 export interface RunCancelResponse {
     id?: string;
     /**
@@ -199,6 +230,12 @@ export interface RunCreateParams {
      * Task prompt for the agent
      */
     prompt: string;
+    /**
+     * HTTPS callback URL to receive a notification when the run completes. Registered
+     * atomically with the run — eliminates the race condition of calling /watch after
+     * /exec. Additional watchers can still be added via POST /run/:id/watch.
+     */
+    callbackUrl?: string | null;
     /**
      * Additional guidance for this run
      */
@@ -213,6 +250,25 @@ export interface RunCreateParams {
      */
     objectIds?: Array<string> | null;
 }
+export interface RunListParams {
+    /**
+     * Filter by agent ID
+     */
+    agentId?: string;
+    /**
+     * Pagination cursor (run ID from previous page). Returns runs created before this
+     * run.
+     */
+    cursor?: string;
+    /**
+     * Maximum number of runs to return (default 50, max 250)
+     */
+    limit?: number;
+    /**
+     * Filter by run status
+     */
+    status?: 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
+}
 export interface RunEventsParams {
     /**
      * Replay events after this sequence number
@@ -226,6 +282,6 @@ export interface RunWatchParams {
     callbackUrl: string;
 }
 export declare namespace Run {
-    export { type RunCreateResponse as RunCreateResponse, type RunCancelResponse as RunCancelResponse, type RunEventsResponse as RunEventsResponse, type RunExecResponse as RunExecResponse, type RunGetDetailsResponse as RunGetDetailsResponse, type RunGetStatusResponse as RunGetStatusResponse, type RunWatchResponse as RunWatchResponse, type RunCreateParams as RunCreateParams, type RunEventsParams as RunEventsParams, type RunWatchParams as RunWatchParams, };
+    export { type RunCreateResponse as RunCreateResponse, type RunListResponse as RunListResponse, type RunCancelResponse as RunCancelResponse, type RunEventsResponse as RunEventsResponse, type RunExecResponse as RunExecResponse, type RunGetDetailsResponse as RunGetDetailsResponse, type RunGetStatusResponse as RunGetStatusResponse, type RunWatchResponse as RunWatchResponse, type RunCreateParams as RunCreateParams, type RunListParams as RunListParams, type RunEventsParams as RunEventsParams, type RunWatchParams as RunWatchParams, };
 }
 //# sourceMappingURL=run.d.ts.map