@stage-labs/metro 0.1.0-beta.21 → 0.1.0-beta.211

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

@@ -1,7 +1,6 @@
-import type { StationTool } from '@metro-labs/mcp/stations/types';
+import type { StationTool } from '@metro-labs/core/stations/types';
 import {
   str,
-  createChannel,
   setChannelMetadata,
   xmtpSendAttachments,
 } from './tools-handlers.js';
@@ -15,43 +14,9 @@ const lineProp = {
 } as const;
 
 export const XMTP_TOOLS: StationTool[] = [
-  {
-    name: 'create_channel',
-    description:
-      'Create a new XMTP group conversation (channel). Args: addresses (required, array of ' +
-      'Ethereum 0x addresses to add as members), name (required, the group name), labels? ' +
-      '(optional string[] status labels applied after creation), account? ' +
-      '(defaults to your only XMTP account). Calls the daemon xmtp `newGroup`, then ' +
-      '`updateChannelMeta` if labels ' +
-      'are given. Returns the new metro:// line and convId. This is an xmtp-only operation. ' +
-      'NOTE: there is no add-members verb on the daemon, so members must be supplied at ' +
-      'creation time.',
-    inputSchema: {
-      type: 'object',
-      properties: {
-        addresses: {
-          type: 'array',
-          description: 'Ethereum 0x addresses to add as group members.',
-          items: { type: 'string' },
-        },
-        name: { type: 'string', description: 'The group/channel name.' },
-        labels: {
-          type: 'array',
-          description: 'Optional status labels to apply after creation.',
-          items: { type: 'string' },
-        },
-        account: {
-          type: 'string',
-          description:
-            'XMTP account to create under. Omit when you have only one.',
-        },
-      },
-      required: ['addresses', 'name'],
-    },
-    handle: (a, ctx) => createChannel(a, ctx),
-  },
   {
     name: 'ask',
+    group: 'write',
     description:
       'Ask a question as a poll in an XMTP conversation (mirrors Claude AskUserQuestion). ' +
       'Single-question form: question (required), options? (string[]), header?, multiSelect?, ' +
@@ -116,11 +81,12 @@ export const XMTP_TOOLS: StationTool[] = [
   },
   {
     name: 'dm',
+    group: 'write',
     description:
       'Open (or reuse) a 1:1 XMTP DM with an Ethereum address. Args: address (required, 0x...), ' +
       'account? (defaults to your only XMTP account). Returns the new metro:// line and ' +
       'convId. xmtp-only ' +
-      '(daemon `newDm`). Use this instead of create_channel when there is a single recipient.',
+      '(daemon `newDm`). For a group, use create_group.',
     inputSchema: {
       type: 'object',
       properties: {
@@ -145,6 +111,7 @@ export const XMTP_TOOLS: StationTool[] = [
   },
   {
     name: 'group_info',
+    group: 'read',
     description:
       "Read an XMTP channel's current metadata + membership. Args: line (required). Returns " +
       '{line, id, account, version (dm|group), name, memberCount, labels, github, preview, ' +
@@ -163,27 +130,46 @@ export const XMTP_TOOLS: StationTool[] = [
   },
   {
     name: 'close_channel',
+    group: 'write',
+    destructive: true,
     description:
-      'Archive/close an XMTP group (removes members). Args: line (required). xmtp-only ' +
-      '(daemon `closeGroup`). Irreversible-ish: members are removed from the group.',
+      'Remove members from an XMTP group, and optionally leave it. Args: line (required), ' +
+      'removeInboxIds? (inbox ids to remove; your own is ignored here), removeSelf? (true to ' +
+      'leave the group yourself). With neither, nothing changes. xmtp-only (daemon ' +
+      '`closeGroup`). Returns {removed, leftSelf}.',
     inputSchema: {
       type: 'object',
-      properties: { line: lineProp },
+      properties: {
+        line: lineProp,
+        removeInboxIds: {
+          type: 'array',
+          description: 'Inbox ids of the members to remove.',
+          items: { type: 'string' },
+        },
+        removeSelf: {
+          type: 'boolean',
+          description: 'Leave the group after removing the others.',
+        },
+      },
       required: ['line'],
     },
     async handle(a, ctx) {
       const line = str(a.line);
       if (!line) return ctx.err('close_channel requires `line`');
-      return ctx.okJson(await ctx.call('closeGroup', { line }));
+      const args: Record<string, unknown> = { line };
+      if (Array.isArray(a.removeInboxIds)) args.removeInboxIds = a.removeInboxIds.map(String);
+      if (a.removeSelf === true) args.removeSelf = true;
+      return ctx.okJson(await ctx.call('closeGroup', args));
     },
   },
   {
     name: 'set_channel_metadata',
+    group: 'write',
     description:
       "Update an existing channel's metadata. Args: line (required, the metro:// line), and " +
       'any of labels? (string[]), github? (url), preview? (url), name? (string). All provided ' +
-      'fields are applied together in one atomic updateChannelMeta daemon call (a single ' +
-      'appData merge plus name update). xmtp-only ' +
+      'fields go in one updateChannelMeta call: the name first, then the labels and links ' +
+      'merged into the group appData. xmtp-only ' +
       '(channel metadata lives on xmtp groups). Returns the updated channel info.',
     inputSchema: {
       type: 'object',

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

@@ -1,7 +1,6 @@
-import { errMsg } from '@metro-labs/mcp/log';
-import { mintId, SELF_URI } from './wire.js';
-
-type EmitInbound = (accountId: string, e: Record<string, unknown>) => void;
+import { errMsg } from '@metro-labs/core/log';
+import { emitInbound, selfUri } from '@metro-labs/core/stations/train-events';
+import { mintId } from '@metro-labs/core/stations/station-runtime';
 
 const WHISPER_BIN = process.env.METRO_WHISPER_BIN ?? 'whisper-cli';
 const WHISPER_MODEL =
@@ -14,7 +13,6 @@ export async function transcribeAndEmit(
   line: string,
   accountId: string,
   sourceMsgId: string,
-  emitInbound: EmitInbound,
 ): Promise<void> {
   const {
     existsSync: ex,
@@ -69,7 +67,7 @@ export async function transcribeAndEmit(
       ts: new Date().toISOString(),
       station: 'xmtp',
       line,
-      from: SELF_URI,
+      from: selfUri(),
       text: `🎙️ ${text}`,
       payload: {
         contentType: 'transcript',

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

@@ -1,7 +1,8 @@
 import { mkdirSync, readFileSync, writeFileSync } from 'node:fs';
 import { dirname } from 'node:path';
 import { Client, type ClientOptions, type Signer } from '@xmtp/node-sdk';
-import { expandHome, signerFor, XMTP_ENV } from './identity.js';
+import { expandHome, identityFor, signerFor, XMTP_ENV } from './identity.js';
+import { ensureDeployed } from './smart.js';
 
 export class XmtpVerifyError extends Error {}
 
@@ -10,6 +11,7 @@ export interface XmtpVerified {
   address: string;
   installationId: string;
   dbPath: string;
+  smart: boolean;
 }
 
 interface RegisteredClient {
@@ -34,15 +36,25 @@ const reason = (err: unknown): string =>
 export async function verifyXmtpKey(
   privateKey: string,
   dbPath: string,
+  smart = false,
   create: CreateXmtpClient = openInbox,
 ): Promise<XmtpVerified> {
-  let signer: Signer;
-  let address: string;
+  let identity: Awaited<ReturnType<typeof identityFor>>;
   try {
-    ({ signer, address } = signerFor(privateKey));
+    signerFor(privateKey);
   } catch {
     throw new XmtpVerifyError('that is not a usable XMTP private key');
   }
+  try {
+    identity = await identityFor(privateKey, smart);
+  } catch (err) {
+    throw new XmtpVerifyError(`could not build the smart account on Base: ${reason(err)}`);
+  }
+  const { signer, address } = identity;
+  if (identity.smart !== null)
+    await ensureDeployed(identity.smart).catch((err: unknown) => {
+      throw new XmtpVerifyError(`could not deploy the smart account on Base (is the ZeroDev sponsorship still on?): ${reason(err)}`);
+    });
   const resolved = expandHome(dbPath);
   mkdirSync(dirname(resolved), { recursive: true });
   const client = await create(signer, resolved).catch((err: unknown) => {
@@ -59,6 +71,7 @@ export async function verifyXmtpKey(
     address,
     installationId: client.installationId,
     dbPath: resolved,
+    smart,
   };
 }
 
@@ -68,10 +81,11 @@ async function runCli(): Promise<void> {
     const input = JSON.parse(readFileSync(0, 'utf8')) as {
       privateKey?: unknown;
       dbPath?: unknown;
+      smart?: unknown;
     };
     if (typeof input.privateKey !== 'string' || typeof input.dbPath !== 'string')
       throw new XmtpVerifyError('xmtp verify needs a privateKey and a dbPath');
-    out = { ok: true, ...(await verifyXmtpKey(input.privateKey, input.dbPath)) };
+    out = { ok: true, ...(await verifyXmtpKey(input.privateKey, input.dbPath, input.smart === true)) };
   } catch (err) {
     out = { ok: false, error: reason(err) };
   }

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

@@ -1,7 +1,3 @@
-export { emit, respond, mintId } from '@metro-labs/mcp/stations/station-runtime';
-
-export const SELF_URI = process.env.METRO_SELF_URI ?? '';
-
 const UID_MAP_MAX = 5000;
 const uidToXmtp = new Map<string, string>();
 
@@ -37,3 +33,17 @@ export function resolveMsgId(rawId: string): string {
       '(not seen by this train; pass the raw xmtp message_id)',
   );
 }
+
+const SENT_MAX = 5000;
+const sentIds = new Set<string>();
+
+export function rememberSent(xmtpId: string | undefined): void {
+  if (!xmtpId) return;
+  sentIds.add(xmtpId);
+  if (sentIds.size > SENT_MAX) {
+    const oldest = sentIds.values().next().value;
+    if (oldest !== undefined) sentIds.delete(oldest);
+  }
+}
+
+export const sentByMe = (xmtpId: string): boolean => sentIds.has(xmtpId);

package/runtime/runtime.json

@@ -1,3 +1,3 @@
 {
-  "version": "0.1.0-beta.21"
+  "version": "0.1.0-beta.211"
 }

package/runtime/server.ts

@@ -0,0 +1 @@
+import './node_modules/@metro-labs/daemon/src/server.ts';

package/runtime/stations.json

@@ -0,0 +1,37 @@
+{
+  "core": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "pino": "^9.5.0",
+    "pino-pretty": "^13.1.3",
+    "ws": "^8.18.0",
+    "zod": "^3.23.8"
+  },
+  "stations": {
+    "xmtp": {
+      "@xmtp/content-type-primitives": "^3.0.1",
+      "@xmtp/content-type-reaction": "^2.0.2",
+      "@xmtp/content-type-remote-attachment": "^2.0.4",
+      "@xmtp/content-type-reply": "^2.0.3",
+      "@xmtp/node-bindings": "1.9.1",
+      "@xmtp/node-sdk": "^6.0.0",
+      "@zerodev/ecdsa-validator": "5.4.9",
+      "@zerodev/sdk": "5.5.10",
+      "viem": "^2.52.2"
+    },
+    "telegram-bot": {},
+    "telegram": {
+      "@mtcute/bun": "0.30.1"
+    },
+    "discord-bot": {
+      "discord.js": "^14.26.4"
+    },
+    "whatsapp": {
+      "baileys": "7.0.0-rc14"
+    },
+    "threema": {
+      "tweetnacl": "^1.0.3"
+    },
+    "outlook": {},
+    "webhook": {}
+  }
+}

package/dist/prompt.js

@@ -1,10 +0,0 @@
-import { createInterface } from 'node:readline';
-export function askLine(question) {
-    const rl = createInterface({ input: process.stdin, output: process.stderr });
-    return new Promise((resolve) => {
-        rl.question(question, (answer) => {
-            rl.close();
-            resolve(answer.trim());
-        });
-    });
-}

package/dist/store.js

@@ -1,70 +0,0 @@
-import { chmodSync, mkdirSync, readFileSync, rmSync, writeFileSync } from 'node:fs';
-import { homedir } from 'node:os';
-import { dirname, join } from 'node:path';
-const DEFAULT_BASE = 'https://mcp.metro.box';
-const DEFAULT_WEB = 'https://metro.box';
-function fromEnv(name, fallback) {
-    const raw = process.env[name]?.trim();
-    return raw === undefined || raw === '' ? fallback : raw.replace(/\/+$/, '');
-}
-export function metroUrl() {
-    return fromEnv('METRO_URL', DEFAULT_BASE);
-}
-export function metroWebUrl() {
-    return fromEnv('METRO_UI_URL', DEFAULT_WEB);
-}
-function configDir() {
-    const xdg = process.env.XDG_CONFIG_HOME?.trim();
-    const base = xdg === undefined || xdg === '' ? join(homedir(), '.config') : xdg;
-    return join(base, 'metro');
-}
-export function credentialsPath() {
-    return join(configDir(), 'credentials.json');
-}
-function readStored() {
-    let raw;
-    try {
-        raw = readFileSync(credentialsPath(), 'utf8');
-    }
-    catch {
-        return null;
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(raw);
-    }
-    catch {
-        return null;
-    }
-    if (typeof parsed !== 'object' || parsed === null)
-        return null;
-    const { token, url } = parsed;
-    if (typeof token !== 'string' || token === '')
-        return null;
-    return { token, url: typeof url === 'string' ? url : DEFAULT_BASE };
-}
-export function readToken() {
-    const fromEnv = process.env.METRO_TOKEN?.trim();
-    if (fromEnv !== undefined && fromEnv !== '')
-        return fromEnv;
-    const stored = readStored();
-    if (stored === null)
-        return null;
-    return stored.url === metroUrl() ? stored.token : null;
-}
-export function writeToken(token) {
-    const path = credentialsPath();
-    mkdirSync(dirname(path), { recursive: true, mode: 0o700 });
-    writeFileSync(path, `${JSON.stringify({ token, url: metroUrl() })}\n`, {
-        mode: 0o600,
-    });
-    chmodSync(path, 0o600);
-}
-export function clearToken() {
-    try {
-        rmSync(credentialsPath());
-    }
-    catch {
-        return;
-    }
-}

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

@@ -1,19 +0,0 @@
-import type { GroupOp, Station, Verb } from '@metro-labs/mcp/stations/types';
-
-export const discordStation: Station = {
-  name: 'discord',
-  hasAccounts: true,
-  hasTrain: true,
-  messageVerbs: new Set<Verb>([
-    'send',
-    'reply',
-    'react',
-    'unreact',
-    'edit',
-    'delete',
-    'read',
-  ]),
-  groupOps: new Set<GroupOp>(['create_group', 'add_members', 'remove_members']),
-  attachmentMode: 'canonical',
-  tools: [],
-};

package/runtime/node_modules/@metro-labs/discord/src/voice-speak.ts

@@ -1,195 +0,0 @@
-import { errMsg } from '@metro-labs/mcp/log';
-import { spawn } from 'node:child_process';
-import { unlink } from 'node:fs/promises';
-import {
-  createAudioPlayer,
-  createAudioResource,
-  getVoiceConnection,
-  entersState,
-  AudioPlayerStatus,
-  StreamType,
-  NoSubscriberBehavior,
-  type VoiceConnection,
-} from '@discordjs/voice';
-import type { Client } from 'discord.js';
-import { accountFor, accounts, routeOf } from './accounts.js';
-import { respond } from './wire.js';
-
-const TTS_VOICE = 'Samantha';
-
-function clientFor(account?: string): { accountId: string; client: Client } {
-  const accountId = accountFor({ account });
-  const acct = accounts.get(accountId);
-  if (!acct) throw new Error(`unknown account '${accountId}'`);
-  return { accountId, client: acct.client };
-}
-
-function run(cmd: string, args: string[]): Promise<void> {
-  return new Promise((resolve, reject) => {
-    const p = spawn(cmd, args, { stdio: ['ignore', 'ignore', 'pipe'] });
-    let err = '';
-    p.stderr?.on('data', (d: Buffer) => {
-      err += d.toString();
-    });
-    p.on('error', reject);
-    p.on('close', (code) => {
-      if (code === 0) resolve();
-      else reject(new Error(`${cmd} exited ${code}: ${err.slice(-400)}`));
-    });
-  });
-}
-
-function channelName(ch: unknown, fallback: string): string {
-  return ch && typeof ch === 'object' && 'name' in ch
-    ? String((ch as { name?: string }).name)
-    : fallback;
-}
-
-function resolveChannelId(args: {
-  channelId?: string;
-  line?: string;
-  account?: string;
-}): string | undefined {
-  if (args.channelId) return args.channelId;
-  if (!args.line) return undefined;
-  try {
-    return routeOf(args.line, args.account).channelId;
-  } catch {
-    return undefined;
-  }
-}
-
-function connByChannel(
-  client: Client,
-  channelId: string | undefined,
-): { conn: VoiceConnection; channelName: string } | null {
-  if (!channelId) return null;
-  const ch = client.channels.cache.get(channelId);
-  const gid =
-    ch && 'guildId' in ch ? (ch as { guildId: string }).guildId : undefined;
-  if (!gid) return null;
-  const conn = getVoiceConnection(gid);
-  if (!conn) return null;
-  return { conn, channelName: channelName(ch, gid) };
-}
-
-function connByGuildScan(
-  client: Client,
-): { conn: VoiceConnection; channelName: string } | null {
-  for (const guild of client.guilds.cache.values()) {
-    const conn = getVoiceConnection(guild.id);
-    if (conn) {
-      const chId = (conn.joinConfig as { channelId?: string }).channelId;
-      const ch = chId ? client.channels.cache.get(chId) : undefined;
-      return { conn, channelName: channelName(ch, guild.name) };
-    }
-  }
-  return null;
-}
-
-function resolveConnection(
-  client: Client,
-  args: { channelId?: string; line?: string; account?: string },
-): { conn: VoiceConnection; channelName: string } | { error: string } {
-  const channelId = resolveChannelId(args);
-  return (
-    connByChannel(client, channelId) ??
-    connByGuildScan(client) ?? {
-      error: 'no active voice connection — run joinVoice first',
-    }
-  );
-}
-
-export async function speak(
-  id: string,
-  rawArgs: Record<string, unknown>,
-): Promise<void> {
-  const args = rawArgs as {
-    account?: string;
-    text?: string;
-    channelId?: string;
-    line?: string;
-    voice?: string;
-  };
-  const text = (args.text ?? '').trim();
-  if (!text) {
-    respond(id, { result: { ok: false, error: 'text is required' } });
-    return;
-  }
-
-  const { accountId, client } = clientFor(args.account);
-  if (!client.isReady()) {
-    respond(id, {
-      result: { ok: false, error: `gateway not ready for '${accountId}'` },
-    });
-    return;
-  }
-
-  const resolved = resolveConnection(client, args);
-  if ('error' in resolved) {
-    respond(id, { result: { ok: false, error: resolved.error } });
-    return;
-  }
-  const { conn, channelName } = resolved;
-
-  const ts = Date.now();
-  const aiff = `/tmp/metro-tts-${ts}.aiff`;
-  const ogg = `/tmp/metro-tts-${ts}.ogg`;
-  const cleanup = async () => {
-    await Promise.allSettled([unlink(aiff), unlink(ogg)]);
-  };
-
-  try {
-    await run('say', ['-v', args.voice ?? TTS_VOICE, '-o', aiff, text]);
-    await run('ffmpeg', [
-      '-hide_banner',
-      '-loglevel',
-      'error',
-      '-y',
-      '-i',
-      aiff,
-      '-ac',
-      '2',
-      '-ar',
-      '48000',
-      '-c:a',
-      'libopus',
-      '-b:a',
-      '64k',
-      '-f',
-      'ogg',
-      ogg,
-    ]);
-
-    const player = createAudioPlayer({
-      behaviors: { noSubscriber: NoSubscriberBehavior.Play },
-    });
-    const resource = createAudioResource(ogg, {
-      inputType: StreamType.OggOpus,
-    });
-    conn.subscribe(player);
-    try {
-      (conn as { rejoin: (c: object) => void }).rejoin({ selfMute: false });
-    } catch {
-    }
-    player.play(resource);
-
-    await entersState(player, AudioPlayerStatus.Playing, 10_000);
-    await entersState(player, AudioPlayerStatus.Idle, 120_000);
-    player.stop();
-    try {
-      (conn as { rejoin: (c: object) => void }).rejoin({ selfMute: true });
-    } catch {
-    }
-
-    respond(id, {
-      result: { ok: true, spoke: text, channelName, account: accountId },
-    });
-  } catch (err) {
-    respond(id, {
-      result: { ok: false, error: errMsg(err), account: accountId },
-    });
-  } finally {
-    await cleanup();
-  }
-}