@wrongstack/core 0.257.2 → 0.264.0

package/dist/storage/index.d.ts

@@ -1,20 +1,20 @@
-import { M as MemoryBackend, j as FileMemoryBackendOptions } from '../plan-templates-DPiQMkBz.js';
-export { A as AbandonedSession, a as AttachmentStoreOptions, C as ConfigLoaderOptions, b as ConfigMigration, c as ConfigMigrationError, d as ConfigSource, D as DEFAULT_CONFIG_MIGRATIONS, e as DefaultAttachmentStore, f as DefaultConfigLoader, g as DefaultConfigStore, h as DefaultMemoryStore, i as DefaultSessionStore, F as FileMemoryBackend, k as MemoryStoreOptions, l as MigrationContext, m as MigrationResult, P as PersistedQueueItem, n as PlanFile, o as PlanItem, p as PlanTemplate, Q as QueueStore, R as RecoveryLock, q as RecoveryLockOptions, S as SessionAnalyzer, r as SessionStoreOptions, T as TodosCheckpointFile, s as addPlanItem, t as attachPlanCheckpoint, u as attachTodosCheckpoint, v as clearPlan, w as deriveTodosFromPlanItem, x as emptyPlan, y as formatPlan, z as formatPlanTemplates, B as getPlanTemplate, E as listPlanTemplates, G as loadPlan, H as loadTodosCheckpoint, I as mutatePlan, J as parseEntries, K as removePlanItem, L as runConfigMigrations, N as savePlan, O as saveTodosCheckpoint, U as setPlanItemStatus } from '../plan-templates-DPiQMkBz.js';
-import { M as MemoryScope, k as MemoryEntry, l as MemoryStore, E as EventBus } from '../brain-TjEEwSpw.js';
-import { l as AgentExtension, j as AfterRunHook } from '../index-CitPrI3a.js';
-import { P as Provider, R as Request, b as Response, S as SessionEvent } from '../context-CGdgA0q6.js';
-export { D as DefaultSessionReader, f as DefaultSessionReaderOptions, S as SessionReader } from '../session-reader-CqRvaL5v.js';
+import { M as MemoryBackend, j as FileMemoryBackendOptions } from '../plan-templates-BvzRBkJc.js';
+export { A as AbandonedSession, a as AttachmentStoreOptions, C as ConfigLoaderOptions, b as ConfigMigration, c as ConfigMigrationError, d as ConfigSource, D as DEFAULT_CONFIG_MIGRATIONS, e as DefaultAttachmentStore, f as DefaultConfigLoader, g as DefaultConfigStore, h as DefaultMemoryStore, i as DefaultSessionStore, F as FileMemoryBackend, k as MemoryStoreOptions, l as MigrationContext, m as MigrationResult, P as PersistedQueueItem, n as PlanFile, o as PlanItem, p as PlanTemplate, Q as QueueStore, R as RecoveryLock, q as RecoveryLockOptions, S as SessionAnalyzer, r as SessionStoreOptions, T as TodosCheckpointFile, s as addPlanItem, t as attachPlanCheckpoint, u as attachTodosCheckpoint, v as clearPlan, w as deriveTodosFromPlanItem, x as emptyPlan, y as formatPlan, z as formatPlanTemplates, B as getPlanTemplate, E as listPlanTemplates, G as loadPlan, H as loadTodosCheckpoint, I as mutatePlan, J as parseEntries, K as removePlanItem, L as runConfigMigrations, N as savePlan, O as saveTodosCheckpoint, U as setPlanItemStatus } from '../plan-templates-BvzRBkJc.js';
+import { M as MemoryScope, b as MemoryEntry, c as MemoryStore, E as EventBus } from '../brain-O1IdKPaK.js';
+import { l as AgentExtension, j as AfterRunHook } from '../index-CbLSI66_.js';
+import { P as Provider, R as Request, b as Response, S as SessionEvent } from '../context-BGSpZNSE.js';
+export { D as DefaultSessionReader, f as DefaultSessionReaderOptions, S as SessionReader } from '../session-reader-KdfVwkKP.js';
 import { S as SessionRewinder, C as CheckpointInfo, a as RewindResultExtended } from '../session-rewinder-C9HnMkhP.js';
 import { T as TaskItem } from '../task-format-vGOIftmK.js';
 export { a as DirectorStateCheckpoint, D as DirectorStateSnapshot, b as DirectorSubagentState, c as DirectorTaskState, l as loadDirectorState } from '../director-state-BfeCUbmk.js';
-export { G as GoalFile, J as JournalEntry, M as MAX_JOURNAL_ENTRIES, a as MAX_PROGRESS_HISTORY, P as ProgressSnapshot, b as appendJournal, e as emptyGoal, f as formatGoal, g as goalFilePath, l as loadGoal, p as parseProgressFromText, r as recordProgress, s as saveGoal, c as setProgress, d as summarizeUsage } from '../goal-store-CV9Yz2X_.js';
+export { G as GoalFile, J as JournalEntry, M as MAX_JOURNAL_ENTRIES, a as MAX_PROGRESS_HISTORY, P as ProgressSnapshot, b as appendJournal, e as emptyGoal, f as formatGoal, g as goalFilePath, l as loadGoal, p as parseProgressFromText, r as recordProgress, s as saveGoal, c as setProgress, d as summarizeUsage } from '../goal-store-CxWmCGbH.js';
 import { W as WstackPaths } from '../wstack-paths-CJjEwPXn.js';
-import { E as SyncCategory, k as SyncConfig } from '../config-DuAu23zm.js';
-export { A as AuditLevel, C as CORE_RECONSTRUCT_EVENTS, a as STANDARD_AUDIT_EVENTS, S as SessionEventBridge, b as SessionEventBridgeOptions, c as SessionSamplingOptions, T as ToolProgressSamplingOptions, d as createSessionEventBridge, r as resolveAuditLevel, e as resolveSessionLoggingConfig } from '../session-event-bridge-BAFWdgQ3.js';
-import '../permission-CwBBpCoF.js';
+import { E as SyncCategory, k as SyncConfig } from '../config-Dz2F3H2K.js';
+export { A as AuditLevel, C as CORE_RECONSTRUCT_EVENTS, a as STANDARD_AUDIT_EVENTS, S as SessionEventBridge, b as SessionEventBridgeOptions, c as SessionSamplingOptions, T as ToolProgressSamplingOptions, d as createSessionEventBridge, r as resolveAuditLevel, e as resolveSessionLoggingConfig } from '../session-event-bridge-DkvvrpDt.js';
+import '../permission-4yvGmMRB.js';
 import '../secret-vault-BJDY28ev.js';
 import '../logger-B63L5bTg.js';
-import '../pipeline-JG8XoudC.js';
+import '../pipeline-CXCeMz8J.js';
 import '../observability-D-HZN_mF.js';
 import '../task-graph-u1q9Jkyk.js';
 
@@ -186,16 +186,23 @@ interface Annotation {
 interface AnnotationsStoreOptions {
     /** Directory where `<sessionId>.annotations.json` files live. */
     dir: string;
+    events?: EventBus;
+    traceId?: string;
 }
 declare class AnnotationsStore {
     private readonly dir;
+    private readonly events;
+    private readonly traceId;
     /** Per-session write queue. Created lazily on first add. */
     private readonly writeChains;
     constructor(opts: AnnotationsStoreOptions);
     /**
      * Return all annotations for `sessionId` in insertion order
      * (oldest first). Returns an empty array when no file exists
-     * yet (the normal case for a fresh session).
+     * yet (the normal case for a fresh session) and also degrades
+     * gracefully to `[]` on a read error (permissions, corruption) —
+     * the failure is still surfaced via a `storage.read` event so it
+     * never silently hides I/O problems from observers.
      */
     list(sessionId: string): Promise<Annotation[]>;
     /**
@@ -279,9 +286,13 @@ interface ReplayLogStoreOptions {
      * session which is a reasonable upper bound.
      */
     maxEntries?: number | undefined;
+    events?: EventBus;
+    traceId?: string;
 }
 declare class ReplayLogStore {
     private readonly dir;
+    private readonly events;
+    private readonly traceId;
     private readonly writeChains;
     /** Per-session hash → entry index, kept in memory after the first load. */
     private readonly cache;
@@ -299,12 +310,6 @@ declare class ReplayLogStore {
         request: Request;
         response: Response;
     }): Promise<string>;
-    /**
-     * Compact the replay log to keep only the most recent maxEntries.
-     * Called when entry count exceeds the cap. Rewrites the entire file
-     * but only happens O(n / maxEntries) times per session.
-     */
-    private rewriteCache;
     /**
      * Look up an entry by hash. Returns `null` when the request has
      * not been recorded for this session. O(1) after the first call
@@ -491,13 +496,24 @@ interface ToolAuditLogOptions {
      * Set to `Infinity` to disable periodic fsync (fastest, but highest data-loss risk).
      */
     fsyncEvery?: number | undefined;
+    events?: EventBus;
+    traceId?: string;
 }
 declare class ToolAuditLog {
     private readonly dir;
+    private readonly events;
+    private readonly traceId;
     /** In-memory cache of the last entry's hash (per session), to compute chains efficiently. */
     private readonly tailHash;
     /** In-memory counter for entry indices — avoids re-reading the file on every write. */
     private readonly tailIndex;
+    /**
+     * File mtime+size recorded after our last write, per session. Used to
+     * detect cross-process writes (session handoff, recovery) that would
+     * invalidate the in-memory tail cache: if the stat no longer matches
+     * we re-read the file to re-establish the chain tip before appending.
+     */
+    private readonly tailStat;
     /** Tracks writes since last fsync, per session. */
     private readonly unSyncedWrites;
     private readonly writeChains;
@@ -517,6 +533,13 @@ declare class ToolAuditLog {
         output: unknown;
         isError: boolean;
     }): Promise<AuditEntry>;
+    /**
+     * Resolve the chain tip (previous hash + next index) for an append.
+     * Uses the in-memory `tailHash`/`tailIndex` cache when the file's
+     * stat matches our last known write; falls back to a full read on
+     * cache miss or when an external writer has extended the file.
+     */
+    private _resolveChainTip;
     /**
      * Walk the chain and verify every entry's hash and prevHash.
      * Returns a structured verdict — never throws.
@@ -526,7 +549,12 @@ declare class ToolAuditLog {
     load(sessionId: string): Promise<AuditEntry[]>;
     private filePath;
     private readAll;
-    private writeAll;
+    /**
+     * Tracks writes since last fsync and triggers periodic fsync.
+     * Called after each O(1) append to maintain the same durability
+     * guarantees as the old writeAll approach.
+     */
+    private _trackUnsynced;
     /**
      * Explicitly sync the file to disk. Called automatically every
      * `fsyncEvery` writes, and available for callers who want to
@@ -687,12 +715,12 @@ interface TaskFile {
 }
 declare function emptyTaskFile(sessionId: string): TaskFile;
 /** Read the task file. Returns null when the file doesn't exist. */
-declare function loadTasks(filePath: string): Promise<TaskFile | null>;
+declare function loadTasks(filePath: string, events?: EventBus, traceId?: string): Promise<TaskFile | null>;
 /**
  * Write the task file atomically. Prefer `mutateTasks` for read-modify-write
  * cycles — this low-level function does NOT acquire a lock.
  */
-declare function saveTasks(filePath: string, tasks: TaskFile): Promise<void>;
+declare function saveTasks(filePath: string, tasks: TaskFile, events?: EventBus, traceId?: string): Promise<void>;
 /**
  * Load, modify, and save the task file under a file-level lock.
  * `fn` receives the current TaskFile (or a fresh empty one) and must
@@ -702,7 +730,7 @@ declare function saveTasks(filePath: string, tasks: TaskFile): Promise<void>;
  * This is the primary API for any code path that reads *and then writes*
  * the task file — it prevents races from parallel `batch_tool_use` calls.
  */
-declare function mutateTasks(filePath: string, sessionId: string, fn: (file: TaskFile) => TaskFile | Promise<TaskFile>): Promise<TaskFile>;
+declare function mutateTasks(filePath: string, sessionId: string, fn: (file: TaskFile) => TaskFile | Promise<TaskFile>, events?: EventBus, traceId?: string): Promise<TaskFile>;
 
 interface PromptEntry {
     id: string;