backpack-ontology 0.7.6 → 0.7.8

package/dist/sync/sync-relay.js

@@ -0,0 +1,118 @@
+// HTTP client for the Backpack Sync Protocol v0.1 relay endpoints.
+// Used by SyncClient (OSS) and the cloud MCP sidecar (when configured for sync).
+import { SyncVersionConflictError, SYNC_PROTOCOL_VERSION, } from "./types.js";
+export class SyncRelayClient {
+    baseUrl;
+    getToken;
+    fetchImpl;
+    constructor(opts) {
+        this.baseUrl = opts.baseUrl.replace(/\/+$/, "");
+        this.getToken =
+            typeof opts.token === "string"
+                ? () => Promise.resolve(opts.token)
+                : opts.token;
+        this.fetchImpl = opts.fetchImpl ?? fetch;
+    }
+    async headers(extra) {
+        const token = await this.getToken();
+        return {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json",
+            "X-Backpack-Sync-Protocol": SYNC_PROTOCOL_VERSION,
+            ...(extra ?? {}),
+        };
+    }
+    async request(method, path, body) {
+        const init = {
+            method,
+            headers: await this.headers(),
+        };
+        if (body !== undefined) {
+            init.body = JSON.stringify(body);
+        }
+        const url = `${this.baseUrl}${path}`;
+        return this.fetchImpl(url, init);
+    }
+    /** POST /api/sync/register — idempotent. Returns the canonical record. */
+    async register(input) {
+        const res = await this.request("POST", "/api/sync/register", input);
+        if (!res.ok) {
+            throw await errorFromResponse(res, "register failed");
+        }
+        return (await res.json());
+    }
+    /** GET /api/sync/backpacks — list the user's sync backpacks. */
+    async listBackpacks() {
+        const res = await this.request("GET", "/api/sync/backpacks");
+        if (!res.ok) {
+            throw await errorFromResponse(res, "listBackpacks failed");
+        }
+        const body = (await res.json());
+        return body.backpacks ?? [];
+    }
+    /** GET /api/sync/backpacks/{id}/manifest. */
+    async manifest(backpackId) {
+        const res = await this.request("GET", `/api/sync/backpacks/${encodeURIComponent(backpackId)}/manifest`);
+        if (!res.ok) {
+            throw await errorFromResponse(res, "manifest failed");
+        }
+        return (await res.json());
+    }
+    /** GET one artifact. */
+    async getArtifact(backpackId, artifactId) {
+        const res = await this.request("GET", `/api/sync/backpacks/${encodeURIComponent(backpackId)}/artifacts/${encodeURIComponent(artifactId)}`);
+        if (!res.ok) {
+            throw await errorFromResponse(res, "getArtifact failed");
+        }
+        return (await res.json());
+    }
+    /**
+     * PUT one artifact. expectedVersion is the version the client believes the
+     * server holds. Pass 0 for new artifacts. Throws SyncVersionConflictError
+     * on 409. Returns the new artifact (with assigned version).
+     */
+    async putArtifact(backpackId, artifactId, content, expectedVersion) {
+        const res = await this.request("PUT", `/api/sync/backpacks/${encodeURIComponent(backpackId)}/artifacts/${encodeURIComponent(artifactId)}`, { expected_version: expectedVersion, content });
+        if (res.status === 409) {
+            const body = (await res.json().catch(() => ({})));
+            const cur = body.current;
+            throw new SyncVersionConflictError(artifactId, cur?.version ?? 0, cur?.content_hash ?? "");
+        }
+        if (!res.ok) {
+            throw await errorFromResponse(res, "putArtifact failed");
+        }
+        return (await res.json());
+    }
+    /** DELETE one artifact (tombstones it). */
+    async deleteArtifact(backpackId, artifactId) {
+        const res = await this.request("DELETE", `/api/sync/backpacks/${encodeURIComponent(backpackId)}/artifacts/${encodeURIComponent(artifactId)}`);
+        if (res.status === 404)
+            return; // already gone, idempotent
+        if (!res.ok) {
+            throw await errorFromResponse(res, "deleteArtifact failed");
+        }
+    }
+    /** DELETE the entire sync backpack. */
+    async deleteBackpack(backpackId) {
+        const res = await this.request("DELETE", `/api/sync/backpacks/${encodeURIComponent(backpackId)}`);
+        if (res.status === 404)
+            return;
+        if (!res.ok) {
+            throw await errorFromResponse(res, "deleteBackpack failed");
+        }
+    }
+}
+async function errorFromResponse(res, prefix) {
+    const text = await res.text().catch(() => "");
+    let detail = text;
+    try {
+        const parsed = JSON.parse(text);
+        if (parsed?.error)
+            detail = parsed.error;
+    }
+    catch {
+        // not JSON, keep raw text
+    }
+    return new Error(`${prefix}: ${res.status} ${res.statusText}${detail ? ` — ${detail}` : ""}`);
+}
+//# sourceMappingURL=sync-relay.js.map

package/dist/sync/sync-relay.js.map

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

package/dist/sync/sync-state.d.ts

@@ -0,0 +1,7 @@
+import type { BackpackSyncState, ArtifactSyncState } from "./types.js";
+export declare function readSyncState(backpackPath: string): Promise<BackpackSyncState | null>;
+export declare function writeSyncState(backpackPath: string, state: BackpackSyncState): Promise<void>;
+export declare function deleteSyncState(backpackPath: string): Promise<void>;
+export declare function emptyArtifactState(): ArtifactSyncState;
+export declare function isStateInitialized(state: BackpackSyncState | null): state is BackpackSyncState;
+//# sourceMappingURL=sync-state.d.ts.map

package/dist/sync/sync-state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-state.d.ts","sourceRoot":"","sources":["../../src/sync/sync-state.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAavE,wBAAsB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAmB3F;AAED,wBAAsB,cAAc,CAClC,YAAY,EAAE,MAAM,EACpB,KAAK,EAAE,iBAAiB,GACvB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED,wBAAsB,eAAe,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMzE;AAED,wBAAgB,kBAAkB,IAAI,iBAAiB,CAOtD;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI,GAAG,KAAK,IAAI,iBAAiB,CAE9F"}

package/dist/sync/sync-state.js

@@ -0,0 +1,63 @@
+// Per-backpack sync state, persisted to <backpack-path>/.sync/state.json.
+// Atomic writes (.tmp + rename) for crash safety.
+import * as fs from "node:fs/promises";
+import * as path from "node:path";
+const STATE_DIR = ".sync";
+const STATE_FILE = "state.json";
+function stateDir(backpackPath) {
+    return path.join(backpackPath, STATE_DIR);
+}
+function statePath(backpackPath) {
+    return path.join(stateDir(backpackPath), STATE_FILE);
+}
+export async function readSyncState(backpackPath) {
+    try {
+        const raw = await fs.readFile(statePath(backpackPath), "utf8");
+        const parsed = JSON.parse(raw);
+        if (!parsed.backpack_id || !parsed.relay_url)
+            return null;
+        return {
+            backpack_id: parsed.backpack_id,
+            name: parsed.name ?? "",
+            relay_url: parsed.relay_url,
+            registered_at: parsed.registered_at ?? new Date().toISOString(),
+            last_sync_at: parsed.last_sync_at ?? null,
+            last_synced_metadata_version: parsed.last_synced_metadata_version ?? 0,
+            artifacts: parsed.artifacts ?? {},
+        };
+    }
+    catch (err) {
+        const e = err;
+        if (e.code === "ENOENT")
+            return null;
+        throw err;
+    }
+}
+export async function writeSyncState(backpackPath, state) {
+    const dir = stateDir(backpackPath);
+    await fs.mkdir(dir, { recursive: true });
+    const target = statePath(backpackPath);
+    const tmp = `${target}.tmp`;
+    await fs.writeFile(tmp, JSON.stringify(state, null, 2), "utf8");
+    await fs.rename(tmp, target);
+}
+export async function deleteSyncState(backpackPath) {
+    try {
+        await fs.rm(stateDir(backpackPath), { recursive: true, force: true });
+    }
+    catch {
+        // best effort
+    }
+}
+export function emptyArtifactState() {
+    return {
+        version: 0,
+        content_hash: "",
+        last_synced_version: 0,
+        modified_at: new Date(0).toISOString(),
+    };
+}
+export function isStateInitialized(state) {
+    return state !== null && !!state.backpack_id && !!state.relay_url;
+}
+//# sourceMappingURL=sync-state.js.map

package/dist/sync/sync-state.js.map

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

package/dist/sync/types.d.ts

@@ -0,0 +1,106 @@
+export declare const SYNC_PROTOCOL_VERSION = "1";
+/** Stable kind tags used to namespace artifact ids. */
+export declare const ARTIFACT_KIND_GRAPH: "graph";
+export declare const ARTIFACT_KIND_KB_DOC: "kb_doc";
+export type ArtifactKind = typeof ARTIFACT_KIND_GRAPH | typeof ARTIFACT_KIND_KB_DOC;
+export interface SyncBackpack {
+    id: string;
+    owner_user_id: string;
+    name: string;
+    color: string;
+    tags: string[];
+    metadata_version: number;
+    metadata_content_hash: string;
+    created_at: string;
+    updated_at: string;
+}
+export interface SyncArtifactSummary {
+    artifact_id: string;
+    version: number;
+    content_hash: string;
+    modified_at: string;
+    deleted?: boolean;
+}
+export interface SyncManifest {
+    backpack_id: string;
+    name: string;
+    color: string;
+    tags: string[];
+    metadata_version: number;
+    metadata_content_hash: string;
+    artifacts: SyncArtifactSummary[];
+}
+export interface SyncArtifact {
+    artifact_id: string;
+    version: number;
+    content_hash: string;
+    modified_at: string;
+    content: unknown;
+}
+/** Content shape for graph artifacts (matches relay's wrapping). */
+export interface GraphArtifactContent {
+    kind: typeof ARTIFACT_KIND_GRAPH;
+    name: string;
+    data: unknown;
+}
+/** Content shape for KB document artifacts. */
+export interface KBDocArtifactContent {
+    kind: typeof ARTIFACT_KIND_KB_DOC;
+    id: string;
+    title: string;
+    content: string;
+    tags: string[];
+    source_graphs: string[];
+    source_node_ids: string[];
+    collection: string;
+    created_at: string;
+    updated_at: string;
+}
+/** Per-artifact local sync state, persisted in <backpack>/.sync/state.json. */
+export interface ArtifactSyncState {
+    version: number;
+    content_hash: string;
+    last_synced_version: number;
+    modified_at: string;
+}
+/** On-disk state for one backpack's sync registration. */
+export interface BackpackSyncState {
+    backpack_id: string;
+    name: string;
+    relay_url: string;
+    registered_at: string;
+    last_sync_at: string | null;
+    /**
+     * Last metadata_version observed at sync time. Reserved for future
+     * use when backpack-level metadata (name, color, tags) syncs through
+     * the protocol; v0.1 sets but does not act on this field.
+     */
+    last_synced_metadata_version: number;
+    artifacts: Record<string, ArtifactSyncState>;
+}
+/** Result of a sync run. */
+export interface SyncRunResult {
+    pushed: string[];
+    pulled: string[];
+    deleted_local: string[];
+    deleted_remote: string[];
+    conflicts: ConflictRecord[];
+    errors: SyncError[];
+}
+export interface ConflictRecord {
+    artifact_id: string;
+    conflict_path: string;
+    remote_version: number;
+}
+export interface SyncError {
+    artifact_id?: string;
+    message: string;
+}
+/** Thrown when the server's version disagrees with the client's expectation. */
+export declare class SyncVersionConflictError extends Error {
+    readonly artifactId: string;
+    readonly serverVersion: number;
+    readonly serverHash: string;
+    constructor(artifactId: string, serverVersion: number, serverHash: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/sync/types.d.ts.map

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

package/dist/sync/types.js

@@ -0,0 +1,20 @@
+// Sync Protocol v0.1 types — shared by client + relay implementations.
+// Mirrors backpack-app's internal/model/sync.go shapes.
+export const SYNC_PROTOCOL_VERSION = "1";
+/** Stable kind tags used to namespace artifact ids. */
+export const ARTIFACT_KIND_GRAPH = "graph";
+export const ARTIFACT_KIND_KB_DOC = "kb_doc";
+/** Thrown when the server's version disagrees with the client's expectation. */
+export class SyncVersionConflictError extends Error {
+    artifactId;
+    serverVersion;
+    serverHash;
+    constructor(artifactId, serverVersion, serverHash) {
+        super(`sync version conflict on ${artifactId} (server version ${serverVersion})`);
+        this.artifactId = artifactId;
+        this.serverVersion = serverVersion;
+        this.serverHash = serverHash;
+        this.name = "SyncVersionConflictError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/sync/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sync/types.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,wDAAwD;AAExD,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAG,CAAC;AAEzC,uDAAuD;AACvD,MAAM,CAAC,MAAM,mBAAmB,GAAG,OAAgB,CAAC;AACpD,MAAM,CAAC,MAAM,oBAAoB,GAAG,QAAiB,CAAC;AA4GtD,gFAAgF;AAChF,MAAM,OAAO,wBAAyB,SAAQ,KAAK;IAE/B;IACA;IACA;IAHlB,YACkB,UAAkB,EAClB,aAAqB,EACrB,UAAkB;QAElC,KAAK,CAAC,4BAA4B,UAAU,oBAAoB,aAAa,GAAG,CAAC,CAAC;QAJlE,eAAU,GAAV,UAAU,CAAQ;QAClB,kBAAa,GAAb,aAAa,CAAQ;QACrB,eAAU,GAAV,UAAU,CAAQ;QAGlC,IAAI,CAAC,IAAI,GAAG,0BAA0B,CAAC;IACzC,CAAC;CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "backpack-ontology",
-  "version": "0.7.6",
+  "version": "0.7.8",
   "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",