feat: Enhance tools with improved context handling and logging

- Added a new `gitToolContextSchema` to define optional properties for Git tools, including `defaultBranch`, `allowForce`, `allowAmend`, `maxCommits`, and `timeout`.
- Updated the `cwd` assignment in multiple Git tools to use nullish coalescing (`??`) for better handling of undefined values.
- Improved timeout handling in the `gitBranchTool` to use a default value if not provided.
- Refactored the `jsonToCsvTool` to introduce a new `JsonToCsvRequestContext` interface, allowing for better context management.
- Removed redundant logging hooks in `jsonToCsvTool` and restructured the execution method for clarity.
- Updated the `randomGeneratorTool` to use a more structured `RandomToolContext` interface, enhancing type safety and clarity.
- Added detailed logging hooks for input and output events in `randomGeneratorTool`.
- Introduced a new `ScraperToolContext` interface in `web-scraper-tool.ts` to manage context more effectively, including properties like `allowedDomains`, `userAgent`, and `timeout`.
- Enhanced logging for various scraping tools, including detailed input and output logging for better traceability.
- Added logging hooks for input and output events across multiple tools, including `htmlToMarkdownTool`, `linkExtractorTool`, and `dataExporterTool`, to improve monitoring and debugging capabilities.

Author: ssdeanx

src/mastra/tools/alpha-vantage.tool.ts

@@ -1,9 +1,11 @@
-import type { InferUITool } from '@mastra/core/tools'
 import { createTool } from '@mastra/core/tools'
+import type { InferUITool } from '@mastra/core/tools'
 import { trace } from '@opentelemetry/api'
 import { z } from 'zod'
 import { log } from '../config/logger'
 
+import type { RequestContext } from '@mastra/core/request-context'
+
 /**
  * Alpha Vantage Tools
  *
@@ -14,6 +16,13 @@ import { log } from '../config/logger'
  * Requires ALPHA_VANTAGE_API_KEY environment variable
  */
 
+/**
+ * Base Request Context for Alpha Vantage
+ */
+export interface AlphaVantageRequestContext extends RequestContext {
+    apiKey?: string
+}
+
 // In-memory counter to track tool calls per request
 // Add this line at the beginning of each tool's execute function to track usage:
 // toolCallCounters.set('tool-id', (toolCallCounters.get('tool-id') ?? 0) + 1)
@@ -83,6 +92,7 @@ export const alphaVantageCryptoTool = createTool({
       .optional(),
   }),
   execute: async (inputData, context) => {
+    const requestContext = context?.requestContext as AlphaVantageRequestContext
     const span = trace
       .getTracer('alpha-vantage-crypto-tool', '1.0.0')
       .startSpan('alpha-vantage-crypto', {
@@ -103,7 +113,7 @@ export const alphaVantageCryptoTool = createTool({
       },
       id: 'alpha-vantage-crypto',
     })
-    const apiKey = process.env.ALPHA_VANTAGE_API_KEY
+    const apiKey = requestContext?.apiKey ?? process.env.ALPHA_VANTAGE_API_KEY
 
     if (typeof apiKey !== 'string' || apiKey.trim() === '') {
       await context?.writer?.custom({
@@ -313,7 +323,7 @@ export const alphaVantageCryptoTool = createTool({
     })
   },
   onOutput: ({ output, toolCallId, toolName, abortSignal }) => {
-    const dataKeys = output.data ? Object.keys(output.data).length : 0
+    const dataKeys = (output.data !== null && typeof output.data === 'object') ? Object.keys(output.data as object).length : 0
     log.info('Alpha Vantage crypto completed', {
       toolCallId,
       toolName,
@@ -412,6 +422,7 @@ export const alphaVantageStockTool = createTool({
   }),
 
   execute: async (inputData, context) => {
+    const requestContext = context?.requestContext as AlphaVantageRequestContext
     const span = trace
       .getTracer('alpha-vantage-stock-tool', '1.0.0')
       .startSpan('alpha-vantage-stock', {
@@ -431,7 +442,7 @@ export const alphaVantageStockTool = createTool({
       },
       id: 'alpha-vantage-stock',
     })
-    const apiKey = process.env.ALPHA_VANTAGE_API_KEY
+    const apiKey = requestContext?.apiKey ?? process.env.ALPHA_VANTAGE_API_KEY
 
     if (typeof apiKey !== 'string' || apiKey.trim() === '') {
       await context?.writer?.custom({
@@ -674,7 +685,7 @@ export const alphaVantageStockTool = createTool({
     })
   },
   onOutput: ({ output, toolCallId, toolName, abortSignal }) => {
-    const dataKeys = output.data ? Object.keys(output.data).length : 0
+    const dataKeys = (output.data !== null && typeof output.data === 'object') ? Object.keys(output.data as object).length : 0
     log.info('Alpha Vantage stock completed', {
       toolCallId,
       toolName,
@@ -804,6 +815,7 @@ export const alphaVantageTool = createTool({
       .optional(),
   }),
   execute: async (inputData, context) => {
+    const requestContext = context?.requestContext as AlphaVantageRequestContext
     const span = trace
       .getTracer('alpha-vantage-tool', '1.0.0')
       .startSpan('alpha-vantage', {
@@ -823,7 +835,7 @@ export const alphaVantageTool = createTool({
       },
       id: 'alpha-vantage',
     })
-    const apiKey = process.env.ALPHA_VANTAGE_API_KEY
+    const apiKey = requestContext?.apiKey ?? process.env.ALPHA_VANTAGE_API_KEY
 
     if (typeof apiKey !== 'string' || apiKey.trim() === '') {
       await context?.writer?.custom({