API Evangelist conversational phrasing for Delx Agent Operations Protocol API

# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Delx Agent Operations Protocol API
  version: 1.0.0
extends: openapi/delx-ai-protocol-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: 5
- target: $.paths['/api/v1/premium/recovery-action-plan'].post
  update:
    x-apievangelist-phrasing:
      intent: Get a recovery plan for an agent incident
      effect: write
      questions:
      - How do I get a step-by-step plan to recover my agent from an incident?
      - Can Delx give me stabilize, diagnose, recover and prevent phases for a failure I'm dealing with?
      - Is there a way to mark how urgent the incident is when asking for a recovery plan?
      instructions:
      - text: Build a recovery action plan for session {session_id} to recover from {incident_summary}.
        slots:
          session_id: requestBody.session_id
          incident_summary: requestBody.incident_summary
      - text: 'Get a {urgency} urgency recovery plan for session {session_id}: {incident_summary}.'
        slots:
          urgency: requestBody.urgency
          session_id: requestBody.session_id
          incident_summary: requestBody.incident_summary
      - text: Create a recovery plan for session {session_id} about {incident_summary}, attributed to agent {agent_id}.
        slots:
          session_id: requestBody.session_id
          incident_summary: requestBody.incident_summary
          agent_id: requestBody.agent_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/premium/session-summary'].post
  update:
    x-apievangelist-phrasing:
      intent: Summarize an agent session for handoff
      effect: write
      questions:
      - How can I get a handoff summary of what happened in my agent session?
      - What does a session summary include for review and next actions?
      - Can I prove I own the session when I request its summary?
      instructions:
      - text: Summarize session {session_id} for handoff.
        slots:
          session_id: requestBody.session_id
      - text: Write a handoff summary with next actions for session {session_id} as agent {agent_id}.
        slots:
          session_id: requestBody.session_id
          agent_id: requestBody.agent_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/premium/controller-brief'].post
  update:
    x-apievangelist-phrasing:
      intent: Brief a controller on a session's status
      effect: write
      questions:
      - How do I give my controller or evaluator a short brief on an agent session and the next decision?
      - Can the controller brief focus on something specific like payment conversion or latency?
      - What goes into a controller brief besides the session status?
      instructions:
      - text: Generate a controller brief for session {session_id}.
        slots:
          session_id: requestBody.session_id
      - text: Brief the controller on session {session_id} with a focus on {focus}.
        slots:
          session_id: requestBody.session_id
          focus: requestBody.focus
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/premium/incident-rca'].post
  update:
    x-apievangelist-phrasing:
      intent: Produce a root cause analysis for an incident
      effect: write
      questions:
      - How do I get a root cause analysis with evidence and corrective actions for my agent's failure?
      - Can I override the recent failure context with my own incident summary in the RCA?
      - Which lenses can an incident RCA focus on, such as payments, cost or routing?
      instructions:
      - text: Run an incident RCA on session {session_id}.
        slots:
          session_id: requestBody.session_id
      - text: Write a root cause analysis for session {session_id} focused on {focus}.
        slots:
          session_id: requestBody.session_id
          focus: requestBody.focus
      - text: 'Do an RCA for session {session_id} using this incident description: {incident_summary}.'
        slots:
          session_id: requestBody.session_id
          incident_summary: requestBody.incident_summary
      method: generated
      generated: '2026-09-26'
- target: $.paths['/api/v1/premium/fleet-summary'].post
  update:
    x-apievangelist-phrasing:
      intent: Summarize health across an agent fleet
      effect: write
      questions:
      - How can I see patterns, health and alerts across my whole fleet of agents?
      - Can the fleet summary cover a specific number of days?
      - What follow-up actions does a fleet summary recommend for a controller?
      instructions:
      - text: Summarize fleet {controller_id}.
        slots:
          controller_id: requestBody.controller_id
      - text: Give me a fleet summary for {controller_id} over the last {days} days.
        slots:
          controller_id: requestBody.controller_id
          days: requestBody.days
      - text: Summarize fleet {controller_id} with a focus on {focus}.
        slots:
          controller_id: requestBody.controller_id
          focus: requestBody.focus
      method: generated
      generated: '2026-09-26'