xytara 1.2.0 → 1.4.0

package/README.md

@@ -30,15 +30,25 @@ The public product loop is:
 
 The package and service surfaces both follow that model.
 
-The current built-in catalog now covers a broader first-party `1.2.0` kernel than the original narrow seed, including:
+The current built-in catalog now covers a broader first-party `1.4.0` kernel than the original narrow seed, including:
 
 - trust and receipt validation/handoff tasks
 - runtime consequence tasks
 - jobs, credits, and policy tasks
+- first-party `a2a` negotiation and commit tasks
+- first-party `a2c` session and task-pack preview tasks
+- identity attestation and registry-link tasks
 - registry and anchoring tasks
 - discovery, admission, and settlement tasks
 - an initial built-in `mcp` adapter task
 
+The current restoration phase also starts carrying grouped public workflows for:
+
+- `a2a` settlement negotiation
+- `a2c` tooling/session flow
+- identity registry plus anchoring flow
+- registry pack bundling plus anchoring flow
+
 The current built-in settlement posture also now reflects the canonical first-party center of gravity across:
 
 - `ethereum_evm`
@@ -47,6 +57,15 @@ The current built-in settlement posture also now reflects the canonical first-pa
 - `proton_xpr`
 - `antelope_eosio`
 
+The economic artifact posture is also now more explicit across the default machine loop:
+
+- quotes carry normalized `payment`, `settlement`, and `treasury` state
+- executed transactions and receipts carry the same normalized economic objects
+- payment-ledger entries preserve linked payment / settlement / treasury outcomes
+- the default first-party economic path is easier to inspect without provider-shaped logic
+
+The same artifacts now also expose a normalized `default_path` object so the bundled economic center of gravity is visible as data instead of being inferred indirectly.
+
 ## Package Surface
 
 The SDK is broad, but it stays organized into a few repeatable families instead of one-off surfaces.
@@ -230,12 +249,18 @@ The quickstart exercises:
 
 - health and catalog
 - discovery summaries and filters
+- restored `a2a`, `a2c`, and identity catalog families
 - staged-vs-default integration posture
 - submission bundle-set export
 - pricing, schema, and template access
 - validation
 - quote and execution flows
 - dedicated `mcp` invocation flow
+- named `a2a` negotiation and commit lanes
+- named `a2c` session and pack-preview lanes
+- named identity attestation preview and registry-link lanes
+- named registry-pack bundle and anchoring-pack preview lanes
+- grouped `a2a`, `a2c`, identity-anchor, and registry-pack-anchor convenience flows
 - named runtime, admission, registry, and anchoring task lanes
 - named trust and receipt-handoff lanes
 - lifecycle and operator helpers
@@ -263,6 +288,30 @@ curl -X POST http://127.0.0.1:4320/v1/admission/preview ^
   -H "content-type: application/json" ^
   -H "authorization: Bearer demo-api-key" ^
   -d "{\"source_zone_id\":\"zone-a\",\"target_zone_id\":\"zone-b\"}"
+curl -X POST http://127.0.0.1:4320/v1/a2a/negotiate ^
+  -H "content-type: application/json" ^
+  -H "authorization: Bearer demo-api-key" ^
+  -d "{\"counterparty_agent_id\":\"agent-counterparty-1\",\"task_pack_ref\":\"pack.a2a.demo\",\"negotiation_mode\":\"quote_then_commit\"}"
+curl -X POST http://127.0.0.1:4320/v1/a2c/packs/preview ^
+  -H "content-type: application/json" ^
+  -H "authorization: Bearer demo-api-key" ^
+  -d "{\"agent_id\":\"agent-demo\",\"pack_ref\":\"pack.tools.research\"}"
+curl -X POST http://127.0.0.1:4320/v1/identity/attest/preview ^
+  -H "content-type: application/json" ^
+  -H "authorization: Bearer demo-api-key" ^
+  -d "{\"subject_id\":\"subject-identity-1\",\"registry_scope\":\"registry.identity.default\"}"
+curl -X POST http://127.0.0.1:4320/v1/registry/packs/bundle ^
+  -H "content-type: application/json" ^
+  -H "authorization: Bearer demo-api-key" ^
+  -d "{\"pack_ref\":\"pack.registry.identity\",\"subject_ids\":[\"subject-identity-1\",\"subject-identity-2\"]}"
+curl -X POST http://127.0.0.1:4320/v1/a2a/flows/settlement ^
+  -H "content-type: application/json" ^
+  -H "authorization: Bearer demo-api-key" ^
+  -d "{\"counterparty_agent_id\":\"agent-counterparty-1\",\"task_pack_ref\":\"pack.a2a.demo\",\"negotiation_mode\":\"quote_then_commit\",\"negotiation_id\":\"negotiation-flow-1\",\"intent_id\":\"intent-a2a-flow-1\"}"
+curl -X POST http://127.0.0.1:4320/v1/identity/flows/anchor ^
+  -H "content-type: application/json" ^
+  -H "authorization: Bearer demo-api-key" ^
+  -d "{\"subject_id\":\"subject-identity-1\",\"registry_scope\":\"registry.identity.default\",\"record_type\":\"identity_attestation\",\"registry_record_id\":\"registry-record-identity-1\",\"commitment_hash\":\"commitment-identity-1\"}"
 curl -X POST http://127.0.0.1:4320/v1/mcp/tools/invoke ^
   -H "content-type: application/json" ^
   -H "authorization: Bearer demo-api-key" ^
@@ -302,11 +351,23 @@ Primary service routes:
 - `POST /v1/receipt-ledger/handoffs/emit`
 - `POST /v1/receipt-ledger/handoffs/validate`
 - `POST /v1/admission/preview`
+- `POST /v1/a2a/negotiate`
+- `POST /v1/a2a/commit`
+- `POST /v1/a2a/flows/settlement`
+- `POST /v1/a2c/sessions/open`
+- `POST /v1/a2c/packs/preview`
+- `POST /v1/a2c/flows/tooling`
+- `POST /v1/identity/attest/preview`
+- `POST /v1/identity/registry/link`
+- `POST /v1/identity/flows/anchor`
 - `POST /v1/runtime/emit`
 - `POST /v1/runtime/anchor`
 - `POST /v1/runtime/emit-anchor`
 - `POST /v1/registry/register`
+- `POST /v1/registry/packs/bundle`
+- `POST /v1/registry/packs/anchor`
 - `POST /v1/anchoring/submit`
+- `POST /v1/anchoring/packs/preview`
 - `POST /v1/mcp/tools/invoke`
 - `GET /v1/payment-quotes`
 - `GET /v1/payment-quotes/:quote_id`

package/fixtures/catalog.js

@@ -440,6 +440,95 @@ const tasks = [
     capabilities: ["credits.apply"],
     adapters: ["http"]
   }),
+  makeTask({
+    task_ref: "internal.a2a.negotiate",
+    public_task_ref: "a2a.negotiate",
+    public_category: "a2a",
+    public_title: "A2A Negotiate",
+    execution_mode: "direct_http",
+    pricing_band: "decision_support",
+    public_launch_price: { amount_minor: 45, currency: "USD_CENTS" },
+    latency_class: "near_real_time",
+    failure_posture: "retry_bounded",
+    input_schema: {
+      type: "object",
+      required: ["counterparty_agent_id", "task_pack_ref"],
+      properties: {
+        counterparty_agent_id: { type: "string" },
+        task_pack_ref: { type: "string" },
+        negotiation_mode: { type: "string" }
+      },
+      additionalProperties: false
+    },
+    capabilities: ["a2a.negotiate"],
+    adapters: ["http"]
+  }),
+  makeTask({
+    task_ref: "internal.a2a.commit",
+    public_task_ref: "a2a.commit",
+    public_category: "a2a",
+    public_title: "A2A Commit",
+    execution_mode: "governed_async",
+    pricing_band: "transactional",
+    public_launch_price: { amount_minor: 105, currency: "USD_CENTS" },
+    latency_class: "governed_async",
+    failure_posture: "governed_async",
+    input_schema: {
+      type: "object",
+      required: ["negotiation_id", "intent_id"],
+      properties: {
+        negotiation_id: { type: "string" },
+        intent_id: { type: "string" }
+      },
+      additionalProperties: false
+    },
+    capabilities: ["a2a.commit"],
+    adapters: ["http", "chain"]
+  }),
+  makeTask({
+    task_ref: "internal.a2c.session.open",
+    public_task_ref: "a2c.session.open",
+    public_category: "a2c",
+    public_title: "A2C Session Open",
+    execution_mode: "direct_http",
+    pricing_band: "utility",
+    public_launch_price: { amount_minor: 20, currency: "USD_CENTS" },
+    latency_class: "instant",
+    failure_posture: "fail_fast",
+    input_schema: {
+      type: "object",
+      required: ["agent_id", "channel_ref"],
+      properties: {
+        agent_id: { type: "string" },
+        channel_ref: { type: "string" }
+      },
+      additionalProperties: false
+    },
+    capabilities: ["a2c.session.open"],
+    adapters: ["http", "mcp"]
+  }),
+  makeTask({
+    task_ref: "internal.a2c.pack.preview",
+    public_task_ref: "a2c.pack.preview",
+    public_category: "a2c",
+    public_title: "A2C Pack Preview",
+    execution_mode: "direct_http",
+    pricing_band: "utility",
+    public_launch_price: { amount_minor: 25, currency: "USD_CENTS" },
+    latency_class: "near_real_time",
+    failure_posture: "retry_bounded",
+    input_schema: {
+      type: "object",
+      required: ["agent_id", "pack_ref"],
+      properties: {
+        agent_id: { type: "string" },
+        pack_ref: { type: "string" }
+      },
+      additionalProperties: false
+    },
+    capabilities: ["a2c.pack.preview"],
+    adapters: ["http"]
+  }),
   makeTask({
     task_ref: "internal.policy.simulate",
     public_task_ref: "policy.simulate",
@@ -461,6 +550,50 @@ const tasks = [
     capabilities: ["policy.simulate"],
     adapters: ["http"]
   }),
+  makeTask({
+    task_ref: "internal.identity.attest.preview",
+    public_task_ref: "identity.attest.preview",
+    public_category: "identity",
+    public_title: "Identity Attest Preview",
+    execution_mode: "direct_http",
+    pricing_band: "decision_support",
+    public_launch_price: { amount_minor: 40, currency: "USD_CENTS" },
+    latency_class: "near_real_time",
+    failure_posture: "retry_bounded",
+    input_schema: {
+      type: "object",
+      required: ["subject_id", "registry_scope"],
+      properties: {
+        subject_id: { type: "string" },
+        registry_scope: { type: "string" }
+      },
+      additionalProperties: false
+    },
+    capabilities: ["identity.attest.preview"],
+    adapters: ["http"]
+  }),
+  makeTask({
+    task_ref: "internal.identity.registry.link",
+    public_task_ref: "identity.registry.link",
+    public_category: "identity",
+    public_title: "Identity Registry Link",
+    execution_mode: "governed_async",
+    pricing_band: "transactional",
+    public_launch_price: { amount_minor: 115, currency: "USD_CENTS" },
+    latency_class: "governed_async",
+    failure_posture: "governed_async",
+    input_schema: {
+      type: "object",
+      required: ["subject_id", "registry_record_id"],
+      properties: {
+        subject_id: { type: "string" },
+        registry_record_id: { type: "string" }
+      },
+      additionalProperties: false
+    },
+    capabilities: ["identity.registry.link"],
+    adapters: ["chain"]
+  }),
   makeTask({
     task_ref: "internal.registry.register",
     public_task_ref: "registry.register",
@@ -483,6 +616,32 @@ const tasks = [
     capabilities: ["registry.register"],
     adapters: ["chain"]
   }),
+  makeTask({
+    task_ref: "internal.registry.pack.bundle",
+    public_task_ref: "registry.pack.bundle",
+    public_category: "registry",
+    public_title: "Registry Pack Bundle",
+    execution_mode: "governed_async",
+    pricing_band: "transactional",
+    public_launch_price: { amount_minor: 135, currency: "USD_CENTS" },
+    latency_class: "governed_async",
+    failure_posture: "governed_async",
+    input_schema: {
+      type: "object",
+      required: ["pack_ref", "subject_ids"],
+      properties: {
+        pack_ref: { type: "string" },
+        subject_ids: {
+          type: "array",
+          items: { type: "string" },
+          minItems: 1
+        }
+      },
+      additionalProperties: false
+    },
+    capabilities: ["registry.pack.bundle"],
+    adapters: ["chain"]
+  }),
   makeTask({
     task_ref: "internal.anchoring.submit",
     public_task_ref: "anchoring.submit",
@@ -504,6 +663,28 @@ const tasks = [
     capabilities: ["anchoring.submit"],
     adapters: ["chain"]
   }),
+  makeTask({
+    task_ref: "internal.anchoring.pack.preview",
+    public_task_ref: "anchoring.pack.preview",
+    public_category: "anchoring",
+    public_title: "Anchoring Pack Preview",
+    execution_mode: "direct_http",
+    pricing_band: "decision_support",
+    public_launch_price: { amount_minor: 35, currency: "USD_CENTS" },
+    latency_class: "near_real_time",
+    failure_posture: "retry_bounded",
+    input_schema: {
+      type: "object",
+      required: ["pack_ref", "commitment_count"],
+      properties: {
+        pack_ref: { type: "string" },
+        commitment_count: { type: "integer", minimum: 1 }
+      },
+      additionalProperties: false
+    },
+    capabilities: ["anchoring.pack.preview"],
+    adapters: ["chain"]
+  }),
   makeTask({
     task_ref: "internal.zones.list",
     public_task_ref: "zones.list",
@@ -662,6 +843,59 @@ const workflows = [
     latency_class: "governed_async",
     failure_posture: "governed_async",
     pricing_basis: "sum"
+  },
+  {
+    workflow_ref: "a2a.settlement.flow",
+    aliases: ["a2a.settlement.flow", "agent.negotiation.flow"],
+    category: "a2a",
+    title: "A2A Settlement Flow",
+    description: "Negotiate with another agent, commit the intent, and settle the resulting transaction.",
+    task_count: 3,
+    task_refs: ["a2a.negotiate", "a2a.commit", "settlement.submit"],
+    latency_class: "governed_async",
+    failure_posture: "governed_async",
+    pricing_basis: "sum"
+  },
+  {
+    workflow_ref: "a2c.tooling.flow",
+    aliases: ["a2c.tooling.flow", "agent.channel.tooling.flow"],
+    category: "a2c",
+    title: "A2C Tooling Flow",
+    description: "Open a channel session, preview a task pack, and invoke the selected MCP tool lane.",
+    task_count: 3,
+    task_refs: ["a2c.session.open", "a2c.pack.preview", "adapter.mcp.invoke"],
+    latency_class: "near_real_time",
+    failure_posture: "retry_bounded",
+    pricing_basis: "sum"
+  },
+  {
+    workflow_ref: "identity.anchor.flow",
+    aliases: ["identity.anchor.flow", "identity.registry.anchor.flow"],
+    category: "identity",
+    title: "Identity Anchor Flow",
+    description: "Preview identity attestation, register the record, link it to identity state, and anchor the resulting proof.",
+    task_count: 4,
+    task_refs: [
+      "identity.attest.preview",
+      "registry.register",
+      "identity.registry.link",
+      "anchoring.submit"
+    ],
+    latency_class: "governed_async",
+    failure_posture: "governed_async",
+    pricing_basis: "sum"
+  },
+  {
+    workflow_ref: "registry.pack.anchor.flow",
+    aliases: ["registry.pack.anchor.flow", "registry.bundle.anchor.flow"],
+    category: "registry",
+    title: "Registry Pack Anchor Flow",
+    description: "Bundle a registry pack, preview anchoring posture, and submit the pack for anchoring.",
+    task_count: 3,
+    task_refs: ["registry.pack.bundle", "anchoring.pack.preview", "anchoring.submit"],
+    latency_class: "governed_async",
+    failure_posture: "governed_async",
+    pricing_basis: "sum"
   }
 ];
 
@@ -691,7 +925,10 @@ const catalog = {
     "runtime",
     "jobs",
     "credits",
+    "a2a",
+    "a2c",
     "policy",
+    "identity",
     "registry",
     "anchoring",
     "discovery",

package/index.js

@@ -30,11 +30,13 @@ const {
   summarizeIntegrationSubmissionBundleReview,
   summarizeIntegrationSubmissionBundleSetReview,
   summarizeIntegrationRegistrySnapshotReview,
-  summarizeIntegrationPromotionReadiness
+  summarizeIntegrationPromotionReadiness,
+  summarizeIntegrationPromotionWorkflow,
+  summarizeIntegrationPromotionWorkflowList
 } = require("./integrations/registry");
 
 const COMMERCE_SDK_NAME = "xytara";
-const COMMERCE_SDK_VERSION = "1.2.0";
+const COMMERCE_SDK_VERSION = "1.4.0";
 const COMMERCE_API_VERSION = "v1";
 
 function createClient(options) {
@@ -73,5 +75,7 @@ module.exports = {
   summarizeIntegrationSubmissionBundleSetReview,
   summarizeIntegrationRegistrySnapshotReview,
   summarizeIntegrationPromotionReadiness,
+  summarizeIntegrationPromotionWorkflow,
+  summarizeIntegrationPromotionWorkflowList,
   validateAdapterImplementation
 };