@ai-matrx/chat 0.4.2 → 0.4.7

package/dist/agents/redux/execution-system/inbox/inbox-turn-end.middleware.js

@@ -1,6 +1,7 @@
 import { setInstanceStatus } from "../conversations/conversations.slice.js";
 import { confirmInboxItem } from "./inbox.slice.js";
 import { isStrandablePersonLine } from "./inbox.selectors.js";
+import { isHostConversation } from "../host-conversations/host-conversations.selectors.js";
 function hasPersonLineWaiting(state, conversationId) {
   return (state.conversationInbox?.byConversationId[conversationId] ?? []).some(
     isStrandablePersonLine
@@ -15,7 +16,7 @@ const inboxTurnEndMiddleware = (store) => (next) => (action) => {
     const status = store.getState().conversations?.byConversationId[action.payload.conversationId]?.status;
     if (status === "complete") conversationId = action.payload.conversationId;
   }
-  if (conversationId && hasPersonLineWaiting(store.getState(), conversationId)) {
+  if (conversationId && !isHostConversation(store.getState(), conversationId) && hasPersonLineWaiting(store.getState(), conversationId)) {
     const id = conversationId;
     void import("./deliver-stranded-queue.thunk.js").then(
       ({ deliverStrandedQueue }) => store.dispatch(

package/dist/agents/redux/execution-system/instance-ui-state/run-configuration-persist.js

@@ -1,6 +1,7 @@
 import { mergeJsonColumn } from "@ai-matrx/data/db";
 import { supabase } from "../../../../host/db.js";
 import { setInstanceStatus } from "../conversations/conversations.slice.js";
+import { isHostConversation } from "../host-conversations/host-conversations.selectors.js";
 const RUN_CONFIGURATION_KEY = "run_configuration";
 const EDIT_DEBOUNCE_MS = 1500;
 const TURN_SETTLE_MS = 4e3;
@@ -104,6 +105,7 @@ async function persistRunConfiguration(conversationId, config) {
 function isPersistable(state, conversationId) {
   const record = state.conversations?.byConversationId[conversationId];
   if (!record || record.cacheOnly || record.isEphemeral) return false;
+  if (isHostConversation(state, conversationId)) return false;
   return !(record.status === "running" || record.status === "streaming" || record.status === "paused");
 }
 const storedSignature = /* @__PURE__ */ new Map();

package/dist/agents/redux/execution-system/messages/messages.selectors.js

@@ -12,7 +12,7 @@ import {
   fromCxAudioPart,
   fromCxVideoPart
 } from "@ai-matrx/media/files";
-import { seedPersistedEnvelopeCache } from "../../../../host/content-ir-slots.js";
+import { seedPersistedEnvelopeCache } from "@ai-matrx/rich-content/kinds/registry/region-envelope-memo";
 import {
   readEnvelope,
   reconstructRegionValue

package/dist/agents/redux/execution-system/thunks/execute-instance.thunk.js

@@ -1,6 +1,7 @@
 import {
   executionRejectionMeta
 } from "./execution-rejection-meta.js";
+import { isHostConversation } from "../host-conversations/host-conversations.selectors.js";
 import { attributionForSend } from "../../../../host/app-identity.js";
 import { mintClientTempId } from "@ai-matrx/kit/ids";
 import { createAsyncThunk } from "@reduxjs/toolkit";
@@ -262,6 +263,11 @@ const executeInstance = createAsyncThunk(
       if (!instance) {
         throw new Error(`Conversation ${conversationId} not found`);
       }
+      if (isHostConversation(state, conversationId)) {
+        throw new Error(
+          `Conversation ${conversationId} is carried by its host; it sends through the host's source.`
+        );
+      }
       const claimHeldElsewhere = isExecutionClaimed(conversationId);
       if (claimHeldElsewhere || hasAbortController(conversationId) || instance.status === "running" || instance.status === "streaming") {
         if (submission) {

package/dist/agents/redux/execution-system/thunks/process-stream.js

@@ -190,7 +190,7 @@ import {
 import { StreamProfiler } from "../../../../ui/stream-profiler.js";
 import { makePartialKindStalenessGate } from "@ai-matrx/content-ir/wire";
 import { prepareInboundRenderBlock } from "../utils/inbound-render-block.js";
-import { progressDataRenderBlock } from "../../../../host/content-ir-slots.js";
+import { progressDataRenderBlock } from "../utils/progress-data-block.js";
 import { DECISION_ANSWERS_BLOCK_TYPE } from "../../../../utils/content-ir/decision-answers-ids.js";
 import { recordContextReceipt } from "../context-rules/receipt-check.js";
 import { assembleMessageParts } from "../utils/assemble-cx-content-blocks.js";

package/dist/agents/redux/execution-system/utils/assemble-cx-content-blocks.js

@@ -1,7 +1,8 @@
 import { computeChildOwnedRanges } from "./child-owned-ranges.js";
 import { toCxMediaPart } from "@ai-matrx/media/files";
 import { isUnifiedImageBlock } from "@ai-matrx/media/files";
-import { isSpecialCodeLanguage } from "../../../../host/content-ir-slots.js";
+import { SPECIAL_CODE_LANGUAGES } from "@ai-matrx/rich-content/display/markdown-classification/processors/utils/content-splitter-core";
+const isSpecialCodeLanguage = (language) => SPECIAL_CODE_LANGUAGES.includes(language);
 import { IR_ENVELOPE_KEY } from "@ai-matrx/content-ir";
 import { envelopeCacheFromEnvelopes } from "@ai-matrx/content-ir";
 import { readEnvelope } from "@ai-matrx/content-ir";

package/dist/agents/redux/execution-system/utils/inbound-render-block.d.ts

@@ -40,3 +40,11 @@ export declare function prepareInboundRenderBlock(data: RenderBlockPayload, gate
     block: RenderBlockPayload;
     sanitized: RenderBlockPayload;
 };
+/**
+ * Ingest guard for SERVER-BUILT envelopes riding `metadata.__ir` on a `render_block` event:
+ * valid -> same reference back + seeded into rich-content's region-envelope memo; malformed ->
+ * stripped copy + a loud diagnostic. Semantics live on the pure function in `@ai-matrx/content-ir`.
+ */
+export declare function sanitizeInboundEnvelopeMetadata(metadata: Record<string, unknown> | null | undefined, context: {
+    blockId: string;
+}): Record<string, unknown> | undefined;

package/dist/agents/redux/execution-system/utils/inbound-render-block.js

@@ -1,5 +1,6 @@
 import { captureError } from "../../../../host/diagnostics.js";
-import { sanitizeInboundEnvelopeMetadata } from "../../../../host/content-ir-slots.js";
+import { sanitizeInboundEnvelopeMetadata as sanitizeInboundEnvelopeMetadataPure } from "@ai-matrx/content-ir";
+import { seedEnvelope } from "@ai-matrx/rich-content/kinds/registry/region-envelope-memo";
 import { sanitizeInboundPartialKindMetadata } from "@ai-matrx/content-ir/wire";
 import { fromRenderBlock } from "@ai-matrx/media/files";
 function prepareInboundRenderBlock(data, gatePartialKindStaleness) {
@@ -30,6 +31,20 @@ function prepareInboundRenderBlock(data, gatePartialKindStaleness) {
     sanitized
   };
 }
+function sanitizeInboundEnvelopeMetadata(metadata, context) {
+  return sanitizeInboundEnvelopeMetadataPure(metadata, context, {
+    seedEnvelope: (envelope) => seedEnvelope(envelope),
+    reportMalformed: ({ blockId, engine, raw }) => {
+      captureError({
+        source: "content-ir",
+        message: `render_block "${blockId}" carried a malformed metadata.__ir envelope (engine "${engine}") \u2014 dropped before Redux so it can't poison the pipeline`,
+        relation: engine,
+        raw
+      });
+    }
+  });
+}
 export {
-  prepareInboundRenderBlock
+  prepareInboundRenderBlock,
+  sanitizeInboundEnvelopeMetadata
 };

package/dist/agents/redux/execution-system/utils/normalize-content-blocks.js

@@ -6,7 +6,7 @@ import {
 } from "@ai-matrx/media/files";
 import { DECISION_ANSWERS_BLOCK_TYPE } from "../../../../utils/content-ir/decision-answers-ids.js";
 import { withPerformedScript } from "../../../speech-script/types.js";
-import { seedPersistedEnvelopeCache } from "../../../../host/content-ir-slots.js";
+import { seedPersistedEnvelopeCache } from "@ai-matrx/rich-content/kinds/registry/region-envelope-memo";
 function normalizeContentBlocks(rawBlocks) {
   return rawBlocks.map((block, i) => normalizeSingle(block, i));
 }

package/dist/agents/redux/execution-system/utils/progress-data-block.d.ts

@@ -0,0 +1,11 @@
+import type { RenderBlockPayload } from "@ai-matrx/agents/generated/stream-events";
+/**
+ * Promote a server progress event's canonical `content_ir` value into the
+ * render block consumed by MarkdownStream/LiveRunDisplay.
+ *
+ * Pipeline endpoints still need their ordinary typed `data` event for domain
+ * state. When that event also carries `content_ir`, this adapter gives the
+ * exact same event a canonical visual representation without asking each
+ * feature to parse or route it itself.
+ */
+export declare function progressDataRenderBlock(data: unknown, eventIndex: number, blockIndex: number): RenderBlockPayload | null;

package/dist/agents/redux/execution-system/utils/progress-data-block.js

@@ -0,0 +1,37 @@
+import { IR_ENVELOPE_KEY } from "@ai-matrx/content-ir";
+import { envelopeFromCompleteValue } from "@ai-matrx/rich-content/kinds/registry/kind-correctors";
+import { applyIrKindRoute } from "@ai-matrx/rich-content/kinds/react/kind-route";
+function progressDataRenderBlock(data, eventIndex, blockIndex) {
+  if (!isJsonObject(data) || !isJsonObject(data.content_ir)) return null;
+  const value = data.content_ir;
+  const kind = value.__kind;
+  if (typeof kind !== "string" || kind.trim().length === 0) return null;
+  const source = JSON.stringify(value);
+  const metadata = {
+    [IR_ENVELOPE_KEY]: envelopeFromCompleteValue(value, kind)
+  };
+  const routed = applyIrKindRoute({
+    type: "code",
+    serverData: { language: "json" },
+    metadata
+  });
+  const projectedContent = routed.serverData?.content;
+  return {
+    blockId: `progress_content_ir_${eventIndex}`,
+    blockIndex,
+    type: routed.type,
+    status: "complete",
+    // The unified artifact stage consumes RenderBlockPayload.content directly
+    // for structured_info. Preserve the JSON in the envelope fingerprint; put
+    // the registered component's canonical projection on the visible channel.
+    content: typeof projectedContent === "string" ? projectedContent : source,
+    data: routed.serverData ?? null,
+    metadata: routed.metadata
+  };
+}
+function isJsonObject(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export {
+  progressDataRenderBlock
+};

package/dist/agents/redux/execution-system/utils/stream-block-accumulator.js

@@ -54,14 +54,13 @@ import {
   isUnclosedGenericXmlOpening,
   startUnrecognizedXmlContainer,
   normalizeCodeLanguage,
-  isSpecialCodeLanguage,
-  kindRegistry,
-  componentRegistry,
-  envelopeForCompletedFenceRegion,
-  envelopeForCompletedXmlRegion,
-  withIrEnvelope,
-  sessionEnvelope
-} from "../../../../host/content-ir-slots.js";
+  SPECIAL_CODE_LANGUAGES
+} from "@ai-matrx/rich-content/display/markdown-classification/processors/utils/content-splitter-v2";
+import { kindRegistry } from "@ai-matrx/rich-content/host/kind-registry";
+import { componentRegistry } from "@ai-matrx/rich-content/host/component-registry";
+import { hostSplitterEnvelopes } from "@ai-matrx/rich-content/host/splitter-envelopes";
+import { withIrEnvelope } from "@ai-matrx/rich-content/kinds/registry/region-envelope-memo";
+import { sessionEnvelope } from "@ai-matrx/rich-content/kinds/registry/kind-correctors";
 import { disposeParseSession, openParseSession } from "@ai-matrx/content-ir";
 import {
   IR_ENVELOPE_KEY
@@ -71,6 +70,9 @@ import {
   splitAroundEmbeddedKindJson
 } from "../../../../utils/content-ir/surfaces/embedded-kind-json.js";
 import { captureError } from "../../../../host/diagnostics.js";
+const isSpecialCodeLanguage = (language) => SPECIAL_CODE_LANGUAGES.includes(language);
+const envelopeForCompletedXmlRegion = (tag, regionText) => hostSplitterEnvelopes()?.xmlRegion(tag, regionText) ?? null;
+const envelopeForCompletedFenceRegion = (language, regionText) => hostSplitterEnvelopes()?.fenceRegion(language, regionText) ?? null;
 function countStructuralObjectBraces(source) {
   let opens = 0;
   let closes = 0;

package/dist/agents/redux/mcp/mcp.slice.js

@@ -1,4 +1,5 @@
 import { createSlice, createAsyncThunk } from "@reduxjs/toolkit";
+import { chatHostHasDatabase } from "../../../host/configure.js";
 import {
   fetchMcpCatalog,
   connectMcpServer as connectMcpServerService
@@ -22,12 +23,14 @@ const initialState = {
   availabilityError: null
 };
 const EMPTY_MCP_AVAILABILITY = {};
+const NEEDS_DATABASE = { condition: () => chatHostHasDatabase() };
 const fetchCatalog = createAsyncThunk("mcp/fetchCatalog", async () => {
   return fetchMcpCatalog();
-});
+}, NEEDS_DATABASE);
 const fetchAvailability = createAsyncThunk(
   "mcp/fetchAvailability",
-  async ({ organizationId, slugs }) => fetchMcpAvailability(organizationId, slugs)
+  async ({ organizationId, slugs }) => fetchMcpAvailability(organizationId, slugs),
+  NEEDS_DATABASE
 );
 const connectServer = createAsyncThunk(
   "mcp/connectServer",
@@ -35,7 +38,8 @@ const connectServer = createAsyncThunk(
     const connectionId = await connectMcpServerService(params);
     dispatch(fetchCatalog());
     return { serverId: params.serverId, connectionId };
-  }
+  },
+  NEEDS_DATABASE
 );
 const connectServerWithCredentials = createAsyncThunk(
   "mcp/connectServerWithCredentials",
@@ -49,7 +53,8 @@ const connectServerWithCredentials = createAsyncThunk(
     });
     dispatch(fetchCatalog());
     return { serverId: params.serverId, connectionId: summary.connection_id };
-  }
+  },
+  NEEDS_DATABASE
 );
 const disconnectServer = createAsyncThunk(
   "mcp/disconnectServer",
@@ -57,7 +62,8 @@ const disconnectServer = createAsyncThunk(
     await disconnectMcpConnection(serverId);
     dispatch(fetchCatalog());
     return serverId;
-  }
+  },
+  NEEDS_DATABASE
 );
 const discoverServerTools = createAsyncThunk(
   "mcp/discoverServerTools",
@@ -70,14 +76,16 @@ const discoverServerTools = createAsyncThunk(
       resources: [],
       prompts: []
     };
-  }
+  },
+  NEEDS_DATABASE
 );
 const refreshServerToken = createAsyncThunk(
   "mcp/refreshServerToken",
   async (serverId) => {
     await refreshMcpConnection(serverId);
     return serverId;
-  }
+  },
+  NEEDS_DATABASE
 );
 const mcpSlice = createSlice({
   name: "mcp",

package/dist/agents/redux/tools/tools.thunks.js

@@ -2,7 +2,9 @@ import { createAsyncThunk } from "@reduxjs/toolkit";
 import { supabase } from "../../../host/db.js";
 import { pgErrorToError } from "@ai-matrx/data";
 import { recordUnavailable } from "../../../host/diagnostics.js";
+import { chatHostHasDatabase } from "../../../host/configure.js";
 const fetchAvailableTools = createAsyncThunk("tools/fetchAvailable", async (_, { getState }) => {
+  if (!chatHostHasDatabase()) return [];
   if (getState().tools.status === "succeeded") {
     return getState().tools.tools;
   }
@@ -28,6 +30,7 @@ const fetchToolById = createAsyncThunk(
   },
   {
     condition: (toolId, { getState }) => {
+      if (!chatHostHasDatabase()) return false;
       const state = getState().tools;
       if (state.tools.some((tool) => tool.id === toolId)) return false;
       if (state.identityById[toolId]) return false;

package/dist/agents/runtime-reconnect/ServerOperationBanner.d.ts

@@ -1,3 +1,8 @@
-export declare function ServerOperationBanner({ conversationId, }: {
+/**
+ * A run that outlived its stream on the platform server (resume, reconnect, parked on a
+ * person). A host-owned conversation has no server operation, so the banner is absent there
+ * (G-DOOR gate).
+ */
+export declare function ServerOperationBanner({ conversationId }: {
     conversationId: string;
 }): import("react").JSX.Element | null;

package/dist/agents/runtime-reconnect/ServerOperationBanner.js

@@ -13,7 +13,12 @@ import { useAppDispatch, useAppSelector } from "../../store/hooks.js";
 import { selectActivePendingAsksForConversation } from "../ui-first-tools/redux/pending-asks.slice.js";
 import { resumeInstance } from "../redux/execution-system/thunks/resume-instance.thunk.js";
 import { reconnectServerOperation } from "./reconnect-server-operation.thunk.js";
-function ServerOperationBanner({
+import { useConversationAbilities } from "../redux/execution-system/host-conversations/conversation-abilities.js";
+function ServerOperationBanner({ conversationId }) {
+  const { hosted } = useConversationAbilities();
+  return hosted ? null : /* @__PURE__ */ jsx(ServerOperationBannerBody, { conversationId });
+}
+function ServerOperationBannerBody({
   conversationId
 }) {
   const dispatch = useAppDispatch();

package/dist/agents/ui-first-tools/ui/ApprovalCard.js

@@ -17,7 +17,7 @@ import { Button } from "@ai-matrx/design-system";
 import { Checkbox } from "../../../ui/checkbox.js";
 import { Textarea } from "@ai-matrx/design-system";
 import { ChangeDiff } from "../../../host/ui-slots.js";
-import { KindInstanceRender } from "../../../host/content-ir-slots.js";
+import { KindInstanceRender } from "@ai-matrx/rich-content/host/app-bindings";
 import { StructuredValueView } from "../../../host/ui-slots.js";
 import { cn } from "@ai-matrx/design-system";
 import { useAppDispatch } from "../../../store/hooks.js";

package/dist/agents/ui-first-tools/ui/AskCard.js

@@ -1,7 +1,6 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useEffect, useMemo, useState } from "react";
-import { RichContent } from "../../../host/ui-slots.js";
 import {
   Info,
   AlertTriangle,
@@ -35,6 +34,7 @@ import { getAskDraft, setAskDraft } from "../redux/ask-draft-registry.js";
 import { AskCardCountdown } from "./AskCardCountdown.js";
 import { AgentCardShell } from "./AgentCardShell.js";
 import { Button } from "@ai-matrx/design-system/controls";
+import { RichContent } from "@ai-matrx/rich-content/levels/RichContent";
 const SINGLE_LABELS = { send: "Send", skip: "Skip" };
 const OTHER_SENTINEL = "__matrx_other__";
 const LEVEL_ICONS = {

package/dist/agents/ui-first-tools/ui/lists/TaskPanel.js

@@ -1,7 +1,6 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { readOf } from "../../../../host/ui-slots.js";
-import { RichContent } from "../../../../host/ui-slots.js";
 import { UntrustedCount } from "../../../../host/ui-slots.js";
 import { useCallback, useEffect, useState } from "react";
 import {
@@ -48,6 +47,7 @@ import { confirm as confirmDialog } from "../../../../host/ui-slots.js";
 import { selectUserId } from "../../../../host/identity.js";
 import { useChatCanvasTab } from "../../../../host/canvas.js";
 import { CONVERSATION_LISTS_KIND } from "../../../../host/canvas-tabs.js";
+import { RichContent } from "@ai-matrx/rich-content/levels/RichContent";
 function useConversationListsTab(conversationId) {
   const tab = useChatCanvasTab({ kind: CONVERSATION_LISTS_KIND, key: conversationId });
   return {

package/dist/conversation/hooks/useDomCapturePrint.js

@@ -16,7 +16,7 @@ function useDomCapturePrint() {
     setError(null);
     let releaseRenderAll = null;
     try {
-      const { renderAllDiagrams } = await import("../../host/markdown-slots.js");
+      const { renderAllDiagrams } = await import("@ai-matrx/rich-content/mermaid/lazy-draw");
       releaseRenderAll = (await renderAllDiagrams()).release;
       const [{ captureDocumentPdf }, { downloadFile }] = await Promise.all([
         import("@ai-matrx/alchemy/operate/capture"),

package/dist/conversation/utils/markdown-print.js

@@ -13,7 +13,7 @@ function printMarkdownContent(markdown, title = "AI Response") {
     prepare: async () => {
       let drawn;
       try {
-        const { drawMermaidForPrint } = await import("../../host/markdown-slots.js");
+        const { drawMermaidForPrint } = await import("@ai-matrx/rich-content/mermaid/print-render");
         drawn = await drawMermaidForPrint(markdown);
       } catch (error) {
         console.error("[print] diagrams could not be drawn", error);

package/dist/cx-chat/components/messages/AssistantMessage.js

@@ -13,10 +13,8 @@ import {
   Save
 } from "lucide-react";
 import { Button } from "@ai-matrx/design-system/controls";
-import {
-  MarkdownStream,
-  AudioOutputBlockSkeleton
-} from "../../../host/markdown-slots.js";
+import { MarkdownStream } from "../../../ui/markdown-stream/MarkdownStream.js";
+import AudioOutputBlockSkeleton from "../../../ui/AudioOutputBlockSkeleton.js";
 import { useDomCapturePrint } from "../../../conversation/hooks/useDomCapturePrint.js";
 import { useAppSelector, useAppDispatch } from "../../../store/hooks.js";
 import { selectMessageHasUnsavedChanges } from "../../_legacy-stubs.js";
@@ -24,7 +22,7 @@ import { editMessage } from "../../_legacy-stubs.js";
 import { buildContentBlocksForSave } from "../../utils/buildContentBlocksForSave.js";
 import { useMediaLoadRecovery } from "@ai-matrx/media/core";
 import { chatConversationsActions } from "../../_legacy-stubs.js";
-import { RichDocumentActions } from "../../../host/rich-document-slots.js";
+import { RichDocumentActions } from "@ai-matrx/rich-content/rich-document/RichDocumentActions";
 import { MessageTimestamp } from "../../../agents/components/messages-display/MessageTimestamp.js";
 import { ErrorAlchemyMenu } from "../../../host/ui-slots.js";
 import { downloadFile } from "@ai-matrx/kit/download";

package/dist/cx-conversation/AssistantMessage.js

@@ -13,10 +13,8 @@ import {
   Save
 } from "lucide-react";
 import { Button } from "@ai-matrx/design-system/controls";
-import {
-  MarkdownStream,
-  AudioOutputBlockSkeleton
-} from "../host/markdown-slots.js";
+import { MarkdownStream } from "../ui/markdown-stream/MarkdownStream.js";
+import AudioOutputBlockSkeleton from "../ui/AudioOutputBlockSkeleton.js";
 import { useDomCapturePrint } from "../conversation/hooks/useDomCapturePrint.js";
 import { useAppSelector, useAppDispatch } from "../store/hooks.js";
 import { selectMessageHasUnsavedChanges } from "./_legacy-stubs.js";
@@ -24,7 +22,7 @@ import { editMessage } from "./_legacy-stubs.js";
 import { buildContentBlocksForSave } from "./utils/buildContentBlocksForSave.js";
 import { useMediaLoadRecovery } from "@ai-matrx/media/core";
 import { chatConversationsActions } from "./_legacy-stubs.js";
-import { RichDocumentActions } from "../host/rich-document-slots.js";
+import { RichDocumentActions } from "@ai-matrx/rich-content/rich-document/RichDocumentActions";
 import { MessageTimestamp } from "../agents/components/messages-display/MessageTimestamp.js";
 import { ErrorAlchemyMenu } from "../host/ui-slots.js";
 import { downloadFile } from "@ai-matrx/kit/download";

package/dist/host/app-data-slots.d.ts

@@ -0,0 +1,85 @@
+/**
+ * host/app-data-slots — the app's DATA and optional enhancements around a rendered message:
+ * the records anchored to a chat, the shape (kind) catalog, the live kind validator, the
+ * Source Inspector a citation opens and the full-screen editor. None of these is the formatted
+ * text engine — chat imports that (`@ai-matrx/rich-content`) directly and renders formatted text
+ * on any host (P29a). These are what only the app has; each has an honest stand-in, reported once
+ * (Law 4). The app registers them in `providers/chatUiRegistration.ts`.
+ *
+ * The slot names extend `ChatUiSlots` by augmentation, so `registerChatUi` accepts them.
+ */
+import type { KindValidator } from "@ai-matrx/content-ir/registry";
+import type { EntityListPage, EntityListQuery, EntityListSort } from "@ai-matrx/records/list";
+import type { ComponentType } from "react";
+import type { MessageCitationSource } from "../agents/redux/execution-system/messages/message-citations.js";
+declare module "./ui-slots" {
+    interface ChatUiSlots {
+        /** The host's kind validator (the live kind catalog's contracts). */
+        contentIrKindValidator: () => KindValidator;
+        /** The list of records anchored to one thing (the host's `AnchorRecordsList`), same props. */
+        AnchorRecordsList: ComponentType<any>;
+        /** Reads the records anchored to one thing; `enabled` false reads nothing (zero-prefetch). */
+        useAnchorRecords: (anchor: {
+            type: string;
+            id: string;
+        } | null, enabled?: boolean) => AnchorRecordsState;
+        /** One page of the host's shape (kind) catalog. */
+        fetchShapePage: (query: EntityListQuery, sort: EntityListSort) => Promise<EntityListPage<ShapeBrowseRow>>;
+        /** One shape row by kind slug, or null. */
+        fetchShapeByKind: (kind: string) => Promise<ShapeBrowseRow | null>;
+        /** Opens one numbered message source (the host's Source Inspector): returns `(source) => void`. */
+        useOpenCitationSource: () => (source: MessageCitationSource) => void;
+        /** The full-screen markdown editor a message's "Edit" opens (the host's `FullScreenMarkdownEditor`), same props. */
+        FullScreenMarkdownEditor: ComponentType<any>;
+    }
+}
+/** What an anchor's record read reports (the host's `AnchorRecordsState`). */
+export interface AnchorRecordsState {
+    status: "loading" | "ready" | "error";
+    records: readonly unknown[];
+    active: readonly unknown[];
+    archived: readonly unknown[];
+    message: string | null;
+    reload: () => void;
+}
+/** The anchor type of a conversation's own records. */
+export declare const CONVERSATION_ANCHOR_TYPE = "conversation";
+/** One row, exactly as the host's shape list returns it. */
+export interface ShapeBrowseRow {
+    access_level: string;
+    authoring_owner: string;
+    created_at: string;
+    created_by: string;
+    description: string;
+    family: string;
+    has_component: boolean;
+    id: string;
+    is_active: boolean;
+    is_owner: boolean;
+    kind: string;
+    label: string;
+    organization_id: string;
+    organization_name: string;
+    origin: string;
+    owner_email: string;
+    total_count: number;
+    updated_at: string;
+    version: number;
+    visibility: string;
+}
+/** A host with no kind catalog checks nothing and says so: a skip is never a pass. */
+export declare const contentIrKindValidator: () => KindValidator;
+/** A host with no record store shows no records list (reported once). */
+export declare const AnchorRecordsList: ComponentType<any>;
+/** A host with no record store reads no records: the list stays empty. */
+export declare const useAnchorRecords: (anchor: {
+    type: string;
+    id: string;
+} | null, enabled?: boolean) => AnchorRecordsState;
+/** A host with no shape catalog has no shapes to browse: the read says so, the picker shows it. */
+export declare const fetchShapePage: (query: EntityListQuery, sort: EntityListSort) => Promise<EntityListPage<ShapeBrowseRow>>;
+export declare const fetchShapeByKind: (kind: string) => Promise<ShapeBrowseRow | null>;
+/** A host with no Source Inspector opens a web source in a new tab; a file source has no target here. */
+export declare const useOpenCitationSource: () => (source: MessageCitationSource) => void;
+/** A host with no full-screen editor opens none: the message's text stays as drawn (reported once). */
+export declare const FullScreenMarkdownEditor: ComponentType<any>;

package/dist/host/app-data-slots.js

@@ -0,0 +1,42 @@
+import { hostFn, hostSlot } from "./ui-slots.js";
+const CONVERSATION_ANCHOR_TYPE = "conversation";
+const contentIrKindValidator = hostFn("contentIrKindValidator", () => ({
+  validate: async (_value, kind) => ({
+    kind,
+    checked: false,
+    ok: false,
+    errors: ["This host has no kind catalog to check against (registerChatUi contentIrKindValidator)."],
+    degradedReason: "catalog_unreachable"
+  }),
+  cachedSchema: async () => null,
+  invalidate: () => void 0
+}));
+const AnchorRecordsList = hostSlot("AnchorRecordsList");
+const useAnchorRecords = hostFn("useAnchorRecords", () => ({
+  status: "ready",
+  records: [],
+  active: [],
+  archived: [],
+  message: null,
+  reload: () => void 0
+}));
+const fetchShapePage = hostFn("fetchShapePage", async () => {
+  throw new Error("This host has no shape catalog (registerChatUi fetchShapePage)");
+});
+const fetchShapeByKind = hostFn("fetchShapeByKind", async () => {
+  throw new Error("This host has no shape catalog (registerChatUi fetchShapeByKind)");
+});
+const useOpenCitationSource = hostFn("useOpenCitationSource", () => (source) => {
+  if (source.url && typeof window !== "undefined") window.open(source.url, "_blank", "noopener,noreferrer");
+});
+const FullScreenMarkdownEditor = hostSlot("FullScreenMarkdownEditor");
+export {
+  AnchorRecordsList,
+  CONVERSATION_ANCHOR_TYPE,
+  FullScreenMarkdownEditor,
+  contentIrKindValidator,
+  fetchShapeByKind,
+  fetchShapePage,
+  useAnchorRecords,
+  useOpenCitationSource
+};

package/dist/host/bare-host-chrome.js

@@ -28,6 +28,7 @@ function BareHostChrome({ host, children }) {
     if (!hasChatScopes("associationsService")) {
       registerChatScopes({
         associationsService: associations.services.associations,
+        favoritesService: associations.favorites,
         getAssociationsStore: (() => associations)
       });
     }

package/dist/host/defaults/prefs.d.ts

@@ -23,3 +23,14 @@ export declare const PREFERENCE_FIELDS: Readonly<Record<string, keyof ChatPrefer
 export declare function createUnhostedKnobs(): ChatKnobsPort;
 export declare const CHAT_PREFS_PREFIX = "ai-matrx-chat:";
 export declare function createWebPrefs(): ChatPrefsPort;
+/**
+ * A prefs port the HOST keeps (HOST-OWNED-SOURCE-PLAN §2.2 "Drafts"): a page whose origin
+ * changes between launches (a local host on a new port, a desktop window) cannot keep drafts in
+ * web storage. The host reads its saved values once (`initial`) and receives every change
+ * (`persist`, `null` = removed) to write where it keeps them — a file, an IPC store. Reads are
+ * synchronous from memory, so the first render already sees the saved draft.
+ */
+export declare function createHostKeptPrefs(options: {
+    initial: Readonly<Record<string, string>>;
+    persist: (key: string, value: string | null) => void;
+}): ChatPrefsPort;