openapi: 3.2.0
info:
  title: HumanMirror Flow API
  version: 1.0.0
  description: Verified 2-3 step missions with whole-transaction success-only billing.
servers:
- url: https://humanmirror.fr
tags:
- name: Flow
paths:
  /api/flow/quote/:
    post:
      summary: Create a free Flow contract quote
      responses:
        '200':
          description: Flow quote
      tags:
      - Flow
      operationId: postApiFlowQuote
      x-operation-id-source: derived
  /api/flow/run/:
    post:
      summary: Execute Flow; charge only if every step succeeds
      security:
      - BearerAuth: []
      responses:
        '200':
          description: Verified Flow success
        '400':
          description: Flow failed; reservation refunded
      tags:
      - Flow
      operationId: postApiFlowRun
      x-operation-id-source: derived
  /api/flow/mcp/:
    post:
      summary: HumanMirror Flow MCP server
      responses:
        '200':
          description: MCP JSON-RPC response
      tags:
      - Flow
      operationId: postApiFlowMcp
      x-operation-id-source: derived
  /api/flow/stats/:
    get:
      summary: Public aggregate Flow stats
      responses:
        '200':
          description: Flow stats
      tags:
      - Flow
      operationId: getApiFlowStats
      x-operation-id-source: derived
components:
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: hm_nexus_*