runbios-sdk 0.2.1-dev.108 → 0.2.1-dev.109

package/dist/index.d.ts

@@ -35,7 +35,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.108";
+export declare const VERSION = "0.2.1-dev.109";
 export declare class RunBiOS {
     /** Search models, fetch configs, check adapter compatibility. */
     readonly models: Models;

package/dist/index.js

@@ -35,7 +35,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.108';
+export const VERSION = '0.2.1-dev.109';
 export class RunBiOS {
     /** Search models, fetch configs, check adapter compatibility. */
     models;

package/dist/resources/loop.d.ts

@@ -1,5 +1,5 @@
 import type { HttpClient } from '../client.js';
-import type { LoopTrace, LoopTraceListResponse, LoopTraceListParams, LoopCaptureParams, LoopCaptureResult, LoopSignal, LoopSignalParams, LoopCandidate, LoopCandidateParams, LoopGrader, LoopGraderParams, LoopGradeResult, LoopDataset, LoopDatasetListParams, LoopDatasetItem, LoopDatasetCreateParams, LoopConfig, LoopConfigParams, LoopStats } from '../types.js';
+import type { LoopTrace, LoopTraceListResponse, LoopTraceListParams, LoopCaptureParams, LoopCaptureResult, LoopSignal, LoopSignalParams, LoopCandidate, LoopCandidateParams, LoopGrader, LoopGraderParams, LoopLabel, LoopLabelCount, LoopGradeResult, LoopDataset, LoopDatasetListParams, LoopDatasetItem, LoopDatasetCreateParams, LoopConfig, LoopConfigParams, LoopStats } from '../types.js';
 /**
  * The Conscious Loop -- capture what your model was asked and answered, record
  * whether it was right, and turn those judgements into training data.
@@ -157,6 +157,27 @@ export declare class Loop {
     addCandidate(traceId: string, params: LoopCandidateParams): Promise<LoopCandidate>;
     /** Every alternative answer recorded for one prompt, oldest first. */
     listCandidates(traceId: string): Promise<LoopCandidate[]>;
+    /**
+     * Label a conversation, so it can be selected later.
+     *
+     * An average over everything is the least useful thing to train on. A model
+     * weak at refunds is fixed with refund examples, and you can only select
+     * those if you said so when the conversation arrived.
+     *
+     * A label may name a `parent`, which is what makes a MASTER GROUP: labelling
+     * something `refunds` with parent `billing` makes it selectable as either,
+     * and selecting `billing` later gathers every child without you maintaining
+     * a list of them.
+     *
+     * Labels are lowercased and trimmed, so `Refunds` and `refunds` are one label.
+     */
+    label(traceId: string, labels: string[], parent?: string): Promise<LoopLabel[]>;
+    unlabel(traceId: string, label: string): Promise<{
+        deleted: boolean;
+        label: string;
+    }>;
+    /** Every label in the workspace, with how many conversations carry it. */
+    listLabels(): Promise<LoopLabelCount[]>;
     /**
      * Build a training set from the feedback recorded so far.
      *

package/dist/resources/loop.js

@@ -203,6 +203,33 @@ export class Loop {
         const res = await this._http.fetchGet(`/api/loop/traces/${encodeURIComponent(traceId)}/candidates`);
         return res.candidates;
     }
+    // ── labels ────────────────────────────────────────────────────────────
+    /**
+     * Label a conversation, so it can be selected later.
+     *
+     * An average over everything is the least useful thing to train on. A model
+     * weak at refunds is fixed with refund examples, and you can only select
+     * those if you said so when the conversation arrived.
+     *
+     * A label may name a `parent`, which is what makes a MASTER GROUP: labelling
+     * something `refunds` with parent `billing` makes it selectable as either,
+     * and selecting `billing` later gathers every child without you maintaining
+     * a list of them.
+     *
+     * Labels are lowercased and trimmed, so `Refunds` and `refunds` are one label.
+     */
+    async label(traceId, labels, parent) {
+        const res = await this._http.fetchPost(`/api/loop/traces/${encodeURIComponent(traceId)}/labels`, { labels, parent });
+        return res.labels;
+    }
+    async unlabel(traceId, label) {
+        return this._http.fetchDelete(`/api/loop/traces/${encodeURIComponent(traceId)}/labels/${encodeURIComponent(label)}`);
+    }
+    /** Every label in the workspace, with how many conversations carry it. */
+    async listLabels() {
+        const res = await this._http.fetchGet('/api/loop/labels');
+        return res.labels;
+    }
     // ── training sets ─────────────────────────────────────────────────────
     /**
      * Build a training set from the feedback recorded so far.

package/dist/types.d.ts

@@ -2085,6 +2085,10 @@ export interface LoopDatasetCreateParams {
     deployment_id?: string;
     from?: string;
     to?: string;
+    /** Narrow to one slice. A label with children selects them too. */
+    label?: string;
+    /** Take this many at random from what the filters matched. */
+    sample?: number;
     /** Holds back your most recent work, not a random slice. 0-50. */
     holdout_percent?: number;
     max_items?: number;
@@ -2237,3 +2241,15 @@ export interface LoopGradeResult {
     signal_id: string | null;
     candidates_graded: number;
 }
+export interface LoopLabel {
+    label: string;
+    /** The master group this label belongs to, if any. */
+    parent: string | null;
+    created_by: string | null;
+    created_at: string;
+}
+export interface LoopLabelCount {
+    label: string;
+    parent: string | null;
+    traces: number;
+}

package/package.json

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