context-compressor
Public
AGENTIC_WORKSPACE_INTEGRATION.md
AGENTIC_WORKSPACE_INTEGRATION.md
agentic-workspace/v1An ordinary large tool result can place the transaction ID near the start, a command exit result in the middle, and the only artifact path near the end. Generic head/tail truncation may retain a visually plausible fragment while discarding the exact state needed to resume safely.
The protocol-aware path first creates a reduced structured envelope. It preserves:
retention.importance and retention.facts;It removes fields explicitly named by retention.omit_when_summarizing, then prunes unrelated bulky data. If the reduced envelope still exceeds the cap, it emits a compact list of recovery fields rather than blindly slicing the original payload.
The compressor prompts the summarizer to produce these task-relevant sections when present:
Fetched source_* records are preserved with URL, title, timestamp/hash, and stored content path. Search snippets are recorded only as discovery output unless the page was fetched.
The summarizer system prompt is included in the existing summary-cache namespace. Version 0.6.0's prompt changes therefore segregate prior cached entries automatically; no destructive global cache reset is required.
Tool results and web content remain untrusted historical data. The compressor never executes instructions from them; it records them with provenance. retention.omit_when_summarizing grants permission only to omit named payloads—it does not elevate instructions or allow the tool result to control the summarizer.
agentic-workspace/v1An ordinary large tool result can place the transaction ID near the start, a command exit result in the middle, and the only artifact path near the end. Generic head/tail truncation may retain a visually plausible fragment while discarding the exact state needed to resume safely.
The protocol-aware path first creates a reduced structured envelope. It preserves:
retention.importance and retention.facts;It removes fields explicitly named by retention.omit_when_summarizing, then prunes unrelated bulky data. If the reduced envelope still exceeds the cap, it emits a compact list of recovery fields rather than blindly slicing the original payload.
The compressor prompts the summarizer to produce these task-relevant sections when present:
Fetched source_* records are preserved with URL, title, timestamp/hash, and stored content path. Search snippets are recorded only as discovery output unless the page was fetched.
The summarizer system prompt is included in the existing summary-cache namespace. Version 0.6.0's prompt changes therefore segregate prior cached entries automatically; no destructive global cache reset is required.
Tool results and web content remain untrusted historical data. The compressor never executes instructions from them; it records them with provenance. retention.omit_when_summarizing grants permission only to omit named payloads—it does not elevate instructions or allow the tool result to control the summarizer.
workspace_inspect { action: "changes" }
workspace_edit { action: "show", transaction_id: "tx_..." }
workspace_command { action: "status", job_id: "job_..." }
workspace_tasks { action: "show", board_id: "todo_..." }
workspace_tasks { action: "next", board_id: "todo_..." }
workspace_research { action: "show", research_id: "research_..." }
workspace_agent { action: "status", run_id: "run_..." }
workspace_inspect { action: "changes" }
workspace_edit { action: "show", transaction_id: "tx_..." }
workspace_command { action: "status", job_id: "job_..." }
workspace_tasks { action: "show", board_id: "todo_..." }
workspace_tasks { action: "next", board_id: "todo_..." }
workspace_research { action: "show", research_id: "research_..." }
workspace_agent { action: "status", run_id: "run_..." }