@wrongstack/core 0.260.0 → 0.265.1

package/dist/storage/index.d.ts

@@ -1,20 +1,20 @@
-import { M as MemoryBackend, j as FileMemoryBackendOptions } from '../plan-templates-BFXyRkEK.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-BFXyRkEK.js';
-import { M as MemoryScope, k as MemoryEntry, l as MemoryStore, E as EventBus } from '../brain-C2yDd7Lw.js';
-import { l as AgentExtension, j as AfterRunHook } from '../index-BPcg4N3M.js';
-import { P as Provider, R as Request, b as Response, S as SessionEvent } from '../context-JFOVvu6z.js';
-export { D as DefaultSessionReader, f as DefaultSessionReaderOptions, S as SessionReader } from '../session-reader-DtofsB-2.js';
+import { M as MemoryBackend, j as FileMemoryBackendOptions } from '../plan-templates-CzD9GnAU.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-CzD9GnAU.js';
+import { M as MemoryScope, b as MemoryEntry, c as MemoryStore, E as EventBus } from '../brain-BXd_61kQ.js';
+import { l as AgentExtension, j as AfterRunHook } from '../index-CEDeNodM.js';
+import { P as Provider, R as Request, b as Response, S as SessionEvent } from '../context-MRk5PhNv.js';
+export { D as DefaultSessionReader, f as DefaultSessionReaderOptions, S as SessionReader } from '../session-reader-CMgdMSRP.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-CPXz6Mml.js';
-import { W as WstackPaths } from '../wstack-paths-CJjEwPXn.js';
-import { E as SyncCategory, k as SyncConfig } from '../config-FG6As4H5.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-BmIDxdJd.js';
-import '../permission-BJ7eO9Vl.js';
-import '../secret-vault-BJDY28ev.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-DtLMySNb.js';
+import { W as WstackPaths } from '../wstack-paths-hOpNLmvf.js';
+import { G as SyncCategory, k as SyncConfig } from '../config-BMCj_XDs.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-BUI6Jf-4.js';
+import '../permission-B9SB45lp.js';
+import '../secret-vault-BAKpgFw_.js';
 import '../logger-B63L5bTg.js';
-import '../pipeline-zflkI2dp.js';
+import '../pipeline-DPDxH_7m.js';
 import '../observability-D-HZN_mF.js';
 import '../task-graph-u1q9Jkyk.js';
 
@@ -507,6 +507,13 @@ declare class ToolAuditLog {
     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;
@@ -526,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.
@@ -535,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
@@ -560,6 +579,22 @@ interface AgentEntry {
     iterations: number;
     /** Tool calls so far. */
     toolCalls: number;
+    /** Cumulative cost in USD for this agent, when known. */
+    costUsd?: number | undefined;
+    /** Cumulative input tokens, when known. */
+    tokensIn?: number | undefined;
+    /** Cumulative output tokens, when known. */
+    tokensOut?: number | undefined;
+    /** Context window fill 0–100 (may exceed 100 when over limit), when known. */
+    ctxPct?: number | undefined;
+    /** Model id this agent is running on, when known. */
+    model?: string | undefined;
+    /**
+     * Tail of the assistant text currently being streamed (capped, throttled).
+     * Lets a cross-process watcher see the response form in near-real-time
+     * instead of waiting for the completed turn to land in the session log.
+     */
+    partialText?: string | undefined;
     /** UTC ISO timestamp of last activity. */
     lastActivityAt: string;
 }
@@ -570,6 +605,12 @@ interface SessionRegistryEntry {
     projectRoot: string;
     projectName: string;
     workingDir: string;
+    /**
+     * Which surface owns this session — `'tui'` / `'webui'` / `'cli'` (one-shot or
+     * REPL). Lets cross-process consumers (e.g. the WebUI Fleet HQ office map) label
+     * each live session by client kind. Optional for back-compat with older entries.
+     */
+    clientType?: 'tui' | 'webui' | 'cli' | 'repl' | string | undefined;
     /** Current git branch, if the project is a git repo. Detected at registration. */
     gitBranch?: string | undefined;
     status: SessionLiveStatus;
@@ -586,6 +627,12 @@ declare class SessionRegistry {
     private readonly filePath;
     private heartbeatTimer;
     private currentSessionId;
+    /**
+     * Last full entry this process registered. Kept so the heartbeat can
+     * re-create our entry if it ever goes missing — e.g. our initial register()
+     * write was dropped (a wedged lock), the file was reset, or we were pruned.
+     */
+    private lastEntry;
     constructor(globalRoot: string);
     /**
      * Register the current session. Call once on session start.
@@ -627,6 +674,14 @@ declare class SessionRegistry {
     private heartbeat;
     private readAndPrune;
     private atomicUpdate;
+    /**
+     * Break a contended lock if it is stale: the recorded owner pid is no longer
+     * alive, or the lock is older than {@link STALE_LOCK_MS}. Returns true when the
+     * lock was removed (caller should retry acquisition). Best-effort and
+     * race-tolerant — a fresh lock (age ~0, live owner) is never broken, so the
+     * common concurrent case self-heals on the next heartbeat.
+     */
+    private breakStaleLock;
     private writeAtomicLocked;
     /** Legacy write without lock — used by heartbeat for performance. */
     private writeAtomic;
@@ -652,6 +707,12 @@ interface AgentStatusTrackerOptions {
     registry: SessionRegistry;
     /** Leader agent name shown in the registry. Default: "leader". */
     leaderName?: string | undefined;
+    /**
+     * Best-effort callback fired after each registry write settles. Used to nudge
+     * local WebUI servers (FleetNotifier) so cross-process status reaches the map
+     * without waiting on their file-watch/poll. Never block or throw.
+     */
+    onUpdate?: (() => void) | undefined;
 }
 declare class AgentStatusTracker {
     private readonly events;
@@ -662,13 +723,62 @@ declare class AgentStatusTracker {
     private leaderCurrentTool;
     private leaderIterations;
     private leaderToolCalls;
+    private leaderCostUsd;
+    private leaderTokensIn;
+    private leaderTokensOut;
+    private leaderCtxPct;
+    private leaderModel;
+    private leaderPartialText;
     private unsubscribers;
+    private readonly onUpdate;
+    private sweepTimer;
+    private partialTimer;
     constructor(opts: AgentStatusTrackerOptions);
     start(): void;
     stop(): void;
+    /**
+     * Coalesce streamed-text flushes: at most one registry write per
+     * {@link PARTIAL_FLUSH_THROTTLE_MS} while text streams in, so per-token
+     * deltas never thrash the cross-process registry file.
+     */
+    private schedulePartialFlush;
+    /**
+     * Remove subagents that have been finished (idle/error) for longer than
+     * {@link AGENT_REAP_MS}. Running / streaming / waiting_user agents are kept
+     * regardless of age — only *not-working* agents are reaped.
+     */
+    private sweep;
     private flush;
 }
 
+interface FleetNotifierOptions {
+    /** WrongStack global dir (`~/.wrongstack`) holding `webui-instances.json`. */
+    baseDir: string;
+    /** This process's project root — only WebUIs on the same project are pinged. */
+    projectRoot: string;
+    /** This process's pid, so a WebUI never pings itself. */
+    selfPid?: number | undefined;
+    /** Injectable POST for tests. Defaults to a timed `fetch`. */
+    post?: ((url: string) => Promise<void>) | undefined;
+}
+declare class FleetNotifier {
+    private readonly baseDir;
+    private readonly projectRoot;
+    private readonly selfPid;
+    private readonly doPost;
+    private cache;
+    private timer;
+    private disposed;
+    constructor(opts: FleetNotifierOptions);
+    /** Coalesced, best-effort nudge. Safe to call on every status change. */
+    notify(): void;
+    /** Resolve same-project WebUI ping URLs (cached briefly). Exposed for tests. */
+    endpoints(): Promise<string[]>;
+    dispose(): void;
+    private flush;
+    private discover;
+}
+
 interface SessionRewinderOptions {
     sessionsDir: string;
     /** The project root directory; used to validate rewind targets stay inside it. */
@@ -701,7 +811,13 @@ declare function loadTasks(filePath: string, events?: EventBus, traceId?: string
  * 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, events?: EventBus, traceId?: string): Promise<void>;
+/**
+ * Persist the task file. Returns `true` on success, `false` if the write
+ * failed (still emits `storage.error` + warns — does NOT throw). `mutateTasks`
+ * inspects the result and throws so the task TOOL can report `ok:false`
+ * instead of falsely claiming the tasks were saved.
+ */
+declare function saveTasks(filePath: string, tasks: TaskFile, events?: EventBus, traceId?: string): Promise<boolean>;
 /**
  * Load, modify, and save the task file under a file-level lock.
  * `fn` receives the current TaskFile (or a fresh empty one) and must
@@ -782,4 +898,4 @@ declare class CloudSync {
     private walkDir;
 }
 
-export { ALL_SYNC_CATEGORIES, type AgentEntry, type AgentLiveStatus, AgentStatusTracker, type AgentStatusTrackerOptions, type Annotation, AnnotationsStore, type AnnotationsStoreOptions, type AuditEntry, CloudSync, type ConsolidationOp, DefaultPromptStore, DefaultSessionRewinder, FileMemoryBackendOptions, GraphMemoryBackend, type GraphMemoryBackendOptions, MemoryBackend, type MemoryConsolidatorOptions, type PromptEntry, type PromptStore, type RecoveryPlan, type ReplayEntry, ReplayLogStore, type ReplayLogStoreOptions, type SessionLiveStatus, SessionMemoryConsolidator, SessionRecovery, SessionRegistry, type SessionRegistryEntry, type SessionRewinderOptions, type StaleSession, SyncCategory, SyncConfig, type SyncResult, type TaskFile, ToolAuditLog, type ToolAuditLogOptions, type VerifyResult, emptyTaskFile, getSessionRegistry, hasSessionRegistry, loadTasks, mutateTasks, saveTasks };
+export { ALL_SYNC_CATEGORIES, type AgentEntry, type AgentLiveStatus, AgentStatusTracker, type AgentStatusTrackerOptions, type Annotation, AnnotationsStore, type AnnotationsStoreOptions, type AuditEntry, CloudSync, type ConsolidationOp, DefaultPromptStore, DefaultSessionRewinder, FileMemoryBackendOptions, FleetNotifier, type FleetNotifierOptions, GraphMemoryBackend, type GraphMemoryBackendOptions, MemoryBackend, type MemoryConsolidatorOptions, type PromptEntry, type PromptStore, type RecoveryPlan, type ReplayEntry, ReplayLogStore, type ReplayLogStoreOptions, type SessionLiveStatus, SessionMemoryConsolidator, SessionRecovery, SessionRegistry, type SessionRegistryEntry, type SessionRewinderOptions, type StaleSession, SyncCategory, SyncConfig, type SyncResult, type TaskFile, ToolAuditLog, type ToolAuditLogOptions, type VerifyResult, emptyTaskFile, getSessionRegistry, hasSessionRegistry, loadTasks, mutateTasks, saveTasks };