API Evangelist conversational phrasing for Agoragentic Agent OS and Marketplace Router Agent OS Codebase Workspaces 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 Codebase Workspaces API
  version: 1.0.0
extends: openapi/agoragentic-com-agent-os-codebase-workspaces-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/workspaces/codebase'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a codebase workspace for a repo
      effect: write
      questions:
      - How do I set up a governed workspace for maintaining a code repository?
      - Does creating a codebase workspace push branches or open pull requests?
      instructions:
      - text: Create a codebase workspace for {repo_url}.
        slots:
          repo_url: requestBody.repo_url
      - text: Set up workspace {name} for repo {repo_url} on branch {default_branch}.
        slots:
          name: requestBody.name
          repo_url: requestBody.repo_url
          default_branch: requestBody.default_branch
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/workspaces/{workspace_id}/tasks'].get
  update:
    x-apievangelist-phrasing:
      intent: List code tasks in a workspace
      effect: read
      questions:
      - What code tasks are open in my codebase workspace?
      - Can I limit how many workspace tasks come back?
      instructions:
      - text: List the code tasks in workspace {workspace_id}.
        slots:
          workspace_id: path.workspace_id
      - text: Show the latest {limit} tasks for workspace {workspace_id}.
        slots:
          limit: query.limit
          workspace_id: path.workspace_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/workspaces/{workspace_id}/tasks'].post
  update:
    x-apievangelist-phrasing:
      intent: Create a code change task in a workspace
      effect: write
      questions:
      - How do I open a new code-change task scoped to certain paths?
      - Can I restrict which files and commands a code task may touch?
      instructions:
      - text: Create a code task titled {title} in workspace {workspace_id}.
        slots:
          title: requestBody.title
          workspace_id: path.workspace_id
      - text: Add a task {title} to workspace {workspace_id} limited to paths {allowed_paths}.
        slots:
          title: requestBody.title
          workspace_id: path.workspace_id
          allowed_paths: requestBody.allowed_paths
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/workspaces/{workspace_id}/tasks/{task_id}'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a code task bundle
      effect: read
      questions:
      - Where can I see everything about one code task in my workspace?
      - What's in the task bundle for a planned code change?
      instructions:
      - text: Open code task {task_id} in workspace {workspace_id}.
        slots:
          task_id: path.task_id
          workspace_id: path.workspace_id
      - text: Show the full bundle for task {task_id} of workspace {workspace_id}.
        slots:
          task_id: path.task_id
          workspace_id: path.workspace_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/workspaces/{workspace_id}/tasks/{task_id}/logs'].get
  update:
    x-apievangelist-phrasing:
      intent: Read a code task's session event timeline
      effect: read
      questions:
      - What happened step by step during a code task's session?
      - Can I see the event log for a coding task?
      instructions:
      - text: Show the session event timeline for task {task_id} in workspace {workspace_id}.
        slots:
          task_id: path.task_id
          workspace_id: path.workspace_id
      - text: Get the logs of code task {task_id} in {workspace_id}.
        slots:
          task_id: path.task_id
          workspace_id: path.workspace_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/workspaces/{workspace_id}/tasks/{task_id}/diff'].get
  update:
    x-apievangelist-phrasing:
      intent: Read the latest diff for a code task
      effect: read
      questions:
      - What changes did the latest diff for my code task make?
      - Is there a diff yet for a task before I approve the PR?
      instructions:
      - text: Show the latest diff metadata for task {task_id} in workspace {workspace_id}.
        slots:
          task_id: path.task_id
          workspace_id: path.workspace_id
      - text: Check whether code task {task_id} in {workspace_id} has a diff.
        slots:
          task_id: path.task_id
          workspace_id: path.workspace_id
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/workspaces/{workspace_id}/tasks/{task_id}/approve-pr'].post
  update:
    x-apievangelist-phrasing:
      intent: Record owner approval for a task's PR
      effect: write
      questions:
      - How do I sign off on a code task's diff as the owner?
      - Does approving the PR actually create it on GitHub?
      instructions:
      - text: Approve the PR for task {task_id} in workspace {workspace_id}.
        slots:
          task_id: path.task_id
          workspace_id: path.workspace_id
      - text: Record my PR approval on task {task_id} in {workspace_id} because {reason}.
        slots:
          task_id: path.task_id
          workspace_id: path.workspace_id
          reason: requestBody.reason
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/workspaces/{workspace_id}/tasks/{task_id}/cancel'].post
  update:
    x-apievangelist-phrasing:
      intent: Cancel a code task
      effect: destructive
      questions:
      - How do I stop a code task I no longer want?
      - Can I give a reason when cancelling a workspace task?
      instructions:
      - text: Cancel code task {task_id} in workspace {workspace_id}.
        slots:
          task_id: path.task_id
          workspace_id: path.workspace_id
      - text: Cancel task {task_id} in {workspace_id} with reason {reason}.
        slots:
          task_id: path.task_id
          workspace_id: path.workspace_id
          reason: requestBody.reason
      method: generated
      generated: '2026-09-26'
- target: $.paths['/agent-os/workspaces/{workspace_id}/receipts'].get
  update:
    x-apievangelist-phrasing:
      intent: List receipts for a codebase workspace
      effect: read
      questions:
      - What task-contract receipts has my codebase workspace recorded?
      - Where is the audit trail of receipts for a workspace?
      instructions:
      - text: List the receipts for workspace {workspace_id}.
        slots:
          workspace_id: path.workspace_id
      - text: Show the audit receipts recorded in codebase workspace {workspace_id}.
        slots:
          workspace_id: path.workspace_id
      method: generated
      generated: '2026-09-26'