@classic-homes/agent-chat 0.12.0 → 0.13.0

package/README.md

@@ -78,15 +78,22 @@ loads produced files with `client.fetchFile` (blob URLs, revoked when the messag
 A host can show the chat over its pages instead of on a route of its own:
 
 - `createChatSurface({ storageKey })` holds which presentation is showing (`launcher`, `float`
-  or `dock`), the launcher's corner, the window's geometry and an `unread` flag; it persists to
-  `localStorage` under `storageKey` and keeps the window inside the viewport.
-- `ChatLauncher` is the floating button (drag to another corner; shows answering, unseen answer,
-  error and a MOCK marker). `FloatingWindow` is a non-modal window around any content: drag by
-  the header, resize from the edges, drop on the right edge to dock, arrow keys on the move
-  handle, Escape to minimize. The dock itself is the host's (e.g. a theme `DataPanel`).
+  or `dock`), where the launcher sits (`corner`, or `launcher` once the user has placed it), the
+  window's geometry and an `unread` flag; it persists to `localStorage` under `storageKey` and
+  keeps both inside the viewport. The launcher's place and the window's are separate.
+- `ChatLauncher` is the floating button. The user can drag it anywhere; pass `position` and save
+  the drop from `onmove` (`surface.setLauncher`). While answering an arc orbits it; it also shows
+  an unseen answer, an error and a MOCK marker.
+- `FloatingWindow` is a non-modal window around any content: one header (mark, `title`, optional
+  `subtitle` such as the conversation name, your `actions`, Dock, Minimize), drag by the header,
+  resize from the edges, drop on the right edge to dock, arrow keys on the move handle, Escape to
+  minimize. It takes the keyboard when it appears (the first text field, else the window;
+  `autofocus={false}` to opt out). The dock itself is the host's (e.g. a theme `DataPanel`).
+  For history, render `ConversationSidebar` in place of the chat (`class="w-full border-r-0"`);
+  with a host-owned session nothing is lost while it shows.
 - Pass `AgentChat` a host-owned `session` (`new ChatSession({...})`) and `variant="float"` or
   `"panel"`. The session then survives the view moving between presentations, including a
-  running answer. With `session` set, configure `mode`, `agent`, `clientKind`, `getContext` and
+  running answer and the unsent composer text (`session.draft`). With `session` set, configure `mode`, `agent`, `clientKind`, `getContext` and
   the turn callbacks on the session; those `AgentChat` props are ignored. Call
   `surface.notifyTurnEnd()` from the session's `onTurnEnd` to flag an answer that finished while
   collapsed.
@@ -118,4 +125,7 @@ A host can show the chat over its pages instead of on a route of its own:
   an error with Try again when that load fails.
 - `ArtifactPanel`, `UiFrame`, `ModeBanner`.
 
+While an answer has nothing to show yet, the assistant message cycles through
+`THINKING_PHRASES` (homebuilding verbs, as in the Classic Chat widget) beside a stepped loader.
+
 Publishing: `docs/operations/package-publishing.md`.

package/dist/components/AgentChat.svelte

@@ -185,7 +185,6 @@
   });
 
   let composer: Composer | undefined = $state();
-  let draft = $state('');
   let files = $state<FileRef[]>([]);
   let selectedArtifact = $state<string | null>(null);
   let artifactsOpen = $state(false);
@@ -248,7 +247,7 @@
     if (conversationId) void session.load(conversationId);
   }
   function prompt(text: string): void {
-    draft = text;
+    session.draft = text;
     composer?.focus();
   }
 </script>
@@ -354,7 +353,7 @@
     />
     <Composer
       bind:this={composer}
-      bind:value={draft}
+      bind:value={session.draft}
       bind:files
       disabled={session.status === 'loading'}
       streaming={session.streaming}

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

package/dist/components/AssistantMessage.svelte

@@ -9,6 +9,7 @@
   import type { AssistantMessage } from '../reducer.js';
   import { errorTitle, isContinuable } from '../reducer.js';
   import { parseMarkdown } from '../markdown.js';
+  import { THINKING_PHRASE_MS, pickThinkingPhrase } from '../thinking.js';
   import ArtifactChip from './ArtifactChip.svelte';
   import Markdown from './Markdown.svelte';
   import MessageActions from './MessageActions.svelte';
@@ -101,6 +102,13 @@
       !message.tools.some((t) => !t.status) &&
       !message.artifacts.some((a) => a.open),
   );
+  // A homebuilding verb while there is nothing to show yet, changed every few seconds.
+  let phrase = $state(pickThinkingPhrase());
+  $effect(() => {
+    if (!thinking) return;
+    const timer = setInterval(() => (phrase = pickThinkingPhrase(phrase)), THINKING_PHRASE_MS);
+    return () => clearInterval(timer);
+  });
   // Continue carries on the text so far of an answer cut short or stopped; a reply stopped before
   // any text, or one that failed or lost its connection, is retried instead.
   const canContinue = $derived(last && !!oncontinue && isContinuable(message));
@@ -124,17 +132,15 @@
     {/if}
     {#if html}<Markdown {html} streaming={streaming && !!message.text} onclick={handleClick} />{/if}
     {#if thinking}
-      <div class="flex items-center gap-2 text-sm text-muted-foreground" role="status">
-        <span class="flex gap-1" aria-hidden="true">
-          <span class="h-1.5 w-1.5 rounded-full bg-current motion-safe:animate-bounce"></span>
-          <span
-            class="h-1.5 w-1.5 rounded-full bg-current motion-safe:animate-bounce [animation-delay:150ms]"
-          ></span>
-          <span
-            class="h-1.5 w-1.5 rounded-full bg-current motion-safe:animate-bounce [animation-delay:300ms]"
-          ></span>
-        </span>
-        Thinking
+      <!-- aria-live off: the phrase changes for the eye; announcing each one would be noise. -->
+      <div
+        class="flex items-center gap-2 text-sm italic text-muted-foreground"
+        role="status"
+        aria-live="off"
+        data-agent-thinking
+      >
+        <span>{phrase}</span>
+        <span class="thinking-loader" aria-hidden="true"></span>
       </div>
     {/if}
     {#if message.artifacts.length}
@@ -204,3 +210,30 @@
     {/if}
   </div>
 </div>
+
+<style>
+  /* Six blocks with one lit, stepping along (the Classic Chat widget's loader). Only custom
+     properties and an animation here: nothing a host's base styles compete with. */
+  .thinking-loader {
+    display: inline-block;
+    width: 60px;
+    height: 10px;
+    flex-shrink: 0;
+    -webkit-mask: linear-gradient(90deg, #000 70%, #0000 0) left / 20% 100%;
+    mask: linear-gradient(90deg, #000 70%, #0000 0) left / 20% 100%;
+    background: linear-gradient(hsl(var(--primary)) 0 0) left -25% top 0 / 20% 100% no-repeat
+      hsl(var(--muted-foreground) / 0.25);
+    animation: thinking-slide 1s infinite steps(6);
+  }
+  @keyframes thinking-slide {
+    100% {
+      background-position: right -25% top 0;
+    }
+  }
+  @media (prefers-reduced-motion: reduce) {
+    .thinking-loader {
+      animation: none;
+      background-position: left 37.5% top 0;
+    }
+  }
+</style>

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,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,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,gGAAgG;IAChG,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,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,iDAAiD;IACjD,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AAmKH;;;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,UAAU,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAapD,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,gGAAgG;IAChG,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,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,iDAAiD;IACjD,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,UAAU,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/E,8DAA8D;IAC9D,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;CACzB;AA0KH;;;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/ChatLauncher.svelte

@@ -1,16 +1,20 @@
 <script lang="ts">
   /**
-   * The floating launcher: a round button pinned to a viewport corner that opens the chat. The
-   * user can drag it; on release it snaps to the nearest corner. It also reports what the chat
+   * The floating launcher: a round button that opens the chat. It starts in a viewport corner;
+   * the user can drag it anywhere and it stays where it is dropped (kept inside the viewport),
+   * independent of where the chat window sits. It also reports what the chat
    * is doing while collapsed (answering, an unseen answer, an error) and keeps the mock backend
    * visible (AGENTS.md: mock must always be visible).
    */
   import { cn, Icon } from '@classic-homes/theme-svelte';
   import type { LauncherStatus } from '../surface.svelte.js';
-  import { DRAG_THRESHOLD, nearestCorner, type Corner, type Point } from '../surface-geometry.js';
+  import { DRAG_THRESHOLD, clampLauncher, type Corner, type Point } from '../surface-geometry.js';
 
   interface Props {
+    /** Where it sits until the user places it. */
     corner?: Corner;
+    /** Where the user placed it (top-left, viewport px); null or absent uses `corner`. */
+    position?: Point | null;
     status?: LauncherStatus;
     /** The backend is the mock: show the marker on the button. */
     mock?: boolean;
@@ -20,12 +24,13 @@
     expanded?: boolean;
     draggable?: boolean;
     onclick?: () => void;
-    /** The user dropped the button in another corner. */
-    oncornerchange?: (corner: Corner) => void;
+    /** The user dropped the button here (top-left, already inside the viewport). */
+    onmove?: (position: Point) => void;
     class?: string;
   }
   let {
     corner = 'bottom-right',
+    position = null,
     status = 'idle',
     mock = false,
     label = 'Classic Agent',
@@ -33,7 +38,7 @@
     expanded = false,
     draggable = true,
     onclick,
-    oncornerchange,
+    onmove,
     class: className,
   }: Props = $props();
 
@@ -59,6 +64,11 @@
     'top-left': 'top-5 left-5',
   };
 
+  const viewport = () => ({ width: window.innerWidth, height: window.innerHeight });
+  // A placed button has to stay reachable when the window shrinks.
+  let size = $state(typeof window === 'undefined' ? { width: 1280, height: 800 } : viewport());
+  const placed = $derived(position ? clampLauncher(position, size) : null);
+
   let start: Point | null = null;
   let offset = $state<Point>({ x: 0, y: 0 });
   let dragging = $state(false);
@@ -85,12 +95,10 @@
     if (!dragging) return;
     dragging = false;
     suppressClick = true;
+    // Where the button is now, drag offset included.
+    const box = button?.getBoundingClientRect();
     offset = { x: 0, y: 0 };
-    const next = nearestCorner(
-      { x: event.clientX, y: event.clientY },
-      { width: window.innerWidth, height: window.innerHeight },
-    );
-    if (next !== corner) oncornerchange?.(next);
+    if (box) onmove?.(clampLauncher({ x: box.left, y: box.top }, viewport()));
   }
   function onpointercancel(): void {
     start = null;
@@ -106,15 +114,19 @@
   }
 </script>
 
+<svelte:window onresize={() => (size = viewport())} />
+
 <button
   bind:this={button}
   type="button"
   class={cn(
     'fixed z-40 flex size-14 touch-none select-none items-center justify-center rounded-full bg-primary text-primary-foreground shadow-lg outline-none ring-offset-background transition-shadow hover:shadow-xl focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2',
-    CORNER_CLASS[corner],
-    dragging ? 'cursor-grabbing opacity-80' : 'cursor-pointer',
+    !placed && CORNER_CLASS[corner],
+    dragging ? 'scale-105 cursor-grabbing opacity-85' : 'cursor-pointer',
     className,
   )}
+  style:left={placed ? `${placed.x}px` : undefined}
+  style:top={placed ? `${placed.y}px` : undefined}
   style:transform={dragging ? `translate(${offset.x}px, ${offset.y}px)` : undefined}
   aria-label={name}
   aria-expanded={expanded}
@@ -129,12 +141,18 @@
   {onpointercancel}
 >
   {#if status === 'streaming'}
+    <!-- Answering: an arc orbits just outside the button and the icon breathes. With reduced motion
+         the rim stays as a still ring. -->
     <span
-      class="pointer-events-none absolute inset-0 animate-ping rounded-full bg-primary opacity-30 motion-reduce:hidden"
+      class="pointer-events-none absolute -inset-[7px] rounded-full animate-spin [animation-duration:1.1s] motion-reduce:animate-none"
+      style="background: conic-gradient(from 0deg, transparent 0 35%, hsl(var(--primary)) 100%); -webkit-mask: radial-gradient(farthest-side, transparent calc(100% - 3px), #000 calc(100% - 2.5px)); mask: radial-gradient(farthest-side, transparent calc(100% - 3px), #000 calc(100% - 2.5px));"
       aria-hidden="true"
+      data-testid="launcher-ring"
     ></span>
   {/if}
-  <Icon name="sparkles" size={24} />
+  <span class={cn('flex', status === 'streaming' && 'motion-safe:animate-pulse')}>
+    <Icon name="sparkles" size={24} />
+  </span>
   {#if status === 'unread' || status === 'error'}
     <span
       class={cn(

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

@@ -1,7 +1,10 @@
 import type { LauncherStatus } from '../surface.svelte.js';
-import { type Corner } from '../surface-geometry.js';
+import { type Corner, type Point } from '../surface-geometry.js';
 interface Props {
+    /** Where it sits until the user places it. */
     corner?: Corner;
+    /** Where the user placed it (top-left, viewport px); null or absent uses `corner`. */
+    position?: Point | null;
     status?: LauncherStatus;
     /** The backend is the mock: show the marker on the button. */
     mock?: boolean;
@@ -11,8 +14,8 @@ interface Props {
     expanded?: boolean;
     draggable?: boolean;
     onclick?: () => void;
-    /** The user dropped the button in another corner. */
-    oncornerchange?: (corner: Corner) => void;
+    /** The user dropped the button here (top-left, already inside the viewport). */
+    onmove?: (position: Point) => void;
     class?: string;
 }
 declare const ChatLauncher: import("svelte").Component<Props, {

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

@@ -1 +1 @@
-{"version":3,"file":"ChatLauncher.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/ChatLauncher.svelte.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAiC,KAAK,MAAM,EAAc,MAAM,wBAAwB,CAAC;AAG9F,UAAU,KAAK;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,qDAAqD;IACrD,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAkHH,QAAA,MAAM,YAAY;iBA7FG,IAAI;MA6FiC,CAAC;AAC3D,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AACpD,eAAe,YAAY,CAAC"}
+{"version":3,"file":"ChatLauncher.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/ChatLauncher.svelte.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAiC,KAAK,MAAM,EAAE,KAAK,KAAK,EAAE,MAAM,wBAAwB,CAAC;AAG9F,UAAU,KAAK;IACb,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,QAAQ,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;IACxB,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,8DAA8D;IAC9D,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gEAAgE;IAChE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,gFAAgF;IAChF,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,KAAK,KAAK,IAAI,CAAC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA2HH,QAAA,MAAM,YAAY;iBArGG,IAAI;MAqGiC,CAAC;AAC3D,KAAK,YAAY,GAAG,UAAU,CAAC,OAAO,YAAY,CAAC,CAAC;AACpD,eAAe,YAAY,CAAC"}

package/dist/components/FloatingWindow.svelte

@@ -5,7 +5,7 @@
    * it is given. Keyboard: the move handle takes arrow keys (Shift resizes, Alt for small
    * steps); Escape inside the window minimizes it unless something inside used the key.
    */
-  import { untrack, type Snippet } from 'svelte';
+  import { onMount, untrack, type Snippet } from 'svelte';
   import { Button, cn, Icon } from '@classic-homes/theme-svelte';
   import type { ChatSurface } from '../surface.svelte.js';
   import {
@@ -20,6 +20,10 @@
   interface Props {
     surface: ChatSurface;
     title?: string;
+    /** A second, quieter line under the title, e.g. the conversation's name. */
+    subtitle?: string;
+    /** Replaces the mark before the title. */
+    icon?: Snippet;
     id?: string;
     /** Header buttons before Dock and Minimize, e.g. New chat. */
     actions?: Snippet;
@@ -29,17 +33,25 @@
     resizable?: boolean;
     /** Called after the window minimizes, e.g. to move focus to the launcher. */
     onminimize?: () => void;
+    /**
+     * Take the keyboard when the window appears and nothing inside has it yet: the first text
+     * field, or the window itself. Without it Escape and Tab start from the page underneath.
+     */
+    autofocus?: boolean;
     class?: string;
   }
   let {
     surface,
     title = 'Classic Agent',
+    subtitle,
+    icon,
     id = 'agent-chat-window',
     actions,
     children,
     dockable = true,
     resizable = true,
     onminimize,
+    autofocus = true,
     class: className,
   }: Props = $props();
 
@@ -47,6 +59,16 @@
   // Untracked: attaching clamps the saved rect, which must not re-run this effect.
   $effect(() => untrack(() => surface.attach()));
 
+  let root: HTMLElement | undefined = $state();
+  // After the content has mounted (and had its own chance to focus something).
+  onMount(() => {
+    if (!autofocus || !root || root.contains(document.activeElement)) return;
+    const field = root.querySelector<HTMLElement>(
+      'textarea:not([disabled]), input:not([disabled])',
+    );
+    (field ?? root).focus({ preventScroll: true });
+  });
+
   function minimize(): void {
     surface.minimize();
     onminimize?.();
@@ -161,14 +183,16 @@
   }
 </script>
 
-<!-- svelte-ignore a11y_no_noninteractive_element_interactions -->
+<!-- svelte-ignore a11y_no_noninteractive_element_interactions, a11y_no_noninteractive_element_to_interactive_role -->
 <section
+  bind:this={root}
   {id}
+  tabindex="-1"
   role="dialog"
   aria-modal="false"
   aria-labelledby="{id}-title"
   class={cn(
-    'fixed z-40 flex flex-col overflow-hidden rounded-xl border border-border bg-background text-foreground shadow-2xl',
+    'fixed z-40 flex flex-col overflow-hidden rounded-xl border border-border bg-background text-foreground shadow-2xl outline-none',
     surface.moving && 'select-none',
     dockHint && 'ring-2 ring-primary',
     className,
@@ -184,7 +208,7 @@
   <!-- svelte-ignore a11y_no_static_element_interactions -->
   <div
     class={cn(
-      'flex h-11 shrink-0 touch-none items-center gap-1 border-b border-border bg-muted/40 pl-1 pr-2',
+      'flex h-12 shrink-0 touch-none items-center gap-1 border-b border-border bg-muted/40 pl-1 pr-2',
       surface.moving ? 'cursor-grabbing' : 'cursor-grab',
     )}
     data-testid="window-header"
@@ -204,7 +228,24 @@
     >
       <Icon name="grip" size={14} />
     </button>
-    <h2 id="{id}-title" class="min-w-0 flex-1 truncate text-sm font-semibold">{title}</h2>
+    {#if icon}
+      {@render icon()}
+    {:else}
+      <span
+        class="flex size-7 shrink-0 items-center justify-center rounded-full bg-primary/10 text-primary"
+        aria-hidden="true"
+      >
+        <Icon name="sparkles" size={14} />
+      </span>
+    {/if}
+    <div class="ml-1 flex min-w-0 flex-1 flex-col leading-tight">
+      <h2 id="{id}-title" class="truncate text-sm font-semibold">{title}</h2>
+      {#if subtitle}
+        <span class="truncate text-[11px] text-muted-foreground" data-testid="window-subtitle"
+          >{subtitle}</span
+        >
+      {/if}
+    </div>
     {@render actions?.()}
     {#if dockable}
       <Button

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

@@ -9,6 +9,10 @@ import type { ChatSurface } from '../surface.svelte.js';
 interface Props {
     surface: ChatSurface;
     title?: string;
+    /** A second, quieter line under the title, e.g. the conversation's name. */
+    subtitle?: string;
+    /** Replaces the mark before the title. */
+    icon?: Snippet;
     id?: string;
     /** Header buttons before Dock and Minimize, e.g. New chat. */
     actions?: Snippet;
@@ -18,6 +22,11 @@ interface Props {
     resizable?: boolean;
     /** Called after the window minimizes, e.g. to move focus to the launcher. */
     onminimize?: () => void;
+    /**
+     * Take the keyboard when the window appears and nothing inside has it yet: the first text
+     * field, or the window itself. Without it Escape and Tab start from the page underneath.
+     */
+    autofocus?: boolean;
     class?: string;
 }
 declare const FloatingWindow: import("svelte").Component<Props, {}, "">;

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

@@ -1 +1 @@
-{"version":3,"file":"FloatingWindow.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/FloatingWindow.svelte.ts"],"names":[],"mappings":"AAGA;;;;;KAKK;AACL,OAAO,EAAW,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AAE/C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAWtD,UAAU,KAAK;IACb,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAkLH,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}
+{"version":3,"file":"FloatingWindow.svelte.d.ts","sourceRoot":"","sources":["../../src/lib/components/FloatingWindow.svelte.ts"],"names":[],"mappings":"AAGA;;;;;KAKK;AACL,OAAO,EAAoB,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AAExD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAWtD,UAAU,KAAK;IACb,OAAO,EAAE,WAAW,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,4EAA4E;IAC5E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0CAA0C;IAC1C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,8DAA8D;IAC9D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,yEAAyE;IACzE,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,6EAA6E;IAC7E,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AA2MH,QAAA,MAAM,cAAc,2CAAwC,CAAC;AAC7D,KAAK,cAAc,GAAG,UAAU,CAAC,OAAO,cAAc,CAAC,CAAC;AACxD,eAAe,cAAc,CAAC"}

package/dist/index.d.ts

@@ -8,6 +8,7 @@ export * from './session.svelte.js';
 export * from './shortcuts.js';
 export * from './surface-geometry.js';
 export * from './surface.svelte.js';
+export * from './thinking.js';
 export * from './ui-frame-protocol.js';
 export * from './welcome.js';
 export { default as AgentChat } from './components/AgentChat.svelte';

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,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,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;AACjE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,oCAAoC,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,gBAAgB,CAAC;AAC/B,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,eAAe,CAAC;AAC9B,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;AACjE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACjF,OAAO,EAAE,OAAO,IAAI,YAAY,EAAE,MAAM,kCAAkC,CAAC;AAC3E,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,oCAAoC,CAAC"}

package/dist/index.js

@@ -8,6 +8,7 @@ export * from './session.svelte.js';
 export * from './shortcuts.js';
 export * from './surface-geometry.js';
 export * from './surface.svelte.js';
+export * from './thinking.js';
 export * from './ui-frame-protocol.js';
 export * from './welcome.js';
 export { default as AgentChat } from './components/AgentChat.svelte';

package/dist/session.svelte.d.ts

@@ -50,6 +50,8 @@ export declare class ChatSession {
         bytes: number;
         status: "uploaded" | "indexed" | "failed";
     }[];
+    /** The unsent composer text, kept here so it survives the view being remounted. */
+    draft: string;
     private controller;
     /** The request being streamed; differs from the shown answer's id while continuing it. */
     private streamRequestId;

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":"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"}
+{"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,EACP,UAAU,EACX,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAOL,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;IACjG;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAQD,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,4FAA4F;IAC5F,KAAK,SAAqC;IAC1C,SAAS,qBAAyC;IAClD,YAAY;;;;;;QAAyB;IACrC,mFAAmF;IACnF,KAAK,SAAc;IAEnB,OAAO,CAAC,UAAU,CAA8B;IAChD,0FAA0F;IAC1F,OAAO,CAAC,eAAe,CAAqB;IAC5C,0FAA0F;IAC1F,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,WAAW,CAA4C;IAC/D,4EAA4E;IAC5E,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;IAC7C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyC;gBAEvD,OAAO,EAAE,kBAAkB;IAOvC;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,SAAS,KAAK,IAAI,GAAG,MAAM,IAAI;IAO3D,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,IAAI,OAAO,IAAI,gBAAgB,GAAG,SAAS,CAG1C;IAED;;;;OAIG;IACH,KAAK,IAAI,IAAI;IAWb,wFAAwF;IACxF,OAAO,CAAC,MAAM;IAUd,yFAAyF;IACnF,IAAI,CAAC,cAAc,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2CjD;;;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;IA+B/F;;;OAGG;IACG,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS7C;;;OAGG;IACH,OAAO,CAAC,WAAW;IAOnB,oFAAoF;IAC9E,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IASlD,2EAA2E;IACrE,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAS1D;;;;OAIG;IACG,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA4BhD,+FAA+F;IACzF,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAa9C;;;OAGG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyBzF;;;;;OAKG;IACH,MAAM,IAAI,IAAI;YAgBA,GAAG;IA2FjB,wFAAwF;IACxF,OAAO,CAAC,MAAM;IA+Bd,OAAO,CAAC,QAAQ;IAOhB,OAAO,CAAC,MAAM;CAKf;AAiBD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,kBAAkB,GAAG,WAAW,CAE1E"}

package/dist/session.svelte.js

@@ -18,6 +18,8 @@ export class ChatSession {
     agent = $state('classic-agent');
     loadError = $state(undefined);
     pendingFiles = $state([]);
+    /** The unsent composer text, kept here so it survives the view being remounted. */
+    draft = $state('');
     controller;
     /** The request being streamed; differs from the shown answer's id while continuing it. */
     streamRequestId;

package/dist/surface-geometry.d.ts

@@ -44,6 +44,10 @@ export declare function clampSize(size: Size, viewport: Size): Size;
 export declare function clampRect(rect: Rect, viewport: Size): Rect;
 /** Where a new window opens: beside the launcher's corner, clear of the launcher itself. */
 export declare function defaultRect(viewport: Size, corner: Corner, size?: Size): Rect;
+/** Top-left point of the launcher button when it sits in `corner`. */
+export declare function launcherPoint(corner: Corner, viewport: Size): Point;
+/** Keep a freely placed launcher button fully inside the viewport. */
+export declare function clampLauncher(point: Point, viewport: Size): Point;
 /** The corner a dropped launcher snaps to. */
 export declare function nearestCorner(point: Point, viewport: Size): Corner;
 /**

package/dist/surface-geometry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"surface-geometry.d.ts","sourceRoot":"","sources":["../src/lib/surface-geometry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AACD,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,WAAW,IAAK,SAAQ,KAAK,EAAE,IAAI;CAAG;AAE5C,MAAM,MAAM,MAAM,GAAG,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,CAAC;AAC/E,eAAO,MAAM,OAAO,EAAE,SAAS,MAAM,EAA6D,CAAC;AAEnG,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAChF,eAAO,MAAM,iBAAiB,EAAE,SAAS,eAAe,EASvD,CAAC;AAEF,eAAO,MAAM,YAAY;;;;;IAKvB,yDAAyD;;CAEjD,CAAC;AACX,eAAO,MAAM,kBAAkB,EAAE,IAAkC,CAAC;AACpE,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,gGAAgG;AAChG,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,yFAAyF;AACzF,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,4EAA4E;AAC5E,eAAO,MAAM,QAAQ,KAAK,CAAC;AAK3B,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,GAAG,IAAI,CAS1D;AAED,0EAA0E;AAC1E,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,GAAG,IAAI,CAQ1D;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,IAAyB,GAAG,IAAI,CAmBjG;AAED,8CAA8C;AAC9C,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,GAAG,MAAM,CAIlE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,eAAe,EAC1B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,IAAI,GACb,IAAI,CAaN;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,GAAG,OAAO,CAElE"}
+{"version":3,"file":"surface-geometry.d.ts","sourceRoot":"","sources":["../src/lib/surface-geometry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,WAAW,KAAK;IACpB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX;AACD,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AACD,MAAM,WAAW,IAAK,SAAQ,KAAK,EAAE,IAAI;CAAG;AAE5C,MAAM,MAAM,MAAM,GAAG,cAAc,GAAG,aAAa,GAAG,WAAW,GAAG,UAAU,CAAC;AAC/E,eAAO,MAAM,OAAO,EAAE,SAAS,MAAM,EAA6D,CAAC;AAEnG,2CAA2C;AAC3C,MAAM,MAAM,eAAe,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;AAChF,eAAO,MAAM,iBAAiB,EAAE,SAAS,eAAe,EASvD,CAAC;AAEF,eAAO,MAAM,YAAY;;;;;IAKvB,yDAAyD;;CAEjD,CAAC;AACX,eAAO,MAAM,kBAAkB,EAAE,IAAkC,CAAC;AACpE,eAAO,MAAM,aAAa,KAAK,CAAC;AAChC,eAAO,MAAM,eAAe,KAAK,CAAC;AAClC,gGAAgG;AAChG,eAAO,MAAM,cAAc,IAAI,CAAC;AAChC,yFAAyF;AACzF,eAAO,MAAM,cAAc,KAAK,CAAC;AACjC,4EAA4E;AAC5E,eAAO,MAAM,QAAQ,KAAK,CAAC;AAK3B,wEAAwE;AACxE,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,GAAG,IAAI,CAS1D;AAED,0EAA0E;AAC1E,wBAAgB,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,GAAG,IAAI,CAQ1D;AAED,4FAA4F;AAC5F,wBAAgB,WAAW,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE,IAAyB,GAAG,IAAI,CAmBjG;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,GAAG,KAAK,CAMnE;AAED,sEAAsE;AACtE,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,GAAG,KAAK,CAIjE;AAED,8CAA8C;AAC9C,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,GAAG,MAAM,CAIlE;AAED;;;GAGG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,IAAI,EACV,SAAS,EAAE,eAAe,EAC1B,EAAE,EAAE,MAAM,EACV,EAAE,EAAE,MAAM,EACV,QAAQ,EAAE,IAAI,GACb,IAAI,CAaN;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,GAAG,OAAO,CAElE"}

package/dist/surface-geometry.js

@@ -63,6 +63,19 @@ export function defaultRect(viewport, corner, size = DEFAULT_FLOAT_SIZE) {
         y: corner.startsWith('top') ? clear : viewport.height - fitted.height - clear,
     }, viewport);
 }
+/** Top-left point of the launcher button when it sits in `corner`. */
+export function launcherPoint(corner, viewport) {
+    const far = (extent) => Math.max(0, extent - LAUNCHER_SIZE - LAUNCHER_MARGIN);
+    return {
+        x: corner.endsWith('left') ? LAUNCHER_MARGIN : far(viewport.width),
+        y: corner.startsWith('top') ? LAUNCHER_MARGIN : far(viewport.height),
+    };
+}
+/** Keep a freely placed launcher button fully inside the viewport. */
+export function clampLauncher(point, viewport) {
+    const within = (value, extent) => Math.min(Math.max(0, value), Math.max(0, extent - LAUNCHER_SIZE));
+    return { x: within(point.x, viewport.width), y: within(point.y, viewport.height) };
+}
 /** The corner a dropped launcher snaps to. */
 export function nearestCorner(point, viewport) {
     const vertical = point.y < viewport.height / 2 ? 'top' : 'bottom';

package/dist/surface.svelte.d.ts

@@ -1,4 +1,4 @@
-import { type Corner, type Rect, type ResizeDirection, type Size } from './surface-geometry.js';
+import { type Corner, type Point, type Rect, type ResizeDirection, type Size } from './surface-geometry.js';
 /**
  * How the chat is presented over a host page: collapsed to the launcher button, a floating
  * window, or docked to the side. The full page is a host route, not a mode here; a host on that
@@ -21,7 +21,7 @@ export interface ChatSurfaceOptions {
 }
 /**
  * Reactive state of the detached chat (Svelte 5 runes class): which presentation is showing,
- * the launcher's corner, the floating window's geometry and whether an answer arrived unseen.
+ * where the launcher sits, the floating window's geometry and whether an answer arrived unseen.
  * Layout survives reloads through `storageKey`; a saved window that no longer fits the viewport
  * is pulled back inside.
  */
@@ -30,6 +30,11 @@ export declare class ChatSurface {
     /** The open presentation the launcher returns to. */
     lastOpen: OpenSurfaceMode;
     corner: Corner;
+    /**
+     * Where the user dropped the launcher (its top-left), or null while it sits in `corner`.
+     * Separate from the window's place: moving one never moves the other.
+     */
+    launcher: Point | null;
     /** An answer finished while the chat was collapsed. Cleared on open. */
     unread: boolean;
     /** True while the user drags or resizes the window. */
@@ -48,6 +53,11 @@ export declare class ChatSurface {
     /** A turn ended; flag it when the user cannot see the answer. */
     notifyTurnEnd(): void;
     setCorner(corner: Corner): void;
+    /**
+     * The user dropped the launcher at `point` (top-left). It stays there; `corner` follows the
+     * nearest one, which is where a window that was never moved opens.
+     */
+    setLauncher(point: Point): void;
     /** Move the window by a pointer or key delta. Call `commit` when the gesture ends. */
     moveBy(dx: number, dy: number): void;
     resizeBy(direction: ResizeDirection, dx: number, dy: number): void;

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

@@ -1 +1 @@
-{"version":3,"file":"surface.svelte.d.ts","sourceRoot":"","sources":["../src/lib/surface.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EAKL,KAAK,MAAM,EACX,KAAK,IAAI,EACT,KAAK,eAAe,EACpB,KAAK,IAAI,EACV,MAAM,uBAAuB,CAAC;AAE/B;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AACxD,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;AAE/D,kEAAkE;AAClE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEvE,MAAM,WAAW,kBAAkB;IACjC,mGAAmG;IACnG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC,CAAC;IAC/C,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAiBD;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,IAAI,cAAmC;IACvC,qDAAqD;IACrD,QAAQ,kBAAoC;IAC5C,MAAM,SAAkC;IACxC,wEAAwE;IACxE,MAAM,UAAiB;IACvB,uDAAuD;IACvD,MAAM,UAAiB;IACvB,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAEjC,OAAO,GAAE,kBAAuB;IAO5C,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,yFAAyF;IACzF,IAAI,IAAI,IAAI,IAAI,CAGf;IAED,IAAI,CAAC,IAAI,GAAE,eAA+B,GAAG,IAAI;IAMjD,QAAQ,IAAI,IAAI;IAIhB,MAAM,IAAI,IAAI;IAId,IAAI,IAAI,IAAI;IAGZ,KAAK,IAAI,IAAI;IAIb,iEAAiE;IACjE,aAAa,IAAI,IAAI;IAIrB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B,sFAAsF;IACtF,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAIpC,QAAQ,CAAC,SAAS,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAGlE,oDAAoD;IACpD,MAAM,IAAI,IAAI;IAId,6EAA6E;IAC7E,SAAS,IAAI,IAAI;IAKjB;;;OAGG;IACH,MAAM,CAAC,MAAM,GAAE,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,qBAAqB,CAAU,GAAG,MAAM,IAAI;IAS7F,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,OAAO;IAgBf,OAAO,CAAC,OAAO;CAchB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAE/E"}
+{"version":3,"file":"surface.svelte.d.ts","sourceRoot":"","sources":["../src/lib/surface.svelte.ts"],"names":[],"mappings":"AAAA,OAAO,EAQL,KAAK,MAAM,EACX,KAAK,KAAK,EACV,KAAK,IAAI,EACT,KAAK,eAAe,EACpB,KAAK,IAAI,EACV,MAAM,uBAAuB,CAAC;AAE/B;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,OAAO,GAAG,MAAM,CAAC;AACxD,MAAM,MAAM,eAAe,GAAG,OAAO,CAAC,WAAW,EAAE,UAAU,CAAC,CAAC;AAE/D,kEAAkE;AAClE,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC;AAEvE,MAAM,WAAW,kBAAkB;IACjC,mGAAmG;IACnG,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,iDAAiD;IACjD,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,SAAS,CAAC,CAAC;IAC/C,2CAA2C;IAC3C,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,8CAA8C;IAC9C,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAuBD;;;;;GAKG;AACH,qBAAa,WAAW;IACtB,IAAI,cAAmC;IACvC,qDAAqD;IACrD,QAAQ,kBAAoC;IAC5C,MAAM,SAAkC;IACxC;;;OAGG;IACH,QAAQ,eAA8B;IACtC,wEAAwE;IACxE,MAAM,UAAiB;IACvB,uDAAuD;IACvD,MAAM,UAAiB;IACvB,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAqB;gBAEjC,OAAO,GAAE,kBAAuB;IAO5C,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED,yFAAyF;IACzF,IAAI,IAAI,IAAI,IAAI,CAGf;IAED,IAAI,CAAC,IAAI,GAAE,eAA+B,GAAG,IAAI;IAMjD,QAAQ,IAAI,IAAI;IAIhB,MAAM,IAAI,IAAI;IAId,IAAI,IAAI,IAAI;IAGZ,KAAK,IAAI,IAAI;IAIb,iEAAiE;IACjE,aAAa,IAAI,IAAI;IAIrB,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAK/B;;;OAGG;IACH,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI;IAU/B,sFAAsF;IACtF,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAIpC,QAAQ,CAAC,SAAS,EAAE,eAAe,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI;IAGlE,oDAAoD;IACpD,MAAM,IAAI,IAAI;IAId,6EAA6E;IAC7E,SAAS,IAAI,IAAI;IAKjB;;;OAGG;IACH,MAAM,CAAC,MAAM,GAAE,IAAI,CAAC,MAAM,EAAE,kBAAkB,GAAG,qBAAqB,CAAU,GAAG,MAAM,IAAI;IAS7F,OAAO,CAAC,QAAQ;IAMhB,OAAO,CAAC,OAAO;IAUf,OAAO,CAAC,OAAO;IAkBf,OAAO,CAAC,OAAO;CAehB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAE/E"}

package/dist/surface.svelte.js

@@ -1,10 +1,13 @@
-import { CORNERS, clampRect, defaultRect, resizeRect, } from './surface-geometry.js';
+import { CORNERS, LAUNCHER_SIZE, clampLauncher, clampRect, defaultRect, nearestCorner, resizeRect, } from './surface-geometry.js';
+const isPoint = (value) => typeof value === 'object' &&
+    value !== null &&
+    ['x', 'y'].every((key) => Number.isFinite(value[key]));
 const isRect = (value) => typeof value === 'object' &&
     value !== null &&
     ['x', 'y', 'width', 'height'].every((key) => Number.isFinite(value[key]));
 /**
  * Reactive state of the detached chat (Svelte 5 runes class): which presentation is showing,
- * the launcher's corner, the floating window's geometry and whether an answer arrived unseen.
+ * where the launcher sits, the floating window's geometry and whether an answer arrived unseen.
  * Layout survives reloads through `storageKey`; a saved window that no longer fits the viewport
  * is pulled back inside.
  */
@@ -13,6 +16,11 @@ export class ChatSurface {
     /** The open presentation the launcher returns to. */
     lastOpen = $state('float');
     corner = $state('bottom-right');
+    /**
+     * Where the user dropped the launcher (its top-left), or null while it sits in `corner`.
+     * Separate from the window's place: moving one never moves the other.
+     */
+    launcher = $state(null);
     /** An answer finished while the chat was collapsed. Cleared on open. */
     unread = $state(false);
     /** True while the user drags or resizes the window. */
@@ -62,6 +70,17 @@ export class ChatSurface {
     }
     setCorner(corner) {
         this.corner = corner;
+        this.launcher = null;
+        this.persist();
+    }
+    /**
+     * The user dropped the launcher at `point` (top-left). It stays there; `corner` follows the
+     * nearest one, which is where a window that was never moved opens.
+     */
+    setLauncher(point) {
+        const viewport = this.viewport();
+        this.launcher = clampLauncher(point, viewport);
+        this.corner = nearestCorner({ x: this.launcher.x + LAUNCHER_SIZE / 2, y: this.launcher.y + LAUNCHER_SIZE / 2 }, viewport);
         this.persist();
     }
     /** Move the window by a pointer or key delta. Call `commit` when the gesture ends. */
@@ -130,6 +149,8 @@ export class ChatSurface {
                 this.corner = data.corner;
             if (isRect(data.rect))
                 this.saved = clampRect(data.rect, this.viewport());
+            if (isPoint(data.launcher))
+                this.launcher = clampLauncher({ x: data.launcher.x, y: data.launcher.y }, this.viewport());
         }
         catch {
             // Unreadable or blocked storage: start from the defaults.
@@ -143,6 +164,7 @@ export class ChatSurface {
                 lastOpen: this.lastOpen,
                 corner: this.corner,
                 rect: this.saved,
+                launcher: this.launcher,
             };
             this.storage()?.setItem(this.options.storageKey, JSON.stringify(data));
         }

package/dist/thinking.d.ts

@@ -0,0 +1,10 @@
+/**
+ * What the assistant shows while it works and has nothing to say yet: homebuilding verbs in
+ * place of a bare "Thinking" (the wording the Classic Chat widget uses).
+ */
+export declare const THINKING_PHRASES: readonly string[];
+/** How long one phrase shows before the next. */
+export declare const THINKING_PHRASE_MS = 4000;
+/** A random phrase, never `previous` twice in a row. */
+export declare function pickThinkingPhrase(previous?: string, random?: () => number): string;
+//# sourceMappingURL=thinking.d.ts.map

package/dist/thinking.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thinking.d.ts","sourceRoot":"","sources":["../src/lib/thinking.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,MAAM,EAiD7C,CAAC;AAEF,iDAAiD;AACjD,eAAO,MAAM,kBAAkB,OAAO,CAAC;AAEvC,wDAAwD;AACxD,wBAAgB,kBAAkB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,MAAM,GAAE,MAAM,MAAoB,GAAG,MAAM,CAGhG"}

package/dist/thinking.js

@@ -0,0 +1,61 @@
+/**
+ * What the assistant shows while it works and has nothing to say yet: homebuilding verbs in
+ * place of a bare "Thinking" (the wording the Classic Chat widget uses).
+ */
+export const THINKING_PHRASES = [
+    'Framing',
+    'Drafting',
+    'Surveying',
+    'Grading',
+    'Excavating',
+    'Leveling',
+    'Measuring',
+    'Squaring',
+    'Pouring footings',
+    'Pouring slab',
+    'Laying foundation',
+    'Raising walls',
+    'Setting trusses',
+    'Sheathing',
+    'Roofing',
+    'Nailing',
+    'Checking plans',
+    'Reading blueprints',
+    'Pulling permits',
+    'Scheduling inspections',
+    'Sketching layouts',
+    'Mapping lots',
+    'Staking corners',
+    'Wiring',
+    'Plumbing',
+    'Ducting',
+    'Insulating',
+    'Hanging drywall',
+    'Mudding',
+    'Sanding',
+    'Priming',
+    'Painting',
+    'Laying tile',
+    'Installing cabinets',
+    'Setting countertops',
+    'Hanging doors',
+    'Trimming',
+    'Flooring',
+    'Picking finishes',
+    'Matching paint',
+    'Choosing fixtures',
+    'Landscaping',
+    'Touring models',
+    'Comparing plans',
+    'Building',
+    'Punch list',
+    'Final walkthrough',
+    'Handing keys',
+];
+/** How long one phrase shows before the next. */
+export const THINKING_PHRASE_MS = 4000;
+/** A random phrase, never `previous` twice in a row. */
+export function pickThinkingPhrase(previous, random = Math.random) {
+    const pool = previous ? THINKING_PHRASES.filter((p) => p !== previous) : THINKING_PHRASES;
+    return pool[Math.min(pool.length - 1, Math.floor(random() * pool.length))];
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@classic-homes/agent-chat",
-  "version": "0.12.0",
+  "version": "0.13.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.",
@@ -18,8 +18,8 @@
     "!dist/**/*.test.*"
   ],
   "dependencies": {
-    "@classic-homes/agent-client": "0.12.0",
-    "@classic-homes/agent-contracts": "0.12.0",
+    "@classic-homes/agent-client": "0.13.0",
+    "@classic-homes/agent-contracts": "0.13.0",
     "dompurify": "3.4.17"
   },
   "peerDependencies": {