@noodleseed/assistant 1.10.0 → 1.11.0

package/README.md

@@ -247,6 +247,26 @@ interaction streams a continuation. `principalKey` is browser-local and never se
 whenever the authenticated user or tenant changes so the hook aborts and clears the previous session and
 transcript.
 
+If the product deliberately sends a first turn on mount, make the effect cleanup-aware. React Strict Mode
+discards the provisional effect, so a persistent "already sent" ref can suppress the stable remount:
+
+```tsx
+import { useEffect } from "react";
+
+useEffect(() => {
+  let active = true;
+  queueMicrotask(() => {
+    if (active) settle(client.sendMessage(initialMessage));
+  });
+  return () => {
+    active = false;
+  };
+}, [client, initialMessage]);
+```
+
+`settle` must await or catch the command promise as in the complete example; the same structured failure
+also appears in the hook's `error` state.
+
 When the customer-owned transcript should render the linked MCP App itself, pass the typed `data-view`
 payload and the same client to the supported host component:
 
@@ -320,6 +340,24 @@ Use the lower-level `subscribe(...)` event stream only for transport and session
 do not belong in the transcript. The package uses the headless `ai` runtime only; React remains an optional
 peer isolated to the `/react` and `/react/client` entries.
 
+For a custom progress surface, raw `tool_started` carries the direct invocation's call `id` and technical
+`tool` name before execution. Map known tools through a finite application-owned label table and use a
+neutral fallback such as "Working"; never turn an internal identifier into customer copy mechanically.
+Keep one reserved region with `role="status"` and `aria-live="polite"` from submitted/thinking through tool
+activity and the linked-view skeleton. `view_available` makes that view ready; a raw `error` event or chat
+`error` state replaces the skeleton with `role="alert"`. Keep the skeleton's dimensions stable, mark its
+decorative shapes `aria-hidden="true"`, and disable shimmer/transition animation under
+`@media (prefers-reduced-motion: reduce)`.
+
+The transport identity of a view is exactly `view.id + view.resourceUri`; different call IDs are distinct
+invocations and must not be collapsed automatically. If the product intentionally owns one current panel
+for a known resource, define an explicit application-owned slot map and replace only that slot:
+
+```ts
+const viewSlots = new Map([["ui://workspace/current", "current-workspace"]]);
+const renderKey = viewSlots.get(view.resourceUri) ?? `${view.id}:${view.resourceUri}`;
+```
+
 `clientContext` contains untrusted locale/timezone presentation hints and is evaluated for every turn.
 The client resolves a turn or interaction only after exactly one valid terminal `done` event followed by
 stream EOF. A truncated or malformed stream, duplicate `done`, or any frame after `done` is

package/dist/{chunk-RYQBXTLR.js → chunk-KRB2SXFD.js}

@@ -8360,6 +8360,11 @@ function toAssistantClientEvent(event) {
         return event;
       }
       break;
+    case "tool_started":
+      if (hasString(value, "id") && hasString(value, "tool") && hasOptionalTurnId(value)) {
+        return event;
+      }
+      break;
     case "tool_proposed":
       if (hasString(value, "id") && hasString(value, "tool") && hasOptionalString(value.title) && hasOptionalString(value.description) && hasOptionalJson(value.arguments) && (value.reviewSchema === void 0 || isRecord2(value.reviewSchema)) && hasOptionalString(value.expiresAt) && (value.requiresConfirmation === void 0 || value.requiresConfirmation === true) && hasOptionalTurnId(value)) {
         return event;
@@ -9086,4 +9091,4 @@ export {
   AssistantClientError,
   createAssistantClient
 };
-//# sourceMappingURL=chunk-RYQBXTLR.js.map
+//# sourceMappingURL=chunk-KRB2SXFD.js.map