YeonGyu-Kim
33d39597ae
- 1208→1243 TS files (+35), 143k→155k LOC (+12k)
- Update all agent models: Sisyphus, Hephaestus, Oracle, Librarian, Atlas, Metis, Momus
- Add 6 new hook directories (39→45 dirs): beast-mode-system, hashline-edit-diff-enhancer, anthropic-image-context, task-reminder, compaction-todo-preserver, runtime-fallback
- Update category models: visual-engineering/artistry gemini-3-pro→gemini-3.1-pro
- Add 2 config schema files: fallback-models.ts, runtime-fallback.ts
- Timestamp: 2026-03-02 | Commit: 1c2caa09
🤖 Generated with assistance of [OhMyOpenCode](https://github.com/code-yeongyu/oh-my-opencode)
54 lines
2.3 KiB
Markdown
54 lines
2.3 KiB
Markdown
# src/tools/background-task/ — Background Task Tool Wrappers
|
|
|
|
**Generated:** 2026-03-02
|
|
|
|
## 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.
|