@ai-matrx/chat 0.2.4 → 0.2.7

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/hooks/useAgentDuplicateFlow.d.ts

@@ -1,12 +1,22 @@
 interface UseAgentDuplicateFlowOptions {
     basePath?: string;
+    /** Sub-route the copy opens on when the source is not the current page. */
+    fallbackSuffix?: string;
+}
+export interface StartDuplicateOptions {
+    /** Copy this saved version (definition_version id). Omitted = the current agent. */
+    versionId?: string;
 }
 /**
- * Shared duplicate flow for agent surfaces (options menu, read-only builder save,
- * floating "create my copy" chip). Returns a trigger + the outcome dialog element.
+ * Shared duplicate flow for agent surfaces (options menu, versions tab,
+ * read-only builder save, floating "create my copy" chip). Returns triggers +
+ * the one dialog element:
+ *   - `startDuplicate()` copies right away (current agent, or `{ versionId }`).
+ *   - `openChooser()` first asks which version to copy, defaulting to current.
  */
 export declare function useAgentDuplicateFlow(agentId: string, options?: UseAgentDuplicateFlowOptions): {
-    readonly startDuplicate: () => Promise<void>;
+    readonly startDuplicate: (opts?: StartDuplicateOptions) => Promise<void>;
+    readonly openChooser: () => Promise<void>;
     readonly dialog: import("react").JSX.Element;
     readonly isDuplicating: boolean;
     /** False in a host that registered no builder door: nothing offers a duplicate (reported once). */

package/dist/agents/hooks/useAgentDuplicateFlow.js

@@ -5,8 +5,10 @@ import { usePathname } from "../../host/navigation.js";
 import { useAppDispatch, useAppSelector } from "../../store/hooks.js";
 import { selectAgentById } from "../redux/agent-definition/selectors.js";
 import { getBuilderDoor, requireBuilderDoor } from "../../host/builder-door.js";
+import { supabase } from "../../host/db.js";
 import {
-  AgentDuplicateOutcomeDialog
+  AgentDuplicateOutcomeDialog,
+  CURRENT_VERSION_CHOICE
 } from "../components/shared/AgentDuplicateOutcomeDialog.js";
 import { isAdminSystemAgentsContext } from "../components/shared/agent-route-context.js";
 import { getUserMessage } from "@ai-matrx/agents/matrx";
@@ -15,56 +17,111 @@ function useAgentDuplicateFlow(agentId, options) {
   const dispatch = useAppDispatch();
   const pathname = usePathname();
   const basePath = options?.basePath ?? "/agents";
+  const fallbackSuffix = options?.fallbackSuffix ?? "/build";
   const agent = useAppSelector((state2) => selectAgentById(state2, agentId));
   const [open, setOpen] = useState(false);
   const [state, setState] = useState("loading");
   const [newAgentId, setNewAgentId] = useState(null);
   const [errorMessage, setErrorMessage] = useState("");
   const [asSystem, setAsSystem] = useState(false);
+  const [versions, setVersions] = useState([]);
+  const [versionsLoading, setVersionsLoading] = useState(false);
+  const [versionsError, setVersionsError] = useState(null);
+  const [selected, setSelected] = useState(CURRENT_VERSION_CHOICE);
+  const newAgent = useAppSelector(
+    (s) => newAgentId ? selectAgentById(s, newAgentId) : void 0
+  );
   const isAdminContext = isAdminSystemAgentsContext(basePath);
   const isBuiltin = agent?.agentType === "builtin";
-  const newAgentName = agent?.name ? `Copy of ${agent.name}` : "";
   const newAgentPath = newAgentId ? (() => {
     const sourceSegment = `${basePath}/${agentId}`;
-    const suffix = pathname && pathname.startsWith(sourceSegment) ? pathname.slice(sourceSegment.length) : "/build";
-    return `${basePath}/${newAgentId}${suffix || "/build"}`;
+    const here = pathname && pathname.startsWith(sourceSegment) ? pathname.slice(sourceSegment.length) : fallbackSuffix;
+    const suffix = /^\/v(\/|$)/.test(here) ? fallbackSuffix : here;
+    return `${basePath}/${newAgentId}${suffix || fallbackSuffix}`;
   })() : null;
-  const startDuplicate = useCallback(async () => {
-    const duplicateAsSystem = isAdminContext && isBuiltin;
-    setAsSystem(duplicateAsSystem);
+  const startDuplicate = useCallback(
+    async (opts) => {
+      const duplicateAsSystem = isAdminContext && isBuiltin;
+      setAsSystem(duplicateAsSystem);
+      setNewAgentId(null);
+      setErrorMessage("");
+      setState("loading");
+      setOpen(true);
+      try {
+        const id = await dispatch(
+          requireBuilderDoor().duplicateAgent({
+            agentId,
+            asSystem: duplicateAsSystem,
+            versionId: opts?.versionId
+          })
+        ).unwrap();
+        setNewAgentId(id);
+        setState("success");
+      } catch (err) {
+        if (isOrganizationSelectionCancelled(err)) {
+          setOpen(false);
+          return;
+        }
+        setErrorMessage(getUserMessage(err));
+        setState("error");
+      }
+    },
+    [agentId, dispatch, isAdminContext, isBuiltin]
+  );
+  const openChooser = useCallback(async () => {
+    setSelected(CURRENT_VERSION_CHOICE);
     setNewAgentId(null);
     setErrorMessage("");
-    setState("loading");
+    setState("choose");
     setOpen(true);
-    try {
-      const id = await dispatch(
-        requireBuilderDoor().duplicateAgent({ agentId, asSystem: duplicateAsSystem })
-      ).unwrap();
-      setNewAgentId(id);
-      setState("success");
-    } catch (err) {
-      if (isOrganizationSelectionCancelled(err)) {
-        setOpen(false);
-        return;
-      }
-      setErrorMessage(getUserMessage(err));
-      setState("error");
+    setVersionsLoading(true);
+    setVersionsError(null);
+    const { data, error } = await supabase.rpc("agx_get_version_history", {
+      p_agent_id: agentId,
+      p_limit: 500,
+      p_offset: 0
+    });
+    setVersionsLoading(false);
+    if (error) {
+      setVersions([]);
+      setVersionsError(error.message);
+      return;
     }
-  }, [agentId, dispatch, isAdminContext, isBuiltin]);
+    setVersions(
+      (data ?? []).map((row) => ({
+        versionId: row.version_id,
+        versionNumber: row.version_number,
+        changedAt: row.changed_at,
+        changeNote: row.change_note ?? null
+      }))
+    );
+  }, [agentId]);
   const dialog = /* @__PURE__ */ jsx(
     AgentDuplicateOutcomeDialog,
     {
       open,
       onOpenChange: setOpen,
       state,
-      newAgentName,
+      newAgentName: newAgent?.name ?? "",
       newAgentPath,
       errorMessage,
-      asSystem
+      asSystem,
+      chooser: {
+        currentVersion: agent?.version ?? null,
+        versions,
+        versionsLoading,
+        versionsError,
+        selected,
+        onSelectedChange: setSelected,
+        onConfirm: () => void startDuplicate(
+          selected === CURRENT_VERSION_CHOICE ? void 0 : { versionId: selected }
+        )
+      }
     }
   );
   return {
     startDuplicate,
+    openChooser,
     dialog,
     isDuplicating: open && state === "loading",
     /** False in a host that registered no builder door: nothing offers a duplicate (reported once). */

package/dist/agents/hooks/useWidgetHandle.js

@@ -38,7 +38,7 @@ function useWidgetHandle(handle) {
     idRef.current = callbackManager.registerWidgetHandle(
       makeStableHandle(handleRef)
     );
-    if (true) {
+    if (process.env.NODE_ENV !== "production") {
       const methodCount = [
         ...Object.values(WIDGET_TOOL_NAME_TO_HANDLE_METHOD),
         ...LIFECYCLE_KEYS

package/dist/agents/prompt-preview/PromptPreviewContent.js

@@ -1,5 +1,7 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { useClipboard } from "@ai-matrx/kit/clipboard";
+import { toast as copyToast } from "../../host/notify.js";
 import { useEffect, useState } from "react";
 import { Loader2, Copy, RefreshCw, AlertTriangle } from "lucide-react";
 import { Button } from "@ai-matrx/design-system/controls";
@@ -10,6 +12,9 @@ import { ErrorAlchemyMenu } from "../../host/ui-slots.js";
 function PromptPreviewContent({
   conversationId
 }) {
+  const { copyText } = useClipboard({
+    notify: (message, kind) => kind === "error" ? copyToast.error(message) : copyToast.success(message)
+  });
   const store = useAppStore();
   const [loading, setLoading] = useState(false);
   const [error, setError] = useState(null);
@@ -39,7 +44,7 @@ function PromptPreviewContent({
   }, [conversationId, store, nonce]);
   const copy = async (label, text) => {
     try {
-      await navigator.clipboard.writeText(text);
+      await copyText(text);
       toast.success(`${label} copied`);
     } catch {
       toast.error("Couldn't copy");

package/dist/agents/redux/agent-definition/cache-bust-middleware.js

@@ -43,7 +43,7 @@ async function bustAgentCache(baseUrl, agentId, headers) {
       keepalive: true
     });
   } catch (err) {
-    if (true) {
+    if (process.env.NODE_ENV !== "production") {
       console.warn(`[agent cache-bust] ${agentId} \u2192`, err);
     }
   }

package/dist/agents/redux/agent-definition/parse-messages-variables.js

@@ -28,6 +28,7 @@ const VARIABLE_COMPONENT_KNOWN_KEYS = [
   "min",
   "max",
   "step",
+  "pick_list",
   "structured_list",
   "picklist",
   "assignment",
@@ -201,6 +202,10 @@ function parseVariableCustomComponent(value, path) {
   const min = parseOptionalNumber(value.min, `${path}.min`);
   const max = parseOptionalNumber(value.max, `${path}.max`);
   const step = parseOptionalNumber(value.step, `${path}.step`);
+  const pickList = parseStructuredListBinding(
+    value.pick_list,
+    `${path}.pick_list`
+  );
   const structuredList = parseStructuredListBinding(
     value.structured_list,
     `${path}.structured_list`
@@ -224,6 +229,7 @@ function parseVariableCustomComponent(value, path) {
   if (min !== void 0) parsed.min = min;
   if (max !== void 0) parsed.max = max;
   if (step !== void 0) parsed.step = step;
+  if (pickList !== void 0) parsed.pick_list = pickList;
   if (structuredList !== void 0) parsed.structured_list = structuredList;
   if (picklist !== void 0) parsed.picklist = picklist;
   if (assignment !== void 0) parsed.assignment = assignment;

package/dist/agents/redux/agent-shortcuts/thunks.js

@@ -708,7 +708,7 @@ const fetchUnifiedMenu = createAsyncThunk(
         const categoryDefs = [];
         const shortcutDefs = [];
         const contentBlockDefs = [];
-        if (true) {
+        if (process.env.NODE_ENV !== "production") {
           const placementSummary = (payload.data ?? []).map((p) => ({
             placement_type: p.placement_type,
             categories: (p.categories_flat ?? []).length,

package/dist/agents/redux/execution-system/instance-resources/resource-source.js

@@ -1,5 +1,4 @@
-import { normalize } from "../../../../host/ui-slots.js";
-import { toMediaRef } from "../../../../host/ui-slots.js";
+import { normalize, toMediaRef } from "@ai-matrx/media/files/engine";
 const MEDIA_BLOCK_TYPES = /* @__PURE__ */ new Set([
   "image",
   "audio",

package/dist/agents/redux/execution-system/thunks/execute-manual-instance.thunk.js

@@ -532,7 +532,7 @@ const executeManualInstance = createAsyncThunk(
           })
         );
       }
-      if (true) {
+      if (process.env.NODE_ENV !== "production") {
         if (/\/ai\/agents\//.test(url) || /\/ai\/conversations\//.test(url)) {
           throw new Error(
             `[ManualExec] Forbidden URL "${url}". The manual execution path must NEVER hit /ai/agents/* or /ai/conversations/* (those do server-side definition lookup + caching). Use /ai/manual or a deliberate route override via manualEndpointOverride / apiConfig.`

package/dist/agents/redux/execution-system/thunks/launch-conversation.thunk.js

@@ -61,7 +61,7 @@ function invocationToManagedOptions(invocation) {
   return managed;
 }
 function warnUnsupported(invocation) {
-  if (false) return;
+  if (process.env.NODE_ENV === "production") return;
   if (invocation.identity.conversationId) {
     console.warn(
       "[launchConversation] identity.conversationId is passed through to the execution thunk, but turn-2+ routing currently still goes through executeInstance's existing `selectHasMessages` branch. The explicit conversationId-in-invocation path lands in Phase 3."

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/redux/execution-system/utils/assert-conversation-id.js

@@ -2,7 +2,7 @@ function assertConversationIdMatches(localConversationId, incomingId, source) {
   if (!incomingId) return;
   if (incomingId === localConversationId) return;
   const message = `[conversation-id drift] server returned a different conversation id via ${source}. local=${localConversationId} incoming=${incomingId}. The server must honor the client-generated conversation id.`;
-  if (true) {
+  if (process.env.NODE_ENV !== "production") {
     throw new Error(message);
   }
   console.error(message);

package/dist/agents/redux/execution-system/utils/content-prefilter.js

@@ -1,4 +1,4 @@
-import { ourFileUrlMarkers } from "../../../../host/ui-slots.js";
+import { OUR_FILE_URL_MARKERS } from "@ai-matrx/media/files/engine";
 const Candidate = {
   NONE: 0,
   TEXT: 0,
@@ -34,7 +34,7 @@ function isStandaloneAudioLink(trimmed) {
   return false;
 }
 function mightBeOurFile(trimmed) {
-  const markers = ourFileUrlMarkers();
+  const markers = OUR_FILE_URL_MARKERS;
   for (let mi = 0; mi < markers.length; mi++) {
     if (trimmed.includes(markers[mi])) return true;
   }

package/dist/agents/runtime/realtime/launchRealtimeSession.thunk.js

@@ -2,7 +2,7 @@ import { createAsyncThunk } from "@reduxjs/toolkit";
 const launchRealtimeSession = createAsyncThunk("agents/runtime/launchRealtimeSession", async (opts) => {
   const { agentId, surfaceName } = opts;
   const instanceId = `realtime-${agentId}`;
-  if (true) {
+  if (process.env.NODE_ENV !== "production") {
     console.debug(
       "[launchRealtimeSession] resolved",
       { agentId, surfaceName, instanceId }

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

@@ -16,8 +16,8 @@
  *     `settings_catalog_profile`.
  *
  * 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
+ * the campaign's own precedent is `matrx-user/pick-lists` / `matrx-user/pick-list-manager`,
+ * 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/agents/types/agent-definition.types.d.ts

@@ -26,7 +26,7 @@ export type VariableComponentType = (typeof VARIABLE_COMPONENT_TYPES)[number];
  * Binding of a variable to a Structured List (a Table of choices in the record store). When set, the
  * variable's options are hydrated at runtime from the list (labels only — the secret `description`
  * never reaches the client) and the emitted value is a ```matrx reference fence string
- * (`kind:"reference"`, `type:"structured_list_item"`), not text. Orthogonal to `type`, so a
+ * (`kind:"reference"`, `type:"pick_list_item"`), not text. Orthogonal to `type`, so a
  * structured-list-bound variable can render as select / radio / buttons / checkbox (a "picklist"
  * in the dropdown-projection sense).
  */
@@ -69,16 +69,18 @@ export interface VariableCustomComponent {
     unit?: string;
     /**
      * Structured-list binding. When present, options come from the bound Structured List and the
-     * variable's value is a ```matrx reference fence string (one `structured_list_item` for
+     * variable's value is a ```matrx reference fence string (one `pick_list_item` for
      * single-select, N items + any "Other" lines for multi). Kept top-level (not stashable) so it
      * survives component-type switches.
      */
-    structured_list?: StructuredListBinding;
+    pick_list?: StructuredListBinding;
     /**
-     * @deprecated Legacy key — READ-ONLY. Historical agent definitions store the binding under
-     * `picklist`; readers fall back to it via {@link readStructuredList}. New writes use
-     * `structured_list` only. Do not emit this key.
+     * @deprecated Legacy keys — READ-ONLY. Historical agent definitions store the binding under
+     * `structured_list` or `picklist`; readers fall back to them via {@link readStructuredList}.
+     * New writes use `pick_list` only. Do not emit these keys.
      */
+    structured_list?: StructuredListBinding;
+    /** @deprecated Legacy key — READ-ONLY (see `structured_list`). */
     picklist?: StructuredListBinding;
     /** Automatic-assignment strategies explicitly enabled by the agent author. */
     assignment?: VariableAssignmentConfig;

package/dist/agents/utils/variable-customcomponent.d.ts

@@ -21,8 +21,8 @@ export declare function readMax(cc: VariableCustomComponent | undefined): number
 export declare function readStep(cc: VariableCustomComponent | undefined): number;
 /**
  * The structured-list binding, if this variable is bound to a Structured List. Top-level only.
- * Reads the canonical `structured_list` key and falls back to the legacy `picklist` key
- * (read-only back-compat for historical agent definitions — new writes use `structured_list`).
+ * Reads the canonical `pick_list` key and falls back to the legacy `structured_list` and `picklist` keys
+ * (read-only back-compat for historical agent definitions — new writes use `pick_list`).
  */
 export declare function readStructuredList(cc: VariableCustomComponent | undefined): StructuredListBinding | undefined;
 export interface BuildCustomComponentInput {

package/dist/agents/utils/variable-customcomponent.js

@@ -48,7 +48,7 @@ function readStep(cc) {
   return cc?.step ?? cc?.stash?.step ?? 1;
 }
 function readStructuredList(cc) {
-  return cc?.structured_list ?? cc?.picklist;
+  return cc?.pick_list ?? cc?.structured_list ?? cc?.picklist;
 }
 function buildCustomComponent(input) {
   const { type } = input;
@@ -81,7 +81,7 @@ function buildCustomComponent(input) {
     cc.stash = stash;
   }
   if (input.structuredList?.listId) {
-    cc.structured_list = input.structuredList;
+    cc.pick_list = input.structuredList;
   }
   if (input.randomAssignment) {
     cc.assignment = { random: true };
@@ -89,7 +89,7 @@ function buildCustomComponent(input) {
   if (input.resourceContext && ((input.resourceContext.promote?.length ?? 0) > 0 || (input.resourceContext.exclude?.length ?? 0) > 0)) {
     cc.resource_context = input.resourceContext;
   }
-  if (type === "textarea" && !cc.stash && !cc.structured_list && !cc.assignment && !cc.resource_context)
+  if (type === "textarea" && !cc.stash && !cc.pick_list && !cc.assignment && !cc.resource_context)
     return void 0;
   return cc;
 }
@@ -114,7 +114,7 @@ function normalizeCustomComponent(cc) {
     const { stash: _drop, ...rest } = next;
     next = rest;
   }
-  if (next.type === "textarea" && !next.stash && !next.structured_list && !next.picklist && !next.assignment && !next.resource_context)
+  if (next.type === "textarea" && !next.stash && !next.pick_list && !next.structured_list && !next.picklist && !next.assignment && !next.resource_context)
     return void 0;
   return next;
 }

package/dist/cx-chat/components/messages/AssistantMessage.js

@@ -1,5 +1,6 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { recognizeOurFileUrl } from "@ai-matrx/media/files/engine";
 import { useState, useEffect, useCallback } from "react";
 import {
   Volume2,
@@ -17,7 +18,6 @@ import { selectMessageHasUnsavedChanges } from "../../_legacy-stubs.js";
 import { editMessage } from "../../_legacy-stubs.js";
 import { buildContentBlocksForSave } from "../../utils/buildContentBlocksForSave.js";
 import { useMediaLoadRecovery } from "@ai-matrx/media/core";
-import { recognizeOurFileUrl } from "../../../host/ui-slots.js";
 import { chatConversationsActions } from "../../_legacy-stubs.js";
 import { RichDocumentActions } from "../../../host/rich-document-slots.js";
 import { MessageTimestamp } from "../../../agents/components/messages-display/MessageTimestamp.js";

package/dist/cx-chat/components/user-input/ConversationInput.js

@@ -1,5 +1,6 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { useFileUpload } from "@ai-matrx/media/files/engine/handler/hooks/useFileUpload";
 import {
   useState,
   useRef,
@@ -44,7 +45,6 @@ import { selectIsDebugMode } from "../../../host/prefs.js";
 import { openOverlay, CHAT_WINDOWS } from "../../../host/windows.js";
 import { ResourceChips } from "../../../agents/resources/ResourceChips.js";
 import { useClipboardPaste } from "../../../host/ui-slots.js";
-import { useFileUpload } from "../../../host/ui-slots.js";
 import { composeUploadFolderPath } from "@ai-matrx/media/files";
 import { RunControlsMenu } from "../../../agents/components/inputs/smart-input/RunControlsMenu.js";
 import { PlusAttachMenu } from "../../../agents/components/inputs/smart-input/PlusAttachMenu.js";

package/dist/cx-conversation/AssistantMessage.js

@@ -1,5 +1,6 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { recognizeOurFileUrl } from "@ai-matrx/media/files/engine";
 import { useState, useEffect, useCallback } from "react";
 import {
   Volume2,
@@ -17,7 +18,6 @@ import { selectMessageHasUnsavedChanges } from "./_legacy-stubs.js";
 import { editMessage } from "./_legacy-stubs.js";
 import { buildContentBlocksForSave } from "./utils/buildContentBlocksForSave.js";
 import { useMediaLoadRecovery } from "@ai-matrx/media/core";
-import { recognizeOurFileUrl } from "../host/ui-slots.js";
 import { chatConversationsActions } from "./_legacy-stubs.js";
 import { RichDocumentActions } from "../host/rich-document-slots.js";
 import { MessageTimestamp } from "../agents/components/messages-display/MessageTimestamp.js";

package/dist/cx-conversation/ConversationInput.js

@@ -1,5 +1,6 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { useFileUpload } from "@ai-matrx/media/files/engine/handler/hooks/useFileUpload";
 import {
   useState,
   useRef,
@@ -54,7 +55,6 @@ import { selectActiveChatAgent } from "./_legacy-stubs.js";
 import { selectIsDebugMode } from "../host/prefs.js";
 import { ResourceChips } from "../agents/resources/ResourceChips.js";
 import { ResourcePickerMenu } from "../host/ui-slots.js";
-import { useFileUpload } from "../host/ui-slots.js";
 import { composeUploadFolderPath } from "@ai-matrx/media/files";
 import { useRecordAndTranscribe } from "../host/ui-slots.js";
 import { TranscriptionLoader } from "../host/ui-slots.js";