Skip to content

Commit 7b80fb3

Browse files
author
Mateusz
committed
Add cross-references between dynamic compression and pytest context saving docs
Link dynamic-tool-output-compression.md to pytest-context-saving.md as a complementary token-saving method, and vice versa.
1 parent daf170c commit 7b80fb3

2 files changed

Lines changed: 5 additions & 48 deletions

File tree

docs/user_guide/features/dynamic-tool-output-compression.md

Lines changed: 2 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -463,54 +463,12 @@ cat var/compression_recovery/abc123.original.json
463463

464464
Legacy Gemini connector truncation controls (`GEMINI_TOOL_OUTPUT_TRUNCATE_*` and backend `tool_output_truncate_*` extras) are deprecated but still functional:
465465

466-
- When dynamic compression is **active**, legacy controls are accepted but marked inactive
467-
- When dynamic compression is **inactive**, legacy controls run through a compatibility path
468-
- Legacy session pytest compression toggles emit deprecation warnings
469-
470-
## Migration from Legacy Features
471-
472-
### From Pytest Output Compression
473-
474-
The legacy `pytest_compression_enabled` toggle is deprecated. Migrate to dynamic compression:
475-
476-
**Before:**
477-
```yaml
478-
session:
479-
pytest_compression_enabled: true
480-
```
481-
482-
**After:**
483-
```yaml
484-
dynamic_compression:
485-
enabled: true
486-
level: "balanced"
487-
```
488-
489-
### From Backend Truncation
490-
491-
Backend-specific truncation settings are deprecated:
492-
493-
**Before:**
494-
```yaml
495-
backends:
496-
gemini:
497-
extra:
498-
tool_output_truncate_chars: 10000
499-
```
500-
501-
**After:**
502-
```yaml
503-
dynamic_compression:
504-
enabled: true
505-
level: "balanced"
506-
min_bytes: 1024
507-
```
508-
509466
## Related Features
510467

511468
- [Context Compaction](context-compaction.md) - Remove stale tool results before compression
469+
- [Pytest Context Saving](pytest-context-saving.md) - Rewrite pytest commands at the tool-call level to inject `-r fE` and `-q` flags for compact output (complementary, works *before* request preparation)
470+
- [Token Saving](token-saving.md) - How compaction and dynamic compression combine for lower context usage
512471
- [Context Window Enforcement](context-window-enforcement.md) - Enforce per-model context limits
513-
- [Pytest Output Compression](pytest-compression.md) - Legacy pytest-specific compression (deprecated)
514472
- [Session Management](session-management.md) - Session handling with compression awareness
515473

516474
## See Also

docs/user_guide/features/pytest-context-saving.md

Lines changed: 3 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -216,10 +216,9 @@ For models with smaller context windows, context saving helps fit more informati
216216

217217
**Too much output still visible:**
218218

219-
- Context saving only adds `-r fE` and `-q` flags (skipping `-q` when verbose output is requested)
219+
- Context saving only adds `-r fE` and `-q` flags (skipping `-q` when verbose output is requested)
220220
- If tests have many failures, all failures will still be shown
221-
- Consider combining with [Pytest Compression](pytest-compression.md)
222-
- Review if additional pytest flags are needed
221+
- Review if additional pytest flags are needed
223222

224223
**Missing important information:**
225224

@@ -236,7 +235,7 @@ For models with smaller context windows, context saving helps fit more informati
236235

237236
## Related Features
238237

239-
- [Pytest Compression](pytest-compression.md) - Compress pytest output to save tokens
238+
- [Dynamic Tool Output Compression](dynamic-tool-output-compression.md) - Strategy-based runtime compression of tool outputs during request preparation (complements command rewriting with content-aware reduction)
240239
- [Context Window Enforcement](context-window-enforcement.md) - Enforce per-model context window limits
241240
- [Session Management](session-management.md) - Intelligent session continuity
242241
- [Tool Access Control](tool-access-control.md) - Control which tools can be executed

0 commit comments

Comments
 (0)