@agentforge/tools 0.18.3 → 0.18.5

package/dist/index.js

@@ -1,7 +1,7 @@
 import { toolBuilder, ToolCategory, LogLevel, createLogger, createTool } from '@agentforge/core';
 import { lookup } from 'dns/promises';
 import net from 'net';
-import axios11 from 'axios';
+import axios5 from 'axios';
 import { z } from 'zod';
 import * as cheerio from 'cheerio';
 import { WebClient } from '@slack/web-api';
@@ -201,7 +201,7 @@ async function requestWithDestinationPolicy(config, policy = {}) {
   for (let redirectCount = 0; ; redirectCount += 1) {
     const validatedAddresses = await validateDestinationAllowed(currentUrl, effectivePolicy);
     currentConfig.lookup = createPinnedLookup(validatedAddresses);
-    const response = await axios11(currentConfig);
+    const response = await axios5(currentConfig);
     if (!isRedirectStatus(response.status)) return response;
     if (effectivePolicy.allowRedirects === false) blockDestination(currentUrl, "redirect");
     if (redirectCount >= maxRedirects) throw new DestinationPolicyError(currentUrl, "redirect", `Maximum redirect count (${maxRedirects}) exceeded for ${currentUrl}`);
@@ -710,26 +710,23 @@ var DuckDuckGoProvider = class {
    * @param timeout - Request timeout in milliseconds (default: 30000)
    */
   async search(query, maxResults, timeout = DEFAULT_TIMEOUT) {
-    return retryWithBackoff(async () => {
-      try {
-        const response = await axios11.get(
-          "https://api.duckduckgo.com/",
-          {
-            params: {
-              q: query,
-              format: "json"
-            },
-            headers: {
-              "User-Agent": "Mozilla/5.0 (compatible; AgentForge/1.0; +https://github.com/agentforge)"
-            },
-            timeout
-          }
-        );
+    try {
+      return await retryWithBackoff(async () => {
+        const response = await axios5.get("https://api.duckduckgo.com/", {
+          params: {
+            q: query,
+            format: "json"
+          },
+          headers: {
+            "User-Agent": "Mozilla/5.0 (compatible; AgentForge/1.0; +https://github.com/agentforge)"
+          },
+          timeout
+        });
         return this.normalizeResults(response.data, maxResults);
-      } catch (error) {
-        throw new Error(`DuckDuckGo search failed: ${error.message}`);
-      }
-    });
+      });
+    } catch (error) {
+      throw new Error(`DuckDuckGo search failed: ${error.message}`);
+    }
   }
   /**
    * Normalize DuckDuckGo response to SearchResult[]
@@ -814,9 +811,9 @@ var SerperProvider = class {
         "Serper API key not found. Set SERPER_API_KEY environment variable. Get your key at https://serper.dev"
       );
     }
-    return retryWithBackoff(async () => {
-      try {
-        const response = await axios11.post(
+    try {
+      return await retryWithBackoff(async () => {
+        const response = await axios5.post(
           "https://google.serper.dev/search",
           {
             q: query,
@@ -831,20 +828,18 @@ var SerperProvider = class {
           }
         );
         return this.normalizeResults(response.data, maxResults);
-      } catch (error) {
-        if (error.response?.status === 401) {
-          throw new Error(
-            "Invalid Serper API key. Get your key at https://serper.dev"
-          );
-        }
-        if (error.response?.status === 429) {
-          throw new Error(
-            "Serper API rate limit exceeded. Please try again later or upgrade your plan at https://serper.dev"
-          );
-        }
-        throw new Error(`Serper search failed: ${error.message}`);
+      });
+    } catch (error) {
+      if (error.response?.status === 401) {
+        throw new Error("Invalid Serper API key. Get your key at https://serper.dev");
       }
-    });
+      if (error.response?.status === 429) {
+        throw new Error(
+          "Serper API rate limit exceeded. Please try again later or upgrade your plan at https://serper.dev"
+        );
+      }
+      throw new Error(`Serper search failed: ${error.message}`);
+    }
   }
   /**
    * Normalize Serper response to SearchResult[]
@@ -1221,38 +1216,91 @@ function createGetConfiguredAuth(apiKey, email, siteUrl) {
     return { ATLASSIAN_API_KEY, ATLASSIAN_EMAIL, ATLASSIAN_SITE_URL };
   };
 }
-function createGetConfiguredAuthHeader(getConfiguredAuth) {
-  return function getConfiguredAuthHeader() {
-    const { ATLASSIAN_API_KEY, ATLASSIAN_EMAIL } = getConfiguredAuth();
-    const auth2 = Buffer.from(`${ATLASSIAN_EMAIL}:${ATLASSIAN_API_KEY}`).toString("base64");
-    return `Basic ${auth2}`;
-  };
-}
 function getConfig() {
   const ATLASSIAN_API_KEY = process.env.ATLASSIAN_API_KEY || "";
   const ATLASSIAN_EMAIL = process.env.ATLASSIAN_EMAIL || "";
   const ATLASSIAN_SITE_URL = (process.env.ATLASSIAN_SITE_URL || "").replace(/\/$/, "");
   if (!ATLASSIAN_API_KEY || !ATLASSIAN_EMAIL || !ATLASSIAN_SITE_URL) {
-    throw new Error("Confluence credentials not configured. Set ATLASSIAN_API_KEY, ATLASSIAN_EMAIL, and ATLASSIAN_SITE_URL in .env");
+    throw new Error(
+      "Confluence credentials not configured. Set ATLASSIAN_API_KEY, ATLASSIAN_EMAIL, and ATLASSIAN_SITE_URL in .env"
+    );
   }
   return { ATLASSIAN_API_KEY, ATLASSIAN_EMAIL, ATLASSIAN_SITE_URL };
 }
-function getAuthHeader() {
-  const { ATLASSIAN_API_KEY, ATLASSIAN_EMAIL } = getConfig();
-  const auth2 = Buffer.from(`${ATLASSIAN_EMAIL}:${ATLASSIAN_API_KEY}`).toString("base64");
-  return `Basic ${auth2}`;
+function isRecord(value) {
+  return typeof value === "object" && value !== null;
+}
+function describeError(error) {
+  const errorRecord = isRecord(error) ? error : void 0;
+  const response = isRecord(errorRecord?.response) ? errorRecord.response : void 0;
+  const responseData = isRecord(response?.data) ? response.data : void 0;
+  const providerMessage = typeof responseData?.message === "string" ? responseData.message : void 0;
+  const errorMessage = typeof errorRecord?.message === "string" ? errorRecord.message : void 0;
+  return {
+    message: providerMessage || errorMessage,
+    status: typeof response?.status === "number" ? response.status : void 0
+  };
 }
-function createSearchConfluenceTool(getAuth, getAuthHeader2, logger20) {
-  return toolBuilder().name("search-confluence").description("Search for pages in Confluence using keywords or CQL (Confluence Query Language). Returns matching pages with titles, IDs, and excerpts.").category(ToolCategory.WEB).tag("confluence").tag("search").tag("knowledge-base").usageNotes("Use this to find relevant documentation, policies, or information in Confluence. You can search by keywords or use CQL for advanced queries (e.g., 'space=AI AND type=page'). Use get-confluence-page to retrieve full content of specific pages.").suggests(["get-confluence-page"]).schema(z.object({
-    query: z.string().describe("Search query or CQL expression (e.g., 'payment processing' or 'space=BL3 AND title~payment')"),
-    limit: z.number().optional().describe("Maximum number of results to return (default: 10, max: 25)")
-  })).implement(async ({ query, limit = 10 }) => {
+function authenticatedConfig(auth2, config = {}) {
+  const credentials = Buffer.from(`${auth2.ATLASSIAN_EMAIL}:${auth2.ATLASSIAN_API_KEY}`).toString(
+    "base64"
+  );
+  return {
+    ...config,
+    headers: {
+      ...config.headers,
+      Authorization: `Basic ${credentials}`
+    }
+  };
+}
+function createConfluenceRequest(getAuth) {
+  return {
+    async get(path13, config = {}) {
+      const auth2 = getAuth();
+      const response = await axios5.get(
+        `${auth2.ATLASSIAN_SITE_URL}${path13}`,
+        authenticatedConfig(auth2, config)
+      );
+      return { data: response.data, siteUrl: auth2.ATLASSIAN_SITE_URL };
+    },
+    async post(path13, data, config = {}) {
+      const auth2 = getAuth();
+      const response = await axios5.post(
+        `${auth2.ATLASSIAN_SITE_URL}${path13}`,
+        data,
+        authenticatedConfig(auth2, config)
+      );
+      return { data: response.data, siteUrl: auth2.ATLASSIAN_SITE_URL };
+    },
+    async put(path13, data, config = {}) {
+      const auth2 = getAuth();
+      const response = await axios5.put(
+        `${auth2.ATLASSIAN_SITE_URL}${path13}`,
+        data,
+        authenticatedConfig(auth2, config)
+      );
+      return { data: response.data, siteUrl: auth2.ATLASSIAN_SITE_URL };
+    },
+    describeError
+  };
+}
+function createSearchConfluenceTool(request2, logger20) {
+  return toolBuilder().name("search-confluence").description(
+    "Search for pages in Confluence using keywords or CQL (Confluence Query Language). Returns matching pages with titles, IDs, and excerpts."
+  ).category(ToolCategory.WEB).tag("confluence").tag("search").tag("knowledge-base").usageNotes(
+    "Use this to find relevant documentation, policies, or information in Confluence. You can search by keywords or use CQL for advanced queries (e.g., 'space=AI AND type=page'). Use get-confluence-page to retrieve full content of specific pages."
+  ).suggests(["get-confluence-page"]).schema(
+    z.object({
+      query: z.string().describe(
+        "Search query or CQL expression (e.g., 'payment processing' or 'space=BL3 AND title~payment')"
+      ),
+      limit: z.number().optional().describe("Maximum number of results to return (default: 10, max: 25)")
+    })
+  ).implement(async ({ query, limit = 10 }) => {
     logger20.info("search-confluence called", { query, limit });
     try {
-      const { ATLASSIAN_SITE_URL } = getAuth();
-      const response = await axios11.get(`${ATLASSIAN_SITE_URL}/wiki/rest/api/content/search`, {
+      const response = await request2.get("/wiki/rest/api/content/search", {
         headers: {
-          Authorization: getAuthHeader2(),
           Accept: "application/json"
         },
         params: {
@@ -1261,22 +1309,24 @@ function createSearchConfluenceTool(getAuth, getAuthHeader2, logger20) {
           expand: "space,version"
         }
       });
-      const { ATLASSIAN_SITE_URL: siteUrl } = getAuth();
       const results = response.data.results.map((page) => ({
         id: page.id,
         title: page.title,
         type: page.type,
         space: page.space?.name || "Unknown",
         spaceKey: page.space?.key || "",
-        url: `${siteUrl}/wiki${page._links.webui}`,
+        url: `${response.siteUrl}/wiki${page._links.webui}`,
         lastModified: page.version?.when || ""
       }));
       if (results.length === 0) {
-        logger20.warn("search-confluence returned NO RESULTS - this is a valid outcome, agent should not retry", {
-          query,
-          limit,
-          totalSize: response.data.totalSize
-        });
+        logger20.warn(
+          "search-confluence returned NO RESULTS - this is a valid outcome, agent should not retry",
+          {
+            query,
+            limit,
+            totalSize: response.data.totalSize
+          }
+        );
       } else {
         logger20.info("search-confluence result", {
           query,
@@ -1293,28 +1343,33 @@ function createSearchConfluenceTool(getAuth, getAuthHeader2, logger20) {
         results
       });
     } catch (error) {
+      const description = request2.describeError(error);
       logger20.error("search-confluence error", {
         query,
-        error: error.response?.data?.message || error.message,
-        status: error.response?.status
+        ...description.message !== void 0 ? { error: description.message } : {},
+        ...description.status !== void 0 ? { status: description.status } : {}
       });
       return JSON.stringify({
         success: false,
-        error: error.response?.data?.message || error.message
+        error: description.message
       });
     }
   }).build();
 }
-function createGetConfluencePageTool(getAuth, getAuthHeader2, logger20) {
-  return toolBuilder().name("get-confluence-page").description("Get the full content of a specific Confluence page by its ID. Returns the page title, content (in storage format), space, and metadata.").category(ToolCategory.WEB).tag("confluence").tag("page").tag("content").usageNotes("Use this after search-confluence to retrieve the full content of a specific page. The page ID can be found in search results.").requires(["search-confluence"]).schema(z.object({
-    page_id: z.string().describe("The Confluence page ID (from search results)")
-  })).implement(async ({ page_id }) => {
+function createGetConfluencePageTool(request2, logger20) {
+  return toolBuilder().name("get-confluence-page").description(
+    "Get the full content of a specific Confluence page by its ID. Returns the page title, content (in storage format), space, and metadata."
+  ).category(ToolCategory.WEB).tag("confluence").tag("page").tag("content").usageNotes(
+    "Use this after search-confluence to retrieve the full content of a specific page. The page ID can be found in search results."
+  ).requires(["search-confluence"]).schema(
+    z.object({
+      page_id: z.string().describe("The Confluence page ID (from search results)")
+    })
+  ).implement(async ({ page_id }) => {
     logger20.info("get-confluence-page called", { page_id });
     try {
-      const { ATLASSIAN_SITE_URL } = getAuth();
-      const response = await axios11.get(`${ATLASSIAN_SITE_URL}/wiki/rest/api/content/${page_id}`, {
+      const response = await request2.get(`/wiki/rest/api/content/${page_id}`, {
         headers: {
-          Authorization: getAuthHeader2(),
           Accept: "application/json"
         },
         params: {
@@ -1337,35 +1392,40 @@ function createGetConfluencePageTool(getAuth, getAuthHeader2, logger20) {
           space: page.space?.name || "Unknown",
           spaceKey: page.space?.key || "",
           content: page.body?.storage?.value || "",
-          url: `${ATLASSIAN_SITE_URL}/wiki${page._links.webui}`,
+          url: `${response.siteUrl}/wiki${page._links.webui}`,
           created: page.history?.createdDate || "",
           lastModified: page.version?.when || "",
           version: page.version?.number || 1
         }
       });
     } catch (error) {
+      const description = request2.describeError(error);
       logger20.error("get-confluence-page error", {
         page_id,
-        error: error.response?.data?.message || error.message,
-        status: error.response?.status
+        ...description.message !== void 0 ? { error: description.message } : {},
+        ...description.status !== void 0 ? { status: description.status } : {}
       });
       return JSON.stringify({
         success: false,
-        error: error.response?.data?.message || error.message
+        error: description.message
       });
     }
   }).build();
 }
-function createListConfluenceSpacesTool(getAuth, getAuthHeader2, logger20) {
-  return toolBuilder().name("list-confluence-spaces").description("List all available Confluence spaces. Returns space names, keys, types, and descriptions to help identify where to search for information.").category(ToolCategory.WEB).tag("confluence").tag("spaces").tag("list").usageNotes("Use this first to discover available spaces before searching. Helps narrow down searches to specific areas (e.g., 'AI', 'BL3', 'Finance').").follows(["search-confluence"]).schema(z.object({
-    limit: z.number().optional().describe("Maximum number of spaces to return (default: 25)")
-  })).implement(async ({ limit = 25 }) => {
+function createListConfluenceSpacesTool(request2, logger20) {
+  return toolBuilder().name("list-confluence-spaces").description(
+    "List all available Confluence spaces. Returns space names, keys, types, and descriptions to help identify where to search for information."
+  ).category(ToolCategory.WEB).tag("confluence").tag("spaces").tag("list").usageNotes(
+    "Use this first to discover available spaces before searching. Helps narrow down searches to specific areas (e.g., 'AI', 'BL3', 'Finance')."
+  ).follows(["search-confluence"]).schema(
+    z.object({
+      limit: z.number().optional().describe("Maximum number of spaces to return (default: 25)")
+    })
+  ).implement(async ({ limit = 25 }) => {
     logger20.info("list-confluence-spaces called", { limit });
     try {
-      const { ATLASSIAN_SITE_URL } = getAuth();
-      const response = await axios11.get(`${ATLASSIAN_SITE_URL}/wiki/rest/api/space`, {
+      const response = await request2.get("/wiki/rest/api/space", {
         headers: {
-          Authorization: getAuthHeader2(),
           Accept: "application/json"
         },
         params: {
@@ -1377,7 +1437,7 @@ function createListConfluenceSpacesTool(getAuth, getAuthHeader2, logger20) {
         name: space.name,
         type: space.type,
         description: space.description?.plain?.value || "",
-        url: `${ATLASSIAN_SITE_URL}/wiki${space._links.webui}`
+        url: `${response.siteUrl}/wiki${space._links.webui}`
       }));
       logger20.info("list-confluence-spaces result", {
         spaceCount: spaces.length,
@@ -1390,28 +1450,33 @@ function createListConfluenceSpacesTool(getAuth, getAuthHeader2, logger20) {
         spaces
       });
     } catch (error) {
+      const description = request2.describeError(error);
       logger20.error("list-confluence-spaces error", {
-        error: error.response?.data?.message || error.message,
-        status: error.response?.status
+        ...description.message !== void 0 ? { error: description.message } : {},
+        ...description.status !== void 0 ? { status: description.status } : {}
       });
       return JSON.stringify({
         success: false,
-        error: error.response?.data?.message || error.message
+        error: description.message
       });
     }
   }).build();
 }
-function createGetSpacePagesTool(getAuth, getAuthHeader2, logger20) {
-  return toolBuilder().name("get-space-pages").description("Get all pages from a specific Confluence space by space key. Useful for browsing content in a particular area.").category(ToolCategory.WEB).tag("confluence").tag("space").tag("pages").usageNotes("Use this to explore all pages in a specific space. Get the space key from list-confluence-spaces first.").requires(["list-confluence-spaces"]).schema(z.object({
-    space_key: z.string().describe("The space key (e.g., 'AI', 'BL3', 'FIN')"),
-    limit: z.number().optional().describe("Maximum number of pages to return (default: 25)")
-  })).implement(async ({ space_key, limit = 25 }) => {
+function createGetSpacePagesTool(request2, logger20) {
+  return toolBuilder().name("get-space-pages").description(
+    "Get all pages from a specific Confluence space by space key. Useful for browsing content in a particular area."
+  ).category(ToolCategory.WEB).tag("confluence").tag("space").tag("pages").usageNotes(
+    "Use this to explore all pages in a specific space. Get the space key from list-confluence-spaces first."
+  ).requires(["list-confluence-spaces"]).schema(
+    z.object({
+      space_key: z.string().describe("The space key (e.g., 'AI', 'BL3', 'FIN')"),
+      limit: z.number().optional().describe("Maximum number of pages to return (default: 25)")
+    })
+  ).implement(async ({ space_key, limit = 25 }) => {
     logger20.info("get-space-pages called", { space_key, limit });
     try {
-      const { ATLASSIAN_SITE_URL } = getAuth();
-      const response = await axios11.get(`${ATLASSIAN_SITE_URL}/wiki/rest/api/content`, {
+      const response = await request2.get("/wiki/rest/api/content", {
         headers: {
-          Authorization: getAuthHeader2(),
           Accept: "application/json"
         },
         params: {
@@ -1424,14 +1489,17 @@ function createGetSpacePagesTool(getAuth, getAuthHeader2, logger20) {
       const pages = response.data.results.map((page) => ({
         id: page.id,
         title: page.title,
-        url: `${ATLASSIAN_SITE_URL}/wiki${page._links.webui}`,
+        url: `${response.siteUrl}/wiki${page._links.webui}`,
         lastModified: page.version?.when || ""
       }));
       if (pages.length === 0) {
-        logger20.warn("get-space-pages returned NO PAGES - this is a valid outcome, agent should not retry", {
-          space_key,
-          limit
-        });
+        logger20.warn(
+          "get-space-pages returned NO PAGES - this is a valid outcome, agent should not retry",
+          {
+            space_key,
+            limit
+          }
+        );
       } else {
         logger20.info("get-space-pages result", {
           space_key,
@@ -1447,28 +1515,38 @@ function createGetSpacePagesTool(getAuth, getAuthHeader2, logger20) {
         pages
       });
     } catch (error) {
+      const description = request2.describeError(error);
       logger20.error("get-space-pages error", {
         space_key,
-        error: error.response?.data?.message || error.message,
-        status: error.response?.status
+        ...description.message !== void 0 ? { error: description.message } : {},
+        ...description.status !== void 0 ? { status: description.status } : {}
       });
       return JSON.stringify({
         success: false,
-        error: error.response?.data?.message || error.message
+        error: description.message
       });
     }
   }).build();
 }
-function createCreateConfluencePageTool(getAuth, getAuthHeader2, logger20) {
-  return toolBuilder().name("create-confluence-page").description("Create a new page in a Confluence space. Requires space key, page title, and content (in HTML storage format).").category(ToolCategory.WEB).tag("confluence").tag("create").tag("write").usageNotes("Use this to create new documentation pages. Content should be in Confluence storage format (HTML). Get the space key from list-confluence-spaces first. Be mindful of creating duplicate pages.").requires(["list-confluence-spaces"]).schema(z.object({
-    space_key: z.string().describe("The space key where the page will be created (e.g., 'AI', 'BL3')"),
-    title: z.string().describe("The title of the new page"),
-    content: z.string().describe("The page content in HTML format (Confluence storage format)"),
-    parent_page_id: z.string().optional().describe("Optional parent page ID to create this as a child page")
-  })).implement(async ({ space_key, title, content, parent_page_id }) => {
-    logger20.info("create-confluence-page called", { space_key, title, hasParent: !!parent_page_id });
+function createCreateConfluencePageTool(request2, logger20) {
+  return toolBuilder().name("create-confluence-page").description(
+    "Create a new page in a Confluence space. Requires space key, page title, and content (in HTML storage format)."
+  ).category(ToolCategory.WEB).tag("confluence").tag("create").tag("write").usageNotes(
+    "Use this to create new documentation pages. Content should be in Confluence storage format (HTML). Get the space key from list-confluence-spaces first. Be mindful of creating duplicate pages."
+  ).requires(["list-confluence-spaces"]).schema(
+    z.object({
+      space_key: z.string().describe("The space key where the page will be created (e.g., 'AI', 'BL3')"),
+      title: z.string().describe("The title of the new page"),
+      content: z.string().describe("The page content in HTML format (Confluence storage format)"),
+      parent_page_id: z.string().optional().describe("Optional parent page ID to create this as a child page")
+    })
+  ).implement(async ({ space_key, title, content, parent_page_id }) => {
+    logger20.info("create-confluence-page called", {
+      space_key,
+      title,
+      hasParent: !!parent_page_id
+    });
     try {
-      const { ATLASSIAN_SITE_URL } = getAuth();
       const pageData = {
         type: "page",
         title,
@@ -1483,16 +1561,11 @@ function createCreateConfluencePageTool(getAuth, getAuthHeader2, logger20) {
       if (parent_page_id) {
         pageData.ancestors = [{ id: parent_page_id }];
       }
-      const response = await axios11.post(
-        `${ATLASSIAN_SITE_URL}/wiki/rest/api/content`,
-        pageData,
-        {
-          headers: {
-            Authorization: getAuthHeader2(),
-            "Content-Type": "application/json"
-          }
+      const response = await request2.post("/wiki/rest/api/content", pageData, {
+        headers: {
+          "Content-Type": "application/json"
         }
-      );
+      });
       logger20.info("create-confluence-page result", {
         page_id: response.data.id,
         title: response.data.title,
@@ -1504,45 +1577,45 @@ function createCreateConfluencePageTool(getAuth, getAuthHeader2, logger20) {
           id: response.data.id,
           title: response.data.title,
           space: space_key,
-          url: `${ATLASSIAN_SITE_URL}/wiki${response.data._links.webui}`,
+          url: `${response.siteUrl}/wiki${response.data._links.webui}`,
           version: response.data.version?.number || 1
         }
       });
     } catch (error) {
+      const description = request2.describeError(error);
       logger20.error("create-confluence-page error", {
         space_key,
         title,
-        error: error.response?.data?.message || error.message,
-        status: error.response?.status
+        ...description.message !== void 0 ? { error: description.message } : {},
+        ...description.status !== void 0 ? { status: description.status } : {}
       });
       return JSON.stringify({
         success: false,
-        error: error.response?.data?.message || error.message
+        error: description.message
       });
     }
   }).build();
 }
-function createUpdateConfluencePageTool(getAuth, getAuthHeader2, logger20) {
-  return toolBuilder().name("update-confluence-page").description("Update an existing Confluence page's content. Requires page ID, new title, and new content.").category(ToolCategory.WEB).tag("confluence").tag("update").tag("write").usageNotes("Use this to update existing documentation. You must provide the page ID (from search results). The tool will automatically handle version incrementing. Always get the current page content first to avoid overwriting important information.").requires(["get-confluence-page"]).schema(z.object({
-    page_id: z.string().describe("The ID of the page to update"),
-    title: z.string().describe("The new title for the page"),
-    content: z.string().describe("The new content in HTML format (Confluence storage format)")
-  })).implement(async ({ page_id, title, content }) => {
+function createUpdateConfluencePageTool(request2, logger20) {
+  return toolBuilder().name("update-confluence-page").description(
+    "Update an existing Confluence page's content. Requires page ID, new title, and new content."
+  ).category(ToolCategory.WEB).tag("confluence").tag("update").tag("write").usageNotes(
+    "Use this to update existing documentation. You must provide the page ID (from search results). The tool will automatically handle version incrementing. Always get the current page content first to avoid overwriting important information."
+  ).requires(["get-confluence-page"]).schema(
+    z.object({
+      page_id: z.string().describe("The ID of the page to update"),
+      title: z.string().describe("The new title for the page"),
+      content: z.string().describe("The new content in HTML format (Confluence storage format)")
+    })
+  ).implement(async ({ page_id, title, content }) => {
     logger20.info("update-confluence-page called", { page_id, title });
     try {
-      const { ATLASSIAN_SITE_URL } = getAuth();
-      const getResponse = await axios11.get(
-        `${ATLASSIAN_SITE_URL}/wiki/rest/api/content/${page_id}`,
-        {
-          headers: {
-            Authorization: getAuthHeader2()
-          },
-          params: { expand: "version" }
-        }
-      );
+      const getResponse = await request2.get(`/wiki/rest/api/content/${page_id}`, {
+        params: { expand: "version" }
+      });
       const currentVersion = getResponse.data.version.number;
-      const updateResponse = await axios11.put(
-        `${ATLASSIAN_SITE_URL}/wiki/rest/api/content/${page_id}`,
+      const updateResponse = await request2.put(
+        `/wiki/rest/api/content/${page_id}`,
         {
           type: "page",
           title,
@@ -1556,7 +1629,6 @@ function createUpdateConfluencePageTool(getAuth, getAuthHeader2, logger20) {
         },
         {
           headers: {
-            Authorization: getAuthHeader2(),
             "Content-Type": "application/json"
           }
         }
@@ -1572,49 +1644,49 @@ function createUpdateConfluencePageTool(getAuth, getAuthHeader2, logger20) {
         page: {
           id: updateResponse.data.id,
           title: updateResponse.data.title,
-          url: `${ATLASSIAN_SITE_URL}/wiki${updateResponse.data._links.webui}`,
+          url: `${updateResponse.siteUrl}/wiki${updateResponse.data._links.webui}`,
           version: updateResponse.data.version.number,
           previousVersion: currentVersion
         }
       });
     } catch (error) {
+      const description = request2.describeError(error);
       logger20.error("update-confluence-page error", {
         page_id,
         title,
-        error: error.response?.data?.message || error.message,
-        status: error.response?.status
+        ...description.message !== void 0 ? { error: description.message } : {},
+        ...description.status !== void 0 ? { status: description.status } : {}
       });
       return JSON.stringify({
         success: false,
-        error: error.response?.data?.message || error.message
+        error: description.message
       });
     }
   }).build();
 }
-function createArchiveConfluencePageTool(getAuth, getAuthHeader2, logger20) {
-  return toolBuilder().name("archive-confluence-page").description("Archive a Confluence page by moving it to trash. The page can be restored by space admins. Note: UI may require a note explaining why the page was archived.").category(ToolCategory.WEB).tag("confluence").tag("archive").tag("delete").usageNotes("Use this to archive outdated or obsolete documentation. The page is moved to trash, not permanently deleted. Space admins can restore it if needed. Be very careful - only archive pages that are truly obsolete.").conflicts(["create-confluence-page"]).schema(z.object({
-    page_id: z.string().describe("The ID of the page to archive"),
-    reason: z.string().optional().describe("Optional reason for archiving (for audit trail)")
-  })).implement(async ({ page_id, reason }) => {
+function createArchiveConfluencePageTool(request2, logger20) {
+  return toolBuilder().name("archive-confluence-page").description(
+    "Archive a Confluence page by moving it to trash. The page can be restored by space admins. Note: UI may require a note explaining why the page was archived."
+  ).category(ToolCategory.WEB).tag("confluence").tag("archive").tag("delete").usageNotes(
+    "Use this to archive outdated or obsolete documentation. The page is moved to trash, not permanently deleted. Space admins can restore it if needed. Be very careful - only archive pages that are truly obsolete."
+  ).conflicts(["create-confluence-page"]).schema(
+    z.object({
+      page_id: z.string().describe("The ID of the page to archive"),
+      reason: z.string().optional().describe("Optional reason for archiving (for audit trail)")
+    })
+  ).implement(async ({ page_id, reason }) => {
     logger20.info("archive-confluence-page called", {
       page_id,
       ...reason ? { reason } : {}
     });
     try {
-      const { ATLASSIAN_SITE_URL } = getAuth();
-      const getResponse = await axios11.get(
-        `${ATLASSIAN_SITE_URL}/wiki/rest/api/content/${page_id}`,
-        {
-          headers: {
-            Authorization: getAuthHeader2()
-          },
-          params: { expand: "version,body.storage,space" }
-        }
-      );
+      const getResponse = await request2.get(`/wiki/rest/api/content/${page_id}`, {
+        params: { expand: "version,body.storage,space" }
+      });
       const currentVersion = getResponse.data.version.number;
       const pageData = getResponse.data;
-      await axios11.put(
-        `${ATLASSIAN_SITE_URL}/wiki/rest/api/content/${page_id}`,
+      await request2.put(
+        `/wiki/rest/api/content/${page_id}`,
         {
           version: { number: currentVersion + 1 },
           title: pageData.title,
@@ -1625,7 +1697,6 @@ function createArchiveConfluencePageTool(getAuth, getAuthHeader2, logger20) {
         },
         {
           headers: {
-            Authorization: getAuthHeader2(),
             "Content-Type": "application/json"
           }
         }
@@ -1648,14 +1719,15 @@ function createArchiveConfluencePageTool(getAuth, getAuthHeader2, logger20) {
         }
       });
     } catch (error) {
+      const description = request2.describeError(error);
       logger20.error("archive-confluence-page error", {
         page_id,
-        error: error.response?.data?.message || error.message,
-        status: error.response?.status
+        ...description.message !== void 0 ? { error: description.message } : {},
+        ...description.status !== void 0 ? { status: description.status } : {}
       });
       return JSON.stringify({
         success: false,
-        error: error.response?.data?.message || error.message
+        error: description.message
       });
     }
   }).build();
@@ -1664,13 +1736,14 @@ function createArchiveConfluencePageTool(getAuth, getAuthHeader2, logger20) {
 // src/web/confluence/index.ts
 var logLevel2 = process.env.LOG_LEVEL?.toLowerCase() || LogLevel.INFO;
 var logger2 = createLogger("[tools:confluence]", { level: logLevel2 });
-var searchConfluence = createSearchConfluenceTool(getConfig, getAuthHeader, logger2);
-var getConfluencePage = createGetConfluencePageTool(getConfig, getAuthHeader, logger2);
-var listConfluenceSpaces = createListConfluenceSpacesTool(getConfig, getAuthHeader, logger2);
-var getSpacePages = createGetSpacePagesTool(getConfig, getAuthHeader, logger2);
-var createConfluencePage = createCreateConfluencePageTool(getConfig, getAuthHeader, logger2);
-var updateConfluencePage = createUpdateConfluencePageTool(getConfig, getAuthHeader, logger2);
-var archiveConfluencePage = createArchiveConfluencePageTool(getConfig, getAuthHeader, logger2);
+var request = createConfluenceRequest(getConfig);
+var searchConfluence = createSearchConfluenceTool(request, logger2);
+var getConfluencePage = createGetConfluencePageTool(request, logger2);
+var listConfluenceSpaces = createListConfluenceSpacesTool(request, logger2);
+var getSpacePages = createGetSpacePagesTool(request, logger2);
+var createConfluencePage = createCreateConfluencePageTool(request, logger2);
+var updateConfluencePage = createUpdateConfluencePageTool(request, logger2);
+var archiveConfluencePage = createArchiveConfluencePageTool(request, logger2);
 var confluenceTools = [
   // Read tools
   searchConfluence,
@@ -1683,22 +1756,17 @@ var confluenceTools = [
   archiveConfluencePage
 ];
 function createConfluenceTools(config = {}) {
-  const {
-    apiKey,
-    email,
-    siteUrl,
-    logLevel: customLogLevel
-  } = config;
+  const { apiKey, email, siteUrl, logLevel: customLogLevel } = config;
   const getConfiguredAuth = createGetConfiguredAuth(apiKey, email, siteUrl);
-  const getConfiguredAuthHeader = createGetConfiguredAuthHeader(getConfiguredAuth);
+  const request2 = createConfluenceRequest(getConfiguredAuth);
   const toolLogger = customLogLevel ? createLogger("tools:confluence", { level: customLogLevel }) : logger2;
-  const searchConfluence2 = createSearchConfluenceTool(getConfiguredAuth, getConfiguredAuthHeader, toolLogger);
-  const getConfluencePage2 = createGetConfluencePageTool(getConfiguredAuth, getConfiguredAuthHeader, toolLogger);
-  const listConfluenceSpaces2 = createListConfluenceSpacesTool(getConfiguredAuth, getConfiguredAuthHeader, toolLogger);
-  const getSpacePages2 = createGetSpacePagesTool(getConfiguredAuth, getConfiguredAuthHeader, toolLogger);
-  const createConfluencePage2 = createCreateConfluencePageTool(getConfiguredAuth, getConfiguredAuthHeader, toolLogger);
-  const updateConfluencePage2 = createUpdateConfluencePageTool(getConfiguredAuth, getConfiguredAuthHeader, toolLogger);
-  const archiveConfluencePage2 = createArchiveConfluencePageTool(getConfiguredAuth, getConfiguredAuthHeader, toolLogger);
+  const searchConfluence2 = createSearchConfluenceTool(request2, toolLogger);
+  const getConfluencePage2 = createGetConfluencePageTool(request2, toolLogger);
+  const listConfluenceSpaces2 = createListConfluenceSpacesTool(request2, toolLogger);
+  const getSpacePages2 = createGetSpacePagesTool(request2, toolLogger);
+  const createConfluencePage2 = createCreateConfluencePageTool(request2, toolLogger);
+  const updateConfluencePage2 = createUpdateConfluencePageTool(request2, toolLogger);
+  const archiveConfluencePage2 = createArchiveConfluencePageTool(request2, toolLogger);
   return {
     searchConfluence: searchConfluence2,
     getConfluencePage: getConfluencePage2,
@@ -1889,14 +1957,14 @@ function createJsonStringifyTool(defaultIndent = 2, defaultPretty = false) {
     };
   }).build();
 }
-function isRecord(value) {
+function isRecord2(value) {
   return typeof value === "object" && value !== null && !Array.isArray(value);
 }
 function getPathValue(current, part) {
   const arrayMatch = part.match(/^(\w+)\[(\d+)\]$/);
   if (arrayMatch) {
     const [, key, index] = arrayMatch;
-    if (!isRecord(current)) {
+    if (!isRecord2(current)) {
       return void 0;
     }
     const candidate = current[key];
@@ -1905,7 +1973,7 @@ function getPathValue(current, part) {
     }
     return candidate[parseInt(index, 10)];
   }
-  if (!isRecord(current)) {
+  if (!isRecord2(current)) {
     return void 0;
   }
   return current[part];
@@ -2561,7 +2629,7 @@ async function initializeFromEnv() {
 // src/data/neo4j/embeddings/utils.ts
 function withProviderErrorMetadata(error, message) {
   const wrappedError = new Error(message);
-  if (!isRecord2(error)) return wrappedError;
+  if (!isRecord3(error)) return wrappedError;
   if (typeof error.code === "string") wrappedError.code = error.code;
   if (error.response !== void 0) wrappedError.response = error.response;
   return wrappedError;
@@ -2574,12 +2642,12 @@ var DEFAULT_RETRY_CONFIG2 = {
   // 10 seconds
   backoffMultiplier: 2
 };
-function isRecord2(value) {
+function isRecord3(value) {
   return typeof value === "object" && value !== null;
 }
 function isRetryableError2(error) {
-  if (!isRecord2(error)) return false;
-  const response = isRecord2(error.response) ? error.response : void 0;
+  if (!isRecord3(error)) return false;
+  const response = isRecord3(error.response) ? error.response : void 0;
   const status = typeof response?.status === "number" ? response.status : void 0;
   const code = typeof error.code === "string" ? error.code : void 0;
   const message = typeof error.message === "string" ? error.message : void 0;
@@ -2705,7 +2773,7 @@ var OpenAIEmbeddingProvider = class {
     const modelToUse = model || this.defaultModel;
     return retryWithBackoff2(async () => {
       try {
-        const response = await axios11.post(
+        const response = await axios5.post(
           `${this.baseURL}/embeddings`,
           {
             input: text,
@@ -2735,7 +2803,7 @@ var OpenAIEmbeddingProvider = class {
         };
       } catch (error) {
         let message;
-        const response = axios11.isAxiosError(error) ? error.response : void 0;
+        const response = axios5.isAxiosError(error) ? error.response : void 0;
         if (response?.status === 401) {
           message = "Invalid OpenAI API key. Get your key at https://platform.openai.com/api-keys";
         } else if (response?.status === 429) {
@@ -2762,7 +2830,7 @@ var OpenAIEmbeddingProvider = class {
     const modelToUse = model || this.defaultModel;
     return retryWithBackoff2(async () => {
       try {
-        const response = await axios11.post(
+        const response = await axios5.post(
           `${this.baseURL}/embeddings`,
           {
             input: texts,
@@ -2793,7 +2861,7 @@ var OpenAIEmbeddingProvider = class {
         };
       } catch (error) {
         let message;
-        const response = axios11.isAxiosError(error) ? error.response : void 0;
+        const response = axios5.isAxiosError(error) ? error.response : void 0;
         if (response?.status === 401) {
           message = "Invalid OpenAI API key. Get your key at https://platform.openai.com/api-keys";
         } else if (response?.status === 429) {
@@ -2835,7 +2903,7 @@ var CohereEmbeddingProvider = class {
     const modelToUse = model || this.defaultModel;
     return retryWithBackoff2(async () => {
       try {
-        const response = await axios11.post(
+        const response = await axios5.post(
           `${this.baseUrl}/embed`,
           {
             texts,
@@ -2863,7 +2931,7 @@ var CohereEmbeddingProvider = class {
           } : void 0
         };
       } catch (error) {
-        if (axios11.isAxiosError(error)) {
+        if (axios5.isAxiosError(error)) {
           const status = error.response?.status;
           const providerMessage = error.response?.data?.message || error.message;
           let message;
@@ -2901,7 +2969,7 @@ var HuggingFaceEmbeddingProvider = class {
     const modelToUse = model || this.defaultModel;
     return retryWithBackoff2(async () => {
       try {
-        const response = await axios11.post(
+        const response = await axios5.post(
           `${this.baseUrl}/${modelToUse}`,
           {
             inputs: text,
@@ -2923,7 +2991,7 @@ var HuggingFaceEmbeddingProvider = class {
           dimensions: embedding.length
         };
       } catch (error) {
-        if (axios11.isAxiosError(error)) {
+        if (axios5.isAxiosError(error)) {
           const status = error.response?.status;
           const message = error.response?.data?.error || error.message;
           let messageText;
@@ -2948,7 +3016,7 @@ var HuggingFaceEmbeddingProvider = class {
     const modelToUse = model || this.defaultModel;
     return retryWithBackoff2(async () => {
       try {
-        const response = await axios11.post(
+        const response = await axios5.post(
           `${this.baseUrl}/${modelToUse}`,
           {
             inputs: texts,
@@ -2971,7 +3039,7 @@ var HuggingFaceEmbeddingProvider = class {
           dimensions
         };
       } catch (error) {
-        if (axios11.isAxiosError(error)) {
+        if (axios5.isAxiosError(error)) {
           const status = error.response?.status;
           const message = error.response?.data?.error || error.message;
           let messageText;
@@ -3020,7 +3088,7 @@ var VoyageEmbeddingProvider = class {
     const modelToUse = model || this.defaultModel;
     return retryWithBackoff2(async () => {
       try {
-        const response = await axios11.post(
+        const response = await axios5.post(
           `${this.baseUrl}/embeddings`,
           {
             input: texts,
@@ -3047,7 +3115,7 @@ var VoyageEmbeddingProvider = class {
           } : void 0
         };
       } catch (error) {
-        if (axios11.isAxiosError(error)) {
+        if (axios5.isAxiosError(error)) {
           const status = error.response?.status;
           const message = error.response?.data?.message || error.message;
           let messageText;
@@ -3084,7 +3152,7 @@ var OllamaEmbeddingProvider = class {
     const modelToUse = model || this.defaultModel;
     return retryWithBackoff2(async () => {
       try {
-        const response = await axios11.post(
+        const response = await axios5.post(
           `${this.baseUrl}/api/embeddings`,
           {
             model: modelToUse,
@@ -3103,7 +3171,7 @@ var OllamaEmbeddingProvider = class {
           dimensions: embedding.length
         };
       } catch (error) {
-        if (axios11.isAxiosError(error)) {
+        if (axios5.isAxiosError(error)) {
           const status = error.response?.status;
           const message = error.response?.data?.error || error.message;
           let messageText;
@@ -3496,6 +3564,16 @@ function formatResults(records) {
   });
 }
 
+// src/data/neo4j/tools/session-owner.ts
+async function withNeo4jSession(database, operation) {
+  const session = neo4jPool.getSession(database);
+  try {
+    return await operation(session);
+  } finally {
+    await session.close();
+  }
+}
+
 // src/data/neo4j/tools/neo4j-query.ts
 var logger4 = createLogger("agentforge:tools:neo4j:query");
 function createNeo4jQueryTool() {
@@ -3516,8 +3594,7 @@ function createNeo4jQueryTool() {
       ...input.database ? { database: input.database } : {}
     });
     try {
-      const session = neo4jPool.getSession(input.database);
-      try {
+      return await withNeo4jSession(input.database, async (session) => {
         const result = await session.run(input.cypher, input.parameters || {});
         const formattedResults = formatResults(result.records);
         const duration = Date.now() - startTime;
@@ -3546,9 +3623,7 @@ function createNeo4jQueryTool() {
             }
           }
         };
-      } finally {
-        await session.close();
-      }
+      });
     } catch (error) {
       const duration = Date.now() - startTime;
       const errorMessage = error instanceof Error ? error.message : "Failed to execute query";
@@ -3576,8 +3651,7 @@ function createNeo4jGetSchemaTool() {
       };
     }
     try {
-      const session = neo4jPool.getSession(input.database);
-      try {
+      return await withNeo4jSession(input.database, async (session) => {
         const labelsResult = await session.run("CALL db.labels()");
         const nodeLabels = labelsResult.records.map((r) => r.get("label"));
         const relTypesResult = await session.run("CALL db.relationshipTypes()");
@@ -3617,9 +3691,7 @@ function createNeo4jGetSchemaTool() {
             totalIndexes: indexes.length
           }
         };
-      } finally {
-        await session.close();
-      }
+      });
     } catch (error) {
       return {
         success: false,
@@ -3698,8 +3770,7 @@ function createNeo4jFindNodesTool() {
     }
     try {
       const safeLabel = validateLabel(input.label);
-      const session = neo4jPool.getSession(input.database);
-      try {
+      return await withNeo4jSession(input.database, async (session) => {
         let cypher = `MATCH (n:${safeLabel})`;
         let parameters = {};
         if (input.properties && Object.keys(input.properties).length > 0) {
@@ -3721,9 +3792,7 @@ function createNeo4jFindNodesTool() {
             limit: input.limit
           }
         };
-      } finally {
-        await session.close();
-      }
+      });
     } catch (error) {
       return {
         success: false,
@@ -3749,8 +3818,7 @@ function createNeo4jTraverseTool() {
     try {
       const safeDirection = validateDirection(input.direction || "outgoing");
       const safeRelType = input.relationshipType ? validateRelationshipType(input.relationshipType) : null;
-      const session = neo4jPool.getSession(input.database);
-      try {
+      return await withNeo4jSession(input.database, async (session) => {
         let relPattern = "";
         if (safeDirection === "OUTGOING") {
           relPattern = safeRelType ? `-[r:${safeRelType}*1..${input.maxDepth}]->` : `-[r*1..${input.maxDepth}]->`;
@@ -3787,9 +3855,7 @@ function createNeo4jTraverseTool() {
             maxDepth: input.maxDepth
           }
         };
-      } finally {
-        await session.close();
-      }
+      });
     } catch (error) {
       return {
         success: false,
@@ -3814,8 +3880,7 @@ function createNeo4jVectorSearchTool() {
       };
     }
     try {
-      const session = neo4jPool.getSession(input.database);
-      try {
+      return await withNeo4jSession(input.database, async (session) => {
         const cypher = `
             CALL db.index.vector.queryNodes($indexName, $limit, $queryVector)
             YIELD node, score
@@ -3842,9 +3907,7 @@ function createNeo4jVectorSearchTool() {
             limit: input.limit
           }
         };
-      } finally {
-        await session.close();
-      }
+      });
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : "Failed to perform vector search";
       let helpText = "";
@@ -3890,8 +3953,7 @@ function createNeo4jVectorSearchWithEmbeddingTool() {
     });
     try {
       const embeddingResult = await embeddingManager.generateEmbedding(input.queryText, input.model);
-      const session = neo4jPool.getSession(input.database);
-      try {
+      return await withNeo4jSession(input.database, async (session) => {
         const cypher = `
             CALL db.index.vector.queryNodes($indexName, $limit, $queryVector)
             YIELD node, score
@@ -3933,9 +3995,7 @@ function createNeo4jVectorSearchWithEmbeddingTool() {
             usage: embeddingResult.usage
           }
         };
-      } finally {
-        await session.close();
-      }
+      });
     } catch (error) {
       const duration = Date.now() - startTime;
       const errorMessage = error instanceof Error ? error.message : "Failed to perform vector search with embedding";
@@ -3991,8 +4051,7 @@ function createNeo4jCreateNodeWithEmbeddingTool() {
       const embeddingResult = await embeddingManager.generateEmbedding(textToEmbed, input.model);
       const safeLabel = validateLabel(input.label);
       const safeEmbeddingProp = validatePropertyKey(input.embeddingProperty || "embedding");
-      const session = neo4jPool.getSession(input.database);
-      try {
+      return await withNeo4jSession(input.database, async (session) => {
         const allProperties = {
           ...input.properties
         };
@@ -4026,9 +4085,7 @@ function createNeo4jCreateNodeWithEmbeddingTool() {
           },
           message: `Created node with label '${input.label}' and ${embeddingResult.dimensions}-dimensional embedding`
         };
-      } finally {
-        await session.close();
-      }
+      });
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : "Failed to create node with embedding";
       let helpText = "";
@@ -10315,49 +10372,57 @@ var fileSearchSchema = z.object({
   recursive: z.boolean().default(true).describe("Search in subdirectories"),
   caseSensitive: z.boolean().default(false).describe("Case-sensitive pattern matching")
 });
+async function* traverseDirectory(directory, recursive) {
+  const entries = await promises.readdir(directory, { withFileTypes: true });
+  for (const entry of entries) {
+    const fullPath = path.join(directory, entry.name);
+    const isDirectory = entry.isDirectory();
+    yield {
+      name: entry.name,
+      fullPath,
+      isFile: entry.isFile(),
+      isDirectory
+    };
+    if (recursive && isDirectory) {
+      yield* traverseDirectory(fullPath, true);
+    }
+  }
+}
+
+// src/file/directory/tools/directory-list.ts
 function createDirectoryListTool(defaultRecursive = false, defaultIncludeDetails = false, policy = DEFAULT_FILE_SYSTEM_POLICY) {
   return toolBuilder().name("directory-list").description("List all files and directories in a directory. Can optionally include file details and filter by extension.").category(ToolCategory.FILE_SYSTEM).tags(["directory", "list", "files", "filesystem"]).schema(directoryListSchema).implementSafe(async (input) => {
     const safePath = await policy.resolvePath(input.path, "directory listing");
     const includeDetails = input.includeDetails ?? defaultIncludeDetails;
-    const listFiles = async (dir, recursive2) => {
-      const entries = await promises.readdir(dir, { withFileTypes: true });
-      const files2 = [];
-      for (const entry of entries) {
-        const fullPath = path.join(dir, entry.name);
-        const relativePath = path.relative(safePath, fullPath);
-        if (input.extension && !entry.name.endsWith(input.extension)) {
-          if (!entry.isDirectory() || !recursive2) {
-            continue;
-          }
-        }
-        if (includeDetails) {
-          const stats = await promises.lstat(fullPath);
-          files2.push({
-            name: entry.name,
-            path: relativePath,
-            fullPath,
-            isFile: entry.isFile(),
-            isDirectory: entry.isDirectory(),
-            size: stats.size,
-            modified: stats.mtime.toISOString()
-          });
-        } else {
-          files2.push({
-            name: entry.name,
-            path: relativePath,
-            isFile: entry.isFile(),
-            isDirectory: entry.isDirectory()
-          });
-        }
-        if (recursive2 && entry.isDirectory()) {
-          const subFiles = await listFiles(fullPath, true);
-          files2.push(...subFiles);
+    const recursive = input.recursive ?? defaultRecursive;
+    const files = [];
+    for await (const entry of traverseDirectory(safePath, recursive)) {
+      const relativePath = path.relative(safePath, entry.fullPath);
+      if (input.extension && !entry.name.endsWith(input.extension)) {
+        if (!entry.isDirectory || !recursive) {
+          continue;
         }
       }
-      return files2;
-    };
-    const recursive = input.recursive ?? defaultRecursive;
-    const files = await listFiles(safePath, recursive);
+      if (includeDetails) {
+        const stats = await promises.lstat(entry.fullPath);
+        files.push({
+          name: entry.name,
+          path: relativePath,
+          fullPath: entry.fullPath,
+          isFile: entry.isFile,
+          isDirectory: entry.isDirectory,
+          size: stats.size,
+          modified: stats.mtime.toISOString()
+        });
+      } else {
+        files.push({
+          name: entry.name,
+          path: relativePath,
+          isFile: entry.isFile,
+          isDirectory: entry.isDirectory
+        });
+      }
+    }
     const result = {
       path: input.path,
       files,
@@ -10393,24 +10458,14 @@ function createFileSearchTool(defaultRecursive = true, defaultCaseSensitive = fa
     const recursive = input.recursive ?? defaultRecursive;
     const caseSensitive = input.caseSensitive ?? defaultCaseSensitive;
     const safeDirectory = await policy.resolvePath(input.directory, "file search");
-    const searchFiles = async (dir) => {
-      const entries = await promises.readdir(dir, { withFileTypes: true });
-      const matches2 = [];
-      const regexPattern = input.pattern.replace(/\./g, "\\.").replace(/\*/g, ".*");
-      const regex = new RegExp(`^${regexPattern}$`, caseSensitive ? "" : "i");
-      for (const entry of entries) {
-        const fullPath = path.join(dir, entry.name);
-        if (entry.isFile() && regex.test(entry.name)) {
-          matches2.push(fullPath);
-        }
-        if (recursive && entry.isDirectory()) {
-          const subMatches = await searchFiles(fullPath);
-          matches2.push(...subMatches);
-        }
+    const regexPattern = input.pattern.replace(/\./g, "\\.").replace(/\*/g, ".*");
+    const regex = new RegExp(`^${regexPattern}$`, caseSensitive ? "" : "i");
+    const matches = [];
+    for await (const entry of traverseDirectory(safeDirectory, recursive)) {
+      if (entry.isFile && regex.test(entry.name)) {
+        matches.push(entry.fullPath);
       }
-      return matches2;
-    };
-    const matches = await searchFiles(safeDirectory);
+    }
     return {
       directory: input.directory,
       pattern: input.pattern,
@@ -11372,11 +11427,11 @@ var AskHumanInputSchema = z.object({
 });
 var logLevel3 = process.env.LOG_LEVEL?.toLowerCase() || LogLevel.INFO;
 var logger19 = createLogger("agentforge:tools:agent:ask-human", { level: logLevel3 });
-function isRecord3(value) {
+function isRecord4(value) {
   return typeof value === "object" && value !== null;
 }
 function resolveInterrupt(module) {
-  if (!isRecord3(module)) {
+  if (!isRecord4(module)) {
     return void 0;
   }
   const candidate = module.interrupt;