@darkiceinteractive/mcp-conductor 2.0.0-alpha.1 → 3.0.0-beta.2

package/dist/cli/commands/routing.js

@@ -0,0 +1,60 @@
+/**
+ * routing command: heuristic per-tool routing recommendation.
+ * @module cli/commands/routing
+ */
+import { loadConductorConfig, saveConductorConfig, getDefaultConductorConfigPath } from '../../config/index.js';
+/**
+ * Heuristic: servers whose names or typical tool shapes suggest small payloads
+ * should be marked passthrough. This is the X1 heuristic adapted for the CLI.
+ *
+ * Rule: if the server name matches known lightweight patterns (search, calendar,
+ * weather, echo, ping) → passthrough. Otherwise → execute_code.
+ *
+ * A more sophisticated version would sample live tool responses — this is the
+ * static heuristic that can be applied without connecting.
+ */
+export function recommendRouting(serverName) {
+    const lower = serverName.toLowerCase();
+    const passthroughPatterns = [
+        /search/, /calendar/, /weather/, /echo/, /ping/, /todo/, /remind/,
+        /notes?$/, /contacts?$/, /email$/, /mail$/, /slack$/, /discord$/,
+    ];
+    const isPassthrough = passthroughPatterns.some((p) => p.test(lower));
+    return {
+        serverName,
+        recommendation: isPassthrough ? 'passthrough' : 'execute_code',
+        reason: isPassthrough
+            ? 'Name matches lightweight-payload pattern (responses typically <1KB)'
+            : 'Name does not match passthrough patterns; execute_code is safer default',
+    };
+}
+/**
+ * Generate routing recommendations for one or all configured servers.
+ * Optionally write the recommendations back to the conductor config.
+ */
+export function getRoutingRecommendations(options) {
+    const config = loadConductorConfig();
+    if (!config) {
+        return { recommendations: [], applied: false };
+    }
+    const serverNames = options.serverName
+        ? [options.serverName]
+        : Object.keys(config.servers);
+    const recommendations = serverNames
+        .filter((n) => config.servers[n] !== undefined)
+        .map(recommendRouting);
+    if (options.apply && recommendations.length > 0) {
+        // Store routing hint in server env as __routing (lightweight annotation).
+        for (const rec of recommendations) {
+            const server = config.servers[rec.serverName];
+            if (server) {
+                server.env = { ...(server.env ?? {}), __routing: rec.recommendation };
+            }
+        }
+        const configPath = getDefaultConductorConfigPath();
+        saveConductorConfig(config, configPath);
+        return { recommendations, applied: true, configPath };
+    }
+    return { recommendations, applied: false };
+}
+//# sourceMappingURL=routing.js.map

package/dist/cli/commands/routing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing.js","sourceRoot":"","sources":["../../../src/cli/commands/routing.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,6BAA6B,EAAE,MAAM,uBAAuB,CAAC;AAchH;;;;;;;;;GASG;AACH,MAAM,UAAU,gBAAgB,CAAC,UAAkB;IACjD,MAAM,KAAK,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC;IACvC,MAAM,mBAAmB,GAAG;QAC1B,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ;QACjE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,OAAO,EAAE,QAAQ,EAAE,UAAU;KACjE,CAAC;IAEF,MAAM,aAAa,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAErE,OAAO;QACL,UAAU;QACV,cAAc,EAAE,aAAa,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,cAAc;QAC9D,MAAM,EAAE,aAAa;YACnB,CAAC,CAAC,qEAAqE;YACvE,CAAC,CAAC,yEAAyE;KAC9E,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,yBAAyB,CAAC,OAGzC;IACC,MAAM,MAAM,GAAG,mBAAmB,EAAE,CAAC;IACrC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,EAAE,eAAe,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;IACjD,CAAC;IAED,MAAM,WAAW,GAAG,OAAO,CAAC,UAAU;QACpC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC;QACtB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAEhC,MAAM,eAAe,GAAG,WAAW;SAChC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC;SAC9C,GAAG,CAAC,gBAAgB,CAAC,CAAC;IAEzB,IAAI,OAAO,CAAC,KAAK,IAAI,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChD,0EAA0E;QAC1E,KAAK,MAAM,GAAG,IAAI,eAAe,EAAE,CAAC;YAClC,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;YAC9C,IAAI,MAAM,EAAE,CAAC;gBACX,MAAM,CAAC,GAAG,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,cAAc,EAAE,CAAC;YACxE,CAAC;QACH,CAAC;QACD,MAAM,UAAU,GAAG,6BAA6B,EAAE,CAAC;QACnD,mBAAmB,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;QACxC,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IACxD,CAAC;IAED,OAAO,EAAE,eAAe,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;AAC7C,CAAC"}

package/dist/cli/commands/test-server.d.ts

@@ -0,0 +1,34 @@
+/**
+ * test-server command: transient connect, list tools, latency probe.
+ * @module cli/commands/test-server
+ */
+export interface TestServerOptions {
+    /** Server name (looks up in conductor config) */
+    name?: string;
+    /** Directly specify command (bypasses config lookup) */
+    command?: string;
+    /** Command args */
+    args?: string[];
+    /** Environment variables */
+    env?: Record<string, string>;
+    /** Connection timeout ms */
+    timeoutMs?: number;
+}
+export interface TestServerResult {
+    success: boolean;
+    serverName: string;
+    connected: boolean;
+    toolCount: number;
+    tools: Array<{
+        name: string;
+        description: string;
+    }>;
+    latencyMs: number;
+    error?: string;
+}
+/**
+ * Transiently connect to an MCP server, list its tools and measure latency.
+ * The connection is always closed afterwards — no persistent registration.
+ */
+export declare function testServer(options: TestServerOptions): Promise<TestServerResult>;
+//# sourceMappingURL=test-server.d.ts.map

package/dist/cli/commands/test-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"test-server.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/test-server.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAQH,MAAM,WAAW,iBAAiB;IAChC,iDAAiD;IACjD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,4BAA4B;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,4BAA4B;IAC5B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4EtF"}

package/dist/cli/commands/test-server.js

@@ -0,0 +1,86 @@
+/**
+ * test-server command: transient connect, list tools, latency probe.
+ * @module cli/commands/test-server
+ */
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StdioClientTransport } from '@modelcontextprotocol/sdk/client/stdio.js';
+import { minimalChildEnv } from '../../utils/index.js';
+import { loadConductorConfig } from '../../config/index.js';
+/**
+ * Transiently connect to an MCP server, list its tools and measure latency.
+ * The connection is always closed afterwards — no persistent registration.
+ */
+export async function testServer(options) {
+    const name = options.name ?? 'unnamed';
+    let command;
+    let args;
+    let env;
+    if (options.command) {
+        command = options.command;
+        args = options.args ?? [];
+        env = options.env;
+    }
+    else if (options.name) {
+        const config = loadConductorConfig();
+        if (!config) {
+            return { success: false, serverName: name, connected: false, toolCount: 0, tools: [], latencyMs: 0, error: 'No conductor config found' };
+        }
+        const serverDef = config.servers[options.name];
+        if (!serverDef) {
+            return { success: false, serverName: name, connected: false, toolCount: 0, tools: [], latencyMs: 0, error: `Server '${options.name}' not found in conductor config` };
+        }
+        command = serverDef.command;
+        args = serverDef.args ?? [];
+        env = serverDef.env;
+    }
+    else {
+        return { success: false, serverName: name, connected: false, toolCount: 0, tools: [], latencyMs: 0, error: 'Either name or command must be provided' };
+    }
+    const timeoutMs = options.timeoutMs ?? 15000;
+    const t0 = Date.now();
+    const client = new Client({ name: 'mcp-conductor-test', version: '1.0.0' });
+    const transport = new StdioClientTransport({
+        command,
+        args,
+        env: { ...minimalChildEnv(), ...(env ?? {}) },
+    });
+    try {
+        const connectPromise = client.connect(transport);
+        const timeoutPromise = new Promise((_, reject) => setTimeout(() => reject(new Error(`Connection timed out after ${timeoutMs}ms`)), timeoutMs));
+        await Promise.race([connectPromise, timeoutPromise]);
+        const listResult = await client.listTools();
+        const latencyMs = Date.now() - t0;
+        const tools = (listResult.tools ?? []).map((t) => ({
+            name: t.name,
+            description: t.description ?? '',
+        }));
+        return {
+            success: true,
+            serverName: name,
+            connected: true,
+            toolCount: tools.length,
+            tools,
+            latencyMs,
+        };
+    }
+    catch (err) {
+        return {
+            success: false,
+            serverName: name,
+            connected: false,
+            toolCount: 0,
+            tools: [],
+            latencyMs: Date.now() - t0,
+            error: String(err),
+        };
+    }
+    finally {
+        try {
+            await client.close();
+        }
+        catch {
+            // ignore cleanup errors
+        }
+    }
+}
+//# sourceMappingURL=test-server.js.map

package/dist/cli/commands/test-server.js.map

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

package/dist/cli/daemon.d.ts

@@ -0,0 +1,60 @@
+/**
+ * Daemon CLI subcommands for MCP Conductor.
+ *
+ * Designed as a self-contained module so Agent I (X2 lifecycle CLI) can
+ * import and register these commands without taking a dependency on the full
+ * daemon implementation at the top level.
+ *
+ * Usage (in the host CLI program):
+ *
+ * ```typescript
+ * import { Command } from 'commander';
+ * import { registerDaemonCommands } from './cli/daemon.js';
+ *
+ * const program = new Command();
+ * registerDaemonCommands(program);
+ * program.parse();
+ * ```
+ *
+ * Available subcommands:
+ *   daemon start   — Start the daemon in the background
+ *   daemon stop    — Stop a running daemon
+ *   daemon status  — Print daemon health and stats
+ *   daemon logs    — Tail the daemon log file
+ *
+ * @module cli/daemon
+ */
+declare function daemonStart(options: {
+    port?: string;
+    background?: boolean;
+}): Promise<void>;
+declare function daemonStop(): Promise<void>;
+declare function daemonStatus(): Promise<void>;
+declare function daemonLogs(options: {
+    lines?: string;
+    follow?: boolean;
+}): Promise<void>;
+/**
+ * Register all daemon subcommands onto a Commander `program` instance.
+ *
+ * @example
+ * ```typescript
+ * import { Command } from 'commander';
+ * import { registerDaemonCommands } from './cli/daemon.js';
+ * const program = new Command('mcp-conductor-cli');
+ * registerDaemonCommands(program);
+ * program.parse();
+ * ```
+ */
+export declare function registerDaemonCommands(program: {
+    command: (name: string) => DaemonCommandBuilder;
+}): void;
+/** Minimal interface matching Commander's Command for type safety without the dep. */
+interface DaemonCommandBuilder {
+    description: (d: string) => DaemonCommandBuilder;
+    option: (flags: string, description?: string, defaultValue?: string) => DaemonCommandBuilder;
+    action: (fn: (...args: unknown[]) => void | Promise<void>) => DaemonCommandBuilder;
+    command: (name: string) => DaemonCommandBuilder;
+}
+export { daemonStart, daemonStop, daemonStatus, daemonLogs };
+//# sourceMappingURL=daemon.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"daemon.d.ts","sourceRoot":"","sources":["../../src/cli/daemon.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAgDH,iBAAe,WAAW,CAAC,OAAO,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAqC1F;AAED,iBAAe,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CA4BzC;AAED,iBAAe,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC,CAoB3C;AAED,iBAAe,UAAU,CAAC,OAAO,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAwCtF;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE;IAC9C,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,oBAAoB,CAAC;CACjD,GAAG,IAAI,CAmCP;AAMD,sFAAsF;AACtF,UAAU,oBAAoB;IAC5B,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,oBAAoB,CAAC;IACjD,MAAM,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,KAAK,oBAAoB,CAAC;IAC7F,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,oBAAoB,CAAC;IACnF,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,oBAAoB,CAAC;CACjD;AAMD,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,EAAE,CAAC"}

package/dist/cli/daemon.js

@@ -0,0 +1,244 @@
+/**
+ * Daemon CLI subcommands for MCP Conductor.
+ *
+ * Designed as a self-contained module so Agent I (X2 lifecycle CLI) can
+ * import and register these commands without taking a dependency on the full
+ * daemon implementation at the top level.
+ *
+ * Usage (in the host CLI program):
+ *
+ * ```typescript
+ * import { Command } from 'commander';
+ * import { registerDaemonCommands } from './cli/daemon.js';
+ *
+ * const program = new Command();
+ * registerDaemonCommands(program);
+ * program.parse();
+ * ```
+ *
+ * Available subcommands:
+ *   daemon start   — Start the daemon in the background
+ *   daemon stop    — Stop a running daemon
+ *   daemon status  — Print daemon health and stats
+ *   daemon logs    — Tail the daemon log file
+ *
+ * @module cli/daemon
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync, statSync, createReadStream } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import { spawn } from 'node:child_process';
+import { DaemonClient } from '../daemon/client.js';
+// ---------------------------------------------------------------------------
+// Paths
+// ---------------------------------------------------------------------------
+const CONDUCTOR_DIR = join(homedir(), '.mcp-conductor');
+const PID_FILE = join(CONDUCTOR_DIR, 'daemon.pid');
+const LOG_FILE = join(CONDUCTOR_DIR, 'daemon.log');
+const SOCKET_PATH = join(CONDUCTOR_DIR, 'daemon.sock');
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function ensureDir() {
+    mkdirSync(CONDUCTOR_DIR, { recursive: true });
+}
+function readPid() {
+    if (!existsSync(PID_FILE))
+        return null;
+    try {
+        return parseInt(readFileSync(PID_FILE, 'utf-8').trim(), 10);
+    }
+    catch {
+        return null;
+    }
+}
+function isRunning(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+// ---------------------------------------------------------------------------
+// Subcommand implementations
+// ---------------------------------------------------------------------------
+async function daemonStart(options) {
+    ensureDir();
+    const pid = readPid();
+    if (pid !== null && isRunning(pid)) {
+        console.log(`Daemon is already running (PID ${pid})`);
+        return;
+    }
+    const tcpPort = options.port ? parseInt(options.port, 10) : undefined;
+    // Build the daemon entry script args.
+    const args = ['--daemon-server'];
+    if (tcpPort)
+        args.push('--tcp-port', String(tcpPort));
+    // Spawn the daemon process detached.
+    const out = require('node:fs').openSync(LOG_FILE, 'a');
+    const child = spawn(process.execPath, [process.argv[1], ...args], {
+        detached: true,
+        stdio: ['ignore', out, out],
+    });
+    child.unref();
+    writeFileSync(PID_FILE, String(child.pid), 'utf-8');
+    // Brief wait for the socket to appear.
+    let ready = false;
+    for (let i = 0; i < 20; i++) {
+        await new Promise((r) => setTimeout(r, 100));
+        if (existsSync(SOCKET_PATH)) {
+            ready = true;
+            break;
+        }
+    }
+    if (ready) {
+        console.log(`Daemon started (PID ${child.pid})`);
+    }
+    else {
+        console.warn(`Daemon spawned (PID ${child.pid}) but socket not yet visible. Check logs: ${LOG_FILE}`);
+    }
+}
+async function daemonStop() {
+    const pid = readPid();
+    if (pid === null) {
+        console.log('No PID file found — daemon may not be running.');
+        return;
+    }
+    if (!isRunning(pid)) {
+        console.log(`Daemon PID ${pid} is not running.`);
+        return;
+    }
+    try {
+        process.kill(pid, 'SIGTERM');
+        // Wait up to 5 s for the process to exit.
+        for (let i = 0; i < 50; i++) {
+            await new Promise((r) => setTimeout(r, 100));
+            if (!isRunning(pid))
+                break;
+        }
+        if (!isRunning(pid)) {
+            console.log(`Daemon (PID ${pid}) stopped.`);
+        }
+        else {
+            console.warn(`Daemon (PID ${pid}) did not exit in 5 s. Sending SIGKILL.`);
+            process.kill(pid, 'SIGKILL');
+        }
+    }
+    catch (err) {
+        console.error(`Failed to stop daemon: ${String(err)}`);
+    }
+}
+async function daemonStatus() {
+    const pid = readPid();
+    if (pid === null || !isRunning(pid)) {
+        console.log('Daemon: STOPPED');
+        return;
+    }
+    console.log(`Daemon: RUNNING (PID ${pid})`);
+    // Try connecting to get live stats.
+    try {
+        const client = new DaemonClient({ connectTimeoutMs: 2000 });
+        await client.connect();
+        const stats = await client.stats();
+        console.log('Stats:', JSON.stringify(stats, null, 2));
+        await client.disconnect();
+    }
+    catch (err) {
+        console.log(`(Could not fetch live stats: ${String(err)})`);
+    }
+}
+async function daemonLogs(options) {
+    if (!existsSync(LOG_FILE)) {
+        console.log('No log file found at', LOG_FILE);
+        return;
+    }
+    const n = parseInt(options.lines ?? '50', 10);
+    if (options.follow) {
+        // Simple tail -f implementation using a ReadStream.
+        const stat = statSync(LOG_FILE);
+        const stream = createReadStream(LOG_FILE, {
+            start: Math.max(0, stat.size - 8192),
+            encoding: 'utf-8',
+        });
+        stream.pipe(process.stdout);
+        stream.on('end', () => {
+            // Keep watching by polling — Node.js fs.watch is enough for a dev tool.
+            let lastSize = stat.size;
+            const interval = setInterval(() => {
+                try {
+                    const newStat = statSync(LOG_FILE);
+                    if (newStat.size > lastSize) {
+                        const tail = createReadStream(LOG_FILE, {
+                            start: lastSize,
+                            encoding: 'utf-8',
+                        });
+                        tail.pipe(process.stdout);
+                        lastSize = newStat.size;
+                    }
+                }
+                catch {
+                    clearInterval(interval);
+                }
+            }, 500);
+            process.on('SIGINT', () => { clearInterval(interval); process.exit(0); });
+        });
+    }
+    else {
+        const content = readFileSync(LOG_FILE, 'utf-8');
+        const lines = content.split('\n').filter(Boolean);
+        const tail = lines.slice(-n).join('\n');
+        console.log(tail);
+    }
+}
+// ---------------------------------------------------------------------------
+// Registration function (Agent I integration point)
+// ---------------------------------------------------------------------------
+/**
+ * Register all daemon subcommands onto a Commander `program` instance.
+ *
+ * @example
+ * ```typescript
+ * import { Command } from 'commander';
+ * import { registerDaemonCommands } from './cli/daemon.js';
+ * const program = new Command('mcp-conductor-cli');
+ * registerDaemonCommands(program);
+ * program.parse();
+ * ```
+ */
+export function registerDaemonCommands(program) {
+    const daemon = program.command('daemon').description('Manage the MCP Conductor daemon process');
+    // daemon start
+    daemon.command('start')
+        .description('Start the daemon in the background')
+        .option('--port <port>', 'TCP port for Tailscale clients')
+        .action(async (...args) => {
+        await daemonStart(args[0]);
+    });
+    // daemon stop
+    daemon.command('stop')
+        .description('Stop the running daemon')
+        .action(async () => {
+        await daemonStop();
+    });
+    // daemon status
+    daemon.command('status')
+        .description('Show daemon health and statistics')
+        .action(async () => {
+        await daemonStatus();
+    });
+    // daemon logs
+    daemon.command('logs')
+        .description('Show daemon log output')
+        .option('-n, --lines <n>', 'Number of lines to show', '50')
+        .option('-f, --follow', 'Follow log output')
+        .action(async (...args) => {
+        await daemonLogs(args[0]);
+    });
+}
+// ---------------------------------------------------------------------------
+// Exported individual action functions (for programmatic use and testing)
+// ---------------------------------------------------------------------------
+export { daemonStart, daemonStop, daemonStatus, daemonLogs };
+//# sourceMappingURL=daemon.js.map

package/dist/cli/daemon.js.map

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

package/dist/cli/replay.d.ts

@@ -0,0 +1,16 @@
+/**
+ * CLI — replay subcommand
+ *
+ * Usage:
+ *   mcp-conductor-cli replay <recordingPath> [--at <seq> --op replace|skip [--with <json>]] ...
+ *   mcp-conductor-cli replay --list
+ *
+ * Options:
+ *   --list                   List all available recordings
+ *   --at <n>                 Sequence index for a modification
+ *   --op replace|skip        Operation to apply at that index
+ *   --with <json>            JSON value for replace operation
+ *   --recordings-dir <path>  Override the recordings directory
+ */
+export declare function runReplayCli(argv?: string[]): Promise<void>;
+//# sourceMappingURL=replay.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../../src/cli/replay.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAyDH,wBAAsB,YAAY,CAAC,IAAI,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CA6CxF"}

package/dist/cli/replay.js

@@ -0,0 +1,89 @@
+/**
+ * CLI — replay subcommand
+ *
+ * Usage:
+ *   mcp-conductor-cli replay <recordingPath> [--at <seq> --op replace|skip [--with <json>]] ...
+ *   mcp-conductor-cli replay --list
+ *
+ * Options:
+ *   --list                   List all available recordings
+ *   --at <n>                 Sequence index for a modification
+ *   --op replace|skip        Operation to apply at that index
+ *   --with <json>            JSON value for replace operation
+ *   --recordings-dir <path>  Override the recordings directory
+ */
+import { ReplayRecorder } from '../observability/index.js';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+function parseArgs(argv) {
+    const result = { list: false, modifications: [] };
+    let i = 0;
+    while (i < argv.length) {
+        const arg = argv[i];
+        if (arg === '--list') {
+            result.list = true;
+            i++;
+            continue;
+        }
+        if (arg === '--recordings-dir') {
+            result.recordingsDir = argv[++i];
+            i++;
+            continue;
+        }
+        if (arg === '--at') {
+            const at = parseInt(argv[++i] ?? '0', 10);
+            i++;
+            const nextArg = argv[i];
+            const op = nextArg === '--op' ? (argv[++i] ?? 'replace') : 'replace';
+            if (nextArg === '--op')
+                i++;
+            let withValue;
+            if (i < argv.length && argv[i] === '--with') {
+                withValue = JSON.parse(argv[++i] ?? 'null');
+                i++;
+            }
+            result.modifications.push({ at, op: op, with: withValue });
+            continue;
+        }
+        if (arg && !arg.startsWith('--')) {
+            result.recordingPath = arg;
+        }
+        i++;
+    }
+    return result;
+}
+export async function runReplayCli(argv = process.argv.slice(2)) {
+    const args = parseArgs(argv);
+    const recordingsDir = args.recordingsDir
+        ?? join(homedir(), '.mcp-conductor', 'recordings');
+    const recorder = new ReplayRecorder({ recordingsDir });
+    if (args.list) {
+        const recordings = recorder.listRecordings();
+        if (recordings.length === 0) {
+            process.stdout.write('No recordings found.\n');
+            return;
+        }
+        for (const r of recordings) {
+            const kb = (r.sizeBytes / 1024).toFixed(1);
+            const date = new Date(r.createdAt).toISOString();
+            process.stdout.write(`${r.sessionId}  ${kb} KB  ${date}\n`);
+        }
+        return;
+    }
+    if (!args.recordingPath) {
+        process.stderr.write('Usage: replay <recordingPath> [--at <seq> --op replace|skip [--with <json>]] ...\n' +
+            '       replay --list\n');
+        process.exit(1);
+    }
+    const { result, divergence } = recorder.replay(args.recordingPath, args.modifications);
+    if (divergence) {
+        process.stderr.write(`Divergence detected at seq ${divergence.at}:\n` +
+            `  expected: ${JSON.stringify(divergence.expected)}\n` +
+            `  actual:   ${JSON.stringify(divergence.actual)}\n`);
+    }
+    process.stdout.write(JSON.stringify(result, null, 2) + '\n');
+    if (divergence) {
+        process.exit(2);
+    }
+}
+//# sourceMappingURL=replay.js.map

package/dist/cli/replay.js.map

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

package/dist/cli/wizard/setup.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Interactive setup wizard using @inquirer/prompts.
+ * Guides the user through discovering Claude configs, importing servers,
+ * and optionally cleaning up source configs.
+ * @module cli/wizard/setup
+ */
+/**
+ * Run the full interactive setup wizard.
+ * Falls back to non-interactive mode if TTY is not available (CI).
+ */
+export declare function runSetupWizard(): Promise<void>;
+//# sourceMappingURL=setup.d.ts.map

package/dist/cli/wizard/setup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/cli/wizard/setup.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAmEpD"}