@agentforge/tools 0.16.71 → 0.16.72

package/dist/index.js

@@ -788,7 +788,7 @@ function getDefaultSlackClient() {
     }
   };
 }
-function createSendSlackMessageTool(getSlackClient, logger18) {
+function createSendSlackMessageTool(getSlackClient, logger19) {
   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, logger18) {
       message: z.string().describe("Message content to send")
     })
   ).implementSafe(async ({ channel, message }) => {
-    logger18.info("send-slack-message called", { channel, messageLength: message.length });
+    logger19.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, logger18) {
         username: config.botName,
         icon_emoji: config.botIcon
       });
-      logger18.info("send-slack-message result", {
+      logger19.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, logger18) {
         message_id: result.ts
       };
     } catch (error) {
-      logger18.error("send-slack-message failed", {
+      logger19.error("send-slack-message failed", {
         channel,
         error: error.message,
         data: error.data
@@ -828,7 +828,7 @@ function createSendSlackMessageTool(getSlackClient, logger18) {
     }
   }).build();
 }
-function createNotifySlackTool(getSlackClient, logger18) {
+function createNotifySlackTool(getSlackClient, logger19) {
   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, logger18) {
       mentions: z.array(z.string()).optional().describe("List of usernames to mention (without @)")
     })
   ).implementSafe(async ({ channel, message, mentions = [] }) => {
-    logger18.info("notify-slack called", {
+    logger19.info("notify-slack called", {
       channel,
       messageLength: message.length,
       mentionCount: mentions.length
@@ -852,7 +852,7 @@ function createNotifySlackTool(getSlackClient, logger18) {
       username: config.botName,
       icon_emoji: config.botIcon
     });
-    logger18.info("notify-slack result", {
+    logger19.info("notify-slack result", {
       ...result.channel ? { channel: result.channel } : {},
       ...result.ts ? { timestamp: result.ts } : {},
       mentions: mentions.length
@@ -866,7 +866,7 @@ function createNotifySlackTool(getSlackClient, logger18) {
     };
   }).build();
 }
-function createGetSlackChannelsTool(getSlackClient, logger18) {
+function createGetSlackChannelsTool(getSlackClient, logger19) {
   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, logger18) {
       include_private: z.boolean().optional().describe("Include private channels (default: false)")
     })
   ).implementSafe(async ({ include_private = false }) => {
-    logger18.info("get-slack-channels called", { include_private });
+    logger19.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, logger18) {
       });
       allChannels = [...allChannels, ...privateChannels.channels || []];
     }
-    logger18.info("get-slack-channels result", {
+    logger19.info("get-slack-channels result", {
       channelCount: allChannels.length,
       includePrivate: include_private
     });
@@ -903,7 +903,7 @@ function createGetSlackChannelsTool(getSlackClient, logger18) {
     };
   }).build();
 }
-function createGetSlackMessagesTool(getSlackClient, logger18) {
+function createGetSlackMessagesTool(getSlackClient, logger19) {
   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, logger18) {
       limit: z.number().int().min(1).max(100).optional().describe("Number of messages to retrieve (default: 20, max: 100)")
     })
   ).implementSafe(async ({ channel, limit = 20 }) => {
-    logger18.info("get-slack-messages called", { channel, limit });
+    logger19.info("get-slack-messages called", { channel, limit });
     try {
       const { client: slack } = getSlackClient();
       let channelId = channel;
@@ -923,7 +923,7 @@ function createGetSlackMessagesTool(getSlackClient, logger18) {
         });
         const found = channels.channels?.find((c) => c.name === channel);
         if (!found) {
-          logger18.error("get-slack-messages: channel not found", { channel });
+          logger19.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, logger18) {
         limit: Math.min(limit, 100)
         // Cap at 100 for performance
       });
-      logger18.info("get-slack-messages result", {
+      logger19.info("get-slack-messages result", {
         channel: channelId,
         messageCount: result.messages?.length || 0,
         limit
@@ -953,7 +953,7 @@ function createGetSlackMessagesTool(getSlackClient, logger18) {
         })) || []
       };
     } catch (error) {
-      logger18.error("get-slack-messages failed", {
+      logger19.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, logger18) {
+function createSearchConfluenceTool(getAuth, getAuthHeader2, logger19) {
   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 }) => {
-    logger18.info("search-confluence called", { query, limit });
+    logger19.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, logger18) {
         lastModified: page.version?.when || ""
       }));
       if (results.length === 0) {
-        logger18.warn("search-confluence returned NO RESULTS - this is a valid outcome, agent should not retry", {
+        logger19.warn("search-confluence returned NO RESULTS - this is a valid outcome, agent should not retry", {
           query,
           limit,
           totalSize: response.data.totalSize
         });
       } else {
-        logger18.info("search-confluence result", {
+        logger19.info("search-confluence result", {
           query,
           resultCount: results.length,
           totalSize: response.data.totalSize,
@@ -1085,7 +1085,7 @@ function createSearchConfluenceTool(getAuth, getAuthHeader2, logger18) {
         results
       });
     } catch (error) {
-      logger18.error("search-confluence error", {
+      logger19.error("search-confluence error", {
         query,
         error: error.response?.data?.message || error.message,
         status: error.response?.status
@@ -1097,11 +1097,11 @@ function createSearchConfluenceTool(getAuth, getAuthHeader2, logger18) {
     }
   }).build();
 }
-function createGetConfluencePageTool(getAuth, getAuthHeader2, logger18) {
+function createGetConfluencePageTool(getAuth, getAuthHeader2, logger19) {
   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 }) => {
-    logger18.info("get-confluence-page called", { page_id });
+    logger19.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, logger18) {
         }
       });
       const page = response.data;
-      logger18.info("get-confluence-page result", {
+      logger19.info("get-confluence-page result", {
         page_id,
         title: page.title,
         space: page.space?.name,
@@ -1136,7 +1136,7 @@ function createGetConfluencePageTool(getAuth, getAuthHeader2, logger18) {
         }
       });
     } catch (error) {
-      logger18.error("get-confluence-page error", {
+      logger19.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, logger18) {
     }
   }).build();
 }
-function createListConfluenceSpacesTool(getAuth, getAuthHeader2, logger18) {
+function createListConfluenceSpacesTool(getAuth, getAuthHeader2, logger19) {
   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 }) => {
-    logger18.info("list-confluence-spaces called", { limit });
+    logger19.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, logger18) {
         description: space.description?.plain?.value || "",
         url: `${ATLASSIAN_SITE_URL}/wiki${space._links.webui}`
       }));
-      logger18.info("list-confluence-spaces result", {
+      logger19.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, logger18) {
         spaces
       });
     } catch (error) {
-      logger18.error("list-confluence-spaces error", {
+      logger19.error("list-confluence-spaces error", {
         error: error.response?.data?.message || error.message,
         status: error.response?.status
       });
@@ -1193,12 +1193,12 @@ function createListConfluenceSpacesTool(getAuth, getAuthHeader2, logger18) {
     }
   }).build();
 }
-function createGetSpacePagesTool(getAuth, getAuthHeader2, logger18) {
+function createGetSpacePagesTool(getAuth, getAuthHeader2, logger19) {
   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 }) => {
-    logger18.info("get-space-pages called", { space_key, limit });
+    logger19.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, logger18) {
         lastModified: page.version?.when || ""
       }));
       if (pages.length === 0) {
-        logger18.warn("get-space-pages returned NO PAGES - this is a valid outcome, agent should not retry", {
+        logger19.warn("get-space-pages returned NO PAGES - this is a valid outcome, agent should not retry", {
           space_key,
           limit
         });
       } else {
-        logger18.info("get-space-pages result", {
+        logger19.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, logger18) {
         pages
       });
     } catch (error) {
-      logger18.error("get-space-pages error", {
+      logger19.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, logger18) {
     }
   }).build();
 }
-function createCreateConfluencePageTool(getAuth, getAuthHeader2, logger18) {
+function createCreateConfluencePageTool(getAuth, getAuthHeader2, logger19) {
   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 }) => {
-    logger18.info("create-confluence-page called", { space_key, title, hasParent: !!parent_page_id });
+    logger19.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, logger18) {
           }
         }
       );
-      logger18.info("create-confluence-page result", {
+      logger19.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, logger18) {
         }
       });
     } catch (error) {
-      logger18.error("create-confluence-page error", {
+      logger19.error("create-confluence-page error", {
         space_key,
         title,
         error: error.response?.data?.message || error.message,
@@ -1314,13 +1314,13 @@ function createCreateConfluencePageTool(getAuth, getAuthHeader2, logger18) {
     }
   }).build();
 }
-function createUpdateConfluencePageTool(getAuth, getAuthHeader2, logger18) {
+function createUpdateConfluencePageTool(getAuth, getAuthHeader2, logger19) {
   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 }) => {
-    logger18.info("update-confluence-page called", { page_id, title });
+    logger19.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, logger18) {
           }
         }
       );
-      logger18.info("update-confluence-page result", {
+      logger19.info("update-confluence-page result", {
         page_id,
         title: updateResponse.data.title,
         previousVersion: currentVersion,
@@ -1370,7 +1370,7 @@ function createUpdateConfluencePageTool(getAuth, getAuthHeader2, logger18) {
         }
       });
     } catch (error) {
-      logger18.error("update-confluence-page error", {
+      logger19.error("update-confluence-page error", {
         page_id,
         title,
         error: error.response?.data?.message || error.message,
@@ -1383,12 +1383,12 @@ function createUpdateConfluencePageTool(getAuth, getAuthHeader2, logger18) {
     }
   }).build();
 }
-function createArchiveConfluencePageTool(getAuth, getAuthHeader2, logger18) {
+function createArchiveConfluencePageTool(getAuth, getAuthHeader2, logger19) {
   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 }) => {
-    logger18.info("archive-confluence-page called", {
+    logger19.info("archive-confluence-page called", {
       page_id,
       ...reason ? { reason } : {}
     });
@@ -1422,7 +1422,7 @@ function createArchiveConfluencePageTool(getAuth, getAuthHeader2, logger18) {
           }
         }
       );
-      logger18.info("archive-confluence-page result", {
+      logger19.info("archive-confluence-page result", {
         page_id,
         title: pageData.title,
         previousVersion: currentVersion,
@@ -1440,7 +1440,7 @@ function createArchiveConfluencePageTool(getAuth, getAuthHeader2, logger18) {
         }
       });
     } catch (error) {
-      logger18.error("archive-confluence-page error", {
+      logger19.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, logger18, vendor, message) {
+function cancelPendingReconnection(timer, logger19, vendor, message) {
   if (!timer) {
     return null;
   }
-  logger18.debug(message, { vendor });
+  logger19.debug(message, { vendor });
   clearTimeout(timer);
   return null;
 }
-async function waitForInFlightConnection(promise, logger18, vendor, phase) {
+async function waitForInFlightConnection(promise, logger19, vendor, phase) {
   if (!promise) {
     return null;
   }
-  logger18.debug(`Waiting for in-flight connection attempt to complete before ${phase}`, {
+  logger19.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, logger18) {
+function scheduleReconnection(context, logger19) {
   if (context.reconnectionConfig.maxAttempts > 0 && context.reconnectionAttempts >= context.reconnectionConfig.maxAttempts) {
-    logger18.error("Max reconnection attempts reached", {
+    logger19.error("Max reconnection attempts reached", {
       vendor: context.vendor,
       attempts: context.reconnectionAttempts,
       maxAttempts: context.reconnectionConfig.maxAttempts
@@ -4213,7 +4213,7 @@ function scheduleReconnection(context, logger18) {
   const nextAttempt = context.reconnectionAttempts + 1;
   context.setReconnectionAttempts(nextAttempt);
   context.setState("reconnecting" /* RECONNECTING */);
-  logger18.info("Scheduling reconnection attempt", {
+  logger19.info("Scheduling reconnection attempt", {
     vendor: context.vendor,
     attempt: nextAttempt,
     maxAttempts: context.reconnectionConfig.maxAttempts,
@@ -4227,7 +4227,7 @@ function scheduleReconnection(context, logger18) {
   const timer = setTimeout(async () => {
     context.setReconnectionTimer(null);
     try {
-      logger18.info("Attempting reconnection", {
+      logger19.info("Attempting reconnection", {
         vendor: context.vendor,
         attempt: nextAttempt
       });
@@ -4237,7 +4237,7 @@ function scheduleReconnection(context, logger18) {
       context.setConnectPromise(promise);
       await promise;
     } catch (error) {
-      logger18.error("Reconnection attempt failed", {
+      logger19.error("Reconnection attempt failed", {
         vendor: context.vendor,
         attempt: nextAttempt,
         error: error instanceof Error ? error.message : String(error)
@@ -4248,17 +4248,17 @@ function scheduleReconnection(context, logger18) {
 }
 
 // src/data/relational/connection/connection-cleanup.ts
-async function cleanupConnectionResources(vendor, client, clearConnection, logger18) {
+async function cleanupConnectionResources(vendor, client, clearConnection, logger19) {
   if (!client) {
     return;
   }
-  logger18.debug("Cleaning up cancelled connection", {
+  logger19.debug("Cleaning up cancelled connection", {
     vendor
   });
   try {
     await shutdownClient(vendor, client);
   } catch (error) {
-    logger18.debug("Error during cancelled connection cleanup", {
+    logger19.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, logger18) {
+async function closeManagedConnection(runtime, logger19) {
   const client = runtime.getClient();
   if (client) {
-    logger18.info("Closing database connection", {
+    logger19.info("Closing database connection", {
       vendor: runtime.vendor,
       state: runtime.getState()
     });
@@ -4277,12 +4277,12 @@ async function closeManagedConnection(runtime, logger18) {
       await shutdownClient(runtime.vendor, client);
       runtime.setState("disconnected" /* DISCONNECTED */);
       runtime.emitDisconnected();
-      logger18.debug("Database connection closed successfully", {
+      logger19.debug("Database connection closed successfully", {
         vendor: runtime.vendor,
         state: runtime.getState()
       });
     } catch (error) {
-      logger18.error("Error closing database connection", {
+      logger19.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, logger18) {
+async function initializeManagedConnection(runtime, logger19) {
   const startTime = Date.now();
   const currentGeneration = runtime.getConnectionGeneration();
   if (runtime.getState() === "connected" /* CONNECTED */ && runtime.getClient()) {
-    logger18.warn("Re-initializing an already connected manager; emitting disconnected before cleanup", {
+    logger19.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, logger18) {
         runtime.setClient(null);
         runtime.setDb(null);
       },
-      logger18
+      logger19
     );
   }
   runtime.setState("connecting" /* CONNECTING */);
-  logger18.info("Initializing database connection", {
+  logger19.info("Initializing database connection", {
     vendor: runtime.vendor,
     connectionType: typeof runtime.config.connection,
     state: runtime.getState()
@@ -4485,7 +4485,7 @@ async function initializeManagedConnection(runtime, logger18) {
     runtime.setClient(initialized.client);
     runtime.setDb(initialized.db);
     if (currentGeneration !== runtime.getConnectionGeneration()) {
-      logger18.debug("Connection cancelled during initialization", {
+      logger19.debug("Connection cancelled during initialization", {
         vendor: runtime.vendor,
         currentGeneration,
         newGeneration: runtime.getConnectionGeneration()
@@ -4497,18 +4497,18 @@ async function initializeManagedConnection(runtime, logger18) {
           runtime.setClient(null);
           runtime.setDb(null);
         },
-        logger18
+        logger19
       );
       runtime.setState("disconnected" /* DISCONNECTED */);
       throw new Error("Connection cancelled during initialization");
     }
-    logger18.debug("Validating connection health", { vendor: runtime.vendor });
+    logger19.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()) {
-      logger18.debug("Connection cancelled during health check", {
+      logger19.debug("Connection cancelled during health check", {
         vendor: runtime.vendor,
         currentGeneration,
         newGeneration: runtime.getConnectionGeneration()
@@ -4520,7 +4520,7 @@ async function initializeManagedConnection(runtime, logger18) {
           runtime.setClient(null);
           runtime.setDb(null);
         },
-        logger18
+        logger19
       );
       runtime.setState("disconnected" /* DISCONNECTED */);
       throw new Error("Connection cancelled during health check");
@@ -4528,7 +4528,7 @@ async function initializeManagedConnection(runtime, logger18) {
     runtime.setState("connected" /* CONNECTED */);
     runtime.emitConnected();
     runtime.resetReconnectionAttempts();
-    logger18.info("Database connection initialized successfully", {
+    logger19.info("Database connection initialized successfully", {
       vendor: runtime.vendor,
       duration: Date.now() - startTime,
       state: runtime.getState()
@@ -4549,7 +4549,7 @@ async function initializeManagedConnection(runtime, logger18) {
       if (runtime.errorListenerCount() > 0) {
         runtime.emitError(normalizedError);
       }
-      logger18.error(errorMessage, {
+      logger19.error(errorMessage, {
         vendor: runtime.vendor,
         error: normalizedError.message,
         duration: Date.now() - startTime,
@@ -4562,13 +4562,13 @@ async function initializeManagedConnection(runtime, logger18) {
           runtime.setClient(null);
           runtime.setDb(null);
         },
-        logger18
+        logger19
       );
       if (runtime.getReconnectionConfig().enabled && currentGeneration === runtime.getConnectionGeneration()) {
         runtime.scheduleReconnection();
       }
     } else {
-      logger18.debug("Connection initialization cancelled", {
+      logger19.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, logger18) {
+async function checkConnectionHealth(args, logger19) {
   if (!args.db || !args.client) {
-    logger18.debug("Health check failed: connection not initialized", { vendor: args.vendor });
+    logger19.debug("Health check failed: connection not initialized", { vendor: args.vendor });
     return false;
   }
   try {
     await args.execute(sql`SELECT 1`);
-    logger18.debug("Health check passed", { vendor: args.vendor });
+    logger19.debug("Health check passed", { vendor: args.vendor });
     return true;
   } catch (error) {
-    logger18.debug("Health check failed", {
+    logger19.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, logger18) {
-  logger18.debug("Executing SQL query", {
+async function executeQuery(context, query, logger19) {
+  logger19.debug("Executing SQL query", {
     vendor: context.vendor
   });
   if (context.vendor === "sqlite") {
@@ -6982,15 +6982,15 @@ function diffSchemas(before, after) {
       }
       tableDiffs.push(diff);
     }
-    for (const cd of colDiffs) {
-      if (cd.type === "added") columnsAdded++;
-      else if (cd.type === "removed") columnsRemoved++;
+    for (const columnDiff of colDiffs) {
+      if (columnDiff.type === "added") columnsAdded++;
+      else if (columnDiff.type === "removed") columnsRemoved++;
       else columnsChanged++;
     }
   }
-  const tablesAdded = tableDiffs.filter((d) => d.type === "added").length;
-  const tablesRemoved = tableDiffs.filter((d) => d.type === "removed").length;
-  const tablesChanged = tableDiffs.filter((d) => d.type === "changed").length;
+  const tablesAdded = tableDiffs.filter((diff) => diff.type === "added").length;
+  const tablesRemoved = tableDiffs.filter((diff) => diff.type === "removed").length;
+  const tablesChanged = tableDiffs.filter((diff) => diff.type === "changed").length;
   const identical = tableDiffs.length === 0;
   logger14.debug("Schema diff computed", {
     identical,
@@ -7004,58 +7004,10 @@ function diffSchemas(before, after) {
     summary: { tablesAdded, tablesRemoved, tablesChanged, columnsAdded, columnsRemoved, columnsChanged }
   };
 }
-function exportSchemaToJson(schema) {
-  return JSON.stringify(schema, sortedReplacer, 2);
-}
-function importSchemaFromJson(json) {
-  const parsed = JSON.parse(json);
-  if (!parsed || typeof parsed !== "object") {
-    throw new Error("Invalid schema JSON: expected an object");
-  }
-  const obj = parsed;
-  if (!obj.vendor || typeof obj.vendor !== "string") {
-    throw new Error('Invalid schema JSON: missing or invalid "vendor" field');
-  }
-  if (!Array.isArray(obj.tables)) {
-    throw new Error('Invalid schema JSON: missing or invalid "tables" array');
-  }
-  if (!obj.generatedAt || typeof obj.generatedAt !== "string") {
-    throw new Error('Invalid schema JSON: missing or invalid "generatedAt" field');
-  }
-  for (const table of obj.tables) {
-    if (!table || typeof table !== "object") {
-      throw new Error("Invalid schema JSON: each table must be an object");
-    }
-    if (!table.name || typeof table.name !== "string") {
-      throw new Error('Invalid schema JSON: each table must have a "name" string');
-    }
-    if (!Array.isArray(table.columns)) {
-      throw new Error(`Invalid schema JSON: table "${table.name}" missing "columns" array`);
-    }
-    if (!Array.isArray(table.primaryKey)) {
-      throw new Error(`Invalid schema JSON: table "${table.name}" missing "primaryKey" array`);
-    }
-  }
-  logger14.debug("Schema imported from JSON", {
-    vendor: obj.vendor,
-    tableCount: obj.tables.length
-  });
-  return parsed;
-}
-function sortedReplacer(_key, value) {
-  if (value && typeof value === "object" && !Array.isArray(value)) {
-    const sorted = {};
-    for (const k of Object.keys(value).sort()) {
-      sorted[k] = value[k];
-    }
-    return sorted;
-  }
-  return value;
-}
 function tableMap(tables) {
   const map = /* @__PURE__ */ new Map();
-  for (const t of tables) {
-    map.set(formatName(t).toLowerCase(), t);
+  for (const table of tables) {
+    map.set(formatName(table).toLowerCase(), table);
   }
   return map;
 }
@@ -7066,43 +7018,113 @@ function diffColumns(before, after) {
   const diffs = [];
   const beforeMap = /* @__PURE__ */ new Map();
   const afterMap = /* @__PURE__ */ new Map();
-  for (const c of before) beforeMap.set(c.name.toLowerCase(), c);
-  for (const c of after) afterMap.set(c.name.toLowerCase(), c);
-  for (const [key] of beforeMap) {
+  for (const column of before) beforeMap.set(column.name.toLowerCase(), column);
+  for (const column of after) afterMap.set(column.name.toLowerCase(), column);
+  for (const [key, beforeColumn] of beforeMap) {
     if (!afterMap.has(key)) {
-      diffs.push({ column: beforeMap.get(key).name, type: "removed" });
+      diffs.push({ column: beforeColumn.name, type: "removed" });
     }
   }
-  for (const [key] of afterMap) {
+  for (const [key, afterColumn] of afterMap) {
     if (!beforeMap.has(key)) {
-      diffs.push({ column: afterMap.get(key).name, type: "added" });
+      diffs.push({ column: afterColumn.name, type: "added" });
     }
   }
-  for (const [key, beforeCol] of beforeMap) {
-    const afterCol = afterMap.get(key);
-    if (!afterCol) continue;
+  for (const [key, beforeColumn] of beforeMap) {
+    const afterColumn = afterMap.get(key);
+    if (!afterColumn) continue;
     const changes = [];
-    if (beforeCol.type.toLowerCase() !== afterCol.type.toLowerCase()) {
-      changes.push({ property: "type", before: beforeCol.type, after: afterCol.type });
-    }
-    if (beforeCol.isNullable !== afterCol.isNullable) {
-      changes.push({ property: "isNullable", before: beforeCol.isNullable, after: afterCol.isNullable });
+    if (beforeColumn.type.toLowerCase() !== afterColumn.type.toLowerCase()) {
+      changes.push({ property: "type", before: beforeColumn.type, after: afterColumn.type });
+    }
+    if (beforeColumn.isNullable !== afterColumn.isNullable) {
+      changes.push({
+        property: "isNullable",
+        before: beforeColumn.isNullable,
+        after: afterColumn.isNullable
+      });
     }
-    if (beforeCol.isPrimaryKey !== afterCol.isPrimaryKey) {
-      changes.push({ property: "isPrimaryKey", before: beforeCol.isPrimaryKey, after: afterCol.isPrimaryKey });
+    if (beforeColumn.isPrimaryKey !== afterColumn.isPrimaryKey) {
+      changes.push({
+        property: "isPrimaryKey",
+        before: beforeColumn.isPrimaryKey,
+        after: afterColumn.isPrimaryKey
+      });
     }
-    if (String(beforeCol.defaultValue) !== String(afterCol.defaultValue)) {
-      changes.push({ property: "defaultValue", before: beforeCol.defaultValue, after: afterCol.defaultValue });
+    if (String(beforeColumn.defaultValue) !== String(afterColumn.defaultValue)) {
+      changes.push({
+        property: "defaultValue",
+        before: beforeColumn.defaultValue,
+        after: afterColumn.defaultValue
+      });
     }
     if (changes.length > 0) {
-      diffs.push({ column: beforeCol.name, type: "changed", changes });
+      diffs.push({ column: beforeColumn.name, type: "changed", changes });
     }
   }
   return diffs;
 }
-function arraysEqual(a, b) {
-  if (a.length !== b.length) return false;
-  return a.every((v, i) => v === b[i]);
+function arraysEqual(before, after) {
+  if (before.length !== after.length) return false;
+  return before.every((value, index) => value === after[index]);
+}
+var logger15 = createLogger("agentforge:tools:data:relational:schema-diff");
+function exportSchemaToJson(schema) {
+  return JSON.stringify(schema, sortedReplacer, 2);
+}
+function importSchemaFromJson(json) {
+  const parsed = JSON.parse(json);
+  validateSchemaJson(parsed);
+  const schema = parsed;
+  logger15.debug("Schema imported from JSON", {
+    vendor: schema.vendor,
+    tableCount: schema.tables.length
+  });
+  return schema;
+}
+function validateSchemaJson(parsed) {
+  if (!parsed || typeof parsed !== "object") {
+    throw new Error("Invalid schema JSON: expected an object");
+  }
+  const schema = parsed;
+  if (!schema.vendor || typeof schema.vendor !== "string") {
+    throw new Error('Invalid schema JSON: missing or invalid "vendor" field');
+  }
+  if (!Array.isArray(schema.tables)) {
+    throw new Error('Invalid schema JSON: missing or invalid "tables" array');
+  }
+  if (!schema.generatedAt || typeof schema.generatedAt !== "string") {
+    throw new Error('Invalid schema JSON: missing or invalid "generatedAt" field');
+  }
+  for (const table of schema.tables) {
+    validateTableJson(table);
+  }
+}
+function validateTableJson(table) {
+  if (!table || typeof table !== "object") {
+    throw new Error("Invalid schema JSON: each table must be an object");
+  }
+  const record = table;
+  if (!record.name || typeof record.name !== "string") {
+    throw new Error('Invalid schema JSON: each table must have a "name" string');
+  }
+  if (!Array.isArray(record.columns)) {
+    throw new Error(`Invalid schema JSON: table "${record.name}" missing "columns" array`);
+  }
+  if (!Array.isArray(record.primaryKey)) {
+    throw new Error(`Invalid schema JSON: table "${record.name}" missing "primaryKey" array`);
+  }
+}
+function sortedReplacer(_key, value) {
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    const record = value;
+    const sorted = {};
+    for (const key of Object.keys(record).sort()) {
+      sorted[key] = record[key];
+    }
+    return sorted;
+  }
+  return value;
 }
 var relationalQuerySchema = z.object({
   sql: z.string().describe("SQL query string to execute"),
@@ -7333,7 +7355,7 @@ function isSafeValidationError(error) {
 }
 
 // src/data/relational/tools/relational-select/executor.ts
-var logger15 = createLogger("agentforge:tools:data:relational:select");
+var logger16 = createLogger("agentforge:tools:data:relational:select");
 function toSelectQueryInput(input) {
   return {
     table: input.table,
@@ -7347,7 +7369,7 @@ function toSelectQueryInput(input) {
 }
 async function executeSelect(manager, input, context) {
   const startTime = Date.now();
-  logger15.debug("Building SELECT query", {
+  logger16.debug("Building SELECT query", {
     vendor: input.vendor,
     table: input.table,
     hasWhere: !!input.where,
@@ -7365,7 +7387,7 @@ async function executeSelect(manager, input, context) {
       };
       const streamInput = toSelectQueryInput(input);
       if (input.streaming.benchmark) {
-        logger15.warn("Streaming benchmark enabled; SELECT will execute up to three times (result + benchmark regular + benchmark streaming).", {
+        logger16.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,
@@ -7376,7 +7398,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;
-      logger15.debug("Streaming SELECT query executed successfully", {
+      logger16.debug("Streaming SELECT query executed successfully", {
         vendor: input.vendor,
         table: input.table,
         rowCount: streamResult.rowCount,
@@ -7405,7 +7427,7 @@ async function executeSelect(manager, input, context) {
     const executionTime = Date.now() - startTime;
     const rows = Array.isArray(result) ? result : result.rows || [];
     const rowCount = rows.length;
-    logger15.debug("SELECT query executed successfully", {
+    logger16.debug("SELECT query executed successfully", {
       vendor: input.vendor,
       table: input.table,
       rowCount,
@@ -7418,7 +7440,7 @@ async function executeSelect(manager, input, context) {
     };
   } catch (error) {
     const executionTime = Date.now() - startTime;
-    logger15.error("SELECT query execution failed", {
+    logger16.error("SELECT query execution failed", {
       vendor: input.vendor,
       table: input.table,
       error: error instanceof Error ? error.message : String(error),
@@ -8988,7 +9010,7 @@ function isSafeGetSchemaValidationError(error) {
 }
 
 // src/data/relational/tools/relational-get-schema.ts
-var logger16 = createLogger("agentforge:tools:data:relational:get-schema");
+var logger17 = createLogger("agentforge:tools:data:relational:get-schema");
 function buildSchemaCacheKey(vendor, connectionString, database) {
   const databaseScope = database ?? "default";
   const connectionHash = createHash("sha256").update(connectionString).digest("hex");
@@ -9060,7 +9082,7 @@ var relationalGetSchema = toolBuilder().name("relational-get-schema").displayNam
       summary
     };
   } catch (error) {
-    logger16.error("Schema introspection failed", {
+    logger17.error("Schema introspection failed", {
       vendor: input.vendor,
       hasTablesFilter: Array.isArray(input.tables),
       tablesFilterCount: input.tables?.length ?? 0,
@@ -10226,7 +10248,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 logger17 = createLogger("agentforge:tools:agent:ask-human", { level: logLevel3 });
+var logger18 = createLogger("agentforge:tools:agent:ask-human", { level: logLevel3 });
 function isRecord2(value) {
   return typeof value === "object" && value !== null;
 }
@@ -10291,7 +10313,7 @@ function createAskHumanTool() {
       suggestions: validatedInput.suggestions,
       status: "pending"
     };
-    logger17.debug("About to call interrupt()", {
+    logger18.debug("About to call interrupt()", {
       humanRequest: {
         id: humanRequest.id,
         question: humanRequest.question,
@@ -10307,13 +10329,13 @@ function createAskHumanTool() {
     let response;
     try {
       response = interrupt(humanRequest);
-      logger17.debug("interrupt() returned successfully", {
+      logger18.debug("interrupt() returned successfully", {
         responseType: typeof response,
         hasResponse: response != null,
         ...typeof response === "string" ? { responseLength: response.length } : {}
       });
     } catch (error) {
-      logger17.debug("interrupt() threw error (expected for GraphInterrupt)", {
+      logger18.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)
       });