@ai-matrx/chat 0.4.22 → 0.4.26

package/CHANGELOG.md

@@ -1,5 +1,48 @@
 # @ai-matrx/chat
 
+## 0.4.26
+
+- `RichCopySplit` renders the content action set (`ContentActions` from rich-content 0.2.52): Copy, Plain (with the new `viewKey` prop), Export, Print and Transform (the host's Alchemy palette) each one click. New `exportTitle` prop names exported files.
+- A chat answer honors its bar's Plain switch: the exact source in place of the render (the render stays mounted).
+
+Consumer action: pass `viewKey` and wrap the host's content in `ContentView` to get Plain.
+
+## 0.4.25 — nine more host slots draw the real component in any host
+
+- `ReadFailure`, `UntrustedCount`, `OptionCombobox`, `AspectRatioSelect`, `FloatingSheet`,
+  `ConfigurationTable`, `ConfigurationTableRow`, `FieldHelp` and `TextInputDialog` default to
+  `@ai-matrx/design-system` 0.82.0's components (moved there whole from matrx-frontend); a slot whose
+  default is the package component no longer reports itself as unregistered.
+- `./ui/aspect-ratio-options` re-exports design-system's ratio helpers (one copy).
+- Guard: `slots-draw-their-package-default.test.tsx` (the list only grows).
+
+Consumer action: none — a host's registration still wins; matrx-frontend may drop its registrations of
+these nine slots (they are the same components).
+
+Also in 0.4.25 — `createMemoryNavigation` (from `@ai-matrx/chat/host`): a navigation port that keeps the
+chat's address in memory for hosts whose own address must not move (an extension side panel; Matrx
+Local, whose router already owns `/chat`). Options `initial`, `home`, `persist(address)`,
+`openExternal(href)`; back/forward, link clicks, one search-params object per address. Guard:
+`memory-navigation-keeps-the-page-still.test.tsx` (red 2/5 on a planted break → green 5/5). Consumer
+action: none; matrx-extend may drop its own `memory-navigation.tsx`.
+
+Also in 0.4.25 — a host names the mandate that answers its new-chat screen: `app.defaultChatMandateKey`
+(Matrx Local `local.cloud_chat`, Matrx Extend `extend.browser_chat`); absent = `chat.default_new_chat`.
+`ChatNewClient`, `ChatConversationRoom`, `ChatNewHeader` read it through one hook
+(`useDefaultChatMandateKey`). Guard: `a-host-names-its-default-chat-mandate.test.tsx` (red 1/3 on a
+planted break → green 3/3). Consumer action: none.
+
+## 0.4.24
+
+Republish of 0.4.23 (its publish failed in finish-build on a member call read as an import; fixed in 4008c0cbbc). No consumer action required.
+
+## 0.4.23
+
+- An answer open in the in-place editor stays open when its conversation is re-read (`hydrateMessages` carries `_editingInPlace`); in the floating chat window the editor closed ~1.5s after a double-click. Guard: `hydrate-keeps-an-open-in-place-editor.test.ts`.
+- A Chat link naming its agent and conversation (`agent:<id>:m-run_a-<agent>_c-<conversation>`) opens them: the window adopts a seed that arrives after it mounted, never over the person's own choice (`adoptLateWindowSeed`). Guard: `a-chat-link-opens-its-conversation.test.ts`.
+
+No consumer action required.
+
 ## 0.4.22
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/agent-copy/RichCopySplit.d.ts

@@ -2,9 +2,19 @@ import * as React from "react";
 import type { MatrxCopyMenuProps } from "@ai-matrx/alchemy/react/workspace";
 export type RichCopySplitProps = MatrxCopyMenuProps & {
     human: NonNullable<MatrxCopyMenuProps["human"]>;
+    /**
+     * The item's Plain / Formatted key: the host renders its content through
+     * <ContentView viewKey={…} text={…}> (@ai-matrx/rich-content/copy/ContentActions).
+     * Guard: matrx-frontend content-actions.census — every display host passes it.
+     */
+    viewKey?: string;
+    /** File name / print title for Export and Print. */
+    exportTitle?: string;
 };
 /**
- * THE split Copy of a markdown host (Arman, 2026-10-04: "one click to get either the markdown
+ * THE content action set of a markdown host (ContentActions, Arman 2026-10-08: copy, Plain,
+ * Export, Print and Transform each one click away; Transform opens the Alchemy palette below).
+ * Formerly the split Copy of a markdown host (Arman, 2026-10-04: "one click to get either the markdown
  * version or the no-markup version"). One click copies the person's flavor (`copy.default_flavor`);
  * the chevron offers exactly Copy markdown and Copy plain text (2026-10-07). The Alchemy palette
  * (formatted, JSON, download, AI, the host's record copies) is "Export…" — ONE row under a divider

package/dist/agent-copy/RichCopySplit.js

@@ -1,7 +1,7 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
 import * as React from "react";
-import { CopySplitButton } from "@ai-matrx/rich-content/copy/CopySplitButton";
+import { ContentActions } from "@ai-matrx/rich-content/copy/ContentActions";
 import { copyRichContent } from "@ai-matrx/rich-content/copy/copy-commands";
 import { ExportPaletteAnchor, openExportPalette, useExportPaletteKey } from "@ai-matrx/rich-content/copy/ExportPalette";
 import { cn } from "@ai-matrx/design-system";
@@ -17,12 +17,18 @@ function RichCopySplit(props) {
   const exportKey = useExportPaletteKey();
   return /* @__PURE__ */ jsxs("span", { className: cn("inline-flex shrink-0 items-center", className), children: [
     /* @__PURE__ */ jsx(
-      CopySplitButton,
+      ContentActions,
       {
+        content: () => {
+          const value = typeof human === "function" ? human() : human;
+          return typeof value === "string" ? value : String(value ?? "");
+        },
         copy,
         size: splitSize,
         label: `Copy ${props.label ?? ""}`.trim(),
-        onExport: () => void openExportPalette(exportKey)
+        title: props.exportTitle ?? props.label,
+        viewKey: props.viewKey,
+        onTransform: () => void openExportPalette(exportKey)
       }
     ),
     /* @__PURE__ */ jsx(ExportPaletteAnchor, { exportKey, controllerRef: palette }),

package/dist/agents/components/chat/ChatConversationRoom.js

@@ -2,7 +2,7 @@
 import { jsx } from "react/jsx-runtime";
 import { ChatRoomClient } from "./ChatRoomClient.js";
 import { ChatMandateUnavailable, ChatNewLandingSkeleton } from "./ChatNewClient.js";
-import { DEFAULT_NEW_CHAT_MANDATE_KEY } from "./chat-quick-actions.config.js";
+import { useDefaultChatMandateKey } from "./default-chat-mandate.js";
 import { useMandate } from "../../../mandates/useMandate.js";
 import { WorkspaceGate } from "../../../host/ui-slots.js";
 function ChatConversationRoom({
@@ -13,6 +13,7 @@ function ChatConversationRoom({
   composer,
   organizationId = null
 }) {
+  const defaultMandateKey = useDefaultChatMandateKey();
   if (agentId && !ownedByMandate) {
     return /* @__PURE__ */ jsx(
       ChatRoomClient,
@@ -30,7 +31,7 @@ function ChatConversationRoom({
       {
         agentId,
         conversationId,
-        mandateKey: DEFAULT_NEW_CHAT_MANDATE_KEY,
+        mandateKey: defaultMandateKey,
         sandboxBinding,
         composer
       }
@@ -52,8 +53,9 @@ function ChatConversationRoomResolved({
   sandboxBinding,
   composer
 }) {
+  const defaultMandateKey = useDefaultChatMandateKey();
   const { mandate, loading, error, organizationPending } = useMandate(
-    DEFAULT_NEW_CHAT_MANDATE_KEY,
+    defaultMandateKey,
     organizationId ? { organizationId } : {}
   );
   if (loading) return /* @__PURE__ */ jsx(ChatNewLandingSkeleton, {});
@@ -66,7 +68,7 @@ function ChatConversationRoomResolved({
     {
       agentId: mandate.agentId,
       conversationId,
-      mandateKey: DEFAULT_NEW_CHAT_MANDATE_KEY,
+      mandateKey: defaultMandateKey,
       sandboxBinding,
       composer
     }

package/dist/agents/components/chat/ChatNewClient.js

@@ -11,7 +11,7 @@ import {
   ComposerGreeting,
   ComposerQuickActionsSkeleton
 } from "../inputs/smart-input/composer/ComposerSplash.js";
-import { DEFAULT_NEW_CHAT_MANDATE_KEY } from "./chat-quick-actions.config.js";
+import { useDefaultChatMandateKey } from "./default-chat-mandate.js";
 import { useMandate } from "../../../mandates/useMandate.js";
 import { ErrorAlchemyMenu } from "../../../host/ui-slots.js";
 import { asClause } from "@ai-matrx/kit/text";
@@ -21,7 +21,8 @@ function ChatNewClient({
   pinned = false,
   composer
 }) {
-  const { mandate } = useMandate(DEFAULT_NEW_CHAT_MANDATE_KEY, { optional: true });
+  const defaultMandateKey = useDefaultChatMandateKey();
+  const { mandate } = useMandate(defaultMandateKey, { optional: true });
   if (pinned && agentId) {
     return /* @__PURE__ */ jsx(ChatNewBody, { agentId, composer, pinned: true });
   }
@@ -31,7 +32,8 @@ function ChatNewClient({
 function ChatNewClientResolved({
   composer
 }) {
-  const { mandate, loading, error, organizationPending } = useMandate(DEFAULT_NEW_CHAT_MANDATE_KEY);
+  const defaultMandateKey = useDefaultChatMandateKey();
+  const { mandate, loading, error, organizationPending } = useMandate(defaultMandateKey);
   if (loading) return /* @__PURE__ */ jsx(ChatNewLandingSkeleton, {});
   if (organizationPending) {
     return /* @__PURE__ */ jsx(WorkspaceGate, { blocked: true, sentence: "Chat needs a workspace to open.", children: /* @__PURE__ */ jsx(ChatNewLandingSkeleton, {}) });
@@ -71,12 +73,13 @@ function ChatNewBody({
   composer,
   pinned = false
 }) {
+  const defaultMandateKey = useDefaultChatMandateKey();
   const surfaceKey = chatRouteSurfaceKey(agentId);
   return /* @__PURE__ */ jsx(
     ChatRoomClient,
     {
       agentId,
-      mandateKey: pinned ? void 0 : DEFAULT_NEW_CHAT_MANDATE_KEY,
+      mandateKey: pinned ? void 0 : defaultMandateKey,
       composer,
       landingContent: (conversationId, composerPresentation) => composerPresentation ? /* @__PURE__ */ jsx(
         NewChatGreeting,

package/dist/agents/components/chat/ChatNewHeader.js

@@ -1,7 +1,7 @@
 "use client";
 import { jsx } from "react/jsx-runtime";
 import { ChatRunHeader } from "./ChatRunHeader.js";
-import { DEFAULT_NEW_CHAT_MANDATE_KEY } from "./chat-quick-actions.config.js";
+import { useDefaultChatMandateKey } from "./default-chat-mandate.js";
 import { useMandate } from "../../../mandates/useMandate.js";
 function ChatNewHeader({
   agentId,
@@ -20,7 +20,8 @@ function ChatNewHeader({
 function ChatNewHeaderResolved({
   composerMode
 }) {
-  const { mandate } = useMandate(DEFAULT_NEW_CHAT_MANDATE_KEY);
+  const defaultMandateKey = useDefaultChatMandateKey();
+  const { mandate } = useMandate(defaultMandateKey);
   return /* @__PURE__ */ jsx(ChatRunHeader, { activeAgentId: mandate?.agentId, composerMode });
 }
 export {

package/dist/agents/components/chat/default-chat-mandate.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The mandate that answers the new-chat screen and agentless conversations in THIS host: the host's
+ * `app.defaultChatMandateKey` (Matrx Local names `local.cloud_chat`), else the web's
+ * `chat.default_new_chat`. One reader, so every screen that resolves the default agrees.
+ */
+import type { AnyMandateKey } from "@ai-matrx/agents/mandates";
+export declare function useDefaultChatMandateKey(): AnyMandateKey;

package/dist/agents/components/chat/default-chat-mandate.js

@@ -0,0 +1,9 @@
+"use client";
+import { useMaybeChatHost } from "../../../host/react.js";
+import { DEFAULT_NEW_CHAT_MANDATE_KEY } from "./chat-quick-actions.config.js";
+function useDefaultChatMandateKey() {
+  return useMaybeChatHost()?.app.defaultChatMandateKey ?? DEFAULT_NEW_CHAT_MANDATE_KEY;
+}
+export {
+  useDefaultChatMandateKey
+};

package/dist/agents/components/context-items/bodies/UnregisteredBody.d.ts

@@ -1,7 +1,10 @@
-/** The generic default for a context-item body the host did not register: the generic body, labelled. */
+/**
+ * The default for a context-item body the host did not register: the generic body, which shows the
+ * item itself (the missing editor is reported once by the slot; never a "not set up here" line).
+ */
 import type { ContextItemBodyProps } from "../types.js";
-export declare function UnregisteredBody({ name, what, props }: {
+export declare function UnregisteredBody({ name, props }: {
     name: string;
-    what: string;
+    what?: string;
     props: ContextItemBodyProps;
 }): import("react").JSX.Element;

package/dist/agents/components/context-items/bodies/UnregisteredBody.js

@@ -1,14 +1,8 @@
 "use client";
-import { jsx, jsxs } from "react/jsx-runtime";
+import { jsx } from "react/jsx-runtime";
 import { GenericBody } from "./GenericBody.js";
-function UnregisteredBody({ name, what, props }) {
-  return /* @__PURE__ */ jsxs("div", { className: "flex h-full min-h-0 flex-col", "data-chat-slot-fallback": name, children: [
-    /* @__PURE__ */ jsxs("div", { className: "px-4 pt-3 text-[11px] text-muted-foreground", children: [
-      what,
-      " is not set up here"
-    ] }),
-    /* @__PURE__ */ jsx("div", { className: "min-h-0 flex-1", children: /* @__PURE__ */ jsx(GenericBody, { ...props }) })
-  ] });
+function UnregisteredBody({ name, props }) {
+  return /* @__PURE__ */ jsx("div", { className: "flex h-full min-h-0 flex-col", "data-chat-slot-fallback": name, children: /* @__PURE__ */ jsx("div", { className: "min-h-0 flex-1", children: /* @__PURE__ */ jsx(GenericBody, { ...props }) }) });
 }
 export {
   UnregisteredBody

package/dist/agents/components/inputs/resources/attach-resource.js

@@ -54,6 +54,7 @@ function resourceLabel(resource) {
     case "table":
       return resource.data.table_name ?? "Table";
     case "webpage":
+      if (typeof resource.data === "string") return resource.data.replace(/^https?:\/\/(www\.)?/i, "").replace(/\/$/, "");
       return resource.data.title ?? resource.data.url ?? "Webpage";
     case "youtube":
       return resource.data.title ?? "YouTube";

package/dist/agents/components/inputs/smart-input/SmartAgentInput.js

@@ -8,6 +8,8 @@ import { InboxQueueStrip } from "./InboxQueueStrip.js";
 import { selectViewerCanReply } from "../../../redux/execution-system/conversations/conversations.selectors.js";
 import { ViewOnlyComposerBar } from "./ViewOnlyComposerBar.js";
 import { selectHasUserInput } from "../../../redux/execution-system/instance-user-input/instance-user-input.selectors.js";
+import { useConversationHeld } from "../../../../host/conversation-hooks-react.js";
+import { Hourglass } from "lucide-react";
 function SmartAgentInput({
   conversationId,
   uploadRoot = "userContent",
@@ -41,7 +43,8 @@ function SmartAgentInput({
   const ambientHasNothingToSend = useAppSelector(
     (state) => isLauncher && conversationId ? !selectHasUserInput(conversationId)(state) : false
   );
-  const sendDisabled = disableSend || ambientHasNothingToSend;
+  const heldSentence = useConversationHeld(conversationId);
+  const sendDisabled = disableSend || ambientHasNothingToSend || heldSentence !== null;
   const viewerCanReply = useAppSelector(
     (state) => conversationId ? selectViewerCanReply(conversationId)(state) : true
   );
@@ -52,6 +55,18 @@ function SmartAgentInput({
   }
   return /* @__PURE__ */ jsxs(Fragment, { children: [
     queueStrip,
+    heldSentence ? /* @__PURE__ */ jsxs(
+      "div",
+      {
+        role: "status",
+        "data-testid": "composer-held",
+        className: "mx-auto mb-1.5 flex w-full items-center gap-2 px-1 text-xs text-muted-foreground",
+        children: [
+          /* @__PURE__ */ jsx(Hourglass, { className: "h-3.5 w-3.5 shrink-0", "aria-hidden": true }),
+          /* @__PURE__ */ jsx("span", { className: "truncate", title: heldSentence, children: heldSentence })
+        ]
+      }
+    ) : null,
     /* @__PURE__ */ jsx(
       SmartAgentInputStacked,
       {

package/dist/agents/components/inputs/smart-input/composer/ComposerMenu.js

@@ -12,6 +12,7 @@ import { Check, ChevronRight } from "lucide-react";
 import { Popover, PopoverAnchor, PopoverContent } from "@ai-matrx/design-system";
 import { Switch } from "../../../../../ui/switch.js";
 import { cn } from "@ai-matrx/design-system";
+import { SlotBoundary } from "../../../../../host/ui-slots.js";
 const ComposerMenuPresentationContext = createContext("popover");
 const ComposerSheetNavContext = createContext(null);
 const SHEET_ROW = "sheet-row flex w-full min-w-0 shrink-0 items-center gap-3 bg-card px-3 text-left text-base text-foreground transition-colors active:bg-accent first:rounded-t-xl last:rounded-b-xl [.sheet-gap+&]:rounded-t-xl [&:has(+.sheet-gap)]:rounded-b-xl [.sheet-row+&]:border-t [.sheet-row+&]:border-border/60";
@@ -272,7 +273,7 @@ function ComposerSubmenu({
           // A panel with no fixed height on desktop is content-sized on the
           // phone too — one sizing decision, both presentations.
           fit: panelClassName && !/(^|\s)h-\[/.test(panelClassName) ? "content" : "fill",
-          render: () => typeof children === "function" ? children(sheetNav.pop) : children
+          render: () => /* @__PURE__ */ jsx(SlotBoundary, { name: `menu:${typeof row.label === "string" ? row.label : "panel"}`, children: typeof children === "function" ? children(sheetNav.pop) : children })
         })
       }
     );
@@ -321,7 +322,7 @@ function ComposerSubmenu({
           panelClassName ?? "w-72",
           "max-sm:!w-[calc(100vw-1rem)]"
         ),
-        children: /* @__PURE__ */ jsx(ComposerMenuLevel, { children: drillInPlace ? /* @__PURE__ */ jsx(InPlaceNav, { children: typeof children === "function" ? children(close) : children }) : typeof children === "function" ? children(close) : children })
+        children: /* @__PURE__ */ jsx(ComposerMenuLevel, { children: drillInPlace ? /* @__PURE__ */ jsx(InPlaceNav, { children: /* @__PURE__ */ jsx(SlotBoundary, { name: `menu:${typeof row.label === "string" ? row.label : "panel"}`, children: typeof children === "function" ? children(close) : children }) }) : /* @__PURE__ */ jsx(SlotBoundary, { name: `menu:${typeof row.label === "string" ? row.label : "panel"}`, children: typeof children === "function" ? children(close) : children }) })
       }
     )
   ] });

package/dist/agents/components/inputs/smart-input/composer/ComposerPlusMenu.js

@@ -62,7 +62,8 @@ import { setUserInputText } from "../../../../redux/execution-system/instance-us
 import { prependTemplateToDraft } from "../prepend-template-to-draft.js";
 import { SmartInputMessageTemplatePicker } from "../../../../../host/ui-slots.js";
 import { useOpenContextPreviewPanel } from "../../../../../host/window-openers.js";
-import { useOpenRunControlsWindow } from "../../../../../host/window-openers.js";
+import { useHasChatWindowOpener, useOpenRunControlsWindow } from "../../../../../host/window-openers.js";
+import { isHostSlotRegistered } from "../../../../../host/ui-slots.js";
 import { useOpenCloudBrowserCanvas } from "../../../../../host/ui-slots.js";
 import { ActiveContextTree } from "../../../../../context/sources/scopes.js";
 import { useComputeTargetActions } from "../use-compute-target-actions.js";
@@ -123,6 +124,9 @@ function ComposerPlusMenu({
   const agentId = useAppSelector(selectAgentIdFromInstance(conversationId));
   const openContextPreview = useOpenContextPreviewPanel();
   const openRunControlsWindow = useOpenRunControlsWindow();
+  const runControlsWindowHosted = useHasChatWindowOpener("openRunControlsWindow");
+  const runControlsInline = presentation === "sheet" || !runControlsWindowHosted;
+  const hostPicker = isHostSlotRegistered("ResourcePickerMenu");
   const openCloudBrowser = useOpenCloudBrowserCanvas();
   const sandboxBlocked = useSandboxBindingBlocked(conversationId);
   const workingDocEnabled = useAppSelector(selectWorkingDocEnabled(conversationId));
@@ -168,40 +172,42 @@ function ComposerPlusMenu({
       /* @__PURE__ */ jsx(ComposerSubmenu, { row: { icon: FolderOpen, label: "Add files or photos" }, panelClassName: PICKER_PANEL, children: (closeCascade) => picker("files", closeCascade) })
     ),
     /* @__PURE__ */ jsx(ComposerSubmenu, { row: { icon: Link2, label: "Add a link" }, panelClassName: LINK_PANEL, children: (closeCascade) => picker("webpage", closeCascade) }),
-    /* @__PURE__ */ jsx(
-      ComposerSubmenu,
-      {
-        row: { icon: Boxes, label: "From your workspace" },
-        panelClassName: CONTENT_PANEL,
-        drillInPlace: true,
-        children: /* @__PURE__ */ jsxs("div", { className: "flex flex-col p-1.5", children: [
-          /* @__PURE__ */ jsx(ComposerMenuLabel, { children: "Attach from AI Matrx" }),
-          workspaceRows().map((row) => /* @__PURE__ */ jsx(ComposerSubmenu, { row: { icon: row.icon, label: row.label }, children: (back) => picker(row.view, back) }, row.view))
-        ] })
-      }
-    ),
-    /* @__PURE__ */ jsx(
-      ComposerSubmenu,
-      {
-        row: { icon: contextValuesItem().icon, label: contextValuesItem().label },
-        panelClassName: PICKER_PANEL,
-        children: (closeCascade) => picker("context_values", closeCascade)
-      }
-    ),
-    /* @__PURE__ */ jsx(
-      ComposerMenuRow,
-      {
-        icon: Search,
-        label: "Search your knowledge",
-        detail: touchOnly ? void 0 : "\u2318K",
-        onClick: () => {
-          close();
-          openAttachSearch();
+    hostPicker ? /* @__PURE__ */ jsxs(Fragment, { children: [
+      /* @__PURE__ */ jsx(
+        ComposerSubmenu,
+        {
+          row: { icon: Boxes, label: "From your workspace" },
+          panelClassName: CONTENT_PANEL,
+          drillInPlace: true,
+          children: /* @__PURE__ */ jsxs("div", { className: "flex flex-col p-1.5", children: [
+            /* @__PURE__ */ jsx(ComposerMenuLabel, { children: "Attach from AI Matrx" }),
+            workspaceRows().map((row) => /* @__PURE__ */ jsx(ComposerSubmenu, { row: { icon: row.icon, label: row.label }, children: (back) => picker(row.view, back) }, row.view))
+          ] })
         }
-      }
-    ),
+      ),
+      /* @__PURE__ */ jsx(
+        ComposerSubmenu,
+        {
+          row: { icon: contextValuesItem().icon, label: contextValuesItem().label },
+          panelClassName: PICKER_PANEL,
+          children: (closeCascade) => picker("context_values", closeCascade)
+        }
+      ),
+      /* @__PURE__ */ jsx(
+        ComposerMenuRow,
+        {
+          icon: Search,
+          label: "Search your knowledge",
+          detail: touchOnly ? void 0 : "\u2318K",
+          onClick: () => {
+            close();
+            openAttachSearch();
+          }
+        }
+      )
+    ] }) : null,
     shows("plus.skills") || shows("plus.tools") || shows("plus.connectors") || shows("plus.environment") ? /* @__PURE__ */ jsx(ComposerMenuDivider, {}) : null,
-    shows("plus.skills") ? presentation === "sheet" ? /* @__PURE__ */ jsx(ComposerSubmenu, { row: { icon: Lightbulb, label: "Skills", badge: counts.skills }, children: /* @__PURE__ */ jsx(RunSkillPicker, { conversationId }) }) : /* @__PURE__ */ jsx(
+    shows("plus.skills") ? runControlsInline ? /* @__PURE__ */ jsx(ComposerSubmenu, { row: { icon: Lightbulb, label: "Skills", badge: counts.skills }, children: /* @__PURE__ */ jsx(RunSkillPicker, { conversationId }) }) : /* @__PURE__ */ jsx(
       ComposerMenuRow,
       {
         icon: Lightbulb,
@@ -213,7 +219,7 @@ function ComposerPlusMenu({
         }
       }
     ) : null,
-    shows("plus.tools") ? presentation === "sheet" ? (
+    shows("plus.tools") ? runControlsInline ? (
       // Phone: a full-height page — THE Tools surface, one pane at a time.
       /* @__PURE__ */ jsx(ComposerSubmenu, { row: { icon: Wrench, label: "Tools", badge: counts.tools }, children: /* @__PURE__ */ jsx(RunToolPicker, { conversationId }) })
     ) : (
@@ -234,7 +240,7 @@ function ComposerPlusMenu({
     ) : null,
     shows("plus.connectors") ? /* @__PURE__ */ jsxs(ComposerSubmenu, { row: { icon: Plug, label: "Connections" }, panelClassName: "w-[360px] h-[min(70dvh,480px)]", children: [
       /* @__PURE__ */ jsx(ComposerConnectorsPanel, { conversationId, onNavigate: close }),
-      /* @__PURE__ */ jsx(ComposerSubmenu, { row: { icon: Globe, label: "Google Workspace files" }, panelClassName: PICKER_PANEL, children: (closeCascade) => picker("google", closeCascade) })
+      hostPicker ? /* @__PURE__ */ jsx(ComposerSubmenu, { row: { icon: Globe, label: "Google Workspace files" }, panelClassName: PICKER_PANEL, children: (closeCascade) => picker("google", closeCascade) }) : null
     ] }) : null,
     shows("plus.environment") ? /* @__PURE__ */ jsx(ComposerSubmenu, { row: { icon: Server, label: "Environment" }, panelClassName: "w-80", children: /* @__PURE__ */ jsx(
       ComposerEnvironmentPanel,

package/dist/agents/components/messages-display/assistant/AgentAssistantMessage.js

@@ -74,6 +74,9 @@ import {
 import { retryConversationTurn } from "../../../redux/execution-system/message-crud/retry-turn.thunk.js";
 import { commitInlineContentEdit } from "../../../redux/execution-system/message-crud/commit-inline-edit.thunk.js";
 import { InPlaceAnswerEditor } from "./InPlaceAnswerEditor.js";
+import { PlainTextView } from "@ai-matrx/rich-content/copy/ContentActions";
+import { usePlainView } from "@ai-matrx/rich-content/copy/content-view-store";
+import { richDocumentViewKey } from "@ai-matrx/rich-content/rich-document/runtime/useActionSurfaceProvider";
 import { updateMessageRecord } from "../../../redux/execution-system/messages/messages.slice.js";
 import { handInPlaceCaret } from "@ai-matrx/rich-editor/in-place/caret-handoff";
 import { toast } from "../../../../host/notify.js";
@@ -197,6 +200,9 @@ function AgentAssistantMessage({
     () => extractFlatText(record, { withCitationMarkers: hasCitations, keepInlineThinking: true }),
     [record, hasCitations]
   );
+  const plainView = usePlainView(
+    messageId ? richDocumentViewKey({ type: "chat-message", conversationId, messageId }, "") : null
+  );
   const attachmentParts = extractContentBlocks(record).filter(
     (b) => isAttachmentMessagePart(b) && !isInlineAssistantMedia(b)
   );
@@ -427,26 +433,29 @@ function AgentAssistantMessage({
           ) : (
             // THE READING SET on a saved chat answer (highlight, comment, suggest, link +
             // the Notes & comments dock) — the same mount every note and saved document uses.
-            /* @__PURE__ */ jsx(RecordAnnotations, { record: annotationRecord, children: /* @__PURE__ */ jsx("div", { "data-message-content": true, ...answerReadProps, children: /* @__PURE__ */ jsx(
-              MarkdownStream,
-              {
-                imagePolicy: "ai",
-                requestId: effectiveRequestId,
-                recordMessageIds,
-                streamSlotStart: streamSlotStart ?? record?._streamSlotStart,
-                streamSlotEnd: streamSlotEnd ?? record?._streamSlotEnd,
-                turnId: messageId,
-                conversationId,
-                messageId: messageId ?? void 0,
-                content: renderedText,
-                isStreamActive: isStreamActive && !failed,
-                hideCopyButton: true,
-                allowFullScreenEditor: false,
-                serverProcessedBlocks,
-                onContentChange: handleInlineContentChange,
-                applyLocalEdits: false
-              }
-            ) }) })
+            /* @__PURE__ */ jsx(RecordAnnotations, { record: annotationRecord, children: /* @__PURE__ */ jsxs("div", { "data-message-content": true, ...answerReadProps, children: [
+              plainView ? /* @__PURE__ */ jsx(PlainTextView, { text: renderedText ?? "" }) : null,
+              /* @__PURE__ */ jsx("div", { className: plainView ? "hidden" : "contents", children: /* @__PURE__ */ jsx(
+                MarkdownStream,
+                {
+                  imagePolicy: "ai",
+                  requestId: effectiveRequestId,
+                  recordMessageIds,
+                  streamSlotStart: streamSlotStart ?? record?._streamSlotStart,
+                  streamSlotEnd: streamSlotEnd ?? record?._streamSlotEnd,
+                  turnId: messageId,
+                  conversationId,
+                  messageId: messageId ?? void 0,
+                  content: renderedText,
+                  isStreamActive: isStreamActive && !failed,
+                  hideCopyButton: true,
+                  allowFullScreenEditor: false,
+                  serverProcessedBlocks,
+                  onContentChange: handleInlineContentChange,
+                  applyLocalEdits: false
+                }
+              ) })
+            ] }) })
           ),
           !isClosedStreamSegment && displaySources.length > 0 && /* @__PURE__ */ jsx(MessageSourcesRow, { sources: displaySources, className: "mt-2" }),
           !isStreamActive && /* @__PURE__ */ jsx(PrefillNote, { metadata: record?.metadata }),

package/dist/agents/components/messages-display/user/AgentUserMessage.js

@@ -41,6 +41,7 @@ import { isAttachmentMessagePart } from "../../context-items/normalize.js";
 import MarkdownStream from "../../../../ui/markdown-stream/MarkdownStream.js";
 import "../rich-document/chat-message-source.js";
 import { literalUserText } from "./literal-user-text.js";
+import { getConversationHooks } from "../../../../host/conversation-hooks.js";
 import { buildVariableDisplayLines } from "../../../utils/variable-display-lines.js";
 import {
   recordTranscriptEvent,
@@ -57,7 +58,8 @@ function AgentUserMessageContent({
   bodyBlocks,
   variables
 }) {
-  const trimmedText = text.trim();
+  const shown = getConversationHooks(conversationId)?.displayUserText?.(text) ?? text;
+  const trimmedText = shown.trim();
   const hasBodyBlocks = !!bodyBlocks && bodyBlocks.length > 0;
   if (!trimmedText && !hasBodyBlocks && attachmentParts.length === 0 && (!variables || buildVariableDisplayLines(variables).length === 0)) {
     return null;

package/dist/agents/components/shared/AgentConversationColumn.d.ts

@@ -120,6 +120,15 @@ interface AgentConversationColumnBaseProps {
      * web chat exactly. See ./transcript-layout.tsx.
      */
     layout?: TranscriptLayout;
+    /** A quiet note UNDER the composer (host chrome). Absent ⇒ nothing is drawn. */
+    belowInput?: React.ReactNode;
+    /**
+     * Words to put in an EMPTY composer, once per distinct value (a hand-off
+     * from elsewhere on the page). Never overwrites text the person typed.
+     */
+    draftSeed?: string | null;
+    /** The column's accessible name (a host's keyboard scope may key on it). */
+    label?: string;
 }
-export declare function AgentConversationColumn({ conversationId, displayConversationId, surfaceKey, constrainWidth, edgeToEdgeScroll, smartInputProps, landingContent, hideInput, hideCreatorPanel, afterMessages, aboveInput, deferColdMarkdown, audience, layout, }: AgentConversationColumnProps): import("react").JSX.Element;
+export declare function AgentConversationColumn({ conversationId, displayConversationId, surfaceKey, constrainWidth, edgeToEdgeScroll, smartInputProps, landingContent, hideInput, hideCreatorPanel, afterMessages, aboveInput, deferColdMarkdown, audience, layout, belowInput, draftSeed, label, }: AgentConversationColumnProps): import("react").JSX.Element;
 export {};

package/dist/agents/components/shared/AgentConversationColumn.js

@@ -19,6 +19,7 @@ import { PendingAsksZone } from "../../ui-first-tools/ui/PendingAsksZone.js";
 import { ServerOperationBanner } from "../../runtime-reconnect/ServerOperationBanner.js";
 import { ProposedDirectivesZone } from "../../../host/ui-slots.js";
 import { useAppDispatch, useAppSelector } from "../../../store/hooks.js";
+import { setUserInputText } from "../../redux/execution-system/instance-user-input/instance-user-input.slice.js";
 import { selectMessageCount } from "../../redux/execution-system/messages/messages.selectors.js";
 import {
   revealOlderGroups,
@@ -63,12 +64,16 @@ function AgentConversationColumn({
   aboveInput,
   deferColdMarkdown = false,
   audience = "builder",
-  layout
+  layout,
+  belowInput,
+  draftSeed,
+  label
 }) {
   const resolvedLayout = resolveTranscriptLayout(layout);
   const columnClass = transcriptColumnClass(resolvedLayout);
   const dispatch = useAppDispatch();
   const displayId = displayConversationId ?? conversationId;
+  useDraftSeed(conversationId, draftSeed ?? null);
   const scrollRef = useRef(null);
   const contentRef = useRef(null);
   const didAutoRevealRef = useRef(false);
@@ -213,6 +218,8 @@ function AgentConversationColumn({
   return /* @__PURE__ */ jsx(ConversationAbilitiesProvider, { conversationId: displayId, children: /* @__PURE__ */ jsx(TranscriptAudienceProvider, { audience, children: /* @__PURE__ */ jsx(TranscriptLayoutProvider, { layout: resolvedLayout, children: /* @__PURE__ */ jsxs(
     "div",
     {
+      "data-chat-column": "",
+      ...label ? { "aria-label": label, role: "region" } : {},
       className: cn(
         "h-full flex flex-col overflow-hidden",
         // Legacy: pad the whole column. Edge mode: padding lives on the
@@ -349,7 +356,8 @@ function AgentConversationColumn({
                   surfaceKey,
                   ...smartInputProps
                 }
-              )
+              ),
+              belowInput ? /* @__PURE__ */ jsx("div", { className: "px-1 pb-1 text-xs text-muted-foreground", "data-chat-below-input": "", children: belowInput }) : null
             ]
           }
         )
@@ -357,6 +365,22 @@ function AgentConversationColumn({
     }
   ) }) }) });
 }
+function useDraftSeed(conversationId, seed) {
+  const dispatch = useAppDispatch();
+  const current = useAppSelector(
+    (state) => state.instanceUserInput?.byConversationId[conversationId]?.text ?? null
+  );
+  const exists = useAppSelector(
+    (state) => state.instanceUserInput?.byConversationId[conversationId] !== void 0
+  );
+  const appliedRef = useRef(null);
+  useEffect(() => {
+    if (!seed || !exists || appliedRef.current === seed) return;
+    appliedRef.current = seed;
+    if (current && current.trim()) return;
+    dispatch(setUserInputText({ conversationId, text: seed }));
+  }, [seed, exists, current, conversationId, dispatch]);
+}
 export {
   AgentConversationColumn
 };