vrr/agent-zero
2
0
Fork 0
mirror of https://github.com/agent0ai/agent-zero.git synced 2026-07-13 02:48:30 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 2
agent-zero/plugins/_chat_compaction/AGENTS.md
frdel e138e33ca9 Add file-level DOX docs & update AGENTS indexes 
Add comprehensive file-level DOX documentation across the repo and update directory AGENTS.md indexes. Many new `*.py.dox.md` files were added under api, helpers, tools, plugins, extensions, webui, and other dirs to document endpoint purpose, ownership, runtime contracts, work guidance, and verification. Several AGENTS.md files were created or updated (agents profiles, api, docker, extensions, helpers, plugins, skills, webui components, etc.) to list child DOX files and clarify documentation/work guidance. Also add example and bundled profile DOX files (agent0, default, developer, hacker, researcher) and minor updates to helpers/dirty_json.py and its tests. These changes improve on-disk documentation coverage and establish the convention that each direct runtime file should have a matching `*.dox.md` describing its contracts and verification steps.
2026-06-08 12:41:53 +02:00

999 B
Raw Permalink 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.
  • Keep generated summaries bounded by configured model and token limits.
  • 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.