Method execute

src/tools/builtin/task.ts:88–140

(args: z.infer<typeof TaskArgs>, ctx: ToolContext)

  argsSchema = TaskArgs;

  async execute(args: z.infer<typeof TaskArgs>, ctx: ToolContext): Promise<ToolResult> {
    if (!subAgentRunner) {
      return {
        content: '[SUBAGENT_DISABLED] Sub-agents are not enabled in this QodeX configuration. ' +
          'Run `qx setup` and select sequential or parallel sub-agent mode, or set ' +
          'subagents.mode: sequential in ~/.qodex/config.yaml.',
        isError: true,
      };
    }

    const maxIterations = args.max_iterations ?? 8;
    const role = args.role; // undefined => default 'subagent' behavior; the runner resolves it
    logger.info('Dispatching sub-agent', {
      description: args.description,
      maxIterations,
      promptChars: args.prompt.length,
      modelOverride: args.model ?? '(default)',
      role: role ?? '(subagent)',
    });

    const subSessionId = `${ctx.sessionId}/sub-${Date.now()}`;
    ctx.emit({ type: 'progress', message: `Sub-agent dispatched: ${args.description}${role ? ` [role: ${role}]` : ''}${args.model ? ` (model: ${args.model})` : ''}` });

    const start = Date.now();
    const result = await subAgentRunner(args.prompt, {
      maxIterations,
      signal: ctx.signal,
      sessionId: subSessionId,
      modelOverride: args.model,
      role,
    });
    const elapsedSec = Math.round((Date.now() - start) / 1000);

    if (!result.ok) {
      return {
        content:
          `[SUBAGENT_FAILED] Sub-agent "${args.description}" failed after ${result.toolCallsRun} tool call(s) in ${elapsedSec}s.\n` +
          `Model: ${result.modelUsed ?? 'unknown'}\n` +
          `Error: ${result.error ?? 'unknown'}\n` +
          `Partial output:\n${result.finalText || '(none)'}`,
        isError: true,
        metadata: { subSessionId, toolCallsRun: result.toolCallsRun, elapsedSec, modelUsed: result.modelUsed },
      };
    }

    return {
      content:
        `[SUBAGENT_DONE] "${args.description}" — completed in ${result.toolCallsRun} tool call(s), ${elapsedSec}s` +
        `${result.modelUsed ? ` (model: ${result.modelUsed})` : ''}\n\n` +
        `--- Sub-agent summary ---\n${result.finalText}`,
      metadata: { subSessionId, toolCallsRun: result.toolCallsRun, elapsedSec, ok: true, modelUsed: result.modelUsed },
    };
  }
}