@deepagents/toolbox 0.1.2 → 0.2.0

package/dist/index.js

@@ -174,640 +174,10 @@ var duckStocks = tool3({
 });
 
 // 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 { tool as tool4 } from "ai";
 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;
-  providerOptions;
-  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.providerOptions = config.providerOptions;
-    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(),
-        output: z4.string().optional().describe(
-          "Optional instructions on how the final output should be formatted. this would be passed to the underlying llm as part of the prompt."
-        )
-      }),
-      execute: async ({ input: input2, output }, options) => {
-        try {
-          const result = await generateText2({
-            model: this.model,
-            system: this.#prepareInstructions(),
-            prompt: `
-              <Input>
-              ${input2}
-              </Input>
-              ${output ? `<OutputInstructions>
-${output}
-</OutputInstructions>` : ""}
-            `,
-            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 `An error thrown from a tool call. 
-<ErrorDetails>
-${JSON.stringify(error)}
-</ErrorDetails>`;
-        }
-      }
-    });
-  }
-  toTool(props) {
-    return { [this.handoffToolName]: this.asTool(props) };
-  }
-  debug(prefix = "") {
-    console.log(
-      `Debug: ${chalk2.bgMagenta("Agent")}: ${chalk2.dim.black(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({
+import { toState } from "@deepagents/agent";
+var scratchpad_tool = tool4({
   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.
@@ -825,8 +195,8 @@ var scratchpad_tool = tool5({
     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.")
+  inputSchema: z4.object({
+    reflection: z4.string().describe("Your detailed reflection on research progress.")
   }),
   execute: async ({ reflection }, options) => {
     const context = toState(options);
@@ -839,25 +209,25 @@ ${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()
+import { tool as tool5 } from "ai";
+import { z as z5 } from "zod";
+var GetWeatherSchema = z5.object({
+  location: z5.string(),
+  unit: z5.enum(["C", "F"]),
+  temperature: z5.number(),
+  condition: z5.string(),
+  high: z5.number(),
+  low: z5.number(),
+  humidity: z5.number(),
+  windKph: z5.number(),
+  icon: z5.string().optional()
 });
-var getWeatherTool = tool6({
+var getWeatherTool = tool5({
   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")
+  inputSchema: z5.object({
+    location: z5.string().describe("City name, address or coordinates"),
+    unit: z5.enum(["C", "F"]).default("C")
   }),
   outputSchema: GetWeatherSchema,
   execute: async ({ location, unit }) => {
@@ -977,11 +347,12 @@ function mapWeatherCode(code) {
 }
 
 // packages/toolbox/src/lib/web-search.ts
-import { groq as groq2 } from "@ai-sdk/groq";
+import { groq } from "@ai-sdk/groq";
+import { agent } from "@deepagents/agent";
 var web_search_tool = duckDuckGoSearch;
 var searchAgent = agent({
   name: "research_agent",
-  model: groq2("openai/gpt-oss-20b"),
+  model: groq("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
@@ -989,25 +360,26 @@ var searchAgent = agent({
 });
 
 // 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")
+import { tool as tool6 } from "ai";
+import z6 from "zod";
+import { toState as toState2 } from "@deepagents/agent";
+var AcceptanceCriteriaSchema = z6.object({
+  criterion: z6.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(
+var UserStorySchema = z6.object({
+  title: z6.string().describe("Clear, concise title for the user story"),
+  userRole: z6.string().describe('The user role or persona (e.g., "developer", "end user")'),
+  action: z6.string().describe("What the user wants to do"),
+  benefit: z6.string().describe("The value or benefit the user gets"),
+  acceptanceCriteria: z6.array(AcceptanceCriteriaSchema).describe("List of specific, testable conditions that must be met"),
+  technicalNotes: z6.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")
+  priority: z6.enum(["High", "Medium", "Low"]).describe("Priority level based on complexity and dependencies"),
+  storyPoints: z6.enum(["1", "2", "3", "5", "8", "13"]).describe("Estimated complexity using Fibonacci sequence"),
+  epicOrFeature: z6.string().optional().describe("The epic or feature group this story belongs to")
 });
-var user_story_formatter_tool = tool7({
+var user_story_formatter_tool = tool6({
   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.
@@ -1026,7 +398,7 @@ var user_story_formatter_tool = tool7({
 `,
   inputSchema: UserStorySchema,
   execute: async (story, options) => {
-    const context = toState(options);
+    const context = toState2(options);
     context.userStories ??= [];
     context.userStories.push(story);
     const formatted = `
@@ -1056,8 +428,9 @@ Total stories recorded: ${context.userStories.length}`;
 });
 
 // packages/toolbox/src/lib/hackernews-search.ts
-import { tool as tool8 } from "ai";
-import { z as z8 } from "zod";
+import { tool as tool7 } from "ai";
+import { z as z7 } from "zod";
+import { toState as toState3 } from "@deepagents/agent";
 function buildTags(options) {
   const tags = [];
   if (options.type && options.type !== "all") {
@@ -1371,21 +744,21 @@ function formatJobResults(response) {
 `;
   return header + results.join("\n");
 }
-var search_by_query = tool8({
+var search_by_query = tool7({
   description: "Tool to search HackerNews stories by keywords and filters. Use when you need to find HN stories matching specific search criteria, time periods, or popularity thresholds.",
-  inputSchema: z8.object({
-    query: z8.string().describe(
+  inputSchema: z7.object({
+    query: z7.string().describe(
       'Search query for story titles and content. Examples: "artificial intelligence", "python"'
     ),
-    timeFilter: z8.enum(["d", "w", "m", "y", "all"]).default("all").describe("Time filter: d=day, w=week, m=month, y=year, all=no filter"),
-    minPoints: z8.number().int().min(0).optional().describe("Minimum points threshold"),
-    minComments: z8.number().int().min(0).optional().describe("Minimum comments threshold"),
-    sortBy: z8.enum(["relevance", "date"]).default("relevance").describe("Sort results by relevance or date"),
-    page: z8.number().int().min(0).default(0).describe("Page number (0-indexed)"),
-    hitsPerPage: z8.number().int().min(1).max(1e3).default(20).describe("Results per page (max 1000)")
+    timeFilter: z7.enum(["d", "w", "m", "y", "all"]).default("all").describe("Time filter: d=day, w=week, m=month, y=year, all=no filter"),
+    minPoints: z7.number().int().min(0).optional().describe("Minimum points threshold"),
+    minComments: z7.number().int().min(0).optional().describe("Minimum comments threshold"),
+    sortBy: z7.enum(["relevance", "date"]).default("relevance").describe("Sort results by relevance or date"),
+    page: z7.number().int().min(0).default(0).describe("Page number (0-indexed)"),
+    hitsPerPage: z7.number().int().min(1).max(1e3).default(20).describe("Results per page (max 1000)")
   }),
   execute: async (input, options) => {
-    const context = toState(options);
+    const context = toState3(options);
     context.hackernews_sources ??= [];
     const numericFilters = buildNumericFilters({
       timeFilter: input.timeFilter,
@@ -1404,19 +777,19 @@ var search_by_query = tool8({
     return formatStoryResults(response);
   }
 });
-var search_by_author = tool8({
+var search_by_author = tool7({
   description: "Tool to search HackerNews content by author username. Use when you need to find all stories, comments, or both by a specific HN user.",
-  inputSchema: z8.object({
-    author: z8.string().describe('HackerNews username to search for. Examples: "pg", "tptacek"'),
-    type: z8.enum(["story", "comment", "all"]).default("all").describe("Type of content: story, comment, or all"),
-    timeFilter: z8.enum(["d", "w", "m", "y", "all"]).default("all").describe("Time filter: d=day, w=week, m=month, y=year, all=no filter"),
-    minComments: z8.number().int().min(0).optional().describe("Minimum comments threshold (for stories only)"),
-    sortBy: z8.enum(["relevance", "date"]).default("date").describe("Sort results by relevance or date"),
-    page: z8.number().int().min(0).default(0).describe("Page number (0-indexed)"),
-    hitsPerPage: z8.number().int().min(1).max(1e3).default(20).describe("Results per page (max 1000)")
+  inputSchema: z7.object({
+    author: z7.string().describe('HackerNews username to search for. Examples: "pg", "tptacek"'),
+    type: z7.enum(["story", "comment", "all"]).default("all").describe("Type of content: story, comment, or all"),
+    timeFilter: z7.enum(["d", "w", "m", "y", "all"]).default("all").describe("Time filter: d=day, w=week, m=month, y=year, all=no filter"),
+    minComments: z7.number().int().min(0).optional().describe("Minimum comments threshold (for stories only)"),
+    sortBy: z7.enum(["relevance", "date"]).default("date").describe("Sort results by relevance or date"),
+    page: z7.number().int().min(0).default(0).describe("Page number (0-indexed)"),
+    hitsPerPage: z7.number().int().min(1).max(1e3).default(20).describe("Results per page (max 1000)")
   }),
   execute: async (input, options) => {
-    const context = toState(options);
+    const context = toState3(options);
     context.hackernews_sources ??= [];
     const tags = buildTags({ type: input.type, author: input.author });
     const numericFilters = buildNumericFilters({
@@ -1434,13 +807,13 @@ var search_by_author = tool8({
     return formatAuthorResults(response);
   }
 });
-var get_story_item = tool8({
+var get_story_item = tool7({
   description: "Tool to get detailed information about a specific HackerNews story by ID. Use when you need full details about a particular HN story including title, URL, author, points, and comments.",
-  inputSchema: z8.object({
-    storyId: z8.string().describe('HackerNews story ID. Example: "38709478"')
+  inputSchema: z7.object({
+    storyId: z7.string().describe('HackerNews story ID. Example: "38709478"')
   }),
   execute: async (input, options) => {
-    const context = toState(options);
+    const context = toState3(options);
     context.hackernews_sources ??= [];
     const item = await fetchHNItem(input.storyId);
     if (item.type !== "story") {
@@ -1456,10 +829,10 @@ var get_story_item = tool8({
     return formatItemDetails(item);
   }
 });
-var get_story_comment = tool8({
+var get_story_comment = tool7({
   description: "Tool to get detailed information about a specific HackerNews comment by ID. Use when you need full details about a particular comment including text, author, and parent story information.",
-  inputSchema: z8.object({
-    commentId: z8.string().describe('HackerNews comment ID. Example: "38710123"')
+  inputSchema: z7.object({
+    commentId: z7.string().describe('HackerNews comment ID. Example: "38710123"')
   }),
   execute: async (input) => {
     const item = await fetchHNItem(input.commentId);
@@ -1471,14 +844,14 @@ var get_story_comment = tool8({
     return formatItemDetails(item);
   }
 });
-var get_front_page_stories = tool8({
+var get_front_page_stories = tool7({
   description: "Tool to get current HackerNews front page stories. Use when you need to see the latest trending and popular stories on HN.",
-  inputSchema: z8.object({
-    page: z8.number().int().min(0).default(0).describe("Page number (0-indexed)"),
-    hitsPerPage: z8.number().int().min(1).max(50).default(30).describe("Results per page (max 50)")
+  inputSchema: z7.object({
+    page: z7.number().int().min(0).default(0).describe("Page number (0-indexed)"),
+    hitsPerPage: z7.number().int().min(1).max(50).default(30).describe("Results per page (max 50)")
   }),
   execute: async (input, options) => {
-    const context = toState(options);
+    const context = toState3(options);
     context.hackernews_sources ??= [];
     const response = await searchHackerNewsAPI({
       tags: "front_page",
@@ -1490,13 +863,13 @@ var get_front_page_stories = tool8({
     return formatStoryResults(response);
   }
 });
-var get_story_comments = tool8({
+var get_story_comments = tool7({
   description: "Tool to get all comments for a specific HackerNews story. Use when you need to read the discussion and comments on a particular HN story.",
-  inputSchema: z8.object({
-    storyId: z8.string().describe('HackerNews story ID. Example: "38709478"'),
-    sortBy: z8.enum(["relevance", "date"]).default("date").describe("Sort comments by relevance or date"),
-    page: z8.number().int().min(0).default(0).describe("Page number (0-indexed)"),
-    hitsPerPage: z8.number().int().min(1).max(1e3).default(50).describe("Results per page (max 1000)")
+  inputSchema: z7.object({
+    storyId: z7.string().describe('HackerNews story ID. Example: "38709478"'),
+    sortBy: z7.enum(["relevance", "date"]).default("date").describe("Sort comments by relevance or date"),
+    page: z7.number().int().min(0).default(0).describe("Page number (0-indexed)"),
+    hitsPerPage: z7.number().int().min(1).max(1e3).default(50).describe("Results per page (max 1000)")
   }),
   execute: async (input) => {
     const response = await searchHackerNewsAPI({
@@ -1508,21 +881,21 @@ var get_story_comments = tool8({
     return formatCommentResults(response);
   }
 });
-var search_ask_hn = tool8({
+var search_ask_hn = tool7({
   description: "Tool to search Ask HN posts - questions posed to the HackerNews community. Use when you need to find community questions and discussions on specific topics.",
-  inputSchema: z8.object({
-    query: z8.string().default("").describe(
+  inputSchema: z7.object({
+    query: z7.string().default("").describe(
       'Search query for Ask HN posts. Examples: "artificial intelligence", "career"'
     ),
-    timeFilter: z8.enum(["d", "w", "m", "y", "all"]).default("all").describe("Time filter: d=day, w=week, m=month, y=year, all=no filter"),
-    minPoints: z8.number().int().min(0).optional().describe("Minimum points threshold"),
-    minComments: z8.number().int().min(0).optional().describe("Minimum comments threshold"),
-    sortBy: z8.enum(["relevance", "date"]).default("relevance").describe("Sort by relevance or date"),
-    page: z8.number().int().min(0).default(0).describe("Page number (0-indexed)"),
-    hitsPerPage: z8.number().int().min(1).max(1e3).default(20).describe("Results per page (max 1000)")
+    timeFilter: z7.enum(["d", "w", "m", "y", "all"]).default("all").describe("Time filter: d=day, w=week, m=month, y=year, all=no filter"),
+    minPoints: z7.number().int().min(0).optional().describe("Minimum points threshold"),
+    minComments: z7.number().int().min(0).optional().describe("Minimum comments threshold"),
+    sortBy: z7.enum(["relevance", "date"]).default("relevance").describe("Sort by relevance or date"),
+    page: z7.number().int().min(0).default(0).describe("Page number (0-indexed)"),
+    hitsPerPage: z7.number().int().min(1).max(1e3).default(20).describe("Results per page (max 1000)")
   }),
   execute: async (input, options) => {
-    const context = toState(options);
+    const context = toState3(options);
     context.hackernews_sources ??= [];
     const numericFilters = buildNumericFilters({
       timeFilter: input.timeFilter,
@@ -1541,21 +914,21 @@ var search_ask_hn = tool8({
     return formatStoryResults(response);
   }
 });
-var search_show_hn = tool8({
+var search_show_hn = tool7({
   description: "Tool to search Show HN posts - projects and products shared with the HackerNews community. Use when you need to discover community projects, demos, or products on specific topics.",
-  inputSchema: z8.object({
-    query: z8.string().default("").describe(
+  inputSchema: z7.object({
+    query: z7.string().default("").describe(
       'Search query for Show HN posts. Examples: "web app", "open source"'
     ),
-    timeFilter: z8.enum(["d", "w", "m", "y", "all"]).default("all").describe("Time filter: d=day, w=week, m=month, y=year, all=no filter"),
-    minPoints: z8.number().int().min(0).optional().describe("Minimum points threshold"),
-    minComments: z8.number().int().min(0).optional().describe("Minimum comments threshold"),
-    sortBy: z8.enum(["relevance", "date"]).default("relevance").describe("Sort by relevance or date"),
-    page: z8.number().int().min(0).default(0).describe("Page number (0-indexed)"),
-    hitsPerPage: z8.number().int().min(1).max(1e3).default(20).describe("Results per page (max 1000)")
+    timeFilter: z7.enum(["d", "w", "m", "y", "all"]).default("all").describe("Time filter: d=day, w=week, m=month, y=year, all=no filter"),
+    minPoints: z7.number().int().min(0).optional().describe("Minimum points threshold"),
+    minComments: z7.number().int().min(0).optional().describe("Minimum comments threshold"),
+    sortBy: z7.enum(["relevance", "date"]).default("relevance").describe("Sort by relevance or date"),
+    page: z7.number().int().min(0).default(0).describe("Page number (0-indexed)"),
+    hitsPerPage: z7.number().int().min(1).max(1e3).default(20).describe("Results per page (max 1000)")
   }),
   execute: async (input, options) => {
-    const context = toState(options);
+    const context = toState3(options);
     context.hackernews_sources ??= [];
     const numericFilters = buildNumericFilters({
       timeFilter: input.timeFilter,
@@ -1574,19 +947,19 @@ var search_show_hn = tool8({
     return formatStoryResults(response);
   }
 });
-var search_jobs = tool8({
+var search_jobs = tool7({
   description: "Tool to search HackerNews job postings. Use when you need to find tech job opportunities posted on HN.",
-  inputSchema: z8.object({
-    query: z8.string().default("").describe(
+  inputSchema: z7.object({
+    query: z7.string().default("").describe(
       'Search query for job postings. Examples: "remote", "machine learning"'
     ),
-    timeFilter: z8.enum(["d", "w", "m", "y", "all"]).default("all").describe("Time filter: d=day, w=week, m=month, y=year, all=no filter"),
-    sortBy: z8.enum(["relevance", "date"]).default("date").describe("Sort by relevance or date"),
-    page: z8.number().int().min(0).default(0).describe("Page number (0-indexed)"),
-    hitsPerPage: z8.number().int().min(1).max(1e3).default(20).describe("Results per page (max 1000)")
+    timeFilter: z7.enum(["d", "w", "m", "y", "all"]).default("all").describe("Time filter: d=day, w=week, m=month, y=year, all=no filter"),
+    sortBy: z7.enum(["relevance", "date"]).default("date").describe("Sort by relevance or date"),
+    page: z7.number().int().min(0).default(0).describe("Page number (0-indexed)"),
+    hitsPerPage: z7.number().int().min(1).max(1e3).default(20).describe("Results per page (max 1000)")
   }),
   execute: async (input, options) => {
-    const context = toState(options);
+    const context = toState3(options);
     context.hackernews_sources ??= [];
     const numericFilters = buildNumericFilters({
       timeFilter: input.timeFilter
@@ -1603,17 +976,17 @@ var search_jobs = tool8({
     return formatJobResults(response);
   }
 });
-var search_polls = tool8({
+var search_polls = tool7({
   description: "Tool to search HackerNews polls - community surveys and voting. Use when you need to find community polls on various topics.",
-  inputSchema: z8.object({
-    query: z8.string().default("").describe('Search query for polls. Example: "programming language"'),
-    timeFilter: z8.enum(["d", "w", "m", "y", "all"]).default("all").describe("Time filter: d=day, w=week, m=month, y=year, all=no filter"),
-    sortBy: z8.enum(["relevance", "date"]).default("date").describe("Sort by relevance or date"),
-    page: z8.number().int().min(0).default(0).describe("Page number (0-indexed)"),
-    hitsPerPage: z8.number().int().min(1).max(1e3).default(20).describe("Results per page (max 1000)")
+  inputSchema: z7.object({
+    query: z7.string().default("").describe('Search query for polls. Example: "programming language"'),
+    timeFilter: z7.enum(["d", "w", "m", "y", "all"]).default("all").describe("Time filter: d=day, w=week, m=month, y=year, all=no filter"),
+    sortBy: z7.enum(["relevance", "date"]).default("date").describe("Sort by relevance or date"),
+    page: z7.number().int().min(0).default(0).describe("Page number (0-indexed)"),
+    hitsPerPage: z7.number().int().min(1).max(1e3).default(20).describe("Results per page (max 1000)")
   }),
   execute: async (input, options) => {
-    const context = toState(options);
+    const context = toState3(options);
     context.hackernews_sources ??= [];
     const numericFilters = buildNumericFilters({
       timeFilter: input.timeFilter
@@ -1630,29 +1003,29 @@ var search_polls = tool8({
     return formatStoryResults(response);
   }
 });
-var get_user_profile = tool8({
+var get_user_profile = tool7({
   description: "Tool to get HackerNews user profile information. Use when you need to view a user's karma, account creation date, and bio.",
-  inputSchema: z8.object({
-    username: z8.string().describe('HackerNews username. Example: "pg"')
+  inputSchema: z7.object({
+    username: z7.string().describe('HackerNews username. Example: "pg"')
   }),
   execute: async (input) => {
     const user = await fetchHNUser(input.username);
     return formatUserProfile(user);
   }
 });
-var search_by_domain = tool8({
+var search_by_domain = tool7({
   description: "Tool to search HackerNews stories from a specific domain or website. Use when you need to find all HN posts from a particular domain or track discussions about content from specific websites.",
-  inputSchema: z8.object({
-    domain: z8.string().describe('Domain to search. Examples: "github.com", "arxiv.org"'),
-    timeFilter: z8.enum(["d", "w", "m", "y", "all"]).default("all").describe("Time filter: d=day, w=week, m=month, y=year, all=no filter"),
-    minPoints: z8.number().int().min(0).optional().describe("Minimum points threshold"),
-    minComments: z8.number().int().min(0).optional().describe("Minimum comments threshold"),
-    sortBy: z8.enum(["relevance", "date"]).default("date").describe("Sort by relevance or date"),
-    page: z8.number().int().min(0).default(0).describe("Page number (0-indexed)"),
-    hitsPerPage: z8.number().int().min(1).max(1e3).default(20).describe("Results per page (max 1000)")
+  inputSchema: z7.object({
+    domain: z7.string().describe('Domain to search. Examples: "github.com", "arxiv.org"'),
+    timeFilter: z7.enum(["d", "w", "m", "y", "all"]).default("all").describe("Time filter: d=day, w=week, m=month, y=year, all=no filter"),
+    minPoints: z7.number().int().min(0).optional().describe("Minimum points threshold"),
+    minComments: z7.number().int().min(0).optional().describe("Minimum comments threshold"),
+    sortBy: z7.enum(["relevance", "date"]).default("date").describe("Sort by relevance or date"),
+    page: z7.number().int().min(0).default(0).describe("Page number (0-indexed)"),
+    hitsPerPage: z7.number().int().min(1).max(1e3).default(20).describe("Results per page (max 1000)")
   }),
   execute: async (input, options) => {
-    const context = toState(options);
+    const context = toState3(options);
     context.hackernews_sources ??= [];
     const numericFilters = buildNumericFilters({
       timeFilter: input.timeFilter,
@@ -1683,21 +1056,21 @@ var search_by_domain = tool8({
     return formatStoryResults(data);
   }
 });
-var search_highly_discussed = tool8({
+var search_highly_discussed = tool7({
   description: "Tool to search for highly discussed HackerNews stories with many comments. Use when you need to find engaging or controversial discussions with significant community participation.",
-  inputSchema: z8.object({
-    minComments: z8.number().int().min(1).describe(
+  inputSchema: z7.object({
+    minComments: z7.number().int().min(1).describe(
       "Minimum number of comments (required). Example: 100 for highly discussed stories"
     ),
-    query: z8.string().default("").describe('Optional search query. Example: "AI"'),
-    timeFilter: z8.enum(["d", "w", "m", "y", "all"]).default("all").describe("Time filter: d=day, w=week, m=month, y=year, all=no filter"),
-    minPoints: z8.number().int().min(0).optional().describe("Minimum points threshold"),
-    sortBy: z8.enum(["relevance", "date"]).default("date").describe("Sort by relevance or date"),
-    page: z8.number().int().min(0).default(0).describe("Page number (0-indexed)"),
-    hitsPerPage: z8.number().int().min(1).max(1e3).default(20).describe("Results per page (max 1000)")
+    query: z7.string().default("").describe('Optional search query. Example: "AI"'),
+    timeFilter: z7.enum(["d", "w", "m", "y", "all"]).default("all").describe("Time filter: d=day, w=week, m=month, y=year, all=no filter"),
+    minPoints: z7.number().int().min(0).optional().describe("Minimum points threshold"),
+    sortBy: z7.enum(["relevance", "date"]).default("date").describe("Sort by relevance or date"),
+    page: z7.number().int().min(0).default(0).describe("Page number (0-indexed)"),
+    hitsPerPage: z7.number().int().min(1).max(1e3).default(20).describe("Results per page (max 1000)")
   }),
   execute: async (input, options) => {
-    const context = toState(options);
+    const context = toState3(options);
     context.hackernews_sources ??= [];
     const numericFilters = buildNumericFilters({
       timeFilter: input.timeFilter,
@@ -1716,20 +1089,20 @@ var search_highly_discussed = tool8({
     return formatStoryResults(response);
   }
 });
-var search_trending = tool8({
+var search_trending = tool7({
   description: "Tool to find currently trending HackerNews stories - recent posts with high engagement. Use when you need to discover what's hot right now on HN by combining recency with high points and comments.",
-  inputSchema: z8.object({
-    minPoints: z8.number().int().min(10).default(50).describe(
+  inputSchema: z7.object({
+    minPoints: z7.number().int().min(10).default(50).describe(
       "Minimum points threshold. Example: 100 for highly upvoted stories"
     ),
-    maxAgeHours: z8.number().int().min(1).max(72).default(24).describe("Maximum age in hours. Example: 24 for stories from today"),
-    minComments: z8.number().int().min(0).default(10).describe("Minimum comments threshold"),
-    sortBy: z8.enum(["relevance", "date"]).default("date").describe("Sort by relevance or date"),
-    page: z8.number().int().min(0).default(0).describe("Page number (0-indexed)"),
-    hitsPerPage: z8.number().int().min(1).max(100).default(30).describe("Results per page (max 100)")
+    maxAgeHours: z7.number().int().min(1).max(72).default(24).describe("Maximum age in hours. Example: 24 for stories from today"),
+    minComments: z7.number().int().min(0).default(10).describe("Minimum comments threshold"),
+    sortBy: z7.enum(["relevance", "date"]).default("date").describe("Sort by relevance or date"),
+    page: z7.number().int().min(0).default(0).describe("Page number (0-indexed)"),
+    hitsPerPage: z7.number().int().min(1).max(100).default(30).describe("Results per page (max 100)")
   }),
   execute: async (input, options) => {
-    const context = toState(options);
+    const context = toState3(options);
     context.hackernews_sources ??= [];
     const numericFilters = buildNumericFilters({
       maxAgeHours: input.maxAgeHours,