studiograph 1.3.48-next.26 → 1.3.48-next.261

package/dist/agent/context-window.js

@@ -0,0 +1,459 @@
+/**
+ * Context-window management for the in-app chat agent.
+ *
+ * The agent accumulates conversation history in `agent.state.messages`. Large
+ * tool results (asset/image payloads from list_assets / read_asset /
+ * inspect_artifact, big document or dataset bodies) plus the running turn count
+ * make that array grow without bound. Once it exceeds the model's token ceiling
+ * the provider rejects the WHOLE request with a hard 400 ("prompt is too long:
+ * N tokens > M maximum"), killing the chat.
+ *
+ * This module is the PROACTIVE half of the fix: a pure, provider-agnostic
+ * pass that estimates tokens and, when a request would overflow, trims the
+ * transcript down to fit BEFORE it is sent. It is wired into the runtime via
+ * pi-agent-core's `transformContext` hook (orchestrator.ts), which runs once
+ * before every LLM call and non-destructively produces the message array sent
+ * to the provider — the persistent transcript (saved to disk / shown in the UI)
+ * is untouched.
+ *
+ * The DESTRUCTIVE half (agent-pool.ts `compactArtifactHistory`) is the privacy/
+ * baseline complement: after each turn it strips images and elides artifact
+ * bundles from the PERSISTED transcript, but deliberately keeps large text (so
+ * saved chats stay readable). It does not share this module's helpers — the two
+ * passes have different jobs (must-not-persist vs live token budget); see that
+ * method's own docstring for the split of labor.
+ *
+ * Nothing here does I/O or model calls — it is deterministic and unit-tested.
+ */
+// ── Tunables ────────────────────────────────────────────────────────────────
+/**
+ * Characters per token — deliberately the LOW end of the realistic range, which
+ * makes the whole module's safety invariant hold:
+ *
+ *   as long as real-chars-per-token ≥ CHARS_PER_TOKEN, our estimate is ≥ the
+ *   real token count, so clipping/trimming to a token budget guarantees the
+ *   real prompt stays under that budget (and thus under the model window).
+ *
+ * The two error directions are asymmetric: under-counting risks a hard provider
+ * 400 that kills the whole conversation (the exact failure this module prevents);
+ * over-counting only trims slightly earlier than strictly necessary. Measured
+ * density by content: English prose ~4, code ~3, and the token-dense JSON that
+ * actually overflows — `list_assets` rows full of UUIDs/URLs/filenames — ~2.4
+ * (observed live: 1.10M real tokens vs a 0.88M estimate at the old value of 3,
+ * a 25% under-count that 400'd a 1M-window request). 2.2 sits just below that
+ * worst realistic case, so dense tool results no longer slip the budget; only
+ * sub-2.2 content (heavy base64 text, which is rare since images are stripped as
+ * blocks) can, and the reactive `isContextOverflow` net (chat.ts) backstops it.
+ */
+const CHARS_PER_TOKEN = 2.2;
+/** Per-message structural overhead (role framing, delimiters) in tokens. */
+const PER_MESSAGE_OVERHEAD = 4;
+/** Rough token cost of an image content block. Image tokens are a function of
+ *  pixel dimensions, not byte size, but we only have the base64 string here, so
+ *  this is a deliberately rough heuristic with an 800-token floor (downscaled
+ *  inspect images ≤1024px land ~1.6k; large composer uploads more). Exactness
+ *  isn't required — images ride only in recent/pinned turns, and the budget
+ *  margin plus the reactive overflow net absorb the slack. */
+function estimateImageTokens(base64Len) {
+    return Math.max(800, Math.ceil(base64Len / 700));
+}
+/** A tool result is "large" once its content estimate crosses this. Tier-1
+ *  stubbing and the post-turn compaction both use it. ~2k tokens ≈ a screenful
+ *  of JSON — small results stay inline so the agent doesn't have to re-fetch. */
+export const LARGE_TOOL_RESULT_TOKENS = 2000;
+/** Turns at the tail that are never evicted or stubbed — the live working set
+ *  the agent needs to answer the current question. A "turn" is a user-message-
+ *  delimited group (see `groupIntoTurns`). */
+const PINNED_RECENT_TURNS = 3;
+/** Estimate tokens for one message's content (text + images + tool-call args). */
+export function estimateMessageTokens(msg) {
+    const m = msg;
+    if (!m || typeof m !== 'object')
+        return 0;
+    let chars = 0;
+    let tokens = PER_MESSAGE_OVERHEAD;
+    const addContent = (content) => {
+        if (typeof content === 'string') {
+            chars += content.length;
+            return;
+        }
+        if (!Array.isArray(content))
+            return;
+        for (const block of content) {
+            if (!block || typeof block !== 'object')
+                continue;
+            if (block.type === 'text' && typeof block.text === 'string')
+                chars += block.text.length;
+            else if (block.type === 'thinking' && typeof block.thinking === 'string')
+                chars += block.thinking.length;
+            else if (block.type === 'image' && typeof block.data === 'string')
+                tokens += estimateImageTokens(block.data.length);
+            else if (block.type === 'toolCall') {
+                // Assistant tool-call block: name + serialized arguments.
+                if (typeof block.name === 'string')
+                    chars += block.name.length;
+                try {
+                    chars += JSON.stringify(block.arguments ?? {}).length;
+                }
+                catch { /* unserializable — skip */ }
+            }
+        }
+    };
+    addContent(m.content);
+    return tokens + Math.ceil(chars / CHARS_PER_TOKEN);
+}
+/**
+ * Estimate the total prompt tokens for a transcript, optionally including the
+ * system prompt and tool schemas (both ride in every request).
+ */
+export function estimateTokens(messages, systemPrompt, tools) {
+    let total = 0;
+    for (const msg of messages)
+        total += estimateMessageTokens(msg);
+    if (systemPrompt)
+        total += Math.ceil(systemPrompt.length / CHARS_PER_TOKEN);
+    if (tools && tools.length) {
+        let schemaChars = 0;
+        for (const t of tools) {
+            schemaChars += (t.name?.length ?? 0) + (t.description?.length ?? 0);
+            try {
+                schemaChars += JSON.stringify(t.parameters ?? {}).length;
+            }
+            catch { /* skip */ }
+        }
+        total += Math.ceil(schemaChars / CHARS_PER_TOKEN);
+    }
+    return total;
+}
+// Note on accuracy: an earlier design self-calibrated the estimator against each
+// turn's real `usage.input`. That was removed deliberately — once the manager
+// starts trimming, the persisted transcript and the prompt actually sent diverge,
+// so the learned ratio biases downward exactly when trimming is active (less
+// trimming → overflow), and folding the fixed tool-schema cost into a
+// multiplicative factor double-counted it. The conservative fixed estimator
+// (`CHARS_PER_TOKEN`, see above) plus the `computeBudget` margin and the reactive
+// `isContextOverflow` backstop are simpler and fail safe.
+// ── Large-result detection + stubbing (used by manageContext's Tier 1) ─────
+/** True if a toolResult message's content is large enough to be worth eliding. */
+export function isLargeToolResult(msg) {
+    const m = msg;
+    if (!m || m.role !== 'toolResult' || !Array.isArray(m.content))
+        return false;
+    // Any image block makes it large (vision must never persist across turns).
+    if (m.content.some((b) => b?.type === 'image'))
+        return true;
+    return estimateMessageTokens(msg) >= LARGE_TOOL_RESULT_TOKENS;
+}
+/** The stub text that replaces an elided tool result. Names the tool so the
+ *  agent knows it can call it again to retrieve the content on demand. */
+export function toolResultStub(toolName) {
+    const name = toolName || 'a tool';
+    return `[A large ${name} result from an earlier step was removed to save context. ` +
+        `Call ${name} again if you need its current contents.]`;
+}
+/**
+ * Return a pairing-safe stubbed COPY of a toolResult message: content replaced
+ * with a one-line stub, `toolCallId`/`toolName`/`role` preserved (so the paired
+ * assistant tool-call still resolves and the provider doesn't 400), `details`
+ * dropped. Returns the original reference if it is not a large tool result.
+ */
+export function stubToolResult(msg) {
+    const m = msg;
+    if (!isLargeToolResult(msg))
+        return msg;
+    const copy = { ...m, content: [{ type: 'text', text: toolResultStub(m.toolName) }] };
+    delete copy.details;
+    return copy;
+}
+/** Compute the usable input-token budget for a model. */
+export function computeBudget(model) {
+    // Defensive: a freeform/custom model id resolves to `undefined` via pi-ai's
+    // getModel(); without this guard `model.contextWindow` throws, transformContext
+    // swallows it, and proactive trimming is silently disabled for the whole
+    // session. Treat an unknown model as a conservative 200k window.
+    const ctx = model?.contextWindow && model.contextWindow > 0 ? model.contextWindow : 200_000;
+    const reserveForOutput = Math.min(model?.maxTokens && model.maxTokens > 0 ? model.maxTokens : 8000, 64_000);
+    // 10% cushion (was 6%): absorbs estimator variance for content slightly denser
+    // than CHARS_PER_TOKEN, on top of the output reservation.
+    const safetyMargin = Math.max(Math.floor(ctx * 0.10), 8000);
+    return Math.max(ctx - reserveForOutput - safetyMargin, Math.floor(ctx * 0.25));
+}
+/**
+ * Group messages into user-delimited turns. A turn starts at a `user` message
+ * and runs up to (but not including) the next `user` message — so an assistant's
+ * tool-call blocks and the `toolResult` messages that answer them always live in
+ * the SAME turn. That invariant is what makes whole-turn eviction pairing-safe:
+ * dropping a turn never orphans a tool_use from its tool_result (the Anthropic
+ * 400). Any leading non-user messages (e.g. a loaded session) form turn 0.
+ */
+function groupIntoTurns(messages) {
+    const turns = [];
+    let current = [];
+    for (const msg of messages) {
+        if (msg?.role === 'user' && current.length > 0) {
+            turns.push(current);
+            current = [];
+        }
+        current.push(msg);
+    }
+    if (current.length > 0)
+        turns.push(current);
+    return turns;
+}
+/** Short topic snippet from a user message, for the rolling-summary stub. */
+function userTopic(msg) {
+    const m = msg;
+    if (m?.role !== 'user')
+        return null;
+    let text = '';
+    if (typeof m.content === 'string')
+        text = m.content;
+    else if (Array.isArray(m.content)) {
+        text = m.content.filter((b) => b?.type === 'text').map((b) => b.text).join(' ');
+    }
+    text = text.replace(/\s+/g, ' ').trim();
+    if (!text)
+        return null;
+    return text.length > 80 ? text.slice(0, 80) + '…' : text;
+}
+/** Rolling-summary text describing the evicted turns. Prepended to the first
+ *  KEPT user message (not emitted as its own message) so we never produce two
+ *  consecutive user messages — some providers enforce role alternation. */
+function buildSummaryText(evicted) {
+    const msgCount = evicted.reduce((n, t) => n + t.length, 0);
+    const topics = evicted
+        .flat()
+        .map(userTopic)
+        .filter((t) => !!t)
+        .slice(0, 8);
+    const topicLine = topics.length ? ` Earlier topics: ${topics.join('; ')}.` : '';
+    return `[${msgCount} earlier message(s) were removed to fit the model's context window.${topicLine} ` +
+        `Ask the user or re-run a tool if you need details from before this point.]`;
+}
+/** Return a COPY of `turns` with the summary text prepended to the first user
+ *  message of the first kept turn (so it reads as scene-setting on the oldest
+ *  surviving question, with no extra message and no role-alternation break). */
+function prependSummaryToTurns(turns, summary) {
+    const flat = turns.flat();
+    const idx = flat.findIndex((m) => m?.role === 'user');
+    const block = { type: 'text', text: summary };
+    if (idx < 0) {
+        // No user message survived (unusual) — fall back to a standalone leading note.
+        return [{ role: 'user', content: [block], timestamp: 0 }, ...flat];
+    }
+    const m = flat[idx];
+    const content = Array.isArray(m.content)
+        ? [block, ...m.content]
+        : [block, { type: 'text', text: typeof m.content === 'string' ? m.content : '' }];
+    flat[idx] = { ...m, content };
+    return flat;
+}
+/**
+ * Trim the latest turn's own oversized blocks in place (on copies): drop image
+ * blocks and clip very long text blocks, prepending a note. Used only when a
+ * single turn alone exceeds budget (Tier 3) so the turn still runs instead of
+ * poisoning the session.
+ */
+function truncateTurn(turn, targetTokens) {
+    const note = '[Some attachments or large contents in this message were truncated because it exceeded the model context window. ' +
+        'Send less at once or split it up if you need the full content processed.]';
+    // Cumulative char budget across the WHOLE turn — not per-block. A turn with
+    // several individually-small-but-collectively-large text results (e.g. one
+    // assistant step returning many tool results) must still come in under the
+    // target; a per-block cap would let each pass and leave the turn over budget.
+    let remainingChars = Math.max(2000, Math.floor(targetTokens * CHARS_PER_TOKEN));
+    const clipText = (text) => {
+        if (remainingChars <= 0)
+            return '…[truncated]';
+        if (text.length <= remainingChars) {
+            remainingChars -= text.length;
+            return text;
+        }
+        const slice = text.slice(0, remainingChars) + '\n…[truncated]';
+        remainingChars = 0;
+        return slice;
+    };
+    // Strip images and clip text cumulatively on a copy of each message.
+    const out = turn.map((msg) => {
+        const m = msg;
+        if (Array.isArray(m.content)) {
+            const content = m.content
+                .filter((b) => b?.type !== 'image')
+                .map((b) => {
+                if (b?.type === 'text' && typeof b.text === 'string')
+                    return { ...b, text: clipText(b.text) };
+                // Elide an oversized assistant tool-call argument payload (e.g. a
+                // create_artifact bundle made THIS turn, before the post-turn
+                // compaction runs). estimateMessageTokens counts these, so leaving
+                // them inline lets Tier 3 finish "truncated" yet still over budget →
+                // a provider 400. Replace the args with a marker; keep id/name so the
+                // tool_use ↔ tool_result pairing survives. Mirrors agent-pool's
+                // `{ _elided: true }` convention for create_artifact bundles.
+                if (b?.type === 'toolCall' && b.arguments && b.arguments._elided !== true) {
+                    let argLen = 0;
+                    try {
+                        argLen = JSON.stringify(b.arguments).length;
+                    }
+                    catch {
+                        argLen = 0;
+                    }
+                    if (argLen > 1000) {
+                        remainingChars = Math.max(0, remainingChars - 40);
+                        return { ...b, arguments: { _elided: true } };
+                    }
+                }
+                return b;
+            });
+            // Never emit an empty content array — the providers 400 on a tool_result
+            // (or user message) with no content. An image-only result filtered down to
+            // nothing gets a placeholder so the message — and its toolCallId pairing —
+            // survives.
+            if (content.length === 0)
+                content.push({ type: 'text', text: '[content removed to fit context]' });
+            return { ...m, content };
+        }
+        if (typeof m.content === 'string') {
+            return { ...m, content: clipText(m.content) };
+        }
+        return msg;
+    });
+    // Prepend the note to the first user message of the turn, if any.
+    const firstUserIdx = out.findIndex((m) => m?.role === 'user');
+    if (firstUserIdx >= 0) {
+        const m = out[firstUserIdx];
+        const noteBlock = { type: 'text', text: note };
+        const content = Array.isArray(m.content)
+            ? [noteBlock, ...m.content]
+            : [noteBlock, { type: 'text', text: typeof m.content === 'string' ? m.content : '' }];
+        out[firstUserIdx] = { ...m, content };
+    }
+    return out;
+}
+/**
+ * Bring a transcript under the model's input-token budget. Non-destructive:
+ * returns a NEW array of (possibly stubbed) message copies; the caller's message
+ * objects are never mutated. Tiered:
+ *   1. stub oversized tool results (oldest first, recent turns pinned)
+ *   2. evict oldest whole turns, folding a rolling summary into the oldest kept
+ *      user message
+ *   3. if the latest turn alone still overflows, truncate its oversized blocks
+ *
+ * Always pairing-safe: tool_use ↔ tool_result groupings are preserved so the
+ * provider never 400s on an orphaned tool result. Best-effort under extreme
+ * inputs: if even the truncated latest turn can't fit (e.g. enormous tool-call
+ * arguments the manager won't drop), it returns the smallest result it can and
+ * `stats.estimateAfter` reports the residual — the reactive `isContextOverflow`
+ * net (chat.ts) is the final backstop.
+ */
+export function manageContext(input) {
+    const { messages, systemPrompt, model, tools } = input;
+    const budget = computeBudget(model);
+    // Fixed per-request overhead (system prompt + tool schemas) — constant across
+    // all tiers, so compute once. Per-message costs are cached and kept summed so
+    // the whole pass stays O(n) instead of re-estimating the array in every loop.
+    const fixedOverhead = estimateTokens([], systemPrompt, tools);
+    const msgEst = (msg) => estimateMessageTokens(msg);
+    const perMsg = messages.map(msgEst);
+    const total = () => fixedOverhead + perMsg.reduce((a, b) => a + b, 0);
+    const estimateBefore = total();
+    const stats = {
+        budget,
+        estimateBefore,
+        estimateAfter: estimateBefore,
+        stubbedResults: 0,
+        evictedTurns: 0,
+        truncatedLatestTurn: false,
+        overBudget: false,
+    };
+    // Fast path — the overwhelming common case.
+    if (estimateBefore <= budget)
+        return { messages, stats };
+    // Parallel arrays: `working[i]` ↔ `costs[i]`. `running` tracks the live total.
+    let working = messages.slice();
+    let costs = perMsg.slice();
+    let running = estimateBefore;
+    // ── Tier 1: stub oversized tool results, oldest first, pinning recent turns ──
+    // Recent turns are normally pinned so the agent keeps its live working set
+    // inline. EXCEPTION: a single tool result that alone eats a large fraction of
+    // the budget (e.g. a 3M-token `list_assets` dump) is stubbed even when pinned —
+    // keeping one giant result inline would otherwise force Tier 2 to evict whole
+    // turns of surrounding conversation to make room, gutting the agent's task
+    // context (observed live: a 7,278-asset list collapsed context to ~48k and the
+    // agent lost the thread). The agent re-fetches from the stub on demand.
+    const GIANT_RESULT_TOKENS = Math.floor(budget * 0.33);
+    const turnsForPin = groupIntoTurns(working);
+    const pinnedFrom = Math.max(0, turnsForPin.length - PINNED_RECENT_TURNS);
+    const pinnedMsgs = new Set(turnsForPin.slice(pinnedFrom).flat());
+    for (let i = 0; i < working.length && running > budget; i++) {
+        const msg = working[i];
+        // Skip pinned recent messages UNLESS this one is a single giant result.
+        if (pinnedMsgs.has(msg) && costs[i] <= GIANT_RESULT_TOKENS)
+            continue;
+        if (isLargeToolResult(msg)) {
+            working[i] = stubToolResult(msg);
+            const newCost = msgEst(working[i]);
+            running += newCost - costs[i];
+            costs[i] = newCost;
+            stats.stubbedResults++;
+        }
+    }
+    // ── Tier 2: evict oldest whole turns, keeping the pinned tail ──────────────
+    if (running > budget) {
+        const turns = groupIntoTurns(working);
+        // Cost per turn, aligned with `turns` order (turns partition `working`).
+        let offset = 0;
+        const turnCosts = turns.map((t) => {
+            let c = 0;
+            for (let k = 0; k < t.length; k++)
+                c += costs[offset + k];
+            offset += t.length;
+            return c;
+        });
+        const evicted = [];
+        let firstKept = 0; // index of the first turn still kept
+        // Evict oldest first, keeping at least the single latest turn (Tier 3 then
+        // truncates that turn if it alone still overflows). The PINNED_RECENT_TURNS
+        // preference only matters when already under budget — and there we never
+        // enter this loop — so the hard floor here is 1, not PINNED_RECENT_TURNS;
+        // otherwise a few large recent turns could exceed a small budget with no way
+        // to recover.
+        while (turns.length - firstKept > 1 && running > budget) {
+            evicted.push(turns[firstKept]);
+            running -= turnCosts[firstKept];
+            firstKept++;
+            stats.evictedTurns++;
+        }
+        if (evicted.length > 0) {
+            const keptTurns = turns.slice(firstKept);
+            working = prependSummaryToTurns(keptTurns, buildSummaryText(evicted));
+            costs = working.map(msgEst);
+            running = fixedOverhead + costs.reduce((a, b) => a + b, 0);
+        }
+    }
+    // ── Tier 3: latest turn alone still overflows — truncate its own bulk ──────
+    if (running > budget) {
+        const turns = groupIntoTurns(working);
+        if (turns.length > 0) {
+            const lastIdx = turns.length - 1;
+            const before = turns.slice(0, lastIdx).flat();
+            const beforeTokens = fixedOverhead + before.map(msgEst).reduce((a, b) => a + b, 0);
+            // Room left for the latest turn after everything kept before it. Floor at
+            // 256 so a large `before` can't push the target so high that truncateTurn's
+            // own minimum-keep defeats the truncation entirely.
+            const target = Math.max(budget - beforeTokens, 256);
+            turns[lastIdx] = truncateTurn(turns[lastIdx], target);
+            working = turns.flat();
+            costs = working.map(msgEst);
+            running = fixedOverhead + costs.reduce((a, b) => a + b, 0);
+            stats.truncatedLatestTurn = true;
+        }
+    }
+    stats.estimateAfter = running;
+    // Terminal guard: all tiers ran and we're STILL over budget — the irreducible
+    // cost (systemPrompt + tool schemas, or one unshrinkable message) exceeds the
+    // budget. Nothing more to trim here; flag it so the caller can log it (not a
+    // silent failure) and the reactive net handles the likely 400.
+    stats.overBudget = running > budget;
+    return { messages: working, stats };
+}
+//# sourceMappingURL=context-window.js.map

package/dist/agent/context-window.js.map

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

package/dist/agent/followups.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Follow-up suggestion marker parsing.
+ *
+ * The system prompt instructs the agent to end every response with an HTML
+ * comment of the form:
+ *
+ *   <!-- followups: ["prompt 1", "prompt 2", "prompt 3"] -->
+ *
+ * Each transport (web, CLI, MCP) must strip this marker from the content it
+ * displays and surface the suggestions in whatever form fits its UI — chips
+ * in the web client, a dim numbered list in the CLI, a `suggestions` field
+ * in MCP, etc.
+ *
+ * Keep the parser in one place so a new transport can't silently leak the
+ * raw marker.
+ */
+export interface ParsedFollowups {
+    /** Response content with the marker removed and trailing whitespace trimmed. */
+    content: string;
+    /** Parsed suggestions, if the marker was present and valid JSON. */
+    suggestions?: string[];
+}
+/**
+ * Parse a raw agent response and split it into clean content plus optional
+ * follow-up suggestions. Malformed markers are left in place (the caller can
+ * choose to strip or render as-is), matching the existing web behaviour.
+ */
+export declare function parseFollowups(raw: string): ParsedFollowups;
+/**
+ * Return true if `text` contains an *unclosed* followups marker — used by
+ * streaming consumers to know whether to defer rendering the tail of a
+ * delta until the closing `-->` arrives.
+ */
+export declare function hasOpenFollowupsMarker(text: string): boolean;

package/dist/agent/followups.js

@@ -0,0 +1,52 @@
+/**
+ * Follow-up suggestion marker parsing.
+ *
+ * The system prompt instructs the agent to end every response with an HTML
+ * comment of the form:
+ *
+ *   <!-- followups: ["prompt 1", "prompt 2", "prompt 3"] -->
+ *
+ * Each transport (web, CLI, MCP) must strip this marker from the content it
+ * displays and surface the suggestions in whatever form fits its UI — chips
+ * in the web client, a dim numbered list in the CLI, a `suggestions` field
+ * in MCP, etc.
+ *
+ * Keep the parser in one place so a new transport can't silently leak the
+ * raw marker.
+ */
+/** Matches the trailing followups HTML comment at end of text (with optional trailing whitespace). */
+const FOLLOWUPS_RE = /<!--\s*followups:\s*(\[[\s\S]*?\])\s*-->\s*$/;
+/**
+ * Parse a raw agent response and split it into clean content plus optional
+ * follow-up suggestions. Malformed markers are left in place (the caller can
+ * choose to strip or render as-is), matching the existing web behaviour.
+ */
+export function parseFollowups(raw) {
+    const match = raw.match(FOLLOWUPS_RE);
+    if (!match)
+        return { content: raw };
+    try {
+        const parsed = JSON.parse(match[1]);
+        if (!Array.isArray(parsed) || !parsed.every((s) => typeof s === 'string')) {
+            return { content: raw };
+        }
+        const content = raw.slice(0, match.index).trimEnd();
+        return { content, suggestions: parsed };
+    }
+    catch {
+        return { content: raw };
+    }
+}
+/**
+ * Return true if `text` contains an *unclosed* followups marker — used by
+ * streaming consumers to know whether to defer rendering the tail of a
+ * delta until the closing `-->` arrives.
+ */
+export function hasOpenFollowupsMarker(text) {
+    const lastOpen = text.lastIndexOf('<!--');
+    if (lastOpen < 0)
+        return false;
+    const lastClose = text.lastIndexOf('-->');
+    return lastClose < lastOpen;
+}
+//# sourceMappingURL=followups.js.map

package/dist/agent/followups.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"followups.js","sourceRoot":"","sources":["../../src/agent/followups.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,sGAAsG;AACtG,MAAM,YAAY,GAAG,8CAA8C,CAAC;AASpE;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,GAAW;IACxC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IAEpC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,EAAE,CAAC;YAC1E,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;QAC1B,CAAC;QACD,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;QACpD,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAC1C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC;IAC1B,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,sBAAsB,CAAC,IAAY;IACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;IAC1C,IAAI,QAAQ,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IAC/B,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IAC1C,OAAO,SAAS,GAAG,QAAQ,CAAC;AAC9B,CAAC"}