Method create

packages/core/src/core/subagent.ts:278–335

* Creates and validates a new SubAgentScope instance. * This factory method ensures that all tools provided in the prompt configuration * are valid for non-interactive use before creating the subagent instance. * @param {string} name - The name of the subagent. * @param {Config} runtimeC

(
    name: string,
    runtimeContext: Config,
    promptConfig: PromptConfig,
    modelConfig: ModelConfig,
    runConfig: RunConfig,
    toolConfig?: ToolConfig,
    outputConfig?: OutputConfig,
  )

   * @throws {Error} If any tool requires user confirmation.
   */
  static async create(
    name: string,
    runtimeContext: Config,
    promptConfig: PromptConfig,
    modelConfig: ModelConfig,
    runConfig: RunConfig,
    toolConfig?: ToolConfig,
    outputConfig?: OutputConfig,
  ): Promise<SubAgentScope> {
    if (toolConfig) {
      const toolRegistry: ToolRegistry = await runtimeContext.getToolRegistry();
      const toolsToLoad: string[] = [];
      for (const tool of toolConfig.tools) {
        if (typeof tool === 'string') {
          toolsToLoad.push(tool);
        }
      }

      for (const toolName of toolsToLoad) {
        const tool = toolRegistry.getTool(toolName);
        if (tool) {
          const requiredParams = tool.schema.parameters?.required ?? [];
          if (requiredParams.length > 0) {
            // This check is imperfect. A tool might require parameters but still
            // be interactive (e.g., `delete_file(path)`). However, we cannot
            // build a generic invocation without knowing what dummy parameters
            // to provide. Crashing here because `build({})` fails is worse
            // than allowing a potential hang later if an interactive tool is
            // used. This is a best-effort check.
            console.warn(
              `Cannot check tool "${toolName}" for interactivity because it requires parameters. Assuming it is safe for non-interactive use.`,
            );
            continue;
          }

          const invocation = tool.build({});
          const confirmationDetails = await invocation.shouldConfirmExecute(
            new AbortController().signal,
          );
          if (confirmationDetails) {
            throw new Error(
              `Tool "${toolName}" requires user confirmation and cannot be used in a non-interactive subagent.`,
            );
          }
        }
      }
    }

    return new SubAgentScope(
      name,
      runtimeContext,
      promptConfig,
      modelConfig,
      runConfig,
      toolConfig,
      outputConfig,
    );
  }