sdk/python/examples/06_thread_lifecycle_and_controls/sync.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, runtime_config

ensure_local_sdk_src()

from openai_codex import Codex

with Codex(config=runtime_config()) as codex:
    thread = codex.thread_start(model="gpt-5.4", config={"model_reasoning_effort": "high"})
    first = thread.turn("One sentence about structured planning.").run()
    second = thread.turn("Now restate it for a junior engineer.").run()

    reopened = codex.thread_resume(thread.id)
    listing_active = codex.thread_list(limit=20, archived=False)
    reading = reopened.read(include_turns=True)

    _ = reopened.set_name("sdk-lifecycle-demo")
    _ = codex.thread_archive(reopened.id)
    listing_archived = codex.thread_list(limit=20, archived=True)
    unarchived = codex.thread_unarchive(reopened.id)

    resumed = codex.thread_resume(
        unarchived.id,
        model="gpt-5.4",
        config={"model_reasoning_effort": "high"},
    )
    resumed_result = resumed.turn("Continue in one short sentence.").run()

    forked = codex.thread_fork(unarchived.id, model="gpt-5.4")
    forked_result = forked.turn("Take a different angle in one short sentence.").run()

    compact_result = unarchived.compact()

    print("Lifecycle OK:", thread.id)
    print("first:", first.id, first.status)
    print("second:", second.id, second.status)
    print("read.turns:", len(reading.thread.turns))
    print("list.active:", len(listing_active.data))
    print("list.archived:", len(listing_archived.data))
    print("resumed:", resumed_result.id, resumed_result.status)
    print("forked:", forked_result.id, forked_result.status)
    print("compact:", compact_result.model_dump(mode="json", by_alias=True))