@cogitator-ai/cli 0.19.1 → 0.21.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.
package/README.md CHANGED
@@ -59,7 +59,7 @@ cogitator run -m ollama/llama3.1:8b "What is the capital of France?"
59
59
  | `cogitator acp` | Serve a Cogitator coding agent to an editor over the Agent Client Protocol (stdio) |
60
60
  | `cogitator build` | Bundle a gateway into a self-starting `dist/cogitator.mjs` |
61
61
  | `cogitator daemon <cmd>` | Run in the background / install as a launchd or systemd service |
62
- | `cogitator bridge <cmd>` | Run and watch the agent bridge between harnesses (experimental) |
62
+ | `cogitator bridge <cmd>` | Run and watch the agent bridge between harnesses, and call it from a session (experimental) |
63
63
  | `cogitator skill <cmd>` | Create, validate, install and remove skills |
64
64
  | `cogitator models` | List or pull Ollama models |
65
65
  | `cogitator status` | Show Docker Compose and Ollama status (alias: `ps`) |
@@ -75,7 +75,7 @@ Every command ends with examples in its `--help`.
75
75
 
76
76
  ### Output and exit codes
77
77
 
78
- Every command exits with `0` when it did what was asked, `1` when it could not (a failed check, deploy or install, a missing service) and `2` when the command line is wrong (an unknown option, command or value, with the closest valid name). Failures print the message and what to do about it on stderr; `COGITATOR_DEBUG=1` adds the stack trace. With `--json` (`add`, `doctor`, `eval`, `models`, `status`, `deploy`, `bridge status`, `bridge log`) the result goes to stdout as JSON, and a failure as `{ "ok": false, "error": { "message", "exitCode", "hints" } }`.
78
+ Every command exits with `0` when it did what was asked, `1` when it could not (a failed check, deploy or install, a missing service) and `2` when the command line is wrong (an unknown option, command or value, with the closest valid name). Failures print the message and what to do about it on stderr, `COGITATOR_DEBUG=1` adds the stack trace. With `--json` (`add`, `doctor`, `eval`, `models`, `status`, `deploy`, `bridge status`, `bridge log`, `bridge doctor`, `bridge delegate`, `bridge send`, `bridge inbox`) the result goes to stdout as JSON, and a failure as `{ "ok": false, "error": { "message", "exitCode", "hints" } }`.
79
79
 
80
80
  ---
81
81
 
@@ -381,6 +381,8 @@ The PID file (`.cogitator/daemon.pid`) records the launched script, so `stop` ne
381
381
  The agent bridge (experimental): Claude Code, Codex and other agents hand each other jobs, ask questions on the way and report back, each in its own window. The bridge is a dispatcher, one per machine, shared by every project. See [`@cogitator-ai/bridge`](https://www.npmjs.com/package/@cogitator-ai/bridge).
382
382
 
383
383
  ```bash
384
+ cogitator bridge install [harness] # give Claude Code and Codex the bridge in this project
385
+ cogitator bridge uninstall [harness] # take out what install put in
384
386
  cogitator bridge serve # the dispatcher in the foreground, until Ctrl+C
385
387
  cogitator bridge status [--json] # the dispatcher, the sessions it knows, the jobs in progress
386
388
  cogitator bridge log # the last 50 entries of the journal
@@ -388,12 +390,35 @@ cogitator bridge log --follow # keep printing what comes in
388
390
  cogitator bridge log --job 12 # everything about one job
389
391
  cogitator bridge log --all # the whole journal
390
392
  cogitator bridge log --json # one line of JSON per entry
393
+ cogitator bridge doctor [--json] # whether Claude Code and Codex can be reached, and what to fix
391
394
  ```
392
395
 
393
- `serve` refuses to start while another dispatcher runs and names its PID. `status` exits 0 when a dispatcher runs and 1 when none does. `log` reads the store itself, so it works after the dispatcher stopped, and prints what agents wrote on one line each without control characters. The files live in `~/.cogitator/bridge` (`bridge.db`, `bridge.sock`), `COGITATOR_BRIDGE_HOME` or `--home <dir>` moves them.
396
+ `serve` reaches Claude Code and Codex sessions through their own commands: it starts a session for a job (`claude --bg`, `codex exec`), hands letters to Codex threads (`codex queue`) and answers the hooks of Claude Code sessions that wait for mail. With `--home <dir>` the sessions it starts are told that folder, so they call this dispatcher. A hook runs the command line the way `serve` itself was run, by absolute paths, so it does not depend on the `PATH` of a session. `COGITATOR_BRIDGE_COMMAND` names another way, such as `cogitator bridge`. The sessions it starts get the bridge's tools with them, so they ask, answer and report whatever their sandbox. A Codex thread it starts works in the `workspace-write` sandbox, which keeps its shell commands from the bridge's socket and its tools from nothing, and a thread whose turn ends without a report gets its final answer taken as one. `--codex-sandbox <mode>` or `COGITATOR_BRIDGE_CODEX_SANDBOX` names another sandbox (`read-only`, `danger-full-access`) for what the thread itself may do: `danger-full-access` holds nothing back. What a Codex thread it started prints is kept in `sessions/` of the bridge's folder. It refuses to start while another dispatcher runs and names its PID. `status` exits 0 when a dispatcher runs and 1 when none does. `log` reads the store itself, so it works after the dispatcher stopped, and prints what agents wrote on one line each without control characters. The files live in `~/.cogitator/bridge` (`bridge.db`, `bridge.sock`), `COGITATOR_BRIDGE_HOME` or `--home <dir>` moves them.
394
397
 
395
398
  With `cogitator daemon start --bridge` the assistant daemon hosts the dispatcher, so no second process is needed.
396
399
 
400
+ `doctor` checks the dispatcher, then each harness: its version, the commands the bridge needs from it, whether Claude Code trusts the folder (`--cwd <dir>`, the current one by default), whether sessions opened in it carry the wake hook and have the bridge's tools, whether a hook tells the tools which session calls, and whether Codex's local daemon runs. Every finding that is not fine comes with what to do. It exits 1 when something the bridge needs is missing, 0 when at most warnings are left.
401
+
402
+ `install` sets the harnesses up for the sessions you open: `claude`, `codex`, or both when none is named, leaving out one that is not installed. It lists every change, asks once, and makes them: the server of tools (`claude mcp add --scope local`, `codex mcp add`), for Claude Code the hooks and the rule for the tools in the project's `.claude/settings.local.json`, and the notes in `CLAUDE.md` and `AGENTS.md`. `--dry-run` only lists, `-y` does not ask, and without a terminal nothing is changed unless `-y` is there. `--user` sets every project of yours up, `--take-jobs` lets sessions carry out the jobs of other agents without asking you first, `--no-notes` leaves the instructions files alone and `--no-allow` keeps Claude Code's permission prompt for the bridge tools. `--cwd <dir>` names another project, `--json` prints the changes. Running it again changes only what is out of date. `uninstall` takes the same out again, and leaves Codex its server unless `--user` is there, since Codex keeps its servers for every project.
403
+
404
+ A session with the tools needs no command line. One without them, and you at a terminal inside one, calls the bridge from a shell, known by the id its harness put into the environment (`CLAUDE_CODE_SESSION_ID`, `CODEX_THREAD_ID`):
405
+
406
+ ```bash
407
+ cogitator bridge delegate <to> [text...] # hand a job over: --title, --cwd, --check <command>, --parent <job>
408
+ cogitator bridge send [text...] --job <n> --kind <question|answer|report|note|permission>
409
+ cogitator bridge inbox # the letters that wait: --job <n>, --peek, --unhandled
410
+ cogitator bridge cancel <job> [reason...] # take back a job this session handed over
411
+ cogitator bridge wait # wait for mail and exit with 2 when it comes
412
+ cogitator bridge mcp # serve the bridge tools over MCP (stdio)
413
+ cogitator bridge caller --hook claude-code # tell the tools which session calls
414
+ ```
415
+
416
+ `delegate` prints the number of the job and returns at once, the answer arrives as a letter. `<to>` is `codex`, `claude`, the name of an agent, or `codex:new` for a fresh session. The text of `delegate` and `send` is the arguments, or stdin when there are none or they are `-`. A text that starts with a dash goes after `--`. `send --kind report --failed` reports a job that could not be done, `--reply-to <letter>` names the letter an answer is for. All three take `--json`.
417
+
418
+ `wait` is what the wake hook of a Claude Code session runs: it waits for the mail of the session (`--timeout <seconds>`, 600 by default), and when a letter comes writes it to stderr and exits with code 2, which makes Claude Code wake the session with it. With `--hook claude-code` it takes the session from what Claude Code wrote to the hook's stdin, and `--agent <name>` is the name the bridge gave a session it started. Under the letters it adds one line saying how to answer through the bridge: with the tools when `--tools` says the session has them, with the command line otherwise. Without mail it exits with 0 and prints nothing. A failure, a mistyped option included, exits with 1 and never with 2, so an error cannot wake a session. See the [`@cogitator-ai/bridge`](https://www.npmjs.com/package/@cogitator-ai/bridge#claude-code-and-codex) for the hook itself.
419
+
420
+ `mcp` is the server of the bridge's tools, started by a harness for a session, not by you: `delegate`, `ask`, `answer`, `report`, `note`, `inbox`, `job`, `jobs`, `cancel` and `agents`. It connects to the dispatcher for each call, so it may start before the dispatcher does. `caller` is the hook Claude Code runs before a call of one of these tools: it adds the session to the arguments of the call, since Claude Code keeps one server across `/clear`. It never exits with 2, which Claude Code would read as a refusal of the tool call. A folder of the bridge that is not the default one (`--home`, `COGITATOR_BRIDGE_HOME`) is written into the command of the server and of the hooks, since a harness does not always hand its environment on.
421
+
397
422
  ---
398
423
 
399
424
  ### cogitator rewind
@@ -0,0 +1,53 @@
1
+ /**
2
+ * cogitator bridge install | uninstall - give the sessions a person opens in Claude Code and
3
+ * Codex the bridge, and take it away again
4
+ */
5
+ import { type AdapterSetup } from '@cogitator-ai/bridge';
6
+ import { type InstallTarget } from '../utils/bridge-adapters.js';
7
+ /** How the commands talk to the person */
8
+ export interface BridgeInstallIo {
9
+ print(line: string): void;
10
+ /** Asks a yes or no question. Undefined when nobody is there to answer */
11
+ confirm(question: string): Promise<boolean | undefined>;
12
+ }
13
+ /** What the commands work with */
14
+ export interface BridgeInstallContext {
15
+ io: BridgeInstallIo;
16
+ env: NodeJS.ProcessEnv;
17
+ cwd: string;
18
+ /** How each harness is set up, those of this command line by default */
19
+ setups?: Partial<Record<InstallTarget, AdapterSetup>>;
20
+ }
21
+ interface SharedFlags {
22
+ home?: string;
23
+ /** The project to set up, the one the current folder is in by default */
24
+ cwd?: string;
25
+ /** For every project of this person, not for this one only */
26
+ user?: boolean;
27
+ dryRun?: boolean;
28
+ yes?: boolean;
29
+ json?: boolean;
30
+ }
31
+ export interface BridgeInstallFlags extends SharedFlags {
32
+ /** False with `--no-notes`: the instructions files stay as they are */
33
+ notes?: boolean;
34
+ /** False with `--no-allow`: Claude Code goes on asking before a session calls a bridge tool */
35
+ allow?: boolean;
36
+ /** Sessions carry out the jobs of other agents without asking the person first */
37
+ takeJobs?: boolean;
38
+ }
39
+ export type BridgeUninstallFlags = SharedFlags;
40
+ /** `all` or one of the harnesses, as the command line names them. */
41
+ export declare const INSTALL_CHOICES: readonly ["claude", "codex", "all"];
42
+ /**
43
+ * cogitator bridge install [claude|codex|all]: gives the sessions a person opens the bridge.
44
+ * Every change is listed first and made only after a yes.
45
+ */
46
+ export declare function runBridgeInstall(target: string | undefined, flags: BridgeInstallFlags, context?: BridgeInstallContext): Promise<number>;
47
+ /**
48
+ * cogitator bridge uninstall [claude|codex|all]: takes out what `install` put in, and nothing
49
+ * else. Every change is listed first and made only after a yes.
50
+ */
51
+ export declare function runBridgeUninstall(target: string | undefined, flags: BridgeUninstallFlags, context?: BridgeInstallContext): Promise<number>;
52
+ export {};
53
+ //# sourceMappingURL=bridge-install.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bridge-install.d.ts","sourceRoot":"","sources":["../../src/commands/bridge-install.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,OAAO,EAKL,KAAK,YAAY,EAGlB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAIL,KAAK,aAAa,EACnB,MAAM,6BAA6B,CAAC;AAGrC,0CAA0C;AAC1C,MAAM,WAAW,eAAe;IAC9B,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,0EAA0E;IAC1E,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,SAAS,CAAC,CAAC;CACzD;AAED,kCAAkC;AAClC,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,eAAe,CAAC;IACpB,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,wEAAwE;IACxE,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC;CACvD;AAyBD,UAAU,WAAW;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,yEAAyE;IACzE,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,kBAAmB,SAAQ,WAAW;IACrD,uEAAuE;IACvE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,+FAA+F;IAC/F,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kFAAkF;IAClF,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,oBAAoB,GAAG,WAAW,CAAC;AAE/C,qEAAqE;AACrE,eAAO,MAAM,eAAe,qCAAuC,CAAC;AAmJpE;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,kBAAkB,EACzB,OAAO,GAAE,oBAAuC,GAC/C,OAAO,CAAC,MAAM,CAAC,CAoDjB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,GAAG,SAAS,EAC1B,KAAK,EAAE,oBAAoB,EAC3B,OAAO,GAAE,oBAAuC,GAC/C,OAAO,CAAC,MAAM,CAAC,CAsCjB"}
@@ -0,0 +1,239 @@
1
+ /**
2
+ * cogitator bridge install | uninstall - give the sessions a person opens in Claude Code and
3
+ * Codex the bridge, and take it away again
4
+ */
5
+ import chalk from 'chalk';
6
+ import { resolve } from 'node:path';
7
+ import { createInterface } from 'node:readline/promises';
8
+ import { BridgeClient, CommandMissingError, bridgePaths, findCheckoutRoot, } from '@cogitator-ai/bridge';
9
+ import { INSTALL_LABELS, INSTALL_TARGETS, bridgeSetups, } from '../utils/bridge-adapters.js';
10
+ import { CommandError, UsageError, printJson, reportFailure } from '../utils/cli.js';
11
+ /** Prompts on the terminal, undefined when stdin is not one */
12
+ function terminalIo() {
13
+ return {
14
+ print: (line) => console.log(line),
15
+ confirm: async (question) => {
16
+ if (!process.stdin.isTTY)
17
+ return undefined;
18
+ const prompt = createInterface({ input: process.stdin, output: process.stdout });
19
+ try {
20
+ const answer = await prompt.question(`${question} [y/N] `);
21
+ return /^y(es)?$/i.test(answer.trim());
22
+ }
23
+ finally {
24
+ prompt.close();
25
+ }
26
+ },
27
+ };
28
+ }
29
+ const defaultContext = () => ({
30
+ io: terminalIo(),
31
+ env: process.env,
32
+ cwd: process.cwd(),
33
+ });
34
+ /** `all` or one of the harnesses, as the command line names them. */
35
+ export const INSTALL_CHOICES = [...INSTALL_TARGETS, 'all'];
36
+ function targetsOf(target) {
37
+ if (target === undefined || target === 'all')
38
+ return [...INSTALL_TARGETS];
39
+ const found = INSTALL_TARGETS.find((known) => known === target);
40
+ if (found)
41
+ return [found];
42
+ throw new UsageError(`"${target}" is not a harness the bridge sets up`, [
43
+ `Use one of: ${INSTALL_CHOICES.join(', ')}`,
44
+ ]);
45
+ }
46
+ /**
47
+ * Asks each harness for its steps. A harness that is not installed is left out when every
48
+ * harness was asked for, and is a failure when it was named.
49
+ */
50
+ async function planFor(targets, named, steps, setups) {
51
+ const plan = { planned: [], missing: [] };
52
+ for (const target of targets) {
53
+ const setup = setups[target];
54
+ if (!setup)
55
+ continue;
56
+ try {
57
+ plan.planned.push({ target, steps: await steps(setup) });
58
+ }
59
+ catch (error) {
60
+ if (!(error instanceof CommandMissingError))
61
+ throw error;
62
+ if (named) {
63
+ throw new CommandError(`${INSTALL_LABELS[target]} is not installed: ${error.message}`);
64
+ }
65
+ plan.missing.push(target);
66
+ }
67
+ }
68
+ return plan;
69
+ }
70
+ function show(plan, io) {
71
+ let number = 0;
72
+ for (const { target, steps } of plan.planned) {
73
+ io.print(chalk.bold(INSTALL_LABELS[target]));
74
+ if (steps.length === 0)
75
+ io.print(chalk.dim(' nothing to change'));
76
+ for (const step of steps) {
77
+ number += 1;
78
+ io.print(` ${number}. ${step.title}`);
79
+ for (const line of step.lines)
80
+ io.print(chalk.dim(` ${line}`));
81
+ }
82
+ }
83
+ for (const target of plan.missing) {
84
+ io.print(chalk.bold(INSTALL_LABELS[target]));
85
+ io.print(chalk.dim(' not installed on this machine, left out'));
86
+ }
87
+ }
88
+ function asJson(plan, applied) {
89
+ return {
90
+ applied,
91
+ changes: plan.planned.flatMap(({ target, steps }) => steps.map((step) => ({ harness: target, title: step.title, lines: step.lines }))),
92
+ missing: plan.missing,
93
+ };
94
+ }
95
+ /**
96
+ * Shows the plan, asks, and makes the changes one after another. Returns whether they were made.
97
+ *
98
+ * @throws CommandError when a step fails, naming it and how many were made before it
99
+ */
100
+ async function carryOut(plan, flags, question, io) {
101
+ const steps = plan.planned.flatMap(({ steps: own }) => own);
102
+ if (!flags.json)
103
+ show(plan, io);
104
+ if (steps.length === 0 || flags.dryRun)
105
+ return false;
106
+ if (!flags.yes) {
107
+ if (flags.json) {
108
+ throw new UsageError('With --json nothing is asked', [
109
+ 'Add --yes to make the changes, or --dry-run to list them',
110
+ ]);
111
+ }
112
+ const answer = await io.confirm(question.replace('%d', String(steps.length)));
113
+ if (answer === undefined) {
114
+ throw new CommandError('Nothing was changed: nobody is here to confirm', {
115
+ hints: ['Run it again with --yes'],
116
+ });
117
+ }
118
+ if (!answer) {
119
+ io.print('Nothing was changed');
120
+ return false;
121
+ }
122
+ }
123
+ for (const [index, step] of steps.entries()) {
124
+ try {
125
+ await step.apply();
126
+ }
127
+ catch (error) {
128
+ throw new CommandError(`"${step.title}" failed: ${error instanceof Error ? error.message : String(error)}`, {
129
+ hints: [
130
+ index === 0
131
+ ? 'Nothing was changed before it'
132
+ : `The ${index} change${index === 1 ? '' : 's'} before it ${index === 1 ? 'was' : 'were'} made. Running the command again goes on from here`,
133
+ ],
134
+ cause: error,
135
+ });
136
+ }
137
+ }
138
+ return true;
139
+ }
140
+ function contextOf(flags, context) {
141
+ return {
142
+ project: findCheckoutRoot(resolve(context.cwd, flags.cwd ?? '.')),
143
+ scope: flags.user ? 'user' : 'project',
144
+ };
145
+ }
146
+ async function dispatcherRuns(flags, env) {
147
+ try {
148
+ const client = await BridgeClient.connect({
149
+ socketPath: bridgePaths({ ...(flags.home && { home: flags.home }), env }).socket,
150
+ timeoutMs: 3_000,
151
+ });
152
+ await client.close();
153
+ return true;
154
+ }
155
+ catch {
156
+ return false;
157
+ }
158
+ }
159
+ /**
160
+ * cogitator bridge install [claude|codex|all]: gives the sessions a person opens the bridge.
161
+ * Every change is listed first and made only after a yes.
162
+ */
163
+ export async function runBridgeInstall(target, flags, context = defaultContext()) {
164
+ try {
165
+ const setups = context.setups ?? bridgeSetups(context.env, { ...(flags.home && { home: flags.home }) });
166
+ const where = contextOf(flags, context);
167
+ const plan = await planFor(targetsOf(target), target !== undefined && target !== 'all', (setup) => setup.install({
168
+ ...where,
169
+ notes: flags.notes !== false,
170
+ takeJobs: flags.takeJobs === true,
171
+ allowTools: flags.allow !== false,
172
+ }), setups);
173
+ if (plan.planned.length === 0) {
174
+ throw new CommandError('Neither Claude Code nor Codex is installed on this machine');
175
+ }
176
+ if (!flags.json) {
177
+ context.io.print(where.scope === 'user'
178
+ ? 'Setting up the agent bridge for every project of yours'
179
+ : `Setting up the agent bridge for the project ${where.project}`);
180
+ }
181
+ const applied = await carryOut(plan, flags, 'Make these %d changes?', context.io);
182
+ if (flags.json) {
183
+ printJson(asJson(plan, applied));
184
+ return 0;
185
+ }
186
+ const changes = plan.planned.reduce((count, { steps }) => count + steps.length, 0);
187
+ if (changes === 0)
188
+ context.io.print(chalk.green('Everything is in place already'));
189
+ if (flags.dryRun || (changes > 0 && !applied))
190
+ return 0;
191
+ if (applied)
192
+ context.io.print(chalk.green(`Done: ${changes} change${changes === 1 ? '' : 's'}`));
193
+ if (!(await dispatcherRuns(flags, context.env))) {
194
+ context.io.print(chalk.dim(' No dispatcher runs yet. Start the one of this machine: cogitator bridge serve'));
195
+ }
196
+ if (applied) {
197
+ context.io.print(chalk.dim(' Sessions that are open now get the tools when they are started again'));
198
+ }
199
+ context.io.print(chalk.dim(' Check the setup: cogitator bridge doctor'));
200
+ return 0;
201
+ }
202
+ catch (error) {
203
+ return reportFailure(error, { json: flags.json ?? false });
204
+ }
205
+ }
206
+ /**
207
+ * cogitator bridge uninstall [claude|codex|all]: takes out what `install` put in, and nothing
208
+ * else. Every change is listed first and made only after a yes.
209
+ */
210
+ export async function runBridgeUninstall(target, flags, context = defaultContext()) {
211
+ try {
212
+ const setups = context.setups ?? bridgeSetups(context.env, { ...(flags.home && { home: flags.home }) });
213
+ const where = contextOf(flags, context);
214
+ const plan = await planFor(targetsOf(target), target !== undefined && target !== 'all', (setup) => setup.uninstall(where), setups);
215
+ if (!flags.json) {
216
+ context.io.print(where.scope === 'user'
217
+ ? 'Taking the agent bridge out of every project of yours'
218
+ : `Taking the agent bridge out of the project ${where.project}`);
219
+ }
220
+ const applied = await carryOut(plan, flags, 'Make these %d changes?', context.io);
221
+ if (flags.json) {
222
+ printJson(asJson(plan, applied));
223
+ return 0;
224
+ }
225
+ const changes = plan.planned.reduce((count, { steps }) => count + steps.length, 0);
226
+ if (changes === 0)
227
+ context.io.print(chalk.green('Nothing of the bridge is set up here'));
228
+ if (applied)
229
+ context.io.print(chalk.green(`Done: ${changes} change${changes === 1 ? '' : 's'}`));
230
+ if (where.scope === 'project' && plan.planned.some(({ target: name }) => name === 'codex')) {
231
+ context.io.print(chalk.dim(' Codex keeps its servers for every project: its server of tools goes with cogitator bridge uninstall codex --user'));
232
+ }
233
+ return 0;
234
+ }
235
+ catch (error) {
236
+ return reportFailure(error, { json: flags.json ?? false });
237
+ }
238
+ }
239
+ //# sourceMappingURL=bridge-install.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bridge-install.js","sourceRoot":"","sources":["../../src/commands/bridge-install.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,93 @@
1
+ /**
2
+ * cogitator bridge delegate | send | inbox | wait | doctor - the bridge as a session and a
3
+ * person at a terminal use it
4
+ */
5
+ import { type BridgeAdapter, type LetterKind } from '@cogitator-ai/bridge';
6
+ /** What the session commands work with */
7
+ export interface BridgeSessionContext {
8
+ print(line: string): void;
9
+ /** Where a waiter writes the mail: its harness reads it from the hook's stderr */
10
+ wake(text: string): void;
11
+ env: NodeJS.ProcessEnv;
12
+ cwd: string;
13
+ /** What is piped into the command, undefined at a terminal */
14
+ stdin(): Promise<string | undefined>;
15
+ /** The adapters that tell sessions apart and check their harnesses */
16
+ adapters?: readonly BridgeAdapter[];
17
+ signal?: AbortSignal;
18
+ }
19
+ interface HomeFlags {
20
+ home?: string;
21
+ }
22
+ export interface BridgeDelegateFlags extends HomeFlags {
23
+ title?: string;
24
+ cwd?: string;
25
+ check?: string[];
26
+ parent?: number;
27
+ json?: boolean;
28
+ }
29
+ /** cogitator bridge delegate <to> <text>: hands a job over and prints its number at once. */
30
+ export declare function runBridgeDelegate(to: string, words: readonly string[], flags: BridgeDelegateFlags, context?: BridgeSessionContext): Promise<number>;
31
+ export declare const SENDABLE_KINDS: readonly ["question", "answer", "report", "note", "permission"];
32
+ export interface BridgeSendFlags extends HomeFlags {
33
+ job: number;
34
+ kind: Exclude<LetterKind, 'task'>;
35
+ failed?: boolean;
36
+ replyTo?: string;
37
+ json?: boolean;
38
+ }
39
+ /** cogitator bridge send --job N --kind K <text>: a letter on a job that exists. */
40
+ export declare function runBridgeSend(words: readonly string[], flags: BridgeSendFlags, context?: BridgeSessionContext): Promise<number>;
41
+ export interface BridgeInboxFlags extends HomeFlags {
42
+ job?: number;
43
+ peek?: boolean;
44
+ unhandled?: boolean;
45
+ json?: boolean;
46
+ }
47
+ /** cogitator bridge inbox: the letters waiting for the session, each under its signature. */
48
+ export declare function runBridgeInbox(flags: BridgeInboxFlags, context?: BridgeSessionContext): Promise<number>;
49
+ export interface BridgeCancelFlags extends HomeFlags {
50
+ json?: boolean;
51
+ }
52
+ /**
53
+ * cogitator bridge cancel <job> [reason]: the session that handed a job over takes it back. The
54
+ * agent it was with is told to stop.
55
+ */
56
+ export declare function runBridgeCancel(job: number, words: readonly string[], flags: BridgeCancelFlags, context?: BridgeSessionContext): Promise<number>;
57
+ /**
58
+ * How a session without the bridge's tools answers a letter it was woken with: the command line
59
+ * as the session can run it, whatever its `PATH`.
60
+ */
61
+ export declare function replyHint(bridgeCommand: string, home?: string): string;
62
+ /** How a session with the bridge's tools answers a letter it was woken with. */
63
+ export declare const TOOLS_REPLY_HINT: string;
64
+ export interface BridgeWaitFlags extends HomeFlags {
65
+ /** The harness whose hook runs the command: its stdin tells the session */
66
+ hook?: string;
67
+ /** Seconds to wait */
68
+ timeout?: number;
69
+ /** The name the bridge gave the session, for one it started */
70
+ agent?: string;
71
+ /** The session has the bridge's tools: it is told to reply with them, not with the command line */
72
+ tools?: boolean;
73
+ }
74
+ /** What `wait` exits with when it has mail: the code that makes a harness wake its session. */
75
+ export declare const WAKE_EXIT_CODE = 2;
76
+ /**
77
+ * cogitator bridge wait: waits for the session's mail and exits. With mail it writes the letters
78
+ * to stderr and exits with code 2, which is what wakes a Claude Code session whose background
79
+ * hook ran it. Without, it exits with 0 and says nothing. A failure exits with 1, never with 2:
80
+ * an error must not wake the session.
81
+ */
82
+ export declare function runBridgeWait(flags: BridgeWaitFlags, context?: BridgeSessionContext): Promise<number>;
83
+ export interface BridgeDoctorFlags extends HomeFlags {
84
+ cwd?: string;
85
+ json?: boolean;
86
+ }
87
+ /**
88
+ * cogitator bridge doctor: whether the bridge can reach the harnesses of this machine. Exits 1
89
+ * when something it needs is missing, 0 when at most warnings are left.
90
+ */
91
+ export declare function runBridgeDoctor(flags: BridgeDoctorFlags, context?: BridgeSessionContext): Promise<number>;
92
+ export {};
93
+ //# sourceMappingURL=bridge-session.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"bridge-session.d.ts","sourceRoot":"","sources":["../../src/commands/bridge-session.ts"],"names":[],"mappings":"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"}