@deepagents/toolbox 0.18.0 → 0.20.0

package/dist/index.js

@@ -173,264 +173,196 @@ var duckStocks = tool3({
   }
 });
 
-// packages/toolbox/src/lib/scratchbad.ts
-import { tool as tool4 } from "ai";
+// packages/toolbox/src/lib/filesystem.ts
+import { dynamicTool, jsonSchema, tool as tool4 } from "ai";
+import FastGlob from "fast-glob";
+import spawn2 from "nano-spawn";
+import { readFile, readdir, stat } from "node:fs/promises";
+import { basename, join, relative } from "node:path";
 import z4 from "zod";
-import { toState } from "@deepagents/agent";
-var scratchpad_tool = tool4({
-  description: `Tool for strategic reflection on research progress and decision-making.
+import { fastembed, nodeSQLite, similaritySearch } from "@deepagents/retrieval";
+import * as connectors from "@deepagents/retrieval/connectors";
+import { ignorePatterns } from "@deepagents/retrieval/connectors";
 
-    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?
+// packages/toolbox/src/lib/state.ts
+function toState(options) {
+  return options.experimental_context;
+}
 
-    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?
-`,
+// packages/toolbox/src/lib/filesystem.ts
+var read_file_tool = tool4({
+  description: `Use this tool to read a file from the filesystem. Supports reading entire files or specific line ranges.`,
   inputSchema: z4.object({
-    reflection: z4.string().describe("Your detailed reflection on research progress.")
+    filePath: z4.string().min(1),
+    lineStart: z4.coerce.number().int().positive().optional().describe(
+      "Starting line number (1-indexed). If omitted, reads from the beginning."
+    ),
+    lineEnd: z4.coerce.number().int().positive().optional().describe(
+      "Ending line number (1-indexed). If omitted, reads to the end. Maximum 200 lines can be read at once."
+    )
   }),
-  execute: async ({ reflection }, options) => {
+  execute: async ({ filePath, lineStart, lineEnd }, options) => {
     const context = toState(options);
-    context.scratchpad += `- ${reflection}
-`;
-    return `Reflection recorded. Current scratchpad now:
----
-${context.scratchpad}`;
+    const fullPath = join(context.repo_path, filePath);
+    const stats = await stat(fullPath);
+    const maxSize = 100 * 1024;
+    if (stats.size > maxSize) {
+      return `File too large to read (size: ${stats.size} bytes, max: ${maxSize} bytes)`;
+    }
+    try {
+      const content = await readFile(fullPath, "utf-8");
+      if (!lineStart && !lineEnd) {
+        return content;
+      }
+      const lines = content.split("\n");
+      const start = (lineStart ?? 1) - 1;
+      const end = lineEnd ?? lines.length;
+      if (start < 0 || start >= lines.length) {
+        return `Invalid lineStart: ${lineStart}. File has ${lines.length} lines.`;
+      }
+      if (end < start) {
+        return `Invalid range: lineEnd (${lineEnd}) must be >= lineStart (${lineStart})`;
+      }
+      const maxLines = 200;
+      const requestedLines = end - start;
+      if (requestedLines > maxLines) {
+        return `Too many lines requested (${requestedLines}). Maximum is ${maxLines} lines.`;
+      }
+      return lines.slice(start, end).join("\n");
+    } catch (error) {
+      console.error("Error reading file:", error);
+      return `Error reading file: ${JSON.stringify(error)}`;
+    }
   }
 });
-
-// packages/toolbox/src/lib/weather.ts
-import { tool as tool5 } from "ai";
-import { z as z5 } from "zod";
-var GetWeatherInputSchema = z5.object({
-  location: z5.string().describe("City name, address or coordinates"),
-  unit: z5.enum(["C", "F"]).default("C")
-});
-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 read_dir_tool = tool4({
+  description: "Use this tool to list files in a directory.",
+  inputSchema: z4.object({
+    dir_path: z4.string().min(1).optional().default("./").describe('Relative path to the directory. Defaults to "./"')
+  }),
+  execute: async ({ dir_path }, options) => {
+    const context = toState(options);
+    return readdir(join(context.repo_path, dir_path), "utf-8");
+  }
 });
-var getWeatherTool = tool5({
-  description: "Get the current weather for a location.",
-  inputSchema: GetWeatherInputSchema,
-  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"
+var glob_tool = tool4({
+  description: `Use this tool to list files in a directory.
+			This tool returns only direct files and directories that match the provided glob pattern.
+			Make sure not to look for framework generated files, such as ios/android folders in a react native project or .next in a nextjs project and so on.
+			`,
+  inputSchema: z4.object({
+    pattern: z4.string().min(1).describe("A glob pattern to match files. ")
+  }),
+  execute: async ({ pattern }, options) => {
+    const context = toState(options);
+    const files = await FastGlob(pattern, {
+      dot: true,
+      cwd: context.repo_path,
+      unique: true,
+      deep: 1,
+      followSymbolicLinks: false,
+      ignore: await ignorePatterns(context.repo_path)
     });
-    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;
+    return files;
   }
 });
-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 } from "@ai-sdk/groq";
-import { agent } from "@deepagents/agent";
-var web_search_tool = duckDuckGoSearch;
-var searchAgent = agent({
-  name: "research_agent",
-  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
+var search_files_tool = tool4({
+  description: "Search for files in the repository by name or extension. Returns relative file paths. Avoids framework-generated and ignored paths.",
+  inputSchema: z4.object({
+    pattern: z4.string().min(1).describe("A glob pattern to match files."),
+    max_results: z4.number().int().positive().max(500).optional().default(100),
+    depth: z4.number().int().describe("Max directory depth to search. defaults to 31.")
+  }),
+  execute: async ({ pattern, max_results = 100, depth }, options) => {
+    const context = toState(options);
+    const ignore = await ignorePatterns(context.repo_path);
+    const files = await FastGlob(pattern, {
+      dot: false,
+      cwd: context.repo_path,
+      unique: true,
+      deep: depth,
+      followSymbolicLinks: false,
+      ignore
+    });
+    return files.slice(0, max_results);
   }
 });
-
-// packages/toolbox/src/lib/user-story-formatter.ts
-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 = 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: 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 file_exists_tool = tool4({
+  description: "Check if a file exists in the repository.",
+  inputSchema: z4.object({ filePath: z4.string().min(1) }),
+  execute: async ({ filePath }, options) => {
+    const context = toState(options);
+    return stat(join(context.repo_path, filePath)).then(() => true).catch(() => false);
+  }
 });
-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.
-    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 = toState2(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}`;
+var search_content_tool = dynamicTool({
+  description: `Use this tool to search the content of files in the repository. this tool is backed by a vector database and uses semantic search to find the most relevant snippets of content.`,
+  // inputSchema: z.object({
+  //   query: z.string().min(1).describe('The search query.'),
+  // }),
+  inputSchema: jsonSchema({
+    additionalProperties: true,
+    type: "object",
+    properties: {
+      query: {
+        type: "string",
+        description: "The search query."
+      }
+    }
+  }),
+  async execute(input, options) {
+    const keys = Object.keys(input).filter((k) => k !== "query");
+    if (keys.length > 0) {
+      return `Invalid input: only "query" is supported. Found extra keys: ${keys.join(", ")}`;
+    }
+    if (typeof input.query !== "string" || input.query.trim().length === 0) {
+      return 'Invalid input: "query" must be a non-empty string.';
+    }
+    try {
+      const context = toState(options);
+      const results = await similaritySearch(input.query, {
+        connector: connectors.repo(
+          context.repo_path,
+          [".ts", ".tsx", ".md", ".prisma"],
+          "never"
+        ),
+        store: nodeSQLite("deepsearch.sqlite", 384),
+        embedder: fastembed()
+      });
+      const contents = results.map((it) => {
+        const source = relative(context.repo_path, it.document_id);
+        const filename = basename(source);
+        return {
+          source,
+          snippet: it.content,
+          citation: `[${filename}](./${source})`
+        };
+      });
+      return contents.map(
+        (it) => [
+          `File: ${it.source}`,
+          `Citation: ${it.citation}`,
+          "```",
+          it.snippet,
+          "```"
+        ].join("\n")
+      ).join("\n\n------\n\n");
+    } catch (error) {
+      console.error("Error in search_content_tool:", error);
+      return `Error during content search: ${JSON.stringify(error)}`;
+    }
   }
 });
+async function repoTree(dir_path) {
+  const result = await spawn2("git", ["ls-tree", "-r", "HEAD", "--name-only"], {
+    cwd: dir_path
+  }).pipe("tree", ["--fromfile"]);
+  return result.output;
+}
 
 // packages/toolbox/src/lib/hackernews-search.ts
-import { tool as tool7 } from "ai";
-import { z as z7 } from "zod";
-import { toState as toState3 } from "@deepagents/agent";
+import { tool as tool5 } from "ai";
+import { z as z5 } from "zod";
 function buildTags(options) {
   const tags = [];
   if (options.type && options.type !== "all") {
@@ -744,21 +676,21 @@ function formatJobResults(response) {
 `;
   return header + results.join("\n");
 }
-var search_by_query = tool7({
+var search_by_query = tool5({
   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: z7.object({
-    query: z7.string().describe(
+  inputSchema: z5.object({
+    query: z5.string().describe(
       'Search query for story titles and content. Examples: "artificial intelligence", "python"'
     ),
-    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)")
+    timeFilter: z5.enum(["d", "w", "m", "y", "all"]).default("all").describe("Time filter: d=day, w=week, m=month, y=year, all=no filter"),
+    minPoints: z5.number().int().min(0).optional().describe("Minimum points threshold"),
+    minComments: z5.number().int().min(0).optional().describe("Minimum comments threshold"),
+    sortBy: z5.enum(["relevance", "date"]).default("relevance").describe("Sort results by relevance or date"),
+    page: z5.number().int().min(0).default(0).describe("Page number (0-indexed)"),
+    hitsPerPage: z5.number().int().min(1).max(1e3).default(20).describe("Results per page (max 1000)")
   }),
   execute: async (input, options) => {
-    const context = toState3(options);
+    const context = toState(options);
     context.hackernews_sources ??= [];
     const numericFilters = buildNumericFilters({
       timeFilter: input.timeFilter,
@@ -777,19 +709,19 @@ var search_by_query = tool7({
     return formatStoryResults(response);
   }
 });
-var search_by_author = tool7({
+var search_by_author = tool5({
   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: 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)")
+  inputSchema: z5.object({
+    author: z5.string().describe('HackerNews username to search for. Examples: "pg", "tptacek"'),
+    type: z5.enum(["story", "comment", "all"]).default("all").describe("Type of content: story, comment, or all"),
+    timeFilter: z5.enum(["d", "w", "m", "y", "all"]).default("all").describe("Time filter: d=day, w=week, m=month, y=year, all=no filter"),
+    minComments: z5.number().int().min(0).optional().describe("Minimum comments threshold (for stories only)"),
+    sortBy: z5.enum(["relevance", "date"]).default("date").describe("Sort results by relevance or date"),
+    page: z5.number().int().min(0).default(0).describe("Page number (0-indexed)"),
+    hitsPerPage: z5.number().int().min(1).max(1e3).default(20).describe("Results per page (max 1000)")
   }),
   execute: async (input, options) => {
-    const context = toState3(options);
+    const context = toState(options);
     context.hackernews_sources ??= [];
     const tags = buildTags({ type: input.type, author: input.author });
     const numericFilters = buildNumericFilters({
@@ -807,13 +739,13 @@ var search_by_author = tool7({
     return formatAuthorResults(response);
   }
 });
-var get_story_item = tool7({
+var get_story_item = tool5({
   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: z7.object({
-    storyId: z7.string().describe('HackerNews story ID. Example: "38709478"')
+  inputSchema: z5.object({
+    storyId: z5.string().describe('HackerNews story ID. Example: "38709478"')
   }),
   execute: async (input, options) => {
-    const context = toState3(options);
+    const context = toState(options);
     context.hackernews_sources ??= [];
     const item = await fetchHNItem(input.storyId);
     if (item.type !== "story") {
@@ -829,10 +761,10 @@ var get_story_item = tool7({
     return formatItemDetails(item);
   }
 });
-var get_story_comment = tool7({
+var get_story_comment = tool5({
   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: z7.object({
-    commentId: z7.string().describe('HackerNews comment ID. Example: "38710123"')
+  inputSchema: z5.object({
+    commentId: z5.string().describe('HackerNews comment ID. Example: "38710123"')
   }),
   execute: async (input) => {
     const item = await fetchHNItem(input.commentId);
@@ -844,14 +776,14 @@ var get_story_comment = tool7({
     return formatItemDetails(item);
   }
 });
-var get_front_page_stories = tool7({
+var get_front_page_stories = tool5({
   description: "Tool to get current HackerNews front page stories. Use when you need to see the latest trending and popular stories on HN.",
-  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)")
+  inputSchema: z5.object({
+    page: z5.number().int().min(0).default(0).describe("Page number (0-indexed)"),
+    hitsPerPage: z5.number().int().min(1).max(50).default(30).describe("Results per page (max 50)")
   }),
   execute: async (input, options) => {
-    const context = toState3(options);
+    const context = toState(options);
     context.hackernews_sources ??= [];
     const response = await searchHackerNewsAPI({
       tags: "front_page",
@@ -863,13 +795,13 @@ var get_front_page_stories = tool7({
     return formatStoryResults(response);
   }
 });
-var get_story_comments = tool7({
+var get_story_comments = tool5({
   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: 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)")
+  inputSchema: z5.object({
+    storyId: z5.string().describe('HackerNews story ID. Example: "38709478"'),
+    sortBy: z5.enum(["relevance", "date"]).default("date").describe("Sort comments by relevance or date"),
+    page: z5.number().int().min(0).default(0).describe("Page number (0-indexed)"),
+    hitsPerPage: z5.number().int().min(1).max(1e3).default(50).describe("Results per page (max 1000)")
   }),
   execute: async (input) => {
     const response = await searchHackerNewsAPI({
@@ -881,21 +813,21 @@ var get_story_comments = tool7({
     return formatCommentResults(response);
   }
 });
-var search_ask_hn = tool7({
+var search_ask_hn = tool5({
   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: z7.object({
-    query: z7.string().default("").describe(
+  inputSchema: z5.object({
+    query: z5.string().default("").describe(
       'Search query for Ask HN posts. Examples: "artificial intelligence", "career"'
     ),
-    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)")
+    timeFilter: z5.enum(["d", "w", "m", "y", "all"]).default("all").describe("Time filter: d=day, w=week, m=month, y=year, all=no filter"),
+    minPoints: z5.number().int().min(0).optional().describe("Minimum points threshold"),
+    minComments: z5.number().int().min(0).optional().describe("Minimum comments threshold"),
+    sortBy: z5.enum(["relevance", "date"]).default("relevance").describe("Sort by relevance or date"),
+    page: z5.number().int().min(0).default(0).describe("Page number (0-indexed)"),
+    hitsPerPage: z5.number().int().min(1).max(1e3).default(20).describe("Results per page (max 1000)")
   }),
   execute: async (input, options) => {
-    const context = toState3(options);
+    const context = toState(options);
     context.hackernews_sources ??= [];
     const numericFilters = buildNumericFilters({
       timeFilter: input.timeFilter,
@@ -914,21 +846,21 @@ var search_ask_hn = tool7({
     return formatStoryResults(response);
   }
 });
-var search_show_hn = tool7({
+var search_show_hn = tool5({
   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: z7.object({
-    query: z7.string().default("").describe(
+  inputSchema: z5.object({
+    query: z5.string().default("").describe(
       'Search query for Show HN posts. Examples: "web app", "open source"'
     ),
-    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)")
+    timeFilter: z5.enum(["d", "w", "m", "y", "all"]).default("all").describe("Time filter: d=day, w=week, m=month, y=year, all=no filter"),
+    minPoints: z5.number().int().min(0).optional().describe("Minimum points threshold"),
+    minComments: z5.number().int().min(0).optional().describe("Minimum comments threshold"),
+    sortBy: z5.enum(["relevance", "date"]).default("relevance").describe("Sort by relevance or date"),
+    page: z5.number().int().min(0).default(0).describe("Page number (0-indexed)"),
+    hitsPerPage: z5.number().int().min(1).max(1e3).default(20).describe("Results per page (max 1000)")
   }),
   execute: async (input, options) => {
-    const context = toState3(options);
+    const context = toState(options);
     context.hackernews_sources ??= [];
     const numericFilters = buildNumericFilters({
       timeFilter: input.timeFilter,
@@ -947,19 +879,19 @@ var search_show_hn = tool7({
     return formatStoryResults(response);
   }
 });
-var search_jobs = tool7({
+var search_jobs = tool5({
   description: "Tool to search HackerNews job postings. Use when you need to find tech job opportunities posted on HN.",
-  inputSchema: z7.object({
-    query: z7.string().default("").describe(
+  inputSchema: z5.object({
+    query: z5.string().default("").describe(
       'Search query for job postings. Examples: "remote", "machine learning"'
     ),
-    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)")
+    timeFilter: z5.enum(["d", "w", "m", "y", "all"]).default("all").describe("Time filter: d=day, w=week, m=month, y=year, all=no filter"),
+    sortBy: z5.enum(["relevance", "date"]).default("date").describe("Sort by relevance or date"),
+    page: z5.number().int().min(0).default(0).describe("Page number (0-indexed)"),
+    hitsPerPage: z5.number().int().min(1).max(1e3).default(20).describe("Results per page (max 1000)")
   }),
   execute: async (input, options) => {
-    const context = toState3(options);
+    const context = toState(options);
     context.hackernews_sources ??= [];
     const numericFilters = buildNumericFilters({
       timeFilter: input.timeFilter
@@ -976,17 +908,17 @@ var search_jobs = tool7({
     return formatJobResults(response);
   }
 });
-var search_polls = tool7({
+var search_polls = tool5({
   description: "Tool to search HackerNews polls - community surveys and voting. Use when you need to find community polls on various topics.",
-  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)")
+  inputSchema: z5.object({
+    query: z5.string().default("").describe('Search query for polls. Example: "programming language"'),
+    timeFilter: z5.enum(["d", "w", "m", "y", "all"]).default("all").describe("Time filter: d=day, w=week, m=month, y=year, all=no filter"),
+    sortBy: z5.enum(["relevance", "date"]).default("date").describe("Sort by relevance or date"),
+    page: z5.number().int().min(0).default(0).describe("Page number (0-indexed)"),
+    hitsPerPage: z5.number().int().min(1).max(1e3).default(20).describe("Results per page (max 1000)")
   }),
   execute: async (input, options) => {
-    const context = toState3(options);
+    const context = toState(options);
     context.hackernews_sources ??= [];
     const numericFilters = buildNumericFilters({
       timeFilter: input.timeFilter
@@ -1003,29 +935,29 @@ var search_polls = tool7({
     return formatStoryResults(response);
   }
 });
-var get_user_profile = tool7({
+var get_user_profile = tool5({
   description: "Tool to get HackerNews user profile information. Use when you need to view a user's karma, account creation date, and bio.",
-  inputSchema: z7.object({
-    username: z7.string().describe('HackerNews username. Example: "pg"')
+  inputSchema: z5.object({
+    username: z5.string().describe('HackerNews username. Example: "pg"')
   }),
   execute: async (input) => {
     const user = await fetchHNUser(input.username);
     return formatUserProfile(user);
   }
 });
-var search_by_domain = tool7({
+var search_by_domain = tool5({
   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: 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)")
+  inputSchema: z5.object({
+    domain: z5.string().describe('Domain to search. Examples: "github.com", "arxiv.org"'),
+    timeFilter: z5.enum(["d", "w", "m", "y", "all"]).default("all").describe("Time filter: d=day, w=week, m=month, y=year, all=no filter"),
+    minPoints: z5.number().int().min(0).optional().describe("Minimum points threshold"),
+    minComments: z5.number().int().min(0).optional().describe("Minimum comments threshold"),
+    sortBy: z5.enum(["relevance", "date"]).default("date").describe("Sort by relevance or date"),
+    page: z5.number().int().min(0).default(0).describe("Page number (0-indexed)"),
+    hitsPerPage: z5.number().int().min(1).max(1e3).default(20).describe("Results per page (max 1000)")
   }),
   execute: async (input, options) => {
-    const context = toState3(options);
+    const context = toState(options);
     context.hackernews_sources ??= [];
     const numericFilters = buildNumericFilters({
       timeFilter: input.timeFilter,
@@ -1056,21 +988,21 @@ var search_by_domain = tool7({
     return formatStoryResults(data);
   }
 });
-var search_highly_discussed = tool7({
+var search_highly_discussed = tool5({
   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: z7.object({
-    minComments: z7.number().int().min(1).describe(
+  inputSchema: z5.object({
+    minComments: z5.number().int().min(1).describe(
       "Minimum number of comments (required). Example: 100 for highly discussed stories"
     ),
-    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)")
+    query: z5.string().default("").describe('Optional search query. Example: "AI"'),
+    timeFilter: z5.enum(["d", "w", "m", "y", "all"]).default("all").describe("Time filter: d=day, w=week, m=month, y=year, all=no filter"),
+    minPoints: z5.number().int().min(0).optional().describe("Minimum points threshold"),
+    sortBy: z5.enum(["relevance", "date"]).default("date").describe("Sort by relevance or date"),
+    page: z5.number().int().min(0).default(0).describe("Page number (0-indexed)"),
+    hitsPerPage: z5.number().int().min(1).max(1e3).default(20).describe("Results per page (max 1000)")
   }),
   execute: async (input, options) => {
-    const context = toState3(options);
+    const context = toState(options);
     context.hackernews_sources ??= [];
     const numericFilters = buildNumericFilters({
       timeFilter: input.timeFilter,
@@ -1089,20 +1021,20 @@ var search_highly_discussed = tool7({
     return formatStoryResults(response);
   }
 });
-var search_trending = tool7({
+var search_trending = tool5({
   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: z7.object({
-    minPoints: z7.number().int().min(10).default(50).describe(
+  inputSchema: z5.object({
+    minPoints: z5.number().int().min(10).default(50).describe(
       "Minimum points threshold. Example: 100 for highly upvoted stories"
     ),
-    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)")
+    maxAgeHours: z5.number().int().min(1).max(72).default(24).describe("Maximum age in hours. Example: 24 for stories from today"),
+    minComments: z5.number().int().min(0).default(10).describe("Minimum comments threshold"),
+    sortBy: z5.enum(["relevance", "date"]).default("date").describe("Sort by relevance or date"),
+    page: z5.number().int().min(0).default(0).describe("Page number (0-indexed)"),
+    hitsPerPage: z5.number().int().min(1).max(100).default(30).describe("Results per page (max 100)")
   }),
   execute: async (input, options) => {
-    const context = toState3(options);
+    const context = toState(options);
     context.hackernews_sources ??= [];
     const numericFilters = buildNumericFilters({
       maxAgeHours: input.maxAgeHours,
@@ -1147,25 +1079,273 @@ var hackernewsTools = {
   search_highly_discussed,
   search_trending
 };
+
+// packages/toolbox/src/lib/scratchbad.ts
+import { tool as tool6 } from "ai";
+import z6 from "zod";
+var scratchpad_tool = tool6({
+  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: z6.object({
+    reflection: z6.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/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}`;
+  }
+});
+
+// packages/toolbox/src/lib/weather.ts
+import { tool as tool8 } from "ai";
+import { z as z8 } from "zod";
+var GetWeatherInputSchema = z8.object({
+  location: z8.string().describe("City name, address or coordinates"),
+  unit: z8.enum(["C", "F"]).default("C")
+});
+var GetWeatherSchema = z8.object({
+  location: z8.string(),
+  unit: z8.enum(["C", "F"]),
+  temperature: z8.number(),
+  condition: z8.string(),
+  high: z8.number(),
+  low: z8.number(),
+  humidity: z8.number(),
+  windKph: z8.number(),
+  icon: z8.string().optional()
+});
+var getWeatherTool = tool8({
+  description: "Get the current weather for a location.",
+  inputSchema: GetWeatherInputSchema,
+  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
+var web_search_tool = duckDuckGoSearch;
 export {
   GetWeatherSchema,
   ddgSearchSchema,
   duckDuckGoSearch,
   duckStocks,
   execute_os_command,
+  file_exists_tool,
   getWeatherTool,
   get_front_page_stories,
   get_story_comment,
   get_story_comments,
   get_story_item,
   get_user_profile,
+  glob_tool,
   hackernewsTools,
+  read_dir_tool,
+  read_file_tool,
+  repoTree,
   scratchpad_tool,
-  searchAgent,
   search_ask_hn,
   search_by_author,
   search_by_domain,
   search_by_query,
+  search_content_tool,
+  search_files_tool,
   search_highly_discussed,
   search_jobs,
   search_polls,