@ai-matrx/chat 0.4.7 → 0.4.8

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @ai-matrx/chat
 
+## 0.4.8
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/chat/v0.4.7..npm/chat/v0.4.8 -- apps/shared/chat`).
+No source changes intended and no consumer action required.
+
 ## 0.4.7
 
 - The host-source column test gets an explicit 120s budget: the column now renders the real text engine

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

@@ -5,7 +5,11 @@ import {
   classifyUsageRefusal
 } from "../../../../host/usage-gate.js";
 import { parseNdjsonStream } from "../../../../host/server/stream-parser.js";
-import { isStreamTransportLost, StreamTransportError } from "@ai-matrx/agents/matrx";
+import {
+  isStreamTransportLost,
+  readStreamCursor,
+  StreamTransportError
+} from "@ai-matrx/agents/matrx";
 import { monitorStream } from "@ai-matrx/data/net";
 import { mintClientTempId } from "@ai-matrx/kit/ids";
 import { withPerformedScript } from "../../../speech-script/types.js";
@@ -139,15 +143,7 @@ import { getCapabilitiesForConversation } from "../../../runtime/get-model-capab
 import { toast } from "../../../../host/notify.js";
 import { isDirectiveApplyEvent } from "@ai-matrx/agents/envelope";
 import { proposeDirective } from "../../proposed-directives/proposedDirectivesSlice.js";
-function readTransportCursor(event) {
-  if (typeof event !== "object" || event === null || !("stream_seq" in event) || typeof event.stream_seq !== "number" || !Number.isSafeInteger(event.stream_seq) || event.stream_seq <= 0) {
-    return null;
-  }
-  return {
-    streamId: "stream_id" in event && typeof event.stream_id === "string" && event.stream_id.length > 0 ? event.stream_id : null,
-    streamSeq: event.stream_seq
-  };
-}
+const readTransportCursor = readStreamCursor;
 function renderBlockToContentType(type) {
   if (type === "image" || type === "image_output") return "image";
   if (type === "audio_output") return "audio";
@@ -349,6 +345,7 @@ async function processStream({
   let pendingTransportCursor = null;
   const batchedDispatch = (action) => dispatch(autoBatched(action));
   let reasoningLeakReported = false;
+  let serverStructuredData = null;
   const runJsonExtraction = (isFinal) => {
     if (!jsonTracker) return;
     const req = getState().activeRequests.byRequestId[requestId];
@@ -367,10 +364,22 @@ async function processStream({
     const jsonState = isFinal ? jsonTracker.finalize() : jsonTracker.getState();
     if (isFinal || jsonState.revision !== lastJsonRevision) {
       lastJsonRevision = jsonState.revision;
+      const clientResults = jsonState.results.map(toSnapshot);
+      const results = serverStructuredData ? [
+        toSnapshot({
+          value: serverStructuredData,
+          type: Array.isArray(serverStructuredData) ? "array" : "object",
+          source: "whole-string",
+          isComplete: true,
+          repairApplied: false,
+          warnings: ["Server structured_output payload"]
+        }),
+        ...clientResults
+      ] : clientResults;
       batchedDispatch(
         updateExtractedJson({
           requestId,
-          results: jsonState.results.map(toSnapshot),
+          results,
           revision: jsonState.revision,
           isComplete: isFinal
         })
@@ -1920,6 +1929,10 @@ async function processStream({
             );
           } else if (isStructuredOutputEvent(event)) {
             otherEvents++;
+            if (event.data.success && event.data.data != null && typeof event.data.data === "object") {
+              serverStructuredData = event.data.data;
+              runJsonExtraction(false);
+            }
             dispatch(
               appendTimeline({
                 requestId,

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

@@ -276,6 +276,8 @@ export interface HeadlessAgentJsonResult {
  * result passes through untouched.
  */
 export declare function failWarnedOutputMissingKeys(getState: () => ChatRootState, opts: Pick<HeadlessAgentJsonOptions, "mandateKey" | "surfaceKey" | "expect">, result: HeadlessAgentJsonResult): Promise<HeadlessAgentJsonResult>;
+/** The first JSON object in `text` that holds EVERY required key, or null. */
+export declare function recoverByRequiredKeys(text: string | undefined, required: readonly string[]): Record<string, unknown> | null;
 /**
  * The plain sentence of a warned-holder failure (`failWarnedOutputMissingKeys`),
  * or `null` for any other result. A lane that swallows failures to `null`

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

@@ -1,4 +1,4 @@
-import { extractFirstJson } from "@ai-matrx/kit/json-extract";
+import { extractAllJson, extractFirstJson } from "@ai-matrx/kit/json-extract";
 import { extractErrorMessage } from "@ai-matrx/data/net";
 import { destroyInstanceIfAllowed } from "../conversations/conversations.thunks.js";
 import { captureError } from "../../../../host/diagnostics.js";
@@ -129,13 +129,18 @@ async function failWarnedOutputMissingKeys(getState, opts, result) {
   if (required.length === 0) return result;
   let missing;
   if (result.success && isRecord) {
-    const record = data;
-    const answers = typeof record.answers === "object" && record.answers !== null && !Array.isArray(record.answers) ? record.answers : null;
-    missing = required.filter((key) => !(key in record) && !(answers && key in answers));
+    missing = missingRequiredKeys(data, required);
   } else {
     missing = [...required];
   }
   if (missing.length === 0) return result;
+  const recovered = recoverByRequiredKeys(result.fullResponse, required);
+  if (recovered) {
+    console.warn(
+      `[runHeadlessAgentJson] ${opts.surfaceKey}: the first JSON read lacked ${missing.join(", ")}; a candidate in the answer holding every required key was used instead.`
+    );
+    return { ...result, success: true, data: recovered, noResult: false, error: void 0, errorDetail: void 0 };
+  }
   const warning = resolved.outputWarnings[0];
   const holderId = warning.holderId ?? resolved.agentId;
   let holderName;
@@ -174,6 +179,21 @@ async function failWarnedOutputMissingKeys(getState, opts, result) {
     errorDetail: `mandate_output_unusable: missing ${keys}`
   };
 }
+function missingRequiredKeys(record, required) {
+  const answers = typeof record.answers === "object" && record.answers !== null && !Array.isArray(record.answers) ? record.answers : null;
+  return required.filter((key) => !(key in record) && !(answers && key in answers));
+}
+function recoverByRequiredKeys(text, required) {
+  if (!text || required.length === 0) return null;
+  for (const candidate of extractAllJson(text, { allowFuzzy: true })) {
+    const value = candidate.value;
+    if (typeof value !== "object" || value === null || Array.isArray(value)) continue;
+    if (missingRequiredKeys(value, required).length === 0) {
+      return value;
+    }
+  }
+  return null;
+}
 function mandateOutputUnusableSentence(result) {
   if (result.success) return null;
   if (!result.errorDetail?.startsWith("mandate_output_unusable")) return null;
@@ -565,5 +585,6 @@ export {
   failWarnedOutputMissingKeys,
   livePosture,
   mandateOutputUnusableSentence,
+  recoverByRequiredKeys,
   runHeadlessAgentJson
 };

package/dist/agents/runtime-reconnect/reconnect-server-operation.thunk.js

@@ -1,7 +1,11 @@
 import { retryReconnect } from "./retry-reconnect.js";
 import { discardRetainedTransportConsumer } from "../redux/execution-system/thunks/process-stream.js";
 import { createAsyncThunk } from "@reduxjs/toolkit";
-import { runtimeOperationRejoinPath, settleRunPickup } from "@ai-matrx/agents/matrx";
+import {
+  pickServerJobOperation,
+  runtimeOperationRejoinPath,
+  settleRunPickup
+} from "@ai-matrx/agents/matrx";
 import { toast } from "../../host/notify.js";
 import { captureError } from "../../host/diagnostics.js";
 import { setRequestStatus } from "../redux/execution-system/active-requests/active-requests.slice.js";
@@ -77,8 +81,9 @@ const reconnectServerOperation = createAsyncThunk(
         clearFollower();
         return noFollow;
       }
-      op = byLink?.operations.find((o) => !o.is_terminal) ?? null;
-      settledWhileDisconnected = !op && Boolean(byLink?.operations.length);
+      const picked = pickServerJobOperation(byLink?.operations);
+      op = picked && !picked.is_terminal ? picked : null;
+      settledWhileDisconnected = Boolean(picked?.is_terminal);
     } catch (err) {
       const superseded = ctrl.signal.aborted || !stillOwner();
       clearFollower();
@@ -263,9 +268,8 @@ const reconnectServerOperation = createAsyncThunk(
           clearFollower();
           return noFollow;
         }
-        const stillLive = refreshed?.operations.find(
-          (operation) => !operation.is_terminal
-        );
+        const latest = pickServerJobOperation(refreshed?.operations);
+        const stillLive = latest && !latest.is_terminal ? latest : null;
         if (stillLive) {
           if (followers.get(conversationId) === ctrl) {
             followers.delete(conversationId);

package/dist/host/defaults/prefs.d.ts

@@ -23,14 +23,22 @@ export declare const PREFERENCE_FIELDS: Readonly<Record<string, keyof ChatPrefer
 export declare function createUnhostedKnobs(): ChatKnobsPort;
 export declare const CHAT_PREFS_PREFIX = "ai-matrx-chat:";
 export declare function createWebPrefs(): ChatPrefsPort;
+/** A host-kept prefs port, plus the late arrival of the host's saved values. */
+export interface HostKeptPrefs extends ChatPrefsPort {
+    /**
+     * The host's saved values arrived after the port was made (read over a socket or IPC). A key
+     * already written this session keeps the newer value; every other key is set and announced.
+     */
+    load(values: Readonly<Record<string, string>>): void;
+}
 /**
  * A prefs port the HOST keeps (HOST-OWNED-SOURCE-PLAN §2.2 "Drafts"): a page whose origin
  * changes between launches (a local host on a new port, a desktop window) cannot keep drafts in
- * web storage. The host reads its saved values once (`initial`) and receives every change
- * (`persist`, `null` = removed) to write where it keeps them — a file, an IPC store. Reads are
- * synchronous from memory, so the first render already sees the saved draft.
+ * web storage. The host hands its saved values in (`initial`, or `load` when they arrive later)
+ * and receives every change (`persist`, `null` = removed) to write where it keeps them — a file,
+ * an IPC store. Reads are synchronous from memory.
  */
 export declare function createHostKeptPrefs(options: {
-    initial: Readonly<Record<string, string>>;
+    initial?: Readonly<Record<string, string>>;
     persist: (key: string, value: string | null) => void;
-}): ChatPrefsPort;
+}): HostKeptPrefs;

package/dist/host/defaults/prefs.js

@@ -169,12 +169,14 @@ function createWebPrefs() {
   return port;
 }
 function createHostKeptPrefs(options) {
-  const memory = new Map(Object.entries(options.initial));
+  const memory = new Map(Object.entries(options.initial ?? {}));
+  const written = /* @__PURE__ */ new Set();
   const listeners = /* @__PURE__ */ new Set();
   const emit = (key) => {
     for (const listener of listeners) listener(key);
   };
   const write = (key, value) => {
+    written.add(key);
     try {
       options.persist(key, value);
     } catch (error) {
@@ -206,7 +208,14 @@ function createHostKeptPrefs(options) {
     },
     knob: (key, fallback) => parseKnob(memory.get(key) ?? null, fallback),
     knobs: createUnhostedKnobs(),
-    snapshot: () => Object.fromEntries(memory)
+    snapshot: () => Object.fromEntries(memory),
+    load(values) {
+      for (const [key, value] of Object.entries(values)) {
+        if (written.has(key) || memory.get(key) === value) continue;
+        memory.set(key, value);
+        emit(key);
+      }
+    }
   };
   return port;
 }

package/dist/host/index.d.ts

@@ -10,7 +10,7 @@ export { createDbIdentity, SIGNED_OUT_IDENTITY } from "./defaults/identity.js";
 export { createNoPickerOrg, createStoredOrg, CHAT_ACTIVE_ORG_STORAGE_KEY } from "./defaults/org.js";
 export { createDefaultServer, DEFAULT_CHAT_SERVER_URL, } from "./defaults/server.js";
 export { createDomNotifier } from "./defaults/notify.js";
-export { createWebPrefs, createHostKeptPrefs, CHAT_PREFS_PREFIX } from "./defaults/prefs.js";
+export { createWebPrefs, createHostKeptPrefs, CHAT_PREFS_PREFIX, type HostKeptPrefs } from "./defaults/prefs.js";
 export { createWindowNavigation } from "./defaults/navigation.js";
 export { createUnhostedWindows } from "./defaults/windows.js";
 export { CHAT_WINDOWS, CHAT_WINDOW_IDS, DEFAULT_WINDOW_INSTANCE_ID, isChatWindowId, type ChatWindowId, } from "./windows.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.4.7",
+  "version": "0.4.8",
   "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",
@@ -226,17 +226,14 @@
     "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/agents": "latest",
     "@ai-matrx/content-ir": "latest",
-    "@ai-matrx/content-ir-react": "latest",
-    "@ai-matrx/data": "latest",
+    "@ai-matrx/associations": "latest",
+    "@ai-matrx/canvas": "latest",
     "@ai-matrx/design-system": "latest",
     "@ai-matrx/diff": "latest",
-    "@ai-matrx/icons": "latest",
     "@ai-matrx/kit": "latest",
     "@ai-matrx/media": "latest",
     "@ai-matrx/print": "latest",
@@ -245,6 +242,9 @@
     "@ai-matrx/records-ui": "latest",
     "@ai-matrx/rich-content": "latest",
     "@ai-matrx/rich-editor": "latest",
+    "@ai-matrx/data": "latest",
+    "@ai-matrx/content-ir-react": "latest",
+    "@ai-matrx/icons": "latest",
     "@ai-matrx/tap-target": "latest"
   },
   "devDependencies": {