corkcrm-mcp 0.8.0 → 0.10.0

package/dist/auth.d.ts

@@ -11,3 +11,5 @@ export declare function getConvexUrl(): string;
  * Called once on first tool invocation.
  */
 export declare function ensureAuthenticated(testFn: () => Promise<unknown>): Promise<void>;
+/** The folder a download goes to when the call names none: CORK_DOWNLOAD_DIR, else null (files.ts uses ~/Downloads). */
+export declare function getDownloadDir(): string | null;

package/dist/auth.js

@@ -37,4 +37,9 @@ export async function ensureAuthenticated(testFn) {
         throw new Error(`API key validation failed: ${msg}`);
     }
 }
+/** The folder a download goes to when the call names none: CORK_DOWNLOAD_DIR, else null (files.ts uses ~/Downloads). */
+export function getDownloadDir() {
+    const dir = process.env.CORK_DOWNLOAD_DIR?.trim();
+    return dir ? dir : null;
+}
 //# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -1 +1 @@
-{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,IAAI,SAAS,GAAG,KAAK,CAAC;AAEtB,MAAM,UAAU,SAAS;IACvB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACrC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,iDAAiD;YAC/C,gDAAgD,CACnD,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IACnC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,+CAA+C;YAC7C,mFAAmF,CACtF,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAA8B;IAE9B,IAAI,SAAS;QAAE,OAAO;IACtB,IAAI,CAAC;QACH,MAAM,MAAM,EAAE,CAAC;QACf,SAAS,GAAG,IAAI,CAAC;IACnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,EAAE,CAAC,CAAC;IACvD,CAAC;AACH,CAAC"}
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,IAAI,SAAS,GAAG,KAAK,CAAC;AAEtB,MAAM,UAAU,SAAS;IACvB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC;IACrC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,iDAAiD;YAC/C,gDAAgD,CACnD,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,YAAY;IAC1B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;IACnC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,+CAA+C;YAC7C,mFAAmF,CACtF,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAA8B;IAE9B,IAAI,SAAS;QAAE,OAAO;IACtB,IAAI,CAAC;QACH,MAAM,MAAM,EAAE,CAAC;QACf,SAAS,GAAG,IAAI,CAAC;IACnB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,GAAG,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACrE,MAAM,IAAI,KAAK,CAAC,8BAA8B,GAAG,EAAE,CAAC,CAAC;IACvD,CAAC;AACH,CAAC;AAED,wHAAwH;AACxH,MAAM,UAAU,cAAc;IAC5B,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,EAAE,IAAI,EAAE,CAAC;IAClD,OAAO,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AAC1B,CAAC"}

package/dist/changeFiles.d.ts

@@ -0,0 +1,23 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+type Args = Record<string, unknown>;
+/** One file ready to upload: its name, the MIME type it is sent with, and its bytes. */
+type Upload = {
+    name: string;
+    type: string;
+    size: number;
+    bytes: () => Promise<Uint8Array>;
+};
+/**
+ * The local checks for paths, in the design's order, so a bad call never uploads: the count, then each
+ * path: absolute, there, a file and not a folder, at most 25 MB, a type the app takes.
+ */
+export declare function checkPaths(raw: unknown): Promise<Upload[]>;
+/** The local checks for a text add: its length, then the name's extension, then its UTF-8 size. */
+export declare function checkText(text: unknown, rawName: unknown): Upload;
+/** POSTs one file's bytes to its upload URL with its MIME type; answers the storage ID. The URL never goes into an error. */
+export declare function uploadBytes(url: string, file: {
+    name: string;
+    type: string;
+}, bytes: Uint8Array): Promise<string>;
+export declare function runChangeFiles(args: Args): Promise<CallToolResult>;
+export {};

package/dist/changeFiles.js

@@ -0,0 +1,239 @@
+// The change_files tool's run path (Tool Design, "change_files"). add reads files from disk and uploads
+// their bytes straight to Convex storage, so it runs here instead of through the shared callback in tools.ts.
+// Backend actions: upload_start, add, discard, rename, move, copy, delete (write/files.ts).
+import { readFile, stat } from "node:fs/promises";
+import { homedir } from "node:os";
+import { basename, isAbsolute, join } from "node:path";
+import { callTool } from "./client.js";
+import { FILES_PER_CALL, formatSize, isTextType, MAX_FILE_SIZE, TEXT_ADD_MAX, typeOfName, TYPES_SENTENCE, } from "./fileKinds.js";
+import { formatChangeFiles, formatFilePreview, isFilePreview, } from "./formatChangeFiles.js";
+import { errorResult, refuse, textResult, ToolRefusal } from "./result.js";
+const TOOL = "change_files";
+const NOTHING_CHANGED = "Nothing changed.";
+const UPLOAD_TIMEOUT_MS = 120_000;
+// The arguments each action takes; anything else is bad_argument, naming it (Tool Design, Arguments).
+const TAKES = {
+    add: ["action", "task", "paths", "text", "name"],
+    rename: ["action", "task", "files", "name"],
+    move: ["action", "task", "files", "to"],
+    copy: ["action", "task", "files", "to"],
+    delete: ["action", "task", "files", "confirm_token"],
+};
+/** Every change_files refusal ends "Nothing changed." (write rule 7); a sentence may carry it already. */
+const withNothingChanged = (m) => (m.includes(NOTHING_CHANGED) ? m : `${m.trimEnd()} ${NOTHING_CHANGED}`);
+/** "That's 11 files, over the limit of 10 per call. ..." (W68 (b) for add; write/cap.ts). */
+function checkPerCall(count, action) {
+    if (count <= FILES_PER_CALL)
+        return;
+    const split = action === "add" ? "Add them in two calls, or zip them." : `${action[0].toUpperCase()}${action.slice(1)} them in two calls.`;
+    refuse("over_limit", `That's ${count} files, over the limit of ${FILES_PER_CALL} per call. ${split}`);
+}
+function checkArgs(action, args) {
+    for (const key of Object.keys(args)) {
+        if (args[key] === undefined || TAKES[action].includes(key))
+            continue;
+        if (key === "confirm_token")
+            refuse("bad_argument", `${action} doesn't take confirm_token; only a delete's second call does.`);
+        refuse("bad_argument", `${action} doesn't take ${key}.`);
+    }
+    if (typeof args.task !== "string" || !args.task.trim()) {
+        refuse("bad_argument", "task is required: the alpha-ID of a milestone, task, or subtask.");
+    }
+    if (action !== "add") {
+        if (!Array.isArray(args.files))
+            refuse("bad_argument", `files is required: the names or IDs of the files to ${action}.`);
+        checkPerCall(args.files.length, action);
+    }
+}
+/** "~/Desktop/a.pdf" -> "/Users/me/Desktop/a.pdf". */
+const expandHome = (p) => (p === "~" ? homedir() : p.startsWith("~/") ? join(homedir(), p.slice(2)) : p);
+/**
+ * The local checks for paths, in the design's order, so a bad call never uploads: the count, then each
+ * path: absolute, there, a file and not a folder, at most 25 MB, a type the app takes.
+ */
+export async function checkPaths(raw) {
+    const paths = raw;
+    checkPerCall(paths.length, "add");
+    const uploads = [];
+    for (const given of paths) {
+        const path = expandHome(given.trim());
+        if (!isAbsolute(path))
+            refuse("bad_argument", `paths must be absolute, like /Users/you/Desktop/spec.pdf. Got '${given}'.`);
+        let info;
+        try {
+            info = await stat(path);
+        }
+        catch {
+            return refuse("not_found", `No file at ${path}.`);
+        }
+        const name = basename(path);
+        if (info.isDirectory()) {
+            refuse("bad_argument", `'${name}' is a folder. Name the files, up to ${FILES_PER_CALL}, or zip the folder and add the zip.`);
+        }
+        if (!info.isFile())
+            refuse("bad_argument", `${path} isn't a regular file.`);
+        if (info.size > MAX_FILE_SIZE)
+            refuse("over_limit", `'${name}' is ${formatSize(info.size)}, over the app's 25 MB limit per file.`);
+        const type = typeOfName(name);
+        if (!type)
+            refuse("not_allowed", `'${name}' is a type the app doesn't take. ${TYPES_SENTENCE}`);
+        uploads.push({ name, type: type, size: info.size, bytes: async () => new Uint8Array(await readFile(path)) });
+    }
+    return uploads;
+}
+/** The local checks for a text add: its length, then the name's extension, then its UTF-8 size. */
+export function checkText(text, rawName) {
+    const body = text;
+    if (body.length > TEXT_ADD_MAX) {
+        refuse("over_limit", `The text is ${body.length.toLocaleString("en-US")} characters, over the limit of ${TEXT_ADD_MAX.toLocaleString("en-US")} for a text add. Split it, or save it as a file and add the path.`);
+    }
+    if (typeof rawName !== "string" || !rawName.trim()) {
+        refuse("bad_argument", "add with text needs name: the file name with its extension, like notes.md.");
+    }
+    const name = rawName.trim();
+    const type = typeOfName(name);
+    if (!type || !isTextType(type)) {
+        refuse("bad_argument", `'${name}' needs a text extension: .md, .txt, .csv, .json, .html, .css, or .js.`);
+    }
+    const bytes = new TextEncoder().encode(body);
+    if (bytes.length > MAX_FILE_SIZE)
+        refuse("over_limit", `'${name}' is ${formatSize(bytes.length)}, over the app's 25 MB limit per file.`);
+    return { name, type: type, size: bytes.length, bytes: async () => bytes };
+}
+/** A backend call; a refusal comes back as a ToolRefusal with the backend's error. */
+async function backend(args) {
+    const result = await callTool(TOOL, args);
+    if (!result.ok)
+        throw new ToolRefusal(result.error);
+    return result.data;
+}
+/** POSTs one file's bytes to its upload URL with its MIME type; answers the storage ID. The URL never goes into an error. */
+export async function uploadBytes(url, file, bytes) {
+    let response;
+    try {
+        response = await fetch(url, {
+            method: "POST",
+            headers: { "Content-Type": file.type },
+            body: bytes, // Node takes any Uint8Array; the DOM types want an ArrayBuffer-backed one
+            signal: AbortSignal.timeout(UPLOAD_TIMEOUT_MS),
+        });
+    }
+    catch (e) {
+        const message = (e instanceof Error ? e.message : String(e)).split(url).join("the upload URL");
+        throw new Error(`Could not upload '${file.name}': ${message}.`);
+    }
+    if (!response.ok)
+        throw new Error(`Could not upload '${file.name}' (HTTP ${response.status}).`);
+    let storageId;
+    try {
+        storageId = (await response.json()).storageId;
+    }
+    catch {
+        storageId = undefined;
+    }
+    if (typeof storageId !== "string" || !storageId)
+        throw new Error(`Could not upload '${file.name}': no storage ID came back.`);
+    return storageId;
+}
+/** Deletes this call's uploads that have no file row. Best effort: its own failure never hides the first error. */
+async function discard(storageIds) {
+    if (!storageIds.length)
+        return;
+    try {
+        await callTool(TOOL, { action: "discard", storage_ids: storageIds });
+    }
+    catch {
+        // The backend's add already discards on its own refusals; an upload left behind expires unused.
+    }
+}
+async function add(args) {
+    if (args.paths !== undefined && args.text !== undefined) {
+        refuse("bad_argument", "add takes paths or text, not both. Add the text file in its own call.");
+    }
+    if (args.paths !== undefined && args.name !== undefined) {
+        refuse("bad_argument", "add with paths doesn't take name; each file keeps its own name. Rename it after.");
+    }
+    if (args.paths === undefined && args.text === undefined) {
+        refuse("bad_argument", "add needs paths (absolute file paths) or text plus name.");
+    }
+    const uploads = args.paths !== undefined ? await checkPaths(args.paths) : [checkText(args.text, args.name)];
+    const task = args.task.trim();
+    // Nothing is written until add: upload_start checks the item, its count, and each declared size and type.
+    const start = await backend({
+        action: "upload_start",
+        task,
+        files: uploads.map((u) => ({ name: u.name, size: u.size, type: u.type })),
+    });
+    const stored = [];
+    try {
+        for (const [i, u] of uploads.entries())
+            stored.push(await uploadBytes(start.upload_urls[i], u, await u.bytes()));
+        return await backend({
+            action: "add",
+            task,
+            files: uploads.map((u, i) => ({ storage_id: stored[i], name: u.name })),
+        });
+    }
+    catch (e) {
+        await discard(stored);
+        throw e;
+    }
+}
+/** structuredContent: text first, then the change; never the backend's summary or a storage URL. */
+function fieldsOf(r) {
+    const small = (f) => ({ id: f.id, name: f.name, kind: f.kind, size: f.size });
+    if (isFilePreview(r)) {
+        return {
+            action: "delete",
+            preview: true,
+            task: r.task,
+            files: r.files.map((f) => ({ ...small(f), added_by: f.added_by, added_at: f.added_at })),
+            count: r.count,
+            confirm_token: r.confirm_token,
+            expires_at: r.expires_at,
+        };
+    }
+    const out = { action: r.action, task: r.task };
+    if ("to" in r)
+        out.to = r.to;
+    out.files = r.files.map(small);
+    out.count = r.count;
+    if ("source_count" in r)
+        out.source_count = r.source_count;
+    if ("same_name" in r)
+        out.same_name = r.same_name.map((s) => ({ id: s.id, name: s.older_name, added_at: s.added_at }));
+    if ("unchanged" in r) {
+        out.old_name = r.old_name;
+        out.unchanged = r.unchanged;
+    }
+    return out;
+}
+/** A refusal: the sentence ending "Nothing changed.", and for a refused delete confirm, the fresh preview. */
+function refusal(error) {
+    const message = withNothingChanged(error.message);
+    if (error.code === "confirm_required" && isFilePreview(error.details)) {
+        const text = `${message}\n${formatFilePreview(error.details)}`;
+        return { content: [{ type: "text", text }], structuredContent: { text, error: { ...error, message } }, isError: true };
+    }
+    // The ambiguous sentence already lists the files with dates, sizes, and IDs; don't print them twice.
+    const shown = error.code === "ambiguous" ? { ...error, message, candidates: undefined } : { ...error, message };
+    const result = errorResult(TOOL, shown);
+    return { ...result, structuredContent: { ...result.structuredContent, error: { ...error, message } } };
+}
+export async function runChangeFiles(args) {
+    try {
+        const action = args.action;
+        checkArgs(action, args);
+        const data = action === "add"
+            ? await add(args)
+            : await backend(Object.fromEntries(Object.entries(args).filter(([, v]) => v !== undefined)));
+        return textResult(formatChangeFiles(data), fieldsOf(data));
+    }
+    catch (e) {
+        if (e instanceof ToolRefusal)
+            return refusal(e.error);
+        const message = e instanceof Error ? e.message : String(e);
+        return refusal({ code: "internal", message });
+    }
+}
+//# sourceMappingURL=changeFiles.js.map

package/dist/changeFiles.js.map

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

package/dist/descriptions.d.ts

@@ -1,4 +1,4 @@
-export type ToolName = "find_tasks" | "get_task" | "count_tasks" | "list_views" | "list_projects" | "get_workspace_info" | "resolve" | "find_timecards" | "sum_time" | "find_comments" | "create_task" | "update_task" | "place_task" | "set_order" | "bulk_update_tasks" | "move_task" | "delete_task" | "add_comment" | "edit_comment" | "delete_comment" | "link_pull_request" | "help";
+export type ToolName = "find_tasks" | "get_task" | "count_tasks" | "list_views" | "list_projects" | "get_workspace_info" | "resolve" | "find_timecards" | "sum_time" | "find_comments" | "files" | "change_files" | "create_task" | "update_task" | "place_task" | "set_order" | "bulk_update_tasks" | "move_task" | "delete_task" | "add_comment" | "edit_comment" | "delete_comment" | "link_pull_request" | "help";
 export declare const DESCRIPTIONS: Record<ToolName, {
     title: string;
     description: string;

package/dist/descriptions.js

@@ -86,6 +86,14 @@ export const DESCRIPTIONS = {
         title: "Link a pull request",
         description: `Attaches a GitHub pull request to a task. Usually not needed: a pull request whose branch, title, or body has the task's alpha-ID links itself. Use it for one that can't mention the ID. More: help topic link_pull_request.`,
     },
+    files: {
+        title: "Files",
+        description: `Lists, finds, reads, or downloads files on a milestone, task, or subtask. No answer holds a whole file: list and find give names and sizes; read gives one part (text by lines, an image, or other types saved to disk); download saves to a folder. More: help topic files.`,
+    },
+    change_files: {
+        title: "Change files",
+        description: `Adds, renames, moves, copies, or deletes files on a milestone, task, or subtask. add takes absolute paths, or text plus a name: 10 files per call, 10 per item, 25 MB each. To edit a file, download it, change it, add the copy. delete previews first: show it, wait for a yes, never confirm in the same turn. More: help topic change_files.`,
+    },
     help: {
         title: "CorkTasks help",
         description: `Rules and examples for the corktasks tools: how search matches, what is hidden by default, dev views, dates, paging, placement, and answer style. Call it once before your first corktasks call in a chat, and with a topic before a tool you haven't used or after an error.`,

package/dist/descriptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"descriptions.js","sourceRoot":"","sources":["../src/descriptions.ts"],"names":[],"mappings":"AAwBA,2GAA2G;AAC3G,gGAAgG;AAChG,gDAAgD;AAChD,MAAM,CAAC,MAAM,YAAY,GAA6D;IACpF,UAAU,EAAE;QACV,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,6gBAA6gB;KAC3hB;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,kUAAkU;KAChV;IACD,WAAW,EAAE;QACX,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,qRAAqR;KACnS;IACD,UAAU,EAAE;QACV,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,qNAAqN;KACnO;IACD,aAAa,EAAE;QACb,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,6PAA6P;KAC3Q;IACD,kBAAkB,EAAE;QAClB,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,yNAAyN;KACvO;IACD,OAAO,EAAE;QACP,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,sTAAsT;KACpU;IACD,cAAc,EAAE;QACd,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,6WAA6W;KAC3X;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,kWAAkW;KAChX;IACD,aAAa,EAAE;QACb,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,wWAAwW;KACtX;IACD,WAAW,EAAE;QACX,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,khBAAkhB;KAChiB;IACD,WAAW,EAAE;QACX,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,yVAAyV;KACvW;IACD,UAAU,EAAE;QACV,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,wUAAwU;KACtV;IACD,SAAS,EAAE;QACT,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,iUAAiU;KAC/U;IACD,iBAAiB,EAAE;QACjB,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,uWAAuW;KACrX;IACD,SAAS,EAAE;QACT,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,2RAA2R;KACzS;IACD,WAAW,EAAE;QACX,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,iTAAiT;KAC/T;IACD,WAAW,EAAE;QACX,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,wJAAwJ;KACtK;IACD,YAAY,EAAE;QACZ,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,yMAAyM;KACvN;IACD,cAAc,EAAE;QACd,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,iMAAiM;KAC/M;IACD,iBAAiB,EAAE;QACjB,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,+NAA+N;KAC7O;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,+QAA+Q;KAC7R;CACF,CAAC"}
+{"version":3,"file":"descriptions.js","sourceRoot":"","sources":["../src/descriptions.ts"],"names":[],"mappings":"AA0BA,2GAA2G;AAC3G,gGAAgG;AAChG,gDAAgD;AAChD,MAAM,CAAC,MAAM,YAAY,GAA6D;IACpF,UAAU,EAAE;QACV,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,6gBAA6gB;KAC3hB;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,kUAAkU;KAChV;IACD,WAAW,EAAE;QACX,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,qRAAqR;KACnS;IACD,UAAU,EAAE;QACV,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,qNAAqN;KACnO;IACD,aAAa,EAAE;QACb,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,6PAA6P;KAC3Q;IACD,kBAAkB,EAAE;QAClB,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,yNAAyN;KACvO;IACD,OAAO,EAAE;QACP,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,sTAAsT;KACpU;IACD,cAAc,EAAE;QACd,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,6WAA6W;KAC3X;IACD,QAAQ,EAAE;QACR,KAAK,EAAE,UAAU;QACjB,WAAW,EAAE,kWAAkW;KAChX;IACD,aAAa,EAAE;QACb,KAAK,EAAE,eAAe;QACtB,WAAW,EAAE,wWAAwW;KACtX;IACD,WAAW,EAAE;QACX,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,khBAAkhB;KAChiB;IACD,WAAW,EAAE;QACX,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,yVAAyV;KACvW;IACD,UAAU,EAAE;QACV,KAAK,EAAE,YAAY;QACnB,WAAW,EAAE,wUAAwU;KACtV;IACD,SAAS,EAAE;QACT,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,iUAAiU;KAC/U;IACD,iBAAiB,EAAE;QACjB,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EAAE,uWAAuW;KACrX;IACD,SAAS,EAAE;QACT,KAAK,EAAE,WAAW;QAClB,WAAW,EAAE,2RAA2R;KACzS;IACD,WAAW,EAAE;QACX,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,iTAAiT;KAC/T;IACD,WAAW,EAAE;QACX,KAAK,EAAE,aAAa;QACpB,WAAW,EAAE,wJAAwJ;KACtK;IACD,YAAY,EAAE;QACZ,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,yMAAyM;KACvN;IACD,cAAc,EAAE;QACd,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,iMAAiM;KAC/M;IACD,iBAAiB,EAAE;QACjB,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,+NAA+N;KAC7O;IACD,KAAK,EAAE;QACL,KAAK,EAAE,OAAO;QACd,WAAW,EAAE,8QAA8Q;KAC5R;IACD,YAAY,EAAE;QACZ,KAAK,EAAE,cAAc;QACrB,WAAW,EAAE,kVAAkV;KAChW;IACD,IAAI,EAAE;QACJ,KAAK,EAAE,gBAAgB;QACvB,WAAW,EAAE,+QAA+Q;KAC7R;CACF,CAAC"}

package/dist/fileKinds.d.ts

@@ -0,0 +1,36 @@
+export declare const MAX_FILE_SIZE: number;
+export declare const MAX_FILES_PER_TASK = 10;
+export declare const IMAGE_READ_MAX = 3670016;
+export declare const READ_LINES_DEFAULT = 200;
+export declare const READ_LINES_MAX = 500;
+export declare const READ_CHARS_MAX = 40000;
+export declare const FILES_PER_CALL = 10;
+export declare const TEXT_ADD_MAX = 100000;
+/** The kinds the app takes, in words (read/fileShared.ts TYPES_SENTENCE). */
+export declare const TYPES_SENTENCE = "It takes PDF, Word, Excel, images (PNG, JPEG, GIF, WebP), text, CSV, Markdown, JSON, HTML, CSS, JavaScript, and ZIP.";
+/** Extension to the MIME type an upload is stored with. */
+export declare const EXTENSION_TYPES: Record<string, string>;
+/** "text/markdown; charset=utf-8" -> "text/markdown". */
+export declare const baseType: (type: string | undefined) => string;
+/** "Spec.PDF" -> "pdf"; no extension -> "". */
+export declare function extensionOf(name: string): string;
+/** The MIME type an upload of this name is sent with, or undefined for a type the app doesn't take. */
+export declare function typeOfName(name: string): string | undefined;
+/** A MIME type in words: "PDF", "Markdown", "PNG". An unknown type prints as is. */
+export declare const typeWords: (type: string) => string;
+/** Text kinds are read by lines: text/* and JSON. */
+export declare const isTextType: (type: string) => boolean;
+export declare const isImageType: (type: string) => boolean;
+/** "512 B", "39 KB" (whole), "5.2 MB" (one decimal). */
+export declare function formatSize(bytes: number): string;
+/** A name safe to write in one folder: no slashes, NUL, "..", or leading dots; empty becomes "file". */
+export declare function cleanName(name: string): string;
+/** "spec.pdf", n 2 -> "spec (2).pdf"; a name with no extension gets the number at the end. */
+export declare function numberedName(name: string, n: number): string;
+/**
+ * Writes bytes to `folder` under the cleaned name, never overwriting: a taken name gets " (1)", " (2)".
+ * The wx flag makes a race between the check and the write fail instead of overwrite.
+ */
+export declare function writeNew(folder: string, name: string, bytes: Uint8Array): Promise<string>;
+/** Fetches a stored copy's bytes. The URL never goes into an error message. */
+export declare function fetchBytes(url: string, name: string): Promise<Uint8Array>;

package/dist/fileKinds.js

@@ -0,0 +1,149 @@
+// Shared file facts for the file tools: the app's limits, MIME types in words, sizes, and safe names on disk.
+// Copied from convex/routes/tasks/files.ts and convex/routes/mcp/read/fileShared.ts; the package can't import
+// Convex code, so keep these in step by hand (Tool Design, "Limits").
+import { constants } from "node:fs";
+import { open } from "node:fs/promises";
+import { join } from "node:path";
+export const MAX_FILE_SIZE = 25 * 1024 * 1024; // 26,214,400 bytes
+export const MAX_FILES_PER_TASK = 10;
+export const IMAGE_READ_MAX = 3_670_016; // 3.5 MB
+export const READ_LINES_DEFAULT = 200;
+export const READ_LINES_MAX = 500;
+export const READ_CHARS_MAX = 40_000;
+export const FILES_PER_CALL = 10; // change_files: add, move, copy, delete (write/cap.ts)
+export const TEXT_ADD_MAX = 100_000; // change_files: characters in a text add (write/cap.ts)
+/** The kinds the app takes, in words (read/fileShared.ts TYPES_SENTENCE). */
+export const TYPES_SENTENCE = "It takes PDF, Word, Excel, images (PNG, JPEG, GIF, WebP), text, CSV, Markdown, JSON, HTML, CSS, JavaScript, and ZIP.";
+/** Extension to the MIME type an upload is stored with. */
+export const EXTENSION_TYPES = {
+    pdf: "application/pdf",
+    doc: "application/msword",
+    docx: "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    xls: "application/vnd.ms-excel",
+    xlsx: "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    txt: "text/plain",
+    csv: "text/csv",
+    md: "text/markdown",
+    markdown: "text/markdown",
+    png: "image/png",
+    jpg: "image/jpeg",
+    jpeg: "image/jpeg",
+    gif: "image/gif",
+    webp: "image/webp",
+    json: "application/json",
+    html: "text/html",
+    htm: "text/html",
+    css: "text/css",
+    js: "text/javascript",
+    mjs: "text/javascript",
+    zip: "application/zip",
+};
+const TYPE_WORDS = {
+    "application/pdf": "PDF",
+    "application/msword": "Word",
+    "application/vnd.openxmlformats-officedocument.wordprocessingml.document": "Word",
+    "application/vnd.ms-excel": "Excel",
+    "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet": "Excel",
+    "text/csv": "CSV",
+    "text/markdown": "Markdown",
+    "text/plain": "text",
+    "application/json": "JSON",
+    "text/html": "HTML",
+    "text/css": "CSS",
+    "text/javascript": "JavaScript",
+    "image/png": "PNG",
+    "image/jpeg": "JPEG",
+    "image/gif": "GIF",
+    "image/webp": "WebP",
+    "application/zip": "ZIP",
+    "application/x-zip-compressed": "ZIP",
+};
+const IMAGE_TYPES = ["image/png", "image/jpeg", "image/gif", "image/webp"];
+/** "text/markdown; charset=utf-8" -> "text/markdown". */
+export const baseType = (type) => (type ?? "").split(";")[0].trim().toLowerCase();
+/** "Spec.PDF" -> "pdf"; no extension -> "". */
+export function extensionOf(name) {
+    const dot = name.lastIndexOf(".");
+    return dot > 0 ? name.slice(dot + 1).toLowerCase() : "";
+}
+/** The MIME type an upload of this name is sent with, or undefined for a type the app doesn't take. */
+export function typeOfName(name) {
+    const ext = extensionOf(name);
+    return Object.hasOwn(EXTENSION_TYPES, ext) ? EXTENSION_TYPES[ext] : undefined;
+}
+/** A MIME type in words: "PDF", "Markdown", "PNG". An unknown type prints as is. */
+export const typeWords = (type) => TYPE_WORDS[baseType(type)] ?? (baseType(type) || "file");
+/** Text kinds are read by lines: text/* and JSON. */
+export const isTextType = (type) => {
+    const t = baseType(type);
+    return t.startsWith("text/") || t === "application/json";
+};
+export const isImageType = (type) => IMAGE_TYPES.includes(baseType(type));
+/** "512 B", "39 KB" (whole), "5.2 MB" (one decimal). */
+export function formatSize(bytes) {
+    if (bytes < 1024)
+        return `${bytes} B`;
+    if (bytes < 1024 * 1024)
+        return `${Math.round(bytes / 1024)} KB`;
+    return `${(bytes / (1024 * 1024)).toFixed(1)} MB`;
+}
+/** A name safe to write in one folder: no slashes, NUL, "..", or leading dots; empty becomes "file". */
+export function cleanName(name) {
+    const cleaned = name
+        .replace(/\0/g, "")
+        .replace(/[/\\]/g, "-")
+        .replace(/\.\./g, "")
+        .replace(/^[.\s]+/, "")
+        .trim();
+    return cleaned || "file";
+}
+/** "spec.pdf", n 2 -> "spec (2).pdf"; a name with no extension gets the number at the end. */
+export function numberedName(name, n) {
+    if (n === 0)
+        return name;
+    const dot = name.lastIndexOf(".");
+    return dot > 0 ? `${name.slice(0, dot)} (${n})${name.slice(dot)}` : `${name} (${n})`;
+}
+/**
+ * Writes bytes to `folder` under the cleaned name, never overwriting: a taken name gets " (1)", " (2)".
+ * The wx flag makes a race between the check and the write fail instead of overwrite.
+ */
+export async function writeNew(folder, name, bytes) {
+    const clean = cleanName(name);
+    for (let n = 0; n < 1000; n++) {
+        const path = join(folder, numberedName(clean, n));
+        let handle;
+        try {
+            handle = await open(path, constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL, 0o644);
+        }
+        catch (e) {
+            if (e.code === "EEXIST")
+                continue;
+            throw e;
+        }
+        try {
+            await handle.writeFile(bytes);
+        }
+        finally {
+            await handle.close();
+        }
+        return path;
+    }
+    throw new Error(`Too many files named '${clean}' in ${folder}.`);
+}
+const FETCH_TIMEOUT_MS = 60_000;
+/** Fetches a stored copy's bytes. The URL never goes into an error message. */
+export async function fetchBytes(url, name) {
+    let response;
+    try {
+        response = await fetch(url, { signal: AbortSignal.timeout(FETCH_TIMEOUT_MS) });
+    }
+    catch (e) {
+        const message = (e instanceof Error ? e.message : String(e)).split(url).join("the stored copy");
+        throw new Error(`Could not fetch '${name}': ${message}.`);
+    }
+    if (!response.ok)
+        throw new Error(`Could not fetch '${name}' (HTTP ${response.status}).`);
+    return new Uint8Array(await response.arrayBuffer());
+}
+//# sourceMappingURL=fileKinds.js.map

package/dist/fileKinds.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fileKinds.js","sourceRoot":"","sources":["../src/fileKinds.ts"],"names":[],"mappings":"AAAA,8GAA8G;AAC9G,8GAA8G;AAC9G,sEAAsE;AAEtE,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,MAAM,CAAC,MAAM,aAAa,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,mBAAmB;AAClE,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,CAAC;AACrC,MAAM,CAAC,MAAM,cAAc,GAAG,SAAS,CAAC,CAAC,SAAS;AAClD,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,CAAC;AACtC,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,CAAC;AAClC,MAAM,CAAC,MAAM,cAAc,GAAG,MAAM,CAAC;AACrC,MAAM,CAAC,MAAM,cAAc,GAAG,EAAE,CAAC,CAAC,uDAAuD;AACzF,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,CAAC,wDAAwD;AAE7F,6EAA6E;AAC7E,MAAM,CAAC,MAAM,cAAc,GACzB,sHAAsH,CAAC;AAEzH,2DAA2D;AAC3D,MAAM,CAAC,MAAM,eAAe,GAA2B;IACrD,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,oBAAoB;IACzB,IAAI,EAAE,yEAAyE;IAC/E,GAAG,EAAE,0BAA0B;IAC/B,IAAI,EAAE,mEAAmE;IACzE,GAAG,EAAE,YAAY;IACjB,GAAG,EAAE,UAAU;IACf,EAAE,EAAE,eAAe;IACnB,QAAQ,EAAE,eAAe;IACzB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,YAAY;IACjB,IAAI,EAAE,YAAY;IAClB,GAAG,EAAE,WAAW;IAChB,IAAI,EAAE,YAAY;IAClB,IAAI,EAAE,kBAAkB;IACxB,IAAI,EAAE,WAAW;IACjB,GAAG,EAAE,WAAW;IAChB,GAAG,EAAE,UAAU;IACf,EAAE,EAAE,iBAAiB;IACrB,GAAG,EAAE,iBAAiB;IACtB,GAAG,EAAE,iBAAiB;CACvB,CAAC;AAEF,MAAM,UAAU,GAA2B;IACzC,iBAAiB,EAAE,KAAK;IACxB,oBAAoB,EAAE,MAAM;IAC5B,yEAAyE,EAAE,MAAM;IACjF,0BAA0B,EAAE,OAAO;IACnC,mEAAmE,EAAE,OAAO;IAC5E,UAAU,EAAE,KAAK;IACjB,eAAe,EAAE,UAAU;IAC3B,YAAY,EAAE,MAAM;IACpB,kBAAkB,EAAE,MAAM;IAC1B,WAAW,EAAE,MAAM;IACnB,UAAU,EAAE,KAAK;IACjB,iBAAiB,EAAE,YAAY;IAC/B,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,MAAM;IACpB,WAAW,EAAE,KAAK;IAClB,YAAY,EAAE,MAAM;IACpB,iBAAiB,EAAE,KAAK;IACxB,8BAA8B,EAAE,KAAK;CACtC,CAAC;AAEF,MAAM,WAAW,GAAG,CAAC,WAAW,EAAE,YAAY,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;AAE3E,yDAAyD;AACzD,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAwB,EAAU,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAE9G,+CAA+C;AAC/C,MAAM,UAAU,WAAW,CAAC,IAAY;IACtC,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC1D,CAAC;AAED,uGAAuG;AACvG,MAAM,UAAU,UAAU,CAAC,IAAY;IACrC,MAAM,GAAG,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC,MAAM,CAAC,eAAe,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;AAChF,CAAC;AAED,oFAAoF;AACpF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,MAAM,CAAC,CAAC;AAE5G,qDAAqD;AACrD,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAW,EAAE;IAClD,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IACzB,OAAO,CAAC,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,kBAAkB,CAAC;AAC3D,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;AAE3F,wDAAwD;AACxD,MAAM,UAAU,UAAU,CAAC,KAAa;IACtC,IAAI,KAAK,GAAG,IAAI;QAAE,OAAO,GAAG,KAAK,IAAI,CAAC;IACtC,IAAI,KAAK,GAAG,IAAI,GAAG,IAAI;QAAE,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IACjE,OAAO,GAAG,CAAC,KAAK,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC;AACpD,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,MAAM,OAAO,GAAG,IAAI;SACjB,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC;SAClB,OAAO,CAAC,QAAQ,EAAE,GAAG,CAAC;SACtB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;SACpB,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC;SACtB,IAAI,EAAE,CAAC;IACV,OAAO,OAAO,IAAI,MAAM,CAAC;AAC3B,CAAC;AAED,8FAA8F;AAC9F,MAAM,UAAU,YAAY,CAAC,IAAY,EAAE,CAAS;IAClD,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACzB,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;IAClC,OAAO,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,KAAK,CAAC,GAAG,CAAC;AACvF,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,MAAc,EAAE,IAAY,EAAE,KAAiB;IAC5E,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC9B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,YAAY,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC;QAClD,IAAI,MAAM,CAAC;QACX,IAAI,CAAC;YACH,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,OAAO,GAAG,SAAS,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;QAC9F,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,IAAK,CAA2B,CAAC,IAAI,KAAK,QAAQ;gBAAE,SAAS;YAC7D,MAAM,CAAC,CAAC;QACV,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;QAChC,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;QACvB,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,IAAI,KAAK,CAAC,yBAAyB,KAAK,QAAQ,MAAM,GAAG,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAEhC,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,GAAW,EAAE,IAAY;IACxD,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC,CAAC;IACjF,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,OAAO,GAAG,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAChG,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,MAAM,OAAO,GAAG,CAAC,CAAC;IAC5D,CAAC;IACD,IAAI,CAAC,QAAQ,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,oBAAoB,IAAI,WAAW,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;IAC1F,OAAO,IAAI,UAAU,CAAC,MAAM,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC;AACtD,CAAC"}

package/dist/files.d.ts

@@ -0,0 +1,24 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import { type ReadPart } from "./formatFiles.js";
+type Args = Record<string, unknown>;
+/** The temp folder PDF, Word, Excel, and ZIP reads are saved to. */
+export declare const readFolder: () => string;
+/** "201-400" or "7" to a 1-based inclusive range; badly formed is bad_argument. */
+export declare function parseLines(raw: string | undefined): {
+    from: number;
+    to: number;
+};
+/** Splits text into lines on \n (a \r stays); a final newline doesn't add an empty line. */
+export declare function splitLines(text: string): string[];
+/** The asked lines, cut to 500 lines, then to 40,000 characters at a full line. */
+export declare function readPart(name: string, all: string[], asked: {
+    from: number;
+    to: number;
+}): {
+    part: ReadPart;
+    body: string;
+};
+/** The download folder: folder, else CORK_DOWNLOAD_DIR, else ~/Downloads. It must exist; it is never created. */
+export declare function downloadFolder(folder: string | undefined): Promise<string>;
+export declare function runFiles(args: Args): Promise<CallToolResult>;
+export {};