runbios-sdk 0.2.1-rc.130 → 0.2.1-rc.138

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-rc.130";
+export declare const VERSION = "0.2.1-rc.138";
 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-rc.130';
+export const VERSION = '0.2.1-rc.138';
 export class RunBiOS {
     /** Search models, fetch configs, check adapter compatibility. */
     models;

package/dist/resources/loop.d.ts

@@ -312,6 +312,13 @@ export declare class Loop {
      * twice the weight, and the combined score is the weighted mean over the
      * rules that actually applied.
      *
+     * `matches_gold` needs no `expected`: it compares each answer to the gold
+     * answer recorded on that same conversation, or the human correction when
+     * there is no gold, and scores sampled alternatives against the same gold.
+     * A conversation with neither is skipped, not failed, so one rule checks
+     * every labelled question without punishing the unlabelled ones. An
+     * optional `tolerance` widens the match when both sides are bare numbers.
+     *
      * A caution worth knowing before you write a set: a rule made only of
      * `forbidden` phrases is satisfied VACUOUSLY by an answer that says nothing.
      * Pair it with a `required` phrase, or you are rewarding silence.
@@ -408,15 +415,27 @@ export declare class Loop {
      */
     agentStatus(): Promise<LoopAgentStatus>;
     /**
-     * Turn the agent on: mints the workspace's managed serverless key. After
-     * this, automatic judges and sample runs make model calls billed to the
+     * Turn the agent on: mints the workspace's managed serverless key and
+     * resumes the automatic judges a previous turn-off paused. 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
-     * on. Nothing already scored or written is removed.
+     * Turn the agent off: revokes its key and pauses every automatic judge in
+     * the workspace (`judges_paused`; each judge shows `auto_paused`). Turning
+     * it back on resumes exactly those judges. Open runs stop where they are
+     * and continue if it is turned back on. Nothing already scored or written
+     * is removed.
      */
     disableAgent(): Promise<{
         revoked: boolean;

package/dist/resources/loop.js

@@ -417,6 +417,13 @@ export class Loop {
      * twice the weight, and the combined score is the weighted mean over the
      * rules that actually applied.
      *
+     * `matches_gold` needs no `expected`: it compares each answer to the gold
+     * answer recorded on that same conversation, or the human correction when
+     * there is no gold, and scores sampled alternatives against the same gold.
+     * A conversation with neither is skipped, not failed, so one rule checks
+     * every labelled question without punishing the unlabelled ones. An
+     * optional `tolerance` widens the match when both sides are bare numbers.
+     *
      * A caution worth knowing before you write a set: a rule made only of
      * `forbidden` phrases is satisfied VACUOUSLY by an answer that says nothing.
      * Pair it with a `required` phrase, or you are rewarding silence.
@@ -579,18 +586,31 @@ export class Loop {
         return this._http.fetchGet('/api/loop/agent');
     }
     /**
-     * Turn the agent on: mints the workspace's managed serverless key. After
-     * this, automatic judges and sample runs make model calls billed to the
+     * Turn the agent on: mints the workspace's managed serverless key and
+     * resumes the automatic judges a previous turn-off paused. 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;
     }
     /**
-     * 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
-     * on. Nothing already scored or written is removed.
+     * Turn the agent off: revokes its key and pauses every automatic judge in
+     * the workspace (`judges_paused`; each judge shows `auto_paused`). Turning
+     * it back on resumes exactly those judges. Open runs stop where they are
+     * and continue if it is turned back on. Nothing already scored or written
+     * is removed.
      */
     async disableAgent() {
         return this._http.fetchDelete('/api/loop/agent');

package/dist/types.d.ts

@@ -701,6 +701,13 @@ export interface TrainingJob {
     status: TrainingJobStatus;
     error_message?: string | null;
     error_code?: string | null;
+    /**
+     * Who ended a `stopped` run: `user` (Stop button, API, queue cancel) or
+     * `platform` (wallet exhausted, account block). Empty when the run is not
+     * stopped, or was stopped before this was recorded. A `failed` run is a
+     * different fact and never carries a stop origin.
+     */
+    stop_origin?: 'user' | 'platform' | '';
     current_step?: number;
     total_steps?: number;
     current_loss?: number | null;
@@ -2236,10 +2243,27 @@ export interface LoopImportResult {
      */
     reviewed: number;
     needs_review: number;
+    /**
+     * How many rows could not be READ as a conversation. The file's shape is
+     * wrong, and changing the file is what fixes it.
+     */
     refused: number;
+    /**
+     * How many rows were understood and then could not be stored. Counted apart
+     * from `refused`, because the two are different claims and rewriting a file
+     * that was already correct fixes nothing. A call with any of these fails
+     * rather than succeeding, and the failure carries these same fields.
+     */
+    not_saved?: number;
     /** How many rows of each recognised shape, so a mis-shaped file is visible. */
     by_shape: Record<string, number>;
     refused_why: Record<string, number>;
+    /**
+     * The conversations this call created, in file order. Without them a caller
+     * whose import half-failed has a number and no way to reach what landed: no
+     * way to label it, review it, or delete it and start again.
+     */
+    trace_ids?: string[];
     notes: string[];
 }
 export interface LoopSignal {
@@ -2520,6 +2544,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. */
@@ -2658,8 +2689,16 @@ export interface LoopCandidate {
     metadata: Record<string, unknown>;
     created_at: string;
 }
-/** The deterministic checks a grader can perform. */
-export type LoopGraderKind = 'exact_match' | 'contains' | 'regex' | 'json_valid' | 'numeric' | 'tool_called';
+/**
+ * The deterministic checks a grader can perform.
+ *
+ * `matches_gold` is the one kind with no expected value of its own: it
+ * compares each answer to the gold answer recorded on that same conversation
+ * (or the human correction when there is no gold), scores sampled
+ * alternatives against the same gold, and is NOT APPLIED to a conversation
+ * that carries neither, so it never marks down an unlabelled answer.
+ */
+export type LoopGraderKind = 'matches_gold' | 'exact_match' | 'contains' | 'regex' | 'json_valid' | 'numeric' | 'tool_called';
 export interface LoopGraderConfig {
     expected?: string;
     /** Every phrase that must appear. */
@@ -2669,7 +2708,10 @@ export interface LoopGraderConfig {
     pattern?: string;
     /** Keys the answer must carry, for `json_valid`. */
     keys?: string[];
-    /** How far from `expected` still counts, for `numeric`. */
+    /**
+     * How far from `expected` still counts, for `numeric`. For `matches_gold`,
+     * how far from the gold answer still counts when both are bare numbers.
+     */
     tolerance?: number;
     /** The function that must have been called, for `tool_called`. */
     function?: string;

package/package.json

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