hammoc 1.1.5 → 1.2.0

package/packages/server/dist/services/summarizeService.js

@@ -0,0 +1,122 @@
+/**
+ * Summarize Service — Story 25.9
+ *
+ * Uses Agent SDK query() with a temporary session to generate conversation
+ * summaries. Works with both OAuth and API key authentication.
+ * The temporary session JSONL is deleted after use.
+ */
+import { randomUUID } from 'crypto';
+import { unlink } from 'fs/promises';
+import { query } from '@anthropic-ai/claude-agent-sdk';
+import { createLogger } from '../utils/logger.js';
+import { SessionService } from './sessionService.js';
+const log = createLogger('summarizeService');
+const SUMMARY_PROMPT_PREFIX = `You are a conversation summarizer. Given the following conversation between a user and an AI assistant, produce a concise structured summary that preserves:
+
+1. **Key decisions made** — what was agreed upon
+2. **Important code changes** — files created/modified, patterns adopted
+3. **Current state** — what has been completed, what remains
+4. **Critical context** — constraints, gotchas, or requirements mentioned
+
+Format the summary as a bulleted list grouped by these categories. Be concise but complete — the summary will be used to continue the conversation from an earlier point. Write in the same language as the original conversation.
+
+<conversation>
+`;
+const SUMMARY_PROMPT_SUFFIX = `
+</conversation>
+
+Summarize the above conversation.`;
+/** Max estimated tokens for input messages (safety margin) */
+const MAX_INPUT_TOKENS = 200_000;
+/** Simple heuristic: ~4 chars per token */
+function estimateTokens(text) {
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Summarize a list of conversation messages using Agent SDK query().
+ * Creates a temporary session, extracts the summary, then deletes the session file.
+ */
+export async function summarize(messages, options) {
+    if (!messages || messages.length === 0) {
+        throw new Error('No messages to summarize');
+    }
+    // Truncate from the beginning if over token limit (keep recent messages)
+    let truncated = messages;
+    let totalTokens = truncated.reduce((sum, m) => sum + estimateTokens(m.content), 0);
+    if (totalTokens > MAX_INPUT_TOKENS) {
+        truncated = [...messages];
+        while (totalTokens > MAX_INPUT_TOKENS && truncated.length > 0) {
+            const removed = truncated.shift();
+            totalTokens -= estimateTokens(removed.content);
+        }
+        log.info(`Truncated messages from ${messages.length} to ${truncated.length} (token estimate: ${totalTokens})`);
+        if (truncated.length === 0) {
+            throw new Error('Conversation too large to summarize');
+        }
+    }
+    // Format conversation
+    const conversationText = truncated
+        .map((m) => `${m.role}: ${m.content}`)
+        .join('\n');
+    let localeHint = '';
+    if (options?.locale) {
+        localeHint = `\nRespond in ${options.locale} language.\n`;
+    }
+    const prompt = SUMMARY_PROMPT_PREFIX + conversationText + SUMMARY_PROMPT_SUFFIX + localeHint;
+    const tempSessionId = randomUUID();
+    // Resolve temp session JSONL path using SessionService (same encoding as SDK)
+    let tempSessionPath = null;
+    if (options?.projectSlug) {
+        const sessionService = new SessionService();
+        tempSessionPath = sessionService.getSessionFilePath(options.projectSlug, tempSessionId);
+    }
+    log.info(`Generating summary: tempSession=${tempSessionId}, messageCount=${truncated.length}`);
+    try {
+        const q = query({
+            prompt,
+            options: {
+                maxTurns: 1,
+                sessionId: tempSessionId,
+                cwd: options?.cwd,
+                permissionMode: 'dontAsk',
+                enableFileCheckpointing: false,
+                abortController: options?.signal
+                    ? (() => { const ac = new AbortController(); options.signal.addEventListener('abort', () => ac.abort(), { once: true }); return ac; })()
+                    : undefined,
+            },
+        });
+        let resultText = '';
+        for await (const message of q) {
+            if (options?.signal?.aborted) {
+                await q.return();
+                break;
+            }
+            if (message.type === 'result') {
+                const msg = message;
+                if (msg.subtype === 'success' && msg.result) {
+                    resultText = msg.result;
+                }
+                else if (msg.is_error || (msg.subtype && msg.subtype !== 'success')) {
+                    throw new Error(msg.result || `Summary failed: ${msg.subtype}`);
+                }
+            }
+        }
+        if (!resultText) {
+            throw new Error('No text content in summary response');
+        }
+        return resultText;
+    }
+    finally {
+        // Clean up temporary session JSONL
+        if (tempSessionPath) {
+            try {
+                await unlink(tempSessionPath);
+                log.debug(`Deleted temp session: ${tempSessionPath}`);
+            }
+            catch {
+                log.warn(`Failed to delete temp session: ${tempSessionPath}`);
+            }
+        }
+    }
+}
+//# sourceMappingURL=summarizeService.js.map

package/packages/server/dist/services/summarizeService.js.map

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

package/packages/server/dist/utils/imageUtils.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Shared image utilities for hash computation, MIME mapping, and path/URL construction.
+ * Used by imageStorageService and historyParser to ensure consistent behavior.
+ */
+export declare function getExtensionFromMimeType(mimeType: string): string | undefined;
+export declare function computeImageHash(data: string): string;
+export declare function buildImageFilename(data: string, mimeType: string): string | null;
+export declare function buildThumbnailFilename(data: string, mimeType: string): string | null;
+export declare function buildImageUrl(projectSlug: string, sessionId: string, filename: string): string;
+export declare function getImageDir(projectDir: string, sessionId: string): string;
+//# sourceMappingURL=imageUtils.d.ts.map

package/packages/server/dist/utils/imageUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageUtils.d.ts","sourceRoot":"","sources":["../../src/utils/imageUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,wBAAgB,wBAAwB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE7E;AAED,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAErD;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIhF;AAED,wBAAgB,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAIpF;AAED,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAE9F;AAED,wBAAgB,WAAW,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEzE"}

package/packages/server/dist/utils/imageUtils.js

@@ -0,0 +1,37 @@
+/**
+ * Shared image utilities for hash computation, MIME mapping, and path/URL construction.
+ * Used by imageStorageService and historyParser to ensure consistent behavior.
+ */
+import crypto from 'crypto';
+import path from 'path';
+const MIME_TO_EXT = {
+    'image/png': '.png',
+    'image/jpeg': '.jpg',
+    'image/gif': '.gif',
+    'image/webp': '.webp',
+};
+export function getExtensionFromMimeType(mimeType) {
+    return MIME_TO_EXT[mimeType];
+}
+export function computeImageHash(data) {
+    return crypto.createHash('sha256').update(data).digest('hex').substring(0, 16);
+}
+export function buildImageFilename(data, mimeType) {
+    const ext = MIME_TO_EXT[mimeType];
+    if (!ext)
+        return null;
+    return `${computeImageHash(data)}${ext}`;
+}
+export function buildThumbnailFilename(data, mimeType) {
+    const ext = MIME_TO_EXT[mimeType];
+    if (!ext)
+        return null;
+    return `${computeImageHash(data)}_thumb${ext}`;
+}
+export function buildImageUrl(projectSlug, sessionId, filename) {
+    return `/api/projects/${projectSlug}/sessions/${sessionId}/images/${filename}`;
+}
+export function getImageDir(projectDir, sessionId) {
+    return path.join(projectDir, 'images', sessionId);
+}
+//# sourceMappingURL=imageUtils.js.map

package/packages/server/dist/utils/imageUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"imageUtils.js","sourceRoot":"","sources":["../../src/utils/imageUtils.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,WAAW,GAA2B;IAC1C,WAAW,EAAE,MAAM;IACnB,YAAY,EAAE,MAAM;IACpB,WAAW,EAAE,MAAM;IACnB,YAAY,EAAE,OAAO;CACtB,CAAC;AAEF,MAAM,UAAU,wBAAwB,CAAC,QAAgB;IACvD,OAAO,WAAW,CAAC,QAAQ,CAAC,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,OAAO,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,IAAY,EAAE,QAAgB;IAC/D,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,GAAG,GAAG,EAAE,CAAC;AAC3C,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,IAAY,EAAE,QAAgB;IACnE,MAAM,GAAG,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IACtB,OAAO,GAAG,gBAAgB,CAAC,IAAI,CAAC,SAAS,GAAG,EAAE,CAAC;AACjD,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,WAAmB,EAAE,SAAiB,EAAE,QAAgB;IACpF,OAAO,iBAAiB,WAAW,aAAa,SAAS,WAAW,QAAQ,EAAE,CAAC;AACjF,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,UAAkB,EAAE,SAAiB;IAC/D,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,CAAC,CAAC;AACpD,CAAC"}

package/packages/server/dist/utils/messageTree.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Server-side message tree building utilities
+ * Story 25.4: Branch-aware Message Pagination
+ *
+ * Pure functions that work with RawJSONLMessage to build a tree,
+ * extract active branch paths, and compute branch points.
+ */
+import type { RawJSONLMessage } from '@hammoc/shared';
+export interface RawTreeNode {
+    message: RawJSONLMessage;
+    children: RawTreeNode[];
+}
+export interface RawMessageTree {
+    roots: RawTreeNode[];
+    nodeMap: Map<string, RawTreeNode>;
+}
+export interface BranchPointInfo {
+    total: number;
+    current: number;
+    /** The key to use in branchSelections when navigating this branch point.
+     *  For inner branches: the parent node's UUID. For root-level: ROOT_BRANCH_KEY. */
+    selectionKey: string;
+}
+export interface ActiveBranchResult {
+    messages: RawJSONLMessage[];
+    branchPoints: Record<string, BranchPointInfo>;
+}
+/**
+ * Group children into logical branches by UUID prefix.
+ * A true branch exists only when there are multiple user-type groups.
+ * Mirrors client-side groupChildrenIntoBranches logic.
+ */
+export declare function groupRawChildrenIntoBranches(children: RawTreeNode[]): RawTreeNode[][];
+/**
+ * Build a raw message tree from JSONL messages using parentUuid links.
+ * Handles orphans (missing parent) and circular references defensively.
+ */
+export declare function buildRawMessageTree(messages: RawJSONLMessage[]): RawMessageTree;
+/**
+ * Find default branch selections by tracing from the newest leaf to root.
+ * Returns a Record<string, number> mapping branch point UUIDs to selected indices.
+ */
+export declare function getDefaultRawBranchSelections(roots: RawTreeNode[]): Record<string, number>;
+/**
+ * Extract the active branch as a flat RawJSONLMessage array,
+ * following branch selections. Unselected branch points default to last (newest) branch.
+ * Also computes branchPoints info for the response.
+ */
+export declare function getActiveRawBranch(roots: RawTreeNode[], branchSelections: Record<string, number>): ActiveBranchResult;
+/**
+ * Find branch selections that lead to a specific message UUID.
+ * Returns a branchSelections record suitable for getActiveRawBranch,
+ * or null if the UUID is not found in the tree.
+ */
+export declare function findBranchSelectionsForUuid(roots: RawTreeNode[], targetUuid: string): Record<string, number> | null;
+//# sourceMappingURL=messageTree.d.ts.map

package/packages/server/dist/utils/messageTree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messageTree.d.ts","sourceRoot":"","sources":["../../src/utils/messageTree.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAQtD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,eAAe,CAAC;IACzB,QAAQ,EAAE,WAAW,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,WAAW,EAAE,CAAC;IACrB,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB;uFACmF;IACnF,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CAC/C;AAkCD;;;;GAIG;AACH,wBAAgB,4BAA4B,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,EAAE,CAiDrF;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,eAAe,EAAE,GAAG,cAAc,CA8D/E;AAED;;;GAGG;AACH,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAgF1F;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,WAAW,EAAE,EACpB,gBAAgB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GACvC,kBAAkB,CA2EpB;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,WAAW,EAAE,EACpB,UAAU,EAAE,MAAM,GACjB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAgD/B"}

package/packages/server/dist/utils/messageTree.js

@@ -0,0 +1,356 @@
+/**
+ * Server-side message tree building utilities
+ * Story 25.4: Branch-aware Message Pagination
+ *
+ * Pure functions that work with RawJSONLMessage to build a tree,
+ * extract active branch paths, and compute branch points.
+ */
+import { ROOT_BRANCH_KEY } from '@hammoc/shared';
+import { createLogger } from './logger.js';
+const log = createLogger('messageTree');
+// --- Helpers ---
+/** Message types that participate in the conversation tree for branch selection */
+const CONVERSATION_TYPES = new Set(['user', 'assistant', 'system']);
+/**
+ * Detect task-notification user messages injected by background tasks.
+ * These are user-type messages whose content starts with <task-notification> —
+ * they should not count as branch-creating user messages since they are
+ * system-injected and can arrive concurrently with real user input.
+ */
+function isTaskNotification(node) {
+    const content = node.message.message?.content;
+    if (typeof content === 'string')
+        return content.trimStart().startsWith('<task-notification>');
+    if (Array.isArray(content)) {
+        const first = content.find((c) => c.type === 'text');
+        return first?.text?.trimStart().startsWith('<task-notification>') ?? false;
+    }
+    return false;
+}
+/**
+ * Extract base UUID from a potentially split message UUID.
+ * Split IDs follow patterns: {uuid}-text-{n}, {uuid}-tool-{id}, {uuid}-thinking
+ */
+function getBaseUuid(uuid) {
+    const match = uuid.match(/^([0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12})(?:-(text-\d+|tool-.+|thinking))?$/);
+    return match ? match[1] : uuid;
+}
+/**
+ * Group children into logical branches by UUID prefix.
+ * A true branch exists only when there are multiple user-type groups.
+ * Mirrors client-side groupChildrenIntoBranches logic.
+ */
+export function groupRawChildrenIntoBranches(children) {
+    // Step 1: group split fragments by base UUID
+    const groups = new Map();
+    for (const child of children) {
+        const base = getBaseUuid(child.message.uuid);
+        if (!groups.has(base))
+            groups.set(base, []);
+        groups.get(base).push(child);
+    }
+    const uuidGroups = Array.from(groups.values());
+    if (uuidGroups.length <= 1)
+        return uuidGroups;
+    // Step 2: detect true branches — only user-type groups count.
+    // A group "leads to a user" if it directly contains a user-type node OR
+    // if it contains a non-conversation intermediary (e.g. attachment, progress)
+    // whose subtree contains any conversation node. This handles chains like
+    // user → attachment → attachment → assistant (normal flow through attachments)
+    // and assistant → progress → user (resumeSessionAt asymmetry).
+    function hasConversationDescendant(n, depth) {
+        if (depth > 10)
+            return false;
+        if (CONVERSATION_TYPES.has(n.message.type))
+            return true;
+        return n.children.some((c) => hasConversationDescendant(c, depth + 1));
+    }
+    function groupLeadsToUser(g) {
+        return g.some((n) => (n.message.type === 'user' && !isTaskNotification(n)) ||
+            (!CONVERSATION_TYPES.has(n.message.type) && hasConversationDescendant(n, 0)));
+    }
+    const userGroupCount = uuidGroups.filter(groupLeadsToUser).length;
+    if (userGroupCount <= 1) {
+        // No real branches — all children are sequential flow
+        return [children];
+    }
+    // Multiple user groups = true branch point.
+    // Fold non-user groups into the nearest preceding user group.
+    const branches = [];
+    for (const group of uuidGroups) {
+        if (groupLeadsToUser(group)) {
+            branches.push([...group]);
+        }
+        else if (branches.length > 0) {
+            branches[branches.length - 1].push(...group);
+        }
+        else {
+            branches.push([...group]);
+        }
+    }
+    return branches;
+}
+// --- Core Functions ---
+/**
+ * Build a raw message tree from JSONL messages using parentUuid links.
+ * Handles orphans (missing parent) and circular references defensively.
+ */
+export function buildRawMessageTree(messages) {
+    const nodeMap = new Map();
+    const roots = [];
+    // Phase 1: Create all nodes
+    for (const msg of messages) {
+        nodeMap.set(msg.uuid, { message: msg, children: [] });
+    }
+    // Phase 2: Link parent→children, detect orphans
+    for (const msg of messages) {
+        const node = nodeMap.get(msg.uuid);
+        if (!msg.parentUuid) {
+            roots.push(node);
+        }
+        else {
+            const parent = nodeMap.get(msg.parentUuid);
+            if (!parent) {
+                log.warn(`Orphan message "${msg.uuid}" references non-existent parent "${msg.parentUuid}", treating as root`);
+                roots.push(node);
+            }
+            else {
+                parent.children.push(node);
+            }
+        }
+    }
+    // Phase 3: Detect circular references
+    const visited = new Set();
+    const inStack = new Set();
+    function detectCycle(node) {
+        if (inStack.has(node.message.uuid))
+            return true;
+        if (visited.has(node.message.uuid))
+            return false;
+        visited.add(node.message.uuid);
+        inStack.add(node.message.uuid);
+        for (const child of node.children) {
+            if (detectCycle(child)) {
+                log.warn(`Circular reference detected at "${child.message.uuid}", breaking link and treating as root`);
+                node.children = node.children.filter((c) => c !== child);
+                roots.push(child);
+            }
+        }
+        inStack.delete(node.message.uuid);
+        return false;
+    }
+    for (const root of [...roots]) {
+        detectCycle(root);
+    }
+    // Phase 3b: Promote unvisited nodes (rootless cycles)
+    for (const node of nodeMap.values()) {
+        if (!visited.has(node.message.uuid)) {
+            log.warn(`Unreachable node "${node.message.uuid}" promoted to root`);
+            roots.push(node);
+            detectCycle(node);
+        }
+    }
+    return { roots, nodeMap };
+}
+/**
+ * Find default branch selections by tracing from the newest leaf to root.
+ * Returns a Record<string, number> mapping branch point UUIDs to selected indices.
+ */
+export function getDefaultRawBranchSelections(roots) {
+    const selections = {};
+    if (roots.length === 0)
+        return selections;
+    // Find newest leaf
+    let newestLeaf = null;
+    let newestTime = '';
+    function findLeaves(node) {
+        const branches = groupRawChildrenIntoBranches(node.children);
+        if (branches.length === 0) {
+            // Only consider conversation-relevant types (user, assistant, system) as
+            // leaf candidates. Metadata types (queue-operation, file-history-snapshot,
+            // progress, last-prompt) are often isolated roots with no children — if
+            // their timestamp is newer than the last conversation message they would
+            // be incorrectly selected, causing getActiveRawBranch to pick an empty root.
+            if (!CONVERSATION_TYPES.has(node.message.type))
+                return;
+            const ts = node.message.timestamp || '';
+            if (ts > newestTime || !newestLeaf) {
+                newestTime = ts;
+                newestLeaf = node;
+            }
+            return;
+        }
+        for (const branch of branches) {
+            for (const child of branch) {
+                findLeaves(child);
+            }
+        }
+    }
+    for (const root of roots) {
+        findLeaves(root);
+    }
+    if (!newestLeaf)
+        return selections;
+    // Build parent map for reverse traversal
+    const parentMap = new Map();
+    function buildParentMap(node) {
+        for (const child of node.children) {
+            parentMap.set(child.message.uuid, node);
+            buildParentMap(child);
+        }
+    }
+    for (const root of roots) {
+        buildParentMap(root);
+    }
+    // Walk up from leaf
+    let current = newestLeaf;
+    while (current) {
+        const parent = parentMap.get(current.message.uuid);
+        if (parent) {
+            const branches = groupRawChildrenIntoBranches(parent.children);
+            if (branches.length > 1) {
+                const branchIdx = branches.findIndex((branch) => branch.some((n) => n.message.uuid === current.message.uuid));
+                if (branchIdx >= 0) {
+                    selections[parent.message.uuid] = branchIdx;
+                }
+            }
+        }
+        else {
+            // current is a root — check multi-root selection
+            // Use conversation-relevant roots only (matching getActiveRawBranch)
+            const convRoots = roots.filter((r) => r.children.length > 0 || CONVERSATION_TYPES.has(r.message.type));
+            if (convRoots.length > 1) {
+                const rootIdx = convRoots.indexOf(current);
+                if (rootIdx >= 0) {
+                    selections[ROOT_BRANCH_KEY] = rootIdx;
+                }
+            }
+        }
+        current = parent || null;
+    }
+    return selections;
+}
+/**
+ * Extract the active branch as a flat RawJSONLMessage array,
+ * following branch selections. Unselected branch points default to last (newest) branch.
+ * Also computes branchPoints info for the response.
+ */
+export function getActiveRawBranch(roots, branchSelections) {
+    const messages = [];
+    const branchPoints = {};
+    if (roots.length === 0)
+        return { messages, branchPoints };
+    // Handle multi-root
+    // Filter to conversation-relevant roots: roots that either have children
+    // (part of a conversation chain) or are displayable types (user/assistant/system).
+    // Isolated metadata roots (queue-operation, file-history-snapshot, progress
+    // without children, last-prompt) are noise and must not participate in
+    // branch selection — otherwise they inflate the root count and cause the
+    // wrong root to be selected as the active conversation epoch.
+    let activeRoots;
+    const conversationRoots = roots.filter((r) => r.children.length > 0 || CONVERSATION_TYPES.has(r.message.type));
+    if (conversationRoots.length > 1) {
+        const userRootCount = conversationRoots.filter((r) => r.message.type === 'user').length;
+        const hasCompactBoundary = conversationRoots.some((r) => r.message.type === 'system' && r.message.subtype === 'compact_boundary');
+        if (userRootCount > 1 || hasCompactBoundary) {
+            const selectedIdx = branchSelections[ROOT_BRANCH_KEY] ?? conversationRoots.length - 1;
+            const clampedIdx = Math.max(0, Math.min(selectedIdx, conversationRoots.length - 1));
+            const selectedRoot = conversationRoots[clampedIdx];
+            const rootKey = selectedRoot.message.type === 'user' ? selectedRoot.message.uuid : ROOT_BRANCH_KEY;
+            branchPoints[rootKey] = { total: conversationRoots.length, current: clampedIdx, selectionKey: ROOT_BRANCH_KEY };
+            activeRoots = [selectedRoot];
+        }
+        else {
+            // Sequential orphan roots — display all conversation roots
+            activeRoots = conversationRoots;
+        }
+    }
+    else {
+        // 0 or 1 conversation root — traverse all conversation roots (+ metadata
+        // roots with children, already included via the filter)
+        activeRoots = conversationRoots.length > 0 ? conversationRoots : roots;
+    }
+    function traverse(node) {
+        messages.push(node.message);
+        const branches = groupRawChildrenIntoBranches(node.children);
+        if (branches.length === 0)
+            return;
+        if (branches.length > 1) {
+            const selectedIdx = branchSelections[node.message.uuid] ?? branches.length - 1;
+            const clampedIdx = Math.max(0, Math.min(selectedIdx, branches.length - 1));
+            // Tag the first user message in the selected branch with branch info.
+            // If no direct user child exists, check one level deeper (handles
+            // assistant → progress → user pattern where progress is intermediary).
+            const selectedBranch = branches[clampedIdx];
+            const firstUserInBranch = selectedBranch.find((n) => n.message.type === 'user')
+                || selectedBranch.flatMap((n) => n.children).find((c) => c.message.type === 'user');
+            const branchKey = firstUserInBranch ? firstUserInBranch.message.uuid : node.message.uuid;
+            branchPoints[branchKey] = { total: branches.length, current: clampedIdx, selectionKey: node.message.uuid };
+            for (const child of selectedBranch) {
+                traverse(child);
+            }
+        }
+        else {
+            for (const child of branches[0]) {
+                traverse(child);
+            }
+        }
+    }
+    for (const root of activeRoots) {
+        traverse(root);
+    }
+    return { messages, branchPoints };
+}
+/**
+ * Find branch selections that lead to a specific message UUID.
+ * Returns a branchSelections record suitable for getActiveRawBranch,
+ * or null if the UUID is not found in the tree.
+ */
+export function findBranchSelectionsForUuid(roots, targetUuid) {
+    const selections = {};
+    function containsUuid(node) {
+        if (node.message.uuid === targetUuid)
+            return true;
+        return node.children.some(containsUuid);
+    }
+    function traverse(node) {
+        if (node.message.uuid === targetUuid)
+            return true;
+        const branches = groupRawChildrenIntoBranches(node.children);
+        if (branches.length === 0)
+            return false;
+        for (let i = 0; i < branches.length; i++) {
+            if (branches[i].some(containsUuid)) {
+                if (branches.length > 1) {
+                    selections[node.message.uuid] = i;
+                }
+                for (const child of branches[i]) {
+                    if (traverse(child))
+                        return true;
+                }
+                return true;
+            }
+        }
+        return false;
+    }
+    // Handle multi-root: check which root tree contains the target
+    const conversationRoots = roots.filter((r) => r.children.length > 0 || CONVERSATION_TYPES.has(r.message.type));
+    if (conversationRoots.length > 1) {
+        for (let i = 0; i < conversationRoots.length; i++) {
+            if (containsUuid(conversationRoots[i])) {
+                selections[ROOT_BRANCH_KEY] = i;
+                if (traverse(conversationRoots[i]))
+                    return selections;
+                return selections;
+            }
+        }
+        return null;
+    }
+    const searchRoots = conversationRoots.length > 0 ? conversationRoots : roots;
+    for (const root of searchRoots) {
+        if (traverse(root))
+            return selections;
+    }
+    return null;
+}
+//# sourceMappingURL=messageTree.js.map

package/packages/server/dist/utils/messageTree.js.map

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

package/packages/server/package.json

@@ -27,6 +27,7 @@
     "js-yaml": "^4.1.1",
     "multer": "^2.1.1",
     "node-pty": "^1.0.0",
+    "sharp": "^0.34.5",
     "simple-git": "^3.27.0",
     "socket.io": "^4.8.0",
     "web-push": "^3.6.7",
@@ -41,12 +42,13 @@
     "@types/js-yaml": "^4.0.9",
     "@types/multer": "^2.1.0",
     "@types/node": "^22.0.0",
+    "@types/sharp": "^0.31.1",
     "@types/supertest": "^6.0.3",
     "@types/web-push": "^3.6.4",
     "@vitest/coverage-v8": "^2.0.0",
     "supertest": "^7.2.2",
     "tsx": "^4.19.0",
     "typescript": "^5.6.0",
-    "vitest": "^2.0.0"
+    "vitest": "^2.1.9"
   }
 }

package/packages/shared/dist/constants/index.d.ts

@@ -0,0 +1,3 @@
+export * from './errorCodes.js';
+export * from './messageTree.js';
+//# sourceMappingURL=index.d.ts.map

package/packages/shared/dist/constants/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/constants/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC"}