runbios-sdk 0.2.1-dev.115 → 0.2.1-dev.116

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.115";
+export declare const VERSION = "0.2.1-dev.116";
 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.115';
+export const VERSION = '0.2.1-dev.116';
 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, LoopLabel, LoopLabelCount, LoopGradeResult, LoopDataset, LoopDatasetListParams, LoopDatasetItem, LoopDatasetCreateParams, LoopConfig, LoopConfigParams, LoopStats, LoopJudge, LoopJudgeParams, LoopJudgeRun, LoopJudgeWork, LoopJudgeVerdict, LoopJudgeVerdictResult } from '../types.js';
+import type { LoopTrace, LoopTraceListResponse, LoopTraceListParams, LoopCaptureParams, LoopCaptureResult, LoopImportParams, LoopImportResult, LoopSignal, LoopSignalParams, LoopCandidate, LoopCandidateParams, LoopGrader, LoopGraderParams, LoopLabel, LoopLabelCount, LoopGradeResult, LoopDataset, LoopDatasetListParams, LoopDatasetItem, LoopDatasetCreateParams, LoopConfig, LoopConfigParams, LoopStats, LoopJudge, LoopJudgeParams, LoopJudgeRun, LoopJudgeWork, LoopJudgeVerdict, LoopJudgeVerdictResult } 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.
@@ -59,6 +59,33 @@ export declare class Loop {
      * your application.
      */
     capture(params: LoopCaptureParams): Promise<LoopCaptureResult>;
+    /**
+     * Bring data you already have into the loop.
+     *
+     * This does NOT create a training set. It creates conversations, in the same
+     * place captured ones live and subject to the same review, rules, judges and
+     * labels. A row becomes trainable when something says it is good, never
+     * because it arrived in a file -- which is the one guarantee that separates
+     * a corpus from a pile.
+     *
+     * Each row is read for what it actually is. A `prompt`/`chosen`/`rejected`
+     * triple becomes a preference pair; an answer plus a yes-or-no becomes a
+     * thumbs verdict; a question and an answer waits for review; a question with
+     * no answer waits for an answer; a paragraph of prose is refused, because it
+     * is not a conversation.
+     *
+     * A verdict that arrives *with* the file is kept -- discarding somebody's
+     * judgement would be worse -- but it is recorded as having come from your
+     * earlier process rather than from a reviewer here, and the conversation
+     * records that it was imported. Neither fact can be reconstructed later, so
+     * both are written at the door.
+     *
+     * `source` is required and becomes the id every imported conversation is
+     * filed under: "everything in one bucket called import" is a corpus nobody
+     * can slice afterwards. At most 5000 rows per call, because the call is
+     * synchronous and somebody is waiting on it.
+     */
+    importRows(params: LoopImportParams): Promise<LoopImportResult>;
     /** List captured conversations, newest first. */
     listTraces(params?: LoopTraceListParams): Promise<LoopTraceListResponse>;
     /** Read one conversation, with every verdict recorded on it. */

package/dist/resources/loop.js

@@ -62,6 +62,35 @@ export class Loop {
     async capture(params) {
         return this._http.fetchPost('/api/loop/traces', params);
     }
+    /**
+     * Bring data you already have into the loop.
+     *
+     * This does NOT create a training set. It creates conversations, in the same
+     * place captured ones live and subject to the same review, rules, judges and
+     * labels. A row becomes trainable when something says it is good, never
+     * because it arrived in a file -- which is the one guarantee that separates
+     * a corpus from a pile.
+     *
+     * Each row is read for what it actually is. A `prompt`/`chosen`/`rejected`
+     * triple becomes a preference pair; an answer plus a yes-or-no becomes a
+     * thumbs verdict; a question and an answer waits for review; a question with
+     * no answer waits for an answer; a paragraph of prose is refused, because it
+     * is not a conversation.
+     *
+     * A verdict that arrives *with* the file is kept -- discarding somebody's
+     * judgement would be worse -- but it is recorded as having come from your
+     * earlier process rather than from a reviewer here, and the conversation
+     * records that it was imported. Neither fact can be reconstructed later, so
+     * both are written at the door.
+     *
+     * `source` is required and becomes the id every imported conversation is
+     * filed under: "everything in one bucket called import" is a corpus nobody
+     * can slice afterwards. At most 5000 rows per call, because the call is
+     * synchronous and somebody is waiting on it.
+     */
+    async importRows(params) {
+        return this._http.fetchPost('/api/loop/import', params);
+    }
     // ── traces ────────────────────────────────────────────────────────────
     /** List captured conversations, newest first. */
     async listTraces(params = {}) {

package/dist/types.d.ts

@@ -2046,6 +2046,35 @@ export interface LoopCaptureResult {
     /** Why nothing was stored, e.g. `capture_disabled`, `not_sampled`. */
     reason?: string;
 }
+export interface LoopImportParams {
+    /**
+     * Where this came from. Required, and becomes the id every imported
+     * conversation is filed under, so the import stays sliceable later.
+     */
+    source: string;
+    /** The file, already parsed. At most 5000 rows per call. */
+    rows: Record<string, unknown>[];
+    /** Which model produced these, when the rows do not say per-row. */
+    model?: string;
+    /** Applied to every row: importing a dump is when somebody knows what it is. */
+    labels?: string[];
+    attributes?: Record<string, string>;
+}
+export interface LoopImportResult {
+    imported: number;
+    /**
+     * How many arrived carrying a verdict. Reported apart from `imported`
+     * because it is the difference between data you can train on and data
+     * somebody still has to look at.
+     */
+    reviewed: number;
+    needs_review: number;
+    refused: 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>;
+    notes: string[];
+}
 export interface LoopSignal {
     id: string;
     trace_id: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "runbios-sdk",
-  "version": "0.2.1-dev.115",
+  "version": "0.2.1-dev.116",
   "description": "Official TypeScript SDK for the Run BiOS training and deployment platform API",
   "type": "module",
   "main": "./dist/index.js",
@@ -20,7 +20,7 @@
   ],
   "scripts": {
     "build": "tsc",
-    "test": "npm run build && node --test test/contracts.test.mjs test/capacity-contract.test.mjs test/contract-drift.test.mjs test/inference-param-naming.test.mjs test/coming-soon.test.mjs",
+    "test": "npm run build && node --test \"test/*.test.mjs\"",
     "clean": "rm -rf dist",
     "prepack": "npm run clean && npm run build"
   },