@nimble-way/nimble-js 0.14.0 → 0.16.0

package/resources/task-agent/runs.d.mts

@@ -0,0 +1,277 @@
+import { APIResource } from "../../core/resource.mjs";
+import { APIPromise } from "../../core/api-promise.mjs";
+import { RequestOptions } from "../../internal/request-options.mjs";
+export declare class Runs extends APIResource {
+    /**
+     * List task runs for the caller's workspace and the given agent, newest first.
+     */
+    list(agentID: string, query?: RunListParams | null | undefined, options?: RequestOptions): APIPromise<RunListResponse>;
+    /**
+     * Cancel an in-progress or queued run.
+     */
+    cancel(runID: string, params: RunCancelParams, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Poll run status. Repeat until status is 'completed', 'failed', or 'cancelled'.
+     */
+    get(runID: string, params: RunGetParams, options?: RequestOptions): APIPromise<RunGetResponse>;
+    /**
+     * Fetch the result for a terminal run. Returns 408 if still active, 422 with
+     * `AgentRunFailedResult` if failed.
+     */
+    getResult(runID: string, params: RunGetResultParams, options?: RequestOptions): APIPromise<RunGetResultResponse>;
+    /**
+     * Server-Sent Events stream of real-time progress events for a run. The run must
+     * have been created with `enable_events=true`.
+     */
+    streamEvents(runID: string, params: RunStreamEventsParams, options?: RequestOptions): APIPromise<unknown>;
+}
+export type RunListResponse = Array<RunListResponse.RunListResponseItem>;
+export declare namespace RunListResponse {
+    interface RunListResponseItem {
+        /**
+         * Run identifier.
+         */
+        id: string;
+        created_at: string;
+        effort: 'quickest' | 'quick' | 'research' | 'pro' | 'max';
+        /**
+         * Interaction ID — pass as previous_interaction_id to reuse context.
+         */
+        interaction_id: string;
+        /**
+         * True while status is 'queued' or 'running'.
+         */
+        is_active: boolean;
+        status: 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
+        completed_at?: string | null;
+        error?: RunListResponseItem.Error | null;
+        prompt?: string | null;
+        started_at?: string | null;
+        /**
+         * Web Search Agent instance this run belongs to.
+         */
+        web_search_agent_id?: string | null;
+        workspace_id?: string | null;
+    }
+    namespace RunListResponseItem {
+        interface Error {
+            /**
+             * Human-readable error description.
+             */
+            message: string;
+            /**
+             * Reference ID (equals the run id).
+             */
+            ref_id: string;
+        }
+    }
+}
+export interface RunGetResponse {
+    /**
+     * Run identifier.
+     */
+    id: string;
+    created_at: string;
+    effort: 'quickest' | 'quick' | 'research' | 'pro' | 'max';
+    /**
+     * Interaction ID — pass as previous_interaction_id to reuse context.
+     */
+    interaction_id: string;
+    /**
+     * True while status is 'queued' or 'running'.
+     */
+    is_active: boolean;
+    status: 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
+    completed_at?: string | null;
+    error?: RunGetResponse.Error | null;
+    prompt?: string | null;
+    started_at?: string | null;
+    /**
+     * Web Search Agent instance this run belongs to.
+     */
+    web_search_agent_id?: string | null;
+    workspace_id?: string | null;
+}
+export declare namespace RunGetResponse {
+    interface Error {
+        /**
+         * Human-readable error description.
+         */
+        message: string;
+        /**
+         * Reference ID (equals the run id).
+         */
+        ref_id: string;
+    }
+}
+export type RunGetResultResponse = RunGetResultResponse.AgentRunResult | RunGetResultResponse.AgentRunFailedResult;
+export declare namespace RunGetResultResponse {
+    interface AgentRunResult {
+        output: AgentRunResult.AgentRunTextOutput | AgentRunResult.AgentRunJsonOutput;
+        run: AgentRunResult.Run;
+    }
+    namespace AgentRunResult {
+        interface AgentRunTextOutput {
+            /**
+             * The final prose answer.
+             */
+            content: string;
+            basis?: Array<AgentRunTextOutput.Basi>;
+            type?: 'text';
+        }
+        namespace AgentRunTextOutput {
+            interface Basi {
+                field: string;
+                citations?: Array<Basi.Citation>;
+                confidence?: 'high' | 'medium' | 'low' | null;
+                reasoning?: string;
+            }
+            namespace Basi {
+                interface Citation {
+                    url: string;
+                    excerpts?: Array<string> | null;
+                    index?: number | null;
+                    title?: string | null;
+                    web_search_agent?: string | null;
+                }
+            }
+        }
+        interface AgentRunJsonOutput {
+            content: {
+                [key: string]: unknown;
+            } | Array<unknown>;
+            basis?: Array<AgentRunJsonOutput.Basi>;
+            type?: 'json';
+        }
+        namespace AgentRunJsonOutput {
+            interface Basi {
+                field: string;
+                citations?: Array<Basi.Citation>;
+                confidence?: 'high' | 'medium' | 'low' | null;
+                reasoning?: string;
+            }
+            namespace Basi {
+                interface Citation {
+                    url: string;
+                    excerpts?: Array<string> | null;
+                    index?: number | null;
+                    title?: string | null;
+                    web_search_agent?: string | null;
+                }
+            }
+        }
+        interface Run {
+            /**
+             * Run identifier.
+             */
+            id: string;
+            created_at: string;
+            effort: 'quickest' | 'quick' | 'research' | 'pro' | 'max';
+            /**
+             * Interaction ID — pass as previous_interaction_id to reuse context.
+             */
+            interaction_id: string;
+            /**
+             * True while status is 'queued' or 'running'.
+             */
+            is_active: boolean;
+            status: 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
+            completed_at?: string | null;
+            error?: Run.Error | null;
+            prompt?: string | null;
+            started_at?: string | null;
+            /**
+             * Web Search Agent instance this run belongs to.
+             */
+            web_search_agent_id?: string | null;
+            workspace_id?: string | null;
+        }
+        namespace Run {
+            interface Error {
+                /**
+                 * Human-readable error description.
+                 */
+                message: string;
+                /**
+                 * Reference ID (equals the run id).
+                 */
+                ref_id: string;
+            }
+        }
+    }
+    interface AgentRunFailedResult {
+        error: AgentRunFailedResult.Error;
+        run: AgentRunFailedResult.Run;
+    }
+    namespace AgentRunFailedResult {
+        interface Error {
+            /**
+             * Human-readable error description.
+             */
+            message: string;
+            /**
+             * Reference ID (equals the run id).
+             */
+            ref_id: string;
+        }
+        interface Run {
+            /**
+             * Run identifier.
+             */
+            id: string;
+            created_at: string;
+            effort: 'quickest' | 'quick' | 'research' | 'pro' | 'max';
+            /**
+             * Interaction ID — pass as previous_interaction_id to reuse context.
+             */
+            interaction_id: string;
+            /**
+             * True while status is 'queued' or 'running'.
+             */
+            is_active: boolean;
+            status: 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
+            completed_at?: string | null;
+            error?: Run.Error | null;
+            prompt?: string | null;
+            started_at?: string | null;
+            /**
+             * Web Search Agent instance this run belongs to.
+             */
+            web_search_agent_id?: string | null;
+            workspace_id?: string | null;
+        }
+        namespace Run {
+            interface Error {
+                /**
+                 * Human-readable error description.
+                 */
+                message: string;
+                /**
+                 * Reference ID (equals the run id).
+                 */
+                ref_id: string;
+            }
+        }
+    }
+}
+export type RunStreamEventsResponse = unknown;
+export interface RunListParams {
+    limit?: number;
+    offset?: number;
+}
+export interface RunCancelParams {
+    agent_id: string;
+}
+export interface RunGetParams {
+    agent_id: string;
+}
+export interface RunGetResultParams {
+    agent_id: string;
+}
+export interface RunStreamEventsParams {
+    agent_id: string;
+}
+export declare namespace Runs {
+    export { type RunListResponse as RunListResponse, type RunGetResponse as RunGetResponse, type RunGetResultResponse as RunGetResultResponse, type RunStreamEventsResponse as RunStreamEventsResponse, type RunListParams as RunListParams, type RunCancelParams as RunCancelParams, type RunGetParams as RunGetParams, type RunGetResultParams as RunGetResultParams, type RunStreamEventsParams as RunStreamEventsParams, };
+}
+//# sourceMappingURL=runs.d.mts.map

package/resources/task-agent/runs.d.mts.map

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

package/resources/task-agent/runs.d.ts

@@ -0,0 +1,277 @@
+import { APIResource } from "../../core/resource.js";
+import { APIPromise } from "../../core/api-promise.js";
+import { RequestOptions } from "../../internal/request-options.js";
+export declare class Runs extends APIResource {
+    /**
+     * List task runs for the caller's workspace and the given agent, newest first.
+     */
+    list(agentID: string, query?: RunListParams | null | undefined, options?: RequestOptions): APIPromise<RunListResponse>;
+    /**
+     * Cancel an in-progress or queued run.
+     */
+    cancel(runID: string, params: RunCancelParams, options?: RequestOptions): APIPromise<void>;
+    /**
+     * Poll run status. Repeat until status is 'completed', 'failed', or 'cancelled'.
+     */
+    get(runID: string, params: RunGetParams, options?: RequestOptions): APIPromise<RunGetResponse>;
+    /**
+     * Fetch the result for a terminal run. Returns 408 if still active, 422 with
+     * `AgentRunFailedResult` if failed.
+     */
+    getResult(runID: string, params: RunGetResultParams, options?: RequestOptions): APIPromise<RunGetResultResponse>;
+    /**
+     * Server-Sent Events stream of real-time progress events for a run. The run must
+     * have been created with `enable_events=true`.
+     */
+    streamEvents(runID: string, params: RunStreamEventsParams, options?: RequestOptions): APIPromise<unknown>;
+}
+export type RunListResponse = Array<RunListResponse.RunListResponseItem>;
+export declare namespace RunListResponse {
+    interface RunListResponseItem {
+        /**
+         * Run identifier.
+         */
+        id: string;
+        created_at: string;
+        effort: 'quickest' | 'quick' | 'research' | 'pro' | 'max';
+        /**
+         * Interaction ID — pass as previous_interaction_id to reuse context.
+         */
+        interaction_id: string;
+        /**
+         * True while status is 'queued' or 'running'.
+         */
+        is_active: boolean;
+        status: 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
+        completed_at?: string | null;
+        error?: RunListResponseItem.Error | null;
+        prompt?: string | null;
+        started_at?: string | null;
+        /**
+         * Web Search Agent instance this run belongs to.
+         */
+        web_search_agent_id?: string | null;
+        workspace_id?: string | null;
+    }
+    namespace RunListResponseItem {
+        interface Error {
+            /**
+             * Human-readable error description.
+             */
+            message: string;
+            /**
+             * Reference ID (equals the run id).
+             */
+            ref_id: string;
+        }
+    }
+}
+export interface RunGetResponse {
+    /**
+     * Run identifier.
+     */
+    id: string;
+    created_at: string;
+    effort: 'quickest' | 'quick' | 'research' | 'pro' | 'max';
+    /**
+     * Interaction ID — pass as previous_interaction_id to reuse context.
+     */
+    interaction_id: string;
+    /**
+     * True while status is 'queued' or 'running'.
+     */
+    is_active: boolean;
+    status: 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
+    completed_at?: string | null;
+    error?: RunGetResponse.Error | null;
+    prompt?: string | null;
+    started_at?: string | null;
+    /**
+     * Web Search Agent instance this run belongs to.
+     */
+    web_search_agent_id?: string | null;
+    workspace_id?: string | null;
+}
+export declare namespace RunGetResponse {
+    interface Error {
+        /**
+         * Human-readable error description.
+         */
+        message: string;
+        /**
+         * Reference ID (equals the run id).
+         */
+        ref_id: string;
+    }
+}
+export type RunGetResultResponse = RunGetResultResponse.AgentRunResult | RunGetResultResponse.AgentRunFailedResult;
+export declare namespace RunGetResultResponse {
+    interface AgentRunResult {
+        output: AgentRunResult.AgentRunTextOutput | AgentRunResult.AgentRunJsonOutput;
+        run: AgentRunResult.Run;
+    }
+    namespace AgentRunResult {
+        interface AgentRunTextOutput {
+            /**
+             * The final prose answer.
+             */
+            content: string;
+            basis?: Array<AgentRunTextOutput.Basi>;
+            type?: 'text';
+        }
+        namespace AgentRunTextOutput {
+            interface Basi {
+                field: string;
+                citations?: Array<Basi.Citation>;
+                confidence?: 'high' | 'medium' | 'low' | null;
+                reasoning?: string;
+            }
+            namespace Basi {
+                interface Citation {
+                    url: string;
+                    excerpts?: Array<string> | null;
+                    index?: number | null;
+                    title?: string | null;
+                    web_search_agent?: string | null;
+                }
+            }
+        }
+        interface AgentRunJsonOutput {
+            content: {
+                [key: string]: unknown;
+            } | Array<unknown>;
+            basis?: Array<AgentRunJsonOutput.Basi>;
+            type?: 'json';
+        }
+        namespace AgentRunJsonOutput {
+            interface Basi {
+                field: string;
+                citations?: Array<Basi.Citation>;
+                confidence?: 'high' | 'medium' | 'low' | null;
+                reasoning?: string;
+            }
+            namespace Basi {
+                interface Citation {
+                    url: string;
+                    excerpts?: Array<string> | null;
+                    index?: number | null;
+                    title?: string | null;
+                    web_search_agent?: string | null;
+                }
+            }
+        }
+        interface Run {
+            /**
+             * Run identifier.
+             */
+            id: string;
+            created_at: string;
+            effort: 'quickest' | 'quick' | 'research' | 'pro' | 'max';
+            /**
+             * Interaction ID — pass as previous_interaction_id to reuse context.
+             */
+            interaction_id: string;
+            /**
+             * True while status is 'queued' or 'running'.
+             */
+            is_active: boolean;
+            status: 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
+            completed_at?: string | null;
+            error?: Run.Error | null;
+            prompt?: string | null;
+            started_at?: string | null;
+            /**
+             * Web Search Agent instance this run belongs to.
+             */
+            web_search_agent_id?: string | null;
+            workspace_id?: string | null;
+        }
+        namespace Run {
+            interface Error {
+                /**
+                 * Human-readable error description.
+                 */
+                message: string;
+                /**
+                 * Reference ID (equals the run id).
+                 */
+                ref_id: string;
+            }
+        }
+    }
+    interface AgentRunFailedResult {
+        error: AgentRunFailedResult.Error;
+        run: AgentRunFailedResult.Run;
+    }
+    namespace AgentRunFailedResult {
+        interface Error {
+            /**
+             * Human-readable error description.
+             */
+            message: string;
+            /**
+             * Reference ID (equals the run id).
+             */
+            ref_id: string;
+        }
+        interface Run {
+            /**
+             * Run identifier.
+             */
+            id: string;
+            created_at: string;
+            effort: 'quickest' | 'quick' | 'research' | 'pro' | 'max';
+            /**
+             * Interaction ID — pass as previous_interaction_id to reuse context.
+             */
+            interaction_id: string;
+            /**
+             * True while status is 'queued' or 'running'.
+             */
+            is_active: boolean;
+            status: 'queued' | 'running' | 'completed' | 'failed' | 'cancelled';
+            completed_at?: string | null;
+            error?: Run.Error | null;
+            prompt?: string | null;
+            started_at?: string | null;
+            /**
+             * Web Search Agent instance this run belongs to.
+             */
+            web_search_agent_id?: string | null;
+            workspace_id?: string | null;
+        }
+        namespace Run {
+            interface Error {
+                /**
+                 * Human-readable error description.
+                 */
+                message: string;
+                /**
+                 * Reference ID (equals the run id).
+                 */
+                ref_id: string;
+            }
+        }
+    }
+}
+export type RunStreamEventsResponse = unknown;
+export interface RunListParams {
+    limit?: number;
+    offset?: number;
+}
+export interface RunCancelParams {
+    agent_id: string;
+}
+export interface RunGetParams {
+    agent_id: string;
+}
+export interface RunGetResultParams {
+    agent_id: string;
+}
+export interface RunStreamEventsParams {
+    agent_id: string;
+}
+export declare namespace Runs {
+    export { type RunListResponse as RunListResponse, type RunGetResponse as RunGetResponse, type RunGetResultResponse as RunGetResultResponse, type RunStreamEventsResponse as RunStreamEventsResponse, type RunListParams as RunListParams, type RunCancelParams as RunCancelParams, type RunGetParams as RunGetParams, type RunGetResultParams as RunGetResultParams, type RunStreamEventsParams as RunStreamEventsParams, };
+}
+//# sourceMappingURL=runs.d.ts.map

package/resources/task-agent/runs.d.ts.map

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

package/resources/task-agent/runs.js

@@ -0,0 +1,50 @@
+"use strict";
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Runs = void 0;
+const resource_1 = require("../../core/resource.js");
+const headers_1 = require("../../internal/headers.js");
+const path_1 = require("../../internal/utils/path.js");
+class Runs extends resource_1.APIResource {
+    /**
+     * List task runs for the caller's workspace and the given agent, newest first.
+     */
+    list(agentID, query = {}, options) {
+        return this._client.get((0, path_1.path) `/v1/task-agents/${agentID}/runs`, { query, ...options });
+    }
+    /**
+     * Cancel an in-progress or queued run.
+     */
+    cancel(runID, params, options) {
+        const { agent_id } = params;
+        return this._client.post((0, path_1.path) `/v1/task-agents/${agent_id}/runs/${runID}/cancel`, {
+            ...options,
+            headers: (0, headers_1.buildHeaders)([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Poll run status. Repeat until status is 'completed', 'failed', or 'cancelled'.
+     */
+    get(runID, params, options) {
+        const { agent_id } = params;
+        return this._client.get((0, path_1.path) `/v1/task-agents/${agent_id}/runs/${runID}`, options);
+    }
+    /**
+     * Fetch the result for a terminal run. Returns 408 if still active, 422 with
+     * `AgentRunFailedResult` if failed.
+     */
+    getResult(runID, params, options) {
+        const { agent_id } = params;
+        return this._client.get((0, path_1.path) `/v1/task-agents/${agent_id}/runs/${runID}/result`, options);
+    }
+    /**
+     * Server-Sent Events stream of real-time progress events for a run. The run must
+     * have been created with `enable_events=true`.
+     */
+    streamEvents(runID, params, options) {
+        const { agent_id } = params;
+        return this._client.get((0, path_1.path) `/v1/task-agents/${agent_id}/runs/${runID}/events`, options);
+    }
+}
+exports.Runs = Runs;
+//# sourceMappingURL=runs.js.map

package/resources/task-agent/runs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runs.js","sourceRoot":"","sources":["../../src/resources/task-agent/runs.ts"],"names":[],"mappings":";AAAA,sFAAsF;;;AAEtF,qDAAkD;AAElD,uDAAsD;AAEtD,uDAAiD;AAEjD,MAAa,IAAK,SAAQ,sBAAW;IACnC;;OAEG;IACH,IAAI,CACF,OAAe,EACf,QAA0C,EAAE,EAC5C,OAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,mBAAmB,OAAO,OAAO,EAAE,EAAE,KAAK,EAAE,GAAG,OAAO,EAAE,CAAC,CAAC;IACxF,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,KAAa,EAAE,MAAuB,EAAE,OAAwB;QACrE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAA,WAAI,EAAA,mBAAmB,QAAQ,SAAS,KAAK,SAAS,EAAE;YAC/E,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;;OAEG;IACH,GAAG,CAAC,KAAa,EAAE,MAAoB,EAAE,OAAwB;QAC/D,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,mBAAmB,QAAQ,SAAS,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;IACpF,CAAC;IAED;;;OAGG;IACH,SAAS,CACP,KAAa,EACb,MAA0B,EAC1B,OAAwB;QAExB,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,mBAAmB,QAAQ,SAAS,KAAK,SAAS,EAAE,OAAO,CAAC,CAAC;IAC3F,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,KAAa,EAAE,MAA6B,EAAE,OAAwB;QACjF,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAC5B,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAA,WAAI,EAAA,mBAAmB,QAAQ,SAAS,KAAK,SAAS,EAAE,OAAO,CAAC,CAAC;IAC3F,CAAC;CACF;AApDD,oBAoDC"}

package/resources/task-agent/runs.mjs

@@ -0,0 +1,46 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+import { APIResource } from "../../core/resource.mjs";
+import { buildHeaders } from "../../internal/headers.mjs";
+import { path } from "../../internal/utils/path.mjs";
+export class Runs extends APIResource {
+    /**
+     * List task runs for the caller's workspace and the given agent, newest first.
+     */
+    list(agentID, query = {}, options) {
+        return this._client.get(path `/v1/task-agents/${agentID}/runs`, { query, ...options });
+    }
+    /**
+     * Cancel an in-progress or queued run.
+     */
+    cancel(runID, params, options) {
+        const { agent_id } = params;
+        return this._client.post(path `/v1/task-agents/${agent_id}/runs/${runID}/cancel`, {
+            ...options,
+            headers: buildHeaders([{ Accept: '*/*' }, options?.headers]),
+        });
+    }
+    /**
+     * Poll run status. Repeat until status is 'completed', 'failed', or 'cancelled'.
+     */
+    get(runID, params, options) {
+        const { agent_id } = params;
+        return this._client.get(path `/v1/task-agents/${agent_id}/runs/${runID}`, options);
+    }
+    /**
+     * Fetch the result for a terminal run. Returns 408 if still active, 422 with
+     * `AgentRunFailedResult` if failed.
+     */
+    getResult(runID, params, options) {
+        const { agent_id } = params;
+        return this._client.get(path `/v1/task-agents/${agent_id}/runs/${runID}/result`, options);
+    }
+    /**
+     * Server-Sent Events stream of real-time progress events for a run. The run must
+     * have been created with `enable_events=true`.
+     */
+    streamEvents(runID, params, options) {
+        const { agent_id } = params;
+        return this._client.get(path `/v1/task-agents/${agent_id}/runs/${runID}/events`, options);
+    }
+}
+//# sourceMappingURL=runs.mjs.map