refactor(compact): align compact/summary and CompactionResult on shadowed* naming

This commit is contained in:
Hypatia May
2026-06-23 16:51:20 +08:00
parent 894653763e
commit 442f85469e
5 changed files with 12 additions and 12 deletions

View File

@@ -48,7 +48,7 @@ The `compact/*` events extend `SessionEventMap` (merge-extensible) via declarati
| Event | Payload | On surface? |
|---|---|---|
| `compact/start` | `{ turn }` | no (log-only) |
| `compact/summary` | `{ summary, compactedRange, compactedEventSeqs, tokenCount }` | no (log-only) |
| `compact/summary` | `{ summary, shadowedRange, shadowedSeqs, shadowedTokenCount }` | no (log-only) |
| `compact/end` | `{ turn, error? }` | no (log-only) |
## Implementing a backend

View File

@@ -29,9 +29,9 @@ declare module '@deepseek-ai/dsh-session' {
*/
'compact/summary': {
summary: ContentBlock[]
compactedRange: { startSeq: number; endSeq: number }
compactedEventSeqs: number[]
tokenCount: number
shadowedRange: { start: number; end: number }
shadowedSeqs: number[]
shadowedTokenCount: number
}
/** Marks the end of a compaction — log-only, releases the lock. `error` set if summarization failed. */
'compact/end': { turn: number; error?: string }
@@ -53,5 +53,5 @@ export interface CompactionResult {
/** The seq numbers of all shadowed surface nodes. */
shadowedSeqs: number[]
/** Estimated token count of the shadowed content. */
compactedTokenCount: number
shadowedTokenCount: number
}

View File

@@ -36,9 +36,9 @@ class StubCompactService extends CompactService {
const startEvent = session.append('compact/start', { turn: 0 })
const summaryEvent = session.append('compact/summary', {
summary: [{ type: 'text', text: 'stub' }],
compactedRange: { startSeq: start, endSeq: end },
compactedEventSeqs: [],
tokenCount: 0,
shadowedRange: { start, end },
shadowedSeqs: [],
shadowedTokenCount: 0,
})
const endEvent = session.append('compact/end', { turn: 0 })
return {
@@ -48,7 +48,7 @@ class StubCompactService extends CompactService {
summary: [{ type: 'text', text: 'stub' }],
shadowedRange: { start, end },
shadowedSeqs: [],
compactedTokenCount: 0,
shadowedTokenCount: 0,
}
}
}