@cogitator-ai/bridge 0.2.0 → 0.3.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 (74) hide show
  1. package/README.md +156 -8
  2. package/dist/adapter.d.ts +123 -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 +90 -0
  7. package/dist/adapters/claude.d.ts.map +1 -0
  8. package/dist/adapters/claude.js +359 -0
  9. package/dist/adapters/claude.js.map +1 -0
  10. package/dist/adapters/codex.d.ts +58 -0
  11. package/dist/adapters/codex.d.ts.map +1 -0
  12. package/dist/adapters/codex.js +330 -0
  13. package/dist/adapters/codex.js.map +1 -0
  14. package/dist/adapters/exec.d.ts +57 -0
  15. package/dist/adapters/exec.d.ts.map +1 -0
  16. package/dist/adapters/exec.js +149 -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/client.d.ts +9 -2
  23. package/dist/client.d.ts.map +1 -1
  24. package/dist/client.js +17 -3
  25. package/dist/client.js.map +1 -1
  26. package/dist/dispatcher.d.ts +67 -17
  27. package/dist/dispatcher.d.ts.map +1 -1
  28. package/dist/dispatcher.js +240 -17
  29. package/dist/dispatcher.js.map +1 -1
  30. package/dist/host.d.ts +1 -1
  31. package/dist/host.d.ts.map +1 -1
  32. package/dist/index.d.ts +13 -2
  33. package/dist/index.d.ts.map +1 -1
  34. package/dist/index.js +6 -0
  35. package/dist/index.js.map +1 -1
  36. package/dist/inputs.d.ts +40 -1
  37. package/dist/inputs.d.ts.map +1 -1
  38. package/dist/inputs.js +25 -2
  39. package/dist/inputs.js.map +1 -1
  40. package/dist/paths.d.ts +6 -0
  41. package/dist/paths.d.ts.map +1 -1
  42. package/dist/paths.js +19 -0
  43. package/dist/paths.js.map +1 -1
  44. package/dist/protocol.d.ts +5 -0
  45. package/dist/protocol.d.ts.map +1 -1
  46. package/dist/protocol.js +5 -0
  47. package/dist/protocol.js.map +1 -1
  48. package/dist/server.d.ts.map +1 -1
  49. package/dist/server.js +6 -1
  50. package/dist/server.js.map +1 -1
  51. package/dist/testing/conformance.d.ts +65 -0
  52. package/dist/testing/conformance.d.ts.map +1 -0
  53. package/dist/testing/conformance.js +217 -0
  54. package/dist/testing/conformance.js.map +1 -0
  55. package/dist/testing/fake-harnesses.d.ts +101 -0
  56. package/dist/testing/fake-harnesses.d.ts.map +1 -0
  57. package/dist/testing/fake-harnesses.js +291 -0
  58. package/dist/testing/fake-harnesses.js.map +1 -0
  59. package/dist/testing/index.d.ts +5 -0
  60. package/dist/testing/index.d.ts.map +1 -0
  61. package/dist/testing/index.js +3 -0
  62. package/dist/testing/index.js.map +1 -0
  63. package/dist/types.d.ts +3 -39
  64. package/dist/types.d.ts.map +1 -1
  65. package/dist/types.js +2 -0
  66. package/dist/types.js.map +1 -1
  67. package/dist/waiter.d.ts +36 -0
  68. package/dist/waiter.d.ts.map +1 -0
  69. package/dist/waiter.js +92 -0
  70. package/dist/waiter.js.map +1 -0
  71. package/fakes/claude.mjs +450 -0
  72. package/fakes/codex.mjs +391 -0
  73. package/fakes/lib.mjs +507 -0
  74. package/package.json +7 -1
@@ -0,0 +1,291 @@
1
+ import { spawn } from 'node:child_process';
2
+ import { chmodSync, existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, renameSync, rmSync, writeFileSync, } from 'node:fs';
3
+ import { tmpdir } from 'node:os';
4
+ import { delimiter, dirname, join, resolve } from 'node:path';
5
+ import { setTimeout as sleep } from 'node:timers/promises';
6
+ import { fileURLToPath } from 'node:url';
7
+ /**
8
+ * The value a caller gave a variable on purpose: one in `base` that is not simply what the
9
+ * process running the tests has, as in `env({ ...process.env, COGITATOR_BRIDGE_HOME: mine })`.
10
+ */
11
+ function named(base, variable) {
12
+ const value = base?.[variable];
13
+ return value !== undefined && value !== process.env[variable] ? value : undefined;
14
+ }
15
+ const HARNESSES = ['claude', 'codex'];
16
+ const SURROUNDING_SESSION_VARIABLES = ['CLAUDE_CODE_SESSION_ID', 'CODEX_THREAD_ID'];
17
+ /**
18
+ * Folders code under test would otherwise look for in the home of the person running the tests:
19
+ * the bridge's own, and where Claude Code keeps its settings and the folders it trusts
20
+ */
21
+ const OWN_FOLDERS = {
22
+ COGITATOR_BRIDGE_HOME: 'bridge',
23
+ CLAUDE_CONFIG_DIR: 'claude-config',
24
+ };
25
+ const TRANSCRIPT_FOLDERS = { claude: 'sessions', codex: 'threads' };
26
+ const POLL_MS = 20;
27
+ const STOP_GRACE_MS = 5_000;
28
+ const DEFAULT_TURN_TIMEOUT_MS = 10_000;
29
+ /**
30
+ * Installs executable stand-ins of `claude` and `codex` for tests of code that drives the real
31
+ * command lines. Each call gets its own executables and its own state, `cleanup()` ends it.
32
+ */
33
+ export function installFakeHarnesses(options = {}) {
34
+ if (process.platform === 'win32') {
35
+ throw new Error('The fake claude and codex executables need a POSIX shell, win32 has none');
36
+ }
37
+ const { bin, home, created } = createFolders(options.dir);
38
+ for (const harness of HARNESSES)
39
+ writeWrapper(bin, harness);
40
+ const running = new Set();
41
+ const env = (base) => {
42
+ const merged = { ...withoutSurroundingSession(base ?? process.env), ...options.env };
43
+ return {
44
+ ...merged,
45
+ PATH: [bin, merged.PATH].filter(Boolean).join(delimiter),
46
+ FAKE_HARNESS_HOME: home,
47
+ ...Object.fromEntries(Object.entries(OWN_FOLDERS).map(([variable, folder]) => [
48
+ variable,
49
+ options.env?.[variable] ?? named(base, variable) ?? join(home, folder),
50
+ ])),
51
+ };
52
+ };
53
+ const run = (harness, args, options = {}) => execute(join(bin, harness), args, { ...options, env: { ...env(), ...options.env } }, running);
54
+ const succeed = async (harness, args, options) => {
55
+ const { code, stdout, stderr } = await run(harness, args, options);
56
+ if (code === 0)
57
+ return stdout.trim();
58
+ throw new Error(`fake ${harness} ${args.join(' ')} exited with ${code}: ${stderr.trim()}`);
59
+ };
60
+ const transcript = (harness, id) => readTranscript(join(home, harness, TRANSCRIPT_FOLDERS[harness]), id);
61
+ return {
62
+ bin,
63
+ home,
64
+ env,
65
+ run,
66
+ transcript,
67
+ trustFolder(folder) {
68
+ const file = join(home, 'claude', 'trusted.json');
69
+ const trusted = new Set([...stringsIn(readJson(file)), resolve(folder)]);
70
+ writeJson(file, [...trusted]);
71
+ },
72
+ async openClaudeWindow({ cwd, settings, name, env: extra }) {
73
+ const args = [
74
+ '__open',
75
+ ...(settings === undefined ? [] : ['--settings', settingsArgument(settings)]),
76
+ ...(name === undefined ? [] : ['--name', name]),
77
+ ];
78
+ return succeed('claude', args, { cwd, env: extra });
79
+ },
80
+ async say(sessionId, text) {
81
+ await succeed('claude', ['__say', sessionId, text]);
82
+ },
83
+ async claudeSessions({ all = false } = {}) {
84
+ const listing = await succeed('claude', ['agents', '--json', ...(all ? ['--all'] : [])]);
85
+ return JSON.parse(listing);
86
+ },
87
+ async openCodexThread({ cwd, owner = 'app' }) {
88
+ return succeed('codex', ['__open', '-C', cwd, '--owner', owner]);
89
+ },
90
+ async startCodexApp() {
91
+ await succeed('codex', ['__app', 'start']);
92
+ },
93
+ async stopCodexApp() {
94
+ await succeed('codex', ['__app', 'stop']);
95
+ },
96
+ async startCodexDaemon() {
97
+ await succeed('codex', ['app-server', 'daemon', 'start']);
98
+ },
99
+ async stopCodexDaemon() {
100
+ await succeed('codex', ['app-server', 'daemon', 'stop']);
101
+ },
102
+ async waitForTurn(harness, id, matches, waiting = {}) {
103
+ const { timeoutMs = DEFAULT_TURN_TIMEOUT_MS, what = 'a matching turn' } = waiting;
104
+ const deadline = Date.now() + timeoutMs;
105
+ for (;;) {
106
+ const turns = transcript(harness, id);
107
+ const found = turns.find(matches);
108
+ if (found)
109
+ return found;
110
+ if (Date.now() >= deadline) {
111
+ throw new Error(`Timed out after ${timeoutMs} ms waiting for ${what} of ${harness} ${id}, ` +
112
+ `turns seen: ${JSON.stringify(turns)}`);
113
+ }
114
+ await sleep(POLL_MS);
115
+ }
116
+ },
117
+ async cleanup() {
118
+ const started = [...running].map((child) => child.pid);
119
+ try {
120
+ await stopAll([...recordedPids(home), ...started].filter(isPid));
121
+ }
122
+ finally {
123
+ for (const folder of created)
124
+ rmSync(folder, { recursive: true, force: true });
125
+ }
126
+ },
127
+ };
128
+ }
129
+ /**
130
+ * The folders of one installation. The temp folder sits under `/tmp` where there is one: the
131
+ * temp folder of macOS is too deep for the unix sockets tests create next to it.
132
+ */
133
+ function createFolders(dir) {
134
+ if (dir === undefined) {
135
+ const base = existsSync('/tmp') ? '/tmp' : tmpdir();
136
+ const root = mkdtempSync(join(base, 'fake-harness-'));
137
+ return { ...createStateFolders(root), created: [root] };
138
+ }
139
+ const folders = createStateFolders(resolve(dir));
140
+ return { ...folders, created: [folders.bin, folders.home] };
141
+ }
142
+ function createStateFolders(root) {
143
+ const bin = join(root, 'bin');
144
+ const home = join(root, 'home');
145
+ mkdirSync(bin);
146
+ mkdirSync(home);
147
+ return { bin, home };
148
+ }
149
+ function shellQuote(text) {
150
+ return `'${text.replaceAll("'", `'\\''`)}'`;
151
+ }
152
+ function writeWrapper(bin, harness) {
153
+ const script = fileURLToPath(new URL(`../../fakes/${harness}.mjs`, import.meta.url));
154
+ const wrapper = join(bin, harness);
155
+ const command = `exec ${shellQuote(process.execPath)} ${shellQuote(script)} "$@"`;
156
+ writeFileSync(wrapper, `#!/bin/sh\n${command}\n`);
157
+ chmodSync(wrapper, 0o755);
158
+ }
159
+ function withoutSurroundingSession(base) {
160
+ const kept = Object.entries(base).filter(([name]) => !SURROUNDING_SESSION_VARIABLES.includes(name));
161
+ return Object.fromEntries(kept);
162
+ }
163
+ function settingsArgument(settings) {
164
+ return typeof settings === 'string' ? settings : JSON.stringify(settings);
165
+ }
166
+ function execute(file, args, options, running) {
167
+ const { cwd, env, input } = options;
168
+ return new Promise((resolveRun, rejectRun) => {
169
+ const stdin = input === undefined ? 'ignore' : 'pipe';
170
+ const child = spawn(file, args, { cwd, env, stdio: [stdin, 'pipe', 'pipe'] });
171
+ const output = { stdout: '', stderr: '' };
172
+ running.add(child);
173
+ child.stdout?.setEncoding('utf8').on('data', (chunk) => (output.stdout += chunk));
174
+ child.stderr?.setEncoding('utf8').on('data', (chunk) => (output.stderr += chunk));
175
+ child.on('error', (error) => {
176
+ running.delete(child);
177
+ rejectRun(error);
178
+ });
179
+ child.on('close', (code) => {
180
+ running.delete(child);
181
+ resolveRun({ code, ...output });
182
+ });
183
+ child.stdin?.on('error', () => undefined);
184
+ child.stdin?.end(input);
185
+ });
186
+ }
187
+ function readJson(file) {
188
+ try {
189
+ return JSON.parse(readFileSync(file, 'utf8'));
190
+ }
191
+ catch {
192
+ return undefined;
193
+ }
194
+ }
195
+ function writeJson(file, value) {
196
+ mkdirSync(dirname(file), { recursive: true });
197
+ const draft = `${file}.${process.pid}.tmp`;
198
+ writeFileSync(draft, JSON.stringify(value, null, 2));
199
+ renameSync(draft, file);
200
+ }
201
+ function stringsIn(value) {
202
+ const items = Array.isArray(value) ? value : [];
203
+ return items.filter((item) => typeof item === 'string');
204
+ }
205
+ function namesIn(folder) {
206
+ try {
207
+ return readdirSync(folder);
208
+ }
209
+ catch {
210
+ return [];
211
+ }
212
+ }
213
+ /** The transcript of the session or thread whose id is `id` or starts with it (a short id) */
214
+ function readTranscript(folder, id) {
215
+ const name = namesIn(folder).find((entry) => entry.startsWith(id) && entry.endsWith('.jsonl'));
216
+ if (name === undefined)
217
+ return [];
218
+ try {
219
+ const lines = readFileSync(join(folder, name), 'utf8').split('\n').slice(0, -1);
220
+ return lines.map((line) => JSON.parse(line));
221
+ }
222
+ catch {
223
+ return [];
224
+ }
225
+ }
226
+ function isPid(value) {
227
+ return typeof value === 'number' && Number.isInteger(value) && value > 1;
228
+ }
229
+ function pidsOf(record) {
230
+ if (typeof record !== 'object' || record === null)
231
+ return [];
232
+ const { pid, hookPids } = record;
233
+ const hooks = Array.isArray(hookPids) ? hookPids : [];
234
+ return [pid, ...hooks].filter(isPid);
235
+ }
236
+ /**
237
+ * The processes the state names: sessions, their running hooks, the daemon, the app and every
238
+ * `codex exec` in the middle of its turn
239
+ */
240
+ function recordedPids(home) {
241
+ const sessions = join(home, 'claude', 'sessions');
242
+ const threads = join(home, 'codex', 'threads');
243
+ const records = [
244
+ ...namesIn(sessions)
245
+ .filter((name) => name.endsWith('.json'))
246
+ .map((name) => join(sessions, name)),
247
+ join(home, 'codex', 'daemon.json'),
248
+ join(home, 'codex', 'app.json'),
249
+ ...namesIn(threads)
250
+ .filter((name) => name.endsWith('.pid'))
251
+ .map((name) => join(threads, name)),
252
+ ];
253
+ return records.flatMap((file) => pidsOf(readJson(file)));
254
+ }
255
+ function isAlive(pid) {
256
+ try {
257
+ process.kill(pid, 0);
258
+ return true;
259
+ }
260
+ catch (error) {
261
+ return error.code === 'EPERM';
262
+ }
263
+ }
264
+ /** Signals a process and, when it leads a process group as sessions and hooks do, its group */
265
+ function signal(pid, name) {
266
+ for (const target of [-pid, pid]) {
267
+ try {
268
+ process.kill(target, name);
269
+ }
270
+ catch { }
271
+ }
272
+ }
273
+ async function allGone(pids) {
274
+ const deadline = Date.now() + STOP_GRACE_MS;
275
+ while (pids.some(isAlive)) {
276
+ if (Date.now() >= deadline)
277
+ return false;
278
+ await sleep(POLL_MS);
279
+ }
280
+ return true;
281
+ }
282
+ async function stopAll(pids) {
283
+ for (const name of ['SIGTERM', 'SIGKILL']) {
284
+ for (const pid of pids.filter(isAlive))
285
+ signal(pid, name);
286
+ if (await allGone(pids))
287
+ return;
288
+ }
289
+ throw new Error(`Fake harness processes outlived SIGKILL: ${pids.filter(isAlive).join(', ')}`);
290
+ }
291
+ //# sourceMappingURL=fake-harnesses.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"fake-harnesses.js","sourceRoot":"","sources":["../../src/testing/fake-harnesses.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ export { adapterConformanceCases } from './conformance.js';
2
+ export type { AdapterConformanceCase, AdapterConformanceContext, AdapterConformanceTarget, AdapterFeature, AdapterScenario, } from './conformance.js';
3
+ export { installFakeHarnesses } from './fake-harnesses.js';
4
+ export type { FakeClaudeSession, FakeCommandRun, FakeHarnessOptions, FakeHarnesses, FakeTurn, } from './fake-harnesses.js';
5
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,YAAY,EACV,sBAAsB,EACtB,yBAAyB,EACzB,wBAAwB,EACxB,cAAc,EACd,eAAe,GAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,YAAY,EACV,iBAAiB,EACjB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,QAAQ,GACT,MAAM,qBAAqB,CAAC"}
@@ -0,0 +1,3 @@
1
+ export { adapterConformanceCases } from './conformance.js';
2
+ export { installFakeHarnesses } from './fake-harnesses.js';
3
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/testing/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAQ3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,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
@@ -0,0 +1 @@
1
+ {"version":3,"file":"waiter.d.ts","sourceRoot":"","sources":["../src/waiter.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjE,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,2CAA2C;IAC3C,MAAM,EAAE,cAAc,CAAC;IACvB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAClB,2EAA2E;IAC3E,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0BAA0B;IAC1B,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,MAAM,EAAE,SAAS,GAAG,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;IACtD,OAAO,EAAE,cAAc,EAAE,CAAC;IAC1B;;;OAGG;IACH,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC1B;AAiBD;;;;;;GAMG;AACH,wBAAsB,WAAW,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAwDzF;AAED,gGAAgG;AAChG,wBAAgB,QAAQ,CAAC,OAAO,EAAE,SAAS,cAAc,EAAE,GAAG,MAAM,CAEnE"}
package/dist/waiter.js ADDED
@@ -0,0 +1,92 @@
1
+ import { BridgeClient } from './client.js';
2
+ import { isBridgeError } from './errors.js';
3
+ import { MAX_WAIT_MS } from './inputs.js';
4
+ const DEFAULT_RETRY_MS = 2_000;
5
+ function pause(ms, signal) {
6
+ if (signal?.aborted)
7
+ return Promise.resolve();
8
+ return new Promise((resolve) => {
9
+ const done = () => {
10
+ clearTimeout(timer);
11
+ signal?.removeEventListener('abort', done);
12
+ resolve();
13
+ };
14
+ const timer = setTimeout(done, ms);
15
+ signal?.addEventListener('abort', done, { once: true });
16
+ });
17
+ }
18
+ /**
19
+ * Waits at the dispatcher for a session's mail, as the process a hook of the session runs. A
20
+ * dispatcher that does not run, or stops while the waiter waits, is waited for too: the session
21
+ * stays reachable across a restart of the dispatcher.
22
+ *
23
+ * @throws BridgeError what the dispatcher refuses the session for, other than not running
24
+ */
25
+ export async function waitForMail(options) {
26
+ const { signal } = options;
27
+ const deadline = Date.now() + Math.min(options.timeoutMs, MAX_WAIT_MS);
28
+ const retryMs = options.retryMs ?? DEFAULT_RETRY_MS;
29
+ const none = async () => undefined;
30
+ for (;;) {
31
+ const left = deadline - Date.now();
32
+ if (signal?.aborted)
33
+ return { reason: 'closed', letters: [], confirm: none };
34
+ if (left <= 0)
35
+ return { reason: 'timeout', letters: [], confirm: none };
36
+ let client;
37
+ try {
38
+ client = await BridgeClient.connect({
39
+ socketPath: options.socketPath,
40
+ caller: options.caller,
41
+ });
42
+ }
43
+ catch (error) {
44
+ if (!isBridgeError(error) || error.code !== 'not_running')
45
+ throw error;
46
+ await pause(Math.min(retryMs, left), signal);
47
+ continue;
48
+ }
49
+ if (signal?.aborted) {
50
+ await client.close();
51
+ return { reason: 'closed', letters: [], confirm: none };
52
+ }
53
+ const onAbort = () => void client.close();
54
+ signal?.addEventListener('abort', onAbort, { once: true });
55
+ try {
56
+ const waited = await client.wait({ timeoutMs: left });
57
+ if (waited.reason === 'letters') {
58
+ const ids = waited.letters.map((letter) => letter.id);
59
+ const connection = client;
60
+ return {
61
+ reason: 'letters',
62
+ letters: waited.letters,
63
+ confirm: async () => {
64
+ try {
65
+ await connection.delivered(ids);
66
+ }
67
+ finally {
68
+ await connection.close();
69
+ }
70
+ },
71
+ };
72
+ }
73
+ await client.close();
74
+ if (waited.reason !== 'closed')
75
+ return { reason: waited.reason, letters: [], confirm: none };
76
+ }
77
+ catch (error) {
78
+ await client.close().catch(() => undefined);
79
+ if (!isBridgeError(error) || error.code !== 'not_running')
80
+ throw error;
81
+ }
82
+ finally {
83
+ signal?.removeEventListener('abort', onAbort);
84
+ }
85
+ await pause(Math.min(retryMs, Math.max(0, deadline - Date.now())), signal);
86
+ }
87
+ }
88
+ /** The text a waiter hands its session: the letters, oldest first, each under its signature. */
89
+ export function mailText(letters) {
90
+ return letters.map((letter) => letter.text.trimEnd()).join('\n\n');
91
+ }
92
+ //# sourceMappingURL=waiter.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"waiter.js","sourceRoot":"","sources":["../src/waiter.ts"],"names":[],"mappings":"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"}