agent-zero/plugins/_office/AGENTS.md
Alessandro bd584da2f4 Improve Editor text file workflows
Generalize the Editor storage/session path from Markdown-only to exact-text .md and .txt documents, including open, save, Save As, and rename refresh behavior.

Expose Open in Editor as a visible row action in the File Browser for Editor-owned text files, keep non-Editor surface opens in the overflow menu, and route Desktop text MIME handling through the Editor bridge.

Tests: node --check webui/components/modals/file-browser/file-browser-store.js; python -m py_compile plugins/_office/helpers/document_store.py plugins/_editor/helpers/markdown_sessions.py plugins/_editor/api/editor_session.py plugins/_editor/api/ws_editor.py plugins/_desktop/helpers/desktop_session.py plugins/_desktop/api/desktop_session.py plugins/_office/api/office_session.py plugins/_office/api/ws_office.py; pytest tests/test_office_document_store.py tests/test_file_browser_navigation.py tests/test_office_canvas_setup.py -q
2026-06-23 14:42:49 +02:00

1.2 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.
  • Editor text Save As storage helpers must preserve exact .md or .txt text and create a new registered document without mutating or deleting the source document.

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.