Optionalhandle: string | null
Optional existing session handle to resume.
Target CLI provider (default: 'codex').
Absolute canonical workspace path.
Optionaloptions: number | AbortSignal | BackendReadContext | FileLockOptions
Optional cancellation signal, execution budget, read context, or lock options (EXEC-001-T09c).
Resolved session record with active turn token, or error description.
Resolves or initializes a session and atomically acquires exclusive turn ownership.
Checks cancellation signals and execution budget before creating or resolving session, during lock acquisition waits, and across synchronous boundaries immediately after write. Atomic file writes (
atomicWriteviafs.rename) represent uninterruptible OS operations; if cancellation occurs across a write boundary, rollback to idle is attempted, any newly initialized empty session file is removed, and turn token is revoked.