@netique/overleaf-mcp 0.1.0

package/dist/tools/compile.js

@@ -0,0 +1,188 @@
+import { z } from "zod";
+import { asJson, olGet, olPostJson, expectOk } from "../api/http.js";
+import { getActiveProject, setLastCompile } from "../session/activeProject.js";
+import { logger } from "../util/logger.js";
+const Schema = z.object({
+    root_doc: z
+        .string()
+        .optional()
+        .describe("Project-relative path to use as the LaTeX root (e.g. 'main.tex'). Defaults to the project's configured root doc."),
+    draft: z
+        .boolean()
+        .default(false)
+        .describe("Draft mode — faster but uses placeholder images for figures."),
+    stop_on_first_error: z
+        .boolean()
+        .default(false)
+        .describe("Stop on the first LaTeX error instead of continuing to produce a partial PDF."),
+});
+function summarizeErrors(log) {
+    if (!log)
+        return { errors: [], warnings: 0 };
+    const errors = [];
+    let warnings = 0;
+    for (const line of log.split("\n")) {
+        if (/^! /.test(line))
+            errors.push(line.trim());
+        else if (/warning/i.test(line))
+            warnings++;
+    }
+    return { errors: errors.slice(0, 20), warnings };
+}
+// Build the GET-able URL for an output file from a compile response, including
+// the clsiserverid + compileGroup query params CLSI requires.
+function buildOutputUrl(file, last) {
+    const params = new URLSearchParams();
+    if (last.clsiServerId)
+        params.set("clsiserverid", last.clsiServerId);
+    if (last.compileGroup)
+        params.set("compileGroup", last.compileGroup);
+    const base = file.url.replace(/^\/+/, "");
+    const sep = base.includes("?") ? "&" : "?";
+    const qs = params.toString();
+    return qs ? `${base}${sep}${qs}` : base;
+}
+async function fetchOutputLog(last) {
+    const logFile = last.outputFiles?.find((f) => f.path === "output.log");
+    if (!logFile)
+        return undefined;
+    const path = buildOutputUrl(logFile, last);
+    const res = await olGet(path);
+    await expectOk(res, `GET ${path}`);
+    return await res.text();
+}
+export function registerCompile(server) {
+    server.registerTool("compile", {
+        title: "Compile the open Overleaf project",
+        description: "Triggers a LaTeX compile on Overleaf's CLSI, then fetches `output.log` and returns a unified summary: " +
+            "status, whether a PDF was produced, error_count (parsed `! `-prefixed log lines), warning_count, first error lines, output file list, timings. " +
+            "Note: Overleaf returns status:\"success\" even when LaTeX has errors (PDF is still generated under nonstopmode). " +
+            "The truthful 'did it build cleanly?' check is `error_count === 0`. " +
+            "Use `read_log` for the full log when more context is needed.",
+        inputSchema: Schema.shape,
+    }, async (args) => {
+        const ap = getActiveProject();
+        if (!ap) {
+            return { content: [{ type: "text", text: "No project is open. Call open_project first." }], isError: true };
+        }
+        try {
+            const body = {
+                check: "silent",
+                draft: args.draft,
+                incrementalCompilesEnabled: true,
+                rootResourcePath: args.root_doc ?? null,
+                stopOnFirstError: args.stop_on_first_error,
+            };
+            const res = await olPostJson(`project/${ap.projectId}/compile?auto_compile=true`, body);
+            const result = await asJson(res, `POST project/${ap.projectId}/compile`);
+            setLastCompile(result);
+            const pdf = result.outputFiles?.find((f) => f.path === "output.pdf");
+            const logFile = result.outputFiles?.find((f) => f.path === "output.log");
+            let errorCount = 0;
+            let warningCount = 0;
+            let errorLines = [];
+            let logBytes = 0;
+            if (logFile) {
+                try {
+                    const log = await fetchOutputLog(result);
+                    if (log) {
+                        logBytes = log.length;
+                        const summarized = summarizeErrors(log);
+                        errorLines = summarized.errors;
+                        errorCount = errorLines.length;
+                        warningCount = summarized.warnings;
+                    }
+                }
+                catch (logErr) {
+                    logger.warn("compile: log fetch failed; not fatal", logErr instanceof Error ? logErr.message : logErr);
+                }
+            }
+            const summary = {
+                status: result.status ?? "unknown",
+                built_cleanly: errorCount === 0 && Boolean(pdf),
+                pdf_available: Boolean(pdf),
+                error_count: errorCount,
+                warning_count: warningCount,
+                first_errors: errorLines.slice(0, 5),
+                log_bytes: logBytes,
+                compile_time_ms: result.timings?.compile,
+                total_time_ms: result.timings?.compileE2E,
+                output_files: (result.outputFiles ?? []).map((f) => f.path),
+            };
+            const headline = summary.built_cleanly
+                ? `Built cleanly. PDF produced, 0 LaTeX errors.`
+                : errorCount > 0
+                    ? `LaTeX errors detected (${errorCount}). ${pdf ? "Partial PDF produced." : "No PDF."} First error: ${errorLines[0] ?? "(see read_log)"}`
+                    : !pdf
+                        ? `No PDF produced. status=${summary.status}.`
+                        : `Compile status: ${summary.status}.`;
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `${headline} ` +
+                            (summary.compile_time_ms ? `Compile took ${summary.compile_time_ms}ms. ` : "") +
+                            (warningCount ? `${warningCount} warning(s). ` : "") +
+                            (errorCount > 0 ? `Use \`read_log\` for full log.` : ""),
+                    },
+                ],
+                structuredContent: summary,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.error("compile failed", msg);
+            return { content: [{ type: "text", text: `Compile failed: ${msg}` }], isError: true };
+        }
+    });
+}
+export function registerReadLog(server) {
+    server.registerTool("read_log", {
+        title: "Read the last compile's output.log",
+        description: "Returns the full LaTeX log from the most recent `compile` call. " +
+            "`compile` already includes the error count + first few errors in its response — use this only when you need more context (full log, line numbers, package warnings, etc.). " +
+            "Includes a summary of `!`-prefixed error lines at the top, then the full log (truncated to the last 8000 chars).",
+        inputSchema: {},
+        annotations: { readOnlyHint: true },
+    }, async () => {
+        const ap = getActiveProject();
+        if (!ap)
+            return { content: [{ type: "text", text: "No project is open." }], isError: true };
+        const last = ap.lastCompile;
+        if (!last) {
+            return { content: [{ type: "text", text: "No compile has been run for the open project yet. Call `compile` first." }], isError: true };
+        }
+        const logFile = last.outputFiles?.find((f) => f.path === "output.log");
+        if (!logFile) {
+            return { content: [{ type: "text", text: "The last compile produced no output.log (it may have failed before reaching LaTeX)." }], isError: true };
+        }
+        try {
+            const fullLog = await fetchOutputLog(last);
+            if (fullLog == null) {
+                return { content: [{ type: "text", text: "No output.log available." }], isError: true };
+            }
+            const { errors, warnings } = summarizeErrors(fullLog);
+            const tail = fullLog.length > 8000 ? fullLog.slice(-8000) : fullLog;
+            const errorBlock = errors.length
+                ? `=== ${errors.length} error line(s) ===\n${errors.join("\n")}\n\n`
+                : "=== no '! ' error lines ===\n\n";
+            const text = errorBlock +
+                (fullLog.length > 8000 ? `=== output.log (last 8000 of ${fullLog.length} chars) ===\n` : "=== output.log ===\n") +
+                tail;
+            return {
+                content: [{ type: "text", text }],
+                structuredContent: {
+                    log_bytes: fullLog.length,
+                    error_lines: errors,
+                    warning_count: warnings,
+                },
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.error("read_log failed", msg);
+            return { content: [{ type: "text", text: `Failed to fetch output.log: ${msg}` }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=compile.js.map

package/dist/tools/compile.js.map

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

package/dist/tools/editFile.js

@@ -0,0 +1,123 @@
+import { z } from "zod";
+import { applyOtUpdate, getActiveSocket } from "../api/socket.js";
+import { getIdentity } from "../session/identity.js";
+import { ensureDocLoaded, updateDoc } from "../session/docCache.js";
+import { findByPath, getActiveProject } from "../session/activeProject.js";
+import { textToOps } from "../ot/diff.js";
+import { generateIdSeed } from "../ot/trackedChanges.js";
+import { logger } from "../util/logger.js";
+const Schema = z.object({
+    path: z
+        .string()
+        .min(1)
+        .optional()
+        .describe("Project-relative path of the doc to edit, e.g. 'main.tex' or 'chapters/intro.tex'. If omitted, defaults to the project's root doc."),
+    new_content: z
+        .string()
+        .describe("Desired full content of the file. The server computes a diff against the current content and submits the minimal OT operation."),
+    expected_version: z
+        .number()
+        .int()
+        .optional()
+        .describe("Optional safety check. If provided and the doc's current version differs, the edit is rejected."),
+    track: z
+        .enum(["auto", "on", "off"])
+        .default("on")
+        .describe("Tracked-changes mode. Default is 'on' — every edit lands as a pending suggestion in Overleaf's Review panel, which is what collaborators expect for an agent. Set 'off' explicitly to make a direct (untracked) edit. 'auto' tracks only when the project has track-changes enabled for this user."),
+});
+export function registerEditFile(server) {
+    server.registerTool("edit_file", {
+        title: "Edit a .tex doc in the open Overleaf project",
+        description: "Replaces the contents of a doc by computing a minimal diff and submitting it as an OT operation " +
+            "over the live Socket.IO connection. The change lands in the web editor in real time. " +
+            "By default the edit appears as a pending suggestion in the Review panel (track:'on'); pass track:'off' to write directly. " +
+            "If `path` is omitted, defaults to the project's root doc. " +
+            "Only .tex / .bib / .md / similar text docs are editable — binary files are not.",
+        inputSchema: Schema.shape,
+    }, async (args) => {
+        const ap = getActiveProject();
+        if (!ap) {
+            return { content: [{ type: "text", text: "No project is open. Call open_project first." }], isError: true };
+        }
+        const resolvedPath = args.path ?? ap.rootDocPath;
+        if (!resolvedPath) {
+            return { content: [{ type: "text", text: "No path provided and the project has no configured root doc. Pass a `path`." }], isError: true };
+        }
+        const entity = findByPath(resolvedPath);
+        if (!entity) {
+            return {
+                content: [{ type: "text", text: `Path not found in project: '${resolvedPath}'. Use list_files to inspect available paths.` }],
+                isError: true,
+            };
+        }
+        if (entity.kind !== "doc") {
+            return { content: [{ type: "text", text: `'${resolvedPath}' is a ${entity.kind}, not an editable doc.` }], isError: true };
+        }
+        try {
+            const cached = await ensureDocLoaded(entity.id);
+            if (args.expected_version !== undefined && cached.version !== args.expected_version) {
+                return {
+                    content: [{ type: "text", text: `Version mismatch: cached version is ${cached.version}, you provided ${args.expected_version}. Re-read the file and retry.` }],
+                    isError: true,
+                };
+            }
+            const ops = textToOps(cached.text, args.new_content);
+            if (ops.length === 0) {
+                return {
+                    content: [{ type: "text", text: "No-op: new_content is identical to the current doc." }],
+                    structuredContent: { path: entity.path, doc_id: entity.id, version: cached.version, ops_applied: 0 },
+                };
+            }
+            const identity = await getIdentity();
+            const sock = getActiveSocket();
+            const shouldTrack = args.track === "on" ? true : args.track === "off" ? false : ap.trackChangesOnForMe;
+            const meta = {
+                source: sock?.publicId ?? "overleaf-mcp",
+                ts: Date.now(),
+                user_id: identity.userId,
+            };
+            if (shouldTrack)
+                meta.tc = generateIdSeed();
+            const update = {
+                doc: entity.id,
+                op: ops,
+                v: cached.version,
+                meta,
+            };
+            await applyOtUpdate(entity.id, update);
+            const newVersion = cached.version + 1;
+            updateDoc(entity.id, args.new_content, newVersion);
+            const insertedChars = ops.reduce((n, op) => n + (op.i?.length ?? 0), 0);
+            const deletedChars = ops.reduce((n, op) => n + (op.d?.length ?? 0), 0);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Applied ${ops.length} op(s) to '${entity.path}' (+${insertedChars} / -${deletedChars} chars). ` +
+                            `Doc version ${cached.version} -> ${newVersion}. ` +
+                            (shouldTrack
+                                ? "Submitted as tracked changes — should appear as a pending suggestion in Overleaf's review panel."
+                                : "Submitted as a direct edit (no tracking)."),
+                    },
+                ],
+                structuredContent: {
+                    path: entity.path,
+                    doc_id: entity.id,
+                    ops_applied: ops.length,
+                    chars_inserted: insertedChars,
+                    chars_deleted: deletedChars,
+                    version_before: cached.version,
+                    version_after: newVersion,
+                    tracked: shouldTrack,
+                    track_mode: args.track,
+                },
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.error("edit_file failed", msg);
+            return { content: [{ type: "text", text: `Failed to edit '${args.path}': ${msg}` }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=editFile.js.map

package/dist/tools/editFile.js.map

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

package/dist/tools/listFiles.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+import { getActiveProject } from "../session/activeProject.js";
+const Schema = z.object({
+    kind: z
+        .enum(["all", "doc", "file", "folder"])
+        .default("all")
+        .describe("Filter by entity kind. 'doc' = editable .tex/.md files, 'file' = binary assets (images, PDFs), 'folder' = directories."),
+    path_contains: z.string().optional().describe("Case-insensitive substring filter on the project-relative path."),
+});
+export function registerListFiles(server) {
+    server.registerTool("list_files", {
+        title: "List files in the open Overleaf project",
+        description: "Returns the file tree of the currently open project as a flat list of project-relative paths. " +
+            "Cheap — uses cached data from open_project, no network. " +
+            "Each entity has a path (e.g. 'chapters/intro.tex'), an id, and a kind ('doc' | 'file' | 'folder').",
+        inputSchema: Schema.shape,
+        annotations: { readOnlyHint: true, idempotentHint: true },
+    }, async (args) => {
+        const ap = getActiveProject();
+        if (!ap) {
+            return {
+                content: [{ type: "text", text: "No project is open. Call open_project first." }],
+                isError: true,
+            };
+        }
+        let entities = ap.entities;
+        if (args.kind !== "all")
+            entities = entities.filter((e) => e.kind === args.kind);
+        if (args.path_contains) {
+            const needle = args.path_contains.toLowerCase();
+            entities = entities.filter((e) => e.path.toLowerCase().includes(needle));
+        }
+        entities = [...entities].sort((a, b) => a.path.localeCompare(b.path));
+        const lines = entities.map((e) => `${e.kind.padEnd(6)} ${e.path}`);
+        const text = lines.length === 0 ? "(no entities matched)" : lines.join("\n");
+        return {
+            content: [{ type: "text", text }],
+            structuredContent: { project_id: ap.projectId, count: entities.length, entities },
+        };
+    });
+}
+//# sourceMappingURL=listFiles.js.map

package/dist/tools/listFiles.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listFiles.js","sourceRoot":"","sources":["../../src/tools/listFiles.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAE/D,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACtB,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC;SACtC,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,wHAAwH,CAAC;IACrI,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iEAAiE,CAAC;CACjH,CAAC,CAAC;AAEH,MAAM,UAAU,iBAAiB,CAAC,MAAiB;IACjD,MAAM,CAAC,YAAY,CACjB,YAAY,EACZ;QACE,KAAK,EAAE,yCAAyC;QAChD,WAAW,EACT,gGAAgG;YAChG,0DAA0D;YAC1D,oGAAoG;QACtG,WAAW,EAAE,MAAM,CAAC,KAAK;QACzB,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE;KAC1D,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,MAAM,EAAE,GAAG,gBAAgB,EAAE,CAAC;QAC9B,IAAI,CAAC,EAAE,EAAE,CAAC;YACR,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,8CAA8C,EAAE,CAAC;gBACjF,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;QACD,IAAI,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC;QAC3B,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK;YAAE,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC;QACjF,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC;YAChD,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;QAC3E,CAAC;QACD,QAAQ,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACtE,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC7E,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;YACjC,iBAAiB,EAAE,EAAE,UAAU,EAAE,EAAE,CAAC,SAAS,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE;SAClF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/listProjects.js

@@ -0,0 +1,88 @@
+import { z } from "zod";
+import { asJson, olGet, olPostJson } from "../api/http.js";
+import { normalizeProject } from "../api/types.js";
+import { logger } from "../util/logger.js";
+async function fetchProjects() {
+    // POST /api/project is the dashboard XHR — returns lastUpdated, owner, etc.
+    // GET /user/projects exists on older / self-hosted Overleaf but returns a
+    // minimal payload (id + name + accessLevel only). Prefer the rich endpoint.
+    let raw;
+    const r1 = await olPostJson("api/project", {});
+    if (r1.ok) {
+        raw = (await r1.json()).projects;
+    }
+    else if (r1.status === 404 || r1.status === 405) {
+        const r2 = await olGet("user/projects");
+        raw = (await asJson(r2, "GET /user/projects")).projects;
+    }
+    else {
+        await asJson(r1, "POST /api/project");
+    }
+    if (!raw)
+        return [];
+    return raw.map(normalizeProject).sort((a, b) => {
+        const ta = a.lastUpdated ? Date.parse(a.lastUpdated) : 0;
+        const tb = b.lastUpdated ? Date.parse(b.lastUpdated) : 0;
+        return tb - ta;
+    });
+}
+const FilterSchema = z.object({
+    include_archived: z
+        .boolean()
+        .default(false)
+        .describe("Include archived projects in the result (default: false)."),
+    include_trashed: z
+        .boolean()
+        .default(false)
+        .describe("Include trashed projects in the result (default: false)."),
+    name_contains: z
+        .string()
+        .optional()
+        .describe("Case-insensitive substring filter on project name."),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(500)
+        .default(30)
+        .describe("Maximum number of projects to return, after sorting by most recently updated (default: 30)."),
+});
+export function registerListProjects(server) {
+    server.registerTool("list_projects", {
+        title: "List Overleaf projects",
+        description: "Lists projects on the configured Overleaf account, sorted by most recently updated. " +
+            "Returns each project's id, name, last update time, and owner. " +
+            "Use the returned id with `open_project` to start working on a project.",
+        inputSchema: FilterSchema.shape,
+        annotations: { readOnlyHint: true, idempotentHint: true },
+    }, async (args) => {
+        try {
+            let projects = await fetchProjects();
+            const totalBeforeFilter = projects.length;
+            if (!args.include_archived)
+                projects = projects.filter((p) => !p.archived);
+            if (!args.include_trashed)
+                projects = projects.filter((p) => !p.trashed);
+            if (args.name_contains) {
+                const needle = args.name_contains.toLowerCase();
+                projects = projects.filter((p) => p.name.toLowerCase().includes(needle));
+            }
+            const truncated = projects.length > args.limit;
+            const shown = projects.slice(0, args.limit);
+            const payload = { count: shown.length, total_matched: projects.length, total_account: totalBeforeFilter, truncated, projects: shown };
+            return {
+                content: [{ type: "text", text: JSON.stringify(payload, null, 2) }],
+                structuredContent: payload,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.error("list_projects failed", msg);
+            return {
+                content: [{ type: "text", text: `Failed to list projects: ${msg}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=listProjects.js.map

package/dist/tools/listProjects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"listProjects.js","sourceRoot":"","sources":["../../src/tools/listProjects.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAwC,MAAM,iBAAiB,CAAC;AACzF,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAM3C,KAAK,UAAU,aAAa;IAC1B,4EAA4E;IAC5E,0EAA0E;IAC1E,4EAA4E;IAC5E,IAAI,GAA6B,CAAC;IAClC,MAAM,EAAE,GAAG,MAAM,UAAU,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAC/C,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC;QACV,GAAG,GAAI,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAsB,CAAC,QAAQ,CAAC;IACzD,CAAC;SAAM,IAAI,EAAE,CAAC,MAAM,KAAK,GAAG,IAAI,EAAE,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;QAClD,MAAM,EAAE,GAAG,MAAM,KAAK,CAAC,eAAe,CAAC,CAAC;QACxC,GAAG,GAAG,CAAC,MAAM,MAAM,CAAmB,EAAE,EAAE,oBAAoB,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC5E,CAAC;SAAM,CAAC;QACN,MAAM,MAAM,CAAC,EAAE,EAAE,mBAAmB,CAAC,CAAC;IACxC,CAAC;IACD,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,OAAO,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QAC7C,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,MAAM,EAAE,GAAG,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzD,OAAO,EAAE,GAAG,EAAE,CAAC;IACjB,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,gBAAgB,EAAE,CAAC;SAChB,OAAO,EAAE;SACT,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,2DAA2D,CAAC;IACxE,eAAe,EAAE,CAAC;SACf,OAAO,EAAE;SACT,OAAO,CAAC,KAAK,CAAC;SACd,QAAQ,CAAC,0DAA0D,CAAC;IACvE,aAAa,EAAE,CAAC;SACb,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,oDAAoD,CAAC;IACjE,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,CAAC;SACN,GAAG,CAAC,GAAG,CAAC;SACR,OAAO,CAAC,EAAE,CAAC;SACX,QAAQ,CAAC,6FAA6F,CAAC;CAC3G,CAAC,CAAC;AAEH,MAAM,UAAU,oBAAoB,CAAC,MAAiB;IACpD,MAAM,CAAC,YAAY,CACjB,eAAe,EACf;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,sFAAsF;YACtF,gEAAgE;YAChE,wEAAwE;QAC1E,WAAW,EAAE,YAAY,CAAC,KAAK;QAC/B,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE;KAC1D,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,IAAI,CAAC;YACH,IAAI,QAAQ,GAAG,MAAM,aAAa,EAAE,CAAC;YACrC,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC;YAC1C,IAAI,CAAC,IAAI,CAAC,gBAAgB;gBAAE,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;YAC3E,IAAI,CAAC,IAAI,CAAC,eAAe;gBAAE,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC;YACzE,IAAI,IAAI,CAAC,aAAa,EAAE,CAAC;gBACvB,MAAM,MAAM,GAAG,IAAI,CAAC,aAAa,CAAC,WAAW,EAAE,CAAC;gBAChD,QAAQ,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;YAC3E,CAAC;YACD,MAAM,SAAS,GAAG,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC;YAC/C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;YAC5C,MAAM,OAAO,GAAG,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,aAAa,EAAE,QAAQ,CAAC,MAAM,EAAE,aAAa,EAAE,iBAAiB,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;YACtI,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;gBACnE,iBAAiB,EAAE,OAAO;aAC3B,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,MAAM,CAAC,KAAK,CAAC,sBAAsB,EAAE,GAAG,CAAC,CAAC;YAC1C,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,4BAA4B,GAAG,EAAE,EAAE,CAAC;gBACpE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/openProject.js

@@ -0,0 +1,58 @@
+import { z } from "zod";
+import { open } from "../session/activeProject.js";
+import { logger } from "../util/logger.js";
+const Schema = z.object({
+    project_id: z
+        .string()
+        .min(8)
+        .describe("The Overleaf project id, from list_projects (a hex string like '61d853bcbf1003100e957034')."),
+});
+export function registerOpenProject(server) {
+    server.registerTool("open_project", {
+        title: "Open Overleaf project",
+        description: "Joins the project's real-time Socket.IO session and caches its file tree. " +
+            "Must be called before list_files / read_file / edit_file. " +
+            "Switching projects automatically closes the previous session.",
+        inputSchema: Schema.shape,
+    }, async (args) => {
+        try {
+            const p = await open(args.project_id);
+            const project = p.project;
+            const summary = {
+                project_id: p.projectId,
+                name: p.name,
+                root_doc_path: p.rootDocPath,
+                root_doc_id: p.rootDocId,
+                entity_count: p.entities.length,
+                docs: p.entities.filter((e) => e.kind === "doc").length,
+                files: p.entities.filter((e) => e.kind === "file").length,
+                folders: p.entities.filter((e) => e.kind === "folder").length,
+                track_changes_on_for_me: p.trackChangesOnForMe,
+                compiler: project.compiler,
+                spell_check_language: project.spellCheckLanguage,
+                public_access_level: project.publicAccesLevel,
+                owner: project.owner ? { email: project.owner.email, name: [project.owner.first_name, project.owner.last_name].filter(Boolean).join(" ") || undefined } : undefined,
+                members: (project.members ?? []).map((m) => ({ email: m.email, name: [m.first_name, m.last_name].filter(Boolean).join(" ") || undefined, privileges: m.privileges })),
+            };
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Opened "${p.name}" (${summary.docs} docs, ${summary.files} files, ${summary.folders} folders). ` +
+                            `Track changes ${summary.track_changes_on_for_me ? "is ON" : "is OFF"} for this user. ` +
+                            `Root doc: ${p.rootDocPath ?? "(unset)"}. ` +
+                            `Compiler: ${summary.compiler ?? "(default)"}. ` +
+                            `Use list_files to browse, read_file/edit_file to read+write (path defaults to the root doc).`,
+                    },
+                ],
+                structuredContent: summary,
+            };
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            logger.error("open_project failed", msg);
+            return { content: [{ type: "text", text: `Failed to open project: ${msg}` }], isError: true };
+        }
+    });
+}
+//# sourceMappingURL=openProject.js.map

package/dist/tools/openProject.js.map

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