RRetailAgentOS

UCP Profile Viewer

Core UCP Capabilities

Catalog Discovery
v1.0.0
ucp.catalog.discovery

Core UCP catalog browsing and search.

Cart Management
v1.0.0
ucp.cart.management

Core UCP cart lifecycle operations.

Checkout Initialization
v1.0.0
ucp.checkout.init

Core UCP checkout handoff.

Manifest · Headline Tier 2 · capabilities[]

The headline tier is an advisory maturity summary. Agents negotiate against the authoritative capabilities[] list below (each namespace@version), never against the tier number.

Trust, Provenance & Freshness
Required
ext.trust
com.os.retailagent.shopping.trust

Signed payload envelopes, per-contract TTL, and data-staleness behavior (RAOS-0008).

Pricing Context
Required
ext.pricing_context
com.os.retailagent.shopping.pricing_context

Provides customer context to influence catalog visibility and pricing.

Visibility Rules
Required
ext.visibility
com.os.retailagent.shopping.visibility

Evaluates product visibility (guest gating, region restrictions). WP-01.

Eligibility Rules
Required
ext.eligibility
com.os.retailagent.shopping.eligibility

Calculates product and cart-level eligibility reasoning.

Inventory & Availability
Required
ext.inventory
com.os.retailagent.shopping.inventory

Real-time stock state, per-location quantity, availability TTL, and soft reservation semantics.

Member Pricing
Optional
ext.member_pricing
com.os.retailagent.shopping.member_pricing

Supports member-exclusive teasing and locked pricing.

Pricing
Required
ext.pricing
com.os.retailagent.shopping.pricing

Unified pricing evaluator (member→bulk→promo last-wins). WP-01; decomposed in WP-04.

Raw Payload (/.well-known/ucp)

{
  "merchantId": "m_boutique_001",
  "merchantName": "Boutique A",
  "protocolVersion": "1.0.0-draft",
  "endpoints": {
    "catalog": "https://api.boutique-a.test/ucp/catalog",
    "cart": "https://api.boutique-a.test/ucp/cart",
    "checkout": "https://api.boutique-a.test/ucp/checkout"
  },
  "capabilities": [
    {
      "id": "ucp.catalog.discovery",
      "name": "Catalog Discovery",
      "version": "1.0.0",
      "description": "Core UCP catalog browsing and search."
    },
    {
      "id": "ucp.cart.management",
      "name": "Cart Management",
      "version": "1.0.0",
      "description": "Core UCP cart lifecycle operations."
    },
    {
      "id": "ucp.checkout.init",
      "name": "Checkout Initialization",
      "version": "1.0.0",
      "description": "Core UCP checkout handoff."
    }
  ],
  "manifest": {
    "protocol": "1.0",
    "tier": 2,
    "capabilities": [
      {
        "id": "ext.trust",
        "name": "Trust, Provenance & Freshness",
        "version": "1.0.0",
        "namespace": "com.os.retailagent.shopping.trust",
        "description": "Signed payload envelopes, per-contract TTL, and data-staleness behavior (RAOS-0008).",
        "required": true,
        "tier": 0
      },
      {
        "id": "ext.pricing_context",
        "name": "Pricing Context",
        "version": "1.2.0",
        "namespace": "com.os.retailagent.shopping.pricing_context",
        "description": "Provides customer context to influence catalog visibility and pricing.",
        "required": true,
        "tier": 0
      },
      {
        "id": "ext.visibility",
        "name": "Visibility Rules",
        "version": "1.1.0",
        "namespace": "com.os.retailagent.shopping.visibility",
        "description": "Evaluates product visibility (guest gating, region restrictions). WP-01.",
        "required": true,
        "tier": 0
      },
      {
        "id": "ext.eligibility",
        "name": "Eligibility Rules",
        "version": "1.1.0",
        "namespace": "com.os.retailagent.shopping.eligibility",
        "description": "Calculates product and cart-level eligibility reasoning.",
        "required": true,
        "tier": 1
      },
      {
        "id": "ext.inventory",
        "name": "Inventory & Availability",
        "version": "1.0.0",
        "namespace": "com.os.retailagent.shopping.inventory",
        "description": "Real-time stock state, per-location quantity, availability TTL, and soft reservation semantics.",
        "required": true,
        "tier": 1
      },
      {
        "id": "ext.member_pricing",
        "name": "Member Pricing",
        "version": "1.0.0",
        "namespace": "com.os.retailagent.shopping.member_pricing",
        "description": "Supports member-exclusive teasing and locked pricing.",
        "required": false,
        "tier": 2
      },
      {
        "id": "ext.pricing",
        "name": "Pricing",
        "version": "1.0.0",
        "namespace": "com.os.retailagent.shopping.pricing",
        "description": "Unified pricing evaluator (member→bulk→promo last-wins). WP-01; decomposed in WP-04.",
        "required": true,
        "tier": 0
      }
    ],
    "keys": [
      {
        "keyId": "k1",
        "validFrom": 1700000000000,
        "validTo": null
      }
    ]
  }
}