@cyanmycelium/mcp-persistence 0.0.0-stage → 0.2.0

package/dist/conformance/persistence.conformance.d.ts

@@ -0,0 +1,4 @@
+import type { IPersistenceStore } from "../contract/persistence.store.js";
+import type { IStoreContext } from "../contract/persistence.types.js";
+/** Reuse on a direct backend or a PersistenceSlotStore with the same caller privileges. */
+export declare function describePersistenceStoreConformance(name: string, getStore: () => IPersistenceStore, context?: IStoreContext): void;

package/dist/conformance/persistence.conformance.js

@@ -0,0 +1,56 @@
+import { describe, expect, it } from "vitest";
+import { randomUUID } from "node:crypto";
+/** Reuse on a direct backend or a PersistenceSlotStore with the same caller privileges. */
+export function describePersistenceStoreConformance(name, getStore, context = { subject: "conformance" }) {
+    describe(name, () => {
+        const namespace = "explorer";
+        const put = (id, key, expectedRevision = 0, payload = { saved: true }) => ({ namespace, id, kind: "checkpoint", schemaVersion: "1", payload, expectedRevision, references: [], idempotencyKey: key });
+        it("keeps immutable revisions and rejects a stale write", async () => {
+            const store = getStore(), id = randomUUID();
+            const first = await store.putAsync(put(id, randomUUID()), context);
+            await store.putAsync(put(id, randomUUID(), 1, { saved: false }), context);
+            expect((await store.getAsync({ namespace, id, revision: 1 }, context)).payload).toEqual(first.payload);
+            await expect(store.putAsync(put(id, randomUUID(), 1), context)).rejects.toMatchObject({ code: "revision_conflict" });
+        });
+        it("replays a mutation and rejects reuse with different content", async () => {
+            const store = getStore(), id = randomUUID(), request = put(id, randomUUID());
+            const result = await store.putAsync(request, context);
+            expect(await store.putAsync(request, context)).toEqual(result);
+            await expect(store.putAsync({ ...request, payload: { saved: false } }, context)).rejects.toMatchObject({ code: "idempotency_conflict" });
+            expect((await store.listRevisionsAsync({ namespace, id }, context)).items).toHaveLength(1);
+        });
+        it("serializes competing writes to the same revision", async () => {
+            const store = getStore(), id = randomUUID();
+            await store.putAsync(put(id, randomUUID()), context);
+            const results = await Promise.allSettled([store.putAsync(put(id, randomUUID(), 1), context), store.putAsync(put(id, randomUUID(), 1), context)]);
+            expect(results.filter(r => r.status === "fulfilled")).toHaveLength(1);
+            expect(results.filter(r => r.status === "rejected")).toHaveLength(1);
+        });
+        it("deletes logically while keeping pinned history", async () => {
+            const store = getStore(), id = randomUUID();
+            await store.putAsync(put(id, randomUUID()), context);
+            const deleted = await store.deleteAsync({ namespace, id, expectedRevision: 1, idempotencyKey: randomUUID() }, context);
+            expect(deleted.deleted).toBe(true);
+            await expect(store.getAsync({ namespace, id }, context)).rejects.toMatchObject({ code: "not_found" });
+            expect((await store.getAsync({ namespace, id, revision: 1 }, context)).revision).toBe(1);
+            await expect(store.putAsync(put(id, randomUUID()), context)).rejects.toMatchObject({ code: "revision_conflict" });
+        });
+        it("rejects a missing artifact reference transactionally", async () => {
+            const store = getStore(), id = randomUUID();
+            await expect(store.putAsync({ ...put(id, randomUUID()), references: [{ type: "artifact", namespace, id: randomUUID() }] }, context)).rejects.toMatchObject({ code: "not_found" });
+            await expect(store.getAsync({ namespace, id }, context)).rejects.toMatchObject({ code: "not_found" });
+        });
+        it("binds signed pagination to its filters", async () => {
+            const store = getStore();
+            for (let i = 0; i < 3; ++i)
+                await store.putAsync(put(randomUUID(), randomUUID()), context);
+            const page = await store.listAsync({ namespace, limit: 1 }, context);
+            expect(page.items).toHaveLength(1);
+            expect(page.nextCursor).toBeTruthy();
+            const next = await store.listAsync({ namespace, limit: 1, cursor: page.nextCursor }, context);
+            expect(next.items[0].id).not.toBe(page.items[0].id);
+            await expect(store.listAsync({ namespace, kind: "other", cursor: page.nextCursor }, context)).rejects.toMatchObject({ code: "invalid_request" });
+        });
+    });
+}
+//# sourceMappingURL=persistence.conformance.js.map

package/dist/conformance/persistence.conformance.js.map

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

package/dist/contract/errors.d.ts

@@ -0,0 +1,5 @@
+export type PersistenceErrorCode = "not_found" | "revision_conflict" | "idempotency_conflict" | "policy_denied" | "quota_exceeded" | "transfer_incomplete" | "integrity_error" | "invalid_request" | "unsupported_format" | "retention_blocked" | "busy" | "store_unavailable";
+export declare class PersistenceError extends Error {
+    readonly code: PersistenceErrorCode;
+    constructor(code: PersistenceErrorCode, message: string);
+}

package/dist/contract/errors.js

@@ -0,0 +1,9 @@
+export class PersistenceError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "PersistenceError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/contract/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/contract/errors.ts"],"names":[],"mappings":"AAMA,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IAClB;IAArB,YAAqB,IAA0B,EAAE,OAAe;QAC5D,KAAK,CAAC,OAAO,CAAC,CAAC;QADE,SAAI,GAAJ,IAAI,CAAsB;QAE3C,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACnC,CAAC;CACJ"}

package/dist/contract/persistence.protocol.d.ts

@@ -0,0 +1,83 @@
+/** Backend-independent wire contract. Generate contracts/persistence.v1.json from these definitions. */
+type Schema = Record<string, unknown>;
+export declare const PERSISTENCE_DEFINITIONS: Record<string, Schema>;
+export declare const PERSISTENCE_TOOL_DESCRIPTIONS: Record<string, string>;
+/** Plain MCP tools/list descriptors, including inputSchema and outputSchema. */
+export declare const PERSISTENCE_TOOLS: {
+    name: string;
+    description: string;
+    inputSchema: {
+        $defs: Record<string, Schema>;
+        type: string;
+        properties: Record<string, Schema>;
+        required: string[];
+        additionalProperties: boolean;
+    };
+    outputSchema: {
+        type: string;
+        anyOf: Schema[];
+        $defs: Record<string, Schema>;
+    };
+}[];
+export declare const PERSISTENCE_RESOURCE_TEMPLATES: {
+    uriTemplate: string;
+    name: string;
+    mimeType: string;
+}[];
+export declare const PERSISTENCE_PROTOCOL: {
+    contract: string;
+    revision: number;
+    tools: {
+        name: string;
+        description: string;
+        inputSchema: {
+            $defs: Record<string, Schema>;
+            type: string;
+            properties: Record<string, Schema>;
+            required: string[];
+            additionalProperties: boolean;
+        };
+        outputSchema: {
+            type: string;
+            anyOf: Schema[];
+            $defs: Record<string, Schema>;
+        };
+    }[];
+    resources: {
+        uri: string;
+        name: string;
+        mimeType: string;
+        description: string;
+    }[];
+    resourceTemplates: {
+        uriTemplate: string;
+        name: string;
+        mimeType: string;
+    }[];
+    transfer: {
+        authentication: string;
+        routes: ({
+            method: string;
+            path: string;
+            request: string;
+            success: number;
+            precondition: string;
+            response?: undefined;
+        } | {
+            method: string;
+            path: string;
+            response: string;
+            success: number;
+            precondition: string;
+            request?: undefined;
+        })[];
+        errors: {
+            400: string[];
+            403: string[];
+            404: string[];
+            413: string[];
+            500: string[];
+        };
+    };
+};
+export {};

package/dist/contract/persistence.protocol.js

@@ -0,0 +1,75 @@
+const string = { type: "string", minLength: 1, maxLength: 256 };
+const segment = { type: "string", pattern: "^[A-Za-z0-9_][A-Za-z0-9._-]{0,127}$", maxLength: 128 };
+const revision = { type: "integer", minimum: 1, maximum: Number.MAX_SAFE_INTEGER };
+const expectedRevision = { ...revision, minimum: 0 };
+const date = { type: "string", format: "date-time" };
+const key = { ...string, maxLength: 128 };
+const mimeType = { type: "string", maxLength: 128, pattern: "^[a-zA-Z0-9!#$&^_.+-]+/[a-zA-Z0-9!#$&^_.+-]+$" };
+const ref = (name) => ({ $ref: `#/$defs/${name}` });
+function object(properties, required = Object.keys(properties)) { return { type: "object", properties, required, additionalProperties: false }; }
+const location = { namespace: segment, id: segment };
+const page = { limit: { type: "integer", minimum: 1, maximum: 200 }, cursor: { type: "string", minLength: 1, maxLength: 4096 } };
+const finish = { namespace: segment, uploadId: segment, idempotencyKey: key };
+const errorCodes = ["not_found", "revision_conflict", "idempotency_conflict", "policy_denied", "quota_exceeded", "transfer_incomplete", "integrity_error", "invalid_request", "unsupported_format", "retention_blocked", "busy", "store_unavailable"];
+export const PERSISTENCE_DEFINITIONS = {
+    Json: { anyOf: [{ type: "null" }, { type: "boolean" }, { type: "number" }, { type: "string" }, { type: "array", items: ref("Json") }, { type: "object", additionalProperties: ref("Json") }] },
+    Reference: { oneOf: [object({ type: { const: "document" }, ...location, revision }), object({ type: { const: "artifact" }, ...location })] },
+    Hash: object({ algorithm: { const: "sha256" }, value: { type: "string", pattern: "^[a-f0-9]{64}$" } }),
+    Document: object({ ...location, kind: string, schemaVersion: string, revision, createdAt: date, updatedAt: date, deleted: { type: "boolean" }, payload: ref("Json"), references: { type: "array", maxItems: 256, items: ref("Reference") } }),
+    Artifact: object({ ...location, mimeType, size: { type: "integer", minimum: 0, maximum: Number.MAX_SAFE_INTEGER }, hash: ref("Hash"), createdAt: date, provenance: ref("Json") }),
+    Upload: object({ namespace: segment, artifactId: segment, uploadId: segment, expiresAt: date }),
+    DocumentPage: object({ items: { type: "array", maxItems: 200, items: ref("Document") }, nextCursor: page.cursor }, ["items"]),
+    Capabilities: object({ contract: { const: "persistence.v1" }, durability: { enum: ["file-sync", "file-and-directory-sync"] }, limits: object(Object.fromEntries(["maxDocumentBytes", "maxArtifactBytes", "maxReferences", "maxPageSize", "maxNamespaceBytes", "idempotencyRetentionSeconds"].map(k => [k, { type: "integer", minimum: 1 }]))) }),
+    Acknowledgement: object({ ok: { const: true } }),
+    Error: object({ error: object({ code: { enum: errorCodes }, message: { type: "string" } }) }),
+};
+export const PERSISTENCE_TOOL_DESCRIPTIONS = {
+    capabilities: "Read protocol limits and durability guarantees.",
+    get: "Read a document head or an immutable revision.", put: "Create or update with expectedRevision and an idempotency key.",
+    list: "List documents you may read, with bounded pagination.", listRevisions: "List immutable revisions of a document you may read.",
+    delete: "Add a tombstone; keep history and referenced files.", purge: "Permanently purge an unreferenced revision or artifact after retention.",
+    beginArtifact: "Reserve an upload. Transfer bytes over the authenticated HTTP endpoint.",
+    commitArtifact: "Verify and publish a completed upload atomically.", abortArtifact: "Abort an inactive upload.",
+    getArtifact: "Read artifact metadata; bytes use the authenticated HTTP endpoint.",
+    uploadAccess: "Authorize an upload stream and read its target metadata. Used by the transfer endpoint.",
+};
+const inputs = {
+    capabilities: { input: object({}), result: "Capabilities" },
+    get: { input: object({ ...location, revision }, ["namespace", "id"]), result: "Document" },
+    put: { input: object({ ...location, expectedRevision, kind: string, schemaVersion: string, payload: ref("Json"), references: { type: "array", maxItems: 256, items: ref("Reference") }, idempotencyKey: key }), result: "Document" },
+    list: { input: object({ namespace: segment, kind: string, includeDeleted: { type: "boolean" }, ...page }, ["namespace"]), result: "DocumentPage" },
+    listRevisions: { input: object({ ...location, ...page }, ["namespace", "id"]), result: "DocumentPage" },
+    delete: { input: object({ ...location, expectedRevision: revision, idempotencyKey: key }), result: "Document" },
+    purge: { input: object({ namespace: segment, target: { oneOf: [object({ type: { const: "document" }, id: segment, revision }), object({ type: { const: "artifact" }, id: segment })] }, idempotencyKey: key }), result: "Acknowledgement" },
+    beginArtifact: { input: object({ namespace: segment, mimeType, size: { type: "integer", minimum: 0, maximum: Number.MAX_SAFE_INTEGER }, hash: ref("Hash"), provenance: ref("Json"), idempotencyKey: key }), result: "Upload" },
+    commitArtifact: { input: object(finish), result: "Artifact" },
+    abortArtifact: { input: object(finish), result: "Acknowledgement" },
+    uploadAccess: { input: object({ namespace: segment, uploadId: segment }), result: "Upload" },
+    getArtifact: { input: object(location), result: "Artifact" },
+};
+/** Plain MCP tools/list descriptors, including inputSchema and outputSchema. */
+export const PERSISTENCE_TOOLS = Object.entries(inputs).map(([name, definition]) => ({
+    name: `persistence.${name}`, description: PERSISTENCE_TOOL_DESCRIPTIONS[name],
+    inputSchema: { ...definition.input, $defs: PERSISTENCE_DEFINITIONS },
+    outputSchema: { type: "object", anyOf: [ref(definition.result), ref("Error")], $defs: PERSISTENCE_DEFINITIONS },
+}));
+export const PERSISTENCE_RESOURCE_TEMPLATES = [
+    { uriTemplate: "persistence://documents/{namespace}/{id}", name: "Document head", mimeType: "application/json" },
+    { uriTemplate: "persistence://documents/{namespace}/{id}/revisions/{revision}", name: "Pinned document revision", mimeType: "application/json" },
+    { uriTemplate: "persistence://artifacts/{namespace}/{id}", name: "Artifact metadata", mimeType: "application/json" },
+];
+export const PERSISTENCE_PROTOCOL = {
+    contract: "persistence.v1", revision: 1,
+    tools: PERSISTENCE_TOOLS,
+    resources: [{ uri: "persistence://capabilities", name: "Persistence capabilities", mimeType: "application/json", description: PERSISTENCE_TOOL_DESCRIPTIONS.capabilities }],
+    resourceTemplates: PERSISTENCE_RESOURCE_TEMPLATES,
+    transfer: {
+        authentication: "The same bearer as the MCP client; every request is reauthorized through the broker. No reusable bearer URLs.",
+        routes: [
+            { method: "PUT", path: "/uploads/{namespace}/{uploadId}", request: "application/octet-stream raw bytes", success: 204, precondition: "beginArtifact; uploadAccess authorization" },
+            { method: "GET", path: "/artifacts/{namespace}/{id}", response: "raw bytes with stored MIME type and Content-Length", success: 200, precondition: "committed artifact; getArtifact authorization" },
+        ],
+        errors: { 400: ["invalid_request", "transfer_incomplete", "integrity_error"], 403: ["policy_denied"], 404: ["not_found"], 413: ["quota_exceeded"], 500: ["store_unavailable", "busy"] },
+    },
+};
+//# sourceMappingURL=persistence.protocol.js.map

package/dist/contract/persistence.protocol.js.map

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

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

@@ -0,0 +1,29 @@
+import type { IArtifact, IBeginArtifact, IDeleteDocument, IDocument, IDocumentKey, IFinishArtifact, IListDocuments, IPage, IPageRequest, IPersistenceCapabilities, IPurge, IPutDocument, IStoreContext, IUpload } from "./persistence.types.js";
+/** Trusted backend contract, following the direct-store/remote-slot pattern of mcp-vault. */
+export interface IPersistenceStore {
+    readonly id: string;
+    getCapabilitiesAsync(signal?: AbortSignal): Promise<IPersistenceCapabilities>;
+    getAsync(request: IDocumentKey & {
+        revision?: number;
+    }, context: IStoreContext): Promise<IDocument>;
+    putAsync(request: IPutDocument, context: IStoreContext): Promise<IDocument>;
+    listAsync(request: IListDocuments, context: IStoreContext): Promise<IPage<IDocument>>;
+    listRevisionsAsync(request: IDocumentKey & IPageRequest, context: IStoreContext): Promise<IPage<IDocument>>;
+    /** Adds a tombstone; does not purge history or files. */
+    deleteAsync(request: IDeleteDocument, context: IStoreContext): Promise<IDocument>;
+    beginArtifactAsync(request: IBeginArtifact, context: IStoreContext): Promise<IUpload>;
+    inspectUploadAsync(namespace: string, uploadId: string, context: IStoreContext): Promise<IUpload>;
+    /** Stream bytes internally. The public endpoint must authenticate and authorize separately. */
+    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>;
+    getArtifactAsync(request: IDocumentKey, context: IStoreContext): Promise<IArtifact>;
+    readArtifactAsync(request: IDocumentKey, context: IStoreContext): Promise<AsyncIterable<Uint8Array>>;
+    /** Physical purge, subject to retention and incoming-reference checks. */
+    purgeAsync(request: IPurge, context: IStoreContext): Promise<void>;
+    closeAsync(): Promise<void>;
+}

package/dist/contract/persistence.store.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=persistence.store.js.map

package/dist/contract/persistence.store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.store.js","sourceRoot":"","sources":["../../src/contract/persistence.store.ts"],"names":[],"mappings":""}

package/dist/contract/persistence.types.d.ts

@@ -0,0 +1,115 @@
+/** persistence.v1 documents and immutable artifacts. */
+export type Json = null | boolean | number | string | Json[] | {
+    [key: string]: Json;
+};
+export interface IDocumentKey {
+    namespace: string;
+    id: string;
+}
+export interface IDocumentReference extends IDocumentKey {
+    type: "document";
+    revision: number;
+}
+export interface IArtifactReference {
+    type: "artifact";
+    namespace: string;
+    id: string;
+}
+export interface IDocument extends IDocumentKey {
+    kind: string;
+    schemaVersion: string;
+    revision: number;
+    createdAt: string;
+    updatedAt: string;
+    deleted: boolean;
+    payload: Json;
+    references: readonly (IDocumentReference | IArtifactReference)[];
+}
+export interface IMutation {
+    idempotencyKey: string;
+}
+export interface IPutDocument extends IDocumentKey, IMutation {
+    /** Zero creates only; otherwise must equal the current revision, including a tombstone. */
+    expectedRevision: number;
+    kind: string;
+    schemaVersion: string;
+    payload: Json;
+    references: readonly (IDocumentReference | IArtifactReference)[];
+}
+export interface IPageRequest {
+    limit?: number;
+    cursor?: string;
+}
+export interface IPage<T> {
+    items: readonly T[];
+    nextCursor?: string;
+}
+export interface IListDocuments extends IPageRequest {
+    namespace: string;
+    kind?: string;
+    includeDeleted?: boolean;
+}
+export interface IDeleteDocument extends IDocumentKey, IMutation {
+    expectedRevision: number;
+}
+export interface IArtifact {
+    namespace: string;
+    id: string;
+    mimeType: string;
+    size: number;
+    hash: {
+        algorithm: "sha256";
+        value: string;
+    };
+    createdAt: string;
+    provenance: Json;
+}
+export interface IBeginArtifact extends IMutation {
+    namespace: string;
+    mimeType: string;
+    size: number;
+    hash: {
+        algorithm: "sha256";
+        value: string;
+    };
+    provenance: Json;
+}
+/** No physical path or reusable bearer ticket in persisted/replayed store results. */
+export interface IUpload {
+    namespace: string;
+    artifactId: string;
+    uploadId: string;
+    expiresAt: string;
+}
+export interface IFinishArtifact extends IMutation {
+    namespace: string;
+    uploadId: string;
+}
+export interface IPurge extends IMutation {
+    namespace: string;
+    target: {
+        type: "document";
+        id: string;
+        revision: number;
+    } | {
+        type: "artifact";
+        id: string;
+    };
+}
+/** Internal trusted context, supplied by middleware; never accepted from tool arguments. */
+export interface IStoreContext {
+    readonly subject: string;
+    readonly signal?: AbortSignal;
+}
+export interface IPersistenceCapabilities {
+    contract: "persistence.v1";
+    durability: "file-sync" | "file-and-directory-sync";
+    limits: {
+        maxDocumentBytes: number;
+        maxArtifactBytes: number;
+        maxReferences: number;
+        maxPageSize: number;
+        maxNamespaceBytes: number;
+        idempotencyRetentionSeconds: number;
+    };
+}

package/dist/contract/persistence.types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=persistence.types.js.map

package/dist/contract/persistence.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"persistence.types.js","sourceRoot":"","sources":["../../src/contract/persistence.types.ts"],"names":[],"mappings":""}

package/dist/contract/validation.d.ts

@@ -0,0 +1,7 @@
+import { PersistenceError } from "./errors.js";
+export declare function fail(code: ConstructorParameters<typeof PersistenceError>[0], message: string): never;
+export declare function segment(value: unknown): string;
+export declare function integer(value: unknown, min?: number, max?: number): number;
+export declare function text(value: unknown, max?: number): string;
+export declare function canonical(value: unknown): string;
+export declare function digest(value: unknown): string;

package/dist/contract/validation.js

@@ -0,0 +1,43 @@
+import { createHash } from "node:crypto";
+import { PersistenceError } from "./errors.js";
+export function fail(code, message) {
+    throw new PersistenceError(code, message);
+}
+export function segment(value) {
+    if (typeof value !== "string" || !/^[A-Za-z0-9_][A-Za-z0-9._-]{0,127}$/.test(value))
+        fail("invalid_request", "Invalid resource segment");
+    return value;
+}
+export function integer(value, min = 0, max = Number.MAX_SAFE_INTEGER) {
+    if (typeof value !== "number" || !Number.isSafeInteger(value) || value < min || value > max)
+        fail("invalid_request", "Invalid integer");
+    return value;
+}
+export function text(value, max = 256) {
+    if (typeof value !== "string" || !value.length || value.length > max)
+        fail("invalid_request", "Invalid string");
+    return value;
+}
+export function canonical(value) {
+    let nodes = 0;
+    const seen = new Set();
+    function visit(v, depth) {
+        if (++nodes > 100_000 || depth > 64)
+            fail("invalid_request", "JSON is too complex");
+        if (v === null || typeof v === "boolean" || typeof v === "string")
+            return v;
+        if (typeof v === "number" && Number.isFinite(v))
+            return v;
+        if (typeof v !== "object" || seen.has(v))
+            fail("invalid_request", "Expected finite, acyclic JSON");
+        if (!Array.isArray(v) && Object.getPrototypeOf(v) !== Object.prototype && Object.getPrototypeOf(v) !== null)
+            fail("invalid_request", "Expected plain JSON");
+        seen.add(v);
+        const out = Array.isArray(v) ? v.map(x => visit(x, depth + 1)) : Object.fromEntries(Object.keys(v).sort().map(k => [k, visit(v[k], depth + 1)]));
+        seen.delete(v);
+        return out;
+    }
+    return JSON.stringify(visit(value, 0));
+}
+export function digest(value) { return createHash("sha256").update(canonical(value)).digest("hex"); }
+//# sourceMappingURL=validation.js.map

package/dist/contract/validation.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export * from "./contract/persistence.types.js";
+export * from "./contract/persistence.store.js";
+export * from "./contract/errors.js";
+export * from "./contract/persistence.protocol.js";
+export * from "./sqlite/sqlite.persistence.store.js";
+export * from "./server/declaration.js";
+export * from "./server/persistence.behavior.js";
+export * from "./server/persistence.slot.store.js";
+export * from "./provider/artifact.http.js";

package/dist/index.js

@@ -0,0 +1,10 @@
+export * from "./contract/persistence.types.js";
+export * from "./contract/persistence.store.js";
+export * from "./contract/errors.js";
+export * from "./contract/persistence.protocol.js";
+export * from "./sqlite/sqlite.persistence.store.js";
+export * from "./server/declaration.js";
+export * from "./server/persistence.behavior.js";
+export * from "./server/persistence.slot.store.js";
+export * from "./provider/artifact.http.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,cAAc,iCAAiC,CAAC;AAChD,cAAc,iCAAiC,CAAC;AAChD,cAAc,sBAAsB,CAAC;AACrC,cAAc,oCAAoC,CAAC;AACnD,cAAc,sCAAsC,CAAC;AACrD,cAAc,yBAAyB,CAAC;AACxC,cAAc,kCAAkC,CAAC;AACjD,cAAc,oCAAoC,CAAC;AACnD,cAAc,6BAA6B,CAAC"}

package/dist/provider/artifact.http.d.ts

@@ -0,0 +1,8 @@
+import { type Server } from "node:http";
+import type { IPersistenceStore } from "../contract/persistence.store.js";
+/** Every stream is authorized by a fresh MCP call made with the HTTP caller's bearer. */
+export declare function createArtifactTransferServer(options: {
+    store: IPersistenceStore;
+    brokerMcpUrl: string;
+    dev?: boolean;
+}): Server;

package/dist/provider/artifact.http.js

@@ -0,0 +1,69 @@
+import { createServer } from "node:http";
+import { Readable } from "node:stream";
+import { pipeline } from "node:stream/promises";
+import { McpClient } from "@cyanmycelium/mcp-core";
+import { StreamableHttpTransport } from "@cyanmycelium/mcp-core/node";
+import { PersistenceError } from "../contract/errors.js";
+import { segment } from "../contract/validation.js";
+import { MCP_STORE_CONTEXT } from "../server/persistence.behavior.js";
+import { slotPayload } from "../server/persistence.slot.store.js";
+/** Every stream is authorized by a fresh MCP call made with the HTTP caller's bearer. */
+export function createArtifactTransferServer(options) {
+    const server = createServer(async (request, response) => {
+        const controller = new AbortController();
+        request.once("aborted", () => controller.abort());
+        response.once("close", () => { if (!response.writableFinished)
+            controller.abort(); });
+        let client;
+        try {
+            const path = new URL(request.url ?? "/", "http://localhost").pathname;
+            const match = /^\/(uploads|artifacts)\/([^/]+)\/([^/]+)$/.exec(path);
+            if (!match || !((match[1] === "uploads" && request.method === "PUT") || (match[1] === "artifacts" && request.method === "GET"))) {
+                response.writeHead(404).end();
+                return;
+            }
+            const namespace = segment(match[2]), id = segment(match[3]);
+            const auth = request.headers.authorization;
+            if (!options.dev && (!auth || !/^Bearer [^\s]+$/i.test(auth)))
+                throw new PersistenceError("policy_denied", "Bearer authorization required");
+            client = new McpClient({ name: "persistence-transfer", version: "0.1.0" }, new StreamableHttpTransport(options.brokerMcpUrl, { headers: auth ? { Authorization: auth } : {} }), 15_000);
+            let permission;
+            try {
+                await client.connect();
+                permission = slotPayload(await client.callTool(match[1] === "uploads" ? "persistence.uploadAccess" : "persistence.getArtifact", { namespace, ...(match[1] === "uploads" ? { uploadId: id } : { id }) }));
+            }
+            catch (error) {
+                if (error instanceof PersistenceError)
+                    throw error;
+                throw new PersistenceError("policy_denied", "Broker did not authorize transfer");
+            }
+            const context = { ...MCP_STORE_CONTEXT, signal: controller.signal };
+            if (match[1] === "uploads") {
+                await options.store.writeArtifactAsync({ namespace, uploadId: id, bytes: request }, context);
+                response.writeHead(204).end();
+            }
+            else {
+                const metadata = permission;
+                const bytes = await options.store.readArtifactAsync({ namespace, id }, context);
+                response.writeHead(200, { "Content-Type": metadata.mimeType, "Content-Length": metadata.size, "Cache-Control": "no-store", "X-Content-Type-Options": "nosniff" });
+                await pipeline(Readable.from(bytes), response, { signal: controller.signal });
+            }
+        }
+        catch (error) {
+            if (response.headersSent)
+                response.destroy();
+            else {
+                const code = error instanceof PersistenceError ? error.code : "store_unavailable";
+                const status = code === "policy_denied" ? 403 : code === "not_found" ? 404 : code === "quota_exceeded" ? 413 : ["invalid_request", "transfer_incomplete", "integrity_error"].includes(code) ? 400 : 500;
+                response.writeHead(status, { "Content-Type": "application/json", "Cache-Control": "no-store" }).end(JSON.stringify({ error: { code, message: "Artifact transfer refused or failed" } }));
+            }
+        }
+        finally {
+            client?.disconnect();
+        }
+    });
+    server.requestTimeout = 30 * 60_000;
+    server.headersTimeout = 15_000;
+    return server;
+}
+//# sourceMappingURL=artifact.http.js.map

package/dist/provider/artifact.http.js.map

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

package/dist/provider/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};