@ai-matrx/chat 0.2.8 → 0.2.10

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @ai-matrx/chat
 
+## 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
 
 ALC-19: the one file-download door.

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

@@ -21,16 +21,6 @@ export interface ExportItem {
      */
     onSelect?: () => void | Promise<void>;
 }
-export declare function downloadFile(filename: string, content: BlobPart, mime: string): void;
-/**
- * Save a file that already has a URL (a data: or blob: URL, or a remote URL the browser may
- * download). Same-origin and data/blob URLs are saved under `filename`; a cross-origin remote
- * URL is handed to the browser, which may ignore the name. `newTab` opens it in a new tab
- * (noopener) as the cross-origin fallback.
- */
-export declare function downloadUrl(url: string, filename: string, options?: {
-    newTab?: boolean;
-}): void;
 /** Sanitized `base-2026-07-27.ext` filename. */
 export declare function exportFilename(base: string, extension: string): string;
 export declare function jsonExportItem(data: unknown | (() => unknown), label?: string): ExportItem;

package/dist/agent-copy/export.js

@@ -1,24 +1,3 @@
-function downloadFile(filename, content, mime) {
-  const blob = new Blob([content], { type: mime });
-  const url = URL.createObjectURL(blob);
-  clickDownloadAnchor(url, filename);
-  setTimeout(() => URL.revokeObjectURL(url), 1e3);
-}
-function downloadUrl(url, filename, options = {}) {
-  clickDownloadAnchor(url, filename, options.newTab);
-}
-function clickDownloadAnchor(href, filename, newTab = false) {
-  const anchor = document.createElement("a");
-  anchor.href = href;
-  anchor.download = filename;
-  if (newTab) {
-    anchor.target = "_blank";
-    anchor.rel = "noopener noreferrer";
-  }
-  document.body.appendChild(anchor);
-  anchor.click();
-  document.body.removeChild(anchor);
-}
 function exportFilename(base, extension) {
   const slug = base.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").slice(0, 60);
   const date = (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
@@ -90,8 +69,6 @@ function csvExportItem(rows, label = "CSV", columns) {
 }
 export {
   csvExportItem,
-  downloadFile,
-  downloadUrl,
   exportFilename,
   jsonExportItem,
   rowsToCsv,

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/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/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,7 @@ function PayloadTab({ conversationId }) {
     if (!request) return;
     try {
       const text = JSON.stringify(request, null, 2);
-      void navigator.clipboard.writeText(text).then(() => {
+      void copyText(text).then(() => {
         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,12 @@ 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(() => {
       setCopied(true);
       setTimeout(() => setCopied(false), 1200);
     });

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" },

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

@@ -333,6 +333,9 @@ const saveShortcutField = createAsyncThunk(
     dispatch(markShortcutSaved({ id: shortcutId }));
   }
 );
+function withGlobalShortcutAdminLane(request) {
+  return request.setHeader("x-matrx-admin-lane", "1");
+}
 const createShortcut = createAsyncThunk("agentShortcut/create", async (shortcutData, { dispatch, getState }) => {
   const userId = selectUserId(getState());
   const organizationId = await ensureOrgId(shortcutData.organizationId);
@@ -346,7 +349,9 @@ const createShortcut = createAsyncThunk("agentShortcut/create", async (shortcutD
     createdAt: "",
     updatedAt: ""
   };
-  const { data, error } = await shortcutTable(supabase).insert(agentShortcutToInsert(draft)).select().single();
+  const isGlobalWrite = shortcutData.userId === null && shortcutData.organizationId == null && shortcutData.projectId == null && shortcutData.taskId == null;
+  const insertRequest = shortcutTable(supabase).insert(agentShortcutToInsert(draft)).select().single();
+  const { data, error } = await (isGlobalWrite ? withGlobalShortcutAdminLane(insertRequest) : insertRequest);
   if (error) throw pgErrorToError(error);
   const newShortcut = toGlobalOwnershipRecord(
     dbRowToAgentShortcut(data),
@@ -392,13 +397,12 @@ const duplicateShortcut = createAsyncThunk("agentShortcut/duplicate", async (arg
 const promoteShortcutToGlobal = createAsyncThunk(
   "agentShortcut/promoteToGlobal",
   async ({ shortcutId, targetCategoryId, label }, { dispatch }) => {
-    const { data, error } = await supabase.rpc(
-      SHORTCUT_RPCS.promoteToGlobal,
-      {
+    const { data, error } = await withGlobalShortcutAdminLane(
+      supabase.rpc(SHORTCUT_RPCS.promoteToGlobal, {
         p_shortcut_id: shortcutId,
         p_target_category_id: targetCategoryId,
         p_label: label && label.trim().length > 0 ? label.trim() : void 0
-      }
+      })
     );
     if (error) throw pgErrorToError(error);
     const newShortcutId = data;

package/dist/agents/redux/execution-system/instance-resources/remarks.d.ts

@@ -159,6 +159,12 @@ export interface RemarkDurability {
 }
 /** True while some chip of this conversation has not yet been saved server-side. */
 export declare function hasPendingRemarkWrites(conversationId: string): boolean;
+/**
+ * True once the app has registered how unsent chips are kept. Without it every
+ * chip is browser-only and lost on reload, so a missing port is announced, never
+ * silently stood in for (the door a person touches must say when it is not wired).
+ */
+export declare function isRemarkDurabilityRegistered(): boolean;
 /** Save every pending chip write and wait for its row/ref (called before a send). */
 export declare function flushRemarkWrites(conversationId: string): Promise<void>;
 /** Put a conversation's unsent chips back (any device) — the composer calls this once on mount. */

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

@@ -72,10 +72,23 @@ function buildSource(item, coalesceKey) {
 function hasPendingRemarkWrites(conversationId) {
   return durability?.hasPending(conversationId) ?? false;
 }
+function isRemarkDurabilityRegistered() {
+  return durability !== null;
+}
+const announcedMissing = /* @__PURE__ */ new Set();
+function announceMissingDurability(op) {
+  if (announcedMissing.has(op)) return;
+  announcedMissing.add(op);
+  console.error(
+    `[remarks] ${op} ran with no durability port registered: unsent chips are NOT kept server-side. The app must call registerRemarkDurability (providers/ChatSurfaceRegistrations).`
+  );
+}
 async function flushRemarkWrites(conversationId) {
+  if (!durability) announceMissingDurability("flush");
   await durability?.flush(conversationId);
 }
 function restoreComposerRemarks(conversationId) {
+  if (!durability) announceMissingDurability("restore");
   durability?.restore(conversationId);
 }
 let durability = null;
@@ -100,6 +113,7 @@ function stageRemark(conversationId, item, options = {}) {
         dispatch(setResourceSource({ conversationId, resourceId: live.resourceId, source }));
         dispatch(setResourcePreview({ conversationId, resourceId: live.resourceId, preview: source.label }));
         if (!options.fromServer && !item.blockStateRef) {
+          if (!durability) announceMissingDurability("save");
           durability?.save(conversationId, live.resourceId, coalesceKey, item);
         }
         return live.resourceId;
@@ -110,6 +124,7 @@ function stageRemark(conversationId, item, options = {}) {
     dispatch(addResource({ conversationId, blockType: REMARKS_BLOCK_TYPE, source, resourceId }));
     dispatch(setResourcePreview({ conversationId, resourceId, preview: source.label }));
     if (!options.fromServer && !item.blockStateRef) {
+      if (!durability) announceMissingDurability("save");
       durability?.save(conversationId, resourceId, coalesceKey, item);
     }
     return resourceId;
@@ -205,6 +220,7 @@ export {
   dismissRemarkChip,
   flushRemarkWrites,
   hasPendingRemarkWrites,
+  isRemarkDurabilityRegistered,
   readStoredRemarks,
   registerRemarkDurability,
   remarkChipTitle,

package/dist/agents/redux/execution-system/instance-ui-state/components/InstanceUIStateCore.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 { Badge, Button, Tile } from "@ai-matrx/design-system/controls";
 import { useState } from "react";
 import { cn } from "@ai-matrx/design-system";
@@ -18,9 +20,12 @@ import {
   selectInstanceTitle
 } from "../instance-ui-state.selectors.js";
 function useCopyText(text) {
+  const { copyText } = useClipboard({
+    notify: (message, kind) => kind === "error" ? toast.error(message) : toast.success(message)
+  });
   const [copied, setCopied] = useState(false);
   const copy = () => {
-    navigator.clipboard.writeText(text).then(() => {
+    copyText(text).then(() => {
       setCopied(true);
       setTimeout(() => setCopied(false), 1500);
     });

package/dist/agents/redux/execution-system/instance-ui-state/components/InstanceUIStateList.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 { useState } from "react";
 import { cn } from "@ai-matrx/design-system";
 import {
@@ -19,9 +21,12 @@ import {
 } from "../instance-ui-state.selectors.js";
 import { Button } from "@ai-matrx/design-system/controls";
 function useCopyText(text) {
+  const { copyText } = useClipboard({
+    notify: (message, kind) => kind === "error" ? toast.error(message) : toast.success(message)
+  });
   const [copied, setCopied] = useState(false);
   const copy = () => {
-    navigator.clipboard.writeText(text).then(() => {
+    copyText(text).then(() => {
       setCopied(true);
       setTimeout(() => setCopied(false), 1500);
     });

package/dist/agents/redux/execution-system/message-crud/commit-inline-edit.thunk.js

@@ -6,6 +6,7 @@ import { updateMessageRecord } from "../messages/messages.slice.js";
 import { saveAnswerEdit } from "./save-answer-edit.thunk.js";
 import { refetchSingleMessage } from "./refetch-single-message.thunk.js";
 import { toast } from "../../../../host/notify.js";
+import { copyToHostClipboard } from "../../../../host/clipboard.js";
 import { buildContentBlocksForSave } from "../../../../cx-chat/utils/buildContentBlocksForSave.js";
 import { stripCitationMarkers } from "../messages/message-citations.js";
 import { extractFlatText } from "../messages/messages.selectors.js";
@@ -97,7 +98,7 @@ async function persistInlineEdit(dispatch, conversationId, messageId, entry) {
     action: {
       label: "Copy my edit",
       onClick: () => {
-        void navigator.clipboard?.writeText(draft);
+        void copyToHostClipboard(draft);
       }
     }
   });

package/dist/canvas/workspace/useCanvasWorkspaceConversation.d.ts

@@ -62,6 +62,18 @@ export declare function conversationInAddress(param: string, search: string): st
 export declare function workspaceChatMemoryKey(surfaceKey: string): string;
 export declare function recallWorkspaceConversation(surfaceKey: string): string | null;
 export declare function rememberWorkspaceConversation(surfaceKey: string, conversationId: string | null): void;
+/**
+ * THE RESERVED ID OF AN UNSENT CHAT (2026-10-06). A new chat that has not been
+ * sent is unknown to the server, so a reload cannot reopen it and used to mint a
+ * different id — which orphaned every chip staged into it (a comment riding
+ * "with next message" came back gone). The id is reserved on this device per
+ * home and handed to the launch, so the unsent chat comes back under the SAME id
+ * and its saved chips are found. Released when the server has the conversation
+ * (the memory above takes over) and by New chat (a new chat is a new id).
+ */
+export declare function reservedChatKey(surfaceKey: string): string;
+export declare function reserveWorkspaceConversationId(surfaceKey: string, fresh: boolean): string | undefined;
+export declare function releaseWorkspaceConversationId(surfaceKey: string): void;
 /** `search` with `?<param>=` set to `conversationId`, or removed when null. */
 export declare function addressWithConversation(param: string, search: string, conversationId: string | null): string;
 export interface CanvasWorkspaceConversationController {

package/dist/canvas/workspace/useCanvasWorkspaceConversation.js

@@ -39,6 +39,27 @@ function rememberWorkspaceConversation(surfaceKey, conversationId) {
   } catch {
   }
 }
+function reservedChatKey(surfaceKey) {
+  return `matrx:workspace-chat-reserved:${surfaceKey}`;
+}
+function reserveWorkspaceConversationId(surfaceKey, fresh) {
+  try {
+    const key = reservedChatKey(surfaceKey);
+    const kept = fresh ? null : window.localStorage.getItem(key);
+    if (kept && CONVERSATION_ID.test(kept)) return kept;
+    const id = window.crypto.randomUUID();
+    window.localStorage.setItem(key, id);
+    return id;
+  } catch {
+    return void 0;
+  }
+}
+function releaseWorkspaceConversationId(surfaceKey) {
+  try {
+    window.localStorage.removeItem(reservedChatKey(surfaceKey));
+  } catch {
+  }
+}
 function addressWithConversation(param, search, conversationId) {
   const params = new URLSearchParams(search);
   if (conversationId) params.set(param, conversationId);
@@ -99,6 +120,7 @@ function useCanvasWorkspaceConversation(surfaceKey, input) {
     if (addressParam === null || !addressRead || !conversationId) return;
     const shown = request.kind === "open" || serverHasIt ? conversationId : null;
     rememberWorkspaceConversation(surfaceKey, shown);
+    if (shown) releaseWorkspaceConversationId(surfaceKey);
     const search = addressWithConversation(addressParam, window.location.search, shown);
     if (search === window.location.search) return;
     replaceAddressWithoutNavigating(`${window.location.pathname}${search}${window.location.hash}`);
@@ -111,8 +133,11 @@ function useCanvasWorkspaceConversation(surfaceKey, input) {
     const stale = () => handled.current !== key;
     if (request.kind === "new" || request.kind === "agent") {
       const runtime = ownSurface ? { runtime: { surfaceName: null } } : {};
-      const launch = request.kind === "agent" ? launchAgent(request.agentId, { surfaceKey, sourceFeature: "chat", ...runtime }) : launchMandate(request.mandateKey ?? DEFAULT_NEW_CHAT_MANDATE_KEY, {
+      const reserved = addressParam !== null ? reserveWorkspaceConversationId(surfaceKey, request.nonce > 0) : void 0;
+      const reservation = reserved ? { conversationId: reserved } : {};
+      const launch = request.kind === "agent" ? launchAgent(request.agentId, { surfaceKey, sourceFeature: "chat", ...reservation, ...runtime }) : launchMandate(request.mandateKey ?? DEFAULT_NEW_CHAT_MANDATE_KEY, {
         surfaceKey,
+        ...reservation,
         // A REGISTERED feature, never a new string: this surface IS the chat.
         sourceFeature: "chat",
         ...runtime
@@ -193,7 +218,10 @@ export {
   addressWithConversation,
   conversationInAddress,
   recallWorkspaceConversation,
+  releaseWorkspaceConversationId,
   rememberWorkspaceConversation,
+  reserveWorkspaceConversationId,
+  reservedChatKey,
   useCanvasWorkspaceConversation,
   workspaceChatMemoryKey
 };

package/dist/context-menu/types.d.ts

@@ -4,6 +4,7 @@ import type { SourceFeature } from "../agents/types/instance.types.js";
 import type { Scope } from "../agents/redux/shared/scope.js";
 import type { ApplicationScope } from "../agents/types/scope.types.js";
 import type { EntityTypeToken } from "@ai-matrx/associations";
+import type { ResolvedItem } from "@ai-matrx/alchemy/declare";
 /**
  * The few shapes the host owns (the rich document's content source and actions, the sharing
  * system's resource types). The package declares them open; the host fills them in by augmenting
@@ -399,6 +400,12 @@ export interface MenuContentProps {
     variant: MenuVariant;
     /** The clicked target's own name for the header (`CONTEXT_MENU_HEADING_KEY`). */
     heading?: ContextMenuHeading | null;
+    /**
+     * The declared item the menu opened on (a table row: `table_row`, identity `table_id` + `row_id`),
+     * raw-free, as `itemSources` resolved it. It becomes the click target's `item`, so Actions and
+     * menu rows read the declared item instead of re-deriving it. Null = not on an item.
+     */
+    item?: ResolvedItem | null;
     sourceFeature: SourceFeature;
     surfaceName?: string;
     menuVersion: number;

package/dist/cx-chat/components/messages/AssistantMessage.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 { recognizeOurFileUrl } from "@ai-matrx/media/files/engine";
 import { useState, useEffect, useCallback } from "react";
 import {
@@ -22,6 +24,7 @@ import { chatConversationsActions } from "../../_legacy-stubs.js";
 import { RichDocumentActions } from "../../../host/rich-document-slots.js";
 import { MessageTimestamp } from "../../../agents/components/messages-display/MessageTimestamp.js";
 import { ErrorAlchemyMenu } from "../../../host/ui-slots.js";
+import { downloadFile } from "@ai-matrx/kit/download";
 function AssistantMessage({
   message,
   sessionId,
@@ -31,6 +34,9 @@ function AssistantMessage({
   isTtsRequest = false,
   onContentChange
 }) {
+  const { copyText } = useClipboard({
+    notify: (message2, kind) => kind === "error" ? toast.error(message2) : toast.success(message2)
+  });
   const [isAppearing, setIsAppearing] = useState(true);
   const [isAudioLinkCopied, setIsAudioLinkCopied] = useState(false);
   const [isDownloading, setIsDownloading] = useState(false);
@@ -97,15 +103,8 @@ function AssistantMessage({
     try {
       const resp = await fetch(audioUrl);
       const blob = await resp.blob();
-      const objectUrl = URL.createObjectURL(blob);
       const ext = audioMimeType?.split("/")[1] ?? "wav";
-      const link = document.createElement("a");
-      link.href = objectUrl;
-      link.download = `audio-response.${ext}`;
-      document.body.appendChild(link);
-      link.click();
-      document.body.removeChild(link);
-      URL.revokeObjectURL(objectUrl);
+      downloadFile(`audio-response.${ext}`, blob, blob.type);
     } catch {
     } finally {
       setIsDownloading(false);
@@ -186,8 +185,7 @@ function AssistantMessage({
                 variant: "quiet",
                 onClick: async () => {
                   if (!audioUrl) return;
-                  await navigator.clipboard.writeText(audioUrl).catch(() => {
-                  });
+                  await copyText(audioUrl);
                   setIsAudioLinkCopied(true);
                   setTimeout(() => setIsAudioLinkCopied(false), 2e3);
                 },

package/dist/cx-chat/components/messages/UserMessage.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 { useState, useEffect, useRef, useMemo } from "react";
 import {
   Check,
@@ -84,6 +86,9 @@ function UserMessage({
   onContentChange,
   compact = false
 }) {
+  const { copyText } = useClipboard({
+    notify: (message2, kind) => kind === "error" ? toast.error(message2) : toast.success(message2)
+  });
   const [isCollapsed, setIsCollapsed] = useState(true);
   const [isCopied, setIsCopied] = useState(false);
   const [shouldBeCollapsible, setShouldBeCollapsible] = useState(false);
@@ -130,7 +135,7 @@ function UserMessage({
   }, [isEditing]);
   const handleCopy = (e) => {
     e.stopPropagation();
-    navigator.clipboard.writeText(message.content).then(() => {
+    copyText(message.content).then(() => {
       setIsCopied(true);
       setTimeout(() => setIsCopied(false), 2e3);
     });

package/dist/cx-conversation/AssistantMessage.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 { recognizeOurFileUrl } from "@ai-matrx/media/files/engine";
 import { useState, useEffect, useCallback } from "react";
 import {
@@ -22,6 +24,7 @@ import { chatConversationsActions } from "./_legacy-stubs.js";
 import { RichDocumentActions } from "../host/rich-document-slots.js";
 import { MessageTimestamp } from "../agents/components/messages-display/MessageTimestamp.js";
 import { ErrorAlchemyMenu } from "../host/ui-slots.js";
+import { downloadFile } from "@ai-matrx/kit/download";
 function AssistantMessage({
   message,
   sessionId,
@@ -31,6 +34,9 @@ function AssistantMessage({
   isTtsRequest = false,
   onContentChange
 }) {
+  const { copyText } = useClipboard({
+    notify: (message2, kind) => kind === "error" ? toast.error(message2) : toast.success(message2)
+  });
   const [isAppearing, setIsAppearing] = useState(true);
   const [isAudioLinkCopied, setIsAudioLinkCopied] = useState(false);
   const [isDownloading, setIsDownloading] = useState(false);
@@ -97,15 +103,8 @@ function AssistantMessage({
     try {
       const resp = await fetch(audioUrl);
       const blob = await resp.blob();
-      const objectUrl = URL.createObjectURL(blob);
       const ext = audioMimeType?.split("/")[1] ?? "wav";
-      const link = document.createElement("a");
-      link.href = objectUrl;
-      link.download = `audio-response.${ext}`;
-      document.body.appendChild(link);
-      link.click();
-      document.body.removeChild(link);
-      URL.revokeObjectURL(objectUrl);
+      downloadFile(`audio-response.${ext}`, blob, blob.type);
     } catch {
     } finally {
       setIsDownloading(false);
@@ -186,8 +185,7 @@ function AssistantMessage({
                 variant: "quiet",
                 onClick: async () => {
                   if (!audioUrl) return;
-                  await navigator.clipboard.writeText(audioUrl).catch(() => {
-                  });
+                  await copyText(audioUrl);
                   setIsAudioLinkCopied(true);
                   setTimeout(() => setIsAudioLinkCopied(false), 2e3);
                 },

package/dist/cx-conversation/UserMessage.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 { useState, useEffect, useRef, useMemo } from "react";
 import {
   Check,
@@ -84,6 +86,9 @@ function UserMessage({
   onContentChange,
   compact = false
 }) {
+  const { copyText } = useClipboard({
+    notify: (message2, kind) => kind === "error" ? toast.error(message2) : toast.success(message2)
+  });
   const [isCollapsed, setIsCollapsed] = useState(true);
   const [isCopied, setIsCopied] = useState(false);
   const [shouldBeCollapsible, setShouldBeCollapsible] = useState(false);
@@ -130,7 +135,7 @@ function UserMessage({
   }, [isEditing]);
   const handleCopy = (e) => {
     e.stopPropagation();
-    navigator.clipboard.writeText(message.content).then(() => {
+    copyText(message.content).then(() => {
       setIsCopied(true);
       setTimeout(() => setIsCopied(false), 2e3);
     });

package/dist/host/clipboard.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The clipboard seam — plain-text copy for package code outside a React component.
+ *
+ * The kit `copyText` with its success and failure notices routed through the notify seam, so a
+ * refused copy always announces itself. Resolves to whether the copy landed.
+ */
+export declare function copyToHostClipboard(text: string, successMessage?: string): Promise<boolean>;

package/dist/host/clipboard.js

@@ -0,0 +1,11 @@
+import { copyText } from "@ai-matrx/kit/clipboard";
+import { toast } from "./notify.js";
+function copyToHostClipboard(text, successMessage) {
+  return copyText(text, {
+    successMessage,
+    notify: (message, kind) => kind === "error" ? toast.error(message) : toast.success(message)
+  });
+}
+export {
+  copyToHostClipboard
+};

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

@@ -317,12 +317,10 @@ export interface ChatUiSlots {
     dispatchWarRoomTool: AnyFn;
     dispatchWarRoomMasterTool: AnyFn;
     resolveGmailSendConnection: AnyFn;
-    voiceDisplayName: AnyFn;
     canvasGetVersionHistory: (canvasId: string) => Promise<CanvasItemRow[]>;
     canvasGetById: (canvasId: string) => Promise<CanvasItemRow | null>;
     createSandboxFilesystemAdapter: AnyFn;
     notesGetById: AnyFn;
-    isLiveConversationVoice: AnyFn;
     createHtmlPage: AnyFn;
     convertMarkdownToHtml: AnyFn;
     sklActions: Record<string, AnyFn>;
@@ -338,7 +336,6 @@ export interface ChatUiSlots {
     WorkspaceGate: AnyComponent;
     OrganizationContextNotice: AnyComponent;
     JsonInspector: AnyComponent;
-    InlineCopyButton: AnyComponent;
     ConfirmDialog: SlotComponent<OpenChangeProps>;
     ModelListDropdown: SlotComponent<ModelListDropdownProps>;
     TextWithDoors: AnyComponent;
@@ -357,6 +354,7 @@ export interface ChatUiSlots {
     AccessGate: AnyComponent;
     ReferenceCopyMenuItem: AnyComponent;
     ReferenceCopyButton: AnyComponent;
+    InlineCopyButton: AnyComponent;
     MandateNotesPanel: AnyComponent;
     SurfaceBoundAgentsList: SlotComponent<AgentsListProps>;
     ProposedDirectivesZone: AnyComponent;
@@ -604,7 +602,6 @@ export declare const StaleDataNotice: AnyComponent;
 export declare const WorkspaceGate: AnyComponent;
 export declare const OrganizationContextNotice: AnyComponent;
 export declare const JsonInspector: AnyComponent;
-export declare const InlineCopyButton: AnyComponent;
 export declare const ConfirmDialog: SlotComponent<OpenChangeProps>;
 export declare const ModelListDropdown: SlotComponent<ModelListDropdownProps>;
 export declare const TextWithDoors: AnyComponent;
@@ -623,6 +620,7 @@ export declare const AnswerTextPreview: AnyComponent;
 export declare const AccessGate: AnyComponent;
 export declare const ReferenceCopyMenuItem: AnyComponent;
 export declare const ReferenceCopyButton: AnyComponent;
+export declare const InlineCopyButton: AnyComponent;
 export declare const MandateNotesPanel: AnyComponent;
 export declare const SurfaceBoundAgentsList: SlotComponent<AgentsListProps>;
 export declare const ProposedDirectivesZone: AnyComponent;
@@ -712,12 +710,10 @@ export declare const adoptCloudBrowserRunFromStream: AnyFn;
 export declare const dispatchWarRoomTool: AnyFn;
 export declare const dispatchWarRoomMasterTool: AnyFn;
 export declare const resolveGmailSendConnection: AnyFn;
-export declare const voiceDisplayName: AnyFn;
 export declare const canvasGetVersionHistory: (canvasId: string) => Promise<CanvasItemRow[]>;
 export declare const canvasGetById: (canvasId: string) => Promise<CanvasItemRow | null>;
 export declare const createSandboxFilesystemAdapter: AnyFn;
 export declare const notesGetById: AnyFn;
-export declare const isLiveConversationVoice: AnyFn;
 export declare const createHtmlPage: AnyFn;
 export declare const convertMarkdownToHtml: AnyFn;
 /** The host's skill-library action creators (`sklActions.x(...)`); resolved at call time, a bare host throws naming the slot. */

package/dist/host/ui-slots.js

@@ -4,6 +4,7 @@ import { formatCost, usdToPoints } from "@ai-matrx/kit/format";
 import { reportUnregisteredHostSlot as reportUnregistered } from "./diagnostics.js";
 import { DefaultWebpageSnapshotView } from "./defaults/webpage-snapshot-view.js";
 import { DefaultFullScreenOverlay, DefaultWindowPanel } from "./defaults/window-panel.js";
+import { copyText } from "@ai-matrx/kit/clipboard";
 const slots = {};
 function registerChatUi(next) {
   Object.assign(slots, next);
@@ -68,14 +69,7 @@ const failingThunk = (name) => () => () => {
 const STAND_INS = {
   confirm: async () => false,
   copyRichContent: async () => false,
-  copyToClipboard: async (text) => {
-    try {
-      await navigator.clipboard.writeText(String(text));
-      return true;
-    } catch {
-      return false;
-    }
-  },
+  copyToClipboard: (text) => copyText(String(text)),
   useTablesEverywhere: () => NONE,
   useCenterControlFit: () => true,
   connectorDefinitionFromMcp: () => null,
@@ -327,7 +321,6 @@ const StaleDataNotice = slotComponent("StaleDataNotice", unregisteredWidget("Sta
 const WorkspaceGate = slotComponent("WorkspaceGate", unregisteredWidget("WorkspaceGate"));
 const OrganizationContextNotice = slotComponent("OrganizationContextNotice", unregisteredWidget("OrganizationContextNotice"));
 const JsonInspector = slotComponent("JsonInspector", unregisteredWidget("JsonInspector"));
-const InlineCopyButton = slotComponent("InlineCopyButton", unregisteredWidget("InlineCopyButton"));
 const ConfirmDialog = slotComponent("ConfirmDialog", unregisteredWidget("ConfirmDialog"));
 const ModelListDropdown = slotComponent("ModelListDropdown", unregisteredWidget("ModelListDropdown"));
 const TextWithDoors = slotComponent("TextWithDoors", unregisteredWidget("TextWithDoors"));
@@ -346,6 +339,7 @@ const AnswerTextPreview = slotComponent("AnswerTextPreview", unregisteredWidget(
 const AccessGate = slotComponent("AccessGate", unregisteredWidget("AccessGate"));
 const ReferenceCopyMenuItem = slotComponent("ReferenceCopyMenuItem", unregisteredWidget("ReferenceCopyMenuItem"));
 const ReferenceCopyButton = slotComponent("ReferenceCopyButton", unregisteredWidget("ReferenceCopyButton"));
+const InlineCopyButton = slotComponent("InlineCopyButton", unregisteredWidget("InlineCopyButton"));
 const MandateNotesPanel = slotComponent("MandateNotesPanel", unregisteredWidget("MandateNotesPanel"));
 const SurfaceBoundAgentsList = slotComponent("SurfaceBoundAgentsList", unregisteredWidget("SurfaceBoundAgentsList"));
 const ProposedDirectivesZone = slotComponent("ProposedDirectivesZone", unregisteredWidget("ProposedDirectivesZone"));
@@ -417,12 +411,10 @@ const adoptCloudBrowserRunFromStream = slotFn("adoptCloudBrowserRunFromStream");
 const dispatchWarRoomTool = slotFn("dispatchWarRoomTool");
 const dispatchWarRoomMasterTool = slotFn("dispatchWarRoomMasterTool");
 const resolveGmailSendConnection = slotFn("resolveGmailSendConnection");
-const voiceDisplayName = slotFn("voiceDisplayName", (_set, id) => id);
 const canvasGetVersionHistory = slotFn("canvasGetVersionHistory");
 const canvasGetById = slotFn("canvasGetById");
 const createSandboxFilesystemAdapter = slotFn("createSandboxFilesystemAdapter");
 const notesGetById = slotFn("notesGetById");
-const isLiveConversationVoice = slotFn("isLiveConversationVoice", () => false);
 const createHtmlPage = slotFn("createHtmlPage");
 const convertMarkdownToHtml = slotFn("convertMarkdownToHtml");
 const sklActions = new Proxy({}, { get: (_t, prop) => (...args) => {
@@ -668,7 +660,6 @@ export {
   humanLines,
   invalidateCanvasItemCache,
   invalidateMandateCatalogueCache,
-  isLiveConversationVoice,
   isSkillStreamEvent,
   isUuidValue,
   isWarRoomThreadAgentSurface,
@@ -771,6 +762,5 @@ export {
   useSkills,
   useTablesEverywhere,
   useTextareaFormatting,
-  useUrlSync,
-  voiceDisplayName
+  useUrlSync
 };

package/dist/public-chat/components/PublicMessageOptionsMenu.js

@@ -29,6 +29,7 @@ import { openOverlay, CHAT_WINDOWS } from "../../host/windows.js";
 import { kindTextToMarkdown } from "../../utils/content-ir/surfaces/kind-text-to-markdown.js";
 import { removeCodeSpans, replaceFences } from "@ai-matrx/content-ir/source";
 import { selectOrganizationId, ensureOrganizationContext, isOrganizationSelectionCancelled } from "../../host/org.js";
+import { downloadFile } from "@ai-matrx/kit/download";
 const PENDING_ACTION_KEY = "matrx_pending_post_auth_action";
 const PublicMessageOptionsMenu = ({
   content: answerContent,
@@ -248,15 +249,7 @@ const PublicMessageOptionsMenu = ({
   };
   const handleSaveAsFile = () => {
     const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, 19);
-    const blob = new Blob([content], { type: "text/markdown;charset=utf-8" });
-    const url = URL.createObjectURL(blob);
-    const link = document.createElement("a");
-    link.href = url;
-    link.download = `ai-response-${timestamp}.md`;
-    document.body.appendChild(link);
-    link.click();
-    document.body.removeChild(link);
-    URL.revokeObjectURL(url);
+    downloadFile(`ai-response-${timestamp}.md`, content, "text/markdown;charset=utf-8");
     onClose();
   };
   const handleEmailToMe = async () => {

package/dist/store/create-chat-store.d.ts

@@ -1,5 +1,14 @@
+import { type FilesHost } from "@ai-matrx/media/files/engine";
 import type { ChatState } from "./state.js";
-export declare function createChatStore(preloadedState?: Partial<ChatState>): import("@reduxjs/toolkit").EnhancedStore<{
+export interface CreateChatStoreOptions {
+    /**
+     * The files engine's host (database, server client, optional scope/org/share/notify) for a
+     * host that has not called `configureFilesHost` itself. The engine is then wired to THIS
+     * store, so file thunks read and write the slice chat renders from.
+     */
+    files?: Omit<FilesHost, "store">;
+}
+export declare function createChatStore(preloadedState?: Partial<ChatState>, options?: CreateChatStoreOptions): import("@reduxjs/toolkit").EnhancedStore<{
     voiceAgent: import("../voice-agent/types.js").VoiceAgentState;
     agentDefinition: import("../agents/types/agent-definition.types.js").AgentDefinitionSliceState;
     conversationList: import("../agents/redux/conversation-list/conversation-list.types.js").ConversationListState;

package/dist/store/create-chat-store.js

@@ -4,12 +4,13 @@ import { fork } from "redux-saga/effects";
 import {
   cloudFilesMutationToastMiddleware,
   cloudFilesRealtimeMiddleware,
-  cloudFilesReducer
+  cloudFilesReducer,
+  configureFilesHost
 } from "@ai-matrx/media/files/engine";
 import { chatReducers } from "./slices.js";
 import { chatMiddlewares } from "./middlewares.js";
 import { chatSagas } from "./sagas.js";
-function createChatStore(preloadedState) {
+function createChatStore(preloadedState, options = {}) {
   const sagaMiddleware = createSagaMiddleware();
   const store = configureStore({
     // Files are part of chat (P16f): the files engine's slice and its two middlewares come
@@ -30,6 +31,7 @@ function createChatStore(preloadedState) {
     ),
     devTools: process.env.NODE_ENV !== "production"
   });
+  if (options.files) configureFilesHost({ ...options.files, store: () => store });
   sagaMiddleware.run(function* chatRootSaga() {
     for (const saga of chatSagas()) yield fork(saga);
   });

package/dist/surfaces/runtime/SurfaceRuntimeContext.d.ts

@@ -1,3 +1,4 @@
+import { type LiveValuesStore } from "@ai-matrx/alchemy/surface";
 import { type ReactNode } from "react";
 import type { SurfaceScopePayload } from "../types.js";
 import type { InstanceContextEntry } from "../../agents/types/instance.types.js";
@@ -198,6 +199,15 @@ export interface SurfaceRegistry {
     /** Called after every registration change. */
     subscribe: (listener: () => void) => () => void;
 }
+/**
+ * THE PAGE'S LIVE VALUES REACH THE AGENT (ALC-18). A value the surface DECLARES that its runtime
+ * and contributions left unset is answered from the page's live capture (`@ai-matrx/alchemy/surface`
+ * `liveValues`: identity, selection, sections), only while the publishing page IS this surface —
+ * the same rule as `createSurfacePort({ live })`'s `getValue`. A supplied value always wins, and an
+ * undeclared live name (the request log, a section nobody declared) never rides along. Every reader
+ * of `getScope()` — the send path's context entries, the context window, write-back — gets it.
+ */
+export declare function withLiveValues(surfaceName: string, loaded: SurfaceScopePayload, live?: LiveValuesStore): SurfaceScopePayload;
 /**
  * The hosts `surfaceName` was mounted inside earlier in this page session
  * that are STILL mounted, deepest first. Empty when `surfaceName` itself is

package/dist/surfaces/runtime/SurfaceRuntimeContext.js

@@ -1,6 +1,8 @@
 "use client";
 import { jsx } from "react/jsx-runtime";
 import { announceUndeclaredLoadedValues } from "./loaded-value-check.js";
+import { liveValueOf, liveValues } from "@ai-matrx/alchemy/surface";
+import { getManifest } from "./registry.js";
 import {
   createContext,
   useCallback,
@@ -15,6 +17,25 @@ import {
   useAlchemySurfaceHandle
 } from "../../agent-copy/AlchemySurfaceBridge.js";
 let nextId = 0;
+function withLiveValues(surfaceName, loaded, live = liveValues) {
+  const declared = getManifest(surfaceName)?.values ?? [];
+  const missing = declared.filter((v) => !(v.name in loaded));
+  if (missing.length === 0) return loaded;
+  let capture;
+  try {
+    capture = live.readFor(surfaceName);
+  } catch (err) {
+    console.error(`[surfaces] the live values of "${surfaceName}" could not be read`, err);
+    return loaded;
+  }
+  if (!capture) return loaded;
+  const filled = { ...loaded };
+  for (const v of missing) {
+    const value = liveValueOf(capture, v.name);
+    if (value !== void 0) filled[v.name] = value;
+  }
+  return filled;
+}
 function createRegistry(kind, onRegister) {
   let stack = [];
   const listeners = /* @__PURE__ */ new Set();
@@ -70,7 +91,7 @@ function createRegistry(kind, onRegister) {
       }
       const loaded = { ...own, ...contributed };
       announceUndeclaredLoadedValues(surfaceName, loaded);
-      return loaded;
+      return withLiveValues(surfaceName, loaded);
     };
     return () => {
       const own = getScope();
@@ -531,5 +552,6 @@ export {
   waitForCapturedRuntime,
   wasPageOwnConversationOf,
   wasSurfaceMountedThisSession,
+  withLiveValues,
   withScopeContributions
 };

package/dist/tool-call-visualization/components/ToolTabBodies.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 { resultToHuman } from "../utils/human-copy.js";
 import React, { useState } from "react";
 import { useToolConversationId } from "./ToolConversationContext.js";
@@ -33,18 +35,12 @@ const CopyButton = ({
   text,
   className
 }) => {
+  const { copyText } = useClipboard({
+    notify: (message, kind) => kind === "error" ? toast.error(message) : toast.success(message)
+  });
   const [copied, setCopied] = useState(false);
   const handleCopy = async () => {
-    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);
-    }
+    await copyText(text);
     setCopied(true);
     setTimeout(() => setCopied(false), 2e3);
   };

package/dist/tool-call-visualization/result-fields/ResultFile.js

@@ -8,6 +8,7 @@ import { formatFileSize } from "@ai-matrx/kit/format";
 import { useFileActions } from "../../host/ui-slots.js";
 import { useMediaResolution } from "@ai-matrx/media/core";
 import { Button } from "@ai-matrx/design-system/controls";
+import { downloadUrl } from "@ai-matrx/kit/download";
 function deriveName(file) {
   if (file.file_name && file.file_name.trim().length > 0) return file.file_name.trim();
   const src = file.download_url ?? file.url;
@@ -33,14 +34,7 @@ function deriveTypeLabel(file, name) {
   return null;
 }
 function triggerAnchorDownload(href, name) {
-  const a = document.createElement("a");
-  a.href = href;
-  a.download = name;
-  a.target = "_blank";
-  a.rel = "noopener noreferrer";
-  document.body.appendChild(a);
-  a.click();
-  a.remove();
+  downloadUrl(href, name, { newTab: true });
 }
 const ResultFile = ({ file, density = "inline", className }) => {
   const [busy, setBusy] = useState(false);

package/dist/tool-call-visualization/result-fields/ShortId.js

@@ -2,31 +2,9 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import React from "react";
 import { Check, Copy } from "lucide-react";
+import { copyText } from "@ai-matrx/kit/clipboard";
 import { cn } from "@ai-matrx/design-system";
 import { Button } from "@ai-matrx/design-system/controls";
-async function copyText(text) {
-  try {
-    if (navigator.clipboard?.writeText) {
-      await navigator.clipboard.writeText(text);
-      return true;
-    }
-  } catch {
-  }
-  try {
-    const ta = document.createElement("textarea");
-    ta.value = text;
-    ta.style.position = "fixed";
-    ta.style.opacity = "0";
-    ta.style.pointerEvents = "none";
-    document.body.appendChild(ta);
-    ta.select();
-    const ok = document.execCommand("copy");
-    document.body.removeChild(ta);
-    return ok;
-  } catch {
-    return false;
-  }
-}
 const ShortId = ({
   value,
   variant = "compact",

package/dist/voice-agent/components/LiveVoiceDoor.js

@@ -2,7 +2,7 @@
 import { jsx, jsxs } from "react/jsx-runtime";
 import { SettingDoor } from "../../host/prefs-react.js";
 import { useAppSelector } from "../../store/hooks.js";
-import { voiceDisplayName } from "../../host/ui-slots.js";
+import { voiceDisplayName } from "@ai-matrx/media/voices";
 function LiveVoiceDoor({
   voiceId,
   agentId

package/dist/voice-agent/hooks/useVoiceAgentInstance.js

@@ -12,7 +12,7 @@ import {
   useRealtimeSessionConfig
 } from "../realtimeSession.js";
 import { useSessionKnob } from "../../host/prefs-react.js";
-import { isLiveConversationVoice } from "../../host/ui-slots.js";
+import { isLiveConversationVoice } from "@ai-matrx/media/voices";
 const LIVE_CONVERSATION_VOICE_KNOB = "media.conversation.voice";
 function isVoiceId(v) {
   return isLiveConversationVoice(v);

package/dist/window-panels/windows/agents/ObservationalMemoryWindow.d.ts

@@ -1,20 +1,3 @@
-/**
- * ObservationalMemoryWindow
- *
- * Admin-only floating inspector for the Observational Memory feature.
- * Wraps `ObservationalMemoryCore` in the standard WindowPanel shell with a
- * sidebar listing every conversation the session has seen memory activity
- * for — that means either:
- *   - the conversation has a persisted `observational_memory` metadata block
- *     (hydrated on conversation load), OR
- *   - we have received at least one `memory_*` stream event for it this
- *     session, OR
- *   - an authoritative cost summary has been fetched for it.
- *
- * See `/window-panel-authoring` for the registration contract. This window is
- * persisted (NOT ephemeral) — admins get their last-selected conversation
- * back after a reload, matching the per-conversation nature of the feature.
- */
 import React from "react";
 interface ObservationalMemoryWindowProps {
     isOpen: boolean;

package/dist/window-panels/windows/agents/ObservationalMemoryWindow.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, useMemo, useState } from "react";
 import {
   Brain,
@@ -36,9 +38,12 @@ import {
 import { CHAT_WINDOWS } from "../../../host/windows.js";
 import { Button } from "@ai-matrx/design-system/controls";
 function useCopyText(text) {
+  const { copyText } = useClipboard({
+    notify: (message, kind) => kind === "error" ? toast.error(message) : toast.success(message)
+  });
   const [copied, setCopied] = useState(false);
   const copy = useCallback(() => {
-    navigator.clipboard.writeText(text).then(() => {
+    copyText(text).then(() => {
       setCopied(true);
       setTimeout(() => setCopied(false), 1500);
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/chat",
-  "version": "0.2.8",
+  "version": "0.2.10",
   "description": "THE one AI Matrx person-to-agent chat system: the full chat (running agents, conversations, tool calls, streaming, context, surfaces, voice) as per-module subpaths @ai-matrx/chat/<domain>/<module> over a host contract (/host, /host/react) whose only required value is a db; plus the kernel compatibility entries (., /external-store, /matrx, /react, /tools, styles.css, tokens.css) until P28.",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -202,23 +202,23 @@
     "uuid": "^14.0.2",
     "zod": "^4.6.5",
     "@ai-matrx/agents": "latest",
+    "@ai-matrx/alchemy": "latest",
+    "@ai-matrx/associations": "latest",
     "@ai-matrx/browser-audio": "latest",
     "@ai-matrx/canvas": "latest",
     "@ai-matrx/content-ir": "latest",
-    "@ai-matrx/content-ir-react": "latest",
     "@ai-matrx/data": "latest",
     "@ai-matrx/design-system": "latest",
     "@ai-matrx/diff": "latest",
     "@ai-matrx/icons": "latest",
-    "@ai-matrx/kit": "latest",
+    "@ai-matrx/content-ir-react": "latest",
+    "@ai-matrx/media": "latest",
     "@ai-matrx/print": "latest",
     "@ai-matrx/realtime": "latest",
     "@ai-matrx/records": "latest",
     "@ai-matrx/records-ui": "latest",
     "@ai-matrx/tap-target": "latest",
-    "@ai-matrx/alchemy": "latest",
-    "@ai-matrx/associations": "latest",
-    "@ai-matrx/media": "latest"
+    "@ai-matrx/kit": "latest"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "^0.18.5",