@ai-matrx/design-system 0.18.1 → 0.18.3

package/CHANGELOG.md

@@ -1,5 +1,30 @@
 # Changelog
 
+## 0.18.3 — 2026-09-12
+
+Reopening an Alchemy preparation now checks the current source while retaining
+manual drafts. Changed direct sources offer an explicit keep-or-regenerate
+choice, all-matching sources detect identity changes without eagerly fetching
+pages, and failed refreshes remain visible instead of silently reusing stale
+content.
+
+### Consumer action
+
+Update to 0.18.3. No host configuration changes are required.
+
+## 0.18.2 — 2026-09-12
+
+Alchemy copy sessions now reset only when their explicit identity changes,
+preventing organization or authentication transitions from leaking prepared
+state across sessions. Data-table copy sources explicitly identify the table as
+their primary source while preserving raw JSON and hidden-export preparation.
+Failed-run recovery remains limited to valid recoverable runs.
+
+### Consumer action
+
+Update to 0.18.2 and provide a stable `identityKey` wherever authentication or
+organization identity can change during a mounted Alchemy session.
+
 ## 0.18.1 — 2026-09-12
 
 Reorderable table columns now drag from the visible header label instead of a

package/dist/content-transfer.cjs

@@ -660,7 +660,17 @@ var sourceFor = (id, label, build) => ({
   }
 });
 function MatrxCopyMenu(props) {
-  return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(MatrxCopyMenuSession, { ...props }, props.sourceId ?? props.label);
+  const inherited = useContentTransferCapabilities();
+  return /* @__PURE__ */ (0, import_jsx_runtime7.jsx)(
+    MatrxCopyMenuSession,
+    {
+      ...props
+    },
+    JSON.stringify([
+      inherited.identityKey ?? null,
+      props.sourceId ?? props.label
+    ])
+  );
 }
 function MatrxCopyMenuSession(props) {
   const instance = React7.useId();
@@ -688,7 +698,7 @@ function MatrxCopyMenuSession(props) {
   })) : void 0;
   const agent = aiVisible && props.agent !== void 0 ? make("agent", () => asPayload(resolve(props.agent))) : void 0;
   const structuredAgent = aiVisible && props.agent !== void 0 ? make("structured-agent", () => structuredPayload(resolve(props.agent))) : void 0;
-  const table = exportVisible && props.export?.sheetRows ? make("rows", () => {
+  const table = (exportVisible || props.primarySource === "table") && props.export?.sheetRows ? make("rows", () => {
     const value = (0, import_content_transfer.normalizeTransferJson)(props.export.sheetRows());
     if (!Array.isArray(value) || value.some(
       (row) => row === null || typeof row !== "object" || Array.isArray(row)
@@ -835,7 +845,7 @@ function MatrxCopyMenuSession(props) {
         return props.sendToSheet(draft.payload.rows, props.label);
       }
     });
-  const source = json ?? table ?? structuredAgent ?? human ?? builderVariants[0]?.source;
+  const source = (props.primarySource === "table" ? table : void 0) ?? json ?? table ?? structuredAgent ?? human ?? builderVariants[0]?.source;
   if (!source && !actions.length) return null;
   const target = source ?? make("actions", () => ({ kind: "text", text: props.label }));
   return /* @__PURE__ */ (0, import_jsx_runtime7.jsxs)(import_jsx_runtime7.Fragment, { children: [
@@ -855,7 +865,7 @@ function MatrxCopyMenuSession(props) {
         formatSources: {
           ...human ? { plain: human, markdown: humanMarkdown, html: humanMarkdown } : {},
           ...json ? { json, "compact-json": json } : {},
-          ...table ? { csv: table, tsv: table } : {}
+          ...table && exportVisible ? { csv: table, tsv: table } : {}
         },
         ...props.disabled !== void 0 ? { disabled: props.disabled } : {},
         className: cn(
@@ -1240,6 +1250,10 @@ function materialIdentity(material) {
   }
   return `payload:${id}`;
 }
+function snapshotContent(snapshot) {
+  const { sourceId, label, payload, coverage, unsavedChanges, omissions, sections, limits } = snapshot;
+  return JSON.stringify({ sourceId, label, payload, coverage, unsavedChanges, omissions, sections, limits });
+}
 function useFence() {
   const mounted = React8.useRef(true);
   const nextId = React8.useRef(0);
@@ -1288,7 +1302,12 @@ async function buildArtifact(draft, format, label) {
   const extension = format === "plain" ? "txt" : format === "compact-json" ? "json" : format;
   return (0, import_content_transfer2.serialize)(draft, format, { spreadsheetSafe: format === "csv" || format === "tsv", filename: `${filenameFor(label)}.${extension}` });
 }
-function ContentTransferMenu({ source, surface, label, projection, sections, preferences, table, formatSources, variants = EMPTY_VARIANTS, actions = [], capabilities: local, disabled, enabled = true, className, stopPropagation = true, hide = [], controllerRef }) {
+function ContentTransferMenu(props) {
+  const inherited = React8.useContext(CapabilityContext);
+  const identityKey = props.capabilities?.identityKey ?? inherited.identityKey;
+  return /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(ContentTransferMenuSession, { ...props }, identityKey ?? "anonymous");
+}
+function ContentTransferMenuSession({ source, surface, label, projection, sections, preferences, table, formatSources, variants = EMPTY_VARIANTS, actions = [], capabilities: local, disabled, enabled = true, className, stopPropagation = true, hide = [], controllerRef }) {
   const triggerRef = React8.useRef(null);
   const inherited = React8.useContext(CapabilityContext);
   const nearestSurface = React8.useContext(SurfaceContext);
@@ -1337,7 +1356,7 @@ function ContentTransferMenu({ source, surface, label, projection, sections, pre
       const captured = await material.capture(signal);
       sourceMaterial = { id: captured.snapshot.sourceId, label: captured.snapshot.label, capture: async () => captured };
     } else if ("kind" in material) {
-      sourceMaterial = applyMenuProjection ? { id: "direct", label: sourceLabel, capture: async () => (0, import_content_transfer2.directSource)(material, { label: sourceLabel, ...projection ? { projection } : {}, ...sections ? { sections } : {} }) } : material;
+      sourceMaterial = { id: materialIdentity(material), label: sourceLabel, capture: async () => (0, import_content_transfer2.directSource)(material, { sourceId: materialIdentity(material), label: sourceLabel, ...applyMenuProjection && projection ? { projection } : {}, ...applyMenuProjection && sections ? { sections } : {} }) };
     } else if (applyMenuProjection && (projection || sections)) {
       sourceMaterial = {
         id: material.id,
@@ -1354,7 +1373,7 @@ function ContentTransferMenu({ source, surface, label, projection, sections, pre
     } else {
       sourceMaterial = material;
     }
-    const raw = "kind" in sourceMaterial ? (0, import_content_transfer2.directSource)(sourceMaterial) : await sourceMaterial.capture({ scope, signal });
+    const raw = await sourceMaterial.capture({ scope, signal });
     const constrained = (0, import_content_transfer2.resolveTransferPreferences)(providerPreferences, preferences, raw.snapshot.limits);
     const result = await (0, import_content_transfer2.capture)({ id: raw.snapshot.sourceId, label: raw.snapshot.label, capture: async () => ({ ...raw, snapshot: { ...raw.snapshot, limits: constrained.limits } }) }, signal, scope);
     if (scope !== "all-matching" || !collectPages) return result;
@@ -1414,31 +1433,117 @@ function ContentTransferMenu({ source, surface, label, projection, sections, pre
       fence.finish(controller);
     }
   }, [captureOne, capturePrimary, fence, formatSources, initialScope, preferences, providerPreferences, report, transport]);
-  const openWorkspace = React8.useCallback(async (key = primaryWorkspaceKey, variant) => {
-    const variantMaterial = variant && "kind" in variant.source ? { id: `variant:${key}`, label: variant.label, capture: async () => (0, import_content_transfer2.directSource)(variant.source, { label: variant.label }) } : variant?.source;
-    const captureWorkspace = variantMaterial ? (scope, signal) => captureOne(variantMaterial, scope, signal, true) : capturePrimary;
-    workspaceCaptures.current.set(key, captureWorkspace);
-    if (workspaces[key]) {
-      setWorkspaceKey(key);
-      setWorkspaceOpen(true);
-      return;
-    }
-    const { controller, id } = fence.begin();
-    try {
-      const result = await captureWorkspace(initialScope, controller.signal);
-      if (!fence.valid(id, controller)) return;
-      const resolved = (0, import_content_transfer2.resolveTransferPreferences)(providerPreferences, preferences, result.snapshot.limits);
-      const original = (0, import_content_transfer2.createDraft)(result.snapshot);
-      const base = { ...result, key, original, draft: original, scope: initialScope, preferences: resolved, ...result.collectionError ? { error: result.collectionError } : {} };
-      setWorkspaces((current) => ({ ...current, [key]: { ...base, draft: rebuild(base, initialControls(base)) } }));
-      setWorkspaceKey(key);
-      setWorkspaceOpen(true);
-    } catch (error) {
-      if (fence.valid(id, controller)) setNotice(errorMessage(error, "Could not capture content"));
-    } finally {
-      fence.finish(controller);
-    }
-  }, [captureOne, capturePrimary, fence, initialScope, preferences, primaryWorkspaceKey, providerPreferences, workspaces]);
+  const openWorkspace = React8.useCallback(
+    async (key = primaryWorkspaceKey, variant) => {
+      const variantMaterial = variant && "kind" in variant.source ? {
+        id: `variant:${key}`,
+        label: variant.label,
+        capture: async () => (0, import_content_transfer2.directSource)(variant.source, {
+          sourceId: `variant:${key}`,
+          label: variant.label
+        })
+      } : variant?.source;
+      const captureWorkspace = (scope, signal, collectPages = true) => captureOne(variantMaterial ?? primary, scope, signal, true, collectPages);
+      workspaceCaptures.current.set(key, captureWorkspace);
+      const existing = workspaces[key];
+      const { controller, id } = fence.begin();
+      if (existing) {
+        try {
+          const allMatching = existing.scope === "all-matching";
+          const fresh = await captureWorkspace(
+            existing.scope,
+            controller.signal,
+            !allMatching
+          );
+          if (!fence.valid(id, controller) || !workspaceCaptures.current.has(key))
+            return;
+          if (allMatching && (!existing.allMatching || !fresh.allMatching))
+            throw new Error(
+              "This source can no longer provide an all-matching snapshot."
+            );
+          const collectionIdentity = (value) => value && {
+            query: value.source.query,
+            projection: value.projection,
+            columns: value.columns,
+            limits: value.limits
+          };
+          const changed = allMatching ? JSON.stringify(collectionIdentity(existing.allMatching)) !== JSON.stringify(collectionIdentity(fresh.allMatching)) : snapshotContent(existing.snapshot) !== snapshotContent(fresh.snapshot);
+          setWorkspaces((current) => {
+            const retained = current[key];
+            if (!retained) return current;
+            return {
+              ...current,
+              [key]: {
+                ...retained,
+                error: fresh.collectionError,
+                ...allMatching ? { sourceStale: changed } : changed ? { pending: { ...fresh, scope: retained.scope } } : { pending: void 0 }
+              }
+            };
+          });
+          setWorkspaceKey(key);
+          setWorkspaceOpen(true);
+        } catch (error) {
+          if (fence.valid(id, controller) && workspaceCaptures.current.has(key)) {
+            setWorkspaces(
+              (current) => current[key] ? {
+                ...current,
+                [key]: {
+                  ...current[key],
+                  error: errorMessage(error, "Could not refresh source")
+                }
+              } : current
+            );
+            setWorkspaceKey(key);
+            setWorkspaceOpen(true);
+          }
+        } finally {
+          fence.finish(controller);
+        }
+        return;
+      }
+      try {
+        const result = await captureWorkspace(initialScope, controller.signal);
+        if (!fence.valid(id, controller)) return;
+        const resolved = (0, import_content_transfer2.resolveTransferPreferences)(
+          providerPreferences,
+          preferences,
+          result.snapshot.limits
+        );
+        const original = (0, import_content_transfer2.createDraft)(result.snapshot);
+        const base = {
+          ...result,
+          key,
+          original,
+          draft: original,
+          scope: initialScope,
+          preferences: resolved,
+          ...result.collectionError ? { error: result.collectionError } : {}
+        };
+        setWorkspaces((current) => ({
+          ...current,
+          [key]: { ...base, draft: rebuild(base, initialControls(base)) }
+        }));
+        setWorkspaceKey(key);
+        setWorkspaceOpen(true);
+      } catch (error) {
+        if (fence.valid(id, controller))
+          setNotice(errorMessage(error, "Could not capture content"));
+      } finally {
+        fence.finish(controller);
+      }
+    },
+    [
+      captureOne,
+      capturePrimary,
+      fence,
+      initialScope,
+      preferences,
+      primaryWorkspaceKey,
+      primary,
+      providerPreferences,
+      workspaces
+    ]
+  );
   React8.useImperativeHandle(controllerRef, () => ({
     focusTrigger: () => triggerRef.current?.focus(),
     prepare: async (requestedSource, options) => {
@@ -1581,6 +1686,9 @@ function PreparationWorkspace({ restoreFocus, open, state, scopes, onClose, onCh
   const [instruction, setInstruction] = React8.useState("");
   const [busy, setBusy] = React8.useState(null);
   const [aiFailed, setAiFailed] = React8.useState(false);
+  React8.useEffect(() => {
+    setAiFailed(false);
+  }, [state.snapshot.id, state.draft.revision]);
   const activeAi = React8.useRef(null);
   const activeCapture = React8.useRef(null);
   React8.useEffect(() => {
@@ -1658,7 +1766,7 @@ function PreparationWorkspace({ restoreFocus, open, state, scopes, onClose, onCh
     setBusy("capture");
     try {
       const result = await captureScope(scope, controller.signal);
-      if (fence.valid(id, controller) && latest.current.draft.revision === revision) onChange({ ...latest.current, pending: { ...result, scope }, error: result.collectionError });
+      if (fence.valid(id, controller) && latest.current.draft.revision === revision) onChange({ ...latest.current, pending: { ...result, scope }, sourceStale: false, error: result.collectionError });
     } catch (error) {
       if (fence.valid(id, controller)) onChange({ ...latest.current, error: errorMessage(error, "Refresh failed") });
     } finally {
@@ -1891,7 +1999,7 @@ function PreparationWorkspace({ restoreFocus, open, state, scopes, onClose, onCh
           activeCapture.current = null;
           setBusy(null);
         }, children: "Stop loading rows" }) : null,
-        ai && aiSession.current?.recover && busy !== "ai" ? /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Button, { type: "button", variant: "outline", onClick: () => void runAi(true), children: aiFailed ? "Retry or rejoin AI run" : "Rejoin AI run" }) : null,
+        ai && aiFailed && aiSession.current?.recover && busy !== "ai" ? /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Button, { type: "button", variant: "outline", onClick: () => void runAi(true), children: aiFailed ? "Retry or rejoin AI run" : "Rejoin AI run" }) : null,
         ai ? /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("p", { className: "matrx-alchemy-meta", children: "AI creates a preview. It never copies automatically. Closing detaches this view without cancelling server work." }) : null,
         state.error ? /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("p", { role: "alert", className: "matrx-alchemy-error", children: state.error }) : null
       ] }) : null
@@ -1901,6 +2009,7 @@ function PreparationWorkspace({ restoreFocus, open, state, scopes, onClose, onCh
       /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Button, { type: "button", variant: "outline", onClick: () => setPendingControls(null), children: "Keep edited draft" }),
       /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Button, { type: "button", onClick: applyPendingControls, children: "Rebuild from source" })
     ] }) : null,
+    state.sourceStale ? /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("p", { role: "alert", className: "matrx-alchemy-decision", children: "The source changed since this draft. Use Refresh source to review the latest data." }) : null,
     state.pending ? /* @__PURE__ */ (0, import_jsx_runtime8.jsxs)("div", { className: "matrx-alchemy-decision", role: "alert", children: [
       /* @__PURE__ */ (0, import_jsx_runtime8.jsx)("p", { children: "A fresh source snapshot is ready." }),
       /* @__PURE__ */ (0, import_jsx_runtime8.jsx)(Button, { type: "button", variant: "outline", onClick: () => resolveCapture("keep"), children: "Keep current snapshot and draft" }),