backpack-ontology 0.7.13 → 0.8.0

package/dist/ops/kb.js

@@ -0,0 +1,176 @@
+// Knowledge-base operations. Cloud KB is just /api/kb/documents; local
+// KB lives under each backpack root and is read via the Backpack class's
+// DocumentStore.
+import { DocumentStore } from "../core/document-store.js";
+import { getKBMounts } from "../core/backpacks-registry.js";
+import { getContext } from "./context.js";
+import { resolveCloudToken, getRelayUrl, assertSafeRelay } from "./auth.js";
+async function localStore() {
+    const ctx = await getContext();
+    if (ctx.source !== "local" || !ctx.backpackPath) {
+        throw new Error("active context is not a local backpack");
+    }
+    const mountConfigs = await getKBMounts(ctx.backpackPath);
+    const mounts = mountConfigs.map((m) => ({
+        name: m.name,
+        path: m.path,
+        // Default to writable when the registry didn't specify — matches the
+        // behavior the rest of the codebase (Backpack class, viewer, MCP) has
+        // assumed for the lifetime of the project. An earlier "safer default"
+        // change inverted this and silently broke `bp kbs create` against
+        // mounts whose registry entry didn't include the field.
+        writable: m.writable !== false,
+    }));
+    return new DocumentStore(mounts);
+}
+/** List KB documents in the active context. */
+export async function listKB() {
+    const ctx = await getContext();
+    if (ctx.source === "local") {
+        const store = await localStore();
+        const result = await store.list({ limit: 1000 });
+        return result.documents.map((d) => ({
+            id: d.id,
+            title: d.title,
+            tags: d.tags ?? [],
+            sourceGraphs: d.sourceGraphs ?? [],
+            collection: d.collection,
+            origin: "local",
+        }));
+    }
+    const token = await resolveCloudToken();
+    if (!token)
+        throw new Error("not signed in — run `bp login` first");
+    assertSafeRelay(getRelayUrl());
+    const res = await fetch(`${getRelayUrl()}/api/kb/documents?limit=1000`, {
+        headers: { Authorization: `Bearer ${token}` },
+    });
+    if (!res.ok) {
+        if (res.status === 404)
+            return []; // KB endpoint not exposed
+        if (res.status === 401)
+            throw new Error("cloud session expired — run `bp login` to refresh");
+        throw new Error(`cloud /api/kb/documents returned HTTP ${res.status}`);
+    }
+    const body = await res.json();
+    const all = (body.documents ?? []).map((d) => ({
+        id: d.id,
+        title: d.title ?? d.id,
+        tags: d.tags ?? [],
+        sourceGraphs: d.sourceGraphs ?? [],
+        collection: d.collection,
+        sourceBackpack: d.sourceBackpack,
+        origin: "cloud",
+    }));
+    const wantContainer = (ctx.cloudContainer ?? "").trim();
+    return wantContainer
+        ? all.filter((d) => d.sourceBackpack === wantContainer)
+        : all;
+}
+/** Create or update a KB document. Local writes go through DocumentStore.
+ * Cloud writes hit /api/kb/documents (POST for create, PUT for update). */
+export async function saveKB(input) {
+    const ctx = await getContext();
+    if (ctx.source === "local") {
+        const store = await localStore();
+        const before = input.id ? await store.read(input.id).catch(() => null) : null;
+        const saved = await store.save(input);
+        return { id: saved.id, created: !before };
+    }
+    const token = await resolveCloudToken();
+    if (!token)
+        throw new Error("not signed in — run `bp login` first");
+    assertSafeRelay(getRelayUrl());
+    const haveId = !!input.id;
+    const url = haveId
+        ? `${getRelayUrl()}/api/kb/documents/${encodeURIComponent(input.id)}`
+        : `${getRelayUrl()}/api/kb/documents`;
+    const res = await fetch(url, {
+        method: haveId ? "PUT" : "POST",
+        headers: { "Content-Type": "application/json", Authorization: `Bearer ${token}` },
+        body: JSON.stringify({
+            title: input.title,
+            content: input.content,
+            tags: input.tags ?? [],
+            sourceGraphs: input.sourceGraphs ?? [],
+            collection: input.collection,
+        }),
+    });
+    if (!res.ok) {
+        if (res.status === 401)
+            throw new Error("cloud session expired — run `bp login` to refresh");
+        throw new Error(`cloud KB save returned HTTP ${res.status}`);
+    }
+    const body = await res.json();
+    // Use the actual response status — the upsert endpoint may have created
+    // a new doc even though the caller passed an `id` that didn't exist.
+    // POST returns 201 on create; PUT returns 201 on create (upsert), 200 on update.
+    return { id: body.id, created: res.status === 201 };
+}
+export async function deleteKB(id) {
+    const ctx = await getContext();
+    if (ctx.source === "local") {
+        const store = await localStore();
+        await store.delete(id);
+        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/kb/documents/${encodeURIComponent(id)}`, {
+        method: "DELETE",
+        headers: { Authorization: `Bearer ${token}` },
+    });
+    if (res.status === 404)
+        throw new Error(`kb doc "${id}" not found`);
+    if (!res.ok) {
+        if (res.status === 401)
+            throw new Error("cloud session expired — run `bp login` to refresh");
+        throw new Error(`cloud KB delete returned HTTP ${res.status}`);
+    }
+}
+export async function getKB(id) {
+    const ctx = await getContext();
+    if (ctx.source === "local") {
+        const store = await localStore();
+        const doc = await store.read(id);
+        if (!doc)
+            return null;
+        return {
+            id: doc.id,
+            title: doc.title,
+            tags: doc.tags ?? [],
+            sourceGraphs: doc.sourceGraphs ?? [],
+            collection: doc.collection,
+            content: doc.content,
+            origin: "local",
+        };
+    }
+    const token = await resolveCloudToken();
+    if (!token)
+        throw new Error("not signed in — run `bp login` first");
+    assertSafeRelay(getRelayUrl());
+    const res = await fetch(`${getRelayUrl()}/api/kb/documents/${encodeURIComponent(id)}`, {
+        headers: { Authorization: `Bearer ${token}` },
+    });
+    if (res.status === 404)
+        return null;
+    if (!res.ok) {
+        if (res.status === 401)
+            throw new Error("cloud session expired — run `bp login` to refresh");
+        throw new Error(`cloud /api/kb/documents/${id} returned HTTP ${res.status}`);
+    }
+    const d = await res.json();
+    return {
+        id: d.id,
+        title: d.title ?? d.id,
+        tags: d.tags ?? [],
+        sourceGraphs: d.sourceGraphs ?? [],
+        collection: d.collection,
+        sourceBackpack: d.sourceBackpack,
+        content: d.content ?? "",
+        origin: "cloud",
+    };
+}
+//# sourceMappingURL=kb.js.map

package/dist/ops/kb.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backpack-ontology",
-  "version": "0.7.13",
+  "version": "0.8.0",
   "description": "A persistent learning graph engine for Claude Code via MCP — structured knowledge that carries forward across sessions",
   "license": "Apache-2.0",
   "author": "Noah Irzinger",
@@ -11,7 +11,8 @@
     "backpack-sync": "./dist/bin/backpack-sync.js",
     "backpack-init": "./dist/bin/init.js",
     "backpack-benchmark": "./dist/bin/backpack-benchmark.js",
-    "backpack": "./dist/bin/backpack.js"
+    "backpack": "./dist/bin/backpack.js",
+    "bp": "./dist/bin/bp.js"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",