@sumicom/quicksave 0.8.9 → 0.8.10

package/dist/ai/cardBuilder.d.ts

@@ -1,9 +1,31 @@
-import type { Attachment, Card, CardId, CardEvent, CardHistoryResponse, PendingInputAttachment } from '@sumicom/quicksave-shared';
+import type { Attachment, Card, CardId, CardEvent, CardHistoryResponse, PendingInputAttachment, GeneratedImageCard, SystemCard } from '@sumicom/quicksave-shared';
 /**
  * Load persisted card history for a memory-mode session.
  * Returns cards in insertion order, or empty array if none exist.
  */
 export declare function loadPersistedCards(sessionId: string): Promise<Card[]>;
+export declare function encodeCwdPath(cwd: string): string;
+export declare function claudeProjectDir(cwd: string): string;
+export declare function jsonlPath(sessionId: string, cwd: string): string;
+/** Compact "1m 25s" / "45s" duration for the `text` fallback. The PWA renders
+ *  its own badge from `meta.durationMs`; this keeps debug logs and non-PWA
+ *  consumers readable. */
+export declare function formatDurationMs(ms: number): string;
+/** Build a structured `turn_duration` system card from a Claude JSONL entry. */
+export declare function turnDurationCard(msg: {
+    durationMs?: unknown;
+    messageCount?: unknown;
+}, id: CardId): SystemCard;
+/** Build a structured `stop_hook_summary` system card from a Claude JSONL entry.
+ *  Flags as `warning` when any hook errored or blocked continuation — that's the
+ *  channel that surfaces hook misconfigs (e.g. a bad interpreter path). */
+export declare function stopHookSummaryCard(msg: {
+    hookInfos?: unknown;
+    hookErrors?: unknown;
+    level?: unknown;
+    preventedContinuation?: unknown;
+    stopReason?: unknown;
+}, id: CardId): SystemCard;
 export declare class StreamCardBuilder {
     private sessionId;
     private cwd;
@@ -15,6 +37,14 @@ export declare class StreamCardBuilder {
     private agentIdToCardId;
     /** Cards created for subagent permissions — removed after resolution. */
     private ephemeralCards;
+    /** Agent tool_use input stashed from assistant message, keyed by tool_use block.id.
+     *  Consumed when task_started arrives with the matching tool_use_id. */
+    private agentToolUseStash;
+    /** Card ID of the currently running subagent; tool calls are nested here instead of
+     *  being emitted as top-level ToolCallCards. Cleared on task_notification. */
+    private activeSubagentCardId;
+    /** Nested tool_use_id → subagentCardId — lets toolResult() route to the right card. */
+    private nestedToolUseToSubagentCard;
     /** Current streaming assistant_text card (for append_text events) */
     private currentTextCardId;
     /** JSONL file byte offset at the start of the current turn — history reads stop here. */
@@ -34,6 +64,11 @@ export declare class StreamCardBuilder {
      * Call before clearCards() at the end of each turn.
      */
     persistCards(): Promise<void>;
+    /** Persist a single card immediately. Used when a memory-mode provider
+     * injects a user prompt into an already-running turn; the card must survive
+     * refresh before the turn's normal end-of-turn persist runs. */
+    persistCard(card: Card): Promise<void>;
+    private persistCardBatch;
     /** Snapshot current JSONL byte size so history reads stop before the active turn. */
     snapshotCutoff(): Promise<void>;
     /**
@@ -103,10 +138,35 @@ export declare class StreamCardBuilder {
     toolResult(toolUseId: string, content: string, isError: boolean): CardEvent | null;
     /** Attach AskUserQuestion answers to the matching ToolCallCard. */
     setToolAnswers(toolUseId: string, answers: Record<string, string>): CardEvent | null;
-    subagentStart(description: string, agentId: string, toolUseId?: string): CardEvent;
+    /** Stash Agent tool_use input fields for later use when task_started arrives. */
+    stashAgentToolUseInput(toolUseId: string, input: {
+        prompt?: string;
+        subagentType?: string;
+        requestedModel?: string;
+    }): void;
+    subagentStart(description: string, agentId: string, toolUseId?: string, extras?: {
+        prompt?: string;
+        subagentType?: string;
+        requestedModel?: string;
+    }): CardEvent;
     subagentProgress(agentId: string, toolUseId: string | undefined, toolUseCount?: number, lastToolName?: string): CardEvent | null;
     subagentEnd(agentId: string, toolUseId: string | undefined, status: 'completed' | 'failed' | 'stopped', summary?: string): CardEvent | null;
     systemMessage(text: string, subtype?: 'compacted' | 'cost' | 'error' | 'info' | 'warning'): CardEvent;
+    /** Live structured `turn_duration` card — mirrors the history builder so a
+     *  reload renders identically. */
+    turnDuration(raw: {
+        durationMs?: unknown;
+        messageCount?: unknown;
+    }): CardEvent;
+    /** Live structured `stop_hook_summary` card — see history builder counterpart. */
+    stopHookSummary(raw: {
+        hookInfos?: unknown;
+        hookErrors?: unknown;
+        level?: unknown;
+        preventedContinuation?: unknown;
+        stopReason?: unknown;
+    }): CardEvent;
+    generatedImage(prompt: string, status: GeneratedImageCard['status'], savedPath?: string): CardEvent;
     recoverySuggested(reason: string, action: 'compact', label: string): CardEvent;
     errorMessage(text: string): CardEvent;
 }

package/dist/ai/cardBuilder.d.ts.map

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

package/dist/ai/cardBuilder.js

@@ -46,6 +46,22 @@ const TOOL_RESULT_TRUNCATE_LENGTH = 500;
 function cardHistoryPath(sessionId) {
     return join(getCardHistoryDir(), `${sessionId}.json`);
 }
+function cleanPersistedCard(card) {
+    const { pendingInput, ...rest } = card;
+    void pendingInput;
+    if (rest.type === 'assistant_text') {
+        return { ...rest, streaming: false };
+    }
+    return rest;
+}
+function mergeCardsById(existing, incoming) {
+    const byId = new Map();
+    for (const card of existing)
+        byId.set(card.id, card);
+    for (const card of incoming)
+        byId.set(card.id, card);
+    return Array.from(byId.values());
+}
 /**
  * Load persisted card history for a memory-mode session.
  * Returns cards in insertion order, or empty array if none exist.
@@ -64,13 +80,13 @@ export async function loadPersistedCards(sessionId) {
     }
 }
 // ── Direct JSONL file reading (replaces SDK getSessionMessages/listSubagents) ──
-function encodeCwdPath(cwd) {
+export function encodeCwdPath(cwd) {
     return cwd.replace(/\//g, '-');
 }
-function claudeProjectDir(cwd) {
+export function claudeProjectDir(cwd) {
     return join(homedir(), '.claude', 'projects', encodeCwdPath(cwd));
 }
-function jsonlPath(sessionId, cwd) {
+export function jsonlPath(sessionId, cwd) {
     return join(claudeProjectDir(cwd), sessionId + '.jsonl');
 }
 function parseJSONLContent(content) {
@@ -220,6 +236,58 @@ function extractToolResultText(content) {
     }
     return JSON.stringify(content);
 }
+/** Compact "1m 25s" / "45s" duration for the `text` fallback. The PWA renders
+ *  its own badge from `meta.durationMs`; this keeps debug logs and non-PWA
+ *  consumers readable. */
+export function formatDurationMs(ms) {
+    if (!Number.isFinite(ms) || ms < 0)
+        return '0s';
+    const totalSec = Math.round(ms / 1000);
+    const m = Math.floor(totalSec / 60);
+    const s = totalSec % 60;
+    return m > 0 ? `${m}m ${s}s` : `${s}s`;
+}
+/** Build a structured `turn_duration` system card from a Claude JSONL entry. */
+export function turnDurationCard(msg, id) {
+    const durationMs = typeof msg.durationMs === 'number' ? msg.durationMs : 0;
+    const messageCount = typeof msg.messageCount === 'number' ? msg.messageCount : 0;
+    return {
+        type: 'system',
+        id,
+        timestamp: Date.now(),
+        text: `Turn: ${formatDurationMs(durationMs)} · ${messageCount} messages`,
+        subtype: 'info',
+        meta: { kind: 'turn_duration', durationMs, messageCount },
+    };
+}
+/** Build a structured `stop_hook_summary` system card from a Claude JSONL entry.
+ *  Flags as `warning` when any hook errored or blocked continuation — that's the
+ *  channel that surfaces hook misconfigs (e.g. a bad interpreter path). */
+export function stopHookSummaryCard(msg, id) {
+    const hooks = Array.isArray(msg.hookInfos)
+        ? msg.hookInfos.map((h) => ({
+            command: typeof h?.command === 'string' ? h.command : '',
+            durationMs: typeof h?.durationMs === 'number' ? h.durationMs : 0,
+        }))
+        : [];
+    const errors = Array.isArray(msg.hookErrors)
+        ? msg.hookErrors.filter((e) => typeof e === 'string')
+        : [];
+    const preventedContinuation = msg.preventedContinuation === true;
+    const level = typeof msg.level === 'string' ? msg.level : undefined;
+    const stopReason = typeof msg.stopReason === 'string' && msg.stopReason ? msg.stopReason : undefined;
+    const text = errors.length > 0
+        ? `Stop hook: ${hooks.length} ran, ${errors.length} error${errors.length > 1 ? 's' : ''}`
+        : `Stop hook: ${hooks.length} ran`;
+    return {
+        type: 'system',
+        id,
+        timestamp: Date.now(),
+        text,
+        subtype: errors.length > 0 || preventedContinuation ? 'warning' : 'info',
+        meta: { kind: 'stop_hook_summary', hooks, errors, level, preventedContinuation, stopReason },
+    };
+}
 // ============================================================================
 // StreamCardBuilder — streaming session, emits CardEvents
 // ============================================================================
@@ -234,6 +302,14 @@ export class StreamCardBuilder {
     agentIdToCardId = new Map();
     /** Cards created for subagent permissions — removed after resolution. */
     ephemeralCards = new Set();
+    /** Agent tool_use input stashed from assistant message, keyed by tool_use block.id.
+     *  Consumed when task_started arrives with the matching tool_use_id. */
+    agentToolUseStash = new Map();
+    /** Card ID of the currently running subagent; tool calls are nested here instead of
+     *  being emitted as top-level ToolCallCards. Cleared on task_notification. */
+    activeSubagentCardId = null;
+    /** Nested tool_use_id → subagentCardId — lets toolResult() route to the right card. */
+    nestedToolUseToSubagentCard = new Map();
     /** Current streaming assistant_text card (for append_text events) */
     currentTextCardId = null;
     /** JSONL file byte offset at the start of the current turn — history reads stop here. */
@@ -258,6 +334,9 @@ export class StreamCardBuilder {
         this.toolUseIdToCardId.clear();
         this.agentIdToCardId.clear();
         this.ephemeralCards.clear();
+        this.agentToolUseStash.clear();
+        this.activeSubagentCardId = null;
+        this.nestedToolUseToSubagentCard.clear();
         this.currentTextCardId = null;
     }
     /**
@@ -269,17 +348,20 @@ export class StreamCardBuilder {
         const cards = this.getCards();
         if (cards.length === 0)
             return;
-        // Strip transient fields before persisting
-        const cleaned = cards.map(c => {
-            const { pendingInput, ...rest } = c;
-            if (rest.type === 'assistant_text') {
-                return { ...rest, streaming: false };
-            }
-            return rest;
-        });
+        await this.persistCardBatch(cards);
+    }
+    /** Persist a single card immediately. Used when a memory-mode provider
+     * injects a user prompt into an already-running turn; the card must survive
+     * refresh before the turn's normal end-of-turn persist runs. */
+    async persistCard(card) {
+        await this.persistCardBatch([card]);
+    }
+    async persistCardBatch(cards) {
+        if (cards.length === 0)
+            return;
+        const cleaned = cards.map(cleanPersistedCard);
         const dir = getCardHistoryDir();
         const p = cardHistoryPath(this.sessionId);
-        // Append to existing history
         let existing = [];
         try {
             if (existsSync(p)) {
@@ -290,7 +372,7 @@ export class StreamCardBuilder {
             }
         }
         catch { /* start fresh */ }
-        const merged = [...existing, ...cleaned];
+        const merged = mergeCardsById(existing, cleaned);
         await mkdir(dir, { recursive: true });
         await writeFile(p, JSON.stringify(merged) + '\n');
     }
@@ -364,6 +446,9 @@ export class StreamCardBuilder {
         this.toolUseIdToCardId.clear();
         this.agentIdToCardId.clear();
         this.ephemeralCards.clear();
+        this.agentToolUseStash.clear();
+        this.activeSubagentCardId = null;
+        this.nestedToolUseToSubagentCard.clear();
         this.currentTextCardId = null;
     }
     /** Cancel any pending deferred clear. Called on hot resume so the queued clear
@@ -468,6 +553,15 @@ export class StreamCardBuilder {
      */
     toolUse(toolName, toolInput, toolUseId) {
         this.currentTextCardId = null;
+        // Route to active subagent: nest this tool call inside the SubagentCard
+        if (this.activeSubagentCardId) {
+            const subagentCard = this.cards.get(this.activeSubagentCardId);
+            if (subagentCard) {
+                const toolCalls = [...(subagentCard.toolCalls ?? []), { id: toolUseId, toolName, toolInput }];
+                this.nestedToolUseToSubagentCard.set(toolUseId, this.activeSubagentCardId);
+                return this.updateEvent(this.activeSubagentCardId, { toolCalls });
+            }
+        }
         // Check if card was pre-created from canUseTool
         const existingCardId = this.toolUseIdToCardId.get(toolUseId);
         if (existingCardId) {
@@ -551,6 +645,17 @@ export class StreamCardBuilder {
         return Array.from(this.cards.values());
     }
     toolResult(toolUseId, content, isError) {
+        // Route to active subagent's nested tool call
+        const subagentCardId = this.nestedToolUseToSubagentCard.get(toolUseId);
+        if (subagentCardId) {
+            const subagentCard = this.cards.get(subagentCardId);
+            if (!subagentCard?.toolCalls)
+                return null;
+            const truncated = content.length > TOOL_RESULT_TRUNCATE_LENGTH;
+            const resultContent = truncated ? content.slice(0, TOOL_RESULT_TRUNCATE_LENGTH) + ' [truncated]' : content;
+            const toolCalls = subagentCard.toolCalls.map(tc => tc.id === toolUseId ? { ...tc, result: { content: resultContent, isError } } : tc);
+            return this.updateEvent(subagentCardId, { toolCalls });
+        }
         const cardId = this.toolUseIdToCardId.get(toolUseId);
         if (!cardId)
             return null;
@@ -569,9 +674,19 @@ export class StreamCardBuilder {
             return null;
         return this.updateEvent(cardId, { answers });
     }
-    subagentStart(description, agentId, toolUseId) {
+    /** Stash Agent tool_use input fields for later use when task_started arrives. */
+    stashAgentToolUseInput(toolUseId, input) {
+        this.agentToolUseStash.set(toolUseId, input);
+    }
+    subagentStart(description, agentId, toolUseId, extras) {
         this.currentTextCardId = null;
         const id = this.nextId();
+        const stashed = toolUseId ? this.agentToolUseStash.get(toolUseId) : undefined;
+        if (toolUseId)
+            this.agentToolUseStash.delete(toolUseId);
+        const subagentType = stashed?.subagentType ?? extras?.subagentType;
+        const requestedModel = stashed?.requestedModel ?? extras?.requestedModel;
+        const prompt = extras?.prompt ?? stashed?.prompt;
         const card = {
             type: 'subagent', id, timestamp: Date.now(),
             description,
@@ -579,9 +694,12 @@ export class StreamCardBuilder {
             agentId,
             status: 'running',
             toolUseCount: 0,
+            ...(subagentType ? { subagentType } : {}),
+            ...(requestedModel ? { requestedModel } : {}),
+            ...(prompt ? { prompt } : {}),
         };
         this.agentIdToCardId.set(agentId, id);
-        // Position after the parent ToolCallCard if we have the toolUseId
+        this.activeSubagentCardId = id;
         const afterCardId = toolUseId ? this.toolUseIdToCardId.get(toolUseId) : undefined;
         return this.addEvent(card, afterCardId);
     }
@@ -602,12 +720,34 @@ export class StreamCardBuilder {
             ?? (toolUseId ? this.agentIdToCardId.get(toolUseId) : undefined);
         if (!cardId)
             return null;
+        if (cardId === this.activeSubagentCardId)
+            this.activeSubagentCardId = null;
         return this.updateEvent(cardId, { status, summary });
     }
     systemMessage(text, subtype) {
         const card = { type: 'system', id: this.nextId(), timestamp: Date.now(), text, subtype };
         return this.addEvent(card);
     }
+    /** Live structured `turn_duration` card — mirrors the history builder so a
+     *  reload renders identically. */
+    turnDuration(raw) {
+        return this.addEvent(turnDurationCard(raw, this.nextId()));
+    }
+    /** Live structured `stop_hook_summary` card — see history builder counterpart. */
+    stopHookSummary(raw) {
+        return this.addEvent(stopHookSummaryCard(raw, this.nextId()));
+    }
+    generatedImage(prompt, status, savedPath) {
+        const card = {
+            type: 'generated_image',
+            id: this.nextId(),
+            timestamp: Date.now(),
+            prompt,
+            status,
+            ...(savedPath ? { savedPath } : {}),
+        };
+        return this.addEvent(card);
+    }
     recoverySuggested(reason, action, label) {
         const card = {
             type: 'recovery_suggested',
@@ -623,6 +763,54 @@ export class StreamCardBuilder {
         return this.systemMessage(`Error: ${text}`, 'error');
     }
 }
+/** Read tool calls from a subagent's JSONL — used by buildCardsFromHistory to nest them. */
+async function readSubagentToolCalls(jsonlPath) {
+    try {
+        const content = await readFile(jsonlPath, 'utf-8');
+        const messages = parseJSONLContent(content);
+        const resultMap = new Map();
+        const toolCalls = [];
+        for (const msg of messages) {
+            const rawMsg = msg.message;
+            if (!Array.isArray(rawMsg?.content))
+                continue;
+            if (msg.type === 'user') {
+                for (const block of rawMsg.content) {
+                    if (block.type === 'tool_result' && block.tool_use_id) {
+                        const text = extractToolResultText(block.content);
+                        resultMap.set(block.tool_use_id, { content: text, isError: !!block.is_error });
+                    }
+                }
+            }
+            else if (msg.type === 'assistant') {
+                for (const block of rawMsg.content) {
+                    if (block.type === 'tool_use' && block.id && block.name !== 'Agent') {
+                        toolCalls.push({
+                            id: block.id,
+                            toolName: block.name,
+                            toolInput: typeof block.input === 'object' && block.input ? block.input : {},
+                        });
+                    }
+                }
+            }
+        }
+        // Attach results and apply truncation
+        for (const tc of toolCalls) {
+            const r = resultMap.get(tc.id);
+            if (r) {
+                const truncated = r.content.length > TOOL_RESULT_TRUNCATE_LENGTH;
+                tc.result = {
+                    content: truncated ? r.content.slice(0, TOOL_RESULT_TRUNCATE_LENGTH) + ' [truncated]' : r.content,
+                    isError: r.isError,
+                };
+            }
+        }
+        return toolCalls;
+    }
+    catch {
+        return [];
+    }
+}
 // ============================================================================
 // buildCardsFromHistory — convert JSONL history into Card[]
 // ============================================================================
@@ -682,7 +870,52 @@ export async function buildCardsFromHistory(sessionId, cwd, offset = 0, limit =
     // The Claude CLI stores this as `toolUseResult` at the message envelope
     // level, separate from the human-readable tool_result.content string.
     const askUserResults = new Map();
+    const taskStarts = new Map();
+    const taskProgress = new Map();
+    const taskEnds = new Map();
+    const taskKey = (agentId, toolUseId) => {
+        if (typeof toolUseId === 'string' && toolUseId.length > 0)
+            return toolUseId;
+        if (typeof agentId === 'string' && agentId.length > 0)
+            return agentId;
+        return null;
+    };
     for (const msg of allMessages) {
+        if (msg.type === 'system') {
+            const subtype = msg.subtype;
+            const key = taskKey(msg.task_id, msg.tool_use_id);
+            if (key && subtype === 'task_started') {
+                taskStarts.set(key, {
+                    description: typeof msg.description === 'string' ? msg.description : '',
+                    agentId: typeof msg.task_id === 'string' ? msg.task_id : key,
+                    toolUseId: typeof msg.tool_use_id === 'string' ? msg.tool_use_id : key,
+                    prompt: typeof msg.prompt === 'string' ? msg.prompt : undefined,
+                    subagentType: typeof msg.subagent_type === 'string'
+                        ? msg.subagent_type
+                        : typeof msg.subagentType === 'string'
+                            ? msg.subagentType
+                            : undefined,
+                    requestedModel: typeof msg.model === 'string'
+                        ? msg.model
+                        : typeof msg.requested_model === 'string'
+                            ? msg.requested_model
+                            : undefined,
+                });
+            }
+            else if (key && subtype === 'task_progress') {
+                taskProgress.set(key, {
+                    toolUseCount: typeof msg.usage?.tool_uses === 'number' ? msg.usage.tool_uses : undefined,
+                    lastToolName: typeof msg.last_tool_name === 'string' ? msg.last_tool_name : undefined,
+                });
+            }
+            else if (key && subtype === 'task_notification') {
+                const status = msg.status;
+                taskEnds.set(key, {
+                    status: status === 'failed' || status === 'stopped' ? status : 'completed',
+                    summary: typeof msg.summary === 'string' ? msg.summary : undefined,
+                });
+            }
+        }
         const rawMsg = msg.message;
         const toolUseResult = msg.toolUseResult;
         if (!Array.isArray(rawMsg?.content))
@@ -707,24 +940,32 @@ export async function buildCardsFromHistory(sessionId, cwd, offset = 0, limit =
     // System messages (task_started) are NOT reliably present in the JSONL.
     // Instead, read subagent meta.json files and match by description to the
     // Agent tool_use input.description.
-    // Build description → toolUseId map from Agent tool_use blocks
+    // Build description → toolUseId map and capture Agent tool_use input data
     const descToToolUseId = new Map();
+    const agentInputByToolUseId = new Map();
     for (const msg of allMessages) {
         const rawMsg = msg.message;
         if (!Array.isArray(rawMsg?.content))
             continue;
         for (const block of rawMsg.content) {
             if (block.type === 'tool_use' && block.name === 'Agent' && block.id) {
-                const desc = block.input?.description ?? '';
+                const input = block.input;
+                const desc = input?.description ?? '';
                 if (desc)
                     descToToolUseId.set(desc, block.id);
+                agentInputByToolUseId.set(block.id, {
+                    prompt: typeof input?.prompt === 'string' ? input.prompt : undefined,
+                    subagentType: typeof input?.subagent_type === 'string' ? input.subagent_type : undefined,
+                    requestedModel: typeof input?.model === 'string' ? input.model : undefined,
+                });
             }
         }
     }
+    const subagentsDir = join(claudeProjectDir(cwd), sessionId, 'subagents');
     const toolUseIdToAgentId = new Map();
+    const subagentToolCallsByToolUseId = new Map();
     try {
         const agentIds = await listSubagentIdsFromDisk(sessionId, cwd);
-        const subagentsDir = join(claudeProjectDir(cwd), sessionId, 'subagents');
         for (const agentId of agentIds) {
             try {
                 const meta = JSON.parse(await readFile(join(subagentsDir, `${agentId}.meta.json`), 'utf-8'));
@@ -740,6 +981,12 @@ export async function buildCardsFromHistory(sessionId, cwd, offset = 0, limit =
                 toolUseIdToAgentId.set(toolUseId, toolUseId);
             }
         }
+        // Read each subagent's JSONL to extract nested tool calls
+        for (const [toolUseId, agentId] of toolUseIdToAgentId) {
+            const toolCalls = await readSubagentToolCalls(join(subagentsDir, `${agentId}.jsonl`));
+            if (toolCalls.length > 0)
+                subagentToolCallsByToolUseId.set(toolUseId, toolCalls);
+        }
     }
     catch {
         // No subagents or SDK error — fallback: agentId = toolUseId
@@ -765,12 +1012,54 @@ export async function buildCardsFromHistory(sessionId, cwd, offset = 0, limit =
     let seq = Math.max(0, total - offset - limit);
     const nextId = () => `${sessionId}:h:${++seq}`;
     const cards = [];
+    const emittedSubagentKeys = new Set();
+    const slicedAgentToolUseIds = new Set();
+    for (const msg of sliced) {
+        const rawMsg = msg.message;
+        if (!Array.isArray(rawMsg?.content))
+            continue;
+        for (const block of rawMsg.content) {
+            if (block.type === 'tool_use' && block.name === 'Agent' && block.id) {
+                slicedAgentToolUseIds.add(block.id);
+            }
+        }
+    }
+    const subagentCardFromTask = (task) => {
+        const key = task.toolUseId || task.agentId;
+        const end = taskEnds.get(key);
+        const progress = taskProgress.get(key);
+        return {
+            type: 'subagent',
+            id: nextId(),
+            timestamp: Date.now(),
+            description: task.description,
+            toolUseId: task.toolUseId,
+            agentId: task.agentId,
+            status: end?.status ?? 'running',
+            ...(end?.summary ? { summary: end.summary } : {}),
+            toolUseCount: progress?.toolUseCount ?? 0,
+            ...(progress?.lastToolName ? { lastToolName: progress.lastToolName } : {}),
+            ...(task.prompt ? { prompt: task.prompt } : {}),
+            ...(task.subagentType ? { subagentType: task.subagentType } : {}),
+            ...(task.requestedModel ? { requestedModel: task.requestedModel } : {}),
+        };
+    };
     for (const msg of sliced) {
         // ── System messages ──
         if (msg.type === 'system') {
             const subtype = msg.subtype;
-            // Skip subagent lifecycle events (handled via subagentCards below)
-            if (subtype === 'task_started' || subtype === 'task_progress' || subtype === 'task_notification')
+            const key = taskKey(msg.task_id, msg.tool_use_id);
+            if (subtype === 'task_started' && key) {
+                const task = taskStarts.get(key);
+                if (task && !slicedAgentToolUseIds.has(task.toolUseId) && !emittedSubagentKeys.has(key)) {
+                    cards.push(subagentCardFromTask(task));
+                    emittedSubagentKeys.add(key);
+                }
+                continue;
+            }
+            // Progress/end task events update the task_started card; they do not
+            // render as standalone history cards.
+            if (subtype === 'task_progress' || subtype === 'task_notification')
                 continue;
             // Skip init and status messages (not useful in history)
             if (subtype === 'init' || subtype === 'status' || subtype === 'session_state_changed')
@@ -778,6 +1067,12 @@ export async function buildCardsFromHistory(sessionId, cwd, offset = 0, limit =
             if (subtype === 'compact_boundary') {
                 cards.push({ type: 'system', id: nextId(), timestamp: Date.now(), text: 'Context compacted', subtype: 'compacted' });
             }
+            else if (subtype === 'turn_duration') {
+                cards.push(turnDurationCard(msg, nextId()));
+            }
+            else if (subtype === 'stop_hook_summary') {
+                cards.push(stopHookSummaryCard(msg, nextId()));
+            }
             else {
                 // Unknown system subtype — show as info
                 cards.push({ type: 'system', id: nextId(), timestamp: Date.now(), text: subtype ?? 'System event', subtype: 'info' });
@@ -901,12 +1196,17 @@ export async function buildCardsFromHistory(sessionId, cwd, offset = 0, limit =
                         break;
                     case 'tool_use': {
                         if (agentToolUseIds.has(block.id)) {
-                            // Agent tool_use → create a ToolCallCard as anchor, then SubagentCard
+                            // Agent tool_use → SubagentCard
                             const agentId = toolUseIdToAgentId.get(block.id) ?? block.id;
                             const result = toolResults.get(block.id);
                             const description = block.input?.description ?? '';
                             const summary = result ? result.content.slice(0, 200) : undefined;
-                            // Insert SubagentCard
+                            const agentInput = agentInputByToolUseId.get(block.id);
+                            const taskStart = taskStarts.get(block.id);
+                            const progress = taskProgress.get(block.id);
+                            const end = taskEnds.get(block.id);
+                            const prompt = agentInput?.prompt ?? taskStart?.prompt;
+                            const nestedToolCalls = subagentToolCallsByToolUseId.get(block.id);
                             const subagentCard = {
                                 type: 'subagent',
                                 id: nextId(),
@@ -914,11 +1214,17 @@ export async function buildCardsFromHistory(sessionId, cwd, offset = 0, limit =
                                 description,
                                 toolUseId: block.id,
                                 agentId,
-                                status: result ? 'completed' : 'running',
-                                summary,
-                                toolUseCount: 0,
+                                status: end?.status ?? (result ? 'completed' : 'running'),
+                                summary: end?.summary ?? summary,
+                                toolUseCount: progress?.toolUseCount ?? nestedToolCalls?.length ?? 0,
+                                ...(progress?.lastToolName ? { lastToolName: progress.lastToolName } : {}),
+                                ...(agentInput?.subagentType ? { subagentType: agentInput.subagentType } : {}),
+                                ...(agentInput?.requestedModel ? { requestedModel: agentInput.requestedModel } : {}),
+                                ...(prompt ? { prompt } : {}),
+                                ...(nestedToolCalls?.length ? { toolCalls: nestedToolCalls } : {}),
                             };
                             cards.push(subagentCard);
+                            emittedSubagentKeys.add(block.id);
                         }
                         else {
                             // Normal tool call