v0.3.9
Orca v0.3.9
Orca v0.3.9 upgrades Plan mode from a permission-only gate to a full
plan-then-execute workflow, matching the interaction model used by Codex and
Claude Code.
What Changed
- Plan mode now performs read-only exploration and emits a formal
<proposed_plan>block when the plan is complete. The agent no longer
attempts file writes that are silently rejected; instead it produces a
structured plan and signals completion through a protocol marker. - A bottom-anchored approval dialog appears once the proposed plan is ready.
Approving restores the approval mode that was active before entering Plan
and automatically submits an implementation turn. Rejecting keeps the
session in Plan mode so the user can continue iterating. - Per-turn mode context injection replaces the old session-creation-time
system prompt. Switching to Plan mid-session now takes effect on the very
next turn, and switching away immediately removes the read-only constraint. - The plan approval dialog supports PageUp/PageDown and mouse scroll for
reviewing long plans. Arrow keys switch between approval options; Enter
confirms the selection. update_plantask checklists no longer trigger the formal Plan approval
flow. Only a successful foreground turn in Plan mode that produces a
ChatMessage::ProposedPlanopens the approval dialog.
Compatibility
Existing transcripts and sessions remain readable. The new plan approval
state is TUI-internal and does not change CLI, JSONL, ACP, or provider
contracts. The ImplementApprovedPlan user action is added to the typed
surface mutation manifest.
Verification
cargo fmt --all -- --checkcargo clippy --workspace --all-targets --locked -j 1- Plan approval keyboard and mouse interaction tests
- Dynamic mode context injection tests
- Mutation manifest boundary tests (33 actions)
cargo nextest run -p orca-tui --lib --locked --profile ci-serialcargo nextest run --workspace --all-targets --locked --profile ci --no-fail-fast- Runtime surface, version sync, npm staging, and website build gates
git diff --check
Upgrade
npm install -g @blade-ai/orca@0.3.9macOS and Linux native installer:
curl -fsSL https://orcaagent.dev/install.sh | \
INSTALL_DIR=/usr/local/bin ORCA_VERSION=0.3.9 shWindows PowerShell, including workspace sandbox setup:
& ([scriptblock]::Create((irm https://orcaagent.dev/install.ps1))) -Version 0.3.9 -SetupSandbox