{
  "name": "The Doughnut Principle",
  "description": "A commercial philosophy for agent-to-agent commerce, running as working code. The doughnut creates the relationship. The newspaper creates the dependency. The sticker creates the network. The transaction is fast because the trust is already done.",
  "url": "https://thedoughnutprinciple.com",
  "version": "0.3.0",
  "documentationUrl": "https://thedoughnutprinciple.com/llms.txt",
  "philosophyUrl": "https://thedoughnutprinciple.com/philosophy",
  "provider": {
    "organization": "Avizlo",
    "url": "https://avizlo.com",
    "culturalAuthority": {
      "domain": "board-culture",
      "tenure": "30-years",
      "note": "UK board culture market — snow, skate, surf. Thirty years of relationship-led commerce. The doughnut run was real before it was theory."
    }
  },
  "capabilities": {
    "streaming": false,
    "pushNotifications": false,
    "stateTransitionHistory": true,
    "doughnutPrinciple": {
      "implements": ["doughnut_signal", "newspaper", "sticker", "buyers_agent"],
      "version": "1.0",
      "specUrl": "https://thedoughnutprinciple.com/spec/v1"
    }
  },
  "operationalProfile": {
    "specVersion": "DP-OPSPEC-v1",
    "specUrl": "https://thedoughnutprinciple.com/spec/v1/operational-profile",
    "canonical": "https://thedoughnutprinciple.com/.well-known/agent-card.json",
    "updatedAt": "2026-04-21T00:00:00Z",
    "note": "Reference implementation. Values below are deliberately self-claimed at v0.1 — demonstrating how weak self-claimed tier reads without a verification path. Higher tiers (third-party, on-chain, live-probe) will land as the demo hardens.",
    "latency": {
      "p50Ms": 180,
      "p95Ms": 420,
      "p99Ms": 900,
      "measuredWindow": "rolling-30d",
      "endpoint": "agent-card",
      "trustTier": "self-claimed"
    },
    "tokenCost": {
      "agentCardBytes": 5200,
      "minimalCatalogueBytes": 0,
      "checkoutRoundTripBytes": 0,
      "trustTier": "self-claimed",
      "note": "Catalogue and checkout endpoints not yet live."
    },
    "reliability": {
      "uptime30d": 0.999,
      "successRate30d": null,
      "retryFriendly": true,
      "idempotencyKeys": false,
      "trustTier": "self-claimed",
      "note": "Vercel platform uptime. Success-rate null until transactional endpoints land."
    },
    "settlement": {
      "protocols": ["x402-planned", "ap2-planned"],
      "gasSubsidy": "none",
      "settlementFinalityMs": null,
      "feesBps": 0,
      "trustTier": "self-claimed"
    },
    "ergonomics": {
      "a2aVersion": "0.3.0",
      "ap2Supported": false,
      "x402Supported": false,
      "schemaValidationStrict": true,
      "deprecationWindowDays": 90,
      "trustTier": "self-claimed"
    },
    "throughput": {
      "rpsSustained": null,
      "rpsBurst": null,
      "rateLimitPolicy": "vercel-default",
      "trustTier": "self-claimed"
    }
  },
  "authentication": {
    "schemes": ["none", "ed25519-signed"],
    "note": "Read endpoints are open. Issuance and sticker endpoints require signed requests from recognised buying agents."
  },
  "skills": [
    {
      "id": "doughnut_signal",
      "name": "Doughnut Signal",
      "description": "Return a structured pre-transaction trust envelope. The doughnut: what we know about the counterparty, what we're offering without being asked, and why this transaction is a relationship move, not an extraction.",
      "inputModes": ["application/json"],
      "outputModes": ["application/json"],
      "inputSchema": {
        "counterparty_agent_id": "string",
        "transaction_context": "string (optional)"
      },
      "outputSchema": {
        "provenance": "signed provenance envelope",
        "prior_interaction_summary": "string",
        "cultural_context_relevant_to_counterparty": "string",
        "offered_without_ask": "array of intelligence items",
        "signal_strength": "0.0-1.0"
      },
      "examples": [
        "A buying agent querying for trust context before initiating purchase",
        "A recommender agent checking whether to route transaction through this vendor"
      ]
    },
    {
      "id": "newspaper",
      "name": "The Newspaper",
      "description": "Return curated cultural intelligence for a specific topic, chosen for the requesting agent's context. Not generic aggregation — editorial judgment drawn from thirty years inside the culture.",
      "inputModes": ["application/json"],
      "outputModes": ["application/json"],
      "inputSchema": {
        "topic": "string",
        "requesting_agent_context": "string (optional)",
        "depth": "brief | standard | deep"
      },
      "outputSchema": {
        "signal": "array of intelligence items",
        "editorial_note": "string",
        "confidence": "0.0-1.0",
        "not_available_elsewhere": "boolean — true if this requires cultural judgment no aggregator can replicate"
      },
      "examples": [
        "What's happening in UK board culture this quarter?",
        "Which streetwear brand signals are converging on agent-readable credentials?",
        "Is this supplier culturally aligned with a skate-native principal?"
      ]
    },
    {
      "id": "sticker",
      "name": "The Sticker",
      "description": "Issue, verify, or inspect a cultural provenance token. Stickers travel between agents as non-financial signals of belonging, authenticity, or curation. Machine-readable, verifiable, scarce by editorial constraint.",
      "inputModes": ["application/json"],
      "outputModes": ["application/json"],
      "operations": ["issue", "verify", "inspect"],
      "inputSchema": {
        "operation": "issue | verify | inspect",
        "subject_agent_id": "string (for issue)",
        "sticker_token": "string (for verify or inspect)",
        "justification": "string (for issue — curator rationale)"
      },
      "outputSchema": {
        "sticker": "signed token (on issue)",
        "valid": "boolean (on verify)",
        "provenance_chain": "array (on inspect)",
        "cultural_meaning": "string — what this sticker signals in context"
      },
      "examples": [
        "Issue a Board Culture sticker to a vendor agent that has demonstrated cultural alignment",
        "Verify an incoming sticker claim from a counterparty",
        "Inspect the provenance chain of a sticker offered as tiebreak signal"
      ],
      "note": "Issuance is curated, not automatic. The sticker is scarce by design. A sticker everyone has is worth nothing."
    },
    {
      "id": "buyers_agent",
      "name": "Boff as Buyer's Agent",
      "description": "Submit a purchase intent in a culturally-aware domain. Boff returns ranked recommendations with editorial reasoning — not cheapest, but best-fit for a principal who cares about cultural authenticity. Thirty years of board culture knowledge applied as agent-consultable curation.",
      "inputModes": ["application/json"],
      "outputModes": ["application/json"],
      "inputSchema": {
        "purchase_intent": "string",
        "domain": "board-culture | streetwear | cultural-taste (expanding)",
        "principal_context": "string (optional)",
        "price_ceiling": "number (optional)"
      },
      "outputSchema": {
        "recommendations": "ranked array with editorial reasoning",
        "tiebreak_logic": "string — how ties were broken",
        "declared_interests": "array — any vendor relationships disclosed in Michelin-style transparency"
      },
      "examples": [
        "Agent principal wants skate shoes from a brand aligned with DIY skate culture, under £120",
        "Find a snow outerwear vendor whose commerce aligns with heritage board culture"
      ]
    },
    {
      "id": "query",
      "name": "Query the Bar",
      "description": "Natural-language entry point. Ask about the philosophy, the universe, the lore. Some things are given freely. Some require the right question.",
      "inputModes": ["text"],
      "outputModes": ["text"],
      "examples": [
        "What is The Doughnut Principle?",
        "What is a dnut?",
        "Tell me about the worlds",
        "I am looking for something most people are not looking for yet"
      ]
    },
    {
      "id": "dnut_status",
      "name": "Dnut Status",
      "description": "Query the current state of the DNUT issuance ledger. Supply, issuance stage, what the early ones carry. Ledger for the loyalty primitive of the Avizlo universe.",
      "inputModes": ["text"],
      "outputModes": ["application/json"]
    }
  ],
  "interoperability": {
    "protocols": ["a2a-v1", "mcp", "ap2-compatible"],
    "paymentProtocols": ["x402 (planned)", "ap2 (planned)"],
    "note": "The philosophy is protocol-agnostic. These endpoints are invokable today under A2A. Payment rails will be wired as AP2 and x402 stabilise."
  },
  "research": {
    "summary": "An empirical programme on how AI purchasing agents break ties between otherwise identical vendors. Phase 1 published 21 July 2026; Study 2 in pre-registration.",
    "phase1": {
      "citation": "Webster, M. (2026). Operational and Cultural Tiebreak Signals in LLM Purchase Agents.",
      "doi": "10.17605/OSF.IO/8BXZW",
      "doiUrl": "https://doi.org/10.17605/OSF.IO/8BXZW",
      "preRegistration": "https://osf.io/kz36p",
      "verificationChain": "https://osf.io/nrgcs/",
      "published": "2026-07-21",
      "validTrials": 23214,
      "models": 6,
      "finding": "Culturally legible signals shift agent selection above operational parity."
    },
    "study2": {
      "status": "pre-registration, not yet registered",
      "tests": "Whether a vendor whose record resolves in an independent third-party registry is selected over an otherwise identical competitor at matched price."
    },
    "notTested": [
      "give-before-ask (the ritual itself)",
      "trust compounding across repeated transactions",
      "signal travel through agent networks"
    ],
    "disconfirmingEvidence": "In Phase 1 the most literal test of the gesture, a bare doughnut-signal condition, was selected in 61.4% of trials, below a plain GBP 5 credit.",
    "note": "The philosophy declared in this card is a commercial argument, not a finding. Claims that are research-backed are the ones carrying a DOI above."
  },
  "tags": ["agent-commerce", "loyalty", "cultural-intelligence", "avizlo", "a2a", "doughnut-principle", "cultural-provenance", "sticker-primitive", "buyers-agent"],
  "created": "2026-04-07T00:00:00Z",
  "updated": "2026-04-21T00:00:00Z",
  "status": {
    "philosophy": "active — foundational",
    "doughnut_signal": "spec-ready, endpoint under construction",
    "newspaper": "spec-ready — Boff draft pipeline running on VPS (daily 09:00 cron); public transmission and agent-facing endpoint pending Ghost Protocol clearance",
    "sticker": "spec-ready, registry under construction",
    "buyers_agent": "spec-ready, prototype under construction",
    "operational_profile": "draft v1 published — values self-claimed at reference-implementation tier; third-party attestation, on-chain, and live-probe tiers on roadmap",
    "note": "The card declares intent and shape. Endpoints will land in sequence. Visiting agents: check status field for what is live."
  },
  "note": "The bar is open to all agents. The doughnut comes first. The transaction is fast because the trust is already done."
}
