@revolist/ui 4.0.1-rc → 4.0.3-rc

package/activity-message.d.ts

@@ -1,4 +1,4 @@
-import { h, ComponentChildren } from 'preact';
+import { h, ComponentChildren } from './_vendor/preact/src/index';
 export interface ActivityMessageProps {
     className?: string;
     avatar: ComponentChildren;

package/activity-message.js

@@ -1,40 +1,40 @@
-import { jsx as e, jsxs as t } from "preact/jsx-runtime";
+import { t as e } from "./_chunks/jsxRuntime.module-F6UFnpT-.js";
 //#region src/activity-message.tsx
-function n({ className: n = "", avatar: r, timestamp: i, header: a, children: o, actions: s, details: c }) {
-	return /* @__PURE__ */ t("article", {
-		class: `rv-activity-message ${n}`,
+function t({ className: t = "", avatar: n, timestamp: r, header: i, children: a, actions: o, details: s }) {
+	return /* @__PURE__ */ e("article", {
+		class: `rv-activity-message ${t}`,
 		children: [
 			/* @__PURE__ */ e("div", {
 				class: "rv-activity-message-avatar",
-				children: r
+				children: n
 			}),
-			/* @__PURE__ */ t("div", {
+			/* @__PURE__ */ e("div", {
 				class: "rv-activity-message-card",
 				children: [
-					a && /* @__PURE__ */ e("div", {
+					i && /* @__PURE__ */ e("div", {
 						class: "rv-activity-message-header",
-						children: a
+						children: i
 					}),
 					/* @__PURE__ */ e("div", {
-						class: `rv-activity-message-content${a ? " rv-activity-message-content--full" : ""}`,
-						children: o
+						class: `rv-activity-message-content${i ? " rv-activity-message-content--full" : ""}`,
+						children: a
 					}),
 					/* @__PURE__ */ e("div", {
 						class: "rv-activity-message-time",
-						children: i
+						children: r
 					}),
-					s && /* @__PURE__ */ e("div", {
+					o && /* @__PURE__ */ e("div", {
 						class: "rv-activity-message-actions",
-						children: s
+						children: o
 					})
 				]
 			}),
-			c && /* @__PURE__ */ e("div", {
+			s && /* @__PURE__ */ e("div", {
 				class: "rv-activity-message-details",
-				children: c
+				children: s
 			})
 		]
 	});
 }
 //#endregion
-export { n as ActivityMessage };
+export { t as ActivityMessage };

package/ai/_chat.scss

@@ -0,0 +1,195 @@
+.rv-ai-chat {
+  display: flex;
+  flex-direction: column;
+  min-width: 0;
+  min-height: 0;
+  width: 100%;
+  height: 100%;
+  color: var(--rv-ui-text);
+  background: var(--rv-ui-surface);
+  font: 400 0.875rem/1.55 var(--rv-ai-font, system-ui, sans-serif);
+}
+.rv-ai-chat-scroll {
+  position: relative;
+  display: flex;
+  flex: 1;
+  min-height: 0;
+  min-width: 0;
+}
+.rv-ai-chat-viewport {
+  flex: 1;
+  min-width: 0;
+  overflow: auto;
+  overscroll-behavior: contain;
+  overflow-anchor: none;
+  scrollbar-gutter: stable;
+  &:focus-visible {
+    outline: 2px solid var(--rv-ui-accent);
+    outline-offset: -2px;
+  }
+}
+.rv-ai-chat-content {
+  display: flex;
+  flex-direction: column;
+  gap: 1.5rem;
+  min-height: 100%;
+  padding: 1.25rem;
+}
+.rv-ai-chat-empty {
+  margin: auto;
+  text-align: center;
+  max-width: 24rem;
+  padding-block: 2rem;
+}
+.rv-ai-chat-empty p {
+  color: var(--rv-ui-text-muted);
+  margin-block: 0.5rem;
+}
+.rv-ai-chat-jump.rv-btn {
+  position: absolute;
+  inset-block-end: 0.75rem;
+  inset-inline-start: 50%;
+  transform: translateX(-50%);
+  box-shadow: 0 2px 12px var(--rv-ui-focus-ring);
+  white-space: nowrap;
+}
+.rv-ai-chat-composer {
+  flex: none;
+  padding: 0.75rem 1rem 1rem;
+}
+.rv-ai-message {
+  display: flex;
+  flex-direction: column;
+  gap: 0.625rem;
+  min-width: 0;
+  max-width: 100%;
+  align-self: flex-start;
+}
+.rv-ai-message-content {
+  white-space: pre-wrap;
+  overflow-wrap: anywhere;
+  min-width: 0;
+}
+.rv-ai-message--user {
+  align-self: flex-end;
+  max-width: 85%;
+  .rv-ai-message-content {
+    padding: 0.625rem 1rem;
+    border-radius: 1.125rem;
+    background: var(--rv-ui-surface-sunken);
+  }
+  .rv-ai-message-actions {
+    justify-content: flex-end;
+  }
+}
+.rv-ai-message--system {
+  color: var(--rv-ui-text-muted);
+  font-size: 0.8125rem;
+  align-self: center;
+}
+.rv-ai-message-actions {
+  display: flex;
+  align-items: center;
+  flex-wrap: wrap;
+  gap: 0.25rem;
+}
+.rv-ai-trace {
+  font-size: 0.8125rem;
+  min-width: 0;
+}
+.rv-ai-trace > .rv-disclosure-summary {
+  display: flex;
+  align-items: center;
+  gap: 0.5rem;
+  padding: 0.25rem 0;
+  color: var(--rv-ui-text-muted);
+  cursor: pointer;
+}
+.rv-ai-trace-heading {
+  display: inline-flex;
+  align-items: center;
+  gap: 0.5rem;
+  min-width: 0;
+  overflow-wrap: anywhere;
+}
+.rv-ai-trace-content {
+  padding: 0.625rem 0 0.25rem 1rem;
+  margin-inline-start: 0.5rem;
+  border-inline-start: 1px solid var(--rv-ui-border);
+  white-space: pre-wrap;
+  overflow-wrap: anywhere;
+}
+.rv-ai-task-item {
+  display: flex;
+  align-items: flex-start;
+  gap: 0.5rem;
+  padding-block: 0.3rem;
+}
+.rv-ai-task-icon {
+  display: inline-flex;
+  width: 1rem;
+  height: 1.25rem;
+  flex: none;
+  align-items: center;
+  justify-content: center;
+  svg {
+    width: 0.875rem;
+    height: 0.875rem;
+  }
+  &[data-status='error'] {
+    color: var(--rv-ui-danger);
+  }
+  &[data-status='running'] {
+    color: var(--rv-ui-accent);
+  }
+}
+@media (max-width: 480px) {
+  .rv-ai-chat-content {
+    padding: 1rem;
+  }
+  .rv-ai-message--user {
+    max-width: 95%;
+  }
+}
+
+.rv-ai-trace-chevron {
+  display: inline-flex;
+  align-items: center;
+}
+.rv-ai-trace[open] .rv-ai-trace-chevron {
+  transform: rotate(180deg);
+}
+
+.rv-ai-trace-line {
+  color: var(--rv-ui-text-muted);
+  padding-block: 0.25rem;
+}
+
+// Mounted assistants keep the composer in normal flow above the grid.
+.rv-ai-mounted-chat {
+  height: auto;
+  .rv-ai-chat-viewport {
+    min-height: 0;
+    max-height: min(18rem, 40vh);
+  }
+  .rv-ai-chat-content {
+    min-height: 0;
+    padding: 0.75rem 0;
+    &:empty {
+      padding: 0;
+    }
+  }
+  .rv-ai-chat-composer {
+    padding: 0.75rem 0 0;
+  }
+}
+.rv-ai-chat-result {
+  max-width: 100%;
+  margin: 0;
+  padding: 0.625rem;
+  border-radius: 0.5rem;
+  background: var(--rv-ui-surface-sunken);
+  font: inherit;
+  white-space: pre-wrap;
+  overflow-wrap: anywhere;
+}

package/ai/_style.scss

@@ -1,3 +1,4 @@
+@use './chat';
 .rv-ai-assistant {
   box-sizing: border-box;
   width: 100%;
@@ -18,11 +19,12 @@
   min-width: 0;
 }
 .rv-ai-prompt-composer {
-  display: flex;
-  flex-direction: column;
+  display: grid;
+  grid-template-columns: minmax(0, 1fr) auto;
+  align-items: end;
   min-width: 0;
   border: 1px solid var(--rv-ui-border);
-  border-radius: calc(var(--rv-ui-radius, 6px) + 10px);
+  border-radius: 24px;
   background: var(--rv-ui-surface-sunken);
   transition:
     border-color var(--rv-ui-motion-fast, 120ms) var(--rv-ui-motion-ease, ease),
@@ -34,10 +36,12 @@
   }
 }
 .rv-ai-prompt-composer textarea.rv-control {
+  grid-column: 1;
+  grid-row: 1;
   display: block;
-  min-height: 4.75rem;
+  min-height: 1.5rem;
   max-height: 12rem;
-  padding: 0.875rem 1rem 0.5rem;
+  padding: 0.75rem 1rem;
   border: 0;
   border-radius: inherit;
   background: transparent;
@@ -52,25 +56,44 @@
   }
 }
 .rv-ai-prompt-toolbar {
+  grid-column: 2;
+  grid-row: 1;
   display: flex;
   gap: 0.75rem;
   align-items: center;
   justify-content: space-between;
   min-width: 0;
-  padding: 0.375rem 0.625rem 0.625rem 1rem;
+  padding: 0.5rem 0.5rem 0.5rem 0;
 }
 .rv-ai-prompt-footer {
+  grid-column: 1 / -1;
+  grid-row: 2;
   min-width: 0;
   margin-inline: 1rem;
-  padding-block: 0.625rem 0.25rem;
-  border-block-start: 1px solid var(--rv-ui-border);
+  padding-block: 0.625rem;
   &:empty {
     display: none;
   }
 }
+.rv-ai-prompt-composer:has(.rv-ai-prompt-hint) {
+  grid-template-columns: minmax(0, 1fr);
+  .rv-ai-prompt-toolbar {
+    grid-column: 1;
+    grid-row: 3;
+    padding-inline-start: 1rem;
+  }
+}
 .rv-ai-request-trail {
   min-width: 0;
 }
+.rv-ai-request-trail .rv-ai-trail-trigger {
+  color: var(--rv-ui-accent-text);
+  background: var(--rv-ui-selected-bg);
+  &:hover:not(:disabled), &:focus-visible {
+    color: var(--rv-ui-accent-text);
+    background: var(--rv-ui-selected-bg);
+  }
+}
 .rv-ai-trail-trigger .rv-svg-icon {
   transition: transform var(--rv-ui-motion-fast, 120ms)
     var(--rv-ui-motion-ease, ease);
@@ -84,63 +107,86 @@
   max-width: calc(100% - 16px);
   max-height: min(30rem, calc(100dvh - 16px));
   padding: 0;
+  border-radius: 12px;
   font: inherit;
   &:focus {
     outline: none;
   }
 }
 .rv-ai-trail-header {
-  padding: 0.75rem 0.875rem 0.5rem;
+  padding: 0.875rem 1rem 0.625rem;
 }
 .rv-ai-trail-label {
   display: flex;
   align-items: center;
   gap: 0.5rem;
-  color: var(--rv-ui-text-muted);
+  color: var(--rv-ui-text);
   font-size: 0.75rem;
   font-weight: var(--rv-ui-font-weight-medium, 500);
 }
 .rv-ai-trail-steps {
   display: flex;
   flex-direction: column;
-  gap: 0.375rem;
+  gap: 0.25rem;
   min-width: 0;
   margin: 0;
-  padding: 0 0.5rem 0.5rem;
+  padding: 0 0.5rem 0.625rem;
   list-style: none;
 }
+.rv-ai-step {
+  position: relative;
+  &:not(:last-child)::before {
+    content: '';
+    position: absolute;
+    left: 20px;
+    top: 32px;
+    bottom: -12px;
+    width: 1px;
+    background: var(--rv-ui-border);
+  }
+}
 .rv-ai-step-chip {
   display: flex;
   align-items: flex-start;
   gap: 0.625rem;
   min-width: 0;
   padding: 0.5rem;
-  border: 1px solid var(--rv-ui-border);
-  border-radius: var(--rv-ui-radius, 6px);
-  background: var(--rv-ui-surface);
+  border: 0;
+  border-radius: 8px;
+  background: transparent;
   color: var(--rv-ui-text);
 }
+.rv-ai-step:hover .rv-ai-step-chip,
+.rv-ai-step:focus-within .rv-ai-step-chip {
+  background: var(--rv-ui-surface-hover);
+}
 .rv-ai-step[data-current] .rv-ai-step-chip {
-  background: var(--rv-ui-selected-bg);
-  border-color: color-mix(
-    in srgb,
-    var(--rv-ui-accent) 30%,
-    var(--rv-ui-border)
-  );
+  background: color-mix(in srgb, var(--rv-ui-selected-bg) 55%, var(--rv-ui-surface));
 }
 .rv-ai-step-number {
+  position: relative;
+  box-sizing: border-box;
   flex: none;
-  min-width: 1.25rem;
-  padding-block: 0.25rem;
+  min-width: 24px;
+  height: 24px;
+  margin-block: 2px;
+  padding: 0 4px;
+  border-radius: 999px;
+  background: var(--rv-ui-surface-sunken);
   color: var(--rv-ui-text-muted);
   font-size: 0.6875rem;
   font-variant-numeric: tabular-nums;
   text-align: center;
+  line-height: 24px;
+}
+.rv-ai-step[data-current] .rv-ai-step-number {
+  background: var(--rv-ui-accent);
+  color: var(--rv-ui-accent-contrast, #fff);
 }
 .rv-ai-step-label {
   flex: 1;
   min-width: 0;
-  padding-block: 0.1875rem;
+  padding-block: 0.25rem;
   overflow-wrap: anywhere;
   white-space: pre-wrap;
   font-size: 0.75rem;
@@ -178,27 +224,43 @@
   overflow-wrap: anywhere;
 }
 .rv-ai-prompt-toolbar .rv-ai-prompt-submit {
-  --rv-icon-button-size: 32px;
+  --rv-icon-button-size: 30px;
+  min-height: var(--rv-icon-button-size);
   flex: 0 0 auto;
-  padding: 0.5rem;
+  padding: 0.25rem;
   border-radius: 50%;
 }
 .rv-ai-suggestions {
   display: flex;
-  gap: 0.5rem;
+  flex-wrap: wrap;
+  align-items: center;
+  gap: 0.375rem;
   min-width: 0;
-  overflow-x: auto;
-  overscroll-behavior-x: contain;
-  scroll-padding-inline: 4px;
-  scrollbar-width: thin;
-  // Give keyboard focus outlines room inside the scrolling row.
+  // Leave room for focus outlines.
   padding: 4px;
   margin: -4px;
 }
+.rv-ai-suggestions .dropdown-container.rv-ai-examples {
+  flex: 0 0 28px;
+  width: 28px;
+  height: 28px;
+}
+.rv-ai-examples .dropdown-trigger {
+  justify-content: center;
+  width: 28px;
+  height: 28px;
+  padding: 0;
+  border: 0;
+  border-radius: var(--rv-ui-radius, 6px);
+  background: transparent;
+  color: var(--rv-ui-text);
+  font-size: 0.75rem;
+  line-height: 1.25;
+}
 .rv-ai-suggestions .rv-ai-suggestion {
   flex: 0 0 auto;
-  min-height: 32px;
-  padding: 0.5rem 0.75rem;
+  min-height: 28px;
+  padding: 0.25rem 0.625rem;
   border-radius: 999px;
   font-size: 0.75rem;
   line-height: 1.25;
@@ -250,3 +312,12 @@
     outline-offset: 2px;
   }
 }
+
+.rv-ai-result-details {
+  margin: 0;
+  max-height: 16rem;
+  overflow: auto;
+  white-space: pre-wrap;
+  overflow-wrap: anywhere;
+  font-size: 0.875em;
+}

package/ai/chat.d.ts

@@ -0,0 +1,63 @@
+import { h, ComponentChildren, JSX } from '../_vendor/preact/src/index';
+import { AiPromptInputProps } from './components';
+import { AiUiTranslations } from './translations';
+export interface AiChatPartProps {
+    children?: ComponentChildren;
+    className?: string;
+    translations?: AiUiTranslations;
+}
+export interface AiChatProps extends AiChatPartProps {
+    label?: string;
+    style?: JSX.CSSProperties;
+}
+/** Presentation only. The host owns transcript, provider, actions and persistence. */
+export declare function AiChat({ children, className, label, style, translations, }: AiChatProps): h.JSX.Element;
+export interface AiChatContentProps extends AiChatPartProps {
+    label?: string;
+    /** Follow updates only while the reader remains at the live edge. */
+    autoScroll?: boolean;
+    busy?: boolean;
+    jumpLabel?: string;
+}
+/** Scroll measurement belongs to this visual viewport, never to a grid/data owner. */
+export declare function AiChatContent({ children, className, autoScroll, busy, label, jumpLabel, translations, }: AiChatContentProps): h.JSX.Element;
+export interface AiChatEmptyStateProps extends AiChatPartProps {
+    title?: string;
+    description?: string;
+}
+export declare function AiChatEmptyState({ title, description, children, className, translations, }: AiChatEmptyStateProps): h.JSX.Element;
+/** Existing composer behavior, with chat-specific defaults. */
+export declare function AiChatComposer(props: AiPromptInputProps): h.JSX.Element;
+export interface AiMessageProps extends AiChatPartProps {
+    from: 'user' | 'assistant' | 'system';
+    label?: string;
+    isStreaming?: boolean;
+}
+export declare function AiMessage({ from, label, isStreaming, children, className, translations, }: AiMessageProps): h.JSX.Element;
+/** Text stays text. Hosts can supply their own trusted Markdown renderer as children. */
+export declare function AiMessageContent({ children, className, }: AiChatPartProps): h.JSX.Element;
+export interface AiMessageActionsProps extends AiChatPartProps {
+    label?: string;
+}
+export declare function AiMessageActions({ children, className, label, translations, }: AiMessageActionsProps): h.JSX.Element;
+export type AiTaskStatus = 'pending' | 'running' | 'completed' | 'error' | 'cancelled';
+export interface AiTaskProps extends AiChatPartProps {
+    title: string;
+    status?: AiTaskStatus;
+    open?: boolean;
+    defaultOpen?: boolean;
+    onOpenChange?(open: boolean): void;
+}
+export declare function AiTask(props: AiTaskProps): h.JSX.Element;
+export interface AiTaskItemProps extends AiChatPartProps {
+    status?: AiTaskStatus;
+}
+export declare function AiTaskItem({ status, children, className, translations, }: AiTaskItemProps): h.JSX.Element;
+export interface AiReasoningProps extends Omit<AiTaskProps, 'title' | 'status'> {
+    title?: string;
+    isStreaming?: boolean;
+    /** Host-supplied elapsed seconds; no hidden timer or invented reasoning. */
+    duration?: number;
+}
+/** Render only reasoning/summary text explicitly supplied by the host or provider. */
+export declare function AiReasoning({ title, isStreaming, duration, children, translations, ...props }: AiReasoningProps): h.JSX.Element;

package/ai/components.d.ts

@@ -1,7 +1,7 @@
 import { AiUiTranslations } from './translations';
-import { h, ComponentChildren, ComponentProps } from 'preact';
+import { h, ComponentChildren, ComponentProps } from '../_vendor/preact/src/index';
 import { Textarea } from '../controls';
-export type AiActionPhase = 'idle' | 'understanding' | 'applying' | 'completed' | 'clarification' | 'unsupported' | 'error' | 'cancelled';
+export type AiActionPhase = 'idle' | 'understanding' | 'applying' | 'preview' | 'completed' | 'clarification' | 'unsupported' | 'error' | 'cancelled';
 export interface AiPromptInputProps {
     translations?: AiUiTranslations;
     value: string;
@@ -14,6 +14,8 @@ export interface AiPromptInputProps {
     placeholder?: string;
     submitLabel?: string;
     stopLabel?: string;
+    /** Opt-in local prompt recall. Arrow keys retain normal multiline behavior away from text edges. */
+    promptHistory?: readonly string[];
     /** Empty-draft keyboard guidance. An empty string lets toolbar context replace it. */
     hint?: string;
     /** Host-supported actions or context, displayed in the composer toolbar. */
@@ -24,10 +26,14 @@ export interface AiPromptInputProps {
     textareaProps?: Pick<ComponentProps<typeof Textarea>, 'className' | 'style' | 'rows'>;
 }
 /** Shared composer: Enter submits, Shift+Enter inserts a line; IME never submits. */
-export declare function AiPromptInput({ translations, value, onValueChange, onSubmit, onStop, busy, disabled, label, placeholder, submitLabel, stopLabel, hint, actions, footer, textareaProps, }: AiPromptInputProps): h.JSX.Element;
+export declare function AiPromptInput({ translations, value, onValueChange, onSubmit, onStop, busy, disabled, label, placeholder, submitLabel, stopLabel, promptHistory, hint, actions, footer, textareaProps, }: AiPromptInputProps): h.JSX.Element;
+export interface AiSuggestionChoice {
+    label: string;
+    prompt: string;
+}
 export interface AiSuggestionsProps {
     translations?: AiUiTranslations;
-    items: readonly string[];
+    items: readonly (string | AiSuggestionChoice)[];
     onSelect(value: string): void;
     disabled?: boolean;
     label?: string;
@@ -57,3 +63,13 @@ export interface AiAssistantProps {
 }
 /** Neutral composition; grid/model/query policy remains in the consuming product. */
 export declare function AiAssistant({ translations, label, children, footer, busy, }: AiAssistantProps): h.JSX.Element;
+export interface AiChangePreviewProps {
+    translations?: AiUiTranslations;
+    summary: string;
+    details?: string;
+    disabled?: boolean;
+    onApply(): void;
+    onCancel(): void;
+}
+/** Generic approval surface; the host retains the prepared command and its mutation policy. */
+export declare function AiChangePreview({ translations, summary, details, disabled, onApply, onCancel, }: AiChangePreviewProps): h.JSX.Element;

package/ai/index.d.ts

@@ -2,4 +2,6 @@ export * from './components';
 export * from './mount';
 export * from './request-trail';
 export * from './translations';
+export type { AiPromptHistoryOptions } from './prompt-history';
 export { AiTranslationProvider } from './translation-context';
+export * from './chat';

package/ai/index.js

@@ -1,3 +1,3 @@
-import { a as e, c as t, i as n, l as r, n as i, o as a, r as o, s, t as c } from "../_chunks/request-trail-D0oVzdRd.js";
-import { t as l } from "../_chunks/mount-0-8opf1j.js";
-export { t as AI_UI_MESSAGES, i as AiActionStatus, o as AiAssistant, n as AiPromptInput, c as AiRequestTrail, e as AiResult, a as AiSuggestions, s as AiTranslationProvider, l as mountAiAssistant, r as translateAiText };
+import { t as e } from "../_chunks/mount-DQ1cpppK.js";
+import { _ as t, a as n, b as r, c as i, d as a, f as o, g as s, h as c, i as l, l as u, m as d, n as f, o as p, p as m, r as h, s as g, t as _, u as v, x as y, y as b } from "../_chunks/request-trail-DSlFix6i.js";
+export { r as AI_UI_MESSAGES, o as AiActionStatus, m as AiAssistant, d as AiChangePreview, f as AiChat, h as AiChatComposer, l as AiChatContent, n as AiChatEmptyState, p as AiMessage, g as AiMessageActions, i as AiMessageContent, c as AiPromptInput, u as AiReasoning, _ as AiRequestTrail, s as AiResult, t as AiSuggestions, v as AiTask, a as AiTaskItem, b as AiTranslationProvider, e as mountAiAssistant, y as translateAiText };

package/ai/mount.d.ts

@@ -1,17 +1,44 @@
 import { AiUiTranslations } from './translations';
-import { AiActionPhase, AiPromptInputProps } from './components';
+import { AiActionPhase, AiPromptInputProps, AiSuggestionChoice } from './components';
 import { AiRequestTrailItem, AiRequestTrailProps } from './request-trail';
+import { AiPromptHistoryOptions } from './prompt-history';
 export interface AiAssistantMountState {
     phase: AiActionPhase;
+    /** Accepted public user request only; never an internal model prompt. */
+    request?: {
+        id: string;
+        prompt: string;
+    };
+    /** Increment to clear the local chat transcript and composer. */
+    chatKey?: number;
     message: string;
+    /** Plain text from a bounded host-owned action result. */
+    resultDetails?: string;
+    pendingAction?: {
+        summary: string;
+        details?: string;
+    };
+    canUndoData?: boolean;
+    canRedoData?: boolean;
     matchedRows?: number;
     canRestore?: boolean;
     suggestions?: readonly string[];
+    choices?: readonly AiSuggestionChoice[];
     steps?: readonly AiRequestTrailItem[];
     canEditSteps?: boolean;
 }
 export interface AiAssistantMountOptions {
+    mode?: 'toolbar' | 'chat';
+    onClearChat?(): void;
+    /** Local input recall and optional host persistence; never sent to the model automatically. */
+    promptHistory?: AiPromptHistoryOptions;
+    /** Auto-dismiss settled activity messages; disabled unless configured. */
+    activityDurationMs?: number;
     translations?: AiUiTranslations;
+    onApplyAction?(): void;
+    onCancelAction?(): void;
+    onUndoData?(): void;
+    onRedoData?(): void;
     onSubmit(prompt: string): void;
     onStop(): void;
     onRestore(): void;
@@ -29,5 +56,7 @@ export interface AiAssistantMountOptions {
 /** Framework-independent mount of the same TSX used by the public components. */
 export declare function mountAiAssistant(host: HTMLElement, options: AiAssistantMountOptions): {
     update(state: AiAssistantMountState): void;
+    /** Update example choices without remounting the composer or losing its draft. */
+    setSuggestions(items: readonly string[]): void;
     destroy(): void;
 };