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

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.113";
+export declare const VERSION = "0.2.1-dev.115";
 export declare class RunBiOS {
     /** Search models, fetch configs, check adapter compatibility. */
     readonly models: Models;
@@ -75,4 +75,4 @@ export { Training } from './resources/training.js';
 export { Wallet } from './resources/wallet.js';
 export { GPU, type GPURecommendation } from './resources/gpu.js';
 export { Inference, validateChatRequest, parseSSE, buildInferenceRequest, contextSizingBasis, type ContextSizingBasis, CONTEXT_DEFAULT_CEILING, CONTEXT_EDITABLE_FLOOR, type ChatMessage, type FunctionTool, type ChatCompletionParams, type ChatCompletionResponse, type ChatCompletionChunk, } from './resources/inference.js';
-export type { BiOSConfig, PaginatedResponse, ApiErrorBody, AvailableGpuAlternative, CapacityMinimumRequirement, InferenceBookingAccepted, Model, ModelSearchParams, ModelSearchResponse, ModelDetailResponse, ModelConfig, Dataset, DatasetListParams, DatasetListResponse, DatasetUploadParams, DatasetPreview, DatasetPreviewParams, DatasetImportHFParams, DatasetRegisterHFParams, DatasetHubSearchParams, DatasetHubPreviewParams, DatasetValidation, DatasetFormatVariant, DatasetFormatSpec, DatasetFormatSpecs, DatasetStorageUsage, TrainingMethod, RLHFAlgorithm, AdapterType, TrainingJobStatus, TrainingStatusFilter, TrainingCreateParams, TrainingListParams, TrainingListResponse, TrainingJob, TrainingMetrics, MetricPoint, MetricGraphConfig, TrainingCheckpoint, TrainingLogs, TrainingLogEntry, TrainingStopResponse, TrainingResumeResponse, CanonicalTrainingRequest, TrainingPreflightDataset, TrainingPreflightWarning, TrainingPreflightResponse, TrainingCapabilityChoice, TrainingConfigFieldCapability, TrainingCapabilities, GPUChoice, WalletBalance, Transaction, TransactionListResponse, TransactionListParams, GPUInfo, GPUPricingResponse, GPUOptionsParams, GPUOption, GPUOptionSuggestion, GPUOptionsResponse, InferenceStatus, InferenceCreateParams, InferenceUpdateParams, InferenceDeployment, InferenceDeploymentSummary, InferenceCreateResponse, InferenceListResponse, InferenceUpdateResponse, InferenceLifecycleResponse, InferenceDeleteResponse, InferenceGPUOptionMarket, InferenceGPUOption, InferenceGPUAlternative, InferenceGPUOptionsParams, InferenceGPUOptionsResponse, InferenceCanonicalRequest, InferencePreflightWarning, InferencePreflightResponse, AdapterCompatibility, AdapterCompatibilityResponse, AdapterCompatibilityParams, SupportedArchitecture, ArchitectureScope, SupportedArchitecturesResponse, ApiKey, ApiKeyScope, ApiKeyIntrospection, Organization, OrgMember, OrgInvite, Workspace, Integration, IntegrationCreateParams, StorageUsage, StorageObject, PromptTokensDetails, ChatCompletionUsage, } from './types.js';
+export type { BiOSConfig, PaginatedResponse, ApiErrorBody, AvailableGpuAlternative, CapacityMinimumRequirement, InferenceBookingAccepted, Model, ModelSearchParams, ModelSearchResponse, ModelDetailResponse, ModelConfig, Dataset, DatasetListParams, DatasetListResponse, DatasetUploadParams, DatasetPreview, DatasetPreviewParams, DatasetImportHFParams, DatasetRegisterHFParams, DatasetHubSearchParams, DatasetHubPreviewParams, DatasetValidation, DatasetFormatVariant, DatasetFormatSpec, DatasetFormatSpecs, DatasetStorageUsage, TrainingMethod, RLHFAlgorithm, AdapterType, TrainingJobStatus, TrainingStatusFilter, TrainingCreateParams, TrainingListParams, TrainingListResponse, TrainingJob, TrainingMetrics, TrainingResourceMetrics, TrainingDeviceMetrics, MetricPoint, MetricGraphConfig, TrainingCheckpoint, TrainingLogs, TrainingLogEntry, TrainingStopResponse, TrainingResumeResponse, CanonicalTrainingRequest, TrainingPreflightDataset, TrainingPreflightWarning, TrainingPreflightResponse, TrainingCapabilityChoice, TrainingConfigFieldCapability, TrainingCapabilities, GPUChoice, WalletBalance, Transaction, TransactionListResponse, TransactionListParams, GPUInfo, GPUPricingResponse, GPUOptionsParams, GPUOption, GPUOptionSuggestion, GPUOptionsResponse, InferenceStatus, InferenceCreateParams, InferenceUpdateParams, InferenceDeployment, InferenceDeploymentSummary, InferenceCreateResponse, InferenceListResponse, InferenceUpdateResponse, InferenceLifecycleResponse, InferenceDeleteResponse, InferenceGPUOptionMarket, InferenceGPUOption, InferenceGPUAlternative, InferenceGPUOptionsParams, InferenceGPUOptionsResponse, InferenceCanonicalRequest, InferencePreflightWarning, InferencePreflightResponse, AdapterCompatibility, AdapterCompatibilityResponse, AdapterCompatibilityParams, SupportedArchitecture, ArchitectureScope, SupportedArchitecturesResponse, ApiKey, ApiKeyScope, ApiKeyIntrospection, Organization, OrgMember, OrgInvite, Workspace, Integration, IntegrationCreateParams, StorageUsage, StorageObject, PromptTokensDetails, ChatCompletionUsage, } from './types.js';

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

package/dist/resources/loop.d.ts

@@ -171,9 +171,18 @@ export declare class Loop {
      *
      * 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<{
+    label(traceId: string, labels: string[], parent?: string, attributes?: Record<string, string>): Promise<LoopLabel[]>;
+    /**
+     * Set named dimensions on a conversation: `{ category: 'billing',
+     * language: 'es' }`.
+     *
+     * An upsert per dimension, so correcting `category` leaves `task` and any
+     * bare tags exactly where they were — no delete-then-add.
+     */
+    setAttributes(traceId: string, attributes: Record<string, string>): Promise<LoopLabel[]>;
+    unlabel(traceId: string, label: string, key?: string): Promise<{
         deleted: boolean;
+        key: string;
         label: string;
     }>;
     /** Every label in the workspace, with how many conversations carry it. */

package/dist/resources/loop.js

@@ -76,6 +76,16 @@ export class Loop {
             q.set('to', params.to);
         if (params.signalled)
             q.set('signalled', 'true');
+        if (params.label)
+            q.set('label', params.label);
+        // Repeated rather than comma-joined: a value containing a comma would
+        // otherwise silently split into two filters that match nothing.
+        for (const [k, v] of Object.entries(params.attributes ?? {})) {
+            if (k && v)
+                q.append('attr', `${k}:${v}`);
+        }
+        if (params.unlabelled)
+            q.set('unlabelled', 'true');
         if (params.limit != null)
             q.set('limit', String(params.limit));
         if (params.offset != null)
@@ -218,12 +228,24 @@ export class Loop {
      *
      * 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 });
+    async label(traceId, labels, parent, attributes) {
+        const res = await this._http.fetchPost(`/api/loop/traces/${encodeURIComponent(traceId)}/labels`, { labels, parent, attributes });
         return res.labels;
     }
-    async unlabel(traceId, label) {
-        return this._http.fetchDelete(`/api/loop/traces/${encodeURIComponent(traceId)}/labels/${encodeURIComponent(label)}`);
+    /**
+     * Set named dimensions on a conversation: `{ category: 'billing',
+     * language: 'es' }`.
+     *
+     * An upsert per dimension, so correcting `category` leaves `task` and any
+     * bare tags exactly where they were — no delete-then-add.
+     */
+    async setAttributes(traceId, attributes) {
+        const res = await this._http.fetchPost(`/api/loop/traces/${encodeURIComponent(traceId)}/labels`, { attributes });
+        return res.labels;
+    }
+    async unlabel(traceId, label, key) {
+        const q = key ? `?key=${encodeURIComponent(key)}` : '';
+        return this._http.fetchDelete(`/api/loop/traces/${encodeURIComponent(traceId)}/labels/${encodeURIComponent(label)}${q}`);
     }
     /** Every label in the workspace, with how many conversations carry it. */
     async listLabels() {

package/dist/types.d.ts

@@ -759,12 +759,37 @@ export interface TrainingListResponse {
     limit: number;
     offset: number;
 }
+export interface TrainingDeviceMetrics {
+    memory_used_mib: number | null;
+    memory_total_mib: number | null;
+    utilization_pct: number | null;
+    temperature_c: number | null;
+}
+export interface TrainingResourceMetrics {
+    scope: 'worker';
+    sampled_at: string | null;
+    received_at: string;
+    gpu_count: number | null;
+    gpu_memory_used_mib: number | null;
+    gpu_memory_total_mib: number | null;
+    gpu_utilization_pct: number | null;
+    gpu_temperature_c: number | null;
+    host_ram_used_gib: number | null;
+    host_ram_limit_gib: number | null;
+    host_ram_pct: number | null;
+    host_cpu_usage_pct: number | null;
+    host_cpu_limit_cores: number | null;
+    disk_used_gib: number | null;
+    disk_total_gib: number | null;
+    gpus: TrainingDeviceMetrics[];
+}
 /** Training metrics for a job. */
 export interface TrainingMetrics {
     metrics: MetricPoint[];
     training_method?: string | null;
     rlhf_type?: string | null;
     graph_configs: MetricGraphConfig[];
+    resource_metrics?: TrainingResourceMetrics | null;
     /** @deprecated Use metrics. Populated as a compatibility alias. */
     steps?: MetricPoint[];
 }
@@ -921,6 +946,8 @@ export interface TrainingConfigFieldCapability {
     label: string;
     type: 'integer' | 'number' | 'boolean' | 'string' | 'string_array' | 'string_or_string_array' | 'object';
     default: unknown;
+    default_by_adapter?: Record<string, number>;
+    requires_step_horizon?: boolean;
     enabled: boolean;
     disabled_reason?: string;
     aliases?: string[];
@@ -2073,6 +2100,15 @@ export interface LoopTraceListParams {
     to?: string;
     /** Only conversations that already carry a verdict. */
     signalled?: boolean;
+    /** One bare tag. A tag with children matches them too. */
+    label?: string;
+    /**
+     * Named dimensions, ANDed together: `{ category: 'billing', language: 'es' }`.
+     * Exact within their key — `source=support` does not match `team=support`.
+     */
+    attributes?: Record<string, string>;
+    /** Only the conversations nobody has described yet. */
+    unlabelled?: boolean;
     limit?: number;
     offset?: number;
 }
@@ -2095,6 +2131,14 @@ export interface LoopDatasetCreateParams {
     /** Holds back your most recent work, not a random slice. 0-50. */
     holdout_percent?: number;
     max_items?: number;
+    /**
+     * Named dimensions, ANDed with each other and with `label`:
+     * `{ category: 'billing', language: 'es' }`. This is what turns one captured
+     * corpus into a different dataset for every task somebody trains for.
+     */
+    attributes?: Record<string, string>;
+    /** Only the conversations nobody has described yet. */
+    unlabelled?: boolean;
 }
 export interface LoopDataset {
     id: string;
@@ -2358,9 +2402,12 @@ export interface LoopLabel {
     parent: string | null;
     created_by: string | null;
     created_at: string;
+    /** The dimension this value belongs to. `tag` for a bare name. */
+    key: string;
 }
 export interface LoopLabelCount {
     label: string;
     parent: string | null;
     traces: number;
+    key: string;
 }

package/package.json

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