wave-agent-sdk 0.0.7 → 0.0.10

package/src/utils/bashHistory.ts

@@ -5,6 +5,7 @@
 
 import fs from "fs";
 import { BASH_HISTORY_FILE, DATA_DIRECTORY } from "./constants.js";
+import { logger } from "./globalLogger.js";
 
 export interface BashHistoryEntry {
   command: string;
@@ -28,8 +29,8 @@ const ensureDataDirectory = (): void => {
     if (!fs.existsSync(DATA_DIRECTORY)) {
       fs.mkdirSync(DATA_DIRECTORY, { recursive: true });
     }
-  } catch {
-    // logger.debug("Failed to create data directory:", error);
+  } catch (error) {
+    logger.debug("Failed to create data directory:", error);
   }
 };
 
@@ -52,7 +53,7 @@ export const loadBashHistory = (): BashHistory => {
 
     // Version compatibility check
     if (history.version !== HISTORY_VERSION) {
-      // logger.debug("Bash history version mismatch, resetting history");
+      logger.debug("Bash history version mismatch, resetting history");
       return {
         commands: [],
         version: HISTORY_VERSION,
@@ -60,8 +61,8 @@ export const loadBashHistory = (): BashHistory => {
     }
 
     return history;
-  } catch {
-    // logger.debug("Failed to load bash history:", error);
+  } catch (error) {
+    logger.debug("Failed to load bash history:", error);
     return {
       commands: [],
       version: HISTORY_VERSION,
@@ -76,7 +77,7 @@ export const saveBashHistory = (history: BashHistory): void => {
   try {
     // Skip saving to file when in test environment
     if (process.env.NODE_ENV === "test") {
-      // logger.debug("Skipping bash history save in test environment");
+      logger.debug("Skipping bash history save in test environment");
       return;
     }
 
@@ -89,8 +90,8 @@ export const saveBashHistory = (history: BashHistory): void => {
 
     const data = JSON.stringify(history, null, 2);
     fs.writeFileSync(BASH_HISTORY_FILE, data, "utf-8");
-  } catch {
-    // logger.debug("Failed to save bash history:", error);
+  } catch (error) {
+    logger.debug("Failed to save bash history:", error);
   }
 };
 
@@ -102,12 +103,6 @@ export const addBashCommandToHistory = (
   workdir: string,
 ): void => {
   try {
-    // Filter system-generated commands, do not add to history
-    if (command.startsWith("git add . && git commit -m")) {
-      // logger.debug("Skipping system-generated command:", { command, workdir });
-      return;
-    }
-
     const history = loadBashHistory();
     const timestamp = Date.now();
 
@@ -130,9 +125,9 @@ export const addBashCommandToHistory = (
     }
 
     saveBashHistory(history);
-    // logger.debug("Added bash command to history:", { command, workdir });
-  } catch {
-    // logger.debug("Failed to add bash command to history:", error);
+    logger.debug("Added bash command to history:", { command, workdir });
+  } catch (error) {
+    logger.debug("Failed to add bash command to history:", error);
   }
 };
 
@@ -158,7 +153,7 @@ export const searchBashHistory = (
     if (!normalizedQuery) {
       // If no search query, return recent commands (deduplicated)
       const deduped = deduplicateCommands(filteredCommands);
-      return deduped.slice(-limit).reverse(); // Latest first
+      return deduped.slice(0, limit); // Latest first
     }
 
     // Search by relevance
@@ -201,11 +196,16 @@ export const searchBashHistory = (
     const dedupedMatches = deduplicateCommands(matches);
     const result = dedupedMatches.slice(0, limit);
 
-    // logger.debug("Bash history search results:", { query, workdir: process.cwd(), originalCount: matches.length, dedupedCount: result.length });
+    logger.debug("Bash history search results:", {
+      query,
+      workdir: process.cwd(),
+      originalCount: matches.length,
+      dedupedCount: result.length,
+    });
 
     return result;
-  } catch {
-    // logger.debug("Failed to search bash history:", error);
+  } catch (error) {
+    logger.debug("Failed to search bash history:", error);
     return [];
   }
 };
@@ -226,9 +226,9 @@ const deduplicateCommands = (
     }
   }
 
-  // Sort by timestamp and return
+  // Sort by timestamp and return (new to old)
   return Array.from(commandMap.values()).sort(
-    (a, b) => a.timestamp - b.timestamp,
+    (a, b) => b.timestamp - a.timestamp,
   );
 };
 
@@ -247,13 +247,37 @@ export const getRecentBashCommands = (
 
     // Return recent commands after deduplication
     const deduped = deduplicateCommands(filtered);
-    return deduped.slice(-limit).reverse(); // Latest first
-  } catch {
-    // logger.debug("Failed to get recent bash commands:", error);
+    return deduped.slice(0, limit); // Latest first
+  } catch (error) {
+    logger.debug("Failed to get recent bash commands:", error);
     return [];
   }
 };
 
+/**
+ * Delete a specific command from bash history
+ */
+export const deleteBashCommandFromHistory = (
+  command: string,
+  workdir: string,
+): void => {
+  try {
+    const history = loadBashHistory();
+    const initialLength = history.commands.length;
+
+    history.commands = history.commands.filter(
+      (entry) => !(entry.command === command && entry.workdir === workdir),
+    );
+
+    if (history.commands.length !== initialLength) {
+      saveBashHistory(history);
+      logger.debug("Deleted bash command from history:", { command, workdir });
+    }
+  } catch (error) {
+    logger.debug("Failed to delete bash command from history:", error);
+  }
+};
+
 /**
  * Clear bash history
  */
@@ -264,9 +288,9 @@ export const clearBashHistory = (): void => {
       version: HISTORY_VERSION,
     };
     saveBashHistory(history);
-    // logger.debug("Bash history cleared");
-  } catch {
-    // logger.debug("Failed to clear bash history:", error);
+    logger.debug("Bash history cleared");
+  } catch (error) {
+    logger.debug("Failed to clear bash history:", error);
   }
 };
 
@@ -292,8 +316,8 @@ export const getBashCommandStats = (): {
       uniqueCommands: uniqueCommands.size,
       workdirs,
     };
-  } catch {
-    // logger.debug("Failed to get bash command stats:", error);
+  } catch (error) {
+    logger.debug("Failed to get bash command stats:", error);
     return {
       totalCommands: 0,
       uniqueCommands: 0,

package/src/utils/builtinSubagents.ts

@@ -0,0 +1,71 @@
+import type { SubagentConfiguration } from "./subagentParser.js";
+
+/**
+ * Get all built-in subagent configurations
+ * Built-in subagents have priority 3 (lowest) and can be overridden by user/project configs
+ */
+export function getBuiltinSubagents(): SubagentConfiguration[] {
+  return [
+    createExploreSubagent(),
+    // Add more built-in subagents here as needed
+  ];
+}
+
+/**
+ * Create the Explore built-in subagent configuration
+ * Specialized for codebase exploration and file search tasks
+ */
+function createExploreSubagent(): SubagentConfiguration {
+  const systemPrompt = `You are a file search specialist. You excel at thoroughly navigating and exploring codebases.
+
+=== CRITICAL: READ-ONLY MODE - NO FILE MODIFICATIONS ===
+This is a READ-ONLY exploration task. You are STRICTLY PROHIBITED from:
+- Creating new files (no Write, touch, or file creation of any kind)
+- Modifying existing files (no Edit operations)
+- Deleting files (no rm or deletion)
+- Moving or copying files (no mv or cp)
+- Creating temporary files anywhere, including /tmp
+- Using redirect operators (>, >>, |) or heredocs to write to files
+- Running ANY commands that change system state
+
+Your role is EXCLUSIVELY to search and analyze existing code. You do NOT have access to file editing tools - attempting to edit files will fail.
+
+Your strengths:
+- Rapidly finding files using glob patterns
+- Searching code and text with powerful regex patterns
+- Reading and analyzing file contents
+- Using Language Server Protocol (LSP) for deep code intelligence (definitions, references, etc.)
+
+Guidelines:
+- Use Glob for broad file pattern matching
+- Use Grep for searching file contents with regex
+- Use Read when you know the specific file path you need to read
+- Use LSP for code intelligence features like finding definitions, references, implementations, and symbols. This is especially useful for understanding complex code relationships.
+- Use Bash ONLY for read-only operations (ls, git status, git log, git diff, find, cat, head, tail)
+- NEVER use Bash for: mkdir, touch, rm, cp, mv, git add, git commit, npm install, pip install, or any file creation/modification
+- Adapt your search approach based on the thoroughness level specified by the caller
+- Return file paths as absolute paths in your final response
+- For clear communication, avoid using emojis
+- Communicate your final report directly as a regular message - do NOT attempt to create files
+
+NOTE: You are meant to be a fast agent that returns output as quickly as possible. In order to achieve this you must:
+- Make efficient use of the tools that you have at your disposal: be smart about how you search for files and implementations
+- Wherever possible you should try to spawn multiple parallel tool calls for grepping and reading files
+
+Complete the user's search request efficiently and report your findings clearly.`;
+
+  // Define allowed tools for read-only operations
+  const allowedTools = ["Glob", "Grep", "Read", "Bash", "LS", "LSP"];
+
+  return {
+    name: "Explore",
+    description:
+      'Fast agent specialized for exploring codebases. Use this when you need to quickly find files by patterns (eg. "src/components/**/*.tsx"), search code for keywords (eg. "API endpoints"), or answer questions about the codebase (eg. "how do API endpoints work?"). When calling this agent, specify the desired thoroughness level: "quick" for basic searches, "medium" for moderate exploration, or "very thorough" for comprehensive analysis across multiple locations and naming conventions.',
+    systemPrompt,
+    tools: allowedTools,
+    model: "fastModel", // Special value that will use parent's fastModel
+    filePath: "<builtin:Explore>",
+    scope: "builtin",
+    priority: 3, // Lowest priority - can be overridden by user configs
+  };
+}