@ai-matrx/chat 0.3.33 → 0.4.2

package/dist/agents/resources/default-picker-items.js

@@ -0,0 +1,48 @@
+import {
+  AppWindow,
+  CheckSquare,
+  CirclePlay,
+  File,
+  FileText,
+  FolderOpen,
+  Globe,
+  Image,
+  Layers,
+  Lightbulb,
+  MessagesSquare,
+  Mic,
+  Notebook,
+  Plug,
+  Search,
+  StickyNote,
+  Table2,
+  Wrench
+} from "lucide-react";
+const item = (id, label, icon, requiresCapability = null) => ({ id, label, icon, iconClassName: "", requiresCapability });
+const DEFAULT_RESOURCE_PICKER_ITEMS = [
+  item("files", "Files", FolderOpen),
+  item("audio", "Voice Pad", Mic),
+  item("webpage", "Web page", Globe),
+  item("google", "Google", Search),
+  item("cloud_browser", "Cloud browser", AppWindow),
+  item("tools", "Tools", Wrench),
+  item("connections", "Connections", Plug),
+  item("skills", "Skills", Lightbulb),
+  item("conversations", "Chats", MessagesSquare),
+  item("tables", "Tables", Table2),
+  item("notes", "Notes", StickyNote),
+  item("tasks", "Tasks", CheckSquare),
+  item("workbooks", "Workbooks", Notebook),
+  item("documents", "Documents", FileText),
+  item("context_values", "Context values", Layers),
+  item("image_url", "Image link", Image, "supportsImageUrls"),
+  item("file_url", "File link", File, "supportsFileUrls"),
+  item("youtube", "YouTube", CirclePlay, "supportsYoutubeVideos")
+];
+function defaultResourcePickerItems() {
+  return [...DEFAULT_RESOURCE_PICKER_ITEMS];
+}
+export {
+  DEFAULT_RESOURCE_PICKER_ITEMS,
+  defaultResourcePickerItems
+};

package/dist/agents/runtime/generation-job.js

@@ -1,8 +1,5 @@
 import { selectAgentById } from "../redux/agent-definition/selectors.js";
-import {
-  fetchModelById,
-  selectModelById
-} from "../model-registry/modelRegistrySlice.js";
+import { getModelRecords, readModelRecords, selectModelById } from "../redux/model-registry.js";
 import { setRequestGenerationJob } from "../redux/execution-system/active-requests/active-requests.slice.js";
 import { parseCapabilities } from "../model-registry/parse.js";
 import { selectCurrentSettings } from "../redux/execution-system/instance-model-overrides/instance-model-overrides.selectors.js";
@@ -20,7 +17,7 @@ function selectRunModelId(state, conversationId) {
 function resolveGenerationJob(state, conversationId) {
   const modelId = selectRunModelId(state, conversationId);
   if (!modelId) return null;
-  const model = selectModelById(state, modelId);
+  const model = selectModelById(readModelRecords(), modelId);
   if (!model?.capabilities) return null;
   const kind = runOutputKindFromModalities(
     parseCapabilities(model.capabilities, {
@@ -38,9 +35,9 @@ function resolveGenerationJob(state, conversationId) {
 async function labelGenerationJob(dispatch, getState, requestId, conversationId) {
   const modelId = selectRunModelId(getState(), conversationId);
   if (!modelId) return;
-  if (!selectModelById(getState(), modelId)) {
+  if (!selectModelById(readModelRecords(), modelId)) {
     try {
-      await dispatch(fetchModelById(modelId));
+      await getModelRecords().loadModel(modelId);
     } catch (err) {
       console.warn(
         "[generation-job] could not load the model to label this run; the generic working line stays",

package/dist/agents/runtime/get-model-capabilities.js

@@ -1,5 +1,5 @@
 import { selectAgentById } from "../redux/agent-definition/selectors.js";
-import { selectModelById } from "../model-registry/modelRegistrySlice.js";
+import { readModelRecords, selectModelById } from "../redux/model-registry.js";
 import {
   parseCapabilities
 } from "../model-registry/parse.js";
@@ -8,7 +8,7 @@ function getCapabilitiesForConversation(state, conversationId) {
   if (!instance?.agentId) return null;
   const agent = selectAgentById(state, instance.agentId);
   if (!agent?.modelId) return null;
-  const model = selectModelById(state, agent.modelId);
+  const model = selectModelById(readModelRecords(), agent.modelId);
   if (!model) return null;
   return parseCapabilities(model.capabilities, {
     modelId: agent.modelId,
@@ -16,7 +16,7 @@ function getCapabilitiesForConversation(state, conversationId) {
   });
 }
 function getCapabilitiesForModel(state, modelId) {
-  const model = selectModelById(state, modelId);
+  const model = selectModelById(readModelRecords(), modelId);
   if (!model) return null;
   return parseCapabilities(model.capabilities, {
     modelId,

package/dist/agents/types/instance.types.d.ts

@@ -58,7 +58,8 @@ export type UnregisteredSourceApp = string & {
 export type SourceAppValue = SourceApp | UnregisteredSourceApp;
 /** Preserve DB fidelity while preventing new producer call sites from inventing strings. */
 export declare function sourceAppFromStorage(value: string): SourceAppValue;
-export type ApiEndpointMode = "agent" | "manual";
+/** "host": a host-owned message source carries the turn (`host/source`), never a server door. */
+export type ApiEndpointMode = "agent" | "manual" | "host";
 /**
  * Client attestation of HOW an AI request was triggered — the only provenance
  * input the client may send. The server DERIVES `origin_class` from witnessed

package/dist/agents/ui-first-tools/redux/agent-lists.selectors.d.ts

@@ -54,8 +54,8 @@ export declare const selectAgentTaskCounts: (conversationId: string) => ((state:
     proposedDirectives: import("../../redux/proposed-directives/proposedDirectivesSlice.js").ProposedDirectivesState;
     agentSettings: import("../../redux/agent-settings/types.js").AgentSettingsState;
     conversationAttachments: import("../../connectors/attachments.slice.js").AttachmentsSliceState;
-    modelRegistry: import("../../model-registry/modelRegistrySlice.js").ModelRegistryState;
     chatHost: import("../../../store/chat-host.slice.js").ChatHostState;
+    hostConversations: import("../../redux/execution-system/host-conversations/host-conversations.slice.js").HostConversationsState;
 } & import("../../../store/root-state.js").ChatHostReadSlices) => {
     total: number;
     done: number;
@@ -139,8 +139,8 @@ export declare const selectUserTodoCounts: (conversationId: string) => ((state:
     proposedDirectives: import("../../redux/proposed-directives/proposedDirectivesSlice.js").ProposedDirectivesState;
     agentSettings: import("../../redux/agent-settings/types.js").AgentSettingsState;
     conversationAttachments: import("../../connectors/attachments.slice.js").AttachmentsSliceState;
-    modelRegistry: import("../../model-registry/modelRegistrySlice.js").ModelRegistryState;
     chatHost: import("../../../store/chat-host.slice.js").ChatHostState;
+    hostConversations: import("../../redux/execution-system/host-conversations/host-conversations.slice.js").HostConversationsState;
 } & import("../../../store/root-state.js").ChatHostReadSlices) => {
     total: number;
     done: number;

package/dist/cx-chat/components/SsrSidebarChats.js

@@ -9,7 +9,7 @@ import {
   Share2,
   Users
 } from "lucide-react";
-import { useSelector } from "react-redux";
+import { useAppSelector as useSelector } from "../../store/hooks.js";
 import { selectUserId } from "../../host/identity.js";
 import {
   DropdownMenu,

package/dist/cx-chat/components/sidebar/SidebarUserFooter.js

@@ -1,7 +1,7 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { Link } from "../../../host/navigation.js";
-import { useSelector } from "react-redux";
+import { useAppSelector as useSelector } from "../../../store/hooks.js";
 import {
   selectUserId,
   selectDisplayName,

package/dist/host/app-identity.d.ts

@@ -0,0 +1,20 @@
+/**
+ * host/app-identity — what the app calls itself on the conversations it starts.
+ *
+ * Every send stamps `source_app` (and `source_feature`) on the request; the host's `app` option
+ * decides them (contract: `ChatHost.app`). A host that named no app is the neutral `chat`
+ * producer — said once — never the main frontend's label. Non-React code reads the configured
+ * host at call time; with no host configured the instance's own stamp stands.
+ */
+import type { ChatAppIdentity } from "./contract.js";
+export interface WireAttribution {
+    sourceApp: string | undefined;
+    sourceFeature: string | undefined;
+}
+/** The identity this app stamps (the host's `app`, else the neutral default). */
+export declare function currentChatApp(): ChatAppIdentity | null;
+/** The `source_app` / `source_feature` a send carries: the host's identity over the instance's own. */
+export declare function attributionForSend(instance: {
+    sourceApp?: string | undefined;
+    sourceFeature?: string | undefined;
+}): WireAttribution;

package/dist/host/app-identity.js

@@ -0,0 +1,21 @@
+import { DEFAULT_CHAT_APP, getChatHost, isChatHostConfigured } from "./configure.js";
+import { announceOnce } from "./errors.js";
+function currentChatApp() {
+  return isChatHostConfigured() ? getChatHost().app : null;
+}
+function attributionForSend(instance) {
+  const app = currentChatApp();
+  if (!app) return { sourceApp: instance.sourceApp, sourceFeature: instance.sourceFeature };
+  if (app === DEFAULT_CHAT_APP) {
+    announceOnce(
+      "chat-host-app-unnamed",
+      `The host named no \`app\`, so its conversations are labelled "${app.sourceApp}". Pass app: { sourceApp, sourceFeature? } to ChatProvider's host to name it.`,
+      "info"
+    );
+  }
+  return { sourceApp: app.sourceApp, sourceFeature: app.sourceFeature ?? instance.sourceFeature };
+}
+export {
+  attributionForSend,
+  currentChatApp
+};

package/dist/host/bare-host-chrome.d.ts

@@ -0,0 +1,14 @@
+/**
+ * What a bare host (a private chat store: extension, desktop, a fresh Vite app) gets mounted
+ * for it, because the chat UI cannot render without them and the host has nothing to say about
+ * them beyond the db it already gave: one tooltip provider, one associations store over
+ * `host.db`, the model catalog + favorites, and the agent catalog the host resolves (`host.catalog()`, built over `db`). A host that passes its own `store` (matrx-frontend) already mounts both above the
+ * chat with its own ports, so they are never shadowed there.
+ * Proof: canary/ (P29a) renders the transcript and composer with only `{ db }`.
+ */
+import { type ReactNode } from "react";
+import type { ResolvedChatHost } from "./contract.js";
+export declare function BareHostChrome({ host, children }: {
+    host: ResolvedChatHost;
+    children?: ReactNode;
+}): import("react").JSX.Element;

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

@@ -0,0 +1,44 @@
+"use client";
+import { jsx } from "react/jsx-runtime";
+import { useState } from "react";
+import { TooltipProvider } from "@ai-matrx/design-system";
+import { createAssociationsStore } from "@ai-matrx/associations/core";
+import { AssociationsProvider } from "@ai-matrx/associations/react";
+import { AgentCatalogProvider } from "@ai-matrx/agents/catalog/react";
+import { createModelCatalog, createModelFavorites } from "@ai-matrx/agents/models";
+import { ModelCatalogProvider } from "@ai-matrx/agents/models/react";
+import { hasChatScopes, registerChatScopes } from "../context/sources/scopes.js";
+const SAVE_REASON = "save this";
+function BareHostChrome({ host, children }) {
+  const [associations] = useState(
+    () => createAssociationsStore({
+      dataSource: host.db,
+      identity: {
+        requireUserId: () => {
+          const userId = host.identity.current().userId;
+          if (!userId) throw new Error("@ai-matrx/chat: no one is signed in, so this cannot be saved.");
+          return userId;
+        },
+        // A variable, not a literal: finish-build reads `require("…")` as an import.
+        ensureOrgId: () => host.org.require(SAVE_REASON)
+      }
+    })
+  );
+  useState(() => {
+    if (!hasChatScopes("associationsService")) {
+      registerChatScopes({
+        associationsService: associations.services.associations,
+        getAssociationsStore: (() => associations)
+      });
+    }
+  });
+  const [catalog] = useState(() => host.catalog());
+  const [models] = useState(() => ({
+    catalog: createModelCatalog({ client: host.db }),
+    favorites: createModelFavorites({ client: host.db })
+  }));
+  return /* @__PURE__ */ jsx(TooltipProvider, { delayDuration: 200, children: /* @__PURE__ */ jsx(AgentCatalogProvider, { catalog, children: /* @__PURE__ */ jsx(AssociationsProvider, { store: associations, children: /* @__PURE__ */ jsx(ModelCatalogProvider, { catalog: models.catalog, favorites: models.favorites, children }) }) }) });
+}
+export {
+  BareHostChrome
+};

package/dist/host/configure.d.ts

@@ -12,7 +12,9 @@
  * port (identity → diagnostics, server → identity + org) always reaches the
  * resolved one — the host's override when it gave one.
  */
-import type { ChatHost, ChatRoutes, ResolvedChatHost } from "./contract.js";
+import type { ChatAppIdentity, ChatHost, ChatRoutes, ResolvedChatHost } from "./contract.js";
+/** What a host that names no `app` is called: the neutral registered producer, never matrx-frontend. */
+export declare const DEFAULT_CHAT_APP: ChatAppIdentity;
 /** The platform's production addresses — the default `routes`. */
 export declare const DEFAULT_CHAT_ROUTES: ChatRoutes;
 export declare function resolveChatHost(host: ChatHost): ResolvedChatHost;
@@ -22,6 +24,12 @@ export declare function configureChat(host: ChatHost): ResolvedChatHost;
 export declare function onChatHostConfigured(listener: () => void): () => void;
 /** The configured host. Throws `ChatHostNotConfiguredError` (with the remedy) when there is none. */
 export declare function getChatHost(): ResolvedChatHost;
+/**
+ * False when the configured host gave a message `source` and no `db` (the db is the stand-in).
+ * The branch every global database read takes FIRST (G-DOOR). Unconfigured: true — the read
+ * then fails loudly on the missing host, as before.
+ */
+export declare function chatHostHasDatabase(): boolean;
 /** True once `configureChat` (or `<ChatProvider>` in a browser) has run. */
 export declare function isChatHostConfigured(): boolean;
 /** Test-only: forget the configured host. */

package/dist/host/configure.js

@@ -8,7 +8,7 @@ import {
   isChatSourceApp
 } from "./defaults/diagnostics.js";
 import { createDbIdentity } from "./defaults/identity.js";
-import { createNoPickerOrg } from "./defaults/org.js";
+import { createStoredOrg } from "./defaults/org.js";
 import { createDefaultServer } from "./defaults/server.js";
 import { createDefaultServerApi } from "./defaults/server-api.js";
 import { createDomNotifier } from "./defaults/notify.js";
@@ -19,6 +19,14 @@ import { createDbCatalogGetter } from "./defaults/catalog.js";
 import { createDefaultChrome } from "./defaults/chrome.js";
 import { createDbFeedback } from "./defaults/feedback.js";
 import { createUnhostedCanvas } from "./defaults/canvas.js";
+import { SIGNED_OUT_IDENTITY } from "./defaults/identity.js";
+import {
+  NO_DATABASE_CODE_PREFIX,
+  createConsoleDiagnostics,
+  createNoDatabaseStandIn,
+  createNoServerApi
+} from "./no-database.js";
+const DEFAULT_CHAT_APP = Object.freeze({ sourceApp: "chat" });
 const DEFAULT_CHAT_ROUTES = Object.freeze({
   workflowStudio: "https://workflows.aimatrx.com"
 });
@@ -41,24 +49,41 @@ const PORTS = [
 const EMPTY_REGISTRATIONS = Object.freeze({});
 function assertDb(host) {
   const db = host?.db;
-  if (!db) throw new ChatHostInvalidError("`db` is missing");
+  if (!db) {
+    if (host?.source) return;
+    throw new ChatHostInvalidError("`db` is missing (pass `db`, or a message `source`)");
+  }
   if (typeof db.rpc !== "function" || typeof db.from !== "function" || !db.auth) {
     throw new ChatHostInvalidError(
       "`db` is not a Supabase client (no auth/rpc/from)"
     );
   }
 }
+const SOURCE_ONLY_IDENTITY = Object.freeze({
+  current: () => SOURCE_ONLY_IDENTITY_VALUE,
+  subscribe: () => () => {
+  },
+  getAccessToken: async () => null
+});
+const SOURCE_ONLY_IDENTITY_VALUE = Object.freeze({ ...SIGNED_OUT_IDENTITY, authReady: true });
 function resolveChatHost(host) {
   assertDb(host);
-  const { db } = host;
+  const hasDatabase = Boolean(host.db);
+  const reportNoDatabase = (feature) => {
+    ref.diagnostics.capture(new Error(`no database: ${feature}`), {
+      area: "host-source",
+      code: `${NO_DATABASE_CODE_PREFIX}${feature}`
+    });
+  };
+  const db = host.db ?? createNoDatabaseStandIn(reportNoDatabase);
   const overridden = new Set(
     PORTS.filter((name) => host[name] !== void 0)
   );
   const ref = {};
-  const diagnostics = host.diagnostics ?? createLogClientErrorDiagnostics(db, { sourceApp: host.sourceApp });
+  const diagnostics = host.diagnostics ?? (hasDatabase ? createLogClientErrorDiagnostics(db, { sourceApp: host.sourceApp }) : createConsoleDiagnostics());
   const notify = host.notify ?? createDomNotifier();
-  const identity = host.identity ?? createDbIdentity(db, () => ref.diagnostics);
-  const org = host.org ?? createNoPickerOrg(
+  const identity = host.identity ?? (hasDatabase ? createDbIdentity(db, () => ref.diagnostics) : SOURCE_ONLY_IDENTITY);
+  const org = host.org ?? createStoredOrg(
     () => ref.notify,
     () => ref.diagnostics
   );
@@ -68,7 +93,10 @@ function resolveChatHost(host) {
   );
   const server = {
     ...serverPort,
-    api: serverPort.api ?? defaultServerApi(() => ref)
+    api: serverPort.api ?? (hasDatabase || host.server ? defaultServerApi(() => ref) : createNoServerApi(
+      reportNoDatabase,
+      defaultServerApi(() => ref)
+    ))
   };
   const prefs = host.prefs ?? createWebPrefs();
   const navigation = host.navigation ?? createWindowNavigation();
@@ -81,7 +109,10 @@ function resolveChatHost(host) {
   );
   Object.assign(ref, {
     db,
+    hasDatabase,
+    source: host.source ?? null,
     sourceApp: isChatSourceApp(host.sourceApp) ? host.sourceApp : null,
+    app: host.app ?? DEFAULT_CHAT_APP,
     identity,
     org,
     server,
@@ -106,7 +137,7 @@ function defaultServerApi(host) {
 let configured = null;
 function configureChat(host) {
   if (configured?.host === host) return configured.resolved;
-  if (configured && configured.host.db !== host.db) {
+  if (configured && configured.host.db && host.db && configured.host.db !== host.db) {
     announceOnce(
       "configure-replaced-db",
       "configureChat was called again with a different `db`; the newest host replaces the first. Configure the chat host once per page."
@@ -131,6 +162,9 @@ function getChatHost() {
   if (!configured) throw new ChatHostNotConfiguredError();
   return configured.resolved;
 }
+function chatHostHasDatabase() {
+  return configured ? configured.resolved.hasDatabase : true;
+}
 function isChatHostConfigured() {
   return configured !== null;
 }
@@ -138,8 +172,10 @@ function _resetChatHostForTests() {
   configured = null;
 }
 export {
+  DEFAULT_CHAT_APP,
   DEFAULT_CHAT_ROUTES,
   _resetChatHostForTests,
+  chatHostHasDatabase,
   configureChat,
   getChatHost,
   isChatHostConfigured,

package/dist/host/content-ir-slots.d.ts

@@ -183,7 +183,11 @@ export declare const componentRegistry: ContentIrComponentRegistryPort;
 export declare const contentIrKindValidator: () => KindValidator;
 /** A host with no progress adapter promotes nothing: the event keeps only its ordinary typed data. */
 export declare const progressDataRenderBlock: (data: unknown, eventIndex: number, blockIndex: number) => RenderBlockPayload | null;
-/** The classifier primitives have no honest stand-in: a host without them fails loudly by name. */
+/**
+ * The classifier primitives ARE the block classifier, so a bare host gets the real ones from
+ * `@ai-matrx/rich-content` (the same module matrx-frontend registers); the stream accumulator
+ * threw on the first streamed token without them (P29a canary).
+ */
 export declare const contentSplitterPrimitives: () => ContentSplitterPrimitives;
 /** 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>>;

package/dist/host/content-ir-slots.js

@@ -2,6 +2,7 @@ import { sanitizeInboundEnvelopeMetadata as sanitizeInboundEnvelopeMetadataPure
 import { captureError } from "./diagnostics.js";
 import { createElement } from "react";
 import { hostFn, hostSlot } from "./ui-slots.js";
+import * as splitterCore from "@ai-matrx/rich-content/display/markdown-classification/processors/utils/content-splitter-core";
 const CONVERSATION_ANCHOR_TYPE = "conversation";
 const KindInstanceRender = hostSlot(
   "KindInstanceRender",
@@ -63,7 +64,10 @@ const contentIrKindValidator = hostFn("contentIrKindValidator", () => ({
   invalidate: () => void 0
 }));
 const progressDataRenderBlock = hostFn("progressDataRenderBlock", () => null);
-const contentSplitterPrimitives = hostFn("contentSplitterPrimitives");
+const contentSplitterPrimitives = hostFn(
+  "contentSplitterPrimitives",
+  () => splitterCore
+);
 const fetchShapePage = hostFn("fetchShapePage", async () => {
   throw new Error("This host has no shape catalog (registerChatUi fetchShapePage)");
 });

package/dist/host/contract.d.ts

@@ -24,6 +24,7 @@ import type { CanvasJson } from "@ai-matrx/canvas";
 import type { ChatCanvasTabKind } from "./canvas-tabs.js";
 import type { ChatWindowOpeners } from "./window-openers.js";
 import type { DefaultChatServerApi, DefaultChatServerTypes } from "./defaults/server-api.js";
+import type { ChatMessageSource } from "./source.js";
 /**
  * The connection contract (R10). Authenticated, RLS applies. Typed with the
  * package's own `ChatDatabase` (`./db-types`, generated: the schemas the
@@ -89,6 +90,11 @@ export interface ChatOrgPort {
      * Never picks one on the person's behalf.
      */
     require(reason: string, options?: ChatOrgRequireOptions): Promise<string>;
+    /**
+     * The person picked an organization in the package's own picker (the bare-host
+     * `WorkspaceGate`). Absent on a host that brings its own picker (matrx-frontend).
+     */
+    choose?(org: ChatOrganization): void;
 }
 /**
  * The host's server client and its types, REGISTERED by module augmentation —
@@ -718,15 +724,39 @@ export interface ChatCanvasPort {
     useOpeners(): ChatCanvasOpeners;
     useTab(tab: ChatCanvasTabRef): ChatCanvasTab;
 }
+/** How a host names itself on the conversations it starts. */
+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;
+}
 export interface ChatHost {
-    /** R10 connection contract — the ONLY required value. Authenticated, RLS applies. */
-    db: ChatDb;
+    /**
+     * R10 connection contract. Authenticated, RLS applies. Required unless `source` is given: a
+     * host with no database gets the no-database stand-in (`./no-database`), which refuses and
+     * says so per feature.
+     */
+    db?: ChatDb;
+    /**
+     * A host-owned message source (`./source`, HOST-OWNED-SOURCE-PLAN §2.2): conversations bound
+     * to it (`useHostConversation`) load, stream and send through the host, never a database.
+     * Both may be given; at least one is required.
+     */
+    source?: ChatMessageSource;
     /**
      * Which client this is, for the platform errors system (`log_client_error`'s
      * closed `p_source_app` list). Absent or off the list: diagnostics stay on the
      * console and say so once.
      */
     sourceApp?: ChatSourceApp;
+    /**
+     * What this app calls itself on the conversations it starts (`source_app`, and when given a
+     * `source_feature` that replaces the per-screen one). Both must be registered with the server
+     * (`source_attribution`). Absent: the neutral app `chat` and each screen's own feature — a host
+     * that is not matrx-frontend never labels its rows as the main app's.
+     */
+    app?: ChatAppIdentity;
     /** Default: from db.auth (getSession + onAuthStateChange); admin level from admin.admins. */
     identity?: ChatIdentityPort;
     /** Default: no active org; `require` refuses loudly (never auto-picks). */
@@ -765,8 +795,15 @@ export interface ChatHost {
 export type ChatPortName = "identity" | "org" | "server" | "notify" | "diagnostics" | "prefs" | "navigation" | "windows" | "catalog" | "registry" | "chrome" | "feedback" | "routes" | "canvas";
 /** Every port present. `overridden` names the ports the host supplied itself. */
 export interface ResolvedChatHost {
+    /** The host's client, or the no-database stand-in when it gave only a `source`. */
     db: ChatDb;
+    /** False when `db` is the stand-in. */
+    hasDatabase: boolean;
+    /** The host's message source, or null. */
+    source: ChatMessageSource | null;
     sourceApp: ChatSourceApp | null;
+    /** The app's identity on the conversations it starts (`DEFAULT_CHAT_APP` when the host gave none). */
+    app: ChatAppIdentity;
     identity: ChatIdentityPort;
     org: ChatOrgPort;
     server: ResolvedChatServerPort;