@ai-matrx/chat 0.7.22 → 0.7.24

package/CHANGELOG.md

@@ -1,5 +1,41 @@
 # @ai-matrx/chat
 
+## 0.7.24
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/chat/v0.7.23..npm/chat/v0.7.24 -- apps/shared/chat`).
+No source changes intended and no consumer action required.
+
+## 0.7.23
+### Unreleased
+
+### The Form inputs layout folds, it never disappears
+
+- **`AgentVariableForm`: the "Fill in the details below" header folds the fields and opens them again.**
+  It used to write the host's `showVariablePanel` flag, so one click removed the whole form, header
+  included — a host with no variables button of its own (the form-style composer, a Board agent-form
+  tile) could never get the fields back. The fold is the form's own state; `showVariablePanel` stays the
+  host's hide and the composer button's. Guard: `form-fold-never-removes-the-form.test.tsx`.
+  Consumer action: none.
+
+### A run parked on the person waits for them (lane F15)
+
+- **`runHeadlessAgentJson` / `adoptHeadlessAgentJson` / `continueAgentJson`: waiting on the person is a
+  waiting state, never a failure.** A turn that ends parked on a question (`ask_person`,
+  `suspended_awaiting_client`) no longer settles from the parked call (the Applet builder said "The
+  builder answered without an app" over a question it never showed). The wait fires the new
+  `onAwaitingPerson`, pauses `timeoutMs`, re-reads the conversation (`rereadAndFollow`) when the ask
+  closes anywhere, and resolves from the resumed turn's answer; `personWaitMs` (default 6h) bounds it.
+  A parked run that stops waiting harvests nothing (`awaitingPerson: true`). Consumer action: a surface
+  that runs an agent which may ask passes `onAwaitingPerson` to say it is waiting.
+- **A dropped connection is not a failed run.** When the stream dies on a connection loss
+  (`transport_lost` / `heartbeat_timeout`) the server finishes the turn and `reconnectServerOperation`
+  re-reads it; the headless wait now waits for that (5 min ceiling) and resolves from the answer it
+  brings, instead of failing "before returning a result" while the build finished on the server. A
+  reconnect that brings nothing ends with the stream's own reason. Consumer action: none.
+- **A settled turn that ended on a tool call shows the call, not "Processing…"** (`isWaitingForFirstContent`):
+  the parked ask's card now draws in place of a shimmer that never ended. Consumer action: none.
+
 ## 0.7.22
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see
@@ -9,6 +45,17 @@ No source changes intended and no consumer action required.
 ## 0.7.21
 ### Unreleased
 
+### /chat/new: the last two startup costs
+
+- **Pinned agents read only the pins, only on screen.** `PinnedAgentsSection` waits for
+  `useInView` (never from a closed mobile sheet or collapsed rail), then calls the catalog's
+  `ensureFavoriteRows()` — `ues_list` + `agx_get_list_full?id=in.(…)` — instead of loading the
+  whole agent catalogue after page idle. It shows a loading skeleton and a retry on failure.
+- **The splash paints its final footprint.** The server-painted composer shell carries the
+  composer's placeholder (no pulse), the landing no longer fades in from opacity 0, and the
+  quick-action row keeps its skeleton until the organization is set instead of vanishing. On a
+  phone the textarea placeholder was the page's Largest Contentful Paint at 5.7–15 s.
+
 ### /chat/new: the live residuals of the startup-read work
 
 - **A minted id is a draft before its record exists.** `generateConversationId` remembers the ids this tab

package/dist/agents/components/chat/NewChatGreeting.d.ts

@@ -20,6 +20,15 @@ interface NewChatGreetingProps {
  * agent's fresh-chat route, never a launch with a resolved id.
  */
 export declare function NewChatGreeting({ sourceConversationId, surfaceKey, composer, }: NewChatGreetingProps): import("react").JSX.Element;
-/** The splash composer's footprint while its conversation is created. */
+/**
+ * The splash composer as the server paints it, before the page is live: the
+ * real card's box and its placeholder in the real textarea's type and inset.
+ *
+ * THE PLACEHOLDER PAINTS WITH THE PAGE (2026-10-09). It is the largest text on
+ * a phone's /chat/new (larger than the greeting), so a shell without it made
+ * the live textarea's placeholder the page's Largest Contentful Paint seconds
+ * later. Same words, same size: the live box replaces it without a new paint
+ * winning. No pulse — an opacity animation would hide the text from that count.
+ */
 export declare function ChatSplashComposerShell(): import("react").JSX.Element;
 export {};

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

@@ -11,6 +11,7 @@ import {
   ComposerQuickActions
 } from "../inputs/smart-input/composer/ComposerSplash.js";
 import { IntelligenceIndicator } from "../../../surfaces/runtime/intelligence.js";
+const SPLASH_PLACEHOLDER = "How can I help you today?";
 function NewChatGreeting({
   sourceConversationId,
   surfaceKey,
@@ -35,7 +36,7 @@ function NewChatGreeting({
       {
         conversationId: sourceConversationId,
         surfaceKey,
-        composer: { ...composer, size: "splash", placeholder: "How can I help you today?" }
+        composer: { ...composer, size: "splash", placeholder: SPLASH_PLACEHOLDER }
       }
     ) : /* @__PURE__ */ jsx(ChatSplashComposerShell, {}),
     /* @__PURE__ */ jsx(
@@ -60,7 +61,8 @@ function ChatSplashComposerShell() {
     "div",
     {
       "aria-hidden": true,
-      className: "h-[132px] w-full max-w-[760px] animate-pulse rounded-[22px] border border-border bg-card"
+      className: "h-[132px] w-full max-w-[760px] rounded-[22px] border border-border bg-card p-2 shadow-[0_2px_10px_rgba(0,0,0,0.05)]",
+      children: /* @__PURE__ */ jsx("div", { className: "px-1.5 py-1 text-[15px] leading-6 text-muted-foreground/60", children: SPLASH_PLACEHOLDER })
     }
   );
 }

package/dist/agents/components/chat/PinnedAgentsSection.d.ts

@@ -14,9 +14,12 @@ interface PinnedAgentsSectionProps {
  * with the rest of the app, and shares the agent registry with the dropdown
  * (no parallel fetches).
  *
- * The catalogue is asked for after the page is idle (see the effect below),
- * so the section is absent at first paint and appears once the list lands —
- * or sooner, when the person opens any agent picker.
+ * PINS READ ONLY THE PINS, AND ONLY ON SCREEN (2026-10-09). The section asks
+ * the catalog for the caller's starred rows (`ensureFavoriteRows`: `ues_list`,
+ * then `agx_get_list_full` filtered to those ids) once the section is actually
+ * visible (`useInView`) — never the whole catalogue, and never from a closed
+ * mobile sheet or collapsed rail. The full list loads only when a picker opens
+ * or the person searches agents; when it has, its rows answer here too.
  */
 export declare function PinnedAgentsSection({ activeAgentId, }: PinnedAgentsSectionProps): import("react").JSX.Element | null;
 export {};

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

@@ -5,18 +5,20 @@ import { useRouter, Link } from "../../../host/navigation.js";
 import { cn } from "@ai-matrx/design-system";
 import {
   FavoriteAgentButton,
+  useAgentCatalog,
   useAgentCatalogRows,
+  useAgentCatalogState,
   useAgentConsumer
 } from "@ai-matrx/agents/catalog/react";
 import { makeSelectFilteredAgents } from "@ai-matrx/agents/catalog";
 import { useAppStore } from "../../../store/hooks.js";
 import { stageChatAgentSwitch } from "./begin-fresh-chat.js";
-import { Button, DisclosureHeader } from "@ai-matrx/design-system/controls";
-import { ensureAgentCatalog } from "../../identity/agent-identity.js";
-import { whenPageIdle } from "@ai-matrx/kit/idle-scheduler";
+import { Button, DisclosureHeader, RegionSkeleton } from "@ai-matrx/design-system/controls";
+import { useInView } from "@ai-matrx/kit/hooks";
 const CONSUMER_ID = "chat-sidebar-pinned";
 const PINNED_COLLAPSED_LIMIT = 5;
 const selectPinnedAgents = makeSelectFilteredAgents();
+const selectFavoriteRowsStatus = (state) => state.favoriteRowsStatus;
 function pinnedAgentHref(agentId) {
   return `/chat/a/${encodeURIComponent(agentId)}`;
 }
@@ -26,13 +28,13 @@ function PinnedAgentsSection({
   const router = useRouter();
   const store = useAppStore();
   const consumer = useAgentConsumer(CONSUMER_ID);
+  const catalog = useAgentCatalog();
+  const favoriteRowsStatus = useAgentCatalogState(selectFavoriteRowsStatus);
+  const [visibleRef, visible] = useInView({ rootMargin: "64px" });
   useEffect(() => {
-    const controller = new AbortController();
-    void whenPageIdle(controller.signal).then((idle) => {
-      if (idle) void ensureAgentCatalog();
-    });
-    return () => controller.abort();
-  }, []);
+    if (!visible) return;
+    void catalog.ensureFavoriteRows().catch(() => void 0);
+  }, [catalog, visible]);
   useEffect(() => {
     if (consumer.favFilter !== "yes") consumer.setFavFilter("yes");
   }, [consumer]);
@@ -42,7 +44,26 @@ function PinnedAgentsSection({
   const [showAll, setShowAll] = useState(false);
   const hasMorePins = pinned.length > PINNED_COLLAPSED_LIMIT;
   const visiblePins = showAll || !hasMorePins ? pinned : pinned.slice(0, PINNED_COLLAPSED_LIMIT);
-  if (pinned.length === 0) return null;
+  if (pinned.length === 0) {
+    if (!visible) {
+      return /* @__PURE__ */ jsx("div", { ref: visibleRef, "aria-hidden": "true" });
+    }
+    if (favoriteRowsStatus === "idle" || favoriteRowsStatus === "loading") {
+      return /* @__PURE__ */ jsx("div", { className: "shrink-0 border-b border-border px-2 py-1.5", children: /* @__PURE__ */ jsx(RegionSkeleton, { shape: "rows", count: 2, "aria-label": "Loading pinned agents" }) });
+    }
+    if (favoriteRowsStatus === "failed") {
+      return /* @__PURE__ */ jsx("div", { className: "shrink-0 border-b border-border px-2 py-1.5", children: /* @__PURE__ */ jsx(
+        Button,
+        {
+          variant: "quiet",
+          className: "w-full",
+          onClick: () => void catalog.ensureFavoriteRows().catch(() => void 0),
+          children: "Pinned agents did not load. Retry"
+        }
+      ) });
+    }
+    return null;
+  }
   return /* @__PURE__ */ jsxs("div", { className: "shrink-0 border-b border-border", children: [
     /* @__PURE__ */ jsx(
       DisclosureHeader,

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

@@ -44,5 +44,5 @@ interface SmartAgentInputProps {
      */
     composer: ComposerPresentation;
 }
-export declare function SmartAgentInput({ conversationId, uploadRoot, uploadPath, enablePasteImages, compact, showSendButton, showVariableIcon, surfaceKey, draftAlias, disableSend, variablesPanelStyle, contextRailPresentation, contextRailAttachedItems, extraRightControls, surfaceValueAnchors, composer, }: SmartAgentInputProps): React.JSX.Element;
+export declare function SmartAgentInput({ conversationId, uploadRoot, uploadPath, enablePasteImages, compact, showSendButton, showVariableIcon, surfaceKey, draftAlias, disableSend, variablesPanelStyle, contextRailPresentation, contextRailAttachedItems, extraRightControls, surfaceValueAnchors, composer, }: SmartAgentInputProps): React.JSX.Element | null;
 export {};

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

@@ -5,6 +5,7 @@ import { useAppDispatch, useAppSelector } from "../../../../store/hooks.js";
 import { setVariablesPanelStyle } from "../../../redux/execution-system/instance-ui-state/instance-ui-state.slice.js";
 import { SmartAgentInputStacked } from "./SmartAgentInputStacked.js";
 import { InboxQueueStrip } from "./InboxQueueStrip.js";
+import { selectMessagesUnreadableReason } from "../../../redux/execution-system/messages/messages.selectors.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";
@@ -45,11 +46,19 @@ function SmartAgentInput({
   );
   const heldSentence = useConversationHeld(conversationId);
   const sendDisabled = disableSend || ambientHasNothingToSend || heldSentence !== null;
+  const unreadableReason = useAppSelector((state) => {
+    if (!conversationId) return null;
+    const reason = selectMessagesUnreadableReason(conversationId)(state);
+    return reason === "private" || reason === "removed" ? reason : null;
+  });
   const viewerCanReply = useAppSelector(
     (state) => conversationId ? selectViewerCanReply(conversationId)(state) : true
   );
   const variableIconShown = showVariableIcon && variablesPanelStyle !== "hidden";
   const queueStrip = conversationId && !isLauncher ? /* @__PURE__ */ jsx(InboxQueueStrip, { conversationId }) : null;
+  if (unreadableReason) {
+    return null;
+  }
   if (conversationId && !viewerCanReply) {
     return /* @__PURE__ */ jsx(ViewOnlyComposerBar, {});
   }

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

@@ -110,8 +110,7 @@ function ComposerQuickActions({
       observer.disconnect();
     };
   }, [actions.length]);
-  if (!organizationId) return null;
-  if (knob === void 0) {
+  if (!organizationId || knob === void 0) {
     return /* @__PURE__ */ jsx(ComposerQuickActionsSkeleton, { className });
   }
   if (actions.length === 0) return null;

package/dist/agents/components/inputs/variable-input-variations/AgentVariableForm.js

@@ -12,7 +12,6 @@ import {
 } from "../../../redux/execution-system/instance-variable-values/instance-variable-values.selectors.js";
 import { setUserVariableValue } from "../../../redux/execution-system/instance-variable-values/instance-variable-values.slice.js";
 import { selectShowVariablePanel } from "../../../redux/execution-system/instance-ui-state/instance-ui-state.selectors.js";
-import { toggleVariablePanel } from "../../../redux/execution-system/instance-ui-state/instance-ui-state.slice.js";
 import { Label } from "@ai-matrx/design-system";
 import { Input, DisclosureHeader } from "@ai-matrx/design-system/controls";
 import { Switch } from "../../../../ui/switch.js";
@@ -46,6 +45,7 @@ function AgentVariableForm({ conversationId }) {
   );
   const userValues = useAppSelector(selectUserVariableValues(conversationId));
   const showVariables = useAppSelector(selectShowVariablePanel(conversationId));
+  const [open, setOpen] = useState(true);
   if (!definitions || definitions.length === 0) return null;
   if (!showVariables) return null;
   const filledCount = definitions.filter((def) => {
@@ -59,14 +59,14 @@ function AgentVariableForm({ conversationId }) {
     /* @__PURE__ */ jsx(
       DisclosureHeader,
       {
-        open: showVariables,
-        onClick: () => dispatch(toggleVariablePanel(conversationId)),
+        open,
+        onClick: () => setOpen((v) => !v),
         chevron: "end",
-        title: showVariables ? "Fill in the details below" : `${filledCount}/${definitions.length} details provided`,
+        title: open ? "Fill in the details below" : `${filledCount}/${definitions.length} details provided`,
         className: "shrink-0"
       }
     ),
-    showVariables && /* @__PURE__ */ jsxs("div", { className: "border-t border-border flex-1 min-h-0 overflow-y-auto", children: [
+    open && /* @__PURE__ */ jsxs("div", { className: "border-t border-border flex-1 min-h-0 overflow-y-auto", children: [
       /* @__PURE__ */ jsx(BoundVariableChips, { conversationId }),
       /* @__PURE__ */ jsx("div", { className: "px-2.5 py-2", children: visibleDefs.map((def, i) => /* @__PURE__ */ jsxs("div", { children: [
         i > 0 && /* @__PURE__ */ jsx("div", { className: "border-t border-border my-2" }),

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

@@ -8,6 +8,7 @@ import { StaleDataNotice } from "../../../host/ui-slots.js";
 import {
   selectConversationMessages,
   selectMessagesHydrationFailure,
+  selectMessagesUnreadableReason,
   selectVisibleMessageGroupLimit
 } from "../../redux/execution-system/messages/messages.selectors.js";
 import {
@@ -32,7 +33,8 @@ import { AgentAssistantMessage } from "./assistant/AgentAssistantMessage.js";
 import { AgentEmptyMessageDisplay } from "./assistant/AgentEmptyMessageDisplay.js";
 import { ErrorBoundaryWithCapture } from "../../../host/ui-slots.js";
 import { ExampleTurnsGroup } from "../../message-flags/ExampleTurnsGroup.js";
-import { Pin } from "lucide-react";
+import { Lock, Pin, Trash2 } from "lucide-react";
+import { EmptyState } from "@ai-matrx/design-system/controls";
 import {
   hydratePinnedMessages,
   usePendingPinMessageIds,
@@ -63,6 +65,10 @@ function AgentConversationDisplay({
   const hydrationFailure = useAppSelector(
     selectMessagesHydrationFailure(conversationId)
   );
+  const unreadableReason = useAppSelector((state) => {
+    const reason = selectMessagesUnreadableReason(conversationId)(state);
+    return reason === "private" || reason === "removed" ? reason : null;
+  });
   const phase = useAppSelector(selectStreamPhase(conversationId));
   const latestRequestId = useAppSelector(selectLatestRequestId(conversationId));
   const visibleGroupLimit = useAppSelector(
@@ -206,6 +212,22 @@ function AgentConversationDisplay({
   ]);
   const resolveMenuContext = (target) => resolveMarkdownContext(target, conversationId);
   if (displayGroups.length === 0) {
+    if (unreadableReason) {
+      return /* @__PURE__ */ jsx("div", { className: "p-4", children: unreadableReason === "private" ? /* @__PURE__ */ jsx(
+        EmptyState,
+        {
+          icon: /* @__PURE__ */ jsx(Lock, { className: "h-5 w-5" }),
+          title: "Private chat",
+          line: "Only its owner can open it"
+        }
+      ) : /* @__PURE__ */ jsx(
+        EmptyState,
+        {
+          icon: /* @__PURE__ */ jsx(Trash2, { className: "h-5 w-5" }),
+          title: "Chat deleted"
+        }
+      ) });
+    }
     if (hydrationFailure) {
       return /* @__PURE__ */ jsx("div", { className: "p-4", children: /* @__PURE__ */ jsx(
         StaleDataNotice,

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

@@ -232,17 +232,7 @@ function AgentConversationColumn({
       ),
       children: [
         /* @__PURE__ */ jsxs("div", { className: "relative flex-1 min-h-0", children: [
-          showLanding ? /* @__PURE__ */ jsx(
-            motion.div,
-            {
-              className: "absolute inset-0 overflow-y-auto",
-              initial: { opacity: 0 },
-              animate: { opacity: 1 },
-              transition: { duration: 0.2 },
-              children: landingContent
-            },
-            "landing"
-          ) : /* @__PURE__ */ jsxs(
+          showLanding ? /* @__PURE__ */ jsx("div", { className: "absolute inset-0 overflow-y-auto", children: landingContent }, "landing") : /* @__PURE__ */ jsxs(
             motion.div,
             {
               ref: scrollRef,

package/dist/agents/redux/execution-system/messages/messages.selectors.d.ts

@@ -8,7 +8,7 @@
  * python-generated discriminated union).
  */
 import type { ChatRootState } from "../../../../store/root-state.js";
-import { type MessageRecord } from "./messages.slice.js";
+import { type ConversationUnreadableReason, type MessageRecord } from "./messages.slice.js";
 import type { ContentSegment } from "../active-requests/active-requests.selectors.js";
 import { type MessagePart, type RenderBlockPayload } from "@ai-matrx/agents/generated/stream-events";
 import type { ApiEndpointMode } from "../../../types/instance.types.js";
@@ -69,6 +69,8 @@ export declare const selectHasMessages: (conversationId: string) => (state: Chat
  * including a genuinely empty conversation.
  */
 export declare const selectMessagesHydrationFailure: (conversationId: string) => (state: ChatRootState) => string | null;
+/** `private` / `removed` when the conversation is not this person's to read. */
+export declare const selectMessagesUnreadableReason: (conversationId: string) => (state: ChatRootState) => ConversationUnreadableReason | null;
 export declare const selectMessageContent: (conversationId: string, messageId: string) => (state: ChatRootState) => MessageRecord["content"] | undefined;
 export declare const selectMessageStatus: (conversationId: string, messageId: string) => (state: ChatRootState) => MessageRecord["status"] | undefined;
 export declare const selectMessageClientStatus: (conversationId: string, messageId: string) => (state: ChatRootState) => MessageRecord["_clientStatus"] | undefined;

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

@@ -1,5 +1,7 @@
 import { createSelector } from "@reduxjs/toolkit";
-import { nextTranscriptPosition } from "./messages.slice.js";
+import {
+  nextTranscriptPosition
+} from "./messages.slice.js";
 import { normalizeContentBlocks } from "../utils/normalize-content-blocks.js";
 import { isAttachmentMessagePart } from "../../../components/context-items/normalize.js";
 import {
@@ -58,6 +60,7 @@ const selectMessageCount = (conversationId) => (state) => state.messages.byConve
 const selectNextMessagePosition = (conversationId) => (state) => nextTranscriptPosition(state.messages.byConversationId[conversationId]);
 const selectHasMessages = (conversationId) => (state) => (state.messages.byConversationId[conversationId]?.orderedIds?.length ?? 0) > 0;
 const selectMessagesHydrationFailure = (conversationId) => (state) => state.messages.byConversationId[conversationId]?.hydrationFailure ?? null;
+const selectMessagesUnreadableReason = (conversationId) => (state) => state.messages.byConversationId[conversationId]?.unreadableReason ?? null;
 const selectMessageContent = (conversationId, messageId) => (state) => state.messages.byConversationId[conversationId]?.byId?.[messageId]?.content;
 const selectMessageStatus = (conversationId, messageId) => (state) => state.messages.byConversationId[conversationId]?.byId?.[messageId]?.status;
 const selectMessageClientStatus = (conversationId, messageId) => (state) => state.messages.byConversationId[conversationId]?.byId?.[messageId]?._clientStatus;
@@ -626,6 +629,7 @@ export {
   selectMessageStreamRequestId,
   selectMessagesHydrationFailure,
   selectMessagesInterleavedRuns,
+  selectMessagesUnreadableReason,
   selectNextMessagePosition,
   selectOldestLoadedPosition,
   selectOrderedMessageIds,

package/dist/agents/redux/execution-system/messages/messages.slice.d.ts

@@ -252,7 +252,21 @@ export interface MessagesEntry {
      * conversation leaves it `null`. Cleared by any successful `hydrateMessages`.
      */
     hydrationFailure: string | null;
+    /**
+     * Why a reopen read came back empty, when that is not a failure:
+     *   - `missing`: the server never saved it (a chat whose first turn was never
+     *     sent). It opens as an empty new chat; callers that wait for a row to
+     *     appear read this instead of a failure.
+     *   - `private`: it exists and belongs to someone else.
+     *   - `removed`: it was deleted.
+     * A retry can never change `private`/`removed`, so the transcript says what
+     * is true instead of offering "Try again" and the composer is absent. Set by
+     * `loadConversation`; cleared by any successful `hydrateMessages`.
+     */
+    unreadableReason: ConversationUnreadableReason | null;
 }
+/** Why a held conversation id cannot be read by this person. */
+export type ConversationUnreadableReason = "missing" | "private" | "removed";
 export interface MessagesState {
     byConversationId: Record<string, MessagesEntry>;
 }
@@ -359,6 +373,9 @@ export declare const initInstanceMessages: import("@reduxjs/toolkit").ActionCrea
 }, "messages/setConversationLabel">, setMessagesHydrationFailure: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
     conversationId: string;
     failure: string | null;
-}, "messages/setMessagesHydrationFailure">, clearMessages: import("@reduxjs/toolkit").ActionCreatorWithPayload<string, "messages/clearMessages">;
+}, "messages/setMessagesHydrationFailure">, setMessagesUnreadable: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    conversationId: string;
+    reason: ConversationUnreadableReason | null;
+}, "messages/setMessagesUnreadable">, clearMessages: import("@reduxjs/toolkit").ActionCreatorWithPayload<string, "messages/clearMessages">;
 declare const _default: import("redux").Reducer<MessagesState>;
 export default _default;

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

@@ -81,7 +81,8 @@ function getOrCreate(state, conversationId, apiEndpointMode = "agent") {
       hasMoreOlder: false,
       isLoadingOlder: false,
       visibleGroupLimit: null,
-      hydrationFailure: null
+      hydrationFailure: null,
+      unreadableReason: null
     };
     state.byConversationId[conversationId] = entry;
   }
@@ -379,6 +380,7 @@ const messagesSlice = createSlice({
       }
       entry.isLoadingOlder = false;
       entry.hydrationFailure = null;
+      entry.unreadableReason = null;
     },
     /**
      * Prepend an older page of messages to the transcript. **Strictly
@@ -487,6 +489,13 @@ const messagesSlice = createSlice({
       const entry = getOrCreate(state, conversationId);
       entry.hydrationFailure = failure;
     },
+    /** Record that this conversation is not this person's to read. */
+    setMessagesUnreadable(state, action) {
+      const { conversationId, reason } = action.payload;
+      const entry = getOrCreate(state, conversationId);
+      entry.unreadableReason = reason;
+      if (reason) entry.hydrationFailure = null;
+    },
     /** Clear the transcript (e.g. auto-clear on a new run). */
     clearMessages(state, action) {
       const entry = state.byConversationId[action.payload];
@@ -544,6 +553,7 @@ const {
   removeMessage,
   setConversationLabel,
   setMessagesHydrationFailure,
+  setMessagesUnreadable,
   clearMessages
 } = messagesSlice.actions;
 var messages_slice_default = messagesSlice.reducer;
@@ -563,6 +573,7 @@ export {
   sentWithRequest,
   setConversationLabel,
   setMessagesHydrationFailure,
+  setMessagesUnreadable,
   setOlderLoading,
   setVisibleGroupLimit,
   shouldCreateOptimisticUserMessage,

package/dist/agents/redux/execution-system/thunks/continue-agent-json.d.ts

@@ -22,7 +22,7 @@ import type { RequestInitiation } from "../../../types/instance.types.js";
 import type { Resource } from "../../../resources/types.js";
 import { type HostTurnInput } from "./execute-instance.thunk.js";
 import { type AdoptedAgentJsonOptions, type HeadlessAgentJsonResult } from "./run-headless-agent-json.js";
-export interface ContinueAgentJsonOptions extends Pick<AdoptedAgentJsonOptions, "surfaceKey" | "timeoutMs" | "pollIntervalMs" | "settleMs" | "expect" | "onResult" | "signal" | "failureMessages"> {
+export interface ContinueAgentJsonOptions extends Pick<AdoptedAgentJsonOptions, "surfaceKey" | "timeoutMs" | "pollIntervalMs" | "settleMs" | "expect" | "onResult" | "signal" | "failureMessages" | "onAwaitingPerson" | "personWaitMs"> {
     conversationId: string;
     /** What the person typed for this turn. Exclusive with `hostTurn`. */
     userInput?: string;

package/dist/agents/redux/execution-system/thunks/continue-agent-json.js

@@ -54,7 +54,9 @@ async function continueAgentJson(dispatch, getState, opts) {
       ...opts.expect ? { expect: opts.expect } : {},
       ...opts.onResult ? { onResult: opts.onResult } : {},
       ...opts.signal ? { signal: opts.signal } : {},
-      ...opts.failureMessages ? { failureMessages: opts.failureMessages } : {}
+      ...opts.failureMessages ? { failureMessages: opts.failureMessages } : {},
+      ...opts.onAwaitingPerson ? { onAwaitingPerson: opts.onAwaitingPerson } : {},
+      ...opts.personWaitMs !== void 0 ? { personWaitMs: opts.personWaitMs } : {}
     });
   } catch (err) {
     const message = err instanceof Error ? err.message : String(err);

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

@@ -81,6 +81,18 @@ export interface FetchBundleOptions {
 }
 declare function describeSupabaseError(err: unknown): Record<string, unknown>;
 export { describeSupabaseError };
+/**
+ * Why a conversation id this person holds read back empty, asked only after
+ * the bundle RPC answered NULL:
+ *   - `missing` — the server never saved it (an id minted in a browser whose
+ *     first turn was never sent). Nothing to load and nothing wrong.
+ *   - `removed` — it was deleted.
+ *   - `private` — it exists and belongs to someone else (AI chat is Private).
+ * `null` when the question itself could not be answered — the caller then
+ * keeps the honest "couldn't load" state.
+ */
+export type ConversationEmptyReadReason = "missing" | "removed" | "private";
+export declare function fetchConversationUnreadableReason(conversationId: string): Promise<ConversationEmptyReadReason | null>;
 /**
  * Fetches a page of conversation history via `get_cx_conversation_bundle`.
  * Falls back to direct table queries when the RPC is unavailable (dev DBs

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

@@ -19,6 +19,27 @@ function describeSupabaseError(err) {
   }
   return { raw: err };
 }
+async function fetchConversationUnreadableReason(conversationId) {
+  try {
+    const { data, error } = await supabase.schema("chat").rpc("conversation_unreadable_reason", {
+      p_conversation_id: conversationId
+    });
+    if (error) {
+      console.error(
+        "[conversation-bundle] conversation_unreadable_reason failed:",
+        describeSupabaseError(error)
+      );
+      return null;
+    }
+    return data === "missing" || data === "removed" || data === "private" ? data : null;
+  } catch (err) {
+    console.error(
+      "[conversation-bundle] conversation_unreadable_reason threw:",
+      describeSupabaseError(err)
+    );
+    return null;
+  }
+}
 async function fetchConversationBundle(conversationId, options = {}) {
   const {
     messageLimit = 50,
@@ -295,6 +316,7 @@ export {
   describeSupabaseError,
   extractBundleToolCalls,
   fetchConversationBundle,
+  fetchConversationUnreadableReason,
   messageRowToRecord,
   requestRowToRecord,
   toolCallRowToRecord,

package/dist/agents/redux/execution-system/thunks/load-conversation.thunk.js

@@ -13,7 +13,8 @@ import {
 } from "../conversations/conversations.slice.js";
 import {
   hydrateMessages,
-  setMessagesHydrationFailure
+  setMessagesHydrationFailure,
+  setMessagesUnreadable
 } from "../messages/messages.slice.js";
 import { reconcileMessagesArtifacts } from "../../../../host/ui-slots.js";
 import {
@@ -62,6 +63,7 @@ import {
 import { loadCodeEditHistoryThunk } from "../../../../host/ui-slots.js";
 import {
   CONVERSATION_NOT_MATERIALIZED,
+  fetchConversationUnreadableReason,
   fetchConversationBundle,
   describeSupabaseError,
   extractBundleToolCalls,
@@ -118,12 +120,26 @@ const loadConversation = createAsyncThunk(
       if (err?.code === CONVERSATION_NOT_MATERIALIZED) {
         void historyPromise.catch?.(() => void 0);
         if (expectMaterialized) {
-          dispatch(
-            setMessagesHydrationFailure({
-              conversationId,
-              failure: NOT_READABLE_DETAIL
-            })
-          );
+          const reason = await fetchConversationUnreadableReason(conversationId);
+          if ((getState().messages.byConversationId[conversationId]?.orderedIds?.length ?? 0) > 0) {
+            return { conversationId };
+          }
+          if (reason) {
+            if (reason === "missing") {
+              console.info(
+                "[loadConversation] %s was never saved \u2014 opening it as a new chat",
+                conversationId
+              );
+            }
+            dispatch(setMessagesUnreadable({ conversationId, reason }));
+          } else {
+            dispatch(
+              setMessagesHydrationFailure({
+                conversationId,
+                failure: NOT_READABLE_DETAIL
+              })
+            );
+          }
         }
         return { conversationId };
       }

package/dist/agents/redux/execution-system/thunks/run-headless-agent-json.d.ts

@@ -168,6 +168,19 @@ export interface HeadlessAgentJsonOptions {
      * discards. Pair it with `onResult` so an unmounting surface still persists.
      */
     signal?: AbortSignal;
+    /**
+     * THE RUN IS WAITING ON THE PERSON, NOT FAILED. The turn ended parked on a question
+     * (`ask_person`, or a server park on a person): its answer is the turn that resumes once
+     * they answer. The wait pauses `timeoutMs`, fires this once so the surface can say so and
+     * show the question, re-reads the conversation when the ask closes (answered here, in
+     * another tab or by text), and resolves from the resumed turn. Bounded by `personWaitMs`.
+     */
+    onAwaitingPerson?: (info: {
+        requestId: string;
+        conversationId: string;
+    }) => void;
+    /** Ceiling on waiting for the person once a run parks on them. Default 6h; `signal` stops it sooner. */
+    personWaitMs?: number;
     /** Fires with the conversation id BEFORE the stream runs (live UI handle). */
     onConversationCreated?: (conversationId: string) => void;
     /**
@@ -271,6 +284,8 @@ export interface HeadlessAgentJsonResult {
      * from a failure that carries its own reason.
      */
     noResult?: boolean;
+    /** `true` when the run ended parked on the person and stopped waiting before they answered. */
+    awaitingPerson?: boolean;
 }
 /**
  * 🚨 A WARNED CHOICE THAT ANSWERS WITHOUT A REQUIRED KEY FAILS PLAINLY.
@@ -333,6 +348,10 @@ export interface AdoptedAgentJsonOptions {
     onResult?: HeadlessAgentJsonOptions["onResult"];
     /** Stop waiting and harvest — same contract as `HeadlessAgentJsonOptions.signal`. */
     signal?: AbortSignal;
+    /** Same contract as `HeadlessAgentJsonOptions.onAwaitingPerson`. */
+    onAwaitingPerson?: HeadlessAgentJsonOptions["onAwaitingPerson"];
+    /** Same contract as `HeadlessAgentJsonOptions.personWaitMs`. */
+    personWaitMs?: number;
     /** Per-feature user-facing failure copy. */
     failureMessages?: HeadlessAgentJsonOptions["failureMessages"];
     /** See `deferNoJsonCapture` on `HeadlessAgentJsonOptions`. */

package/dist/agents/redux/execution-system/thunks/run-headless-agent-json.js

@@ -8,10 +8,17 @@ import {
   selectExtractedJson,
   selectFirstExtractedObject,
   selectJsonExtractionComplete,
+  selectRequestAwaitingPerson,
   selectRequestError,
   selectRequestStatus,
   selectRenderBlocksByType
 } from "../active-requests/active-requests.selectors.js";
+import {
+  selectLatestAnswerText as selectCommittedAnswerText,
+  selectLatestAssistantMessageId
+} from "../messages/messages.selectors.js";
+import { countOpenAsksForConversation } from "../../../runtime-reconnect/parked-on-person.js";
+import { rereadAndFollow } from "../../../runtime-reconnect/reread-and-follow.js";
 import {
   selectLatestAnswerText,
   selectLatestRequestId
@@ -44,6 +51,10 @@ function safeShape(err) {
 const DEFAULT_TIMEOUT_MS = 12e4;
 const DEFAULT_POLL_MS = 250;
 const DEFAULT_SETTLE_MS = 6e3;
+const DEFAULT_PERSON_WAIT_MS = 6 * 60 * 6e4;
+const RECONNECT_WAIT_MS = 5 * 6e4;
+const isConnectionLoss = (errorType) => errorType === "transport_lost" || errorType === "heartbeat_timeout";
+const PERSON_ASK_POLL_MS = 1e4;
 const DEFAULT_MESSAGES = {
   streamError: "The agent failed before returning a result.",
   noJson: "The agent finished but produced no structured JSON.",
@@ -243,6 +254,8 @@ async function adoptHeadlessAgentJson(dispatch, getState, opts) {
       msgs,
       expect: opts.expect ?? "json",
       ...opts.signal ? { signal: opts.signal } : {},
+      ...opts.onAwaitingPerson ? { onAwaitingPerson: opts.onAwaitingPerson } : {},
+      personWaitMs: opts.personWaitMs ?? DEFAULT_PERSON_WAIT_MS,
       deferNoJsonCapture: opts.deferNoJsonCapture === true
     });
   } catch (err) {
@@ -388,6 +401,8 @@ async function launchAndWait(dispatch, getState, opts) {
       msgs,
       expect: opts.expect ?? "json",
       ...opts.signal ? { signal: opts.signal } : {},
+      ...opts.onAwaitingPerson ? { onAwaitingPerson: opts.onAwaitingPerson } : {},
+      personWaitMs: opts.personWaitMs ?? DEFAULT_PERSON_WAIT_MS,
       deferNoJsonCapture: opts.deferNoJsonCapture === true
     });
   } catch (err) {
@@ -549,13 +564,45 @@ async function waitForExtraction(dispatch, getState, args) {
       ...base()
     };
   };
+  const answerSince = (state) => {
+    if (!state.messages) return `live\0${selectLatestAnswerText(conversationId)(state)}`;
+    const committed = selectCommittedAnswerText(conversationId)(state);
+    if (committed.trim()) return `${selectLatestAssistantMessageId(conversationId)(state) ?? ""}\0${committed}`;
+    return `live\0${selectLatestAnswerText(conversationId)(state)}`;
+  };
+  const unanswered = (why) => ({
+    success: false,
+    data: null,
+    error: why === "timeout" ? "Your agent's question was not answered in time." : "Stopped waiting for your answer.",
+    awaitingPerson: true,
+    ...base()
+  });
+  const startMarker = answerSince(getState());
+  let lostAt = null;
+  const reconnectedAnswer = () => {
+    const marker = answerSince(getState());
+    if (marker === startMarker) return null;
+    return fuzzyFallback(marker.slice(marker.indexOf("\0") + 1));
+  };
+  let person = null;
   try {
-    while (Date.now() - start < args.timeoutMs) {
+    while (person ? Date.now() - person.since < args.personWaitMs : Date.now() - start < args.timeoutMs || lostAt !== null && Date.now() - lostAt < RECONNECT_WAIT_MS) {
       if (args.signal?.aborted) {
-        return settle("aborted", noResultMsg);
+        return person ? unanswered("aborted") : settle("aborted", noResultMsg);
       }
       const state = getState();
       const status = selectRequestStatus(requestId)(state);
+      if (lostAt !== null) {
+        const recovered = reconnectedAnswer();
+        if (recovered != null) return { success: true, data: recovered, ...base() };
+      }
+      if (status === "error" && isConnectionLoss(selectRequestError(requestId)(state)?.error_type)) {
+        lostAt ??= Date.now();
+        if (Date.now() - lostAt < RECONNECT_WAIT_MS) {
+          await sleep(args.pollMs);
+          continue;
+        }
+      }
       if (status === "error") {
         const reqError = selectRequestError(requestId)(state);
         const { data } = resolveRunData(getState, requestId, conversationId);
@@ -572,6 +619,44 @@ async function waitForExtraction(dispatch, getState, args) {
           ...base()
         };
       }
+      if (!person && status !== void 0 && TERMINAL_STATUSES.has(status) && selectRequestAwaitingPerson(requestId)(state)) {
+        person = {
+          since: Date.now(),
+          baseline: answerSince(state),
+          askedAt: Date.now(),
+          following: false,
+          changedAt: null
+        };
+        try {
+          args.onAwaitingPerson?.({ requestId, conversationId });
+        } catch (err) {
+          console.error("[runHeadlessAgentJson] onAwaitingPerson threw", err);
+        }
+      }
+      if (person) {
+        const now = Date.now();
+        if (!person.following && now - person.askedAt >= PERSON_ASK_POLL_MS) {
+          person.askedAt = now;
+          try {
+            if (await countOpenAsksForConversation(conversationId) === 0) {
+              person.following = true;
+              await rereadAndFollow(dispatch, conversationId, "runHeadlessAgentJson: the ask closed");
+            }
+          } catch {
+          }
+        }
+        const now2 = getState();
+        const marker = answerSince(now2);
+        const answer = marker.slice(marker.indexOf("\0") + 1);
+        if (answer.trim() && marker !== person.baseline) {
+          const data = fuzzyFallback(answer);
+          if (data != null) return { success: true, data, ...base() };
+          person.changedAt ??= now;
+          if (now - person.changedAt > args.settleMs) return settle("stream-ended", noResultMsg);
+        }
+        await sleep(args.pollMs);
+        continue;
+      }
       if (selectJsonExtractionComplete(requestId)(state)) {
         return settle("extraction-complete", noResultMsg);
       }
@@ -586,6 +671,18 @@ async function waitForExtraction(dispatch, getState, args) {
       }
       await sleep(args.pollMs);
     }
+    if (person) return unanswered("timeout");
+    if (lostAt !== null && selectRequestStatus(requestId)(getState()) === "error") {
+      const reqError = selectRequestError(requestId)(getState());
+      const { data } = resolveRunData(getState, requestId, conversationId);
+      return {
+        success: false,
+        data,
+        error: reqError?.user_message ?? reqError?.message ?? msgs.streamError,
+        ...reqError?.error_type ? { errorDetail: reqError.error_type } : {},
+        ...base()
+      };
+    }
     return settle("timeout", msgs.timeout);
   } finally {
     dispatch(releaseRequestForViewer({ requestId, viewerId }));

package/dist/ui/markdown-stream/EnhancedChatMarkdown.js

@@ -5,6 +5,7 @@ import { useState, useEffect, useLayoutEffect, useMemo, useCallback, useRef } fr
 import { cn } from "@ai-matrx/design-system";
 import { WIDE_FIGURE_HOST_CLASS, WIDE_FIGURE_PROSE_CLIP_CLASS } from "../../agents/components/shared/assistant-message-layout.js";
 import { splitContentIntoBlocksV2 } from "@ai-matrx/rich-content/display/markdown-classification/processors/utils/content-splitter-v2";
+import { isWaitingForFirstContent } from "./waiting-for-content.js";
 import { renderSettledFromRecord, settledOneShotBlocks } from "@ai-matrx/rich-content/display/chat-markdown/settle-stream-blocks";
 import { expandTextBlocksInList } from "@ai-matrx/rich-content/display/markdown-classification/processors/utils/expand-text-blocks";
 import { reuseUnchangedBlocks } from "@ai-matrx/rich-content/display/chat-markdown/stable-blocks";
@@ -316,13 +317,19 @@ const EnhancedChatMarkdownInternal = ({
   const currentContent = editedContent ?? resolvedContent;
   const hasRequestOrTaskId = requestId || taskId;
   const hasReceivedNonTextContent = serverProcessedBlocks && serverProcessedBlocks.length > 0 || hasReduxRenderBlocks;
-  const isWaitingForContent = hasRequestOrTaskId && !resolvedContent.trim() && !hasReceivedNonTextContent;
-  const hasUnifiedSpecial = !settledFromRecord && (streamSlotStart !== void 0 || streamSlotEnd !== void 0 || agentCallId !== void 0 || unifiedSlots.some(
-    (s) => s.kind === "tool" || s.kind === "status" || s.kind === "error" || s.kind === "thinking" || s.kind === "render_block" && blockCarriesDataNotText(renderBlocksMap[s.blockId])
-  ));
   const hasDbInterleavedSpecial = messageInterleavedContent.some(
     (s) => s.type === "db_tool" || s.type === "thinking"
   );
+  const isWaitingForContent = isWaitingForFirstContent({
+    hasRequestOrTaskId: !!hasRequestOrTaskId,
+    resolvedContent,
+    hasReceivedNonTextContent: !!hasReceivedNonTextContent,
+    settledFromRecord,
+    recordHasNonText: hasDbInterleavedSpecial
+  });
+  const hasUnifiedSpecial = !settledFromRecord && (streamSlotStart !== void 0 || streamSlotEnd !== void 0 || agentCallId !== void 0 || unifiedSlots.some(
+    (s) => s.kind === "tool" || s.kind === "status" || s.kind === "error" || s.kind === "thinking" || s.kind === "render_block" && blockCarriesDataNotText(renderBlocksMap[s.blockId])
+  ));
   const toolLifecycleMapSelector = useMemo(
     () => requestId ? selectToolLifecycleMap(requestId) : () => void 0,
     [requestId]

package/dist/ui/markdown-stream/waiting-for-content.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Is this assistant turn still waiting for its first content (the "Processing…" shimmer)?
+ *
+ * A turn that ENDED on a tool call with no text — an `ask_person` parked on the person — is
+ * settled: its record holds the call, and the call is what the person must see. Before this rule
+ * the empty text kept the shimmer up forever over the question it was hiding (the Applet
+ * builder, live 2026-10-09: "Processing…" while the server waited on a choose_one ask).
+ */
+export declare function isWaitingForFirstContent(args: {
+    hasRequestOrTaskId: boolean;
+    resolvedContent: string;
+    hasReceivedNonTextContent: boolean;
+    settledFromRecord: boolean;
+    recordHasNonText: boolean;
+}): boolean;

package/dist/ui/markdown-stream/waiting-for-content.js

@@ -0,0 +1,10 @@
+function isWaitingForFirstContent(args) {
+  if (!args.hasRequestOrTaskId) return false;
+  if (args.resolvedContent.trim()) return false;
+  if (args.hasReceivedNonTextContent) return false;
+  if (args.settledFromRecord && args.recordHasNonText) return false;
+  return true;
+}
+export {
+  isWaitingForFirstContent
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.7.22",
+  "version": "0.7.24",
   "description": "THE one AI Matrx person-to-agent chat system: the full chat (running agents, conversations, tool calls, streaming, context, surfaces, voice) as explicit per-module subpaths @ai-matrx/chat/<domain>/<module> (no wildcards: scripts/public-modules.json) over a host contract (/host, /host/react) whose only required value is a db. One chat, one renderer: the old kernel entries (., /external-store, /matrx, /react, /tools, styles.css, tokens.css) are retired.",
   "type": "module",
   "license": "MIT",
@@ -4681,25 +4681,25 @@
     "server-only": "^0.0.1",
     "uuid": "^14.0.2",
     "zod": "^4.6.5",
+    "@ai-matrx/agents": "latest",
+    "@ai-matrx/alchemy": "latest",
+    "@ai-matrx/associations": "latest",
     "@ai-matrx/browser-audio": "latest",
     "@ai-matrx/canvas": "latest",
-    "@ai-matrx/associations": "latest",
     "@ai-matrx/content-ir": "latest",
-    "@ai-matrx/agents": "latest",
-    "@ai-matrx/alchemy": "latest",
+    "@ai-matrx/content-ir-react": "latest",
+    "@ai-matrx/data": "latest",
     "@ai-matrx/design-system": "latest",
+    "@ai-matrx/icons": "latest",
+    "@ai-matrx/diff": "latest",
     "@ai-matrx/kit": "latest",
     "@ai-matrx/media": "latest",
     "@ai-matrx/print": "latest",
-    "@ai-matrx/diff": "latest",
     "@ai-matrx/realtime": "latest",
     "@ai-matrx/records": "latest",
     "@ai-matrx/records-ui": "latest",
     "@ai-matrx/rich-content": "latest",
-    "@ai-matrx/data": "latest",
-    "@ai-matrx/rich-editor": "latest",
-    "@ai-matrx/content-ir-react": "latest",
-    "@ai-matrx/icons": "latest"
+    "@ai-matrx/rich-editor": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
@@ -4818,5 +4818,5 @@
     "check:side-effects": "node ../scripts/check-side-effects-listed.mjs . && node ../scripts/check-side-effects-listed.mjs --self-test",
     "check:public-surface": "node ./scripts/sync-public-surface.mjs --check && node ./scripts/sync-public-surface.mjs --self-test"
   },
-  "gitHead": "ec969cf6169fd1c376feb4eb7e4ec3e5aa07e607"
+  "gitHead": "cab8d9bc66fa516a57684222b15e62677a35d4fa"
 }