@agentdeck/shared 0.2.0 → 1.0.0

package/dist/timeline-label.d.ts

@@ -0,0 +1,38 @@
+import type { TimelineEntry } from './timeline.js';
+/** Canonical agent → display-name map. The ONLY place this mapping lives on
+ *  the TS side; language mirrors copy it verbatim. Never abbreviate
+ *  "OpenClaw" (see memory `brand-direction.md`). */
+export declare function agentDisplayLabel(agentType: string | undefined | null): string;
+/** Compact agent → display-name for very tight surfaces (LED matrix, ticker
+ *  when width is scarce). Keeps the brand distinct without the CLI/App suffix. */
+export declare function agentShortLabel(agentType: string | undefined | null): string;
+export interface TimelineRowAttribution {
+    /** Resolved agent display name, or undefined when no agent is attributed. */
+    agent?: string;
+    /** Project / worktree name. */
+    project?: string;
+    /** Task label — the APME task summary when present, else the task row's
+     *  own label; undefined for rows outside a task. */
+    task?: string;
+    /** The already-summarized row body (`entry.raw`). */
+    text: string;
+}
+/** Decompose a TimelineEntry into its attributed pieces. Every surface builds
+ *  its displayed row from this, so agent/project/task/text stay consistent. */
+export declare function timelineRowAttribution(entry: TimelineEntry): TimelineRowAttribution;
+export interface FormatTimelineRowOptions {
+    /** Which attribution parts to prepend before the text, in order. Defaults
+     *  to agent + project (the common glance form). */
+    parts?: Array<'agent' | 'project' | 'task'>;
+    /** Include the row body text after the attribution. Default true. */
+    includeText?: boolean;
+    /** Use the compact agent name (ticker/matrix). Default false. */
+    short?: boolean;
+    /** Separator between attribution parts. Default " · ". */
+    separator?: string;
+}
+/** Canonical joined label. Replaces the divergent "[project] Agent" vs
+ *  "project · tag" conventions with one separator (" · ") and an explicit,
+ *  caller-chosen part order. Example: "Claude · AgentDeck · Fix eink ticker". */
+export declare function formatTimelineRowLabel(entry: TimelineEntry, opts?: FormatTimelineRowOptions): string;
+//# sourceMappingURL=timeline-label.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"timeline-label.d.ts","sourceRoot":"","sources":["../src/timeline-label.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD;;oDAEoD;AACpD,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAkB9E;AAED;kFACkF;AAClF,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,MAAM,CAM5E;AAED,MAAM,WAAW,sBAAsB;IACrC,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;wDACoD;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;CACd;AAeD;+EAC+E;AAC/E,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,aAAa,GAAG,sBAAsB,CAWnF;AAED,MAAM,WAAW,wBAAwB;IACvC;uDACmD;IACnD,KAAK,CAAC,EAAE,KAAK,CAAC,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC,CAAC;IAC5C,qEAAqE;IACrE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,iEAAiE;IACjE,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,0DAA0D;IAC1D,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;iFAEiF;AACjF,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,aAAa,EACpB,IAAI,GAAE,wBAA6B,GAClC,MAAM,CAYR"}

package/dist/timeline-label.js

@@ -0,0 +1,95 @@
+// timeline-label.ts — the SINGLE source of truth for turning a TimelineEntry
+// into its attributed, human-readable row text ("agent · project · task ·
+// text").
+//
+// Before this file, shared/src exposed `agentBrandColor` but NO agent
+// display-name function, so every surface (Swift ×5, Kotlin ×2, ESP32 ×4,
+// plugin) hand-rolled the same `claude-code → "Claude"` map and its own
+// separator convention, and they drifted. The mirrors (Swift
+// `SessionFormatters.displayAgentLabel`, Kotlin `EinkFormatUtils`, C++
+// `agent_label.h`) must match `agentDisplayLabel` below exactly.
+//
+// Design: `timelineRowAttribution` returns the STRUCTURED pieces so a
+// space-constrained surface (ESP32 ticker, iPhone) can pick which fields to
+// show, while roomy surfaces render all four. `formatTimelineRowLabel` joins
+// them with the one canonical separator.
+/** Canonical agent → display-name map. The ONLY place this mapping lives on
+ *  the TS side; language mirrors copy it verbatim. Never abbreviate
+ *  "OpenClaw" (see memory `brand-direction.md`). */
+export function agentDisplayLabel(agentType) {
+    switch (agentType) {
+        case 'claude-code': return 'Claude';
+        case 'openclaw': return 'OpenClaw';
+        case 'codex-cli': return 'Codex CLI';
+        case 'codex-app': return 'Codex App';
+        case 'opencode': return 'OpenCode';
+        case 'antigravity': return 'Antigravity';
+        case 'monitor': return 'Monitor';
+        case 'daemon': return 'Daemon';
+        default:
+            if (!agentType)
+                return 'Agent';
+            // Unknown but non-empty: titlecase the slug so a new agent still reads
+            // sensibly instead of collapsing to a generic "Agent".
+            return agentType
+                .replace(/-/g, ' ')
+                .replace(/\b\w/g, (c) => c.toUpperCase());
+    }
+}
+/** Compact agent → display-name for very tight surfaces (LED matrix, ticker
+ *  when width is scarce). Keeps the brand distinct without the CLI/App suffix. */
+export function agentShortLabel(agentType) {
+    switch (agentType) {
+        case 'codex-cli':
+        case 'codex-app': return 'Codex';
+        default: return agentDisplayLabel(agentType);
+    }
+}
+/** The task pieces vary: a `task_start`/`task_end` row's own `raw` is the task
+ *  label ("Task 1"); a turn row inside a task carries `taskId` but no inline
+ *  label, so callers that want a task chip use `taskSummary` when the eval has
+ *  produced one. Returns the best available task descriptor. */
+function taskDescriptor(entry) {
+    const summary = entry.taskSummary?.trim();
+    if (summary)
+        return summary;
+    if (entry.type === 'task_start' || entry.type === 'task_end') {
+        return entry.raw?.trim() || undefined;
+    }
+    return undefined;
+}
+/** Decompose a TimelineEntry into its attributed pieces. Every surface builds
+ *  its displayed row from this, so agent/project/task/text stay consistent. */
+export function timelineRowAttribution(entry) {
+    const agent = entry.agentType ? agentDisplayLabel(entry.agentType) : undefined;
+    const project = entry.projectName?.trim() || undefined;
+    const task = taskDescriptor(entry);
+    const text = (entry.raw ?? '').trim();
+    return {
+        ...(agent ? { agent } : {}),
+        ...(project ? { project } : {}),
+        ...(task ? { task } : {}),
+        text,
+    };
+}
+/** Canonical joined label. Replaces the divergent "[project] Agent" vs
+ *  "project · tag" conventions with one separator (" · ") and an explicit,
+ *  caller-chosen part order. Example: "Claude · AgentDeck · Fix eink ticker". */
+export function formatTimelineRowLabel(entry, opts = {}) {
+    const { parts = ['agent', 'project'], includeText = true, short = false, separator = ' · ' } = opts;
+    const attr = timelineRowAttribution(entry);
+    const agentText = short ? agentShortLabel(entry.agentType) : attr.agent;
+    const pieces = [];
+    for (const p of parts) {
+        if (p === 'agent' && agentText)
+            pieces.push(agentText);
+        else if (p === 'project' && attr.project)
+            pieces.push(attr.project);
+        else if (p === 'task' && attr.task)
+            pieces.push(attr.task);
+    }
+    if (includeText && attr.text)
+        pieces.push(attr.text);
+    return pieces.join(separator);
+}
+//# sourceMappingURL=timeline-label.js.map

package/dist/timeline-label.js.map

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

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