@stage-labs/metro 0.1.0-beta.295 → 0.1.0-beta.296

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stage-labs/metro",
-  "version": "0.1.0-beta.295",
+  "version": "0.1.0-beta.296",
   "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.295",
+  "version": "0.1.0-beta.296",
   "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/mcp/diagnostics.ts

@@ -0,0 +1,102 @@
+import { createHash } from 'node:crypto';
+import type { IncomingMessage, ServerResponse } from 'node:http';
+import { bufferedSince } from '@metro-labs/core/events';
+import { STATIONS } from '@metro-labs/core/station-names';
+import { accountEnabled, accountFromLine, knownAccounts } from '../agents/map.js';
+import { eventInScope } from '../agents/scope.js';
+import type { GetStreamDiagnostic } from './raw-get-stream.js';
+
+export const MCP_STATUS_PATH = '/mcp/status';
+
+export const diagnosticTag = (value: string): string =>
+  createHash('sha256').update(value).digest('hex').slice(0, 16);
+
+export interface SessionDiagnostic {
+  tag: string;
+  openedAt: string;
+  transportInitialized: boolean;
+  clientInitializedAt: string | null;
+  client: { kind: 'claude-code' | 'metro-sdk-runner' | 'other'; tag: string } | null;
+  subscribed: boolean;
+  streamAttached: boolean;
+  lastStreamAttachedAt: string | null;
+  lastStreamDetachedAt: string | null;
+  stream: GetStreamDiagnostic | null;
+}
+
+export interface SlotDiagnostic {
+  started: boolean;
+  liveEvents: boolean;
+  current: SessionDiagnostic | null;
+  replacements: { at: string; reason: 'initialize' | 'adopt'; tag: string; previous: SessionDiagnostic | null }[];
+}
+
+interface DiagnosticSlot {
+  diagnostics: (scope: Set<string>) => SlotDiagnostic;
+}
+
+export interface IncomingDiagnostic extends SlotDiagnostic {
+  version: 1;
+  observedAt: string;
+  accounts: {
+    station: string;
+    tag: string;
+    receiveEnabled: boolean;
+    bufferedEvents: number;
+    latestEventAt: string | null;
+    latestEventTag: string | null;
+  }[];
+}
+
+export function clientDiagnostic(client: { name: string; version: string } | undefined): SessionDiagnostic['client'] {
+  if (client === undefined) return null;
+  const kind = client.name === 'claude-code' || client.name === 'metro-sdk-runner' ? client.name : 'other';
+  return { kind, tag: diagnosticTag(JSON.stringify([client.name, client.version])) };
+}
+
+const eventDate = (raw: unknown): string | null => {
+  if (typeof raw !== 'string') return null;
+  const time = Date.parse(raw);
+  return Number.isFinite(time) ? new Date(time).toISOString() : null;
+};
+
+const eventTag = (messageId: unknown, id: unknown): string | null => {
+  const value = typeof messageId === 'string' && messageId !== '' ? messageId : id;
+  return typeof value === 'string' && value !== '' ? diagnosticTag(value) : null;
+};
+
+export function incomingDiagnostic(slot: DiagnosticSlot, scope: Set<string>): IncomingDiagnostic {
+  const events = bufferedSince(-1).filter(({ event }) => typeof event.line === 'string' && eventInScope(scope, event.line));
+  const accounts = knownAccounts().filter((account) => scope.has(account.agentId) && STATIONS.some((station) => station === account.station));
+  return {
+    version: 1,
+    observedAt: new Date().toISOString(),
+    ...slot.diagnostics(scope),
+    accounts: accounts.map((account) => {
+      const buffered = events.filter(({ event }) => {
+        const target = accountFromLine(event.line);
+        return target?.station === account.station && target.accountId === account.id;
+      });
+      const latest = buffered.at(-1)?.event;
+      return {
+        station: account.station,
+        tag: diagnosticTag(JSON.stringify([account.station, account.id])),
+        receiveEnabled: accountEnabled(account.station, account.id),
+        bufferedEvents: buffered.length,
+        latestEventAt: latest === undefined ? null : eventDate(latest.ts),
+        latestEventTag: latest === undefined ? null : eventTag(latest.messageId, latest.id),
+      };
+    }),
+  };
+}
+
+export function handleIncomingDiagnostic(req: IncomingMessage, res: ServerResponse, slot: DiagnosticSlot, scope: Set<string>): boolean {
+  if ((req.url ?? '').split('?')[0] !== MCP_STATUS_PATH) return false;
+  if (req.method !== 'GET') {
+    res.writeHead(405, { allow: 'GET' }).end();
+    return true;
+  }
+  const body = JSON.stringify(incomingDiagnostic(slot, scope));
+  res.writeHead(200, { 'content-type': 'application/json', 'cache-control': 'no-store' }).end(body);
+  return true;
+}

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

@@ -8,6 +8,7 @@ import {
   authenticate,
   runWithIdentity,
   type RequestIdentity,
+  allowedAgents,
 } from './request-identity.js';
 import {
   headerValue,
@@ -18,6 +19,7 @@ import { errMsg } from '@metro-labs/core/log';
 import { channelLog, type McpSession } from './session.js';
 import { SessionSlot } from './session-slot.js';
 import { connectCallBridge } from './call-bridge.js';
+import { handleIncomingDiagnostic } from './diagnostics.js';
 
 const isInitialize = (b: unknown): boolean =>
   !!b &&
@@ -128,6 +130,7 @@ export async function createMetroMcp(options: { liveEvents?: boolean } = {}): Pr
       res.writeHead(401).end('unauthorized');
       return;
     }
+    if (handleIncomingDiagnostic(req, res, slot, allowedAgents(identity))) return;
     const parsed = await readOrReject(req, res);
     if (!parsed.ok) return;
     await runWithIdentity(identity, async () => {

package/runtime/node_modules/@metro-labs/daemon/src/mcp/raw-get-stream.ts

@@ -1,4 +1,5 @@
 import type { IncomingMessage, ServerResponse } from 'node:http';
+import { randomUUID } from 'node:crypto';
 import type {
   StreamableHTTPServerTransport,
   EventId,
@@ -49,10 +50,19 @@ export const headerValue = (
   return typeof raw === 'string' ? raw : undefined;
 };
 
+export interface GetStreamDiagnostic {
+  tag: string;
+  openedAt: string;
+  attachedAt: string | null;
+  closedAt: string | null;
+  ownsMapping: boolean;
+}
+
 export interface RawGetSink {
   closed: boolean;
   attach: (transport: StreamableHTTPServerTransport) => void;
   close: () => void;
+  diagnostics: () => GetStreamDiagnostic;
 }
 
 const streamEnded = (sink: RawGetSink, res: ServerResponse): boolean =>
@@ -99,10 +109,8 @@ export interface ServeOpts {
   previous?: () => RawGetSink | undefined;
 }
 
-export async function serveStandaloneGet(opts: ServeOpts): Promise<void> {
-  const { transport, eventStore, scope, req, res, log, registerSink } = opts;
+function primeStream(transport: StreamableHTTPServerTransport, res: ServerResponse): void {
   const sessionId = web(transport)?.sessionId;
-
   res.writeHead(200, {
     'content-type': 'text/event-stream',
     'cache-control': 'no-cache, no-transform',
@@ -113,13 +121,23 @@ export async function serveStandaloneGet(opts: ServeOpts): Promise<void> {
   res.flushHeaders?.();
   res.write(RETRY_DIRECTIVE);
   res.write(COMMENT);
+}
+
+export async function serveStandaloneGet(opts: ServeOpts): Promise<void> {
+  const { transport, eventStore, scope, req, res, log, registerSink } = opts;
+  primeStream(transport, res);
 
   let active = transport;
   let entry: StreamEntry | undefined;
+  const tag = randomUUID();
+  const openedAt = new Date().toISOString();
+  let attachedAt: string | null = null;
+  let closedAt: string | null = null;
   const timers: { keepalive?: ReturnType<typeof setInterval> } = {};
   const closeStream = (): void => {
     if (sink.closed) return;
     sink.closed = true;
+    closedAt = new Date().toISOString();
     if (timers.keepalive) clearInterval(timers.keepalive);
     const mapping = web(active)?._streamMapping;
     if (entry !== undefined && mapping?.get(STANDALONE_STREAM_ID) === entry) {
@@ -150,8 +168,16 @@ export async function serveStandaloneGet(opts: ServeOpts): Promise<void> {
         cleanup: closeStream,
       };
       web(next)?._streamMapping?.set(STANDALONE_STREAM_ID, entry);
+      attachedAt = new Date().toISOString();
     },
     close: closeStream,
+    diagnostics: () => ({
+      tag,
+      openedAt,
+      attachedAt,
+      closedAt,
+      ownsMapping: entry !== undefined && web(active)?._streamMapping?.get(STANDALONE_STREAM_ID) === entry,
+    }),
   };
 
   res.on('close', closeStream);

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

@@ -4,6 +4,18 @@ import { errMsg } from '@metro-labs/core/log';
 import { newReplayLedger } from '../channels/relay.js';
 import { McpSession, channelLog, type SessionKind } from './session.js';
 import { allowedAgents, type RequestIdentity } from './request-identity.js';
+import { diagnosticTag, type SessionDiagnostic, type SlotDiagnostic } from './diagnostics.js';
+
+interface SlotReplacement {
+  at: string;
+  reason: 'initialize' | 'adopt';
+  tag: string;
+  scope: Set<string>;
+  previousScope: Set<string>;
+  previous: SessionDiagnostic | null;
+}
+
+const sharesScope = (left: Set<string>, right: Set<string>): boolean => [...left].some((id) => right.has(id));
 
 export class SessionSlot {
   private session: McpSession | undefined;
@@ -11,6 +23,7 @@ export class SessionSlot {
   private started = false;
   private live: boolean;
   private changing: Promise<void> = Promise.resolve();
+  private readonly replacements: SlotReplacement[] = [];
 
   constructor(
     live = true,
@@ -27,6 +40,20 @@ export class SessionSlot {
     return this.live;
   }
 
+  diagnostics(scope: Set<string>): SlotDiagnostic {
+    return {
+      started: this.started,
+      liveEvents: this.live,
+      current: this.session !== undefined && sharesScope(scope, this.session.scope) ? this.session.diagnostics() : null,
+      replacements: this.replacements.filter((replacement) => sharesScope(scope, replacement.scope)).map((replacement) => ({
+        at: replacement.at,
+        reason: replacement.reason,
+        tag: replacement.tag,
+        previous: sharesScope(scope, replacement.previousScope) ? replacement.previous : null,
+      })),
+    };
+  }
+
   startInbound(): void {
     if (this.started) return;
     this.started = true;
@@ -59,8 +86,27 @@ export class SessionSlot {
     return changed;
   }
 
+  private previousSlot(): Pick<SlotReplacement, 'previous' | 'previousScope'> {
+    return {
+      previous: this.session?.diagnostics() ?? null,
+      previousScope: this.session?.scope ?? new Set<string>(),
+    };
+  }
+
+  private recordReplacement(session: McpSession, adoptId: string | undefined, previous: Pick<SlotReplacement, 'previous' | 'previousScope'>): void {
+    this.replacements.push({
+      at: new Date().toISOString(),
+      reason: adoptId === undefined ? 'initialize' : 'adopt',
+      tag: diagnosticTag(session.id),
+      scope: session.scope,
+      ...previous,
+    });
+    if (this.replacements.length > 8) this.replacements.shift();
+  }
+
   private async replace(identity: RequestIdentity, adoptId?: string): Promise<McpSession> {
     if (adoptId !== undefined && this.session?.id === adoptId) return this.session;
+    const previous = this.previousSlot();
     await this.session?.close();
     if (this.ledger.startAt < 0) this.ledger.startAt = currentBusSeq();
     const id = adoptId ?? randomUUID();
@@ -81,6 +127,7 @@ export class SessionSlot {
       },
     });
     this.session = session;
+    this.recordReplacement(session, adoptId, previous);
     if (this.started && this.live) session.startChannel();
     channelLog('session: opened', 'id', id, 'kind', this.kind, 'adopted', adoptId !== undefined);
     return session;

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

@@ -15,6 +15,7 @@ import { registerToolHandlers, toolSchemaSignature } from './tool-dispatch.js';
 import { web, type RawGetSink } from './raw-get-stream.js';
 import { sharedCalls } from '../voice/shared.js';
 import { CALL_STATE } from '@metro-labs/core/call';
+import { clientDiagnostic, diagnosticTag, type SessionDiagnostic } from './diagnostics.js';
 
 export const channelLog = (...a: unknown[]): void => {
   console.error('[metro-mcp]', ...a);
@@ -84,6 +85,10 @@ export class McpSession {
   private announcing = false;
   private readonly onClosed: (session: McpSession) => void;
   private readonly kind: SessionKind;
+  private readonly openedAt = new Date().toISOString();
+  private clientInitializedAt: string | null = null;
+  private lastStreamAttachedAt: string | null = null;
+  private lastStreamDetachedAt: string | null = null;
 
   private constructor(init: SessionInit) {
     this.id = init.id;
@@ -102,6 +107,9 @@ export class McpSession {
         instructions: voice ? VOICE_MCP_INSTRUCTIONS : MCP_INSTRUCTIONS,
       },
     );
+    this.server.oninitialized = (): void => {
+      this.clientInitializedAt = new Date().toISOString();
+    };
     registerToolHandlers(this.server, {
       markCurrent: (): void => {
         this.issuedSchema = toolSchemaSignature();
@@ -159,6 +167,21 @@ export class McpSession {
     return this.sink;
   }
 
+  diagnostics(): SessionDiagnostic {
+    return {
+      tag: diagnosticTag(this.id),
+      openedAt: this.openedAt,
+      transportInitialized: web(this.transport)?._initialized === true,
+      clientInitializedAt: this.clientInitializedAt,
+      client: clientDiagnostic(this.server.getClientVersion()),
+      subscribed: this.unsubscribe !== undefined,
+      streamAttached: this.streamAttached,
+      lastStreamAttachedAt: this.lastStreamAttachedAt,
+      lastStreamDetachedAt: this.lastStreamDetachedAt,
+      stream: this.sink?.diagnostics() ?? null,
+    };
+  }
+
   inScope(line: string): boolean {
     return this.streamAttached && eventInScope(this.scope, line);
   }
@@ -181,8 +204,10 @@ export class McpSession {
       sink?.close();
       return;
     }
+    if (sink === undefined && this.sink !== undefined) this.lastStreamDetachedAt = new Date().toISOString();
     this.sink = sink;
     if (sink !== undefined) {
+      this.lastStreamAttachedAt = new Date().toISOString();
       this.announceCallState();
       this.announceToolSchema();
     }
@@ -227,6 +252,7 @@ export class McpSession {
 
   dropStream(): void {
     const sink = this.sink;
+    if (sink !== undefined) this.lastStreamDetachedAt = new Date().toISOString();
     this.sink = undefined;
     sink?.close();
   }

package/runtime/node_modules/@metro-labs/daemon/src/routes/http.ts

@@ -12,6 +12,7 @@ import {
   type ServerResponse,
 } from 'node:http';
 import { Line } from '@metro-labs/core/lines';
+import { MCP_STATUS_PATH } from '../mcp/diagnostics.js';
 import { errMsg, log } from '@metro-labs/core/log';
 import {
   classifyEvent,
@@ -214,7 +215,7 @@ export async function startWebhookServer(
 
 function isMcpPath(req: IncomingMessage): boolean {
   const path = (req.url ?? '').split('?')[0];
-  return path === '/' || path === '/mcp' || path === VOICE_MCP_PATH;
+  return path === '/' || path === '/mcp' || path === VOICE_MCP_PATH || path === MCP_STATUS_PATH;
 }
 
 function flatHeaders(req: IncomingMessage): Record<string, string> {

package/runtime/runtime.json

@@ -1,3 +1,3 @@
 {
-  "version": "0.1.0-beta.295"
+  "version": "0.1.0-beta.296"
 }

package/runtime/sdk-runner/runner.json

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