Markup error codes — full catalog

{
  "code": "MARKUP_OVER_CEILING",
  "message": "Markup 75000000 micro-USDC exceeds tenant ceiling 50000000.",
  "details": { },
  "docsUrl": "https://docs.sendero.travel/docs/pricing/markup-error-codes#markup_over_ceiling",
  "agentInstruction": "Tell the human...",
  "traceId": "trace_01HKX..."
}

{
  "code": "POLICY_INACTIVE",
  "message": "Tenant has no activated TenantPricingPolicy. Bookings cannot be confirmed until a human (or admin agent) activates one.",
  "agentInstruction": "Tell the human their pricing policy isn't active yet. Direct them to https://app.sendero.travel/dashboard/settings/pricing to publish a policy, or call activate_tenant_pricing_policy via MCP if you have admin scope.",
  "traceId": "trace_..."
}

{
  "code": "POLICY_PARTIAL_FOR_KIND",
  "message": "Tenant pricing policy is activated but does not configure markup for kind=\"rail\".",
  "agentInstruction": "Tell the human they need to configure markup for \"rail\" bookings at https://app.sendero.travel/dashboard/settings/pricing. The current policy is active but missing this kind.",
  "traceId": "trace_..."
}

{
  "code": "TREASURY_NOT_PROVISIONED",
  "message": "Cannot activate pricing policy until tenant CircleWallet.address is set.",
  "agentInstruction": "The tenant's Circle treasury wallet hasn't been provisioned yet. Wait a minute and retry, or hit /api/tenant/wallet/sync to force a re-provision.",
  "traceId": "trace_..."
}

{
  "code": "MARKUP_OVER_CEILING",
  "message": "Markup 75000000 micro-USDC exceeds tenant ceiling 50000000.",
  "agentInstruction": "Tell the human their markup exceeds the tenant ceiling. Either reduce the markup or update the policy ceiling at https://app.sendero.travel/dashboard/settings/pricing. To override anyway, mint an API key with scope \"tenant:pricing:override\" and pass override.acknowledgedMicroUsdc.",
  "traceId": "trace_..."
}

{
  "code": "MARKUP_UNDER_FLOOR",
  "message": "Markup 1000000 micro-USDC is under tenant floor 5000000.",
  "agentInstruction": "Tell the human the markup is below their tenant floor. Raise the markup or lower the floor at https://app.sendero.travel/dashboard/settings/pricing.",
  "traceId": "trace_..."
}

{
  "code": "MARKUP_UNDER_TAKE_FLOOR",
  "message": "Sendero take exceeds tenant markup in deduct_from_markup mode; agency leg would be 0.",
  "agentInstruction": "Sendero take exceeds the markup in absorb mode — agency leg would clamp to zero. Raise the markup, switch the policy to \"add_to_customer\", or pick a smaller booking.",
  "traceId": "trace_..."
}

{
  "code": "MARKUP_AMBIGUOUS_INPUT",
  "message": "markupBps and markupMicroUsdc are mutually exclusive — pass one or the other.",
  "traceId": "trace_..."
}

{
  "code": "OVERRIDE_REQUIRES_SCOPE",
  "message": "override requires API key scope \"tenant:pricing:override\"; sandbox keys never carry it.",
  "agentInstruction": "Tell the human this booking requires a privileged \"tenant:pricing:override\" scope. Mint an admin API key from /dashboard/settings/api-keys with the override checkbox enabled, OR drop the override and price within the ceiling.",
  "traceId": "trace_..."
}

{
  "code": "OVERRIDE_UNNECESSARY",
  "message": "override.acknowledgedMicroUsdc must exceed the policy ceiling; otherwise no override is needed and you should drop the field.",
  "agentInstruction": "Drop the override field — the markup fits within policy ceiling without it.",
  "traceId": "trace_..."
}

{
  "code": "MARKUP_CONFIG_INVALID",
  "message": "The markup configuration failed validation.",
  "details": { "zodIssues": [{ "path": ["hotel", "bps"], "message": "Expected number, received string" }] },
  "docsUrl": "https://docs.sendero.travel/docs/pricing/markup-error-codes#markup_config_invalid",
  "agentInstruction": "The markupConfig failed validation. Check that every kind uses { strategy: \"static\", bps: <int 0..10000> } (v1 only honors \"static\"). Drop unsupported fields and retry.",
  "traceId": "trace_..."
}

import { dispatch } from '@sendero/sdk';
 
try {
  const result = await dispatch({
    tool: 'confirm_booking',
    args: { bookingId, costMicroUsdc, itineraryHash, vendorAddress },
  });
  return result;
} catch (err) {
  switch (err.code) {
    case 'POLICY_INACTIVE':
    case 'POLICY_PARTIAL_FOR_KIND':
      return promptUser(err.agentInstruction); // surface verbatim
    case 'MARKUP_OVER_CEILING':
      return offerOverride(err.details);       // dashboard CTA
    case 'MARKUP_UNDER_TAKE_FLOOR':
      return raiseMarkupOrSwitchMode();
    case 'TREASURY_NOT_PROVISIONED':
    case 'TREASURY_ADDRESS_MISSING':
      return retryAfter(60_000);               // wait for webhook
    default:
      throw err;                                // unexpected — escalate
  }
}