@songsid/agend 2.1.12 → 2.2.0-alpha.2

package/dist/darwin-memory.d.ts

@@ -2,6 +2,8 @@ import type { HostMemory } from "./host-memory.js";
 export declare const DARWIN_MEMORY_DEADLINE_MS = 2000;
 export declare const DARWIN_MEMORY_CACHE_MS = 30000;
 export declare function unknownDarwinMemory(totalBytes: number): HostMemory;
+/** XNU exposes NOTE_MEMORYSTATUS_PRESSURE_* (1/2/4), not its internal 0/1/2/3 enum. */
+export declare function parseDarwinPressureLevel(text: string): HostMemory["darwinPressureLevel"];
 /** vm_stat's printed free count excludes speculative pages. Purgeable can overlap inactive. */
 export declare function parseDarwinAvailable(text: string, totalBytes: number): number | null;
 /** sysctl prints binary MiB to two decimals, including the valid unallocated 0/0 pool. */
@@ -18,12 +20,15 @@ interface Options {
     run?: MemoryCommandRunner;
     totalmem?: () => number;
     now?: () => number;
+    /** Only the periodic fleet sampler requests the kernel alarm. Diagnostics do not fork for it. */
+    includePressure?: boolean;
 }
-/** One bounded logical read and at most one physical pair, even across stop/restart. */
+/** One bounded logical read and at most one physical batch, even across stop/restart. */
 export declare class DarwinMemoryProbe {
     private readonly run;
     private readonly total;
     private readonly now;
+    private readonly includePressure;
     private flight;
     private cache;
     private epoch;

package/dist/darwin-memory.js

@@ -4,7 +4,12 @@ export const DARWIN_MEMORY_DEADLINE_MS = 2_000;
 export const DARWIN_MEMORY_CACHE_MS = 30_000;
 const MAX_OUTPUT = 32 * 1024;
 export function unknownDarwinMemory(totalBytes) {
-    return { totalBytes, availableBytes: null, availableKind: "unknown", swapTotalBytes: null, swapFreeBytes: null };
+    return { totalBytes, availableBytes: null, availableKind: "unknown", swapTotalBytes: null, swapFreeBytes: null, darwinPressureLevel: null, darwinPressureRaw: null };
+}
+/** XNU exposes NOTE_MEMORYSTATUS_PRESSURE_* (1/2/4), not its internal 0/1/2/3 enum. */
+export function parseDarwinPressureLevel(text) {
+    const match = /^kern\.memorystatus_vm_pressure_level:[ \t]+([124])[ \t]*\r?\n?$/.exec(text);
+    return match && match[0].length === text.length ? Number(match[1]) : null;
 }
 /** vm_stat's printed free count excludes speculative pages. Purgeable can overlap inactive. */
 export function parseDarwinAvailable(text, totalBytes) {
@@ -66,11 +71,12 @@ export const runMemoryCommand = (file, args) => {
         return { result, stopped, kill: () => { } };
     }
 };
-/** One bounded logical read and at most one physical pair, even across stop/restart. */
+/** One bounded logical read and at most one physical batch, even across stop/restart. */
 export class DarwinMemoryProbe {
     run;
     total;
     now;
+    includePressure;
     flight = null;
     cache = null;
     epoch = 0;
@@ -78,11 +84,12 @@ export class DarwinMemoryProbe {
         this.run = options.run ?? runMemoryCommand;
         this.total = options.totalmem ?? totalmem;
         this.now = options.now ?? (() => performance.now());
+        this.includePressure = options.includePressure ?? false;
     }
     read() {
         if (this.cache && this.now() - this.cache.at < DARWIN_MEMORY_CACHE_MS)
             return Promise.resolve({ ...this.cache.memory });
-        // A timed-out or cancelled pair still owns its physical reservation.
+        // A timed-out or cancelled batch still owns its physical reservation.
         if (this.flight) {
             const flight = this.flight;
             if (flight.completed)
@@ -121,7 +128,10 @@ export class DarwinMemoryProbe {
         // Start the deadline before either constructor; a slow constructor cannot earn extra time.
         timer = setTimeout(cancel, DARWIN_MEMORY_DEADLINE_MS);
         timer.unref?.();
-        for (const [file, args] of [["/usr/bin/vm_stat", []], ["/usr/sbin/sysctl", ["vm.swapusage"]]]) {
+        const requests = [["/usr/bin/vm_stat", []], ["/usr/sbin/sysctl", ["vm.swapusage"]]];
+        if (this.includePressure)
+            requests.push(["/usr/sbin/sysctl", ["kern.memorystatus_vm_pressure_level"]]);
+        for (const [file, args] of requests) {
             if (this.now() >= deadlineAt) {
                 cancel();
                 break;
@@ -141,8 +151,9 @@ export class DarwinMemoryProbe {
                 return;
             }
             const available = outputs[0] === null || outputs[0] === undefined ? null : parseDarwinAvailable(outputs[0], totalBytes);
-            finish(available === null ? unknown : { totalBytes, availableBytes: available, availableKind: "available",
-                ...parseDarwinSwap(outputs[1] ?? "") });
+            finish({ ...(available === null ? unknown : { totalBytes, availableBytes: available, availableKind: "available",
+                    ...parseDarwinSwap(outputs[1] ?? "") }), darwinPressureLevel: parseDarwinPressureLevel(outputs[2] ?? ""),
+                darwinPressureRaw: outputs[2]?.slice(0, 1024) ?? null });
         });
         // Never release on kill request/result alone. Rejected cleanup remains reserved.
         void Promise.all(commands.map(command => command.stopped.catch(() => new Promise(() => { })))).then(() => {

package/dist/darwin-memory.js.map

@@ -1 +1 @@
-{"version":3,"file":"darwin-memory.js","sourceRoot":"","sources":["../src/darwin-memory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"darwin-memory.js","sourceRoot":"","sources":["../src/darwin-memory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AAGnC,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,CAAC;AAC/C,MAAM,CAAC,MAAM,sBAAsB,GAAG,MAAM,CAAC;AAC7C,MAAM,UAAU,GAAG,EAAE,GAAG,IAAI,CAAC;AAE7B,MAAM,UAAU,mBAAmB,CAAC,UAAkB;IACpD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,SAAS,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,mBAAmB,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAAC;AACvK,CAAC;AAED,uFAAuF;AACvF,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,MAAM,KAAK,GAAG,kEAAkE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5F,OAAO,KAAK,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAc,CAAC,CAAC,CAAC,IAAI,CAAC;AACzF,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,oBAAoB,CAAC,IAAY,EAAE,UAAkB;IACnE,MAAM,OAAO,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,qEAAqE,CAAC,CAAC,CAAC;IAC1G,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,oCAAoC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/G,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,IAAI,IAAI,QAAQ,GAAG,IAAI,GAAG,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/H,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,UAAU,EAAE,WAAW,CAAC,EAAE,CAAC;QACpE,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,UAAU,IAAI,qBAAqB,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QACvF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,UAAU,IAAI,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3G,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACjC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,KAAK,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;QAC3D,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACrB,CAAC;IACD,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,SAAS,CAAC,GAAG,MAAM,CAAC;IACxD,MAAM,KAAK,GAAG,CAAC,IAAI,GAAG,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,SAAS,CAAC,CAAC,GAAG,QAAQ,CAAC;IAC9E,OAAO,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,GAAG,CAAC,IAAI,KAAK,IAAI,UAAU,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAC5H,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,MAAM,OAAO,GAAG,EAAE,cAAc,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC;IAC9D,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,CAAC,QAAQ,CAAC,2HAA2H,CAAC,CAAC,CAAC;IAC7J,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,OAAO,CAAC;IACtC,MAAM,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzD,IAAI,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,IAAI,GAAG,IAAI,CAAC,GAAG,IAAI;QAAE,OAAO,OAAO,CAAC;IACxI,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,IAAI,CAAC,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC;IAC3F,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,SAAS,CAAC;QAAE,OAAO,OAAO,CAAC;IAC1F,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,CAAC;AAClE,CAAC;AAUD,MAAM,CAAC,MAAM,gBAAgB,GAAwB,CAAC,IAAI,EAAE,IAAI,EAAE,EAAE;IAClE,IAAI,aAA8C,CAAC;IACnD,IAAI,cAA2B,CAAC;IAChC,MAAM,MAAM,GAAG,IAAI,OAAO,CAAgB,OAAO,CAAC,EAAE,GAAG,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IACnF,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE,GAAG,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5E,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE;YACjC,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE;YACjE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,SAAS,EAAE,UAAU;SAC7D,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;QAC5D,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;QACpC,qFAAqF;QACrF,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;QAC/C,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;gBAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC5G,CAAC;IAAC,MAAM,CAAC;QACP,aAAa,CAAC,IAAI,CAAC,CAAC;QAAC,cAAc,EAAE,CAAC;QACtC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;IAC7C,CAAC;AACH,CAAC,CAAC;AAgBF,yFAAyF;AACzF,MAAM,OAAO,iBAAiB;IACX,GAAG,CAAsB;IACzB,KAAK,CAAe;IACpB,GAAG,CAAe;IAClB,eAAe,CAAU;IAClC,MAAM,GAAkB,IAAI,CAAC;IAC7B,KAAK,GAA8C,IAAI,CAAC;IACxD,KAAK,GAAG,CAAC,CAAC;IAElB,YAAY,UAAmB,EAAE;QAC/B,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,gBAAgB,CAAC;QAC3C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,QAAQ,IAAI,QAAQ,CAAC;QAC1C,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,CAAC,CAAC;QACpD,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,KAAK,CAAC;IAC1D,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,GAAG,sBAAsB;YAAE,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QACxH,sEAAsE;QACtE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;YAC3B,IAAI,MAAM,CAAC,SAAS;gBAAE,OAAO,OAAO,CAAC,OAAO,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;YAChF,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,KAAK,KAAK,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACrH,CAAC;QACD,MAAM,KAAK,GAAG,EAAE,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC,KAAK,EAAE,EAAE,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,yBAAyB,CAAC;QAC3G,MAAM,OAAO,GAAG,mBAAmB,CAAC,UAAU,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAoB,EAAE,CAAC;QACrC,IAAI,MAAoC,CAAC;QACzC,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,IAAI,KAAK,GAAyC,IAAI,CAAC;QACvD,MAAM,MAAM,GAAG,IAAI,OAAO,CAAa,OAAO,CAAC,EAAE,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QACzE,MAAM,MAAM,GAAG,CAAC,KAAiB,EAAE,EAAE;YACnC,IAAI,SAAS;gBAAE,OAAO;YACtB,SAAS,GAAG,IAAI,CAAC;YACjB,MAAM,CAAC,SAAS,GAAG,IAAI,CAAC;YACxB,IAAI,KAAK;gBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;YAC/B,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK;gBAAE,IAAI,CAAC,KAAK,GAAG,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,MAAM,EAAE,EAAE,GAAG,KAAK,EAAE,EAAE,CAAC;YAChF,MAAM,CAAC,KAAK,CAAC,CAAC;QAChB,CAAC,CAAC;QACF,MAAM,MAAM,GAAG,GAAG,EAAE;YAClB,MAAM,CAAC,OAAO,CAAC,CAAC;YAChB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;gBAAC,IAAI,CAAC;oBAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBAAC,CAAC;gBAAC,MAAM,CAAC,CAAC,wBAAwB,CAAC,CAAC;YAAC,CAAC;QAChG,CAAC,CAAC;QACF,MAAM,MAAM,GAAW,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QACnE,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,2FAA2F;QAC3F,KAAK,GAAG,UAAU,CAAC,MAAM,EAAE,yBAAyB,CAAC,CAAC;QACtD,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;QAChB,MAAM,QAAQ,GAA8B,CAAC,CAAC,kBAAkB,EAAE,EAAE,CAAC,EAAE,CAAC,kBAAkB,EAAE,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC;QAC/G,IAAI,IAAI,CAAC,eAAe;YAAE,QAAQ,CAAC,IAAI,CAAC,CAAC,kBAAkB,EAAE,CAAC,qCAAqC,CAAC,CAAC,CAAC,CAAC;QACvG,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;YACpC,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,UAAU,EAAE,CAAC;gBAAC,MAAM,EAAE,CAAC;gBAAC,MAAM;YAAC,CAAC;YAClD,IAAI,CAAC;gBAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YAAC,CAAC;YACjD,MAAM,CAAC;gBAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC,CAAC;YAAC,CAAC;QACzG,CAAC;QACD,KAAK,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE;YACzF,IAAI,SAAS;gBAAE,OAAO;YACtB,IAAI,KAAK,KAAK,IAAI,CAAC,KAAK,IAAI,IAAI,CAAC,GAAG,EAAE,IAAI,UAAU,EAAE,CAAC;gBAAC,MAAM,EAAE,CAAC;gBAAC,OAAO;YAAC,CAAC;YAC3E,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,OAAO,CAAC,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,oBAAoB,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;YACxH,MAAM,CAAC,EAAE,GAAG,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,cAAc,EAAE,SAAS,EAAE,aAAa,EAAE,WAAoB;oBACtH,GAAG,eAAe,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC,EAAE,mBAAmB,EAAE,wBAAwB,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBACxG,iBAAiB,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;QAC7D,CAAC,CAAC,CAAC;QACH,iFAAiF;QACjF,KAAK,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,OAAO,CAAO,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;YAC5G,IAAI,IAAI,CAAC,MAAM,KAAK,MAAM;gBAAE,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACjD,CAAC,CAAC,CAAC;QACH,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,CAAC,CAAC,CAAC;IAC9C,CAAC;IAED,IAAI;QACF,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QAClB,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IACxB,CAAC;CACF"}

package/dist/delivery-consumed-watch.d.ts

@@ -0,0 +1,85 @@
+import type { ConsumedVia } from "./delivery-outbox.js";
+export declare const CONSUMED_WATCH: {
+    /** Watches alive at once across the fleet. */
+    maxWatchers: number;
+    /** Bytes one look reads past its offset. */
+    chunkBytes: number;
+    /** A line longer than this (without its newline) is never decoded: skipped. */
+    maxLineBytes: number;
+    /** First interval between looks. */
+    tickMs: number;
+    /** Interval while a backlog is being read (the file is ahead of the offset). */
+    catchUpMs: number;
+    /** Consecutive looks with no growth before the interval doubles… */
+    idleLooksBeforeBackoff: number;
+    /** …up to this. */
+    maxTickMs: number;
+    /** A watch ends after this long (monotonic) whatever it saw. */
+    lifetimeMs: number;
+};
+export interface ConsumedWatchTarget {
+    deliveryId: string;
+    attemptNo: number;
+    backend: string;
+    path: string;
+    offset: number;
+    /** False once the attempt's CLI is no longer the one we wrote to (stop, pause, respawn): the watch ends quietly. */
+    current(): boolean;
+    /** The hit: record it (the outbox decides what it changes). */
+    consumed(via: ConsumedVia, evidence: string): void;
+    logger?: {
+        info(obj: unknown, msg?: string): void;
+        warn(obj: unknown, msg?: string): void;
+        debug?(obj: unknown, msg?: string): void;
+    };
+}
+type Ended = "consumed" | "fenced" | "unavailable" | "expired" | "stopped";
+/** One attempt's watch. Exported for its tests; the fleet starts watches through ConsumedWatchRegistry. */
+export declare class ConsumedWatch {
+    private readonly target;
+    private readonly onEnd;
+    private offset;
+    private carry;
+    /** The current line overran maxLineBytes: discard bytes until the next newline. */
+    private skippingLine;
+    private idleLooks;
+    private interval;
+    private timer;
+    private readonly startedAt;
+    private ended;
+    constructor(target: ConsumedWatchTarget, onEnd: (why: Ended) => void);
+    start(): void;
+    /** Where the next look reads from (tests). */
+    get position(): number;
+    /** The interval between looks the watch is at now (tests). */
+    get currentInterval(): number;
+    /** Bytes of an unfinished line held between looks — never more than CONSUMED_WATCH.maxLineBytes (tests). */
+    get carriedBytes(): number;
+    stop(): void;
+    private schedule;
+    private end;
+    /**
+     * Whether this watch may still act, asked before the first await and again after each one: stopped, its CLI gone
+     * (stop, pause, respawn) or its lifetime over ends it — a read that returns after any of those proves nothing.
+     */
+    private stillLive;
+    /** One bounded look. Never throws; every outcome either schedules the next look or ends the watch. */
+    look(): Promise<void>;
+    /**
+     * Complete lines of this chunk (plus the carried start of a line), judged once each. Every line is held to
+     * maxLineBytes BEFORE it is decoded — one that completes past the cap is skipped like one that never completes —
+     * and only the lines within it are parsed (#1201 review).
+     */
+    private scan;
+}
+/** The fleet's watches (one process): started per attempt, capped, ended by their own look or by stopAll. */
+export declare class ConsumedWatchRegistry {
+    private readonly active;
+    get size(): number;
+    /** Starts a watch for this attempt; false when one runs already or the fleet is at the cap (logged). */
+    start(target: ConsumedWatchTarget): boolean;
+    /** For tests and shutdown: end every watch without a verdict. */
+    stopAll(): void;
+}
+export declare const consumedWatches: ConsumedWatchRegistry;
+export {};

package/dist/delivery-consumed-watch.js

@@ -0,0 +1,244 @@
+/**
+ * #1201: a late, quiet "consumed" signal for a delivery the CLI took into its own queue — a steer, or a hand-off into
+ * a busy CLI's native queue. Such a delivery settles `delivered` (accepted into the CLI's input) or `uncertain` long
+ * before the model reads it: Claude Code takes a queued message at the next tool boundary or when the turn ends, which
+ * can be minutes later, and records it in its transcript then. The watcher reads the transcript from the attempt's
+ * checkpoint and, on the delivery's exact marker in a consumed shape (transcriptDeltaDeliveryMarker: a user entry, or
+ * Claude's absorbed-mid-turn queued command), records it through the outbox (DeliveryOutbox.markConsumed).
+ *
+ * Positive evidence only: a hit upgrades; a miss, an unreadable file, a fence or the end of the watch change nothing.
+ *
+ * It runs on the fleet's event loop, so it is built not to be felt there (#1235):
+ * - every read is async and bounded: one look reads at most CONSUMED_WATCH.chunkBytes from where the previous one
+ *   stopped, and a larger backlog continues on the following looks;
+ * - only complete lines are parsed, each held to CONSUMED_WATCH.maxLineBytes before it is decoded; a longer one (TUI logs
+ *   can run megabytes without a newline) is skipped whole — complete or not — and proves nothing; the lines after it
+ *   are still judged;
+ * - the number of watches in the process (the fleet) is capped; one over the cap is logged and not started;
+ * - a transcript that does not grow is looked at less and less often, and every watch ends after a fixed lifetime,
+ *   measured on the monotonic clock and checked again after every await (a read that returns late proves nothing).
+ */
+import { open, stat } from "node:fs/promises";
+import { performance } from "node:perf_hooks";
+import { transcriptDeltaDeliveryMarker } from "./delivery-reconciliation.js";
+import { measureSyncWork } from "./sync-work-attribution.js";
+export const CONSUMED_WATCH = {
+    /** Watches alive at once across the fleet. */
+    maxWatchers: 32,
+    /** Bytes one look reads past its offset. */
+    chunkBytes: 256 * 1024,
+    /** A line longer than this (without its newline) is never decoded: skipped. */
+    maxLineBytes: 256 * 1024,
+    /** First interval between looks. */
+    tickMs: 5_000,
+    /** Interval while a backlog is being read (the file is ahead of the offset). */
+    catchUpMs: 50,
+    /** Consecutive looks with no growth before the interval doubles… */
+    idleLooksBeforeBackoff: 6,
+    /** …up to this. */
+    maxTickMs: 60_000,
+    /** A watch ends after this long (monotonic) whatever it saw. */
+    lifetimeMs: 30 * 60_000,
+};
+/** One attempt's watch. Exported for its tests; the fleet starts watches through ConsumedWatchRegistry. */
+export class ConsumedWatch {
+    target;
+    onEnd;
+    offset;
+    carry = Buffer.alloc(0);
+    /** The current line overran maxLineBytes: discard bytes until the next newline. */
+    skippingLine = false;
+    idleLooks = 0;
+    interval = CONSUMED_WATCH.tickMs;
+    timer = null;
+    startedAt = performance.now();
+    ended = false;
+    constructor(target, onEnd) {
+        this.target = target;
+        this.onEnd = onEnd;
+        this.offset = target.offset;
+    }
+    start() { this.schedule(CONSUMED_WATCH.tickMs); }
+    /** Where the next look reads from (tests). */
+    get position() { return this.offset; }
+    /** The interval between looks the watch is at now (tests). */
+    get currentInterval() { return this.interval; }
+    /** Bytes of an unfinished line held between looks — never more than CONSUMED_WATCH.maxLineBytes (tests). */
+    get carriedBytes() { return this.carry.length; }
+    stop() { this.end("stopped"); }
+    schedule(ms) {
+        if (this.ended)
+            return;
+        this.timer = setTimeout(() => { void this.look(); }, ms);
+        this.timer.unref?.();
+    }
+    end(why) {
+        if (this.ended)
+            return;
+        this.ended = true;
+        if (this.timer)
+            clearTimeout(this.timer);
+        this.timer = null;
+        this.onEnd(why);
+    }
+    /**
+     * Whether this watch may still act, asked before the first await and again after each one: stopped, its CLI gone
+     * (stop, pause, respawn) or its lifetime over ends it — a read that returns after any of those proves nothing.
+     */
+    stillLive() {
+        if (this.ended)
+            return false;
+        if (!this.target.current()) {
+            this.end("fenced");
+            return false;
+        }
+        if (performance.now() - this.startedAt >= CONSUMED_WATCH.lifetimeMs) {
+            this.end("expired");
+            return false;
+        }
+        return true;
+    }
+    /** One bounded look. Never throws; every outcome either schedules the next look or ends the watch. */
+    async look() {
+        if (this.ended)
+            return;
+        try {
+            if (!this.stillLive())
+                return;
+            let size;
+            try {
+                size = (await stat(this.target.path)).size;
+            }
+            catch {
+                return this.end("unavailable");
+            }
+            if (!this.stillLive())
+                return;
+            if (size < this.offset)
+                return this.end("unavailable"); // rotated or truncated below our offset
+            if (size === this.offset) {
+                if (++this.idleLooks >= CONSUMED_WATCH.idleLooksBeforeBackoff) {
+                    this.idleLooks = 0;
+                    this.interval = Math.min(this.interval * 2, CONSUMED_WATCH.maxTickMs);
+                }
+                return this.schedule(this.interval);
+            }
+            this.idleLooks = 0;
+            const length = Math.min(CONSUMED_WATCH.chunkBytes, size - this.offset);
+            const chunk = await readAt(this.target.path, this.offset, length);
+            if (!this.stillLive())
+                return;
+            if (!chunk)
+                return this.end("unavailable");
+            this.offset += chunk.length;
+            const found = measureSyncWork("consumedWatch.scan", () => this.scan(chunk));
+            if (found) {
+                this.target.consumed(found.via, found.evidence);
+                return this.end("consumed");
+            }
+            this.schedule(this.offset < size ? CONSUMED_WATCH.catchUpMs : this.interval);
+        }
+        catch (err) {
+            this.target.logger?.warn({ err, deliveryId: this.target.deliveryId }, "Consumed-signal watch failed; it proves nothing either way");
+            this.end("unavailable");
+        }
+    }
+    /**
+     * Complete lines of this chunk (plus the carried start of a line), judged once each. Every line is held to
+     * maxLineBytes BEFORE it is decoded — one that completes past the cap is skipped like one that never completes —
+     * and only the lines within it are parsed (#1201 review).
+     */
+    scan(chunk) {
+        let data = chunk;
+        if (this.skippingLine) {
+            const nl = data.indexOf(0x0a);
+            if (nl < 0)
+                return null; // still inside the oversized line
+            data = data.subarray(nl + 1);
+            this.skippingLine = false;
+        }
+        const buffer = this.carry.length ? Buffer.concat([this.carry, data]) : data;
+        const lastNl = buffer.lastIndexOf(0x0a);
+        let found = null;
+        if (lastNl < 0) {
+            this.carry = buffer;
+        }
+        else {
+            this.carry = buffer.subarray(lastNl + 1);
+            const kept = [];
+            for (let start = 0; start <= lastNl;) {
+                const nl = buffer.indexOf(0x0a, start);
+                if (nl - start <= CONSUMED_WATCH.maxLineBytes)
+                    kept.push(buffer.subarray(start, nl + 1));
+                start = nl + 1;
+            }
+            if (kept.length) {
+                const kind = transcriptDeltaDeliveryMarker(Buffer.concat(kept).toString("utf8"), this.target.backend, this.target.deliveryId);
+                if (kind === "user")
+                    found = { via: "turn", evidence: "transcript-consumed:user-entry" };
+                else if (kind === "absorbed")
+                    found = { via: "mid_turn", evidence: "transcript-consumed:absorbed-mid-turn" };
+            }
+        }
+        if (this.carry.length > CONSUMED_WATCH.maxLineBytes) {
+            this.carry = Buffer.alloc(0);
+            this.skippingLine = true;
+        }
+        return found;
+    }
+}
+async function readAt(path, offset, length) {
+    let fh;
+    try {
+        fh = await open(path, "r");
+    }
+    catch {
+        return null;
+    }
+    try {
+        const buffer = Buffer.alloc(length);
+        let read = 0;
+        while (read < length) {
+            const { bytesRead } = await fh.read(buffer, read, length - read, offset + read);
+            if (bytesRead === 0)
+                break;
+            read += bytesRead;
+        }
+        return buffer.subarray(0, read);
+    }
+    catch {
+        return null;
+    }
+    finally {
+        await fh.close().catch(() => { });
+    }
+}
+/** The fleet's watches (one process): started per attempt, capped, ended by their own look or by stopAll. */
+export class ConsumedWatchRegistry {
+    active = new Map();
+    get size() { return this.active.size; }
+    /** Starts a watch for this attempt; false when one runs already or the fleet is at the cap (logged). */
+    start(target) {
+        const key = `${target.deliveryId}#${target.attemptNo}`;
+        if (this.active.has(key))
+            return false;
+        if (this.active.size >= CONSUMED_WATCH.maxWatchers) {
+            target.logger?.warn({ deliveryId: target.deliveryId, active: this.active.size, cap: CONSUMED_WATCH.maxWatchers }, "Consumed-signal watch not started: the fleet is at its watch cap (the delivery keeps its current state)");
+            return false;
+        }
+        const watch = new ConsumedWatch(target, why => {
+            this.active.delete(key);
+            target.logger?.debug?.({ deliveryId: target.deliveryId, why }, "Consumed-signal watch ended");
+        });
+        this.active.set(key, watch);
+        watch.start();
+        return true;
+    }
+    /** For tests and shutdown: end every watch without a verdict. */
+    stopAll() {
+        for (const watch of [...this.active.values()])
+            watch.stop();
+    }
+}
+export const consumedWatches = new ConsumedWatchRegistry();
+//# sourceMappingURL=delivery-consumed-watch.js.map

package/dist/delivery-consumed-watch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delivery-consumed-watch.js","sourceRoot":"","sources":["../src/delivery-consumed-watch.ts"],"names":[],"mappings":"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"}

package/dist/delivery-outbox.d.ts

@@ -17,7 +17,17 @@ export interface DaemonDeliveryPort {
     get?(deliveryId: string): {
         state: OutboxState;
     } | undefined;
+    /** #1201: the CLI's transcript shows this attempt's delivery consumed (see DeliveryOutbox.markConsumed). */
+    markConsumed?(deliveryId: string, targetBootId: string, attemptNo: number, via: ConsumedVia, evidence: string): MarkConsumedResult;
 }
+/** #1201: how the CLI took the delivery — as its own turn, or absorbed into the running turn at a tool boundary. */
+export type ConsumedVia = "turn" | "mid_turn";
+/**
+ * `marked`: a delivered row now carries consumed_at; `upgraded`: an uncertain row is delivered (its unsent failure
+ * notice cancelled); `already`: it was marked before; `ignored`: a state a transcript hit does not change (failed, a
+ * newer attempt, another boot's attempt).
+ */
+export type MarkConsumedResult = "marked" | "upgraded" | "already" | "ignored";
 export type OutboxState = "queued" | "delivering" | "submission_started" | "reconciliation_pending" | "retry_wait" | "delivered" | "failed" | "uncertain" | "cancelled";
 export interface NewOutboxDelivery {
     operationId: string;
@@ -135,6 +145,17 @@ export interface DeliveryStatusItem {
      * other query, and operator reads, stay redacted as before (#982).
      */
     content?: string | null;
+    /**
+     * How the message was routed, in send_to_instance's own words: `steer` (into the live turn) or `idle_queue` (as the
+     * next message). The fleet decided this at admission; it is the row's kind.
+     */
+    delivery_mode: "steer" | "idle_queue";
+    /** How the latest attempt was written to the pane (`native_queue_handoff`: into the CLI's own queue); null before any. */
+    submission_mode: DurableSubmissionMode | null;
+    /** #1201: when the CLI's transcript showed it consumed — accepted is not read; null until then (or never seen). */
+    consumed_at: string | null;
+    /** #1201: `turn` (taken as its own turn) or `mid_turn` (absorbed into a running turn at a tool boundary). */
+    consumed_via: ConsumedVia | null;
     /** #926: the reply this request is owed, when it asked for one. */
     reply_obligation?: {
         state: "open" | "answered";
@@ -198,6 +219,17 @@ export interface DeliveryReconciliationCandidate extends OutboxDelivery {
         enterStartedAt: string | null;
     };
 }
+/** The exact statement `needsAttention` runs; exported so the plan test checks this text and no copy of it. */
+export declare const NEEDS_ATTENTION_SQL = "\n  SELECT delivery_id, state, source_instance, target_instance, kind, finished_at, last_error\n  FROM deliveries INDEXED BY idx_delivery_attention\n  WHERE state IN ('uncertain','failed') AND acknowledged_at IS NULL AND finished_at >= ?\n  ORDER BY finished_at DESC LIMIT ?";
+export interface NeedsAttentionDelivery {
+    deliveryId: string;
+    state: "uncertain" | "failed";
+    sourceInstance: string;
+    targetInstance: string;
+    kind: string;
+    finishedAt: string;
+    lastError: string | null;
+}
 export interface ClaimedOutboxDelivery extends OutboxDelivery {
     targetDaemonBootId: string;
 }
@@ -270,6 +302,20 @@ export declare class DeliveryOutbox extends EventEmitter {
     listPending(): OutboxDelivery[];
     private listPendingSync;
     /** Rows addressed to `target` in any of `states` (indexed: target_instance, state). */
+    /**
+     * #1386: the deliveries an operator should look at — `uncertain` or `failed`, not acknowledged, finished at or
+     * after `sinceIso` — newest first, at most `limit`. Acknowledged rows are excluded before the cap, and the scan
+     * is held to that time range by requiring the partial index: without `INDEXED BY`, SQLite picks
+     * idx_delivery_state_seq and sorts every uncertain/failed row however old (uncertain rows are never pruned).
+     * A database the migration never reached fails here, loudly, instead of scanning.
+     */
+    needsAttention(sinceIso: string, limit?: number): NeedsAttentionDelivery[];
+    /**
+     * #1386: record that `by` looked at this delivery. One statement, so it is atomic: true only when this call
+     * acknowledged it — false when it was already acknowledged, is no longer uncertain/failed (delivered by later
+     * proof), or does not exist. A write error throws; nothing is remembered as acknowledged elsewhere.
+     */
+    acknowledge(deliveryId: string, by: string, atIso?: string): boolean;
     countForTarget(target: string, states: readonly OutboxState[]): number;
     nextRetryAt(): string | null;
     /** Claim the earliest eligible target row; one caller owns each target lane. */
@@ -282,6 +328,21 @@ export declare class DeliveryOutbox extends EventEmitter {
     /** Safe only when the caller can prove no pane write occurred for this attempt. */
     abort(deliveryId: string, targetBootId: string, attemptNo: number, reason: string): boolean;
     complete(deliveryId: string, targetBootId: string, attemptNo: number, outcome: "delivered" | "failed" | "uncertain", evidence?: string): boolean;
+    /**
+     * #1201: the CLI's own transcript shows this attempt's delivery consumed — its exact `[agend-delivery-id:<id>]`
+     * marker in a user entry or a queued-command prompt, read by the late watcher. Positive evidence only: nothing calls
+     * this on a miss, so it can never downgrade a row.
+     *
+     * - `delivered` → stays delivered, gains consumed_at/consumed_via (no state event: nothing about it changed).
+     * - `uncertain` → `delivered`: last_error cleared, the attempt marked delivered, the reply obligation it never opened
+     *   opened, and its failure notice cancelled — but only while that notice is still unsent (queued / retry_wait). One
+     *   the pump already took is left alone: the protocol tells the sender to check delivery_status after an uncertain
+     *   outcome, which now says delivered.
+     * - anything else (failed, an attempt that is not this one) → `ignored`.
+     *
+     * Fenced like complete(): the row must still be on this boot's attempt.
+     */
+    markConsumed(deliveryId: string, targetBootId: string, attemptNo: number, via: ConsumedVia, evidence: string): MarkConsumedResult;
     /** Transient pre-submit failure: state is retryable and the same row keeps its FIFO position. */
     retryBeforeBegin(deliveryId: string, targetBootId: string, attemptNo: number, reason: string, delayMs?: number): boolean;
     failBeforeBegin(deliveryId: string, reason: string): boolean;