[Tarquinen]

Issue for this PR

No linked issue.

Type of change

• Bug fix
• New feature
• Refactor / code improvement
• Documentation

What does this PR do?

Fixes V2 docs that don't match current behavior.

• Attachments: PDFs are supported.
• Compaction: document agents.compaction.model.
• Plugins: configured local paths must be directories. Document which file loads.
• Migrate from V1: agent request.body isn't sent to the model. Show model variants instead.
• Providers: chunk timeout is 15 minutes. Fix the OpenRouter model ID.
• CLI config: unknown keys are ignored, and an invalid value makes OpenCode ignore the whole file (tui: one invalid cli.json field silently discards the entire config #56318).
• CLI: add auth export and auth import, a few common run, mini, and stats flags, and 14 missing keybinds.

How did you verify your code works?

• Checked each change against the source on dev.
• bun typecheck, bun run check:generated, and bun run build in services/www.

Screenshots / recordings

N/A, docs only.

Checklist

• I have tested my changes locally
• I have not included unrelated changes in this PR

[opencode-agent]

Docs-only change. I checked each claim against the source on dev and found no mistakes:

• Attachments: PDFs are passed to the model as files.
• Compaction: the compaction agent's model is used for summaries, falling back to the session's model when it can't be resolved; native compaction always uses the session's model.
• Migrate from V1: agent request.body is only merged in config and never sent to the model. Model variants accept body.
• Plugins: a configured local file path is skipped with a warning ("configured plugin path must be a directory").
• Providers: the default chunk timeout is 900 000 ms (15 minutes).
• CLI config: cli.json is decoded as a whole, so one invalid value drops the entire file.
• CLI and keybinds: every new flag and keybind ID exists with the stated default.

The public API is unchanged; this only documents existing behaviour.

One thing to keep in mind: the request.body note in migrate-v1.mdx will need updating if #55051 (which applies agent request body and headers) lands. Some open docs PRs overlap in part (#54711 for keybinds, #57125 for ignored unknown cli.json keys, #57622 for --completions), so whichever merges second may need a small rebase.

[opencode-agent]

The new commit is still docs-only and matches the source. My earlier review raised no concerns, so there was nothing to address. I checked the new and reworded parts against dev:

• Plugins: a configured plugin directory loads server, then index (Host.resolve in packages/plugin/src/host.ts).
• CLI examples: the split-out run, mini and stats examples use real flags with the right defaults.
• CLI config: the reworded cli.json notes match how the file is read.
• Links: the new /agents#request links resolve.

The public API is unchanged. No new concerns.

[opencode-agent]

This push only changes the model IDs in three examples. Each new ID is in the bundled models.dev catalog: anthropic/claude-sonnet-5-5, openrouter/anthropic/claude-sonnet-5.5, and deepseek/deepseek-v4-pro. DeepSeek V4 Pro accepts temperature, so the variant example in migrate-v1.mdx still works. The public API is unchanged. No new concerns.

[opencode-agent]

This push only changes the variant example in migrate-v1.mdx. opencode/deepseek-v4.1-flash is in the bundled models.dev catalog and accepts temperature, and variants accept a body field, so the config shape is valid. I couldn't check against a live gateway whether the OpenCode endpoint forwards thinking to DeepSeek. The public API is unchanged. No new concerns.