@agentdeck/shared 0.2.0 → 0.2.3

package/dist/timeline-markdown.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Lightweight markdown parser for timeline detail panes.
+ *
+ * Output is a flat array of typed lines that each platform renders natively
+ * (SwiftUI / Compose). Pure data — no rendering. Mirrors the Apple parser at
+ * apple/AgentDeck/UI/Monitor/TimelineStripView.swift `TimelineMarkdownLine`
+ * and the Android port at
+ * android/.../ui/timeline/TimelineMarkdown.kt — keep the three in lockstep.
+ *
+ * Block grammar (line-oriented):
+ *   - ``` toggles a code fence; lines inside become `code` (verbatim, no inline parsing)
+ *   - empty / whitespace-only line → `blank`
+ *   - 1-6 leading hashes + space → `heading` (level 1-6; CommonMark ATX)
+ *   - `- ` or `* ` → `bullet`
+ *   - `<digits>.` or `<digits>)` followed by space → `numbered`
+ *   - `> ` → `quote`
+ *   - `|...|` (with optional `|---|` separator) → `table` block
+ *   - anything else → `text`
+ *
+ * Inline grammar (per `parseInlineSpans`, applied at render time to non-code
+ * line content + table cells; first-match-wins, no recursion):
+ *   - `` `code` `` → `code` span
+ *   - `**bold**`   → `bold` span
+ *   - `*italic*`   → `italic` span (only when not adjacent to another `*`)
+ *   - `[text](href)` → `link` span
+ *   - everything else → `plain` span
+ */
+export type MarkdownLine = {
+    kind: 'blank';
+} | {
+    kind: 'heading';
+    level: 1 | 2 | 3 | 4 | 5 | 6;
+    content: string;
+} | {
+    kind: 'bullet';
+    content: string;
+} | {
+    kind: 'numbered';
+    marker: string;
+    content: string;
+} | {
+    kind: 'quote';
+    content: string;
+} | {
+    kind: 'code';
+    content: string;
+} | {
+    kind: 'text';
+    content: string;
+} | {
+    kind: 'table';
+    rows: string[][];
+    hasHeader: boolean;
+};
+export type InlineSpan = {
+    kind: 'plain';
+    text: string;
+} | {
+    kind: 'bold';
+    text: string;
+} | {
+    kind: 'italic';
+    text: string;
+} | {
+    kind: 'code';
+    text: string;
+} | {
+    kind: 'link';
+    text: string;
+    href: string;
+};
+export declare function parseTimelineMarkdown(text: string): MarkdownLine[];
+/**
+ * Tokenize a single line of inline content into spans. First-match-wins
+ * left-to-right walker; never recurses (so e.g. `**bold *with italic***` is
+ * just bold + plain — keeps the implementation simple and the platform ports
+ * trivial). Always returns at least one span; empty input → empty array.
+ */
+export declare function parseInlineSpans(text: string): InlineSpan[];
+//# sourceMappingURL=timeline-markdown.d.ts.map

package/dist/timeline-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-markdown.d.ts","sourceRoot":"","sources":["../src/timeline-markdown.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AAEH,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,OAAO,CAAA;CAAE,GACjB;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,KAAK,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACrD;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;IAAC,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC;AAE5D,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAChC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAAC;AAEjD,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,YAAY,EAAE,CAgFlE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,UAAU,EAAE,CA8E3D"}

package/dist/timeline-markdown.js

@@ -0,0 +1,221 @@
+/**
+ * Lightweight markdown parser for timeline detail panes.
+ *
+ * Output is a flat array of typed lines that each platform renders natively
+ * (SwiftUI / Compose). Pure data — no rendering. Mirrors the Apple parser at
+ * apple/AgentDeck/UI/Monitor/TimelineStripView.swift `TimelineMarkdownLine`
+ * and the Android port at
+ * android/.../ui/timeline/TimelineMarkdown.kt — keep the three in lockstep.
+ *
+ * Block grammar (line-oriented):
+ *   - ``` toggles a code fence; lines inside become `code` (verbatim, no inline parsing)
+ *   - empty / whitespace-only line → `blank`
+ *   - 1-6 leading hashes + space → `heading` (level 1-6; CommonMark ATX)
+ *   - `- ` or `* ` → `bullet`
+ *   - `<digits>.` or `<digits>)` followed by space → `numbered`
+ *   - `> ` → `quote`
+ *   - `|...|` (with optional `|---|` separator) → `table` block
+ *   - anything else → `text`
+ *
+ * Inline grammar (per `parseInlineSpans`, applied at render time to non-code
+ * line content + table cells; first-match-wins, no recursion):
+ *   - `` `code` `` → `code` span
+ *   - `**bold**`   → `bold` span
+ *   - `*italic*`   → `italic` span (only when not adjacent to another `*`)
+ *   - `[text](href)` → `link` span
+ *   - everything else → `plain` span
+ */
+export function parseTimelineMarkdown(text) {
+    if (!text)
+        return [];
+    const out = [];
+    let inCodeFence = false;
+    const lines = text.split(/\r?\n/);
+    let i = 0;
+    while (i < lines.length) {
+        const rawLine = lines[i];
+        const trimmed = rawLine.trim();
+        if (trimmed.startsWith('```')) {
+            inCodeFence = !inCodeFence;
+            i += 1;
+            continue;
+        }
+        if (inCodeFence) {
+            out.push({ kind: 'code', content: rawLine });
+            i += 1;
+            continue;
+        }
+        if (trimmed.length === 0) {
+            out.push({ kind: 'blank' });
+            i += 1;
+            continue;
+        }
+        // Table block: current line looks like `|...|`. Optional separator on
+        // next line marks the previous row as header. Continue collecting rows
+        // while subsequent lines are also table-rows.
+        if (isTableRow(trimmed)) {
+            const rows = [splitCells(trimmed)];
+            let hasHeader = false;
+            let j = i + 1;
+            if (j < lines.length && isTableSeparator(lines[j].trim())) {
+                hasHeader = true;
+                j += 1;
+            }
+            while (j < lines.length) {
+                const nextTrimmed = lines[j].trim();
+                if (!isTableRow(nextTrimmed) || isTableSeparator(nextTrimmed))
+                    break;
+                rows.push(splitCells(nextTrimmed));
+                j += 1;
+            }
+            out.push({ kind: 'table', rows, hasHeader });
+            i = j;
+            continue;
+        }
+        const heading = parseHeading(trimmed);
+        if (heading) {
+            out.push({ kind: 'heading', level: heading.level, content: heading.content });
+            i += 1;
+            continue;
+        }
+        if (trimmed.startsWith('- ') || trimmed.startsWith('* ')) {
+            out.push({ kind: 'bullet', content: trimmed.slice(2) });
+            i += 1;
+            continue;
+        }
+        const numbered = parseNumbered(trimmed);
+        if (numbered) {
+            out.push({ kind: 'numbered', marker: numbered.marker, content: numbered.content });
+            i += 1;
+            continue;
+        }
+        if (trimmed.startsWith('> ')) {
+            out.push({ kind: 'quote', content: trimmed.slice(2) });
+            i += 1;
+            continue;
+        }
+        out.push({ kind: 'text', content: rawLine });
+        i += 1;
+    }
+    return out.length === 0 ? [{ kind: 'text', content: text }] : out;
+}
+/**
+ * Tokenize a single line of inline content into spans. First-match-wins
+ * left-to-right walker; never recurses (so e.g. `**bold *with italic***` is
+ * just bold + plain — keeps the implementation simple and the platform ports
+ * trivial). Always returns at least one span; empty input → empty array.
+ */
+export function parseInlineSpans(text) {
+    if (!text)
+        return [];
+    const out = [];
+    let pending = ''; // buffered plain text waiting to flush
+    const flushPlain = () => {
+        if (pending.length > 0) {
+            out.push({ kind: 'plain', text: pending });
+            pending = '';
+        }
+    };
+    let i = 0;
+    while (i < text.length) {
+        const ch = text[i];
+        // `code`
+        if (ch === '`') {
+            const close = text.indexOf('`', i + 1);
+            if (close > i) {
+                flushPlain();
+                out.push({ kind: 'code', text: text.slice(i + 1, close) });
+                i = close + 1;
+                continue;
+            }
+        }
+        // **bold**
+        if (ch === '*' && text[i + 1] === '*') {
+            const close = text.indexOf('**', i + 2);
+            if (close > i + 1) {
+                flushPlain();
+                out.push({ kind: 'bold', text: text.slice(i + 2, close) });
+                i = close + 2;
+                continue;
+            }
+        }
+        // *italic* — single `*`, not surrounded by another `*`
+        if (ch === '*' &&
+            text[i + 1] !== '*' &&
+            (i === 0 || text[i - 1] !== '*')) {
+            // Find a closing single `*` that isn't doubled.
+            let j = i + 1;
+            while (j < text.length) {
+                if (text[j] === '*' && text[j + 1] !== '*' && text[j - 1] !== '*')
+                    break;
+                j += 1;
+            }
+            if (j < text.length && j > i + 1) {
+                flushPlain();
+                out.push({ kind: 'italic', text: text.slice(i + 1, j) });
+                i = j + 1;
+                continue;
+            }
+        }
+        // [text](href)
+        if (ch === '[') {
+            const closeBracket = text.indexOf(']', i + 1);
+            if (closeBracket > i && text[closeBracket + 1] === '(') {
+                const closeParen = text.indexOf(')', closeBracket + 2);
+                if (closeParen > closeBracket + 1) {
+                    const linkText = text.slice(i + 1, closeBracket);
+                    const href = text.slice(closeBracket + 2, closeParen);
+                    flushPlain();
+                    out.push({ kind: 'link', text: linkText, href });
+                    i = closeParen + 1;
+                    continue;
+                }
+            }
+        }
+        pending += ch;
+        i += 1;
+    }
+    flushPlain();
+    return out.length === 0 ? [{ kind: 'plain', text }] : out;
+}
+function parseHeading(trimmed) {
+    let level = 0;
+    for (const ch of trimmed) {
+        if (ch === '#')
+            level += 1;
+        else
+            break;
+    }
+    if (level < 1 || level > 6)
+        return null;
+    if (trimmed.charAt(level) !== ' ')
+        return null;
+    return { level: level, content: trimmed.slice(level + 1) };
+}
+function parseNumbered(trimmed) {
+    const m = trimmed.match(/^(\d+)([.)])\s+(.*)$/);
+    if (!m)
+        return null;
+    return { marker: `${m[1]}${m[2]}`, content: m[3] };
+}
+// ---- Table helpers ----
+const TABLE_ROW_RE = /^\s*\|.+\|\s*$/;
+const TABLE_SEPARATOR_RE = /^\s*\|[-:\s|]+\|\s*$/;
+function isTableRow(trimmed) {
+    return TABLE_ROW_RE.test(trimmed) && !isTableSeparator(trimmed);
+}
+function isTableSeparator(trimmed) {
+    if (!TABLE_SEPARATOR_RE.test(trimmed))
+        return false;
+    // Must contain at least one dash to be a real separator (not just `| | |`).
+    return /-/.test(trimmed);
+}
+function splitCells(rowLine) {
+    return rowLine
+        .trim()
+        .replace(/^\|/, '')
+        .replace(/\|$/, '')
+        .split('|')
+        .map((c) => c.trim());
+}
+//# sourceMappingURL=timeline-markdown.js.map

package/dist/timeline-markdown.js.map

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

package/dist/timeline-summarizer.d.ts

@@ -6,8 +6,32 @@ export declare const SUMMARY_SYSTEM_PROMPT = "You are a timeline summarizer. Giv
 /**
  * Extract a topic hint from the first few tokens of a response.
  * Used for immediate chat_start enrichment before LLM summarization.
+ *
+ * Korean handling: politeness-only responses ("네, 확인했습니다.") used to be
+ * stripped to empty and return null, leaving the timeline showing bare
+ * "Completed". Now the strip falls back to the pre-strip candidate so the
+ * row shows something meaningful.
  */
 export declare function extractTopicHint(text: string): string | null;
+export type TopicHintKind = 'topic' | 'fallback' | null;
+/**
+ * Same as `extractTopicHint` but tells the caller whether the result was a
+ * substantive topic (kind='topic') or just a politeness-fallback /
+ * first-sentence fallback (kind='fallback'). Lets emitters set
+ * `summaryKind: 'heuristic'` only when there's real content, vs `'none'`
+ * when we're scraping the bottom of the barrel.
+ */
+export declare function extractTopicHintWithKind(text: string): {
+    hint: string | null;
+    kind: TopicHintKind;
+};
+/**
+ * Last-resort fallback when the response yielded no usable hint and the
+ * caller has the prompt text — produce a snippet of the prompt instead of
+ * literal "Completed". Returns the first sentence (up to `maxLen` chars,
+ * ending at `.` `!` `?` or newline) or null when prompt is too short.
+ */
+export declare function promptSnippetFallback(prompt: string | null | undefined, maxLen?: number): string | null;
 /** Clean LLM output — strip thinking, quotes, markdown artifacts */
 export declare function cleanLLMOutput(content: string): string | null;
 //# sourceMappingURL=timeline-summarizer.d.ts.map

package/dist/timeline-summarizer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timeline-summarizer.d.ts","sourceRoot":"","sources":["../src/timeline-summarizer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,eAAO,MAAM,qBAAqB,wqBAIT,CAAC;AAE1B;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA2C5D;AAED,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA4B7D"}
+{"version":3,"file":"timeline-summarizer.d.ts","sourceRoot":"","sources":["../src/timeline-summarizer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,eAAO,MAAM,qBAAqB,wqBAIT,CAAC;AAE1B;;;;;;;;GAQG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE5D;AAED,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG,UAAU,GAAG,IAAI,CAAC;AAExD;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,GACX;IAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,aAAa,CAAA;CAAE,CAiD9C;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,MAAM,SAAK,GAAG,MAAM,GAAG,IAAI,CAWnG;AAED,oEAAoE;AACpE,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA4B7D"}

package/dist/timeline-summarizer.js

@@ -11,26 +11,38 @@ export const SUMMARY_SYSTEM_PROMPT = `You are a timeline summarizer. Given an AI
 /**
  * Extract a topic hint from the first few tokens of a response.
  * Used for immediate chat_start enrichment before LLM summarization.
+ *
+ * Korean handling: politeness-only responses ("네, 확인했습니다.") used to be
+ * stripped to empty and return null, leaving the timeline showing bare
+ * "Completed". Now the strip falls back to the pre-strip candidate so the
+ * row shows something meaningful.
  */
 export function extractTopicHint(text) {
+    return extractTopicHintWithKind(text).hint;
+}
+/**
+ * Same as `extractTopicHint` but tells the caller whether the result was a
+ * substantive topic (kind='topic') or just a politeness-fallback /
+ * first-sentence fallback (kind='fallback'). Lets emitters set
+ * `summaryKind: 'heuristic'` only when there's real content, vs `'none'`
+ * when we're scraping the bottom of the barrel.
+ */
+export function extractTopicHintWithKind(text) {
     if (!text || text.length < 5)
-        return null;
-    const lines = text.split('\n').map(l => l.trim()).filter(Boolean);
+        return { hint: null, kind: null };
+    const lines = text.split('\n').map((l) => l.trim()).filter(Boolean);
     // Find first non-markdown, non-code-fence, non-empty line
     let candidate = null;
     let inCodeFence = false;
     for (const line of lines) {
-        // Track code fence boundaries
         if (/^```/.test(line)) {
             inCodeFence = !inCodeFence;
             continue;
         }
         if (inCodeFence)
             continue;
-        // Skip headings-only
         if (/^#{1,6}\s*$/.test(line))
             continue;
-        // Strip markdown decorators for evaluation
         const stripped = cleanRawText(line)
             .replace(/^[-*]\s+/, '')
             .replace(/^>\s+/, '')
@@ -41,15 +53,45 @@ export function extractTopicHint(text) {
         }
     }
     if (!candidate)
-        return null;
+        return { hint: null, kind: null };
     const snippet = candidate.length > 80 ? candidate.slice(0, 77) + '...' : candidate;
-    // Remove common Korean prefixes (chained — "네, 확인했습니다." → "")
-    let cleaned = snippet;
-    // Strip leading "네," / "네." first, then polite phrases
-    cleaned = cleaned.replace(/^네[,.]?\s*/i, '');
-    cleaned = cleaned.replace(/^(완료했습니다\.\s*|알겠습니다\.\s*|확인했습니다\.\s*)/i, '');
-    cleaned = cleaned.trim();
-    return cleaned || null;
+    // Try stripping leading Korean polite closers — "네, …" / "확인했습니다."
+    let cleaned = snippet
+        .replace(/^네[,.]?\s*/i, '')
+        .replace(/^(완료했습니다\.\s*|알겠습니다\.\s*|확인했습니다\.\s*)/i, '')
+        .trim();
+    if (cleaned.length >= 3) {
+        return { hint: cleaned, kind: 'topic' };
+    }
+    // Strip left only the EXTRA content beside the polite closer. If polite
+    // closer was the entire candidate, fall back to the candidate itself —
+    // "네, 확인했습니다." beats showing just "Completed".
+    if (snippet.length >= 3) {
+        return { hint: snippet, kind: 'fallback' };
+    }
+    return { hint: null, kind: null };
+}
+/**
+ * Last-resort fallback when the response yielded no usable hint and the
+ * caller has the prompt text — produce a snippet of the prompt instead of
+ * literal "Completed". Returns the first sentence (up to `maxLen` chars,
+ * ending at `.` `!` `?` or newline) or null when prompt is too short.
+ */
+export function promptSnippetFallback(prompt, maxLen = 60) {
+    if (!prompt)
+        return null;
+    const trimmed = prompt.trim();
+    if (trimmed.length < 3)
+        return null;
+    // Cut at the first sentence terminator, otherwise at a hard line break.
+    const stop = trimmed.search(/[.!?。、]|\n/);
+    let snippet = stop > 0 ? trimmed.slice(0, stop) : trimmed;
+    snippet = snippet.trim();
+    if (snippet.length === 0)
+        snippet = trimmed;
+    if (snippet.length > maxLen)
+        snippet = snippet.slice(0, maxLen - 1).trim() + '…';
+    return snippet;
 }
 /** Clean LLM output — strip thinking, quotes, markdown artifacts */
 export function cleanLLMOutput(content) {

package/dist/timeline-summarizer.js.map

@@ -1 +1 @@
-{"version":3,"file":"timeline-summarizer.js","sourceRoot":"","sources":["../src/timeline-summarizer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;yBAIZ,CAAC;AAE1B;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC3C,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAE1C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IAElE,0DAA0D;IAC1D,IAAI,SAAS,GAAkB,IAAI,CAAC;IACpC,IAAI,WAAW,GAAG,KAAK,CAAC;IACxB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,8BAA8B;QAC9B,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;YACtB,WAAW,GAAG,CAAC,WAAW,CAAC;YAC3B,SAAS;QACX,CAAC;QACD,IAAI,WAAW;YAAE,SAAS;QAE1B,qBAAqB;QACrB,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS;QAEvC,2CAA2C;QAC3C,MAAM,QAAQ,GAAG,YAAY,CAAC,IAAI,CAAC;aAChC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;aACvB,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;aACpB,IAAI,EAAE,CAAC;QAEV,IAAI,QAAQ,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;YACzB,SAAS,GAAG,QAAQ,CAAC;YACrB,MAAM;QACR,CAAC;IACH,CAAC;IAED,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAE5B,MAAM,OAAO,GAAG,SAAS,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;IAEnF,8DAA8D;IAC9D,IAAI,OAAO,GAAG,OAAO,CAAC;IACtB,uDAAuD;IACvD,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,aAAa,EAAE,EAAE,CAAC,CAAC;IAC7C,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,wCAAwC,EAAE,EAAE,CAAC,CAAC;IACxE,OAAO,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAEzB,OAAO,OAAO,IAAI,IAAI,CAAC;AACzB,CAAC;AAED,oEAAoE;AACpE,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,IAAI,OAAO,GAAG,OAAO;QACnB,uDAAuD;SACtD,OAAO,CAAC,2BAA2B,EAAE,EAAE,CAAC;QACzC,mDAAmD;SAClD,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC;SAC/B,IAAI,EAAE,CAAC;IAEV,6DAA6D;IAC7D,oDAAoD;IACpD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACrE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,4EAA4E;QAC5E,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACxE,OAAO,GAAG,UAAU,IAAI,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAClD,CAAC;IAED,kDAAkD;IAClD,OAAO,GAAG,OAAO;SACd,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC;SACvB,OAAO,CAAC,kEAAkE,EAAE,EAAE,CAAC;SAC/E,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC,yBAAyB;SACnD,IAAI,EAAE,CAAC;IAEV,IAAI,CAAC,OAAO,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAChD,iCAAiC;IACjC,IAAI,OAAO,CAAC,MAAM,GAAG,EAAE;QAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC;IAChE,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"timeline-summarizer.js","sourceRoot":"","sources":["../src/timeline-summarizer.ts"],"names":[],"mappings":"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"}

package/dist/timeline.d.ts

@@ -2,7 +2,9 @@
  * Shared timeline types and log parser for OpenClaw mode.
  * Used by both bridge (BridgeLogStream) and plugin (LogStream).
  */
-export type TimelineEntryType = 'tool_request' | 'tool_resolved' | 'chat_start' | 'chat_end' | 'chat_response' | 'error' | 'scheduled' | 'user_action' | 'model_call' | 'model_response' | 'memory_recall' | 'tool_exec' | 'eval_result';
+export type TimelineEntryType = 'tool_request' | 'tool_resolved' | 'chat_start' | 'chat_end' | 'chat_response' | 'error' | 'scheduled' | 'user_action' | 'model_call' | 'model_response' | 'memory_recall' | 'tool_exec' | 'eval_result' | 'task_start' | 'task_end' | 'task_milestone';
+import type { TaskBoundarySignal } from './eval-schema.js';
+export type { TaskBoundarySignal } from './eval-schema.js';
 export interface TimelineEntry {
     ts: number;
     type: TimelineEntryType;
@@ -11,12 +13,71 @@ export interface TimelineEntry {
     approvalId?: string;
     status?: 'pending' | 'approved' | 'denied';
     agentType?: string;
+    projectName?: string;
+    sessionId?: string;
+    runId?: string;
+    startedAt?: number;
+    endedAt?: number;
     repeatCount?: number;
     automated?: boolean;
+    /** APME task id. Set on task_start/task_end and on every turn entry inside the task scope. */
+    taskId?: string;
+    /** Only on task_end. Why the task closed. */
+    boundarySignal?: TaskBoundarySignal;
+    /**
+     * Per-task evaluation result, attached when the task_judge resolves
+     * (always AFTER the initial task_end emit — clients upsert the existing
+     * row by (type='task_end', taskId) and merge these four fields).
+     *
+     *   - `taskScore`   : 0..1 composite (matches `tasks.composite_score`)
+     *   - `taskOutcome` : terminal outcome string from `bridge/src/apme/outcome.ts`
+     *     (`'committed' | 'abandoned' | 'iterated' | 'ab_winner' | 'ab_loser'
+     *     | 'interrupted' | 'exploratory' | 'pending'`). UIs collapse into
+     *     three visual classes — success / fail / partial / pending — and pick
+     *     the badge color via design-system status tokens.
+     *   - `taskCategory`: task_rollup category ('general' | 'conversation' | …)
+     *   - `taskSummary` : one-line judge summary
+     */
+    taskScore?: number;
+    taskOutcome?: string;
+    taskCategory?: string;
+    taskSummary?: string;
+    /**
+     * How the row's `raw` summary was produced. Lets clients decide whether
+     * the detail pane is worth showing — when `'none'`, detail is just the
+     * unfiltered response that the heuristic couldn't summarize, and showing
+     * it duplicates content rather than adding value.
+     *   - `'llm'`     : LLM-summarized (clean, short, distinct from detail)
+     *   - `'heuristic'`: topic-hint extracted from response or prompt
+     *   - `'none'`    : last-resort fallback (literal "Completed", bare tool name, etc.)
+     *   - `'progress'`: non-terminal assistant status update (work still running)
+     */
+    summaryKind?: 'llm' | 'heuristic' | 'none' | 'progress';
 }
+/**
+ * Prepare a chat-response body for storage as `entry.detail` while keeping
+ * markdown intact. Use this on chat_response / chat_end emit paths so the
+ * client renderer can apply heading / bullet / table / inline span styles —
+ * `cleanDetailText` would have stripped all of that before it ever reached
+ * the dashboard.
+ *
+ * Filters and caps:
+ *   - System JSON blobs (`{"connectionId": ...}` etc.) → empty
+ *   - Error JSON (`{"error": ...}`) → the error string
+ *   - Other JSON object → compact stringified form (200 char cap)
+ *   - Otherwise → original text with 3+ blank lines collapsed to 2, trimmed
+ *
+ * Markdown markers (`**`, `##`, `|`, `` ` ``, `[text](url)`, etc.) are
+ * preserved verbatim so the client `parseTimelineMarkdown` /
+ * `parseInlineSpans` can do their job.
+ */
+export declare function prepareMarkdownDetail(text: string): string;
 /**
  * Clean detail text — strip markdown artifacts, JSON blobs, and system noise.
- * Applied to timeline entry `detail` fields before storage.
+ * Applied to timeline entry `detail` fields before storage on **non-chat**
+ * paths (tool errors, system log lines). Chat response detail should go
+ * through `prepareMarkdownDetail` instead so the dashboard can render the
+ * markdown.
  */
 export declare function cleanDetailText(text: string): string;
 /**
@@ -29,6 +90,15 @@ export declare function cleanRawText(text: string): string;
  * Applied to both raw and detail fields.
  */
 export declare function cleanNopMarkers(text: string): string;
+export declare function isAssistantProgressUpdate(text?: string): boolean;
+export declare function detailHasRealSignal(detail?: string): boolean;
+export declare function isOpenClawPlaceholderRaw(raw: string): boolean;
+export declare function isTaskNotificationChatStart(entry: TimelineEntry): boolean;
+export declare function isOpenClawLowSignalResponse(entry: TimelineEntry): boolean;
+export declare function isOpenClawCronPrompt(text?: string): boolean;
+export declare function summarizeOpenClawCronPrompt(text?: string): string;
+export declare function shouldDropLowSignalTimelineEntry(entry: TimelineEntry): boolean;
+export declare function normalizeTimelineEntryForStorage(entry: TimelineEntry): TimelineEntry | null;
 /**
  * Extract the semantic core of a timeline entry for dedup comparison.
  * For chat_end: strip duration/tool suffix (everything after first ' · ').

package/dist/timeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../src/timeline.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,iBAAiB,GACzB,cAAc,GAAG,eAAe,GAAG,YAAY,GAAG,UAAU,GAC5D,eAAe,GAAG,OAAO,GAAG,WAAW,GAAG,aAAa,GACvD,YAAY,GAAG,gBAAgB,GAAG,eAAe,GAAG,WAAW,GAC/D,aAAa,CAAC;AAElB,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,iBAAiB,CAAC;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,SAAS,GAAG,UAAU,GAAG,QAAQ,CAAC;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAuDD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CA8CpD;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CASjD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMpD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAMhF;AA2DD;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,aAAa,EACpB,aAAa,EAAE,SAAS,aAAa,EAAE,EACvC,QAAQ,SAAY,GACnB,MAAM,CA4BR;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,GAClB;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,oBAAoB,CAAC,EAAE,MAAM,CAAA;CAAE,GACjE;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,aAAa,CAAA;CAAE,CAAC;AAE5C,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,aAAa,EACpB,OAAO,EAAE,SAAS,aAAa,EAAE,GAChC,iBAAiB,CAgCnB;AAED,kFAAkF;AAClF,wBAAgB,YAAY,CAAC,IAAI,EAAE,OAAO,GAAG,aAAa,GAAG,IAAI,CA2MhE"}
+{"version":3,"file":"timeline.d.ts","sourceRoot":"","sources":["../src/timeline.ts"],"names":[],"mappings":"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"}