@jini-ai/chat 0.3.10 → 0.5.0

package/dist/core/index.js

@@ -4,7 +4,7 @@
  * Zero React, zero DOM/browser globals, zero Node built-ins, zero imports
  * from any product package's scope. See ADS-memory/reports/jini-port/extraction-plan.md
  * §12 C2/C3 and ADS-memory/reports/jini-port/recon/r4b-webui-design.md §1 for the design
- * this package targets, and source-map.md for exact provenance.
+ * this package targets, and archived provenance ledger for exact provenance.
  *
  * Was `@jini-ai/chat-core` (its own top-level package, one entry point) through npm 0.1.2 —
  * consolidated 2026-08-03 into `@jini-ai/chat`'s `./core` subpath alongside `./react` (formerly
@@ -31,13 +31,13 @@ export * from './compact-events.js';
  * vocabulary this used to sit alongside — `CapabilityDef`, `PAGE_CAPABILITIES`, the
  * `data-agent-*` convention, the policy gate, the protocol projections — moved to `@jini-ai/agentic`
  * on 2026-07-26; import it directly rather than through this package. See
- * `packages/agentic/source-map.md` and this package's own source-map.md for the extraction.
+ * `packages/agentic/archived provenance ledger` and this package's own archived provenance ledger for the extraction.
  */
 export * from './agentic/index.js';
 /**
  * Durable chat history — the storage-neutral `ChatHistoryStore` port and the local title
  * heuristic. Types and pure functions only, so this package stays framework-free and
- * `runtime: universal`; the SQLite implementation lives in `@jini-ai/sqlite`'s `chat-history`
+ * `runtime: universal`; the SQLite implementation lives in `@jini-ai/sqlite-chat`'s `chat-history`
  * module, and a host binds it to its own authentication.
  */
 export * from './persistence/index.js';

package/dist/core/messages.d.ts

@@ -8,12 +8,14 @@ export type ChatRole = 'user' | 'assistant';
  * `RunStatus` for a different shape at a different layer — a richer `{ id, state, ... }` record.
  * This is the flat string union a chat message stamps on itself. While both were called
  * `RunStatus`, every consumer importing both packages had to alias one on import, and nothing
- * stopped the two from being confused at a glance. See source-map.md.
+ * stopped the two from being confused at a glance. See archived provenance ledger.
  */
 export declare const CHAT_RUN_STATUSES: readonly ["queued", "running", "succeeded", "failed", "canceled"];
 export type ChatRunStatus = (typeof CHAT_RUN_STATUSES)[number];
 /** `true` once a run has reached a terminal status (no further events will arrive). */
-export declare function isTerminalRunStatus(status: ChatRunStatus | undefined): boolean;
+export declare function isTerminalRunStatus({ status }: {
+    status: ChatRunStatus | undefined;
+}): boolean;
 /** A file or image a user turn carries alongside its text. */
 export interface ChatAttachment {
     path: string;

package/dist/core/messages.js

@@ -5,12 +5,12 @@
  * `RunStatus` for a different shape at a different layer — a richer `{ id, state, ... }` record.
  * This is the flat string union a chat message stamps on itself. While both were called
  * `RunStatus`, every consumer importing both packages had to alias one on import, and nothing
- * stopped the two from being confused at a glance. See source-map.md.
+ * stopped the two from being confused at a glance. See archived provenance ledger.
  */
 export const CHAT_RUN_STATUSES = ['queued', 'running', 'succeeded', 'failed', 'canceled'];
 const TERMINAL_RUN_STATUSES = new Set(['succeeded', 'failed', 'canceled']);
 /** `true` once a run has reached a terminal status (no further events will arrive). */
-export function isTerminalRunStatus(status) {
+export function isTerminalRunStatus({ status }) {
     return status !== undefined && TERMINAL_RUN_STATUSES.has(status);
 }
 //# sourceMappingURL=messages.js.map

package/dist/core/partial-json.d.ts

@@ -23,7 +23,9 @@
  *   depth `d` — one linear scan plus a bounded fixed-point cleanup loop over
  *   the (already shrinking) tail.
  */
-export declare function repairJsonPrefix(buf: string): string;
+export declare function repairJsonPrefix({ buf }: {
+    buf: string;
+}): string;
 /**
  * Best-effort parse of a (possibly truncated) JSON prefix.
  *
@@ -32,5 +34,7 @@ export declare function repairJsonPrefix(buf: string): string;
  *   parse failure — callers should fall back to their last good value.
  * @complexity O(n) — dominated by {@link repairJsonPrefix}.
  */
-export declare function parsePartialJson(buf: string): unknown;
+export declare function parsePartialJson({ buf }: {
+    buf: string;
+}): unknown;
 //# sourceMappingURL=partial-json.d.ts.map

package/dist/core/partial-json.js

@@ -23,7 +23,7 @@
  *   depth `d` — one linear scan plus a bounded fixed-point cleanup loop over
  *   the (already shrinking) tail.
  */
-export function repairJsonPrefix(buf) {
+export function repairJsonPrefix({ buf }) {
     const stack = []; // closers owed, e.g. ['}', ']']
     let inStr = false;
     let esc = false;
@@ -105,12 +105,12 @@ export function repairJsonPrefix(buf) {
  *   parse failure — callers should fall back to their last good value.
  * @complexity O(n) — dominated by {@link repairJsonPrefix}.
  */
-export function parsePartialJson(buf) {
+export function parsePartialJson({ buf }) {
     const trimmed = buf.trim();
     if (!trimmed)
         return null;
     try {
-        return JSON.parse(repairJsonPrefix(trimmed));
+        return JSON.parse(repairJsonPrefix({ buf: trimmed }));
     }
     catch {
         return null;

package/dist/core/persistence/index.d.ts

@@ -2,7 +2,7 @@
  * @module persistence
  *
  * Durable chat history: the storage-neutral port plus the local title heuristic. No driver, no
- * DDL, no I/O — a SQLite implementation lives in `@jini-ai/sqlite`'s `chat-history` module, and
+ * DDL, no I/O — a SQLite implementation lives in `@jini-ai/sqlite-chat`'s `chat-history` module, and
  * a host binds it to its own auth. See `./ports.ts` for why the owner scope is bound into the
  * store rather than passed per call.
  */

package/dist/core/persistence/index.js

@@ -2,7 +2,7 @@
  * @module persistence
  *
  * Durable chat history: the storage-neutral port plus the local title heuristic. No driver, no
- * DDL, no I/O — a SQLite implementation lives in `@jini-ai/sqlite`'s `chat-history` module, and
+ * DDL, no I/O — a SQLite implementation lives in `@jini-ai/sqlite-chat`'s `chat-history` module, and
  * a host binds it to its own auth. See `./ports.ts` for why the owner scope is bound into the
  * store rather than passed per call.
  */

package/dist/core/persistence/ports.d.ts

@@ -1,124 +1,3 @@
-/**
- * @module persistence/ports
- *
- * The storage-neutral contract for durable chat history: conversations and their messages,
- * scoped to an owner. Types and signatures only — this module imports no driver, opens no
- * file, and issues no DDL, so it stays inside `chat-core`'s `runtime: universal` promise.
- *
- * Why here and not in `@jini-ai/agentic`: `chat-core` already depends on `agentic`, so a port
- * living in `agentic` could not import {@link ChatMessage} — the type it exists to persist —
- * without inverting that edge. It would have to redefine the message shape (two sources of
- * truth) or be generic over an opaque type (a persistence abstraction naming nothing).
- *
- * Why the owner scope is baked into the port rather than passed per call: every read must be
- * `WHERE scope = ? AND owner = ? AND id = ?`, never `WHERE id = ?`. A port whose methods take
- * a bare id invites exactly one bug — a handler that forgets the predicate — and that bug is
- * an omission, so review does not reliably catch it. {@link ChatHistoryStore} is obtained
- * already-bound to a {@link ChatOwnerScope}; there is no method on it that can read across
- * owners. Hosts bind the scope from their own auth, which is the one part of this that cannot
- * be reused.
- */
-import type { ChatMessage } from '../messages.js';
-/**
- * Which kind of principal owns a conversation.
- *
- * `user` is an authenticated account; `guest` is an anonymous visitor identified only by an
- * opaque bearer token. They are separated rather than collapsed into one `ownerId` because the
- * retention and disclosure rules differ: guest history expires, user history does not, and a
- * guest's identifier is a credential that must be stored hashed.
- */
-export type ChatOwnerKind = 'user' | 'guest';
-/**
- * The isolation predicate, resolved by the host from its own authentication, and bound into a
- * store before any query runs.
- *
- * `scopeId` is the host's partition key — a workspace, a tenant, a project, whatever that host
- * partitions by. This package does not interpret it; it only guarantees every statement filters
- * on it.
- *
- * `ownerId` for a `guest` MUST already be hashed by the host. This package never sees, stores,
- * or logs a raw bearer token, and cannot verify that a caller honored this — it is stated here
- * because the constraint is real and the type system cannot express it.
- */
-export interface ChatOwnerScope {
-    readonly scopeId: string;
-    readonly ownerKind: ChatOwnerKind;
-    readonly ownerId: string;
-}
-/** Where a conversation's current title came from — see {@link ChatHistoryStore.rename}. */
-export type ChatTitleSource = 'fallback' | 'generated' | 'manual';
-/**
- * A conversation as the list UI needs it: enough to render a row without loading any messages.
- *
- * `messageCount` is computed by the adapter in the same round-trip as the list itself, so a
- * list of N conversations costs one query rather than N+1.
- */
-export interface ChatConversation {
-    readonly id: string;
-    readonly title: string | null;
-    readonly titleSource: ChatTitleSource;
-    readonly messageCount: number;
-    readonly createdAt: number;
-    readonly updatedAt: number;
-    /** Absent means no expiry — the row is retained until explicitly deleted. */
-    readonly expiresAt?: number;
-}
-/** Everything a host may specify when starting a conversation. */
-export interface CreateChatConversationInput {
-    readonly id: string;
-    readonly title?: string | null;
-    readonly titleSource?: ChatTitleSource;
-    /** Epoch ms. Omit for history that never expires. */
-    readonly expiresAt?: number;
-}
-/**
- * Durable chat history for exactly one {@link ChatOwnerScope}.
- *
- * Every method is already scoped. `get(id)` for an id belonging to another owner resolves to
- * `null` rather than throwing — a caller must not be able to distinguish "does not exist" from
- * "exists but is not yours", since that distinction is itself an enumeration oracle.
- */
-export interface ChatHistoryStore {
-    /** Most-recently-updated first. */
-    list(): Promise<ChatConversation[]>;
-    /** `null` when the id does not exist *or* is not owned by this scope. */
-    get(id: string): Promise<ChatConversation | null>;
-    create(input: CreateChatConversationInput): Promise<ChatConversation>;
-    /**
-     * Sets the title and stamps `titleSource`. A `manual` title is never overwritten by a
-     * `generated` one — that rule lives in the adapter so no host can forget it, and it is the
-     * reason `titleSource` is a column rather than a UI concern.
-     */
-    rename(id: string, title: string, source?: ChatTitleSource): Promise<ChatConversation | null>;
-    /** Bumps `updatedAt`, optionally extending expiry for a still-active guest session. */
-    touch(id: string, options?: {
-        readonly expiresAt?: number;
-    }): Promise<void>;
-    /** Cascades to the conversation's messages. No-op when the id is not owned by this scope. */
-    delete(id: string): Promise<void>;
-    /** Ordered by position. Empty when the id is not owned by this scope. */
-    messages(conversationId: string): Promise<ChatMessage[]>;
-    /**
-     * Inserts or updates one message, assigning the next position on insert.
-     *
-     * `null` when the conversation is not owned by this scope — so a mis-scoped write is a
-     * no-op rather than a cross-owner insert.
-     */
-    appendMessage(conversationId: string, message: ChatMessage): Promise<ChatMessage | null>;
-}
-/**
- * Retention. Deliberately NOT on {@link ChatHistoryStore}: a sweep runs across every owner, so
- * putting it on a per-owner store would require an unscoped store to exist, which is the exact
- * escape hatch this design removes.
- */
-export interface ChatHistoryMaintenance {
-    /**
-     * Hard-deletes conversations whose `expiresAt` is at or before `now`, cascading to messages.
-     *
-     * `limit` bounds one call so a large backlog is drained in chunks rather than held in a
-     * single long write transaction — an unbounded `DELETE` is what starves concurrent inserts.
-     * Returns the number of conversations deleted, so a caller can loop until it reports 0.
-     */
-    sweepExpired(now: number, limit?: number): Promise<number>;
-}
+/** Compatibility types; the neutral store entry is the single source of truth. */
+export type * from '@jini-ai/chat/store';
 //# sourceMappingURL=ports.d.ts.map

package/dist/core/persistence/title.d.ts

@@ -31,5 +31,7 @@
  *
  * @complexity O(n) in prompt length; no allocation beyond the intermediate strings.
  */
-export declare function deriveConversationTitle(prompt: string): string;
+export declare function deriveConversationTitle({ prompt }: {
+    prompt: string;
+}): string;
 //# sourceMappingURL=title.d.ts.map

package/dist/core/persistence/title.js

@@ -122,7 +122,7 @@ function trimCjkTitle(input) {
  *
  * @complexity O(n) in prompt length; no allocation beyond the intermediate strings.
  */
-export function deriveConversationTitle(prompt) {
+export function deriveConversationTitle({ prompt }) {
     const cleaned = cleanPrompt(prompt);
     if (!cleaned)
         return '';

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

@@ -15,13 +15,22 @@ import type { FormOption, QuestionForm } from './types.js';
  *
  * @complexity O(q) in the number of questions on the form.
  */
-export declare function formatFormAnswers(form: QuestionForm, answers: Record<string, string | string[]>): string;
+export declare function formatFormAnswers({ form, answers }: {
+    form: QuestionForm;
+    answers: Record<string, string | string[]>;
+}): string;
 /** Resolve a submitted answer value back to its display label, or the value itself when unmatched. */
-export declare function formOptionLabelForValue(question: {
-    options?: FormOption[] | undefined;
-}, value: string): string;
+export declare function formOptionLabelForValue({ question, value }: {
+    question: {
+        options?: FormOption[] | undefined;
+    };
+    value: string;
+}): string;
 /** Resolve a label or value to the canonical option `value`, or the input itself when unmatched. */
-export declare function formOptionValueForLabel(question: {
-    options?: FormOption[] | undefined;
-}, labelOrValue: string): string;
+export declare function formOptionValueForLabel({ question, labelOrValue }: {
+    question: {
+        options?: FormOption[] | undefined;
+    };
+    labelOrValue: string;
+}): string;
 //# sourceMappingURL=format.d.ts.map

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

@@ -5,7 +5,7 @@
  *
  * @complexity O(q) in the number of questions on the form.
  */
-export function formatFormAnswers(form, answers) {
+export function formatFormAnswers({ form, answers }) {
     const lines = [];
     lines.push(`[form answers — ${form.id}]`);
     for (const q of form.questions) {
@@ -33,12 +33,12 @@ function formOptionDisplayForValue(question, value) {
     return `${match.label} [value: ${match.value}]`;
 }
 /** Resolve a submitted answer value back to its display label, or the value itself when unmatched. */
-export function formOptionLabelForValue(question, value) {
+export function formOptionLabelForValue({ question, value }) {
     const match = question.options?.find((option) => option.value === value || option.label === value);
     return match?.label ?? value;
 }
 /** Resolve a label or value to the canonical option `value`, or the input itself when unmatched. */
-export function formOptionValueForLabel(question, labelOrValue) {
+export function formOptionValueForLabel({ question, labelOrValue }) {
     const match = question.options?.find((option) => option.value === labelOrValue || option.label === labelOrValue);
     return match?.value ?? labelOrValue;
 }

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

@@ -10,7 +10,10 @@
  * question objects.
  */
 import type { FormQuestion } from './types.js';
-export declare function mapRawQuestion(q: unknown, index: number): FormQuestion | null;
+export declare function mapRawQuestion({ q, index }: {
+    q: unknown;
+    index: number;
+}): FormQuestion | null;
 /**
  * Whether a model-supplied palette entry may be written into a CSS value.
  *
@@ -26,5 +29,7 @@ export declare function mapRawQuestion(q: unknown, index: number): FormQuestion
  * rather than substituted: a silently recoloured swatch would misrepresent the agent's proposal,
  * and a card with fewer swatches is honest about what survived validation.
  */
-export declare function isRenderableColor(value: string): boolean;
+export declare function isRenderableColor({ value }: {
+    value: string;
+}): boolean;
 //# sourceMappingURL=normalize.d.ts.map

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

@@ -1,5 +1,5 @@
 import { formOptionValueForLabel } from './format.js';
-export function mapRawQuestion(q, index) {
+export function mapRawQuestion({ q, index }) {
     if (!q || typeof q !== 'object')
         return null;
     const qo = q;
@@ -128,9 +128,9 @@ function parseDefaultValue(question, options) {
                     ? String(question.default)
                     : undefined;
     if (typeof raw === 'string')
-        return formOptionValueForLabel({ options }, raw);
+        return formOptionValueForLabel({ question: { options }, labelOrValue: raw });
     if (Array.isArray(raw)) {
-        return raw.filter((value) => typeof value === 'string').map((value) => formOptionValueForLabel({ options }, value));
+        return raw.filter((value) => typeof value === 'string').map((value) => formOptionValueForLabel({ question: { options }, labelOrValue: value }));
     }
     return undefined;
 }
@@ -158,7 +158,7 @@ const COLOR_FUNCTION = /^(?:rgb|rgba|hsl|hsla|hwb|lab|lch|oklab|oklch|color)\(\s
  * rather than substituted: a silently recoloured swatch would misrepresent the agent's proposal,
  * and a card with fewer swatches is honest about what survived validation.
  */
-export function isRenderableColor(value) {
+export function isRenderableColor({ value }) {
     const candidate = value.trim();
     // Bounded before any regex runs: these come from model output, and the function pattern's `\s*`
     // plus a character class is the shape that makes a pathological input worth not accepting at all.
@@ -181,7 +181,7 @@ function parseDirectionCards(raw) {
         const mood = typeof e.mood === 'string' ? e.mood : '';
         const references = Array.isArray(e.references) ? e.references.filter((r) => typeof r === 'string').slice(0, 6) : [];
         const palette = Array.isArray(e.palette)
-            ? e.palette.filter((p) => typeof p === 'string' && isRenderableColor(p)).slice(0, 8)
+            ? e.palette.filter((p) => typeof p === 'string' && isRenderableColor({ value: p })).slice(0, 8)
             : [];
         const displayFont = typeof e.displayFont === 'string' ? e.displayFont : 'Georgia, serif';
         const bodyFont = typeof e.bodyFont === 'string' ? e.bodyFont : '-apple-system, system-ui, sans-serif';

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

@@ -8,9 +8,13 @@ import type { FormSegment, QuestionForm } from './types.js';
  * @complexity O(n) amortized in `input.length` — each iteration advances the
  *   cursor past the segment it just emitted.
  */
-export declare function splitOnQuestionForms(input: string): FormSegment[];
+export declare function splitOnQuestionForms({ input }: {
+    input: string;
+}): FormSegment[];
 /** The first complete, parseable `<question-form>` in `input`, or `null`. */
-export declare function findFirstQuestionForm(input: string): {
+export declare function findFirstQuestionForm({ input }: {
+    input: string;
+}): {
     form: QuestionForm;
     raw: string;
 } | null;
@@ -21,19 +25,25 @@ export declare function findFirstQuestionForm(input: string): {
  * question-form block. For a still-streaming block use
  * {@link parsePartialQuestionForm} instead.
  */
-export declare function parseQuestionForm(input: string): QuestionForm | null;
+export declare function parseQuestionForm({ input }: {
+    input: string;
+}): QuestionForm | 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 declare function stripTrailingOpenQuestionForm(input: string): {
+export declare function stripTrailingOpenQuestionForm({ input }: {
+    input: string;
+}): {
     text: string;
     hadOpenForm: boolean;
 };
 /** `true` when a question-form open tag is present but its close tag hasn't streamed in yet. */
-export declare function hasUnterminatedQuestionForm(input: string): boolean;
+export declare function hasUnterminatedQuestionForm({ input }: {
+    input: string;
+}): boolean;
 /**
  * Tolerant parser for a still-streaming `<question-form>` block. Unlike
  * {@link tryParseForm} it does not require valid, complete JSON: it reads the
@@ -46,5 +56,7 @@ export declare function hasUnterminatedQuestionForm(input: string): boolean;
  * @complexity O(n) in `input.length` (one regex scan plus a linear
  *   string-aware brace walk via {@link parsePartialJson}).
  */
-export declare function parsePartialQuestionForm(input: string): QuestionForm | null;
+export declare function parsePartialQuestionForm({ input }: {
+    input: string;
+}): QuestionForm | null;
 //# sourceMappingURL=scan.d.ts.map

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

@@ -33,7 +33,7 @@ function matchedTagAndAttrs(m) {
  * @complexity O(n) amortized in `input.length` — each iteration advances the
  *   cursor past the segment it just emitted.
  */
-export function splitOnQuestionForms(input) {
+export function splitOnQuestionForms({ input }) {
     const out = [];
     let cursor = 0;
     while (cursor < input.length) {
@@ -57,7 +57,7 @@ export function splitOnQuestionForms(input) {
             out.push({ kind: 'text', text: input.slice(cursor, openStart) });
         }
         const body = input.slice(openEnd, closeIdx);
-        const attrs = parseQuotedAttrs(rawAttrs);
+        const attrs = parseQuotedAttrs({ raw: rawAttrs });
         const form = tryParseForm(body, attrs);
         const blockEnd = closeIdx + closeTag.length;
         if (form) {
@@ -72,8 +72,8 @@ export function splitOnQuestionForms(input) {
     return out;
 }
 /** The first complete, parseable `<question-form>` in `input`, or `null`. */
-export function findFirstQuestionForm(input) {
-    for (const seg of splitOnQuestionForms(input)) {
+export function findFirstQuestionForm({ input }) {
+    for (const seg of splitOnQuestionForms({ input: input })) {
         if (seg.kind === 'form')
             return { form: seg.form, raw: seg.raw };
     }
@@ -86,8 +86,8 @@ export function findFirstQuestionForm(input) {
  * question-form block. For a still-streaming block use
  * {@link parsePartialQuestionForm} instead.
  */
-export function parseQuestionForm(input) {
-    return findFirstQuestionForm(input)?.form ?? null;
+export function parseQuestionForm({ input }) {
+    return findFirstQuestionForm({ input: input })?.form ?? null;
 }
 /**
  * Drop a trailing, not-yet-closed question-form block from streaming text so
@@ -95,7 +95,7 @@ export function parseQuestionForm(input) {
  * JSON finishes. Returns the visible text plus whether such an open block
  * existed (meaning a form is mid-generation).
  */
-export function stripTrailingOpenQuestionForm(input) {
+export function stripTrailingOpenQuestionForm({ input }) {
     let cursor = 0;
     while (cursor < input.length) {
         const slice = input.slice(cursor);
@@ -115,8 +115,8 @@ export function stripTrailingOpenQuestionForm(input) {
     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;
+export function hasUnterminatedQuestionForm({ input }) {
+    return stripTrailingOpenQuestionForm({ input: input }).hadOpenForm;
 }
 function findCloseTag(input, from, closeTag) {
     const closeLower = closeTag.toLowerCase();
@@ -154,7 +154,7 @@ function tryParseForm(body, attrs) {
         return null;
     const questions = [];
     rawQuestions.forEach((q, i) => {
-        const mapped = mapRawQuestion(q, i);
+        const mapped = mapRawQuestion({ q: q, index: i });
         if (mapped)
             questions.push(mapped);
     });
@@ -184,14 +184,14 @@ function tryParseForm(body, attrs) {
  * @complexity O(n) in `input.length` (one regex scan plus a linear
  *   string-aware brace walk via {@link parsePartialJson}).
  */
-export function parsePartialQuestionForm(input) {
+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 attrs = parseQuotedAttrs({ raw: 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
@@ -203,7 +203,7 @@ export function parsePartialQuestionForm(input) {
     // 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 parsed = parsePartialJson({ buf: 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
@@ -343,7 +343,7 @@ function shapeStreamingQuestions(rawQuestions, closedCount) {
         const hasId = typeof q.id === 'string' && q.id.trim().length > 0;
         if (!isClosed && !hasId)
             return;
-        const mapped = mapRawQuestion(raw, index);
+        const mapped = mapRawQuestion({ q: raw, index: index });
         if (mapped)
             out.push(mapped);
     });

package/dist/core/run-activity.d.ts

@@ -48,7 +48,11 @@ export interface RunActivityState {
 /** After this long with nothing new on screen, a thinking/writing line says "Still working…". */
 export declare const RUN_ACTIVITY_IDLE_MS = 20000;
 /** `"page.fill"` → `"Page Fill"`, `"mcp__supabase__list_projects"` → `"List Projects"`. Display only. */
-export declare function humanizeToolName(name: string, input?: unknown): string;
+export declare function humanizeToolName({ name }: {
+    name: string;
+}, { input }?: {
+    input?: (unknown) | undefined;
+}): string;
 /**
  * The latest signal in a running turn's events.
  *
@@ -58,9 +62,13 @@ export declare function humanizeToolName(name: string, input?: unknown): string;
  *
  * @complexity O(n) in events, O(open tool calls) extra space.
  */
-export declare function deriveRunActivity(events: readonly AgentEvent[] | undefined): RunActivityState;
+export declare function deriveRunActivity({ events }: {
+    events: readonly AgentEvent[] | undefined;
+}): RunActivityState;
 /** `4` → `"4 s"`, `80` → `"1 m 20 s"`, `120` → `"2 m 0 s"`. */
-export declare function formatActivityClock(totalSeconds: number): string;
+export declare function formatActivityClock({ totalSeconds }: {
+    totalSeconds: number;
+}): string;
 /** A translator: the chat package's `t(key, vars)`. */
 export type RunActivityTranslate = (key: string, vars?: Record<string, string | number>) => string;
 /** The clock values a label may use. */
@@ -84,5 +92,9 @@ export declare const RUN_ACTIVITY_LABELS: {
  *
  * @complexity O(1).
  */
-export declare function describeRunActivity(activity: RunActivity, clock: RunActivityClock, t: RunActivityTranslate): string;
+export declare function describeRunActivity({ activity, clock, t }: {
+    activity: RunActivity;
+    clock: RunActivityClock;
+    t: RunActivityTranslate;
+}): string;
 //# sourceMappingURL=run-activity.d.ts.map

package/dist/core/run-activity.js

@@ -24,7 +24,7 @@ function stringField(data, key) {
     return typeof value === 'string' && value ? value : undefined;
 }
 /** `"page.fill"` → `"Page Fill"`, `"mcp__supabase__list_projects"` → `"List Projects"`. Display only. */
-export function humanizeToolName(name, input) {
+export function humanizeToolName({ name }, { input } = {}) {
     const real = WRAPPER_TOOL_NAMES.has(name) ? (stringField(input, 'toolId') ?? name) : name;
     const bare = real.startsWith('mcp__') ? real.split('__').slice(2).join('__') || real : real;
     return bare
@@ -69,7 +69,7 @@ function scanEvent(scan, event, index) {
  *
  * @complexity O(n) in events, O(open tool calls) extra space.
  */
-export function deriveRunActivity(events) {
+export function deriveRunActivity({ events }) {
     const scan = { open: [], lastVisible: null, lastCardIndex: -1, retry: null, progress: null, visibleCount: 0 };
     (events ?? []).forEach((event, index) => scanEvent(scan, event, index));
     const visibleCount = scan.visibleCount;
@@ -102,7 +102,7 @@ export function deriveRunActivity(events) {
         return {
             activity: {
                 kind: 'running-tool',
-                tool: humanizeToolName(newestOpen.name, newestOpen.input),
+                tool: humanizeToolName({ name: newestOpen.name }, { input: newestOpen.input }),
                 ...(reported !== undefined ? { reportedSeconds: reported } : {}),
             },
             key: `tool:${newestOpen.id}`,
@@ -115,7 +115,7 @@ export function deriveRunActivity(events) {
     return { activity: { kind: 'thinking' }, key: `thinking:${lastVisibleIndex}`, visibleCount };
 }
 /** `4` → `"4 s"`, `80` → `"1 m 20 s"`, `120` → `"2 m 0 s"`. */
-export function formatActivityClock(totalSeconds) {
+export function formatActivityClock({ totalSeconds }) {
     const seconds = Math.max(0, Math.floor(totalSeconds));
     const minutes = Math.floor(seconds / 60);
     return minutes > 0 ? `${minutes} m ${seconds % 60} s` : `${seconds} s`;
@@ -126,14 +126,14 @@ export function formatActivityClock(totalSeconds) {
  */
 export const RUN_ACTIVITY_LABELS = {
     thinking: (_a, clock, t) => clock.idleMs >= RUN_ACTIVITY_IDLE_MS
-        ? t('Still working… {time}', { time: formatActivityClock(clock.seconds) })
-        : t('Thinking… {time}', { time: formatActivityClock(clock.seconds) }),
+        ? t('Still working… {time}', { time: formatActivityClock({ totalSeconds: clock.seconds }) })
+        : t('Thinking… {time}', { time: formatActivityClock({ totalSeconds: clock.seconds }) }),
     writing: (_a, clock, t) => clock.idleMs >= RUN_ACTIVITY_IDLE_MS
-        ? t('Still working… {time}', { time: formatActivityClock(clock.seconds) })
+        ? t('Still working… {time}', { time: formatActivityClock({ totalSeconds: clock.seconds }) })
         : t('Writing…'),
-    'finding-tool': (_a, clock, t) => t('Finding the right tool… {time}', { time: formatActivityClock(clock.seconds) }),
-    'running-tool': (a, clock, t) => t('Running {tool}… {time}', { tool: a.tool, time: formatActivityClock(clock.seconds) }),
-    'awaiting-answer': (_a, clock, t) => t('Waiting for your answer above · {time}', { time: formatActivityClock(clock.seconds) }),
+    'finding-tool': (_a, clock, t) => t('Finding the right tool… {time}', { time: formatActivityClock({ totalSeconds: clock.seconds }) }),
+    'running-tool': (a, clock, t) => t('Running {tool}… {time}', { tool: a.tool, time: formatActivityClock({ totalSeconds: clock.seconds }) }),
+    'awaiting-answer': (_a, clock, t) => t('Waiting for your answer above · {time}', { time: formatActivityClock({ totalSeconds: clock.seconds }) }),
     retrying: (a, _clock, t) => {
         const who = a.service ? t("{service}'s servers are busy", { service: a.service }) : t('The AI service is busy');
         return a.attempt !== undefined && a.maxAttempts !== undefined
@@ -146,7 +146,7 @@ export const RUN_ACTIVITY_LABELS = {
  *
  * @complexity O(1).
  */
-export function describeRunActivity(activity, clock, t) {
+export function describeRunActivity({ activity, clock, t }) {
     const label = RUN_ACTIVITY_LABELS[activity.kind];
     return label(activity, clock, t);
 }