@ai-matrx/chat 0.2.4 → 0.2.5

package/CHANGELOG.md

@@ -1,5 +1,16 @@
 # @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

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/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/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.4",
+  "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",
@@ -201,23 +201,23 @@
     "server-only": "^0.0.1",
     "uuid": "^14.0.2",
     "zod": "^4.6.5",
-    "@ai-matrx/agents": "latest",
     "@ai-matrx/alchemy": "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/data": "latest",
-    "@ai-matrx/design-system": "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/diff": "latest",
-    "@ai-matrx/records-ui": "latest",
     "@ai-matrx/records": "latest",
+    "@ai-matrx/records-ui": "latest",
     "@ai-matrx/tap-target": "latest"
   },
   "devDependencies": {