[Opencode Sync] Core CLI: Sessions

[adolago]

Scope

• Base ref: origin/main
• Source ref: opencode/dev
• Theme id: opencode-session
• Commits mapped: 56
• Date span: 2026-01-20 to 2026-02-12

Theme Summary

Session lifecycle, context continuity, and session persistence behavior.

Mapping Rule

Commits are assigned to one issue by dominant touched-path prefix (most matched files in commit; ties resolved by longest prefix then fixed theme order).

Top Path Hotspots

• packages/opencode/src/session/prompt.ts (24)
• packages/opencode/src/session/message-v2.ts (11)
• packages/opencode/src/session/llm.ts (8)
• packages/opencode/src/session/system.ts (7)
• packages/opencode/src/session/index.ts (6)
• packages/opencode/src/session/compaction.ts (5)
• packages/opencode/test/session/retry.test.ts (5)
• packages/opencode/src/session/retry.ts (5)
• packages/opencode/test/session/message-v2.test.ts (4)
• packages/opencode/src/session/prompt/trinity.txt (4)

Commits

• 021e42c0 core: fix issue when switching models (mainly between providers) where past reasoning/metadata would be sent to server and cause 400 errors since they came from another account/provider
• 0c4ffec8 chore: rename toModelMessage -> toModelMessages
• 5622c53e tweak: adjust codex prompt to discourage unnecessary question asking and encourage more autonomy
• 68e41a1e fix: pass arguments to commands without explicit placeholders (fix: pass arguments to commands without explicit placeholders anomalyco/opencode#9606)
• 69469505 fix(opencode): preserve tool input from running state for MCP tool results (fix(opencode): preserve tool input from running state for MCP tool results anomalyco/opencode#9667)
• 9dc95c4c tweak: ensure synthetic user message following subtasks is only added when user manually invoked subtask
• cbe20d22 fix: don't update session timestamp for metadata-only changes (resolves Updating a session's metadata ought not update the timestamp anomalyco/opencode#9494) (fix: don't update session timestamp for metadata-only changes (resolves #9494) anomalyco/opencode#9495)
• 65938baf core: update session summary after revert to show file changes
• 6d574549 fix: include _noop tool in activeTools for LiteLLM proxy compatibility (fix: include _noop tool in activeTools for LiteLLM proxy compatibility anomalyco/opencode#9912)
• 96e9c89c chore: generate
• aa599b4a fix: when dropping unsupported metadata match on providerID/model.id instead of providerID/model.api.id to prevent regression when using legacy model ids (pre-variant)
• c2844697 fix: ensure images are properly returned as tool results
• dac73572 chore: generate
• c3415b79 fix: correct spelling 'supercedes' to 'supersedes' (fix: correct spelling 'supercedes' to 'supersedes' anomalyco/opencode#9935)
• 88bcd046 tweak: tell the model what model it is in environment section of prompt
• 8a216a6a fix(app): normalize path separators for session diff filtering on Windows (fix(app): normalize path separators for session diff filtering on Windows anomalyco/opencode#10291)
• 94dd0a8d ignore: rm spoof and bump plugin version
• 6b83b172 fix: await SessionRevert.cleanup for shell (fix: await SessionRevert.cleanup for shell anomalyco/opencode#10669)
• 8b5dde55 tweak: retry logic to catch certain provider problems
• 837037cd fix: ensure openai 404 errors are retried (fix: ensure openai 404 errors are retried anomalyco/opencode#10590)
• d8e7e915 feat(opencode): Handle Venice cache creation tokens (feat(opencode): Handle Venice cache creation tokens anomalyco/opencode#10735)
• dbc8d7ed chore: generate
• f12f7e77 tweak: adjust retry check to be more defensive
• 55859071 fix: ensure parallel tool calls dont double load AGENTS.md
• 03ba49af fix(telemetry): restore userId and sessionId metadata in experimental_telemetry (fix(telemetry): restore userId and sessionId metadata in experimental_telemetry anomalyco/opencode#8195)
• 26e14ce6 fix: add SubtaskPart with metadata reference (fix: add SubtaskPart with metadata reference anomalyco/opencode#10990)
• 870c38a6 fix: maxOutputTokens was accidentally hardcoded to undefined (fix: maxOutputTokens was accidentally hardcoded to undefined  anomalyco/opencode#10995)
• e84d92da feat: Sequential numbering for forked session titles (Issue [FEATURE]: Inherit or regenerate session title when forking anomalyco/opencode#10105) (feat: Sequential numbering for forked session titles (Issue #10105) anomalyco/opencode#10321)
• 11d48670 fix: rm ai sdk middleware that was preventing blocks from being sent back as assistant message content (fix: rm ai sdk middleware that was preventing <think> blocks from being sent back as assistant message content anomalyco/opencode#11270)
• da7c8748 tweak: show actual retry error message instead of generic error msg (tweak: show actual retry error message instead of generic error msg anomalyco/opencode#11520)
• 6c9b2c37 core: allow starting new sessions after errors by fixing stuck session status
• c6947484 Simplify directory tree output for prompts (Simplify directory tree output for prompts anomalyco/opencode#11731)
• ec720145 fix: when using codex sub, send the custom agent prompts as a separate developer message (previously sent as user message but api allows for instructions AND developer messages) (fix: when using codex sub, send the custom agent prompts as a separate developer message (previously sent as user message but api allows for instructions AND developer messages) anomalyco/opencode#11667)
• 16145af4 fix: prevent duplicate AGENTS.md injection when reading instruction files (fix: prevent duplicate AGENTS.md injection when reading instruction files anomalyco/opencode#11581)
• 015cd404 feat: add Trinity model system prompt support (feat: add Trinity model system prompt support anomalyco/opencode#12025)
• a30696f9 feat(plugin): add shell.env hook for manipulating environment in tools and shell (feat(plugin): add shell.env hook for manipulating environment in tools and shell anomalyco/opencode#12012)
• b5a4671c Revert "feat: add Trinity model system prompt support" (Revert "feat: add Trinity model system prompt support" anomalyco/opencode#12029)
• 1721c6ef fix(core): session errors when attachment file not found
• 6daa962a fix: prioritize OPENCODE_CONFIG_DIR for AGENTS.md (fix: prioritize OPENCODE_CONFIG_DIR for AGENTS.md anomalyco/opencode#11536)
• 72de9fe7 fix(opencode): Fixes image reading with OpenAI-compatible providers like Kimi K2.5. (fix(opencode): Fixes image reading with OpenAI-compatible providers like Kimi K2.5. anomalyco/opencode#11323)
• a4584139 core: fix unhandled errors when aborting with queued messages (core: fix unhandled errors when aborting with queued messages anomalyco/opencode#12369)
• 95ad6758 feat: add specific system prompt for Trinity model (feat: add specific system prompt for Trinity model anomalyco/opencode#12144)
• a486b74b feat(core): Set variant in assistant messages too (feat(core): Set variant in assistant messages too anomalyco/opencode#12531)
• e767801d chore: generate
• def907ae fix(opencode): SessionPrompt.shell() now triggers loop if messages are queued (fix(opencode): SessionPrompt.shell() now triggers loop if messages are queued anomalyco/opencode#10987)
• 62f38087 fix: parse mid stream openai responses style errors to prevent infinite retries for errors that should STOP execution (fix: parse mid stream openai responses style errors to prevent infinite retries for errors that should STOP execution anomalyco/opencode#12768)
• 832902c8 fix: publish session.error event for invalid model selection (fix: publish session.error event for invalid model selection anomalyco/opencode#8451)
• 8ad4768e tweak: adjust agent variant logic to not require exact match on model, and instead check if the variant is available for model (tweak: adjust agent variant logic to not require exact match on model, and instead check if the variant is available for model anomalyco/opencode#12838)
• 0fd6f365 fix(core): ensure compaction is more reliable, add reserve token buffer to ensure that input window has enough room to compact (fix(core): ensure compaction is more reliable, add reserve token buffer to ensure that input window has enough room to compact anomalyco/opencode#12924)
• 659f15aa fix(app): no changes in review pane
• 87795384 chore: fix typos and GitHub capitalization (chore: fix typos and GitHub capitalization anomalyco/opencode#12852)
• 8bdf6fa3 fix: show helpful message when free usage limit is exceeded (fix: show helpful message when free usage limit is exceeded anomalyco/opencode#13005)
• 8c7b35ad tweak: compaction check (tweak: compaction check anomalyco/opencode#13214)
• e269788a feat: support claude agent SDK-style structured outputs in the OpenCode SDK (feat: support claude agent SDK-style structured outputs in the OpenCode SDK  anomalyco/opencode#8161)
• 56ad2db0 core: expose tool arguments in shell hook for plugin visibility
• 98aeb60a fix: ensure @-ing a dir uses the read tool instead of dead list tool (fix: ensure @-ing a dir uses the read tool instead of dead list tool anomalyco/opencode#13428)

Acceptance Checklist

• Validate each commit intent is represented in this theme
• Define parity implementation tasks for Zee based on these commits
• Mark commits that are not applicable to Zee