Function createTaskTool

src/node/services/tools/task.ts:353–719

(config: ToolConfiguration)

}

export const createTaskTool: ToolFactory = (config: ToolConfiguration) => {
  // Only advertise the `isolation` parameter on runtimes where sharing the parent checkout is
  // supported. On local runtimes the field is omitted from the schema entirely, so it never
  // enters LLM context.
  const runtimeMode = resolveRuntimeMode(config);
  const inputSchema = buildTaskToolAgentArgsSchema({
    includeIsolation: runtimeModeSupportsSharedTaskWorkspace(runtimeMode),
  });
  const taskTool = tool({
    description: buildTaskDescription(config),
    inputSchema,
    execute: async (args, { abortSignal, toolCallId }): Promise<unknown> => {
      // Defensive: tool() should have already validated args via inputSchema,
      // but keep runtime validation here to preserve type-safety.
      const parsedArgs = TOOL_DEFINITIONS.task.schema.safeParse(args);
      if (!parsedArgs.success) {
        const keys =
          args && typeof args === "object" ? Object.keys(args as Record<string, unknown>) : [];
        log.warn(
          "[task tool] Unexpected input validation failure (should have been caught by AI SDK)",
          {
            issues: parsedArgs.error.issues,
            keys,
          }
        );
        throw new Error(`task tool input validation failed: ${parsedArgs.error.message}`);
      }
      const validatedArgs = parsedArgs.data;
      if (abortSignal?.aborted) {
        throw new Error("Interrupted");
      }

      const {
        kind,
        agentId,
        subagent_type,
        prompt,
        title,
        run_in_background,
        n,
        variants,
        model,
        thinking,
        isolation,
        workspace,
      } = validatedArgs;

      // Explicit per-launch model/thinking overrides. Omitted by default so delegated work
      // inherits the parent's live settings unless the caller requests an override.
      const aiOverrides = parseTaskAiOverrides({ model, thinking });

      const workspaceId = requireWorkspaceId(config, "task");
      const taskService = requireTaskService(config, "task");

      const parentRuntimeAiSettings = buildParentRuntimeAiSettings(config);

      if (config.planFileOnly && kind === "workspace") {
        throw new Error(PLAN_AGENT_EXPLORE_ONLY_ERROR);