Files

T

YeonGyu-Kim 838b5ae216 docs(agents): refresh hierarchical AGENTS.md with team-mode coverage

Update root + 43 directory-level AGENTS.md files to reflect current state:
- Root AGENTS.md rewritten with accurate counts (1967 TS files, 1304 source +
  663 test, 278k LOC, 120 barrel index.ts), 7-step init flow, 5-tier hook
  composition, and full Team Mode section (12 team_* tools, eligibility,
  storage layout, config gate)
- src/AGENTS.md adds team-mode init step, current per-subdir file/LOC table
- src/tools/AGENTS.md documents conditional gates (team-mode +12, task
  system +4, hashline +1, interactive_bash +1, look_at +1) with always-on
  baseline of 20
- src/hooks/AGENTS.md splits into 5 tiers + 4 conditional team-mode hooks
- src/features/team-mode/AGENTS.md surfaces 12 tools, eligible agents,
  spawn-race-safe invariants, and integration points
- src/features/builtin-skills/AGENTS.md tracks 10 skills incl. team-mode
- src/agents/AGENTS.md, src/plugin/AGENTS.md, src/config/AGENTS.md updated
  for team-mode awareness, accurate counts, and current schema field list
- All other AGENTS.md files refreshed to 2026-05-08 generation date

2026-05-08 12:08:42 +09:00

2.3 KiB

Raw Blame History

src/tools/background-task/ — Background Task Tool Wrappers

Generated: 2026-05-08

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