@openweave/weave-provider 0.8.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 lemur bookstores
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @openweave/weave-provider
+ *
+ * Storage-agnostic persistence contract for OpenWeave.
+ *
+ * Quick start:
+ * ```ts
+ * import { resolveProvider } from "@openweave/weave-provider";
+ *
+ * const provider = await resolveProvider<MyRecord>();
+ * await provider.set("ns:my-key", { hello: "world" });
+ * const record = await provider.get("ns:my-key");
+ * await provider.close();
+ * ```
+ */
+export type { IWeaveProvider, ProviderFactory } from "./types.js";
+export { WEAVE_PROVIDER_ENV, WEAVE_DATA_DIR_ENV, DEFAULT_DATA_DIR, ProviderClosedError, UnknownProviderError, } from "./types.js";
+export { MemoryProvider } from "./memory-provider.js";
+export { JsonProvider } from "./json-provider.js";
+export { ProviderRegistry, resolveProvider } from "./registry.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,YAAY,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAClE,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAGlD,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/index.js

@@ -0,0 +1,22 @@
+/**
+ * @openweave/weave-provider
+ *
+ * Storage-agnostic persistence contract for OpenWeave.
+ *
+ * Quick start:
+ * ```ts
+ * import { resolveProvider } from "@openweave/weave-provider";
+ *
+ * const provider = await resolveProvider<MyRecord>();
+ * await provider.set("ns:my-key", { hello: "world" });
+ * const record = await provider.get("ns:my-key");
+ * await provider.close();
+ * ```
+ */
+export { WEAVE_PROVIDER_ENV, WEAVE_DATA_DIR_ENV, DEFAULT_DATA_DIR, ProviderClosedError, UnknownProviderError, } from "./types.js";
+// Built-in implementations
+export { MemoryProvider } from "./memory-provider.js";
+export { JsonProvider } from "./json-provider.js";
+// Registry + convenience resolver
+export { ProviderRegistry, resolveProvider } from "./registry.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAIH,OAAO,EACL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,mBAAmB,EACnB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,2BAA2B;AAC3B,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,kCAAkC;AAClC,OAAO,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC"}

package/dist/json-provider.d.ts

@@ -0,0 +1,47 @@
+import { IWeaveProvider } from "./types.js";
+/**
+ * JsonProvider
+ *
+ * File-system implementation of IWeaveProvider that stores each record as an
+ * individual JSON file inside a configurable data directory.
+ *
+ * Key → file-path mapping:
+ *   key = "graph:my-session"  →  <dataDir>/graph__my-session.json
+ *
+ * Colons in keys are replaced with double-underscores and any characters that
+ * are not safe for all major file systems are percent-encoded, so the mapping
+ * is always reversible.
+ *
+ * Backward-compatible with the original weave-graph PersistenceManager:
+ *   graph:<chatId>  →  weave-data/<chatId>.json   (no namespace prefix)
+ * That legacy layout is preserved for existing data directories.
+ */
+export declare class JsonProvider<T = unknown> implements IWeaveProvider<T> {
+    private dataDir;
+    private closed;
+    constructor(dataDir?: string);
+    close(): Promise<void>;
+    get(key: string): Promise<T | null>;
+    set(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(prefix?: string): Promise<string[]>;
+    clear(prefix?: string): Promise<void>;
+    /**
+     * Convert a logical key into an absolute file path.
+     *
+     * Rules (applied in order):
+     *   1. Replace ":" with "__" (namespace separator)
+     *   2. Replace "/" with "--" (path separator used in ids)
+     *   3. Append ".json"
+     */
+    private keyToPath;
+    /**
+     * Reverse of keyToPath — converts a filename back into a logical key.
+     */
+    private pathToKey;
+    private ensureDataDir;
+    private assertOpen;
+    /** Expose dataDir for testing / diagnostics. */
+    get directory(): string;
+}
+//# sourceMappingURL=json-provider.d.ts.map

package/dist/json-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-provider.d.ts","sourceRoot":"","sources":["../src/json-provider.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAyC,MAAM,YAAY,CAAC;AAEnF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,YAAY,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,cAAc,CAAC,CAAC,CAAC;IACjE,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,GAAE,MAAyB;IAQxC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQtB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAYnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAOzC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWlC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkBxC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3C;;;;;;;OAOG;IACH,OAAO,CAAC,SAAS;IAQjB;;OAEG;IACH,OAAO,CAAC,SAAS;YAgBH,aAAa;IAI3B,OAAO,CAAC,UAAU;IAIlB,gDAAgD;IAChD,IAAI,SAAS,IAAI,MAAM,CAEtB;CACF"}

package/dist/json-provider.js

@@ -0,0 +1,136 @@
+import { promises as fs } from "fs";
+import * as path from "path";
+import { ProviderClosedError, DEFAULT_DATA_DIR } from "./types.js";
+/**
+ * JsonProvider
+ *
+ * File-system implementation of IWeaveProvider that stores each record as an
+ * individual JSON file inside a configurable data directory.
+ *
+ * Key → file-path mapping:
+ *   key = "graph:my-session"  →  <dataDir>/graph__my-session.json
+ *
+ * Colons in keys are replaced with double-underscores and any characters that
+ * are not safe for all major file systems are percent-encoded, so the mapping
+ * is always reversible.
+ *
+ * Backward-compatible with the original weave-graph PersistenceManager:
+ *   graph:<chatId>  →  weave-data/<chatId>.json   (no namespace prefix)
+ * That legacy layout is preserved for existing data directories.
+ */
+export class JsonProvider {
+    dataDir;
+    closed = false;
+    constructor(dataDir = DEFAULT_DATA_DIR) {
+        this.dataDir = dataDir;
+    }
+    // -------------------------------------------------------------------------
+    // Lifecycle
+    // -------------------------------------------------------------------------
+    async close() {
+        this.closed = true;
+    }
+    // -------------------------------------------------------------------------
+    // Core operations
+    // -------------------------------------------------------------------------
+    async get(key) {
+        this.assertOpen();
+        const filePath = this.keyToPath(key);
+        try {
+            const content = await fs.readFile(filePath, "utf-8");
+            return JSON.parse(content);
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                return null;
+            throw err;
+        }
+    }
+    async set(key, value) {
+        this.assertOpen();
+        await this.ensureDataDir();
+        const filePath = this.keyToPath(key);
+        await fs.writeFile(filePath, JSON.stringify(value, null, 2), "utf-8");
+    }
+    async delete(key) {
+        this.assertOpen();
+        const filePath = this.keyToPath(key);
+        try {
+            await fs.unlink(filePath);
+        }
+        catch (err) {
+            if (err.code !== "ENOENT")
+                throw err;
+            // key didn't exist — honour "no-op" contract
+        }
+    }
+    async list(prefix) {
+        this.assertOpen();
+        await this.ensureDataDir();
+        let entries;
+        try {
+            entries = await fs.readdir(this.dataDir);
+        }
+        catch (err) {
+            if (err.code === "ENOENT")
+                return [];
+            throw err;
+        }
+        const keys = entries
+            .filter((f) => f.endsWith(".json"))
+            .map((f) => this.pathToKey(f));
+        if (!prefix)
+            return keys;
+        return keys.filter((k) => k.startsWith(prefix));
+    }
+    async clear(prefix) {
+        this.assertOpen();
+        const keys = await this.list(prefix);
+        await Promise.all(keys.map((k) => this.delete(k)));
+    }
+    // -------------------------------------------------------------------------
+    // Key ↔ filename helpers
+    // -------------------------------------------------------------------------
+    /**
+     * Convert a logical key into an absolute file path.
+     *
+     * Rules (applied in order):
+     *   1. Replace ":" with "__" (namespace separator)
+     *   2. Replace "/" with "--" (path separator used in ids)
+     *   3. Append ".json"
+     */
+    keyToPath(key) {
+        const sanitized = key
+            .replace(/:/g, "__")
+            .replace(/\//g, "--")
+            .replace(/[^a-zA-Z0-9_\-\.]/g, (c) => `~${c.codePointAt(0)?.toString(16)}~`);
+        return path.join(this.dataDir, `${sanitized}.json`);
+    }
+    /**
+     * Reverse of keyToPath — converts a filename back into a logical key.
+     */
+    pathToKey(filename) {
+        const base = filename.endsWith(".json")
+            ? filename.slice(0, -5)
+            : filename;
+        return base
+            .replace(/~([0-9a-f]+)~/g, (_, hex) => String.fromCodePoint(parseInt(hex, 16)))
+            .replace(/--/g, "/")
+            .replace(/__/g, ":");
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    async ensureDataDir() {
+        await fs.mkdir(this.dataDir, { recursive: true });
+    }
+    assertOpen() {
+        if (this.closed)
+            throw new ProviderClosedError("JsonProvider");
+    }
+    /** Expose dataDir for testing / diagnostics. */
+    get directory() {
+        return this.dataDir;
+    }
+}
+//# sourceMappingURL=json-provider.js.map

package/dist/json-provider.js.map

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

package/dist/memory-provider.d.ts

@@ -0,0 +1,28 @@
+import { IWeaveProvider } from "./types.js";
+/**
+ * MemoryProvider
+ *
+ * An in-memory implementation of IWeaveProvider backed by a plain `Map`.
+ * Zero-latency reads/writes, no I/O, no external dependencies.
+ *
+ * Ideal for:
+ *  - Unit tests (fast, isolated, no temp-file cleanup needed)
+ *  - Ephemeral sessions where persistence across restarts is not required
+ *  - Streaming pipelines that only need within-process memory
+ */
+export declare class MemoryProvider<T = unknown> implements IWeaveProvider<T> {
+    private store;
+    private closed;
+    close(): Promise<void>;
+    get(key: string): Promise<T | null>;
+    set(key: string, value: T): Promise<void>;
+    delete(key: string): Promise<void>;
+    list(prefix?: string): Promise<string[]>;
+    clear(prefix?: string): Promise<void>;
+    /** Current number of stored records. */
+    get size(): number;
+    /** Whether the provider has been closed. */
+    get isClosed(): boolean;
+    private assertOpen;
+}
+//# sourceMappingURL=memory-provider.d.ts.map

package/dist/memory-provider.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-provider.d.ts","sourceRoot":"","sources":["../src/memory-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAuB,MAAM,YAAY,CAAC;AAEjE;;;;;;;;;;GAUG;AACH,qBAAa,cAAc,CAAC,CAAC,GAAG,OAAO,CAAE,YAAW,cAAc,CAAC,CAAC,CAAC;IACnE,OAAO,CAAC,KAAK,CAAwB;IACrC,OAAO,CAAC,MAAM,CAAS;IAMjB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAStB,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAKnC,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzC,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAOxC,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB3C,wCAAwC;IACxC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,4CAA4C;IAC5C,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAMD,OAAO,CAAC,UAAU;CAGnB"}

package/dist/memory-provider.js

@@ -0,0 +1,76 @@
+import { ProviderClosedError } from "./types.js";
+/**
+ * MemoryProvider
+ *
+ * An in-memory implementation of IWeaveProvider backed by a plain `Map`.
+ * Zero-latency reads/writes, no I/O, no external dependencies.
+ *
+ * Ideal for:
+ *  - Unit tests (fast, isolated, no temp-file cleanup needed)
+ *  - Ephemeral sessions where persistence across restarts is not required
+ *  - Streaming pipelines that only need within-process memory
+ */
+export class MemoryProvider {
+    store = new Map();
+    closed = false;
+    // -------------------------------------------------------------------------
+    // Lifecycle
+    // -------------------------------------------------------------------------
+    async close() {
+        this.closed = true;
+        this.store.clear();
+    }
+    // -------------------------------------------------------------------------
+    // Core operations
+    // -------------------------------------------------------------------------
+    async get(key) {
+        this.assertOpen();
+        return this.store.get(key) ?? null;
+    }
+    async set(key, value) {
+        this.assertOpen();
+        this.store.set(key, value);
+    }
+    async delete(key) {
+        this.assertOpen();
+        this.store.delete(key);
+    }
+    async list(prefix) {
+        this.assertOpen();
+        const keys = [...this.store.keys()];
+        if (!prefix)
+            return keys;
+        return keys.filter((k) => k.startsWith(prefix));
+    }
+    async clear(prefix) {
+        this.assertOpen();
+        if (!prefix) {
+            this.store.clear();
+            return;
+        }
+        for (const key of this.store.keys()) {
+            if (key.startsWith(prefix)) {
+                this.store.delete(key);
+            }
+        }
+    }
+    // -------------------------------------------------------------------------
+    // Utility — exposed for testing introspection
+    // -------------------------------------------------------------------------
+    /** Current number of stored records. */
+    get size() {
+        return this.store.size;
+    }
+    /** Whether the provider has been closed. */
+    get isClosed() {
+        return this.closed;
+    }
+    // -------------------------------------------------------------------------
+    // Private helpers
+    // -------------------------------------------------------------------------
+    assertOpen() {
+        if (this.closed)
+            throw new ProviderClosedError("MemoryProvider");
+    }
+}
+//# sourceMappingURL=memory-provider.js.map

package/dist/memory-provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-provider.js","sourceRoot":"","sources":["../src/memory-provider.ts"],"names":[],"mappings":"AAAA,OAAO,EAAkB,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEjE;;;;;;;;;;GAUG;AACH,MAAM,OAAO,cAAc;IACjB,KAAK,GAAG,IAAI,GAAG,EAAa,CAAC;IAC7B,MAAM,GAAG,KAAK,CAAC;IAEvB,4EAA4E;IAC5E,YAAY;IACZ,4EAA4E;IAE5E,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,4EAA4E;IAC5E,kBAAkB;IAClB,4EAA4E;IAE5E,KAAK,CAAC,GAAG,CAAC,GAAW;QACnB,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAW,EAAE,KAAQ;QAC7B,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAW;QACtB,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAe;QACxB,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACpC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QACzB,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,MAAe;QACzB,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACnB,OAAO;QACT,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;YACpC,IAAI,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACzB,CAAC;QACH,CAAC;IACH,CAAC;IAED,4EAA4E;IAC5E,8CAA8C;IAC9C,4EAA4E;IAE5E,wCAAwC;IACxC,IAAI,IAAI;QACN,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC;IACzB,CAAC;IAED,4CAA4C;IAC5C,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,4EAA4E;IAC5E,kBAAkB;IAClB,4EAA4E;IAEpE,UAAU;QAChB,IAAI,IAAI,CAAC,MAAM;YAAE,MAAM,IAAI,mBAAmB,CAAC,gBAAgB,CAAC,CAAC;IACnE,CAAC;CACF"}

package/dist/registry.d.ts

@@ -0,0 +1,56 @@
+import { IWeaveProvider, ProviderFactory } from "./types.js";
+/**
+ * ProviderRegistry
+ *
+ * Central factory and registration hub for IWeaveProvider implementations.
+ *
+ * Built-in providers:
+ *   "json"   → JsonProvider  (default)
+ *   "memory" → MemoryProvider
+ *
+ * Third-party providers (weave-provider-sqlite, weave-provider-mongodb …) can
+ * register themselves at startup via `ProviderRegistry.register()`.
+ *
+ * Runtime resolution order:
+ *   1. `WEAVE_PROVIDER` environment variable (e.g. `WEAVE_PROVIDER=memory`)
+ *   2. Falls back to `"json"` when the env var is absent or empty
+ */
+export declare class ProviderRegistry {
+    private static factories;
+    /**
+     * Register a new provider factory under a named key.
+     * The key is normalised to lower-case before storing.
+     *
+     * @example
+     * // In weave-provider-sqlite:
+     * ProviderRegistry.register("sqlite", async () => new SqliteProvider(...));
+     */
+    static register<T = unknown>(name: string, factory: ProviderFactory<T>): void;
+    /**
+     * Resolve and instantiate a provider.
+     *
+     * @param type Explicit provider type string. When omitted, reads
+     *             `process.env.WEAVE_PROVIDER`.  Defaults to `"json"`.
+     *
+     * @throws {UnknownProviderError} if the type is not registered.
+     */
+    static resolve<T = unknown>(type?: string): Promise<IWeaveProvider<T>>;
+    /**
+     * Returns the list of currently registered provider names.
+     * Useful for diagnostics and help text.
+     */
+    static available(): string[];
+    /**
+     * Remove a registered provider (mainly for test isolation).
+     */
+    static unregister(name: string): void;
+}
+/**
+ * Convenience function — resolve the default (or env-configured) provider.
+ *
+ * @example
+ * const provider = await resolveProvider<GraphSnapshot>();
+ * await provider.set("graph:my-session", snapshot);
+ */
+export declare function resolveProvider<T = unknown>(type?: string): Promise<IWeaveProvider<T>>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,eAAe,EAKhB,MAAM,YAAY,CAAC;AAIpB;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAAC,SAAS,CAA+C;IAYvE;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,eAAe,CAAC,CAAC,CAAC,GAAG,IAAI;IAI7E;;;;;;;OAOG;WACU,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;IAW5E;;;OAGG;IACH,MAAM,CAAC,SAAS,IAAI,MAAM,EAAE;IAI5B;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAGtC;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,CAAC,GAAG,OAAO,EAC/C,IAAI,CAAC,EAAE,MAAM,GACZ,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAE5B"}

package/dist/registry.js

@@ -0,0 +1,82 @@
+import { WEAVE_PROVIDER_ENV, WEAVE_DATA_DIR_ENV, DEFAULT_DATA_DIR, UnknownProviderError, } from "./types.js";
+import { JsonProvider } from "./json-provider.js";
+import { MemoryProvider } from "./memory-provider.js";
+/**
+ * ProviderRegistry
+ *
+ * Central factory and registration hub for IWeaveProvider implementations.
+ *
+ * Built-in providers:
+ *   "json"   → JsonProvider  (default)
+ *   "memory" → MemoryProvider
+ *
+ * Third-party providers (weave-provider-sqlite, weave-provider-mongodb …) can
+ * register themselves at startup via `ProviderRegistry.register()`.
+ *
+ * Runtime resolution order:
+ *   1. `WEAVE_PROVIDER` environment variable (e.g. `WEAVE_PROVIDER=memory`)
+ *   2. Falls back to `"json"` when the env var is absent or empty
+ */
+export class ProviderRegistry {
+    static factories = new Map();
+    static {
+        // Register built-in providers
+        ProviderRegistry.register("json", async () => {
+            const dataDir = process.env[WEAVE_DATA_DIR_ENV] ?? DEFAULT_DATA_DIR;
+            return new JsonProvider(dataDir);
+        });
+        ProviderRegistry.register("memory", async () => new MemoryProvider());
+    }
+    /**
+     * Register a new provider factory under a named key.
+     * The key is normalised to lower-case before storing.
+     *
+     * @example
+     * // In weave-provider-sqlite:
+     * ProviderRegistry.register("sqlite", async () => new SqliteProvider(...));
+     */
+    static register(name, factory) {
+        ProviderRegistry.factories.set(name.toLowerCase(), factory);
+    }
+    /**
+     * Resolve and instantiate a provider.
+     *
+     * @param type Explicit provider type string. When omitted, reads
+     *             `process.env.WEAVE_PROVIDER`.  Defaults to `"json"`.
+     *
+     * @throws {UnknownProviderError} if the type is not registered.
+     */
+    static async resolve(type) {
+        const raw = (type ?? process.env[WEAVE_PROVIDER_ENV] ?? "json")
+            .trim()
+            .toLowerCase();
+        const factory = ProviderRegistry.factories.get(raw);
+        if (!factory)
+            throw new UnknownProviderError(raw);
+        return factory();
+    }
+    /**
+     * Returns the list of currently registered provider names.
+     * Useful for diagnostics and help text.
+     */
+    static available() {
+        return [...ProviderRegistry.factories.keys()].sort();
+    }
+    /**
+     * Remove a registered provider (mainly for test isolation).
+     */
+    static unregister(name) {
+        ProviderRegistry.factories.delete(name.toLowerCase());
+    }
+}
+/**
+ * Convenience function — resolve the default (or env-configured) provider.
+ *
+ * @example
+ * const provider = await resolveProvider<GraphSnapshot>();
+ * await provider.set("graph:my-session", snapshot);
+ */
+export async function resolveProvider(type) {
+    return ProviderRegistry.resolve(type);
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAEtD;;;;;;;;;;;;;;;GAeG;AACH,MAAM,OAAO,gBAAgB;IACnB,MAAM,CAAC,SAAS,GAAG,IAAI,GAAG,EAAoC,CAAC;IAEvE;QACE,8BAA8B;QAC9B,gBAAgB,CAAC,QAAQ,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;YAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,gBAAgB,CAAC;YACpE,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC;QACnC,CAAC,CAAC,CAAC;QAEH,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE,CAAC,IAAI,cAAc,EAAE,CAAC,CAAC;IACxE,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,QAAQ,CAAc,IAAY,EAAE,OAA2B;QACpE,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,OAAmC,CAAC,CAAC;IAC1F,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAc,IAAa;QAC7C,MAAM,GAAG,GAAG,CAAC,IAAI,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,IAAI,MAAM,CAAC;aAC5D,IAAI,EAAE;aACN,WAAW,EAAE,CAAC;QAEjB,MAAM,OAAO,GAAG,gBAAgB,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACpD,IAAI,CAAC,OAAO;YAAE,MAAM,IAAI,oBAAoB,CAAC,GAAG,CAAC,CAAC;QAElD,OAAO,OAAO,EAAgC,CAAC;IACjD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,SAAS;QACd,OAAO,CAAC,GAAG,gBAAgB,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,UAAU,CAAC,IAAY;QAC5B,gBAAgB,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;IACxD,CAAC;;AAGH;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAa;IAEb,OAAO,gBAAgB,CAAC,OAAO,CAAI,IAAI,CAAC,CAAC;AAC3C,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,91 @@
+/**
+ * weave-provider — Core type definitions
+ *
+ * IWeaveProvider<T> is the single storage contract that all provider
+ * implementations must satisfy. It follows a simple key-value model with
+ * optional namespace prefixes so that different subsystems (graph, sessions,
+ * vectors, paths) can share a single provider instance without colliding.
+ */
+/**
+ * Storage-agnostic key-value provider used by WeaveGraph, SessionLifecycle,
+ * VectorStore and WeavePath for all persistence needs.
+ *
+ * @typeParam T The value type stored under each key. In practice this will be
+ *              a serialisable plain object (JSON-compatible).
+ */
+export interface IWeaveProvider<T = unknown> {
+    /**
+     * Retrieve a single record by its full key.
+     * Returns `null` if the key does not exist.
+     */
+    get(key: string): Promise<T | null>;
+    /**
+     * Persist a record under the given key, overwriting any previous value.
+     */
+    set(key: string, value: T): Promise<void>;
+    /**
+     * Remove the record associated with the given key.
+     * A no-op if the key does not exist (must NOT throw).
+     */
+    delete(key: string): Promise<void>;
+    /**
+     * List all keys that start with the given prefix.
+     * If prefix is omitted, return every key in the store.
+     *
+     * @param prefix Optional key prefix filter (e.g. `"graph:"`, `"session:"`).
+     */
+    list(prefix?: string): Promise<string[]>;
+    /**
+     * Delete all records whose keys start with the given prefix.
+     * If prefix is omitted, the entire store is wiped.
+     *
+     * @param prefix Optional key prefix filter.
+     */
+    clear(prefix?: string): Promise<void>;
+    /**
+     * Release any resources held by this provider (file handles, DB connections
+     * etc.). After `close()` is called the provider must not accept further
+     * operations.
+     */
+    close(): Promise<void>;
+}
+/**
+ * A zero-argument async factory that resolves to a ready-to-use provider.
+ * Used by the registry when building providers from a connection string.
+ */
+export type ProviderFactory<T = unknown> = () => Promise<IWeaveProvider<T>>;
+/**
+ * Environment variable that controls which provider the registry resolves.
+ *
+ * Accepted values (case-insensitive):
+ *   - `"json"` (default)        → JsonProvider
+ *   - `"memory"`                → MemoryProvider
+ *   - `"sqlite"` / a file path  → weave-provider-sqlite (separate package)
+ *   - `"mongodb"` / a URI       → weave-provider-mongodb (separate package)
+ *   - `"postgres"` / a URI      → weave-provider-postgres (separate package)
+ *   - `"mysql"` / a URI         → weave-provider-mysql (separate package)
+ */
+export declare const WEAVE_PROVIDER_ENV = "WEAVE_PROVIDER";
+/**
+ * Environment variable that controls the root data directory used by the
+ * JsonProvider (and, conventionally, any file-based provider).
+ */
+export declare const WEAVE_DATA_DIR_ENV = "WEAVE_DATA_DIR";
+/**
+ * Default data directory value when WEAVE_DATA_DIR is not set.
+ */
+export declare const DEFAULT_DATA_DIR = "./weave-data";
+/**
+ * Thrown when a provider operation is invoked after `close()` has been called.
+ */
+export declare class ProviderClosedError extends Error {
+    constructor(providerName: string);
+}
+/**
+ * Thrown when the registry cannot resolve a provider from the current
+ * environment configuration.
+ */
+export declare class UnknownProviderError extends Error {
+    constructor(value: string);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAMH;;;;;;GAMG;AACH,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO;IACzC;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAEpC;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE1C;;;OAGG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;;;;OAKG;IACH,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAEzC;;;;;OAKG;IACH,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtC;;;;OAIG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAMD;;;GAGG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,GAAG,OAAO,IAAI,MAAM,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;AAM5E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,kBAAkB,mBAAmB,CAAC;AAEnD;;GAEG;AACH,eAAO,MAAM,gBAAgB,iBAAiB,CAAC;AAM/C;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,YAAY,EAAE,MAAM;CAIjC;AAED;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,KAAK;gBACjC,KAAK,EAAE,MAAM;CAQ1B"}

package/dist/types.js

@@ -0,0 +1,57 @@
+/**
+ * weave-provider — Core type definitions
+ *
+ * IWeaveProvider<T> is the single storage contract that all provider
+ * implementations must satisfy. It follows a simple key-value model with
+ * optional namespace prefixes so that different subsystems (graph, sessions,
+ * vectors, paths) can share a single provider instance without colliding.
+ */
+// ---------------------------------------------------------------------------
+// Registry configuration
+// ---------------------------------------------------------------------------
+/**
+ * Environment variable that controls which provider the registry resolves.
+ *
+ * Accepted values (case-insensitive):
+ *   - `"json"` (default)        → JsonProvider
+ *   - `"memory"`                → MemoryProvider
+ *   - `"sqlite"` / a file path  → weave-provider-sqlite (separate package)
+ *   - `"mongodb"` / a URI       → weave-provider-mongodb (separate package)
+ *   - `"postgres"` / a URI      → weave-provider-postgres (separate package)
+ *   - `"mysql"` / a URI         → weave-provider-mysql (separate package)
+ */
+export const WEAVE_PROVIDER_ENV = "WEAVE_PROVIDER";
+/**
+ * Environment variable that controls the root data directory used by the
+ * JsonProvider (and, conventionally, any file-based provider).
+ */
+export const WEAVE_DATA_DIR_ENV = "WEAVE_DATA_DIR";
+/**
+ * Default data directory value when WEAVE_DATA_DIR is not set.
+ */
+export const DEFAULT_DATA_DIR = "./weave-data";
+// ---------------------------------------------------------------------------
+// Error types
+// ---------------------------------------------------------------------------
+/**
+ * Thrown when a provider operation is invoked after `close()` has been called.
+ */
+export class ProviderClosedError extends Error {
+    constructor(providerName) {
+        super(`[${providerName}] provider has been closed and is no longer usable`);
+        this.name = "ProviderClosedError";
+    }
+}
+/**
+ * Thrown when the registry cannot resolve a provider from the current
+ * environment configuration.
+ */
+export class UnknownProviderError extends Error {
+    constructor(value) {
+        super(`[weave-provider] Unknown provider type "${value}". ` +
+            `Set ${WEAVE_PROVIDER_ENV}=json|memory or install the corresponding ` +
+            `weave-provider-* package.`);
+        this.name = "UnknownProviderError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAiEH,8EAA8E;AAC9E,yBAAyB;AACzB,8EAA8E;AAE9E;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAEnD;;;GAGG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC;AAEnD;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC;AAE/C,8EAA8E;AAC9E,cAAc;AACd,8EAA8E;AAE9E;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC5C,YAAY,YAAoB;QAC9B,KAAK,CAAC,IAAI,YAAY,oDAAoD,CAAC,CAAC;QAC5E,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACpC,CAAC;CACF;AAED;;;GAGG;AACH,MAAM,OAAO,oBAAqB,SAAQ,KAAK;IAC7C,YAAY,KAAa;QACvB,KAAK,CACH,2CAA2C,KAAK,KAAK;YACnD,OAAO,kBAAkB,4CAA4C;YACrE,2BAA2B,CAC9B,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF"}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@openweave/weave-provider",
+  "version": "0.8.0",
+  "description": "Storage-agnostic persistence contract for OpenWeave — IWeaveProvider<T> interface + built-in implementations",
+  "private": false,
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "keywords": [
+    "openweave",
+    "persistence",
+    "provider",
+    "storage"
+  ],
+  "devDependencies": {
+    "@types/node": "22.10.2",
+    "typescript": "5.7.2",
+    "vitest": "3.0.0"
+  },
+  "dependencies": {},
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest",
+    "lint": "eslint src --max-warnings 0",
+    "clean": "rm -rf dist"
+  }
+}