@ai-matrx/chat 0.4.26 → 0.4.29

package/CHANGELOG.md

@@ -1,5 +1,32 @@
 # @ai-matrx/chat
 
+## 0.4.29 — a bare host needs only a db: identity and rich-content optionals are the package's own
+
+- The signed-in user, email, name and admin level the package reads (`buildAmbientContext`,
+  `isFingerprintGuestExecution`) come from its own `chatHost.identity`, never a host `userAuth` /
+  `userProfile` slice. P24g's host-read allow-list is now empty.
+- `useHideReasoning`, `useHideToolResults`, `useMachineFramesVisible` answer from chat's own settings
+  when the host registers no rich-content `app` bindings; `useDocumentDialogsHost`, `RecordAnnotations`
+  and `resolveArtifactDef` are quiet optionals. No warning for them on a bare host. Guard:
+  `a-bare-host-gets-the-rich-content-optionals-quietly.test.tsx`.
+
+Consumer action: none (a host's own `app` bindings still replace these wholesale).
+
+## 0.4.28 — IconButton is the real one in any host
+
+- The `IconButton` slot defaults to `@ai-matrx/design-system` 0.83.0's `IconButton` (the website's,
+  moved whole). Guard: `slots-draw-their-package-default.test.tsx`.
+
+Consumer action: none (a host's own registration still wins).
+
+## 0.4.27 — the error card and the stale-data notice are the real ones in any host
+
+- `ErrorNotice` and `StaleDataNotice` slots default to `@ai-matrx/design-system`'s components (the
+  website's, moved whole); the package's plain stand-ins are gone. Guard:
+  `slots-draw-their-package-default.test.tsx`.
+
+Consumer action: none.
+
 ## 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.

package/dist/agents/coding-session-reply/CodingReplyNotice.d.ts

@@ -0,0 +1,15 @@
+/**
+ * The one visible "who answers here" notice on a mirrored coding-session
+ * conversation: always in plain sight (never a tooltip), always the server's
+ * sentence, and the announced stand-in when the platform default is answering.
+ * It is the only thing between a reply box and a person believing they just
+ * messaged their coding tool. Renders nothing for an ordinary conversation.
+ */
+import * as React from "react";
+import { type ReplyDoorState } from "./reply-door.js";
+export declare function CodingReplyNotice({ state, labelId, className, }: {
+    state: ReplyDoorState;
+    /** Id for the sentence, so a refused field can point `aria-describedby` at it. */
+    labelId?: string;
+    className?: string;
+}): React.JSX.Element | null;

package/dist/agents/coding-session-reply/CodingReplyNotice.js

@@ -0,0 +1,60 @@
+import { jsx, jsxs } from "react/jsx-runtime";
+import { AlertTriangle, Info, Loader2 } from "lucide-react";
+import { ErrorAlchemyMenu } from "../../host/ui-slots.js";
+import { replyDoorErrorSentence, replyDoorView } from "./reply-door.js";
+function CodingReplyNotice({
+  state,
+  labelId,
+  className
+}) {
+  const door = replyDoorView(state);
+  const warn = "flex items-start gap-2 text-xs text-amber-700 dark:text-amber-300";
+  let line = null;
+  if (state.status === "loading") {
+    line = /* @__PURE__ */ jsxs("p", { className: "flex items-center gap-2 text-xs text-muted-foreground", "data-testid": "reply-door-checking", children: [
+      /* @__PURE__ */ jsx(Loader2, { className: "h-3.5 w-3.5 shrink-0 animate-spin" }),
+      /* @__PURE__ */ jsx("span", { children: "Checking who answers here\u2026" })
+    ] });
+  } else if (state.status === "error") {
+    line = /* @__PURE__ */ jsxs("p", { className: warn, "data-testid": "reply-door-error", children: [
+      /* @__PURE__ */ jsx(AlertTriangle, { className: "mt-0.5 h-3.5 w-3.5 shrink-0" }),
+      /* @__PURE__ */ jsxs("span", { children: [
+        replyDoorErrorSentence(state.error),
+        " ",
+        /* @__PURE__ */ jsx(ErrorAlchemyMenu, { error: state.error })
+      ] })
+    ] });
+  } else if (door.label) {
+    line = /* @__PURE__ */ jsxs("p", { id: labelId, className: warn, "data-testid": "reply-door-label", children: [
+      /* @__PURE__ */ jsx(AlertTriangle, { className: "mt-0.5 h-3.5 w-3.5 shrink-0" }),
+      /* @__PURE__ */ jsx("span", { children: door.label })
+    ] });
+  } else if (door.refusalSentence) {
+    line = /* @__PURE__ */ jsxs("p", { id: labelId, className: warn, "data-testid": "reply-door-label", children: [
+      /* @__PURE__ */ jsx(AlertTriangle, { className: "mt-0.5 h-3.5 w-3.5 shrink-0" }),
+      /* @__PURE__ */ jsxs("span", { children: [
+        door.refusalSentence,
+        " ",
+        /* @__PURE__ */ jsx(ErrorAlchemyMenu, { error: door.refusalSentence })
+      ] })
+    ] });
+  }
+  if (!line && !door.standInNotice) return null;
+  return /* @__PURE__ */ jsxs("div", { className, "data-testid": "coding-reply-notice", children: [
+    line,
+    door.standInNotice ? /* @__PURE__ */ jsxs(
+      "p",
+      {
+        className: "mt-1 flex items-start gap-2 text-[11px] leading-relaxed text-muted-foreground",
+        "data-testid": "reply-door-stand-in",
+        children: [
+          /* @__PURE__ */ jsx(Info, { className: "mt-0.5 h-3 w-3 shrink-0" }),
+          /* @__PURE__ */ jsx("span", { children: door.standInNotice })
+        ]
+      }
+    ) : null
+  ] });
+}
+export {
+  CodingReplyNotice
+};

package/dist/agents/coding-session-reply/reply-door.d.ts

@@ -0,0 +1,53 @@
+/**
+ * The reply door on a mirrored coding-session conversation — ONE decision for
+ * every app (website `/work/conversations`, Matrx Local Cloud Chat, the package
+ * chat). Moved here from the two copies the website and the desktop each kept.
+ *
+ * Everything is derived from the server's report
+ * (`GET /coding-sessions/conversations/{id}/responder`). Nothing is invented:
+ * the label, the refusal sentence and the stand-in notice are the server's
+ * strings, composed from the same resolution that picks the answering agent,
+ * and `inputBlocked` follows the server's `can_reply` — the very predicate the
+ * reply POST gates on. Never re-derive, re-word or template those sentences,
+ * and never keep a client-side one as a fallback (V-XT/V3, 2026-09-15: a
+ * hardcoded "AI Matrx is answering" hid a silent platform-default stand-in).
+ */
+import type { components } from "@ai-matrx/agents/generated/api-types";
+export type CodingReplyResponderReport = components["schemas"]["CodingReplyResponderReport"];
+/**
+ * The `source_feature` a reply from this door carries. aidream reads it to
+ * stamp `metadata.origin = "ai_matrx_reply"` and the responder's `agent_id`
+ * onto both the reply and the answer.
+ */
+export declare const CODING_SESSION_REPLY_SOURCE_FEATURE = "coding_session_reply";
+export type ReplyDoorStatus = "idle" | "loading" | "ready" | "error";
+export interface ReplyDoorState {
+    status: ReplyDoorStatus;
+    /** The server's report. Null until it lands and after a failed read. */
+    report: CodingReplyResponderReport | null;
+    /** The read's own failure, in the server's words. Null unless status is "error". */
+    error: string | null;
+}
+export interface ReplyDoorView {
+    /** True when this conversation is a mirrored coding session at all. */
+    isMirror: boolean;
+    /** The server's sentence naming who answers, or null when it said nothing. */
+    label: string | null;
+    /** Shown when the server refuses the reply: its label, else its reason. */
+    refusalSentence: string | null;
+    /** The platform-default stand-in notice, only when a stand-in was used. */
+    standInNotice: string | null;
+    /** True while we do not yet know, or the server refused the reply. */
+    inputBlocked: boolean;
+    /** True only when the SERVER refused (never for a pending or failed read). */
+    replyRefused: boolean;
+    /** The composer placeholder for this state. */
+    placeholder: string;
+    /** What a send from this door files itself as, or null for a normal chat. */
+    sourceFeature: string | null;
+}
+export declare const REPLY_DOOR_PLACEHOLDER = "Ask AI Matrx about this session, or say what to do next.";
+export declare const REPLY_DOOR_REFUSED_PLACEHOLDER = "A reply cannot be sent here.";
+export declare function replyDoorView(state: ReplyDoorState): ReplyDoorView;
+/** The sentence a failed read shows — the real error, never a shrug. */
+export declare function replyDoorErrorSentence(error: string | null): string;

package/dist/agents/coding-session-reply/reply-door.js

@@ -0,0 +1,40 @@
+const CODING_SESSION_REPLY_SOURCE_FEATURE = "coding_session_reply";
+const REPLY_DOOR_PLACEHOLDER = "Ask AI Matrx about this session, or say what to do next.";
+const REPLY_DOOR_REFUSED_PLACEHOLDER = "A reply cannot be sent here.";
+const NOTHING = {
+  isMirror: false,
+  label: null,
+  refusalSentence: null,
+  standInNotice: null,
+  replyRefused: false,
+  placeholder: REPLY_DOOR_PLACEHOLDER,
+  sourceFeature: null
+};
+function replyDoorView(state) {
+  if (state.status === "loading") return { ...NOTHING, inputBlocked: true };
+  if (state.status !== "ready" || state.report === null) return { ...NOTHING, inputBlocked: false };
+  const report = state.report;
+  const isMirror = report.is_coding_session_mirror === true;
+  const label = isMirror && report.composer_label ? report.composer_label : null;
+  const refused = report.can_reply !== true;
+  return {
+    isMirror,
+    label,
+    refusalSentence: refused ? label ?? report.reason ?? null : null,
+    standInNotice: report.responder?.used_platform_default ? report.stand_in_notice ?? null : null,
+    inputBlocked: refused,
+    replyRefused: refused,
+    placeholder: refused ? REPLY_DOOR_REFUSED_PLACEHOLDER : REPLY_DOOR_PLACEHOLDER,
+    sourceFeature: isMirror ? CODING_SESSION_REPLY_SOURCE_FEATURE : null
+  };
+}
+function replyDoorErrorSentence(error) {
+  return `Who answers here could not be loaded, so this screen is not naming anyone: ${error || "no reason given"}`;
+}
+export {
+  CODING_SESSION_REPLY_SOURCE_FEATURE,
+  REPLY_DOOR_PLACEHOLDER,
+  REPLY_DOOR_REFUSED_PLACEHOLDER,
+  replyDoorErrorSentence,
+  replyDoorView
+};

package/dist/agents/coding-session-reply/useChatServerResponderRead.d.ts

@@ -0,0 +1,6 @@
+/**
+ * The responder read through the chat package's own server port — for hosts
+ * that configured `@ai-matrx/chat/host` (the package chat on every app).
+ */
+import type { CodingReplyResponderRead } from "./useCodingReplyResponder.js";
+export declare function useChatServerResponderRead(organizationId?: string | null): CodingReplyResponderRead;

package/dist/agents/coding-session-reply/useChatServerResponderRead.js

@@ -0,0 +1,28 @@
+import { useCallback } from "react";
+import { extractErrorMessage } from "@ai-matrx/data/net";
+import { useAppDispatch } from "../../store/hooks.js";
+import { callApi } from "../../host/server/call-api.js";
+function useChatServerResponderRead(organizationId) {
+  const dispatch = useAppDispatch();
+  return useCallback(
+    async (conversationId) => {
+      const result = await dispatch(
+        callApi({
+          path: "/coding-sessions/conversations/{conversation_id}/responder",
+          method: "GET",
+          pathParams: { conversation_id: conversationId },
+          scopeOverrides: organizationId ? { organization_id: organizationId } : void 0
+        })
+      );
+      if (result.error) {
+        const detail = result.error.serverDetail ? extractErrorMessage(result.error.serverDetail) : "";
+        throw new Error(detail || result.error.message || "Unknown error");
+      }
+      return result.data ?? null;
+    },
+    [dispatch, organizationId]
+  );
+}
+export {
+  useChatServerResponderRead
+};

package/dist/agents/coding-session-reply/useCodingReplyResponder.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Who answers a reply typed on this conversation, asked BEFORE the person
+ * types. The hook holds nothing but the server's answer and the state of
+ * asking for it; every sentence comes from `replyDoorView`.
+ *
+ * The read itself is the host's (`read`): the website reads through its API
+ * door, the desktop through its custodian token, the package chat through the
+ * chat server port (`useChatServerResponderRead`). A fast conversation switch
+ * never paints one conversation's responder onto another's composer.
+ */
+import type { CodingReplyResponderReport, ReplyDoorState } from "./reply-door.js";
+export type CodingReplyResponderRead = (conversationId: string, signal: AbortSignal) => Promise<CodingReplyResponderReport>;
+export declare function useCodingReplyResponder(opts: {
+    conversationId: string | null;
+    /** Read only where a reply can be typed; `false` makes no request (idle). */
+    enabled: boolean;
+    read: CodingReplyResponderRead;
+}): ReplyDoorState & {
+    refresh: () => void;
+};

package/dist/agents/coding-session-reply/useCodingReplyResponder.js

@@ -0,0 +1,37 @@
+import { useCallback, useEffect, useRef, useState } from "react";
+const IDLE = { status: "idle", report: null, error: null };
+function useCodingReplyResponder(opts) {
+  const { conversationId, enabled, read } = opts;
+  const [state, setState] = useState(enabled && conversationId ? { ...IDLE, status: "loading" } : IDLE);
+  const [attempt, setAttempt] = useState(0);
+  const refresh = useCallback(() => setAttempt((value) => value + 1), []);
+  const readRef = useRef(read);
+  readRef.current = read;
+  const wanted = useRef(null);
+  useEffect(() => {
+    if (!enabled || !conversationId) {
+      wanted.current = null;
+      setState(IDLE);
+      return;
+    }
+    wanted.current = conversationId;
+    const controller = new AbortController();
+    let cancelled = false;
+    setState({ status: "loading", report: null, error: null });
+    readRef.current(conversationId, controller.signal).then((report) => {
+      if (cancelled || wanted.current !== conversationId) return;
+      setState({ status: "ready", report: report ?? null, error: null });
+    }).catch((cause) => {
+      if (cancelled || controller.signal.aborted || wanted.current !== conversationId) return;
+      setState({ status: "error", report: null, error: cause instanceof Error ? cause.message : String(cause) });
+    });
+    return () => {
+      cancelled = true;
+      controller.abort();
+    };
+  }, [attempt, conversationId, enabled]);
+  return { ...state, refresh };
+}
+export {
+  useCodingReplyResponder
+};

package/dist/agents/components/messages-display/assistant/AssistantMessageFooter.d.ts

@@ -16,6 +16,7 @@
  * is read from Redux.
  */
 import React from "react";
+import "../../../../ui/markdown-stream/rich-content-defaults.js";
 export interface AssistantMessageFooterProps {
     /** Server `cx_message.id`. */
     messageId: string;

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

@@ -32,6 +32,7 @@ import { buildConversationMessageTitle } from "../../../utils/conversation-messa
 import { resolveAssistantEditTarget } from "../message-options/resolveAssistantEditTarget.js";
 import { MessageTimestamp } from "../MessageTimestamp.js";
 import { useTranscriptLayout } from "../../shared/transcript-layout.js";
+import "../../../../ui/markdown-stream/rich-content-defaults.js";
 function useAssistantMessageActions({
   messageId,
   conversationId,

package/dist/agents/components/messages-display/user/UserActionBar.d.ts

@@ -1,4 +1,5 @@
 import React from "react";
+import "../../../../ui/markdown-stream/rich-content-defaults.js";
 export interface UserActionBarProps {
     /**
      * Flat-text rendering of the user's message — or, when `structuredRaw` is

package/dist/agents/components/messages-display/user/UserActionBar.js

@@ -28,6 +28,7 @@ import { DeleteMessageDialog } from "../message-options/DeleteMessageDialog.js";
 import { openStructuredRawViewer } from "../message-options/openAssistantMessageEditor.js";
 import { extractErrorMessage } from "@ai-matrx/data/net";
 import { useConversationAbilities } from "../../../redux/execution-system/host-conversations/conversation-abilities.js";
+import "../../../../ui/markdown-stream/rich-content-defaults.js";
 import {
   USER_EDIT_ACTIONS,
   routeUserEditAction

package/dist/agents/redux/execution-system/instance-user-input/append-to-composer-draft.thunk.d.ts

@@ -0,0 +1,3 @@
+import type { ChatDispatch, ChatRootState } from "../../../../store/root-state.js";
+export declare function appendedDraftText(current: string, text: string): string;
+export declare function appendToComposerDraft(conversationId: string, text: string): (dispatch: ChatDispatch, getState: () => ChatRootState) => string;

package/dist/agents/redux/execution-system/instance-user-input/append-to-composer-draft.thunk.js

@@ -0,0 +1,19 @@
+import { setUserInputText } from "./instance-user-input.slice.js";
+function appendedDraftText(current, text) {
+  const trimmed = current.trimEnd();
+  return trimmed ? `${trimmed}
+${text}` : text;
+}
+function appendToComposerDraft(conversationId, text) {
+  return (dispatch, getState) => {
+    if (!text) return getState().instanceUserInput.byConversationId[conversationId]?.text ?? "";
+    const current = getState().instanceUserInput.byConversationId[conversationId]?.text ?? "";
+    const next = appendedDraftText(current, text);
+    dispatch(setUserInputText({ conversationId, text: next }));
+    return next;
+  };
+}
+export {
+  appendToComposerDraft,
+  appendedDraftText
+};

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

@@ -1,5 +1,6 @@
 import { adminLaneOrganizationId } from "../../../../host/server/admin-lane.js";
 import { selectOrganizationId } from "../../../../host/org.js";
+import { chatHostHasDatabase } from "../../../../host/configure.js";
 import { selectAccessToken, selectFingerprintId } from "../../../../host/identity.js";
 function isFingerprintGuestExecution(state) {
   return !selectAccessToken(state) && Boolean(selectFingerprintId(state));
@@ -34,7 +35,8 @@ function requireExecutionOrganizationId(state, conversationId) {
     throw new Error(`Conversation ${conversationId} not found.`);
   }
   if (instance.cacheOnly !== false) {
-    const startOrganizationId = instance.organizationId ?? adminLaneOrganizationId() ?? selectOrganizationId(state);
+    const startOrganizationId = instance.organizationId ?? // A host with no database has no admin seat to bill (G-DOOR: this door branches on the host).
+    (chatHostHasDatabase() ? adminLaneOrganizationId() : void 0) ?? selectOrganizationId(state);
     if (startOrganizationId) return startOrganizationId;
     throw new Error(
       "Select an organization before sending this message. The request was not sent."

package/dist/host/conversation-hooks.d.ts

@@ -73,7 +73,11 @@ export declare function tapStreamEvent(conversationId: string, requestId: string
 export declare function continuesThroughMandate(conversationId: string): boolean;
 /** Ask the conversation's host for the next conversation id; null when it has no say. */
 export declare function startHostConversation(conversationId: string): Promise<string | null>;
-/** Subscribe to changes of this conversation's held sentence (registry + the host's own source). */
+/**
+ * Subscribe to changes of this conversation's held sentence: the host's own
+ * source, and the registry (a registration swaps which source is listened to).
+ * Never re-subscribes from inside the source's own notification.
+ */
 export declare function subscribeConversationHeld(conversationId: string | null | undefined, listener: () => void): () => void;
 /** The held sentence right now, or null. */
 export declare function readConversationHeld(conversationId: string | null | undefined): string | null;

package/dist/host/conversation-hooks.js

@@ -3,7 +3,7 @@ const hooksByConversation = /* @__PURE__ */ new Map();
 const extrasByConversation = /* @__PURE__ */ new Map();
 const registryListeners = /* @__PURE__ */ new Set();
 function notifyRegistry() {
-  for (const listener of registryListeners) listener();
+  for (const listener of [...registryListeners]) listener();
 }
 function registerConversationHooks(conversationId, hooks) {
   hooksByConversation.set(conversationId, hooks);
@@ -11,7 +11,6 @@ function registerConversationHooks(conversationId, hooks) {
   return () => {
     if (hooksByConversation.get(conversationId) === hooks) {
       hooksByConversation.delete(conversationId);
-      extrasByConversation.delete(conversationId);
       notifyRegistry();
     }
   };
@@ -58,20 +57,23 @@ async function startHostConversation(conversationId) {
   return start ? start() : null;
 }
 function subscribeConversationHeld(conversationId, listener) {
-  let release = subscribeOnce(conversationId, onChange);
-  function onChange() {
-    release();
-    release = subscribeOnce(conversationId, onChange);
+  let current;
+  let releaseHeld;
+  const bind = () => {
+    const next = conversationId ? hooksByConversation.get(conversationId)?.held : void 0;
+    if (next === current) return;
+    releaseHeld?.();
+    current = next;
+    releaseHeld = next?.subscribe(listener);
+  };
+  const onRegistry = () => {
+    bind();
     listener();
-  }
-  return () => release();
-}
-function subscribeOnce(conversationId, listener) {
-  registryListeners.add(listener);
-  const held = conversationId ? hooksByConversation.get(conversationId)?.held : void 0;
-  const releaseHeld = held?.subscribe(listener);
+  };
+  bind();
+  registryListeners.add(onRegistry);
   return () => {
-    registryListeners.delete(listener);
+    registryListeners.delete(onRegistry);
     releaseHeld?.();
   };
 }

package/dist/host/ui-slots.d.ts

@@ -452,7 +452,7 @@ export declare const InfoHint: AnyComponent;
 export declare const AnswerValueView: AnyComponent;
 /** A host with no error menu draws one labelled line; the error sentence itself is already on screen. */
 export declare const ErrorAlchemyMenu: AnyComponent;
-/** A host with no error card draws the plain sentence, its actions and children, marked as the stand-in. */
+/** THE inline error card is design-system's ErrorNotice (moved from matrx-frontend, host-slot batch 2). */
 export declare const ErrorNotice: AnyComponent;
 export declare const EntityRef: AnyComponent;
 export declare const AdvancedMenu: AnyComponent;

package/dist/host/ui-slots.js

@@ -13,7 +13,10 @@ import { DefaultResourcePickerMenu } from "./defaults/resource-picker-menu.js";
 import { captureReactRenderError } from "./diagnostics.js";
 import {
   ConfirmDialog as PackageConfirmDialog,
+  ErrorNotice as PackageErrorNotice,
   FloatingSheet as PackageFloatingSheet,
+  IconButton as PackageIconButton,
+  StaleDataNotice as PackageStaleDataNotice,
   ReadFailure as PackageReadFailure,
   TextInputDialog as PackageTextInputDialog,
   UntrustedCount as PackageUntrustedCount
@@ -211,17 +214,7 @@ const CopyButtons = slotComponent("CopyButtons");
 const InfoHint = slotComponent("InfoHint");
 const AnswerValueView = slotComponent("AnswerValueView");
 const ErrorAlchemyMenu = slotComponent("ErrorAlchemyMenu", optionalWidget("ErrorAlchemyMenu"));
-const ErrorNotice = slotComponent(
-  "ErrorNotice",
-  ({ title, message, error, actions, children, className }) => createElement(
-    "div",
-    { className: `rounded-md border border-destructive/40 p-2 text-sm ${className ?? ""}`, "data-chat-slot-fallback": "ErrorNotice" },
-    title ? createElement("div", { className: "font-medium" }, title) : null,
-    createElement("div", null, message || (error instanceof Error ? error.message : typeof error === "string" ? error : "")),
-    children ?? null,
-    actions ?? null
-  )
-);
+const ErrorNotice = slotComponent("ErrorNotice", withPackageDefault(PackageErrorNotice));
 const EntityRef = slotComponent("EntityRef");
 const AdvancedMenu = slotComponent("AdvancedMenu");
 const AuthGateDialog = slotComponent("AuthGateDialog");
@@ -334,22 +327,7 @@ const readListRpc = slotFn("readListRpc");
 const ReadFailure = slotComponent("ReadFailure", withPackageDefault(PackageReadFailure));
 const ItemRow = slotComponent("ItemRow", unregisteredWidget("ItemRow"));
 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}.`;
-  return createElement(
-    "div",
-    { role: "status", className: "text-xs text-muted-foreground", "data-stale-data-notice": "" },
-    sentence,
-    props.detail ? ` ${props.detail}` : null,
-    props.onRetry ? createElement(
-      "button",
-      { type: "button", className: "ml-2 underline", onClick: () => props.onRetry?.() },
-      "Try again"
-    ) : null
-  );
-}
-const StaleDataNotice = slotComponent("StaleDataNotice", PlainStaleDataNotice);
+const StaleDataNotice = slotComponent("StaleDataNotice", withPackageDefault(PackageStaleDataNotice));
 const WorkspaceGate = slotComponent("WorkspaceGate", DefaultWorkspaceGate);
 const OrganizationContextNotice = slotComponent("OrganizationContextNotice", unregisteredWidget("OrganizationContextNotice"));
 const JsonInspector = slotComponent("JsonInspector", unregisteredWidget("JsonInspector"));
@@ -385,7 +363,7 @@ const VoiceTextarea = slotComponent("VoiceTextarea", (props) => {
 });
 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 IconButton = slotComponent("IconButton", withPackageDefault(PackageIconButton));
 const LightSwitchToggle = slotComponent("LightSwitchToggle", withPackageDefault(PackageLightSwitchToggle));
 const CitationChip = slotComponent("CitationChip", unregisteredWidget("CitationChip"));
 const MatrxEnvelopeBlock = slotComponent("MatrxEnvelopeBlock", unregisteredWidget("MatrxEnvelopeBlock"));

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

@@ -1,4 +1,5 @@
 import React from "react";
 import type { MarkdownStreamProps } from "./MarkdownStream.js";
+import "./rich-content-defaults.js";
 declare const MarkdownStreamImpl: React.FC<MarkdownStreamProps>;
 export default MarkdownStreamImpl;

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

@@ -6,6 +6,7 @@ import { MarkdownErrorBoundary } from "@ai-matrx/rich-content/display/chat-markd
 import { StreamAwareChatMarkdown } from "./StreamAwareChatMarkdown.js";
 import { BlockRenderingProvider } from "@ai-matrx/rich-content/display/chat-markdown/BlockRenderingContext";
 import { withImagePolicy } from "@ai-matrx/rich-content/levels/prose/remote-image-policy";
+import "./rich-content-defaults.js";
 const MarkdownStreamImpl = ({
   content = "",
   events,

package/dist/ui/markdown-stream/rich-content-defaults.d.ts

@@ -0,0 +1,29 @@
+/**
+ * The rich-content bindings a bare chat host gets from this package (PACKAGE-INDEPENDENCE P29a).
+ *
+ * The block renderer asks its host for a few chat-shaped things: whether to hide reasoning and tool
+ * results, whether machine frames are visible, document dialogs, record annotations, artifact types.
+ * The first three are chat's own settings, so the package answers them itself; the rest are quiet
+ * optionals (no dialogs, children untouched, no artifact types). A host that registers its own
+ * `app` bindings replaces these wholesale, exactly as before, and never sees a warning for them.
+ */
+import { type ReactNode } from "react";
+import { useMachineFramesVisible } from "../../agents/components/shared/transcript-audience.js";
+export declare const CHAT_RICH_CONTENT_APP_DEFAULTS: {
+    useHideReasoning: (conversationId: string | null) => boolean;
+    useHideToolResults: (conversationId: string | null) => boolean;
+    useMachineFramesVisible: typeof useMachineFramesVisible;
+    useDocumentDialogsHost: () => {
+        callbacks: {};
+    };
+    RecordAnnotations: (props: {
+        children?: ReactNode;
+    }) => import("react").DetailedReactHTMLElement<{
+        style: {
+            display: "contents";
+        };
+    }, HTMLElement>;
+    resolveArtifactDef: () => null;
+};
+/** Register the package defaults unless the host has registered its own `app` bindings. */
+export declare function registerChatRichContentDefaults(): void;

package/dist/ui/markdown-stream/rich-content-defaults.js

@@ -0,0 +1,26 @@
+import { createElement } from "react";
+import { configureRichContent, hostCapability } from "@ai-matrx/rich-content/host";
+import { useAppSelector } from "../../store/hooks.js";
+import {
+  selectHideReasoning,
+  selectHideToolResults
+} from "../../agents/redux/execution-system/instance-ui-state/instance-ui-state.selectors.js";
+import { useMachineFramesVisible } from "../../agents/components/shared/transcript-audience.js";
+const never = () => false;
+const CHAT_RICH_CONTENT_APP_DEFAULTS = {
+  useHideReasoning: (conversationId) => useAppSelector(conversationId ? selectHideReasoning(conversationId) : never),
+  useHideToolResults: (conversationId) => useAppSelector(conversationId ? selectHideToolResults(conversationId) : never),
+  useMachineFramesVisible,
+  useDocumentDialogsHost: () => ({ callbacks: {} }),
+  RecordAnnotations: (props) => createElement("span", { style: { display: "contents" } }, props.children),
+  resolveArtifactDef: () => null
+};
+function registerChatRichContentDefaults() {
+  if (hostCapability("app")) return;
+  configureRichContent({ app: CHAT_RICH_CONTENT_APP_DEFAULTS });
+}
+registerChatRichContentDefaults();
+export {
+  CHAT_RICH_CONTENT_APP_DEFAULTS,
+  registerChatRichContentDefaults
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.4.26",
+  "version": "0.4.29",
   "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",
@@ -227,24 +227,24 @@
     "uuid": "^14.0.2",
     "zod": "^4.6.5",
     "@ai-matrx/agents": "latest",
-    "@ai-matrx/alchemy": "latest",
     "@ai-matrx/associations": "latest",
     "@ai-matrx/browser-audio": "latest",
-    "@ai-matrx/canvas": "latest",
+    "@ai-matrx/alchemy": "latest",
     "@ai-matrx/content-ir": "latest",
-    "@ai-matrx/content-ir-react": "latest",
+    "@ai-matrx/canvas": "latest",
     "@ai-matrx/data": "latest",
-    "@ai-matrx/design-system": "latest",
     "@ai-matrx/diff": "latest",
-    "@ai-matrx/icons": "latest",
-    "@ai-matrx/media": "latest",
-    "@ai-matrx/print": "latest",
+    "@ai-matrx/content-ir-react": "latest",
+    "@ai-matrx/design-system": "latest",
     "@ai-matrx/kit": "latest",
+    "@ai-matrx/print": "latest",
     "@ai-matrx/realtime": "latest",
-    "@ai-matrx/records": "latest",
     "@ai-matrx/records-ui": "latest",
-    "@ai-matrx/rich-content": "latest",
+    "@ai-matrx/records": "latest",
     "@ai-matrx/rich-editor": "latest",
+    "@ai-matrx/rich-content": "latest",
+    "@ai-matrx/media": "latest",
+    "@ai-matrx/icons": "latest",
     "@ai-matrx/tap-target": "latest"
   },
   "devDependencies": {