@telepath-computer/autofile 0.3.0 → 0.4.0

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

@@ -1,4 +1,4 @@
-/** Shared compile-time types for the plain JSON crossing store boundaries. */
+/** 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. */
@@ -7,3 +7,5 @@ export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
 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

@@ -1,3 +1,82 @@
-/** Shared compile-time types for the plain JSON crossing store boundaries. */
-export {};
+/** 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

@@ -1 +1 @@
-{"version":3,"file":"json.js","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA,8EAA8E"}
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA,yEAAyE;AAEzE,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAE1C,MAAM,SAAS,GAAI,IAA2D,CAAC,SAAS,CAAC;AAWzF,0FAA0F;AAC1F,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,gCAAgC,CAAC;IAC5D,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,uBAAuB,CAAC;IACjC,CAAC;IACD,OAAO,gBAAgB,CAAC,KAAK,EAAE,EAAE,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,gBAAgB,CAAC,KAAc,EAAE,IAAY,EAAE,SAAsB;IAC5E,MAAM,QAAQ,GAAG,iBAAiB,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,GAAG,CAAC,EAAE,CAAC;IAChE,IAAI,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,QAAQ,6BAA6B,CAAC;IACpE,IAAI,SAAS,EAAE,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,QAAQ,wCAAwC,CAAC;IACnF,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAChG,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YACpD,CAAC,CAAC,SAAS;YACX,CAAC,CAAC,GAAG,QAAQ,oDAAoD,CAAC;IACtE,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,GAAG,QAAQ,KAAK,OAAO,KAAK,mBAAmB,CAAC;IAEtF,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACrC,MAAM,SAAS,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,OAAO,CAAC,CAAC,CAAC,SAAS,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,KAAK,MAAM,CAAC,SAAS,IAAI,SAAS,KAAK,IAAI,EAAE,CAAC;QACnG,OAAO,GAAG,QAAQ,4CAA4C,CAAC;IACjE,CAAC;IACD,8EAA8E;IAC9E,4EAA4E;IAC5E,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC;QACpC,KAAK,IAAI,MAAM,GAAG,SAAS,EAAE,MAAM,KAAK,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,EAAE,CAAC;YACrF,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;YACrE,IAAI,UAAU,KAAK,SAAS;gBAAE,SAAS;YACvC,IAAI,CAAC,CAAC,OAAO,IAAI,UAAU,CAAC,IAAI,OAAO,UAAU,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;gBACvE,OAAO,GAAG,QAAQ,wDAAwD,CAAC;YAC7E,CAAC;YACD,MAAM;QACR,CAAC;IACH,CAAC;IACD,IAAI,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,QAAQ,yCAAyC,CAAC;IACtF,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACpC,4EAA4E;IAC5E,4EAA4E;IAC5E,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,QAAQ,CAAE,CAAC,KAAe,CAAC,CAAC,CAAC,SAAS,CAAC;IACvG,IAAI,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM,GAAG,CAAC,EAAE,CAAC;QACvD,OAAO,GAAG,QAAQ,qDAAqD,CAAC;IAC1E,CAAC;IACD,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IACrB,IAAI,CAAC;QACH,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;YACvB,IAAI,OAAO,GAAG,KAAK,QAAQ;gBAAE,OAAO,GAAG,QAAQ,uCAAuC,CAAC;YACvF,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;gBACzB,IAAI,GAAG,KAAK,QAAQ;oBAAE,SAAS;gBAC/B,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC;oBAC5D,OAAO,GAAG,QAAQ,wCAAwC,CAAC;gBAC7D,CAAC;YACH,CAAC;YACD,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,GAAG,CAAE,CAAC;YAChE,IAAI,CAAC,CAAC,OAAO,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;gBACvD,OAAO,GAAG,QAAQ,iDAAiD,CAAC;YACtE,CAAC;YACD,MAAM,SAAS,GAAG,GAAG,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;YAC/E,MAAM,OAAO,GAAG,gBAAgB,CAAC,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;YACzE,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO,OAAO,CAAC;QAC5C,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;YAAS,CAAC;QACT,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;AACH,CAAC"}

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;

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":"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"}

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>;