@songsid/agend 2.0.12 → 2.1.0-beta.10

package/dist/daemon.d.ts

@@ -1,9 +1,58 @@
 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 } from "./backend/types.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.
+ *
+ * Pane motion wins over a ready match because several backends keep their ready
+ * marker in a persistent header/footer while generating. A stable ready pane is
+ * idle; changing content is working; stable non-ready content eventually sticks.
+ */
+export declare class PaneStateMachine {
+    private readonly stuckTimeoutMs;
+    private readonly readyPattern;
+    private lastPaneHash;
+    private lastPaneChangeAt;
+    private lastObservedAt;
+    private stateChangedAt;
+    private currentState;
+    constructor(readyPattern: RegExp, stuckTimeoutMs?: number, now?: number);
+    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;
@@ -45,6 +94,15 @@ export declare class Daemon extends EventEmitter {
     private rotationStartedAt;
     private preRotationContextPct;
     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;
@@ -57,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;
@@ -69,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;
     /**
@@ -90,6 +153,18 @@ export declare class Daemon extends EventEmitter {
     sendEscape(): Promise<void>;
     stop(): Promise<void>;
     getHangDetector(): HangDetector | null;
+    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;