@rulvar/cli 1.92.0 → 1.94.0

package/dist/index.d.ts

@@ -256,9 +256,12 @@ interface CreateServerOptions {
   * and counted. A replay that no longer reaches back to a client's
   * cursor carries `x-rulvar-events-dropped: <count>` and a leading SSE
   * comment naming the first retained seq; the journal remains the
-  * durable record of the run itself. Absent means unbounded (the
-  * historical behavior). Validated at construction: a positive safe
-  * integer, anything else is a typed ConfigError.
+  * durable record of the run itself. Defaults to
+  * {@link DEFAULT_MAX_BUFFERED_EVENTS_PER_RUN} (RV409; before v1.94.0
+  * absent meant unbounded, and an explicit huge bound such as
+  * `Number.MAX_SAFE_INTEGER` restores that behavior in effect).
+  * Validated at construction: a positive safe integer, anything else
+  * is a typed ConfigError.
   */
   maxBufferedEventsPerRun?: number;
   /**
@@ -284,6 +287,18 @@ interface CreateServerOptions {
 * cannot grow process memory past a few megabytes per connection.
 */
 declare const DEFAULT_MAX_PENDING_EVENTS_PER_CLIENT = 1e4;
+/**
+* The default per-run replay-buffer bound (RV409): generous enough
+* that any ordinary run keeps its full replay (lifecycle events number
+* in the hundreds; only long `agent:stream` delta torrents approach
+* tens of thousands), small enough that one delta-heavy run cannot
+* grow process memory past a few tens of megabytes. Past the bound the
+* oldest events are dropped and the replay marks the gap; the journal
+* remains the durable record. Before v1.94.0 an absent
+* `maxBufferedEventsPerRun` meant unbounded; set an explicit huge
+* bound (`Number.MAX_SAFE_INTEGER`) to restore that in effect.
+*/
+declare const DEFAULT_MAX_BUFFERED_EVENTS_PER_RUN = 5e4;
 interface RulvarServer {
   fetch(req: Request): Promise<Response>;
 }
@@ -416,4 +431,4 @@ declare function toOtel(run: {
   result: Promise<RunOutcome<unknown>>;
 }, tracer: TracerLike, options?: ToOtelOptions): Promise<number>;
 //#endregion
-export { type AssembledCli, type CliConfig, type CliIo, type CommandContext, type CreateServerOptions, type CreateWorkerOptions, DEFAULT_MAX_PENDING_EVENTS_PER_CLIENT, DEFAULT_STORE_DIR, DEFAULT_WORKER_TTL_MS, HELP, type KbSweepCliConfig, type LoadedWorkflowModule, type OtelContextApi, type PreflightDeclaration, type RulvarServer, type SpanLike, type ToOtelOptions, type TracerLike, type Worker, assembleEngine, attachProgress, createServer, createWorker, driveRun, inspectCommand, invoiceCommand, loadCliConfig, loadWorkflowModule, looksLikeFile, preflightCommand, processIo, renderEventLine, reportOutcome, resumeCommand, runCli, runCommand, runsLsCommand, strictExitCode, toOtel };
+export { type AssembledCli, type CliConfig, type CliIo, type CommandContext, type CreateServerOptions, type CreateWorkerOptions, DEFAULT_MAX_BUFFERED_EVENTS_PER_RUN, DEFAULT_MAX_PENDING_EVENTS_PER_CLIENT, DEFAULT_STORE_DIR, DEFAULT_WORKER_TTL_MS, HELP, type KbSweepCliConfig, type LoadedWorkflowModule, type OtelContextApi, type PreflightDeclaration, type RulvarServer, type SpanLike, type ToOtelOptions, type TracerLike, type Worker, assembleEngine, attachProgress, createServer, createWorker, driveRun, inspectCommand, invoiceCommand, loadCliConfig, loadWorkflowModule, looksLikeFile, preflightCommand, processIo, renderEventLine, reportOutcome, resumeCommand, runCli, runCommand, runsLsCommand, strictExitCode, toOtel };

package/dist/index.js

@@ -42,6 +42,18 @@ import { ConfigError, InvalidResolutionError, JournalCompatibilityError, LeaseHe
 * cannot grow process memory past a few megabytes per connection.
 */
 const DEFAULT_MAX_PENDING_EVENTS_PER_CLIENT = 1e4;
+/**
+* The default per-run replay-buffer bound (RV409): generous enough
+* that any ordinary run keeps its full replay (lifecycle events number
+* in the hundreds; only long `agent:stream` delta torrents approach
+* tens of thousands), small enough that one delta-heavy run cannot
+* grow process memory past a few tens of megabytes. Past the bound the
+* oldest events are dropped and the replay marks the gap; the journal
+* remains the durable record. Before v1.94.0 an absent
+* `maxBufferedEventsPerRun` meant unbounded; set an explicit huge
+* bound (`Number.MAX_SAFE_INTEGER`) to restore that in effect.
+*/
+const DEFAULT_MAX_BUFFERED_EVENTS_PER_RUN = 5e4;
 const JSON_HEADERS = { "content-type": "application/json; charset=utf-8" };
 const wallClock = Date.now.bind(globalThis);
 function json(status, body) {
@@ -100,20 +112,20 @@ function createServer(options) {
 	requireCap("maxTrackedRuns", options.maxTrackedRuns, 0);
 	requireCap("maxBufferedEventsPerRun", options.maxBufferedEventsPerRun, 1);
 	requireCap("maxPendingEventsPerClient", options.maxPendingEventsPerClient, 1);
+	const bufferCap = options.maxBufferedEventsPerRun ?? 5e4;
 	const pendingCap = options.maxPendingEventsPerClient ?? 1e4;
 	const journal = engine.stores.journal;
 	const runs = /* @__PURE__ */ new Map();
 	/**
-	* Buffers one event under the configured bound. Overflow drops the
+	* Buffers one event under the resolved bound. Overflow drops the
 	* oldest chunk (an eighth of the bound) in one splice, so the
 	* amortized cost per event stays O(1) and the retained window never
 	* falls below seven eighths of the bound.
 	*/
 	function pushBuffered(run, event) {
 		run.buffer.push(event);
-		const max = options.maxBufferedEventsPerRun;
-		if (max !== void 0 && run.buffer.length > max) {
-			const chunk = Math.max(1, Math.floor(max / 8));
+		if (run.buffer.length > bufferCap) {
+			const chunk = Math.max(1, Math.floor(bufferCap / 8));
 			run.buffer.splice(0, chunk);
 			run.dropped += chunk;
 		}
@@ -1020,4 +1032,4 @@ async function toOtel(run, tracer, options = {}) {
 	return created;
 }
 //#endregion
-export { DEFAULT_MAX_PENDING_EVENTS_PER_CLIENT, DEFAULT_STORE_DIR, DEFAULT_WORKER_TTL_MS, HELP, assembleEngine, attachProgress, createServer, createWorker, driveRun, inspectCommand, invoiceCommand, loadCliConfig, loadWorkflowModule, looksLikeFile, preflightCommand, processIo, renderEventLine, reportOutcome, resumeCommand, runCli, runCommand, runsLsCommand, strictExitCode, toOtel };
+export { DEFAULT_MAX_BUFFERED_EVENTS_PER_RUN, DEFAULT_MAX_PENDING_EVENTS_PER_CLIENT, DEFAULT_STORE_DIR, DEFAULT_WORKER_TTL_MS, HELP, assembleEngine, attachProgress, createServer, createWorker, driveRun, inspectCommand, invoiceCommand, loadCliConfig, loadWorkflowModule, looksLikeFile, preflightCommand, processIo, renderEventLine, reportOutcome, resumeCommand, runCli, runCommand, runsLsCommand, strictExitCode, toOtel };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rulvar/cli",
-  "version": "1.92.0",
+  "version": "1.94.0",
   "description": "Rulvar shell: run/resume/runs/inspect/plan/kb commands, TUI progress, createServer, createWorker, OTel exporter.",
   "type": "module",
   "license": "Apache-2.0",
@@ -22,17 +22,17 @@
     "access": "public"
   },
   "dependencies": {
-    "@rulvar/core": "1.92.0"
+    "@rulvar/core": "1.94.0"
   },
   "devDependencies": {
     "@types/node": "^22.20.1",
     "tsdown": "^0.22.14",
     "typescript": "~6.0.3",
-    "@rulvar/store-sqlite": "1.92.0",
-    "@rulvar/plan": "1.92.0",
-    "@rulvar/planner": "1.92.0",
-    "@rulvar/testing": "1.92.0",
-    "@rulvar/evals": "1.92.0"
+    "@rulvar/testing": "1.94.0",
+    "@rulvar/planner": "1.94.0",
+    "@rulvar/evals": "1.94.0",
+    "@rulvar/plan": "1.94.0",
+    "@rulvar/store-sqlite": "1.94.0"
   },
   "bin": {
     "rulvar": "./dist/cli.js"