@provos/ironcurtain 0.4.0 → 0.5.0

package/dist/signal/format.d.ts

@@ -12,8 +12,11 @@ export declare const SIGNAL_MAX_MESSAGE_LENGTH = 2000;
  * Formats an escalation request as a styled text banner.
  * Includes tool name, arguments, reason, and instructions
  * for the user to reply "approve" or "deny".
+ *
+ * When sessionLabel is provided, includes `[#N]` in the header
+ * so the user knows which session is escalating.
  */
-export declare function formatEscalationBanner(request: EscalationRequest): string;
+export declare function formatEscalationBanner(request: EscalationRequest, sessionLabel?: number): string;
 /**
  * Formats budget status for the /budget command.
  * Shows current turn consumption and session totals.
@@ -29,3 +32,20 @@ export declare function formatBudgetSummary(status: BudgetStatus): string;
  * then single newlines, then at the hard limit.
  */
 export declare function splitMessage(text: string, maxLength: number): string[];
+/**
+ * Information about a managed session for display purposes.
+ */
+export interface SessionListEntry {
+    readonly label: number;
+    readonly turnCount: number;
+    readonly budgetPercent: number;
+}
+/**
+ * Formats the /sessions command output.
+ * Marks the current session with `>`.
+ */
+export declare function formatSessionList(sessions: SessionListEntry[], currentLabel: number | null): string;
+/**
+ * Prefixes a message with `[#N]` when multiple sessions are active.
+ */
+export declare function prefixWithLabel(text: string, label: number, sessionCount: number): string;

package/dist/signal/format.js

@@ -11,15 +11,31 @@ export const SIGNAL_MAX_MESSAGE_LENGTH = 2000;
  * Formats an escalation request as a styled text banner.
  * Includes tool name, arguments, reason, and instructions
  * for the user to reply "approve" or "deny".
+ *
+ * When sessionLabel is provided, includes `[#N]` in the header
+ * so the user knows which session is escalating.
  */
-export function formatEscalationBanner(request) {
+export function formatEscalationBanner(request, sessionLabel) {
     const separator = '\u2501'.repeat(30); // box drawing heavy horizontal
-    const header = '**ESCALATION: Human approval required**';
+    const labelTag = sessionLabel != null ? ` [#${sessionLabel}]` : '';
+    const header = `**ESCALATION${labelTag}: Human approval required**`;
     const toolLine = `Tool: \`${request.serverName}/${request.toolName}\``;
     const argsLine = `Arguments: \`${JSON.stringify(request.arguments)}\``;
+    const contextLines = request.context ? Object.entries(request.context).map(([k, v]) => `${k}: \`${v}\``) : [];
     const reasonLine = `Reason: *${request.reason}*`;
     const instructions = '**Reply "approve" or "deny"**';
-    return [separator, header, separator, toolLine, argsLine, reasonLine, separator, instructions, separator].join('\n');
+    return [
+        separator,
+        header,
+        separator,
+        toolLine,
+        argsLine,
+        ...contextLines,
+        reasonLine,
+        separator,
+        instructions,
+        separator,
+    ].join('\n');
 }
 /**
  * Formats budget status for the /budget command.
@@ -90,6 +106,28 @@ export function splitMessage(text, maxLength) {
     }
     return chunks;
 }
+/**
+ * Formats the /sessions command output.
+ * Marks the current session with `>`.
+ */
+export function formatSessionList(sessions, currentLabel) {
+    if (sessions.length === 0)
+        return 'No active sessions.';
+    const lines = ['**Active sessions:**'];
+    for (const s of sessions) {
+        const marker = s.label === currentLabel ? '>' : ' ';
+        lines.push(`${marker} #${s.label}  turns: ${s.turnCount}  budget: ${s.budgetPercent}%`);
+    }
+    return lines.join('\n');
+}
+/**
+ * Prefixes a message with `[#N]` when multiple sessions are active.
+ */
+export function prefixWithLabel(text, label, sessionCount) {
+    if (sessionCount <= 1)
+        return text;
+    return `[#${label}] ${text}`;
+}
 // --- Private helpers ---
 function formatBudgetLine(label, current, limit, format) {
     const currentStr = format(current);

package/dist/signal/format.js.map

@@ -1 +1 @@
-{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/signal/format.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/signal/format.ts"],"names":[],"mappings":"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"}

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

@@ -5,9 +5,9 @@
  * - WebSocket connection to signal-cli-rest-api with reconnect + exponential backoff
  * - Message routing: authorization, identity verification, escalation replies,
  *   control commands, and session forwarding
- * - Session lifecycle: creates transport+session on demand, cleans up on end
+ * - Multi-session lifecycle: creates transport+session on demand, cleans up on end
  * - Identity verification with TTL cache (5 min), fail-closed
- * - Escalation state with race prevention
+ * - Escalation state with race prevention (per-session)
  * - Message sending via POST /v2/send with text_mode: "styled"
  */
 import { type ResolvedSignalConfig } from './signal-config.js';
@@ -57,23 +57,29 @@ export declare class SignalBotDaemon {
     private reconnectAttempts;
     private static readonly MAX_RECONNECT_DELAY_MS;
     private static readonly BASE_RECONNECT_DELAY_MS;
-    private activeSession;
-    private activeTransport;
-    private messageInFlight;
-    private pendingEscalationId;
-    private escalationResolving;
+    private sessions;
+    private currentLabel;
+    private nextLabel;
+    private readonly maxConcurrentSessions;
     private identityLocked;
     private lastIdentityCheckMs;
     private recentTimestamps;
+    private sessionOpInProgress;
     private exitResolve;
     constructor(options: SignalBotDaemonOptions);
+    /**
+     * Schedules a session-mutating operation (/new, /quit) so that
+     * concurrent routeToSession() calls wait for it to complete.
+     * Operations are chained to prevent interleaving.
+     */
+    private scheduleSessionOp;
     /**
      * Starts the daemon. Returns a promise that resolves when
      * shutdown() is called (e.g., SIGTERM/SIGINT).
      */
     start(): Promise<void>;
     /**
-     * Initiates graceful shutdown. Ends the active session,
+     * Initiates graceful shutdown. Ends all active sessions,
      * closes the WebSocket, and unblocks start().
      */
     shutdown(): Promise<void>;
@@ -87,36 +93,54 @@ export declare class SignalBotDaemon {
     private scheduleReconnect;
     private handleIncomingMessage;
     /**
-     * Routes a user message to the active session. Creates a new
+     * Routes a user message to the current 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.
      */
     private routeToSession;
+    /**
+     * Forwards a message to a specific managed session. Handles
+     * in-flight guards, BudgetExhaustedError, and response formatting.
+     */
+    private forwardToSession;
     /**
      * Creates a new 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 the current session and cleans up. Awaits session.close()
-     * to ensure resources are released (sandbox, MCP connections, etc.).
-     * Guarded against re-entrance.
+     * 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".
      *
-     * Race condition prevention: escalationResolving flag prevents
-     * concurrent replies. pendingEscalationId is cleared in .finally()
-     * after async resolution completes, not before.
+     * Routes to the session with a pending escalation. If multiple
+     * sessions have pending escalations and no label is specified,
+     * asks for disambiguation.
      */
     private handleEscalationReply;
     /** Called by SignalSessionTransport when the session surfaces an escalation. */
-    setPendingEscalation(escalationId: string): void;
+    setPendingEscalation(label: number, escalationId: string): void;
     /** Called by SignalSessionTransport when an escalation expires. */
-    clearPendingEscalation(): void;
+    clearPendingEscalation(label: number): void;
     private handleControlCommand;
     /**
      * Checks whether the sender's Signal identity key has changed.
@@ -137,6 +161,17 @@ export declare class SignalBotDaemon {
     private postMessage;
 }
 export declare function parseSignalEnvelope(data: string): SignalEnvelope | null;
-/** Normalize a phone number by stripping spaces. */
 export declare function normalizePhoneNumber(number: string): string;
 export declare function isAuthorizedSender(envelope: SignalEnvelope, recipientNumber: string): boolean;
+export interface HashPrefixResult {
+    /** The session label from the #N prefix, or null if no prefix was found. */
+    targetLabel: number | null;
+    /** The message text with the #N prefix stripped (or the original text if no prefix). */
+    messageText: string;
+}
+/**
+ * Parses an optional `#N` prefix from a message for one-shot session routing.
+ * Pattern: `#N ` at the start, where N is one or more digits, followed by a space.
+ * E.g., `#2 do something` -> { targetLabel: 2, messageText: 'do something' }
+ */
+export declare function parseHashPrefix(text: string): HashPrefixResult;