aquaman-coder 0.14.1 → 0.16.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,60 @@
1
+ /**
2
+ * Codex setup (v0.16.0): writes PreToolUse + PostToolUse hooks for the shell
3
+ * tool into `$CODEX_HOME/hooks.json` (default `~/.codex/hooks.json`).
4
+ *
5
+ * Verified against openai/codex main, 2026-09-23:
6
+ * - hooks.json is `{ "hooks": { "<Event>": [ { matcher, hooks: [handler] } ] } }`
7
+ * and Codex rejects unknown fields, so nothing else is written into it.
8
+ * - The shell tool's hook name is `Bash`; a bare word matcher is exact.
9
+ * - `timeout` is in seconds (default 600). Handlers must not be `async`,
10
+ * because async hooks cannot rewrite input.
11
+ * - A new or changed user hook does NOT run until trusted: Codex records
12
+ * `[hooks.state."<path>:<event>:<group>:<handler>"] trusted_hash` in
13
+ * config.toml after the user approves it in the startup hook review. We do
14
+ * not write that entry ourselves (the hash covers Codex's normalized form,
15
+ * which we would have to reproduce exactly), so setup tells the user to
16
+ * approve on the next launch, and doctor reports whether they have.
17
+ *
18
+ * Never overwrites unrelated entries. Atomic write via .tmp + rename.
19
+ */
20
+ type HookHandler = {
21
+ type: 'command';
22
+ command: string;
23
+ timeout?: number;
24
+ [k: string]: unknown;
25
+ };
26
+ type HookGroup = {
27
+ matcher?: string;
28
+ hooks: HookHandler[];
29
+ };
30
+ export interface CodexHooksFile {
31
+ hooks?: Record<string, HookGroup[]>;
32
+ [key: string]: unknown;
33
+ }
34
+ export declare const CODEX_HOOK_COMMAND = "aquaman coder hook --host codex";
35
+ export declare function codexHome(): string;
36
+ export declare function defaultCodexHooksPath(): string;
37
+ export interface CodexSetupOptions {
38
+ hooksPath?: string;
39
+ hookCommand?: string;
40
+ }
41
+ export interface CodexSetupResult {
42
+ path: string;
43
+ changed: boolean;
44
+ after: CodexHooksFile;
45
+ }
46
+ export declare function installCodexHooks(opts?: CodexSetupOptions): CodexSetupResult;
47
+ export declare function uninstallCodexHooks(opts?: CodexSetupOptions): CodexSetupResult;
48
+ export interface CodexHookStatus {
49
+ installed: boolean;
50
+ /**
51
+ * Codex has recorded a trust entry for our PreToolUse handler. `false` means
52
+ * the hook is installed but will not run until approved in Codex's startup
53
+ * review. A trust entry for an older version of the handler shows as
54
+ * trusted here but as "modified" in Codex; the review prompts again then.
55
+ */
56
+ trusted: boolean;
57
+ }
58
+ export declare function codexHookStatus(hooksPath?: string, configPath?: string): CodexHookStatus;
59
+ export {};
60
+ //# sourceMappingURL=setup.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../../src/adapters/codex/setup.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAMH,KAAK,WAAW,GAAG;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAA;CAAE,CAAC;AAChG,KAAK,SAAS,GAAG;IAAE,OAAO,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,WAAW,EAAE,CAAA;CAAE,CAAC;AAC5D,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,EAAE,CAAC,CAAC;IACpC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,eAAO,MAAM,kBAAkB,oCAAoC,CAAC;AAIpE,wBAAgB,SAAS,IAAI,MAAM,CAGlC;AAED,wBAAgB,qBAAqB,IAAI,MAAM,CAE9C;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,cAAc,CAAC;CACvB;AAoBD,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,iBAAsB,GAAG,gBAAgB,CAoBhF;AAED,wBAAgB,mBAAmB,CAAC,IAAI,GAAE,iBAAsB,GAAG,gBAAgB,CAmBlF;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB;;;;;OAKG;IACH,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,eAAe,CAC7B,SAAS,GAAE,MAAgC,EAC3C,UAAU,GAAE,MAA8C,GACzD,eAAe,CAmBjB"}
@@ -0,0 +1,116 @@
1
+ /**
2
+ * Codex setup (v0.16.0): writes PreToolUse + PostToolUse hooks for the shell
3
+ * tool into `$CODEX_HOME/hooks.json` (default `~/.codex/hooks.json`).
4
+ *
5
+ * Verified against openai/codex main, 2026-09-23:
6
+ * - hooks.json is `{ "hooks": { "<Event>": [ { matcher, hooks: [handler] } ] } }`
7
+ * and Codex rejects unknown fields, so nothing else is written into it.
8
+ * - The shell tool's hook name is `Bash`; a bare word matcher is exact.
9
+ * - `timeout` is in seconds (default 600). Handlers must not be `async`,
10
+ * because async hooks cannot rewrite input.
11
+ * - A new or changed user hook does NOT run until trusted: Codex records
12
+ * `[hooks.state."<path>:<event>:<group>:<handler>"] trusted_hash` in
13
+ * config.toml after the user approves it in the startup hook review. We do
14
+ * not write that entry ourselves (the hash covers Codex's normalized form,
15
+ * which we would have to reproduce exactly), so setup tells the user to
16
+ * approve on the next launch, and doctor reports whether they have.
17
+ *
18
+ * Never overwrites unrelated entries. Atomic write via .tmp + rename.
19
+ */
20
+ import * as fs from 'node:fs';
21
+ import * as os from 'node:os';
22
+ import * as path from 'node:path';
23
+ export const CODEX_HOOK_COMMAND = 'aquaman coder hook --host codex';
24
+ const HOOK_MARKS = ['aquaman coder hook', 'aquaman-coder hook'];
25
+ const EVENTS = ['PreToolUse', 'PostToolUse'];
26
+ export function codexHome() {
27
+ const env = process.env['CODEX_HOME'];
28
+ return env && env.length > 0 ? env : path.join(os.homedir(), '.codex');
29
+ }
30
+ export function defaultCodexHooksPath() {
31
+ return path.join(codexHome(), 'hooks.json');
32
+ }
33
+ const isOurs = (h) => HOOK_MARKS.some((m) => typeof h.command === 'string' && h.command.includes(m));
34
+ function readHooksFile(hooksPath) {
35
+ if (!fs.existsSync(hooksPath))
36
+ return null;
37
+ const raw = fs.readFileSync(hooksPath, 'utf-8');
38
+ try {
39
+ return JSON.parse(raw);
40
+ }
41
+ catch (err) {
42
+ throw new Error(`Existing ${hooksPath} is not valid JSON: ${err.message}`);
43
+ }
44
+ }
45
+ function writeHooksFile(hooksPath, data) {
46
+ const tmp = hooksPath + '.tmp';
47
+ fs.writeFileSync(tmp, JSON.stringify(data, null, 2) + '\n', { mode: 0o600 });
48
+ fs.renameSync(tmp, hooksPath);
49
+ }
50
+ export function installCodexHooks(opts = {}) {
51
+ const hooksPath = opts.hooksPath ?? defaultCodexHooksPath();
52
+ const hookCommand = opts.hookCommand ?? CODEX_HOOK_COMMAND;
53
+ const dir = path.dirname(hooksPath);
54
+ if (!fs.existsSync(dir))
55
+ fs.mkdirSync(dir, { recursive: true, mode: 0o700 });
56
+ const before = readHooksFile(hooksPath);
57
+ const data = before ? JSON.parse(JSON.stringify(before)) : {};
58
+ data.hooks = data.hooks ?? {};
59
+ for (const event of EVENTS) {
60
+ const list = data.hooks[event] ?? [];
61
+ if (list.some((g) => g.hooks?.some(isOurs)))
62
+ continue;
63
+ list.push({ matcher: 'Bash', hooks: [{ type: 'command', command: hookCommand, timeout: 30 }] });
64
+ data.hooks[event] = list;
65
+ }
66
+ const changed = JSON.stringify(before) !== JSON.stringify(data);
67
+ if (changed)
68
+ writeHooksFile(hooksPath, data);
69
+ return { path: hooksPath, changed, after: data };
70
+ }
71
+ export function uninstallCodexHooks(opts = {}) {
72
+ const hooksPath = opts.hooksPath ?? defaultCodexHooksPath();
73
+ const before = readHooksFile(hooksPath);
74
+ if (!before)
75
+ return { path: hooksPath, changed: false, after: {} };
76
+ const data = JSON.parse(JSON.stringify(before));
77
+ if (data.hooks) {
78
+ for (const event of Object.keys(data.hooks)) {
79
+ data.hooks[event] = data.hooks[event]
80
+ .map((g) => ({ ...g, hooks: g.hooks.filter((h) => !isOurs(h)) }))
81
+ .filter((g) => g.hooks.length > 0);
82
+ if (data.hooks[event].length === 0)
83
+ delete data.hooks[event];
84
+ }
85
+ if (Object.keys(data.hooks).length === 0)
86
+ delete data.hooks;
87
+ }
88
+ const changed = JSON.stringify(before) !== JSON.stringify(data);
89
+ if (changed)
90
+ writeHooksFile(hooksPath, data);
91
+ return { path: hooksPath, changed, after: data };
92
+ }
93
+ export function codexHookStatus(hooksPath = defaultCodexHooksPath(), configPath = path.join(codexHome(), 'config.toml')) {
94
+ let data = null;
95
+ try {
96
+ data = readHooksFile(hooksPath);
97
+ }
98
+ catch {
99
+ return { installed: false, trusted: false };
100
+ }
101
+ const groups = data?.hooks?.['PreToolUse'] ?? [];
102
+ let key = null;
103
+ groups.forEach((g, gi) => g.hooks?.forEach((h, hi) => {
104
+ if (key === null && isOurs(h))
105
+ key = `${hooksPath}:pre_tool_use:${gi}:${hi}`;
106
+ }));
107
+ if (key === null)
108
+ return { installed: false, trusted: false };
109
+ let config = '';
110
+ try {
111
+ config = fs.readFileSync(configPath, 'utf-8');
112
+ }
113
+ catch { /* no config.toml: nothing trusted yet */ }
114
+ return { installed: true, trusted: config.includes(`"${key}"`) };
115
+ }
116
+ //# sourceMappingURL=setup.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"setup.js","sourceRoot":"","sources":["../../../src/adapters/codex/setup.ts"],"names":[],"mappings":"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"}
@@ -4,6 +4,13 @@
4
4
  *
5
5
  * Wraps `POST /broker/resolve` with retry, timeout, and clean errors.
6
6
  */
7
+ /**
8
+ * aquaman's config dir, same rule as the proxy's getConfigDir(). Duplicated
9
+ * rather than imported from aquaman-proxy on purpose: this CLI is spawned
10
+ * from source (`npx tsx .../cli/index.ts`) in tests and dev, where the proxy's
11
+ * dist build may not exist yet, and a runtime import would fail there.
12
+ */
13
+ export declare function aquamanConfigDir(): string;
7
14
  export interface BrokerResolveOptions {
8
15
  service: string;
9
16
  key: string;
@@ -17,7 +24,29 @@ export interface BrokerClientOptions {
17
24
  socketPath?: string;
18
25
  timeoutMs?: number;
19
26
  }
27
+ /** Same socket the daemon binds: `<configDir>/proxy.sock` (honors AQUAMAN_CONFIG_DIR). */
20
28
  export declare function defaultSocketPath(): string;
29
+ /**
30
+ * A broker refusal or failure with the daemon's machine-readable `code`
31
+ * (v0.15.0+: `broker_disabled`, `broker_ref_not_declared`,
32
+ * `broker_ref_isolated`) and HTTP status, so callers can pick the right fix.
33
+ */
34
+ export declare class BrokerError extends Error {
35
+ readonly code?: string;
36
+ readonly status?: number;
37
+ readonly fix?: string;
38
+ constructor(message: string, opts?: {
39
+ code?: string;
40
+ status?: number;
41
+ fix?: string;
42
+ });
43
+ }
44
+ /**
45
+ * Claude Code's sandbox denies Unix-socket connects it hasn't allowlisted, and
46
+ * the kernel reports that as EPERM (macOS Seatbelt) or EACCES/EPERM (Linux
47
+ * seccomp). Say so instead of surfacing a bare errno.
48
+ */
49
+ export declare function sandboxSocketHint(socketPath: string): string;
21
50
  export declare class BrokerClient {
22
51
  private socketPath;
23
52
  private timeoutMs;
@@ -1 +1 @@
1
- {"version":3,"file":"broker-client.d.ts","sourceRoot":"","sources":["../src/broker-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;gBAEd,IAAI,GAAE,mBAAwB;IAK1C;;;OAGG;IACG,OAAO,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA+BvE;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAQ7D,OAAO,CAAC,OAAO;CA6ChB"}
1
+ {"version":3,"file":"broker-client.d.ts","sourceRoot":"","sources":["../src/broker-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;GAKG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAEzC;AAED,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB;IAClC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,0FAA0F;AAC1F,wBAAgB,iBAAiB,IAAI,MAAM,CAE1C;AAED;;;;GAIG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;gBAEV,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAA;KAAO;CAOzF;AAED;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAU5D;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,SAAS,CAAS;gBAEd,IAAI,GAAE,mBAAwB;IAK1C;;;OAGG;IACG,OAAO,CAAC,IAAI,EAAE,oBAAoB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IA+BvE;;OAEG;IACG,MAAM,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAQ7D,OAAO,CAAC,OAAO;CAgDhB"}
@@ -7,8 +7,49 @@
7
7
  import * as http from 'node:http';
8
8
  import * as os from 'node:os';
9
9
  import * as path from 'node:path';
10
+ /**
11
+ * aquaman's config dir, same rule as the proxy's getConfigDir(). Duplicated
12
+ * rather than imported from aquaman-proxy on purpose: this CLI is spawned
13
+ * from source (`npx tsx .../cli/index.ts`) in tests and dev, where the proxy's
14
+ * dist build may not exist yet, and a runtime import would fail there.
15
+ */
16
+ export function aquamanConfigDir() {
17
+ return process.env['AQUAMAN_CONFIG_DIR'] || path.join(os.homedir(), '.aquaman');
18
+ }
19
+ /** Same socket the daemon binds: `<configDir>/proxy.sock` (honors AQUAMAN_CONFIG_DIR). */
10
20
  export function defaultSocketPath() {
11
- return path.join(os.homedir(), '.aquaman', 'proxy.sock');
21
+ return path.join(aquamanConfigDir(), 'proxy.sock');
22
+ }
23
+ /**
24
+ * A broker refusal or failure with the daemon's machine-readable `code`
25
+ * (v0.15.0+: `broker_disabled`, `broker_ref_not_declared`,
26
+ * `broker_ref_isolated`) and HTTP status, so callers can pick the right fix.
27
+ */
28
+ export class BrokerError extends Error {
29
+ code;
30
+ status;
31
+ fix;
32
+ constructor(message, opts = {}) {
33
+ super(message);
34
+ this.name = 'BrokerError';
35
+ this.code = opts.code;
36
+ this.status = opts.status;
37
+ this.fix = opts.fix;
38
+ }
39
+ }
40
+ /**
41
+ * Claude Code's sandbox denies Unix-socket connects it hasn't allowlisted, and
42
+ * the kernel reports that as EPERM (macOS Seatbelt) or EACCES/EPERM (Linux
43
+ * seccomp). Say so instead of surfacing a bare errno.
44
+ */
45
+ export function sandboxSocketHint(socketPath) {
46
+ return (`Connecting to the aquaman proxy socket at ${socketPath} was blocked — most likely by ` +
47
+ `Claude Code's sandbox, which denies Unix sockets by default. On macOS run ` +
48
+ `\`aquaman coder setup claude-code\` (it allowlists this socket in sandbox.network.allowUnixSockets). ` +
49
+ `On Linux/WSL2 the sandbox can only allow it with sandbox.network.allowAllUnixSockets: true, ` +
50
+ `which opens every Unix socket to sandboxed commands. Under Codex, its sandbox blocks the ` +
51
+ `socket unless a permissions profile allows it (network.enabled = true plus ` +
52
+ `unix_sockets); run \`aquaman coder setup codex\` for the snippet.`);
12
53
  }
13
54
  export class BrokerClient {
14
55
  socketPath;
@@ -38,7 +79,7 @@ export class BrokerClient {
38
79
  if (statusCode >= 400) {
39
80
  const msg = json.error || `Broker error (HTTP ${statusCode})`;
40
81
  const fix = json.fix ? ` — ${json.fix}` : '';
41
- throw new Error(`${msg}${fix}`);
82
+ throw new BrokerError(`${msg}${fix}`, { code: json.code, status: statusCode, fix: json.fix });
42
83
  }
43
84
  if (typeof json.value !== 'string' || typeof json.expires_at !== 'string') {
44
85
  throw new Error('Broker response missing value / expires_at');
@@ -74,8 +115,11 @@ export class BrokerClient {
74
115
  });
75
116
  req.on('error', (err) => {
76
117
  if (err.code === 'ENOENT' || err.code === 'ECONNREFUSED') {
77
- reject(new Error(`Cannot reach aquaman proxy at ${this.socketPath}. ` +
78
- `Start it with: aquaman daemon`));
118
+ reject(new BrokerError(`Cannot reach aquaman proxy at ${this.socketPath}. ` +
119
+ `Start it with: aquaman daemon`, { code: 'proxy_unreachable' }));
120
+ }
121
+ else if (err.code === 'EPERM' || err.code === 'EACCES') {
122
+ reject(new BrokerError(sandboxSocketHint(this.socketPath), { code: 'socket_blocked' }));
79
123
  }
80
124
  else {
81
125
  reject(err);
@@ -1 +1 @@
1
- {"version":3,"file":"broker-client.js","sourceRoot":"","sources":["../src/broker-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAkBlC,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,EAAE,YAAY,CAAC,CAAC;AAC3D,CAAC;AAED,MAAM,OAAO,YAAY;IACf,UAAU,CAAS;IACnB,SAAS,CAAS;IAE1B,YAAY,OAA4B,EAAE;QACxC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,iBAAiB,EAAE,CAAC;QACzD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,IAA0B;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;YAC1B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,WAAW,EAAE,IAAI,CAAC,UAAU;SAC7B,CAAC,CAAC;QAEH,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,CAAC,CAAC;QAEpF,IAAI,IAAS,CAAC;QACd,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,6CAA6C,UAAU,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CACrF,CAAC;QACJ,CAAC;QAED,IAAI,UAAU,IAAI,GAAG,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,IAAI,sBAAsB,UAAU,GAAG,CAAC;YAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,GAAG,GAAG,GAAG,GAAG,EAAE,CAAC,CAAC;QAClC,CAAC;QAED,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YAC1E,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM;QACV,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACtE,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,mCAAmC,UAAU,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAEO,OAAO,CACb,MAAsB,EACtB,OAAe,EACf,IAAa;QAEb,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CACtB;gBACE,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,IAAI,EAAE,OAAO;gBACb,MAAM;gBACN,OAAO,EAAE,IAAI;oBACX,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE;oBACnF,CAAC,CAAC,SAAS;gBACb,OAAO,EAAE,IAAI,CAAC,SAAS;aACxB,EACD,CAAC,GAAG,EAAE,EAAE;gBACN,IAAI,MAAM,GAAG,EAAE,CAAC;gBAChB,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAChD,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;oBACjB,OAAO,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;gBAChE,CAAC,CAAC,CAAC;YACL,CAAC,CACF,CAAC;YAEF,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAA0B,EAAE,EAAE;gBAC7C,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;oBACzD,MAAM,CAAC,IAAI,KAAK,CACd,iCAAiC,IAAI,CAAC,UAAU,IAAI;wBACpD,+BAA+B,CAChC,CAAC,CAAC;gBACL,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;gBACrB,GAAG,CAAC,OAAO,EAAE,CAAC;gBACd,MAAM,CAAC,IAAI,KAAK,CAAC,kCAAkC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC;YAC1E,CAAC,CAAC,CAAC;YAEH,IAAI,IAAI;gBAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1B,GAAG,CAAC,GAAG,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}
1
+ {"version":3,"file":"broker-client.js","sourceRoot":"","sources":["../src/broker-client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,EAAE,MAAM,SAAS,CAAC;AAC9B,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAElC;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AAClF,CAAC;AAkBD,0FAA0F;AAC1F,MAAM,UAAU,iBAAiB;IAC/B,OAAO,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,YAAY,CAAC,CAAC;AACrD,CAAC;AAED;;;;GAIG;AACH,MAAM,OAAO,WAAY,SAAQ,KAAK;IAC3B,IAAI,CAAU;IACd,MAAM,CAAU;IAChB,GAAG,CAAU;IAEtB,YAAY,OAAe,EAAE,OAAyD,EAAE;QACtF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IACtB,CAAC;CACF;AAED;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,UAAkB;IAClD,OAAO,CACL,6CAA6C,UAAU,gCAAgC;QACvF,4EAA4E;QAC5E,uGAAuG;QACvG,8FAA8F;QAC9F,2FAA2F;QAC3F,6EAA6E;QAC7E,mEAAmE,CACpE,CAAC;AACJ,CAAC;AAED,MAAM,OAAO,YAAY;IACf,UAAU,CAAS;IACnB,SAAS,CAAS;IAE1B,YAAY,OAA4B,EAAE;QACxC,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,iBAAiB,EAAE,CAAC;QACzD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,IAA0B;QACtC,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC;YAC1B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,WAAW,EAAE,IAAI,CAAC,UAAU;SAC7B,CAAC,CAAC;QAEH,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,iBAAiB,EAAE,IAAI,CAAC,CAAC;QAEpF,IAAI,IAAS,CAAC;QACd,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CACb,6CAA6C,UAAU,MAAM,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CACrF,CAAC;QACJ,CAAC;QAED,IAAI,UAAU,IAAI,GAAG,EAAE,CAAC;YACtB,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,IAAI,sBAAsB,UAAU,GAAG,CAAC;YAC9D,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7C,MAAM,IAAI,WAAW,CAAC,GAAG,GAAG,GAAG,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAChG,CAAC;QAED,IAAI,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;YAC1E,MAAM,IAAI,KAAK,CAAC,4CAA4C,CAAC,CAAC;QAChE,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;IAC3D,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,MAAM;QACV,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;QACtE,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,mCAAmC,UAAU,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAC7B,CAAC;IAEO,OAAO,CACb,MAAsB,EACtB,OAAe,EACf,IAAa;QAEb,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;YACrC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CACtB;gBACE,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,IAAI,EAAE,OAAO;gBACb,MAAM;gBACN,OAAO,EAAE,IAAI;oBACX,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE;oBACnF,CAAC,CAAC,SAAS;gBACb,OAAO,EAAE,IAAI,CAAC,SAAS;aACxB,EACD,CAAC,GAAG,EAAE,EAAE;gBACN,IAAI,MAAM,GAAG,EAAE,CAAC;gBAChB,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE,GAAG,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;gBAChD,GAAG,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;oBACjB,OAAO,CAAC,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,IAAI,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;gBAChE,CAAC,CAAC,CAAC;YACL,CAAC,CACF,CAAC;YAEF,GAAG,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAA0B,EAAE,EAAE;gBAC7C,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,GAAG,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;oBACzD,MAAM,CAAC,IAAI,WAAW,CACpB,iCAAiC,IAAI,CAAC,UAAU,IAAI;wBACpD,+BAA+B,EAC/B,EAAE,IAAI,EAAE,mBAAmB,EAAE,CAC9B,CAAC,CAAC;gBACL,CAAC;qBAAM,IAAI,GAAG,CAAC,IAAI,KAAK,OAAO,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBACzD,MAAM,CAAC,IAAI,WAAW,CAAC,iBAAiB,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE,EAAE,IAAI,EAAE,gBAAgB,EAAE,CAAC,CAAC,CAAC;gBAC1F,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,GAAG,CAAC,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,CAAC;YAEH,GAAG,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;gBACrB,GAAG,CAAC,OAAO,EAAE,CAAC;gBACd,MAAM,CAAC,IAAI,KAAK,CAAC,kCAAkC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,CAAC;YAC1E,CAAC,CAAC,CAAC;YAEH,IAAI,IAAI;gBAAE,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAC1B,GAAG,CAAC,GAAG,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC;CACF"}
@@ -4,13 +4,12 @@
4
4
  *
5
5
  * Subcommands:
6
6
  * setup <agent> Install hook configuration for a coding agent
7
- * (currently: claude-code; codex/opencode/cursor planned)
7
+ * (claude-code, codex)
8
8
  * project list List configured projects
9
9
  * project add Add a project (interactive or flags)
10
10
  * project remove Remove a project
11
- * get <ref> Resolve an aquaman:// ref via the broker and print
12
11
  * exec <cmd...> Run a command with the matching project env injected
13
- * hook Stdio hook handler (invoked by Claude Code)
12
+ * hook Stdio hook handler (invoked by Claude Code or Codex)
14
13
  * doctor Diagnostics
15
14
  */
16
15
  export {};
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;GAaG"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;GAYG"}