@athenaintel/sdk 4.3.2167 → 4.3.2169

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.2167",
-        "User-Agent": "@athenaintel/sdk/4.3.2167",
+        "X-Fern-SDK-Version": "4.3.2169",
+        "User-Agent": "@athenaintel/sdk/4.3.2169",
         "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

@@ -85,34 +85,37 @@ 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({
-     *         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"
+     *         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.AopExecuteRequestIn, requestOptions?: AopClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.AopAsyncExecuteResponseOut>;
+    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.
+     * 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.

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

@@ -349,27 +349,30 @@ 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({
-     *         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"
+     *         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"
+     *             }
      *         }
      *     })
      */
@@ -379,8 +382,9 @@ class AopClient {
     __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, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            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",
@@ -388,7 +392,7 @@ class AopClient {
                 contentType: "application/json",
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
                 requestType: "json",
-                body: request,
+                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,
@@ -409,6 +413,8 @@ class AopClient {
                         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:
@@ -444,7 +450,7 @@ class AopClient {
         });
     }
     /**
-     * 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.
+     * 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.

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/index.d.ts

@@ -1,5 +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 */

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

@@ -5,6 +5,8 @@ import type * as AthenaIntelligence from "../index.js";
 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 */

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

@@ -4,8 +4,10 @@
 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. */
+    /** 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/cjs/api/types/AopBatchRunLaunchOut.d.ts

@@ -6,6 +6,8 @@ export interface AopBatchRunLaunchOut {
     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 */

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

@@ -5,6 +5,8 @@ export interface GeneralAgentConfig {
     enabled_tools?: GeneralAgentConfig.EnabledTools.Item[];
     knowledge_base_asset_ids?: string[];
     model?: string | null;
+    /** A JSON Schema (type: object) the agent's final answer must conform to. When set, the response carries the validated payload in `structured_output` and the request fails with a 500 rather than returning prose that does not match the schema. */
+    structured_output?: Record<string, unknown> | null;
     system_prompt?: string;
 }
 export declare namespace GeneralAgentConfig {

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

@@ -4,4 +4,6 @@ import type * as AthenaIntelligence from "../index.js";
  */
 export interface GeneralAgentResponse {
     messages: AthenaIntelligence.GeneralAgentResponseMessage[];
+    /** The agent's final answer as an object matching `config.structured_output`. Null when no schema was requested. */
+    structured_output?: Record<string, unknown> | null;
 }

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

@@ -0,0 +1,27 @@
+/**
+ * Lifecycle status of one thread (no messages).
+ */
+export interface ThreadStatusBatchItemOut {
+    /** ID of the AOP asset the run executes */
+    aop_asset_id?: string | null;
+    /** Batch handle when the thread was launched via execute-batch */
+    batch_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;
+    /** True once the run completed successfully and its result can be read from `GET /threads/{thread_id}/status` */
+    output_available: 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;
+    /** When the thread's lifecycle state last changed */
+    updated_at?: string | null;
+}

package/dist/cjs/api/types/ThreadStatusBatchItemOut.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/types/ThreadStatusBatchResponseOut.d.ts

@@ -0,0 +1,20 @@
+import type * as AthenaIntelligence from "../index.js";
+/**
+ * Response model for the status of many threads.
+ */
+export interface ThreadStatusBatchResponseOut {
+    /** Found threads per canonical status */
+    counts: AthenaIntelligence.AopBatchStatusCountsOut;
+    /** Requested threads that exist and belong to you */
+    found: number;
+    /** True when every found thread has finished */
+    is_complete: boolean;
+    /** Requested thread IDs that do not exist or are not yours; the two cases are indistinguishable */
+    not_found: string[];
+    /** Distinct thread IDs in the request */
+    requested: number;
+    /** Found threads that have finished (completed + failed + canceled) */
+    terminal: number;
+    /** One entry per found thread, in request order */
+    threads: AthenaIntelligence.ThreadStatusBatchItemOut[];
+}

package/dist/cjs/api/types/ThreadStatusBatchResponseOut.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/types/index.d.ts

@@ -125,6 +125,8 @@ export * from "./ThinkingContent.js";
 export * from "./ThreadBatchStopRequest.js";
 export * from "./ThreadBatchStopResponseOut.js";
 export * from "./ThreadBatchStopResultItem.js";
+export * from "./ThreadStatusBatchItemOut.js";
+export * from "./ThreadStatusBatchResponseOut.js";
 export * from "./ThreadStatusResponseOut.js";
 export * from "./ThreadStopResponseOut.js";
 export * from "./ToolResultContent.js";

package/dist/cjs/api/types/index.js

@@ -141,6 +141,8 @@ __exportStar(require("./ThinkingContent.js"), exports);
 __exportStar(require("./ThreadBatchStopRequest.js"), exports);
 __exportStar(require("./ThreadBatchStopResponseOut.js"), exports);
 __exportStar(require("./ThreadBatchStopResultItem.js"), exports);
+__exportStar(require("./ThreadStatusBatchItemOut.js"), exports);
+__exportStar(require("./ThreadStatusBatchResponseOut.js"), exports);
 __exportStar(require("./ThreadStatusResponseOut.js"), exports);
 __exportStar(require("./ThreadStopResponseOut.js"), exports);
 __exportStar(require("./ToolResultContent.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "4.3.2167";
+export declare const SDK_VERSION = "4.3.2169";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "4.3.2167";
+exports.SDK_VERSION = "4.3.2169";

package/dist/esm/BaseClient.mjs

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

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

@@ -85,34 +85,37 @@ 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({
-     *         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"
+     *         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.AopExecuteRequestIn, requestOptions?: AopClient.RequestOptions): core.HttpResponsePromise<AthenaIntelligence.AopAsyncExecuteResponseOut>;
+    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.
+     * 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.

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";
@@ -313,27 +313,30 @@ 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({
-     *         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"
+     *         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"
+     *             }
      *         }
      *     })
      */
@@ -343,8 +346,9 @@ export class AopClient {
     __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, requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.headers);
+            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",
@@ -352,7 +356,7 @@ export class AopClient {
                 contentType: "application/json",
                 queryParameters: requestOptions === null || requestOptions === void 0 ? void 0 : requestOptions.queryParams,
                 requestType: "json",
-                body: request,
+                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,
@@ -373,6 +377,8 @@ export class AopClient {
                         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:
@@ -408,7 +414,7 @@ export class AopClient {
         });
     }
     /**
-     * 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.
+     * 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.

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/index.d.mts

@@ -1,5 +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

@@ -5,6 +5,8 @@ import type * as AthenaIntelligence from "../index.mjs";
 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 */

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

@@ -4,8 +4,10 @@
 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. */
+    /** 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/AopBatchRunLaunchOut.d.mts

@@ -6,6 +6,8 @@ export interface AopBatchRunLaunchOut {
     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 */

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

@@ -5,6 +5,8 @@ export interface GeneralAgentConfig {
     enabled_tools?: GeneralAgentConfig.EnabledTools.Item[];
     knowledge_base_asset_ids?: string[];
     model?: string | null;
+    /** A JSON Schema (type: object) the agent's final answer must conform to. When set, the response carries the validated payload in `structured_output` and the request fails with a 500 rather than returning prose that does not match the schema. */
+    structured_output?: Record<string, unknown> | null;
     system_prompt?: string;
 }
 export declare namespace GeneralAgentConfig {

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

@@ -4,4 +4,6 @@ import type * as AthenaIntelligence from "../index.mjs";
  */
 export interface GeneralAgentResponse {
     messages: AthenaIntelligence.GeneralAgentResponseMessage[];
+    /** The agent's final answer as an object matching `config.structured_output`. Null when no schema was requested. */
+    structured_output?: Record<string, unknown> | null;
 }

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

@@ -0,0 +1,27 @@
+/**
+ * Lifecycle status of one thread (no messages).
+ */
+export interface ThreadStatusBatchItemOut {
+    /** ID of the AOP asset the run executes */
+    aop_asset_id?: string | null;
+    /** Batch handle when the thread was launched via execute-batch */
+    batch_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;
+    /** True once the run completed successfully and its result can be read from `GET /threads/{thread_id}/status` */
+    output_available: 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;
+    /** When the thread's lifecycle state last changed */
+    updated_at?: string | null;
+}

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

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

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

@@ -0,0 +1,20 @@
+import type * as AthenaIntelligence from "../index.mjs";
+/**
+ * Response model for the status of many threads.
+ */
+export interface ThreadStatusBatchResponseOut {
+    /** Found threads per canonical status */
+    counts: AthenaIntelligence.AopBatchStatusCountsOut;
+    /** Requested threads that exist and belong to you */
+    found: number;
+    /** True when every found thread has finished */
+    is_complete: boolean;
+    /** Requested thread IDs that do not exist or are not yours; the two cases are indistinguishable */
+    not_found: string[];
+    /** Distinct thread IDs in the request */
+    requested: number;
+    /** Found threads that have finished (completed + failed + canceled) */
+    terminal: number;
+    /** One entry per found thread, in request order */
+    threads: AthenaIntelligence.ThreadStatusBatchItemOut[];
+}

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

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

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

@@ -125,6 +125,8 @@ export * from "./ThinkingContent.mjs";
 export * from "./ThreadBatchStopRequest.mjs";
 export * from "./ThreadBatchStopResponseOut.mjs";
 export * from "./ThreadBatchStopResultItem.mjs";
+export * from "./ThreadStatusBatchItemOut.mjs";
+export * from "./ThreadStatusBatchResponseOut.mjs";
 export * from "./ThreadStatusResponseOut.mjs";
 export * from "./ThreadStopResponseOut.mjs";
 export * from "./ToolResultContent.mjs";

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

@@ -125,6 +125,8 @@ export * from "./ThinkingContent.mjs";
 export * from "./ThreadBatchStopRequest.mjs";
 export * from "./ThreadBatchStopResponseOut.mjs";
 export * from "./ThreadBatchStopResultItem.mjs";
+export * from "./ThreadStatusBatchItemOut.mjs";
+export * from "./ThreadStatusBatchResponseOut.mjs";
 export * from "./ThreadStatusResponseOut.mjs";
 export * from "./ThreadStopResponseOut.mjs";
 export * from "./ToolResultContent.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "4.3.2167";
+export declare const SDK_VERSION = "4.3.2169";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "4.3.2167";
+export const SDK_VERSION = "4.3.2169";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@athenaintel/sdk",
-    "version": "4.3.2167",
+    "version": "4.3.2169",
     "private": false,
     "repository": "github:Athena-Intel/athena-typescript",
     "type": "commonjs",

package/reference.md

@@ -224,7 +224,7 @@ await client.aop.execute({
 <dl>
 <dd>
 
-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.
 </dd>
 </dl>
 </dd>
@@ -240,14 +240,16 @@ Start execution of an Agent Operating Procedure (AOP) asset asynchronously. Retu
 
 ```typescript
 await client.aop.executeAsync({
-    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"
+    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"
+        }
     }
 });
 
@@ -265,7 +267,7 @@ await client.aop.executeAsync({
 <dl>
 <dd>
 
-**request:** `AthenaIntelligence.AopExecuteRequestIn` 
+**request:** `AthenaIntelligence.ExecuteAsyncAopRequest` 
     
 </dd>
 </dl>
@@ -297,7 +299,7 @@ await client.aop.executeAsync({
 <dl>
 <dd>
 
-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.
+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`.
 </dd>
 </dl>
 </dd>
@@ -3874,6 +3876,71 @@ await client.threads.batchStopByAssetId({
 </dl>
 
 
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.threads.<a href="/src/api/resources/threads/client/Client.ts">getStatusBatch</a>({ ...params }) -> AthenaIntelligence.ThreadStatusBatchResponseOut</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+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.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.threads.getStatusBatch({
+    thread_ids: ["thread_12345-6789-abcd-efgh", "thread_22345-6789-abcd-efgh"]
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AthenaIntelligence.ThreadStatusBatchRequestIn` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `ThreadsClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
 </dd>
 </dl>
 </details>