wave-agent-sdk 0.14.3 → 0.15.0

package/dist/utils/editUtils.js

@@ -1,7 +1,6 @@
 /**
  * Utility functions for file editing tools
  */
-import { formatLineNumberPrefix } from "./stringUtils.js";
 /**
  * Escape regular expression special characters
  */
@@ -9,61 +8,8 @@ export function escapeRegExp(string) {
     return string.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
 }
 /**
- * Analyze why an edit failed by finding the best partial match and highlighting mismatches.
+ * Returns a generic error message when old_string is not found.
  */
-export function analyzeEditMismatch(content, searchString) {
-    const contentLines = content.split("\n");
-    const searchLines = searchString.split("\n");
-    if (searchLines.length === 0 || contentLines.length === 0) {
-        return "old_string not found in file (empty search or content)";
-    }
-    let bestMatchIndex = -1;
-    let bestMatchScore = -1;
-    // Sliding window to find the best partial match
-    for (let i = 0; i <= contentLines.length - searchLines.length; i++) {
-        let currentScore = 0;
-        for (let j = 0; j < searchLines.length; j++) {
-            if (contentLines[i + j] === searchLines[j]) {
-                currentScore++;
-            }
-        }
-        // Heuristic: prioritize matches where first or last lines match
-        if (contentLines[i] === searchLines[0])
-            currentScore += 0.5;
-        if (contentLines[i + searchLines.length - 1] ===
-            searchLines[searchLines.length - 1])
-            currentScore += 0.5;
-        // Also consider trimmed matches to catch indentation issues
-        for (let j = 0; j < searchLines.length; j++) {
-            if (contentLines[i + j].trim() === searchLines[j].trim() &&
-                contentLines[i + j] !== searchLines[j]) {
-                currentScore += 0.1;
-            }
-        }
-        if (currentScore > bestMatchScore) {
-            bestMatchScore = currentScore;
-            bestMatchIndex = i;
-        }
-    }
-    // If no decent match found (score <= 0), return generic message
-    if (bestMatchScore <= 0) {
-        return "old_string not found in file (no similar block found)";
-    }
-    // Generate detailed report
-    const reportLines = [
-        `old_string not found in file. Best partial match found at line ${bestMatchIndex + 1}:`,
-    ];
-    for (let j = 0; j < searchLines.length; j++) {
-        const lineNum = bestMatchIndex + j + 1;
-        const actualLine = contentLines[bestMatchIndex + j];
-        const expectedLine = searchLines[j];
-        if (actualLine === expectedLine) {
-            reportLines.push(`${formatLineNumberPrefix(lineNum)}${actualLine}`);
-        }
-        else {
-            reportLines.push(`${formatLineNumberPrefix(lineNum)}- ${expectedLine}`);
-            reportLines.push(`${formatLineNumberPrefix(lineNum)}+ ${actualLine}`);
-        }
-    }
-    return reportLines.join("\n");
+export function analyzeEditMismatch() {
+    return "old_string not found in file";
 }

package/dist/utils/markdownParser.d.ts

@@ -27,7 +27,14 @@ export declare function parseBashCommands(content: string): {
     processedContent: string;
 };
 /**
- * Replace bash command placeholders with their outputs
+ * Truncate output if it exceeds the size limit.
+ * Writes to a temp file and returns a preview + file path if truncated.
+ */
+export declare function truncateOutput(output: string): string;
+/**
+ * Replace bash command placeholders with their outputs.
+ * Uses function replacer to avoid $$, $&, $' corruption in shell output.
+ * Handles both inline (!`cmd`) and block (```! cmd ```) syntax.
  */
 export declare function replaceBashCommandsWithOutput(content: string, results: BashCommandResult[]): string;
 /**

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

@@ -1 +1 @@
-{"version":3,"file":"markdownParser.d.ts","sourceRoot":"","sources":["../../src/utils/markdownParser.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAIlE,UAAU,kBAAkB;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,wBAAwB,CAAC;CACnC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB,CA8DA;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CA4CtE;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;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,MAAc,GACtB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAkC9B"}
+{"version":3,"file":"markdownParser.d.ts","sourceRoot":"","sources":["../../src/utils/markdownParser.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAQlE,UAAU,kBAAkB;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,wBAAwB,CAAC;CACnC;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,OAAO,EAAE,MAAM,CAAC;CACjB,CA8DA;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,kBAAkB,CA4CtE;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;CAClB;AAYD,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG;IAClD,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;CAC1B,CAyCA;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAgBrD;AAED;;;;GAIG;AACH,wBAAgB,6BAA6B,CAC3C,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,iBAAiB,EAAE,GAC3B,MAAM,CAuBR;AAED;;GAEG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,MAAM,EAAE,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,MAAc,GACtB,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAkC9B"}

package/dist/utils/markdownParser.js

@@ -1,6 +1,9 @@
-import { readFileSync } from "fs";
+import { readFileSync, writeFileSync, mkdirSync } from "fs";
 import { exec } from "child_process";
 import { promisify } from "util";
+import { join } from "path";
+import { tmpdir } from "os";
+import { SKILL_BASH_MAX_OUTPUT_CHARS, PREVIEW_SIZE_BYTES, } from "../constants/toolLimits.js";
 const execAsync = promisify(exec);
 /**
  * Parse YAML frontmatter from markdown content
@@ -97,13 +100,38 @@ export function parseMarkdownFile(filePath) {
         throw new Error(`Failed to parse markdown file ${filePath}: ${error instanceof Error ? error.message : String(error)}`);
     }
 }
+/**
+ * Block syntax pattern: ```! command ```
+ */
+const BLOCK_BASH_REGEX = /```!\s*\n?([\s\S]*?)\n?```/g;
+/**
+ * Inline syntax pattern: !`command`
+ */
+const INLINE_BASH_REGEX = /!`([^`]+)`/g;
 export function parseBashCommands(content) {
-    const bashCommandRegex = /!`([^`]+)`/g;
+    // Performance gate: skip expensive regex if no bash pattern exists
+    // Covers the common case where 93% of skills have no bash substitution
+    if (!content.includes("!`") && !content.includes("```!")) {
+        return { commands: [], processedContent: content };
+    }
     const commands = [];
-    let match;
-    // Extract all bash commands
-    while ((match = bashCommandRegex.exec(content)) !== null) {
-        commands.push(match[1]);
+    // Extract block commands
+    let blockMatch;
+    const blockRegex = new RegExp(BLOCK_BASH_REGEX.source, BLOCK_BASH_REGEX.flags);
+    while ((blockMatch = blockRegex.exec(content)) !== null) {
+        const cmd = blockMatch[1].trim();
+        if (cmd) {
+            commands.push(cmd);
+        }
+    }
+    // Extract inline commands
+    let inlineMatch;
+    const inlineRegex = new RegExp(INLINE_BASH_REGEX.source, INLINE_BASH_REGEX.flags);
+    while ((inlineMatch = inlineRegex.exec(content)) !== null) {
+        const cmd = inlineMatch[1].trim();
+        if (cmd) {
+            commands.push(cmd);
+        }
     }
     // For now, return the content as-is. The actual command execution
     // will be handled by the slash command manager
@@ -113,18 +141,43 @@ export function parseBashCommands(content) {
     };
 }
 /**
- * Replace bash command placeholders with their outputs
+ * Truncate output if it exceeds the size limit.
+ * Writes to a temp file and returns a preview + file path if truncated.
+ */
+export function truncateOutput(output) {
+    if (output.length <= SKILL_BASH_MAX_OUTPUT_CHARS) {
+        return output;
+    }
+    const preview = output.slice(0, PREVIEW_SIZE_BYTES);
+    const tempDir = join(tmpdir(), "wave-skill-bash");
+    mkdirSync(tempDir, { recursive: true });
+    const tempFile = join(tempDir, `output-${Date.now()}-${Math.random().toString(36).slice(2, 8)}.txt`);
+    writeFileSync(tempFile, output, "utf-8");
+    return `${preview}\n\n[Output truncated (${output.length} chars). Full output saved to: ${tempFile}]`;
+}
+/**
+ * Replace bash command placeholders with their outputs.
+ * Uses function replacer to avoid $$, $&, $' corruption in shell output.
+ * Handles both inline (!`cmd`) and block (```! cmd ```) syntax.
  */
 export function replaceBashCommandsWithOutput(content, results) {
-    const bashCommandRegex = /!`([^`]+)`/g;
     let processedContent = content;
     let commandIndex = 0;
-    processedContent = processedContent.replace(bashCommandRegex, (match) => {
+    // Replace block syntax first: ```! command ```
+    processedContent = processedContent.replace(BLOCK_BASH_REGEX, () => {
+        if (commandIndex < results.length) {
+            const result = results[commandIndex++];
+            return truncateOutput(result.output);
+        }
+        return "";
+    });
+    // Replace inline syntax: !`command`
+    processedContent = processedContent.replace(INLINE_BASH_REGEX, () => {
         if (commandIndex < results.length) {
             const result = results[commandIndex++];
-            return result.output;
+            return truncateOutput(result.output);
         }
-        return match;
+        return "";
     });
     return processedContent;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"openaiClient.d.ts","sourceRoot":"","sources":["../../src/utils/openaiClient.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sCAAsC,EACtC,mCAAmC,EACnC,mBAAmB,EACnB,cAAc,EACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,KAAK,YAAY,GACb,sCAAsC,GACtC,mCAAmC,CAAC;AAExC,UAAU,WAAW,CAAC,CAAC;IACrB,IAAI,EAAE,CAAC,CAAC;IACR,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,UAAU,UAAU,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IACxC,YAAY,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;CACzC;AAED,qBAAa,YAAY;IACX,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAEzC,IAAI,IAAI;;qBAGO,CAAC,SAAS,YAAY,UACrB,CAAC,YACC;gBAAE,MAAM,CAAC,EAAE,WAAW,CAAA;aAAE,KACjC,UAAU,CACX,CAAC,SAAS,mCAAmC,GACzC,aAAa,CAAC,mBAAmB,CAAC,GAClC,cAAc,CACnB;;MA2BN;YAEa,OAAO;YAgJN,oBAAoB;CAqCpC"}
+{"version":3,"file":"openaiClient.d.ts","sourceRoot":"","sources":["../../src/utils/openaiClient.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sCAAsC,EACtC,mCAAmC,EACnC,mBAAmB,EACnB,cAAc,EACf,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAGnD,KAAK,YAAY,GACb,sCAAsC,GACtC,mCAAmC,CAAC;AAExC,UAAU,WAAW,CAAC,CAAC;IACrB,IAAI,EAAE,CAAC,CAAC;IACR,QAAQ,EAAE,QAAQ,CAAC;CACpB;AAED,UAAU,UAAU,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IACxC,YAAY,IAAI,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;CACzC;AAED,qBAAa,YAAY;IACX,OAAO,CAAC,MAAM;gBAAN,MAAM,EAAE,aAAa;IAEzC,IAAI,IAAI;;qBAGO,CAAC,SAAS,YAAY,UACrB,CAAC,YACC;gBAAE,MAAM,CAAC,EAAE,WAAW,CAAA;aAAE,KACjC,UAAU,CACX,CAAC,SAAS,mCAAmC,GACzC,aAAa,CAAC,mBAAmB,CAAC,GAClC,cAAc,CACnB;;MA2BN;YAEa,OAAO;YAqIN,oBAAoB;CAqCpC"}

package/dist/utils/openaiClient.js

@@ -108,27 +108,16 @@ export class OpenAIClient {
             error.status = response.status;
             error.body = errorBody;
             if (response.status === 429 && attempt < maxRetries) {
-                const responseHeaders = {};
-                response.headers.forEach((value, key) => {
-                    responseHeaders[key] = value;
-                });
                 logger.warn("OpenAI API 429 Too Many Requests, retrying...", {
                     attempt: attempt + 1,
                     status: response.status,
-                    responseHeaders,
                 });
                 lastError = error;
                 continue;
             }
-            const responseHeaders = {};
-            response.headers.forEach((value, key) => {
-                responseHeaders[key] = value;
-            });
             logger.error("OpenAI API Error:", {
                 status: response.status,
                 statusText: response.statusText,
-                requestHeaders: headers,
-                responseHeaders,
                 errorBody,
             });
             throw error;

package/dist/utils/stringUtils.d.ts

@@ -23,6 +23,14 @@ export declare const stripAnsiColors: (text: string) => string;
  * @returns Formatted line number prefix
  */
 export declare function formatLineNumberPrefix(lineNumber: number): string;
+/**
+ * Attempt to recover truncated JSON (e.g., missing closing braces due to max tokens).
+ * Tracks brace depth and only recovers if there are unclosed `{` braces.
+ * Will NOT recover if there are unclosed `[` brackets (can't guess the content).
+ * @param jsonStr Potentially truncated JSON string
+ * @returns Recovered JSON string, or the original if unrecoverable
+ */
+export declare function recoverTruncatedJson(jsonStr: string): string;
 /**
  * Efficiently get the last N lines of a string without splitting the whole string.
  */

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

@@ -1 +1 @@
-{"version":3,"file":"stringUtils.d.ts","sourceRoot":"","sources":["../../src/utils/stringUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAgC/D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,MAAM,GACpB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwBxB;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MAK9C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAehE"}
+{"version":3,"file":"stringUtils.d.ts","sourceRoot":"","sources":["../../src/utils/stringUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAgC/D;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,MAAM,GACpB,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAwBxB;AAED;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAAI,MAAM,MAAM,KAAG,MAK9C,CAAC;AAEF;;;;GAIG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAkC5D;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAehE"}

package/dist/utils/stringUtils.js

@@ -77,6 +77,51 @@ export const stripAnsiColors = (text) => {
 export function formatLineNumberPrefix(lineNumber) {
     return `${lineNumber.toString().padStart(6)}\t`;
 }
+/**
+ * Attempt to recover truncated JSON (e.g., missing closing braces due to max tokens).
+ * Tracks brace depth and only recovers if there are unclosed `{` braces.
+ * Will NOT recover if there are unclosed `[` brackets (can't guess the content).
+ * @param jsonStr Potentially truncated JSON string
+ * @returns Recovered JSON string, or the original if unrecoverable
+ */
+export function recoverTruncatedJson(jsonStr) {
+    let braceDepth = 0;
+    let bracketDepth = 0;
+    let inString = false;
+    let escaped = false;
+    for (const ch of jsonStr) {
+        if (escaped) {
+            escaped = false;
+            continue;
+        }
+        if (ch === "\\" && inString) {
+            escaped = true;
+            continue;
+        }
+        if (ch === '"') {
+            inString = !inString;
+            continue;
+        }
+        if (!inString) {
+            if (ch === "{")
+                braceDepth++;
+            if (ch === "}")
+                braceDepth--;
+            if (ch === "[")
+                bracketDepth++;
+            if (ch === "]")
+                bracketDepth--;
+        }
+    }
+    // Build recovery suffix
+    let suffix = "";
+    if (inString)
+        suffix += '"'; // Close unclosed string
+    if (braceDepth > 0 && bracketDepth === 0) {
+        suffix += "}".repeat(braceDepth);
+    }
+    return suffix ? jsonStr + suffix : jsonStr;
+}
 /**
  * Efficiently get the last N lines of a string without splitting the whole string.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wave-agent-sdk",
-  "version": "0.14.3",
+  "version": "0.15.0",
   "description": "SDK for building AI-powered development tools and agents",
   "keywords": [
     "ai",

package/src/agent.ts

@@ -218,13 +218,6 @@ export class Agent {
       }
     };
 
-    // Wire up CWD change callback from AIManager to sync Agent's workdir
-    this.aiManager.setOnCwdChange((newCwd) => {
-      this.workdir = newCwd;
-      this.container.register("Workdir", newCwd);
-      this.options.callbacks?.onWorkdirChange?.(newCwd);
-    });
-
     // Wire up message queue to process when agent becomes idle
     this.messageQueue.onMessageEnqueued = () => {
       // If the AI is NOT loading and command is not running, trigger dequeue
@@ -287,16 +280,6 @@ export class Agent {
     return this.workdir;
   }
 
-  /**
-   * Set the working directory
-   * @param newCwd - The new working directory
-   */
-  public setWorkdir(newCwd: string): void {
-    this.workdir = newCwd;
-    this.container.register("Workdir", newCwd);
-    this.options.callbacks?.onWorkdirChange?.(newCwd);
-  }
-
   /** Get project memory content */
   public get projectMemory(): string {
     return this._projectMemoryContent;

package/src/constants/toolLimits.ts

@@ -0,0 +1,12 @@
+/**
+ * Tool output size limits matching Claude Code patterns.
+ */
+
+/** System-wide default max result size in characters. */
+export const DEFAULT_MAX_RESULT_SIZE_CHARS = 50_000;
+
+/** Per-command cap for skill bash substitution (inline/block). */
+export const SKILL_BASH_MAX_OUTPUT_CHARS = 30_000;
+
+/** Preview size in characters when output is persisted to disk. */
+export const PREVIEW_SIZE_BYTES = 2_048;