feat(opencode): trigger compaction earlier and add multi-file read

[Skyline-23]

Summary

• trigger session compaction earlier to avoid overflow at high context usage
• add multi-file read validation and update read tool guidance
• expand read and compaction tests to cover filePaths edge cases and early threshold

Testing

• bun test test/tool/read.test.ts
• bun test test/session/compaction.test.ts

References

• FixesCodex model response latency increases significantly as conversation grows #9045

[github-actions]

Hey! Your PR title Trigger compaction earlier and add multi-file read doesn't follow conventional commit format.

Please update it to start with one of:

• feat: or feat(scope): new feature
• fix: or fix(scope): bug fix
• docs: or docs(scope): documentation changes
• chore: or chore(scope): maintenance tasks
• refactor: or refactor(scope): code refactoring
• test: or test(scope): adding or updating tests

Where scope is the package name (e.g., app, desktop, opencode).

See CONTRIBUTING.md for details.

[github-actions]

The following comment was made by an LLM, it may be inaccurate:

Based on the search results, here are potentially related PRs to PR #9656:

Related to context overflow/compaction:

• PR feat(opencode): add context overflow prevention with configurable thresholds #8810: feat(opencode): add context overflow prevention with configurable thresholds - Directly addresses context overflow prevention mechanisms
• PR fix(session): prevent context overflow by adding safety margin to compaction check #6562: fix(session): prevent context overflow by adding safety margin to compaction check - Focuses on safety margins for compaction checks
• PR feat: support ZAI token metadata, trigger compaction on idle sessions, add GLM system prompt #4710: feat: support ZAI token metadata, trigger compaction on idle sessions, add GLM system prompt - Addresses compaction triggering
• PR feat: add /branch command to create new session with compacted context #7824: feat: add /branch command to create new session with compacted context - Related to compaction functionality

These PRs may have overlapping scope with PR #9656's goal of "trigger auto-compaction before full context overflow." You should check if any of these have already been merged or if they address the same underlying issue (#9045 referenced in the PR description).

[Copilot]

Pull request overview

This PR introduces two main improvements: triggering auto-compaction earlier to prevent full context overflow, and adding multi-file read capability to the Read tool.

Changes:

• Modified compaction logic to trigger at 90% of usable context instead of 100%
• Extended Read tool to accept either filePath or filePaths parameters for single or multi-file operations
• Updated Read tool documentation to describe the multi-file capability

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 6 comments.

File	Description
packages/opencode/src/session/compaction.ts	Adds EARLY_COMPACT_RATIO constant (0.9) to trigger compaction at 90% of usable context
packages/opencode/src/tool/read.ts	Refactors Read tool to support both single and multiple file reads through filePath/filePaths parameters
packages/opencode/src/tool/read.txt	Documents the new filePaths parameter and multi-file output format
packages/opencode/test/tool/read.test.ts	Adds basic test for reading multiple files using filePaths parameter

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[github-actions]

Thanks for your contribution!

This PR doesn't have a linked issue. All PRs must reference an existing issue.

Please:

1. Open an issue describing the bug/feature (if one doesn't exist)
2. Add Fixes #<number> or Closes #<number> to this PR description

See CONTRIBUTING.md for details.

[Skyline-23]

Updated the PR title to conventional format and added Fixes #9045 in the description. Addressed review feedback with filePaths validation, docs updates, added edge-case tests, Promise.all multi-read, and early compaction threshold coverage.

[github-actions]

Closing this pull request because it has had no updates for more than 60 days. If you plan to continue working on it, feel free to reopen or open a new PR.