lemma-sdk 0.2.11 → 0.2.13

package/README.md

@@ -218,11 +218,114 @@ function AssistantSurface() {
 }
 ```
 
+The assistant UI now ships with built-in fallback theme tokens and a sensible default shell height, so it does not need app-specific CSS variables just to look presentable. If your app already defines the same CSS custom properties (`--bg-surface`, `--brand-primary`, etc.), your values will override the defaults.
+
+Practical expectations:
+
+- The components are React components styled with utility class names, so your app should already compile those class names (for example with Tailwind or the same utility CSS pipeline used by the app shell).
+- `AssistantEmbedded` and `AssistantExperienceView` render with a default minimum height of about 640px. You can still place them in a taller container when you want a full-page assistant.
+- Host apps are still responsible for auth, `LemmaClient` setup, and any product-specific renderers for files, widgets, or navigation.
+
 The intended split is:
 
 - SDK: `useAssistantController`, message/tool normalization, plan parsing, tool rollups, and assistant UI primitives.
 - App: modal shell, fullscreen behavior, route navigation, workspace/file viewers, and product-specific renderers.
 
+Useful UI primitives exported from `lemma-sdk/react`:
+
+- `AssistantHeader`
+- `AssistantConversationList`
+- `AssistantModelPicker`
+- `AssistantShellLayout`
+- `AssistantComposer`
+- `AssistantMessageViewport`
+- `AssistantAskOverlay`
+- `AssistantPendingFileChip`
+- `AssistantStatusPill`
+- `MessageGroup`
+- `PlanSummaryStrip`
+
+For a direct plug-and-play component, `AssistantEmbedded` wires `useAssistantController` into the default assistant experience:
+
+```tsx
+import { AssistantEmbedded } from "lemma-sdk/react";
+
+function SupportAssistant() {
+  return (
+    <AssistantEmbedded
+      client={client}
+      assistantId="support_assistant"
+      podId="pod_123"
+      title="Support Assistant"
+      subtitle="Ask questions about this pod."
+      placeholder="Message Support Assistant"
+      showConversationList
+    />
+  );
+}
+```
+
+If you want the default embedded assistant to fill a page section cleanly, this is a good starting point:
+
+```tsx
+function AssistantPanel() {
+  return (
+    <section style={{ minHeight: 720 }}>
+      <AssistantEmbedded
+        client={client}
+        assistantId="support_assistant"
+        podId="pod_123"
+        title="Support Assistant"
+        subtitle="Answer questions, inspect files, and help with pod changes."
+        placeholder="Ask Support Assistant"
+        showConversationList
+      />
+    </section>
+  );
+}
+```
+
+### Styling the assistant chrome directly
+
+If you are composing your own shell from the exported primitives, you can reuse the same built-in theme values:
+
+```tsx
+import {
+  AssistantComposer,
+  AssistantHeader,
+  AssistantMessageViewport,
+  assistantThemeStyles,
+} from "lemma-sdk/react";
+
+function CustomAssistantChrome() {
+  return (
+    <div style={{ ...assistantThemeStyles, minHeight: 640 }}>
+      <AssistantHeader
+        title="Workspace Assistant"
+        subtitle="Custom shell using SDK primitives"
+      />
+      <AssistantMessageViewport>
+        {/* messages */}
+      </AssistantMessageViewport>
+      <AssistantComposer>
+        {/* composer */}
+      </AssistantComposer>
+    </div>
+  );
+}
+```
+
+You can also merge your own overrides:
+
+```tsx
+import { withAssistantThemeStyles } from "lemma-sdk/react";
+
+const style = withAssistantThemeStyles({
+  "--brand-primary": "#0f766e",
+  "--brand-secondary": "#34d399",
+});
+```
+
 ### Assistant names (resource key)
 
 Assistant CRUD is name-based:

package/dist/react/components/AssistantChrome.d.ts

@@ -0,0 +1,87 @@
+import { type ComponentPropsWithoutRef, type CSSProperties, type ReactNode } from "react";
+import type { AssistantConversationListItem, AssistantConversationRenderArgs } from "./assistant-types.js";
+export declare const assistantThemeStyles: CSSProperties;
+export declare function withAssistantThemeStyles(style?: CSSProperties): CSSProperties;
+export interface AssistantHeaderProps {
+    title: ReactNode;
+    subtitle?: ReactNode;
+    badge?: ReactNode;
+    controls?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
+export interface AssistantMessageViewportProps extends ComponentPropsWithoutRef<"div"> {
+    innerClassName?: string;
+    children: ReactNode;
+}
+export declare const AssistantMessageViewport: import("react").ForwardRefExoticComponent<AssistantMessageViewportProps & import("react").RefAttributes<HTMLDivElement>>;
+export interface AssistantShellLayoutProps {
+    sidebar?: ReactNode;
+    sidebarVisible?: boolean;
+    main: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
+export declare function AssistantShellLayout({ sidebar, sidebarVisible, main, className, style, }: AssistantShellLayoutProps): import("react/jsx-runtime").JSX.Element;
+export declare function AssistantHeader({ title, subtitle, badge, controls, className, style, }: AssistantHeaderProps): import("react/jsx-runtime").JSX.Element;
+export interface AssistantConversationListProps {
+    conversations: AssistantConversationListItem[];
+    activeConversationId: string | null;
+    onSelectConversation: (conversationId: string) => void;
+    onNewConversation?: () => void;
+    renderConversationLabel?: (args: AssistantConversationRenderArgs) => ReactNode;
+    title?: ReactNode;
+    newLabel?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
+export declare function AssistantConversationList({ conversations, activeConversationId, onSelectConversation, onNewConversation, renderConversationLabel, title, newLabel, className, style, }: AssistantConversationListProps): import("react/jsx-runtime").JSX.Element;
+export interface AssistantModelPickerProps<TValue extends string = string> {
+    value: TValue | null;
+    options: TValue[];
+    disabled?: boolean;
+    autoLabel?: ReactNode;
+    getOptionLabel?: (value: TValue) => ReactNode;
+    onChange: (value: TValue | null) => void;
+    className?: string;
+    style?: CSSProperties;
+}
+export declare function AssistantModelPicker<TValue extends string = string>({ value, options, disabled, autoLabel, getOptionLabel, onChange, className, style, }: AssistantModelPickerProps<TValue>): import("react/jsx-runtime").JSX.Element;
+export interface AssistantAskOverlayProps {
+    questionNumber: number;
+    totalQuestions: number;
+    question: ReactNode;
+    options: string[];
+    selectedOptions: string[];
+    canContinue: boolean;
+    continueLabel: ReactNode;
+    onSelectOption: (option: string) => void;
+    onContinue?: () => void;
+    onSkip?: () => void;
+    mode?: "single_select" | "multi_select" | "rank_priorities";
+    style?: CSSProperties;
+}
+export declare function AssistantAskOverlay({ questionNumber, totalQuestions, question, options, selectedOptions, canContinue, continueLabel, onSelectOption, onContinue, onSkip, mode, style, }: AssistantAskOverlayProps): import("react/jsx-runtime").JSX.Element;
+export interface AssistantPendingFileChipProps {
+    label: ReactNode;
+    onRemove?: () => void;
+    className?: string;
+    style?: CSSProperties;
+}
+export interface AssistantComposerProps {
+    floating?: ReactNode;
+    status?: ReactNode;
+    pendingFiles?: ReactNode;
+    children: ReactNode;
+    className?: string;
+    style?: CSSProperties;
+}
+export declare function AssistantComposer({ floating, status, pendingFiles, children, className, style, }: AssistantComposerProps): import("react/jsx-runtime").JSX.Element;
+export declare function AssistantPendingFileChip({ label, onRemove, className, style, }: AssistantPendingFileChipProps): import("react/jsx-runtime").JSX.Element;
+export interface AssistantStatusPillProps {
+    label: ReactNode;
+    subtle?: boolean;
+    className?: string;
+    style?: CSSProperties;
+}
+export declare function AssistantStatusPill({ label, subtle, className, style, }: AssistantStatusPillProps): import("react/jsx-runtime").JSX.Element;

package/dist/react/components/AssistantChrome.js

@@ -0,0 +1,95 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { forwardRef } from "react";
+function cx(...values) {
+    return values.filter(Boolean).join(" ");
+}
+function formatConversationTimestamp(value) {
+    const parsed = new Date(value);
+    if (Number.isNaN(parsed.valueOf())) {
+        return "";
+    }
+    return new Intl.DateTimeFormat("en-US", {
+        month: "short",
+        day: "numeric",
+        timeZone: "UTC",
+    }).format(parsed);
+}
+export const assistantThemeStyles = {
+    "--bg-canvas": "#f4ede6",
+    "--bg-surface": "#fffaf4",
+    "--bg-subtle": "#efe4d8",
+    "--border-default": "#d8c4b2",
+    "--border-subtle": "#eadacc",
+    "--text-primary": "#23160f",
+    "--text-secondary": "#5f4838",
+    "--text-tertiary": "#8d715b",
+    "--text-on-brand": "#fff7f0",
+    "--text-inverse": "#fffaf4",
+    "--brand-primary": "#c45a2f",
+    "--brand-secondary": "#f2a65e",
+    "--brand-accent": "#df7a38",
+    "--brand-glow": "#f4d6b5",
+    "--state-success": "#1c8c63",
+    "--state-info": "#2e78b7",
+    "--state-error": "#be4637",
+    "--state-warning": "#a86811",
+    "--shadow-xs": "0 6px 18px -12px rgba(46, 27, 15, 0.35)",
+    "--shadow-sm": "0 12px 28px -20px rgba(46, 27, 15, 0.28)",
+    "--shadow-md": "0 20px 44px -28px rgba(46, 27, 15, 0.34)",
+    "--shadow-lg": "0 28px 64px -34px rgba(46, 27, 15, 0.4)",
+};
+export function withAssistantThemeStyles(style) {
+    return {
+        ...assistantThemeStyles,
+        ...style,
+    };
+}
+export const AssistantMessageViewport = forwardRef(function AssistantMessageViewport({ className, innerClassName, children, style, ...props }, ref) {
+    return (_jsx("div", { ref: ref, className: cx("min-h-0 flex-1 overflow-y-auto bg-[var(--bg-surface)] px-4 py-4", className), style: withAssistantThemeStyles(style), ...props, children: _jsx("div", { className: cx("mx-auto flex w-full max-w-5xl flex-col gap-3", innerClassName), children: children }) }));
+});
+export function AssistantShellLayout({ sidebar, sidebarVisible = false, main, className, style, }) {
+    return (_jsxs("div", { className: cx("mx-auto flex h-full w-full min-h-[640px] flex-col gap-3 rounded-[28px] border border-[color:color-mix(in_srgb,_var(--border-default)_72%,_transparent)] bg-[linear-gradient(180deg,color-mix(in_srgb,_var(--bg-canvas)_95%,_transparent),color-mix(in_srgb,_var(--bg-surface)_98%,_transparent))] p-3 font-sans antialiased shadow-[var(--shadow-lg)]", !!sidebar && sidebarVisible && "lg:grid lg:grid-cols-[280px_minmax(0,1fr)] lg:gap-3", className), style: withAssistantThemeStyles(style), children: [sidebar && sidebarVisible ? (_jsx("div", { className: "hidden h-full min-h-0 lg:block", children: sidebar })) : null, main] }));
+}
+export function AssistantHeader({ title, subtitle, badge, controls, className, style, }) {
+    return (_jsxs("div", { className: cx("flex items-center justify-between border-b border-[color:color-mix(in_srgb,_var(--border-default)_80%,_transparent)] px-4 py-3.5", className), style: withAssistantThemeStyles(style), children: [_jsxs("div", { className: "flex items-center gap-2.5", children: [badge ? (_jsx("div", { className: "flex h-9 w-9 items-center justify-center rounded-2xl bg-[linear-gradient(145deg,var(--brand-primary),var(--brand-secondary))] shadow-[var(--shadow-xs)]", children: badge })) : null, _jsxs("div", { children: [_jsx("h3", { className: "text-[13px] font-semibold leading-tight tracking-[-0.01em] text-[var(--text-primary)]", children: title }), subtitle ? (_jsx("p", { className: "mt-0.5 text-[11px] text-[var(--text-tertiary)]", children: subtitle })) : null] })] }), controls ? (_jsx("div", { className: "flex items-center gap-1", children: controls })) : null] }));
+}
+export function AssistantConversationList({ conversations, activeConversationId, onSelectConversation, onNewConversation, renderConversationLabel, title = "Conversations", newLabel = "New", className, style, }) {
+    return (_jsxs("aside", { className: cx("flex h-full min-h-[560px] flex-col overflow-hidden rounded-[24px] border border-[color:color-mix(in_srgb,_var(--border-default)_80%,_transparent)] bg-[linear-gradient(180deg,color-mix(in_srgb,_var(--bg-surface)_98%,_transparent),color-mix(in_srgb,_var(--bg-canvas)_74%,_transparent))] shadow-[var(--shadow-lg)]", className), style: withAssistantThemeStyles(style), children: [_jsx("div", { className: "border-b border-[color:color-mix(in_srgb,_var(--border-default)_80%,_transparent)] px-4 py-3.5", children: _jsxs("div", { className: "flex items-center justify-between gap-3", children: [_jsxs("div", { children: [_jsx("div", { className: "text-[13px] font-semibold text-[var(--text-primary)]", children: title }), _jsxs("div", { className: "mt-1 text-[11px] text-[var(--text-tertiary)]", children: [conversations.length, " total"] })] }), onNewConversation ? (_jsx("button", { type: "button", onClick: onNewConversation, className: "rounded-full border border-[var(--border-default)] bg-[color:color-mix(in_srgb,_var(--bg-surface)_92%,_white)] px-3 py-1.5 text-[11px] font-medium text-[var(--text-secondary)] transition-colors hover:bg-[var(--bg-subtle)] hover:text-[var(--text-primary)]", children: newLabel })) : null] }) }), _jsx("div", { className: "min-h-0 flex-1 space-y-2 overflow-y-auto p-3", children: conversations.map((conversation) => {
+                    const isActive = conversation.id === activeConversationId;
+                    return (_jsxs("button", { type: "button", onClick: () => onSelectConversation(conversation.id), className: cx("w-full rounded-2xl border px-3 py-3 text-left transition-all duration-200", isActive
+                            ? "border-[color:color-mix(in_srgb,_var(--brand-primary)_44%,_var(--border-default))] bg-[linear-gradient(135deg,color-mix(in_srgb,_var(--brand-glow)_52%,_var(--bg-surface)),color-mix(in_srgb,_var(--brand-primary)_8%,_var(--bg-surface)))] shadow-[var(--shadow-xs)]"
+                            : "border-[var(--border-default)] bg-[color:color-mix(in_srgb,_var(--bg-surface)_88%,_white)] hover:-translate-y-[1px] hover:bg-[var(--bg-subtle)] hover:shadow-[var(--shadow-xs)]"), children: [_jsx("div", { className: "truncate text-[12px] font-medium text-[var(--text-primary)]", children: renderConversationLabel
+                                    ? renderConversationLabel({ conversation, isActive })
+                                    : (conversation.title || "Untitled conversation") }), _jsxs("div", { className: "mt-2 flex items-center justify-between gap-2", children: [_jsx("div", { className: "text-[10px] uppercase tracking-[0.08em] text-[var(--text-tertiary)]", children: (conversation.status || "waiting").toLowerCase() }), conversation.updated_at ? (_jsx("div", { className: "truncate text-[10px] text-[var(--text-tertiary)]", children: formatConversationTimestamp(conversation.updated_at) })) : null] })] }, conversation.id));
+                }) })] }));
+}
+export function AssistantModelPicker({ value, options, disabled, autoLabel = "Auto", getOptionLabel, onChange, className, style, }) {
+    const autoValue = "__AUTO__";
+    return (_jsxs("select", { value: value ?? autoValue, onChange: (event) => onChange(event.target.value === autoValue ? null : event.target.value), disabled: disabled, className: cx("h-9 rounded-full border border-[color:color-mix(in_srgb,_var(--border-default)_80%,_transparent)] bg-[color:color-mix(in_srgb,_var(--bg-surface)_88%,_white)] px-3.5 text-[11px] font-medium text-[var(--text-secondary)] shadow-[var(--shadow-xs)]", className), style: withAssistantThemeStyles(style), "aria-label": "Conversation model", title: "Conversation model", children: [_jsx("option", { value: autoValue, children: autoLabel }), options.map((option) => (_jsx("option", { value: option, children: getOptionLabel ? getOptionLabel(option) : option }, option)))] }));
+}
+export function AssistantAskOverlay({ questionNumber, totalQuestions, question, options, selectedOptions, canContinue, continueLabel, onSelectOption, onContinue, onSkip, mode = "single_select", style, }) {
+    return (_jsxs("div", { className: "space-y-2 rounded-[22px] border border-[color:color-mix(in_srgb,_var(--border-default)_82%,_transparent)] bg-[linear-gradient(180deg,color-mix(in_srgb,_var(--bg-surface)_98%,_transparent),color-mix(in_srgb,_var(--bg-canvas)_70%,_transparent))] p-3 shadow-[var(--shadow-md)]", style: withAssistantThemeStyles(style), children: [_jsxs("div", { className: "flex items-start justify-between gap-3", children: [_jsxs("div", { children: [_jsxs("div", { className: "text-[11px] uppercase tracking-[0.12em] text-[var(--text-tertiary)]", children: ["Question ", questionNumber, " of ", totalQuestions] }), _jsx("p", { className: "mt-1 text-[14px] font-medium leading-6 text-[var(--text-primary)]", children: question })] }), onSkip ? (_jsx("button", { type: "button", onClick: onSkip, className: "rounded-md px-2 py-1 text-[12px] text-[var(--text-tertiary)] transition-colors hover:bg-[var(--bg-subtle)] hover:text-[var(--text-primary)]", children: "Skip" })) : null] }), _jsx("div", { className: "max-h-[260px] space-y-1.5 overflow-y-auto pr-1", children: options.map((option, optionIndex) => {
+                    const isSelected = selectedOptions.includes(option);
+                    const rankLabel = mode === "rank_priorities" && isSelected
+                        ? selectedOptions.indexOf(option) + 1
+                        : null;
+                    return (_jsx("button", { type: "button", onClick: () => onSelectOption(option), className: cx("w-full rounded-lg border px-2.5 py-2 text-left text-[13px] transition-colors", isSelected
+                            ? "border-[color:color-mix(in_srgb,_var(--brand-primary)_64%,_var(--border-subtle))] bg-[color:color-mix(in_srgb,_var(--brand-primary)_14%,_transparent)] text-[var(--text-primary)]"
+                            : "border-[var(--border-default)] bg-[var(--bg-canvas)] text-[var(--text-secondary)] hover:bg-[var(--bg-subtle)] hover:text-[var(--text-primary)]"), children: _jsxs("span", { className: "inline-flex items-center gap-2", children: [rankLabel ? (_jsx("span", { className: "inline-flex h-4 min-w-4 items-center justify-center rounded-full bg-[var(--brand-primary)] px-1 text-[10px] font-semibold text-[var(--text-on-brand)]", children: rankLabel })) : (_jsx("span", { className: cx("inline-block h-2.5 w-2.5 rounded-full border", isSelected
+                                        ? "border-[var(--brand-primary)] bg-[var(--brand-primary)]"
+                                        : "border-[var(--border-default)] bg-transparent") })), option] }) }, `${option}-${optionIndex}`));
+                }) }), onContinue ? (_jsx("div", { className: "flex justify-end", children: _jsx("button", { type: "button", onClick: onContinue, disabled: !canContinue, className: cx("rounded-md px-2.5 py-1.5 text-[12px] font-medium transition-colors", canContinue
+                        ? "bg-[var(--brand-primary)] text-[var(--text-on-brand)] hover:bg-[color:color-mix(in_srgb,_var(--brand-primary)_88%,_var(--text-primary))]"
+                        : "bg-[var(--bg-subtle)] text-[var(--text-tertiary)]"), children: continueLabel }) })) : null] }));
+}
+export function AssistantComposer({ floating, status, pendingFiles, children, className, style, }) {
+    return (_jsxs("div", { className: cx("relative rounded-[24px] border border-[color:color-mix(in_srgb,_var(--border-default)_80%,_transparent)] bg-[linear-gradient(180deg,color-mix(in_srgb,_var(--bg-surface)_98%,_transparent),color-mix(in_srgb,_var(--bg-canvas)_82%,_transparent))] p-2.5 shadow-[var(--shadow-md)]", className), style: withAssistantThemeStyles(style), children: [floating ? (_jsx("div", { className: "absolute bottom-[calc(100%+8px)] left-0 right-0 z-20", children: floating })) : null, _jsx("div", { className: "min-h-[34px] px-2 pb-1", children: _jsx("div", { className: "flex min-h-[26px] items-center transition-opacity duration-200", children: status || _jsx("span", { "aria-hidden": "true", className: "inline-block h-[30px]" }) }) }), pendingFiles ? (_jsx("div", { className: "flex flex-wrap items-center gap-1.5 px-1 pb-1.5", children: pendingFiles })) : null, children] }));
+}
+export function AssistantPendingFileChip({ label, onRemove, className, style, }) {
+    return (_jsxs("span", { className: cx("inline-flex max-w-full items-center gap-1.5 rounded-full border border-[color:color-mix(in_srgb,_var(--border-default)_72%,_transparent)] bg-[color:color-mix(in_srgb,_var(--bg-surface)_70%,_var(--bg-subtle))] px-2.5 py-1 text-[11px] text-[var(--text-secondary)]", className), style: withAssistantThemeStyles(style), children: [_jsx("span", { className: "truncate max-w-[180px]", children: label }), onRemove ? (_jsx("button", { type: "button", onClick: onRemove, className: "inline-flex h-4 w-4 items-center justify-center rounded-full hover:bg-[var(--bg-canvas)]", title: "Remove file", children: "\u00D7" })) : null] }));
+}
+export function AssistantStatusPill({ label, subtle = false, className, style, }) {
+    return (_jsxs("div", { className: cx("inline-flex min-h-[32px] max-w-full items-center gap-2 rounded-full px-3 py-1.5 text-[12px] transition-all duration-200", subtle
+            ? "border border-[color:color-mix(in_srgb,_var(--border-default)_72%,_transparent)] bg-[color:color-mix(in_srgb,_var(--bg-surface)_90%,_transparent)] text-[var(--text-tertiary)]"
+            : "border border-[color:color-mix(in_srgb,_var(--brand-primary)_24%,_var(--border-default))] bg-[color:color-mix(in_srgb,_var(--brand-glow)_28%,_var(--bg-surface))] text-[var(--text-secondary)]", className), style: withAssistantThemeStyles(style), children: [_jsxs("span", { className: "relative inline-flex h-2.5 w-2.5 shrink-0", children: [_jsx("span", { className: "absolute inline-flex h-full w-full animate-ping rounded-full bg-[var(--brand-primary)]/45" }), _jsx("span", { className: "relative inline-flex h-2.5 w-2.5 rounded-full bg-[var(--brand-primary)]" })] }), _jsx("span", { className: "truncate", children: label })] }));
+}

package/dist/react/components/AssistantEmbedded.d.ts

@@ -0,0 +1,8 @@
+import type { LemmaClient } from "../../client.js";
+import { type AssistantConversationScope } from "../useAssistantController.js";
+import { type AssistantExperienceViewProps } from "./AssistantExperience.js";
+export interface AssistantEmbeddedProps extends Omit<AssistantExperienceViewProps, "controller">, AssistantConversationScope {
+    client: LemmaClient;
+    enabled?: boolean;
+}
+export declare function AssistantEmbedded({ client, podId, assistantId, organizationId, enabled, ...props }: AssistantEmbeddedProps): import("react/jsx-runtime").JSX.Element;

package/dist/react/components/AssistantEmbedded.js

@@ -0,0 +1,13 @@
+import { jsx as _jsx } from "react/jsx-runtime";
+import { useAssistantController } from "../useAssistantController.js";
+import { AssistantExperienceView } from "./AssistantExperience.js";
+export function AssistantEmbedded({ client, podId, assistantId, organizationId, enabled = true, ...props }) {
+    const controller = useAssistantController({
+        client,
+        podId: podId ?? undefined,
+        assistantId: assistantId ?? undefined,
+        organizationId: organizationId ?? undefined,
+        enabled,
+    });
+    return _jsx(AssistantExperienceView, { controller: controller, ...props });
+}

package/dist/react/components/AssistantExperience.d.ts

@@ -1,4 +1,4 @@
-import { type ReactNode } from "react";
+import { type CSSProperties, type ReactNode } from "react";
 import type { AssistantRenderableMessage, AssistantToolInvocation } from "../useAssistantController.js";
 import type { AssistantControllerView, AssistantConversationRenderArgs, AssistantMessageRenderArgs, AssistantPendingFileRenderArgs, AssistantPresentedFileRenderArgs, AssistantToolRenderArgs } from "./assistant-types.js";
 type PlanStatus = "pending" | "in_progress" | "completed";
@@ -39,6 +39,8 @@ export interface AssistantExperienceViewProps {
     subtitle?: ReactNode;
     placeholder?: string;
     emptyState?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
     draft?: string;
     onDraftChange?: (value: string) => void;
     showConversationList?: boolean;
@@ -75,5 +77,5 @@ export declare function MessageGroup({ message, conversationId, onNavigateResour
     renderPresentedFile?: (args: AssistantPresentedFileRenderArgs) => ReactNode;
     renderToolInvocation?: (args: AssistantToolRenderArgs) => ReactNode;
 }): import("react/jsx-runtime").JSX.Element;
-export declare function AssistantExperienceView({ controller, title, subtitle, placeholder, emptyState, draft: controlledDraft, onDraftChange, showConversationList, onNavigateResource, renderConversationLabel, renderMessageContent, renderPresentedFile, renderPendingFile, renderToolInvocation, }: AssistantExperienceViewProps): import("react/jsx-runtime").JSX.Element;
+export declare function AssistantExperienceView({ controller, title, subtitle, placeholder, emptyState, className, style, draft: controlledDraft, onDraftChange, showConversationList, onNavigateResource, renderConversationLabel, renderMessageContent, renderPresentedFile, renderPendingFile, renderToolInvocation, }: AssistantExperienceViewProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/react/components/AssistantExperience.js

@@ -1,6 +1,7 @@
-import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { jsx as _jsx, jsxs as _jsxs, Fragment as _Fragment } from "react/jsx-runtime";
 import { useCallback, useEffect, useMemo, useRef, useState, } from "react";
 import { AvailableModels } from "../../types.js";
+import { AssistantComposer, AssistantConversationList, AssistantHeader, AssistantAskOverlay, AssistantMessageViewport, AssistantModelPicker, AssistantPendingFileChip, AssistantStatusPill, withAssistantThemeStyles, } from "./AssistantChrome.js";
 function cx(...values) {
     return values.filter(Boolean).join(" ");
 }
@@ -506,7 +507,7 @@ function defaultPresentedFile({ filepath }) {
     return (_jsxs("div", { className: "rounded-2xl border border-[color:color-mix(in_srgb,_var(--border-default)_78%,_transparent)] bg-[linear-gradient(180deg,color-mix(in_srgb,var(--bg-surface)_96%,transparent),color-mix(in_srgb,var(--bg-canvas)_76%,transparent))] px-3 py-2.5", children: [_jsx("div", { className: "text-[14px] font-medium text-[var(--text-primary)]", children: fileNameFromPath(filepath) }), _jsx("div", { className: "mt-1 text-[12px] text-[var(--text-tertiary)]", children: filepath })] }));
 }
 function defaultPendingFile({ file, remove }) {
-    return (_jsxs("span", { className: "inline-flex max-w-full items-center gap-1.5 rounded-full bg-[var(--bg-subtle)] px-2 py-1 text-[11px] text-[var(--text-secondary)]", children: [_jsx("span", { className: "truncate max-w-[180px]", children: file.name }), _jsx("button", { type: "button", onClick: remove, className: "inline-flex h-4 w-4 items-center justify-center rounded-full hover:bg-[var(--bg-canvas)]", title: "Remove file", children: "\u00D7" })] }));
+    return (_jsx(AssistantPendingFileChip, { label: file.name, onRemove: remove }));
 }
 export function PlanSummaryStrip({ plan, onHide }) {
     const [showAll, setShowAll] = useState(false);
@@ -526,12 +527,28 @@ export function ThinkingIndicator() {
 }
 export function EmptyState({ onSendMessage }) {
     const suggestions = [
-        { text: "Create an agent that summarizes documents", icon: "🤖" },
-        { text: "Add a table for tracking leads", icon: "📊" },
-        { text: "Create a full React desk page for an executive dashboard", icon: "🧩" },
-        { text: "Create a flow to process emails", icon: "⚡" },
+        {
+            label: "Summarize uploaded docs",
+            text: "Summarize the documents I upload and pull out decisions, owners, and next steps.",
+            accent: "Research",
+        },
+        {
+            label: "Build a CRM table",
+            text: "Create a table for leads with useful columns, sample views, and suggested automation hooks.",
+            accent: "Data",
+        },
+        {
+            label: "Draft a support workflow",
+            text: "Design a support triage workflow with an assistant, a queue, and follow-up tasks.",
+            accent: "Ops",
+        },
+        {
+            label: "Create a dashboard page",
+            text: "Build a React desk page for an executive dashboard with KPIs, trends, and recent activity.",
+            accent: "UI",
+        },
     ];
-    return (_jsxs("div", { className: "text-center py-5 px-2", children: [_jsxs("div", { className: "flex flex-col items-center justify-center mb-6", children: [_jsx("div", { className: "mb-3 flex h-10 w-10 items-center justify-center rounded-full bg-[linear-gradient(135deg,var(--brand-primary),var(--brand-secondary))] shadow-[var(--shadow-xs)]", children: _jsx("span", { className: "text-[var(--text-on-brand)] text-lg", children: "\u2728" }) }), _jsx("h4", { className: "font-semibold text-[var(--text-primary)] text-[15px]", children: "What can I help you build?" }), _jsx("p", { className: "text-[13px] text-[var(--text-tertiary)] mt-1.5 max-w-sm leading-relaxed", children: "I can create agents, set up data stores, build pages, and automate workflows for your pod." })] }), _jsx("div", { className: "grid grid-cols-1 sm:grid-cols-2 gap-2.5 max-w-[500px] mx-auto", children: suggestions.map((suggestion, index) => (_jsxs("button", { onClick: () => onSendMessage(suggestion.text), className: "text-left px-3 py-2.5 rounded-lg border border-[var(--border-default)] bg-[var(--bg-surface)] text-xs text-[var(--text-secondary)] hover:border-[color:color-mix(in_srgb,_var(--brand-accent)_52%,_var(--border-subtle))] hover:bg-[color:color-mix(in_srgb,_var(--brand-glow)_72%,_var(--bg-surface))] hover:text-[var(--text-primary)] transition-all duration-200 flex items-center gap-2.5 group", children: [_jsx("span", { className: "text-base opacity-70 group-hover:opacity-100 transition-opacity", children: suggestion.icon }), _jsx("span", { className: "flex-1 leading-snug", children: suggestion.text }), _jsx("span", { className: "text-[var(--text-tertiary)] group-hover:text-[var(--state-warning)] group-hover:translate-x-0.5 transition-all opacity-0 group-hover:opacity-100", children: "\u203A" })] }, `${suggestion.text}-${index}`))) })] }));
+    return (_jsxs("div", { className: "px-2 py-7", children: [_jsxs("div", { className: "mx-auto max-w-2xl text-center", children: [_jsx("div", { className: "mx-auto mb-4 flex h-12 w-12 items-center justify-center rounded-[18px] bg-[linear-gradient(145deg,var(--brand-primary),var(--brand-secondary))] shadow-[var(--shadow-sm)]", children: _jsx("span", { className: "text-[var(--text-on-brand)] text-sm font-semibold tracking-[0.18em]", children: "AI" }) }), _jsx("div", { className: "inline-flex items-center rounded-full border border-[color:color-mix(in_srgb,_var(--border-default)_78%,_transparent)] bg-[color:color-mix(in_srgb,_var(--bg-surface)_84%,_white)] px-3 py-1 text-[10px] font-semibold uppercase tracking-[0.14em] text-[var(--text-tertiary)]", children: "Start with a concrete job" }), _jsx("h4", { className: "mt-4 text-[20px] font-semibold tracking-[-0.02em] text-[var(--text-primary)]", children: "What can I help you build?" }), _jsx("p", { className: "mx-auto mt-2 max-w-xl text-[13px] leading-relaxed text-[var(--text-tertiary)]", children: "I can shape workflows, spin up data structures, write desk UI, and turn rough ideas into working pod changes." })] }), _jsx("div", { className: "mx-auto mt-6 grid max-w-3xl grid-cols-1 gap-3 sm:grid-cols-2", children: suggestions.map((suggestion, index) => (_jsx("button", { onClick: () => onSendMessage(suggestion.text), className: "group rounded-[22px] border border-[color:color-mix(in_srgb,_var(--border-default)_78%,_transparent)] bg-[linear-gradient(180deg,color-mix(in_srgb,_var(--bg-surface)_94%,_white),color-mix(in_srgb,_var(--bg-canvas)_64%,_transparent))] px-4 py-4 text-left shadow-[var(--shadow-xs)] transition-all duration-200 hover:-translate-y-[2px] hover:border-[color:color-mix(in_srgb,_var(--brand-accent)_48%,_var(--border-subtle))] hover:shadow-[var(--shadow-sm)]", children: _jsxs("div", { className: "flex items-start justify-between gap-3", children: [_jsxs("div", { children: [_jsx("div", { className: "inline-flex rounded-full bg-[color:color-mix(in_srgb,_var(--brand-glow)_46%,_white)] px-2.5 py-1 text-[10px] font-semibold uppercase tracking-[0.12em] text-[var(--brand-primary)]", children: suggestion.accent }), _jsx("div", { className: "mt-3 text-[14px] font-semibold tracking-[-0.01em] text-[var(--text-primary)]", children: suggestion.label }), _jsx("div", { className: "mt-1.5 text-[12px] leading-5 text-[var(--text-secondary)]", children: suggestion.text })] }), _jsx("span", { className: "mt-0.5 text-[var(--text-tertiary)] transition-all group-hover:translate-x-0.5 group-hover:text-[var(--brand-primary)]", children: "\u203A" })] }) }, `${suggestion.label}-${index}`))) })] }));
 }
 function ReasoningPartCard({ text, isStreaming, durationMs, }) {
     return (_jsxs("details", { className: "group", open: isStreaming, children: [_jsxs("summary", { className: "list-none cursor-pointer inline-flex items-center gap-1.5 text-[12px] leading-5 text-[var(--text-tertiary)]", children: [_jsx("span", { className: "transition-transform group-open:rotate-90", children: "\u203A" }), _jsx("span", { className: cx("font-semibold", isStreaming && "text-transparent bg-clip-text bg-[linear-gradient(110deg,var(--text-secondary),35%,var(--brand-accent),50%,var(--text-secondary),65%)] bg-[length:250%_100%] animate-pulse"), children: isStreaming ? "Thinking" : `Thought${durationMs ? ` · ${Math.max(1, Math.round(durationMs / 1000))}s` : ""}` })] }), _jsx("div", { className: "mt-1 pl-4 border-l border-[var(--border-default)]", children: _jsx("pre", { className: "text-[11px] leading-5 text-[var(--text-tertiary)] whitespace-pre-wrap font-mono", children: text }) })] }));
@@ -754,7 +771,7 @@ export function MessageGroup({ message, conversationId, onNavigateResource, onWi
                         return null;
                     }), presentableFilepaths.length > 0 ? (_jsx(PresentFilesCard, { filepaths: presentableFilepaths, conversationId: conversationId, renderPresentedFile: renderPresentedFile })) : null] })] }));
 }
-export function AssistantExperienceView({ controller, title = "Lemma Assistant", subtitle = "Ask across your workspace and organization.", placeholder = "Message Lemma Assistant", emptyState, draft: controlledDraft, onDraftChange, showConversationList = false, onNavigateResource, renderConversationLabel = defaultConversationLabel, renderMessageContent = defaultMessageContent, renderPresentedFile, renderPendingFile = defaultPendingFile, renderToolInvocation, }) {
+export function AssistantExperienceView({ controller, title = "Lemma Assistant", subtitle = "Ask across your workspace and organization.", placeholder = "Message Lemma Assistant", emptyState, className, style, draft: controlledDraft, onDraftChange, showConversationList = false, onNavigateResource, renderConversationLabel = defaultConversationLabel, renderMessageContent = defaultMessageContent, renderPresentedFile, renderPendingFile = defaultPendingFile, renderToolInvocation, }) {
     const [draft, setDraft] = useControllableDraft(controlledDraft, onDraftChange);
     const [isPlanHidden, setIsPlanHidden] = useState(false);
     const [dismissedAskToolCallIds, setDismissedAskToolCallIds] = useState([]);
@@ -992,41 +1009,24 @@ export function AssistantExperienceView({ controller, title = "Lemma Assistant",
         ? effectiveAskOverlayState.answers[effectiveAskOverlayState.currentQuestionIndex] || []
         : [];
     const canContinueAsk = activeAskAnswers.length > 0;
-    return (_jsxs("div", { className: cx("flex h-full min-h-0 flex-col gap-3 font-sans antialiased", showConversationList && "lg:grid lg:grid-cols-[280px_minmax(0,1fr)] lg:gap-3"), children: [showConversationList ? (_jsxs("aside", { className: "hidden min-h-0 overflow-hidden rounded-2xl border border-[color:color-mix(in_srgb,_var(--border-default)_80%,_transparent)] bg-[var(--bg-surface)] shadow-[var(--shadow-lg)] lg:flex lg:flex-col", children: [_jsx("div", { className: "border-b border-[color:color-mix(in_srgb,_var(--border-default)_80%,_transparent)] px-4 py-3", children: _jsxs("div", { className: "flex items-center justify-between gap-3", children: [_jsxs("div", { children: [_jsx("div", { className: "text-[13px] font-semibold text-[var(--text-primary)]", children: "Conversations" }), _jsxs("div", { className: "mt-1 text-[11px] text-[var(--text-tertiary)]", children: [controller.conversations.length, " total"] })] }), _jsx("button", { type: "button", onClick: controller.clearMessages, className: "rounded-full border border-[var(--border-default)] bg-[var(--bg-surface)] px-3 py-1.5 text-[11px] font-medium text-[var(--text-secondary)] hover:text-[var(--text-primary)]", children: "New" })] }) }), _jsx("div", { className: "min-h-0 flex-1 overflow-y-auto p-3 space-y-2", children: controller.conversations.map((conversation) => {
-                            const isActive = conversation.id === controller.activeConversationId;
-                            return (_jsxs("button", { type: "button", onClick: () => controller.selectConversation(conversation.id), className: cx("w-full rounded-xl border px-3 py-2.5 text-left transition-colors", isActive
-                                    ? "border-[color:color-mix(in_srgb,_var(--brand-primary)_44%,_var(--border-default))] bg-[color:color-mix(in_srgb,_var(--brand-glow)_42%,_var(--bg-surface))]"
-                                    : "border-[var(--border-default)] bg-[var(--bg-surface)] hover:bg-[var(--bg-subtle)]"), children: [_jsx("div", { className: "text-[12px] font-medium text-[var(--text-primary)]", children: renderConversationLabel({ conversation, isActive }) }), _jsx("div", { className: "mt-1 text-[10px] uppercase tracking-[0.08em] text-[var(--text-tertiary)]", children: (conversation.status || "waiting").toLowerCase() })] }, conversation.id));
-                        }) })] })) : null, _jsxs("div", { className: "flex h-full min-h-0 flex-col gap-3", children: [_jsxs("div", { className: "flex min-h-0 flex-1 flex-col overflow-hidden rounded-2xl border border-[color:color-mix(in_srgb,_var(--border-default)_80%,_transparent)] bg-[var(--bg-surface)] shadow-[var(--shadow-lg)]", children: [_jsxs("div", { className: "flex items-center justify-between border-b border-[color:color-mix(in_srgb,_var(--border-default)_80%,_transparent)] px-4 py-3", children: [_jsxs("div", { className: "flex items-center gap-2.5", children: [_jsx("div", { className: "h-7 w-7 rounded-full bg-[linear-gradient(135deg,var(--brand-primary),var(--brand-secondary))] flex items-center justify-center shadow-[var(--shadow-xs)]", children: _jsx("span", { className: "text-[var(--text-on-brand)] text-xs", children: "\u2728" }) }), _jsxs("div", { children: [_jsx("h3", { className: "font-semibold text-[var(--text-primary)] text-[13px] leading-tight", children: title }), _jsx("p", { className: "text-[11px] text-[var(--text-tertiary)]", children: subtitle })] })] }), _jsxs("div", { className: "flex items-center gap-1", children: [_jsxs("select", { value: controller.conversationModel || "", onChange: (event) => { void handleModelChange(event.target.value || null); }, disabled: isConversationBusy || isUpdatingModel, className: "h-8 rounded-full border border-[color:color-mix(in_srgb,_var(--border-default)_80%,_transparent)] bg-[var(--bg-surface)] px-3 text-[11px] text-[var(--text-secondary)]", children: [_jsx("option", { value: "", children: "Auto" }), availableModels.map((availableModel) => (_jsx("option", { value: availableModel, children: availableModel }, availableModel)))] }), _jsx("button", { type: "button", onClick: controller.clearMessages, title: "New conversation", className: "inline-flex h-8 w-8 items-center justify-center rounded-full text-[var(--text-tertiary)] hover:bg-[var(--bg-subtle)] hover:text-[var(--text-secondary)]", children: "\u21BA" })] })] }), _jsxs("div", { className: "flex-1 overflow-y-auto px-4 py-4 space-y-3 min-h-[180px] bg-[var(--bg-surface)]", ref: messagesContainerRef, onScroll: updatePinnedState, children: [controller.messages.length === 0 && !isConversationBusy ? (emptyState || _jsx(EmptyState, { onSendMessage: (message) => { void controller.sendMessage(message); } })) : null, (controller.isLoadingMessages && controller.messages.length === 0) ? (_jsx("div", { className: "flex justify-center py-6", children: _jsx("span", { className: "text-[var(--text-tertiary)] text-sm", children: "Loading\u2026" }) })) : null, (controller.isLoadingOlderMessages && controller.messages.length > 0) ? (_jsx("div", { className: "flex justify-center py-1", children: _jsx("span", { className: "text-[var(--text-tertiary)] text-xs", children: "Loading older\u2026" }) })) : null, displayMessageRows.map((row, index) => {
+    return (_jsxs("div", { className: cx("relative isolate flex h-full w-full min-h-[640px] flex-col gap-3 overflow-hidden rounded-[30px] border border-[color:color-mix(in_srgb,_var(--border-default)_72%,_transparent)] bg-[linear-gradient(180deg,color-mix(in_srgb,_var(--bg-canvas)_95%,_transparent),color-mix(in_srgb,_var(--bg-surface)_98%,_transparent))] p-3 font-sans antialiased shadow-[var(--shadow-lg)]", showConversationList && "lg:grid lg:grid-cols-[280px_minmax(0,1fr)] lg:gap-3", className), style: withAssistantThemeStyles(style), children: [_jsx("div", { "aria-hidden": "true", className: "pointer-events-none absolute inset-x-0 top-0 h-44 bg-[radial-gradient(circle_at_top,color-mix(in_srgb,_var(--brand-glow)_78%,_transparent),transparent_72%)] opacity-80" }), showConversationList ? (_jsx(AssistantConversationList, { conversations: controller.conversations, activeConversationId: controller.activeConversationId, onSelectConversation: (conversationId) => controller.selectConversation(conversationId), onNewConversation: controller.clearMessages, renderConversationLabel: renderConversationLabel, className: "relative z-[1] hidden lg:flex lg:flex-col" })) : null, _jsxs("div", { className: "relative z-[1] flex h-full min-h-0 flex-col gap-3", children: [_jsxs("div", { className: "flex min-h-0 flex-1 flex-col overflow-hidden rounded-[24px] border border-[color:color-mix(in_srgb,_var(--border-default)_80%,_transparent)] bg-[linear-gradient(180deg,color-mix(in_srgb,_var(--bg-surface)_98%,_transparent),color-mix(in_srgb,_var(--bg-canvas)_74%,_transparent))] shadow-[var(--shadow-lg)]", children: [_jsx(AssistantHeader, { title: title, subtitle: subtitle, badge: _jsx("span", { className: "text-[10px] font-semibold uppercase tracking-[0.14em] text-[var(--text-on-brand)]", children: "AI" }), controls: (_jsxs(_Fragment, { children: [_jsx(AssistantModelPicker, { value: controller.conversationModel, options: availableModels, onChange: (nextModel) => { void handleModelChange(nextModel); }, disabled: isConversationBusy || isUpdatingModel }), _jsx("button", { type: "button", onClick: controller.clearMessages, title: "New conversation", className: "inline-flex h-9 items-center justify-center rounded-full border border-[color:color-mix(in_srgb,_var(--border-default)_80%,_transparent)] bg-[color:color-mix(in_srgb,_var(--bg-surface)_88%,_white)] px-3 text-[11px] font-medium text-[var(--text-secondary)] shadow-[var(--shadow-xs)] transition-colors hover:bg-[var(--bg-subtle)] hover:text-[var(--text-primary)]", children: "New" })] })) }), _jsxs(AssistantMessageViewport, { className: "min-h-[260px] bg-transparent", ref: messagesContainerRef, onScroll: updatePinnedState, children: [controller.messages.length === 0 && !isConversationBusy ? (emptyState || _jsx(EmptyState, { onSendMessage: (message) => { void controller.sendMessage(message); } })) : null, (controller.isLoadingMessages && controller.messages.length === 0) ? (_jsx("div", { className: "flex justify-center py-6", children: _jsx("span", { className: "text-[var(--text-tertiary)] text-sm", children: "Loading\u2026" }) })) : null, (controller.isLoadingOlderMessages && controller.messages.length > 0) ? (_jsx("div", { className: "flex justify-center py-1", children: _jsx("span", { className: "text-[var(--text-tertiary)] text-xs", children: "Loading older\u2026" }) })) : null, displayMessageRows.map((row, index) => {
                                         const previousRow = index > 0 ? displayMessageRows[index - 1] : null;
                                         const showAssistantHeader = row.message.role !== "assistant"
                                             ? false
                                             : previousRow?.message.role !== "assistant";
                                         const includesLastRawMessage = row.sourceIndexes.includes(controller.messages.length - 1);
                                         return (_jsx(MessageGroup, { message: row.message, onNavigateResource: onNavigateResource, onWidgetSendPrompt: handleWidgetSendPrompt, conversationId: controller.activeConversationId, isStreaming: isConversationBusy && includesLastRawMessage && row.message.role === "assistant", showAssistantHeader: showAssistantHeader, renderMessageContent: renderMessageContent, renderPresentedFile: renderPresentedFile, renderToolInvocation: renderToolInvocation }, row.id || index));
-                                    }), isConversationBusy && controller.messages.length > 0 && !activeToolBanner && !lastMessageHasContent ? (_jsx(ThinkingIndicator, {})) : null, controller.error ? (_jsx("div", { className: "bg-[color:color-mix(in_srgb,_var(--state-error)_12%,_transparent)] border border-[color:color-mix(in_srgb,_var(--state-error)_48%,_var(--border-subtle))] rounded-lg p-3 text-xs text-[var(--state-error)] flex items-start gap-2.5", children: _jsxs("div", { children: [_jsx("p", { className: "font-medium", children: "Something went wrong" }), _jsx("p", { className: "text-[var(--state-error)] mt-1", children: controller.error })] }) })) : null, (controller.messages.length > 0 || isConversationBusy || !!controller.error) ? (_jsx("div", { "aria-hidden": "true", className: "h-14 shrink-0" })) : null] })] }), _jsxs("div", { className: "relative rounded-2xl border border-[color:color-mix(in_srgb,_var(--border-default)_80%,_transparent)] bg-[var(--bg-surface)] p-2 shadow-[var(--shadow-md)]", children: [planSummary ? (_jsx("div", { className: "absolute bottom-[calc(100%+8px)] left-0 right-0 z-20", children: isPlanHidden ? (_jsxs("button", { type: "button", onClick: () => setIsPlanHidden(false), className: "inline-flex items-center gap-2 rounded-lg border border-[var(--border-default)] bg-[var(--bg-surface)] px-3 py-1.5 text-[11px] font-medium text-[var(--text-secondary)] hover:text-[var(--text-primary)] hover:bg-[var(--bg-subtle)] transition-colors", children: ["Show plan (", planSummary.completedCount, "/", planSummary.steps.length, ")"] })) : (_jsx(PlanSummaryStrip, { plan: planSummary, onHide: () => setIsPlanHidden(true) })) })) : null, isConversationBusy && activeToolBanner ? (_jsx("div", { className: "px-2 pb-1", children: _jsx("div", { className: "inline-flex max-w-full items-center gap-1.5 text-[11px] text-[var(--text-tertiary)] animate-in fade-in duration-200", children: _jsx("span", { className: "truncate", children: activeToolBanner.summary }) }) })) : null, activeAskQuestion && effectiveAskOverlayState && pendingAskUserInput ? (_jsxs("div", { className: "space-y-2", children: [_jsxs("div", { className: "flex items-start justify-between gap-3", children: [_jsxs("div", { children: [_jsxs("div", { className: "text-[11px] uppercase tracking-[0.12em] text-[var(--text-tertiary)]", children: ["Question ", effectiveAskOverlayState.currentQuestionIndex + 1, " of ", pendingAskUserInput.questions.length] }), _jsx("p", { className: "mt-1 text-[14px] font-medium text-[var(--text-primary)] leading-6", children: activeAskQuestion.question })] }), _jsx("button", { type: "button", onClick: () => dismissAskOverlay(effectiveAskOverlayState.toolCallId), className: "rounded-md px-2 py-1 text-[12px] text-[var(--text-tertiary)] hover:text-[var(--text-primary)] hover:bg-[var(--bg-subtle)] transition-colors", children: "Skip" })] }), _jsx("div", { className: "max-h-[260px] overflow-y-auto space-y-1.5 pr-1", children: activeAskQuestion.options.map((option, optionIndex) => {
-                                            const isSelected = activeAskAnswers.includes(option);
-                                            const rankLabel = activeAskQuestion.type === "rank_priorities" && isSelected
-                                                ? activeAskAnswers.indexOf(option) + 1
-                                                : null;
-                                            return (_jsx("button", { type: "button", onClick: () => updateAskAnswer(option), className: cx("w-full rounded-lg border px-2.5 py-2 text-left text-[13px] transition-colors", isSelected
-                                                    ? "border-[color:color-mix(in_srgb,_var(--brand-primary)_64%,_var(--border-subtle))] bg-[color:color-mix(in_srgb,_var(--brand-primary)_14%,_transparent)] text-[var(--text-primary)]"
-                                                    : "border-[var(--border-default)] bg-[var(--bg-canvas)] text-[var(--text-secondary)] hover:text-[var(--text-primary)] hover:bg-[var(--bg-subtle)]"), children: _jsxs("span", { className: "inline-flex items-center gap-2", children: [rankLabel ? (_jsx("span", { className: "inline-flex h-4 min-w-4 items-center justify-center rounded-full bg-[var(--brand-primary)] px-1 text-[10px] font-semibold text-[var(--text-on-brand)]", children: rankLabel })) : (_jsx("span", { className: cx("inline-block h-2.5 w-2.5 rounded-full border", isSelected
-                                                                ? "border-[var(--brand-primary)] bg-[var(--brand-primary)]"
-                                                                : "border-[var(--border-default)] bg-transparent") })), option] }) }, `${option}-${optionIndex}`));
-                                        }) }), (activeAskQuestion.type !== "single_select" || pendingAskUserInput.questions.length > 1) ? (_jsx("div", { className: "flex justify-end", children: _jsx("button", { type: "button", onClick: continueAskQuestions, disabled: !canContinueAsk, className: cx("rounded-md px-2.5 py-1.5 text-[12px] font-medium transition-colors", canContinueAsk
-                                                ? "bg-[var(--brand-primary)] text-[var(--text-on-brand)] hover:bg-[color:color-mix(in_srgb,_var(--brand-primary)_88%,_var(--text-primary))]"
-                                                : "bg-[var(--bg-subtle)] text-[var(--text-tertiary)]"), children: effectiveAskOverlayState.currentQuestionIndex >= pendingAskUserInput.questions.length - 1 ? "Use answers" : "Continue" }) })) : null] })) : (_jsxs("div", { className: "space-y-1.5", children: [controller.pendingFiles.length > 0 ? (_jsx("div", { className: "flex flex-wrap items-center gap-1.5 px-1", children: controller.pendingFiles.map((file) => {
-                                            const fileKey = `${file.name}:${file.size}:${file.lastModified}`;
-                                            return (_jsx("div", { children: renderPendingFile({
-                                                    file,
-                                                    remove: () => controller.removePendingFile(fileKey),
-                                                }) }, fileKey));
-                                        }) })) : null, _jsxs("div", { className: "relative flex items-end gap-2", children: [_jsx("input", { ref: fileInputRef, type: "file", multiple: true, className: "hidden", onChange: (event) => { void handleUploadSelection(event.target.files); } }), _jsx("button", { type: "button", onClick: () => fileInputRef.current?.click(), disabled: isConversationBusy || controller.isUploadingFiles, className: cx("mb-1.5 ml-1 h-9 w-9 rounded-full flex items-center justify-center transition-colors", isConversationBusy || controller.isUploadingFiles
-                                                    ? "bg-[var(--bg-subtle)] text-[var(--text-tertiary)]"
-                                                    : "bg-[var(--bg-subtle)] text-[var(--text-secondary)] hover:bg-[var(--bg-canvas)] hover:text-[var(--text-primary)]"), title: "Upload files", children: controller.isUploadingFiles ? "…" : "＋" }), _jsx("textarea", { ref: inputRef, value: draft, onChange: (event) => setDraft(event.target.value), onKeyDown: handleKeyDown, placeholder: placeholder, className: "flex-1 resize-none border-0 bg-transparent px-3 py-2.5 text-[14px] text-[var(--text-primary)] leading-6 focus:ring-0 focus:outline-none placeholder:text-[var(--text-tertiary)] min-h-[48px] max-h-[220px]", rows: 1, disabled: isConversationBusy }), _jsx("div", { className: "pb-1.5 pr-1.5", children: _jsx("button", { onClick: isConversationBusy ? controller.stop : () => { void handleSubmit(); }, disabled: !isConversationBusy && !draft.trim(), className: cx("h-9 w-9 rounded-full flex items-center justify-center transition-all duration-200", isConversationBusy
-                                                        ? "bg-[var(--text-primary)] text-[var(--text-inverse)] hover:bg-[color:color-mix(in_srgb,_var(--text-primary)_80%,_transparent)] hover:scale-105"
-                                                        : draft.trim()
-                                                            ? "bg-[var(--brand-primary)] text-[var(--text-on-brand)] shadow-[var(--shadow-xs)] hover:bg-[color:color-mix(in_srgb,_var(--brand-primary)_88%,_var(--text-primary))]"
-                                                            : "bg-[var(--bg-subtle)] text-[var(--text-tertiary)]"), title: isConversationBusy ? "Stop generating" : "Send message", children: isConversationBusy ? "■" : "→" }) })] })] }))] })] })] }));
+                                    }), isConversationBusy && controller.messages.length > 0 && !activeToolBanner && !lastMessageHasContent ? (_jsx(ThinkingIndicator, {})) : null, controller.error ? (_jsx("div", { className: "bg-[color:color-mix(in_srgb,_var(--state-error)_12%,_transparent)] border border-[color:color-mix(in_srgb,_var(--state-error)_48%,_var(--border-subtle))] rounded-lg p-3 text-xs text-[var(--state-error)] flex items-start gap-2.5", children: _jsxs("div", { children: [_jsx("p", { className: "font-medium", children: "Something went wrong" }), _jsx("p", { className: "text-[var(--state-error)] mt-1", children: controller.error })] }) })) : null, (controller.messages.length > 0 || isConversationBusy || !!controller.error) ? (_jsx("div", { "aria-hidden": "true", className: "h-14 shrink-0" })) : null] })] }), _jsx(AssistantComposer, { floating: planSummary ? (isPlanHidden ? (_jsxs("button", { type: "button", onClick: () => setIsPlanHidden(false), className: "inline-flex items-center gap-2 rounded-lg border border-[var(--border-default)] bg-[var(--bg-surface)] px-3 py-1.5 text-[11px] font-medium text-[var(--text-secondary)] transition-colors hover:bg-[var(--bg-subtle)] hover:text-[var(--text-primary)]", children: ["Show plan (", planSummary.completedCount, "/", planSummary.steps.length, ")"] })) : (_jsx(PlanSummaryStrip, { plan: planSummary, onHide: () => setIsPlanHidden(true) }))) : undefined, status: isConversationBusy && activeToolBanner ? (_jsx(AssistantStatusPill, { label: activeToolBanner.summary, subtle: true })) : undefined, pendingFiles: controller.pendingFiles.length > 0 ? (_jsx(_Fragment, { children: controller.pendingFiles.map((file) => {
+                                const fileKey = `${file.name}:${file.size}:${file.lastModified}`;
+                                return (_jsx("div", { children: renderPendingFile({
+                                        file,
+                                        remove: () => controller.removePendingFile(fileKey),
+                                    }) }, fileKey));
+                            }) })) : undefined, children: activeAskQuestion && effectiveAskOverlayState && pendingAskUserInput ? (_jsx(AssistantAskOverlay, { questionNumber: effectiveAskOverlayState.currentQuestionIndex + 1, totalQuestions: pendingAskUserInput.questions.length, question: activeAskQuestion.question, options: activeAskQuestion.options, selectedOptions: activeAskAnswers, canContinue: canContinueAsk, continueLabel: effectiveAskOverlayState.currentQuestionIndex >= pendingAskUserInput.questions.length - 1 ? "Use answers" : "Continue", onSelectOption: updateAskAnswer, onContinue: activeAskQuestion.type !== "single_select" || pendingAskUserInput.questions.length > 1 ? continueAskQuestions : undefined, onSkip: () => dismissAskOverlay(effectiveAskOverlayState.toolCallId), mode: activeAskQuestion.type })) : (_jsxs("div", { className: "relative flex items-end gap-2", children: [_jsx("input", { ref: fileInputRef, type: "file", multiple: true, className: "hidden", onChange: (event) => { void handleUploadSelection(event.target.files); } }), _jsx("button", { type: "button", onClick: () => fileInputRef.current?.click(), disabled: isConversationBusy || controller.isUploadingFiles, className: cx("mb-1.5 ml-1 flex h-10 w-10 items-center justify-center rounded-full border border-[color:color-mix(in_srgb,_var(--border-default)_78%,_transparent)] transition-colors", isConversationBusy || controller.isUploadingFiles
+                                        ? "bg-[var(--bg-subtle)] text-[var(--text-tertiary)]"
+                                        : "bg-[color:color-mix(in_srgb,_var(--bg-surface)_78%,_white)] text-[var(--text-secondary)] hover:bg-[var(--bg-subtle)] hover:text-[var(--text-primary)]"), title: "Upload files", children: controller.isUploadingFiles ? "..." : "+" }), _jsx("textarea", { ref: inputRef, value: draft, onChange: (event) => setDraft(event.target.value), onKeyDown: handleKeyDown, placeholder: placeholder, className: "min-h-[52px] max-h-[220px] flex-1 resize-none border-0 bg-transparent px-3 py-2.5 text-[14px] leading-6 text-[var(--text-primary)] placeholder:text-[var(--text-tertiary)] focus:outline-none focus:ring-0", rows: 1, disabled: isConversationBusy }), _jsx("div", { className: "pb-1.5 pr-1.5", children: _jsx("button", { onClick: isConversationBusy ? controller.stop : () => { void handleSubmit(); }, disabled: !isConversationBusy && !draft.trim(), className: cx("flex h-10 w-10 items-center justify-center rounded-full transition-all duration-200", isConversationBusy
+                                            ? "bg-[var(--text-primary)] text-[var(--text-inverse)] hover:scale-105 hover:bg-[color:color-mix(in_srgb,_var(--text-primary)_80%,_transparent)]"
+                                            : draft.trim()
+                                                ? "bg-[var(--brand-primary)] text-[var(--text-on-brand)] shadow-[var(--shadow-xs)] hover:bg-[color:color-mix(in_srgb,_var(--brand-primary)_88%,_var(--text-primary))]"
+                                                : "bg-[var(--bg-subtle)] text-[var(--text-tertiary)]"), title: isConversationBusy ? "Stop generating" : "Send message", children: isConversationBusy ? "[]" : "->" }) })] })) })] })] }));
 }

package/dist/react/components/assistant-types.d.ts

@@ -1,4 +1,4 @@
-import type { ReactNode } from "react";
+import type { CSSProperties, ReactNode } from "react";
 import type { AssistantRenderableMessage, AssistantToolInvocation } from "../useAssistantController.js";
 export interface AssistantConversationListItem {
     id: string;
@@ -61,6 +61,8 @@ export interface AssistantExperienceCustomizationProps {
     subtitle?: ReactNode;
     placeholder?: string;
     emptyState?: ReactNode;
+    className?: string;
+    style?: CSSProperties;
     draft?: string;
     onDraftChange?: (value: string) => void;
     showConversationList?: boolean;

package/dist/react/index.d.ts

@@ -13,8 +13,12 @@ export type { UseAssistantRuntimeOptions, UseAssistantRuntimeResult, } from "./u
 export { useAssistantController } from "./useAssistantController.js";
 export type { AssistantAction, AssistantConversationScope, AssistantMessagePart, AssistantRenderableMessage, AssistantToolInvocation, UseAssistantControllerOptions, UseAssistantControllerResult, } from "./useAssistantController.js";
 export type { AssistantConversationRenderArgs, AssistantControllerView, AssistantExperienceCustomizationProps, AssistantMessageRenderArgs, AssistantPendingFileRenderArgs, AssistantPresentedFileRenderArgs, AssistantToolRenderArgs, } from "./components/assistant-types.js";
+export { AssistantAskOverlay, AssistantComposer, AssistantConversationList, AssistantHeader, AssistantMessageViewport, AssistantModelPicker, AssistantPendingFileChip, AssistantShellLayout, AssistantStatusPill, assistantThemeStyles, withAssistantThemeStyles, } from "./components/AssistantChrome.js";
+export type { AssistantAskOverlayProps, AssistantComposerProps, AssistantConversationListProps, AssistantHeaderProps, AssistantMessageViewportProps, AssistantModelPickerProps, AssistantPendingFileChipProps, AssistantShellLayoutProps, AssistantStatusPillProps, } from "./components/AssistantChrome.js";
 export { AssistantExperienceView } from "./components/AssistantExperience.js";
 export type { ActiveToolBanner, AskUserInputQuestion, AssistantExperienceViewProps, DisplayMessageRow, PendingAskUserInput, PlanStepState, PlanSummaryState, } from "./components/AssistantExperience.js";
+export { AssistantEmbedded } from "./components/AssistantEmbedded.js";
+export type { AssistantEmbeddedProps } from "./components/AssistantEmbedded.js";
 export { buildDisplayMessageRows, dedupToolInvocations, EmptyState, findPendingAskUserInput, formatAskUserInputAnswers, getActiveToolBanner, extractPresentFilePathsFromInvocation, latestPlanSummary, MessageGroup, PlanSummaryStrip, ThinkingIndicator, } from "./components/AssistantExperience.js";
 export { useTaskSession } from "./useTaskSession.js";
 export type { CreateTaskInput, UseTaskSessionOptions, UseTaskSessionResult, } from "./useTaskSession.js";

package/dist/react/index.js

@@ -5,7 +5,9 @@ export { useAssistantRun } from "./useAssistantRun.js";
 export { useAssistantSession } from "./useAssistantSession.js";
 export { useAssistantRuntime } from "./useAssistantRuntime.js";
 export { useAssistantController } from "./useAssistantController.js";
+export { AssistantAskOverlay, AssistantComposer, AssistantConversationList, AssistantHeader, AssistantMessageViewport, AssistantModelPicker, AssistantPendingFileChip, AssistantShellLayout, AssistantStatusPill, assistantThemeStyles, withAssistantThemeStyles, } from "./components/AssistantChrome.js";
 export { AssistantExperienceView } from "./components/AssistantExperience.js";
+export { AssistantEmbedded } from "./components/AssistantEmbedded.js";
 export { buildDisplayMessageRows, dedupToolInvocations, EmptyState, findPendingAskUserInput, formatAskUserInputAnswers, getActiveToolBanner, extractPresentFilePathsFromInvocation, latestPlanSummary, MessageGroup, PlanSummaryStrip, ThinkingIndicator, } from "./components/AssistantExperience.js";
 export { useTaskSession } from "./useTaskSession.js";
 export { useFunctionSession } from "./useFunctionSession.js";

package/dist/react/useAssistantController.js

@@ -708,14 +708,16 @@ export function useAssistantController({ client, podId, assistantId, organizatio
     }, [conversations]);
     useEffect(() => {
         const conversationId = activeConversationIdRef.current;
-        if (!conversationId)
-            return;
-        if (!runtimeMessages || runtimeMessages.length === 0)
+        if (!conversationId) {
+            setMessages([]);
             return;
+        }
         const normalized = sortMessagesByCreatedAt(runtimeMessages)
-            .filter((message) => !message.conversation_id || message.conversation_id === conversationId);
-        if (normalized.length === 0)
+            .filter((message) => message.conversation_id === conversationId);
+        if (normalized.length === 0) {
+            setMessages([]);
             return;
+        }
         const nextMessages = mapConversationMessages(normalized);
         const pendingText = sessionStreamingText.trim();
         if (pendingText.length > 0) {

package/dist/react/useAssistantRuntime.js

@@ -43,8 +43,15 @@ function upsertRuntimeMessage(previous, incoming) {
     next.push(incoming);
     return next;
 }
-function toRuntimeMessage(message) {
-    return message;
+function toRuntimeMessage(message, fallbackConversationId) {
+    const runtimeMessage = message;
+    if (runtimeMessage.conversation_id || !fallbackConversationId) {
+        return runtimeMessage;
+    }
+    return {
+        ...runtimeMessage,
+        conversation_id: fallbackConversationId,
+    };
 }
 function buildOptimisticId() {
     if (typeof globalThis.crypto !== "undefined" && typeof globalThis.crypto.randomUUID === "function") {
@@ -56,16 +63,16 @@ export function useAssistantRuntime({ conversationId = null, sessionMessages = [
     const [runtimeMessages, setRuntimeMessages] = useState([]);
     const mergeMessages = useCallback((messages) => {
         setRuntimeMessages((previous) => {
-            const merged = messages.reduce((accumulator, message) => upsertRuntimeMessage(accumulator, toRuntimeMessage(message)), previous);
+            const merged = messages.reduce((accumulator, message) => upsertRuntimeMessage(accumulator, toRuntimeMessage(message, conversationId)), previous);
             return [...merged].sort((a, b) => messageTime(a) - messageTime(b));
         });
-    }, []);
+    }, [conversationId]);
     const replaceLoadedMessages = useCallback((messages) => {
-        setRuntimeMessages((previous) => {
-            const next = messages.reduce((accumulator, message) => upsertRuntimeMessage(accumulator, toRuntimeMessage(message)), previous);
-            return [...next].sort((a, b) => messageTime(a) - messageTime(b));
-        });
-    }, []);
+        const normalized = messages
+            .map((message) => toRuntimeMessage(message, conversationId))
+            .filter((message) => !conversationId || message.conversation_id === conversationId);
+        setRuntimeMessages([...normalized].sort((a, b) => messageTime(a) - messageTime(b)));
+    }, [conversationId]);
     const appendOptimisticUserMessage = useCallback((content, options) => {
         const trimmed = content.trim();
         const optimisticConversationId = options?.conversationId ?? conversationId ?? undefined;
@@ -98,8 +105,8 @@ export function useAssistantRuntime({ conversationId = null, sessionMessages = [
         if (sessionMessages.length === 0)
             return;
         const normalized = sessionMessages
-            .map((message) => toRuntimeMessage(message))
-            .filter((message) => !conversationId || !message.conversation_id || message.conversation_id === conversationId);
+            .map((message) => toRuntimeMessage(message, conversationId))
+            .filter((message) => !conversationId || message.conversation_id === conversationId);
         if (normalized.length === 0)
             return;
         mergeMessages(normalized);

package/dist/react/useAssistantSession.js

@@ -57,6 +57,7 @@ export function useAssistantSession(options) {
     const [isStreaming, setIsStreaming] = useState(false);
     const [error, setError] = useState(null);
     const abortRef = useRef(null);
+    const conversationIdRef = useRef(externalConversationId);
     const statusRef = useRef(undefined);
     const streamingTextRef = useRef("");
     const autoResumedKeyRef = useRef(null);
@@ -65,20 +66,30 @@ export function useAssistantSession(options) {
     const onMessageRef = useRef(onMessage);
     const onErrorRef = useRef(onError);
     const setConversationId = useCallback((nextConversationId) => {
-        setConversationIdState(nextConversationId);
-        autoResumedKeyRef.current = null;
-        streamingTextRef.current = "";
-        setStreamingText("");
-        if (!nextConversationId) {
+        abortRef.current?.abort();
+        abortRef.current = null;
+        setConversationIdState((currentConversationId) => {
+            if (currentConversationId === nextConversationId) {
+                return currentConversationId;
+            }
+            autoResumedKeyRef.current = null;
+            streamingTextRef.current = "";
+            setStreamingText("");
             setConversation(null);
             setStatus(undefined);
             statusRef.current = undefined;
             setMessages([]);
-        }
+            setError(null);
+            setIsStreaming(false);
+            return nextConversationId;
+        });
     }, []);
     useEffect(() => {
-        setConversationIdState(externalConversationId);
-    }, [externalConversationId]);
+        setConversationId(externalConversationId);
+    }, [externalConversationId, setConversationId]);
+    useEffect(() => {
+        conversationIdRef.current = conversationId;
+    }, [conversationId]);
     useEffect(() => {
         onEventRef.current = onEvent;
     }, [onEvent]);
@@ -206,6 +217,13 @@ export function useAssistantSession(options) {
                 page_token: input.pageToken,
             });
             const nextMessages = response.items ?? [];
+            if (conversationIdRef.current !== id) {
+                return {
+                    items: nextMessages,
+                    limit: response.limit ?? input.limit ?? 20,
+                    next_page_token: response.next_page_token,
+                };
+            }
             setMessages((previous) => nextMessages.reduce((accumulator, message) => upsertConversationMessage(accumulator, message), previous));
             return {
                 items: nextMessages,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lemma-sdk",
-  "version": "0.2.11",
+  "version": "0.2.13",
   "description": "Official TypeScript SDK for Lemma pod-scoped APIs",
   "type": "module",
   "main": "dist/index.js",