@littlebigbrain/client 0.2.0 → 0.3.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,
@@ -105,7 +105,6 @@ and `elapsedMs`.
 | 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.
@@ -147,7 +141,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 +250,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 +259,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 +272,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 +302,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 +437,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.
@@ -518,22 +512,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,7 @@ export class LbbClient {
             query: { confirm: opts.confirm },
         });
     }
-    // --- models as runs (WS9 registry + eval machinery) ---
+    // --- 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 +401,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 +533,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 +543,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 +562,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 +577,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 +592,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 +602,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 +800,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.
@@ -883,44 +911,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;
@@ -35,6 +35,8 @@ export declare class GraphNamespace {
     } & CallOptions): Promise<unknown>;
     /** 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 +51,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;
@@ -188,14 +183,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>;
-}

package/dist/namespaces.js

@@ -51,6 +51,10 @@ export class GraphNamespace {
             body,
         });
     }
+    /** Export this graph's current snapshot as Turtle, N-Triples, TriG, or N-Quads. */
+    exportRdf(opts = {}) {
+        return this.client.exportRdf(opts);
+    }
 }
 export class FactsNamespace {
     client;
@@ -79,23 +83,31 @@ export class FactsNamespace {
         });
     }
     /**
-     * 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, opts = {}) {
-        const { batch, strict, observedAt, resourceType, edgeIdempotency, ...request } = opts;
+    importRdf(rdf, opts = {}) {
+        const { format = "ntriples", baseIri, graphUri, blankNodeScope, batch, strict, observedAt, resourceType, edgeIdempotency, ...request } = opts;
         return this.client.request("POST", "/v1/graph/import/rdf", {
             ...request,
             idempotencyKey: request.idempotencyKey ?? this.client.idempotencyKey("import-rdf"),
-            rawBody: ntriples,
-            contentType: "application/n-triples",
+            rawBody: rdf,
+            contentType: {
+                ntriples: "application/n-triples",
+                turtle: "text/turtle",
+                nquads: "application/n-quads",
+                trig: "application/trig",
+            }[format],
             query: {
                 batch,
                 strict,
                 observed_at: observedAt,
-                format: "ntriples",
+                format,
+                base_iri: baseIri,
+                graph_uri: graphUri,
+                blank_node_scope: blankNodeScope,
                 resource_type: resourceType,
                 edge_idempotency: edgeIdempotency,
             },
@@ -455,28 +467,3 @@ export class QueryNamespace {
         });
     }
 }
-/** Database administration. Keep stack credentials on trusted servers only. */
-export class AdminNamespace {
-    client;
-    constructor(client) {
-        this.client = client;
-    }
-    createStack(body) {
-        return this.client.adminCreateStack(body);
-    }
-    stack(slug) {
-        return this.client.adminStack(slug);
-    }
-    rotateStackKey(slug) {
-        return this.client.adminRotateStackKey(slug);
-    }
-    deleteStack(slug) {
-        return this.client.adminDeleteStack(slug);
-    }
-    mintSession(accountId, ttlSeconds) {
-        return this.client.adminMintSession(accountId, ttlSeconds);
-    }
-    stackActivity(slug, window = "24h") {
-        return this.client.adminStackActivity(slug, window);
-    }
-}

package/dist/schema.d.ts

@@ -360,6 +360,23 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/graph/export/rdf": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Export the snapshot-visible RDF projection as Turtle, N-Triples, TriG, or N-Quads (hard 100,000-statement materialization ceiling) */
+        get: operations["get_v1_graph_export_rdf"];
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/graph/groundability": {
         parameters: {
             query?: never;
@@ -403,7 +420,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Bulk-ingest N-Triples directly through the fixed RDF_TRIPLE relation; source predicates and literal terms are preserved as edge metadata */
+        /** Bulk-ingest N-Triples, Turtle, N-Quads, or TriG through the fixed RDF_TRIPLE relation; RDF terms and named-graph labels are preserved as edge metadata */
         post: operations["post_v1_graph_import_rdf"];
         delete?: never;
         options?: never;
@@ -1273,7 +1290,7 @@ export interface paths {
         };
         get?: never;
         put?: never;
-        /** Audit current graph data against the active SHACL schema bundle */
+        /** Audit current graph data against the active SHACL schema bundle; JSON by default, or a standard RDF sh:ValidationReport as Turtle/N-Triples */
         post: operations["post_v1_schema_audit"];
         delete?: never;
         options?: never;
@@ -3279,7 +3296,7 @@ export interface components {
             uri: string;
         };
         /**
-         * @description Aggregate outcome of an RDF import. Every N-Triples statement is committed
+         * @description Aggregate outcome of an RDF import. Every RDF statement is committed
          *     through a fixed `RDF_TRIPLE` edge; source predicate and literal term metadata
          *     are stored on the edge so the RDF/SPARQL projection can emit source RDF terms
          *     while avoiding one ontology relation/property per source predicate.
@@ -4309,8 +4326,10 @@ export interface components {
             name: string;
             required: boolean;
             /**
-             * @description Lowercase scalar value type: bool | i64 | f64 | datetime | keyword |
-             *     text | bytes | vector_f32.
+             * @description Lowercase value type: bool | i64 | f64 | datetime | keyword | text |
+             *     bytes | vector_f32 | keyword_set | i64_set. The `*_set` types hold a
+             *     sorted, deduplicated member set filterable by membership
+             *     (`overlaps`/`contains_all`/`not_overlaps`).
              */
             value_type: string;
         };
@@ -4646,6 +4665,15 @@ export interface components {
             keyword: string;
         } | {
             text: string;
+        } | {
+            /**
+             * @description Members of a `keyword_set` field. Order and duplicates don't matter on
+             *     the wire; the commit path canonicalizes (sorts, deduplicates) at rest.
+             */
+            keyword_set: string[];
+        } | {
+            /** @description Members of an `i64_set` field; canonicalized like `keyword_set`. */
+            i64_set: number[];
         };
         /**
          * @description One leaf of a derived edge's provenance trail. A tagged union so a calibrated
@@ -5390,6 +5418,21 @@ export interface components {
             /** @enum {string} */
             op: "gte";
             value: components["schemas"]["SearchFilterValue"];
+        } | {
+            field: string;
+            /** @enum {string} */
+            op: "overlaps";
+            values: components["schemas"]["SearchFilterValue"][];
+        } | {
+            field: string;
+            /** @enum {string} */
+            op: "contains_all";
+            values: components["schemas"]["SearchFilterValue"][];
+        } | {
+            field: string;
+            /** @enum {string} */
+            op: "not_overlaps";
+            values: components["schemas"]["SearchFilterValue"][];
         } | {
             field: string;
             last_as_prefix?: boolean;
@@ -10060,6 +10103,157 @@ export interface operations {
             };
         };
     };
+    get_v1_graph_export_rdf: {
+        parameters: {
+            query?: {
+                /** @description Graph name (default `main`) */
+                graph?: string;
+                /** @description Branch name (default `main`) */
+                branch?: string;
+                /** @description RDF format: turtle (default), nt/ntriples, trig, or nq/nquads */
+                format?: string;
+                /** @description Optional lower output ceiling; cannot exceed the server hard cap */
+                max_triples?: string;
+                /** @description RFC3339 valid-time snapshot pin */
+                as_of_valid_time?: string;
+                /** @description Commit-sequence snapshot pin */
+                as_of_commit_seq?: string;
+                /** @description subclass (default) or none */
+                entailment?: string;
+                /** @description Include stored rule-derived facts when true */
+                reason?: string;
+            };
+            header?: {
+                /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
+                "Lbb-Version"?: string;
+            };
+            path?: never;
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            /** @description RDF graph */
+            200: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/n-quads": string;
+                    "application/n-triples": string;
+                    "application/trig": string;
+                    "text/turtle": string;
+                };
+            };
+            /** @description Bad request */
+            400: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Unauthorized */
+            401: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Forbidden */
+            403: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Not found */
+            404: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Conflict */
+            409: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Rate limit exceeded */
+            429: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Internal server error */
+            500: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+            /** @description Service unavailable */
+            503: {
+                headers: {
+                    /** @description API contract version used for the response */
+                    "Lbb-Version"?: string;
+                    /** @description Request correlation id */
+                    "X-Request-Id"?: string;
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["LbbErrorEnvelope"];
+                };
+            };
+        };
+    };
     get_v1_graph_groundability: {
         parameters: {
             query?: {
@@ -10357,8 +10551,14 @@ export interface operations {
                 observed_at?: string;
                 /** @description Edge duplicate handling: skip_unchanged (default) or append for fresh high-throughput loads */
                 edge_idempotency?: string;
-                /** @description RDF format; only ntriples is supported today */
+                /** @description RDF format: ntriples (default), turtle, nquads, or trig */
                 format?: string;
+                /** @description Optional base IRI for resolving relative IRIs in Turtle or TriG */
+                base_iri?: string;
+                /** @description Optional named-graph IRI for N-Triples or Turtle input */
+                graph_uri?: string;
+                /** @description Optional stable document scope for blank-node labels across chunks; omit to preserve labels exactly across retries and chunk boundaries */
+                blank_node_scope?: string;
                 /** @description Entity type name for imported RDF resources (default Resource) */
                 resource_type?: string;
             };
@@ -17959,6 +18159,8 @@ export interface operations {
                 graph?: string;
                 /** @description Branch name (default `main`) */
                 branch?: string;
+                /** @description Response format: json (default), turtle, or nt/ntriples */
+                format?: string;
             };
             header?: {
                 /** @description API contract version to pin. Use `2026-06-22` for this beta-breaking shape. */
@@ -17971,7 +18173,7 @@ export interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description OK */
+            /** @description SHACL validation report */
             200: {
                 headers: {
                     /** @description API contract version used for the response */
@@ -17982,6 +18184,8 @@ export interface operations {
                 };
                 content: {
                     "application/json": components["schemas"]["SchemaAuditReport"];
+                    "application/n-triples": string;
+                    "text/turtle": string;
                 };
             };
             /** @description Bad request */

package/dist/types.d.ts

@@ -45,6 +45,27 @@ export type EntityPropertiesLine = {
 };
 /** One bulk-import line: a triplet, or an entity-properties record. */
 export type ImportLine = Schemas["TripletInput"] | EntityPropertiesLine;
+export interface RdfImportOptions {
+    format?: "ntriples" | "turtle" | "nquads" | "trig";
+    baseIri?: string;
+    graphUri?: string;
+    /** Stable document scope for blank labels across chunks; omit for legacy stable labels. */
+    blankNodeScope?: string;
+    batch?: number;
+    strict?: boolean;
+    observedAt?: string;
+    resourceType?: string;
+    edgeIdempotency?: "append" | "skip_unchanged";
+    idempotencyKey?: string;
+}
+export interface RdfExportOptions {
+    format?: "turtle" | "ntriples" | "trig" | "nquads";
+    maxTriples?: number;
+    asOfValidTime?: string;
+    asOfCommitSeq?: number;
+    entailment?: "subclass" | "none";
+    reason?: boolean;
+}
 export type AttributeFilterOp = "eq" | "ne" | "lt" | "le" | "gt" | "ge";
 export type AttributeFilterValue = string | number | boolean | {
     dateTime: string;
@@ -132,7 +153,7 @@ export declare function parseSparqlResults(response: Schemas["SparqlTextResponse
 export declare function firstPatternVariable(patterns: Schemas["AnalyticTriplePattern"][]): string;
 export declare function attributeFilter(filter: AttributeFilter, defaultVar: string): Schemas["SparqlFilter"];
 export interface LbbClientOptions {
-    /** Base URL of the Little Big Brain server, e.g. `https://db.eu.littlebigbrain.com`. */
+    /** Base URL of the little big brain server, e.g. `https://db.eu.littlebigbrain.com`. */
     baseUrl: string;
     /** Stack API key (`lbb_sk_test_…` / `lbb_sk_live_…`) or single-mode token. */
     apiKey?: string;
@@ -177,29 +198,6 @@ export interface LbbResponseEvent {
     retryCount: number;
     elapsedMs: number;
 }
-export interface LbbStackView {
-    stack_id: string;
-    owner_id?: string;
-    name: string;
-    slug: string;
-    tenant_id: string;
-    default_graph: string;
-    default_branch: string;
-    created_at_micros: number;
-    api_key_hint: string;
-    api_key_rotated_at_micros: number;
-}
-export interface LbbAdminStackCreateRequest {
-    owner_id: string;
-    name: string;
-    slug?: string;
-}
-export interface LbbAdminStackResponse {
-    ok: true;
-    stack: LbbStackView;
-    api_key?: string;
-    active_api_key_count?: number;
-}
 export type LbbStackActivityWindow = "1h" | "4h" | "12h" | "24h";
 export interface LbbStackActivityResponse {
     ok: true;
@@ -276,19 +274,6 @@ export interface LbbStackActivityResponse {
     }>;
     partial: boolean;
 }
-export interface LbbAdminSessionResponse {
-    ok: true;
-    /** A `lbb_ses_…` session token scoped to the account. */
-    token: string;
-    expires_at_micros: number;
-}
-export interface LbbAdminStackDeleteResponse {
-    ok: true;
-    deleted_stack: LbbStackView;
-    tenant_prefix: string;
-    objects_deleted: number;
-    bytes_deleted: number;
-}
 export interface LbbErrorPayload {
     type?: string;
     code?: string;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@littlebigbrain/client",
-  "version": "0.2.0",
-  "description": "TypeScript client for the Little Big Brain graph + hybrid search HTTP API",
+  "version": "0.3.0",
+  "description": "TypeScript client for the little big brain graph + hybrid search HTTP API",
   "license": "Apache-2.0",
   "repository": {
     "type": "git",