@ai-matrx/chat 0.4.24 → 0.4.26

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # @ai-matrx/chat
 
+## 0.4.26
+
+- `RichCopySplit` renders the content action set (`ContentActions` from rich-content 0.2.52): Copy, Plain (with the new `viewKey` prop), Export, Print and Transform (the host's Alchemy palette) each one click. New `exportTitle` prop names exported files.
+- A chat answer honors its bar's Plain switch: the exact source in place of the render (the render stays mounted).
+
+Consumer action: pass `viewKey` and wrap the host's content in `ContentView` to get Plain.
+
+## 0.4.25 — nine more host slots draw the real component in any host
+
+- `ReadFailure`, `UntrustedCount`, `OptionCombobox`, `AspectRatioSelect`, `FloatingSheet`,
+  `ConfigurationTable`, `ConfigurationTableRow`, `FieldHelp` and `TextInputDialog` default to
+  `@ai-matrx/design-system` 0.82.0's components (moved there whole from matrx-frontend); a slot whose
+  default is the package component no longer reports itself as unregistered.
+- `./ui/aspect-ratio-options` re-exports design-system's ratio helpers (one copy).
+- Guard: `slots-draw-their-package-default.test.tsx` (the list only grows).
+
+Consumer action: none — a host's registration still wins; matrx-frontend may drop its registrations of
+these nine slots (they are the same components).
+
+Also in 0.4.25 — `createMemoryNavigation` (from `@ai-matrx/chat/host`): a navigation port that keeps the
+chat's address in memory for hosts whose own address must not move (an extension side panel; Matrx
+Local, whose router already owns `/chat`). Options `initial`, `home`, `persist(address)`,
+`openExternal(href)`; back/forward, link clicks, one search-params object per address. Guard:
+`memory-navigation-keeps-the-page-still.test.tsx` (red 2/5 on a planted break → green 5/5). Consumer
+action: none; matrx-extend may drop its own `memory-navigation.tsx`.
+
+Also in 0.4.25 — a host names the mandate that answers its new-chat screen: `app.defaultChatMandateKey`
+(Matrx Local `local.cloud_chat`, Matrx Extend `extend.browser_chat`); absent = `chat.default_new_chat`.
+`ChatNewClient`, `ChatConversationRoom`, `ChatNewHeader` read it through one hook
+(`useDefaultChatMandateKey`). Guard: `a-host-names-its-default-chat-mandate.test.tsx` (red 1/3 on a
+planted break → green 3/3). Consumer action: none.
+
 ## 0.4.24
 
 Republish of 0.4.23 (its publish failed in finish-build on a member call read as an import; fixed in 4008c0cbbc). No consumer action required.

package/dist/agent-copy/RichCopySplit.d.ts

@@ -2,9 +2,19 @@ import * as React from "react";
 import type { MatrxCopyMenuProps } from "@ai-matrx/alchemy/react/workspace";
 export type RichCopySplitProps = MatrxCopyMenuProps & {
     human: NonNullable<MatrxCopyMenuProps["human"]>;
+    /**
+     * The item's Plain / Formatted key: the host renders its content through
+     * <ContentView viewKey={…} text={…}> (@ai-matrx/rich-content/copy/ContentActions).
+     * Guard: matrx-frontend content-actions.census — every display host passes it.
+     */
+    viewKey?: string;
+    /** File name / print title for Export and Print. */
+    exportTitle?: string;
 };
 /**
- * THE split Copy of a markdown host (Arman, 2026-10-04: "one click to get either the markdown
+ * THE content action set of a markdown host (ContentActions, Arman 2026-10-08: copy, Plain,
+ * Export, Print and Transform each one click away; Transform opens the Alchemy palette below).
+ * Formerly the split Copy of a markdown host (Arman, 2026-10-04: "one click to get either the markdown
  * version or the no-markup version"). One click copies the person's flavor (`copy.default_flavor`);
  * the chevron offers exactly Copy markdown and Copy plain text (2026-10-07). The Alchemy palette
  * (formatted, JSON, download, AI, the host's record copies) is "Export…" — ONE row under a divider

package/dist/agent-copy/RichCopySplit.js

@@ -1,7 +1,7 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
 import * as React from "react";
-import { CopySplitButton } from "@ai-matrx/rich-content/copy/CopySplitButton";
+import { ContentActions } from "@ai-matrx/rich-content/copy/ContentActions";
 import { copyRichContent } from "@ai-matrx/rich-content/copy/copy-commands";
 import { ExportPaletteAnchor, openExportPalette, useExportPaletteKey } from "@ai-matrx/rich-content/copy/ExportPalette";
 import { cn } from "@ai-matrx/design-system";
@@ -17,12 +17,18 @@ function RichCopySplit(props) {
   const exportKey = useExportPaletteKey();
   return /* @__PURE__ */ jsxs("span", { className: cn("inline-flex shrink-0 items-center", className), children: [
     /* @__PURE__ */ jsx(
-      CopySplitButton,
+      ContentActions,
       {
+        content: () => {
+          const value = typeof human === "function" ? human() : human;
+          return typeof value === "string" ? value : String(value ?? "");
+        },
         copy,
         size: splitSize,
         label: `Copy ${props.label ?? ""}`.trim(),
-        onExport: () => void openExportPalette(exportKey)
+        title: props.exportTitle ?? props.label,
+        viewKey: props.viewKey,
+        onTransform: () => void openExportPalette(exportKey)
       }
     ),
     /* @__PURE__ */ jsx(ExportPaletteAnchor, { exportKey, controllerRef: palette }),

package/dist/agents/components/chat/ChatConversationRoom.js

@@ -2,7 +2,7 @@
 import { jsx } from "react/jsx-runtime";
 import { ChatRoomClient } from "./ChatRoomClient.js";
 import { ChatMandateUnavailable, ChatNewLandingSkeleton } from "./ChatNewClient.js";
-import { DEFAULT_NEW_CHAT_MANDATE_KEY } from "./chat-quick-actions.config.js";
+import { useDefaultChatMandateKey } from "./default-chat-mandate.js";
 import { useMandate } from "../../../mandates/useMandate.js";
 import { WorkspaceGate } from "../../../host/ui-slots.js";
 function ChatConversationRoom({
@@ -13,6 +13,7 @@ function ChatConversationRoom({
   composer,
   organizationId = null
 }) {
+  const defaultMandateKey = useDefaultChatMandateKey();
   if (agentId && !ownedByMandate) {
     return /* @__PURE__ */ jsx(
       ChatRoomClient,
@@ -30,7 +31,7 @@ function ChatConversationRoom({
       {
         agentId,
         conversationId,
-        mandateKey: DEFAULT_NEW_CHAT_MANDATE_KEY,
+        mandateKey: defaultMandateKey,
         sandboxBinding,
         composer
       }
@@ -52,8 +53,9 @@ function ChatConversationRoomResolved({
   sandboxBinding,
   composer
 }) {
+  const defaultMandateKey = useDefaultChatMandateKey();
   const { mandate, loading, error, organizationPending } = useMandate(
-    DEFAULT_NEW_CHAT_MANDATE_KEY,
+    defaultMandateKey,
     organizationId ? { organizationId } : {}
   );
   if (loading) return /* @__PURE__ */ jsx(ChatNewLandingSkeleton, {});
@@ -66,7 +68,7 @@ function ChatConversationRoomResolved({
     {
       agentId: mandate.agentId,
       conversationId,
-      mandateKey: DEFAULT_NEW_CHAT_MANDATE_KEY,
+      mandateKey: defaultMandateKey,
       sandboxBinding,
       composer
     }

package/dist/agents/components/chat/ChatNewClient.js

@@ -11,7 +11,7 @@ import {
   ComposerGreeting,
   ComposerQuickActionsSkeleton
 } from "../inputs/smart-input/composer/ComposerSplash.js";
-import { DEFAULT_NEW_CHAT_MANDATE_KEY } from "./chat-quick-actions.config.js";
+import { useDefaultChatMandateKey } from "./default-chat-mandate.js";
 import { useMandate } from "../../../mandates/useMandate.js";
 import { ErrorAlchemyMenu } from "../../../host/ui-slots.js";
 import { asClause } from "@ai-matrx/kit/text";
@@ -21,7 +21,8 @@ function ChatNewClient({
   pinned = false,
   composer
 }) {
-  const { mandate } = useMandate(DEFAULT_NEW_CHAT_MANDATE_KEY, { optional: true });
+  const defaultMandateKey = useDefaultChatMandateKey();
+  const { mandate } = useMandate(defaultMandateKey, { optional: true });
   if (pinned && agentId) {
     return /* @__PURE__ */ jsx(ChatNewBody, { agentId, composer, pinned: true });
   }
@@ -31,7 +32,8 @@ function ChatNewClient({
 function ChatNewClientResolved({
   composer
 }) {
-  const { mandate, loading, error, organizationPending } = useMandate(DEFAULT_NEW_CHAT_MANDATE_KEY);
+  const defaultMandateKey = useDefaultChatMandateKey();
+  const { mandate, loading, error, organizationPending } = useMandate(defaultMandateKey);
   if (loading) return /* @__PURE__ */ jsx(ChatNewLandingSkeleton, {});
   if (organizationPending) {
     return /* @__PURE__ */ jsx(WorkspaceGate, { blocked: true, sentence: "Chat needs a workspace to open.", children: /* @__PURE__ */ jsx(ChatNewLandingSkeleton, {}) });
@@ -71,12 +73,13 @@ function ChatNewBody({
   composer,
   pinned = false
 }) {
+  const defaultMandateKey = useDefaultChatMandateKey();
   const surfaceKey = chatRouteSurfaceKey(agentId);
   return /* @__PURE__ */ jsx(
     ChatRoomClient,
     {
       agentId,
-      mandateKey: pinned ? void 0 : DEFAULT_NEW_CHAT_MANDATE_KEY,
+      mandateKey: pinned ? void 0 : defaultMandateKey,
       composer,
       landingContent: (conversationId, composerPresentation) => composerPresentation ? /* @__PURE__ */ jsx(
         NewChatGreeting,

package/dist/agents/components/chat/ChatNewHeader.js

@@ -1,7 +1,7 @@
 "use client";
 import { jsx } from "react/jsx-runtime";
 import { ChatRunHeader } from "./ChatRunHeader.js";
-import { DEFAULT_NEW_CHAT_MANDATE_KEY } from "./chat-quick-actions.config.js";
+import { useDefaultChatMandateKey } from "./default-chat-mandate.js";
 import { useMandate } from "../../../mandates/useMandate.js";
 function ChatNewHeader({
   agentId,
@@ -20,7 +20,8 @@ function ChatNewHeader({
 function ChatNewHeaderResolved({
   composerMode
 }) {
-  const { mandate } = useMandate(DEFAULT_NEW_CHAT_MANDATE_KEY);
+  const defaultMandateKey = useDefaultChatMandateKey();
+  const { mandate } = useMandate(defaultMandateKey);
   return /* @__PURE__ */ jsx(ChatRunHeader, { activeAgentId: mandate?.agentId, composerMode });
 }
 export {

package/dist/agents/components/chat/default-chat-mandate.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The mandate that answers the new-chat screen and agentless conversations in THIS host: the host's
+ * `app.defaultChatMandateKey` (Matrx Local names `local.cloud_chat`), else the web's
+ * `chat.default_new_chat`. One reader, so every screen that resolves the default agrees.
+ */
+import type { AnyMandateKey } from "@ai-matrx/agents/mandates";
+export declare function useDefaultChatMandateKey(): AnyMandateKey;

package/dist/agents/components/chat/default-chat-mandate.js

@@ -0,0 +1,9 @@
+"use client";
+import { useMaybeChatHost } from "../../../host/react.js";
+import { DEFAULT_NEW_CHAT_MANDATE_KEY } from "./chat-quick-actions.config.js";
+function useDefaultChatMandateKey() {
+  return useMaybeChatHost()?.app.defaultChatMandateKey ?? DEFAULT_NEW_CHAT_MANDATE_KEY;
+}
+export {
+  useDefaultChatMandateKey
+};

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

@@ -74,6 +74,9 @@ import {
 import { retryConversationTurn } from "../../../redux/execution-system/message-crud/retry-turn.thunk.js";
 import { commitInlineContentEdit } from "../../../redux/execution-system/message-crud/commit-inline-edit.thunk.js";
 import { InPlaceAnswerEditor } from "./InPlaceAnswerEditor.js";
+import { PlainTextView } from "@ai-matrx/rich-content/copy/ContentActions";
+import { usePlainView } from "@ai-matrx/rich-content/copy/content-view-store";
+import { richDocumentViewKey } from "@ai-matrx/rich-content/rich-document/runtime/useActionSurfaceProvider";
 import { updateMessageRecord } from "../../../redux/execution-system/messages/messages.slice.js";
 import { handInPlaceCaret } from "@ai-matrx/rich-editor/in-place/caret-handoff";
 import { toast } from "../../../../host/notify.js";
@@ -197,6 +200,9 @@ function AgentAssistantMessage({
     () => extractFlatText(record, { withCitationMarkers: hasCitations, keepInlineThinking: true }),
     [record, hasCitations]
   );
+  const plainView = usePlainView(
+    messageId ? richDocumentViewKey({ type: "chat-message", conversationId, messageId }, "") : null
+  );
   const attachmentParts = extractContentBlocks(record).filter(
     (b) => isAttachmentMessagePart(b) && !isInlineAssistantMedia(b)
   );
@@ -427,26 +433,29 @@ function AgentAssistantMessage({
           ) : (
             // THE READING SET on a saved chat answer (highlight, comment, suggest, link +
             // the Notes & comments dock) — the same mount every note and saved document uses.
-            /* @__PURE__ */ jsx(RecordAnnotations, { record: annotationRecord, children: /* @__PURE__ */ jsx("div", { "data-message-content": true, ...answerReadProps, children: /* @__PURE__ */ jsx(
-              MarkdownStream,
-              {
-                imagePolicy: "ai",
-                requestId: effectiveRequestId,
-                recordMessageIds,
-                streamSlotStart: streamSlotStart ?? record?._streamSlotStart,
-                streamSlotEnd: streamSlotEnd ?? record?._streamSlotEnd,
-                turnId: messageId,
-                conversationId,
-                messageId: messageId ?? void 0,
-                content: renderedText,
-                isStreamActive: isStreamActive && !failed,
-                hideCopyButton: true,
-                allowFullScreenEditor: false,
-                serverProcessedBlocks,
-                onContentChange: handleInlineContentChange,
-                applyLocalEdits: false
-              }
-            ) }) })
+            /* @__PURE__ */ jsx(RecordAnnotations, { record: annotationRecord, children: /* @__PURE__ */ jsxs("div", { "data-message-content": true, ...answerReadProps, children: [
+              plainView ? /* @__PURE__ */ jsx(PlainTextView, { text: renderedText ?? "" }) : null,
+              /* @__PURE__ */ jsx("div", { className: plainView ? "hidden" : "contents", children: /* @__PURE__ */ jsx(
+                MarkdownStream,
+                {
+                  imagePolicy: "ai",
+                  requestId: effectiveRequestId,
+                  recordMessageIds,
+                  streamSlotStart: streamSlotStart ?? record?._streamSlotStart,
+                  streamSlotEnd: streamSlotEnd ?? record?._streamSlotEnd,
+                  turnId: messageId,
+                  conversationId,
+                  messageId: messageId ?? void 0,
+                  content: renderedText,
+                  isStreamActive: isStreamActive && !failed,
+                  hideCopyButton: true,
+                  allowFullScreenEditor: false,
+                  serverProcessedBlocks,
+                  onContentChange: handleInlineContentChange,
+                  applyLocalEdits: false
+                }
+              ) })
+            ] }) })
           ),
           !isClosedStreamSegment && displaySources.length > 0 && /* @__PURE__ */ jsx(MessageSourcesRow, { sources: displaySources, className: "mt-2" }),
           !isStreamActive && /* @__PURE__ */ jsx(PrefillNote, { metadata: record?.metadata }),

package/dist/agents/redux/execution-system/utils/required-organization.js

@@ -1,8 +1,8 @@
 import { adminLaneOrganizationId } from "../../../../host/server/admin-lane.js";
 import { selectOrganizationId } from "../../../../host/org.js";
+import { selectAccessToken, selectFingerprintId } from "../../../../host/identity.js";
 function isFingerprintGuestExecution(state) {
-  const partial = state;
-  return !partial.userAuth?.accessToken && Boolean(partial.userProfile?.fingerprintId);
+  return !selectAccessToken(state) && Boolean(selectFingerprintId(state));
 }
 function executionOrganizationForRequest(state, conversationId) {
   if (isFingerprintGuestExecution(state)) return void 0;

package/dist/agents/ui-first-tools/redux/build-ambient-context.js

@@ -1,5 +1,6 @@
 import { selectProjectId, selectProjectName, selectTaskId, selectTaskName, selectScopeSelectionsContext } from "../../../context/sources/scopes.js";
 import { selectOrganizationId, selectOrganizationName } from "../../../host/org.js";
+import { selectChatIdentity } from "../../../host/identity.js";
 function snapshotRoute(engineered) {
   if (typeof window === "undefined") {
     return { url: null, title: null, route_kind: "server" };
@@ -18,22 +19,22 @@ function snapshotRoute(engineered) {
   return { url, title, route_kind };
 }
 function buildAmbientContext(state, conversationId) {
-  const auth = state.userAuth;
-  if (!auth?.id) return null;
-  const profile = state.userProfile?.userMetadata;
-  const name = profile?.fullName || profile?.name || profile?.preferredUsername || auth.email || "user";
+  const auth = selectChatIdentity(state);
+  if (!auth.userId) return null;
+  const name = auth.displayName || auth.name || auth.preferredUsername || auth.email || "user";
   const now = /* @__PURE__ */ new Date();
   const timezone = typeof Intl !== "undefined" ? Intl.DateTimeFormat().resolvedOptions().timeZone : "UTC";
   const locale = typeof navigator !== "undefined" && navigator.language ? navigator.language : "en-US";
   const snapshot = {
     user: {
-      id: auth.id,
+      id: auth.userId,
       name,
       email: auth.email ?? null,
       // ADMIN POWER, not identity: an agent on a user page must see an admin
       // exactly as it sees anyone else (utils/supabase/adminLane.ts).
-      is_admin: auth.adminLaneOpen === true && (auth.isAdmin ?? false),
-      admin_level: auth.adminLaneOpen === true ? auth.adminLevel ?? null : null
+      // The identity port's adminLevel is already what the host grants on this page.
+      is_admin: auth.adminLevel !== null,
+      admin_level: auth.adminLevel
     },
     client: {
       surface: "nextjs",

package/dist/host/contract.d.ts

@@ -18,6 +18,7 @@
 import type { SupabaseClient } from "@supabase/supabase-js";
 import type { AnchorHTMLAttributes, ComponentType, ReactNode, Ref } from "react";
 import type { AgentCatalog } from "@ai-matrx/agents/catalog";
+import type { AnyMandateKey } from "@ai-matrx/agents/mandates";
 import type { ChatDatabase } from "./db-types.js";
 import type { ChatWindowId } from "./windows.js";
 import type { CanvasJson } from "@ai-matrx/canvas";
@@ -730,7 +731,12 @@ export interface ChatAppIdentity {
     /** `chat.conversation.source_app` — a producer registered with the server. */
     sourceApp: string;
     /** `source_feature` for every conversation this app starts; absent keeps each screen's own. */
-    sourceFeature?: string;
+    sourceFeature?: string; /**
+     * The mandate that answers this app's new-chat screen and agentless conversations (Matrx Local:
+     * `local.cloud_chat`; Matrx Extend: `extend.browser_chat`). Which agent runs is the database's
+     * answer for that key, never the host's. Absent: `chat.default_new_chat`, as on the web.
+     */
+    defaultChatMandateKey?: AnyMandateKey;
 }
 /**
  * Where each conversation's text may go (lanes/agents-chat-proposal.md W0(a)). The package enforces

package/dist/host/defaults/memory-navigation.d.ts

@@ -0,0 +1,12 @@
+import type { ChatNavigationPort } from "../contract.js";
+export interface MemoryNavigationOptions {
+    initial?: string | null;
+    home?: string;
+    persist?: (address: string) => void;
+    openExternal?: (href: string) => void;
+}
+/** A memory port plus the address it holds, for hosts that read or restore it. */
+export interface MemoryNavigationPort extends ChatNavigationPort {
+    address(): string;
+}
+export declare function createMemoryNavigation(options?: MemoryNavigationOptions): MemoryNavigationPort;

package/dist/host/defaults/memory-navigation.js

@@ -0,0 +1,102 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { useSyncExternalStore } from "react";
+const LOCAL_ORIGIN = "https://chat.memory.local";
+function defaultOpenExternal(href) {
+  if (typeof window !== "undefined") window.open(href, "_blank", "noopener,noreferrer");
+}
+function createMemoryNavigation(options = {}) {
+  const home = options.home ?? "/chat";
+  const openExternal = options.openExternal ?? defaultOpenExternal;
+  let address = options.initial && options.initial.startsWith("/") ? options.initial : home;
+  const listeners = /* @__PURE__ */ new Set();
+  const history = [];
+  const ahead = [];
+  const set = (next) => {
+    if (next === address) return;
+    address = next;
+    for (const listener of listeners) listener();
+    options.persist?.(next);
+  };
+  const toAddress = (href) => {
+    try {
+      const url = new URL(href, LOCAL_ORIGIN + address);
+      return url.origin === LOCAL_ORIGIN ? url.pathname + url.search : null;
+    } catch {
+      return null;
+    }
+  };
+  const go = (href, mode) => {
+    const next = toAddress(href);
+    if (next === null) {
+      openExternal(href);
+      return;
+    }
+    if (mode === "push" && next !== address) {
+      history.push(address);
+      ahead.length = 0;
+    }
+    set(next);
+  };
+  const router = {
+    push: (href) => go(href, "push"),
+    replace: (href) => go(href, "replace"),
+    back: () => {
+      ahead.push(address);
+      set(history.pop() ?? home);
+    },
+    forward: () => {
+      const next = ahead.pop();
+      if (next === void 0) return;
+      history.push(address);
+      set(next);
+    },
+    refresh: () => void 0,
+    prefetch: () => void 0
+  };
+  const subscribe = (listener) => {
+    listeners.add(listener);
+    return () => {
+      listeners.delete(listener);
+    };
+  };
+  const useAddress = () => useSyncExternalStore(subscribe, () => address, () => address);
+  let cached = null;
+  const paramsFor = (current) => {
+    if (cached?.address !== current) {
+      cached = { address: current, params: new URLSearchParams(current.split("?")[1] ?? "") };
+    }
+    return cached.params;
+  };
+  function MemoryLink({ href, children, onClick, prefetch, replace, scroll, ...anchor }) {
+    void prefetch;
+    void scroll;
+    return /* @__PURE__ */ jsx(
+      "a",
+      {
+        ...anchor,
+        href,
+        onClick: (event) => {
+          onClick?.(event);
+          if (event.defaultPrevented || event.metaKey || event.ctrlKey || event.shiftKey) return;
+          event.preventDefault();
+          go(href, replace ? "replace" : "push");
+        },
+        children
+      }
+    );
+  }
+  return {
+    address: () => address,
+    push: router.push,
+    replace: router.replace,
+    back: router.back,
+    useRouter: () => router,
+    usePathname: () => useAddress().split("?")[0] || home,
+    useSearchParams: () => paramsFor(useAddress()),
+    Link: MemoryLink
+  };
+}
+export {
+  createMemoryNavigation
+};

package/dist/host/index.d.ts

@@ -12,6 +12,7 @@ export { createDefaultServer, DEFAULT_CHAT_SERVER_URL, } from "./defaults/server
 export { createDomNotifier } from "./defaults/notify.js";
 export { createWebPrefs, createHostKeptPrefs, CHAT_PREFS_PREFIX, type HostKeptPrefs } from "./defaults/prefs.js";
 export { createWindowNavigation } from "./defaults/navigation.js";
+export { createMemoryNavigation, type MemoryNavigationOptions, type MemoryNavigationPort, } from "./defaults/memory-navigation.js";
 export { createUnhostedWindows } from "./defaults/windows.js";
 export { CHAT_WINDOWS, CHAT_WINDOW_IDS, DEFAULT_WINDOW_INSTANCE_ID, isChatWindowId, type ChatWindowId, } from "./windows.js";
 export type { ChatWindowOpeners } from "./window-openers.js";

package/dist/host/index.js

@@ -29,6 +29,9 @@ import {
 import { createDomNotifier } from "./defaults/notify.js";
 import { createWebPrefs, createHostKeptPrefs, CHAT_PREFS_PREFIX } from "./defaults/prefs.js";
 import { createWindowNavigation } from "./defaults/navigation.js";
+import {
+  createMemoryNavigation
+} from "./defaults/memory-navigation.js";
 import { createUnhostedWindows } from "./defaults/windows.js";
 import {
   CHAT_WINDOWS,
@@ -89,6 +92,7 @@ export {
   createDomNotifier,
   createHostKeptPrefs,
   createLogClientErrorDiagnostics,
+  createMemoryNavigation,
   createNoDatabaseStandIn,
   createNoPickerOrg,
   createStoredOrg,

package/dist/host/ui-slots.js

@@ -11,10 +11,21 @@ import { DefaultFullScreenOverlay, DefaultWindowPanel } from "./defaults/window-
 import { DefaultSettingControlInput } from "./defaults/setting-control-input.js";
 import { DefaultResourcePickerMenu } from "./defaults/resource-picker-menu.js";
 import { captureReactRenderError } from "./diagnostics.js";
-import { ConfirmDialog as PackageConfirmDialog } from "@ai-matrx/design-system";
 import {
+  ConfirmDialog as PackageConfirmDialog,
+  FloatingSheet as PackageFloatingSheet,
+  ReadFailure as PackageReadFailure,
+  TextInputDialog as PackageTextInputDialog,
+  UntrustedCount as PackageUntrustedCount
+} from "@ai-matrx/design-system";
+import {
+  AspectRatioSelect as PackageAspectRatioSelect,
   ClampedNumberInput as PackageClampedNumberInput,
+  ConfigurationTable as PackageConfigurationTable,
+  ConfigurationTableRow as PackageConfigurationTableRow,
+  FieldHelp as PackageFieldHelp,
   LightSwitchToggle as PackageLightSwitchToggle,
+  OptionCombobox as PackageOptionCombobox,
   NumberStepper as PackageNumberStepper
 } from "@ai-matrx/design-system/controls";
 const slots = {};
@@ -46,7 +57,9 @@ function slotComponent(name, Fallback) {
     const Impl = slots[name];
     if (!Impl) {
       const absent = !Fallback || Fallback.optionalAbsent;
-      reportUnregistered(name, absent ? "it renders nothing here" : "a plain stand-in is drawn");
+      if (!Fallback?.isPackageDefault) {
+        reportUnregistered(name, absent ? "it renders nothing here" : "a plain stand-in is drawn");
+      }
       return Fallback ? createElement(SlotBoundary, { name }, createElement(Fallback, props)) : null;
     }
     return createElement(SlotBoundary, { name }, createElement(Impl, props));
@@ -57,6 +70,7 @@ function slotComponent(name, Fallback) {
 function withPackageDefault(Component2) {
   const PackageDefault = (props) => createElement(Component2, props);
   PackageDefault.displayName = `PackageDefault(${Component2.displayName ?? Component2.name ?? "component"})`;
+  PackageDefault.isPackageDefault = true;
   return PackageDefault;
 }
 function unregisteredWidget(name) {
@@ -317,9 +331,9 @@ const useRecordAndTranscribe = slotFn("useRecordAndTranscribe");
 const requestScribeAudioSeek = slotFn("requestScribeAudioSeek", () => void 0);
 const resolvePdfSurfaceIds = slotFn("resolvePdfSurfaceIds");
 const readListRpc = slotFn("readListRpc");
-const ReadFailure = slotComponent("ReadFailure", unregisteredWidget("ReadFailure"));
+const ReadFailure = slotComponent("ReadFailure", withPackageDefault(PackageReadFailure));
 const ItemRow = slotComponent("ItemRow", unregisteredWidget("ItemRow"));
-const UntrustedCount = slotComponent("UntrustedCount", unregisteredWidget("UntrustedCount"));
+const UntrustedCount = slotComponent("UntrustedCount", withPackageDefault(PackageUntrustedCount));
 function PlainStaleDataNotice(props) {
   const what = props.what ?? "this";
   const sentence = props.hasData ? `Showing what was last read; ${what} could not be refreshed.` : `Could not read ${what}.`;
@@ -347,12 +361,12 @@ const StructuredValueView = slotComponent("StructuredValueView", unregisteredWid
 const KindValueFrontDoor = slotComponent("KindValueFrontDoor", unregisteredWidget("KindValueFrontDoor"));
 const KindDataGate = slotComponent("KindDataGate", unregisteredWidget("KindDataGate"));
 const ServerNotes = slotComponent("ServerNotes", unregisteredWidget("ServerNotes"));
-const OptionCombobox = slotComponent("OptionCombobox", unregisteredWidget("OptionCombobox"));
+const OptionCombobox = slotComponent("OptionCombobox", withPackageDefault(PackageOptionCombobox));
 const NumberStepper = slotComponent("NumberStepper", withPackageDefault(PackageNumberStepper));
 const MatrxFloatingFrame = slotComponent("MatrxFloatingFrame", unregisteredWidget("MatrxFloatingFrame"));
 const ItemMenu = slotComponent("ItemMenu", unregisteredWidget("ItemMenu"));
 const ClampedNumberInput = slotComponent("ClampedNumberInput", withPackageDefault(PackageClampedNumberInput));
-const AspectRatioSelect = slotComponent("AspectRatioSelect", unregisteredWidget("AspectRatioSelect"));
+const AspectRatioSelect = slotComponent("AspectRatioSelect", withPackageDefault(PackageAspectRatioSelect));
 const AnswerTextPreview = slotComponent("AnswerTextPreview", unregisteredWidget("AnswerTextPreview"));
 const AccessGate = slotComponent("AccessGate", unregisteredWidget("AccessGate"));
 const ReferenceCopyMenuItem = slotComponent("ReferenceCopyMenuItem", unregisteredWidget("ReferenceCopyMenuItem"));
@@ -369,16 +383,16 @@ const VoiceTextarea = slotComponent("VoiceTextarea", (props) => {
   const { onChange, value, className, placeholder, rows, id, ref, autoFocus, disabled } = props;
   return createElement("textarea", { ref, id, value, onChange, className, placeholder, rows, autoFocus, disabled, "data-chat-slot-fallback": "textarea" });
 });
-const FloatingSheet = slotComponent("FloatingSheet", unregisteredWidget("FloatingSheet"));
+const FloatingSheet = slotComponent("FloatingSheet", withPackageDefault(PackageFloatingSheet));
 const AppLink = slotComponent("AppLink", ({ href, children, className, ...rest }) => createElement("a", { href, className, ...rest }, children));
 const IconButton = slotComponent("IconButton", unregisteredWidget("IconButton"));
 const LightSwitchToggle = slotComponent("LightSwitchToggle", withPackageDefault(PackageLightSwitchToggle));
 const CitationChip = slotComponent("CitationChip", unregisteredWidget("CitationChip"));
 const MatrxEnvelopeBlock = slotComponent("MatrxEnvelopeBlock", unregisteredWidget("MatrxEnvelopeBlock"));
 const ErrorBoundaryWithCapture = slotComponent("ErrorBoundaryWithCapture", ({ children }) => children ?? null);
-const ConfigurationTable = slotComponent("ConfigurationTable", unregisteredWidget("ConfigurationTable"));
-const ConfigurationTableRow = slotComponent("ConfigurationTableRow", unregisteredWidget("ConfigurationTableRow"));
-const FieldHelp = slotComponent("FieldHelp", unregisteredWidget("FieldHelp"));
+const ConfigurationTable = slotComponent("ConfigurationTable", withPackageDefault(PackageConfigurationTable));
+const ConfigurationTableRow = slotComponent("ConfigurationTableRow", withPackageDefault(PackageConfigurationTableRow));
+const FieldHelp = slotComponent("FieldHelp", withPackageDefault(PackageFieldHelp));
 const HtmlPreviewFullScreenEditor = slotComponent("HtmlPreviewFullScreenEditor", unregisteredWidget("HtmlPreviewFullScreenEditor"));
 const AgentEditAccessBadge = slotComponent("AgentEditAccessBadge", unregisteredWidget("AgentEditAccessBadge"));
 const DataRefPreviewContent = slotComponent("DataRefPreviewContent", unregisteredWidget("DataRefPreviewContent"));
@@ -499,7 +513,7 @@ const CustomDataBindingSummary = slotComponent("CustomDataBindingSummary", unreg
 const CustomDataBindingPreview = slotComponent("CustomDataBindingPreview", unregisteredWidget("CustomDataBindingPreview"));
 const AiModelRef = slotComponent("AiModelRef", unregisteredWidget("AiModelRef"));
 const AiToolRef = slotComponent("AiToolRef", unregisteredWidget("AiToolRef"));
-const TextInputDialog = slotComponent("TextInputDialog", unregisteredWidget("TextInputDialog"));
+const TextInputDialog = slotComponent("TextInputDialog", withPackageDefault(PackageTextInputDialog));
 const ProInput = slotComponent("ProInput", (props) => createElement("input", { ...props, "data-chat-slot-fallback": "input" }));
 const MatrxDynamicPanelHost = slotComponent("MatrxDynamicPanelHost", unregisteredWidget("MatrxDynamicPanelHost"));
 const useClippedContentGuard = slotFn("useClippedContentGuard");

package/dist/ui/aspect-ratio-options.d.ts

@@ -1,28 +1,6 @@
 /**
- * Aspect-ratio option sets — recognising them and ordering them for a picker.
- *
- * Model catalogs expose aspect ratio as a plain string enum ("1:1", "16:9",
- * "9:19.5", Runway's pixel pairs "1280:720", plus words like "auto" or
- * "match_input_image"). Any option list that is mostly ratios renders through
- * `AspectRatioSelect` — wherever it came from — so the rule lives on the data,
- * not on one control key.
+ * Aspect-ratio option sets — the one copy lives in `@ai-matrx/design-system/controls`
+ * (moved there with `AspectRatioSelect`, chat host-slot batch 2, 2026-10-08).
+ * This subpath keeps `@ai-matrx/chat/ui/aspect-ratio-options` importers working.
  */
-export interface ParsedRatio {
-    w: number;
-    h: number;
-}
-export declare function parseRatio(value: string): ParsedRatio | null;
-/** True when at least two options and every option but the words is a ratio. */
-export declare function isAspectRatioOptionSet(options: readonly string[]): boolean;
-/** "Square", "Landscape", … — a plain word for the shape. */
-export declare function ratioShapeName(value: string): string | null;
-/** Words that are not ratios ("auto", "match_input_image") read as words. */
-export declare function humanizeRatioWord(value: string): string;
-export interface RatioGroups {
-    /** Non-ratio words first (Auto, Match input image). */
-    words: string[];
-    common: string[];
-    more: string[];
-}
-/** Split options into words, common ratios (fixed order) and the rest (by shape). */
-export declare function groupRatioOptions(options: readonly string[]): RatioGroups;
+export { parseRatio, isAspectRatioOptionSet, ratioShapeName, humanizeRatioWord, groupRatioOptions, type ParsedRatio, type RatioGroups, } from "@ai-matrx/design-system/controls";

package/dist/ui/aspect-ratio-options.js

@@ -1,78 +1,10 @@
-import { humanizeIdentifier } from "@ai-matrx/kit/text-case";
-const RATIO_RE = /^\s*(\d+(?:\.\d+)?)\s*[:x×/]\s*(\d+(?:\.\d+)?)\s*$/i;
-function parseRatio(value) {
-  const m = RATIO_RE.exec(value);
-  if (!m) return null;
-  const w = Number(m[1]);
-  const h = Number(m[2]);
-  if (!(w > 0 && h > 0)) return null;
-  return { w, h };
-}
-function isAspectRatioOptionSet(options) {
-  const ratios = options.filter((o) => parseRatio(o) !== null).length;
-  return ratios >= 2 && ratios >= options.length - 2;
-}
-const COMMON_ORDER = [
-  "1:1",
-  "16:9",
-  "9:16",
-  "4:3",
-  "3:4",
-  "3:2",
-  "2:3",
-  "4:5",
-  "5:4",
-  "21:9"
-];
-function reduced(r) {
-  const scale = 1e3;
-  let a = Math.round(r.w * scale);
-  let b = Math.round(r.h * scale);
-  const gcd = (x, y) => y === 0 ? x : gcd(y, x % y);
-  const g = gcd(a, b);
-  a /= g;
-  b /= g;
-  return `${a}:${b}`;
-}
-function ratioShapeName(value) {
-  const r = parseRatio(value);
-  if (!r) return null;
-  const k = r.w / r.h;
-  if (Math.abs(k - 1) < 0.02) return "Square";
-  if (k >= 2.2) return "Ultrawide";
-  if (k <= 1 / 2.2) return "Tall";
-  if (k > 1.6) return "Widescreen";
-  if (k < 1 / 1.6) return "Story";
-  return k > 1 ? "Landscape" : "Portrait";
-}
-function humanizeRatioWord(value) {
-  return humanizeIdentifier(value) || value;
-}
-function groupRatioOptions(options) {
-  const words = [];
-  const ratioOpts = [];
-  for (const o of options) (parseRatio(o) ? ratioOpts : words).push(o);
-  const byReduced = /* @__PURE__ */ new Map();
-  for (const o of ratioOpts) {
-    const key = reduced(parseRatio(o));
-    if (!byReduced.has(key)) byReduced.set(key, o);
-  }
-  const common = [];
-  for (const c of COMMON_ORDER) {
-    const hit = byReduced.get(reduced(parseRatio(c)));
-    if (hit) common.push(hit);
-  }
-  const commonSet = new Set(common);
-  const more = ratioOpts.filter((o) => !commonSet.has(o)).sort((a, b) => {
-    const ra = parseRatio(a);
-    const rb = parseRatio(b);
-    return rb.w / rb.h - ra.w / ra.h;
-  });
-  if (ratioOpts.length <= 6) {
-    return { words, common: [...common, ...more], more: [] };
-  }
-  return { words, common, more };
-}
+import {
+  parseRatio,
+  isAspectRatioOptionSet,
+  ratioShapeName,
+  humanizeRatioWord,
+  groupRatioOptions
+} from "@ai-matrx/design-system/controls";
 export {
   groupRatioOptions,
   humanizeRatioWord,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.4.24",
+  "version": "0.4.26",
   "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",
@@ -234,18 +234,18 @@
     "@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/icons": "latest",
-    "@ai-matrx/design-system": "latest",
-    "@ai-matrx/kit": "latest",
     "@ai-matrx/media": "latest",
     "@ai-matrx/print": "latest",
+    "@ai-matrx/kit": "latest",
     "@ai-matrx/realtime": "latest",
     "@ai-matrx/records": "latest",
     "@ai-matrx/records-ui": "latest",
+    "@ai-matrx/rich-content": "latest",
     "@ai-matrx/rich-editor": "latest",
-    "@ai-matrx/tap-target": "latest",
-    "@ai-matrx/rich-content": "latest"
+    "@ai-matrx/tap-target": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",