@ai-matrx/chat 0.2.0 → 0.2.2

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @ai-matrx/chat
 
+## 0.2.2
+### Last re-sync before matrx-frontend consumes the published package (P27)
+
+- Carries the frontend's latest `packages/chat` changes: the composer's run-controls row folds when
+  it overflows (`useComposerFold`, `ComposerMetaRow`), message timestamp and assistant footer/turn
+  group updates, input action buttons and stacked input.
+- The module tree's suites run here under Jest (`pnpm test:modules`); the host-tie ratchet moved
+  in from matrx-frontend (`pnpm check:host-boundary`, budget 0).
+- Consumer action: none.
+
+## 0.2.1
+### Re-sync with matrx-frontend's packages/chat (P27)
+
+- Carries every frontend-side change made to `packages/chat` after the 0.2.0 copy: a pasted image
+  attaches once (react-dropzone owns paste; the hand-rolled paste handler is gone; the host's
+  no-paste setting reaches the drop target), the Chat/Work/Advanced switch is the design system's
+  `SegmentedControl`, the send tooltip uses `isMacLike` and the Connect chip the one GitHub glyph,
+  surfaces import `@ai-matrx/alchemy/operate` (ALC-16/17: platform write targets, Save to
+  document/workbook through the one door, `receipt.result` carries what the page's handler made).
+- Fixes the copy's stale host suites (they import `testing/fake-db`, as the frontend moved them).
+- Consumer action: none.
+
 ## 0.2.0
 ### The full chat system moves in (P27, PACKAGE-INDEPENDENCE)
 

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

@@ -1,5 +1,5 @@
 import { type ReactNode } from "react";
-import { type SurfaceHandle } from "@ai-matrx/kit/content-transfer";
+import { type SurfaceHandle } from "@ai-matrx/alchemy/operate";
 import type { SurfaceScopePayload } from "../surfaces/types.js";
 /**
  * Creates a handle for this exact React mount. Hook-only runtime registrations

package/dist/agent-copy/AlchemySurfaceBridge.js

@@ -3,7 +3,7 @@ import { jsx } from "react/jsx-runtime";
 import { useEffect, useId, useRef } from "react";
 import {
   createSurfaceTransferHandle
-} from "@ai-matrx/kit/content-transfer";
+} from "@ai-matrx/alchemy/operate";
 import { ContentTransferSurfaceProvider } from "@ai-matrx/design-system/content-transfer";
 import { getSurfaceManifest } from "../host/ui-slots.js";
 function useAlchemySurfaceHandle(surfaceName, getScope) {

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

@@ -1,2 +1,2 @@
 /** Compatibility import path; agent envelope serialization is package-owned. */
-export { buildAgentPayload, fenceJsonBlock, type AgentPayloadInput, } from "@ai-matrx/kit/content-transfer";
+export { buildAgentPayload, fenceJsonBlock, type AgentPayloadInput, } from "@ai-matrx/alchemy/operate";

package/dist/agent-copy/buildAgentPayload.js

@@ -1,7 +1,7 @@
 import {
   buildAgentPayload,
   fenceJsonBlock
-} from "@ai-matrx/kit/content-transfer";
+} from "@ai-matrx/alchemy/operate";
 export {
   buildAgentPayload,
   fenceJsonBlock

package/dist/agent-copy/page-capture/pageCapture.d.ts

@@ -14,7 +14,7 @@
  * sections, and the recent requests with their timings. Pure: no React, no
  * network — the suite drives it directly.
  */
-import type { AgentPayloadInput } from "@ai-matrx/kit/content-transfer";
+import type { AgentPayloadInput } from "@ai-matrx/alchemy/operate";
 import type { AlchemyGroomerConfig } from "@ai-matrx/design-system/content-transfer";
 export type PageCaptureKind = "table-page" | "record" | "dialog" | "admin-page";
 /** A chosen thing, by name and id. Either may be null (not chosen / not loaded). */

package/dist/agents/components/inputs/smart-input/AgentTextarea.d.ts

@@ -21,7 +21,6 @@ interface AgentTextareaProps {
     singleRow?: boolean;
     uploadRoot?: string;
     uploadPath?: string;
-    enablePasteImages?: boolean;
     surfaceKey?: string;
     /**
      * The key an unsent draft is also kept under, so it survives a reload of a
@@ -62,5 +61,5 @@ interface AgentTextareaProps {
     /** With `composerType`: each text line is one 32px composer row (splash · page). */
     composerRows?: boolean;
 }
-export declare function AgentTextarea({ conversationId, compact, singleRow, uploadRoot, uploadPath, enablePasteImages, surfaceKey, draftAlias, disableSend, initiallyExpanded, autoFocus, showExpandToggle, placeholder, minHeightPx, flush, composerType, composerRows, maxHeightPx, textMenu, }: AgentTextareaProps): React.JSX.Element;
+export declare function AgentTextarea({ conversationId, compact, singleRow, uploadRoot, uploadPath, surfaceKey, draftAlias, disableSend, initiallyExpanded, autoFocus, showExpandToggle, placeholder, minHeightPx, flush, composerType, composerRows, maxHeightPx, textMenu, }: AgentTextareaProps): React.JSX.Element;
 export {};

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

@@ -23,14 +23,12 @@ import {
   selectComposerHasSomethingToSend,
   selectIsExecuting
 } from "../../../redux/execution-system/selectors/aggregate.selectors.js";
-import { useClipboardPaste } from "../../../../host/ui-slots.js";
 import { focusUnlessTypingElsewhere } from "../../../../utils/dom/focus-guard.js";
 import {
   composerKeyIntent,
   intentTakesTheKey
 } from "../../../../ui/composer/composerSubmit.js";
 import { readVerticalChrome, snapToLineGrid } from "./textarea-line-grid.js";
-import { usePasteImageResource } from "../resources/usePasteImageResource.js";
 import { useInstanceInputUndoRedo } from "../../../hooks/useInstanceInputUndoRedo.js";
 import { ComposerDraftNotice } from "./ComposerDraftNotice.js";
 import { ComposerToolsNotice } from "./ComposerToolsNotice.js";
@@ -48,7 +46,6 @@ function AgentTextarea({
   singleRow = false,
   uploadRoot = "userContent",
   uploadPath = "agent-attachments",
-  enablePasteImages = true,
   surfaceKey,
   draftAlias,
   disableSend = false,
@@ -128,15 +125,6 @@ function AgentTextarea({
     if (disableSend) return;
     dispatch(interruptAndSend({ conversationId, surfaceKey }));
   }, [disableSend, conversationId, surfaceKey, dispatch]);
-  const handlePasteImage = usePasteImageResource(conversationId, {
-    uploadRoot,
-    uploadPath
-  });
-  useClipboardPaste({
-    textareaRef,
-    onPasteImage: handlePasteImage,
-    disabled: !enablePasteImages
-  });
   const handleTextChange = useCallback(
     (value) => {
       dispatch(

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

@@ -36,6 +36,7 @@ import {
   smartExecute,
   cancelExecution
 } from "../../../redux/execution-system/thunks/smart-execute.thunk.js";
+import { isMacLike } from "../../../hooks/useAgentUndoRedo.js";
 import { MicDeviceMenu } from "../../../../host/ui-slots.js";
 import { Button, SplitButton } from "@ai-matrx/design-system/controls";
 import { cn } from "@ai-matrx/design-system";
@@ -171,7 +172,7 @@ function InputActionButtons({
     ] });
   }
   if (composer.part === "controls") {
-    return /* @__PURE__ */ jsxs("div", { className: "flex min-w-0 items-center justify-between gap-1.5 shrink-0", children: [
+    return /* @__PURE__ */ jsxs("div", { "data-composer-row": "", className: "flex min-w-0 items-center justify-between gap-1.5 shrink-0", children: [
       /* @__PURE__ */ jsxs("div", { className: "flex min-w-0 shrink-0 items-center gap-1.5", children: [
         plusMenu,
         /* @__PURE__ */ jsx(DesktopPresenceIndicator, { conversationId }),
@@ -212,7 +213,6 @@ function ComposerSendSlot({
   );
   return /* @__PURE__ */ jsx(Fragment, { children: children(hasSomethingToSend) });
 }
-const IS_MAC = typeof navigator !== "undefined" && /Mac|iPhone|iPad/.test(navigator.platform || navigator.userAgent);
 function Keys({ keys }) {
   return /* @__PURE__ */ jsx("span", { className: "flex shrink-0 items-center gap-0.5", children: keys.map((key) => /* @__PURE__ */ jsx(
     "kbd",
@@ -230,7 +230,7 @@ function ComposerSendButton({
   disabled,
   onSend
 }) {
-  const mod = IS_MAC ? "\u2318" : "Ctrl";
+  const mod = isMacLike() ? "\u2318" : "Ctrl";
   const rows = isExecuting ? [
     { label: "Queue for when it finishes", keys: submitOnEnter ? ["\u21B5"] : [mod, "\u21B5"] },
     ...submitOnEnter ? [{ label: "Steer in now", keys: [mod, "\u21B5"] }] : [],

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

@@ -22,6 +22,7 @@ import { composerShows } from "./composer/composer-mode-visibility.js";
 import { ComposerChipsRow } from "./composer/ComposerChipsRow.js";
 import { ComposerMetaRow, ComposerPills, ComposerScopeCluster, ComposerValueGroupChip } from "./composer/ComposerMetaRow.js";
 import { useComposerFold } from "./composer/useComposerFold.js";
+import { useTouchOnlyDevice } from "../../../../ui/composer/useTouchOnlyDevice.js";
 function SmartAgentInputStacked({
   conversationId,
   uploadRoot = "userContent",
@@ -44,6 +45,7 @@ function SmartAgentInputStacked({
   const [voiceBusy, setVoiceBusy] = useState(false);
   const [expandRequestKey, setExpandRequestKey] = useState(0);
   const { ref: composerRootRef, folded } = useComposerFold();
+  const touchOnly = useTouchOnlyDevice();
   const showFreeformInput = useAppSelector(
     selectShowFreeformInput(conversationId ?? "")
   );
@@ -65,7 +67,8 @@ function SmartAgentInputStacked({
       "div",
       {
         className: cn(
-          "matrx-touch-targets mx-auto flex w-full min-w-0 shrink-0 flex-col",
+          touchOnly && "matrx-touch-targets",
+          "mx-auto flex w-full min-w-0 shrink-0 flex-col",
           formCompact ? void 0 : "max-w-[768px]"
         ),
         "data-composer-size": composer.size,
@@ -77,6 +80,7 @@ function SmartAgentInputStacked({
             conversationId,
             uploadRoot,
             uploadPath,
+            pasteFiles: enablePasteImages,
             className: cn(
               "relative flex w-full min-h-0 flex-col gap-1.5 border border-border bg-card transition-colors focus-within:border-foreground/25",
               "[&_[data-variable-row]]:px-1.5 [&_[data-variable-heading]]:px-1.5 [&>input[type=file]]:!hidden",
@@ -152,7 +156,6 @@ function SmartAgentInputStacked({
       compact: isCompact,
       uploadRoot,
       uploadPath,
-      enablePasteImages,
       surfaceKey,
       disableSend: sendBlocked,
       initiallyExpanded: expandRequestKey > 0,
@@ -182,7 +185,7 @@ function SmartAgentInputStacked({
       "div",
       {
         ref: composerRootRef,
-        className: "matrx-touch-targets mx-auto flex w-full min-w-0 max-w-[420px] shrink-0 flex-col",
+        className: cn(touchOnly && "matrx-touch-targets", "mx-auto flex w-full min-w-0 max-w-[420px] shrink-0 flex-col"),
         "data-composer-size": composer.size,
         "data-composer-mode": composer.mode,
         "data-assist-dock-avoid": "",
@@ -192,6 +195,7 @@ function SmartAgentInputStacked({
             conversationId,
             uploadRoot,
             uploadPath,
+            pasteFiles: enablePasteImages,
             className: cn(
               "relative flex w-full min-h-0 flex-col gap-1 rounded-[18px] border p-1.5",
               "border-glass-edge bg-glass shadow-glass backdrop-blur-glass backdrop-saturate-glass transition-[border-color,background-color,box-shadow]",
@@ -230,7 +234,6 @@ function SmartAgentInputStacked({
                     compact: true,
                     uploadRoot,
                     uploadPath,
-                    enablePasteImages,
                     surfaceKey,
                     disableSend: sendBlocked,
                     autoFocus: false,
@@ -263,9 +266,11 @@ function SmartAgentInputStacked({
     {
       ref: composerRootRef,
       className: cn(
-        // THE 44px FLOOR for every control on a touch layout (globals.css);
-        // desktop density is untouched.
-        "matrx-touch-targets mx-auto flex w-full min-w-0 shrink-0 flex-col gap-1",
+        // THE 44px FLOOR on a TOUCH device only. The shared class also fires
+        // on any viewport under 1024px, which stretched every button and pill
+        // of a narrowed desktop window to 44px (2026-10-06).
+        touchOnly && "matrx-touch-targets",
+        "mx-auto flex w-full min-w-0 shrink-0 flex-col gap-1",
         isCompact ? void 0 : "max-w-[768px]"
       ),
       "data-composer-size": composer.size,
@@ -280,6 +285,7 @@ function SmartAgentInputStacked({
             conversationId,
             uploadRoot,
             uploadPath,
+            pasteFiles: enablePasteImages,
             className: cardClassName,
             children: [
               /* @__PURE__ */ jsx(

package/dist/agents/components/inputs/smart-input/SmartInputFileDropTarget.d.ts

@@ -2,7 +2,14 @@ interface SmartInputFileDropTargetProps extends Omit<React.ComponentPropsWithout
     conversationId: string;
     uploadRoot?: string;
     uploadPath?: string;
+    /**
+     * Pasted files (a screenshot, Cmd/Ctrl+V of a copied file) attach through
+     * the same upload as a drop. react-dropzone OWNS paste-to-upload (v20+,
+     * on by default); nothing else in the input may also catch the paste, or
+     * every pasted image attaches twice (2026-10-06). False = paste stays text.
+     */
+    pasteFiles?: boolean;
     children: React.ReactNode;
 }
-export declare function SmartInputFileDropTarget({ conversationId, uploadRoot, uploadPath, className, children, ...rootProps }: SmartInputFileDropTargetProps): import("react").JSX.Element;
+export declare function SmartInputFileDropTarget({ conversationId, uploadRoot, uploadPath, pasteFiles, className, children, ...rootProps }: SmartInputFileDropTargetProps): import("react").JSX.Element;
 export {};

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

@@ -8,6 +8,7 @@ function SmartInputFileDropTarget({
   conversationId,
   uploadRoot,
   uploadPath,
+  pasteFiles = true,
   className,
   children,
   ...rootProps
@@ -19,7 +20,8 @@ function SmartInputFileDropTarget({
   const { getRootProps, getInputProps, isDragActive } = useDropzone({
     onDrop: (files) => void uploadResources(files),
     noClick: true,
-    noKeyboard: true
+    noKeyboard: true,
+    noPaste: !pasteFiles
   });
   return /* @__PURE__ */ jsxs(
     "div",

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

@@ -89,7 +89,7 @@ function ComposerMetaRow({
   return (
     // One line, always: a narrow column scrolls the row sideways, never wraps it.
     // Every gap is the tap-target 6px; the clusters sit at the two ends.
-    /* @__PURE__ */ jsxs("div", { className: cn(COMPOSER_ROW_CLASS, "justify-between gap-1.5 px-1"), children: [
+    /* @__PURE__ */ jsxs("div", { "data-composer-row": "", className: cn(COMPOSER_ROW_CLASS, "justify-between gap-1.5 px-1"), children: [
       /* @__PURE__ */ jsx(ComposerScopeCluster, { conversationId, composer, folded }),
       /* @__PURE__ */ jsx(ComposerPills, { conversationId, composer, menuSide, folded })
     ] })

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

@@ -16,7 +16,7 @@ import {
   COMPOSER_MODE_LABELS
 } from "./composer-types.js";
 import { useComposerMode } from "./useComposerMode.js";
-import { Button } from "@ai-matrx/design-system/controls";
+import { SegmentedControl } from "@ai-matrx/design-system/controls";
 function ComposerModeSwitch({
   initialMode,
   size = "bar",
@@ -30,20 +30,15 @@ function ComposerModeSwitch({
   const fit = useCenterControlFit(cellRef, [fullRef, triggerRef], mode);
   const measured = useSyncExternalStore(noopSubscribe, () => true, () => false);
   const renderSegments = (interactive) => /* @__PURE__ */ jsx(
-    "div",
+    SegmentedControl,
     {
-      role: interactive ? "tablist" : void 0,
-      "aria-label": interactive ? "Composer mode" : void 0,
-      className: cn(
-        "shrink-0 items-center gap-0.5 rounded-lg bg-muted p-0.5",
-        panel || !interactive ? "inline-flex rounded-lg" : measured ? "inline-flex rounded-[10px]" : "hidden rounded-[10px] sm:inline-flex",
-        !interactive && "w-max max-w-none",
-        className
-      ),
-      children: COMPOSER_MODES.map((value) => {
-        const on = value === mode;
-        return /* @__PURE__ */ jsx(Button, { variant: "quiet", pressed: !!on, role: interactive ? "tab" : void 0, "aria-selected": interactive ? on : void 0, "aria-pressed": interactive ? void 0 : on, tabIndex: interactive ? void 0 : -1, onClick: interactive ? () => setMode(value) : void 0, children: COMPOSER_MODE_LABELS[value] }, value);
-      })
+      "aria-label": "Composer mode",
+      value: mode,
+      onValueChange: (value) => {
+        if (interactive) setMode(value);
+      },
+      data: COMPOSER_MODES.map((value) => ({ value, label: COMPOSER_MODE_LABELS[value] })),
+      className: cn("shrink-0", !interactive && "w-max max-w-none", className)
     }
   );
   if (panel) return renderSegments(true);
@@ -61,7 +56,7 @@ function ComposerModeSwitch({
       className: "relative flex w-full min-w-0 justify-center",
       "data-route-nav-inflow": fit.inflow ? "" : void 0,
       children: [
-        /* @__PURE__ */ jsxs("div", { "aria-hidden": true, className: "pointer-events-none invisible absolute left-0 top-0", children: [
+        /* @__PURE__ */ jsxs("div", { "aria-hidden": true, inert: true, className: "pointer-events-none invisible absolute left-0 top-0", children: [
           /* @__PURE__ */ jsx("div", { ref: fullRef, className: "w-max max-w-none", children: renderSegments(false) }),
           /* @__PURE__ */ jsx("span", { ref: triggerRef, "data-route-nav-min": true, className: cn(triggerClass, "w-max max-w-none"), children: triggerFace })
         ] }),

package/dist/agents/components/inputs/smart-input/composer/useComposerFold.d.ts

@@ -5,8 +5,9 @@
  */
 export declare const COMPOSER_FOLD_WIDTH_PX = 480;
 /**
- * Watches the composer's own width and re-renders only when it crosses the
- * fold threshold — never per pixel while a panel is dragged.
+ * Watches the composer's own width — and whether a row under the card
+ * overflows — and re-renders only when the fold flips, never per pixel while
+ * a panel is dragged.
  */
 export declare function useComposerFold(): {
     ref: import("react").Dispatch<import("react").SetStateAction<HTMLDivElement | null>>;

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

@@ -6,15 +6,40 @@ function useComposerFold() {
   const [folded, setFolded] = useState(false);
   useEffect(() => {
     if (!el || typeof ResizeObserver === "undefined") return void 0;
-    const observer = new ResizeObserver(([entry]) => {
-      const width = entry?.contentRect.width ?? 0;
-      setFolded(width > 0 && width < COMPOSER_FOLD_WIDTH_PX);
-    });
+    let foldedAt = 0;
+    const evaluate = () => {
+      const width = el.getBoundingClientRect().width;
+      if (width === 0) return;
+      const rows = Array.from(el.querySelectorAll("[data-composer-row]"));
+      const overflowing = rows.some((row) => row.scrollWidth > row.clientWidth + 1);
+      setFolded((was) => {
+        if (width < COMPOSER_FOLD_WIDTH_PX) {
+          foldedAt = Math.max(foldedAt, width);
+          return true;
+        }
+        if (!was && overflowing) {
+          foldedAt = width;
+          return true;
+        }
+        if (was && width > foldedAt + UNFOLD_MARGIN_PX && !overflowing) {
+          foldedAt = 0;
+          return false;
+        }
+        return was;
+      });
+    };
+    const observer = new ResizeObserver(evaluate);
     observer.observe(el);
-    return () => observer.disconnect();
+    const mutations = new MutationObserver(() => requestAnimationFrame(evaluate));
+    mutations.observe(el, { subtree: true, childList: true, characterData: true });
+    return () => {
+      observer.disconnect();
+      mutations.disconnect();
+    };
   }, [el]);
   return { ref, folded };
 }
+const UNFOLD_MARGIN_PX = 80;
 export {
   COMPOSER_FOLD_WIDTH_PX,
   useComposerFold

package/dist/agents/components/messages-display/MessageTimestamp.d.ts

@@ -9,6 +9,13 @@ interface TimestampDisplay {
     compact: string;
 }
 export declare function formatTimestampDisplay(timestamp: TimestampInput): TimestampDisplay | null;
-/** Hover-only compact time; the exact date, seconds and zone remain available on focus. */
+/**
+ * The time at the END of the action row. It always occupies its space — it is
+ * revealed by opacity on hover/focus, never inserted — so showing it shifts
+ * nothing. It never wraps: a narrow row gets the time alone ("2:23 PM"), a
+ * wider one the date too ("Oct 6, 2:23 PM"). The exact date, seconds and zone
+ * stay in the tooltip and accessible name. A touch screen has no hover to
+ * reveal it, so there it takes no space at all and the actions get the row.
+ */
 export declare function MessageTimestamp({ timestamp }: MessageTimestampProps): import("react").JSX.Element | null;
 export {};

package/dist/agents/components/messages-display/MessageTimestamp.js

@@ -50,11 +50,10 @@ function MessageTimestamp({ timestamp }) {
       tabIndex: 0,
       "aria-label": `${display.absolute} (${display.relative})`,
       title: `${display.absolute} (${display.relative})`,
-      style: { whiteSpace: "nowrap" },
-      className: "sr-only text-[10px] font-normal text-muted-foreground/65 focus:not-sr-only [@media(hover:hover)]:group-hover/assistant-msg:not-sr-only [@media(hover:hover)]:group-focus-within/assistant-msg:not-sr-only",
+      className: "shrink-0 whitespace-nowrap [@media(hover:none)]:hidden text-[10px] font-normal text-muted-foreground/65 opacity-0 transition-opacity focus:opacity-100 [@media(hover:hover)]:group-hover/assistant-msg:opacity-100 [@media(hover:hover)]:group-focus-within/assistant-msg:opacity-100",
       children: [
-        /* @__PURE__ */ jsx("span", { className: "@min-[400px]/message-footer:hidden", children: display.compact }),
-        /* @__PURE__ */ jsx("span", { className: "hidden @min-[400px]/message-footer:inline", children: display.short })
+        /* @__PURE__ */ jsx("span", { className: "@min-[420px]/message-footer:hidden", children: display.compact }),
+        /* @__PURE__ */ jsx("span", { className: "hidden @min-[420px]/message-footer:inline", children: display.short })
       ]
     }
   );

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

@@ -52,7 +52,8 @@ import { AssistantWarning } from "../../run/AssistantWarning.js";
 import { BreathingOrb } from "./BreathingOrb.js";
 import {
   AssistantMessageContextMenu,
-  AssistantMessageFooter
+  AssistantMessageFooter,
+  AssistantMessageFooterPlaceholder
 } from "./AssistantMessageFooter.js";
 import { AssistantNoAnswer } from "./AssistantNoAnswer.js";
 import { selectInstanceStatus } from "../../../redux/execution-system/conversations/conversations.selectors.js";
@@ -442,7 +443,7 @@ function AgentAssistantMessage({
           !isClosedStreamSegment && displaySources.length > 0 && /* @__PURE__ */ jsx(MessageSourcesRow, { sources: displaySources, className: "mt-2" }),
           !isStreamActive && /* @__PURE__ */ jsx(PrefillNote, { metadata: record?.metadata }),
           !isStreamActive && /* @__PURE__ */ jsx(StoppedNote, { metadata: record?.metadata, requestStatus }),
-          isStreamActive && !failed && (phase === "text_streaming" || phase === "interstitial") && /* @__PURE__ */ jsx(BreathingOrb, { className: "mt-1.5", size: 48 })
+          isStreamActive && !failed && (phase === "text_streaming" || phase === "interstitial") && /* @__PURE__ */ jsx("div", { className: "relative h-0 overflow-visible", children: /* @__PURE__ */ jsx(BreathingOrb, { className: "absolute left-0 top-[3px]", size: 40 }) })
         ] }),
         !isClosedStreamSegment && visibleWarnings?.map((warning, index) => /* @__PURE__ */ jsx(
           AssistantWarning,
@@ -475,7 +476,8 @@ function AgentAssistantMessage({
             isCapturing,
             surfaceKey
           }
-        )
+        ),
+        !hideActionBar && (isStreamActive || !messageId) && !failed && !editingInPlace && /* @__PURE__ */ jsx(AssistantMessageFooterPlaceholder, {})
       ]
     }
   );

package/dist/agents/components/messages-display/assistant/AssistantMessageFooter.d.ts

@@ -51,6 +51,11 @@ export declare function useAssistantMessageActions({ messageId, conversationId,
     showOptions: boolean;
     isLatestAssistant: boolean;
 };
+/**
+ * Holds the action row's space while a reply streams (the real footer needs
+ * the saved message id), so nothing below jumps when the actions arrive.
+ */
+export declare function AssistantMessageFooterPlaceholder(): React.JSX.Element;
 export declare function AssistantMessageFooter(props: AssistantMessageFooterProps): React.JSX.Element;
 export default AssistantMessageFooter;
 /** Agent-menu placements over a rendered answer (never "Content Blocks"). */

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

@@ -146,6 +146,10 @@ function useAssistantMessageActions({
     isLatestAssistant
   };
 }
+let lastFooterRowHeight = 46;
+function AssistantMessageFooterPlaceholder() {
+  return /* @__PURE__ */ jsx("div", { "aria-hidden": true, style: { height: lastFooterRowHeight } });
+}
 function AssistantMessageFooter(props) {
   const { messageId, conversationId, surfaceKey } = props;
   const {
@@ -162,6 +166,17 @@ function AssistantMessageFooter(props) {
     isLatestAssistant
   } = useAssistantMessageActions(props);
   const isHoverOnly = density === "compact" && !isLatestAssistant;
+  const rowRef = useRef(null);
+  useEffect(() => {
+    const row = rowRef.current;
+    if (!row) return;
+    const observer = new ResizeObserver(() => {
+      const height = row.getBoundingClientRect().height;
+      if (height > 0) lastFooterRowHeight = height;
+    });
+    observer.observe(row);
+    return () => observer.disconnect();
+  }, []);
   return /* @__PURE__ */ jsxs(Fragment, { children: [
     /* @__PURE__ */ jsxs(
       "div",
@@ -171,19 +186,26 @@ function AssistantMessageFooter(props) {
           isHoverOnly && "opacity-0 group-hover/assistant-msg:opacity-100 focus-within:opacity-100"
         ),
         children: [
-          /* @__PURE__ */ jsxs("div", { className: "@container/message-footer w-full min-w-0", children: [
-            /* @__PURE__ */ jsx(
-              RichDocumentActions,
-              {
-                content: config.content,
-                source: config.source,
-                actions: config.actions,
-                hideOverflow: !showOptions,
-                className: "px-0"
-              }
-            ),
-            /* @__PURE__ */ jsx("div", { className: "flex justify-end", children: /* @__PURE__ */ jsx(MessageTimestamp, { timestamp: record?.createdAt }) })
-          ] }),
+          /* @__PURE__ */ jsxs(
+            "div",
+            {
+              ref: rowRef,
+              className: "@container/message-footer flex w-full min-w-0 items-center gap-2",
+              children: [
+                /* @__PURE__ */ jsx("div", { className: "min-w-0 flex-1", children: /* @__PURE__ */ jsx(
+                  RichDocumentActions,
+                  {
+                    content: config.content,
+                    source: config.source,
+                    actions: config.actions,
+                    hideOverflow: !showOptions,
+                    className: "px-0"
+                  }
+                ) }),
+                /* @__PURE__ */ jsx(MessageTimestamp, { timestamp: record?.createdAt })
+              ]
+            }
+          ),
           /* @__PURE__ */ jsx(
             NegativeVerdictFollowUp,
             {
@@ -243,6 +265,7 @@ export {
   ASSISTANT_ANSWER_PLACEMENT_MODE,
   AssistantMessageContextMenu,
   AssistantMessageFooter,
+  AssistantMessageFooterPlaceholder,
   AssistantMessageFooter_default as default,
   useAssistantMessageActions
 };

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

@@ -5,7 +5,8 @@ import { useDomCapturePrint } from "../../../../conversation/hooks/useDomCapture
 import { AgentAssistantMessage } from "./AgentAssistantMessage.js";
 import {
   AssistantMessageContextMenu,
-  AssistantMessageFooter
+  AssistantMessageFooter,
+  AssistantMessageFooterPlaceholder
 } from "./AssistantMessageFooter.js";
 import {
   membersForRender,
@@ -111,6 +112,7 @@ function AssistantTurnGroup({
           },
           `files-${m.key}`
         )),
+        lastMember && !showBar && /* @__PURE__ */ jsx(AssistantMessageFooterPlaceholder, {}),
         showBar && anchorMessageId && // The group's bar sits BESIDE its members, so it carries the turn's
         // one menu itself — its ⋯ opens the same menu the answer's
         // right-click does (RC-B6), never a second drawn menu.

package/dist/surfaces/manifests/_baseline.manifest.d.ts

@@ -150,6 +150,65 @@ export declare const PLATFORM_CONTEXT_VALUES: {
         readonly sortOrder: 9997;
     };
 };
+/**
+ * THE BASELINE SURFACE — where the platform's own write targets are declared
+ * (Matrx Alchemy ALC-17). Every surface inherits it: the one write door reads
+ * it as the root ancestor of every surface (`surfaceWriteDeclarations` in
+ * `runtime/surface-writeback.ts`), so a write to a platform target from ANY
+ * surface resolves here, and the platform's headless handlers are registered
+ * on this name. It is not a page and is never mounted.
+ */
+export declare const BASELINE_SURFACE_NAME = "matrx-platform/baseline";
+/** `surface_feedback` value bounds — the description and the check read the same numbers. */
+export declare const SURFACE_FEEDBACK_KINDS: readonly ["missing_capability", "wrong_or_unclear_description", "bug", "missing_data", "suggestion"];
+export declare const SURFACE_FEEDBACK_MESSAGE_MIN = 10;
+export declare const SURFACE_FEEDBACK_MESSAGE_MAX = 4000;
+/** At most this many custom fields per `custom_fields_add` write. */
+export declare const CUSTOM_FIELDS_MAX_PER_WRITE = 10;
+/**
+ * THE PLATFORM WRITE TARGETS, declared once on the baseline surface. Each has
+ * the apply policy it always had: window fields and custom fields are `ask`
+ * (an agent's write waits for the person's card; a person's own write is the
+ * approval); feedback is `auto` (it changes nothing on the page). The runtime
+ * files word the live offer from these (`customFieldsTarget()` adds the
+ * mounted sections), and register the handlers that apply them.
+ */
+export declare const PLATFORM_WRITE_TARGETS: {
+    readonly window_form_fields: {
+        readonly name: "window_form_fields";
+        readonly label: "Fields in an open window";
+        readonly description: 'Change fields in an open window that has no registered surface (listed in your context as window::<title>). Value: { "window": "<title exactly as listed>", "changes": [{ "field": "<field key>", "value": <new value> }] }. A text or number field takes a string or number, a checkbox or switch takes true/false, a list takes the text of one of its choices (a wrong choice is refused with the real ones). Every change is checked against the field\'s rules before anything lands; the person approves first, and the window\'s own Save still decides.';
+        readonly valueType: "object";
+        readonly mode: "draft";
+        readonly applyPolicy: "ask";
+    };
+    readonly surface_feedback: {
+        readonly name: "surface_feedback";
+        readonly label: "Feedback about this page";
+        readonly description: string;
+        readonly valueType: "object";
+        readonly mode: "entity";
+        readonly applyPolicy: "auto";
+    };
+    readonly custom_fields_add: {
+        readonly name: "custom_fields_add";
+        readonly label: "Add custom fields";
+        readonly description: string;
+        readonly valueType: "object";
+        readonly mode: "entity";
+        readonly applyPolicy: "ask";
+    };
+    readonly custom_fields_set: {
+        readonly name: "custom_fields_set";
+        readonly label: "Fill in custom fields";
+        readonly description: string;
+        readonly valueType: "object";
+        readonly mode: "entity";
+        readonly applyPolicy: "ask";
+    };
+};
+export type PlatformWriteTargetName = keyof typeof PLATFORM_WRITE_TARGETS;
+export declare function isPlatformWriteTarget(name: string): name is PlatformWriteTargetName;
 /** Names only the platform writes — a manifest declaring one is refused. */
 export declare const PLATFORM_RESERVED_NAMES: {
     values: ReadonlyArray<string>;