@ai-matrx/agents 0.17.2 → 0.17.4

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.
@@ -131,6 +131,14 @@ interface MatrxContentTransferLaunchInput {
131
131
  signal?: AbortSignal;
132
132
  onProgress?: (progress: MatrxContentTransferProgress) => void;
133
133
  }
134
+ /**
135
+ * The mapped-only offered values of `alchemy.prepared_content` (server
136
+ * `client_mandates.py`), built from facts this launch already holds. Sent by
137
+ * name beside the four by-name values; the mandate door drops them unless a
138
+ * binding's consumption map names one, so no current Holder's payload changes.
139
+ * Absent facts are omitted, never sent empty.
140
+ */
141
+ declare function preparedContentOfferedValues(snapshot: Snapshot, draft: Draft): Record<string, string | number | boolean | string[]>;
134
142
  /** One monotonic generation fences every public launch/recover/rejoin. */
135
143
  declare function createMatrxContentTransferAdapter(options: MatrxContentTransferAdapterOptions): {
136
144
  launch(input: MatrxContentTransferLaunchInput): Promise<MatrxContentTransferResult>;
@@ -140,4 +148,4 @@ declare function createMatrxContentTransferAdapter(options: MatrxContentTransfer
140
148
  };
141
149
  type MatrxContentTransferAdapter = ReturnType<typeof createMatrxContentTransferAdapter>;
142
150
 
143
- export { type MatrxContentTransferAdapter, type MatrxContentTransferAdapterOptions, type MatrxContentTransferDbResponse, type MatrxContentTransferDbRow, type MatrxContentTransferIdentity, type MatrxContentTransferLaunchInput, type MatrxContentTransferProgress, type MatrxContentTransferQuery, type MatrxContentTransferResult, type MatrxContentTransferStatus, type MatrxContentTransferSupabase, type MatrxTransferAction, type MatrxTransferBindings, type MatrxTransferContent, type MatrxTransferDestination, type MatrxTransferIdentity, type MatrxTransferPorts, createMatrxContentTransferAdapter, createMatrxTransferActions, createMatrxTransferPorts };
151
+ export { type MatrxContentTransferAdapter, type MatrxContentTransferAdapterOptions, type MatrxContentTransferDbResponse, type MatrxContentTransferDbRow, type MatrxContentTransferIdentity, type MatrxContentTransferLaunchInput, type MatrxContentTransferProgress, type MatrxContentTransferQuery, type MatrxContentTransferResult, type MatrxContentTransferStatus, type MatrxContentTransferSupabase, type MatrxTransferAction, type MatrxTransferBindings, type MatrxTransferContent, type MatrxTransferDestination, type MatrxTransferIdentity, type MatrxTransferPorts, createMatrxContentTransferAdapter, createMatrxTransferActions, createMatrxTransferPorts, preparedContentOfferedValues };
@@ -131,6 +131,14 @@ interface MatrxContentTransferLaunchInput {
131
131
  signal?: AbortSignal;
132
132
  onProgress?: (progress: MatrxContentTransferProgress) => void;
133
133
  }
134
+ /**
135
+ * The mapped-only offered values of `alchemy.prepared_content` (server
136
+ * `client_mandates.py`), built from facts this launch already holds. Sent by
137
+ * name beside the four by-name values; the mandate door drops them unless a
138
+ * binding's consumption map names one, so no current Holder's payload changes.
139
+ * Absent facts are omitted, never sent empty.
140
+ */
141
+ declare function preparedContentOfferedValues(snapshot: Snapshot, draft: Draft): Record<string, string | number | boolean | string[]>;
134
142
  /** One monotonic generation fences every public launch/recover/rejoin. */
135
143
  declare function createMatrxContentTransferAdapter(options: MatrxContentTransferAdapterOptions): {
136
144
  launch(input: MatrxContentTransferLaunchInput): Promise<MatrxContentTransferResult>;
@@ -140,4 +148,4 @@ declare function createMatrxContentTransferAdapter(options: MatrxContentTransfer
140
148
  };
141
149
  type MatrxContentTransferAdapter = ReturnType<typeof createMatrxContentTransferAdapter>;
142
150
 
143
- export { type MatrxContentTransferAdapter, type MatrxContentTransferAdapterOptions, type MatrxContentTransferDbResponse, type MatrxContentTransferDbRow, type MatrxContentTransferIdentity, type MatrxContentTransferLaunchInput, type MatrxContentTransferProgress, type MatrxContentTransferQuery, type MatrxContentTransferResult, type MatrxContentTransferStatus, type MatrxContentTransferSupabase, type MatrxTransferAction, type MatrxTransferBindings, type MatrxTransferContent, type MatrxTransferDestination, type MatrxTransferIdentity, type MatrxTransferPorts, createMatrxContentTransferAdapter, createMatrxTransferActions, createMatrxTransferPorts };
151
+ export { type MatrxContentTransferAdapter, type MatrxContentTransferAdapterOptions, type MatrxContentTransferDbResponse, type MatrxContentTransferDbRow, type MatrxContentTransferIdentity, type MatrxContentTransferLaunchInput, type MatrxContentTransferProgress, type MatrxContentTransferQuery, type MatrxContentTransferResult, type MatrxContentTransferStatus, type MatrxContentTransferSupabase, type MatrxTransferAction, type MatrxTransferBindings, type MatrxTransferContent, type MatrxTransferDestination, type MatrxTransferIdentity, type MatrxTransferPorts, createMatrxContentTransferAdapter, createMatrxTransferActions, createMatrxTransferPorts, preparedContentOfferedValues };
@@ -1367,6 +1367,31 @@ function descriptionForOmissions(draft) {
1367
1367
  (o) => `${o.path || "document"}: ${o.reason}${o.count === void 0 ? "" : ` (${o.count})`}`
1368
1368
  ).join("; ");
1369
1369
  }
1370
+ function preparedContentOfferedValues(snapshot, draft) {
1371
+ const { coverage } = snapshot;
1372
+ const values = {
1373
+ coverage_status: coverage.status,
1374
+ included_count: coverage.included,
1375
+ payload_kind: draft.payload.kind,
1376
+ omission_count: draft.omissions.length,
1377
+ has_unsaved_changes: snapshot.unsavedChanges,
1378
+ manually_edited: draft.manuallyEdited
1379
+ };
1380
+ if (coverage.total !== null) values.total_count = coverage.total;
1381
+ if (coverage.unit) values.coverage_unit = coverage.unit;
1382
+ if (coverage.reason) values.coverage_reason = coverage.reason;
1383
+ if (draft.payload.kind === "rows") {
1384
+ values.row_count = draft.payload.rows.length;
1385
+ const labels = draft.payload.columns.filter((column) => column.visible).map((column) => column.label);
1386
+ if (labels.length > 0) values.column_labels = labels;
1387
+ }
1388
+ if (draft.omissions.length > 0)
1389
+ values.omission_reasons = draft.omissions.map((o) => o.reason);
1390
+ const sections = snapshot.sections.map((section) => section.label);
1391
+ if (sections.length > 0) values.section_labels = sections;
1392
+ if (snapshot.capturedAt) values.captured_at = snapshot.capturedAt;
1393
+ return values;
1394
+ }
1370
1395
  function visibleAssistantText(content) {
1371
1396
  if (typeof content === "string") return content.trim() || null;
1372
1397
  if (!Array.isArray(content)) return null;
@@ -1622,7 +1647,8 @@ function createMatrxContentTransferAdapter(options) {
1622
1647
  input.snapshot,
1623
1648
  input.draft
1624
1649
  ),
1625
- omission_description: descriptionForOmissions(input.draft)
1650
+ omission_description: descriptionForOmissions(input.draft),
1651
+ ...preparedContentOfferedValues(input.snapshot, input.draft)
1626
1652
  }
1627
1653
  },
1628
1654
  { signal }
@@ -1719,6 +1745,7 @@ function createMatrxContentTransferAdapter(options) {
1719
1745
  export {
1720
1746
  createMatrxContentTransferAdapter,
1721
1747
  createMatrxTransferActions,
1722
- createMatrxTransferPorts
1748
+ createMatrxTransferPorts,
1749
+ preparedContentOfferedValues
1723
1750
  };
1724
1751
  //# sourceMappingURL=index.js.map