@athenaintel/sdk 4.3.2160 → 4.3.2162

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.2160",
-        "User-Agent": "@athenaintel/sdk/4.3.2160",
+        "X-Fern-SDK-Version": "4.3.2162",
+        "User-Agent": "@athenaintel/sdk/4.3.2162",
         "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

@@ -52,6 +52,10 @@ export declare class AopClient {
      * @example
      *     await client.aop.execute({
      *         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"
@@ -75,6 +79,10 @@ export declare class AopClient {
      * @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"

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

@@ -174,6 +174,10 @@ class AopClient {
      * @example
      *     await client.aop.execute({
      *         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,6 +269,10 @@ class AopClient {
      * @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"

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

@@ -1,3 +1,4 @@
+import type * as AthenaIntelligence from "../index.js";
 /**
  * Request model for executing an AOP (Agent Operating Procedure).
  */
@@ -6,6 +7,8 @@ export interface AopExecuteRequestIn {
     asset_id: string;
     /** Execute the AOP in dry-run mode: the agent runs with its real prompt, config, and read-only tools, but side-effectful tool calls (emails, external writes) are validated and captured instead of executed. The session remains visible and is marked with athena_metadata.is_dry_run for UI badging. */
     dry_run?: boolean;
+    /** Optional spend cap for this execution: max_model_calls (top-level and sub-agent model calls) and/or max_cost_usd (provider cost at Athena's model pricing). When a limit is reached the run stops before the next model call, ends with athena_termination_reason=run_budget, and the AOP execution settles as not succeeded. Absent = no cap beyond the agent's step limit. */
+    run_budget?: AthenaIntelligence.RunBudget | 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/RunBudget.d.ts

@@ -0,0 +1,16 @@
+/**
+ * The most one execution may spend before the runtime stops it.
+ *
+ * Both limits are optional individually; at least one must be set. A limit
+ * that is reached ends the run: the model call that would exceed
+ * ``max_model_calls`` is never made, and neither is the first call after
+ * accumulated provider cost reaches ``max_cost_usd`` — or the call projected
+ * to cross it (a cost cap can be overshot by at most one call's variance,
+ * since the provider bills after the fact).
+ */
+export interface RunBudget {
+    /** Maximum provider cost in USD this execution may accumulate, at Athena's in-house model pricing. The run stops before the model call that has reached, or is projected to cross, this amount; a single call can overshoot it by at most that call's cost. */
+    max_cost_usd?: number | null;
+    /** Maximum number of model calls (top-level and sub-agent) this execution may make. The run stops before the call that would exceed it. */
+    max_model_calls?: number | null;
+}

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

@@ -88,6 +88,7 @@ export * from "./ReadCapabilitiesOut.js";
 export * from "./RedactedThinkingContent.js";
 export * from "./RenameAssetResponseOut.js";
 export * from "./RevokeSshAccessResponseOut.js";
+export * from "./RunBudget.js";
 export * from "./RunTaskResponse.js";
 export * from "./SaveAssetRequestOut.js";
 export * from "./SemanticModelMetaResponseOut.js";

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

@@ -104,6 +104,7 @@ __exportStar(require("./ReadCapabilitiesOut.js"), exports);
 __exportStar(require("./RedactedThinkingContent.js"), exports);
 __exportStar(require("./RenameAssetResponseOut.js"), exports);
 __exportStar(require("./RevokeSshAccessResponseOut.js"), exports);
+__exportStar(require("./RunBudget.js"), exports);
 __exportStar(require("./RunTaskResponse.js"), exports);
 __exportStar(require("./SaveAssetRequestOut.js"), exports);
 __exportStar(require("./SemanticModelMetaResponseOut.js"), exports);

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "4.3.2160";
+export declare const SDK_VERSION = "4.3.2162";

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.2160";
+exports.SDK_VERSION = "4.3.2162";

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.2160",
-        "User-Agent": "@athenaintel/sdk/4.3.2160",
+        "X-Fern-SDK-Version": "4.3.2162",
+        "User-Agent": "@athenaintel/sdk/4.3.2162",
         "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

@@ -52,6 +52,10 @@ export declare class AopClient {
      * @example
      *     await client.aop.execute({
      *         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"
@@ -75,6 +79,10 @@ export declare class AopClient {
      * @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"

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

@@ -138,6 +138,10 @@ export class AopClient {
      * @example
      *     await client.aop.execute({
      *         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"
@@ -229,6 +233,10 @@ export class AopClient {
      * @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"

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

@@ -1,3 +1,4 @@
+import type * as AthenaIntelligence from "../index.mjs";
 /**
  * Request model for executing an AOP (Agent Operating Procedure).
  */
@@ -6,6 +7,8 @@ export interface AopExecuteRequestIn {
     asset_id: string;
     /** Execute the AOP in dry-run mode: the agent runs with its real prompt, config, and read-only tools, but side-effectful tool calls (emails, external writes) are validated and captured instead of executed. The session remains visible and is marked with athena_metadata.is_dry_run for UI badging. */
     dry_run?: boolean;
+    /** Optional spend cap for this execution: max_model_calls (top-level and sub-agent model calls) and/or max_cost_usd (provider cost at Athena's model pricing). When a limit is reached the run stops before the next model call, ends with athena_termination_reason=run_budget, and the AOP execution settles as not succeeded. Absent = no cap beyond the agent's step limit. */
+    run_budget?: AthenaIntelligence.RunBudget | 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/RunBudget.d.mts

@@ -0,0 +1,16 @@
+/**
+ * The most one execution may spend before the runtime stops it.
+ *
+ * Both limits are optional individually; at least one must be set. A limit
+ * that is reached ends the run: the model call that would exceed
+ * ``max_model_calls`` is never made, and neither is the first call after
+ * accumulated provider cost reaches ``max_cost_usd`` — or the call projected
+ * to cross it (a cost cap can be overshot by at most one call's variance,
+ * since the provider bills after the fact).
+ */
+export interface RunBudget {
+    /** Maximum provider cost in USD this execution may accumulate, at Athena's in-house model pricing. The run stops before the model call that has reached, or is projected to cross, this amount; a single call can overshoot it by at most that call's cost. */
+    max_cost_usd?: number | null;
+    /** Maximum number of model calls (top-level and sub-agent) this execution may make. The run stops before the call that would exceed it. */
+    max_model_calls?: number | null;
+}

package/dist/esm/api/types/RunBudget.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

@@ -88,6 +88,7 @@ export * from "./ReadCapabilitiesOut.mjs";
 export * from "./RedactedThinkingContent.mjs";
 export * from "./RenameAssetResponseOut.mjs";
 export * from "./RevokeSshAccessResponseOut.mjs";
+export * from "./RunBudget.mjs";
 export * from "./RunTaskResponse.mjs";
 export * from "./SaveAssetRequestOut.mjs";
 export * from "./SemanticModelMetaResponseOut.mjs";

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

@@ -88,6 +88,7 @@ export * from "./ReadCapabilitiesOut.mjs";
 export * from "./RedactedThinkingContent.mjs";
 export * from "./RenameAssetResponseOut.mjs";
 export * from "./RevokeSshAccessResponseOut.mjs";
+export * from "./RunBudget.mjs";
 export * from "./RunTaskResponse.mjs";
 export * from "./SaveAssetRequestOut.mjs";
 export * from "./SemanticModelMetaResponseOut.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "4.3.2160";
+export declare const SDK_VERSION = "4.3.2162";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "4.3.2160";
+export const SDK_VERSION = "4.3.2162";

package/package.json

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

package/reference.md

@@ -101,6 +101,10 @@ DEPRECATED: This endpoint is deprecated. Please use /aop/execute-async instead f
 ```typescript
 await client.aop.execute({
     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"
@@ -170,6 +174,10 @@ 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"