@kitn.ai/ui 0.25.1 → 0.26.0

package/dist/solid.server.js

@@ -1,4 +1,4 @@
-import { A as e, a as t, b as o, d as r, e as n, f as i, g as c, h as d, i as C, j as l, k as b, l as g, m, n as u, B as p, o as T, p as h, q as A, r as R, t as S, u as I, v as E, x as P, y as v, z as D, D as f, E as x, F as L, G as k, H as w, I as _, J as M, K as O, L as y, M as B, N as F, M as H, O as N, P as z, Q as V, R as U, S as G, T as Y, U as K, V as W, W as j, X as q, Y as J, Z as Q, _ as X, $ as Z, a0 as $, a1 as aa, a2 as sa, a3 as ea, a4 as ta, a5 as oa, a6 as ra, a7 as na, a8 as ia, a9 as ca, aa as da, ab as Ca, ac as la, ad as ba, ae as ga, af as ma, ag as ua, ah as pa, ai as Ta, aj as ha, ak as Aa, al as Ra, am as Sa, an as Ia, ao as Ea, ap as Pa, aq as va, ar as Da, as as fa, at as xa, au as La, av as ka, aw as wa, ax as _a, ay as Ma, az as Oa, aA as ya, aB as Ba, aC as Fa, aD as Ha, aE as Na, aF as za, aG as Va, aH as Ua, aI as Ga, aJ as Ya, aK as Ka, aL as Wa, aM as ja, aN as qa, aO as Ja, aP as Qa, aQ as Xa, aR as Za, aS as $a, aT as as, aU as ss, aV as es, aW as ts, aX as os, aY as rs, aZ as ns, a_ as is, a$ as cs, b0 as ds, b1 as Cs, b2 as ls, b3 as bs, b4 as gs, b5 as ms, b6 as us, b7 as ps, b8 as Ts, b9 as hs, ba as As, bb as Rs, bc as Ss, bd as Is, be as Es, bf as Ps, bg as vs, bh as Ds, bi as fs, bj as xs, bk as Ls, bl as ks, bm as ws, bn as _s, bo as Ms, bp as Os, bq as ys, br as Bs, bs as Fs, bt as Hs, bu as Ns, bv as zs, bw as Vs, bx as Us, by as Gs, bz as Ys, bA as Ks, bB as Ws, bC as js, bD as qs, bE as Js, bF as Qs, bG as Xs, bH as Zs, bI as $s, bJ as ae, bK as se, bL as ee, bM as te, bN as oe, bO as re, bP as ne, bQ as ie, bR as ce, bS as de, bT as Ce, bU as le, bV as be, bW as ge, bX as me, bY as ue, bZ as pe, b_ as Te, b$ as he, c0 as Ae, c1 as Re, c2 as Se, c3 as Ie, c4 as Ee, c5 as Pe, c6 as ve, c as De, c7 as fe, c8 as xe, c9 as Le, ca as ke, cb as we, cc as _e, cd as Me, ce as Oe, cf as ye, cg as Be, ch as Fe, ci as He, cj as Ne, ck as ze, cl as Ve, cm as Ue, cn as Ge, co as Ye, cp as Ke, cq as We, cr as je, cs as qe, ct as Je, cu as Qe, cv as Xe, cw as Ze, cx as $e, cy as at, cz as st, cA as et, cB as tt, cC as ot, cD as rt, cE as nt, cF as it, cG as ct, cH as dt, cI as Ct, cJ as lt, cK as bt, cL as gt, cM as mt, cN as ut, cO as pt, cP as Tt, cQ as ht, cR as At, cS as Rt, cT as St, cU as It, cV as Et, cW as Pt, cX as vt, cY as Dt, cZ as ft, c_ as xt, c$ as Lt, d0 as kt, d1 as wt, d2 as _t, d3 as Mt, d4 as Ot, d5 as yt, d6 as Bt, d7 as Ft, d8 as Ht, d9 as Nt, da as zt, db as Vt, dc as Ut, dd as Gt } from "./solid-CGYNdLRR.js";
+import { A as e, b as t, d as o, e as r, f as n, g as i, h as c, i as d, j as C, k as l, l as b, m as g, n as m, o as u, B as p, p as h, q as T, r as A, t as S, u as I, v as R, x as v, y as E, z as P, D, E as k, F as f, G as L, H as x, I as w, J as _, K as y, L as O, M as B, N as M, O as F, N as H, P as N, Q as z, R as V, S as G, T as U, U as Y, V as K, W, X as j, Y as q, Z as J, _ as Q, $ as X, a0 as Z, a1 as $, a2 as aa, a3 as sa, a4 as ea, a5 as ta, a6 as oa, a7 as ra, a8 as na, a9 as ia, aa as ca, ab as da, ac as Ca, ad as la, ae as ba, af as ga, ag as ma, ah as ua, ai as pa, aj as ha, ak as Ta, al as Aa, am as Sa, an as Ia, ao as Ra, ap as va, aq as Ea, ar as Pa, as as Da, at as ka, au as fa, av as La, aw as xa, ax as wa, ay as _a, az as ya, aA as Oa, aB as Ba, aC as Ma, aD as Fa, aE as Ha, aF as Na, aG as za, aH as Va, aI as Ga, aJ as Ua, aK as Ya, aL as Ka, aM as Wa, aN as ja, aO as qa, aP as Ja, aQ as Qa, aR as Xa, aS as Za, aT as $a, aU as as, aV as ss, aW as es, aX as ts, aY as os, aZ as rs, a_ as ns, a$ as is, b0 as cs, b1 as ds, b2 as Cs, b3 as ls, b4 as bs, b5 as gs, b6 as ms, b7 as us, b8 as ps, b9 as hs, ba as Ts, bb as As, bc as Ss, bd as Is, be as Rs, bf as vs, bg as Es, bh as Ps, bi as Ds, bj as ks, bk as fs, bl as Ls, bm as xs, bn as ws, bo as _s, bp as ys, bq as Os, br as Bs, bs as Ms, bt as Fs, bu as Hs, bv as Ns, bw as zs, bx as Vs, by as Gs, bz as Us, bA as Ys, bB as Ks, bC as Ws, bD as js, bE as qs, bF as Js, bG as Qs, bH as Xs, bI as Zs, bJ as $s, bK as ae, bL as se, bM as ee, bN as te, bO as oe, bP as re, bQ as ne, bR as ie, bS as ce, bT as de, bU as Ce, bV as le, bW as be, bX as ge, bY as me, bZ as ue, b_ as pe, b$ as he, c0 as Te, c1 as Ae, c2 as Se, c3 as Ie, c4 as Re, c5 as ve, c6 as Ee, c7 as Pe, c8 as De, c9 as ke, ca as fe, cb as Le, cc as xe, c as we, cd as _e, ce as ye, cf as Oe, cg as Be, ch as Me, ci as Fe, cj as He, ck as Ne, cl as ze, cm as Ve, cn as Ge, co as Ue, cp as Ye, cq as Ke, cr as We, cs as je, ct as qe, cu as Je, cv as Qe, cw as Xe, cx as Ze, cy as $e, cz as at, cA as st, cB as et, cC as tt, cD as ot, cE as rt, cF as nt, cG as it, cH as ct, cI as dt, cJ as Ct, cK as lt, cL as bt, cM as gt, cN as mt, cO as ut, cP as pt, cQ as ht, cR as Tt, cS as At, cT as St, cU as It, cV as Rt, cW as vt, cX as Et, cY as Pt, cZ as Dt, c_ as kt, c$ as ft, d0 as Lt, d1 as xt, d2 as wt, d3 as _t, d4 as yt, d5 as Ot, d6 as Bt, d7 as Mt, d8 as Ft, d9 as Ht, da as Nt, db as zt, dc as Vt, dd as Gt, de as Ut, df as Yt, dg as Kt, dh as Wt, di as jt, dj as qt, dk as Jt, dl as Qt } from "./solid-CnavwBye.js";
 export {
   e as AgentCard,
   t as Artifact,
@@ -15,33 +15,33 @@ export {
   m as AudioVisualizer,
   u as Avatar,
   p as BUILTIN_CARD_COMPONENTS,
-  T as BUILTIN_CARD_TAGS,
-  h as Badge,
+  h as BUILTIN_CARD_TAGS,
+  T as Badge,
   A as BarsLoader,
-  R as Button,
-  S as CARD_CONTRACT_VERSION,
-  I as CARD_EVENT_NAME,
-  E as CHOICE_CARD_TYPE,
-  P as CONFIRM_CARD_TYPE,
-  v as Card,
+  S as Button,
+  I as CARD_CONTRACT_VERSION,
+  R as CARD_EVENT_NAME,
+  v as CHOICE_CARD_TYPE,
+  E as CONFIRM_CARD_TYPE,
+  P as Card,
   D as CardFallback,
-  f as CardProvider,
-  x as CardRenderer,
+  k as CardProvider,
+  f as CardRenderer,
   L as ChainOfThought,
-  k as ChainOfThoughtAccordion,
+  x as ChainOfThoughtAccordion,
   w as ChainOfThoughtContent,
   _ as ChainOfThoughtItem,
-  M as ChainOfThoughtStep,
+  y as ChainOfThoughtStep,
   O as ChainOfThoughtTrigger,
-  y as ChatConfig,
-  B as ChatContainer,
+  B as ChatConfig,
+  M as ChatContainer,
   F as ChatContainerContent,
   H as ChatContainerRoot,
   N as ChatContainerScrollAnchor,
   z as ChatScopePicker,
   V as ChatThread,
-  U as Checkpoint,
-  G as CheckpointIcon,
+  G as Checkpoint,
+  U as CheckpointIcon,
   Y as CheckpointTrigger,
   K as ChoiceCard,
   W as CircularLoader,
@@ -69,193 +69,200 @@ export {
   ma as ContextTrigger,
   ua as ConversationItem,
   pa as ConversationList,
-  Ta as DEFAULT_ARTIFACT_CARD_HEIGHT,
-  ha as Dialog,
+  ha as DEFAULT_ARTIFACT_CARD_HEIGHT,
+  Ta as Dialog,
   Aa as DismissedStub,
-  Ra as DotsLoader,
-  Sa as Dropdown,
-  Ia as DropdownCheckboxItem,
-  Ea as DropdownContent,
-  Pa as DropdownItem,
-  va as DropdownLabel,
-  Da as DropdownRadioItem,
-  fa as DropdownSeparator,
-  xa as DropdownSub,
-  La as DropdownSubContent,
-  ka as DropdownSubTrigger,
-  wa as DropdownTrigger,
-  _a as EMBED_CARD_TYPE,
+  Sa as Dock,
+  Ia as DockCloseGlyph,
+  Ra as DockLauncherGlyph,
+  va as DotsLoader,
+  Ea as Dropdown,
+  Pa as DropdownCheckboxItem,
+  Da as DropdownContent,
+  ka as DropdownItem,
+  fa as DropdownLabel,
+  La as DropdownRadioItem,
+  xa as DropdownSeparator,
+  wa as DropdownSub,
+  _a as DropdownSubContent,
+  ya as DropdownSubTrigger,
+  Oa as DropdownTrigger,
+  Ba as EMBED_CARD_TYPE,
   Ma as EditableLabel,
-  Oa as Embed,
-  ya as Empty,
-  Ba as EmptyContent,
-  Fa as EmptyDescription,
-  Ha as EmptyHeader,
-  Na as EmptyMedia,
-  za as EmptyTitle,
-  Va as FeedbackBar,
-  Ua as FileTree,
-  Ga as FileUpload,
-  Ya as FileUploadContent,
-  Ka as FileUploadTrigger,
-  Wa as Form,
-  ja as HoverCard,
-  qa as HoverCardContent,
-  Ja as HoverCardRoot,
-  Qa as HoverCardTrigger,
-  Xa as Image,
-  Za as Input,
-  $a as Kbd,
-  as as LINK_PREVIEW_TYPE,
-  ss as LinkPreview,
-  es as Loader,
-  ts as Markdown,
-  os as Message,
-  rs as MessageAction,
-  ns as MessageActions,
-  is as MessageAvatar,
-  cs as MessageBody,
-  ds as MessageContent,
-  Cs as MessageCopyButton,
-  ls as MessageSkills,
-  bs as ModelSwitcher,
-  gs as Nav,
-  ms as Notice,
-  us as OTHER_ACTION,
-  ps as Pane,
-  Ts as PaneGrid,
-  hs as PaneGroup,
-  As as Popover,
-  Rs as ProgressBar,
-  Ss as PromptDock,
-  Is as PromptInput,
-  Es as PromptInputAction,
-  Ps as PromptInputActions,
-  vs as PromptInputTextarea,
-  Ds as PromptSuggestion,
-  fs as PulseDotLoader,
-  xs as PulseLoader,
-  Ls as Reasoning,
-  ks as ReasoningContent,
-  ws as ReasoningTrigger,
-  _s as Resizable,
+  Fa as Embed,
+  Ha as Empty,
+  Na as EmptyContent,
+  za as EmptyDescription,
+  Va as EmptyHeader,
+  Ga as EmptyMedia,
+  Ua as EmptyTitle,
+  Ya as FeedbackBar,
+  Ka as FileTree,
+  Wa as FileUpload,
+  ja as FileUploadContent,
+  qa as FileUploadTrigger,
+  Ja as Form,
+  Qa as HoverCard,
+  Xa as HoverCardContent,
+  Za as HoverCardRoot,
+  $a as HoverCardTrigger,
+  as as Image,
+  ss as Input,
+  es as Kbd,
+  ts as LINK_PREVIEW_TYPE,
+  os as LinkPreview,
+  rs as Loader,
+  ns as Markdown,
+  is as Message,
+  cs as MessageAction,
+  ds as MessageActions,
+  Cs as MessageAvatar,
+  ls as MessageBody,
+  bs as MessageContent,
+  gs as MessageCopyButton,
+  ms as MessageSkills,
+  us as ModelSwitcher,
+  ps as Nav,
+  hs as Notice,
+  Ts as OTHER_ACTION,
+  As as Pane,
+  Ss as PaneGrid,
+  Is as PaneGroup,
+  Rs as Popover,
+  vs as ProgressBar,
+  Es as PromptDock,
+  Ps as PromptInput,
+  Ds as PromptInputAction,
+  ks as PromptInputActions,
+  fs as PromptInputTextarea,
+  Ls as PromptSuggestion,
+  xs as PulseDotLoader,
+  ws as PulseLoader,
+  _s as Reasoning,
+  ys as ReasoningContent,
+  Os as ReasoningTrigger,
+  Bs as Resizable,
   Ms as ResizableHandle,
-  Os as ResizablePanel,
-  ys as ResizablePanelGroup,
-  Bs as ResponseCompare,
-  Fs as ResponseStream,
-  Hs as Screen,
-  Ns as ScrollArea,
-  zs as ScrollButton,
-  Vs as Segmented,
-  Us as Separator,
-  Gs as SettingItem,
-  Ys as SettingsGroup,
-  Ks as Skeleton,
-  Ws as Source,
-  js as SourceContent,
-  qs as SourceList,
-  Js as SourceTrigger,
-  Qs as Status,
-  Xs as Switch,
-  Zs as TASKS_CARD_TYPE,
-  $s as Tabs,
-  ae as TasksCard,
-  se as TerminalLoader,
-  ee as TextBlinkLoader,
-  te as TextDotsLoader,
-  oe as TextShimmer,
-  re as TextShimmerLoader,
-  ne as Textarea,
-  ie as ThinkingBar,
-  ce as Thread,
-  de as Toast,
-  Ce as ToastRegion,
-  le as Tool,
-  be as Tooltip,
-  ge as TypingLoader,
-  me as VoiceInput,
-  ue as VoiceOutput,
-  pe as WaveLoader,
-  Te as applyResolution,
-  he as buildFileTree,
-  Ae as buildResult,
-  Re as buildSelection,
-  Se as buttonVariantForStyle,
-  Ie as buttonVariants,
-  Ee as canConfirm,
-  Pe as clampBasis,
-  ve as classifyTool,
-  De as cn,
-  fe as coerceValue,
-  xe as configureCodeHighlighting,
-  Le as configureEmbedAllowlist,
-  ke as configureLinkPreview,
-  we as configurePdfPreview,
-  _e as configureToasts,
-  Me as confirmReason,
-  Oe as createKaiChat,
-  ye as createPresence,
-  Be as defaultActionId,
-  Fe as defaultIsReopenable,
-  He as dismissRecovery,
-  Ne as emitCardEvent,
-  ze as emptyMediaVariants,
-  Ve as ensureToastRegion,
-  Ue as firstEnabledIndex,
-  Ge as getAttachmentLabel,
-  Ye as getMediaCategory,
-  Ke as getToasts,
-  We as hasLinkPreviewFetcher,
-  je as initialSelected,
-  qe as isAnyStreaming,
-  Je as isCodeHighlightingEnabled,
-  Qe as isGenericOriginAllowed,
-  Xe as isMaxReached,
-  Ze as isPdfPreviewEnabled,
-  $e as listenForCardEvents,
-  at as mergeCardComponents,
-  st as mergeCardTags,
-  et as mountRemoteCard,
-  tt as nextEnabledIndex,
-  ot as normalizeActions,
-  rt as normalizeCandidates,
-  nt as normalizeOptions,
-  it as normalizeSize,
-  ct as normalizeTasks,
-  dt as orderedKeys,
-  Ct as parseVimeoId,
-  lt as parseYouTubeId,
-  bt as proseClass,
-  gt as renderCard,
-  mt as renderIcon,
-  ut as resolutionFromEvent,
-  pt as resolveEmbed,
-  Tt as resolveLinkMetadata,
-  ht as resolveOtherConfig,
-  At as resolveToPx,
-  Rt as routeCardEvent,
-  St as selectAllState,
-  It as selectedInOrder,
-  Et as showSelectAll,
-  Pt as stubIntent,
-  vt as textClass,
-  Dt as toast,
-  ft as toggleableIds,
-  xt as useAttachmentContext,
-  Lt as useAttachmentsContext,
-  kt as useAutoResize,
-  wt as useCardHost,
-  _t as useChatConfig,
-  Mt as useChatContainer,
-  Ot as useDismiss,
-  yt as usePosition,
-  Bt as usePromptInput,
-  Ft as useResolved,
-  Ht as useStickToBottom,
-  Nt as useTextStream,
-  zt as useVoiceRecorder,
-  Vt as validateAgainstSchema,
-  Ut as validateForm,
-  Gt as widgetFor
+  Fs as ResizablePanel,
+  Hs as ResizablePanelGroup,
+  Ns as ResponseCompare,
+  zs as ResponseStream,
+  Vs as Screen,
+  Gs as ScrollArea,
+  Us as ScrollButton,
+  Ys as Segmented,
+  Ks as Separator,
+  Ws as SettingItem,
+  js as SettingsGroup,
+  qs as Skeleton,
+  Js as SlottedConversationItem,
+  Qs as Source,
+  Xs as SourceContent,
+  Zs as SourceList,
+  $s as SourceTrigger,
+  ae as Status,
+  se as Switch,
+  ee as TASKS_CARD_TYPE,
+  te as Tabs,
+  oe as TasksCard,
+  re as TerminalLoader,
+  ne as TextBlinkLoader,
+  ie as TextDotsLoader,
+  ce as TextShimmer,
+  de as TextShimmerLoader,
+  Ce as Textarea,
+  le as ThinkingBar,
+  be as Thread,
+  ge as Toast,
+  me as ToastRegion,
+  ue as Tool,
+  pe as Tooltip,
+  he as TypingLoader,
+  Te as VoiceInput,
+  Ae as VoiceOutput,
+  Se as WaveLoader,
+  Ie as WorkspaceShell,
+  Re as applyResolution,
+  ve as buildFileTree,
+  Ee as buildResult,
+  Pe as buildSelection,
+  De as buttonVariantForStyle,
+  ke as buttonVariants,
+  fe as canConfirm,
+  Le as clampBasis,
+  xe as classifyTool,
+  we as cn,
+  _e as coerceValue,
+  ye as configureCodeHighlighting,
+  Oe as configureEmbedAllowlist,
+  Be as configureLinkPreview,
+  Me as configurePdfPreview,
+  Fe as configureToasts,
+  He as confirmReason,
+  Ne as createConversationItemsController,
+  ze as createKaiChat,
+  Ve as createPresence,
+  Ge as defaultActionId,
+  Ue as defaultIsReopenable,
+  Ye as dismissRecovery,
+  Ke as emitCardEvent,
+  We as emptyMediaVariants,
+  je as ensureToastRegion,
+  qe as firstEnabledIndex,
+  Je as getAttachmentLabel,
+  Qe as getMediaCategory,
+  Xe as getToasts,
+  Ze as hasLinkPreviewFetcher,
+  $e as initialSelected,
+  at as isAnyStreaming,
+  st as isCodeHighlightingEnabled,
+  et as isGenericOriginAllowed,
+  tt as isMaxReached,
+  ot as isPdfPreviewEnabled,
+  rt as listenForCardEvents,
+  nt as mergeCardComponents,
+  it as mergeCardTags,
+  ct as mountRemoteCard,
+  dt as nextEnabledIndex,
+  Ct as normalizeActions,
+  lt as normalizeCandidates,
+  bt as normalizeOptions,
+  gt as normalizeSize,
+  mt as normalizeTasks,
+  ut as orderedKeys,
+  pt as parseVimeoId,
+  ht as parseYouTubeId,
+  Tt as proseClass,
+  At as readConversationItemId,
+  St as renderCard,
+  It as renderIcon,
+  Rt as resolutionFromEvent,
+  vt as resolveEmbed,
+  Et as resolveLinkMetadata,
+  Pt as resolveOtherConfig,
+  Dt as resolveToPx,
+  kt as routeCardEvent,
+  ft as selectAllState,
+  Lt as selectedInOrder,
+  xt as showSelectAll,
+  wt as stubIntent,
+  _t as textClass,
+  yt as toast,
+  Ot as toggleableIds,
+  Bt as useAttachmentContext,
+  Mt as useAttachmentsContext,
+  Ft as useAutoResize,
+  Ht as useCardHost,
+  Nt as useChatConfig,
+  zt as useChatContainer,
+  Vt as useDismiss,
+  Gt as usePosition,
+  Ut as usePromptInput,
+  Yt as useResolved,
+  Kt as useStickToBottom,
+  Wt as useTextStream,
+  jt as useVoiceRecorder,
+  qt as validateAgainstSchema,
+  Jt as validateForm,
+  Qt as widgetFor
 };

package/dist/state/index.d.ts

@@ -4,6 +4,10 @@ export { createAssistantStream, onStreamSettled } from './stream.js';
 export type { SetMessages, AssistantStream } from './stream.js';
 export { appendTextPart, appendReasoningPart, upsertToolPart, upsertCardPart, fingerprint } from './parts.js';
 export type { ReasoningOpts } from './parts.js';
+export { updateThreadMessages, bindThreadMessages, createThreadSessions } from './threads.js';
+export type { ThreadLike, SetThreads, BindThreadOptions, ThreadSessions } from './threads.js';
+export { parseStoredThread, createSaveScheduler } from './persistence.js';
+export type { ParsedThread, DroppedStored, SaveScheduler, SaveSchedulerOptions } from './persistence.js';
 export { createMockResponder, DEFAULT_MOCK_REPLIES, MOCK_BANNER, MOCK_MARKER, MOCK_MARKER_KEY, MOCK_MODEL_ID } from './mock.js';
 export type { MockResponder, MockResponderOptions } from './mock.js';
 export type { ChatMessage, ChatMessageAction, CustomAction, AvatarData, FeedbackVote, MessagePart, MessageSource, RawOrigin, } from '../elements/chat-types.js';

package/dist/state/persistence.d.ts

@@ -0,0 +1,51 @@
+import { ChatMessage } from '../elements/chat-types.js';
+/** One record the parse refused, and why. Deciding loudly is the caller's
+ *  verb (warn, reject the whole record, count it); this is the information
+ *  that a quiet version would withhold. */
+export interface DroppedStored {
+    at: 'thread' | 'message' | 'part';
+    reason: string;
+    value: unknown;
+}
+export interface ParsedThread {
+    messages: ChatMessage[];
+    /** Empty on a clean parse. Never silently shorter output than input. */
+    dropped: DroppedStored[];
+}
+/**
+ * Validate a stored thread — the JSON-parsed value of one thread's messages
+ * array — back into `ChatMessage[]`. Never throws: unreadable records are
+ * DROPPED and reported in `dropped`, so a truncated write loses one record,
+ * not every conversation. What to DO about a drop (warn, discard the whole
+ * record, telemetry) is the caller's policy.
+ */
+export declare function parseStoredThread(value: unknown): ParsedThread;
+export interface SaveSchedulerOptions {
+    /** The quiet period before a scheduled snapshot is written. This is policy
+     *  and therefore REQUIRED — the kit ships no default debounce. */
+    delayMs: number;
+    /** The scheduler the seam runs on. Defaults to the global timers; inject
+     *  your own for tests or a non-timer scheduler. */
+    setTimeout?: (fn: () => void, ms: number) => unknown;
+    clearTimeout?: (handle: unknown) => void;
+}
+export interface SaveScheduler<T> {
+    /** Remember `snapshot` as the latest state and (re)start the quiet-period
+     *  timer. Call it on every state change; only the last snapshot inside the
+     *  quiet period is written. */
+    schedule(snapshot: T): void;
+    /** Write the pending snapshot NOW and disarm the timer — the
+     *  `beforeunload`/`visibilitychange` story, so a tab closed mid-stream still
+     *  persists. No-op when nothing is pending: the last write already happened. */
+    flush(): void;
+    /** Drop the pending write unsaved (e.g. unmount-without-persist). */
+    cancel(): void;
+    pending(): boolean;
+}
+/**
+ * The debounce/flush seam: a streaming reply lands a state update per token,
+ * and without this shape so would the consumer's storage backend. The kit owns
+ * only the timer dance; `save` (WHAT and WHERE, including its own try/catch
+ * policy for quota errors) and `delayMs` (HOW LONG) are the consumer's.
+ */
+export declare function createSaveScheduler<T>(save: (snapshot: T) => void, opts: SaveSchedulerOptions): SaveScheduler<T>;

package/dist/state/stream.d.ts

@@ -36,6 +36,56 @@ export interface AssistantStream {
     addSource(source: Unmixed<Source>): AssistantStream;
     addFile(attachment: AttachmentData): AssistantStream;
     done(): void;
+    /** Settles the turn as FAILED and puts `reason` where the reader can find it.
+     *
+     *  WHERE THE REASON LANDS, in order:
+     *  1. every tool part that has NOT produced a result flips to `output-error`
+     *     with `errorText: reason`, so no panel spins forever. A tool ALREADY in
+     *     `output-error` with its own non-empty `errorText` is left exactly as it
+     *     is: "search index offline" is the answer to what went wrong and
+     *     "Connection lost." is the generic outer symptom, so overwriting the
+     *     specific with the generic loses the only actionable thing on the
+     *     message. It still counts as carrying the failure. A tool in
+     *     `output-error` with NO text does get filled in — an error panel with
+     *     nothing in it says no more than a blank bubble does.
+     *  2. if no part was able to carry it, the reason is APPENDED as its own text
+     *     part.
+     *
+     *  Never both — a turn does not report the same failure twice.
+     *
+     *  "Where the reader can FIND it" is deliberate, and rule 1 and rule 2 are not
+     *  equally loud. Rule 2 is text in the thread: read without any interaction.
+     *  Rule 1 is a tool panel, which renders COLLAPSED — the header shows an error
+     *  icon and a badge, so the failure is unmissable, but the `errorText` itself
+     *  is one click away. That is the right default for a failed tool inside an
+     *  otherwise readable answer, and it is why rule 2 exists rather than always
+     *  stamping the panel and calling it reported.
+     *
+     *  Rule 2 is the whole point and it used to be missing. `abort` only ever did
+     *  rule 1, so a TEXT-ONLY turn — every turn of a text-only support widget —
+     *  had nothing to stamp: the string was discarded and a failed request
+     *  rendered an EMPTY assistant bubble, while the consumer that passed a
+     *  perfectly good sentence believed it had reported the failure. That is the
+     *  repo's "decide loudly" rule broken on the one path where being quiet is
+     *  worst, and it shipped because the discard is invisible from the call site.
+     *
+     *  It is a NEW part, never a merge onto the trailing text: gluing "Connection
+     *  lost." onto the model's half-finished sentence reads as the model saying
+     *  it. Text that already streamed stays exactly where it is.
+     *
+     *  The reason is TRIMMED, and `abort()` with no reason — or one that is empty
+     *  or all whitespace — appends nothing: there is no reason to discard, and the
+     *  kit will not invent copy the consumer did not write. Rule 1 still runs,
+     *  with `errorText: undefined`. Whitespace is not a pedantic case here: the
+     *  scaffold hands over `err.message`, and an `Error` is free to carry `''`,
+     *  which would otherwise render an INVISIBLE text part — a blank bubble that
+     *  also claims to have said something.
+     *
+     *  Settled is settled: after `done()` or a first `abort()`, this is a no-op
+     *  like every other mutator, so the reason cannot be appended twice.
+     *
+     *  The reason is CONSUMER-facing text and is rendered as markdown like any
+     *  other text part. Pass a sentence a visitor can read, not a stack trace. */
     abort(reason?: string): void;
 }
 /** Start an assistant message and drive it through `set`. New refs on every mutation. */

package/dist/state/threads.d.ts

@@ -0,0 +1,71 @@
+import { ChatMessage } from '../elements/chat-types.js';
+import { SetMessages } from './stream.js';
+/** The minimal thread record the fold needs. The consumer's own record type
+ *  (title, timestamps, whatever its storage keeps) extends this — those fields
+ *  are policy and stay outside the kit. */
+export interface ThreadLike {
+    id: string;
+    messages: ChatMessage[];
+}
+/** The functional-updater setter over the whole thread LIST — the same
+ *  React-setState shape `SetMessages` is, one level up. */
+export type SetThreads<T extends ThreadLike> = (updater: (prev: T[]) => T[]) => void;
+export interface BindThreadOptions<T extends ThreadLike> {
+    /** Stamp the changed record (e.g. `updatedAt`). Runs on a hit only. Kept a
+     *  callback because WHAT gets stamped — and with whose clock — is the
+     *  consumer's record shape, not ours. */
+    touch?: (thread: T) => T;
+    /** A delta arrived for a thread that is no longer in the list (deleted while
+     *  its reply was streaming). The delta is dropped either way — dropping is
+     *  the only correct fold — but the drop is reported, not silent. */
+    onDrop?: (threadId: string) => void;
+}
+/**
+ * Pure fold: apply `updater` to the messages of thread `id` within a list.
+ *
+ * reactivity-two-halves (CLAUDE.md): the hit gets a NEW containing array
+ * (which notifies) and a NEW record object (which makes the change visible);
+ * every other record keeps its reference. A MISS returns `threads` itself —
+ * the same reference — so a late delta for a deleted thread re-renders
+ * nothing and resurrects nothing.
+ */
+export declare function updateThreadMessages<T extends ThreadLike>(threads: T[], id: string, updater: (prev: ChatMessage[]) => ChatMessage[], opts?: BindThreadOptions<T>): T[];
+/**
+ * A `SetMessages` bound to ONE thread. Capture the id when the user hits send
+ * and hand the result to `createAssistantStream`: the reply then lands in the
+ * thread that was open at send time, never whichever one is open when the
+ * tokens arrive — which is what makes switching away mid-reply (and coming
+ * back to a finished answer) safe.
+ */
+export declare function bindThreadMessages<T extends ThreadLike>(setThreads: SetThreads<T>, id: string, opts?: BindThreadOptions<T>): SetMessages;
+/** The in-flight-turn bookkeeping for a multi-thread app: which threads are
+ *  streaming, and the AbortController for each. See `createThreadSessions`. */
+export interface ThreadSessions {
+    /** Register a new in-flight turn. One turn per thread: a prior in-flight
+     *  turn for the SAME thread is aborted first. Pass the returned controller's
+     *  `signal` to your fetch — the fetch line itself stays yours. */
+    begin(threadId: string): AbortController;
+    /** The turn settled (done or failed) — call from your `finally`. `controller`
+     *  is required so a slow old turn's cleanup cannot clear a newer turn that
+     *  has since begun on the same thread: a stale controller is a no-op. */
+    end(threadId: string, controller: AbortController): void;
+    /** Cancel the in-flight turn (the delete-under-stream story): aborts the
+     *  controller and clears the streaming state. Returns whether anything was
+     *  actually in flight. Pair it with the id-bound sink above, which drops any
+     *  deltas that were already past the abort. */
+    abort(threadId: string): boolean;
+    isStreaming(threadId: string): boolean;
+    /** A fresh array snapshot each call — safe to hand straight to a setState. */
+    streamingIds(): string[];
+}
+/**
+ * Create the session tracker. `onChange` fires with a fresh `streamingIds()`
+ * snapshot after every transition — mirror it into your framework's state to
+ * derive `loading` (`sessions.isStreaming(activeId)` is the per-thread flag a
+ * single boolean cannot be, because a stream keeps running when you switch
+ * away).
+ *
+ * This is the one stateful object in the module, because an abort map is
+ * irreducibly stateful; it still does no I/O and owns no timer.
+ */
+export declare function createThreadSessions(onChange?: (streamingIds: string[]) => void): ThreadSessions;