@ai-matrx/alchemy 0.13.0 → 0.14.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (81) hide show
  1. package/CHANGELOG.md +29 -0
  2. package/dist/actions.cjs.map +1 -1
  3. package/dist/actions.d.cts +18 -23
  4. package/dist/actions.d.ts +18 -23
  5. package/dist/actions.js.map +1 -1
  6. package/dist/checks.d.cts +2 -0
  7. package/dist/checks.d.ts +2 -0
  8. package/dist/core.cjs +4 -4
  9. package/dist/core.cjs.map +1 -1
  10. package/dist/core.d.cts +8 -58
  11. package/dist/core.d.ts +8 -58
  12. package/dist/core.js +4 -4
  13. package/dist/core.js.map +1 -1
  14. package/dist/declare/schema.json +3 -0
  15. package/dist/declare.cjs +1 -1
  16. package/dist/declare.cjs.map +1 -1
  17. package/dist/declare.d.cts +26 -1
  18. package/dist/declare.d.ts +26 -1
  19. package/dist/declare.js +1 -1
  20. package/dist/declare.js.map +1 -1
  21. package/dist/index.cjs +4 -4
  22. package/dist/index.cjs.map +1 -1
  23. package/dist/index.d.cts +8 -58
  24. package/dist/index.d.ts +8 -58
  25. package/dist/index.js +4 -4
  26. package/dist/index.js.map +1 -1
  27. package/dist/menu.d.cts +16 -21
  28. package/dist/menu.d.ts +16 -21
  29. package/dist/operate-document.cjs +2 -2
  30. package/dist/operate-document.cjs.map +1 -1
  31. package/dist/operate-document.d.cts +4 -42
  32. package/dist/operate-document.d.ts +4 -42
  33. package/dist/operate-document.js +2 -2
  34. package/dist/operate-document.js.map +1 -1
  35. package/dist/operate-rich-html.cjs +1 -1
  36. package/dist/operate-rich-html.cjs.map +1 -1
  37. package/dist/operate-rich-html.d.cts +3 -42
  38. package/dist/operate-rich-html.d.ts +3 -42
  39. package/dist/operate-rich-html.js +1 -1
  40. package/dist/operate-rich-html.js.map +1 -1
  41. package/dist/operate-server.cjs +1 -1
  42. package/dist/operate-server.cjs.map +1 -1
  43. package/dist/operate-server.d.cts +8 -46
  44. package/dist/operate-server.d.ts +8 -46
  45. package/dist/operate-server.js +1 -1
  46. package/dist/operate-server.js.map +1 -1
  47. package/dist/operate-xlsx.cjs +2 -2
  48. package/dist/operate-xlsx.cjs.map +1 -1
  49. package/dist/operate-xlsx.d.cts +4 -42
  50. package/dist/operate-xlsx.d.ts +4 -42
  51. package/dist/operate-xlsx.js +2 -2
  52. package/dist/operate-xlsx.js.map +1 -1
  53. package/dist/operate.cjs +4 -4
  54. package/dist/operate.cjs.map +1 -1
  55. package/dist/operate.d.cts +8 -58
  56. package/dist/operate.d.ts +8 -58
  57. package/dist/operate.js +4 -4
  58. package/dist/operate.js.map +1 -1
  59. package/dist/ports.d.cts +11 -15
  60. package/dist/ports.d.ts +11 -15
  61. package/dist/react-bar.d.cts +2 -0
  62. package/dist/react-bar.d.ts +2 -0
  63. package/dist/react-host.d.cts +16 -21
  64. package/dist/react-host.d.ts +16 -21
  65. package/dist/react-menu.d.cts +2 -0
  66. package/dist/react-menu.d.ts +2 -0
  67. package/dist/react-overflow.d.cts +16 -21
  68. package/dist/react-overflow.d.ts +16 -21
  69. package/dist/react-palette.d.cts +2 -0
  70. package/dist/react-palette.d.ts +2 -0
  71. package/dist/react-selection.d.cts +2 -0
  72. package/dist/react-selection.d.ts +2 -0
  73. package/dist/react-sheet.d.cts +2 -0
  74. package/dist/react-sheet.d.ts +2 -0
  75. package/dist/surface.cjs +1 -1
  76. package/dist/surface.cjs.map +1 -1
  77. package/dist/surface.d.cts +222 -16
  78. package/dist/surface.d.ts +222 -16
  79. package/dist/surface.js +1 -1
  80. package/dist/surface.js.map +1 -1
  81. package/package.json +2 -2
package/dist/ports.d.cts CHANGED
@@ -1,3 +1,5 @@
1
+ import { Json as Json$2 } from '@ai-matrx/kit/transfer-json';
2
+
1
3
  /**
2
4
  * Matrx Alchemy — Declare types (CONTRACT §2.1).
3
5
  *
@@ -5,8 +7,8 @@
5
7
  * no React. Runtime behaviour lives in `MountedSurface` (`/declare/host`) and in
6
8
  * handler registrations, never here. Zero React, zero `@ai-matrx/agents`.
7
9
  */
8
- type Json$2 = null | boolean | number | string | Json$2[] | {
9
- [key: string]: Json$2;
10
+ type Json$1 = null | boolean | number | string | Json$1[] | {
11
+ [key: string]: Json$1;
10
12
  };
11
13
  /** Unchanged from `ui_surface_value_type_chk`. */
12
14
  type ValueType = "string" | "number" | "boolean" | "object" | "array" | "document";
@@ -136,6 +138,8 @@ interface SurfaceDeclaration {
136
138
  configNamespaces?: readonly ConfigNamespaceDeclaration[];
137
139
  evidenceSources?: readonly EvidenceSourceDeclaration[];
138
140
  skipBaselineValues?: boolean;
141
+ /** Opt out of the host's baseline item types (`baselineItemTypes`, e.g. `TABLE_ROW_ITEM_TYPE`). */
142
+ skipBaselineItemTypes?: boolean;
139
143
  }
140
144
  type ValueProvenance = {
141
145
  kind: "own";
@@ -222,14 +226,6 @@ interface ClickTarget {
222
226
  host?: unknown;
223
227
  }
224
228
 
225
- /**
226
- * Framework-neutral transfer contracts (Alchemy Operate, CONTRACT §2.3). All data crossing this boundary is JSON.
227
- * Moved from `@ai-matrx/kit/content-transfer` in ALC-16; the format-adapter contract lives in `./contract`.
228
- */
229
- type Json$1 = null | boolean | number | string | Json$1[] | {
230
- [key: string]: Json$1;
231
- };
232
-
233
229
  /**
234
230
  * Operate — the format and delivery contract (Matrx Alchemy CONTRACT §2.3, ALC-16).
235
231
  *
@@ -259,7 +255,7 @@ type Receipt = {
259
255
  sentence: string;
260
256
  warning?: string;
261
257
  fix?: string; /** What the handler produced (e.g. the created record). */
262
- result?: Json$1;
258
+ result?: Json$2;
263
259
  } | {
264
260
  status: "queued";
265
261
  to: WriteTargetRef;
@@ -419,7 +415,7 @@ type ActionResult<T = unknown> = {
419
415
  /** `POST /actions/run` (aidream) — the request. */
420
416
  interface ServerActionRunRequest {
421
417
  name: string;
422
- input: Json$2;
418
+ input: Json$1;
423
419
  by: ActionCaller;
424
420
  surface_name?: string;
425
421
  policy?: ActionPolicy;
@@ -428,8 +424,8 @@ interface ServerActionRunRequest {
428
424
  interface ServerActionRunResponse {
429
425
  status: "applied" | "proposed" | "refused";
430
426
  message: string;
431
- receipts: Json$2[];
432
- proposal?: Json$2;
427
+ receipts: Json$1[];
428
+ proposal?: Json$1;
433
429
  }
434
430
  /** A mandate run request: by alias (an Action's `target`) or by key. */
435
431
  type MandateRunRequest = ({
@@ -439,7 +435,7 @@ type MandateRunRequest = ({
439
435
  key: string;
440
436
  alias?: never;
441
437
  }) & {
442
- variables: Record<string, Json$2>;
438
+ variables: Record<string, Json$1>;
443
439
  userInput?: string;
444
440
  by: ActionCaller;
445
441
  policy: ActionPolicy;
package/dist/ports.d.ts CHANGED
@@ -1,3 +1,5 @@
1
+ import { Json as Json$2 } from '@ai-matrx/kit/transfer-json';
2
+
1
3
  /**
2
4
  * Matrx Alchemy — Declare types (CONTRACT §2.1).
3
5
  *
@@ -5,8 +7,8 @@
5
7
  * no React. Runtime behaviour lives in `MountedSurface` (`/declare/host`) and in
6
8
  * handler registrations, never here. Zero React, zero `@ai-matrx/agents`.
7
9
  */
8
- type Json$2 = null | boolean | number | string | Json$2[] | {
9
- [key: string]: Json$2;
10
+ type Json$1 = null | boolean | number | string | Json$1[] | {
11
+ [key: string]: Json$1;
10
12
  };
11
13
  /** Unchanged from `ui_surface_value_type_chk`. */
12
14
  type ValueType = "string" | "number" | "boolean" | "object" | "array" | "document";
@@ -136,6 +138,8 @@ interface SurfaceDeclaration {
136
138
  configNamespaces?: readonly ConfigNamespaceDeclaration[];
137
139
  evidenceSources?: readonly EvidenceSourceDeclaration[];
138
140
  skipBaselineValues?: boolean;
141
+ /** Opt out of the host's baseline item types (`baselineItemTypes`, e.g. `TABLE_ROW_ITEM_TYPE`). */
142
+ skipBaselineItemTypes?: boolean;
139
143
  }
140
144
  type ValueProvenance = {
141
145
  kind: "own";
@@ -222,14 +226,6 @@ interface ClickTarget {
222
226
  host?: unknown;
223
227
  }
224
228
 
225
- /**
226
- * Framework-neutral transfer contracts (Alchemy Operate, CONTRACT §2.3). All data crossing this boundary is JSON.
227
- * Moved from `@ai-matrx/kit/content-transfer` in ALC-16; the format-adapter contract lives in `./contract`.
228
- */
229
- type Json$1 = null | boolean | number | string | Json$1[] | {
230
- [key: string]: Json$1;
231
- };
232
-
233
229
  /**
234
230
  * Operate — the format and delivery contract (Matrx Alchemy CONTRACT §2.3, ALC-16).
235
231
  *
@@ -259,7 +255,7 @@ type Receipt = {
259
255
  sentence: string;
260
256
  warning?: string;
261
257
  fix?: string; /** What the handler produced (e.g. the created record). */
262
- result?: Json$1;
258
+ result?: Json$2;
263
259
  } | {
264
260
  status: "queued";
265
261
  to: WriteTargetRef;
@@ -419,7 +415,7 @@ type ActionResult<T = unknown> = {
419
415
  /** `POST /actions/run` (aidream) — the request. */
420
416
  interface ServerActionRunRequest {
421
417
  name: string;
422
- input: Json$2;
418
+ input: Json$1;
423
419
  by: ActionCaller;
424
420
  surface_name?: string;
425
421
  policy?: ActionPolicy;
@@ -428,8 +424,8 @@ interface ServerActionRunRequest {
428
424
  interface ServerActionRunResponse {
429
425
  status: "applied" | "proposed" | "refused";
430
426
  message: string;
431
- receipts: Json$2[];
432
- proposal?: Json$2;
427
+ receipts: Json$1[];
428
+ proposal?: Json$1;
433
429
  }
434
430
  /** A mandate run request: by alias (an Action's `target`) or by key. */
435
431
  type MandateRunRequest = ({
@@ -439,7 +435,7 @@ type MandateRunRequest = ({
439
435
  key: string;
440
436
  alias?: never;
441
437
  }) & {
442
- variables: Record<string, Json$2>;
438
+ variables: Record<string, Json$1>;
443
439
  userInput?: string;
444
440
  by: ActionCaller;
445
441
  policy: ActionPolicy;
@@ -139,6 +139,8 @@ interface SurfaceDeclaration {
139
139
  configNamespaces?: readonly ConfigNamespaceDeclaration[];
140
140
  evidenceSources?: readonly EvidenceSourceDeclaration[];
141
141
  skipBaselineValues?: boolean;
142
+ /** Opt out of the host's baseline item types (`baselineItemTypes`, e.g. `TABLE_ROW_ITEM_TYPE`). */
143
+ skipBaselineItemTypes?: boolean;
142
144
  }
143
145
  type ValueProvenance = {
144
146
  kind: "own";
@@ -139,6 +139,8 @@ interface SurfaceDeclaration {
139
139
  configNamespaces?: readonly ConfigNamespaceDeclaration[];
140
140
  evidenceSources?: readonly EvidenceSourceDeclaration[];
141
141
  skipBaselineValues?: boolean;
142
+ /** Opt out of the host's baseline item types (`baselineItemTypes`, e.g. `TABLE_ROW_ITEM_TYPE`). */
143
+ skipBaselineItemTypes?: boolean;
142
144
  }
143
145
  type ValueProvenance = {
144
146
  kind: "own";
@@ -1,5 +1,6 @@
1
1
  import * as React from 'react';
2
2
  import { TransferOutcome } from '@ai-matrx/alchemy/operate';
3
+ import { Json as Json$2 } from '@ai-matrx/kit/transfer-json';
3
4
 
4
5
  /**
5
6
  * Matrx Alchemy — Declare types (CONTRACT §2.1).
@@ -8,8 +9,8 @@ import { TransferOutcome } from '@ai-matrx/alchemy/operate';
8
9
  * no React. Runtime behaviour lives in `MountedSurface` (`/declare/host`) and in
9
10
  * handler registrations, never here. Zero React, zero `@ai-matrx/agents`.
10
11
  */
11
- type Json$2 = null | boolean | number | string | Json$2[] | {
12
- [key: string]: Json$2;
12
+ type Json$1 = null | boolean | number | string | Json$1[] | {
13
+ [key: string]: Json$1;
13
14
  };
14
15
  /** Unchanged from `ui_surface_value_type_chk`. */
15
16
  type ValueType = "string" | "number" | "boolean" | "object" | "array" | "document";
@@ -139,6 +140,8 @@ interface SurfaceDeclaration {
139
140
  configNamespaces?: readonly ConfigNamespaceDeclaration[];
140
141
  evidenceSources?: readonly EvidenceSourceDeclaration[];
141
142
  skipBaselineValues?: boolean;
143
+ /** Opt out of the host's baseline item types (`baselineItemTypes`, e.g. `TABLE_ROW_ITEM_TYPE`). */
144
+ skipBaselineItemTypes?: boolean;
142
145
  }
143
146
  type ValueProvenance = {
144
147
  kind: "own";
@@ -167,7 +170,7 @@ type QualifiedValueKey = string;
167
170
  /** Live slot payloads (page-capture's shapes, kept). */
168
171
  interface LiveValues {
169
172
  selection?: {
170
- choices: Record<string, Json$2>;
173
+ choices: Record<string, Json$1>;
171
174
  text: string | null;
172
175
  };
173
176
  "on-demand"?: readonly OnDemandSection[];
@@ -179,8 +182,8 @@ interface OnDemandSection {
179
182
  title: string;
180
183
  description?: string;
181
184
  role: "data" | "request";
182
- brief?: Json$2;
183
- load(signal: AbortSignal): Promise<Json$2>;
185
+ brief?: Json$1;
186
+ load(signal: AbortSignal): Promise<Json$1>;
184
187
  }
185
188
  interface RecentRequest {
186
189
  method: string;
@@ -190,7 +193,7 @@ interface RecentRequest {
190
193
  durationMs?: number;
191
194
  requestId?: string;
192
195
  client?: string;
193
- requestBody?: Json$2;
196
+ requestBody?: Json$1;
194
197
  requestBodyNote?: string;
195
198
  errorSentence?: string;
196
199
  timestamp: number;
@@ -259,14 +262,6 @@ interface ClickTarget {
259
262
  host?: unknown;
260
263
  }
261
264
 
262
- /**
263
- * Framework-neutral transfer contracts (Alchemy Operate, CONTRACT §2.3). All data crossing this boundary is JSON.
264
- * Moved from `@ai-matrx/kit/content-transfer` in ALC-16; the format-adapter contract lives in `./contract`.
265
- */
266
- type Json$1 = null | boolean | number | string | Json$1[] | {
267
- [key: string]: Json$1;
268
- };
269
-
270
265
  /**
271
266
  * Operate — the format and delivery contract (Matrx Alchemy CONTRACT §2.3, ALC-16).
272
267
  *
@@ -296,7 +291,7 @@ type Receipt = {
296
291
  sentence: string;
297
292
  warning?: string;
298
293
  fix?: string; /** What the handler produced (e.g. the created record). */
299
- result?: Json$1;
294
+ result?: Json$2;
300
295
  } | {
301
296
  status: "queued";
302
297
  to: WriteTargetRef;
@@ -456,7 +451,7 @@ type ActionResult<T = unknown> = {
456
451
  /** `POST /actions/run` (aidream) — the request. */
457
452
  interface ServerActionRunRequest {
458
453
  name: string;
459
- input: Json$2;
454
+ input: Json$1;
460
455
  by: ActionCaller;
461
456
  surface_name?: string;
462
457
  policy?: ActionPolicy;
@@ -465,8 +460,8 @@ interface ServerActionRunRequest {
465
460
  interface ServerActionRunResponse {
466
461
  status: "applied" | "proposed" | "refused";
467
462
  message: string;
468
- receipts: Json$2[];
469
- proposal?: Json$2;
463
+ receipts: Json$1[];
464
+ proposal?: Json$1;
470
465
  }
471
466
  /** A mandate run request: by alias (an Action's `target`) or by key. */
472
467
  type MandateRunRequest = ({
@@ -476,7 +471,7 @@ type MandateRunRequest = ({
476
471
  key: string;
477
472
  alias?: never;
478
473
  }) & {
479
- variables: Record<string, Json$2>;
474
+ variables: Record<string, Json$1>;
480
475
  userInput?: string;
481
476
  by: ActionCaller;
482
477
  policy: ActionPolicy;
@@ -1008,11 +1003,11 @@ interface ReadOmission {
1008
1003
  */
1009
1004
  interface ProjectedReads {
1010
1005
  values(signal: AbortSignal): Promise<{
1011
- values: Record<string, Json$2>;
1006
+ values: Record<string, Json$1>;
1012
1007
  omissions: readonly ReadOmission[];
1013
1008
  }>;
1014
1009
  item(signal: AbortSignal): Promise<{
1015
- values: Record<string, Json$2>;
1010
+ values: Record<string, Json$1>;
1016
1011
  omissions: readonly ReadOmission[];
1017
1012
  } | null>;
1018
1013
  live(signal: AbortSignal): Promise<LiveValues>;
@@ -1,5 +1,6 @@
1
1
  import * as React from 'react';
2
2
  import { TransferOutcome } from '@ai-matrx/alchemy/operate';
3
+ import { Json as Json$2 } from '@ai-matrx/kit/transfer-json';
3
4
 
4
5
  /**
5
6
  * Matrx Alchemy — Declare types (CONTRACT §2.1).
@@ -8,8 +9,8 @@ import { TransferOutcome } from '@ai-matrx/alchemy/operate';
8
9
  * no React. Runtime behaviour lives in `MountedSurface` (`/declare/host`) and in
9
10
  * handler registrations, never here. Zero React, zero `@ai-matrx/agents`.
10
11
  */
11
- type Json$2 = null | boolean | number | string | Json$2[] | {
12
- [key: string]: Json$2;
12
+ type Json$1 = null | boolean | number | string | Json$1[] | {
13
+ [key: string]: Json$1;
13
14
  };
14
15
  /** Unchanged from `ui_surface_value_type_chk`. */
15
16
  type ValueType = "string" | "number" | "boolean" | "object" | "array" | "document";
@@ -139,6 +140,8 @@ interface SurfaceDeclaration {
139
140
  configNamespaces?: readonly ConfigNamespaceDeclaration[];
140
141
  evidenceSources?: readonly EvidenceSourceDeclaration[];
141
142
  skipBaselineValues?: boolean;
143
+ /** Opt out of the host's baseline item types (`baselineItemTypes`, e.g. `TABLE_ROW_ITEM_TYPE`). */
144
+ skipBaselineItemTypes?: boolean;
142
145
  }
143
146
  type ValueProvenance = {
144
147
  kind: "own";
@@ -167,7 +170,7 @@ type QualifiedValueKey = string;
167
170
  /** Live slot payloads (page-capture's shapes, kept). */
168
171
  interface LiveValues {
169
172
  selection?: {
170
- choices: Record<string, Json$2>;
173
+ choices: Record<string, Json$1>;
171
174
  text: string | null;
172
175
  };
173
176
  "on-demand"?: readonly OnDemandSection[];
@@ -179,8 +182,8 @@ interface OnDemandSection {
179
182
  title: string;
180
183
  description?: string;
181
184
  role: "data" | "request";
182
- brief?: Json$2;
183
- load(signal: AbortSignal): Promise<Json$2>;
185
+ brief?: Json$1;
186
+ load(signal: AbortSignal): Promise<Json$1>;
184
187
  }
185
188
  interface RecentRequest {
186
189
  method: string;
@@ -190,7 +193,7 @@ interface RecentRequest {
190
193
  durationMs?: number;
191
194
  requestId?: string;
192
195
  client?: string;
193
- requestBody?: Json$2;
196
+ requestBody?: Json$1;
194
197
  requestBodyNote?: string;
195
198
  errorSentence?: string;
196
199
  timestamp: number;
@@ -259,14 +262,6 @@ interface ClickTarget {
259
262
  host?: unknown;
260
263
  }
261
264
 
262
- /**
263
- * Framework-neutral transfer contracts (Alchemy Operate, CONTRACT §2.3). All data crossing this boundary is JSON.
264
- * Moved from `@ai-matrx/kit/content-transfer` in ALC-16; the format-adapter contract lives in `./contract`.
265
- */
266
- type Json$1 = null | boolean | number | string | Json$1[] | {
267
- [key: string]: Json$1;
268
- };
269
-
270
265
  /**
271
266
  * Operate — the format and delivery contract (Matrx Alchemy CONTRACT §2.3, ALC-16).
272
267
  *
@@ -296,7 +291,7 @@ type Receipt = {
296
291
  sentence: string;
297
292
  warning?: string;
298
293
  fix?: string; /** What the handler produced (e.g. the created record). */
299
- result?: Json$1;
294
+ result?: Json$2;
300
295
  } | {
301
296
  status: "queued";
302
297
  to: WriteTargetRef;
@@ -456,7 +451,7 @@ type ActionResult<T = unknown> = {
456
451
  /** `POST /actions/run` (aidream) — the request. */
457
452
  interface ServerActionRunRequest {
458
453
  name: string;
459
- input: Json$2;
454
+ input: Json$1;
460
455
  by: ActionCaller;
461
456
  surface_name?: string;
462
457
  policy?: ActionPolicy;
@@ -465,8 +460,8 @@ interface ServerActionRunRequest {
465
460
  interface ServerActionRunResponse {
466
461
  status: "applied" | "proposed" | "refused";
467
462
  message: string;
468
- receipts: Json$2[];
469
- proposal?: Json$2;
463
+ receipts: Json$1[];
464
+ proposal?: Json$1;
470
465
  }
471
466
  /** A mandate run request: by alias (an Action's `target`) or by key. */
472
467
  type MandateRunRequest = ({
@@ -476,7 +471,7 @@ type MandateRunRequest = ({
476
471
  key: string;
477
472
  alias?: never;
478
473
  }) & {
479
- variables: Record<string, Json$2>;
474
+ variables: Record<string, Json$1>;
480
475
  userInput?: string;
481
476
  by: ActionCaller;
482
477
  policy: ActionPolicy;
@@ -1008,11 +1003,11 @@ interface ReadOmission {
1008
1003
  */
1009
1004
  interface ProjectedReads {
1010
1005
  values(signal: AbortSignal): Promise<{
1011
- values: Record<string, Json$2>;
1006
+ values: Record<string, Json$1>;
1012
1007
  omissions: readonly ReadOmission[];
1013
1008
  }>;
1014
1009
  item(signal: AbortSignal): Promise<{
1015
- values: Record<string, Json$2>;
1010
+ values: Record<string, Json$1>;
1016
1011
  omissions: readonly ReadOmission[];
1017
1012
  } | null>;
1018
1013
  live(signal: AbortSignal): Promise<LiveValues>;
@@ -142,6 +142,8 @@ interface SurfaceDeclaration {
142
142
  configNamespaces?: readonly ConfigNamespaceDeclaration[];
143
143
  evidenceSources?: readonly EvidenceSourceDeclaration[];
144
144
  skipBaselineValues?: boolean;
145
+ /** Opt out of the host's baseline item types (`baselineItemTypes`, e.g. `TABLE_ROW_ITEM_TYPE`). */
146
+ skipBaselineItemTypes?: boolean;
145
147
  }
146
148
  type ValueProvenance = {
147
149
  kind: "own";
@@ -142,6 +142,8 @@ interface SurfaceDeclaration {
142
142
  configNamespaces?: readonly ConfigNamespaceDeclaration[];
143
143
  evidenceSources?: readonly EvidenceSourceDeclaration[];
144
144
  skipBaselineValues?: boolean;
145
+ /** Opt out of the host's baseline item types (`baselineItemTypes`, e.g. `TABLE_ROW_ITEM_TYPE`). */
146
+ skipBaselineItemTypes?: boolean;
145
147
  }
146
148
  type ValueProvenance = {
147
149
  kind: "own";
@@ -1,5 +1,6 @@
1
1
  import * as React from 'react';
2
2
  import { TransferOutcome } from '@ai-matrx/alchemy/operate';
3
+ import { Json as Json$2 } from '@ai-matrx/kit/transfer-json';
3
4
 
4
5
  /**
5
6
  * Matrx Alchemy — Declare types (CONTRACT §2.1).
@@ -8,8 +9,8 @@ import { TransferOutcome } from '@ai-matrx/alchemy/operate';
8
9
  * no React. Runtime behaviour lives in `MountedSurface` (`/declare/host`) and in
9
10
  * handler registrations, never here. Zero React, zero `@ai-matrx/agents`.
10
11
  */
11
- type Json$2 = null | boolean | number | string | Json$2[] | {
12
- [key: string]: Json$2;
12
+ type Json$1 = null | boolean | number | string | Json$1[] | {
13
+ [key: string]: Json$1;
13
14
  };
14
15
  /** Unchanged from `ui_surface_value_type_chk`. */
15
16
  type ValueType = "string" | "number" | "boolean" | "object" | "array" | "document";
@@ -139,6 +140,8 @@ interface SurfaceDeclaration {
139
140
  configNamespaces?: readonly ConfigNamespaceDeclaration[];
140
141
  evidenceSources?: readonly EvidenceSourceDeclaration[];
141
142
  skipBaselineValues?: boolean;
143
+ /** Opt out of the host's baseline item types (`baselineItemTypes`, e.g. `TABLE_ROW_ITEM_TYPE`). */
144
+ skipBaselineItemTypes?: boolean;
142
145
  }
143
146
  type ValueProvenance = {
144
147
  kind: "own";
@@ -167,7 +170,7 @@ type QualifiedValueKey = string;
167
170
  /** Live slot payloads (page-capture's shapes, kept). */
168
171
  interface LiveValues {
169
172
  selection?: {
170
- choices: Record<string, Json$2>;
173
+ choices: Record<string, Json$1>;
171
174
  text: string | null;
172
175
  };
173
176
  "on-demand"?: readonly OnDemandSection[];
@@ -179,8 +182,8 @@ interface OnDemandSection {
179
182
  title: string;
180
183
  description?: string;
181
184
  role: "data" | "request";
182
- brief?: Json$2;
183
- load(signal: AbortSignal): Promise<Json$2>;
185
+ brief?: Json$1;
186
+ load(signal: AbortSignal): Promise<Json$1>;
184
187
  }
185
188
  interface RecentRequest {
186
189
  method: string;
@@ -190,7 +193,7 @@ interface RecentRequest {
190
193
  durationMs?: number;
191
194
  requestId?: string;
192
195
  client?: string;
193
- requestBody?: Json$2;
196
+ requestBody?: Json$1;
194
197
  requestBodyNote?: string;
195
198
  errorSentence?: string;
196
199
  timestamp: number;
@@ -259,14 +262,6 @@ interface ClickTarget {
259
262
  host?: unknown;
260
263
  }
261
264
 
262
- /**
263
- * Framework-neutral transfer contracts (Alchemy Operate, CONTRACT §2.3). All data crossing this boundary is JSON.
264
- * Moved from `@ai-matrx/kit/content-transfer` in ALC-16; the format-adapter contract lives in `./contract`.
265
- */
266
- type Json$1 = null | boolean | number | string | Json$1[] | {
267
- [key: string]: Json$1;
268
- };
269
-
270
265
  /**
271
266
  * Operate — the format and delivery contract (Matrx Alchemy CONTRACT §2.3, ALC-16).
272
267
  *
@@ -296,7 +291,7 @@ type Receipt = {
296
291
  sentence: string;
297
292
  warning?: string;
298
293
  fix?: string; /** What the handler produced (e.g. the created record). */
299
- result?: Json$1;
294
+ result?: Json$2;
300
295
  } | {
301
296
  status: "queued";
302
297
  to: WriteTargetRef;
@@ -456,7 +451,7 @@ type ActionResult<T = unknown> = {
456
451
  /** `POST /actions/run` (aidream) — the request. */
457
452
  interface ServerActionRunRequest {
458
453
  name: string;
459
- input: Json$2;
454
+ input: Json$1;
460
455
  by: ActionCaller;
461
456
  surface_name?: string;
462
457
  policy?: ActionPolicy;
@@ -465,8 +460,8 @@ interface ServerActionRunRequest {
465
460
  interface ServerActionRunResponse {
466
461
  status: "applied" | "proposed" | "refused";
467
462
  message: string;
468
- receipts: Json$2[];
469
- proposal?: Json$2;
463
+ receipts: Json$1[];
464
+ proposal?: Json$1;
470
465
  }
471
466
  /** A mandate run request: by alias (an Action's `target`) or by key. */
472
467
  type MandateRunRequest = ({
@@ -476,7 +471,7 @@ type MandateRunRequest = ({
476
471
  key: string;
477
472
  alias?: never;
478
473
  }) & {
479
- variables: Record<string, Json$2>;
474
+ variables: Record<string, Json$1>;
480
475
  userInput?: string;
481
476
  by: ActionCaller;
482
477
  policy: ActionPolicy;
@@ -1008,11 +1003,11 @@ interface ReadOmission {
1008
1003
  */
1009
1004
  interface ProjectedReads {
1010
1005
  values(signal: AbortSignal): Promise<{
1011
- values: Record<string, Json$2>;
1006
+ values: Record<string, Json$1>;
1012
1007
  omissions: readonly ReadOmission[];
1013
1008
  }>;
1014
1009
  item(signal: AbortSignal): Promise<{
1015
- values: Record<string, Json$2>;
1010
+ values: Record<string, Json$1>;
1016
1011
  omissions: readonly ReadOmission[];
1017
1012
  } | null>;
1018
1013
  live(signal: AbortSignal): Promise<LiveValues>;
@@ -1,5 +1,6 @@
1
1
  import * as React from 'react';
2
2
  import { TransferOutcome } from '@ai-matrx/alchemy/operate';
3
+ import { Json as Json$2 } from '@ai-matrx/kit/transfer-json';
3
4
 
4
5
  /**
5
6
  * Matrx Alchemy — Declare types (CONTRACT §2.1).
@@ -8,8 +9,8 @@ import { TransferOutcome } from '@ai-matrx/alchemy/operate';
8
9
  * no React. Runtime behaviour lives in `MountedSurface` (`/declare/host`) and in
9
10
  * handler registrations, never here. Zero React, zero `@ai-matrx/agents`.
10
11
  */
11
- type Json$2 = null | boolean | number | string | Json$2[] | {
12
- [key: string]: Json$2;
12
+ type Json$1 = null | boolean | number | string | Json$1[] | {
13
+ [key: string]: Json$1;
13
14
  };
14
15
  /** Unchanged from `ui_surface_value_type_chk`. */
15
16
  type ValueType = "string" | "number" | "boolean" | "object" | "array" | "document";
@@ -139,6 +140,8 @@ interface SurfaceDeclaration {
139
140
  configNamespaces?: readonly ConfigNamespaceDeclaration[];
140
141
  evidenceSources?: readonly EvidenceSourceDeclaration[];
141
142
  skipBaselineValues?: boolean;
143
+ /** Opt out of the host's baseline item types (`baselineItemTypes`, e.g. `TABLE_ROW_ITEM_TYPE`). */
144
+ skipBaselineItemTypes?: boolean;
142
145
  }
143
146
  type ValueProvenance = {
144
147
  kind: "own";
@@ -167,7 +170,7 @@ type QualifiedValueKey = string;
167
170
  /** Live slot payloads (page-capture's shapes, kept). */
168
171
  interface LiveValues {
169
172
  selection?: {
170
- choices: Record<string, Json$2>;
173
+ choices: Record<string, Json$1>;
171
174
  text: string | null;
172
175
  };
173
176
  "on-demand"?: readonly OnDemandSection[];
@@ -179,8 +182,8 @@ interface OnDemandSection {
179
182
  title: string;
180
183
  description?: string;
181
184
  role: "data" | "request";
182
- brief?: Json$2;
183
- load(signal: AbortSignal): Promise<Json$2>;
185
+ brief?: Json$1;
186
+ load(signal: AbortSignal): Promise<Json$1>;
184
187
  }
185
188
  interface RecentRequest {
186
189
  method: string;
@@ -190,7 +193,7 @@ interface RecentRequest {
190
193
  durationMs?: number;
191
194
  requestId?: string;
192
195
  client?: string;
193
- requestBody?: Json$2;
196
+ requestBody?: Json$1;
194
197
  requestBodyNote?: string;
195
198
  errorSentence?: string;
196
199
  timestamp: number;
@@ -259,14 +262,6 @@ interface ClickTarget {
259
262
  host?: unknown;
260
263
  }
261
264
 
262
- /**
263
- * Framework-neutral transfer contracts (Alchemy Operate, CONTRACT §2.3). All data crossing this boundary is JSON.
264
- * Moved from `@ai-matrx/kit/content-transfer` in ALC-16; the format-adapter contract lives in `./contract`.
265
- */
266
- type Json$1 = null | boolean | number | string | Json$1[] | {
267
- [key: string]: Json$1;
268
- };
269
-
270
265
  /**
271
266
  * Operate — the format and delivery contract (Matrx Alchemy CONTRACT §2.3, ALC-16).
272
267
  *
@@ -296,7 +291,7 @@ type Receipt = {
296
291
  sentence: string;
297
292
  warning?: string;
298
293
  fix?: string; /** What the handler produced (e.g. the created record). */
299
- result?: Json$1;
294
+ result?: Json$2;
300
295
  } | {
301
296
  status: "queued";
302
297
  to: WriteTargetRef;
@@ -456,7 +451,7 @@ type ActionResult<T = unknown> = {
456
451
  /** `POST /actions/run` (aidream) — the request. */
457
452
  interface ServerActionRunRequest {
458
453
  name: string;
459
- input: Json$2;
454
+ input: Json$1;
460
455
  by: ActionCaller;
461
456
  surface_name?: string;
462
457
  policy?: ActionPolicy;
@@ -465,8 +460,8 @@ interface ServerActionRunRequest {
465
460
  interface ServerActionRunResponse {
466
461
  status: "applied" | "proposed" | "refused";
467
462
  message: string;
468
- receipts: Json$2[];
469
- proposal?: Json$2;
463
+ receipts: Json$1[];
464
+ proposal?: Json$1;
470
465
  }
471
466
  /** A mandate run request: by alias (an Action's `target`) or by key. */
472
467
  type MandateRunRequest = ({
@@ -476,7 +471,7 @@ type MandateRunRequest = ({
476
471
  key: string;
477
472
  alias?: never;
478
473
  }) & {
479
- variables: Record<string, Json$2>;
474
+ variables: Record<string, Json$1>;
480
475
  userInput?: string;
481
476
  by: ActionCaller;
482
477
  policy: ActionPolicy;
@@ -1008,11 +1003,11 @@ interface ReadOmission {
1008
1003
  */
1009
1004
  interface ProjectedReads {
1010
1005
  values(signal: AbortSignal): Promise<{
1011
- values: Record<string, Json$2>;
1006
+ values: Record<string, Json$1>;
1012
1007
  omissions: readonly ReadOmission[];
1013
1008
  }>;
1014
1009
  item(signal: AbortSignal): Promise<{
1015
- values: Record<string, Json$2>;
1010
+ values: Record<string, Json$1>;
1016
1011
  omissions: readonly ReadOmission[];
1017
1012
  } | null>;
1018
1013
  live(signal: AbortSignal): Promise<LiveValues>;
@@ -139,6 +139,8 @@ interface SurfaceDeclaration {
139
139
  configNamespaces?: readonly ConfigNamespaceDeclaration[];
140
140
  evidenceSources?: readonly EvidenceSourceDeclaration[];
141
141
  skipBaselineValues?: boolean;
142
+ /** Opt out of the host's baseline item types (`baselineItemTypes`, e.g. `TABLE_ROW_ITEM_TYPE`). */
143
+ skipBaselineItemTypes?: boolean;
142
144
  }
143
145
  type ValueProvenance = {
144
146
  kind: "own";