@happyvertical/smrt-chat 0.55.6 → 0.55.7

package/dist/index.js

@@ -1,5 +1,5 @@
 import { c as ChatThread, d as ChatParticipant, f as ChatMessage, i as clientRequestMessageId, l as ChatRoom, n as ChatService, o as VoiceSessionCollection, p as AgentSession, s as VoiceSession, t as ChatClientRequestConflictError, u as ChatReaction } from "./chunks/ChatService-C9UxuJaw.js";
-import { A as MAX_CLIENT_TOOLS, C as SESSION_CONTINUATIONS_FIELD, D as runAssistantTurn, E as createSessionContinuationStore, F as classifyToolError, I as invokeManifestTool, L as manifestToolToAITool, M as MAX_CLIENT_TOOL_SCHEMA_BYTES, N as appendClientToolResults, O as CLIENT_TOOL_RESULT_GUIDANCE, P as buildManifestToolCatalog, R as runToolLoop, S as DEFAULT_CONTINUATION_TTL_MS, T as createMemoryContinuationStore, _ as runPersonaConversationTurn, a as MAX_CHAT_STREAM_CONTENT_LENGTH, b as CONTINUATION_CLAIM_TTL_MS, c as encodeChatStreamEvent, d as conversationPersonaFromAgentPersona, f as conversationPersonaFromResolved, g as resolveConversationInstructions, h as recallPersonaMemory, i as DEFAULT_CHAT_STREAM_HEARTBEAT_MS, j as MAX_CLIENT_TOOL_RESULT_CHARS, k as DEFAULT_MAX_STEPS, l as runChatConversationStream, m as principalBindingFor, n as ChatStreamError, o as MAX_CHAT_STREAM_MESSAGES, p as formatRecalledMemory, r as ChatStreamUnauthorizedError, s as createChatStreamHandler, t as ChatStreamBadRequestError, u as bindPersonaToSession, v as ASSISTANT_TURN_GENERIC_ERROR, w as createAssistantTurnResponse, x as DEFAULT_ASSISTANT_TURN_HEARTBEAT_MS, y as AssistantTurnUserError, z as sanitizeClientToolDeclarations } from "./chunks/chat-stream-Dq-tb26i.js";
+import { A as MAX_CLIENT_TOOLS, C as SESSION_CONTINUATIONS_FIELD, D as runAssistantTurn, E as createSessionContinuationStore, F as classifyToolError, I as invokeManifestTool, L as manifestToolToAITool, M as MAX_CLIENT_TOOL_SCHEMA_BYTES, N as appendClientToolResults, O as CLIENT_TOOL_RESULT_GUIDANCE, P as buildManifestToolCatalog, R as runToolLoop, S as DEFAULT_CONTINUATION_TTL_MS, T as createMemoryContinuationStore, _ as runPersonaConversationTurn, a as MAX_CHAT_STREAM_CONTENT_LENGTH, b as CONTINUATION_CLAIM_TTL_MS, c as encodeChatStreamEvent, d as conversationPersonaFromAgentPersona, f as conversationPersonaFromResolved, g as resolveConversationInstructions, h as recallPersonaMemory, i as DEFAULT_CHAT_STREAM_HEARTBEAT_MS, j as MAX_CLIENT_TOOL_RESULT_CHARS, k as DEFAULT_MAX_STEPS, l as runChatConversationStream, m as principalBindingFor, n as ChatStreamError, o as MAX_CHAT_STREAM_MESSAGES, p as formatRecalledMemory, r as ChatStreamUnauthorizedError, s as createChatStreamHandler, t as ChatStreamBadRequestError, u as bindPersonaToSession, v as ASSISTANT_TURN_GENERIC_ERROR, w as createAssistantTurnResponse, x as DEFAULT_ASSISTANT_TURN_HEARTBEAT_MS, y as AssistantTurnUserError, z as sanitizeClientToolDeclarations } from "./chunks/chat-stream-BM3-maAM.js";
 import { i as matchesToolAllowList, n as encodeAssistantTurnEvent, r as readAssistantTurnStream, t as AssistantTurnStreamError } from "./chunks/assistant-turn-events-BbZUf-Ju.js";
 import { a as createServerDataSurfaceBridge, i as createDataSurfaceCommandBridge, n as DEFAULT_DATA_SURFACE_BRIDGE_TTL_MS, r as createDataSurfaceBridge, t as DATA_SURFACE_BRIDGE_VERSION } from "./chunks/data-surface-bridge-BJomMxjS.js";
 import { CHAT_MODULE_META, CHAT_UI_SLOTS } from "./ui.js";

package/dist/manifest.json

@@ -2,7 +2,7 @@
   "version": "1.0.0",
   "timestamp": 0,
   "packageName": "@happyvertical/smrt-chat",
-  "packageVersion": "0.55.6",
+  "packageVersion": "0.55.7",
   "objects": {
     "@happyvertical/smrt-chat:AgentSessionCollection": {
       "name": "agentsessioncollection",
@@ -1948,6 +1948,7 @@
       "className": "AgentSession",
       "qualifiedName": "@happyvertical/smrt-chat:AgentSession",
       "collection": "agentsessions",
+      "description": "Agent conversation session.",
       "filePath": "/home/runner/work/smrt/smrt/packages/chat/src/models/AgentSession.ts",
       "packageName": "@happyvertical/smrt-chat",
       "fields": {
@@ -2406,6 +2407,7 @@
       "className": "ChatMessage",
       "qualifiedName": "@happyvertical/smrt-chat:ChatMessage",
       "collection": "chatmessages",
+      "description": "Chat message. Internal model — all mutations must go through the membership-checked ChatService (S5 #1392).",
       "filePath": "/home/runner/work/smrt/smrt/packages/chat/src/models/ChatMessage.ts",
       "packageName": "@happyvertical/smrt-chat",
       "fields": {
@@ -2924,6 +2926,7 @@
       "className": "ChatParticipant",
       "qualifiedName": "@happyvertical/smrt-chat:ChatParticipant",
       "collection": "chatparticipants",
+      "description": "Room membership row. Internal model — membership must be established and mutated only through the membership/owner-checked ChatService (S5 #1392).",
       "filePath": "/home/runner/work/smrt/smrt/packages/chat/src/models/ChatParticipant.ts",
       "packageName": "@happyvertical/smrt-chat",
       "fields": {
@@ -3303,6 +3306,7 @@
       "className": "ChatReaction",
       "qualifiedName": "@happyvertical/smrt-chat:ChatReaction",
       "collection": "chatreactions",
+      "description": "Message reaction. Internal model — reactions must be added/removed only through the membership-checked ChatService (S5 #1392).",
       "filePath": "/home/runner/work/smrt/smrt/packages/chat/src/models/ChatReaction.ts",
       "packageName": "@happyvertical/smrt-chat",
       "fields": {
@@ -3487,6 +3491,7 @@
       "className": "ChatRoom",
       "qualifiedName": "@happyvertical/smrt-chat:ChatRoom",
       "collection": "chatrooms",
+      "description": "Chat room supporting public channels, private groups, DMs, and agent conversations.",
       "filePath": "/home/runner/work/smrt/smrt/packages/chat/src/models/ChatRoom.ts",
       "packageName": "@happyvertical/smrt-chat",
       "fields": {
@@ -3841,6 +3846,7 @@
       "className": "ChatThread",
       "qualifiedName": "@happyvertical/smrt-chat:ChatThread",
       "collection": "chatthreads",
+      "description": "Conversation thread. Internal model — threads must be created/mutated only through the membership-checked ChatService (S5 #1392).",
       "filePath": "/home/runner/work/smrt/smrt/packages/chat/src/models/ChatThread.ts",
       "packageName": "@happyvertical/smrt-chat",
       "fields": {
@@ -4085,6 +4091,7 @@
       "className": "VoiceGatewayTurn",
       "qualifiedName": "@happyvertical/smrt-chat:VoiceGatewayTurn",
       "collection": "voicegatewayturns",
+      "description": "Durable reservation for a gateway turn. The natural key makes turn_id replay checks concurrency-safe before transcript messages are written.",
       "filePath": "/home/runner/work/smrt/smrt/packages/chat/src/models/VoiceGatewayTurn.ts",
       "packageName": "@happyvertical/smrt-chat",
       "fields": {
@@ -4357,6 +4364,7 @@
       "className": "VoiceSession",
       "qualifiedName": "@happyvertical/smrt-chat:VoiceSession",
       "collection": "voicesessions",
+      "description": "Short-lived binding proving a voice gateway turn belongs to an authenticated SMRT actor, persona, and chat session.",
       "filePath": "/home/runner/work/smrt/smrt/packages/chat/src/models/VoiceSession.ts",
       "packageName": "@happyvertical/smrt-chat",
       "fields": {

package/dist/smrt-knowledge.json

@@ -3,12 +3,12 @@
   "sensitiveFieldsExcluded": true,
   "generatedAt": "1970-01-01T00:00:00.000Z",
   "packageName": "@happyvertical/smrt-chat",
-  "packageVersion": "0.55.6",
+  "packageVersion": "0.55.7",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "78884d71653332f6e089fc70ff926755dbca12a2ba1a9a5f4ba4aa8cfd1b72a0",
-    "packageJson": "6e3601ea62993897b790ac9c9acc517e2aa47355862bc9081bed9ff2f4bc1d78",
+    "manifest": "f855574fffcad9f6344572790fef65561ef4cf1c2e05e7d4ca720f2548c188ed",
+    "packageJson": "3fcd03b006478ce2d74ceed792325386f344095904d71501ac770628d661535d",
     "agents": "0d11ad3c134fc4de4c3fd61fb3a5e7d760ecf8ef6b2b16679b66358e6877dd74",
     "moduleDoc:agents/dev-workbench.md": "69b6f827d25c8aeb0e7516c90303af23948803213b5d34bc334c1e3376c83a16",
     "agentSurface:src/routes/chat-dev.intents.ts": "ff8f7c19c7eb6e841a08f03c97773c53092ed208004666bfed372bd1ad456b35"
@@ -1237,6 +1237,7 @@
       "name": "AgentSession",
       "qualifiedName": "@happyvertical/smrt-chat:AgentSession",
       "collection": "agentsessions",
+      "description": "Agent conversation session.",
       "tableName": "agent_sessions",
       "packageName": "@happyvertical/smrt-chat",
       "extends": "SmrtObject",
@@ -1689,6 +1690,7 @@
       "name": "ChatMessage",
       "qualifiedName": "@happyvertical/smrt-chat:ChatMessage",
       "collection": "chatmessages",
+      "description": "Chat message. Internal model — all mutations must go through the membership-checked ChatService (S5 #1392).",
       "tableName": "chat_messages",
       "packageName": "@happyvertical/smrt-chat",
       "extends": "SmrtObject",
@@ -2190,6 +2192,7 @@
       "name": "ChatParticipant",
       "qualifiedName": "@happyvertical/smrt-chat:ChatParticipant",
       "collection": "chatparticipants",
+      "description": "Room membership row. Internal model — membership must be established and mutated only through the membership/owner-checked ChatService (S5 #1392).",
       "tableName": "chat_participants",
       "packageName": "@happyvertical/smrt-chat",
       "extends": "SmrtObject",
@@ -2504,6 +2507,7 @@
       "name": "ChatReaction",
       "qualifiedName": "@happyvertical/smrt-chat:ChatReaction",
       "collection": "chatreactions",
+      "description": "Message reaction. Internal model — reactions must be added/removed only through the membership-checked ChatService (S5 #1392).",
       "tableName": "chat_reactions",
       "packageName": "@happyvertical/smrt-chat",
       "extends": "SmrtObject",
@@ -2592,6 +2596,7 @@
       "qualifiedName": "@happyvertical/smrt-chat:ChatRoom",
       "displayLabelField": "name",
       "collection": "chatrooms",
+      "description": "Chat room supporting public channels, private groups, DMs, and agent conversations.",
       "tableName": "chat_rooms",
       "packageName": "@happyvertical/smrt-chat",
       "extends": "SmrtObject",
@@ -2946,6 +2951,7 @@
       "qualifiedName": "@happyvertical/smrt-chat:ChatThread",
       "displayLabelField": "title",
       "collection": "chatthreads",
+      "description": "Conversation thread. Internal model — threads must be created/mutated only through the membership-checked ChatService (S5 #1392).",
       "tableName": "chat_threads",
       "packageName": "@happyvertical/smrt-chat",
       "extends": "SmrtObject",
@@ -3146,6 +3152,7 @@
       "name": "VoiceGatewayTurn",
       "qualifiedName": "@happyvertical/smrt-chat:VoiceGatewayTurn",
       "collection": "voicegatewayturns",
+      "description": "Durable reservation for a gateway turn. The natural key makes turn_id replay checks concurrency-safe before transcript messages are written.",
       "tableName": "voice_gateway_turns",
       "packageName": "@happyvertical/smrt-chat",
       "extends": "SmrtObject",
@@ -3301,6 +3308,7 @@
       "name": "VoiceSession",
       "qualifiedName": "@happyvertical/smrt-chat:VoiceSession",
       "collection": "voicesessions",
+      "description": "Short-lived binding proving a voice gateway turn belongs to an authenticated SMRT actor, persona, and chat session.",
       "tableName": "voice_sessions",
       "packageName": "@happyvertical/smrt-chat",
       "extends": "SmrtObject",

package/dist/svelte/components/assistant/AssistantComposer.svelte

@@ -15,6 +15,8 @@ import {
   type DictationSourceProvider,
   DictationStatus,
   type DictationTranscribe,
+  type HandsFreeCaptureFactory,
+  type HandsFreeVadOptions,
   insertTextAtCursor,
   longPress,
   primeReadyBeep,
@@ -22,7 +24,7 @@ import {
 } from '@happyvertical/smrt-ui/forms';
 import { useI18n } from '@happyvertical/smrt-ui/i18n';
 import { Button } from '@happyvertical/smrt-ui/ui';
-import { onDestroy } from 'svelte';
+import { onDestroy, untrack } from 'svelte';
 import { M } from '../../i18n.js';
 import type { AssistantAttachmentRef } from './assistant-transport.js';
 
@@ -66,6 +68,43 @@ export interface Props {
    * own, without `dictation`.
    */
   transcribe?: DictationTranscribe | null;
+  /**
+   * `'hands-free'`: the microphone stays on and each sentence is written
+   * down when the speaker pauses, with no tap per phrase; tapping the
+   * microphone (or sending, or Escape) ends it. Needs `handsFreeCapture` and
+   * an on-device speech source (smrt-svelte's `whisper-local` / `moonshine`);
+   * otherwise it is ordinary press-to-talk. Default `'push'`.
+   */
+  dictationMode?: 'push' | 'hands-free';
+  /**
+   * The hands-free microphone, `createHandsFreeCapture` from
+   * `@happyvertical/smrt-ui/forms/hands-free`.
+   */
+  handsFreeCapture?: HandsFreeCaptureFactory | null;
+  /** Pause length and sensitivity for hands-free (see `HandsFreeVadOptions`). */
+  handsFreeVad?: HandsFreeVadOptions;
+  /**
+   * Hands-free only: send the message once the speaker has been quiet for
+   * `sendOnPauseMs` after the last sentence was written down (the same path
+   * as pressing Send). A new sentence, a key press, Escape or the microphone
+   * button cancels the pending send. Never sends an empty message. While a
+   * send is in flight, or the composer is disabled, the send waits and the
+   * text stays in the box until the composer can accept it again. Default
+   * `false`.
+   */
+  sendOnPause?: boolean;
+  /** Quiet time before `sendOnPause` sends, in ms. Default 1200. */
+  sendOnPauseMs?: number;
+  /**
+   * The assistant's reply is being played aloud (text to speech). While
+   * `true`, hands-free listening is suspended (half-duplex: the microphone
+   * stays open but nothing is heard, so the assistant is not transcribed into
+   * the box) and resumes after a short guard when it turns `false`. The
+   * microphone shows "Paused while the assistant speaks". A pending send on
+   * pause is unaffected; tapping the microphone still ends hands-free.
+   * Default `false`.
+   */
+  speaking?: boolean;
 }
 
 let {
@@ -76,6 +115,12 @@ let {
   value: content = $bindable(''),
   dictation: dictationSource = null,
   transcribe = null,
+  dictationMode = 'push',
+  handsFreeCapture = null,
+  handsFreeVad,
+  sendOnPause = false,
+  sendOnPauseMs = 1200,
+  speaking = false,
 }: Props = $props();
 const canDictate = $derived(Boolean(dictationSource || transcribe));
 let stagedAttachments = $state<AssistantAttachmentRef[]>([]);
@@ -105,6 +150,26 @@ function messageField(): HTMLTextAreaElement | null {
   return textareaEl ?? null;
 }
 
+/** Moves focus to the message field (a host that opens the composer
+ * directly, e.g. AssistantDock `conversations="single"`). A no-op while the
+ * composer is disabled. */
+export function focus(): void {
+  messageField()?.focus();
+}
+
+// Send on pause: true once a hands-free sentence has been written into the
+// box and not yet sent, `autoSendCountdown` while the grace period runs, and
+// `autoSendWaiting` when the grace period is over but a send is in flight.
+let sendDictated = $state(false);
+let autoSendCountdown = $state(false);
+let autoSendWaiting = $state(false);
+
+function cancelAutoSend() {
+  sendDictated = false;
+  autoSendCountdown = false;
+  autoSendWaiting = false;
+}
+
 // One dictation per composer; the source is read when listening starts.
 const dictation = new Dictation({
   source: () => {
@@ -112,6 +177,8 @@ const dictation = new Dictation({
     return dictationSource();
   },
   onText: (text) => {
+    // A new sentence (re)arms the send-on-pause countdown.
+    sendDictated = true;
     const field = messageField();
     if (field) insertTextAtCursor(field, text);
     else content = content ? `${content} ${text}` : text;
@@ -119,11 +186,74 @@ const dictation = new Dictation({
 });
 // The recording fallback follows the prop (a host may set it later).
 $effect.pre(() => {
-  dictation.setOptions({ transcribe });
+  dictation.setOptions({
+    transcribe,
+    mode: dictationMode,
+    handsFreeCapture,
+    vad: handsFreeVad,
+  });
 });
 
 onDestroy(() => dictation.dispose());
 
+// Half-duplex: do not listen while the assistant's reply is played aloud.
+$effect(() => {
+  const on = speaking;
+  untrack(() => (on ? dictation.suspend() : dictation.resume()));
+});
+
+// The grace period: quiet, nothing being written down, something to send.
+// Speech starting (or a sentence still queued) clears it; the next written
+// sentence starts it again.
+$effect(() => {
+  const armed =
+    sendOnPause &&
+    sendDictated &&
+    dictation.handsFree &&
+    dictation.state === 'listening' &&
+    !dictation.speaking &&
+    dictation.queued === 0 &&
+    content.trim().length > 0;
+  if (!armed) {
+    autoSendCountdown = false;
+    return;
+  }
+  autoSendCountdown = true;
+  const timer = setTimeout(
+    () => {
+      autoSendCountdown = false;
+      sendDictated = false;
+      autoSendWaiting = true;
+    },
+    Math.max(0, sendOnPauseMs),
+  );
+  return () => clearTimeout(timer);
+});
+
+// Ends of the wait: send as soon as the composer can take input, but only
+// while still hands-free (stopping the microphone cancels a pending send).
+$effect(() => {
+  if (!autoSendWaiting) return;
+  if (!sendOnPause || !dictation.handsFree || !content.trim()) {
+    autoSendWaiting = false;
+    return;
+  }
+  if (dictation.speaking || dictation.queued > 0) {
+    // More was said while waiting: back to the grace period.
+    autoSendWaiting = false;
+    sendDictated = true;
+    return;
+  }
+  if (sending || disabled || uploading) return;
+  autoSendWaiting = false;
+  void handleSend(true);
+});
+
+// Hands-free ended (microphone tapped, Escape, an error): nothing is sent.
+$effect(() => {
+  if (!dictation.handsFree) cancelAutoSend();
+});
+
 function startDictationFromHold() {
   if (disabled || uploading || dictation.active) return;
   void dictation.start();
@@ -192,25 +322,34 @@ async function handleDrop(event: DragEvent) {
   }
 }
 
-async function handleSend() {
+/** `keepListening`: a hands-free send on pause keeps the microphone on so the
+ * conversation can go on; pressing Send or Enter ends dictation. */
+async function handleSend(keepListening = false) {
+  if (disabled || sending) return;
+  cancelAutoSend();
+  // End dictation and wait for its last words before the draft is read.
+  if (dictation.active && !keepListening) {
+    await dictation.stop();
+    await dictation.whenSettled();
+  }
   const trimmed = content.trim();
   if (!trimmed || disabled || sending) return;
-  if (dictation.active) void dictation.stop();
   sendError = null;
   sending = true;
-  // #2904 review finding 4: keep the draft text/attachments until onsend
-  // settles — clearing them synchronously (the previous behavior) lost the
-  // user's message forever on a transport failure, with no visible error.
+  // The sent text leaves the box as soon as the send starts, so a manual or
+  // automatic send never leaves it sitting there for the whole reply, and
+  // anything said or typed meanwhile lands in a fresh box. A failed send puts
+  // it back (#2904 review finding 4: never lose the message on failure).
+  const sentAttachments = stagedAttachments;
+  content = '';
+  stagedAttachments = [];
+  if (textareaEl) textareaEl.style.height = 'auto';
   try {
-    await onsend(trimmed, stagedAttachments);
-    // #2991: text typed while the send was in flight is newer than what was
-    // sent; keep it.
-    if (content.trim() === trimmed) content = '';
-    stagedAttachments = [];
-    if (textareaEl) {
-      textareaEl.style.height = 'auto';
-    }
+    await onsend(trimmed, sentAttachments);
   } catch (error) {
+    const newer = content.trim();
+    content = newer ? `${trimmed}\n${newer}` : trimmed;
+    stagedAttachments = [...sentAttachments, ...stagedAttachments];
     sendError =
       error instanceof Error
         ? error.message
@@ -221,17 +360,20 @@ async function handleSend() {
 }
 
 function handleKeydown(event: KeyboardEvent) {
-  if (event.key === 'Escape' && dictation.active) {
+  if (event.key === 'Escape' && (dictation.active || sendDictated)) {
     event.preventDefault();
-    void dictation.stop();
+    cancelAutoSend();
+    if (dictation.active) void dictation.stop();
     return;
   }
+  // Typing means the person has taken over: no automatic send.
+  if (event.key.length === 1 || event.key === 'Backspace') cancelAutoSend();
   // Matches ../messages/MessageInput.svelte's handleKeydown convention:
   // plain Enter sends, Shift+Enter inserts a newline. `isComposing` guards
   // against an IME's confirmation Enter being treated as a send.
   if (event.key === 'Enter' && !event.shiftKey && !event.isComposing) {
     event.preventDefault();
-    handleSend();
+    void handleSend();
   }
 }
 
@@ -284,7 +426,7 @@ function removeAttachment(id: string) {
     </ul>
   {/if}
   {#if canDictate}
-    <DictationStatus {dictation} />
+    <DictationStatus {dictation} sending={autoSendCountdown || autoSendWaiting} />
   {/if}
   <div class="assistant-composer-row">
     {#if onupload}
@@ -349,7 +491,7 @@ function removeAttachment(id: string) {
     <Button
       type="button"
       class="assistant-composer-send"
-      onclick={handleSend}
+      onclick={() => handleSend()}
       disabled={disabled || uploading || sending || !content.trim()}
     >
       {t(M['chat.assistant_composer.send'])}
@@ -363,8 +505,10 @@ function removeAttachment(id: string) {
     background: var(--smrt-color-surface, #ffffff);
     padding: var(--smrt-spacing-2, 8px);
     flex-shrink: 0;
+    container-type: inline-size;
   }
 
+
   .assistant-composer-row {
     display: flex;
     align-items: flex-end;
@@ -419,13 +563,7 @@ function removeAttachment(id: string) {
   /* Phones: 16px text so iOS Safari doesn't zoom the page when the
      message field gets focus. */
   @media (max-width: 48rem) {
-    .assistant-composer-field {
-    flex: 1;
-    display: flex;
-    min-inline-size: 0;
-  }
-
-  :global(.assistant-composer-textarea) {
+    :global(.assistant-composer-textarea) {
       font-size: max(1rem, 16px);
     }
   }
@@ -491,4 +629,22 @@ function removeAttachment(id: string) {
     color: var(--smrt-color-on-error-container, #410002);
     font: var(--smrt-typography-body-small-font, 0.8125rem/1.4 sans-serif);
   }
+
+  /* A narrow dock (a sidebar a couple of hundred pixels wide): the message
+     field takes the whole row and the attach, dictate and send controls sit
+     under it, so the placeholder never wraps a syllable per line. */
+  @container (max-width: 22rem) {
+    .assistant-composer-row {
+      flex-wrap: wrap;
+    }
+
+    .assistant-composer-field {
+      flex: 1 1 100%;
+      order: -1;
+    }
+
+    :global(.assistant-composer-send) {
+      margin-inline-start: auto;
+    }
+  }
 </style>

package/dist/svelte/components/assistant/AssistantComposer.svelte.d.ts

@@ -8,7 +8,7 @@
  * flow, which is sized for a dedicated upload panel, not a one-line composer
  * (#2904 review fix).
  */
-import { type DictationSourceProvider, type DictationTranscribe } from '@happyvertical/smrt-ui/forms';
+import { type DictationSourceProvider, type DictationTranscribe, type HandsFreeCaptureFactory, type HandsFreeVadOptions } from '@happyvertical/smrt-ui/forms';
 import type { AssistantAttachmentRef } from './assistant-transport.js';
 export interface Props {
     /** Called with the trimmed message text and any staged attachments when
@@ -45,8 +45,47 @@ export interface Props {
      * own, without `dictation`.
      */
     transcribe?: DictationTranscribe | null;
+    /**
+     * `'hands-free'`: the microphone stays on and each sentence is written
+     * down when the speaker pauses, with no tap per phrase; tapping the
+     * microphone (or sending, or Escape) ends it. Needs `handsFreeCapture` and
+     * an on-device speech source (smrt-svelte's `whisper-local` / `moonshine`);
+     * otherwise it is ordinary press-to-talk. Default `'push'`.
+     */
+    dictationMode?: 'push' | 'hands-free';
+    /**
+     * The hands-free microphone, `createHandsFreeCapture` from
+     * `@happyvertical/smrt-ui/forms/hands-free`.
+     */
+    handsFreeCapture?: HandsFreeCaptureFactory | null;
+    /** Pause length and sensitivity for hands-free (see `HandsFreeVadOptions`). */
+    handsFreeVad?: HandsFreeVadOptions;
+    /**
+     * Hands-free only: send the message once the speaker has been quiet for
+     * `sendOnPauseMs` after the last sentence was written down (the same path
+     * as pressing Send). A new sentence, a key press, Escape or the microphone
+     * button cancels the pending send. Never sends an empty message. While a
+     * send is in flight, or the composer is disabled, the send waits and the
+     * text stays in the box until the composer can accept it again. Default
+     * `false`.
+     */
+    sendOnPause?: boolean;
+    /** Quiet time before `sendOnPause` sends, in ms. Default 1200. */
+    sendOnPauseMs?: number;
+    /**
+     * The assistant's reply is being played aloud (text to speech). While
+     * `true`, hands-free listening is suspended (half-duplex: the microphone
+     * stays open but nothing is heard, so the assistant is not transcribed into
+     * the box) and resumes after a short guard when it turns `false`. The
+     * microphone shows "Paused while the assistant speaks". A pending send on
+     * pause is unaffected; tapping the microphone still ends hands-free.
+     * Default `false`.
+     */
+    speaking?: boolean;
 }
-declare const AssistantComposer: import("svelte").Component<Props, {}, "value">;
+declare const AssistantComposer: import("svelte").Component<Props, {
+    focus: () => void;
+}, "value">;
 type AssistantComposer = ReturnType<typeof AssistantComposer>;
 export default AssistantComposer;
 //# sourceMappingURL=AssistantComposer.svelte.d.ts.map

package/dist/svelte/components/assistant/AssistantComposer.svelte.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AssistantComposer.svelte.d.ts","sourceRoot":"","sources":["../../../../src/svelte/components/assistant/AssistantComposer.svelte.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,OAAO,EAGL,KAAK,uBAAuB,EAE5B,KAAK,mBAAmB,EAKzB,MAAM,8BAA8B,CAAC;AAKtC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGvE,MAAM,WAAW,KAAK;IACpB;;;;4DAIwD;IACxD,MAAM,EAAE,CACN,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,sBAAsB,EAAE,KAClC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B;sEACkE;IAClE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAClE,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;0CAEsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC3C;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACzC;AA4PD,QAAA,MAAM,iBAAiB,gDAAwC,CAAC;AAChE,KAAK,iBAAiB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC9D,eAAe,iBAAiB,CAAC"}
+{"version":3,"file":"AssistantComposer.svelte.d.ts","sourceRoot":"","sources":["../../../../src/svelte/components/assistant/AssistantComposer.svelte.ts"],"names":[],"mappings":"AAGA;;;;;;;;;GASG;AACH,OAAO,EAGL,KAAK,uBAAuB,EAE5B,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,EAC5B,KAAK,mBAAmB,EAKzB,MAAM,8BAA8B,CAAC;AAKtC,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAGvE,MAAM,WAAW,KAAK;IACpB;;;;4DAIwD;IACxD,MAAM,EAAE,CACN,OAAO,EAAE,MAAM,EACf,WAAW,EAAE,sBAAsB,EAAE,KAClC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1B;sEACkE;IAClE,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC;IAClE,yDAAyD;IACzD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;0CAEsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf;;;;;;;OAOG;IACH,SAAS,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC3C;;;;;;OAMG;IACH,UAAU,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACxC;;;;;;OAMG;IACH,aAAa,CAAC,EAAE,MAAM,GAAG,YAAY,CAAC;IACtC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAClD,+EAA+E;IAC/E,YAAY,CAAC,EAAE,mBAAmB,CAAC;IACnC;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,kEAAkE;IAClE,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;;;;;OAQG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAmWD,QAAA,MAAM,iBAAiB;iBAxSJ,IAAI;WAwSwC,CAAC;AAChE,KAAK,iBAAiB,GAAG,UAAU,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAC9D,eAAe,iBAAiB,CAAC"}