@cogitator-ai/bridge 0.2.0 → 0.4.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.
Files changed (116) hide show
  1. package/README.md +242 -8
  2. package/dist/adapter.d.ts +130 -0
  3. package/dist/adapter.d.ts.map +1 -0
  4. package/dist/adapter.js +2 -0
  5. package/dist/adapter.js.map +1 -0
  6. package/dist/adapters/claude.d.ts +145 -0
  7. package/dist/adapters/claude.d.ts.map +1 -0
  8. package/dist/adapters/claude.js +537 -0
  9. package/dist/adapters/claude.js.map +1 -0
  10. package/dist/adapters/codex.d.ts +71 -0
  11. package/dist/adapters/codex.d.ts.map +1 -0
  12. package/dist/adapters/codex.js +379 -0
  13. package/dist/adapters/codex.js.map +1 -0
  14. package/dist/adapters/exec.d.ts +70 -0
  15. package/dist/adapters/exec.d.ts.map +1 -0
  16. package/dist/adapters/exec.js +161 -0
  17. package/dist/adapters/exec.js.map +1 -0
  18. package/dist/adapters/hosted.d.ts +168 -0
  19. package/dist/adapters/hosted.d.ts.map +1 -0
  20. package/dist/adapters/hosted.js +361 -0
  21. package/dist/adapters/hosted.js.map +1 -0
  22. package/dist/adapters/tools-server.d.ts +21 -0
  23. package/dist/adapters/tools-server.d.ts.map +1 -0
  24. package/dist/adapters/tools-server.js +19 -0
  25. package/dist/adapters/tools-server.js.map +1 -0
  26. package/dist/client.d.ts +9 -2
  27. package/dist/client.d.ts.map +1 -1
  28. package/dist/client.js +17 -3
  29. package/dist/client.js.map +1 -1
  30. package/dist/dispatcher.d.ts +69 -17
  31. package/dist/dispatcher.d.ts.map +1 -1
  32. package/dist/dispatcher.js +243 -17
  33. package/dist/dispatcher.js.map +1 -1
  34. package/dist/host.d.ts +1 -1
  35. package/dist/host.d.ts.map +1 -1
  36. package/dist/index.d.ts +18 -3
  37. package/dist/index.d.ts.map +1 -1
  38. package/dist/index.js +9 -1
  39. package/dist/index.js.map +1 -1
  40. package/dist/inputs.d.ts +40 -1
  41. package/dist/inputs.d.ts.map +1 -1
  42. package/dist/inputs.js +25 -2
  43. package/dist/inputs.js.map +1 -1
  44. package/dist/paths.d.ts +6 -0
  45. package/dist/paths.d.ts.map +1 -1
  46. package/dist/paths.js +19 -0
  47. package/dist/paths.js.map +1 -1
  48. package/dist/protocol.d.ts +5 -0
  49. package/dist/protocol.d.ts.map +1 -1
  50. package/dist/protocol.js +5 -0
  51. package/dist/protocol.js.map +1 -1
  52. package/dist/server.d.ts.map +1 -1
  53. package/dist/server.js +6 -1
  54. package/dist/server.js.map +1 -1
  55. package/dist/setup/claude.d.ts +53 -0
  56. package/dist/setup/claude.d.ts.map +1 -0
  57. package/dist/setup/claude.js +261 -0
  58. package/dist/setup/claude.js.map +1 -0
  59. package/dist/setup/codex.d.ts +22 -0
  60. package/dist/setup/codex.d.ts.map +1 -0
  61. package/dist/setup/codex.js +95 -0
  62. package/dist/setup/codex.js.map +1 -0
  63. package/dist/setup/files.d.ts +22 -0
  64. package/dist/setup/files.d.ts.map +1 -0
  65. package/dist/setup/files.js +86 -0
  66. package/dist/setup/files.js.map +1 -0
  67. package/dist/setup/index.d.ts +6 -0
  68. package/dist/setup/index.d.ts.map +1 -0
  69. package/dist/setup/index.js +3 -0
  70. package/dist/setup/index.js.map +1 -0
  71. package/dist/setup/setup.d.ts +52 -0
  72. package/dist/setup/setup.d.ts.map +1 -0
  73. package/dist/setup/setup.js +2 -0
  74. package/dist/setup/setup.js.map +1 -0
  75. package/dist/testing/conformance.d.ts +65 -0
  76. package/dist/testing/conformance.d.ts.map +1 -0
  77. package/dist/testing/conformance.js +217 -0
  78. package/dist/testing/conformance.js.map +1 -0
  79. package/dist/testing/fake-harnesses.d.ts +121 -0
  80. package/dist/testing/fake-harnesses.d.ts.map +1 -0
  81. package/dist/testing/fake-harnesses.js +303 -0
  82. package/dist/testing/fake-harnesses.js.map +1 -0
  83. package/dist/testing/index.d.ts +5 -0
  84. package/dist/testing/index.d.ts.map +1 -0
  85. package/dist/testing/index.js +3 -0
  86. package/dist/testing/index.js.map +1 -0
  87. package/dist/tools/caller.d.ts +39 -0
  88. package/dist/tools/caller.d.ts.map +1 -0
  89. package/dist/tools/caller.js +92 -0
  90. package/dist/tools/caller.js.map +1 -0
  91. package/dist/tools/guidance.d.ts +33 -0
  92. package/dist/tools/guidance.d.ts.map +1 -0
  93. package/dist/tools/guidance.js +92 -0
  94. package/dist/tools/guidance.js.map +1 -0
  95. package/dist/tools/index.d.ts +27 -0
  96. package/dist/tools/index.d.ts.map +1 -0
  97. package/dist/tools/index.js +24 -0
  98. package/dist/tools/index.js.map +1 -0
  99. package/dist/tools/tools.d.ts +38 -0
  100. package/dist/tools/tools.d.ts.map +1 -0
  101. package/dist/tools/tools.js +354 -0
  102. package/dist/tools/tools.js.map +1 -0
  103. package/dist/types.d.ts +3 -39
  104. package/dist/types.d.ts.map +1 -1
  105. package/dist/types.js +2 -0
  106. package/dist/types.js.map +1 -1
  107. package/dist/waiter.d.ts +36 -0
  108. package/dist/waiter.d.ts.map +1 -0
  109. package/dist/waiter.js +92 -0
  110. package/dist/waiter.js.map +1 -0
  111. package/fakes/claude.mjs +715 -0
  112. package/fakes/codex.mjs +571 -0
  113. package/fakes/lib.mjs +585 -0
  114. package/fakes/mcp.mjs +151 -0
  115. package/fakes/sandbox.mjs +84 -0
  116. package/package.json +19 -1
@@ -0,0 +1,27 @@
1
+ /**
2
+ * The agent bridge as tools of an agent: what `cogitator bridge mcp` serves to Claude Code and
3
+ * Codex, and what an agent of your own gets to take part.
4
+ *
5
+ * @example
6
+ * ```ts
7
+ * import { MCPServer } from '@cogitator-ai/mcp';
8
+ * import { bridgePaths } from '@cogitator-ai/bridge';
9
+ * import { BRIDGE_INSTRUCTIONS, bridgeTools } from '@cogitator-ai/bridge/tools';
10
+ *
11
+ * const server = new MCPServer({
12
+ * name: 'cogitator-bridge',
13
+ * version: '1.0.0',
14
+ * transport: 'stdio',
15
+ * instructions: BRIDGE_INSTRUCTIONS,
16
+ * });
17
+ * server.registerTools(bridgeTools({ socketPath: bridgePaths().socket }));
18
+ * await server.start();
19
+ * ```
20
+ */
21
+ export { bridgeTools } from './tools.js';
22
+ export type { BridgeToolsOptions } from './tools.js';
23
+ export { TOOL_CALL_HINT_KEY, callerOfToolCall, withoutToolCallHint } from './caller.js';
24
+ export type { ToolCallHint, ToolCallOrigin } from './caller.js';
25
+ export { BRIDGE_INSTRUCTIONS, BRIDGE_NOTES_END, BRIDGE_NOTES_START, bridgeNotes, hasBridgeNotes, withBridgeNotes, withoutBridgeNotes, } from './guidance.js';
26
+ export type { BridgeNotesOptions } from './guidance.js';
27
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,YAAY,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACrD,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AACxF,YAAY,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,eAAe,EACf,kBAAkB,GACnB,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}
@@ -0,0 +1,24 @@
1
+ /**
2
+ * The agent bridge as tools of an agent: what `cogitator bridge mcp` serves to Claude Code and
3
+ * Codex, and what an agent of your own gets to take part.
4
+ *
5
+ * @example
6
+ * ```ts
7
+ * import { MCPServer } from '@cogitator-ai/mcp';
8
+ * import { bridgePaths } from '@cogitator-ai/bridge';
9
+ * import { BRIDGE_INSTRUCTIONS, bridgeTools } from '@cogitator-ai/bridge/tools';
10
+ *
11
+ * const server = new MCPServer({
12
+ * name: 'cogitator-bridge',
13
+ * version: '1.0.0',
14
+ * transport: 'stdio',
15
+ * instructions: BRIDGE_INSTRUCTIONS,
16
+ * });
17
+ * server.registerTools(bridgeTools({ socketPath: bridgePaths().socket }));
18
+ * await server.start();
19
+ * ```
20
+ */
21
+ export { bridgeTools } from './tools.js';
22
+ export { TOOL_CALL_HINT_KEY, callerOfToolCall, withoutToolCallHint } from './caller.js';
23
+ export { BRIDGE_INSTRUCTIONS, BRIDGE_NOTES_END, BRIDGE_NOTES_START, bridgeNotes, hasBridgeNotes, withBridgeNotes, withoutBridgeNotes, } from './guidance.js';
24
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,OAAO,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAExF,OAAO,EACL,mBAAmB,EACnB,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,cAAc,EACd,eAAe,EACf,kBAAkB,GACnB,MAAM,eAAe,CAAC"}
@@ -0,0 +1,38 @@
1
+ import type { Tool } from '@cogitator-ai/types';
2
+ export interface BridgeToolsOptions {
3
+ /** Where the dispatcher of this machine listens, `bridgePaths().socket` */
4
+ socketPath: string;
5
+ /** The environment of the process the tools run in, `process.env` by default */
6
+ env?: NodeJS.ProcessEnv;
7
+ /** The folder the session works in when the call does not say, the current one by default */
8
+ cwd?: string;
9
+ /** How long the dispatcher may take to answer a call, 30 s by default */
10
+ timeoutMs?: number;
11
+ }
12
+ /**
13
+ * The bridge as tools of an agent: hand a job over, ask and answer on the way, report, and see
14
+ * what goes on. They are what `cogitator bridge mcp` serves to Claude Code and Codex. No tool
15
+ * waits for another agent: each returns at once, and the reply comes later as a letter.
16
+ *
17
+ * Every call says which session makes it (`callerOfToolCall`) and reaches the dispatcher on a
18
+ * connection of its own, so the tools go on working across a restart of the dispatcher and
19
+ * across a change of the session they serve.
20
+ *
21
+ * @example
22
+ * ```ts
23
+ * import { MCPServer } from '@cogitator-ai/mcp';
24
+ * import { bridgePaths } from '@cogitator-ai/bridge';
25
+ * import { BRIDGE_INSTRUCTIONS, bridgeTools } from '@cogitator-ai/bridge/tools';
26
+ *
27
+ * const server = new MCPServer({
28
+ * name: 'cogitator-bridge',
29
+ * version: '1.0.0',
30
+ * transport: 'stdio',
31
+ * instructions: BRIDGE_INSTRUCTIONS,
32
+ * });
33
+ * server.registerTools(bridgeTools({ socketPath: bridgePaths().socket }));
34
+ * await server.start();
35
+ * ```
36
+ */
37
+ export declare function bridgeTools(options: BridgeToolsOptions): Tool[];
38
+ //# sourceMappingURL=tools.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.d.ts","sourceRoot":"","sources":["../../src/tools/tools.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAmB,MAAM,qBAAqB,CAAC;AAUjE,MAAM,WAAW,kBAAkB;IACjC,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB,6FAA6F;IAC7F,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAyDD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,EAAE,CAgV/D"}
@@ -0,0 +1,354 @@
1
+ import { tool } from '@cogitator-ai/core';
2
+ import { z } from 'zod';
3
+ import { BridgeClient } from '../client.js';
4
+ import { BridgeError, isBridgeError } from '../errors.js';
5
+ import { oneLine } from '../letters.js';
6
+ import { NEW_SESSION, aliasOfHarness } from '../registry.js';
7
+ import { mailText } from '../waiter.js';
8
+ import { callerOfToolCall } from './caller.js';
9
+ /** A tool that changes something in the bridge: it adds, never destroys, and stays on this machine. */
10
+ const WRITES = {
11
+ readOnlyHint: false,
12
+ destructiveHint: false,
13
+ idempotentHint: false,
14
+ openWorldHint: false,
15
+ };
16
+ const READS = { readOnlyHint: true, openWorldHint: false };
17
+ const OPEN_STATES = ['submitted', 'working', 'input-required'];
18
+ /** How many letters of a job `job` shows, the newest. */
19
+ const TRAIL_LETTERS = 10;
20
+ /** How much of one letter `job` shows. The whole letter is in the inbox of who got it. */
21
+ const TRAIL_BODY = 4_000;
22
+ const JobNumber = z.number().int().positive().describe('The number of the job');
23
+ /** An ISO time to the minute, as an agent reads it: `2026-11-16 13:49 UTC`. */
24
+ function clock(at) {
25
+ return `${at.slice(0, 16).replace('T', ' ')} UTC`;
26
+ }
27
+ function jobLine(job) {
28
+ return `#${job.number} ${job.state} ${job.from} -> ${job.to} "${oneLine(job.title)}"`;
29
+ }
30
+ function letterBlock(letter) {
31
+ const body = letter.body.length > TRAIL_BODY
32
+ ? `${letter.body.slice(0, TRAIL_BODY)}\n[cut here, ${letter.body.length} characters in all]`
33
+ : letter.body;
34
+ const outcome = letter.outcome ? ` (${letter.outcome})` : '';
35
+ return `${clock(letter.createdAt)} ${letter.kind}${outcome} from ${letter.from} to ${letter.to}, letter ${letter.id}:\n${body}`;
36
+ }
37
+ function agentLine(agent, self, waiting) {
38
+ const notes = [
39
+ agent.name === self ? 'this session' : undefined,
40
+ agent.sessionName ? `"${oneLine(agent.sessionName)}"` : undefined,
41
+ agent.status === 'starting' ? 'starting' : undefined,
42
+ waiting ? 'wakes for mail' : undefined,
43
+ ].filter((note) => note !== undefined);
44
+ return `${agent.name} ${agent.harness}${notes.length > 0 ? `, ${notes.join(', ')}` : ''}`;
45
+ }
46
+ const NO_DISPATCHER = 'No bridge dispatcher runs on this machine, so nothing was sent. Tell the user to start it: cogitator bridge serve';
47
+ const NO_SESSION = 'The bridge cannot tell which session is calling: the call names none, and neither does the environment of the tools. ' +
48
+ 'They work inside a session of Claude Code or Codex. Tell the user to check the setup: cogitator bridge doctor';
49
+ /**
50
+ * The bridge as tools of an agent: hand a job over, ask and answer on the way, report, and see
51
+ * what goes on. They are what `cogitator bridge mcp` serves to Claude Code and Codex. No tool
52
+ * waits for another agent: each returns at once, and the reply comes later as a letter.
53
+ *
54
+ * Every call says which session makes it (`callerOfToolCall`) and reaches the dispatcher on a
55
+ * connection of its own, so the tools go on working across a restart of the dispatcher and
56
+ * across a change of the session they serve.
57
+ *
58
+ * @example
59
+ * ```ts
60
+ * import { MCPServer } from '@cogitator-ai/mcp';
61
+ * import { bridgePaths } from '@cogitator-ai/bridge';
62
+ * import { BRIDGE_INSTRUCTIONS, bridgeTools } from '@cogitator-ai/bridge/tools';
63
+ *
64
+ * const server = new MCPServer({
65
+ * name: 'cogitator-bridge',
66
+ * version: '1.0.0',
67
+ * transport: 'stdio',
68
+ * instructions: BRIDGE_INSTRUCTIONS,
69
+ * });
70
+ * server.registerTools(bridgeTools({ socketPath: bridgePaths().socket }));
71
+ * await server.start();
72
+ * ```
73
+ */
74
+ export function bridgeTools(options) {
75
+ const env = options.env ?? process.env;
76
+ function originOf(args, context) {
77
+ const request = typeof context === 'object' && context !== null && 'request' in context
78
+ ? context.request
79
+ : undefined;
80
+ const { meta, client } = (typeof request === 'object' && request !== null ? request : {});
81
+ const name = typeof client === 'object' && client !== null && 'name' in client
82
+ ? client.name
83
+ : undefined;
84
+ return {
85
+ args,
86
+ ...(typeof meta === 'object' && meta !== null && { meta: meta }),
87
+ ...(typeof name === 'string' && { client: name }),
88
+ };
89
+ }
90
+ /** Runs `work` as the session that made the call, on a connection that lasts for the call. */
91
+ async function asCaller(args, context, work) {
92
+ let caller;
93
+ let bridge;
94
+ try {
95
+ caller = callerOfToolCall(originOf(args, context), env, options.cwd ?? process.cwd());
96
+ if (!caller)
97
+ throw new Error(NO_SESSION);
98
+ bridge = await BridgeClient.connect({
99
+ socketPath: options.socketPath,
100
+ caller,
101
+ ...(options.timeoutMs !== undefined && { timeoutMs: options.timeoutMs }),
102
+ });
103
+ if (!bridge.agent) {
104
+ throw new BridgeError('not_registered', 'The bridge did not say which agent this session is');
105
+ }
106
+ return await work(bridge, bridge.agent);
107
+ }
108
+ catch (error) {
109
+ if (isBridgeError(error) && error.code === 'not_running' && !bridge) {
110
+ throw new Error(NO_DISPATCHER, { cause: error });
111
+ }
112
+ throw error;
113
+ }
114
+ finally {
115
+ await bridge?.close().catch(() => undefined);
116
+ }
117
+ }
118
+ const delegate = tool({
119
+ name: 'delegate',
120
+ title: 'Hand a job to another agent',
121
+ description: 'Hand a job to another coding agent on this machine and get its number at once. The agent works in its own session: its questions and its report come back later as letters that wake this session, so end your turn after the call instead of waiting.',
122
+ parameters: z.looseObject({
123
+ to: z
124
+ .string()
125
+ .min(1)
126
+ .describe(`Who gets the job: "codex" or "claude" for the session of that agent in this project (one is started when none is open), "codex:${NEW_SESSION}" for a fresh one, or an agent name from the agents tool such as "codex-2@app"`),
127
+ task: z
128
+ .string()
129
+ .min(1)
130
+ .describe('The job: what to do, and what done looks like. The other agent sees nothing of this conversation, so name the files, the constraints and the decisions already made'),
131
+ title: z.string().optional().describe('A short name of the job, its first line by default'),
132
+ cwd: z
133
+ .string()
134
+ .optional()
135
+ .describe("The folder the job is done in, inside this project. This session's by default"),
136
+ parent: z
137
+ .number()
138
+ .int()
139
+ .positive()
140
+ .optional()
141
+ .describe('The job this one is part of, when this session carries out several. Found by itself otherwise'),
142
+ }),
143
+ annotations: WRITES,
144
+ sideEffects: ['process'],
145
+ execute: async (args, context) => asCaller(args, context, async (bridge) => {
146
+ const { job, duplicate } = await bridge.createJob({
147
+ to: args.to,
148
+ body: args.task,
149
+ ...(args.title !== undefined && { title: args.title }),
150
+ ...(args.cwd !== undefined && { cwd: args.cwd }),
151
+ ...(args.parent !== undefined && { parent: args.parent }),
152
+ });
153
+ return (`Job #${job.number} is with ${job.to} (${job.state})${duplicate ? ', handed over before: nothing was sent twice' : ''}. ` +
154
+ 'Its questions and its report arrive as letters. Say in one line what you handed over, then end your turn: do not wait or poll.');
155
+ }),
156
+ });
157
+ const ask = tool({
158
+ name: 'ask',
159
+ title: 'Ask about a job',
160
+ description: 'Ask the other agent of a job a question: whoever handed you the job, or the agent you handed one to. The answer comes back as a letter that wakes this session, so end your turn after asking.',
161
+ parameters: z.looseObject({
162
+ job: JobNumber,
163
+ question: z
164
+ .string()
165
+ .min(1)
166
+ .describe('The question, with what the other agent needs to answer it'),
167
+ }),
168
+ annotations: WRITES,
169
+ sideEffects: ['external'],
170
+ execute: async (args, context) => asCaller(args, context, async (bridge) => {
171
+ const sent = await bridge.send({ job: args.job, kind: 'question', body: args.question });
172
+ return `Asked ${sent.letter.to}. Job #${sent.job.number} is ${sent.job.state}. End your turn: the answer wakes this session.`;
173
+ }),
174
+ });
175
+ const answer = tool({
176
+ name: 'answer',
177
+ title: 'Answer a question',
178
+ description: 'Answer a question another agent asked about a job. The answer goes to that agent, who does not see this conversation.',
179
+ parameters: z.looseObject({
180
+ job: JobNumber,
181
+ answer: z.string().min(1).describe('The answer'),
182
+ letter: z
183
+ .string()
184
+ .optional()
185
+ .describe('The id of the letter this answers, from its first line. The open question of the job by default'),
186
+ }),
187
+ annotations: WRITES,
188
+ sideEffects: ['external'],
189
+ execute: async (args, context) => asCaller(args, context, async (bridge) => {
190
+ const sent = await bridge.send({
191
+ job: args.job,
192
+ kind: 'answer',
193
+ body: args.answer,
194
+ ...(args.letter !== undefined && { inReplyTo: args.letter }),
195
+ });
196
+ return `Answered ${sent.letter.to}. Job #${sent.job.number} is ${sent.job.state}.`;
197
+ }),
198
+ });
199
+ const report = tool({
200
+ name: 'report',
201
+ title: 'Report on a job',
202
+ description: 'Report the result of a job that was handed to this session, which ends the job. Whoever handed it over reads only this report, so say what was done, where, and what is left.',
203
+ parameters: z.looseObject({
204
+ job: JobNumber,
205
+ result: z
206
+ .string()
207
+ .min(1)
208
+ .describe('What was done: the outcome, the files touched, how it was checked, what is left open'),
209
+ failed: z
210
+ .boolean()
211
+ .optional()
212
+ .describe('True when the job could not be done. The result then says why'),
213
+ }),
214
+ annotations: WRITES,
215
+ sideEffects: ['external'],
216
+ execute: async (args, context) => asCaller(args, context, async (bridge) => {
217
+ const sent = await bridge.send({
218
+ job: args.job,
219
+ kind: 'report',
220
+ body: args.result,
221
+ ...(args.failed && { outcome: 'failed' }),
222
+ });
223
+ return `Reported to ${sent.letter.to}. Job #${sent.job.number} is ${sent.job.state}.`;
224
+ }),
225
+ });
226
+ const note = tool({
227
+ name: 'note',
228
+ title: 'Send a note on a job',
229
+ description: 'Tell the other agent of a job something it should know and need not answer: progress, a finding, a change of plan. The job goes on.',
230
+ parameters: z.looseObject({
231
+ job: JobNumber,
232
+ text: z.string().min(1).describe('What the other agent should know'),
233
+ }),
234
+ annotations: WRITES,
235
+ sideEffects: ['external'],
236
+ execute: async (args, context) => asCaller(args, context, async (bridge) => {
237
+ const sent = await bridge.send({ job: args.job, kind: 'note', body: args.text });
238
+ return `Sent the note to ${sent.letter.to}. Job #${sent.job.number} is ${sent.job.state}.`;
239
+ }),
240
+ });
241
+ const inbox = tool({
242
+ name: 'inbox',
243
+ title: 'Read the letters that wait',
244
+ description: 'Read the letters that wait for this session, each under the line that says which job it is about and who wrote it. Letters usually arrive by themselves: use this when nothing woke the session, or for a letter too long to be handed over whole.',
245
+ parameters: z.looseObject({
246
+ job: z.number().int().positive().optional().describe('Only the letters of one job'),
247
+ peek: z.boolean().optional().describe('Look without taking: the letters stay as they are'),
248
+ unhandled: z
249
+ .boolean()
250
+ .optional()
251
+ .describe('Also the letters read before and not answered since'),
252
+ }),
253
+ annotations: WRITES,
254
+ sideEffects: [],
255
+ execute: async (args, context) => asCaller(args, context, async (bridge) => {
256
+ const letters = await bridge.inbox({
257
+ ...(args.job !== undefined && { job: args.job }),
258
+ ...(args.peek && { peek: true }),
259
+ ...(args.unhandled && { unhandled: true }),
260
+ });
261
+ return letters.length === 0 ? 'No letters wait for this session.' : mailText(letters);
262
+ }),
263
+ });
264
+ const job = tool({
265
+ name: 'job',
266
+ title: 'Look at a job',
267
+ description: 'See one job: its state, who handed it to whom, and for a job of this session its latest letters. Reads only, takes nothing from the inbox.',
268
+ parameters: z.looseObject({ job: JobNumber }),
269
+ annotations: READS,
270
+ sideEffects: [],
271
+ execute: async (args, context) => asCaller(args, context, async (bridge, self) => {
272
+ const found = await bridge.job(args.job);
273
+ const lines = [
274
+ jobLine(found),
275
+ `Handed over ${clock(found.createdAt)}, last change ${clock(found.updatedAt)}, folder ${found.cwd}`,
276
+ ];
277
+ if (found.reason)
278
+ lines.push(`Reason: ${found.reason}`);
279
+ if (found.parent !== undefined)
280
+ lines.push(`Part of job #${found.parent}`);
281
+ if (found.from !== self.name && found.to !== self.name) {
282
+ lines.push('Its letters are between its two agents: this session is neither.');
283
+ return lines.join('\n');
284
+ }
285
+ const trail = await bridge.letters({
286
+ job: found.number,
287
+ newestFirst: true,
288
+ limit: TRAIL_LETTERS,
289
+ });
290
+ if (trail.length > 0) {
291
+ lines.push('', ...trail.reverse().map((letter) => letterBlock(letter)));
292
+ }
293
+ return lines.join('\n');
294
+ }),
295
+ });
296
+ const jobs = tool({
297
+ name: 'jobs',
298
+ title: 'List the jobs of this session',
299
+ description: 'List the jobs this session handed over or carries out: those in progress, or all of them.',
300
+ parameters: z.looseObject({
301
+ all: z.boolean().optional().describe('Also the jobs that are over, the newest first'),
302
+ }),
303
+ annotations: READS,
304
+ sideEffects: [],
305
+ execute: async (args, context) => asCaller(args, context, async (bridge, self) => {
306
+ const found = await bridge.jobs({
307
+ party: self.name,
308
+ ...(!args.all && { states: OPEN_STATES }),
309
+ limit: 50,
310
+ });
311
+ if (found.length === 0) {
312
+ return args.all ? 'This session has no jobs.' : 'This session has no jobs in progress.';
313
+ }
314
+ return found.map((entry) => jobLine(entry)).join('\n');
315
+ }),
316
+ });
317
+ const cancel = tool({
318
+ name: 'cancel',
319
+ title: 'Take a job back',
320
+ description: 'Take back a job this session handed over. The agent that worked on it is told to stop, and what it did so far stays where it is.',
321
+ parameters: z.looseObject({
322
+ job: JobNumber,
323
+ reason: z.string().optional().describe('Why, for the agent that worked on it'),
324
+ }),
325
+ annotations: WRITES,
326
+ sideEffects: ['process'],
327
+ execute: async (args, context) => asCaller(args, context, async (bridge) => {
328
+ const canceled = await bridge.cancel(args.job, args.reason?.trim() || undefined);
329
+ return `Job #${canceled.number} is ${canceled.state}, ${canceled.to} is told.`;
330
+ }),
331
+ });
332
+ const agents = tool({
333
+ name: 'agents',
334
+ title: 'See who can take a job',
335
+ description: 'List the sessions of coding agents the bridge knows in this project, and the agents it can start a session of. Their names are what delegate takes.',
336
+ parameters: z.looseObject({}),
337
+ annotations: READS,
338
+ sideEffects: [],
339
+ execute: async (args, context) => asCaller(args, context, async (bridge, self) => {
340
+ const [known, status] = await Promise.all([
341
+ bridge.agents({ project: self.project, statuses: ['active', 'starting'] }),
342
+ bridge.status(),
343
+ ]);
344
+ const lines = known.map((agent) => agentLine(agent, self.name, status.waiting.includes(agent.name)));
345
+ const startable = status.startable.map((harness) => aliasOfHarness(harness));
346
+ lines.push('', startable.length > 0
347
+ ? `The bridge starts a session for a job handed to: ${startable.join(', ')} (when none is open in this project, or with ":${NEW_SESSION}" after the word)`
348
+ : 'The bridge cannot start sessions here: a job goes to a session that is listed above');
349
+ return lines.join('\n');
350
+ }),
351
+ });
352
+ return [delegate, ask, answer, report, note, inbox, job, jobs, cancel, agents];
353
+ }
354
+ //# sourceMappingURL=tools.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"tools.js","sourceRoot":"","sources":["../../src/tools/tools.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAE1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE7D,OAAO,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAuB,MAAM,aAAa,CAAC;AAapE,uGAAuG;AACvG,MAAM,MAAM,GAAoB;IAC9B,YAAY,EAAE,KAAK;IACnB,eAAe,EAAE,KAAK;IACtB,cAAc,EAAE,KAAK;IACrB,aAAa,EAAE,KAAK;CACrB,CAAC;AAEF,MAAM,KAAK,GAAoB,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,CAAC;AAE5E,MAAM,WAAW,GAAwB,CAAC,WAAW,EAAE,SAAS,EAAE,gBAAgB,CAAC,CAAC;AAEpF,yDAAyD;AACzD,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB,0FAA0F;AAC1F,MAAM,UAAU,GAAG,KAAK,CAAC;AAEzB,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC,CAAC;AAEhF,+EAA+E;AAC/E,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,MAAM,CAAC;AACpD,CAAC;AAED,SAAS,OAAO,CAAC,GAAc;IAC7B,OAAO,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,KAAK,KAAK,GAAG,CAAC,IAAI,OAAO,GAAG,CAAC,EAAE,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC;AAC1F,CAAC;AAED,SAAS,WAAW,CAAC,MAAc;IACjC,MAAM,IAAI,GACR,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,UAAU;QAC7B,CAAC,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,UAAU,CAAC,gBAAgB,MAAM,CAAC,IAAI,CAAC,MAAM,qBAAqB;QAC5F,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;IAClB,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;IAC7D,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,SAAS,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,OAAO,SAAS,MAAM,CAAC,IAAI,OAAO,MAAM,CAAC,EAAE,YAAY,MAAM,CAAC,EAAE,MAAM,IAAI,EAAE,CAAC;AAClI,CAAC;AAED,SAAS,SAAS,CAAC,KAAkB,EAAE,IAAwB,EAAE,OAAgB;IAC/E,MAAM,KAAK,GAAG;QACZ,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS;QAChD,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;QACjE,KAAK,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;QACpD,OAAO,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,SAAS;KACvC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC;IACvC,OAAO,GAAG,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;AAC7F,CAAC;AAED,MAAM,aAAa,GACjB,mHAAmH,CAAC;AAEtH,MAAM,UAAU,GACd,uHAAuH;IACvH,+GAA+G,CAAC;AAElH;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,WAAW,CAAC,OAA2B;IACrD,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,CAAC;IAEvC,SAAS,QAAQ,CAAC,IAAa,EAAE,OAAgB;QAC/C,MAAM,OAAO,GACX,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,IAAI,SAAS,IAAI,OAAO;YACrE,CAAC,CAAE,OAAiC,CAAC,OAAO;YAC5C,CAAC,CAAC,SAAS,CAAC;QAChB,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAGvF,CAAC;QACF,MAAM,IAAI,GACR,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,IAAI,MAAM;YAC/D,CAAC,CAAE,MAA6B,CAAC,IAAI;YACrC,CAAC,CAAC,SAAS,CAAC;QAChB,OAAO;YACL,IAAI;YACJ,GAAG,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,IAAI,IAAI,EAAE,IAAI,EAAE,IAA+B,EAAE,CAAC;YAC3F,GAAG,CAAC,OAAO,IAAI,KAAK,QAAQ,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;SAClD,CAAC;IACJ,CAAC;IAED,8FAA8F;IAC9F,KAAK,UAAU,QAAQ,CACrB,IAAa,EACb,OAAgB,EAChB,IAA6D;QAE7D,IAAI,MAAkC,CAAC;QACvC,IAAI,MAAgC,CAAC;QACrC,IAAI,CAAC;YACH,MAAM,GAAG,gBAAgB,CAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC,CAAC;YACtF,IAAI,CAAC,MAAM;gBAAE,MAAM,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC;YACzC,MAAM,GAAG,MAAM,YAAY,CAAC,OAAO,CAAC;gBAClC,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,MAAM;gBACN,GAAG,CAAC,OAAO,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE,CAAC;aACzE,CAAC,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;gBAClB,MAAM,IAAI,WAAW,CACnB,gBAAgB,EAChB,oDAAoD,CACrD,CAAC;YACJ,CAAC;YACD,OAAO,MAAM,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,aAAa,IAAI,CAAC,MAAM,EAAE,CAAC;gBACpE,MAAM,IAAI,KAAK,CAAC,aAAa,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;YACnD,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,MAAM,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC;QACpB,IAAI,EAAE,UAAU;QAChB,KAAK,EAAE,6BAA6B;QACpC,WAAW,EACT,wPAAwP;QAC1P,UAAU,EAAE,CAAC,CAAC,WAAW,CAAC;YACxB,EAAE,EAAE,CAAC;iBACF,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CACP,kIAAkI,WAAW,gFAAgF,CAC9N;YACH,IAAI,EAAE,CAAC;iBACJ,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CACP,qKAAqK,CACtK;YACH,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;YAC3F,GAAG,EAAE,CAAC;iBACH,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CAAC,+EAA+E,CAAC;YAC5F,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,EAAE;iBACV,QAAQ,CACP,+FAA+F,CAChG;SACJ,CAAC;QACF,WAAW,EAAE,MAAM;QACnB,WAAW,EAAE,CAAC,SAAS,CAAC;QACxB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACvC,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC;gBAChD,EAAE,EAAE,IAAI,CAAC,EAAE;gBACX,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,GAAG,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;gBACtD,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;gBAChD,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;aAC1D,CAAC,CAAC;YACH,OAAO,CACL,QAAQ,GAAG,CAAC,MAAM,YAAY,GAAG,CAAC,EAAE,KAAK,GAAG,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC,CAAC,8CAA8C,CAAC,CAAC,CAAC,EAAE,IAAI;gBACzH,gIAAgI,CACjI,CAAC;QACJ,CAAC,CAAC;KACL,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,IAAI,CAAC;QACf,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,gMAAgM;QAClM,UAAU,EAAE,CAAC,CAAC,WAAW,CAAC;YACxB,GAAG,EAAE,SAAS;YACd,QAAQ,EAAE,CAAC;iBACR,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,4DAA4D,CAAC;SAC1E,CAAC;QACF,WAAW,EAAE,MAAM;QACnB,WAAW,EAAE,CAAC,UAAU,CAAC;QACzB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACvC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;YACzF,OAAO,SAAS,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,IAAI,CAAC,GAAG,CAAC,MAAM,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,iDAAiD,CAAC;QAChI,CAAC,CAAC;KACL,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,CAAC;QAClB,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,mBAAmB;QAC1B,WAAW,EACT,uHAAuH;QACzH,UAAU,EAAE,CAAC,CAAC,WAAW,CAAC;YACxB,GAAG,EAAE,SAAS;YACd,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,CAAC;YAChD,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,iGAAiG,CAClG;SACJ,CAAC;QACF,WAAW,EAAE,MAAM;QACnB,WAAW,EAAE,CAAC,UAAU,CAAC;QACzB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACvC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;gBAC7B,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,IAAI,CAAC,MAAM;gBACjB,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;aAC7D,CAAC,CAAC;YACH,OAAO,YAAY,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,IAAI,CAAC,GAAG,CAAC,MAAM,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC;QACrF,CAAC,CAAC;KACL,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,CAAC;QAClB,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,+KAA+K;QACjL,UAAU,EAAE,CAAC,CAAC,WAAW,CAAC;YACxB,GAAG,EAAE,SAAS;YACd,MAAM,EAAE,CAAC;iBACN,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CACP,sFAAsF,CACvF;YACH,MAAM,EAAE,CAAC;iBACN,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,+DAA+D,CAAC;SAC7E,CAAC;QACF,WAAW,EAAE,MAAM;QACnB,WAAW,EAAE,CAAC,UAAU,CAAC;QACzB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACvC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;gBAC7B,GAAG,EAAE,IAAI,CAAC,GAAG;gBACb,IAAI,EAAE,QAAQ;gBACd,IAAI,EAAE,IAAI,CAAC,MAAM;gBACjB,GAAG,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,OAAO,EAAE,QAAiB,EAAE,CAAC;aACnD,CAAC,CAAC;YACH,OAAO,eAAe,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,IAAI,CAAC,GAAG,CAAC,MAAM,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC;QACxF,CAAC,CAAC;KACL,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,IAAI,CAAC;QAChB,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,sBAAsB;QAC7B,WAAW,EACT,qIAAqI;QACvI,UAAU,EAAE,CAAC,CAAC,WAAW,CAAC;YACxB,GAAG,EAAE,SAAS;YACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,kCAAkC,CAAC;SACrE,CAAC;QACF,WAAW,EAAE,MAAM;QACnB,WAAW,EAAE,CAAC,UAAU,CAAC;QACzB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACvC,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACjF,OAAO,oBAAoB,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,IAAI,CAAC,GAAG,CAAC,MAAM,OAAO,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,CAAC;QAC7F,CAAC,CAAC;KACL,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,IAAI,CAAC;QACjB,IAAI,EAAE,OAAO;QACb,KAAK,EAAE,4BAA4B;QACnC,WAAW,EACT,oPAAoP;QACtP,UAAU,EAAE,CAAC,CAAC,WAAW,CAAC;YACxB,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6BAA6B,CAAC;YACnF,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;YAC1F,SAAS,EAAE,CAAC;iBACT,OAAO,EAAE;iBACT,QAAQ,EAAE;iBACV,QAAQ,CAAC,qDAAqD,CAAC;SACnE,CAAC;QACF,WAAW,EAAE,MAAM;QACnB,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACvC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC;gBACjC,GAAG,CAAC,IAAI,CAAC,GAAG,KAAK,SAAS,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC;gBAChD,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;gBAChC,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;aAC3C,CAAC,CAAC;YACH,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,mCAAmC,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACxF,CAAC,CAAC;KACL,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,IAAI,CAAC;QACf,IAAI,EAAE,KAAK;QACX,KAAK,EAAE,eAAe;QACtB,WAAW,EACT,4IAA4I;QAC9I,UAAU,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,CAAC;QAC7C,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YAC7C,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACzC,MAAM,KAAK,GAAG;gBACZ,OAAO,CAAC,KAAK,CAAC;gBACd,eAAe,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,iBAAiB,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC,YAAY,KAAK,CAAC,GAAG,EAAE;aACpG,CAAC;YACF,IAAI,KAAK,CAAC,MAAM;gBAAE,KAAK,CAAC,IAAI,CAAC,WAAW,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YACxD,IAAI,KAAK,CAAC,MAAM,KAAK,SAAS;gBAAE,KAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;YAC3E,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,EAAE,KAAK,IAAI,CAAC,IAAI,EAAE,CAAC;gBACvD,KAAK,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;gBAC/E,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC1B,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,OAAO,CAAC;gBACjC,GAAG,EAAE,KAAK,CAAC,MAAM;gBACjB,WAAW,EAAE,IAAI;gBACjB,KAAK,EAAE,aAAa;aACrB,CAAC,CAAC;YACH,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACrB,KAAK,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAC1E,CAAC;YACD,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC,CAAC;KACL,CAAC,CAAC;IAEH,MAAM,IAAI,GAAG,IAAI,CAAC;QAChB,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,+BAA+B;QACtC,WAAW,EACT,2FAA2F;QAC7F,UAAU,EAAE,CAAC,CAAC,WAAW,CAAC;YACxB,GAAG,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,+CAA+C,CAAC;SACtF,CAAC;QACF,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YAC7C,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC;gBAC9B,KAAK,EAAE,IAAI,CAAC,IAAI;gBAChB,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,CAAC;gBACzC,KAAK,EAAE,EAAE;aACV,CAAC,CAAC;YACH,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,2BAA2B,CAAC,CAAC,CAAC,uCAAuC,CAAC;YAC1F,CAAC;YACD,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzD,CAAC,CAAC;KACL,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,CAAC;QAClB,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,kIAAkI;QACpI,UAAU,EAAE,CAAC,CAAC,WAAW,CAAC;YACxB,GAAG,EAAE,SAAS;YACd,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;SAC/E,CAAC;QACF,WAAW,EAAE,MAAM;QACnB,WAAW,EAAE,CAAC,SAAS,CAAC;QACxB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,EAAE;YACvC,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC,CAAC;YACjF,OAAO,QAAQ,QAAQ,CAAC,MAAM,OAAO,QAAQ,CAAC,KAAK,KAAK,QAAQ,CAAC,EAAE,WAAW,CAAC;QACjF,CAAC,CAAC;KACL,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,CAAC;QAClB,IAAI,EAAE,QAAQ;QACd,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,qJAAqJ;QACvJ,UAAU,EAAE,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,EAAE;QACf,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAC/B,QAAQ,CAAC,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;YAC7C,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;gBACxC,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,QAAQ,EAAE,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,CAAC;gBAC1E,MAAM,CAAC,MAAM,EAAE;aAChB,CAAC,CAAC;YACH,MAAM,KAAK,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAChC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CACjE,CAAC;YACF,MAAM,SAAS,GAAG,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;YAC7E,KAAK,CAAC,IAAI,CACR,EAAE,EACF,SAAS,CAAC,MAAM,GAAG,CAAC;gBAClB,CAAC,CAAC,oDAAoD,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,kDAAkD,WAAW,mBAAmB;gBAC1J,CAAC,CAAC,qFAAqF,CAC1F,CAAC;YACF,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC,CAAC;KACL,CAAC,CAAC;IAEH,OAAO,CAAC,QAAQ,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAW,CAAC;AAC3F,CAAC"}
package/dist/types.d.ts CHANGED
@@ -255,6 +255,8 @@ export interface BridgeLimits {
255
255
  jobsPerHour: number;
256
256
  /** How many sessions adapters may be starting at once */
257
257
  maxStartingSessions: number;
258
+ /** How often adapters that can list their sessions are asked which of them still run */
259
+ presenceCheckMs: number;
258
260
  }
259
261
  export declare const BridgeLimitsSchema: z.ZodObject<{
260
262
  maxDepth: z.ZodNumber;
@@ -278,45 +280,7 @@ export declare const BridgeLimitsSchema: z.ZodObject<{
278
280
  maxOpenJobs: z.ZodNumber;
279
281
  jobsPerHour: z.ZodNumber;
280
282
  maxStartingSessions: z.ZodNumber;
283
+ presenceCheckMs: z.ZodNumber;
281
284
  }, z.core.$strict>;
282
285
  export declare const DEFAULT_LIMITS: BridgeLimits;
283
- /** A letter on its way to a session, as an adapter gets it. */
284
- export interface LetterDelivery {
285
- agent: AgentRecord;
286
- letter: RenderedLetter;
287
- job: BridgeJob;
288
- }
289
- /** What the bridge asks of an adapter that starts a session for a job. */
290
- export interface SessionRequest {
291
- /** The name the bridge gave the session, to hand to it as `COGITATOR_BRIDGE_AGENT` */
292
- agentName: string;
293
- harness: string;
294
- project: string;
295
- cwd: string;
296
- sessionName?: string;
297
- job: BridgeJob;
298
- /** The job's first letter, for a harness that takes the first message when it starts a session */
299
- firstLetter: RenderedLetter;
300
- }
301
- export interface CreatedSession {
302
- sessionId: string;
303
- sessionName?: string;
304
- /** Whether the session got `firstLetter` when it started, so the bridge does not deliver it again */
305
- deliveredFirstLetter?: boolean;
306
- }
307
- /**
308
- * How the bridge reaches the sessions of one harness. Without an adapter a session still takes
309
- * part: it reads its inbox whenever it calls the bridge.
310
- */
311
- export interface BridgeAdapter {
312
- /** The harness it reaches, in lower case: letters, digits, `.`, `_` and `-` */
313
- readonly harness: string;
314
- /** The mechanism letters travel by, recorded with every session of the harness */
315
- readonly delivery: string;
316
- readonly capabilities: AdapterCapabilities;
317
- /** Hands the letter to the session. Rejects when it could not, and the bridge tries again */
318
- deliver(delivery: LetterDelivery): Promise<void>;
319
- /** Starts a session for a job. Present when `capabilities.createSession` is true */
320
- createSession?(request: SessionRequest): Promise<CreatedSession>;
321
- }
322
286
  //# sourceMappingURL=types.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
package/dist/types.js CHANGED
@@ -111,6 +111,7 @@ export const BridgeLimitsSchema = z.strictObject({
111
111
  maxOpenJobs: z.number().int().positive().max(10_000),
112
112
  jobsPerHour: z.number().int().positive().max(100_000),
113
113
  maxStartingSessions: z.number().int().positive().max(100),
114
+ presenceCheckMs: z.number().int().positive().max(86_400_000),
114
115
  });
115
116
  export const DEFAULT_LIMITS = {
116
117
  maxDepth: 3,
@@ -126,5 +127,6 @@ export const DEFAULT_LIMITS = {
126
127
  maxOpenJobs: 20,
127
128
  jobsPerHour: 60,
128
129
  maxStartingSessions: 2,
130
+ presenceCheckMs: 60_000,
129
131
  };
130
132
  //# sourceMappingURL=types.js.map
package/dist/types.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,36 @@
1
+ import type { CallerIdentity, RenderedLetter } from './types.js';
2
+ export interface WaitForMailOptions {
3
+ socketPath: string;
4
+ /** The session whose mail is waited for */
5
+ caller: CallerIdentity;
6
+ /** How long to wait in all, a day at most */
7
+ timeoutMs: number;
8
+ /** How often to look for a dispatcher that does not run, 2 s by default */
9
+ retryMs?: number;
10
+ /** Ends the wait early */
11
+ signal?: AbortSignal;
12
+ }
13
+ export interface WaitForMailResult {
14
+ /**
15
+ * Why the wait ended: `letters` came, the time ran out (`timeout`), another waiter of the
16
+ * session took over (`replaced`), or `signal` aborted (`closed`)
17
+ */
18
+ reason: 'letters' | 'timeout' | 'replaced' | 'closed';
19
+ letters: RenderedLetter[];
20
+ /**
21
+ * Tells the bridge the letters reached the session. Call it once they are where the session
22
+ * reads them: until then they stay queued, and the next waiter gets them again
23
+ */
24
+ confirm(): Promise<void>;
25
+ }
26
+ /**
27
+ * Waits at the dispatcher for a session's mail, as the process a hook of the session runs. A
28
+ * dispatcher that does not run, or stops while the waiter waits, is waited for too: the session
29
+ * stays reachable across a restart of the dispatcher.
30
+ *
31
+ * @throws BridgeError what the dispatcher refuses the session for, other than not running
32
+ */
33
+ export declare function waitForMail(options: WaitForMailOptions): Promise<WaitForMailResult>;
34
+ /** The text a waiter hands its session: the letters, oldest first, each under its signature. */
35
+ export declare function mailText(letters: readonly RenderedLetter[]): string;
36
+ //# sourceMappingURL=waiter.d.ts.map