backpack-ontology 0.7.13 → 0.8.0

package/dist/ops/context.js

@@ -0,0 +1,158 @@
+// CLI active-scope state: which backpack (local) or container (cloud)
+// the user is currently working with. Stored as a single small JSON
+// file under configDir so `bp` runs are stateful across invocations
+// without taking a lock or making `bp ls` slow.
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+import { configDir } from "../core/paths.js";
+import { resolveCloudToken, getRelayUrl, assertSafeRelay } from "./auth.js";
+function contextFilePath() {
+    return path.join(configDir(), "cli-context.json");
+}
+function backpacksRegistryPath() {
+    return path.join(configDir(), "backpacks.json");
+}
+/**
+ * Read the current CLI context. Falls back to the active local backpack
+ * from the registry, then to a cloud-no-container default if signed in.
+ * Never throws — callers can rely on always getting *some* context.
+ */
+export async function getContext() {
+    // 1. Explicit CLI state file wins
+    try {
+        const raw = await fs.readFile(contextFilePath(), "utf8");
+        const parsed = JSON.parse(raw);
+        if (parsed.source === "local" || parsed.source === "cloud") {
+            return {
+                source: parsed.source,
+                backpackPath: parsed.backpackPath,
+                cloudContainer: parsed.cloudContainer,
+            };
+        }
+    }
+    catch { /* no state yet */ }
+    // 2. Fall back to the registered active local backpack
+    const local = await readActiveLocalBackpack();
+    if (local) {
+        return { source: "local", backpackPath: local };
+    }
+    // 3. Last resort: cloud, no container filter (works only if signed in)
+    return { source: "cloud" };
+}
+export async function setContext(ctx) {
+    await fs.mkdir(path.dirname(contextFilePath()), { recursive: true });
+    await fs.writeFile(contextFilePath(), JSON.stringify(ctx, null, 2), "utf8");
+}
+export async function clearContext() {
+    try {
+        await fs.unlink(contextFilePath());
+    }
+    catch { /* already gone */ }
+}
+async function readActiveLocalBackpack() {
+    try {
+        const raw = await fs.readFile(backpacksRegistryPath(), "utf8");
+        const reg = JSON.parse(raw);
+        return typeof reg.active === "string" ? reg.active : null;
+    }
+    catch {
+        return null;
+    }
+}
+async function readAllLocalBackpacks() {
+    try {
+        const raw = await fs.readFile(backpacksRegistryPath(), "utf8");
+        const reg = JSON.parse(raw);
+        if (!Array.isArray(reg.paths))
+            return [];
+        return reg.paths.map((p) => ({ name: path.basename(p), path: p }));
+    }
+    catch {
+        return [];
+    }
+}
+async function readCloudContainers(token) {
+    try {
+        assertSafeRelay(getRelayUrl());
+        const res = await fetch(`${getRelayUrl()}/api/sync/backpacks`, {
+            headers: { Authorization: `Bearer ${token}` },
+        });
+        if (!res.ok)
+            return [];
+        const body = await res.json();
+        return body.backpacks ?? [];
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Discover every context the user could switch to: local backpacks from
+ * the registry, and cloud sync_backpacks from the relay if signed in.
+ */
+export async function listContexts() {
+    const out = [];
+    for (const bp of await readAllLocalBackpacks()) {
+        out.push({ name: `local:${bp.name}`, source: "local", backpackPath: bp.path, detail: bp.path });
+    }
+    const token = await resolveCloudToken();
+    if (token) {
+        for (const c of await readCloudContainers(token)) {
+            const detail = c.origin_kind === "local" && c.origin_device_name
+                ? `device-synced from ${c.origin_device_name}`
+                : "cloud-native";
+            out.push({ name: `cloud:${c.name}`, source: "cloud", cloudContainer: c.name, detail });
+        }
+    }
+    return out;
+}
+/**
+ * Resolve a user-supplied context name. Three outcomes:
+ *  - exact / case-insensitive / unique-bare match → `{ ctx }`
+ *  - bare name matches multiple contexts (e.g. local:personal AND cloud:personal)
+ *      → `{ ctx: null, ambiguous: ["local:personal", "cloud:personal"] }`
+ *  - no plausible match → `{ ctx: null, suggestions: [...] }`
+ */
+export async function resolveContextName(input) {
+    const all = await listContexts();
+    const lower = input.toLowerCase();
+    const exact = all.find((c) => c.name === input);
+    if (exact)
+        return { ctx: exact };
+    const prefixed = all.find((c) => c.name.toLowerCase() === lower);
+    if (prefixed)
+        return { ctx: prefixed };
+    // Bare name (no `source:` prefix) → look for matches by suffix
+    const bareMatches = all.filter((c) => c.name.split(":").pop()?.toLowerCase() === lower);
+    if (bareMatches.length === 1)
+        return { ctx: bareMatches[0] };
+    if (bareMatches.length > 1) {
+        return { ctx: null, ambiguous: bareMatches.map((m) => m.name) };
+    }
+    // No bare match: offer suggestions
+    const suggestions = all
+        .map((c) => ({ name: c.name, score: similarityScore(c.name.toLowerCase(), lower) }))
+        .sort((a, b) => b.score - a.score)
+        .slice(0, 3)
+        .filter((s) => s.score > 0)
+        .map((s) => s.name);
+    return { ctx: null, suggestions };
+}
+function similarityScore(a, b) {
+    if (a.includes(b))
+        return 100 - (a.length - b.length);
+    if (b.includes(a))
+        return 100 - (b.length - a.length);
+    let common = 0;
+    for (const ch of new Set(b))
+        if (a.includes(ch))
+            common++;
+    return common;
+}
+export function describeContext(ctx) {
+    if (ctx.source === "local") {
+        return ctx.backpackPath ? `local:${path.basename(ctx.backpackPath)}` : "local";
+    }
+    return ctx.cloudContainer ? `cloud:${ctx.cloudContainer}` : "cloud (all containers)";
+}
+//# sourceMappingURL=context.js.map

package/dist/ops/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/ops/context.ts"],"names":[],"mappings":"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"}

package/dist/ops/graphs.d.ts

@@ -0,0 +1,69 @@
+import type { LearningGraphData } from "../core/types.js";
+export interface GraphSummary {
+    name: string;
+    description?: string;
+    tags?: string[];
+    nodeCount: number;
+    edgeCount: number;
+    /** Only meaningful for cloud graphs. */
+    encrypted?: boolean;
+    /** Cloud sync_backpack name, when source = cloud. */
+    sourceBackpack?: string;
+    /** "local" or "cloud" — where this row came from. */
+    origin: "local" | "cloud";
+}
+/** List graphs visible in the current context. */
+export declare function listGraphs(): Promise<GraphSummary[]>;
+export type GraphFetchResult = {
+    kind: "ok";
+    data: LearningGraphData;
+} | {
+    kind: "missing";
+} | {
+    kind: "encrypted";
+};
+/** Fetch a single graph's full data. Tagged result so callers can
+ * distinguish 404 (missing) from encrypted-on-cloud (server only has
+ * ciphertext) without making a second round-trip. */
+export declare function getGraph(name: string): Promise<GraphFetchResult>;
+/** Find a single summary by name without fetching the full graph data. */
+export declare function getGraphSummary(name: string): Promise<GraphSummary | null>;
+/** Create a new empty graph in the active context. */
+export declare function createGraph(name: string, opts?: {
+    description?: string;
+}): Promise<void>;
+/** Delete a graph by name. Cloud is soft-delete (server-side), local is hard. */
+export declare function deleteGraph(name: string): Promise<void>;
+export declare function renameGraph(oldName: string, newName: string): Promise<void>;
+/** Upsert a full graph payload by name. Used by `bp apply -f file`.
+ * Atomic on the local path — preserves branches, snapshots, snippets,
+ * the lock heartbeat. The cloud path is server-side idempotent. */
+export declare function applyGraph(name: string, data: LearningGraphData): Promise<{
+    created: boolean;
+}>;
+export interface SearchHit {
+    graphName: string;
+    nodeId: string;
+    nodeType: string;
+    label: string;
+}
+export interface SearchResult {
+    hits: SearchHit[];
+    /** How many graphs we actually opened — capped to maxGraphs. */
+    graphsScanned: number;
+    /** Total graphs in scope (including encrypted ones we couldn't scan). */
+    graphsInScope: number;
+    /** Graphs skipped because they were encrypted or unscannable. */
+    graphsSkipped: number;
+    /** Hit a cap and stopped scanning. Surface this to the user so a "no
+     * matches" result doesn't look authoritative. */
+    truncated: boolean;
+}
+/** Search node properties across graphs in the current scope. Caps the
+ * number of graphs scanned (default 50) so a `bp search` against a 1000-
+ * graph backpack doesn't fan out into 1000 sequential GETs. */
+export declare function searchGraphs(query: string, opts?: {
+    hitsPerGraph?: number;
+    maxGraphs?: number;
+}): Promise<SearchResult>;
+//# sourceMappingURL=graphs.d.ts.map

package/dist/ops/graphs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphs.d.ts","sourceRoot":"","sources":["../../src/ops/graphs.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAM1D,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,qDAAqD;IACrD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;CAC3B;AAsCD,kDAAkD;AAClD,wBAAsB,UAAU,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAgC1D;AAED,MAAM,MAAM,gBAAgB,GACxB;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,iBAAiB,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,GACnB;IAAE,IAAI,EAAE,WAAW,CAAA;CAAE,CAAC;AAE1B;;qDAEqD;AACrD,wBAAsB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA6BtE;AAED,0EAA0E;AAC1E,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAGhF;AAID,sDAAsD;AACtD,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CA4BlG;AAED,iFAAiF;AACjF,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmB7D;AAED,wBAAsB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBjF;AAED;;mEAEmE;AACnE,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CA8BrG;AAED,MAAM,WAAW,SAAS;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,SAAS,EAAE,CAAC;IAClB,gEAAgE;IAChE,aAAa,EAAE,MAAM,CAAC;IACtB,yEAAyE;IACzE,aAAa,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,aAAa,EAAE,MAAM,CAAC;IACtB;qDACiD;IACjD,SAAS,EAAE,OAAO,CAAC;CACpB;AAKD;;+DAE+D;AAC/D,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,IAAI,GAAE;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACvD,OAAO,CAAC,YAAY,CAAC,CAqCvB"}

package/dist/ops/graphs.js

@@ -0,0 +1,278 @@
+// Graph operations — the unified read surface that picks local vs cloud
+// based on the active CLI context. Both the CLI and (eventually) MCP
+// tools should funnel through this so behavior stays consistent.
+import { Backpack } from "../core/backpack.js";
+import { JsonFileBackend } from "../storage/json-file-backend.js";
+import { getContext } from "./context.js";
+import { resolveCloudToken, getRelayUrl, assertSafeRelay } from "./auth.js";
+/** Lazily build a Backpack handle scoped to the active local folder. */
+async function localBackpack() {
+    const ctx = await getContext();
+    if (ctx.source !== "local" || !ctx.backpackPath) {
+        throw new Error("active context is not a local backpack");
+    }
+    const backend = new JsonFileBackend(undefined, { graphsDirOverride: ctx.backpackPath });
+    await backend.initialize();
+    return new Backpack(backend);
+}
+async function fetchCloudGraphs(token) {
+    assertSafeRelay(getRelayUrl());
+    const res = await fetch(`${getRelayUrl()}/api/graphs`, {
+        headers: { Authorization: `Bearer ${token}` },
+    });
+    if (!res.ok) {
+        if (res.status === 401)
+            throw new Error("cloud session expired — run `bp login` to refresh");
+        throw new Error(`cloud /api/graphs returned HTTP ${res.status}`);
+    }
+    const body = await res.json();
+    return Array.isArray(body) ? body : [];
+}
+/** List graphs visible in the current context. */
+export async function listGraphs() {
+    const ctx = await getContext();
+    if (ctx.source === "local") {
+        const bp = await localBackpack();
+        const summaries = await bp.listOntologies();
+        return summaries.map((s) => ({
+            name: s.name,
+            description: s.description,
+            tags: s.tags,
+            nodeCount: s.nodeCount,
+            edgeCount: s.edgeCount,
+            origin: "local",
+        }));
+    }
+    // Cloud: list everything the user has access to, filter by container.
+    const token = await resolveCloudToken();
+    if (!token)
+        throw new Error("not signed in — run `bp login` first");
+    const rows = await fetchCloudGraphs(token);
+    const wantContainer = (ctx.cloudContainer ?? "").trim();
+    const filtered = wantContainer
+        ? rows.filter((g) => g.sourceBackpack === wantContainer)
+        : rows;
+    return filtered.map((g) => ({
+        name: g.name,
+        description: g.description,
+        tags: [],
+        nodeCount: g.nodeCount ?? 0,
+        edgeCount: g.edgeCount ?? 0,
+        encrypted: g.encrypted,
+        sourceBackpack: g.sourceBackpack,
+        origin: "cloud",
+    }));
+}
+/** Fetch a single graph's full data. Tagged result so callers can
+ * distinguish 404 (missing) from encrypted-on-cloud (server only has
+ * ciphertext) without making a second round-trip. */
+export async function getGraph(name) {
+    const ctx = await getContext();
+    if (ctx.source === "local") {
+        const bp = await localBackpack();
+        try {
+            const data = await bp.loadOntology(name);
+            return { kind: "ok", data };
+        }
+        catch (err) {
+            const msg = err.message;
+            if (/not found/i.test(msg))
+                return { kind: "missing" };
+            throw err;
+        }
+    }
+    const token = await resolveCloudToken();
+    if (!token)
+        throw new Error("not signed in — run `bp login` first");
+    assertSafeRelay(getRelayUrl());
+    const res = await fetch(`${getRelayUrl()}/api/graphs/${encodeURIComponent(name)}`, {
+        headers: { Authorization: `Bearer ${token}` },
+    });
+    if (res.status === 404)
+        return { kind: "missing" };
+    if (!res.ok) {
+        if (res.status === 401)
+            throw new Error("cloud session expired — run `bp login` to refresh");
+        throw new Error(`cloud /api/graphs/${name} returned HTTP ${res.status}`);
+    }
+    const data = await res.json();
+    // /api/graphs/{name} returns `null` for encrypted graphs (the server
+    // only has ciphertext, no plaintext to send).
+    if (data === null)
+        return { kind: "encrypted" };
+    return { kind: "ok", data: data };
+}
+/** Find a single summary by name without fetching the full graph data. */
+export async function getGraphSummary(name) {
+    const all = await listGraphs();
+    return all.find((g) => g.name === name) ?? null;
+}
+/* ─────────────── Mutations ─────────────── */
+/** Create a new empty graph in the active context. */
+export async function createGraph(name, opts = {}) {
+    const ctx = await getContext();
+    if (ctx.source === "local") {
+        const bp = await localBackpack();
+        await bp.createOntology(name, opts.description ?? "");
+        return;
+    }
+    // Cloud: PUT /api/graphs/{name} with an empty graph payload. New
+    // cloud-native graphs land in the server's default "cloud" container;
+    // use `bp graphs move` to relocate.
+    const token = await resolveCloudToken();
+    if (!token)
+        throw new Error("not signed in — run `bp login` first");
+    assertSafeRelay(getRelayUrl());
+    const now = new Date().toISOString();
+    const empty = {
+        metadata: { name, description: opts.description ?? "", createdAt: now, updatedAt: now },
+        nodes: [],
+        edges: [],
+    };
+    const res = await fetch(`${getRelayUrl()}/api/graphs/${encodeURIComponent(name)}`, {
+        method: "PUT",
+        headers: { "Content-Type": "application/json", "Authorization": `Bearer ${token}` },
+        body: JSON.stringify(empty),
+    });
+    if (!res.ok) {
+        if (res.status === 401)
+            throw new Error("cloud session expired — run `bp login` to refresh");
+        throw new Error(`cloud create returned HTTP ${res.status}`);
+    }
+}
+/** Delete a graph by name. Cloud is soft-delete (server-side), local is hard. */
+export async function deleteGraph(name) {
+    const ctx = await getContext();
+    if (ctx.source === "local") {
+        const bp = await localBackpack();
+        await bp.deleteOntology(name);
+        return;
+    }
+    const token = await resolveCloudToken();
+    if (!token)
+        throw new Error("not signed in — run `bp login` first");
+    assertSafeRelay(getRelayUrl());
+    const res = await fetch(`${getRelayUrl()}/api/graphs/${encodeURIComponent(name)}`, {
+        method: "DELETE",
+        headers: { Authorization: `Bearer ${token}` },
+    });
+    if (res.status === 404)
+        throw new Error(`graph "${name}" not found in the current scope`);
+    if (!res.ok) {
+        if (res.status === 401)
+            throw new Error("cloud session expired — run `bp login` to refresh");
+        throw new Error(`cloud delete returned HTTP ${res.status}`);
+    }
+}
+export async function renameGraph(oldName, newName) {
+    const ctx = await getContext();
+    if (ctx.source === "local") {
+        const bp = await localBackpack();
+        await bp.renameOntology(oldName, newName);
+        return;
+    }
+    const token = await resolveCloudToken();
+    if (!token)
+        throw new Error("not signed in — run `bp login` first");
+    assertSafeRelay(getRelayUrl());
+    const res = await fetch(`${getRelayUrl()}/api/graphs/${encodeURIComponent(oldName)}/rename`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json", Authorization: `Bearer ${token}` },
+        body: JSON.stringify({ name: newName }),
+    });
+    if (res.status === 404)
+        throw new Error(`graph "${oldName}" not found in the current scope`);
+    if (!res.ok) {
+        if (res.status === 401)
+            throw new Error("cloud session expired — run `bp login` to refresh");
+        if (res.status === 409)
+            throw new Error(`a graph named "${newName}" already exists`);
+        throw new Error(`cloud rename returned HTTP ${res.status}`);
+    }
+}
+/** Upsert a full graph payload by name. Used by `bp apply -f file`.
+ * Atomic on the local path — preserves branches, snapshots, snippets,
+ * the lock heartbeat. The cloud path is server-side idempotent. */
+export async function applyGraph(name, data) {
+    const ctx = await getContext();
+    if (ctx.source === "local") {
+        const bp = await localBackpack();
+        const exists = await bp.ontologyExists(name);
+        if (exists) {
+            await bp.saveOntologyData(name, data);
+        }
+        else {
+            await bp.createOntologyFromData(name, data);
+        }
+        return { created: !exists };
+    }
+    const token = await resolveCloudToken();
+    if (!token)
+        throw new Error("not signed in — run `bp login` first");
+    assertSafeRelay(getRelayUrl());
+    // Note: the relay's PUT /api/graphs/{name} doesn't honor an
+    // X-Backpack-Source-Name hint for new graphs (only the legacy
+    // /sync endpoint does). New cloud-native graphs land in the default
+    // "cloud" container. Use `bp graphs move <name> --to <container>`
+    // (Step 4) after creation if you need them in a specific container.
+    const res = await fetch(`${getRelayUrl()}/api/graphs/${encodeURIComponent(name)}`, {
+        method: "PUT",
+        headers: { "Content-Type": "application/json", "Authorization": `Bearer ${token}` },
+        body: JSON.stringify(data),
+    });
+    if (!res.ok) {
+        if (res.status === 401)
+            throw new Error("cloud session expired — run `bp login` to refresh");
+        throw new Error(`cloud apply returned HTTP ${res.status}`);
+    }
+    return { created: false };
+}
+const SEARCH_DEFAULT_MAX_GRAPHS = 50;
+const SEARCH_DEFAULT_HITS_PER_GRAPH = 5;
+/** Search node properties across graphs in the current scope. Caps the
+ * number of graphs scanned (default 50) so a `bp search` against a 1000-
+ * graph backpack doesn't fan out into 1000 sequential GETs. */
+export async function searchGraphs(query, opts = {}) {
+    const trimmed = query.trim();
+    if (!trimmed) {
+        return { hits: [], graphsScanned: 0, graphsInScope: 0, graphsSkipped: 0, truncated: false };
+    }
+    const q = trimmed.toLowerCase();
+    const hitsPerGraph = opts.hitsPerGraph ?? SEARCH_DEFAULT_HITS_PER_GRAPH;
+    const maxGraphs = opts.maxGraphs ?? SEARCH_DEFAULT_MAX_GRAPHS;
+    const summaries = await listGraphs();
+    const scannable = summaries.filter((s) => !s.encrypted);
+    const truncated = scannable.length > maxGraphs;
+    const targets = scannable.slice(0, maxGraphs);
+    const hits = [];
+    for (const s of targets) {
+        let result;
+        try {
+            result = await getGraph(s.name);
+        }
+        catch {
+            continue;
+        }
+        if (result.kind !== "ok")
+            continue;
+        let countInThis = 0;
+        for (const n of result.data.nodes) {
+            const label = Object.values(n.properties ?? {}).find((v) => typeof v === "string") ?? n.id;
+            const haystack = (n.type + " " + Object.values(n.properties ?? {}).filter((v) => typeof v === "string").join(" ")).toLowerCase();
+            if (haystack.includes(q)) {
+                hits.push({ graphName: s.name, nodeId: n.id, nodeType: n.type, label });
+                countInThis++;
+                if (countInThis >= hitsPerGraph)
+                    break;
+            }
+        }
+    }
+    return {
+        hits,
+        graphsScanned: targets.length,
+        graphsInScope: summaries.length,
+        graphsSkipped: summaries.length - targets.length,
+        truncated,
+    };
+}
+//# sourceMappingURL=graphs.js.map

package/dist/ops/graphs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphs.js","sourceRoot":"","sources":["../../src/ops/graphs.ts"],"names":[],"mappings":"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"}

package/dist/ops/kb.d.ts

@@ -0,0 +1,33 @@
+export interface KBSummary {
+    id: string;
+    title: string;
+    tags: string[];
+    sourceGraphs: string[];
+    collection?: string;
+    /** Cloud sync_backpack name when origin = cloud. */
+    sourceBackpack?: string;
+    origin: "local" | "cloud";
+}
+/** List KB documents in the active context. */
+export declare function listKB(): Promise<KBSummary[]>;
+export interface KBDocument extends KBSummary {
+    content: string;
+}
+export interface KBSaveInput {
+    /** Existing id when updating; omit for create. */
+    id?: string;
+    title: string;
+    content: string;
+    tags?: string[];
+    sourceGraphs?: string[];
+    collection?: string;
+}
+/** Create or update a KB document. Local writes go through DocumentStore.
+ * Cloud writes hit /api/kb/documents (POST for create, PUT for update). */
+export declare function saveKB(input: KBSaveInput): Promise<{
+    id: string;
+    created: boolean;
+}>;
+export declare function deleteKB(id: string): Promise<void>;
+export declare function getKB(id: string): Promise<KBDocument | null>;
+//# sourceMappingURL=kb.d.ts.map

package/dist/ops/kb.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kb.d.ts","sourceRoot":"","sources":["../../src/ops/kb.ts"],"names":[],"mappings":"AASA,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,OAAO,GAAG,OAAO,CAAC;CAC3B;AA+BD,+CAA+C;AAC/C,wBAAsB,MAAM,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC,CAuCnD;AAED,MAAM,WAAW,UAAW,SAAQ,SAAS;IAC3C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,kDAAkD;IAClD,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;2EAC2E;AAC3E,wBAAsB,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAmC1F;AAED,wBAAsB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAmBxD;AAED,wBAAsB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAsClE"}