Files

T

YeonGyu-Kim 33d39597ae docs(agents): regenerate AGENTS.md hierarchy with updated metrics and model configs

- 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)

2026-03-02 23:40:38 +09:00

2.3 KiB

Raw Blame History

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.

2.3 KiB Raw Blame History