warp-agent-sdk 0.2.0

package/resources/agent/agent.d.ts

@@ -0,0 +1,119 @@
+import { APIResource } from "../../core/resource.js";
+import * as TasksAPI from "./tasks.js";
+import { TaskItem, TaskListParams, TaskListResponse, TaskSourceType, TaskState, Tasks } from "./tasks.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Agent extends APIResource {
+    tasks: TasksAPI.Tasks;
+    /**
+     * Spawn an ambient agent with a prompt and optional configuration. The agent will
+     * be queued for execution and assigned a unique task ID.
+     *
+     * @example
+     * ```ts
+     * const response = await client.agent.run({
+     *   prompt: 'Fix the bug in auth.go',
+     * });
+     * ```
+     */
+    run(body: AgentRunParams, options?: RequestOptions): APIPromise<AgentRunResponse>;
+}
+/**
+ * Configuration for an ambient agent task
+ */
+export interface AmbientAgentConfig {
+    /**
+     * Custom base prompt for the agent
+     */
+    base_prompt?: string;
+    /**
+     * UID of a CloudEnvironment GSO to use
+     */
+    environment_id?: string;
+    /**
+     * Map of MCP server configurations by name
+     */
+    mcp_servers?: {
+        [key: string]: AmbientAgentConfig.McpServers;
+    };
+    /**
+     * LLM model to use (uses workspace default if not specified)
+     */
+    model_id?: string;
+    /**
+     * Config name for searchability and traceability
+     */
+    name?: string;
+}
+export declare namespace AmbientAgentConfig {
+    /**
+     * Configuration for an MCP server. Must have exactly one of: warp_id, command, or
+     * url.
+     */
+    interface McpServers {
+        /**
+         * Stdio transport - command arguments
+         */
+        args?: Array<string>;
+        /**
+         * Stdio transport - command to run
+         */
+        command?: string;
+        /**
+         * Environment variables for the server
+         */
+        env?: {
+            [key: string]: string;
+        };
+        /**
+         * HTTP headers for SSE/HTTP transport
+         */
+        headers?: {
+            [key: string]: string;
+        };
+        /**
+         * SSE/HTTP transport - server URL
+         */
+        url?: string;
+        /**
+         * Reference to a Warp shared MCP server by UUID
+         */
+        warp_id?: string;
+    }
+}
+export interface AgentRunResponse {
+    /**
+     * Current state of the task:
+     *
+     * - QUEUED: Task is waiting to be picked up
+     * - PENDING: Task is being prepared
+     * - CLAIMED: Task has been claimed by a worker
+     * - INPROGRESS: Task is actively being executed
+     * - SUCCEEDED: Task completed successfully
+     * - FAILED: Task failed
+     */
+    state: TasksAPI.TaskState;
+    /**
+     * Unique identifier for the created task
+     */
+    task_id: string;
+}
+export interface AgentRunParams {
+    /**
+     * The prompt/instruction for the agent to execute
+     */
+    prompt: string;
+    /**
+     * Configuration for an ambient agent task
+     */
+    config?: AmbientAgentConfig;
+    /**
+     * Custom title for the task (auto-generated if not provided)
+     */
+    title?: string;
+}
+export declare namespace Agent {
+    export { type AmbientAgentConfig as AmbientAgentConfig, type AgentRunResponse as AgentRunResponse, type AgentRunParams as AgentRunParams, };
+    export { Tasks as Tasks, type TaskItem as TaskItem, type TaskSourceType as TaskSourceType, type TaskState as TaskState, type TaskListResponse as TaskListResponse, type TaskListParams as TaskListParams, };
+}
+//# sourceMappingURL=agent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../src/resources/agent/agent.ts"],"names":[],"mappings":"OAEO,EAAE,WAAW,EAAE;OACf,KAAK,QAAQ;OACb,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAAE,cAAc,EAAE,SAAS,EAAE,KAAK,EAAE;OAChF,EAAE,UAAU,EAAE;OACd,EAAE,cAAc,EAAE;AAEzB,qBAAa,KAAM,SAAQ,WAAW;IACpC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAoC;IAEzD;;;;;;;;;;OAUG;IACH,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,UAAU,CAAC,gBAAgB,CAAC;CAGlF;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;IAExB;;OAEG;IACH,WAAW,CAAC,EAAE;QAAE,CAAC,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAAC,UAAU,CAAA;KAAE,CAAC;IAE/D;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,yBAAiB,kBAAkB,CAAC;IAClC;;;OAGG;IACH,UAAiB,UAAU;QACzB;;WAEG;QACH,IAAI,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;QAErB;;WAEG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;QAEjB;;WAEG;QACH,GAAG,CAAC,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;QAEhC;;WAEG;QACH,OAAO,CAAC,EAAE;YAAE,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAA;SAAE,CAAC;QAEpC;;WAEG;QACH,GAAG,CAAC,EAAE,MAAM,CAAC;QAEb;;WAEG;QACH,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB;CACF;AAED,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;;;OASG;IACH,KAAK,EAAE,QAAQ,CAAC,SAAS,CAAC;IAE1B;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,MAAM,CAAC,EAAE,kBAAkB,CAAC;IAE5B;;OAEG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,MAAM,CAAC,OAAO,WAAW,KAAK,CAAC;IAC7B,OAAO,EACL,KAAK,kBAAkB,IAAI,kBAAkB,EAC7C,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,cAAc,IAAI,cAAc,GACtC,CAAC;IAEF,OAAO,EACL,KAAK,IAAI,KAAK,EACd,KAAK,QAAQ,IAAI,QAAQ,EACzB,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,SAAS,IAAI,SAAS,EAC3B,KAAK,gBAAgB,IAAI,gBAAgB,EACzC,KAAK,cAAc,IAAI,cAAc,GACtC,CAAC;CACH"}

package/resources/agent/agent.js

@@ -0,0 +1,31 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Agent = void 0;
+const tslib_1 = require("../../internal/tslib.js");
+const resource_1 = require("../../core/resource.js");
+const TasksAPI = tslib_1.__importStar(require("./tasks.js"));
+const tasks_1 = require("./tasks.js");
+class Agent extends resource_1.APIResource {
+    constructor() {
+        super(...arguments);
+        this.tasks = new TasksAPI.Tasks(this._client);
+    }
+    /**
+     * Spawn an ambient agent with a prompt and optional configuration. The agent will
+     * be queued for execution and assigned a unique task ID.
+     *
+     * @example
+     * ```ts
+     * const response = await client.agent.run({
+     *   prompt: 'Fix the bug in auth.go',
+     * });
+     * ```
+     */
+    run(body, options) {
+        return this._client.post('/agent/run', { body, ...options });
+    }
+}
+exports.Agent = Agent;
+Agent.Tasks = tasks_1.Tasks;
+//# sourceMappingURL=agent.js.map

package/resources/agent/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../../src/resources/agent/agent.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;;AAEtF,qDAAkD;AAClD,6DAAoC;AACpC,sCAAuG;AAIvG,MAAa,KAAM,SAAQ,sBAAW;IAAtC;;QACE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAgB3D,CAAC;IAdC;;;;;;;;;;OAUG;IACH,GAAG,CAAC,IAAoB,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;CACF;AAjBD,sBAiBC;AA0GD,KAAK,CAAC,KAAK,GAAG,aAAK,CAAC"}

package/resources/agent/agent.mjs

@@ -0,0 +1,26 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import * as TasksAPI from "./tasks.mjs";
+import { Tasks } from "./tasks.mjs";
+export class Agent extends APIResource {
+    constructor() {
+        super(...arguments);
+        this.tasks = new TasksAPI.Tasks(this._client);
+    }
+    /**
+     * Spawn an ambient agent with a prompt and optional configuration. The agent will
+     * be queued for execution and assigned a unique task ID.
+     *
+     * @example
+     * ```ts
+     * const response = await client.agent.run({
+     *   prompt: 'Fix the bug in auth.go',
+     * });
+     * ```
+     */
+    run(body, options) {
+        return this._client.post('/agent/run', { body, ...options });
+    }
+}
+Agent.Tasks = Tasks;
+//# sourceMappingURL=agent.mjs.map

package/resources/agent/agent.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.mjs","sourceRoot":"","sources":["../../src/resources/agent/agent.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,WAAW,EAAE;OACf,KAAK,QAAQ;OACb,EAAyE,KAAK,EAAE;AAIvF,MAAM,OAAO,KAAM,SAAQ,WAAW;IAAtC;;QACE,UAAK,GAAmB,IAAI,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAgB3D,CAAC;IAdC;;;;;;;;;;OAUG;IACH,GAAG,CAAC,IAAoB,EAAE,OAAwB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IAC/D,CAAC;CACF;AA0GD,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC"}

package/resources/agent/index.d.mts

@@ -0,0 +1,3 @@
+export { Agent, type AmbientAgentConfig, type AgentRunResponse, type AgentRunParams } from "./agent.mjs";
+export { Tasks, type TaskItem, type TaskSourceType, type TaskState, type TaskListResponse, type TaskListParams, } from "./tasks.mjs";
+//# sourceMappingURL=index.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../../src/resources/agent/index.ts"],"names":[],"mappings":"OAEO,EAAE,KAAK,EAAE,KAAK,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE;OAC9E,EACL,KAAK,EACL,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB"}

package/resources/agent/index.d.ts

@@ -0,0 +1,3 @@
+export { Agent, type AmbientAgentConfig, type AgentRunResponse, type AgentRunParams } from "./agent.js";
+export { Tasks, type TaskItem, type TaskSourceType, type TaskState, type TaskListResponse, type TaskListParams, } from "./tasks.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/agent/index.ts"],"names":[],"mappings":"OAEO,EAAE,KAAK,EAAE,KAAK,kBAAkB,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE;OAC9E,EACL,KAAK,EACL,KAAK,QAAQ,EACb,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,gBAAgB,EACrB,KAAK,cAAc,GACpB"}

package/resources/agent/index.js

@@ -0,0 +1,9 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tasks = exports.Agent = void 0;
+var agent_1 = require("./agent.js");
+Object.defineProperty(exports, "Agent", { enumerable: true, get: function () { return agent_1.Agent; } });
+var tasks_1 = require("./tasks.js");
+Object.defineProperty(exports, "Tasks", { enumerable: true, get: function () { return tasks_1.Tasks; } });
+//# sourceMappingURL=index.js.map

package/resources/agent/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/resources/agent/index.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,oCAAqG;AAA5F,8FAAA,KAAK,OAAA;AACd,oCAOiB;AANf,8FAAA,KAAK,OAAA"}

package/resources/agent/index.mjs

@@ -0,0 +1,4 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+export { Agent } from "./agent.mjs";
+export { Tasks, } from "./tasks.mjs";
+//# sourceMappingURL=index.mjs.map

package/resources/agent/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../../src/resources/agent/index.ts"],"names":[],"mappings":"AAAA,sFAAsF;OAE/E,EAAE,KAAK,EAAuE;OAC9E,EACL,KAAK,GAMN"}

package/resources/agent/tasks.d.mts

@@ -0,0 +1,183 @@
+import { APIResource } from "../../core/resource.mjs";
+import * as AgentAPI from "./agent.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Tasks extends APIResource {
+    /**
+     * Retrieve detailed information about a specific agent task, including the full
+     * prompt, session link, and resolved configuration.
+     *
+     * @example
+     * ```ts
+     * const taskItem = await client.agent.tasks.retrieve(
+     *   'taskId',
+     * );
+     * ```
+     */
+    retrieve(taskID: string, options?: RequestOptions): APIPromise<TaskItem>;
+    /**
+     * Retrieve a paginated list of agent tasks with optional filtering. Results are
+     * ordered by creation time (newest first).
+     *
+     * @example
+     * ```ts
+     * const tasks = await client.agent.tasks.list();
+     * ```
+     */
+    list(query?: TaskListParams | null | undefined, options?: RequestOptions): APIPromise<TaskListResponse>;
+}
+export interface TaskItem {
+    /**
+     * Timestamp when the task was created (RFC3339)
+     */
+    created_at: string;
+    /**
+     * The prompt/instruction for the agent
+     */
+    prompt: string;
+    /**
+     * Current state of the task:
+     *
+     * - QUEUED: Task is waiting to be picked up
+     * - PENDING: Task is being prepared
+     * - CLAIMED: Task has been claimed by a worker
+     * - INPROGRESS: Task is actively being executed
+     * - SUCCEEDED: Task completed successfully
+     * - FAILED: Task failed
+     */
+    state: TaskState;
+    /**
+     * Unique identifier for the task
+     */
+    task_id: string;
+    /**
+     * Human-readable title for the task
+     */
+    title: string;
+    /**
+     * Timestamp when the task was last updated (RFC3339)
+     */
+    updated_at: string;
+    /**
+     * Configuration for an ambient agent task
+     */
+    agent_config?: AgentAPI.AmbientAgentConfig;
+    creator?: TaskItem.Creator;
+    /**
+     * UUID of the shared session (if available)
+     */
+    session_id?: string;
+    /**
+     * URL to view the agent session
+     */
+    session_link?: string;
+    /**
+     * Source that created the task:
+     *
+     * - LINEAR: Created from Linear integration
+     * - API: Created via the public API
+     * - SLACK: Created from Slack integration
+     * - LOCAL: Created from local CLI/app
+     * - SCHEDULED_AGENT: Created by a scheduled agent
+     */
+    source?: TaskSourceType;
+    status_message?: TaskItem.StatusMessage;
+}
+export declare namespace TaskItem {
+    interface Creator {
+        /**
+         * Type of the creator principal
+         */
+        type?: 'user' | 'service_account';
+        /**
+         * Unique identifier of the creator
+         */
+        uid?: string;
+    }
+    interface StatusMessage {
+        /**
+         * Human-readable status message
+         */
+        message?: string;
+    }
+}
+/**
+ * Source that created the task:
+ *
+ * - LINEAR: Created from Linear integration
+ * - API: Created via the public API
+ * - SLACK: Created from Slack integration
+ * - LOCAL: Created from local CLI/app
+ * - SCHEDULED_AGENT: Created by a scheduled agent
+ */
+export type TaskSourceType = 'LINEAR' | 'API' | 'SLACK' | 'LOCAL' | 'SCHEDULED_AGENT';
+/**
+ * Current state of the task:
+ *
+ * - QUEUED: Task is waiting to be picked up
+ * - PENDING: Task is being prepared
+ * - CLAIMED: Task has been claimed by a worker
+ * - INPROGRESS: Task is actively being executed
+ * - SUCCEEDED: Task completed successfully
+ * - FAILED: Task failed
+ */
+export type TaskState = 'QUEUED' | 'PENDING' | 'CLAIMED' | 'INPROGRESS' | 'SUCCEEDED' | 'FAILED';
+export interface TaskListResponse {
+    page_info: TaskListResponse.PageInfo;
+    tasks: Array<TaskItem>;
+}
+export declare namespace TaskListResponse {
+    interface PageInfo {
+        /**
+         * Whether there are more results available
+         */
+        has_next_page: boolean;
+        /**
+         * Opaque cursor for fetching the next page
+         */
+        next_cursor?: string;
+    }
+}
+export interface TaskListParams {
+    /**
+     * Filter by agent config name
+     */
+    config_name?: string;
+    /**
+     * Filter tasks created after this timestamp (RFC3339 format)
+     */
+    created_after?: string;
+    /**
+     * Filter tasks created before this timestamp (RFC3339 format)
+     */
+    created_before?: string;
+    /**
+     * Filter by creator UID (user or service account)
+     */
+    creator?: string;
+    /**
+     * Pagination cursor from previous response
+     */
+    cursor?: string;
+    /**
+     * Maximum number of tasks to return
+     */
+    limit?: number;
+    /**
+     * Filter by model ID
+     */
+    model_id?: string;
+    /**
+     * Filter by task source type
+     */
+    source?: TaskSourceType;
+    /**
+     * Filter by task state. Can be specified multiple times to match any of the given
+     * states.
+     */
+    state?: Array<TaskState>;
+}
+export declare namespace Tasks {
+    export { type TaskItem as TaskItem, type TaskSourceType as TaskSourceType, type TaskState as TaskState, type TaskListResponse as TaskListResponse, type TaskListParams as TaskListParams, };
+}
+//# sourceMappingURL=tasks.d.mts.map

package/resources/agent/tasks.d.mts.map

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

package/resources/agent/tasks.d.ts

@@ -0,0 +1,183 @@
+import { APIResource } from "../../core/resource.js";
+import * as AgentAPI from "./agent.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Tasks extends APIResource {
+    /**
+     * Retrieve detailed information about a specific agent task, including the full
+     * prompt, session link, and resolved configuration.
+     *
+     * @example
+     * ```ts
+     * const taskItem = await client.agent.tasks.retrieve(
+     *   'taskId',
+     * );
+     * ```
+     */
+    retrieve(taskID: string, options?: RequestOptions): APIPromise<TaskItem>;
+    /**
+     * Retrieve a paginated list of agent tasks with optional filtering. Results are
+     * ordered by creation time (newest first).
+     *
+     * @example
+     * ```ts
+     * const tasks = await client.agent.tasks.list();
+     * ```
+     */
+    list(query?: TaskListParams | null | undefined, options?: RequestOptions): APIPromise<TaskListResponse>;
+}
+export interface TaskItem {
+    /**
+     * Timestamp when the task was created (RFC3339)
+     */
+    created_at: string;
+    /**
+     * The prompt/instruction for the agent
+     */
+    prompt: string;
+    /**
+     * Current state of the task:
+     *
+     * - QUEUED: Task is waiting to be picked up
+     * - PENDING: Task is being prepared
+     * - CLAIMED: Task has been claimed by a worker
+     * - INPROGRESS: Task is actively being executed
+     * - SUCCEEDED: Task completed successfully
+     * - FAILED: Task failed
+     */
+    state: TaskState;
+    /**
+     * Unique identifier for the task
+     */
+    task_id: string;
+    /**
+     * Human-readable title for the task
+     */
+    title: string;
+    /**
+     * Timestamp when the task was last updated (RFC3339)
+     */
+    updated_at: string;
+    /**
+     * Configuration for an ambient agent task
+     */
+    agent_config?: AgentAPI.AmbientAgentConfig;
+    creator?: TaskItem.Creator;
+    /**
+     * UUID of the shared session (if available)
+     */
+    session_id?: string;
+    /**
+     * URL to view the agent session
+     */
+    session_link?: string;
+    /**
+     * Source that created the task:
+     *
+     * - LINEAR: Created from Linear integration
+     * - API: Created via the public API
+     * - SLACK: Created from Slack integration
+     * - LOCAL: Created from local CLI/app
+     * - SCHEDULED_AGENT: Created by a scheduled agent
+     */
+    source?: TaskSourceType;
+    status_message?: TaskItem.StatusMessage;
+}
+export declare namespace TaskItem {
+    interface Creator {
+        /**
+         * Type of the creator principal
+         */
+        type?: 'user' | 'service_account';
+        /**
+         * Unique identifier of the creator
+         */
+        uid?: string;
+    }
+    interface StatusMessage {
+        /**
+         * Human-readable status message
+         */
+        message?: string;
+    }
+}
+/**
+ * Source that created the task:
+ *
+ * - LINEAR: Created from Linear integration
+ * - API: Created via the public API
+ * - SLACK: Created from Slack integration
+ * - LOCAL: Created from local CLI/app
+ * - SCHEDULED_AGENT: Created by a scheduled agent
+ */
+export type TaskSourceType = 'LINEAR' | 'API' | 'SLACK' | 'LOCAL' | 'SCHEDULED_AGENT';
+/**
+ * Current state of the task:
+ *
+ * - QUEUED: Task is waiting to be picked up
+ * - PENDING: Task is being prepared
+ * - CLAIMED: Task has been claimed by a worker
+ * - INPROGRESS: Task is actively being executed
+ * - SUCCEEDED: Task completed successfully
+ * - FAILED: Task failed
+ */
+export type TaskState = 'QUEUED' | 'PENDING' | 'CLAIMED' | 'INPROGRESS' | 'SUCCEEDED' | 'FAILED';
+export interface TaskListResponse {
+    page_info: TaskListResponse.PageInfo;
+    tasks: Array<TaskItem>;
+}
+export declare namespace TaskListResponse {
+    interface PageInfo {
+        /**
+         * Whether there are more results available
+         */
+        has_next_page: boolean;
+        /**
+         * Opaque cursor for fetching the next page
+         */
+        next_cursor?: string;
+    }
+}
+export interface TaskListParams {
+    /**
+     * Filter by agent config name
+     */
+    config_name?: string;
+    /**
+     * Filter tasks created after this timestamp (RFC3339 format)
+     */
+    created_after?: string;
+    /**
+     * Filter tasks created before this timestamp (RFC3339 format)
+     */
+    created_before?: string;
+    /**
+     * Filter by creator UID (user or service account)
+     */
+    creator?: string;
+    /**
+     * Pagination cursor from previous response
+     */
+    cursor?: string;
+    /**
+     * Maximum number of tasks to return
+     */
+    limit?: number;
+    /**
+     * Filter by model ID
+     */
+    model_id?: string;
+    /**
+     * Filter by task source type
+     */
+    source?: TaskSourceType;
+    /**
+     * Filter by task state. Can be specified multiple times to match any of the given
+     * states.
+     */
+    state?: Array<TaskState>;
+}
+export declare namespace Tasks {
+    export { type TaskItem as TaskItem, type TaskSourceType as TaskSourceType, type TaskState as TaskState, type TaskListResponse as TaskListResponse, type TaskListParams as TaskListParams, };
+}
+//# sourceMappingURL=tasks.d.ts.map

package/resources/agent/tasks.d.ts.map

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

package/resources/agent/tasks.js

@@ -0,0 +1,36 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Tasks = void 0;
+const resource_1 = require("../../core/resource.js");
+const path_1 = require("../../internal/utils/path.js");
+class Tasks extends resource_1.APIResource {
+    /**
+     * Retrieve detailed information about a specific agent task, including the full
+     * prompt, session link, and resolved configuration.
+     *
+     * @example
+     * ```ts
+     * const taskItem = await client.agent.tasks.retrieve(
+     *   'taskId',
+     * );
+     * ```
+     */
+    retrieve(taskID, options) {
+        return this._client.get((0, path_1.path) `/agent/tasks/${taskID}`, options);
+    }
+    /**
+     * Retrieve a paginated list of agent tasks with optional filtering. Results are
+     * ordered by creation time (newest first).
+     *
+     * @example
+     * ```ts
+     * const tasks = await client.agent.tasks.list();
+     * ```
+     */
+    list(query = {}, options) {
+        return this._client.get('/agent/tasks', { query, ...options });
+    }
+}
+exports.Tasks = Tasks;
+//# sourceMappingURL=tasks.js.map

package/resources/agent/tasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tasks.js","sourceRoot":"","sources":["../../src/resources/agent/tasks.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAIlD,uDAAiD;AAEjD,MAAa,KAAM,SAAQ,sBAAW;IACpC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,MAAc,EAAE,OAAwB;QAC/C,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,gBAAgB,MAAM,EAAE,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC;IAED;;;;;;;;OAQG;IACH,IAAI,CACF,QAA2C,EAAE,EAC7C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACjE,CAAC;CACF;AA/BD,sBA+BC"}