@ai-matrx/chat 0.7.9 → 0.7.10

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @ai-matrx/chat
 
+## 0.7.10
+### a refused answer is a failed run (lane M3)
+
+- **`useHeadlessAgentJson.run`**: when `coerce` refuses the answer the model gave, the run is recorded as failed
+  (`chat.user_request` status `failed`, `error` = the reason, `metadata.output_refused`) through the guarded
+  `mergeJsonColumn` write (`recordRunOutputRefused`); a write that does not land is a `console.error`. Before, the run
+  stayed `completed` with `error` null forever. The error is re-thrown unchanged for the surface to say plainly.
+- **Consumer action:** none.
+
 ## 0.7.9
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see
@@ -15,6 +24,11 @@ No source changes intended and no consumer action required.
 ## 0.7.7
 ### Unreleased
 
+- **No first-load layout shift from assistant messages** (spend register item 32): `AgentAssistantMessage` no longer swaps a fixed-height
+  skeleton for the markdown after 140 ms (measured CLS 0.48 on the run page). Persisted answers render in place on first paint.
+  `deferColdMarkdown` is removed from `AgentAssistantMessage`, `AssistantTurnGroup` and `AgentConversationDisplay` (the column keeps its
+  own history staging). **Consumer action:** none.
+
 - **`continueAgentJson`** (`agents/redux/execution-system/thunks/continue-agent-json`): the NEXT turn of a
   conversation whose first turn ran headlessly, waited on like the first (`adoptHeadlessAgentJson`). A turn is
   the person's words (`userInput`) or a turn the HOST writes (`hostTurn` — sent as `host_turn`, never

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

@@ -8,9 +8,8 @@ interface AgentConversationDisplayProps {
      */
     surfaceKey?: string;
     compact?: boolean;
-    deferColdMarkdown?: boolean;
     fallbackVisibleGroupLimit?: number | null;
     bottomPinned?: boolean;
 }
-export declare function AgentConversationDisplay({ conversationId, surfaceKey, compact, deferColdMarkdown, fallbackVisibleGroupLimit, bottomPinned, }: AgentConversationDisplayProps): import("react").JSX.Element;
+export declare function AgentConversationDisplay({ conversationId, surfaceKey, compact, fallbackVisibleGroupLimit, bottomPinned, }: AgentConversationDisplayProps): import("react").JSX.Element;
 export {};

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

@@ -53,7 +53,6 @@ function AgentConversationDisplay({
   conversationId,
   surfaceKey,
   compact = false,
-  deferColdMarkdown = false,
   fallbackVisibleGroupLimit = null,
   bottomPinned = false
 }) {
@@ -262,8 +261,7 @@ function AgentConversationDisplay({
                 isStreamActive: false,
                 surfaceKey,
                 compact: true,
-                hideActionBar: true,
-                deferColdMarkdown
+                hideActionBar: true
               },
               member.messageId
             )
@@ -307,8 +305,7 @@ function AgentConversationDisplay({
               isStreamActive: group.isStreamActive,
               surfaceKey,
               compact,
-              canRetry: group.canRetry,
-              deferColdMarkdown
+              canRetry: group.canRetry
             }
           )
         },
@@ -327,8 +324,7 @@ function AgentConversationDisplay({
             conversationId,
             surfaceKey,
             compact,
-            members: group.members,
-            deferColdMarkdown
+            members: group.members
           }
         )
       },

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

@@ -33,8 +33,6 @@ export interface AgentAssistantMessageProps {
      * button. Retry is non-destructive (the failed turn stays in history).
      */
     canRetry?: boolean;
-    /** Chat cold-load only: show a short text skeleton before DB markdown mounts. */
-    deferColdMarkdown?: boolean;
     /**
      * False for the intermediate iterations of a multi-step agentic turn. Only
      * the LAST member of a turn carries the answer, so only it may say "this run
@@ -43,4 +41,4 @@ export interface AgentAssistantMessageProps {
      */
     isTurnAnswer?: boolean;
 }
-export declare function AgentAssistantMessage({ conversationId, requestId, messageId, isStreamActive, recordMessageIds, streamSlotStart, streamSlotEnd, surfaceKey, hideActionBar, canRetry, deferColdMarkdown, isTurnAnswer, }: AgentAssistantMessageProps): import("react").JSX.Element;
+export declare function AgentAssistantMessage({ conversationId, requestId, messageId, isStreamActive, recordMessageIds, streamSlotStart, streamSlotEnd, surfaceKey, hideActionBar, canRetry, isTurnAnswer, }: AgentAssistantMessageProps): import("react").JSX.Element;

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

@@ -1,7 +1,6 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import {
-  startTransition,
   useCallback,
   useMemo,
   useState,
@@ -117,7 +116,6 @@ function AgentAssistantMessage({
   surfaceKey,
   hideActionBar = false,
   canRetry = false,
-  deferColdMarkdown = false,
   isTurnAnswer = true
 }) {
   useDebugContext("AgentAssistantMessage");
@@ -137,17 +135,7 @@ function AgentAssistantMessage({
   }, [surfaceKey, conversationId, messageId, requestId, isStreamActive]);
   const dispatch = useAppDispatch();
   const [retrying, setRetrying] = useState(false);
-  const shouldDeferColdMarkdown = deferColdMarkdown && !requestId && !!messageId && !isStreamActive;
-  const [coldMarkdownSettledMessageId, setColdMarkdownSettledMessageId] = useState(null);
-  const coldMarkdownReady = !shouldDeferColdMarkdown || coldMarkdownSettledMessageId === messageId;
   const [providerRetryBusyAction, setProviderRetryBusyAction] = useState(null);
-  useEffect(() => {
-    if (!shouldDeferColdMarkdown || !messageId) return void 0;
-    const timer = window.setTimeout(() => {
-      startTransition(() => setColdMarkdownSettledMessageId(messageId));
-    }, 140);
-    return () => window.clearTimeout(timer);
-  }, [shouldDeferColdMarkdown, messageId]);
   const { captureRef, isCapturing, captureAsPDF } = useDomCapturePrint();
   const handleFullPrint = useCallback(() => {
     captureAsPDF({
@@ -308,7 +296,6 @@ function AgentAssistantMessage({
       rowParts: extractContentBlocks(record)
     }),
     failed,
-    coldMarkdownReady,
     messageId,
     renderedText,
     attachmentCount: attachmentParts.length,
@@ -394,7 +381,7 @@ function AgentAssistantMessage({
       "data-message-id": messageId ?? void 0,
       className: "group/assistant-msg rounded transition-shadow",
       children: [
-        !coldMarkdownReady ? /* @__PURE__ */ jsx(AssistantMarkdownSkeleton, {}) : bufferStream && isStreamActive && !failed ? /* @__PURE__ */ jsxs(Fragment, { children: [
+        bufferStream && isStreamActive && !failed ? /* @__PURE__ */ jsxs(Fragment, { children: [
           showProviderRetry && providerRetry && /* @__PURE__ */ jsx(
             ProviderRetryCard,
             {
@@ -538,15 +525,6 @@ function readErrorDoor(details) {
   const { label, href } = door;
   return typeof label === "string" && typeof href === "string" && href.startsWith("/") ? { label, href } : null;
 }
-function AssistantMarkdownSkeleton() {
-  return /* @__PURE__ */ jsxs("div", { className: "space-y-2 py-1", "aria-hidden": true, children: [
-    /* @__PURE__ */ jsx("div", { className: "h-3.5 w-[96%] animate-pulse rounded bg-muted/55" }),
-    /* @__PURE__ */ jsx("div", { className: "h-3.5 w-[88%] animate-pulse rounded bg-muted/50" }),
-    /* @__PURE__ */ jsx("div", { className: "h-3.5 w-[72%] animate-pulse rounded bg-muted/45" }),
-    /* @__PURE__ */ jsx("div", { className: "h-3.5 w-[94%] animate-pulse rounded bg-muted/40" }),
-    /* @__PURE__ */ jsx("div", { className: "h-3.5 w-[42%] animate-pulse rounded bg-muted/35" })
-  ] });
-}
 export {
   AgentAssistantMessage
 };

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

@@ -16,7 +16,6 @@ interface AssistantTurnGroupProps {
     compact?: boolean;
     /** Every assistant member of this logical turn, in transcript order. */
     members: AssistantTurnGroupMember[];
-    deferColdMarkdown?: boolean;
 }
-export declare function AssistantTurnGroup({ conversationId, surfaceKey, compact, members: rawMembers, deferColdMarkdown, }: AssistantTurnGroupProps): import("react").JSX.Element;
+export declare function AssistantTurnGroup({ conversationId, surfaceKey, compact, members: rawMembers, }: AssistantTurnGroupProps): import("react").JSX.Element;
 export {};

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

@@ -26,8 +26,7 @@ function AssistantTurnGroup({
   conversationId,
   surfaceKey,
   compact = false,
-  members: rawMembers,
-  deferColdMarkdown = false
+  members: rawMembers
 }) {
   const { captureRef, isCapturing, captureAsPDF } = useDomCapturePrint();
   const persistedView = useAppSelector(
@@ -96,8 +95,7 @@ function AssistantTurnGroup({
                 surfaceKey,
                 compact,
                 hideActionBar: true,
-                isTurnAnswer: idx === members.length - 1 && m.streamSlotEnd === void 0,
-                deferColdMarkdown: deferColdMarkdown && idx < members.length - 1
+                isTurnAnswer: idx === members.length - 1 && m.streamSlotEnd === void 0
               }
             ) }, m.key))
           }

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

@@ -113,8 +113,6 @@ export interface AnswerlessTurnInput {
     isStreamActive: boolean;
     /** True when the turn failed — the error path owns that case. */
     failed: boolean;
-    /** False while a cold-load skeleton stands in for the persisted markdown. */
-    coldMarkdownReady: boolean;
     /** `cx_message.id`; null/undefined until the row settles. */
     messageId: string | null | undefined;
     /** The text this turn renders (citation markers included). */

package/dist/agents/components/messages-display/assistant/answerless-turn.js

@@ -31,7 +31,6 @@ function isAnswerlessTurn(input) {
   if (input.isStreamActive) return false;
   if (input.awaitingPerson) return false;
   if (input.failed) return false;
-  if (!input.coldMarkdownReady) return false;
   if (!input.messageId) return false;
   if (input.attachmentCount > 0) return false;
   if (input.mediaBlockCount > 0) return false;

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

@@ -299,7 +299,6 @@ function AgentConversationColumn({
                         {
                           conversationId: displayId,
                           surfaceKey,
-                          deferColdMarkdown,
                           bottomPinned: shouldPinColdScroll,
                           fallbackVisibleGroupLimit: deferColdMarkdown ? chatVisibleGroupLimit ?? CHAT_INITIAL_VISIBLE_GROUPS : null
                         }

package/dist/agents/hooks/useHeadlessAgentJson.js

@@ -3,6 +3,7 @@ import { useCallback, useState } from "react";
 import { useAppDispatch, useAppSelector, useAppStore } from "../../store/hooks.js";
 import { selectConversationRequestIds } from "../redux/execution-system/active-requests/active-requests.selectors.js";
 import { useRetainRequestForViewer } from "../redux/execution-system/active-requests/useRetainRequestForViewer.js";
+import { recordRunOutputRefused } from "../redux/execution-system/thunks/record-run-output-refused.js";
 import {
   runHeadlessAgentJson
 } from "../redux/execution-system/thunks/run-headless-agent-json.js";
@@ -49,7 +50,14 @@ function useHeadlessAgentJson() {
           ...result.conversationId ? { conversationId: result.conversationId } : {}
         });
       }
-      return opts.coerce ? opts.coerce(result.data, result) : result.data;
+      if (!opts.coerce) return result.data;
+      try {
+        return opts.coerce(result.data, result);
+      } catch (refused) {
+        const why = refused instanceof Error ? refused.message : String(refused);
+        if (result.requestId) void recordRunOutputRefused(result.requestId, why);
+        throw refused;
+      }
     } catch (e) {
       const message = e instanceof Error ? e.message : "Failed to run the agent";
       setError(message);

package/dist/agents/redux/execution-system/thunks/record-run-output-refused.d.ts

@@ -0,0 +1,14 @@
+/**
+ * recordRunOutputRefused — a run whose answer the BROWSER refused is a failed run.
+ *
+ * The server marks a run `completed` the moment the model stops; whether the answer was usable is only
+ * known where it is read (the feature's `coerce`, its own check). Before this, such a run stayed
+ * `completed` with `error` null forever (Make's describe box, 2026-10-09: "personal" is not one of
+ * organization, individual). The refusal is written onto the run's own `chat.user_request` row —
+ * status `failed`, `error` = the reason, and `metadata.output_refused` — through the guarded
+ * read-modify-write (`mergeJsonColumn`, a version guard, never a blind update).
+ *
+ * Never silent: a write that does not land is a `console.error` naming the run.
+ */
+export declare const OUTPUT_REFUSED_METADATA_KEY = "output_refused";
+export declare function recordRunOutputRefused(requestId: string, reason: string): Promise<boolean>;

package/dist/agents/redux/execution-system/thunks/record-run-output-refused.js

@@ -0,0 +1,24 @@
+import { mergeJsonColumn } from "@ai-matrx/data/db";
+import { supabase } from "../../../../host/db.js";
+import { hasBrowserSession } from "../../../../host/identity.js";
+const OUTPUT_REFUSED_METADATA_KEY = "output_refused";
+async function recordRunOutputRefused(requestId, reason) {
+  if (!requestId || !await hasBrowserSession()) return false;
+  const result = await mergeJsonColumn({
+    fetchCurrent: () => supabase.schema("chat").from("user_request").select("id, version, metadata").eq("id", requestId).maybeSingle(),
+    readColumn: (row) => row.metadata,
+    merge: (current) => ({ ...current, [OUTPUT_REFUSED_METADATA_KEY]: { reason, at: (/* @__PURE__ */ new Date()).toISOString() } }),
+    applyUpdate: ({ value, expectedVersion, nextVersion }) => supabase.schema("chat").from("user_request").update({ metadata: value, version: nextVersion, status: "failed", error: reason.slice(0, 500) }).eq("id", requestId).eq("version", expectedVersion).select("id, version, metadata").maybeSingle()
+  });
+  if (result.status !== "saved") {
+    console.error(
+      `[run-output-refused] Could not record the refusal on run ${requestId}: ` + (result.status === "error" ? String(result.error) : `write ${result.status}`) + `. The run still reads as completed. Reason: ${reason}`
+    );
+    return false;
+  }
+  return true;
+}
+export {
+  OUTPUT_REFUSED_METADATA_KEY,
+  recordRunOutputRefused
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.7.9",
+  "version": "0.7.10",
   "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/content-ir": "latest",
-    "@ai-matrx/data": "latest",
-    "@ai-matrx/design-system": "latest",
-    "@ai-matrx/kit": "latest",
-    "@ai-matrx/media": "latest",
+    "@ai-matrx/content-ir-react": "latest",
+    "@ai-matrx/agents": "latest",
     "@ai-matrx/icons": "latest",
-    "@ai-matrx/print": "latest",
     "@ai-matrx/diff": "latest",
+    "@ai-matrx/media": "latest",
+    "@ai-matrx/kit": "latest",
+    "@ai-matrx/print": "latest",
     "@ai-matrx/realtime": "latest",
-    "@ai-matrx/records": "latest",
     "@ai-matrx/records-ui": "latest",
+    "@ai-matrx/design-system": "latest",
     "@ai-matrx/rich-content": "latest",
-    "@ai-matrx/rich-editor": "latest",
-    "@ai-matrx/content-ir-react": "latest"
+    "@ai-matrx/records": "latest",
+    "@ai-matrx/data": "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": "6f80fabd57ab4f61aa950c7e2d9b1f3309797abd"
+  "gitHead": "c1236d2d5f8a42087300bafce53317efb25700af"
 }