agent-zero/plugins/_chat_branching/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

919 B

Chat Branching Plugin DOX

Purpose

  • Own branching a chat from any existing message.
  • Keep log and history trimming behavior consistent when creating a branched conversation.

Ownership

  • plugin.yaml and README.md own metadata and user-facing behavior notes.
  • api/branch_chat.py owns branch creation, clone, trim, persist, and refresh behavior.
  • extensions/ owns WebUI button injection.
  • webui/ owns plugin thumbnail assets.

Local Contracts

  • Preserve UUID-based linking between log entries and history messages.
  • Branched chats must include history only up to the selected message.
  • Do not mutate the source chat while creating a branch.

Work Guidance

  • Coordinate UI button injection with message rendering extension points.

Verification

  • Smoke-test branching from several message positions and confirm source chat remains unchanged.

Child DOX Index

No child DOX files.