@stage-labs/metro 0.1.0-beta.300 → 0.1.0-beta.301

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stage-labs/metro",
-  "version": "0.1.0-beta.300",
+  "version": "0.1.0-beta.301",
   "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.300",
+  "version": "0.1.0-beta.301",
   "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/runner-activity.ts

@@ -39,8 +39,11 @@ export type RunnerFailureCode = keyof typeof FAILURE;
 const ERROR_CODES = ['ENOENT', 'EACCES', 'EPERM', 'ENOEXEC', 'ENOMEM', 'ERR_MODULE_NOT_FOUND', 'MODULE_NOT_FOUND', 'ERR_DLOPEN_FAILED', 'ECONNREFUSED', 'ECONNRESET', 'ENOTFOUND', 'EAI_AGAIN', 'ETIMEDOUT', 'CERT_HAS_EXPIRED', 'UNABLE_TO_VERIFY_LEAF_SIGNATURE'] as const;
 const SIGNALS = ['SIGTERM', 'SIGKILL', 'SIGSEGV', 'SIGABRT', 'SIGBUS', 'SIGILL', 'SIGINT', 'SIGHUP', 'SIGPIPE'] as const;
 
+const ERROR_NAME_RE = /^[A-Z][A-Za-z0-9]{0,39}Error$/;
+
 export interface RunnerDiagnostic {
   source: 'exception' | 'stderr';
+  errorName?: string;
   errorCode?: (typeof ERROR_CODES)[number];
   httpStatus?: number;
   exitCode?: number;
@@ -49,14 +52,18 @@ export interface RunnerDiagnostic {
 
 const boundedNumber = (value: unknown, min: number, max: number): number | undefined => typeof value === 'number' && Number.isInteger(value) && value >= min && value <= max ? value : undefined;
 
+const errorNameOf = (value: unknown): string | undefined => typeof value === 'string' && value !== 'Error' && ERROR_NAME_RE.test(value) ? value : undefined;
+
 export function runnerDiagnostic(raw: unknown): RunnerDiagnostic | undefined {
   if (!isRecord(raw) || (raw.source !== 'exception' && raw.source !== 'stderr')) return undefined;
   const errorCode = ERROR_CODES.find((code) => code === raw.errorCode);
   const signal = SIGNALS.find((value) => value === raw.signal);
   const httpStatus = boundedNumber(raw.httpStatus, 400, 599);
   const exitCode = boundedNumber(raw.exitCode, 0, 255);
+  const errorName = errorNameOf(raw.errorName);
   return {
     source: raw.source,
+    ...(errorName === undefined ? {} : { errorName }),
     ...(errorCode === undefined ? {} : { errorCode }),
     ...(httpStatus === undefined ? {} : { httpStatus }),
     ...(exitCode === undefined ? {} : { exitCode }),
@@ -68,7 +75,7 @@ export function runnerFailureSummary(code: RunnerFailureCode, tool: string | nul
   const summary = code === 'tool_error' && name(tool) !== null ? `${tool} failed. See its result in Conversations.` : FAILURE[code];
   const safe = runnerDiagnostic(diagnostic);
   if (safe === undefined) return summary;
-  const details = [safe.errorCode, safe.httpStatus === undefined ? null : `HTTP ${safe.httpStatus}`, safe.exitCode === undefined ? null : `exit ${safe.exitCode}`, safe.signal].filter((value) => value !== undefined && value !== null);
+  const details = [safe.errorName, safe.errorCode, safe.httpStatus === undefined ? null : `HTTP ${safe.httpStatus}`, safe.exitCode === undefined ? null : `exit ${safe.exitCode}`, safe.signal].filter((value) => value !== undefined && value !== null);
   return details.length === 0 ? summary : `${summary} Observed: ${details.join(', ')} (${safe.source === 'stderr' ? 'startup stderr' : 'exception'}).`;
 }
 

package/runtime/runtime.json

@@ -1,3 +1,3 @@
 {
-  "version": "0.1.0-beta.300"
+  "version": "0.1.0-beta.301"
 }

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

@@ -39,8 +39,11 @@ export type RunnerFailureCode = keyof typeof FAILURE;
 const ERROR_CODES = ['ENOENT', 'EACCES', 'EPERM', 'ENOEXEC', 'ENOMEM', 'ERR_MODULE_NOT_FOUND', 'MODULE_NOT_FOUND', 'ERR_DLOPEN_FAILED', 'ECONNREFUSED', 'ECONNRESET', 'ENOTFOUND', 'EAI_AGAIN', 'ETIMEDOUT', 'CERT_HAS_EXPIRED', 'UNABLE_TO_VERIFY_LEAF_SIGNATURE'] as const;
 const SIGNALS = ['SIGTERM', 'SIGKILL', 'SIGSEGV', 'SIGABRT', 'SIGBUS', 'SIGILL', 'SIGINT', 'SIGHUP', 'SIGPIPE'] as const;
 
+const ERROR_NAME_RE = /^[A-Z][A-Za-z0-9]{0,39}Error$/;
+
 export interface RunnerDiagnostic {
   source: 'exception' | 'stderr';
+  errorName?: string;
   errorCode?: (typeof ERROR_CODES)[number];
   httpStatus?: number;
   exitCode?: number;
@@ -49,14 +52,18 @@ export interface RunnerDiagnostic {
 
 const boundedNumber = (value: unknown, min: number, max: number): number | undefined => typeof value === 'number' && Number.isInteger(value) && value >= min && value <= max ? value : undefined;
 
+const errorNameOf = (value: unknown): string | undefined => typeof value === 'string' && value !== 'Error' && ERROR_NAME_RE.test(value) ? value : undefined;
+
 export function runnerDiagnostic(raw: unknown): RunnerDiagnostic | undefined {
   if (!isRecord(raw) || (raw.source !== 'exception' && raw.source !== 'stderr')) return undefined;
   const errorCode = ERROR_CODES.find((code) => code === raw.errorCode);
   const signal = SIGNALS.find((value) => value === raw.signal);
   const httpStatus = boundedNumber(raw.httpStatus, 400, 599);
   const exitCode = boundedNumber(raw.exitCode, 0, 255);
+  const errorName = errorNameOf(raw.errorName);
   return {
     source: raw.source,
+    ...(errorName === undefined ? {} : { errorName }),
     ...(errorCode === undefined ? {} : { errorCode }),
     ...(httpStatus === undefined ? {} : { httpStatus }),
     ...(exitCode === undefined ? {} : { exitCode }),
@@ -68,7 +75,7 @@ export function runnerFailureSummary(code: RunnerFailureCode, tool: string | nul
   const summary = code === 'tool_error' && name(tool) !== null ? `${tool} failed. See its result in Conversations.` : FAILURE[code];
   const safe = runnerDiagnostic(diagnostic);
   if (safe === undefined) return summary;
-  const details = [safe.errorCode, safe.httpStatus === undefined ? null : `HTTP ${safe.httpStatus}`, safe.exitCode === undefined ? null : `exit ${safe.exitCode}`, safe.signal].filter((value) => value !== undefined && value !== null);
+  const details = [safe.errorName, safe.errorCode, safe.httpStatus === undefined ? null : `HTTP ${safe.httpStatus}`, safe.exitCode === undefined ? null : `exit ${safe.exitCode}`, safe.signal].filter((value) => value !== undefined && value !== null);
   return details.length === 0 ? summary : `${summary} Observed: ${details.join(', ')} (${safe.source === 'stderr' ? 'startup stderr' : 'exception'}).`;
 }
 

package/runtime/sdk-runner/runner.json

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

package/runtime/sdk-runner/src/errors.ts

@@ -72,13 +72,24 @@ function processFailure(diagnostic: RunnerDiagnostic | undefined): RunnerFailure
   return diagnostic?.exitCode !== undefined || diagnostic?.signal !== undefined ? 'process_exit' : null;
 }
 
+function namedFailure(value: unknown, source: RunnerDiagnostic['source']): SessionFailure {
+  const errorName = runnerDiagnostic({ source, errorName: isRecord(value) ? value.name : undefined })?.errorName;
+  return errorName === undefined ? { code: 'session_error' } : { code: 'session_error', diagnostic: { source, errorName } };
+}
+
+export function debugFailure(stage: string, err: unknown): void {
+  if (process.env.METRO_RUNNER_DEBUG !== '1') return;
+  const text = err instanceof Error ? err.stack ?? `${err.name}: ${err.message}` : String(err);
+  process.stderr.write(`metro agent debug (${stage}, this terminal only): ${text.slice(0, 4_000)}\n`);
+}
+
 function classify(value: unknown, source: RunnerDiagnostic['source']): SessionFailure {
   const message = errorText(value);
   const known = KNOWN.find((code) => message === runnerFailureSummary(code));
   if (known !== undefined) return { code: known };
   const diagnostic = evidence(isRecord(value) ? value : {}, message, source);
   const code = diagnosticCode(message, diagnostic) ?? TEXT_FAILURES.find(([, pattern]) => pattern.test(message))?.[0] ?? processFailure(diagnostic) ?? 'session_error';
-  return code === 'session_error' ? { code } : { code, ...(diagnostic === undefined ? {} : { diagnostic }) };
+  return code === 'session_error' ? namedFailure(value, source) : { code, ...(diagnostic === undefined ? {} : { diagnostic }) };
 }
 
 export function sessionFailure(err: unknown): SessionFailure {
@@ -88,7 +99,7 @@ export function sessionFailure(err: unknown): SessionFailure {
     let result: SessionFailure = { code: 'session_error' };
     for (let depth = 0; depth < 4; depth++) {
       const next = classify(current, 'exception');
-      if (next.code !== 'session_error') result = next;
+      if (next.code !== 'session_error' || (result.code === 'session_error' && result.diagnostic === undefined)) result = next;
       if (!isRecord(current) || current.cause === undefined) break;
       current = current.cause;
     }

package/runtime/sdk-runner/src/main.ts

@@ -3,7 +3,7 @@ import { log } from '@metro-labs/core/log';
 import { Activity, failureSummary } from './activity.js';
 import { startAgent, type RunningAgent } from './app.js';
 import { runnerConfig } from './config.js';
-import { sessionFailure } from './errors.js';
+import { debugFailure, sessionFailure } from './errors.js';
 
 let agent: RunningAgent | null = null;
 let starting: Promise<RunningAgent> | null = null;
@@ -46,9 +46,11 @@ try {
     await agent.done;
     if (!exiting) activity.fail('The Agent SDK session ended unexpectedly.');
   } catch (err) {
+    debugFailure('session', err);
     if (!exiting) activity.fail(err);
   }
 } catch (err) {
+  debugFailure('start', err);
   const failure = sessionFailure(err);
   log.error({ reason: failure.code, diagnostic: failure.diagnostic, summary: failureSummary(err) }, 'sdk-runner: the Agent SDK session failed to start');
 }

package/runtime/sdk-runner/src/runner.ts

@@ -18,7 +18,7 @@ import type { SessionStore } from './session-store.js';
 import { completedCommand, SessionWatch, startedCommand, uuidsOf } from './session-watch.js';
 import { TaskRecovery } from './task-recovery.js';
 import { METRO_SERVER, type MetroTools } from './tool-proxy.js';
-import { failureSummary, SessionError, StartupDiagnostics } from './errors.js';
+import { debugFailure, failureSummary, SessionError, StartupDiagnostics } from './errors.js';
 
 const STARTUP_WAIT = 'CLAUDE_CODE_MCP_STARTUP_WAIT_MS';
 export const COMPACT_AT = 120_000;
@@ -240,6 +240,7 @@ export class Runner {
     this.switching = this.switching
       .then(() => this.applyModel(model))
       .catch((err: unknown) => {
+        debugFailure('model switch', err);
         const failure = new SessionError(this.diagnostics.failure(err));
         this.parts.activity?.fail(failure);
         log.warn({ reason: failure.failure.code, diagnostic: failure.failure.diagnostic, summary: failureSummary(failure) }, 'sdk-runner: the session could not take the model the Model page picked');