Requests

The provider-neutral request contract starts with RuntimeRunStartBody and resolves to RuntimeRun. Provider implementations can start, retrieve, cancel, stream, or batch requests according to their reported capabilities. The compile-checked Codex request shows one complete provider lifecycle: it starts a run, polls the returned run_id while the normalized status is started or running, and returns the terminal result.

This client mirrors and verifies upstream-compatible behavior. Upstream runtimes remain the canonical protocol owners.

import { CodexApiClient } from "@cavi-ai/api-client/providers/codex/runtime";

export async function runQuickstart(apiKey: string) {
  const client = new CodexApiClient({
    apiKey,
    defaultModel: "gpt-5",
  });
  let run = await client.startRun({
    input: "Summarize why capability checks matter in one sentence.",
  });

  while (run.status === "started" || run.status === "running") {
    await new Promise((resolve) => setTimeout(resolve, 1_000));
    run = await client.getRun(run.run_id);
  }

  return run;
}