@ai-matrx/alchemy 0.3.6 → 0.4.0

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # Changelog
 
+## 0.4.0 — 2026-09-25
+
+Alchemy now sits below `@ai-matrx/agents` (ALC-12). The `/matrx` and `/matrx/react` entries, which only re-exported `@ai-matrx/agents/content-transfer[/react]`, are removed, and `@ai-matrx/agents` is no longer a dependency.
+
+### Consumer action
+
+Import `MatrxContentTransferProvider` and the other Matrx adapter symbols from `@ai-matrx/agents/content-transfer/react` and `@ai-matrx/agents/content-transfer` instead of `@ai-matrx/alchemy/matrx/react` and `@ai-matrx/alchemy/matrx`. The `.`, `/core`, `/react`, CSS and SVG entries are unchanged.
+
 ## 0.3.6
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/README.md

@@ -1,6 +1,6 @@
 # @ai-matrx/alchemy
 
-Alchemy is Matrx’s content-to-AI toolkit. **Alchemy Menu** is its small, reusable copy, preparation and export control. This distribution ships the shared core, React controls, Matrx service adapter, CSS and SVG; it contains no parallel implementation.
+Alchemy is Matrx’s content-to-AI toolkit. **Alchemy Menu** is its small, reusable copy, preparation and export control. This distribution ships the shared core, React controls, CSS and SVG; it contains no parallel implementation. It sits below `@ai-matrx/agents` and never depends on it.
 
 ## One menu, ready to use
 
@@ -65,9 +65,7 @@ A provider `email` port enables CSV, JSON and Markdown email actions. The packag
 
 ## Integrate Matrx services once
 
-`MatrxContentTransferProvider` from `@ai-matrx/alchemy/matrx/react` accepts the canonical transport, authenticated database read port, current organization getter and source application. It supplies the declared durable AI preparation job to descendant menus. The host supplies identity and its existing live-run renderer; the package owns preparation, cancellation, exact request recovery and provenance. Mount the provider at an identity boundary so changing user or organization cannot reuse another identity’s prepared run.
-
-The `/matrx` entry also ships `createMatrxTransferPorts(bindings)` and `createMatrxTransferActions(ports)`. Bind existing Notes, Documents, Workbooks, task, attachment, Code and chat openers once. Register the returned actions through the provider's `capabilities.actions`. Menus inherit Save to Matrx and Continue with AI groups; no page callback or styling is necessary. `createMatrxTransferActions` also accepts a partial port set for hosts that expose fewer destinations. The package owns serialization, capture identity checks, saved-item receipts and retry deduplication.
+The Matrx service adapter lives in `@ai-matrx/agents`, which sits above Alchemy. Import `MatrxContentTransferProvider` from `@ai-matrx/agents/content-transfer/react`, and `createMatrxTransferPorts(bindings)` / `createMatrxTransferActions(ports)` from `@ai-matrx/agents/content-transfer`. The provider accepts the canonical transport, authenticated database read port, current organization getter and source application, and supplies the declared durable AI preparation job to descendant Alchemy menus. Mount it at an identity boundary so changing user or organization cannot reuse another identity’s prepared run. Bind existing Notes, Documents, Workbooks, task, attachment, Code and chat openers once and register the returned actions through the provider's `capabilities.actions`; menus inherit Save to Matrx and Continue with AI groups.
 
 Openers report that an editor was opened, not that the item was saved. Save-and-attach preserves the created note if the destination picker fails. New-chat/window handoffs attach captured content as a text resource, leave the human composer empty and never auto-run. Connected tools are selected through the existing assistant Chat Options picker; this is not an automatic MCP invocation.
 
@@ -89,9 +87,7 @@ const artifact = serialize(createDraft(snapshot), "plain");
 |---|---|
 | `/core` (also package root) | Capture, projection, preparation, serializers, artifacts and transport. |
 | `/react` | `AlchemyMenu`, lower-level `ContentTransferMenu`, surface/provider bindings and React glyph. |
-| `/matrx` | Durable AI preparation and the standard Matrx destination catalog/workflow. |
-| `/matrx/react` | React bindings for that adapter. |
 | `/styles.css` | Self-contained menu and workspace styling. |
 | `/alchemy.svg`, `/portal.svg`, `/copy-transform.svg` | Packaged icon assets; Portal is default. |
 
-The registry installation canary requires the sibling kit, design-system and agents releases first. Stylesheets import the canonical design-system styling; SVG assets are copied from their one source at build time.
+The registry installation canary requires the sibling kit and design-system releases first, and fails if installing Alchemy pulls in `@ai-matrx/agents`. Stylesheets import the canonical design-system styling; SVG assets are copied from their one source at build time.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ai-matrx/alchemy",
-  "version": "0.3.6",
-  "description": "Matrx Alchemy: the complete Matrx copy, prepare-for-AI, and export experience, with framework-neutral core, React menu, glyph, styles and Matrx integration.",
+  "version": "0.4.0",
+  "description": "Matrx Alchemy: the complete Matrx copy, prepare-for-AI, and export experience, with framework-neutral core, React menu, glyph and styles.",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -68,26 +68,6 @@
         "default": "./dist/react.cjs"
       }
     },
-    "./matrx": {
-      "import": {
-        "types": "./dist/matrx.d.ts",
-        "default": "./dist/matrx.js"
-      },
-      "require": {
-        "types": "./dist/matrx.d.cts",
-        "default": "./dist/matrx.cjs"
-      }
-    },
-    "./matrx/react": {
-      "import": {
-        "types": "./dist/matrx-react.d.ts",
-        "default": "./dist/matrx-react.js"
-      },
-      "require": {
-        "types": "./dist/matrx-react.d.cts",
-        "default": "./dist/matrx-react.cjs"
-      }
-    },
     "./styles.css": "./dist/styles.css",
     "./tap-target.css": "./dist/tap-target.css",
     "./alchemy.svg": "./dist/alchemy.svg",
@@ -133,13 +113,12 @@
   ],
   "dependencies": {
     "@ai-matrx/design-system": "latest",
-    "@ai-matrx/kit": "latest",
-    "@ai-matrx/agents": "latest"
+    "@ai-matrx/kit": "latest"
   },
   "scripts": {
     "build": "pnpm clean && tsup && node ./scripts/copy-assets.mjs && node ./scripts/assert-distribution-artifacts.mjs",
     "clean": "node -e \"require('node:fs').rmSync('dist',{recursive:true,force:true})\"",
-    "check:package": "pnpm build && node ../scripts/check-exports-agreement.mjs && publint && pnpm verify:tarball",
+    "check:package": "pnpm build && node ../scripts/check-exports-agreement.mjs && node ../scripts/check-alchemy-below-agents.mjs && publint && pnpm verify:tarball",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run",
     "verify:tarball": "node ./scripts/verify-tarball.mjs"

package/dist/matrx-react.cjs

@@ -1,23 +0,0 @@
-"use client";
-"use strict";
-"use client";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/matrx-react.ts
-var matrx_react_exports = {};
-module.exports = __toCommonJS(matrx_react_exports);
-__reExport(matrx_react_exports, require("@ai-matrx/agents/content-transfer/react"), module.exports);
-//# sourceMappingURL=matrx-react.cjs.map

package/dist/matrx-react.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/matrx-react.ts"],"sourcesContent":["\"use client\";\n\nexport * from \"@ai-matrx/agents/content-transfer/react\";\n"],"mappings":";;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAEA,gCAAc,oDAFd;","names":[]}

package/dist/matrx-react.d.cts

@@ -1 +0,0 @@
-export * from '@ai-matrx/agents/content-transfer/react';

package/dist/matrx-react.d.ts

@@ -1 +0,0 @@
-export * from '@ai-matrx/agents/content-transfer/react';

package/dist/matrx-react.js

@@ -1,6 +0,0 @@
-"use client";
-"use client";
-
-// src/matrx-react.ts
-export * from "@ai-matrx/agents/content-transfer/react";
-//# sourceMappingURL=matrx-react.js.map

package/dist/matrx-react.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/matrx-react.ts"],"sourcesContent":["\"use client\";\n\nexport * from \"@ai-matrx/agents/content-transfer/react\";\n"],"mappings":";;;;AAEA,cAAc;","names":[]}

package/dist/matrx.cjs

@@ -1,21 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __reExport = (target, mod, secondTarget) => (__copyProps(target, mod, "default"), secondTarget && __copyProps(secondTarget, mod, "default"));
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/matrx.ts
-var matrx_exports = {};
-module.exports = __toCommonJS(matrx_exports);
-__reExport(matrx_exports, require("@ai-matrx/agents/content-transfer"), module.exports);
-//# sourceMappingURL=matrx.cjs.map

package/dist/matrx.cjs.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/matrx.ts"],"sourcesContent":["export * from \"@ai-matrx/agents/content-transfer\";\n"],"mappings":";;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA,0BAAc,8CAAd;","names":[]}

package/dist/matrx.d.cts

@@ -1 +0,0 @@
-export * from '@ai-matrx/agents/content-transfer';

package/dist/matrx.d.ts

@@ -1 +0,0 @@
-export * from '@ai-matrx/agents/content-transfer';

package/dist/matrx.js

@@ -1,3 +0,0 @@
-// src/matrx.ts
-export * from "@ai-matrx/agents/content-transfer";
-//# sourceMappingURL=matrx.js.map

package/dist/matrx.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/matrx.ts"],"sourcesContent":["export * from \"@ai-matrx/agents/content-transfer\";\n"],"mappings":";AAAA,cAAc;","names":[]}