@ai-matrx/chat 0.7.11 → 0.7.12

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @ai-matrx/chat
 
+## 0.7.12
+### Unreleased
+### The variables a run used (Agent Factory R59)
+
+- **`selectVariablesTheRunUsed(conversationId)`** (instance-variable-values selectors): the values a run's first turn was sent
+  with, frozen at send; before a send, the request merge. The builder's Side Chat helper reads it so a later edit of the field
+  cannot rewrite what the run was given.
+- **Consumer action:** none.
+
+### A persisted answer paints with its markdown (spend register item 32, cold-load CLS at 1440)
+
+- **`MarkdownStream`**: the engine chunk is requested when a conversation surface's module loads (`preloadMarkdownStream`), kept once
+  resolved, and rendered synchronously on the first render of a new instance. The per-instance `mounted` effect gate (an extra commit
+  after paint) is now `useSyncExternalStore` (still client-only: server and hydration render nothing). Before, the answer block painted
+  as a 36 px header and grew to its full height ~200 ms later, shifting everything below it (CLS 0.06-0.28 at 1440).
+- **Consumer action:** none.
+
 ## 0.7.11
 ### continue-agent-json is exported again
 

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

@@ -6,7 +6,7 @@ import {
   useState,
   useEffect
 } from "react";
-import MarkdownStream from "../../../../ui/markdown-stream/MarkdownStream.js";
+import MarkdownStream, { preloadMarkdownStream } from "../../../../ui/markdown-stream/MarkdownStream.js";
 import "../rich-document/chat-message-source.js";
 import { RecordAnnotations, annotationRecordOf } from "@ai-matrx/rich-content/host/app-bindings";
 import { useAppDispatch, useAppSelector } from "../../../../store/hooks.js";
@@ -91,6 +91,7 @@ import {
 } from "../../../../host/ui-slots.js";
 import { ErrorAlchemyMenu } from "../../../../host/ui-slots.js";
 import { useInPlaceTrigger } from "@ai-matrx/rich-editor/in-place/EditInPlace";
+void preloadMarkdownStream();
 const _NO_LIVE_SOURCES = [];
 const _selectNoLiveSources = () => _NO_LIVE_SOURCES;
 function retryErrorMessage(err) {

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

@@ -105,6 +105,76 @@ export declare const selectOwnVariableValues: (conversationId: string) => ((stat
     memoize: typeof import("reselect").weakMapMemoize;
     argsMemoize: typeof import("reselect").weakMapMemoize;
 };
+/**
+ * The variables a run USED: the values its first turn was sent with — frozen at
+ * send, host-wired names included — so a later edit of the variable field never
+ * rewrites what the run was given. Before any send it is what the next send would
+ * carry (the request merge, defaults included). Read by the agent builder's Side
+ * Chat helper to judge a test run.
+ */
+export declare const selectVariablesTheRunUsed: (conversationId: string) => ((state: {
+    voiceAgent: import("../../../../voice-agent/types.js").VoiceAgentState;
+    agentDefinition: import("../../../types/agent-definition.types.js").AgentDefinitionSliceState;
+    conversationList: import("../../conversation-list/conversation-list.types.js").ConversationListState;
+    conversationHistory: import("../../conversation-history/types.js").ConversationHistoryState;
+    agentShortcut: import("../../agent-shortcuts/types.js").AgentShortcutSliceState;
+    agentShortcutCategory: import("../../agent-shortcut-categories/types.js").AgentShortcutCategorySliceState;
+    surfaceUserState: import("../../../../surfaces/redux/userStateSlice.js").SurfaceUserStateSlice;
+    conversations: import("../conversations/conversations.slice.js").ConversationsState;
+    chatIncognito: import("../../chat/chat-incognito.slice.js").ChatIncognitoState;
+    chatRoute: import("../../chat/chat-route.slice.js").ChatRouteState;
+    instanceModelOverrides: import("../instance-model-overrides/instance-model-overrides.slice.js").InstanceModelOverridesState;
+    instanceInputCapabilities: import("../instance-input-capabilities/instance-input-capabilities.slice.js").InstanceInputCapabilitiesState;
+    instanceVariableValues: import("./instance-variable-values.slice.js").InstanceVariableValuesState;
+    instanceResources: import("../instance-resources/instance-resources.slice.js").InstanceResourcesState;
+    instanceContext: import("../instance-context/instance-context.slice.js").InstanceContextState;
+    instanceWorkingDocument: import("../instance-working-document/instance-working-document.slice.js").InstanceWorkingDocumentSliceState;
+    instanceUserInput: import("../instance-user-input/instance-user-input.slice.js").InstanceUserInputSliceState;
+    instanceClientTools: import("../instance-client-tools/instance-client-tools.slice.js").InstanceClientToolsState;
+    pendingAsks: import("../../../ui-first-tools/redux/pending-asks.slice.js").PendingAsksState;
+    conversationInbox: import("../inbox/inbox.slice.js").ConversationInboxState;
+    agentLists: import("../../../ui-first-tools/redux/agent-lists.slice.js").AgentListsState;
+    instanceUIState: import("../instance-ui-state/instance-ui-state.slice.js").InstanceUIStateSlice;
+    activeTools: import("../active-tools/active-tools.slice.js").ActiveToolsState;
+    activeRequests: import("../active-requests/active-requests.slice.js").ActiveRequestsState;
+    runSets: import("../run-sets/run-sets.slice.js").RunSetsState;
+    messages: import("../messages/messages.slice.js").MessagesState;
+    observability: import("../observability/observability.slice.js").ObservabilityState;
+    contextState: import("../context-state/context-state.slice.js").ContextStateSliceState;
+    observationalMemory: import("../observational-memory/observational-memory.slice.js").ObservationalMemoryState;
+    cacheBypass: import("../message-crud/cache-bypass.slice.js").CacheBypassState;
+    conversationFocus: import("../conversation-focus/conversation-focus.slice.js").ConversationFocusState;
+    surfaces: import("../../surfaces/surfaces.slice.js").SurfacesState;
+    surfacesCatalog: import("../../../../surfaces/redux/surfacesCatalogSlice.js").SurfacesCatalogSliceState;
+    agentSurfaceBindings: import("../../../../surfaces/redux/agentSurfaceBindingsSlice.js").AgentSurfaceBindingsSliceState;
+    surfaceConfig: import("../../../../surfaces/redux/surfaceConfigSlice.js").SurfaceConfigSliceState;
+    agentAssistantMarkdownDraft: import("../../agent-assistant-markdown-draft.slice.js").AgentAssistantMarkdownDraftState;
+    mcp: import("../../mcp/mcp.slice.js").McpSliceState;
+    proposedDirectives: import("../../proposed-directives/proposedDirectivesSlice.js").ProposedDirectivesState;
+    conversationAttachments: import("../../../connectors/attachments.slice.js").AttachmentsSliceState;
+    chatHost: import("../../../../store/chat-host.slice.js").ChatHostState;
+    hostConversations: import("../host-conversations/host-conversations.slice.js").HostConversationsState;
+} & import("../../../../store/root-state.js").ChatHostReadSlices) => Record<string, unknown>) & {
+    clearCache: () => void;
+    resultsCount: () => number;
+    resetResultsCount: () => void;
+} & {
+    resultFunc: (resultFuncArgs_0: import("./instance-variable-values.slice.js").InstanceVariableValuesEntry) => Record<string, unknown>;
+    memoizedResultFunc: ((resultFuncArgs_0: import("./instance-variable-values.slice.js").InstanceVariableValuesEntry) => Record<string, unknown>) & {
+        clearCache: () => void;
+        resultsCount: () => number;
+        resetResultsCount: () => void;
+    };
+    lastResult: () => Record<string, unknown>;
+    dependencies: [(state: ChatRootState) => import("./instance-variable-values.slice.js").InstanceVariableValuesEntry];
+    recomputations: () => number;
+    resetRecomputations: () => void;
+    dependencyRecomputations: () => number;
+    resetDependencyRecomputations: () => void;
+} & {
+    memoize: typeof import("reselect").weakMapMemoize;
+    argsMemoize: typeof import("reselect").weakMapMemoize;
+};
 /** Immutable first-turn values, excluding names the host supplied. */
 export declare const selectOwnSubmittedFirstTurnValues: (conversationId: string) => ((state: {
     voiceAgent: import("../../../../voice-agent/types.js").VoiceAgentState;

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

@@ -25,6 +25,19 @@ const selectOwnVariableValues = (conversationId) => createSelector(
     return Object.keys(own).length === 0 ? EMPTY_RECORD : own;
   }
 );
+const selectVariablesTheRunUsed = (conversationId) => createSelector(
+  (state) => state.instanceVariableValues.byConversationId[conversationId],
+  (entry) => {
+    if (!entry) return EMPTY_RECORD;
+    if (entry.submittedFirstTurnValues) return entry.submittedFirstTurnValues;
+    const merged = resolveVariablesForRequest({
+      definitions: entry.definitions,
+      userValues: entry.userValues,
+      scopeValues: entry.scopeValues
+    });
+    return Object.keys(merged).length > 0 ? merged : EMPTY_RECORD;
+  }
+);
 const selectOwnSubmittedFirstTurnValues = (conversationId) => createSelector(
   (state) => state.instanceVariableValues.byConversationId[conversationId],
   (entry) => {
@@ -134,5 +147,6 @@ export {
   selectScopeVariableValues,
   selectUserVariableValues,
   selectVariableProvenance,
-  selectVariablesForRequest
+  selectVariablesForRequest,
+  selectVariablesTheRunUsed
 };

package/dist/ui/markdown-stream/MarkdownStream.d.ts

@@ -83,6 +83,7 @@ export interface MarkdownStreamProps {
      */
     imagePolicy?: "self" | "other" | "ai" | "inherit";
 }
-declare function MarkdownStream(props: MarkdownStreamProps): import("react").FunctionComponentElement<import("react").SuspenseProps> | null;
+export declare function preloadMarkdownStream(): Promise<void>;
+declare function MarkdownStream(props: MarkdownStreamProps): import("react").FunctionComponentElement<import("react").SuspenseProps> | import("react").ReactElement<MarkdownStreamProps, string | import("react").JSXElementConstructor<any>> | null;
 export { MarkdownStream };
 export default MarkdownStream;

package/dist/ui/markdown-stream/MarkdownStream.js

@@ -1,14 +1,33 @@
 "use client";
-import { createElement, lazy, Suspense, useEffect, useState } from "react";
+import { createElement, lazy, Suspense, useSyncExternalStore } from "react";
 const MarkdownStreamImpl = lazy(() => import("./MarkdownStreamImpl.js"));
+let loadedImpl = null;
+let loading = null;
+const readyListeners = /* @__PURE__ */ new Set();
+function preloadMarkdownStream() {
+  if (typeof window === "undefined") return Promise.resolve();
+  loading ??= import("./MarkdownStreamImpl.js").then((m) => {
+    loadedImpl = m.default;
+    for (const notify of readyListeners) notify();
+  });
+  return loading;
+}
+const subscribeReady = (notify) => {
+  readyListeners.add(notify);
+  return () => readyListeners.delete(notify);
+};
+const clientReady = () => true;
+const serverNotReady = () => false;
 function MarkdownStream(props) {
-  const [mounted, setMounted] = useState(false);
-  useEffect(() => setMounted(true), []);
-  if (!mounted) return null;
+  const client = useSyncExternalStore(subscribeReady, clientReady, serverNotReady);
+  if (!client) return null;
+  if (loadedImpl) return createElement(loadedImpl, props);
+  void preloadMarkdownStream();
   return createElement(Suspense, { fallback: null }, createElement(MarkdownStreamImpl, props));
 }
 var MarkdownStream_default = MarkdownStream;
 export {
   MarkdownStream,
-  MarkdownStream_default as default
+  MarkdownStream_default as default,
+  preloadMarkdownStream
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.7.11",
+  "version": "0.7.12",
   "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,13 +4681,12 @@
     "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/canvas": "latest",
-    "@ai-matrx/content-ir": "latest",
     "@ai-matrx/agents": "latest",
     "@ai-matrx/content-ir-react": "latest",
+    "@ai-matrx/alchemy": "latest",
     "@ai-matrx/data": "latest",
     "@ai-matrx/design-system": "latest",
     "@ai-matrx/icons": "latest",
@@ -4699,6 +4698,7 @@
     "@ai-matrx/records-ui": "latest",
     "@ai-matrx/rich-content": "latest",
     "@ai-matrx/rich-editor": "latest",
+    "@ai-matrx/content-ir": "latest",
     "@ai-matrx/diff": "latest"
   },
   "devDependencies": {
@@ -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": "db3bd1fad7851f7648e0aeee094cf4df6152b3ae"
+  "gitHead": "24ad46786a0c433cb3773b270bf74c9eb32898bc"
 }