creatixchu
a79b97ecca
Rows of the changed-files card open a `changes-diff` right-Sidebar tab that compares the file at turn start and turn end. The workspace-changes recorder copies every file a file tool edits into the Session's temporary directory before the first edit and again at turn end, so files git does not cover are compared without git and counted first-to-last; `maxFileBytes` caps copies and snapshot reads, and `diffTimeoutMs` degrades a slow line comparison to whole-file replacement.
2.3 KiB
2.3 KiB
description, kind
| description | kind |
|---|---|
| The deliverables group map: the Host plugins that record what a turn hands to the user, explicit file deliveries and observed workspace changes, for users and maintainers navigating the group. | package-group |
packages/deliverables
English | 中文
Summary
The deliverables family records what a turn hands to the user as durable Session events that only clients read: the present tool declares final files the model delivered, and the workspace-changes recorder captures the files a turn changed with their line counts from git snapshots and whole-file captures, and serves each file's comparison. The Web deliverables plugin renders both at the end of a turn. Choose this family for a product that shows delivered files and per-turn changes; present needs ctx.tools and ctx.fs, the recorder needs ctx.subprocess and a git executable.
Table of Contents
Packages
| Package | Role | ctx key |
|---|---|---|
tool-present |
Declares existing files as final deliverables through the present tool |
registers on ctx.tools |
workspace-changes |
Summarizes each top-level turn's changed files from git working-tree snapshots and whole-file captures, and serves their comparisons | provides ctx.workspaceChanges; listens to session/event, appends workspace/changes |
Related documentation
- Deliverables subsystem — the
PresentedFileandWorkspaceChangesSummaryvocabulary, the two durable events, and the summary service. - Web deliverables — the turn-tail cards and file mentions that render these events.
- Present declares workspace source files — the delivery decision.
- Turn changed-files card — the snapshot design and coverage rules.
Dev Note
Working context for maintainers — click to expand
None.