@co0ontty/wand 0.3.0 → 0.4.0

package/dist/process-manager.d.ts

@@ -18,18 +18,40 @@ export declare class SessionInputError extends Error {
     constructor(message: string, code: "SESSION_NOT_FOUND" | "SESSION_NOT_RUNNING" | "SESSION_NO_PTY", sessionId: string, sessionStatus?: SessionSnapshot["status"] | undefined);
 }
 export type ProcessEventHandler = (event: ProcessEvent) => void;
+/** A Claude Code session discovered by scanning ~/.claude/projects/ directories. */
+export interface ClaudeHistorySession {
+    claudeSessionId: string;
+    projectDir: string;
+    cwd: string;
+    firstUserMessage: string;
+    timestamp: string;
+    mtimeMs: number;
+    hasConversation: boolean;
+    managedByWand: boolean;
+}
 export declare class ProcessManager extends EventEmitter {
     private readonly config;
     private readonly storage;
     private readonly sessions;
     private readonly logger;
     private readonly lifecycleManager;
+    /** Per-session debounce timers for throttled persist calls */
+    private readonly persistDebounceTimers;
+    /** Last persisted message count per session — used to skip redundant file writes */
+    private readonly lastPersistedMessageCount;
     constructor(config: WandConfig, storage: WandStorage, configDir?: string);
     on(event: "process", listener: ProcessEventHandler): this;
     private emitEvent;
     private cleanupOldSessions;
-    start(command: string, cwd: string | undefined, mode: ExecutionMode, initialInput?: string): SessionSnapshot;
+    start(command: string, cwd: string | undefined, mode: ExecutionMode, initialInput?: string, opts?: {
+        resumedFromSessionId?: string;
+        autoRecovered?: boolean;
+    }): SessionSnapshot;
     list(): SessionSnapshot[];
+    hasClaudeSessionFile(cwd: string, claudeSessionId: string): boolean;
+    private claudeHistoryCache;
+    private static readonly HISTORY_CACHE_TTL_MS;
+    listClaudeHistorySessions(): ClaudeHistorySession[];
     get(id: string): SessionSnapshot | null;
     sendInput(id: string, input: string, view?: "chat" | "terminal"): SessionSnapshot;
     /** Emit a task event for a session, debounced to avoid flooding */
@@ -37,7 +59,8 @@ export declare class ProcessManager extends EventEmitter {
     resize(id: string, cols: number, rows: number): SessionSnapshot;
     stop(id: string): SessionSnapshot;
     delete(id: string): void;
-    runStartupCommands(): Promise<SessionSnapshot[]>;
+    private deleteClaudeCache;
+    runStartupCommands(): SessionSnapshot[];
     private snapshot;
     private isPermissionBlocked;
     private defaultAutonomyPolicy;
@@ -45,13 +68,38 @@ export declare class ProcessManager extends EventEmitter {
     approvePermission(id: string): SessionSnapshot;
     denyPermission(id: string): SessionSnapshot;
     /**
-     * Resolve permission with specific resolution type.
+     * Canonical permission resolution method.
+     * All other permission methods delegate to this.
      * @param resolution - "approve_once", "approve_turn", or "deny"
+     * @param requestId - Optional escalation request ID for validation
      */
-    resolvePermission(id: string, resolution: "approve_once" | "approve_turn" | "deny"): SessionSnapshot;
+    resolvePermission(id: string, resolution: "approve_once" | "approve_turn" | "deny", requestId?: string): SessionSnapshot;
     private persist;
+    /**
+     * Schedule a debounced persist call for the given record.
+     * Multiple calls within the debounce window are coalesced into a single write.
+     * Use this in hot paths (e.g. onData) to reduce I/O pressure.
+     */
+    private schedulePersist;
+    /**
+     * Immediately persist any pending debounced write and clear the timer.
+     * Use this at critical points (exit, stop, delete) to ensure no data loss.
+     */
+    private flushPersist;
+    private backfillExitedClaudeSessionIds;
+    /**
+     * Auto-recover the most recent exited session that has a Claude session ID.
+     * Only resumes one session per server start, using the most recent eligible
+     * session. Sets `resumedToSessionId` on the original session and
+     * `autoRecovered: true` on the new session.
+     */
+    private autoRecoverExitedSessions;
     private archiveExpiredSessions;
     private assertCommandAllowed;
+    /**
+     * @deprecated Only retained for non-Claude-CLI sessions without ptyBridge.
+     * For Claude CLI sessions, auto-approval is handled by ClaudePtyBridge.detectPermission().
+     */
     private autoConfirmWithRecord;
     /**
      * Handle events from ClaudePtyBridge