xytara 2.2.0 → 2.4.0

package/lib/identity_auth.js

@@ -0,0 +1,175 @@
+"use strict";
+
+function normalizeString(value, fallback = null) {
+  const trimmed = typeof value === "string" ? value.trim() : "";
+  return trimmed || fallback;
+}
+
+function ensureArray(value) {
+  return Array.isArray(value) ? value : [];
+}
+
+function nowIso() {
+  return new Date().toISOString();
+}
+
+function buildIdentityBindingPublicView(binding) {
+  if (!binding) return null;
+  return {
+    binding_id: binding.binding_id,
+    account_id: binding.account_id,
+    status: binding.status,
+    identity_kind: binding.identity_kind,
+    identity_ref: binding.identity_ref,
+    registry_scope: binding.registry_scope || null,
+    attached_agent_account_id: binding.attached_agent_account_id || null,
+    source_transaction_id: binding.source_transaction_id || null,
+    expires_at_iso: binding.expires_at_iso || null,
+    rotated_from_binding_id: binding.rotated_from_binding_id || null,
+    replaced_by_binding_id: binding.replaced_by_binding_id || null,
+    created_at_iso: binding.created_at_iso,
+    updated_at_iso: binding.updated_at_iso,
+    revoked_at_iso: binding.revoked_at_iso || null,
+    revoke_reason: binding.revoke_reason || null,
+    labels: ensureArray(binding.labels),
+    issued_by: binding.issued_by || null
+  };
+}
+
+function createIdentityBinding(state, body) {
+  const payload = body && typeof body === "object" && !Array.isArray(body) ? body : {};
+  const createdAtIso = nowIso();
+  const binding = {
+    binding_id: normalizeString(payload.binding_id, `identity_binding_${state.machineIdentityBindings.size + 1}`),
+    account_id: normalizeString(payload.account_id, "acct_demo"),
+    status: normalizeString(payload.status, "active"),
+    identity_kind: normalizeString(payload.identity_kind, "registry_anchor_identity"),
+    identity_ref: normalizeString(payload.identity_ref, `identity_ref_${state.machineIdentityBindings.size + 1}`),
+    registry_scope: normalizeString(payload.registry_scope, null),
+    attached_agent_account_id: normalizeString(payload.attached_agent_account_id, null),
+    source_transaction_id: normalizeString(payload.source_transaction_id, null),
+    expires_at_iso: normalizeString(payload.expires_at_iso, null),
+    labels: ensureArray(payload.labels).map((value) => String(value || "").trim()).filter(Boolean),
+    issued_by: normalizeString(payload.issued_by, "operator"),
+    rotated_from_binding_id: normalizeString(payload.rotated_from_binding_id, null),
+    replaced_by_binding_id: normalizeString(payload.replaced_by_binding_id, null),
+    created_at_iso: createdAtIso,
+    updated_at_iso: createdAtIso,
+    revoked_at_iso: null,
+    revoke_reason: null
+  };
+  state.machineIdentityBindings.set(binding.binding_id, binding);
+  return buildIdentityBindingPublicView(binding);
+}
+
+function listIdentityBindings(state, filters) {
+  const payload = filters && typeof filters === "object" && !Array.isArray(filters) ? filters : {};
+  const accountId = normalizeString(payload.account_id, null);
+  const status = normalizeString(payload.status, null);
+  return Array.from(state.machineIdentityBindings.values())
+    .filter((binding) => {
+      if (accountId && binding.account_id !== accountId) return false;
+      if (status && binding.status !== status) return false;
+      return true;
+    })
+    .map((binding) => buildIdentityBindingPublicView(binding));
+}
+
+function getIdentityBinding(state, bindingId) {
+  if (!bindingId || !state.machineIdentityBindings.has(bindingId)) return null;
+  return buildIdentityBindingPublicView(state.machineIdentityBindings.get(bindingId));
+}
+
+function revokeIdentityBinding(state, bindingId, body) {
+  if (!bindingId || !state.machineIdentityBindings.has(bindingId)) return null;
+  const payload = body && typeof body === "object" && !Array.isArray(body) ? body : {};
+  const current = state.machineIdentityBindings.get(bindingId);
+  const next = {
+    ...current,
+    status: "revoked",
+    revoked_at_iso: nowIso(),
+    revoke_reason: normalizeString(payload.reason, "operator_revoked"),
+    updated_at_iso: nowIso()
+  };
+  state.machineIdentityBindings.set(bindingId, next);
+  return buildIdentityBindingPublicView(next);
+}
+
+function getIdentityBindingRotationSummary(state, bindingId) {
+  if (!bindingId || !state.machineIdentityBindings.has(bindingId)) return null;
+  const binding = state.machineIdentityBindings.get(bindingId);
+  return {
+    summary_version: "xytara-identity-binding-rotation-summary-v1",
+    binding_id: binding.binding_id,
+    account_id: binding.account_id,
+    status: binding.status,
+    predecessor_binding_id: binding.rotated_from_binding_id || null,
+    successor_binding_id: binding.replaced_by_binding_id || null,
+    expires_at_iso: binding.expires_at_iso || null,
+    rotation_state: binding.rotated_from_binding_id || binding.replaced_by_binding_id
+      ? "lineage_present"
+      : "standalone",
+    linked_surfaces: {
+      identity_binding_ref: `/v1/identity/bindings/${encodeURIComponent(binding.binding_id)}`
+    },
+    generated_at_iso: nowIso()
+  };
+}
+
+function renewIdentityBinding(state, bindingId, body) {
+  if (!bindingId || !state.machineIdentityBindings.has(bindingId)) return null;
+  const payload = body && typeof body === "object" && !Array.isArray(body) ? body : {};
+  const current = state.machineIdentityBindings.get(bindingId);
+  const next = {
+    ...current,
+    expires_at_iso: normalizeString(payload.expires_at_iso, current.expires_at_iso || null),
+    updated_at_iso: nowIso()
+  };
+  state.machineIdentityBindings.set(bindingId, next);
+  return buildIdentityBindingPublicView(next);
+}
+
+function rotateIdentityBinding(state, bindingId, body) {
+  if (!bindingId || !state.machineIdentityBindings.has(bindingId)) return null;
+  const payload = body && typeof body === "object" && !Array.isArray(body) ? body : {};
+  const current = state.machineIdentityBindings.get(bindingId);
+  const successorBindingId = normalizeString(payload.successor_binding_id, `${bindingId}_rotated`);
+  const successor = createIdentityBinding(state, {
+    binding_id: successorBindingId,
+    account_id: current.account_id,
+    identity_kind: normalizeString(payload.identity_kind, current.identity_kind),
+    identity_ref: normalizeString(payload.identity_ref, current.identity_ref),
+    registry_scope: normalizeString(payload.registry_scope, current.registry_scope),
+    attached_agent_account_id: normalizeString(payload.attached_agent_account_id, current.attached_agent_account_id),
+    source_transaction_id: normalizeString(payload.source_transaction_id, current.source_transaction_id),
+    expires_at_iso: normalizeString(payload.expires_at_iso, current.expires_at_iso || null),
+    labels: ensureArray(payload.labels).length > 0 ? ensureArray(payload.labels) : ensureArray(current.labels),
+    issued_by: normalizeString(payload.issued_by, current.issued_by || "operator"),
+    rotated_from_binding_id: current.binding_id
+  });
+  revokeIdentityBinding(state, bindingId, {
+    reason: normalizeString(payload.reason, "rotated_to_successor")
+  });
+  state.machineIdentityBindings.set(successor.binding_id, {
+    ...state.machineIdentityBindings.get(successor.binding_id),
+    rotated_from_binding_id: current.binding_id
+  });
+  state.machineIdentityBindings.set(bindingId, {
+    ...state.machineIdentityBindings.get(bindingId),
+    replaced_by_binding_id: successor.binding_id
+  });
+  return {
+    rotated_binding: buildIdentityBindingPublicView(state.machineIdentityBindings.get(bindingId)),
+    successor_identity_binding: buildIdentityBindingPublicView(state.machineIdentityBindings.get(successor.binding_id))
+  };
+}
+
+module.exports = {
+  createIdentityBinding,
+  listIdentityBindings,
+  getIdentityBinding,
+  getIdentityBindingRotationSummary,
+  renewIdentityBinding,
+  revokeIdentityBinding,
+  rotateIdentityBinding
+};

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.4.0",
   "description": "Machine commerce SDK for discovery, quoting, execution, lifecycle inspection, and adapters.",
   "main": "index.js",
   "bin": {