@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
@@ -1 +1 @@
1
- {"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
@@ -1,8 +1,9 @@
1
1
  import { EventEmitter } from 'node:events';
2
2
  import { type BridgeLimitsInput } from './guards.js';
3
- import { type CreateJobInput, type InboxInput, type SendLetterInput } from './inputs.js';
3
+ import { type CreateJobInput, type CreateJobResult, type InboxInput, type SendLetterInput, type SendLetterResult, type WaitInput, type WaitResult } from './inputs.js';
4
4
  import type { AgentFilter, BridgeStore, JobTaskFilter, JournalQuery, LetterFilter } from './store/store.js';
5
- import { type AgentRecord, type BridgeAdapter, type BridgeJob, type BridgeLimits, type CallerIdentity, type JobVerification, type JournalEntry, type Letter, type RenderedLetter } from './types.js';
5
+ import { type AgentRecord, type BridgeJob, type BridgeLimits, type CallerIdentity, type JobVerification, type JournalEntry, type Letter, type RenderedLetter } from './types.js';
6
+ import type { BridgeAdapter, BridgeCalls } from './adapter.js';
6
7
  export interface BridgeDispatcherOptions {
7
8
  store: BridgeStore;
8
9
  /** How the bridge reaches the sessions of each harness. A harness without one reads its inbox */
@@ -21,18 +22,7 @@ export interface BridgeDispatcherOptions {
21
22
  */
22
23
  assertWritable?: () => void;
23
24
  }
24
- export interface CreateJobResult {
25
- job: BridgeJob;
26
- letter: Letter;
27
- /** True when the job was created before with the same `letterId`, and nothing changed now */
28
- duplicate: boolean;
29
- }
30
- export interface SendLetterResult {
31
- letter: Letter;
32
- job: BridgeJob;
33
- /** True when the letter was sent before with the same id, and nothing changed now */
34
- duplicate: boolean;
35
- }
25
+ export type { CreateJobResult, SendLetterResult } from './inputs.js';
36
26
  export interface SweepResult {
37
27
  /** Jobs failed for running out of time or for a letter nobody reacted to */
38
28
  failed: number[];
@@ -45,6 +35,8 @@ export interface DispatcherStatus {
45
35
  queuedLetters: number;
46
36
  /** The harnesses the dispatcher has an adapter for */
47
37
  adapters: string[];
38
+ /** The agents with a waiter armed: a letter for one of them wakes its session at once */
39
+ waiting: string[];
48
40
  }
49
41
  export interface BridgeDispatcherEvents {
50
42
  /** Every entry of the journal, once what it tells is stored */
@@ -71,7 +63,7 @@ export interface BridgeDispatcherEvents {
71
63
  * await bridge.send(codex.name, { job: job.number, kind: 'report', body: 'Done: 14 tests' });
72
64
  * ```
73
65
  */
74
- export declare class BridgeDispatcher extends EventEmitter<BridgeDispatcherEvents> {
66
+ export declare class BridgeDispatcher extends EventEmitter<BridgeDispatcherEvents> implements BridgeCalls {
75
67
  readonly limits: BridgeLimits;
76
68
  private readonly store;
77
69
  private readonly tasks;
@@ -88,6 +80,18 @@ export declare class BridgeDispatcher extends EventEmitter<BridgeDispatcherEvent
88
80
  * adapter reports back, since it may have handed the job's first letter over itself
89
81
  */
90
82
  private readonly starting;
83
+ /** The waiter of each agent that has one, see `wait` */
84
+ private readonly waiters;
85
+ /**
86
+ * Letters somebody holds right now: a waiter that has not confirmed them yet, or an adapter in
87
+ * the middle of pushing one. Nobody else is given a letter in hand, so a session reached two
88
+ * ways does not get it twice
89
+ */
90
+ private readonly inHand;
91
+ /** What each harness with an adapter that lists its sessions said of them, see `checkPresence` */
92
+ private readonly presence;
93
+ private readonly listing;
94
+ private presenceCheckedAt;
91
95
  /** Set once `close` was called: nothing new is delivered, what runs is waited for */
92
96
  private closing;
93
97
  private closed;
@@ -125,6 +129,39 @@ export declare class BridgeDispatcher extends EventEmitter<BridgeDispatcherEvent
125
129
  * always comes first. `afterSeq` looks further than one call returns.
126
130
  */
127
131
  inbox(caller: string, input?: InboxInput): Promise<RenderedLetter[]>;
132
+ /**
133
+ * Waits for the caller's mail: answers at once when letters are queued for it, otherwise as
134
+ * soon as one arrives, or with none when `timeoutMs` passes. This is how a session nothing can
135
+ * be pushed into still wakes: a process of its harness waits here and hands what it gets to
136
+ * the session, as `cogitator bridge wait` does in a hook of Claude Code. The letters stay
137
+ * queued until the waiter says it handed them over (`delivered`), so a waiter that dies with
138
+ * them in hand loses nothing. A session has one waiter: a new one ends the one before it.
139
+ * Aborting `signal` ends the wait, as the socket server does when the connection closes.
140
+ */
141
+ wait(caller: string, input?: WaitInput, signal?: AbortSignal): Promise<WaitResult>;
142
+ /**
143
+ * Says the caller's waiter handed these letters to its session. A job handed over this way
144
+ * counts as taken, as one an adapter pushed does. A letter that is not queued any more, such
145
+ * as one the session read from its inbox meanwhile, stays as it is.
146
+ *
147
+ * @throws BridgeError `unknown_letter` for a letter that is not addressed to the caller
148
+ */
149
+ delivered(caller: string, letterIds: readonly string[]): Promise<Letter[]>;
150
+ private arm;
151
+ /**
152
+ * The letters queued for an agent that nobody holds, oldest first, as many as one answer
153
+ * carries.
154
+ */
155
+ private queuedFor;
156
+ private held;
157
+ /**
158
+ * Notes that a waiter was given these letters. They are in its hand until it confirms them,
159
+ * its connection closes, a newer waiter of the session takes over, or `deliveryTimeoutMs`
160
+ * passes, whichever comes first.
161
+ */
162
+ private hand;
163
+ /** Frees what the waiters of an agent hold: a newer waiter is about to take their place. */
164
+ private letGo;
128
165
  /**
129
166
  * Says the caller is done with a letter that needs no answer. A question, a permission request
130
167
  * and a job's first letter are not dismissed this way: they are marked read, and are done with
@@ -168,6 +205,18 @@ export declare class BridgeDispatcher extends EventEmitter<BridgeDispatcherEvent
168
205
  * the deliveries that are due again. The host calls it on a timer.
169
206
  */
170
207
  sweep(): Promise<SweepResult>;
208
+ /**
209
+ * Asks the adapters that can list their sessions which of them still run, once in
210
+ * `limits.presenceCheckMs`. A session that was listed and then is not, two times in a row, is
211
+ * gone, and its jobs fail with that reason rather than after the reply timeout: one miss may
212
+ * be a session between two states of its harness. A session with a waiter armed is there
213
+ * whatever the list says. One that was never listed (its harness shows it nowhere) is left to
214
+ * the idle rule, unless the adapter runs every session of its harness itself (`ownsSessions`):
215
+ * then what it does not list is gone at once. A session heard from after the list was asked
216
+ * for is not judged by it: it may have started meanwhile.
217
+ */
218
+ private checkPresence;
219
+ private applyPresence;
171
220
  /**
172
221
  * Takes sessions that are not there out of the address book, so a harness word keeps reaching
173
222
  * the session that is: one whose start never finished (the dispatcher that started it is
@@ -180,8 +229,9 @@ export declare class BridgeDispatcher extends EventEmitter<BridgeDispatcherEvent
180
229
  /** Resolves once every call made so far is handled and every delivery it started has ended. */
181
230
  idle(): Promise<void>;
182
231
  /**
183
- * Waits for the calls being handled, the deliveries and the session starts they began, then
184
- * takes no more. A delivery that hangs is given up on after `limits.deliveryTimeoutMs` and a
232
+ * Ends the waits, waits for the calls being handled, the deliveries and the session starts they
233
+ * began, closes the adapters, then takes no more. A session a call asks for after this began
234
+ * is not started: the next dispatcher finds it never started and fails its job. A delivery that hangs is given up on after `limits.deliveryTimeoutMs` and a
185
235
  * session start after `limits.sessionStartTimeoutMs`, so this always ends.
186
236
  */
187
237
  close(): Promise<void>;
@@ -1 +1 @@
1
- {"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../src/dispatcher.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../src/dispatcher.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK3C,OAAO,EAOL,KAAK,iBAAiB,EACvB,MAAM,aAAa,CAAC;AACrB,OAAO,EAcL,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,gBAAgB,EAErB,KAAK,SAAS,EACd,KAAK,UAAU,EAChB,MAAM,aAAa,CAAC;AAerB,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,EACZ,YAAY,EACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAQL,KAAK,WAAW,EAChB,KAAK,SAAS,EAEd,KAAK,YAAY,EACjB,KAAK,cAAc,EAGnB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,MAAM,EAEX,KAAK,cAAc,EACpB,MAAM,YAAY,CAAC;AACpB,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAkB,MAAM,cAAc,CAAC;AAE/E,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,WAAW,CAAC;IACnB,iGAAiG;IACjG,QAAQ,CAAC,EAAE,SAAS,aAAa,EAAE,CAAC;IACpC,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;IACnB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,MAAM,CAAC;IAC3B,qFAAqF;IACrF,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IACjC;;;;OAIG;IACH,cAAc,CAAC,EAAE,MAAM,IAAI,CAAC;CAC7B;AAED,YAAY,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAErE,MAAM,WAAW,WAAW;IAC1B,4EAA4E;IAC5E,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,sDAAsD;IACtD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,yFAAyF;IACzF,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,sBAAsB;IACrC,+DAA+D;IAC/D,OAAO,EAAE,CAAC,YAAY,CAAC,CAAC;CACzB;AAiID;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,qBAAa,gBAAiB,SAAQ,YAAY,CAAC,sBAAsB,CAAE,YAAW,WAAW;IAC/F,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAoC;IAC7D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAe;IACxC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAyB;IACjD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA2B;IAC1D,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoC;IAC/D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4B;IACvD;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAqB;IAC9C,wDAAwD;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD;;;;OAIG;IACH,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA2B;IAClD,kGAAkG;IAClG,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA+B;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,iBAAiB,CAA4B;IACrD,qFAAqF;IACrF,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,MAAM,CAAS;gBAEX,OAAO,EAAE,uBAAuB;IAmB5C;;;;OAIG;IACG,QAAQ,CAAC,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC;IAiF9D;;;;;;OAMG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,eAAe,CAAC;IAgKhF;;;;;;;OAOG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,gBAAgB,CAAC;IAuJ7E;;;;;;;;OAQG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,UAAe,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAwC9E;;;;;;;;OAQG;IACG,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,GAAE,SAAc,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAuB5F;;;;;;OAMG;IACG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAwBhF,OAAO,CAAC,GAAG;IAwBX;;;OAGG;IACH,OAAO,CAAC,SAAS;IASjB,OAAO,CAAC,IAAI;IAQZ;;;;OAIG;IACH,OAAO,CAAC,IAAI;IAsBZ,4FAA4F;IAC5F,OAAO,CAAC,KAAK;IAMb;;;;;;OAMG;IACG,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAqBpE;;;;;OAKG;IACG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IA8BjF;;;;OAIG;IACG,kBAAkB,CACtB,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,GAAG,SAAS,CAAC,GAC1D,OAAO,CAAC,SAAS,CAAC;IAsBrB,wCAAwC;IAClC,GAAG,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAI7C,oEAAoE;IAC9D,IAAI,CAAC,MAAM,GAAE,aAAkB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC;IAStD,MAAM,CAAC,MAAM,GAAE,WAAgB,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAK9D;;;OAGG;IACG,OAAO,CAAC,MAAM,GAAE,YAAiB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAU3D;;;OAGG;IACG,WAAW,CAAC,KAAK,GAAE,YAAiB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAgB9D,MAAM,IAAI,OAAO,CAAC,gBAAgB,CAAC;IAUzC;;;;OAIG;IACG,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;IAkEnC;;;;;;;;;OASG;IACH,OAAO,CAAC,aAAa;YA+BP,aAAa;IAyB3B;;;;;OAKG;YACW,YAAY;IA+B1B,uFAAuF;YACzE,SAAS;IAavB,+FAA+F;IACzF,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B;;;;;OAKG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgB5B,OAAO,CAAC,GAAG;IAIX,OAAO,CAAC,SAAS;YASH,OAAO;IAOrB,OAAO,CAAC,MAAM;IAId;;;OAGG;IACH,OAAO,CAAC,QAAQ;YAOF,QAAQ;IAoBtB,OAAO,CAAC,OAAO;IAIf;;;OAGG;IACH,OAAO,CAAC,SAAS;IAajB,OAAO,CAAC,aAAa;IAYrB,OAAO,CAAC,UAAU;IAQlB,OAAO,CAAC,OAAO;YAMD,WAAW;YASX,UAAU;YAyBV,MAAM;YAQN,OAAO;YAYP,SAAS;IAevB,mGAAmG;YACrF,cAAc;IAgB5B;;;;OAIG;IACH,OAAO,CAAC,eAAe;IAuDvB;;;OAGG;IACH,OAAO,CAAC,YAAY;IAWpB,OAAO,CAAC,MAAM;IA6Bd,sGAAsG;IACtG,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,cAAc;IA6DtB,OAAO,CAAC,QAAQ;IAchB,OAAO,CAAC,WAAW;IAkBnB;;;;OAIG;YACW,aAAa;IA0B3B,OAAO,CAAC,KAAK;IAOb,mGAAmG;IACnG,OAAO,CAAC,IAAI;YAWE,SAAS;IAyDvB,OAAO,CAAC,cAAc;IA0BtB,OAAO,CAAC,YAAY;IASpB,OAAO,CAAC,WAAW;YASL,eAAe;CAyE9B"}
@@ -3,10 +3,10 @@ import { isAbsolute, resolve as resolvePath } from 'node:path';
3
3
  import { TaskManager, textPart, toMessage } from '@cogitator-ai/a2a';
4
4
  import { BridgeError } from './errors.js';
5
5
  import { deliveryBackoff, exhaustedBudget, formatDuration, nextDepth, resolveBudget, resolveLimits, } from './guards.js';
6
- import { AgentsFilterSchema, CreateJobInputSchema, DEFAULT_INBOX_LIMIT, DEFAULT_LIST_LIMIT, InboxInputSchema, JobsFilterSchema, JournalQuerySchema, LettersFilterSchema, SendLetterInputSchema, VerificationInputSchema, } from './inputs.js';
6
+ import { AgentsFilterSchema, CreateJobInputSchema, DEFAULT_INBOX_LIMIT, DEFAULT_LIST_LIMIT, DEFAULT_WAIT_MS, DeliveredInputSchema, InboxInputSchema, JobsFilterSchema, JournalQuerySchema, LettersFilterSchema, SendLetterInputSchema, VerificationInputSchema, WaitInputSchema, } from './inputs.js';
7
7
  import { isFinishedJobState, jobOf, jobRecordOf } from './job-record.js';
8
8
  import { expectationOf, forHistory, newLetterId, normalizeBody, oneLine, quoted, renderLetter, repeats, titleOf, } from './letters.js';
9
- import { findCheckoutRoot, findProjectRoot, isInside } from './paths.js';
9
+ import { canonicalPath, findCheckoutRoot, findProjectRoot, isInside } from './paths.js';
10
10
  import { allocateAgentName, resolveAddress } from './registry.js';
11
11
  import { BRIDGE_JOB_KEY, BRIDGE_SENDER, CallerIdentitySchema, DEFAULT_LIMITS, HarnessNameSchema, INBOX_DELIVERY, NO_CAPABILITIES, } from './types.js';
12
12
  const ACTIVE_JOB_STATES = ['submitted', 'working', 'input-required'];
@@ -118,6 +118,18 @@ export class BridgeDispatcher extends EventEmitter {
118
118
  * adapter reports back, since it may have handed the job's first letter over itself
119
119
  */
120
120
  starting = new Set();
121
+ /** The waiter of each agent that has one, see `wait` */
122
+ waiters = new Map();
123
+ /**
124
+ * Letters somebody holds right now: a waiter that has not confirmed them yet, or an adapter in
125
+ * the middle of pushing one. Nobody else is given a letter in hand, so a session reached two
126
+ * ways does not get it twice
127
+ */
128
+ inHand = new Map();
129
+ /** What each harness with an adapter that lists its sessions said of them, see `checkPresence` */
130
+ presence = new Map();
131
+ listing = new Set();
132
+ presenceCheckedAt = Number.NEGATIVE_INFINITY;
121
133
  /** Set once `close` was called: nothing new is delivered, what runs is waited for */
122
134
  closing = false;
123
135
  closed = false;
@@ -137,6 +149,8 @@ export class BridgeDispatcher extends EventEmitter {
137
149
  }
138
150
  this.adapters.set(harness, adapter);
139
151
  }
152
+ for (const adapter of this.adapters.values())
153
+ adapter.attach?.(this);
140
154
  }
141
155
  /**
142
156
  * Puts the calling session into the address book, or finds it there. A session is known by
@@ -147,8 +161,8 @@ export class BridgeDispatcher extends EventEmitter {
147
161
  const caller = parse(CallerIdentitySchema, identity, 'Cannot register the session');
148
162
  return this.mutate(async (tx) => {
149
163
  const now = this.iso();
150
- const cwd = resolvePath(caller.cwd);
151
- const project = caller.project ? resolvePath(caller.project) : findProjectRoot(cwd);
164
+ const cwd = canonicalPath(caller.cwd);
165
+ const project = canonicalPath(caller.project ?? findProjectRoot(cwd));
152
166
  const adapter = this.adapters.get(caller.harness);
153
167
  const reach = {
154
168
  delivery: adapter?.delivery ?? INBOX_DELIVERY,
@@ -278,9 +292,7 @@ export class BridgeDispatcher extends EventEmitter {
278
292
  }
279
293
  const budget = resolveBudget(request.budget, this.limits);
280
294
  const cwd = request.cwd
281
- ? isAbsolute(request.cwd)
282
- ? resolvePath(request.cwd)
283
- : resolvePath(from.cwd, request.cwd)
295
+ ? canonicalPath(isAbsolute(request.cwd) ? request.cwd : resolvePath(from.cwd, request.cwd))
284
296
  : from.cwd;
285
297
  if (!isInside(from.project, cwd) && !isInside(findCheckoutRoot(from.cwd), cwd)) {
286
298
  throw new BridgeError('invalid_input', `A job is done inside the project it is handed over in (${from.project}) or the checkout you work in, and ${cwd} is outside both`, { cwd, project: from.project });
@@ -536,6 +548,128 @@ export class BridgeDispatcher extends EventEmitter {
536
548
  return rendered;
537
549
  });
538
550
  }
551
+ /**
552
+ * Waits for the caller's mail: answers at once when letters are queued for it, otherwise as
553
+ * soon as one arrives, or with none when `timeoutMs` passes. This is how a session nothing can
554
+ * be pushed into still wakes: a process of its harness waits here and hands what it gets to
555
+ * the session, as `cogitator bridge wait` does in a hook of Claude Code. The letters stay
556
+ * queued until the waiter says it handed them over (`delivered`), so a waiter that dies with
557
+ * them in hand loses nothing. A session has one waiter: a new one ends the one before it.
558
+ * Aborting `signal` ends the wait, as the socket server does when the connection closes.
559
+ */
560
+ async wait(caller, input = {}, signal) {
561
+ const request = parse(WaitInputSchema, input, 'Cannot wait for letters');
562
+ const limit = request.limit ?? DEFAULT_INBOX_LIMIT;
563
+ const outcome = await this.asCaller(caller, async () => {
564
+ const agent = this.requireCaller(caller);
565
+ this.waiters.get(agent.name)?.end('replaced');
566
+ this.letGo(agent.name);
567
+ if (signal?.aborted || this.closing)
568
+ return { letters: [], reason: 'closed' };
569
+ const letters = this.starting.has(agent.name) ? [] : this.queuedFor(agent.name, limit);
570
+ if (letters.length > 0) {
571
+ this.hand(agent.name, letters, signal);
572
+ return { letters, reason: 'letters' };
573
+ }
574
+ return {
575
+ later: this.arm(agent.name, limit, request.timeoutMs ?? DEFAULT_WAIT_MS, signal),
576
+ };
577
+ });
578
+ return 'later' in outcome ? outcome.later : outcome;
579
+ }
580
+ /**
581
+ * Says the caller's waiter handed these letters to its session. A job handed over this way
582
+ * counts as taken, as one an adapter pushed does. A letter that is not queued any more, such
583
+ * as one the session read from its inbox meanwhile, stays as it is.
584
+ *
585
+ * @throws BridgeError `unknown_letter` for a letter that is not addressed to the caller
586
+ */
587
+ async delivered(caller, letterIds) {
588
+ const { letters: ids } = parse(DeliveredInputSchema, { letters: [...letterIds] }, 'Cannot mark the letters delivered');
589
+ return this.asCaller(caller, async (tx) => {
590
+ const agent = this.requireCaller(caller);
591
+ const marked = [];
592
+ for (const id of new Set(ids)) {
593
+ if (this.store.getLetter(id)?.to !== agent.name) {
594
+ throw new BridgeError('unknown_letter', `There is no letter ${id} addressed to you`, {
595
+ letter: id,
596
+ });
597
+ }
598
+ await this.markDelivered(tx, id, { via: 'wait' });
599
+ const letter = this.store.getLetter(id);
600
+ if (letter)
601
+ marked.push(letter);
602
+ }
603
+ tx.wake.add(agent.name);
604
+ return marked;
605
+ });
606
+ }
607
+ arm(name, limit, timeoutMs, signal) {
608
+ return new Promise((resolve) => {
609
+ const waiter = {
610
+ limit,
611
+ signal,
612
+ end: (reason, letters = []) => {
613
+ if (this.waiters.get(name) === waiter)
614
+ this.waiters.delete(name);
615
+ clearTimeout(timer);
616
+ signal?.removeEventListener('abort', onAbort);
617
+ resolve({ letters, reason });
618
+ },
619
+ };
620
+ const timer = setTimeout(() => waiter.end('timeout'), timeoutMs);
621
+ const onAbort = () => waiter.end('closed');
622
+ signal?.addEventListener('abort', onAbort, { once: true });
623
+ this.waiters.set(name, waiter);
624
+ });
625
+ }
626
+ /**
627
+ * The letters queued for an agent that nobody holds, oldest first, as many as one answer
628
+ * carries.
629
+ */
630
+ queuedFor(name, limit) {
631
+ const queued = this.store
632
+ .listLetters({ to: name, states: ['queued'], limit })
633
+ .filter((letter) => !this.held(letter.id));
634
+ return fitting(queued, (letter) => 2 * letter.body.length).map((letter) => renderLetter(letter, this.requireJob(letter.job).job));
635
+ }
636
+ held(letterId) {
637
+ const holder = this.inHand.get(letterId);
638
+ if (!holder)
639
+ return false;
640
+ if (holder.until > this.now())
641
+ return true;
642
+ this.inHand.delete(letterId);
643
+ return false;
644
+ }
645
+ /**
646
+ * Notes that a waiter was given these letters. They are in its hand until it confirms them,
647
+ * its connection closes, a newer waiter of the session takes over, or `deliveryTimeoutMs`
648
+ * passes, whichever comes first.
649
+ */
650
+ hand(name, letters, signal) {
651
+ const holder = { agent: name, until: this.now() + this.limits.deliveryTimeoutMs };
652
+ for (const letter of letters)
653
+ this.inHand.set(letter.id, holder);
654
+ signal?.addEventListener('abort', () => {
655
+ let dropped = false;
656
+ for (const letter of letters) {
657
+ if (this.inHand.get(letter.id) !== holder)
658
+ continue;
659
+ this.inHand.delete(letter.id);
660
+ dropped = true;
661
+ }
662
+ if (dropped)
663
+ this.wakeIfKnown(name);
664
+ }, { once: true });
665
+ }
666
+ /** Frees what the waiters of an agent hold: a newer waiter is about to take their place. */
667
+ letGo(name) {
668
+ for (const [letterId, holder] of this.inHand) {
669
+ if (holder.agent === name && !holder.pushing)
670
+ this.inHand.delete(letterId);
671
+ }
672
+ }
539
673
  /**
540
674
  * Says the caller is done with a letter that needs no answer. A question, a permission request
541
675
  * and a job's first letter are not dismissed this way: they are marked read, and are done with
@@ -660,6 +794,7 @@ export class BridgeDispatcher extends EventEmitter {
660
794
  activeJobs: this.store.jobTasks({ states: ACTIVE_JOB_STATES }).length,
661
795
  queuedLetters: this.store.countLetters({ states: ['queued'] }),
662
796
  adapters: [...this.adapters.keys()],
797
+ waiting: [...this.waiters.keys()].sort(),
663
798
  }));
664
799
  }
665
800
  /**
@@ -719,8 +854,58 @@ export class BridgeDispatcher extends EventEmitter {
719
854
  tx.wake.add(agent);
720
855
  return { failed: [...new Set(failed)], reminded };
721
856
  });
857
+ this.checkPresence();
722
858
  return result;
723
859
  }
860
+ /**
861
+ * Asks the adapters that can list their sessions which of them still run, once in
862
+ * `limits.presenceCheckMs`. A session that was listed and then is not, two times in a row, is
863
+ * gone, and its jobs fail with that reason rather than after the reply timeout: one miss may
864
+ * be a session between two states of its harness. A session with a waiter armed is there
865
+ * whatever the list says. One that was never listed (its harness shows it nowhere) is left to
866
+ * the idle rule, unless the adapter runs every session of its harness itself (`ownsSessions`):
867
+ * then what it does not list is gone at once. A session heard from after the list was asked
868
+ * for is not judged by it: it may have started meanwhile.
869
+ */
870
+ checkPresence() {
871
+ if (this.closing)
872
+ return;
873
+ const now = this.now();
874
+ if (now - this.presenceCheckedAt < this.limits.presenceCheckMs)
875
+ return;
876
+ this.presenceCheckedAt = now;
877
+ for (const [harness, adapter] of this.adapters) {
878
+ if (!adapter.liveSessions || this.listing.has(harness))
879
+ continue;
880
+ this.listing.add(harness);
881
+ const asked = now;
882
+ this.track(within(adapter.liveSessions(), this.limits.deliveryTimeoutMs, `Listing the ${harness} sessions`)
883
+ .then((sessions) => this.mutate((tx) => this.applyPresence(tx, harness, new Set(sessions.map((session) => session.sessionId)), adapter.ownsSessions === true, asked)))
884
+ .finally(() => this.listing.delete(harness)));
885
+ }
886
+ }
887
+ async applyPresence(tx, harness, live, certain, asked) {
888
+ const known = this.presence.get(harness) ?? { live, seen: new Set(), missed: new Set() };
889
+ const missed = new Set();
890
+ for (const sessionId of live)
891
+ known.seen.add(sessionId);
892
+ for (const agent of this.store.listAgents({ harness, statuses: ['active'] })) {
893
+ const id = agent.sessionId;
894
+ if (live.has(id) || this.waiters.has(agent.name) || this.starting.has(agent.name))
895
+ continue;
896
+ if (Date.parse(agent.lastSeenAt) >= asked)
897
+ continue;
898
+ if (!certain && !known.seen.has(id))
899
+ continue;
900
+ if (!certain && !known.missed.has(id)) {
901
+ missed.add(id);
902
+ continue;
903
+ }
904
+ known.seen.delete(id);
905
+ await this.agentGone(tx, agent, `the session of ${agent.name} is not running any more`);
906
+ }
907
+ this.presence.set(harness, { live, seen: known.seen, missed });
908
+ }
724
909
  /**
725
910
  * Takes sessions that are not there out of the address book, so a harness word keeps reaching
726
911
  * the session that is: one whose start never finished (the dispatcher that started it is
@@ -739,6 +924,10 @@ export class BridgeDispatcher extends EventEmitter {
739
924
  seenBefore: now - this.limits.agentIdleMs,
740
925
  });
741
926
  for (const agent of silent) {
927
+ if (this.waiters.has(agent.name))
928
+ continue;
929
+ if (this.presence.get(agent.harness)?.live.has(agent.sessionId))
930
+ continue;
742
931
  const busy = this.store.jobTasks({ party: agent.name, states: ACTIVE_JOB_STATES, limit: 1 });
743
932
  if (busy.length > 0)
744
933
  continue;
@@ -776,13 +965,24 @@ export class BridgeDispatcher extends EventEmitter {
776
965
  }
777
966
  }
778
967
  /**
779
- * Waits for the calls being handled, the deliveries and the session starts they began, then
780
- * takes no more. A delivery that hangs is given up on after `limits.deliveryTimeoutMs` and a
968
+ * Ends the waits, waits for the calls being handled, the deliveries and the session starts they
969
+ * began, closes the adapters, then takes no more. A session a call asks for after this began
970
+ * is not started: the next dispatcher finds it never started and fails its job. A delivery that hangs is given up on after `limits.deliveryTimeoutMs` and a
781
971
  * session start after `limits.sessionStartTimeoutMs`, so this always ends.
782
972
  */
783
973
  async close() {
784
974
  this.closing = true;
975
+ for (const waiter of [...this.waiters.values()])
976
+ waiter.end('closed');
785
977
  await this.idle();
978
+ await Promise.all([...this.adapters.values()].map(async (adapter) => {
979
+ try {
980
+ await adapter.close?.();
981
+ }
982
+ catch (error) {
983
+ this.onError(asError(error));
984
+ }
985
+ }));
786
986
  this.closed = true;
787
987
  }
788
988
  iso(ms = this.now()) {
@@ -827,8 +1027,10 @@ export class BridgeDispatcher extends EventEmitter {
827
1027
  this.onError(asError(error));
828
1028
  }
829
1029
  }
830
- for (const spawn of tx.spawns)
831
- this.startSession(spawn.agent, spawn.job, spawn.letter);
1030
+ if (!this.closing) {
1031
+ for (const spawn of tx.spawns)
1032
+ this.startSession(spawn.agent, spawn.job, spawn.letter);
1033
+ }
832
1034
  for (const agent of tx.wake)
833
1035
  this.wake(agent);
834
1036
  return result;
@@ -1112,7 +1314,8 @@ export class BridgeDispatcher extends EventEmitter {
1112
1314
  * taken: the harness has it and woke the session, which may work without calling the bridge
1113
1315
  * until it reports. The letter is read only once the session calls about the job.
1114
1316
  */
1115
- async markDelivered(tx, letterId) {
1317
+ async markDelivered(tx, letterId, data) {
1318
+ this.inHand.delete(letterId);
1116
1319
  const letter = this.store.getLetter(letterId);
1117
1320
  if (letter?.state !== 'queued')
1118
1321
  return;
@@ -1127,6 +1330,7 @@ export class BridgeDispatcher extends EventEmitter {
1127
1330
  job: letter.job,
1128
1331
  letter: letter.id,
1129
1332
  agent: letter.to,
1333
+ ...(data && { data }),
1130
1334
  });
1131
1335
  if (taken && this.requireJob(letter.job).job.state === 'submitted') {
1132
1336
  await this.transition(tx, letter.job, 'working');
@@ -1160,8 +1364,18 @@ export class BridgeDispatcher extends EventEmitter {
1160
1364
  const agent = this.store.getAgent(name);
1161
1365
  if (agent?.status !== 'active')
1162
1366
  return undefined;
1367
+ const waiter = this.waiters.get(name);
1368
+ if (waiter) {
1369
+ const letters = this.queuedFor(name, waiter.limit);
1370
+ if (letters.length > 0) {
1371
+ this.hand(name, letters, waiter.signal);
1372
+ waiter.end('letters', letters);
1373
+ }
1374
+ return undefined;
1375
+ }
1163
1376
  const adapter = this.adapters.get(agent.harness);
1164
- if (!adapter?.capabilities.push)
1377
+ const deliver = adapter?.capabilities.push ? adapter.deliver?.bind(adapter) : undefined;
1378
+ if (!deliver)
1165
1379
  return undefined;
1166
1380
  const letter = this.store.listLetters({
1167
1381
  to: name,
@@ -1169,23 +1383,32 @@ export class BridgeDispatcher extends EventEmitter {
1169
1383
  attemptsBelow: this.limits.deliveryAttempts,
1170
1384
  limit: 1,
1171
1385
  })[0];
1172
- if (!letter)
1386
+ if (!letter || this.held(letter.id))
1173
1387
  return undefined;
1174
1388
  if (letter.nextAttemptAt && Date.parse(letter.nextAttemptAt) > this.now())
1175
1389
  return undefined;
1176
1390
  const { job } = this.requireJob(letter.job);
1177
- return { agent, adapter, job, letter: renderLetter(letter, job) };
1391
+ this.inHand.set(letter.id, {
1392
+ agent: name,
1393
+ until: this.now() + this.limits.deliveryTimeoutMs,
1394
+ pushing: true,
1395
+ });
1396
+ return { agent, deliver, job, letter: renderLetter(letter, job) };
1178
1397
  });
1179
1398
  if (!next)
1180
1399
  return;
1400
+ let note;
1181
1401
  try {
1182
- await within(next.adapter.deliver({ agent: next.agent, letter: next.letter, job: next.job }), this.limits.deliveryTimeoutMs, `Delivering the letter ${next.letter.id} to ${name}`);
1402
+ const receipt = await within(next.deliver({ agent: next.agent, letter: next.letter, job: next.job }), this.limits.deliveryTimeoutMs, `Delivering the letter ${next.letter.id} to ${name}`);
1403
+ note = receipt?.note;
1183
1404
  }
1184
1405
  catch (error) {
1406
+ this.inHand.delete(next.letter.id);
1185
1407
  await this.mutate(async (tx) => this.deliveryFailed(tx, next.letter.id, asError(error)));
1186
1408
  return;
1187
1409
  }
1188
- await this.mutate((tx) => this.markDelivered(tx, next.letter.id));
1410
+ this.inHand.delete(next.letter.id);
1411
+ await this.mutate((tx) => this.markDelivered(tx, next.letter.id, note ? { note } : undefined));
1189
1412
  }
1190
1413
  }
1191
1414
  deliveryFailed(tx, letterId, error) {