# Session Wait > Register a bounded external result and return it once to the originating Codex session. - Skill: `levineam/session-wait` (Agent Skill) - Install (CLI): `npx skillmds@latest add levineam/session-wait` - Raw SKILL.md: https://api.skillmd.com/api/skills/levineam/session-wait/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: levineam (https://skillmd.com/u/levineam) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/levineam/session-wait --- # Session Wait Use this skill when work must continue outside the current turn and its result must come back to this exact Codex session. The skill is a front door to the private clawd SessionWait engine; it is not a second worker, scheduler, or notification channel. ## Contract The workflow is complete only when: - registration is made from a real Codex turn with trusted session and repository bindings - the wait has one stable `waitId`, an allowlisted terminal producer, an explicit deadline, and a durable owner-only receipt - a terminal receipt is authenticated against the bound wait, subject, revision, fence, and producer - the result is presented at most once to this exact session, immediately only when the native Codex adapter proves the target and acknowledgement - otherwise one bounded projection is queued for the originating session's next eligible hook; it is never rerouted to another session or channel - missing, late, conflicting, cancelled, superseded, and uncertain outcomes remain explicit rather than being silently retried ## Allowed actions The skill may request only these operations through the private engine: - `register` — create or reuse one wait bound to the current Codex turn - `inspect` — show a bounded, redacted status projection - `cancel` — cancel the current wait when the originating owner requests it The skill cannot grant itself event-ingest authority, choose a producer, change the repository binding, extend a deadline, start a worker, run `codex exec`, or send Telegram, calendar, email, or other external notifications. ## Invocation The selected managed Codex runtime exposes the private command `jarvos-session-wait` on `PATH`. Invoke it only from the originating Codex turn; the command derives the session, repository, workspace, and producer bindings from trusted runtime context. ```text jarvos-session-wait register --work-id --action-key \ --subject --revision --deadline [--fence ] jarvos-session-wait inspect --wait-id jarvos-session-wait cancel --wait-id [--reason ] ``` Each invocation returns bounded JSON containing only the wait ID, state, deadline, safe projection, and delivery disposition. Do not supply an origin, state-root, producer, or receipt argument; those fields are runtime-derived or owned by the allowlisted producer. ## Safe result shape Terminal producers return a typed outcome, an opaque result handle, a `sha256:` result digest, and a small inert projection. Raw prompts, transcripts, credentials, absolute paths, instructions, and arbitrary external payloads do not belong in the wait or its public projection. A result-missing receipt must remain missing; the system must not invent a result summary. ## Delivery semantics The authoritative race is a single compare-and-set between an authenticated terminal receipt and the deadline reader. The winner determines whether the wait has a result or an explicit `expired_missing_result` outcome. Delivery is separate from truth: 1. an immediate native delivery is marked delivered only with a durable acknowledgement for the bound thread 2. an unsupported or ambiguous immediate attempt becomes one `queued_next_hook` projection, with no retry loop 3. the next eligible hook claims and consumes that projection once 4. duplicate receipts, process restarts, and late events return the existing disposition rather than displaying twice Preserve the active session's goal, sandbox, approval, and repository scope. Do not use this skill to create a background keepalive, polling loop, calendar reminder, or generic workflow engine.