@travisennis/acai 0.0.1 → 0.0.2

package/README.md

@@ -41,7 +41,6 @@ Acai is built primarily with **TypeScript** and runs on **Node.js**. Key technol
 *   **Tree-sitter:** For robust and efficient code parsing and syntax analysis across multiple programming languages (TypeScript, JavaScript, Java, Python).
 *   **`chalk`, `ora`, `log-update`:** For rich and interactive terminal output.
 *   **`@inquirer/prompts`:** For interactive prompts; CLI args parsed with Node's `util.parseArgs`.
-*   **`simple-git`:** For Git operations.
 *   **`ripgrep` (via `grep.ts` tool):** For fast file content searching.
 *   **`marked`:** For rendering Markdown in the terminal.
 *   **`pino`:** For structured logging.
@@ -53,7 +52,7 @@ Acai is built primarily with **TypeScript** and runs on **Node.js**. Key technol
 ### Prerequisites
 
 **Required:**
-*   Node.js 18.20.0 or higher
+*   Node.js 20 or higher
 *   Git
 *   [Ripgrep](https://github.com/BurntSushi/ripgrep) (`rg` command) - Fast file content searching
 *   [GitHub CLI](https://cli.github.com/) (`gh` command) - Git operations and repository management
@@ -118,7 +117,7 @@ OPENAI_API_KEY=your_openai_api_key_here
 ANTHROPIC_API_KEY=your_anthropic_api_key_here
 
 # Google (Gemini models)
-GOOGLE_API_KEY=your_google_api_key_here
+GOOGLE_GENERATIVE_AI_API_KEY=your_google_api_key_here
 
 # DeepSeek
 DEEPSEEK_API_KEY=your_deepseek_api_key_here
@@ -159,7 +158,7 @@ OPENAI_API_KEY=sk-...
 ANTHROPIC_API_KEY=sk-ant-...
 
 # Optional: Additional providers
-GOOGLE_API_KEY=...
+GOOGLE_GENERATIVE_AI_API_KEY=...
 OPENROUTER_API_KEY=sk-or-...
 
 # Optional: Web services (fallbacks available if not provided)

package/dist/commands/health-command.d.ts

@@ -0,0 +1,2 @@
+import type { CommandOptions, ReplCommand } from "./types.ts";
+export declare function healthCommand({ terminal }: CommandOptions): ReplCommand;

package/dist/commands/health-command.js

@@ -0,0 +1,59 @@
+export function healthCommand({ terminal }) {
+    return {
+        command: "/health",
+        description: "Show application health status and environment variables",
+        result: "continue",
+        getSubCommands: () => Promise.resolve([]),
+        execute() {
+            // Define the environment variables we care about
+            const envVars = [
+                // AI Provider API Keys
+                { name: "OPENAI_API_KEY", description: "OpenAI (GPT models)" },
+                { name: "ANTHROPIC_API_KEY", description: "Anthropic (Claude models)" },
+                {
+                    name: "GOOGLE_GENERATIVE_AI_API_KEY",
+                    description: "Google (Gemini models)",
+                },
+                { name: "DEEPSEEK_API_KEY", description: "DeepSeek" },
+                { name: "X_AI_API_KEY", description: "X.AI (Grok models)" },
+                { name: "XAI_API_KEY", description: "X.AI (Grok models - alt)" },
+                {
+                    name: "OPENROUTER_API_KEY",
+                    description: "OpenRouter (multiple models)",
+                },
+                // Web Service API Keys
+                { name: "EXA_API_KEY", description: "Exa (enhanced web search)" },
+                {
+                    name: "JINA_READER_API_KEY",
+                    description: "Jina Reader (web content extraction)",
+                },
+                // Application Configuration
+                { name: "LOG_LEVEL", description: "Logging level" },
+            ];
+            // Check each environment variable
+            const envStatus = envVars.map((envVar) => {
+                const value = process.env[envVar.name];
+                const hasValue = value !== undefined && value !== null && value.trim() !== "";
+                const status = hasValue ? "✓ Set" : "✗ Not set";
+                return [envVar.name, status, envVar.description];
+            });
+            // Display the table
+            terminal.info("Environment Variables Status:");
+            terminal.table(envStatus, {
+                header: ["Variable", "Status", "Description"],
+                colWidths: [30, 15, 55],
+            });
+            // Count how many are set (derived from envStatus to avoid re-checking process.env)
+            const setCount = envStatus.filter((row) => row[1] === "✓ Set").length;
+            const totalCount = envVars.length;
+            terminal.info(`\nSummary: ${setCount}/${totalCount} environment variables are set`);
+            if (setCount === 0) {
+                terminal.warn("⚠️  No AI provider API keys are configured. The app may not function properly.");
+            }
+            else {
+                terminal.info("✓ At least one AI provider is configured.");
+            }
+            return Promise.resolve();
+        },
+    };
+}

package/dist/commands/manager.js

@@ -7,6 +7,7 @@ import { editPromptCommand } from "./edit-prompt-command.js";
 import { exitCommand } from "./exit-command.js";
 import { filesCommand } from "./files-command.js";
 import { generateRulesCommand } from "./generate-rules-command.js";
+import { healthCommand } from "./health-command.js";
 import { helpCommand } from "./help-command.js";
 import { initCommand } from "./init-command.js";
 import { lastLogCommand } from "./last-log-command.js";
@@ -59,6 +60,7 @@ export class CommandManager {
             editPromptCommand(options),
             exitCommand(options),
             filesCommand(options),
+            healthCommand(options),
             initCommand(options),
             pasteCommand(options),
             promptCommand(options),

package/dist/commands/paste-command.d.ts

@@ -1,2 +1,2 @@
 import type { CommandOptions, ReplCommand } from "./types.ts";
-export declare const pasteCommand: ({ terminal, modelManager, promptManager, }: CommandOptions) => ReplCommand;
+export declare const pasteCommand: ({ terminal, modelManager, promptManager, tokenCounter, }: CommandOptions) => ReplCommand;

package/dist/commands/paste-command.js

@@ -1,8 +1,104 @@
 import Clipboard from "@crosscopy/clipboard";
 import { formatBlock } from "../formatting.js";
 import { logger } from "../logger.js";
-const base64UrlRegex = /^data:(.*?);base64,/;
-export const pasteCommand = ({ terminal, modelManager, promptManager, }) => {
+function extractBase64Content(dataUrl) {
+    return dataUrl.replace(/^data:.*?;base64,/, "");
+}
+function isValidBase64(str) {
+    try {
+        // Remove data URL prefix if present
+        const base64Content = extractBase64Content(str);
+        // Try to decode the base64 string
+        const decoded = Buffer.from(base64Content, "base64");
+        // Re-encode to verify it's valid base64
+        const reEncoded = decoded.toString("base64");
+        // Remove padding for comparison
+        const normalizedOriginal = base64Content.replace(/=/g, "");
+        const normalizedReEncoded = reEncoded.replace(/=/g, "");
+        return normalizedOriginal === normalizedReEncoded;
+    }
+    catch {
+        return false;
+    }
+}
+function detectImageFormatFromBase64(base64Content) {
+    try {
+        const buffer = Buffer.from(base64Content, "base64");
+        // Check for JPEG signature (FF D8 FF)
+        if (buffer.length >= 3 &&
+            buffer[0] === 0xff &&
+            buffer[1] === 0xd8 &&
+            buffer[2] === 0xff) {
+            return "image/jpeg";
+        }
+        // Check for PNG signature (89 50 4E 47 0D 0A 1A 0A)
+        if (buffer.length >= 8 &&
+            buffer[0] === 0x89 &&
+            buffer[1] === 0x50 &&
+            buffer[2] === 0x4e &&
+            buffer[3] === 0x47 &&
+            buffer[4] === 0x0d &&
+            buffer[5] === 0x0a &&
+            buffer[6] === 0x1a &&
+            buffer[7] === 0x0a) {
+            return "image/png";
+        }
+        // Check for GIF signature (GIF87a or GIF89a)
+        if (buffer.length >= 6 &&
+            ((buffer[0] === 0x47 &&
+                buffer[1] === 0x49 &&
+                buffer[2] === 0x46 &&
+                buffer[3] === 0x38 &&
+                buffer[4] === 0x37 &&
+                buffer[5] === 0x61) ||
+                (buffer[0] === 0x47 &&
+                    buffer[1] === 0x49 &&
+                    buffer[2] === 0x46 &&
+                    buffer[3] === 0x38 &&
+                    buffer[4] === 0x39 &&
+                    buffer[5] === 0x61))) {
+            return "image/gif";
+        }
+        // Check for WebP signature (RIFF .... WEBP)
+        if (buffer.length >= 12 &&
+            buffer[0] === 0x52 &&
+            buffer[1] === 0x49 &&
+            buffer[2] === 0x46 &&
+            buffer[3] === 0x46 &&
+            buffer[8] === 0x57 &&
+            buffer[9] === 0x45 &&
+            buffer[10] === 0x42 &&
+            buffer[11] === 0x50) {
+            return "image/webp";
+        }
+        // Check for BMP signature (BM)
+        if (buffer.length >= 2 && buffer[0] === 0x42 && buffer[1] === 0x4d) {
+            return "image/bmp";
+        }
+        // Check for TIFF signatures (II* or MM*)
+        if (buffer.length >= 4 &&
+            ((buffer[0] === 0x49 &&
+                buffer[1] === 0x49 &&
+                buffer[2] === 0x2a &&
+                buffer[3] === 0x00) ||
+                (buffer[0] === 0x4d &&
+                    buffer[1] === 0x4d &&
+                    buffer[2] === 0x00 &&
+                    buffer[3] === 0x2a))) {
+            return "image/tiff";
+        }
+        // If no known signature found, fall back to the data URL MIME type
+        return "unknown";
+    }
+    catch {
+        return "unknown";
+    }
+}
+function extractMimeTypeFromDataUrl(dataUrl) {
+    const match = dataUrl.match(/^data:([^;]+);base64,/);
+    return match?.[1] ? match[1] : "image/png";
+}
+export const pasteCommand = ({ terminal, modelManager, promptManager, tokenCounter, }) => {
     return {
         command: "/paste",
         description: "Pastes image or text content from the clipboard into the next prompt.",
@@ -12,13 +108,59 @@ export const pasteCommand = ({ terminal, modelManager, promptManager, }) => {
             try {
                 if (Clipboard.hasImage()) {
                     const base64DataUrl = await Clipboard.getImageBase64();
-                    const mimeTypeMatch = base64DataUrl.match(base64UrlRegex);
-                    const mimeType = mimeTypeMatch ? mimeTypeMatch[1] : "image/png";
-                    promptManager.addContext({
-                        type: "image",
-                        image: base64DataUrl,
-                        mediaType: mimeType,
-                    });
+                    // Validate the base64 data
+                    if (!isValidBase64(base64DataUrl)) {
+                        terminal.error("Invalid base64 data in clipboard. The image data may be corrupted.");
+                        return;
+                    }
+                    // Extract MIME type with better error handling and actual image format detection
+                    let mimeType;
+                    try {
+                        // First, try to get MIME type from data URL
+                        const dataUrlMimeType = extractMimeTypeFromDataUrl(base64DataUrl);
+                        // Then, detect actual image format from base64 content
+                        const base64Content = extractBase64Content(base64DataUrl);
+                        const detectedFormat = detectImageFormatFromBase64(base64Content);
+                        // Use detected format if available, otherwise fall back to data URL MIME type
+                        if (detectedFormat !== "unknown") {
+                            mimeType = detectedFormat;
+                            // Log if there's a mismatch between data URL and actual format
+                            if (dataUrlMimeType !== detectedFormat) {
+                                logger.warn(`Clipboard library reported ${dataUrlMimeType} but actual image format is ${detectedFormat}. Using detected format.`);
+                            }
+                        }
+                        else {
+                            mimeType = dataUrlMimeType;
+                            logger.warn(`Could not detect image format, using data URL MIME type: ${mimeType}`);
+                        }
+                    }
+                    catch (error) {
+                        logger.warn(`Failed to extract MIME type from clipboard image: ${error}`);
+                        mimeType = "image/png";
+                    }
+                    // Ensure the data URL format is correct
+                    if (!base64DataUrl.startsWith(`data:${mimeType};base64,`)) {
+                        // Fix malformed data URLs
+                        const base64Content = base64DataUrl.replace(/^data:.*?;base64,/, "");
+                        const correctedDataUrl = `data:${mimeType};base64,${base64Content}`;
+                        // Final validation
+                        if (!isValidBase64(correctedDataUrl)) {
+                            terminal.error("Failed to correct base64 data format. The image data may be corrupted.");
+                            return;
+                        }
+                        promptManager.addContext({
+                            type: "image",
+                            image: correctedDataUrl,
+                            mediaType: mimeType,
+                        });
+                    }
+                    else {
+                        promptManager.addContext({
+                            type: "image",
+                            image: base64DataUrl,
+                            mediaType: mimeType,
+                        });
+                    }
                     terminal.success("Image from clipboard will be added to your next prompt.");
                     return;
                 }
@@ -27,8 +169,10 @@ export const pasteCommand = ({ terminal, modelManager, promptManager, }) => {
                     terminal.warn("Clipboard is empty.");
                     return;
                 }
-                promptManager.addContext(formatBlock(clipboardContent, "clipboard", modelManager.getModelMetadata("repl").promptFormat));
-                terminal.success("Clipboard content will be added to your next prompt.");
+                const content = formatBlock(clipboardContent, "clipboard", modelManager.getModelMetadata("repl").promptFormat);
+                promptManager.addContext(content);
+                const tokenCount = tokenCounter.count(content);
+                terminal.success(`Clipboard content will be added to your next prompt. (${tokenCount} tokens)`);
             }
             catch (error) {
                 const message = error instanceof Error ? error.message : String(error);

package/dist/commands/reset-command.js

@@ -1,6 +1,7 @@
 export const resetCommand = ({ terminal, messageHistory, }) => {
     return {
         command: "/reset",
+        aliases: ["/new"],
         description: "Saves the chat history and then resets it.",
         result: "continue",
         getSubCommands: () => Promise.resolve([]),

package/dist/index.js

@@ -106,7 +106,7 @@ async function main() {
     terminal.setTitle(`acai: ${process.cwd()}`);
     const chosenModel = isSupportedModel(flags.model)
         ? flags.model
-        : "openrouter:sonnet4";
+        : "openrouter:glm-4.5";
     const modelManager = new ModelManager({
         stateDir: await appDir.ensurePath("audit"),
     });

package/dist/models/openrouter-provider.d.ts

@@ -1,6 +1,7 @@
 import type { ModelMetadata } from "./providers.ts";
 declare const openrouterModels: {
     readonly "deepseek-v3": import("@ai-sdk/provider").LanguageModelV2;
+    readonly "deepseek-v3-1": import("@ai-sdk/provider").LanguageModelV2;
     readonly "deepseek-r1": import("@ai-sdk/provider").LanguageModelV2;
     readonly "deepseek-v3-free": import("@ai-sdk/provider").LanguageModelV2;
     readonly "deepseek-r1-free": import("@ai-sdk/provider").LanguageModelV2;
@@ -18,12 +19,14 @@ declare const openrouterModels: {
     readonly "glm-4.5": import("@ai-sdk/provider").LanguageModelV2;
     readonly "gpt-5": import("@ai-sdk/provider").LanguageModelV2;
     readonly "gpt-5-mini": import("@ai-sdk/provider").LanguageModelV2;
+    readonly "gpt-oss-120b": import("@ai-sdk/provider").LanguageModelV2;
+    readonly "grok-code-fast-1": import("@ai-sdk/provider").LanguageModelV2;
 };
 type ModelName = `openrouter:${keyof typeof openrouterModels}`;
 export declare const openrouterModelNames: ModelName[];
 export declare const openrouterProvider: {
     openrouter: import("@ai-sdk/provider").ProviderV2 & {
-        languageModel(modelId: "gpt-5" | "gpt-5-mini" | "gpt-4.1" | "deepseek-v3" | "deepseek-r1" | "deepseek-v3-free" | "deepseek-r1-free" | "gemini-flash25" | "gemini-pro25" | "sonnet4" | "opus4" | "opus-4.1" | "kimi-k2" | "kimi-k2-free" | "devstral-medium" | "qwen3-coder" | "qwen3-coder-free" | "glm-4.5"): import("@ai-sdk/provider").LanguageModelV2;
+        languageModel(modelId: "gpt-5" | "gpt-5-mini" | "gpt-4.1" | "deepseek-v3" | "deepseek-v3-1" | "deepseek-r1" | "deepseek-v3-free" | "deepseek-r1-free" | "gemini-flash25" | "gemini-pro25" | "sonnet4" | "opus4" | "opus-4.1" | "kimi-k2" | "kimi-k2-free" | "devstral-medium" | "qwen3-coder" | "qwen3-coder-free" | "glm-4.5" | "gpt-oss-120b" | "grok-code-fast-1"): import("@ai-sdk/provider").LanguageModelV2;
         textEmbeddingModel(modelId: string): import("@ai-sdk/provider").EmbeddingModelV2<string>;
         imageModel(modelId: string): import("@ai-sdk/provider").ImageModelV2;
         transcriptionModel(modelId: string): import("@ai-sdk/provider").TranscriptionModelV2;

package/dist/models/openrouter-provider.js

@@ -13,6 +13,7 @@ const openRouterClient = createOpenAICompatible({
 });
 const openrouterModels = {
     "deepseek-v3": openRouterClient("deepseek/deepseek-chat-v3-0324"),
+    "deepseek-v3-1": openRouterClient("deepseek/deepseek-chat-v3.1"),
     "deepseek-r1": openRouterClient("deepseek/deepseek-r1-0528"),
     "deepseek-v3-free": openRouterClient("deepseek/deepseek-chat-v3-0324:free"),
     "deepseek-r1-free": openRouterClient("deepseek/deepseek-r1-0528:free"),
@@ -30,6 +31,8 @@ const openrouterModels = {
     "glm-4.5": openRouterClient("z-ai/glm-4.5"),
     "gpt-5": openRouterClient("openai/gpt-5"),
     "gpt-5-mini": openRouterClient("openai/gpt-5-mini"),
+    "gpt-oss-120b": openRouterClient("openai/gpt-oss-120b"),
+    "grok-code-fast-1": openRouterClient("x-ai/grok-code-fast-1"),
 };
 export const openrouterModelNames = objectKeys(openrouterModels).map((key) => `openrouter:${key}`);
 export const openrouterProvider = {
@@ -78,6 +81,19 @@ export const openrouterModelRegistry = {
         costPerOutputToken: 0, // Assuming free tier or unknown cost
         category: "balanced",
     },
+    "openrouter:deepseek-v3-1": {
+        id: "openrouter:deepseek-v3-1",
+        provider: "openrouter",
+        contextWindow: 163840,
+        maxOutputTokens: 8000,
+        defaultTemperature: 0.3,
+        promptFormat: "bracket",
+        supportsReasoning: true,
+        supportsToolCalling: true,
+        costPerInputToken: 0.0000002,
+        costPerOutputToken: 0.0000008,
+        category: "balanced",
+    },
     "openrouter:deepseek-r1-free": {
         id: "openrouter:deepseek-r1-free",
         provider: "openrouter",
@@ -252,8 +268,8 @@ export const openrouterModelRegistry = {
         provider: "openrouter",
         contextWindow: 400000,
         maxOutputTokens: 128000,
-        defaultTemperature: 0.3,
-        promptFormat: "markdown",
+        defaultTemperature: 1.0,
+        promptFormat: "xml",
         supportsReasoning: true,
         supportsToolCalling: true,
         costPerInputToken: 0.00000125,
@@ -265,12 +281,38 @@ export const openrouterModelRegistry = {
         provider: "openrouter",
         contextWindow: 200000,
         maxOutputTokens: 64000,
-        defaultTemperature: 0.3,
-        promptFormat: "markdown",
+        defaultTemperature: 1.0,
+        promptFormat: "xml",
         supportsReasoning: true,
         supportsToolCalling: true,
         costPerInputToken: 0.00000015,
         costPerOutputToken: 0.0000006,
         category: "balanced",
     },
+    "openrouter:grok-code-fast-1": {
+        id: "openrouter:grok-code-fast-1",
+        provider: "openrouter",
+        contextWindow: 256000,
+        maxOutputTokens: 10000,
+        defaultTemperature: 0.5,
+        promptFormat: "markdown",
+        supportsReasoning: true,
+        supportsToolCalling: true,
+        costPerInputToken: 0.0000002,
+        costPerOutputToken: 0.0000015,
+        category: "fast",
+    },
+    "openrouter:gpt-oss-120b": {
+        id: "openrouter:gpt-oss-120b",
+        provider: "openrouter",
+        contextWindow: 131072,
+        maxOutputTokens: 64000,
+        defaultTemperature: 1.0,
+        promptFormat: "xml",
+        supportsReasoning: true,
+        supportsToolCalling: true,
+        costPerInputToken: 0.00000007256312,
+        costPerOutputToken: 0.0000002903936,
+        category: "fast",
+    },
 };

package/dist/models/providers.d.ts

@@ -1,7 +1,7 @@
 import { z } from "zod";
 export declare const providers: readonly ["anthropic", "openai", "google", "deepseek", "openrouter", "xai"];
 export type ModelProvider = (typeof providers)[number];
-export declare const models: readonly ("anthropic:opus" | "anthropic:sonnet" | "anthropic:sonnet37" | "anthropic:sonnet37-token-efficient-tools" | "anthropic:sonnet37-128k" | "anthropic:sonnet35" | "anthropic:haiku" | "deepseek:deepseek-chat" | "deepseek:deepseek-reasoner" | "google:flash25lite" | "google:pro25" | "google:flash25" | "openai:o3" | "openai:gpt-4.1" | "openai:o4-mini" | "openai:codex-mini" | "openrouter:gpt-5" | "openrouter:gpt-5-mini" | "openrouter:gpt-4.1" | "openrouter:deepseek-v3" | "openrouter:deepseek-r1" | "openrouter:deepseek-v3-free" | "openrouter:deepseek-r1-free" | "openrouter:gemini-flash25" | "openrouter:gemini-pro25" | "openrouter:sonnet4" | "openrouter:opus4" | "openrouter:opus-4.1" | "openrouter:kimi-k2" | "openrouter:kimi-k2-free" | "openrouter:devstral-medium" | "openrouter:qwen3-coder" | "openrouter:qwen3-coder-free" | "openrouter:glm-4.5" | "xai:grok3" | "xai:grok3-mini")[];
+export declare const models: readonly ("anthropic:opus" | "anthropic:sonnet" | "anthropic:sonnet37" | "anthropic:sonnet37-token-efficient-tools" | "anthropic:sonnet37-128k" | "anthropic:sonnet35" | "anthropic:haiku" | "deepseek:deepseek-chat" | "deepseek:deepseek-reasoner" | "google:flash25lite" | "google:pro25" | "google:flash25" | "openai:o3" | "openai:gpt-4.1" | "openai:o4-mini" | "openai:codex-mini" | "openrouter:gpt-5" | "openrouter:gpt-5-mini" | "openrouter:gpt-4.1" | "openrouter:deepseek-v3" | "openrouter:deepseek-v3-1" | "openrouter:deepseek-r1" | "openrouter:deepseek-v3-free" | "openrouter:deepseek-r1-free" | "openrouter:gemini-flash25" | "openrouter:gemini-pro25" | "openrouter:sonnet4" | "openrouter:opus4" | "openrouter:opus-4.1" | "openrouter:kimi-k2" | "openrouter:kimi-k2-free" | "openrouter:devstral-medium" | "openrouter:qwen3-coder" | "openrouter:qwen3-coder-free" | "openrouter:glm-4.5" | "openrouter:gpt-oss-120b" | "openrouter:grok-code-fast-1" | "xai:grok3" | "xai:grok3-mini")[];
 export type ModelName = (typeof models)[number] | (`xai:${string}` & {}) | (`openai:${string}` & {}) | (`anthropic:${string}` & {}) | (`google:${string}` & {}) | (`deepseek:${string}` & {}) | (`openrouter:${string}` & {});
 export declare function isSupportedModel(model: unknown): model is ModelName;
 export declare function languageModel(model: ModelName): import("@ai-sdk/provider").LanguageModelV2;

package/dist/prompts/manager.d.ts

@@ -16,4 +16,5 @@ export declare class PromptManager {
     hasContext(): boolean;
     clearContext(): void;
     clearAll(): void;
+    getContextTokenCount(): number;
 }

package/dist/prompts/manager.js

@@ -68,4 +68,14 @@ export class PromptManager {
         this.clearContext();
         this.prompt = undefined;
     }
+    getContextTokenCount() {
+        let totalTokens = 0;
+        for (const item of this.context) {
+            if (typeof item === "string") {
+                totalTokens += this.tokenCounter.count(item);
+            }
+            // Skip ImagePart items as they don't contain countable text
+        }
+        return totalTokens;
+    }
 }

package/dist/prompts.js

@@ -6,11 +6,13 @@ import { dedent } from "./dedent.js";
 import { AgentTool } from "./tools/agent.js";
 import { BashTool } from "./tools/bash.js";
 import { CodeInterpreterTool } from "./tools/code-interpreter.js";
+import { DeleteFileTool } from "./tools/delete-file.js";
 import { DirectoryTreeTool } from "./tools/directory-tree.js";
 import { EditFileTool } from "./tools/edit-file.js";
 import { getCurrentBranch, inGitDirectory } from "./tools/git-utils.js";
 import { GrepTool } from "./tools/grep.js";
 import { ReadFileTool } from "./tools/read-file.js";
+import { ReadMultipleFilesTool } from "./tools/read-multiple-files.js";
 import { SaveFileTool } from "./tools/save-file.js";
 import { ThinkTool } from "./tools/think.js";
 import { WebFetchTool } from "./tools/web-fetch.js";
@@ -65,17 +67,18 @@ function toolUsage() {
 
 ### Information Gathering
 - Use \`${DirectoryTreeTool.name}\` for project structure
-- Use \`${ReadFileTool.name}\` for file contents if filenames are provided in the prompt
+- Use \`${ReadFileTool.name}\` or \`${ReadMultipleFilesTool.name}\` for file contents if filenames are provided in the prompt
 - Use \`${GrepTool.name}\` for code pattern searches
 - Use \`${WebFetchTool.name}\` for text-based URLs provided in the prompt
 - Use \`${WebSearchTool.name}\` for external research (e.g., libraries, errors)
-- Use \`${AgentTool.name}\` for iterative keyword/file searches
+- Use \`${AgentTool.name}\` for iterative keyword/file searches. Use this if you need to explore the project fo find what you are looking for.
 - If file contents or URLs are provided in the prompt, use them directly without re-fetching
 - Always verify file contents before suggesting changes unless provided in the prompt
 
 ### Code Modification
-- Use \`${EditFileTool.name}\` for existing file edits (requires user approval)
-- Use \`${SaveFileTool.name}\` for new files only
+- Use \`${EditFileTool.name}\` to edit existing files
+- Use \`${SaveFileTool.name}\` to create new files only
+- Use \`${DeleteFileTool.name}\` to delete files
 
 ### Planning & Complex Tasks
 - Use \`${ThinkTool.name}\` for structured reasoning on complex problems
@@ -85,8 +88,7 @@ function toolUsage() {
 - Execute bash commands within project directory only
 - Always specify absolute paths to avoid errors
 - You have access to the Github CLI
-- **Background Processes:** Use background processes (via \`&\`) for commands that are unlikely to stop on their own, e.g. \`node server.js &\`. If unsure, ask the user.
-- **Interactive Commands:** Try to avoid shell commands that are likely to require user interaction (e.g. \`git rebase -i\`). Use non-interactive versions of commands (e.g. \`npm init -y\` instead of \`npm init\`) when available, and otherwise remind the user that interactive shell commands are not supported and may cause hangs until canceled by the user.
+- Try to avoid shell commands that are likely to require user interaction (e.g. \`git rebase -i\`). Use non-interactive versions of commands (e.g. \`npm init -y\` instead of \`npm init\`) when available, and otherwise remind the user that interactive shell commands are not supported and may cause hangs until canceled by the user.
 
 ### Code Interpreter (\`${CodeInterpreterTool.name}\`)
 - Executes JavaScript code in a separate Node.js process using Node's Permission Model