@roamcode.ai/server 1.0.0 → 1.0.2

package/dist/mcp-send.js

@@ -1,107 +1,93 @@
-/**
- * mcp-send — a stdio MCP server that lets Claude proactively SEND a file or image to the user's chat.
- *
- * roamcode spawns this as `claude`'s MCP subprocess (via --mcp-config). It exposes two tools
- * (send_image / send_file); on a call it POSTs the file PATH to roamcode's
- * `POST /sessions/:id/attach`, which validates the path (fsRoot+realpath) and pushes an `attachment`
- * frame over the session's WebSocket so the web renders it (image inline, file as a download).
- *
- * The connection params arrive via env, with Claude supplying RC_TOKEN directly and Codex supplying a
- * provider-owned RC_TOKEN_FILE. No ANTHROPIC_API_KEY, no @anthropic-ai dependency — only the MCP SDK + zod.
- */
-import { lstatSync, readFileSync } from "node:fs";
-import { basename, isAbsolute } from "node:path";
+#!/usr/bin/env node
+
+// src/mcp-send.ts
+import { lstatSync, readFileSync } from "fs";
+import { basename, isAbsolute } from "path";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 function readTokenFile(path) {
-    try {
-        if (!isAbsolute(path))
-            return undefined;
-        const info = lstatSync(path);
-        if (!info.isFile() || info.isSymbolicLink() || (info.mode & 0o077) !== 0 || info.size < 1 || info.size > 4096) {
-            return undefined;
-        }
-        if (typeof process.getuid === "function" && info.uid !== process.getuid())
-            return undefined;
-        const token = readFileSync(path, "utf8");
-        return token.length <= 4096 && !/[\p{Cc}\p{Zl}\p{Zp}]/u.test(token) ? token : undefined;
-    }
-    catch {
-        return undefined;
+  try {
+    if (!isAbsolute(path)) return void 0;
+    const info = lstatSync(path);
+    if (!info.isFile() || info.isSymbolicLink() || (info.mode & 63) !== 0 || info.size < 1 || info.size > 4096) {
+      return void 0;
     }
+    if (typeof process.getuid === "function" && info.uid !== process.getuid()) return void 0;
+    const token = readFileSync(path, "utf8");
+    return token.length <= 4096 && !/[\p{Cc}\p{Zl}\p{Zp}]/u.test(token) ? token : void 0;
+  } catch {
+    return void 0;
+  }
 }
 function textResult(text, isError = false) {
-    return isError ? { content: [{ type: "text", text }], isError: true } : { content: [{ type: "text", text }] };
+  return isError ? { content: [{ type: "text", text }], isError: true } : { content: [{ type: "text", text }] };
 }
-/**
- * Pure, unit-testable core: POST the attachment to roamcode and map the response to a tool-result.
- * NEVER throws — a bad path, a down server, or a network error all return an `isError` tool-result so
- * Claude learns it failed and can tell the user. `fetchImpl` is injectable for tests (defaults to fetch).
- */
-export async function deliver(env, args, fetchImpl = fetch) {
-    const { RC_BASE_URL, RC_SESSION_ID } = env;
-    const token = env.RC_TOKEN || (env.RC_TOKEN_FILE ? readTokenFile(env.RC_TOKEN_FILE) : undefined);
-    if (!RC_BASE_URL || !RC_SESSION_ID || !token) {
-        return textResult("Attachment delivery is not configured (RC_BASE_URL / RC_SESSION_ID / RC_TOKEN missing).", true);
-    }
-    const url = `${RC_BASE_URL}/sessions/${RC_SESSION_ID}/attach`;
-    let res;
+async function deliver(env, args, fetchImpl = fetch) {
+  const { RC_BASE_URL, RC_SESSION_ID } = env;
+  const token = env.RC_TOKEN || (env.RC_TOKEN_FILE ? readTokenFile(env.RC_TOKEN_FILE) : void 0);
+  if (!RC_BASE_URL || !RC_SESSION_ID || !token) {
+    return textResult("Attachment delivery is not configured (RC_BASE_URL / RC_SESSION_ID / RC_TOKEN missing).", true);
+  }
+  const url = `${RC_BASE_URL}/sessions/${RC_SESSION_ID}/attach`;
+  let res;
+  try {
+    res = await fetchImpl(url, {
+      method: "POST",
+      headers: { authorization: `Bearer ${token}`, "content-type": "application/json" },
+      body: JSON.stringify({ path: args.path, caption: args.caption, kind: args.kind })
+    });
+  } catch (err) {
+    return textResult(`Could not reach roamcode to send the file: ${err.message}`, true);
+  }
+  if (!res.ok) {
+    let detail = `HTTP ${res.status}`;
     try {
-        res = await fetchImpl(url, {
-            method: "POST",
-            headers: { authorization: `Bearer ${token}`, "content-type": "application/json" },
-            body: JSON.stringify({ path: args.path, caption: args.caption, kind: args.kind }),
-        });
+      const body = await res.json();
+      if (typeof body.error === "string") detail = body.error;
+    } catch {
     }
-    catch (err) {
-        return textResult(`Could not reach roamcode to send the file: ${err.message}`, true);
-    }
-    if (!res.ok) {
-        // Surface the server's error body (e.g. "path is outside the allowed root") so Claude can explain it.
-        let detail = `HTTP ${res.status}`;
-        try {
-            const body = (await res.json());
-            if (typeof body.error === "string")
-                detail = body.error;
-        }
-        catch {
-            // non-JSON error body — keep the status code detail
-        }
-        return textResult(`Failed to send ${basename(args.path)}: ${detail}`, true);
-    }
-    return textResult(`Sent ${basename(args.path)} to the user.`);
+    return textResult(`Failed to send ${basename(args.path)}: ${detail}`, true);
+  }
+  return textResult(`Sent ${basename(args.path)} to the user.`);
 }
-const SEND_PARAMS = {
-    path: z.string().describe("Absolute path to the file to send."),
-    caption: z.string().optional().describe("Optional caption shown with the file in the chat."),
+var SEND_PARAMS = {
+  path: z.string().describe("Absolute path to the file to send."),
+  caption: z.string().optional().describe("Optional caption shown with the file in the chat.")
 };
-/** Build the MCP server with the two send tools wired to `deliver`. Reads env lazily per call. */
-export function createMcpSendServer(env = process.env) {
-    const server = new McpServer({ name: "roamcode-send", version: "0.0.0" });
-    server.registerTool("send_image", {
-        description: "Send an IMAGE to the user's chat so they can see it inline. Use when the user asks you to " +
-            "show/send an image, or to deliver a generated image. `path` must be an absolute path to the file.",
-        inputSchema: SEND_PARAMS,
-    }, async ({ path, caption }) => deliver(env, { path, caption, kind: "image" }));
-    server.registerTool("send_file", {
-        description: "Send a FILE to the user's chat as a download. Use when the user asks you to send/deliver a " +
-            "file. `path` must be an absolute path.",
-        inputSchema: SEND_PARAMS,
-    }, async ({ path, caption }) => deliver(env, { path, caption, kind: "file" }));
-    return server;
+function createMcpSendServer(env = process.env) {
+  const server = new McpServer({ name: "roamcode-send", version: "0.0.0" });
+  server.registerTool(
+    "send_image",
+    {
+      description: "Send an IMAGE to the user's chat so they can see it inline. Use when the user asks you to show/send an image, or to deliver a generated image. `path` must be an absolute path to the file.",
+      inputSchema: SEND_PARAMS
+    },
+    async ({ path, caption }) => deliver(env, { path, caption, kind: "image" })
+  );
+  server.registerTool(
+    "send_file",
+    {
+      description: "Send a FILE to the user's chat as a download. Use when the user asks you to send/deliver a file. `path` must be an absolute path.",
+      inputSchema: SEND_PARAMS
+    },
+    async ({ path, caption }) => deliver(env, { path, caption, kind: "file" })
+  );
+  return server;
 }
-/** Run the stdio server when executed directly (node dist/mcp-send.js). */
 async function main() {
-    const server = createMcpSendServer();
-    const transport = new StdioServerTransport();
-    await server.connect(transport);
+  const server = createMcpSendServer();
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
 }
-// Only run when invoked as the entry script, not when imported by a test.
 if (process.argv[1] && import.meta.url === new URL(`file://${process.argv[1]}`).href) {
-    main().catch((err) => {
-        // A stdio MCP server must keep stdout clean (it is the JSON-RPC channel) — log to stderr.
-        process.stderr.write(`mcp-send failed to start: ${err.message}\n`);
-        process.exit(1);
-    });
+  main().catch((err) => {
+    process.stderr.write(`mcp-send failed to start: ${err.message}
+`);
+    process.exit(1);
+  });
 }
+export {
+  createMcpSendServer,
+  deliver
+};