@deepagents/toolbox 0.1.0

package/dist/index.js

@@ -0,0 +1,1055 @@
+// packages/toolbox/src/lib/container.ts
+import { tool } from "ai";
+import spawn from "nano-spawn";
+import { z } from "zod";
+var execute_os_command = tool({
+  description: "Tool to execute Linux commands in an isolated Docker container with Node.js runtime. Use when you need OS operations like file management, package installation, network requests, or system commands.",
+  inputSchema: z.object({
+    command: z.array(z.string().min(1, "Command parts cannot be empty")).min(1, "At least one command part is required").max(20, "Command cannot exceed 20 parts for security").describe(
+      'Command and arguments as array. Examples: ["ls", "-la"], ["npm", "install", "lodash"], ["curl", "-s", "https://api.github.com"], ["node", "--version"]'
+    ),
+    working_directory: z.string().regex(/^\/[a-zA-Z0-9_/.,-]*$/, "Must be a valid absolute Linux path").optional().describe(
+      'Absolute working directory path. Examples: "/tmp", "/workspace", "/app". Defaults to container root.'
+    ),
+    environment_vars: z.record(
+      z.string().min(1, "Environment variable values cannot be empty"),
+      z.string()
+    ).optional().describe(
+      'Environment variables as key-value pairs. Examples: {"NODE_ENV": "development", "API_KEY": "secret123"}'
+    )
+  }),
+  execute: ({ command, working_directory, environment_vars }) => {
+    return exec(command, working_directory, environment_vars);
+  }
+});
+function exec(command, working_directory, environment_vars) {
+  const args = ["exec", "-i"];
+  if (working_directory) {
+    args.push("-w", working_directory);
+  }
+  if (environment_vars) {
+    Object.entries(environment_vars).forEach(([key, value]) => {
+      args.push("-e", `${key}=${value}`);
+    });
+  }
+  args.push("toolos", ...command);
+  return spawn("docker", args, {
+    stdio: "pipe"
+  });
+}
+
+// packages/toolbox/src/lib/ddg-search.ts
+import { tool as tool2 } from "ai";
+import * as ddg from "duck-duck-scrape";
+import { uniqBy } from "lodash-es";
+import { z as z2 } from "zod";
+async function serp({
+  query,
+  source,
+  locale = "en-us",
+  maxResults = 50,
+  ...input
+}) {
+  const safeSearch = ddg.SafeSearchType[
+    "STRICT"
+    // input.safesearch.toUpperCase() as keyof typeof ddg.SafeSearchType
+  ];
+  const time = ddg.SearchTimeType[(input.time || "y")?.toUpperCase()];
+  if (source === "text") {
+    const res2 = await ddg.search(
+      query,
+      {
+        region: "wt-wt",
+        safeSearch,
+        time,
+        locale
+      },
+      {
+        uri_modifier: (rawUrl) => {
+          const url = new URL(rawUrl);
+          url.searchParams.delete("ss_mkt");
+          return url.toString();
+        }
+      }
+    );
+    const items2 = res2.results.slice(0, maxResults).map((r) => ({
+      snippet: r.description,
+      title: r.title,
+      link: r.url,
+      hostname: r.hostname
+    }));
+    return { items: items2, total: res2.results.length, vqd: res2.vqd };
+  }
+  if (source === "news") {
+    const res2 = await ddg.searchNews(query, {
+      safeSearch,
+      time
+    });
+    const items2 = res2.results.slice(0, maxResults).map((r) => ({
+      snippet: r.excerpt,
+      title: r.title,
+      link: r.url,
+      date: r.date,
+      // epoch ms
+      source: r.syndicate,
+      image: r.image,
+      relativeTime: r.relativeTime
+    }));
+    return { items: items2, total: res2.results.length, vqd: res2.vqd };
+  }
+  const res = await ddg.searchImages(query, { safeSearch });
+  const items = res.results.slice(0, maxResults).map((r) => ({
+    title: r.title,
+    thumbnail: r.thumbnail,
+    image: r.image,
+    link: r.url,
+    height: r.height,
+    width: r.width,
+    source: r.source
+  }));
+  return { items, total: res.results.length, vqd: res.vqd };
+}
+var ddgSearchSchema = z2.object({
+  query: z2.string().min(1),
+  source: z2.enum(["text", "news", "images"]).default("text"),
+  locale: z2.string().optional().default("en-us"),
+  // region: z.string().default('wt-wt'),
+  // safesearch: z.enum(['strict', 'moderate', 'off']).default('moderate'),
+  time: z2.enum(["d", "w", "m", "y"]).optional().default("y"),
+  maxResults: z2.number().int().positive().max(50).default(5)
+});
+var duckDuckGoSearch = tool2({
+  description: "A tool for searching the web. Useful for when you need to find information about current events or topics that are not covered in your training data.",
+  inputSchema: ddgSearchSchema,
+  execute: serp
+});
+
+// packages/toolbox/src/lib/ddg-stocks.ts
+import { tool as tool3 } from "ai";
+import { stocks as ddgStocks } from "duck-duck-scrape";
+import { z as z3 } from "zod";
+var toQuote = (r) => ({
+  symbol: r?.Security?.Symbol ?? null,
+  name: r?.Security?.Name ?? null,
+  exchange: r?.Security?.Market ?? null,
+  currency: r?.Currency ?? null,
+  last: r?.Last ?? null,
+  change: r?.ChangeFromPreviousClose ?? null,
+  percentChange: r?.PercentChangeFromPreviousClose ?? null,
+  open: r?.Open ?? null,
+  high: r?.High ?? null,
+  low: r?.Low ?? null,
+  prevClose: r?.PreviousClose ?? null,
+  volume: r?.Volume ?? null,
+  date: r?.Date ?? null,
+  time: r?.Time ?? null,
+  halted: r?.TradingHalted ?? null,
+  source: "DuckDuckGo/Xignite",
+  raw: r
+});
+var duckStocks = tool3({
+  description: "A tool for fetching stock market quotes. Useful for when you need to get the latest stock price and related information for one or more stock symbols.",
+  inputSchema: z3.object({
+    symbols: z3.union([z3.string().min(1), z3.array(z3.string().min(1)).min(1)]).transform((s) => Array.isArray(s) ? s : [s]),
+    includeRaw: z3.boolean().default(false)
+  }),
+  execute: async ({ symbols, includeRaw }) => {
+    const tasks = symbols.map(async (s) => {
+      const sym = s.trim().toUpperCase();
+      try {
+        const r = await ddgStocks(sym);
+        if (!r || r.Outcome && r.Outcome !== "Success") {
+          return { symbol: sym, error: r?.Message || "No quote" };
+        }
+        const q = toQuote(r);
+        if (!includeRaw) delete q.raw;
+        return q;
+      } catch (e) {
+        return { symbol: sym, error: e?.message || "fetch_failed" };
+      }
+    });
+    const results = await Promise.all(tasks);
+    return { results };
+  }
+});
+
+// packages/toolbox/src/lib/scratchbad.ts
+import { tool as tool5 } from "ai";
+import z5 from "zod";
+
+// packages/agent/dist/index.js
+import {
+  Output as Output2,
+  dynamicTool,
+  generateText as generateText2,
+  jsonSchema,
+  stepCountIs as stepCountIs2,
+  tool as tool4
+} from "ai";
+import chalk2 from "chalk";
+import { snakecase } from "stringcase";
+import z4 from "zod";
+import dedent from "dedent";
+import {
+  generateId
+} from "ai";
+import { flow } from "lodash-es";
+import { createInterface } from "node:readline/promises";
+import { titlecase } from "stringcase";
+import { groq } from "@ai-sdk/groq";
+import {
+  NoSuchToolError,
+  Output,
+  convertToModelMessages,
+  createUIMessageStream,
+  generateId as generateId2,
+  generateText,
+  smoothStream,
+  stepCountIs,
+  streamText,
+  wrapLanguageModel
+} from "ai";
+import chalk from "chalk";
+import dedent2 from "dedent";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { createOpenAICompatible } from "@ai-sdk/openai-compatible";
+import { embedMany } from "ai";
+var RECOMMENDED_PROMPT_PREFIX = [
+  `# System context`,
+  `You are part of a multi-agent system called the DeepAgents SDK, designed to make agent coordination and execution easy.`,
+  `Agents uses two primary abstraction: **Agents** and **Handoffs**.`,
+  `An agent encompasses instructions and tools and can hand off a conversation to another agent when appropriate.`,
+  `Handoffs are achieved by calling a handoff function, generally named \`transfer_to_<agent_name>\`.`,
+  `Transfers between agents are handled seamlessly in the background; do not mention or draw attention to these transfers in your conversation with the user.`
+  // 'Do not pass context between agents. the agents already have the complete context without agent to agent communication.',
+  // From 4.1 beast mode
+  // `Please keep going until the user’s query is completely resolved, before ending your turn and yielding back to the user.`,
+  // `Your thinking should be thorough and so it's fine if it's very long. However, avoid unnecessary repetition and verbosity. You should be concise, but thorough.`,
+  // `You MUST iterate and keep going until the problem is solved.`,
+  // `You have everything you need to resolve this problem. I want you to fully solve this autonomously before coming back to me.`,
+  // `Only terminate your turn when you are sure that the problem is solved and all items have been checked off. Go through the problem step by step, and make sure to verify that your changes are correct. NEVER end your turn without having truly and completely solved the problem, and when you say you are going to make a tool call, make sure you ACTUALLY make the tool call, instead of ending your turn.`,
+  // `Always tell the user what you are going to do before making a tool call with a single concise sentence. This will help them understand what you are doing and why.`,
+  // `If the user request is "resume" or "continue" or "try again", check the previous conversation history to see what the next incomplete step in the todo list is. Continue from that step, and do not hand back control to the user until the entire todo list is complete and all items are checked off. Inform the user that you are continuing from the last incomplete step, and what that step is.`,
+  // `Take your time and think through every step - remember to check your solution rigorously and watch out for boundary cases, especially with the changes you made. Use the sequential thinking tool if available. Your solution must be perfect. If not, continue working on it. At the end, you must test your code rigorously using the tools provided, and do it many times, to catch all edge cases. If it is not robust, iterate more and make it perfect. Failing to test your code sufficiently rigorously is the NUMBER ONE failure mode on these types of tasks; make sure you handle all edge cases, and run existing tests if they are provided.`,
+  // `You MUST plan extensively before each function call, and reflect extensively on the outcomes of the previous function calls. DO NOT do this entire process by making function calls only, as this can impair your ability to solve the problem and think insightfully.`,
+  // `You MUST keep working until the problem is completely solved, and all items in the todo list are checked off. Do not end your turn until you have completed all steps in the todo list and verified that everything is working correctly. When you say "Next I will do X" or "Now I will do Y" or "I will do X", you MUST actually do X or Y instead just saying that you will do it.`,
+  // `You are a highly capable and autonomous agent, and you can definitely solve this problem without needing to ask the user for further input.`,
+].join("\n");
+var SUPERVISOR_PROMPT_PREFIX = dedent`
+# System Context
+You are part of a multi-agent system called the DeepAgents SDK, designed to facilitate agent coordination and execution.
+
+- The primary agent, known as the "Supervisor Agent," coordinates communication between specialized agents. The Supervisor Agent does not perform specialized tasks but acts as the central point for communication.
+- Specialized agents must transfer control back to the Supervisor Agent upon completing their tasks.
+
+**Core Directives:**
+- Begin with a concise checklist (3-7 bullets) of what you will do for each user query; items should be conceptual, not implementation-level.
+- Continue working until the user's query is completely resolved; only then yield control back to the user.
+- Your thinking must be thorough and step-by-step. Aim for completeness and rigor while avoiding unnecessary repetition and verbosity.
+- You must iterate and keep working until the problem is fully solved. You have all the requirements and information needed; solve the problem autonomously without user intervention.
+- Do not terminate your turn unless you are certain all issues are resolved and the entire todo list is complete and verified.
+- When making tool calls, explicitly state, in a single concise sentence, the purpose and minimal inputs for the action before executing it.
+- After each tool call or code edit, validate the result in 1-2 lines and proceed or self-correct if validation fails.
+- For requests such as "resume", "continue", or "try again":
+    - Check previous conversation history to determine the next incomplete todo step, continue from there, and do not return control until all items are complete.
+    - Inform the user you are resuming from the last incomplete step, and specify what that step is.
+- Take your time and rigorously check your solution, especially edge and boundary cases. Use sequential thinking tools when available. Your solution must be robust and perfect; continue iterating and retesting as needed.
+- Always test your code using all available tools and provided tests, with repetition as necessary to catch edge cases.
+- Plan extensively before each function/tool call and reflect thoroughly on previous actions before proceeding. Do not proceed solely by chaining function calls—use stepwise planning and reflection.
+- Explicitly complete every todo list item and confirm all steps are working before ending your turn. Always follow through on stated actions.
+- You are a highly capable, autonomous agent, and should not require additional user input to fully solve the task.
+`;
+function visualizeMermaid(root, options = {}) {
+  const { direction = "LR", showTools = true } = options;
+  const nodes = [];
+  const edges = [];
+  const seen = /* @__PURE__ */ new Set();
+  const nameToId = /* @__PURE__ */ new Map();
+  const sanitizeId = (name) => name.toLowerCase().replace(/[^a-z0-9]+/gi, "_").replace(/^_+|_+$/g, "");
+  const ensureNode = (agent2) => {
+    const name = agent2.handoff.name;
+    if (!nameToId.has(name)) {
+      const base = sanitizeId(name) || "agent";
+      let id = base;
+      let i = 1;
+      while (nodes.some((n) => n.id === id)) id = `${base}_${i++}`;
+      nameToId.set(name, id);
+      nodes.push({
+        id,
+        name,
+        tools: Object.keys(agent2.handoff.tools ?? {})
+      });
+    }
+    return nameToId.get(name);
+  };
+  const stack = [root];
+  while (stack.length) {
+    const current = stack.pop();
+    const currentName = current.handoff.name;
+    if (seen.has(currentName)) continue;
+    seen.add(currentName);
+    const fromId = ensureNode(current);
+    for (const child of current.toHandoffs()) {
+      const toId = ensureNode(child);
+      const label = Object.keys(child.handoffTool)[0].replace(
+        /transfer_to_/g,
+        ""
+      );
+      edges.push({ from: fromId, to: toId, label });
+      stack.push(child);
+    }
+  }
+  const lines = [];
+  lines.push(`flowchart ${direction}`);
+  for (const n of nodes) {
+    const name = titlecase(n.name.replace(/_agent/g, "").replace(/_/g, " "));
+    const toolLine = showTools && n.tools.length ? `<br/>tools: ${n.tools.map((it) => it.replace(/transfer_to_/g, "")).join(", ")}` : "";
+    lines.push(`${n.id}["${escapeLabel(`Agent: ${name}${toolLine}`)}"]`);
+  }
+  for (const e of edges) {
+    lines.push(`${e.from} -- ${escapeLabel(e.label)} --> ${e.to}`);
+  }
+  return lines.join("\n");
+}
+function escapeLabel(s) {
+  return s.replace(/"/g, '\\"');
+}
+function visualizeSemantic(root) {
+  const lines = [];
+  const seen = /* @__PURE__ */ new Set();
+  const stack = [root];
+  while (stack.length) {
+    const current = stack.pop();
+    const currentName = current.handoff.name;
+    if (seen.has(currentName)) continue;
+    seen.add(currentName);
+    const from = current.handoff.name;
+    const transfers = current.toHandoffs().map((h) => h.handoff.name);
+    const uniqueTransfers = Array.from(new Set(transfers));
+    const rhs = uniqueTransfers.length ? uniqueTransfers.join(", ") : "none";
+    lines.push(`${from} transfers to: ${rhs}`);
+    for (const child of current.toHandoffs()) stack.push(child);
+  }
+  return lines.join("\n");
+}
+function visualizeRichSemantic(root) {
+  const stack = [root];
+  const seen = /* @__PURE__ */ new Set();
+  const edgeSet = /* @__PURE__ */ new Set();
+  const edges = [];
+  while (stack.length) {
+    const current = stack.pop();
+    const from = current.handoff.name;
+    if (!seen.has(from)) {
+      seen.add(from);
+      for (const child of current.toHandoffs()) {
+        const to = child.handoff.name;
+        const key = `${from}->${to}`;
+        if (!edgeSet.has(key)) {
+          edgeSet.add(key);
+          edges.push({ from, to });
+        }
+        stack.push(child);
+      }
+    }
+  }
+  if (edges.length === 0) return `${root.handoff.name} \u2500\u2500\u25B6 none`;
+  return edges.map(({ from, to }) => `${from} \u2500\u2500\u25B6 ${to}`).join("\n");
+}
+function printChunk(chunk, options) {
+  const {
+    reasoning: includeReasoning,
+    wrapInTags,
+    text: includeText
+  } = options;
+  if (includeReasoning) {
+    if (chunk.type === "reasoning-start") {
+      process.stdout.write(`
+${wrapInTags ? "<reasoning>" : ""}
+`);
+    }
+    if (chunk.type === "reasoning-delta") {
+      process.stdout.write(chunk.delta);
+    }
+    if (chunk.type === "reasoning-end") {
+      process.stdout.write(`
+${wrapInTags ? "</reasoning>" : ""}
+`);
+    }
+  }
+  if (includeText) {
+    if (chunk.type === "text-start") {
+      process.stdout.write(`
+${wrapInTags ? "<text>" : ""}
+`);
+    }
+    if (chunk.type === "text-delta") {
+      process.stdout.write(chunk.delta);
+    }
+    if (chunk.type === "text-end") {
+      process.stdout.write(`
+${wrapInTags ? "</text>" : ""}
+`);
+    }
+  }
+}
+var printer = {
+  readableStream: async (stream2, options) => {
+    const includeReasoning = options?.reasoning ?? true;
+    const wrapInTags = options?.wrapInTags ?? true;
+    const includeText = options?.text ?? true;
+    for await (const chunk of stream2) {
+      printChunk(chunk, {
+        reasoning: includeReasoning,
+        wrapInTags,
+        text: includeText
+      });
+    }
+  },
+  stdout: async (response, options) => {
+    const includeReasoning = options?.reasoning ?? true;
+    const includeText = options?.text ?? true;
+    const wrapInTags = options?.wrapInTags ?? true;
+    for await (const chunk of response.toUIMessageStream()) {
+      printChunk(chunk, {
+        reasoning: includeReasoning,
+        text: includeText,
+        wrapInTags
+      });
+    }
+    console.log(await response.totalUsage);
+  },
+  mermaid: flow(visualizeMermaid, console.log),
+  semantic: flow(visualizeSemantic, console.log),
+  richSemantic: flow(visualizeRichSemantic, console.log)
+};
+function toState(options) {
+  return options.experimental_context;
+}
+var prepareStep = (agent2, model, contextVariables) => {
+  return async ({ steps, messages }) => {
+    const step = steps.at(-1);
+    const agentName = contextVariables.currentActiveAgent;
+    if (!step) {
+      return await prepareAgent(model, agent2, messages, contextVariables);
+    }
+    if (!agentName) {
+      return await prepareAgent(model, agent2, messages, contextVariables);
+    }
+    const nextAgent = findAgent(agent2, agentName);
+    if (!nextAgent) {
+      console.error(`Debug: ${chalk.red("NotFound")}: Agent ${agentName}`);
+      console.dir(
+        {
+          steps: steps.map(({ request, response, ...etc }) => etc),
+          messages
+        },
+        { depth: null }
+      );
+      return void 0;
+    }
+    return await prepareAgent(model, nextAgent, messages, contextVariables);
+  };
+};
+async function prepareAgent(defaultModel, agent2, messages, contextVariables) {
+  agent2.debug();
+  await agent2.prepareHandoff?.(messages);
+  let stepModel = agent2.model ?? defaultModel;
+  if (agent2.output) {
+    const json_schema = zodToJsonSchema(agent2.output, {
+      $refStrategy: "root"
+    });
+    stepModel = wrapLanguageModel({
+      model: stepModel,
+      middleware: {
+        transformParams: async ({ params }) => ({
+          ...params,
+          response_format: {
+            type: "json_schema",
+            json_schema,
+            name: `${agent2.handoff.name}_output`
+          }
+        })
+      }
+    });
+  }
+  return {
+    system: agent2.instructions(contextVariables),
+    activeTools: agent2.toolsNames,
+    model: stepModel,
+    messages,
+    // messages: removeTransferCalls(messages),
+    toolChoice: agent2.toolChoice
+  };
+}
+function findAgent(agent2, agentName) {
+  return [...agent2.toHandoffs(), agent2].find(
+    (it) => it.handoff.name === agentName
+  );
+}
+function agent(config) {
+  return new Agent(config);
+}
+var Agent = class _Agent {
+  model;
+  toolChoice;
+  parent;
+  handoffs;
+  prepareHandoff;
+  prepareEnd;
+  internalName;
+  handoff;
+  handoffToolName;
+  handoffTool;
+  output;
+  temperature;
+  constructor(config) {
+    this.model = config.model;
+    this.toolChoice = config.toolChoice || "auto";
+    this.handoffs = config.handoffs ?? [];
+    this.prepareHandoff = config.prepareHandoff;
+    this.prepareEnd = config.prepareEnd;
+    this.output = config.output;
+    this.temperature = config.temperature;
+    this.internalName = snakecase(config.name);
+    this.handoff = {
+      name: this.internalName,
+      instructions: config.prompt,
+      tools: config.tools ?? {},
+      handoffDescription: config.handoffDescription
+    };
+    this.handoffToolName = `transfer_to_${this.internalName}`;
+    this.handoffTool = {
+      [this.handoffToolName]: dynamicTool({
+        description: [
+          `An input/parameter/argument less tool to transfer control to the ${this.internalName} agent.`,
+          // `Handoff to the ${this.internalName} agent to handle the request`,
+          // `Do not include any parameters/inputs. The agent have access to all the context it needs.`,
+          config.handoffDescription
+        ].filter(Boolean).join(" "),
+        inputSchema: jsonSchema({
+          type: "object",
+          properties: {},
+          additionalProperties: true
+        }),
+        execute: async (_, options) => {
+          const state = toState(options);
+          state.currentActiveAgent = this.internalName;
+          return `Transfer successful to ${this.internalName}.`;
+        }
+      })
+    };
+  }
+  get transfer_tools() {
+    return Object.fromEntries(
+      this.toHandoffs().flatMap((it) => Object.entries(it.handoffTool))
+    );
+  }
+  get toolsNames() {
+    return [
+      // Note: do not add the handoff tool itself otherwise it'd create a agent recursion/loop
+      ...Object.keys(this.transfer_tools),
+      ...Object.keys(this.handoff.tools)
+    ];
+  }
+  #prepareInstructions(contextVariables) {
+    return [
+      typeof this.handoff.instructions === "function" ? this.handoff.instructions(contextVariables) : Array.isArray(this.handoff.instructions) ? this.handoff.instructions.join("\n") : this.handoff.instructions,
+      "",
+      ""
+    ].join("\n");
+  }
+  instructions(contextVariables) {
+    const text = this.#prepareInstructions(contextVariables);
+    const handoffsData = this.toHandoffs();
+    if (handoffsData.length === 0) {
+      return text.replace("<specialized_agents_placeholder>", " ");
+    }
+    const handoffs = [
+      "## Specialized Agents",
+      "| Agent Name | Agent Description |",
+      "| --- | --- |",
+      ...handoffsData.map(
+        (hf) => `| ${hf.handoff.name} | ${hf.handoff.handoffDescription || "No description available"} |`
+      ),
+      "",
+      ""
+    ].join("\n");
+    return text.replace("<specialized_agents_placeholder>", handoffs);
+  }
+  toHandoffs() {
+    const hfs = [];
+    for (const it of this.handoffs ?? []) {
+      const hf = typeof it === "function" ? it() : it;
+      hf.parent = this;
+      hfs.push(hf);
+    }
+    return hfs;
+  }
+  asTool(props) {
+    return tool4({
+      description: props?.toolDescription || this.handoff.handoffDescription,
+      inputSchema: z4.object({
+        input: z4.string()
+      }),
+      execute: async ({ input: input2 }, options) => {
+        try {
+          const result = await generateText2({
+            model: this.model,
+            system: this.#prepareInstructions(),
+            prompt: input2,
+            temperature: 0,
+            tools: this.handoff.tools,
+            abortSignal: options.abortSignal,
+            stopWhen: stepCountIs2(25),
+            experimental_context: options.experimental_context,
+            experimental_output: this.output ? Output2.object({ schema: this.output }) : void 0,
+            onStepFinish: (step) => {
+              const toolCall = step.toolCalls.at(-1);
+              if (toolCall) {
+                console.log(
+                  `Debug: ${chalk2.yellow("ToolCalled")}: ${toolCall.toolName}(${JSON.stringify(toolCall.input)})`
+                );
+              }
+            },
+            prepareStep: prepareStep(
+              this,
+              this.model,
+              options.experimental_context
+            )
+          });
+          if (props?.outputExtractor) {
+            return await props.outputExtractor(result);
+          }
+          return result.steps.map((it) => it.toolResults).flat();
+        } catch (error) {
+          console.error(error);
+          return `Error: ${JSON.stringify(error)}`;
+        }
+      }
+    });
+  }
+  toTool(props) {
+    return { [this.handoffToolName]: this.asTool(props) };
+  }
+  debug(prefix = "") {
+    console.log(
+      `Debug: ${chalk2.bgMagenta("Agent")}: ${chalk2.bold(this.handoff.name)}`
+    );
+    const transferTools = this.toolsNames.filter((toolName) => toolName.startsWith("transfer_to")).map((toolName) => toolName.replace("transfer_to_", ""));
+    const agentTools = this.toolsNames.filter(
+      (toolName) => !toolName.startsWith("transfer_to")
+    );
+    console.log(
+      `Debug: ${chalk2.blue("TransferTools")}: ${transferTools.length ? transferTools : "None"}`
+    );
+    console.log(
+      `Debug: ${chalk2.blue("Agent Tools")}: ${agentTools.length ? agentTools : "None"}`
+    );
+  }
+  toToolset(options) {
+    const tools = flattenTools(
+      this,
+      (node) => node.toHandoffs(),
+      (node) => node.handoff.tools
+    );
+    return {
+      ...Object.fromEntries(tools.flatMap((it) => Object.entries(it))),
+      ...options?.includeTransferTool !== false ? this.transfer_tools : {},
+      ...options?.includeHandoffs !== false ? this.handoffTool : {}
+    };
+  }
+  clone(agent2) {
+    return new _Agent({
+      prepareHandoff: (messages) => {
+        this.prepareHandoff?.(messages);
+      },
+      model: agent2?.model ?? this.model,
+      toolChoice: agent2?.toolChoice ?? this.toolChoice,
+      prompt: agent2?.prompt ?? this.handoff.instructions,
+      tools: agent2?.tools ?? this.handoff.tools,
+      name: agent2?.name ?? this.handoff.name,
+      handoffDescription: agent2?.handoffDescription ?? this.handoff.handoffDescription,
+      handoffs: [...this.handoffs],
+      output: agent2?.output ?? this.output
+    });
+  }
+};
+function flattenTools(root, getChildren, extract) {
+  const stack = [root];
+  const visited = /* @__PURE__ */ new Set();
+  const result = [];
+  while (stack.length) {
+    const node = stack.pop();
+    if (visited.has(node)) continue;
+    visited.add(node);
+    result.push(extract(node));
+    stack.push(...getChildren(node));
+  }
+  return result;
+}
+function instructions({ purpose, routine }) {
+  const lines = [
+    "# Agent Context",
+    ...Array.isArray(purpose) ? purpose : [purpose],
+    "",
+    "",
+    "<specialized_agents_placeholder>"
+  ];
+  if (routine.length) {
+    lines.push(
+      `Use the following routine to fulfill the task.`,
+      `# Routine`,
+      ...routine.map((it, i) => `${i + 1}. ${it}`)
+    );
+  }
+  return lines.join("\n");
+}
+instructions.swarm = ({ purpose, routine }) => {
+  const lines = [
+    RECOMMENDED_PROMPT_PREFIX,
+    "",
+    "",
+    "# Agent Context",
+    ...Array.isArray(purpose) ? purpose : [purpose],
+    "",
+    "",
+    "<specialized_agents_placeholder>"
+  ];
+  if (routine.length) {
+    lines.push(
+      `Use the following routine to fulfill the task.`,
+      `# Routine`,
+      ...routine.map((it, i) => `${i + 1}. ${it}`)
+    );
+  }
+  return lines.join("\n");
+};
+instructions.supervisor = ({
+  purpose,
+  routine
+}) => {
+  const lines = [
+    SUPERVISOR_PROMPT_PREFIX,
+    "",
+    "",
+    "# Agent Context",
+    ...Array.isArray(purpose) ? purpose : [purpose],
+    "",
+    "",
+    "<specialized_agents_placeholder>"
+  ];
+  if (routine.length) {
+    lines.push(
+      `Use the following routine to fulfill the task.`,
+      `# Routine`,
+      ...routine.filter(Boolean).map((it, i) => `${i + 1}. ${it}`)
+    );
+  }
+  return lines.join("\n");
+};
+instructions.supervisor_subagent = ({
+  purpose,
+  routine
+}) => {
+  const lines = [
+    SUPERVISOR_PROMPT_PREFIX,
+    "",
+    "",
+    "# Agent Context",
+    ...Array.isArray(purpose) ? purpose : [purpose],
+    ""
+  ];
+  if (routine.length) {
+    lines.push(
+      `Use the following routine to fulfill the task. Execute ALL steps immediately.`,
+      `# Routine`,
+      ...routine.map((it, i) => `${i + 1}. ${it}`),
+      `${routine.length + 1}. transfer_to_supervisor_agent`
+      // `1. IMMEDIATELY START: ${routine[0]}`,
+      // ...routine.slice(1).map((it, i) => `${i + 2}. ${it}`),
+      // `${routine.length + 1}. STOP HERE - Do not do any other agent's work`,
+      // `${routine.length + 2}. MANDATORY: You MUST call transfer_to_supervisor_agent function RIGHT NOW to return control`,
+      // `${routine.length + 3}. DO NOT END YOUR RESPONSE WITHOUT CALLING THE TRANSFER FUNCTION`,
+    );
+  } else {
+    lines.push(
+      "CRITICAL: end the generation by calling transfer_to_supervisor_agent tool"
+    );
+  }
+  return lines.join("\n");
+};
+var lmstudio = createOpenAICompatible({
+  name: "lmstudio",
+  baseURL: "http://127.0.0.1:1234/v1",
+  supportsStructuredOutputs: true,
+  includeUsage: true
+});
+var glm = createOpenAICompatible({
+  name: "z.ai",
+  baseURL: "https://api.z.ai/api/paas/v4/",
+  apiKey: process.env.ZAI_API_KEY
+});
+
+// packages/toolbox/src/lib/scratchbad.ts
+var scratchpad_tool = tool5({
+  description: `Tool for strategic reflection on research progress and decision-making.
+
+    Use this tool after each search to analyze results and plan next steps systematically.
+    This creates a deliberate pause in the research workflow for quality decision-making.
+
+    When to use:
+    - After receiving search results: What key information did I find?
+    - Before deciding next steps: Do I have enough to answer comprehensively?
+    - When assessing research gaps: What specific information am I still missing?
+    - Before concluding research: Can I provide a complete answer now?
+
+    Reflection should address:
+    1. Analysis of current findings - What concrete information have I gathered?
+    2. Gap assessment - What crucial information is still missing?
+    3. Quality evaluation - Do I have sufficient evidence/examples for a good answer?
+    4. Strategic decision - Should I continue searching or provide my answer?
+`,
+  inputSchema: z5.object({
+    reflection: z5.string().describe("Your detailed reflection on research progress.")
+  }),
+  execute: async ({ reflection }, options) => {
+    const context = toState(options);
+    context.scratchpad += `- ${reflection}
+`;
+    return `Reflection recorded. Current scratchpad now:
+---
+${context.scratchpad}`;
+  }
+});
+
+// packages/toolbox/src/lib/weather.ts
+import { tool as tool6 } from "ai";
+import { z as z6 } from "zod";
+var GetWeatherSchema = z6.object({
+  location: z6.string(),
+  unit: z6.enum(["C", "F"]),
+  temperature: z6.number(),
+  condition: z6.string(),
+  high: z6.number(),
+  low: z6.number(),
+  humidity: z6.number(),
+  windKph: z6.number(),
+  icon: z6.string().optional()
+});
+var getWeatherTool = tool6({
+  name: "weather",
+  description: "Get the current weather for a location.",
+  inputSchema: z6.object({
+    location: z6.string().describe("City name, address or coordinates"),
+    unit: z6.enum(["C", "F"]).default("C")
+  }),
+  outputSchema: GetWeatherSchema,
+  execute: async ({ location, unit }) => {
+    const { latitude, longitude, name } = await geocodeLocation(location);
+    const params = new URLSearchParams({
+      latitude: String(latitude),
+      longitude: String(longitude),
+      current: [
+        "temperature_2m",
+        "relative_humidity_2m",
+        "wind_speed_10m",
+        "weather_code"
+      ].join(","),
+      daily: ["temperature_2m_max", "temperature_2m_min"].join(","),
+      timezone: "auto",
+      temperature_unit: unit === "F" ? "fahrenheit" : "celsius",
+      wind_speed_unit: "kmh"
+    });
+    const url = `https://api.open-meteo.com/v1/forecast?${params.toString()}`;
+    const res = await fetch(url);
+    if (!res.ok) throw new Error(`Weather API failed: ${res.status}`);
+    const data = await res.json();
+    const current = data?.current;
+    const daily = data?.daily;
+    if (!current || !daily) throw new Error("Malformed weather API response");
+    const weatherCode = Number(current.weather_code);
+    const mapped = mapWeatherCode(weatherCode);
+    const result = {
+      location: name,
+      unit,
+      temperature: Math.round(Number(current.temperature_2m)),
+      condition: mapped.condition,
+      high: Math.round(Number(daily.temperature_2m_max?.[0])),
+      low: Math.round(Number(daily.temperature_2m_min?.[0])),
+      humidity: Math.max(
+        0,
+        Math.min(1, Number(current.relative_humidity_2m) / 100)
+      ),
+      windKph: Math.round(Number(current.wind_speed_10m)),
+      icon: mapped.icon
+    };
+    return result;
+  }
+});
+async function geocodeLocation(location) {
+  const coordMatch = location.trim().match(/^\s*(-?\d+(?:\.\d+)?)\s*,\s*(-?\d+(?:\.\d+)?)\s*$/);
+  if (coordMatch) {
+    const latitude = parseFloat(coordMatch[1]);
+    const longitude = parseFloat(coordMatch[2]);
+    return {
+      latitude,
+      longitude,
+      name: `${latitude.toFixed(3)}, ${longitude.toFixed(3)}`
+    };
+  }
+  const url = `https://geocoding-api.open-meteo.com/v1/search?name=${encodeURIComponent(
+    location
+  )}&count=1&language=en&format=json`;
+  const res = await fetch(url);
+  if (!res.ok) throw new Error(`Geocoding failed: ${res.status}`);
+  const data = await res.json();
+  const first = data?.results?.[0];
+  if (!first) throw new Error(`Location not found: ${location}`);
+  const nameParts = [first.name, first.admin1, first.country_code].filter(
+    Boolean
+  );
+  return {
+    latitude: first.latitude,
+    longitude: first.longitude,
+    name: nameParts.join(", ")
+  };
+}
+function mapWeatherCode(code) {
+  switch (code) {
+    case 0:
+      return { condition: "Clear sky", icon: "weather-sun" };
+    case 1:
+      return { condition: "Mainly clear", icon: "weather-sun" };
+    case 2:
+      return { condition: "Partly cloudy", icon: "weather-partly" };
+    case 3:
+      return { condition: "Overcast", icon: "weather-cloud" };
+    case 45:
+    case 48:
+      return { condition: "Fog", icon: "weather-fog" };
+    case 51:
+    case 53:
+    case 55:
+    case 56:
+    case 57:
+      return { condition: "Drizzle", icon: "weather-drizzle" };
+    case 61:
+    case 63:
+    case 65:
+    case 66:
+    case 67:
+      return { condition: "Rain", icon: "weather-rain" };
+    case 71:
+    case 73:
+    case 75:
+    case 77:
+      return { condition: "Snow", icon: "weather-snow" };
+    case 80:
+    case 81:
+    case 82:
+      return { condition: "Showers", icon: "weather-showers" };
+    case 85:
+    case 86:
+      return { condition: "Snow showers", icon: "weather-snow" };
+    case 95:
+    case 96:
+    case 99:
+      return { condition: "Thunderstorm", icon: "weather-thunder" };
+    default:
+      return { condition: "Unknown" };
+  }
+}
+
+// packages/toolbox/src/lib/web-search.ts
+import { groq as groq2 } from "@ai-sdk/groq";
+var web_search_tool = duckDuckGoSearch;
+var searchAgent = agent({
+  name: "research_agent",
+  model: groq2("openai/gpt-oss-20b"),
+  prompt: "You are a diligent research assistant. Your task is to gather accurate and relevant information on a given topic using web search. Use the browser_search tool to find up-to-date information, and synthesize your findings into a concise summary.",
+  tools: {
+    browser_search: duckDuckGoSearch
+  }
+});
+
+// packages/toolbox/src/lib/user-story-formatter.ts
+import { tool as tool7 } from "ai";
+import z7 from "zod";
+var AcceptanceCriteriaSchema = z7.object({
+  criterion: z7.string().describe("A specific, testable acceptance criterion")
+});
+var UserStorySchema = z7.object({
+  title: z7.string().describe("Clear, concise title for the user story"),
+  userRole: z7.string().describe('The user role or persona (e.g., "developer", "end user")'),
+  action: z7.string().describe("What the user wants to do"),
+  benefit: z7.string().describe("The value or benefit the user gets"),
+  acceptanceCriteria: z7.array(AcceptanceCriteriaSchema).describe("List of specific, testable conditions that must be met"),
+  technicalNotes: z7.string().optional().describe(
+    "Relevant files, components, or dependencies from the repository"
+  ),
+  priority: z7.enum(["High", "Medium", "Low"]).describe("Priority level based on complexity and dependencies"),
+  storyPoints: z7.enum(["1", "2", "3", "5", "8", "13"]).describe("Estimated complexity using Fibonacci sequence"),
+  epicOrFeature: z7.string().optional().describe("The epic or feature group this story belongs to")
+});
+var user_story_formatter_tool = tool7({
+  description: `Tool for formatting and recording user stories in a standardized format.
+
+    Use this tool to create well-structured user stories following product management best practices.
+    Each story should follow the format: "As a [role], I want to [action], so that [benefit]"
+
+    When to use:
+    - After analyzing a feature or component in the codebase
+    - When you've gathered enough information to write a complete user story
+    - To document findings in a structured, actionable format
+    - To maintain consistency across all generated user stories
+
+    The tool will:
+    1. Format the story in the standard user story template
+    2. Store it in the context for later synthesis
+    3. Return a formatted version for immediate review
+`,
+  inputSchema: UserStorySchema,
+  execute: async (story, options) => {
+    const context = toState(options);
+    context.userStories ??= [];
+    context.userStories.push(story);
+    const formatted = `
+## ${story.title}
+
+**User Story:**
+As a **${story.userRole}**, I want to **${story.action}**, so that **${story.benefit}**.
+
+**Acceptance Criteria:**
+${story.acceptanceCriteria.map((ac, i) => `${i + 1}. ${ac.criterion}`).join("\n")}
+
+**Technical Notes:**
+${story.technicalNotes || "N/A"}
+
+**Priority:** ${story.priority}
+**Story Points:** ${story.storyPoints}
+${story.epicOrFeature ? `**Epic/Feature:** ${story.epicOrFeature}` : ""}
+
+---
+`.trim();
+    return `User story recorded successfully!
+
+${formatted}
+
+Total stories recorded: ${context.userStories.length}`;
+  }
+});
+export {
+  GetWeatherSchema,
+  ddgSearchSchema,
+  duckDuckGoSearch,
+  duckStocks,
+  execute_os_command,
+  getWeatherTool,
+  scratchpad_tool,
+  searchAgent,
+  serp,
+  user_story_formatter_tool,
+  web_search_tool
+};
+//# sourceMappingURL=index.js.map