hammoc 1.2.2 → 1.3.0

package/packages/server/dist/handlers/websocket.d.ts.map

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

package/packages/server/dist/handlers/websocket.js

@@ -31,6 +31,7 @@ import { parseJSONLFile, transformToHistoryMessages } from '../services/historyP
 import { buildRawMessageTree, getActiveRawBranch, getDefaultRawBranchSelections, findBranchSelectionsForUuid } from '../utils/messageTree.js';
 import { sessionBufferManager } from '../services/sessionBufferManager.js';
 import { imageStorageService } from '../services/imageStorageService.js';
+import { isSnippetRef, resolveSnippet, listSnippets, SnippetError } from '../utils/snippetResolver.js';
 const log = createLogger('websocket');
 // Alias for concise usage in guards
 const queueInstances = getQueueInstances;
@@ -415,9 +416,17 @@ export function getJoinedSessionIdsByProject(projectSlug) {
 async function completeBufferAndBroadcast(sessionId, projectSlug, stream) {
     const aborted = stream?.abortController.signal.aborted ?? false;
     const usage = stream?.deferredUsage;
+    // Guard: if a new stream has taken over during async polling, skip emit
+    // to prevent overwriting the newer stream's client state with stale data.
+    const isStreamReplaced = () => stream && activeStreams.has(sessionId) && activeStreams.get(sessionId) !== stream;
     if (projectSlug) {
         try {
             const messages = await pollFileStabilityThenReload(sessionId, projectSlug);
+            if (isStreamReplaced()) {
+                log.info(`completeBufferAndBroadcast: stream replaced during JSONL polling, skipping emit for ${sessionId}`);
+                sessionBufferManager.setStreaming(sessionId, false);
+                return;
+            }
             sessionBufferManager.setStreaming(sessionId, false);
             io.to(`session:${sessionId}`).emit('stream:complete-messages', {
                 sessionId, messages, usage, ...(aborted && { aborted: true }),
@@ -425,6 +434,11 @@ async function completeBufferAndBroadcast(sessionId, projectSlug, stream) {
         }
         catch (err) {
             log.error(`completeBufferAndBroadcast: failed for ${sessionId}:`, err);
+            if (isStreamReplaced()) {
+                log.info(`completeBufferAndBroadcast: stream replaced (error path), skipping emit for ${sessionId}`);
+                sessionBufferManager.setStreaming(sessionId, false);
+                return;
+            }
             sessionBufferManager.setStreaming(sessionId, false);
             const fallback = sessionBufferManager.get(sessionId)?.messages ?? [];
             io.to(`session:${sessionId}`).emit('stream:complete-messages', {
@@ -500,7 +514,7 @@ function cleanupStream(streamKey, expectedStream) {
 }
 /** Normalize legacy 'never' sync policy to 'streaming' */
 function normalizeSyncPolicy(policy) {
-    return policy === 'always' ? 'always' : 'streaming';
+    return policy === 'streaming' ? 'streaming' : 'always';
 }
 /**
  * Persist the stream's final permission mode to .hammoc/session-permissions.json.
@@ -858,33 +872,41 @@ export async function initializeWebSocket(httpServer) {
                     // from disk and broadcast confirmed messages to all session viewers.
                     const sendEndSlug = sessionProjectMap.get(endedSessionId) ?? null;
                     await completeBufferAndBroadcast(endedSessionId, sendEndSlug, stream);
-                    cleanupStream(endedSessionId);
-                    emitStreamChange(endedSessionId, false, sendEndSlug);
-                    // Persist per-session permission mode before cleanup
-                    const sendFinalMode = stream.chatService?.getPermissionMode();
-                    if (sendFinalMode)
-                        await persistSessionPermissionMode(endedSessionId, sendFinalMode);
-                    // Story 20.1: Trigger dashboard status change on stream end
-                    const endProjectSlug = sessionProjectMap.get(endedSessionId);
-                    if (endProjectSlug) {
-                        // Update sessions-index.json so future list queries hit cache
-                        new SessionService().updateSessionIndex(endProjectSlug, endedSessionId).catch((err) => {
-                            log.warn(`Failed to update session index: project=${endProjectSlug} session=${endedSessionId}`, err);
-                        });
-                        triggerDashboardStatusChange(endProjectSlug);
-                        sessionProjectMap.delete(endedSessionId);
-                    }
-                    // Story 24.1: Schedule chain drain if pending items exist (browser-independent)
-                    const pendingChain = chainState.get(endedSessionId);
-                    const pendingCount = pendingChain?.filter(item => item.status === 'pending').length ?? 0;
-                    log.info(`[CHAIN-DRAIN] chat:send finally: chainItems=${pendingChain?.length ?? 0}, pendingCount=${pendingCount}, statuses=${JSON.stringify(pendingChain?.map(i => ({ id: i.id.slice(0, 8), status: i.status })) ?? [])}`);
-                    if (pendingChain && pendingChain.some(item => item.status === 'pending')) {
-                        scheduleChainDrain(endedSessionId, lang);
+                    // Re-check after async operation — a new chat:send may have replaced
+                    // this stream during JSONL polling, taking over activeStreams/socketToSession.
+                    // Cleaning up or emitting inactive would corrupt the replacement stream.
+                    if (activeStreams.get(endedSessionId) !== stream && activeStreams.has(endedSessionId)) {
+                        log.info(`chat:send finally: stream replaced after completeBufferAndBroadcast for ${endedSessionId}, skipping cleanup`);
                     }
                     else {
-                        log.info(`[CHAIN-DRAIN] chat:send finally: no pending chain items, calling cleanupChainIfIdle for ${endedSessionId}`);
-                        cleanupChainIfIdle(endedSessionId);
-                    }
+                        cleanupStream(endedSessionId, stream);
+                        emitStreamChange(endedSessionId, false, sendEndSlug);
+                        // Persist per-session permission mode before cleanup
+                        const sendFinalMode = stream.chatService?.getPermissionMode();
+                        if (sendFinalMode)
+                            await persistSessionPermissionMode(endedSessionId, sendFinalMode);
+                        // Story 20.1: Trigger dashboard status change on stream end
+                        const endProjectSlug = sessionProjectMap.get(endedSessionId);
+                        if (endProjectSlug) {
+                            // Update sessions-index.json so future list queries hit cache
+                            new SessionService().updateSessionIndex(endProjectSlug, endedSessionId).catch((err) => {
+                                log.warn(`Failed to update session index: project=${endProjectSlug} session=${endedSessionId}`, err);
+                            });
+                            triggerDashboardStatusChange(endProjectSlug);
+                            sessionProjectMap.delete(endedSessionId);
+                        }
+                        // Story 24.1: Schedule chain drain if pending items exist (browser-independent)
+                        const pendingChain = chainState.get(endedSessionId);
+                        const pendingCount = pendingChain?.filter(item => item.status === 'pending').length ?? 0;
+                        log.info(`[CHAIN-DRAIN] chat:send finally: chainItems=${pendingChain?.length ?? 0}, pendingCount=${pendingCount}, statuses=${JSON.stringify(pendingChain?.map(i => ({ id: i.id.slice(0, 8), status: i.status })) ?? [])}`);
+                        if (pendingChain && pendingChain.some(item => item.status === 'pending')) {
+                            scheduleChainDrain(endedSessionId, lang);
+                        }
+                        else {
+                            log.info(`[CHAIN-DRAIN] chat:send finally: no pending chain items, calling cleanupChainIfIdle for ${endedSessionId}`);
+                            cleanupChainIfIdle(endedSessionId);
+                        }
+                    } // end re-check else (stream not replaced after await)
                 }
                 else {
                     log.warn(`[CHAIN-DRAIN] chat:send finally: stream is NOT current active stream (replaced?): endedSessionId=${endedSessionId}`);
@@ -988,7 +1010,7 @@ export async function initializeWebSocket(httpServer) {
             // Use projectSlug from client as fallback when sessionProjectMap entry is gone (stream ended)
             await persistSessionPermissionMode(sessionId, mode, projectSlug);
             // 3) Broadcast to other viewers based on sync policy
-            let syncPolicy = 'streaming';
+            let syncPolicy = 'always';
             try {
                 const prefs = await preferencesService.readPreferences();
                 syncPolicy = normalizeSyncPolicy(prefs.permissionSyncPolicy);
@@ -1158,7 +1180,7 @@ export async function initializeWebSocket(httpServer) {
             const permissionMode = stream.chatService?.getPermissionMode();
             // Story 27.1: Deliver buffer messages (history + streaming data accumulated so far)
             // so a new browser joining mid-stream sees the full context immediately.
-            let buf = sessionBufferManager.get(sessionId);
+            const buf = sessionBufferManager.get(sessionId);
             // Buffer may have been destroyed if all sockets left briefly — recover from JSONL
             if (!buf) {
                 const slug = sessionProjectMap.get(sessionId);
@@ -1233,7 +1255,7 @@ export async function initializeWebSocket(httpServer) {
             }
         });
         // Story 24.1: Prompt chain event handlers
-        socket.on('chain:add', (data) => {
+        socket.on('chain:add', async (data) => {
             if (!data || typeof data !== 'object')
                 return;
             const { sessionId, content, workingDirectory, permissionMode, model, effort } = data;
@@ -1254,6 +1276,55 @@ export async function initializeWebSocket(httpServer) {
             if (!socket.rooms.has(`session:${sessionId}`))
                 return;
             const items = chainState.get(sessionId) || [];
+            // BS-2: Snippet resolution
+            if (isSnippetRef(content)) {
+                let resolvedPrompts;
+                try {
+                    resolvedPrompts = await resolveSnippet(content, workingDirectory);
+                }
+                catch (error) {
+                    if (error instanceof SnippetError) {
+                        const errKey = error.code === 'NOT_FOUND' ? 'snippetNotFound'
+                            : error.code === 'SIZE_EXCEEDED' ? 'snippetSizeExceeded'
+                                : 'snippetParseError';
+                        socket.emit('error', {
+                            code: ERROR_CODES.CHAT_ERROR,
+                            message: t(`ws.error.${errKey}`, {
+                                name: error.snippetName || error.message,
+                                message: error.message,
+                                defaultValue: error.message,
+                            }),
+                        });
+                        return;
+                    }
+                    throw error;
+                }
+                if (items.length + resolvedPrompts.length > 10) {
+                    socket.emit('error', {
+                        code: ERROR_CODES.CHAIN_MAX_EXCEEDED,
+                        message: t('ws.error.chainMaxExceeded'),
+                    });
+                    return;
+                }
+                for (const prompt of resolvedPrompts) {
+                    items.push({
+                        id: generateChainItemId(),
+                        content: prompt,
+                        status: 'pending',
+                        createdAt: Date.now(),
+                        workingDirectory,
+                        permissionMode,
+                        model,
+                        effort,
+                    });
+                }
+                chainState.set(sessionId, items);
+                broadcastChainUpdate(sessionId);
+                if (!activeStreams.has(sessionId)) {
+                    scheduleChainDrain(sessionId, lang);
+                }
+                return;
+            }
             if (items.length >= 10) {
                 socket.emit('error', {
                     code: ERROR_CODES.CHAIN_MAX_EXCEEDED,
@@ -1365,7 +1436,7 @@ export async function initializeWebSocket(httpServer) {
             log.info(`session:rewind-files sessionId=${sessionId}, messageUuid=${messageUuid}, dryRun=${!!dryRun}`);
             try {
                 const sessionService = new SessionService();
-                const projectSlug = sessionService.encodeProjectPath(workingDirectory);
+                const _projectSlug = sessionService.encodeProjectPath(workingDirectory);
                 const rewindQuery = sdkQuery({
                     prompt: '',
                     options: {
@@ -1398,8 +1469,16 @@ export async function initializeWebSocket(httpServer) {
                     }
                 }
                 finally {
+                    // Mark session as dirty BEFORE close — SDK query({ prompt: '' })
+                    // writes an empty user message to the JSONL which causes
+                    // cache_control 400 errors. chatService will clean the JSONL
+                    // before the next resume.
+                    sessionService.markRewindDirty(workingDirectory, sessionId);
                     // Clean up the query object
-                    rewindQuery.close();
+                    try {
+                        rewindQuery.close();
+                    }
+                    catch { /* best-effort */ }
                 }
             }
             catch (err) {
@@ -1577,6 +1656,17 @@ export async function initializeWebSocket(httpServer) {
         socket.on('dashboard:unsubscribe', () => {
             socket.leave('dashboard');
         });
+        // ISSUE-54: Snippet autocomplete — list available snippets
+        socket.on('snippets:list', async (data) => {
+            try {
+                const snippets = await listSnippets(data.workingDirectory);
+                socket.emit('snippets:list', { snippets });
+            }
+            catch (err) {
+                log.error('Failed to list snippets:', err);
+                socket.emit('snippets:list', { snippets: [] });
+            }
+        });
         // Handle project:join/leave — room for queue event delivery (Story 15.2)
         socket.on('project:join', (projectSlug) => {
             socket.join(`project:${projectSlug}`);
@@ -1636,7 +1726,13 @@ export async function initializeWebSocket(httpServer) {
             const qs = getOrCreateQueueService(data.projectSlug);
             const result = parseQueueScript(data.rawLine);
             if (result.items.length > 0) {
-                qs.addItem(result.items[0]);
+                const added = qs.addItem(result.items[0]);
+                if (!added && result.items[0].loop) {
+                    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                    socket.emit('queue:addItemRejected', {
+                        reason: 'Block directives (@loop/@end) cannot be added via addItem',
+                    });
+                }
             }
         });
         socket.on('queue:reorderItems', (data) => {
@@ -1921,7 +2017,7 @@ function validateImages(images, lang) {
 async function handleChatSend(stream, data, abortController, lang) {
     const emit = createStreamEmit(stream);
     const t = i18next.getFixedT(lang);
-    const { content, workingDirectory, sessionId, resume, permissionMode, model, images, effort, resumeSessionAt: rawResumeSessionAt, forkSession, rewindToMessageUuid } = data;
+    const { content: rawContent, workingDirectory, sessionId, resume, permissionMode, model, images, effort, resumeSessionAt: rawResumeSessionAt, forkSession, rewindToMessageUuid } = data;
     // Validate images if present (Story 5.5)
     if (images && images.length > 0) {
         const validation = validateImages(images, lang);
@@ -1941,6 +2037,53 @@ async function handleChatSend(stream, data, abortController, lang) {
         });
         return false;
     }
+    // BS-3: Resolve %snippet references in chat:send messages
+    let content = rawContent;
+    const firstLine = rawContent.split('\n')[0];
+    if (isSnippetRef(firstLine)) {
+        try {
+            const resolvedPrompts = await resolveSnippet(rawContent, workingDirectory);
+            content = resolvedPrompts[0];
+            // Multi-prompt: add remaining prompts as chain items
+            if (resolvedPrompts.length > 1 && stream.sessionId) {
+                const items = chainState.get(stream.sessionId) || [];
+                for (let i = 1; i < resolvedPrompts.length; i++) {
+                    items.push({
+                        id: generateChainItemId(),
+                        content: resolvedPrompts[i],
+                        status: 'pending',
+                        createdAt: Date.now(),
+                        workingDirectory,
+                        permissionMode,
+                        model,
+                        effort,
+                    });
+                }
+                chainState.set(stream.sessionId, items);
+                io.to(`session:${stream.sessionId}`).emit('chain:update', {
+                    sessionId: stream.sessionId,
+                    items: items.map(toPublicChainItem),
+                });
+            }
+        }
+        catch (error) {
+            if (error instanceof SnippetError) {
+                const errKey = error.code === 'NOT_FOUND' ? 'snippetNotFound'
+                    : error.code === 'SIZE_EXCEEDED' ? 'snippetSizeExceeded'
+                        : 'snippetParseError';
+                emit('error', {
+                    code: ERROR_CODES.CHAT_ERROR,
+                    message: t(`ws.error.${errKey}`, {
+                        name: error.snippetName || error.message,
+                        message: error.message,
+                        defaultValue: error.message,
+                    }),
+                });
+                return false;
+            }
+            throw error;
+        }
+    }
     // Buffer the user's message so reconnecting clients can display it
     // (SDK may not have written the JSONL file yet at reconnect time).
     // Skip for fork sessions — the fork prompt is delivered via SessionBufferManager
@@ -1974,7 +2117,7 @@ async function handleChatSend(stream, data, abortController, lang) {
     // Root-level edit branching is not supported — the SDK's --resume-session-at
     // only accepts assistant message UUIDs, and there is no assistant before the
     // first user message. The client should not send ROOT_BRANCH_KEY; reject if received.
-    let resumeSessionAt = rawResumeSessionAt;
+    const resumeSessionAt = rawResumeSessionAt;
     if (resumeSessionAt === ROOT_BRANCH_KEY) {
         emit('error', {
             code: ERROR_CODES.VALIDATION_ERROR,
@@ -2058,7 +2201,7 @@ async function handleChatSend(stream, data, abortController, lang) {
             ...(resumeSessionAt ? { resumeSessionAt } : {}),
             // Story 25.11: fork session — create new session from branch point
             ...(forkSession ? { forkSession: true } : {}),
-            enableFileCheckpointing: true,
+            enableFileCheckpointing: effectivePrefs.enableChatCheckpointing ?? true,
             ...(rewindToMessageUuid ? { rewindToMessageUuid } : {}),
         };
         // Create canUseTool callback for permission & AskUserQuestion handling
@@ -2179,7 +2322,7 @@ async function handleChatSend(stream, data, abortController, lang) {
         };
         // Defer completion until JSONL is flushed — keeps client in streaming state.
         // Usage data is stored and included in stream:complete-messages.
-        const baseOnComplete = callbacks.onComplete;
+        const _baseOnComplete = callbacks.onComplete;
         callbacks.onComplete = (response) => {
             if (response.usage) {
                 stream.deferredUsage = response.usage;
@@ -2277,18 +2420,41 @@ async function handleChatSend(stream, data, abortController, lang) {
                 origOnComplete?.(gatedComplete);
         }
         catch (sendError) {
-            // Resume failed — retry once without resume so SDK creates a fresh session.
-            // Guards:
-            //  1. Only when resuming (not a fresh session send)
-            //  2. Skip if intentionally aborted (user-abort / another-client / timeout)
-            //  3. Skip if SDK already emitted output (onSessionInit fired) — retrying would duplicate side-effects
-            //  4. Skip for non-session errors (rate-limit / auth / network / service-unavailable)
             const parsedError = parseSDKError(sendError, lang);
-            const isNonSessionError = !!parsedError.code && parsedError.code !== SDKErrorCode.UNKNOWN;
+            // Context overflow during resume — auto-compact then retry the original message.
+            // /compact is a CLI-level command processed before context evaluation,
+            // so it works even when context is overflowing.
             if (isResumeAttempt
+                && parsedError.code === SDKErrorCode.CONTEXT_OVERFLOW
+                && !abortController.signal.aborted
+                && !hasEmittedOutput) {
+                log.info(`[AUTO-COMPACT] context overflow on resume, running /compact: sessionId=${sessionId}`);
+                emit('system:info', { message: 'Context limit reached — auto-compacting…' });
+                gatedResultError = null;
+                gatedComplete = null;
+                ungateCallbacks();
+                resetTimeout('auto-compact');
+                // Run /compact to shrink context (preserves session file)
+                await chatService.sendMessageWithCallbacks('/compact', callbacks, chatOptions, canUseTool, (messageType) => {
+                    resetTimeout(`compact:${messageType}`);
+                });
+                // Retry the original message after compaction
+                log.info(`[AUTO-COMPACT] compaction done, retrying original message: sessionId=${sessionId}`);
+                resetTimeout('auto-compact-retry');
+                await chatService.sendMessageWithCallbacks(content, callbacks, chatOptions, canUseTool, (messageType) => {
+                    resetTimeout(`retry:${messageType}`);
+                });
+                // Resume failed for other unknown reasons — retry without resume (fresh session).
+                // Guards:
+                //  1. Only when resuming (not a fresh session send)
+                //  2. Skip if intentionally aborted (user-abort / another-client / timeout)
+                //  3. Skip if SDK already emitted output (onSessionInit fired) — retrying would duplicate side-effects
+                //  4. Skip for non-session errors (rate-limit / auth / network / service-unavailable)
+            }
+            else if (isResumeAttempt
                 && !abortController.signal.aborted
                 && !hasEmittedOutput
-                && !isNonSessionError
+                && parsedError.code === SDKErrorCode.UNKNOWN
                 && !chatOptions.resumeSessionAt) {
                 log.info(`[RESUME-RETRY] resume failed, retrying without resume: sessionId=${sessionId}, error=${parsedError.message.slice(0, 120)}`);
                 // Discard gated events and restore original callbacks for the retry