@telepath-computer/autofile 0.0.0-stage → 0.4.0

package/dist/config.js

@@ -0,0 +1,258 @@
+/** Reads, validates, and writes Autofile's process-wide settings. */
+import { mkdir, readFile, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join, resolve } from "node:path";
+const DEFAULT_HTTP_HOST = "127.0.0.1";
+const DEFAULT_HTTP_PORT = 7319;
+const settingNames = ["storage", "http.host", "http.port", "http.origins"];
+function getAutofileHome() {
+    return resolve(process.env.AUTOFILE_HOME ?? join(homedir(), ".autofile"));
+}
+/** Returns whether a command argument names one of Autofile's settings. */
+export function isSettingName(value) {
+    return settingNames.includes(value);
+}
+/** Returns the path shared stores use to serialize writes between processes. */
+export function getWriteLockPath() {
+    return join(getAutofileHome(), "write.lock");
+}
+async function readConfig() {
+    const configPath = join(getAutofileHome(), "config.json");
+    let text;
+    try {
+        text = await readFile(configPath, "utf8");
+    }
+    catch (error) {
+        if (error instanceof Error && "code" in error && error.code === "ENOENT")
+            return {};
+        throw error;
+    }
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch {
+        throw new Error(`${configPath}: invalid JSON`);
+    }
+    if (!isObject(value))
+        throw new Error(`${configPath}: must contain a JSON object`);
+    const storage = "storage" in value ? value.storage : undefined;
+    if (storage !== undefined && typeof storage !== "string") {
+        throw new Error(`${configPath}: storage must be a string`);
+    }
+    const httpValue = "http" in value ? value.http : undefined;
+    if (httpValue !== undefined && !isObject(httpValue)) {
+        throw new Error(`${configPath}: http must be a JSON object`);
+    }
+    const host = httpValue === undefined || !("host" in httpValue) ? undefined : httpValue.host;
+    if (host !== undefined && (typeof host !== "string" || host.length === 0)) {
+        throw new Error(`${configPath}: http.host must be a non-empty string`);
+    }
+    const port = httpValue === undefined || !("port" in httpValue) ? undefined : httpValue.port;
+    if (port !== undefined && !isPort(port)) {
+        throw new Error(`${configPath}: http.port must be an integer from 1 to 65535`);
+    }
+    const originsValue = httpValue === undefined || !("origins" in httpValue)
+        ? undefined
+        : httpValue.origins;
+    let origins;
+    if (originsValue !== undefined && !Array.isArray(originsValue)) {
+        throw new Error(`${configPath}: http.origins must contain only http or https origins without paths`);
+    }
+    if (originsValue !== undefined) {
+        origins = [];
+        for (const origin of originsValue) {
+            const normalized = typeof origin === "string" ? normalizeHttpOrigin(origin) : undefined;
+            if (normalized === undefined) {
+                throw new Error(`${configPath}: http.origins must contain only http or https origins without paths`);
+            }
+            origins.push(normalized);
+        }
+    }
+    return {
+        ...(storage === undefined ? {} : { storage }),
+        ...(host === undefined && port === undefined && origins === undefined
+            ? {}
+            : {
+                http: {
+                    ...(host === undefined ? {} : { host }),
+                    ...(port === undefined ? {} : { port }),
+                    ...(origins === undefined ? {} : { origins }),
+                },
+            }),
+    };
+}
+async function writeConfig(config) {
+    const autofileHome = getAutofileHome();
+    await mkdir(autofileHome, { recursive: true });
+    await writeFile(join(autofileHome, "config.json"), `${JSON.stringify(canonicalConfig(config), null, 2)}\n`, "utf8");
+}
+/** Returns every effective setting, applying defaults to settings that are absent. */
+export async function getSettings() {
+    const config = await readConfig();
+    return {
+        storage: config.storage ?? join(getAutofileHome(), "data"),
+        http: {
+            host: config.http?.host ?? DEFAULT_HTTP_HOST,
+            port: config.http?.port ?? DEFAULT_HTTP_PORT,
+            origins: [...(config.http?.origins ?? [])],
+        },
+    };
+}
+/** Returns the configured data folder, or the default folder when unset. */
+export async function getStorage() {
+    return (await getSettings()).storage;
+}
+/** Returns a setting as the lines its CLI `get` command prints. */
+export async function getSetting(name) {
+    const settings = await getSettings();
+    switch (name) {
+        case "storage": return [settings.storage];
+        case "http.host": return [settings.http.host];
+        case "http.port": return [String(settings.http.port)];
+        case "http.origins": return settings.http.origins;
+    }
+}
+/** Validates and stores one setting while preserving every other setting. */
+export async function setSetting(name, values) {
+    const config = await readConfig();
+    switch (name) {
+        case "storage": {
+            const [folder] = values;
+            if (values.length !== 1 || folder === undefined || folder === "") {
+                throw new Error("storage must be a non-empty folder");
+            }
+            config.storage = resolveStorage(folder);
+            break;
+        }
+        case "http.host": {
+            const [host] = values;
+            if (values.length !== 1 || host === undefined || host === "") {
+                throw new Error("http.host must be a non-empty string");
+            }
+            config.http = { ...config.http, host };
+            break;
+        }
+        case "http.port": {
+            const [value] = values;
+            if (values.length !== 1 || value === undefined) {
+                throw new Error("http.port must be an integer from 1 to 65535");
+            }
+            config.http = { ...config.http, port: parsePort(value) };
+            break;
+        }
+        case "http.origins": {
+            if (values.length === 0) {
+                throw new Error("http.origins must contain at least one origin");
+            }
+            config.http = { ...config.http, origins: values.map(parseOrigin) };
+            break;
+        }
+    }
+    await writeConfig(config);
+}
+/** Removes one setting so its default applies, preserving its siblings. */
+export async function unsetSetting(name) {
+    const config = await readConfig();
+    let changed = false;
+    if (name === "storage") {
+        changed = config.storage !== undefined;
+        delete config.storage;
+    }
+    else if (config.http !== undefined) {
+        const key = name.slice("http.".length);
+        changed = config.http[key] !== undefined;
+        delete config.http[key];
+        if (Object.keys(config.http).length === 0)
+            delete config.http;
+    }
+    if (changed)
+        await writeConfig(config);
+}
+/** Parses a CLI port value and rejects anything outside the TCP port range. */
+export function parsePort(value) {
+    if (!/^\d+$/u.test(value)) {
+        throw new Error("http.port must be an integer from 1 to 65535");
+    }
+    const port = Number(value);
+    if (!isPort(port))
+        throw new Error("http.port must be an integer from 1 to 65535");
+    return port;
+}
+function resolveStorage(folder) {
+    if (folder === "~")
+        return homedir();
+    return folder.startsWith("~/") ? resolve(homedir(), folder.slice(2)) : resolve(folder);
+}
+function parseOrigin(value) {
+    const origin = normalizeHttpOrigin(value);
+    if (origin === undefined) {
+        throw new Error("http.origins must contain only http or https origins without paths");
+    }
+    return origin;
+}
+/** Returns the URL-normalized form of a strict HTTP origin, or undefined when invalid. */
+export function normalizeHttpOrigin(value) {
+    const match = /^https?:\/\/(.+)$/iu.exec(value);
+    if (match === null)
+        return undefined;
+    const authority = match[1];
+    if (authority === undefined
+        || authority.trim() !== authority
+        || /[\s/\\?#@]/u.test(authority)) {
+        return undefined;
+    }
+    if (authority.startsWith("[")) {
+        const closingBracket = authority.indexOf("]");
+        if (closingBracket <= 1
+            || (authority.slice(closingBracket + 1) !== ""
+                && !/^:\d+$/u.test(authority.slice(closingBracket + 1)))) {
+            return undefined;
+        }
+    }
+    else {
+        const firstColon = authority.indexOf(":");
+        if (firstColon !== -1
+            && (firstColon !== authority.lastIndexOf(":")
+                || !/^\d+$/u.test(authority.slice(firstColon + 1)))) {
+            return undefined;
+        }
+    }
+    try {
+        const url = new URL(value);
+        if ((url.protocol !== "http:" && url.protocol !== "https:")
+            || url.hostname === ""
+            || url.username !== ""
+            || url.password !== "") {
+            return undefined;
+        }
+        return url.origin;
+    }
+    catch {
+        return undefined;
+    }
+}
+function isPort(value) {
+    return typeof value === "number" && Number.isInteger(value) && value >= 1 && value <= 65_535;
+}
+function canonicalConfig(config) {
+    const host = config.http?.host;
+    const port = config.http?.port;
+    const origins = config.http?.origins;
+    return {
+        ...(config.storage === undefined ? {} : { storage: config.storage }),
+        ...(host === undefined && port === undefined && origins === undefined
+            ? {}
+            : {
+                http: {
+                    ...(host === undefined ? {} : { host }),
+                    ...(port === undefined ? {} : { port }),
+                    ...(origins === undefined ? {} : { origins }),
+                },
+            }),
+    };
+}
+function isObject(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/http.d.ts

@@ -0,0 +1,10 @@
+/** Mounts Autofile's transport-independent MCP server on Node's HTTP server. */
+import { type HttpSettings } from "./config.js";
+import type { Autofile } from "./index.js";
+export interface RunningHttpServer {
+    endpoint: URL;
+    closed: Promise<void>;
+    close(): Promise<void>;
+}
+/** Starts one modern-only Streamable HTTP endpoint around a process-shared store. */
+export declare function startHttpServer(store: Autofile, settings: HttpSettings, onError: (error: Error) => void): Promise<RunningHttpServer>;

package/dist/http.js

@@ -0,0 +1,157 @@
+/** Mounts Autofile's transport-independent MCP server on Node's HTTP server. */
+import { createServer } from "node:http";
+import { toNodeHandler } from "@modelcontextprotocol/node";
+import { createMcpHandler } from "@modelcontextprotocol/server";
+import { normalizeHttpOrigin } from "./config.js";
+import { buildServer } from "./server.js";
+import { watchResources } from "./mcp-watch.js";
+const MAX_REQUEST_BODY_BYTES = 64 * 1024 * 1024;
+const CORS_ALLOW_HEADERS = "Content-Type, MCP-Protocol-Version, Mcp-Method, Mcp-Name";
+/** Starts one modern-only Streamable HTTP endpoint around a process-shared store. */
+export async function startHttpServer(store, settings, onError) {
+    const handler = createMcpHandler(() => buildServer(store), {
+        legacy: "reject",
+        maxRequestBodySize: MAX_REQUEST_BODY_BYTES,
+        onerror: onError,
+    });
+    const watcher = await watchResources(store, (batch) => {
+        const uris = new Set(batch.changes.map(({ uri }) => uri));
+        for (const uri of uris) {
+            handler.notify.resourceUpdated(uri);
+        }
+        if (batch.listChanged)
+            handler.notify.resourcesChanged();
+    }, onError).catch(async (error) => {
+        await Promise.all([store.close(), handler.close()]);
+        throw error;
+    });
+    const serveMcp = toNodeHandler(handler, { maxRequestBodySize: MAX_REQUEST_BODY_BYTES });
+    const allowedOrigins = new Set(settings.origins);
+    const allowedHosts = new Set([
+        "localhost",
+        "127.0.0.1",
+        "[::1]",
+        ...settings.origins.map((origin) => new URL(origin).hostname.toLowerCase()),
+    ]);
+    const httpServer = createServer((request, response) => {
+        void routeRequest(request, response, allowedOrigins, allowedHosts, serveMcp);
+    });
+    const closed = new Promise((resolveClosed) => httpServer.once("close", resolveClosed));
+    try {
+        await new Promise((resolveListening, reject) => {
+            const onError = (error) => reject(error);
+            httpServer.once("error", onError);
+            httpServer.listen(settings.port, settings.host, () => {
+                httpServer.off("error", onError);
+                resolveListening();
+            });
+        });
+    }
+    catch (error) {
+        await Promise.all([watcher.close(), handler.close()]);
+        await store.close();
+        throw error;
+    }
+    const endpoint = new URL(`http://${urlHost(settings.host)}:${settings.port}/mcp`);
+    let closing;
+    return {
+        endpoint,
+        closed,
+        close() {
+            closing ??= closeHttpServer();
+            return closing;
+        },
+    };
+    async function closeHttpServer() {
+        httpServer.close();
+        httpServer.closeAllConnections();
+        await Promise.all([watcher.close(), handler.close(), closed]);
+        await store.close();
+    }
+}
+async function routeRequest(request, response, allowedOrigins, allowedHosts, serveMcp) {
+    if (!isAllowedHost(request.headers.host, allowedHosts)) {
+        refuse(response, 403, "Forbidden\n");
+        return;
+    }
+    const origin = request.headers.origin;
+    if (origin !== undefined && !isAllowedOrigin(origin, allowedOrigins)) {
+        refuse(response, 403, "Forbidden\n");
+        return;
+    }
+    if (requestPath(request) !== "/mcp") {
+        refuse(response, 404, "Not Found\n");
+        return;
+    }
+    if (origin !== undefined)
+        setCorsHeaders(response, origin);
+    if (request.method === "OPTIONS") {
+        response.setHeader("Connection", "close");
+        response.writeHead(204, {
+            "Access-Control-Allow-Methods": "POST, OPTIONS",
+            "Access-Control-Allow-Headers": CORS_ALLOW_HEADERS,
+        }).end();
+        return;
+    }
+    await serveMcp(request, response);
+}
+function requestPath(request) {
+    try {
+        return new URL(request.url ?? "", "http://autofile.local").pathname;
+    }
+    catch {
+        return undefined;
+    }
+}
+function isAllowedOrigin(origin, allowedOrigins) {
+    const normalized = normalizeHttpOrigin(origin);
+    if (normalized === undefined)
+        return false;
+    const hostname = new URL(normalized).hostname.toLowerCase();
+    return hostname === "localhost"
+        || hostname === "127.0.0.1"
+        || hostname === "[::1]"
+        || allowedOrigins.has(normalized);
+}
+function isAllowedHost(host, allowedHosts) {
+    const hostname = host === undefined ? undefined : hostHeaderName(host);
+    return hostname !== undefined && allowedHosts.has(hostname);
+}
+function hostHeaderName(host) {
+    if (host === "" || host.trim() !== host || /[\s/\\?#@,]/u.test(host))
+        return undefined;
+    if (host.startsWith("[")) {
+        const closingBracket = host.indexOf("]");
+        if (closingBracket <= 1
+            || (host.slice(closingBracket + 1) !== ""
+                && !/^:\d+$/u.test(host.slice(closingBracket + 1)))) {
+            return undefined;
+        }
+    }
+    else {
+        const firstColon = host.indexOf(":");
+        if (firstColon !== -1
+            && (firstColon !== host.lastIndexOf(":")
+                || !/^\d+$/u.test(host.slice(firstColon + 1)))) {
+            return undefined;
+        }
+    }
+    try {
+        return new URL(`http://${host}`).hostname.toLowerCase();
+    }
+    catch {
+        return undefined;
+    }
+}
+function refuse(response, status, body) {
+    response.setHeader("Connection", "close");
+    response.writeHead(status).end(body);
+}
+function setCorsHeaders(response, origin) {
+    response.setHeader("Access-Control-Allow-Origin", origin);
+    response.setHeader("Vary", "Origin");
+}
+function urlHost(host) {
+    return host.includes(":") && !host.startsWith("[") ? `[${host}]` : host;
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAAA,gFAAgF;AAEhF,OAAO,EAAE,YAAY,EAA6C,MAAM,WAAW,CAAC;AAEpF,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAEhE,OAAO,EAAE,mBAAmB,EAAqB,MAAM,aAAa,CAAC;AACrE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAEhD,MAAM,sBAAsB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAChD,MAAM,kBAAkB,GAAG,0DAA0D,CAAC;AAQtF,qFAAqF;AACrF,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,KAAe,EACf,QAAsB,EACtB,OAA+B;IAE/B,MAAM,OAAO,GAAG,gBAAgB,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,KAAK,CAAC,EAAE;QACzD,MAAM,EAAE,QAAQ;QAChB,kBAAkB,EAAE,sBAAsB;QAC1C,OAAO,EAAE,OAAO;KACjB,CAAC,CAAC;IACH,MAAM,OAAO,GAAG,MAAM,cAAc,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,EAAE;QACpD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;QAC1D,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;QACtC,CAAC;QACD,IAAI,KAAK,CAAC,WAAW;YAAE,OAAO,CAAC,MAAM,CAAC,gBAAgB,EAAE,CAAC;IAC3D,CAAC,EAAE,OAAO,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,KAAc,EAAE,EAAE;QACzC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACpD,MAAM,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;IACH,MAAM,QAAQ,GAAG,aAAa,CAAC,OAAO,EAAE,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,CAAC,CAAC;IACxF,MAAM,cAAc,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IACjD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC;QAC3B,WAAW;QACX,WAAW;QACX,OAAO;QACP,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;KAC5E,CAAC,CAAC;IACH,MAAM,UAAU,GAAG,YAAY,CAAC,CAAC,OAAO,EAAE,QAAQ,EAAE,EAAE;QACpD,KAAK,YAAY,CAAC,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC/E,CAAC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,IAAI,OAAO,CAAO,CAAC,aAAa,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC,CAAC;IAE7F,IAAI,CAAC;QACH,MAAM,IAAI,OAAO,CAAO,CAAC,gBAAgB,EAAE,MAAM,EAAE,EAAE;YACnD,MAAM,OAAO,GAAG,CAAC,KAAY,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAChD,UAAU,CAAC,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;YAClC,UAAU,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,GAAG,EAAE;gBACnD,UAAU,CAAC,GAAG,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;gBACjC,gBAAgB,EAAE,CAAC;YACrB,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACtD,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;QACpB,MAAM,KAAK,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,UAAU,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,QAAQ,CAAC,IAAI,MAAM,CAAC,CAAC;IAClF,IAAI,OAAkC,CAAC;IACvC,OAAO;QACL,QAAQ;QACR,MAAM;QACN,KAAK;YACH,OAAO,KAAK,eAAe,EAAE,CAAC;YAC9B,OAAO,OAAO,CAAC;QACjB,CAAC;KACF,CAAC;IAEF,KAAK,UAAU,eAAe;QAC5B,UAAU,CAAC,KAAK,EAAE,CAAC;QACnB,UAAU,CAAC,mBAAmB,EAAE,CAAC;QACjC,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;QAC9D,MAAM,KAAK,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,OAAwB,EACxB,QAAwB,EACxB,cAAmC,EACnC,YAAiC,EACjC,QAA0C;IAE1C,IAAI,CAAC,aAAa,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,YAAY,CAAC,EAAE,CAAC;QACvD,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;QACrC,OAAO;IACT,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,CAAC;IACtC,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,cAAc,CAAC,EAAE,CAAC;QACrE,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;QACrC,OAAO;IACT,CAAC;IACD,IAAI,WAAW,CAAC,OAAO,CAAC,KAAK,MAAM,EAAE,CAAC;QACpC,MAAM,CAAC,QAAQ,EAAE,GAAG,EAAE,aAAa,CAAC,CAAC;QACrC,OAAO;IACT,CAAC;IACD,IAAI,MAAM,KAAK,SAAS;QAAE,cAAc,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IAE3D,IAAI,OAAO,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;QACjC,QAAQ,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAC1C,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE;YACtB,8BAA8B,EAAE,eAAe;YAC/C,8BAA8B,EAAE,kBAAkB;SACnD,CAAC,CAAC,GAAG,EAAE,CAAC;QACT,OAAO;IACT,CAAC;IAED,MAAM,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,WAAW,CAAC,OAAwB;IAC3C,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,IAAI,EAAE,EAAE,uBAAuB,CAAC,CAAC,QAAQ,CAAC;IACtE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,eAAe,CAAC,MAAc,EAAE,cAAmC;IAC1E,MAAM,UAAU,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IAC3C,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC5D,OAAO,QAAQ,KAAK,WAAW;WAC1B,QAAQ,KAAK,WAAW;WACxB,QAAQ,KAAK,OAAO;WACpB,cAAc,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;AACtC,CAAC;AAED,SAAS,aAAa,CAAC,IAAwB,EAAE,YAAiC;IAChF,MAAM,QAAQ,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IACvE,OAAO,QAAQ,KAAK,SAAS,IAAI,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;AAC9D,CAAC;AAED,SAAS,cAAc,CAAC,IAAY;IAClC,IAAI,IAAI,KAAK,EAAE,IAAI,IAAI,CAAC,IAAI,EAAE,KAAK,IAAI,IAAI,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACvF,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACzB,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACzC,IACE,cAAc,IAAI,CAAC;eAChB,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,KAAK,EAAE;mBACpC,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC,CAAC,EACrD,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;SAAM,CAAC;QACN,MAAM,UAAU,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACrC,IACE,UAAU,KAAK,CAAC,CAAC;eACd,CAAC,UAAU,KAAK,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC;mBACnC,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,EAChD,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;IACH,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,QAAwB,EAAE,MAAc,EAAE,IAAY;IACpE,QAAQ,CAAC,SAAS,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAC1C,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,cAAc,CAAC,QAAwB,EAAE,MAAc;IAC9D,QAAQ,CAAC,SAAS,CAAC,6BAA6B,EAAE,MAAM,CAAC,CAAC;IAC1D,QAAQ,CAAC,SAAS,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,OAAO,CAAC,IAAY;IAC3B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1E,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+/** The embedding interface. Importing it starts no server or watcher. */
+export { Autofile, AutofileError } from "./store.js";
+export type { AutofileProblem, AutofileRecord, ChangeEvent, RecordQuery, RecordQueryResult, TypeChanges, TypeDeclaration, TypeDefinition, WatchOptions, } from "./store.js";
+export type { JsonObject, JsonPrimitive, JsonValue } from "./json.js";
+export type { FormatField, PreparedSchema } from "./schema.js";

package/dist/index.js

@@ -0,0 +1,3 @@
+/** The embedding interface. Importing it starts no server or watcher. */
+export { Autofile, AutofileError } from "./store.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,yEAAyE;AAEzE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC"}

package/dist/json.d.ts

@@ -0,0 +1,11 @@
+/** Shared JSON types and lossless input checks at the store boundary. */
+/** A scalar JSON value. */
+export type JsonPrimitive = string | number | boolean | null;
+/** Any value representable in JSON. */
+export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+/** A JSON object with string keys. */
+export interface JsonObject {
+    [key: string]: JsonValue;
+}
+/** Returns why an input is not a plain JSON object, without calling getters or toJSON. */
+export declare function jsonObjectProblem(value: unknown): string | undefined;

package/dist/json.js

@@ -0,0 +1,82 @@
+/** Shared JSON types and lossless input checks at the store boundary. */
+import { isProxy } from "node:util/types";
+const isRawJson = JSON.isRawJSON;
+/** Returns why an input is not a plain JSON object, without calling getters or toJSON. */
+export function jsonObjectProblem(value) {
+    if (isProxy(value))
+        return "JSON proxies are not supported";
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        return "must be a JSON object";
+    }
+    return jsonValueProblem(value, "", new Set());
+}
+function jsonValueProblem(value, path, ancestors) {
+    const location = `JSON value at ${JSON.stringify(path || "/")}`;
+    if (isProxy(value))
+        return `${location}: proxies are not supported`;
+    if (isRawJson?.(value))
+        return `${location}: raw JSON fragments are not supported`;
+    if (value === null || typeof value === "string" || typeof value === "boolean")
+        return undefined;
+    if (typeof value === "number") {
+        return Number.isFinite(value) && !Object.is(value, -0)
+            ? undefined
+            : `${location}: must be a finite number other than negative zero`;
+    }
+    if (typeof value !== "object")
+        return `${location}: ${typeof value} is not supported`;
+    const isArray = Array.isArray(value);
+    const prototype = Object.getPrototypeOf(value);
+    if (isArray ? prototype !== Array.prototype : prototype !== Object.prototype && prototype !== null) {
+        return `${location}: must be a plain object or ordinary array`;
+    }
+    // Built-in prototypes can carry serialization hooks too. Check descriptors so
+    // the JSON snapshot cannot invoke an inherited getter or rewrite the value.
+    if (!Object.hasOwn(value, "toJSON")) {
+        for (let parent = prototype; parent !== null; parent = Object.getPrototypeOf(parent)) {
+            const descriptor = Object.getOwnPropertyDescriptor(parent, "toJSON");
+            if (descriptor === undefined)
+                continue;
+            if (!("value" in descriptor) || typeof descriptor.value === "function") {
+                return `${location}: inherited JSON serialization hooks are not supported`;
+            }
+            break;
+        }
+    }
+    if (ancestors.has(value))
+        return `${location}: circular references are not supported`;
+    const keys = Reflect.ownKeys(value);
+    // Arrays serialize only their numbered elements. Inspect descriptors rather
+    // than reading properties so getters and toJSON can never change the input.
+    const length = isArray ? Object.getOwnPropertyDescriptor(value, "length").value : undefined;
+    if (length !== undefined && keys.length !== length + 1) {
+        return `${location}: arrays must be dense and have no extra properties`;
+    }
+    ancestors.add(value);
+    try {
+        for (const key of keys) {
+            if (typeof key === "symbol")
+                return `${location}: symbol properties are not supported`;
+            if (length !== undefined) {
+                if (key === "length")
+                    continue;
+                if (!/^(?:0|[1-9]\d*)$/u.test(key) || Number(key) >= length) {
+                    return `${location}: arrays must have no extra properties`;
+                }
+            }
+            const descriptor = Object.getOwnPropertyDescriptor(value, key);
+            if (!("value" in descriptor) || !descriptor.enumerable) {
+                return `${location}: properties must be enumerable data properties`;
+            }
+            const childPath = `${path}/${key.replaceAll("~", "~0").replaceAll("/", "~1")}`;
+            const problem = jsonValueProblem(descriptor.value, childPath, ancestors);
+            if (problem !== undefined)
+                return problem;
+        }
+        return undefined;
+    }
+    finally {
+        ancestors.delete(value);
+    }
+}
+//# sourceMappingURL=json.js.map

package/dist/json.js.map

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

package/dist/mcp-resources.d.ts

@@ -0,0 +1,31 @@
+/** Derives MCP resources from public Autofile records and type declarations. */
+import { type Autofile } from "./index.js";
+/** The public information used in an MCP resource listing. */
+export interface StoreResource {
+    uri: string;
+    name: string;
+    mimeType: string;
+    title?: string;
+    description?: string;
+}
+/** The text or binary contents of one resource. */
+export type StoreResourceContents = {
+    uri: string;
+    mimeType: string;
+    text: string;
+} | {
+    uri: string;
+    mimeType: string;
+    blob: string;
+};
+/** Resource operations shared by the MCP server and its notification adapter. */
+export interface Resources {
+    listResources(): Promise<StoreResource[]>;
+    getResourceMetadata(uri: string): Promise<StoreResource | undefined>;
+    listTypeResources(type: string): Promise<StoreResource[]>;
+    readResource(uri: string): Promise<StoreResourceContents | undefined>;
+}
+/** Builds resource operations using only the public library interface. */
+export declare function buildResources(autofile: Autofile): Resources;
+/** Checks addresses that can occur in an MCP resource-list cursor. */
+export declare function isResourceUri(uri: string): boolean;