wave-agent-sdk 0.0.8 → 0.0.10

package/dist/utils/fileUtils.js

@@ -1,4 +1,8 @@
-import fs from "node:fs";
+import fs from "node:fs/promises";
+import { createReadStream } from "node:fs";
+import path from "node:path";
+import { execSync } from "node:child_process";
+import { homedir } from "node:os";
 /**
  * Reads the first line of a file efficiently using Node.js readline.
  *
@@ -6,7 +10,6 @@ import fs from "node:fs";
  * @return {Promise<string>} - The first non-empty line of the file, or an empty string otherwise.
  */
 export async function readFirstLine(filePath) {
-    const { createReadStream } = fs;
     const { createInterface } = await import("node:readline");
     const fileStream = createReadStream(filePath);
     const rl = createInterface({
@@ -32,30 +35,111 @@ export async function readFirstLine(filePath) {
     }
 }
 /**
- * Reads a file from the end and returns the first non-empty line.
+ * Reads a file from the end and returns the last non-empty line.
+ *
+ * This version supports files that end with:
+ *   - "\n" (Unix-style, including modern macOS)
+ *   - "\r\n" (Windows-style)
+ *   - "\r" (older Mac-style, HL7, etc.)
  *
  * @param {string} filePath - The path to the file.
+ * @param {number} [minLength=1] - Minimum length for the returned line.
  * @return {Promise<string>} - The last non-empty line of the file, or an empty string if no non-empty lines found.
  */
-export async function getLastLine(filePath) {
-    const { exec } = await import("child_process");
-    const { promisify } = await import("util");
-    const execAsync = promisify(exec);
+export async function getLastLine(filePath, minLength = 1) {
+    let fileHandle;
     try {
-        // Use tail with multiple lines to handle cases where the last line might be empty
-        const { stdout } = await execAsync(`tail -n 3 "${filePath}"`);
-        const lines = stdout.split(/\r?\n/);
-        // Find the first non-empty line working backwards
-        for (let i = lines.length - 1; i >= 0; i--) {
-            const line = lines[i].trim();
-            if (line.length > 0) {
-                return line;
+        const stats = await fs.stat(filePath);
+        const fileSize = stats.size;
+        if (fileSize === 0)
+            return "";
+        fileHandle = await fs.open(filePath, "r");
+        const bufferSize = 8 * 1024; // 8KB buffer is usually enough for the last line
+        const buffer = Buffer.alloc(bufferSize);
+        let lineEnd = null;
+        let lineStart = null;
+        let currentPosition = fileSize;
+        while (currentPosition > 0 && lineStart === null) {
+            const readSize = Math.min(bufferSize, currentPosition);
+            currentPosition -= readSize;
+            const { bytesRead } = await fileHandle.read(buffer, 0, readSize, currentPosition);
+            for (let i = bytesRead - 1; i >= 0; i--) {
+                const charCode = buffer[i];
+                if (lineEnd === null) {
+                    // Still looking for the end of the last non-empty line (skip trailing newlines and whitespace)
+                    if (charCode > 32) {
+                        lineEnd = currentPosition + i + 1;
+                    }
+                }
+                else {
+                    // Looking for the start of the line (the newline before it)
+                    if (charCode === 10 || charCode === 13) {
+                        lineStart = currentPosition + i + 1;
+                        break;
+                    }
+                }
             }
         }
-        return "";
+        if (lineEnd === null)
+            return "";
+        if (lineStart === null)
+            lineStart = 0;
+        const length = lineEnd - lineStart;
+        if (length < minLength)
+            return "";
+        const resultBuffer = Buffer.alloc(length);
+        await fileHandle.read(resultBuffer, 0, length, lineStart);
+        const result = resultBuffer.toString("utf8").trim();
+        return result.length >= minLength ? result : "";
     }
     catch {
-        // If tail fails (e.g., file doesn't exist), return empty string
+        // If reading fails (e.g., file doesn't exist), return empty string
         return "";
     }
+    finally {
+        if (fileHandle) {
+            await fileHandle.close();
+        }
+    }
+}
+/**
+ * Ensures that a pattern is present in the global git ignore file.
+ *
+ * @param {string} pattern - The pattern to add to global git ignore.
+ */
+export async function ensureGlobalGitIgnore(pattern) {
+    try {
+        let globalIgnorePath;
+        try {
+            globalIgnorePath = execSync("git config --get core.excludesfile", {
+                encoding: "utf8",
+            }).trim();
+        }
+        catch {
+            // If not set, use default paths
+            const xdgConfigHome = process.env.XDG_CONFIG_HOME || path.join(homedir(), ".config");
+            globalIgnorePath = path.join(xdgConfigHome, "git", "ignore");
+        }
+        if (!globalIgnorePath)
+            return;
+        // Ensure directory exists
+        await fs.mkdir(path.dirname(globalIgnorePath), { recursive: true });
+        let content = "";
+        try {
+            content = await fs.readFile(globalIgnorePath, "utf8");
+        }
+        catch {
+            // File doesn't exist
+        }
+        const lines = content.split("\n").map((line) => line.trim());
+        if (!lines.includes(pattern)) {
+            const newContent = content.endsWith("\n") || content === ""
+                ? `${content}${pattern}\n`
+                : `${content}\n${pattern}\n`;
+            await fs.writeFile(globalIgnorePath, newContent, "utf8");
+        }
+    }
+    catch {
+        // Ignore errors
+    }
 }

package/dist/utils/globalLogger.d.ts

@@ -30,20 +30,6 @@ import type { Logger } from "../types/core.js";
  * ```
  */
 export declare function setGlobalLogger(logger: Logger | null): void;
-/**
- * Retrieve the current global logger instance
- *
- * @returns Current logger instance or null if unconfigured
- *
- * @example
- * ```typescript
- * const currentLogger = getGlobalLogger();
- * if (currentLogger) {
- *   currentLogger.info('Direct logger access');
- * }
- * ```
- */
-export declare function getGlobalLogger(): Logger | null;
 /**
  * Reset global logger to unconfigured state
  * Equivalent to setGlobalLogger(null)

package/dist/utils/globalLogger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"globalLogger.d.ts","sourceRoot":"","sources":["../../src/utils/globalLogger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAa/C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAE3D;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,IAAI,MAAM,GAAG,IAAI,CAE/C;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAMD;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM;IACjB;;;OAGG;8BACc,OAAO,EAAE,KAAG,IAAI;IAKjC;;;OAGG;6BACa,OAAO,EAAE,KAAG,IAAI;IAKhC;;;OAGG;6BACa,OAAO,EAAE,KAAG,IAAI;IAKhC;;;OAGG;8BACc,OAAO,EAAE,KAAG,IAAI;CAIzB,CAAC"}
+{"version":3,"file":"globalLogger.d.ts","sourceRoot":"","sources":["../../src/utils/globalLogger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAa/C;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAE3D;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,IAAI,IAAI,CAExC;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,IAAI,OAAO,CAE5C;AAMD;;;;;;;GAOG;AACH,eAAO,MAAM,MAAM;IACjB;;;OAGG;8BACc,OAAO,EAAE,KAAG,IAAI;IAKjC;;;OAGG;6BACa,OAAO,EAAE,KAAG,IAAI;IAKhC;;;OAGG;6BACa,OAAO,EAAE,KAAG,IAAI;IAKhC;;;OAGG;8BACc,OAAO,EAAE,KAAG,IAAI;CAIzB,CAAC"}

package/dist/utils/globalLogger.js

@@ -40,22 +40,6 @@ let globalLogger = null;
 export function setGlobalLogger(logger) {
     globalLogger = logger;
 }
-/**
- * Retrieve the current global logger instance
- *
- * @returns Current logger instance or null if unconfigured
- *
- * @example
- * ```typescript
- * const currentLogger = getGlobalLogger();
- * if (currentLogger) {
- *   currentLogger.info('Direct logger access');
- * }
- * ```
- */
-export function getGlobalLogger() {
-    return globalLogger;
-}
 /**
  * Reset global logger to unconfigured state
  * Equivalent to setGlobalLogger(null)

package/dist/utils/largeOutputHandler.d.ts

@@ -0,0 +1,15 @@
+export declare const LARGE_OUTPUT_TOKEN_THRESHOLD = 20000;
+/**
+ * Handle large command output by writing to temporary file when token threshold is exceeded
+ *
+ * Uses token-based threshold (20k tokens) to determine when output should be written to temp file.
+ * This provides accurate estimation of actual token cost for LLM processing.
+ *
+ * @param output - The command output string
+ * @returns Object containing processed content and optional file path
+ */
+export declare function handleLargeOutput(output: string): Promise<{
+    content: string;
+    filePath?: string;
+}>;
+//# sourceMappingURL=largeOutputHandler.d.ts.map

package/dist/utils/largeOutputHandler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"largeOutputHandler.d.ts","sourceRoot":"","sources":["../../src/utils/largeOutputHandler.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,4BAA4B,QAAQ,CAAC;AAElD;;;;;;;;GAQG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/D,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,CAAC,CA8BD"}

package/dist/utils/largeOutputHandler.js

@@ -0,0 +1,40 @@
+import { writeFile } from "fs/promises";
+import { join } from "path";
+import { tmpdir } from "os";
+import { logger } from "./globalLogger.js";
+import { estimateTokenCount, getTokenUsageDescription, } from "./tokenEstimator.js";
+// Token threshold for writing output to temp file (20k tokens)
+export const LARGE_OUTPUT_TOKEN_THRESHOLD = 20000;
+/**
+ * Handle large command output by writing to temporary file when token threshold is exceeded
+ *
+ * Uses token-based threshold (20k tokens) to determine when output should be written to temp file.
+ * This provides accurate estimation of actual token cost for LLM processing.
+ *
+ * @param output - The command output string
+ * @returns Object containing processed content and optional file path
+ */
+export async function handleLargeOutput(output) {
+    const estimatedTokens = estimateTokenCount(output);
+    // Check token threshold
+    if (estimatedTokens <= LARGE_OUTPUT_TOKEN_THRESHOLD) {
+        return { content: output };
+    }
+    try {
+        // Create temp file for large output
+        const tempFileName = `bash-output-${Date.now()}-${Math.random().toString(36).substr(2, 9)}.txt`;
+        const tempFilePath = join(tmpdir(), tempFileName);
+        await writeFile(tempFilePath, output, "utf8");
+        const sizeKB = Math.round(output.length / 1024);
+        const tokenDescription = getTokenUsageDescription(output, LARGE_OUTPUT_TOKEN_THRESHOLD);
+        return {
+            content: `Large output (${sizeKB} KB, ${tokenDescription}) written to temporary file. Use the Read tool to access the full content.`,
+            filePath: tempFilePath,
+        };
+    }
+    catch (error) {
+        logger.warn(`Failed to write large output to temp file: ${error}`);
+        // Fallback to direct output if temp file creation fails
+        return { content: output };
+    }
+}

package/dist/utils/markdownParser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"markdownParser.d.ts","sourceRoot":"","sources":["../../src/utils/markdownParser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAElE,UAAU,kBAAkB;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,wBAAwB,CAAC;CACnC;AAwDD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CAsCtE;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG;IAClD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAgBA;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,iBAAiB,EAAE,GAC3B,MAAM,CAcR"}
+{"version":3,"file":"markdownParser.d.ts","sourceRoot":"","sources":["../../src/utils/markdownParser.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAElE,UAAU,kBAAkB;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,wBAAwB,CAAC;CACnC;AA6CD;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CA+BtE;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG;IAClD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAgBA;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,iBAAiB,EAAE,GAC3B,MAAM,CAcR"}

package/dist/utils/markdownParser.js

@@ -22,19 +22,7 @@ function parseFrontmatter(content) {
                 continue;
             const key = trimmedLine.slice(0, colonIndex).trim();
             const value = trimmedLine.slice(colonIndex + 1).trim();
-            // Handle array values for allowed-tools
-            if (key === "allowed-tools" && value) {
-                // Simple array parsing: "tool1, tool2, tool3" or "[tool1, tool2]"
-                let arrayValue = value;
-                if (arrayValue.startsWith("[") && arrayValue.endsWith("]")) {
-                    arrayValue = arrayValue.slice(1, -1);
-                }
-                frontmatter[key] = arrayValue
-                    .split(",")
-                    .map((s) => s.trim())
-                    .filter(Boolean);
-            }
-            else if (value) {
+            if (value) {
                 frontmatter[key] = value;
             }
         }
@@ -55,10 +43,6 @@ export function parseMarkdownFile(filePath) {
         let config;
         if (frontmatter) {
             config = {};
-            if (frontmatter["allowed-tools"] &&
-                Array.isArray(frontmatter["allowed-tools"])) {
-                config.allowedTools = frontmatter["allowed-tools"];
-            }
             if (frontmatter.model && typeof frontmatter.model === "string") {
                 config.model = frontmatter.model;
             }

package/dist/utils/messageOperations.d.ts

@@ -39,15 +39,6 @@ export interface UpdateToolBlockParams {
     parametersChunk?: string;
 }
 export type AgentToolBlockUpdateParams = Omit<UpdateToolBlockParams, "messages">;
-export interface AddDiffBlockParams {
-    messages: Message[];
-    path: string;
-    diffResult: Array<{
-        value: string;
-        added?: boolean;
-        removed?: boolean;
-    }>;
-}
 export interface AddErrorBlockParams {
     messages: Message[];
     error: string;
@@ -85,8 +76,7 @@ export declare const extractUserInputHistory: (messages: Message[]) => string[];
  */
 export declare const convertImageToBase64: (imagePath: string) => string;
 export declare const addUserMessageToMessages: ({ messages, content, images, customCommandContent, source, }: AddUserMessageParams) => Message[];
-export declare const addAssistantMessageToMessages: (messages: Message[], content?: string, toolCalls?: ChatCompletionMessageFunctionToolCall[], usage?: Usage, metadata?: Record<string, unknown>) => Message[];
-export declare const addDiffBlockToMessage: ({ messages, path, diffResult, }: AddDiffBlockParams) => Message[];
+export declare const addAssistantMessageToMessages: (messages: Message[], content?: string, toolCalls?: ChatCompletionMessageFunctionToolCall[], usage?: Usage, additionalFields?: Record<string, unknown>) => Message[];
 export declare const updateToolBlockInMessage: ({ messages, id, parameters, result, success, error, stage, name, shortResult, images, compactParams, parametersChunk, }: UpdateToolBlockParams) => Message[];
 export declare const addErrorBlockToMessage: ({ messages, error, }: AddErrorBlockParams) => Message[];
 export declare const addMemoryBlockToMessage: ({ messages, content, isSuccess, memoryType, storagePath, }: AddMemoryBlockParams) => Message[];

package/dist/utils/messageOperations.d.ts.map

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

package/dist/utils/messageOperations.js

@@ -85,7 +85,7 @@ export const addUserMessageToMessages = ({ messages, content, images, customComm
     return [...messages, userMessage];
 };
 // Add assistant message (support one-time addition of answer and tool calls)
-export const addAssistantMessageToMessages = (messages, content, toolCalls, usage, metadata) => {
+export const addAssistantMessageToMessages = (messages, content, toolCalls, usage, additionalFields) => {
     const blocks = [];
     // If there's answer content, add text block
     if (content) {
@@ -108,27 +108,10 @@ export const addAssistantMessageToMessages = (messages, content, toolCalls, usag
         role: "assistant",
         blocks,
         usage, // Include usage data if provided
-        ...(metadata ? { metadata: { ...metadata } } : {}),
+        ...(additionalFields ? { additionalFields: { ...additionalFields } } : {}),
     };
     return [...messages, initialAssistantMessage];
 };
-// Update File Operation Block of the last assistant message
-export const addDiffBlockToMessage = ({ messages, path, diffResult, }) => {
-    const newMessages = [...messages];
-    // Find the last assistant message
-    for (let i = newMessages.length - 1; i >= 0; i--) {
-        if (newMessages[i].role === "assistant") {
-            // Directly add diff block instead of replacing existing blocks
-            newMessages[i].blocks.push({
-                type: "diff",
-                path: path,
-                diffResult: diffResult,
-            });
-            break;
-        }
-    }
-    return newMessages;
-};
 // Update Tool Block of the last assistant message
 export const updateToolBlockInMessage = ({ messages, id, parameters, result, success, error, stage, name, shortResult, images, compactParams, parametersChunk, }) => {
     const newMessages = [...messages];
@@ -292,7 +275,7 @@ export const getMessagesToCompress = (messages, keepLastCount = 7) => {
 // Add command output block to message list
 export const addCommandOutputMessage = ({ messages, command, }) => {
     const outputMessage = {
-        role: "assistant",
+        role: "user",
         blocks: [
             {
                 type: "command_output",
@@ -308,10 +291,10 @@ export const addCommandOutputMessage = ({ messages, command, }) => {
 // Update output content of command output block
 export const updateCommandOutputInMessage = ({ messages, command, output, }) => {
     const newMessages = [...messages];
-    // Find the last assistant message with a command_output block for this command
+    // Find the last user message with a command_output block for this command
     for (let i = newMessages.length - 1; i >= 0; i--) {
         const msg = newMessages[i];
-        if (msg.role === "assistant") {
+        if (msg.role === "user") {
             const commandBlock = msg.blocks.find((block) => block.type === "command_output" &&
                 block.command === command &&
                 block.isRunning);
@@ -326,10 +309,10 @@ export const updateCommandOutputInMessage = ({ messages, command, output, }) =>
 // Complete command execution, update exit status
 export const completeCommandInMessage = ({ messages, command, exitCode, }) => {
     const newMessages = [...messages];
-    // Find the last assistant message with a command_output block for this command
+    // Find the last user message with a command_output block for this command
     for (let i = newMessages.length - 1; i >= 0; i--) {
         const msg = newMessages[i];
-        if (msg.role === "assistant") {
+        if (msg.role === "user") {
             const commandBlock = msg.blocks.find((block) => block.type === "command_output" &&
                 block.command === command &&
                 block.isRunning);

package/dist/utils/pathEncoder.d.ts

@@ -72,6 +72,10 @@ export declare class PathEncoder {
      * Resolve symbolic links and normalize path before encoding
      */
     resolvePath(path: string): Promise<string>;
+    /**
+     * Get project directory info without creating the directory
+     */
+    getProjectDirectory(originalPath: string, baseSessionDir: string): Promise<ProjectDirectory>;
     /**
      * Create project directory entity from original path
      */

package/dist/utils/pathEncoder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pathEncoder.d.ts","sourceRoot":"","sources":["../../src/utils/pathEncoder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;gBAExC,OAAO,GAAE,mBAAwB;IAY7C;;OAEG;IACG,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMnD;;;OAGG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAyCxC;;;OAGG;IACG,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIzD;;;OAGG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAgC9C;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBhD;;OAEG;IACG,sBAAsB,CAC1B,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,gBAAgB,CAAC;IA0C5B;;OAEG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IA+BjD;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM;IAqBtE;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAsDhC;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACH,OAAO,CAAC,WAAW;CAMpB;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,aAAoB,CAAC"}
+{"version":3,"file":"pathEncoder.d.ts","sourceRoot":"","sources":["../../src/utils/pathEncoder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAOH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;CAClC;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;IACxC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IACrC,QAAQ,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;IAC5B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgC;IACxD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAwB;gBAExC,OAAO,GAAE,mBAAwB;IAY7C;;OAEG;IACG,MAAM,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAMnD;;;OAGG;IACH,UAAU,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM;IAyCxC;;;OAGG;IACG,MAAM,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAIzD;;;OAGG;IACH,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IAgC9C;;OAEG;IACG,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBhD;;OAEG;IACG,mBAAmB,CACvB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,gBAAgB,CAAC;IAmC5B;;OAEG;IACG,sBAAsB,CAC1B,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,gBAAgB,CAAC;IAgB5B;;OAEG;IACH,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO;IA+BjD;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,MAAM;IAqBtE;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAsDhC;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACH,OAAO,CAAC,WAAW;CAMpB;AAED;;GAEG;AACH,eAAO,MAAM,WAAW,aAAoB,CAAC"}

package/dist/utils/pathEncoder.js

@@ -110,9 +110,9 @@ export class PathEncoder {
         }
     }
     /**
-     * Create project directory entity from original path
+     * Get project directory info without creating the directory
      */
-    async createProjectDirectory(originalPath, baseSessionDir) {
+    async getProjectDirectory(originalPath, baseSessionDir) {
         // Resolve the original path and check for symbolic links
         const expandedPath = this.expandTilde(originalPath);
         const absolutePath = resolve(expandedPath);
@@ -134,13 +134,6 @@ export class PathEncoder {
         if (resolvedPath.length > this.options.maxLength) {
             pathHash = this.generateHash(resolvedPath, this.options.hashLength);
         }
-        // Ensure the encoded directory exists
-        try {
-            await mkdir(encodedPath, { recursive: true });
-        }
-        catch {
-            // Ignore errors if directory already exists
-        }
         return {
             originalPath: resolvedPath,
             encodedName,
@@ -149,6 +142,20 @@ export class PathEncoder {
             isSymbolicLink,
         };
     }
+    /**
+     * Create project directory entity from original path
+     */
+    async createProjectDirectory(originalPath, baseSessionDir) {
+        const projectDirectory = await this.getProjectDirectory(originalPath, baseSessionDir);
+        // Ensure the encoded directory exists
+        try {
+            await mkdir(projectDirectory.encodedPath, { recursive: true });
+        }
+        catch {
+            // Ignore errors if directory already exists
+        }
+        return projectDirectory;
+    }
     /**
      * Validate that an encoded name is filesystem-safe
      */

package/dist/utils/subagentParser.d.ts

@@ -5,11 +5,11 @@ export interface SubagentConfiguration {
     model?: string;
     systemPrompt: string;
     filePath: string;
-    scope: "project" | "user";
+    scope: "project" | "user" | "builtin";
     priority: number;
 }
 /**
- * Load all subagent configurations from project and user directories
+ * Load all subagent configurations from project and user directories, plus built-in subagents
  */
 export declare function loadSubagentConfigurations(workdir: string): Promise<SubagentConfiguration[]>;
 /**

package/dist/utils/subagentParser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"subagentParser.d.ts","sourceRoot":"","sources":["../../src/utils/subagentParser.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,GAAG,MAAM,CAAC;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AA+KD;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAmBlC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAGvC"}
+{"version":3,"file":"subagentParser.d.ts","sourceRoot":"","sources":["../../src/utils/subagentParser.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,SAAS,GAAG,MAAM,GAAG,SAAS,CAAC;IACtC,QAAQ,EAAE,MAAM,CAAC;CAClB;AA+KD;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAsBlC;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CACtC,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAGvC"}

package/dist/utils/subagentParser.js

@@ -68,10 +68,10 @@ function validateConfiguration(config, filePath) {
     if (!config.description) {
         throw new Error(`Missing required field 'description' in ${filePath}`);
     }
-    // Validate name pattern
-    const namePattern = /^[a-z][a-z0-9-]*$/;
+    // Validate name pattern - allow letters (upper/lowercase), numbers, and hyphens
+    const namePattern = /^[a-zA-Z][a-zA-Z0-9-]*$/;
     if (!namePattern.test(config.name)) {
-        throw new Error(`Invalid subagent name '${config.name}' in ${filePath}. Must start with a letter and contain only lowercase letters, numbers, and hyphens.`);
+        throw new Error(`Invalid subagent name '${config.name}' in ${filePath}. Must start with a letter and contain only letters, numbers, and hyphens.`);
     }
     // Validate model if specified - allow any non-empty string
     if (config.model && typeof config.model !== "string") {
@@ -132,17 +132,20 @@ function scanSubagentDirectory(dirPath, scope) {
     return configurations;
 }
 /**
- * Load all subagent configurations from project and user directories
+ * Load all subagent configurations from project and user directories, plus built-in subagents
  */
 export async function loadSubagentConfigurations(workdir) {
     const projectDir = join(workdir, ".wave", "agents");
     const userDir = join(process.env.HOME || "~", ".wave", "agents");
+    // Load configurations from all sources
+    const { getBuiltinSubagents } = await import("./builtinSubagents.js");
+    const builtinConfigs = getBuiltinSubagents();
     const projectConfigs = scanSubagentDirectory(projectDir, "project");
     const userConfigs = scanSubagentDirectory(userDir, "user");
-    // Merge configurations, with project configs taking precedence
+    // Merge configurations, with project configs taking highest precedence
     const configMap = new Map();
-    // Process in reverse priority order (user first, then project)
-    for (const config of [...userConfigs, ...projectConfigs]) {
+    // Process in reverse priority order (built-in first, then user, then project)
+    for (const config of [...builtinConfigs, ...userConfigs, ...projectConfigs]) {
         configMap.set(config.name, config);
     }
     return Array.from(configMap.values()).sort((a, b) => {

package/dist/utils/tokenEstimator.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Simple token estimation utility for text content
+ *
+ * This provides a fast approximation of token count without requiring
+ * actual tokenization, which would be expensive for large content.
+ */
+/**
+ * Estimate the number of tokens in a text string
+ *
+ * Uses a simple heuristic based on character count and common patterns:
+ * - Average token length varies by language and content type
+ * - English text: ~4-5 characters per token
+ * - Code/structured text: ~3-4 characters per token
+ * - Numbers/symbols: ~2-3 characters per token
+ *
+ * This function uses a conservative estimate of 4 characters per token
+ * which works well for mixed content (text + code + symbols).
+ *
+ * @param text - The text to estimate tokens for
+ * @returns Estimated number of tokens
+ */
+export declare function estimateTokenCount(text: string): number;
+/**
+ * Check if estimated token count exceeds a threshold
+ *
+ * @param text - The text to check
+ * @param threshold - Token threshold (default: 20,000)
+ * @returns True if estimated tokens exceed threshold
+ */
+export declare function exceedsTokenThreshold(text: string, threshold?: number): boolean;
+/**
+ * Get a human-readable description of estimated token usage
+ *
+ * @param text - The text to analyze
+ * @param threshold - Token threshold for comparison
+ * @returns Description string with token count and threshold info
+ */
+export declare function getTokenUsageDescription(text: string, threshold?: number): string;
+//# sourceMappingURL=tokenEstimator.d.ts.map

package/dist/utils/tokenEstimator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokenEstimator.d.ts","sourceRoot":"","sources":["../../src/utils/tokenEstimator.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAcvD;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,MAAc,GACxB,OAAO,CAET;AAED;;;;;;GAMG;AACH,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,MAAM,EACZ,SAAS,GAAE,MAAc,GACxB,MAAM,CAKR"}

package/dist/utils/tokenEstimator.js

@@ -0,0 +1,55 @@
+/**
+ * Simple token estimation utility for text content
+ *
+ * This provides a fast approximation of token count without requiring
+ * actual tokenization, which would be expensive for large content.
+ */
+/**
+ * Estimate the number of tokens in a text string
+ *
+ * Uses a simple heuristic based on character count and common patterns:
+ * - Average token length varies by language and content type
+ * - English text: ~4-5 characters per token
+ * - Code/structured text: ~3-4 characters per token
+ * - Numbers/symbols: ~2-3 characters per token
+ *
+ * This function uses a conservative estimate of 4 characters per token
+ * which works well for mixed content (text + code + symbols).
+ *
+ * @param text - The text to estimate tokens for
+ * @returns Estimated number of tokens
+ */
+export function estimateTokenCount(text) {
+    if (!text || text.length === 0) {
+        return 0;
+    }
+    // Base estimation: 4 characters per token (conservative)
+    const baseEstimate = Math.ceil(text.length / 4);
+    // Adjust for whitespace (spaces don't contribute much to token count)
+    const whitespaceCount = (text.match(/\s/g) || []).length;
+    const adjustedEstimate = Math.ceil((text.length - whitespaceCount * 0.5) / 4);
+    // Use the more conservative (higher) estimate
+    return Math.max(baseEstimate, adjustedEstimate);
+}
+/**
+ * Check if estimated token count exceeds a threshold
+ *
+ * @param text - The text to check
+ * @param threshold - Token threshold (default: 20,000)
+ * @returns True if estimated tokens exceed threshold
+ */
+export function exceedsTokenThreshold(text, threshold = 20000) {
+    return estimateTokenCount(text) > threshold;
+}
+/**
+ * Get a human-readable description of estimated token usage
+ *
+ * @param text - The text to analyze
+ * @param threshold - Token threshold for comparison
+ * @returns Description string with token count and threshold info
+ */
+export function getTokenUsageDescription(text, threshold = 20000) {
+    const estimatedTokens = estimateTokenCount(text);
+    const exceedsThreshold = estimatedTokens > threshold;
+    return `${estimatedTokens.toLocaleString()} tokens (${exceedsThreshold ? "exceeds" : "within"} ${threshold.toLocaleString()} limit)`;
+}