@lumenflow/kernel 3.0.0

package/dist/evidence/evidence-store.d.ts

@@ -0,0 +1,78 @@
+import { type ToolTraceEntry } from '../kernel.schemas.js';
+export interface EvidenceStoreOptions {
+    evidenceRoot: string;
+    lockRetryDelayMs?: number;
+    lockMaxRetries?: number;
+    /** Byte size threshold for the active JSONL file before rotation. Default: 10 MiB. */
+    compactionThresholdBytes?: number;
+}
+export interface PersistDataResult {
+    dataHash: string;
+    dataRef: string;
+}
+/** @deprecated Use PersistDataResult instead */
+export type PersistInputResult = PersistDataResult;
+export declare class EvidenceStore {
+    private readonly tracesDir;
+    private readonly tracesFilePath;
+    private readonly tracesLockFilePath;
+    private readonly inputsDir;
+    private readonly lockRetryDelayMs;
+    private readonly lockMaxRetries;
+    private readonly compactionThresholdBytes;
+    private tracesHydrated;
+    private orderedTraces;
+    private tracesByTaskId;
+    private taskIdByReceiptId;
+    /** Dedup guard: tracks `receipt_id:kind` keys already indexed (WU-1881). */
+    private seenTraceKeys;
+    /** Byte offset cursor into the active trace file for incremental reads. */
+    private activeFileCursor;
+    /** Number of compacted segment files at last hydration. */
+    private hydratedSegmentCount;
+    constructor(options: EvidenceStoreOptions);
+    appendTrace(entry: ToolTraceEntry): Promise<void>;
+    readTraces(): Promise<ToolTraceEntry[]>;
+    readTracesByTaskId(taskId: string): Promise<ToolTraceEntry[]>;
+    pruneTask(taskId: string): Promise<number>;
+    getReceiptIndexSize(): Promise<number>;
+    private hydrateIndexesIfNeeded;
+    /**
+     * Full hydration: reads all segment files (sorted ascending) then the active file.
+     * Sets cursor to end of active file for subsequent incremental reads.
+     */
+    private fullHydrate;
+    /**
+     * Incremental hydration: only reads new segments (from compaction since last
+     * hydration) and new bytes appended to the active file since the cursor.
+     * This provides O(1) amortized reads for the hot path.
+     */
+    private incrementalHydrate;
+    /**
+     * Lists compacted segment files sorted in ascending order.
+     * Segment files follow the pattern: tool-traces.NNNN.jsonl
+     */
+    private listSegmentFiles;
+    /**
+     * Reads an entire file and applies all trace lines to the indexes.
+     */
+    private hydrateFromFile;
+    /**
+     * Parses newline-delimited JSON lines and applies each to the indexes.
+     */
+    private parseAndApplyLines;
+    /**
+     * Rotates the active JSONL file to a numbered segment if it exceeds the
+     * compaction threshold. Called within the file lock after each append.
+     * @returns true if compaction (rotation) occurred.
+     */
+    private compactIfNeeded;
+    private resetIndexes;
+    private applyTraceToIndexes;
+    persistData(data: unknown): Promise<PersistDataResult>;
+    /** @deprecated Use persistData instead */
+    persistInput(input: unknown): Promise<PersistDataResult>;
+    reconcileOrphanedStarts(): Promise<number>;
+    private withFileLock;
+}
+//# sourceMappingURL=evidence-store.d.ts.map

package/dist/evidence/evidence-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"evidence-store.d.ts","sourceRoot":"","sources":["../../src/evidence/evidence-store.ts"],"names":[],"mappings":"AAQA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,sBAAsB,CAAC;AAU9B,MAAM,WAAW,oBAAoB;IACnC,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,sFAAsF;IACtF,wBAAwB,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,gDAAgD;AAChD,MAAM,MAAM,kBAAkB,GAAG,iBAAiB,CAAC;AAYnD,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAS;IAClD,OAAO,CAAC,cAAc,CAAS;IAC/B,OAAO,CAAC,aAAa,CAAwB;IAC7C,OAAO,CAAC,cAAc,CAAuC;IAC7D,OAAO,CAAC,iBAAiB,CAA6B;IACtD,4EAA4E;IAC5E,OAAO,CAAC,aAAa,CAAqB;IAE1C,2EAA2E;IAC3E,OAAO,CAAC,gBAAgB,CAAK;IAC7B,2DAA2D;IAC3D,OAAO,CAAC,oBAAoB,CAAK;gBAErB,OAAO,EAAE,oBAAoB;IAWnC,WAAW,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA0BjD,UAAU,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAKvC,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAK7D,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAkB1C,mBAAmB,IAAI,OAAO,CAAC,MAAM,CAAC;YAK9B,sBAAsB;IASpC;;;OAGG;YACW,WAAW;IA6BzB;;;;OAIG;YACW,kBAAkB;IA2ChC;;;OAGG;YACW,gBAAgB;IAuB9B;;OAEG;YACW,eAAe;IAO7B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAsB1B;;;;OAIG;YACW,eAAe;IA+B7B,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,mBAAmB;IA2BrB,WAAW,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC;IA0B5D,0CAA0C;IACpC,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAIxD,uBAAuB,IAAI,OAAO,CAAC,MAAM,CAAC;YA0ClC,YAAY;CAyC3B"}

package/dist/evidence/evidence-store.js

@@ -0,0 +1,409 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: Apache-2.0
+import { appendFile, mkdir, open, readdir, rename, rm } from 'node:fs/promises';
+import { createHash } from 'node:crypto';
+import { join } from 'node:path';
+import { canonicalStringify } from '../canonical-json.js';
+import { TOOL_TRACE_KINDS } from '../event-kinds.js';
+import { ToolTraceEntrySchema, } from '../kernel.schemas.js';
+import { KERNEL_POLICY_IDS, SHA256_ALGORITHM, UTF8_ENCODING } from '../shared-constants.js';
+import { readFileOrEmpty, statOrNull } from './fs-helpers.js';
+const DEFAULT_LOCK_RETRY_DELAY_MS = 20;
+const DEFAULT_LOCK_MAX_RETRIES = 250;
+const DEFAULT_COMPACTION_THRESHOLD_BYTES = 10 * 1024 * 1024; // 10 MiB
+const ACTIVE_TRACE_FILE_NAME = 'tool-traces.jsonl';
+const SEGMENT_FILE_PATTERN = /^tool-traces\.(\d+)\.jsonl$/;
+function sha256Hex(content) {
+    return createHash(SHA256_ALGORITHM).update(content).digest('hex');
+}
+function sleep(ms) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, ms);
+    });
+}
+export class EvidenceStore {
+    tracesDir;
+    tracesFilePath;
+    tracesLockFilePath;
+    inputsDir;
+    lockRetryDelayMs;
+    lockMaxRetries;
+    compactionThresholdBytes;
+    tracesHydrated = false;
+    orderedTraces = [];
+    tracesByTaskId = new Map();
+    taskIdByReceiptId = new Map();
+    /** Dedup guard: tracks `receipt_id:kind` keys already indexed (WU-1881). */
+    seenTraceKeys = new Set();
+    /** Byte offset cursor into the active trace file for incremental reads. */
+    activeFileCursor = 0;
+    /** Number of compacted segment files at last hydration. */
+    hydratedSegmentCount = 0;
+    constructor(options) {
+        this.tracesDir = join(options.evidenceRoot, 'traces');
+        this.tracesFilePath = join(this.tracesDir, ACTIVE_TRACE_FILE_NAME);
+        this.tracesLockFilePath = join(this.tracesDir, 'tool-traces.lock');
+        this.inputsDir = join(options.evidenceRoot, 'inputs');
+        this.lockRetryDelayMs = options.lockRetryDelayMs ?? DEFAULT_LOCK_RETRY_DELAY_MS;
+        this.lockMaxRetries = options.lockMaxRetries ?? DEFAULT_LOCK_MAX_RETRIES;
+        this.compactionThresholdBytes =
+            options.compactionThresholdBytes ?? DEFAULT_COMPACTION_THRESHOLD_BYTES;
+    }
+    async appendTrace(entry) {
+        const validated = ToolTraceEntrySchema.parse(entry);
+        let compacted = false;
+        await this.withFileLock(async () => {
+            await mkdir(this.tracesDir, { recursive: true });
+            const serialized = `${JSON.stringify(validated)}\n`;
+            await appendFile(this.tracesFilePath, serialized, UTF8_ENCODING);
+            compacted = await this.compactIfNeeded();
+        });
+        if (this.tracesHydrated) {
+            this.applyTraceToIndexes(validated);
+            if (compacted) {
+                // The active file was rotated; cursor resets to 0 because the new
+                // active file is now empty (or will be created fresh on next append).
+                this.hydratedSegmentCount += 1;
+                this.activeFileCursor = 0;
+            }
+            else {
+                // Advance cursor past the bytes we just wrote so incremental hydrate
+                // does not re-read them.
+                const fileStat = await statOrNull(this.tracesFilePath);
+                this.activeFileCursor = fileStat?.size ?? 0;
+            }
+        }
+    }
+    async readTraces() {
+        await this.hydrateIndexesIfNeeded();
+        return [...this.orderedTraces];
+    }
+    async readTracesByTaskId(taskId) {
+        await this.hydrateIndexesIfNeeded();
+        return [...(this.tracesByTaskId.get(taskId) ?? [])];
+    }
+    async pruneTask(taskId) {
+        await this.hydrateIndexesIfNeeded();
+        const receiptIdsToDelete = [];
+        for (const [receiptId, indexedTaskId] of this.taskIdByReceiptId.entries()) {
+            if (indexedTaskId === taskId) {
+                receiptIdsToDelete.push(receiptId);
+            }
+        }
+        for (const receiptId of receiptIdsToDelete) {
+            this.taskIdByReceiptId.delete(receiptId);
+        }
+        this.tracesByTaskId.delete(taskId);
+        return receiptIdsToDelete.length;
+    }
+    async getReceiptIndexSize() {
+        await this.hydrateIndexesIfNeeded();
+        return this.taskIdByReceiptId.size;
+    }
+    async hydrateIndexesIfNeeded() {
+        if (!this.tracesHydrated) {
+            return this.fullHydrate();
+        }
+        // Incremental: check for new segments and new bytes in active file
+        await this.incrementalHydrate();
+    }
+    /**
+     * Full hydration: reads all segment files (sorted ascending) then the active file.
+     * Sets cursor to end of active file for subsequent incremental reads.
+     */
+    async fullHydrate() {
+        this.resetIndexes();
+        const dirStat = await statOrNull(this.tracesDir);
+        if (!dirStat) {
+            this.tracesHydrated = true;
+            this.activeFileCursor = 0;
+            this.hydratedSegmentCount = 0;
+            return;
+        }
+        // Read compacted segments in order
+        const segments = await this.listSegmentFiles();
+        for (const segmentFile of segments) {
+            const segmentPath = join(this.tracesDir, segmentFile);
+            await this.hydrateFromFile(segmentPath);
+        }
+        this.hydratedSegmentCount = segments.length;
+        // Read active file
+        const activeContent = await readFileOrEmpty(this.tracesFilePath);
+        if (activeContent.length > 0) {
+            this.parseAndApplyLines(activeContent);
+        }
+        this.activeFileCursor = Buffer.byteLength(activeContent, UTF8_ENCODING);
+        this.tracesHydrated = true;
+    }
+    /**
+     * Incremental hydration: only reads new segments (from compaction since last
+     * hydration) and new bytes appended to the active file since the cursor.
+     * This provides O(1) amortized reads for the hot path.
+     */
+    async incrementalHydrate() {
+        // Check if compaction created new segments since last hydration
+        const currentSegments = await this.listSegmentFiles();
+        if (currentSegments.length > this.hydratedSegmentCount) {
+            // Read unseen segments in order. This is required for multi-instance
+            // writers where another process may rotate active traces into segments
+            // that this instance has never indexed.
+            const unseenSegments = currentSegments.slice(this.hydratedSegmentCount);
+            for (const segmentFile of unseenSegments) {
+                const segmentPath = join(this.tracesDir, segmentFile);
+                await this.hydrateFromFile(segmentPath);
+            }
+            this.hydratedSegmentCount = currentSegments.length;
+            // The active file was rotated, so the cursor resets.
+            // Read whatever is now in the new active file from the start.
+            this.activeFileCursor = 0;
+        }
+        // Read only new bytes from the active file
+        const activeFileStat = await statOrNull(this.tracesFilePath);
+        const activeSize = activeFileStat?.size ?? 0;
+        if (activeSize <= this.activeFileCursor) {
+            return; // No new data
+        }
+        // Read only the delta
+        const handle = await open(this.tracesFilePath, 'r');
+        try {
+            const deltaSize = activeSize - this.activeFileCursor;
+            const buffer = Buffer.alloc(deltaSize);
+            await handle.read(buffer, 0, deltaSize, this.activeFileCursor);
+            const deltaContent = buffer.toString(UTF8_ENCODING);
+            if (deltaContent.trim().length > 0) {
+                this.parseAndApplyLines(deltaContent);
+            }
+            this.activeFileCursor = activeSize;
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    /**
+     * Lists compacted segment files sorted in ascending order.
+     * Segment files follow the pattern: tool-traces.NNNN.jsonl
+     */
+    async listSegmentFiles() {
+        let files;
+        try {
+            files = await readdir(this.tracesDir);
+        }
+        catch (error) {
+            const nodeError = error;
+            if (nodeError.code === 'ENOENT') {
+                return [];
+            }
+            throw error;
+        }
+        return files
+            .filter((f) => SEGMENT_FILE_PATTERN.test(f))
+            .sort((a, b) => {
+            const matchA = a.match(SEGMENT_FILE_PATTERN);
+            const matchB = b.match(SEGMENT_FILE_PATTERN);
+            const numA = matchA ? parseInt(matchA[1] ?? '0', 10) : 0;
+            const numB = matchB ? parseInt(matchB[1] ?? '0', 10) : 0;
+            return numA - numB;
+        });
+    }
+    /**
+     * Reads an entire file and applies all trace lines to the indexes.
+     */
+    async hydrateFromFile(filePath) {
+        const content = await readFileOrEmpty(filePath);
+        if (content.trim().length > 0) {
+            this.parseAndApplyLines(content);
+        }
+    }
+    /**
+     * Parses newline-delimited JSON lines and applies each to the indexes.
+     */
+    parseAndApplyLines(content) {
+        const lines = content
+            .split('\n')
+            .map((line) => line.trim())
+            .filter(Boolean);
+        for (let index = 0; index < lines.length; index += 1) {
+            const line = lines[index];
+            if (!line) {
+                continue;
+            }
+            const parsed = (() => {
+                try {
+                    return JSON.parse(line);
+                }
+                catch (error) {
+                    throw new Error(`Malformed evidence trace JSON at line ${index + 1}`, { cause: error });
+                }
+            })();
+            this.applyTraceToIndexes(ToolTraceEntrySchema.parse(parsed));
+        }
+    }
+    /**
+     * Rotates the active JSONL file to a numbered segment if it exceeds the
+     * compaction threshold. Called within the file lock after each append.
+     * @returns true if compaction (rotation) occurred.
+     */
+    async compactIfNeeded() {
+        const fileStat = await statOrNull(this.tracesFilePath);
+        if (!fileStat) {
+            return false;
+        }
+        if (fileStat.size < this.compactionThresholdBytes) {
+            return false;
+        }
+        // Determine the next segment number
+        const segments = await this.listSegmentFiles();
+        let nextNumber = 1;
+        if (segments.length > 0) {
+            const lastSegment = segments[segments.length - 1];
+            if (lastSegment) {
+                const match = lastSegment.match(SEGMENT_FILE_PATTERN);
+                if (match) {
+                    nextNumber = parseInt(match[1] ?? '0', 10) + 1;
+                }
+            }
+        }
+        const segmentName = `tool-traces.${String(nextNumber).padStart(8, '0')}.jsonl`;
+        const segmentPath = join(this.tracesDir, segmentName);
+        // Atomic rename: active file becomes the new segment
+        await rename(this.tracesFilePath, segmentPath);
+        return true;
+    }
+    resetIndexes() {
+        this.orderedTraces = [];
+        this.tracesByTaskId = new Map();
+        this.taskIdByReceiptId = new Map();
+        this.seenTraceKeys = new Set();
+    }
+    applyTraceToIndexes(entry) {
+        const traceKey = `${entry.receipt_id}:${entry.kind}`;
+        if (this.seenTraceKeys.has(traceKey)) {
+            return; // Dedup: already indexed (WU-1881)
+        }
+        this.seenTraceKeys.add(traceKey);
+        this.orderedTraces.push(entry);
+        if (entry.kind === TOOL_TRACE_KINDS.TOOL_CALL_STARTED) {
+            this.taskIdByReceiptId.set(entry.receipt_id, entry.task_id);
+            const bucket = this.tracesByTaskId.get(entry.task_id) ?? [];
+            bucket.push(entry);
+            this.tracesByTaskId.set(entry.task_id, bucket);
+            return;
+        }
+        const taskId = this.taskIdByReceiptId.get(entry.receipt_id);
+        if (!taskId) {
+            return;
+        }
+        const bucket = this.tracesByTaskId.get(taskId) ?? [];
+        bucket.push(entry);
+        this.tracesByTaskId.set(taskId, bucket);
+    }
+    async persistData(data) {
+        const serialized = canonicalStringify(data);
+        const dataHash = sha256Hex(serialized);
+        const dataRef = join(this.inputsDir, dataHash);
+        await mkdir(this.inputsDir, { recursive: true });
+        try {
+            const handle = await open(dataRef, 'wx');
+            try {
+                await handle.writeFile(serialized, UTF8_ENCODING);
+            }
+            finally {
+                await handle.close();
+            }
+        }
+        catch (error) {
+            const nodeError = error;
+            if (nodeError.code !== 'EEXIST') {
+                throw error;
+            }
+        }
+        return {
+            dataHash,
+            dataRef,
+        };
+    }
+    /** @deprecated Use persistData instead */
+    async persistInput(input) {
+        return this.persistData(input);
+    }
+    async reconcileOrphanedStarts() {
+        const traces = await this.readTraces();
+        const started = new Map();
+        const finished = new Set();
+        for (const trace of traces) {
+            if (trace.kind === TOOL_TRACE_KINDS.TOOL_CALL_STARTED) {
+                started.set(trace.receipt_id, trace);
+            }
+            else {
+                finished.add(trace.receipt_id);
+            }
+        }
+        let reconciled = 0;
+        for (const [receiptId] of started) {
+            if (finished.has(receiptId)) {
+                continue;
+            }
+            const policyDecisions = [
+                {
+                    policy_id: KERNEL_POLICY_IDS.RECONCILIATION,
+                    decision: 'deny',
+                    reason: 'Orphaned started trace without matching finished trace',
+                },
+            ];
+            await this.appendTrace({
+                schema_version: 1,
+                kind: TOOL_TRACE_KINDS.TOOL_CALL_FINISHED,
+                receipt_id: receiptId,
+                timestamp: new Date().toISOString(),
+                result: 'crashed',
+                duration_ms: 0,
+                scope_enforcement_note: 'Synthetic crashed finish generated by orphan reconciliation.',
+                policy_decisions: policyDecisions,
+                artifacts_written: [],
+            });
+            reconciled += 1;
+        }
+        return reconciled;
+    }
+    async withFileLock(operation) {
+        await mkdir(this.tracesDir, { recursive: true });
+        for (let attempt = 0; attempt <= this.lockMaxRetries; attempt += 1) {
+            let handle = null;
+            try {
+                handle = await open(this.tracesLockFilePath, 'wx');
+                const result = await operation();
+                await handle.close();
+                await rm(this.tracesLockFilePath, { force: true });
+                return result;
+            }
+            catch (error) {
+                const nodeError = error;
+                if (handle) {
+                    try {
+                        await handle.close();
+                    }
+                    catch {
+                        // Best-effort cleanup; preserve the original operation error.
+                    }
+                    try {
+                        await rm(this.tracesLockFilePath, { force: true });
+                    }
+                    catch {
+                        // Best-effort cleanup; preserve the original operation error.
+                    }
+                }
+                if (nodeError.code === 'EEXIST') {
+                    if (attempt < this.lockMaxRetries) {
+                        await sleep(this.lockRetryDelayMs);
+                        continue;
+                    }
+                    break;
+                }
+                // Non-lock failures from the operation itself must surface directly.
+                throw error;
+            }
+        }
+        throw new Error(`Failed to acquire evidence-store lock at ${this.tracesLockFilePath}`);
+    }
+}
+//# sourceMappingURL=evidence-store.js.map

package/dist/evidence/evidence-store.js.map

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

package/dist/evidence/fs-helpers.d.ts

@@ -0,0 +1,13 @@
+import type { Stats } from 'node:fs';
+/**
+ * Reads a file and returns its content as a string.
+ * Returns an empty string when the file does not exist (ENOENT).
+ * Rethrows all other errors.
+ */
+export declare function readFileOrEmpty(filePath: string): Promise<string>;
+/**
+ * Returns the fs.Stats for a path, or null when the path does not exist (ENOENT).
+ * Rethrows all other errors.
+ */
+export declare function statOrNull(filePath: string): Promise<Stats | null>;
+//# sourceMappingURL=fs-helpers.d.ts.map

package/dist/evidence/fs-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-helpers.d.ts","sourceRoot":"","sources":["../../src/evidence/fs-helpers.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGrC;;;;GAIG;AACH,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUvE;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,GAAG,IAAI,CAAC,CAUxE"}

package/dist/evidence/fs-helpers.js

@@ -0,0 +1,38 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: Apache-2.0
+import { readFile, stat } from 'node:fs/promises';
+import { UTF8_ENCODING } from '../shared-constants.js';
+/**
+ * Reads a file and returns its content as a string.
+ * Returns an empty string when the file does not exist (ENOENT).
+ * Rethrows all other errors.
+ */
+export async function readFileOrEmpty(filePath) {
+    try {
+        return await readFile(filePath, UTF8_ENCODING);
+    }
+    catch (error) {
+        const nodeError = error;
+        if (nodeError.code === 'ENOENT') {
+            return '';
+        }
+        throw error;
+    }
+}
+/**
+ * Returns the fs.Stats for a path, or null when the path does not exist (ENOENT).
+ * Rethrows all other errors.
+ */
+export async function statOrNull(filePath) {
+    try {
+        return await stat(filePath);
+    }
+    catch (error) {
+        const nodeError = error;
+        if (nodeError.code === 'ENOENT') {
+            return null;
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=fs-helpers.js.map

package/dist/evidence/fs-helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-helpers.js","sourceRoot":"","sources":["../../src/evidence/fs-helpers.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,sCAAsC;AAEtC,OAAO,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAElD,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,QAAgB;IACpD,IAAI,CAAC;QACH,OAAO,MAAM,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IACjD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,KAA8B,CAAC;QACjD,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAAgB;IAC/C,IAAI,CAAC;QACH,OAAO,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,SAAS,GAAG,KAA8B,CAAC;QACjD,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAChC,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/evidence/index.d.ts

@@ -0,0 +1,3 @@
+export * from './evidence-store.js';
+export * from './fs-helpers.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/evidence/index.ts"],"names":[],"mappings":"AAGA,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC"}

package/dist/evidence/index.js

@@ -0,0 +1,5 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: Apache-2.0
+export * from './evidence-store.js';
+export * from './fs-helpers.js';
+//# sourceMappingURL=index.js.map

package/dist/evidence/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/evidence/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,sCAAsC;AAEtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @lumenflow/kernel
+ * Domain-agnostic runtime contracts for LumenFlow.
+ */
+export * from './canonical-json.js';
+export * from './evidence/index.js';
+export * from './event-kinds.js';
+export * from './event-store/index.js';
+export * from './kernel.schemas.js';
+export * from './pack/index.js';
+export * from './policy/index.js';
+export * from './runtime/index.js';
+export * from './sandbox/index.js';
+export * from './shared-constants.js';
+export * from './state-machine/index.js';
+export * from './tool-host/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAGA;;;GAGG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC"}

package/dist/index.js

@@ -0,0 +1,19 @@
+// Copyright (c) 2026 Hellmai Ltd
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * @lumenflow/kernel
+ * Domain-agnostic runtime contracts for LumenFlow.
+ */
+export * from './canonical-json.js';
+export * from './evidence/index.js';
+export * from './event-kinds.js';
+export * from './event-store/index.js';
+export * from './kernel.schemas.js';
+export * from './pack/index.js';
+export * from './policy/index.js';
+export * from './runtime/index.js';
+export * from './sandbox/index.js';
+export * from './shared-constants.js';
+export * from './state-machine/index.js';
+export * from './tool-host/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,iCAAiC;AACjC,sCAAsC;AAEtC;;;GAGG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,wBAAwB,CAAC;AACvC,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC"}