@oh-my-pi/pi-utils 16.4.5 → 16.4.6

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 ## [Unreleased]
 
+## [16.4.6] - 2026-07-12
+
+### Added
+
+- Added `AsyncDrain`, the deferred write-batching helper previously private to the coding-agent's prompt-history storage; now shared with model-perf recording.
+
 ## [16.4.2] - 2026-07-10
 
 ### Added

package/dist/types/async.d.ts

@@ -4,3 +4,17 @@
  * Cleans up all listeners on settlement.
  */
 export declare function withTimeout<T>(promise: Promise<T>, ms: number, message: string, signal?: AbortSignal): Promise<T>;
+/**
+ * Coalesces rapid-fire writes into one deferred batch. `push` queues a value
+ * and returns a promise for the batch flush; the first push of a batch arms a
+ * timer (`delayMs`, or a microtask at 0), and every push before it fires joins
+ * the same batch and shares the same promise. Used to keep hot paths off
+ * synchronous storage (prompt history, model perf).
+ */
+export declare class AsyncDrain<T> {
+    #private;
+    readonly delayMs: number;
+    constructor(delayMs?: number);
+    /** Queue `value`; `hnd` receives the whole batch when the window closes. */
+    push(value: T, hnd: (values: T[]) => Promise<void> | void): Promise<void>;
+}

package/package.json

@@ -1,7 +1,7 @@
 {
 	"type": "module",
 	"name": "@oh-my-pi/pi-utils",
-	"version": "16.4.5",
+	"version": "16.4.6",
 	"description": "Shared utilities for pi packages",
 	"homepage": "https://omp.sh",
 	"author": "Can Boluk",
@@ -31,7 +31,7 @@
 		"fmt": "biome format --write ."
 	},
 	"dependencies": {
-		"@oh-my-pi/pi-natives": "16.4.5",
+		"@oh-my-pi/pi-natives": "16.4.6",
 		"handlebars": "^4.7.9",
 		"winston": "^3.19.0",
 		"winston-daily-rotate-file": "^5.0.0"

package/src/async.ts

@@ -48,3 +48,44 @@ export function withTimeout<T>(promise: Promise<T>, ms: number, message: string,
 
 	return wrapped;
 }
+
+/**
+ * Coalesces rapid-fire writes into one deferred batch. `push` queues a value
+ * and returns a promise for the batch flush; the first push of a batch arms a
+ * timer (`delayMs`, or a microtask at 0), and every push before it fires joins
+ * the same batch and shares the same promise. Used to keep hot paths off
+ * synchronous storage (prompt history, model perf).
+ */
+export class AsyncDrain<T> {
+	#queue?: T[];
+	#promise = Promise.resolve();
+
+	constructor(readonly delayMs: number = 0) {}
+
+	/** Queue `value`; `hnd` receives the whole batch when the window closes. */
+	push(value: T, hnd: (values: T[]) => Promise<void> | void): Promise<void> {
+		let queue = this.#queue;
+		if (!queue) {
+			this.#queue = queue = [];
+			const { promise, resolve, reject } = Promise.withResolvers<void>();
+			const exec = (): void => {
+				try {
+					if (this.#queue === queue) {
+						this.#queue = undefined;
+					}
+					resolve(hnd(queue!));
+				} catch (error) {
+					reject(error);
+				}
+			};
+			if (this.delayMs > 0) {
+				setTimeout(exec, this.delayMs);
+			} else {
+				queueMicrotask(exec);
+			}
+			this.#promise = promise;
+		}
+		queue.push(value);
+		return this.#promise;
+	}
+}