@littlebigbrain/client 0.13.2 → 0.14.0

package/dist/client.d.ts

@@ -8,14 +8,13 @@ export type { CallOptions, Query, QueryValue, RequestOptions, } from "./transpor
 export { EntityNamespace, FactsNamespace, GraphNamespace, OntologyNamespace, QueryNamespace, SchemaNamespace, SearchNamespace, } from "./namespaces.js";
 /**
  * A typed HTTP client for a little big brain graph server. One instance is scoped to a
- * single graph/branch; construct another for a different scope. All methods
+ * single graph; construct another for a different scope. All methods
  * return the parsed JSON response and throw {@link LbbError} on failure.
  */
 export declare class LbbClient {
     private readonly baseUrl;
     private readonly apiKey?;
     private readonly graphName?;
-    private readonly branchName?;
     private readonly stack?;
     private readonly fetchImpl;
     private readonly apiVersion;
@@ -38,17 +37,15 @@ export declare class LbbClient {
     readonly embeddings: EmbeddingsNamespace;
     constructor(options: LbbClientOptions);
     graph(name: string, opts?: {
-        branch?: string;
         stack?: string;
     }): GraphNamespace;
     /**
-     * A new client for a different graph/branch on the same server and credential.
-     * Each instance is scoped to one graph/branch, so use this to target another
+     * A new client for a different graph on the same server and credential.
+     * Each instance is scoped to one graph, so use this to target another
      * scope (e.g. creating a fresh graph) without mutating the current client.
      */
     withScope(scope: {
         graph?: string;
-        branch?: string;
         stack?: string;
     }): LbbClient;
     /**
@@ -142,8 +139,8 @@ export declare class LbbClient {
         idempotencyKey?: string;
     }): Promise<Schemas["GraphRetractResponse"]>;
     /**
-     * Create the scoped graph/branch with an empty ontology. Construct the client
-     * with the desired graph/branch first, then call `ontology.define` before
+     * Create the scoped graph with an empty ontology. Construct the client
+     * with the desired graph first, then call `ontology.define` before
      * writing typed data.
      */
     createGraph(): Promise<Schemas["CreateGraphResponse"]>;
@@ -183,33 +180,10 @@ export declare class LbbClient {
         observedAt?: string;
         idempotencyKey?: string;
     }): Promise<Schemas["GraphReloadResponse"]>;
-    /** Fork the scoped branch from an existing branch in the same graph. */
-    createBranch(body: Schemas["GraphBranchCreateRequest"]): Promise<Schemas["GraphBranchCreateResponse"]>;
-    /**
-     * Validate-then-merge: replay `from_branch`'s post-fork commits onto the
-     * SCOPED branch (its fork parent) as one new commit. A write — sends an
-     * Idempotency-Key so a retry replays instead of re-applying.
-     */
-    mergeBranch(body: Schemas["GraphBranchMergeRequest"], opts?: {
-        idempotencyKey?: string;
-    }): Promise<Schemas["GraphBranchMergeResponse"]>;
-    /**
-     * Observe: store a conversation episode verbatim as EPISODE evidence,
-     * anchor + gate extracted facts on an observe branch, and optionally
-     * auto-merge when validation is clean. Flag-gated server-side
-     * (`--enable-observe`). A write — carries an Idempotency-Key.
-     */
-    observe(body: Schemas["ObserveRequest"], opts?: {
-        idempotencyKey?: string;
-    }): Promise<Schemas["ObserveResponse"]>;
-    /** Delete the scoped graph, including every branch, feedback, and active graph-scoped job. */
+    /** Delete the scoped graph, including its feedback and active graph-scoped jobs. */
     deleteGraph(opts: {
         confirm: string;
     }): Promise<Schemas["GraphDeleteResponse"]>;
-    /** Delete only the scoped branch. The server refuses to delete a graph's final live branch. */
-    deleteBranch(opts: {
-        confirm: string;
-    }): Promise<Schemas["GraphBranchDeleteResponse"]>;
     /**
      * Captured signals by flush-seq range, oldest first — the model-training
      * feed. The `seq` on each signal is the temporal-split coordinate (train ≤ T,
@@ -285,16 +259,6 @@ export declare class LbbClient {
     externalPlannerTrace(payload: Schemas["ExternalPlannerTraceV1"], opts?: {
         idempotencyKey?: string;
     }): Promise<Schemas["SignalIngestResponse"]>;
-    /** Planner training examples at or before an optional signal split. */
-    plannerDataset(opts?: {
-        limit?: number;
-        splitSeq?: number;
-    }): Promise<Schemas["PlannerDatasetResponse"]>;
-    /** Planner preference pairs at or before an optional signal split. */
-    plannerPreferenceDataset(opts?: {
-        limit?: number;
-        splitSeq?: number;
-    }): Promise<Schemas["PlannerPreferenceDatasetResponse"]>;
     /** Suggest-ranker examples at or before an optional signal split. */
     suggestDataset(opts?: {
         limit?: number;
@@ -314,14 +278,6 @@ export declare class LbbClient {
         runId: string;
         allowRegression?: boolean;
     }): Promise<unknown>;
-    /**
-     * Promote a finished `planner_lora` training run: gated on held-out slot
-     * exactness and recorded as a `kind=planner` training run.
-     */
-    promotePlanner(opts: {
-        runId: string;
-        allowRegression?: boolean;
-    }): Promise<unknown>;
     /**
      * Append relevance labels for a set of ranked results — how little big brain
      * gathers customer-specific qrels. Grade results (3 ideal/good, 1 partial,
@@ -489,6 +445,6 @@ export declare class LbbClient {
      * rebuild fills it.
      */
     schemaSummary(): Promise<Schemas["RdfSchemaSummaryResponse"]>;
-    /** List the graphs (and branches) under the scoped tenant. */
+    /** List the graphs under the scoped tenant. */
     listGraphs(): Promise<Schemas["GraphListResponse"]>;
 }

package/dist/client.js

@@ -84,14 +84,13 @@ async function durableImportBody(source) {
 }
 /**
  * A typed HTTP client for a little big brain graph server. One instance is scoped to a
- * single graph/branch; construct another for a different scope. All methods
+ * single graph; construct another for a different scope. All methods
  * return the parsed JSON response and throw {@link LbbError} on failure.
  */
 export class LbbClient {
     baseUrl;
     apiKey;
     graphName;
-    branchName;
     stack;
     fetchImpl;
     apiVersion;
@@ -120,7 +119,6 @@ export class LbbClient {
         this.baseUrl = baseUrl.replace(/\/+$/, "");
         this.apiKey = options.apiKey;
         this.graphName = options.graph;
-        this.branchName = options.branch;
         this.stack = options.stack;
         this.apiVersion = options.apiVersion ?? "2026-07-23";
         this.maxRetries = options.maxRetries ?? 6;
@@ -160,13 +158,12 @@ export class LbbClient {
     graph(name, opts = {}) {
         return new GraphNamespace(this.withScope({
             graph: name,
-            branch: opts.branch ?? this.branchName,
             stack: opts.stack ?? this.stack,
         }));
     }
     /**
-     * A new client for a different graph/branch on the same server and credential.
-     * Each instance is scoped to one graph/branch, so use this to target another
+     * A new client for a different graph on the same server and credential.
+     * Each instance is scoped to one graph, so use this to target another
      * scope (e.g. creating a fresh graph) without mutating the current client.
      */
     withScope(scope) {
@@ -174,7 +171,6 @@ export class LbbClient {
             baseUrl: this.baseUrl,
             apiKey: this.apiKey,
             graph: scope.graph ?? this.graphName,
-            branch: scope.branch ?? this.branchName,
             stack: scope.stack ?? this.stack,
             fetch: this.fetchImpl,
             apiVersion: this.apiVersion,
@@ -222,8 +218,6 @@ export class LbbClient {
         const push = (key, value) => params.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
         if (this.graphName !== undefined)
             push("graph", this.graphName);
-        if (this.branchName !== undefined)
-            push("branch", this.branchName);
         if (this.stack !== undefined)
             push("stack", this.stack);
         for (const [key, value] of Object.entries(query ?? {})) {
@@ -604,8 +598,8 @@ export class LbbClient {
         });
     }
     /**
-     * Create the scoped graph/branch with an empty ontology. Construct the client
-     * with the desired graph/branch first, then call `ontology.define` before
+     * Create the scoped graph with an empty ontology. Construct the client
+     * with the desired graph first, then call `ontology.define` before
      * writing typed data.
      */
     createGraph() {
@@ -658,46 +652,13 @@ export class LbbClient {
             idempotencyKey: opts.idempotencyKey ?? this.idempotencyKey("reload"),
         });
     }
-    /** Fork the scoped branch from an existing branch in the same graph. */
-    createBranch(body) {
-        return this.request("POST", "/v1/graph/branch", { body });
-    }
-    /**
-     * Validate-then-merge: replay `from_branch`'s post-fork commits onto the
-     * SCOPED branch (its fork parent) as one new commit. A write — sends an
-     * Idempotency-Key so a retry replays instead of re-applying.
-     */
-    mergeBranch(body, opts = {}) {
-        return this.request("POST", "/v1/graph/branch/merge", {
-            body,
-            idempotencyKey: opts.idempotencyKey ?? this.idempotencyKey("branch-merge"),
-        });
-    }
-    /**
-     * Observe: store a conversation episode verbatim as EPISODE evidence,
-     * anchor + gate extracted facts on an observe branch, and optionally
-     * auto-merge when validation is clean. Flag-gated server-side
-     * (`--enable-observe`). A write — carries an Idempotency-Key.
-     */
-    observe(body, opts = {}) {
-        return this.request("POST", "/v1/memory/observe", {
-            body,
-            idempotencyKey: opts.idempotencyKey ?? this.idempotencyKey("observe"),
-        });
-    }
-    /** Delete the scoped graph, including every branch, feedback, and active graph-scoped job. */
+    /** Delete the scoped graph, including its feedback and active graph-scoped jobs. */
     deleteGraph(opts) {
         return this.request("POST", "/v1/graph/delete", {
             query: { confirm: opts.confirm },
             retry: true,
         });
     }
-    /** Delete only the scoped branch. The server refuses to delete a graph's final live branch. */
-    deleteBranch(opts) {
-        return this.request("DELETE", "/v1/graph/branch", {
-            query: { confirm: opts.confirm },
-        });
-    }
     // --- models as runs (training-run registry + eval machinery) ---
     /**
      * Captured signals by flush-seq range, oldest first — the model-training
@@ -803,18 +764,6 @@ export class LbbClient {
             ],
         }, opts);
     }
-    /** Planner training examples at or before an optional signal split. */
-    plannerDataset(opts = {}) {
-        return this.request("GET", "/v1/models/planner-dataset", {
-            query: { limit: opts.limit, split_seq: opts.splitSeq },
-        });
-    }
-    /** Planner preference pairs at or before an optional signal split. */
-    plannerPreferenceDataset(opts = {}) {
-        return this.request("GET", "/v1/models/planner-preference-dataset", {
-            query: { limit: opts.limit, split_seq: opts.splitSeq },
-        });
-    }
     /** Suggest-ranker examples at or before an optional signal split. */
     suggestDataset(opts = {}) {
         return this.request("GET", "/v1/models/suggest-dataset", {
@@ -837,15 +786,6 @@ export class LbbClient {
             query: { run_id: opts.runId, allow_regression: opts.allowRegression },
         });
     }
-    /**
-     * Promote a finished `planner_lora` training run: gated on held-out slot
-     * exactness and recorded as a `kind=planner` training run.
-     */
-    promotePlanner(opts) {
-        return this.request("POST", "/v1/models/promote-planner", {
-            query: { run_id: opts.runId, allow_regression: opts.allowRegression },
-        });
-    }
     // --- relevance feedback ---
     /**
      * Append relevance labels for a set of ranked results — how little big brain
@@ -1128,7 +1068,7 @@ export class LbbClient {
     schemaSummary() {
         return this.request("GET", "/v1/graph/schema-summary");
     }
-    /** List the graphs (and branches) under the scoped tenant. */
+    /** List the graphs under the scoped tenant. */
     listGraphs() {
         return this.request("GET", "/v1/graphs");
     }

package/dist/namespaces.d.ts

@@ -12,10 +12,9 @@ export declare class GraphNamespace {
     readonly evals: EvalsNamespace;
     readonly embeddings: EmbeddingsNamespace;
     constructor(client: LbbClient);
-    branch(name: string): GraphNamespace;
-    /** Publication lifecycle for this graph/branch, including pre-first-publish state. */
+    /** Publication lifecycle for this graph, including pre-first-publish state. */
     publicationStatus(): Promise<Schemas["PublicationStatusResponse"]>;
-    /** Wait until this graph/branch has an exact generation covering `targetSeq`. */
+    /** Wait until this graph has an exact generation covering `targetSeq`. */
     waitForPublished(targetSeq: number, opts?: {
         timeoutMs?: number;
         pollIntervalMs?: number;
@@ -24,9 +23,6 @@ export declare class GraphNamespace {
     delete(opts: {
         confirm: string;
     } & CallOptions): Promise<Schemas["GraphDeleteResponse"]>;
-    deleteBranch(opts: {
-        confirm: string;
-    } & CallOptions): Promise<Schemas["GraphBranchDeleteResponse"]>;
     /** Retract edges/entities from the scoped graph. See {@link LbbClient.retract}. */
     retract(body: Schemas["GraphRetractRequest"], opts?: CallOptions): Promise<Schemas["GraphRetractResponse"]>;
 }
@@ -96,7 +92,7 @@ export declare class EntityNamespace {
 export declare class EmbeddingsNamespace {
     private readonly client;
     constructor(client: LbbClient);
-    /** Every embedding of the branch with its status. */
+    /** Every embedding of the graph with its status. */
     list(opts?: CallOptions): Promise<Schemas["EmbeddingListResponse"]>;
     /** One embedding: serving and building version, backfill, lag, recall. */
     get(name: string, opts?: CallOptions): Promise<Schemas["EmbeddingStatus"]>;

package/dist/namespaces.js

@@ -37,14 +37,11 @@ export class GraphNamespace {
         this.evals = client.evals;
         this.embeddings = client.embeddings;
     }
-    branch(name) {
-        return new GraphNamespace(this.client.withScope({ branch: name }));
-    }
-    /** Publication lifecycle for this graph/branch, including pre-first-publish state. */
+    /** Publication lifecycle for this graph, including pre-first-publish state. */
     publicationStatus() {
         return this.client.publicationStatus();
     }
-    /** Wait until this graph/branch has an exact generation covering `targetSeq`. */
+    /** Wait until this graph has an exact generation covering `targetSeq`. */
     waitForPublished(targetSeq, opts = {}) {
         return this.client.waitForPublished(targetSeq, opts);
     }
@@ -59,13 +56,6 @@ export class GraphNamespace {
             retry: request.retry ?? true,
         });
     }
-    deleteBranch(opts) {
-        const { confirm, ...request } = opts;
-        return this.client.request("DELETE", "/v1/graph/branch", {
-            ...request,
-            query: { confirm },
-        });
-    }
     /** Retract edges/entities from the scoped graph. See {@link LbbClient.retract}. */
     retract(body, opts = {}) {
         return this.client.request("POST", "/v1/graph/retract", {
@@ -214,7 +204,7 @@ export class EmbeddingsNamespace {
     constructor(client) {
         this.client = client;
     }
-    /** Every embedding of the branch with its status. */
+    /** Every embedding of the graph with its status. */
     list(opts = {}) {
         return this.client.request("GET", "/v1/embeddings", opts);
     }