@zhixuan92/multi-model-agent 5.0.2 → 5.0.3

package/dist/cli/logs.d.ts

@@ -0,0 +1,15 @@
+import type { MultiModelConfig } from '@zhixuan92/multi-model-agent-core';
+export interface LogsDeps {
+    config: MultiModelConfig;
+    homeDir?: string;
+    follow?: boolean;
+    batchId?: string;
+    /** Polling interval when --follow; defaults to 300ms. */
+    pollMs?: number;
+    /** Max time to wait for the log file to appear under --follow; defaults to 30s. */
+    waitForLogMs?: number;
+    stdout?: (s: string) => boolean;
+    stderr?: (s: string) => boolean;
+}
+export declare function runLogs(deps: LogsDeps): Promise<number>;
+//# sourceMappingURL=logs.d.ts.map

package/dist/cli/logs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.d.ts","sourceRoot":"","sources":["../../src/cli/logs.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAE1E,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,gBAAgB,CAAC;IACzB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,yDAAyD;IACzD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAChC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;CACjC;AAeD,wBAAsB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CA0E7D"}

package/dist/cli/logs.js

@@ -0,0 +1,102 @@
+/**
+ * logs.ts — `mmagent logs` subcommand.
+ *
+ * Tails the diagnostic log file for today (mmagent-YYYY-MM-DD.jsonl). Supports
+ * --follow for tail-F semantics and --batch=<id> to filter to a single batch.
+ *
+ * Exit codes:
+ *   0 — success (including "no log file found" cases so scripts don't break)
+ *   1 — reserved for future use
+ */
+import * as os from 'node:os';
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+function todayUtc() {
+    return new Date().toISOString().slice(0, 10);
+}
+function resolveLogPath(config, homeDir) {
+    const dir = config.diagnostics?.logDir ?? path.join(homeDir, '.multi-model', 'logs');
+    return path.join(dir, `mmagent-${todayUtc()}.jsonl`);
+}
+function matchesBatch(line, batchId) {
+    return line.includes(`"batchId":"${batchId}"`);
+}
+export async function runLogs(deps) {
+    const stdout = deps.stdout ?? process.stdout.write.bind(process.stdout);
+    const stderr = deps.stderr ?? process.stderr.write.bind(process.stderr);
+    const homeDir = deps.homeDir ?? os.homedir();
+    const follow = deps.follow ?? false;
+    const pollMs = deps.pollMs ?? 300;
+    const waitForLogMs = deps.waitForLogMs ?? 30_000;
+    if (!deps.config.diagnostics?.log) {
+        stderr(`mmagent logs: diagnostics.log is false in config; set it to true to capture new events.\n`);
+    }
+    const logPath = resolveLogPath(deps.config, homeDir);
+    if (!fs.existsSync(logPath)) {
+        if (!follow) {
+            stderr(`mmagent logs: no log file at ${logPath}. Start the server with diagnostics.log: true and try again.\n`);
+            return 0;
+        }
+        const deadline = Date.now() + waitForLogMs;
+        while (!fs.existsSync(logPath) && Date.now() < deadline) {
+            await new Promise((r) => setTimeout(r, pollMs));
+        }
+        if (!fs.existsSync(logPath)) {
+            stderr(`mmagent logs: no log file appeared within ${Math.floor(waitForLogMs / 1000)}s at ${logPath}.\n`);
+            return 0;
+        }
+    }
+    // Emit existing content (optionally batch-filtered).
+    let offset = 0;
+    try {
+        const existing = fs.readFileSync(logPath, 'utf8');
+        for (const line of existing.split('\n')) {
+            if (line.length === 0)
+                continue;
+            if (deps.batchId && !matchesBatch(line, deps.batchId))
+                continue;
+            stdout(line + '\n');
+        }
+        offset = existing.length;
+    }
+    catch (err) {
+        stderr(`mmagent logs: cannot read ${logPath}: ${err instanceof Error ? err.message : String(err)}\n`);
+        return 0;
+    }
+    if (!follow)
+        return 0;
+    // Tail — poll for new content appended after `offset`.
+    let buf = '';
+    while (true) {
+        await new Promise((r) => setTimeout(r, pollMs));
+        let stat;
+        try {
+            stat = fs.statSync(logPath);
+        }
+        catch {
+            continue;
+        }
+        if (stat.size <= offset)
+            continue;
+        const fd = fs.openSync(logPath, 'r');
+        try {
+            const chunk = Buffer.alloc(stat.size - offset);
+            fs.readSync(fd, chunk, 0, chunk.length, offset);
+            buf += chunk.toString('utf8');
+            offset = stat.size;
+        }
+        finally {
+            fs.closeSync(fd);
+        }
+        const lines = buf.split('\n');
+        buf = lines.pop() ?? ''; // keep any trailing partial line for the next iteration
+        for (const line of lines) {
+            if (line.length === 0)
+                continue;
+            if (deps.batchId && !matchesBatch(line, deps.batchId))
+                continue;
+            stdout(line + '\n');
+        }
+    }
+}
+//# sourceMappingURL=logs.js.map

package/dist/cli/logs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logs.js","sourceRoot":"","sources":["../../src/cli/logs.ts"],"names":[],"mappings":"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"}

package/dist/cli/print-token.d.ts

@@ -0,0 +1,18 @@
+export interface PrintTokenDeps {
+    /** Home directory (defaults to os.homedir()). */
+    homeDir?: string;
+    /** Token file path (already expanded). Overrides config discovery. */
+    tokenFile?: string;
+    /** Environment variable accessor. Defaults to process.env. */
+    env?: Record<string, string | undefined>;
+    /** Write to stdout. Defaults to process.stdout.write. */
+    stdout?: (s: string) => boolean;
+    /** Write to stderr. Defaults to process.stderr.write. */
+    stderr?: (s: string) => boolean;
+}
+/**
+ * Read the bearer token and print it to stdout.
+ * Returns 0 on success, 1 on error.
+ */
+export declare function printToken(deps?: PrintTokenDeps): number;
+//# sourceMappingURL=print-token.d.ts.map

package/dist/cli/print-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"print-token.d.ts","sourceRoot":"","sources":["../../src/cli/print-token.ts"],"names":[],"mappings":"AAoBA,MAAM,WAAW,cAAc;IAC7B,iDAAiD;IACjD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8DAA8D;IAC9D,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACzC,yDAAyD;IACzD,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAChC,yDAAyD;IACzD,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;CACjC;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,GAAE,cAAmB,GAAG,MAAM,CAsC5D"}

package/dist/cli/print-token.js

@@ -0,0 +1,60 @@
+/**
+ * print-token.ts — `mmagent print-token` subcommand.
+ *
+ * Reads the bearer auth token and prints it to stdout.
+ * Env override (MMAGENT_AUTH_TOKEN) wins over any file.
+ * Missing file → prints an error message to stderr and exits 1.
+ *
+ * Usage:
+ *   mmagent print-token [--config <path>]
+ */
+import * as os from 'node:os';
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+/** Expand a leading '~/' to the home directory. */
+function expandHome(p, homeDir) {
+    if (p.startsWith('~/'))
+        return path.join(homeDir, p.slice(2));
+    return p;
+}
+/**
+ * Read the bearer token and print it to stdout.
+ * Returns 0 on success, 1 on error.
+ */
+export function printToken(deps = {}) {
+    const homeDir = deps.homeDir ?? os.homedir();
+    const env = deps.env ?? process.env;
+    const stdout = deps.stdout ?? process.stdout.write.bind(process.stdout);
+    const stderr = deps.stderr ?? process.stderr.write.bind(process.stderr);
+    // Env override wins
+    const envToken = (env['MMAGENT_AUTH_TOKEN'] ?? '').trim();
+    if (envToken.length > 0) {
+        stdout(envToken + '\n');
+        return 0;
+    }
+    // Fall back to token file
+    const rawTokenFile = deps.tokenFile ?? path.join(homeDir, '.multi-model', 'auth-token');
+    const tokenFile = expandHome(rawTokenFile, homeDir);
+    try {
+        const token = fs.readFileSync(tokenFile, 'utf-8').trim();
+        if (token.length === 0) {
+            stderr(`mmagent: token file is empty: ${tokenFile}\n`);
+            return 1;
+        }
+        stdout(token + '\n');
+        return 0;
+    }
+    catch (err) {
+        const code = err.code;
+        if (code === 'ENOENT') {
+            stderr(`mmagent: token file not found: ${tokenFile}\n` +
+                `Run 'mmagent serve' once to generate a token, or set MMAGENT_AUTH_TOKEN.\n`);
+        }
+        else {
+            const msg = err instanceof Error ? err.message : String(err);
+            stderr(`mmagent: cannot read token file ${tokenFile}: ${msg}\n`);
+        }
+        return 1;
+    }
+}
+//# sourceMappingURL=print-token.js.map

package/dist/cli/print-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"print-token.js","sourceRoot":"","sources":["../../src/cli/print-token.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAE9B,mDAAmD;AACnD,SAAS,UAAU,CAAC,CAAS,EAAE,OAAe;IAC5C,IAAI,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,OAAO,CAAC,CAAC;AACX,CAAC;AAeD;;;GAGG;AACH,MAAM,UAAU,UAAU,CAAC,OAAuB,EAAE;IAClD,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;IAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IACpC,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACxE,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAExE,oBAAoB;IACpB,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1D,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;QACxB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,0BAA0B;IAC1B,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC;IACxF,MAAM,SAAS,GAAG,UAAU,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAEpD,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QACzD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,iCAAiC,SAAS,IAAI,CAAC,CAAC;YACvD,OAAO,CAAC,CAAC;QACX,CAAC;QACD,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC;QACrB,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,GAAI,GAA6B,CAAC,IAAI,CAAC;QACjD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;YACtB,MAAM,CACJ,kCAAkC,SAAS,IAAI;gBAC/C,4EAA4E,CAC7E,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,MAAM,CAAC,mCAAmC,SAAS,KAAK,GAAG,IAAI,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC"}

package/dist/cli/serve.d.ts

@@ -0,0 +1,28 @@
+import type { MultiModelConfig } from '@zhixuan92/multi-model-agent-core';
+export declare function maybeAutoUpdateSkills(config: MultiModelConfig, stderr: (s: string) => boolean): Promise<void>;
+/** A running server handle returned by startServe(). */
+export interface ServeHandle {
+    /** The port the server is listening on (useful when port=0 for ephemeral). */
+    port: number;
+    /**
+     * Gracefully shut down the server.
+     * Removes any registered SIGTERM/SIGINT handlers to prevent leaks.
+     * After this resolves, the process is no longer listening and may exit safely.
+     */
+    stop(): Promise<void>;
+}
+/**
+ * Start the HTTP server with the given config.
+ *
+ * Registers SIGTERM and SIGINT handlers that drain in-flight requests and
+ * exit the process cleanly. If config includes `server.limits.shutdownDrainMs`,
+ * the server will wait up to that duration for in-flight requests to finish.
+ *
+ * @param config  Full MultiModelConfig (includes agents.*, defaults, diagnostics,
+ *                and server block).  startServer() inspects the agents.* field
+ *                and enables real tool handlers when present.
+ * @param exit    Process exit function — defaults to process.exit.
+ *                Exposed so tests can suppress actual exits.
+ */
+export declare function startServe(config: MultiModelConfig, exit?: (code: number) => never): Promise<ServeHandle>;
+//# sourceMappingURL=serve.d.ts.map

package/dist/cli/serve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve.d.ts","sourceRoot":"","sources":["../../src/cli/serve.ts"],"names":[],"mappings":"AAsBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AA2B1E,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,gBAAgB,EACxB,MAAM,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,GAC7B,OAAO,CAAC,IAAI,CAAC,CAsCf;AAiBD,wDAAwD;AACxD,MAAM,WAAW,WAAW;IAC1B,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACvB;AAgBD;;;;;;;;;;;;GAYG;AACH,wBAAsB,UAAU,CAC9B,MAAM,EAAE,gBAAgB,EACxB,IAAI,GAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAkC,GACzD,OAAO,CAAC,WAAW,CAAC,CA2QtB"}

package/dist/cli/serve.js

@@ -0,0 +1,405 @@
+/**
+ * serve.ts — starts the HTTP server and manages its signal lifecycle.
+ *
+ * This module owns the complete serve lifecycle: starting the HTTP server,
+ * registering SIGTERM/SIGINT handlers, draining in-flight requests, and
+ * cleanly exiting the process. The CLI entry point (cli/index.ts) delegates
+ * to this module and does not manage signals directly.
+ *
+ * Usage (library):
+ *   const handle = await startServe(config);
+ *   // server is running on handle.port
+ *   await handle.stop(); // graceful shutdown; no process.exit
+ *
+ * Usage (CLI):
+ *   mmagent serve [--config <path>]
+ *   // this module owns signal handling and process.exit
+ */
+import { createHash, randomUUID } from 'node:crypto';
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import { fileURLToPath } from 'node:url';
+import { collectInlineApiKeyOffenders, loadAuthToken } from '@zhixuan92/multi-model-agent-core';
+import { startServer } from '../http/server.js';
+import { setDraining } from '../http/request-pipeline.js';
+import { createRecorder } from '../telemetry/recorder.js';
+import { Flusher } from '../telemetry/flusher.js';
+import { Queue } from '../telemetry/queue.js';
+import { runSyncSkills } from './sync-skills.js';
+import { listEntries, FutureManifestError } from '../skill-install/manifest.js';
+import { readSkillContent, SUPPORTED_SKILLS } from '../skill-install/discover.js';
+import { findMissingSkills } from '../skill-install/skill-installer-common.js';
+import matter from 'gray-matter';
+function isSkillBehind(entryName, entrySkillVersion) {
+    const src = readSkillContent(entryName);
+    if (src === null)
+        return false; // skill removed from bundle — sync-skills will drop it
+    try {
+        const parsed = matter(src);
+        const v = parsed.data['version'];
+        return typeof v === 'string' && v !== entrySkillVersion;
+    }
+    catch {
+        return false;
+    }
+}
+export async function maybeAutoUpdateSkills(config, stderr) {
+    let entries;
+    try {
+        entries = listEntries();
+    }
+    catch (err) {
+        if (err instanceof FutureManifestError) {
+            stderr(`[mmagent] warning: ${err.message}; skipping skill auto-sync\n`);
+            return;
+        }
+        return; // best-effort — never let manifest IO issues block serve
+    }
+    const behind = entries.filter((e) => isSkillBehind(e.name, e.skillVersion));
+    const missing = findMissingSkills(entries, SUPPORTED_SKILLS);
+    if (behind.length === 0 && missing.length === 0)
+        return;
+    if (!config.server.autoUpdateSkills) {
+        const drift = [];
+        if (behind.length > 0)
+            drift.push(`${behind.length} out of date (${behind.map((e) => e.name).join(', ')})`);
+        if (missing.length > 0)
+            drift.push(`${missing.length} new (${missing.map((m) => m.name).join(', ')})`);
+        stderr(`[mmagent] skill drift: ${drift.join('; ')}. ` +
+            `Run 'mmagent sync-skills' to reconcile (or set server.autoUpdateSkills=true in config).\n`);
+        return;
+    }
+    const deadlineMs = 5000;
+    try {
+        await Promise.race([
+            runSyncSkills({ silent: true, bestEffort: true, ifExists: true }),
+            new Promise((resolve) => setTimeout(() => resolve(), deadlineMs)),
+        ]);
+        if (behind.length > 0)
+            process.stdout.write(`[mmagent] auto-synced ${behind.length} updated skill(s)\n`);
+        if (missing.length > 0)
+            process.stdout.write(`[mmagent] auto-synced ${missing.length} new skill(s): ${missing.map((m) => m.name).join(', ')}\n`);
+    }
+    catch {
+        // bestEffort swallows inside; extra safety here.
+    }
+}
+function readServerVersion() {
+    try {
+        const thisDir = path.dirname(fileURLToPath(import.meta.url));
+        const pkgPath = path.join(thisDir, '..', '..', 'package.json');
+        const pkg = JSON.parse(fs.readFileSync(pkgPath, 'utf8'));
+        return pkg.version ?? '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+function envVarHint(agentName) {
+    return `${agentName.toUpperCase().replace(/[^A-Z0-9]/g, '_')}_API_KEY`;
+}
+/**
+ * Shared signal-state used to deduplicate shutdown if two signals arrive
+ * before stop() resolves.
+ */
+let stopInFlight = false;
+// Stored so they can be removed when stop() is called programmatically
+let onSigterm;
+let onSigint;
+let onStdoutErrorRef;
+let onStderrErrorRef;
+let onUncaughtRef;
+let onUnhandledRejectionRef;
+/**
+ * Start the HTTP server with the given config.
+ *
+ * Registers SIGTERM and SIGINT handlers that drain in-flight requests and
+ * exit the process cleanly. If config includes `server.limits.shutdownDrainMs`,
+ * the server will wait up to that duration for in-flight requests to finish.
+ *
+ * @param config  Full MultiModelConfig (includes agents.*, defaults, diagnostics,
+ *                and server block).  startServer() inspects the agents.* field
+ *                and enables real tool handlers when present.
+ * @param exit    Process exit function — defaults to process.exit.
+ *                Exposed so tests can suppress actual exits.
+ */
+export async function startServe(config, exit = process.exit.bind(process)) {
+    const stderr = process.stderr.write.bind(process.stderr);
+    // Auto-update installed skills before bind (bounded 5s; never blocks indefinitely).
+    await maybeAutoUpdateSkills(config, stderr);
+    // Drift check — warn if installed skills don't match the canonical manifest.
+    try {
+        const { makeSkillManifestSync } = await import('../skill-install/skill-manifest-sync.js');
+        const { discoverPerClientInstallDirs } = await import('../skill-install/discover.js');
+        const sync = makeSkillManifestSync(discoverPerClientInstallDirs());
+        const drift = sync.driftReport();
+        if (drift.length > 0) {
+            const summary = drift.map(d => `${d.client}/${d.skill}=${d.issue}`).join(', ');
+            stderr(`[mmagent] WARN: skill manifest drift detected: ${summary}. Re-run 'mmagent sync-skills' to reconcile.\n`);
+        }
+    }
+    catch {
+        // best-effort — never let drift check block serve
+    }
+    // Create the telemetry recorder BEFORE startServer. The server's bus
+    // subscriber (TelemetryUploader) calls getRecorder() during startServer →
+    // if recorder is null at that moment, the uploader is wired with
+    // recorder=null and silently drops every event for the daemon's lifetime.
+    const homeDir = path.join(os.homedir(), '.multi-model');
+    const mmagentVersion = readServerVersion();
+    createRecorder({ homeDir, mmagentVersion });
+    // Pass the full MultiModelConfig (not just the server block) so
+    // registerToolHandlers sees `agents` and registers real tool endpoints.
+    // Stripping to { server } here caused a 3.1.0 regression where tool
+    // endpoints returned 503 'no_agent_config' even when agents were set.
+    const running = await startServer(config);
+    // ── stdout/stderr error + uncaught/unhandled rejection guards ────────
+    const logShutdown = (_cause) => {
+        // Option A: no diagnostics surface today. Cause name routed via stderr only.
+        // Option B (follow-up): wire running.diagnostics?.shutdown(_cause) here.
+    };
+    const onStdoutError = (err) => {
+        if (err.code === 'EPIPE') {
+            logShutdown('stdout_epipe');
+            exit(0);
+        }
+        logShutdown('stdout_other_error');
+        try {
+            process.stderr.write(`[mmagent] stdout error: ${err.message}\n`);
+        }
+        catch { /* stderr may also be dead */ }
+        exit(1);
+    };
+    const onStderrError = (err) => {
+        if (err.code === 'EPIPE') {
+            logShutdown('stdout_epipe');
+            exit(0);
+        }
+        logShutdown('stdout_other_error');
+        exit(1);
+    };
+    const onUncaught = (err) => {
+        const errno = err?.code;
+        if (errno === 'EPIPE') {
+            logShutdown('stdout_epipe');
+            exit(0);
+        }
+        logShutdown('uncaughtException');
+        try {
+            const msg = err instanceof Error ? (err.stack ?? err.message) : String(err);
+            process.stderr.write(`[mmagent] uncaught exception: ${msg}\n`);
+        }
+        catch { /* best-effort */ }
+        exit(1);
+    };
+    const onUnhandledRejection = (reason) => {
+        const errno = reason?.code;
+        if (errno === 'EPIPE') {
+            logShutdown('stdout_epipe');
+            exit(0);
+        }
+        logShutdown('unhandledRejection');
+        try {
+            const msg = reason instanceof Error ? (reason.stack ?? reason.message) : String(reason);
+            process.stderr.write(`[mmagent] unhandled rejection: ${msg}\n`);
+        }
+        catch { /* best-effort */ }
+        exit(1);
+    };
+    process.stdout.on('error', onStdoutError);
+    process.stderr.on('error', onStderrError);
+    process.on('uncaughtException', onUncaught);
+    process.on('unhandledRejection', onUnhandledRejection);
+    onStdoutErrorRef = onStdoutError;
+    onStderrErrorRef = onStderrError;
+    onUncaughtRef = onUncaught;
+    onUnhandledRejectionRef = onUnhandledRejection;
+    // Recorder was created above (BEFORE startServer). homeDir + mmagentVersion
+    // are computed there and reused here for the version-pin file + Flusher.
+    const lastVersionPath = path.join(homeDir, 'last-version');
+    let lastVersion = null;
+    try {
+        lastVersion = fs.readFileSync(lastVersionPath, 'utf8').trim();
+    }
+    catch {
+        // first run — no last-version file yet
+    }
+    if (lastVersion !== mmagentVersion) {
+        try {
+            fs.mkdirSync(homeDir, { recursive: true });
+            fs.writeFileSync(lastVersionPath, mmagentVersion + '\n', { mode: 0o600 });
+        }
+        catch (err) {
+            stderr(`[mmagent] warning: failed to write last-version at ${lastVersionPath}: ${err instanceof Error ? err.message : String(err)}\n`);
+        }
+    }
+    // Telemetry uploader. Default endpoint ships to the project's hosted
+    // dashboard. MMAGENT_TELEMETRY_ENDPOINT overrides for self-hosted backends;
+    // setting it to an empty string disables shipping entirely (events stay in
+    // ~/.multi-model/telemetry-queue.ndjson). The real off-switch for telemetry
+    // is the consent flag (MMAGENT_TELEMETRY=0 / config.telemetry.enabled =
+    // false) — when consent is off the recorder enqueues nothing, so the
+    // flusher's tick is a no-op even with the default endpoint set.
+    const DEFAULT_TELEMETRY_ENDPOINT = 'https://mma-telemetry-frontend.x1.lucazhang.work/v1/events';
+    const envEndpoint = process.env.MMAGENT_TELEMETRY_ENDPOINT;
+    const telemetryEndpoint = envEndpoint === undefined
+        ? DEFAULT_TELEMETRY_ENDPOINT
+        : envEndpoint.trim();
+    let flusher = null;
+    if (telemetryEndpoint) {
+        flusher = new Flusher({
+            queue: new Queue(homeDir),
+            dir: homeDir,
+            endpoint: telemetryEndpoint,
+        });
+        flusher.start();
+    }
+    // Fire once at serve startup. Lives here (not in loadConfigFromFile) so
+    // print-token / info / status don't re-emit the same warning repeatedly.
+    const inlineOffenders = collectInlineApiKeyOffenders(config);
+    if (inlineOffenders.length > 0) {
+        const firstHint = envVarHint(inlineOffenders[0]);
+        stderr(`[mmagent] WARNING: inline apiKey in config for agent(s): ${inlineOffenders.join(', ')}.\n` +
+            `  Fix:\n` +
+            `    export ${firstHint}='<your-key>'\n` +
+            `    # then in config.json, replace\n` +
+            `    #   "apiKey": "..."\n` +
+            `    # with\n` +
+            `    #   "apiKeyEnv": "${firstHint}"\n`);
+    }
+    const cleanupSignal = (sig) => {
+        if (stopInFlight)
+            return;
+        stopInFlight = true;
+        stderr(`[mmagent] received ${sig}, shutting down gracefully\u2026\n`);
+        // 1) Refuse new dispatches immediately so they don't compound the drain.
+        setDraining(true);
+        // 2) Walk BatchRegistry: close every in-flight task's sessions in parallel
+        //    with a 5-second wall clock. After the grace window, SIGKILL any
+        //    subprocess still alive whose session exposes a pid. Without this,
+        //    SIGTERM-killed daemons leaked codex children as orphans (see 2026-05-16
+        //    OOM post-mortem).
+        const SHUTDOWN_GRACE_MS = 5000;
+        const inflight = running.batchRegistry?.allInFlight?.() ?? [];
+        const closeAll = Promise.allSettled(inflight.flatMap((entry) => {
+            const ctxs = entry.executionContexts ? Array.from(entry.executionContexts.values()) : [];
+            return ctxs.map(async (ec) => {
+                try {
+                    await ec.closeSessions();
+                }
+                catch { /* swallow */ }
+            });
+        }));
+        const drainSessions = Promise.race([
+            closeAll,
+            new Promise((resolve) => setTimeout(resolve, SHUTDOWN_GRACE_MS).unref()),
+        ]).then(() => {
+            // Belt-and-suspenders: SIGKILL anything still alive whose pid we know.
+            for (const entry of inflight) {
+                const ctxs = entry.executionContexts ? Array.from(entry.executionContexts.values()) : [];
+                for (const ec of ctxs) {
+                    for (const pid of ec.getActivePids?.() ?? []) {
+                        try {
+                            process.kill(pid, 'SIGKILL');
+                        }
+                        catch { /* already dead */ }
+                    }
+                }
+            }
+        });
+        const drainTelemetry = flusher ? flusher.drain() : Promise.resolve();
+        drainSessions
+            .catch(() => { })
+            .then(() => drainTelemetry)
+            .catch(() => { })
+            .then(() => running.stop())
+            .then(() => exit(0))
+            .catch((err) => {
+            const msg = err instanceof Error ? err.message : String(err);
+            stderr(`[mmagent] shutdown failed: ${msg}\n`);
+            exit(1);
+        });
+    };
+    // Register handlers using named references so they can be removed correctly.
+    // Using anonymous wrappers (e.g. `process.once('SIGTERM', () => fn(sig))`)
+    // would make process.off(sig, fn) unable to find and remove the listener.
+    onSigterm = () => cleanupSignal('SIGTERM');
+    onSigint = () => cleanupSignal('SIGINT');
+    process.once('SIGTERM', onSigterm);
+    process.once('SIGINT', onSigint);
+    // Print the actual bound address so operators see what the kernel assigned
+    // (useful when port=0 selects an ephemeral port).
+    const host = running.serverAddress ?? config.server.bind;
+    // Emit a single structured startup line before the "listening" line.
+    // Fingerprint the auth token (first 8 hex of sha256) so operators can verify
+    // the running instance matches what their clients are using, without ever
+    // revealing the token. bootId discriminates successive startups from the same pid.
+    try {
+        const token = loadAuthToken({ tokenFile: config.server.auth.tokenFile });
+        const fp = createHash('sha256').update(token).digest('hex').slice(0, 8);
+        const bootId = randomUUID();
+        const version = readServerVersion();
+        process.stdout.write(`[mmagent] started | version=${version} | bind=${host}:${running.port} | pid=${process.pid} | token=${fp} | boot=${bootId}\n`);
+    }
+    catch {
+        // Token load shouldn't fail here (startServer already validated it), but
+        // if it does, skip the startup line rather than crash the server.
+    }
+    // Per-tier model lines so operators can see which provider is wired to
+    // each agent slot. The complex tier handles read-only sub-workers + most
+    // implementer work; the standard tier handles annotator/reviewer + the
+    // explore route's internal half. When a tier is unconfigured, log it as
+    // "(not configured)" so a misconfigured slot is visible at boot time.
+    const fmtTier = (slot) => {
+        const cfg = config.agents[slot];
+        if (!cfg || !cfg.model)
+            return '(not configured)';
+        return `${cfg.model} [${cfg.type ?? 'unknown'}]`;
+    };
+    process.stdout.write(`[mmagent] tiers | complex=${fmtTier('complex')} | standard=${fmtTier('standard')}\n`);
+    // A4a.4 (4.2.2+): warn when stale Claude Code project siblings exist
+    // under /tmp/claude/G--*. These come from prior Claude Code test runs
+    // and confuse worker cwd resolution if a caller passes one as ?cwd=.
+    // The validator already rejects them at request time (A4a.1); this
+    // startup scan surfaces the contamination so operators clean it up.
+    // Pure log behavior — does NOT block startup.
+    for (const root of ['/tmp/claude', '/private/tmp/claude']) {
+        try {
+            if (!fs.existsSync(root))
+                continue;
+            const stale = fs.readdirSync(root).filter(e => e.startsWith('G--'));
+            if (stale.length > 0) {
+                process.stdout.write(`[mmagent] WARNING: ${stale.length} stale Claude Code project sibling(s) under ${root}/G--*. ` +
+                    `These can confuse cwd resolution; clean up with: rm -rf ${root}/G--*\n`);
+            }
+        }
+        catch { /* swallow — log-only */ }
+    }
+    process.stdout.write(`[mmagent] listening on ${host}:${running.port}\n`);
+    return {
+        port: running.port,
+        stop: async () => {
+            // Clean up signal listeners to prevent leaks when stop() is called
+            // programmatically (i.e. not via a signal).
+            if (onSigterm)
+                process.off('SIGTERM', onSigterm);
+            if (onSigint)
+                process.off('SIGINT', onSigint);
+            if (onStdoutErrorRef)
+                process.stdout.off('error', onStdoutErrorRef);
+            if (onStderrErrorRef)
+                process.stderr.off('error', onStderrErrorRef);
+            if (onUncaughtRef)
+                process.off('uncaughtException', onUncaughtRef);
+            if (onUnhandledRejectionRef)
+                process.off('unhandledRejection', onUnhandledRejectionRef);
+            onStdoutErrorRef = onStderrErrorRef = onUncaughtRef = onUnhandledRejectionRef = undefined;
+            if (flusher) {
+                await flusher.drain().catch(() => { });
+            }
+            await running.stop();
+        },
+    };
+}
+//# sourceMappingURL=serve.js.map