@classic-homes/agent-chat 0.4.1 → 0.6.0

package/README.md

@@ -51,6 +51,10 @@ agent-api origin that serves `/frame`; artifacts and MCP-UI resources only ever
   (`ComposerPrompt.text` may be a loader, e.g. fetching the template).
 - `ToolTimeline`: tool calls with status and duration, delegations nested; `toolLabels` maps
   tool names to readable ones (`AgentChat` passes both through).
+- `Welcome`: the empty conversation, with a greeting (`userName`), a capability line and up to
+  four `suggestions` that send when chosen. `AgentChat` shows it unless the host passes an
+  `empty` snippet, a loading skeleton while an existing conversation's transcript arrives, and
+  an error with Try again when that load fails.
 - `ArtifactPanel`, `UiFrame`, `ModeBanner`.
 
 Publishing: `docs/operations/package-publishing.md`.

package/dist/components/AgentChat.svelte

@@ -7,15 +7,25 @@
     FileRef,
   } from '@classic-homes/agent-contracts';
   import type { BackendMode } from '@classic-homes/agent-contracts';
-  import { cn, ResizablePanes, Sheet } from '@classic-homes/theme-svelte';
+  import {
+    Alert,
+    Button,
+    cn,
+    Icon,
+    ResizablePanes,
+    Sheet,
+    Skeleton,
+  } from '@classic-homes/theme-svelte';
   import { MediaQuery } from 'svelte/reactivity';
   import { releaseStuckBodyLock } from '../body-lock.js';
   import type { ComposerPrompt } from '../composer-prompts.js';
   import { ChatSession } from '../session.svelte.js';
+  import type { WelcomeSuggestion } from '../welcome.js';
   import ArtifactPanel from './ArtifactPanel.svelte';
   import Composer from './Composer.svelte';
   import MessageList from './MessageList.svelte';
   import ModeBanner from './ModeBanner.svelte';
+  import Welcome from './Welcome.svelte';
 
   interface Props {
     client: AgentApiClient;
@@ -45,9 +55,18 @@
     prompts?: ComposerPrompt[];
     /** Readable tool names for the timeline, by tool name (`server/name` or `name`). */
     toolLabels?: Record<string, string>;
+    /** The signed-in user's name for the welcome greeting (first word shown). */
+    userName?: string | null;
+    /** Starters on an empty conversation (up to four); choosing one sends it. */
+    suggestions?: WelcomeSuggestion[];
+    /** Replaces the welcome's time-of-day greeting. */
+    welcomeTitle?: string;
+    /** Replaces the welcome's capability line. */
+    welcomeDescription?: string;
     /** Rendered above the transcript, e.g. a `ChatHeader`. */
     header?: import('svelte').Snippet;
     context?: import('svelte').Snippet;
+    /** Replaces the default `Welcome` on an empty conversation. */
     empty?: import('svelte').Snippet;
     class?: string;
   }
@@ -69,6 +88,10 @@
     placeholder,
     prompts,
     toolLabels,
+    userName,
+    suggestions,
+    welcomeTitle,
+    welcomeDescription,
     header,
     context,
     empty,
@@ -94,15 +117,20 @@
       }
     },
   });
+  let attemptedId: string | null = null;
   // The constructor already knows `conversationId`; what decides a fetch is whether the
   // transcript for it has been loaded (or started) in this session.
   $effect(() => {
     if (
       conversationId &&
       conversationId !== session.loadedConversationId &&
+      conversationId !== attemptedId &&
       session.status !== 'loading'
-    )
+    ) {
+      // Once per id: a failed load waits for Try again instead of retrying in a loop.
+      attemptedId = conversationId;
       void session.load(conversationId);
+    }
   });
   $effect(() => {
     if (mode && !session.mode) session.mode = mode;
@@ -135,19 +163,82 @@
     const last = session.messages[session.messages.length - 1];
     if (last?.role === 'assistant') void session.retry(last.requestId);
   }
+  // An existing conversation whose transcript has not arrived yet: show a skeleton, not the
+  // welcome (which would flash before the messages).
+  const pending = $derived(
+    session.status === 'loading' ||
+      (!!conversationId &&
+        conversationId !== session.loadedConversationId &&
+        !session.loadError &&
+        session.messages.length === 0),
+  );
+  function reload(): void {
+    if (conversationId) void session.load(conversationId);
+  }
   function prompt(text: string): void {
     draft = text;
     composer?.focus();
   }
 </script>
 
+{#snippet emptyState()}
+  {#if pending}
+    <div
+      class="mx-auto flex w-full max-w-3xl flex-col gap-6 px-4 py-6"
+      aria-busy="true"
+      data-agent-loading
+    >
+      <span class="sr-only" role="status">Loading conversation…</span>
+      <Skeleton class="ml-auto h-10 w-2/5 rounded-2xl" />
+      <div class="flex flex-col gap-2">
+        <Skeleton variant="text" class="w-11/12" />
+        <Skeleton variant="text" class="w-4/5" />
+        <Skeleton variant="text" class="w-3/5" />
+      </div>
+      <Skeleton class="ml-auto h-10 w-1/3 rounded-2xl" />
+      <div class="flex flex-col gap-2">
+        <Skeleton variant="text" class="w-10/12" />
+        <Skeleton variant="text" class="w-2/3" />
+      </div>
+    </div>
+  {:else if session.loadError}
+    <!-- The alert above explains it; no welcome under a failed load. -->
+  {:else if empty}
+    {@render empty()}
+  {:else}
+    <Welcome
+      name={userName}
+      title={welcomeTitle}
+      description={welcomeDescription}
+      {suggestions}
+      compact={variant === 'panel'}
+      disabled={session.status !== 'idle'}
+      onselect={(text) => void send(text)}
+    />
+  {/if}
+{/snippet}
+
 {#snippet chat()}
   <div class="flex h-full min-w-0 flex-1 flex-col">
     {#if header}{@render header()}{/if}
     <ModeBanner mode={session.mode} />
-    {#if session.loadError}<div class="px-4 py-2 text-sm text-destructive" role="alert">
-        {session.loadError}
-      </div>{/if}
+    {#if session.loadError}
+      <div class="mx-auto w-full max-w-3xl px-4 pt-3">
+        <Alert variant="error">
+          <div class="flex flex-wrap items-center gap-x-3 gap-y-1">
+            <p class="min-w-0 flex-1">
+              <strong class="font-semibold">Could not load this conversation.</strong>
+              {session.loadError}
+            </p>
+            {#if conversationId}
+              <Button variant="outline" size="sm" onclick={reload}>
+                <Icon name="refresh" size={14} /> Try again
+              </Button>
+            {/if}
+          </div>
+        </Alert>
+      </div>
+    {/if}
     <MessageList
       messages={session.messages}
       streaming={session.streaming}
@@ -163,8 +254,10 @@
       ontool={(name, params) => ontoolrequest?.(name, params)}
       {onnotify}
       onretry={retry}
+      onregenerate={(requestId) => void session.regenerate(requestId)}
+      onedit={(requestId, text) => void session.edit(requestId, text)}
       oncontinue={() => void session.send('Continue.')}
-      {empty}
+      empty={emptyState}
     />
     <Composer
       bind:this={composer}

package/dist/components/AgentChat.svelte.d.ts

@@ -2,6 +2,7 @@ import type { AgentApiClient } from '@classic-homes/agent-client';
 import type { AgentKey, ClientKind, DocumentContext } from '@classic-homes/agent-contracts';
 import type { BackendMode } from '@classic-homes/agent-contracts';
 import type { ComposerPrompt } from '../composer-prompts.js';
+import type { WelcomeSuggestion } from '../welcome.js';
 interface Props {
     client: AgentApiClient;
     /** Sandbox origin for artifacts and MCP-UI (agent-api `/frame`). */
@@ -30,9 +31,18 @@ interface Props {
     prompts?: ComposerPrompt[];
     /** Readable tool names for the timeline, by tool name (`server/name` or `name`). */
     toolLabels?: Record<string, string>;
+    /** The signed-in user's name for the welcome greeting (first word shown). */
+    userName?: string | null;
+    /** Starters on an empty conversation (up to four); choosing one sends it. */
+    suggestions?: WelcomeSuggestion[];
+    /** Replaces the welcome's time-of-day greeting. */
+    welcomeTitle?: string;
+    /** Replaces the welcome's capability line. */
+    welcomeDescription?: string;
     /** Rendered above the transcript, e.g. a `ChatHeader`. */
     header?: import('svelte').Snippet;
     context?: import('svelte').Snippet;
+    /** Replaces the default `Welcome` on an empty conversation. */
     empty?: import('svelte').Snippet;
     class?: string;
 }

package/dist/components/AgentChat.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AgentChat.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/AgentChat.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EACR,QAAQ,EACR,UAAU,EACV,eAAe,EAEhB,MAAM,gCAAgC,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAIlE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAQ3D,UAAU,KAAK;IACb,MAAM,EAAE,cAAc,CAAC;IACvB,oEAAoE;IACpE,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,+EAA+E;IAC/E,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,eAAe,GAAG,IAAI,GAAG,SAAS,CAAC;IACtD,qBAAqB,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,gFAAgF;IAChF,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,MAAM,EAAE,MAAM,CAAC;KAChB,KAAK,IAAI,CAAC;IACX,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,iGAAiG;IACjG,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,0DAA0D;IAC1D,MAAM,CAAC,EAAE,OAAO,QAAQ,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,QAAQ,EAAE,OAAO,CAAC;IACnC,KAAK,CAAC,EAAE,OAAO,QAAQ,EAAE,OAAO,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAgJH,QAAA,MAAM,SAAS,2CAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}
+{"version":3,"file":"AgentChat.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/AgentChat.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EACR,QAAQ,EACR,UAAU,EACV,eAAe,EAEhB,MAAM,gCAAgC,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gCAAgC,CAAC;AAYlE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAE7D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAQrD,UAAU,KAAK;IACb,MAAM,EAAE,cAAc,CAAC;IACvB,oEAAoE;IACpE,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,+EAA+E;IAC/E,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,eAAe,GAAG,IAAI,GAAG,SAAS,CAAC;IACtD,qBAAqB,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,gFAAgF;IAChF,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE;QACjB,SAAS,EAAE,MAAM,CAAC;QAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAC9B,MAAM,EAAE,MAAM,CAAC;KAChB,KAAK,IAAI,CAAC;IACX,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,iGAAiG;IACjG,aAAa,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IAC7E,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wDAAwD;IACxD,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,oFAAoF;IACpF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,6EAA6E;IAC7E,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,6EAA6E;IAC7E,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC,mDAAmD;IACnD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,8CAA8C;IAC9C,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,0DAA0D;IAC1D,MAAM,CAAC,EAAE,OAAO,QAAQ,EAAE,OAAO,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,QAAQ,EAAE,OAAO,CAAC;IACnC,+DAA+D;IAC/D,KAAK,CAAC,EAAE,OAAO,QAAQ,EAAE,OAAO,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA8MH,QAAA,MAAM,SAAS,2CAAwC,CAAC;AACxD,KAAK,SAAS,GAAG,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC;AAC9C,eAAe,SAAS,CAAC"}

package/dist/components/AssistantMessage.svelte

@@ -30,6 +30,8 @@
     ontool?: (toolName: string, params?: Record<string, unknown>) => void;
     onnotify?: (message: string) => void;
     onretry?: () => void;
+    /** Ask for a new answer to the same question (the latest finished answer). */
+    onregenerate?: () => void;
     /** Ask the agent to pick up a stopped or cut-short answer. */
     oncontinue?: () => void;
   }
@@ -46,6 +48,7 @@
     ontool,
     onnotify,
     onretry,
+    onregenerate,
     oncontinue,
   }: Props = $props();
 
@@ -179,6 +182,7 @@
         text={message.text}
         createdAt={message.createdAt}
         visible={last}
+        {onregenerate}
         class="-ml-1.5"
       />
     {/if}

package/dist/components/AssistantMessage.svelte.d.ts

@@ -13,6 +13,8 @@ interface Props {
     ontool?: (toolName: string, params?: Record<string, unknown>) => void;
     onnotify?: (message: string) => void;
     onretry?: () => void;
+    /** Ask for a new answer to the same question (the latest finished answer). */
+    onregenerate?: () => void;
     /** Ask the agent to pick up a stopped or cut-short answer. */
     oncontinue?: () => void;
 }

package/dist/components/AssistantMessage.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantMessage.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/AssistantMessage.svelte.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAYpD,UAAU,KAAK;IACb,OAAO,EAAE,gBAAgB,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uFAAuF;IACvF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,cAAc,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACtE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAwJH;;;GAGG;AACH,QAAA,MAAM,gBAAgB,2CAAwC,CAAC;AAC/D,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC5D,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"AssistantMessage.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/AssistantMessage.svelte.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAYpD,UAAU,KAAK;IACb,OAAO,EAAE,gBAAgB,CAAC;IAC1B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,uFAAuF;IACvF,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,cAAc,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACtE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,8EAA8E;IAC9E,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAyJH;;;GAGG;AACH,QAAA,MAAM,gBAAgB,2CAAwC,CAAC;AAC/D,KAAK,gBAAgB,GAAG,UAAU,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAC5D,eAAe,gBAAgB,CAAC"}

package/dist/components/MessageActions.svelte

@@ -1,11 +1,12 @@
 <!--
   @component
-  Per-message action bar: copy the raw text and the time it was sent. Hidden until the message is
+  Per-message action bar: copy the raw text, regenerate or edit (latest turn only) and the time
+  it was sent. Hidden until the message is
   hovered or holds focus, except where `visible` (the last message) or on touch screens, which
   have no hover.
 -->
 <script lang="ts">
-  import { cn, CopyButton, Tooltip } from '@classic-homes/theme-svelte';
+  import { Button, cn, CopyButton, Icon, Tooltip } from '@classic-homes/theme-svelte';
   import { formatDateTime, formatTime } from '../message-format.js';
 
   interface Props {
@@ -14,9 +15,21 @@
     /** Keep the bar visible without hover (the last message). */
     visible?: boolean;
     align?: 'start' | 'end';
+    /** Offer "Regenerate" (the latest answer). */
+    onregenerate?: () => void;
+    /** Offer "Edit" (the latest question). */
+    onedit?: () => void;
     class?: string;
   }
-  let { text, createdAt, visible = false, align = 'start', class: className }: Props = $props();
+  let {
+    text,
+    createdAt,
+    visible = false,
+    align = 'start',
+    onregenerate,
+    onedit,
+    class: className,
+  }: Props = $props();
 </script>
 
 <div
@@ -39,6 +52,26 @@
       class="h-7 w-7"
     />
   {/if}
+  {#if onedit}
+    <Button
+      variant="ghost"
+      size="icon"
+      class="h-7 w-7"
+      aria-label="Edit message"
+      title="Edit"
+      onclick={onedit}><Icon name="edit" size={14} /></Button
+    >
+  {/if}
+  {#if onregenerate}
+    <Button
+      variant="ghost"
+      size="icon"
+      class="h-7 w-7"
+      aria-label="Regenerate response"
+      title="Regenerate"
+      onclick={onregenerate}><Icon name="refresh" size={14} /></Button
+    >
+  {/if}
   <Tooltip content={formatDateTime(createdAt)}>
     {#snippet children({ props })}
       <!-- Focusable so keyboard users can read the full date in the tooltip. -->

package/dist/components/MessageActions.svelte.d.ts

@@ -4,10 +4,15 @@ interface Props {
     /** Keep the bar visible without hover (the last message). */
     visible?: boolean;
     align?: 'start' | 'end';
+    /** Offer "Regenerate" (the latest answer). */
+    onregenerate?: () => void;
+    /** Offer "Edit" (the latest question). */
+    onedit?: () => void;
     class?: string;
 }
 /**
- * Per-message action bar: copy the raw text and the time it was sent. Hidden until the message is
+ * Per-message action bar: copy the raw text, regenerate or edit (latest turn only) and the time
+ * it was sent. Hidden until the message is
  * hovered or holds focus, except where `visible` (the last message) or on touch screens, which
  * have no hover.
  */

package/dist/components/MessageActions.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MessageActions.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/MessageActions.svelte.ts"],"names":[],"mappings":"AAOE,UAAU,KAAK;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAgCH;;;;GAIG;AACH,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}
+{"version":3,"file":"MessageActions.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/MessageActions.svelte.ts"],"names":[],"mappings":"AAOE,UAAU,KAAK;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,OAAO,GAAG,KAAK,CAAC;IACxB,8CAA8C;IAC9C,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,0CAA0C;IAC1C,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA8CH;;;;;GAKG;AACH,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/components/MessageItem.svelte

@@ -20,13 +20,16 @@
     ontool?: (toolName: string, params?: Record<string, unknown>) => void;
     onnotify?: (message: string) => void;
     onretry?: () => void;
+    onregenerate?: () => void;
     oncontinue?: () => void;
+    /** User messages only: edit and resend. */
+    onedit?: (text: string) => void;
   }
-  let { message, last = false, ...rest }: Props = $props();
+  let { message, last = false, onedit, ...rest }: Props = $props();
 </script>
 
 {#if message.role === 'user'}
-  <UserMessage {message} {last} />
+  <UserMessage {message} {last} {onedit} />
 {:else}
   <AssistantMessage {message} {last} {...rest} />
 {/if}

package/dist/components/MessageItem.svelte.d.ts

@@ -12,7 +12,10 @@ interface Props {
     ontool?: (toolName: string, params?: Record<string, unknown>) => void;
     onnotify?: (message: string) => void;
     onretry?: () => void;
+    onregenerate?: () => void;
     oncontinue?: () => void;
+    /** User messages only: edit and resend. */
+    onedit?: (text: string) => void;
 }
 /** One transcript entry: a `UserMessage` or an `AssistantMessage`. */
 declare const MessageItem: import("svelte").Component<Props, {}, "">;

package/dist/components/MessageItem.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MessageItem.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/MessageItem.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAK/C,UAAU,KAAK;IACb,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,cAAc,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACtE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAkBH,sEAAsE;AACtE,QAAA,MAAM,WAAW,2CAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}
+{"version":3,"file":"MessageItem.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/MessageItem.svelte.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAK/C,UAAU,KAAK;IACb,OAAO,EAAE,WAAW,CAAC;IACrB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,cAAc,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACtE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,2CAA2C;IAC3C,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AAkBH,sEAAsE;AACtE,QAAA,MAAM,WAAW,2CAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}

package/dist/components/MessageList.svelte

@@ -17,6 +17,10 @@
     ontool?: (toolName: string, params?: Record<string, unknown>) => void;
     onnotify?: (message: string) => void;
     onretry?: () => void;
+    /** Regenerate the latest answer, by its request id. */
+    onregenerate?: (requestId: string) => void;
+    /** Edit the latest question, by its request id. */
+    onedit?: (requestId: string, text: string) => void;
     oncontinue?: () => void;
     empty?: import('svelte').Snippet;
   }
@@ -32,10 +36,19 @@
     ontool,
     onnotify,
     onretry,
+    onregenerate,
+    onedit,
     oncontinue,
     empty,
   }: Props = $props();
 
+  // The latest turn can be regenerated or edited once it has finished.
+  const latest = $derived.by(() => {
+    const last = messages[messages.length - 1];
+    if (streaming || last?.role !== 'assistant' || last.status === 'streaming') return undefined;
+    return messages[messages.length - 2]?.role === 'user' ? last.requestId : undefined;
+  });
+
   let container: HTMLDivElement | undefined = $state();
   /** Pinned to the bottom: new content scrolls into view. Off once the reader scrolls up. */
   let follow = $state(true);
@@ -143,6 +156,16 @@
             {onnotify}
             onretry={i === messages.length - 1 ? onretry : undefined}
             oncontinue={i === messages.length - 1 && !streaming ? oncontinue : undefined}
+            onregenerate={latest &&
+            onregenerate &&
+            i === messages.length - 1 &&
+            message.role === 'assistant' &&
+            message.status === 'done'
+              ? () => onregenerate(latest)
+              : undefined}
+            onedit={latest && onedit && i === messages.length - 2
+              ? (text: string) => onedit(latest, text)
+              : undefined}
           />
         {/each}
       </div>

package/dist/components/MessageList.svelte.d.ts

@@ -11,6 +11,10 @@ interface Props {
     ontool?: (toolName: string, params?: Record<string, unknown>) => void;
     onnotify?: (message: string) => void;
     onretry?: () => void;
+    /** Regenerate the latest answer, by its request id. */
+    onregenerate?: (requestId: string) => void;
+    /** Edit the latest question, by its request id. */
+    onedit?: (requestId: string, text: string) => void;
     oncontinue?: () => void;
     empty?: import('svelte').Snippet;
 }

package/dist/components/MessageList.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"MessageList.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/MessageList.svelte.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAK/C,UAAU,KAAK;IACb,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,cAAc,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACtE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,QAAQ,EAAE,OAAO,CAAC;CAClC;AA4HH,QAAA,MAAM,WAAW,2CAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}
+{"version":3,"file":"MessageList.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/MessageList.svelte.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAK/C,UAAU,KAAK;IACb,QAAQ,EAAE,WAAW,EAAE,CAAC;IACxB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,MAAM,CAAC;IACpC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACpC,cAAc,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9C,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAClC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;IACtE,QAAQ,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,uDAAuD;IACvD,YAAY,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,CAAC;IAC3C,mDAAmD;IACnD,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACnD,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,KAAK,CAAC,EAAE,OAAO,QAAQ,EAAE,OAAO,CAAC;CAClC;AA6IH,QAAA,MAAM,WAAW,2CAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}

package/dist/components/UserMessage.svelte

@@ -1,9 +1,12 @@
 <!--
   @component
   The user's turn: attachments and context above a right-aligned muted bubble, then the action bar.
+  With `onedit` (the latest question) the bubble can be edited in place and sent again.
 -->
 <script lang="ts">
-  import { Icon } from '@classic-homes/theme-svelte';
+  import { Button, Icon, Textarea } from '@classic-homes/theme-svelte';
+  import { LIMITS } from '@classic-homes/agent-contracts';
+  import { tick } from 'svelte';
   import type { UserMessage } from '../reducer.js';
   import { fileIcon, formatBytes } from '../message-format.js';
   import MessageActions from './MessageActions.svelte';
@@ -11,8 +14,37 @@
   interface Props {
     message: UserMessage;
     last?: boolean;
+    /** Replace this question with new text and answer it again. */
+    onedit?: (text: string) => void;
+  }
+  let { message, last = false, onedit }: Props = $props();
+
+  let editing = $state(false);
+  let draft = $state('');
+  let field = $state<HTMLTextAreaElement | null>(null);
+  async function startEdit(): Promise<void> {
+    draft = message.text;
+    editing = true;
+    await tick();
+    field?.focus();
+    field?.select();
+  }
+  function save(): void {
+    const text = draft.trim();
+    if (!text) return;
+    editing = false;
+    if (text !== message.text.trim()) onedit?.(text);
+  }
+  function onkeydown(event: KeyboardEvent): void {
+    if (event.isComposing || event.keyCode === 229) return;
+    if (event.key === 'Escape') {
+      event.preventDefault();
+      editing = false;
+    } else if (event.key === 'Enter' && !event.shiftKey) {
+      event.preventDefault();
+      save();
+    }
   }
-  let { message, last = false }: Props = $props();
 </script>
 
 <div class="group/message flex flex-col items-end gap-1 px-4 py-2" data-role="user">
@@ -37,10 +69,45 @@
       {/each}
     </ul>
   {/if}
-  <div
-    class="max-w-[85%] whitespace-pre-wrap rounded-2xl rounded-br-md bg-muted px-4 py-2.5 text-foreground [overflow-wrap:anywhere]"
-  >
-    {message.text}
-  </div>
-  <MessageActions text={message.text} createdAt={message.createdAt} visible={last} align="end" />
+  {#if editing}
+    <form
+      class="flex w-full max-w-[85%] flex-col gap-2 rounded-2xl border border-input bg-background p-2 focus-within:ring-2 focus-within:ring-ring/20"
+      aria-label="Edit message"
+      onsubmit={(e) => {
+        e.preventDefault();
+        save();
+      }}
+    >
+      <Textarea
+        bind:ref={field}
+        bind:value={draft}
+        autosize
+        rows={1}
+        maxRows={10}
+        maxlength={LIMITS.messageChars}
+        aria-label="Edited message"
+        class="border-0 bg-transparent shadow-none focus-visible:ring-0 focus-visible:ring-offset-0"
+        {onkeydown}
+      />
+      <div class="flex justify-end gap-2">
+        <Button type="button" variant="ghost" size="sm" onclick={() => (editing = false)}
+          >Cancel</Button
+        >
+        <Button type="submit" size="sm" disabled={!draft.trim()}>Send</Button>
+      </div>
+    </form>
+  {:else}
+    <div
+      class="max-w-[85%] whitespace-pre-wrap rounded-2xl rounded-br-md bg-muted px-4 py-2.5 text-foreground [overflow-wrap:anywhere]"
+    >
+      {message.text}
+    </div>
+    <MessageActions
+      text={message.text}
+      createdAt={message.createdAt}
+      visible={last}
+      align="end"
+      onedit={onedit ? startEdit : undefined}
+    />
+  {/if}
 </div>

package/dist/components/UserMessage.svelte.d.ts

@@ -2,8 +2,13 @@ import type { UserMessage } from '../reducer.js';
 interface Props {
     message: UserMessage;
     last?: boolean;
+    /** Replace this question with new text and answer it again. */
+    onedit?: (text: string) => void;
 }
-/** The user's turn: attachments and context above a right-aligned muted bubble, then the action bar. */
+/**
+ * The user's turn: attachments and context above a right-aligned muted bubble, then the action bar.
+ * With `onedit` (the latest question) the bubble can be edited in place and sent again.
+ */
 declare const UserMessage: import("svelte").Component<Props, {}, "">;
 type UserMessage = ReturnType<typeof UserMessage>;
 export default UserMessage;

package/dist/components/UserMessage.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"UserMessage.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/UserMessage.svelte.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAK/C,UAAU,KAAK;IACb,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAqCH,wGAAwG;AACxG,QAAA,MAAM,WAAW,2CAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}
+{"version":3,"file":"UserMessage.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/UserMessage.svelte.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAK/C,UAAU,KAAK;IACb,OAAO,EAAE,WAAW,CAAC;IACrB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,+DAA+D;IAC/D,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC;AA+EH;;;GAGG;AACH,QAAA,MAAM,WAAW,2CAAwC,CAAC;AAC1D,KAAK,WAAW,GAAG,UAAU,CAAC,OAAO,WAAW,CAAC,CAAC;AAClD,eAAe,WAAW,CAAC"}

package/dist/components/Welcome.svelte

@@ -0,0 +1,99 @@
+<!--
+  @component
+  The default empty conversation: a greeting, a capability line and starter suggestions.
+  `AgentChat` renders it unless the host passes its own `empty` snippet.
+-->
+<script lang="ts">
+  import { cn, Icon } from '@classic-homes/theme-svelte';
+  import { greeting, suggestionText, type WelcomeSuggestion } from '../welcome.js';
+
+  interface Props {
+    /** The user's name; only the first word is shown. */
+    name?: string | null;
+    /** Replaces the time-of-day greeting. */
+    title?: string;
+    description?: string;
+    suggestions?: WelcomeSuggestion[];
+    /** Compact single-column layout for the side panel. */
+    compact?: boolean;
+    disabled?: boolean;
+    onselect?: (text: string, suggestion: WelcomeSuggestion) => void;
+    class?: string;
+  }
+  let {
+    name,
+    title,
+    description = 'Ask about homes, lots, documents and company data, or attach a file to work from it.',
+    suggestions = [],
+    compact = false,
+    disabled = false,
+    onselect,
+    class: className,
+  }: Props = $props();
+
+  const headingId = $props.id();
+  const heading = $derived(title ?? greeting(name));
+  const shown = $derived(suggestions.filter((s) => suggestionText(s)).slice(0, 4));
+</script>
+
+<section
+  class={cn(
+    'm-auto flex w-full flex-col items-center px-4 text-center motion-safe:animate-fade-in',
+    compact ? 'max-w-sm gap-4 py-6' : 'max-w-2xl gap-6 py-10',
+    className,
+  )}
+  aria-labelledby={headingId}
+  data-agent-welcome
+>
+  <div class="flex flex-col items-center gap-3">
+    <span
+      class={cn(
+        'inline-flex items-center justify-center rounded-full bg-primary/10 text-primary',
+        compact ? 'size-10' : 'size-12',
+      )}
+      aria-hidden="true"
+    >
+      <Icon name="sparkles" size={compact ? 20 : 24} />
+    </span>
+    <h2
+      id={headingId}
+      class={cn('font-semibold tracking-tight text-foreground', compact ? 'text-lg' : 'text-2xl')}
+    >
+      {heading}
+    </h2>
+    {#if description}
+      <p class="max-w-md text-sm text-muted-foreground">{description}</p>
+    {/if}
+  </div>
+  {#if shown.length}
+    <ul
+      class={cn('grid w-full gap-2 text-left', !compact && 'sm:grid-cols-2')}
+      aria-label="Suggestions"
+    >
+      {#each shown as suggestion (suggestion.id ?? suggestion.label)}
+        <li class="flex">
+          <button
+            type="button"
+            class="group flex w-full items-start gap-3 rounded-lg border border-border bg-background p-3 text-left text-sm transition-colors hover:bg-muted focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50"
+            {disabled}
+            onclick={() => onselect?.(suggestionText(suggestion), suggestion)}
+          >
+            <Icon
+              name={suggestion.icon ?? 'message-square'}
+              size={16}
+              class="mt-0.5 shrink-0 text-muted-foreground group-hover:text-foreground"
+            />
+            <span class="min-w-0">
+              <span class="block font-medium text-foreground">{suggestion.label}</span>
+              {#if suggestion.description}
+                <span class="mt-0.5 block text-xs text-muted-foreground"
+                  >{suggestion.description}</span
+                >
+              {/if}
+            </span>
+          </button>
+        </li>
+      {/each}
+    </ul>
+  {/if}
+</section>

package/dist/components/Welcome.svelte.d.ts

@@ -0,0 +1,22 @@
+import { type WelcomeSuggestion } from '../welcome.js';
+interface Props {
+    /** The user's name; only the first word is shown. */
+    name?: string | null;
+    /** Replaces the time-of-day greeting. */
+    title?: string;
+    description?: string;
+    suggestions?: WelcomeSuggestion[];
+    /** Compact single-column layout for the side panel. */
+    compact?: boolean;
+    disabled?: boolean;
+    onselect?: (text: string, suggestion: WelcomeSuggestion) => void;
+    class?: string;
+}
+/**
+ * The default empty conversation: a greeting, a capability line and starter suggestions.
+ * `AgentChat` renders it unless the host passes its own `empty` snippet.
+ */
+declare const Welcome: import("svelte").Component<Props, {}, "">;
+type Welcome = ReturnType<typeof Welcome>;
+export default Welcome;
+//# sourceMappingURL=Welcome.svelte.d.ts.map

package/dist/components/Welcome.svelte.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Welcome.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/Welcome.svelte.ts"],"names":[],"mappings":"AAIA,OAAO,EAA4B,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAG/E,UAAU,KAAK;IACb,qDAAqD;IACrD,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,iBAAiB,EAAE,CAAC;IAClC,uDAAuD;IACvD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,iBAAiB,KAAK,IAAI,CAAC;IACjE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA8DH;;;GAGG;AACH,QAAA,MAAM,OAAO,2CAAwC,CAAC;AACtD,KAAK,OAAO,GAAG,UAAU,CAAC,OAAO,OAAO,CAAC,CAAC;AAC1C,eAAe,OAAO,CAAC"}

package/dist/components/regenerate.svelte.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=regenerate.svelte.test.d.ts.map

package/dist/components/regenerate.svelte.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"regenerate.svelte.test.d.ts","sourceRoot":"","sources":["../../src/lib/components/regenerate.svelte.test.ts"],"names":[],"mappings":""}

package/dist/components/regenerate.svelte.test.js

@@ -0,0 +1,108 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { cleanup, render, screen, waitFor } from '@testing-library/svelte';
+import userEvent from '@testing-library/user-event';
+import { latestTurn, newAssistantMessage, newUserMessage } from '../reducer.js';
+import { ChatSession } from '../session.svelte.js';
+import AgentChat from './AgentChat.svelte';
+afterEach(() => cleanup());
+/** Answers each request with "Answer N" (N counts requests). */
+function fakeClient() {
+    let n = 0;
+    return {
+        fileUrl: (id) => `#${id}`,
+        uploadFile: vi.fn(),
+        cancel: vi.fn(),
+        getConversation: vi.fn(),
+        resumeTurn: vi.fn(),
+        streamChat: vi.fn(async (req, opts) => {
+            n += 1;
+            [
+                { type: 'start', conversationId: 'c-1', mode: 'live' },
+                { type: 'delta', text: `Answer ${n}` },
+                { type: 'done', finishReason: 'stop' },
+            ].forEach((e, seq) => opts.onEvent({ requestId: req.requestId, seq, ...e }));
+            return { kind: 'done' };
+        }),
+    };
+}
+describe('latestTurn', () => {
+    it('finds the finished latest turn only', () => {
+        const done = { ...newAssistantMessage('r2'), status: 'done' };
+        const messages = [
+            newUserMessage('r1', 'one'),
+            { ...newAssistantMessage('r1'), status: 'done' },
+            newUserMessage('r2', 'two'),
+            done,
+        ];
+        expect(latestTurn(messages, 'r2')?.user.text).toBe('two');
+        expect(latestTurn(messages, 'r2')?.rest).toHaveLength(2);
+        expect(latestTurn(messages, 'r1')).toBeUndefined();
+        expect(latestTurn([...messages.slice(0, 3), newAssistantMessage('r2')], 'r2')).toBeUndefined();
+    });
+});
+describe('ChatSession regenerate and edit', () => {
+    it('replaces the latest turn instead of adding one', async () => {
+        const client = fakeClient();
+        const session = new ChatSession({ client: client });
+        await session.send('first');
+        const firstId = client.streamChat.mock.calls[0][0].requestId;
+        await session.regenerate(firstId);
+        const second = client.streamChat.mock.calls[1][0];
+        expect(second).toMatchObject({ message: 'first', replaces: firstId, conversationId: 'c-1' });
+        expect(session.messages.map((m) => m.text)).toEqual(['first', 'Answer 2']);
+        await session.edit(second.requestId, 'first, but better');
+        expect(client.streamChat.mock.calls[2][0]).toMatchObject({
+            message: 'first, but better',
+            replaces: second.requestId,
+        });
+        expect(session.messages.map((m) => m.text)).toEqual(['first, but better', 'Answer 3']);
+    });
+    it('sends a normal message without replaces', async () => {
+        const client = fakeClient();
+        const session = new ChatSession({ client: client });
+        await session.send('hi');
+        expect(client.streamChat.mock.calls[0][0]).not.toHaveProperty('replaces');
+    });
+});
+describe('AgentChat regenerate and edit', () => {
+    it('offers Regenerate on the latest answer and Edit on the latest question', async () => {
+        const user = userEvent.setup();
+        const client = fakeClient();
+        render(AgentChat, { props: { client: client, sandboxOrigin: 'https://frame.test' } });
+        await user.type(screen.getByRole('textbox', { name: 'Message' }), 'one{Enter}');
+        await screen.findAllByText('Answer 1');
+        await user.type(screen.getByRole('textbox', { name: 'Message' }), 'two{Enter}');
+        await screen.findAllByText('Answer 2');
+        // Only the latest turn.
+        expect(screen.getAllByRole('button', { name: 'Regenerate response' })).toHaveLength(1);
+        expect(screen.getAllByRole('button', { name: 'Edit message' })).toHaveLength(1);
+        await user.click(screen.getByRole('button', { name: 'Regenerate response' }));
+        await waitFor(() => expect(client.streamChat).toHaveBeenCalledTimes(3));
+        expect(client.streamChat.mock.calls[2][0]).toMatchObject({ message: 'two' });
+        expect((await screen.findAllByText('Answer 3')).length).toBeGreaterThan(0);
+        expect(screen.queryByText('Answer 2')).toBeNull();
+        await user.click(screen.getByRole('button', { name: 'Edit message' }));
+        const field = screen.getByRole('textbox', { name: 'Edited message' });
+        await user.clear(field);
+        await user.type(field, 'two, edited{Enter}');
+        await waitFor(() => expect(client.streamChat).toHaveBeenCalledTimes(4));
+        expect(client.streamChat.mock.calls[3][0]).toMatchObject({
+            message: 'two, edited',
+            replaces: client.streamChat.mock.calls[2][0].requestId,
+        });
+        expect(await screen.findByText('two, edited')).toBeTruthy();
+        expect(screen.queryByText(/^two$/)).toBeNull();
+    });
+    it('cancels an edit with Escape', async () => {
+        const user = userEvent.setup();
+        const client = fakeClient();
+        render(AgentChat, { props: { client: client, sandboxOrigin: 'https://frame.test' } });
+        await user.type(screen.getByRole('textbox', { name: 'Message' }), 'one{Enter}');
+        await screen.findAllByText('Answer 1');
+        await user.click(screen.getByRole('button', { name: 'Edit message' }));
+        await user.type(screen.getByRole('textbox', { name: 'Edited message' }), ' more{Escape}');
+        expect(screen.queryByRole('textbox', { name: 'Edited message' })).toBeNull();
+        expect(screen.getByText('one')).toBeTruthy();
+        expect(client.streamChat).toHaveBeenCalledOnce();
+    });
+});

package/dist/components/welcome.svelte.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=welcome.svelte.test.d.ts.map

package/dist/components/welcome.svelte.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"welcome.svelte.test.d.ts","sourceRoot":"","sources":["../../src/lib/components/welcome.svelte.test.ts"],"names":[],"mappings":""}

package/dist/components/welcome.svelte.test.js

@@ -0,0 +1,119 @@
+import { afterEach, describe, expect, it, vi } from 'vitest';
+import { cleanup, render, screen, waitFor } from '@testing-library/svelte';
+import userEvent from '@testing-library/user-event';
+import { greeting, suggestionText } from '../welcome.js';
+import AgentChat from './AgentChat.svelte';
+import Welcome from './Welcome.svelte';
+afterEach(() => cleanup());
+function fakeClient(getConversation = vi.fn()) {
+    return {
+        fileUrl: (id) => `#${id}`,
+        uploadFile: vi.fn(),
+        cancel: vi.fn(),
+        getConversation,
+        resumeTurn: vi.fn(),
+        streamChat: vi.fn(async (req, opts) => {
+            [
+                { type: 'start', conversationId: 'c-1', mode: 'live' },
+                { type: 'delta', text: 'Sure.' },
+                { type: 'done', finishReason: 'stop' },
+            ].forEach((e, seq) => opts.onEvent({ requestId: req.requestId, seq, ...e }));
+            return { kind: 'done' };
+        }),
+    };
+}
+const base = { sandboxOrigin: 'https://frame.test' };
+describe('welcome helpers', () => {
+    it('greets by the time of day and the first name only', () => {
+        expect(greeting('Pat Lee', new Date(2026, 10, 4, 9))).toBe('Good morning, Pat');
+        expect(greeting(undefined, new Date(2026, 10, 4, 14))).toBe('Good afternoon');
+        expect(greeting('  ', new Date(2026, 10, 4, 20))).toBe('Good evening');
+        expect(greeting('Sam', new Date(2026, 10, 4, 2))).toBe('Good evening, Sam');
+    });
+    it('sends the text, or the label without one', () => {
+        expect(suggestionText({ label: 'Open lots' })).toBe('Open lots');
+        expect(suggestionText({ label: 'Lots', text: ' List open lots ' })).toBe('List open lots');
+    });
+});
+describe('Welcome', () => {
+    it('shows at most four suggestions and reports the chosen one', async () => {
+        const onselect = vi.fn();
+        render(Welcome, {
+            props: {
+                name: 'Pat',
+                title: 'Hi Pat',
+                onselect,
+                suggestions: ['A', 'B', 'C', 'D', 'E'].map((label) => ({ label, text: `Do ${label}` })),
+            },
+        });
+        expect(screen.getByRole('heading', { name: 'Hi Pat' })).toBeTruthy();
+        const list = screen.getByRole('list', { name: 'Suggestions' });
+        expect(list.querySelectorAll('button')).toHaveLength(4);
+        await userEvent.click(screen.getByRole('button', { name: 'B' }));
+        expect(onselect).toHaveBeenCalledWith('Do B', expect.objectContaining({ label: 'B' }));
+    });
+});
+describe('AgentChat empty states', () => {
+    it('welcomes a new chat and sends a chosen suggestion', async () => {
+        const client = fakeClient();
+        render(AgentChat, {
+            props: {
+                ...base,
+                client: client,
+                userName: 'Pat Lee',
+                suggestions: [{ label: 'Open lots', text: 'List the open lots' }],
+            },
+        });
+        expect(screen.getByRole('heading', { name: /, Pat$/ })).toBeTruthy();
+        await userEvent.click(screen.getByRole('button', { name: 'Open lots' }));
+        await waitFor(() => expect(client.streamChat).toHaveBeenCalledOnce());
+        expect(client.streamChat.mock.calls[0][0]).toMatchObject({ message: 'List the open lots' });
+        expect((await screen.findAllByText('Sure.')).length).toBeGreaterThan(0);
+        expect(document.querySelector('[data-agent-welcome]')).toBeNull();
+    });
+    it('shows a skeleton, not the welcome, while a conversation loads', async () => {
+        let resolve;
+        const client = fakeClient(vi.fn(() => new Promise((r) => (resolve = r))));
+        render(AgentChat, { props: { ...base, client: client, conversationId: 'c-9' } });
+        expect(document.querySelector('[data-agent-loading]')).toBeTruthy();
+        expect(document.querySelector('[data-agent-welcome]')).toBeNull();
+        resolve({
+            conversation: { conversationId: 'c-9', activeRequestId: null },
+            messages: [
+                {
+                    id: 'u-1',
+                    role: 'user',
+                    content: [{ type: 'text', text: 'Earlier question' }],
+                    createdAt: Date.now(),
+                },
+            ],
+        });
+        expect(await screen.findByText('Earlier question')).toBeTruthy();
+        expect(document.querySelector('[data-agent-loading]')).toBeNull();
+    });
+    it('explains a failed load and retries it', async () => {
+        const getConversation = vi
+            .fn()
+            .mockRejectedValueOnce(new Error('Network down'))
+            .mockResolvedValueOnce({
+            conversation: { conversationId: 'c-9', activeRequestId: null },
+            messages: [],
+        });
+        render(AgentChat, {
+            props: { ...base, client: fakeClient(getConversation), conversationId: 'c-9' },
+        });
+        expect(await screen.findByText('Could not load this conversation.')).toBeTruthy();
+        expect(document.querySelector('[data-agent-welcome]')).toBeNull();
+        // No automatic retry loop.
+        await new Promise((r) => setTimeout(r, 50));
+        expect(getConversation).toHaveBeenCalledOnce();
+        await userEvent.click(screen.getByRole('button', { name: /Try again/ }));
+        await waitFor(() => expect(getConversation).toHaveBeenCalledTimes(2));
+        await waitFor(() => expect(screen.queryByText('Could not load this conversation.')).toBeNull());
+        expect(document.querySelector('[data-agent-welcome]')).toBeTruthy();
+    });
+    it('renders the welcome when the host gives no empty snippet', () => {
+        render(AgentChat, { props: { ...base, client: fakeClient() } });
+        expect(document.querySelector('[data-agent-welcome]')).toBeTruthy();
+    });
+});

package/dist/index.d.ts

@@ -6,6 +6,7 @@ export * from './message-format.js';
 export * from './reducer.js';
 export * from './session.svelte.js';
 export * from './ui-frame-protocol.js';
+export * from './welcome.js';
 export { default as AgentChat } from './components/AgentChat.svelte';
 export { default as ArtifactPanel } from './components/ArtifactPanel.svelte';
 export { default as Composer } from './components/Composer.svelte';
@@ -22,4 +23,5 @@ export { default as MessageActions } from './components/MessageActions.svelte';
 export { default as ArtifactChip } from './components/ArtifactChip.svelte';
 export { default as MessageFiles } from './components/MessageFiles.svelte';
 export { default as ProposalCard } from './components/ProposalCard.svelte';
+export { default as Welcome } from './components/Welcome.svelte';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AACzF,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kCAAkC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC;AACtC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC;AAC7B,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAC7E,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,EAAE,OAAO,IAAI,mBAAmB,EAAE,MAAM,yCAAyC,CAAC;AACzF,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,6BAA6B,CAAC;AACjE,OAAO,EAAE,OAAO,IAAI,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACvE,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,sCAAsC,CAAC;AACnF,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAC/E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,OAAO,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -6,6 +6,7 @@ export * from './message-format.js';
 export * from './reducer.js';
 export * from './session.svelte.js';
 export * from './ui-frame-protocol.js';
+export * from './welcome.js';
 export { default as AgentChat } from './components/AgentChat.svelte';
 export { default as ArtifactPanel } from './components/ArtifactPanel.svelte';
 export { default as Composer } from './components/Composer.svelte';
@@ -22,3 +23,4 @@ export { default as MessageActions } from './components/MessageActions.svelte';
 export { default as ArtifactChip } from './components/ArtifactChip.svelte';
 export { default as MessageFiles } from './components/MessageFiles.svelte';
 export { default as ProposalCard } from './components/ProposalCard.svelte';
+export { default as Welcome } from './components/Welcome.svelte';

package/dist/reducer.d.ts

@@ -100,6 +100,14 @@ export declare function turnForRetry(messages: ChatMessage[], requestId: string)
     user: UserMessage;
     rest: ChatMessage[];
 } | undefined;
+/**
+ * The conversation's latest finished turn (any outcome), to regenerate or edit: its question
+ * and the messages before it. Undefined while it streams or when `requestId` is not the latest.
+ */
+export declare function latestTurn(messages: ChatMessage[], requestId: string): {
+    user: UserMessage;
+    rest: ChatMessage[];
+} | undefined;
 /** Human titles for client error codes (mirrors the task pane's wording). */
 export declare function errorTitle(code: ClientErrorCode): string;
 export type { ClientKind };

package/dist/reducer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reducer.d.ts","sourceRoot":"","sources":["../src/lib/reducer.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"reducer.d.ts","sourceRoot":"","sources":["../src/lib/reducer.ts"],"names":[],"mappings":"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"}

package/dist/reducer.js

@@ -182,6 +182,21 @@ export function turnForRetry(messages, requestId) {
         return undefined;
     return { user, rest: messages.slice(0, -2) };
 }
+/**
+ * The conversation's latest finished turn (any outcome), to regenerate or edit: its question
+ * and the messages before it. Undefined while it streams or when `requestId` is not the latest.
+ */
+export function latestTurn(messages, requestId) {
+    const last = messages[messages.length - 1];
+    if (last?.role !== 'assistant' || last.requestId !== requestId)
+        return undefined;
+    if (last.status === 'streaming')
+        return undefined;
+    const user = messages[messages.length - 2];
+    if (user?.role !== 'user')
+        return undefined;
+    return { user, rest: messages.slice(0, -2) };
+}
 /** Human titles for client error codes (mirrors the task pane's wording). */
 export function errorTitle(code) {
     const titles = {

package/dist/session.svelte.d.ts

@@ -50,15 +50,23 @@ export declare class ChatSession {
     get current(): AssistantMessage | undefined;
     /** Load an existing conversation's transcript and re-attach to a running turn if any. */
     load(conversationId: string): Promise<void>;
+    /**
+     * Send a message. `replaces` names the latest turn this one replaces (regenerate, retry,
+     * edit); the runtime drops that turn's question and answer before answering.
+     */
     send(text: string, options?: {
         files?: FileRef[];
+        replaces?: string;
     }): Promise<void>;
     /**
-     * Resend the last turn after it failed, was stopped or was cut short. The failed turn is
-     * replaced in the view rather than duplicated. (The runtime may still hold the first user
-     * message when it had accepted the turn; a server-side regenerate is a separate change.)
+     * Resend the last turn after it failed, was stopped or was cut short. The turn is replaced,
+     * in the view and in the runtime's transcript, rather than duplicated.
      */
     retry(requestId: string): Promise<void>;
+    /** Ask again for a new answer to the latest question, replacing the current one. */
+    regenerate(requestId: string): Promise<void>;
+    /** Change the latest question and answer it again, replacing that turn. */
+    edit(requestId: string, text: string): Promise<void>;
     /** Re-attach to a turn after reload: replays events after the last seq we hold (none here). */
     resume(requestId: string): Promise<void>;
     cancel(): void;

package/dist/session.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.svelte.d.ts","sourceRoot":"","sources":["../src/lib/session.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,OAAO,KAAK,EACV,QAAQ,EACR,WAAW,EACX,SAAS,EAET,UAAU,EACV,eAAe,EACf,OAAO,EACR,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAKL,KAAK,gBAAgB,EACrB,KAAK,WAAW,EACjB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,cAAc,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,mGAAmG;IACnG,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,eAAe,GAAG,IAAI,GAAG,SAAS,CAAC;IACtD,qBAAqB,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACrC;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAClG;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;AAE7D;;;GAGG;AACH,qBAAa,WAAW;IACtB,QAAQ,gBAA6B;IACrC,MAAM,gBAAiC;IACvC,cAAc,gBAA+B;IAC7C,gGAAgG;IAChG,oBAAoB,gBAA+B;IACnD,IAAI,8BAA8C;IAClD,SAAS,qBAAyC;IAClD,YAAY;;;;;;QAAyB;IAErC,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAEjC,OAAO,EAAE,kBAAkB;IAMvC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,OAAO,IAAI,gBAAgB,GAAG,SAAS,CAG1C;IAED,yFAAyF;IACnF,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+B3C,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,EAAE,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B5E;;;;OAIG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ7C,+FAA+F;IACzF,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa9C,MAAM,IAAI,IAAI;YAOA,GAAG;IA2DjB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,MAAM;CAKf;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAE1E"}
+{"version":3,"file":"session.svelte.d.ts","sourceRoot":"","sources":["../src/lib/session.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAElE,OAAO,KAAK,EACV,QAAQ,EACR,WAAW,EACX,SAAS,EAET,UAAU,EACV,eAAe,EACf,OAAO,EACR,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAML,KAAK,gBAAgB,EACrB,KAAK,WAAW,EACjB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,cAAc,CAAC;IACvB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,mGAAmG;IACnG,IAAI,CAAC,EAAE,WAAW,CAAC;IACnB,KAAK,CAAC,EAAE,QAAQ,CAAC;IACjB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,kEAAkE;IAClE,UAAU,CAAC,EAAE,MAAM,eAAe,GAAG,IAAI,GAAG,SAAS,CAAC;IACtD,qBAAqB,CAAC,EAAE,CAAC,cAAc,EAAE,MAAM,KAAK,IAAI,CAAC;IACzD,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,CAAC;IACrC;;;OAGG;IACH,SAAS,CAAC,EAAE,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CAClG;AAED,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,SAAS,GAAG,WAAW,CAAC;AAE7D;;;GAGG;AACH,qBAAa,WAAW;IACtB,QAAQ,gBAA6B;IACrC,MAAM,gBAAiC;IACvC,cAAc,gBAA+B;IAC7C,gGAAgG;IAChG,oBAAoB,gBAA+B;IACnD,IAAI,8BAA8C;IAClD,SAAS,qBAAyC;IAClD,YAAY;;;;;;QAAyB;IAErC,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAEjC,OAAO,EAAE,kBAAkB;IAMvC,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,OAAO,IAAI,gBAAgB,GAAG,SAAS,CAG1C;IAED,yFAAyF;IACnF,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA+BjD;;;OAGG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B/F;;;OAGG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ7C,oFAAoF;IAC9E,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlD,2EAA2E;IACrE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1D,+FAA+F;IACzF,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa9C,MAAM,IAAI,IAAI;YAOA,GAAG;IA2DjB,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,MAAM;CAKf;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAE1E"}

package/dist/session.svelte.js

@@ -1,5 +1,5 @@
 import { ApiRequestError } from '@classic-homes/agent-client';
-import { applyEvent, newAssistantMessage, newUserMessage, turnForRetry, } from './reducer.js';
+import { applyEvent, newAssistantMessage, newUserMessage, latestTurn, turnForRetry, } from './reducer.js';
 /**
  * Reactive conversation state (Svelte 5 runes class). Owns the stream lifecycle: one turn at a
  * time, cancel, resume after reload, history load. Rendering is left to the components.
@@ -58,6 +58,10 @@ export class ChatSession {
             this.loadError = err instanceof Error ? err.message : 'Could not load the conversation';
         }
     }
+    /**
+     * Send a message. `replaces` names the latest turn this one replaces (regenerate, retry,
+     * edit); the runtime drops that turn's question and answer before answering.
+     */
     async send(text, options = {}) {
         const message = text.trim();
         if (!message || this.status !== 'idle')
@@ -74,6 +78,7 @@ export class ChatSession {
             ...(context ? { context } : {}),
             ...(files.length ? { fileIds: files.map((f) => f.fileId) } : {}),
             ...(this.options.clientKind ? { client: this.options.clientKind } : {}),
+            ...(options.replaces ? { replaces: options.replaces } : {}),
         };
         this.messages = [
             ...this.messages,
@@ -83,9 +88,8 @@ export class ChatSession {
         await this.run(requestId, (signal, onEvent) => this.options.client.streamChat(request, { signal, onEvent }));
     }
     /**
-     * Resend the last turn after it failed, was stopped or was cut short. The failed turn is
-     * replaced in the view rather than duplicated. (The runtime may still hold the first user
-     * message when it had accepted the turn; a server-side regenerate is a separate change.)
+     * Resend the last turn after it failed, was stopped or was cut short. The turn is replaced,
+     * in the view and in the runtime's transcript, rather than duplicated.
      */
     async retry(requestId) {
         if (this.status !== 'idle')
@@ -94,7 +98,27 @@ export class ChatSession {
         if (!turn)
             return;
         this.messages = turn.rest;
-        await this.send(turn.user.text, { files: turn.user.attachments });
+        await this.send(turn.user.text, { files: turn.user.attachments, replaces: requestId });
+    }
+    /** Ask again for a new answer to the latest question, replacing the current one. */
+    async regenerate(requestId) {
+        if (this.status !== 'idle')
+            return;
+        const turn = latestTurn(this.messages, requestId);
+        if (!turn)
+            return;
+        this.messages = turn.rest;
+        await this.send(turn.user.text, { files: turn.user.attachments, replaces: requestId });
+    }
+    /** Change the latest question and answer it again, replacing that turn. */
+    async edit(requestId, text) {
+        if (this.status !== 'idle' || !text.trim())
+            return;
+        const turn = latestTurn(this.messages, requestId);
+        if (!turn)
+            return;
+        this.messages = turn.rest;
+        await this.send(text, { files: turn.user.attachments, replaces: requestId });
     }
     /** Re-attach to a turn after reload: replays events after the last seq we hold (none here). */
     async resume(requestId) {

package/dist/welcome.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Helpers for the empty conversation: greeting and suggestion types.
+ */
+import type { IconName } from '@classic-homes/theme-svelte';
+/** A starter offered on an empty conversation. */
+export interface WelcomeSuggestion {
+    /** Stable key; defaults to the label. */
+    id?: string;
+    /** Short card title, e.g. "Summarize this lot". */
+    label: string;
+    /** One line under the label. */
+    description?: string;
+    /** Message sent when the card is chosen (defaults to the label). */
+    text?: string;
+    icon?: IconName;
+}
+/** The text a suggestion sends. */
+export declare function suggestionText(s: WelcomeSuggestion): string;
+/** "Good morning, Pat" by the local hour; without a name, "Good morning". */
+export declare function greeting(name?: string | null, now?: Date): string;
+//# sourceMappingURL=welcome.d.ts.map

package/dist/welcome.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"welcome.d.ts","sourceRoot":"","sources":["../src/lib/welcome.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,6BAA6B,CAAC;AAE5D,kDAAkD;AAClD,MAAM,WAAW,iBAAiB;IAChC,yCAAyC;IACzC,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,mDAAmD;IACnD,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oEAAoE;IACpE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,QAAQ,CAAC;CACjB;AAED,mCAAmC;AACnC,wBAAgB,cAAc,CAAC,CAAC,EAAE,iBAAiB,GAAG,MAAM,CAE3D;AAED,6EAA6E;AAC7E,wBAAgB,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,GAAG,GAAE,IAAiB,GAAG,MAAM,CAK7E"}

package/dist/welcome.js

@@ -0,0 +1,11 @@
+/** The text a suggestion sends. */
+export function suggestionText(s) {
+    return (s.text ?? s.label).trim();
+}
+/** "Good morning, Pat" by the local hour; without a name, "Good morning". */
+export function greeting(name, now = new Date()) {
+    const hour = now.getHours();
+    const part = hour < 5 ? 'evening' : hour < 12 ? 'morning' : hour < 18 ? 'afternoon' : 'evening';
+    const first = name?.trim().split(/\s+/)[0];
+    return first ? `Good ${part}, ${first}` : `Good ${part}`;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classic-homes/agent-chat",
-  "version": "0.4.1",
+  "version": "0.6.0",
   "private": false,
   "type": "module",
   "description": "Svelte 5 chat UI for Classic Agent: session state, message list, composer, tool timeline, artifacts and MCP-UI sandbox frames. Consumed by the Classic App.",
@@ -17,8 +17,8 @@
     "dist"
   ],
   "dependencies": {
-    "@classic-homes/agent-client": "0.4.1",
-    "@classic-homes/agent-contracts": "0.4.1",
+    "@classic-homes/agent-client": "0.6.0",
+    "@classic-homes/agent-contracts": "0.6.0",
     "dompurify": "3.4.17"
   },
   "peerDependencies": {