jim-bo's picture
docs: add AGENTS.md convention across all directories
2cd140a

AGENTS.md — core/

Framework utilities shared across agents and TUI.

Files

  • chat_events.py — typed event dataclasses (ChatEvent subclasses). This is the agent↔TUI contract. Events: AgentThinking, AgentThinkingChunk, AgentThinkingComplete, AgentToolStart, AgentToolEnd, AgentToolOutput, AgentStreamChunk, AgentComplete, AgentRequiresUserInput, AgentExecuteCommand. Also defines ChatDeps.
  • command.pySlashCommand base class + CommandManager with auto_discover() for plugin loading.
  • fs.pyFSManager for path-jailed filesystem operations.
  • permissions.pyPermissionManager reads/writes tool approvals to .agents/settings.json.