Sessions

Persistence

Authority-backed sessions append semantic facts and content blobs during execution. Orderly saves publish host-owned intent and plan state, operator observations, and catalog metadata without turning those stores into conversation authority. Project memory remains a separate durable subsystem.

Older Omegon sessions may also have a schema-v1 .json/.meta.jsonpair. That pair is a compatibility import source, not an authority backup. Once its model-facing context is materialized into a mixed semantic session, Omegon stops rewriting the pair. Existing files are not deleted automatically.

Resume

# Resume the most recent session
omegon --resume

# Resume a specific session (prefix match)
omegon --resume abc123

# List saved sessions
/sessions

Lineage and Resume

Resume behavior is explicit about what can be reconstructed:

Migration is one-way. After a mixed legacy base is durable, stale or missing pair files cannot change semantic context, transcript, or resume. Unsupported semantic events, missing required blobs, a missing catalog, or corrupt required host stores fail closed instead of falling back to compatibility JSON.

Transcript and Session Export

# Exact committed transcript for full lineage
/transcript

# Exact semantic suffix for mixed lineage
/transcript suffix

# Presentation and evidence export
/session-export

# Current rendered scrollback
/session-export scrollback

/transcript is unavailable for legacy sessions and for a mixed full-session request./session-export is a presentation/evidence artifact with provenance and freshness disclosure; it is not semantic transcript authority. /copy session has the same presentation-only limitation.

Durable Turn Authority

Authority-backed interactive, ACP, daemon, Web/IPC, and omegon run paths record admitted prompts, FIFO queue order, active-turn identity, cancellation or revocation requests, and terminal outcomes in an adjacent authority stream. IPC and Web acceptance first means the runtime ingress received the command; clients observe durable queue state through subsequent runtime queue updates. A cancellation request leaves the turn busy while owned cleanup runs.

Queue, active-turn, and terminal state use one durable lineage-scoped activity revision. Persistent clients accept only newer authoritative revisions. A stale or unversioned busy observation cannot override a newer durable closure. One-shot CLI output projects the fields available at request time but does not claim persistent busy reconciliation.

Mutating calls also carry a durable mutation domain and fence key. If owner acknowledgement or unknown-completion classification, or terminal settlement cannot be recorded after dispatch, Omegon withholds ordinary completion, writes independent emergency evidence, and blocks later matching mutations rather than risking an unqualified repeat. A prepared call has not reached its owner; a dispatched or acknowledged call without settlement recovers as unknown completion.

Unknown completion does not mean failure and does not prove that no side effect occurred. Omegon denies unsafe stable-call replay for mutations unless the original persisted contract was idempotent or enforced exact stable-call deduplication. It does not currently schedule even a safety-eligible replay automatically.

On restart, Omegon validates authority and content blobs, closes an interrupted active turn conservatively, and restores eligible queued prompts that reached durable admission. ACP withdraws orphaned queued requests when their client response channel was lost. Derived projections may be rebuilt from validated authority; authority is never repaired from a compatibility pair, projection, journal, audit row, or UI state. A maintenance resume deny fails before any session load; follow the recovery guide to inspect it.

Before a session-backed provider dispatch, authority appends aroute.lease_recorded fact for the active turn. It preserves selected and serving provider/model identities plus bounded route, contribution, schema, and credential-class evidence without secret material. Sessionless work instead writes a versioned step wrapper toruntime/route-leases.jsonl under the Omegon home and does not fabricate session or turn identity. No current operator command lists historical route leases.

Disable Auto-Save

omegon --no-session

Disables interactive semantic session authority and compatibility persistence for this run. Other configured subsystems, including project memory, logs, and audit records, may still persist data.

Headless Mode

For bounded scripted or CI execution, use a task manifest:

[task]
prompt = "Review the repository and report the highest-risk issue."

[bounds]
max_turns = 4
timeout_secs = 120
token_budget = 20000
tool_budget = 8

[agent]
model = "anthropic:claude-sonnet-4-6"
omegon run task.toml

Flags can override task fields only when a corresponding flag exists. There is currently no command-line override for tool_budget. Top-level --prompt remains a simpler legacy headless mode, not the bounded manifest contract.

Smoke Tests

omegon --smoke

Runs 4 headless smoke tests through the LLM bridge: basic response, bash tool use, file read, and arithmetic validation. Useful for verifying provider connectivity and basic agent functionality after updates. 60-second timeout per test.