@ai-matrx/alchemy 0.12.2 → 0.12.3

package/dist/surface.d.ts

@@ -5,8 +5,8 @@
  * no React. Runtime behaviour lives in `MountedSurface` (`/declare/host`) and in
  * handler registrations, never here. Zero React, zero `@ai-matrx/agents`.
  */
-type Json$1 = null | boolean | number | string | Json$1[] | {
-    [key: string]: Json$1;
+type Json$2 = null | boolean | number | string | Json$2[] | {
+    [key: string]: Json$2;
 };
 /** Unchanged from `ui_surface_value_type_chk`. */
 type ValueType = "string" | "number" | "boolean" | "object" | "array" | "document";
@@ -254,7 +254,7 @@ type ActionResult<T = unknown> = {
 /** `POST /actions/run` (aidream) — the request. */
 interface ServerActionRunRequest {
     name: string;
-    input: Json$1;
+    input: Json$2;
     by: ActionCaller;
     surface_name?: string;
     policy?: ActionPolicy;
@@ -263,8 +263,8 @@ interface ServerActionRunRequest {
 interface ServerActionRunResponse {
     status: "applied" | "proposed" | "refused";
     message: string;
-    receipts: Json$1[];
-    proposal?: Json$1;
+    receipts: Json$2[];
+    proposal?: Json$2;
 }
 /** A mandate run request: by alias (an Action's `target`) or by key. */
 type MandateRunRequest = ({
@@ -274,7 +274,7 @@ type MandateRunRequest = ({
     key: string;
     alias?: never;
 }) & {
-    variables: Record<string, Json$1>;
+    variables: Record<string, Json$2>;
     userInput?: string;
     by: ActionCaller;
     policy: ActionPolicy;
@@ -402,6 +402,14 @@ interface ClickTarget {
     host?: unknown;
 }
 
+/**
+ * Framework-neutral transfer contracts (Alchemy Operate, CONTRACT §2.3). All data crossing this boundary is JSON.
+ * Moved from `@ai-matrx/kit/content-transfer` in ALC-16; the format-adapter contract lives in `./contract`.
+ */
+type Json$1 = null | boolean | number | string | Json$1[] | {
+    [key: string]: Json$1;
+};
+
 /**
  * Operate — the format and delivery contract (Matrx Alchemy CONTRACT §2.3, ALC-16).
  *
@@ -430,7 +438,8 @@ type Receipt = {
     to: WriteTargetRef;
     sentence: string;
     warning?: string;
-    fix?: string;
+    fix?: string; /** What the handler produced (e.g. the created record). */
+    result?: Json$1;
 } | {
     status: "queued";
     to: WriteTargetRef;
@@ -521,7 +530,8 @@ type CannotApply = "stale" | "missing-record" | "broken-span";
  */
 type WriteHandlerResult = void | {
     status: "applied";
-    sentence?: string;
+    sentence?: string; /** What the write produced (e.g. the created record); passed to `receipt.result` unchanged. */
+    result?: Json;
 } | {
     status: "cannot-apply";
     cannotApply: CannotApply;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-matrx/alchemy",
-  "version": "0.12.2",
+  "version": "0.12.3",
   "description": "Matrx Alchemy: the complete Matrx copy, prepare-for-AI, and export experience, with framework-neutral core, React menu, glyph and styles; Declare (what a screen holds: types, registry, validation, JSON schema) and the one surface sync; Actions (the one action registry: eligibility, duplicate refusal, projected reads) and the one menu engine (model + bar, overflow, context, selection, sheet and palette layouts as per-layout React subpaths); Surface (the one SurfacePort runtime: the database surface chain with organization extensions, values, and Action runs).",
   "type": "module",
   "main": "./dist/index.cjs",
@@ -307,9 +307,9 @@
     "*.css"
   ],
   "dependencies": {
-    "@ai-matrx/design-system": "latest",
     "@ai-matrx/print": "latest",
-    "@ai-matrx/kit": "latest"
+    "@ai-matrx/kit": "latest",
+    "@ai-matrx/design-system": "latest"
   },
   "scripts": {
     "build": "pnpm clean && tsup && node ./scripts/copy-assets.mjs && node ./scripts/assert-distribution-artifacts.mjs && node ./scripts/check-subpath-sizes.mjs",