Skip to content

v0.3.9

Choose a tag to compare

@echoVic echoVic released this 07 Aug 07:45
· 203 commits to main since this release

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_plan task checklists no longer trigger the formal Plan approval
    flow. Only a successful foreground turn in Plan mode that produces a
    ChatMessage::ProposedPlan opens 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 -- --check
  • cargo 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-serial
  • cargo 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.9

macOS and Linux native installer:

curl -fsSL https://orcaagent.dev/install.sh | \
  INSTALL_DIR=/usr/local/bin ORCA_VERSION=0.3.9 sh

Windows PowerShell, including workspace sandbox setup:

& ([scriptblock]::Create((irm https://orcaagent.dev/install.ps1))) -Version 0.3.9 -SetupSandbox