@ai-matrx/chat 0.4.22 → 0.4.24

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @ai-matrx/chat
 
+## 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/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/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
 };

package/dist/agents/redux/execution-system/messages/messages.slice.js

@@ -349,7 +349,12 @@ const messagesSlice = createSlice({
           // The live receipt link — the persisted receipt wins once the
           // hydrated row carries one (selectMessageContextReceipt).
           ...live?._requestId ? { _requestId: live._requestId } : {},
-          ...live?._liveContextReceipt ? { _liveContextReceipt: live._liveContextReceipt } : {}
+          ...live?._liveContextReceipt ? { _liveContextReceipt: live._liveContextReceipt } : {},
+          // An answer open in the in-place editor stays open: the flag is
+          // client-only, and a re-read of the conversation (a window loading
+          // the conversation the page already loaded) used to drop it, closing
+          // the editor ~1.5s after a double-click and discarding the draft.
+          ...live?._editingInPlace ? { _editingInPlace: live._editingInPlace } : {}
         };
         entry.orderedIds.push(msg.id);
       }

package/dist/agents/redux/execution-system/thunks/await-launching-conversation.d.ts

@@ -0,0 +1,16 @@
+/**
+ * A SEND THAT BEATS ITS LAUNCH WAITS FOR IT.
+ *
+ * A fresh chat's composer is interactive as soon as it mounts, holding the id the launcher
+ * reserved, while the launcher is still creating that conversation (the agent's run controls, the
+ * organization, the mandate are being read). A person who types fast pressed Send in that window
+ * and the send was dropped as "no longer exists in this tab" (P29a canary: a send ~7 s after load,
+ * right after the workspace was chosen). The conversation was not gone; it had not landed yet.
+ *
+ * So the send waits, briefly, for its conversation to appear. A conversation that really was
+ * reaped never appears, and the caller still says so after the wait.
+ */
+import type { ChatRootState } from "../../../../store/root-state.js";
+/** How long a send waits for a launching conversation before calling it gone. */
+export declare const LAUNCHING_CONVERSATION_WAIT_MS = 15000;
+export declare function awaitLaunchingConversation(getState: () => ChatRootState, conversationId: string, timeoutMs?: number): Promise<boolean>;

package/dist/agents/redux/execution-system/thunks/await-launching-conversation.js

@@ -0,0 +1,16 @@
+const LAUNCHING_CONVERSATION_WAIT_MS = 15e3;
+const POLL_MS = 50;
+async function awaitLaunchingConversation(getState, conversationId, timeoutMs = LAUNCHING_CONVERSATION_WAIT_MS) {
+  const exists = () => getState().conversations.byConversationId[conversationId] !== void 0;
+  if (exists()) return true;
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    await new Promise((resolve) => setTimeout(resolve, POLL_MS));
+    if (exists()) return true;
+  }
+  return false;
+}
+export {
+  LAUNCHING_CONVERSATION_WAIT_MS,
+  awaitLaunchingConversation
+};

package/dist/agents/redux/execution-system/thunks/execute-instance.thunk.js

@@ -1,6 +1,10 @@
 import {
   executionRejectionMeta
 } from "./execution-rejection-meta.js";
+import {
+  continuesThroughMandate,
+  takeTurnExtras
+} from "../../../../host/conversation-hooks.js";
 import { isHostConversation } from "../host-conversations/host-conversations.selectors.js";
 import { attributionForSend } from "../../../../host/app-identity.js";
 import { mintClientTempId } from "@ai-matrx/kit/ids";
@@ -483,7 +487,24 @@ const executeInstance = createAsyncThunk(
       const pendingBypass = dispatch(
         consumePendingCacheBypass(conversationId)
       );
-      if (isContinuation) {
+      const hostExtras = takeTurnExtras(conversationId);
+      if (isContinuation && instance.mandateKey && !instance.initialAgentVersionId && continuesThroughMandate(conversationId)) {
+        const start = resolveStartPath({
+          agentId: instance.agentId,
+          pinnedVersionId: null,
+          mandateKey: instance.mandateKey,
+          overrideConfig: overrideConfig ?? void 0
+        });
+        url = `${baseUrl}${start.path}`;
+        routedPayload = {
+          ...payload,
+          conversation_id: conversationId,
+          is_new: false,
+          store: true,
+          ...retry && { retry: true },
+          ...pendingBypass && { cache_bypass: pendingBypass }
+        };
+      } else if (isContinuation) {
         const convPath = resolveEndpointPath(
           "/ai/conversations/{conversation_id}",
           overrideConfig
@@ -510,6 +531,18 @@ const executeInstance = createAsyncThunk(
           ...pendingBypass && { cache_bypass: pendingBypass }
         };
       }
+      if (hostExtras?.variables) {
+        routedPayload.variables = {
+          ...routedPayload.variables ?? {},
+          ...hostExtras.variables
+        };
+      }
+      if (hostExtras?.context) {
+        routedPayload.context = {
+          ...routedPayload.context ?? {},
+          ...hostExtras.context
+        };
+      }
       {
         const { overrides, error } = resolveRequestOverrides(
           state,

package/dist/agents/redux/execution-system/thunks/process-stream.js

@@ -1,3 +1,4 @@
+import { tapStreamEvent } from "../../../../host/conversation-hooks.js";
 import { selectHostConversation } from "../host-conversations/host-conversations.selectors.js";
 import {
   applyServerUsageState,
@@ -493,8 +494,16 @@ async function processStream({
       }) : rawEvents;
       streamFailure = null;
       let sawTerminalEvent = false;
+      let tapHeld = null;
+      const flushTap = () => {
+        if (!tapHeld) return;
+        const held = tapHeld;
+        tapHeld = null;
+        tapStreamEvent(conversationId, requestId, held.event);
+      };
       try {
         for await (const event of events) {
+          flushTap();
           const stamp = readStreamCursor(event);
           if (stamp !== null) {
             if (!transportCursor.admit(event)) continue;
@@ -506,6 +515,7 @@ async function processStream({
             scheduleBatchEvent();
           }
           totalEvents++;
+          tapHeld = { event };
           const now = performance.now();
           if (activeOnEvent) {
             try {
@@ -2080,6 +2090,7 @@ async function processStream({
       } catch (err) {
         streamFailure = err instanceof Error ? err : new Error(String(err));
       }
+      flushTap();
       if (sawTerminalEvent && streamFailure !== null) {
         streamFailure = null;
       }

package/dist/agents/redux/execution-system/thunks/smart-execute.thunk.js

@@ -6,6 +6,7 @@ import {
   SUBMISSION_REFUSED_AT_ADMISSION
 } from "./execute-instance.thunk.js";
 import { executeManualInstance } from "./execute-manual-instance.thunk.js";
+import { awaitLaunchingConversation } from "./await-launching-conversation.js";
 import { splitInputIntoNewConversation } from "./create-instance.thunk.js";
 import { abortConversation, hasAbortController } from "./abort-registry.js";
 import { setInstanceStatus } from "../conversations/conversations.slice.js";
@@ -65,6 +66,7 @@ import { markResourcesSubmitted } from "../instance-resources/instance-resources
 import { flushRemarkWrites, hasPendingRemarkWrites } from "../instance-resources/remarks.js";
 import { withFreshRemarkRefs } from "../instance-resources/remarks-wire.js";
 import { isOrganizationSelectionCancelled } from "../../../../host/org.js";
+import { runBeforeSend } from "../../../../host/conversation-hooks.js";
 function hasConversationAtExecutionBoundary(state, conversationId) {
   return state.conversations.byConversationId[conversationId] !== void 0;
 }
@@ -152,6 +154,9 @@ function holdBehindInFlightSend(dispatch, getState, args) {
 const smartExecute = createAsyncThunk(
   "instances/smartExecute",
   async ({ conversationId, surfaceKey, whileRunning = "queue", submission: handed }, { getState, dispatch }) => {
+    if (!handed && !hasConversationAtExecutionBoundary(getState(), conversationId)) {
+      await awaitLaunchingConversation(getState, conversationId);
+    }
     const entryState = getState();
     if (!handed) {
       const inputEntry = entryState.instanceUserInput?.byConversationId[conversationId];
@@ -322,6 +327,11 @@ const smartExecute = createAsyncThunk(
         })
       );
       preSendShown = true;
+      const hostGate = await runBeforeSend(conversationId, submission.text);
+      if (!hostGate.ok) {
+        toast.info("Not sent", { description: hostGate.sentence });
+        return;
+      }
       try {
         await dispatch(
           refreshSurfaceScope({ conversationId, composerText: submission.text })

package/dist/host/app-data-slots.d.ts

@@ -76,7 +76,6 @@ export declare const useAnchorRecords: (anchor: {
     type: string;
     id: string;
 } | null, enabled?: boolean) => AnchorRecordsState;
-/** A host with no shape catalog has no shapes to browse: the read says so, the picker shows it. */
 export declare const fetchShapePage: (query: EntityListQuery, sort: EntityListSort) => Promise<EntityListPage<ShapeBrowseRow>>;
 export declare const fetchShapeByKind: (kind: string) => Promise<ShapeBrowseRow | null>;
 /** A host with no Source Inspector opens a web source in a new tab; a file source has no target here. */

package/dist/host/app-data-slots.js

@@ -1,4 +1,6 @@
 import { hostFn, hostSlot } from "./ui-slots.js";
+import { listOrgParam } from "@ai-matrx/records/list";
+import { supabase } from "./db.js";
 const CONVERSATION_ANCHOR_TYPE = "conversation";
 const contentIrKindValidator = hostFn("contentIrKindValidator", () => ({
   validate: async (_value, kind) => ({
@@ -20,11 +22,29 @@ const useAnchorRecords = hostFn("useAnchorRecords", () => ({
   message: null,
   reload: () => void 0
 }));
-const fetchShapePage = hostFn("fetchShapePage", async () => {
-  throw new Error("This host has no shape catalog (registerChatUi fetchShapePage)");
-});
-const fetchShapeByKind = hostFn("fetchShapeByKind", async () => {
-  throw new Error("This host has no shape catalog (registerChatUi fetchShapeByKind)");
+async function readShapePage(query, sort) {
+  const { data, error } = await supabase.rpc("shx_list_scoped", {
+    p_scope: query.scope.kind,
+    p_org_id: listOrgParam(query),
+    p_search: query.search.trim() || void 0,
+    p_deep: query.deep,
+    p_sort: sort.sort,
+    p_dir: sort.direction,
+    p_filters: query.filters,
+    p_limit: sort.pageSize,
+    p_offset: (query.page - 1) * sort.pageSize
+  });
+  if (error) throw new Error(`Could not load the shapes: ${error.message ?? "the database returned an error with no message."}`);
+  const rows = data ?? [];
+  return { rows, total: rows.length > 0 ? Number(rows[0].total_count) : 0 };
+}
+const fetchShapePage = hostFn("fetchShapePage", readShapePage);
+const fetchShapeByKind = hostFn("fetchShapeByKind", async (kind) => {
+  const page = await readShapePage(
+    { scope: { kind: "all" }, orgId: null, search: "", deep: false, archived: "active", filters: { kind: { kind: "text", value: kind } }, page: 1 },
+    { sort: "label", direction: "asc", favoritesFirst: false, pageSize: 50 }
+  );
+  return page.rows.find((row) => row.kind === kind) ?? null;
 });
 const useOpenCitationSource = hostFn("useOpenCitationSource", () => (source) => {
   if (source.url && typeof window !== "undefined") window.open(source.url, "_blank", "noopener,noreferrer");

package/dist/host/bare-host-chrome.js

@@ -8,6 +8,8 @@ import { AgentCatalogProvider } from "@ai-matrx/agents/catalog/react";
 import { createModelCatalog, createModelFavorites } from "@ai-matrx/agents/models";
 import { ModelCatalogProvider } from "@ai-matrx/agents/models/react";
 import { hasChatScopes, registerChatScopes } from "../context/sources/scopes.js";
+import { configureBareFilesHost } from "./defaults/files-host.js";
+import { registerBareReadableBlocks } from "./defaults/bare-block-dispatch.js";
 const SAVE_REASON = "save this";
 function BareHostChrome({ host, children }) {
   const [associations] = useState(
@@ -33,6 +35,8 @@ function BareHostChrome({ host, children }) {
       });
     }
   });
+  useState(() => configureBareFilesHost(host));
+  useState(() => registerBareReadableBlocks());
   const [catalog] = useState(() => host.catalog());
   const [models] = useState(() => ({
     catalog: createModelCatalog({ client: host.db }),

package/dist/host/contract.d.ts

@@ -38,7 +38,7 @@ export type ChatDb = SupabaseClient<ChatDatabase>;
  * (migrations/log_client_error_names_the_feature_too.sql). A value outside it
  * makes the database refuse the row, so the diagnostics default checks it first.
  */
-export declare const CHAT_SOURCE_APPS: readonly ["matrx-frontend", "matrx-extend", "matrx-local", "matrx-mobile"];
+export declare const CHAT_SOURCE_APPS: readonly ["matrx-frontend", "matrx-extend", "matrx-local", "matrx-mobile", "workflow-studio"];
 export type ChatSourceApp = (typeof CHAT_SOURCE_APPS)[number];
 export type ChatAdminLevel = "developer" | "senior_admin" | "super_admin";
 export interface ChatIdentity {

package/dist/host/contract.js

@@ -2,7 +2,8 @@ const CHAT_SOURCE_APPS = [
   "matrx-frontend",
   "matrx-extend",
   "matrx-local",
-  "matrx-mobile"
+  "matrx-mobile",
+  "workflow-studio"
 ];
 export {
   CHAT_SOURCE_APPS

package/dist/host/conversation-hooks-react.d.ts

@@ -0,0 +1,2 @@
+/** The sentence holding this conversation's composer (host/conversation-hooks `held`), or null. */
+export declare function useConversationHeld(conversationId: string | null | undefined): string | null;

package/dist/host/conversation-hooks-react.js

@@ -0,0 +1,12 @@
+import { useSyncExternalStore } from "react";
+import { readConversationHeld, subscribeConversationHeld } from "./conversation-hooks.js";
+function useConversationHeld(conversationId) {
+  return useSyncExternalStore(
+    (listener) => subscribeConversationHeld(conversationId, listener),
+    () => readConversationHeld(conversationId),
+    () => null
+  );
+}
+export {
+  useConversationHeld
+};