docs: sync agent-api-openapi.yaml from warp-server

[hongyi-chen]

Syncs developers/agent-api-openapi.yaml from warp-server/public_api/openapi.yaml.

Source warp-server commit: edcd8278af3c62f1fea20803dff7d5552b8808d0

Structural diff before apply:

Drift detected between
  source: /workspace/warp-server/public_api/openapi.yaml
  target: /workspace/docs/developers/agent-api-openapi.yaml

Paths whose operations differ between source and target:
  ~ /agent/identities/{uid}
  ~ /agent/runs
  ~ /agent/sessions/{sessionUuid}/redirect
Schemas present in source subset but missing from target:
  + AgentRunMode
  + MemoryStoreRef
  + SecretRef
  + SessionSharingConfig
Schemas present in target but absent from source subset:
  - CreateExternalConversationRequest
  - CreateExternalConversationResponse
  - FinishTaskRequest
  - GetUploadTargetRequest
  - NotifyUserRequest
  - ReportArtifactRequest
  - ReportArtifactResponse
  - ReportPullRequestArtifactRequest
  - ResolvePromptRequest
  - ResolvePromptResponse
  - UploadTarget
Schemas whose definitions differ between source subset and target:
  ~ AgentResponse
  ~ AmbientAgentConfig
  ~ CreateAgentRequest
  ~ CreateScheduledAgentRequest
  ~ Harness
  ~ RequestUsage
  ~ RunAgentRequest
  ~ RunItem
  ~ ScheduledAgentItem
  ~ UpdateAgentRequest
  ~ UpdateScheduledAgentRequest

Validation:

• python3 .agents/skills/sync-openapi-spec/scripts/sync_openapi.py --mode self-test passed.
• Apply mode wrote the regenerated spec and confirmed all $refs resolve.
• Follow-up diff reported In sync. No changes needed.
• npm run build passed. The sandbox initially had no /etc/hosts, causing localhost resolution to fail while loading Astro config; adding standard localhost entries fixed the sandbox environment.
• Optional npx @redocly/cli lint developers/agent-api-openapi.yaml failed on a duplicate canonical operationId: listAgents for /agent and /agent/identities, plus existing recommended-rule warnings. The generated docs YAML was left in sync with warp-server rather than hand-edited.

This PR was created by Oz (running Codex).

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview, Comment	May 11, 2026 4:08pm