agentxchain 2.145.0 → 2.147.0

package/src/lib/turn-result-shape.js

@@ -0,0 +1,38 @@
+/**
+ * Lightweight staged turn-result shape guard.
+ *
+ * This is intentionally weaker than full acceptance validation. It exists for
+ * adapter pre-stage checks so obviously incomplete payloads (`{}`,
+ * `{"turn_id":"t1"}`, etc.) are rejected before they can be written into the
+ * governed staging path and mistaken for meaningful execution output.
+ */
+
+function isNonEmptyString(value) {
+  return typeof value === 'string' && value.trim() !== '';
+}
+
+/**
+ * Returns true when `value` has the minimum governed turn-result envelope:
+ *   - `schema_version`
+ *   - at least one identity field (`run_id` or `turn_id`)
+ *   - at least one lifecycle field (`status`, `role`, or `runtime_id`)
+ *
+ * Full schema validation still happens later via `validateStagedTurnResult`.
+ *
+ * @param {unknown} value
+ * @returns {boolean}
+ */
+export function hasMinimumTurnResultShape(value) {
+  if (!value || typeof value !== 'object' || Array.isArray(value)) {
+    return false;
+  }
+
+  const candidate = /** @type {Record<string, unknown>} */ (value);
+  const hasSchemaVersion = isNonEmptyString(candidate.schema_version);
+  const hasIdentity = isNonEmptyString(candidate.run_id) || isNonEmptyString(candidate.turn_id);
+  const hasLifecycle = isNonEmptyString(candidate.status)
+    || isNonEmptyString(candidate.role)
+    || isNonEmptyString(candidate.runtime_id);
+
+  return hasSchemaVersion && hasIdentity && hasLifecycle;
+}

package/src/lib/turn-result-validator.js

@@ -75,7 +75,10 @@ export function validateStagedTurnResult(root, state, config, opts = {}) {
   const normContext = {};
   if (state) {
     normContext.phase = state.phase;
-    // Support both active_turns (v2+) and legacy current_turn formats
+    // Prefer active_turns (the persisted schema field); fall back to the
+    // current_turn compatibility alias for callers that pass a state shape
+    // built outside loadProjectState() (e.g. raw fixtures). Both surfaces are
+    // live per DEC-CURRENT-TURN-COMPAT-ALIAS-001 — current_turn is not legacy.
     const activeTurn = getActiveTurn(state) || state.current_turn;
     if (activeTurn) {
       const roleKey = activeTurn.assigned_role || activeTurn.role;