@songsid/agend 2.1.0-beta.1 → 2.1.0-beta.10

package/dist/daemon.d.ts

@@ -1,11 +1,25 @@
 import { EventEmitter } from "node:events";
 import type { InstanceConfig, RotationSnapshot } from "./types.js";
+import type { Logger } from "./logger.js";
 import { MessageBus } from "./channel/message-bus.js";
 import type { CliBackend, InstanceState, InstanceStateSnapshot } from "./backend/types.js";
 import { HangDetector } from "./hang-detector.js";
 import type { TmuxControlClient } from "./tmux-control.js";
 export declare const DEFAULT_STUCK_TIMEOUT_MS: number;
 export declare const DEFAULT_STATE_POLL_INTERVAL_MS = 5000;
+/** Headless idle timer used by the daemon and unit tests. */
+export declare class AutoPauseController {
+    private readonly thresholdMs;
+    private idleSince;
+    private pausedAt;
+    constructor(thresholdMs: number);
+    observe(state: InstanceState, now?: number): boolean;
+    markPaused(now?: number): void;
+    markAwake(): void;
+    wakeOnDeliver(wake: () => Promise<void>): Promise<void>;
+    get isPaused(): boolean;
+    get lastPausedAt(): number | null;
+}
 /**
  * Headless state machine for pane-based execution state detection.
  *
@@ -25,6 +39,20 @@ export declare class PaneStateMachine {
     observe(pane: string, now?: number): InstanceStateSnapshot;
     snapshot(now?: number): InstanceStateSnapshot;
 }
+/** Tracks whether an inbound arrived after the most recent confirmed idle prompt. */
+export declare class PendingWorkTracker {
+    private lastInboundAt;
+    private lastIdleAt;
+    private sequence;
+    private lastInboundOrder;
+    private lastIdleOrder;
+    constructor(now?: number);
+    recordInbound(now?: number): void;
+    recordIdle(now?: number): void;
+    hasPendingWork(): boolean;
+}
+/** Redact likely credentials and control sequences before pane text reaches logs. */
+export declare function sanitizePaneTail(pane: string, lineCount?: number): string[];
 export declare class Daemon extends EventEmitter {
     private name;
     private config;
@@ -68,8 +96,13 @@ export declare class Daemon extends EventEmitter {
     private hangDetector;
     private instanceState;
     private instanceStateMachine;
+    private pendingWork;
     private instanceStateMonitorTimer;
     private statePollInFlight;
+    private autoPauseController;
+    private pauseRequested;
+    private pauseWakeState;
+    private pauseWakeTransition;
     private modelOverride;
     private recentUserMessages;
     private recentEvents;
@@ -82,10 +115,15 @@ export declare class Daemon extends EventEmitter {
     private lastBuiltInstructions;
     private pasteQueueDepth;
     private errorMonitorTimer;
+    /** Prevent in-flight monitor callbacks from re-arming after a pause. */
+    private runtimeMonitorsFrozen;
     private errorWaitingForRecovery;
     private errorDetectedAt;
-    /** Whether this instance is in an error state (rate-limited, paused, or crash loop). */
+    /** Whether this instance is in an abnormal error state (auto-pause is normal). */
     get isErrorState(): boolean;
+    get isPaused(): boolean;
+    get lastPausedAt(): number | null;
+    private getPauseWakeState;
     /** Whether this instance is in a crash loop (3+ consecutive crashes). */
     get isCrashLoop(): boolean;
     private lastFailoverAt;
@@ -94,7 +132,7 @@ export declare class Daemon extends EventEmitter {
     private static ERROR_COOLDOWN_MS;
     private lastErrorCount;
     private lastDetectedErrorType;
-    constructor(name: string, config: InstanceConfig, instanceDir: string, topicMode?: boolean, backend?: CliBackend | undefined, controlClient?: TmuxControlClient | undefined);
+    constructor(name: string, config: InstanceConfig, instanceDir: string, topicMode?: boolean, backend?: CliBackend | undefined, controlClient?: TmuxControlClient | undefined, rootLogger?: Logger);
     start(): Promise<void>;
     private startHealthCheck;
     /**
@@ -115,9 +153,18 @@ export declare class Daemon extends EventEmitter {
     sendEscape(): Promise<void>;
     stop(): Promise<void>;
     getHangDetector(): HangDetector | null;
-    getInstanceState(): InstanceState;
+    getInstanceState(): InstanceState | "paused";
     getInstanceStateSnapshot(): InstanceStateSnapshot;
+    /** Gracefully stop the CLI while keeping its remain-on-exit tmux window. */
+    pause(): Promise<void>;
+    /** Respawn the CLI in the preserved window and block until its prompt is ready. */
+    wake(timeoutMs?: number): Promise<void>;
     private startInstanceStateMonitor;
+    private handleStuckTransition;
+    /** Stop every runtime poller/watcher while preserving IPC and daemon state. */
+    private freezeRuntimeMonitors;
+    /** Restore the same monitor objects after wake without adding event listeners. */
+    private resumeRuntimeMonitors;
     getMessageBus(): MessageBus;
     private summarizeTool;
     private addToolStatus;