Files
deepseek-harness/packages/spill
Turtle e7def469e1 feat(i18n): key translation pairing records by heading section (#5036)
* feat(i18n): key translation pairing records by heading section

Replace the whole-file blob hashes in *.i18n.yaml with one entry per
heading section that still holds language-specific content, keyed by the
English heading-slug path. Blocks identical across the pair (generated
table rows, code blocks, shared regions) stay out of the hash, so edits to
different sections and identical regenerations merge with Git's default
text merge, including on GitHub.

Remove the dsh-translation-pairing merge driver, its resolver command and
installer wiring; gen-translation-brief recovers last-confirmed text from
commit history. Migrate all active records, archive the superseded Agent
Note, and record the replayed conflict reduction in the new one.

* test(i18n): refresh translation prompt snapshot for the terminology note

* feat(i18n): exclude only code blocks and generated regions from pairing records

Replace byte-equality masking with an explicit rule: a record hash skips
fenced code blocks and BEGIN/END GENERATED regions, the two kinds of
content the pairing gate already requires to be identical on both sides.

Move generated data into regions written into both pages:
gen-config-catalog renders both languages and the record with per-package
regions labelled by code identifiers; gen-module-graph keeps its table in a
region; gen-doc-graphs splices the event matrix regions into the Chinese
page. Add a generic region splice beside the region grammar.
2026-09-23 22:32:06 +08:00
..

description, kind
description kind
Package map for the text spill capability family: what the storage service, the local backend, and the result policy each provide. package-group

spill/ — text spill capability family

English | 中文

Summary

The spill/ group stores full text outside the model's context and returns a locator with retrieval guidance. The family splits into the storage service in spill/, the local filesystem backend in spill-local/, and the tool-result policy in spill-policy/. Tool-result spilling is opt-in through maxInlineTokens and keeps the original result on storage failure. Session references also consume storage directly for truncated captured transcripts, with their own preview and failure notices; they do not require the tool-result policy.

Table of Contents


Packages

Three packages play the spill roles; the subsystem reference owns the exhaustive vocabulary and contracts.

Package Role ctx key
spill/ Storage service: saves oversized text and returns a locator plus retrieval guidance ctx.spillStore
spill-local/ Saves spilled text to private session-scoped files on this machine registers on ctx.spillStore
spill-policy/ Replaces oversized plain-text tool results with a preview and locator listens on ctx.tools

Start with the subsystem reference for the shared vocabulary, then the design decision.

  • Spill subsystem — the SaveTextSpill/SpillRef vocabulary, ownership, and backend relationships.
  • Tool output spill decision — the capability boundary between storage, retention, and tool-owned output handling.

Dev Note

Working context for maintainers — click to expand

None.