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

package/runtime/node_modules/@metro-labs/mcp/src/mcp/session-registry.ts

@@ -1,172 +0,0 @@
-import { randomUUID } from 'node:crypto';
-import { currentBusSeq } from '../daemon/events.js';
-import { errMsg } from '../daemon/log.js';
-import { newReplayLedger, type ReplayLedger } from '../channels/relay.js';
-import { McpSession, channelLog } from './session.js';
-import { agentsInScopeKey } from './session-route.js';
-import { sessionScopeKey, type SessionOwnership } from './session-route.js';
-import type { RequestIdentity } from './request-identity.js';
-
-export const MAX_SESSIONS = 64;
-export const SESSION_IDLE_MS = 10 * 60_000;
-export const LEDGER_MAX = 256;
-const SWEEP_MS = 60_000;
-
-export interface AgentLiveness {
-  connected: boolean;
-  lastSeenAt: number;
-}
-
-export class SessionCapacityError extends Error {
-  constructor() {
-    super('too many live MCP sessions');
-  }
-}
-
-export class SessionRegistry {
-  private readonly byId = new Map<string, McpSession>();
-  private readonly byScope = new Map<string, McpSession>();
-  private readonly ledgers = new Map<string, ReplayLedger>();
-  private readonly sweeper: ReturnType<typeof setInterval>;
-  private readonly log: (...a: unknown[]) => void;
-  private started = false;
-  private floor = 0;
-
-  constructor(log: (...a: unknown[]) => void = channelLog) {
-    this.log = log;
-    this.sweeper = setInterval(() => {
-      this.sweep(Date.now());
-    }, SWEEP_MS);
-    this.sweeper.unref?.();
-  }
-
-  get size(): number {
-    return this.byId.size;
-  }
-
-  get(sessionId: string): McpSession | undefined {
-    return this.byId.get(sessionId);
-  }
-
-  liveness(): Map<string, AgentLiveness> {
-    const out = new Map<string, AgentLiveness>();
-    for (const session of this.byId.values())
-      for (const id of agentsInScopeKey(session.scopeKey)) {
-        const prev = out.get(id);
-        out.set(id, {
-          connected: (prev?.connected ?? false) || session.streamAttached,
-          lastSeenAt: Math.max(prev?.lastSeenAt ?? 0, session.lastSeenAt),
-        });
-      }
-    return out;
-  }
-
-  forScope(scopeKey: string): McpSession | undefined {
-    return this.byScope.get(scopeKey);
-  }
-
-  ownership(
-    presented: string | undefined,
-    scopeKey: string,
-  ): SessionOwnership {
-    if (presented === undefined) return 'none';
-    const found = this.byId.get(presented);
-    if (!found) return 'none';
-    return found.scopeKey === scopeKey ? 'mine' : 'theirs';
-  }
-
-  startInbound(): void {
-    if (this.started) return;
-    this.started = true;
-    this.floor = currentBusSeq();
-    for (const session of this.byId.values()) session.startChannel();
-  }
-
-  async create(
-    identity: RequestIdentity,
-    adoptId?: string,
-  ): Promise<McpSession> {
-    const scopeKey = sessionScopeKey(identity);
-    const id = adoptId ?? randomUUID();
-    await this.byScope.get(scopeKey)?.close();
-    await this.byId.get(id)?.close();
-    await this.makeRoom();
-    const session = await McpSession.open({
-      id,
-      scopeKey,
-      adopted: adoptId !== undefined,
-      ledger: this.ledgerFor(scopeKey),
-      onClosed: (s) => {
-        this.forget(s);
-      },
-    });
-    this.byId.set(id, session);
-    this.byScope.set(scopeKey, session);
-    if (this.started) session.startChannel();
-    this.log('session: opened', 'id', id, 'scope', scopeKey, 'live', this.byId.size);
-    return session;
-  }
-
-  async closeScope(scopeKey: string): Promise<boolean> {
-    const session = this.byScope.get(scopeKey);
-    if (!session) return false;
-    this.log('session: closed, credential rotated', 'id', session.id, 'scope', scopeKey);
-    await session.close();
-    return true;
-  }
-
-  async closeAll(): Promise<void> {
-    clearInterval(this.sweeper);
-    for (const session of [...this.byId.values()]) await session.close();
-    this.ledgers.clear();
-  }
-
-  sweep(now: number): number {
-    let reaped = 0;
-    for (const session of [...this.byId.values()]) {
-      if (session.streamAttached) continue;
-      if (now - session.lastSeenAt <= SESSION_IDLE_MS) continue;
-      this.log('session: reaped idle', 'id', session.id, 'scope', session.scopeKey);
-      session.close().catch((err: unknown) => {
-        this.log('session: reap close failed', 'id', session.id, errMsg(err));
-      });
-      reaped += 1;
-    }
-    return reaped;
-  }
-
-  private forget(session: McpSession): void {
-    if (this.byId.get(session.id) === session) this.byId.delete(session.id);
-    if (this.byScope.get(session.scopeKey) === session)
-      this.byScope.delete(session.scopeKey);
-  }
-
-  private async makeRoom(): Promise<void> {
-    if (this.byId.size < MAX_SESSIONS) return;
-    this.sweep(Date.now());
-    if (this.byId.size < MAX_SESSIONS) return;
-    const idle = [...this.byId.values()]
-      .filter((s) => !s.streamAttached)
-      .sort((a, b) => a.lastSeenAt - b.lastSeenAt)
-      .at(0);
-    if (!idle) throw new SessionCapacityError();
-    await idle.close();
-  }
-
-  private ledgerFor(scopeKey: string): ReplayLedger {
-    const found = this.ledgers.get(scopeKey);
-    if (found) {
-      this.ledgers.delete(scopeKey);
-      this.ledgers.set(scopeKey, found);
-      return found;
-    }
-    const fresh = newReplayLedger(this.started ? this.floor : currentBusSeq());
-    this.ledgers.set(scopeKey, fresh);
-    while (this.ledgers.size > LEDGER_MAX) {
-      const oldest = this.ledgers.keys().next();
-      if (oldest.done) break;
-      this.ledgers.delete(oldest.value);
-    }
-    return fresh;
-  }
-}

package/runtime/node_modules/@metro-labs/mcp/src/mcp/session-route.ts

@@ -1,43 +0,0 @@
-import { allowedAgents, type RequestIdentity } from './request-identity.js';
-
-export function sessionScopeKey(identity: RequestIdentity): string {
-  const ids = [...allowedAgents(identity)].sort();
-  if (ids.length > 0) return `${AGENTS_PREFIX}${ids.join(',')}`;
-  return `email:${identity.kind === 'google' ? identity.email : identity.agentId}`;
-}
-
-const AGENTS_PREFIX = 'agents:';
-
-export function agentsInScopeKey(scopeKey: string): string[] {
-  if (!scopeKey.startsWith(AGENTS_PREFIX)) return [];
-  return scopeKey.slice(AGENTS_PREFIX.length).split(',').filter(Boolean);
-}
-
-export type SessionOwnership = 'none' | 'mine' | 'theirs';
-
-export type SessionRoute =
-  | { kind: 'create'; adoptId?: string }
-  | { kind: 'use' }
-  | { kind: 'reject'; status: number; message: string };
-
-export interface SessionRouteInput {
-  isInitialize: boolean;
-  presented: string | undefined;
-  ownership: SessionOwnership;
-  hasOwnSession: boolean;
-}
-
-const NO_SESSION_HEADER = 'Bad Request: Mcp-Session-Id header is required';
-const NOT_FOUND = 'Session not found';
-
-export function routeSession(input: SessionRouteInput): SessionRoute {
-  if (input.isInitialize) return { kind: 'create' };
-  if (input.presented === undefined)
-    return input.hasOwnSession
-      ? { kind: 'use' }
-      : { kind: 'reject', status: 400, message: NO_SESSION_HEADER };
-  if (input.ownership === 'mine') return { kind: 'use' };
-  if (input.ownership === 'theirs')
-    return { kind: 'reject', status: 404, message: NOT_FOUND };
-  return { kind: 'create', adoptId: input.presented };
-}

package/runtime/node_modules/@metro-labs/mcp/src/monitor/api.ts

@@ -1,240 +0,0 @@
-import type { IncomingMessage, ServerResponse } from 'node:http';
-import { stationByName } from '../stations/registry.js';
-import { errMsg, log } from '../daemon/log.js';
-import { subscribeEvents, type MetroEvent } from '../daemon/events.js';
-import { callTargetDenied, eventInScope } from '../db/agent-scope.js';
-import { hasAnyKey } from '../db/key-map.js';
-import {
-  allowedAgents,
-  authConfigFromEnv,
-  authenticate,
-} from '../mcp/request-identity.js';
-
-export type MonitorCall = (
-  train: string,
-  action: string,
-  args: Record<string, unknown>,
-) => Promise<{ result: unknown }>;
-
-const KEEPALIVE_MS = 25_000;
-const CALL_BODY_MAX = 256 * 1024;
-const METRO_VERSION = process.env.npm_package_version ?? '0.1.0-beta.15';
-
-function monitorEnabled(): boolean {
-  return hasAnyKey() || authConfigFromEnv().sessionSecret !== '';
-}
-
-function cors(req: IncomingMessage): Record<string, string> {
-  return {
-    'access-control-allow-origin': req.headers.origin ?? '*',
-    'access-control-allow-methods': 'GET, POST, OPTIONS',
-    'access-control-allow-headers': 'Authorization, Content-Type',
-    'access-control-max-age': '86400',
-    vary: 'Origin',
-  };
-}
-
-function sendJson(
-  res: ServerResponse,
-  req: IncomingMessage,
-  status: number,
-  body: unknown,
-): void {
-  res.writeHead(status, { 'content-type': 'application/json', ...cors(req) });
-  res.end(JSON.stringify(body));
-}
-
-function parseCallArgs(raw: string): Record<string, unknown> {
-  if (!raw) return {};
-  const parsed = JSON.parse(raw) as { args?: unknown };
-  const value =
-    parsed && typeof parsed === 'object' && 'args' in parsed
-      ? parsed.args
-      : parsed;
-  if (!value || typeof value !== 'object' || Array.isArray(value))
-    throw new Error('call body must be a JSON object');
-  return value as Record<string, unknown>;
-}
-
-async function readCallArgs(
-  req: IncomingMessage,
-): Promise<Record<string, unknown>> {
-  const chunks: Buffer[] = [];
-  let total = 0;
-  for await (const chunk of req) {
-    const buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk as string);
-    total += buf.length;
-    if (total > CALL_BODY_MAX)
-      throw new Error(`request body exceeds ${CALL_BODY_MAX} bytes`);
-    chunks.push(buf);
-  }
-  return parseCallArgs(Buffer.concat(chunks).toString('utf8').trim());
-}
-
-function startTailStream(
-  req: IncomingMessage,
-  res: ServerResponse,
-  allowed: Set<string>,
-): void {
-  res.writeHead(200, {
-    'content-type': 'text/event-stream',
-    'cache-control': 'no-cache, no-transform',
-    connection: 'keep-alive',
-    'x-accel-buffering': 'no',
-    ...cors(req),
-  });
-  const timers: { keepalive?: ReturnType<typeof setInterval> } = {};
-  const subs: { stop?: () => void } = {};
-  let done = false;
-  const cleanup = (): void => {
-    if (done) return;
-    done = true;
-    subs.stop?.();
-    if (timers.keepalive) clearInterval(timers.keepalive);
-    try {
-      res.end();
-    } catch {
-      log.debug('monitor: tail cleanup end failed');
-    }
-  };
-  const write = (chunk: string): void => {
-    if (done) return;
-    if (res.destroyed || res.writableEnded) {
-      cleanup();
-      return;
-    }
-    try {
-      res.write(chunk);
-    } catch (err) {
-      log.debug({ err: errMsg(err) }, 'monitor: tail write failed');
-      cleanup();
-    }
-  };
-  write(': metro monitor tail (live)\n\n');
-  let id = 0;
-  subs.stop = subscribeEvents((e: MetroEvent): void => {
-    if (!eventInScope(allowed, e.line)) return;
-    id += 1;
-    write(`id: ${id}\nevent: live\ndata: ${JSON.stringify(e)}\n\n`);
-  });
-  timers.keepalive = setInterval(() => {
-    write(': keepalive\n\n');
-  }, KEEPALIVE_MS);
-  timers.keepalive.unref?.();
-  req.on('close', cleanup);
-  req.on('error', cleanup);
-}
-
-async function handleCall(
-  req: IncomingMessage,
-  res: ServerResponse,
-  train: string,
-  action: string,
-  call: MonitorCall,
-  allowed: Set<string>,
-): Promise<void> {
-  let args: Record<string, unknown>;
-  try {
-    args = await readCallArgs(req);
-  } catch (err) {
-    sendJson(res, req, 400, { error: `bad JSON body: ${errMsg(err)}` });
-    return;
-  }
-  if (callTargetDenied(allowed, train, args)) {
-    sendJson(res, req, 403, {
-      error: 'metro: this account is outside your authorized scope',
-    });
-    return;
-  }
-  if (stationByName(train)?.hasTrain === false) {
-    sendJson(res, req, 400, {
-      error: `metro: station '${train}' runs in-core and takes no calls`,
-    });
-    return;
-  }
-  try {
-    const { result } = await call(train, action, args);
-    sendJson(res, req, 200, { result });
-  } catch (err) {
-    sendJson(res, req, 502, { error: errMsg(err) });
-  }
-}
-
-function routeApi(
-  req: IncomingMessage,
-  res: ServerResponse,
-  path: string,
-  call: MonitorCall,
-  allowed: Set<string>,
-): void {
-  const callMatch = /^\/api\/call\/([^/]+)\/([^/]+)$/.exec(path);
-  if (callMatch) {
-    if (req.method !== 'POST') {
-      sendJson(res, req, 405, { error: 'method not allowed' });
-      return;
-    }
-    handleCall(
-      req,
-      res,
-      callMatch[1] ?? '',
-      callMatch[2] ?? '',
-      call,
-      allowed,
-    ).catch((err: unknown) => {
-      log.warn({ err: errMsg(err) }, 'monitor: call handler error');
-      if (!res.headersSent) sendJson(res, req, 500, { error: errMsg(err) });
-    });
-    return;
-  }
-  if (path === '/api/tail') {
-    if (req.method !== 'GET') {
-      sendJson(res, req, 405, { error: 'method not allowed' });
-      return;
-    }
-    startTailStream(req, res, allowed);
-    return;
-  }
-  sendJson(res, req, 404, { error: 'not found' });
-}
-
-function preflight(
-  req: IncomingMessage,
-  res: ServerResponse,
-  path: string,
-): boolean {
-  if (!monitorEnabled()) {
-    sendJson(res, req, 404, { error: 'not found' });
-    return true;
-  }
-  if (req.method === 'OPTIONS') {
-    res.writeHead(204, cors(req)).end();
-    return true;
-  }
-  if (req.method === 'GET' && path === '/api/health') {
-    sendJson(res, req, 200, {
-      ok: true,
-      service: 'metro',
-      version: METRO_VERSION,
-      uptime_s: Math.round(process.uptime()),
-    });
-    return true;
-  }
-  return false;
-}
-
-export function handleMonitorRequest(
-  req: IncomingMessage,
-  res: ServerResponse,
-  call: MonitorCall,
-): boolean {
-  const path = (req.url ?? '').split('?', 2)[0] ?? '';
-  if (!path.startsWith('/api/')) return false;
-  if (preflight(req, res, path)) return true;
-  const identity = authenticate(req, authConfigFromEnv());
-  if (!identity) {
-    sendJson(res, req, 401, { error: 'unauthorized' });
-    return true;
-  }
-  routeApi(req, res, path, call, allowedAgents(identity));
-  return true;
-}

package/runtime/node_modules/@metro-labs/mcp/src/server.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env bun
-import './daemon/boot.js';

package/runtime/node_modules/@metro-labs/mcp/src/stations/account-store.ts

@@ -1,80 +0,0 @@
-import { existsSync, readFileSync } from 'node:fs';
-import { errMsg } from '../daemon/log.js';
-import { chmodIfExists } from '../daemon/secure-fs.js';
-
-export type Die = (msg: string) => never;
-
-export interface MakeLoaderOpts<T> {
-  prefix: string;
-  file: string;
-  allowlistEnv: string[];
-  validate: (raw: T[], die: Die) => void;
-}
-
-export interface Loader<T> {
-  die: Die;
-  loadAccounts: () => T[];
-}
-
-export function makeAccountStore<T extends { id: string }>(
-  opts: MakeLoaderOpts<T>,
-): Loader<T> {
-  const die: Die = (msg) => {
-    process.stderr.write(`${opts.prefix}: ${msg}\n`);
-    process.exit(2);
-  };
-
-  let allowlistRaw: string | undefined;
-  for (const k of opts.allowlistEnv) {
-    allowlistRaw ??= process.env[k];
-  }
-  const allowlist = new Set(
-    (allowlistRaw ?? '')
-      .split(',')
-      .map((s) => s.trim())
-      .filter(Boolean),
-  );
-
-  function loadAccounts(): T[] {
-    if (!existsSync(opts.file))
-      return die(
-        `no accounts file ${opts.file} — the daemon writes it from the database at boot; set DATABASE_URL and populate the accounts table`,
-      );
-    chmodIfExists(opts.file);
-    let raw: T[];
-    try {
-      raw = JSON.parse(readFileSync(opts.file, 'utf8')) as T[];
-    } catch (e) {
-      return die(`bad ${opts.file}: ${errMsg(e)}`);
-    }
-    if (!Array.isArray(raw) || raw.length === 0)
-      die(`${opts.file} must be a non-empty array`);
-    opts.validate(raw, die);
-    const selected = allowlist.size
-      ? raw.filter((a) => allowlist.has(a.id))
-      : raw;
-    if (selected.length === 0) {
-      die(
-        `no accounts match ${opts.allowlistEnv[0]} (${[...allowlist].join(', ')})`,
-      );
-    }
-    return selected;
-  }
-
-  return { die, loadAccounts };
-}
-
-export function resolveAccountId(
-  accounts: Map<string, unknown>,
-  args: { account?: string; line?: string },
-  parseAccountId: (line: string) => string | undefined,
-): string {
-  let id = args.account;
-  id ??= args.line ? parseAccountId(args.line) : undefined;
-  id ??= (accounts.size === 1 ? [...accounts.keys()][0] : 'default') ?? 'default';
-  if (!accounts.has(id))
-    throw new Error(
-      `unknown account '${id}' (have: ${[...accounts.keys()].join(', ')})`,
-    );
-  return id;
-}

package/runtime/node_modules/@metro-labs/mcp/src/stations/messaging-normalize.ts

@@ -1,88 +0,0 @@
-type Args = Record<string, unknown>;
-export interface Normalized {
-  action: string;
-  args: Args;
-}
-
-interface Attachment {
-  kind?: string;
-  path?: string;
-  url?: string;
-  data?: string;
-  mime?: string;
-  name?: string;
-}
-
-interface DiscordFile {
-  file: string;
-  kind: string;
-  name: string;
-}
-
-const discordFile = (a: Attachment): DiscordFile | null => {
-  const file = a.path ?? a.url;
-  if (typeof file !== 'string') return null;
-  return { file, kind: a.kind ?? 'file', name: a.name ?? '' };
-};
-
-function discordAttachments(att: Attachment[]): Args {
-  const usable = att
-    .map(discordFile)
-    .filter((f): f is DiscordFile => f !== null);
-  if (!usable.length) return {};
-  return {
-    files: usable.map((f) => f.file),
-    attachmentKinds: usable.map((f) => f.kind),
-    attachmentNames: usable.map((f) => f.name),
-  };
-}
-
-export function normalizeDiscord(action: string, env: Args): Normalized {
-  const att = (env.attachments as Attachment[] | undefined) ?? [];
-  if (action === 'send') {
-    return { action: 'send', args: { ...env, ...discordAttachments(att) } };
-  }
-  if (action === 'reply') {
-    const replyTo = env.replyTo ?? env.messageId;
-    return {
-      action: 'send',
-      args: { ...env, replyTo, ...discordAttachments(att) },
-    };
-  }
-  if (action === 'unreact')
-    return { action: 'react', args: { ...env, emoji: '' } };
-  if (action === 'read') {
-    return {
-      action: 'fetch',
-      args: { line: env.line, limit: env.limit, before: env.before },
-    };
-  }
-  return { action, args: env };
-}
-
-export function normalizeTelegram(action: string, env: Args): Normalized {
-  if (action === 'reply') {
-    return {
-      action: 'send',
-      args: {
-        line: env.line,
-        text: env.text,
-        replyTo: env.replyTo,
-        attachments: env.attachments,
-      },
-    };
-  }
-  if (action === 'unreact')
-    return { action: 'react', args: { ...env, emoji: '' } };
-  return { action, args: env };
-}
-
-export function normalizeXmtp(action: string, env: Args): Normalized {
-  if (action === 'unreact') {
-    return { action: 'react', args: { ...env, action: 'removed' } };
-  }
-  if (action === 'read') {
-    return { action: 'query', args: { line: env.line, limit: env.limit } };
-  }
-  return { action, args: env };
-}

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

@@ -1,3 +0,0 @@
-export { emit, respond, mintId } from '@metro-labs/mcp/stations/station-runtime';
-
-export const SELF_URI = process.env.METRO_SELF_URI ?? '';