@jini-ai/daemon 0.1.0

package/dist/run/core/retry.js.map

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

package/dist/run/diagnostics/diagnostics.d.ts

@@ -0,0 +1,86 @@
+/** @module run/diagnostics/diagnostics — Stderr/stdout tail collection and diagnostic analytics summarization for completed runs. */
+/**
+ * Scrubs secrets/PII from a stream tail before it is stored or emitted. The
+ * engine provides the tail-collection mechanism but takes no opinion on the
+ * scrubbing policy: a consumer injects its own redactor (e.g. `@jini-ai/core`'s
+ * `redactSecrets`). Defaults to identity so a caller that has already scrubbed —
+ * or genuinely wants the raw tail — need not pass one.
+ */
+export type TailRedactor = (text: string) => string;
+/** A recorded run event entry passed to diagnostics collection functions for scanning. */
+export interface RunEventForDiagnostics {
+    event: string;
+    data: unknown;
+}
+/** Identifies which signal was the primary source of diagnostic information for a failed run. */
+export type RunDiagnosticSource = 'error_event' | 'stderr' | 'exit_code' | 'signal' | 'unknown';
+/** Bucketed stderr (and stdout) line count for low-cardinality analytics grouping. */
+export type StderrLineCountBucket = 'none' | '1_5' | '6_20' | '21_100' | 'gt_100';
+/** The mechanism that ended the run's child process or RPC session, derived from events and exit signals. */
+export type RunCloseReason = 'exit_0' | 'exit_nonzero' | 'signal' | 'cancel_requested' | 'stream_error' | 'fatal_rpc_error' | 'empty_output' | 'unknown';
+/** Diagnostic fields included in the `run_finished` analytics payload, summarizing what was observed at run end. */
+export interface RunDiagnosticsAnalytics {
+    diagnostic_source: RunDiagnosticSource;
+    stderr_present: boolean;
+    stderr_line_count_bucket: StderrLineCountBucket;
+    stdout_present: boolean;
+    stdout_line_count_bucket: StderrLineCountBucket;
+    rpc_close_reason: RunCloseReason;
+    first_token_seen: boolean;
+    user_visible_output_seen: boolean;
+    tool_call_seen: boolean;
+    artifact_write_seen: boolean;
+    live_artifact_seen: boolean;
+    resume_auto_reseeded: boolean;
+}
+/** Redacted, byte-capped tail of a stream (stderr or stdout) collected after a run completes. */
+export interface StreamTailSummary {
+    tail: string;
+    lineCount: number;
+    truncated: boolean;
+}
+/** Tail summary specifically for the stderr stream; alias of `StreamTailSummary` for call-site clarity. */
+export type StderrTailSummary = StreamTailSummary;
+/** Tail summary specifically for the stdout stream; alias of `StreamTailSummary` for call-site clarity. */
+export type StdoutTailSummary = StreamTailSummary;
+/**
+ * Maps a raw stderr (or stdout) line count to a low-cardinality analytics bucket.
+ * @param count - Total number of non-empty lines in the stream.
+ * @returns A `StderrLineCountBucket` string for use in analytics payloads.
+ */
+export declare function stderrLineCountBucket(count: number): StderrLineCountBucket;
+/**
+ * Collects the tail of the stderr stream from a run's event list, scrubbed by the
+ * supplied redactor. Returns `undefined` when no stderr output was recorded.
+ * @param events - Recorded run events; only 'stderr' events are processed.
+ * @param redact - Secret/PII scrubber applied to the joined tail; defaults to identity.
+ * @returns A `StderrTailSummary` with the last 20 lines (capped at 4 KB) and a truncation flag, or `undefined`.
+ */
+export declare function collectStderrTailSummary(events?: RunEventForDiagnostics[], redact?: TailRedactor): StderrTailSummary | undefined;
+/**
+ * Collects the tail of the stdout stream from a run's event list, scrubbed by the
+ * supplied redactor. Returns `undefined` when no stdout output was recorded.
+ * @param events - Recorded run events; only 'stdout' events are processed.
+ * @param redact - Secret/PII scrubber applied to the joined tail; defaults to identity.
+ * @returns A `StdoutTailSummary` with the last 20 lines (capped at 4 KB) and a truncation flag, or `undefined`.
+ */
+export declare function collectStdoutTailSummary(events?: RunEventForDiagnostics[], redact?: TailRedactor): StdoutTailSummary | undefined;
+/**
+ * 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.
+ * @param args - Run events, exit code, signal, and boolean flags set by the daemon during finalization.
+ * @returns A `RunDiagnosticsAnalytics` object ready to spread into the `run_finished` analytics event.
+ */
+export declare function summarizeRunDiagnosticsForAnalytics(args: {
+    events?: RunEventForDiagnostics[];
+    exitCode?: number | null;
+    signal?: string | null;
+    cancelRequested?: boolean;
+    streamErrorSeen?: boolean;
+    fatalRpcErrorSeen?: boolean;
+    emptyOutputFailure?: boolean;
+    firstTokenSeen?: boolean;
+    artifactWriteSeen?: boolean;
+    liveArtifactSeen?: boolean;
+}): RunDiagnosticsAnalytics;
+//# sourceMappingURL=diagnostics.d.ts.map

package/dist/run/diagnostics/diagnostics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diagnostics.d.ts","sourceRoot":"","sources":["../../../src/run/diagnostics/diagnostics.ts"],"names":[],"mappings":"AAAA,qIAAqI;AAErI;;;;;;GAMG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;AAIpD,0FAA0F;AAC1F,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,CAAC;CACf;AAED,iGAAiG;AACjG,MAAM,MAAM,mBAAmB,GAC3B,aAAa,GACb,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,SAAS,CAAC;AAEd,sFAAsF;AACtF,MAAM,MAAM,qBAAqB,GAC7B,MAAM,GACN,KAAK,GACL,MAAM,GACN,QAAQ,GACR,QAAQ,CAAC;AAEb,6GAA6G;AAC7G,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,cAAc,GACd,QAAQ,GACR,kBAAkB,GAClB,cAAc,GACd,iBAAiB,GACjB,cAAc,GACd,SAAS,CAAC;AAEd,oHAAoH;AACpH,MAAM,WAAW,uBAAuB;IACtC,iBAAiB,EAAE,mBAAmB,CAAC;IACvC,cAAc,EAAE,OAAO,CAAC;IACxB,wBAAwB,EAAE,qBAAqB,CAAC;IAChD,cAAc,EAAE,OAAO,CAAC;IACxB,wBAAwB,EAAE,qBAAqB,CAAC;IAChD,gBAAgB,EAAE,cAAc,CAAC;IACjC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,wBAAwB,EAAE,OAAO,CAAC;IAClC,cAAc,EAAE,OAAO,CAAC;IACxB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,kBAAkB,EAAE,OAAO,CAAC;IAK5B,oBAAoB,EAAE,OAAO,CAAC;CAC/B;AAED,iGAAiG;AACjG,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,2GAA2G;AAC3G,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AAClD,2GAA2G;AAC3G,MAAM,MAAM,iBAAiB,GAAG,iBAAiB,CAAC;AA4BlD;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,qBAAqB,CAM1E;AA2CD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,GAAE,sBAAsB,EAAO,EACrC,MAAM,GAAE,YAA+B,GACtC,iBAAiB,GAAG,SAAS,CAE/B;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,MAAM,GAAE,sBAAsB,EAAO,EACrC,MAAM,GAAE,YAA+B,GACtC,iBAAiB,GAAG,SAAS,CAE/B;AAED;;;;;GAKG;AACH,wBAAgB,mCAAmC,CAAC,IAAI,EAAE;IACxD,MAAM,CAAC,EAAE,sBAAsB,EAAE,CAAC;IAClC,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B,GAAG,uBAAuB,CA8F1B"}

package/dist/run/diagnostics/diagnostics.js

@@ -0,0 +1,211 @@
+/** @module run/diagnostics/diagnostics — Stderr/stdout tail collection and diagnostic analytics summarization for completed runs. */
+const identityRedactor = (text) => text;
+const STDERR_TAIL_MAX_LINES = 20;
+const STDERR_TAIL_MAX_BYTES = 4 * 1024;
+function readStderrChunk(data) {
+    if (typeof data === 'string')
+        return data;
+    if (!data || typeof data !== 'object' || Array.isArray(data))
+        return null;
+    const obj = data;
+    if (typeof obj.chunk === 'string')
+        return obj.chunk;
+    if (typeof obj.text === 'string')
+        return obj.text;
+    return null;
+}
+function readStdoutChunk(data) {
+    if (typeof data === 'string')
+        return data;
+    if (!data || typeof data !== 'object' || Array.isArray(data))
+        return null;
+    const obj = data;
+    if (typeof obj.chunk === 'string')
+        return obj.chunk;
+    if (typeof obj.text === 'string')
+        return obj.text;
+    return null;
+}
+function countLines(text) {
+    if (!text)
+        return 0;
+    return text.split(/\r?\n/).filter((line) => line.length > 0).length;
+}
+/**
+ * Maps a raw stderr (or stdout) line count to a low-cardinality analytics bucket.
+ * @param count - Total number of non-empty lines in the stream.
+ * @returns A `StderrLineCountBucket` string for use in analytics payloads.
+ */
+export function stderrLineCountBucket(count) {
+    if (count <= 0)
+        return 'none';
+    if (count <= 5)
+        return '1_5';
+    if (count <= 20)
+        return '6_20';
+    if (count <= 100)
+        return '21_100';
+    return 'gt_100';
+}
+function truncateUtf8(value, maxBytes) {
+    const bytes = Buffer.byteLength(value, 'utf8');
+    if (bytes <= maxBytes)
+        return { value, truncated: false };
+    let end = value.length;
+    while (end > 0 && Buffer.byteLength(value.slice(0, end), 'utf8') > maxBytes) {
+        end -= 1;
+    }
+    return { value: value.slice(0, end), truncated: true };
+}
+function collectStreamTailSummary(events, eventName, readChunk, redact) {
+    let streamText = '';
+    for (const event of events) {
+        if (event.event !== eventName)
+            continue;
+        const chunk = readChunk(event.data);
+        if (chunk)
+            streamText += chunk;
+    }
+    const lineCount = countLines(streamText);
+    if (lineCount <= 0)
+        return undefined;
+    const lines = streamText.trimEnd().split(/\r?\n/);
+    const tailLines = lines.slice(-STDERR_TAIL_MAX_LINES);
+    const lineTruncated = lines.length > tailLines.length;
+    const redacted = redact(tailLines.join('\n'));
+    const byteCapped = truncateUtf8(redacted, STDERR_TAIL_MAX_BYTES);
+    return {
+        tail: byteCapped.value,
+        lineCount,
+        truncated: lineTruncated || byteCapped.truncated,
+    };
+}
+/**
+ * Collects the tail of the stderr stream from a run's event list, scrubbed by the
+ * supplied redactor. Returns `undefined` when no stderr output was recorded.
+ * @param events - Recorded run events; only 'stderr' events are processed.
+ * @param redact - Secret/PII scrubber applied to the joined tail; defaults to identity.
+ * @returns A `StderrTailSummary` with the last 20 lines (capped at 4 KB) and a truncation flag, or `undefined`.
+ */
+export function collectStderrTailSummary(events = [], redact = identityRedactor) {
+    return collectStreamTailSummary(events, 'stderr', readStderrChunk, redact);
+}
+/**
+ * Collects the tail of the stdout stream from a run's event list, scrubbed by the
+ * supplied redactor. Returns `undefined` when no stdout output was recorded.
+ * @param events - Recorded run events; only 'stdout' events are processed.
+ * @param redact - Secret/PII scrubber applied to the joined tail; defaults to identity.
+ * @returns A `StdoutTailSummary` with the last 20 lines (capped at 4 KB) and a truncation flag, or `undefined`.
+ */
+export function collectStdoutTailSummary(events = [], redact = identityRedactor) {
+    return collectStreamTailSummary(events, 'stdout', readStdoutChunk, redact);
+}
+/**
+ * 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.
+ * @param args - Run events, exit code, signal, and boolean flags set by the daemon during finalization.
+ * @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 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,
+        stderr_present: stderrPresent,
+        stderr_line_count_bucket: stderrLineCountBucket(stderrLineCount),
+        stdout_present: stdoutPresent,
+        stdout_line_count_bucket: stderrLineCountBucket(stdoutLineCount),
+        rpc_close_reason: rpcCloseReason,
+        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,
+    };
+}
+//# sourceMappingURL=diagnostics.js.map

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

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

package/dist/run/diagnostics/index.d.ts

@@ -0,0 +1,3 @@
+/** @module run/diagnostics — Stderr/stdout tail summaries and diagnostic analytics for completed runs. */
+export * from './diagnostics.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/run/diagnostics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/run/diagnostics/index.ts"],"names":[],"mappings":"AAAA,0GAA0G;AAC1G,cAAc,kBAAkB,CAAC"}

package/dist/run/diagnostics/index.js

@@ -0,0 +1,3 @@
+/** @module run/diagnostics — Stderr/stdout tail summaries and diagnostic analytics for completed runs. */
+export * from './diagnostics.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/run/diagnostics/index.ts"],"names":[],"mappings":"AAAA,0GAA0G;AAC1G,cAAc,kBAAkB,CAAC"}

package/dist/run/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @module run — Public API for generic run-orchestration primitives: result and
+ * error-code derivation, the safe-retry policy and its failure taxonomy, and
+ * post-run diagnostic tail collection.
+ *
+ * These are the product-neutral run-orchestration helpers extracted from the
+ * daemon's run capability barrel. Product telemetry (runtime-type / usage /
+ * timing analytics), the vendor-specific failure classifier, artifact
+ * filesystem snapshotting, and MCP tool-bundle resolution are deliberately
+ * out of scope here — see `source-map.md`.
+ */
+export { runResultFromStatus, deriveRunErrorCode, DEFAULT_SAFE_RUN_RETRY_MAX_ATTEMPTS, SAFE_RUN_RETRY_STRATEGY, RATE_LIMIT_RETRY_BASE_DELAY_MS, TRANSIENT_RETRY_BASE_DELAY_MS, RETRY_BACKOFF_MULTIPLIER, MAX_RETRY_BACKOFF_DELAY_MS, computeRetryBackoffMs, decideSafeRunRetry, classifyProcessExitFailure, resumableFromProcessExit, } from './core/index.js';
+export type { RunResult, RunStatusForAnalytics, RunFailureResult, RunFailureCategory, RunFailureDetail, RunFailureStage, RunRetryStrategy, RunRetrySuppressedReason, RunRetryFailureSignal, RunRetrySideEffectState, RunRetryPolicyInput, RunRetryPolicyDecision, } from './core/index.js';
+export { stderrLineCountBucket, collectStderrTailSummary, collectStdoutTailSummary, summarizeRunDiagnosticsForAnalytics, } from './diagnostics/index.js';
+export type { RunEventForDiagnostics, RunDiagnosticSource, StderrLineCountBucket, RunCloseReason, RunDiagnosticsAnalytics, StreamTailSummary, StderrTailSummary, StdoutTailSummary, TailRedactor, } from './diagnostics/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/run/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/run/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAGH,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,mCAAmC,EACnC,uBAAuB,EACvB,8BAA8B,EAC9B,6BAA6B,EAC7B,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,EACrB,kBAAkB,EAClB,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AACzB,YAAY,EACV,SAAS,EACT,qBAAqB,EACrB,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,wBAAwB,EACxB,qBAAqB,EACrB,uBAAuB,EACvB,mBAAmB,EACnB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAGzB,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,EACxB,mCAAmC,GACpC,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,sBAAsB,EACtB,mBAAmB,EACnB,qBAAqB,EACrB,cAAc,EACd,uBAAuB,EACvB,iBAAiB,EACjB,iBAAiB,EACjB,iBAAiB,EACjB,YAAY,GACb,MAAM,wBAAwB,CAAC"}

package/dist/run/index.js

@@ -0,0 +1,16 @@
+/**
+ * @module run — Public API for generic run-orchestration primitives: result and
+ * error-code derivation, the safe-retry policy and its failure taxonomy, and
+ * post-run diagnostic tail collection.
+ *
+ * These are the product-neutral run-orchestration helpers extracted from the
+ * daemon's run capability barrel. Product telemetry (runtime-type / usage /
+ * timing analytics), the vendor-specific failure classifier, artifact
+ * filesystem snapshotting, and MCP tool-bundle resolution are deliberately
+ * out of scope here — see `source-map.md`.
+ */
+// core — result derivation, failure taxonomy, and retry policy
+export { runResultFromStatus, deriveRunErrorCode, DEFAULT_SAFE_RUN_RETRY_MAX_ATTEMPTS, SAFE_RUN_RETRY_STRATEGY, RATE_LIMIT_RETRY_BASE_DELAY_MS, TRANSIENT_RETRY_BASE_DELAY_MS, RETRY_BACKOFF_MULTIPLIER, MAX_RETRY_BACKOFF_DELAY_MS, computeRetryBackoffMs, decideSafeRunRetry, classifyProcessExitFailure, resumableFromProcessExit, } from './core/index.js';
+// diagnostics — stderr/stdout tail summaries and diagnostic analytics
+export { stderrLineCountBucket, collectStderrTailSummary, collectStdoutTailSummary, summarizeRunDiagnosticsForAnalytics, } from './diagnostics/index.js';
+//# sourceMappingURL=index.js.map

package/dist/run/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/run/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,+DAA+D;AAC/D,OAAO,EACL,mBAAmB,EACnB,kBAAkB,EAClB,mCAAmC,EACnC,uBAAuB,EACvB,8BAA8B,EAC9B,6BAA6B,EAC7B,wBAAwB,EACxB,0BAA0B,EAC1B,qBAAqB,EACrB,kBAAkB,EAClB,0BAA0B,EAC1B,wBAAwB,GACzB,MAAM,iBAAiB,CAAC;AAgBzB,sEAAsE;AACtE,OAAO,EACL,qBAAqB,EACrB,wBAAwB,EACxB,wBAAwB,EACxB,mCAAmC,GACpC,MAAM,wBAAwB,CAAC"}

package/dist/run-lifecycle.d.ts

@@ -0,0 +1,118 @@
+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';
+export interface StartRunInput {
+    /** Opaque caller-supplied identity the run belongs to — never a project/conversation id (see module doc). */
+    readonly contextRef: string;
+    readonly agentId?: string;
+    /**
+     * Caller-supplied idempotency key. Starting twice with the same key
+     * returns the original run (`started: false`) instead of creating a
+     * second one — new behavior this port builds fresh, since OD's own
+     * `clientRequestId` is threaded through but never actually deduplicated
+     * against (confirmed absent upstream; see `source-map.md`).
+     */
+    readonly idempotencyKey?: string;
+    /** Override the generated run id — test/fixture hook only. */
+    readonly runId?: string;
+    /** When set, arms an inactivity watchdog that fails the run as a resumable failure if no `emit()` occurs within this window. */
+    readonly inactivityTimeoutMs?: number;
+}
+export interface StartRunResult {
+    readonly run: RunStatus;
+    /** `false` when an existing run was returned via idempotency-key replay rather than a new one being created. */
+    readonly started: boolean;
+}
+export interface FinishRunInput {
+    readonly runId: string;
+    readonly status: TerminalRunOutcome;
+    readonly code: number | null;
+    readonly signal: string | null;
+    /**
+     * True when a `'failed'`/`'cancelled'` run can be recovered by `resume()`
+     * instead of requiring a fresh `start()`. Generalized from OD's
+     * `run.resumable` flag (set only for a narrow, explicitly resumable
+     * failure-classification subset — see `run-failure-classification.ts` in
+     * the researched source).
+     */
+    readonly resumable: boolean;
+    /** Gap 5 (session resume) — see `RunEndPayload.sessionRef`'s doc in `@jini-ai/protocol`. Threaded straight through to the durable `'end'` entry; this module has no opinion on what it means. */
+    readonly sessionRef?: string;
+}
+export interface ResumeRunResult {
+    readonly run: RunStatus;
+    /** `false` when the run was not eligible (not terminal, or terminal but not `resumable`) — not an error, just a no-op. */
+    readonly resumed: boolean;
+}
+/** The subset of `RunProtocolEvent` a driver may emit directly. `'start'`/`'end'` are kernel-managed — see `start()`/`finish()`. */
+export type DriverEmittableInput = {
+    readonly event: 'agent';
+    readonly data: RunAgentPayload;
+} | {
+    readonly event: 'stdout';
+    readonly data: RunChunkPayload;
+} | {
+    readonly event: 'stderr';
+    readonly data: RunChunkPayload;
+} | {
+    readonly event: 'error';
+    readonly data: RunErrorPayload;
+};
+export type Unsubscribe = () => void;
+export interface StreamOptions {
+    readonly afterCursor?: string | null;
+}
+export type StreamSubscribeResult = {
+    readonly kind: 'ok';
+    readonly unsubscribe: Unsubscribe;
+} | Exclude<EventLogReplayResult, {
+    kind: 'ok';
+}>;
+export interface RunLifecycle {
+    /** Rebuilds the in-memory run index from durable EventLog records. Hosts must await this once during boot before accepting run requests. */
+    rehydrate(): Promise<void>;
+    start(input: StartRunInput): Promise<StartRunResult>;
+    get(runId: string): Promise<RunStatus | undefined>;
+    list(contextRef?: string): Promise<readonly RunStatus[]>;
+    /** Records cancellation intent. Idempotent — cancelling an already-terminal run is a no-op, not an error. */
+    cancel(request: RunCancelRequest): Promise<RunStatus>;
+    /** Registers a listener fired synchronously when `cancel()` is called for `runId`. Returns an unsubscribe function. */
+    onCancelRequested(runId: string, listener: (request: RunCancelRequest) => void): Unsubscribe;
+    /** Appends a driver-observed event and fans it out to live subscribers. Throws if `runId` is unknown or already terminal. */
+    emit(runId: string, input: DriverEmittableInput): Promise<RunProtocolEvent>;
+    /** Idempotent terminal transition; a second call while already terminal is a no-op that returns the existing status unchanged. */
+    finish(input: FinishRunInput): Promise<RunStatus>;
+    resume(runId: string): Promise<ResumeRunResult>;
+    /** Resolves once `runId` reaches a terminal state; resolves immediately if it already has. */
+    waitForTerminal(runId: string): Promise<RunStatus>;
+    /**
+     * Replays buffered history after `options.afterCursor` (or from the
+     * beginning if omitted/null) and then subscribes `onEvent` for live
+     * delivery — the reconnect-and-resume-streaming operation a transport
+     * uses. Mirrors OD's own reconnect guarantee: a caller that reconnects
+     * already caught up on a *terminal* run still receives one more delivery
+     * of the final `'end'` event, so a client can never silently miss the
+     * terminal signal (`runs.ts` `stream()`, researched source).
+     */
+    stream(runId: string, onEvent: (event: RunProtocolEvent) => void, options?: StreamOptions): Promise<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;
+}
+export interface RunLifecycleInternalErrorContext {
+    readonly source: 'inactivity-timeout';
+    readonly runId: string;
+    readonly error: unknown;
+}
+/**
+ * Creates the in-process `RunLifecycle` reference implementation.
+ *
+ * @param input.eventLog - The durable `EventLog` port this lifecycle appends to and replays from.
+ * @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).
+ * @overallScore 100/100
+ */
+export declare function createRunLifecycle(input: CreateRunLifecycleInput): RunLifecycle;
+//# sourceMappingURL=run-lifecycle.d.ts.map

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

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