xytara 2.0.0 → 2.2.0

package/lib/phase_1_openai_codex_pack.js

@@ -0,0 +1,60 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase1OpenaiCodexPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-1-openai-codex-pack",
+    phase_ref: "phase_1",
+    ecosystem_ref: "openai_codex",
+    status: "active",
+    adoption_wedge: "transaction-aware paid capability execution for tool-using agents",
+    main_repo_weight: "xytara_heavy",
+    scope: {
+      runtime_posture: [
+        "direct agent and tool invocation",
+        "quote and payment-aware execution",
+        "credits-first repeat usage",
+        "result package followthrough"
+      ],
+      first_surfaces: [
+        "/v1/release-center/summary",
+        "/v1/release-pack/scenarios/summary",
+        "/v1/outreach-proof/summary",
+        "/v1/announcement-pack/summary"
+      ],
+      first_commands: [
+        "xytara-release --center --summary",
+        "xytara-release --phase-1-openai-codex --summary",
+        "xytara-run --url https://xytara.onrender.com --account acct_demo --command \"cli-run\" --task trust.verify --body-json '{\"subject_id\":\"subject-1\"}' --wallet-id merchant_wallet_main --wallet-secret YOUR_LOCAL_SIGNED_SECRET --txid YOUR_BSV_TXID"
+      ]
+    },
+    done_means: [
+      "outside builders can see where xytara fits relative to agent runtimes instead of mistaking it for a generic framework",
+      "the first OpenAI/Codex path is clear enough to try from one CLI and one release-center route",
+      "Phase 1 runtime posture is explicit in public product surfaces"
+    ]
+  };
+}
+
+function summarizePhase1OpenaiCodexPack() {
+  const pack = buildPhase1OpenaiCodexPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_ref: pack.ecosystem_ref,
+    surface_count: pack.scope.first_surfaces.length,
+    command_count: pack.scope.first_commands.length,
+    done_mean_count: pack.done_means.length,
+    first_surface: pack.scope.first_surfaces[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase1OpenaiCodexPack,
+  summarizePhase1OpenaiCodexPack
+};

package/lib/phase_1_openai_codex_runtime_pack.js

@@ -0,0 +1,52 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase1OpenaiCodexRuntimePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-1-openai-codex-runtime-pack",
+    phase_ref: "phase_1",
+    ecosystem_ref: "openai_codex",
+    posture: "runtime_path",
+    first_path: {
+      purpose: "run a paid capability call through xytara from an OpenAI/Codex-style tool-using agent flow",
+      first_http_sequence: [
+        "/v1/release-center/summary",
+        "/v1/release-pack/scenarios/summary",
+        "/x402/commands/execute"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-1-openai-codex-runtime --summary",
+        "xytara-run --url https://xytara.onrender.com --account acct_demo --command \"cli-run\" --task trust.verify --body-json '{\"subject_id\":\"subject-1\"}' --wallet-id merchant_wallet_main --wallet-secret YOUR_LOCAL_SIGNED_SECRET --txid YOUR_BSV_TXID"
+      ],
+      expected_signals: [
+        "quote and spend-aware execution result",
+        "runtime result package ready for proof followthrough",
+        "metered and replayable machine transaction path"
+      ],
+      followthrough_ref: "https://xoonya.onrender.com/v1/phases/phase-1/openai-codex/proof/summary"
+    }
+  };
+}
+
+function summarizePhase1OpenaiCodexRuntimePack() {
+  const pack = buildPhase1OpenaiCodexRuntimePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_ref: pack.ecosystem_ref,
+    http_step_count: pack.first_path.first_http_sequence.length,
+    cli_step_count: pack.first_path.first_cli_sequence.length,
+    signal_count: pack.first_path.expected_signals.length,
+    first_http_step: pack.first_path.first_http_sequence[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase1OpenaiCodexRuntimePack,
+  summarizePhase1OpenaiCodexRuntimePack
+};

package/lib/phase_2_base_runtime_pack.js

@@ -0,0 +1,71 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase2BaseRuntimePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-2-base-runtime-pack",
+    phase_ref: "phase_2",
+    ecosystem_refs: ["base"],
+    posture: "runtime_path",
+    settlement_shape: {
+      payment_asset: "base-native-or-tokenized-value",
+      rail_family: "evm_l2",
+      settlement_modes: ["ethereum_evm"],
+      operator_surfaces: [
+        "/v1/integrations/settlement-modes",
+        "/v1/release-center/summary"
+      ]
+    },
+    completion_shape: {
+      completion_checks: [
+        "Base runtime lane is public and inspectable",
+        "L2 settlement posture stays visible at the lane level",
+        "operator surfaces remain available from the Base lane",
+        "the lane stays consistent with the broader EVM/Base family"
+      ]
+    },
+    first_path: {
+      purpose: "show the Base-specific runtime lane inside Phase 2's broader EVM payment-rail work",
+      first_http_sequence: [
+        "/v1/phases/phase-2/evm-base/summary",
+        "/v1/phases/phase-2/base/summary",
+        "/v1/integrations/settlement-modes"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-2-base-runtime --summary",
+        "xytara-release --phase-2-base-usdc-runtime --summary"
+      ],
+      expected_signals: [
+        "Base has a dedicated runtime-facing lane instead of appearing only inside combined EVM language",
+        "the L2-specific settlement posture is visible without breaking the shared EVM model",
+        "the path stays compatible with the same operator and release-center surfaces"
+      ]
+    }
+  };
+}
+
+function summarizePhase2BaseRuntimePack() {
+  const pack = buildPhase2BaseRuntimePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.ecosystem_refs.length,
+    settlement_mode_count: pack.settlement_shape.settlement_modes.length,
+    completion_check_count: pack.completion_shape.completion_checks.length,
+    http_step_count: pack.first_path.first_http_sequence.length,
+    cli_step_count: pack.first_path.first_cli_sequence.length,
+    signal_count: pack.first_path.expected_signals.length,
+    operator_surface_count: pack.settlement_shape.operator_surfaces.length,
+    first_http_step: pack.first_path.first_http_sequence[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase2BaseRuntimePack,
+  summarizePhase2BaseRuntimePack
+};

package/lib/phase_2_base_usdc_runtime_pack.js

@@ -0,0 +1,72 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase2BaseUsdcRuntimePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-2-base-usdc-runtime-pack",
+    phase_ref: "phase_2",
+    ecosystem_refs: ["base", "usdc"],
+    posture: "runtime_path",
+    settlement_shape: {
+      payment_assets: ["base-native-or-tokenized-value", "usdc"],
+      rail_family: "evm_l2_and_stablecoin",
+      settlement_modes: ["ethereum_evm"],
+      operator_surfaces: [
+        "/v1/integrations/settlement-modes",
+        "/v1/release-center/summary"
+      ]
+    },
+    completion_shape: {
+      completion_checks: [
+        "combined Base plus USDC lane is public and inspectable",
+        "both payment assets stay visible on the lane",
+        "settlement mode stays attached to the combined path",
+        "operator surfaces remain available while Base and USDC also stand alone"
+      ]
+    },
+    first_path: {
+      purpose: "show the first concrete Base + USDC machine-commerce runtime lane inside Phase 2",
+      first_http_sequence: [
+        "/v1/phases/phase-2/evm-base/summary",
+        "/v1/integrations/settlement-modes",
+        "/v1/release-center/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-2-base-usdc-runtime --summary",
+        "xytara-release --phase-2-evm-base-runtime --summary"
+      ],
+      expected_signals: [
+        "Base + USDC are visible as the first concrete public split inside the broader EVM lane",
+        "Phase 2 starts to separate rail-specific runtime posture from generic multi-rail language",
+        "the path stays compatible with the same release-center and settlement-mode inspection surfaces"
+      ]
+    }
+  };
+}
+
+function summarizePhase2BaseUsdcRuntimePack() {
+  const pack = buildPhase2BaseUsdcRuntimePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.ecosystem_refs.length,
+    settlement_mode_count: pack.settlement_shape.settlement_modes.length,
+    payment_asset_count: pack.settlement_shape.payment_assets.length,
+    completion_check_count: pack.completion_shape.completion_checks.length,
+    http_step_count: pack.first_path.first_http_sequence.length,
+    cli_step_count: pack.first_path.first_cli_sequence.length,
+    signal_count: pack.first_path.expected_signals.length,
+    operator_surface_count: pack.settlement_shape.operator_surfaces.length,
+    first_http_step: pack.first_path.first_http_sequence[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase2BaseUsdcRuntimePack,
+  summarizePhase2BaseUsdcRuntimePack
+};

package/lib/phase_2_closeout_pack.js

@@ -0,0 +1,65 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase2CloseoutPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-2-closeout-pack",
+    phase_ref: "phase_2",
+    posture: "closeout_complete",
+    closeout: {
+      current_decision: "ready_for_phase_3",
+      blocking_actions: [],
+      action_sequence: [
+        "review phase-2 completion summary",
+        "review phase-2 freeze-review summary",
+        "confirm the current runtime lane shape as frozen baseline",
+        "record the gate review outcome",
+        "flip ready_for_next_phase deliberately"
+      ],
+      completion_signals: [
+        "freeze decision has been recorded",
+        "gate review has been recorded",
+        "phase-2 gate summary shows zero unsatisfied gate conditions"
+      ]
+    },
+    sources: {
+      completion_summary: "/v1/phases/phase-2/completion/summary",
+      freeze_review_summary: "/v1/phases/phase-2/freeze-review/summary",
+      gate_summary: "/v1/phases/phase-2/gate/summary"
+    },
+    first_path: {
+      purpose: "show the recorded closeout path that moved Phase 2 into ready-for-next-phase state",
+      first_http_sequence: [
+        "/v1/phases/phase-2/gate/summary",
+        "/v1/phases/phase-2/closeout/summary",
+        "/v1/release-center/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-2-closeout --summary",
+        "xytara-release --phase-2-gate --summary"
+      ]
+    }
+  };
+}
+
+function summarizePhase2CloseoutPack() {
+  const pack = buildPhase2CloseoutPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    blocking_action_count: pack.closeout.blocking_actions.length,
+    action_step_count: pack.closeout.action_sequence.length,
+    completion_signal_count: pack.closeout.completion_signals.length,
+    current_decision: pack.closeout.current_decision
+  };
+}
+
+module.exports = {
+  buildPhase2CloseoutPack,
+  summarizePhase2CloseoutPack
+};

package/lib/phase_2_completion_pack.js

@@ -0,0 +1,113 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase2CompletionPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-2-completion-pack",
+    phase_ref: "phase_2",
+    posture: "completion_complete",
+    coverage: {
+      ecosystem_refs: ["evm", "base", "eth", "usdc"],
+      lane_refs: [
+        "/v1/phases/phase-2/evm/summary",
+        "/v1/phases/phase-2/evm-base/summary",
+        "/v1/phases/phase-2/base/summary",
+        "/v1/phases/phase-2/usdc/summary",
+        "/v1/phases/phase-2/base-usdc/summary",
+        "/v1/phases/phase-2/eth/summary"
+      ],
+      payment_assets: ["evm-native-or-tokenized-value", "base-native-or-tokenized-value", "eth", "usdc"],
+      settlement_modes: ["ethereum_evm"],
+      operator_surfaces: [
+        "/v1/integrations/settlement-modes",
+        "/v1/release-center/summary",
+        "/v1/publish-plan/summary"
+      ]
+    },
+    completion: {
+      checks: [
+        "broad Phase 2 rail pack is public and inspectable",
+        "all current Phase 2 runtime lanes are public and inspectable",
+        "combined Base plus USDC lane remains public alongside standalone Base and USDC lanes",
+        "payment-asset coverage is visible at phase level and on the combined lane",
+        "settlement-mode and operator surfaces remain attached to the rail family",
+        "release-center summary reflects Phase 2 breadth and completion coverage"
+      ],
+      readiness_criteria: [
+        {
+          ref: "criterion.phase_surface_public",
+          label: "Phase 2 broad summary is live and inspectable",
+          satisfied: true
+        },
+        {
+          ref: "criterion.runtime_lane_coverage",
+          label: "All planned current runtime lanes are live and inspectable",
+          satisfied: true
+        },
+        {
+          ref: "criterion.asset_coverage_visible",
+          label: "Asset coverage is visible at both phase and combined-lane level",
+          satisfied: true
+        },
+        {
+          ref: "criterion.operator_surfaces_attached",
+          label: "Settlement and operator surfaces remain attached to the rail family",
+          satisfied: true
+        },
+        {
+          ref: "criterion.freeze_shape_confirmed",
+          label: "The final Phase 2 lane shape is explicitly frozen",
+          satisfied: true
+        },
+        {
+          ref: "criterion.next_phase_gate_reviewed",
+          label: "A final freeze review has been recorded before opening Phase 3",
+          satisfied: true
+        }
+      ],
+      ready_for_next_phase: true,
+      remaining_focus: []
+    },
+    first_path: {
+      purpose: "review whether Phase 2 is complete as a machine-commerce program slice rather than just enumerated",
+      first_http_sequence: [
+        "/v1/phases/phase-2/summary",
+        "/v1/phases/phase-2/completion/summary",
+        "/v1/release-center/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-2-completion --summary",
+        "xytara-release --phase-2 --summary"
+      ]
+    }
+  };
+}
+
+function summarizePhase2CompletionPack() {
+  const pack = buildPhase2CompletionPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.coverage.ecosystem_refs.length,
+    lane_count: pack.coverage.lane_refs.length,
+    payment_asset_count: pack.coverage.payment_assets.length,
+    settlement_mode_count: pack.coverage.settlement_modes.length,
+    operator_surface_count: pack.coverage.operator_surfaces.length,
+    completion_check_count: pack.completion.checks.length,
+    readiness_criteria_count: pack.completion.readiness_criteria.length,
+    satisfied_criteria_count: pack.completion.readiness_criteria.filter((criterion) => criterion.satisfied === true).length,
+    unsatisfied_criteria_count: pack.completion.readiness_criteria.filter((criterion) => criterion.satisfied !== true).length,
+    remaining_focus_count: pack.completion.remaining_focus.length,
+    ready_for_next_phase: pack.completion.ready_for_next_phase
+  };
+}
+
+module.exports = {
+  buildPhase2CompletionPack,
+  summarizePhase2CompletionPack
+};

package/lib/phase_2_decision_record_pack.js

@@ -0,0 +1,66 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase2DecisionRecordPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-2-decision-record-pack",
+    phase_ref: "phase_2",
+    posture: "decision_recorded",
+    records: {
+      freeze_decision: {
+        status: "recorded",
+        description: "record the final runtime lane shape as the frozen Phase 2 baseline"
+      },
+      gate_review: {
+        status: "recorded",
+        description: "record the final review that authorizes the move to Phase 3"
+      }
+    },
+    record_steps: [
+      "confirm the current runtime lane family is the final Phase 2 shape",
+      "record the freeze decision",
+      "record the gate review outcome",
+      "recheck phase-2 gate summary for zero unsatisfied conditions"
+    ],
+    outputs: [
+      "freeze decision status is recorded",
+      "gate review status is recorded",
+      "phase-2 gate is ready to stay flipped deliberately"
+    ],
+    first_path: {
+      purpose: "show the two recorded decisions that allow the Phase 2 gate to stay flipped",
+      first_http_sequence: [
+        "/v1/phases/phase-2/closeout/summary",
+        "/v1/phases/phase-2/decision-record/summary",
+        "/v1/phases/phase-2/gate/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-2-decision-record --summary",
+        "xytara-release --phase-2-closeout --summary"
+      ]
+    }
+  };
+}
+
+function summarizePhase2DecisionRecordPack() {
+  const pack = buildPhase2DecisionRecordPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    pending_record_count: Object.values(pack.records).filter((record) => record.status === "pending_record").length,
+    record_step_count: pack.record_steps.length,
+    output_count: pack.outputs.length,
+    freeze_decision_status: pack.records.freeze_decision.status,
+    gate_review_status: pack.records.gate_review.status
+  };
+}
+
+module.exports = {
+  buildPhase2DecisionRecordPack,
+  summarizePhase2DecisionRecordPack
+};

package/lib/phase_2_decision_resolution_pack.js

@@ -0,0 +1,69 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase2DecisionResolutionPack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-2-decision-resolution-pack",
+    phase_ref: "phase_2",
+    posture: "decision_resolution",
+    transitions: [
+      {
+        record_ref: "freeze_decision",
+        from: "pending_record",
+        to: "recorded",
+        resolution_action: "record the final runtime lane freeze decision"
+      },
+      {
+        record_ref: "gate_review",
+        from: "pending_record",
+        to: "recorded",
+        resolution_action: "record the final gate review authorizing Phase 3"
+      }
+    ],
+    resolution_sequence: [
+      "confirm the final Phase 2 runtime lane shape",
+      "change freeze_decision from pending_record to recorded",
+      "change gate_review from pending_record to recorded",
+      "recheck the phase-2 gate for zero unsatisfied conditions",
+      "flip ready_for_next_phase deliberately"
+    ],
+    completion_result: {
+      target_gate_decision: "ready_for_phase_3",
+      target_ready_for_next_phase: true
+    },
+    first_path: {
+      purpose: "show the exact status transitions still needed before the phase gate can flip",
+      first_http_sequence: [
+        "/v1/phases/phase-2/decision-record/summary",
+        "/v1/phases/phase-2/decision-resolution/summary",
+        "/v1/phases/phase-2/gate/summary"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-2-decision-resolution --summary",
+        "xytara-release --phase-2-decision-record --summary"
+      ]
+    }
+  };
+}
+
+function summarizePhase2DecisionResolutionPack() {
+  const pack = buildPhase2DecisionResolutionPack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    transition_count: pack.transitions.length,
+    resolution_step_count: pack.resolution_sequence.length,
+    target_gate_decision: pack.completion_result.target_gate_decision,
+    target_ready_for_next_phase: pack.completion_result.target_ready_for_next_phase
+  };
+}
+
+module.exports = {
+  buildPhase2DecisionResolutionPack,
+  summarizePhase2DecisionResolutionPack
+};

package/lib/phase_2_eth_runtime_pack.js

@@ -0,0 +1,70 @@
+"use strict";
+
+const packageJson = require("../package.json");
+
+function buildPhase2EthRuntimePack() {
+  return {
+    ok: true,
+    product: packageJson.name,
+    category: "machine-commerce-phase-2-eth-runtime-pack",
+    phase_ref: "phase_2",
+    ecosystem_refs: ["eth"],
+    posture: "runtime_path",
+    settlement_shape: {
+      payment_asset: "eth",
+      rail_family: "evm",
+      settlement_focus: "chain-native value transfer with runtime-side settlement inspection",
+      operator_surfaces: [
+        "/v1/integrations/settlement-modes",
+        "/v1/release-center/summary"
+      ]
+    },
+    completion_shape: {
+      completion_checks: [
+        "ETH runtime lane is public and inspectable",
+        "chain-native settlement posture stays visible at the lane level",
+        "operator surfaces remain available from the ETH lane",
+        "the lane stays consistent with the broader EVM family"
+      ]
+    },
+    first_path: {
+      purpose: "show the first ETH-specific machine-commerce runtime lane inside the broader EVM phase",
+      first_http_sequence: [
+        "/v1/phases/phase-2/evm-base/summary",
+        "/v1/phases/phase-2/eth/summary",
+        "/v1/integrations/settlement-modes"
+      ],
+      first_cli_sequence: [
+        "xytara-release --phase-2-eth-runtime --summary",
+        "xytara-release --phase-2-evm-base-runtime --summary"
+      ],
+      expected_signals: [
+        "ETH has a dedicated runtime-facing rail slice rather than living only inside the generic EVM bucket",
+        "settlement-shape detail is visible alongside the entry path",
+        "Phase 2 is getting more specific without breaking the shared multi-rail model"
+      ]
+    }
+  };
+}
+
+function summarizePhase2EthRuntimePack() {
+  const pack = buildPhase2EthRuntimePack();
+  return {
+    ok: true,
+    product: pack.product,
+    category: pack.category,
+    phase_ref: pack.phase_ref,
+    ecosystem_count: pack.ecosystem_refs.length,
+    completion_check_count: pack.completion_shape.completion_checks.length,
+    http_step_count: pack.first_path.first_http_sequence.length,
+    cli_step_count: pack.first_path.first_cli_sequence.length,
+    signal_count: pack.first_path.expected_signals.length,
+    operator_surface_count: pack.settlement_shape.operator_surfaces.length,
+    first_http_step: pack.first_path.first_http_sequence[0] || null
+  };
+}
+
+module.exports = {
+  buildPhase2EthRuntimePack,
+  summarizePhase2EthRuntimePack
+};