@ai-matrx/chat 0.3.2 → 0.3.3

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @ai-matrx/chat
 
+## 0.3.3 — 2026-10-07
+### Re-sync before matrx-frontend consumes the published package (P27)
+
+- Carries every
+  matrx-frontend `packages/chat` edit after `7f630d97d9`: a server-ended failed request is a failed turn
+  (`thunks/terminal-request-failure`, process-stream, messages selectors), agent autosave recovery.
+  Its suite needs the app's content-ir host, so it lives app-side with the other host suites.
+- Consumer action: none.
+
 ## 0.3.2
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/agents/hooks/useAgentAutoSave.js

@@ -90,9 +90,14 @@ function useAgentAutoSave(agentId) {
       try {
         const snapshot = { _dirty: true };
         if (record._dirtyFields) {
-          for (const field of Object.keys(
-            record._dirtyFields
-          )) {
+          const fields = new Set(
+            Object.keys(record._dirtyFields)
+          );
+          if (fields.has("modelId") || fields.has("settings")) {
+            fields.add("modelId");
+            fields.add("settings");
+          }
+          for (const field of fields) {
             snapshot[field] = readField(record, field);
           }
         }

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

@@ -169,6 +169,16 @@ export declare function extractInspectableText(record: MessageRecord | undefined
  * CONVERSATION_FAILURE_AND_RETRY_FE_GUIDE.md.
  */
 export declare function isFailedRecord(record: MessageRecord | undefined): boolean;
+/**
+ * The provider stop reason a reloaded turn was saved with, when it is NOT a
+ * normal finish — or null. A turn the provider stopped early can be saved as
+ * an ordinary `active` message with its partial text and only
+ * `metadata.finish_reason` telling the truth (a recitation stop, 2026-10-06);
+ * that row reloaded with no error at all.
+ */
+export declare function abnormalFinishReason(record: MessageRecord | undefined): string | null;
+/** The sentence a reloaded early-stopped turn shows. */
+export declare function earlyStopMessage(reason: string): string;
 /**
  * The persisted error text for a failed turn. Prefers the structured top-level
  * `error.message`; falls back to the legacy `metadata.error` string, then to

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

@@ -282,7 +282,33 @@ function isFailedRecord(record) {
   if (record.status === "failed") return true;
   if (record.error) return true;
   const md = record.metadata;
-  return !!md && typeof md === "object" && !Array.isArray(md) && md.failed === true;
+  if (!!md && typeof md === "object" && !Array.isArray(md) && md.failed === true) {
+    return true;
+  }
+  return abnormalFinishReason(record) !== null;
+}
+const NORMAL_FINISH_REASONS = /* @__PURE__ */ new Set([
+  "stop",
+  "end_turn",
+  "stop_sequence",
+  "tool_use",
+  "tool_calls",
+  "function_call",
+  "pause_turn",
+  "completed",
+  "success"
+]);
+function abnormalFinishReason(record) {
+  if (!record || record.role !== "assistant") return null;
+  const md = record.metadata;
+  if (!md || typeof md !== "object" || Array.isArray(md)) return null;
+  const reason = md.finish_reason;
+  if (typeof reason !== "string" || reason.length === 0) return null;
+  const normalized = reason.toLowerCase().replace(/^finishreason\./, "");
+  return NORMAL_FINISH_REASONS.has(normalized) ? null : normalized;
+}
+function earlyStopMessage(reason) {
+  return reason === "max_tokens" || reason === "length" ? "The response hit its length limit before it finished." : "The response was stopped early by the model provider, so it may be incomplete.";
 }
 function extractRecordError(record) {
   if (!record) return void 0;
@@ -294,6 +320,8 @@ function extractRecordError(record) {
     const err = md.error;
     if (typeof err === "string" && err.length > 0) return err;
   }
+  const stopped = abnormalFinishReason(record);
+  if (stopped) return earlyStopMessage(stopped);
   const flat = extractFlatText(record);
   return flat.length > 0 ? flat : void 0;
 }
@@ -545,6 +573,8 @@ const selectMessagesInterleavedRuns = (conversationId, messageIds) => {
 };
 export {
   EMPTY_CONVERSATION_MESSAGES,
+  abnormalFinishReason,
+  earlyStopMessage,
   extractAnswerDocumentText,
   extractContentBlocks,
   extractFlatText,

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

@@ -69,6 +69,10 @@ import {
   appendCitation
 } from "../active-requests/active-requests.slice.js";
 import { parseNormalizedCitation } from "../messages/message-citations.js";
+import {
+  terminalFailureFromCompletion,
+  terminalFailureFromRecordUpdate
+} from "./terminal-request-failure.js";
 import { confirmServerSync } from "../conversations/conversations.slice.js";
 import { receivedFsChange } from "../../../../host/ui-slots.js";
 import {
@@ -430,6 +434,17 @@ async function processStream({
       terminalTransportController.abort("post-terminal-grace");
     }, POST_TERMINAL_GRACE_MS);
   };
+  const failRequestFromTerminalStatus = (error) => {
+    if (!error) return;
+    if (getState().activeRequests.byRequestId[requestId]?.status === "error") {
+      return;
+    }
+    console.warn(
+      `[stream:${requestId.slice(0, 8)}] user request ended FAILED without an error event (${error.error_type}) \u2014 surfacing it as a failed turn.`
+    );
+    dispatch(setRequestStatus({ requestId, status: "error", error }));
+    dispatch(setInstanceStatus({ conversationId, status: "error" }));
+  };
   let lastTransportSeq = getState().activeRequests.byRequestId[requestId]?.lastTransportSeq ?? 0;
   let transportStreamId = getState().activeRequests.byRequestId[requestId]?.transportStreamId ?? null;
   let retainedEntry;
@@ -635,6 +650,7 @@ async function processStream({
             }
             if (d.operation === "user_request") {
               dispatch(setCompletion({ requestId, data: d }));
+              failRequestFromTerminalStatus(terminalFailureFromCompletion(d));
               completionStats = result;
               const totals = completionStats.total_usage?.total;
               if (totals) {
@@ -1664,6 +1680,7 @@ async function processStream({
                 refreshUserMessageWithoutBody(d.record_id);
               }
             } else if (d.table === "user_request") {
+              failRequestFromTerminalStatus(terminalFailureFromRecordUpdate(d));
               dispatch(
                 patchUserRequest({
                   id: d.record_id,

package/dist/agents/redux/execution-system/thunks/terminal-request-failure.d.ts

@@ -0,0 +1,27 @@
+/**
+ * A request that ENDED FAILED without an `error` event.
+ *
+ * The server has three ways to say a user request failed, and only one of
+ * them is the `error` event: a terminal failure it persisted on purpose (a
+ * provider safety / recitation stop, a model refusal, any finish-reason
+ * failure) is announced as a `user_request` completion with
+ * `status: "failed"` and/or a `record_update` moving the `user_request` row
+ * to `failed`, then a normal `end`. Before this module the stream treated
+ * both as bookkeeping, the `end` handler marked the request `complete`, and
+ * the turn showed NO error — while its half-written content (a flashcard set
+ * cut off by a recitation stop, 2026-10-06) sat there looking finished.
+ *
+ * Pure: reads the event payload, returns the `ErrorPayload` the request
+ * should carry, or null when the event is not a terminal failure. It never
+ * matches on the message TEXT (the server is free to reword it) — only on
+ * the operation/table, the status, and the structured fields.
+ */
+import type { CompletionPayload, ErrorPayload, RecordUpdatePayload } from "@ai-matrx/agents/generated/stream-events";
+/** error_type when the server sent no structured one. */
+export declare const TERMINAL_FAILURE_ERROR_TYPE = "request_failed";
+/** Shown when the server said "failed" and nothing more. */
+export declare const TERMINAL_FAILURE_FALLBACK_MESSAGE = "The response stopped before it finished.";
+/** A `user_request` completion whose status is not success. */
+export declare function terminalFailureFromCompletion(d: CompletionPayload): ErrorPayload | null;
+/** A `record_update` moving the `user_request` row to `failed`. */
+export declare function terminalFailureFromRecordUpdate(d: RecordUpdatePayload): ErrorPayload | null;

package/dist/agents/redux/execution-system/thunks/terminal-request-failure.js

@@ -0,0 +1,56 @@
+const TERMINAL_FAILURE_ERROR_TYPE = "request_failed";
+const TERMINAL_FAILURE_FALLBACK_MESSAGE = "The response stopped before it finished.";
+function asRecord(value) {
+  return value && typeof value === "object" && !Array.isArray(value) ? value : null;
+}
+function readStructuredError(raw) {
+  if (typeof raw === "string") {
+    const trimmed = raw.trim();
+    if (trimmed.startsWith("{")) {
+      try {
+        return readStructuredError(JSON.parse(trimmed));
+      } catch {
+      }
+    }
+    return { errorType: null, message: trimmed || null };
+  }
+  const obj = asRecord(raw);
+  if (!obj) return { errorType: null, message: null };
+  const errorType = typeof obj.error_type === "string" ? obj.error_type : typeof obj.type === "string" ? obj.type : null;
+  const message = typeof obj.user_message === "string" && obj.user_message ? obj.user_message : typeof obj.message === "string" && obj.message ? obj.message : null;
+  return { errorType, message };
+}
+function buildPayload(source, fields, finishReason) {
+  const structured = readStructuredError(fields?.error);
+  const errorType = structured.errorType ?? (typeof fields?.error_type === "string" ? fields.error_type : null) ?? TERMINAL_FAILURE_ERROR_TYPE;
+  const message = structured.message ?? TERMINAL_FAILURE_FALLBACK_MESSAGE;
+  return {
+    error_type: errorType,
+    message,
+    user_message: message,
+    details: {
+      source,
+      ...finishReason ? { finish_reason: finishReason } : {},
+      ...typeof fields?.reason === "string" ? { reason: fields.reason } : {}
+    }
+  };
+}
+function terminalFailureFromCompletion(d) {
+  if (d.operation !== "user_request" || d.status !== "failed") return null;
+  const result = asRecord(d.result);
+  const metadata = asRecord(result?.metadata);
+  const finishReason = typeof result?.finish_reason === "string" ? result.finish_reason : null;
+  return buildPayload("completion", metadata ?? result, finishReason);
+}
+function terminalFailureFromRecordUpdate(d) {
+  if (d.table !== "user_request" || d.status !== "failed") return null;
+  const metadata = asRecord(d.metadata);
+  const finishReason = typeof metadata?.finish_reason === "string" ? metadata.finish_reason : null;
+  return buildPayload("record_update", metadata, finishReason);
+}
+export {
+  TERMINAL_FAILURE_ERROR_TYPE,
+  TERMINAL_FAILURE_FALLBACK_MESSAGE,
+  terminalFailureFromCompletion,
+  terminalFailureFromRecordUpdate
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.3.2",
+  "version": "0.3.3",
   "description": "THE one AI Matrx person-to-agent chat system: the full chat (running agents, conversations, tool calls, streaming, context, surfaces, voice) as per-module subpaths @ai-matrx/chat/<domain>/<module> over a host contract (/host, /host/react) whose only required value is a db; plus the kernel compatibility entries (., /external-store, /matrx, /react, /tools, styles.css, tokens.css) until P28.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -201,24 +201,24 @@
     "server-only": "^0.0.1",
     "uuid": "^14.0.2",
     "zod": "^4.6.5",
-    "@ai-matrx/associations": "latest",
-    "@ai-matrx/browser-audio": "latest",
     "@ai-matrx/agents": "latest",
+    "@ai-matrx/browser-audio": "latest",
+    "@ai-matrx/associations": "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/design-system": "latest",
     "@ai-matrx/icons": "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/kit": "latest",
     "@ai-matrx/tap-target": "latest",
-    "@ai-matrx/alchemy": "latest",
-    "@ai-matrx/print": "latest"
+    "@ai-matrx/records": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",