@athenaintel/sdk 4.3.2166 → 4.3.2168

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

@@ -0,0 +1,20 @@
+import type * as AthenaIntelligence from "../index.mjs";
+/**
+ * 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/esm/api/types/AopBatchStatusResponseOut.mjs

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

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

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

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

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "4.3.2166";
+export const SDK_VERSION = "4.3.2168";

package/package.json

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

package/reference.md

@@ -1,5 +1,72 @@
 # Reference
 ## Aop
+<details><summary><code>client.aop.<a href="/src/api/resources/aop/client/Client.ts">getBatchStatus</a>({ ...params }) -> AthenaIntelligence.AopBatchStatusResponseOut</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+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.
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+await client.aop.getBatchStatus({
+    batch_id: "batch_0f4c3c3e-1c1a-4a3e-9a5f-0d3f1a2b3c4d",
+    status: "terminal",
+    limit: 200
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AthenaIntelligence.GetBatchStatusAopRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AopClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
 <details><summary><code>client.aop.<a href="/src/api/resources/aop/client/Client.ts">create</a>({ ...params }) -> AthenaIntelligence.AopCreateResponseOut</code></summary>
 <dl>
 <dd>
@@ -157,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>
@@ -173,15 +240,97 @@ Start execution of an Agent Operating Procedure (AOP) asset asynchronously. Retu
 
 ```typescript
 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"
+        }
+    }
+});
+
+```
+</dd>
+</dl>
+</dd>
+</dl>
+
+#### ⚙️ Parameters
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+**request:** `AthenaIntelligence.ExecuteAsyncAopRequest` 
+    
+</dd>
+</dl>
+
+<dl>
+<dd>
+
+**requestOptions:** `AopClient.RequestOptions` 
+    
+</dd>
+</dl>
+</dd>
+</dl>
+
+
+</dd>
+</dl>
+</details>
+
+<details><summary><code>client.aop.<a href="/src/api/resources/aop/client/Client.ts">executeBatch</a>({ ...params }) -> AthenaIntelligence.AopBatchExecuteResponseOut</code></summary>
+<dl>
+<dd>
+
+#### 📝 Description
+
+<dl>
+<dd>
+
+<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. 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>
+</dl>
+
+#### 🔌 Usage
+
+<dl>
+<dd>
+
+<dl>
+<dd>
+
+```typescript
+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"
+            }
+        }]
 });
 
 ```
@@ -198,7 +347,7 @@ await client.aop.executeAsync({
 <dl>
 <dd>
 
-**request:** `AthenaIntelligence.AopExecuteRequestIn` 
+**request:** `AthenaIntelligence.AopBatchExecuteRequestIn` 
     
 </dd>
 </dl>
@@ -3727,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>