RFC-032: Post-Hoc Evaluation Loop — 10. API Extension

AIGP Specification › RFC-032: Post-Hoc Evaluation Loop › 10. API Extension

← 9. Second-Order Cybernetics: Self-Learning Governance · Section index · 11. Schema →

10. API Extension

10.1 New Endpoints

/api/v1/anticipate:
  post:
    summary: Declare pre-execution expectations
    operationId: anticipate
    requestBody:
      required: true
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/AnticipateRequest"
    responses:
      "200":
        content:
          application/json:
            schema:
              type: object
              properties:
                status: { type: string, enum: [accepted, rejected] }
                anticipation_id: { type: string }
                sealed_at: { type: string, format: date-time }
                d_dna_ref: { type: string }
      "409":
        description: Anticipation already sealed (execution has started)

/api/v1/verify:
  post:
    summary: Submit post-hoc verification result
    operationId: verify
    requestBody:
      required: true
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/VerifyRequest"
    responses:
      "200":
        content:
          application/json:
            schema:
              type: object
              properties:
                status: { type: string }
                verification_id: { type: string }
                governance_action: { type: string }
                d_dna_ref: { type: string }

/api/v1/verify/{anticipation_id}:
  get:
    summary: Retrieve verification results for an anticipation
    operationId: getVerification
    parameters:
      - name: anticipation_id
        in: path
        required: true
        schema: { type: string }
    responses:
      "200":
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/VerifyResponse"
      "404":
        description: No verification exists for this anticipation

/api/v1/anticipate/{agent_id}/baseline:
  get:
    summary: Retrieve behavioral baseline for an agent
    operationId: getBaseline
    parameters:
      - name: agent_id
        in: path
        required: true
        schema: { type: string }
    responses:
      "200":
        content:
          application/json:
            schema:
              $ref: "#/components/schemas/BehavioralBaseline"
      "404":
        description: No baseline computed yet (insufficient verified executions)

---

---

← 9. Second-Order Cybernetics: Self-Learning Governance · Section index · 11. Schema →