@graview/core 0.1.20 → 0.1.22

package/dist/sync/index.d.ts

@@ -0,0 +1,11 @@
+export { googleCalendar, googleCalendarMapping } from "./google-calendar.js";
+export type { Fetcher, GoogleCalendarOptions } from "./google-calendar.js";
+export { syncConflictInvariant, SYNC_CONFLICTS } from "./conflict.js";
+export type { SyncConflictOptions } from "./conflict.js";
+export { SyncEngine } from "./engine.js";
+export type { SettledConflict, SyncOptions, SyncReport } from "./engine.js";
+export { allowTools, doorClient, mcpClient, mcpDoor, mcpRemote, ownHost, sameOrigin } from "./mcp.js";
+export type { DoorHeaders, DoorRequest, DoorResponse, McpClientOptions, McpDoorOptions, McpRemoteOptions, ToolCall } from "./mcp.js";
+export { EMPTY_SYNC_STATE, systemAuthor } from "./types.js";
+export type { ConflictPolicy, RemoteAck, RemoteChange, RemoteLink, RemoteSystem, RemoteWrite, ResourceMapping, SyncConflict, SyncMapping, SyncState, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AASA,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,YAAY,EAAE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC3E,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACtE,YAAY,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,YAAY,EAAE,eAAe,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtG,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,gBAAgB,EAAE,cAAc,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AACrI,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC5D,YAAY,EACV,cAAc,EACd,SAAS,EACT,YAAY,EACZ,UAAU,EACV,YAAY,EACZ,WAAW,EACX,eAAe,EACf,YAAY,EACZ,WAAW,EACX,SAAS,GACV,MAAM,YAAY,CAAC"}

package/dist/sync/index.js

@@ -0,0 +1,15 @@
+/*
+ * `@graview/core/sync` — two-way sync on the op log: the engine, its
+ * mappings, the conflict invariant, and the transports (Google Calendar, a
+ * tool server over MCP).
+ *
+ * An entry of its own, not part of `@graview/core`: a hosted page imports the
+ * main entry up front and draws without ever syncing, so the engine and its
+ * transports are reached only by a host that runs one.
+ */
+export { googleCalendar, googleCalendarMapping } from "./google-calendar.js";
+export { syncConflictInvariant, SYNC_CONFLICTS } from "./conflict.js";
+export { SyncEngine } from "./engine.js";
+export { allowTools, doorClient, mcpClient, mcpDoor, mcpRemote, ownHost, sameOrigin } from "./mcp.js";
+export { EMPTY_SYNC_STATE, systemAuthor } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/sync/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/sync/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAAE,cAAc,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAE7E,OAAO,EAAE,qBAAqB,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAEtE,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAEtG,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/sync/mcp.d.ts

@@ -0,0 +1,124 @@
+import type { RemoteChange, RemoteSystem, RemoteWrite } from "./types.js";
+/**
+ * A REMOTE THAT SPEAKS MCP — the tools another system already serves, called
+ * by name, as the sync's transport.
+ *
+ * Three pieces, each usable alone. `mcpClient` calls a streamable-HTTP MCP
+ * endpoint (a session, JSON or an event stream back, one retry when the
+ * server forgot the session) and only the tools it was allowed. `mcpDoor` is
+ * the narrow way a page reaches it: a server route that holds the token,
+ * answers only its own origin's JSON, and passes only the allowed tools —
+ * and `doorClient` is the page's side of it. `mcpRemote` turns calls into a
+ * `RemoteSystem` the engine runs.
+ *
+ * Nothing here imports a `node:` builtin: the client runs in Node or a page,
+ * and the door takes any request and response shaped like Node's.
+ */
+/** Calls one tool by name and resolves to what it answered: its text, parsed as JSON when it is JSON. */
+export type ToolCall = (name: string, args: Record<string, unknown>) => Promise<unknown>;
+type Fetch = (input: string, init?: RequestInit) => Promise<Response>;
+/**
+ * THE TOOLS A SYNC MAY CALL, and the sentence for one it may not. A sync
+ * needs a handful of a server's tools; every other one stays out of reach,
+ * whoever asks.
+ */
+export declare function allowTools(names: Iterable<string>): (name: string) => string | undefined;
+export interface McpClientOptions {
+    /** The server's MCP endpoint. */
+    readonly url: string;
+    /** The tools this client may call; any other is refused before it is sent. */
+    readonly allow: Iterable<string>;
+    /** Headers each request carries — a token read when it is needed, never handed to a page. */
+    readonly headers?: () => Record<string, string> | Promise<Record<string, string>>;
+    readonly fetch?: Fetch;
+    /** Who is calling, as `initialize` says it. */
+    readonly clientInfo?: {
+        readonly name: string;
+        readonly version: string;
+    };
+}
+/** Calls an MCP server's tools over streamable HTTP. */
+export declare function mcpClient(options: McpClientOptions): ToolCall;
+/** The headers a door reads, as Node's `IncomingMessage` has them. */
+export type DoorHeaders = Readonly<Record<string, string | readonly string[] | undefined>>;
+/**
+ * WHETHER A HOST IS THIS MACHINE AS A PAGE NAMES IT: `localhost`, a
+ * `*.localhost` name or an IP address — or one of `hosts`, the names the
+ * server was told it answers to. A page on a name of its own that it
+ * rebinds to this machine sends its own name as the Host, and the browser
+ * agrees with it about the origin; the name is what gives it away.
+ */
+export declare function ownHost(host: string | undefined, hosts?: Iterable<string>): boolean;
+/**
+ * WHETHER A REQUEST CAME FROM THIS SERVER'S OWN PAGES: no `Sec-Fetch-Site`
+ * other than same-origin (or none, for curl), an `Origin`, when there is
+ * one, naming this host, and a host that is this machine (`ownHost`). A page
+ * on another origin can fire a request at a local server; it cannot make the
+ * browser say it came from here. Every door answers this the same way: the
+ * dev server's doors (`@graview/ship/dev`) ask this too.
+ */
+export declare function sameOrigin(headers: DoorHeaders, hosts?: Iterable<string>): boolean;
+/** A request and a response, as Node's `http` (and Vite's and Connect's middleware) hands them. */
+export interface DoorRequest {
+    readonly method?: string;
+    readonly url?: string;
+    readonly headers: DoorHeaders;
+    on(event: "data", listener: (chunk: unknown) => void): unknown;
+    on(event: "end", listener: () => void): unknown;
+}
+export interface DoorResponse {
+    statusCode: number;
+    setHeader(name: string, value: string): unknown;
+    end(body: string): unknown;
+}
+export interface McpDoorOptions {
+    /** Where the door answers. Default `/graview/mcp`. */
+    readonly path?: string;
+    /** What reaches the server — usually an `mcpClient` holding the token. */
+    readonly call: ToolCall;
+    /** The tools a page may ask for through the door. */
+    readonly allow: Iterable<string>;
+    /** Host names the server answers to besides this machine's own (`ownHost`). */
+    readonly hosts?: Iterable<string>;
+    /** The most a request may send, in bytes. Default 1 MB. */
+    readonly limit?: number;
+}
+/**
+ * THE DOOR A PAGE REACHES A TOOL SERVER THROUGH, as server middleware.
+ *
+ * The page never holds the token and never names the endpoint: it posts
+ * `{ name, arguments }` here and gets `{ ok, result | error }` back. What
+ * passes is as narrow as the sync needs — a POST, `application/json`, from
+ * this server's own origin, naming an allowed tool — and every refusal says
+ * which of those it was.
+ */
+export declare function mcpDoor(options: McpDoorOptions): (request: DoorRequest, response: DoorResponse, next: () => void) => void;
+/** The page's side of an `mcpDoor`: the same calls, posted to the door on this page's own origin. */
+export declare function doorClient(options?: {
+    readonly path?: string;
+    readonly base?: string;
+    readonly fetch?: Fetch;
+}): ToolCall;
+export interface McpRemoteOptions {
+    /** Names the remote. */
+    readonly name: string;
+    /** How a call reaches the tools: `mcpClient` in Node, `doorClient` in a page. */
+    readonly call: ToolCall;
+    /** Everything that changed since `cursor`, read with the tools. */
+    pull(call: ToolCall, cursor?: string): Promise<{
+        readonly changes: readonly RemoteChange[];
+        readonly cursor: string;
+    }>;
+    /**
+     * One write, made with the tools, and the version it produced. Whatever it
+     * throws is that write's refusal, in its own words; the rest still go.
+     */
+    push(call: ToolCall, write: RemoteWrite): Promise<{
+        readonly id: string;
+        readonly version: string;
+    }>;
+}
+/** A `RemoteSystem` over a tool server: one write at a time, each refused alone. */
+export declare function mcpRemote(options: McpRemoteOptions): RemoteSystem;
+export {};
+//# sourceMappingURL=mcp.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/sync/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAa,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAErF;;;;;;;;;;;;;;GAcG;AAEH,yGAAyG;AACzG,MAAM,MAAM,QAAQ,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAEzF,KAAK,KAAK,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEtE;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAIxF;AAED,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,8EAA8E;IAC9E,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC,6FAA6F;IAC7F,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC;IAClF,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAC;IACvB,+CAA+C;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAAE;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3E;AAqBD,wDAAwD;AACxD,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,QAAQ,CAiE7D;AAED,sEAAsE;AACtE,MAAM,MAAM,WAAW,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC,CAAC;AAE3F;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,EAAE,KAAK,GAAE,QAAQ,CAAC,MAAM,CAAM,GAAG,OAAO,CAWvF;AAED;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,EAAE,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,GAAG,OAAO,CAYlF;AAED,mGAAmG;AACnG,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,WAAW,CAAC;IAC9B,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,GAAG,OAAO,CAAC;IAC/D,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC;CACjD;AACD,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC;IAChD,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,cAAc;IAC7B,sDAAsD;IACtD,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,qDAAqD;IACrD,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC,+EAA+E;IAC/E,QAAQ,CAAC,KAAK,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,CAAC;IAClC,2DAA2D;IAC3D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;;;;;;GAQG;AACH,wBAAgB,OAAO,CAAC,OAAO,EAAE,cAAc,GAAG,CAAC,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,IAAI,KAAK,IAAI,CAuDzH;AAED,qGAAqG;AACrG,wBAAgB,UAAU,CAAC,OAAO,GAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,KAAK,CAAA;CAAO,GAAG,QAAQ,CAa7H;AAED,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IACxB,mEAAmE;IACnE,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,OAAO,EAAE,SAAS,YAAY,EAAE,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvH;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;QAAE,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtG;AAED,oFAAoF;AACpF,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,YAAY,CAgBjE"}

package/dist/sync/mcp.js

@@ -0,0 +1,247 @@
+/**
+ * THE TOOLS A SYNC MAY CALL, and the sentence for one it may not. A sync
+ * needs a handful of a server's tools; every other one stays out of reach,
+ * whoever asks.
+ */
+export function allowTools(names) {
+    const allowed = [...new Set(names)];
+    return (name) => allowed.includes(name) ? undefined : `${name} is not a tool this sync uses (it uses ${allowed.join(", ")}).`;
+}
+/** A JSON-RPC answer, from a JSON body or the last `data:` line of an event stream. */
+async function readAnswer(response) {
+    const text = await response.text();
+    if (response.headers.get("content-type")?.includes("text/event-stream")) {
+        const data = text
+            .split("\n")
+            .filter((line) => line.startsWith("data:"))
+            .map((line) => line.slice(5).trim())
+            .filter(Boolean);
+        return data.length > 0 ? JSON.parse(data[data.length - 1]) : {};
+    }
+    return text ? JSON.parse(text) : {};
+}
+/** Calls an MCP server's tools over streamable HTTP. */
+export function mcpClient(options) {
+    const send = options.fetch ?? ((input, init) => fetch(input, init));
+    const refuse = allowTools(options.allow);
+    let session;
+    let opening;
+    let id = 0;
+    const headers = async (extra = {}) => ({
+        "content-type": "application/json",
+        accept: "application/json, text/event-stream",
+        ...(await options.headers?.()),
+        ...(session ? { "mcp-session-id": session } : {}),
+        ...extra,
+    });
+    const open = async () => {
+        const init = await send(options.url, {
+            method: "POST",
+            headers: await headers(),
+            body: JSON.stringify({
+                jsonrpc: "2.0",
+                id: ++id,
+                method: "initialize",
+                params: { protocolVersion: "2024-11-05", capabilities: {}, clientInfo: options.clientInfo ?? { name: "graview-sync", version: "1" } },
+            }),
+        });
+        if (!init.ok)
+            throw new Error(`The MCP server answered ${init.status} when the sync introduced itself.`);
+        const opened = init.headers.get("mcp-session-id") ?? undefined;
+        await init.text();
+        await send(options.url, {
+            method: "POST",
+            headers: await headers(opened ? { "mcp-session-id": opened } : {}),
+            body: JSON.stringify({ jsonrpc: "2.0", method: "notifications/initialized" }),
+        });
+        return opened;
+    };
+    const call = async (name, args, retry) => {
+        const refusal = refuse(name);
+        if (refusal)
+            throw new Error(refusal);
+        if (session === undefined)
+            session = await (opening ??= open().finally(() => (opening = undefined)));
+        const response = await send(options.url, {
+            method: "POST",
+            headers: await headers(),
+            body: JSON.stringify({ jsonrpc: "2.0", id: ++id, method: "tools/call", params: { name, arguments: args } }),
+        });
+        if ((response.status === 404 || response.status === 400) && retry && session !== undefined) {
+            // The server restarted and forgot the session: open another, once.
+            session = undefined;
+            await response.text();
+            return call(name, args, false);
+        }
+        if (!response.ok)
+            throw new Error(`The MCP server answered ${response.status} to ${name}.`);
+        const answer = await readAnswer(response);
+        if (answer.error)
+            throw new Error(answer.error.message ?? `The MCP server refused ${name}.`);
+        const text = answer.result?.content?.find((part) => part.type === "text")?.text ?? "";
+        if (answer.result?.isError)
+            throw new Error(text || `${name} failed.`);
+        try {
+            return JSON.parse(text);
+        }
+        catch {
+            return text;
+        }
+    };
+    return (name, args) => call(name, args, true);
+}
+/**
+ * WHETHER A HOST IS THIS MACHINE AS A PAGE NAMES IT: `localhost`, a
+ * `*.localhost` name or an IP address — or one of `hosts`, the names the
+ * server was told it answers to. A page on a name of its own that it
+ * rebinds to this machine sends its own name as the Host, and the browser
+ * agrees with it about the origin; the name is what gives it away.
+ */
+export function ownHost(host, hosts = []) {
+    if (host === undefined)
+        return true;
+    let name;
+    try {
+        name = new URL(`http://${host}`).hostname.toLowerCase();
+    }
+    catch {
+        return false;
+    }
+    if (name === "localhost" || name.endsWith(".localhost") || /^\d{1,3}(\.\d{1,3}){3}$/.test(name) || name.startsWith("["))
+        return true;
+    for (const allowed of hosts)
+        if (allowed.toLowerCase() === name)
+            return true;
+    return false;
+}
+/**
+ * WHETHER A REQUEST CAME FROM THIS SERVER'S OWN PAGES: no `Sec-Fetch-Site`
+ * other than same-origin (or none, for curl), an `Origin`, when there is
+ * one, naming this host, and a host that is this machine (`ownHost`). A page
+ * on another origin can fire a request at a local server; it cannot make the
+ * browser say it came from here. Every door answers this the same way: the
+ * dev server's doors (`@graview/ship/dev`) ask this too.
+ */
+export function sameOrigin(headers, hosts) {
+    const site = headers["sec-fetch-site"];
+    if (typeof site === "string" && site !== "same-origin" && site !== "none")
+        return false;
+    const host = headers["host"];
+    if (!ownHost(typeof host === "string" ? host : undefined, hosts))
+        return false;
+    const origin = headers["origin"];
+    if (typeof origin !== "string")
+        return true;
+    try {
+        return new URL(origin).host === host;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * THE DOOR A PAGE REACHES A TOOL SERVER THROUGH, as server middleware.
+ *
+ * The page never holds the token and never names the endpoint: it posts
+ * `{ name, arguments }` here and gets `{ ok, result | error }` back. What
+ * passes is as narrow as the sync needs — a POST, `application/json`, from
+ * this server's own origin, naming an allowed tool — and every refusal says
+ * which of those it was.
+ */
+export function mcpDoor(options) {
+    const path = options.path ?? "/graview/mcp";
+    const refuse = allowTools(options.allow);
+    const hosts = options.hosts ? [...options.hosts] : undefined;
+    const limit = options.limit ?? 1_000_000;
+    const answer = (response, status, body) => {
+        response.statusCode = status;
+        response.setHeader("content-type", "application/json");
+        response.end(JSON.stringify(body));
+    };
+    return (request, response, next) => {
+        if ((request.url ?? "").split("?")[0] !== path)
+            return next();
+        if (request.method !== "POST")
+            return answer(response, 405, { ok: false, error: "Refused: the door takes a POST." });
+        if (!sameOrigin(request.headers, hosts))
+            return answer(response, 403, { ok: false, error: "Refused: not from this page's own origin." });
+        const type = request.headers["content-type"];
+        // The media type itself: one a page on another site may send unasked (`text/plain; x=application/json`) is not JSON.
+        if (typeof type !== "string" || type.split(";")[0].trim().toLowerCase() !== "application/json") {
+            return answer(response, 415, { ok: false, error: "Refused: send application/json." });
+        }
+        const decoder = new TextDecoder();
+        let text = "";
+        let size = 0;
+        let over = false;
+        request.on("data", (chunk) => {
+            if (over)
+                return;
+            const bytes = typeof chunk === "string" ? new TextEncoder().encode(chunk) : chunk;
+            size += bytes.byteLength;
+            if (size > limit) {
+                over = true;
+                return answer(response, 413, { ok: false, error: `Refused: more than ${limit} bytes.` });
+            }
+            text += decoder.decode(bytes, { stream: true });
+        });
+        request.on("end", () => {
+            if (over)
+                return;
+            text += decoder.decode();
+            void (async () => {
+                let asked;
+                try {
+                    asked = JSON.parse(text || "{}");
+                }
+                catch {
+                    return answer(response, 400, { ok: false, error: "Refused: the body is not JSON." });
+                }
+                if (typeof asked.name !== "string")
+                    return answer(response, 400, { ok: false, error: "Refused: name the tool." });
+                const refusal = refuse(asked.name);
+                if (refusal)
+                    return answer(response, 403, { ok: false, error: `Refused: ${refusal}` });
+                try {
+                    const args = asked.arguments && typeof asked.arguments === "object" ? asked.arguments : {};
+                    answer(response, 200, { ok: true, result: await options.call(asked.name, args) });
+                }
+                catch (error) {
+                    answer(response, 200, { ok: false, error: error instanceof Error ? error.message : String(error) });
+                }
+            })();
+        });
+    };
+}
+/** The page's side of an `mcpDoor`: the same calls, posted to the door on this page's own origin. */
+export function doorClient(options = {}) {
+    const send = options.fetch ?? ((input, init) => fetch(input, init));
+    const at = `${options.base ?? ""}${options.path ?? "/graview/mcp"}`;
+    return async (name, args) => {
+        const response = await send(at, { method: "POST", headers: { "content-type": "application/json" }, body: JSON.stringify({ name, arguments: args }) });
+        const body = (await response.json().catch(() => ({ ok: false, error: `The door answered ${response.status}.` })));
+        if (!body.ok)
+            throw new Error(body.error ?? `The door refused ${name}.`);
+        return body.result;
+    };
+}
+/** A `RemoteSystem` over a tool server: one write at a time, each refused alone. */
+export function mcpRemote(options) {
+    return {
+        name: options.name,
+        pull: (cursor) => options.pull(options.call, cursor),
+        async push(writes) {
+            const acks = [];
+            for (const write of writes) {
+                try {
+                    acks.push({ localId: write.localId, ...(await options.push(options.call, write)) });
+                }
+                catch (error) {
+                    acks.push({ localId: write.localId, id: write.id ?? "", version: "", error: error instanceof Error ? error.message : String(error) });
+                }
+            }
+            return acks;
+        },
+    };
+}
+//# sourceMappingURL=mcp.js.map

package/dist/sync/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/sync/mcp.ts"],"names":[],"mappings":"AAuBA;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,KAAuB;IAChD,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;IACpC,OAAO,CAAC,IAAI,EAAE,EAAE,CACd,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,0CAA0C,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjH,CAAC;AAmBD,uFAAuF;AACvF,KAAK,UAAU,UAAU,CAAC,QAAkB;IAC1C,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IACnC,IAAI,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,EAAE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;QACxE,MAAM,IAAI,GAAG,IAAI;aACd,KAAK,CAAC,IAAI,CAAC;aACX,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;aAC1C,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;aACnC,MAAM,CAAC,OAAO,CAAC,CAAC;QACnB,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAE,CAAe,CAAC,CAAC,CAAC,EAAE,CAAC;IAClF,CAAC;IACD,OAAO,IAAI,CAAC,CAAC,CAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAe,CAAC,CAAC,CAAC,EAAE,CAAC;AACrD,CAAC;AAED,wDAAwD;AACxD,MAAM,UAAU,SAAS,CAAC,OAAyB;IACjD,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;IACpE,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,OAA2B,CAAC;IAChC,IAAI,OAAgD,CAAC;IACrD,IAAI,EAAE,GAAG,CAAC,CAAC;IAEX,MAAM,OAAO,GAAG,KAAK,EAAE,QAAgC,EAAE,EAAmC,EAAE,CAAC,CAAC;QAC9F,cAAc,EAAE,kBAAkB;QAClC,MAAM,EAAE,qCAAqC;QAC7C,GAAG,CAAC,MAAM,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAC9B,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,GAAG,KAAK;KACT,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,KAAK,IAAiC,EAAE;QACnD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;YACnC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,MAAM,OAAO,EAAE;YACxB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;gBACnB,OAAO,EAAE,KAAK;gBACd,EAAE,EAAE,EAAE,EAAE;gBACR,MAAM,EAAE,YAAY;gBACpB,MAAM,EAAE,EAAE,eAAe,EAAE,YAAY,EAAE,YAAY,EAAE,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,IAAI,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,GAAG,EAAE,EAAE;aACtI,CAAC;SACH,CAAC,CAAC;QACH,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,CAAC,MAAM,mCAAmC,CAAC,CAAC;QACzG,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,SAAS,CAAC;QAC/D,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClB,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;YACtB,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,2BAA2B,EAAE,CAAC;SAC9E,CAAC,CAAC;QACH,OAAO,MAAM,CAAC;IAChB,CAAC,CAAC;IAEF,MAAM,IAAI,GAAG,KAAK,EAAE,IAAY,EAAE,IAA6B,EAAE,KAAc,EAAoB,EAAE;QACnG,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;QAC7B,IAAI,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;QACtC,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,GAAG,MAAM,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QACrG,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE;YACvC,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,MAAM,OAAO,EAAE;YACxB,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,EAAE,CAAC;SAC5G,CAAC,CAAC;QACH,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,GAAG,IAAI,QAAQ,CAAC,MAAM,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC3F,mEAAmE;YACnE,OAAO,GAAG,SAAS,CAAC;YACpB,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;YACtB,OAAO,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC;QACjC,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,2BAA2B,QAAQ,CAAC,MAAM,OAAO,IAAI,GAAG,CAAC,CAAC;QAC5F,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,MAAM,CAAC,KAAK;YAAE,MAAM,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,IAAI,0BAA0B,IAAI,GAAG,CAAC,CAAC;QAC7F,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM,CAAC,EAAE,IAAI,IAAI,EAAE,CAAC;QACtF,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO;YAAE,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,GAAG,IAAI,UAAU,CAAC,CAAC;QACvE,IAAI,CAAC;YACH,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAY,CAAC;QACrC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC,CAAC;IAEF,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAChD,CAAC;AAKD;;;;;;GAMG;AACH,MAAM,UAAU,OAAO,CAAC,IAAwB,EAAE,QAA0B,EAAE;IAC5E,IAAI,IAAI,KAAK,SAAS;QAAE,OAAO,IAAI,CAAC;IACpC,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,IAAI,KAAK,WAAW,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,yBAAyB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACrI,KAAK,MAAM,OAAO,IAAI,KAAK;QAAE,IAAI,OAAO,CAAC,WAAW,EAAE,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;IAC7E,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,OAAoB,EAAE,KAAwB;IACvE,MAAM,IAAI,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;IACvC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,aAAa,IAAI,IAAI,KAAK,MAAM;QAAE,OAAO,KAAK,CAAC;IACxF,MAAM,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7B,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,EAAE,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/E,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;IACjC,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC5C,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AA6BD;;;;;;;;GAQG;AACH,MAAM,UAAU,OAAO,CAAC,OAAuB;IAC7C,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,cAAc,CAAC;IAC5C,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACzC,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,SAAS,CAAC;IACzC,MAAM,MAAM,GAAG,CAAC,QAAsB,EAAE,MAAc,EAAE,IAAa,EAAE,EAAE;QACvE,QAAQ,CAAC,UAAU,GAAG,MAAM,CAAC;QAC7B,QAAQ,CAAC,SAAS,CAAC,cAAc,EAAE,kBAAkB,CAAC,CAAC;QACvD,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC;IACF,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,EAAE;QACjC,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;YAAE,OAAO,IAAI,EAAE,CAAC;QAC9D,IAAI,OAAO,CAAC,MAAM,KAAK,MAAM;YAAE,OAAO,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,iCAAiC,EAAE,CAAC,CAAC;QACrH,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC;YAAE,OAAO,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,2CAA2C,EAAE,CAAC,CAAC;QACzI,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAC7C,qHAAqH;QACrH,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,KAAK,kBAAkB,EAAE,CAAC;YAChG,OAAO,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,iCAAiC,EAAE,CAAC,CAAC;QACxF,CAAC;QACD,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAC;QAClC,IAAI,IAAI,GAAG,EAAE,CAAC;QACd,IAAI,IAAI,GAAG,CAAC,CAAC;QACb,IAAI,IAAI,GAAG,KAAK,CAAC;QACjB,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YAC3B,IAAI,IAAI;gBAAE,OAAO;YACjB,MAAM,KAAK,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,KAAoB,CAAC;YAClG,IAAI,IAAI,KAAK,CAAC,UAAU,CAAC;YACzB,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;gBACjB,IAAI,GAAG,IAAI,CAAC;gBACZ,OAAO,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,sBAAsB,KAAK,SAAS,EAAE,CAAC,CAAC;YAC3F,CAAC;YACD,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAClD,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YACrB,IAAI,IAAI;gBAAE,OAAO;YACjB,IAAI,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACzB,KAAK,CAAC,KAAK,IAAI,EAAE;gBACf,IAAI,KAA8C,CAAC;gBACnD,IAAI,CAAC;oBACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,IAAI,IAAI,CAAiB,CAAC;gBACnD,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,gCAAgC,EAAE,CAAC,CAAC;gBACvF,CAAC;gBACD,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ;oBAAE,OAAO,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,yBAAyB,EAAE,CAAC,CAAC;gBAClH,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBACnC,IAAI,OAAO;oBAAE,OAAO,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,YAAY,OAAO,EAAE,EAAE,CAAC,CAAC;gBACvF,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,KAAK,CAAC,SAAS,IAAI,OAAO,KAAK,CAAC,SAAS,KAAK,QAAQ,CAAC,CAAC,CAAE,KAAK,CAAC,SAAqC,CAAC,CAAC,CAAC,EAAE,CAAC;oBACxH,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;gBACpF,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACtG,CAAC;YACH,CAAC,CAAC,EAAE,CAAC;QACP,CAAC,CAAC,CAAC;IACL,CAAC,CAAC;AACJ,CAAC;AAED,qGAAqG;AACrG,MAAM,UAAU,UAAU,CAAC,UAAsF,EAAE;IACjH,MAAM,IAAI,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,KAAK,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC;IACpE,MAAM,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,GAAG,OAAO,CAAC,IAAI,IAAI,cAAc,EAAE,CAAC;IACpE,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE;QAC1B,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;QACtJ,MAAM,IAAI,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,qBAAqB,QAAQ,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAI/G,CAAC;QACF,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,KAAK,IAAI,oBAAoB,IAAI,GAAG,CAAC,CAAC;QACzE,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC,CAAC;AACJ,CAAC;AAgBD,oFAAoF;AACpF,MAAM,UAAU,SAAS,CAAC,OAAyB;IACjD,OAAO;QACL,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,IAAI,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;QACpD,KAAK,CAAC,IAAI,CAAC,MAAM;YACf,MAAM,IAAI,GAAgB,EAAE,CAAC;YAC7B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,IAAI,CAAC;oBACH,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;gBACtF,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACf,IAAI,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACxI,CAAC;YACH,CAAC;YACD,OAAO,IAAI,CAAC;QACd,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/sync/types.d.ts

@@ -43,6 +43,27 @@ export interface ResourceMapping {
      */
     readonly encode?: Readonly<Record<string, (value: unknown, node: Record<string, unknown>) => unknown>>;
     readonly decode?: Readonly<Record<string, (value: unknown) => unknown>>;
+    /**
+     * THE REMOTE OWNS THESE. Inbound changes land; nothing here is ever sent,
+     * and a local act that would write a record of the kind is refused with
+     * `because` once the engine guards the store (`SyncEngine.guard`), and the
+     * store's `permits` stops offering it — the
+     * sentence a person reads, so it names who does own it ("sourcevision:
+     * re-run the analysis to change the zones").
+     */
+    readonly readonly?: boolean;
+    /** Why a read-only resource is not written from here, as a person reads it. */
+    readonly because?: string;
+    /**
+     * OUR FIELD THAT HOLDS THE REMOTE'S VERSION of a record, when the graph
+     * was made from the remote (a projection, an import, a seed). A node that
+     * carries one and has no link is linked at it when the engine is made, so
+     * the first run pushes nothing it did not have to and an unchanged pull
+     * is an echo, not news.
+     */
+    readonly version?: string;
+    /** Our field that holds the remote's id, for those links. Absent: the node's own id. */
+    readonly remoteId?: string;
 }
 export interface SyncMapping {
     /** Names the system, and appears as the author of every inbound change. */
@@ -106,6 +127,13 @@ export interface SyncState {
     readonly links: Readonly<Record<string, RemoteLink>>;
     /** Writes that have not reached the remote yet. */
     readonly outbox: readonly RemoteWrite[];
+    /**
+     * Conflicts waiting for somebody to choose (the `report` policy). A field
+     * held here is not sent until `resolve` says which side stands.
+     */
+    readonly conflicts?: readonly SyncConflict[];
+    /** Records the remote deleted that were kept here: no longer linked, and not sent again as new. */
+    readonly gone?: readonly string[];
 }
 export interface RemoteLink {
     readonly resource: string;
@@ -122,6 +150,13 @@ export interface RemoteLink {
 export declare const EMPTY_SYNC_STATE: SyncState;
 /** The author every inbound change is attributed to. */
 export declare function systemAuthor(system: string): Author;
+/**
+ * WHAT A CONFLICT BECOMES, decided once for the engine: `report` holds both
+ * sides and sends neither until somebody chooses (`resolve`); `theirs` takes
+ * the remote's value through the ordinary inbound act; `ours` keeps ours and
+ * sends it. Every one of them is said in the report.
+ */
+export type ConflictPolicy = "report" | "theirs" | "ours";
 /** One field, changed on both sides since the last time they agreed. */
 export interface SyncConflict {
     readonly localId: string;

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

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

package/dist/sync/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sync/types.ts"],"names":[],"mappings":"AAoIA,MAAM,CAAC,MAAM,gBAAgB,GAAc,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAErE,wDAAwD;AACxD,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;AACxC,CAAC"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/sync/types.ts"],"names":[],"mappings":"AAgKA,MAAM,CAAC,MAAM,gBAAgB,GAAc,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AAErE,wDAAwD;AACxD,MAAM,UAAU,YAAY,CAAC,MAAc;IACzC,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC;AACxC,CAAC"}

package/dist/testing.d.ts

@@ -1,5 +1,8 @@
 import { type GraviewApp } from "./app.js";
 import type { GraphSnapshot } from "./graph/types.js";
+import type { AnySchema } from "./schema/schema.js";
+import { Store } from "./store.js";
+import { type Finding as DocumentFinding } from "./document/findings.js";
 /**
  * A DECLARATION BUILT TO BE AWKWARD.
  *
@@ -66,4 +69,31 @@ export interface AwkwardGraphOptions {
     readonly fill?: Readonly<Record<string, unknown>>;
 }
 export declare function awkwardGraph(app: GraviewApp, options?: number | AwkwardGraphOptions): GraphSnapshot;
+/**
+ * A PRODUCT'S DOCUMENT AND SEED, COMPILED FROM WHERE THEY LIVE.
+ *
+ * A product whose declaration is a document (n-dx's emitted one, a hosted
+ * app's) tested it by copying it into `tests/fixtures` and holding the copy
+ * to the original with a drift test of its own. Read from its path instead,
+ * there is no copy to drift: the document compiled with the checker (a
+ * refusal throws, saying every finding), the seed read beside it, and a
+ * fresh store over both — the app's own acts, rules and policy, in memory —
+ * each time `store()` is asked. Paths are relative to the working
+ * directory, or a `file:` URL (`new URL("../app.graview.json", import.meta.url)`).
+ */
+export interface DocumentFiles {
+    readonly app: GraviewApp;
+    /** The document as read. */
+    readonly document: unknown;
+    /** The seed as read, when one was named. */
+    readonly seed?: GraphSnapshot;
+    /** What the checker said of a document it compiled: warnings and notes. */
+    readonly findings: readonly DocumentFinding[];
+    /** A fresh store over the seed, every call. */
+    store(): Store<AnySchema>;
+}
+export declare function compileDocumentFiles(document: string | URL, options?: {
+    readonly seed?: string | URL;
+    readonly today?: () => string;
+}): DocumentFiles;
 //# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAMtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEtD;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,iFAAiF;IACjF,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACpC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AA6CD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,cAAmB,GAAG,UAAU,CAyEnE;AA6CD;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACnD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,GAAE,MAAM,GAAG,mBAAwB,GAAG,aAAa,CA+BvG"}
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAGA,OAAO,EAAa,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAMtD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AAGnC,OAAO,EAAe,KAAK,OAAO,IAAI,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEtF;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,MAAM,WAAW,cAAc;IAC7B,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;OAGG;IACH,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,iFAAiF;IACjF,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAC1B,sEAAsE;IACtE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC;IAC/B,6EAA6E;IAC7E,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACpC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AA6CD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,OAAO,GAAE,cAAmB,GAAG,UAAU,CAyEnE;AA6CD;;;;;;;;GAQG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;CACnD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,OAAO,GAAE,MAAM,GAAG,mBAAwB,GAAG,aAAa,CA+BvG;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAC;IACzB,4BAA4B;IAC5B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,4CAA4C;IAC5C,QAAQ,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC;IAC9B,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,SAAS,eAAe,EAAE,CAAC;IAC9C,+CAA+C;IAC/C,KAAK,IAAI,KAAK,CAAC,SAAS,CAAC,CAAC;CAC3B;AAcD,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,GAAG,EAAE,OAAO,GAAE;IAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,GAAG,CAAC;IAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAA;CAAO,GAAG,aAAa,CAoBzJ"}

package/dist/testing.js

@@ -1,3 +1,5 @@
+import { readFileSync } from "node:fs";
+import { resolve as resolvePath } from "node:path";
 import { z } from "zod";
 import { defineApp } from "./app.js";
 import { declareInstallation } from "./installation.js";
@@ -5,6 +7,10 @@ import { bindSchema } from "./bind.js";
 import { nodeRef } from "./mutations/node-ref.js";
 import { createSchema } from "./schema/schema.js";
 import { defineNode } from "./schema/define-node.js";
+import { Store } from "./store.js";
+import { readSnapshot } from "./snapshot.js";
+import { compileDocument } from "./document/compile-checked.js";
+import { sayFindings } from "./document/findings.js";
 /* Plurals of the length a real domain has. The district row breaks on these
    and never on "Jobs", which is why the examples never found it. */
 const LONG = [
@@ -193,4 +199,36 @@ export function awkwardGraph(app, options = {}) {
     }
     return { nodes: nodes, edges: [] };
 }
+const readJsonAt = (path) => JSON.parse(readFileSync(typeof path === "string" ? resolvePath(process.cwd(), path) : path, "utf8"));
+/** A seed as `serve --seed` reads it: the snapshot's line format, or an old `{ nodes, edges }` file. */
+function readSeed(path) {
+    const text = readFileSync(typeof path === "string" ? resolvePath(process.cwd(), path) : path, "utf8");
+    try {
+        return readSnapshot(text).snapshot;
+    }
+    catch {
+        throw new Error(`${String(path)} is not a graph snapshot: it needs "nodes" and "edges" arrays, or a snapshot header line.`);
+    }
+}
+export function compileDocumentFiles(document, options = {}) {
+    const read = readJsonAt(document);
+    const compiled = compileDocument(read, options.today ? { today: options.today } : {});
+    if (!compiled.ok)
+        throw new Error(`${String(document)} does not compile:\n${sayFindings(compiled.findings)}`);
+    const app = compiled.app;
+    const seed = options.seed === undefined ? undefined : readSeed(options.seed);
+    return {
+        app,
+        document: read,
+        ...(seed ? { seed } : {}),
+        findings: compiled.findings,
+        store: () => new Store({
+            schema: app.schema,
+            mutations: (app.mutations ?? []),
+            invariants: (app.invariants ?? []),
+            ...(seed ? { snapshot: structuredClone(seed) } : {}),
+            ...(app.policy ? { policy: app.policy } : {}),
+        }),
+    };
+}
 //# sourceMappingURL=testing.js.map