codex/sdk/python/examples/12_turn_params_kitchen_sink/async.py

import sys
from pathlib import Path

_EXAMPLES_ROOT = Path(__file__).resolve().parents[1]
if str(_EXAMPLES_ROOT) not in sys.path:
    sys.path.insert(0, str(_EXAMPLES_ROOT))

from _bootstrap import ensure_local_sdk_src

ensure_local_sdk_src()

import asyncio

from codex_app_server import (
    AskForApproval,
    AsyncCodex,
    Personality,
    ReasoningEffort,
    ReasoningSummary,
    SandboxPolicy,
    TextInput,
)

OUTPUT_SCHEMA = {
    "type": "object",
    "properties": {
        "summary": {"type": "string"},
        "actions": {
            "type": "array",
            "items": {"type": "string"},
        },
    },
    "required": ["summary", "actions"],
    "additionalProperties": False,
}

SANDBOX_POLICY = SandboxPolicy.model_validate(
    {
        "type": "readOnly",
        "access": {"type": "fullAccess"},
    }
)
SUMMARY = ReasoningSummary.model_validate("concise")

PROMPT = (
    "Analyze a safe rollout plan for enabling a feature flag in production. "
    "Return JSON matching the requested schema."
)
APPROVAL_POLICY = AskForApproval.model_validate("never")


async def main() -> None:
    async with AsyncCodex() as codex:
        thread = await codex.thread_start(model="gpt-5", config={"model_reasoning_effort": "high"})

        turn = await thread.turn(
            TextInput(PROMPT),
            approval_policy=APPROVAL_POLICY,
            cwd=str(Path.cwd()),
            effort=ReasoningEffort.medium,
            model="gpt-5",
            output_schema=OUTPUT_SCHEMA,
            personality=Personality.pragmatic,
            sandbox_policy=SANDBOX_POLICY,
            summary=SUMMARY,
        )
        result = await turn.run()

        print("Status:", result.status)
        print("Text:", result.text)
        print("Usage:", result.usage)


if __name__ == "__main__":
    asyncio.run(main())