@ai-matrx/chat 0.7.29 → 0.7.30

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @ai-matrx/chat
 
+## 0.7.30
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/chat/v0.7.29..npm/chat/v0.7.30 -- apps/shared/chat`).
+No source changes intended and no consumer action required.
+
 ## 0.7.29
 ### the agents messenger
 

package/dist/agents/components/inputs/smart-input/useConversationDisplayRows.d.ts

@@ -1,12 +1,11 @@
+import { type ResolvedContextRow } from "@ai-matrx/agents/context";
+import type { ChatRootState } from "../../../../store/root-state.js";
 /**
- * The context rows a conversation's chip and full view DISPLAY: the door's
- * display rows (`selectDisplayContextRows`), with the server-added documents
- * reconciled against what is attached to the conversation NOW — the same
- * platform.associations edges `AttachedDocumentChips` lists, and the connector
- * resources (repos, Google files, synced records) the attachments handle has
- * read (`selectConversationAttachmentsEntry`, no second fetch). An attachment
- * detached since the last receipt drops out at once; one attached since then
- * shows at once, its size unknown until the next receipt.
+ * What the host's context sources (the page the person is on, for a browser host) would add to
+ * the next turn, read now and again whenever a source says it changed, the window regains focus,
+ * or the conversation changes. A host without sources reads `{}` once and never again.
  */
-import type { ResolvedContextRow } from "@ai-matrx/agents/context";
+export declare function useHostContextPreview(conversationId: string): Record<string, unknown>;
+/** The host's would-be context as rows, each under the person's saved rule; keys already shown stay as they are. */
+export declare function hostContextRows(state: ChatRootState, conversationId: string, shown: readonly ResolvedContextRow[], hostContext: Readonly<Record<string, unknown>>): ResolvedContextRow[];
 export declare function useConversationDisplayRows(conversationId: string, mandateKillSwitch: boolean): ResolvedContextRow[];

package/dist/agents/components/inputs/smart-input/useConversationDisplayRows.js

@@ -1,9 +1,22 @@
 "use client";
+import { useEffect, useMemo, useRef, useState } from "react";
+import {
+  DEFAULT_SURFACE_KEY,
+  resolveContextRow
+} from "@ai-matrx/agents/context";
+import { humanizeIdentifier } from "@ai-matrx/kit/text-case";
 import { useAppSelector, useAppStore } from "../../../../store/hooks.js";
 import { useConversationMaterialized } from "../../../hooks/useConversationMaterialized.js";
 import { useContainerLinks } from "@ai-matrx/associations/react";
 import { attachmentContextKey } from "@ai-matrx/agents/context";
 import {
+  previewHostTurnContext,
+  subscribeHostContextChanges
+} from "../../../redux/execution-system/utils/host-turn.js";
+import { resolveClientSurface } from "../../../redux/execution-system/utils/build-tool-injection.js";
+import { selectSavedContextRuleRows } from "../../../redux/execution-system/context-rules/context-rules.thunks.js";
+import {
+  selectContextInlineCap,
   DOCUMENT_ATTACHMENT_PREFIXES,
   RESOURCE_ATTACHMENT_PREFIXES,
   durableAttachmentKey,
@@ -18,6 +31,51 @@ import {
   useAttachedDocumentFileNames
 } from "../resources/attached-documents.js";
 import { selectOrganizationId } from "../../../../host/org.js";
+function useHostContextPreview(conversationId) {
+  const store = useAppStore();
+  const [preview, setPreview] = useState({});
+  const latest = useRef(0);
+  useEffect(() => {
+    let live = true;
+    const read = () => {
+      const ticket = ++latest.current;
+      void previewHostTurnContext(store.getState(), conversationId).then(
+        (context) => {
+          if (live && ticket === latest.current) setPreview(context);
+        },
+        () => void 0
+      );
+    };
+    read();
+    const off = subscribeHostContextChanges(read);
+    const onFocus = () => read();
+    window.addEventListener("focus", onFocus);
+    return () => {
+      live = false;
+      off();
+      window.removeEventListener("focus", onFocus);
+    };
+  }, [store, conversationId]);
+  return preview;
+}
+function hostContextRows(state, conversationId, shown, hostContext) {
+  const keys = Object.keys(hostContext);
+  if (keys.length === 0) return [];
+  const have = new Set(shown.map((row) => row.key));
+  const saved = selectSavedContextRuleRows(state);
+  const cap = selectContextInlineCap(state, conversationId);
+  const primarySurface = resolveClientSurface(state, conversationId) ?? null;
+  return keys.filter((key) => !have.has(key) && hostContext[key] !== void 0).map((key) => {
+    const source = {
+      key,
+      label: humanizeIdentifier(key) || key,
+      surfaceKey: DEFAULT_SURFACE_KEY,
+      origin: "page",
+      value: hostContext[key]
+    };
+    return resolveContextRow(source, saved, cap, primarySurface);
+  });
+}
 function useConversationDisplayRows(conversationId, mandateKillSwitch) {
   const store = useAppStore();
   const rows = useAppSelector(selectDisplayContextRows(conversationId, mandateKillSwitch));
@@ -55,11 +113,28 @@ function useConversationDisplayRows(conversationId, mandateKillSwitch) {
     key: attachmentContextKey(row.provider, row.resource_ref),
     label: row.display_name
   })) : null;
-  return reconcileDurableAttachments(store.getState(), conversationId, rows, [
-    { prefixes: DOCUMENT_ATTACHMENT_PREFIXES, items: documents },
-    { prefixes: RESOURCE_ATTACHMENT_PREFIXES, items: resources }
-  ]);
+  const reconciled = reconcileDurableAttachments(
+    store.getState(),
+    conversationId,
+    rows,
+    [
+      { prefixes: DOCUMENT_ATTACHMENT_PREFIXES, items: documents },
+      { prefixes: RESOURCE_ATTACHMENT_PREFIXES, items: resources }
+    ]
+  );
+  const hostContext = useHostContextPreview(conversationId);
+  return useMemo(() => {
+    const extra = hostContextRows(
+      store.getState(),
+      conversationId,
+      reconciled,
+      hostContext
+    );
+    return extra.length === 0 ? reconciled : [...reconciled, ...extra];
+  }, [store, conversationId, reconciled, hostContext]);
 }
 export {
-  useConversationDisplayRows
+  hostContextRows,
+  useConversationDisplayRows,
+  useHostContextPreview
 };

package/dist/agents/redux/execution-system/utils/host-turn.d.ts

@@ -37,6 +37,15 @@ export declare function resetLatchedTurns(): void;
  * keeps what the start latched (a resume whose start predates this page load latches then).
  */
 export declare function collectHostTurnContribution(state: ChatRootState, conversationId: string, phase: ChatHostTurnPhase): Promise<ChatHostTurnContribution | null>;
+/**
+ * What the host's context sources would add to the NEXT turn's `context`, read for display (the
+ * composer's context chip). Same sources, same bounded wait, same merge as a real send, but
+ * nothing is latched. A source that is slow or throws contributes no rows here (the skip is
+ * announced through diagnostics like any other).
+ */
+export declare function previewHostTurnContext(state: ChatRootState, conversationId: string): Promise<Record<string, unknown>>;
+/** Subscribe to every context source's "my answer may have changed" signal; returns one unsubscribe. */
+export declare function subscribeHostContextChanges(onChange: () => void): () => void;
 /**
  * Merge the host's context entries under what the request already carries: a key the person
  * or the agent set always wins. Returns the original object when the host adds nothing.

package/dist/agents/redux/execution-system/utils/host-turn.js

@@ -93,6 +93,29 @@ async function collectHostTurnContribution(state, conversationId, phase) {
   }
   return contribution;
 }
+async function previewHostTurnContext(state, conversationId) {
+  if (!isChatHostConfigured()) return {};
+  const sources = getChatHost().registry.contextSources ?? [];
+  if (sources.length === 0) return {};
+  const input = {
+    conversationId,
+    agentId: agentIdOf(state, conversationId),
+    phase: "start"
+  };
+  const merged = mergeContributions(
+    await Promise.all(sources.map((source) => askSource(source, input)))
+  );
+  return merged?.context ?? {};
+}
+function subscribeHostContextChanges(onChange) {
+  if (!isChatHostConfigured()) return () => void 0;
+  const offs = (getChatHost().registry.contextSources ?? []).flatMap(
+    (source) => source.subscribe ? [source.subscribe(onChange)] : []
+  );
+  return () => {
+    for (const off of offs) off();
+  };
+}
 function mergeHostTurnContext(existing, hostContext) {
   if (!hostContext) return existing;
   const keys = Object.keys(hostContext);
@@ -113,7 +136,9 @@ export {
   devicePermissionModeKey,
   getLatchedTurn,
   mergeHostTurnContext,
+  previewHostTurnContext,
   readDevicePermissionMode,
   resetLatchedTurns,
+  subscribeHostContextChanges,
   writeDevicePermissionMode
 };

package/dist/context/sources/scopes.d.ts

@@ -3,7 +3,7 @@
  *
  * Scopes (user-authored dimensions: organization, project, task, scope types and their
  * values, the active scope selection) are a platform primitive the chat package READS to
- * build what an agent receives. Until `@ai-matrx/scopes` exists (P17s1–s2), the host hands
+ * build what an agent receives. Until the data/records packages own scope reading (scopes package deleted 2026-10-09), the host hands
  * them over through ONE registration, `registerChatScopes({...})`, keyed by the export names
  * that package will publish — so P17s3 swaps this module's import specifier for
  * `@ai-matrx/scopes` and deletes this file, with no call-site change.

package/dist/host/contract.d.ts

@@ -873,6 +873,12 @@ export interface ChatContextSource {
     /** Stable id, for diagnostics. */
     id: string;
     contribute(input: ChatHostTurnInput): Promise<ChatHostTurnContribution | null>;
+    /**
+     * Tell the package this source's answer may have changed (the page navigated, the person
+     * switched tabs), so the composer's context chip re-reads it. Returns the unsubscribe. Absent:
+     * the chip reads the source when the conversation opens and when the window regains focus.
+     */
+    subscribe?(onChange: () => void): () => void;
 }
 export interface ChatRoutingPort {
     policy(conversationId: string): ChatRoutingPolicy;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.7.29",
+  "version": "0.7.30",
   "description": "THE one AI Matrx person-to-agent chat system: the full chat (running agents, conversations, tool calls, streaming, context, surfaces, voice) as explicit per-module subpaths @ai-matrx/chat/<domain>/<module> (no wildcards: scripts/public-modules.json) over a host contract (/host, /host/react) whose only required value is a db. One chat, one renderer: the old kernel entries (., /external-store, /matrx, /react, /tools, styles.css, tokens.css) are retired.",
   "type": "module",
   "license": "MIT",
@@ -4716,14 +4716,14 @@
     "server-only": "^0.0.1",
     "uuid": "^14.0.2",
     "zod": "^4.6.5",
+    "@ai-matrx/alchemy": "latest",
     "@ai-matrx/associations": "latest",
     "@ai-matrx/browser-audio": "latest",
-    "@ai-matrx/alchemy": "latest",
+    "@ai-matrx/agents": "latest",
     "@ai-matrx/canvas": "latest",
     "@ai-matrx/content-ir": "latest",
     "@ai-matrx/content-ir-react": "latest",
     "@ai-matrx/data": "latest",
-    "@ai-matrx/diff": "latest",
     "@ai-matrx/design-system": "latest",
     "@ai-matrx/icons": "latest",
     "@ai-matrx/kit": "latest",
@@ -4731,11 +4731,11 @@
     "@ai-matrx/messaging": "latest",
     "@ai-matrx/print": "latest",
     "@ai-matrx/realtime": "latest",
+    "@ai-matrx/diff": "latest",
     "@ai-matrx/records": "latest",
     "@ai-matrx/records-ui": "latest",
     "@ai-matrx/rich-content": "latest",
-    "@ai-matrx/rich-editor": "latest",
-    "@ai-matrx/agents": "latest"
+    "@ai-matrx/rich-editor": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",
@@ -4854,5 +4854,5 @@
     "check:side-effects": "node ../scripts/check-side-effects-listed.mjs . && node ../scripts/check-side-effects-listed.mjs --self-test",
     "check:public-surface": "node ./scripts/sync-public-surface.mjs --check && node ./scripts/sync-public-surface.mjs --self-test"
   },
-  "gitHead": "4d71c2b833fcf4ddf381519c7ceda59cfa0174db"
+  "gitHead": "95a5e215a7437a241b5588b14653a183c82c240c"
 }