@ai-matrx/chat 0.2.5 → 0.2.7

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @ai-matrx/chat
 
+## 0.2.7 — 2026-10-06
+### Re-sync before matrx-frontend consumes the published package (P27)
+
+- Carries every matrx-frontend `packages/chat` edit made after base `9abc4bc369` (41 files, all
+  fast-forward): agent duplicate-any-version flow and one version-copy door, files engine read from
+  `@ai-matrx/media` directly (P16f, 8 file slots gone), ALC-16/19 kit clipboard copy, pick-list token,
+  `host/db-types.ts`, private-store-has-files suite.
+- The ALC-19 copy call sites imported the app's `@/lib/toast`; they use the package notify port
+  (`host/notify`) instead, so the host-tie budget stays 0. `ProcessedDocumentTitle` dispatches the media
+  rename thunk through its own signature.
+- Consumer action: none.
+
+## 0.2.6 — 2026-10-06
+
+- The build no longer bakes `process.env.NODE_ENV` to `"development"` (esbuild's browser-platform default):
+  16 modules read the host's value again, so dev-only checks stop running in production and the
+  test-mode throw in `surfaces/runtime/loaded-value-check` fires under Jest (P27).
+- Consumer action: none.
+
 ## 0.2.5 — 2026-10-06
 ### Re-sync before matrx-frontend consumes the published package (P27)
 

package/dist/agents/addressing/agentAddress.js

@@ -37,7 +37,7 @@ function versionIdMessage(address, suppliedId, context) {
 function assertAgentIdNotVersion(address, suppliedId, context) {
   if (!address.isVersion || suppliedId === address.agentId) return;
   const message = versionIdMessage(address, suppliedId, context);
-  if (true) throw new TypeError(message);
+  if (process.env.NODE_ENV !== "production") throw new TypeError(message);
   console.error(message);
 }
 function reportVersionIdRescued(address, suppliedId, context) {

package/dist/agents/components/context-items/bodies/ProcessedDocumentTitle.js

@@ -1,8 +1,8 @@
 "use client";
 import { jsx } from "react/jsx-runtime";
+import { renameFile } from "@ai-matrx/media/files/engine/redux/thunks";
 import { toast } from "../../../../host/notify.js";
 import { useAppDispatch } from "../../../../store/hooks.js";
-import { renameFile } from "../../../../host/ui-slots.js";
 import { useAttachedDocumentDisplayName } from "../../inputs/resources/attached-documents.js";
 import { PdfNamedSurfaceSwitcher } from "../../../../host/ui-slots.js";
 function ProcessedDocumentTitle({
@@ -20,7 +20,8 @@ function ProcessedDocumentTitle({
   const hasSiblings = siblings.length > 1;
   const handleRename = fileId ? async (next) => {
     try {
-      await dispatch(renameFile({ fileId, newName: next })).unwrap();
+      const dispatchFiles = dispatch;
+      await dispatchFiles(renameFile({ fileId, newName: next })).unwrap();
     } catch (err) {
       toast.error(
         err instanceof Error ? `Rename failed: ${err.message}` : "Rename failed"

package/dist/agents/components/context-items/bodies/WebpageBody.js

@@ -1,5 +1,7 @@
 "use client";
 import { Fragment, 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 { Check, Copy, ExternalLink } from "lucide-react";
 import {
@@ -40,13 +42,16 @@ function WebpageBody({ item, setTitle }) {
   );
 }
 function WebpageFooter({ item }) {
+  const { copyText } = useClipboard({
+    notify: (message, kind) => kind === "error" ? copyToast.error(message) : copyToast.success(message)
+  });
   const webpage = firstWebpage(item);
   const url = webpage ? webpageUrl(webpage) : null;
   const [copied, setCopied] = useState(false);
   if (!url) return null;
   const copy = async () => {
     try {
-      await navigator.clipboard.writeText(url);
+      await copyText(url);
       setCopied(true);
       setTimeout(() => setCopied(false), 1500);
     } catch {

package/dist/agents/components/debug/SandboxFileViewer.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 { Button } from "@ai-matrx/design-system/controls";
 import { useCallback, useEffect, useRef, useState } from "react";
 import { FileText, Loader2, RefreshCw, Copy, Check } from "lucide-react";
@@ -11,6 +13,9 @@ function SandboxFileViewer({
   initialPath = "",
   lockPath = false
 }) {
+  const { copyText } = useClipboard({
+    notify: (message, kind) => kind === "error" ? copyToast.error(message) : copyToast.success(message)
+  });
   const [path, setPath] = useState(initialPath);
   const [content, setContent] = useState(null);
   const [loading, setLoading] = useState(false);
@@ -45,7 +50,7 @@ function SandboxFileViewer({
   }, [initialPath, sandboxRowId, load]);
   const handleCopy = async () => {
     if (content == null) return;
-    await navigator.clipboard.writeText(content);
+    await copyText(content);
     setCopied(true);
     toast.success("File contents copied");
     setTimeout(() => setCopied(false), 1500);

package/dist/agents/components/debug/StreamDebugPanel.js

@@ -1,5 +1,7 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useClipboard } from "@ai-matrx/kit/clipboard";
+import { toast } from "../../../host/notify.js";
 import { Chip, Button, DisclosureHeader } from "@ai-matrx/design-system/controls";
 import { formatDurationMs } from "@ai-matrx/kit/format";
 import React, { useState, useRef, useEffect, useMemo } from "react";
@@ -49,9 +51,12 @@ function DebugTabScroll({ children }) {
   return /* @__PURE__ */ jsx("div", { className: "flex flex-col flex-1 min-h-0 h-full", children: /* @__PURE__ */ jsx(ScrollArea, { className: "flex-1 min-h-0", children }) });
 }
 function useCopy() {
+  const { copyText } = useClipboard({
+    notify: (message, kind) => kind === "error" ? toast.error(message) : toast.success(message)
+  });
   const [copied, setCopied] = useState(null);
   const copy = (text, id) => {
-    navigator.clipboard.writeText(text);
+    copyText(text);
     setCopied(id);
     setTimeout(() => setCopied(null), 1500);
   };

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

@@ -1,5 +1,6 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useFileUpload } from "@ai-matrx/media/files/engine/handler/hooks/useFileUpload";
 import { useCallback, useRef, useState } from "react";
 import {
   Image as ImageIcon,
@@ -20,7 +21,6 @@ import { FileResourceChip } from "../../../../host/ui-slots.js";
 import { InlineMediaRef } from "@ai-matrx/media/react";
 import { useFileDocument } from "../../../../host/ui-slots.js";
 import { useMediaResolution } from "@ai-matrx/media/core";
-import { useFileUpload } from "../../../../host/ui-slots.js";
 import { FilesResourcePicker } from "../../../../host/ui-slots.js";
 import { cn } from "@ai-matrx/design-system";
 import { ResourceFamilyPolicyEditor } from "../resources/ResourceFamilyPolicyEditor.js";

package/dist/agents/components/inputs/resources/attached-documents.js

@@ -1,6 +1,7 @@
 "use client";
+import { fileHandler } from "@ai-matrx/media/files/engine";
+import { useFile } from "@ai-matrx/media/files/engine/handler/hooks/useFile";
 import { useEffect, useState } from "react";
-import { resolveFile, useFile } from "../../../../host/ui-slots.js";
 import { normalizeResourceFamilyPolicy } from "./resource-family-policy.js";
 const ATTACHED_DOCUMENT_TOKENS = ["processed_document", "file"];
 function parseAttachedDocumentMetadata(metadata) {
@@ -78,7 +79,7 @@ function useAttachedDocumentFileNames(fileIds) {
     if (!idsKey) return void 0;
     let cancelled = false;
     for (const fileId of idsKey.split(",")) {
-      resolveFile({ kind: "file_id", fileId }).then((file) => {
+      fileHandler.resolve({ kind: "file_id", fileId }).then((file) => {
         const name = file.meta.fileName?.trim();
         if (cancelled || !name) return;
         setNames((prev) => prev[fileId] === name ? prev : { ...prev, [fileId]: name });

package/dist/agents/components/inputs/resources/usePasteImageResource.js

@@ -1,10 +1,10 @@
 "use client";
+import { useFileUpload } from "@ai-matrx/media/files/engine/handler/hooks/useFileUpload";
+import { normalize } from "@ai-matrx/media/files/engine";
 import { useEffect, useRef } from "react";
 import { toast } from "../../../../host/notify.js";
 import { useAppDispatch, useAppStore } from "../../../../store/hooks.js";
-import { useFileUpload } from "../../../../host/ui-slots.js";
 import { composeUploadFolderPath } from "@ai-matrx/media/files";
-import { normalize } from "../../../../host/ui-slots.js";
 import {
   addResource,
   removeResource,

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

@@ -1,12 +1,13 @@
 "use client";
 import { jsx } from "react/jsx-runtime";
+import { useClipboard } from "@ai-matrx/kit/clipboard";
+import { toast as copyToast } from "../../../host/notify.js";
 import { useEffect } from "react";
 import { usePathname } from "../../../host/navigation.js";
 import { Stethoscope } from "lucide-react";
 import { useAppSelector, useAppStore } from "../../../store/hooks.js";
 import { selectMessageCount } from "../../redux/execution-system/messages/messages.selectors.js";
 import { selectStreamPhase } from "../../redux/execution-system/selectors/aggregate.selectors.js";
-import { writeClipboard } from "../../../agent-copy/clipboard.js";
 import { toast } from "../../../host/notify.js";
 import { useDebugContext } from "../../../host/prefs-react.js";
 import {
@@ -25,6 +26,9 @@ function TranscriptIntegrityCopyButtonInner({
   surfaceKey,
   effectiveVisibleGroupLimit
 }) {
+  const { copyText } = useClipboard({
+    notify: (message, kind) => kind === "error" ? copyToast.error(message) : copyToast.success(message)
+  });
   const store = useAppStore();
   const pathname = usePathname() ?? "";
   const messageCount = useAppSelector(selectMessageCount(conversationId));
@@ -64,7 +68,7 @@ function TranscriptIntegrityCopyButtonInner({
       effectiveVisibleGroupLimit
     });
     try {
-      await writeClipboard(formatTranscriptIntegrityReport(report));
+      await copyText(formatTranscriptIntegrityReport(report));
       toast.success(
         report.anomalies.length === 0 ? "Transcript report copied \u2014 no anomalies detected" : `Transcript report copied \u2014 ${report.anomalies.length} anomal${report.anomalies.length === 1 ? "y" : "ies"} flagged`
       );

package/dist/agents/components/observational-memory/components/MemoryStateInspector.d.ts

@@ -1,15 +1,3 @@
-/**
- * MemoryStateInspector
- *
- * Admin-only view of the raw `cx_observational_memory` row for a conversation.
- * Shows the actual `active_observations` text (what's being injected on every
- * turn), plus the buffered observation/reflection state, generation counter,
- * token counts, and metadata.
- *
- * We query Supabase directly with the RLS'd client — non-admin users will
- * see an empty result even if they somehow reach this component, and admins
- * will see the full row.
- */
 import React from "react";
 interface MemoryStateInspectorProps {
     conversationId: string;

package/dist/agents/components/observational-memory/components/MemoryStateInspector.js

@@ -1,5 +1,7 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useClipboard } from "@ai-matrx/kit/clipboard";
+import { toast } from "../../../../host/notify.js";
 import { useCallback, useEffect, useMemo, useState } from "react";
 import { extractErrorMessage } from "@ai-matrx/data/net";
 import {
@@ -262,13 +264,16 @@ function BufferedObservationCard({
   cycle,
   defaultOpen
 }) {
+  const { copyText } = useClipboard({
+    notify: (message, kind) => kind === "error" ? toast.error(message) : toast.success(message)
+  });
   const [open, setOpen] = useState(defaultOpen);
   const [copied, setCopied] = useState(false);
   const text = cycle.observations ?? "";
   const hasText = text.length > 0;
   const handleCopy = useCallback(() => {
     if (!hasText) return;
-    navigator.clipboard.writeText(text);
+    copyText(text);
     setCopied(true);
     setTimeout(() => setCopied(false), 1500);
   }, [text, hasText]);
@@ -498,11 +503,14 @@ function TextPayload({
   text,
   maxHeightClass = "max-h-64"
 }) {
+  const { copyText } = useClipboard({
+    notify: (message, kind) => kind === "error" ? toast.error(message) : toast.success(message)
+  });
   const [copied, setCopied] = useState(false);
   const hasText = typeof text === "string" && text.length > 0;
   const handleCopy = useCallback(() => {
     if (!text) return;
-    navigator.clipboard.writeText(text);
+    copyText(text);
     setCopied(true);
     setTimeout(() => setCopied(false), 1500);
   }, [text]);

package/dist/agents/components/run-controls/AgentExecutionTestModal.js

@@ -1,5 +1,7 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useClipboard } from "@ai-matrx/kit/clipboard";
+import { toast as copyToast } from "../../../host/notify.js";
 import { useState, useEffect, useCallback } from "react";
 import { kindTextToMarkdown } from "../../../utils/content-ir/surfaces/kind-text-to-markdown.js";
 import { useAppSelector } from "../../../store/hooks.js";
@@ -43,6 +45,9 @@ function DirectTestMode({
   userInput,
   apiEndpointMode
 }) {
+  const { copyText } = useClipboard({
+    notify: (message, kind) => kind === "error" ? copyToast.error(message) : copyToast.success(message)
+  });
   const { launchAgent, close } = useAgentLauncher();
   const [conversationId, setConversationId] = useState(null);
   const [copied, setCopied] = useState(false);
@@ -88,7 +93,7 @@ function DirectTestMode({
   ]);
   const handleCopy = useCallback(() => {
     if (responseText) {
-      navigator.clipboard.writeText(kindTextToMarkdown(responseText));
+      copyText(kindTextToMarkdown(responseText));
       setCopied(true);
       setTimeout(() => setCopied(false), 2e3);
     }

package/dist/agents/components/shared/AgentDuplicateOutcomeDialog.d.ts

@@ -1,4 +1,26 @@
-export type DuplicateOutcomeState = "loading" | "success" | "error";
+/** "choose" = the person picks which version to copy before anything runs. */
+export type DuplicateOutcomeState = "choose" | "loading" | "success" | "error";
+/** The value of the "copy the agent as it is now" choice. */
+export declare const CURRENT_VERSION_CHOICE = "current";
+export interface DuplicateVersionOption {
+    versionId: string;
+    versionNumber: number;
+    changedAt: string;
+    changeNote: string | null;
+}
+export interface DuplicateVersionChooser {
+    /** The source agent's live version number, shown on the default choice. */
+    currentVersion: number | null;
+    /** Saved past versions, newest first. */
+    versions: DuplicateVersionOption[];
+    versionsLoading: boolean;
+    /** Set when the version list could not be read — the current version still works. */
+    versionsError: string | null;
+    /** CURRENT_VERSION_CHOICE or a version id. */
+    selected: string;
+    onSelectedChange: (value: string) => void;
+    onConfirm: () => void;
+}
 export interface AgentDuplicateOutcomeDialogProps {
     open: boolean;
     /** Called when the user dismisses the dialog (X button, escape, or "Stay
@@ -15,6 +37,8 @@ export interface AgentDuplicateOutcomeDialogProps {
     /** Whether the source agent was a builtin/system agent. Tweaks the success
      *  copy so admins know the duplicate is also a system agent. */
     asSystem?: boolean;
+    /** Required for the "choose" state. */
+    chooser?: DuplicateVersionChooser;
 }
 /**
  * Post-duplicate "where would you like to go?" choice surface.
@@ -30,4 +54,4 @@ export interface AgentDuplicateOutcomeDialogProps {
  * Mobile renders as a bottom Drawer (per project mobile rules — never Dialog
  * on mobile); desktop uses a small Dialog (`sm:max-w-md`).
  */
-export declare function AgentDuplicateOutcomeDialog({ open, onOpenChange, state, newAgentName, newAgentPath, errorMessage, asSystem, }: AgentDuplicateOutcomeDialogProps): import("react").JSX.Element;
+export declare function AgentDuplicateOutcomeDialog({ open, onOpenChange, state, newAgentName, newAgentPath, errorMessage, asSystem, chooser, }: AgentDuplicateOutcomeDialogProps): import("react").JSX.Element;

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

@@ -26,7 +26,9 @@ import {
 } from "@ai-matrx/design-system";
 import { Alert, AlertDescription } from "@ai-matrx/design-system";
 import { Button } from "@ai-matrx/design-system";
+import { Select } from "@ai-matrx/design-system/controls";
 import { useIsMobile } from "@ai-matrx/kit/media-query";
+const CURRENT_VERSION_CHOICE = "current";
 function AgentDuplicateOutcomeDialog({
   open,
   onOpenChange,
@@ -34,7 +36,8 @@ function AgentDuplicateOutcomeDialog({
   newAgentName,
   newAgentPath,
   errorMessage,
-  asSystem = false
+  asSystem = false,
+  chooser
 }) {
   const isMobile = useIsMobile();
   const router = useRouter();
@@ -52,9 +55,42 @@ function AgentDuplicateOutcomeDialog({
   const handleStayHere = () => {
     onOpenChange(false);
   };
-  const titleText = state === "loading" ? "Duplicating agent\u2026" : state === "success" ? asSystem ? "System agent duplicated" : "Agent duplicated" : "Duplicate failed";
-  const descriptionText = state === "loading" ? "Creating a copy with all messages, variables, settings, and tools." : state === "success" ? newAgentName ? `"${newAgentName}" is ready. Where would you like to go?` : "The copy is ready. Where would you like to go?" : errorMessage ?? "Something went wrong while duplicating.";
+  const titleText = state === "choose" ? "Duplicate agent" : state === "loading" ? "Duplicating agent\u2026" : state === "success" ? asSystem ? "System agent duplicated" : "Agent duplicated" : "Duplicate failed";
+  const descriptionText = state === "choose" ? "Pick the version to copy into a new agent." : state === "loading" ? "Creating a copy with all messages, variables, settings, and tools." : state === "success" ? newAgentName ? `"${newAgentName}" is ready. Where would you like to go?` : "The copy is ready. Where would you like to go?" : errorMessage ?? "Something went wrong while duplicating.";
   const body = /* @__PURE__ */ jsxs("div", { className: "space-y-4", children: [
+    state === "choose" && chooser && /* @__PURE__ */ jsxs("div", { className: "space-y-3", children: [
+      /* @__PURE__ */ jsx(
+        Select,
+        {
+          "aria-label": "Version to copy",
+          className: "w-full",
+          value: chooser.selected,
+          onValueChange: chooser.onSelectedChange,
+          options: [
+            {
+              value: CURRENT_VERSION_CHOICE,
+              label: chooser.currentVersion != null ? `Current version (v${chooser.currentVersion})` : "Current version"
+            },
+            ...chooser.versions.filter((v) => v.versionNumber !== chooser.currentVersion).map((v) => ({ value: v.versionId, label: versionOptionLabel(v) }))
+          ]
+        }
+      ),
+      chooser.versionsLoading && /* @__PURE__ */ jsxs("p", { className: "flex items-center gap-2 text-xs text-muted-foreground", children: [
+        /* @__PURE__ */ jsx(Loader2, { className: "h-3 w-3 animate-spin" }),
+        "Loading versions\u2026"
+      ] }),
+      chooser.versionsError && /* @__PURE__ */ jsxs("p", { className: "text-xs text-destructive", children: [
+        "Past versions could not be loaded: ",
+        chooser.versionsError
+      ] }),
+      /* @__PURE__ */ jsxs("div", { className: "flex justify-end gap-2", children: [
+        /* @__PURE__ */ jsx(Button, { variant: "ghost", onClick: handleStayHere, children: "Cancel" }),
+        /* @__PURE__ */ jsxs(Button, { onClick: chooser.onConfirm, children: [
+          /* @__PURE__ */ jsx(Copy, { className: "h-4 w-4" }),
+          "Duplicate"
+        ] })
+      ] })
+    ] }),
     state === "loading" && /* @__PURE__ */ jsxs("div", { className: "flex flex-col items-center gap-3 py-6", children: [
       /* @__PURE__ */ jsx(Loader2, { className: "h-10 w-10 animate-spin text-primary" }),
       /* @__PURE__ */ jsx("p", { className: "text-sm text-muted-foreground", children: "Please wait\u2026" })
@@ -137,6 +173,16 @@ function AgentDuplicateOutcomeDialog({
     body
   ] }) });
 }
+function versionOptionLabel(v) {
+  const date = new Date(v.changedAt).toLocaleDateString(void 0, {
+    month: "short",
+    day: "numeric",
+    year: "numeric"
+  });
+  const note = v.changeNote?.trim();
+  return note ? `v${v.versionNumber} \xB7 ${date} \xB7 ${note.length > 40 ? `${note.slice(0, 40)}\u2026` : note}` : `v${v.versionNumber} \xB7 ${date}`;
+}
 export {
-  AgentDuplicateOutcomeDialog
+  AgentDuplicateOutcomeDialog,
+  CURRENT_VERSION_CHOICE
 };

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

@@ -2,7 +2,7 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { useAppDispatch, useAppSelector } from "../../../store/hooks.js";
 import { applyOrganizationContextHeader } from "../../../host/server/organization-context.js";
-import { getBuilderDoor, requireBuilderDoor } from "../../../host/builder-door.js";
+import { getBuilderDoor } from "../../../host/builder-door.js";
 import { invalidateAgentCache } from "../../redux/agent-definition/invalidate-agent-cache.thunk.js";
 import { selectAgentById } from "../../redux/agent-definition/selectors.js";
 import { useOpenAgentSettingsWindow } from "../../../host/window-openers.js";
@@ -21,7 +21,7 @@ import { useOpenAgentInterfaceVariationsWindow } from "../../../host/window-open
 import { useOpenSaveTemplateDialog } from "../../../host/window-openers.js";
 const SAVE_AS_TEMPLATE_LABEL = "Save as template";
 import { useCallback, useState } from "react";
-import { usePathname, Link } from "../../../host/navigation.js";
+import { Link } from "../../../host/navigation.js";
 import {
   MoreHorizontal,
   FileText,
@@ -66,17 +66,11 @@ import {
 } from "@ai-matrx/design-system";
 import { Drawer, DrawerContent, DrawerTitle } from "@ai-matrx/design-system";
 import { MenuTapButton } from "@ai-matrx/tap-target/buttons";
-import {
-  AgentDuplicateOutcomeDialog
-} from "./AgentDuplicateOutcomeDialog.js";
+import { useAgentDuplicateFlow } from "../../hooks/useAgentDuplicateFlow.js";
 import { ReferenceCopyMenuItem } from "../../../host/ui-slots.js";
-import {
-  isAdminSystemAgentsContext
-} from "./agent-route-context.js";
 import { useAgentLifecycleActions } from "../../lifecycle/useAgentLifecycleActions.js";
-import { getUserMessage } from "@ai-matrx/agents/matrx";
 import { selectIsSuperAdmin } from "../../../host/identity.js";
-import { selectOrganizationId, isOrganizationSelectionCancelled } from "../../../host/org.js";
+import { selectOrganizationId } from "../../../host/org.js";
 import { Button, Tile } from "@ai-matrx/design-system/controls";
 const INTERFACE_VARIATIONS = [
   "Full Modal",
@@ -182,7 +176,6 @@ function AgentOptionsMenu({
   const [isConverting, setIsConverting] = useState(false);
   const [isRefreshingCache, setIsRefreshingCache] = useState(false);
   const dispatch = useAppDispatch();
-  const pathname = usePathname();
   const openSettings = useOpenAgentSettingsWindow();
   const openRunHistory = useOpenAgentRunHistoryWindow();
   const openAdvancedEditor = useOpenAgentContentWindow();
@@ -197,45 +190,13 @@ function AgentOptionsMenu({
   const openAdminFindUsages = useOpenAgentAdminFindUsagesWindow();
   const openImport = useOpenAgentImportWindow();
   const openInterfaceVariations = useOpenAgentInterfaceVariationsWindow();
-  const [duplicateOpen, setDuplicateOpen] = useState(false);
-  const [duplicateState, setDuplicateState] = useState("loading");
-  const [duplicatedAgentId, setDuplicatedAgentId] = useState(
-    null
-  );
-  const [duplicatedAgentName, setDuplicatedAgentName] = useState("");
-  const [duplicateError, setDuplicateError] = useState("");
-  const [duplicateAsSystem, setDuplicateAsSystem] = useState(false);
+  const duplicateFlow = useAgentDuplicateFlow(agentId, {
+    basePath,
+    fallbackSuffix: ""
+  });
   const agent = useAppSelector((state) => selectAgentById(state, agentId));
   const isBuiltin = agent?.agentType === "builtin";
-  const isAdminContext = isAdminSystemAgentsContext(basePath);
-  const newAgentPath = duplicatedAgentId ? (() => {
-    const sourceSegment = `${basePath}/${agentId}`;
-    const suffix = pathname && pathname.startsWith(sourceSegment) ? pathname.slice(sourceSegment.length) : "";
-    return `${basePath}/${duplicatedAgentId}${suffix}`;
-  })() : null;
-  const runDuplicate = useCallback(async () => {
-    const asSystem = isAdminContext && isBuiltin;
-    setDuplicateAsSystem(asSystem);
-    setDuplicatedAgentId(null);
-    setDuplicatedAgentName(agent?.name ? `Copy of ${agent.name}` : "");
-    setDuplicateError("");
-    setDuplicateState("loading");
-    setDuplicateOpen(true);
-    try {
-      const newId = await dispatch(
-        requireBuilderDoor().duplicateAgent({ agentId, asSystem })
-      ).unwrap();
-      setDuplicatedAgentId(newId);
-      setDuplicateState("success");
-    } catch (err) {
-      if (isOrganizationSelectionCancelled(err)) {
-        setDuplicateOpen(false);
-        return;
-      }
-      setDuplicateError(getUserMessage(err));
-      setDuplicateState("error");
-    }
-  }, [agent?.name, agentId, dispatch, isAdminContext, isBuiltin]);
+  const runDuplicate = duplicateFlow.openChooser;
   const hasBuilderDoor = getBuilderDoor() !== null;
   const managementItems = AGENT_MANAGEMENT_ITEMS.filter(
     (item) => (!isBuiltin || item.label !== "Convert to Template") && (hasBuilderDoor || item.label !== "Duplicate")
@@ -395,18 +356,7 @@ function AgentOptionsMenu({
     setOpen(false);
   };
   const trigger = /* @__PURE__ */ jsx(MenuTapButton, { variant: "transparent" });
-  const duplicateDialog = /* @__PURE__ */ jsx(
-    AgentDuplicateOutcomeDialog,
-    {
-      open: duplicateOpen,
-      onOpenChange: setDuplicateOpen,
-      state: duplicateState,
-      newAgentName: duplicatedAgentName,
-      newAgentPath,
-      errorMessage: duplicateError,
-      asSystem: duplicateAsSystem
-    }
-  );
+  const duplicateDialog = duplicateFlow.dialog;
   if (isMobile) {
     return /* @__PURE__ */ jsxs(Fragment, { children: [
       /* @__PURE__ */ jsxs(Drawer, { open, onOpenChange: setOpen, children: [
@@ -518,7 +468,7 @@ function AgentOptionsMenu({
         /* @__PURE__ */ jsx(DropdownMenuSeparator, {}),
         /* @__PURE__ */ jsx(DropdownMenuLabel, { className: "text-[10px] uppercase tracking-wider text-muted-foreground/60 font-semibold", children: "Manage" }),
         managementItems.map(({ label, icon: Icon, soon }) => {
-          const duplicateInFlight = duplicateOpen && duplicateState === "loading";
+          const duplicateInFlight = duplicateFlow.isDuplicating;
           const isLoading = label === "Convert to Template" && isConverting || label === "Duplicate" && duplicateInFlight;
           const displayLabel = label === "Convert to Template" && isConverting ? "Saving..." : label === "Duplicate" && duplicateInFlight ? "Duplicating..." : label;
           return /* @__PURE__ */ jsxs(

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

@@ -1,10 +1,15 @@
 "use client";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { useClipboard } from "@ai-matrx/kit/clipboard";
+import { toast } from "../../../host/notify.js";
 import { useEffect, useState } from "react";
 import { Activity, X, Copy } from "lucide-react";
 import { cn } from "@ai-matrx/design-system";
 import { Button } from "@ai-matrx/design-system/controls";
 function StreamProfilerOverlay() {
+  const { copyText } = useClipboard({
+    notify: (message, kind) => kind === "error" ? toast.error(message) : toast.success(message)
+  });
   const [isOpen, setIsOpen] = useState(false);
   const [reports, setReports] = useState([]);
   useEffect(() => {
@@ -29,7 +34,7 @@ function StreamProfilerOverlay() {
       /* @__PURE__ */ jsx(Button, { variant: "quiet", icon: /* @__PURE__ */ jsx(X, {}), "aria-label": "Close", onClick: () => setIsOpen(false) })
     ] }),
     /* @__PURE__ */ jsx("div", { className: "flex-1 overflow-y-auto p-4 space-y-4", children: reports.length === 0 ? /* @__PURE__ */ jsx("div", { className: "text-center text-slate-500 italic py-8", children: "No stream data collected yet. Trigger a prompt." }) : reports.map((r, i) => /* @__PURE__ */ jsxs("div", { className: "bg-slate-900 border border-slate-800 rounded-lg p-3 space-y-2 relative group", children: [
-      /* @__PURE__ */ jsx(Button, { variant: "quiet", icon: /* @__PURE__ */ jsx(Copy, {}), onClick: () => navigator.clipboard.writeText(JSON.stringify(r, null, 2)), title: "Copy JSON", "aria-label": "Copy JSON", className: "absolute top-2 right-2 opacity-0 group-hover:opacity-100" }),
+      /* @__PURE__ */ jsx(Button, { variant: "quiet", icon: /* @__PURE__ */ jsx(Copy, {}), onClick: () => copyText(JSON.stringify(r, null, 2)), title: "Copy JSON", "aria-label": "Copy JSON", className: "absolute top-2 right-2 opacity-0 group-hover:opacity-100" }),
       /* @__PURE__ */ jsx("div", { className: "text-blue-400 font-bold mb-2", children: r.Test }),
       /* @__PURE__ */ jsxs("div", { className: "grid grid-cols-2 gap-x-4 gap-y-1 text-xs", children: [
         /* @__PURE__ */ jsx("div", { className: "text-slate-500", children: "Client Duration:" }),

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). */