@agentforge/tools 0.16.63 → 0.16.65

package/dist/index.js

@@ -788,7 +788,7 @@ function getDefaultSlackClient() {
     }
   };
 }
-function createSendSlackMessageTool(getSlackClient, logger19) {
+function createSendSlackMessageTool(getSlackClient, logger18) {
   return toolBuilder().name("send-slack-message").description("Send a message to a Slack channel for team communication and notifications").category(ToolCategory.WEB).tags(["slack", "messaging", "communication"]).usageNotes(
     "Use this for general team communication. For notifications with @mentions, consider using notify-slack instead. Use get-slack-channels first if you need to find the right channel."
   ).suggests(["get-slack-channels"]).schema(
@@ -797,7 +797,7 @@ function createSendSlackMessageTool(getSlackClient, logger19) {
       message: z.string().describe("Message content to send")
     })
   ).implementSafe(async ({ channel, message }) => {
-    logger19.info("send-slack-message called", { channel, messageLength: message.length });
+    logger18.info("send-slack-message called", { channel, messageLength: message.length });
     try {
       const { client: slack, config } = getSlackClient();
       const result = await slack.chat.postMessage({
@@ -806,7 +806,7 @@ function createSendSlackMessageTool(getSlackClient, logger19) {
         username: config.botName,
         icon_emoji: config.botIcon
       });
-      logger19.info("send-slack-message result", {
+      logger18.info("send-slack-message result", {
         ...result.channel ? { channel: result.channel } : {},
         ...result.ts ? { timestamp: result.ts } : {},
         messageLength: message.length,
@@ -819,7 +819,7 @@ function createSendSlackMessageTool(getSlackClient, logger19) {
         message_id: result.ts
       };
     } catch (error) {
-      logger19.error("send-slack-message failed", {
+      logger18.error("send-slack-message failed", {
         channel,
         error: error.message,
         data: error.data
@@ -828,7 +828,7 @@ function createSendSlackMessageTool(getSlackClient, logger19) {
     }
   }).build();
 }
-function createNotifySlackTool(getSlackClient, logger19) {
+function createNotifySlackTool(getSlackClient, logger18) {
   return toolBuilder().name("notify-slack").description("Send a notification to a Slack channel with optional @mentions for urgent alerts").category(ToolCategory.WEB).tags(["slack", "notification", "alert"]).usageNotes(
     "Use this for urgent notifications that require @mentions. For general messages without mentions, use send-slack-message instead."
   ).suggests(["get-slack-channels"]).schema(
@@ -838,7 +838,7 @@ function createNotifySlackTool(getSlackClient, logger19) {
       mentions: z.array(z.string()).optional().describe("List of usernames to mention (without @)")
     })
   ).implementSafe(async ({ channel, message, mentions = [] }) => {
-    logger19.info("notify-slack called", {
+    logger18.info("notify-slack called", {
       channel,
       messageLength: message.length,
       mentionCount: mentions.length
@@ -852,7 +852,7 @@ function createNotifySlackTool(getSlackClient, logger19) {
       username: config.botName,
       icon_emoji: config.botIcon
     });
-    logger19.info("notify-slack result", {
+    logger18.info("notify-slack result", {
       ...result.channel ? { channel: result.channel } : {},
       ...result.ts ? { timestamp: result.ts } : {},
       mentions: mentions.length
@@ -866,7 +866,7 @@ function createNotifySlackTool(getSlackClient, logger19) {
     };
   }).build();
 }
-function createGetSlackChannelsTool(getSlackClient, logger19) {
+function createGetSlackChannelsTool(getSlackClient, logger18) {
   return toolBuilder().name("get-slack-channels").description("Get a list of available Slack channels to find the right channel for messaging").category(ToolCategory.WEB).tags(["slack", "channels", "list"]).usageNotes(
     "Use this first to discover available channels before sending messages. Helps ensure you are sending to the correct channel."
   ).follows(["send-slack-message", "notify-slack"]).schema(
@@ -874,7 +874,7 @@ function createGetSlackChannelsTool(getSlackClient, logger19) {
       include_private: z.boolean().optional().describe("Include private channels (default: false)")
     })
   ).implementSafe(async ({ include_private = false }) => {
-    logger19.info("get-slack-channels called", { include_private });
+    logger18.info("get-slack-channels called", { include_private });
     const { client: slack } = getSlackClient();
     const publicChannels = await slack.conversations.list({
       types: "public_channel",
@@ -888,7 +888,7 @@ function createGetSlackChannelsTool(getSlackClient, logger19) {
       });
       allChannels = [...allChannels, ...privateChannels.channels || []];
     }
-    logger19.info("get-slack-channels result", {
+    logger18.info("get-slack-channels result", {
       channelCount: allChannels.length,
       includePrivate: include_private
     });
@@ -903,7 +903,7 @@ function createGetSlackChannelsTool(getSlackClient, logger19) {
     };
   }).build();
 }
-function createGetSlackMessagesTool(getSlackClient, logger19) {
+function createGetSlackMessagesTool(getSlackClient, logger18) {
   return toolBuilder().name("get-slack-messages").description("Retrieve message history from a Slack channel to read recent conversations").category(ToolCategory.WEB).tags(["slack", "messages", "history", "read"]).usageNotes(
     "Use this to read recent messages from a channel. Use get-slack-channels first if you need to find the channel ID. Returns messages in reverse chronological order (newest first)."
   ).suggests(["get-slack-channels"]).schema(
@@ -912,7 +912,7 @@ function createGetSlackMessagesTool(getSlackClient, logger19) {
       limit: z.number().int().min(1).max(100).optional().describe("Number of messages to retrieve (default: 20, max: 100)")
     })
   ).implementSafe(async ({ channel, limit = 20 }) => {
-    logger19.info("get-slack-messages called", { channel, limit });
+    logger18.info("get-slack-messages called", { channel, limit });
     try {
       const { client: slack } = getSlackClient();
       let channelId = channel;
@@ -923,7 +923,7 @@ function createGetSlackMessagesTool(getSlackClient, logger19) {
         });
         const found = channels.channels?.find((c) => c.name === channel);
         if (!found) {
-          logger19.error("get-slack-messages: channel not found", { channel });
+          logger18.error("get-slack-messages: channel not found", { channel });
           throw new Error(
             `Channel '${channel}' not found. Use get-slack-channels to see available channels.`
           );
@@ -935,7 +935,7 @@ function createGetSlackMessagesTool(getSlackClient, logger19) {
         limit: Math.min(limit, 100)
         // Cap at 100 for performance
       });
-      logger19.info("get-slack-messages result", {
+      logger18.info("get-slack-messages result", {
         channel: channelId,
         messageCount: result.messages?.length || 0,
         limit
@@ -953,7 +953,7 @@ function createGetSlackMessagesTool(getSlackClient, logger19) {
         })) || []
       };
     } catch (error) {
-      logger19.error("get-slack-messages failed", {
+      logger18.error("get-slack-messages failed", {
         channel,
         error: error.message,
         data: error.data
@@ -1034,12 +1034,12 @@ function getAuthHeader() {
   const auth2 = Buffer.from(`${ATLASSIAN_EMAIL}:${ATLASSIAN_API_KEY}`).toString("base64");
   return `Basic ${auth2}`;
 }
-function createSearchConfluenceTool(getAuth, getAuthHeader2, logger19) {
+function createSearchConfluenceTool(getAuth, getAuthHeader2, logger18) {
   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 }) => {
-    logger19.info("search-confluence called", { query, limit });
+    logger18.info("search-confluence called", { query, limit });
     try {
       const { ATLASSIAN_SITE_URL } = getAuth();
       const response = await axios16.get(`${ATLASSIAN_SITE_URL}/wiki/rest/api/content/search`, {
@@ -1064,13 +1064,13 @@ function createSearchConfluenceTool(getAuth, getAuthHeader2, logger19) {
         lastModified: page.version?.when || ""
       }));
       if (results.length === 0) {
-        logger19.warn("search-confluence returned NO RESULTS - this is a valid outcome, agent should not retry", {
+        logger18.warn("search-confluence returned NO RESULTS - this is a valid outcome, agent should not retry", {
           query,
           limit,
           totalSize: response.data.totalSize
         });
       } else {
-        logger19.info("search-confluence result", {
+        logger18.info("search-confluence result", {
           query,
           resultCount: results.length,
           totalSize: response.data.totalSize,
@@ -1085,7 +1085,7 @@ function createSearchConfluenceTool(getAuth, getAuthHeader2, logger19) {
         results
       });
     } catch (error) {
-      logger19.error("search-confluence error", {
+      logger18.error("search-confluence error", {
         query,
         error: error.response?.data?.message || error.message,
         status: error.response?.status
@@ -1097,11 +1097,11 @@ function createSearchConfluenceTool(getAuth, getAuthHeader2, logger19) {
     }
   }).build();
 }
-function createGetConfluencePageTool(getAuth, getAuthHeader2, logger19) {
+function createGetConfluencePageTool(getAuth, getAuthHeader2, logger18) {
   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 }) => {
-    logger19.info("get-confluence-page called", { page_id });
+    logger18.info("get-confluence-page called", { page_id });
     try {
       const { ATLASSIAN_SITE_URL } = getAuth();
       const response = await axios16.get(`${ATLASSIAN_SITE_URL}/wiki/rest/api/content/${page_id}`, {
@@ -1114,7 +1114,7 @@ function createGetConfluencePageTool(getAuth, getAuthHeader2, logger19) {
         }
       });
       const page = response.data;
-      logger19.info("get-confluence-page result", {
+      logger18.info("get-confluence-page result", {
         page_id,
         title: page.title,
         space: page.space?.name,
@@ -1136,7 +1136,7 @@ function createGetConfluencePageTool(getAuth, getAuthHeader2, logger19) {
         }
       });
     } catch (error) {
-      logger19.error("get-confluence-page error", {
+      logger18.error("get-confluence-page error", {
         page_id,
         error: error.response?.data?.message || error.message,
         status: error.response?.status
@@ -1148,11 +1148,11 @@ function createGetConfluencePageTool(getAuth, getAuthHeader2, logger19) {
     }
   }).build();
 }
-function createListConfluenceSpacesTool(getAuth, getAuthHeader2, logger19) {
+function createListConfluenceSpacesTool(getAuth, getAuthHeader2, logger18) {
   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 }) => {
-    logger19.info("list-confluence-spaces called", { limit });
+    logger18.info("list-confluence-spaces called", { limit });
     try {
       const { ATLASSIAN_SITE_URL } = getAuth();
       const response = await axios16.get(`${ATLASSIAN_SITE_URL}/wiki/rest/api/space`, {
@@ -1171,7 +1171,7 @@ function createListConfluenceSpacesTool(getAuth, getAuthHeader2, logger19) {
         description: space.description?.plain?.value || "",
         url: `${ATLASSIAN_SITE_URL}/wiki${space._links.webui}`
       }));
-      logger19.info("list-confluence-spaces result", {
+      logger18.info("list-confluence-spaces result", {
         spaceCount: spaces.length,
         spaceKeys: spaces.map((s) => s.key).slice(0, 5)
         // Log first 5 space keys
@@ -1182,7 +1182,7 @@ function createListConfluenceSpacesTool(getAuth, getAuthHeader2, logger19) {
         spaces
       });
     } catch (error) {
-      logger19.error("list-confluence-spaces error", {
+      logger18.error("list-confluence-spaces error", {
         error: error.response?.data?.message || error.message,
         status: error.response?.status
       });
@@ -1193,12 +1193,12 @@ function createListConfluenceSpacesTool(getAuth, getAuthHeader2, logger19) {
     }
   }).build();
 }
-function createGetSpacePagesTool(getAuth, getAuthHeader2, logger19) {
+function createGetSpacePagesTool(getAuth, getAuthHeader2, logger18) {
   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 }) => {
-    logger19.info("get-space-pages called", { space_key, limit });
+    logger18.info("get-space-pages called", { space_key, limit });
     try {
       const { ATLASSIAN_SITE_URL } = getAuth();
       const response = await axios16.get(`${ATLASSIAN_SITE_URL}/wiki/rest/api/content`, {
@@ -1220,12 +1220,12 @@ function createGetSpacePagesTool(getAuth, getAuthHeader2, logger19) {
         lastModified: page.version?.when || ""
       }));
       if (pages.length === 0) {
-        logger19.warn("get-space-pages returned NO PAGES - this is a valid outcome, agent should not retry", {
+        logger18.warn("get-space-pages returned NO PAGES - this is a valid outcome, agent should not retry", {
           space_key,
           limit
         });
       } else {
-        logger19.info("get-space-pages result", {
+        logger18.info("get-space-pages result", {
           space_key,
           pageCount: pages.length,
           titles: pages.map((p) => p.title).slice(0, 3)
@@ -1239,7 +1239,7 @@ function createGetSpacePagesTool(getAuth, getAuthHeader2, logger19) {
         pages
       });
     } catch (error) {
-      logger19.error("get-space-pages error", {
+      logger18.error("get-space-pages error", {
         space_key,
         error: error.response?.data?.message || error.message,
         status: error.response?.status
@@ -1251,14 +1251,14 @@ function createGetSpacePagesTool(getAuth, getAuthHeader2, logger19) {
     }
   }).build();
 }
-function createCreateConfluencePageTool(getAuth, getAuthHeader2, logger19) {
+function createCreateConfluencePageTool(getAuth, getAuthHeader2, logger18) {
   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 }) => {
-    logger19.info("create-confluence-page called", { space_key, title, hasParent: !!parent_page_id });
+    logger18.info("create-confluence-page called", { space_key, title, hasParent: !!parent_page_id });
     try {
       const { ATLASSIAN_SITE_URL } = getAuth();
       const pageData = {
@@ -1285,7 +1285,7 @@ function createCreateConfluencePageTool(getAuth, getAuthHeader2, logger19) {
           }
         }
       );
-      logger19.info("create-confluence-page result", {
+      logger18.info("create-confluence-page result", {
         page_id: response.data.id,
         title: response.data.title,
         space: space_key
@@ -1301,7 +1301,7 @@ function createCreateConfluencePageTool(getAuth, getAuthHeader2, logger19) {
         }
       });
     } catch (error) {
-      logger19.error("create-confluence-page error", {
+      logger18.error("create-confluence-page error", {
         space_key,
         title,
         error: error.response?.data?.message || error.message,
@@ -1314,13 +1314,13 @@ function createCreateConfluencePageTool(getAuth, getAuthHeader2, logger19) {
     }
   }).build();
 }
-function createUpdateConfluencePageTool(getAuth, getAuthHeader2, logger19) {
+function createUpdateConfluencePageTool(getAuth, getAuthHeader2, logger18) {
   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 }) => {
-    logger19.info("update-confluence-page called", { page_id, title });
+    logger18.info("update-confluence-page called", { page_id, title });
     try {
       const { ATLASSIAN_SITE_URL } = getAuth();
       const getResponse = await axios16.get(
@@ -1353,7 +1353,7 @@ function createUpdateConfluencePageTool(getAuth, getAuthHeader2, logger19) {
           }
         }
       );
-      logger19.info("update-confluence-page result", {
+      logger18.info("update-confluence-page result", {
         page_id,
         title: updateResponse.data.title,
         previousVersion: currentVersion,
@@ -1370,7 +1370,7 @@ function createUpdateConfluencePageTool(getAuth, getAuthHeader2, logger19) {
         }
       });
     } catch (error) {
-      logger19.error("update-confluence-page error", {
+      logger18.error("update-confluence-page error", {
         page_id,
         title,
         error: error.response?.data?.message || error.message,
@@ -1383,12 +1383,12 @@ function createUpdateConfluencePageTool(getAuth, getAuthHeader2, logger19) {
     }
   }).build();
 }
-function createArchiveConfluencePageTool(getAuth, getAuthHeader2, logger19) {
+function createArchiveConfluencePageTool(getAuth, getAuthHeader2, logger18) {
   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 }) => {
-    logger19.info("archive-confluence-page called", {
+    logger18.info("archive-confluence-page called", {
       page_id,
       ...reason ? { reason } : {}
     });
@@ -1422,7 +1422,7 @@ function createArchiveConfluencePageTool(getAuth, getAuthHeader2, logger19) {
           }
         }
       );
-      logger19.info("archive-confluence-page result", {
+      logger18.info("archive-confluence-page result", {
         page_id,
         title: pageData.title,
         previousVersion: currentVersion,
@@ -1440,7 +1440,7 @@ function createArchiveConfluencePageTool(getAuth, getAuthHeader2, logger19) {
         }
       });
     } catch (error) {
-      logger19.error("archive-confluence-page error", {
+      logger18.error("archive-confluence-page error", {
         page_id,
         error: error.response?.data?.message || error.message,
         status: error.response?.status
@@ -4168,19 +4168,19 @@ var ConnectionState = /* @__PURE__ */ ((ConnectionState2) => {
   ConnectionState2["ERROR"] = "error";
   return ConnectionState2;
 })(ConnectionState || {});
-function cancelPendingReconnection(timer, logger19, vendor, message) {
+function cancelPendingReconnection(timer, logger18, vendor, message) {
   if (!timer) {
     return null;
   }
-  logger19.debug(message, { vendor });
+  logger18.debug(message, { vendor });
   clearTimeout(timer);
   return null;
 }
-async function waitForInFlightConnection(promise, logger19, vendor, phase) {
+async function waitForInFlightConnection(promise, logger18, vendor, phase) {
   if (!promise) {
     return null;
   }
-  logger19.debug(`Waiting for in-flight connection attempt to complete before ${phase}`, {
+  logger18.debug(`Waiting for in-flight connection attempt to complete before ${phase}`, {
     vendor
   });
   try {
@@ -4197,9 +4197,9 @@ function shutdownClient(vendor, client) {
     client.close();
   }
 }
-function scheduleReconnection(context, logger19) {
+function scheduleReconnection(context, logger18) {
   if (context.reconnectionConfig.maxAttempts > 0 && context.reconnectionAttempts >= context.reconnectionConfig.maxAttempts) {
-    logger19.error("Max reconnection attempts reached", {
+    logger18.error("Max reconnection attempts reached", {
       vendor: context.vendor,
       attempts: context.reconnectionAttempts,
       maxAttempts: context.reconnectionConfig.maxAttempts
@@ -4213,7 +4213,7 @@ function scheduleReconnection(context, logger19) {
   const nextAttempt = context.reconnectionAttempts + 1;
   context.setReconnectionAttempts(nextAttempt);
   context.setState("reconnecting" /* RECONNECTING */);
-  logger19.info("Scheduling reconnection attempt", {
+  logger18.info("Scheduling reconnection attempt", {
     vendor: context.vendor,
     attempt: nextAttempt,
     maxAttempts: context.reconnectionConfig.maxAttempts,
@@ -4227,7 +4227,7 @@ function scheduleReconnection(context, logger19) {
   const timer = setTimeout(async () => {
     context.setReconnectionTimer(null);
     try {
-      logger19.info("Attempting reconnection", {
+      logger18.info("Attempting reconnection", {
         vendor: context.vendor,
         attempt: nextAttempt
       });
@@ -4237,7 +4237,7 @@ function scheduleReconnection(context, logger19) {
       context.setConnectPromise(promise);
       await promise;
     } catch (error) {
-      logger19.error("Reconnection attempt failed", {
+      logger18.error("Reconnection attempt failed", {
         vendor: context.vendor,
         attempt: nextAttempt,
         error: error instanceof Error ? error.message : String(error)
@@ -4248,17 +4248,17 @@ function scheduleReconnection(context, logger19) {
 }
 
 // src/data/relational/connection/connection-cleanup.ts
-async function cleanupConnectionResources(vendor, client, clearConnection, logger19) {
+async function cleanupConnectionResources(vendor, client, clearConnection, logger18) {
   if (!client) {
     return;
   }
-  logger19.debug("Cleaning up cancelled connection", {
+  logger18.debug("Cleaning up cancelled connection", {
     vendor
   });
   try {
     await shutdownClient(vendor, client);
   } catch (error) {
-    logger19.debug("Error during cancelled connection cleanup", {
+    logger18.debug("Error during cancelled connection cleanup", {
       vendor,
       error: error instanceof Error ? error.message : String(error)
     });
@@ -4266,10 +4266,10 @@ async function cleanupConnectionResources(vendor, client, clearConnection, logge
     clearConnection();
   }
 }
-async function closeManagedConnection(runtime, logger19) {
+async function closeManagedConnection(runtime, logger18) {
   const client = runtime.getClient();
   if (client) {
-    logger19.info("Closing database connection", {
+    logger18.info("Closing database connection", {
       vendor: runtime.vendor,
       state: runtime.getState()
     });
@@ -4277,12 +4277,12 @@ async function closeManagedConnection(runtime, logger19) {
       await shutdownClient(runtime.vendor, client);
       runtime.setState("disconnected" /* DISCONNECTED */);
       runtime.emitDisconnected();
-      logger19.debug("Database connection closed successfully", {
+      logger18.debug("Database connection closed successfully", {
         vendor: runtime.vendor,
         state: runtime.getState()
       });
     } catch (error) {
-      logger19.error("Error closing database connection", {
+      logger18.error("Error closing database connection", {
         vendor: runtime.vendor,
         error: error instanceof Error ? error.message : String(error),
         state: runtime.getState()
@@ -4455,11 +4455,11 @@ async function initializeSQLiteConnection(connection) {
 }
 
 // src/data/relational/connection/connection-initialization.ts
-async function initializeManagedConnection(runtime, logger19) {
+async function initializeManagedConnection(runtime, logger18) {
   const startTime = Date.now();
   const currentGeneration = runtime.getConnectionGeneration();
   if (runtime.getState() === "connected" /* CONNECTED */ && runtime.getClient()) {
-    logger19.warn("Re-initializing an already connected manager; emitting disconnected before cleanup", {
+    logger18.warn("Re-initializing an already connected manager; emitting disconnected before cleanup", {
       vendor: runtime.vendor
     });
     runtime.setState("disconnected" /* DISCONNECTED */);
@@ -4471,11 +4471,11 @@ async function initializeManagedConnection(runtime, logger19) {
         runtime.setClient(null);
         runtime.setDb(null);
       },
-      logger19
+      logger18
     );
   }
   runtime.setState("connecting" /* CONNECTING */);
-  logger19.info("Initializing database connection", {
+  logger18.info("Initializing database connection", {
     vendor: runtime.vendor,
     connectionType: typeof runtime.config.connection,
     state: runtime.getState()
@@ -4485,7 +4485,7 @@ async function initializeManagedConnection(runtime, logger19) {
     runtime.setClient(initialized.client);
     runtime.setDb(initialized.db);
     if (currentGeneration !== runtime.getConnectionGeneration()) {
-      logger19.debug("Connection cancelled during initialization", {
+      logger18.debug("Connection cancelled during initialization", {
         vendor: runtime.vendor,
         currentGeneration,
         newGeneration: runtime.getConnectionGeneration()
@@ -4497,18 +4497,18 @@ async function initializeManagedConnection(runtime, logger19) {
           runtime.setClient(null);
           runtime.setDb(null);
         },
-        logger19
+        logger18
       );
       runtime.setState("disconnected" /* DISCONNECTED */);
       throw new Error("Connection cancelled during initialization");
     }
-    logger19.debug("Validating connection health", { vendor: runtime.vendor });
+    logger18.debug("Validating connection health", { vendor: runtime.vendor });
     const healthy = await runtime.isHealthy();
     if (!healthy) {
       throw new Error(`Failed to establish healthy connection to ${runtime.vendor} database`);
     }
     if (currentGeneration !== runtime.getConnectionGeneration()) {
-      logger19.debug("Connection cancelled during health check", {
+      logger18.debug("Connection cancelled during health check", {
         vendor: runtime.vendor,
         currentGeneration,
         newGeneration: runtime.getConnectionGeneration()
@@ -4520,7 +4520,7 @@ async function initializeManagedConnection(runtime, logger19) {
           runtime.setClient(null);
           runtime.setDb(null);
         },
-        logger19
+        logger18
       );
       runtime.setState("disconnected" /* DISCONNECTED */);
       throw new Error("Connection cancelled during health check");
@@ -4528,7 +4528,7 @@ async function initializeManagedConnection(runtime, logger19) {
     runtime.setState("connected" /* CONNECTED */);
     runtime.emitConnected();
     runtime.resetReconnectionAttempts();
-    logger19.info("Database connection initialized successfully", {
+    logger18.info("Database connection initialized successfully", {
       vendor: runtime.vendor,
       duration: Date.now() - startTime,
       state: runtime.getState()
@@ -4549,7 +4549,7 @@ async function initializeManagedConnection(runtime, logger19) {
       if (runtime.errorListenerCount() > 0) {
         runtime.emitError(normalizedError);
       }
-      logger19.error(errorMessage, {
+      logger18.error(errorMessage, {
         vendor: runtime.vendor,
         error: normalizedError.message,
         duration: Date.now() - startTime,
@@ -4562,13 +4562,13 @@ async function initializeManagedConnection(runtime, logger19) {
           runtime.setClient(null);
           runtime.setDb(null);
         },
-        logger19
+        logger18
       );
       if (runtime.getReconnectionConfig().enabled && currentGeneration === runtime.getConnectionGeneration()) {
         runtime.scheduleReconnection();
       }
     } else {
-      logger19.debug("Connection initialization cancelled", {
+      logger18.debug("Connection initialization cancelled", {
         vendor: runtime.vendor,
         duration: Date.now() - startTime,
         state: runtime.getState()
@@ -4586,17 +4586,17 @@ function isSqliteNonQueryError(error) {
   const hasNonQueryMessage = error.message.includes("does not return data");
   return isSqliteOrTypeError && hasNonQueryMessage;
 }
-async function checkConnectionHealth(args, logger19) {
+async function checkConnectionHealth(args, logger18) {
   if (!args.db || !args.client) {
-    logger19.debug("Health check failed: connection not initialized", { vendor: args.vendor });
+    logger18.debug("Health check failed: connection not initialized", { vendor: args.vendor });
     return false;
   }
   try {
     await args.execute(sql`SELECT 1`);
-    logger19.debug("Health check passed", { vendor: args.vendor });
+    logger18.debug("Health check passed", { vendor: args.vendor });
     return true;
   } catch (error) {
-    logger19.debug("Health check failed", {
+    logger18.debug("Health check failed", {
       vendor: args.vendor,
       error: error instanceof Error ? error.message : String(error)
     });
@@ -4639,8 +4639,8 @@ function getConnectionPoolMetrics(vendor, client) {
 }
 
 // src/data/relational/connection/query-execution.ts
-async function executeQuery(context, query, logger19) {
-  logger19.debug("Executing SQL query", {
+async function executeQuery(context, query, logger18) {
+  logger18.debug("Executing SQL query", {
     vendor: context.vendor
   });
   if (context.vendor === "sqlite") {
@@ -5625,10 +5625,13 @@ async function executeBatchedTask(task, options = {}) {
     failures
   };
 }
-var logger9 = createLogger("agentforge:tools:data:relational:stream");
 var DEFAULT_CHUNK_SIZE = 100;
-var MAX_CHUNK_SIZE = 5e3;
 var DEFAULT_SAMPLE_SIZE = 50;
+var MAX_CHUNK_SIZE = 5e3;
+var MAX_SAMPLE_SIZE = 5e3;
+var streamExecutorLogger = createLogger("agentforge:tools:data:relational:stream");
+
+// src/data/relational/query/stream-executor-options.ts
 function normalizeBoundedInt(value, fieldName, min, max, fallback) {
   if (value === void 0) {
     return fallback;
@@ -5647,14 +5650,17 @@ function normalizePositiveInt2(value, fieldName, fallback) {
   }
   return value;
 }
-function extractRows(result) {
-  if (Array.isArray(result)) {
-    return result;
-  }
-  return result.rows ?? [];
+function resolveChunkSize(options) {
+  return normalizeBoundedInt(options.chunkSize, "chunkSize", 1, MAX_CHUNK_SIZE, DEFAULT_CHUNK_SIZE);
 }
-function isCancelledError(error) {
-  return error instanceof Error && error.message.includes("Stream cancelled by caller");
+function resolveSampleSize(options) {
+  return normalizeBoundedInt(
+    options.sampleSize,
+    "sampleSize",
+    0,
+    MAX_SAMPLE_SIZE,
+    DEFAULT_SAMPLE_SIZE
+  );
 }
 function resolveTotalRowsLimit(input, options) {
   const inputLimit = normalizePositiveInt2(input.limit, "limit");
@@ -5667,8 +5673,21 @@ function resolveTotalRowsLimit(input, options) {
   }
   return Math.min(inputLimit, maxRows);
 }
+
+// src/data/relational/query/row-extraction.ts
+function extractRows(result) {
+  if (Array.isArray(result)) {
+    return result;
+  }
+  if (result && typeof result === "object" && Array.isArray(result.rows)) {
+    return result.rows;
+  }
+  return [];
+}
+
+// src/data/relational/query/stream-executor-chunks.ts
 async function* streamSelectChunks(executor, input, options = {}) {
-  const chunkSize = normalizeBoundedInt(options.chunkSize, "chunkSize", 1, MAX_CHUNK_SIZE, DEFAULT_CHUNK_SIZE);
+  const chunkSize = resolveChunkSize(options);
   const baseOffset = input.offset ?? 0;
   const totalRowsLimit = resolveTotalRowsLimit(input, options);
   let processedRows = 0;
@@ -5711,16 +5730,17 @@ function createSelectReadableStream(executor, input, options = {}) {
     highWaterMark: 1
   });
 }
+
+// src/data/relational/query/stream-executor-runtime.ts
+function isCancelledError(error) {
+  return error instanceof Error && error.message.includes("Stream cancelled by caller");
+}
+
+// src/data/relational/query/stream-executor-execution.ts
 async function executeStreamingSelect(executor, input, options = {}) {
   const startTime = Date.now();
   const collectedRows = [];
-  const sampleSize = normalizeBoundedInt(
-    options.sampleSize,
-    "sampleSize",
-    0,
-    5e3,
-    DEFAULT_SAMPLE_SIZE
-  );
+  const sampleSize = resolveSampleSize(options);
   let rowCount = 0;
   let chunkCount = 0;
   let cancelled = false;
@@ -5758,7 +5778,7 @@ async function executeStreamingSelect(executor, input, options = {}) {
   const endHeapUsed = process.memoryUsage().heapUsed;
   peakHeapUsed = Math.max(peakHeapUsed, endHeapUsed);
   const executionTime = Date.now() - startTime;
-  logger9.debug("Streaming SELECT execution completed", {
+  streamExecutorLogger.debug("Streaming SELECT execution completed", {
     table: input.table,
     vendor: input.vendor,
     chunkCount,
@@ -5781,11 +5801,16 @@ async function executeStreamingSelect(executor, input, options = {}) {
     }
   };
 }
+
+// src/data/relational/query/stream-executor-benchmark.ts
 async function benchmarkStreamingSelectMemory(executor, input, options = {}) {
-  logger9.warn("Running streaming benchmark will execute the SELECT query twice (regular + streaming).", {
-    table: input.table,
-    vendor: input.vendor
-  });
+  streamExecutorLogger.warn(
+    "Running streaming benchmark will execute the SELECT query twice (regular + streaming).",
+    {
+      table: input.table,
+      vendor: input.vendor
+    }
+  );
   const nonStreamingStartHeapUsed = process.memoryUsage().heapUsed;
   const nonStreamingStartTime = Date.now();
   const nonStreamingResult = await executor.execute(buildSelectQuery(input));
@@ -5802,7 +5827,7 @@ async function benchmarkStreamingSelectMemory(executor, input, options = {}) {
     0
   );
   const memorySavedPercent = nonStreamingPeakHeapUsed > 0 ? memorySavedBytes / nonStreamingPeakHeapUsed * 100 : 0;
-  logger9.debug("Streaming benchmark completed", {
+  streamExecutorLogger.debug("Streaming benchmark completed", {
     table: input.table,
     vendor: input.vendor,
     nonStreamingRows: nonStreamingRows.length,
@@ -5874,7 +5899,7 @@ function withTransactionTimeout(operation, timeoutMs, onTimeout) {
 }
 
 // src/data/relational/query/transaction-managed.ts
-var logger10 = createLogger("agentforge:tools:data:relational:transaction");
+var logger9 = createLogger("agentforge:tools:data:relational:transaction");
 var SAVEPOINT_NAME_PATTERN = /^[A-Za-z_][A-Za-z0-9_]*$/;
 var ManagedTransaction = class {
   id;
@@ -5982,7 +6007,7 @@ var ManagedTransaction = class {
         await this.executeQuery(sql.raw("PRAGMA read_uncommitted = 1"));
         this.shouldRestoreSqliteReadUncommitted = true;
       } else {
-        logger10.debug("Ignoring SQLite isolation level override", {
+        logger9.debug("Ignoring SQLite isolation level override", {
           transactionId: this.id,
           isolationLevel: this.options.isolationLevel
         });
@@ -6007,7 +6032,7 @@ var ManagedTransaction = class {
       const targetValue = this.sqliteReadUncommittedOriginal ?? 0;
       await this.executeQuery(sql.raw(`PRAGMA read_uncommitted = ${targetValue}`));
     } catch (error) {
-      logger10.warn("Failed to restore SQLite read_uncommitted pragma", {
+      logger9.warn("Failed to restore SQLite read_uncommitted pragma", {
         transactionId: this.id,
         error: error instanceof Error ? error.message : String(error)
       });
@@ -6033,14 +6058,14 @@ var ManagedTransaction = class {
 };
 
 // src/data/relational/query/transaction-runner.ts
-var logger11 = createLogger("agentforge:tools:data:relational:transaction");
+var logger10 = createLogger("agentforge:tools:data:relational:transaction");
 var transactionSequence = 0;
 async function withTransaction(manager, operation, options) {
   const startTime = Date.now();
   const resolvedOptions = resolveTransactionOptions(options);
   const transactionId = `tx-${++transactionSequence}`;
   const vendor = manager.getVendor();
-  logger11.debug("Starting transaction", {
+  logger10.debug("Starting transaction", {
     transactionId,
     vendor,
     ...resolvedOptions.isolationLevel ? { isolationLevel: resolvedOptions.isolationLevel } : {},
@@ -6067,7 +6092,7 @@ async function withTransaction(manager, operation, options) {
       if (transaction.isActive()) {
         await transaction.commit();
       }
-      logger11.debug("Transaction committed", {
+      logger10.debug("Transaction committed", {
         transactionId,
         vendor,
         duration: Date.now() - startTime
@@ -6078,14 +6103,14 @@ async function withTransaction(manager, operation, options) {
         try {
           await transaction.rollback();
         } catch (rollbackError) {
-          logger11.error("Transaction rollback failed", {
+          logger10.error("Transaction rollback failed", {
             transactionId,
             vendor,
             error: rollbackError instanceof Error ? rollbackError.message : String(rollbackError)
           });
         }
       }
-      logger11.error("Transaction failed", {
+      logger10.error("Transaction failed", {
         transactionId,
         vendor,
         duration: Date.now() - startTime,
@@ -6576,7 +6601,7 @@ async function inspectSQLite(runQueryRows) {
 }
 
 // src/data/relational/schema/schema-inspector.ts
-var logger12 = createLogger("agentforge:tools:data:relational:schema-inspector");
+var logger11 = createLogger("agentforge:tools:data:relational:schema-inspector");
 var DEFAULT_CACHE_TTL_MS = 6e4;
 var schemaCache = /* @__PURE__ */ new Map();
 var SchemaInspector = class _SchemaInspector {
@@ -6604,7 +6629,7 @@ var SchemaInspector = class _SchemaInspector {
     if (!bypassCache && this.cacheKey) {
       const cached = schemaCache.get(this.cacheKey);
       if (cached && cached.expiresAt > Date.now()) {
-        logger12.debug("Schema cache hit", { vendor: this.vendor });
+        logger11.debug("Schema cache hit", { vendor: this.vendor });
         return filterSchemaTables(cloneSchema(cached.schema), tableFilters);
       }
     }
@@ -6649,7 +6674,7 @@ var SchemaInspector = class _SchemaInspector {
     return result.rows;
   }
 };
-var logger13 = createLogger("agentforge:tools:data:relational:schema-validator");
+var logger12 = createLogger("agentforge:tools:data:relational:schema-validator");
 function validateTableExists(schema, tableName) {
   const errors = [];
   if (!tableName || typeof tableName !== "string") {
@@ -6663,7 +6688,7 @@ function validateTableExists(schema, tableName) {
       `Table "${tableName}" does not exist. Available tables: ${available || "(none)"}`
     );
   }
-  logger13.debug("Table existence validation", { tableName, valid: errors.length === 0 });
+  logger12.debug("Table existence validation", { tableName, valid: errors.length === 0 });
   return { valid: errors.length === 0, errors };
 }
 function validateColumnsExist(schema, tableName, columnNames) {
@@ -6686,7 +6711,7 @@ function validateColumnsExist(schema, tableName, columnNames) {
       );
     }
   }
-  logger13.debug("Column existence validation", {
+  logger12.debug("Column existence validation", {
     tableName,
     columnCount: columnNames.length,
     valid: errors.length === 0
@@ -6722,7 +6747,7 @@ function validateColumnTypes(schema, tableName, expectedTypes) {
       );
     }
   }
-  logger13.debug("Column type validation", {
+  logger12.debug("Column type validation", {
     tableName,
     typeChecks: Object.keys(expectedTypes).length,
     valid: errors.length === 0
@@ -6742,7 +6767,7 @@ function findTable(schema, tableName) {
 function formatTableName(table) {
   return table.schema ? `${table.schema}.${table.name}` : table.name;
 }
-var logger14 = createLogger("agentforge:tools:data:relational:type-mapper");
+var logger13 = createLogger("agentforge:tools:data:relational:type-mapper");
 var POSTGRES_TYPE_MAP = {
   // Numeric
   smallint: "number",
@@ -6908,7 +6933,7 @@ function mapColumnType(vendor, dbType, nullable = false) {
   const result = { tsType, nullable, dbType };
   if (tsType === "unknown" && normalised !== "json" && normalised !== "jsonb") {
     result.notes = `No explicit mapping for "${dbType}"; defaulting to unknown`;
-    logger14.debug("Unmapped database type", { vendor, dbType, normalised });
+    logger13.debug("Unmapped database type", { vendor, dbType, normalised });
   }
   if ((normalised === "bigint" || normalised === "int8" || normalised === "bigserial") && (vendor === "postgresql" || vendor === "mysql")) {
     result.notes = "Mapped to string to avoid JavaScript number precision loss for 64-bit integers";
@@ -6923,7 +6948,7 @@ function mapSchemaTypes(vendor, columns) {
     }
     result.get(col.table).set(col.name, mapColumnType(vendor, col.type, col.nullable));
   }
-  logger14.debug("Schema type mapping complete", {
+  logger13.debug("Schema type mapping complete", {
     vendor,
     tables: result.size,
     columns: columns.length
@@ -6940,7 +6965,7 @@ function normaliseDbType(raw) {
   type = type.replace(/\s+unsigned$/, "");
   return type.trim();
 }
-var logger15 = createLogger("agentforge:tools:data:relational:schema-diff");
+var logger14 = createLogger("agentforge:tools:data:relational:schema-diff");
 function diffSchemas(before, after) {
   const tableDiffs = [];
   let columnsAdded = 0;
@@ -6980,7 +7005,7 @@ function diffSchemas(before, after) {
   const tablesRemoved = tableDiffs.filter((d) => d.type === "removed").length;
   const tablesChanged = tableDiffs.filter((d) => d.type === "changed").length;
   const identical = tableDiffs.length === 0;
-  logger15.debug("Schema diff computed", {
+  logger14.debug("Schema diff computed", {
     identical,
     tablesAdded,
     tablesRemoved,
@@ -7024,7 +7049,7 @@ function importSchemaFromJson(json) {
       throw new Error(`Invalid schema JSON: table "${table.name}" missing "primaryKey" array`);
     }
   }
-  logger15.debug("Schema imported from JSON", {
+  logger14.debug("Schema imported from JSON", {
     vendor: obj.vendor,
     tableCount: obj.tables.length
   });
@@ -7321,7 +7346,7 @@ function isSafeValidationError(error) {
 }
 
 // src/data/relational/tools/relational-select/executor.ts
-var logger16 = createLogger("agentforge:tools:data:relational:select");
+var logger15 = createLogger("agentforge:tools:data:relational:select");
 function toSelectQueryInput(input) {
   return {
     table: input.table,
@@ -7335,7 +7360,7 @@ function toSelectQueryInput(input) {
 }
 async function executeSelect(manager, input, context) {
   const startTime = Date.now();
-  logger16.debug("Building SELECT query", {
+  logger15.debug("Building SELECT query", {
     vendor: input.vendor,
     table: input.table,
     hasWhere: !!input.where,
@@ -7353,7 +7378,7 @@ async function executeSelect(manager, input, context) {
       };
       const streamInput = toSelectQueryInput(input);
       if (input.streaming.benchmark) {
-        logger16.warn("Streaming benchmark enabled; SELECT will execute up to three times (result + benchmark regular + benchmark streaming).", {
+        logger15.warn("Streaming benchmark enabled; SELECT will execute up to three times (result + benchmark regular + benchmark streaming).", {
           vendor: input.vendor,
           table: input.table,
           chunkSize: streamOptions.chunkSize ?? DEFAULT_CHUNK_SIZE,
@@ -7364,7 +7389,7 @@ async function executeSelect(manager, input, context) {
       const streamResult = await executeStreamingSelect(executor, streamInput, streamOptions);
       const benchmark = input.streaming.benchmark ? await benchmarkStreamingSelectMemory(executor, streamInput, streamOptions) : void 0;
       const executionTime2 = Date.now() - startTime;
-      logger16.debug("Streaming SELECT query executed successfully", {
+      logger15.debug("Streaming SELECT query executed successfully", {
         vendor: input.vendor,
         table: input.table,
         rowCount: streamResult.rowCount,
@@ -7393,7 +7418,7 @@ async function executeSelect(manager, input, context) {
     const executionTime = Date.now() - startTime;
     const rows = Array.isArray(result) ? result : result.rows || [];
     const rowCount = rows.length;
-    logger16.debug("SELECT query executed successfully", {
+    logger15.debug("SELECT query executed successfully", {
       vendor: input.vendor,
       table: input.table,
       rowCount,
@@ -7406,7 +7431,7 @@ async function executeSelect(manager, input, context) {
     };
   } catch (error) {
     const executionTime = Date.now() - startTime;
-    logger16.error("SELECT query execution failed", {
+    logger15.error("SELECT query execution failed", {
       vendor: input.vendor,
       table: input.table,
       error: error instanceof Error ? error.message : String(error),
@@ -8976,7 +9001,7 @@ function isSafeGetSchemaValidationError(error) {
 }
 
 // src/data/relational/tools/relational-get-schema.ts
-var logger17 = createLogger("agentforge:tools:data:relational:get-schema");
+var logger16 = createLogger("agentforge:tools:data:relational:get-schema");
 function buildSchemaCacheKey(vendor, connectionString, database) {
   const databaseScope = database ?? "default";
   const connectionHash = createHash("sha256").update(connectionString).digest("hex");
@@ -9048,7 +9073,7 @@ var relationalGetSchema = toolBuilder().name("relational-get-schema").displayNam
       summary
     };
   } catch (error) {
-    logger17.error("Schema introspection failed", {
+    logger16.error("Schema introspection failed", {
       vendor: input.vendor,
       hasTablesFilter: Array.isArray(input.tables),
       tablesFilterCount: input.tables?.length ?? 0,
@@ -10214,7 +10239,7 @@ var AskHumanInputSchema = z.object({
   suggestions: z.array(z.string()).optional().describe("Suggested responses for the human")
 });
 var logLevel3 = process.env.LOG_LEVEL?.toLowerCase() || LogLevel.INFO;
-var logger18 = createLogger("agentforge:tools:agent:ask-human", { level: logLevel3 });
+var logger17 = createLogger("agentforge:tools:agent:ask-human", { level: logLevel3 });
 function isRecord2(value) {
   return typeof value === "object" && value !== null;
 }
@@ -10279,7 +10304,7 @@ function createAskHumanTool() {
       suggestions: validatedInput.suggestions,
       status: "pending"
     };
-    logger18.debug("About to call interrupt()", {
+    logger17.debug("About to call interrupt()", {
       humanRequest: {
         id: humanRequest.id,
         question: humanRequest.question,
@@ -10295,13 +10320,13 @@ function createAskHumanTool() {
     let response;
     try {
       response = interrupt(humanRequest);
-      logger18.debug("interrupt() returned successfully", {
+      logger17.debug("interrupt() returned successfully", {
         responseType: typeof response,
         hasResponse: response != null,
         ...typeof response === "string" ? { responseLength: response.length } : {}
       });
     } catch (error) {
-      logger18.debug("interrupt() threw error (expected for GraphInterrupt)", {
+      logger17.debug("interrupt() threw error (expected for GraphInterrupt)", {
         ...error && typeof error === "object" && "constructor" in error ? { errorType: error.constructor?.name } : {},
         error: error instanceof Error ? error.message : String(error)
       });