@stage-labs/metro 0.1.0-beta.274 → 0.1.0-beta.276

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stage-labs/metro",
-  "version": "0.1.0-beta.274",
+  "version": "0.1.0-beta.276",
   "description": "The metro command line: run your agent on this machine, relaying its chat channels and connectors to Claude Code.",
   "license": "MIT",
   "repository": {

package/runtime/marketplace/plugin/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "metro",
-  "version": "0.1.0-beta.274",
+  "version": "0.1.0-beta.276",
   "description": "Metro for Claude Code, installed by the metro daemon on this machine: every connector the agent holds as its own MCP server relayed through the daemon, the orchestrator-only guard on the main thread, and the standing rules loaded at each session start. No vendor credential ever sits in a config file.",
   "author": {
     "name": "Bonustrack",

package/runtime/node_modules/@metro-labs/core/src/stations/attachments.ts

@@ -106,9 +106,16 @@ export const saveBufferToCache = async (
   meta: { mime?: string; name?: string },
 ): Promise<SavedAttachment> => {
   assertAttachmentSize(data.length);
-  const { writeFile } = await import('node:fs/promises');
+  const { writeFile, rename, rm } = await import('node:fs/promises');
+  const { randomUUID } = await import('node:crypto');
   const path = await cachePathFor(messageId, index, meta);
-  await writeFile(path, data);
+  const part = `${await cachePathFor(randomUUID(), index, meta)}.part`;
+  try {
+    await writeFile(part, data);
+    await rename(part, path);
+  } finally {
+    await rm(part, { force: true });
+  }
   return { path, mime: meta.mime, name: meta.name, bytes: data.length };
 };
 

package/runtime/node_modules/@metro-labs/xmtp/src/actions-conv.ts

@@ -1,8 +1,8 @@
 import { IdentifierKind, type DecodedMessage } from '@xmtp/node-sdk';
-import { accountForCall, convOf, lineOf, parseLine } from './accounts.js';
+import { accountForCall, convOf, lineOf, type Account } from './accounts.js';
 import { respond } from '@metro-labs/core/stations/station-runtime';
 import { resolveMsgId } from './wire.js';
-import { TrainError } from '@metro-labs/core/train-error';
+import { serializeTrainError, TrainError } from '@metro-labs/core/train-error';
 import {
   buildGroupInfo,
   buildMemberList,
@@ -17,6 +17,7 @@ import { updateChannelMeta } from './actions-meta.js';
 import { deletedByRequests, isDeleteRequest, superAdminCheck } from './delete-requests.js';
 import { isCallSignal } from './codecs.js';
 import { syncConversation } from './network.js';
+import { readAttachments } from './read-attachments.js';
 
 type Args = Record<string, unknown>;
 type Handler = (id: string, args: Args) => Promise<void>;
@@ -56,27 +57,41 @@ function textOf(m: DecodedMessage): string {
 
 const DELETED = { text: '[deletedMessage]', contentType: 'deletedMessage' };
 
+function messageOf(acct: Account, m: DecodedMessage, deleted: Set<string>): Record<string, unknown> {
+  return {
+    id: m.id,
+    ts: new Date(Number(m.sentAtNs / 1_000_000n)).toISOString(),
+    from: `metro://xmtp/${acct.cfg.id}/user/${m.senderInboxId}`,
+    ...(m.senderInboxId === acct.inboxId ? { self: true } : {}),
+    ...(deleted.has(m.id) ? DELETED : { text: textOf(m), contentType: m.contentType?.typeId ?? 'unknown' }),
+  };
+}
+
 async function read(id: string, args: Args): Promise<void> {
-  const { line, limit, before } = args as { line: string; limit?: number; before?: string };
+  const { line, limit, before, messageId } = args as { line: string; limit?: number; before?: string; messageId?: string };
   const { acct, conv } = await convOf(line);
   if (!conv)
     throw new TrainError('NOT_FOUND', `conversation not found for ${line}`);
-  const lim = Math.min(Math.max(1, limit ?? 20), 200);
   await syncConversation(acct.client, conv);
   const all = await conv.messages();
+  if (messageId) {
+    const target = resolveMsgId(messageId);
+    const message = acct.client.conversations.getMessageById(target);
+    if (message?.conversationId !== conv.id || isDeleteRequest(message) || isCallSignal(message))
+      throw new TrainError('NOT_FOUND', `message ${messageId} is not in this conversation`);
+    const deleted = deletedByRequests([...all, message], superAdminCheck(conv));
+    try {
+      const attachments = deleted.has(message.id) ? [] : await readAttachments(message);
+      respond(id, { result: { line, account: acct.cfg.id, message: { ...messageOf(acct, message, deleted), attachments } } });
+    } catch (error) {
+      respond(id, serializeTrainError(error));
+    }
+    return;
+  }
+  const lim = Math.min(Math.max(1, limit ?? 20), 200);
   const deleted = deletedByRequests(all, superAdminCheck(conv));
   const slice = upTo(all.filter((m) => !isDeleteRequest(m) && !isCallSignal(m)), before).slice(-lim);
-  const parsed = parseLine(line);
-  if (!parsed)
-    throw new TrainError('NOT_FOUND', `could not parse line ${line}`);
-  const acctId = parsed.accountId;
-  const messages = slice.map((m) => ({
-    id: m.id,
-    ts: new Date(Number(m.sentAtNs / 1_000_000n)).toISOString(),
-    from: `metro://xmtp/${acctId}/user/${m.senderInboxId}`,
-    ...(m.senderInboxId === acct.inboxId ? { self: true } : {}),
-    ...(deleted.has(m.id) ? DELETED : { text: textOf(m), contentType: m.contentType?.typeId ?? 'unknown' }),
-  }));
+  const messages = slice.map((m) => messageOf(acct, m, deleted));
   respond(id, { result: { line, count: messages.length, messages } });
 }
 

package/runtime/node_modules/@metro-labs/xmtp/src/read-attachments.ts

@@ -0,0 +1,37 @@
+import type { DecodedMessage } from '@xmtp/node-sdk';
+import { kindOf } from '@metro-labs/core/stations/attachments';
+import { saveInlineAttachment, saveRemoteAttachment, type RemoteEntry, type SavedAttachment } from './attachments.js';
+
+interface ReadAttachment {
+  name?: string;
+  mime?: string;
+  kind: string;
+  size: number;
+  local_path: string;
+}
+
+function fileOf(saved: SavedAttachment): ReadAttachment {
+  return {
+    name: saved.name,
+    mime: saved.mime,
+    kind: kindOf(saved.mime ?? '', saved.path),
+    size: saved.bytes,
+    local_path: saved.path,
+  };
+}
+
+export async function readAttachments(message: DecodedMessage): Promise<ReadAttachment[]> {
+  const type = message.contentType?.typeId;
+  if (type === 'attachment') {
+    const content = message.content as { filename?: string; mimeType?: string; content: Uint8Array };
+    return [fileOf(await saveInlineAttachment(content, message.id))];
+  }
+  if (type === 'remoteStaticAttachment')
+    return [fileOf(await saveRemoteAttachment(message.content as RemoteEntry, message.id))];
+  if (type === 'multiRemoteStaticAttachment' || type === 'multiRemoteAttachment') {
+    const content = message.content as { attachments: RemoteEntry[] };
+    return Promise.all(content.attachments.map(async (entry, index) =>
+      fileOf(await saveRemoteAttachment(entry, message.id, index))));
+  }
+  return [];
+}

package/runtime/node_modules/@metro-labs/xmtp/src/station.ts

@@ -7,6 +7,7 @@ export const xmtpStation: Station = {
   hasAccounts: true,
   hasTrain: true,
   messageVerbs: new Set<Verb>(['send', 'reply', 'react', 'unreact', 'delete', 'read']),
+  readFilters: new Set(['message_id']),
   groupOps: new Set<GroupOp>(['create_group', 'add_members', 'remove_members']),
   attachmentMode: 'native',
   profileFields: new Set<ProfileField>(PROFILE_FIELDS),

package/runtime/runtime.json

@@ -1,3 +1,3 @@
 {
-  "version": "0.1.0-beta.274"
+  "version": "0.1.0-beta.276"
 }

package/runtime/sdk-runner/node_modules/@metro-labs/core/src/stations/attachments.ts

@@ -106,9 +106,16 @@ export const saveBufferToCache = async (
   meta: { mime?: string; name?: string },
 ): Promise<SavedAttachment> => {
   assertAttachmentSize(data.length);
-  const { writeFile } = await import('node:fs/promises');
+  const { writeFile, rename, rm } = await import('node:fs/promises');
+  const { randomUUID } = await import('node:crypto');
   const path = await cachePathFor(messageId, index, meta);
-  await writeFile(path, data);
+  const part = `${await cachePathFor(randomUUID(), index, meta)}.part`;
+  try {
+    await writeFile(part, data);
+    await rename(part, path);
+  } finally {
+    await rm(part, { force: true });
+  }
   return { path, mime: meta.mime, name: meta.name, bytes: data.length };
 };
 

package/runtime/sdk-runner/runner.json

@@ -1,5 +1,5 @@
 {
-  "version": "0.1.0-beta.274",
+  "version": "0.1.0-beta.276",
   "dependencies": {
     "@anthropic-ai/claude-agent-sdk": "0.3.287",
     "@modelcontextprotocol/sdk": "^1.29.0",