@ai-matrx/alchemy 0.13.0 → 0.15.0

package/dist/actions.d.cts

@@ -1,4 +1,5 @@
 import { TransferOutcome } from '@ai-matrx/alchemy/operate';
+import { Json as Json$2 } from '@ai-matrx/kit/transfer-json';
 
 /**
  * Matrx Alchemy — Declare types (CONTRACT §2.1).
@@ -7,8 +8,8 @@ import { TransferOutcome } from '@ai-matrx/alchemy/operate';
  * no React. Runtime behaviour lives in `MountedSurface` (`/declare/host`) and in
  * handler registrations, never here. Zero React, zero `@ai-matrx/agents`.
  */
-type Json$2 = null | boolean | number | string | Json$2[] | {
-    [key: string]: Json$2;
+type Json$1 = null | boolean | number | string | Json$1[] | {
+    [key: string]: Json$1;
 };
 /** Unchanged from `ui_surface_value_type_chk`. */
 type ValueType = "string" | "number" | "boolean" | "object" | "array" | "document";
@@ -138,6 +139,8 @@ interface SurfaceDeclaration {
     configNamespaces?: readonly ConfigNamespaceDeclaration[];
     evidenceSources?: readonly EvidenceSourceDeclaration[];
     skipBaselineValues?: boolean;
+    /** Opt out of the host's baseline item types (`baselineItemTypes`, e.g. `TABLE_ROW_ITEM_TYPE`). */
+    skipBaselineItemTypes?: boolean;
 }
 type ValueProvenance = {
     kind: "own";
@@ -166,7 +169,7 @@ type QualifiedValueKey = string;
 /** Live slot payloads (page-capture's shapes, kept). */
 interface LiveValues {
     selection?: {
-        choices: Record<string, Json$2>;
+        choices: Record<string, Json$1>;
         text: string | null;
     };
     "on-demand"?: readonly OnDemandSection[];
@@ -178,8 +181,8 @@ interface OnDemandSection {
     title: string;
     description?: string;
     role: "data" | "request";
-    brief?: Json$2;
-    load(signal: AbortSignal): Promise<Json$2>;
+    brief?: Json$1;
+    load(signal: AbortSignal): Promise<Json$1>;
 }
 interface RecentRequest {
     method: string;
@@ -189,7 +192,7 @@ interface RecentRequest {
     durationMs?: number;
     requestId?: string;
     client?: string;
-    requestBody?: Json$2;
+    requestBody?: Json$1;
     requestBodyNote?: string;
     errorSentence?: string;
     timestamp: number;
@@ -258,14 +261,6 @@ 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).
  *
@@ -295,7 +290,7 @@ type Receipt = {
     sentence: string;
     warning?: string;
     fix?: string; /** What the handler produced (e.g. the created record). */
-    result?: Json$1;
+    result?: Json$2;
 } | {
     status: "queued";
     to: WriteTargetRef;
@@ -528,7 +523,7 @@ type ActionResult<T = unknown> = {
 /** `POST /actions/run` (aidream) — the request. */
 interface ServerActionRunRequest {
     name: string;
-    input: Json$2;
+    input: Json$1;
     by: ActionCaller;
     surface_name?: string;
     policy?: ActionPolicy;
@@ -537,8 +532,8 @@ interface ServerActionRunRequest {
 interface ServerActionRunResponse {
     status: "applied" | "proposed" | "refused";
     message: string;
-    receipts: Json$2[];
-    proposal?: Json$2;
+    receipts: Json$1[];
+    proposal?: Json$1;
 }
 /** A mandate run request: by alias (an Action's `target`) or by key. */
 type MandateRunRequest = ({
@@ -548,7 +543,7 @@ type MandateRunRequest = ({
     key: string;
     alias?: never;
 }) & {
-    variables: Record<string, Json$2>;
+    variables: Record<string, Json$1>;
     userInput?: string;
     by: ActionCaller;
     policy: ActionPolicy;
@@ -1099,11 +1094,11 @@ interface ReadOmission {
  */
 interface ProjectedReads {
     values(signal: AbortSignal): Promise<{
-        values: Record<string, Json$2>;
+        values: Record<string, Json$1>;
         omissions: readonly ReadOmission[];
     }>;
     item(signal: AbortSignal): Promise<{
-        values: Record<string, Json$2>;
+        values: Record<string, Json$1>;
         omissions: readonly ReadOmission[];
     } | null>;
     live(signal: AbortSignal): Promise<LiveValues>;
@@ -1235,7 +1230,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$2>;
+    values: Record<string, Json$1>;
     omissions: ReadOmission[];
 };
 declare function createProjectedReads(source: ProjectionSource): ProjectedReads;
@@ -1332,7 +1327,7 @@ interface ClientToolRow {
     name: string;
     label: string;
     description: string;
-    input_schema: Json$2;
+    input_schema: Json$1;
     /** Live values: "ui" (applied directly) | "draft" (proposed for review). */
     mode: "ui" | "draft";
     declared_by?: ActionDeclaredBy;

package/dist/actions.d.ts

@@ -1,4 +1,5 @@
 import { TransferOutcome } from '@ai-matrx/alchemy/operate';
+import { Json as Json$2 } from '@ai-matrx/kit/transfer-json';
 
 /**
  * Matrx Alchemy — Declare types (CONTRACT §2.1).
@@ -7,8 +8,8 @@ import { TransferOutcome } from '@ai-matrx/alchemy/operate';
  * no React. Runtime behaviour lives in `MountedSurface` (`/declare/host`) and in
  * handler registrations, never here. Zero React, zero `@ai-matrx/agents`.
  */
-type Json$2 = null | boolean | number | string | Json$2[] | {
-    [key: string]: Json$2;
+type Json$1 = null | boolean | number | string | Json$1[] | {
+    [key: string]: Json$1;
 };
 /** Unchanged from `ui_surface_value_type_chk`. */
 type ValueType = "string" | "number" | "boolean" | "object" | "array" | "document";
@@ -138,6 +139,8 @@ interface SurfaceDeclaration {
     configNamespaces?: readonly ConfigNamespaceDeclaration[];
     evidenceSources?: readonly EvidenceSourceDeclaration[];
     skipBaselineValues?: boolean;
+    /** Opt out of the host's baseline item types (`baselineItemTypes`, e.g. `TABLE_ROW_ITEM_TYPE`). */
+    skipBaselineItemTypes?: boolean;
 }
 type ValueProvenance = {
     kind: "own";
@@ -166,7 +169,7 @@ type QualifiedValueKey = string;
 /** Live slot payloads (page-capture's shapes, kept). */
 interface LiveValues {
     selection?: {
-        choices: Record<string, Json$2>;
+        choices: Record<string, Json$1>;
         text: string | null;
     };
     "on-demand"?: readonly OnDemandSection[];
@@ -178,8 +181,8 @@ interface OnDemandSection {
     title: string;
     description?: string;
     role: "data" | "request";
-    brief?: Json$2;
-    load(signal: AbortSignal): Promise<Json$2>;
+    brief?: Json$1;
+    load(signal: AbortSignal): Promise<Json$1>;
 }
 interface RecentRequest {
     method: string;
@@ -189,7 +192,7 @@ interface RecentRequest {
     durationMs?: number;
     requestId?: string;
     client?: string;
-    requestBody?: Json$2;
+    requestBody?: Json$1;
     requestBodyNote?: string;
     errorSentence?: string;
     timestamp: number;
@@ -258,14 +261,6 @@ 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).
  *
@@ -295,7 +290,7 @@ type Receipt = {
     sentence: string;
     warning?: string;
     fix?: string; /** What the handler produced (e.g. the created record). */
-    result?: Json$1;
+    result?: Json$2;
 } | {
     status: "queued";
     to: WriteTargetRef;
@@ -528,7 +523,7 @@ type ActionResult<T = unknown> = {
 /** `POST /actions/run` (aidream) — the request. */
 interface ServerActionRunRequest {
     name: string;
-    input: Json$2;
+    input: Json$1;
     by: ActionCaller;
     surface_name?: string;
     policy?: ActionPolicy;
@@ -537,8 +532,8 @@ interface ServerActionRunRequest {
 interface ServerActionRunResponse {
     status: "applied" | "proposed" | "refused";
     message: string;
-    receipts: Json$2[];
-    proposal?: Json$2;
+    receipts: Json$1[];
+    proposal?: Json$1;
 }
 /** A mandate run request: by alias (an Action's `target`) or by key. */
 type MandateRunRequest = ({
@@ -548,7 +543,7 @@ type MandateRunRequest = ({
     key: string;
     alias?: never;
 }) & {
-    variables: Record<string, Json$2>;
+    variables: Record<string, Json$1>;
     userInput?: string;
     by: ActionCaller;
     policy: ActionPolicy;
@@ -1099,11 +1094,11 @@ interface ReadOmission {
  */
 interface ProjectedReads {
     values(signal: AbortSignal): Promise<{
-        values: Record<string, Json$2>;
+        values: Record<string, Json$1>;
         omissions: readonly ReadOmission[];
     }>;
     item(signal: AbortSignal): Promise<{
-        values: Record<string, Json$2>;
+        values: Record<string, Json$1>;
         omissions: readonly ReadOmission[];
     } | null>;
     live(signal: AbortSignal): Promise<LiveValues>;
@@ -1235,7 +1230,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$2>;
+    values: Record<string, Json$1>;
     omissions: ReadOmission[];
 };
 declare function createProjectedReads(source: ProjectionSource): ProjectedReads;
@@ -1332,7 +1327,7 @@ interface ClientToolRow {
     name: string;
     label: string;
     description: string;
-    input_schema: Json$2;
+    input_schema: Json$1;
     /** Live values: "ui" (applied directly) | "draft" (proposed for review). */
     mode: "ui" | "draft";
     declared_by?: ActionDeclaredBy;