feat(cli): support piped prompts for exec

[echoVic]

Summary

• allow orca exec to read the prompt from piped stdin when no prompt argument is provided
• support orca exec - for explicit stdin prompt mode
• append piped stdin as a <stdin>...</stdin> context block when a prompt argument is also present
• document stdin-based headless harness usage in README

Validation

• cargo test --test exec_jsonl -- --nocapture
• cargo check
• rustfmt --edition 2024 --check src/cli.rs tests/exec_jsonl.rs

Evaluation

• Ran a pipe-based agent capability harness against target/debug/orca: 12/12 passed
• Covered stdin prompt modes, multi-turn fixture, read_file, edit/full-auto, approval denial, subagent, verifier, history resume, budget exhaustion, and server pipe protocol

Notes

• Full cargo fmt --check still reports pre-existing formatting drift in untouched files.
• Full cargo test --workspace still fails in unrelated workflow_cli_contract tests.

Summary by CodeRabbit

• New Features

  • orca exec now supports reading prompts from stdin for headless execution; examples added to documentation
  • Added summary caching layer to improve response performance
  • TUI now displays real-time context token usage and remaining budget

• Refactor

  • Internal conversation state management restructured to better handle volatile context and summaries
  • Enhanced history resume logic to preserve conversation state across sessions

• Tests

  • Expanded test coverage for stdin prompt handling, summary rendering determinism, and history state restoration

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: 261c3739-772d-49c4-b6f1-9cb696b80730

📥 Commits

Reviewing files that changed from the base of the PR and between e62e2d4 and 754f39a.

⛔ Files ignored due to path filters (1)

• Cargo.lock is excluded by !**/*.lock

📒 Files selected for processing (19)

• README.md
• crates/orca-core/src/conversation.rs
• crates/orca-mcp/src/client.rs
• crates/orca-provider/Cargo.toml
• crates/orca-provider/examples/summary_render_metrics.rs
• crates/orca-provider/examples/summary_render_realapi.rs
• crates/orca-provider/src/context.rs
• crates/orca-provider/src/deepseek_http.rs
• crates/orca-provider/src/lib.rs
• crates/orca-provider/src/summary_cache.rs
• crates/orca-provider/src/tool_schema.rs
• crates/orca-runtime/src/controller.rs
• crates/orca-runtime/src/history.rs
• crates/orca-tui/src/bridge.rs
• crates/orca-tui/src/types.rs
• crates/orca-tui/src/ui.rs
• src/cli.rs
• tests/exec_jsonl.rs
• tests/history_contract.rs

---

📝 Walkthrough

Walkthrough

This PR refactors Conversation to carry VolatileContext (plan/goal/skill) and SummaryState (baseline/deltas) as first-class fields instead of pinned system messages, rewrites the remote summary delta rendering pipeline with deterministic tool-output extraction and SHA-256 disk caching, injects volatile/summary into DeepSeek API messages, updates history persistence and session resume, adds a TUI context usage gauge, and adds stdin-based prompt resolution to orca exec.

Changes

Volatile/Summary State Refactor and Pipeline

Layer / File(s)	Summary
VolatileContext, SummaryState, and Conversation struct crates/orca-core/src/conversation.rs	Adds VolatileContext, SummaryState, and TokenCountable; expands Conversation struct; reworks plan/goal/skill replacement APIs to write volatile fields instead of pinned system messages; adds legacy stripping helpers and tests.
On-disk summary cache module crates/orca-provider/Cargo.toml, crates/orca-provider/src/lib.rs, crates/orca-provider/src/summary_cache.rs	Introduces summary_cache module with SHA-256 content-addressed key generation (summary_key), lookup/store I/O APIs, cache directory resolution from ORCA_HOME or ~/.orca, and deterministic key/round-trip tests. Adds sha2, dirs, and tempfile dependencies.
Summary delta rendering pipeline crates/orca-provider/src/context.rs	Rewrites compact_with_summary and summarize_collapsed_messages to micro-compact first, reconstruct original collapsed messages for summary rendering, produce RenderedSummaryDelta via tiered tool-output extraction, manage SummaryState baseline/deltas rebuild, cache requests, and extract assistant_content for storage. Updates token counting to include volatile and summary costs. Adds 600+ lines of compaction and rendering tests.
DeepSeek API message injection for volatile/summary crates/orca-provider/src/deepseek_http.rs	Rewrites conversation_to_api_messages as an imperative loop that injects [Summary baseline]/[Summary update N] system messages and appends volatile overlay to the last outgoing message. Exposes ApiMessage and conversation_to_api_messages as pub(crate). Adds volatile overlay behavior tests.
History persistence and resume for SummaryState crates/orca-runtime/src/history.rs	Adds summary_state field to ContextSummaryRecord; adds append_summary_state method; refactors resume_conversation to replay compactions and restore SummaryState from persisted records or rebuild from legacy entries. Adds resume and compaction-replay tests.
Runtime and TUI wiring to new APIs crates/orca-runtime/src/controller.rs, crates/orca-tui/src/bridge.rs	Updates controller to set skill context via replace_skill_context, switch compaction writes to append_summary_state, remove per-turn budget hint, and fix UpdatePlan message handling. Updates bridge to strip legacy volatile/summary on resume, use append_summary_state in all compaction paths, emit ContextUpdated event, and remove budget hint application.
TUI context usage display crates/orca-tui/src/types.rs, crates/orca-tui/src/ui.rs	Adds TuiEvent::ContextUpdated with used_tokens/limit_tokens; adds AppState fields and update handler; adds context_cell helper with success/warning/error color thresholds to render_status; tests all three color states.
Examples, determinism tests, and contract test updates crates/orca-provider/examples/*, crates/orca-provider/src/tool_schema.rs, crates/orca-mcp/src/client.rs, tests/history_contract.rs	Adds summary_render_metrics deterministic harness and summary_render_realapi real-API benchmark; adds tool schema byte-stability and insertion-order tests; adds McpRegistry insertion-order test; flips history_contract skill assertions to absence.

stdin Prompt Resolution for orca exec

Layer / File(s)	Summary
CLI stdin resolver, tests, and README docs README.md, src/cli.rs, tests/exec_jsonl.rs	Adds resolve_exec_prompt_from_stdin to cli.rs supporting - sentinel, no-args stdin read, and piped stdin appended in <stdin>...</stdin> block; updates run_exec with error reporting; adds four integration tests covering all stdin modes; documents headless usage in README.

Sequence Diagram(s)

sequenceDiagram
  participant Controller/Bridge
  participant context.rs
  participant micro_compact
  participant render_summary_delta
  participant summary_cache
  participant DeepSeek API
  participant deepseek_http.rs

  rect rgba(100, 149, 237, 0.5)
    note over Controller/Bridge,deepseek_http.rs: Compaction path
    Controller/Bridge->>context.rs: compact_with_summary(conversation)
    context.rs->>micro_compact: micro_compact_stale_tool_outputs(conversation)
    micro_compact-->>context.rs: micro_compacted (volatile/summary preserved)
    context.rs->>context.rs: summarize_collapsed_messages(collapsed window)
    context.rs->>render_summary_delta: original collapsed messages
    render_summary_delta-->>context.rs: RenderedSummaryDelta
    context.rs->>summary_cache: lookup(scope, purpose, prev, delta_text)
    alt cache miss
      context.rs->>DeepSeek API: request_summary(rendered_delta, prev_summary)
      DeepSeek API-->>context.rs: assistant_content
      context.rs->>summary_cache: store(key, summary)
    end
    context.rs->>context.rs: rebuild SummaryState baseline/deltas
    context.rs-->>Controller/Bridge: updated Conversation (volatile + SummaryState)
    Controller/Bridge->>history.rs: append_summary_state(before, after, summary, &conversation.summary)
  end

  rect rgba(50, 205, 50, 0.5)
    note over deepseek_http.rs,DeepSeek API: Per-turn API call
    deepseek_http.rs->>deepseek_http.rs: conversation_to_api_messages(conversation)
    deepseek_http.rs->>deepseek_http.rs: inject_summary_messages (baseline + deltas) after system msg
    deepseek_http.rs->>deepseek_http.rs: append volatile.render() to last message
    deepseek_http.rs->>DeepSeek API: POST /chat (enriched messages)
  end

Loading

Estimated code review effort

🎯 5 (Critical) | ⏱️ ~120 minutes

Poem

🐇 Hops into the warren with a brand new scheme,
volatile fields and delta caches gleam.
Stdin pipes the prompt when args are bare,
a <stdin> block tucked in with care.
Summary tiers computed, SHA hashed tight,
the context gauge glows green — all feels right! ✨

✨ Finishing Touches

📝 Generate docstrings

• Create stacked PR
• Commit on current branch

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Commit unit tests in branch feat/pipe-eval-stdin

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}