@ai-matrx/alchemy 0.12.2 → 0.13.0

package/dist/actions.d.cts

@@ -1,4 +1,4 @@
-import { TransferOutcome } from '@ai-matrx/kit/content-transfer';
+import { TransferOutcome } from '@ai-matrx/alchemy/operate';
 
 /**
  * Matrx Alchemy — Declare types (CONTRACT §2.1).
@@ -7,8 +7,8 @@ import { TransferOutcome } from '@ai-matrx/kit/content-transfer';
  * 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";
@@ -166,7 +166,7 @@ type QualifiedValueKey = string;
 /** Live slot payloads (page-capture's shapes, kept). */
 interface LiveValues {
     selection?: {
-        choices: Record<string, Json$1>;
+        choices: Record<string, Json$2>;
         text: string | null;
     };
     "on-demand"?: readonly OnDemandSection[];
@@ -178,8 +178,8 @@ interface OnDemandSection {
     title: string;
     description?: string;
     role: "data" | "request";
-    brief?: Json$1;
-    load(signal: AbortSignal): Promise<Json$1>;
+    brief?: Json$2;
+    load(signal: AbortSignal): Promise<Json$2>;
 }
 interface RecentRequest {
     method: string;
@@ -189,7 +189,7 @@ interface RecentRequest {
     durationMs?: number;
     requestId?: string;
     client?: string;
-    requestBody?: Json$1;
+    requestBody?: Json$2;
     requestBodyNote?: string;
     errorSentence?: string;
     timestamp: number;
@@ -258,6 +258,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).
  *
@@ -286,7 +294,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;
@@ -377,7 +386,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;
@@ -518,7 +528,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;
@@ -527,8 +537,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 = ({
@@ -538,7 +548,7 @@ type MandateRunRequest = ({
     key: string;
     alias?: never;
 }) & {
-    variables: Record<string, Json$1>;
+    variables: Record<string, Json$2>;
     userInput?: string;
     by: ActionCaller;
     policy: ActionPolicy;
@@ -1089,11 +1099,11 @@ interface ReadOmission {
  */
 interface ProjectedReads {
     values(signal: AbortSignal): Promise<{
-        values: Record<string, Json$1>;
+        values: Record<string, Json$2>;
         omissions: readonly ReadOmission[];
     }>;
     item(signal: AbortSignal): Promise<{
-        values: Record<string, Json$1>;
+        values: Record<string, Json$2>;
         omissions: readonly ReadOmission[];
     } | null>;
     live(signal: AbortSignal): Promise<LiveValues>;
@@ -1225,7 +1235,7 @@ interface ProjectionSource {
 }
 /** Keep declared, ordinary, exportable values; record every removal. */
 declare function projectValues(raw: Record<string, unknown>, declared: readonly Pick<DeclaredValue, "name" | "sensitivity">[], pathPrefix?: string): {
-    values: Record<string, Json$1>;
+    values: Record<string, Json$2>;
     omissions: ReadOmission[];
 };
 declare function createProjectedReads(source: ProjectionSource): ProjectedReads;
@@ -1322,7 +1332,7 @@ interface ClientToolRow {
     name: string;
     label: string;
     description: string;
-    input_schema: Json$1;
+    input_schema: Json$2;
     /** Live values: "ui" (applied directly) | "draft" (proposed for review). */
     mode: "ui" | "draft";
     declared_by?: ActionDeclaredBy;

package/dist/actions.d.ts

@@ -1,4 +1,4 @@
-import { TransferOutcome } from '@ai-matrx/kit/content-transfer';
+import { TransferOutcome } from '@ai-matrx/alchemy/operate';
 
 /**
  * Matrx Alchemy — Declare types (CONTRACT §2.1).
@@ -7,8 +7,8 @@ import { TransferOutcome } from '@ai-matrx/kit/content-transfer';
  * 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";
@@ -166,7 +166,7 @@ type QualifiedValueKey = string;
 /** Live slot payloads (page-capture's shapes, kept). */
 interface LiveValues {
     selection?: {
-        choices: Record<string, Json$1>;
+        choices: Record<string, Json$2>;
         text: string | null;
     };
     "on-demand"?: readonly OnDemandSection[];
@@ -178,8 +178,8 @@ interface OnDemandSection {
     title: string;
     description?: string;
     role: "data" | "request";
-    brief?: Json$1;
-    load(signal: AbortSignal): Promise<Json$1>;
+    brief?: Json$2;
+    load(signal: AbortSignal): Promise<Json$2>;
 }
 interface RecentRequest {
     method: string;
@@ -189,7 +189,7 @@ interface RecentRequest {
     durationMs?: number;
     requestId?: string;
     client?: string;
-    requestBody?: Json$1;
+    requestBody?: Json$2;
     requestBodyNote?: string;
     errorSentence?: string;
     timestamp: number;
@@ -258,6 +258,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).
  *
@@ -286,7 +294,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;
@@ -377,7 +386,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;
@@ -518,7 +528,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;
@@ -527,8 +537,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 = ({
@@ -538,7 +548,7 @@ type MandateRunRequest = ({
     key: string;
     alias?: never;
 }) & {
-    variables: Record<string, Json$1>;
+    variables: Record<string, Json$2>;
     userInput?: string;
     by: ActionCaller;
     policy: ActionPolicy;
@@ -1089,11 +1099,11 @@ interface ReadOmission {
  */
 interface ProjectedReads {
     values(signal: AbortSignal): Promise<{
-        values: Record<string, Json$1>;
+        values: Record<string, Json$2>;
         omissions: readonly ReadOmission[];
     }>;
     item(signal: AbortSignal): Promise<{
-        values: Record<string, Json$1>;
+        values: Record<string, Json$2>;
         omissions: readonly ReadOmission[];
     } | null>;
     live(signal: AbortSignal): Promise<LiveValues>;
@@ -1225,7 +1235,7 @@ interface ProjectionSource {
 }
 /** Keep declared, ordinary, exportable values; record every removal. */
 declare function projectValues(raw: Record<string, unknown>, declared: readonly Pick<DeclaredValue, "name" | "sensitivity">[], pathPrefix?: string): {
-    values: Record<string, Json$1>;
+    values: Record<string, Json$2>;
     omissions: ReadOmission[];
 };
 declare function createProjectedReads(source: ProjectionSource): ProjectedReads;
@@ -1322,7 +1332,7 @@ interface ClientToolRow {
     name: string;
     label: string;
     description: string;
-    input_schema: Json$1;
+    input_schema: Json$2;
     /** Live values: "ui" (applied directly) | "draft" (proposed for review). */
     mode: "ui" | "draft";
     declared_by?: ActionDeclaredBy;