@telepath-computer/autofile 0.0.0-stage → 0.4.0

package/dist/mcp-resources.js

@@ -0,0 +1,111 @@
+/** Derives MCP resources from public Autofile records and type declarations. */
+import { AutofileError } from "./index.js";
+const typeNamePattern = /^[a-z][a-z0-9-]*$/u;
+const typeUriPattern = /^autofile:\/\/\/_types\/([a-z][a-z0-9-]*)$/u;
+const recordUriPattern = /^autofile:\/\/\/[a-z][a-z0-9-]*\/[a-z0-9][a-z0-9-]*$/u;
+const blobUriPattern = /^autofile:\/\/\/_blobs\/[^/]+$/u;
+/** Builds resource operations using only the public library interface. */
+export function buildResources(autofile) {
+    async function listResources() {
+        const resources = [];
+        for (const declaration of await autofile.types.list()) {
+            resources.push(...await listTypeResources(declaration.type));
+        }
+        return resources.sort(compareResources);
+    }
+    async function getResourceMetadata(uri) {
+        const type = typeUriPattern.exec(uri)?.[1];
+        if (type !== undefined) {
+            const declaration = await readable(() => autofile.types.get(type));
+            return declaration === undefined ? undefined : declarationResource(declaration);
+        }
+        if (!recordUriPattern.test(uri))
+            return undefined;
+        const record = await readable(() => autofile.records.get(uri));
+        return record === undefined ? undefined : recordResource(record);
+    }
+    async function listTypeResources(type) {
+        if (!typeNamePattern.test(type))
+            return [];
+        const declaration = await readable(() => autofile.types.get(type));
+        if (declaration === undefined)
+            return [];
+        const resources = [declarationResource(declaration)];
+        let cursor;
+        do {
+            const page = await readable(() => autofile.records.find({ type, limit: 200, cursor }));
+            if (page === undefined)
+                break;
+            resources.push(...page.records.map(recordResource));
+            // Queries exclude records that fail schema validation. A direct public
+            // read can still return them, including the problems needed to repair them.
+            for (const { uri } of page.unreadable) {
+                const record = await readable(() => autofile.records.get(uri));
+                if (record !== undefined)
+                    resources.push(recordResource(record));
+            }
+            cursor = page.cursor;
+        } while (cursor !== undefined);
+        return resources.sort(compareResources);
+    }
+    async function readResource(uri) {
+        if (blobUriPattern.test(uri)) {
+            const blob = await autofile.blobs.get(uri);
+            return blob === undefined ? undefined : {
+                uri, mimeType: blob.mimeType, blob: Buffer.from(blob.bytes).toString("base64"),
+            };
+        }
+        const type = typeUriPattern.exec(uri)?.[1];
+        const document = type !== undefined
+            ? await readable(() => autofile.types.get(type))
+            : recordUriPattern.test(uri)
+                ? await readable(() => autofile.records.get(uri))
+                : undefined;
+        if (document === undefined)
+            return undefined;
+        return { uri, mimeType: "application/json", text: serialize(document) };
+    }
+    return { listResources, getResourceMetadata, listTypeResources, readResource };
+}
+/** Checks addresses that can occur in an MCP resource-list cursor. */
+export function isResourceUri(uri) {
+    return typeUriPattern.test(uri) || recordUriPattern.test(uri);
+}
+function declarationResource(declaration) {
+    return {
+        uri: declaration.uri,
+        name: `Type: ${declaration.type}`,
+        mimeType: "application/json",
+        description: declaration.description,
+        ...(declaration.title === undefined ? {} : { title: declaration.title }),
+    };
+}
+function recordResource(record) {
+    return {
+        uri: record.uri,
+        name: `${record.type}: ${record.key}`,
+        mimeType: "application/json",
+        ...(record.title === undefined ? {} : { title: record.title }),
+    };
+}
+function serialize(value) {
+    return `${JSON.stringify(value, (_key, item) => {
+        if (typeof item !== "object" || item === null || Array.isArray(item))
+            return item;
+        return Object.fromEntries(Object.entries(item).sort(([left], [right]) => (left < right ? -1 : left > right ? 1 : 0)));
+    }, 2)}\n`;
+}
+function compareResources(left, right) {
+    return left.uri < right.uri ? -1 : left.uri > right.uri ? 1 : 0;
+}
+async function readable(read) {
+    try {
+        return await read();
+    }
+    catch (error) {
+        if (error instanceof AutofileError)
+            return undefined;
+        throw error;
+    }
+}
+//# sourceMappingURL=mcp-resources.js.map

package/dist/mcp-resources.js.map

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

package/dist/mcp-tools.d.ts

@@ -0,0 +1,113 @@
+/** Translates the library operations into the existing MCP tool result shapes. */
+import { type Autofile, type JsonObject, type RecordQuery } from "./index.js";
+import { type UploadBlobInput, type UploadBlobOptions } from "./mcp-upload.js";
+export type { UploadBlobInput } from "./mcp-upload.js";
+/** One reason a tool request was refused. */
+export interface StoreError {
+    uri?: string;
+    message: string;
+}
+/** The MCP refusal body, before protocol formatting. */
+export interface Refusal {
+    errors: StoreError[];
+}
+/** Arguments to find_records. */
+export type FindRecordsInput = RecordQuery;
+/** Arguments to get_record. */
+export interface GetRecordInput {
+    uri: string;
+}
+/** Arguments to create_record. */
+export interface CreateRecordInput {
+    type: string;
+    key?: string;
+    record: JsonObject;
+}
+/** Arguments to update_record. */
+export interface UpdateRecordInput {
+    uri: string;
+    patch: JsonObject;
+}
+/** Arguments to delete_record. */
+export interface DeleteRecordInput {
+    uri: string;
+}
+/** Arguments to get_type. */
+export interface GetTypeInput {
+    type: string;
+}
+/** Arguments to create_type. */
+export interface CreateTypeInput {
+    type: string;
+    description: string;
+    schema: JsonObject;
+    titleField?: string;
+    title?: string;
+}
+/** Arguments to update_type. */
+export interface UpdateTypeInput {
+    type: string;
+    description?: string;
+    schema?: JsonObject;
+    titleField?: string | null;
+    title?: string | null;
+}
+/** Arguments to delete_type. */
+export interface DeleteTypeInput {
+    type: string;
+}
+/** A successful MCP write names the changed resource. */
+export interface UriResult {
+    uri: string;
+}
+/** A page returned by find_records. */
+export interface FindRecordsResult {
+    records: RecordResult[];
+    errors: StoreError[];
+    cursor?: string;
+}
+/** The record envelope exposed by MCP tools. */
+export interface RecordResult extends UriResult {
+    title?: string;
+    createdAt: string;
+    updatedAt: string;
+    value: JsonObject;
+    error?: string;
+}
+/** A declaration summary returned by list_types. */
+export interface TypeSummary extends UriResult {
+    type: string;
+    description: string;
+    title?: string;
+}
+/** The list_types result body. */
+export interface ListTypesResult {
+    types: TypeSummary[];
+}
+/** A full declaration returned by get_type. */
+export interface TypeResult extends UriResult {
+    description: string;
+    schema: JsonObject;
+    titleField?: string;
+    title?: string;
+}
+/** A successful type update also reports records invalid under its schema. */
+export interface UpdateTypeResult extends UriResult {
+    errors: StoreError[];
+}
+/** Plain tool handlers used by the protocol boundary. */
+export interface Tools {
+    findRecords(input: FindRecordsInput): Promise<FindRecordsResult | Refusal>;
+    getRecord(input: GetRecordInput): Promise<RecordResult | Refusal>;
+    createRecord(input: CreateRecordInput): Promise<UriResult | Refusal>;
+    updateRecord(input: UpdateRecordInput): Promise<UriResult | Refusal>;
+    uploadBlob(input: UploadBlobInput, options?: UploadBlobOptions): Promise<UriResult | Refusal>;
+    deleteRecord(input: DeleteRecordInput): Promise<UriResult | Refusal>;
+    listTypes(input: Record<string, never>): Promise<ListTypesResult>;
+    getType(input: GetTypeInput): Promise<TypeResult | Refusal>;
+    createType(input: CreateTypeInput): Promise<UriResult | Refusal>;
+    updateType(input: UpdateTypeInput): Promise<UpdateTypeResult | Refusal>;
+    deleteType(input: DeleteTypeInput): Promise<UriResult | Refusal>;
+}
+/** Builds tool handlers that use the class for every store operation. */
+export declare function buildTools(autofile: Autofile): Tools;

package/dist/mcp-tools.js

@@ -0,0 +1,89 @@
+/** Translates the library operations into the existing MCP tool result shapes. */
+import { AutofileError } from "./index.js";
+import { uploadBlob } from "./mcp-upload.js";
+/** Builds tool handlers that use the class for every store operation. */
+export function buildTools(autofile) {
+    return {
+        findRecords: (input) => withRefusal(async () => {
+            const result = await autofile.records.find(input);
+            return {
+                records: result.records.map(recordResult),
+                errors: result.unreadable,
+                ...(result.cursor === undefined ? {} : { cursor: result.cursor }),
+            };
+        }),
+        getRecord: ({ uri }) => withRefusal(async () => {
+            const record = await autofile.records.get(uri);
+            if (record === undefined) {
+                // The library returns undefined for either missing part of this address;
+                // MCP has always named the missing declaration when the type is absent.
+                const type = uri.slice("autofile:///".length).split("/")[0];
+                if (await autofile.types.get(type) === undefined) {
+                    return { errors: [{ uri: `autofile:///_types/${type}`, message: "type does not exist" }] };
+                }
+                return { errors: [{ uri, message: "record does not exist" }] };
+            }
+            return recordResult(record);
+        }),
+        createRecord: ({ type, record, key }) => withRefusal(async () => {
+            const created = await autofile.records.create(type, record, { key });
+            return { uri: created.uri };
+        }),
+        updateRecord: ({ uri, patch }) => withRefusal(async () => {
+            const updated = await autofile.records.update(uri, patch);
+            return { uri: updated.uri };
+        }),
+        uploadBlob: (input, options = {}) => withRefusal(() => uploadBlob(autofile, input, options)),
+        deleteRecord: ({ uri }) => withRefusal(async () => {
+            await autofile.records.delete(uri);
+            return { uri };
+        }),
+        async listTypes() {
+            const declarations = await autofile.types.list();
+            return {
+                types: declarations.map(({ uri, type, description, title }) => ({
+                    uri, type, description,
+                    ...(title === undefined ? {} : { title }),
+                })),
+            };
+        },
+        getType: ({ type }) => withRefusal(async () => {
+            const declaration = await autofile.types.get(type);
+            if (declaration === undefined) {
+                return { errors: [{ uri: `autofile:///_types/${type}`, message: "type does not exist" }] };
+            }
+            const { type: _type, ...result } = declaration;
+            return result;
+        }),
+        createType: ({ type, ...declaration }) => withRefusal(async () => {
+            const created = await autofile.types.create(type, declaration);
+            return { uri: created.uri };
+        }),
+        updateType: ({ type, ...changes }) => withRefusal(async () => {
+            const updated = await autofile.types.update(type, changes);
+            return { uri: updated.uri, errors: updated.problems ?? [] };
+        }),
+        deleteType: ({ type }) => withRefusal(async () => {
+            await autofile.types.delete(type);
+            return { uri: `autofile:///_types/${type}` };
+        }),
+    };
+}
+function recordResult(record) {
+    const { type: _type, key: _key, problems = [], ...result } = record;
+    return {
+        ...result,
+        ...(problems.length === 0 ? {} : { error: problems.map(({ message }) => message).join("; ") }),
+    };
+}
+async function withRefusal(operation) {
+    try {
+        return await operation();
+    }
+    catch (error) {
+        if (error instanceof AutofileError)
+            return { errors: error.problems };
+        throw error;
+    }
+}
+//# sourceMappingURL=mcp-tools.js.map

package/dist/mcp-tools.js.map

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

package/dist/mcp-upload.d.ts

@@ -0,0 +1,16 @@
+/** Validates MCP upload sources and reads local files only for stdio requests. */
+import { type Autofile } from "./index.js";
+/** Arguments to upload_blob; exactly one source is required. */
+export interface UploadBlobInput {
+    base64?: string;
+    path?: string;
+    mediaType?: string;
+}
+/** Local file access is granted only by the stdio transport. */
+export interface UploadBlobOptions {
+    allowLocalPaths?: boolean;
+}
+/** Uploads decoded bytes through the library's public blob operation. */
+export declare function uploadBlob(autofile: Autofile, input: UploadBlobInput, options: UploadBlobOptions): Promise<{
+    uri: string;
+}>;

package/dist/mcp-upload.js

@@ -0,0 +1,81 @@
+/** Validates MCP upload sources and reads local files only for stdio requests. */
+import { constants } from "node:fs";
+import { open } from "node:fs/promises";
+import { isAbsolute } from "node:path";
+import { lookup as lookupMimeType } from "mime-types";
+import { AutofileError } from "./index.js";
+// Bound transport decoding and file reads before handing bytes to the library.
+const MAX_UPLOAD_BYTES = 7_340_032;
+/** Uploads decoded bytes through the library's public blob operation. */
+export async function uploadBlob(autofile, input, options) {
+    if ((input.base64 === undefined) === (input.path === undefined)) {
+        refuse("supply exactly one of base64 or path");
+    }
+    if (input.path !== undefined) {
+        if (options.allowLocalPaths !== true)
+            refuse("local paths are accepted only over stdio, not HTTP");
+        if (!isAbsolute(input.path))
+            refuse("local upload path must be absolute");
+        const mediaType = input.mediaType ?? (lookupMimeType(input.path) || "application/octet-stream");
+        let bytes;
+        try {
+            bytes = await readUpload(input.path);
+        }
+        catch (error) {
+            if (error instanceof AutofileError)
+                throw error;
+            return refuse("local upload source cannot be read");
+        }
+        return { uri: await autofile.blobs.put(bytes, mediaType) };
+    }
+    if (input.mediaType === undefined)
+        refuse("mediaType is required for base64 uploads");
+    const base64 = input.base64;
+    // Buffer's base64 decoder silently ignores invalid characters and accepts
+    // incomplete padding. Check syntax and the round trip to reject both those
+    // forms and nonzero unused bits in the final sextet.
+    if (base64.length % 4 !== 0 || !/^[A-Za-z0-9+/]*={0,2}$/u.test(base64)) {
+        refuse("base64 must be canonical base64");
+    }
+    const padding = base64.endsWith("==") ? 2 : base64.endsWith("=") ? 1 : 0;
+    const size = base64.length / 4 * 3 - padding;
+    if (size > MAX_UPLOAD_BYTES)
+        refuseSize(size);
+    const bytes = Buffer.from(base64, "base64");
+    if (bytes.toString("base64") !== base64)
+        refuse("base64 must be canonical base64");
+    return { uri: await autofile.blobs.put(bytes, input.mediaType) };
+}
+async function readUpload(path) {
+    // Nonblocking opens and a regular-file check keep devices, sockets and pipes
+    // from hanging a request. The extra byte also detects growth after stat.
+    const file = await open(path, constants.O_RDONLY | constants.O_NONBLOCK);
+    try {
+        const details = await file.stat();
+        if (!details.isFile())
+            refuse("local upload source must be a regular file");
+        if (details.size > MAX_UPLOAD_BYTES)
+            refuseSize(details.size);
+        const buffer = Buffer.alloc(MAX_UPLOAD_BYTES + 1);
+        let length = 0;
+        while (length < buffer.length) {
+            const { bytesRead } = await file.read(buffer, length, buffer.length - length, null);
+            if (bytesRead === 0)
+                break;
+            length += bytesRead;
+        }
+        if (length > MAX_UPLOAD_BYTES)
+            refuseSize(length);
+        return buffer.subarray(0, length);
+    }
+    finally {
+        await file.close();
+    }
+}
+function refuseSize(size) {
+    return refuse(`blob is ${String(size)} bytes; limit is ${String(MAX_UPLOAD_BYTES)} bytes`);
+}
+function refuse(message) {
+    throw new AutofileError([{ message }]);
+}
+//# sourceMappingURL=mcp-upload.js.map

package/dist/mcp-upload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-upload.js","sourceRoot":"","sources":["../src/mcp-upload.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAElF,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,YAAY,CAAC;AAEtD,OAAO,EAAE,aAAa,EAAiB,MAAM,YAAY,CAAC;AAE1D,+EAA+E;AAC/E,MAAM,gBAAgB,GAAG,SAAS,CAAC;AAOnC,yEAAyE;AACzE,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAAkB,EAClB,KAAsB,EACtB,OAA0B;IAE1B,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,EAAE,CAAC;QAChE,MAAM,CAAC,sCAAsC,CAAC,CAAC;IACjD,CAAC;IACD,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QAC7B,IAAI,OAAO,CAAC,eAAe,KAAK,IAAI;YAAE,MAAM,CAAC,oDAAoD,CAAC,CAAC;QACnG,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC;YAAE,MAAM,CAAC,oCAAoC,CAAC,CAAC;QAC1E,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,0BAA0B,CAAC,CAAC;QAChG,IAAI,KAAiB,CAAC;QACtB,IAAI,CAAC;YACH,KAAK,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,KAAK,YAAY,aAAa;gBAAE,MAAM,KAAK,CAAC;YAChD,OAAO,MAAM,CAAC,oCAAoC,CAAC,CAAC;QACtD,CAAC;QACD,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,SAAS,CAAC,EAAE,CAAC;IAC7D,CAAC;IACD,IAAI,KAAK,CAAC,SAAS,KAAK,SAAS;QAAE,MAAM,CAAC,0CAA0C,CAAC,CAAC;IACtF,MAAM,MAAM,GAAG,KAAK,CAAC,MAAO,CAAC;IAC7B,0EAA0E;IAC1E,2EAA2E;IAC3E,qDAAqD;IACrD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,yBAAyB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACvE,MAAM,CAAC,iCAAiC,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACzE,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;IAC7C,IAAI,IAAI,GAAG,gBAAgB;QAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC5C,IAAI,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,MAAM;QAAE,MAAM,CAAC,iCAAiC,CAAC,CAAC;IACnF,OAAO,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;AACnE,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,6EAA6E;IAC7E,yEAAyE;IACzE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IACzE,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAClC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE;YAAE,MAAM,CAAC,4CAA4C,CAAC,CAAC;QAC5E,IAAI,OAAO,CAAC,IAAI,GAAG,gBAAgB;YAAE,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,gBAAgB,GAAG,CAAC,CAAC,CAAC;QAClD,IAAI,MAAM,GAAG,CAAC,CAAC;QACf,OAAO,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YAC9B,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,GAAG,MAAM,EAAE,IAAI,CAAC,CAAC;YACpF,IAAI,SAAS,KAAK,CAAC;gBAAE,MAAM;YAC3B,MAAM,IAAI,SAAS,CAAC;QACtB,CAAC;QACD,IAAI,MAAM,GAAG,gBAAgB;YAAE,UAAU,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACpC,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,OAAO,MAAM,CAAC,WAAW,MAAM,CAAC,IAAI,CAAC,oBAAoB,MAAM,CAAC,gBAAgB,CAAC,QAAQ,CAAC,CAAC;AAC7F,CAAC;AAED,SAAS,MAAM,CAAC,OAAe;IAC7B,MAAM,IAAI,aAAa,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/mcp-watch.d.ts

@@ -0,0 +1,18 @@
+/** Derives MCP resource-list hints from the changes published by Autofile. */
+import type { Autofile, ChangeEvent } from "./index.js";
+import { type Resources } from "./mcp-resources.js";
+/** One resource update and whether the batch changed the MCP resource list. */
+export interface ResourceChange extends ChangeEvent {
+    listChanged: boolean;
+}
+/** Resource updates coalesced by the underlying Autofile watcher. */
+export interface ResourceChangeBatch {
+    changes: ResourceChange[];
+    listChanged: boolean;
+}
+/** An MCP subscription to the store's shared watcher. */
+export interface ResourceWatcher {
+    close(): Promise<void>;
+}
+/** Watches MCP metadata using the instance's existing change subscription API. */
+export declare function watchResources(store: Autofile, onChange: (batch: ResourceChangeBatch) => void | Promise<void>, onError: (error: Error) => void, resources?: Resources): Promise<ResourceWatcher>;

package/dist/mcp-watch.js

@@ -0,0 +1,165 @@
+/** Derives MCP resource-list hints from the changes published by Autofile. */
+import { buildResources } from "./mcp-resources.js";
+const readFailed = Symbol("read failed");
+const unknownMetadata = Symbol("unknown metadata");
+/** Watches MCP metadata using the instance's existing change subscription API. */
+export async function watchResources(store, onChange, onError, resources = buildResources(store)) {
+    const cache = new Map();
+    let pending = Promise.resolve();
+    let initializing = true;
+    const initialChanges = [];
+    let unsubscribe;
+    try {
+        unsubscribe = await store.watch((changes) => {
+            if (initializing) {
+                initialChanges.push(...changes);
+                return;
+            }
+            return enqueue(changes);
+        }, { onError });
+        for (const resource of await resources.listResources()) {
+            cache.set(resource.uri, resourceMetadata(resource));
+        }
+        initializing = false;
+        if (initialChanges.length > 0)
+            await enqueue(initialChanges);
+    }
+    catch (error) {
+        await unsubscribe?.();
+        throw error;
+    }
+    let closing;
+    return { close: () => closing ??= closeWatcher() };
+    function enqueue(changes) {
+        const batch = new Map();
+        for (const { uri, kind } of changes)
+            addEvent(batch, uri, kind);
+        pending = pending.then(() => processBatch(batch))
+            .catch((error) => onError(toError(error)));
+        return pending;
+    }
+    async function processBatch(batch) {
+        const before = new Set(cache.keys());
+        const supplied = new Map();
+        const failedUris = new Set();
+        let focusedReadFailed = false;
+        const markReadFailed = (uri) => {
+            focusedReadFailed = true;
+            failedUris.add(uri);
+            cache.set(uri, unknownMetadata);
+        };
+        let metadataChanged = false;
+        const affectedTypes = new Set();
+        for (const uri of batch.keys()) {
+            const type = declarationType(uri);
+            if (type === undefined || affectedTypes.has(type) || failedUris.has(uri))
+                continue;
+            affectedTypes.add(type);
+            const declarationUri = `autofile:///_types/${type}`;
+            const recordPrefix = `autofile:///${type}/`;
+            const listed = await readSafely(() => resources.listTypeResources(type));
+            if (listed === readFailed) {
+                const affectedUris = new Set([...cache.keys(), ...batch.keys()]);
+                for (const scopedUri of affectedUris) {
+                    if (scopedUri !== declarationUri && !scopedUri.startsWith(recordPrefix))
+                        continue;
+                    markReadFailed(scopedUri);
+                }
+                continue;
+            }
+            const current = new Map(listed.map((resource) => [resource.uri, resource]));
+            const scope = new Set(current.keys());
+            for (const cachedUri of cache.keys()) {
+                if (cachedUri === declarationUri || cachedUri.startsWith(recordPrefix)) {
+                    scope.add(cachedUri);
+                }
+            }
+            for (const scopedUri of scope) {
+                const wasListed = cache.has(scopedUri);
+                const isListed = current.has(scopedUri);
+                if (scopedUri.startsWith(recordPrefix)
+                    && wasListed !== isListed
+                    && !batch.has(scopedUri)) {
+                    addEvent(batch, scopedUri, isListed ? "created" : "deleted");
+                }
+                metadataChanged = updateCache(cache, scopedUri, current.get(scopedUri))
+                    || metadataChanged;
+            }
+            for (const [currentUri, resource] of current)
+                supplied.set(currentUri, resource);
+        }
+        for (const uri of [...batch.keys()]) {
+            if (declarationType(uri) !== undefined)
+                continue;
+            if (failedUris.has(uri))
+                continue;
+            const resource = supplied.get(uri)
+                ?? await readSafely(() => resources.getResourceMetadata(uri));
+            if (resource === readFailed) {
+                markReadFailed(uri);
+                continue;
+            }
+            metadataChanged = updateCache(cache, uri, resource) || metadataChanged;
+        }
+        for (const uri of batch.keys()) {
+            if (!before.has(uri) && !cache.has(uri) && !failedUris.has(uri))
+                batch.delete(uri);
+        }
+        const listChanged = focusedReadFailed
+            || metadataChanged
+            || [...batch.values()].some((event) => event.membershipChanged);
+        const changes = [...batch.entries()].map(([uri, event]) => ({
+            uri,
+            kind: event.lastEvent,
+            listChanged,
+        }));
+        if (changes.length > 0 || listChanged)
+            await onChange({ changes, listChanged });
+    }
+    async function closeWatcher() {
+        await unsubscribe?.();
+        await pending;
+    }
+    async function readSafely(read) {
+        try {
+            return await read();
+        }
+        catch (error) {
+            onError(toError(error));
+            return readFailed;
+        }
+    }
+}
+function addEvent(batch, uri, event) {
+    const existing = batch.get(uri);
+    if (existing === undefined) {
+        batch.set(uri, { membershipChanged: event !== "changed", lastEvent: event });
+    }
+    else {
+        existing.membershipChanged ||= event !== "changed";
+        existing.lastEvent = event;
+    }
+}
+function updateCache(cache, uri, resource) {
+    const previous = cache.get(uri);
+    const next = resource === undefined ? undefined : resourceMetadata(resource);
+    if (next === undefined)
+        cache.delete(uri);
+    else
+        cache.set(uri, next);
+    return previous === unknownMetadata
+        || previous?.title !== next?.title
+        || previous?.description !== next?.description
+        || (previous === undefined) !== (next === undefined);
+}
+function resourceMetadata(resource) {
+    return { title: resource.title, description: resource.description };
+}
+function declarationType(uri) {
+    const match = /^autofile:\/\/\/_types\/([a-z][a-z0-9-]*)$/u.exec(uri);
+    return match?.[1];
+}
+function toError(error) {
+    return error instanceof Error ? error : new Error(String(error));
+}
+//# sourceMappingURL=mcp-watch.js.map

package/dist/mcp-watch.js.map

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