@ai-matrx/alchemy 0.12.2 → 0.13.0

package/dist/react-host.d.ts

@@ -1,5 +1,5 @@
 import * as React from 'react';
-import { TransferOutcome } from '@ai-matrx/kit/content-transfer';
+import { TransferOutcome } from '@ai-matrx/alchemy/operate';
 
 /**
  * Matrx Alchemy — Declare types (CONTRACT §2.1).
@@ -8,8 +8,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";
@@ -167,7 +167,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[];
@@ -179,8 +179,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;
@@ -190,7 +190,7 @@ interface RecentRequest {
     durationMs?: number;
     requestId?: string;
     client?: string;
-    requestBody?: Json$1;
+    requestBody?: Json$2;
     requestBodyNote?: string;
     errorSentence?: string;
     timestamp: number;
@@ -259,6 +259,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).
  *
@@ -287,7 +295,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;
@@ -378,7 +387,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;
@@ -446,7 +456,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;
@@ -455,8 +465,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 = ({
@@ -466,7 +476,7 @@ type MandateRunRequest = ({
     key: string;
     alias?: never;
 }) & {
-    variables: Record<string, Json$1>;
+    variables: Record<string, Json$2>;
     userInput?: string;
     by: ActionCaller;
     policy: ActionPolicy;
@@ -998,11 +1008,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>;