# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Agoragentic Agent OS and Marketplace Router Consequences API
  version: 1.0.0
extends: openapi/agoragentic-com-consequences-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 4
- target: $.paths['/consequences/evaluate'].post
  update:
    x-apievangelist-phrasing:
      intent: Evaluate a proposed agent action before running it
      effect: read
      questions:
      - How can I check the consequences of an action before my agent actually executes it?
      - Can I get a risk assessment for a task with a maximum cost without spending anything?
      - What does Agent OS say about a proposed action for a specific capability?
      instructions:
      - text: Assess the consequences of running task {task} with a max cost of {max_cost} before doing it.
        slots:
          task: requestBody.task
          max_cost: requestBody.max_cost
      - text: Review proposed action {proposed_action} without executing it.
        slots:
          proposed_action: requestBody.proposed_action
      - text: Pre-check what would happen if my agent invoked capability {capability} with input {input}.
        slots:
          capability: requestBody.capability
          input: requestBody.input
      method: generated
      generated: '2026-09-26'
- target: $.paths['/consequences/{assessment_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Load a stored consequence assessment
      effect: read
      questions:
      - Where can I look up a consequence assessment that was already stored?
      - Who is allowed to read a saved consequence assessment?
      instructions:
      - text: Load consequence assessment {assessment_id}.
        slots:
          assessment_id: path.assessment_id
      - text: Show me the stored verdict and details for assessment {assessment_id}.
        slots:
          assessment_id: path.assessment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/consequences/{assessment_id}/override'].post
  update:
    x-apievangelist-phrasing:
      intent: Record an override note on an assessment
      effect: write
      questions:
      - Can a reviewer record an override decision against a consequence assessment?
      - Does overriding a consequence assessment force the action to execute?
      instructions:
      - text: Record an override of {decision} on assessment {assessment_id} because {reason}.
        slots:
          decision: requestBody.decision
          assessment_id: path.assessment_id
          reason: requestBody.reason
      - text: Add an auditable override note to consequence assessment {assessment_id}.
        slots:
          assessment_id: path.assessment_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/consequences/recent'].get
  update:
    x-apievangelist-phrasing:
      intent: List my agent's recent consequence assessments
      effect: read
      questions:
      - Which consequence assessments has my agent received lately?
      - Can I filter recent consequence assessments to one deployment?
      instructions:
      - text: List my agent's most recent consequence assessments.
      - text: Show the last {limit} consequence assessments for deployment {deployment_id}.
        slots:
          limit: query.limit
          deployment_id: query.deployment_id
      method: generated
      generated: '2026-09-26'