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,53 @@
+# src/tools/background-task/ — Background Task Tool Wrappers
+
+**Generated:** 2026-02-19
+
+## OVERVIEW
+
+18 files. Tool-layer wrappers for `background_output` and `background_cancel`. Does NOT implement the background execution engine — that lives in `src/features/background-agent/`. This directory provides the LLM-facing tool interface.
+
+## THREE TOOLS
+
+| Tool | Factory | Purpose |
+|------|---------|---------|
+| `background_output` | `createBackgroundOutput` | Get results from a running/completed background task |
+| `background_cancel` | `createBackgroundCancel` | Cancel running task(s) |
+| `createBackgroundTask` | internal | Shared factory used by both |
+
+## KEY FILES
+
+| File | Purpose |
+|------|---------|
+| `create-background-output.ts` | `background_output` tool: fetch task results by task_id |
+| `create-background-cancel.ts` | `background_cancel` tool: cancel by taskId or all=true |
+| `create-background-task.ts` | Shared tool factory with common params |
+| `clients.ts` | Client interfaces for background output and cancel |
+| `session-messages.ts` | Fetch session messages from OpenCode |
+| `full-session-format.ts` | Format full session output (messages, thinking blocks) |
+| `task-result-format.ts` | Format task result for LLM consumption |
+| `task-status-format.ts` | Format task status (running/completed/error) |
+| `message-dir.ts` | Temp directory for message exchange |
+| `truncate-text.ts` | Truncate large output to fit context |
+| `time-format.ts` | Human-readable duration formatting |
+| `delay.ts` | Polling delay utility |
+| `types.ts` | `BackgroundTaskOptions`, result/status types |
+| `constants.ts` | Timeout defaults, polling intervals |
+
+## BACKGROUND OUTPUT MODES
+
+```
+background_output(task_id, block=false)  → check current status/result
+background_output(task_id, block=true)   → wait until complete (timeout default: 120s)
+background_output(task_id, full_session=true) → return full session transcript
+background_output(task_id, message_limit=N) → last N messages only
+background_output(task_id, include_thinking=true) → include thinking blocks
+```
+
+## RELATIONSHIP TO BACKGROUND ENGINE
+
+```
+tools/background-task/  ← LLM tool interface
+features/background-agent/  ← execution engine (BackgroundManager)
+```
+
+`createBackgroundOutput` queries `BackgroundManager.getTask(task_id)` — it does not manage task state.