@compilr-dev/agents 0.0.1 → 0.1.0

package/dist/providers/openai.js

@@ -0,0 +1,133 @@
+/**
+ * OpenAI LLM Provider
+ *
+ * Implements LLMProvider interface for OpenAI models (GPT-4o, GPT-4o-mini, etc.)
+ * Extends OpenAICompatibleProvider for shared functionality.
+ *
+ * @example
+ * ```typescript
+ * const provider = createOpenAIProvider({
+ *   model: 'gpt-4o',
+ *   apiKey: process.env.OPENAI_API_KEY
+ * });
+ * ```
+ *
+ * @remarks
+ * - Requires valid OpenAI API key
+ * - Default model is gpt-4o
+ * - Extended thinking is not supported (Claude-specific feature)
+ */
+import { ProviderError } from '../errors.js';
+import { OpenAICompatibleProvider } from './openai-compatible.js';
+// Default configuration
+const DEFAULT_MODEL = 'gpt-4o';
+const DEFAULT_BASE_URL = 'https://api.openai.com';
+/**
+ * OpenAI LLM Provider
+ *
+ * Provides streaming chat completion using OpenAI models.
+ * Supports GPT-4o, GPT-4o-mini, and other compatible models.
+ */
+export class OpenAIProvider extends OpenAICompatibleProvider {
+    name = 'openai';
+    apiKey;
+    organization;
+    constructor(config = {}) {
+        const apiKey = config.apiKey ?? process.env.OPENAI_API_KEY;
+        if (!apiKey) {
+            throw new ProviderError('OpenAI API key not found. Set OPENAI_API_KEY environment variable or pass apiKey in config.', 'openai');
+        }
+        const baseConfig = {
+            baseUrl: config.baseUrl ?? DEFAULT_BASE_URL,
+            model: config.model ?? DEFAULT_MODEL,
+            maxTokens: config.maxTokens,
+            timeout: config.timeout,
+        };
+        super(baseConfig);
+        this.apiKey = apiKey;
+        this.organization = config.organization;
+    }
+    /**
+     * OpenAI authentication with Bearer token
+     */
+    getAuthHeaders() {
+        const headers = {
+            Authorization: `Bearer ${this.apiKey}`,
+        };
+        if (this.organization) {
+            headers['OpenAI-Organization'] = this.organization;
+        }
+        return headers;
+    }
+    /**
+     * OpenAI chat completions endpoint
+     */
+    getEndpointPath() {
+        return '/v1/chat/completions';
+    }
+    /**
+     * OpenAI uses standard body format (no provider-specific extensions needed)
+     */
+    buildProviderSpecificBody(_options) {
+        return {};
+    }
+    /**
+     * Map HTTP errors with OpenAI-specific messages
+     */
+    mapHttpError(status, body, _model) {
+        let message = `OpenAI error (${String(status)})`;
+        try {
+            const parsed = JSON.parse(body);
+            if (parsed.error?.message) {
+                message = parsed.error.message;
+            }
+        }
+        catch {
+            message = body || message;
+        }
+        switch (status) {
+            case 401:
+                return new ProviderError('Invalid OpenAI API key. Check your OPENAI_API_KEY.', 'openai', 401);
+            case 403:
+                return new ProviderError('Access denied. Check your OpenAI API key permissions.', 'openai', 403);
+            case 429:
+                return new ProviderError('OpenAI rate limit exceeded. Please wait and try again.', 'openai', 429);
+            case 500:
+            case 502:
+            case 503:
+                return new ProviderError('OpenAI service temporarily unavailable. Please try again later.', 'openai', status);
+            default:
+                return new ProviderError(message, 'openai', status);
+        }
+    }
+    /**
+     * Map connection errors with OpenAI-specific messages
+     */
+    mapConnectionError(_error) {
+        return new ProviderError('Failed to connect to OpenAI API. Check your internet connection.', 'openai');
+    }
+}
+/**
+ * Create an OpenAI provider instance
+ *
+ * @example
+ * ```typescript
+ * // Using environment variable (OPENAI_API_KEY)
+ * const provider = createOpenAIProvider();
+ *
+ * // With explicit API key
+ * const provider = createOpenAIProvider({ apiKey: 'sk-...' });
+ *
+ * // With custom model
+ * const provider = createOpenAIProvider({ model: 'gpt-4o-mini' });
+ *
+ * // With organization
+ * const provider = createOpenAIProvider({
+ *   apiKey: 'sk-...',
+ *   organization: 'org-...'
+ * });
+ * ```
+ */
+export function createOpenAIProvider(config = {}) {
+    return new OpenAIProvider(config);
+}

package/dist/tools/builtin/glob.d.ts

@@ -38,6 +38,12 @@ export interface GlobInput {
      * Return absolute paths instead of relative (default: false)
      */
     absolute?: boolean;
+    /**
+     * Directory names to exclude from search.
+     * Default excludes: node_modules, .git, dist, build, etc.
+     * Set to empty array [] to include all directories.
+     */
+    excludeDirs?: string[];
 }
 /**
  * Glob tool definition
@@ -59,4 +65,9 @@ export declare function createGlobTool(options?: {
      * Always include these patterns regardless of ignore
      */
     alwaysInclude?: string[];
+    /**
+     * Override default excluded directories.
+     * Defaults to: node_modules, .git, dist, build, etc.
+     */
+    excludeDirs?: string[];
 }): Tool<GlobInput>;

package/dist/tools/builtin/glob.js

@@ -5,6 +5,29 @@ import { readdir } from 'node:fs/promises';
 import { join } from 'node:path';
 import { defineTool, createSuccessResult, createErrorResult } from '../define.js';
 import { isNodeError } from './utils.js';
+/**
+ * Default directories to exclude from glob searches.
+ * These are typically large, generated, or not relevant for code search.
+ */
+const DEFAULT_EXCLUDE_DIRS = [
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    '.next',
+    '.nuxt',
+    '.output',
+    'coverage',
+    '.nyc_output',
+    '__pycache__',
+    '.pytest_cache',
+    'venv',
+    '.venv',
+    'target', // Rust/Java
+    'vendor', // Go/PHP
+    '.cargo',
+    '.cache',
+];
 /**
  * Glob tool definition
  */
@@ -48,6 +71,11 @@ export const globTool = defineTool({
                 type: 'boolean',
                 description: 'Return absolute paths instead of relative',
             },
+            excludeDirs: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Directory names to exclude (default: node_modules, .git, dist, build, etc.)',
+            },
         },
         required: ['pattern'],
     },
@@ -57,7 +85,7 @@ export const globTool = defineTool({
  * Execute the glob tool
  */
 async function executeGlob(input) {
-    const { pattern, path: basePath = '.', includeHidden = false, onlyDirectories = false, onlyFiles = !onlyDirectories, maxDepth, maxResults = 1000, absolute = false, } = input;
+    const { pattern, path: basePath = '.', includeHidden = false, onlyDirectories = false, onlyFiles = !onlyDirectories, maxDepth, maxResults = 1000, absolute = false, excludeDirs = DEFAULT_EXCLUDE_DIRS, } = input;
     // Check if base path exists
     try {
         await readdir(basePath);
@@ -91,6 +119,7 @@ async function executeGlob(input) {
             maxResults,
             matches,
             basePath,
+            excludeDirs,
         });
         // Format output
         const results = absolute ? matches.map((m) => join(basePath, m)) : matches;
@@ -117,6 +146,7 @@ async function searchDirectory(basePath, relativePath, depth, options) {
         return;
     }
     const currentPath = relativePath ? join(basePath, relativePath) : basePath;
+    const excludeSet = new Set(options.excludeDirs);
     let entries;
     try {
         entries = await readdir(currentPath, { withFileTypes: true });
@@ -133,8 +163,12 @@ async function searchDirectory(basePath, relativePath, depth, options) {
         if (!options.includeHidden && entry.name.startsWith('.')) {
             continue;
         }
-        const entryRelativePath = relativePath ? join(relativePath, entry.name) : entry.name;
         const isDir = entry.isDirectory();
+        // Skip excluded directories
+        if (isDir && excludeSet.has(entry.name)) {
+            continue;
+        }
+        const entryRelativePath = relativePath ? join(relativePath, entry.name) : entry.name;
         const isFile = entry.isFile();
         // Check if this entry matches the pattern
         if (options.pattern.test(entryRelativePath)) {
@@ -226,6 +260,11 @@ export function createGlobTool(options) {
                     type: 'boolean',
                     description: 'Return absolute paths instead of relative',
                 },
+                excludeDirs: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Directory names to exclude (default: node_modules, .git, dist, build, etc.)',
+                },
             },
             required: ['pattern'],
         },
@@ -235,9 +274,12 @@ export function createGlobTool(options) {
             if (options?.baseDir && !searchPath.startsWith('/')) {
                 searchPath = join(options.baseDir, searchPath);
             }
+            // Apply custom excludeDirs from factory options if specified and input doesn't override
+            const excludeDirs = input.excludeDirs ?? options?.excludeDirs ?? DEFAULT_EXCLUDE_DIRS;
             return executeGlob({
                 ...input,
                 path: searchPath,
+                excludeDirs,
             });
         },
     });

package/dist/tools/builtin/grep.d.ts

@@ -50,6 +50,12 @@ export interface GrepInput {
      * Search recursively in directories (default: true)
      */
     recursive?: boolean;
+    /**
+     * Directory names to exclude from search.
+     * Default excludes: node_modules, .git, dist, build, etc.
+     * Set to empty array [] to include all directories.
+     */
+    excludeDirs?: string[];
 }
 /**
  * Grep tool definition
@@ -60,7 +66,6 @@ export declare const grepTool: Tool<GrepInput>;
  *
  * TODO: Future enhancements could include:
  * - maxFileSize: Skip files larger than specified size
- * - excludeDirs: Exclude directories by name (e.g., node_modules, .git)
  */
 export declare function createGrepTool(options?: {
     /**
@@ -71,4 +76,9 @@ export declare function createGrepTool(options?: {
      * Default file extensions to search
      */
     defaultExtensions?: string[];
+    /**
+     * Override default excluded directories.
+     * Defaults to: node_modules, .git, dist, build, etc.
+     */
+    excludeDirs?: string[];
 }): Tool<GrepInput>;

package/dist/tools/builtin/grep.js

@@ -6,6 +6,29 @@ import { readdir, stat } from 'node:fs/promises';
 import { join, relative } from 'node:path';
 import { defineTool, createSuccessResult, createErrorResult } from '../define.js';
 import { isNodeError, isExtensionAllowed } from './utils.js';
+/**
+ * Default directories to exclude from grep searches.
+ * These are typically large, generated, or not relevant for code search.
+ */
+const DEFAULT_EXCLUDE_DIRS = [
+    'node_modules',
+    '.git',
+    'dist',
+    'build',
+    '.next',
+    '.nuxt',
+    '.output',
+    'coverage',
+    '.nyc_output',
+    '__pycache__',
+    '.pytest_cache',
+    'venv',
+    '.venv',
+    'target', // Rust/Java
+    'vendor', // Go/PHP
+    '.cargo',
+    '.cache',
+];
 /**
  * Grep tool definition
  */
@@ -103,7 +126,7 @@ function safeRegexTest(regex, text) {
  */
 async function executeGrep(input) {
     try {
-        const { pattern, path, ignoreCase = false, lineNumbers = true, before = 0, after = 0, filesOnly = false, includeHidden = false, extensions, maxMatches = 100, recursive = true, } = input;
+        const { pattern, path, ignoreCase = false, lineNumbers = true, before = 0, after = 0, filesOnly = false, includeHidden = false, extensions, maxMatches = 100, recursive = true, excludeDirs = DEFAULT_EXCLUDE_DIRS, } = input;
         // Check for potentially dangerous regex patterns
         if (isPotentiallyDangerousRegex(pattern)) {
             return createErrorResult(`Potentially dangerous regex pattern detected (ReDoS risk). ` +
@@ -128,6 +151,7 @@ async function executeGrep(input) {
                 recursive,
                 includeHidden,
                 extensions,
+                excludeDirs,
             });
         }
         else {
@@ -189,6 +213,7 @@ async function executeGrep(input) {
  */
 async function collectFiles(dir, files, options) {
     const entries = await readdir(dir, { withFileTypes: true });
+    const excludeSet = new Set(options.excludeDirs ?? []);
     for (const entry of entries) {
         // Skip hidden files unless included
         if (!options.includeHidden && entry.name.startsWith('.')) {
@@ -205,6 +230,10 @@ async function collectFiles(dir, files, options) {
             files.push(fullPath);
         }
         else if (entry.isDirectory() && options.recursive) {
+            // Skip excluded directories
+            if (excludeSet.has(entry.name)) {
+                continue;
+            }
             await collectFiles(fullPath, files, options);
         }
     }
@@ -286,7 +315,6 @@ function formatMatches(matches, options) {
  *
  * TODO: Future enhancements could include:
  * - maxFileSize: Skip files larger than specified size
- * - excludeDirs: Exclude directories by name (e.g., node_modules, .git)
  */
 export function createGrepTool(options) {
     return defineTool({
@@ -342,6 +370,11 @@ export function createGrepTool(options) {
                     type: 'boolean',
                     description: 'Search recursively in directories (default: true)',
                 },
+                excludeDirs: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Directory names to exclude (default: node_modules, .git, dist, build, etc.)',
+                },
             },
             required: ['pattern', 'path'],
         },
@@ -353,10 +386,13 @@ export function createGrepTool(options) {
             }
             // Apply default extensions if none specified
             const extensions = input.extensions ?? options?.defaultExtensions;
+            // Apply custom excludeDirs from factory options if specified and input doesn't override
+            const excludeDirs = input.excludeDirs ?? options?.excludeDirs ?? DEFAULT_EXCLUDE_DIRS;
             return executeGrep({
                 ...input,
                 path: searchPath,
                 extensions,
+                excludeDirs,
             });
         },
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@compilr-dev/agents",
-  "version": "0.0.1",
+  "version": "0.1.0",
   "description": "Lightweight multi-LLM agent library for building CLI AI assistants",
   "type": "module",
   "main": "dist/index.js",
@@ -64,7 +64,7 @@
     }
   },
   "devDependencies": {
-    "@anthropic-ai/sdk": "^0.30.0",
+    "@anthropic-ai/sdk": "^0.30.1",
     "@eslint/js": "^9.39.1",
     "@modelcontextprotocol/sdk": "^1.23.0",
     "@types/node": "^24.10.1",