@cotal-ai/connector-core 0.73.0 → 0.76.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 (43) hide show
  1. package/dist/agent.d.ts +27 -2
  2. package/dist/agent.d.ts.map +1 -1
  3. package/dist/agent.js +118 -31
  4. package/dist/agent.js.map +1 -1
  5. package/dist/agui-wal-path.d.ts +3 -5
  6. package/dist/agui-wal-path.d.ts.map +1 -1
  7. package/dist/agui-wal-path.js +3 -5
  8. package/dist/agui-wal-path.js.map +1 -1
  9. package/dist/config.d.ts +9 -0
  10. package/dist/config.d.ts.map +1 -1
  11. package/dist/config.js +27 -7
  12. package/dist/config.js.map +1 -1
  13. package/dist/control.d.ts.map +1 -1
  14. package/dist/control.js +2 -13
  15. package/dist/control.js.map +1 -1
  16. package/dist/docs-bundle.generated.d.ts +1 -1
  17. package/dist/docs-bundle.generated.js +21 -21
  18. package/dist/docs-bundle.generated.js.map +1 -1
  19. package/dist/durable-source.d.ts +1 -2
  20. package/dist/durable-source.d.ts.map +1 -1
  21. package/dist/durable-source.js +1 -2
  22. package/dist/durable-source.js.map +1 -1
  23. package/dist/event-wal.js +1 -1
  24. package/dist/event-wal.js.map +1 -1
  25. package/dist/framing.d.ts.map +1 -1
  26. package/dist/framing.js +3 -1
  27. package/dist/framing.js.map +1 -1
  28. package/dist/launch.d.ts +3 -2
  29. package/dist/launch.d.ts.map +1 -1
  30. package/dist/launch.js +6 -5
  31. package/dist/launch.js.map +1 -1
  32. package/dist/manager-call.d.ts +1 -6
  33. package/dist/manager-call.d.ts.map +1 -1
  34. package/dist/manager-call.js +9 -34
  35. package/dist/manager-call.js.map +1 -1
  36. package/dist/subject-frontier.d.ts +3 -6
  37. package/dist/subject-frontier.d.ts.map +1 -1
  38. package/dist/subject-frontier.js +35 -49
  39. package/dist/subject-frontier.js.map +1 -1
  40. package/dist/tool-specs.d.ts.map +1 -1
  41. package/dist/tool-specs.js +86 -2
  42. package/dist/tool-specs.js.map +1 -1
  43. package/package.json +3 -2
package/dist/agent.d.ts CHANGED
@@ -48,6 +48,10 @@ export interface InboxItem {
48
48
  text: string;
49
49
  replyTo?: string;
50
50
  contextId?: string;
51
+ /** How many times the broker has delivered this copy, 1 on the first; absent on a live copy.
52
+ * Broker-derived, never read from the payload: above 1, an earlier delivery of this message went
53
+ * unacked past its ack wait and may have run, here or on another reader. */
54
+ deliveryCount?: number;
51
55
  }
52
56
  /** Reply correlation for outgoing messages (SPEC §5): `contextId` is the asker's conversation id,
53
57
  * `replyTo` the id of the message being answered. */
@@ -125,6 +129,8 @@ export declare class MeshAgent extends EventEmitter {
125
129
  /** Surfaced to the host but not yet committed or abandoned, counted per holding frame because
126
130
  * frames overlap. See {@link holdInFlight}. */
127
131
  private inFlightIds;
132
+ /** Ack-wait renewal timers of held durable deliveries, by receive key. See {@link keepOwned}. */
133
+ private renewals;
128
134
  private classificationUnsafe;
129
135
  /** Terminal receive-time decisions that must survive the live→durable transition: successfully
130
136
  * surfaced pull-only messages and hard drops under muted/focus. Capacity loss degrades the
@@ -354,8 +360,12 @@ export declare class MeshAgent extends EventEmitter {
354
360
  private answering;
355
361
  /** Begin connecting with background retry. Resolves after the first completed mesh join. */
356
362
  start(retryMs?: number): Promise<void>;
363
+ private consumerClaim?;
364
+ private connectFlight?;
357
365
  private connectLoop;
366
+ private stopFlight?;
358
367
  stop(): Promise<void>;
368
+ private stopOnce;
359
369
  /** Manual reconnect: tear down the mesh connection and rebuild it in-process, WITHOUT
360
370
  * stopping the agent (the recovery path, so it does NOT assert connected). Delegates to
361
371
  * {@link CotalEndpoint.reconnect}, which is serialized with the self-heal supervisor and
@@ -411,8 +421,8 @@ export declare class MeshAgent extends EventEmitter {
411
421
  /** Return pending messages in stable receive order. Automatic delivery excludes quiet ambient;
412
422
  * pull-only is the explicit cotal_inbox lane. */
413
423
  peekInbox(scope?: InboxScope): InboxItem[];
414
- /** Mark a surfaced batch as mid-delivery, so the overflow valve will not ack it out from under the
415
- * host. Pair with {@link releaseInFlight} on the delivery verdict, whichever way it goes.
424
+ /** Mark a surfaced batch as mid-delivery, so the overflow valve will not evict it out from under
425
+ * the host. Pair with {@link releaseInFlight} on the delivery verdict, whichever way it goes.
416
426
  *
417
427
  * **Counted, not a set.** Hook frames overlap, so the same id is routinely in two open batches at
418
428
  * once; if a hold were a boolean, the first frame's verdict would unprotect ids the second is
@@ -434,6 +444,21 @@ export declare class MeshAgent extends EventEmitter {
434
444
  /** One frame's verdict is in (either way). The id is ordinary backlog again only once EVERY frame
435
445
  * holding it has reported — a release from one must not speak for another still in flight. */
436
446
  releaseInFlight(ids: readonly string[]): void;
447
+ private own;
448
+ /** Keep a held durable delivery with this reader for as long as the hold lasts, by restarting its
449
+ * ack wait at half the wait. Only a HELD delivery is renewed: a queued one keeps the broker's
450
+ * timer, so a reader busy with other work does not sit on a role request another reader could
451
+ * take, and an abandoned one (released) runs out and redelivers. */
452
+ private keepOwned;
453
+ private stopRenewal;
454
+ /** Restart one copy's ack wait, unless this reader can no longer vouch that it still holds that
455
+ * copy. JetStream acks by stream sequence rather than by delivery, so a renewal sent after the
456
+ * wait may have run out (a stalled loop, a link down for longer than the wait) would extend the
457
+ * copy the broker has since handed to another reader. Renewal stops instead and the copy is the
458
+ * broker's to redeliver. Nothing is sent while the link is down, because the client buffers a
459
+ * publish and would replay it after the wait had run out; a handle whose connection was torn
460
+ * down throws, which is the same lost ownership. */
461
+ private renewOwned;
437
462
  /** Return scoped pending messages and ack them — call only when they're actually surfaced. */
438
463
  drainInbox(limit?: number, scope?: InboxScope): InboxItem[];
439
464
  /** Ack exact surfaced deliveries without assuming they still form the physical inbox prefix.
@@ -1 +1 @@
1
- {"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EASL,aAAa,EAcb,KAAK,YAAY,EAKjB,KAAK,QAAQ,EACb,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,YAAY,EAEjB,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,EAElB,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAM/C,YAAY,EAAE,aAAa,EAAE,WAAW,EAAE,CAAC;AAE3C;;;6DAG6D;AAC7D,eAAO,MAAM,gBAAgB,QAAS,CAAC;AAEvC;;;;;;8EAM8E;AAC9E,eAAO,MAAM,gBAAgB,QAAS,CAAC;AAEvC;;8BAE8B;AAC9B,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAItD;AA2BD,2EAA2E;AAC3E,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX;;;;;;6EAMyE;IACzE,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,SAAS,GAAG,IAAI,GAAG,SAAS,CAAC;IACnC,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wDAAwD;IACxD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,kGAAkG;IAClG,UAAU,EAAE,OAAO,CAAC;IACpB,+FAA+F;IAC/F,UAAU,EAAE,OAAO,CAAC;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;iFAE6E;IAC7E,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;sDACsD;AACtD,MAAM,WAAW,WAAW;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;8EAC0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAoDD,0GAA0G;AAC1G,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,MAAM,CAAC;CACZ;AAED,0GAA0G;AAC1G,wBAAgB,eAAe,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,EAAE,UAAU,GAAG,OAAO,CASrE;AAyDD,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,WAAW,GAAG,WAAW,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAuBD;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,GAAG,YAAY,GAAG,cAAc,GAAG,SAAS,CAAC;AAE3G;;;;;;;;GAQG;AACH,eAAO,MAAM,wBAAwB,SAAU,CAAC;AAmChD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,SAAU,SAAQ,YAAY;IACzC,QAAQ,CAAC,EAAE,EAAE,aAAa,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAE7B,OAAO,CAAC,KAAK,CAAiB;IAC9B;;;;;;oGAMgG;IAChG,OAAO,CAAC,UAAU,CAAqB;IACvC,OAAO,CAAC,cAAc,CAAqB;IAC3C;;8DAE0D;IAC1D,OAAO,CAAC,sBAAsB,CAA6D;IAC3F;oDACgD;IAChD,OAAO,CAAC,WAAW,CAA6B;IAChD,iGAAiG;IACjG,OAAO,CAAC,QAAQ,CAAqD;IACrE,OAAO,CAAC,oBAAoB,CAAS;IACrC;;6EAEyE;IACzE,OAAO,CAAC,oBAAoB,CAAqB;IACjD,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,+FAA+F;IAC/F,OAAO,CAAC,mBAAmB,CAAS;IACpC;;0CAEsC;IACtC,OAAO,CAAC,mBAAmB,CAAC,CAAS;IACrC;;;;;;uFAMmF;IACnF,OAAO,CAAC,uBAAuB,CAAC,CAAS;IACzC;;;;;;sFAMkF;IAClF,OAAO,CAAC,2BAA2B,CAAC,CAAS;IAC7C;sEACkE;IAClE,OAAO,CAAC,mBAAmB,CAAC,CAAS;IACrC,OAAO,CAAC,iBAAiB,CAAmE;IAC5F,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,UAAU,CAAyB;IAC3C,OAAO,CAAC,aAAa,CAAiC;IACtD;;kEAE8D;IAC9D,OAAO,CAAC,cAAc,CAAqB;IAC3C;;;8EAG0E;IAC1E,OAAO,CAAC,YAAY,CAAkC;IACtD;;;;mFAI+E;IAC/E,OAAO,CAAC,WAAW,CAAiC;IACpD;0FACsF;IACtF,OAAO,CAAC,YAAY,CAA6B;IACjD;;iEAE6D;IAC7D,OAAO,CAAC,gBAAgB,CAAqB;IAC7C,OAAO,CAAC,aAAa,CAAC,CAAiC;IACvD,wFAAwF;IACxF,OAAO,CAAC,WAAW,CAAC,CAAS;IAC7B,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,UAAU,CAAqB;IACvC,8FAA8F;IAC9F,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwC;IACpE;;wEAEoE;IACpE,OAAO,CAAC,QAAQ,CAAC,UAAU,CAGvB;IACJ;;;oFAGgF;IAChF,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD;+DAC2D;IAC3D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyD;IAC/E;qFACiF;IACjF,OAAO,CAAC,UAAU,CAAC,CAAS;IAC5B,OAAO,CAAC,aAAa,CAAS;IAC9B;;;;;mGAK+F;IAC/F,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAkC;IAChE,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,gBAAgB,CAA6B;IACrD;;;;+FAI2F;IAC3F,OAAO,CAAC,WAAW,CAAkC;IACrD,mGAAmG;IACnG,OAAO,CAAC,kBAAkB,CAAK;IAC/B;oGACgG;IAChG,OAAO,CAAC,WAAW,CAAK;IACxB,4FAA4F;IAC5F,OAAO,CAAC,UAAU,CAAuC;IACzD;iFAC6E;IAC7E,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,yBAAyB,CAAqB;IACtD,OAAO,CAAC,SAAS,CAAS;IAC1B;;;;;;iFAM6E;IAC7E,OAAO,CAAC,aAAa,CAAoC;gBAE7C,MAAM,EAAE,WAAW;IA0E/B,IAAI,EAAE,IAAI,MAAM,CAEf;IAED,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,qGAAqG;IACrG,IAAI,kBAAkB,IAAI,OAAO,CAEhC;IAED,yGAAyG;IACzG,IAAI,eAAe,IAAI,MAAM,GAAG,SAAS,CAExC;IAED;;;;;;;;kGAQ8F;IAC9F,IAAI,oBAAoB,IAAI;QAC1B,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,MAAM,EAAE,MAAM,CAAC;QACf,mBAAmB,EAAE,MAAM,CAAC;QAC5B,KAAK,EAAE,OAAO,CAAC;KAChB,GAAG,SAAS,CAEZ;IAED,oEAAoE;IACpE,IAAI,kBAAkB,IAAI,MAAM,GAAG,SAAS,CAE3C;IAED,2FAA2F;IAC3F,IAAI,sBAAsB,IAAI,MAAM,GAAG,SAAS,CAE/C;IAED;;;oEAGgE;IAChE,IAAI,0BAA0B,IAAI,MAAM,GAAG,SAAS,CAEnD;IAED;2CACuC;IACvC,OAAO,CAAC,kBAAkB;IAS1B;6FACyF;IACzF,OAAO,CAAC,yBAAyB;IAMjC;;;;;;;;;;;;;;;;;;;OAmBG;IACH,0BAA0B,CAAC,GAAG,SAAa,GAAG,MAAM,GAAG,SAAS;IAQhE;;yGAEqG;IACrG,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED;;;;;;;;;;;4CAWwC;IACxC,IAAI,eAAe,IAAI,eAAe,CAQrC;IAED;;oFAEgF;IAC1E,kBAAkB,CAAC,SAAS,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B3D,+EAA+E;IAC/E,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAKjD;;;;;;uFAMmF;IACnF,eAAe,CAAC,CAAC,EAAE,WAAW,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC;IAO5D;;;sFAGkF;IAClF,eAAe,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO;IAMzC;;mGAE+F;IAC/F,OAAO,CAAC,KAAK;IAWb,gGAAgG;IAChG,OAAO,CAAC,cAAc;IAOtB;;;;;;4FAMwF;IACxF,OAAO,CAAC,SAAS;IA0BjB,4FAA4F;IAC5F,KAAK,CAAC,OAAO,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IASpC,OAAO,CAAC,aAAa,CAAC,CAAW;IACjC,OAAO,CAAC,aAAa,CAAC,CAAgB;YAExB,WAAW;IAgDzB,OAAO,CAAC,UAAU,CAAC,CAAgB;IAEnC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAIP,QAAQ;IAkCtB;;;;iGAI6F;IACvF,SAAS,IAAI,OAAO,CAAC;QAAE,EAAE,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IA+B5D,OAAO,CAAC,MAAM;IA6Hd,OAAO,CAAC,MAAM;IA+Dd,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,gBAAgB;IAaxB;;2CAEuC;IACvC,OAAO,CAAC,aAAa;IAWrB;;iDAE6C;IAC7C,OAAO,CAAC,YAAY;IAepB,oGAAoG;IACpG,OAAO,CAAC,eAAe;IAIvB;;;4EAGwE;IACxE,OAAO,CAAC,cAAc;IAYtB;;kFAE8E;IAC9E,OAAO,CAAC,gBAAgB;IAWxB,wFAAwF;YAC1E,WAAW;IAMzB;;;;;;uGAMmG;IACnG,OAAO,CAAC,UAAU;IAqBlB;0GACsG;IACtG,OAAO,CAAC,YAAY;IAKpB,OAAO,CAAC,kBAAkB;IAa1B;;;;gDAI4C;IAC5C,OAAO,CAAC,WAAW;IAwBnB;sDACkD;IAClD,SAAS,CAAC,KAAK,GAAE,UAAkB,GAAG,SAAS,EAAE;IAIjD;;;;;;;;;;;;;kEAa8D;IAC9D,YAAY,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,OAAO;IAgB7C;;;sGAGkG;IAClG,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI/B;mGAC+F;IAC/F,eAAe,CAAC,GAAG,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAW7C,OAAO,CAAC,GAAG;IAMX;;;yEAGqE;IACrE,OAAO,CAAC,SAAS;IAYjB,OAAO,CAAC,WAAW;IAKnB;;;;;;yDAMqD;IACrD,OAAO,CAAC,UAAU;IAYlB,8FAA8F;IAC9F,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,UAAkB,GAAG,SAAS,EAAE;IAsBlE;;;;;;iDAM6C;IAC7C,oBAAoB,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,GAAG,gBAAgB;IA6B/D,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,OAAO;IAIf;;gGAE4F;IAC5F,OAAO,CAAC,WAAW;IAUnB,UAAU,CAAC,KAAK,GAAE,UAAkB,GAAG,MAAM;IAI7C,kFAAkF;IAClF,yBAAyB,IAAI,MAAM,GAAG,SAAS;IAS/C;;;;;;;;;;;;;;;;;;;OAmBG;IACH,IAAI,YAAY,IAAI,UAAU,CAE7B;IAED;;;;;;;OAOG;IACH,YAAY,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAIpC;;;;;;;;;;;;;;;;;;;;;OAqBG;IACH,WAAW,CAAC,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO;IAI1C,oFAAoF;IACpF,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAIpC;;;;;;;;OAQG;IACH,eAAe,IAAI,MAAM;IAIzB,kFAAkF;IAClF,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAInC;;;;;;;;;OASG;IACH,OAAO,CAAC,eAAe;IAKvB;gCAC4B;IAC5B,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,SAAS;IAK/D;;;0EAGsE;IACtE,oBAAoB,IAAI,MAAM;IAI9B;;;;;;;gFAO4E;IAC5E,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,OAAO,GAAG,MAAM;IAYxD;;;wFAGoF;IACpF,WAAW,IAAI,IAAI;IAMnB;qFACiF;IACjF,IAAI,SAAS,IAAI,aAAa,CAE7B;IAED,4FAA4F;IAC5F,WAAW,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAItD,4EAA4E;IAC5E,kBAAkB,IAAI,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC;IAIjD;;;;;;;;iDAQ6C;IACvC,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAYlF;;;;;;kCAM8B;IACxB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAqCtD;;;;;;;;;;;iCAW6B;IACvB,aAAa,CAAC,QAAQ,GAAE,WAAW,CAAC,MAAM,CAAa,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,SAAS,EAAE,CAAC;QAAC,eAAe,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;YAM5G,iBAAiB;IAiGzB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAOtF;;;;;OAKG;IACG,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAe3D;;;;;;;;;;;;4FAYwF;YAC1E,mBAAmB;IAqBjC;8DAC0D;IAC1D,OAAO,CAAC,YAAY;IAMd,OAAO,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;QACT,GAAG,EAAE,YAAY,CAAC;QAClB,GAAG,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,OAAO,CAAA;SAAE,CAAC;QACzC;wFACgF;QAChF,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;IAiBF;;wEAEoE;IACpE,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAIjD;;uGAEmG;IACnG,OAAO,CAAC,UAAU;IAmBZ,EAAE,CACN,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM,EACZ,IAAI,GAAE;QAAE,OAAO,CAAC,EAAE,MAAM,CAAA;KAAO,GAC9B,OAAO,CAAC;QACT,GAAG,EAAE,YAAY,CAAC;QAClB,8FAA8F;QAC9F,IAAI,CAAC,EAAE,QAAQ,CAAC;QAChB,SAAS,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;QACxC,GAAG,EAAE;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,SAAS,EAAE,OAAO,CAAA;SAAE,CAAC;QACzC,2FAA2F;QAC3F,qBAAqB,EAAE,QAAQ,CAAC,QAAQ,CAAC,GAAG,YAAY,CAAC;KAC1D,CAAC;IAmDF;;;;;;;;;;;kFAW8E;IACxE,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,OAAO,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IA0DzO;6FACyF;IACnF,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IASzH;;;;;;sEAMkE;YACpD,aAAa;IAuE3B;;;;;kGAK8F;YAChF,gBAAgB;IAc9B;;;;;;;4FAOwF;IAClF,OAAO,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAYlF;;;;4CAIwC;IAClC,GAAG,CAAC,IAAI,EAAE,OAAO,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC;IAUtH,OAAO,CAAC,cAAc;IAStB;;;;sGAIkG;YACpF,SAAS;IA8BvB;;;;;;;;;OASG;IACH,OAAO,CAAC,eAAe;IASvB;;;;;mGAK+F;IAC/F,gBAAgB,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,GAAG,SAAS;IAqBnE;;uFAEmF;IACnF,mBAAmB,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAOrD;;;;6DAIyD;IACnD,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,EAAE,IAAI,GAAE;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,YAAY,CAAC;IAgCxI,+FAA+F;IAC/F,OAAO,CAAC,UAAU;IAMlB;uGACmG;IAC7F,YAAY,CAAC,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,OAAO,CAAC,YAAY,CAAC;IAM1E;;;;;;;;;;;;;;;;;;;+FAmB2F;IACrF,aAAa,CAAC,GAAG,EAAE;QACvB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;QACrB,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;QAC1B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;QACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,GAAG,OAAO,CAAC,YAAY,GAAG;QAAE,aAAa,CAAC,EAAE,MAAM,CAAC;QAAC,eAAe,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAA;KAAE,CAAC;IAwE9F;6CACyC;IACnC,YAAY,IAAI,OAAO,CAAC,YAAY,CAAC;IAK3C,8FAA8F;IACxF,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAOtD,4CAA4C;IAC5C,MAAM,IAAI,QAAQ,EAAE;IAIpB;qFACiF;IACjF,YAAY,IAAI,YAAY;IAI5B,8CAA8C;IAC9C,IAAI,MAAM,IAAI,cAAc,CAE3B;IAED;;;;;;;;;;kEAU8D;IAC9D,OAAO,CAAC,OAAO;IAOf;;;;;;;;;;;;;;;iCAe6B;IAC7B,qBAAqB,IAAI,IAAI;IAIvB,SAAS,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBzE;;;;;;;;;OASG;IACG,WAAW,CAAC,MAAM,EAAE,cAAc,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAW7D,aAAa;IAK3B,qEAAqE;IAC/D,YAAY,CAAC,SAAS,EAAE,iBAAiB,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE;0GACsG;IACtG,YAAY,CAAC,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI;IAI/B;;;4FAGwF;IACxF,OAAO,CAAC,cAAc;IAUtB;;;;;yGAKqG;IAC/F,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOjF;;;;qFAIiF;IACjF,eAAe,IAAI,MAAM,GAAG,SAAS;IAUrC;oFACgF;IAChF,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,OAAO,CAAA;KAAE;IAUnH,2EAA2E;IAC3E,cAAc,IAAI,MAAM,EAAE;IAI1B;;iEAE6D;IACvD,YAAY,IAAI,OAAO,CAC3B;QACE,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,MAAM,EAAE,OAAO,CAAC;QAChB,MAAM,EAAE,OAAO,CAAC;QAChB,eAAe,EAAE,OAAO,CAAC;QACzB,cAAc,CAAC,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,CAAC;QACnD,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,WAAW,GAAG,QAAQ,CAAC;KAC9B,EAAE,CACJ;IAuFD;;;;;2BAKuB;IACjB,WAAW,CACf,OAAO,EAAE,MAAM,GACd,OAAO,CAAC;QAAE,MAAM,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAKtF,mEAAmE;IAC7D,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,CAAC;IAO/D;;wEAEoE;YACtD,gBAAgB;IAI9B;;;;+EAI2E;IACrE,aAAa,CAAC,SAAS,GAAE,MAAyB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxE;;;6DAGyD;IACzD,OAAO,CAAC,eAAe;IAmBvB;;qEAEiE;IACjE,OAAO,CAAC,mBAAmB;IAO3B;;uFAEmF;IACnF,OAAO,CAAC,mBAAmB;IAQ3B,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,iBAAiB;IAezB,OAAO,CAAC,GAAG;CAGZ;AAED;;uCAEuC;AACvC,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,YAAY,EAAE;IAAE,KAAK,EAAE,SAAS,CAAA;CAAE,CAAC,GAAG,MAAM,CAI/F;AAED,kGAAkG;AAClG,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,EAAE,CAOrF"}
package/dist/agent.js CHANGED
@@ -1,7 +1,7 @@
1
1
  import { AsyncLocalStorage } from "node:async_hooks";
2
2
  import { EventEmitter } from "node:events";
3
3
  import { hostname } from "node:os";
4
- import { normalizeMentions, RUN_LAUNCH_DEADLINE_MS, subjectMatches, isConcreteChannel, assertValidChannel, channelInAllow, resolvePeer as resolvePeerInRoster, peerLabel, CotalEndpoint, BASELINE_LIFECYCLE_ENDPOINT, BIND_SPLIT_REISSUES, assertLifecycleToken, EpEnvelopeError, isPublishPermissionDenied, unansweredRequest, renderLifecycleBlocked, controlReplyFrom, runAgentBearer, partsToText, assertValidRole, } from "@cotal-ai/core";
4
+ import { normalizeMentions, RUN_LAUNCH_DEADLINE_MS, subjectMatches, isConcreteChannel, assertValidChannel, channelInAllow, resolvePeer as resolvePeerInRoster, peerLabel, CotalEndpoint, acquireLocalConsumer, BASELINE_LIFECYCLE_ENDPOINT, BIND_SPLIT_REISSUES, assertLifecycleToken, EpEnvelopeError, isPublishPermissionDenied, unansweredRequest, renderLifecycleBlocked, controlReplyFrom, runAgentBearer, partsToText, assertValidRole, } from "@cotal-ai/core";
5
5
  import { attributionSafe } from "./framing.js";
6
6
  import { invokeUserManager } from "./manager-call.js";
7
7
  /** Client-side floor for a spawn action's submit + follow. The manager acceptance carries the exact
@@ -200,6 +200,8 @@ export class MeshAgent extends EventEmitter {
200
200
  /** Surfaced to the host but not yet committed or abandoned, counted per holding frame because
201
201
  * frames overlap. See {@link holdInFlight}. */
202
202
  inFlightIds = new Map();
203
+ /** Ack-wait renewal timers of held durable deliveries, by receive key. See {@link keepOwned}. */
204
+ renewals = new Map();
203
205
  classificationUnsafe = false;
204
206
  /** Terminal receive-time decisions that must survive the live→durable transition: successfully
205
207
  * surfaced pull-only messages and hard drops under muted/focus. Capacity loss degrades the
@@ -634,8 +636,16 @@ export class MeshAgent extends EventEmitter {
634
636
  }
635
637
  /** Begin connecting with background retry. Resolves after the first completed mesh join. */
636
638
  start(retryMs = 3000) {
637
- return this.connectLoop(retryMs);
639
+ if (this._stopping)
640
+ throw new Error("cannot start a stopped mesh session");
641
+ if (!this.consumerClaim && this.config.lifecycleUid) {
642
+ const { owner, actor } = this.ep.principal;
643
+ this.consumerClaim = acquireLocalConsumer(this.config.servers, this.config.space, owner, actor, this.config.lifecycleUid);
644
+ }
645
+ return this.connectFlight ??= this.connectLoop(retryMs);
638
646
  }
647
+ consumerClaim;
648
+ connectFlight;
639
649
  async connectLoop(retryMs) {
640
650
  while (!this._stopping && !this._connected) {
641
651
  try {
@@ -681,8 +691,14 @@ export class MeshAgent extends EventEmitter {
681
691
  }
682
692
  }
683
693
  }
684
- async stop() {
694
+ stopFlight;
695
+ stop() {
696
+ return this.stopFlight ??= this.stopOnce();
697
+ }
698
+ async stopOnce() {
685
699
  this._stopping = true;
700
+ for (const key of [...this.renewals.keys()])
701
+ this.stopRenewal(key);
686
702
  if (this.turnPollTimer !== undefined) {
687
703
  clearInterval(this.turnPollTimer);
688
704
  this.turnPollTimer = undefined;
@@ -695,8 +711,8 @@ export class MeshAgent extends EventEmitter {
695
711
  this.emit("transport", { connected: false });
696
712
  }
697
713
  // Unconditional: a background self-heal can flip _connected without us, so a `_connected`
698
- // guard could skip the stop and leak the live connection/heartbeat/supervisor. ep.stop() is
699
- // idempotent (early-returns once stopped), so calling it when already-down is a noop.
714
+ // guard could skip the stop and leak the live connection/heartbeat/supervisor. ep.stop()
715
+ // coalesces its retained shutdown outcome, including an earlier closure refusal.
700
716
  // #636: departure is the last write. Running it THROUGH the chain (as its own inOrder entry,
701
717
  // not merely awaited alongside it) orders offline behind every write already admitted,
702
718
  // whichever method admitted it — setStatus's requireConnected included. The race is bounded so
@@ -704,8 +720,14 @@ export class MeshAgent extends EventEmitter {
704
720
  // endpoint must still stop, so ep.stop() runs directly once there. Every write admitted AFTER
705
721
  // this point is refused at once by inOrder() (see there) rather than queued behind departure,
706
722
  // so a straggler cannot land after offline and does not sit out setStatus's connect grace.
707
- await Promise.race([this.inOrder(() => this.ep.stop(), true), sleep(3_000)]);
723
+ const departure = this.inOrder(() => this.ep.stop(), true);
724
+ await Promise.race([departure, sleep(3_000)]);
708
725
  await this.ep.stop();
726
+ await departure;
727
+ // A late initial bind must finish its stopped teardown before custody is released.
728
+ await this.connectFlight;
729
+ this.consumerClaim?.release();
730
+ this.consumerClaim = undefined;
709
731
  }
710
732
  /** Manual reconnect: tear down the mesh connection and rebuild it in-process, WITHOUT
711
733
  * stopping the agent (the recovery path, so it does NOT assert connected). Delegates to
@@ -778,6 +800,10 @@ export class MeshAgent extends EventEmitter {
778
800
  if (existing) {
779
801
  if (delivery.durable) {
780
802
  existing.ack = delivery.ack;
803
+ // A fresh copy is a fresh ownership: a hold that outlived the copy it renewed keeps this one.
804
+ this.own(existing, delivery.redelivery);
805
+ if (this.inFlightIds.has(existing.item.recvKey))
806
+ this.keepOwned(existing.item.recvKey);
781
807
  this.emit("incoming", existing.item);
782
808
  }
783
809
  return;
@@ -848,7 +874,7 @@ export class MeshAgent extends EventEmitter {
848
874
  // #662: recall cannot pick this copy out from an identical one with another disposition, so
849
875
  // its body is held here, pull-only, and recall hands back only copies nothing is bound to.
850
876
  if (item.id === "")
851
- this.buffer(item, () => { }, true, idless);
877
+ this.buffer(item, { ack: () => { } }, true, idless);
852
878
  if (item.mentionsMe)
853
879
  this.emit("mention-wake", item);
854
880
  return;
@@ -866,13 +892,14 @@ export class MeshAgent extends EventEmitter {
866
892
  const pullOnly = snapshottedPullOnly || (!item.mentionsMe && (item.historical || automaticReply || this.classificationUnsafe));
867
893
  if (pullOnly)
868
894
  this.excludeFromFocus(item);
869
- this.buffer(item, delivery.ack, pullOnly, idless);
895
+ this.buffer(item, delivery, pullOnly, idless);
870
896
  return;
871
897
  }
872
- this.buffer(item, delivery.ack, false);
898
+ this.buffer(item, delivery, false);
873
899
  }
874
- buffer(item, ack, pullOnly, idless) {
875
- const pending = { item, ack, pullOnly, receivedAt: Date.now() };
900
+ buffer(item, delivery, pullOnly, idless) {
901
+ const pending = { item, ack: delivery.ack, pullOnly, receivedAt: Date.now() };
902
+ this.own(pending, delivery.redelivery);
876
903
  if (idless)
877
904
  pending.idless = { tally: this.focusIdless, ...idless };
878
905
  this.inbox.push(pending);
@@ -892,27 +919,29 @@ export class MeshAgent extends EventEmitter {
892
919
  //
893
920
  // So directedness decides who gets sacrificed, and directedness is read from `kind`, which is
894
921
  // derived from the delivering subject and broker-policed rather than from the payload.
895
- let index = this.inbox.findIndex((p) => p.pullOnly);
922
+ //
923
+ // A held entry is never sacrificed: the host's verdict commits through its ack handle, and its
924
+ // renewal is what keeps the broker from redelivering it meanwhile. Evicting one would drop
925
+ // both, handing a long turn's role request to a second worker while the first still runs it
926
+ // and leaving the first one's completion nothing to ack. Holds are capped at twice this bound
927
+ // ({@link holdInFlight}), so the buffer stays bounded.
928
+ const evictable = (p) => !this.inFlightIds.has(p.item.recvKey);
929
+ let index = this.inbox.findIndex((p) => p.pullOnly && evictable(p));
896
930
  // Channel traffic before anything addressed to us specifically, forged mentions included.
897
931
  if (index < 0)
898
- index = this.inbox.findIndex((p) => p.item.kind === "channel");
932
+ index = this.inbox.findIndex((p) => p.item.kind === "channel" && evictable(p));
899
933
  // Only when the whole buffer is directed mail does the oldest lose, and that case carries no
900
934
  // attacker advantage: a peer cannot force DMs it is not authorised to send.
901
935
  if (index < 0)
902
- index = 0;
936
+ index = this.inbox.findIndex(evictable);
937
+ if (index < 0)
938
+ break;
903
939
  const [evicted] = this.inbox.splice(index, 1);
904
940
  const sacrificingDirected = evicted.item.kind !== "channel";
905
941
  this.rememberEvicted(evicted);
906
942
  // #662: a held id-less message is no longer settled here, so recall may hand it back.
907
943
  if (evicted.idless?.tally === this.focusIdless)
908
944
  this.unsettleIdless(evicted.idless.digest, evicted.idless.copy);
909
- // ...but NOT an id that is mid-delivery. Overflow prefers the oldest, which is exactly what a
910
- // surfaced batch is made of, so without this an arrival can ack a message a host is still
911
- // trying to hand to its runtime. Evicting bounds memory; acking is what makes it
912
- // unrecoverable — gone from the buffer, never marked handled, no longer redeliverable. Left
913
- // un-acked it redelivers; and if the delivery does succeed, {@link drainInboxDeliveries} marks the
914
- // now-missing id handled so that redelivery is silently acked.
915
- //
916
945
  // A directed message is never acked on overflow: leaving it un-acked lets JetStream redeliver
917
946
  // it once we have room, which turns unrecoverable loss into a delay. Channel ambient is still
918
947
  // acked, because replaying it is what the history flood was (#775).
@@ -925,7 +954,7 @@ export class MeshAgent extends EventEmitter {
925
954
  // it instead, as a per-id eviction count once did (#807), acked a message the sender had
926
955
  // seen stored and the live recipient never read, with one stderr line as the only trace:
927
956
  // a seat whose turn ran long lost its oldest DMs exactly that way (#2215).
928
- if (!sacrificingDirected && !this.inFlightIds.has(evicted.item.recvKey))
957
+ if (!sacrificingDirected)
929
958
  evicted.ack();
930
959
  }
931
960
  }
@@ -1127,8 +1156,8 @@ export class MeshAgent extends EventEmitter {
1127
1156
  peekInbox(scope = "all") {
1128
1157
  return this.inbox.filter((p) => this.inScope(p, scope)).map((p) => p.item);
1129
1158
  }
1130
- /** Mark a surfaced batch as mid-delivery, so the overflow valve will not ack it out from under the
1131
- * host. Pair with {@link releaseInFlight} on the delivery verdict, whichever way it goes.
1159
+ /** Mark a surfaced batch as mid-delivery, so the overflow valve will not evict it out from under
1160
+ * the host. Pair with {@link releaseInFlight} on the delivery verdict, whichever way it goes.
1132
1161
  *
1133
1162
  * **Counted, not a set.** Hook frames overlap, so the same id is routinely in two open batches at
1134
1163
  * once; if a hold were a boolean, the first frame's verdict would unprotect ids the second is
@@ -1153,8 +1182,10 @@ export class MeshAgent extends EventEmitter {
1153
1182
  fresh++;
1154
1183
  if (this.inFlightIds.size + fresh > MAX_INBOX * 2)
1155
1184
  return false;
1156
- for (const id of ids)
1185
+ for (const id of ids) {
1157
1186
  this.inFlightIds.set(id, (this.inFlightIds.get(id) ?? 0) + 1);
1187
+ this.keepOwned(id);
1188
+ }
1158
1189
  return true;
1159
1190
  }
1160
1191
  /** Whether this id is currently protected from the overflow valve — i.e. some frame is mid-delivery
@@ -1171,12 +1202,62 @@ export class MeshAgent extends EventEmitter {
1171
1202
  const held = this.inFlightIds.get(id);
1172
1203
  if (held === undefined)
1173
1204
  continue;
1174
- if (held <= 1)
1205
+ if (held <= 1) {
1175
1206
  this.inFlightIds.delete(id);
1207
+ this.stopRenewal(id);
1208
+ }
1176
1209
  else
1177
1210
  this.inFlightIds.set(id, held - 1);
1178
1211
  }
1179
1212
  }
1213
+ own(p, redelivery) {
1214
+ p.redelivery = redelivery;
1215
+ p.ownedUntil = redelivery && Date.now() + redelivery.ackWaitMs;
1216
+ p.item.deliveryCount = redelivery?.deliveryCount;
1217
+ }
1218
+ /** Keep a held durable delivery with this reader for as long as the hold lasts, by restarting its
1219
+ * ack wait at half the wait. Only a HELD delivery is renewed: a queued one keeps the broker's
1220
+ * timer, so a reader busy with other work does not sit on a role request another reader could
1221
+ * take, and an abandoned one (released) runs out and redelivers. */
1222
+ keepOwned(key) {
1223
+ if (this.renewals.has(key))
1224
+ return;
1225
+ const p = this.inbox.find((x) => x.item.recvKey === key);
1226
+ if (!p?.redelivery || !this.renewOwned(p))
1227
+ return;
1228
+ const timer = setInterval(() => {
1229
+ const held = this.inbox.find((x) => x.item.recvKey === key);
1230
+ if (!held || !this.renewOwned(held))
1231
+ this.stopRenewal(key);
1232
+ }, p.redelivery.ackWaitMs / 2);
1233
+ timer.unref?.();
1234
+ this.renewals.set(key, timer);
1235
+ }
1236
+ stopRenewal(key) {
1237
+ clearInterval(this.renewals.get(key));
1238
+ this.renewals.delete(key);
1239
+ }
1240
+ /** Restart one copy's ack wait, unless this reader can no longer vouch that it still holds that
1241
+ * copy. JetStream acks by stream sequence rather than by delivery, so a renewal sent after the
1242
+ * wait may have run out (a stalled loop, a link down for longer than the wait) would extend the
1243
+ * copy the broker has since handed to another reader. Renewal stops instead and the copy is the
1244
+ * broker's to redeliver. Nothing is sent while the link is down, because the client buffers a
1245
+ * publish and would replay it after the wait had run out; a handle whose connection was torn
1246
+ * down throws, which is the same lost ownership. */
1247
+ renewOwned(p) {
1248
+ if (!p.redelivery || p.ownedUntil === undefined || Date.now() >= p.ownedUntil)
1249
+ return false;
1250
+ if (!this._transportConnected)
1251
+ return true;
1252
+ try {
1253
+ p.redelivery.working();
1254
+ }
1255
+ catch {
1256
+ return false;
1257
+ }
1258
+ p.ownedUntil = Date.now() + p.redelivery.ackWaitMs;
1259
+ return true;
1260
+ }
1180
1261
  /** Return scoped pending messages and ack them — call only when they're actually surfaced. */
1181
1262
  drainInbox(limit, scope = "all") {
1182
1263
  const eligible = this.inbox.filter((p) => this.inScope(p, scope));
@@ -1606,7 +1687,7 @@ export class MeshAgent extends EventEmitter {
1606
1687
  }
1607
1688
  const copy = { epoch, frontier: seq, ready: Promise.resolve(), seq };
1608
1689
  fresh.bound.add(seq);
1609
- this.buffer(this.toInboxItem(m, "channel", true), () => { }, true, { digest, copy });
1690
+ this.buffer(this.toInboxItem(m, "channel", true), { ack: () => { } }, true, { digest, copy });
1610
1691
  }
1611
1692
  if (tallies === this.focusIdless)
1612
1693
  this.settleIdlessRead(channel, epoch, retained);
@@ -1706,7 +1787,7 @@ export class MeshAgent extends EventEmitter {
1706
1787
  /** #384: a peer that sent us a DM or anycast and has no roster row, by its exact id or, while the
1707
1788
  * presence view is current, by a display name only one such sender carried. A one-shot
1708
1789
  * `cotal send` never registers presence, so without this a reply to it could not be addressed. */
1709
- heldSender(target, byName) {
1790
+ heldSender(target, byName, peer) {
1710
1791
  const name = this.senders.get(target);
1711
1792
  if (name !== undefined)
1712
1793
  return { id: target, name };
@@ -1716,10 +1797,14 @@ export class MeshAgent extends EventEmitter {
1716
1797
  // A sender rostered again under a new name has a row now, so its old name must not collide here.
1717
1798
  const rostered = new Set(this.ep.getRoster().map((p) => p.card.id));
1718
1799
  const matches = [...this.senders].filter(([id, n]) => !rostered.has(id) && n.toLowerCase() === want);
1800
+ // A roster row cannot hide another authenticated sender that has no presence row.
1801
+ if (peer)
1802
+ matches.unshift([peer.card.id, peer.card.name]);
1719
1803
  if (matches.length > 1)
1720
- throw new Error(`"${target}" is ambiguous - ${matches.length} senders with no roster row share that name; ` +
1804
+ throw new Error(`"${target}" is ambiguous - ${matches.length} known peers share that name; ` +
1721
1805
  `DM by instance id instead: ${matches.map(([id, n]) => `${n} (${id})`).join("; ")}`);
1722
- return matches[0] && { id: matches[0][0], name: matches[0][1] };
1806
+ const match = matches[0];
1807
+ return match && match[0] !== peer?.card.id ? { id: match[0], name: match[1] } : undefined;
1723
1808
  }
1724
1809
  async dm(target, text, opts = {}) {
1725
1810
  await this.requireConnected();
@@ -1739,7 +1824,9 @@ export class MeshAgent extends EventEmitter {
1739
1824
  // #384: a target with no roster row may still be a peer that messaged us (its id is
1740
1825
  // authenticated), which a one-shot `cotal send` always is. The DM goes to that identity and the
1741
1826
  // space's DM stream keeps it, instead of refusing a reply nothing could ever deliver.
1742
- const held = peer ? undefined : this.heldSender(target, this.ep.presenceView().state === "current");
1827
+ const held = peer?.card.id === target
1828
+ ? undefined
1829
+ : this.heldSender(target, this.ep.presenceView().state === "current", peer);
1743
1830
  if (!peer && !held) {
1744
1831
  const after = this.ep.presenceView();
1745
1832
  if (after.state === "current")