vrr/agent-zero
2
0
Fork 0
mirror of https://github.com/agent0ai/agent-zero.git synced 2026-07-09 17:08:29 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 4
agent-zero/plugins/_chat_compaction/AGENTS.md
Alessandro ad148f24cc Fix Responses state after history compaction 
Clear the active Responses provider continuation when automatic history compression or manual chat compaction rewrites local history, while preserving stored response IDs for cleanup.

Add focused regressions for both compression paths so compacted chats do not keep stale provider-side context.
2026-07-07 16:59:49 +02:00

1.4 KiB
Raw Blame History

Chat Compaction Plugin DOX

Purpose

  • Own compacting an entire chat history into a single optimized summary message.
  • Keep compaction prompt, helper, API, and modal behavior aligned.

Ownership

  • plugin.yaml and default_config.yaml own metadata and compaction defaults.
  • api/compact_chat.py owns the compaction endpoint.
  • helpers/compactor.py owns summary generation and history rewrite logic.
  • prompts/ owns compaction system and message prompts.
  • webui/ owns the compaction modal and store.

Local Contracts

  • Preserve chat history integrity and persistence after compaction.
  • Backup JSON and transcript artifacts must remain UTF-8 writable when chat content contains malformed Unicode such as lone surrogates.
  • Keep generated summaries bounded by configured model and token limits.
  • Preserve loaded skill names from skill_instructions metadata without copying full skill bodies into compacted summaries.
  • After replacing local history, clear the active Responses provider continuation while preserving stored response IDs for cleanup.
  • Do not discard original context data unless the compaction flow explicitly owns that behavior.

Work Guidance

  • Coordinate prompt changes with helper behavior and UI confirmation text.

Verification

  • Smoke-test compacting a chat and reloading it after persistence.

Child DOX Index

No child DOX files.