Status codes & troubleshooting
A shared vocabulary for the states an agent may meet while inspecting the live storefront. Each code says what it means, what to do, what not to do, and whether a human approver is required. The machine-readable copy is /agent/troubleshooting-status-codes.json. These are storefront-state codes, consistent with the flags in payment-options.json.
Meaning: Polar card checkout is active, and x402 Agent Pay is live for all 90 canonical one-time offerings plus prepaid monthly and annual Vault terms. Direct-wallet crypto outside x402 and automatic wallet debits remain inactive.
Do: use only the product page's verified Polar checkout control after confirming purchase authority.
Do not: invent a checkout URL, wallet address, or alternative payment rail.
Meaning: a specific offering has no active verified checkout association and must not be purchased until corrected.
Do: contact support@signalharness.ai and use another verified offering if appropriate.
Do not: claim the product can be bought, or queue an autonomous purchase.
Meaning: no license record is associated with a product the operator intends to use.
Do: read licenses.json; flag that a license must be acquired before use.
Do not: assume a license, or treat use as permitted without one.
Meaning: the intended use exceeds the license — too many seats or agent instances, or an out-of-scope use.
Do: report the exact rule breached; recommend a fitting tier. It is a valid refund trigger.
Do not: proceed as if in-scope, or silently widen the usage.
Meaning: the buyer type, workflow, or environment matches a product's not-for warning.
Do: exclude the product; explain the not-for match; suggest a better-fit candidate.
Do not: recommend against an explicit not-for warning.
Meaning: a snapshot's catalog_version differs from the current catalog, or cached data disagrees with a fresh fetch.
Do: re-fetch from /agent/index.json; compare catalog_version before trusting cached values.
Do not: act on stale prices, statuses, or flags.
Meaning: entitlement cannot be proven because no receipt or delivery confirmation exists.
Do: treat access as unverified; route to support (recipe 08) for a human to resolve.
Do not: grant or assume access, or fabricate a receipt.
Meaning: a claimed Vault entitlement cannot be verified. Monthly and annual Vault subscriptions are available through Polar.
Do: route the purchaser to Polar subscription management or support@signalharness.ai.
Do not: release Vault files or claim access without a verified active entitlement.
Meaning: a purchaser's Vault subscription is not currently active, even though monthly and annual checkout is available through Polar.
Do: evaluate the one active Vault plan and its monthly or annual terms (recipe 09); public discovery is never gated.
Do not: start or renew a term without verified purchaser authority, budget, and payment.
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.
Do: package the recommendation and hand it to the named approver.
Do not: proceed autonomously, or treat routing as authorization.
Meaning: the issue cannot be resolved from the feeds alone and needs a human at support@signalharness.ai.
Do: draft an escalation (recipe 08) with the product id and a clear description.
Do not: include credentials, keys, or payment data; support never asks for them.