@jini-ai/daemon 0.2.1 → 0.3.0

package/dist/run/diagnostics/diagnostics.js

@@ -100,6 +100,137 @@ export function collectStderrTailSummary(events = [], redact = identityRedactor)
 export function collectStdoutTailSummary(events = [], redact = identityRedactor) {
     return collectStreamTailSummary(events, 'stdout', readStdoutChunk, redact);
 }
+/** The set of `rpc_close_reason` strings a `runtime_close` diagnostic may legitimately carry. */
+const RECOGNIZED_CLOSE_REASONS = new Set([
+    'exit_0',
+    'exit_nonzero',
+    'signal',
+    'cancel_requested',
+    'stream_error',
+    'fatal_rpc_error',
+    'empty_output',
+    'unknown',
+]);
+/** Coerces an event's `data` to a property bag so `data.type` probing never throws on a scalar/array payload. */
+function eventDataRecord(data) {
+    return data && typeof data === 'object' ? data : {};
+}
+/**
+ * Reads the authoritative close reason a driver recorded on a `runtime_close` diagnostic event,
+ * or `null` when this event carries none (or carries an unrecognized value).
+ */
+function readRecordedCloseReason(event, data) {
+    if (event.event !== 'diagnostic' || data.type !== 'runtime_close')
+        return null;
+    const reason = data.rpc_close_reason;
+    if (typeof reason !== 'string')
+        return null;
+    return RECOGNIZED_CLOSE_REASONS.has(reason) ? reason : null;
+}
+/** True when this event is a non-empty streamed text/thinking delta — i.e. output a user actually saw. */
+function hasVisibleTextDelta(data) {
+    if (data.type !== 'text_delta' && data.type !== 'thinking_delta')
+        return false;
+    return typeof data.delta === 'string' && data.delta.length > 0;
+}
+/** Accumulates the raw stderr/stdout text carried by this event, if it is a stream chunk. */
+function accumulateStreamChunk(observed, event) {
+    if (event.event === 'stderr') {
+        const chunk = readStderrChunk(event.data);
+        if (chunk)
+            observed.stderr += chunk;
+        return;
+    }
+    if (event.event === 'stdout') {
+        const chunk = readStdoutChunk(event.data);
+        if (chunk) {
+            observed.stdout += chunk;
+            observed.userVisibleOutputSeen = true;
+        }
+    }
+}
+/** Latches the observed-behavior flags (visible output, tool calls, artifacts, resume re-seed) for one event. */
+function accumulateObservedFlags(observed, event, data) {
+    if (hasVisibleTextDelta(data))
+        observed.userVisibleOutputSeen = true;
+    if (data.type === 'tool_use')
+        observed.toolCallSeen = true;
+    if (data.type === 'artifact')
+        observed.artifactWriteSeen = true;
+    if (data.type === 'live_artifact' || event.event === 'live_artifact') {
+        observed.liveArtifactSeen = true;
+    }
+    if (event.event === 'diagnostic' && data.type === 'agent_resume_auto_reseed') {
+        observed.resumeAutoReseeded = true;
+    }
+}
+/** Folds one event into the accumulator. */
+function accumulateEvent(observed, event) {
+    if (event.event === 'error')
+        observed.hasErrorEvent = true;
+    accumulateStreamChunk(observed, event);
+    const data = eventDataRecord(event.data);
+    accumulateObservedFlags(observed, event, data);
+    const closeReason = readRecordedCloseReason(event, data);
+    if (closeReason)
+        observed.recordedCloseReason = closeReason;
+}
+/**
+ * Single pass over a run's event list collecting every diagnostic signal the analytics payload
+ * needs. Seeded with the daemon-supplied artifact flags so an event stream that never mentions an
+ * artifact still reports what finalization already knew.
+ */
+function scanRunEvents(events, seed) {
+    const observed = {
+        stderr: '',
+        stdout: '',
+        hasErrorEvent: false,
+        userVisibleOutputSeen: false,
+        toolCallSeen: false,
+        artifactWriteSeen: seed.artifactWriteSeen,
+        liveArtifactSeen: seed.liveArtifactSeen,
+        recordedCloseReason: null,
+        resumeAutoReseeded: false,
+    };
+    for (const event of events) {
+        accumulateEvent(observed, event);
+    }
+    return observed;
+}
+/** Picks the single most informative signal available about why the run ended, in priority order. */
+function resolveDiagnosticSource(signals) {
+    if (signals.hasErrorEvent)
+        return 'error_event';
+    if (signals.stderrPresent)
+        return 'stderr';
+    if (signals.signal)
+        return 'signal';
+    if (typeof signals.exitCode === 'number')
+        return 'exit_code';
+    return 'unknown';
+}
+/**
+ * Resolves the mechanism that closed the run. A reason a driver explicitly recorded always wins;
+ * otherwise the daemon's own finalization flags are consulted in priority order, falling back to
+ * the raw process exit signal/code.
+ */
+function resolveRpcCloseReason(recordedCloseReason, signals) {
+    if (recordedCloseReason)
+        return recordedCloseReason;
+    if (signals.cancelRequested === true)
+        return 'cancel_requested';
+    if (signals.fatalRpcErrorSeen === true)
+        return 'fatal_rpc_error';
+    if (signals.streamErrorSeen === true)
+        return 'stream_error';
+    if (signals.emptyOutputFailure === true)
+        return 'empty_output';
+    if (signals.signal)
+        return 'signal';
+    if (typeof signals.exitCode !== 'number')
+        return 'unknown';
+    return signals.exitCode === 0 ? 'exit_0' : 'exit_nonzero';
+}
 /**
  * Produces the full `RunDiagnosticsAnalytics` payload for a completed run by scanning its event stream
  * and combining observed flags (tool calls, artifact writes, first token) with process-level signals.
@@ -107,105 +238,32 @@ export function collectStdoutTailSummary(events = [], redact = identityRedactor)
  * @returns A `RunDiagnosticsAnalytics` object ready to spread into the `run_finished` analytics event.
  */
 export function summarizeRunDiagnosticsForAnalytics(args) {
-    const events = args.events ?? [];
-    let stderr = '';
-    let stdout = '';
-    let userVisibleOutputSeen = false;
-    let toolCallSeen = false;
-    let artifactWriteSeen = args.artifactWriteSeen === true;
-    let liveArtifactSeen = args.liveArtifactSeen === true;
-    let recordedCloseReason = null;
-    let resumeAutoReseeded = false;
-    for (const event of events) {
-        if (event.event === 'stderr') {
-            const chunk = readStderrChunk(event.data);
-            if (chunk)
-                stderr += chunk;
-        }
-        if (event.event === 'stdout') {
-            const chunk = readStdoutChunk(event.data);
-            if (chunk) {
-                stdout += chunk;
-                userVisibleOutputSeen = true;
-            }
-        }
-        const data = event.data && typeof event.data === 'object'
-            ? event.data
-            : {};
-        if (data.type === 'text_delta' || data.type === 'thinking_delta') {
-            const delta = typeof data.delta === 'string' ? data.delta : '';
-            if (delta.length > 0)
-                userVisibleOutputSeen = true;
-        }
-        if (data.type === 'tool_use')
-            toolCallSeen = true;
-        if (event.event === 'diagnostic' && data.type === 'agent_resume_auto_reseed') {
-            resumeAutoReseeded = true;
-        }
-        if (data.type === 'artifact')
-            artifactWriteSeen = true;
-        if (data.type === 'live_artifact' || event.event === 'live_artifact') {
-            liveArtifactSeen = true;
-        }
-        if (event.event === 'diagnostic' &&
-            data.type === 'runtime_close' &&
-            typeof data.rpc_close_reason === 'string') {
-            const reason = data.rpc_close_reason;
-            if (reason === 'exit_0' ||
-                reason === 'exit_nonzero' ||
-                reason === 'signal' ||
-                reason === 'cancel_requested' ||
-                reason === 'stream_error' ||
-                reason === 'fatal_rpc_error' ||
-                reason === 'empty_output' ||
-                reason === 'unknown') {
-                recordedCloseReason = reason;
-            }
-        }
-    }
-    const stderrLineCount = countLines(stderr);
-    const stdoutLineCount = countLines(stdout);
-    const hasErrorEvent = events.some((event) => event.event === 'error');
+    const observed = scanRunEvents(args.events ?? [], {
+        artifactWriteSeen: args.artifactWriteSeen === true,
+        liveArtifactSeen: args.liveArtifactSeen === true,
+    });
+    const stderrLineCount = countLines(observed.stderr);
+    const stdoutLineCount = countLines(observed.stdout);
     const stderrPresent = stderrLineCount > 0;
     const stdoutPresent = stdoutLineCount > 0;
-    let diagnosticSource = 'unknown';
-    if (hasErrorEvent)
-        diagnosticSource = 'error_event';
-    else if (stderrPresent)
-        diagnosticSource = 'stderr';
-    else if (args.signal)
-        diagnosticSource = 'signal';
-    else if (typeof args.exitCode === 'number')
-        diagnosticSource = 'exit_code';
-    let rpcCloseReason = 'unknown';
-    if (recordedCloseReason)
-        rpcCloseReason = recordedCloseReason;
-    else if (args.cancelRequested === true)
-        rpcCloseReason = 'cancel_requested';
-    else if (args.fatalRpcErrorSeen === true)
-        rpcCloseReason = 'fatal_rpc_error';
-    else if (args.streamErrorSeen === true)
-        rpcCloseReason = 'stream_error';
-    else if (args.emptyOutputFailure === true)
-        rpcCloseReason = 'empty_output';
-    else if (args.signal)
-        rpcCloseReason = 'signal';
-    else if (typeof args.exitCode === 'number') {
-        rpcCloseReason = args.exitCode === 0 ? 'exit_0' : 'exit_nonzero';
-    }
     return {
-        diagnostic_source: diagnosticSource,
+        diagnostic_source: resolveDiagnosticSource({
+            hasErrorEvent: observed.hasErrorEvent,
+            stderrPresent,
+            signal: args.signal,
+            exitCode: args.exitCode,
+        }),
         stderr_present: stderrPresent,
         stderr_line_count_bucket: stderrLineCountBucket(stderrLineCount),
         stdout_present: stdoutPresent,
         stdout_line_count_bucket: stderrLineCountBucket(stdoutLineCount),
-        rpc_close_reason: rpcCloseReason,
+        rpc_close_reason: resolveRpcCloseReason(observed.recordedCloseReason, args),
         first_token_seen: args.firstTokenSeen === true,
-        user_visible_output_seen: userVisibleOutputSeen,
-        tool_call_seen: toolCallSeen,
-        artifact_write_seen: artifactWriteSeen,
-        live_artifact_seen: liveArtifactSeen,
-        resume_auto_reseeded: resumeAutoReseeded,
+        user_visible_output_seen: observed.userVisibleOutputSeen,
+        tool_call_seen: observed.toolCallSeen,
+        artifact_write_seen: observed.artifactWriteSeen,
+        live_artifact_seen: observed.liveArtifactSeen,
+        resume_auto_reseeded: observed.resumeAutoReseeded,
     };
 }
 //# sourceMappingURL=diagnostics.js.map

package/dist/run/diagnostics/diagnostics.js.map

@@ -1 +1 @@
-{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../../src/run/diagnostics/diagnostics.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"diagnostics.js","sourceRoot":"","sources":["../../../src/run/diagnostics/diagnostics.ts"],"names":[],"mappings":"AAAA,qIAAqI;AAWrI,MAAM,gBAAgB,GAAiB,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC;AAmEtD,MAAM,qBAAqB,GAAG,EAAE,CAAC;AACjC,MAAM,qBAAqB,GAAG,CAAC,GAAG,IAAI,CAAC;AAEvC,SAAS,eAAe,CAAC,IAAa;IACpC,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1E,MAAM,GAAG,GAAG,IAA+B,CAAC;IAC5C,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC;IACpD,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC,IAAI,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,eAAe,CAAC,IAAa;IACpC,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC1C,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IAC1E,MAAM,GAAG,GAAG,IAA+B,CAAC;IAC5C,IAAI,OAAO,GAAG,CAAC,KAAK,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC;IACpD,IAAI,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ;QAAE,OAAO,GAAG,CAAC,IAAI,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC;AACtE,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAa;IACjD,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IAC9B,IAAI,KAAK,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7B,IAAI,KAAK,IAAI,EAAE;QAAE,OAAO,MAAM,CAAC;IAC/B,IAAI,KAAK,IAAI,GAAG;QAAE,OAAO,QAAQ,CAAC;IAClC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,YAAY,CAAC,KAAa,EAAE,QAAgB;IAInD,MAAM,KAAK,GAAG,MAAM,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC/C,IAAI,KAAK,IAAI,QAAQ;QAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IAC1D,IAAI,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;IACvB,OAAO,GAAG,GAAG,CAAC,IAAI,MAAM,CAAC,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,CAAC,GAAG,QAAQ,EAAE,CAAC;QAC5E,GAAG,IAAI,CAAC,CAAC;IACX,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;AACzD,CAAC;AAED,SAAS,wBAAwB,CAC/B,MAAgC,EAChC,SAAiB,EACjB,SAA2C,EAC3C,MAAoB;IAEpB,IAAI,UAAU,GAAG,EAAE,CAAC;IACpB,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS;YAAE,SAAS;QACxC,MAAM,KAAK,GAAG,SAAS,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,KAAK;YAAE,UAAU,IAAI,KAAK,CAAC;IACjC,CAAC;IACD,MAAM,SAAS,GAAG,UAAU,CAAC,UAAU,CAAC,CAAC;IACzC,IAAI,SAAS,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IAErC,MAAM,KAAK,GAAG,UAAU,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IAClD,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,qBAAqB,CAAC,CAAC;IACtD,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC;IACtD,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9C,MAAM,UAAU,GAAG,YAAY,CAAC,QAAQ,EAAE,qBAAqB,CAAC,CAAC;IAEjE,OAAO;QACL,IAAI,EAAE,UAAU,CAAC,KAAK;QACtB,SAAS;QACT,SAAS,EAAE,aAAa,IAAI,UAAU,CAAC,SAAS;KACjD,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,SAAmC,EAAE,EACrC,SAAuB,gBAAgB;IAEvC,OAAO,wBAAwB,CAAC,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;AAC7E,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,wBAAwB,CACtC,SAAmC,EAAE,EACrC,SAAuB,gBAAgB;IAEvC,OAAO,wBAAwB,CAAC,MAAM,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;AAC7E,CAAC;AAED,iGAAiG;AACjG,MAAM,wBAAwB,GAAwB,IAAI,GAAG,CAAiB;IAC5E,QAAQ;IACR,cAAc;IACd,QAAQ;IACR,kBAAkB;IAClB,cAAc;IACd,iBAAiB;IACjB,cAAc;IACd,SAAS;CACV,CAAC,CAAC;AAEH,iHAAiH;AACjH,SAAS,eAAe,CAAC,IAAa;IACpC,OAAO,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAA+B,CAAC,CAAC,CAAC,EAAE,CAAC;AACjF,CAAC;AAED;;;GAGG;AACH,SAAS,uBAAuB,CAC9B,KAA6B,EAC7B,IAA6B;IAE7B,IAAI,KAAK,CAAC,KAAK,KAAK,YAAY,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe;QAAE,OAAO,IAAI,CAAC;IAC/E,MAAM,MAAM,GAAG,IAAI,CAAC,gBAAgB,CAAC;IACrC,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC5C,OAAO,wBAAwB,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAwB,CAAC,CAAC,CAAC,IAAI,CAAC;AAChF,CAAC;AAED,0GAA0G;AAC1G,SAAS,mBAAmB,CAAC,IAA6B;IACxD,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,IAAI,IAAI,CAAC,IAAI,KAAK,gBAAgB;QAAE,OAAO,KAAK,CAAC;IAC/E,OAAO,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACjE,CAAC;AAeD,6FAA6F;AAC7F,SAAS,qBAAqB,CAAC,QAA8B,EAAE,KAA6B;IAC1F,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,KAAK;YAAE,QAAQ,CAAC,MAAM,IAAI,KAAK,CAAC;QACpC,OAAO;IACT,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC7B,MAAM,KAAK,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,KAAK,EAAE,CAAC;YACV,QAAQ,CAAC,MAAM,IAAI,KAAK,CAAC;YACzB,QAAQ,CAAC,qBAAqB,GAAG,IAAI,CAAC;QACxC,CAAC;IACH,CAAC;AACH,CAAC;AAED,iHAAiH;AACjH,SAAS,uBAAuB,CAC9B,QAA8B,EAC9B,KAA6B,EAC7B,IAA6B;IAE7B,IAAI,mBAAmB,CAAC,IAAI,CAAC;QAAE,QAAQ,CAAC,qBAAqB,GAAG,IAAI,CAAC;IACrE,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;QAAE,QAAQ,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3D,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;QAAE,QAAQ,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAChE,IAAI,IAAI,CAAC,IAAI,KAAK,eAAe,IAAI,KAAK,CAAC,KAAK,KAAK,eAAe,EAAE,CAAC;QACrE,QAAQ,CAAC,gBAAgB,GAAG,IAAI,CAAC;IACnC,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,KAAK,YAAY,IAAI,IAAI,CAAC,IAAI,KAAK,0BAA0B,EAAE,CAAC;QAC7E,QAAQ,CAAC,kBAAkB,GAAG,IAAI,CAAC;IACrC,CAAC;AACH,CAAC;AAED,4CAA4C;AAC5C,SAAS,eAAe,CAAC,QAA8B,EAAE,KAA6B;IACpF,IAAI,KAAK,CAAC,KAAK,KAAK,OAAO;QAAE,QAAQ,CAAC,aAAa,GAAG,IAAI,CAAC;IAC3D,qBAAqB,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACvC,MAAM,IAAI,GAAG,eAAe,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACzC,uBAAuB,CAAC,QAAQ,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAC/C,MAAM,WAAW,GAAG,uBAAuB,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;IACzD,IAAI,WAAW;QAAE,QAAQ,CAAC,mBAAmB,GAAG,WAAW,CAAC;AAC9D,CAAC;AAED;;;;GAIG;AACH,SAAS,aAAa,CACpB,MAAgC,EAChC,IAA+D;IAE/D,MAAM,QAAQ,GAAyB;QACrC,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,EAAE;QACV,aAAa,EAAE,KAAK;QACpB,qBAAqB,EAAE,KAAK;QAC5B,YAAY,EAAE,KAAK;QACnB,iBAAiB,EAAE,IAAI,CAAC,iBAAiB;QACzC,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;QACvC,mBAAmB,EAAE,IAAI;QACzB,kBAAkB,EAAE,KAAK;KAC1B,CAAC;IACF,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;IACnC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,qGAAqG;AACrG,SAAS,uBAAuB,CAAC,OAKhC;IACC,IAAI,OAAO,CAAC,aAAa;QAAE,OAAO,aAAa,CAAC;IAChD,IAAI,OAAO,CAAC,aAAa;QAAE,OAAO,QAAQ,CAAC;IAC3C,IAAI,OAAO,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC;IACpC,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,WAAW,CAAC;IAC7D,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;GAIG;AACH,SAAS,qBAAqB,CAC5B,mBAA0C,EAC1C,OAOC;IAED,IAAI,mBAAmB;QAAE,OAAO,mBAAmB,CAAC;IACpD,IAAI,OAAO,CAAC,eAAe,KAAK,IAAI;QAAE,OAAO,kBAAkB,CAAC;IAChE,IAAI,OAAO,CAAC,iBAAiB,KAAK,IAAI;QAAE,OAAO,iBAAiB,CAAC;IACjE,IAAI,OAAO,CAAC,eAAe,KAAK,IAAI;QAAE,OAAO,cAAc,CAAC;IAC5D,IAAI,OAAO,CAAC,kBAAkB,KAAK,IAAI;QAAE,OAAO,cAAc,CAAC;IAC/D,IAAI,OAAO,CAAC,MAAM;QAAE,OAAO,QAAQ,CAAC;IACpC,IAAI,OAAO,OAAO,CAAC,QAAQ,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAC3D,OAAO,OAAO,CAAC,QAAQ,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC;AAC5D,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,mCAAmC,CAAC,IAWnD;IACC,MAAM,QAAQ,GAAG,aAAa,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,EAAE;QAChD,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,KAAK,IAAI;QAClD,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,KAAK,IAAI;KACjD,CAAC,CAAC;IACH,MAAM,eAAe,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,eAAe,GAAG,UAAU,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACpD,MAAM,aAAa,GAAG,eAAe,GAAG,CAAC,CAAC;IAC1C,MAAM,aAAa,GAAG,eAAe,GAAG,CAAC,CAAC;IAE1C,OAAO;QACL,iBAAiB,EAAE,uBAAuB,CAAC;YACzC,aAAa,EAAE,QAAQ,CAAC,aAAa;YACrC,aAAa;YACb,MAAM,EAAE,IAAI,CAAC,MAAM;YACnB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC;QACF,cAAc,EAAE,aAAa;QAC7B,wBAAwB,EAAE,qBAAqB,CAAC,eAAe,CAAC;QAChE,cAAc,EAAE,aAAa;QAC7B,wBAAwB,EAAE,qBAAqB,CAAC,eAAe,CAAC;QAChE,gBAAgB,EAAE,qBAAqB,CAAC,QAAQ,CAAC,mBAAmB,EAAE,IAAI,CAAC;QAC3E,gBAAgB,EAAE,IAAI,CAAC,cAAc,KAAK,IAAI;QAC9C,wBAAwB,EAAE,QAAQ,CAAC,qBAAqB;QACxD,cAAc,EAAE,QAAQ,CAAC,YAAY;QACrC,mBAAmB,EAAE,QAAQ,CAAC,iBAAiB;QAC/C,kBAAkB,EAAE,QAAQ,CAAC,gBAAgB;QAC7C,oBAAoB,EAAE,QAAQ,CAAC,kBAAkB;KAClD,CAAC;AACJ,CAAC"}

package/dist/run-lifecycle.d.ts

@@ -1,6 +1,6 @@
-import type { RunAgentPayload, RunCancelRequest, RunChunkPayload, RunErrorPayload, RunProtocolEvent, RunStatus } from '@jini-ai/protocol';
-import type { EventLog, EventLogReplayResult } from './event-log.js';
-import type { TerminalRunOutcome } from './close-status.js';
+import type { RunAgentPayload, RunCancelRequest, RunChunkPayload, RunErrorPayload, RunProtocolEvent, RunStartPayload, RunStatus } from '@jini-ai/protocol';
+import type { EventLog, EventLogEntry, EventLogReplayResult } from './event-log.js';
+import type { InactivityWatchdog, TerminalRunOutcome } from './close-status.js';
 export interface StartRunInput {
     /** Opaque caller-supplied identity the run belongs to — never a project/conversation id (see module doc). */
     readonly contextRef: string;
@@ -96,10 +96,88 @@ export interface RunLifecycle {
      */
     stream(runId: string, onEvent: (event: RunProtocolEvent) => void, options?: StreamOptions): Promise<StreamSubscribeResult>;
 }
+/**
+ * `start()`'s idempotency-replay lookup: the run id an existing `idempotencyKey` already maps to,
+ * or `undefined` when there is no key or no existing mapping (a fresh start proceeds normally).
+ * Pure.
+ */
+export declare function resolveIdempotentReplayRunId(idempotencyIndex: ReadonlyMap<string, string>, idempotencyKey: string | undefined): string | undefined;
+/** Registers `runId` under `idempotencyKey` in `idempotencyIndex` — a no-op when no key was supplied. */
+export declare function registerIdempotencyKeyIfPresent(idempotencyIndex: Map<string, string>, idempotencyKey: string | undefined, runId: string): void;
+/**
+ * Removes `idempotencyKey`'s mapping from `idempotencyIndex`, but only when it still points at
+ * `runId` — used to roll back a failed durable `'start'` append without clobbering a different
+ * run that may have since claimed the same key (defensive; `start()`'s own locking makes that
+ * race unreachable today, but the check costs nothing and documents the invariant).
+ */
+export declare function clearIdempotencyIndexEntryIfMatching(idempotencyIndex: Map<string, string>, idempotencyKey: string | undefined, runId: string): void;
+/**
+ * Default terminal-run retention window: how long a completed/failed/cancelled run's in-memory
+ * record stays readable via `get`/`list`/`stream`/`resume` before eviction. `runs.set()` never had
+ * a matching `runs.delete()` for a run that finishes normally — every terminal run's record was kept
+ * for the daemon process's entire lifetime, unbounded by run volume or uptime. Terminal runs are
+ * still read after they end (status polling, run-history listing, stream reconnects), so the fix
+ * cannot be "delete on completion" — this bounds *how long* a terminal record survives instead of
+ * deleting it immediately. 24h comfortably covers same-day polling/listing/reconnect without
+ * retaining every run a long-lived daemon ever processed.
+ */
+export declare const DEFAULT_TERMINAL_RETENTION_MS: number;
+/**
+ * Default hard cap on concurrently-retained terminal run records, independent of
+ * {@link DEFAULT_TERMINAL_RETENTION_MS} — the oldest terminal record is evicted once this is
+ * exceeded. A TTL alone does not bound memory when runs complete faster than they age out (a burst
+ * arriving within the retention window keeps growing); this cap gives a true worst-case bound
+ * regardless of arrival rate.
+ */
+export declare const DEFAULT_MAX_TERMINAL_RUNS = 1000;
+/**
+ * How long a just-terminal run should remain retained before its eviction timer fires: `retentionMs`
+ * minus however much of that window has already elapsed since `terminalAt`. Floored at `0` so a run
+ * that was already past its retention window when this is computed (relevant for `rehydrate()`,
+ * where a run may have gone terminal long before this process started) schedules an immediate
+ * eviction rather than a negative-delay timer. Pure.
+ */
+export declare function computeRetentionDelayMs(terminalAt: number, retentionMs: number, now: number): number;
+/** The durable `'start'` entry's payload — pure field mapping, split out of `start()` so its two optional-field spreads don't count toward that method's own complexity. */
+export declare function buildStartPayload(runId: string, startInput: Pick<StartRunInput, 'contextRef' | 'agentId' | 'idempotencyKey'>): RunStartPayload;
+/**
+ * Arms `record.watchdog` when `timeoutMs` is configured — a no-op otherwise. `record` is typed as a
+ * plain `{watchdog}` shape (not `Pick<RunRecord, 'watchdog'>`) purely so this function can be
+ * exported without naming the private `RunRecord` type in a public signature.
+ */
+export declare function armWatchdogIfConfigured(record: {
+    watchdog: InactivityWatchdog | undefined;
+}, timeoutMs: number | undefined, onTimeout: () => void): void;
+/**
+ * `stream()`'s replay-delivery step: sends every already-durable entry to `onEvent`, returning the
+ * delivered eventIds so a caller can avoid re-delivering the same event from a different source
+ * (buffered live events observed during the replay, a terminal catch-up event). Pure aside from
+ * calling the injected `onEvent`.
+ */
+export declare function deliverReplayedEvents(runId: string, entries: readonly EventLogEntry[], onEvent: (event: RunProtocolEvent) => void): Set<string>;
+/**
+ * Delivers every event in `events` not already present in `deliveredEventIds`, marking each as
+ * delivered as it goes. Reused in `stream()` for both the buffered-live-event catch-up and the
+ * single terminal-event catch-up, so the "don't double-deliver" bookkeeping lives in one place.
+ */
+export declare function deliverUndeliveredEvents(events: readonly RunProtocolEvent[], deliveredEventIds: Set<string>, onEvent: (event: RunProtocolEvent) => void): void;
+/**
+ * Closes out a `stream()` subscription once replay and catch-up delivery are done: a terminal run's
+ * subscriber is removed immediately (no further event will ever come), a still-live run's stays
+ * registered behind the returned `unsubscribe`. `record` is typed as a plain `{subscribers}` shape
+ * for the same exportability reason as {@link armWatchdogIfConfigured}.
+ */
+export declare function finishStreamSubscription(record: {
+    subscribers: Set<(event: RunProtocolEvent) => void>;
+}, subscriber: (event: RunProtocolEvent) => void, terminal: boolean): StreamSubscribeResult;
 export interface CreateRunLifecycleInput {
     readonly eventLog: EventLog;
     /** Host-owned sink for asynchronous lifecycle failures that cannot be returned to a caller. Defaults to `console.error`. */
     readonly onInternalError?: (context: RunLifecycleInternalErrorContext) => void;
+    /** How long a terminal run's in-memory record is retained before eviction. See {@link DEFAULT_TERMINAL_RETENTION_MS}. Defaults to that constant. */
+    readonly terminalRetentionMs?: number;
+    /** Hard cap on concurrently-retained terminal run records. See {@link DEFAULT_MAX_TERMINAL_RUNS}. Defaults to that constant. */
+    readonly maxTerminalRuns?: number;
 }
 export interface RunLifecycleInternalErrorContext {
     readonly source: 'inactivity-timeout';
@@ -110,8 +188,10 @@ export interface RunLifecycleInternalErrorContext {
  * Creates the in-process `RunLifecycle` reference implementation.
  *
  * @param input.eventLog - The durable `EventLog` port this lifecycle appends to and replays from.
+ * @param input.terminalRetentionMs - See {@link CreateRunLifecycleInput.terminalRetentionMs}.
+ * @param input.maxTerminalRuns - See {@link CreateRunLifecycleInput.maxTerminalRuns}.
  * @returns A `RunLifecycle` backed by an in-memory run registry plus the injected `EventLog`.
- * @complexity Per-call complexities documented on each method; the registry itself is a `Map` keyed by `runId` (O(1) lookup).
+ * @complexity Per-call complexities documented on each method; the registry itself is a `Map` keyed by `runId` (O(1) lookup). Memory is bounded: non-terminal runs are O(n) in concurrently-live runs, and terminal runs are capped at `maxTerminalRuns` (each additionally bounded in retention time by `terminalRetentionMs`) rather than growing for the life of the process.
  * @overallScore 100/100
  */
 export declare function createRunLifecycle(input: CreateRunLifecycleInput): RunLifecycle;

package/dist/run-lifecycle.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-lifecycle.d.ts","sourceRoot":"","sources":["../src/run-lifecycle.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"run-lifecycle.d.ts","sourceRoot":"","sources":["../src/run-lifecycle.ts"],"names":[],"mappings":"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"}