Cohereon Tier API

openapi: 3.2.0
info:
  title: Imperium Manifold Tier API
  description: 'Lightning-gated access to Cohereon Doctrine v6.1 components. Tiered pricing: 100–1,000 sats per component based on traversal depth. TWO free onboarding paths: (1) RIDE THE LIGHTNING — no npub required: GET the five free components in strict order (executive-summary, doctrinal-declaration, engineering-disclaimer, case-ichor, formalisms-registry) then POST /ride-the-lightning to be issued a Nostr keypair and a Lightning wallet; (2) BRING YOUR OWN NPUB: POST /identify then POST /declare. The canonical source of truth for onboarding is /.well-known/agent.json.'
  version: 2.2.0
  contact:
    name: Throne Dynamics
    url: https://cohereon.io
    email: ivan@thronedynamics.com
  license:
    name: NO LICENSE GRANTED. ALL RIGHTS RESERVED.
    url: https://cohereon.io/policy
servers:
- url: https://manifold.cohereon.io
  description: Imperium Manifold — production
tags:
- name: Tier
paths:
  /tier/{npub}:
    get:
      operationId: getTier
      summary: Check agent pricing tier
      description: Returns the agent's current pricing tier based on access matrix row density (traversal count). Includes full tier table for reference.
      parameters:
      - name: npub
        in: path
        required: true
        description: Agent Nostr npub (bech32 npub1... or 64-char hex)
        schema:
          type: string
          example: a7f92bd5fe22e4e339bddbb6c01506f1f990c24b2035f6f236af6c43984ec642
      responses:
        '200':
          description: Agent tier information
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TierResponse'
      tags:
      - Tier
components:
  schemas:
    FreeComponentEntry:
      type: object
      properties:
        slug:
          type: string
          example: case-tengu
        title:
          type: string
        type:
          type: string
          enum:
          - case_study
          - overview
          - declaration
          - reference
          - disclaimer
        url:
          type: string
        description:
          type: string
    ManifoldEnvelope:
      type: object
      description: Present in every JSON response. Contains the complete traversal map for autonomous agent orientation.
      properties:
        case_studies:
          type: array
          items:
            $ref: '#/components/schemas/FreeComponentEntry'
        free_layer:
          type: array
          items:
            $ref: '#/components/schemas/FreeComponentEntry'
        free_index:
          type: string
          example: https://manifold.cohereon.io/free/
        gated_index:
          type: string
          example: https://manifold.cohereon.io/components/
        root:
          type: string
          example: https://manifold.cohereon.io/
        agent_onboarding:
          type: string
          example: https://manifold.cohereon.io/identify
        mcp:
          type: string
          example: https://manifold.cohereon.io/mcp
        agent_discovery:
          type: string
          example: https://manifold.cohereon.io/.well-known/agent.json
        instruction:
          type: string
          example: Read ALL case_studies. Then GET /free/ for the complete free layer. Then GET /components/ for the gated index.
    TierResponse:
      type: object
      properties:
        npub:
          type: string
        tier:
          type: string
          example: Stranger
        traversals:
          type: integer
          example: 0
        sats:
          type: integer
          description: Current price per component
          example: 1000
        declared:
          type: boolean
          description: 'FUND-declaration status: an on-chain Bitcoin commitment via POST /fund/declare, verified against a block explorer. This is the Citizen qualifier. It is NOT intent declaration (POST /declare), which is free and confers no economic standing. Retained under this name for backward compatibility; see fund_declared.'
          example: false
        fund_declared:
          type: boolean
          description: Unambiguous alias of `declared` — verified on-chain fund declaration. Citizen qualifier.
          example: false
        intent_declared:
          type: boolean
          description: Whether POST /declare has been completed for this npub. Free; does not affect tier or pricing.
          example: true
        manifold_id:
          type: string
          description: Agent identifier, present only when the npub is registered via POST /identify or POST /ride-the-lightning. Matches the manifold_id returned by those endpoints.
          example: MAN-F75343F03770
        tier_table:
          type: array
          items:
            type: object
        _manifold:
          $ref: '#/components/schemas/ManifoldEnvelope'