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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stage-labs/metro",
-  "version": "0.1.0-beta.296",
+  "version": "0.1.0-beta.298",
   "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.296",
+  "version": "0.1.0-beta.298",
   "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/agent-user/provision.ts

@@ -10,9 +10,11 @@ import { watchAgentView } from './view.js';
 import { closeMetroHome } from './metro-home.js';
 import { mustHelper } from '../metro-user/privilege.js';
 import { stagedPluginVersion } from '../claude/plugin-install.js';
+import { CLAUDE_CODE_VERSION } from '../claude/pinned.js';
+import { pinClaudeCode } from '../claude/version.js';
 
 const INSTALL_MS = 10 * 60_000;
-const INSTALLER = 'curl -fsSL https://claude.ai/install.sh | bash';
+const INSTALLER = `curl -fsSL https://claude.ai/install.sh | bash -s ${CLAUDE_CODE_VERSION}`;
 
 export type Provisioned = 'off' | 'failed' | 'ready';
 
@@ -55,6 +57,14 @@ function installClaude(user: AgentUser): Promise<void> {
   });
 }
 
+function pinCheckedClaude(): void {
+  try {
+    pinClaudeCode();
+  } catch (err) {
+    log.warn({ want: CLAUDE_CODE_VERSION, err: errMsg(err) }, 'agent-user: could not install the Claude Code version metro was checked with; keeping the installed one');
+  }
+}
+
 function copyMarketplace(user: AgentUser, env: NodeJS.ProcessEnv): void {
   const store = env.METRO_RUNTIME_STORE?.trim() ?? '';
   const from = join(store, 'marketplace');
@@ -71,6 +81,7 @@ export async function provisionAgentUser(env: NodeJS.ProcessEnv = process.env):
     const user = ensureUser();
     if (user === null) throw new Error(`the user ${AGENT_NAME} could not be found after creating it`);
     await installClaude(user);
+    pinCheckedClaude();
     copyMarketplace(user, env);
     watchAgentView();
     return 'ready';

package/runtime/node_modules/@metro-labs/daemon/src/claude/api.ts

@@ -212,9 +212,9 @@ function answer(method: string, path: string, query: URLSearchParams, dir: strin
 function versionAnswer(req: IncomingMessage, deps: ClaudeApiDeps): Promise<unknown> {
   const version: VersionDeps = { ...deps.version, session: deps.version?.session ?? deps.session };
   const method = req.method ?? 'GET';
-  if (method === 'GET') return claudeVersion(version);
+  if (method === 'GET') return Promise.resolve(claudeVersion(version));
   if (method !== 'POST') throw new ApiError('method not allowed', 405);
-  return updateClaude(version);
+  return Promise.resolve(updateClaude(version));
 }
 
 const SINGLETONS: Record<string, (req: IncomingMessage, deps: ClaudeApiDeps, session: ApiSession) => Promise<unknown>> = {

package/runtime/node_modules/@metro-labs/daemon/src/claude/channel-check.ts

@@ -0,0 +1,56 @@
+import { join } from 'node:path';
+import { errMsg, log } from '@metro-labs/core/log';
+import { existsSync, readdirNames, readRange } from '../agent-user/agent-fs.js';
+
+const HEAD_BYTES = 64 * 1024;
+const SKIPPED_RE = /Channel notifications skipped: ([^"\\]+)/;
+const REGISTERED = 'Channel notifications registered';
+const NAME_RE = /^(\d{4}-\d{2}-\d{2})T(\d{2})-(\d{2})-(\d{2})-(\d{3})Z\.jsonl$/;
+const SLACK_MS = 5_000;
+
+export interface ChannelState {
+  registered: boolean;
+  reason: string | null;
+}
+
+let state: ChannelState | null = null;
+
+export const channelState = (): ChannelState | null => state;
+
+export function forgetChannelState(): void {
+  state = null;
+}
+
+export const mcpLogDir = (home: string): string =>
+  join(home, '.cache', 'claude-cli-nodejs', home.replace(/[^a-zA-Z0-9]/g, '-'), 'mcp-logs-metro');
+
+const openedAt = (name: string): number => {
+  const m = NAME_RE.exec(name);
+  return m === null ? Number.NaN : Date.parse(`${m[1] ?? ''}T${m[2] ?? ''}:${m[3] ?? ''}:${m[4] ?? ''}.${m[5] ?? ''}Z`);
+};
+
+export function readChannelState(home: string, since: number): ChannelState | null {
+  const dir = mcpLogDir(home);
+  if (!existsSync(dir)) return null;
+  const newest = readdirNames(dir).filter((name) => openedAt(name) >= since - SLACK_MS).sort().at(-1);
+  if (newest === undefined) return null;
+  const head = readRange(join(dir, newest), 0, HEAD_BYTES).toString('utf8');
+  const skipped = SKIPPED_RE.exec(head);
+  if (skipped !== null) return { registered: false, reason: skipped[1]?.trim() ?? null };
+  return head.includes(REGISTERED) ? { registered: true, reason: null } : null;
+}
+
+export function noteChannelState(home: string, since: number): boolean {
+  let found: ChannelState | null;
+  try {
+    found = readChannelState(home, since);
+  } catch (err) {
+    log.debug({ err: errMsg(err) }, 'claude-session: could not read the metro MCP log of Claude Code');
+    return false;
+  }
+  if (found === null) return false;
+  state = found;
+  if (found.registered) log.info('claude-session: Claude Code registered the metro channel');
+  else log.error({ reason: found.reason }, 'claude-session: Claude Code skipped the metro channel, so chat messages do not reach the session');
+  return true;
+}

package/runtime/node_modules/@metro-labs/daemon/src/claude/pinned.ts

@@ -0,0 +1,16 @@
+import { spawnSync } from 'node:child_process';
+import { errMsg } from '@metro-labs/core/log';
+import { asAgent } from '../agent-user/user.js';
+
+export const CLAUDE_CODE_VERSION = '2.1.289';
+
+const INSTALL_TIMEOUT_MS = 5 * 60_000;
+const TAIL = 400;
+
+export function installClaudeCode(bin: string): void {
+  const run = spawnSync(...asAgent(bin, ['install', CLAUDE_CODE_VERSION]), { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'], timeout: INSTALL_TIMEOUT_MS });
+  const failed = `claude install ${CLAUDE_CODE_VERSION} failed`;
+  if (run.error !== undefined) throw new Error(`${failed}: ${errMsg(run.error)}`);
+  if (run.status === 0) return;
+  throw new Error(`${failed}: ${`${run.stderr}${run.stdout}`.trim().slice(-TAIL)}`);
+}

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

@@ -18,6 +18,7 @@ import { harnessRunner, isHarnessRunner, sdkAllowed, SDK_NEEDS_KEY, type Harness
 import { claudeAccount, claudeInstalled } from './login.js';
 import { trustFolder } from './onboarding.js';
 import { inSessionScope } from './memory.js';
+import { channelState, forgetChannelState, noteChannelState, type ChannelState } from './channel-check.js';
 import { runningAsRoot } from '../metro-user/privilege.js';
 import { agentExtraEnv, agentUser, agentUserExpected, agentViewDir, asAgent, claudeHome } from '../agent-user/user.js';
 
@@ -59,6 +60,7 @@ export interface SessionStatus {
   blocked: string | null;
   lastStartedAt: string | null;
   lastError: string | null;
+  channels?: ChannelState | null;
 }
 
 export interface SessionSnapshot {
@@ -212,12 +214,15 @@ function noteLaunchLines(pane: string, seen: Set<string>): void {
     }
 }
 
-function confirmChannels(tmux: string, until: number): void {
+function confirmChannels(tmux: string, home: string, startedAt: number): void {
+  const until = startedAt + CONFIRM_WAIT_MS;
   const seen = new Set<string>();
   let confirmed = false;
+  let checked = false;
   const tick = (): void => {
     const pane = capturePane(tmux);
     noteLaunchLines(pane, seen);
+    checked ||= noteChannelState(home, startedAt);
     if (!confirmed && pane.includes(WARNING) && pane.includes('server:metro')) {
       spawnSync(...asAgent(tmux, ['send-keys', '-t', SESSION_NAME, 'Enter']), { stdio: 'ignore' });
       log.info('claude-session: confirmed the development channels dialog for server:metro');
@@ -230,6 +235,7 @@ function confirmChannels(tmux: string, until: number): void {
 
 function recordStart(deps: SessionDeps, tmux: string, now: number, run: { error?: Error; status: number | null; stderr: string }): void {
   memory.lastStartedAt = now;
+  forgetChannelState();
   if (run.error !== undefined || run.status !== 0) {
     memory.lastError = run.error === undefined ? `tmux new-session exited ${String(run.status)}: ${run.stderr.trim()}` : errMsg(run.error);
     log.warn({ err: memory.lastError }, 'claude-session: tmux could not start');
@@ -238,7 +244,7 @@ function recordStart(deps: SessionDeps, tmux: string, now: number, run: { error?
   memory.lastError = null;
   const agents = deps.agents ?? agentsDir();
   writeState(agents, { version: deps.version ?? METRO_VERSION, runner: harnessRunner(agents) });
-  confirmChannels(tmux, now + CONFIRM_WAIT_MS);
+  confirmChannels(tmux, sessionHome(deps), now);
 }
 
 function tmuxLaunch(deps: SessionDeps, tmux: string, args: string[]): [string, string[]] {
@@ -296,6 +302,7 @@ export function sessionStatus(deps: SessionDeps = {}): SessionStatus {
     autostart: autostartEnabled(deps.agents ?? agentsDir()),
     blocked: sessionBlocked(deps),
     lastError: memory.lastError,
+    channels: channelState(),
   };
 }
 

package/runtime/node_modules/@metro-labs/daemon/src/claude/version.ts

@@ -3,31 +3,23 @@ import { homedir } from 'node:os';
 import { join } from 'node:path';
 import { ApiError } from '@metro-labs/http/api-error';
 import { errMsg, log } from '@metro-labs/core/log';
-import { isRecord } from '@metro-labs/core/is-record';
 import { sessionRunning, stopSession, type SessionDeps } from './session.js';
 import { agentUser, asAgent, claudeBin } from '../agent-user/user.js';
+import { CLAUDE_CODE_VERSION, installClaudeCode } from './pinned.js';
 
-const LATEST_URL = 'https://registry.npmjs.org/@anthropic-ai/claude-code/latest';
 const VERSION_RE = /(\d+)\.(\d+)\.(\d+)/;
-const CACHE_MS = 10 * 60_000;
-const INSTALL_TIMEOUT_MS = 5 * 60_000;
-const TAIL = 400;
 
 export interface VersionDeps {
   claude?: string;
-  fetchImpl?: typeof fetch;
   session?: SessionDeps;
-  now?: () => number;
 }
 
 export interface ClaudeVersion {
   installed: string | null;
-  latest: string | null;
+  latest: string;
   newer: boolean;
 }
 
-let cached: { latest: string | null; at: number } | null = null;
-
 function candidates(deps: VersionDeps): string[] {
   if (deps.claude !== undefined) return [deps.claude];
   return agentUser() === null ? ['claude', join(homedir(), '.local', 'bin', 'claude')] : [claudeBin()];
@@ -51,48 +43,9 @@ function located(deps: VersionDeps): { bin: string; installed: string } | null {
   return null;
 }
 
-export function newerThan(a: string, b: string): boolean {
-  const left = a.split('.').map(Number);
-  const right = b.split('.').map(Number);
-  for (let i = 0; i < 3; i += 1) {
-    const d = (left[i] ?? 0) - (right[i] ?? 0);
-    if (d !== 0) return d > 0;
-  }
-  return false;
-}
-
-async function latestClaudeVersion(deps: VersionDeps = {}): Promise<string | null> {
-  const now = (deps.now ?? Date.now)();
-  if (cached !== null && now - cached.at < CACHE_MS) return cached.latest;
-  const fetchImpl = deps.fetchImpl ?? fetch;
-  let latest: string | null = null;
-  try {
-    const res = await fetchImpl(LATEST_URL, { headers: { accept: 'application/json' }, redirect: 'manual' });
-    const body: unknown = res.ok ? await res.json() : null;
-    latest = isRecord(body) && typeof body.version === 'string' ? parse(body.version) : null;
-  } catch (err) {
-    log.warn({ err: errMsg(err) }, 'claude-version: could not read the latest version from npm');
-  }
-  cached = { latest, at: now };
-  return latest;
-}
-
-export function forgetClaudeVersion(): void {
-  cached = null;
-}
-
-export async function claudeVersion(deps: VersionDeps = {}): Promise<ClaudeVersion> {
+export function claudeVersion(deps: VersionDeps = {}): ClaudeVersion {
   const installed = located(deps)?.installed ?? null;
-  const latest = await latestClaudeVersion(deps);
-  return { installed, latest, newer: installed !== null && latest !== null && newerThan(latest, installed) };
-}
-
-function install(bin: string): void {
-  const run = spawnSync(...asAgent(bin, ['install', 'latest']), { encoding: 'utf8', stdio: ['ignore', 'pipe', 'pipe'], timeout: INSTALL_TIMEOUT_MS });
-  if (run.error !== undefined) throw new ApiError(`claude install latest failed: ${errMsg(run.error)}`, 502);
-  if (run.status === 0) return;
-  const said = `${run.stderr ?? ''}${run.stdout ?? ''}`.trim().slice(-TAIL);
-  throw new ApiError(`claude install latest failed: ${said}`, 502);
+  return { installed, latest: CLAUDE_CODE_VERSION, newer: installed !== null && installed !== CLAUDE_CODE_VERSION };
 }
 
 function restartIfChanged(changed: boolean, session: SessionDeps): boolean {
@@ -101,13 +54,23 @@ function restartIfChanged(changed: boolean, session: SessionDeps): boolean {
   return true;
 }
 
-export async function updateClaude(deps: VersionDeps = {}): Promise<ClaudeVersion & { restarted: boolean }> {
+export function updateClaude(deps: VersionDeps = {}): ClaudeVersion & { restarted: boolean } {
   const found = located(deps);
   if (found === null) throw new ApiError('Claude Code is not installed on this machine', 404);
-  install(found.bin);
-  forgetClaudeVersion();
-  const after = await claudeVersion(deps);
+  try {
+    installClaudeCode(found.bin);
+  } catch (err) {
+    throw new ApiError(errMsg(err), 502);
+  }
+  const after = claudeVersion(deps);
   const restarted = restartIfChanged(after.installed !== null && after.installed !== found.installed, deps.session ?? {});
   log.info({ from: found.installed, to: after.installed, restarted }, 'claude-version: Claude Code updated');
   return { ...after, restarted };
 }
+
+export function pinClaudeCode(deps: VersionDeps = {}): void {
+  const found = located(deps);
+  if (found === null || found.installed === CLAUDE_CODE_VERSION) return;
+  installClaudeCode(found.bin);
+  log.info({ from: found.installed, to: located(deps)?.installed ?? null }, 'claude-version: installed the Claude Code version metro was checked with');
+}

package/runtime/node_modules/@metro-labs/daemon/src/connectors/migration-guard.ts

@@ -8,6 +8,7 @@ import { assertMigrationOutcomeKnown, beginMigrationOperation, drainMigrationLis
 const locked = (phase: string): boolean => phase !== 'rolled_back';
 const retired = (record: NonNullable<ReturnType<typeof migrationRecord>>): boolean => record.move === true || record.phase === 'cutover' || record.phase === 'active' || record.phase === 'rollback';
 const refused = (): ApiError => new ApiError('This local connector is locked while it moves to the organization.', 409);
+const editRefused = (): ApiError => new ApiError('This local connector is locked while it moves to the organization. To change or remove it, open Move to organization and roll back its migration first.', 409);
 
 export function migrationSource(id: string, dir = agentsDir()): ReturnType<typeof migrationRecords>[number] | null {
   const record = migrationRecord(id, dir);
@@ -27,7 +28,7 @@ export function assertLocalMigrationUse(id: string, dir = agentsDir()): void {
 }
 
 export function assertLocalMigrationEdit(id: string, dir = agentsDir()): void {
-  if (migrationRecords(dir).some((record) => locked(record.phase) && record.sourceId === id)) throw refused();
+  if (migrationRecords(dir).some((record) => locked(record.phase) && record.sourceId === id)) throw editRefused();
 }
 
 export function migrationExportableRows<T extends { id: string; name: string }>(rows: readonly T[], dir = agentsDir()): T[] {

package/runtime/node_modules/@metro-labs/daemon/src/connectors/org-runtime-discovery.ts

@@ -98,8 +98,9 @@ export async function discoverOrgGroups(url: string, guard: DiscoveryGuard): Pro
       try {
         return await guardedRequest(input, init, guard, budget);
       } catch (error) {
-        failure.error = orgRuntimeError(error);
-        throw failure.error;
+        const safe = orgRuntimeError(error);
+        if (init?.method !== 'DELETE' || safe.status !== 502) failure.error = safe;
+        throw safe;
       }
     };
     const tools = await listRemoteTools(new URL(url), { kind: 'none' }, send);

package/runtime/runtime.json

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

package/runtime/sdk-runner/runner.json

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