replicas-mcp 0.1.1 → 0.1.3

package/README.md

@@ -1,6 +1,8 @@
 # replicas-mcp
 
-MCP (Model Context Protocol) server for [Replicas](https://replicas.dev) - cloud workspaces for AI coding agents.
+Stdio MCP server for [Replicas](https://replicas.dev) - cloud workspaces for AI coding agents.
+
+For MCP clients that require a remote server URL instead of stdio, use the streamable HTTP endpoint at `https://api.replicas.dev/v1/mcp`.
 
 ## Installation
 
@@ -25,8 +27,9 @@ Get your API key from [Settings](https://replicas.dev/dashboard?settings=org-api
 | Tool | Description |
 |------|-------------|
 | `create_replica` | Create a new replica workspace |
-| `list_replicas` | List all replicas (paginated) |
-| `get_replica` | Get a replica by ID |
+| `list_replicas` | List all replicas (paginated) with PR info |
+| `get_replica` | Get a replica by ID with detailed info (agent, branch, diff) |
 | `send_replica_message` | Send a message to a replica |
 | `delete_replica` | Delete a replica |
 | `list_repositories` | List available repositories |
+| `read_replica_history` | Read conversation history (paginated from end) |

package/dist/index.js

@@ -1,148 +1,617 @@
 #!/usr/bin/env node
-import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
-import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
-import { z } from 'zod';
-const API_URL = process.env.REPLICAS_API_URL || 'https://api.replicas.dev';
-const API_KEY = process.env.REPLICAS_API_KEY;
+#!/usr/bin/env node
+
+// src/index.ts
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+// ../shared/src/display-message/parsers/codex-parser.ts
+function safeJsonParse(str, fallback) {
+  try {
+    return JSON.parse(str);
+  } catch {
+    return fallback;
+  }
+}
+function getStatusFromExitCode(exitCode) {
+  return exitCode === 0 ? "completed" : "failed";
+}
+function findLastMessageByType(messages, type) {
+  return messages.findLast((m) => m.type === type);
+}
+function parsePatch(input) {
+  const operations = [];
+  const lines = input.split("\n");
+  let currentOp = null;
+  let diffLines = [];
+  for (let i = 0; i < lines.length; i++) {
+    const line = lines[i];
+    if (line.startsWith("*** Add File:")) {
+      if (currentOp) {
+        if (diffLines.length > 0) currentOp.diff = diffLines.join("\n");
+        operations.push(currentOp);
+        diffLines = [];
+      }
+      currentOp = {
+        action: "add",
+        path: line.replace("*** Add File:", "").trim()
+      };
+    } else if (line.startsWith("*** Update File:")) {
+      if (currentOp) {
+        if (diffLines.length > 0) currentOp.diff = diffLines.join("\n");
+        operations.push(currentOp);
+        diffLines = [];
+      }
+      currentOp = {
+        action: "update",
+        path: line.replace("*** Update File:", "").trim()
+      };
+    } else if (line.startsWith("*** Delete File:")) {
+      if (currentOp) {
+        if (diffLines.length > 0) currentOp.diff = diffLines.join("\n");
+        operations.push(currentOp);
+        diffLines = [];
+      }
+      currentOp = {
+        action: "delete",
+        path: line.replace("*** Delete File:", "").trim()
+      };
+    } else if (line.startsWith("*** Move to:")) {
+      if (currentOp) {
+        currentOp.moveTo = line.replace("*** Move to:", "").trim();
+      }
+    } else if (line.startsWith("*** Begin Patch") || line.startsWith("*** End Patch")) {
+      continue;
+    } else if (currentOp && (line.startsWith("+") || line.startsWith("-") || line.startsWith("@@") || line.trim() === "")) {
+      diffLines.push(line);
+    }
+  }
+  if (currentOp) {
+    if (diffLines.length > 0) currentOp.diff = diffLines.join("\n");
+    operations.push(currentOp);
+  }
+  return operations;
+}
+function parseCodexEvents(events) {
+  const messages = [];
+  const pendingPatches = /* @__PURE__ */ new Map();
+  events.forEach((event) => {
+    if (event.type === "event_msg" && event.payload?.type === "user_message") {
+      messages.push({
+        id: `user-${event.timestamp}`,
+        type: "user",
+        content: event.payload.message || "",
+        timestamp: event.timestamp
+      });
+    }
+    if (event.type === "event_msg" && event.payload?.type === "agent_reasoning") {
+      messages.push({
+        id: `reasoning-${event.timestamp}-${messages.length}`,
+        type: "reasoning",
+        content: event.payload.text || "",
+        status: "completed",
+        timestamp: event.timestamp
+      });
+    }
+    if (event.type === "response_item") {
+      const payloadType = event.payload?.type;
+      if (payloadType === "message" && event.payload?.role === "assistant") {
+        const content = event.payload.content || [];
+        const textContent = content.filter((c) => c.type === "output_text").map((c) => c.text || "").join("\n");
+        if (textContent) {
+          messages.push({
+            id: `agent-${event.timestamp}`,
+            type: "agent",
+            content: textContent,
+            timestamp: event.timestamp
+          });
+        }
+      }
+      if (payloadType === "function_call" && event.payload?.name === "shell") {
+        const args = safeJsonParse(event.payload.arguments || "{}", {});
+        const command = Array.isArray(args.command) ? args.command.join(" ") : args.command || "";
+        messages.push({
+          id: `command-${event.timestamp}`,
+          type: "command",
+          command,
+          output: "",
+          // Will be filled by function_call_output
+          status: "in_progress",
+          timestamp: event.timestamp
+        });
+      }
+      if (payloadType === "function_call_output") {
+        const output = safeJsonParse(
+          event.payload.output || "{}",
+          {}
+        );
+        if (output.output !== void 0 && output.metadata) {
+          const commandMsg = findLastMessageByType(messages, "command");
+          if (commandMsg) {
+            commandMsg.output = output.output || "";
+            commandMsg.exitCode = output.metadata?.exit_code;
+            commandMsg.status = getStatusFromExitCode(output.metadata?.exit_code);
+          }
+        }
+      }
+      if (payloadType === "custom_tool_call") {
+        const callId = event.payload.call_id;
+        const name = event.payload.name;
+        const input = event.payload.input || "";
+        const status = event.payload.status || "in_progress";
+        if (name === "apply_patch") {
+          const operations = parsePatch(input);
+          pendingPatches.set(callId, { input, status, timestamp: event.timestamp, operations });
+        } else {
+          messages.push({
+            id: `toolcall-${event.timestamp}`,
+            type: "tool_call",
+            server: "custom",
+            tool: name,
+            status,
+            timestamp: event.timestamp
+          });
+        }
+      }
+      if (payloadType === "custom_tool_call_output") {
+        const callId = event.payload.call_id;
+        const output = safeJsonParse(
+          event.payload.output || "{}",
+          {}
+        );
+        const pendingPatch = pendingPatches.get(callId);
+        if (pendingPatch) {
+          messages.push({
+            id: `patch-${pendingPatch.timestamp}`,
+            type: "patch",
+            operations: pendingPatch.operations,
+            output: output.output || "",
+            exitCode: output.metadata?.exit_code,
+            status: getStatusFromExitCode(output.metadata?.exit_code),
+            timestamp: pendingPatch.timestamp
+          });
+          pendingPatches.delete(callId);
+        } else {
+          const toolCallMsg = findLastMessageByType(messages, "tool_call");
+          if (toolCallMsg) {
+            toolCallMsg.status = getStatusFromExitCode(output.metadata?.exit_code);
+          }
+        }
+      }
+      if (payloadType === "function_call" && event.payload?.name === "update_plan") {
+        const args = safeJsonParse(
+          event.payload.arguments || "{}",
+          {}
+        );
+        if (args.plan && Array.isArray(args.plan)) {
+          const todoItems = args.plan.map((item) => ({
+            text: item.step,
+            completed: item.status === "completed"
+          }));
+          messages.push({
+            id: `todo-${event.timestamp}`,
+            type: "todo_list",
+            items: todoItems,
+            status: "completed",
+            timestamp: event.timestamp
+          });
+        }
+      }
+    }
+  });
+  return messages;
+}
+
+// ../shared/src/display-message/parsers/claude-parser.ts
+function safeJsonParse2(str, fallback) {
+  try {
+    return JSON.parse(str);
+  } catch {
+    return fallback;
+  }
+}
+function extractToolResultContent(content) {
+  if (!content) return "";
+  if (typeof content === "string") return content;
+  if (Array.isArray(content)) {
+    return content.filter((item) => item.type === "text").map((item) => item.text || "").join("\n");
+  }
+  return "";
+}
+function parseClaudeEvents(events, parentToolUseId) {
+  const messages = [];
+  const filterValue = parentToolUseId !== void 0 ? parentToolUseId : null;
+  const filteredEvents = events.filter(
+    (e) => e.payload.parent_tool_use_id === filterValue
+  );
+  const toolCallMap = /* @__PURE__ */ new Map();
+  filteredEvents.forEach((event) => {
+    if (event.type === "claude-user") {
+      const content = event.payload.message?.content || [];
+      const toolResult = content.find((c) => c.type === "tool_result");
+      if (toolResult && toolResult.tool_use_id) {
+        return;
+      }
+      const textContent = content.filter((c) => c.type === "text").map((c) => c.text || "").join("\n");
+      const images = content.filter((c) => c.type === "image" && c.source).map((c) => {
+        const source = c.source;
+        return {
+          type: "image",
+          mediaType: source.media_type || "image/png",
+          data: source.data || ""
+        };
+      }).filter((img) => img.data);
+      if (textContent || images.length > 0) {
+        messages.push({
+          id: `user-${event.timestamp}`,
+          type: "user",
+          content: textContent || (images.length > 0 ? `[${images.length} image${images.length > 1 ? "s" : ""} attached]` : ""),
+          images: images.length > 0 ? images : void 0,
+          timestamp: event.timestamp
+        });
+      }
+    }
+    if (event.type === "claude-assistant") {
+      const contentBlocks = event.payload.message?.content || [];
+      contentBlocks.forEach((block) => {
+        if (block.type === "text" && block.text) {
+          messages.push({
+            id: `agent-${event.timestamp}-${messages.length}`,
+            type: "agent",
+            content: block.text,
+            timestamp: event.timestamp
+          });
+        }
+        if (block.type === "thinking" && block.text) {
+          messages.push({
+            id: `reasoning-${event.timestamp}-${messages.length}`,
+            type: "reasoning",
+            content: block.text,
+            status: "completed",
+            timestamp: event.timestamp
+          });
+        }
+        if (block.type === "tool_use" && block.id) {
+          const toolName = block.name || "unknown";
+          const toolInput = block.input || {};
+          const toolUseId = block.id;
+          toolCallMap.set(toolUseId, {
+            messageIndex: messages.length,
+            toolName,
+            input: toolInput
+          });
+          if (toolName === "Task") {
+            const inputObj = typeof toolInput === "string" ? safeJsonParse2(toolInput, {}) : toolInput;
+            const nestedEvents = events.filter((e) => e.payload.parent_tool_use_id === toolUseId).map((e) => ({
+              timestamp: e.timestamp,
+              type: e.type,
+              payload: e.payload
+            }));
+            messages.push({
+              id: `subagent-${event.timestamp}-${messages.length}`,
+              type: "subagent",
+              toolUseId,
+              description: inputObj.description || "Subagent Task",
+              prompt: inputObj.prompt || "",
+              subagentType: inputObj.subagent_type || "general",
+              model: inputObj.model,
+              status: "in_progress",
+              nestedEvents,
+              timestamp: event.timestamp
+            });
+          } else if (toolName === "Bash" || toolName === "bash" || toolName === "shell") {
+            const inputObj = typeof toolInput === "string" ? safeJsonParse2(toolInput, {}) : toolInput;
+            const command = inputObj.command || "";
+            messages.push({
+              id: `command-${event.timestamp}-${messages.length}`,
+              type: "command",
+              command,
+              output: "",
+              status: "in_progress",
+              timestamp: event.timestamp
+            });
+          } else if (toolName === "Write" || toolName === "Edit") {
+            const inputObj = typeof toolInput === "string" ? safeJsonParse2(toolInput, {}) : toolInput;
+            const filePath = inputObj.file_path || "";
+            const action = toolName === "Write" ? "add" : "update";
+            messages.push({
+              id: `file-${event.timestamp}-${messages.length}`,
+              type: "file_change",
+              changes: [{
+                path: filePath,
+                kind: action
+              }],
+              status: "in_progress",
+              timestamp: event.timestamp
+            });
+          } else if (toolName === "TodoWrite") {
+            const inputObj = typeof toolInput === "string" ? safeJsonParse2(toolInput, {}) : toolInput;
+            const todos = inputObj.todos || [];
+            const todoItems = todos.map((todo) => ({
+              text: todo.content,
+              completed: todo.status === "completed"
+            }));
+            if (todoItems.length > 0) {
+              messages.push({
+                id: `todo-${event.timestamp}-${messages.length}`,
+                type: "todo_list",
+                items: todoItems,
+                status: "completed",
+                timestamp: event.timestamp
+              });
+            }
+          } else if (toolName === "WebSearch") {
+            const inputObj = typeof toolInput === "string" ? safeJsonParse2(toolInput, {}) : toolInput;
+            const query = inputObj.query || "";
+            messages.push({
+              id: `search-${event.timestamp}-${messages.length}`,
+              type: "web_search",
+              query,
+              status: "in_progress",
+              timestamp: event.timestamp
+            });
+          } else {
+            messages.push({
+              id: `toolcall-${event.timestamp}-${messages.length}`,
+              type: "tool_call",
+              server: "claude",
+              tool: toolName,
+              input: toolInput,
+              status: "in_progress",
+              timestamp: event.timestamp
+            });
+          }
+        }
+      });
+    }
+    if (event.type === "claude-result") {
+      const payload = event.payload;
+      if (payload.is_error || payload.subtype !== "success") {
+        const errorList = payload.errors || [];
+        const errorMessage = errorList.length > 0 ? errorList.join("\n") : "Claude session encountered an unexpected error.";
+        messages.push({
+          id: `error-${event.timestamp}`,
+          type: "error",
+          message: errorMessage,
+          timestamp: event.timestamp
+        });
+      }
+    }
+  });
+  filteredEvents.forEach((event) => {
+    if (event.type === "claude-user") {
+      const content = event.payload.message?.content || [];
+      const toolResult = content.find((c) => c.type === "tool_result");
+      if (toolResult && toolResult.tool_use_id) {
+        const toolInfo = toolCallMap.get(toolResult.tool_use_id);
+        if (!toolInfo) return;
+        const resultContent = extractToolResultContent(toolResult.content);
+        const isError = toolResult.is_error || false;
+        const status = isError ? "failed" : "completed";
+        const message = messages[toolInfo.messageIndex];
+        if (!message) return;
+        if (message.type === "command") {
+          message.output = resultContent;
+          message.status = status;
+          const exitCodeMatch = resultContent.match(/exit code:?\s*(\d+)/i);
+          if (exitCodeMatch) {
+            message.exitCode = parseInt(exitCodeMatch[1], 10);
+          } else {
+            message.exitCode = isError ? 1 : 0;
+          }
+        } else if (message.type === "file_change") {
+          message.status = status;
+        } else if (message.type === "web_search") {
+          message.status = status;
+        } else if (message.type === "tool_call") {
+          message.output = resultContent;
+          message.status = status;
+        } else if (message.type === "subagent") {
+          message.output = resultContent;
+          message.status = status;
+        }
+      }
+    }
+  });
+  return messages;
+}
+
+// ../shared/src/display-message/parsers/index.ts
+function parseAgentEvents(events, agentType) {
+  if (agentType === "codex") {
+    return parseCodexEvents(events);
+  } else if (agentType === "claude") {
+    return parseClaudeEvents(events);
+  }
+  return [];
+}
+
+// src/index.ts
+var API_URL = process.env.REPLICAS_API_URL || "https://api.replicas.dev";
+var API_KEY = process.env.REPLICAS_API_KEY;
 if (!API_KEY) {
-    console.error('REPLICAS_API_KEY environment variable required');
-    process.exit(1);
+  console.error("REPLICAS_API_KEY environment variable required");
+  process.exit(1);
 }
-/**
- * Makes an authenticated request to the Replicas API.
- */
 async function api(method, path, body) {
-    const res = await fetch(`${API_URL}${path}`, {
-        method,
-        headers: {
-            'Authorization': `Bearer ${API_KEY}`,
-            'Content-Type': 'application/json',
-        },
-        body: body ? JSON.stringify(body) : undefined,
-    });
-    if (!res.ok) {
-        const text = await res.text();
-        throw new Error(`API error ${res.status}: ${text}`);
-    }
-    return res.json();
+  const res = await fetch(`${API_URL}${path}`, {
+    method,
+    headers: {
+      "Authorization": `Bearer ${API_KEY}`,
+      "Content-Type": "application/json"
+    },
+    body: body ? JSON.stringify(body) : void 0
+  });
+  if (!res.ok) {
+    const text = await res.text();
+    throw new Error(`API error ${res.status}: ${text}`);
+  }
+  return res.json();
 }
-/**
- * Creates a tool result with text content.
- */
 function result(data, isError = false) {
-    return {
-        content: [{
-                type: 'text',
-                text: typeof data === 'string' ? data : JSON.stringify(data, null, 2),
-            }],
-        ...(isError && { isError: true }),
-    };
+  return {
+    content: [{
+      type: "text",
+      text: typeof data === "string" ? data : JSON.stringify(data, null, 2)
+    }],
+    ...isError && { isError: true }
+  };
 }
-const server = new McpServer({
-    name: 'replicas-mcp',
-    version: '0.1.0',
+var server = new McpServer({
+  name: "replicas-mcp",
+  version: "0.1.1"
 });
-const registerTool = server.registerTool.bind(server);
-registerTool('create_replica', {
-    description: 'Create a new replica workspace and send initial message',
+var registerTool = server.registerTool.bind(server);
+registerTool(
+  "create_replica",
+  {
+    description: "Create a new replica workspace and send initial message",
     inputSchema: {
-        name: z.string(),
-        message: z.string(),
-        repository: z.string(),
-        instance_type: z.enum(['standard', 'large', 'power']).optional(),
-        coding_agent: z.enum(['claude', 'codex']).optional(),
-    },
-}, async (args) => {
-    try {
-        const body = {
-            name: args.name,
-            message: args.message,
-            repository: args.repository,
-        };
-        if (args.instance_type)
-            body.instance_type = args.instance_type;
-        if (args.coding_agent)
-            body.coding_agent = args.coding_agent;
-        return result(await api('POST', '/v1/replica', body));
+      name: z.string(),
+      message: z.string(),
+      repository: z.string(),
+      instance_type: z.enum(["standard", "large", "power"]).optional(),
+      coding_agent: z.enum(["claude", "codex"]).optional()
     }
-    catch (e) {
-        return result(e instanceof Error ? e.message : String(e), true);
+  },
+  async (args) => {
+    try {
+      const body = {
+        name: args.name,
+        message: args.message,
+        repository: args.repository
+      };
+      if (args.instance_type) body.instance_type = args.instance_type;
+      if (args.coding_agent) body.coding_agent = args.coding_agent;
+      return result(await api("POST", "/v1/replica", body));
+    } catch (e) {
+      return result(e instanceof Error ? e.message : String(e), true);
     }
-});
-registerTool('list_replicas', {
-    description: 'List all replicas',
+  }
+);
+registerTool(
+  "list_replicas",
+  {
+    description: "List all replicas",
     inputSchema: {
-        page: z.number().optional(),
-        limit: z.number().optional(),
-    },
-}, async (args) => {
-    try {
-        const params = new URLSearchParams();
-        if (args.page)
-            params.set('page', String(args.page));
-        if (args.limit)
-            params.set('limit', String(args.limit));
-        const q = params.toString();
-        return result(await api('GET', `/v1/replica${q ? '?' + q : ''}`));
+      page: z.number().optional(),
+      limit: z.number().optional()
     }
-    catch (e) {
-        return result(e instanceof Error ? e.message : String(e), true);
+  },
+  async (args) => {
+    try {
+      const params = new URLSearchParams();
+      if (args.page) params.set("page", String(args.page));
+      if (args.limit) params.set("limit", String(args.limit));
+      const q = params.toString();
+      return result(await api("GET", `/v1/replica${q ? "?" + q : ""}`));
+    } catch (e) {
+      return result(e instanceof Error ? e.message : String(e), true);
     }
-});
-registerTool('get_replica', {
-    description: 'Get replica by ID',
+  }
+);
+registerTool(
+  "get_replica",
+  {
+    description: "Get replica by ID",
     inputSchema: {
-        id: z.string(),
-    },
-}, async (args) => {
-    try {
-        return result(await api('GET', `/v1/replica/${args.id}`));
+      id: z.string()
     }
-    catch (e) {
-        return result(e instanceof Error ? e.message : String(e), true);
+  },
+  async (args) => {
+    try {
+      return result(await api("GET", `/v1/replica/${args.id}`));
+    } catch (e) {
+      return result(e instanceof Error ? e.message : String(e), true);
     }
-});
-registerTool('send_replica_message', {
-    description: 'Send message to a replica',
+  }
+);
+registerTool(
+  "send_replica_message",
+  {
+    description: "Send message to a replica",
     inputSchema: {
-        id: z.string(),
-        message: z.string(),
-        coding_agent: z.enum(['claude', 'codex']).optional(),
-    },
-}, async (args) => {
-    try {
-        const body = { message: args.message };
-        if (args.coding_agent)
-            body.coding_agent = args.coding_agent;
-        return result(await api('POST', `/v1/replica/${args.id}/send`, body));
+      id: z.string(),
+      message: z.string(),
+      coding_agent: z.enum(["claude", "codex"]).optional()
     }
-    catch (e) {
-        return result(e instanceof Error ? e.message : String(e), true);
+  },
+  async (args) => {
+    try {
+      const body = { message: args.message };
+      if (args.coding_agent) body.coding_agent = args.coding_agent;
+      return result(await api("POST", `/v1/replica/${args.id}/send`, body));
+    } catch (e) {
+      return result(e instanceof Error ? e.message : String(e), true);
     }
-});
-registerTool('delete_replica', {
-    description: 'Delete a replica',
+  }
+);
+registerTool(
+  "delete_replica",
+  {
+    description: "Delete a replica",
     inputSchema: {
-        id: z.string(),
-    },
-}, async (args) => {
-    try {
-        return result(await api('DELETE', `/v1/replica/${args.id}`));
+      id: z.string()
     }
-    catch (e) {
-        return result(e instanceof Error ? e.message : String(e), true);
+  },
+  async (args) => {
+    try {
+      return result(await api("DELETE", `/v1/replica/${args.id}`));
+    } catch (e) {
+      return result(e instanceof Error ? e.message : String(e), true);
     }
-});
-registerTool('list_repositories', {
-    description: 'List available repositories',
-}, async () => {
+  }
+);
+registerTool(
+  "list_repositories",
+  {
+    description: "List available repositories"
+  },
+  async () => {
     try {
-        return result(await api('GET', '/v1/repositories'));
+      return result(await api("GET", "/v1/repositories"));
+    } catch (e) {
+      return result(e instanceof Error ? e.message : String(e), true);
     }
-    catch (e) {
-        return result(e instanceof Error ? e.message : String(e), true);
+  }
+);
+registerTool(
+  "read_replica_history",
+  {
+    description: "Read conversation history of a replica. Returns parsed DisplayMessage objects (user messages, agent responses, commands, file changes, tool calls, etc). If the workspace is sleeping, it will be woken and you should retry in 30-90 seconds.",
+    inputSchema: {
+      id: z.string(),
+      limit: z.number().optional().describe("Maximum number of events to return"),
+      offset: z.number().optional().describe("Number of events to skip from the end")
     }
-});
-const transport = new StdioServerTransport();
+  },
+  async (args) => {
+    try {
+      const params = new URLSearchParams();
+      if (args.limit) params.set("limit", String(args.limit));
+      if (args.offset) params.set("offset", String(args.offset));
+      const q = params.toString();
+      const response = await api("GET", `/v1/replica/${args.id}/read${q ? "?" + q : ""}`);
+      if (response.waking) {
+        return result({
+          status: "waking",
+          message: "Workspace is waking from sleep. Retry in 30-90 seconds."
+        });
+      }
+      const agentType = response.coding_agent || "claude";
+      const messages = parseAgentEvents(response.events, agentType);
+      return result({
+        thread_id: response.thread_id,
+        coding_agent: response.coding_agent,
+        total: response.total,
+        hasMore: response.hasMore,
+        messages
+      });
+    } catch (e) {
+      return result(e instanceof Error ? e.message : String(e), true);
+    }
+  }
+);
+var transport = new StdioServerTransport();
 await server.connect(transport);
-//# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "replicas-mcp",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "license": "UNLICENSED",
   "type": "module",
   "main": "dist/index.js",
@@ -8,7 +8,7 @@
     "replicas-mcp": "dist/index.js"
   },
   "scripts": {
-    "build": "tsc",
+    "build": "tsup",
     "start": "node dist/index.js"
   },
   "dependencies": {
@@ -16,7 +16,9 @@
     "zod": "^3.25.0"
   },
   "devDependencies": {
+    "@replicas/shared": "*",
     "@types/node": "^20.11.17",
-    "typescript": "^5.8.3"
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3"
   }
 }

package/src/index.ts

@@ -4,6 +4,7 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
 import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+import { parseAgentEvents, type AgentType, type ReadReplicaHistoryResponse } from '@replicas/shared';
 
 const API_URL = process.env.REPLICAS_API_URL || 'https://api.replicas.dev';
 const API_KEY = process.env.REPLICAS_API_KEY;
@@ -58,7 +59,7 @@ type RegisterToolFn = (
 
 const server = new McpServer({
   name: 'replicas-mcp',
-  version: '0.1.0',
+  version: '0.1.1',
 });
 
 const registerTool = server.registerTool.bind(server) as RegisterToolFn;
@@ -182,5 +183,47 @@ registerTool(
   }
 );
 
+registerTool(
+  'read_replica_history',
+  {
+    description: 'Read conversation history of a replica. Returns parsed DisplayMessage objects (user messages, agent responses, commands, file changes, tool calls, etc). If the workspace is sleeping, it will be woken and you should retry in 30-90 seconds.',
+    inputSchema: {
+      id: z.string(),
+      limit: z.number().optional().describe('Maximum number of events to return'),
+      offset: z.number().optional().describe('Number of events to skip from the end'),
+    },
+  },
+  async (args) => {
+    try {
+      const params = new URLSearchParams();
+      if (args.limit) params.set('limit', String(args.limit));
+      if (args.offset) params.set('offset', String(args.offset));
+      const q = params.toString();
+      const response = await api<ReadReplicaHistoryResponse>('GET', `/v1/replica/${args.id}/read${q ? '?' + q : ''}`);
+
+      if (response.waking) {
+        return result({
+          status: 'waking',
+          message: 'Workspace is waking from sleep. Retry in 30-90 seconds.',
+        });
+      }
+
+      // Parse raw events into DisplayMessage format
+      const agentType = (response.coding_agent || 'claude') as AgentType;
+      const messages = parseAgentEvents(response.events, agentType);
+
+      return result({
+        thread_id: response.thread_id,
+        coding_agent: response.coding_agent,
+        total: response.total,
+        hasMore: response.hasMore,
+        messages,
+      });
+    } catch (e) {
+      return result(e instanceof Error ? e.message : String(e), true);
+    }
+  }
+);
+
 const transport = new StdioServerTransport();
 await server.connect(transport);

package/tsup.config.ts

@@ -0,0 +1,24 @@
+const config = {
+  entry: ['src/index.ts'],
+  format: ['esm'],
+  bundle: true,
+  noExternal: ['@replicas/shared'],
+  dts: false,
+  clean: true,
+  outDir: 'dist',
+  banner: {
+    js: '#!/usr/bin/env node',
+  },
+  outExtension() {
+    return {
+      js: '.js',
+    };
+  },
+  esbuildOptions(options: { alias?: Record<string, string> }) {
+    options.alias = {
+      '@replicas/shared': '../shared/src',
+    };
+  },
+};
+
+export default config;

package/dist/index.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};

package/dist/index.js.map

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