@travisennis/acai 0.0.9 → 0.0.11

package/dist/tools/web-search.d.ts

@@ -0,0 +1,44 @@
+import { z } from "zod";
+import type { ToolExecutionOptions } from "./types.ts";
+export declare const WebSearchTool: {
+    name: "WebSearch";
+};
+/**
+ * Input schema for the web search tool
+ */
+declare const inputSchema: z.ZodObject<{
+    query: z.ZodString;
+    numResults: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | null, unknown>, z.ZodNullable<z.ZodCoercedNumber<unknown>>>>;
+    timeout: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | null, unknown>, z.ZodNullable<z.ZodCoercedNumber<unknown>>>>;
+    provider: z.ZodOptional<z.ZodEnum<{
+        exa: "exa";
+        duckduckgo: "duckduckgo";
+    }>>;
+}, z.core.$strip>;
+type WebSearchInputSchema = z.infer<typeof inputSchema>;
+/**
+ * Execute web search
+ */
+export declare function executeWebSearch(options: WebSearchInputSchema, executionOptions: ToolExecutionOptions): Promise<string>;
+/**
+ * Create the web search tool
+ */
+export declare const createWebSearchTool: () => Promise<{
+    toolDef: {
+        description: string;
+        inputSchema: z.ZodObject<{
+            query: z.ZodString;
+            numResults: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | null, unknown>, z.ZodNullable<z.ZodCoercedNumber<unknown>>>>;
+            timeout: z.ZodOptional<z.ZodPipe<z.ZodTransform<string | null, unknown>, z.ZodNullable<z.ZodCoercedNumber<unknown>>>>;
+            provider: z.ZodOptional<z.ZodEnum<{
+                exa: "exa";
+                duckduckgo: "duckduckgo";
+            }>>;
+        }, z.core.$strip>;
+    };
+    display({ query }: WebSearchInputSchema): string;
+    execute(options: WebSearchInputSchema, executionOptions: ToolExecutionOptions): Promise<string>;
+}>;
+export type WebSearchTool = Awaited<ReturnType<typeof createWebSearchTool>>;
+export {};
+//# sourceMappingURL=web-search.d.ts.map

package/dist/tools/web-search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search.d.ts","sourceRoot":"","sources":["../../source/tools/web-search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,eAAO,MAAM,aAAa;;CAEzB,CAAC;AAQF;;GAEG;AACH,QAAA,MAAM,WAAW;;;;;;;;iBAkBf,CAAC;AAEH,KAAK,oBAAoB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AA+MxD;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,oBAAoB,EAC7B,gBAAgB,EAAE,oBAAoB,GACrC,OAAO,CAAC,MAAM,CAAC,CAwEjB;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;uBAQT,oBAAoB;qBAI5B,oBAAoB,oBACX,oBAAoB,GACrC,OAAO,CAAC,MAAM,CAAC;EAIrB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC"}

package/dist/tools/web-search.js

@@ -0,0 +1,226 @@
+import { z } from "zod";
+import style from "../terminal/style.js";
+export const WebSearchTool = {
+    name: "WebSearch",
+};
+// Default search options
+const DEFAULT_NUM_RESULTS = 10;
+const DEFAULT_TIMEOUT = 30000; // 30 seconds
+const EXA_API_BASE = "https://api.exa.ai";
+const EXA_API_VERSION = "2024-05-22";
+/**
+ * Input schema for the web search tool
+ */
+const inputSchema = z.object({
+    query: z.string().describe("The search query to execute"),
+    numResults: z
+        .preprocess((val) => convertNullString(val), z.coerce.number().nullable())
+        .optional()
+        .describe(`Number of search results to return (default: ${DEFAULT_NUM_RESULTS}, max: 100)`),
+    timeout: z
+        .preprocess((val) => convertNullString(val), z.coerce.number().nullable())
+        .optional()
+        .describe(`Timeout in milliseconds for the search request (default: ${DEFAULT_TIMEOUT}ms)`),
+    provider: z
+        .enum(["exa", "duckduckgo"])
+        .optional()
+        .describe("Search provider to use (default: exa with duckduckgo fallback)"),
+});
+/**
+ * Convert null/undefined to string for preprocessing
+ */
+function convertNullString(val) {
+    if (val === null ||
+        val === undefined ||
+        val === "null" ||
+        val === "undefined") {
+        return null;
+    }
+    return String(val);
+}
+/**
+ * Factory function for creating abort handlers.
+ * Defined at module level to avoid capturing closure scope.
+ */
+function createAbortHandler(ctrl, signal) {
+    return () => {
+        ctrl.abort(signal?.reason ?? new Error("Aborted"));
+    };
+}
+/**
+ * Create an AbortSignal that combines a timeout with an optional parent signal
+ */
+function createTimeoutSignal(timeoutMs, parentSignal) {
+    const controller = new AbortController();
+    // Use bind() to avoid capturing scope in timeout callback
+    const abort = controller.abort.bind(controller);
+    const timeoutId = setTimeout(() => abort(new Error(`Request timed out after ${timeoutMs}ms`)), timeoutMs);
+    // Create abort handler using factory to avoid capturing scope
+    const abortHandler = createAbortHandler(controller, parentSignal);
+    if (parentSignal) {
+        if (parentSignal.aborted) {
+            abortHandler();
+        }
+        else {
+            parentSignal.addEventListener("abort", abortHandler, { once: true });
+        }
+    }
+    return {
+        signal: controller.signal,
+        cleanup: () => {
+            clearTimeout(timeoutId);
+            if (parentSignal) {
+                parentSignal.removeEventListener("abort", abortHandler);
+            }
+        },
+    };
+}
+/**
+ * Fetch from Exa API
+ */
+async function fetchExa(query, numResults, signal) {
+    const apiKey = process.env["EXA_API_KEY"];
+    if (!apiKey) {
+        throw new Error("EXA_API_KEY environment variable is not set. Please set it to use Exa API.");
+    }
+    const response = await fetch(`${EXA_API_BASE}/search`, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "x-api-key": apiKey,
+            "exa-version": EXA_API_VERSION,
+        },
+        body: JSON.stringify({
+            query,
+            numResults,
+        }),
+        signal,
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`Exa API error: ${response.status} - ${errorText}`);
+    }
+    const data = await response.json();
+    return {
+        results: data.results.map((result) => ({
+            title: result.title,
+            url: result.url,
+            snippet: result.body,
+            publishedDate: result.publishedDate,
+        })),
+        provider: "exa",
+        query,
+        totalResults: data.results.length,
+    };
+}
+/**
+ * Fetch from DuckDuckGo API (using their instant answer API)
+ */
+async function fetchDuckDuckGo(query, numResults, signal) {
+    const encodedQuery = encodeURIComponent(query);
+    const response = await fetch(`https://api.duckduckgo.com/?q=${encodedQuery}&format=json&no_html=1&skip_disambig=1`, { signal });
+    if (!response.ok) {
+        throw new Error(`DuckDuckGo API error: ${response.status} - ${response.statusText}`);
+    }
+    const data = await response.json();
+    if (!data.RelatedTopics || data.RelatedTopics.length === 0) {
+        return {
+            results: [],
+            provider: "duckduckgo",
+            query,
+        };
+    }
+    const results = data.RelatedTopics.slice(0, numResults)
+        // biome-ignore lint/style/useNamingConvention: DuckDuckGo API response uses PascalCase
+        .filter((topic) => topic.Result)
+        .map((topic) => {
+        // Parse the result format: "<a>Title</a> - Description"
+        const resultHtml = topic.Result || "";
+        const titleMatch = resultHtml.match(/>([^<]+)</);
+        const title = titleMatch ? titleMatch[1] : "No title";
+        return {
+            title,
+            url: topic.FirstURL || "",
+            snippet: topic.Text || "",
+        };
+    });
+    return {
+        results,
+        provider: "duckduckgo",
+        query,
+        totalResults: data.RelatedTopics.length,
+    };
+}
+/**
+ * Execute web search
+ */
+export async function executeWebSearch(options, executionOptions) {
+    const { query, numResults = DEFAULT_NUM_RESULTS, timeout = DEFAULT_TIMEOUT, provider = "exa", } = options;
+    if (executionOptions.abortSignal?.aborted) {
+        throw new Error("Web search aborted");
+    }
+    if (!query || query.trim().length === 0) {
+        throw new Error("Search query cannot be empty");
+    }
+    const effectiveNumResults = Math.min(Math.max(numResults ?? 1, 1), 100);
+    const effectiveTimeout = Math.min(Math.max(timeout ?? 1000, 1000), 60000);
+    const { signal, cleanup } = createTimeoutSignal(effectiveTimeout, executionOptions.abortSignal);
+    try {
+        let response;
+        if (provider === "duckduckgo") {
+            response = await fetchDuckDuckGo(query, effectiveNumResults, signal);
+        }
+        else {
+            // Try Exa first, fall back to DuckDuckGo
+            try {
+                response = await fetchExa(query, effectiveNumResults, signal);
+            }
+            catch (exaError) {
+                // Fall back to DuckDuckGo if Exa fails (but not if aborted)
+                if (signal.aborted) {
+                    throw exaError;
+                }
+                // Provide more helpful error message about Exa failure
+                const errorMsg = exaError instanceof Error ? exaError.message : String(exaError);
+                if (errorMsg.includes("fetch failed") ||
+                    errorMsg.includes("ENOTFOUND") ||
+                    errorMsg.includes("connect")) {
+                    throw new Error(`Exa API is not accessible (network error). Try using provider="duckduckgo" instead.`);
+                }
+                response = await fetchDuckDuckGo(query, effectiveNumResults, signal);
+            }
+        }
+        if (response.results.length === 0) {
+            return `No search results found for "${query}".`;
+        }
+        const resultsText = response.results
+            .map((result, index) => `${index + 1}. [${result.title}](${result.url})\n   ${result.snippet.substring(0, 200)}${result.snippet.length > 200 ? "..." : ""}`)
+            .join("\n\n");
+        return `Search results for "${query}" (${response.provider}):\n\n${resultsText}\n\nTotal results: ${response.totalResults || response.results.length}`;
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        throw new Error(`Web search failed: ${errorMessage}`);
+    }
+    finally {
+        cleanup();
+    }
+}
+/**
+ * Create the web search tool
+ */
+export const createWebSearchTool = async () => {
+    const toolDescription = "Search the web for information.";
+    return {
+        toolDef: {
+            description: toolDescription,
+            inputSchema,
+        },
+        display({ query }) {
+            return `🔍 ${style.cyan(query)}`;
+        },
+        async execute(options, executionOptions) {
+            return executeWebSearch(options, executionOptions);
+        },
+    };
+};

package/dist/tui/autocomplete/attachment-provider.d.ts

@@ -1,6 +1,7 @@
 import type { AutocompleteItem } from "./base-provider.ts";
-import { PathProvider } from "./path-provider.ts";
-export declare class AttachmentProvider extends PathProvider {
+import { FileSearchProvider } from "./file-search-provider.ts";
+export declare class AttachmentProvider extends FileSearchProvider {
+    matchesContext(textBeforeCursor: string): boolean;
     getSuggestions(lines: string[], cursorLine: number, cursorCol: number): Promise<{
         items: AutocompleteItem[];
         prefix: string;
@@ -10,9 +11,5 @@ export declare class AttachmentProvider extends PathProvider {
         cursorLine: number;
         cursorCol: number;
     };
-    getForceFileSuggestions(lines: string[], cursorLine: number, cursorCol: number): Promise<{
-        items: AutocompleteItem[];
-        prefix: string;
-    } | null>;
 }
 //# sourceMappingURL=attachment-provider.d.ts.map

package/dist/tui/autocomplete/attachment-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"attachment-provider.d.ts","sourceRoot":"","sources":["../../../source/tui/autocomplete/attachment-provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,qBAAa,kBAAmB,SAAQ,YAAY;IACnC,cAAc,CAC3B,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAyCvD,eAAe,CACtB,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,MAAM,GACb;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAwB9C,uBAAuB,CACpC,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CA0CjE"}
+{"version":3,"file":"attachment-provider.d.ts","sourceRoot":"","sources":["../../../source/tui/autocomplete/attachment-provider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAE/D,qBAAa,kBAAmB,SAAQ,kBAAkB;IAC/C,cAAc,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO;IAI3C,cAAc,CAC3B,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IA8BvD,eAAe,CACtB,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,MAAM,GACb;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;CAmB9D"}

package/dist/tui/autocomplete/attachment-provider.js

@@ -1,103 +1,50 @@
 import { extname } from "node:path";
-import { PathProvider } from "./path-provider.js";
-export class AttachmentProvider extends PathProvider {
+import { FileSearchProvider } from "./file-search-provider.js";
+export class AttachmentProvider extends FileSearchProvider {
+    matchesContext(textBeforeCursor) {
+        return /(?:^|\s)#[^\s]*$/.test(textBeforeCursor);
+    }
     async getSuggestions(lines, cursorLine, cursorCol) {
         const currentLine = lines[cursorLine] || "";
         const textBeforeCursor = currentLine.slice(0, cursorCol);
-        // Only handle @ file attachments
-        const pathMatch = textBeforeCursor.match(/@([^\s]*)$/);
+        const pathMatch = textBeforeCursor.match(/#([^\s]*)$/);
         if (!pathMatch) {
             return null;
         }
-        let prefix = pathMatch[0]; // Includes the @
-        // Handle @ file attachment prefix
-        if (prefix.startsWith("@")) {
-            prefix = prefix.slice(1); // Remove the @
-        }
-        else {
-            return null;
-        }
-        const suggestions = await this.getFileSuggestions(prefix);
+        const prefix = pathMatch[0];
+        const searchTerm = pathMatch[1];
+        const suggestions = await this.searchFiles(searchTerm);
         if (suggestions.length === 0)
             return null;
-        // For @ prefix, filter to only show directories and attachable files
-        const filteredSuggestions = [];
-        for (const suggestion of suggestions) {
-            if (!suggestion.value.endsWith("/") &&
-                !isAttachableFile(suggestion.value)) {
-                continue;
-            }
-            suggestion.value = `@${suggestion.value}`;
-            filteredSuggestions.push(suggestion);
-        }
+        const filteredSuggestions = suggestions.filter((s) => isAttachableFile(s.value));
         if (filteredSuggestions.length === 0)
             return null;
+        for (const suggestion of filteredSuggestions) {
+            suggestion.value = `#${suggestion.value}`;
+        }
         return {
             items: filteredSuggestions,
-            prefix: pathMatch[0],
+            prefix,
         };
     }
     applyCompletion(lines, cursorLine, cursorCol, item, prefix) {
+        if (!prefix.startsWith("#")) {
+            return { lines, cursorLine, cursorCol };
+        }
         const currentLine = lines[cursorLine] || "";
         const beforePrefix = currentLine.slice(0, cursorCol - prefix.length);
         const afterCursor = currentLine.slice(cursorCol);
-        // Only handle @ file attachment completion if prefix starts with "@"
-        if (prefix.startsWith("@")) {
-            // Handle @ file attachment completion
-            const newLine = `${beforePrefix + item.value} ${afterCursor}`;
-            const newLines = [...lines];
-            newLines[cursorLine] = newLine;
-            return {
-                lines: newLines,
-                cursorLine,
-                cursorCol: beforePrefix.length + item.value.length + 1, // +1 for space
-            };
-        }
-        // If not an @ attachment, let other providers handle it
-        return { lines, cursorLine, cursorCol };
-    }
-    // Force file completion (called on Tab key) - always returns suggestions
-    async getForceFileSuggestions(lines, cursorLine, cursorCol) {
-        const currentLine = lines[cursorLine] || "";
-        const textBeforeCursor = currentLine.slice(0, cursorCol);
-        // Check for @ file attachment syntax first
-        const atMatch = textBeforeCursor.match(/@([^\s]*)$/);
-        const pathMatch = atMatch ? atMatch[0] : null;
-        console.log("pathMatch", textBeforeCursor, pathMatch);
-        if (pathMatch !== null) {
-            let prefix = pathMatch; // Includes the @
-            // Handle @ file attachment prefix
-            if (prefix.startsWith("@")) {
-                prefix = prefix.slice(1); // Remove the @
-            }
-            else {
-                return null;
-            }
-            const suggestions = await this.getFileSuggestions(prefix);
-            if (suggestions.length === 0)
-                return null;
-            // For @ prefix, filter to only show directories and attachable files
-            const filteredSuggestions = [];
-            for (const suggestion of suggestions) {
-                if (!suggestion.value.endsWith("/") &&
-                    !isAttachableFile(suggestion.value)) {
-                    continue;
-                }
-                suggestion.value = `@${suggestion.value}`;
-                filteredSuggestions.push(suggestion);
-            }
-            if (filteredSuggestions.length === 0)
-                return null;
-            return {
-                items: suggestions,
-                prefix: pathMatch,
-            };
-        }
-        return null;
+        const newLine = `${beforePrefix + item.value} ${afterCursor}`;
+        const newLines = [...lines];
+        newLines[cursorLine] = newLine;
+        return {
+            lines: newLines,
+            cursorLine,
+            cursorCol: beforePrefix.length + item.value.length + 1,
+        };
     }
 }
 function isAttachableFile(filePath) {
-    // Check file extension for common text files that might be misidentified
     const textExtensions = [
         ".txt",
         ".md",

package/dist/tui/autocomplete/base-provider.d.ts

@@ -4,6 +4,7 @@ export interface AutocompleteItem {
     description?: string;
 }
 export interface AutocompleteProvider {
+    matchesContext(textBeforeCursor: string): boolean;
     getSuggestions(lines: string[], cursorLine: number, cursorCol: number): Promise<{
         items: AutocompleteItem[];
         prefix: string;

package/dist/tui/autocomplete/base-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-provider.d.ts","sourceRoot":"","sources":["../../../source/tui/autocomplete/base-provider.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IAGnC,cAAc,CACZ,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAIjE,eAAe,CACb,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,MAAM,GACb;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/D"}
+{"version":3,"file":"base-provider.d.ts","sourceRoot":"","sources":["../../../source/tui/autocomplete/base-provider.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,oBAAoB;IAGnC,cAAc,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAAC;IAIlD,cAAc,CACZ,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC,CAAC;IAIjE,eAAe,CACb,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,MAAM,GACb;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/D"}

package/dist/tui/autocomplete/combined-provider.d.ts

@@ -2,6 +2,7 @@ import type { AutocompleteItem, AutocompleteProvider } from "./base-provider.ts"
 export declare class CombinedProvider implements AutocompleteProvider {
     private providers;
     constructor(providers: AutocompleteProvider[]);
+    matchesContext(textBeforeCursor: string): boolean;
     getSuggestions(lines: string[], cursorLine: number, cursorCol: number): Promise<{
         items: AutocompleteItem[];
         prefix: string;
@@ -11,10 +12,6 @@ export declare class CombinedProvider implements AutocompleteProvider {
         cursorLine: number;
         cursorCol: number;
     };
-    getForceFileSuggestions(lines: string[], cursorLine: number, cursorCol: number): Promise<{
-        items: AutocompleteItem[];
-        prefix: string;
-    } | null>;
     shouldTriggerFileCompletion(lines: string[], cursorLine: number, cursorCol: number): boolean;
 }
 //# sourceMappingURL=combined-provider.d.ts.map

package/dist/tui/autocomplete/combined-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"combined-provider.d.ts","sourceRoot":"","sources":["../../../source/tui/autocomplete/combined-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAE5B,qBAAa,gBAAiB,YAAW,oBAAoB;IAC3D,OAAO,CAAC,SAAS,CAAyB;gBAE9B,SAAS,EAAE,oBAAoB,EAAE;IAIvC,cAAc,CAClB,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAehE,eAAe,CACb,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,MAAM,GACb;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAwBvD,uBAAuB,CAC3B,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAwBhE,2BAA2B,CACzB,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO;CAmBX"}
+{"version":3,"file":"combined-provider.d.ts","sourceRoot":"","sources":["../../../source/tui/autocomplete/combined-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAE5B,qBAAa,gBAAiB,YAAW,oBAAoB;IAC3D,OAAO,CAAC,SAAS,CAAyB;gBAE9B,SAAS,EAAE,oBAAoB,EAAE;IAI7C,cAAc,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO;IAI3C,cAAc,CAClB,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAehE,eAAe,CACb,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,MAAM,GACb;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;IAwB7D,2BAA2B,CACzB,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO;CAmBX"}

package/dist/tui/autocomplete/combined-provider.js

@@ -3,6 +3,9 @@ export class CombinedProvider {
     constructor(providers) {
         this.providers = providers;
     }
+    matchesContext(textBeforeCursor) {
+        return this.providers.some((p) => p.matchesContext(textBeforeCursor));
+    }
     async getSuggestions(lines, cursorLine, cursorCol) {
         // Try each provider in order until we get suggestions
         for (const provider of this.providers) {
@@ -27,23 +30,6 @@ export class CombinedProvider {
         // If no provider handled it, return unchanged
         return { lines, cursorLine, cursorCol };
     }
-    // Force file completion (called on Tab key) - always returns suggestions
-    async getForceFileSuggestions(lines, cursorLine, cursorCol) {
-        if (!this.shouldTriggerFileCompletion(lines, cursorLine, cursorCol)) {
-            return null;
-        }
-        // Try each provider that has getForceFileSuggestions method
-        for (const provider of this.providers) {
-            if ("getForceFileSuggestions" in provider &&
-                typeof provider.getForceFileSuggestions === "function") {
-                const result = await provider.getForceFileSuggestions(lines, cursorLine, cursorCol);
-                if (result) {
-                    return result;
-                }
-            }
-        }
-        return null;
-    }
     // Check if we should trigger file completion (called on Tab key)
     shouldTriggerFileCompletion(lines, cursorLine, cursorCol) {
         // Try each provider that has shouldTriggerFileCompletion method

package/dist/tui/autocomplete/command-provider.d.ts

@@ -7,6 +7,7 @@ export interface SlashCommand {
 export declare class CommandProvider<T extends SlashCommand | AutocompleteItem> implements AutocompleteProvider {
     private commands;
     constructor(commands?: T[]);
+    matchesContext(textBeforeCursor: string): boolean;
     getSuggestions(lines: string[], cursorLine: number, cursorCol: number): Promise<{
         items: AutocompleteItem[];
         prefix: string;

package/dist/tui/autocomplete/command-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"command-provider.d.ts","sourceRoot":"","sources":["../../../source/tui/autocomplete/command-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,sBAAsB,CAAC,CAAC,cAAc,EAAE,MAAM,GAAG,gBAAgB,EAAE,GAAG,IAAI,CAAC;CAC5E;AAED,qBAAa,eAAe,CAAC,CAAC,SAAS,YAAY,GAAG,gBAAgB,CACpE,YAAW,oBAAoB;IAE/B,OAAO,CAAC,QAAQ,CAAM;gBAEV,QAAQ,GAAE,CAAC,EAAO;IAIxB,cAAc,CAClB,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IA8DhE,eAAe,CACb,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,MAAM,GACb;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;CAwC9D"}
+{"version":3,"file":"command-provider.d.ts","sourceRoot":"","sources":["../../../source/tui/autocomplete/command-provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IAGrB,sBAAsB,CAAC,CAAC,cAAc,EAAE,MAAM,GAAG,gBAAgB,EAAE,GAAG,IAAI,CAAC;CAC5E;AAED,qBAAa,eAAe,CAAC,CAAC,SAAS,YAAY,GAAG,gBAAgB,CACpE,YAAW,oBAAoB;IAE/B,OAAO,CAAC,QAAQ,CAAM;gBAEV,QAAQ,GAAE,CAAC,EAAO;IAI9B,cAAc,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO;IAI3C,cAAc,CAClB,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IA8DhE,eAAe,CACb,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,MAAM,GACb;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;CAwC9D"}

package/dist/tui/autocomplete/command-provider.js

@@ -3,6 +3,9 @@ export class CommandProvider {
     constructor(commands = []) {
         this.commands = commands;
     }
+    matchesContext(textBeforeCursor) {
+        return textBeforeCursor.trimStart().startsWith("/");
+    }
     async getSuggestions(lines, cursorLine, cursorCol) {
         const currentLine = lines[cursorLine] || "";
         const textBeforeCursor = currentLine.slice(0, cursorCol);

package/dist/tui/autocomplete/file-search-provider.d.ts

@@ -2,6 +2,7 @@ import type { AutocompleteItem, AutocompleteProvider } from "./base-provider.ts"
 export declare class FileSearchProvider implements AutocompleteProvider {
     private maxResults;
     private maxDepth;
+    matchesContext(textBeforeCursor: string): boolean;
     getSuggestions(lines: string[], cursorLine: number, cursorCol: number): Promise<{
         items: AutocompleteItem[];
         prefix: string;
@@ -11,6 +12,6 @@ export declare class FileSearchProvider implements AutocompleteProvider {
         cursorLine: number;
         cursorCol: number;
     };
-    private searchFiles;
+    protected searchFiles(searchTerm: string): Promise<AutocompleteItem[]>;
 }
 //# sourceMappingURL=file-search-provider.d.ts.map

package/dist/tui/autocomplete/file-search-provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-search-provider.d.ts","sourceRoot":"","sources":["../../../source/tui/autocomplete/file-search-provider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AA+B5B,qBAAa,kBAAmB,YAAW,oBAAoB;IAC7D,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,QAAQ,CAAK;IAEf,cAAc,CAClB,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAuBhE,eAAe,CACb,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,MAAM,GACb;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;YAqB/C,WAAW;CA+D1B"}
+{"version":3,"file":"file-search-provider.d.ts","sourceRoot":"","sources":["../../../source/tui/autocomplete/file-search-provider.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,gBAAgB,EAChB,oBAAoB,EACrB,MAAM,oBAAoB,CAAC;AA2C5B,qBAAa,kBAAmB,YAAW,oBAAoB;IAC7D,OAAO,CAAC,UAAU,CAAM;IACxB,OAAO,CAAC,QAAQ,CAAK;IAErB,cAAc,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO;IAI3C,cAAc,CAClB,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,KAAK,EAAE,gBAAgB,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAuBhE,eAAe,CACb,KAAK,EAAE,MAAM,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,gBAAgB,EACtB,MAAM,EAAE,MAAM,GACb;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE;cAqB7C,WAAW,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,gBAAgB,EAAE,CAAC;CAoE7E"}

package/dist/tui/autocomplete/file-search-provider.js

@@ -30,13 +30,27 @@ async function loadGitignorePatterns(cwd) {
         return [];
     }
 }
+function fuzzyScore(filename, searchTerm) {
+    const lower = filename.toLowerCase();
+    if (lower.startsWith(searchTerm))
+        return 0;
+    const nameWithoutExt = lower.replace(/\.[^.]+$/, "");
+    if (nameWithoutExt.startsWith(searchTerm))
+        return 1;
+    if (lower.includes(searchTerm))
+        return 2;
+    return 3;
+}
 export class FileSearchProvider {
     maxResults = 20;
-    maxDepth = 3;
+    maxDepth = 8;
+    matchesContext(textBeforeCursor) {
+        return /(?:^|\s)@[^\s]*$/.test(textBeforeCursor);
+    }
     async getSuggestions(lines, cursorLine, cursorCol) {
         const currentLine = lines[cursorLine] || "";
         const textBeforeCursor = currentLine.slice(0, cursorCol);
-        const pathMatch = textBeforeCursor.match(/#([^\s]*)$/);
+        const pathMatch = textBeforeCursor.match(/(?<!@)@([^\s]*)$/);
         if (!pathMatch) {
             return null;
         }
@@ -52,8 +66,8 @@ export class FileSearchProvider {
         };
     }
     applyCompletion(lines, cursorLine, cursorCol, item, prefix) {
-        // Only handle completions that start with #
-        if (!prefix.startsWith("#")) {
+        // Only handle completions that start with @
+        if (!prefix.startsWith("@")) {
             return { lines, cursorLine, cursorCol };
         }
         const currentLine = lines[cursorLine] || "";
@@ -71,7 +85,6 @@ export class FileSearchProvider {
     async searchFiles(searchTerm) {
         const results = [];
         const cwd = process.cwd();
-        // Build ignore instance with .gitignore patterns + defaults
         const ig = ignore().add(defaultIgnoredPatterns);
         const gitignorePatterns = await loadGitignorePatterns(cwd);
         if (gitignorePatterns.length > 0) {
@@ -97,22 +110,29 @@ export class FileSearchProvider {
                     continue;
                 }
                 const isDirectory = match.endsWith("/");
-                const pathWithoutTrailingSlash = isDirectory
-                    ? match.slice(0, -1)
-                    : match;
-                const label = pathWithoutTrailingSlash.split("/").pop() || pathWithoutTrailingSlash;
-                const parentPath = pathWithoutTrailingSlash
-                    .split("/")
-                    .slice(0, -1)
-                    .join("/");
+                const relativePathWithPrefix = relativePath.startsWith("./")
+                    ? relativePath
+                    : `./${relativePath}`;
+                const relPath = isDirectory
+                    ? `${relativePathWithPrefix}/`
+                    : relativePathWithPrefix;
+                const label = relativePath.split("/").pop() || relativePath;
+                const parentPath = relativePath.split("/").slice(0, -1).join("/");
                 results.push({
-                    value: isDirectory ? `${match} ` : match,
+                    value: isDirectory ? `${relPath} ` : relPath,
                     label,
                     description: parentPath || ".",
                 });
-                if (results.length >= this.maxResults) {
-                    break;
-                }
+            }
+            results.sort((a, b) => {
+                const scoreA = fuzzyScore(a.label, lowerSearchTerm);
+                const scoreB = fuzzyScore(b.label, lowerSearchTerm);
+                if (scoreA !== scoreB)
+                    return scoreA - scoreB;
+                return a.label.localeCompare(b.label);
+            });
+            if (results.length > this.maxResults) {
+                results.length = this.maxResults;
             }
         }
         catch {