@cyanmycelium/mcp-persistence 0.0.0-stage → 0.1.0

package/dist/provider/main.js

@@ -0,0 +1,82 @@
+#!/usr/bin/env node
+import { McpServerBuilder } from "@cyanmycelium/mcp-core";
+import { DirectTransport } from "@cyanmycelium/mcp-broker-provider";
+import { BrokerAccessGuard, openGuard } from "@cyanmycelium/mcp-uns";
+import { SqlitePersistenceStore } from "../sqlite/sqlite.persistence.store.js";
+import { PersistenceBehavior } from "../server/persistence.behavior.js";
+import { buildPersistenceDeclaration } from "../server/declaration.js";
+import { createArtifactTransferServer } from "./artifact.http.js";
+import { integer } from "../contract/validation.js";
+async function main() {
+    const dev = process.argv.includes("--dev");
+    if (process.argv.slice(2).some(arg => arg !== "--dev"))
+        throw new Error("Usage: mcp-persistence [--dev]");
+    const root = process.env.MCP_PERSISTENCE_RESOURCE_ROOT ?? "/local/persistence";
+    const brokerBase = process.env.MCP_PERSISTENCE_BROKER_URL ?? "http://127.0.0.1:3000";
+    const brokerUrl = new URL(brokerBase);
+    if (!["http:", "https:"].includes(brokerUrl.protocol) || brokerUrl.username || brokerUrl.password || brokerUrl.pathname !== "/" || brokerUrl.search || brokerUrl.hash)
+        throw new Error("Broker URL must be an HTTP(S) origin without credentials");
+    const loopback = ["127.0.0.1", "localhost", "[::1]"].includes(brokerUrl.hostname);
+    const secret = process.env.MCP_PERSISTENCE_PROVIDER_SECRET;
+    if (!dev && !secret)
+        throw new Error("Production requires MCP_PERSISTENCE_PROVIDER_SECRET; use --dev explicitly for the local open guard");
+    if (!dev && brokerUrl.protocol !== "https:" && !loopback)
+        throw new Error("Remote production broker requires HTTPS");
+    if (dev && (!loopback || brokerUrl.protocol !== "http:"))
+        throw new Error("--dev requires a loopback HTTP broker");
+    let localBroker;
+    let server;
+    let store;
+    let http;
+    try {
+        if (dev) {
+            const { WsTunnelBuilder } = await import("@cyanmycelium/mcp-broker");
+            localBroker = new WsTunnelBuilder().withHost("127.0.0.1").withPort(Number(brokerUrl.port || 80)).build();
+            await localBroker.start();
+            console.error("[persistence] DEV: openGuard enabled, loopback only, no access policy. Use a separate data root.");
+        }
+        store = new SqlitePersistenceStore({ directory: process.env.MCP_PERSISTENCE_DATA ?? (dev ? "./data-dev" : "./data"), allowFileSyncOnly: process.env.MCP_PERSISTENCE_ALLOW_FILE_SYNC_ONLY === "1" });
+        const ws = new URL("/provider/persistence", brokerUrl);
+        ws.protocol = brokerUrl.protocol === "https:" ? "wss:" : "ws:";
+        const transport = new DirectTransport(ws.toString(), dev ? { aggregate: true } : { secret });
+        const guard = dev ? openGuard() : new BrokerAccessGuard(transport.broker);
+        server = new McpServerBuilder().withName("persistence").withTransport(transport).withGrammarResolver(() => `default:${process.env.MCP_PERSISTENCE_LOCALE === "fr" ? "fr" : "en"}`).register(new PersistenceBehavior(store, guard, { namespace: root })).build();
+        await server.start();
+        if (!dev) {
+            const declaration = await transport.broker.declare(buildPersistenceDeclaration({ version: "1", namespace: root }));
+            if (!declaration.accepted)
+                throw new Error("Broker refused the persistence declaration");
+        }
+        http = createArtifactTransferServer({ store, brokerMcpUrl: new URL("/persistence/mcp", brokerUrl).toString(), dev });
+        const port = integer(Number(process.env.MCP_PERSISTENCE_TRANSFER_PORT ?? 3001), 1, 65535);
+        await new Promise((resolve, reject) => { http.once("error", reject); http.listen(port, "127.0.0.1", resolve); });
+        console.error(`[persistence] ${dev ? "DEV" : "broker-authorized"} provider started; transfer endpoint on loopback:${port}`);
+        let stopping = false;
+        const stop = async () => {
+            if (stopping)
+                return;
+            stopping = true;
+            try {
+                await new Promise(resolve => http.close(() => resolve()));
+                await server?.stop?.();
+                await store?.closeAsync();
+                await localBroker?.stop();
+            }
+            catch {
+                console.error("[persistence] Shutdown failed");
+                process.exitCode = 1;
+            }
+        };
+        process.once("SIGINT", () => { void stop(); });
+        process.once("SIGTERM", () => { void stop(); });
+    }
+    catch (error) {
+        http?.close();
+        await server?.stop?.();
+        await store?.closeAsync();
+        await localBroker?.stop();
+        throw error;
+    }
+}
+main().catch(error => { console.error(`[persistence] ${error instanceof Error && !error.message.includes("\\") ? error.message : "Startup failed"}`); process.exitCode = 1; });
+//# sourceMappingURL=main.js.map

package/dist/provider/main.js.map

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

package/dist/server/declaration.d.ts

@@ -0,0 +1,18 @@
+export declare class PersistenceResources {
+    readonly root: string;
+    constructor(root: string);
+    document(namespace: string, id: string): string;
+    artifact(namespace: string, id: string): string;
+}
+export declare function buildPersistenceDeclaration(input: {
+    version: string;
+    namespace: string;
+}): {
+    version: string;
+    domain: string;
+    namespace: {
+        resource: string;
+    };
+    capabilities: string[];
+    resultsRequired: string[];
+};

package/dist/server/declaration.js

@@ -0,0 +1,23 @@
+import { segment, text } from "../contract/validation.js";
+export class PersistenceResources {
+    root;
+    constructor(root) {
+        this.root = root;
+        if (!root.startsWith("/") || root.split("/").slice(1).some(s => { try {
+            segment(s);
+            return false;
+        }
+        catch {
+            return true;
+        } }))
+            throw new Error("Invalid broker resource root");
+    }
+    document(namespace, id) { return `${this.root}/namespaces/${segment(namespace)}/documents/${segment(id)}`; }
+    artifact(namespace, id) { return `${this.root}/namespaces/${segment(namespace)}/artifacts/${segment(id)}`; }
+}
+export function buildPersistenceDeclaration(input) {
+    new PersistenceResources(input.namespace);
+    text(input.version);
+    return { version: input.version, domain: "persistence", namespace: { resource: input.namespace }, capabilities: ["persistence.read", "persistence.write", "persistence.delete", "persistence.admin"], resultsRequired: ["persistence.write", "persistence.delete", "persistence.admin"] };
+}
+//# sourceMappingURL=declaration.js.map

package/dist/server/declaration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"declaration.js","sourceRoot":"","sources":["../../src/server/declaration.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AAE1D,MAAM,OAAO,oBAAoB;IACR;IAArB,YAAqB,IAAY;QAAZ,SAAI,GAAJ,IAAI,CAAQ;QAC7B,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,CAAC;YAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YAAC,OAAO,KAAK,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC;YAAC,OAAO,IAAI,CAAC;QAAC,CAAC,CAAC,CAAC,CAAC;YAAE,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACnL,CAAC;IACD,QAAQ,CAAC,SAAiB,EAAE,EAAU,IAAY,OAAO,GAAG,IAAI,CAAC,IAAI,eAAe,OAAO,CAAC,SAAS,CAAC,cAAc,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;IACpI,QAAQ,CAAC,SAAiB,EAAE,EAAU,IAAY,OAAO,GAAG,IAAI,CAAC,IAAI,eAAe,OAAO,CAAC,SAAS,CAAC,cAAc,OAAO,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;CACvI;AACD,MAAM,UAAU,2BAA2B,CAAC,KAA6C;IACrF,IAAI,oBAAoB,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC/D,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,EAAE,EAAE,YAAY,EAAE,CAAC,kBAAkB,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,mBAAmB,CAAC,EAAE,eAAe,EAAE,CAAC,mBAAmB,EAAE,oBAAoB,EAAE,mBAAmB,CAAC,EAAE,CAAC;AAC9R,CAAC"}

package/dist/server/persistence.behavior.d.ts

@@ -0,0 +1,16 @@
+import { McpBehavior, McpGrammar, type McpResource, type McpResourceTemplate, type McpTool } from "@cyanmycelium/mcp-core";
+import type { IAccessGuard } from "@cyanmycelium/mcp-uns";
+import type { IPersistenceStore } from "../contract/persistence.store.js";
+import type { IStoreContext } from "../contract/persistence.types.js";
+/** Broker caller references are request-scoped, not stable user ids. Keys are shared per namespace. */
+export declare const MCP_STORE_CONTEXT: IStoreContext;
+export declare const CAPABILITIES_URI = "persistence://capabilities";
+export declare class PersistenceBehavior extends McpBehavior {
+    constructor(store: IPersistenceStore, guard: IAccessGuard, options: {
+        namespace: string;
+    });
+    protected _buildResources(): McpResource[];
+    protected _buildTemplate(): McpResourceTemplate[];
+    protected _buildGrammars(): Map<string, McpGrammar>;
+    protected _buildTools(): McpTool[];
+}

package/dist/server/persistence.behavior.js

@@ -0,0 +1,173 @@
+import { McpAdapterBase, McpBehavior, McpGrammar } from "@cyanmycelium/mcp-core";
+import { PersistenceError } from "../contract/errors.js";
+import { fail, segment } from "../contract/validation.js";
+import { PersistenceResources } from "./declaration.js";
+import { PERSISTENCE_TOOLS, PERSISTENCE_RESOURCE_TEMPLATES, PERSISTENCE_TOOL_DESCRIPTIONS as EN } from "../contract/persistence.protocol.js";
+/** Broker caller references are request-scoped, not stable user ids. Keys are shared per namespace. */
+export const MCP_STORE_CONTEXT = Object.freeze({ subject: "broker-namespace" });
+export const CAPABILITIES_URI = "persistence://capabilities";
+const FR = {
+    capabilities: "Lire les limites du protocole et les garanties de durabilité.",
+    get: "Lire la tête d'un document ou une révision immuable.", put: "Créer ou modifier avec expectedRevision et une clé d'idempotence.",
+    list: "Lister les documents autorisés avec pagination bornée.", listRevisions: "Lister les révisions immuables d'un document autorisé.",
+    delete: "Ajouter une suppression logique en conservant l'historique et les fichiers.", purge: "Purger définitivement une révision ou un artefact sans référence après rétention.",
+    beginArtifact: "Réserver un transfert. Les octets passent par le point HTTP authentifié.",
+    commitArtifact: "Vérifier et publier atomiquement un transfert terminé.", abortArtifact: "Annuler un transfert inactif.",
+    getArtifact: "Lire les métadonnées ; les octets passent par le point HTTP authentifié.",
+    uploadAccess: "Autoriser un flux de transfert et lire ses métadonnées cibles.",
+};
+class PersistenceAdapter extends McpAdapterBase {
+    store;
+    guard;
+    paths;
+    constructor(store, guard, root) {
+        super("persistence");
+        this.store = store;
+        this.guard = guard;
+        this.paths = new PersistenceResources(root);
+    }
+    check(capability, kind, key) {
+        return { capability: `persistence.${capability}`, resource: `persistence:${kind}:${segment(key.namespace)}/${segment(key.id)}`, resourcePath: this.paths[kind](key.namespace, key.id) };
+    }
+    async decisions(checks, request) {
+        const decisions = await this.guard.authorizeAsync(checks, request);
+        if (decisions.length !== checks.length)
+            fail("policy_denied", "No complete authorization decision");
+        return decisions;
+    }
+    async allowed(checks, request) {
+        const decisions = await this.decisions(checks, request);
+        if (decisions.some(d => !d.allowed || d.constraints)) {
+            for (const d of decisions)
+                if (d.allowed)
+                    this.guard.report(d, "refused", "policy_denied");
+            fail("policy_denied", "Access refused");
+        }
+        return decisions;
+    }
+    async mutation(checks, request, action) {
+        const decisions = await this.allowed(checks, request);
+        try {
+            const result = await action();
+            for (const d of decisions)
+                this.guard.report(d, "success");
+            return result;
+        }
+        catch (error) {
+            for (const d of decisions)
+                this.guard.report(d, "failure", error instanceof PersistenceError ? error.code : "store_unavailable");
+            throw error;
+        }
+    }
+    async upload(args, request) {
+        const namespace = segment(args.namespace), uploadId = segment(args.uploadId);
+        let upload;
+        try {
+            upload = await this.store.inspectUploadAsync(namespace, uploadId, MCP_STORE_CONTEXT);
+        }
+        catch (error) {
+            await this.allowed([this.check("write", "artifact", { namespace, id: "_new" })], request);
+            throw error;
+        }
+        return upload;
+    }
+    async invoke(name, args, request) {
+        if (name === "capabilities")
+            return this.store.getCapabilitiesAsync();
+        const namespace = segment(args.namespace);
+        const context = MCP_STORE_CONTEXT;
+        switch (name) {
+            case "list": {
+                const page = await this.store.listAsync(args, context);
+                const decisions = await this.decisions(page.items.map(d => this.check("read", "document", d)), request);
+                return { ...page, items: page.items.filter((_, i) => decisions[i]?.allowed && !decisions[i]?.constraints) };
+            }
+            case "get":
+            case "listRevisions": {
+                const key = { namespace, id: segment(args.id) };
+                await this.allowed([this.check("read", "document", key)], request);
+                return name === "get" ? this.store.getAsync(args, context)
+                    : this.store.listRevisionsAsync(args, context);
+            }
+            case "put": {
+                const input = args;
+                if (!Array.isArray(input.references))
+                    fail("invalid_request", "Expected references array");
+                const checks = [this.check("write", "document", { namespace, id: segment(args.id) })];
+                const caps = await this.store.getCapabilitiesAsync();
+                if (input.references.length > caps.limits.maxReferences)
+                    fail("invalid_request", "Too many references");
+                for (const ref of input.references) {
+                    if (!ref || (ref.type !== "document" && ref.type !== "artifact"))
+                        fail("invalid_request", "Invalid reference");
+                    checks.push(this.check("read", ref.type, ref));
+                }
+                return this.mutation(checks, request, () => this.store.putAsync(input, context));
+            }
+            case "delete": return this.mutation([this.check("delete", "document", { namespace, id: segment(args.id) })], request, () => this.store.deleteAsync(args, context));
+            case "purge": {
+                const input = args;
+                if (!input.target || (input.target.type !== "document" && input.target.type !== "artifact"))
+                    fail("invalid_request", "Invalid purge target");
+                return this.mutation([this.check("admin", input.target.type, { namespace, id: segment(input.target.id) })], request, () => this.store.purgeAsync(input, context));
+            }
+            case "beginArtifact": return this.mutation([this.check("write", "artifact", { namespace, id: "_new" })], request, () => this.store.beginArtifactAsync(args, context));
+            case "uploadAccess":
+            case "commitArtifact":
+            case "abortArtifact": {
+                const upload = await this.upload(args, request);
+                const checks = [this.check("write", "artifact", { namespace, id: upload.artifactId })];
+                if (name === "uploadAccess")
+                    return this.mutation(checks, request, async () => upload);
+                return this.mutation(checks, request, () => name === "commitArtifact"
+                    ? this.store.commitArtifactAsync(args, context) : this.store.abortArtifactAsync(args, context));
+            }
+            case "getArtifact": {
+                const key = { namespace, id: segment(args.id) };
+                await this.allowed([this.check("read", "artifact", key)], request);
+                return this.store.getArtifactAsync(key, context);
+            }
+            default: fail("invalid_request", "Unknown persistence tool");
+        }
+    }
+    async executeToolAsync(_uri, tool, args, request) {
+        try {
+            const definition = PERSISTENCE_TOOLS.find(t => t.name === tool);
+            if (!definition)
+                fail("invalid_request", "Unknown persistence tool");
+            const schema = definition.inputSchema;
+            if (Object.keys(args).some(k => !Object.hasOwn(schema.properties, k)) || schema.required.some(k => !Object.hasOwn(args, k)))
+                fail("invalid_request", "Unknown or missing tool argument");
+            const payload = (await this.invoke(tool.replace(/^persistence\./, ""), args, request)) ?? { ok: true };
+            return { content: [{ type: "text", text: JSON.stringify(payload) }], structuredContent: payload };
+        }
+        catch (error) {
+            const code = error instanceof PersistenceError ? error.code : "store_unavailable";
+            const payload = { error: { code, message: error instanceof PersistenceError ? error.message : "Persistence operation failed" } };
+            return { isError: true, content: [{ type: "text", text: JSON.stringify(payload) }], structuredContent: payload };
+        }
+    }
+    async readResourceAsync(uri, request) {
+        if (uri === CAPABILITIES_URI)
+            return { uri, mimeType: "application/json", text: JSON.stringify(await this.store.getCapabilitiesAsync()) };
+        const match = /^persistence:\/\/(documents|artifacts)\/([^/]+)\/([^/]+)(?:\/revisions\/(\d+))?$/.exec(uri);
+        if (!match || (match[1] === "artifacts" && match[4]))
+            return undefined;
+        const args = { namespace: decodeURIComponent(match[2]), id: decodeURIComponent(match[3]), ...(match[4] ? { revision: Number(match[4]) } : {}) };
+        return { uri, mimeType: "application/json", text: JSON.stringify(await this.invoke(match[1] === "documents" ? "get" : "getArtifact", args, request)) };
+    }
+}
+export class PersistenceBehavior extends McpBehavior {
+    constructor(store, guard, options) { super(new PersistenceAdapter(store, guard, options.namespace), { namespace: "persistence" }); }
+    _buildResources() { return [{ uri: CAPABILITIES_URI, name: "Persistence capabilities", mimeType: "application/json", description: EN.capabilities }]; }
+    _buildTemplate() {
+        return structuredClone(PERSISTENCE_RESOURCE_TEMPLATES);
+    }
+    _buildGrammars() {
+        return new Map([["default:en", EN], ["default:fr", FR]].map(([key, descriptions]) => [key, McpGrammar.fromJSON({ tools: Object.fromEntries(Object.entries(descriptions).map(([name, description]) => [`persistence.${name}`, { description }])) })]));
+    }
+    _buildTools() {
+        return structuredClone(PERSISTENCE_TOOLS);
+    }
+}
+//# sourceMappingURL=persistence.behavior.js.map

package/dist/server/persistence.behavior.js.map

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

package/dist/server/persistence.slot.store.d.ts

@@ -0,0 +1,45 @@
+import type { IPersistenceStore } from "../contract/persistence.store.js";
+import type { IArtifact, IBeginArtifact, IDeleteDocument, IDocument, IDocumentKey, IFinishArtifact, IListDocuments, IPage, IPageRequest, IPersistenceCapabilities, IPurge, IPutDocument, IStoreContext, IUpload } from "../contract/persistence.types.js";
+export interface ISlotClient {
+    callTool(name: string, args: Record<string, unknown>): Promise<{
+        content?: readonly unknown[];
+        structuredContent?: unknown;
+        isError?: boolean;
+    }>;
+}
+export declare function slotPayload(result: Awaited<ReturnType<ISlotClient["callTool"]>>): unknown;
+export interface ITransferClientOptions {
+    baseUrl: string;
+    /** The same bearer credentials used by the MCP client. Never sent to an arbitrary redirected URL. */
+    headers?: () => Record<string, string>;
+}
+export declare class PersistenceSlotStore implements IPersistenceStore {
+    readonly id: string;
+    private readonly client;
+    private readonly transfer?;
+    constructor(id: string, client: ISlotClient, transfer?: ITransferClientOptions | undefined);
+    private call;
+    getCapabilitiesAsync(): Promise<IPersistenceCapabilities>;
+    getAsync(r: IDocumentKey & {
+        revision?: number;
+    }, c: IStoreContext): Promise<IDocument>;
+    putAsync(r: IPutDocument, c: IStoreContext): Promise<IDocument>;
+    listAsync(r: IListDocuments, c: IStoreContext): Promise<IPage<IDocument>>;
+    listRevisionsAsync(r: IDocumentKey & IPageRequest, c: IStoreContext): Promise<IPage<IDocument>>;
+    deleteAsync(r: IDeleteDocument, c: IStoreContext): Promise<IDocument>;
+    purgeAsync(r: IPurge, c: IStoreContext): Promise<void>;
+    beginArtifactAsync(r: IBeginArtifact, c: IStoreContext): Promise<IUpload>;
+    inspectUploadAsync(namespace: string, uploadId: string, c: IStoreContext): Promise<IUpload>;
+    commitArtifactAsync(r: IFinishArtifact, c: IStoreContext): Promise<IArtifact>;
+    abortArtifactAsync(r: IFinishArtifact, c: IStoreContext): Promise<void>;
+    getArtifactAsync(r: IDocumentKey, c: IStoreContext): Promise<IArtifact>;
+    private response;
+    writeArtifactAsync(r: {
+        namespace: string;
+        uploadId: string;
+        bytes: AsyncIterable<Uint8Array>;
+    }, c: IStoreContext): Promise<void>;
+    readArtifactAsync(r: IDocumentKey, c: IStoreContext): Promise<AsyncIterable<Uint8Array>>;
+    /** Caller owns the connected MCP client. Context.subject is never sent over the wire. */
+    closeAsync(): Promise<void>;
+}

package/dist/server/persistence.slot.store.js

@@ -0,0 +1,94 @@
+import { PersistenceError } from "../contract/errors.js";
+import { fail, segment } from "../contract/validation.js";
+export function slotPayload(result) {
+    let payload = result.structuredContent;
+    if (payload === undefined) {
+        const block = result.content?.find(b => typeof b === "object" && b !== null && b.type === "text");
+        try {
+            payload = JSON.parse(block?.text ?? "null");
+        }
+        catch {
+            fail("integrity_error", "Malformed persistence response");
+        }
+    }
+    if (result.isError) {
+        const error = payload?.error;
+        throw new PersistenceError((error?.code ?? "store_unavailable"), error?.message ?? "Persistence operation failed");
+    }
+    return payload;
+}
+export class PersistenceSlotStore {
+    id;
+    client;
+    transfer;
+    constructor(id, client, transfer) {
+        this.id = id;
+        this.client = client;
+        this.transfer = transfer;
+        if (transfer) {
+            const url = new URL(transfer.baseUrl);
+            if (url.username || url.password || url.search || url.hash || (url.protocol !== "https:" && !(url.protocol === "http:" && ["localhost", "127.0.0.1", "[::1]"].includes(url.hostname))))
+                fail("invalid_request", "Transfer endpoint requires HTTPS or loopback HTTP");
+        }
+    }
+    async call(method, request, context) {
+        context?.signal?.throwIfAborted();
+        return slotPayload(await this.client.callTool(`persistence.${method}`, { ...request }));
+    }
+    getCapabilitiesAsync() { return this.call("capabilities", {}); }
+    getAsync(r, c) { return this.call("get", { namespace: r.namespace, id: r.id, ...(r.revision === undefined ? {} : { revision: r.revision }) }, c); }
+    putAsync(r, c) { return this.call("put", r, c); }
+    listAsync(r, c) { return this.call("list", r, c); }
+    listRevisionsAsync(r, c) { return this.call("listRevisions", { namespace: r.namespace, id: r.id, ...(r.limit === undefined ? {} : { limit: r.limit }), ...(r.cursor === undefined ? {} : { cursor: r.cursor }) }, c); }
+    deleteAsync(r, c) { return this.call("delete", r, c); }
+    purgeAsync(r, c) { return this.call("purge", r, c); }
+    beginArtifactAsync(r, c) { return this.call("beginArtifact", r, c); }
+    inspectUploadAsync(namespace, uploadId, c) { return this.call("uploadAccess", { namespace, uploadId }, c); }
+    commitArtifactAsync(r, c) { return this.call("commitArtifact", r, c); }
+    abortArtifactAsync(r, c) { return this.call("abortArtifact", r, c); }
+    getArtifactAsync(r, c) { return this.call("getArtifact", { namespace: r.namespace, id: r.id }, c); }
+    async response(path, init) {
+        if (!this.transfer)
+            fail("unsupported_format", "Configure the HTTP transfer endpoint");
+        const response = await fetch(`${this.transfer.baseUrl.replace(/\/$/, "")}${path}`, { ...init, headers: { ...this.transfer.headers?.(), ...init.headers }, redirect: "error" });
+        if (!response.ok) {
+            let body = {};
+            try {
+                body = await response.json();
+            }
+            catch { /* A proxy may return a non-JSON failure. */ }
+            throw new PersistenceError(body.error?.code ?? (response.status === 403 || response.status === 401 ? "policy_denied" : "store_unavailable"), "Artifact transfer failed");
+        }
+        return response;
+    }
+    async writeArtifactAsync(r, c) {
+        c.signal?.throwIfAborted();
+        const iterator = r.bytes[Symbol.asyncIterator]();
+        const stream = new ReadableStream({ async pull(controller) { const next = await iterator.next(); if (next.done)
+                controller.close();
+            else
+                controller.enqueue(next.value); }, async cancel() { await iterator.return?.(); } });
+        await this.response(`/uploads/${segment(r.namespace)}/${segment(r.uploadId)}`, { method: "PUT", body: stream, signal: c.signal, duplex: "half" });
+    }
+    async readArtifactAsync(r, c) {
+        const response = await this.response(`/artifacts/${segment(r.namespace)}/${segment(r.id)}`, { signal: c.signal });
+        if (!response.body)
+            fail("transfer_incomplete", "Missing artifact response body");
+        const body = response.body;
+        return (async function* () { const reader = body.getReader(); try {
+            while (true) {
+                const chunk = await reader.read();
+                if (chunk.done)
+                    break;
+                yield chunk.value;
+            }
+        }
+        finally {
+            await reader.cancel();
+            reader.releaseLock();
+        } })();
+    }
+    /** Caller owns the connected MCP client. Context.subject is never sent over the wire. */
+    async closeAsync() { }
+}
+//# sourceMappingURL=persistence.slot.store.js.map

package/dist/server/persistence.slot.store.js.map

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

package/dist/sqlite/sqlite.persistence.store.d.ts

@@ -0,0 +1,72 @@
+import type { IPersistenceStore } from "../contract/persistence.store.js";
+import type { IArtifact, IBeginArtifact, IDeleteDocument, IDocument, IDocumentKey, IFinishArtifact, IListDocuments, IPage, IPageRequest, IPersistenceCapabilities, IPurge, IPutDocument, IStoreContext, IUpload } from "../contract/persistence.types.js";
+declare const DEFAULTS: {
+    maxDocumentBytes: number;
+    maxArtifactBytes: number;
+    maxReferences: number;
+    maxPageSize: number;
+    maxNamespaceBytes: number;
+    idempotencyRetentionSeconds: number;
+};
+export interface ISqlitePersistenceOptions {
+    directory: string;
+    limits?: Partial<typeof DEFAULTS>;
+    retentionMs?: number;
+    /** Windows cannot fsync directories through Node. Opt in explicitly to file-sync durability. */
+    allowFileSyncOnly?: boolean;
+}
+/** One provider process owns one local data root. SQLite serializes all metadata mutations. */
+export declare class SqlitePersistenceStore implements IPersistenceStore {
+    readonly id = "sqlite-files";
+    readonly directory: string;
+    private readonly db;
+    private readonly limits;
+    private readonly cursorKey;
+    private readonly retentionMs;
+    private readonly fileSyncOnly;
+    private readonly active;
+    private readonly readers;
+    private closed;
+    constructor(options: ISqlitePersistenceOptions);
+    private safe;
+    private syncDirectory;
+    private writeDurable;
+    private check;
+    private key;
+    private quota;
+    private mutation;
+    getCapabilitiesAsync(): Promise<IPersistenceCapabilities>;
+    private document;
+    getAsync(request: IDocumentKey & {
+        revision?: number;
+    }, context: IStoreContext): Promise<IDocument>;
+    private insert;
+    putAsync(request: IPutDocument, context: IStoreContext): Promise<IDocument>;
+    private page;
+    private pageAfter;
+    private pageLimit;
+    listAsync(request: IListDocuments, context: IStoreContext): Promise<IPage<IDocument>>;
+    listRevisionsAsync(request: IDocumentKey & IPageRequest, context: IStoreContext): Promise<IPage<IDocument>>;
+    deleteAsync(request: IDeleteDocument, context: IStoreContext): Promise<IDocument>;
+    beginArtifactAsync(request: IBeginArtifact, context: IStoreContext): Promise<IUpload>;
+    private upload;
+    inspectUploadAsync(namespace: string, uploadId: string, context: IStoreContext): Promise<IUpload>;
+    writeArtifactAsync(request: {
+        namespace: string;
+        uploadId: string;
+        bytes: AsyncIterable<Uint8Array>;
+    }, context: IStoreContext): Promise<void>;
+    commitArtifactAsync(request: IFinishArtifact, context: IStoreContext): Promise<IArtifact>;
+    abortArtifactAsync(request: IFinishArtifact, context: IStoreContext): Promise<void>;
+    private artifact;
+    getArtifactAsync(request: IDocumentKey, context: IStoreContext): Promise<IArtifact>;
+    readArtifactAsync(request: IDocumentKey, context: IStoreContext): Promise<AsyncIterable<Uint8Array>>;
+    private verifyFile;
+    purgeAsync(request: IPurge, context: IStoreContext): Promise<void>;
+    private collectGarbage;
+    private expireUploads;
+    private collectOrphans;
+    private recover;
+    closeAsync(): Promise<void>;
+}
+export {};