getcompanion-ai/co-mono
1
0
Fork 0
mirror of https://github.com/getcompanion-ai/co-mono.git synced 2026-04-17 10:02:23 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

Clarify that cut point is always user/assistant/bash, never tool result

Browse source
This commit is contained in:
Mario Zechner 2025-12-24 12:55:15 +01:00
parent 5f41a384cc
commit 35a40b2197
1 changed files with 7 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

14
packages/coding-agent/docs/hooks.md
View file

@ -209,7 +209,7 @@ After compaction (new entry appended):
on reload on reload (stored in this entry) on reload on reload (stored in this entry)
``` ```
The session file is append-only. When loading, the session loader finds the latest compaction entry, uses its summary, then loads messages starting from `firstKeptEntryIndex`. The session file is append-only. When loading, the session loader finds the latest compaction entry, uses its summary, then loads messages starting from `firstKeptEntryIndex`. The cut point is always a user, assistant, or bashExecution message (never a tool result, which must stay with its tool call).
``` ```
What gets sent to the LLM as context: What gets sent to the LLM as context:
@ -222,7 +222,7 @@ What gets sent to the LLM as context:
summary firstKeptEntryIndex onwards summary firstKeptEntryIndex onwards
``` ```
**Split turns:** When a single turn is too large, the cut point may land mid-turn (at an assistant message). In this case `cutPoint.isSplitTurn = true`: **Split turns:** When a single turn is too large, the cut point may land mid-turn at an assistant message. In this case `cutPoint.isSplitTurn = true`:
``` ```
Split turn example (one huge turn that exceeds keepRecentTokens): Split turn example (one huge turn that exceeds keepRecentTokens):
@ -231,11 +231,11 @@ Split turn example (one huge turn that exceeds keepRecentTokens):
┌────────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┐ ┌────────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┬──────┐
│ header │ user │ asst │ tool │ asst │ tool │ tool │ asst │ tool │ asst │ │ header │ user │ asst │ tool │ asst │ tool │ tool │ asst │ tool │ asst │
└────────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┘ └────────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┴──────┘
↑ ↑ ↑ ↑
turnStartIndex = 1 firstKeptEntryIndex = 7 turnStartIndex = 1 firstKeptEntryIndex = 7
│ │ │ │ (must be user/asst/bash, not tool)
└────── turn prefix ────────┘ (idx 1-6, summarized separately) └────────── turn prefix ───────────┘ (idx 1-6, summarized separately)
└── kept messages (idx 7-9) └── kept messages (idx 7-9)
messagesToSummarize = [] (no complete turns before this one) messagesToSummarize = [] (no complete turns before this one)
messagesToKeep = [msg idx 7, msg idx 8, msg idx 9] messagesToKeep = [msg idx 7, msg idx 8, msg idx 9]