attocode 0.2.3 → 0.2.5

package/dist/src/integrations/utilities/sourcegraph.js

@@ -0,0 +1,379 @@
+/**
+ * Sourcegraph Integration
+ *
+ * Cross-repository code search using Sourcegraph API.
+ * Enables searching across multiple codebases for patterns, references, and definitions.
+ *
+ * @example
+ * ```typescript
+ * const sg = createSourcegraphClient();
+ * const results = await sg.search('context:global repo:^github.com/org func:handleAuth');
+ * ```
+ */
+// =============================================================================
+// GRAPHQL QUERIES
+// =============================================================================
+const SEARCH_QUERY = `
+query Search($query: String!, $patternType: SearchPatternType) {
+  search(query: $query, patternType: $patternType) {
+    results {
+      matchCount
+      limitHit
+      alert {
+        title
+        description
+      }
+      results {
+        __typename
+        ... on FileMatch {
+          repository {
+            name
+          }
+          file {
+            path
+            url
+          }
+          lineMatches {
+            lineNumber
+            preview
+            offsetAndLengths
+          }
+        }
+        ... on CommitSearchResult {
+          commit {
+            repository {
+              name
+            }
+            oid
+            message
+          }
+        }
+        ... on Repository {
+          name
+          url
+        }
+      }
+    }
+  }
+}
+`;
+const SYMBOL_QUERY = `
+query Symbols($query: String!, $first: Int) {
+  search(query: $query) {
+    results {
+      results {
+        __typename
+        ... on FileMatch {
+          symbols {
+            name
+            kind
+            containerName
+            location {
+              resource {
+                path
+                repository {
+                  name
+                }
+              }
+              range {
+                start { line character }
+                end { line character }
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+}
+`;
+// =============================================================================
+// SOURCEGRAPH CLIENT
+// =============================================================================
+/**
+ * Sourcegraph API client.
+ */
+export class SourcegraphClient {
+    config;
+    constructor(config = {}) {
+        this.config = {
+            endpoint: config.endpoint || 'https://sourcegraph.com',
+            accessToken: config.accessToken || process.env.SOURCEGRAPH_ACCESS_TOKEN || '',
+            defaultContext: config.defaultContext || 'global',
+            timeout: config.timeout || 30000,
+        };
+    }
+    /**
+     * Check if the client is configured with valid credentials.
+     */
+    isConfigured() {
+        return !!this.config.accessToken;
+    }
+    /**
+     * Search code across repositories.
+     */
+    async search(query, options = {}) {
+        if (!this.isConfigured()) {
+            throw new Error('Sourcegraph access token not configured. Set SOURCEGRAPH_ACCESS_TOKEN environment variable.');
+        }
+        // Build full query with options
+        const fullQuery = this.buildQuery(query, options);
+        const startTime = Date.now();
+        const response = await this.graphql(SEARCH_QUERY, {
+            query: fullQuery,
+            patternType: options.patternType?.toUpperCase() || 'LITERAL',
+        });
+        const data = response.search?.results;
+        if (!data) {
+            return {
+                results: [],
+                matchCount: 0,
+                durationMs: Date.now() - startTime,
+                limitHit: false,
+            };
+        }
+        const results = [];
+        for (const result of data.results || []) {
+            if (result.__typename === 'FileMatch') {
+                const repository = result.repository?.name || '';
+                const filePath = result.file?.path || '';
+                const fileUrl = `${this.config.endpoint}${result.file?.url || ''}`;
+                for (const lineMatch of result.lineMatches || []) {
+                    results.push({
+                        repository,
+                        filePath,
+                        fileUrl,
+                        lineNumbers: [lineMatch.lineNumber],
+                        preview: lineMatch.preview,
+                        matchType: 'content',
+                    });
+                }
+            }
+            else if (result.__typename === 'Repository') {
+                results.push({
+                    repository: result.name,
+                    filePath: '',
+                    fileUrl: `${this.config.endpoint}${result.url || ''}`,
+                    lineNumbers: [],
+                    preview: result.name,
+                    matchType: 'path',
+                });
+            }
+        }
+        return {
+            results: options.maxResults ? results.slice(0, options.maxResults) : results,
+            matchCount: data.matchCount || results.length,
+            durationMs: Date.now() - startTime,
+            limitHit: data.limitHit || false,
+            alerts: data.alert ? [data.alert.description || data.alert.title] : undefined,
+        };
+    }
+    /**
+     * Search for symbols (functions, classes, etc.).
+     */
+    async searchSymbols(query, options = {}) {
+        if (!this.isConfigured()) {
+            throw new Error('Sourcegraph access token not configured');
+        }
+        const fullQuery = this.buildQuery(`type:symbol ${query}`, options);
+        const response = await this.graphql(SYMBOL_QUERY, {
+            query: fullQuery,
+            first: options.maxResults || 50,
+        });
+        const results = response.search?.results?.results || [];
+        const symbols = [];
+        for (const result of results) {
+            if (result.__typename === 'FileMatch' && result.symbols) {
+                for (const symbol of result.symbols) {
+                    symbols.push({
+                        name: symbol.name,
+                        kind: symbol.kind,
+                        containerName: symbol.containerName,
+                        filePath: symbol.location?.resource?.path || '',
+                        repository: symbol.location?.resource?.repository?.name || '',
+                        range: {
+                            start: {
+                                line: symbol.location?.range?.start?.line || 0,
+                                character: symbol.location?.range?.start?.character || 0,
+                            },
+                            end: {
+                                line: symbol.location?.range?.end?.line || 0,
+                                character: symbol.location?.range?.end?.character || 0,
+                            },
+                        },
+                    });
+                }
+            }
+        }
+        return symbols;
+    }
+    /**
+     * Find references to a symbol.
+     */
+    async findReferences(symbolName, options = {}) {
+        const query = `\\b${this.escapeRegex(symbolName)}\\b`;
+        return this.search(query, { ...options, patternType: 'regexp' });
+    }
+    /**
+     * Find definition of a symbol.
+     */
+    async findDefinition(symbolName, language) {
+        const query = language
+            ? `${symbolName} lang:${language}`
+            : symbolName;
+        return this.searchSymbols(query, { maxResults: 10 });
+    }
+    /**
+     * Search for files by path pattern.
+     */
+    async searchFiles(pathPattern, options = {}) {
+        const query = `file:${pathPattern}`;
+        return this.search(query, options);
+    }
+    /**
+     * Get repository information.
+     */
+    async getRepository(repoName) {
+        const query = `
+      query Repository($name: String!) {
+        repository(name: $name) {
+          name
+          description
+          url
+          defaultBranch {
+            name
+          }
+        }
+      }
+    `;
+        const response = await this.graphql(query, { name: repoName });
+        const repo = response.repository;
+        if (!repo)
+            return null;
+        return {
+            name: repo.name,
+            description: repo.description,
+            url: `${this.config.endpoint}${repo.url || ''}`,
+            defaultBranch: repo.defaultBranch?.name,
+        };
+    }
+    // ===========================================================================
+    // PRIVATE METHODS
+    // ===========================================================================
+    /**
+     * Build a full query string with options.
+     */
+    buildQuery(baseQuery, options) {
+        const parts = [];
+        // Context
+        const context = options.context || this.config.defaultContext;
+        if (context && context !== 'global') {
+            parts.push(`context:${context}`);
+        }
+        // Repository filter
+        if (options.repoFilter) {
+            parts.push(`repo:${options.repoFilter}`);
+        }
+        // File filter
+        if (options.fileFilter) {
+            parts.push(`file:${options.fileFilter}`);
+        }
+        // Language filter
+        if (options.language) {
+            parts.push(`lang:${options.language}`);
+        }
+        // Case sensitivity
+        if (options.caseSensitive) {
+            parts.push('case:yes');
+        }
+        // Add base query
+        parts.push(baseQuery);
+        return parts.join(' ');
+    }
+    /**
+     * Execute a GraphQL query.
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    async graphql(query, variables) {
+        const controller = new AbortController();
+        const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+        try {
+            const response = await fetch(`${this.config.endpoint}/.api/graphql`, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/json',
+                    'Authorization': `token ${this.config.accessToken}`,
+                },
+                body: JSON.stringify({ query, variables }),
+                signal: controller.signal,
+            });
+            if (!response.ok) {
+                throw new Error(`Sourcegraph API error: ${response.status} ${response.statusText}`);
+            }
+            const json = await response.json();
+            if (json.errors?.length) {
+                throw new Error(`Sourcegraph query error: ${json.errors[0].message}`);
+            }
+            return json.data || {};
+        }
+        finally {
+            clearTimeout(timeoutId);
+        }
+    }
+    /**
+     * Escape special regex characters.
+     */
+    escapeRegex(str) {
+        return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    }
+}
+// =============================================================================
+// FACTORY
+// =============================================================================
+/**
+ * Create a Sourcegraph client.
+ */
+export function createSourcegraphClient(config) {
+    return new SourcegraphClient(config);
+}
+// =============================================================================
+// UTILITIES
+// =============================================================================
+/**
+ * Format search results for display.
+ */
+export function formatSearchResults(response, maxPreviewLines = 3) {
+    const lines = [];
+    lines.push(`Found ${response.matchCount} matches in ${response.durationMs}ms`);
+    if (response.limitHit) {
+        lines.push('(results truncated)');
+    }
+    lines.push('');
+    for (const result of response.results) {
+        lines.push(`${result.repository}/${result.filePath}`);
+        if (result.lineNumbers.length > 0) {
+            lines.push(`  Line ${result.lineNumbers.join(', ')}`);
+        }
+        if (result.preview) {
+            const previewLines = result.preview.split('\n').slice(0, maxPreviewLines);
+            for (const line of previewLines) {
+                lines.push(`    ${line}`);
+            }
+        }
+        lines.push('');
+    }
+    if (response.alerts?.length) {
+        lines.push('Alerts:');
+        for (const alert of response.alerts) {
+            lines.push(`  - ${alert}`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Check if Sourcegraph is configured.
+ */
+export function isSourcegraphConfigured() {
+    return !!process.env.SOURCEGRAPH_ACCESS_TOKEN;
+}
+//# sourceMappingURL=sourcegraph.js.map

package/dist/src/integrations/utilities/sourcegraph.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sourcegraph.js","sourceRoot":"","sources":["../../../../src/integrations/utilities/sourcegraph.ts"],"names":[],"mappings":"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"}

package/dist/src/integrations/utilities/thinking-strategy.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Thinking/Reflection Strategy
+ *
+ * Generates thinking directives that guide LLMs to use their
+ * internal reasoning (extended thinking) for better planning,
+ * evaluation, and self-assessment.
+ *
+ * Following Anthropic's multi-agent research pattern:
+ * thinking is controlled through prompt engineering, not code mechanics.
+ */
+import type { ComplexityTier } from '../agents/complexity-classifier.js';
+export interface ThinkingDirective {
+    /** What the model should think about before acting */
+    preActionPrompt?: string;
+    /** What the model should evaluate after tool results */
+    postToolPrompt?: string;
+    /** Quality assessment prompt before returning results */
+    qualityCheckPrompt?: string;
+}
+export interface ThinkingConfig {
+    /** Enable pre-task planning in thinking */
+    enablePreTaskPlanning: boolean;
+    /** Enable post-tool evaluation in thinking */
+    enablePostToolEvaluation: boolean;
+    /** Enable quality self-assessment */
+    enableQualityAssessment: boolean;
+    /** Minimum complexity tier for thinking activation */
+    minComplexityTier: ComplexityTier;
+}
+/**
+ * Generate thinking directives based on complexity and config.
+ */
+export declare function generateThinkingDirectives(complexityTier: ComplexityTier, config?: Partial<ThinkingConfig>): ThinkingDirective;
+/**
+ * Generate thinking-related system prompt additions.
+ * Injected into buildMessages() for complex tasks.
+ */
+export declare function getThinkingSystemPrompt(complexityTier: ComplexityTier, config?: Partial<ThinkingConfig>): string | null;
+/**
+ * Generate quality self-assessment prompt for subagents.
+ * Added to subagent constraints before they return.
+ */
+export declare function getSubagentQualityPrompt(): string;
+/**
+ * Create a thinking strategy manager.
+ */
+export declare function createThinkingStrategy(config?: Partial<ThinkingConfig>): {
+    generateDirectives: (tier: ComplexityTier) => ThinkingDirective;
+    getSystemPrompt: (tier: ComplexityTier) => string | null;
+    getSubagentPrompt: () => string;
+};
+//# sourceMappingURL=thinking-strategy.d.ts.map

package/dist/src/integrations/utilities/thinking-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thinking-strategy.d.ts","sourceRoot":"","sources":["../../../../src/integrations/utilities/thinking-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAMzE,MAAM,WAAW,iBAAiB;IAChC,sDAAsD;IACtD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,wDAAwD;IACxD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,yDAAyD;IACzD,kBAAkB,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,2CAA2C;IAC3C,qBAAqB,EAAE,OAAO,CAAC;IAC/B,8CAA8C;IAC9C,wBAAwB,EAAE,OAAO,CAAC;IAClC,qCAAqC;IACrC,uBAAuB,EAAE,OAAO,CAAC;IACjC,sDAAsD;IACtD,iBAAiB,EAAE,cAAc,CAAC;CACnC;AA2BD;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,cAAc,EAAE,cAAc,EAC9B,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B,iBAAiB,CAuBnB;AA0CD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,cAAc,EAAE,cAAc,EAC9B,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B,MAAM,GAAG,IAAI,CAkBf;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAQjD;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,CAAC,EAAE,OAAO,CAAC,cAAc,CAAC,GAC/B;IACD,kBAAkB,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,iBAAiB,CAAC;IAChE,eAAe,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,MAAM,GAAG,IAAI,CAAC;IACzD,iBAAiB,EAAE,MAAM,MAAM,CAAC;CACjC,CAMA"}

package/dist/src/integrations/utilities/thinking-strategy.js

@@ -0,0 +1,129 @@
+/**
+ * Thinking/Reflection Strategy
+ *
+ * Generates thinking directives that guide LLMs to use their
+ * internal reasoning (extended thinking) for better planning,
+ * evaluation, and self-assessment.
+ *
+ * Following Anthropic's multi-agent research pattern:
+ * thinking is controlled through prompt engineering, not code mechanics.
+ */
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+const DEFAULT_CONFIG = {
+    enablePreTaskPlanning: true,
+    enablePostToolEvaluation: true,
+    enableQualityAssessment: true,
+    minComplexityTier: 'medium',
+};
+/**
+ * Complexity tier ordering for comparison.
+ */
+const TIER_ORDER = {
+    simple: 0,
+    medium: 1,
+    complex: 2,
+    deep_research: 3,
+};
+// =============================================================================
+// DIRECTIVE GENERATORS
+// =============================================================================
+/**
+ * Generate thinking directives based on complexity and config.
+ */
+export function generateThinkingDirectives(complexityTier, config) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    // Check if thinking should be activated for this complexity level
+    if (TIER_ORDER[complexityTier] < TIER_ORDER[cfg.minComplexityTier]) {
+        return {}; // No thinking directives for simple tasks
+    }
+    const directive = {};
+    if (cfg.enablePreTaskPlanning) {
+        directive.preActionPrompt = getPreActionPrompt(complexityTier);
+    }
+    if (cfg.enablePostToolEvaluation) {
+        directive.postToolPrompt = getPostToolPrompt(complexityTier);
+    }
+    if (cfg.enableQualityAssessment) {
+        directive.qualityCheckPrompt = getQualityCheckPrompt(complexityTier);
+    }
+    return directive;
+}
+function getPreActionPrompt(tier) {
+    if (tier === 'deep_research' || tier === 'complex') {
+        return `Before taking any action, use your thinking to:
+1. Assess which tools are most relevant for this task
+2. Determine the optimal sequence of operations
+3. If complex, plan which subagents to spawn and what each should do
+4. Identify potential pitfalls or dependencies between subtasks
+5. Decide whether to explore more or act on what you know
+
+Then proceed with your plan.`;
+    }
+    return `Before acting, briefly assess in your thinking:
+1. What tools are most relevant for this task?
+2. What is the most efficient approach?
+3. Are there dependencies between steps?
+
+Then proceed.`;
+}
+function getPostToolPrompt(_tier) {
+    return `After receiving tool results, evaluate in your thinking:
+- Did the tool calls return useful information?
+- Is the information sufficient or do I need more?
+- Should I change approach based on what I learned?
+- Are there any errors or unexpected results to address?`;
+}
+function getQualityCheckPrompt(_tier) {
+    return `Before returning your final answer, evaluate in your thinking:
+1. Did I address all aspects of the objective?
+2. Is my output complete and in the correct format?
+3. Have I met all success criteria?
+4. Are there any gaps or issues I should flag?`;
+}
+// =============================================================================
+// SYSTEM PROMPT INTEGRATION
+// =============================================================================
+/**
+ * Generate thinking-related system prompt additions.
+ * Injected into buildMessages() for complex tasks.
+ */
+export function getThinkingSystemPrompt(complexityTier, config) {
+    const directive = generateThinkingDirectives(complexityTier, config);
+    if (!directive.preActionPrompt && !directive.postToolPrompt) {
+        return null;
+    }
+    const parts = ['## Thinking Guidelines'];
+    if (directive.preActionPrompt) {
+        parts.push(`### Before Acting\n${directive.preActionPrompt}`);
+    }
+    if (directive.postToolPrompt) {
+        parts.push(`### After Tool Results\n${directive.postToolPrompt}`);
+    }
+    return parts.join('\n\n');
+}
+/**
+ * Generate quality self-assessment prompt for subagents.
+ * Added to subagent constraints before they return.
+ */
+export function getSubagentQualityPrompt() {
+    return `Before returning your final result, evaluate your work:
+1. Did you fully address the objective given to you?
+2. Is your output in the expected format?
+3. Did you stay within scope (not doing more or less than asked)?
+4. Are there any unresolved issues or gaps to flag to the parent?
+
+If you find gaps, note them clearly in your response.`;
+}
+/**
+ * Create a thinking strategy manager.
+ */
+export function createThinkingStrategy(config) {
+    return {
+        generateDirectives: (tier) => generateThinkingDirectives(tier, config),
+        getSystemPrompt: (tier) => getThinkingSystemPrompt(tier, config),
+        getSubagentPrompt: getSubagentQualityPrompt,
+    };
+}
+//# sourceMappingURL=thinking-strategy.js.map

package/dist/src/integrations/utilities/thinking-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thinking-strategy.js","sourceRoot":"","sources":["../../../../src/integrations/utilities/thinking-strategy.ts"],"names":[],"mappings":"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"}