@zhixuan92/multi-model-agent 5.0.2 → 5.0.3

package/README.md

@@ -2,11 +2,9 @@
 
 [![npm](https://img.shields.io/npm/v/@zhixuan92/multi-model-agent?label=npm)](https://www.npmjs.com/package/@zhixuan92/multi-model-agent)
 
-**The horizontal harness for AI engineering** — a local HTTP daemon that routes the right agent to the right task, gets it done right with **cross-agent review**, and caps spend with **bounded execution**. One process serves Claude Code, Codex CLI, Gemini CLI, and Cursor via installable skills; bring your own keys.
+Local HTTP daemon that delegates tool-using work to sub-agents on different LLM providers. One process serves Claude Code, Codex CLI, Gemini CLI, and Cursor via installable skills.
 
-**The bet:** a reviewed multi-agent harness matches or beats a single frontier model, at a fraction of the cost. **Models go deep; we connect them wide** — and the engineer always keeps the judgment.
-
-*Renamed from `@zhixuan92/multi-model-agent-mcp` in 3.0.0 — the package no longer uses MCP. North star: [DIRECTION.md](https://github.com/zhixuan312/multi-model-agent/blob/master/DIRECTION.md). See [CHANGELOG](https://github.com/zhixuan312/multi-model-agent/blob/master/CHANGELOG.md).*
+*Renamed from `@zhixuan92/multi-model-agent-mcp` in 3.0.0 — the package no longer uses MCP. See [CHANGELOG](https://github.com/zhixuan312/multi-model-agent/blob/master/CHANGELOG.md).*
 
 ## Why
 
@@ -20,13 +18,6 @@ Your flagship model reasoning about architecture is money well spent. That same
 
 Plus structural quality: implementation and review run on **different** model families — different blind spots, catches what self-review can't.
 
-## How it works
-
-- **Three layers.** Your own agent keeps the judgment on top; beneath it sit two labor slots you configure — `complex` and `standard` (labor *categories*, not fixed intelligence tiers).
-- **AIDLC + rods.** Each tool is a *rod* — a gate over one stage of the AI Development Life Cycle: `investigate` / `research` feed the front, `audit` gates the spec and plan, `delegate` / `execute-plan` build, `review` / `debug` guard the output, `retry` closes the loop, `journal` remembers. The harness instruments the lifecycle; the engineer authors it.
-- **Reviewed by default.** Write tasks run implement → spec review → quality review → rework with implementer and reviewer on **different agents**; read-only rods return findings and skip review.
-- **Built on the providers' own runtimes.** Claude work runs through the **Claude Agent SDK**, OpenAI/Codex work through the official **Codex CLI** — when a provider deepens its runtime the harness gets better for free, and a Claude Code task can run on Codex underneath (or vice versa).
-
 ## Initial setup
 
 Four steps, in order.
@@ -34,7 +25,7 @@ Four steps, in order.
 ### 1. Install CLI + skills
 
 ```bash
-npm i -g @zhixuan92/multi-model-agent       # standalone binary (Bun embedded) — npm uses Node ≥18 only to install; the daemon needs no Node/Bun
+npm i -g @zhixuan92/multi-model-agent       # requires Node ≥ 22
 mmagent sync-skills                         # auto-detect all clients (idempotent install + update)
 # or pin a specific target:
 mmagent sync-skills --target=claude-code    # claude-code | gemini-cli | codex-cli | cursor
@@ -128,7 +119,7 @@ Skills are the surface your AI client sees. `mmagent sync-skills` writes them to
 | `mma-research` | `POST /research` | External multi-source research with citations — arxiv, semantic_scholar, github_search, brave-with-`site:`-filters — for a focused question. |
 | `mma-debug` | `POST /debug` | A test fails, a build breaks, or behavior is unexpected — delegate the reproduce/trace, keep the hypothesis on the main agent. |
 | `mma-review` | `POST /review` | Source-code review (pre-merge, post-implementation, security-focused). One worker per file, in parallel. |
-| `mma-audit` | `POST /audit` | Audit a prose artifact against a named criteria set — pick the **subtype**: `default` (general prose-coherence), `spec` (requirements: testability, decision-trace), `plan` (a plan verified against the actual codebase), `skill` (a SKILL.md). Run `subtype=plan` before `mma-execute-plan`. |
+| `mma-audit` | `POST /audit` | Audit a spec / plan / design doc / recommendation doc for executability blockers (contradictions, ambiguity, recommendation-coherence gaps). Default is the comprehensive sweep; `security` and `performance` are narrow opt-in lenses. |
 | `mma-journal-record` | `POST /journal-record` | Record a durable project learning into the cross-agent journal — what was tried, what happened, the lesson — integrated into a graph of ADR "node" files under `.mmagent/journal/` (create / refine / supersede / merge with typed edges). |
 | `mma-journal-recall` | `POST /journal-recall` | Recall relevant prior learnings from the journal for a question or situation — traverses the node graph rather than keyword-filtering. |
 
@@ -242,7 +233,7 @@ Generated on first `mmagent serve`. Retrieve with `mmagent print-token`, or set
 
 ## REST API
 
-16 endpoints. All tool endpoints are async: they return `202 { batchId, statusUrl }` immediately and the executor runs in the background. Poll `GET /batch/:id` for the terminal envelope.
+15 endpoints. All tool endpoints are async: they return `202 { batchId, statusUrl }` immediately and the executor runs in the background. Poll `GET /batch/:id` for the terminal envelope.
 
 | Endpoint | Purpose |
 |---|---|
@@ -259,7 +250,6 @@ Generated on first `mmagent serve`. Retrieve with `mmagent print-token`, or set
 | `GET /batch/:id[?taskIndex=N]` | Poll a batch: `202 text/plain` (pending) or `200 application/json` (terminal). `?taskIndex=N` slices on complete state |
 | `POST /context-blocks?cwd=<abs>` | Register a reusable context block |
 | `DELETE /context-blocks/:id?cwd=<abs>` | Delete a context block |
-| `POST /control/batch-slice` | Slice an in-flight batch — return a subset of its tasks by index |
 | `GET /health` | Liveness probe (unauthenticated, loopback-only) |
 | `GET /status` | Server status (authenticated, loopback-only) |
 
@@ -298,12 +288,12 @@ Full design rationale: [DIRECTION.md](https://github.com/zhixuan312/multi-model-
 | Skill version mismatch | `mmagent sync-skills` and restart your client |
 | `401 unauthorized` from a skill | `export MMAGENT_AUTH_TOKEN=$(mmagent print-token)` |
 | `pkill` reports success but `mmagent info` still shows the old PID | The pattern didn't match — try `kill <pid-from-mmagent-info>` directly |
-| TLS `handshake_failure` to a known-good telemetry endpoint | Local DNS cache is stale. `sudo dscacheutil -flushcache && sudo killall -HUP mDNSResponder` (macOS); restart the daemon so its process re-resolves |
+| TLS `handshake_failure` to a known-good telemetry endpoint | Local DNS cache is stale. `sudo dscacheutil -flushcache && sudo killall -HUP mDNSResponder` (macOS); restart the daemon so its Node process re-resolves |
 | Local telemetry queue stops draining | Daemon's flusher is in exponential backoff after a transport failure (capped at 1 hr). Restart the daemon to force an immediate boot-flush |
 
-## What's new in 5.0
+## What's new in 4.9.0
 
-- **Runtime migrated to Bun**, and this package now ships as **standalone per-platform binaries** with Bun embedded: `npm i -g @zhixuan92/multi-model-agent` resolves a native binary that needs neither Node nor Bun to run (npm uses Node ≥18 only for the install shim). Behavior is identical to 4.x.
+- **Delegate skill passthrough.** `POST /delegate` tasks accept an optional `skills: string[]`. Each name is resolved from the caller's skill store (by `X-MMA-Client`), staged into an ephemeral per-task directory, and delivered natively — Claude workers via a local SDK plugin, Codex workers via an ephemeral `CODEX_HOME`. Unknown names hard-fail just that task; omitting `skills` is byte-for-byte the previous behavior.
 
 Full history: [CHANGELOG](https://github.com/zhixuan312/multi-model-agent/blob/master/CHANGELOG.md).
 

package/dist/cli/index.d.ts

@@ -0,0 +1,62 @@
+#!/usr/bin/env node
+import { type ParsedArgs } from 'minimist';
+import { type MultiModelConfig } from '@zhixuan92/multi-model-agent-core';
+/**
+ * Minimal I/O dependencies — allows tests to intercept stdout/stderr and
+ * override process.argv / process.exit.
+ */
+export interface CliDeps {
+    /**
+     * argv[0..] (not including node path or script path) passed to minimist.
+     * Defaults to process.argv.slice(2).
+     */
+    argv?: () => string[];
+    /**
+     * Current working directory. Defaults to process.cwd().
+     * Used only for resolving the CWD/.multi-model-agent.json discovery path.
+     */
+    cwd?: () => string;
+    /**
+     * Home directory. Defaults to os.homedir().
+     * Used only for resolving the ~/.multi-model/config.json discovery path.
+     */
+    homeDir?: () => string;
+    /**
+     * Environment variable accessor. Defaults to process.env.
+     */
+    env?: () => Record<string, string | undefined>;
+    /** Write to stdout. Defaults to process.stdout.write.bind(process.stdout). */
+    stdout?: (s: string) => boolean;
+    /** Write to stderr. Defaults to process.stderr.write.bind(process.stderr). */
+    stderr?: (s: string) => boolean;
+    /** Exit the process. Defaults to process.exit. */
+    exit?: (code: number) => never;
+}
+/** Parse minimist args from an argv array. */
+export declare function parseArgs(argv: string[]): ParsedArgs;
+/**
+ * Resolve the config file path using the discovery order:
+ *   1. --config <path>   (explicit flag)
+ *   2. $MMAGENT_CONFIG   (env var)
+ *   3. CWD/.multi-model-agent.json
+ *   4. ~/.multi-model/config.json
+ *
+ * Returns the first path that exists, or undefined if none exist.
+ * Does NOT validate or parse the file — caller uses loadConfigFromFile().
+ */
+export declare function resolveConfigPath(explicit: string | undefined, env: Record<string, string | undefined>, cwd: string, home: string): string | undefined;
+/**
+ * Load config using the discovery order.
+ * Tries each candidate in priority order and returns the first successfully
+ * loaded config. Returns an error listing all attempted paths if none are found
+ * or every found file is unreadable/invalid.
+ */
+export declare function loadConfig(explicitPath: string | undefined, deps: Pick<CliDeps, 'cwd' | 'homeDir' | 'env'>): Promise<MultiModelConfig>;
+/**
+ * Main entry point — exported so it can be unit-tested without subprocess spawning.
+ *
+ * @param deps  I/O dependencies (defaults to real process globals).
+ */
+export declare function main(deps?: CliDeps): Promise<void>;
+export type { MultiModelConfig };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AA0BA,OAAiB,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AACrD,OAAO,EAEL,KAAK,gBAAgB,EACtB,MAAM,mCAAmC,CAAC;AAU3C;;;GAGG;AACH,MAAM,WAAW,OAAO;IACtB;;;OAGG;IACH,IAAI,CAAC,EAAE,MAAM,MAAM,EAAE,CAAC;IACtB;;;OAGG;IACH,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB;;;OAGG;IACH,OAAO,CAAC,EAAE,MAAM,MAAM,CAAC;IACvB;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC/C,8EAA8E;IAC9E,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAChC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAChC,kDAAkD;IAClD,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC;CAChC;AAED,8CAA8C;AAC9C,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,UAAU,CASpD;AA4BD;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAC/B,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,EACvC,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,GACX,MAAM,GAAG,SAAS,CAKpB;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,YAAY,EAAE,MAAM,GAAG,SAAS,EAChC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,KAAK,GAAG,SAAS,GAAG,KAAK,CAAC,GAC7C,OAAO,CAAC,gBAAgB,CAAC,CA0B3B;AAuCD;;;;GAIG;AACH,wBAAsB,IAAI,CAAC,IAAI,GAAE,OAAY,GAAG,OAAO,CAAC,IAAI,CAAC,CAuK5D;AA+BD,YAAY,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/cli/index.js

@@ -0,0 +1,345 @@
+#!/usr/bin/env node
+/**
+ * CLI entry point for `mmagent` / `multi-model-agent`.
+ *
+ * Usage:
+ *   mmagent serve [--config <path>]
+ *   mmagent --help
+ *   mmagent --version
+ *
+ * Config discovery order (highest priority → lowest):
+ *   1. --config <path>          (explicit flag)
+ *   2. $MMAGENT_CONFIG env var
+ *   3. CWD/.multi-model-agent.json
+ *   4. ~/.multi-model/config.json
+ *
+ * All side effects (process.exit, stdout/stderr writes) are contained in the
+ * bootstrap at the bottom of this file. The internal `main()` function is
+ * exported so it can be unit-tested without spawning subprocesses.
+ *
+ * Signal lifecycle is owned by `serve.ts` — this module delegates to
+ * `startServe()` which registers SIGTERM/SIGINT handlers and manages process.exit.
+ */
+import * as path from 'node:path';
+import * as fs from 'node:fs';
+import * as os from 'node:os';
+import { fileURLToPath } from 'node:url';
+import minimist from 'minimist';
+import { loadConfigFromFile, } from '@zhixuan92/multi-model-agent-core';
+import { startServe } from './serve.js';
+import { printToken } from './print-token.js';
+import { runStatus, buildServerUrl } from './status.js';
+import { runInfo } from './info.js';
+import { runSyncSkills } from './sync-skills.js';
+import { runDisable, runEnable } from './toggle.js';
+import { runLogs } from './logs.js';
+import { runTelemetry } from './telemetry.js';
+/** Parse minimist args from an argv array. */
+export function parseArgs(argv) {
+    return minimist(argv, {
+        string: ['config', 'batch'],
+        boolean: ['help', 'version', 'json', 'dry-run', 'if-exists', 'silent', 'best-effort', 'follow', 'log'],
+        alias: { config: 'c', help: 'h', version: 'v', json: 'j' },
+        // Note: stopEarly is NOT set. With stopEarly:true, options after the first
+        // positional argument (the subcommand) would be silently dropped. E.g.
+        // `mmagent serve --config ./config.json` would lose --config.
+    });
+}
+/**
+ * Build the ordered list of config-file candidates from discovery sources.
+ * Returns an array of resolved paths; callers filter for existence and
+ * iterate in priority order. This single builder ensures that
+ * resolveConfigPath() and loadConfig() cannot drift apart.
+ */
+function buildCandidatePaths(explicit, env, cwd, home) {
+    const paths = [];
+    if (explicit)
+        paths.push(explicit);
+    const envVal = (env['MMAGENT_CONFIG'] ?? '').trim();
+    if (envVal)
+        paths.push(envVal);
+    paths.push(path.join(cwd, '.multi-model-agent.json'));
+    paths.push(path.join(home, '.multi-model', 'config.json'));
+    return paths;
+}
+/**
+ * Resolve the config file path using the discovery order:
+ *   1. --config <path>   (explicit flag)
+ *   2. $MMAGENT_CONFIG   (env var)
+ *   3. CWD/.multi-model-agent.json
+ *   4. ~/.multi-model/config.json
+ *
+ * Returns the first path that exists, or undefined if none exist.
+ * Does NOT validate or parse the file — caller uses loadConfigFromFile().
+ */
+export function resolveConfigPath(explicit, env, cwd, home) {
+    for (const p of buildCandidatePaths(explicit, env, cwd, home)) {
+        if (p && fs.existsSync(p))
+            return p;
+    }
+    return undefined;
+}
+/**
+ * Load config using the discovery order.
+ * Tries each candidate in priority order and returns the first successfully
+ * loaded config. Returns an error listing all attempted paths if none are found
+ * or every found file is unreadable/invalid.
+ */
+export async function loadConfig(explicitPath, deps) {
+    const cwd = deps.cwd?.() ?? process.cwd();
+    const home = deps.homeDir?.() ?? os.homedir();
+    const env = deps.env?.() ?? process.env;
+    const attempted = [];
+    for (const p of buildCandidatePaths(explicitPath, env, cwd, home)) {
+        if (!p) {
+            attempted.push('<source: not set>');
+            continue;
+        }
+        attempted.push(p);
+        if (!fs.existsSync(p))
+            continue;
+        try {
+            return await loadConfigFromFile(p);
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : String(err);
+            throw new Error(`Config error (${p}): ${msg}`);
+        }
+    }
+    throw new Error(`No config file found. Tried:\n${attempted.join('\n')}\n` +
+        `Set one via --config, $MMAGENT_CONFIG, or place it at a default location above.`);
+}
+const HELP_TEXT = `\
+mmagent — multi-model-agent HTTP server
+
+Usage:
+  mmagent [command] [options]
+
+Commands:
+  serve            Start the HTTP server (default)
+  print-token      Print the bearer auth token to stdout
+  info             Print config + daemon identity (works offline)
+  status           Show server status (requires a running server)
+  sync-skills      Install + update + reconcile all shipped skills (single upsert command, replaces 4.0.x install-skill / update-skills)
+  disable          Remove MMA skills from clients and pin them off (survives npm upgrades)
+  enable           Restore MMA skills (clears a prior \`disable\`, then re-syncs)
+  logs             Tail the diagnostic log (use --follow / --batch=<id>)
+  telemetry        Manage telemetry consent (status|enable|disable|reset-id|dump-queue)
+
+Global options:
+  --config, -c <path>   Path to config file
+  --help, -h            Show this help
+  --version, -v         Show version
+`;
+/**
+ * Read the server package version from package.json, walking up from this file.
+ */
+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';
+    }
+}
+/**
+ * Main entry point — exported so it can be unit-tested without subprocess spawning.
+ *
+ * @param deps  I/O dependencies (defaults to real process globals).
+ */
+export async function main(deps = {}) {
+    const argv = deps.argv?.() ?? process.argv.slice(2);
+    const stdout = deps.stdout ?? process.stdout.write.bind(process.stdout);
+    const stderr = deps.stderr ?? process.stderr.write.bind(process.stderr);
+    const exit = deps.exit ?? process.exit.bind(process);
+    const opts = parseArgs(argv);
+    const positional = opts._;
+    const subcommand = positional[0] ?? 'serve';
+    const configArg = typeof opts['config'] === 'string' ? opts['config'] : undefined;
+    if (opts['help']) {
+        stdout(HELP_TEXT);
+        return;
+    }
+    if (opts['version']) {
+        stdout(readServerVersion() + '\n');
+        return;
+    }
+    switch (subcommand) {
+        case 'serve': {
+            const config = await loadConfig(configArg, deps);
+            // Stderr event streaming is always on (4.7.3+; no --verbose flag).
+            // --log enables JSONL persistence to ~/.multi-model/logs/mmagent-YYYY-MM-DD.jsonl.
+            if (opts['log'] === true) {
+                if (!config.diagnostics)
+                    config.diagnostics = { log: false };
+                config.diagnostics.log = true;
+            }
+            // startServe() blocks until a signal arrives and exits the process.
+            await startServe(config, exit);
+            break;
+        }
+        case 'print-token': {
+            const config = await loadConfig(configArg, deps).catch(() => null);
+            const tokenFile = config
+                ? config.server.auth.tokenFile
+                : path.join(deps.homeDir?.() ?? os.homedir(), '.multi-model', 'auth-token');
+            const code = printToken({
+                homeDir: deps.homeDir?.() ?? os.homedir(),
+                tokenFile,
+                env: deps.env?.() ?? process.env,
+                stdout: deps.stdout,
+                stderr: deps.stderr,
+            });
+            exit(code);
+            break;
+        }
+        case 'status': {
+            const jsonFlag = opts['json'] === true;
+            const config = await loadConfig(configArg, deps).catch(() => null);
+            const home = deps.homeDir?.() ?? os.homedir();
+            const tokenFile = config
+                ? config.server.auth.tokenFile
+                : path.join(home, '.multi-model', 'auth-token');
+            const serverUrl = config
+                ? buildServerUrl(config.server.bind, config.server.port)
+                : buildServerUrl('127.0.0.1', 7337);
+            const code = await runStatus({
+                serverUrl,
+                tokenFile,
+                json: jsonFlag,
+                env: deps.env?.() ?? process.env,
+                homeDir: home,
+                stdout: deps.stdout,
+                stderr: deps.stderr,
+            });
+            exit(code);
+            break;
+        }
+        case 'info': {
+            const jsonFlag = opts['json'] === true;
+            const config = await loadConfig(configArg, deps).catch(() => null);
+            if (!config) {
+                stderr(`mmagent info: cannot load config. Set --config or $MMAGENT_CONFIG.\n`);
+                exit(1);
+                break;
+            }
+            const code = await runInfo({
+                cliVersion: readServerVersion(),
+                bind: config.server.bind,
+                port: config.server.port,
+                tokenFile: config.server.auth.tokenFile,
+                homeDir: deps.homeDir?.() ?? os.homedir(),
+                json: jsonFlag,
+                stdout: deps.stdout,
+                stderr: deps.stderr,
+            });
+            exit(code);
+            break;
+        }
+        case 'logs': {
+            const config = await loadConfig(configArg, deps).catch(() => null);
+            if (!config) {
+                stderr(`mmagent logs: cannot load config. Set --config or $MMAGENT_CONFIG.\n`);
+                exit(1);
+                break;
+            }
+            const code = await runLogs({
+                config,
+                homeDir: deps.homeDir?.() ?? os.homedir(),
+                follow: opts['follow'] === true,
+                batchId: typeof opts['batch'] === 'string' ? opts['batch'] : undefined,
+                stdout: deps.stdout,
+                stderr: deps.stderr,
+            });
+            exit(code);
+            break;
+        }
+        case 'sync-skills': {
+            // Forward argv tokens that come after the subcommand name so
+            // sync-skills' own minimist sees `--target=`, `--all-targets`, etc.
+            const subCmdIdx = argv.indexOf('sync-skills');
+            const subArgv = subCmdIdx >= 0 ? argv.slice(subCmdIdx + 1) : positional.slice(1);
+            const code = await runSyncSkills({
+                argv: subArgv,
+                homeDir: deps.homeDir?.() ?? os.homedir(),
+                ifExists: opts['if-exists'] === true,
+                silent: opts['silent'] === true,
+                bestEffort: opts['best-effort'] === true,
+                stdout: deps.stdout,
+                stderr: deps.stderr,
+            });
+            exit(code);
+            break;
+        }
+        case 'enable':
+        case 'disable': {
+            // Forward argv tokens after the subcommand name so toggle's own minimist
+            // sees --target=, --all-targets, --dry-run, --json.
+            const subCmdIdx = argv.indexOf(subcommand);
+            const subArgv = subCmdIdx >= 0 ? argv.slice(subCmdIdx + 1) : positional.slice(1);
+            const run = subcommand === 'disable' ? runDisable : runEnable;
+            const code = await run({
+                argv: subArgv,
+                homeDir: deps.homeDir?.() ?? os.homedir(),
+                cliVersion: readServerVersion(),
+                stdout: deps.stdout,
+                stderr: deps.stderr,
+            });
+            exit(code);
+            break;
+        }
+        case 'telemetry': {
+            const home = deps.homeDir?.() ?? path.join(os.homedir(), '.multi-model');
+            const telemetrySubcommand = positional[1] ?? 'status';
+            const validSubcommands = ['status', 'enable', 'disable', 'reset-id', 'dump-queue'];
+            if (!validSubcommands.includes(telemetrySubcommand)) {
+                stderr(`mmagent telemetry: unknown subcommand '${telemetrySubcommand}'\nValid: ${validSubcommands.join(', ')}\n`);
+                exit(1);
+                break;
+            }
+            const code = await runTelemetry({
+                subcommand: telemetrySubcommand,
+                homeDir: home,
+                stdout: deps.stdout,
+                stderr: deps.stderr,
+            });
+            exit(code);
+            break;
+        }
+        default: {
+            stderr(`Unknown command: ${subcommand}\nRun 'mmagent --help' for usage.\n`);
+            exit(1);
+        }
+    }
+}
+// ── Bootstrap ──────────────────────────────────────────────────────────────
+// Only run main() when this module is executed as the CLI entry point.
+// Tests import main() directly and pass CliDeps.
+function isMain() {
+    try {
+        const argv1 = process.argv[1];
+        if (!argv1)
+            return false;
+        // Resolve to absolute path and follow symlinks — npm installs the bin as a
+        // symlink in node_modules/.bin/, so argv[1] points at the symlink, not the
+        // real file. fs.realpathSync follows the link so it matches import.meta.url.
+        const entryPath = import.meta.url.startsWith('file://')
+            ? fileURLToPath(import.meta.url)
+            : path.resolve(argv1);
+        return fs.realpathSync(path.resolve(argv1)) === entryPath;
+    }
+    catch {
+        return false;
+    }
+}
+if (isMain()) {
+    void main().catch((err) => {
+        const msg = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`mmagent: ${msg}\n`);
+        process.exit(1);
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,QAA6B,MAAM,UAAU,CAAC;AACrD,OAAO,EACL,kBAAkB,GAEnB,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACpD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAkC9C,8CAA8C;AAC9C,MAAM,UAAU,SAAS,CAAC,IAAc;IACtC,OAAO,QAAQ,CAAC,IAAI,EAAE;QACpB,MAAM,EAAE,CAAC,QAAQ,EAAE,OAAO,CAAC;QAC3B,OAAO,EAAE,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,CAAC;QACtG,KAAK,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE;QAC1D,2EAA2E;QAC3E,uEAAuE;QACvE,8DAA8D;KAC/D,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,SAAS,mBAAmB,CAC1B,QAA4B,EAC5B,GAAuC,EACvC,GAAW,EACX,IAAY;IAEZ,MAAM,KAAK,GAAa,EAAE,CAAC;IAE3B,IAAI,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEnC,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,gBAAgB,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACpD,IAAI,MAAM;QAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAE/B,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,yBAAyB,CAAC,CAAC,CAAC;IAEtD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC;IAE3D,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAC/B,QAA4B,EAC5B,GAAuC,EACvC,GAAW,EACX,IAAY;IAEZ,KAAK,MAAM,CAAC,IAAI,mBAAmB,CAAC,QAAQ,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;QAC9D,IAAI,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,YAAgC,EAChC,IAA8C;IAE9C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;IAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,OAAO,CAAC,GAAG,CAAC;IAExC,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,CAAC,IAAI,mBAAmB,CAAC,YAAY,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,CAAC;QAClE,IAAI,CAAC,CAAC,EAAE,CAAC;YACP,SAAS,CAAC,IAAI,CAAC,mBAAmB,CAAC,CAAC;YACpC,SAAS;QACX,CAAC;QACD,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;YAAE,SAAS;QAChC,IAAI,CAAC;YACH,OAAO,MAAM,kBAAkB,CAAC,CAAC,CAAC,CAAC;QACrC,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7D,MAAM,IAAI,KAAK,CAAC,iBAAiB,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC;QACjD,CAAC;IACH,CAAC;IAED,MAAM,IAAI,KAAK,CACb,iCAAiC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;QACzD,iFAAiF,CAClF,CAAC;AACJ,CAAC;AAED,MAAM,SAAS,GAAG;;;;;;;;;;;;;;;;;;;;;CAqBjB,CAAC;AAEF;;GAEG;AACH,SAAS,iBAAiB;IACxB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;QAC7D,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,cAAc,CAAC,CAAC;QAC/D,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,CAAyB,CAAC;QACjF,OAAO,GAAG,CAAC,OAAO,IAAI,OAAO,CAAC;IAChC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,OAAgB,EAAE;IAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,EAAE,EAAE,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACpD,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;IACxE,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAErD,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,CAAa,CAAC;IACtC,MAAM,UAAU,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC;IAC5C,MAAM,SAAS,GAAG,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAElF,IAAI,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACjB,MAAM,CAAC,SAAS,CAAC,CAAC;QAClB,OAAO;IACT,CAAC;IAED,IAAI,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QACpB,MAAM,CAAC,iBAAiB,EAAE,GAAG,IAAI,CAAC,CAAC;QACnC,OAAO;IACT,CAAC;IAED,QAAQ,UAAU,EAAE,CAAC;QACnB,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;YACjD,mEAAmE;YACnE,mFAAmF;YACnF,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,IAAI,EAAE,CAAC;gBACzB,IAAI,CAAC,MAAM,CAAC,WAAW;oBAAE,MAAM,CAAC,WAAW,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC;gBAC7D,MAAM,CAAC,WAAW,CAAC,GAAG,GAAG,IAAI,CAAC;YAChC,CAAC;YACD,oEAAoE;YACpE,MAAM,UAAU,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;YAC/B,MAAM;QACR,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACnE,MAAM,SAAS,GAAG,MAAM;gBACtB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS;gBAC9B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC;YAC9E,MAAM,IAAI,GAAG,UAAU,CAAC;gBACtB,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE;gBACzC,SAAS;gBACT,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,OAAO,CAAC,GAAG;gBAChC,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,CAAC;YACX,MAAM;QACR,CAAC;QACD,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;YACvC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACnE,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;YAC9C,MAAM,SAAS,GAAG,MAAM;gBACtB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS;gBAC9B,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,YAAY,CAAC,CAAC;YAClD,MAAM,SAAS,GAAG,MAAM;gBACtB,CAAC,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;gBACxD,CAAC,CAAC,cAAc,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;YACtC,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC;gBAC3B,SAAS;gBACT,SAAS;gBACT,IAAI,EAAE,QAAQ;gBACd,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,IAAI,OAAO,CAAC,GAAG;gBAChC,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,CAAC;YACX,MAAM;QACR,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;YACvC,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACnE,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,CAAC,sEAAsE,CAAC,CAAC;gBAC/E,IAAI,CAAC,CAAC,CAAC,CAAC;gBACR,MAAM;YACR,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC;gBACzB,UAAU,EAAE,iBAAiB,EAAE;gBAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI;gBACxB,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI;gBACxB,SAAS,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS;gBACvC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE;gBACzC,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,CAAC;YACX,MAAM;QACR,CAAC;QACD,KAAK,MAAM,CAAC,CAAC,CAAC;YACZ,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;YACnE,IAAI,CAAC,MAAM,EAAE,CAAC;gBACZ,MAAM,CAAC,sEAAsE,CAAC,CAAC;gBAC/E,IAAI,CAAC,CAAC,CAAC,CAAC;gBACR,MAAM;YACR,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC;gBACzB,MAAM;gBACN,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE;gBACzC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI;gBAC/B,OAAO,EAAE,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;gBACtE,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,CAAC;YACX,MAAM;QACR,CAAC;QACD,KAAK,aAAa,CAAC,CAAC,CAAC;YACnB,6DAA6D;YAC7D,oEAAoE;YACpE,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;YAC9C,MAAM,OAAO,GAAG,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACjF,MAAM,IAAI,GAAG,MAAM,aAAa,CAAC;gBAC/B,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE;gBACzC,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,KAAK,IAAI;gBACpC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI;gBAC/B,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC,KAAK,IAAI;gBACxC,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,CAAC;YACX,MAAM;QACR,CAAC;QACD,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS,CAAC,CAAC,CAAC;YACf,yEAAyE;YACzE,oDAAoD;YACpD,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC3C,MAAM,OAAO,GAAG,SAAS,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;YACjF,MAAM,GAAG,GAAG,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;YAC9D,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC;gBACrB,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE;gBACzC,UAAU,EAAE,iBAAiB,EAAE;gBAC/B,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,CAAC;YACX,MAAM;QACR,CAAC;QACD,KAAK,WAAW,CAAC,CAAC,CAAC;YACjB,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,cAAc,CAAC,CAAC;YACzE,MAAM,mBAAmB,GAAG,UAAU,CAAC,CAAC,CAAC,IAAI,QAAQ,CAAC;YACtD,MAAM,gBAAgB,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;YACnF,IAAI,CAAC,gBAAgB,CAAC,QAAQ,CAAC,mBAAmB,CAAC,EAAE,CAAC;gBACpD,MAAM,CAAC,0CAA0C,mBAAmB,aAAa,gBAAgB,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClH,IAAI,CAAC,CAAC,CAAC,CAAC;gBACR,MAAM;YACR,CAAC;YACD,MAAM,IAAI,GAAG,MAAM,YAAY,CAAC;gBAC9B,UAAU,EAAE,mBAAkF;gBAC9F,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,MAAM,EAAE,IAAI,CAAC,MAAM;aACpB,CAAC,CAAC;YACH,IAAI,CAAC,IAAI,CAAC,CAAC;YACX,MAAM;QACR,CAAC;QACD,OAAO,CAAC,CAAC,CAAC;YACR,MAAM,CAAC,oBAAoB,UAAU,qCAAqC,CAAC,CAAC;YAC5E,IAAI,CAAC,CAAC,CAAC,CAAC;QACV,CAAC;IACH,CAAC;AACH,CAAC;AAED,8EAA8E;AAE9E,uEAAuE;AACvE,iDAAiD;AACjD,SAAS,MAAM;IACb,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAC9B,IAAI,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QACzB,2EAA2E;QAC3E,2EAA2E;QAC3E,6EAA6E;QAC7E,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC;YACrD,CAAC,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC;YAChC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QACxB,OAAO,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,KAAK,SAAS,CAAC;IAC5D,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,IAAI,MAAM,EAAE,EAAE,CAAC;IACb,KAAK,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;QACjC,MAAM,GAAG,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;QAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/cli/info.d.ts

@@ -0,0 +1,22 @@
+export interface InfoDeps {
+    /** CLI package version (read from the server package.json at startup). */
+    cliVersion: string;
+    /** Config bind address (e.g. '127.0.0.1'). */
+    bind: string;
+    /** Config port (e.g. 7337). */
+    port: number;
+    /** Token file path (already resolved from config, no tilde expansion yet). */
+    tokenFile: string;
+    /** Home dir for tilde expansion. Defaults to os.homedir(). */
+    homeDir?: string;
+    /** Emit machine-readable JSON instead of a human summary. */
+    json?: boolean;
+    /** stdout writer (for testing). */
+    stdout?: (s: string) => boolean;
+    /** stderr writer (for testing). */
+    stderr?: (s: string) => boolean;
+    /** Injectable fetch for testing; defaults to global fetch. */
+    fetch?: typeof fetch;
+}
+export declare function runInfo(deps: InfoDeps): Promise<number>;
+//# sourceMappingURL=info.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"info.d.ts","sourceRoot":"","sources":["../../src/cli/info.ts"],"names":[],"mappings":"AAiBA,MAAM,WAAW,QAAQ;IACvB,0EAA0E;IAC1E,UAAU,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,SAAS,EAAE,MAAM,CAAC;IAClB,8DAA8D;IAC9D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6DAA6D;IAC7D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,mCAAmC;IACnC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAChC,mCAAmC;IACnC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IAChC,8DAA8D;IAC9D,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAsBD,wBAAsB,OAAO,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CA2E7D"}

package/dist/cli/info.js

@@ -0,0 +1,100 @@
+/**
+ * info.ts — `mmagent info` subcommand.
+ *
+ * One-shot identity probe: emits CLI version, configured bind/port, token
+ * fingerprint (sha256 first 8 hex chars), and — if the daemon is reachable —
+ * daemon version/pid/startedAt/uptimeMs from GET /health. Designed to be
+ * parseable with --json for scripts and human-readable without it.
+ *
+ * Usage:
+ *   mmagent info [--config <path>] [--json]
+ */
+import * as crypto from 'node:crypto';
+import * as os from 'node:os';
+import * as path from 'node:path';
+import { readFileSync } from 'node:fs';
+import { notApplicable } from '@zhixuan92/multi-model-agent-core';
+function fingerprint(token) {
+    return crypto.createHash('sha256').update(token).digest('hex').slice(0, 8);
+}
+function resolveHome(p, homeDir) {
+    return p.startsWith('~/') ? path.join(homeDir, p.slice(2)) : p;
+}
+export async function runInfo(deps) {
+    const stdout = deps.stdout ?? process.stdout.write.bind(process.stdout);
+    const stderr = deps.stderr ?? process.stderr.write.bind(process.stderr);
+    const fetcher = deps.fetch ?? fetch;
+    const homeDir = deps.homeDir ?? os.homedir();
+    const json = deps.json ?? false;
+    const resolvedTokenFile = resolveHome(deps.tokenFile, homeDir);
+    let tokenFp;
+    try {
+        const token = readFileSync(resolvedTokenFile, 'utf-8').trim();
+        if (token.length === 0) {
+            stderr(`mmagent info: auth token file is empty: ${resolvedTokenFile}\n`);
+            return 1;
+        }
+        tokenFp = fingerprint(token);
+    }
+    catch (err) {
+        const code = err.code;
+        const msg = err instanceof Error ? err.message : String(err);
+        if (code === 'ENOENT') {
+            stderr(`mmagent info: auth token file not found: ${resolvedTokenFile}\n`);
+        }
+        else {
+            stderr(`mmagent info: cannot read auth token file: ${msg}\n`);
+        }
+        return 1;
+    }
+    const host = (deps.bind === '0.0.0.0' || deps.bind === '::') ? '127.0.0.1' : deps.bind;
+    const healthUrl = `http://${host}:${deps.port}/health`;
+    let running = false;
+    let health = null;
+    try {
+        const res = await fetcher(healthUrl, { signal: AbortSignal.timeout(2000) });
+        if (res.ok) {
+            health = await res.json();
+            running = true;
+        }
+    }
+    catch {
+        // daemon not running — leave running=false
+    }
+    const fromHealth = (key, validate) => {
+        if (!running)
+            return notApplicable('daemon not running');
+        const v = health?.[key];
+        if (validate(v))
+            return v;
+        return notApplicable('daemon version predates info fields');
+    };
+    const info = {
+        cliVersion: deps.cliVersion,
+        daemonVersion: fromHealth('version', (v) => typeof v === 'string' && v.length > 0),
+        bind: deps.bind,
+        port: deps.port,
+        pid: fromHealth('pid', (v) => typeof v === 'number'),
+        uptimeMs: fromHealth('uptimeMs', (v) => typeof v === 'number'),
+        startedAt: fromHealth('startedAt', (v) => typeof v === 'number'),
+        tokenFingerprint: tokenFp,
+        running,
+    };
+    if (json) {
+        stdout(JSON.stringify(info, null, 2) + '\n');
+        return 0;
+    }
+    const parts = [`mmagent cli=${info.cliVersion}`];
+    if (typeof info.daemonVersion === 'string')
+        parts.push(`daemon=${info.daemonVersion}`);
+    parts.push(`bind=${info.bind}:${info.port}`);
+    if (typeof info.pid === 'number')
+        parts.push(`pid=${info.pid}`);
+    if (typeof info.uptimeMs === 'number')
+        parts.push(`uptime=${Math.floor(info.uptimeMs / 1000)}s`);
+    parts.push(`token=${info.tokenFingerprint}`);
+    parts.push(`running=${info.running ? 'yes' : 'no'}`);
+    stdout(parts.join('  ') + '\n');
+    return 0;
+}
+//# sourceMappingURL=info.js.map

package/dist/cli/info.js.map

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