wave-agent-sdk 0.0.7 → 0.0.10

package/dist/tools/readTool.js

@@ -1,6 +1,112 @@
-import { readFile } from "fs/promises";
+import { readFile, stat } from "fs/promises";
+import { extname } from "path";
+import { logger } from "../utils/globalLogger.js";
 import { resolvePath, getDisplayPath } from "../utils/path.js";
 import { isBinaryDocument, getBinaryDocumentError, } from "../utils/fileFormat.js";
+import { convertImageToBase64 } from "../utils/messageOperations.js";
+/**
+ * Supported image file extensions
+ */
+const SUPPORTED_IMAGE_EXTENSIONS = [
+    "png",
+    "jpeg",
+    "jpg",
+    "gif",
+    "webp",
+];
+/**
+ * Check if a file path represents an image file
+ * @param filePath - Path to the file
+ * @returns true if the file is a supported image format
+ */
+function isImageFile(filePath) {
+    const ext = extname(filePath).toLowerCase().substring(1);
+    return SUPPORTED_IMAGE_EXTENSIONS.includes(ext);
+}
+/**
+ * Validate image file size
+ * @param filePath - Path to the image file
+ * @param maxSizeBytes - Maximum allowed file size in bytes (default: 20MB)
+ * @returns Promise<boolean> - true if file size is within limit
+ */
+async function validateImageFileSize(filePath, maxSizeBytes = 20 * 1024 * 1024) {
+    try {
+        const stats = await stat(filePath);
+        return stats.size <= maxSizeBytes;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Get MIME type for image file based on extension
+ * @param filePath - Path to the image file
+ * @returns MIME type string
+ */
+function getImageMimeType(filePath) {
+    const ext = extname(filePath).toLowerCase().substring(1);
+    switch (ext) {
+        case "png":
+            return "image/png";
+        case "jpg":
+        case "jpeg":
+            return "image/jpeg";
+        case "gif":
+            return "image/gif";
+        case "webp":
+            return "image/webp";
+        default:
+            return "image/png"; // Default fallback
+    }
+}
+/**
+ * Process an image file and return ToolResult with image data
+ * @param filePath - Path to the image file
+ * @param context - Tool execution context
+ * @returns Promise<ToolResult> with image data
+ */
+async function processImageFile(filePath, context) {
+    try {
+        // Resolve path
+        const actualFilePath = filePath.startsWith("/")
+            ? filePath
+            : resolvePath(filePath, context.workdir);
+        // Validate file size
+        const isValidSize = await validateImageFileSize(actualFilePath);
+        if (!isValidSize) {
+            const stats = await stat(actualFilePath);
+            const sizeMB = (stats.size / (1024 * 1024)).toFixed(2);
+            return {
+                success: false,
+                content: "",
+                error: `Image file exceeds 20MB limit (actual: ${sizeMB}MB)`,
+            };
+        }
+        // Convert image to base64
+        const imageDataUrl = convertImageToBase64(actualFilePath);
+        const mimeType = getImageMimeType(actualFilePath);
+        // Extract base64 data from data URL (remove data:image/type;base64, prefix)
+        const base64Data = imageDataUrl.split(",")[1] || "";
+        return {
+            success: true,
+            content: `Image file processed: ${getDisplayPath(filePath, context.workdir)}\nFormat: ${mimeType}\nSize: Available for AI processing`,
+            shortResult: `Image processed (${mimeType})`,
+            images: [
+                {
+                    data: base64Data,
+                    mediaType: mimeType,
+                },
+            ],
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            content: "",
+            error: `Failed to process image: ${error instanceof Error ? error.message : String(error)}`,
+        };
+    }
+}
 /**
  * Read Tool Plugin - Read file content
  */
@@ -10,7 +116,7 @@ export const readTool = {
         type: "function",
         function: {
             name: "Read",
-            description: "Reads a file from the local filesystem. You can access any file directly by using this tool.\nAssume this tool is able to read all files on the machine. If the User provides a path to a file assume that path is valid. It is okay to read a file that does not exist; an error will be returned.\n\nUsage:\n- The file_path parameter must be an absolute path, not a relative path\n- By default, it reads up to 2000 lines starting from the beginning of the file\n- You can optionally specify a line offset and limit (especially handy for long files), but it's recommended to read the whole file by not providing these parameters\n- Any lines longer than 2000 characters will be truncated\n- Results are returned using cat -n format, with line numbers starting at 1\n- This tool allows Claude Code to read images (eg PNG, JPG, etc). When reading an image file the contents are presented visually as Claude Code is a multimodal LLM.\n- This tool can read Jupyter notebooks (.ipynb files) and returns all cells with their outputs, combining code, text, and visualizations.\n- You have the capability to call multiple tools in a single response. It is always better to speculatively read multiple files as a batch that are potentially useful.\n- You will regularly be asked to read screenshots. If the user provides a path to a screenshot ALWAYS use this tool to view the file at the path. This tool will work with all temporary file paths like /var/folders/123/abc/T/TemporaryItems/NSIRD_screencaptureui_ZfB1tD/Screenshot.png\n- If you read a file that exists but has empty contents you will receive a system reminder warning in place of file contents.\n- Binary document formats (PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX) are not supported and will return an error.",
+            description: "Reads a file from the local filesystem. You can access any file directly by using this tool.\nAssume this tool is able to read all files on the machine. If the User provides a path to a file assume that path is valid. It is okay to read a file that does not exist; an error will be returned.\n\nUsage:\n- The file_path parameter must be an absolute path, not a relative path\n- By default, it reads up to 2000 lines starting from the beginning of the file\n- You can optionally specify a line offset and limit (especially handy for long files), but it's recommended to read the whole file by not providing these parameters\n- Any lines longer than 2000 characters will be truncated\n- Results are returned using cat -n format, with line numbers starting at 1\n- This tool allows Agent to read images (eg PNG, JPG, etc). When reading an image file the contents are presented visually as Agent is a multimodal LLM.\n- This tool can read Jupyter notebooks (.ipynb files) and returns all cells with their outputs, combining code, text, and visualizations.\n- You have the capability to call multiple tools in a single response. It is always better to speculatively read multiple files as a batch that are potentially useful.\n- You will regularly be asked to read screenshots. If the user provides a path to a screenshot ALWAYS use this tool to view the file at the path. This tool will work with all temporary file paths like /var/folders/123/abc/T/TemporaryItems/NSIRD_screencaptureui_ZfB1tD/Screenshot.png\n- If you read a file that exists but has empty contents you will receive a system reminder warning in place of file contents.\n- Binary document formats (PDF, DOC, DOCX, XLS, XLSX, PPT, PPTX) are not supported and will return an error.",
             parameters: {
                 type: "object",
                 properties: {
@@ -50,6 +156,10 @@ export const readTool = {
                 error: getBinaryDocumentError(filePath),
             };
         }
+        // Check if this is an image file
+        if (isImageFile(filePath)) {
+            return processImageFile(filePath, context);
+        }
         try {
             // Note: New Read tool requires absolute paths, so we don't use resolvePath
             // But for compatibility, if it's not an absolute path, we still try to resolve
@@ -59,7 +169,7 @@ export const readTool = {
             const fileContent = await readFile(actualFilePath, "utf-8");
             // Check if file is empty
             if (fileContent.length === 0) {
-                // logger.warn(`File ${filePath} exists but has empty contents`);
+                logger.warn(`File ${filePath} exists but has empty contents`);
                 return {
                     success: true,
                     content: "⚠️ System reminder: This file exists but has empty contents.",

package/dist/tools/skillTool.js

@@ -14,11 +14,11 @@ export function createSkillTool(skillManager) {
         return `Invoke a Wave skill by name. Skills are user-defined automation templates that can be personal or project-specific.\n\nAvailable skills:\n${skillList}`;
     };
     return {
-        name: "skill",
+        name: "Skill",
         config: {
             type: "function",
             function: {
-                name: "skill",
+                name: "Skill",
                 description: getToolDescription(),
                 parameters: {
                     type: "object",

package/dist/tools/todoWriteTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"todoWriteTool.d.ts","sourceRoot":"","sources":["../../src/tools/todoWriteTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAc,MAAM,YAAY,CAAC;AAQzD;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,UAoN3B,CAAC"}
+{"version":3,"file":"todoWriteTool.d.ts","sourceRoot":"","sources":["../../src/tools/todoWriteTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AAQtE;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,UAoP3B,CAAC"}

package/dist/tools/todoWriteTool.js

@@ -92,6 +92,29 @@ When in doubt, use this tool. Being proactive with task management demonstrates
             },
         },
     },
+    formatCompactParams: (params, context) => {
+        void context; // Context not needed for this tool
+        try {
+            const { todos } = params;
+            // Handle invalid or missing tasks array
+            if (!todos || !Array.isArray(todos)) {
+                return "invalid todos";
+            }
+            // Handle empty task list
+            if (todos.length === 0) {
+                return "0 tasks";
+            }
+            // Count completed tasks
+            const completedCount = todos.filter((todo) => todo && todo.status === "completed").length;
+            const totalCount = todos.length;
+            // Format with proper singular/plural
+            const taskWord = totalCount === 1 ? "task" : "tasks";
+            return `${completedCount}/${totalCount} ${taskWord}`;
+        }
+        catch {
+            return "invalid todos";
+        }
+    },
     execute: async (args) => {
         try {
             // Validate arguments

package/dist/tools/types.d.ts

@@ -2,6 +2,7 @@
  * Tool plugin interface definitions
  */
 import { ChatCompletionFunctionTool } from "openai/resources.js";
+import type { PermissionMode, PermissionCallback } from "../types/permissions.js";
 export interface ToolPlugin {
     name: string;
     config: ChatCompletionFunctionTool;
@@ -13,14 +14,6 @@ export interface ToolResult {
     content: string;
     error?: string;
     shortResult?: string;
-    originalContent?: string;
-    newContent?: string;
-    diffResult?: Array<{
-        count?: number;
-        value: string;
-        added?: boolean;
-        removed?: boolean;
-    }>;
     filePath?: string;
     images?: Array<{
         data: string;
@@ -31,5 +24,15 @@ export interface ToolContext {
     abortSignal?: AbortSignal;
     backgroundBashManager?: import("../managers/backgroundBashManager.js").BackgroundBashManager;
     workdir: string;
+    /** Permission mode for this tool execution */
+    permissionMode?: PermissionMode;
+    /** Custom permission callback */
+    canUseToolCallback?: PermissionCallback;
+    /** Permission manager instance for permission checks */
+    permissionManager?: import("../managers/permissionManager.js").PermissionManager;
+    /** MCP manager instance for calling MCP tools */
+    mcpManager?: import("../managers/mcpManager.js").McpManager;
+    /** LSP manager instance for code intelligence */
+    lspManager?: import("../types/lsp.js").ILspManager;
 }
 //# sourceMappingURL=types.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAEjE,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,0BAA0B,CAAC;IACnC,OAAO,EAAE,CACP,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,WAAW,KACjB,OAAO,CAAC,UAAU,CAAC,CAAC;IACzB,mBAAmB,CAAC,EAAE,CACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,WAAW,KACjB,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,KAAK,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,OAAO,CAAC;QAChB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,CAAC,CAAC;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,MAAM,CAAC,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,qBAAqB,CAAC,EAAE,OAAO,sCAAsC,EAAE,qBAAqB,CAAC;IAC7F,OAAO,EAAE,MAAM,CAAC;CACjB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/tools/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EACV,cAAc,EACd,kBAAkB,EACnB,MAAM,yBAAyB,CAAC;AAEjC,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,0BAA0B,CAAC;IACnC,OAAO,EAAE,CACP,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,EAAE,WAAW,KACjB,OAAO,CAAC,UAAU,CAAC,CAAC;IACzB,mBAAmB,CAAC,EAAE,CACpB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,OAAO,EAAE,WAAW,KACjB,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB,MAAM,CAAC,EAAE,KAAK,CAAC;QACb,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,WAAW;IAC1B,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,qBAAqB,CAAC,EAAE,OAAO,sCAAsC,EAAE,qBAAqB,CAAC;IAC7F,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,iCAAiC;IACjC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACxC,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,OAAO,kCAAkC,EAAE,iBAAiB,CAAC;IACjF,iDAAiD;IACjD,UAAU,CAAC,EAAE,OAAO,2BAA2B,EAAE,UAAU,CAAC;IAC5D,iDAAiD;IACjD,UAAU,CAAC,EAAE,OAAO,iBAAiB,EAAE,WAAW,CAAC;CACpD"}

package/dist/tools/writeTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writeTool.d.ts","sourceRoot":"","sources":["../../src/tools/writeTool.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AAItE;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,UAyJvB,CAAC"}
+{"version":3,"file":"writeTool.d.ts","sourceRoot":"","sources":["../../src/tools/writeTool.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AAGtE;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,UAoLvB,CAAC"}

package/dist/tools/writeTool.js

@@ -1,7 +1,7 @@
 import { readFile, writeFile, mkdir } from "fs/promises";
 import { dirname } from "path";
+import { logger } from "../utils/globalLogger.js";
 import { resolvePath, getDisplayPath } from "../utils/path.js";
-import { diffLines } from "diff";
 /**
  * File Write Tool Plugin
  */
@@ -11,7 +11,7 @@ export const writeTool = {
         type: "function",
         function: {
             name: "Write",
-            description: "Writes a file to the local filesystem.\n\nUsage:\n- This tool will overwrite the existing file if there is one at the provided path.\n- If this is an existing file, you MUST use the Read tool first to read the file's contents. This tool will fail if you did not read the file first.\n- ALWAYS prefer editing existing files in the codebase. NEVER write new files unless explicitly required.\n- NEVER proactively create documentation files (*.md) or README files. Only create documentation files if explicitly requested by the User.\n- Only use emojis if the user explicitly requests it. Avoid writing emojis to files unless asked.",
+            description: "Writes a file to the local filesystem.\n\nUsage:\n- This tool will overwrite the existing file if there is one at the provided path.\n- If this is an existing file, you MUST use the Read tool first to read the file's contents. This tool will fail if you did not read the file first.\n- ALWAYS prefer editing existing files in the codebase. NEVER write new files unless explicitly required.\n- NEVER proactively create documentation files (*.md) or README files. Only create documentation files if explicitly requested by the User.\n- Only use emojis if the user explicitly requests it. Avoid writing emojis to files unless asked.\n- IMPORTANT: Always provide file_path parameter before content parameter when calling this tool.",
             parameters: {
                 type: "object",
                 properties: {
@@ -67,9 +67,6 @@ export const writeTool = {
                     content: `File ${filePath} already has the same content, no changes needed`,
                     shortResult: "No changes needed",
                     filePath: resolvedPath,
-                    originalContent,
-                    newContent: content,
-                    diffResult: [],
                 };
             }
             // Ensure directory exists
@@ -81,9 +78,32 @@ export const writeTool = {
                 // Ignore directory already exists error
                 if (mkdirError instanceof Error &&
                     !mkdirError.message.includes("EEXIST")) {
-                    // logger.warn(
-                    //   `Failed to create directory ${fileDir}: ${mkdirError.message}`,
-                    // );
+                    logger.warn(`Failed to create directory ${fileDir}: ${mkdirError.message}`);
+                }
+            }
+            // Permission check after validation but before real operation
+            if (context.permissionManager &&
+                context.permissionMode &&
+                context.permissionMode !== "bypassPermissions") {
+                if (context.permissionManager.isRestrictedTool("Write")) {
+                    try {
+                        const permissionContext = context.permissionManager.createContext("Write", context.permissionMode, context.canUseToolCallback, { file_path: filePath, content });
+                        const permissionResult = await context.permissionManager.checkPermission(permissionContext);
+                        if (permissionResult.behavior === "deny") {
+                            return {
+                                success: false,
+                                content: "",
+                                error: `Write operation denied by user, reason: ${permissionResult.message || "No reason provided"}`,
+                            };
+                        }
+                    }
+                    catch {
+                        return {
+                            success: false,
+                            content: "",
+                            error: "Permission check failed",
+                        };
+                    }
                 }
             }
             // Write file
@@ -97,26 +117,21 @@ export const writeTool = {
                     error: `Failed to write file: ${writeError instanceof Error ? writeError.message : String(writeError)}`,
                 };
             }
-            // Generate diff information
-            const diffResult = diffLines(originalContent, content);
             const shortResult = isExistingFile ? "File overwritten" : "File created";
             const lines = content.split("\n").length;
             const chars = content.length;
             const detailedContent = `${shortResult} (${lines} lines, ${chars} characters)`;
-            // logger.debug(`Write tool: ${shortResult}`);
+            logger.debug(`Write tool: ${shortResult}`);
             return {
                 success: true,
                 content: detailedContent,
                 shortResult,
                 filePath: resolvedPath,
-                originalContent,
-                newContent: content,
-                diffResult,
             };
         }
         catch (error) {
             const errorMessage = error instanceof Error ? error.message : String(error);
-            // logger.error(`Write tool error: ${errorMessage}`);
+            logger.error(`Write tool error: ${errorMessage}`);
             return {
                 success: false,
                 content: "",

package/dist/types/commands.d.ts

@@ -9,7 +9,6 @@ export interface SlashCommand {
     handler: (args?: string) => Promise<void> | void;
 }
 export interface CustomSlashCommandConfig {
-    allowedTools?: string[];
     model?: string;
     description?: string;
 }
@@ -20,5 +19,9 @@ export interface CustomSlashCommand {
     filePath: string;
     content: string;
     config?: CustomSlashCommandConfig;
+    namespace?: string;
+    isNested: boolean;
+    depth: number;
+    segments: string[];
 }
 //# sourceMappingURL=commands.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/types/commands.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,wBAAwB;IACvC,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,wBAAwB,CAAC;CACnC"}
+{"version":3,"file":"commands.d.ts","sourceRoot":"","sources":["../../src/types/commands.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAClD;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,wBAAwB,CAAC;IAGlC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,OAAO,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB"}

package/dist/types/config.d.ts

@@ -2,9 +2,13 @@
  * Agent and service configuration types
  * Dependencies: None
  */
+import OpenAI from "openai";
 export interface GatewayConfig {
     apiKey: string;
     baseURL: string;
+    defaultHeaders?: Record<string, string>;
+    fetchOptions?: OpenAI["fetchOptions"];
+    fetch?: OpenAI["fetch"];
 }
 export interface ModelConfig {
     agentModel: string;

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/types/config.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;CACnB"}

package/dist/types/configuration.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Configuration Management Types
+ *
+ * Types for centralized configuration loading and validation services.
+ * These support the refactored configuration architecture that separates
+ * configuration management from hook execution.
+ */
+import type { WaveConfiguration } from "./hooks.js";
+/**
+ * Result of configuration loading operations with detailed status information
+ */
+export interface ConfigurationLoadResult {
+    /** The loaded configuration, or null if loading failed */
+    configuration: WaveConfiguration | null;
+    /** Whether the loading operation was successful */
+    success: boolean;
+    /** Error message if loading failed */
+    error?: string;
+    /** Path of the successfully loaded file */
+    sourcePath?: string;
+    /** Non-critical warnings during loading */
+    warnings: string[];
+}
+/**
+ * Result of configuration validation operations
+ */
+export interface ValidationResult {
+    /** Whether the configuration is valid */
+    isValid: boolean;
+    /** Critical errors that prevent configuration use */
+    errors: string[];
+    /** Non-critical warnings about the configuration */
+    warnings: string[];
+}
+/**
+ * Configuration file paths organized by category
+ */
+export interface ConfigurationPaths {
+    /** User-specific configuration file paths in priority order */
+    userPaths: string[];
+    /** Project-specific configuration file paths in priority order */
+    projectPaths: string[];
+    /** All configuration paths combined */
+    allPaths: string[];
+    /** Only the paths that actually exist on the filesystem */
+    existingPaths: string[];
+}
+/**
+ * Options for configuring the ConfigurationService
+ */
+export interface ConfigurationServiceOptions {
+    /** Working directory for resolving project configurations */
+    workdir: string;
+    /** Optional logger for configuration operations */
+    logger?: Logger;
+    /** Whether to enable validation during loading (default: true) */
+    enableValidation?: boolean;
+}
+/**
+ * Minimal logger interface for configuration services
+ */
+interface Logger {
+    error: (...args: unknown[]) => void;
+    warn: (...args: unknown[]) => void;
+    info: (...args: unknown[]) => void;
+    debug: (...args: unknown[]) => void;
+}
+export {};
+//# sourceMappingURL=configuration.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"configuration.d.ts","sourceRoot":"","sources":["../../src/types/configuration.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0DAA0D;IAC1D,aAAa,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACxC,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,2CAA2C;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,2CAA2C;IAC3C,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,yCAAyC;IACzC,OAAO,EAAE,OAAO,CAAC;IACjB,qDAAqD;IACrD,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,oDAAoD;IACpD,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,kEAAkE;IAClE,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,2DAA2D;IAC3D,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,mDAAmD;IACnD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,UAAU,MAAM;IACd,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACrC"}

package/dist/types/configuration.js

@@ -0,0 +1,8 @@
+/**
+ * Configuration Management Types
+ *
+ * Types for centralized configuration loading and validation services.
+ * These support the refactored configuration architecture that separates
+ * configuration management from hook execution.
+ */
+export {};

package/dist/types/core.d.ts

@@ -2,6 +2,7 @@
  * Core foundational types used across multiple domains
  * Dependencies: None (foundation layer)
  */
+import type { CompletionUsage } from "openai/resources";
 /**
  * Logger interface definition
  * Compatible with OpenAI package Logger interface
@@ -22,6 +23,50 @@ export interface Usage {
     total_tokens: number;
     model?: string;
     operation_type?: "agent" | "compress";
+    cache_read_input_tokens?: number;
+    cache_creation_input_tokens?: number;
+    cache_creation?: {
+        ephemeral_5m_input_tokens: number;
+        ephemeral_1h_input_tokens: number;
+    };
+}
+/**
+ * Enhanced usage metrics including Claude cache information
+ * Backward compatible with standard OpenAI CompletionUsage
+ */
+export interface ClaudeUsage extends CompletionUsage {
+    prompt_tokens: number;
+    completion_tokens: number;
+    total_tokens: number;
+    /**
+     * Number of tokens read from existing cache
+     * Indicates cost savings from cache hits
+     */
+    cache_read_input_tokens?: number;
+    /**
+     * Number of tokens used to create new cache entries
+     * Investment in future cache hits
+     */
+    cache_creation_input_tokens?: number;
+    /**
+     * Detailed breakdown of cache creation by duration
+     */
+    cache_creation?: {
+        /** Tokens cached for 5 minute duration */
+        ephemeral_5m_input_tokens: number;
+        /** Tokens cached for 1 hour duration */
+        ephemeral_1h_input_tokens: number;
+    };
+}
+/**
+ * Represents a diff change for tool parameter-based diff display
+ * Contains the old content and new content for comparison
+ */
+export interface Change {
+    /** The original content (empty string for additions) */
+    oldContent: string;
+    /** The new content (empty string for deletions) */
+    newContent: string;
 }
 export declare class ConfigurationError extends Error {
     readonly field: string;

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

@@ -1 +1 @@
-{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/types/core.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;CACvC;AAED,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,KAAK,EAAE,MAAM;aACb,QAAQ,CAAC,EAAE,OAAO;gBAFlC,OAAO,EAAE,MAAM,EACC,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,OAAO,YAAA;CAKrC;AAGD,eAAO,MAAM,aAAa;;;;;;CAQhB,CAAC"}
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/types/core.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAExD;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACpC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,IAAI,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;IACnC,KAAK,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC;CACrC;AAED;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IACrB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,OAAO,GAAG,UAAU,CAAC;IAGtC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,2BAA2B,CAAC,EAAE,MAAM,CAAC;IACrC,cAAc,CAAC,EAAE;QACf,yBAAyB,EAAE,MAAM,CAAC;QAClC,yBAAyB,EAAE,MAAM,CAAC;KACnC,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,WAAY,SAAQ,eAAe;IAElD,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,YAAY,EAAE,MAAM,CAAC;IAGrB;;;OAGG;IACH,uBAAuB,CAAC,EAAE,MAAM,CAAC;IAEjC;;;OAGG;IACH,2BAA2B,CAAC,EAAE,MAAM,CAAC;IAErC;;OAEG;IACH,cAAc,CAAC,EAAE;QACf,0CAA0C;QAC1C,yBAAyB,EAAE,MAAM,CAAC;QAClC,wCAAwC;QACxC,yBAAyB,EAAE,MAAM,CAAC;KACnC,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,MAAM;IACrB,wDAAwD;IACxD,UAAU,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,kBAAmB,SAAQ,KAAK;aAGzB,KAAK,EAAE,MAAM;aACb,QAAQ,CAAC,EAAE,OAAO;gBAFlC,OAAO,EAAE,MAAM,EACC,KAAK,EAAE,MAAM,EACb,QAAQ,CAAC,EAAE,OAAO,YAAA;CAKrC;AAGD,eAAO,MAAM,aAAa;;;;;;CAQhB,CAAC"}

package/dist/types/environment.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Environment Variable System Types
+ *
+ * Provides comprehensive TypeScript types for environment variable validation,
+ * merging, and conflict resolution in the Wave Agent SDK.
+ */
+/**
+ * Result of environment variable validation
+ */
+export interface EnvironmentValidationResult {
+    isValid: boolean;
+    errors: string[];
+    warnings: string[];
+}
+/**
+ * Context containing merged environment variables and conflict information
+ */
+export interface MergedEnvironmentContext {
+    userVars: Record<string, string>;
+    projectVars: Record<string, string>;
+    mergedVars: Record<string, string>;
+    conflicts: Array<{
+        key: string;
+        userValue: string;
+        projectValue: string;
+        resolvedValue: string;
+    }>;
+}
+/**
+ * Type guard to check if a value is a valid environment variables object
+ */
+export declare function isValidEnvironmentVars(env: unknown): env is Record<string, string>;
+/**
+ * Configuration options for environment merging
+ */
+export interface EnvironmentMergeOptions {
+    /** Whether to include warnings for conflicting variables */
+    includeConflictWarnings?: boolean;
+    /** Whether to validate variable names for common patterns */
+    validateVariableNames?: boolean;
+}
+/**
+ * Result of environment variable processing operations
+ */
+export interface EnvironmentProcessResult {
+    /** The processed environment variables */
+    processedVars: Record<string, string>;
+    /** Any conflicts that occurred during processing */
+    conflicts: EnvironmentConflict[];
+    /** Non-critical warnings during processing */
+    warnings: string[];
+    /** Whether the variables were successfully applied to process.env */
+    applied: boolean;
+}
+/**
+ * Enhanced environment merge context with conflict details
+ */
+export interface EnvironmentMergeContext {
+    /** User-provided environment variables */
+    userVars: Record<string, string>;
+    /** Project-provided environment variables */
+    projectVars: Record<string, string>;
+    /** Final merged environment variables */
+    mergedVars: Record<string, string>;
+    /** Detailed conflict information */
+    conflicts: EnvironmentConflict[];
+}
+/**
+ * Detailed information about an environment variable conflict
+ */
+export interface EnvironmentConflict {
+    /** The environment variable key */
+    key: string;
+    /** Value from user configuration */
+    userValue: string;
+    /** Value from project configuration */
+    projectValue: string;
+    /** Final resolved value (which source won) */
+    resolvedValue: string;
+    /** Which source provided the final value */
+    source: "user" | "project";
+}
+//# sourceMappingURL=environment.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/types/environment.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,SAAS,EAAE,KAAK,CAAC;QACf,GAAG,EAAE,MAAM,CAAC;QACZ,SAAS,EAAE,MAAM,CAAC;QAClB,YAAY,EAAE,MAAM,CAAC;QACrB,aAAa,EAAE,MAAM,CAAC;KACvB,CAAC,CAAC;CACJ;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,OAAO,GACX,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAa/B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,4DAA4D;IAC5D,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,6DAA6D;IAC7D,qBAAqB,CAAC,EAAE,OAAO,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,oDAAoD;IACpD,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,8CAA8C;IAC9C,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,qEAAqE;IACrE,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,6CAA6C;IAC7C,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,yCAAyC;IACzC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,oCAAoC;IACpC,SAAS,EAAE,mBAAmB,EAAE,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mCAAmC;IACnC,GAAG,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,uCAAuC;IACvC,YAAY,EAAE,MAAM,CAAC;IACrB,8CAA8C;IAC9C,aAAa,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;CAC5B"}

package/dist/types/environment.js

@@ -0,0 +1,21 @@
+/**
+ * Environment Variable System Types
+ *
+ * Provides comprehensive TypeScript types for environment variable validation,
+ * merging, and conflict resolution in the Wave Agent SDK.
+ */
+/**
+ * Type guard to check if a value is a valid environment variables object
+ */
+export function isValidEnvironmentVars(env) {
+    if (typeof env !== "object" || env === null) {
+        return false;
+    }
+    // Check if all keys and values are strings
+    for (const [key, value] of Object.entries(env)) {
+        if (typeof key !== "string" || typeof value !== "string") {
+            return false;
+        }
+    }
+    return true;
+}

package/dist/types/fileSearch.d.ts

@@ -0,0 +1,5 @@
+export interface FileItem {
+    path: string;
+    type: "file" | "directory";
+}
+//# sourceMappingURL=fileSearch.d.ts.map