@ai-matrx/chat 0.4.0 → 0.4.2

package/CHANGELOG.md

@@ -1,5 +1,31 @@
 # @ai-matrx/chat
 
+## 0.4.2
+### P29a round 2 (a bare host is a real app)
+
+- **Front door = the real screens.** `FRONT_DOOR` now names `agents/components/chat/ChatNewClient` and
+  `ChatConversationRoom`; the `cx-chat` demo screens are out. The default navigation port is
+  CLIENT-SIDE (history API + a notify event; same-origin `Link` clicks move the history, no page load);
+  `@ai-matrx/chat/host/react` exports `useRouter`/`usePathname`/`useSearchParams`/`Link` over the host's
+  navigation port. `check:front-door:canary` scans the canary.
+- **A host names itself.** `ChatHost.app = { sourceApp, sourceFeature? }` stamps `source_app` /
+  `source_feature` on every send; absent = the neutral `chat` producer (said once), never matrx-frontend.
+  matrx-frontend sets `app: { sourceApp: "matrx-frontend" }` explicitly. Both names must be registered
+  with the server.
+- **The model picker is the agents package's own** (`@ai-matrx/agents/models/react`); `ModelListDropdown` is
+  no longer a slot. A bare host's `BareHostChrome` mounts the catalog + favorites over `host.db`.
+- **Unsent chips persist server-side in a bare host** (`default-remark-durability`: `block_state_set` /
+  `block_state_list_staged` / `block_state_dismiss_chip`), registered by `<ChatProvider>` for a private store.
+- **Stand-ins report quietly.** An unregistered optional slot is one `console.info` line, once; only a
+  registration the package cannot run without (`SLOT_CANNOT_RUN`) warns and reaches diagnostics.
+  A bare host also gets the associations service (working document + scratchpad restore) from its own store.
+
+## 0.4.1
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/chat/v0.4.0..npm/chat/v0.4.1 -- apps/shared/chat`).
+No source changes intended and no consumer action required.
+
 ## 0.4.0
 
 Agent core B3 + the B2 tail — every piece of agent and model state has one holder:

package/dist/agents/addressing/useAgentHref.js

@@ -1,6 +1,7 @@
 "use client";
 import { useContext, useEffect, useState, useSyncExternalStore } from "react";
 import { ReactReduxContext } from "react-redux";
+import { ChatStoreContext } from "../../store/context.js";
 import {
   agentDoorFor,
   agentGoHref,
@@ -15,7 +16,9 @@ import { selectIsAdmin } from "../../host/identity.js";
 const noSubscribe = () => () => {
 };
 function useAgentAddressViewer() {
-  const store = useContext(ReactReduxContext)?.store;
+  const chatStore = useContext(ChatStoreContext)?.store;
+  const hostStore = useContext(ReactReduxContext)?.store;
+  const store = chatStore ?? hostStore;
   const read = () => store ? selectIsAdmin(store.getState()) : void 0;
   const isAdmin = useSyncExternalStore(
     store ? store.subscribe : noSubscribe,

package/dist/agents/api/submit-tool-results.js

@@ -1,3 +1,5 @@
+import { selectHostConversation } from "../redux/execution-system/host-conversations/host-conversations.selectors.js";
+import { answerHostAsk } from "../redux/execution-system/host-conversations/host-conversation.thunks.js";
 import { callApi } from "../../host/server/call-api.js";
 import { toast } from "../../host/notify.js";
 import { formatDurationMs } from "@ai-matrx/kit/format";
@@ -232,7 +234,7 @@ async function failLifecycleForCalls(dispatch, getState, conversationId, results
   }
 }
 const submitToolResult = (pending) => {
-  return (dispatch) => {
+  return (dispatch, getState) => {
     dispatch(settleClientToolCall(pending));
     if (!pending.is_error && nonErrorOutputReadsAsFailure(pending.output)) {
       console.error(
@@ -240,6 +242,14 @@ const submitToolResult = (pending) => {
       );
     }
     const { conversationId, ...rest } = pending;
+    if (selectHostConversation(conversationId)(getState())) {
+      void answerHostAsk(conversationId, rest.call_id, rest).catch((error) => {
+        toast.error("Your answer did not reach this chat", {
+          description: error instanceof Error ? error.message : String(error)
+        });
+      });
+      return;
+    }
     const bucket = queue.get(conversationId) ?? [];
     bucket.push(rest);
     queue.set(conversationId, bucket);

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

@@ -1,6 +1,6 @@
 "use client";
 import { useEffect } from "react";
-import { useStore } from "react-redux";
+import { useAppStore as useStore } from "../../../store/hooks.js";
 import { useOptionalCanvas } from "@ai-matrx/canvas/react";
 import { selectCanvasIsHydrated } from "@ai-matrx/canvas";
 function canvasItemConversation(item, conversationOfMessage) {

package/dist/agents/components/messages-display/AgentConversationDisplay.js

@@ -1,5 +1,6 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { useConversationAbilities } from "../../redux/execution-system/host-conversations/conversation-abilities.js";
 import { useEffect, useMemo, useRef, useState } from "react";
 import { useAppDispatch, useAppSelector } from "../../../store/hooks.js";
 import { loadConversation } from "../../redux/execution-system/thunks/load-conversation.thunk.js";
@@ -101,9 +102,11 @@ function AgentConversationDisplay({
     () => setFindOpen(true),
     displayGroups.length > 0
   );
+  const { database: canPin } = useConversationAbilities();
   useEffect(() => {
+    if (!canPin) return;
     void hydratePinnedMessages(messages.map((m) => m.id));
-  }, [messages]);
+  }, [messages, canPin]);
   const [findHistory, setFindHistory] = useState({
     state: "loading",
     loaded: 0

package/dist/agents/components/run-controls/panels/shared.d.ts

@@ -65,6 +65,7 @@ export declare function makeSelectConversationRequests(conversationId: string):
     agentSettings: import("../../../redux/agent-settings/types.js").AgentSettingsState;
     conversationAttachments: import("../../../connectors/attachments.slice.js").AttachmentsSliceState;
     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) => ActiveRequest[]) & {
     clearCache: () => void;
     resultsCount: () => number;

package/dist/agents/components/shared/AgentConversationColumn.js

@@ -26,6 +26,7 @@ import {
 } from "../../redux/execution-system/messages/messages.slice.js";
 import { selectStreamPhase } from "../../redux/execution-system/selectors/aggregate.selectors.js";
 import { selectShowCreatorPanel } from "../../../host/prefs.js";
+import { ConversationAbilitiesProvider } from "../../redux/execution-system/host-conversations/conversation-abilities.js";
 import {
   TranscriptAudienceProvider
 } from "./transcript-audience.js";
@@ -202,7 +203,7 @@ function AgentConversationColumn({
   }, []);
   const edgeScroll = constrainWidth && edgeToEdgeScroll;
   const centerWrap = edgeScroll ? cn(ASSISTANT_MESSAGE_COLUMN_CLASS, ASSISTANT_MESSAGE_COLUMN_INSET_CLASS) : "contents";
-  return /* @__PURE__ */ jsx(TranscriptAudienceProvider, { audience, children: /* @__PURE__ */ jsxs(
+  return /* @__PURE__ */ jsx(ConversationAbilitiesProvider, { conversationId: displayId, children: /* @__PURE__ */ jsx(TranscriptAudienceProvider, { audience, children: /* @__PURE__ */ jsxs(
     "div",
     {
       className: cn(
@@ -347,7 +348,7 @@ function AgentConversationColumn({
         )
       ]
     }
-  ) });
+  ) }) });
 }
 export {
   AgentConversationColumn

package/dist/agents/components/working-document/workingDocumentSurface.d.ts

@@ -20,7 +20,7 @@ export declare function surfaceNameForKind(kind: WorkingDocumentKind): string;
 export declare function sourceFeatureForKind(kind: WorkingDocumentKind): SourceFeature;
 /** `UnifiedAgentContextMenu` prop bundle for a document kind. */
 export declare function workingDocumentContextMenuProps(kind: WorkingDocumentKind): {
-    sourceFeature: "action_request_continuation" | "action_request_credential" | "action_request_one_time_code" | "action_request_park" | "action_request_resolve" | "admin" | "agent" | "agent-app" | "agent-builder" | "agent-comparison" | "agent-factory" | "agent-generator" | "agent-runner" | "agent-service" | "agent-studio" | "agent_blocks" | "agent_call" | "agent_factory.copy_probe" | "agent_factory.tool_probe" | "agent_flow_v1" | "agent_foundry_v1" | "agent_run" | "agent_structure_builder" | "agent_tool" | "agent_usage_sync" | "agents-other" | "ai-results" | "ai_judge" | "analysis-studio" | "auto_ingest" | "auto_ingest_ner" | "background_agent" | "billing" | "browser_handoff_delegate" | "browser_handoff_resolve" | "browser_session_health" | "builtin_agent" | "builtin_categorize" | "canvas" | "chat" | "claude-code" | "clean_pdf_extracted_content" | "client-unmapped" | "cloud_browser.local_login_learning" | "cms" | "code-editor" | "codex" | "coding_session_bridge.backfill" | "coding_session_native" | "coding_session_reply" | "communications.sms" | "conductor" | "content-extractor" | "content_plan_acceptance" | "content_plan_cms_fill" | "content_plan_cms_fill_preview" | "content_plan_deepen" | "content_plan_generate" | "content_processing" | "content_processing.research_landing" | "content_processing.transcript_landing" | "content_processing_upload_hook" | "context-parity" | "context_compare_answer" | "context_follow_listener" | "context_summary" | "conversation" | "conversation_context" | "conversation_crash_recovery" | "conversation_fork" | "conversation_resume" | "coverage" | "crawl_run" | "crm" | "crm.media_list_refresh" | "crm.media_list_research" | "crm.party_kind" | "crm.personalization" | "cursor" | "deep_research_v1" | "deferred_claim_recovery" | "dictionary" | "distillation_coherence" | "doc_verify" | "documents" | "education-analytics" | "education-assessment" | "education-fastfire" | "education-flashcards" | "education-ingest" | "education-media-reconcile" | "education-mindmap" | "education-planner" | "education-tutor" | "education_card_image_generator" | "education_card_image_prompt_writer" | "education_card_image_qc_judge" | "education_card_image_rot" | "education_card_image_web_source" | "education_card_images" | "education_study_pack" | "education_study_pack_v2" | "endpoint_family_sweep" | "external_url_change" | "files" | "fork_and_run" | "google_workspace.approval_replay" | "group_chat_cadence" | "hindsight" | "hindsight/crystallization" | "hindsight/wire_replay" | "hindsight_replay" | "hindsight_replay_worker" | "hindsight_shadow_recompilation" | "hr" | "human_decisions" | "image-studio" | "incident-assurance" | "internal" | "judge" | "kg_clustering_namer" | "legal" | "local_proxy" | "mandate_candidate_review" | "mandates.batch_lane" | "manual" | "marketing" | "masterwork" | "masterwork_audition_elicitation_vanilla" | "masterwork_audition_outcome_vanilla" | "masterwork_audition_unfolding_vanilla" | "masterwork_audition_vanilla" | "masterwork_bench_a2" | "masterwork_bench_extract" | "masterwork_bench_judge" | "masterwork_bench_panel" | "masterwork_build" | "masterwork_recovery" | "media_catalog" | "media_heal" | "meet:after_meeting_workflow" | "mermaid-workbench" | "messages" | "ner" | "news_monitor" | "notes" | "notify_listener" | "outcome_attribution" | "outreach" | "page_extraction" | "page_extraction_retry" | "pdf-cleaner" | "pdf-extractor" | "pdf-widgets" | "personal-staff" | "personal_staff_workspace_listener" | "platform_checks" | "platform_checks_drain" | "podcasts" | "print" | "product_capture_intake" | "product_capture_research" | "projects" | "prompt" | "proof_run:content_plan_family_grounding" | "proof_run:news_self_validating" | "provenance" | "provider_outage" | "rag" | "rag-search" | "rag.page_clean" | "rag_chunk_contextualizer" | "rag_hyde_generator" | "rag_pdf_page_cleaner" | "rag_query_expander" | "reachability" | "realtime" | "realtime_tool" | "registry_ingestion.pass" | "request_snapshot_blob" | "reroute" | "research" | "research_condenser_1" | "research_condenser_2" | "research_refresh_dispatch" | "row_history" | "scanner" | "scheduled" | "schema_coerce" | "scraper" | "scratchpad" | "screen_tool_run" | "seo" | "seo.engine_schedule_dispatcher" | "seo.keyword_place_backfill" | "seo.page_analysis" | "seo.rank_schedule" | "seo_analysis_sweep" | "seo_keyword_research" | "server-door" | "server-run" | "sharing" | "sms-assistant" | "sms-outbound" | "socket_compat" | "source_intelligence" | "staff-inbox-driver" | "suggestion_sweep" | "summarize_content" | "sweep_listener" | "system" | "tasks" | "test.agent_factory.intake" | "tool-call-visualization" | "tool-testing" | "transcription" | "udt" | "vision_interview" | "vision_interview_tracker" | "voice-agent" | "vscode" | "web-capture" | "web_crawl_crash_resume" | "web_crawl_schedule_dispatch" | "web_research" | "web_url_announce" | "whole_value_follower" | "workflow_decision_fallback" | "workflow_extract_sweep" | "workflow_holder_proof" | "workflow_node_test" | "workflow_plan_assist" | "workflow_recovery_advisor" | "workflow_recovery_push" | "workflow_recovery_resolve" | "workflow_run" | "workflow_run_assists" | "workflow_worker" | "working-document" | "youtube_research_processing" | "youtube_transcription";
+    sourceFeature: "action_request_continuation" | "action_request_credential" | "action_request_one_time_code" | "action_request_park" | "action_request_resolve" | "admin" | "agent" | "agent-app" | "agent-builder" | "agent-comparison" | "agent-factory" | "agent-generator" | "agent-runner" | "agent-service" | "agent-studio" | "agent_blocks" | "agent_call" | "agent_factory.copy_probe" | "agent_factory.tool_probe" | "agent_flow_v1" | "agent_foundry_v1" | "agent_run" | "agent_structure_builder" | "agent_tool" | "agent_usage_sync" | "agents-other" | "ai-results" | "ai_judge" | "analysis-studio" | "auto_ingest" | "auto_ingest_ner" | "background_agent" | "billing" | "browser_handoff_delegate" | "browser_handoff_resolve" | "browser_session_health" | "builtin_agent" | "builtin_categorize" | "canvas" | "chat" | "chat-canary" | "claude-code" | "clean_pdf_extracted_content" | "client-unmapped" | "cloud_browser.local_login_learning" | "cms" | "code-editor" | "codex" | "coding_session_bridge.backfill" | "coding_session_native" | "coding_session_reply" | "communications.sms" | "conductor" | "content-extractor" | "content_plan_acceptance" | "content_plan_cms_fill" | "content_plan_cms_fill_preview" | "content_plan_deepen" | "content_plan_generate" | "content_processing" | "content_processing.research_landing" | "content_processing.transcript_landing" | "content_processing_upload_hook" | "context-parity" | "context_compare_answer" | "context_follow_listener" | "context_summary" | "conversation" | "conversation_context" | "conversation_crash_recovery" | "conversation_fork" | "conversation_resume" | "coverage" | "crawl_run" | "crm" | "crm.media_list_refresh" | "crm.media_list_research" | "crm.party_kind" | "crm.personalization" | "cursor" | "deep_research_v1" | "deferred_claim_recovery" | "dictionary" | "distillation_coherence" | "doc_verify" | "documents" | "education-analytics" | "education-assessment" | "education-fastfire" | "education-flashcards" | "education-ingest" | "education-media-reconcile" | "education-mindmap" | "education-planner" | "education-tutor" | "education_card_image_generator" | "education_card_image_prompt_writer" | "education_card_image_qc_judge" | "education_card_image_rot" | "education_card_image_web_source" | "education_card_images" | "education_study_pack" | "education_study_pack_v2" | "endpoint_family_sweep" | "external_url_change" | "files" | "fork_and_run" | "google_workspace.approval_replay" | "group_chat_cadence" | "hindsight" | "hindsight/crystallization" | "hindsight/wire_replay" | "hindsight_replay" | "hindsight_replay_worker" | "hindsight_shadow_recompilation" | "hr" | "human_decisions" | "image-studio" | "incident-assurance" | "internal" | "judge" | "kg_clustering_namer" | "legal" | "local_proxy" | "mandate_candidate_review" | "mandates.batch_lane" | "manual" | "marketing" | "masterwork" | "masterwork_audition_elicitation_vanilla" | "masterwork_audition_outcome_vanilla" | "masterwork_audition_unfolding_vanilla" | "masterwork_audition_vanilla" | "masterwork_bench_a2" | "masterwork_bench_extract" | "masterwork_bench_judge" | "masterwork_bench_panel" | "masterwork_build" | "masterwork_recovery" | "media_catalog" | "media_heal" | "meet:after_meeting_workflow" | "mermaid-workbench" | "messages" | "ner" | "news_monitor" | "notes" | "notify_listener" | "outcome_attribution" | "outreach" | "page_extraction" | "page_extraction_retry" | "pdf-cleaner" | "pdf-extractor" | "pdf-widgets" | "personal-staff" | "personal_staff_workspace_listener" | "platform_checks" | "platform_checks_drain" | "podcasts" | "print" | "product_capture_intake" | "product_capture_research" | "projects" | "prompt" | "proof_run:content_plan_family_grounding" | "proof_run:news_self_validating" | "provenance" | "provider_outage" | "rag" | "rag-search" | "rag.page_clean" | "rag_chunk_contextualizer" | "rag_hyde_generator" | "rag_pdf_page_cleaner" | "rag_query_expander" | "reachability" | "realtime" | "realtime_tool" | "registry_ingestion.pass" | "request_snapshot_blob" | "reroute" | "research" | "research_condenser_1" | "research_condenser_2" | "research_refresh_dispatch" | "row_history" | "scanner" | "scheduled" | "schema_coerce" | "scraper" | "scratchpad" | "screen_tool_run" | "seo" | "seo.engine_schedule_dispatcher" | "seo.keyword_place_backfill" | "seo.page_analysis" | "seo.rank_schedule" | "seo_analysis_sweep" | "seo_keyword_research" | "server-door" | "server-run" | "sharing" | "sms-assistant" | "sms-outbound" | "socket_compat" | "source_intelligence" | "staff-inbox-driver" | "suggestion_sweep" | "summarize_content" | "sweep_listener" | "system" | "tasks" | "test.agent_factory.intake" | "tool-call-visualization" | "tool-testing" | "transcription" | "udt" | "vision_interview" | "vision_interview_tracker" | "voice-agent" | "vscode" | "web-capture" | "web_crawl_crash_resume" | "web_crawl_schedule_dispatch" | "web_research" | "web_url_announce" | "whole_value_follower" | "workflow_decision_fallback" | "workflow_extract_sweep" | "workflow_holder_proof" | "workflow_node_test" | "workflow_plan_assist" | "workflow_recovery_advisor" | "workflow_recovery_push" | "workflow_recovery_resolve" | "workflow_run" | "workflow_run_assists" | "workflow_worker" | "working-document" | "youtube_research_processing" | "youtube_transcription";
     surfaceName: string;
     isEditable: true;
     enabledPlacements: ("ai-action" | "content-block" | "quick-action")[];

package/dist/agents/identity/model-catalog.js

@@ -12,6 +12,7 @@ import { useModelRecordsSelector } from "@ai-matrx/agents/models/react";
 import { supabase } from "../../host/db.js";
 import { captureError } from "../../host/diagnostics.js";
 import { isSignedOutVisitor } from "../../host/identity.js";
+import { chatHostHasDatabase } from "../../host/configure.js";
 const KEY = /* @__PURE__ */ Symbol.for("ai-matrx.chat.model-catalog");
 function getModelCatalog() {
   const g = globalThis;
@@ -19,7 +20,8 @@ function getModelCatalog() {
   const catalog = createModelCatalog({
     // supabase-js satisfies the catalog's structural client as-is.
     client: supabase,
-    isSignedIn: async () => !await isSignedOutVisitor(),
+    // A host with no database has no catalog to read (host/source): nobody is signed in.
+    isSignedIn: async () => chatHostHasDatabase() && !await isSignedOutVisitor(),
     errorSink: (event) => {
       captureError({
         source: "supabase-postgrest",
@@ -69,13 +71,13 @@ function useModelLabel(modelId) {
 function useModelLabelWithClass(modelId, offeringId) {
   useModelLabel(modelId);
   useEffect(() => {
-    void getModelRecords().loadClasses();
+    if (chatHostHasDatabase()) void getModelRecords().loadClasses();
   }, []);
   return useModelRecords((s) => selectModelLabelWithClass(s, modelId, offeringId));
 }
 function useModelClassLabels() {
   useEffect(() => {
-    void getModelRecords().loadClasses();
+    if (chatHostHasDatabase()) void getModelRecords().loadClasses();
   }, []);
 }
 function useModelClassControls(modelId, offeringId) {