_KermanandTianyi Cui
f4a32dbd0a
Represent tool results as tool-role messages and migrate released wrappers without losing outer own JSON fields, call identity, error state, or writer field order. Refuse nested or wrapper-only information that has no lossless current representation before successor publication. Validate current event relationships directly instead of projecting V4 data back into V3. Keep lifecycle, PTC, title/command, compaction, system-field and retired-syntax checks on catalog restoration and ordinary JSONL opens. The Worker JSON equality helper must inspect own keys so it cannot admit PTC arguments that Node rejects. Keep the source role change, required native admission and consumer fixture updates in one complete review layer. Explain shared-type changes in the persistence record and the native reader rationale in its existing note. Use checked branded fixture identities and discriminant narrowing instead of unknown double casts; fixture values and assertions remain intact. This recomposes the original tool-role work by _Kerman with the independently validated migration and admission repairs by Tianyi Cui. Frozen generations and snapshot input version selection are retained. Co-authored-by: Tianyi Cui <[email protected]>
description, kind
| description | kind |
|---|---|
| The todo group map: the model-facing todo_write tool over the session log, for users and maintainers navigating the group. | package-group |
packages/todo
English | 中文
Summary
The todo group gives agents a session-level task list to plan with: add tasks, mark them in progress, and check them off, with the same list persisting across turns and reopened sessions. It is one product package that provides the todo_write tool; the list belongs to the agent session that created it, and each update replaces the whole list. Interactive hosts show the standing plan from the list, while the group itself ships no UI.
Table of Contents
Packages
| Package | Role | ctx key |
|---|---|---|
tool-todo |
Lets the agent maintain a session task list: plan tasks, update status, and track progress | registers on ctx.tools |
Related documentation
- Todo subsystem — the
todo/writeevent payload, ownership rules, andTodoItem. - Generated tool catalog — the
todo_writeschema the model receives. - Generated configuration catalog — every accepted config field.
- todo_write tool Agent Note — the original design and its alternatives.
Dev Note
Working context for maintainers — click to expand
None.