@nanocollective/nanocoder 1.14.3 → 1.15.0

package/dist/types/core.d.ts

@@ -1,4 +1,7 @@
 import React from 'react';
+import { tool, jsonSchema, type Tool as AISDKTool } from 'ai';
+export { tool, jsonSchema };
+export type AISDKCoreTool = AISDKTool<any, any>;
 export interface Message {
     role: 'user' | 'assistant' | 'system' | 'tool';
     content: string;
@@ -37,9 +40,55 @@ export interface Tool {
     };
 }
 export type ToolHandler = (input: any) => Promise<string>;
+/**
+ * Tool formatter type for Ink UI
+ * Formats tool arguments and results for display in the CLI
+ */
+export type ToolFormatter = (args: any, result?: string) => string | Promise<string> | React.ReactElement | Promise<React.ReactElement>;
+/**
+ * Tool validator type for pre-execution validation
+ * Returns validation result with optional error message
+ */
+export type ToolValidator = (args: any) => Promise<{
+    valid: true;
+} | {
+    valid: false;
+    error: string;
+}>;
+/**
+ * Unified tool entry interface
+ *
+ * Provides a structured way to manage all tool metadata in one place:
+ * - name: Tool name for registry and lookup
+ * - tool: Native AI SDK CoreTool (without execute for human-in-the-loop)
+ * - handler: Manual execution handler called after user confirmation
+ * - formatter: Optional React component for rich CLI UI display
+ * - validator: Optional pre-execution validation function
+ */
+export interface ToolEntry {
+    name: string;
+    tool: AISDKCoreTool;
+    handler: ToolHandler;
+    formatter?: ToolFormatter;
+    validator?: ToolValidator;
+}
+/**
+ * Nanocoder's extended tool definition
+ *
+ * Uses AI SDK's native CoreTool with Nanocoder-specific metadata:
+ * - name: Tool name (metadata for registry and lookup)
+ * - tool: Native AI SDK CoreTool (using tool() and jsonSchema()) WITHOUT execute function
+ * - handler: Manual execution function called after user confirmation (human-in-the-loop)
+ * - formatter: React component for rich UI display in terminal
+ * - validator: Optional pre-execution validation
+ * - requiresConfirmation: Whether to show confirmation UI (default: true)
+ *
+ * Note: We keep 'name' as metadata since AI SDK's Tool type doesn't expose it.
+ */
 export interface ToolDefinition {
+    name: string;
+    tool: AISDKCoreTool;
     handler: ToolHandler;
-    config: Tool;
     formatter?: (args: any, result?: string) => string | Promise<string> | React.ReactElement | Promise<React.ReactElement>;
     requiresConfirmation?: boolean;
     validator?: (args: any) => Promise<{
@@ -48,6 +97,7 @@ export interface ToolDefinition {
         valid: false;
         error: string;
     }>;
+    config?: Tool;
 }
 interface LLMMessage {
     role: 'assistant';
@@ -59,15 +109,20 @@ export interface LLMChatResponse {
         message: LLMMessage;
     }>;
 }
+export interface StreamCallbacks {
+    onToken?: (token: string) => void;
+    onToolCall?: (toolCall: ToolCall) => void;
+    onFinish?: () => void;
+}
 export interface LLMClient {
     getCurrentModel(): string;
     setModel(model: string): void;
     getContextSize(): number;
     getAvailableModels(): Promise<string[]>;
-    chat(messages: Message[], tools: Tool[], signal?: AbortSignal): Promise<LLMChatResponse>;
+    chat(messages: Message[], tools: Record<string, AISDKCoreTool>, signal?: AbortSignal): Promise<LLMChatResponse>;
+    chatStream?(messages: Message[], tools: Record<string, AISDKCoreTool>, callbacks: StreamCallbacks, signal?: AbortSignal): Promise<LLMChatResponse>;
     clearContext(): Promise<void>;
 }
 export type DevelopmentMode = 'normal' | 'auto-accept' | 'plan';
 export declare const DEVELOPMENT_MODE_LABELS: Record<DevelopmentMode, string>;
-export {};
 //# sourceMappingURL=core.d.ts.map

package/dist/types/core.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../source/types/core.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../source/types/core.ts"],"names":[],"mappings":"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"}

package/dist/types/core.js

@@ -1,3 +1,5 @@
+import { tool, jsonSchema } from 'ai';
+export { tool, jsonSchema };
 export const DEVELOPMENT_MODE_LABELS = {
     normal: '▶ normal mode on',
     'auto-accept': '⏵⏵ auto-accept mode on',

package/dist/types/core.js.map

@@ -1 +1 @@
-{"version":3,"file":"core.js","sourceRoot":"","sources":["../../source/types/core.ts"],"names":[],"mappings":"AA8FA,MAAM,CAAC,MAAM,uBAAuB,GAAoC;IACvE,MAAM,EAAE,kBAAkB;IAC1B,aAAa,EAAE,wBAAwB;IACvC,IAAI,EAAE,gBAAgB;CACtB,CAAC"}
+{"version":3,"file":"core.js","sourceRoot":"","sources":["../../source/types/core.ts"],"names":[],"mappings":"AAEA,OAAO,EAAC,IAAI,EAAE,UAAU,EAAyB,MAAM,IAAI,CAAC;AAE5D,OAAO,EAAC,IAAI,EAAE,UAAU,EAAC,CAAC;AA8K1B,MAAM,CAAC,MAAM,uBAAuB,GAAoC;IACvE,MAAM,EAAE,kBAAkB;IAC1B,aAAa,EAAE,wBAAwB;IACvC,IAAI,EAAE,gBAAgB;CACtB,CAAC"}

package/dist/utils/file-autocomplete.d.ts

@@ -0,0 +1,31 @@
+interface FileCompletion {
+    path: string;
+    displayPath: string;
+    score: number;
+    isDirectory: boolean;
+}
+/**
+ * Fuzzy match scoring algorithm for file paths
+ * Returns a score from 0 to 1000 (higher = better match)
+ * @deprecated Use fuzzyScoreFilePath from fuzzy-matching.ts instead
+ */
+export declare function fuzzyScore(filePath: string, query: string): number;
+/**
+ * Extract the current @mention being typed at cursor position
+ * Returns the mention text and its position in the input
+ */
+export declare function getCurrentFileMention(input: string, cursorPosition?: number): {
+    mention: string;
+    startIndex: number;
+    endIndex: number;
+} | null;
+/**
+ * Get file completions for a partial path
+ */
+export declare function getFileCompletions(partialPath: string, cwd: string, maxResults?: number): Promise<FileCompletion[]>;
+/**
+ * Clear the file list cache (useful for testing or when files change)
+ */
+export declare function clearFileListCache(): void;
+export {};
+//# sourceMappingURL=file-autocomplete.d.ts.map

package/dist/utils/file-autocomplete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-autocomplete.d.ts","sourceRoot":"","sources":["../../source/utils/file-autocomplete.ts"],"names":[],"mappings":"AASA,UAAU,cAAc;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;CACrB;AAqFD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAElE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,MAAM,EACb,cAAc,CAAC,EAAE,MAAM,GACrB;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAC,GAAG,IAAI,CA8ChE;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACvC,WAAW,EAAE,MAAM,EACnB,GAAG,EAAE,MAAM,EACX,UAAU,GAAE,MAAW,GACrB,OAAO,CAAC,cAAc,EAAE,CAAC,CAwB3B;AAED;;GAEG;AACH,wBAAgB,kBAAkB,IAAI,IAAI,CAEzC"}

package/dist/utils/file-autocomplete.js

@@ -0,0 +1,156 @@
+import { exec } from 'node:child_process';
+import { promisify } from 'node:util';
+import { readFileSync, existsSync } from 'node:fs';
+import { join } from 'node:path';
+import ignore from 'ignore';
+import { fuzzyScoreFilePath } from './fuzzy-matching.js';
+const execAsync = promisify(exec);
+/**
+ * Load and parse .gitignore file, returns an ignore instance
+ */
+function loadGitignore(cwd) {
+    const ig = ignore();
+    const gitignorePath = join(cwd, '.gitignore');
+    // Always ignore common directories
+    ig.add([
+        'node_modules',
+        '.git',
+        'dist',
+        'build',
+        'coverage',
+        '.next',
+        '.nuxt',
+        'out',
+        '.cache',
+    ]);
+    // Load .gitignore if it exists
+    if (existsSync(gitignorePath)) {
+        try {
+            const gitignoreContent = readFileSync(gitignorePath, 'utf-8');
+            ig.add(gitignoreContent);
+        }
+        catch {
+            // Silently fail if we can't read .gitignore
+            // The hardcoded ignores above will still apply
+        }
+    }
+    return ig;
+}
+let fileListCache = null;
+const CACHE_TTL = 5000; // 5 seconds
+/**
+ * Get list of all files in the project (respecting gitignore)
+ */
+async function getAllFiles(cwd) {
+    // Check cache
+    const now = Date.now();
+    if (fileListCache && now - fileListCache.timestamp < CACHE_TTL) {
+        return fileListCache.files;
+    }
+    try {
+        const ig = loadGitignore(cwd);
+        // Use find to list all files, excluding common large directories
+        const { stdout } = await execAsync(`find . -type f -not -path "*/node_modules/*" -not -path "*/.git/*" -not -path "*/dist/*" -not -path "*/build/*" -not -path "*/coverage/*" -not -path "*/.next/*" -not -path "*/.nuxt/*" -not -path "*/out/*" -not -path "*/.cache/*"`, { cwd, maxBuffer: 1024 * 1024 * 10 });
+        const allFiles = stdout
+            .trim()
+            .split('\n')
+            .filter(Boolean)
+            .map(line => line.replace(/^\.\//, '')) // Remove leading "./"
+            .filter(file => !ig.ignores(file)); // Filter by gitignore
+        // Update cache
+        fileListCache = {
+            files: allFiles,
+            timestamp: now,
+        };
+        return allFiles;
+    }
+    catch (error) {
+        // If find fails, return empty array
+        console.error('Failed to list files:', error);
+        return [];
+    }
+}
+/**
+ * Fuzzy match scoring algorithm for file paths
+ * Returns a score from 0 to 1000 (higher = better match)
+ * @deprecated Use fuzzyScoreFilePath from fuzzy-matching.ts instead
+ */
+export function fuzzyScore(filePath, query) {
+    return fuzzyScoreFilePath(filePath, query);
+}
+/**
+ * Extract the current @mention being typed at cursor position
+ * Returns the mention text and its position in the input
+ */
+export function getCurrentFileMention(input, cursorPosition) {
+    const pos = cursorPosition ?? input.length;
+    // Find the last @ before cursor
+    let startIndex = -1;
+    for (let i = pos - 1; i >= 0; i--) {
+        if (input[i] === '@') {
+            startIndex = i;
+            break;
+        }
+        // Stop if we hit whitespace (except for path separators)
+        if (input[i] === ' ' || input[i] === '\t' || input[i] === '\n') {
+            break;
+        }
+    }
+    if (startIndex === -1) {
+        return null;
+    }
+    // Find the end of the mention (next whitespace or end of string)
+    let endIndex = pos;
+    for (let i = pos; i < input.length; i++) {
+        if (input[i] === ' ' ||
+            input[i] === '\t' ||
+            input[i] === '\n' ||
+            input[i] === '@') {
+            break;
+        }
+        endIndex = i + 1;
+    }
+    // Extract mention text (without the @)
+    const fullText = input.substring(startIndex, endIndex);
+    const mention = fullText.substring(1); // Remove @ prefix
+    // Remove line range suffix if present (e.g., ":10-20")
+    const mentionWithoutRange = mention.replace(/:\d+(-\d+)?$/, '');
+    return {
+        mention: mentionWithoutRange,
+        startIndex,
+        endIndex,
+    };
+}
+/**
+ * Get file completions for a partial path
+ */
+export async function getFileCompletions(partialPath, cwd, maxResults = 20) {
+    // Get all files
+    const allFiles = await getAllFiles(cwd);
+    // Score each file
+    const scoredFiles = allFiles
+        .map(file => ({
+        path: file,
+        displayPath: file.length > 50 ? '...' + file.slice(-47) : file,
+        score: fuzzyScoreFilePath(file, partialPath),
+        isDirectory: false, // We're only listing files, not directories
+    }))
+        .filter(f => f.score > 0) // Only include matches
+        .sort((a, b) => {
+        // Sort by score (descending)
+        if (b.score !== a.score) {
+            return b.score - a.score;
+        }
+        // If scores are equal, sort alphabetically
+        return a.path.localeCompare(b.path);
+    })
+        .slice(0, maxResults); // Limit results
+    return scoredFiles;
+}
+/**
+ * Clear the file list cache (useful for testing or when files change)
+ */
+export function clearFileListCache() {
+    fileListCache = null;
+}
+//# sourceMappingURL=file-autocomplete.js.map

package/dist/utils/file-autocomplete.js.map

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

package/dist/utils/file-autocomplete.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=file-autocomplete.spec.d.ts.map

package/dist/utils/file-autocomplete.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-autocomplete.spec.d.ts","sourceRoot":"","sources":["../../source/utils/file-autocomplete.spec.ts"],"names":[],"mappings":""}

package/dist/utils/file-autocomplete.spec.js

@@ -0,0 +1,142 @@
+import test from 'ava';
+import { fuzzyScore, getCurrentFileMention, clearFileListCache, } from './file-autocomplete.js';
+console.log(`\nfile-autocomplete.spec.ts`);
+// Test fuzzyScore()
+test('fuzzy score: exact match gets highest score', t => {
+    const score = fuzzyScore('app.tsx', 'app.tsx');
+    t.is(score, 1000);
+});
+test('fuzzy score: exact filename match', t => {
+    const score = fuzzyScore('src/components/app.tsx', 'app.tsx');
+    t.is(score, 900);
+});
+test('fuzzy score: path ends with query', t => {
+    const score = fuzzyScore('src/components/Button.tsx', 'Button.tsx');
+    // This matches exact filename, so it gets 900 not 850
+    t.is(score, 900);
+});
+test('fuzzy score: filename starts with query', t => {
+    const score = fuzzyScore('src/components/Button.tsx', 'butt');
+    t.is(score, 800);
+});
+test('fuzzy score: path starts with query', t => {
+    const score = fuzzyScore('src/components/Button.tsx', 'src/comp');
+    t.is(score, 750);
+});
+test('fuzzy score: filename contains query', t => {
+    const score = fuzzyScore('src/components/Button.tsx', 'ton');
+    t.is(score, 700);
+});
+test('fuzzy score: path contains query', t => {
+    const score = fuzzyScore('src/components/Button.tsx', 'compo');
+    // "compo" is a substring in path but doesn't start the path
+    t.is(score, 600);
+});
+test('fuzzy score: sequential character match', t => {
+    const score = fuzzyScore('src/components/Button.tsx', 'btn');
+    t.true(score > 0 && score < 600);
+});
+test('fuzzy score: no match returns 0', t => {
+    const score = fuzzyScore('app.tsx', 'xyz');
+    t.is(score, 0);
+});
+test('fuzzy score: empty query returns 0', t => {
+    const score = fuzzyScore('app.tsx', '');
+    t.is(score, 0);
+});
+test('fuzzy score: case insensitive', t => {
+    const score1 = fuzzyScore('App.tsx', 'app');
+    const score2 = fuzzyScore('app.tsx', 'APP');
+    t.true(score1 > 0);
+    t.true(score2 > 0);
+});
+test('fuzzy score: prefers shorter paths', t => {
+    const shortPath = fuzzyScore('app.tsx', 'app');
+    const longPath = fuzzyScore('src/components/nested/app.tsx', 'app');
+    // Both match filename "app.tsx" starting with "app", so they get same score
+    // The scoring doesn't currently prefer shorter paths
+    t.is(shortPath, longPath);
+});
+test('fuzzy score: consecutive matches get bonus', t => {
+    // "but" matches consecutively in "Button"
+    const consecutive = fuzzyScore('Button.tsx', 'but');
+    // "btn" requires skipping characters
+    const nonConsecutive = fuzzyScore('Button.tsx', 'btn');
+    t.true(consecutive > nonConsecutive);
+});
+// Test getCurrentFileMention()
+test('extracts mention at end of string', t => {
+    const result = getCurrentFileMention('Fix @src/app');
+    t.truthy(result);
+    t.is(result.mention, 'src/app');
+    t.is(result.startIndex, 4);
+    t.is(result.endIndex, 12);
+});
+test('extracts mention in middle of string', t => {
+    // Cursor at position 15 is right after "x" in ".tsx"
+    const result = getCurrentFileMention('Check @app.tsx please', 14);
+    t.truthy(result);
+    t.is(result.mention, 'app.tsx');
+    t.is(result.startIndex, 6);
+});
+test('extracts mention with cursor in middle', t => {
+    const result = getCurrentFileMention('Fix @src/ap', 11);
+    t.truthy(result);
+    t.is(result.mention, 'src/ap');
+});
+test('returns null when no @ symbol', t => {
+    const result = getCurrentFileMention('Just regular text');
+    t.is(result, null);
+});
+test('returns null when @ is after cursor', t => {
+    const result = getCurrentFileMention('Text @file.txt', 3);
+    t.is(result, null);
+});
+test('returns null when @ is followed by space', t => {
+    const result = getCurrentFileMention('Fix @ file.txt');
+    t.is(result, null);
+});
+test('strips line range from mention', t => {
+    const result = getCurrentFileMention('Fix @app.tsx:10-20');
+    t.truthy(result);
+    t.is(result.mention, 'app.tsx');
+});
+test('strips single line number from mention', t => {
+    const result = getCurrentFileMention('Fix @app.tsx:10');
+    t.truthy(result);
+    t.is(result.mention, 'app.tsx');
+});
+test('handles multiple @ symbols', t => {
+    const result = getCurrentFileMention('Compare @a.ts and @b.ts', 24);
+    t.truthy(result);
+    t.is(result.mention, 'b.ts');
+});
+test('handles @ at start of string', t => {
+    const result = getCurrentFileMention('@app.tsx');
+    t.truthy(result);
+    t.is(result.mention, 'app.tsx');
+    t.is(result.startIndex, 0);
+});
+test('handles path with slashes', t => {
+    const result = getCurrentFileMention('@src/components/Button.tsx');
+    t.truthy(result);
+    t.is(result.mention, 'src/components/Button.tsx');
+});
+test('stops at whitespace', t => {
+    // When cursor is at end (after "here"), we look back and hit whitespace
+    // So we should use cursor position right after the file mention
+    const result = getCurrentFileMention('@app.tsx here', 8);
+    t.truthy(result);
+    t.is(result.mention, 'app.tsx');
+    t.is(result.endIndex, 8);
+});
+test('stops at next @ symbol', t => {
+    const result = getCurrentFileMention('@app.tsx@other', 8);
+    t.truthy(result);
+    t.is(result.mention, 'app.tsx');
+});
+// Clear cache between tests (if needed)
+test.afterEach(() => {
+    clearFileListCache();
+});
+//# sourceMappingURL=file-autocomplete.spec.js.map

package/dist/utils/file-autocomplete.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-autocomplete.spec.js","sourceRoot":"","sources":["../../source/utils/file-autocomplete.spec.ts"],"names":[],"mappings":"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"}

package/dist/utils/file-content-loader.d.ts

@@ -0,0 +1,31 @@
+interface FileContentResult {
+    success: boolean;
+    content?: string;
+    error?: string;
+    metadata: {
+        path: string;
+        absolutePath: string;
+        size: number;
+        lineCount: number;
+        lineRange?: {
+            start: number;
+            end?: number;
+        };
+        tokens: number;
+    };
+}
+/**
+ * Load file content with optional line range
+ * Silently handles errors - returns success: false instead of throwing
+ */
+export declare function loadFileContent(filePath: string, lineRange?: {
+    start: number;
+    end?: number;
+}): Promise<FileContentResult>;
+/**
+ * Format file content with header for LLM context
+ * Used when assembling the prompt
+ */
+export declare function formatFileForContext(result: FileContentResult): string;
+export {};
+//# sourceMappingURL=file-content-loader.d.ts.map

package/dist/utils/file-content-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-content-loader.d.ts","sourceRoot":"","sources":["../../source/utils/file-content-loader.ts"],"names":[],"mappings":"AAGA,UAAU,iBAAiB;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE;QACT,IAAI,EAAE,MAAM,CAAC;QACb,YAAY,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,MAAM,CAAC;QAClB,SAAS,CAAC,EAAE;YAAC,KAAK,EAAE,MAAM,CAAC;YAAC,GAAG,CAAC,EAAE,MAAM,CAAA;SAAC,CAAC;QAC1C,MAAM,EAAE,MAAM,CAAC;KACf,CAAC;CACF;AAED;;;GAGG;AACH,wBAAsB,eAAe,CACpC,QAAQ,EAAE,MAAM,EAChB,SAAS,CAAC,EAAE;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAC,GACvC,OAAO,CAAC,iBAAiB,CAAC,CA2G5B;AAiBD;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,iBAAiB,GAAG,MAAM,CA0BtE"}

package/dist/utils/file-content-loader.js

@@ -0,0 +1,142 @@
+import { resolve } from 'node:path';
+import { readFile, stat } from 'node:fs/promises';
+/**
+ * Load file content with optional line range
+ * Silently handles errors - returns success: false instead of throwing
+ */
+export async function loadFileContent(filePath, lineRange) {
+    try {
+        const absPath = resolve(filePath);
+        // Check if file exists and get stats
+        const fileStats = await stat(absPath);
+        // Check if it's a file (not directory)
+        if (!fileStats.isFile()) {
+            return {
+                success: false,
+                error: 'Path is not a file',
+                metadata: {
+                    path: filePath,
+                    absolutePath: absPath,
+                    size: 0,
+                    lineCount: 0,
+                    lineRange,
+                    tokens: 0,
+                },
+            };
+        }
+        // Read file content
+        let content;
+        try {
+            content = await readFile(absPath, 'utf-8');
+        }
+        catch {
+            // File might be binary or unreadable
+            return {
+                success: false,
+                error: 'Failed to read file (might be binary)',
+                metadata: {
+                    path: filePath,
+                    absolutePath: absPath,
+                    size: fileStats.size,
+                    lineCount: 0,
+                    lineRange,
+                    tokens: 0,
+                },
+            };
+        }
+        // Split into lines
+        const allLines = content.split('\n');
+        const totalLines = allLines.length;
+        // Extract line range if specified
+        let selectedLines;
+        let actualLineRange;
+        if (lineRange) {
+            const start = Math.max(1, lineRange.start);
+            const end = lineRange.end ? Math.min(totalLines, lineRange.end) : start;
+            // Validate range
+            if (start > totalLines) {
+                // Invalid range, return empty
+                selectedLines = [];
+            }
+            else {
+                // Arrays are 0-indexed, but line numbers are 1-indexed
+                selectedLines = allLines.slice(start - 1, end);
+                actualLineRange = { start, end: lineRange.end ? end : undefined };
+            }
+        }
+        else {
+            // No line range, use all lines
+            selectedLines = allLines;
+        }
+        // Format with line numbers
+        const formattedContent = formatFileContentWithLineNumbers(selectedLines, lineRange?.start || 1);
+        // Calculate metadata
+        const size = content.length;
+        const tokens = Math.ceil(formattedContent.length / 4); // Rough token estimate
+        return {
+            success: true,
+            content: formattedContent,
+            metadata: {
+                path: filePath,
+                absolutePath: absPath,
+                size,
+                lineCount: selectedLines.length,
+                lineRange: actualLineRange,
+                tokens,
+            },
+        };
+    }
+    catch (error) {
+        // File doesn't exist or other error
+        const absPath = resolve(filePath);
+        return {
+            success: false,
+            error: error instanceof Error ? error.message : 'Unknown error',
+            metadata: {
+                path: filePath,
+                absolutePath: absPath,
+                size: 0,
+                lineCount: 0,
+                lineRange,
+                tokens: 0,
+            },
+        };
+    }
+}
+/**
+ * Format file lines with line numbers
+ */
+function formatFileContentWithLineNumbers(lines, startLineNumber) {
+    let result = '';
+    for (let i = 0; i < lines.length; i++) {
+        const lineNum = String(startLineNumber + i).padStart(4, ' ');
+        result += `${lineNum}: ${lines[i]}\n`;
+    }
+    return result.slice(0, -1); // Remove trailing newline
+}
+/**
+ * Format file content with header for LLM context
+ * Used when assembling the prompt
+ */
+export function formatFileForContext(result) {
+    if (!result.success || !result.content) {
+        return `Error loading file: ${result.metadata.path}`;
+    }
+    const { path, lineCount, lineRange, tokens } = result.metadata;
+    let header;
+    if (lineRange) {
+        const rangeStr = lineRange.end
+            ? `${lineRange.start}-${lineRange.end}`
+            : `${lineRange.start}`;
+        header = `=== File: ${path} (Lines ${rangeStr}) ===`;
+    }
+    else {
+        header = `=== File: ${path} ===`;
+    }
+    const footer = '='.repeat(header.length);
+    const stats = lineRange
+        ? `Lines: ${lineRange.start}${lineRange.end ? `-${lineRange.end}` : ''} (${lineCount} lines, ~${tokens} tokens)`
+        : `Lines: ${lineCount}, ~${tokens} tokens`;
+    return `${header}\n${stats}\n\n${result.content}\n${footer}`;
+}
+//# sourceMappingURL=file-content-loader.js.map