@caelo-cms/mcp-server 0.10.55 → 0.10.58

package/dist/image-upload.js

@@ -1,121 +1,47 @@
 // SPDX-License-Identifier: MPL-2.0
-/** Image upload transport shared by chat and admin MCP servers. */
+/**
+ * caelo_upload_images for the stdio shims: reads local files (or base64)
+ * and POSTs each image to the admin's `/api/mcp/images`. The per-file loop
+ * and the tool definition are shared with the admin's remote endpoint
+ * (./surfaces/upload.ts, ./tool-definitions.ts).
+ */
 import { constants } from "node:fs";
 import { open } from "node:fs/promises";
-import { basename } from "node:path";
-import { z } from "zod";
 import { resolveTimeoutMs } from "./http.js";
 import { describeIapRejection, ingressHeaders } from "./ingress-auth.js";
-const MAX_BYTES = 5 * 1024 * 1024;
-/** Uploaded media references accepted by caelo_chat; never accept object-store keys. */
-export const uploadedImageSchema = z
-    .object({
-    assetId: z.string().uuid(),
-    mime: z.enum(["image/png", "image/jpeg", "image/webp", "image/gif"]),
-    alt: z.string().max(2048).optional(),
-})
-    .strict();
-const imageInput = z
-    .object({
-    filePath: z.string().min(1).max(4096).optional(),
-    base64: z
-        .string()
-        .min(4)
-        .max(Math.ceil(MAX_BYTES / 3) * 4)
-        .regex(/^(?:[A-Za-z0-9+/]{4})*(?:[A-Za-z0-9+/]{2}==|[A-Za-z0-9+/]{3}=)?$/)
-        .optional(),
-    filename: z.string().min(1).max(512).optional(),
-    alt: z.string().max(2048).optional(),
-    reference: z.boolean().optional(),
-})
-    .strict()
-    .refine((i) => (i.filePath === undefined) !== (i.base64 === undefined), "Supply exactly one of filePath or base64");
-/** A bounded batch; each file has its own success/error result for safe retries. */
-export const uploadImagesInput = z.object({ images: z.array(imageInput).min(1).max(4) }).strict();
-/** Exposed in both MCP catalogues, including chat-scoped connections. */
-export const UPLOAD_IMAGES_TOOL = {
-    name: "caelo_upload_images",
-    description: "Upload 1–4 PNG, JPEG, WebP or GIF images (5 MiB each) to the Caelo media library. " +
-        "Prefer filePath for files on the machine running this MCP server; otherwise supply raw base64 (no data URL). " +
-        "Files become shared CMS media assets. Set reference: true for images that only guide image generation or editing " +
-        "(character sheets, style samples): they stay out of the page-image library and are never published. " +
-        "Returns attachments for caelo_chat " +
-        "or asset IDs for page tools. Uploading does not send a chat message or publish a page. " +
-        "Results are per file: retry only failures. Requires the token owner's current content.write permission.",
-    inputSchema: {
-        type: "object",
-        required: ["images"],
-        additionalProperties: false,
-        properties: {
-            images: {
-                type: "array",
-                minItems: 1,
-                maxItems: 4,
-                items: {
-                    type: "object",
-                    additionalProperties: false,
-                    properties: {
-                        filePath: {
-                            type: "string",
-                            description: "Path on the MCP server machine. Mutually exclusive with base64.",
-                        },
-                        base64: {
-                            type: "string",
-                            description: "Raw image bytes as base64. Mutually exclusive with filePath.",
-                        },
-                        filename: { type: "string", description: "Optional media filename." },
-                        alt: { type: "string", description: "Optional description of the image." },
-                        reference: {
-                            type: "boolean",
-                            description: "True for an image that only guides generation/editing; it is never placed on a page.",
-                        },
-                    },
-                    oneOf: [{ required: ["filePath"] }, { required: ["base64"] }],
-                },
-            },
-        },
-    },
-};
+import { uploadImagesWith } from "./surfaces/upload.js";
+import { MAX_IMAGE_BYTES } from "./tool-definitions.js";
+/** Read a local image file, refusing anything that is not a 1 B – 5 MiB regular file. */
+async function readLocalImage(filePath) {
+    const file = await open(filePath, constants.O_RDONLY | constants.O_NONBLOCK);
+    try {
+        const stat = await file.stat();
+        if (!stat.isFile() || stat.size === 0 || stat.size > MAX_IMAGE_BYTES)
+            throw new Error("Expected an image file of 1 byte to 5 MiB");
+        // Read at most cap+1 even if the file grows after stat().
+        const buffer = Buffer.alloc(MAX_IMAGE_BYTES + 1);
+        let total = 0;
+        while (total < buffer.length) {
+            const { bytesRead } = await file.read(buffer, total, buffer.length - total, null);
+            if (!bytesRead)
+                break;
+            total += bytesRead;
+        }
+        return buffer.subarray(0, total);
+    }
+    finally {
+        await file.close();
+    }
+}
 /** Upload caller-selected files, returning failures individually without dropping successes. */
 export async function uploadImages(opts, input) {
-    const parsed = uploadImagesInput.parse(input);
-    const results = [];
-    for (const [index, image] of parsed.images.entries()) {
-        try {
-            let bytes;
-            if (image.filePath) {
-                const file = await open(image.filePath, constants.O_RDONLY | constants.O_NONBLOCK);
-                try {
-                    const stat = await file.stat();
-                    if (!stat.isFile() || stat.size === 0 || stat.size > MAX_BYTES)
-                        throw new Error("Expected an image file of 1 byte to 5 MiB");
-                    // Read at most cap+1 even if the file grows after stat().
-                    const buffer = Buffer.alloc(MAX_BYTES + 1);
-                    let total = 0;
-                    while (total < buffer.length) {
-                        const { bytesRead } = await file.read(buffer, total, buffer.length - total, null);
-                        if (!bytesRead)
-                            break;
-                        total += bytesRead;
-                    }
-                    bytes = buffer.subarray(0, total);
-                }
-                finally {
-                    await file.close();
-                }
-            }
-            else {
-                if (image.base64 === undefined)
-                    throw new Error("Missing image bytes");
-                bytes = Buffer.from(image.base64, "base64");
-            }
-            if (!bytes.length || bytes.length > MAX_BYTES)
-                throw new Error("Image must be at most 5 MiB and non-empty");
-            const filename = image.filename ?? (image.filePath ? basename(image.filePath) : "image");
-            const query = new URLSearchParams({ filename });
-            if (image.alt)
-                query.set("alt", image.alt);
-            if (image.reference)
+    return uploadImagesWith(input, {
+        readFile: readLocalImage,
+        store: async (bytes, meta) => {
+            const query = new URLSearchParams({ filename: meta.filename });
+            if (meta.alt)
+                query.set("alt", meta.alt);
+            if (meta.reference)
                 query.set("visibility", "reference");
             const response = await fetch(`${opts.adminUrl.replace(/\/+$/, "")}/api/mcp/images?${query}`, {
                 method: "POST",
@@ -132,28 +58,8 @@ export async function uploadImages(opts, input) {
                 throw new Error(describeIapRejection(response, text) ?? `HTTP ${response.status}: ${text.slice(0, 500)}`);
             }
             const value = (await response.json());
-            const attachment = uploadedImageSchema.parse({
-                assetId: value.assetId,
-                mime: value.mime,
-                alt: image.alt ?? filename,
-            });
-            results.push({ index, attachment });
-        }
-        catch (e) {
-            results.push({ index, error: e instanceof Error ? e.message : String(e) });
-        }
-    }
-    return {
-        ...(results.every((r) => "error" in r) ? { isError: true } : {}),
-        content: [
-            {
-                type: "text",
-                text: JSON.stringify({
-                    results,
-                    attachments: results.flatMap((r) => ("attachment" in r ? [r.attachment] : [])),
-                }),
-            },
-        ],
-    };
+            return { assetId: value.assetId, mime: value.mime };
+        },
+    });
 }
 //# sourceMappingURL=image-upload.js.map

package/dist/image-upload.js.map

@@ -1 +1 @@
-{"version":3,"file":"image-upload.js","sourceRoot":"","sources":["../src/image-upload.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"image-upload.js","sourceRoot":"","sources":["../src/image-upload.ts"],"names":[],"mappings":"AAAA,mCAAmC;AAEnC;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAA2B,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAExD,yFAAyF;AACzF,KAAK,UAAU,cAAc,CAAC,QAAgB;IAC5C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,QAAQ,EAAE,SAAS,CAAC,QAAQ,GAAG,SAAS,CAAC,UAAU,CAAC,CAAC;IAC7E,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAC/B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,IAAI,CAAC,IAAI,KAAK,CAAC,IAAI,IAAI,CAAC,IAAI,GAAG,eAAe;YAClE,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;QAC/D,0DAA0D;QAC1D,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,eAAe,GAAG,CAAC,CAAC,CAAC;QACjD,IAAI,KAAK,GAAG,CAAC,CAAC;QACd,OAAO,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC;YAC7B,MAAM,EAAE,SAAS,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC;YAClF,IAAI,CAAC,SAAS;gBAAE,MAAM;YACtB,KAAK,IAAI,SAAS,CAAC;QACrB,CAAC;QACD,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;AACH,CAAC;AAED,gGAAgG;AAChG,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,IAAyC,EACzC,KAAc;IAEd,OAAO,gBAAgB,CAAC,KAAK,EAAE;QAC7B,QAAQ,EAAE,cAAc;QACxB,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE;YAC3B,MAAM,KAAK,GAAG,IAAI,eAAe,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YAC/D,IAAI,IAAI,CAAC,GAAG;gBAAE,KAAK,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC;YACzC,IAAI,IAAI,CAAC,SAAS;gBAAE,KAAK,CAAC,GAAG,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;YACzD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,mBAAmB,KAAK,EAAE,EAAE;gBAC3F,MAAM,EAAE,MAAM;gBACd,OAAO,EAAE;oBACP,GAAG,CAAC,MAAM,cAAc,EAAE,CAAC;oBAC3B,mBAAmB,EAAE,IAAI,CAAC,KAAK;oBAC/B,cAAc,EAAE,0BAA0B;iBAC3C;gBACD,IAAI,EAAE,IAAI,UAAU,CAAC,KAAK,CAAC;gBAC3B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC;aACvD,CAAC,CAAC;YACH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;gBACjB,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnC,MAAM,IAAI,KAAK,CACb,oBAAoB,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,QAAQ,QAAQ,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CACzF,CAAC;YACJ,CAAC;YACD,MAAM,KAAK,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAA4B,CAAC;YACjE,OAAO,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;QACtD,CAAC;KACF,CAAC,CAAC;AACL,CAAC"}

package/dist/index.js

@@ -22,45 +22,53 @@
  *
  * Every mode first matches its release to the admin's (#764, see
  * ./version-handshake.ts), so the `claude mcp add` command carries no
- * version and survives admin upgrades.
+ * version and survives admin upgrades. Without credentials the MCP modes
+ * start unconfigured instead (#841, see ./unconfigured.ts).
  */
 import { startAdminMcpServer } from "./admin-server.js";
 import { runExport } from "./export.js";
 import { startMcpServer } from "./server.js";
+import { missingCredentials, startUnconfiguredServer } from "./unconfigured.js";
 import { ensureAdminRelease } from "./version-handshake.js";
-const adminUrl = process.env.CAELO_ADMIN_URL;
-const token = process.env.CAELO_MCP_TOKEN;
-if (!adminUrl) {
-    console.error("CAELO_ADMIN_URL not set — point me at your admin install (e.g. https://admin.example.com)");
-    process.exit(2);
-}
-if (!token) {
-    console.error("CAELO_MCP_TOKEN not set — mint one at /settings/mcp on your admin install");
-    process.exit(2);
-}
-// #764 — run as the admin's own release (re-execs on a mismatch).
-await ensureAdminRelease({ adminUrl, token, bin: "caelo-mcp-server" });
 const command = process.argv[2];
-if (command === "export") {
-    const outFlag = process.argv.indexOf("--out");
-    const outDir = outFlag !== -1 ? process.argv[outFlag + 1] : undefined;
-    if (outFlag !== -1 && !outDir) {
-        console.error("--out needs a directory argument");
-        process.exit(2);
-    }
-    const written = await runExport({ adminUrl, token, outDir: outDir ?? process.cwd() });
-    for (const path of written)
-        console.log(path);
-    console.log(`exported ${written.length} file(s) — re-run after skills or site memory change`);
-}
-else if (command === "admin") {
-    await startAdminMcpServer({ adminUrl, token });
-}
-else if (command !== undefined) {
+if (command !== undefined && command !== "admin" && command !== "export") {
     console.error(`unknown command: ${command} (expected no command, "admin", or "export")`);
     process.exit(2);
 }
+// #841 — the MCP modes start without credentials so directories can list
+// their tools; `export` is a one-shot CLI with nothing to list, so it
+// still exits.
+const missing = missingCredentials(process.env);
+if (missing.length > 0 && command !== "export") {
+    await startUnconfiguredServer({ mode: command === "admin" ? "admin" : "chat", missing });
+}
 else {
-    await startMcpServer({ adminUrl, token });
+    const adminUrl = process.env.CAELO_ADMIN_URL;
+    const token = process.env.CAELO_MCP_TOKEN;
+    if (!adminUrl || !token) {
+        console.error(`${missing.join(" and ")} not set — export needs CAELO_ADMIN_URL and an ADMIN-scoped ` +
+            "CAELO_MCP_TOKEN minted at /settings/mcp on your admin install");
+        process.exit(2);
+    }
+    // #764 — run as the admin's own release (re-execs on a mismatch).
+    await ensureAdminRelease({ adminUrl, token, bin: "caelo-mcp-server" });
+    if (command === "export") {
+        const outFlag = process.argv.indexOf("--out");
+        const outDir = outFlag !== -1 ? process.argv[outFlag + 1] : undefined;
+        if (outFlag !== -1 && !outDir) {
+            console.error("--out needs a directory argument");
+            process.exit(2);
+        }
+        const written = await runExport({ adminUrl, token, outDir: outDir ?? process.cwd() });
+        for (const path of written)
+            console.log(path);
+        console.log(`exported ${written.length} file(s) — re-run after skills or site memory change`);
+    }
+    else if (command === "admin") {
+        await startAdminMcpServer({ adminUrl, token });
+    }
+    else {
+        await startMcpServer({ adminUrl, token });
+    }
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA,mCAAmC;AAEnC;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAE5D,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;AAC7C,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC;AAE1C,IAAI,CAAC,QAAQ,EAAE,CAAC;IACd,OAAO,CAAC,KAAK,CACX,2FAA2F,CAC5F,CAAC;IACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AACD,IAAI,CAAC,KAAK,EAAE,CAAC;IACX,OAAO,CAAC,KAAK,CAAC,2EAA2E,CAAC,CAAC;IAC3F,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,kEAAkE;AAClE,MAAM,kBAAkB,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,GAAG,EAAE,kBAAkB,EAAE,CAAC,CAAC;AAEvE,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAEhC,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;IACzB,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC9C,MAAM,MAAM,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IACtE,IAAI,OAAO,KAAK,CAAC,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;QAC9B,OAAO,CAAC,KAAK,CAAC,kCAAkC,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,SAAS,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IACtF,KAAK,MAAM,IAAI,IAAI,OAAO;QAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,CAAC,GAAG,CAAC,YAAY,OAAO,CAAC,MAAM,sDAAsD,CAAC,CAAC;AAChG,CAAC;KAAM,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;IAC/B,MAAM,mBAAmB,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AACjD,CAAC;KAAM,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;IACjC,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,8CAA8C,CAAC,CAAC;IACzF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;KAAM,CAAC;IACN,MAAM,cAAc,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;AAC5C,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/server.d.ts

@@ -7,11 +7,5 @@ export interface StartOpts {
     /** Poll interval while waiting on an approval; tests shorten it. */
     readonly approvalPollMs?: number;
 }
-/**
- * MCP `instructions` for the chat-scope server (#552), injected into the
- * connecting agent's context so it uses caelo_chat as a conversation with
- * the site's own agent rather than a one-shot command.
- */
-export declare const CHAT_MCP_INSTRUCTIONS: string;
 export declare function startMcpServer(opts: StartOpts): Promise<void>;
 //# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAiB/E,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,oEAAoE;IACpE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAED;;;;GAIG;AACH,eAAO,MAAM,qBAAqB,QAKtB,CAAC;AAsFb,wBAAsB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAgMnE"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,+CAA+C,CAAC;AAQ/E,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,4DAA4D;IAC5D,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;IAC/B,oEAAoE;IACpE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;CAClC;AAKD,wBAAsB,cAAc,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBnE"}

package/dist/server.js

@@ -1,273 +1,38 @@
 // SPDX-License-Identifier: MPL-2.0
 /**
- * MCP server construction. Registers `caelo_chat` and the image upload companion
- * and binds it to a stdio transport. Routing edits through one conversational tool is
- * deliberate: the remote agent talks to Caelo's chat-runner the same
- * way a human in the browser does. Browse / publish / propose actions
- * happen through the chat ("which pages exist?" → agent calls
- * pages.list internally → text response). Same auth surface, same
- * actor scope, same audit trail.
+ * The chat-scope stdio MCP server: `caelo_chat` plus its approval wait and
+ * the image upload companion, bound to a stdio transport. The server itself
+ * (tools, replies, approval waits) is ./surfaces/chat-surface.ts, shared
+ * with the admin's remote endpoint (issue #806); this module backs it with
+ * HTTP calls to the admin install's `/api/mcp/*` endpoints.
  */
-import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
-import { z } from "zod";
 import { resolveApprovalWaitMs } from "./approval-wait.js";
-import { describeDecisions, describeReady, describeSuperseded, describeWaiting, settleChatApprovals, } from "./chat-approval.js";
 import { fetchChatApprovalState, resumeChat, sendChat } from "./chat-bridge.js";
 import { resolveTimeoutMs } from "./http.js";
-import { UPLOAD_IMAGES_TOOL, uploadedImageSchema, uploadImages } from "./image-upload.js";
-/**
- * MCP `instructions` for the chat-scope server (#552), injected into the
- * connecting agent's context so it uses caelo_chat as a conversation with
- * the site's own agent rather than a one-shot command.
- */
-export const CHAT_MCP_INSTRUCTIONS = [
-    "This server talks to a Caelo CMS site's own AI agent through caelo_chat; describe the outcome you want and the agent decides how to build it.",
-    "Pass the chatSessionId from a reply to continue the same conversation; omit it only to start a new one.",
-    "Changes land on that chat's preview branch; nothing reaches the live site until the operator publishes in the Caelo admin. Some actions wait for the operator's approval click there.",
-    "When a reply says the turn is waiting for the operator's approval, call caelo_await_approval with the chatSessionId: it waits for the decision and returns your turn's continuation. Never re-send the request; you cannot approve anything yourself.",
-].join("\n");
-const awaitApprovalInput = z.object({ chatSessionId: z.string().uuid() }).strict();
+import { uploadImages } from "./image-upload.js";
+import { createChatMcpServer } from "./surfaces/chat-surface.js";
+import { ownVersion } from "./version-handshake.js";
 /** The resume request's timeout (`resumeChat`), reserved out of a call's budget. */
 const resumeTimeoutMs = () => resolveTimeoutMs(30_000);
-/** Headroom for the state reads around a resume in caelo_await_approval. */
-const RESUME_SLACK_MS = 5_000;
-/** Issue #658 — keep waiting on the approval cards a caelo_chat turn paused on. */
-const AWAIT_APPROVAL_TOOL = {
-    name: "caelo_await_approval",
-    description: "Wait for the operator's Approve/Reject on the approval cards your caelo_chat turn paused on, then " +
-        "continue that turn and return its reply (the change applied, or the agent's reaction to a rejection). " +
-        "Use it when a caelo_chat reply says it is still waiting for approval. You cannot approve anything " +
-        "yourself — only the operator can, in the Caelo admin.",
-    inputSchema: {
-        type: "object",
-        properties: {
-            chatSessionId: {
-                type: "string",
-                description: "The chatSessionId from the caelo_chat reply that is waiting.",
-            },
-        },
-        required: ["chatSessionId"],
-    },
-};
-/**
- * The tool result for a caelo_chat exchange: every reply in order (the first
- * turn, then each resumed one), the decisions in between, and — while cards
- * still wait — the next step.
- */
-function chatResult(first, settled, chatSessionId) {
-    const turns = first ? [first, ...settled.turns] : [...settled.turns];
-    const last = turns.at(-1);
-    const text = [
-        ...(first ? [first.assistant] : []),
-        ...(settled.decided.length > 0 ? [describeDecisions(settled.decided)] : []),
-        ...settled.turns.map((t) => t.assistant),
-        ...(settled.kind === "pending" ? [describeWaiting(chatSessionId, settled.waiting)] : []),
-        ...(settled.kind === "superseded" ? [describeSuperseded(settled.dropped)] : []),
-        ...(settled.kind === "ready" ? [describeReady(chatSessionId)] : []),
-    ]
-        .filter((t) => t.trim().length > 0)
-        .join("\n\n");
-    const reply = text.length > 0
-        ? text
-        : "Nothing of yours waits for the operator's approval in this chat; continue with caelo_chat.";
-    return {
-        content: [
-            { type: "text", text: reply },
-            {
-                type: "text",
-                text: JSON.stringify({
-                    chatSessionId,
-                    requestId: last?.requestId ?? null,
-                    toolCalls: turns.flatMap((t) => t.toolCalls),
-                    pendingProposals: last?.pendingProposals ?? 0,
-                    costMicrocents: turns.reduce((sum, t) => sum + t.costMicrocents, 0),
-                    // Non-empty while the turn waits on the operator.
-                    pendingApprovals: settled.kind === "pending"
-                        ? settled.waiting.map((a) => ({ approvalId: a.approvalId, toolName: a.toolName }))
-                        : [],
-                }, null, 2),
-            },
-        ],
-    };
-}
-const caeloChatInputSchema = z
-    .object({
-    attachments: z.array(uploadedImageSchema).max(4).optional(),
-    message: z.string().min(1).max(50_000),
-    chatSessionId: z.string().uuid().optional(),
-    pageId: z.string().uuid().optional(),
-})
-    .strict();
 export async function startMcpServer(opts) {
-    const server = new Server({
-        name: "caelo-mcp-server",
-        version: "0.1.0",
+    const target = { adminUrl: opts.adminUrl, token: opts.token };
+    const server = createChatMcpServer({
+        sendChat: (input) => sendChat({
+            ...target,
+            message: input.message,
+            ...(input.attachments ? { attachments: input.attachments } : {}),
+            ...(input.chatSessionId ? { chatSessionId: input.chatSessionId } : {}),
+            ...(input.pageId ? { pageId: input.pageId } : {}),
+        }),
+        resumeChat: (chatSessionId) => resumeChat({ ...target, chatSessionId }),
+        fetchChatApprovalState: (chatSessionId) => fetchChatApprovalState({ ...target, chatSessionId }),
+        uploadImages: (args) => uploadImages(target, args),
     }, {
-        capabilities: { tools: {} },
-        instructions: CHAT_MCP_INSTRUCTIONS,
-    });
-    server.setRequestHandler(ListToolsRequestSchema, async () => ({
-        tools: [
-            UPLOAD_IMAGES_TOOL,
-            AWAIT_APPROVAL_TOOL,
-            {
-                name: "caelo_chat",
-                description: "Talk to your Caelo CMS install's AI agent. Same agent that powers the live-edit chat overlay — it can read pages, propose edits, queue Owner-approval proposals, summarise plugin data. Continues an existing chat session (when chatSessionId is supplied) or starts a fresh one. Returns the agent's reply text plus structured tool-call summaries.",
-                inputSchema: {
-                    type: "object",
-                    required: ["message"],
-                    properties: {
-                        attachments: {
-                            type: "array",
-                            maxItems: 4,
-                            description: "Attachments returned by caelo_upload_images.",
-                            items: z.toJSONSchema(uploadedImageSchema),
-                        },
-                        message: {
-                            type: "string",
-                            description: "What you want to say to the Caelo agent.",
-                        },
-                        chatSessionId: {
-                            type: "string",
-                            description: "Optional. Chat session UUID to continue. Omit to start a fresh page-unbound chat.",
-                        },
-                        pageId: {
-                            type: "string",
-                            description: "Optional. Bind a NEW chat to one page so the agent's page-context block is populated. Same shape as /edit?page=<id>.",
-                        },
-                    },
-                },
-            },
-        ],
-    }));
-    server.setRequestHandler(CallToolRequestSchema, async (req, extra) => {
-        // Progress notifications keep progress-aware clients from timing the
-        // call out while it waits on the operator (only when they asked).
-        const progressToken = req.params._meta?.progressToken;
-        const onPending = progressToken === undefined
-            ? undefined
-            : async (elapsedMs) => {
-                await extra.sendNotification({
-                    method: "notifications/progress",
-                    params: {
-                        progressToken,
-                        progress: Math.round(elapsedMs / 1000),
-                        message: "Waiting for the operator to approve or reject in the Caelo admin…",
-                    },
-                });
-            };
-        /** Wait for the operator, then continue the paused turn (issue #658). */
-        const settle = (chatSessionId, waitMs) => settleChatApprovals({
-            chatSessionId,
-            fetchState: () => fetchChatApprovalState({ ...opts, chatSessionId }),
-            resume: () => resumeChat({ ...opts, chatSessionId }),
-            waitMs,
-            // The resume POST's whole timeout stays inside the call's budget.
-            resumeReserveMs: resumeTimeoutMs(),
-            ...(opts.approvalPollMs !== undefined ? { intervalMs: opts.approvalPollMs } : {}),
-            ...(onPending ? { onPending } : {}),
-        });
-        if (req.params.name === UPLOAD_IMAGES_TOOL.name) {
-            try {
-                return await uploadImages(opts, req.params.arguments);
-            }
-            catch (e) {
-                return { isError: true, content: [{ type: "text", text: String(e) }] };
-            }
-        }
-        if (req.params.name === AWAIT_APPROVAL_TOOL.name) {
-            const parsed = awaitApprovalInput.safeParse(req.params.arguments ?? {});
-            if (!parsed.success) {
-                return {
-                    isError: true,
-                    content: [{ type: "text", text: `invalid arguments: ${parsed.error.message}` }],
-                };
-            }
-            try {
-                // Room for at least one resume, even with a short configured wait —
-                // otherwise a decided turn could never continue.
-                const settled = await settle(parsed.data.chatSessionId, Math.max(resolveApprovalWaitMs(), resumeTimeoutMs() + RESUME_SLACK_MS));
-                return chatResult(null, settled, parsed.data.chatSessionId);
-            }
-            catch (e) {
-                const msg = e instanceof Error ? e.message : String(e);
-                return {
-                    isError: true,
-                    content: [{ type: "text", text: `caelo_await_approval failed: ${msg}` }],
-                };
-            }
-        }
-        if (req.params.name !== "caelo_chat") {
-            return {
-                isError: true,
-                content: [{ type: "text", text: `unknown tool: ${req.params.name}` }],
-            };
-        }
-        const parsed = caeloChatInputSchema.safeParse(req.params.arguments ?? {});
-        if (!parsed.success) {
-            return {
-                isError: true,
-                content: [{ type: "text", text: `invalid arguments: ${parsed.error.message}` }],
-            };
-        }
-        try {
-            const startedAt = Date.now();
-            const result = await sendChat({
-                adminUrl: opts.adminUrl,
-                token: opts.token,
-                message: parsed.data.message,
-                ...(parsed.data.attachments ? { attachments: parsed.data.attachments } : {}),
-                ...(parsed.data.chatSessionId ? { chatSessionId: parsed.data.chatSessionId } : {}),
-                ...(parsed.data.pageId ? { pageId: parsed.data.pageId } : {}),
-            });
-            // Issue #658 — the turn paused on approval cards: wait for the
-            // operator's decision within what is left of the wait bound, then
-            // continue this same turn and return its reply too.
-            if (result.pendingApprovals.length === 0) {
-                return chatResult(result, { kind: "settled", decided: [], turns: [] }, result.chatSessionId);
-            }
-            let settled;
-            try {
-                settled = await settle(result.chatSessionId, Math.max(0, resolveApprovalWaitMs() - (Date.now() - startedAt)));
-            }
-            catch (e) {
-                // The turn ran and its session exists: keep both in the result so
-                // the agent can continue with caelo_await_approval instead of
-                // retrying into duplicate work (codex review).
-                const msg = e instanceof Error ? e.message : String(e);
-                const waiting = chatResult(result, {
-                    kind: "pending",
-                    decided: [],
-                    turns: [],
-                    waiting: result.pendingApprovals.map((a) => ({
-                        ...a,
-                        status: "pending",
-                        approved: null,
-                        reason: null,
-                    })),
-                }, result.chatSessionId);
-                return {
-                    ...waiting,
-                    content: [
-                        ...waiting.content,
-                        {
-                            type: "text",
-                            text: `Checking the operator's decision failed (${msg}); the request still exists. Call caelo_await_approval with chatSessionId "${result.chatSessionId}".`,
-                        },
-                    ],
-                };
-            }
-            return chatResult(result, settled, result.chatSessionId);
-        }
-        catch (e) {
-            const msg = e instanceof Error ? e.message : String(e);
-            return {
-                isError: true,
-                content: [{ type: "text", text: `caelo_chat failed: ${msg}` }],
-            };
-        }
+        serverVersion: ownVersion(),
+        approvalWaitMs: resolveApprovalWaitMs,
+        resumeTimeoutMs,
+        ...(opts.approvalPollMs !== undefined ? { approvalPollMs: opts.approvalPollMs } : {}),
     });
     await server.connect(opts.transport ?? new StdioServerTransport());
 }