@ai-matrx/chat 0.7.23 → 0.7.24

package/CHANGELOG.md

@@ -1,8 +1,23 @@
 # @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
@@ -30,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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.7.23",
+  "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,16 +4681,17 @@
     "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/alchemy": "latest",
     "@ai-matrx/canvas": "latest",
     "@ai-matrx/content-ir": "latest",
     "@ai-matrx/content-ir-react": "latest",
     "@ai-matrx/data": "latest",
     "@ai-matrx/design-system": "latest",
-    "@ai-matrx/diff": "latest",
     "@ai-matrx/icons": "latest",
+    "@ai-matrx/diff": "latest",
     "@ai-matrx/kit": "latest",
     "@ai-matrx/media": "latest",
     "@ai-matrx/print": "latest",
@@ -4698,8 +4699,7 @@
     "@ai-matrx/records": "latest",
     "@ai-matrx/records-ui": "latest",
     "@ai-matrx/rich-content": "latest",
-    "@ai-matrx/rich-editor": "latest",
-    "@ai-matrx/agents": "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": "39aa4a6200282fa60c92b648157a3627a13b5083"
+  "gitHead": "cab8d9bc66fa516a57684222b15e62677a35d4fa"
 }