Method getTools

examples/agents-as-tools/src/server.ts:857–974

()

  }

  override getTools(): ToolSet {
    return {
      research: tool({
        description:
          "Dispatch a Researcher helper to investigate a topic in depth. " +
          "The helper does multi-step search and synthesis; you summarize " +
          "the result for the user. Returns the helper's synthesized summary.",
        inputSchema: z.object({
          query: z
            .string()
            .min(3)
            .describe(
              "The research topic. Be specific — e.g. 'How does HTTP/3 differ from HTTP/2?' rather than 'HTTP'."
            )
        }),
        execute: async ({ query }, { toolCallId, abortSignal }) => {
          return await this._runHelperTurn(Researcher, query, toolCallId, 0, {
            abortSignal
          });
        }
      }),
      plan: tool({
        description:
          "Dispatch a Planner helper to produce a concrete implementation " +
          "plan for a feature or refactor. The helper inspects (simulated) " +
          "files and writes a structured plan with overview / affected files / " +
          "step-by-step / open questions sections. Use for 'how do I implement X' " +
          "or 'what's a plan for Y' kinds of questions.",
        inputSchema: z.object({
          description: z
            .string()
            .min(5)
            .describe(
              "What needs planning. Be concrete — e.g. 'add a dark mode toggle to the settings page' rather than 'plan dark mode'."
            )
        }),
        execute: async ({ description }, { toolCallId, abortSignal }) => {
          return await this._runHelperTurn(
            Planner,
            description,
            toolCallId,
            0,
            {
              abortSignal
            }
          );
        }
      }),
      compare: tool({
        description:
          "Dispatch TWO Researcher helpers in parallel to investigate two " +
          "related topics simultaneously. Use for compare/contrast queries; " +
          "the user sees both helpers' timelines unfolding side-by-side " +
          "under the same tool call. Returns both summaries (or per-branch " +
          "errors if one of the helpers failed).",
        inputSchema: z.object({
          a: z.string().min(3).describe("First topic to investigate."),
          b: z