Add Search Engine

Add Search Engine Skill

When the user requests to add a new AI search engine (e.g., "Integrate Claude 3", "Add Anthropic"), follow these steps:

Steps

1. Create Provider File

   • Create src/infrastructure/search/{provider-name}.provider.ts
   • Import the ISearchProvider interface from src/domain/search/types.ts
   • Implement all required methods

2. Provider Template

   import { ISearchProvider, SearchOptions, SearchResult } from '../../domain/search/types.js';
   import { env } from '../../config/index.js';
   
   export class {ProviderName}Provider implements ISearchProvider {
     private readonly apiKey: string;
   
     constructor() {
       this.apiKey = env.{PROVIDER}_API_KEY ?? '';
       if (!this.apiKey) {
         throw new Error('{PROVIDER}_API_KEY is required');
       }
     }
   
     async search(query: string, options?: SearchOptions): Promise<SearchResult> {
       // Implementation
     }
   }
   

3. Update Factory

   • Edit src/infrastructure/search/factory.ts
   • Add the new provider to the createProvider function
   • Add the provider enum value

4. Update Environment

   • Add {PROVIDER}_API_KEY to .env.example
   • Add to the env schema in src/config/env.ts

5. Update Schema

   • Add provider to the engines enum in controller schemas

6. Test

   • Run npm run typecheck to verify compilation
   • Create a basic integration test

Validation Checklist

• Provider implements ISearchProvider interface
• Environment variable documented in .env.example
• Factory updated with new provider
• Controller enum includes new provider
• No TypeScript errors