@jini-ai/chat 0.1.0

package/dist/core/question-form/scan.js

@@ -0,0 +1,404 @@
+/**
+ * @module question-form/scan
+ *
+ * Markup segmentation for `<question-form>` / `<ask-question>` blocks:
+ * locating open/close tags, splitting prose from form JSON, and the
+ * tolerant streaming-recovery path that renders a partial form before its
+ * JSON body has finished arriving. Split out of the original single-file
+ * `question-form.ts`; see `../question-form.ts` for the public facade, the
+ * block format, and the tag-name-alias rule.
+ */
+import { parsePartialJson } from '../partial-json.js';
+import { parseQuotedAttrs } from '../util/markup-attributes.js';
+import { mapRawQuestion } from './normalize.js';
+// `question-form` is the canonical tag; `ask-question` is an alias the model
+// occasionally drifts to. The close tag must match the open tag name, so each
+// match captures the name and computes its own close-tag string. Matching is
+// case-insensitive so `<Question-Form>` / `<ASK-QUESTION>` still parse.
+const OPEN_RE = /<(question-form|ask-question)\b([^>]*)>/i;
+// Group 1 is a mandatory (non-optional) alternation and group 2 is an
+// unconditional `*`-quantified capture, so both always participate whenever
+// `m` itself is non-null — `noUncheckedIndexedAccess` just can't see that
+// from the regex alone. Centralized here so the six call sites below don't
+// each repeat the same assertion and reasoning.
+function matchedTagAndAttrs(m) {
+    return { tagName: m[1].toLowerCase(), rawAttrs: m[2] };
+}
+/**
+ * Split `input` into ordered prose/form segments. Scans repeatedly for
+ * `question-form`/`ask-question` opens; for each, locates the matching close
+ * tag and tries to parse the JSON body. A block that doesn't parse cleanly,
+ * or has no close tag yet, is left in the prose stream verbatim.
+ *
+ * @complexity O(n) amortized in `input.length` — each iteration advances the
+ *   cursor past the segment it just emitted.
+ */
+export function splitOnQuestionForms(input) {
+    const out = [];
+    let cursor = 0;
+    while (cursor < input.length) {
+        const slice = input.slice(cursor);
+        const m = OPEN_RE.exec(slice);
+        if (!m) {
+            out.push({ kind: 'text', text: slice });
+            break;
+        }
+        const { tagName, rawAttrs } = matchedTagAndAttrs(m);
+        const closeTag = `</${tagName}>`;
+        const openStart = cursor + m.index;
+        const openEnd = openStart + m[0].length;
+        const closeIdx = findCloseTag(input, openEnd, closeTag);
+        if (closeIdx === -1) {
+            // Unterminated — leave the rest as prose so we don't swallow it.
+            out.push({ kind: 'text', text: slice });
+            break;
+        }
+        if (openStart > cursor) {
+            out.push({ kind: 'text', text: input.slice(cursor, openStart) });
+        }
+        const body = input.slice(openEnd, closeIdx);
+        const attrs = parseQuotedAttrs(rawAttrs);
+        const form = tryParseForm(body, attrs);
+        const blockEnd = closeIdx + closeTag.length;
+        if (form) {
+            out.push({ kind: 'form', form, raw: input.slice(openStart, blockEnd) });
+        }
+        else {
+            // Malformed — keep raw text so the user can still see it.
+            out.push({ kind: 'text', text: input.slice(openStart, blockEnd) });
+        }
+        cursor = blockEnd;
+    }
+    return out;
+}
+/** The first complete, parseable `<question-form>` in `input`, or `null`. */
+export function findFirstQuestionForm(input) {
+    for (const seg of splitOnQuestionForms(input)) {
+        if (seg.kind === 'form')
+            return { form: seg.form, raw: seg.raw };
+    }
+    return null;
+}
+/**
+ * Convenience wrapper over {@link findFirstQuestionForm} matching the
+ * `parseQuestionForm()` name from the target API — returns just the form
+ * (dropping the matched raw text), or `null` when `input` has no complete
+ * question-form block. For a still-streaming block use
+ * {@link parsePartialQuestionForm} instead.
+ */
+export function parseQuestionForm(input) {
+    return findFirstQuestionForm(input)?.form ?? null;
+}
+/**
+ * Drop a trailing, not-yet-closed question-form block from streaming text so
+ * a chat surface doesn't flash raw `<question-form>{…` markup before the
+ * JSON finishes. Returns the visible text plus whether such an open block
+ * existed (meaning a form is mid-generation).
+ */
+export function stripTrailingOpenQuestionForm(input) {
+    let cursor = 0;
+    while (cursor < input.length) {
+        const slice = input.slice(cursor);
+        const m = OPEN_RE.exec(slice);
+        if (!m)
+            break;
+        const { tagName } = matchedTagAndAttrs(m);
+        const closeTag = `</${tagName}>`;
+        const openStart = cursor + m.index;
+        const openEnd = openStart + m[0].length;
+        const closeIdx = findCloseTag(input, openEnd, closeTag);
+        if (closeIdx === -1) {
+            return { text: input.slice(0, openStart), hadOpenForm: true };
+        }
+        cursor = closeIdx + closeTag.length;
+    }
+    return { text: input, hadOpenForm: false };
+}
+/** `true` when a question-form open tag is present but its close tag hasn't streamed in yet. */
+export function hasUnterminatedQuestionForm(input) {
+    return stripTrailingOpenQuestionForm(input).hadOpenForm;
+}
+function findCloseTag(input, from, closeTag) {
+    const closeLower = closeTag.toLowerCase();
+    const tagLen = closeTag.length;
+    const maxStart = input.length - tagLen;
+    for (let i = from; i <= maxStart; i++) {
+        if (input.slice(i, i + tagLen).toLowerCase() === closeLower) {
+            return i;
+        }
+    }
+    return -1;
+}
+function tryParseForm(body, attrs) {
+    const trimmed = body.trim();
+    if (!trimmed)
+        return null;
+    // Allow the JSON to be wrapped in a fenced ```json block — common when the
+    // model echoes its own indented body.
+    const stripped = trimmed
+        .replace(/^```(?:json)?\s*/i, '')
+        .replace(/```\s*$/i, '')
+        .trim();
+    let data;
+    try {
+        data = JSON.parse(stripped);
+    }
+    catch {
+        return null;
+    }
+    if (!data || typeof data !== 'object')
+        return null;
+    const obj = data;
+    const rawQuestions = Array.isArray(obj.questions) ? obj.questions : null;
+    if (!rawQuestions)
+        return null;
+    const questions = [];
+    rawQuestions.forEach((q, i) => {
+        const mapped = mapRawQuestion(q, i);
+        if (mapped)
+            questions.push(mapped);
+    });
+    if (questions.length === 0)
+        return null;
+    const id = attrs.id ?? (typeof obj.id === 'string' ? obj.id : 'discovery');
+    const title = attrs.title ?? (typeof obj.title === 'string' ? obj.title : 'A few quick questions');
+    const description = typeof obj.description === 'string' ? obj.description : undefined;
+    const submitLabel = typeof obj.submitLabel === 'string' ? obj.submitLabel : undefined;
+    return {
+        id,
+        title,
+        questions,
+        ...(description ? { description } : {}),
+        ...(submitLabel ? { submitLabel } : {}),
+    };
+}
+/**
+ * Tolerant parser for a still-streaming `<question-form>` block. Unlike
+ * {@link tryParseForm} it does not require valid, complete JSON: it reads the
+ * title/id from the open tag's attrs (available the instant the tag streams
+ * in) and extracts however many *complete* question objects have arrived so
+ * far, so a Questions panel can render a frame immediately and fill
+ * questions in progressively. Returns `null` only when no open tag is
+ * present at all.
+ *
+ * @complexity O(n) in `input.length` (one regex scan plus a linear
+ *   string-aware brace walk via {@link parsePartialJson}).
+ */
+export function parsePartialQuestionForm(input) {
+    const m = OPEN_RE.exec(input);
+    if (!m)
+        return null;
+    const { tagName, rawAttrs } = matchedTagAndAttrs(m);
+    const closeTag = `</${tagName}>`;
+    const openEnd = m.index + m[0].length;
+    const attrs = parseQuotedAttrs(rawAttrs);
+    const closeIdx = findCloseTag(input, openEnd, closeTag);
+    const rawBody = closeIdx === -1 ? input.slice(openEnd) : input.slice(openEnd, closeIdx);
+    // Strip the fenced ```json wrapper some models emit. The opening fence is
+    // removed always; the trailing fence is removed too once it streams in
+    // (possibly only a partial ``` so far) — otherwise leftover backticks make
+    // the JSON unparseable in the gap between "fence closed" and
+    // "</question-form> arrived", dropping the live preview back to empty.
+    const body = stripTrailingFence(rawBody.replace(/^\s*```(?:json)?\s*/i, ''));
+    // Derive form-level metadata from the *parsed top-level object*, not a
+    // whole-body regex scan: a nested question/option `id`/`title`/`description`
+    // must not masquerade as the form's own.
+    const parsed = parsePartialJson(body);
+    const top = parsed && typeof parsed === 'object' && !Array.isArray(parsed) ? parsed : {};
+    const topTitle = typeof top.title === 'string' && top.title.trim().length > 0 ? top.title : undefined;
+    // `id` keys a still-editable panel, so it must be stable for the whole
+    // stream — don't adopt it until its string literal is fully terminated,
+    // otherwise it would churn character-by-character and remount the panel.
+    const id = attrs.id ?? completeTopLevelString(body, 'id') ?? 'discovery';
+    const title = attrs.title ?? topTitle ?? 'A few quick questions';
+    const description = typeof top.description === 'string' ? top.description : undefined;
+    const submitLabel = typeof top.submitLabel === 'string' ? top.submitLabel : undefined;
+    const questions = shapeStreamingQuestions(top.questions, countClosedQuestionObjects(body));
+    return {
+        id,
+        title,
+        questions,
+        ...(description ? { description } : {}),
+        ...(submitLabel ? { submitLabel } : {}),
+    };
+}
+// Strip a trailing ``` fence (possibly only partially streamed) from a form
+// body — but only when those backticks are the closing wrapper, not content
+// of a JSON string value still being typed.
+function stripTrailingFence(body) {
+    const m = /\s*`{1,3}\s*$/.exec(body);
+    if (!m)
+        return body;
+    const before = body.slice(0, m.index);
+    if (endsInsideJsonString(before))
+        return body;
+    return before;
+}
+function endsInsideJsonString(s) {
+    let inStr = false;
+    let esc = false;
+    for (let i = 0; i < s.length; i++) {
+        const c = s[i];
+        if (inStr) {
+            if (esc)
+                esc = false;
+            else if (c === '\\')
+                esc = true;
+            else if (c === '"')
+                inStr = false;
+        }
+        else if (c === '"') {
+            inStr = true;
+        }
+    }
+    return inStr;
+}
+// Return a top-level (depth-1) string field's value ONLY if its string
+// literal is fully terminated in the (possibly partial) body. Depth-aware so
+// a nested question `id` can't be mistaken for the form's own.
+function completeTopLevelString(body, field) {
+    const marker = `"${field}"`;
+    let depth = 0;
+    let inStr = false;
+    let esc = false;
+    for (let i = 0; i < body.length; i++) {
+        const c = body[i];
+        if (inStr) {
+            if (esc)
+                esc = false;
+            else if (c === '\\')
+                esc = true;
+            else if (c === '"')
+                inStr = false;
+            continue;
+        }
+        if (c === '{' || c === '[') {
+            depth++;
+            continue;
+        }
+        if (c === '}' || c === ']') {
+            depth--;
+            continue;
+        }
+        if (c === '"') {
+            if (depth === 1 && body.startsWith(marker, i)) {
+                let j = i + marker.length;
+                while (j < body.length && /\s/.test(body[j]))
+                    j++;
+                if (body[j] !== ':') {
+                    inStr = true; // it's a value string, not our key — skip it
+                    continue;
+                }
+                j++;
+                while (j < body.length && /\s/.test(body[j]))
+                    j++;
+                if (body[j] !== '"')
+                    return undefined; // value not a (started) string
+                let value = '';
+                let vesc = false;
+                for (let k = j + 1; k < body.length; k++) {
+                    const vc = body[k];
+                    if (vesc) {
+                        value += vc;
+                        vesc = false;
+                    }
+                    else if (vc === '\\') {
+                        value += vc;
+                        vesc = true;
+                    }
+                    else if (vc === '"') {
+                        try {
+                            return JSON.parse(`"${value}"`);
+                        }
+                        catch {
+                            return value;
+                        }
+                    }
+                    else {
+                        value += vc;
+                    }
+                }
+                return undefined; // closing quote hasn't streamed yet
+            }
+            inStr = true;
+        }
+    }
+    return undefined;
+}
+function shapeStreamingQuestions(rawQuestions, closedCount) {
+    if (!Array.isArray(rawQuestions))
+        return [];
+    const out = [];
+    rawQuestions.forEach((raw, index) => {
+        if (!raw || typeof raw !== 'object')
+            return;
+        const q = raw;
+        const label = q.label;
+        if (typeof label !== 'string' || label.trim().length === 0)
+            return;
+        // Surface a question only once its canonical id is determinable, so the
+        // preview id matches what the final parse assigns: a closed object's id
+        // is final; an in-flight object needs an explicit id already present.
+        const isClosed = index < closedCount;
+        const hasId = typeof q.id === 'string' && q.id.trim().length > 0;
+        if (!isClosed && !hasId)
+            return;
+        const mapped = mapRawQuestion(raw, index);
+        if (mapped)
+            out.push(mapped);
+    });
+    return out;
+}
+// Count how many question objects in a partial `"questions": [ … ]` body
+// have their closing brace already streamed (string-aware).
+function countClosedQuestionObjects(body) {
+    const keyMatch = /"questions"\s*:\s*\[/.exec(body);
+    if (!keyMatch)
+        return 0;
+    let i = keyMatch.index + keyMatch[0].length;
+    let count = 0;
+    while (i < body.length) {
+        while (i < body.length && /[\s,]/.test(body[i]))
+            i++;
+        if (i >= body.length || body[i] === ']')
+            break;
+        if (body[i] !== '{')
+            break;
+        const obj = extractBalancedObject(body, i);
+        if (!obj)
+            break; // trailing object hasn't closed yet
+        count++;
+        i += obj.length;
+    }
+    return count;
+}
+// Return the substring for the balanced `{...}` object starting at `start`,
+// or null if it never closes (string-aware so braces inside strings don't count).
+function extractBalancedObject(s, start) {
+    let depth = 0;
+    let inStr = false;
+    let esc = false;
+    for (let i = start; i < s.length; i++) {
+        const c = s[i];
+        if (inStr) {
+            if (esc)
+                esc = false;
+            else if (c === '\\')
+                esc = true;
+            else if (c === '"')
+                inStr = false;
+            continue;
+        }
+        if (c === '"')
+            inStr = true;
+        else if (c === '{')
+            depth++;
+        else if (c === '}') {
+            depth--;
+            if (depth === 0)
+                return s.slice(start, i + 1);
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=scan.js.map

package/dist/core/question-form/scan.js.map

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

package/dist/core/question-form/types.d.ts

@@ -0,0 +1,83 @@
+/**
+ * @module question-form/types
+ *
+ * Type vocabulary for the `<question-form>` parser, split out of the
+ * original single-file `question-form.ts` so `scan.ts` / `normalize.ts` /
+ * `format.ts` can each import just the types they need without pulling in
+ * one another's implementation. See `../question-form.ts` for the public
+ * facade and the block format this vocabulary describes.
+ */
+export type QuestionType = 'radio' | 'checkbox' | 'select' | 'text' | 'textarea' | 'number' | 'range' | 'date' | 'time' | 'datetime-local' | 'color' | 'url' | 'email' | 'tel' | 'file' | 'switch' | 'direction-cards';
+/**
+ * Rich card metadata for a single `direction-cards` option. A direction
+ * picker renders a swatch row, a serif/sans type sample, a mood blurb, and a
+ * "references" line so users can scan visually instead of reading radio
+ * labels. The agent emits this metadata inline in the form JSON so a host
+ * can render it without additional fetches.
+ */
+export interface DirectionCard {
+    /** The radio value — what comes back in the user's answer. Must match a label/value in `options`. */
+    id: string;
+    /** Short headline on the card. */
+    label: string;
+    /** One- or two-sentence mood blurb. */
+    mood: string;
+    /** Real-world exemplars (kept to at most 6 by the parser). */
+    references: string[];
+    /** Swatch hex / OKLch strings for the palette row (kept to at most 8 by the parser). */
+    palette: string[];
+    /** Display (headline) font stack, for a live "Aa" sample. */
+    displayFont: string;
+    /** Body font stack, for a secondary sample. */
+    bodyFont: string;
+}
+export interface FormOption {
+    label: string;
+    value: string;
+    description?: string;
+}
+export interface FormQuestion {
+    id: string;
+    label: string;
+    type: QuestionType;
+    options?: FormOption[];
+    placeholder?: string;
+    required?: boolean;
+    help?: string;
+    defaultValue?: string | string[];
+    /** Only applies when `type === 'checkbox'`. Caps the number of selected options. */
+    maxSelections?: number;
+    /**
+     * For finite-choice controls, show a free-form override beside the
+     * generated options so the user can supply their own value.
+     */
+    allowCustom?: boolean;
+    customLabel?: string;
+    customPlaceholder?: string;
+    /** Numeric/range inputs only. */
+    min?: number;
+    max?: number;
+    step?: number;
+    /** File inputs only. The answer serializes selected file names, not bytes. */
+    multiple?: boolean;
+    /** File inputs only. Mirrors the native file input `accept` attribute. */
+    accept?: string;
+    /** Only present when `type === 'direction-cards'`. Mapped to `options` by `id`. */
+    cards?: DirectionCard[];
+}
+export interface QuestionForm {
+    id: string;
+    title: string;
+    description?: string;
+    questions: FormQuestion[];
+    submitLabel?: string;
+}
+export type FormSegment = {
+    kind: 'text';
+    text: string;
+} | {
+    kind: 'form';
+    form: QuestionForm;
+    raw: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/core/question-form/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/question-form/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,MAAM,YAAY,GACpB,OAAO,GACP,UAAU,GACV,QAAQ,GACR,MAAM,GACN,UAAU,GACV,QAAQ,GACR,OAAO,GACP,MAAM,GACN,MAAM,GACN,gBAAgB,GAChB,OAAO,GACP,KAAK,GACL,OAAO,GACP,KAAK,GACL,MAAM,GACN,QAAQ,GACR,iBAAiB,CAAC;AAEtB;;;;;;GAMG;AACH,MAAM,WAAW,aAAa;IAC5B,qGAAqG;IACrG,EAAE,EAAE,MAAM,CAAC;IACX,kCAAkC;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,8DAA8D;IAC9D,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,wFAAwF;IACxF,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,6DAA6D;IAC7D,WAAW,EAAE,MAAM,CAAC;IACpB,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,YAAY,CAAC;IACnB,OAAO,CAAC,EAAE,UAAU,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;IACjC,oFAAoF;IACpF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iCAAiC;IACjC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,mFAAmF;IACnF,KAAK,CAAC,EAAE,aAAa,EAAE,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,YAAY,EAAE,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,YAAY,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC"}

package/dist/core/question-form/types.js

@@ -0,0 +1,11 @@
+/**
+ * @module question-form/types
+ *
+ * Type vocabulary for the `<question-form>` parser, split out of the
+ * original single-file `question-form.ts` so `scan.ts` / `normalize.ts` /
+ * `format.ts` can each import just the types they need without pulling in
+ * one another's implementation. See `../question-form.ts` for the public
+ * facade and the block format this vocabulary describes.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/question-form/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/core/question-form/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/dist/core/question-form.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @module question-form
+ *
+ * Parser for inline `<question-form>...</question-form>` blocks an agent
+ * emits to ask the user a structured set of clarifying questions before
+ * proceeding. Body must be JSON, e.g.:
+ *
+ *   <question-form id="discovery" title="Quick brief">
+ *   {
+ *     "questions": [
+ *       { "id": "platform", "label": "Platform", "type": "radio",
+ *         "options": ["Mobile (iOS/Android)", "Desktop web", "Responsive"],
+ *         "required": true }
+ *     ]
+ *   }
+ *   </question-form>
+ *
+ * `<ask-question>...</ask-question>` is accepted as an alias for
+ * `<question-form>`, so a model that drifts to the colloquial tag name
+ * still renders correctly instead of leaking raw markup into prose.
+ *
+ * Splits a final assistant text payload into ordered segments — prose +
+ * forms — so a host's message renderer can render the form inline.
+ *
+ * This module is a stable public facade. The implementation is split across
+ * `question-form/` by responsibility, each with its own invariants:
+ *   - `types.ts`     — the shared type vocabulary
+ *   - `scan.ts`       — tag matching, prose/form segmentation, and the
+ *                       tolerant streaming-recovery path
+ *   - `normalize.ts`  — raw-JSON-to-`FormQuestion` normalization, including
+ *                       the `isRenderableColor` CSS-injection guard
+ *   - `format.ts`     — turning submitted answers into agent-readable prose
+ * Only re-exports live here; do not add implementation directly to this file.
+ */
+export type { QuestionType, DirectionCard, FormOption, FormQuestion, QuestionForm, FormSegment } from './question-form/types.js';
+export { splitOnQuestionForms, findFirstQuestionForm, parseQuestionForm, stripTrailingOpenQuestionForm, hasUnterminatedQuestionForm, parsePartialQuestionForm, } from './question-form/scan.js';
+export { isRenderableColor } from './question-form/normalize.js';
+export { formatFormAnswers, formOptionLabelForValue, formOptionValueForLabel } from './question-form/format.js';
+//# sourceMappingURL=question-form.d.ts.map

package/dist/core/question-form.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-form.d.ts","sourceRoot":"","sources":["../../src/core/question-form.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AACH,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACjI,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,6BAA6B,EAC7B,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/core/question-form.js

@@ -0,0 +1,4 @@
+export { splitOnQuestionForms, findFirstQuestionForm, parseQuestionForm, stripTrailingOpenQuestionForm, hasUnterminatedQuestionForm, parsePartialQuestionForm, } from './question-form/scan.js';
+export { isRenderableColor } from './question-form/normalize.js';
+export { formatFormAnswers, formOptionLabelForValue, formOptionValueForLabel } from './question-form/format.js';
+//# sourceMappingURL=question-form.js.map

package/dist/core/question-form.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"question-form.js","sourceRoot":"","sources":["../../src/core/question-form.ts"],"names":[],"mappings":"AAmCA,OAAO,EACL,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,6BAA6B,EAC7B,2BAA2B,EAC3B,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/core/todos.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @module todos
+ *
+ * Pure TodoWrite-style plan-tool snapshot parsing/derivation. Reads the
+ * structured plan a `TodoWrite`/`update_plan`-shaped tool call carries and
+ * derives the "latest plan state" a pinned progress card renders — no I/O,
+ * no framework.
+ */
+import type { AgentEvent } from './events.js';
+import type { ChatRunStatus } from './messages.js';
+export type TodoStatus = 'pending' | 'in_progress' | 'completed' | 'stopped';
+export interface TodoItem {
+    content: string;
+    status: TodoStatus;
+    activeForm?: string | undefined;
+}
+/** `true` when `name` is one of the accepted plan/TodoWrite tool-name spellings. */
+export declare function isTodoWriteToolName(name: string): boolean;
+/**
+ * Parse a plan-tool call's raw `input` into a normalized `TodoItem[]`,
+ * tolerating the several shapes different agent runtimes emit (`todos` vs
+ * `plan` array; `content`/`step`/`description`/`label`/`text` for the item
+ * body; `activeForm`/`active_form`).
+ *
+ * @param input - The `tool_use` event's `input`, of unknown shape.
+ * @returns Normalized items; entries with no recognizable body text are dropped.
+ * @complexity O(n) in the number of raw plan entries.
+ */
+export declare function parseTodoWriteInput(input: unknown): TodoItem[];
+/**
+ * Find the most recent plan-tool `tool_use` in a single turn's events and
+ * return its parsed items, or `[]` if this turn never wrote a plan.
+ * @complexity O(n), scanning from the end.
+ */
+export declare function latestTodosFromEvents(events: AgentEvent[] | undefined): TodoItem[];
+/** The subset of {@link latestTodosFromEvents} not yet marked `completed`. */
+export declare function unfinishedTodosFromEvents(events: AgentEvent[] | undefined): TodoItem[];
+/**
+ * Walk a conversation in reverse to find the most recent plan-tool
+ * `tool_use` across every message and return its raw (un-parsed) `input`, so
+ * a caller can hand it straight to a plan/todo card without re-implementing
+ * the discovery walk.
+ *
+ * @param messages - Conversation turns, oldest first (only `events` is read).
+ * @returns The raw tool input, or `null` if no plan tool has run yet.
+ * @complexity O(n*m) worst case (n messages, m events each), but returns on
+ *   the first hit scanning backwards, so the common case (a recent plan
+ *   update) is far cheaper.
+ */
+export declare function latestTodoWriteInputFromMessages(messages: ReadonlyArray<{
+    events?: AgentEvent[] | undefined;
+}> | undefined): unknown | null;
+/** Convenience alias for {@link latestTodoWriteInputFromMessages} matching the `latestTodoWriteInput()` name in the target API. */
+export declare const latestTodoWriteInput: typeof latestTodoWriteInputFromMessages;
+/**
+ * Variant of {@link latestTodoWriteInputFromMessages} for a "pinned progress
+ * card" that must stay honest once its owning run has ended: while the run
+ * is still active the raw input is returned as-is, but once the run is
+ * terminal any item still marked `in_progress` is flipped to `stopped` (the
+ * agent process exited before marking it done or failed).
+ *
+ * @complexity Same as {@link latestTodoWriteInputFromMessages}, plus an O(m)
+ *   remap of the winning turn's items when the run has ended.
+ */
+export declare function latestTodoWriteInputForPinnedCard<T extends {
+    events?: AgentEvent[] | undefined;
+    runStatus?: ChatRunStatus | undefined;
+    endedAt?: number | undefined;
+}>(messages: ReadonlyArray<T> | undefined): unknown | null;
+//# sourceMappingURL=todos.d.ts.map

package/dist/core/todos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"todos.d.ts","sourceRoot":"","sources":["../../src/core/todos.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAEnD,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,aAAa,GAAG,WAAW,GAAG,SAAS,CAAC;AAE7E,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACjC;AASD,oFAAoF;AACpF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEzD;AAYD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,QAAQ,EAAE,CAiC9D;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,SAAS,GAAG,QAAQ,EAAE,CAQlF;AAED,8EAA8E;AAC9E,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,SAAS,GAAG,QAAQ,EAAE,CAEtF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gCAAgC,CAC9C,QAAQ,EAAE,aAAa,CAAC;IAAE,MAAM,CAAC,EAAE,UAAU,EAAE,GAAG,SAAS,CAAA;CAAE,CAAC,GAAG,SAAS,GACzE,OAAO,GAAG,IAAI,CAahB;AAED,mIAAmI;AACnI,eAAO,MAAM,oBAAoB,yCAAmC,CAAC;AA4BrE;;;;;;;;;GASG;AACH,wBAAgB,iCAAiC,CAC/C,CAAC,SAAS;IACR,MAAM,CAAC,EAAE,UAAU,EAAE,GAAG,SAAS,CAAC;IAClC,SAAS,CAAC,EAAE,aAAa,GAAG,SAAS,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B,EACD,QAAQ,EAAE,aAAa,CAAC,CAAC,CAAC,GAAG,SAAS,GAAG,OAAO,GAAG,IAAI,CAiBxD"}