agentxchain 2.60.0 → 2.61.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agentxchain",
-  "version": "2.60.0",
+  "version": "2.61.0",
   "description": "CLI for AgentXchain — governed multi-agent software delivery",
   "type": "module",
   "bin": {

package/src/lib/governed-state.js

@@ -575,7 +575,7 @@ function attachLegacyCurrentTurnAlias(state) {
 function formatBudgetRecoveryAction(isReadyToResume) {
   return isReadyToResume
     ? 'Run agentxchain resume to assign the next turn'
-    : 'Increase per_run_max_usd in agentxchain.json, then run agentxchain resume';
+    : 'Increase budget with agentxchain config --set budget.per_run_max_usd <usd>, then run agentxchain resume';
 }
 
 function formatBudgetRecoveryDetail(spentUsd, limitUsd, remainingUsd, isReadyToResume) {
@@ -1938,7 +1938,7 @@ export function assignGovernedTurn(root, config, roleId) {
 
   // DEC-BUDGET-ENFORCE-001: Pre-assignment budget exhaustion guard
   if (state.budget_status?.remaining_usd != null && state.budget_status.remaining_usd <= 0) {
-    return { ok: false, error: `Cannot assign turn: run budget exhausted (spent $${(state.budget_status.spent_usd || 0).toFixed(2)} of $${((state.budget_status.spent_usd || 0) + state.budget_status.remaining_usd).toFixed(2)} limit). Increase per_run_max_usd in agentxchain.json, then run agentxchain resume` };
+    return { ok: false, error: `Cannot assign turn: run budget exhausted (spent $${(state.budget_status.spent_usd || 0).toFixed(2)} of $${((state.budget_status.spent_usd || 0) + state.budget_status.remaining_usd).toFixed(2)} limit). Increase budget with agentxchain config --set budget.per_run_max_usd <usd>, then run agentxchain resume` };
   }
 
   // DEC-PARALLEL-011: Budget reservation
@@ -2675,7 +2675,7 @@ function _acceptGovernedTurnLocked(root, config, opts) {
         recovery: {
           typed_reason: 'budget_exhausted',
           owner: 'human',
-          recovery_action: 'Increase per_run_max_usd in agentxchain.json, then run agentxchain resume',
+          recovery_action: 'Increase budget with agentxchain config --set budget.per_run_max_usd <usd>, then run agentxchain resume',
           turn_retained: false,
           detail: `Run budget exhausted: spent $${updatedState.budget_status.spent_usd.toFixed(2)} of $${limit.toFixed(2)} limit ($${overBy.toFixed(2)} over)`,
         },

package/src/lib/normalized-config.js

@@ -61,6 +61,7 @@ const VALID_API_PROXY_PREFLIGHT_FIELDS = [
   'tokenizer',
   'safety_margin_tokens',
 ];
+const VALID_BUDGET_ON_EXCEED = ['pause_and_escalate'];
 
 function validateMcpRuntime(runtimeId, runtime, errors) {
   const transport = typeof runtime?.transport === 'string' && runtime.transport.trim()
@@ -537,6 +538,12 @@ export function validateV4Config(data, projectRoot) {
     errors.push(...policyValidation.errors);
   }
 
+  // Budget (optional but validated if present)
+  if (data.budget !== undefined) {
+    const budgetValidation = validateBudgetConfig(data.budget);
+    errors.push(...budgetValidation.errors);
+  }
+
   // Approval Policy (optional but validated if present)
   if (data.approval_policy !== undefined) {
     errors.push(...validateApprovalPolicy(data.approval_policy, data.routing));
@@ -551,6 +558,80 @@ export function validateV4Config(data, projectRoot) {
   return { ok: errors.length === 0, errors };
 }
 
+export function validateBudgetConfig(budget) {
+  const errors = [];
+
+  if (budget === null) {
+    return { ok: true, errors };
+  }
+
+  if (!budget || typeof budget !== 'object' || Array.isArray(budget)) {
+    errors.push('budget must be an object');
+    return { ok: false, errors };
+  }
+
+  validateBudgetUsdLimit('budget.per_turn_max_usd', budget.per_turn_max_usd, errors);
+  validateBudgetUsdLimit('budget.per_run_max_usd', budget.per_run_max_usd, errors);
+
+  if (
+    Number.isFinite(budget.per_turn_max_usd) &&
+    Number.isFinite(budget.per_run_max_usd) &&
+    budget.per_turn_max_usd > budget.per_run_max_usd
+  ) {
+    errors.push('budget.per_turn_max_usd must be less than or equal to budget.per_run_max_usd when both are set');
+  }
+
+  if (budget.on_exceed !== undefined) {
+    if (typeof budget.on_exceed !== 'string' || !VALID_BUDGET_ON_EXCEED.includes(budget.on_exceed)) {
+      errors.push(`budget.on_exceed must be one of: ${VALID_BUDGET_ON_EXCEED.join(', ')} (warn is not implemented)`);
+    }
+  }
+
+  if (budget.cost_rates !== undefined) {
+    if (!budget.cost_rates || typeof budget.cost_rates !== 'object' || Array.isArray(budget.cost_rates)) {
+      errors.push('budget.cost_rates must be an object');
+    } else {
+      for (const [model, rates] of Object.entries(budget.cost_rates)) {
+        if (typeof model !== 'string' || !model.trim()) {
+          errors.push('budget.cost_rates model keys must be non-empty strings');
+          continue;
+        }
+        if (!rates || typeof rates !== 'object' || Array.isArray(rates)) {
+          errors.push(`budget.cost_rates.${model} must be an object`);
+          continue;
+        }
+        validateBudgetCostRate(`budget.cost_rates.${model}.input_per_1m`, rates.input_per_1m, errors);
+        validateBudgetCostRate(`budget.cost_rates.${model}.output_per_1m`, rates.output_per_1m, errors);
+      }
+    }
+  }
+
+  return { ok: errors.length === 0, errors };
+}
+
+function validateBudgetUsdLimit(path, value, errors) {
+  if (value === undefined || value === null) {
+    return;
+  }
+  if (typeof value !== 'number' || !Number.isFinite(value)) {
+    errors.push(`${path} must be a finite number when provided`);
+    return;
+  }
+  if (value <= 0) {
+    errors.push(`${path} must be greater than 0 when provided`);
+  }
+}
+
+function validateBudgetCostRate(path, value, errors) {
+  if (typeof value !== 'number' || !Number.isFinite(value)) {
+    errors.push(`${path} must be a finite number`);
+    return;
+  }
+  if (value < 0) {
+    errors.push(`${path} must be greater than or equal to 0`);
+  }
+}
+
 export function validateSchedulesConfig(schedules, roles) {
   const errors = [];