@zhixuan92/multi-model-agent 5.0.2 → 5.1.0

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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"}

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"}