@stage-labs/metro 0.1.0-beta.281 → 0.1.0-beta.283

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stage-labs/metro",
-  "version": "0.1.0-beta.281",
+  "version": "0.1.0-beta.283",
   "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.281",
+  "version": "0.1.0-beta.283",
   "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/daemon/src/channels/inbound.ts

@@ -11,6 +11,7 @@ import { replyMeta } from './addressed.js';
 import {
   capSet,
   displayNameMeta,
+  missingAttachmentNames,
   senderMeta,
   tsMeta,
   takeMediaCtx,
@@ -56,6 +57,7 @@ interface InboundDeps {
 }
 
 const ATTACH_TIMEOUT_MS = 15_000;
+const LATE_ATTACH_WINDOW_MS = 15 * 60_000;
 const DEDUPE_TTL_MS = 30_000;
 const DEDUPE_MAX = 2_000;
 const ALLOWED_LINES_MAX = 2_000;
@@ -149,27 +151,24 @@ export class InboundRelay {
   private async flushPendingFallback(id: string): Promise<void> {
     const e = this.pendingAttachments.get(id);
     if (!e) return;
-    this.pendingAttachments.delete(id);
-    const missing = e.attachments.filter((_, i) => !e.saved.has(i));
-    if (!missing.length) return;
-    const names = missing
-      .map((a) => a.name ?? a.kind ?? 'attachment')
-      .join(', ');
+    const missing = missingAttachmentNames(e);
+    if (!missing.length) {
+      this.pendingAttachments.delete(id);
+      return;
+    }
+    e.timer = setTimeout(() => { this.pendingAttachments.delete(id); }, LATE_ATTACH_WINDOW_MS);
+    const ctx = takeMediaCtx(e);
     await this.notify('notifications/claude/channel', {
       content:
-        (e.text ? `${e.text}\n` : '') +
-        `[attachment(s) could not be fetched in time: ${names}]`,
+        (ctx.text ? `${ctx.text}\n` : '') +
+        `[attachment(s) still downloading: ${missing.join(', ')}; they follow in a separate note]`,
       meta: {
-        line: e.line,
-        from: e.from,
-        station: e.station,
-        ...tsMeta(e.ts),
-        message_id: e.messageId,
-        line_name: e.lineName,
-        from_name: e.fromName,
-        ...displayNameMeta(e.fromDisplayName),
-        ...e.reply,
-        ...e.callMeta?.(),
+        line: ctx.line,
+        from: ctx.from,
+        station: ctx.station,
+        ...senderMeta(ctx),
+        ...ctx.reply,
+        ...ctx.callMeta?.(),
       },
     });
   }

package/runtime/node_modules/@metro-labs/daemon/src/channels/pending.ts

@@ -62,6 +62,12 @@ export const senderMeta = (c: MediaCtx): Record<string, string> => ({
   ...displayNameMeta(c.fromDisplayName),
 });
 
+export function missingAttachmentNames(buf: PendingMsg): string[] {
+  return buf.attachments
+    .filter((_, i) => !buf.saved.has(i))
+    .map((a) => a.name ?? a.kind ?? 'attachment');
+}
+
 export function takeMediaCtx(buf: PendingMsg): MediaCtx {
   const ctx: MediaCtx = {
     line: buf.line,

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

@@ -12,8 +12,22 @@ import { errMsg } from '@metro-labs/core/log';
 
 export type { SavedAttachment };
 
-export const REMOTE_FETCH_ATTEMPTS = 3;
-const REMOTE_FETCH_BACKOFF_MS = 400;
+interface FetchSchedule {
+  delaysMs: readonly number[];
+  requestTimeoutMs: number;
+}
+
+const READ_SCHEDULE: FetchSchedule = { delaysMs: [400, 800], requestTimeoutMs: 9_000 };
+export const INBOUND_FETCH_SCHEDULE: FetchSchedule = {
+  delaysMs: [
+    2_000, 4_000, 8_000, 15_000, 30_000, 30_000,
+    60_000, 60_000, 60_000, 60_000, 60_000, 60_000,
+  ],
+  requestTimeoutMs: 120_000,
+};
+export const REMOTE_FETCH_ATTEMPTS = READ_SCHEDULE.delaysMs.length + 1;
+const SWARM_FALLBACK_GATEWAY = 'https://download.gateway.ethswarm.org/bzz/';
+const SWARM_BZZ_URL = /^https:\/\/[^/]+\/bzz\/([0-9a-f]{64}(?:[0-9a-f]{64})?)\/?$/i;
 
 const sleep = (ms: number): Promise<void> =>
   new Promise((resolve) => setTimeout(resolve, ms));
@@ -74,22 +88,56 @@ interface DecodedAttachment {
   data: Uint8Array;
 }
 
-async function loadRemote(r: RemoteEntry): Promise<DecodedAttachment> {
+function remoteUrls(url: string): string[] {
+  const ref = SWARM_BZZ_URL.exec(url)?.[1];
+  if (ref === undefined) return [url];
+  const fallback = `${SWARM_FALLBACK_GATEWAY}${ref.toLowerCase()}/`;
+  return url.toLowerCase().replace(/\/?$/, '/') === fallback ? [url] : [url, fallback];
+}
+
+function withTimeout<T>(work: Promise<T>, ms: number, url: string): Promise<T> {
+  let timer: ReturnType<typeof setTimeout> | undefined;
+  const expired = new Promise<never>((_resolve, reject) => {
+    timer = setTimeout(() => {
+      reject(new Error(`no answer from ${url} within ${ms / 1000}s`));
+    }, ms);
+  });
+  return Promise.race([work, expired]).finally(() => {
+    clearTimeout(timer);
+  });
+}
+
+function loadFrom(r: RemoteEntry, url: string, timeoutMs: number): Promise<DecodedAttachment> {
+  return withTimeout(
+    RemoteAttachmentCodec.load<DecodedAttachment>(
+      { ...toRemoteDescriptor(r), url },
+      loadRegistry,
+    ),
+    timeoutMs,
+    url,
+  );
+}
+
+async function loadRemote(
+  r: RemoteEntry,
+  schedule: FetchSchedule,
+): Promise<DecodedAttachment> {
+  const urls = remoteUrls(r.url);
   let last = '';
-  for (let attempt = 1; attempt <= REMOTE_FETCH_ATTEMPTS; attempt += 1) {
-    try {
-      return await RemoteAttachmentCodec.load<DecodedAttachment>(
-        toRemoteDescriptor(r),
-        loadRegistry,
-      );
-    } catch (err) {
-      last = errMsg(err);
-      if (attempt < REMOTE_FETCH_ATTEMPTS)
-        await sleep(REMOTE_FETCH_BACKOFF_MS * attempt);
+  for (const delay of [0, ...schedule.delaysMs]) {
+    if (delay > 0) await sleep(delay);
+    const errors: string[] = [];
+    for (const url of urls) {
+      try {
+        return await loadFrom(r, url, schedule.requestTimeoutMs);
+      } catch (err) {
+        errors.push(errMsg(err));
+      }
     }
+    last = errors.join('; ');
   }
   throw new Error(
-    `xmtp remote attachment fetch failed after ${REMOTE_FETCH_ATTEMPTS} attempts: ${last}`,
+    `xmtp remote attachment fetch failed after ${schedule.delaysMs.length + 1} attempts: ${last}`,
   );
 }
 
@@ -97,9 +145,10 @@ export async function saveRemoteAttachment(
   r: RemoteEntry,
   messageId: string,
   index = 0,
+  schedule: FetchSchedule = READ_SCHEDULE,
 ): Promise<SavedAttachment> {
   if (r.contentLength) assertAttachmentSize(r.contentLength);
-  const decoded = await loadRemote(r);
+  const decoded = await loadRemote(r, schedule);
   return saveBufferToCache(decoded.data, messageId, index, {
     mime: decoded.mimeType,
     name: decoded.filename ?? r.filename,

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

@@ -3,6 +3,7 @@ import type { Reply } from '@xmtp/content-type-reply';
 import { errMsg } from '@metro-labs/core/log';
 import { transcribeAndEmit } from './transcribe.js';
 import {
+  INBOUND_FETCH_SCHEDULE,
   saveInlineAttachment,
   saveRemoteAttachment,
   type RemoteEntry,
@@ -207,7 +208,7 @@ function remoteStaticPayload(
   ctx: EnvelopeCtx,
 ): Record<string, unknown> {
   const kind = IMG_RE.test(c.url) ? 'image' : 'file';
-  reportAttachment(saveRemoteAttachment(c, ctx.msgId, 0), { station: 'xmtp', account: ctx.accountId, line: ctx.line, forId: ctx.baseId, index: 0 });
+  reportAttachment(saveRemoteAttachment(c, ctx.msgId, 0, INBOUND_FETCH_SCHEDULE), { station: 'xmtp', account: ctx.accountId, line: ctx.line, forId: ctx.baseId, index: 0 });
   return {
     ...base,
     text: `[${kind}: ${c.filename ?? c.url}]`,
@@ -223,7 +224,7 @@ function multiRemoteEnvelope(
 ): Record<string, unknown> {
   const m = c as { attachments?: RemoteEntry[] };
   (Array.isArray(m.attachments) ? m.attachments : []).forEach((r, i) => {
-    reportAttachment(saveRemoteAttachment(r, ctx.msgId, i), { station: 'xmtp', account: ctx.accountId, line: ctx.line, forId: ctx.baseId, index: i });
+    reportAttachment(saveRemoteAttachment(r, ctx.msgId, i, INBOUND_FETCH_SCHEDULE), { station: 'xmtp', account: ctx.accountId, line: ctx.line, forId: ctx.baseId, index: i });
   });
   return multiRemotePayload(base, typeId, c);
 }

package/runtime/runtime.json

@@ -1,3 +1,3 @@
 {
-  "version": "0.1.0-beta.281"
+  "version": "0.1.0-beta.283"
 }

package/runtime/sdk-runner/runner.json

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