Coder/deepseek-harness
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Document restored compaction result fields

Browse Source
This commit is contained in:
Tianyi Cui
2026-07-15 17:25:39 +08:00
parent d25a56b431
commit 8eccd5416e
2 changed files with 10 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

10
docs/core-data-structures/compaction.md
View File

@@ -20,10 +20,18 @@ These variants are merged inside a `declare module '@deepseek-ai/dsh-session'` b
## `CompactionResult` ## `CompactionResult`
What a successful compaction returns to its caller: the shadowed range and seqs plus the estimated token count. The durable `compact/summary` event owns the raw summary and bookkeeping-event identity. What a successful compaction returns to its caller: the bookkeeping-event seqs, raw summary, shadowed range and seqs, and estimated token count.
```ts type-equiv ```ts type-equiv
interface CompactionResult { interface CompactionResult {
/** The seq of the appended `compact/start` event. */
startSeq: number
/** The seq of the appended `compact/summary` event. */
summarySeq: number
/** The seq of the appended `compact/end` event. */
endSeq: number
/** The summary content blocks produced by the backend. */
summary: ContentBlock[]
/** /**
* The surface-boundary pair that was shadowed: the seqs of the first * The surface-boundary pair that was shadowed: the seqs of the first
* (`start`) and last (`end`) surface nodes of the replaced range. A * (`start`) and last (`end`) surface nodes of the replaced range. A

2
packages/cordis/tool-cordis/src/api-catalog.ts
View File

@@ -631,7 +631,7 @@ export const TYPE_API: readonly TypeApiEntry[] = [
}, },
{ {
name: 'CompactionResult', name: 'CompactionResult',
declaration: 'export interface CompactionResult {\n shadowedRange: {\n start: number;\n end: number;\n };\n shadowedSeqs: number[];\n shadowedTokenCount: number;\n}', declaration: 'export interface CompactionResult {\n startSeq: number;\n summarySeq: number;\n endSeq: number;\n summary: ContentBlock[];\n shadowedRange: {\n start: number;\n end: number;\n };\n shadowedSeqs: number[];\n shadowedTokenCount: number;\n}',
}, },
{ {
name: 'ConfinedArgv', name: 'ConfinedArgv',