runbios-sdk 0.2.1-dev.133 → 0.2.1-dev.134

package/dist/index.d.ts

@@ -36,7 +36,7 @@ import { Loop } from './resources/loop.js';
  * SDK version. Sent as part of the User-Agent header.
  * Must match package.json "version" -- enforced by a contract test.
  */
-export declare const VERSION = "0.2.1-dev.133";
+export declare const VERSION = "0.2.1-dev.134";
 export declare class RunBiOS {
     /** Search models, fetch configs, check adapter compatibility. */
     readonly models: Models;

package/dist/index.js

@@ -36,7 +36,7 @@ import { Loop } from './resources/loop.js';
  * SDK version. Sent as part of the User-Agent header.
  * Must match package.json "version" -- enforced by a contract test.
  */
-export const VERSION = '0.2.1-dev.133';
+export const VERSION = '0.2.1-dev.134';
 export class RunBiOS {
     /** Search models, fetch configs, check adapter compatibility. */
     models;

package/dist/resources/loop.d.ts

@@ -411,8 +411,17 @@ export declare class Loop {
      * Turn the agent on: mints the workspace's managed serverless key. After
      * this, automatic judges and sample runs make model calls billed to the
      * workspace. Idempotent.
+     *
+     * `monthly_spend_cap_cents` caps what that key may spend on model calls in
+     * a calendar month. Omitted = no cap on a fresh key, and an existing cap is
+     * left as it is; sent while the agent is already on, it moves the cap on
+     * the existing key without minting a new one. When the cap is reached the
+     * agent's model calls are refused until next month and its runs pause with
+     * that reason.
      */
-    enableAgent(): Promise<LoopAgentCredential>;
+    enableAgent(opts?: {
+        monthly_spend_cap_cents?: number;
+    }): Promise<LoopAgentCredential>;
     /**
      * Turn the agent off: revokes its key and sets every automatic judge back to
      * manual. Open runs stop where they are and continue if it is turned back

package/dist/resources/loop.js

@@ -582,9 +582,19 @@ export class Loop {
      * Turn the agent on: mints the workspace's managed serverless key. After
      * this, automatic judges and sample runs make model calls billed to the
      * workspace. Idempotent.
+     *
+     * `monthly_spend_cap_cents` caps what that key may spend on model calls in
+     * a calendar month. Omitted = no cap on a fresh key, and an existing cap is
+     * left as it is; sent while the agent is already on, it moves the cap on
+     * the existing key without minting a new one. When the cap is reached the
+     * agent's model calls are refused until next month and its runs pause with
+     * that reason.
      */
-    async enableAgent() {
-        const res = await this._http.fetchPost('/api/loop/agent', {});
+    async enableAgent(opts = {}) {
+        const body = {};
+        if (opts.monthly_spend_cap_cents != null)
+            body.monthly_spend_cap_cents = opts.monthly_spend_cap_cents;
+        const res = await this._http.fetchPost('/api/loop/agent', body);
         return res.credential;
     }
     /**

package/dist/types.d.ts

@@ -2527,6 +2527,13 @@ export interface LoopAgentCredential {
     last_used_at: string | null;
     last_error: string | null;
     revoked_at: string | null;
+    /**
+     * The most the agent's key may spend on model calls in a calendar month,
+     * in cents. `null` = no cap (the default): the agent can spend up to the
+     * workspace's serverless balance. Once reached, the agent's model calls
+     * are refused until next month and its runs pause with that reason.
+     */
+    monthly_spend_cap_cents: number | null;
 }
 export interface LoopAgentStatus {
     /** An agent can exist in this environment at all. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runbios-sdk",
-  "version": "0.2.1-dev.133",
+  "version": "0.2.1-dev.134",
   "description": "Official TypeScript SDK for the Run BiOS training and deployment platform API",
   "type": "module",
   "main": "./dist/index.js",