@littlebigbrain/client 0.3.0 → 0.4.1

package/README.md

@@ -95,13 +95,14 @@ and `elapsedMs`.
 | Area | Methods |
 | --- | --- |
 | Write | `graph("main").facts.create` |
+| Managed embeddings | `graph("main").embeddingConfig`, `graph("main").setEmbeddingConfig`, `graph("main").backfillEmbeddings`, `graph("main").promoteEmbedding` |
 | Search | `search.hybrid`, `search.multi`, `search.fullText`, `search.vector` |
 | Context substrate | `context.ask`, `context.suggest`, `context.resolve`, `context.decode`, `context.groundability` |
 | Search feedback (training data) | `search.feedback`, `search.feedbackExport` |
 | Traversal | `traverse`, `semanticTraverse` |
 | Temporal / lineage / shapes | `currentState`, `history`, `why`, `shacl` |
 | Query | `query.sparql`, `query.structured`, `query.analytics`, `query.shacl`, `query.infer`, `query.premises` |
-| Ontology | `ontology.view`, `ontology.conformance`, `ontology.search`, `ontology.resolve`, `ontology.define`, `ontology.evolve` |
+| Ontology | `ontology.view`, `ontology.conformance`, `ontology.search`, `ontology.resolve`, `ontology.define`, `ontology.evolve`, `ontology.induce` |
 | Index lifecycle | `indexes.run`, `indexes.build`, `indexes.delta`, `indexes.gc`, `compact` |
 | Inspection | `entities.list`, `entities.filterByAttributes`, `status`, `metadata`, `summary` |
 | Schema activation | `schema.view`, `schema.preview`, `schema.publish`, `schema.audit` |

package/dist/client.d.ts

@@ -131,6 +131,17 @@ export declare class LbbClient {
     deleteGraph(opts: {
         confirm: string;
     }): Promise<unknown>;
+    embeddingConfig(): Promise<Schemas["ManagedEmbeddingConfigResponse"]>;
+    setEmbeddingConfig(body: Schemas["ManagedEmbeddingConfigRequest"]): Promise<Schemas["ManagedEmbeddingConfigResponse"]>;
+    backfillEmbeddings(opts?: {
+        batchSize?: number;
+        limit?: number;
+        full?: boolean;
+    }): Promise<Schemas["ManagedEmbeddingBackfillResponse"]>;
+    promoteEmbedding(opts: {
+        runId: string;
+        allowRegression?: boolean;
+    }): Promise<Schemas["ManagedEmbeddingPromoteResponse"]>;
     /**
      * The graph's grounding vocabulary as byte-sorted, deduped string sections —
      * the canonical input for a decoder-side automaton (FST/trie) and the
@@ -474,6 +485,8 @@ export declare class LbbClient {
      * migration is needed — and a request that changes nothing is a no-op.
      */
     evolveOntology(body: Schemas["OntologyEvolveRequest"]): Promise<Schemas["OntologyEvolveResponse"]>;
+    /** Suggest ontology additions from the current graph without mutating it. */
+    induceOntology(body: Schemas["OntologyInduceRequest"]): Promise<Schemas["OntologyInduceResponse"]>;
     /**
      * Build default ANN + BM25 indexes. With `{ background: true }` the build
      * runs detached on the server and the call returns immediately — use it for

package/dist/client.js

@@ -389,6 +389,22 @@ export class LbbClient {
             query: { confirm: opts.confirm },
         });
     }
+    embeddingConfig() {
+        return this.request("GET", "/v1/graph/embedding");
+    }
+    setEmbeddingConfig(body) {
+        return this.request("POST", "/v1/graph/embedding", { body });
+    }
+    backfillEmbeddings(opts = {}) {
+        return this.request("POST", "/v1/graph/embedding/backfill", {
+            query: { batch_size: opts.batchSize, limit: opts.limit, full: opts.full },
+        });
+    }
+    promoteEmbedding(opts) {
+        return this.request("POST", "/v1/graph/embedding/promote", {
+            query: { run_id: opts.runId, allow_regression: opts.allowRegression },
+        });
+    }
     // --- models as runs (training-run registry + eval machinery) ---
     /**
      * The graph's grounding vocabulary as byte-sorted, deduped string sections —
@@ -852,6 +868,10 @@ export class LbbClient {
     evolveOntology(body) {
         return this.request("POST", "/v1/ontology/evolve", { body });
     }
+    /** Suggest ontology additions from the current graph without mutating it. */
+    induceOntology(body) {
+        return this.request("POST", "/v1/ontology/induce", { body, retry: true });
+    }
     // --- index lifecycle ---
     /**
      * Build default ANN + BM25 indexes. With `{ background: true }` the build

package/dist/namespaces.d.ts

@@ -33,6 +33,17 @@ export declare class GraphNamespace {
     delete(opts: {
         confirm: string;
     } & CallOptions): Promise<unknown>;
+    embeddingConfig(opts?: CallOptions): Promise<Schemas["ManagedEmbeddingConfigResponse"]>;
+    setEmbeddingConfig(body: Schemas["ManagedEmbeddingConfigRequest"], opts?: CallOptions): Promise<Schemas["ManagedEmbeddingConfigResponse"]>;
+    backfillEmbeddings(options?: CallOptions & {
+        batchSize?: number;
+        limit?: number;
+        full?: boolean;
+    }): Promise<Schemas["ManagedEmbeddingBackfillResponse"]>;
+    promoteEmbedding(options: CallOptions & {
+        runId: string;
+        allowRegression?: boolean;
+    }): Promise<Schemas["ManagedEmbeddingPromoteResponse"]>;
     /** Retract edges/entities from the scoped graph. See {@link LbbClient.retract}. */
     retract(body: Schemas["GraphRetractRequest"], opts?: CallOptions): Promise<Schemas["GraphRetractResponse"]>;
     /** Export this graph's current snapshot as Turtle, N-Triples, TriG, or N-Quads. */
@@ -170,6 +181,7 @@ export declare class OntologyNamespace {
     resolve(body: Schemas["OntologyResolveRequest"], opts?: CallOptions): Promise<Schemas["OntologyResolveResponse"]>;
     define(body: Schemas["OntologyDefineRequest"], opts?: CallOptions): Promise<Schemas["OntologyDefineResponse"]>;
     evolve(body: Schemas["OntologyEvolveRequest"], opts?: CallOptions): Promise<Schemas["OntologyEvolveResponse"]>;
+    induce(body: Schemas["OntologyInduceRequest"], opts?: CallOptions): Promise<Schemas["OntologyInduceResponse"]>;
 }
 /** Structured, SPARQL-text, reasoning, and analytical query operations. */
 export declare class QueryNamespace {

package/dist/namespaces.js

@@ -43,6 +43,29 @@ export class GraphNamespace {
             query: { confirm },
         });
     }
+    embeddingConfig(opts = {}) {
+        return this.client.request("GET", "/v1/graph/embedding", opts);
+    }
+    setEmbeddingConfig(body, opts = {}) {
+        return this.client.request("POST", "/v1/graph/embedding", {
+            ...opts,
+            body,
+        });
+    }
+    backfillEmbeddings(options = {}) {
+        const { batchSize, limit, full, ...request } = options;
+        return this.client.request("POST", "/v1/graph/embedding/backfill", {
+            ...request,
+            query: { batch_size: batchSize, limit, full },
+        });
+    }
+    promoteEmbedding(options) {
+        const { runId, allowRegression, ...request } = options;
+        return this.client.request("POST", "/v1/graph/embedding/promote", {
+            ...request,
+            query: { run_id: runId, allow_regression: allowRegression },
+        });
+    }
     /** Retract edges/entities from the scoped graph. See {@link LbbClient.retract}. */
     retract(body, opts = {}) {
         return this.client.request("POST", "/v1/graph/retract", {
@@ -413,6 +436,13 @@ export class OntologyNamespace {
             body,
         });
     }
+    induce(body, opts = {}) {
+        return this.client.request("POST", "/v1/ontology/induce", {
+            ...opts,
+            retry: opts.retry ?? true,
+            body,
+        });
+    }
 }
 /** Structured, SPARQL-text, reasoning, and analytical query operations. */
 export class QueryNamespace {