@ai-matrx/chat 0.7.30 → 0.7.31

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @ai-matrx/chat
 
+## 0.7.31
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/chat/v0.7.30..npm/chat/v0.7.31 -- apps/shared/chat`).
+No source changes intended and no consumer action required.
+
 ## 0.7.30
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/agents/hooks/useComposerStructuredRun.d.ts

@@ -0,0 +1,20 @@
+import { type HeadlessAgentJsonResult } from "../redux/execution-system/thunks/run-headless-agent-json.js";
+export interface ComposerStructuredRunOptions<T> {
+    /** The conversation the page launched and the composer sends. */
+    conversationId: string | null | undefined;
+    /** Stable surface key (telemetry, the same key the launcher used). */
+    surfaceKey: string;
+    /** Variables the page supplies whole — hidden from the form, still sent. */
+    pageOwnedVariables?: readonly string[];
+    /** Narrow the extracted value; throw for an unusable answer. */
+    coerce: (value: unknown, result: HeadlessAgentJsonResult) => T;
+    /** The answer, once a sent run finishes and extracts. */
+    onResult: (answer: T, requestId: string) => void;
+    /** The run failed or its answer could not be used. */
+    onError: (message: string, requestId: string) => void;
+    /** A run the composer just sent (the page shows its own progress). */
+    onStart?: (requestId: string) => void;
+}
+export declare function useComposerStructuredRun<T>({ conversationId, surfaceKey, pageOwnedVariables, coerce, onResult, onError, onStart, }: ComposerStructuredRunOptions<T>): {
+    running: boolean;
+};

package/dist/agents/hooks/useComposerStructuredRun.js

@@ -0,0 +1,75 @@
+"use client";
+import { useEffect, useRef, useState } from "react";
+import { useAppDispatch, useAppSelector, useAppStore } from "../../store/hooks.js";
+import { selectLatestRequestId } from "../redux/execution-system/selectors/aggregate.selectors.js";
+import { setPageOwnedVariableNames } from "../redux/execution-system/instance-variable-values/instance-variable-values.slice.js";
+import {
+  adoptHeadlessAgentJson
+} from "../redux/execution-system/thunks/run-headless-agent-json.js";
+function useComposerStructuredRun({
+  conversationId,
+  surfaceKey,
+  pageOwnedVariables,
+  coerce,
+  onResult,
+  onError,
+  onStart
+}) {
+  const dispatch = useAppDispatch();
+  const store = useAppStore();
+  const [running, setRunning] = useState(false);
+  const latest = useAppSelector(
+    (state) => conversationId ? selectLatestRequestId(conversationId)(state) : void 0
+  );
+  const seen = useRef({
+    conversationId: null,
+    ids: /* @__PURE__ */ new Set()
+  });
+  const callbacks = useRef({ coerce, onResult, onError, onStart });
+  useEffect(() => {
+    callbacks.current = { coerce, onResult, onError, onStart };
+  });
+  const ownedKey = (pageOwnedVariables ?? []).join("\0");
+  useEffect(() => {
+    if (!conversationId || !ownedKey) return;
+    dispatch(setPageOwnedVariableNames({ conversationId, names: ownedKey.split("\0") }));
+  }, [dispatch, conversationId, ownedKey]);
+  useEffect(() => {
+    if (!conversationId) return;
+    if (seen.current.conversationId !== conversationId) {
+      seen.current = { conversationId, ids: new Set(latest ? [latest] : []) };
+      return;
+    }
+    if (!latest || seen.current.ids.has(latest)) return;
+    seen.current.ids.add(latest);
+    const requestId = latest;
+    setRunning(true);
+    callbacks.current.onStart?.(requestId);
+    void adoptHeadlessAgentJson(dispatch, store.getState, {
+      requestId,
+      conversationId,
+      surfaceKey,
+      expect: "json",
+      keepInstance: true
+    }).then((result) => {
+      if (!result.success) {
+        callbacks.current.onError(
+          [result.error, result.errorDetail].filter(Boolean).join(" \u2014 ") || "The run returned no answer.",
+          requestId
+        );
+        return;
+      }
+      try {
+        callbacks.current.onResult(callbacks.current.coerce(result.data, result), requestId);
+      } catch (err) {
+        callbacks.current.onError(err instanceof Error ? err.message : String(err), requestId);
+      }
+    }).catch((err) => {
+      callbacks.current.onError(err instanceof Error ? err.message : String(err), requestId);
+    }).finally(() => setRunning(false));
+  }, [dispatch, store, conversationId, latest, surfaceKey]);
+  return { running };
+}
+export {
+  useComposerStructuredRun
+};

package/dist/agents/redux/execution-system/instance-variable-values/bound-variable.selectors.js

@@ -53,7 +53,9 @@ const selectVisibleInputDefinitions = (conversationId) => {
       (entry, items) => {
         if (!entry || entry.definitions.length === 0) return EMPTY_DEFS;
         const effective = applyInheritedComponents(entry.definitions, items);
+        const pageOwned = entry.pageOwnedNames ?? [];
         const visible = effective.filter((d) => {
+          if (pageOwned.includes(d.name)) return false;
           if (isCustomDataBinding(d.binding)) return false;
           if (!isBound(d)) return true;
           return isEmptyVal(entry.scopeValues[d.name]);

package/dist/agents/redux/execution-system/instance-variable-values/instance-variable-values.slice.d.ts

@@ -62,6 +62,14 @@ export interface InstanceVariableValuesEntry {
      * the name leaves this list: it is now genuinely hers.
      */
     hostValueNames: string[];
+    /**
+     * Variables the PAGE supplies whole and the person never edits (an
+     * organization's facts, the tables a builder may reuse, today's date): they
+     * ship with the run like any value, but the variable form never draws them
+     * as fields — only the variables the person fills appear (Arman, 2026-10-09:
+     * "variables are the stars of the show"). Absent = none.
+     */
+    pageOwnedNames?: string[];
     /** Immutable payload rendered only with the first submitted user turn. */
     submittedFirstTurnValues: Record<string, unknown> | null;
     submittedFirstTurnHostValueNames: string[];
@@ -86,7 +94,10 @@ export declare const initInstanceVariables: import("@reduxjs/toolkit").ActionCre
 }, "instanceVariableValues/setUserVariableValues">, setHostVariableValues: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
     conversationId: string;
     values: Record<string, unknown>;
-}, "instanceVariableValues/setHostVariableValues">, restoreVariableValues: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+}, "instanceVariableValues/setHostVariableValues">, setPageOwnedVariableNames: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
+    conversationId: string;
+    names: string[];
+}, "instanceVariableValues/setPageOwnedVariableNames">, restoreVariableValues: import("@reduxjs/toolkit").ActionCreatorWithPayload<{
     conversationId: string;
     values: Record<string, unknown>;
     /** The subset of `values` the host wired. Omitted = all of it is hers. */

package/dist/agents/redux/execution-system/instance-variable-values/instance-variable-values.slice.js

@@ -78,6 +78,15 @@ const instanceVariableValuesSlice = createSlice({
       }
       entry.hostValueNames = names;
     },
+    /**
+     * Name the variables this page supplies whole (see `pageOwnedNames`): the
+     * form hides them; their values still ship.
+     */
+    setPageOwnedVariableNames(state, action) {
+      const entry = state.byConversationId[action.payload.conversationId];
+      if (!entry) return;
+      entry.pageOwnedNames = [...new Set(action.payload.names)];
+    },
     /**
      * Put back a set of ALREADY-RESOLVED values TOGETHER WITH THEIR AUTHORSHIP.
      *
@@ -259,6 +268,7 @@ const {
   setUserVariableValue,
   setUserVariableValues,
   setHostVariableValues,
+  setPageOwnedVariableNames,
   restoreVariableValues,
   stampSubmittedFirstTurnValues,
   clearSubmittedFirstTurnValues,
@@ -287,6 +297,7 @@ export {
   resetUserVariableValues,
   restoreVariableValues,
   setHostVariableValues,
+  setPageOwnedVariableNames,
   setRuntimeVariableResourcePolicy,
   setScopeVariableValues,
   setUserVariableValue,

package/dist/messenger/MessengerRail.js

@@ -139,7 +139,7 @@ function MessengerRail({
       "data-collapsed": collapsed ? "true" : "false",
       className: cn(
         "flex h-full shrink-0 flex-col border-r border-border bg-muted/40 py-2 transition-[width] duration-150",
-        collapsed ? "w-16 px-2" : "w-36 px-2",
+        collapsed ? "w-16 px-2" : "w-40 px-2",
         className
       ),
       children: [

package/dist/messenger/agents/AgentsMessenger.js

@@ -307,7 +307,7 @@ function useAgentsMessengerSource(options = {}) {
         id: agentRowId(row.agentId),
         name: nameOf(row.agentId),
         avatar: { kind: "monogram" },
-        preview: row.latest ? threadTitle(row.latest) : seatOf(row.agentId) ? STARTER_LABEL : void 0,
+        preview: row.latest ? threadTitle(row.latest) : void 0,
         time: relativeDate(row.latest?.updatedAt),
         pinned: row.pinned,
         searchText: info.get(row.agentId)?.description ?? void 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.7.30",
+  "version": "0.7.31",
   "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",
@@ -4716,14 +4716,14 @@
     "server-only": "^0.0.1",
     "uuid": "^14.0.2",
     "zod": "^4.6.5",
-    "@ai-matrx/alchemy": "latest",
     "@ai-matrx/associations": "latest",
     "@ai-matrx/browser-audio": "latest",
-    "@ai-matrx/agents": "latest",
     "@ai-matrx/canvas": "latest",
     "@ai-matrx/content-ir": "latest",
     "@ai-matrx/content-ir-react": "latest",
+    "@ai-matrx/alchemy": "latest",
     "@ai-matrx/data": "latest",
+    "@ai-matrx/agents": "latest",
     "@ai-matrx/design-system": "latest",
     "@ai-matrx/icons": "latest",
     "@ai-matrx/kit": "latest",
@@ -4731,11 +4731,11 @@
     "@ai-matrx/messaging": "latest",
     "@ai-matrx/print": "latest",
     "@ai-matrx/realtime": "latest",
-    "@ai-matrx/diff": "latest",
     "@ai-matrx/records": "latest",
     "@ai-matrx/records-ui": "latest",
     "@ai-matrx/rich-content": "latest",
-    "@ai-matrx/rich-editor": "latest"
+    "@ai-matrx/rich-editor": "latest",
+    "@ai-matrx/diff": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
@@ -4854,5 +4854,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": "95a5e215a7437a241b5588b14653a183c82c240c"
+  "gitHead": "49f70431f3ef0317f82a1e22f628cf521e448058"
 }