@athenaintel/sdk 4.3.2166 → 4.3.2168

package/dist/esm/api/resources/aop/client/Client.mjs

@@ -20,7 +20,7 @@ var __rest = (this && this.__rest) || function (s, e) {
     return t;
 };
 import { normalizeClientOptionsWithAuth } from "../../../../BaseClient.mjs";
-import { mergeHeaders } from "../../../../core/headers.mjs";
+import { mergeHeaders, mergeOnlyDefinedHeaders } from "../../../../core/headers.mjs";
 import * as core from "../../../../core/index.mjs";
 import * as environments from "../../../../environments.mjs";
 import * as errors from "../../../../errors/index.mjs";
@@ -29,6 +29,100 @@ export class AopClient {
     constructor(options = {}) {
         this._options = normalizeClientOptionsWithAuth(options);
     }
+    /**
+     * Aggregate lifecycle status of every run launched under a batch handle from `POST /aop/execute-batch`: counts per canonical run status, an `is_complete` flag, and a cursor-paged list of runs. Poll this once per batch instead of `GET /threads/{thread_id}/status` per thread; fetch a run's messages from the thread status endpoint only once it is terminal. This read never loads transcripts.
+     *
+     * @param {AthenaIntelligence.GetBatchStatusAopRequest} request
+     * @param {AopClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.BadRequestError}
+     * @throws {@link AthenaIntelligence.UnauthorizedError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     *
+     * @example
+     *     await client.aop.getBatchStatus({
+     *         batch_id: "batch_0f4c3c3e-1c1a-4a3e-9a5f-0d3f1a2b3c4d",
+     *         status: "terminal",
+     *         limit: 200
+     *     })
+     */
+    getBatchStatus(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getBatchStatus(request, requestOptions));
+    }
+    __getBatchStatus(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const { batch_id: batchId, status, cursor, limit } = request;
+            const _queryParams = {};
+            if (status != null) {
+                _queryParams.status = status;
+            }
+            if (cursor !== undefined) {
+                _queryParams.cursor = cursor;
+            }
+            if (limit != null) {
+                _queryParams.limit = limit.toString();
+            }
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.AthenaIntelligenceEnvironment.Production, `api/v0/aop/batches/${core.url.encodePathParam(batchId)}`),
+                method: "GET",
+                headers: _headers,
+                queryParameters: Object.assign(Object.assign({}, _queryParams), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams),
+                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new AthenaIntelligence.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new AthenaIntelligence.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new AthenaIntelligence.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new AthenaIntelligence.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.AthenaIntelligenceError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "body-is-null":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling GET /api/v0/aop/batches/{batch_id}.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Create a new AOP (Agent Operating Procedure) asset with the given configuration. The created AOP can then be executed via /aop/execute-async, inspected via /aop/{asset_id}/config, and updated via PUT /aop/{asset_id}/config. Use [[ placeholder ]] syntax in the prompt for user inputs supplied at execution time.
      *
@@ -219,40 +313,148 @@ export class AopClient {
         });
     }
     /**
-     * Start execution of an Agent Operating Procedure (AOP) asset asynchronously. Returns immediately with a thread_id for tracking execution progress without waiting for completion.
+     * Start execution of an Agent Operating Procedure (AOP) asset asynchronously. Returns immediately with a thread_id for tracking execution progress without waiting for completion. Send an `Idempotency-Key` header to make the launch safe to retry: if the response is lost, repeating the identical request with the same key returns the original `thread_id` (with `deduplicated: true`) instead of starting a second run. Keys are private to your account; reusing a key with different parameters is rejected with 422, and a retry that races the first attempt gets 409.
      *
-     * @param {AthenaIntelligence.AopExecuteRequestIn} request
+     * @param {AthenaIntelligence.ExecuteAsyncAopRequest} request
      * @param {AopClient.RequestOptions} requestOptions - Request-specific configuration.
      *
      * @throws {@link AthenaIntelligence.BadRequestError}
      * @throws {@link AthenaIntelligence.UnauthorizedError}
      * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.ConflictError}
      * @throws {@link AthenaIntelligence.UnprocessableEntityError}
      * @throws {@link AthenaIntelligence.InternalServerError}
      *
      * @example
      *     await client.aop.executeAsync({
+     *         body: {
+     *             asset_id: "asset_9249292-d118-42d3-95b4-00eccfe0754f",
+     *             run_budget: {
+     *                 max_cost_usd: 30,
+     *                 max_model_calls: 80
+     *             },
+     *             user_inputs: {
+     *                 "company": "Acme Corp",
+     *                 "quarter": "Q1 2024"
+     *             }
+     *         }
+     *     })
+     */
+    executeAsync(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__executeAsync(request, requestOptions));
+    }
+    __executeAsync(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const { "Idempotency-Key": idempotencyKey, body: _body } = request;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, mergeOnlyDefinedHeaders({ "Idempotency-Key": idempotencyKey !== undefined ? idempotencyKey : undefined }), requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.AthenaIntelligenceEnvironment.Production, "api/v0/aop/execute-async"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: _body,
+                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 400:
+                        throw new AthenaIntelligence.BadRequestError(_response.error.body, _response.rawResponse);
+                    case 401:
+                        throw new AthenaIntelligence.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 404:
+                        throw new AthenaIntelligence.NotFoundError(_response.error.body, _response.rawResponse);
+                    case 409:
+                        throw new AthenaIntelligence.ConflictError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new AthenaIntelligence.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new AthenaIntelligence.InternalServerError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.AthenaIntelligenceError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "body-is-null":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling POST /api/v0/aop/execute-async.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
+    /**
+     * Start many Agent Operating Procedure (AOP) runs under one batch handle. Each run is queued exactly like `POST /aop/execute-async`; the response returns a `batch_id` so the caller polls `GET /aop/batches/{batch_id}` once per batch instead of once per thread. Pass the `batch_id` back to append more runs to the same batch. Runs are launched independently: a run that fails to launch is reported with an error and does not stop the others. Runs are idempotent within a batch: a run whose `idempotency_key` (or, when omitted, `client_ref`) was already launched into the same batch with the same parameters is not started again; its original outcome is replayed with `deduplicated: true`.
+     *
+     * @param {AthenaIntelligence.AopBatchExecuteRequestIn} request
+     * @param {AopClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.BadRequestError}
+     * @throws {@link AthenaIntelligence.UnauthorizedError}
+     * @throws {@link AthenaIntelligence.NotFoundError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     * @throws {@link AthenaIntelligence.InternalServerError}
+     *
+     * @example
+     *     await client.aop.executeBatch({
      *         asset_id: "asset_9249292-d118-42d3-95b4-00eccfe0754f",
      *         run_budget: {
      *             max_cost_usd: 30,
      *             max_model_calls: 80
      *         },
-     *         user_inputs: {
-     *             "company": "Acme Corp",
-     *             "quarter": "Q1 2024"
-     *         }
+     *         runs: [{
+     *                 client_ref: "row-1",
+     *                 user_inputs: {
+     *                     "company": "Acme Corp"
+     *                 }
+     *             }, {
+     *                 client_ref: "row-2",
+     *                 user_inputs: {
+     *                     "company": "Globex"
+     *                 }
+     *             }]
      *     })
      */
-    executeAsync(request, requestOptions) {
-        return core.HttpResponsePromise.fromPromise(this.__executeAsync(request, requestOptions));
+    executeBatch(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__executeBatch(request, requestOptions));
     }
-    __executeAsync(request, requestOptions) {
+    __executeBatch(request, requestOptions) {
         return __awaiter(this, void 0, void 0, function* () {
             var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
             const _authRequest = yield this._options.authProvider.getAuthRequest();
             const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
             const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
-                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.AthenaIntelligenceEnvironment.Production, "api/v0/aop/execute-async"),
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.AthenaIntelligenceEnvironment.Production, "api/v0/aop/execute-batch"),
                 method: "POST",
                 headers: _headers,
                 contentType: "application/json",
@@ -304,7 +506,7 @@ export class AopClient {
                         rawResponse: _response.rawResponse,
                     });
                 case "timeout":
-                    throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling POST /api/v0/aop/execute-async.");
+                    throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling POST /api/v0/aop/execute-batch.");
                 case "unknown":
                     throw new errors.AthenaIntelligenceError({
                         message: _response.error.errorMessage,

package/dist/esm/api/resources/aop/client/requests/AopBatchExecuteRequestIn.d.mts

@@ -0,0 +1,34 @@
+import type * as AthenaIntelligence from "../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         asset_id: "asset_9249292-d118-42d3-95b4-00eccfe0754f",
+ *         run_budget: {
+ *             max_cost_usd: 30,
+ *             max_model_calls: 80
+ *         },
+ *         runs: [{
+ *                 client_ref: "row-1",
+ *                 user_inputs: {
+ *                     "company": "Acme Corp"
+ *                 }
+ *             }, {
+ *                 client_ref: "row-2",
+ *                 user_inputs: {
+ *                     "company": "Globex"
+ *                 }
+ *             }]
+ *     }
+ */
+export interface AopBatchExecuteRequestIn {
+    /** Default AOP asset ID for runs that omit their own `asset_id` */
+    asset_id?: string | null;
+    /** Existing batch to append these runs to (returned by a previous execute-batch call). Omit to start a new batch. */
+    batch_id?: string | null;
+    /** Execute every run in dry-run mode: side-effectful tool calls are validated and captured instead of executed. */
+    dry_run?: boolean;
+    /** Per-run spend cap (max_model_calls / max_cost_usd) applied to every run in the request. */
+    run_budget?: AthenaIntelligence.RunBudget | null;
+    /** Runs to launch (1-100 per request). Launch more into the same batch by repeating the call with the returned `batch_id`. */
+    runs: AthenaIntelligence.AopBatchRunIn[];
+}

package/dist/esm/api/resources/aop/client/requests/AopBatchExecuteRequestIn.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/aop/client/requests/ExecuteAsyncAopRequest.d.mts

@@ -0,0 +1,22 @@
+import type * as AthenaIntelligence from "../../../../index.mjs";
+/**
+ * @example
+ *     {
+ *         body: {
+ *             asset_id: "asset_9249292-d118-42d3-95b4-00eccfe0754f",
+ *             run_budget: {
+ *                 max_cost_usd: 30,
+ *                 max_model_calls: 80
+ *             },
+ *             user_inputs: {
+ *                 "company": "Acme Corp",
+ *                 "quarter": "Q1 2024"
+ *             }
+ *         }
+ *     }
+ */
+export interface ExecuteAsyncAopRequest {
+    /** Optional caller-chosen key that makes this launch safe to retry. Repeating the identical request with the same key replays the original response instead of starting another run. */
+    "Idempotency-Key"?: string | null;
+    body: AthenaIntelligence.AopExecuteRequestIn;
+}

package/dist/esm/api/resources/aop/client/requests/ExecuteAsyncAopRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/aop/client/requests/GetBatchStatusAopRequest.d.mts

@@ -0,0 +1,18 @@
+/**
+ * @example
+ *     {
+ *         batch_id: "batch_0f4c3c3e-1c1a-4a3e-9a5f-0d3f1a2b3c4d",
+ *         status: "terminal",
+ *         limit: 200
+ *     }
+ */
+export interface GetBatchStatusAopRequest {
+    /** Batch handle returned by execute-batch */
+    batch_id: string;
+    /** Which runs to list: `terminal` (completed/failed/canceled), `active` (everything else) or `all`. Counts always cover the whole batch. */
+    status?: string;
+    /** `next_cursor` from the previous page */
+    cursor?: string | null;
+    /** Maximum runs to return in this page */
+    limit?: number;
+}

package/dist/esm/api/resources/aop/client/requests/GetBatchStatusAopRequest.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/aop/client/requests/index.d.mts

@@ -1,3 +1,6 @@
+export type { AopBatchExecuteRequestIn } from "./AopBatchExecuteRequestIn.mjs";
 export type { AopConfigUpdateRequestIn } from "./AopConfigUpdateRequestIn.mjs";
 export type { AopCreateRequestIn } from "./AopCreateRequestIn.mjs";
+export type { ExecuteAsyncAopRequest } from "./ExecuteAsyncAopRequest.mjs";
+export type { GetBatchStatusAopRequest } from "./GetBatchStatusAopRequest.mjs";
 export type { GetConfigAopRequest } from "./GetConfigAopRequest.mjs";

package/dist/esm/api/resources/threads/client/Client.d.mts

@@ -28,6 +28,23 @@ export declare class ThreadsClient {
      */
     batchStopByAssetId(request: AthenaIntelligence.ThreadBatchStopRequest, requestOptions?: ThreadsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.ThreadBatchStopResponseOut>;
     private __batchStopByAssetId;
+    /**
+     * Read the lifecycle status of up to 200 threads in one call, whether they were started by `POST /aop/execute-async` or `POST /aop/execute-batch`. Returns aggregate counts plus one compact entry per thread (status, terminal flag, output availability, timestamps) without loading any messages; fetch results with `GET /threads/{thread_id}/status` once `output_available` is true. Only threads you launched are returned: unknown IDs and other users' threads are listed in `not_found` and are indistinguishable.
+     *
+     * @param {AthenaIntelligence.ThreadStatusBatchRequestIn} request
+     * @param {ThreadsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.UnauthorizedError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     * @throws {@link AthenaIntelligence.InternalServerError}
+     *
+     * @example
+     *     await client.threads.getStatusBatch({
+     *         thread_ids: ["thread_12345-6789-abcd-efgh", "thread_22345-6789-abcd-efgh"]
+     *     })
+     */
+    getStatusBatch(request: AthenaIntelligence.ThreadStatusBatchRequestIn, requestOptions?: ThreadsClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.ThreadStatusBatchResponseOut>;
+    private __getStatusBatch;
     /**
      * Stop multiple running thread executions in a single request. This endpoint accepts thread IDs (the same IDs used with the single-thread stop endpoint). Each thread is stopped independently - failures for individual threads do not affect other threads in the batch.
      *

package/dist/esm/api/resources/threads/client/Client.mjs

@@ -99,6 +99,87 @@ export class ThreadsClient {
             }
         });
     }
+    /**
+     * Read the lifecycle status of up to 200 threads in one call, whether they were started by `POST /aop/execute-async` or `POST /aop/execute-batch`. Returns aggregate counts plus one compact entry per thread (status, terminal flag, output availability, timestamps) without loading any messages; fetch results with `GET /threads/{thread_id}/status` once `output_available` is true. Only threads you launched are returned: unknown IDs and other users' threads are listed in `not_found` and are indistinguishable.
+     *
+     * @param {AthenaIntelligence.ThreadStatusBatchRequestIn} request
+     * @param {ThreadsClient.RequestOptions} requestOptions - Request-specific configuration.
+     *
+     * @throws {@link AthenaIntelligence.UnauthorizedError}
+     * @throws {@link AthenaIntelligence.UnprocessableEntityError}
+     * @throws {@link AthenaIntelligence.InternalServerError}
+     *
+     * @example
+     *     await client.threads.getStatusBatch({
+     *         thread_ids: ["thread_12345-6789-abcd-efgh", "thread_22345-6789-abcd-efgh"]
+     *     })
+     */
+    getStatusBatch(request, requestOptions) {
+        return core.HttpResponsePromise.fromPromise(this.__getStatusBatch(request, requestOptions));
+    }
+    __getStatusBatch(request, requestOptions) {
+        return __awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k;
+            const _authRequest = yield this._options.authProvider.getAuthRequest();
+            const _headers = mergeHeaders(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            const _response = yield ((_b = this._options.fetcher) !== null && _b !== void 0 ? _b : core.fetcher)({
+                url: core.url.join((_d = (_c = (yield core.Supplier.get(this._options.baseUrl))) !== null && _c !== void 0 ? _c : (yield core.Supplier.get(this._options.environment))) !== null && _d !== void 0 ? _d : environments.AthenaIntelligenceEnvironment.Production, "api/v0/threads/status-batch"),
+                method: "POST",
+                headers: _headers,
+                contentType: "application/json",
+                queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
+                requestType: "json",
+                body: request,
+                timeoutMs: ((_g = (_e = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.timeoutInSeconds) !== null && _e !== void 0 ? _e : (_f = this._options) === null || _f === void 0 ? void 0 : _f.timeoutInSeconds) !== null && _g !== void 0 ? _g : 60) * 1000,
+                maxRetries: (_h = requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.maxRetries) !== null && _h !== void 0 ? _h : (_j = this._options) === null || _j === void 0 ? void 0 : _j.maxRetries,
+                abortSignal: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.abortSignal,
+                fetchFn: (_k = this._options) === null || _k === void 0 ? void 0 : _k.fetch,
+                logging: this._options.logging,
+            });
+            if (_response.ok) {
+                return {
+                    data: _response.body,
+                    rawResponse: _response.rawResponse,
+                };
+            }
+            if (_response.error.reason === "status-code") {
+                switch (_response.error.statusCode) {
+                    case 401:
+                        throw new AthenaIntelligence.UnauthorizedError(_response.error.body, _response.rawResponse);
+                    case 422:
+                        throw new AthenaIntelligence.UnprocessableEntityError(_response.error.body, _response.rawResponse);
+                    case 500:
+                        throw new AthenaIntelligence.InternalServerError(_response.error.body, _response.rawResponse);
+                    default:
+                        throw new errors.AthenaIntelligenceError({
+                            statusCode: _response.error.statusCode,
+                            body: _response.error.body,
+                            rawResponse: _response.rawResponse,
+                        });
+                }
+            }
+            switch (_response.error.reason) {
+                case "non-json":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        body: _response.error.rawBody,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "body-is-null":
+                    throw new errors.AthenaIntelligenceError({
+                        statusCode: _response.error.statusCode,
+                        rawResponse: _response.rawResponse,
+                    });
+                case "timeout":
+                    throw new errors.AthenaIntelligenceTimeoutError("Timeout exceeded when calling POST /api/v0/threads/status-batch.");
+                case "unknown":
+                    throw new errors.AthenaIntelligenceError({
+                        message: _response.error.errorMessage,
+                        rawResponse: _response.rawResponse,
+                    });
+            }
+        });
+    }
     /**
      * Stop multiple running thread executions in a single request. This endpoint accepts thread IDs (the same IDs used with the single-thread stop endpoint). Each thread is stopped independently - failures for individual threads do not affect other threads in the batch.
      *

package/dist/esm/api/resources/threads/client/requests/ThreadStatusBatchRequestIn.d.mts

@@ -0,0 +1,10 @@
+/**
+ * @example
+ *     {
+ *         thread_ids: ["thread_12345-6789-abcd-efgh", "thread_22345-6789-abcd-efgh"]
+ *     }
+ */
+export interface ThreadStatusBatchRequestIn {
+    /** Thread IDs to check (1-200 per request), from `POST /aop/execute-async` or `POST /aop/execute-batch`. Duplicates are collapsed. */
+    thread_ids: string[];
+}

package/dist/esm/api/resources/threads/client/requests/ThreadStatusBatchRequestIn.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/resources/threads/client/requests/index.d.mts

@@ -1,2 +1,3 @@
 export type { GetStatusThreadsRequest } from "./GetStatusThreadsRequest.mjs";
 export type { StopThreadsRequest } from "./StopThreadsRequest.mjs";
+export type { ThreadStatusBatchRequestIn } from "./ThreadStatusBatchRequestIn.mjs";

package/dist/esm/api/types/AopAsyncExecuteResponseOut.d.mts

@@ -10,6 +10,8 @@ export interface AopAsyncExecuteResponseOut {
     aop_title: string;
     /** Base prompt of the AOP before user inputs were added */
     base_prompt: string;
+    /** True when this response replays an earlier launch with the same `Idempotency-Key`; no new run was started. */
+    deduplicated?: boolean;
     /** Final prompt used for execution including user inputs */
     final_prompt: string;
     /** Status message about the async execution */

package/dist/esm/api/types/AopBatchExecuteResponseOut.d.mts

@@ -0,0 +1,16 @@
+import type * as AthenaIntelligence from "../index.mjs";
+/**
+ * Response model for launching a batch of AOP runs.
+ */
+export interface AopBatchExecuteResponseOut {
+    /** Batch handle. Poll `GET /aop/batches/{batch_id}` for the whole batch instead of every thread, and pass it back to `POST /aop/execute-batch` to append more runs. Null when a new batch launched no runs: there is nothing to poll or append to, so no handle is issued. */
+    batch_id?: string | null;
+    /** Runs in this request that replayed an earlier launch (same `idempotency_key` / `client_ref` in this batch) instead of starting */
+    deduplicated?: number;
+    /** Runs in this request that could not be launched */
+    failed: number;
+    /** Runs accepted and queued in this request */
+    launched: number;
+    /** Per-run launch outcome, in request order */
+    runs: AthenaIntelligence.AopBatchRunLaunchOut[];
+}

package/dist/esm/api/types/AopBatchExecuteResponseOut.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/AopBatchRunIn.d.mts

@@ -0,0 +1,13 @@
+/**
+ * One AOP run inside an execute-batch request.
+ */
+export interface AopBatchRunIn {
+    /** ID of the AOP asset to execute for this run. Defaults to the batch-level `asset_id` when omitted. */
+    asset_id?: string | null;
+    /** Caller-supplied correlation key (e.g. a row id) echoed back on the run in the batch status response. Unique within a batch: a later run with the same `client_ref` in the same batch is not launched again; its outcome is replayed with `deduplicated: true`. */
+    client_ref?: string | null;
+    /** Optional per-run idempotency key, scoped to your account and the batch. Repeating a run with the same key (and same parameters) replays the original launch outcome instead of starting a duplicate. Defaults to `client_ref` when omitted. */
+    idempotency_key?: string | null;
+    /** Optional user inputs to append to the AOP's prompt as key-value pairs */
+    user_inputs?: Record<string, string | null> | null;
+}

package/dist/esm/api/types/AopBatchRunIn.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/AopBatchRunLaunchOut.d.mts

@@ -0,0 +1,17 @@
+/**
+ * Outcome of launching one run of an execute-batch request.
+ */
+export interface AopBatchRunLaunchOut {
+    /** ID of the AOP asset the run executes */
+    aop_asset_id?: string | null;
+    /** Caller-supplied correlation key from the request */
+    client_ref?: string | null;
+    /** True when this run replays an earlier launch with the same `idempotency_key` / `client_ref` in this batch; no new run was started. */
+    deduplicated?: boolean;
+    /** Why the run could not be launched; null on success */
+    error?: string | null;
+    /** Position of the run in the request's `runs` list */
+    index: number;
+    /** Thread ID of the launched run; null when the launch failed */
+    thread_id?: string | null;
+}

package/dist/esm/api/types/AopBatchRunLaunchOut.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/AopBatchRunStatusOut.d.mts

@@ -0,0 +1,21 @@
+/**
+ * Lifecycle status of one run in a batch (no messages).
+ */
+export interface AopBatchRunStatusOut {
+    /** ID of the AOP asset the run executes */
+    aop_asset_id?: string | null;
+    /** Caller-supplied correlation key from the launch request */
+    client_ref?: string | null;
+    /** ISO timestamp when the run reached a terminal state */
+    completed_at?: string | null;
+    /** When the run was queued */
+    created_at?: string | null;
+    /** Error message when the run failed */
+    error?: string | null;
+    /** True once the run is completed, failed or canceled */
+    is_terminal: boolean;
+    /** Canonical run status: scheduled, queued, running, needs_input, completed, failed or canceled */
+    status: string;
+    /** Thread ID; use `GET /threads/{thread_id}/status` for the result */
+    thread_id: string;
+}

package/dist/esm/api/types/AopBatchRunStatusOut.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};

package/dist/esm/api/types/AopBatchStatusCountsOut.d.mts

@@ -0,0 +1,12 @@
+/**
+ * Run counts of a batch by canonical run status.
+ */
+export interface AopBatchStatusCountsOut {
+    canceled?: number;
+    completed?: number;
+    failed?: number;
+    needs_input?: number;
+    queued?: number;
+    running?: number;
+    scheduled?: number;
+}

package/dist/esm/api/types/AopBatchStatusCountsOut.mjs

@@ -0,0 +1,2 @@
+// This file was auto-generated by Fern from our API Definition.
+export {};