@a5c-ai/agent-mux-cli 0.2.0

package/dist/commands/hooks.js

@@ -0,0 +1,219 @@
+/**
+ * `amux hooks <agent> <subcommand> [args]` — manage and dispatch hooks.
+ *
+ * Subcommands:
+ *   discover            List native hook types supported by the harness.
+ *   list                List registered hooks (project + global).
+ *   add <hookType> [--handler builtin|command|script] [--target <t>] [--id <id>] [--global]
+ *   remove <id> [--global]
+ *   set <id> [--priority N] [--enabled true|false] [--target <t>]
+ *   handle <hookType>   Read JSON payload on stdin, dispatch, emit unified result.
+ */
+import { HookConfigManager, HookDispatcher, builtInHooks, getHookCatalog, parseHookPayload, formatHookResult, } from '@a5c-ai/agent-mux-core';
+import { flagBool, flagStr } from '../parse-args.js';
+import { ExitCode } from '../exit-codes.js';
+import { printError, printJsonError, printJsonOk, printTable, } from '../output.js';
+export const HOOKS_FLAGS = {
+    handler: { type: 'string' },
+    target: { type: 'string' },
+    priority: { type: 'string' },
+    enabled: { type: 'string' },
+    id: { type: 'string' },
+    global: { type: 'boolean' },
+    project: { type: 'boolean' },
+};
+function jsonMode(args) {
+    return flagBool(args.flags, 'json') === true;
+}
+export async function hooksCommand(_client, args) {
+    const json = jsonMode(args);
+    const agent = args.subcommand;
+    const sub = args.positionals[0];
+    if (!agent || !sub) {
+        const msg = 'Usage: amux hooks <agent> <discover|list|add|remove|set|handle> [...]';
+        if (json)
+            printJsonError('VALIDATION_ERROR', msg);
+        else
+            printError(msg);
+        return ExitCode.USAGE_ERROR;
+    }
+    const mgr = new HookConfigManager();
+    switch (sub) {
+        case 'discover':
+            return discover(agent, json);
+        case 'list':
+            return await list(agent, mgr, json);
+        case 'add':
+            return await add(agent, mgr, args, json);
+        case 'remove':
+            return await remove(mgr, args, json);
+        case 'set':
+            return await set(mgr, args, json);
+        case 'handle':
+            return await handle(agent, mgr, args);
+        default: {
+            const msg = `Unknown hooks subcommand: ${sub}`;
+            if (json)
+                printJsonError('VALIDATION_ERROR', msg);
+            else
+                printError(msg);
+            return ExitCode.USAGE_ERROR;
+        }
+    }
+}
+function discover(agent, json) {
+    const entries = getHookCatalog(agent);
+    if (json) {
+        printJsonOk({ agent, hookTypes: entries });
+        return ExitCode.SUCCESS;
+    }
+    if (entries.length === 0) {
+        process.stdout.write(`(no hook catalog entry for ${agent})\n`);
+        return ExitCode.SUCCESS;
+    }
+    printTable(['Hook', 'Direction', 'Description'], entries.map((e) => [e.name, e.direction, e.description]));
+    return ExitCode.SUCCESS;
+}
+async function list(agent, mgr, json) {
+    const all = await mgr.list();
+    const matching = all.filter((h) => h.agent === agent || h.agent === '*');
+    if (json) {
+        printJsonOk({ hooks: matching });
+        return ExitCode.SUCCESS;
+    }
+    if (matching.length === 0) {
+        process.stdout.write('(no hooks registered)\n');
+        return ExitCode.SUCCESS;
+    }
+    printTable(['ID', 'HookType', 'Handler', 'Target', 'Priority', 'Enabled'], matching.map((h) => [
+        h.id,
+        h.hookType,
+        h.handler,
+        h.target,
+        String(h.priority ?? 100),
+        String(h.enabled !== false),
+    ]));
+    return ExitCode.SUCCESS;
+}
+async function add(agent, mgr, args, json) {
+    const hookType = args.positionals[1];
+    if (!hookType) {
+        const msg = 'Usage: amux hooks <agent> add <hookType> [--handler ...] [--target ...]';
+        if (json)
+            printJsonError('VALIDATION_ERROR', msg);
+        else
+            printError(msg);
+        return ExitCode.USAGE_ERROR;
+    }
+    const id = flagStr(args.flags, 'id') ?? `${agent}.${hookType}.${Date.now().toString(36)}`;
+    const handler = (flagStr(args.flags, 'handler') ?? 'builtin');
+    const target = flagStr(args.flags, 'target') ?? 'log';
+    const priority = flagStr(args.flags, 'priority');
+    const scope = flagBool(args.flags, 'global') === true ? 'global' : 'project';
+    const reg = {
+        id,
+        agent: agent,
+        hookType,
+        handler,
+        target,
+        priority: priority ? Number(priority) : undefined,
+        enabled: true,
+    };
+    await mgr.add(reg, scope);
+    if (json)
+        printJsonOk({ added: reg, scope });
+    else
+        process.stdout.write(`Added hook ${id} (${scope}).\n`);
+    return ExitCode.SUCCESS;
+}
+async function remove(mgr, args, json) {
+    const id = args.positionals[1];
+    if (!id) {
+        const msg = 'Usage: amux hooks <agent> remove <id>';
+        if (json)
+            printJsonError('VALIDATION_ERROR', msg);
+        else
+            printError(msg);
+        return ExitCode.USAGE_ERROR;
+    }
+    const scope = flagBool(args.flags, 'global') === true ? 'global'
+        : flagBool(args.flags, 'project') === true ? 'project' : undefined;
+    const removed = await mgr.remove(id, scope);
+    if (json)
+        printJsonOk({ removed, id });
+    else
+        process.stdout.write(removed ? `Removed ${id}.\n` : `No hook with id ${id}.\n`);
+    return removed ? ExitCode.SUCCESS : ExitCode.GENERAL_ERROR;
+}
+async function set(mgr, args, json) {
+    const id = args.positionals[1];
+    if (!id) {
+        const msg = 'Usage: amux hooks <agent> set <id> [--priority N] [--enabled true|false] [--target ...]';
+        if (json)
+            printJsonError('VALIDATION_ERROR', msg);
+        else
+            printError(msg);
+        return ExitCode.USAGE_ERROR;
+    }
+    const patch = {};
+    const priority = flagStr(args.flags, 'priority');
+    const enabled = flagStr(args.flags, 'enabled');
+    const target = flagStr(args.flags, 'target');
+    if (priority !== undefined)
+        patch['priority'] = Number(priority);
+    if (enabled !== undefined)
+        patch['enabled'] = enabled === 'true';
+    if (target !== undefined)
+        patch['target'] = target;
+    const updated = await mgr.set(id, patch);
+    if (!updated) {
+        if (json)
+            printJsonError('VALIDATION_ERROR', `No hook with id ${id}`);
+        else
+            printError(`No hook with id ${id}`);
+        return ExitCode.GENERAL_ERROR;
+    }
+    if (json)
+        printJsonOk({ updated });
+    else
+        process.stdout.write(`Updated ${id}.\n`);
+    return ExitCode.SUCCESS;
+}
+async function handle(agent, mgr, args) {
+    const hookType = args.positionals[1];
+    if (!hookType) {
+        process.stderr.write('Usage: amux hooks <agent> handle <hookType>\n');
+        return ExitCode.USAGE_ERROR;
+    }
+    const raw = await readStdin();
+    let parsed = {};
+    if (raw.trim()) {
+        try {
+            parsed = JSON.parse(raw);
+        }
+        catch {
+            parsed = { body: raw };
+        }
+    }
+    const payload = parseHookPayload(agent, hookType, parsed);
+    const dispatcher = new HookDispatcher(mgr, builtInHooks);
+    const result = await dispatcher.dispatch(payload);
+    const { stdout, exitCode } = formatHookResult(agent, hookType, result);
+    if (stdout)
+        process.stdout.write(stdout);
+    return exitCode;
+}
+function readStdin() {
+    return new Promise((resolve) => {
+        if (process.stdin.isTTY) {
+            resolve('');
+            return;
+        }
+        let buf = '';
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('data', (d) => (buf += d));
+        process.stdin.on('end', () => resolve(buf));
+        process.stdin.on('error', () => resolve(buf));
+    });
+}
+//# sourceMappingURL=hooks.js.map

package/dist/commands/hooks.js.map

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

package/dist/commands/install-helpers.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Internal helpers for the install/update/detect/uninstall commands.
+ * Split out to keep `install.ts` under the max-file-lines budget.
+ */
+export type SpawnRunner = (command: string, args: string[]) => Promise<{
+    code: number;
+    stdout: string;
+    stderr: string;
+}>;
+/**
+ * Create a SpawnRunner. When `echo` is true, child output is mirrored to
+ * the CLI's stdout/stderr (useful for long-running install commands in
+ * human mode). When false (default for JSON/detect), child output is
+ * captured silently so it doesn't contaminate structured output.
+ */
+export declare function makeSpawnRunner(echo: boolean): SpawnRunner;
+export declare const defaultSpawnRunner: SpawnRunner;
+export declare const silentSpawnRunner: SpawnRunner;
+/**
+ * Temporarily swallow writes to process.stdout/stderr while `fn` runs.
+ * Used to suppress per-agent JSON envelopes when `--all --json` aggregates
+ * results into a single response.
+ */
+export declare function runSilently<T>(fn: () => Promise<T>): Promise<T>;
+//# sourceMappingURL=install-helpers.d.ts.map

package/dist/commands/install-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-helpers.d.ts","sourceRoot":"","sources":["../../src/commands/install-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,MAAM,WAAW,GAAG,CACxB,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,KACX,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAE/D;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,WAAW,CAuB1D;AAED,eAAO,MAAM,kBAAkB,EAAE,WAAmC,CAAC;AACrE,eAAO,MAAM,iBAAiB,EAAE,WAAoC,CAAC;AAErE;;;;GAIG;AACH,wBAAsB,WAAW,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAYrE"}

package/dist/commands/install-helpers.js

@@ -0,0 +1,58 @@
+/**
+ * Internal helpers for the install/update/detect/uninstall commands.
+ * Split out to keep `install.ts` under the max-file-lines budget.
+ */
+import { spawn } from 'node:child_process';
+/**
+ * Create a SpawnRunner. When `echo` is true, child output is mirrored to
+ * the CLI's stdout/stderr (useful for long-running install commands in
+ * human mode). When false (default for JSON/detect), child output is
+ * captured silently so it doesn't contaminate structured output.
+ */
+export function makeSpawnRunner(echo) {
+    return (command, args) => new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            stdio: ['ignore', 'pipe', 'pipe'],
+            shell: false,
+            windowsHide: true,
+        });
+        let stdout = '';
+        let stderr = '';
+        child.stdout?.setEncoding('utf8');
+        child.stderr?.setEncoding('utf8');
+        child.stdout?.on('data', (c) => {
+            stdout += c;
+            if (echo)
+                process.stdout.write(c);
+        });
+        child.stderr?.on('data', (c) => {
+            stderr += c;
+            if (echo)
+                process.stderr.write(c);
+        });
+        child.on('error', (err) => reject(err));
+        child.on('exit', (code) => resolve({ code: code ?? 1, stdout, stderr }));
+    });
+}
+export const defaultSpawnRunner = makeSpawnRunner(true);
+export const silentSpawnRunner = makeSpawnRunner(false);
+/**
+ * Temporarily swallow writes to process.stdout/stderr while `fn` runs.
+ * Used to suppress per-agent JSON envelopes when `--all --json` aggregates
+ * results into a single response.
+ */
+export async function runSilently(fn) {
+    const origOut = process.stdout.write.bind(process.stdout);
+    const origErr = process.stderr.write.bind(process.stderr);
+    const noop = ((..._a) => true);
+    process.stdout.write = noop;
+    process.stderr.write = noop;
+    try {
+        return await fn();
+    }
+    finally {
+        process.stdout.write = origOut;
+        process.stderr.write = origErr;
+    }
+}
+//# sourceMappingURL=install-helpers.js.map

package/dist/commands/install-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"install-helpers.js","sourceRoot":"","sources":["../../src/commands/install-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAC;AAO3C;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAAC,IAAa;IAC3C,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,EAAE,CACvB,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAC9B,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;YACjC,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;YACjC,KAAK,EAAE,KAAK;YACZ,WAAW,EAAE,IAAI;SAClB,CAAC,CAAC;QACH,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,IAAI,MAAM,GAAG,EAAE,CAAC;QAChB,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,KAAK,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;QAClC,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;YACrC,MAAM,IAAI,CAAC,CAAC;YACZ,IAAI,IAAI;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,CAAC,CAAS,EAAE,EAAE;YACrC,MAAM,IAAI,CAAC,CAAC;YACZ,IAAI,IAAI;gBAAE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACpC,CAAC,CAAC,CAAC;QACH,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;QACxC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC;IAC3E,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAgB,eAAe,CAAC,IAAI,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,iBAAiB,GAAgB,eAAe,CAAC,KAAK,CAAC,CAAC;AAErE;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAI,EAAoB;IACvD,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,IAAI,GAAG,CAAC,CAAC,GAAG,EAAa,EAAE,EAAE,CAAC,IAAI,CAAmB,CAAC;IAC3D,OAAO,CAAC,MAA+C,CAAC,KAAK,GAAG,IAAI,CAAC;IACrE,OAAO,CAAC,MAA+C,CAAC,KAAK,GAAG,IAAI,CAAC;IACtE,IAAI,CAAC;QACH,OAAO,MAAM,EAAE,EAAE,CAAC;IACpB,CAAC;YAAS,CAAC;QACR,OAAO,CAAC,MAA+C,CAAC,KAAK,GAAG,OAAO,CAAC;QACxE,OAAO,CAAC,MAA+C,CAAC,KAAK,GAAG,OAAO,CAAC;IAC3E,CAAC;AACH,CAAC"}

package/dist/commands/install.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `amux install <agent>`, `amux update <agent>`, `amux detect <agent>`,
+ * and `amux uninstall <agent>` commands.
+ *
+ * Dispatches to the adapter's per-agent install/update/detect methods,
+ * so each harness may override behavior.
+ *
+ * @see docs/10-cli-reference.md
+ */
+import type { AgentMuxClient } from '@a5c-ai/agent-mux-core';
+import type { ParsedArgs, FlagDef } from '../parse-args.js';
+import { type SpawnRunner as HelperSpawnRunner } from './install-helpers.js';
+/** Flags recognized by the install/uninstall/update/detect commands. */
+export declare const INSTALL_FLAGS: Record<string, FlagDef>;
+export type SpawnRunner = HelperSpawnRunner;
+export interface InstallCommandDeps {
+    /** Back-compat: overrides the adapter's internal Spawner for this run. */
+    spawnRunner?: SpawnRunner;
+}
+/**
+ * Handle `amux install [<agent>] [--all]`, `amux update [<agent>] [--all]`,
+ * `amux detect [<agent>] [--all]`, and `amux uninstall <agent>`.
+ */
+export declare function installCommand(client: AgentMuxClient, args: ParsedArgs, deps?: InstallCommandDeps): Promise<number>;
+//# sourceMappingURL=install.d.ts.map

package/dist/commands/install.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"install.d.ts","sourceRoot":"","sources":["../../src/commands/install.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,cAAc,EAKf,MAAM,wBAAwB,CAAC;AAGhC,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAO5D,OAAO,EAEL,KAAK,WAAW,IAAI,iBAAiB,EACtC,MAAM,sBAAsB,CAAC;AAE9B,wEAAwE;AACxE,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAKjD,CAAC;AAOF,MAAM,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAM5C,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,WAAW,CAAC,EAAE,WAAW,CAAC;CAC3B;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAClC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,UAAU,EAChB,IAAI,GAAE,kBAAuB,GAC5B,OAAO,CAAC,MAAM,CAAC,CA+CjB"}