@a5c-ai/agent-mux-cli 0.2.0

package/dist/commands/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/commands/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACjE,OAAO,EACL,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,UAAU,EAAiB,OAAO,GAC3E,MAAM,cAAc,CAAC;AAEtB,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,MAAsB,EAAE,IAAgB;IAC1E,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC;IAC5B,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;IAEvD,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAClE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,QAAQ,EAAE,CAAC;gBACb,cAAc,CAAC,kBAAkB,EAAE,oCAAoC,CAAC,CAAC;YAC3E,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,oCAAoC,CAAC,CAAC;YACnD,CAAC;YACD,OAAO,QAAQ,CAAC,WAAW,CAAC;QAC9B,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QAClC,OAAO,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;QAClB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;QAClC,IAAI,CAAC,KAAK,IAAI,CAAC,KAAK,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YAC5C,IAAI,QAAQ,EAAE,CAAC;gBACb,cAAc,CAAC,kBAAkB,EAAE,gDAAgD,CAAC,CAAC;YACvF,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,gDAAgD,CAAC,CAAC;YAC/D,CAAC;YACD,OAAO,QAAQ,CAAC,WAAW,CAAC;QAC9B,CAAC;QACD,OAAO,SAAS,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAClE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,QAAQ,EAAE,CAAC;gBACb,cAAc,CAAC,kBAAkB,EAAE,oCAAoC,CAAC,CAAC;YAC3E,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,oCAAoC,CAAC,CAAC;YACnD,CAAC;YACD,OAAO,QAAQ,CAAC,WAAW,CAAC;QAC9B,CAAC;QACD,OAAO,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;QACvB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAClE,IAAI,CAAC,KAAK,EAAE,CAAC;YACX,IAAI,QAAQ,EAAE,CAAC;gBACb,cAAc,CAAC,kBAAkB,EAAE,oCAAoC,CAAC,CAAC;YAC3E,CAAC;iBAAM,CAAC;gBACN,UAAU,CAAC,oCAAoC,CAAC,CAAC;YACnD,CAAC;YACD,OAAO,QAAQ,CAAC,WAAW,CAAC;QAC9B,CAAC;QACD,OAAO,cAAc,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,GAAG,KAAK,QAAQ,EAAE,CAAC;QACrB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAClE,OAAO,YAAY,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;IAC/C,CAAC;IAED,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,IAAI,QAAQ,EAAE,CAAC;YACb,cAAc,CAAC,kBAAkB,EAAE,mEAAmE,CAAC,CAAC;QAC1G,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,mEAAmE,CAAC,CAAC;QAClF,CAAC;QACD,OAAO,QAAQ,CAAC,WAAW,CAAC;IAC9B,CAAC;IAED,IAAI,QAAQ,EAAE,CAAC;QACb,cAAc,CAAC,kBAAkB,EAAE,8BAA8B,GAAG,EAAE,CAAC,CAAC;IAC1E,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,8BAA8B,GAAG,EAAE,CAAC,CAAC;IAClD,CAAC;IACD,OAAO,QAAQ,CAAC,WAAW,CAAC;AAC9B,CAAC;AAED,KAAK,UAAU,SAAS,CACtB,MAAsB,EAAE,KAAa,EAAE,KAAyB,EAAE,QAAiB;IAEnF,IAAI,CAAC;QACH,IAAI,MAAe,CAAC;QACpB,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;QACtD,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC;QAED,IAAI,QAAQ,EAAE,CAAC;YACb,kEAAkE;YAClE,yDAAyD;YACzD,WAAW,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACpD,CAAC;aAAM,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACzD,SAAS,CAAC,MAAM,CAAC,CAAC;QACpB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC,CAAC;QAC9C,CAAC;QACD,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CACtB,MAAsB,EAAE,KAAa,EAAE,KAAa,EAAE,QAAgB,EAAE,QAAiB;IAEzF,IAAI,CAAC;QACH,sEAAsE;QACtE,IAAI,KAAK,GAAY,QAAQ,CAAC;QAC9B,IACE,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC;YAChF,QAAQ,KAAK,MAAM,IAAI,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,MAAM;YAClE,CAAC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAC/B,CAAC;YACD,IAAI,CAAC;gBACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;YAC/B,CAAC;YAAC,MAAM,CAAC;gBACP,iBAAiB;YACnB,CAAC;QACH,CAAC;QAED,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC;QAElD,IAAI,QAAQ,EAAE,CAAC;YACb,WAAW,CAAC,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACvC,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,OAAO,KAAK,IAAI,KAAK,MAAM,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC7E,CAAC;QACD,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CAAC,MAAsB,EAAE,KAAa,EAAE,QAAiB;IAClF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAEjD,IAAI,QAAQ,EAAE,CAAC;YACb,WAAW,CAAC,MAAM,CAAC,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,SAAS,CAAC,MAAM,CAAC,CAAC;QACpB,CAAC;QACD,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,cAAc,CAAC,MAAsB,EAAE,KAAa,EAAE,QAAiB;IACpF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAC9C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAE3D,IAAI,QAAQ,EAAE,CAAC;YACb,WAAW,CAAC,MAAM,CAAC,CAAC;QACtB,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;YAC1B,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;gBACf,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,CAAC,CAAC;YACpD,CAAC;iBAAM,CAAC;gBACN,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAmC,CAAC;gBACrE,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;oBACvB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;gBAC7D,CAAC;YACH,CAAC;QACH,CAAC;QACD,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,MAAsB,EAAE,KAAyB,EAAE,QAAiB;IAEpE,IAAI,CAAC;QACH,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACpC,CAAC;aAAM,CAAC;YACN,MAAM,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;QAC/B,CAAC;QAED,IAAI,QAAQ,EAAE,CAAC;YACb,WAAW,CAAC,EAAE,QAAQ,EAAE,KAAK,IAAI,KAAK,EAAE,CAAC,CAAC;QAC5C,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,yBAAyB,KAAK,CAAC,CAAC,CAAC,QAAQ,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;QACnF,CAAC;QACD,OAAO,QAAQ,CAAC,OAAO,CAAC;IAC1B,CAAC;IAAC,OAAO,GAAY,EAAE,CAAC;QACtB,OAAO,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACpC,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,GAAY,EAAE,QAAiB;IAClD,IAAI,GAAG,YAAY,aAAa,EAAE,CAAC;QACjC,IAAI,QAAQ,EAAE,CAAC;YACb,cAAc,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,CAAC,WAAW,CAAC,CAAC;QACzD,CAAC;aAAM,CAAC;YACN,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QAC1B,CAAC;QACD,OAAO,mBAAmB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,IAAI,QAAQ,EAAE,CAAC;QACb,cAAc,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IACtC,CAAC;SAAM,CAAC;QACN,UAAU,CAAC,OAAO,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,QAAQ,CAAC,aAAa,CAAC;AAChC,CAAC"}

package/dist/commands/detect-host.d.ts

@@ -0,0 +1,8 @@
+/**
+ * `amux detect-host` — detect whether the current process is running
+ * under a supported agent harness.
+ */
+import type { AgentMuxClient } from '@a5c-ai/agent-mux-core';
+import type { ParsedArgs } from '../parse-args.js';
+export declare function detectHostCommand(client: AgentMuxClient, args: ParsedArgs): Promise<number>;
+//# sourceMappingURL=detect-host.d.ts.map

package/dist/commands/detect-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-host.d.ts","sourceRoot":"","sources":["../../src/commands/detect-host.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAKnD,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,MAAM,CAAC,CAuBjB"}

package/dist/commands/detect-host.js

@@ -0,0 +1,33 @@
+/**
+ * `amux detect-host` — detect whether the current process is running
+ * under a supported agent harness.
+ */
+import { flagBool } from '../parse-args.js';
+import { ExitCode } from '../exit-codes.js';
+import { printJsonOk, printKeyValue } from '../output.js';
+export async function detectHostCommand(client, args) {
+    const jsonMode = flagBool(args.flags, 'json') === true;
+    const info = client.detectHost();
+    if (jsonMode) {
+        printJsonOk({
+            detected: info !== null,
+            agent: info?.agent ?? null,
+            confidence: info?.confidence ?? null,
+            source: info?.source ?? null,
+            matchedSignals: info?.matchedSignals ?? [],
+        });
+    }
+    else if (info === null) {
+        process.stdout.write('No host harness detected. This process appears to be running from a shell.\n');
+    }
+    else {
+        printKeyValue([
+            ['Host agent:', info.agent],
+            ['Confidence:', info.confidence],
+            ['Source:', info.source],
+            ['Signals:', info.matchedSignals.join(', ') || '--'],
+        ]);
+    }
+    return ExitCode.SUCCESS;
+}
+//# sourceMappingURL=detect-host.js.map

package/dist/commands/detect-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-host.js","sourceRoot":"","sources":["../../src/commands/detect-host.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE1D,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,MAAsB,EACtB,IAAgB;IAEhB,MAAM,QAAQ,GAAG,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,CAAC;IACvD,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC;IAEjC,IAAI,QAAQ,EAAE,CAAC;QACb,WAAW,CAAC;YACV,QAAQ,EAAE,IAAI,KAAK,IAAI;YACvB,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,IAAI;YAC1B,UAAU,EAAE,IAAI,EAAE,UAAU,IAAI,IAAI;YACpC,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,IAAI;YAC5B,cAAc,EAAE,IAAI,EAAE,cAAc,IAAI,EAAE;SAC3C,CAAC,CAAC;IACL,CAAC;SAAM,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QACzB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,8EAA8E,CAAC,CAAC;IACvG,CAAC;SAAM,CAAC;QACN,aAAa,CAAC;YACZ,CAAC,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC;YAC3B,CAAC,aAAa,EAAE,IAAI,CAAC,UAAU,CAAC;YAChC,CAAC,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC;YACxB,CAAC,UAAU,EAAE,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;SACrD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,QAAQ,CAAC,OAAO,CAAC;AAC1B,CAAC"}

package/dist/commands/doctor.d.ts

@@ -0,0 +1,4 @@
+import type { AgentMuxClient } from '@a5c-ai/agent-mux-core';
+import type { ParsedArgs } from '../parse-args.js';
+export declare function doctorCommand(client: AgentMuxClient, args: ParsedArgs): Promise<number>;
+//# sourceMappingURL=doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"doctor.d.ts","sourceRoot":"","sources":["../../src/commands/doctor.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,cAAc,EAAuC,MAAM,wBAAwB,CAAC;AAClG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AA6HnD,wBAAsB,aAAa,CACjC,MAAM,EAAE,cAAc,EACtB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,MAAM,CAAC,CAWjB"}

package/dist/commands/doctor.js

@@ -0,0 +1,120 @@
+/**
+ * `amux doctor` — aggregated environment health check.
+ *
+ * Reports Node.js version, per-adapter install + auth + config-file status,
+ * and hook registry paths. Designed for copy/paste into bug reports.
+ */
+import * as os from 'node:os';
+import * as path from 'node:path';
+import * as fs from 'node:fs/promises';
+import { flagBool } from '../parse-args.js';
+import { ExitCode } from '../exit-codes.js';
+import { printJsonOk } from '../output.js';
+async function fileExists(p) {
+    try {
+        await fs.access(p);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function meetsNodeMinimum(version) {
+    const m = version.replace(/^v/, '').split('.').map((n) => parseInt(n, 10));
+    if (m[0] > 20)
+        return true;
+    if (m[0] === 20 && m[1] >= 9)
+        return true;
+    return false;
+}
+async function buildReport(client) {
+    const adapters = client.adapters.list();
+    const agents = [];
+    for (const info of adapters) {
+        const adapter = client.adapters.get(info.agent);
+        if (!adapter)
+            continue;
+        let install;
+        try {
+            install = adapter.detectInstallation
+                ? await adapter.detectInstallation()
+                : { installed: false, notes: 'detectInstallation() not implemented' };
+        }
+        catch (e) {
+            install = { installed: false, notes: `error: ${e instanceof Error ? e.message : String(e)}` };
+        }
+        let auth;
+        try {
+            auth = await adapter.detectAuth();
+        }
+        catch (e) {
+            auth = { status: 'unauthenticated' };
+            void e;
+        }
+        const configFiles = [];
+        const paths = adapter.configSchema?.configFilePaths ?? [];
+        for (const p of paths) {
+            configFiles.push({ path: p, exists: await fileExists(p) });
+        }
+        agents.push({ agent: info.agent, install, auth, configFiles });
+    }
+    const globalHookPath = path.join(os.homedir(), '.amux', 'hooks.json');
+    const projectHookPath = path.join(process.cwd(), '.amux', 'hooks.json');
+    const installedAgents = agents.filter((a) => a.install.installed).length;
+    const authenticatedAgents = agents.filter((a) => a.auth.status === 'authenticated').length;
+    return {
+        node: {
+            version: process.version,
+            platform: process.platform,
+            arch: process.arch,
+            meetsMinimum: meetsNodeMinimum(process.version),
+        },
+        agents,
+        hooks: {
+            globalPath: globalHookPath,
+            projectPath: projectHookPath,
+            globalExists: await fileExists(globalHookPath),
+            projectExists: await fileExists(projectHookPath),
+        },
+        summary: {
+            installedAgents,
+            authenticatedAgents,
+            totalAgents: agents.length,
+        },
+    };
+}
+function formatReport(r) {
+    const lines = [];
+    lines.push('amux doctor');
+    lines.push('───────────');
+    lines.push(`Node:   ${r.node.version} on ${r.node.platform}/${r.node.arch} ${r.node.meetsMinimum ? 'OK' : '— below minimum (needs >= 20.9.0)'}`);
+    lines.push(`Agents: ${r.summary.installedAgents}/${r.summary.totalAgents} installed, ${r.summary.authenticatedAgents} authenticated`);
+    lines.push('');
+    for (const a of r.agents) {
+        const installed = a.install.installed ? 'installed' : 'not installed';
+        const version = 'version' in a.install && a.install.version ? ` v${a.install.version}` : '';
+        const authed = a.auth.status === 'authenticated' ? 'authenticated' : a.auth.status;
+        const cfg = a.configFiles.length === 0
+            ? 'none'
+            : a.configFiles.map((c) => `${c.path}${c.exists ? '' : ' (missing)'}`).join(', ');
+        lines.push(`  ${a.agent.padEnd(20)} ${installed}${version}; auth: ${authed}`);
+        lines.push(`    config: ${cfg}`);
+    }
+    lines.push('');
+    lines.push('Hooks:');
+    lines.push(`  global:  ${r.hooks.globalPath}${r.hooks.globalExists ? '' : ' (missing)'}`);
+    lines.push(`  project: ${r.hooks.projectPath}${r.hooks.projectExists ? '' : ' (missing)'}`);
+    return lines.join('\n') + '\n';
+}
+export async function doctorCommand(client, args) {
+    const jsonMode = flagBool(args.flags, 'json') === true;
+    const report = await buildReport(client);
+    if (jsonMode) {
+        printJsonOk(report);
+    }
+    else {
+        process.stdout.write(formatReport(report));
+    }
+    return ExitCode.SUCCESS;
+}
+//# sourceMappingURL=doctor.js.map

package/dist/commands/doctor.js.map

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

package/dist/commands/help.d.ts

@@ -0,0 +1,14 @@
+/**
+ * `amux help` and `--help` support.
+ *
+ * @see docs/10-cli-reference.md Section 26
+ */
+/**
+ * Print help for a command or the main help.
+ */
+export declare function printHelp(command?: string): void;
+/**
+ * Print version.
+ */
+export declare function printVersion(): void;
+//# sourceMappingURL=help.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAyUH;;GAEG;AACH,wBAAgB,SAAS,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAMhD;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAEnC"}

package/dist/commands/help.js

@@ -0,0 +1,346 @@
+/**
+ * `amux help` and `--help` support.
+ *
+ * @see docs/10-cli-reference.md Section 26
+ */
+import { createRequire } from 'node:module';
+function readVersion() {
+    try {
+        const require = createRequire(import.meta.url);
+        return require('../../package.json').version ?? '0.0.0';
+    }
+    catch {
+        return '0.0.0';
+    }
+}
+const VERSION = readVersion();
+/** Top-level help text. */
+const MAIN_HELP = `amux - Agent Multiplexer CLI (v${VERSION})
+
+Usage: amux [command] [subcommand] [args] [flags]
+
+Commands:
+  run [agent] [prompt]    Run an agent with a prompt
+  install [agent]         Install an agent CLI (or --all)
+  update [agent]          Update an agent CLI (or --all)
+  detect [agent]          Report installed version/path (or --all)
+  uninstall <agent>       Uninstall an agent CLI
+  adapters                List and inspect registered adapters
+  models                  List and inspect models
+  sessions                Manage agent sessions
+  config                  Read and write agent configuration
+  profiles                Manage named RunOptions presets
+  auth                    Check and setup authentication
+  plugins                 Manage agent plugins
+  detect-host             Detect which agent harness we are running under
+  remote                  Install / update amux on a remote host
+  hooks                   Manage and dispatch unified agent hooks
+  doctor                  Run environment health check
+  version                 Print version
+  help [command]          Show help for a command
+
+Global Flags:
+  --agent, -a <name>      Target agent name
+  --model, -m <model>     Model ID
+  --json                  Output as JSON
+  --debug                 Enable debug output
+  --config-dir <path>     Override config directory
+  --project-dir <path>    Override project config directory
+  --no-color              Disable colored output
+  --version, -V           Print version
+  --help, -h              Show help
+
+Examples:
+  amux run claude "explain this code"
+  amux run --agent gemini --json "list all files"
+  amux adapters list
+  amux models list claude
+  amux sessions list claude
+  amux config get claude model
+`;
+/** Command-specific help texts. */
+const COMMAND_HELP = {
+    run: `amux run - Run an agent with a prompt
+
+Usage: amux run [<agent>] [<prompt>] [flags]
+
+Flags:
+  --model, -m <model>          Model ID
+  --stream / --no-stream       Enable/disable streaming
+  --thinking-effort <level>    low, medium, high, max
+  --thinking-budget <tokens>   Thinking budget in tokens
+  --temperature <float>        Sampling temperature (0.0-2.0)
+  --max-tokens <int>           Maximum output tokens
+  --max-turns <int>            Maximum agentic turns
+  --session <id>               Resume session by ID
+  --fork <id>                  Fork session by ID
+  --no-session                 Ephemeral run
+  --system <text>              System prompt
+  --system-mode <mode>         prepend, append, replace
+  --cwd <path>                 Working directory
+  --env KEY=VALUE              Environment variable (repeatable)
+  --yolo                       Auto-approve all tool calls
+  --deny                       Auto-deny all approval requests
+  --timeout <ms>               Run timeout in milliseconds
+  --tag <tag>                  Run tag (repeatable)
+  --profile <name>             Named profile to apply
+  --interactive, -i            Enter interactive REPL mode
+  --quiet, -q                  Suppress non-essential output
+  --json                       Emit JSONL event stream
+
+Examples:
+  amux run claude "explain this codebase"
+  amux run codex --yolo --no-session "add tests"
+  amux run --profile fast "review this PR"
+`,
+    adapters: `amux adapters - Adapter discovery
+
+Usage:
+  amux adapters list [flags]
+  amux adapters detect <agent> [flags]
+  amux adapters info <agent> [flags]
+
+Flags:
+  --json    Output as JSON
+
+Examples:
+  amux adapters list
+  amux adapters detect claude
+  amux adapters info gemini
+`,
+    models: `amux models - Model registry
+
+Usage:
+  amux models list <agent> [flags]
+  amux models info <agent> <model> [flags]
+  amux models refresh <agent>
+
+Flags:
+  --json    Output as JSON
+
+Examples:
+  amux models list claude
+  amux models info claude claude-sonnet-4-20250514
+`,
+    sessions: `amux sessions - Session management
+
+Usage:
+  amux sessions list <agent> [flags]
+  amux sessions show <agent> <session-id>
+  amux sessions search <query> [flags]
+  amux sessions export <agent> <session-id> [flags]
+  amux sessions cost
+
+Flags:
+  --since <date>     Filter sessions after this date
+  --until <date>     Filter sessions before this date
+  --model <model>    Filter by model
+  --tag <tag>        Filter by tag (repeatable)
+  --limit <n>        Maximum results
+  --sort <field>     Sort by: date, cost, turns
+  --format <fmt>     Output format: json, jsonl, markdown
+  --json             Output as JSON
+`,
+    config: `amux config - Configuration management
+
+Usage:
+  amux config get <agent> [field]
+  amux config set <agent> <field> <value>
+  amux config schema <agent>
+  amux config validate <agent>
+  amux config reload [agent]
+
+Flags:
+  --scope <scope>    global or project
+  --json             Output as JSON
+
+Examples:
+  amux config get claude
+  amux config get claude model
+  amux config set claude model claude-sonnet-4-20250514
+  amux config schema codex
+`,
+    profiles: `amux profiles - Profile management
+
+Usage:
+  amux profiles list [flags]
+  amux profiles show <name>
+  amux profiles set <name> [run-flags]
+  amux profiles delete <name> [flags]
+  amux profiles apply <name>
+
+Flags:
+  --scope <scope>    global or project
+  --json             Output as JSON
+
+Examples:
+  amux profiles list
+  amux profiles set fast --agent claude --yolo --max-turns 5
+  amux profiles show fast
+  amux profiles delete fast
+`,
+    auth: `amux auth - Authentication
+
+Usage:
+  amux auth check [agent]
+  amux auth setup <agent>
+
+Flags:
+  --json    Output as JSON
+
+Examples:
+  amux auth check
+  amux auth check claude
+  amux auth setup gemini
+`,
+    install: `amux install - Install agent CLI binaries
+
+Usage:
+  amux install <agent> [--force] [--dry-run] [--version <v>] [--json]
+  amux install --all [--force] [--dry-run] [--json]
+  amux uninstall <agent> [--json]
+
+Flags:
+  --all             Install every registered agent
+  --force           Reinstall even if already present
+  --dry-run         Print the planned command without executing
+  --version <v>     Pin to a specific version (npm only)
+  --json            Output as JSON
+
+Examples:
+  amux install claude
+  amux install --all --dry-run
+  amux uninstall codex
+`,
+    update: `amux update - Update an installed agent CLI
+
+Usage:
+  amux update <agent> [--dry-run] [--json]
+  amux update --all [--dry-run] [--json]
+
+Flags:
+  --all       Update every registered agent
+  --dry-run   Print the planned command without executing
+  --json      Output as JSON
+
+Examples:
+  amux update claude
+  amux update --all
+`,
+    detect: `amux detect - Report installed version, path, and status per agent
+
+Usage:
+  amux detect <agent> [--json]
+  amux detect --all [--json]
+
+Flags:
+  --all     Detect every registered agent
+  --json    Output as JSON
+
+Examples:
+  amux detect claude
+  amux detect --all --json
+`,
+    uninstall: `amux uninstall - Uninstall an agent CLI binary
+
+Usage:
+  amux uninstall <agent> [--json]
+`,
+    'detect-host': `amux detect-host - Detect the current agent harness
+
+Usage:
+  amux detect-host [--json]
+
+Inspects env vars, parent process, and TTY signals to report which
+coding-agent harness (claude, codex, gemini, ...) this CLI is running
+inside, if any.
+`,
+    remote: `amux remote - Install / update amux on a remote host
+
+Usage:
+  amux remote install <host> --mode <ssh|docker|k8s|local> [flags]
+  amux remote update  <host> --mode <ssh|docker|k8s|local> [flags]
+
+Flags:
+  --mode <mode>            ssh | docker | k8s | local (required)
+  --harness <agent>        Agent to install after amux (default: claude)
+  --image <img>            Docker image (docker mode)
+  --identity-file <path>   SSH key path (ssh mode)
+  --port <n>               SSH port (ssh mode)
+  --namespace <ns>         Kubernetes namespace (k8s mode)
+  --context <ctx>          Kubernetes context (k8s mode)
+  --force                  Reinstall even if amux is already present
+  --dry-run                Print the planned commands without executing
+  --json                   Output as JSON
+
+Examples:
+  amux remote install host.example.com --mode ssh --dry-run
+  amux remote install my-pod --mode k8s --namespace dev --harness codex
+`,
+    plugins: `amux plugins - Plugin management
+
+Usage:
+  amux plugins list <agent> [flags]
+  amux plugins install <agent> <plugin> [flags]
+  amux plugins uninstall <agent> <plugin>
+
+Flags:
+  --version <ver>    Pin to specific version
+  --global           Install globally
+  --json             Output as JSON
+`,
+    hooks: `amux hooks - Unified hook management and dispatch
+
+Usage:
+  amux hooks discover [--json]              List supported hook types per harness
+  amux hooks list [--agent <a>] [--json]    List registered hooks
+  amux hooks add --id <id> --agent <a> --hook-type <t> --handler <builtin|command|script> --target <t>
+  amux hooks remove <id>
+  amux hooks set <id> [--priority N] [--enabled true|false]
+  amux hooks handle <agent> <hookType>      Dispatch a hook (reads payload JSON from stdin)
+  amux hooks install <agent> <hookType> <command>   Write native hook entry into harness config
+
+Flags:
+  --global / --project     Target scope (default: project)
+  --priority <int>         Sort order (lower = earlier); default 100
+  --enabled <bool>         Enable or disable without removal
+  --json                   Output as JSON
+
+Examples:
+  amux hooks discover
+  amux hooks add --id trace-all --agent '*' --hook-type '*' --handler builtin --target trace
+  amux hooks install claude PreToolUse "amux hooks handle claude PreToolUse"
+`,
+    doctor: `amux doctor - Health check for amux environment
+
+Usage:
+  amux doctor [--json]
+
+Aggregates:
+  - Node.js version (>= 20.9.0)
+  - Installed harness CLIs and versions (per adapter detectInstallation)
+  - Auth status per adapter (detectAuth)
+  - Config file presence per adapter
+  - Hook registry + .amux paths
+
+Use this first when filing a bug. The text report is stable for copy/paste.
+`,
+};
+/**
+ * Print help for a command or the main help.
+ */
+export function printHelp(command) {
+    if (command && COMMAND_HELP[command]) {
+        process.stdout.write(COMMAND_HELP[command] + '\n');
+    }
+    else {
+        process.stdout.write(MAIN_HELP);
+    }
+}
+/**
+ * Print version.
+ */
+export function printVersion() {
+    process.stdout.write(`amux v${VERSION}\n`);
+}
+//# sourceMappingURL=help.js.map

package/dist/commands/help.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.js","sourceRoot":"","sources":["../../src/commands/help.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAE5C,SAAS,WAAW;IAClB,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QAC/C,OAAQ,OAAO,CAAC,oBAAoB,CAA0B,CAAC,OAAO,IAAI,OAAO,CAAC;IACpF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,OAAO,CAAC;IACjB,CAAC;AACH,CAAC;AAED,MAAM,OAAO,GAAG,WAAW,EAAE,CAAC;AAE9B,2BAA2B;AAC3B,MAAM,SAAS,GAAG,kCAAkC,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA0C1D,CAAC;AAEF,mCAAmC;AACnC,MAAM,YAAY,GAA2B;IAC3C,GAAG,EAAE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCN;IACC,QAAQ,EAAE;;;;;;;;;;;;;;CAcX;IACC,MAAM,EAAE;;;;;;;;;;;;;CAaT;IACC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;CAkBX;IACC,MAAM,EAAE;;;;;;;;;;;;;;;;;;CAkBT;IACC,QAAQ,EAAE;;;;;;;;;;;;;;;;;;CAkBX;IACC,IAAI,EAAE;;;;;;;;;;;;;CAaP;IACC,OAAO,EAAE;;;;;;;;;;;;;;;;;;CAkBV;IACC,MAAM,EAAE;;;;;;;;;;;;;;CAcT;IACC,MAAM,EAAE;;;;;;;;;;;;;CAaT;IACC,SAAS,EAAE;;;;CAIZ;IACC,aAAa,EAAE;;;;;;;;CAQhB;IACC,MAAM,EAAE;;;;;;;;;;;;;;;;;;;;;CAqBT;IACC,OAAO,EAAE;;;;;;;;;;;CAWV;IACC,KAAK,EAAE;;;;;;;;;;;;;;;;;;;;;CAqBR;IACC,MAAM,EAAE;;;;;;;;;;;;;CAaT;CACA,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,SAAS,CAAC,OAAgB;IACxC,IAAI,OAAO,IAAI,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;QACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IACrD,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,OAAO,IAAI,CAAC,CAAC;AAC7C,CAAC"}

package/dist/commands/hooks.d.ts

@@ -0,0 +1,17 @@
+/**
+ * `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 type { AgentMuxClient } from '@a5c-ai/agent-mux-core';
+import type { ParsedArgs } from '../parse-args.js';
+import type { FlagDef } from '../parse-args.js';
+export declare const HOOKS_FLAGS: Record<string, FlagDef>;
+export declare function hooksCommand(_client: AgentMuxClient, args: ParsedArgs): Promise<number>;
+//# sourceMappingURL=hooks.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../../src/commands/hooks.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAiC,MAAM,wBAAwB,CAAC;AAU5F,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGnD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAQhD,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAQ/C,CAAC;AAMF,wBAAsB,YAAY,CAChC,OAAO,EAAE,cAAc,EACvB,IAAI,EAAE,UAAU,GACf,OAAO,CAAC,MAAM,CAAC,CAiCjB"}