@wrongstack/core 0.148.0 → 0.236.0

package/dist/storage/index.d.ts

@@ -1,20 +1,20 @@
-import { M as MemoryBackend, j as FileMemoryBackendOptions } from '../plan-templates-CkKNPU3I.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 parseEntries, J as removePlanItem, K as runConfigMigrations, L as savePlan, N as saveTodosCheckpoint, O as setPlanItemStatus } from '../plan-templates-CkKNPU3I.js';
-import { M as MemoryScope, k as MemoryEntry, l as MemoryStore } from '../brain-Cp_3GIS2.js';
-import { l as AgentExtension, j as AfterRunHook } from '../index-CPweVoFM.js';
-import { P as Provider, R as Request, b as Response, S as SessionEvent } from '../context-C7G_MtLV.js';
-export { D as DefaultSessionReader, f as DefaultSessionReaderOptions, S as SessionReader } from '../session-reader-BAtCxdaw.js';
+import { M as MemoryBackend, j as FileMemoryBackendOptions } from '../plan-templates-DPABrDvy.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-DPABrDvy.js';
+import { M as MemoryScope, k as MemoryEntry, l as MemoryStore, E as EventBus } from '../brain-sCZ3lCjq.js';
+import { l as AgentExtension, j as AfterRunHook } from '../index-C2eSNPsB.js';
+import { P as Provider, R as Request, b as Response, S as SessionEvent } from '../context-CLz3z_E8.js';
+export { D as DefaultSessionReader, f as DefaultSessionReaderOptions, S as SessionReader } from '../session-reader-CCOssnBS.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';
-import { W as WstackPaths } from '../wstack-paths-DD50Omgn.js';
-import { B as SyncCategory, k as SyncConfig } from '../config-BaVThgnT.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-DWlvglC2.js';
-import '../permission-B7nKnEvQ.js';
-import '../secret-vault-DoISxaKO.js';
+import { W as WstackPaths } from '../wstack-paths-CJjEwPXn.js';
+import { E as SyncCategory, k as SyncConfig } from '../config-Koq6f3fs.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-BhtkkFFy.js';
+import '../permission-DbWPbuoA.js';
+import '../secret-vault-BJDY28ev.js';
 import '../logger-B63L5bTg.js';
-import '../pipeline-BG7UgbDc.js';
+import '../pipeline-DsmlwTXu.js';
 import '../observability-D-HZN_mF.js';
 import '../task-graph-u1q9Jkyk.js';
 
@@ -537,6 +537,129 @@ declare class ToolAuditLog {
     private enqueue;
 }
 
+/** Live status of a single agent within a session. */
+type AgentLiveStatus = 'idle' | 'running' | 'streaming' | 'waiting_user' | 'error';
+interface AgentEntry {
+    /** Unique agent id (ULID or UUID). */
+    id: string;
+    /** Human-readable label (e.g. "leader", "bug-hunter #1"). */
+    name: string;
+    status: AgentLiveStatus;
+    /** Current tool name if running, undefined otherwise. */
+    currentTool?: string | undefined;
+    /** Iteration count so far. */
+    iterations: number;
+    /** Tool calls so far. */
+    toolCalls: number;
+    /** UTC ISO timestamp of last activity. */
+    lastActivityAt: string;
+}
+type SessionLiveStatus = 'active' | 'idle' | 'closing' | 'stale';
+interface SessionRegistryEntry {
+    sessionId: string;
+    projectSlug: string;
+    projectRoot: string;
+    projectName: string;
+    workingDir: string;
+    /** Current git branch, if the project is a git repo. Detected at registration. */
+    gitBranch?: string | undefined;
+    status: SessionLiveStatus;
+    pid: number;
+    /** UTC ISO */
+    startedAt: string;
+    /** UTC ISO — updated on every heartbeat */
+    lastHeartbeatAt: string;
+    /** Count of tracked agents */
+    agentCount: number;
+    agents: AgentEntry[];
+}
+declare class SessionRegistry {
+    private readonly filePath;
+    private heartbeatTimer;
+    private currentSessionId;
+    constructor(globalRoot: string);
+    /**
+     * Register the current session. Call once on session start.
+     * Starts the heartbeat timer.
+     */
+    register(entry: Omit<SessionRegistryEntry, 'status' | 'lastHeartbeatAt' | 'agentCount' | 'agents'> & {
+        agents?: AgentEntry[] | undefined;
+    }): Promise<void>;
+    /**
+     * Update agent status for the current session. Call on every
+     * significant status change (agent start, tool start, user wait, error).
+     */
+    updateAgents(agents: AgentEntry[]): Promise<void>;
+    /**
+     * Mark the session as closing. Called during shutdown.
+     * Stops the heartbeat timer.
+     */
+    markClosing(): Promise<void>;
+    /**
+     * Remove the current session from the registry. Call on clean exit.
+     */
+    unregister(): Promise<void>;
+    /**
+     * List all non-stale sessions. Prunes stale entries automatically.
+     */
+    list(): Promise<SessionRegistryEntry[]>;
+    /**
+     * Get a single session entry by ID. Returns undefined if not found or stale.
+     */
+    get(sessionId: string): Promise<SessionRegistryEntry | undefined>;
+    /**
+     * List all sessions for a specific project (by slug).
+     */
+    listByProject(projectSlug: string): Promise<SessionRegistryEntry[]>;
+    /**
+     * Return the registry file path. Useful for WebUI to watch/read.
+     */
+    get registryPath(): string;
+    private heartbeat;
+    private readAndPrune;
+    private atomicUpdate;
+    private writeAtomicLocked;
+    /** Legacy write without lock — used by heartbeat for performance. */
+    private writeAtomic;
+}
+declare function getSessionRegistry(globalRoot?: string): SessionRegistry;
+declare function hasSessionRegistry(): boolean;
+
+/**
+ * AgentStatusTracker — subscribes to EventBus events and keeps the
+ * SessionRegistry updated with live agent status.
+ *
+ * Created once per process during boot. Listens for:
+ * - agent.run.started / agent.run.completed → agent status changes
+ * - tool.started / tool.executed → current tool tracking
+ * - brain.ask_human → waiting_user status
+ * - fleet events (subagent spawn/start/done) → agent entries
+ *
+ * @module agent-status-tracker
+ */
+
+interface AgentStatusTrackerOptions {
+    events: EventBus;
+    registry: SessionRegistry;
+    /** Leader agent name shown in the registry. Default: "leader". */
+    leaderName?: string | undefined;
+}
+declare class AgentStatusTracker {
+    private readonly events;
+    private readonly registry;
+    private readonly leaderName;
+    private agents;
+    private leaderStatus;
+    private leaderCurrentTool;
+    private leaderIterations;
+    private leaderToolCalls;
+    private unsubscribers;
+    constructor(opts: AgentStatusTrackerOptions);
+    start(): void;
+    stop(): void;
+    private flush;
+}
+
 interface SessionRewinderOptions {
     sessionsDir: string;
     /** The project root directory; used to validate rewind targets stay inside it. */
@@ -563,8 +686,23 @@ interface TaskFile {
     tasks: TaskItem[];
 }
 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>;
+/**
+ * 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>;
+/**
+ * Load, modify, and save the task file under a file-level lock.
+ * `fn` receives the current TaskFile (or a fresh empty one) and must
+ * return the mutated TaskFile (mutating in-place is fine — the returned
+ * reference is what gets saved).
+ *
+ * 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>;
 
 interface PromptEntry {
     id: string;
@@ -635,4 +773,4 @@ declare class CloudSync {
     private walkDir;
 }
 
-export { ALL_SYNC_CATEGORIES, 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, SessionMemoryConsolidator, SessionRecovery, type SessionRewinderOptions, type StaleSession, SyncCategory, SyncConfig, type SyncResult, type TaskFile, ToolAuditLog, type ToolAuditLogOptions, type VerifyResult, emptyTaskFile, loadTasks, 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, 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 };