@ai-matrx/chat 0.7.10 → 0.7.12

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # @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
+
+- **`./agents/redux/execution-system/thunks/continue-agent-json`** is back in the public surface; 0.7.9 dropped it
+  from `public-modules.json` while `matrx-frontend`'s Applet builder imports it (`continueAgentJson`).
+- **Consumer action:** none.
+
 ## 0.7.10
 ### a refused answer is a failed run (lane M3)
 

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/components/messages-display/user/AgentUserMessage.js

@@ -204,7 +204,9 @@ function AgentUserMessage({
     bodyBlocks,
     trimmedText
   ]);
-  const compactUserMessage = useTranscriptLayout().userMessage === "compact";
+  const userMessageLook = useTranscriptLayout().userMessage;
+  const bubbleUserMessage = userMessageLook === "bubble";
+  const compactUserMessage = userMessageLook === "compact" || bubbleUserMessage;
   const { isCollapsed, setIsCollapsed, shouldBeCollapsible, measureRef } = useCollapsibleMessageText(collapseSignature, compactUserMessage ? COMPACT_COLLAPSE_THRESHOLD_PX : void 0);
   const authoredByHost = metadata?.authored_by === "host";
   const isSuperAdmin = useAppSelector(selectIsSuperAdmin);
@@ -271,7 +273,8 @@ function AgentUserMessage({
   return /* @__PURE__ */ jsxs(
     "div",
     {
-      className: cn("group relative", containerMargin),
+      className: cn("group relative", containerMargin, bubbleUserMessage && "flex flex-col items-end"),
+      "data-user-message-look": userMessageLook,
       "data-message-id": messageId,
       onMouseEnter: () => setIsHovered(true),
       onMouseLeave: () => setIsHovered(false),
@@ -292,11 +295,14 @@ function AgentUserMessage({
         /* @__PURE__ */ jsx(
           "div",
           {
-            className: compactUserMessage ? (
+            className: bubbleUserMessage ? (
+              // The person's turn on the trailing side, in a rounded bubble as wide as its words (Messages).
+              "w-fit max-w-[80%] min-w-0 bg-muted rounded-2xl px-3.5 py-2 [&_.math-content-wrapper]:my-0 [&_p:last-child]:mb-0"
+            ) : compactUserMessage ? (
               // Tight: no inset from the left, and the markdown paragraph's own margins dropped.
               "bg-muted rounded-md px-3 py-2 [&_.math-content-wrapper]:my-0 [&_p:last-child]:mb-0"
             ) : "bg-muted border border-border rounded-lg px-2 py-2",
-            "data-user-message-style": compactUserMessage ? "compact" : "card",
+            "data-user-message-style": bubbleUserMessage ? "bubble" : compactUserMessage ? "compact" : "card",
             children: /* @__PURE__ */ jsxs("div", { className: "relative min-w-0", children: [
               /* @__PURE__ */ jsxs(
                 "div",

package/dist/agents/components/shared/transcript-layout.d.ts

@@ -8,7 +8,9 @@
  *  - `width`: "reading" (the canonical `max-w-3xl` reading column) | "fill" (the host's pane).
  *  - `align`: "center" | "start" — where a reading-width column sits in a wider pane.
  *  - `userMessage`: "compact" (DEFAULT: a flat tight block; only a genuinely long message
- *    collapses) | "card" (the bordered card that collapses a long message behind a chevron).
+ *    collapses) | "card" (the bordered card that collapses a long message behind a chevron) |
+ *    "bubble" (Messages / Xcode's coding assistant: the person's turn on the trailing side in a
+ *    rounded bubble as wide as its words, answers full width; collapses like "compact").
  *  - `answerActions`: "hover" (DEFAULT: the action row is revealed on hover / keyboard focus, and
  *    always on touch — its height is reserved, so revealing it moves nothing; a finished answer ends
  *    on its last word) | "latest" (the latest answer's row is always visible, older ones on hover) |
@@ -18,7 +20,7 @@ import { type ReactNode } from "react";
 export interface TranscriptLayout {
     width?: "reading" | "fill";
     align?: "center" | "start";
-    userMessage?: "card" | "compact";
+    userMessage?: "card" | "compact" | "bubble";
     answerActions?: "shown" | "latest" | "hover";
 }
 export declare const DEFAULT_TRANSCRIPT_LAYOUT: Required<TranscriptLayout>;

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/host/defaults/server-api.d.ts

@@ -10,7 +10,7 @@
  * values here — no admin lane, no admin door, no endpoint overrides, no local
  * engine, no browser extension (each refusal says so once).
  */
-import { applyOrganizationContextHeader, type MatrxCallError, type MatrxCallResult, type MatrxTransport, type ProviderSessionFailure, type ProviderSessionFailureVerdict } from "@ai-matrx/agents/matrx";
+import { applyOrganizationContextHeader, type MatrxCallError, type MatrxCallResult, type MatrxTransport, type ProviderSessionFailure, type ProviderSessionFailureVerdict, type ProviderSessionUsage } from "@ai-matrx/agents/matrx";
 import type { TypedStreamEvent } from "@ai-matrx/agents/generated/stream-events";
 import type { ApiPaths, ApiSchemas as Schemas, DefaultBrokeredCredential, DefaultRequestOptions, GetResult, PatchBody, PatchResult, PathWith, PostBody, PostResult } from "./typed-paths.js";
 import type { ChatIdentityPort, ChatOrgPort, ChatServerPort } from "../contract.js";
@@ -349,6 +349,7 @@ export declare function createDefaultServerApi(host: () => ServerHostView): {
         captureErrors?: boolean;
     }) => Promise<DefaultBrokeredCredential>;
     reportBrowserProviderFailure: (failure: ProviderSessionFailure) => DefaultServerThunk<Promise<ProviderSessionFailureVerdict | null>>;
+    reportBrowserProviderUsage: (usage: ProviderSessionUsage) => void;
     parseNdjsonStream: (response: Response, signal?: AbortSignal) => {
         requestId: string | null;
         conversationId: string | null;

package/dist/host/defaults/server-api.js

@@ -7,7 +7,9 @@ import {
   executeMatrxCall,
   normalizeMatrxError,
   parseMatrxNdjsonResponse,
+  createProviderUsageReporter,
   reportProviderSessionFailure,
+  reportProviderSessionUsage,
   sendMatrxRequest
 } from "@ai-matrx/agents/matrx";
 import { announceOnce } from "../errors.js";
@@ -149,6 +151,9 @@ function createDefaultServerApi(host) {
     });
   }
   const productionUrl = () => baseUrl();
+  const usageReporter = createProviderUsageReporter({
+    send: (usage) => reportProviderSessionUsage(transport({ source: "providerSessionUsage" }), usage)
+  });
   return {
     // call-api
     callApi,
@@ -234,6 +239,8 @@ function createDefaultServerApi(host) {
         return null;
       }
     },
+    // what a browser-held provider session spent: queued, retried, billed once per usage_id
+    reportBrowserProviderUsage: (usage) => usageReporter.report(usage),
     // the NDJSON stream every run reads
     // THE shared parser: a body that breaks mid-run is a TRANSPORT loss (the
     // run may still finish and is reattachable), never a failed run.

package/dist/host/server/provider-session-usage.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Server seam — what a browser-held provider session spent (`POST /broker/usage`), reported through
+ * the configured host's server client. Fire-and-forget: the host queues, retries and de-duplicates.
+ */
+export declare const reportBrowserProviderUsage: (usage: import("@ai-matrx/agents").ProviderSessionUsage) => void;

package/dist/host/server/provider-session-usage.js

@@ -0,0 +1,5 @@
+import { forwardServer } from "../server.js";
+const reportBrowserProviderUsage = forwardServer("reportBrowserProviderUsage");
+export {
+  reportBrowserProviderUsage
+};

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/dist/voice-agent/hooks/useXaiVoiceSession.js

@@ -53,6 +53,8 @@ import {
   createXaiClient
 } from "../transport/xaiClient.js";
 import { reportBrowserProviderFailure } from "../../host/server/provider-session-failure.js";
+import { reportBrowserProviderUsage } from "../../host/server/provider-session-usage.js";
+import { createXaiUsageMeter } from "../usage.js";
 import { transcriptTextFromEvent } from "../transport/serverEvents.js";
 import {
   voiceDebugLog,
@@ -103,6 +105,13 @@ function useXaiVoiceSession(opts) {
   const voiceIdRef = useRef(voiceId);
   const realtimeModelRef = useRef(realtimeModel);
   realtimeModelRef.current = realtimeModel;
+  const usageMeterRef = useRef(null);
+  if (!usageMeterRef.current) {
+    usageMeterRef.current = createXaiUsageMeter({
+      model: () => realtimeModelRef.current,
+      report: (usage) => reportBrowserProviderUsage(usage)
+    });
+  }
   const instructionsRef = useRef(instructions);
   const toolsRef = useRef(tools);
   voiceIdRef.current = voiceId;
@@ -334,6 +343,7 @@ function useXaiVoiceSession(opts) {
       switch (event.type) {
         case "session.created":
           voiceDebugLog(instanceId, "info", "ws.session.created");
+          usageMeterRef.current?.started(event.session.id);
           break;
         case "session.updated": {
           voiceDebugLog(
@@ -523,6 +533,7 @@ function useXaiVoiceSession(opts) {
           break;
         }
         case "response.done": {
+          usageMeterRef.current?.responseDone(event.response);
           runFlush();
           if (!pendingAssistantTurnIdRef.current) break;
           const playedMs = playbackRef.current?.markTurnEnded() ?? 0;
@@ -658,6 +669,7 @@ function useXaiVoiceSession(opts) {
     assistantTurnStartedAtMsRef.current = null;
     assistantAudioStartedAtMsRef.current = null;
     firstAudioReceivedRef.current = false;
+    usageMeterRef.current?.ended();
     xaiClientRef.current?.disconnect();
     clearSessionSubscriptions();
     await captureRef.current?.stop();
@@ -771,6 +783,7 @@ function useXaiVoiceSession(opts) {
     const unsubEvent = client.onEvent(handleServerEvent);
     const unsubError = client.onError(handleClientError);
     const unsubClose = client.onClose((info) => {
+      usageMeterRef.current?.ended();
       voiceDebugIncr(instanceId, "closeCount");
       voiceDebugSetFlags(instanceId, {
         lastCloseIntentional: info.intentional,

package/dist/voice-agent/usage.d.ts

@@ -0,0 +1,20 @@
+import type { ProviderSessionUsage } from "@ai-matrx/agents/matrx";
+import type { XaiResponseUsage } from "./transport/serverEvents.js";
+export interface XaiUsageMeterOptions {
+    /** The realtime model the session opened with; unresolved = nothing priceable to report. */
+    model: () => string | null | undefined;
+    report: (usage: ProviderSessionUsage) => void;
+    now?: () => number;
+}
+export interface XaiUsageMeter {
+    /** Session opened: start the clock and remember xAI's session id. */
+    started(sessionId: string | null | undefined): void;
+    /** One `response.done`: report its tokens plus the session time since the last report. */
+    responseDone(response: {
+        id: string;
+        usage?: XaiResponseUsage;
+    }): void;
+    /** Session closed (clean or dropped): report the trailing slice of session time. Idempotent. */
+    ended(): void;
+}
+export declare function createXaiUsageMeter(options: XaiUsageMeterOptions): XaiUsageMeter;

package/dist/voice-agent/usage.js

@@ -0,0 +1,50 @@
+function createXaiUsageMeter(options) {
+  const now = options.now ?? (() => Date.now());
+  let sessionId = null;
+  let sliceStartedAt = null;
+  let ordinal = 0;
+  function takeSeconds() {
+    if (sliceStartedAt === null) return 0;
+    const at = now();
+    const seconds = Math.max(0, (at - sliceStartedAt) / 1e3);
+    sliceStartedAt = at;
+    return seconds;
+  }
+  return {
+    started(id) {
+      sessionId = id?.trim() || null;
+      sliceStartedAt = now();
+      ordinal = 0;
+    },
+    responseDone(response) {
+      const model = options.model()?.trim();
+      if (!model || !response.id) return;
+      options.report({
+        provider: "xai",
+        model,
+        usage_id: response.id,
+        input_tokens: response.usage?.input_tokens,
+        output_tokens: response.usage?.output_tokens,
+        seconds: takeSeconds()
+      });
+    },
+    ended() {
+      const model = options.model()?.trim();
+      const startedAt = sliceStartedAt;
+      sliceStartedAt = null;
+      if (!model || startedAt === null) return;
+      const seconds = Math.max(0, (now() - startedAt) / 1e3);
+      if (seconds < 1) return;
+      ordinal += 1;
+      options.report({
+        provider: "xai",
+        model,
+        usage_id: `${sessionId ?? `session-${startedAt}`}:end:${ordinal}`,
+        seconds
+      });
+    }
+  };
+}
+export {
+  createXaiUsageMeter
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.7.10",
+  "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",
@@ -2140,6 +2140,11 @@
       "import": "./dist/agents/redux/execution-system/thunks/call-conversation-api.js",
       "default": "./dist/agents/redux/execution-system/thunks/call-conversation-api.js"
     },
+    "./agents/redux/execution-system/thunks/continue-agent-json": {
+      "types": "./dist/agents/redux/execution-system/thunks/continue-agent-json.d.ts",
+      "import": "./dist/agents/redux/execution-system/thunks/continue-agent-json.js",
+      "default": "./dist/agents/redux/execution-system/thunks/continue-agent-json.js"
+    },
     "./agents/redux/execution-system/thunks/conversation-bundle": {
       "types": "./dist/agents/redux/execution-system/thunks/conversation-bundle.d.ts",
       "import": "./dist/agents/redux/execution-system/thunks/conversation-bundle.js",
@@ -2435,11 +2440,6 @@
       "import": "./dist/agents/route/buildSystemAgentAiPayload.js",
       "default": "./dist/agents/route/buildSystemAgentAiPayload.js"
     },
-    "./agents/run/useRunAgent": {
-      "types": "./dist/agents/run/useRunAgent.d.ts",
-      "import": "./dist/agents/run/useRunAgent.js",
-      "default": "./dist/agents/run/useRunAgent.js"
-    },
     "./agents/runtime-reconnect/ServerOperationBanner": {
       "types": "./dist/agents/runtime-reconnect/ServerOperationBanner.d.ts",
       "import": "./dist/agents/runtime-reconnect/ServerOperationBanner.js",
@@ -4681,25 +4681,25 @@
     "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/content-ir-react": "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",
-    "@ai-matrx/diff": "latest",
-    "@ai-matrx/media": "latest",
     "@ai-matrx/kit": "latest",
+    "@ai-matrx/media": "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/records": "latest",
-    "@ai-matrx/data": "latest",
-    "@ai-matrx/rich-editor": "latest"
+    "@ai-matrx/rich-editor": "latest",
+    "@ai-matrx/content-ir": "latest",
+    "@ai-matrx/diff": "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": "c1236d2d5f8a42087300bafce53317efb25700af"
+  "gitHead": "24ad46786a0c433cb3773b270bf74c9eb32898bc"
 }

package/dist/agents/run/useRunAgent.d.ts

@@ -1,69 +0,0 @@
-import type { Action } from "redux";
-import type { ThunkAction } from "redux-thunk";
-import type { ChatRootState } from "../../store/root-state.js";
-import { type CallScope, type LLMParamsBody } from "../../host/server/call-api.js";
-import type { components } from "@ai-matrx/agents/generated/api-types";
-export interface RunAgentArgs {
-    /** Live agent id (UUID) or slug. */
-    agentId: string;
-    /** The user message sent to the agent (optional for variable-only agents). */
-    userInput?: string;
-    /** Variable name → value map, filling the agent's declared variables. */
-    variables?: Record<string, string>;
-    /** Per-run model/config overrides (temperature, ai_model_id, …). */
-    configOverrides?: LLMParamsBody;
-    /** Entity-local scope. Explicit values beat the user's global active context. */
-    organizationId?: string;
-    projectId?: string;
-    taskId?: string;
-    /**
-     * Stable durable-entity identity. The server reloads this row and uses its
-     * saved scope; the browser does not get to redefine that scope.
-     */
-    contextAnchor?: components["schemas"]["ContextAnchor"];
-    /** Durable producer attribution for the conversation and usage ledger. */
-    sourceApp: string;
-    sourceFeature: string;
-    /**
-     * Interactivity attestation — the ONLY input a client has into
-     * `origin_class`. "user" (the default) is a person's gesture on the screen
-     * that calls this hook; client code firing a run with no gesture behind it
-     * passes "auto". Omitting it entirely is what makes the server class our own
-     * screens as unattested API callers.
-     */
-    initiation?: "user" | "auto";
-    /** Abort the in-flight run. */
-    signal?: AbortSignal;
-    /** Stream chunk-by-chunk text as it arrives (e.g. to show live progress). */
-    onChunk?: (fullText: string) => void;
-}
-export interface UseRunAgent {
-    /** Run the agent and resolve with the full accumulated text output. */
-    run: (args: RunAgentArgs) => Promise<string>;
-    running: boolean;
-    error: string | null;
-    reset: () => void;
-}
-/** Body type for POST /ai/agents/{agent_id} with transport-injected scope. */
-type RunAgentBody = Omit<components["schemas"]["AgentStartRequest"], "organization_id" | "project_id" | "task_id"> & Partial<Pick<components["schemas"]["AgentStartRequest"], "organization_id" | "project_id" | "task_id">>;
-export declare function buildRunAgentRequest(args: RunAgentArgs): {
-    body: RunAgentBody;
-    scopeOverrides: Partial<CallScope>;
-};
-/**
- * Run a one-shot agent through the published package client and resolve with
- * the full text output. Thunk-shaped so the hook (and thunk-style callers)
- * share ONE implementation with real `getState` access.
- *
- * Result semantics (parity with the pre-package flow, proven by
- * `useRunAgent.test.ts` + `run-agent-via-matrx.test.ts`):
- *   - a fatal `error` event → throw its `user_message` → `message` → fallback;
- *   - a `failed`/`cancelled` `user_request` completion → throw
- *     `result.error` → `result.user_message` → "The agent run <status>"
- *     (when both fire, the error event wins — the package/projector ruling);
- *   - otherwise resolve accumulated chunk text, falling back to the
- *     completion's `result.output`.
- */
-export declare function runAgentViaMatrxClient(args: RunAgentArgs): ThunkAction<Promise<string>, ChatRootState, unknown, Action>;
-export declare function useRunAgent(): UseRunAgent;
-export {};

package/dist/agents/run/useRunAgent.js

@@ -1,135 +0,0 @@
-"use client";
-import { useCallback, useRef, useState } from "react";
-import { useAppDispatch } from "../../store/hooks.js";
-import {
-  startAgentRun
-} from "@ai-matrx/agents/matrx";
-import {
-  createAgentRequestProjection,
-  projectAgentEvent
-} from "@ai-matrx/agents/projection/request";
-import {
-  buildRequestBody,
-  resolveScope,
-  waitForAuthReady
-} from "../../host/server/call-api.js";
-import { createMatrxTransport } from "../../host/server/matrx-transport.js";
-import { applyDesktopTargetToRequestBody } from "@ai-matrx/agents/matrx";
-import { extractErrorMessage } from "@ai-matrx/data/net";
-import { selectDesktopTargetInstanceId } from "../../host/prefs.js";
-function buildRunAgentRequest(args) {
-  const scopeOverrides = {};
-  if (args.organizationId !== void 0) {
-    scopeOverrides.organization_id = args.organizationId;
-  }
-  if (args.projectId !== void 0) scopeOverrides.project_id = args.projectId;
-  if (args.taskId !== void 0) scopeOverrides.task_id = args.taskId;
-  return {
-    body: {
-      // One-shot run: a freshly minted id for correlation, is_new so the
-      // server never looks anything up, store:false so nothing is written.
-      conversation_id: crypto.randomUUID(),
-      is_new: true,
-      store: false,
-      user_input: args.userInput ?? null,
-      variables: args.variables && Object.keys(args.variables).length > 0 ? args.variables : void 0,
-      config_overrides: args.configOverrides,
-      source_app: args.sourceApp,
-      source_feature: args.sourceFeature,
-      initiation: args.initiation ?? "user",
-      context_anchor: args.contextAnchor,
-      stream: true,
-      debug: false
-    },
-    scopeOverrides
-  };
-}
-const stringField = (bag, key) => {
-  if (typeof bag !== "object" || bag === null) return null;
-  const value = bag[key];
-  return typeof value === "string" && value ? value : null;
-};
-function runAgentViaMatrxClient(args) {
-  return async (_dispatch, getState) => {
-    await waitForAuthReady(getState);
-    const state = getState();
-    const { body, scopeOverrides } = buildRunAgentRequest(args);
-    const scope = resolveScope(state, scopeOverrides);
-    const request = buildRequestBody(body, scope);
-    const desktopTargetInstanceId = selectDesktopTargetInstanceId(state);
-    if (desktopTargetInstanceId) {
-      applyDesktopTargetToRequestBody(request, desktopTargetInstanceId);
-    }
-    const transport = createMatrxTransport(getState, {
-      organizationId: scope.organization_id,
-      source: "runAgentViaMatrxClient"
-    });
-    const handle = await startAgentRun(
-      transport,
-      args.agentId,
-      request,
-      args.signal ? { signal: args.signal } : {}
-    );
-    let projection = createAgentRequestProjection({
-      requestId: handle.requestId ?? String(request.conversation_id),
-      conversationId: handle.conversationId
-    });
-    for await (const envelope of handle.events) {
-      const previousAnswer = projection.answer;
-      projection = projectAgentEvent(projection, envelope);
-      if (projection.answer !== previousAnswer) {
-        args.onChunk?.(projection.answer);
-      }
-    }
-    if (projection.error) {
-      throw new Error(
-        stringField(projection.error, "user_message") ?? stringField(projection.error, "message") ?? "The agent run failed"
-      );
-    }
-    const completion = projection.completion;
-    const completionStatus = typeof completion?.status === "string" ? completion.status : null;
-    if (completionStatus === "failed" || completionStatus === "cancelled") {
-      const result = completion?.result;
-      throw new Error(
-        stringField(result, "error") ?? stringField(result, "user_message") ?? `The agent run ${completionStatus}`
-      );
-    }
-    if (projection.answer) return projection.answer;
-    return stringField(completion?.result, "output") ?? "";
-  };
-}
-function useRunAgent() {
-  const dispatch = useAppDispatch();
-  const [running, setRunning] = useState(false);
-  const [error, setError] = useState(null);
-  const runningRef = useRef(false);
-  const reset = useCallback(() => {
-    setRunning(false);
-    setError(null);
-    runningRef.current = false;
-  }, []);
-  const run = useCallback(
-    async (args) => {
-      setRunning(true);
-      setError(null);
-      runningRef.current = true;
-      try {
-        return await dispatch(runAgentViaMatrxClient(args));
-      } catch (err) {
-        const message = extractErrorMessage(err);
-        setError(message);
-        throw err instanceof Error ? err : new Error(message);
-      } finally {
-        runningRef.current = false;
-        setRunning(false);
-      }
-    },
-    [dispatch]
-  );
-  return { run, running, error, reset };
-}
-export {
-  buildRunAgentRequest,
-  runAgentViaMatrxClient,
-  useRunAgent
-};