@athenaintel/sdk 4.3.2166 → 4.3.2168

package/README.md

@@ -61,7 +61,7 @@ following namespace:
 ```typescript
 import { AthenaIntelligence } from "@athenaintel/sdk";
 
-const request: AthenaIntelligence.AopCreateRequestIn = {
+const request: AthenaIntelligence.GetBatchStatusAopRequest = {
     ...
 };
 ```

package/dist/cjs/BaseClient.js

@@ -43,8 +43,8 @@ function normalizeClientOptions(options) {
     const headers = (0, headers_js_1.mergeHeaders)({
         "X-Fern-Language": "JavaScript",
         "X-Fern-SDK-Name": "@athenaintel/sdk",
-        "X-Fern-SDK-Version": "4.3.2166",
-        "User-Agent": "@athenaintel/sdk/4.3.2166",
+        "X-Fern-SDK-Version": "4.3.2168",
+        "User-Agent": "@athenaintel/sdk/4.3.2168",
         "X-Fern-Runtime": core.RUNTIME.type,
         "X-Fern-Runtime-Version": core.RUNTIME.version,
     }, options === null || options === void 0 ? void 0 : options.headers);

package/dist/cjs/api/resources/aop/client/Client.d.ts

@@ -11,6 +11,26 @@ export declare namespace AopClient {
 export declare class AopClient {
     protected readonly _options: NormalizedClientOptionsWithAuth<AopClient.Options>;
     constructor(options?: AopClient.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: AthenaIntelligence.GetBatchStatusAopRequest, requestOptions?: AopClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.AopBatchStatusResponseOut>;
+    private __getBatchStatus;
     /**
      * 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.
      *
@@ -65,32 +85,69 @@ export declare class AopClient {
     execute(request: AthenaIntelligence.AopExecuteRequestIn, requestOptions?: AopClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.AopExecuteResponseOut>;
     private __execute;
     /**
-     * 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: AthenaIntelligence.ExecuteAsyncAopRequest, requestOptions?: AopClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.AopAsyncExecuteResponseOut>;
+    private __executeAsync;
+    /**
+     * 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: AthenaIntelligence.AopExecuteRequestIn, requestOptions?: AopClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.AopAsyncExecuteResponseOut>;
-    private __executeAsync;
+    executeBatch(request: AthenaIntelligence.AopBatchExecuteRequestIn, requestOptions?: AopClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.AopBatchExecuteResponseOut>;
+    private __executeBatch;
     /**
      * Retrieve the full configuration of an AOP asset by its ID. Returns prompt, agent config, structured output schema, and other settings.
      *

package/dist/cjs/api/resources/aop/client/Client.js

@@ -65,6 +65,100 @@ class AopClient {
     constructor(options = {}) {
         this._options = (0, BaseClient_js_1.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 = (0, headers_js_1.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.
      *
@@ -255,40 +349,148 @@ 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 = (0, headers_js_1.mergeHeaders)(_authRequest.headers, (_a = this._options) === null || _a === void 0 ? void 0 : _a.headers, (0, headers_js_1.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 = (0, headers_js_1.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",
@@ -340,7 +542,7 @@ 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/cjs/api/resources/aop/client/requests/AopBatchExecuteRequestIn.d.ts

@@ -0,0 +1,34 @@
+import type * as AthenaIntelligence from "../../../../index.js";
+/**
+ * @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/cjs/api/resources/aop/client/requests/AopBatchExecuteRequestIn.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/aop/client/requests/ExecuteAsyncAopRequest.d.ts

@@ -0,0 +1,22 @@
+import type * as AthenaIntelligence from "../../../../index.js";
+/**
+ * @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/cjs/api/resources/aop/client/requests/ExecuteAsyncAopRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/aop/client/requests/GetBatchStatusAopRequest.d.ts

@@ -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/cjs/api/resources/aop/client/requests/GetBatchStatusAopRequest.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/aop/client/requests/index.d.ts

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

package/dist/cjs/api/resources/threads/client/Client.d.ts

@@ -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/cjs/api/resources/threads/client/Client.js

@@ -135,6 +135,87 @@ 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 = (0, headers_js_1.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/cjs/api/resources/threads/client/requests/ThreadStatusBatchRequestIn.d.ts

@@ -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/cjs/api/resources/threads/client/requests/ThreadStatusBatchRequestIn.js

@@ -0,0 +1,3 @@
+"use strict";
+// This file was auto-generated by Fern from our API Definition.
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/api/resources/threads/client/requests/index.d.ts

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

package/dist/cjs/api/types/AopAsyncExecuteResponseOut.d.ts

@@ -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 */