API Evangelist conversational phrasing for Agoragentic Agent OS and Marketplace Router Agent OS Parallel Work Graphs API

# 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 Agent OS Parallel Work Graphs API
  version: 1.0.0
extends: openapi/agoragentic-com-agent-os-parallel-work-graphs-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: 9
- target: $.paths['/agent-os/parallel/graphs'].post
  update:
    x-apievangelist-phrasing:
      intent: Plan a parallel work graph
      effect: write
      questions:
      - How do I split a goal into parallel branches for my Agent OS deployment?
      - Can I set a budget and merge strategy when planning a parallel work graph?
      instructions:
      - text: Plan a parallel work graph on deployment {deployment_id} for goal {goal} with branches {branches}.
        slots:
          deployment_id: requestBody.deployment_id
          goal: requestBody.goal
          branches: requestBody.branches
      - text: Create a work graph for {goal} on {deployment_id} with branches {branches}, budget {budget}, merged by {merge_strategy}.
        slots:
          goal: requestBody.goal
          deployment_id: requestBody.deployment_id
          branches: requestBody.branches
          budget: requestBody.budget
          merge_strategy: requestBody.merge_strategy
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/parallel/graphs/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a work graph with its attempt audit
      effect: read
      questions:
      - What's the current state of my parallel work graph, including its branches and cost?
      - Can I see the budget attempts recorded for a work graph?
      instructions:
      - text: Show parallel work graph {id}.
        slots:
          id: path.id
      - text: Get graph {id} with its branches, cost summary and budget attempts.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/parallel/graphs/{id}/cancel'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a parallel work graph
      effect: destructive
      questions:
      - How do I stop a parallel work graph and all its running branches?
      - What happens to in-flight workers when I cancel a graph?
      instructions:
      - text: Cancel work graph {id}.
        slots:
          id: path.id
      - text: Durably cancel graph {id} and abort its branches.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/parallel/graphs/{id}/retry'].post
  update:
    x-apievangelist-phrasing:
      intent: Retry failed branches via the legacy alias
      effect: write
      questions:
      - My older client calls the retry alias; does it still requeue failed branches of a graph?
      - Is the plain retry route the same as retry-failed?
      instructions:
      - text: Retry graph {id} using the older retry compatibility route.
        slots:
          id: path.id
      - text: Call the legacy retry alias on graph {id} with force set to {force}.
        slots:
          id: path.id
          force: requestBody.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/parallel/graphs/{id}/retry-failed'].post
  update:
    x-apievangelist-phrasing:
      intent: Retry a graph's failed branches
      effect: write
      questions:
      - How do I rerun only the branches that failed in my parallel work graph?
      - Does retrying failed branches reuse the previous attempt or create a new one?
      instructions:
      - text: Retry the failed branches of graph {id}.
        slots:
          id: path.id
      - text: 'Requeue failed branches in work graph {id}, forcing it: {force}.'
        slots:
          id: path.id
          force: requestBody.force
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/parallel/graphs/{id}/execute'].post
  update:
    x-apievangelist-phrasing:
      intent: Revalidate or canary-run a work graph
      effect: write
      questions:
      - How do I execute a queued parallel work graph, or run its no-effect canary?
      - Why is ordinary marketplace dispatch unavailable when I execute a graph?
      instructions:
      - text: Execute work graph {id}.
        slots:
          id: path.id
      - text: Revalidate the authority of queued graph {id} and run its canary.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/parallel/graphs/{id}/receipts'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a work graph's receipts
      effect: read
      questions:
      - Which attempts in my work graph produced receipts, and what did they cost?
      - Where can I reconcile a parallel graph's receipts and settlement status?
      instructions:
      - text: Show the receipts for graph {id}.
        slots:
          id: path.id
      - text: List receipt-bearing attempts and cost completeness for work graph {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/parallel/graphs/{id}/branches'].get
  update:
    x-apievangelist-phrasing:
      intent: List a work graph's branches
      effect: read
      questions:
      - What branches make up my parallel work graph?
      - How do I see every branch and its status for one graph?
      instructions:
      - text: List the branches of graph {id}.
        slots:
          id: path.id
      - text: Show all branches in parallel work graph {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/parallel/branches/{id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get one work graph branch
      effect: read
      questions:
      - How do I inspect a single branch of a parallel work graph by its own ID?
      - Why does a branch lookup return 404 when I'm not authorized for its graph?
      instructions:
      - text: Show branch {id}.
        slots:
          id: path.id
      - text: Get the status and output of parallel work branch {id}.
        slots:
          id: path.id
      method: generated
      generated: '2026-09-26'