@athenaintel/sdk 4.3.2166 → 4.3.2168

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

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

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

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

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

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

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

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

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

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

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

@@ -0,0 +1,20 @@
+import type * as AthenaIntelligence from "../index.js";
+/**
+ * Response model for the status of an execute-batch.
+ */
+export interface AopBatchStatusResponseOut {
+    /** The batch handle that was checked */
+    batch_id: string;
+    /** Runs per canonical status */
+    counts: AthenaIntelligence.AopBatchStatusCountsOut;
+    /** True when every run in the batch has finished */
+    is_complete: boolean;
+    /** Opaque cursor for the next page of `runs`; null when this page is the last one. Pass it as `cursor` on the next call. */
+    next_cursor?: string | null;
+    /** One page of runs matching the `status` filter, ordered by cursor */
+    runs: AthenaIntelligence.AopBatchRunStatusOut[];
+    /** Runs that have finished (completed + failed + canceled) */
+    terminal: number;
+    /** Runs launched into the batch so far */
+    total: number;
+}

package/dist/cjs/api/types/AopBatchStatusResponseOut.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/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

@@ -2,6 +2,12 @@ export * from "./ActivityClockRangeIn.js";
 export * from "./ActivityDeltaOut.js";
 export * from "./ActivityItemOut.js";
 export * from "./AopAsyncExecuteResponseOut.js";
+export * from "./AopBatchExecuteResponseOut.js";
+export * from "./AopBatchRunIn.js";
+export * from "./AopBatchRunLaunchOut.js";
+export * from "./AopBatchRunStatusOut.js";
+export * from "./AopBatchStatusCountsOut.js";
+export * from "./AopBatchStatusResponseOut.js";
 export * from "./AopConfigResponseOut.js";
 export * from "./AopConfigUpdateResponseOut.js";
 export * from "./AopCreateResponseOut.js";
@@ -119,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

@@ -18,6 +18,12 @@ __exportStar(require("./ActivityClockRangeIn.js"), exports);
 __exportStar(require("./ActivityDeltaOut.js"), exports);
 __exportStar(require("./ActivityItemOut.js"), exports);
 __exportStar(require("./AopAsyncExecuteResponseOut.js"), exports);
+__exportStar(require("./AopBatchExecuteResponseOut.js"), exports);
+__exportStar(require("./AopBatchRunIn.js"), exports);
+__exportStar(require("./AopBatchRunLaunchOut.js"), exports);
+__exportStar(require("./AopBatchRunStatusOut.js"), exports);
+__exportStar(require("./AopBatchStatusCountsOut.js"), exports);
+__exportStar(require("./AopBatchStatusResponseOut.js"), exports);
 __exportStar(require("./AopConfigResponseOut.js"), exports);
 __exportStar(require("./AopConfigUpdateResponseOut.js"), exports);
 __exportStar(require("./AopCreateResponseOut.js"), exports);
@@ -135,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.2166";
+export declare const SDK_VERSION = "4.3.2168";

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.2166";
+exports.SDK_VERSION = "4.3.2168";

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.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/esm/api/resources/aop/client/Client.d.mts

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