Files

T

YeonGyu-Kim b30a131690 refactor: migrate delegate_task to task tool with metadata fixes

- Rename delegate_task tool to task across codebase (100 files)
- Update model references: claude-opus-4-6 → 4-5, gpt-5.3-codex → 5.2-codex
- Add tool-metadata-store to restore metadata overwritten by fromPlugin()
- Add session ID polling for BackgroundManager task sessions
- Await async ctx.metadata() calls in tool executors
- Add ses_ prefix guard to getMessageDir for performance
- Harden BackgroundManager with idle deferral and error handling
- Fix duplicate task key in sisyphus-junior test object literals
- Fix unawaited showOutputToUser in ast_grep_replace
- Fix background=true → run_in_background=true in ultrawork prompt
- Fix duplicate task/task references in docs and comments

2026-02-06 21:35:30 +09:00

3.3 KiB

Raw Blame History

TOOLS KNOWLEDGE BASE

OVERVIEW

25+ tools across 8 categories. Two patterns: Direct ToolDefinition (static) and Factory Function (context-dependent).

Categories: LSP (6), AST-Grep (2), Search (2), Session (4), Task (4), Agent delegation (2), Background (2), Skill (3), System (2)

STRUCTURE

tools/
├── [tool-name]/
│   ├── index.ts      # Barrel export
│   ├── tools.ts      # ToolDefinition or factory
│   ├── types.ts      # Zod schemas
│   └── constants.ts  # Fixed values
├── lsp/              # 6 tools: definition, references, symbols, diagnostics, rename (client.ts 803 lines)
├── ast-grep/         # 2 tools: search, replace (25 languages)
├── delegate-task/    # Category-based routing (executor.ts 983 lines, constants.ts 552 lines)
├── task/             # 4 tools: create, get, list, update (Claude Code compatible)
├── session-manager/  # 4 tools: list, read, search, info
├── grep/             # Custom grep with timeout (60s, 10MB)
├── glob/             # 60s timeout, 100 file limit
├── interactive-bash/ # Tmux session management
├── look-at/          # Multimodal PDF/image (307 lines)
├── skill/            # Skill execution
├── skill-mcp/        # Skill MCP operations
├── slashcommand/     # Slash command dispatch
├── call-omo-agent/   # Direct agent invocation (358 lines)
└── background-task/  # background_output, background_cancel (734 lines)

TOOL CATEGORIES

Category	Tools	Pattern
LSP	lsp_goto_definition, lsp_find_references, lsp_symbols, lsp_diagnostics, lsp_prepare_rename, lsp_rename	Direct
Search	ast_grep_search, ast_grep_replace, grep, glob	Direct
Session	session_list, session_read, session_search, session_info	Direct
Task	task_create, task_get, task_list, task_update	Factory
Agent	task, call_omo_agent	Factory
Background	background_output, background_cancel	Factory
System	interactive_bash, look_at	Mixed
Skill	skill, skill_mcp, slashcommand	Factory

TASK TOOLS

Claude Code compatible task management.

task_create: Creates a new task. Auto-generates ID and syncs to Todo.
task_get: Retrieves a task by ID.
task_list: Lists active tasks. Filters out completed/deleted by default.
task_update: Updates task fields. Supports additive addBlocks/addBlockedBy.

HOW TO ADD

Create src/tools/[name]/ with standard files
Use tool() from @opencode-ai/plugin/tool
Export from src/tools/index.ts
Static tools → builtinTools, Factory → separate export

TOOL PATTERNS

Direct ToolDefinition:

export const grep: ToolDefinition = tool({
  description: "...",
  args: { pattern: tool.schema.string() },
  execute: async (args) => result,
})

Factory Function (context-dependent):

export function createDelegateTask(ctx, manager): ToolDefinition {
  return tool({ execute: async (args) => { /* uses ctx */ } })
}

NAMING

Tool names: snake_case (lsp_goto_definition)
Functions: camelCase (createDelegateTask)
Directories: kebab-case (delegate-task/)

ANTI-PATTERNS

Sequential bash: Use && or delegation
Raw file ops: Never mkdir/touch in tool logic
Sleep: Use polling loops

3.3 KiB Raw Blame History