xytara 2.4.0 → 2.6.0

package/START_HERE.md

@@ -18,6 +18,45 @@ Its job is to let a caller:
 
 ## 2. Run The Fastest Real Example
 
+For an outside builder, the shortest public spine is:
+
+```text
+quote -> pay/credits -> execute -> prove
+```
+
+Open:
+
+```text
+https://www.naxytra.com/v1/first-run-path
+https://www.naxytra.com/v1/first-run-kit
+```
+
+The first safe runtime command is quote-only:
+
+```bash
+xytara first-run --run-quote --account ACCOUNT_REF --pretty
+```
+
+The underlying command is:
+
+```bash
+xytara-run --url https://xytara.onrender.com --account ACCOUNT_REF --task adapter.mcp.invoke --command mcp.invoke:summarize --body-json "{\"tool_name\":\"summarize\",\"arguments\":{\"text\":\"Summarize the Naxytra first-run path in one sentence.\"}}" --quote-only --pretty
+```
+
+Then execute with direct signed payment or a credits-first funded account:
+
+```bash
+xytara first-run --execute-with-credits --account ACCOUNT_REF --pretty
+```
+
+Then hand the result into `xoonya` for proof review and verification:
+
+```bash
+xoonya first-run --verify-native --pretty
+```
+
+## 3. Run The Fastest Local Package Example
+
 Run:
 
 ```bash
@@ -37,7 +76,7 @@ If you want the shortest neutral external-adoption bundle, continue with:
 - [EXAMPLE_PATHS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/EXAMPLE_PATHS.md)
 - `node examples/partner_launch_walkthrough.js`
 
-## 3. Verify The Whole Package
+## 4. Verify The Whole Package
 
 Run:
 
@@ -47,12 +86,83 @@ npm run verify:all
 
 This is the production-confidence check for the published package surface.
 
-## 4. Read The Durable Contract
+If you are evaluating a real deployment that will use grants, credits, entitlements, or usage meters, also run:
+
+```bash
+npm run verify:production-readiness
+```
+
+That gate is stricter than local verification and expects:
+
+- runtime persistence through `XYTARA_STATE_FILE` on persistent disk or `XYTARA_SUPABASE_*`
+- signed payment verification with a real wallet registry
+- real operator bearer tokens
+- treasury destinations configured through `XYTARA_TREASURY_DESTINATIONS_PATH`
+- callback signing configured through `XYTARA_CALLBACK_SIGNING_SECRET`
+- hosted checkout event verification configured through `XYTARA_CHECKOUT_WEBHOOK_SECRET`
+- `L402` ingress verification configured through `XYTARA_L402_SHARED_SECRET` when `XYTARA_L402_ENABLED=true`
+- `BOLT` ingress verification configured through `XYTARA_BOLT_SHARED_SECRET` when `XYTARA_BOLT_ENABLED=true`
+- `MPP` ingress verification configured through `XYTARA_MPP_SHARED_SECRET` when `XYTARA_MPP_ENABLED=true`
+- write-path rate limiting configured and enabled
+- execution targets configured through `XYTARA_EXECUTION_TARGETS_JSON` whenever you require provider-backed execution for live sold capabilities
+- non-mock native settlement runtime mode
+
+## 5. Read The Durable Contract
 
 For long-term product understanding, read:
 
 - [FINAL_CONTRACT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/FINAL_CONTRACT.md)
 - [SERVICE_CONTRACT.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/SERVICE_CONTRACT.md)
+- `GET /openapi.json`
+- `GET /asyncapi.json`
+- `GET /cloudevents.json`
+- `GET /v1/auth-profiles`
+- `GET /v1/identity-interop`
+- `GET /v1/providers`
+- `GET /v1/frameworks`
+- `GET /v1/protocols`
+- `GET /v1/integration-matrix`
+- `GET /v1/telemetry`
+- `GET /v1/provenance`
+- `GET /v1/artifact-distribution`
+- `GET /v1/shared-signals`
+- `GET /v1/feature-control`
+- `GET /v1/mcp`
+- `GET /v1/a2a`
+- `GET /v1/a2c`
+- `GET /v1/x402`
+- `GET /v1/l402`
+- `GET /v1/l402/security`
+- `GET /v1/bolt`
+- `GET /v1/bolt/security`
+- `GET /v1/stripe-mpp`
+- `GET /v1/stripe-mpp/security`
+- `GET /v1/network-transport`
+- `GET /v1/payment-protocols`
+- `GET /v1/payment-protocols/strategy`
+- `GET /v1/payment-fronts`
+- `GET /v1/checkout/events/security`
+- `GET /v1/settlement`
+- `GET /v1/stripe-mpp`
+- `GET /v1/stablecoins`
+- `GET /v1/major-rails`
+- `GET /v1/treasury`
+- `GET /v1/pricing-optimization`
+- `GET /v1/pricing-optimization/quote-cohorts`
+- `GET /v1/pricing-optimization/recommendations`
+- `GET /v1/activity-ledger`
+- `GET /v1/treasury-destinations`
+- `GET /v1/treasury-destinations/operator-pack`
+- `POST /v1/treasury-destinations/validate-preview`
+- `GET /v1/treasury-egress-policy`
+- `GET /v1/erc8004`
+- `GET /v1/event-systems`
+- `GET /v1/integrations`
+- `GET /v1/capability-registry/execution-truth`
+- `GET /v1/capability-registry/execution-truth/summary`
+- `GET /v1/capability-registry/commercialization-summary`
+- `GET /v1/go-live`
+- `GET /v1/go-live/summary`
 - [PROGRAM_STATUS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/PROGRAM_STATUS.md)
 - [OPERATOR_START_HERE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/OPERATOR_START_HERE.md)
 - [OPERATIONS_RUNBOOK.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/OPERATIONS_RUNBOOK.md)
@@ -62,9 +172,11 @@ For long-term product understanding, read:
 - [PARTNER_READY_PATH.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/PARTNER_READY_PATH.md)
 - [BSV_TERANODE_SETUP.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/BSV_TERANODE_SETUP.md)
 - [REAL_PAYMENT_SETUP.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/REAL_PAYMENT_SETUP.md)
+- [TREASURY_DESTINATIONS.example.json](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/TREASURY_DESTINATIONS.example.json)
+- [TREASURY_DESTINATIONS.production.template.json](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/TREASURY_DESTINATIONS.production.template.json)
 - [TERMINOLOGY.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/TERMINOLOGY.md)
 
-## 5. If You Are Building Adapters
+## 6. If You Are Building Adapters
 
 Continue with:
 
@@ -73,7 +185,7 @@ Continue with:
 - [adapters/ONBOARDING_POSTURE.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/adapters/ONBOARDING_POSTURE.md)
 - [adapters/THIRD_PARTY_SUBMISSION_PROCESS.md](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/adapters/THIRD_PARTY_SUBMISSION_PROCESS.md)
 
-## 6. Production Reading Rule
+## 7. Production Reading Rule
 
 If you only remember one thing, remember this:
 
@@ -83,7 +195,36 @@ It is:
 
 discover -> preview/quote -> execute -> inspect -> hand off to `xoonya`
 
-## 7. If You Are Operating The Closed Program
+If you want the shortest CLI-first read of the package after install, use:
+
+- `xytara start-here`
+- `xytara release --summary`
+- `xytara run --help`
+
+If you are operationalizing monetization and multi-rail treasury custody, use:
+
+- `GET /v1/go-live`
+- `GET /v1/go-live/summary`
+- `GET /v1/pricing-optimization/quote-abandonment-summary`
+- `GET /v1/pricing-optimization/quote-cohorts`
+- `GET /v1/pricing-optimization/recommendations`
+- `GET /v1/treasury-destinations`
+- `GET /v1/treasury-destinations/operator-pack`
+- `POST /v1/treasury-destinations/validate-preview`
+- `GET /v1/treasury-egress-policy`
+- `GET /v1/activity-ledger`
+- `GET /v1/capability-registry/execution-truth`
+- `GET /v1/capability-registry/execution-truth/summary`
+- `GET /v1/capability-registry/commercialization-summary`
+
+Public/private rule:
+
+- `GET /v1/treasury-destinations` is safe for public-readiness visibility
+- `GET /v1/treasury-destinations/operator-pack` is where real custody landing refs belong
+- public website and public catalog surfaces should never expose treasury landing refs or custody-provider refs
+- when `XYTARA_ACCOUNT_AUTH_BEARER_TOKEN` is configured, operator-only routes like `activity-ledger`, `treasury-destinations/operator-pack`, `treasury-destinations/validate-preview`, and `treasury-egress-policy` require that bearer token
+
+## 8. If You Are Operating The Closed Program
 
 Use:
 

package/TREASURY_DESTINATIONS.example.json

@@ -0,0 +1,66 @@
+{
+  "bsv_teranode": {
+    "destination_id": "treasury_bsv_main",
+    "destination_kind": "bsv_teranode_address",
+    "external_ref": "1ReplaceWithRealBsvAddressOrPaymail",
+    "custody_ref": "vault.bsv.primary",
+    "reporting_ref": "ledger.bsv.primary",
+    "wallet_ref": "wallet.bsv.primary",
+    "provider_ref": "arc.bsv.primary",
+    "network": "mainnet",
+    "storage_class": "cold_primary"
+  },
+  "evm": {
+    "destination_id": "treasury_evm_main",
+    "destination_kind": "evm_address",
+    "external_ref": "0xReplaceWithRealEvmTreasuryAddress",
+    "chain_id": "1",
+    "custody_ref": "vault.evm.primary",
+    "reporting_ref": "ledger.evm.primary",
+    "wallet_ref": "wallet.evm.primary",
+    "provider_ref": "rpc.evm.primary",
+    "storage_class": "warm_operational"
+  },
+  "base": {
+    "destination_id": "treasury_base_main",
+    "destination_kind": "evm_address",
+    "external_ref": "0xReplaceWithRealBaseTreasuryAddress",
+    "chain_id": "8453",
+    "custody_ref": "vault.base.primary",
+    "reporting_ref": "ledger.base.primary",
+    "wallet_ref": "wallet.base.primary",
+    "provider_ref": "rpc.base.primary",
+    "storage_class": "warm_operational"
+  },
+  "usdc": {
+    "destination_id": "treasury_usdc_primary",
+    "destination_kind": "stablecoin_address",
+    "external_ref": "0xReplaceWithRealUsdcReceivingAddress",
+    "asset_symbol": "USDC",
+    "chain_id": "8453",
+    "custody_ref": "vault.usdc.primary",
+    "reporting_ref": "ledger.usdc.primary",
+    "wallet_ref": "wallet.usdc.primary",
+    "storage_class": "warm_operational"
+  },
+  "dai": {
+    "destination_id": "treasury_dai_primary",
+    "destination_kind": "stablecoin_address",
+    "external_ref": "0xReplaceWithRealDaiReceivingAddress",
+    "asset_symbol": "DAI",
+    "chain_id": "1",
+    "custody_ref": "vault.dai.primary",
+    "reporting_ref": "ledger.dai.primary",
+    "wallet_ref": "wallet.dai.primary",
+    "storage_class": "warm_operational"
+  },
+  "monero": {
+    "destination_id": "treasury_monero_private",
+    "destination_kind": "monero_address",
+    "external_ref": "8ReplaceWithRealMoneroAddress",
+    "policy_scope": "internal_optional_privacy_reserve",
+    "custody_ref": "vault.monero.policy_gated",
+    "reporting_ref": "ledger.monero.internal",
+    "storage_class": "isolated_policy_gated"
+  }
+}

package/TREASURY_DESTINATIONS.production.template.json

@@ -0,0 +1,108 @@
+{
+  "_notes": [
+    "Copy this file to TREASURY_DESTINATIONS.production.json and replace every placeholder before use.",
+    "Only claim a rail as live treasury landing if its entry has a real destination you control.",
+    "external_ref is the real receiving destination: address, paymail, or equivalent custody landing reference.",
+    "monero should remain internal-only and policy-gated."
+  ],
+  "bsv_teranode": {
+    "destination_id": "treasury_bsv_main",
+    "destination_kind": "bsv_teranode_address",
+    "external_ref": "REPLACE_WITH_REAL_BSV_ADDRESS_OR_PAYMAIL",
+    "custody_ref": "vault.bsv.primary",
+    "reporting_ref": "ledger.bsv.primary",
+    "wallet_ref": "wallet.bsv.primary",
+    "provider_ref": "arc.bsv.primary",
+    "network": "mainnet",
+    "storage_class": "cold_primary"
+  },
+  "evm": {
+    "destination_id": "treasury_evm_main",
+    "destination_kind": "evm_address",
+    "external_ref": "REPLACE_WITH_REAL_EVM_MAINNET_ADDRESS",
+    "chain_id": "1",
+    "custody_ref": "vault.evm.primary",
+    "reporting_ref": "ledger.evm.primary",
+    "wallet_ref": "wallet.evm.primary",
+    "provider_ref": "rpc.evm.primary",
+    "storage_class": "warm_operational"
+  },
+  "base": {
+    "destination_id": "treasury_base_main",
+    "destination_kind": "evm_address",
+    "external_ref": "REPLACE_WITH_REAL_BASE_ADDRESS",
+    "chain_id": "8453",
+    "custody_ref": "vault.base.primary",
+    "reporting_ref": "ledger.base.primary",
+    "wallet_ref": "wallet.base.primary",
+    "provider_ref": "rpc.base.primary",
+    "storage_class": "warm_operational"
+  },
+  "solana_payment": {
+    "destination_id": "treasury_solana_main",
+    "destination_kind": "solana_address",
+    "external_ref": "REPLACE_WITH_REAL_SOLANA_ADDRESS",
+    "network": "mainnet-beta",
+    "asset_symbol": "SOL_OR_SPL",
+    "custody_ref": "vault.solana.primary",
+    "reporting_ref": "ledger.solana.primary",
+    "wallet_ref": "wallet.solana.primary",
+    "provider_ref": "rpc.solana.primary",
+    "storage_class": "warm_operational"
+  },
+  "xpr_payment": {
+    "destination_id": "treasury_xpr_main",
+    "destination_kind": "proton_xpr_account",
+    "external_ref": "REPLACE_WITH_REAL_XPR_ACCOUNT",
+    "network": "mainnet",
+    "asset_symbol": "XPR",
+    "custody_ref": "vault.xpr.primary",
+    "reporting_ref": "ledger.xpr.primary",
+    "wallet_ref": "wallet.xpr.primary",
+    "provider_ref": "rpc.xpr.primary",
+    "storage_class": "warm_operational"
+  },
+  "antelope_payment": {
+    "destination_id": "treasury_antelope_main",
+    "destination_kind": "antelope_account",
+    "external_ref": "REPLACE_WITH_REAL_ANTELOPE_ACCOUNT",
+    "network": "mainnet",
+    "asset_symbol": "EOSIO_OR_ANTILOPE",
+    "custody_ref": "vault.antelope.primary",
+    "reporting_ref": "ledger.antelope.primary",
+    "wallet_ref": "wallet.antelope.primary",
+    "provider_ref": "rpc.antelope.primary",
+    "storage_class": "warm_operational"
+  },
+  "usdc": {
+    "destination_id": "treasury_usdc_primary",
+    "destination_kind": "stablecoin_address",
+    "external_ref": "REPLACE_WITH_REAL_USDC_RECEIVING_ADDRESS",
+    "asset_symbol": "USDC",
+    "chain_id": "8453",
+    "custody_ref": "vault.usdc.primary",
+    "reporting_ref": "ledger.usdc.primary",
+    "wallet_ref": "wallet.usdc.primary",
+    "storage_class": "warm_operational"
+  },
+  "dai": {
+    "destination_id": "treasury_dai_primary",
+    "destination_kind": "stablecoin_address",
+    "external_ref": "REPLACE_WITH_REAL_DAI_RECEIVING_ADDRESS",
+    "asset_symbol": "DAI",
+    "chain_id": "1",
+    "custody_ref": "vault.dai.primary",
+    "reporting_ref": "ledger.dai.primary",
+    "wallet_ref": "wallet.dai.primary",
+    "storage_class": "warm_operational"
+  },
+  "monero": {
+    "destination_id": "treasury_monero_private",
+    "destination_kind": "monero_address",
+    "external_ref": "REPLACE_WITH_REAL_MONERO_ADDRESS",
+    "policy_scope": "internal_optional_privacy_reserve",
+    "custody_ref": "vault.monero.policy_gated",
+    "reporting_ref": "ledger.monero.internal",
+    "storage_class": "isolated_policy_gated"
+  }
+}

package/adapters/examples/langchain-reference-execution-adapter.js

@@ -0,0 +1,81 @@
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+
+const manifest = JSON.parse(
+  fs.readFileSync(path.resolve(__dirname, "langchain-reference-execution-adapter.manifest.json"), "utf8")
+);
+
+function normalizeChainRequest(request) {
+  const body = request && request.body && typeof request.body === "object" ? request.body : {};
+  const chainRef = String(body.chain_ref || body.chain_id || request.task_ref || "langchain.reference.chain").trim();
+  const toolTraceRef = String(body.tool_trace_ref || body.trace_id || "trace.reference").trim();
+  const contextRef = String(body.context_ref || body.session_id || "context.reference").trim();
+  return {
+    chain_ref: chainRef,
+    tool_trace_ref: toolTraceRef,
+    context_ref: contextRef,
+    input: body.input && typeof body.input === "object" ? body.input : {}
+  };
+}
+
+async function getHealth() {
+  return {
+    status: "ok",
+    readiness: "ready",
+    adapter_id: manifest.adapter_id,
+    provider_claim: "reference_local_contract_adapter"
+  };
+}
+
+function describeCapabilities() {
+  return {
+    adapter_id: manifest.adapter_id,
+    adapter_class: manifest.adapter_class,
+    capabilities: manifest.capabilities.slice(),
+    execution_modes: Array.isArray(manifest.execution_modes) ? manifest.execution_modes.slice() : [],
+    claim_boundary: "normalizes_langchain_style_payloads_without_claiming_external_provider_execution"
+  };
+}
+
+async function preview(request) {
+  const normalized = normalizeChainRequest(request || {});
+  return {
+    adapter_id: manifest.adapter_id,
+    accepted: true,
+    preview: {
+      mode: "preview",
+      ...normalized
+    }
+  };
+}
+
+async function execute(request) {
+  const normalized = normalizeChainRequest(request || {});
+  return {
+    adapter_id: manifest.adapter_id,
+    status: "completed",
+    result: {
+      mode: "execute",
+      framework: "langchain",
+      ...normalized
+    },
+    proof_facts: {
+      emits_proof_compatible_facts: true,
+      proof_mode: manifest.proof_contract.proof_mode,
+      framework: "langchain",
+      chain_ref: normalized.chain_ref,
+      tool_trace_ref: normalized.tool_trace_ref,
+      context_ref: normalized.context_ref
+    }
+  };
+}
+
+module.exports = {
+  manifest,
+  getHealth,
+  describeCapabilities,
+  preview,
+  execute
+};

package/adapters/examples/langchain-reference-execution-adapter.manifest.json

@@ -0,0 +1,79 @@
+{
+  "adapter_id": "reference.framework.langchain",
+  "adapter_class": "execution_adapter",
+  "adapter_version": "0.1.0",
+  "interface_version": "commerce-adapter-interface/v1",
+  "display_name": "LangChain Reference Execution Adapter",
+  "description": "Reference execution adapter for LangChain-style chain, tool, and trace payloads without claiming a live external LangChain provider.",
+  "capabilities": [
+    "framework.langchain.preview",
+    "framework.langchain.execute"
+  ],
+  "compatibility": {
+    "node": ">=18",
+    "commerce_contract": "xytara/v1",
+    "proof_contract": "xoonya/v1"
+  },
+  "health_contract": {
+    "check_kind": "self_reported",
+    "supports_readiness": true
+  },
+  "idempotency_contract": {
+    "strategy": "caller_supplied_key",
+    "scope": "framework_execution"
+  },
+  "failure_contract": {
+    "categories": [
+      "invalid_chain_payload",
+      "timeout",
+      "upstream_unavailable"
+    ],
+    "retryable_categories": [
+      "timeout",
+      "upstream_unavailable"
+    ]
+  },
+  "proof_contract": {
+    "emits_proof_compatible_facts": true,
+    "proof_mode": "framework_execution_facts"
+  },
+  "latency_class": "interactive",
+  "pricing_basis": "per_chain_execution",
+  "execution_modes": [
+    "sync"
+  ],
+  "required_secrets": [],
+  "required_permissions": [],
+  "supported_profiles": [
+    "reference",
+    "framework"
+  ],
+  "supported_regions": [
+    "local"
+  ],
+  "supported_settlement_modes": [
+    "credits_first",
+    "bsv_teranode",
+    "x402"
+  ],
+  "registration_contract": {
+    "integration_id": "reference.framework.langchain",
+    "integration_maturity": "reference_example",
+    "bundled": true,
+    "default_selection_enabled": false,
+    "selection_priority": 430,
+    "requires_explicit_selection": true
+  },
+  "certification_contract": {
+    "certification_state": "reference_example",
+    "certification_scope": [
+      "contract_shape",
+      "framework_payload_normalization",
+      "proof_fact_emission"
+    ],
+    "verified_with": [
+      "npm run verify:adapters"
+    ],
+    "last_verified_contract_version": "commerce-adapter-interface/v1"
+  }
+}

package/adapters/examples/langgraph-reference-execution-adapter.js

@@ -0,0 +1,81 @@
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+
+const manifest = JSON.parse(
+  fs.readFileSync(path.resolve(__dirname, "langgraph-reference-execution-adapter.manifest.json"), "utf8")
+);
+
+function normalizeGraphRequest(request) {
+  const body = request && request.body && typeof request.body === "object" ? request.body : {};
+  const graphRef = String(body.graph_ref || body.graph_id || request.task_ref || "langgraph.reference.graph").trim();
+  const nodeRef = String(body.node_ref || body.node_id || "entry").trim();
+  const checkpointRef = String(body.checkpoint_ref || body.thread_id || "checkpoint.reference").trim();
+  return {
+    graph_ref: graphRef,
+    node_ref: nodeRef,
+    checkpoint_ref: checkpointRef,
+    input: body.input && typeof body.input === "object" ? body.input : {}
+  };
+}
+
+async function getHealth() {
+  return {
+    status: "ok",
+    readiness: "ready",
+    adapter_id: manifest.adapter_id,
+    provider_claim: "reference_local_contract_adapter"
+  };
+}
+
+function describeCapabilities() {
+  return {
+    adapter_id: manifest.adapter_id,
+    adapter_class: manifest.adapter_class,
+    capabilities: manifest.capabilities.slice(),
+    execution_modes: Array.isArray(manifest.execution_modes) ? manifest.execution_modes.slice() : [],
+    claim_boundary: "normalizes_langgraph_style_payloads_without_claiming_external_provider_execution"
+  };
+}
+
+async function preview(request) {
+  const normalized = normalizeGraphRequest(request || {});
+  return {
+    adapter_id: manifest.adapter_id,
+    accepted: true,
+    preview: {
+      mode: "preview",
+      ...normalized
+    }
+  };
+}
+
+async function execute(request) {
+  const normalized = normalizeGraphRequest(request || {});
+  return {
+    adapter_id: manifest.adapter_id,
+    status: "completed",
+    result: {
+      mode: "execute",
+      framework: "langgraph",
+      ...normalized
+    },
+    proof_facts: {
+      emits_proof_compatible_facts: true,
+      proof_mode: manifest.proof_contract.proof_mode,
+      framework: "langgraph",
+      graph_ref: normalized.graph_ref,
+      node_ref: normalized.node_ref,
+      checkpoint_ref: normalized.checkpoint_ref
+    }
+  };
+}
+
+module.exports = {
+  manifest,
+  getHealth,
+  describeCapabilities,
+  preview,
+  execute
+};