ceos/opencode
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

docs: consolidate session work-unit vocabulary (#35218)

Browse source
This commit is contained in:
Kit Langton 2026-07-03 14:49:05 -04:00 • committed by GitHub
commit ca861fdf43
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
6 changed files with 79 additions and 59 deletions
Download patch file Download diff file Expand all files Collapse all files

4
specs/v2/tools.md
View file

@ -148,7 +148,7 @@ Invalid input never invokes the tool. Invalid output never produces a successful
`toModelOutput` is pure and total. When omitted, the encoded output remains structured output; an encoded string is also projected as text. Projection does not receive invocation identity because presentation depends only on validated input and output.
Provider-turn materialization captures the effective registration identity for each advertised name without retaining its handler. Settlement rejects the call as stale if that registration was removed or replaced, including when closing an overlay reveals the previously effective registration. The current handler is captured only after this check; removing or replacing its registration afterward does not affect the running invocation.
Step materialization captures the effective registration identity for each advertised name without retaining its handler. Settlement rejects the call as stale if that registration was removed or replaced, including when closing an overlay reveals the previously effective registration. The current handler is captured only after this check; removing or replacing its registration afterward does not affect the running invocation.
## Output Bounding
@ -176,7 +176,7 @@ Leaf tools translate only errors they deliberately classify as recoverable. Broa
- **Durable identity:** invocation-owned records use the exact Session, agent, assistant message, and call IDs supplied by the runner.
- **Scoped registration:** closing a Scope removes exactly its registration and reveals any prior active overlay.
- **Captured execution:** registration changes cannot alter an invocation after effective lookup.
- **Stale rejection:** a call never executes a registration other than the one advertised for its provider turn.
- **Stale rejection:** a call never executes a registration other than the one advertised for its step.
- **Storage encapsulation:** domain output does not change according to model-output bounding or retention policy.
## Follow-Up