INSERTION.md

Compressor Reflex (v1): Insertion Point Specification

1. Architectural Placement

The Compressor Reflex sits inline between tool execution and conversational context append.

[Agent Core / LLM]
       │
       │ 1. Emits Tool Call (e.g. view_file, grep_search, run_command)
       ▼
[Tool Execution Engine]
       │
       │ 2. Returns Raw Output (stdout/stderr, file lines, search hits)
       ▼
┌────────────────────────────────────────────────────────┐
│             COMPRESSOR REFLEX INTERCEPTION             │
│                                                        │
│  Input: Step Intent (<= 128 tok) + Raw Output Chunk    │
│  Logic: Line-level keep/drop classification            │
│  Policy: Fails-Open (keep on uncertainty / <= 5 lines) │
└────────────────────────────────────────────────────────┘
       │
       │ 3. Returns Compressed Output (Decision-relevant lines only)
       ▼
[Context Accumulator / Trajectory Store]
       │
       │ 4. Compressed context sent to LLM on subsequent step
       ▼
[Next Agent Step]

2. Interception Contract

1. Timing: Immediately after the tool process finishes execution and captures stdout/stderr/return payload, but strictly before that text is appended to the message history or prompt buffer.
2. Inputs:
   • intent: The current user prompt, active goal, or reasoning step that prompted the tool call ($\le 128$ tokens).
   • raw_output: The verbatim text output from the tool execution.
3. Fail-Open Policy:
   • If output length $\le 5$ lines or $\le 64$ tokens $\rightarrow$ bypass compressor, pass through verbatim.
   • If any runtime, tokenizer, or inference error occurs $\rightarrow$ pass through verbatim with warning log.
   • Line scoring: Keep any line where $p(\text{keep}) \ge \tau$ (where $\tau$ is calibrated on the must-keep anchor set).
4. Output: A reconstructed string containing only the kept lines in their exact original relative order, preserving line numbers and error context.