zero-paper-api.v1.yaml

openapi: 3.1.0
info:
  title: ZERO Paper API
  version: 0.1.2
  summary: Local paper runtime and operator API for ZERO.
  description: |
    ZERO Paper API is the public local runtime contract for paper-first,
    self-custodial onchain operations. It requires no exchange credentials by
    default. Live execution is local opt-in and is refused unless local custody,
    journal, risk, and emergency preflight checks pass.
  license:
    name: Apache-2.0
    identifier: Apache-2.0
servers:
  - url: http://127.0.0.1:8765
    description: Local paper runtime
tags:
  - name: runtime
  - name: operator
  - name: paper
  - name: audit
  - name: network
  - name: intelligence
  - name: live
  - name: market
paths:
  /:
    get:
      tags: [runtime]
      operationId: getRoot
      summary: Runtime version probe.
      responses:
        "200":
          description: Runtime identity and status.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RootResponse"
  /health:
    get:
      tags: [runtime]
      operationId: getHealth
      summary: Health, dependency, circuit breaker, and recovery state.
      responses:
        "200":
          description: Runtime health packet.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HealthResponse"
  /v2/status:
    get:
      tags: [operator]
      operationId: getV2Status
      summary: Operator status summary consumed by the CLI.
      responses:
        "200":
          description: Operator status packet.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/V2StatusResponse"
  /positions:
    get:
      tags: [operator]
      operationId: getPositions
      summary: Current paper positions.
      responses:
        "200":
          description: Position list.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PositionsResponse"
  /risk:
    get:
      tags: [operator]
      operationId: getRisk
      summary: Current risk state.
      responses:
        "200":
          description: Risk state.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RiskResponse"
  /brief:
    get:
      tags: [operator]
      operationId: getBrief
      summary: Compact operator brief.
      responses:
        "200":
          description: Brief packet.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/BriefResponse"
  /decision/stack:
    get:
      tags: [paper]
      operationId: getDecisionStack
      summary: Paper lens, layer, and modifier decision stack.
      parameters:
        - $ref: "#/components/parameters/CoinQuery"
      responses:
        "200":
          description: Decision stack packet.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/DecisionStackResponse"
        "400":
          $ref: "#/components/responses/BadRequest"
        "503":
          $ref: "#/components/responses/Unavailable"
  /regime:
    get:
      tags: [operator]
      operationId: getRegime
      summary: Paper regime readout.
      parameters:
        - $ref: "#/components/parameters/CoinQuery"
      responses:
        "200":
          description: Regime packet.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RegimeResponse"
  /evaluate/{coin}:
    get:
      tags: [paper]
      operationId: evaluateCoin
      summary: Evaluate a paper setup for one coin.
      parameters:
        - name: coin
          in: path
          required: true
          schema:
            type: string
            example: BTC
      responses:
        "200":
          description: Evaluation packet.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/EvaluateResponse"
        "400":
          $ref: "#/components/responses/BadRequest"
        "503":
          $ref: "#/components/responses/Unavailable"
  /pulse:
    get:
      tags: [operator]
      operationId: getPulse
      summary: Recent decision events.
      parameters:
        - $ref: "#/components/parameters/LimitQuery"
      responses:
        "200":
          description: Recent event packet.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/PulseResponse"
  /approaching:
    get:
      tags: [operator]
      operationId: getApproaching
      summary: Gates or limits the operator is approaching.
      responses:
        "200":
          description: Approaching packet.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ApproachingResponse"
  /rejections:
    get:
      tags: [paper]
      operationId: getRejections
      summary: Recent rejected paper decisions.
      parameters:
        - $ref: "#/components/parameters/CoinQuery"
        - $ref: "#/components/parameters/LimitQuery"
      responses:
        "200":
          description: Rejection list.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RejectionsResponse"
  /journal:
    get:
      tags: [audit]
      operationId: getJournal
      summary: Recent paper decision journal records.
      parameters:
        - $ref: "#/components/parameters/LimitQuery"
      responses:
        "200":
          description: Journal tail.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/JournalResponse"
  /memory:
    get:
      tags: [audit]
      operationId: getMemory
      summary: Public-safe local memory snapshot.
      parameters:
        - $ref: "#/components/parameters/LimitQuery"
        - name: format
          in: query
          required: false
          schema:
            type: string
            enum: [json, md]
      responses:
        "200":
          description: Redacted memory state.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/MemorySnapshotResponse"
  /genesis:
    get:
      tags: [audit]
      operationId: getGenesis
      summary: Plan-only genesis proposal classifications.
      responses:
        "200":
          description: Genesis proposal snapshot.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/GenesisSnapshotResponse"
  /evolve:
    get:
      tags: [audit]
      operationId: getEvolve
      summary: Paper-only evolve gate status.
      responses:
        "200":
          description: Evolve gate snapshot.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/EvolveSnapshotResponse"
  /research:
    get:
      tags: [audit]
      operationId: getResearch
      summary: Paper-only research command-chain report.
      responses:
        "200":
          description: Research command-chain snapshot.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ResearchSnapshotResponse"
  /runtime/parity:
    get:
      tags: [runtime]
      operationId: getRuntimeParity
      summary: Production-parity OODA report with disabled live shadow execution.
      responses:
        "200":
          description: Runtime production-parity packet.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/RuntimeParityResponse"
  /metrics:
    get:
      tags: [audit]
      operationId: getMetrics
      summary: Runtime counters and recovery metrics.
      responses:
        "200":
          description: Metrics packet.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/MetricsResponse"
  /immune:
    get:
      tags: [runtime]
      operationId: getImmune
      summary: Risk-blocking immune and circuit-breaker state.
      responses:
        "200":
          description: Immune breaker packet.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ImmuneResponse"
  /audit/export:
    get:
      tags: [audit]
      operationId: getAuditExport
      summary: Structured audit export for a paper session.
      parameters:
        - $ref: "#/components/parameters/LimitQuery"
      responses:
        "200":
          description: Audit export.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AuditExportResponse"
  /deployment/claim:
    get:
      tags: [network]
      operationId: getDeploymentClaim
      summary: Public-safe local deployment identity claim.
      responses:
        "200":
          description: Signature-ready deployment claim packet.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/DeploymentClaimResponse"
  /deployment/heartbeat:
    get:
      tags: [network]
      operationId: getDeploymentHeartbeat
      summary: Public-safe local deployment heartbeat and liveness packet.
      responses:
        "200":
          description: Signature-ready deployment heartbeat packet.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/DeploymentHeartbeatResponse"
  /network/profile:
    get:
      tags: [network]
      operationId: getNetworkProfile
      summary: Public-safe local ZERO Network profile packet.
      responses:
        "200":
          description: Public profile packet.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/NetworkProfileResponse"
  /network/leaderboard:
    get:
      tags: [network]
      operationId: getNetworkLeaderboard
      summary: Public-safe local leaderboard row.
      responses:
        "200":
          description: Local leaderboard packet.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/NetworkLeaderboardResponse"
  /network/publish:
    post:
      tags: [network]
      operationId: publishNetworkProfile
      summary: Append a redacted profile packet to a local proof log.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/NetworkPublishRequest"
      responses:
        "200":
          description: Publish result.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/LocalExportResponse"
        "400":
          $ref: "#/components/responses/BadRequest"
  /network/ingest:
    post:
      tags: [network]
      operationId: ingestNetworkProfiles
      summary: Validate redacted profile packets with hosted-style anti-gaming rules.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/NetworkIngestRequest"
      responses:
        "200":
          description: Ingestion decision packet.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/NetworkIngestionResponse"
        "400":
          $ref: "#/components/responses/BadRequest"
  /intelligence/snapshot:
    get:
      tags: [intelligence]
      operationId: getIntelligenceSnapshot
      summary: Delayed public ZERO Intelligence snapshot.
      responses:
        "200":
          description: Delayed aggregate intelligence packet.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/IntelligenceSnapshotResponse"
  /intelligence/catalog:
    get:
      tags: [intelligence]
      operationId: getIntelligenceCatalog
      summary: Public catalog for commercial ZERO Intelligence surfaces.
      responses:
        "200":
          description: Intelligence catalog.
          content:
            application/json:
            schema:
              $ref: "#/components/schemas/IntelligenceCatalogResponse"
  /intelligence/commercial:
    get:
      tags: [intelligence]
      operationId: getIntelligenceCommercial
      summary: Billing-ready commercial ZERO Intelligence API contract.
      responses:
        "200":
          description: Commercial API boundary, scopes, plans, usage events, and privacy contract.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/IntelligenceCommercialResponse"
  /intelligence/model-gateway:
    get:
      tags: [intelligence]
      operationId: getIntelligenceModelGateway
      summary: Public-safe model gateway provider and fail-closed routing status.
      responses:
        "200":
          description: Model gateway status.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ModelGatewayStatusResponse"
  /intelligence/model-gateway/health:
    get:
      tags: [intelligence]
      operationId: getIntelligenceModelGatewayHealth
      summary: Public-safe model gateway health probe.
      parameters:
        - name: network
          in: query
          required: false
          description: Run an explicit provider network probe when true.
          schema:
            type: boolean
            default: false
      responses:
        "200":
          description: Model gateway health packet.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ModelGatewayHealthResponse"
  /intelligence/model-gateway/audit:
    get:
      tags: [intelligence]
      operationId: getIntelligenceModelGatewayAudit
      summary: Public-safe model gateway audit bundle.
      responses:
        "200":
          description: Model gateway audit bundle.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ModelGatewayAuditResponse"
  /intelligence/export:
    post:
      tags: [intelligence]
      operationId: exportIntelligenceSnapshot
      summary: Append a delayed intelligence snapshot to a local export log.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/ConsentRequest"
      responses:
        "200":
          description: Export result.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/LocalExportResponse"
  /v1/intelligence/snapshots:
    get:
      tags: [intelligence]
      operationId: getHostedIntelligenceSnapshots
      summary: Hosted-compatible snapshot feed with public delayed access and paid realtime scope.
      parameters:
        - name: freshness
          in: query
          required: false
          schema:
            type: string
            enum: [delayed, realtime]
            default: delayed
      responses:
        "200":
          description: Hosted-compatible snapshot feed response.
          headers:
            x-zero-ratelimit-limit:
              schema: { type: string }
            x-zero-ratelimit-remaining:
              schema: { type: string }
            x-zero-ratelimit-reset:
              schema: { type: string }
            x-zero-ratelimit-policy:
              schema: { type: string }
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HostedIntelligenceResponse"
        "401":
          description: Missing or invalid token for paid freshness.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HostedIntelligenceErrorResponse"
        "403":
          description: Token does not grant the requested scope.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HostedIntelligenceErrorResponse"
  /v1/intelligence/history:
    get:
      tags: [intelligence]
      operationId: getHostedIntelligenceHistory
      summary: Hosted-compatible historical intelligence query.
      responses:
        "200":
          description: Hosted-compatible history response.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HostedIntelligenceResponse"
        "401":
          description: Missing or invalid token.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HostedIntelligenceErrorResponse"
        "403":
          description: Token does not grant the requested scope.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HostedIntelligenceErrorResponse"
  /v1/intelligence/cohorts:
    get:
      tags: [intelligence]
      operationId: getHostedIntelligenceCohorts
      summary: Hosted-compatible cohort analytics query.
      responses:
        "200":
          description: Hosted-compatible cohort response.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HostedIntelligenceResponse"
        "401":
          description: Missing or invalid token.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HostedIntelligenceErrorResponse"
        "403":
          description: Token does not grant the requested scope.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HostedIntelligenceErrorResponse"
  /v1/intelligence/benchmarks:
    get:
      tags: [intelligence]
      operationId: getHostedIntelligenceBenchmarks
      summary: Hosted-compatible benchmark analytics query.
      responses:
        "200":
          description: Hosted-compatible benchmark response.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HostedIntelligenceResponse"
        "401":
          description: Missing or invalid token.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HostedIntelligenceErrorResponse"
        "403":
          description: Token does not grant the requested scope.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HostedIntelligenceErrorResponse"
  /v1/intelligence/webhooks:
    post:
      tags: [intelligence]
      operationId: createHostedIntelligenceWebhook
      summary: Hosted-compatible webhook subscription and signature fixture.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/HostedIntelligenceWriteRequest"
      responses:
        "200":
          description: Hosted-compatible webhook subscription response.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HostedIntelligenceResponse"
        "401":
          description: Missing or invalid token.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HostedIntelligenceErrorResponse"
        "403":
          description: Token does not grant the requested scope.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HostedIntelligenceErrorResponse"
  /v1/intelligence/exports:
    post:
      tags: [intelligence]
      operationId: createHostedIntelligenceExport
      summary: Hosted-compatible bulk export job.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/HostedIntelligenceWriteRequest"
      responses:
        "200":
          description: Hosted-compatible export job response.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HostedIntelligenceResponse"
        "401":
          description: Missing or invalid token.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HostedIntelligenceErrorResponse"
        "403":
          description: Token does not grant the requested scope.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HostedIntelligenceErrorResponse"
  /hl/status:
    get:
      tags: [market]
      operationId: getHyperliquidStatus
      summary: Hyperliquid read-only market status.
      parameters:
        - name: symbol
          in: query
          required: false
          schema:
            type: array
            items:
              type: string
          style: form
          explode: true
      responses:
        "200":
          description: Disabled metadata or read-only Hyperliquid status.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HyperliquidStatusResponse"
  /hl/account:
    get:
      tags: [market]
      operationId: getHyperliquidAccount
      summary: Hyperliquid read-only account snapshot.
      responses:
        "200":
          description: Normalized read-only account truth.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HyperliquidAccountResponse"
        "400":
          $ref: "#/components/responses/BadRequest"
  /hl/reconcile:
    get:
      tags: [market]
      operationId: getHyperliquidReconciliation
      summary: Local runtime versus Hyperliquid account reconciliation.
      responses:
        "200":
          description: Reconciliation packet used by live risk gates.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/HyperliquidReconciliationResponse"
  /market/quote:
    get:
      tags: [market]
      operationId: getMarketQuote
      summary: Active quote source used by paper execution.
      parameters:
        - name: symbol
          in: query
          required: true
          schema:
            type: string
            example: BTC
      responses:
        "200":
          description: Quote packet.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/MarketQuoteResponse"
        "400":
          $ref: "#/components/responses/BadRequest"
        "503":
          $ref: "#/components/responses/Unavailable"
  /operator/state:
    get:
      tags: [operator]
      operationId: getOperatorState
      summary: Operator friction state consumed by the terminal.
      responses:
        "200":
          description: Operator state packet.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/OperatorStateResponse"
  /operator/context:
    get:
      tags: [operator]
      operationId: getOperatorContext
      summary: Current operator audit identity.
      parameters:
        - name: X-Zero-Operator-Id
          in: header
          required: false
          schema:
            type: string
        - name: X-Zero-Operator-Handle
          in: header
          required: false
          schema:
            type: string
        - name: X-Zero-Operator-Role
          in: header
          required: false
          schema:
            type: string
        - name: X-Zero-Operator-Scope
          in: header
          required: false
          schema:
            type: string
      responses:
        "200":
          description: Operator context packet.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/OperatorContextResponse"
  /operator/events:
    post:
      tags: [operator]
      operationId: postOperatorEvents
      summary: Submit local operator events.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: true
      responses:
        "200":
          description: Accepted event count and current operator snapshot.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/OperatorEventsResponse"
  /execute:
    post:
      tags: [paper, live]
      operationId: postExecute
      summary: Submit a paper order, or live order when X-Zero-Mode is live.
      parameters:
        - name: X-Zero-Mode
          in: header
          required: false
          schema:
            type: string
            enum: [paper, live]
            default: paper
        - name: X-Zero-Expose-Trace
          in: header
          required: false
          schema:
            type: string
            enum: ["true", "false"]
            default: "false"
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/ExecuteRequest"
      responses:
        "200":
          description: Paper fill/refusal or live submission/refusal.
          headers:
            X-Zero-Trace-Id:
              $ref: "#/components/headers/TraceId"
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/ExecuteResponse"
        "400":
          $ref: "#/components/responses/BadRequest"
        "503":
          $ref: "#/components/responses/Unavailable"
  /auto/toggle:
    post:
      tags: [operator]
      operationId: postAutoToggle
      summary: Toggle local simulated automation state.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              required: [enabled]
              properties:
                enabled:
                  type: boolean
              additionalProperties: false
      responses:
        "200":
          description: Toggle result.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/AutoToggleResponse"
  /live/preflight:
    get:
      tags: [live]
      operationId: getLivePreflight
      summary: Non-secret local live-readiness gate.
      responses:
        "200":
          description: Live preflight packet.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/LivePreflightResponse"
  /live/cockpit:
    get:
      tags: [live]
      operationId: getLiveCockpit
      summary: Consolidated read-only live operator cockpit packet.
      responses:
        "200":
          description: Live cockpit packet.
          content:
            application/json:
            schema:
              $ref: "#/components/schemas/LiveCockpitResponse"
  /live/canary-policy:
    get:
      tags: [live]
      operationId: getLiveCanaryPolicy
      summary: Read-only live canary policy lifecycle and next-step recommendation.
      responses:
        "200":
          description: Canary policy lifecycle packet.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/LiveCanaryPolicyResponse"
  /live/certification:
    get:
      tags: [live]
      operationId: getLiveCertification
      summary: Dry-run live execution certification harness.
      responses:
        "200":
          description: Certification drills and evidence requirements.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/LiveCertificationResponse"
  /live/receipts:
    get:
      tags: [live]
      operationId: getLiveReceipts
      summary: Public-safe local live execution receipt bundle.
      responses:
        "200":
          description: Execution receipts with hashed local tokens and venue acknowledgement.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/LiveExecutionReceiptsResponse"
  /live/evidence:
    get:
      tags: [live]
      operationId: getLiveEvidence
      summary: Public-safe signed live-readiness evidence packet.
      responses:
        "200":
          description: Hash-only canary evidence bundle.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/LiveEvidenceResponse"
  /live/heartbeat:
    post:
      tags: [live]
      operationId: postLiveHeartbeat
      summary: Refresh local live dead-man heartbeat.
      responses:
        "200":
          $ref: "#/components/responses/LiveControl"
  /live/pause:
    post:
      tags: [live]
      operationId: postLivePause
      summary: Pause local live entry control.
      responses:
        "200":
          $ref: "#/components/responses/LiveControl"
  /live/resume:
    post:
      tags: [live]
      operationId: postLiveResume
      summary: Resume local live entry control.
      responses:
        "200":
          $ref: "#/components/responses/LiveControl"
  /live/kill:
    post:
      tags: [live]
      operationId: postLiveKill
      summary: Engage local live kill switch and cancel open orders.
      responses:
        "200":
          $ref: "#/components/responses/LiveControl"
  /live/flatten:
    post:
      tags: [live]
      operationId: postLiveFlatten
      summary: Submit reduce-only flatten orders for local live positions.
      responses:
        "200":
          description: Flatten result.
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/LiveFlattenResponse"
components:
  parameters:
    CoinQuery:
      name: coin
      in: query
      required: false
      schema:
        type: string
        example: BTC
    LimitQuery:
      name: limit
      in: query
      required: false
      schema:
        type: integer
        minimum: 1
        default: 50
  headers:
    TraceId:
      description: Per-request trace ID generated by the local runtime.
      schema:
        type: string
        pattern: "^trace-[a-f0-9]{16}$"
  responses:
    BadRequest:
      description: Invalid request.
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/ErrorResponse"
    Unavailable:
      description: Runtime dependency unavailable.
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/ErrorResponse"
    LiveControl:
      description: Live control result.
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/LiveControlResponse"
  schemas:
    RootResponse:
      type: object
      required: [name, version, status, ts]
      properties:
        name:
          type: string
          const: zero-paper-engine
        version:
          type: string
        status:
          type: string
          const: ok
        ts:
          type: string
          format: date-time
      additionalProperties: false
    ErrorResponse:
      type: object
      required: [error]
      properties:
        error:
          type: string
        path:
          type: string
      additionalProperties: false
    HealthResponse:
      type: object
      required: [status, components, dependencies, circuit_breakers, risk, recovery, immune, ws_connections]
      properties:
        status:
          type: string
          const: ok
        components:
          type: object
          additionalProperties: true
        dependencies:
          type: object
          additionalProperties: true
        circuit_breakers:
          type: object
          additionalProperties: true
        risk:
          type: object
          additionalProperties: true
        recovery:
          $ref: "#/components/schemas/Recovery"
        immune:
          $ref: "#/components/schemas/ImmuneResponse"
        ws_connections:
          type: integer
          minimum: 0
      additionalProperties: false
    V2StatusResponse:
      type: object
      required: [confidence, market, positions, today, approaching, blind_spots, alert, recovery, ts]
      properties:
        confidence:
          type: object
          required: [score, level]
          properties:
            score:
              type: integer
            level:
              type: string
          additionalProperties: false
        market:
          type: object
          required: [regime, health, signal, prediction, fear_greed, coins_tradeable]
          additionalProperties: true
        positions:
          type: object
          required: [open, unrealized_pnl, equity]
          additionalProperties: false
        today:
          type: object
          required: [trades, wins, pnl, streak, sizing_mult]
          additionalProperties: false
        approaching:
          type: array
          items:
            type: object
            additionalProperties: true
        blind_spots:
          type: array
          items:
            type: object
            additionalProperties: true
        alert:
          type: [string, "null"]
        recovery:
          $ref: "#/components/schemas/Recovery"
        ts:
          type: string
          format: date-time
      additionalProperties: false
    Recovery:
      type: object
      required:
        - status
        - source
        - durable
        - journal_path
        - decisions_recovered
        - fills_recovered
        - rejections_recovered
        - positions_recovered
        - last_decision_at
        - current_decisions
        - current_fills
        - current_rejections
        - current_positions
      properties:
        status:
          type: string
        source:
          type: string
        durable:
          type: boolean
        journal_path:
          type: [string, "null"]
        decisions_recovered:
          type: integer
        fills_recovered:
          type: integer
        rejections_recovered:
          type: integer
        positions_recovered:
          type: integer
        last_decision_at:
          type: [string, "null"]
          format: date-time
        current_decisions:
          type: integer
        current_fills:
          type: integer
        current_rejections:
          type: integer
        current_positions:
          type: integer
      additionalProperties: false
    Position:
      type: object
      required: [symbol, side, size, entry, mark, unrealized_pnl, unrealized_r, age_s]
      properties:
        symbol:
          type: string
        side:
          type: string
          enum: [long, short]
        size:
          type: number
        entry:
          type: number
        mark:
          type: number
        unrealized_pnl:
          type: number
        unrealized_r:
          type: number
        age_s:
          type: number
      additionalProperties: false
    PositionsResponse:
      type: object
      required: [positions, count, account_value, total_unrealized_pnl]
      properties:
        positions:
          type: array
          items:
            $ref: "#/components/schemas/Position"
        count:
          type: integer
        account_value:
          type: number
        total_unrealized_pnl:
          type: number
      additionalProperties: false
    RiskResponse:
      type: object
      required:
        - account_value
        - updated_at
        - daily_pnl_usd
        - daily_loss_usd
        - per_runner
        - global_halt
        - daily_loss_since
        - halted
        - halt_reason
        - halt_until
        - stop_failure_halt
        - open_count
        - drawdown_pct
        - peak_equity
        - last_drawdown_alert_pct
        - peak_equity_30d
        - capital_floor_hit
      additionalProperties: true
    BriefResponse:
      type: object
      required: [timestamp, fear_greed, open_positions, positions, recent_signals, approaching, last_cycle]
      additionalProperties: true
    RegimeResponse:
      type: object
      required: [coin, regime, confidence, source]
      additionalProperties: true
    EvaluateResponse:
      type: object
      required: [coin, price, price_source, consensus, conviction, direction, regime, layers, data_fresh, timestamp]
      additionalProperties: true
    DecisionStackResponse:
      type: object
      required:
        - schema_version
        - mode
        - paper_only
        - coin
        - generated_at
        - price
        - lenses
        - layers
        - modifiers
        - decision
        - privacy
      properties:
        schema_version:
          type: string
          const: zero.decision.stack.v1
        mode:
          type: string
          const: paper
        paper_only:
          type: boolean
          const: true
        coin:
          type: string
        generated_at:
          type: string
          format: date-time
        price:
          type: object
          additionalProperties: true
        lenses:
          type: array
          items:
            type: object
            required: [lens, family, status, signal, confidence, weight, evidence, public_safe]
            additionalProperties: true
        layers:
          type: array
          items:
            type: object
            required: [layer, kind, passed, value, detail, blocks_entry]
            additionalProperties: true
        modifiers:
          type: array
          items:
            type: object
            required: [modifier, effect, direction, value, reason, bounded]
            additionalProperties: true
        decision:
          type: object
          required: [verdict, direction, consensus, conviction, allowed_to_execute_live, reason]
          additionalProperties: true
        privacy:
          type: object
          additionalProperties: true
      additionalProperties: false
    PulseResponse:
      type: object
      required: [events]
      properties:
        events:
          type: array
          items:
            type: object
            required: [kind, coin, message, severity, ts]
            additionalProperties: true
      additionalProperties: false
    ApproachingResponse:
      type: object
      required: [approaching]
      properties:
        approaching:
          type: array
          items:
            type: object
            additionalProperties: true
      additionalProperties: false
    Rejection:
      type: object
      required: [coin, direction, stage, reason, ts]
      properties:
        coin:
          type: string
        direction:
          type: string
          enum: [buy, sell]
        stage:
          type: string
        reason:
          type: string
        ts:
          type: string
          format: date-time
        trace_id:
          type: string
      additionalProperties: false
    RejectionsResponse:
      type: object
      required: [rejections]
      properties:
        rejections:
          type: array
          items:
            $ref: "#/components/schemas/Rejection"
      additionalProperties: false
    JournalResponse:
      type: object
      required: [decisions, count]
      properties:
        decisions:
          type: array
          items:
            type: object
            additionalProperties: true
        count:
          type: integer
      additionalProperties: false
    MemorySnapshotResponse:
      type: object
      required: [schema_version, generated_at, source, stats, entries, knowledge]
      properties:
        schema_version:
          type: string
          const: zero.memory.snapshot.v1
        generated_at:
          type: string
          format: date-time
        source:
          type: string
        stats:
          type: object
          required: [schema_version, generated_at, total_entries, active_entries, expired_entries, by_kind, privacy]
          additionalProperties: true
        entries:
          type: array
          items:
            type: object
            required: [schema_version, id, kind, scope, subject, summary, evidence_hash, source, created_at, expires_at, confidence, tags, metadata]
            additionalProperties: true
        knowledge:
          nullable: true
          type: string
      additionalProperties: false
    GenesisSnapshotResponse:
      type: object
      required: [schema_version, generated_at, source, mode, applies_code_changes, guardian_policy, stats, decisions, privacy]
      properties:
        schema_version:
          type: string
          const: zero.genesis.snapshot.v1
        generated_at:
          type: string
          format: date-time
        source:
          type: string
        mode:
          type: string
          const: plan-only
        applies_code_changes:
          type: boolean
          const: false
        guardian_policy:
          type: object
          additionalProperties: true
        stats:
          type: object
          required: [schema_version, generated_at, total_decisions, by_decision, protected_classes, human_review_required]
          additionalProperties: true
        decisions:
          type: array
          items:
            type: object
            required: [schema_version, id, proposal_id, decision, reason, decided_at, required_human_review, min_sample_size, policy_version, proposal]
            additionalProperties: true
        privacy:
          type: object
          required: [contains_live_prices, contains_wallet_material, contains_exchange_order_ids, contains_private_keys]
          additionalProperties: true
      additionalProperties: false
    EvolveSnapshotResponse:
      type: object
      required: [schema_version, generated_at, source, mode, applies_to_checkout, pushes_to_remote, input_decisions, selected_proposal_id, accepted_candidates, build, red_team, paper_canary, calibration, promotion, promotion_plan, rollback_plan, promotion_verification, policy]
      properties:
        schema_version:
          type: string
          const: zero.evolve.snapshot.v1
        generated_at:
          type: string
          format: date-time
        source:
          type: string
        mode:
          type: string
          const: paper-only
        applies_to_checkout:
          type: boolean
          const: false
        pushes_to_remote:
          type: boolean
          const: false
        input_decisions:
          type: integer
        selected_proposal_id:
          type: string
          nullable: true
        accepted_candidates:
          type: integer
        build:
          type: object
          nullable: true
          additionalProperties: true
        red_team:
          type: object
          nullable: true
          additionalProperties: true
        paper_canary:
          type: object
          required: [schema_version, generated_at, mode, scenario, decisions, fills, rejections, open_positions, baseline]
          additionalProperties: true
        calibration:
          type: object
          required: [schema_version, generated_at, mode, passed, drift, gate]
          additionalProperties: true
        promotion:
          type: object
          required: [schema_version, generated_at, mode, promotable_after_human_review, promoted, pushes_to_remote, requires_human_approval, gates, reason]
          additionalProperties: true
        promotion_plan:
          type: object
          required: [schema_version, generated_at, mode, plan_only, eligible_for_local_apply, applies_to_checkout, pushes_to_remote, places_orders, requires_human_approval, required_approval_phrase, gates, safety]
          additionalProperties: true
        rollback_plan:
          type: object
          required: [schema_version, generated_at, mode, plan_only, rollback_ready, applies_to_checkout, pushes_to_remote, restores, rollback_hash, instructions]
          additionalProperties: true
        promotion_verification:
          type: object
          required: [schema_version, generated_at, ok, checks, failures]
          additionalProperties: true
        policy:
          type: object
          additionalProperties: true
      additionalProperties: false
    ResearchSnapshotResponse:
      type: object
      required: [schema_version, generated_at, source, mode, paper_only, available, commands, applies_code_changes, pushes_to_remote, claims_live_pnl, summary, reports, privacy, report_hash]
      properties:
        schema_version:
          type: string
          const: zero.research.snapshot.v1
        generated_at:
          type: string
          format: date-time
        source:
          type: string
        mode:
          type: string
          const: paper-only
        paper_only:
          type: boolean
          const: true
        available:
          type: boolean
        commands:
          type: array
          items:
            type: string
        applies_code_changes:
          type: boolean
          const: false
        pushes_to_remote:
          type: boolean
          const: false
        claims_live_pnl:
          type: boolean
          const: false
        summary:
          type: object
          required: [candidate_count, sample_size, minimum_sample_met, convergence_status, proposal_count]
          additionalProperties: true
        reports:
          type: object
          required: [hunt, edge, convergence, thesis, score, meta, sharpen]
          additionalProperties: true
        privacy:
          type: object
          required: [contains_live_prices, contains_wallet_material, contains_venue_order_material, contains_secret_material, contains_raw_live_pnl]
          additionalProperties: true
        report_hash:
          type: string
          pattern: "^sha256:"
      additionalProperties: false
    MetricsResponse:
      type: object
      required: [schema_version, generated_at, mode, runtime, api, engine, immune, recovery, memory, genesis, evolve, research]
      properties:
        schema_version:
          type: string
          const: zero.metrics.v1
        generated_at:
          type: string
          format: date-time
        mode:
          type: string
          const: paper
        runtime:
          type: object
          additionalProperties: true
        api:
          type: object
          additionalProperties: true
        engine:
          type: object
          additionalProperties: true
        recovery:
          $ref: "#/components/schemas/Recovery"
        immune:
          $ref: "#/components/schemas/ImmuneResponse"
        memory:
          type: object
          additionalProperties: true
        genesis:
          type: object
          additionalProperties: true
        evolve:
          type: object
          additionalProperties: true
        research:
          type: object
          additionalProperties: true
      additionalProperties: false
    RuntimeParityResponse:
      type: object
      required: [schema_version, generated_at, mode, paper_only, places_live_orders, scenario, cycles_requested, cycles_run, phase_order, paper, live_shadow, runtime_bus, feedback, certification, checks, ok, claim_boundary, parity_hash]
      properties:
        schema_version:
          type: string
          const: zero.runtime.production_parity.v1
        generated_at:
          type: string
          format: date-time
        source:
          type: string
        available:
          type: boolean
        mode:
          type: string
          const: production-parity
        paper_only:
          type: boolean
          const: true
        places_live_orders:
          type: boolean
          const: false
        scenario:
          type: string
        cycles_requested:
          type: integer
          minimum: 1
        cycles_run:
          type: integer
          minimum: 1
        phase_order:
          type: array
          items:
            type: string
        paper:
          type: object
          required: [decisions, fills, rejections, open_positions, recent_cycles]
          additionalProperties: true
        live_shadow:
          type: object
          required: [mode, accepted, refused, adapter_orders_placed, records]
          additionalProperties: true
        runtime_bus:
          type: object
          required: [integrity, snapshot]
          additionalProperties: true
        feedback:
          type: object
          required: [schema_version, sample_size, cycles, fills, rejections, rejection_rate, execution_quality, items]
          additionalProperties: true
        certification:
          type: object
          required: [schema_version, mode, passed, live_start_certified, summary]
          additionalProperties: true
        checks:
          type: object
          additionalProperties:
            type: boolean
        ok:
          type: boolean
        claim_boundary:
          type: object
          required: [production_ooda_parity, live_trading_claimed, operator_owned_canary_required_for_live_claim, protected_live_code_evolution_allowed, remote_push_allowed]
          additionalProperties: true
        parity_hash:
          type: string
          pattern: "^sha256:"
      additionalProperties: false
    ImmuneResponse:
      type: object
      required: [schema_version, generated_at, mode, risk_increasing_allowed, summary, breakers]
      properties:
        schema_version:
          type: string
          const: zero.immune.v1
        generated_at:
          type: string
          format: date-time
        mode:
          type: string
        risk_increasing_allowed:
          type: boolean
        summary:
          type: object
          additionalProperties: true
        breakers:
          type: array
          items:
            type: object
            required: [name, status, blocks_risk, severity, reason, evidence]
            additionalProperties: true
      additionalProperties: false
    AuditExportResponse:
      type: object
      required: [schema_version, exported_at, mode, source, limit, operator_context, summary, retention, metrics, recovery, memory, deployment_claim, deployment_heartbeat, operator_actions, decisions]
      additionalProperties: true
    DeploymentClaimResponse:
      type: object
      required: [schema_version, generated_at, deployment, operator, runtime, evidence, privacy, claim_hash, signature]
      properties:
        schema_version:
          const: zero.deployment.claim.v1
        generated_at:
          type: string
          format: date-time
        deployment:
          type: object
          required: [deployment_id, kind, environment, owner, version]
          properties:
            deployment_id:
              type: string
            kind:
              type: string
            environment:
              type: string
            owner:
              type: string
            version:
              type: string
          additionalProperties: false
        operator:
          type: object
          required: [handle, role, scope, source]
          properties:
            handle:
              type: string
            role:
              type: string
            scope:
              type: string
            source:
              type: string
          additionalProperties: true
        runtime:
          type: object
          additionalProperties: true
        evidence:
          type: object
          additionalProperties: true
        privacy:
          type: object
          additionalProperties: true
        claim_hash:
          type: string
          pattern: "^sha256:"
        signature:
          type: object
          required: [status, algorithm, public_key, signature, signer, signed_claim_hash]
          properties:
            status:
              type: string
              enum: [unsigned_local, signed_external]
            algorithm:
              type: [string, "null"]
            public_key:
              type: [string, "null"]
            signature:
              type: [string, "null"]
            signer:
              type: string
            signed_claim_hash:
              type: string
              pattern: "^sha256:"
          additionalProperties: true
      additionalProperties: true
    DeploymentHeartbeatResponse:
      type: object
      required: [schema_version, generated_at, deployment, deployment_claim_hash, operator, runtime, liveness, privacy, heartbeat_hash, signature]
      properties:
        schema_version:
          const: zero.deployment.heartbeat.v1
        generated_at:
          type: string
          format: date-time
        deployment:
          type: object
          required: [deployment_id, kind, environment, owner, version]
          properties:
            deployment_id:
              type: string
            kind:
              type: string
            environment:
              type: string
            owner:
              type: string
            version:
              type: string
          additionalProperties: false
        deployment_claim_hash:
          type: string
          pattern: "^sha256:"
        operator:
          type: object
          required: [handle, role, scope, source]
          additionalProperties: true
        runtime:
          type: object
          additionalProperties: true
        liveness:
          type: object
          required: [status, live_executor_configured, dead_man_expired]
          properties:
            status:
              type: string
              enum: [paper_only, fresh, expired]
            live_executor_configured:
              type: boolean
            dead_man_expired:
              type: boolean
            last_live_heartbeat_at:
              type: [number, "null"]
            dead_man_timeout_s:
              type: [number, "null"]
            next_required_within_s:
              type: [number, "null"]
          additionalProperties: true
        privacy:
          type: object
          additionalProperties: true
        heartbeat_hash:
          type: string
          pattern: "^sha256:"
        signature:
          type: object
          required: [status, algorithm, public_key, signature, signer, signed_heartbeat_hash]
          properties:
            status:
              type: string
              enum: [unsigned_local, signed_external]
            algorithm:
              type: [string, "null"]
            public_key:
              type: [string, "null"]
            signature:
              type: [string, "null"]
            signer:
              type: string
            signed_heartbeat_hash:
              type: string
              pattern: "^sha256:"
          additionalProperties: true
      additionalProperties: true
    ExecuteRequest:
      type: object
      required: [coin, side, size]
      properties:
        coin:
          type: string
          example: BTC
        side:
          type: string
          enum: [buy, sell]
        size:
          type: number
          exclusiveMinimum: 0
        idempotency_key:
          type: string
      additionalProperties: false
    ExecuteResponse:
      type: object
      required: [accepted, simulated, fill_id, coin, side, size, reason]
      properties:
        accepted:
          type: boolean
        simulated:
          type: boolean
        fill_id:
          type: [string, "null"]
        coin:
          type: string
        side:
          type: string
          enum: [buy, sell]
        size:
          type: number
        reason:
          type: string
        trace_id:
          type: string
        idempotency_key:
          type: string
        status:
          type: string
      additionalProperties: false
    NetworkProfileResponse:
      type: object
      required: [schema_version, generated_at, mode, profile, metrics, verification, deployment_claim, deployment_heartbeat, leaderboard_row, privacy]
      additionalProperties: true
    NetworkLeaderboardResponse:
      type: object
      required: [schema_version, generated_at, mode, rows, privacy]
      additionalProperties: true
    NetworkPublishRequest:
      type: object
      required: [consent]
      properties:
        consent:
          type: boolean
        handle:
          type: string
        display_name:
          type: string
      additionalProperties: false
    NetworkIngestRequest:
      type: object
      properties:
        profile:
          type: object
          additionalProperties: true
        profiles:
          type: array
          items:
            type: object
            additionalProperties: true
      additionalProperties: false
    NetworkIngestionResponse:
      type: object
      required: [schema_version, generated_at, summary, records, leaderboard, rules, privacy]
      properties:
        schema_version:
          const: zero.network.ingestion.v1
        generated_at:
          type: string
          format: date-time
        summary:
          type: object
          required: [submitted, accepted, refused, duplicates, leaderboard_rows]
          additionalProperties: true
        records:
          type: array
          items:
            type: object
            required: [index, decision, handle, proof_hash, trust_tier, anti_gaming_score, leaderboard_eligible, risk_flags, refusal_reasons]
            additionalProperties: true
        leaderboard:
          $ref: "#/components/schemas/NetworkLeaderboardResponse"
        rules:
          type: object
          required: [purpose, accepted_inputs, refusal_policy, ranking_source, financial_advice]
          additionalProperties: true
        privacy:
          type: object
          required: [default, publication]
          additionalProperties: true
      additionalProperties: true
    ConsentRequest:
      type: object
      required: [consent]
      properties:
        consent:
          type: boolean
      additionalProperties: false
    LocalExportResponse:
      type: object
      required: [ok]
      properties:
        ok:
          type: boolean
        path:
          type: string
        reason:
          type: string
      additionalProperties: true
    IntelligenceSnapshotResponse:
      type: object
      required: [schema_version, generated_at, access, source, signals, aggregates, commercial_unlocks, privacy]
      additionalProperties: true
    IntelligenceCatalogResponse:
      type: object
      required: [schema_version, generated_at, positioning, public, commercial, hosted_api_contract, data_rules]
      additionalProperties: true
    IntelligenceCommercialResponse:
      type: object
      required: [schema_version, generated_at, positioning, boundary, auth, plans, scopes, datasets, endpoints, rate_limits, usage_events, webhooks, exports, reliability, privacy]
      properties:
        schema_version:
          const: zero.intelligence.commercial.v1
        generated_at:
          type: string
          format: date-time
        boundary:
          type: object
          required: [open, commercial, not_sold]
          additionalProperties: true
        auth:
          type: object
          required: [scheme, credential, runtime_required, local_runtime_enforcement]
          additionalProperties: true
        plans:
          type: array
          items:
            type: object
            required: [id, name, billing, scopes, freshness, included_usage_events]
            additionalProperties: true
        scopes:
          type: array
          items:
            type: object
            required: [name, description, commercial]
            additionalProperties: true
        datasets:
          type: array
          items:
            type: object
            required: [name, source, public_delay_s, raw_private_data]
            additionalProperties: true
        endpoints:
          type: array
          items:
            type: object
            required: [path, required_scope, usage_event]
            additionalProperties: true
        rate_limits:
          type: object
          required: [headers, policy]
          additionalProperties: true
        usage_events:
          type: array
          items:
            type: object
            required: [name, metered, billable, required_fields]
            additionalProperties: true
        privacy:
          type: object
          required: [exchange_credentials_collected, custody_transferred, raw_journals_required, raw_model_prompts_included, operator_secrets_included, source_packets]
          additionalProperties: true
      additionalProperties: true
    HostedIntelligenceResponse:
      type: object
      required: [schema_version, generated_at, account, usage, rate_limit]
      properties:
        schema_version:
          type: string
          pattern: "^zero\\.intelligence\\.hosted\\."
        generated_at:
          type: string
          format: date-time
        account:
          type: object
          required: [id, plan, authenticated, scopes]
          additionalProperties: true
        usage:
          type: object
          required: [name, account_id, scope, timestamp, metered, billable]
          additionalProperties: true
        rate_limit:
          type: object
          required: [limit, remaining, reset, policy]
          additionalProperties: true
      additionalProperties: true
    HostedIntelligenceWriteRequest:
      type: object
      properties:
        url:
          type: string
        event_types:
          type: array
          items:
            type: string
        format:
          type: string
          enum: [jsonl, csv]
        dataset:
          type: string
      additionalProperties: true
    HostedIntelligenceErrorResponse:
      type: object
      required: [schema_version, error, rate_limit]
      properties:
        schema_version:
          const: zero.intelligence.hosted_error.v1
        error:
          type: string
        required_scope:
          type: string
        rate_limit:
          type: object
          required: [limit, remaining, reset, policy]
          additionalProperties: true
      additionalProperties: true
    ModelGatewayStatusResponse:
      type: object
      required: [schema_version, generated_at, mode, default_provider, routing, providers, usage, privacy]
      properties:
        schema_version:
          const: zero.model_gateway.status.v1
        generated_at:
          type: string
          format: date-time
        mode:
          type: string
          enum: [fail_closed, local_ready, external_ready]
        default_provider:
          type: string
        routing:
          type: object
          additionalProperties:
            type: [string, "null"]
        providers:
          type: array
          items:
            type: object
            required: [provider, model, configured, local, live_network, network_allowed, capabilities, required_env]
            additionalProperties: true
        usage:
          type: object
          required: [events, total_estimated_cost_usd, recent]
          additionalProperties: true
        privacy:
          type: object
          required: [prompts_included, raw_model_outputs_included, contains_api_keys, contains_exchange_credentials, contains_wallet_material]
          additionalProperties: true
      additionalProperties: true
    ModelGatewayHealthResponse:
      type: object
      required: [schema_version, generated_at, status, selected_provider, network_probe, checks, safety]
      properties:
        schema_version:
          const: zero.model_gateway.health.v1
        generated_at:
          type: string
          format: date-time
        status:
          type: string
          enum: [failed_closed, degraded, ready, healthy]
        selected_provider:
          type: [string, "null"]
        network_probe:
          type: object
          required: [requested, performed, status, provider, attempts, reason]
          additionalProperties: true
        checks:
          type: array
          items:
            type: object
            required: [provider, status, selected, configured, network_allowed, capabilities, retry_policy, reasons]
            additionalProperties: true
        safety:
          type: object
          required: [fail_closed, advisory_only, network_probe_requires_explicit_query, prompts_included, raw_model_outputs_included]
          additionalProperties: true
      additionalProperties: true
    ModelGatewayAuditResponse:
      type: object
      required: [schema_version, generated_at, status, health, usage, controls, evidence_requirements, privacy]
      properties:
        schema_version:
          const: zero.model_gateway.audit.v1
        generated_at:
          type: string
          format: date-time
        status:
          type: object
          required: [mode, default_provider, selected_provider]
          additionalProperties: true
        health:
          $ref: "#/components/schemas/ModelGatewayHealthResponse"
        usage:
          type: object
          required: [events, total_estimated_cost_usd, cost_policy]
          additionalProperties: true
        controls:
          type: object
          required: [fail_closed_default, advisory_only, structured_output_validation, bounded_retry_policy, network_disabled_by_default, operator_configured_pricing_only]
          additionalProperties: true
        evidence_requirements:
          type: array
          items:
            type: string
        privacy:
          type: object
          required: [prompts_included, raw_model_outputs_included, contains_api_keys, contains_exchange_credentials, contains_wallet_material, provider_request_ids_included, headers_included]
          additionalProperties: true
      additionalProperties: true
    HyperliquidStatusResponse:
      type: object
      required: [enabled, exchange]
      additionalProperties: true
    HyperliquidAccountResponse:
      type: object
      required: [schema_version, exchange, user, as_of, positions, open_orders, counts]
      additionalProperties: true
    HyperliquidReconciliationResponse:
      type: object
      required: [schema_version, exchange, status, risk_increasing_allowed, reason, as_of, local, exchange_state, drifts]
      additionalProperties: true
    MarketQuoteResponse:
      type: object
      required: [symbol, price, source, as_of, mode, live]
      additionalProperties: false
    OperatorStateResponse:
      type: object
      required: [label, friction, vector, as_of, version]
      additionalProperties: true
    OperatorContextResponse:
      type: object
      required: [schema_version, operator_id, handle, role, scope, source]
      properties:
        schema_version:
          const: zero.operator_context.v1
        operator_id:
          type: string
        handle:
          type: string
        role:
          type: string
        scope:
          type: string
        source:
          type: string
      additionalProperties: true
    OperatorEventsResponse:
      type: object
      required: [accepted, snapshot, operator_context]
      additionalProperties: true
    AutoToggleResponse:
      type: object
      required: [state, simulated, reason]
      additionalProperties: true
    LivePreflightResponse:
      type: object
      required: [schema_version, generated_at, exchange, mode, ready, live_mode, controls_ready, checks]
      additionalProperties: true
    LiveCockpitResponse:
      type: object
      required:
        - schema_version
        - generated_at
        - mode
        - live_mode
        - ready
        - controls_ready
        - risk_increasing_allowed
        - next_action
        - preflight
        - immune
        - reconciliation
        - certification
        - heartbeat
        - live_records
        - operator_actions
        - operator_context
      properties:
        schema_version:
          const: zero.live_cockpit.v1
        ready:
          type: boolean
        risk_increasing_allowed:
          type: boolean
        next_action:
          type: string
        operator_context:
          $ref: "#/components/schemas/OperatorContextResponse"
      additionalProperties: true
    LiveCanaryPolicyResponse:
      type: object
      required:
        - schema_version
        - policy_version
        - generated_at
        - mode
        - summary
        - policy
        - phases
        - recommendation
        - privacy
      properties:
        schema_version:
          const: zero.live_canary_policy.v1
        policy_version:
          type: string
        generated_at:
          type: string
          format: date-time
        summary:
          type: object
          required:
            - ready_for_canary
            - policy_armed
            - live_order_attempted
            - live_order_accepted
            - publishable_canary_evidence
            - qualified
            - next_step
          additionalProperties: true
        phases:
          type: array
          items:
            type: object
            required: [name, status, detail, evidence]
            additionalProperties: true
        recommendation:
          type: object
          required: [action, risk_direction, reason]
          additionalProperties: true
      additionalProperties: true
    LiveCertificationResponse:
      type: object
      required: [schema_version, mode, passed, live_start_certified, summary, drills, evidence_requirements]
      additionalProperties: true
    LiveEvidenceResponse:
      type: object
      required:
        - schema_version
        - generated_at
        - mode
        - live_mode
        - ready
        - risk_increasing_allowed
        - operator_context
        - summary
        - artifacts
        - canary_rule
        - privacy
        - evidence_hash
        - signature
      properties:
        schema_version:
          const: zero.live_evidence.v1
        generated_at:
          type: string
          format: date-time
        ready:
          type: boolean
        risk_increasing_allowed:
          type: boolean
        artifacts:
          type: array
          items:
            type: object
            required: [name, schema_version, status, hash, included]
            additionalProperties: true
        evidence_hash:
          type: string
          pattern: "^sha256:"
        signature:
          type: object
          required: [status, algorithm, signature, signer, signed_evidence_hash, key_material_included]
          additionalProperties: true
      additionalProperties: true
    LiveExecutionReceiptsResponse:
      type: object
      required:
        - schema_version
        - generated_at
        - mode
        - operator_context
        - summary
        - receipts
        - privacy
        - receipts_hash
      properties:
        schema_version:
          const: zero.live_execution_receipts.v1
        generated_at:
          type: string
          format: date-time
        mode:
          type: string
        receipts:
          type: array
          items:
            type: object
            required:
              - schema_version
              - accepted
              - status
              - reason
              - request
              - request_hash
              - receipt_hash
            additionalProperties: true
        receipts_hash:
          type: string
          pattern: "^sha256:"
      additionalProperties: true
    LiveControlResponse:
      type: object
      required: [ok]
      properties:
        ok:
          type: boolean
        reason:
          type: string
      additionalProperties: true
    LiveFlattenResponse:
      type: object
      required: [ok, orders]
      properties:
        ok:
          type: boolean
        reason:
          type: string
        orders:
          type: array
          items:
            $ref: "#/components/schemas/ExecuteResponse"
      additionalProperties: true