@ai-matrx/chat 0.2.3 → 0.2.5

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @ai-matrx/chat
 
+## 0.2.5 — 2026-10-06
+### Re-sync before matrx-frontend consumes the published package (P27)
+
+- Carries every matrx-frontend `packages/chat` edit made after base `1b1bc31165`: run-headless-agent-json
+  (shortcutId/applicationScope + result keeping), picklist input, surface-catalog profile, host ui-slots and
+  window-openers, route-to-surface, tool-call-visualization registry/effects, regenerated `host/db-types.ts`
+  (pick-list renames). Alchemy imports stay on `@ai-matrx/alchemy/operate` (ALC-16).
+- `store/hooks.ts` seam hooks (`useAppSelector`/`useAppDispatch`/`useAppStore`) are annotated so their
+  .d.ts keep the registered host types instead of the expanded bare shape (P27).
+- Consumer action: none.
+
+## 0.2.4 — 2026-10-06
+
+- The Alchemy menu imports come from `@ai-matrx/alchemy/react/workspace` and transfer types from
+  `@ai-matrx/alchemy/operate` (ALC-16; design-system 0.69.0 removed `./content-transfer`).
+  `conversationJsonFormat` is the contract's lazy `FormatAdapter` (`load()` → `build(draft, options, signal)`).
+- `store/root-state.ts` `ChatHostReadSlices` drops its `[field: string]: unknown` index signatures, so a
+  host's concrete slice interfaces (matrx-frontend's `UserAuthState`, …) are assignable to the
+  package's emitted selector/thunk signatures (P27: ~490 of the 646 app errors against 0.2.3).
+- Consumer action: none.
+
 ## 0.2.3
 ### The frontend's last in-flight chat edit, carried at the P27 cutover
 

package/dist/agent-copy/AlchemySurfaceBridge.js

@@ -4,7 +4,7 @@ import { useEffect, useId, useRef } from "react";
 import {
   createSurfaceTransferHandle
 } from "@ai-matrx/alchemy/operate";
-import { ContentTransferSurfaceProvider } from "@ai-matrx/design-system/content-transfer";
+import { ContentTransferSurfaceProvider } from "@ai-matrx/alchemy/react/workspace";
 import { getSurfaceManifest } from "../host/ui-slots.js";
 function useAlchemySurfaceHandle(surfaceName, getScope) {
   const instanceId = useId();

package/dist/agent-copy/alchemy-session.d.ts

@@ -1,5 +1,5 @@
-import type { FormatAdapter, Payload, Source } from "@ai-matrx/kit/content-transfer";
-import type { EnvelopeMeta, TransferMenuVariant } from "@ai-matrx/design-system/content-transfer";
+import type { FormatAdapter, Payload, Source } from "@ai-matrx/alchemy/operate";
+import type { EnvelopeMeta, TransferMenuVariant } from "@ai-matrx/alchemy/react/workspace";
 export type AlchemySessionIntent = 
 /**
  * The preparation workspace (trim, choose, AI preparation, destinations). `forDestination`: the

package/dist/agent-copy/page-capture/pageCapture.d.ts

@@ -15,7 +15,7 @@
  * network — the suite drives it directly.
  */
 import type { AgentPayloadInput } from "@ai-matrx/alchemy/operate";
-import type { AlchemyGroomerConfig } from "@ai-matrx/design-system/content-transfer";
+import type { AlchemyGroomerConfig } from "@ai-matrx/alchemy/react/workspace";
 export type PageCaptureKind = "table-page" | "record" | "dialog" | "admin-page";
 /** A chosen thing, by name and id. Either may be null (not chosen / not loaded). */
 export interface PageCaptureNamed {

package/dist/agents/components/inputs/input-components/PicklistVariableInput.js

@@ -10,7 +10,7 @@ import {
   buildPicklistItemFence,
   readPicklistSelection
 } from "@ai-matrx/agents/envelope";
-import { useStructuredListForSelection } from "../../../../host/ui-slots.js";
+import { usePickListForSelection } from "../../../../host/ui-slots.js";
 import { ReadFailure } from "../../../../host/ui-slots.js";
 const OTHER_PREFIX = "Other: ";
 function PicklistVariableInput({
@@ -23,7 +23,7 @@ function PicklistVariableInput({
   containerWidth = 0
 }) {
   const binding = readStructuredList(customComponent);
-  const { items, loading, unavailable, error, retry } = useStructuredListForSelection(
+  const { items, loading, unavailable, error, retry } = usePickListForSelection(
     binding?.listId ?? null,
     binding?.groupName
   );

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_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" | "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" | "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_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" | "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/conversation-export/conversation-transfer.d.ts

@@ -1,6 +1,6 @@
 import type { ConversationTransferRow } from "./conversation-transfer-rows.js";
 import type { Payload, Section, Source } from "@ai-matrx/alchemy/operate";
-import type { FormatAdapter } from "@ai-matrx/kit/content-transfer";
+import type { FormatAdapter } from "@ai-matrx/alchemy/operate";
 import type { ChatDispatch, ChatRootState } from "../../store/root-state.js";
 export interface ConversationMessageRow {
     role: "user" | "assistant";

package/dist/agents/conversation-export/conversation-transfer.js

@@ -100,8 +100,13 @@ function conversationJsonFormat(read) {
   return {
     id: "json",
     label: "JSON",
+    extension: "json",
+    mime: "application/json;charset=utf-8",
+    modes: ["copy", "download"],
+    runsOn: "client",
     supports: (payload) => payload.kind === "markdown" || payload.kind === "text",
-    build: async (draft, signal) => {
+    // The contract's lazy adapter (`@ai-matrx/alchemy/operate`): the engine is this closure.
+    load: async () => ({ build: async (draft, _options, signal) => {
       const c = await read();
       signal.throwIfAborted();
       const onlyCut = !draft.manuallyEdited && draft.provenance.every((p) => p.kind === "original" || p.kind === "deterministic") && draft.omissions.every((o) => o.reason === "excluded");
@@ -128,7 +133,7 @@ function conversationJsonFormat(read) {
         file: { filename: `${c.fileBase}.json`, mime: "application/json;charset=utf-8", bytes: new TextEncoder().encode(json) },
         omissions: draft.omissions.map((o) => ({ ...o }))
       });
-    }
+    } })
   };
 }
 function sourceOf(id, label, read) {

package/dist/agents/redux/execution-system/selectors/aggregate.selectors.d.ts

@@ -418,10 +418,8 @@ export declare function makeSelectAssembledRequest(conversationId: string): ((st
     resetResultsCount: () => void;
 } & {
     resultFunc: (resultFuncArgs_0: import("../conversations/conversations.slice.js").ConversationsState, resultFuncArgs_1: import("../instance-ui-state/instance-ui-state.slice.js").InstanceUIStateSlice, resultFuncArgs_2: import("../instance-user-input/instance-user-input.slice.js").InstanceUserInputSliceState, resultFuncArgs_3: import("../instance-resources/instance-resources.slice.js").InstanceResourcesState, resultFuncArgs_4: import("../instance-variable-values/instance-variable-values.slice.js").InstanceVariableValuesState, resultFuncArgs_5: import("../instance-model-overrides/instance-model-overrides.slice.js").InstanceModelOverridesState, resultFuncArgs_6: import("../instance-context/instance-context.slice.js").InstanceContextState, resultFuncArgs_7: import("../instance-client-tools/instance-client-tools.slice.js").InstanceClientToolsState, resultFuncArgs_8: {
-        [field: string]: unknown;
         organization_id?: string | null;
     } | undefined, resultFuncArgs_9: import("../../../../store/chat-host.slice.js").ChatHostState, resultFuncArgs_10: import("../../../types/agent-definition.types.js").AgentDefinitionSliceState, resultFuncArgs_11: import("../../../../surfaces/redux/userStateSlice.js").SurfaceUserStateSlice, resultFuncArgs_12: import("../messages/messages.slice.js").MessagesState, resultFuncArgs_13: {
-        [field: string]: unknown;
         id: string | null;
         email?: string | null;
         isAnonymous?: boolean;
@@ -430,20 +428,16 @@ export declare function makeSelectAssembledRequest(conversationId: string): ((st
         adminLaneOpen?: boolean;
         adminLevel?: string | null;
     } | undefined, resultFuncArgs_14: {
-        [field: string]: unknown;
         fingerprintId?: string | null;
         userMetadata?: {
             fullName?: string | null;
             name?: string | null;
             preferredUsername?: string | null;
-            [field: string]: unknown;
         } | null;
     } | undefined) => AssembledAgentStartRequest | null;
     memoizedResultFunc: ((resultFuncArgs_0: import("../conversations/conversations.slice.js").ConversationsState, resultFuncArgs_1: import("../instance-ui-state/instance-ui-state.slice.js").InstanceUIStateSlice, resultFuncArgs_2: import("../instance-user-input/instance-user-input.slice.js").InstanceUserInputSliceState, resultFuncArgs_3: import("../instance-resources/instance-resources.slice.js").InstanceResourcesState, resultFuncArgs_4: import("../instance-variable-values/instance-variable-values.slice.js").InstanceVariableValuesState, resultFuncArgs_5: import("../instance-model-overrides/instance-model-overrides.slice.js").InstanceModelOverridesState, resultFuncArgs_6: import("../instance-context/instance-context.slice.js").InstanceContextState, resultFuncArgs_7: import("../instance-client-tools/instance-client-tools.slice.js").InstanceClientToolsState, resultFuncArgs_8: {
-        [field: string]: unknown;
         organization_id?: string | null;
     } | undefined, resultFuncArgs_9: import("../../../../store/chat-host.slice.js").ChatHostState, resultFuncArgs_10: import("../../../types/agent-definition.types.js").AgentDefinitionSliceState, resultFuncArgs_11: import("../../../../surfaces/redux/userStateSlice.js").SurfaceUserStateSlice, resultFuncArgs_12: import("../messages/messages.slice.js").MessagesState, resultFuncArgs_13: {
-        [field: string]: unknown;
         id: string | null;
         email?: string | null;
         isAnonymous?: boolean;
@@ -452,13 +446,11 @@ export declare function makeSelectAssembledRequest(conversationId: string): ((st
         adminLaneOpen?: boolean;
         adminLevel?: string | null;
     } | undefined, resultFuncArgs_14: {
-        [field: string]: unknown;
         fingerprintId?: string | null;
         userMetadata?: {
             fullName?: string | null;
             name?: string | null;
             preferredUsername?: string | null;
-            [field: string]: unknown;
         } | null;
     } | undefined) => AssembledAgentStartRequest | null) & {
         clearCache: () => void;
@@ -467,10 +459,8 @@ export declare function makeSelectAssembledRequest(conversationId: string): ((st
     };
     lastResult: () => AssembledAgentStartRequest | null;
     dependencies: [(s: ChatRootState) => import("../conversations/conversations.slice.js").ConversationsState, (s: ChatRootState) => import("../instance-ui-state/instance-ui-state.slice.js").InstanceUIStateSlice, (s: ChatRootState) => import("../instance-user-input/instance-user-input.slice.js").InstanceUserInputSliceState, (s: ChatRootState) => import("../instance-resources/instance-resources.slice.js").InstanceResourcesState, (s: ChatRootState) => import("../instance-variable-values/instance-variable-values.slice.js").InstanceVariableValuesState, (s: ChatRootState) => import("../instance-model-overrides/instance-model-overrides.slice.js").InstanceModelOverridesState, (s: ChatRootState) => import("../instance-context/instance-context.slice.js").InstanceContextState, (s: ChatRootState) => import("../instance-client-tools/instance-client-tools.slice.js").InstanceClientToolsState, (s: ChatRootState) => {
-        [field: string]: unknown;
         organization_id?: string | null;
     } | undefined, (s: ChatRootState) => import("../../../../store/chat-host.slice.js").ChatHostState, (s: ChatRootState) => import("../../../types/agent-definition.types.js").AgentDefinitionSliceState, (s: ChatRootState) => import("../../../../surfaces/redux/userStateSlice.js").SurfaceUserStateSlice, (s: ChatRootState) => import("../messages/messages.slice.js").MessagesState, (s: ChatRootState) => {
-        [field: string]: unknown;
         id: string | null;
         email?: string | null;
         isAnonymous?: boolean;
@@ -479,13 +469,11 @@ export declare function makeSelectAssembledRequest(conversationId: string): ((st
         adminLaneOpen?: boolean;
         adminLevel?: string | null;
     } | undefined, (s: ChatRootState) => {
-        [field: string]: unknown;
         fingerprintId?: string | null;
         userMetadata?: {
             fullName?: string | null;
             name?: string | null;
             preferredUsername?: string | null;
-            [field: string]: unknown;
         } | null;
     } | undefined];
     recomputations: () => number;

package/dist/agents/redux/execution-system/thunks/run-headless-agent-json.d.ts

@@ -104,9 +104,12 @@ export interface HeadlessAgentJsonOptions {
      *
      * A markdown agent asked for "json" fails with "produced no structured
      * JSON" even though it answered perfectly — which is the whole reason this
-     * option exists rather than a second primitive.
+     * option exists rather than a second primitive. `"media"` — the run's
+     * finished media blocks are the product (an image/audio/video model answers
+     * with a media block, never text); `data` is the array of unified media
+     * blocks (`fileId`, `mimeType`, `width`, `height`, …).
      */
-    expect?: "json" | "text";
+    expect?: "json" | "text" | "media";
     /** Let the extractor fuzzy-parse at finalize. Default true. */
     fuzzyOnFinalize?: boolean;
     /**
@@ -190,6 +193,8 @@ export interface HeadlessAgentJsonOptions {
         noJson?: string;
         /** `expect: "text"` run finished but produced no answer text. */
         noText?: string;
+        /** `expect: "media"` run finished but produced no media. */
+        noMedia?: string;
         /** Ceiling elapsed. */
         timeout?: string;
     };
@@ -302,7 +307,7 @@ export interface AdoptedAgentJsonOptions {
     /** Bounded settle window after a terminal stream state. Default 6s. */
     settleMs?: number;
     /** See `expect` on `HeadlessAgentJsonOptions`. Default "json". */
-    expect?: "json" | "text";
+    expect?: "json" | "text" | "media";
     /**
      * Keep the conversation/instance alive after the run. Default false — the
      * instance is destroyed on settle, matching the launched path. A caller

package/dist/agents/redux/execution-system/thunks/run-headless-agent-json.js

@@ -9,7 +9,8 @@ import {
   selectFirstExtractedObject,
   selectJsonExtractionComplete,
   selectRequestError,
-  selectRequestStatus
+  selectRequestStatus,
+  selectRenderBlocksByType
 } from "../active-requests/active-requests.selectors.js";
 import {
   selectLatestAnswerText,
@@ -47,10 +48,22 @@ const DEFAULT_MESSAGES = {
   streamError: "The agent failed before returning a result.",
   noJson: "The agent finished but produced no structured JSON.",
   noText: "The agent finished but produced no text.",
+  noMedia: "The agent finished but produced no image, audio or video.",
   timeout: "The AI response timed out. If you switched browser tabs during this process, the connection may have been suspended \u2014 keep this tab active and try again."
 };
 const TERMINAL_STATUSES = /* @__PURE__ */ new Set(["complete", "error", "timeout", "cancelled"]);
 const sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+const MEDIA_BLOCK_TYPES = ["image_output", "audio_output", "video_output"];
+function completedMediaOf(getState, requestId) {
+  const state = getState();
+  const out = [];
+  for (const type of MEDIA_BLOCK_TYPES) {
+    for (const block of selectRenderBlocksByType(requestId, type)(state) ?? []) {
+      if (block.status === "complete" && block.data) out.push(block.data);
+    }
+  }
+  return out;
+}
 function screamFlattening(verdict, ctx) {
   console.error(verdict.message);
   captureError({
@@ -99,7 +112,7 @@ async function deliverResult(seam, result) {
   }
 }
 async function failWarnedOutputMissingKeys(getState, opts, result) {
-  if (!opts.mandateKey || (opts.expect ?? "json") === "text") return result;
+  if (!opts.mandateKey || (opts.expect ?? "json") !== "json") return result;
   const mandateKey = opts.mandateKey;
   const data = result.data;
   const isRecord = typeof data === "object" && data !== null && !Array.isArray(data);
@@ -414,7 +427,7 @@ function reportNoResult(getState, args) {
 }
 async function waitForExtraction(dispatch, getState, args) {
   const { conversationId, requestId, msgs } = args;
-  const noResultMsg = args.expect === "text" ? msgs.noText : msgs.noJson;
+  const noResultMsg = args.expect === "text" ? msgs.noText : args.expect === "media" ? msgs.noMedia : msgs.noJson;
   const start = Date.now();
   let terminalAt = null;
   const viewerId = `runHeadlessAgentJson:${args.surfaceKey}:${requestId}`;
@@ -425,6 +438,23 @@ async function waitForExtraction(dispatch, getState, args) {
     fullResponse: selectLatestAnswerText(conversationId)(getState())
   });
   const settle = (reason, message) => {
+    if (args.expect === "media") {
+      const b = base();
+      const media = completedMediaOf(getState, requestId);
+      if (media.length > 0) return { success: true, data: media, ...b };
+      if (reason === "aborted") return { success: false, data: null, error: message, ...b };
+      if (!args.deferNoJsonCapture || reason === "timeout") {
+        reportNoResult(getState, {
+          requestId,
+          conversationId,
+          surfaceKey: args.surfaceKey,
+          agentRef: args.agentRef,
+          reason,
+          message
+        });
+      }
+      return { success: false, data: null, error: message, ...b };
+    }
     if (args.expect === "text") {
       const b = base();
       if (b.fullResponse.trim()) {
@@ -511,6 +541,9 @@ async function waitForExtraction(dispatch, getState, args) {
         return settle("extraction-complete", noResultMsg);
       }
       if (status !== void 0 && TERMINAL_STATUSES.has(status)) {
+        if (args.expect === "media" && completedMediaOf(getState, requestId).length > 0) {
+          return settle("stream-ended", noResultMsg);
+        }
         terminalAt ??= Date.now();
         if (Date.now() - terminalAt > args.settleMs) {
           return settle("stream-ended", noResultMsg);

package/dist/agents/surface-catalog-profile.d.ts

@@ -17,7 +17,7 @@
  *
  * Two target definitions over the same fields is a defect, not a coincidence:
  * the campaign's own precedent is `matrx-user/lists` / `matrx-user/list-manager`,
- * whose shared targets were lifted into `features/user-lists/`. So the CONTRACT
+ * whose shared targets were lifted into `features/data-tables/pick-lists/`. So the CONTRACT
  * — the accepted keys, the per-field bounds, the replace-vs-patch semantics,
  * and the model-facing prose that states them — is defined exactly once, here.
  *

package/dist/host/db-types.d.ts

@@ -26155,6 +26155,88 @@ export type ChatDatabase = {
                 };
                 Returns: boolean;
             };
+            _entity_cursor_decode: {
+                Args: {
+                    p: string;
+                };
+                Returns: Json;
+            };
+            _entity_cursor_encode: {
+                Args: {
+                    p: Json;
+                };
+                Returns: string;
+            };
+            _entity_identifier: {
+                Args: {
+                    p_cols: Json;
+                    p_name: string;
+                };
+                Returns: string;
+            };
+            _entity_org_notice: {
+                Args: {
+                    p_ids: Json;
+                    p_op: string;
+                    p_organization_id: string;
+                    p_token: string;
+                };
+                Returns: undefined;
+            };
+            _entity_refuse: {
+                Args: {
+                    p_code: string;
+                    p_detail?: Json;
+                    p_message: string;
+                };
+                Returns: undefined;
+            };
+            _entity_reraise: {
+                Args: {
+                    p_detail: string;
+                    p_hint: string;
+                    p_message: string;
+                    p_state: string;
+                };
+                Returns: undefined;
+            };
+            _entity_trash_or_restore: {
+                Args: {
+                    p_entity_type: string;
+                    p_ids: string[];
+                    p_trash: boolean;
+                };
+                Returns: Json;
+            };
+            _entity_wire_rows: {
+                Args: {
+                    p_columns: Json;
+                    p_rows: Json;
+                    p_token: string;
+                };
+                Returns: Json;
+            };
+            _entity_write_refusal: {
+                Args: {
+                    p_column?: string;
+                    p_constraint?: string;
+                    p_detail: string;
+                    p_extra?: Json;
+                    p_hint: string;
+                    p_message: string;
+                    p_state: string;
+                };
+                Returns: undefined;
+            };
+            _entity_write_values: {
+                Args: {
+                    p_insert: boolean;
+                    p_org: string;
+                    p_token: string;
+                    p_values: Json;
+                };
+                Returns: Json;
+            };
             _final_switch_is_on: {
                 Args: never;
                 Returns: boolean;
@@ -28042,6 +28124,13 @@ export type ChatDatabase = {
                 };
                 Returns: string;
             };
+            entity_archive: {
+                Args: {
+                    p_entity_type: string;
+                    p_ids: string[];
+                };
+                Returns: Json;
+            };
             entity_columns: {
                 Args: {
                     p_organization_id: string;
@@ -28061,6 +28150,22 @@ export type ChatDatabase = {
                 };
                 Returns: Database["platform"]["Enums"]["visibility"];
             };
+            entity_get: {
+                Args: {
+                    p_entity_type: string;
+                    p_ids: string[];
+                    p_include?: Json;
+                };
+                Returns: Json;
+            };
+            entity_insert: {
+                Args: {
+                    p_entity_type: string;
+                    p_organization_id: string;
+                    p_rows: Json;
+                };
+                Returns: Json;
+            };
             entity_is_org_scoped: {
                 Args: {
                     p_token: string;
@@ -28073,6 +28178,33 @@ export type ChatDatabase = {
                 };
                 Returns: boolean;
             };
+            entity_list_scoped: {
+                Args: {
+                    p_after?: string;
+                    p_archived?: string;
+                    p_deep?: boolean;
+                    p_entity_type: string;
+                    p_favorites_first?: boolean;
+                    p_filter?: Json;
+                    p_include?: Json;
+                    p_page?: number;
+                    p_page_size?: number;
+                    p_scope?: Json;
+                    p_search?: string;
+                    p_search_columns?: string[];
+                    p_search_match?: string;
+                    p_sort?: Json;
+                    p_trash?: boolean;
+                    p_with_total?: boolean;
+                };
+                Returns: Json;
+            };
+            entity_org_topic_admits: {
+                Args: {
+                    p_topic: string;
+                };
+                Returns: boolean;
+            };
             entity_organization_id: {
                 Args: {
                     p_id: string;
@@ -28110,6 +28242,22 @@ export type ChatDatabase = {
                 };
                 Returns: boolean;
             };
+            entity_unarchive: {
+                Args: {
+                    p_entity_type: string;
+                    p_ids: string[];
+                };
+                Returns: Json;
+            };
+            entity_update: {
+                Args: {
+                    p_base_version?: number;
+                    p_entity_type: string;
+                    p_id: string;
+                    p_patch?: Json;
+                };
+                Returns: Json;
+            };
             extensibility_knob: {
                 Args: {
                     p_definition_id?: string;
@@ -31988,7 +32136,7 @@ export type ChatDatabase = {
                     isSetofReturn: true;
                 };
             };
-            _d31_impl_get_user_list_with_items: {
+            _d31_impl_get_pick_list_with_items: {
                 Args: {
                     p_list_id: string;
                 };
@@ -32032,7 +32180,7 @@ export type ChatDatabase = {
                 };
                 Returns: Json;
             };
-            _d31_impl_update_user_list: {
+            _d31_impl_update_pick_list: {
                 Args: {
                     p_authenticated_read?: boolean;
                     p_description?: string;
@@ -38384,7 +38532,7 @@ export type ChatDatabase = {
                 };
                 Returns: Json;
             };
-            get_structured_list_for_selection: {
+            get_pick_list_for_selection: {
                 Args: {
                     p_list_id: string;
                 };
@@ -38541,13 +38689,13 @@ export type ChatDatabase = {
                 };
                 Returns: Json;
             };
-            get_user_list_with_items: {
+            get_pick_list_with_items: {
                 Args: {
                     p_list_id: string;
                 };
                 Returns: Json;
             };
-            get_user_lists_summary: {
+            get_pick_lists_summary: {
                 Args: {
                     p_user_id: string;
                 };
@@ -43772,7 +43920,7 @@ export type ChatDatabase = {
                 };
                 Returns: Json;
             };
-            update_user_list: {
+            update_pick_list: {
                 Args: {
                     p_authenticated_read?: boolean;
                     p_description?: string;

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

@@ -285,7 +285,7 @@ export interface ChatUiSlots {
     };
     useAutoLabel: AnyFn;
     generateLabelFromContent: AnyFn;
-    useStructuredListForSelection: (listId: string | null | undefined, groupName?: string) => {
+    usePickListForSelection: (listId: string | null | undefined, groupName?: string) => {
         items: PicklistItem[];
         groups: unknown[];
         loading: boolean;
@@ -688,7 +688,7 @@ export declare const useSkills: () => {
 };
 export declare const useAutoLabel: AnyFn;
 export declare const generateLabelFromContent: AnyFn;
-export declare const useStructuredListForSelection: (listId: string | null | undefined, groupName?: string) => {
+export declare const usePickListForSelection: (listId: string | null | undefined, groupName?: string) => {
     items: PicklistItem[];
     groups: unknown[];
     loading: boolean;

package/dist/host/ui-slots.js

@@ -167,7 +167,7 @@ const STAND_INS = {
   beginPlaybackSession: () => ({ id: "", update: () => void 0, end: () => void 0 }),
   useCanvasOpenGuard: () => ({ ensureCanvasReachable: async () => true }),
   useSkills: () => ({ skills: NONE, grouped: {}, count: 0, loading: false, error: null, reload: async () => void 0 }),
-  useStructuredListForSelection: () => ({ items: NONE, groups: NONE, loading: false, unavailable: true, error: null, retry: () => void 0 }),
+  usePickListForSelection: () => ({ items: NONE, groups: NONE, loading: false, unavailable: true, error: null, retry: () => void 0 }),
   useOutputFeedback: () => ({ verdict: null, isLoaded: true })
 };
 function slotFn(name, declared) {
@@ -408,7 +408,7 @@ const useRegisterChatAttachTarget = slotFn("useRegisterChatAttachTarget", () =>
 const useSkills = slotFn("useSkills");
 const useAutoLabel = slotFn("useAutoLabel", () => void 0);
 const generateLabelFromContent = slotFn("generateLabelFromContent");
-const useStructuredListForSelection = slotFn("useStructuredListForSelection");
+const usePickListForSelection = slotFn("usePickListForSelection");
 const useGitHubConnection = slotFn("useGitHubConnection");
 const useOutputFeedback = slotFn("useOutputFeedback");
 const saveOutputFeedback = slotFn("saveOutputFeedback");
@@ -789,12 +789,12 @@ export {
   useOverlaySurfaceRenderAck,
   usePageCapture,
   usePageCaptureContribution,
+  usePickListForSelection,
   usePopoutContainer,
   useRecordAndTranscribe,
   useRegisterChatAttachTarget,
   useRunControlCounts,
   useSkills,
-  useStructuredListForSelection,
   useTablesEverywhere,
   useTextareaFormatting,
   useUrlSync,

package/dist/host/window-openers.d.ts

@@ -145,7 +145,7 @@ export interface OpenScraperWindowOptions {
     url?: string;
     mode?: ScraperWindowMode;
 }
-export interface OpenStructuredListManagerV2WindowOptions {
+export interface OpenPickListManagerWindowOptions {
     title?: string;
     forcedListId?: string | null;
 }
@@ -297,7 +297,7 @@ export interface ChatWindowOpeners {
     openSaveTemplateDialog: (opts?: OpenSaveTemplateDialogOptions) => void;
     openScraperWindow: (opts?: OpenScraperWindowOptions) => ChatWindowHandle;
     openScratchpadPanel: (opts?: OpenScratchpadPanelOptions) => ChatWindowHandle;
-    openStructuredListManagerV2Window: (opts?: OpenStructuredListManagerV2WindowOptions) => ChatWindowHandle;
+    openPickListManagerWindow: (opts?: OpenPickListManagerWindowOptions) => ChatWindowHandle;
     openSurfaceContextInspector: (opts: OpenSurfaceContextInspectorOptions) => ChatWindowHandle;
     openSurfaceContextWindow: (opts: OpenSurfaceContextWindowOptions) => void;
     openSystemInstructionWindow: (opts: OpenSystemInstructionWindowOptions) => ChatWindowHandle;
@@ -352,7 +352,7 @@ export declare function useOpenQuickChatSheet(): (opts?: OpenQuickChatSheetOptio
 export declare function useOpenRunControlsWindow(): (opts: OpenRunControlsWindowOptions) => ChatWindowHandle;
 export declare function useOpenSaveTemplateDialog(): (opts?: OpenSaveTemplateDialogOptions) => void;
 export declare function useOpenScraperWindow(): (opts?: OpenScraperWindowOptions) => ChatWindowHandle;
-export declare function useOpenStructuredListManagerV2Window(): (opts?: OpenStructuredListManagerV2WindowOptions) => ChatWindowHandle;
+export declare function useOpenPickListManagerWindow(): (opts?: OpenPickListManagerWindowOptions) => ChatWindowHandle;
 export declare function useOpenSurfaceContextInspector(): (opts: OpenSurfaceContextInspectorOptions) => ChatWindowHandle;
 export declare function useOpenSurfaceContextWindow(): (opts: OpenSurfaceContextWindowOptions) => void;
 export declare function useOpenSystemInstructionWindow(): (opts: OpenSystemInstructionWindowOptions) => ChatWindowHandle;

package/dist/host/window-openers.js

@@ -52,7 +52,7 @@ const UNHOSTED_WINDOW_OPENERS = {
   openSaveTemplateDialog: unhosted("openSaveTemplateDialog"),
   openScraperWindow: unhosted("openScraperWindow"),
   openScratchpadPanel: unhosted("openScratchpadPanel"),
-  openStructuredListManagerV2Window: unhosted("openStructuredListManagerV2Window"),
+  openPickListManagerWindow: unhosted("openPickListManagerWindow"),
   openSurfaceContextInspector: unhosted("openSurfaceContextInspector"),
   openSurfaceContextWindow: unhosted("openSurfaceContextWindow"),
   openSystemInstructionWindow: unhosted("openSystemInstructionWindow"),
@@ -206,8 +206,8 @@ function useOpenSaveTemplateDialog() {
 function useOpenScraperWindow() {
   return useOpener("openScraperWindow");
 }
-function useOpenStructuredListManagerV2Window() {
-  return useOpener("openStructuredListManagerV2Window");
+function useOpenPickListManagerWindow() {
+  return useOpener("openPickListManagerWindow");
 }
 function useOpenSurfaceContextInspector() {
   return useOpener("openSurfaceContextInspector");
@@ -261,6 +261,7 @@ export {
   useOpenLiveRunWindow,
   useOpenMandateWindow,
   useOpenNotesWindow,
+  useOpenPickListManagerWindow,
   useOpenPromptPreviewWindow,
   useOpenQuickChatSheet,
   useOpenRunControlsWindow,
@@ -268,7 +269,6 @@ export {
   useOpenScraperWindow,
   useOpenScratchpadPanel,
   useOpenShortcutEditorWindow,
-  useOpenStructuredListManagerV2Window,
   useOpenSurfaceContextInspector,
   useOpenSurfaceContextWindow,
   useOpenSystemInstructionWindow,

package/dist/store/hooks.d.ts

@@ -6,138 +6,6 @@ export declare const useChatSelector: UseSelector<ChatRootState>;
 export declare const useChatDispatch: UseDispatch<ChatDispatch>;
 /** The chat store itself (for `getState()` inside callbacks). */
 export declare const useChatStore: UseStore<ChatAppStore>;
-export declare const useAppSelector: UseSelector<{
-    voiceAgent: import("../voice-agent/types.js").VoiceAgentState;
-    agentDefinition: import("../agents/types/agent-definition.types.js").AgentDefinitionSliceState;
-    conversationList: import("../agents/redux/conversation-list/conversation-list.types.js").ConversationListState;
-    conversationHistory: import("../agents/redux/conversation-history/index.js").ConversationHistoryState;
-    agentShortcut: import("../agents/redux/agent-shortcuts/types.js").AgentShortcutSliceState;
-    agentShortcutCategory: import("../agents/redux/agent-shortcut-categories/types.js").AgentShortcutCategorySliceState;
-    surfaceUserState: import("../surfaces/redux/userStateSlice.js").SurfaceUserStateSlice;
-    tools: import("../agents/redux/tools/tools.slice.js").ToolsSliceState;
-    conversations: import("../agents/redux/execution-system/conversations/conversations.slice.js").ConversationsState;
-    chatIncognito: import("../agents/redux/chat/chat-incognito.slice.js").ChatIncognitoState;
-    chatRoute: import("../agents/redux/chat/chat-route.slice.js").ChatRouteState;
-    instanceModelOverrides: import("../agents/redux/execution-system/instance-model-overrides/instance-model-overrides.slice.js").InstanceModelOverridesState;
-    instanceInputCapabilities: import("../agents/redux/execution-system/instance-input-capabilities/instance-input-capabilities.slice.js").InstanceInputCapabilitiesState;
-    instanceVariableValues: import("../agents/redux/execution-system/instance-variable-values/instance-variable-values.slice.js").InstanceVariableValuesState;
-    instanceResources: import("../agents/redux/execution-system/instance-resources/instance-resources.slice.js").InstanceResourcesState;
-    instanceContext: import("../agents/redux/execution-system/instance-context/instance-context.slice.js").InstanceContextState;
-    instanceWorkingDocument: import("../agents/redux/execution-system/instance-working-document/instance-working-document.slice.js").InstanceWorkingDocumentSliceState;
-    instanceUserInput: import("../agents/redux/execution-system/instance-user-input/instance-user-input.slice.js").InstanceUserInputSliceState;
-    instanceClientTools: import("../agents/redux/execution-system/instance-client-tools/instance-client-tools.slice.js").InstanceClientToolsState;
-    pendingAsks: import("../agents/ui-first-tools/redux/pending-asks.slice.js").PendingAsksState;
-    conversationInbox: import("../agents/redux/execution-system/inbox/inbox.slice.js").ConversationInboxState;
-    agentLists: import("../agents/ui-first-tools/redux/agent-lists.slice.js").AgentListsState;
-    instanceUIState: import("../agents/redux/execution-system/instance-ui-state/instance-ui-state.slice.js").InstanceUIStateSlice;
-    activeTools: import("../agents/redux/execution-system/active-tools/active-tools.slice.js").ActiveToolsState;
-    activeRequests: import("../agents/redux/execution-system/active-requests/active-requests.slice.js").ActiveRequestsState;
-    runSets: import("../agents/redux/execution-system/run-sets/run-sets.slice.js").RunSetsState;
-    messages: import("../agents/redux/execution-system/messages/messages.slice.js").MessagesState;
-    observability: import("../agents/redux/execution-system/observability/observability.slice.js").ObservabilityState;
-    contextState: import("../agents/redux/execution-system/context-state/context-state.slice.js").ContextStateSliceState;
-    observationalMemory: import("../agents/redux/execution-system/observational-memory/observational-memory.slice.js").ObservationalMemoryState;
-    cacheBypass: import("../agents/redux/execution-system/message-crud/cache-bypass.slice.js").CacheBypassState;
-    conversationFocus: import("../agents/redux/execution-system/conversation-focus/conversation-focus.slice.js").ConversationFocusState;
-    surfaces: import("../agents/redux/surfaces/surfaces.slice.js").SurfacesState;
-    surfacesCatalog: import("../surfaces/redux/surfacesCatalogSlice.js").SurfacesCatalogSliceState;
-    agentSurfaceBindings: import("../surfaces/redux/agentSurfaceBindingsSlice.js").AgentSurfaceBindingsSliceState;
-    surfaceConfig: import("../surfaces/redux/surfaceConfigSlice.js").SurfaceConfigSliceState;
-    agentAssistantMarkdownDraft: import("../agents/redux/agent-assistant-markdown-draft.slice.js").AgentAssistantMarkdownDraftState;
-    mcp: import("../agents/redux/mcp/mcp.slice.js").McpSliceState;
-    proposedDirectives: import("../agents/redux/proposed-directives/proposedDirectivesSlice.js").ProposedDirectivesState;
-    agentSettings: import("../agents/redux/agent-settings/types.js").AgentSettingsState;
-    conversationAttachments: import("../agents/connectors/attachments.slice.js").AttachmentsSliceState;
-    modelRegistry: import("../agents/model-registry/modelRegistrySlice.js").ModelRegistryState;
-    chatHost: import("./chat-host.slice.js").ChatHostState;
-} & import("./root-state.js").ChatHostReadSlices>;
-export declare const useAppDispatch: UseDispatch<import("redux-thunk").ThunkDispatch<{
-    voiceAgent: import("../voice-agent/types.js").VoiceAgentState;
-    agentDefinition: import("../agents/types/agent-definition.types.js").AgentDefinitionSliceState;
-    conversationList: import("../agents/redux/conversation-list/conversation-list.types.js").ConversationListState;
-    conversationHistory: import("../agents/redux/conversation-history/index.js").ConversationHistoryState;
-    agentShortcut: import("../agents/redux/agent-shortcuts/types.js").AgentShortcutSliceState;
-    agentShortcutCategory: import("../agents/redux/agent-shortcut-categories/types.js").AgentShortcutCategorySliceState;
-    surfaceUserState: import("../surfaces/redux/userStateSlice.js").SurfaceUserStateSlice;
-    tools: import("../agents/redux/tools/tools.slice.js").ToolsSliceState;
-    conversations: import("../agents/redux/execution-system/conversations/conversations.slice.js").ConversationsState;
-    chatIncognito: import("../agents/redux/chat/chat-incognito.slice.js").ChatIncognitoState;
-    chatRoute: import("../agents/redux/chat/chat-route.slice.js").ChatRouteState;
-    instanceModelOverrides: import("../agents/redux/execution-system/instance-model-overrides/instance-model-overrides.slice.js").InstanceModelOverridesState;
-    instanceInputCapabilities: import("../agents/redux/execution-system/instance-input-capabilities/instance-input-capabilities.slice.js").InstanceInputCapabilitiesState;
-    instanceVariableValues: import("../agents/redux/execution-system/instance-variable-values/instance-variable-values.slice.js").InstanceVariableValuesState;
-    instanceResources: import("../agents/redux/execution-system/instance-resources/instance-resources.slice.js").InstanceResourcesState;
-    instanceContext: import("../agents/redux/execution-system/instance-context/instance-context.slice.js").InstanceContextState;
-    instanceWorkingDocument: import("../agents/redux/execution-system/instance-working-document/instance-working-document.slice.js").InstanceWorkingDocumentSliceState;
-    instanceUserInput: import("../agents/redux/execution-system/instance-user-input/instance-user-input.slice.js").InstanceUserInputSliceState;
-    instanceClientTools: import("../agents/redux/execution-system/instance-client-tools/instance-client-tools.slice.js").InstanceClientToolsState;
-    pendingAsks: import("../agents/ui-first-tools/redux/pending-asks.slice.js").PendingAsksState;
-    conversationInbox: import("../agents/redux/execution-system/inbox/inbox.slice.js").ConversationInboxState;
-    agentLists: import("../agents/ui-first-tools/redux/agent-lists.slice.js").AgentListsState;
-    instanceUIState: import("../agents/redux/execution-system/instance-ui-state/instance-ui-state.slice.js").InstanceUIStateSlice;
-    activeTools: import("../agents/redux/execution-system/active-tools/active-tools.slice.js").ActiveToolsState;
-    activeRequests: import("../agents/redux/execution-system/active-requests/active-requests.slice.js").ActiveRequestsState;
-    runSets: import("../agents/redux/execution-system/run-sets/run-sets.slice.js").RunSetsState;
-    messages: import("../agents/redux/execution-system/messages/messages.slice.js").MessagesState;
-    observability: import("../agents/redux/execution-system/observability/observability.slice.js").ObservabilityState;
-    contextState: import("../agents/redux/execution-system/context-state/context-state.slice.js").ContextStateSliceState;
-    observationalMemory: import("../agents/redux/execution-system/observational-memory/observational-memory.slice.js").ObservationalMemoryState;
-    cacheBypass: import("../agents/redux/execution-system/message-crud/cache-bypass.slice.js").CacheBypassState;
-    conversationFocus: import("../agents/redux/execution-system/conversation-focus/conversation-focus.slice.js").ConversationFocusState;
-    surfaces: import("../agents/redux/surfaces/surfaces.slice.js").SurfacesState;
-    surfacesCatalog: import("../surfaces/redux/surfacesCatalogSlice.js").SurfacesCatalogSliceState;
-    agentSurfaceBindings: import("../surfaces/redux/agentSurfaceBindingsSlice.js").AgentSurfaceBindingsSliceState;
-    surfaceConfig: import("../surfaces/redux/surfaceConfigSlice.js").SurfaceConfigSliceState;
-    agentAssistantMarkdownDraft: import("../agents/redux/agent-assistant-markdown-draft.slice.js").AgentAssistantMarkdownDraftState;
-    mcp: import("../agents/redux/mcp/mcp.slice.js").McpSliceState;
-    proposedDirectives: import("../agents/redux/proposed-directives/proposedDirectivesSlice.js").ProposedDirectivesState;
-    agentSettings: import("../agents/redux/agent-settings/types.js").AgentSettingsState;
-    conversationAttachments: import("../agents/connectors/attachments.slice.js").AttachmentsSliceState;
-    modelRegistry: import("../agents/model-registry/modelRegistrySlice.js").ModelRegistryState;
-    chatHost: import("./chat-host.slice.js").ChatHostState;
-} & import("./root-state.js").ChatHostReadSlices, unknown, import("redux").UnknownAction> & import("redux").Dispatch<import("redux").UnknownAction>>;
-export declare const useAppStore: UseStore<import("redux").Store<{
-    voiceAgent: import("../voice-agent/types.js").VoiceAgentState;
-    agentDefinition: import("../agents/types/agent-definition.types.js").AgentDefinitionSliceState;
-    conversationList: import("../agents/redux/conversation-list/conversation-list.types.js").ConversationListState;
-    conversationHistory: import("../agents/redux/conversation-history/index.js").ConversationHistoryState;
-    agentShortcut: import("../agents/redux/agent-shortcuts/types.js").AgentShortcutSliceState;
-    agentShortcutCategory: import("../agents/redux/agent-shortcut-categories/types.js").AgentShortcutCategorySliceState;
-    surfaceUserState: import("../surfaces/redux/userStateSlice.js").SurfaceUserStateSlice;
-    tools: import("../agents/redux/tools/tools.slice.js").ToolsSliceState;
-    conversations: import("../agents/redux/execution-system/conversations/conversations.slice.js").ConversationsState;
-    chatIncognito: import("../agents/redux/chat/chat-incognito.slice.js").ChatIncognitoState;
-    chatRoute: import("../agents/redux/chat/chat-route.slice.js").ChatRouteState;
-    instanceModelOverrides: import("../agents/redux/execution-system/instance-model-overrides/instance-model-overrides.slice.js").InstanceModelOverridesState;
-    instanceInputCapabilities: import("../agents/redux/execution-system/instance-input-capabilities/instance-input-capabilities.slice.js").InstanceInputCapabilitiesState;
-    instanceVariableValues: import("../agents/redux/execution-system/instance-variable-values/instance-variable-values.slice.js").InstanceVariableValuesState;
-    instanceResources: import("../agents/redux/execution-system/instance-resources/instance-resources.slice.js").InstanceResourcesState;
-    instanceContext: import("../agents/redux/execution-system/instance-context/instance-context.slice.js").InstanceContextState;
-    instanceWorkingDocument: import("../agents/redux/execution-system/instance-working-document/instance-working-document.slice.js").InstanceWorkingDocumentSliceState;
-    instanceUserInput: import("../agents/redux/execution-system/instance-user-input/instance-user-input.slice.js").InstanceUserInputSliceState;
-    instanceClientTools: import("../agents/redux/execution-system/instance-client-tools/instance-client-tools.slice.js").InstanceClientToolsState;
-    pendingAsks: import("../agents/ui-first-tools/redux/pending-asks.slice.js").PendingAsksState;
-    conversationInbox: import("../agents/redux/execution-system/inbox/inbox.slice.js").ConversationInboxState;
-    agentLists: import("../agents/ui-first-tools/redux/agent-lists.slice.js").AgentListsState;
-    instanceUIState: import("../agents/redux/execution-system/instance-ui-state/instance-ui-state.slice.js").InstanceUIStateSlice;
-    activeTools: import("../agents/redux/execution-system/active-tools/active-tools.slice.js").ActiveToolsState;
-    activeRequests: import("../agents/redux/execution-system/active-requests/active-requests.slice.js").ActiveRequestsState;
-    runSets: import("../agents/redux/execution-system/run-sets/run-sets.slice.js").RunSetsState;
-    messages: import("../agents/redux/execution-system/messages/messages.slice.js").MessagesState;
-    observability: import("../agents/redux/execution-system/observability/observability.slice.js").ObservabilityState;
-    contextState: import("../agents/redux/execution-system/context-state/context-state.slice.js").ContextStateSliceState;
-    observationalMemory: import("../agents/redux/execution-system/observational-memory/observational-memory.slice.js").ObservationalMemoryState;
-    cacheBypass: import("../agents/redux/execution-system/message-crud/cache-bypass.slice.js").CacheBypassState;
-    conversationFocus: import("../agents/redux/execution-system/conversation-focus/conversation-focus.slice.js").ConversationFocusState;
-    surfaces: import("../agents/redux/surfaces/surfaces.slice.js").SurfacesState;
-    surfacesCatalog: import("../surfaces/redux/surfacesCatalogSlice.js").SurfacesCatalogSliceState;
-    agentSurfaceBindings: import("../surfaces/redux/agentSurfaceBindingsSlice.js").AgentSurfaceBindingsSliceState;
-    surfaceConfig: import("../surfaces/redux/surfaceConfigSlice.js").SurfaceConfigSliceState;
-    agentAssistantMarkdownDraft: import("../agents/redux/agent-assistant-markdown-draft.slice.js").AgentAssistantMarkdownDraftState;
-    mcp: import("../agents/redux/mcp/mcp.slice.js").McpSliceState;
-    proposedDirectives: import("../agents/redux/proposed-directives/proposedDirectivesSlice.js").ProposedDirectivesState;
-    agentSettings: import("../agents/redux/agent-settings/types.js").AgentSettingsState;
-    conversationAttachments: import("../agents/connectors/attachments.slice.js").AttachmentsSliceState;
-    modelRegistry: import("../agents/model-registry/modelRegistrySlice.js").ModelRegistryState;
-    chatHost: import("./chat-host.slice.js").ChatHostState;
-} & import("./root-state.js").ChatHostReadSlices, import("redux").UnknownAction, unknown>>;
+export declare const useAppSelector: UseSelector<ChatRootState>;
+export declare const useAppDispatch: UseDispatch<ChatDispatch>;
+export declare const useAppStore: UseStore<ChatAppStore>;

package/dist/store/root-state.d.ts

@@ -6,7 +6,8 @@ export interface ChatStoreRegister {
 /**
  * Slices the HOST owns that package code reads when present (§2.3). A private store has none of
  * them, so every read is optional; a registered host store supplies the real shapes. Only the
- * fields the package reads are named — anything else stays `unknown`.
+ * fields the package reads are named, with no index signatures, so a host's concrete slice
+ * interfaces (which carry extra fields) stay assignable.
  */
 export interface ChatHostReadSlices {
     userAuth?: {
@@ -17,11 +18,9 @@ export interface ChatHostReadSlices {
         isAdmin?: boolean;
         adminLaneOpen?: boolean;
         adminLevel?: string | null;
-        [field: string]: unknown;
     };
     appContext?: {
         organization_id?: string | null;
-        [field: string]: unknown;
     };
     userProfile?: {
         fingerprintId?: string | null;
@@ -29,16 +28,12 @@ export interface ChatHostReadSlices {
             fullName?: string | null;
             name?: string | null;
             preferredUsername?: string | null;
-            [field: string]: unknown;
         } | null;
-        [field: string]: unknown;
     };
     cloudFiles?: {
         filesById: Record<string, {
             fileName?: string | null;
-            [field: string]: unknown;
         } | undefined>;
-        [field: string]: unknown;
     };
     transcriptStudio?: {
         byId?: Record<string, {
@@ -46,16 +41,12 @@ export interface ChatHostReadSlices {
             assistantConversationId?: string | null;
             assistantConversations?: readonly {
                 conversationId: string;
-                [field: string]: unknown;
             }[];
-            [field: string]: unknown;
         } | undefined>;
         documentsById?: Record<string, Record<string, {
             id?: string;
             content?: string | null;
-            [field: string]: unknown;
         } | undefined> | undefined>;
-        [field: string]: unknown;
     };
 }
 /** The full store state the package runs in: the host's when registered, else `ChatState` + optional host reads. */

package/dist/surfaces/utils/route-to-surface.js

@@ -95,7 +95,7 @@ const SURFACE_ROUTE_MAPPINGS = [
   { prefix: "/work", surface: "matrx-user/ai-work" },
   { prefix: "/files", surface: "matrx-user/files" },
   { prefix: "/projects", surface: "matrx-user/projects" },
-  { prefix: "/lists", surface: "matrx-user/lists" },
+  { prefix: "/pick-lists", surface: "matrx-user/lists" },
   { prefix: "/tools/pdf-extractor", surface: "matrx-user/pdf-extractor" },
   { prefix: "/tools/scanner", surface: "matrx-user/scanner" },
   { prefix: "/documents", surface: "matrx-user/documents" },

package/dist/tool-call-visualization/effects/toolStateEffects.d.ts

@@ -26,7 +26,7 @@
  * ADDING AN ENTITY: one entry in `TOOL_STATE_EFFECTS` — tool names + a `run`
  * that dispatches the feature's refetch thunk(s). Known not-yet-covered
  * writers (no canonical Redux refetch today, or their state is hook-local):
- * picklist (session-cached `usePicklistDetail`), dictionary, workbook,
+ * picklist (session-cached `usePickListDetail`), dictionary, workbook,
  * dataset/usertable, document. The working document is already reconciled by
  * its own `context_changed` re-read; the scratchpad is agent-readonly.
  */

package/dist/tool-call-visualization/registry/registry.js

@@ -4,7 +4,6 @@ import {
   CheckCircle,
   FileSearch,
   ListChecks,
-  List,
   SquareCheckBig,
   ListTodo,
   FileText,
@@ -1061,14 +1060,13 @@ const APP_FEATURE_TOOL_NAMES = /* @__PURE__ */ new Set([
   "seo_check_meta_descriptions",
   "seo_get_keyword_data",
   "topical_map",
-  "picklist",
+  "pick_list",
   "task",
   "tasks",
   "user_todos",
   "document",
   "dataset",
   "usertable_create",
-  "get_user_lists",
   "knowledge_search",
   "document_search",
   "knowledge_browse",
@@ -1165,14 +1163,13 @@ const RESULT_IS_PURPOSE_TOOLS = /* @__PURE__ */ new Set([
   // the inventory / passage / store / entity map IS the answer
   "document_content",
   // the fetched pages/text ARE the answer
-  "get_user_lists",
   "seo",
   // the analyzed SERP previews / keyword table ARE the deliverable
   "seo_check_meta_tags_batch",
   "seo_check_meta_titles",
   "seo_check_meta_descriptions",
   "seo_get_keyword_data",
-  "picklist",
+  "pick_list",
   // the created/loaded list is the deliverable
   "document",
   "dataset",
@@ -1198,8 +1195,7 @@ function getToolDisplayMode(toolName, entry) {
 }
 const TOOL_GLYPHS = {
   // entity tools
-  picklist: { icon: ListChecks, accent: "violet" },
-  get_user_lists: { icon: List, accent: "violet" },
+  pick_list: { icon: ListChecks, accent: "violet" },
   task: { icon: SquareCheckBig, accent: "blue" },
   tasks: { icon: ListTodo, accent: "blue" },
   user_todos: { icon: ListTodo, accent: "blue" },

package/package.json

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