xytara 1.26.0 → 1.27.0

package/README.md

@@ -606,6 +606,24 @@ Primary service routes:
 - `POST /v1/registry/packs/anchor`
 - `POST /v1/anchoring/submit`
 - `POST /v1/anchoring/packs/preview`
+- `GET /v1/coordination-center`
+- `GET /v1/coordination-center/summary`
+- `GET /v1/zones`
+- `GET /v1/zones/compatibility-profiles`
+- `GET /v1/zones/:zoneId/constitution`
+- `POST /v1/coordination-center/interpretation-handoff/validate`
+- `POST /v1/coordination-center/handshake-preview`
+- `POST /v1/coordination-center/cross-zone-preview`
+- `POST /v1/coordination-center/admission-case-projection`
+- `POST /v1/coordination-center/admission-case-bundle`
+- `POST /v1/coordination-center/operator-view`
+- `POST /v1/coordination-center/admin-view`
+- `POST /v1/coordination-center/admission-ops-pack`
+- `POST /v1/coordination-center/admission-workflow-pack`
+- `POST /v1/coordination-center/coordination-pack`
+- `POST /v1/coordination-center/review-link`
+- `GET /v1/coordination-center/zones-dashboard`
+- `POST /v1/coordination-center/zones-dashboard-pack`
 - `POST /v1/mcp/tools/invoke`
 - `GET /v1/payment-quotes`
 - `GET /v1/payment-quotes/:quote_id`
@@ -636,6 +654,73 @@ Primary service routes:
 - `GET /v1/operator-export-pack`
 - `GET /v1/operations/dashboard`
 - `GET /v1/operations/attention-records`
+- `GET /v1/operator-shell`
+- `GET /v1/operator-shell/summary`
+- `POST /v1/operator-shell/summary`
+- `POST /v1/operator-shell/workflow-pack`
+- `POST /v1/operator-shell/admin-pack`
+- `GET /v1/agent-accounts`
+- `POST /v1/agent-accounts`
+- `GET /v1/agent-accounts/:account_id`
+- `POST /v1/economics/budgets`
+- `POST /v1/economics/budgets/:budget_id/status`
+- `POST /v1/economics/agents`
+- `POST /v1/economics/agents/:agent_id/status`
+- `POST /v1/economics/receipts`
+- `POST /v1/economics/receipts/:receipt_id/lifecycle`
+- `POST /v1/economics/receipts/:receipt_id/operator-action`
+- `POST /v1/economics/allocations/mint`
+- `POST /v1/economics/allocations/reverse`
+- `POST /v1/economics/rails/credits/preview`
+- `POST /v1/economics/rails/credits/apply`
+- `POST /v1/economics/receipt-ledger/validate`
+- `POST /v1/economics/interpretation-handoff`
+- `POST /v1/economics/markets/preview`
+- `POST /v1/economics/markets/workflow-pack`
+- `POST /v1/economics/markets/signoff-pack`
+- `POST /v1/economics/markets/coordination-pack`
+- `GET /v1/economics/accounts/:account_id/budgets`
+- `GET /v1/economics/accounts/:account_id/agents`
+- `GET /v1/economics/accounts/:account_id/receipts`
+- `GET /v1/economics/accounts/:account_id`
+- `GET /v1/economics/accounts/:account_id/operator-view`
+- `GET /v1/economics/accounts/:account_id/operator-dashboard`
+- `GET /v1/economics/accounts/:account_id/treasury-summary`
+- `GET /v1/economics/accounts/:account_id/ledger-export`
+- `GET /v1/economics/accounts/:account_id/treasury-drilldown`
+- `GET /v1/economics/accounts/:account_id/reconciliation-pack`
+- `GET /v1/economics/accounts/:account_id/treasury-workflow-pack`
+- `GET /v1/economics/accounts/:account_id/treasury-signoff-pack`
+- `GET /v1/economics/accounts/:account_id/policy-summary`
+- `GET /v1/economics/accounts/:account_id/rail-summary`
+- `GET /v1/economics/accounts/:account_id/rail-workflow-pack`
+- `GET /v1/economics/accounts/:account_id/rail-signoff-pack`
+- `POST /v1/economics/jobs/:job_id/operator-action`
+- `GET /v1/economics/evidence/receipts/:receipt_ref`
+- `GET /v1/economics/evidence/jobs/:job_id`
+- `GET /v1/economics/integration/jobs/:job_id`
+
+The Wave C coordination carry-over line adds a bounded coordination center on top of the public transaction spine:
+
+- zone discovery, compatibility profiles, and constitution lookup
+- interpretation-handoff validation and cross-zone handshake preview
+- cross-zone admission-case projection and portable case-bundle export
+- coordination operator/admin views plus explicit review-linkage into governance and proof follow-through
+- admission ops/workflow packs, coordination packs, and zones dashboard packaging
+
+The Wave D adapter-breadth line broadens the bundled public integration surface as well:
+
+- additional built-in protocol surfaces for `a2a`, `acp`, `mqtt`, `grpc`, `kafka`, `nats`, and `ros2`
+- additional built-in execution-front surfaces for `langchain`, `langgraph`, `semantic_kernel`, `autogen`, `crewai`, and `llamaindex`
+- broader bundled payment and identity breadth through `mpp` and `erc8004`-oriented public integration surfaces
+
+The Wave F shell carry-over line adds a bounded operator shell inside public `xytara`:
+
+- self-serve agent account issuance for the public runtime path
+- a unified operator shell summary across operations, economics, and coordination
+- compact workflow/admin shell exports that point cleanly into proof-side follow-through when needed
+
+This keeps the public product centered on `naxytra` while recovering the useful operator-shell lineage as a built-in `xytara` capability instead of a separate branded surface.
 
 ## Verification
 

package/SERVICE_CONTRACT.md

@@ -30,6 +30,24 @@ Named first-class lanes:
 - `POST /v1/runtime/emit-anchor`
 - `POST /v1/registry/register`
 - `POST /v1/anchoring/submit`
+- `GET /v1/coordination-center`
+- `GET /v1/coordination-center/summary`
+- `GET /v1/zones`
+- `GET /v1/zones/compatibility-profiles`
+- `GET /v1/zones/:zoneId/constitution`
+- `POST /v1/coordination-center/interpretation-handoff/validate`
+- `POST /v1/coordination-center/handshake-preview`
+- `POST /v1/coordination-center/cross-zone-preview`
+- `POST /v1/coordination-center/admission-case-projection`
+- `POST /v1/coordination-center/admission-case-bundle`
+- `POST /v1/coordination-center/operator-view`
+- `POST /v1/coordination-center/admin-view`
+- `POST /v1/coordination-center/admission-ops-pack`
+- `POST /v1/coordination-center/admission-workflow-pack`
+- `POST /v1/coordination-center/coordination-pack`
+- `POST /v1/coordination-center/review-link`
+- `GET /v1/coordination-center/zones-dashboard`
+- `POST /v1/coordination-center/zones-dashboard-pack`
 - `POST /v1/mcp/tools/invoke`
 - `POST /x402/mcp/tools/invoke`
 
@@ -61,6 +79,51 @@ Lifecycle and operator routes:
 - `GET /v1/operator-export-pack`
 - `GET /v1/operations/dashboard`
 - `GET /v1/operations/attention-records`
+- `GET /v1/operator-shell`
+- `GET /v1/operator-shell/summary`
+- `POST /v1/operator-shell/summary`
+- `POST /v1/operator-shell/workflow-pack`
+- `POST /v1/operator-shell/admin-pack`
+- `GET /v1/agent-accounts`
+- `POST /v1/agent-accounts`
+- `GET /v1/agent-accounts/:account_id`
+- `POST /v1/economics/budgets`
+- `POST /v1/economics/budgets/:budget_id/status`
+- `POST /v1/economics/agents`
+- `POST /v1/economics/agents/:agent_id/status`
+- `POST /v1/economics/receipts`
+- `POST /v1/economics/receipts/:receipt_id/lifecycle`
+- `POST /v1/economics/receipts/:receipt_id/operator-action`
+- `POST /v1/economics/allocations/mint`
+- `POST /v1/economics/allocations/reverse`
+- `POST /v1/economics/rails/credits/preview`
+- `POST /v1/economics/rails/credits/apply`
+- `POST /v1/economics/receipt-ledger/validate`
+- `POST /v1/economics/interpretation-handoff`
+- `POST /v1/economics/markets/preview`
+- `POST /v1/economics/markets/workflow-pack`
+- `POST /v1/economics/markets/signoff-pack`
+- `POST /v1/economics/markets/coordination-pack`
+- `GET /v1/economics/accounts/:account_id/budgets`
+- `GET /v1/economics/accounts/:account_id/agents`
+- `GET /v1/economics/accounts/:account_id/receipts`
+- `GET /v1/economics/accounts/:account_id`
+- `GET /v1/economics/accounts/:account_id/operator-view`
+- `GET /v1/economics/accounts/:account_id/operator-dashboard`
+- `GET /v1/economics/accounts/:account_id/treasury-summary`
+- `GET /v1/economics/accounts/:account_id/ledger-export`
+- `GET /v1/economics/accounts/:account_id/treasury-drilldown`
+- `GET /v1/economics/accounts/:account_id/reconciliation-pack`
+- `GET /v1/economics/accounts/:account_id/treasury-workflow-pack`
+- `GET /v1/economics/accounts/:account_id/treasury-signoff-pack`
+- `GET /v1/economics/accounts/:account_id/policy-summary`
+- `GET /v1/economics/accounts/:account_id/rail-summary`
+- `GET /v1/economics/accounts/:account_id/rail-workflow-pack`
+- `GET /v1/economics/accounts/:account_id/rail-signoff-pack`
+- `POST /v1/economics/jobs/:job_id/operator-action`
+- `GET /v1/economics/evidence/receipts/:receipt_ref`
+- `GET /v1/economics/evidence/jobs/:job_id`
+- `GET /v1/economics/integration/jobs/:job_id`
 
 ## Error-Shape Expectations
 

package/adapters/AUTHORING_GUIDE.md

@@ -68,7 +68,11 @@ Current examples:
 - [example-settlement-adapter.manifest.json](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/adapters/examples/example-settlement-adapter.manifest.json)
 - [example-settlement-adapter.js](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/adapters/examples/example-settlement-adapter.js)
 - [example-third-party-registration.submission-bundle.json](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/adapters/examples/example-third-party-registration.submission-bundle.json)
+- [example-third-party-acp-registration.submission-bundle.json](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/adapters/examples/example-third-party-acp-registration.submission-bundle.json)
 - [example-third-party-identity-registration.submission-bundle.json](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/adapters/examples/example-third-party-identity-registration.submission-bundle.json)
+- [example-third-party-erc8004-registration.submission-bundle.json](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/adapters/examples/example-third-party-erc8004-registration.submission-bundle.json)
+- [example-third-party-langchain-registration.submission-bundle.json](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/adapters/examples/example-third-party-langchain-registration.submission-bundle.json)
+- [example-third-party-mpp-registration.submission-bundle.json](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/adapters/examples/example-third-party-mpp-registration.submission-bundle.json)
 - [example-third-party-settlement-registration.submission-bundle.json](C:/Users/Yoga/Desktop/workspace/vscode_workspace_public/naxytra/xytara/adapters/examples/example-third-party-settlement-registration.submission-bundle.json)
 
 If you want the shortest reviewable end-to-end path, use:
@@ -191,6 +195,12 @@ Use:
 
 This gives future integrations one predictable artifact for authoring review, staging review, or registry import.
 
+Public posture rule:
+
+- native support means `xytara` ships a bundled first-party integration in the registry
+- adapter support means the public contract and authoring path are available for that class or lane
+- third-party plugin posture means the integration should normally enter through explicit submission bundles and staged registration before default rollout
+
 Bundle-driven staging/export is also supported, so a set of reviewed third-party integrations can be turned into a normalized registry snapshot without custom glue code.
 
 If you need to hand off multiple reviewed integrations together, package them as a bundle set rather than inventing a one-off folder convention each time.

package/adapters/examples/example-third-party-acp-registration.submission-bundle.json

@@ -0,0 +1,124 @@
+{
+  "bundle_version": "xytara/integration-submission-bundle/v1",
+  "manifest": {
+    "adapter_id": "partner.protocol.acme_acp",
+    "adapter_class": "agent_protocol_adapter",
+    "adapter_version": "0.1.0",
+    "interface_version": "commerce-adapter-interface/v1",
+    "display_name": "Acme ACP Partner Adapter",
+    "description": "Reference third-party ACP integration showing how staged ACP registration should appear in discovery.",
+    "capabilities": [
+      "protocol.acp.bridge"
+    ],
+    "required_secrets": [
+      "ACME_ACP_TOKEN"
+    ],
+    "required_permissions": [
+      "network:outbound"
+    ],
+    "supported_profiles": [
+      "partner",
+      "marketplace"
+    ],
+    "supported_regions": [
+      "global"
+    ],
+    "supported_settlement_modes": [
+      "evm_payment"
+    ],
+    "pricing_basis": "per_task",
+    "latency_class": "near_real_time",
+    "registration_contract": {
+      "integration_id": "partner.protocol.acme_acp",
+      "integration_maturity": "reference_example",
+      "bundled": false,
+      "default_selection_enabled": false,
+      "requires_explicit_selection": true
+    },
+    "certification_contract": {
+      "certification_state": "reference_example",
+      "certification_scope": [
+        "contract_shape"
+      ],
+      "verified_with": [
+        "verify_adapters"
+      ],
+      "last_verified_contract_version": "xytara/v1"
+    },
+    "compatibility": {
+      "node": ">=18",
+      "commerce_contract": "xytara/v1",
+      "proof_contract": "xoonya/v1"
+    },
+    "health_contract": {
+      "check_kind": "self_reported",
+      "supports_readiness": true
+    },
+    "idempotency_contract": {
+      "strategy": "quote_bound_invocation",
+      "scope": "protocol_invocation"
+    },
+    "failure_contract": {
+      "categories": [
+        "invalid_input",
+        "timeout",
+        "upstream_unavailable"
+      ],
+      "retryable_categories": [
+        "timeout",
+        "upstream_unavailable"
+      ]
+    },
+    "proof_contract": {
+      "emits_proof_compatible_facts": true,
+      "proof_mode": "protocol_invocation_facts"
+    }
+  },
+  "registration_record": {
+    "integration_id": "partner.protocol.acme_acp",
+    "adapter_id": "partner.protocol.acme_acp",
+    "adapter_class": "agent_protocol_adapter",
+    "registration_state": "staging_registered",
+    "integration_maturity": "staging_candidate",
+    "certification_state": "self_attested",
+    "bundled": false,
+    "default_selection_enabled": false,
+    "requires_explicit_selection": true,
+    "registered_at": "2026-03-25T00:00:00Z",
+    "registered_by": "partner:acme",
+    "verified_with": [
+      "schema_conformance",
+      "staging_acp_smoke"
+    ],
+    "protocols": [
+      "acp"
+    ],
+    "settlement_modes": [
+      "evm_payment"
+    ],
+    "notes": "Reference staged registration for third-party ACP integration."
+  },
+  "certification_pack": {
+    "integration_id": "partner.protocol.acme_acp",
+    "adapter_id": "partner.protocol.acme_acp",
+    "adapter_class": "agent_protocol_adapter",
+    "certification_state": "self_attested",
+    "certification_scope": [
+      "self_attested_contract_shape",
+      "staging_smoke"
+    ],
+    "verified_with": [
+      "schema_conformance",
+      "staging_acp_smoke"
+    ],
+    "submitted_at": "2026-03-25T00:00:00Z",
+    "submitted_by": "partner:acme",
+    "last_verified_contract_version": "xytara/v1",
+    "evidence_refs": [
+      "memory://acme-acp/certification/schema-report",
+      "memory://acme-acp/certification/smoke-report"
+    ],
+    "notes": "Reference certification pack for staged third-party ACP integration."
+  },
+  "notes": "Reference submission bundle for third-party ACP integration."
+}

package/adapters/examples/example-third-party-erc8004-registration.submission-bundle.json

@@ -0,0 +1,121 @@
+{
+  "bundle_version": "xytara/integration-submission-bundle/v1",
+  "manifest": {
+    "adapter_id": "partner.identity.erc8004_bridge",
+    "adapter_class": "identity_registry_adapter",
+    "adapter_version": "0.1.0",
+    "interface_version": "commerce-adapter-interface/v1",
+    "display_name": "ERC-8004 Bridge Identity Adapter",
+    "description": "Reference third-party ERC-8004 identity integration showing staged identity-registry registration.",
+    "capabilities": [
+      "identity.erc8004.action"
+    ],
+    "required_secrets": [
+      "ERC8004_BRIDGE_TOKEN"
+    ],
+    "required_permissions": [
+      "network:outbound"
+    ],
+    "supported_profiles": [
+      "identity",
+      "registry"
+    ],
+    "supported_regions": [
+      "global"
+    ],
+    "supported_settlement_modes": [
+      "none"
+    ],
+    "pricing_basis": "per_task",
+    "latency_class": "near_real_time",
+    "registration_contract": {
+      "integration_id": "partner.identity.erc8004_bridge",
+      "integration_maturity": "reference_example",
+      "bundled": false,
+      "default_selection_enabled": false,
+      "requires_explicit_selection": true
+    },
+    "certification_contract": {
+      "certification_state": "reference_example",
+      "certification_scope": [
+        "contract_shape"
+      ],
+      "verified_with": [
+        "verify_adapters"
+      ],
+      "last_verified_contract_version": "xytara/v1"
+    },
+    "compatibility": {
+      "node": ">=18",
+      "commerce_contract": "xytara/v1",
+      "proof_contract": "xoonya/v1"
+    },
+    "health_contract": {
+      "check_kind": "self_reported",
+      "supports_readiness": true
+    },
+    "idempotency_contract": {
+      "strategy": "record_ref_binding",
+      "scope": "identity_registry_request"
+    },
+    "failure_contract": {
+      "categories": [
+        "invalid_input",
+        "timeout",
+        "upstream_unavailable"
+      ],
+      "retryable_categories": [
+        "timeout",
+        "upstream_unavailable"
+      ]
+    },
+    "proof_contract": {
+      "emits_proof_compatible_facts": true,
+      "proof_mode": "registry_reference_facts"
+    }
+  },
+  "registration_record": {
+    "integration_id": "partner.identity.erc8004_bridge",
+    "adapter_id": "partner.identity.erc8004_bridge",
+    "adapter_class": "identity_registry_adapter",
+    "registration_state": "staging_registered",
+    "integration_maturity": "staging_candidate",
+    "certification_state": "self_attested",
+    "bundled": false,
+    "default_selection_enabled": false,
+    "requires_explicit_selection": true,
+    "registered_at": "2026-03-25T00:00:00Z",
+    "registered_by": "partner:erc8004-bridge",
+    "verified_with": [
+      "schema_conformance",
+      "staging_identity_smoke"
+    ],
+    "protocols": [
+      "erc8004"
+    ],
+    "notes": "Reference staged registration for third-party ERC-8004 identity integration."
+  },
+  "certification_pack": {
+    "integration_id": "partner.identity.erc8004_bridge",
+    "adapter_id": "partner.identity.erc8004_bridge",
+    "adapter_class": "identity_registry_adapter",
+    "certification_state": "self_attested",
+    "certification_scope": [
+      "self_attested_contract_shape",
+      "staging_smoke"
+    ],
+    "verified_with": [
+      "schema_conformance",
+      "staging_identity_smoke"
+    ],
+    "submitted_at": "2026-03-25T00:00:00Z",
+    "submitted_by": "partner:erc8004-bridge",
+    "last_verified_contract_version": "xytara/v1",
+    "evidence_refs": [
+      "memory://erc8004-bridge/certification/schema-report",
+      "memory://erc8004-bridge/certification/smoke-report"
+    ],
+    "notes": "Reference certification pack for staged third-party ERC-8004 identity integration."
+  },
+  "notes": "Reference submission bundle for third-party ERC-8004 identity integration."
+}

package/adapters/examples/example-third-party-langchain-registration.submission-bundle.json

@@ -0,0 +1,124 @@
+{
+  "bundle_version": "xytara/integration-submission-bundle/v1",
+  "manifest": {
+    "adapter_id": "partner.execution.langchain_bridge",
+    "adapter_class": "execution_adapter",
+    "adapter_version": "0.1.0",
+    "interface_version": "commerce-adapter-interface/v1",
+    "display_name": "LangChain Bridge Execution Adapter",
+    "description": "Reference third-party LangChain execution-front integration showing staged execution adapter registration.",
+    "capabilities": [
+      "execution.langchain.chain"
+    ],
+    "required_secrets": [
+      "LANGCHAIN_BRIDGE_TOKEN"
+    ],
+    "required_permissions": [
+      "network:outbound"
+    ],
+    "supported_profiles": [
+      "agent_runtime"
+    ],
+    "supported_regions": [
+      "global"
+    ],
+    "supported_settlement_modes": [
+      "none"
+    ],
+    "pricing_basis": "per_task",
+    "latency_class": "interactive",
+    "execution_modes": [
+      "sync",
+      "waited"
+    ],
+    "registration_contract": {
+      "integration_id": "partner.execution.langchain_bridge",
+      "integration_maturity": "reference_example",
+      "bundled": false,
+      "default_selection_enabled": false,
+      "requires_explicit_selection": true
+    },
+    "certification_contract": {
+      "certification_state": "reference_example",
+      "certification_scope": [
+        "contract_shape"
+      ],
+      "verified_with": [
+        "verify_adapters"
+      ],
+      "last_verified_contract_version": "xytara/v1"
+    },
+    "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": "task_execution"
+    },
+    "failure_contract": {
+      "categories": [
+        "invalid_input",
+        "timeout",
+        "upstream_unavailable"
+      ],
+      "retryable_categories": [
+        "timeout",
+        "upstream_unavailable"
+      ]
+    },
+    "proof_contract": {
+      "emits_proof_compatible_facts": true,
+      "proof_mode": "execution_facts_only"
+    }
+  },
+  "registration_record": {
+    "integration_id": "partner.execution.langchain_bridge",
+    "adapter_id": "partner.execution.langchain_bridge",
+    "adapter_class": "execution_adapter",
+    "registration_state": "staging_registered",
+    "integration_maturity": "staging_candidate",
+    "certification_state": "self_attested",
+    "bundled": false,
+    "default_selection_enabled": false,
+    "requires_explicit_selection": true,
+    "registered_at": "2026-03-25T00:00:00Z",
+    "registered_by": "partner:langchain-bridge",
+    "verified_with": [
+      "schema_conformance",
+      "staging_execution_smoke"
+    ],
+    "execution_backends": [
+      "langchain"
+    ],
+    "notes": "Reference staged registration for third-party LangChain execution integration."
+  },
+  "certification_pack": {
+    "integration_id": "partner.execution.langchain_bridge",
+    "adapter_id": "partner.execution.langchain_bridge",
+    "adapter_class": "execution_adapter",
+    "certification_state": "self_attested",
+    "certification_scope": [
+      "self_attested_contract_shape",
+      "staging_smoke"
+    ],
+    "verified_with": [
+      "schema_conformance",
+      "staging_execution_smoke"
+    ],
+    "submitted_at": "2026-03-25T00:00:00Z",
+    "submitted_by": "partner:langchain-bridge",
+    "last_verified_contract_version": "xytara/v1",
+    "evidence_refs": [
+      "memory://langchain-bridge/certification/schema-report",
+      "memory://langchain-bridge/certification/smoke-report"
+    ],
+    "notes": "Reference certification pack for staged third-party LangChain execution integration."
+  },
+  "notes": "Reference submission bundle for third-party LangChain execution integration."
+}