Turns and events

A turn is one user request in a thread. run() waits for completion and returns a turn result; runStreamed() returns an async event sequence.

Copyconst { events } = await thread.runStreamed("Run tests and fix the failing cases");
for await (const event of events) {
  if (event.type === "item.completed") console.log(event.item);
  if (event.type === "turn.completed") console.log(event.usage);
}

Items include agent_message, reasoning, command_execution, file_change, mcp_tool_call, web_search, todo_list, and error. Command executions and MCP calls expose an in-progress and completed/failed lifecycle. The MCP server represents the same operations with turn/start, turn/steer, and turn/interrupt, and emits codex/event/* notifications.