codekin 0.5.1 → 0.5.2

package/server/dist/session-archive.js.map

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

package/server/dist/session-manager.d.ts

@@ -60,7 +60,17 @@ export declare class SessionManager {
     private sessionPersistence;
     /** Delegated diff operations (git diff, discard changes). */
     private diffManager;
+    /** Interval handle for the idle session reaper. */
+    private _idleReaperInterval;
     constructor();
+    /**
+     * Stop Claude processes for sessions that have been idle too long.
+     * A session is idle when it has no connected clients and no activity
+     * for IDLE_SESSION_TIMEOUT_MS. Only stops the process — does not delete
+     * the session, so it can be resumed later via --resume.
+     * Headless sessions (webhook, workflow, stepflow) are exempt.
+     */
+    private reapIdleSessions;
     /** Direct access to the approval manager for callers that need repo-level approval operations. */
     get approvalManager(): ApprovalManager;
     /** Schedule session naming via AI provider. */
@@ -145,6 +155,13 @@ export declare class SessionManager {
      * Wires up all event handlers for streaming text, tools, prompts, and auto-restart.
      */
     startClaude(sessionId: string): boolean;
+    /**
+     * Wait for a session's Claude process to emit its system_init event,
+     * indicating it is ready to accept input. Resolves immediately if the
+     * session already has a claudeSessionId (process previously initialized).
+     * Times out after `timeoutMs` (default 30s) to avoid hanging indefinitely.
+     */
+    waitForReady(sessionId: string, timeoutMs?: number): Promise<void>;
     /**
      * Attach all ClaudeProcess event listeners for a session.
      * Extracted from startClaude() to keep that method focused on process setup.
@@ -173,6 +190,22 @@ export declare class SessionManager {
      * session naming on first completed turn.
      */
     private handleClaudeResult;
+    /**
+     * Emit a notification when the session has had enough turns that Claude's
+     * context window may start compressing older messages. Uses simple turn-count
+     * heuristic — imprecise but zero-risk and protocol-independent.
+     */
+    private checkContextWarning;
+    /**
+     * Detect transient API errors and schedule an automatic retry.
+     * Returns true if a retry was scheduled (caller should skip result broadcast).
+     */
+    private handleApiRetry;
+    /**
+     * Broadcast the turn result, suppress orchestrator noise, notify listeners,
+     * and trigger session naming if needed.
+     */
+    private finalizeResult;
     /**
      * Handle a Claude process 'exit' event: clean up state, notify exit listeners,
      * and either auto-restart (within limits) or broadcast the final exit message.
@@ -258,9 +291,12 @@ export declare class SessionManager {
      * Caps output at ~4000 chars, keeping the most recent exchanges.
      */
     private buildSessionContext;
+    /** Max size of a single output chunk in the history buffer. */
+    private static readonly MAX_OUTPUT_CHUNK;
     /**
      * Append a message to a session's output history for replay.
-     * Merges consecutive 'output' chunks into a single entry to save space.
+     * Merges consecutive 'output' chunks up to MAX_OUTPUT_CHUNK to save space,
+     * and splits oversized outputs into multiple entries to bound replay cost.
      */
     addToHistory(session: Session, msg: WsServerMessage): void;
     /** Send a message to all connected clients of a session, with back-pressure protection. */

package/server/dist/session-manager.js

@@ -41,6 +41,16 @@ const MAX_HISTORY = 2000;
 const MAX_API_RETRIES = 3;
 /** Base delay for API error retry (doubles each attempt: 3s, 6s, 12s). */
 const API_RETRY_BASE_DELAY_MS = 3000;
+/** How long a session can be idle (no clients, no activity) before its process is stopped. */
+const IDLE_SESSION_TIMEOUT_MS = 30 * 60 * 1000; // 30 minutes
+/** How often to check for idle sessions. */
+const IDLE_CHECK_INTERVAL_MS = 5 * 60 * 1000; // 5 minutes
+/** How old a dead session must be before automatic pruning (7 days). */
+const STALE_SESSION_AGE_MS = 7 * 24 * 60 * 60 * 1000;
+/** Number of Claude turns before showing a context compression warning. */
+const CONTEXT_WARNING_TURN_THRESHOLD = 15;
+/** Second warning at this threshold. */
+const CONTEXT_CRITICAL_TURN_THRESHOLD = 25;
 /** Patterns in result text that indicate a transient API error worth retrying. */
 const API_RETRY_PATTERNS = [
     /api_error/i,
@@ -79,6 +89,8 @@ export class SessionManager {
     sessionPersistence;
     /** Delegated diff operations (git diff, discard changes). */
     diffManager;
+    /** Interval handle for the idle session reaper. */
+    _idleReaperInterval = null;
     constructor() {
         this.archive = new SessionArchive();
         this._approvalManager = new ApprovalManager();
@@ -94,6 +106,58 @@ export class SessionManager {
         for (const session of this.sessions.values()) {
             this.wirePlanManager(session);
         }
+        // Start idle session reaper
+        this._idleReaperInterval = setInterval(() => this.reapIdleSessions(), IDLE_CHECK_INTERVAL_MS);
+    }
+    /**
+     * Stop Claude processes for sessions that have been idle too long.
+     * A session is idle when it has no connected clients and no activity
+     * for IDLE_SESSION_TIMEOUT_MS. Only stops the process — does not delete
+     * the session, so it can be resumed later via --resume.
+     * Headless sessions (webhook, workflow, stepflow) are exempt.
+     */
+    reapIdleSessions() {
+        const now = Date.now();
+        for (const session of this.sessions.values()) {
+            // Skip headless sessions — they are managed by their own lifecycles
+            if (session.source === 'webhook' || session.source === 'workflow' || session.source === 'stepflow')
+                continue;
+            // Skip sessions with connected clients or no running process
+            if (session.clients.size > 0 || !session.claudeProcess?.isAlive())
+                continue;
+            // Skip sessions that are actively processing
+            if (session.isProcessing)
+                continue;
+            const idleMs = now - session._lastActivityAt;
+            if (idleMs > IDLE_SESSION_TIMEOUT_MS) {
+                console.log(`[idle-reaper] stopping idle session=${session.id} name="${session.name}" idle=${Math.round(idleMs / 60_000)}min`);
+                session._stoppedByUser = true; // prevent auto-restart
+                session.claudeProcess.removeAllListeners();
+                session.claudeProcess.stop();
+                session.claudeProcess = null;
+                session.isProcessing = false;
+                const msg = { type: 'system_message', subtype: 'exit', text: 'Claude process stopped due to inactivity. It will resume when you send a new message.' };
+                this.addToHistory(session, msg);
+                this.persistToDiskDebounced();
+                this._globalBroadcast?.({ type: 'sessions_updated' });
+            }
+        }
+        // Prune stale sessions: no process, no clients, older than STALE_SESSION_AGE_MS
+        const staleIds = [];
+        for (const session of this.sessions.values()) {
+            if (session.claudeProcess?.isAlive())
+                continue;
+            if (session.clients.size > 0)
+                continue;
+            const ageMs = now - new Date(session.created).getTime();
+            if (ageMs > STALE_SESSION_AGE_MS) {
+                staleIds.push(session.id);
+            }
+        }
+        for (const id of staleIds) {
+            console.log(`[idle-reaper] pruning stale session=${id} (age > ${STALE_SESSION_AGE_MS / 86_400_000}d)`);
+            this.delete(id);
+        }
     }
     // ---------------------------------------------------------------------------
     // Approval — direct accessor (callers use sessions.approvalManager.xxx)
@@ -149,11 +213,13 @@ export class SessionManager {
             _wasActiveBeforeRestart: false,
             _apiRetryCount: 0,
             _turnCount: 0,
+            _claudeTurnCount: 0,
             _namingAttempts: 0,
             isProcessing: false,
             pendingControlRequests: new Map(),
             pendingToolApprovals: new Map(),
             _leaveGraceTimer: null,
+            _lastActivityAt: Date.now(),
             planManager: new PlanManager(),
         };
         this.wirePlanManager(session);
@@ -400,7 +466,7 @@ export class SessionManager {
             groupDir: s.groupDir,
             worktreePath: s.worktreePath,
             connectedClients: s.clients.size,
-            lastActivity: s.created,
+            lastActivity: new Date(s._lastActivityAt).toISOString(),
             source: s.source,
         }));
     }
@@ -417,7 +483,7 @@ export class SessionManager {
             groupDir: s.groupDir,
             worktreePath: s.worktreePath,
             connectedClients: s.clients.size,
-            lastActivity: s.created,
+            lastActivity: new Date(s._lastActivityAt).toISOString(),
             source: s.source,
         }));
     }
@@ -444,6 +510,7 @@ export class SessionManager {
         }
         session.clients.add(ws);
         this.clientSessionMap.set(ws, sessionId);
+        session._lastActivityAt = Date.now();
         // Re-broadcast pending tool approval prompts (PreToolUse hook path)
         for (const pending of session.pendingToolApprovals.values()) {
             if (pending.promptMsg) {
@@ -612,7 +679,14 @@ export class SessionManager {
         const repoDir = session.groupDir ?? session.workingDir;
         const registryPatterns = this._approvalManager.getAllowedToolsForRepo(repoDir);
         const mergedAllowedTools = [...new Set([...(session.allowedTools || []), ...registryPatterns])];
-        const cp = new ClaudeProcess(session.workingDir, session.claudeSessionId || undefined, extraEnv, session.model, session.permissionMode, resume, mergedAllowedTools);
+        const cp = new ClaudeProcess(session.workingDir, {
+            sessionId: session.claudeSessionId || undefined,
+            extraEnv,
+            model: session.model,
+            permissionMode: session.permissionMode,
+            resume,
+            allowedTools: mergedAllowedTools,
+        });
         this.wireClaudeEvents(cp, session, sessionId);
         cp.start();
         session.claudeProcess = cp;
@@ -622,6 +696,30 @@ export class SessionManager {
         this.broadcast(session, startMsg);
         return true;
     }
+    /**
+     * Wait for a session's Claude process to emit its system_init event,
+     * indicating it is ready to accept input. Resolves immediately if the
+     * session already has a claudeSessionId (process previously initialized).
+     * Times out after `timeoutMs` (default 30s) to avoid hanging indefinitely.
+     */
+    waitForReady(sessionId, timeoutMs = 30_000) {
+        const session = this.sessions.get(sessionId);
+        if (!session?.claudeProcess)
+            return Promise.resolve();
+        // If the process already completed init in a prior turn, resolve immediately
+        if (session.claudeSessionId)
+            return Promise.resolve();
+        return new Promise((resolve) => {
+            const timer = setTimeout(() => {
+                console.warn(`[waitForReady] Timed out waiting for system_init on ${sessionId} after ${timeoutMs}ms`);
+                resolve();
+            }, timeoutMs);
+            session.claudeProcess.once('system_init', () => {
+                clearTimeout(timer);
+                resolve();
+            });
+        });
+    }
     /**
      * Attach all ClaudeProcess event listeners for a session.
      * Extracted from startClaude() to keep that method focused on process setup.
@@ -792,55 +890,104 @@ export class SessionManager {
      */
     handleClaudeResult(session, sessionId, result, isError) {
         session.isProcessing = false;
+        session._claudeTurnCount++;
         this._globalBroadcast?.({ type: 'sessions_updated' });
-        // Detect transient API errors and auto-retry the last user message
-        if (isError && session._lastUserInput && this.isRetryableApiError(result)) {
-            if (session._apiRetryCount < MAX_API_RETRIES) {
-                session._apiRetryCount++;
-                const attempt = session._apiRetryCount;
-                const delay = API_RETRY_BASE_DELAY_MS * Math.pow(2, attempt - 1);
-                const retryMsg = {
-                    type: 'system_message',
-                    subtype: 'restart',
-                    text: `API error (transient). Retrying automatically in ${delay / 1000}s (attempt ${attempt}/${MAX_API_RETRIES})...`,
-                };
-                this.addToHistory(session, retryMsg);
-                this.broadcast(session, retryMsg);
-                console.log(`[api-retry] session=${sessionId} attempt=${attempt}/${MAX_API_RETRIES} delay=${delay}ms error=${result.slice(0, 200)}`);
-                // Clear any previous retry timer
-                if (session._apiRetryTimer)
-                    clearTimeout(session._apiRetryTimer);
-                session._apiRetryTimer = setTimeout(() => {
-                    session._apiRetryTimer = undefined;
-                    if (!session.claudeProcess?.isAlive() || session._stoppedByUser)
-                        return;
-                    console.log(`[api-retry] resending message for session=${sessionId} attempt=${attempt}`);
-                    session.claudeProcess.sendMessage(session._lastUserInput);
-                }, delay);
-                return; // Don't broadcast result — we're retrying
-            }
-            // All retries exhausted
-            const exhaustedMsg = {
+        // Attempt API retry for transient errors — returns true if a retry was scheduled
+        if (isError && this.handleApiRetry(session, sessionId, result)) {
+            return;
+        }
+        // Warn about context window pressure at turn thresholds
+        this.checkContextWarning(session);
+        this.finalizeResult(session, sessionId, result, isError);
+    }
+    /**
+     * Emit a notification when the session has had enough turns that Claude's
+     * context window may start compressing older messages. Uses simple turn-count
+     * heuristic — imprecise but zero-risk and protocol-independent.
+     */
+    checkContextWarning(session) {
+        const turns = session._claudeTurnCount;
+        if (turns === CONTEXT_WARNING_TURN_THRESHOLD) {
+            const msg = {
+                type: 'system_message',
+                subtype: 'notification',
+                text: `This session has ${turns} turns. Claude may begin compressing older messages from its context window. Earlier parts of the conversation may no longer be fully available to Claude.`,
+            };
+            this.broadcastAndHistory(session, msg);
+            session._contextWarningShown = true;
+        }
+        else if (turns === CONTEXT_CRITICAL_TURN_THRESHOLD) {
+            const msg = {
                 type: 'system_message',
-                subtype: 'error',
-                text: `API error persisted after ${MAX_API_RETRIES} retries. ${result}`,
+                subtype: 'notification',
+                text: `This session has ${turns} turns. Claude's context window is likely under pressure — older messages may have been compressed or dropped. Consider starting a new session for best results.`,
             };
-            this.addToHistory(session, exhaustedMsg);
-            this.broadcast(session, exhaustedMsg);
+            this.broadcastAndHistory(session, msg);
+        }
+    }
+    /**
+     * Detect transient API errors and schedule an automatic retry.
+     * Returns true if a retry was scheduled (caller should skip result broadcast).
+     */
+    handleApiRetry(session, sessionId, result) {
+        if (!session._lastUserInput || !this.isRetryableApiError(result)) {
             session._apiRetryCount = 0;
+            return false;
         }
-        else {
-            // Non-retryable error or successful result — reset retry counter
+        // Skip retry if the original input is older than 60 seconds — context has likely moved on
+        if (session._lastUserInputAt && Date.now() - session._lastUserInputAt > 60_000) {
+            console.log(`[api-retry] skipping stale retry for session=${sessionId} (input age=${Math.round((Date.now() - session._lastUserInputAt) / 1000)}s)`);
             session._apiRetryCount = 0;
-            if (isError) {
-                const msg = { type: 'system_message', subtype: 'error', text: result };
-                this.addToHistory(session, msg);
-                this.broadcast(session, msg);
-            }
+            return false;
+        }
+        if (session._apiRetryCount < MAX_API_RETRIES) {
+            session._apiRetryCount++;
+            const attempt = session._apiRetryCount;
+            const delay = API_RETRY_BASE_DELAY_MS * Math.pow(2, attempt - 1);
+            const retryMsg = {
+                type: 'system_message',
+                subtype: 'restart',
+                text: `API error (transient). Retrying automatically in ${delay / 1000}s (attempt ${attempt}/${MAX_API_RETRIES})...`,
+            };
+            this.addToHistory(session, retryMsg);
+            this.broadcast(session, retryMsg);
+            console.log(`[api-retry] session=${sessionId} attempt=${attempt}/${MAX_API_RETRIES} delay=${delay}ms error=${result.slice(0, 200)}`);
+            if (session._apiRetryTimer)
+                clearTimeout(session._apiRetryTimer);
+            session._apiRetryTimer = setTimeout(() => {
+                session._apiRetryTimer = undefined;
+                if (!session.claudeProcess?.isAlive() || session._stoppedByUser)
+                    return;
+                console.log(`[api-retry] resending message for session=${sessionId} attempt=${attempt}`);
+                session.claudeProcess.sendMessage(session._lastUserInput);
+            }, delay);
+            return true;
+        }
+        // All retries exhausted
+        const exhaustedMsg = {
+            type: 'system_message',
+            subtype: 'error',
+            text: `API error persisted after ${MAX_API_RETRIES} retries. ${result}`,
+        };
+        this.addToHistory(session, exhaustedMsg);
+        this.broadcast(session, exhaustedMsg);
+        session._apiRetryCount = 0;
+        return false;
+    }
+    /**
+     * Broadcast the turn result, suppress orchestrator noise, notify listeners,
+     * and trigger session naming if needed.
+     */
+    finalizeResult(session, sessionId, result, isError) {
+        session._apiRetryCount = 0;
+        session._lastUserInput = undefined;
+        session._lastUserInputAt = undefined;
+        if (isError) {
+            const msg = { type: 'system_message', subtype: 'error', text: result };
+            this.addToHistory(session, msg);
+            this.broadcast(session, msg);
         }
-        // Suppress noise from orchestrator/agent sessions: if the entire turn's
-        // text output is a short, low-value phrase, strip it from history so it
-        // doesn't pollute the chat or replay on rejoin.
+        // Suppress noise from orchestrator/agent sessions
         if ((session.source === 'orchestrator' || session.source === 'agent') && !isError) {
             const turnText = this.extractCurrentTurnText(session);
             if (turnText && turnText.length < 80 && /^(no response requested|please approve|nothing to do|no action needed|acknowledged)[.!]?$/i.test(turnText.trim())) {
@@ -851,14 +998,13 @@ export class SessionManager {
         const resultMsg = { type: 'result' };
         this.addToHistory(session, resultMsg);
         this.broadcast(session, resultMsg);
-        // Notify result listeners (orchestrator, child monitor, etc.)
         for (const listener of this._resultListeners) {
             try {
                 listener(sessionId, isError);
             }
             catch { /* listener error */ }
         }
-        // If session is still unnamed after first response, name it now — we have full context
+        // If session is still unnamed after first response, name it now
         if (session.name.startsWith('hub:') && session._namingAttempts === 0) {
             if (session._namingTimer) {
                 clearTimeout(session._namingTimer);
@@ -958,8 +1104,11 @@ export class SessionManager {
         const session = this.sessions.get(sessionId);
         if (!session)
             return;
+        session._lastActivityAt = Date.now();
+        // Reset stopped-by-user flag so idle-reaped sessions can auto-start
+        session._stoppedByUser = false;
         if (!session.claudeProcess?.isAlive()) {
-            // Claude not running (e.g. after server restart) — auto-start first.
+            // Claude not running (e.g. after server restart or idle reap) — auto-start first.
             // Claude CLI in -p mode waits for first input before emitting init,
             // so we write directly to the stdin pipe buffer (no waiting for init).
             this.startClaude(sessionId);
@@ -972,6 +1121,7 @@ export class SessionManager {
                 if (context) {
                     const combined = context + '\n\n' + data;
                     session._lastUserInput = combined;
+                    session._lastUserInputAt = Date.now();
                     session._apiRetryCount = 0;
                     if (!session.isProcessing) {
                         session.isProcessing = true;
@@ -991,6 +1141,7 @@ export class SessionManager {
             this.retrySessionNamingOnInteraction(sessionId);
         }
         session._lastUserInput = data;
+        session._lastUserInputAt = Date.now();
         session._apiRetryCount = 0;
         if (!session.isProcessing) {
             session.isProcessing = true;
@@ -1007,6 +1158,7 @@ export class SessionManager {
         const session = this.sessions.get(sessionId);
         if (!session)
             return;
+        session._lastActivityAt = Date.now();
         // ExitPlanMode approvals are handled through the normal pendingToolApprovals
         // path (routed via the PreToolUse hook). No special plan_review_ prefix needed.
         // Check for pending tool approval from PreToolUse hook
@@ -1379,7 +1531,7 @@ export class SessionManager {
         if (session.allowedTools && this.matchesAllowedTools(session.allowedTools, toolName, toolInput)) {
             return 'session';
         }
-        if (session.clients.size === 0 && (session.source === 'webhook' || session.source === 'workflow' || session.source === 'stepflow')) {
+        if (session.clients.size === 0 && (session.source === 'webhook' || session.source === 'workflow' || session.source === 'stepflow' || session.source === 'orchestrator')) {
             return 'headless';
         }
         return 'prompt';
@@ -1605,22 +1757,36 @@ export class SessionManager {
         }
         return `[This session was interrupted by a server restart. Here is the previous conversation for context:]\n${context}\n[End of previous context. The user's new message follows.]`;
     }
+    /** Max size of a single output chunk in the history buffer. */
+    static MAX_OUTPUT_CHUNK = 50_000; // 50KB
     /**
      * Append a message to a session's output history for replay.
-     * Merges consecutive 'output' chunks into a single entry to save space.
+     * Merges consecutive 'output' chunks up to MAX_OUTPUT_CHUNK to save space,
+     * and splits oversized outputs into multiple entries to bound replay cost.
      */
     addToHistory(session, msg) {
         if (msg.type === 'output') {
             const last = session.outputHistory[session.outputHistory.length - 1];
-            if (last?.type === 'output' && last.data.length < 100_000) {
+            if (last?.type === 'output' && last.data.length < SessionManager.MAX_OUTPUT_CHUNK) {
                 last.data += msg.data;
                 this.persistToDiskDebounced();
                 return;
             }
+            // Split oversized output into bounded chunks
+            if (msg.data.length > SessionManager.MAX_OUTPUT_CHUNK) {
+                for (let i = 0; i < msg.data.length; i += SessionManager.MAX_OUTPUT_CHUNK) {
+                    session.outputHistory.push({ type: 'output', data: msg.data.slice(i, i + SessionManager.MAX_OUTPUT_CHUNK) });
+                }
+                if (session.outputHistory.length > MAX_HISTORY) {
+                    session.outputHistory.splice(0, session.outputHistory.length - MAX_HISTORY);
+                }
+                this.persistToDiskDebounced();
+                return;
+            }
         }
         session.outputHistory.push(msg);
         if (session.outputHistory.length > MAX_HISTORY) {
-            session.outputHistory = session.outputHistory.slice(-MAX_HISTORY);
+            session.outputHistory.splice(0, session.outputHistory.length - MAX_HISTORY);
         }
         this.persistToDiskDebounced();
     }
@@ -1674,6 +1840,10 @@ export class SessionManager {
     /** Graceful shutdown: complete in-progress tasks, persist state, kill all processes.
      *  Returns a promise that resolves once all Claude processes have exited. */
     shutdown() {
+        if (this._idleReaperInterval) {
+            clearInterval(this._idleReaperInterval);
+            this._idleReaperInterval = null;
+        }
         // Complete in-progress tasks for active sessions before persisting.
         // This handles self-deploy: the commit/push task was the last step, and
         // the server restart means it succeeded. Without this, restored sessions