docs: add module-level AGENTS.md for mcp-oauth, atlas, rules-injector, background-task, call-omo-agent, lsp

🤖 Generated with assistance of [OhMyOpenCode](https://github.com/code-yeongyu/oh-my-opencode)
2026-02-19 03:15:27 +09:00
parent 73514ed329
commit a28e989f83
6 changed files with 345 additions and 0 deletions
@@ -0,0 +1,51 @@
+# src/tools/call-omo-agent/ — Direct Agent Invocation Tool
+
+**Generated:** 2026-02-19
+
+## OVERVIEW
+
+23 files. The `call_omo_agent` tool — direct invocation of named agents (explore, librarian only). Distinct from `delegate-task`: no category system, no skill loading, no model selection. Fixed agent set, same execution modes (background/sync).
+
+## DISTINCTION FROM delegate-task
+
+| Aspect | `call_omo_agent` | `delegate-task` (`task`) |
+|--------|-----------------|--------------------------|
+| Agent selection | Named agent (explore/librarian) | Category or subagent_type |
+| Skill loading | None | `load_skills[]` supported |
+| Model selection | From agent's fallback chain | From category config |
+| Use case | Quick contextual grep | Full delegation with skills |
+
+## ALLOWED AGENTS
+
+Only `explore` and `librarian` — enforced via `ALLOWED_AGENTS` constant in `constants.ts`. Case-insensitive validation.
+
+## EXECUTION MODES
+
+Same two modes as delegate-task:
+
+| Mode | File | Description |
+|------|------|-------------|
+| **Background** | `background-agent-executor.ts` | Async via `BackgroundManager` |
+| **Sync** | `sync-executor.ts` | Create session → wait for idle → return result |
+
+## KEY FILES
+
+| File | Purpose |
+|------|---------|
+| `tools.ts` | `createCallOmoAgent()` factory — validates agent, routes to executor |
+| `background-executor.ts` | Routes to background or sync based on `run_in_background` |
+| `background-agent-executor.ts` | Launch via `BackgroundManager.launch()` |
+| `sync-executor.ts` | Synchronous session: create → send prompt → poll → fetch result |
+| `session-creator.ts` | Create OpenCode session for sync execution |
+| `subagent-session-creator.ts` | Create session with agent-specific config |
+| `subagent-session-prompter.ts` | Inject prompt into session |
+| `completion-poller.ts` | Poll until session idle |
+| `session-completion-poller.ts` | Session-specific completion check |
+| `session-message-output-extractor.ts` | Extract last assistant message as result |
+| `message-processor.ts` | Process raw message content |
+| `message-dir.ts` + `message-storage-directory.ts` | Temp storage for message exchange |
+| `types.ts` | `CallOmoAgentArgs`, `AllowedAgentType`, `ToolContextWithMetadata` |
+
+## SESSION CONTINUATION
+
+Pass `session_id` to resume an existing session rather than create a new one — handled in both executors.