Wait for cloud task

waitForCodexCloudTask durably checks an existing task until it reaches a terminal state.

automations/wait-for-codex-task.automation.ts

import { automation, onHttpRequest } from "automate.ax"
import { startCodexCloudTask, waitForCodexCloudTask } from "automate.ax/codex"

export default automation("Wait for Codex", () => {
  onHttpRequest({ scope: "automation" })
  const started = startCodexCloudTask({
    branch: "main",
    environmentId: "env_abc123",
    prompt: "Implement the requested change and validate it.",
  })
  const completed = waitForCodexCloudTask({
    taskId: started.id,
    pollInterval: "5m",
    maxPolls: 36,
  })

  completed.status
  completed.currentTurnId
  completed.pullRequests
})

taskId accepts a task ID or compatible signal, including startCodexCloudTask(...).id or continueCodexCloudTask(...).taskId. pollInterval defaults to "5m"; maxPolls defaults to 36 and accepts up to 120. Optional second argument { account } defaults to the project binding and is reused for every status check. Automate.ax checks immediately, then performs each remaining check in a durable child continuation, so provider work can outlive any individual Lambda invocation. The result emits when the task status becomes ready, applied, or error. It includes the prompt, attempts, messages, diff, branch, environment, and pull requests. The signal fails if the task remains pending for the complete polling budget.

Codex Cloud does not currently provide an official public REST API. This callable uses undocumented ChatGPT backend endpoints that may change without notice.

⌘I

Get started

Guides

Concepts

Management API

Reference