xytara 2.2.0 → 2.3.0

package/RELEASE_NOTES.md

@@ -1,17 +1,17 @@
-# xytara 2.2.0 Release Notes
+# xytara 2.3.0 Release Notes
 
-`xytara` 2.2.0 is the public machine-commerce program-complete line.
+`xytara` 2.3.0 is the public machine-commerce intelligence line.
 
 Highlights:
 
 - direct one-line machine execution with `xytara-run`
-- release, comparison, adoption, scenario, and launch packs over HTTP and CLI
-- release-center, announcement-pack, and release-candidate surfaces for public launch readiness
-- credits-first reusable spend posture
-- native settlement-aware runtime inspection
-- proof-compatible handoff into `xoonya`
-- partner-ready onboarding and launch docs
-- explicit runtime durability posture, including Supabase-backed persistence on hosts without persistent disk
+- account-level economics intelligence with bounded next-best-action guidance
+- treasury intelligence for value-capture, reconciliation risk, and replenishment posture
+- partner/adoption intelligence for readiness, onboarding friction, and promotion posture
+- operator intelligence that compresses runtime economics and partner posture into one operating view
+- credits-first reusable spend posture with durable runtime economics state
+- native settlement-aware runtime inspection and proof-compatible handoff into `xoonya`
+- partner-ready onboarding, launch docs, and public example paths remain in place
 
 Recommended first checks:
 
@@ -19,7 +19,9 @@ Recommended first checks:
 2. `xytara-release --candidate --summary`
 3. `npm run verify:release-candidate`
 4. `node examples/partner_launch_walkthrough.js`
-5. inspect `/v1/release-candidate/summary` and `/v1/runtime/durability` on the deployed service
+5. inspect `/v1/economics/accounts/:account_id/intelligence-summary`
+6. inspect `/v1/partner-intelligence` and `/v1/operator-intelligence?account_id=...`
+7. inspect `/v1/runtime/durability` on the deployed service
 
 Recommended first docs:
 

package/lib/commerce_client.js

@@ -3776,6 +3776,30 @@ class CommerceClient {
     return result && result.data ? result.data : null;
   }
 
+  async getPartnerIntelligenceSummary() {
+    const result = await this.getJson("/v1/partner-intelligence/summary");
+    return result && result.data ? result.data : null;
+  }
+
+  async getPartnerIntelligencePack() {
+    const result = await this.getJson("/v1/partner-intelligence");
+    return result && result.data ? result.data : null;
+  }
+
+  async getOperatorIntelligenceSummary(accountId) {
+    const resolvedAccountId = String(accountId || this.accountId || "").trim();
+    const suffix = resolvedAccountId ? `?account_id=${encodeURIComponent(resolvedAccountId)}` : "";
+    const result = await this.getJson(`/v1/operator-intelligence/summary${suffix}`);
+    return result && result.data ? result.data : null;
+  }
+
+  async getOperatorIntelligencePack(accountId) {
+    const resolvedAccountId = String(accountId || this.accountId || "").trim();
+    const suffix = resolvedAccountId ? `?account_id=${encodeURIComponent(resolvedAccountId)}` : "";
+    const result = await this.getJson(`/v1/operator-intelligence${suffix}`);
+    return result && result.data ? result.data : null;
+  }
+
   async getCreditBalance(accountId) {
     const resolvedAccountId = String(accountId || this.accountId || "").trim();
     if (!resolvedAccountId) throw new Error("getCreditBalance requires accountId");
@@ -3783,6 +3807,20 @@ class CommerceClient {
     return result && result.data ? result.data : null;
   }
 
+  async getEconomicsIntelligenceSummary(accountId) {
+    const resolvedAccountId = String(accountId || this.accountId || "").trim();
+    if (!resolvedAccountId) throw new Error("getEconomicsIntelligenceSummary requires accountId");
+    const result = await this.getJson(`/v1/economics/accounts/${encodeURIComponent(resolvedAccountId)}/intelligence-summary`);
+    return result && result.data ? result.data : null;
+  }
+
+  async getTreasuryIntelligenceSummary(accountId) {
+    const resolvedAccountId = String(accountId || this.accountId || "").trim();
+    if (!resolvedAccountId) throw new Error("getTreasuryIntelligenceSummary requires accountId");
+    const result = await this.getJson(`/v1/economics/accounts/${encodeURIComponent(resolvedAccountId)}/treasury-intelligence-summary`);
+    return result && result.data ? result.data : null;
+  }
+
   async getUsageMeteringSummary(accountId) {
     const resolvedAccountId = String(accountId || this.accountId || "").trim();
     if (!resolvedAccountId) throw new Error("getUsageMeteringSummary requires accountId");

package/lib/commerce_economics.js

@@ -478,6 +478,113 @@ function buildCreditBalanceSummary(state, accountId) {
   };
 }
 
+function buildWalletSummary(state, accountId) {
+  const balance = buildCreditBalanceSummary(state, accountId);
+  const allocations = listAllocationEventsForAccount(state, accountId);
+  const usageMeters = listUsageMetersForAccount(state, accountId);
+  const reserveUnits = allocations
+    .filter((entry) => entry && entry.direction === "reserve")
+    .reduce((sum, entry) => sum + Number(entry.units || 0), 0);
+  const committedUnits = allocations
+    .filter((entry) => entry && entry.direction === "commit")
+    .reduce((sum, entry) => sum + Number(entry.units || 0), 0);
+  const releasedUnits = allocations
+    .filter((entry) => entry && entry.direction === "release")
+    .reduce((sum, entry) => sum + Number(entry.units || 0), 0);
+  const reversedUnits = allocations
+    .filter((entry) => entry && entry.direction === "reverse")
+    .reduce((sum, entry) => sum + Number(entry.units || 0), 0);
+  const reserveCount = allocations.filter((entry) => entry && entry.direction === "reserve").length;
+  const walletState = balance.available_units <= 0
+    ? "depleted"
+    : balance.entitlement_summary.low_entitlement_count > 0
+      ? "low_balance"
+      : "healthy";
+
+  return {
+    wallet_version: "xytara-machine-wallet-summary-v1",
+    wallet_id: `wallet_${accountId}`,
+    account_id: accountId,
+    canonical_unit: "usage_units",
+    wallet_state: walletState,
+    issued_units: balance.issued_units,
+    available_units: balance.available_units,
+    reserved_units: reserveUnits,
+    committed_units: committedUnits,
+    released_units: releasedUnits,
+    reversed_units: reversedUnits,
+    consumed_units: balance.consumed_units,
+    reserve_count: reserveCount,
+    entitlement_count: balance.entitlement_summary.entitlement_count,
+    active_entitlement_count: balance.entitlement_summary.active_entitlement_count,
+    usage_meter_count: usageMeters.length,
+    replenishment_posture: balance.replenishment_summary.depleted_count > 0
+      ? "replenishment_required"
+      : balance.replenishment_summary.low_balance_count > 0
+        ? "replenishment_recommended"
+        : "sufficient_capacity",
+    linked_surfaces: {
+      credit_balance_ref: `/v1/economics/accounts/${encodeURIComponent(accountId)}/credit-balance`,
+      entitlements_ref: `/v1/economics/accounts/${encodeURIComponent(accountId)}/entitlements`,
+      usage_meters_ref: `/v1/economics/accounts/${encodeURIComponent(accountId)}/usage-meters`,
+      wallet_ledger_summary_ref: `/v1/economics/accounts/${encodeURIComponent(accountId)}/wallet-ledger-summary`
+    },
+    generated_at_iso: nowIso()
+  };
+}
+
+function buildWalletLedgerSummary(state, accountId) {
+  const wallet = buildWalletSummary(state, accountId);
+  const allocations = listAllocationEventsForAccount(state, accountId);
+  const spends = listCreditSpendsForAccount(state, accountId);
+  const railCredits = listRailCreditsForAccount(state, accountId);
+  const consequences = {
+    mint_count: allocations.filter((entry) => entry && entry.direction === "mint").length + railCredits.length,
+    reserve_count: allocations.filter((entry) => entry && entry.direction === "reserve").length,
+    commit_count: allocations.filter((entry) => entry && entry.direction === "commit").length + spends.length,
+    release_count: allocations.filter((entry) => entry && entry.direction === "release").length,
+    reverse_count: allocations.filter((entry) => entry && entry.direction === "reverse").length
+  };
+
+  return {
+    summary_version: "xytara-wallet-ledger-summary-v1",
+    wallet_id: wallet.wallet_id,
+    account_id: accountId,
+    canonical_truth_posture: "allocation_and_consequence_records_with_materialized_wallet_summary",
+    canonical_unit: wallet.canonical_unit,
+    wallet_state: wallet.wallet_state,
+    wallet_summary: {
+      issued_units: wallet.issued_units,
+      available_units: wallet.available_units,
+      reserved_units: wallet.reserved_units,
+      committed_units: wallet.committed_units,
+      released_units: wallet.released_units,
+      reversed_units: wallet.reversed_units,
+      consumed_units: wallet.consumed_units
+    },
+    ledger_lifecycle_counts: consequences,
+    source_record_counts: {
+      allocation_count: allocations.length,
+      rail_credit_count: railCredits.length,
+      credit_spend_count: spends.length,
+      entitlement_count: wallet.entitlement_count,
+      usage_meter_count: wallet.usage_meter_count
+    },
+    translation_boundary: {
+      public_commercial_shell: "credits",
+      canonical_hidden_unit: "usage_units",
+      canonical_wallet_truth: "hidden_machine_wallet",
+      materialized_projection: "wallet_summary"
+    },
+    linked_surfaces: {
+      wallet_ref: `/v1/economics/accounts/${encodeURIComponent(accountId)}/wallet`,
+      ledger_export_ref: `/v1/economics/accounts/${encodeURIComponent(accountId)}/ledger-export`,
+      reconciliation_pack_ref: `/v1/economics/accounts/${encodeURIComponent(accountId)}/reconciliation-pack`
+    },
+    generated_at_iso: nowIso()
+  };
+}
+
 function getWorkflowTaskRefs(workflowRef) {
   const workflow = findWorkflow(workflowRef);
   if (!workflow || !Array.isArray(workflow.tasks)) return [];
@@ -922,6 +1029,199 @@ function buildTreasurySummary(state, accountId) {
   };
 }
 
+function selectRecommendedCreditPack(totalUnits, usageMeterCount) {
+  if (totalUnits >= 1500 || usageMeterCount >= 20) return "credits.fleet";
+  if (totalUnits >= 500 || usageMeterCount >= 10) return "credits.agent";
+  if (totalUnits >= 100 || usageMeterCount >= 3) return "credits.builder";
+  if (totalUnits > 0 || usageMeterCount > 0) return "credits.starter";
+  return null;
+}
+
+function buildEconomicsIntelligenceSummary(state, accountId) {
+  const balanceSummary = buildCreditBalanceSummary(state, accountId);
+  const meteringSummary = buildUsageMeteringSummary(state, accountId);
+  const replenishmentSummary = buildEntitlementReplenishmentSummary(state, accountId);
+  const treasurySummary = buildTreasurySummary(state, accountId);
+
+  const usageMeterCount = Number(meteringSummary.usage_meter_count || 0);
+  const totalUnits = Number(meteringSummary.total_units || 0);
+  const availableUnits = Number(balanceSummary.available_units || 0);
+  const consumedUnits = Number(balanceSummary.consumed_units || 0);
+  const lowBalanceCount = Number(replenishmentSummary.low_balance_count || 0);
+  const depletedCount = Number(replenishmentSummary.depleted_count || 0);
+  const mintedUnits = Number(treasurySummary.treasury && treasurySummary.treasury.minted_units || 0);
+  const settledAmountMinor = Number(treasurySummary.treasury && treasurySummary.treasury.settled_amount_minor || 0);
+  const budgetCount = Number(treasurySummary.budgets && treasurySummary.budgets.total || 0);
+
+  let recommendedFundingPosture = "direct_pay_first";
+  if (availableUnits > 0 || consumedUnits > 0 || usageMeterCount > 0) {
+    recommendedFundingPosture = "credits_first";
+  }
+  if (availableUnits <= 0 && (usageMeterCount > 0 || consumedUnits > 0)) {
+    recommendedFundingPosture = "pack_backed_credits_first";
+  }
+
+  const recommendedPackId = replenishmentSummary.recommended_pack_ids[0] || selectRecommendedCreditPack(totalUnits, usageMeterCount);
+
+  let replenishmentRiskState = "low";
+  if (lowBalanceCount > 0) replenishmentRiskState = "watch";
+  if (depletedCount > 0 || (availableUnits > 0 && availableUnits <= Math.max(8, totalUnits))) {
+    replenishmentRiskState = "high";
+  }
+
+  let treasuryHealthState = "healthy";
+  if (mintedUnits === 0 && settledAmountMinor === 0 && usageMeterCount === 0) {
+    treasuryHealthState = "pre_funding";
+  } else if (availableUnits <= 0 && (consumedUnits > 0 || usageMeterCount > 0)) {
+    treasuryHealthState = "constrained";
+  } else if (lowBalanceCount > 0 || budgetCount > 0) {
+    treasuryHealthState = "watch";
+  }
+
+  let nextBestAction = "continue_current_posture";
+  if (recommendedFundingPosture === "direct_pay_first") {
+    nextBestAction = "start_with_direct_pay";
+  }
+  if (recommendedFundingPosture === "credits_first" && recommendedPackId && usageMeterCount >= 3) {
+    nextBestAction = "consider_pack_funding";
+  }
+  if (replenishmentRiskState === "watch") {
+    nextBestAction = "prepare_replenishment";
+  }
+  if (replenishmentRiskState === "high") {
+    nextBestAction = "replenish_credits";
+  }
+  if (treasuryHealthState === "constrained") {
+    nextBestAction = "restore_runtime_balance";
+  }
+
+  return {
+    account_id: accountId,
+    category: "machine-commerce-account-economics-intelligence-summary",
+    recommended_funding_posture: recommendedFundingPosture,
+    recommended_pack_id: recommendedPackId,
+    replenishment_risk_state: replenishmentRiskState,
+    treasury_health_state: treasuryHealthState,
+    next_best_action: nextBestAction,
+    explanation_signals: {
+      available_units: availableUnits,
+      consumed_units: consumedUnits,
+      usage_meter_count: usageMeterCount,
+      metered_units: totalUnits,
+      low_balance_count: lowBalanceCount,
+      depleted_count: depletedCount,
+      recommended_replenishment_pack_ids: replenishmentSummary.recommended_pack_ids,
+      pricing_bands: meteringSummary.pricing_bands,
+      minted_units: mintedUnits,
+      settled_amount_minor: settledAmountMinor,
+      budget_count: budgetCount
+    },
+    linked_surfaces: {
+      credit_balance_ref: `/v1/economics/accounts/${encodeURIComponent(accountId)}/credit-balance`,
+      metering_summary_ref: `/v1/economics/accounts/${encodeURIComponent(accountId)}/metering-summary`,
+      entitlement_replenishment_summary_ref: `/v1/economics/accounts/${encodeURIComponent(accountId)}/entitlements/replenishment-summary`,
+      treasury_summary_ref: `/v1/economics/accounts/${encodeURIComponent(accountId)}/treasury-summary`,
+      operator_dashboard_ref: `/v1/economics/accounts/${encodeURIComponent(accountId)}/operator-dashboard`
+    },
+    generated_at_iso: nowIso()
+  };
+}
+
+function buildTreasuryIntelligenceSummary(state, accountId) {
+  const treasurySummary = buildTreasurySummary(state, accountId);
+  const treasuryDrilldown = buildTreasuryDrilldown(state, accountId);
+  const reconciliationPack = buildReconciliationPack(state, accountId);
+  const meteringSummary = buildUsageMeteringSummary(state, accountId);
+  const balanceSummary = buildCreditBalanceSummary(state, accountId);
+  const railSummary = buildRailSummary(state, accountId);
+
+  const mintedUnits = Number(treasurySummary.treasury.minted_units || 0);
+  const consumedUnits = Number(treasurySummary.treasury.consumed_units || 0);
+  const availableUnits = Number(treasurySummary.treasury.available_units || 0);
+  const settledAmountMinor = Number(treasurySummary.treasury.settled_amount_minor || 0);
+  const usageMeterCount = Number(meteringSummary.usage_meter_count || 0);
+  const pendingTransactions = Number(treasuryDrilldown.unresolved_flags.pending_transactions || 0);
+  const pendingReceipts = Number(treasuryDrilldown.unresolved_flags.pending_receipts || 0);
+  const disputedReceipts = Number(reconciliationPack.unresolved_state.disputed_receipt_count || 0);
+  const escalatedReceipts = Number(reconciliationPack.unresolved_state.escalated_receipt_count || 0);
+  const paymentLedgerCount = Number(treasurySummary.payment_ledger_count || 0);
+  const railCreditEventCount = Number(railSummary.credit_event_count || 0);
+
+  let treasuryEfficiencyState = "healthy";
+  if (mintedUnits === 0 && settledAmountMinor === 0 && usageMeterCount === 0) {
+    treasuryEfficiencyState = "pre_funding";
+  } else if (availableUnits <= 0 && (consumedUnits > 0 || usageMeterCount > 0)) {
+    treasuryEfficiencyState = "constrained";
+  } else if (pendingTransactions > 0 || pendingReceipts > 0) {
+    treasuryEfficiencyState = "watch";
+  }
+
+  let valueCaptureState = "aligned";
+  if (usageMeterCount === 0 && paymentLedgerCount === 0 && railCreditEventCount === 0) {
+    valueCaptureState = "pre_conversion";
+  } else if (usageMeterCount >= 3 && paymentLedgerCount <= 1 && consumedUnits > 0) {
+    valueCaptureState = "repeat_use_ready";
+  } else if (consumedUnits > mintedUnits && mintedUnits > 0) {
+    valueCaptureState = "leaking";
+  }
+
+  let reconciliationRiskState = "low";
+  if (pendingTransactions > 0 || pendingReceipts > 0) reconciliationRiskState = "watch";
+  if (disputedReceipts > 0 || escalatedReceipts > 0) reconciliationRiskState = "high";
+
+  let replenishmentFatigueState = "low";
+  if (railCreditEventCount >= 2 && availableUnits <= Math.max(8, meteringSummary.total_units || 0)) {
+    replenishmentFatigueState = "watch";
+  }
+  if (railCreditEventCount >= 3 && balanceSummary.replenishment_summary.low_balance_count > 0) {
+    replenishmentFatigueState = "high";
+  }
+
+  let nextBestAction = "continue_treasury_posture";
+  if (treasuryEfficiencyState === "pre_funding") {
+    nextBestAction = "establish_runtime_funding";
+  } else if (treasuryEfficiencyState === "constrained") {
+    nextBestAction = "restore_runtime_balance";
+  } else if (reconciliationRiskState === "high") {
+    nextBestAction = "review_reconciliation_pack";
+  } else if (reconciliationRiskState === "watch") {
+    nextBestAction = "inspect_treasury_drilldown";
+  } else if (replenishmentFatigueState === "high" || valueCaptureState === "repeat_use_ready") {
+    nextBestAction = "recommend_larger_pack_posture";
+  }
+
+  return {
+    account_id: accountId,
+    category: "machine-commerce-account-treasury-intelligence-summary",
+    treasury_efficiency_state: treasuryEfficiencyState,
+    value_capture_state: valueCaptureState,
+    reconciliation_risk_state: reconciliationRiskState,
+    replenishment_fatigue_state: replenishmentFatigueState,
+    next_best_action: nextBestAction,
+    explanation_signals: {
+      minted_units: mintedUnits,
+      consumed_units: consumedUnits,
+      available_units: availableUnits,
+      settled_amount_minor: settledAmountMinor,
+      usage_meter_count: usageMeterCount,
+      payment_ledger_count: paymentLedgerCount,
+      rail_credit_event_count: railCreditEventCount,
+      pending_transaction_count: pendingTransactions,
+      pending_receipt_count: pendingReceipts,
+      disputed_receipt_count: disputedReceipts,
+      escalated_receipt_count: escalatedReceipts
+    },
+    linked_surfaces: {
+      treasury_summary_ref: `/v1/economics/accounts/${encodeURIComponent(accountId)}/treasury-summary`,
+      treasury_drilldown_ref: `/v1/economics/accounts/${encodeURIComponent(accountId)}/treasury-drilldown`,
+      reconciliation_pack_ref: `/v1/economics/accounts/${encodeURIComponent(accountId)}/reconciliation-pack`,
+      metering_summary_ref: `/v1/economics/accounts/${encodeURIComponent(accountId)}/metering-summary`,
+      rail_summary_ref: `/v1/economics/accounts/${encodeURIComponent(accountId)}/rail-summary`
+    },
+    generated_at_iso: nowIso()
+  };
+}
+
 function buildLedgerExport(state, accountId) {
   return {
     export_version: "xytara-economics-ledger-export-v1",
@@ -1402,6 +1702,10 @@ module.exports = {
   previewRailCredits,
   applyRailCredits,
   buildCreditBalanceSummary,
+  buildWalletSummary,
+  buildWalletLedgerSummary,
+  buildEconomicsIntelligenceSummary,
+  buildTreasuryIntelligenceSummary,
   buildTreasurySummary,
   buildLedgerExport,
   buildTreasuryDrilldown,

package/lib/operator_intelligence.js

@@ -0,0 +1,90 @@
+"use strict";
+
+const { buildEconomicsIntelligenceSummary } = require("./commerce_economics");
+const { buildPartnerIntelligencePack } = require("./partner_intelligence");
+
+function buildOperatorIntelligencePack(state, input) {
+  const payload = input && typeof input === "object" && !Array.isArray(input) ? input : {};
+  const accountId = String(payload.account_id || "acct_demo").trim() || "acct_demo";
+  const economicsIntelligence = buildEconomicsIntelligenceSummary(state, accountId);
+  const partnerIntelligence = buildPartnerIntelligencePack();
+
+  const actionQueue = [];
+
+  if (economicsIntelligence.next_best_action && economicsIntelligence.next_best_action !== "continue_current_posture") {
+    actionQueue.push({
+      lane: "runtime_economics",
+      priority: economicsIntelligence.replenishment_risk_state === "high" ? "high" : "medium",
+      action: economicsIntelligence.next_best_action,
+      reason: `funding posture is ${economicsIntelligence.recommended_funding_posture} with ${economicsIntelligence.replenishment_risk_state} replenishment risk`
+    });
+  }
+
+  if (partnerIntelligence.next_best_action) {
+    actionQueue.push({
+      lane: "partner_adoption",
+      priority: partnerIntelligence.onboarding_friction_state === "low" ? "medium" : "high",
+      action: partnerIntelligence.next_best_action,
+      reason: `partner readiness is ${partnerIntelligence.partner_readiness_state} and onboarding friction is ${partnerIntelligence.onboarding_friction_state}`
+    });
+  }
+
+  if (actionQueue.length === 0) {
+    actionQueue.push({
+      lane: "operator_posture",
+      priority: "low",
+      action: "continue_current_posture",
+      reason: "runtime economics and partner posture are both stable enough to continue current operation"
+    });
+  }
+
+  return {
+    ok: true,
+    account_id: accountId,
+    category: "machine-commerce-operator-intelligence-pack",
+    overall_operator_state: {
+      runtime_economics_state: economicsIntelligence.treasury_health_state,
+      partner_adoption_state: partnerIntelligence.partner_readiness_state,
+      top_priority: actionQueue[0].priority
+    },
+    recommended_operator_motion: actionQueue[0].action,
+    next_action_queue: actionQueue,
+    intelligence_refs: {
+      economics_intelligence_ref: `/v1/economics/accounts/${encodeURIComponent(accountId)}/intelligence-summary`,
+      partner_intelligence_ref: "/v1/partner-intelligence",
+      operator_dashboard_ref: `/v1/economics/accounts/${encodeURIComponent(accountId)}/operator-dashboard`
+    },
+    explanation_signals: {
+      runtime_next_best_action: economicsIntelligence.next_best_action,
+      runtime_funding_posture: economicsIntelligence.recommended_funding_posture,
+      runtime_replenishment_risk_state: economicsIntelligence.replenishment_risk_state,
+      runtime_treasury_health_state: economicsIntelligence.treasury_health_state,
+      partner_next_best_action: partnerIntelligence.next_best_action,
+      partner_readiness_state: partnerIntelligence.partner_readiness_state,
+      partner_onboarding_friction_state: partnerIntelligence.onboarding_friction_state,
+      partner_promotion_readiness_state: partnerIntelligence.promotion_readiness_state
+    },
+    generated_from: {
+      economics_category: economicsIntelligence.category,
+      partner_category: partnerIntelligence.category
+    }
+  };
+}
+
+function summarizeOperatorIntelligencePack(state, input) {
+  const pack = buildOperatorIntelligencePack(state, input);
+  return {
+    ok: true,
+    account_id: pack.account_id,
+    category: pack.category,
+    recommended_operator_motion: pack.recommended_operator_motion,
+    queue_length: pack.next_action_queue.length,
+    runtime_economics_state: pack.overall_operator_state.runtime_economics_state,
+    partner_adoption_state: pack.overall_operator_state.partner_adoption_state
+  };
+}
+
+module.exports = {
+  buildOperatorIntelligencePack,
+  summarizeOperatorIntelligencePack
+};

package/lib/partner_intelligence.js

@@ -0,0 +1,105 @@
+"use strict";
+
+const packageJson = require("../package.json");
+const { buildAdoptionPack } = require("./release_pack");
+const { buildAdapterPartnerPack } = require("./adapter_partner_pack");
+
+function classifyPartnerReadinessState(adoptionPack, adapterPartnerPack) {
+  const targetCount = adoptionPack.initial_adoption_targets.length;
+  const firstSuccessPathCount = adoptionPack.first_success_paths.length;
+  const partnerValueCount = adapterPartnerPack.partner_value.length;
+  const maturityStepCount = adapterPartnerPack.trust_path.maturity_path.length;
+
+  if (targetCount >= 4 && firstSuccessPathCount >= 3 && partnerValueCount >= 4 && maturityStepCount >= 5) {
+    return "strong";
+  }
+  if (targetCount >= 2 && firstSuccessPathCount >= 2 && partnerValueCount >= 2) {
+    return "working";
+  }
+  return "early";
+}
+
+function classifyOnboardingFrictionState(adapterPartnerPack) {
+  const docCount = adapterPartnerPack.start_path.first_docs.length;
+  const commandCount = adapterPartnerPack.start_path.first_commands.length;
+  const exampleCount = adapterPartnerPack.start_path.first_examples.length;
+
+  if (docCount >= 2 && commandCount >= 4 && exampleCount >= 2) return "low";
+  if (docCount >= 1 && commandCount >= 2) return "manageable";
+  return "high";
+}
+
+function classifyPromotionReadinessState(adapterPartnerPack) {
+  const publicSurfaceCount = Object.keys(adapterPartnerPack.public_surfaces).length;
+  const maturityStepCount = adapterPartnerPack.trust_path.maturity_path.length;
+  if (publicSurfaceCount >= 5 && maturityStepCount >= 5) return "strong";
+  if (publicSurfaceCount >= 3 && maturityStepCount >= 3) return "working";
+  return "early";
+}
+
+function buildPartnerIntelligencePack() {
+  const adoptionPack = buildAdoptionPack();
+  const adapterPartnerPack = buildAdapterPartnerPack();
+  const partnerReadinessState = classifyPartnerReadinessState(adoptionPack, adapterPartnerPack);
+  const onboardingFrictionState = classifyOnboardingFrictionState(adapterPartnerPack);
+  const promotionReadinessState = classifyPromotionReadinessState(adapterPartnerPack);
+
+  let nextBestAction = "promote_partner_start_path";
+  if (onboardingFrictionState !== "low") {
+    nextBestAction = "tighten_partner_onboarding";
+  } else if (promotionReadinessState !== "strong") {
+    nextBestAction = "strengthen_promotion_trust_path";
+  }
+
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-partner-intelligence-pack",
+    partner_readiness_state: partnerReadinessState,
+    onboarding_friction_state: onboardingFrictionState,
+    promotion_readiness_state: promotionReadinessState,
+    first_partner_segment: adapterPartnerPack.adoption_message.first_partner_type,
+    recommended_partner_motion: "lead_with_adapter_authors_and_agent_builders",
+    next_best_action: nextBestAction,
+    explanation_signals: {
+      adoption_target_count: adoptionPack.initial_adoption_targets.length,
+      target_ecosystem_count: adoptionPack.target_ecosystems.length,
+      first_success_path_count: adoptionPack.first_success_paths.length,
+      partner_value_count: adapterPartnerPack.partner_value.length,
+      onboarding_doc_count: adapterPartnerPack.start_path.first_docs.length,
+      onboarding_command_count: adapterPartnerPack.start_path.first_commands.length,
+      onboarding_example_count: adapterPartnerPack.start_path.first_examples.length,
+      maturity_step_count: adapterPartnerPack.trust_path.maturity_path.length,
+      public_surface_count: Object.keys(adapterPartnerPack.public_surfaces).length
+    },
+    linked_surfaces: {
+      adoption_summary_ref: "/v1/release-pack/adoption/summary",
+      adapter_partner_summary_ref: "/v1/adapter-partners/summary",
+      release_center_summary_ref: "/v1/release-center/summary"
+    },
+    generated_from: {
+      adoption_pack_category: adoptionPack.category,
+      adapter_partner_pack_category: adapterPartnerPack.category
+    }
+  };
+}
+
+function summarizePartnerIntelligencePack() {
+  const pack = buildPartnerIntelligencePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    partner_readiness_state: pack.partner_readiness_state,
+    onboarding_friction_state: pack.onboarding_friction_state,
+    promotion_readiness_state: pack.promotion_readiness_state,
+    first_partner_segment: pack.first_partner_segment,
+    next_best_action: pack.next_best_action,
+    signal_count: Object.keys(pack.explanation_signals).length
+  };
+}
+
+module.exports = {
+  buildPartnerIntelligencePack,
+  summarizePartnerIntelligencePack
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xytara",
-  "version": "2.2.0",
+  "version": "2.3.0",
   "description": "Machine commerce SDK for discovery, quoting, execution, lifecycle inspection, and adapters.",
   "main": "index.js",
   "bin": {

package/server.js

@@ -64,6 +64,10 @@ const {
   previewRailCredits,
   applyRailCredits,
   buildCreditBalanceSummary,
+  buildWalletSummary,
+  buildWalletLedgerSummary,
+  buildEconomicsIntelligenceSummary,
+  buildTreasuryIntelligenceSummary,
   buildTreasurySummary,
   buildLedgerExport,
   buildTreasuryDrilldown,
@@ -242,6 +246,14 @@ const {
   buildAdapterPartnerPack,
   summarizeAdapterPartnerPack
 } = require("./lib/adapter_partner_pack");
+const {
+  buildPartnerIntelligencePack,
+  summarizePartnerIntelligencePack
+} = require("./lib/partner_intelligence");
+const {
+  buildOperatorIntelligencePack,
+  summarizeOperatorIntelligencePack
+} = require("./lib/operator_intelligence");
 const {
   buildSoftLaunchPack,
   summarizeSoftLaunchPack
@@ -3259,6 +3271,42 @@ async function routeRequest(req, res) {
     return;
   }
 
+  if (req.method === "GET" && url.pathname === "/v1/partner-intelligence") {
+    sendJson(res, 200, buildPartnerIntelligencePack());
+    return;
+  }
+
+  if (req.method === "GET" && url.pathname === "/v1/partner-intelligence/summary") {
+    sendJson(res, 200, summarizePartnerIntelligencePack());
+    return;
+  }
+
+  if (req.method === "GET" && url.pathname === "/v1/operator-intelligence") {
+    sendJson(res, 200, buildOperatorIntelligencePack(state, {
+      account_id: url.searchParams.get("account_id") || "acct_demo"
+    }));
+    return;
+  }
+
+  if (req.method === "GET" && url.pathname === "/v1/operator-intelligence/summary") {
+    sendJson(res, 200, summarizeOperatorIntelligencePack(state, {
+      account_id: url.searchParams.get("account_id") || "acct_demo"
+    }));
+    return;
+  }
+
+  if (req.method === "POST" && url.pathname === "/v1/operator-intelligence") {
+    const body = await readJsonBody(req);
+    sendJson(res, 200, buildOperatorIntelligencePack(state, body));
+    return;
+  }
+
+  if (req.method === "POST" && url.pathname === "/v1/operator-intelligence/summary") {
+    const body = await readJsonBody(req);
+    sendJson(res, 200, summarizeOperatorIntelligencePack(state, body));
+    return;
+  }
+
   if (req.method === "GET" && url.pathname === "/v1/soft-launch") {
     sendJson(res, 200, buildSoftLaunchPack());
     return;
@@ -5757,6 +5805,30 @@ async function routeRequest(req, res) {
     return;
   }
 
+  if (req.method === "GET" && url.pathname.startsWith("/v1/economics/accounts/") && url.pathname.endsWith("/wallet")) {
+    const accountId = getDecodedSuffixId(url.pathname, "/v1/economics/accounts/").replace(/\/wallet$/, "");
+    sendJson(res, 200, buildWalletSummary(state, accountId));
+    return;
+  }
+
+  if (req.method === "GET" && url.pathname.startsWith("/v1/economics/accounts/") && url.pathname.endsWith("/wallet-ledger-summary")) {
+    const accountId = getDecodedSuffixId(url.pathname, "/v1/economics/accounts/").replace(/\/wallet-ledger-summary$/, "");
+    sendJson(res, 200, buildWalletLedgerSummary(state, accountId));
+    return;
+  }
+
+  if (req.method === "GET" && url.pathname.startsWith("/v1/economics/accounts/") && url.pathname.endsWith("/intelligence-summary")) {
+    const accountId = getDecodedSuffixId(url.pathname, "/v1/economics/accounts/").replace(/\/intelligence-summary$/, "");
+    sendJson(res, 200, buildEconomicsIntelligenceSummary(state, accountId));
+    return;
+  }
+
+  if (req.method === "GET" && url.pathname.startsWith("/v1/economics/accounts/") && url.pathname.endsWith("/treasury-intelligence-summary")) {
+    const accountId = getDecodedSuffixId(url.pathname, "/v1/economics/accounts/").replace(/\/treasury-intelligence-summary$/, "");
+    sendJson(res, 200, buildTreasuryIntelligenceSummary(state, accountId));
+    return;
+  }
+
   if (req.method === "GET" && url.pathname.startsWith("/v1/economics/accounts/") && url.pathname.endsWith("/metering-summary")) {
     const accountId = getDecodedSuffixId(url.pathname, "/v1/economics/accounts/").replace(/\/metering-summary$/, "");
     sendJson(res, 200, buildUsageMeteringSummary(state, accountId));