@ai-matrx/agents 0.17.3 → 0.17.4

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 0.17.4
+### Unreleased
+
+### Added
+
+- `./content-transfer`: `preparedContentOfferedValues(snapshot, draft)` and the
+  Alchemy preparation launch now sends the `alchemy.prepared_content` offered
+  values by name (`coverage_status`, `included_count`, `total_count`,
+  `coverage_unit`, `coverage_reason`, `payload_kind`, `row_count`,
+  `column_labels`, `omission_reasons`, `omission_count`, `section_labels`,
+  `has_unsaved_changes`, `captured_at`, `manually_edited`) beside the four
+  existing variables. Absent facts are omitted. These are mapped-only on the
+  server, so no current Holder's payload changes.
+
+### Consumer action
+
+- None.
+
 ## 0.17.3
 
 Automatic changed-only republish (docs/metadata drift since the last tag — see

package/dist/content-transfer/index.cjs

@@ -22,7 +22,8 @@ var content_transfer_exports = {};
 __export(content_transfer_exports, {
   createMatrxContentTransferAdapter: () => createMatrxContentTransferAdapter,
   createMatrxTransferActions: () => createMatrxTransferActions,
-  createMatrxTransferPorts: () => createMatrxTransferPorts
+  createMatrxTransferPorts: () => createMatrxTransferPorts,
+  preparedContentOfferedValues: () => preparedContentOfferedValues
 });
 module.exports = __toCommonJS(content_transfer_exports);
 
@@ -1389,6 +1390,31 @@ function descriptionForOmissions(draft) {
     (o) => `${o.path || "document"}: ${o.reason}${o.count === void 0 ? "" : ` (${o.count})`}`
   ).join("; ");
 }
+function preparedContentOfferedValues(snapshot, draft) {
+  const { coverage } = snapshot;
+  const values = {
+    coverage_status: coverage.status,
+    included_count: coverage.included,
+    payload_kind: draft.payload.kind,
+    omission_count: draft.omissions.length,
+    has_unsaved_changes: snapshot.unsavedChanges,
+    manually_edited: draft.manuallyEdited
+  };
+  if (coverage.total !== null) values.total_count = coverage.total;
+  if (coverage.unit) values.coverage_unit = coverage.unit;
+  if (coverage.reason) values.coverage_reason = coverage.reason;
+  if (draft.payload.kind === "rows") {
+    values.row_count = draft.payload.rows.length;
+    const labels = draft.payload.columns.filter((column) => column.visible).map((column) => column.label);
+    if (labels.length > 0) values.column_labels = labels;
+  }
+  if (draft.omissions.length > 0)
+    values.omission_reasons = draft.omissions.map((o) => o.reason);
+  const sections = snapshot.sections.map((section) => section.label);
+  if (sections.length > 0) values.section_labels = sections;
+  if (snapshot.capturedAt) values.captured_at = snapshot.capturedAt;
+  return values;
+}
 function visibleAssistantText(content) {
   if (typeof content === "string") return content.trim() || null;
   if (!Array.isArray(content)) return null;
@@ -1644,7 +1670,8 @@ function createMatrxContentTransferAdapter(options) {
                   input.snapshot,
                   input.draft
                 ),
-                omission_description: descriptionForOmissions(input.draft)
+                omission_description: descriptionForOmissions(input.draft),
+                ...preparedContentOfferedValues(input.snapshot, input.draft)
               }
             },
             { signal }