@ai-matrx/chat 0.2.9 → 0.3.2

package/CHANGELOG.md

@@ -1,11 +1,45 @@
 # @ai-matrx/chat
 
+## 0.3.2
+
+Automatic changed-only republish (docs/metadata drift since the last tag — see
+`git diff npm/chat/v0.2.10..npm/chat/v0.3.2 -- apps/shared/chat`).
+No source changes intended and no consumer action required.
+
+## 0.3.1 — 2026-10-07
+### Re-sync before matrx-frontend consumes the published package (P27)
+
+- Carries every matrx-frontend `packages/chat` edit after `636e7ef2dd` (context-preview copy, agent-settings
+  `offeringId`, surface-config service, db-types) and `surfaces/lib/ui-surfaces-agent-writes` +
+  `ui-surfaces-scope` (+ suite), which earlier re-syncs missed; the app imports both.
+- Consumer action: none.
+
+## 0.3.0 — 2026-10-07
+
+ALC-19: the chat clipboard slot is content-shaped.
+
+- Host UI slot `copyToClipboard` (`host/ui-slots`) is renamed `copyContent(content, options)`; its stand-in copies a string as text (anything else as JSON) through `@ai-matrx/kit/clipboard` and calls `options.onError` on failure. `agent-copy/clipboard` no longer exports the failure-swallowing `writeClipboard` (only `approxTokens`).
+- Consumer action: register `copyContent` (not `copyToClipboard`) in `registerChatUi`; import `copyContent` from `@ai-matrx/chat/host/ui-slots`; replace any `writeClipboard` import with `@ai-matrx/kit/clipboard` `copyText`.
+
+## 0.2.10 — 2026-10-07
+### Re-sync before matrx-frontend consumes the published package (P27)
+
+- Carries every matrx-frontend `packages/chat` edit made after base `f5f30ae893` (32 files): ALC-18 live
+  values reach the surface scope and the clicked row's declared item, ALC-19 kit copy/`host/clipboard`,
+  board chat keeps its conversation id across a reload, voices read from `@ai-matrx/media/voices`,
+  remarks durability-port announcement.
+- Their `@/lib/toast` imports use the package notify port and their `agent-copy/export` download imports
+  use `@ai-matrx/kit/download` (0.2.9 dropped the chat copy). Public "Save as file" passes the text,
+  not a pre-built Blob, so the saved file holds the markdown.
+- Consumer action: none.
+
 ## 0.2.9 — 2026-10-07
 
 ALC-19: the download door moved to the base package.
 
 - `agent-copy/export` no longer exports `downloadFile` / `downloadUrl`; they live in `@ai-matrx/kit/download` (kit 0.26.0).
 - Consumer action: import `downloadFile` / `downloadUrl` from `@ai-matrx/kit/download`.
+- The audio-response download, the public chat "save as file" and tool-result file links save through kit's door too (no hand-built anchors left in the package).
 
 ## 0.2.8 — 2026-10-07
 

package/dist/agent-copy/clipboard.d.ts

@@ -1,8 +1,6 @@
 /**
- * Shared clipboard + payload-size helpers for the agent-copy primitives.
- * One implementation — CopyButtons, AiCopyMenu, and the Groomer all use these;
- * never re-roll a clipboard write or a token estimate at a callsite.
+ * Shared payload-size helper for the agent-copy primitives. Clipboard writes go through
+ * `@ai-matrx/kit/clipboard`; never re-roll a token estimate at a callsite.
  */
-export declare function writeClipboard(text: string): Promise<void>;
 /** Rough token estimate (chars / 4) — same convention as the Groomer window. */
 export declare function approxTokens(text: string): number;

package/dist/agent-copy/clipboard.js

@@ -1,19 +1,6 @@
-async function writeClipboard(text) {
-  try {
-    await navigator.clipboard.writeText(text);
-  } catch {
-    const textarea = document.createElement("textarea");
-    textarea.value = text;
-    document.body.appendChild(textarea);
-    textarea.select();
-    document.execCommand("copy");
-    document.body.removeChild(textarea);
-  }
-}
 function approxTokens(text) {
   return Math.ceil(text.length / 4);
 }
 export {
-  approxTokens,
-  writeClipboard
+  approxTokens
 };

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

@@ -16,67 +16,15 @@
  */
 import type { AgentPayloadInput } from "@ai-matrx/alchemy/operate";
 import type { AlchemyGroomerConfig } from "@ai-matrx/alchemy/react/workspace";
-export type PageCaptureKind = "table-page" | "record" | "dialog" | "admin-page";
+import { mergeLiveCapture, type LiveCapture, type LiveCaptureKind, type LiveCaptureValue, type LiveContribution, type LiveNamed, type LiveRequest, type LiveSection } from "@ai-matrx/alchemy/surface";
+export type PageCaptureKind = LiveCaptureKind;
 /** A chosen thing, by name and id. Either may be null (not chosen / not loaded). */
-export interface PageCaptureNamed {
-    id: string | null;
-    name: string | null;
-}
-export type PageCaptureValue = PageCaptureNamed | string | number | boolean | null;
-export interface PageCaptureSection {
-    /** Stable id — the Groomer's section id. Unique within one capture. */
-    id: string;
-    /** What the person calls this part of the page. */
-    title: string;
-    description?: string;
-    /** `data` survives "Only the data"; `request` does not. */
-    role: "data" | "request";
-    value: unknown;
-    /** The one-line brief (counts, a sentence). Defaults to the value's shape. */
-    brief?: unknown;
-    /**
-     * A section too big to hold on the page (a table's records): `value` is the
-     * honest stub saying it is not included, and `load` reads it at copy time for
-     * the "with …" variants. Never a second read while the page is only open.
-     */
-    load?: () => Promise<unknown>;
-}
-export interface PageCaptureRequest {
-    method: string;
-    path: string;
-    status: string;
-    httpStatus?: number;
-    durationMs?: number;
-    requestId?: string;
-    /** Which client door (supabase-rest, supabase-rpc, aidream, next-api …). */
-    client?: string;
-    /** The JSON request body under 8 KB, credentials redacted. */
-    requestBody?: unknown;
-    requestBodyNote?: string;
-    /** A failed request's own sentence from the server (the refusal, verbatim). */
-    errorSentence?: string;
-    timestamp: number;
-}
-export interface PageCapture {
-    kind: PageCaptureKind;
-    title: string;
-    route: string;
-    url?: string;
-    /** What this page is OF (table, record, dialog subject …), names and ids. */
-    identity: Record<string, PageCaptureValue>;
-    /** The exact choices the person made on the page, in order. */
-    selection: Record<string, PageCaptureValue>;
-    sections: PageCaptureSection[];
-    /** The error sentences on screen, verbatim. */
-    errors: string[];
-    requests: PageCaptureRequest[];
-}
-export interface PageCaptureContribution {
-    owner: string;
-    sections: PageCaptureSection[];
-    /** Names a descendant knows and the page does not (a table's name read inside its mount). */
-    identity?: Record<string, PageCaptureValue>;
-}
+export type PageCaptureNamed = LiveNamed;
+export type PageCaptureValue = LiveCaptureValue;
+export type PageCaptureSection = LiveSection;
+export type PageCaptureRequest = LiveRequest;
+export type PageCapture = LiveCapture;
+export type PageCaptureContribution = LiveContribution;
 /** The marker a cycle leaves where the repeated object would have been. */
 export declare const CIRCULAR_MARKER_PREFIX = "[circular reference to ";
 /** A JSON pointer path in words: `/sections/1/load` → `sections › 1 › load`; root is "the capture itself". */
@@ -95,9 +43,10 @@ export declare function checkedTransferJson<T>(value: T, what: string): T;
 /** `Name (id)`, `Name`, `(id)`, or "not chosen". */
 export declare function describeValue(v: PageCaptureValue): string;
 /** Merge descendant sections into a capture. Two owners claiming one id is a loud error. */
-export declare function mergePageCapture(base: PageCapture, contributions: readonly PageCaptureContribution[]): PageCapture;
+/** The page's capture plus its descendants' contributions — alchemy's one merge. */
+export declare const mergePageCapture: typeof mergeLiveCapture;
 /**
- * THE CAPTURE MADE PLAIN AT REGISTRATION (`getActivePageCapture` calls this): identity, selection,
+ * THE CAPTURE MADE PLAIN AT READ (`getActivePageCapture` calls this): identity, selection,
  * every section's value and brief, and every request body are plain JSON. A section's `load` stays a
  * function — it is how the "with …" copies read — and is never handed to a transfer (see
  * `pageCaptureJson`).

package/dist/agent-copy/page-capture/pageCapture.js

@@ -1,4 +1,7 @@
 import { formatCount } from "@ai-matrx/kit/format";
+import {
+  mergeLiveCapture
+} from "@ai-matrx/alchemy/surface";
 const COMPACT_CHARS = 6e3;
 const CIRCULAR_MARKER_PREFIX = "[circular reference to ";
 function pathInWords(path) {
@@ -118,28 +121,7 @@ function compactValue(value) {
     preview: text.slice(0, COMPACT_CHARS)
   };
 }
-function mergePageCapture(base, contributions) {
-  const owners = new Map(base.sections.map((s) => [s.id, "page"]));
-  const sections = [...base.sections];
-  const identity = { ...base.identity };
-  for (const c of contributions) {
-    for (const [k, v] of Object.entries(c.identity ?? {})) {
-      const prior = identity[k];
-      if (prior === void 0 || prior === null || isNamed(prior) && !prior.name) identity[k] = v;
-    }
-    for (const s of c.sections) {
-      const prior = owners.get(s.id);
-      if (prior) {
-        throw new Error(
-          `[page-capture] section "${s.id}" is claimed by both "${prior}" and "${c.owner}"`
-        );
-      }
-      owners.set(s.id, c.owner);
-      sections.push(s);
-    }
-  }
-  return { ...base, identity, sections };
-}
+const mergePageCapture = mergeLiveCapture;
 function plainNamedRecord(rec) {
   return toPlainJson(rec);
 }
@@ -192,6 +174,7 @@ function envelopeContext(c) {
   return {
     page: c.title,
     "surface-kind": c.kind,
+    ...c.surfaceName ? { surface: c.surfaceName } : {},
     route: c.route,
     ...keyed(describeRecord(c.identity)),
     ...keyed(describeRecord(c.selection))

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

@@ -51,7 +51,7 @@ function WebpageFooter({ item }) {
   if (!url) return null;
   const copy = async () => {
     try {
-      await copyText(url);
+      if (!await copyText(url)) return;
       setCopied(true);
       setTimeout(() => setCopied(false), 1500);
     } catch {

package/dist/agents/components/context-preview/AttachedContextSection.js

@@ -32,7 +32,7 @@ import { setConversationDocumentEnabledThunk } from "../../redux/execution-syste
 import { setScratchpadGateThunk } from "../../redux/execution-system/instance-working-document/scratchpad.thunks.js";
 import { useActiveContextLayerItems } from "../context-items/useActiveContextLayerItems.js";
 import { docKindForContextKey } from "../../utils/workingDocumentContext.js";
-import { InlineCopyButton } from "../../../host/ui-slots.js";
+import { CopyButtons } from "../../../host/ui-slots.js";
 import { cn } from "@ai-matrx/design-system";
 import { contextEntryLabel } from "../context-policies-display/contextEntryLabel.js";
 const COPY_REVEAL = "opacity-0 transition-opacity pointer-coarse:opacity-100";
@@ -196,11 +196,12 @@ function AttachedContextSection({
             k
           )) }),
           /* @__PURE__ */ jsx(
-            InlineCopyButton,
+            CopyButtons,
             {
-              content: variables,
+              label: "Copy",
+              json: variables,
               size: "xs",
-              className: cn(COPY_REVEAL, "group-hover/vars:opacity-100")
+              className: cn("absolute top-1 right-1 z-10", COPY_REVEAL, "group-hover/vars:opacity-100")
             }
           )
         ] }),
@@ -285,12 +286,12 @@ function AttachedContextSection({
               /* @__PURE__ */ jsx("span", { className: "italic text-muted-foreground", children: "(empty \u2014 sent, but has no content yet)" })
             ) }),
             /* @__PURE__ */ jsx(
-              InlineCopyButton,
+              CopyButtons,
               {
-                content: item.preview,
-                formatJson: false,
+                label: "Copy",
+                human: item.preview,
                 size: "xs",
-                className: cn(COPY_REVEAL, "group-hover/entry:opacity-100")
+                className: cn("absolute top-1 right-1 z-10", COPY_REVEAL, "group-hover/entry:opacity-100")
               }
             )
           ] }, item.key);

package/dist/agents/components/context-preview/ContextCompareView.js

@@ -9,7 +9,7 @@ import { Skeleton } from "@ai-matrx/design-system";
 import { Badge, Button, Chip } from "@ai-matrx/design-system/controls";
 import { Textarea } from "@ai-matrx/design-system";
 import { Tabs, TabsContent, TabsList, TabsTrigger } from "../../../ui/tabs.js";
-import { InlineCopyButton } from "../../../host/ui-slots.js";
+import { CopyButtons } from "../../../host/ui-slots.js";
 import { RichContent } from "../../../host/ui-slots.js";
 import { SystemItemsLine } from "./SystemItemsLine.js";
 import { useAppDispatch, useAppSelector } from "../../../store/hooks.js";
@@ -109,12 +109,12 @@ function Block({
     ) : block ? /* @__PURE__ */ jsxs("div", { className: "group/block relative mt-1.5", children: [
       /* @__PURE__ */ jsx("pre", { "data-kind-source": "explicit", className: "whitespace-pre-wrap break-words rounded-md border border-border bg-muted/40 px-2.5 py-2 font-mono text-[11px] leading-relaxed text-foreground", children: block }),
       /* @__PURE__ */ jsx(
-        InlineCopyButton,
+        CopyButtons,
         {
-          content: block,
-          formatJson: false,
+          label: "Copy",
+          human: block,
           size: "sm",
-          className: "opacity-0 transition-opacity pointer-coarse:opacity-100 group-hover/block:opacity-100"
+          className: "absolute top-1 right-1 z-10 opacity-0 transition-opacity pointer-coarse:opacity-100 group-hover/block:opacity-100"
         }
       )
     ] }) : /* @__PURE__ */ jsx("div", { className: "mt-1.5 rounded-md border border-border bg-muted/30 px-2.5 py-2 text-xs italic text-muted-foreground", children: "No block \u2014 this side delivers no context for this selection." }),
@@ -141,12 +141,12 @@ function FedBlock({ label, text, slot }) {
     text ? /* @__PURE__ */ jsxs("div", { className: "group/block relative mt-1", children: [
       /* @__PURE__ */ jsx("pre", { "data-kind-source": "explicit", className: "max-h-[28rem] overflow-auto whitespace-pre-wrap break-words rounded-md border border-border bg-muted/40 px-2.5 py-2 font-mono text-[11px] leading-relaxed text-foreground", children: text }),
       /* @__PURE__ */ jsx(
-        InlineCopyButton,
+        CopyButtons,
         {
-          content: text,
-          formatJson: false,
+          label: "Copy",
+          human: text,
           size: "sm",
-          className: "opacity-0 transition-opacity pointer-coarse:opacity-100 group-hover/block:opacity-100"
+          className: "absolute top-1 right-1 z-10 opacity-0 transition-opacity pointer-coarse:opacity-100 group-hover/block:opacity-100"
         }
       )
     ] }) : /* @__PURE__ */ jsxs("p", { className: "mt-1 rounded-md border border-border bg-muted/30 px-2.5 py-2 text-xs italic text-muted-foreground", children: [
@@ -278,12 +278,12 @@ function JsonBlock({ label, value, slot }) {
     /* @__PURE__ */ jsxs("div", { className: "group/block relative mt-1", children: [
       /* @__PURE__ */ jsx("pre", { "data-kind-source": "explicit", className: "overflow-auto whitespace-pre-wrap break-all rounded-md border border-border bg-muted/40 px-2.5 py-2 font-mono text-[11px] leading-relaxed text-foreground", children: text }),
       /* @__PURE__ */ jsx(
-        InlineCopyButton,
+        CopyButtons,
         {
-          content: text,
-          formatJson: false,
+          label: "Copy",
+          human: text,
           size: "sm",
-          className: "opacity-0 transition-opacity pointer-coarse:opacity-100 group-hover/block:opacity-100"
+          className: "absolute top-1 right-1 z-10 opacity-0 transition-opacity pointer-coarse:opacity-100 group-hover/block:opacity-100"
         }
       )
     ] })

package/dist/agents/components/context-preview/ContextPreviewPanel.js

@@ -5,7 +5,7 @@ import { AlertTriangle, Braces, FileCode2, RefreshCw } from "lucide-react";
 import { cn } from "@ai-matrx/design-system";
 import { Skeleton } from "@ai-matrx/design-system";
 import { Badge, Button, Chip, SegmentedControl } from "@ai-matrx/design-system/controls";
-import { InlineCopyButton } from "../../../host/ui-slots.js";
+import { CopyButtons } from "../../../host/ui-slots.js";
 import { useAppSelector } from "../../../store/hooks.js";
 import { SurfaceRuntimeProvider } from "../../../surfaces/runtime/SurfaceRuntimeContext.js";
 import {
@@ -68,12 +68,12 @@ function VariableGroup({
         ] }),
         /* @__PURE__ */ jsx("div", { className: "mt-1 whitespace-pre-wrap break-words rounded bg-muted/40 px-2 py-1 font-mono text-[11px] leading-relaxed text-foreground/90", children: f.value || /* @__PURE__ */ jsx("span", { className: "italic text-muted-foreground", children: "(empty)" }) }),
         /* @__PURE__ */ jsx(
-          InlineCopyButton,
+          CopyButtons,
           {
-            content: f.value,
-            formatJson: false,
+            label: "Copy",
+            human: f.value,
             size: "xs",
-            className: "opacity-0 transition-opacity pointer-coarse:opacity-100 group-hover/var:opacity-100"
+            className: "absolute top-1 right-1 z-10 opacity-0 transition-opacity pointer-coarse:opacity-100 group-hover/var:opacity-100"
           }
         )
       ] }, key);
@@ -201,12 +201,12 @@ function ResolvedView({
           className: "relative h-7 w-7 shrink-0",
           title: "Copy everything the agent receives",
           children: /* @__PURE__ */ jsx(
-            InlineCopyButton,
+            CopyButtons,
             {
-              content: copyAllText,
-              formatJson: false,
+              label: "Copy all for AI",
+              human: copyAllText,
               size: "sm",
-              tooltipText: "Copy all for AI"
+              className: "absolute top-1 right-1 z-10"
             }
           )
         }
@@ -286,12 +286,12 @@ function ResolvedBody({
       block ? /* @__PURE__ */ jsxs("div", { className: "group/block relative mt-1.5", children: [
         /* @__PURE__ */ jsx("pre", { className: "whitespace-pre-wrap break-words rounded-md border border-primary/20 bg-muted/40 px-2.5 py-2 font-mono text-[11px] leading-relaxed text-foreground", children: block }),
         /* @__PURE__ */ jsx(
-          InlineCopyButton,
+          CopyButtons,
           {
-            content: block,
-            formatJson: false,
+            label: "Copy",
+            human: block,
             size: "sm",
-            className: "opacity-0 transition-opacity pointer-coarse:opacity-100 group-hover/block:opacity-100"
+            className: "absolute top-1 right-1 z-10 opacity-0 transition-opacity pointer-coarse:opacity-100 group-hover/block:opacity-100"
           }
         )
       ] }) : /* @__PURE__ */ jsx("div", { className: "mt-1.5 rounded-md border border-border bg-muted/30 px-2.5 py-2 text-xs italic text-muted-foreground", children: "No block would be injected \u2014 no organization or scopes active." }),

package/dist/agents/components/conversation-actions/conversation-verbs.js

@@ -1,4 +1,5 @@
 import { toast } from "../../../host/notify.js";
+import { copyToHostClipboard } from "../../../host/clipboard.js";
 import { toastDoor } from "../../../host/ui-slots.js";
 import { openOverlay, CHAT_WINDOWS } from "../../../host/windows.js";
 import {
@@ -23,12 +24,7 @@ function resolveAbsoluteHref(href) {
   return `${window.location.origin}${href.startsWith("/") ? href : `/${href}`}`;
 }
 async function copyConversationLink(href) {
-  try {
-    await navigator.clipboard.writeText(resolveAbsoluteHref(href));
-    toast.success("Link copied");
-  } catch {
-    toast.error("Couldn't copy \u2014 your browser blocked clipboard access");
-  }
+  await copyToHostClipboard(resolveAbsoluteHref(href), "Link copied");
 }
 function shareConversation(dispatch, conversationId, title) {
   dispatch(

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

@@ -50,7 +50,7 @@ function SandboxFileViewer({
   }, [initialPath, sandboxRowId, load]);
   const handleCopy = async () => {
     if (content == null) return;
-    await copyText(content);
+    if (!await copyText(content)) return;
     setCopied(true);
     toast.success("File contents copied");
     setTimeout(() => setCopied(false), 1500);

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

@@ -55,8 +55,8 @@ function useCopy() {
     notify: (message, kind) => kind === "error" ? toast.error(message) : toast.success(message)
   });
   const [copied, setCopied] = useState(null);
-  const copy = (text, id) => {
-    copyText(text);
+  const copy = async (text, id) => {
+    if (!await copyText(text)) return;
     setCopied(id);
     setTimeout(() => setCopied(null), 1500);
   };

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

@@ -68,7 +68,7 @@ function TranscriptIntegrityCopyButtonInner({
       effectiveVisibleGroupLimit
     });
     try {
-      await copyText(formatTranscriptIntegrityReport(report));
+      if (!await copyText(formatTranscriptIntegrityReport(report))) return;
       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.js

@@ -271,9 +271,9 @@ function BufferedObservationCard({
   const [copied, setCopied] = useState(false);
   const text = cycle.observations ?? "";
   const hasText = text.length > 0;
-  const handleCopy = useCallback(() => {
+  const handleCopy = useCallback(async () => {
     if (!hasText) return;
-    copyText(text);
+    if (!await copyText(text)) return;
     setCopied(true);
     setTimeout(() => setCopied(false), 1500);
   }, [text, hasText]);
@@ -508,9 +508,9 @@ function TextPayload({
   });
   const [copied, setCopied] = useState(false);
   const hasText = typeof text === "string" && text.length > 0;
-  const handleCopy = useCallback(() => {
+  const handleCopy = useCallback(async () => {
     if (!text) return;
-    copyText(text);
+    if (!await copyText(text)) return;
     setCopied(true);
     setTimeout(() => setCopied(false), 1500);
   }, [text]);

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

@@ -91,9 +91,9 @@ function DirectTestMode({
     close,
     conversationId
   ]);
-  const handleCopy = useCallback(() => {
+  const handleCopy = useCallback(async () => {
     if (responseText) {
-      copyText(kindTextToMarkdown(responseText));
+      if (!await copyText(kindTextToMarkdown(responseText))) return;
       setCopied(true);
       setTimeout(() => setCopied(false), 2e3);
     }

package/dist/agents/components/run-controls/PayloadTab.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 { Badge, Button } from "@ai-matrx/design-system/controls";
 import { useCallback, useMemo, useState } from "react";
 import { Copy, Check } from "lucide-react";
@@ -119,6 +121,9 @@ function roledImagesOf(messages) {
   return rows;
 }
 function PayloadTab({ conversationId }) {
+  const { copyText } = useClipboard({
+    notify: (message, kind) => kind === "error" ? toast.error(message) : toast.success(message)
+  });
   const assembledRequestSelector = useMemo(
     () => makeSelectAssembledRequest(conversationId),
     [conversationId]
@@ -163,7 +168,8 @@ function PayloadTab({ conversationId }) {
     if (!request) return;
     try {
       const text = JSON.stringify(request, null, 2);
-      void navigator.clipboard.writeText(text).then(() => {
+      void copyText(text).then((copied2) => {
+        if (!copied2) return;
         setCopied(true);
         window.setTimeout(() => setCopied(false), 1500);
       });

package/dist/agents/components/run-controls/panels/BackendTargetPanel.js

@@ -1,5 +1,7 @@
 "use client";
 import { jsx, jsxs } from "react/jsx-runtime";
+import { useClipboard } from "@ai-matrx/kit/clipboard";
+import { toast } from "../../../../host/notify.js";
 import { formatDurationSeconds } from "@ai-matrx/kit/format";
 import { useState } from "react";
 import { Copy, Check } from "lucide-react";
@@ -19,9 +21,13 @@ function CopyableValue({
   mono = true,
   className
 }) {
+  const { copyText } = useClipboard({
+    notify: (message, kind) => kind === "error" ? toast.error(message) : toast.success(message)
+  });
   const [copied, setCopied] = useState(false);
   const handleCopy = () => {
-    void navigator.clipboard.writeText(value).then(() => {
+    void copyText(value).then((copied2) => {
+      if (!copied2) return;
       setCopied(true);
       setTimeout(() => setCopied(false), 1200);
     });

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

@@ -2,7 +2,9 @@
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { Badge, Button } from "@ai-matrx/design-system/controls";
 import { useState } from "react";
-import { Save, Loader2, AlertTriangle, Eye } from "lucide-react";
+import { Save, Loader2, AlertTriangle, Eye, Undo2 } from "lucide-react";
+import { useAppDispatch } from "../../../store/hooks.js";
+import { resetAllAgentFields } from "../../redux/agent-definition/slice.js";
 import { useChatCanvasTab } from "../../../host/canvas.js";
 import { AGENT_UNSAVED_CHANGES_KIND } from "../../../host/canvas-tabs.js";
 import { cn } from "@ai-matrx/design-system";
@@ -41,7 +43,9 @@ function AgentSaveStatus({
     reachBadge,
     available
   } = useAgentSaveAction(agentId, { editModeOverride });
+  const dispatch = useAppDispatch();
   const [settingsOpen, setSettingsOpen] = useState(false);
+  const [confirmDiscardOpen, setConfirmDiscardOpen] = useState(false);
   const diffTab = useChatCanvasTab({ kind: AGENT_UNSAVED_CHANGES_KIND, key: agentId });
   const handleSelectModel = () => {
     setShowModelWarning(false);
@@ -67,6 +71,7 @@ function AgentSaveStatus({
       isEditMode && isDirty && /* @__PURE__ */ jsxs(Fragment, { children: [
         /* @__PURE__ */ jsx(Badge, { tone: "warning", children: isNewRoute ? "Not saved" : "Unsaved" }),
         /* @__PURE__ */ jsx(ErrorAlchemyMenu, {}),
+        !isNewRoute && /* @__PURE__ */ jsx(Button, { variant: "quiet", icon: /* @__PURE__ */ jsx(Undo2, {}), onClick: () => setConfirmDiscardOpen(true), disabled: isLoading, title: "Discard unsaved changes", "aria-label": "Discard unsaved changes" }),
         !isNewRoute && /* @__PURE__ */ jsx(Button, { variant: "quiet", pressed: diffTab.isVisible, icon: /* @__PURE__ */ jsx(Eye, {}), onClick: () => diffTab.toggle({ title: "Unsaved changes", data: { agentId } }), title: "View unsaved changes", "aria-label": "View unsaved changes" })
       ] }),
       isEditMode && /* @__PURE__ */ jsx(Button, { variant: "quiet", icon: isLoading ? /* @__PURE__ */ jsx(Loader2, { className: "animate-spin" }) : /* @__PURE__ */ jsx(Save, {}), onClick: handleSave, disabled: !canSave, title: isReadOnlySave ? "View only \u2014 create your copy to save changes" : isNewRoute ? "Save new agent" : isDirty ? "Save changes" : "No unsaved changes", "aria-label": isReadOnlySave ? "View only \u2014 create your copy to save changes" : isNewRoute ? "Save new agent" : isDirty ? "Save changes" : "No unsaved changes" }),
@@ -90,6 +95,22 @@ function AgentSaveStatus({
         /* @__PURE__ */ jsx(AlertDialogAction, { onClick: handleSelectModel, children: "Select a Model" })
       ] })
     ] }) }),
+    /* @__PURE__ */ jsx(AlertDialog, { open: confirmDiscardOpen, onOpenChange: setConfirmDiscardOpen, children: /* @__PURE__ */ jsxs(AlertDialogContent, { children: [
+      /* @__PURE__ */ jsxs(AlertDialogHeader, { children: [
+        /* @__PURE__ */ jsx(AlertDialogTitle, { children: "Discard unsaved changes?" }),
+        /* @__PURE__ */ jsx(AlertDialogDescription, { children: "The agent goes back to its last saved version." })
+      ] }),
+      /* @__PURE__ */ jsxs(AlertDialogFooter, { children: [
+        /* @__PURE__ */ jsx(AlertDialogCancel, { children: "Keep editing" }),
+        /* @__PURE__ */ jsx(
+          AlertDialogAction,
+          {
+            onClick: () => dispatch(resetAllAgentFields({ id: agentId })),
+            children: "Discard"
+          }
+        )
+      ] })
+    ] }) }),
     /* @__PURE__ */ jsx(
       AgentSettingsModal,
       {

package/dist/agents/hooks/useAgentAutoSave.js

@@ -8,7 +8,10 @@ import {
   selectAgentIsReadOnly,
   selectAgentAccessResolved
 } from "../redux/agent-definition/selectors.js";
-import { setAgentField } from "../redux/agent-definition/slice.js";
+import {
+  resetAllAgentFields,
+  setAgentField
+} from "../redux/agent-definition/slice.js";
 import { readField } from "@ai-matrx/agents/field-flags";
 import { toast } from "../../host/notify.js";
 const STORAGE_PREFIX = "agent-autosave:";
@@ -65,7 +68,16 @@ function useAgentAutoSave(agentId) {
     if (restored.length > 0) {
       restoredRef.current = true;
       toast.info(
-        `Restored unsaved changes to ${record.name || "this agent"} from this browser (${restored.join(", ")}). Save to keep them, or undo to discard.`
+        `Restored unsaved changes to ${record.name || "this agent"} from this browser (${restored.join(", ")}). Save to keep them, or discard them.`,
+        {
+          id: `agent-autosave-restored:${agentId}`,
+          duration: 2e4,
+          action: {
+            label: "Discard",
+            // Back to the saved agent; the clean-state effect drops the backup.
+            onClick: () => dispatch(resetAllAgentFields({ id: agentId }))
+          }
+        }
       );
     }
   }, [agentId, record, fetchStatus, dispatch]);

package/dist/agents/menu/agent-actions.js

@@ -1,6 +1,6 @@
 "use client";
 import { Cpu, Copy, RefreshCw, ExternalLink } from "lucide-react";
-import { toast } from "../../host/notify.js";
+import { copyToHostClipboard } from "../../host/clipboard.js";
 import {
   withAvailability
 } from "../../context-menu/utils/availability.js";
@@ -30,8 +30,7 @@ function buildAgentMenuSection({
         label: "Copy agent ID",
         icon: Copy,
         onSelect: () => {
-          void navigator.clipboard.writeText(agentId);
-          toast.success("Agent ID copied");
+          void copyToHostClipboard(agentId, "Agent ID copied");
         }
       },
       {
@@ -41,8 +40,7 @@ function buildAgentMenuSection({
         icon: Copy,
         disabled: !agentName,
         onSelect: () => {
-          void navigator.clipboard.writeText(agentName ?? "");
-          toast.success("Agent name copied");
+          void copyToHostClipboard(agentName ?? "", "Agent name copied");
         }
       },
       { kind: "separator", id: "agent-sep-1" },