{
  "schema_version": "1.0.0",
  "site": "SignalHarness.ai",
  "status": "production-active",
  "human_review_recommended": true,
  "live_payments_enabled": true,
  "feed": "troubleshooting / status codes",
  "public_discovery_free": true,
  "checkout_enabled": true,
  "products_purchasable": true,
  "routing_is_not_authorization": true,
  "human_page": "/troubleshooting/",
  "notice": "Shared vocabulary for the states an agent may meet while inspecting the production storefront. These are storefront-state codes, consistent with /agent/payment-options.json; they are not HTTP status codes.",
  "status_codes": [
    {
      "code": "direct_crypto_disabled",
      "meaning": "Polar human checkout is active. Direct-wallet crypto outside x402 remains inactive.",
      "agent_should": "Use a verified Polar control for human checkout, or a canonical x402 purchase endpoint returned by free Agent Pay discovery after confirming purchase authority.",
      "agent_must_not": "Invent a checkout URL, wallet address, payment requirement, or alternative payment rail.",
      "human_approval_required": false
    },
    {
      "code": "agent_pay_full_catalog_live",
      "meaning": "x402 Agent Pay is live for all 90 canonical one-time offerings plus prepaid monthly and annual SignalHarness Vault terms.",
      "agent_should": "Read /agent/payment-options.json, select an exact canonical offering, validate the network, asset, recipient, amount, and purchase endpoint, then follow the purchaser's wallet authority and budget policy.",
      "agent_must_not": "Reuse a payment requirement for another offering, manually transfer funds, or assume that a Vault renewal can charge a wallet automatically.",
      "human_approval_required": false
    },
    {
      "code": "product_unavailable",
      "meaning": "A specific offering has no active verified checkout association and must not be purchased until corrected.",
      "agent_should": "Contact support@signalharness.ai and use another verified offering if appropriate.",
      "agent_must_not": "Invent a checkout association or queue an autonomous purchase.",
      "human_approval_required": false
    },
    {
      "code": "missing_license",
      "meaning": "No license record is associated with a product the operator intends to use.",
      "agent_should": "Read /agent/licenses.json; flag that a license must be acquired before use.",
      "agent_must_not": "Assume a license or treat use as permitted without one.",
      "human_approval_required": true
    },
    {
      "code": "invalid_license_scope",
      "meaning": "The intended use exceeds the license (too many seats or agent instances, or an out-of-scope use).",
      "agent_should": "Report the exact rule breached and recommend a fitting tier; note it is a valid refund trigger.",
      "agent_must_not": "Proceed as if in-scope or silently widen the usage.",
      "human_approval_required": true
    },
    {
      "code": "unsupported_buyer_context",
      "meaning": "The buyer type, workflow, or environment matches a product's not-for warning.",
      "agent_should": "Exclude the product; explain the not-for match; suggest a better-fit candidate.",
      "agent_must_not": "Recommend against an explicit not-for warning.",
      "human_approval_required": false
    },
    {
      "code": "stale_catalog_metadata",
      "meaning": "A snapshot's catalog_version differs from the current catalog, or cached data disagrees with a fresh fetch.",
      "agent_should": "Re-fetch from /agent/index.json and compare catalog_version before trusting cached values.",
      "agent_must_not": "Act on stale prices, statuses, or flags.",
      "human_approval_required": false
    },
    {
      "code": "missing_receipt",
      "meaning": "Entitlement cannot be proven because no receipt or delivery confirmation exists.",
      "agent_should": "Treat access as unverified; route to support for a human to resolve.",
      "agent_must_not": "Grant or assume access, or fabricate a receipt.",
      "human_approval_required": true
    },
    {
      "code": "vault_access_unverified",
      "meaning": "A claimed Vault entitlement cannot be verified. Monthly and annual Vault subscriptions are available through Polar.",
      "agent_should": "Route the purchaser to Polar access or support@signalharness.ai.",
      "agent_must_not": "Grant access without a verified active entitlement.",
      "human_approval_required": false
    },
    {
      "code": "subscription_inactive",
      "meaning": "A purchaser's Vault subscription is not currently active, even though monthly and annual checkout is available through Polar.",
      "agent_should": "Route the purchaser to Polar subscription management or support@signalharness.ai.",
      "agent_must_not": "Grant or renew access without the purchaser's authorization and a verified Polar state.",
      "human_approval_required": false
    },
    {
      "code": "human_approval_required",
      "meaning": "The next step is a high-risk action (purchase, subscription, procurement, install, onboarding, refund) that a human/business owner must authorize with budget permission.",
      "agent_should": "Package the recommendation and hand it to the named approver.",
      "agent_must_not": "Proceed autonomously or treat routing as authorization.",
      "human_approval_required": true
    },
    {
      "code": "support_escalation_required",
      "meaning": "The issue cannot be resolved from the feeds alone and needs a human at support@signalharness.ai.",
      "agent_should": "Draft an escalation with the product id and a clear description for a human to send.",
      "agent_must_not": "Include credentials, keys, or payment data; support never asks for them.",
      "human_approval_required": true
    }
  ],
  "generated": "2026-07-09",
  "agent_pay_full_crypto_commerce": {
    "status": "live",
    "products_x402_enabled": 90,
    "products_x402_disabled": 0,
    "vault_x402_enabled": true,
    "vault_plan_id": "signalharness-vault",
    "vault_billing_model": "prepaid_renewable_terms",
    "automatic_wallet_debit": false,
    "human_step_inside_pre_authorized_transaction": false,
    "free_catalog_url": "https://signalharness-x402-seller-pilot.onrender.com/api/agent/catalog"
  }
}