runbios-sdk 0.2.16-dev.259 → 0.2.16-dev.262

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.16-dev.259";
+export declare const VERSION = "0.2.16-dev.262";
 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.16-dev.259';
+export const VERSION = '0.2.16-dev.262';
 export class RunBiOS {
     /** Search models, fetch configs, check adapter compatibility. */
     models;

package/dist/resources/loop.d.ts

@@ -225,9 +225,17 @@ export declare class Loop {
      * 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.
+     * a list of them. The parent applies to the bare `labels` only: sent with
+     * `attributes` and no labels it would group nothing, and is refused.
+     *
+     * Leave `parent` out and a label the conversation already carries keeps
+     * the group it has: re-running `label(id, ['refunds'])` does not take
+     * `refunds` out of `billing`. Pass `''` to take the labels out of their
+     * group; the labels themselves stay.
      *
      * Labels are lowercased and trimmed, so `Refunds` and `refunds` are one label.
+     * A conversation carries at most 32 across every dimension; a label it
+     * already has does not count again.
      */
     label(traceId: string, labels: string[], parent?: string, attributes?: Record<string, string>): Promise<LoopLabel[]>;
     /**

package/dist/resources/loop.js

@@ -288,9 +288,17 @@ export class Loop {
      * 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.
+     * a list of them. The parent applies to the bare `labels` only: sent with
+     * `attributes` and no labels it would group nothing, and is refused.
+     *
+     * Leave `parent` out and a label the conversation already carries keeps
+     * the group it has: re-running `label(id, ['refunds'])` does not take
+     * `refunds` out of `billing`. Pass `''` to take the labels out of their
+     * group; the labels themselves stay.
      *
      * Labels are lowercased and trimmed, so `Refunds` and `refunds` are one label.
+     * A conversation carries at most 32 across every dimension; a label it
+     * already has does not count again.
      */
     async label(traceId, labels, parent, attributes) {
         const res = await this._http.fetchPost(`/api/loop/traces/${encodeURIComponent(traceId)}/labels`, { labels, parent, attributes });

package/dist/types.d.ts

@@ -2571,7 +2571,11 @@ export interface LoopSignalParams {
     labels?: string[];
     /** The same, by dimension: `{ category: 'billing' }`. */
     attributes?: Record<string, string>;
-    /** The master group the bare labels belong to. */
+    /**
+     * The master group the bare labels belong to. Left out, a label the
+     * conversation already carries keeps its group; `''` takes the labels out
+     * of their group.
+     */
     parent?: string;
 }
 export interface LoopTrace {

package/package.json

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