lint

Author: pietrozullo

DEVELOPMENT.md

@@ -77,13 +77,11 @@ We use GitHub Actions to automate our release process, connecting GitHub Release
    ```
 
    This will:
-
    - Update the version in package.json
    - Create a git tag
    - Push the changes and tag to GitHub
 
 2. **Create GitHub Release**:
-
    - Go to GitHub repository → "Releases" → "Draft a new release"
    - Choose the tag that was just created
    - Fill in release notes detailing what's new, fixes, and any breaking changes
@@ -92,7 +90,6 @@ We use GitHub Actions to automate our release process, connecting GitHub Release
 3. **Automated Publishing**:
 
    The GitHub Action will automatically:
-
    - Verify the package version matches the GitHub tag
    - Run linting and build checks
    - Generate a changelog from commits since the last release
@@ -106,12 +103,10 @@ We use GitHub Actions to automate our release process, connecting GitHub Release
 To set up automated publishing:
 
 1. Generate an NPM access token:
-
    - Go to npmjs.com → User Settings → Access Tokens
    - Create a new token with "Automation" type and publish permissions
 
 2. Add the token to GitHub repository secrets:
-
    - Go to your GitHub repository → Settings → Secrets → Actions
    - Add a new secret named `NPM_TOKEN` with the value of your NPM token
 

src/agents/mcp_agent.ts

@@ -7,7 +7,6 @@ import type { StreamEvent } from '@langchain/core/tracers/log_stream'
 import type { AgentFinish, AgentStep } from 'langchain/agents'
 
 import type { ZodSchema } from 'zod'
-import { zodToJsonSchema } from 'zod-to-json-schema'
 import type { MCPClient } from '../client.js'
 import type { BaseConnector } from '../connectors/base.js'
 import type { MCPSession } from '../session.js'
@@ -25,6 +24,7 @@ import {
   AgentExecutor,
   createToolCallingAgent,
 } from 'langchain/agents'
+import { zodToJsonSchema } from 'zod-to-json-schema'
 import { LangChainAdapter } from '../adapters/langchain_adapter.js'
 import { logger } from '../logging.js'
 import { ServerManager } from '../managers/server_manager.js'
@@ -368,7 +368,7 @@ export class MCPAgent {
         // Fallback: use the same LLM but we'll handle structure in our helper method
         structuredLlm = this.llm
       }
-      schemaDescription = JSON.stringify(zodToJsonSchema(outputSchema), null, 2);
+      schemaDescription = JSON.stringify(zodToJsonSchema(outputSchema), null, 2)
     }
 
     try {
@@ -804,10 +804,10 @@ export class MCPAgent {
     // Get detailed schema information for better prompting
     const maxRetries = 3
     let lastError: string = ''
-    
+
     for (let attempt = 1; attempt <= maxRetries; attempt++) {
       logger.info(`🔄 Structured output attempt ${attempt}/${maxRetries}`)
-      
+
       let formatPrompt = `
       Please format the following information according to the EXACT schema specified below.
       You must use the exact field names and types as shown in the schema.
@@ -842,21 +842,21 @@ export class MCPAgent {
         const validatedResult = this._validateStructuredResult(structuredResult, outputSchema)
         logger.info(`✅ Structured output successful on attempt ${attempt}`)
         return validatedResult
-        
-      } catch (e) {
+      }
+      catch (e) {
         lastError = e instanceof Error ? e.message : String(e)
         logger.warn(`⚠️ Structured output attempt ${attempt} failed: ${lastError}`)
-        
+
         if (attempt === maxRetries) {
           logger.error(`❌ All ${maxRetries} structured output attempts failed`)
           throw new Error(`Failed to generate valid structured output after ${maxRetries} attempts. Last error: ${lastError}`)
         }
-        
+
         // Continue to next attempt
         continue
       }
     }
-    
+
     // This should never be reached, but TypeScript requires it
     throw new Error('Unexpected error in structured output generation')
   }
@@ -866,42 +866,42 @@ export class MCPAgent {
    */
   private _validateStructuredResult<T>(structuredResult: any, outputSchema: ZodSchema<T>): T {
     // Use Zod to validate the structured result
-    try { 
+    try {
       // Use Zod to validate the structured result
       const validatedResult = outputSchema.parse(structuredResult)
 
-    // Additional validation for required fields
-    const schemaType = outputSchema as any
-    if (schemaType._def && schemaType._def.shape) {
-      for (const [fieldName, fieldSchema] of Object.entries(schemaType._def.shape)) {
-        const field = fieldSchema as any
-        const isOptional = field.isOptional?.() ?? field._def?.typeName === 'ZodOptional'
-        const isNullable = field.isNullable?.() ?? field._def?.typeName === 'ZodNullable'
-        if (!isOptional && !isNullable) {
-          const value = (validatedResult as any)[fieldName]
-          if (value === null || value === undefined
-            || (typeof value === 'string' && !value.trim())
-            || (Array.isArray(value) && value.length === 0)) {
-            throw new Error(`Required field '${fieldName}' is missing or empty`)
+      // Additional validation for required fields
+      const schemaType = outputSchema as any
+      if (schemaType._def && schemaType._def.shape) {
+        for (const [fieldName, fieldSchema] of Object.entries(schemaType._def.shape)) {
+          const field = fieldSchema as any
+          const isOptional = field.isOptional?.() ?? field._def?.typeName === 'ZodOptional'
+          const isNullable = field.isNullable?.() ?? field._def?.typeName === 'ZodNullable'
+          if (!isOptional && !isNullable) {
+            const value = (validatedResult as any)[fieldName]
+            if (value === null || value === undefined
+              || (typeof value === 'string' && !value.trim())
+              || (Array.isArray(value) && value.length === 0)) {
+              throw new Error(`Required field '${fieldName}' is missing or empty`)
+            }
           }
         }
       }
-    }
 
-    return validatedResult
-  }
-  catch (e) {
-    logger.debug(`Validation details: ${e}`)
-    throw e // Re-raise to trigger retry logic
-  }
+      return validatedResult
+    }
+    catch (e) {
+      logger.debug(`Validation details: ${e}`)
+      throw e // Re-raise to trigger retry logic
+    }
   }
 
   /**
    * Enhance the query with schema information to make the agent aware of required fields.
    */
   private _enhanceQueryWithSchema<T>(query: string, outputSchema: ZodSchema<T>): string {
     try {
-      const schemaDescription = JSON.stringify(zodToJsonSchema(outputSchema), null, 2);
+      const schemaDescription = JSON.stringify(zodToJsonSchema(outputSchema), null, 2)
 
       // Enhance the query with schema awareness
       const enhancedQuery = `