context-epoch.ts: Schema.decodeUnknownEffect with Effect.orDie crashes session on schema mismatch

Description

File: packages/core/src/session/context-epoch.ts:72

const snapshot = yield* Schema.decodeUnknownEffect(SystemContext.Snapshot)(stored.snapshot).pipe(Effect.orDie)

Schema.decodeUnknownEffect returns Effect<A, ParseError>. Effect.orDie converts any ParseError into a defect. If the stored snapshot in SQLite has an incompatible schema (after version upgrade, data migration, or data corruption), every existing session fails to load with an unhandled defect — all sessions are bricked.

Fix: Use Effect.mapError to convert ParseError into a recoverable error:

Effect.mapError((e) => new Error(`Failed to decode context snapshot: ${e.message}`))

OpenCode version

v1.16.0 (commit 3cf1cef)

This issue might be a duplicate of or related to existing issues. Please check:

bug(session): legacy message/part rows missing required schema fields cause 400 BadRequest on session load #29908: Similar issue where schema mismatches between stored data and current Effect schemas cause sessions to fail to load after upgrades. That report covers missing required fields on message/part rows; this issue covers a related failure mode in context-epoch.ts where Effect.orDie converts a ParseError into a defect during snapshot decoding.

If you believe these are distinct issues, please let a maintainer know.

Navigation Menu

Repository navigation

context-epoch.ts: Schema.decodeUnknownEffect with Effect.orDie crashes session on schema mismatch #30871

Description

OpenCode version

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

context-epoch.ts: Schema.decodeUnknownEffect with Effect.orDie crashes session on schema mismatch #30871

Description

Description

OpenCode version

Activity

github-actions commented on Jun 5, 2026

Metadata

Metadata

Assignees

Labels

Type

Projects

Milestone

Relationships

Development

Issue actions