@happyvertical/smrt-chat 0.55.0 → 0.55.2

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-CFUoIO5f.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-Bpx5qi-h.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.0",
+  "packageVersion": "0.55.2",
   "objects": {
     "@happyvertical/smrt-chat:AgentSessionCollection": {
       "name": "agentsessioncollection",
@@ -1998,7 +1998,12 @@
           "default": "active",
           "_meta": {
             "required": true
-          }
+          },
+          "enum": [
+            "active",
+            "closed",
+            "expired"
+          ]
         },
         "allowedTools": {
           "type": "text",
@@ -2455,7 +2460,15 @@
           "default": "text",
           "_meta": {
             "required": true
-          }
+          },
+          "enum": [
+            "text",
+            "system",
+            "action",
+            "file",
+            "tool_call",
+            "tool_result"
+          ]
         },
         "role": {
           "type": "text",
@@ -2463,7 +2476,13 @@
           "default": "user",
           "_meta": {
             "required": true
-          }
+          },
+          "enum": [
+            "user",
+            "assistant",
+            "system",
+            "tool"
+          ]
         },
         "isEdited": {
           "type": "boolean",
@@ -2944,7 +2963,13 @@
           "default": "member",
           "_meta": {
             "required": true
-          }
+          },
+          "enum": [
+            "owner",
+            "admin",
+            "member",
+            "viewer"
+          ]
         },
         "status": {
           "type": "text",
@@ -2952,7 +2977,13 @@
           "default": "active",
           "_meta": {
             "required": true
-          }
+          },
+          "enum": [
+            "active",
+            "left",
+            "kicked",
+            "banned"
+          ]
         },
         "onlineStatus": {
           "type": "text",
@@ -2960,7 +2991,13 @@
           "default": "offline",
           "_meta": {
             "required": true
-          }
+          },
+          "enum": [
+            "online",
+            "away",
+            "dnd",
+            "offline"
+          ]
         },
         "lastReadMessageId": {
           "type": "foreignKey",
@@ -3486,7 +3523,13 @@
           "default": "public",
           "_meta": {
             "required": true
-          }
+          },
+          "enum": [
+            "public",
+            "private",
+            "dm",
+            "agent"
+          ]
         },
         "status": {
           "type": "text",
@@ -3494,7 +3537,12 @@
           "default": "active",
           "_meta": {
             "required": true
-          }
+          },
+          "enum": [
+            "active",
+            "archived",
+            "deleted"
+          ]
         },
         "topic": {
           "type": "text",
@@ -3646,6 +3694,7 @@
       "extends": "SmrtObject",
       "exportName": "ChatRoom",
       "collectionExportName": "ChatRoomCollection",
+      "displayLabelField": "name",
       "validationRules": [
         {
           "field": "roomType",
@@ -3900,6 +3949,7 @@
       "extends": "SmrtObject",
       "exportName": "ChatThread",
       "collectionExportName": "ChatThreadCollection",
+      "displayLabelField": "title",
       "validationRules": [
         {
           "field": "roomId",
@@ -4093,7 +4143,12 @@
           "default": "processing",
           "_meta": {
             "required": true
-          }
+          },
+          "enum": [
+            "processing",
+            "completed",
+            "failed"
+          ]
         },
         "completedAt": {
           "type": "datetime",
@@ -4383,7 +4438,12 @@
           "default": "active",
           "_meta": {
             "required": true
-          }
+          },
+          "enum": [
+            "active",
+            "expired",
+            "revoked"
+          ]
         },
         "expiresAt": {
           "type": "datetime",

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.0",
+  "packageVersion": "0.55.2",
   "sourceManifestPath": "dist/manifest.json",
   "agentDocPath": "AGENTS.md",
   "sourceHashes": {
-    "manifest": "2a58dba6ee34e272a2b651f98af98146ee4074dc9cdeb059fd2856c79f9ce2a5",
-    "packageJson": "401b5bd68ede628ad4c3049319e252530838637915710e0bbcc37238770ef9ad",
+    "manifest": "c75e87eccad2e9d1ee2d10133b30188cd05d29f4eef5c1f590b1363ab7590f6f",
+    "packageJson": "91ae029d4ea508b0cf0c447263a3ea18b70c396546e1bd0eb0c7f312da0d4155",
     "agents": "0d11ad3c134fc4de4c3fd61fb3a5e7d760ecf8ef6b2b16679b66358e6877dd74",
     "moduleDoc:agents/dev-workbench.md": "69b6f827d25c8aeb0e7516c90303af23948803213b5d34bc334c1e3376c83a16",
     "agentSurface:src/routes/chat-dev.intents.ts": "ff8f7c19c7eb6e841a08f03c97773c53092ed208004666bfed372bd1ad456b35"
@@ -2590,6 +2590,7 @@
     {
       "name": "ChatRoom",
       "qualifiedName": "@happyvertical/smrt-chat:ChatRoom",
+      "displayLabelField": "name",
       "collection": "chatrooms",
       "tableName": "chat_rooms",
       "packageName": "@happyvertical/smrt-chat",
@@ -2943,6 +2944,7 @@
     {
       "name": "ChatThread",
       "qualifiedName": "@happyvertical/smrt-chat:ChatThread",
+      "displayLabelField": "title",
       "collection": "chatthreads",
       "tableName": "chat_threads",
       "packageName": "@happyvertical/smrt-chat",

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

@@ -40,7 +40,7 @@ export interface Props {
   ) => void | Promise<void>;
   /** Called with the picked/dropped files; resolves to the uploaded
    * attachment refs to stage as removable chips above the input. */
-  onupload: (files: FileList) => Promise<AssistantAttachmentRef[]>;
+  onupload?: (files: FileList) => Promise<AssistantAttachmentRef[]>;
   /** Disables the composer (e.g. no active thread yet). */
   disabled?: boolean;
   /** Placeholder text for the empty textarea. */
@@ -91,7 +91,7 @@ let sendError = $state<string | null>(null);
 // unrelated and can occur independently (e.g. staging fails while a
 // previous message is still sending).
 let uploadError = $state<string | null>(null);
-let fileInputEl: HTMLInputElement | undefined;
+let fileInputEl: HTMLInputElement | undefined = $state();
 // Captured from the textarea's input event so auto-resize works without
 // binding to the Textarea primitive's inner DOM node.
 let textareaEl: HTMLTextAreaElement | undefined;
@@ -148,8 +148,14 @@ async function handleFileChange(event: Event) {
   if (!files || files.length === 0) return;
   uploading = true;
   uploadError = null;
+  const upload = onupload;
+  if (!upload) {
+    uploading = false;
+    input.value = '';
+    return;
+  }
   try {
-    const uploaded = await onupload(files);
+    const uploaded = await upload(files);
     stagedAttachments = [...stagedAttachments, ...uploaded];
   } catch (error) {
     // Already-staged chips are left untouched — only this batch failed.
@@ -164,6 +170,8 @@ async function handleFileChange(event: Event) {
 }
 
 async function handleDrop(event: DragEvent) {
+  const upload = onupload;
+  if (!upload) return;
   event.preventDefault();
   if (disabled || uploading) return;
   const files = event.dataTransfer?.files;
@@ -171,7 +179,7 @@ async function handleDrop(event: DragEvent) {
   uploading = true;
   uploadError = null;
   try {
-    const uploaded = await onupload(files);
+    const uploaded = await upload(files);
     stagedAttachments = [...stagedAttachments, ...uploaded];
   } catch (error) {
     // Already-staged chips are left untouched — only this batch failed.
@@ -239,7 +247,11 @@ function removeAttachment(id: string) {
 </script>
 
 <!-- svelte-ignore a11y_no_static_element_interactions -->
-<div class="assistant-composer" ondrop={handleDrop} ondragover={(e) => e.preventDefault()}>
+<div
+  class="assistant-composer"
+  ondrop={onupload ? handleDrop : undefined}
+  ondragover={onupload ? (event) => event.preventDefault() : undefined}
+>
   {#if sendError}
     <p class="assistant-composer-error" role="alert">
       {t(M['chat.assistant_composer.send_error'], { message: sendError })}
@@ -275,8 +287,9 @@ function removeAttachment(id: string) {
     <DictationStatus {dictation} />
   {/if}
   <div class="assistant-composer-row">
-    <!-- raw-primitive-allow: compact icon-only attach control backed by a hidden native file input; opens the OS picker, matching MessageInput's icon-button send control pattern -->
-    <Button
+    {#if onupload}
+      <!-- raw-primitive-allow: compact icon-only attach control backed by a hidden native file input; opens the OS picker, matching MessageInput's icon-button send control pattern -->
+      <Button
       type="button"
       variant="secondary"
       size="sm"
@@ -296,9 +309,9 @@ function removeAttachment(id: string) {
           stroke-linejoin="round"
         />
       </svg>
-    </Button>
-    <!-- raw-primitive-allow: visually-hidden native file input that backs the attach button's OS picker; the base Input primitive renders a visible bordered control and cannot be this hidden picker (same pattern as ../shared/FileUpload.svelte). Cycle-3 second final F2: the visually-hidden clip-rect styling keeps this element IN the accessibility tree, so unlike FileUpload's own wrapping label element with visible text, this needs an explicit aria-label to avoid an unnamed file control. -->
-    <input
+      </Button>
+      <!-- raw-primitive-allow: visually-hidden native file input that backs the attach button's OS picker; the base Input primitive renders a visible bordered control and cannot be this hidden picker (same pattern as ../shared/FileUpload.svelte). Cycle-3 second final F2: the visually-hidden clip-rect styling keeps this element IN the accessibility tree, so unlike FileUpload's own wrapping label element with visible text, this needs an explicit aria-label to avoid an unnamed file control. -->
+      <input
       bind:this={fileInputEl}
       type="file"
       class="assistant-composer-file-input"
@@ -307,7 +320,8 @@ function removeAttachment(id: string) {
       disabled={disabled || uploading}
       tabindex="-1"
       aria-label={t(M['chat.assistant_composer.attach_files'])}
-    />
+      />
+    {/if}
     <div
       class="assistant-composer-field"
       use:longPress={{

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

@@ -19,7 +19,7 @@ export interface Props {
     onsend: (content: string, attachments: AssistantAttachmentRef[]) => void | Promise<void>;
     /** Called with the picked/dropped files; resolves to the uploaded
      * attachment refs to stage as removable chips above the input. */
-    onupload: (files: FileList) => Promise<AssistantAttachmentRef[]>;
+    onupload?: (files: FileList) => Promise<AssistantAttachmentRef[]>;
     /** Disables the composer (e.g. no active thread yet). */
     disabled?: boolean;
     /** Placeholder text for the empty textarea. */

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,EAAE,CAAC,KAAK,EAAE,QAAQ,KAAK,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAAC;IACjE,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;AAkPD,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,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"}

package/dist/svelte/components/assistant/AssistantDock.svelte

@@ -84,6 +84,10 @@ export interface Props {
    * currently-mounted surfaces from this and fails closed when none are
    * registered. */
   registry: DataSurfaceRegistry;
+  /** Where the assistant obtains its working context. `data-surfaces` keeps
+   * the route-surface guidance; `server` is for transports whose authenticated
+   * backend supplies context and tools without browser data surfaces. */
+  contextMode?: 'data-surfaces' | 'server';
   /** Client-side seam to a server-hosted `DataSurfaceActionAdapter`; required
    * to preview/apply proposed actions, optional for plain chat. */
   actionClient?: AssistantActionClient;
@@ -169,6 +173,7 @@ export interface Props {
 const {
   transport,
   registry,
+  contextMode = 'data-surfaces',
   actionClient,
   surfaces,
   visible = true,
@@ -275,9 +280,14 @@ $effect(() => {
 // swap; everything inside stays `untrack`-ed so it does NOT also rerun on
 // unrelated $state changes elsewhere (preserving the F1 guarantee that the
 // mount effect above runs exactly once per mount).
+let uploadContextEpoch = $state(0);
+
 $effect(() => {
   void registry;
-  untrack(() => controller.syncRegistry());
+  untrack(() => {
+    uploadContextEpoch++;
+    controller.syncRegistry();
+  });
 });
 
 // Cycle-2 second final finding 1: a SEPARATE effect, scoped to only the
@@ -305,7 +315,10 @@ $effect(() => {
 // once per mount).
 $effect(() => {
   void transport;
-  untrack(() => controller.syncTransport());
+  untrack(() => {
+    uploadContextEpoch++;
+    controller.syncTransport();
+  });
 });
 
 // #3000: in a narrow container (below the `@container` breakpoint in the
@@ -339,6 +352,12 @@ function closeThreads() {
   });
 }
 
+async function openThreads() {
+  threadsOpen = true;
+  await tick();
+  threadsEl?.querySelector<HTMLElement>('.assistant-thread-list-item')?.focus();
+}
+
 async function handleSelectThread(threadId: string) {
   closeThreads();
   // openThread() catches internally and records any failure on
@@ -388,15 +407,28 @@ async function handleUpload(
   // returning [] here would make a failed upload look like a successful
   // empty batch. This handler ALSO records the failure on controller.error
   // so the dock-level banner matches the send path.
+  const uploadTransport = transport;
+  const uploadEpoch = uploadContextEpoch;
+  const isCurrentUpload = () =>
+    transport === uploadTransport && uploadContextEpoch === uploadEpoch;
   try {
+    const upload = uploadTransport.uploadAttachment;
+    if (!upload) {
+      throw new Error('AssistantDock: attachment upload is not supported');
+    }
     const uploaded: AssistantAttachmentRef[] = [];
     for (const file of Array.from(files)) {
-      uploaded.push(await transport.uploadAttachment(file));
+      uploaded.push(await upload.call(uploadTransport, file));
+      if (!isCurrentUpload()) return [];
     }
     controller.setError(null);
     return uploaded;
   } catch (error) {
-    controller.setError(error instanceof Error ? error.message : String(error));
+    if (isCurrentUpload()) {
+      controller.setError(
+        error instanceof Error ? error.message : String(error),
+      );
+    }
     throw error;
   }
 }
@@ -437,7 +469,7 @@ async function handleConfirmAction(requestId: string) {
         threads={controller.threads}
         activeThreadId={controller.activeThreadId}
         onselect={handleSelectThread}
-        oncreate={handleCreateThread}
+        oncreate={transport.createThread ? handleCreateThread : undefined}
       />
     </div>
 
@@ -459,13 +491,62 @@ async function handleConfirmAction(requestId: string) {
         </div>
       {/if}
 
-      {#if controller.surfaces.length === 0 && !pageTools}
+      {#if contextMode === 'data-surfaces' && controller.surfaces.length === 0 && !pageTools}
         <p class="assistant-dock-empty">
           {t(M['chat.assistant_dock.no_surfaces'])}
         </p>
       {/if}
 
       <div class="assistant-dock-scroll">
+        {#if !controller.activeThreadId && controller.threadsLoading}
+          <div
+            class="assistant-dock-thread-state assistant-dock-thread-loading"
+            role="status"
+            aria-label={t(M['chat.assistant_dock.loading_conversations'])}
+          >
+            <p>{t(M['chat.assistant_dock.loading_conversations'])}</p>
+          </div>
+        {:else if !controller.activeThreadId && !controller.error}
+          <section
+            class="assistant-dock-thread-state"
+            aria-labelledby={`${threadsId}-empty-title`}
+          >
+            {#if controller.threads.length > 0}
+              <h2 id={`${threadsId}-empty-title`}>
+                {t(M['chat.assistant_dock.choose_conversation'])}
+              </h2>
+              <p>{t(M['chat.assistant_dock.choose_conversation_hint'])}</p>
+              <div class="assistant-dock-thread-state-actions">
+                <Button
+                  type="button"
+                  aria-controls={threadsId}
+                  onclick={openThreads}
+                >
+                  {t(M['chat.assistant_dock.view_conversations'])}
+                </Button>
+                {#if transport.createThread}
+                  <Button type="button" variant="ghost" onclick={handleCreateThread}>
+                    {t(M['chat.assistant_dock.start_new_conversation'])}
+                  </Button>
+                {/if}
+              </div>
+            {:else if transport.createThread}
+              <h2 id={`${threadsId}-empty-title`}>
+                {t(M['chat.assistant_dock.start_conversation'])}
+              </h2>
+              <p>{t(M['chat.assistant_dock.start_conversation_hint'])}</p>
+              <Button type="button" onclick={handleCreateThread}>
+                {t(M['chat.assistant_dock.start_new_conversation'])}
+              </Button>
+            {:else}
+              <h2 id={`${threadsId}-empty-title`}>
+                {t(M['chat.assistant_dock.no_conversations'])}
+              </h2>
+              <p>{t(M['chat.assistant_dock.no_conversations_hint'])}</p>
+            {/if}
+          </section>
+        {/if}
+
         <ul class="assistant-dock-messages">
           {#each controller.messages as message (message.id)}
             <li>
@@ -658,17 +739,19 @@ async function handleConfirmAction(requestId: string) {
             />
           </div>
         {/if}
-        <AssistantComposer
-          bind:value={
-            () => controller.draft, (text) => controller.setDraft(text)
-          }
-          onsend={handleSend}
-          onupload={handleUpload}
-          disabled={!controller.activeThreadId}
-          placeholder={composerPlaceholder}
-          {dictation}
-          {transcribe}
-        />
+        {#key uploadContextEpoch}
+          <AssistantComposer
+            bind:value={
+              () => controller.draft, (text) => controller.setDraft(text)
+            }
+            onsend={handleSend}
+            onupload={transport.uploadAttachment ? handleUpload : undefined}
+            disabled={!controller.activeThreadId}
+            placeholder={composerPlaceholder}
+            {dictation}
+            {transcribe}
+          />
+        {/key}
       </div>
     </div>
   </div>
@@ -846,6 +929,45 @@ async function handleConfirmAction(requestId: string) {
     gap: var(--smrt-spacing-2, 8px);
   }
 
+  .assistant-dock-thread-state {
+    flex: 1;
+    min-height: 10rem;
+    display: flex;
+    flex-direction: column;
+    align-items: center;
+    justify-content: center;
+    gap: var(--smrt-spacing-2, 8px);
+    padding: var(--smrt-spacing-5, 20px);
+    color: var(--smrt-color-on-surface-variant, #43474e);
+    text-align: center;
+  }
+
+  .assistant-dock-thread-state h2,
+  .assistant-dock-thread-state p {
+    margin: 0;
+  }
+
+  .assistant-dock-thread-state h2 {
+    color: var(--smrt-color-on-surface, #1a1c1e);
+    font: var(--smrt-typography-title-medium-font, 600 1rem/1.4 sans-serif);
+  }
+
+  .assistant-dock-thread-state p {
+    max-width: 28rem;
+    font: var(--smrt-typography-body-medium-font, 0.875rem/1.5 sans-serif);
+  }
+
+  .assistant-dock-thread-state-actions {
+    display: flex;
+    flex-wrap: wrap;
+    justify-content: center;
+    gap: var(--smrt-spacing-2, 8px);
+  }
+
+  .assistant-dock-thread-loading {
+    min-height: 4rem;
+  }
+
   .assistant-dock-tool-call {
     margin-top: var(--smrt-spacing-2, 8px);
     min-width: 0;

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

@@ -13,6 +13,10 @@ export interface Props {
      * currently-mounted surfaces from this and fails closed when none are
      * registered. */
     registry: DataSurfaceRegistry;
+    /** Where the assistant obtains its working context. `data-surfaces` keeps
+     * the route-surface guidance; `server` is for transports whose authenticated
+     * backend supplies context and tools without browser data surfaces. */
+    contextMode?: 'data-surfaces' | 'server';
     /** Client-side seam to a server-hosted `DataSurfaceActionAdapter`; required
      * to preview/apply proposed actions, optional for plain chat. */
     actionClient?: AssistantActionClient;

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

@@ -1 +1 @@
-{"version":3,"file":"AssistantDock.svelte.d.ts","sourceRoot":"","sources":["../../../../src/svelte/components/assistant/AssistantDock.svelte.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,mBAAmB,EACpB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EACV,uBAAuB,EACvB,mBAAmB,EACpB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,KAAK,OAAO,EAAiB,MAAM,QAAQ,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AAQzE,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AACnF,OAAO,KAAK,EAEV,gBAAgB,EAChB,kBAAkB,EACnB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAE/B,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,uBAAuB,EAC5B,KAAK,YAAY,EAElB,MAAM,8CAA8C,CAAC;AAGtD,MAAM,WAAW,KAAK;IACpB,kEAAkE;IAClE,SAAS,EAAE,kBAAkB,CAAC;IAC9B;;qBAEiB;IACjB,QAAQ,EAAE,mBAAmB,CAAC;IAC9B;qEACiE;IACjE,YAAY,CAAC,EAAE,qBAAqB,CAAC;IACrC;;;;;;;;gEAQ4D;IAC5D,QAAQ,CAAC,EAAE,mBAAmB,EAAE,CAAC;IACjC,yEAAyE;IACzE,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;0EAIsE;IACtE,QAAQ,CAAC,EAAE,OAAO,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;IACvC;;;yEAGqE;IACrE,YAAY,CAAC,EAAE,CAAC,UAAU,EAAE,uBAAuB,KAAK,IAAI,CAAC;IAC7D;2DACuD;IACvD,eAAe,CAAC,EAAE,CAChB,OAAO,EAAE,wBAAwB,EACjC,MAAM,EAAE,uBAAuB,KAC5B,IAAI,CAAC;IACV;;2DAEuD;IACvD,eAAe,CAAC,EAAE,CAChB,OAAO,EAAE,wBAAwB,EACjC,OAAO,EAAE,sBAAsB,KAC5B,IAAI,CAAC;IACV;;;0DAGsD;IACtD,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;qCACiC;IACjC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;2EAGuE;IACvE,SAAS,CAAC,EAAE,yBAAyB,CAAC;IACtC;wCACoC;IACpC,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,yBAAyB,CAAC;IAC5E;0EACsE;IACtE,QAAQ,CAAC,EAAE,CAAC,MAAM,EAAE,eAAe,KAAK,IAAI,CAAC;IAC7C;wEACoE;IACpE,MAAM,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACpC;0EACsE;IACtE,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,CAAC;IAC1D,sEAAsE;IACtE,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;uCACmC;IACnC,KAAK,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,KAAK,IAAI,CAAC;IAC3C;;yCAEqC;IACrC,aAAa,CAAC,EAAE,6BAA6B,CAAC;IAC9C;+EAC2E;IAC3E,SAAS,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAAC;IAC3C;;kCAE8B;IAC9B,UAAU,CAAC,EAAE,mBAAmB,GAAG,IAAI,CAAC;CACzC;AAkeD,QAAA,MAAM,aAAa,2CAAwC,CAAC;AAC5D,KAAK,aAAa,GAAG,UAAU,CAAC,OAAO,aAAa,CAAC,CAAC;AACtD,eAAe,aAAa,CAAC"}
+{"version":3,"file":"AssistantDock.svelte.d.ts","sourceRoot":"","sources":["../../../../src/svelte/components/assistant/AssistantDock.svelte.ts"],"names":[],"mappings":"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"}

package/dist/svelte/components/assistant/assistant-transport.d.ts

@@ -127,10 +127,13 @@ export interface AssistantSendMessageResult {
 }
 export interface AssistantTransport {
     listThreads(): Promise<AssistantThreadSummary[]>;
-    createThread(title: string): Promise<AssistantThreadSummary>;
+    /** Creates another conversation when the backend supports multiple threads.
+     * Omit this method for a fixed, single-session assistant. */
+    createThread?(title: string): Promise<AssistantThreadSummary>;
     loadMessages(threadId: string): Promise<AssistantMessage[]>;
     sendMessage(input: AssistantSendMessageInput): Promise<AssistantSendMessageResult>;
-    uploadAttachment(file: File): Promise<AssistantAttachmentRef>;
+    /** Uploads a file for staging in the composer. Omit when unsupported. */
+    uploadAttachment?(file: File): Promise<AssistantAttachmentRef>;
     /** When present, `AssistantDock` renders `ModelPicker` in the composer
      * header and threads the selected id through `sendMessage`'s `model`. A
      * transport that has no model choice (e.g. a single fixed backend model)
@@ -140,6 +143,8 @@ export interface AssistantTransport {
      * transport that ever returns `clientToolCalls`. */
     resumeTurn?(input: AssistantResumeTurnInput): Promise<AssistantSendMessageResult>;
 }
+/** A transport that exposes every optional conversation capability. */
+export type FullAssistantTransport = AssistantTransport & Required<Pick<AssistantTransport, 'createThread' | 'uploadAttachment'>>;
 export interface InMemoryAssistantTransportOptions {
     /** Simulates a still-processing turn: the Nth send for a given thread
      * returns `inProgress: true` before resolving on a later `loadMessages`. */
@@ -164,7 +169,7 @@ export interface InMemoryAssistantTransportOptions {
      * choice. */
     models?: ModelOption[];
 }
-export declare function createInMemoryAssistantTransport(options?: InMemoryAssistantTransportOptions): AssistantTransport;
+export declare function createInMemoryAssistantTransport(options?: InMemoryAssistantTransportOptions): FullAssistantTransport;
 /**
  * Wire contract for `createSmrtAssistantTransport`'s reads (Copilot PR #2919
  * jAwqo/jAwrQ/jAwvV). `readEndpoint` must be a host-supplied, MEMBER-scoped
@@ -248,15 +253,15 @@ export interface SmrtAssistantTransportOptions {
      * building block a host's endpoint implementation should call. */
     readEndpoint: string;
     token: string;
-    /** Required for sendMessage/createThread, which have no generated REST route
+    /** Required for sendMessage, which has no generated REST route
      * (ChatThread/ChatMessage only expose `list`/`get` — see file header). Host
-     * apps must supply a `ChatService`-backed endpoint here; omitting it leaves
-     * `createThread`/`sendMessage` throwing a descriptive error rather than
-     * silently no-opping. */
+     * apps must supply a `ChatService`-backed endpoint here. Thread creation and
+     * attachment upload are optional capabilities; omitting either callback
+     * omits its corresponding dock control. */
     writeEndpoint?: {
-        createThread: (title: string) => Promise<AssistantThreadSummary>;
+        createThread?: (title: string) => Promise<AssistantThreadSummary>;
         sendMessage: (input: AssistantSendMessageInput) => Promise<AssistantSendMessageResult>;
-        uploadAttachment: (file: File) => Promise<AssistantAttachmentRef>;
+        uploadAttachment?: (file: File) => Promise<AssistantAttachmentRef>;
         /** Resumes a turn suspended on browser tools (#2908); see
          * `AssistantTransport.resumeTurn`. */
         resumeTurn?: (input: AssistantResumeTurnInput) => Promise<AssistantSendMessageResult>;
@@ -271,7 +276,7 @@ export interface SmrtAssistantTransportOptions {
  * Reads go through a host-supplied, MEMBER-scoped `readEndpoint` (never the
  * generated `ChatThread`/`ChatMessage` list routes directly — see this
  * section's header comment above `SmrtAssistantTransportOptions`). Writes
- * (`createThread`, `sendMessage`, `uploadAttachment`) require an explicit
+ * (`createThread`, `sendMessage`, `uploadAttachment`) use an explicit
  * `writeEndpoint` supplied by the host application, since neither model
  * exposes a generated `create` route (`api: { include: ['list', 'get'] }`,
  * `../../../models/ChatThread.ts:16`, `../../../models/ChatMessage.ts:26`).