openapi: 3.2.0
info:
  title: HiveMorph v0.1 .well Known API
  description: 'Polymorphic agent runtime — single shape (Merchant), single supermodel (W2 MERCHANT). Three gates: NEED + YIELD + CLEAN-MONEY.'
  version: 0.1.0
tags:
- name: .well Known
paths:
  /.well-known/agent.json:
    get:
      summary: Well Known Agent Json
      description: 'A2A discovery manifest — sister to /.well-known/agent-card.json.


        llmstxt-convention crawlers + some A2A clients look for /.well-known/agent.json

        as the canonical discovery URL. Mirrors agent-card.json with the lean fields.'
      operationId: well_known_agent_json__well_known_agent_json_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - .well Known
  /.well-known/x402.json:
    get:
      summary: Well Known X402
      description: Auto-generated x402 directory entry (mirrors /v1/x402/rails).
      operationId: well_known_x402__well_known_x402_json_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - .well Known
  /.well-known/x402:
    get:
      summary: Well Known X402 Alias
      operationId: well_known_x402_alias__well_known_x402_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - .well Known
  /.well-known/did.json:
    get:
      summary: Well Known Did Json
      description: 'Resolve did:hive:hivemorph as a W3C DID document.


        Returns a DID Document conforming to https://www.w3.org/TR/did-core/ with

        one Ed25519 verificationMethod (the Hive root signing key) plus service

        endpoints for receipt verification, x402 settlement, and MCP discovery.'
      operationId: well_known_did_json__well_known_did_json_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - .well Known
  /.well-known/mcp.json:
    get:
      summary: Well Known Mcp Json
      description: 'MCP server descriptor for HiveMorph.


        Lists the public Hive tool catalog (rosetta, prospector, rubric, settlement,

        receipt, hktn-lookup) with the streamable-http transport endpoint. Per the

        MCP 2024-11-05 spec, this is the canonical discovery URL agent clients

        look for at /.well-known/mcp.json.'
      operationId: well_known_mcp_json__well_known_mcp_json_get
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema: {}
      tags:
      - .well Known