@provos/ironcurtain 0.5.1 → 0.7.0

package/dist/signal/signal-bot-daemon.d.ts

@@ -9,10 +9,15 @@
  * - Identity verification with TTL cache (5 min), fail-closed
  * - Escalation state with race prevention (per-session)
  * - Message sending via POST /v2/send with text_mode: "styled"
+ *
+ * Session state is owned by SessionManager (injected via constructor).
+ * This class only handles Signal-specific concerns: WebSocket, identity,
+ * message parsing, and command dispatch.
  */
 import { type ResolvedSignalConfig } from './signal-config.js';
 import type { SessionMode } from '../session/types.js';
 import type { SignalContainerManager } from './signal-container.js';
+import { SessionManager } from '../session/session-manager.js';
 /**
  * Signal message envelope received via WebSocket.
  * Only the fields relevant to IronCurtain are typed here;
@@ -46,20 +51,19 @@ export interface SignalBotDaemonOptions {
     readonly config: ResolvedSignalConfig;
     readonly containerManager: SignalContainerManager;
     readonly mode: SessionMode;
+    readonly sessionManager?: SessionManager;
 }
 export declare class SignalBotDaemon {
     private config;
     private readonly containerManager;
     private readonly mode;
+    private readonly sessionManager;
     private ws;
     private baseUrl;
     private closed;
     private reconnectAttempts;
     private static readonly MAX_RECONNECT_DELAY_MS;
     private static readonly BASE_RECONNECT_DELAY_MS;
-    private sessions;
-    private currentLabel;
-    private nextLabel;
     private readonly maxConcurrentSessions;
     private identityLocked;
     private lastIdentityCheckMs;
@@ -74,12 +78,23 @@ export declare class SignalBotDaemon {
      */
     private scheduleSessionOp;
     /**
-     * Starts the daemon. Returns a promise that resolves when
-     * shutdown() is called (e.g., SIGTERM/SIGINT).
+     * Connects the daemon: starts the Docker container, waits for
+     * health, connects WebSocket, and sends the online greeting.
+     * Throws if any step fails (container won't start, health timeout, etc.).
+     */
+    connect(): Promise<void>;
+    /**
+     * Blocks until shutdown() is called (e.g., SIGTERM/SIGINT).
+     * Call connect() first to establish the connection.
+     */
+    run(): Promise<void>;
+    /**
+     * Convenience: connects and then blocks until shutdown.
+     * Used by the standalone `ironcurtain bot` command.
      */
     start(): Promise<void>;
     /**
-     * Initiates graceful shutdown. Ends all active sessions,
+     * Initiates graceful shutdown. Ends all Signal sessions,
      * closes the WebSocket, and unblocks start().
      */
     shutdown(): Promise<void>;
@@ -93,12 +108,13 @@ export declare class SignalBotDaemon {
     private scheduleReconnect;
     private handleIncomingMessage;
     /**
-     * Routes a user message to the current session. Creates a new
+     * Routes a user message to the current Signal session. Creates a new
      * session if none exists. Handles BudgetExhaustedError by ending
      * the exhausted session and notifying the user.
      *
      * Supports one-shot `#N` prefix routing: `#2 do something` routes
      * "do something" to session #2 without changing currentLabel.
+     * Only Signal sessions accept forwarded messages.
      */
     private routeToSession;
     /**
@@ -107,34 +123,20 @@ export declare class SignalBotDaemon {
      */
     private forwardToSession;
     /**
-     * Creates a new session with a fresh SignalSessionTransport.
+     * Creates a new Signal session with a fresh SignalSessionTransport.
      * Follows the same pattern as index.ts: create transport,
      * wire callbacks, create session, start transport.
      * Returns the label of the new session.
      */
     private startNewSession;
-    /**
-     * Ends a specific session by label and cleans up.
-     * If it was the current session, auto-switches to the most recent remaining.
-     */
-    endSession(label: number): Promise<void>;
-    /**
-     * Convenience method: ends the current session (if any).
-     */
-    endCurrentSession(): Promise<void>;
-    /**
-     * Auto-switches currentLabel to the highest remaining label (most recent),
-     * or null if no sessions remain.
-     */
-    private autoSwitchCurrent;
     /**
      * Checks if the message is an escalation reply.
      * Accepts: approve, deny, /approve, /deny (case-insensitive).
      * Optionally with a session label: "approve #2", "/approve 2".
      *
-     * Routes to the session with a pending escalation. If multiple
-     * sessions have pending escalations and no label is specified,
-     * asks for disambiguation.
+     * Routes to the session with a pending escalation.
+     * Works across ALL session types (signal + cron) so that
+     * `approve #3` from Signal can approve a cron job's escalation.
      */
     private handleEscalationReply;
     /** Called by SignalSessionTransport when the session surfaces an escalation. */