mirror of https://gitee.com/zhangsken/opencode.git synced 2026-10-16 10:30:01 +08:00

Files

T

History

Simon Klee 80241e9718 companion: fix session and voice races

Keep user interactions tied to the current companion turn so stopping,
typing, or reopening a retained session cannot revive stale speech or lose
input. Limit status information to the main session and the companion's
actual permission boundary.

2026-09-25 23:41:01 +02:00

catalog-config-plugin-lifecycle.md

chore: generate

2026-08-08 04:21:03 +00:00

companion.md

companion: fix session and voice races

2026-09-25 23:41:01 +02:00

event-stream-architecture.md

refactor(server): share event stream encoding (#36484 )

2026-07-12 11:48:52 -04:00

provider-policy.md

feat(core): identify the client on Console requests (#50896 )

2026-09-23 07:09:19 -05:00

README.md

companion: add voice-enabled side sessions

2026-09-25 20:41:37 +02:00

session.md

refactor(core): isolate Session admission and controls (#46019 )

2026-08-28 23:22:25 -04:00

tools.md

refactor(tools): unify tool APIs and result handling (#38367 )

2026-07-23 21:13:31 +00:00

README.md

V2 Specifications

These documents explain V2 behavior that is difficult to recover from one source file. They are not API reference or a backlog.

Authority

Authority follows the concern:

Concern	Owner
HTTP operations and transport errors	Protocol endpoint definitions assembled by Server `HttpApi`
Public domain shapes and durable event payloads	Schema
Runtime behavior and persistence	Core
Contributor-critical regression guardrails	Root AGENTS.md

Current specifications explain cross-module contracts without copying exact types. Decision records explain why a design was selected. Historical documents describe earlier states and may use obsolete names.

Generated clients follow the assembled public HttpApi. GitHub issues own active work; Git history preserves removed plans and scratchpads.

Current Contracts

Document	Job
Session	Explain prompt admission, execution, instructions, compaction, and recovery boundaries.
Tools	Explain tool construction, registration, execution, and outcome laws.
Companion	Explain companion sessions, main-session tools, and the voice cascade.

Decision Records

Document	Status	Job
Event stream	Accepted and implemented	Record why public events use one encoded feed with independent queues.
Provider policy	Accepted and implemented	Allow or deny provider use and permission checks, with Console-managed statements having final authority.

Historical Context

Document	Job
Catalog/config/plugin lifecycle	Preserve the option comparison that led to replayable Location-scoped catalog transforms.

Do not add implementation checklists here. Put actionable work in GitHub issues and package-specific contributor guidance next to the code it governs.