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

1 KiB

LibreOffice Plugin DOX

Purpose

  • Own ODF-first LibreOffice office artifact workflows for Writer, Calc, and Impress files.

Ownership

  • tools/office_artifact.py owns the agent-facing office artifact tool.
  • helpers/ owns artifact editing, canvas context, document storage, LibreOffice runtime, and presentation writing.
  • api/ owns office session and WebSocket handlers.
  • hooks.py, prompts/, skills/, extensions/, and webui/ own lifecycle behavior, prompts, skill guidance, hooks, and office panel UI.

Local Contracts

  • Preserve document storage integrity and live session synchronization.
  • Keep LibreOffice operations bounded to intended workspaces and artifact paths.
  • Do not expose document contents or temporary files beyond intended UI/tool flows.

Work Guidance

  • Coordinate tool, session, and panel changes so canvas state reflects document state.

Verification

  • Smoke-test creating, editing, previewing, and reconnecting office artifact sessions after changes.

Child DOX Index

No child DOX files.