@littlebigbrain/client 0.2.0 → 0.4.0

package/README.md

@@ -1,6 +1,6 @@
 # @littlebigbrain/client
 
-TypeScript client for the [Little Big Brain](https://littlebigbrain.com) graph + hybrid search HTTP
+TypeScript client for the [little big brain](https://littlebigbrain.com) graph + hybrid search HTTP
 API. Request and response types are generated from the committed
 [`contracts/openapi.json`](https://github.com/littlebigbrains/lbb-typescript/blob/main/contracts/openapi.json) (the single source of
 truth, derived from the Rust `lbb-api` types); the client itself is a thin,
@@ -95,17 +95,17 @@ 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` |
-| Database admin | `admin.createStack`, `admin.stack`, `admin.rotateStackKey`, `admin.deleteStack` |
 
 Common request/response shapes have direct imports such as `SearchRequest`,
 `SearchResponse`, `Entity`, `GraphSummary`, `CommitRequest`, `AskResponse`, and

package/dist/client.d.ts

@@ -1,14 +1,14 @@
-import type { ImportLine, LbbAdminSessionResponse, LbbAdminStackCreateRequest, LbbAdminStackDeleteResponse, LbbAdminStackResponse, LbbClientOptions, LbbStackActivityResponse, LbbStackActivityWindow, ListResponse, RawLbbResponse, Schemas, SparqlResults } from "./types.js";
+import type { ImportLine, LbbClientOptions, LbbStackActivityResponse, LbbStackActivityWindow, ListResponse, RawLbbResponse, RdfExportOptions, RdfImportOptions, Schemas, SparqlResults } from "./types.js";
 import { type RequestOptions } from "./transport.js";
-import { AdminNamespace, ContextNamespace, EntityNamespace, GraphNamespace, IndexNamespace, OntologyNamespace, QueryNamespace, SchemaNamespace, SearchNamespace } from "./namespaces.js";
+import { ContextNamespace, EntityNamespace, GraphNamespace, IndexNamespace, OntologyNamespace, QueryNamespace, SchemaNamespace, SearchNamespace } from "./namespaces.js";
 export { parseSparqlResults } from "./types.js";
-export type { AttributeFilter, AttributeFilterOp, AttributeFilterValue, EntityAttributeFilterOptions, EntityPropertiesLine, FetchLike, FlatProperties, ImportLine, LbbAdminSessionResponse, LbbAdminStackCreateRequest, LbbAdminStackDeleteResponse, LbbAdminStackResponse, LbbClientOptions, LbbRequestEvent, LbbResponseEvent, LbbErrorPayload, LbbStackActivityResponse, LbbStackActivityWindow, LbbStackView, ListResponse, RawLbbResponse, Schemas, SparqlResults, SparqlResultsJson, SparqlTerm, AskRequest, AskResponse, CommitRequest, CommitResponse, Entity, EntitySelector, GraphMetadata, GraphSummary, SchemaView, SearchRequest, SearchResponse, SearchResult, Snapshot, } from "./types.js";
+export type { AttributeFilter, AttributeFilterOp, AttributeFilterValue, EntityAttributeFilterOptions, EntityPropertiesLine, FetchLike, FlatProperties, ImportLine, LbbClientOptions, LbbRequestEvent, LbbResponseEvent, LbbErrorPayload, LbbStackActivityResponse, LbbStackActivityWindow, ListResponse, RawLbbResponse, RdfExportOptions, RdfImportOptions, Schemas, SparqlResults, SparqlResultsJson, SparqlTerm, AskRequest, AskResponse, CommitRequest, CommitResponse, Entity, EntitySelector, GraphMetadata, GraphSummary, SchemaView, SearchRequest, SearchResponse, SearchResult, Snapshot, } from "./types.js";
 export { LbbError } from "./transport.js";
 export type { CallOptions, Query, QueryValue, RequestOptions, } from "./transport.js";
 export type { EntityListOptions, HybridSearchOptions } from "./namespaces.js";
-export { AdminNamespace, ContextNamespace, EntityNamespace, FactsNamespace, GraphNamespace, IndexNamespace, OntologyNamespace, QueryNamespace, SchemaNamespace, SearchNamespace, } from "./namespaces.js";
+export { ContextNamespace, EntityNamespace, FactsNamespace, GraphNamespace, IndexNamespace, OntologyNamespace, QueryNamespace, SchemaNamespace, SearchNamespace, } from "./namespaces.js";
 /**
- * A typed HTTP client for a Little Big Brain graph server. One instance is scoped to a
+ * 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
  * return the parsed JSON response and throw {@link LbbError} on failure.
  */
@@ -25,7 +25,6 @@ export declare class LbbClient {
     private readonly timeoutMs;
     private readonly onRequest?;
     private readonly onResponse?;
-    readonly admin: AdminNamespace;
     readonly context: ContextNamespace;
     readonly search: SearchNamespace;
     readonly indexes: IndexNamespace;
@@ -87,18 +86,13 @@ export declare class LbbClient {
         idempotencyKey?: string;
     }): Promise<Schemas["GraphImportResponse"]>;
     /**
-     * Bulk-ingest N-Triples without client-side conversion. Resource-object
+     * Bulk-ingest N-Triples, Turtle, N-Quads, or TriG without client-side conversion. Resource-object
      * triples become keyed Resource edges; literal-object triples become text
      * properties on the subject Resource.
      */
-    importRdf(ntriples: string, opts?: {
-        batch?: number;
-        strict?: boolean;
-        observedAt?: string;
-        resourceType?: string;
-        edgeIdempotency?: "append" | "skip_unchanged";
-        idempotencyKey?: string;
-    }): Promise<Schemas["GraphRdfImportResponse"]>;
+    importRdf(rdf: string, opts?: RdfImportOptions): Promise<Schemas["GraphRdfImportResponse"]>;
+    /** Export the snapshot-visible RDF projection as Turtle, N-Triples, TriG, or N-Quads. */
+    exportRdf(opts?: RdfExportOptions): Promise<string>;
     /**
      * Retract specific edges and/or every edge touching given entities. Appends
      * superseding retract events rather than deleting — history stays visible in an
@@ -113,7 +107,7 @@ export declare class LbbClient {
     /** Fork the scoped branch from an existing branch in the same graph. */
     createBranch(body: Schemas["GraphBranchCreateRequest"]): Promise<Schemas["GraphBranchCreateResponse"]>;
     /**
-     * WS16 validate-then-merge: replay `from_branch`'s post-fork commits onto the
+     * 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.
      */
@@ -121,7 +115,7 @@ export declare class LbbClient {
         idempotencyKey?: string;
     }): Promise<Schemas["GraphBranchMergeResponse"]>;
     /**
-     * WS15 observe: store a conversation episode verbatim as EPISODE evidence,
+     * 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.
@@ -137,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
@@ -147,7 +152,7 @@ export declare class LbbClient {
         limit?: number;
     }): Promise<Schemas["VocabExportResponse"]>;
     /**
-     * Captured signals by flush-seq range, oldest first — the flywheel training
+     * Captured signals by flush-seq range, oldest first — the model-training
      * feed. The `seq` on each signal is the temporal-split coordinate (train ≤ T,
      * eval > T).
      */
@@ -256,7 +261,7 @@ export declare class LbbClient {
     }): Promise<Schemas["ExtractorDatasetResponse"]>;
     /**
      * Promote a finished `extractor_lora` training run: gated on held-out fact
-     * F1, recorded as a WS9 `kind=extractor` run whose adapter resident
+     * F1, recorded as a `kind=extractor` training run whose adapter resident
      * extraction then serves.
      */
     promoteExtractor(opts: {
@@ -265,7 +270,7 @@ export declare class LbbClient {
     }): Promise<unknown>;
     /**
      * Promote a finished `planner_lora` training run: gated on held-out slot
-     * exactness, recorded as a WS9 `kind=planner` run whose adapter `/v1/ask`
+     * exactness, recorded as a `kind=planner` training run whose adapter `/v1/ask`
      * then serves.
      */
     promotePlanner(opts: {
@@ -278,29 +283,29 @@ export declare class LbbClient {
     multiSearch(body: Schemas["HybridMultiSearchRequest"]): Promise<Schemas["HybridMultiSearchResponse"]>;
     /**
      * Grounded prefix completion from the index vocabulary + ontology. Optionally
-     * narrow relation completions by a type-signature `context` (WS10) — a type
+     * narrow relation completions by a type-signature `context` — a type
      * pair that admits a single relation flags `signature_forced`.
      */
     suggest(body: Schemas["SearchSuggestRequest"]): Promise<Schemas["SearchSuggestResponse"]>;
     /**
-     * Snap free text to the nearest real vocabulary item (WS11). Embedding cosine
+     * Snap free text to the nearest real vocabulary item. Embedding cosine
      * on a managed graph, else lexical; never fabricates a term.
      */
     resolveTerm(body: Schemas["ResolveTermRequest"]): Promise<Schemas["ResolveTermResponse"]>;
     /**
      * Ground a natural-language question to the graph's real vocabulary, retrieve
-     * against the pinned snapshot, and answer with citations (WS12, `/v1/ask`).
+     * against the pinned snapshot, and answer with citations (`/v1/ask`).
      */
     ask(body: Schemas["AskRequest"]): Promise<Schemas["AskResponse"]>;
     /**
      * Name the relation between two entities (`/v1/decode`): the DB narrows the
-     * candidates to the type pair's admissible relations (WS10), answers alone
+     * candidates to the type pair's admissible relations, answers alone
      * when the pair forces a single relation, and otherwise decodes it with the
      * graph-native fine-tuned model — the "DB narrows, cheap model decodes" call.
      */
     decode(body: Schemas["DecodeRequest"]): Promise<Schemas["DecodeResponse"]>;
     /**
-     * Report which completion mechanisms will carry on this graph (WS13):
+     * Report which completion mechanisms will carry on this graph:
      * signature sparsity, name semantics, sampled narrowing recall, and a
      * narrow / narrow+finetune / lexical-first recommendation.
      */
@@ -308,7 +313,7 @@ export declare class LbbClient {
         sample?: number;
     }): Promise<Schemas["GroundabilityReport"]>;
     /**
-     * Append relevance labels for a set of search results — how Little Big Brain
+     * Append relevance labels for a set of search results — how little big brain
      * gathers customer-specific qrels. Grade results (3 ideal/good, 1 partial,
      * 0 bad), referencing the search response's `search_id` so labels tie back to
      * that ranking. Stored apart from customer facts and exported via
@@ -443,7 +448,7 @@ export declare class LbbClient {
     /** The rule set stored on the scoped graph branch (version + rules). */
     graphRules(): Promise<Schemas["RuleSet"]>;
     /**
-     * Stage G — derive edges from calibrated retrieval matches (preview): each
+     * Derive edges from calibrated retrieval matches (preview): each
      * candidate scored `P >= threshold` becomes a derived edge `(anchor, relation,
      * matched)` with a typed `Retrieval` provenance leaf. Pass either explicit
      * `candidates` or a `query` the server runs as BM25 entity retrieval.
@@ -480,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
@@ -518,22 +525,6 @@ export declare class LbbClient {
     summary(): Promise<Schemas["GraphSummaryResponse"]>;
     /** List the graphs (and branches) under the scoped tenant. */
     listGraphs(): Promise<Schemas["GraphListResponse"]>;
-    /** Create a database stack and return its one-time stack API key. */
-    adminCreateStack(body: LbbAdminStackCreateRequest): Promise<LbbAdminStackResponse>;
-    /** Inspect a database stack without returning secret key material. */
-    adminStack(slug: string): Promise<LbbAdminStackResponse>;
-    /** Rotate a database stack key and return the new one-time API key. */
-    adminRotateStackKey(slug: string): Promise<LbbAdminStackResponse>;
-    /** Delete a database stack after confirming the slug. */
-    adminDeleteStack(slug: string): Promise<LbbAdminStackDeleteResponse>;
-    /**
-     * Mint a short-lived `lbb_ses_…` session token for an account. A trusted
-     * co-located service uses it (with `?stack=<slug>`) to call the data plane on
-     * the account's behalf without handling the stack's mode-bearing stack key.
-     */
-    adminMintSession(accountId: string, ttlSeconds?: number): Promise<LbbAdminSessionResponse>;
-    /** Customer-visible activity for one database stack. */
-    adminStackActivity(slug: string, window?: LbbStackActivityWindow): Promise<LbbStackActivityResponse>;
     /** Activity for the stack selected by the bearer stack key or session. */
     stackActivity(window?: LbbStackActivityWindow): Promise<LbbStackActivityResponse>;
 }

package/dist/client.js

@@ -1,11 +1,11 @@
 import { parseSparqlResults } from "./types.js";
 import { parseLbbError, parseResponseJson, retryAllowed, retryDelayForAttempt, retryableStatus, sleep, } from "./transport.js";
-import { AdminNamespace, ContextNamespace, EntityNamespace, GraphNamespace, IndexNamespace, OntologyNamespace, QueryNamespace, SchemaNamespace, SearchNamespace, } from "./namespaces.js";
+import { ContextNamespace, EntityNamespace, GraphNamespace, IndexNamespace, OntologyNamespace, QueryNamespace, SchemaNamespace, SearchNamespace, } from "./namespaces.js";
 export { parseSparqlResults } from "./types.js";
 export { LbbError } from "./transport.js";
-export { AdminNamespace, ContextNamespace, EntityNamespace, FactsNamespace, GraphNamespace, IndexNamespace, OntologyNamespace, QueryNamespace, SchemaNamespace, SearchNamespace, } from "./namespaces.js";
+export { ContextNamespace, EntityNamespace, FactsNamespace, GraphNamespace, IndexNamespace, OntologyNamespace, QueryNamespace, SchemaNamespace, SearchNamespace, } from "./namespaces.js";
 /**
- * A typed HTTP client for a Little Big Brain graph server. One instance is scoped to a
+ * 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
  * return the parsed JSON response and throw {@link LbbError} on failure.
  */
@@ -22,7 +22,6 @@ export class LbbClient {
     timeoutMs;
     onRequest;
     onResponse;
-    admin;
     context;
     search;
     indexes;
@@ -57,7 +56,6 @@ export class LbbClient {
             throw new Error("no fetch implementation available; pass options.fetch");
         }
         this.fetchImpl = chosen;
-        this.admin = new AdminNamespace(this);
         this.context = new ContextNamespace(this);
         this.search = new SearchNamespace(this);
         this.indexes = new IndexNamespace(this);
@@ -213,9 +211,16 @@ export class LbbClient {
         });
         if (!response.ok)
             throw parseLbbError(response.status, text.trim(), requestId);
+        const responseContentType = response.headers?.get("content-type")?.toLowerCase() ?? "";
+        const isRdfText = responseContentType.includes("text/turtle") ||
+            responseContentType.includes("application/n-triples") ||
+            responseContentType.includes("application/trig") ||
+            responseContentType.includes("application/n-quads");
         return {
             data: text
-                ? parseResponseJson(text, response.status, requestId)
+                ? isRdfText
+                    ? text
+                    : parseResponseJson(text, response.status, requestId)
                 : undefined,
             status: response.status,
             requestId,
@@ -289,25 +294,48 @@ export class LbbClient {
         });
     }
     /**
-     * Bulk-ingest N-Triples without client-side conversion. Resource-object
+     * Bulk-ingest N-Triples, Turtle, N-Quads, or TriG without client-side conversion. Resource-object
      * triples become keyed Resource edges; literal-object triples become text
      * properties on the subject Resource.
      */
-    importRdf(ntriples, opts = {}) {
+    importRdf(rdf, opts = {}) {
+        const format = opts.format ?? "ntriples";
+        const contentTypes = {
+            ntriples: "application/n-triples",
+            turtle: "text/turtle",
+            nquads: "application/n-quads",
+            trig: "application/trig",
+        };
         return this.request("POST", "/v1/graph/import/rdf", {
-            rawBody: ntriples,
-            contentType: "application/n-triples",
+            rawBody: rdf,
+            contentType: contentTypes[format],
             query: {
                 batch: opts.batch,
                 strict: opts.strict,
                 observed_at: opts.observedAt,
-                format: "ntriples",
+                format,
+                base_iri: opts.baseIri,
+                graph_uri: opts.graphUri,
+                blank_node_scope: opts.blankNodeScope,
                 resource_type: opts.resourceType,
                 edge_idempotency: opts.edgeIdempotency,
             },
             idempotencyKey: opts.idempotencyKey ?? this.idempotencyKey("import-rdf"),
         });
     }
+    /** Export the snapshot-visible RDF projection as Turtle, N-Triples, TriG, or N-Quads. */
+    exportRdf(opts = {}) {
+        return this.request("GET", "/v1/graph/export/rdf", {
+            query: {
+                format: opts.format === "ntriples" ? "nt" : opts.format,
+                max_triples: opts.maxTriples,
+                as_of_valid_time: opts.asOfValidTime,
+                as_of_commit_seq: opts.asOfCommitSeq,
+                entailment: opts.entailment,
+                reason: opts.reason,
+            },
+        });
+    }
     /**
      * Retract specific edges and/or every edge touching given entities. Appends
      * superseding retract events rather than deleting — history stays visible in an
@@ -329,7 +357,7 @@ export class LbbClient {
         return this.request("POST", "/v1/graph/branch", { body });
     }
     /**
-     * WS16 validate-then-merge: replay `from_branch`'s post-fork commits onto the
+     * 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.
      */
@@ -340,7 +368,7 @@ export class LbbClient {
         });
     }
     /**
-     * WS15 observe: store a conversation episode verbatim as EPISODE evidence,
+     * 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.
@@ -361,7 +389,23 @@ export class LbbClient {
             query: { confirm: opts.confirm },
         });
     }
-    // --- models as runs (WS9 registry + eval machinery) ---
+    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 —
      * the canonical input for a decoder-side automaton (FST/trie) and the
@@ -373,7 +417,7 @@ export class LbbClient {
         });
     }
     /**
-     * Captured signals by flush-seq range, oldest first — the flywheel training
+     * Captured signals by flush-seq range, oldest first — the model-training
      * feed. The `seq` on each signal is the temporal-split coordinate (train ≤ T,
      * eval > T).
      */
@@ -505,7 +549,7 @@ export class LbbClient {
     }
     /**
      * Promote a finished `extractor_lora` training run: gated on held-out fact
-     * F1, recorded as a WS9 `kind=extractor` run whose adapter resident
+     * F1, recorded as a `kind=extractor` training run whose adapter resident
      * extraction then serves.
      */
     promoteExtractor(opts) {
@@ -515,7 +559,7 @@ export class LbbClient {
     }
     /**
      * Promote a finished `planner_lora` training run: gated on held-out slot
-     * exactness, recorded as a WS9 `kind=planner` run whose adapter `/v1/ask`
+     * exactness, recorded as a `kind=planner` training run whose adapter `/v1/ask`
      * then serves.
      */
     promotePlanner(opts) {
@@ -534,14 +578,14 @@ export class LbbClient {
     }
     /**
      * Grounded prefix completion from the index vocabulary + ontology. Optionally
-     * narrow relation completions by a type-signature `context` (WS10) — a type
+     * narrow relation completions by a type-signature `context` — a type
      * pair that admits a single relation flags `signature_forced`.
      */
     suggest(body) {
         return this.request("POST", "/v1/search/suggest", { body });
     }
     /**
-     * Snap free text to the nearest real vocabulary item (WS11). Embedding cosine
+     * Snap free text to the nearest real vocabulary item. Embedding cosine
      * on a managed graph, else lexical; never fabricates a term.
      */
     resolveTerm(body) {
@@ -549,14 +593,14 @@ export class LbbClient {
     }
     /**
      * Ground a natural-language question to the graph's real vocabulary, retrieve
-     * against the pinned snapshot, and answer with citations (WS12, `/v1/ask`).
+     * against the pinned snapshot, and answer with citations (`/v1/ask`).
      */
     ask(body) {
         return this.request("POST", "/v1/ask", { body });
     }
     /**
      * Name the relation between two entities (`/v1/decode`): the DB narrows the
-     * candidates to the type pair's admissible relations (WS10), answers alone
+     * candidates to the type pair's admissible relations, answers alone
      * when the pair forces a single relation, and otherwise decodes it with the
      * graph-native fine-tuned model — the "DB narrows, cheap model decodes" call.
      */
@@ -564,7 +608,7 @@ export class LbbClient {
         return this.request("POST", "/v1/decode", { body });
     }
     /**
-     * Report which completion mechanisms will carry on this graph (WS13):
+     * Report which completion mechanisms will carry on this graph:
      * signature sparsity, name semantics, sampled narrowing recall, and a
      * narrow / narrow+finetune / lexical-first recommendation.
      */
@@ -574,7 +618,7 @@ export class LbbClient {
         });
     }
     /**
-     * Append relevance labels for a set of search results — how Little Big Brain
+     * Append relevance labels for a set of search results — how little big brain
      * gathers customer-specific qrels. Grade results (3 ideal/good, 1 partial,
      * 0 bad), referencing the search response's `search_id` so labels tie back to
      * that ranking. Stored apart from customer facts and exported via
@@ -772,7 +816,7 @@ export class LbbClient {
         return this.request("GET", "/v1/inference/rules");
     }
     /**
-     * Stage G — derive edges from calibrated retrieval matches (preview): each
+     * Derive edges from calibrated retrieval matches (preview): each
      * candidate scored `P >= threshold` becomes a derived edge `(anchor, relation,
      * matched)` with a typed `Retrieval` provenance leaf. Pass either explicit
      * `candidates` or a `query` the server runs as BM25 entity retrieval.
@@ -824,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
@@ -883,44 +931,7 @@ export class LbbClient {
     listGraphs() {
         return this.request("GET", "/v1/graphs");
     }
-    // --- database admin ---
-    /** Create a database stack and return its one-time stack API key. */
-    adminCreateStack(body) {
-        return this.request("POST", "/api/admin/stacks", { body });
-    }
-    /** Inspect a database stack without returning secret key material. */
-    adminStack(slug) {
-        return this.request("GET", "/api/admin/stacks", { query: { stack: slug } });
-    }
-    /** Rotate a database stack key and return the new one-time API key. */
-    adminRotateStackKey(slug) {
-        return this.request("POST", "/api/admin/stacks/rotate-key", {
-            query: { stack: slug },
-        });
-    }
-    /** Delete a database stack after confirming the slug. */
-    adminDeleteStack(slug) {
-        return this.request("DELETE", "/api/admin/stacks", {
-            query: { stack: slug, confirm: slug },
-        });
-    }
-    /**
-     * Mint a short-lived `lbb_ses_…` session token for an account. A trusted
-     * co-located service uses it (with `?stack=<slug>`) to call the data plane on
-     * the account's behalf without handling the stack's mode-bearing stack key.
-     */
-    adminMintSession(accountId, ttlSeconds) {
-        const body = { account_id: accountId };
-        if (ttlSeconds !== undefined)
-            body.ttl_seconds = ttlSeconds;
-        return this.request("POST", "/api/admin/sessions", { body });
-    }
-    /** Customer-visible activity for one database stack. */
-    adminStackActivity(slug, window = "24h") {
-        return this.request("GET", "/api/admin/stacks/activity", {
-            query: { stack: slug, window },
-        });
-    }
+    // --- stack activity ---
     /** Activity for the stack selected by the bearer stack key or session. */
     stackActivity(window = "24h") {
         return this.request("GET", "/v1/stack/activity", { query: { window } });

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { LbbClient, LbbError, parseSparqlResults } from "./client.js";
-export type { LbbAdminStackCreateRequest, LbbAdminStackDeleteResponse, LbbAdminStackResponse, LbbClientOptions, CallOptions, RequestOptions, EntityListOptions, HybridSearchOptions, LbbRequestEvent, LbbResponseEvent, LbbStackActivityResponse, LbbStackActivityWindow, LbbStackView, FetchLike, Schemas, SparqlResults, SparqlResultsJson, SparqlTerm, AskRequest, AskResponse, CommitRequest, CommitResponse, Entity, EntitySelector, GraphMetadata, GraphSummary, SchemaView, SearchRequest, SearchResponse, SearchResult, Snapshot, } from "./client.js";
+export type { LbbClientOptions, CallOptions, RequestOptions, EntityListOptions, HybridSearchOptions, LbbRequestEvent, LbbResponseEvent, LbbStackActivityResponse, LbbStackActivityWindow, FetchLike, Schemas, SparqlResults, SparqlResultsJson, SparqlTerm, AskRequest, AskResponse, CommitRequest, CommitResponse, Entity, EntitySelector, GraphMetadata, GraphSummary, SchemaView, SearchRequest, SearchResponse, SearchResult, Snapshot, } from "./client.js";
 export type { components, paths, operations } from "./schema.js";

package/dist/namespaces.d.ts

@@ -1,6 +1,6 @@
 import type { LbbClient } from "./client.js";
 import type { CallOptions } from "./transport.js";
-import { type EntityAttributeFilterOptions, type ImportLine, type ListResponse, type Schemas } from "./types.js";
+import { type EntityAttributeFilterOptions, type ImportLine, type ListResponse, type RdfExportOptions, type RdfImportOptions, type Schemas } from "./types.js";
 export interface HybridSearchOptions extends CallOptions {
     topK?: number;
     source?: string;
@@ -33,8 +33,21 @@ 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. */
+    exportRdf(opts?: RdfExportOptions): Promise<string>;
 }
 export declare class FactsNamespace {
     private readonly client;
@@ -49,19 +62,12 @@ export declare class FactsNamespace {
         idempotencyKey?: string;
     }): Promise<Schemas["GraphImportResponse"]>;
     /**
-     * Bulk-load N-Triples through the native RDF import endpoint.
+     * Bulk-load N-Triples, Turtle, N-Quads, or TriG through the native RDF import endpoint.
      *
      * Statements are committed through the fixed RDF_TRIPLE relation; source RDF
      * predicates and literal term details are preserved as edge metadata.
      */
-    importRdf(ntriples: string, opts?: CallOptions & {
-        batch?: number;
-        strict?: boolean;
-        observedAt?: string;
-        resourceType?: string;
-        edgeIdempotency?: "append" | "skip_unchanged";
-        idempotencyKey?: string;
-    }): Promise<Schemas["GraphRdfImportResponse"]>;
+    importRdf(rdf: string, opts?: CallOptions & RdfImportOptions): Promise<Schemas["GraphRdfImportResponse"]>;
 }
 export declare class SearchNamespace {
     private readonly client;
@@ -175,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 {
@@ -188,14 +195,3 @@ export declare class QueryNamespace {
     infer(body: Schemas["InferenceRunRequest"], opts?: CallOptions): Promise<Schemas["InferenceRunResponse"]>;
     premises(body: Schemas["RetrievalPremiseRequest"], opts?: CallOptions): Promise<Schemas["RetrievalPremiseResponse"]>;
 }
-/** Database administration. Keep stack credentials on trusted servers only. */
-export declare class AdminNamespace {
-    private readonly client;
-    constructor(client: LbbClient);
-    createStack(body: import("./types.js").LbbAdminStackCreateRequest): Promise<import("./types.js").LbbAdminStackResponse>;
-    stack(slug: string): Promise<import("./types.js").LbbAdminStackResponse>;
-    rotateStackKey(slug: string): Promise<import("./types.js").LbbAdminStackResponse>;
-    deleteStack(slug: string): Promise<import("./types.js").LbbAdminStackDeleteResponse>;
-    mintSession(accountId: string, ttlSeconds?: number): Promise<import("./types.js").LbbAdminSessionResponse>;
-    stackActivity(slug: string, window?: import("./types.js").LbbStackActivityWindow): Promise<import("./types.js").LbbStackActivityResponse>;
-}