wave-agent-sdk 0.10.4 → 0.11.1

package/src/builtin-skills/settings/SKILL.md

@@ -1,86 +0,0 @@
----
-name: settings
-description: Manage Wave settings and get guidance on settings.json
-allowed-tools: Bash, Read, Write
----
-
-# Wave Settings Skill
-
-This skill helps you manage your Wave configuration and provides guidance on how to use `settings.json`.
-
-## What is `settings.json`?
-
-`settings.json` is the central configuration file for Wave. It allows you to customize hooks, environment variables, tool permissions, and more.
-
-Wave looks for `settings.json` in three scopes:
-1.  **User Scope**: Global settings for all projects. Located at `~/.wave/settings.json`.
-2.  **Project Scope**: Settings specific to the current project. Located at `.wave/settings.json` in your project root.
-3.  **Local Scope**: Local overrides for the current project (not committed to git). Located at `.wave/settings.local.json`.
-
-## Common Settings
-
-### 1. Hooks
-Hooks allow you to automate tasks when certain events occur (e.g., `WorktreeCreate`, `TaskStart`).
-For detailed hook configuration, see [HOOKS.md](${WAVE_SKILL_DIR}/HOOKS.md).
-
-### 2. Environment Variables
-Set environment variables that will be available to all tools and hooks.
-```json
-{
-  "env": {
-    "NODE_ENV": "development",
-    "API_KEY": "your-api-key"
-  }
-}
-```
-
-### 3. Permissions
-Manage tool permissions and define the "Safe Zone".
-```json
-{
-  "permissions": {
-    "allow": ["Bash", "Read"],
-    "deny": ["Write"],
-    "defaultMode": "interactive",
-    "additionalDirectories": ["/tmp/wave-exports"]
-  }
-}
-```
-
-### 4. Enabled Plugins
-Enable or disable specific plugins.
-```json
-{
-  "enabledPlugins": {
-    "git-plugin": true,
-    "experimental-plugin": false
-  }
-}
-```
-
-### 5. Model and Token Configuration
-Define which AI models Wave should use and set token limits via environment variables.
-```json
-{
-  "env": {
-    "WAVE_MODEL": "gemini-3-flash",
-    "WAVE_FAST_MODEL": "gemini-2.5-flash",
-    "WAVE_MAX_INPUT_TOKENS": "100000",
-    "WAVE_MAX_OUTPUT_TOKENS": "4096"
-  }
-}
-```
-
-### 6. Other Settings
-- `language`: Preferred language for agent communication (e.g., `"en"`, `"zh"`).
-- `autoMemoryEnabled`: Enable or disable auto-memory (default: `true`).
-
-## How to use this skill
-
-You can ask me to:
-- "Show my current settings"
-- "Update my project settings to enable auto-memory"
-- "How do I configure a post-commit hook?"
-- "What are the available permission modes?"
-
-I will guide you through the process and ensure your configuration is valid.

package/src/utils/builtinSubagents.ts

@@ -1,122 +0,0 @@
-import {
-  BASH_SUBAGENT_TYPE,
-  EXPLORE_SUBAGENT_TYPE,
-  PLAN_SUBAGENT_TYPE,
-  GENERAL_PURPOSE_SUBAGENT_TYPE,
-} from "../constants/subagents.js";
-import {
-  BASH_SUBAGENT_SYSTEM_PROMPT,
-  GENERAL_PURPOSE_SYSTEM_PROMPT,
-  PLAN_SUBAGENT_SYSTEM_PROMPT,
-  EXPLORE_SUBAGENT_SYSTEM_PROMPT,
-} from "../prompts/index.js";
-import {
-  BASH_TOOL_NAME,
-  GLOB_TOOL_NAME,
-  GREP_TOOL_NAME,
-  READ_TOOL_NAME,
-  LSP_TOOL_NAME,
-} from "../constants/tools.js";
-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 [
-    createBashSubagent(),
-    createExploreSubagent(),
-    createGeneralPurposeSubagent(),
-    createPlanSubagent(),
-    // Add more built-in subagents here as needed
-  ];
-}
-
-/**
- * Create the Bash built-in subagent configuration
- * Specialized for executing bash commands and git operations
- */
-function createBashSubagent(): SubagentConfiguration {
-  return {
-    name: BASH_SUBAGENT_TYPE,
-    description:
-      "Command execution specialist for running bash commands. Use this for git operations, command execution, and other terminal tasks.",
-    systemPrompt: BASH_SUBAGENT_SYSTEM_PROMPT,
-    tools: [BASH_TOOL_NAME],
-    model: "inherit",
-    filePath: `<builtin:${BASH_SUBAGENT_TYPE}>`,
-    scope: "builtin",
-    priority: 3,
-  };
-}
-
-/**
- * Create the General-Purpose built-in subagent configuration
- * Specialized for multi-step research and implementation tasks
- */
-function createGeneralPurposeSubagent(): SubagentConfiguration {
-  return {
-    name: GENERAL_PURPOSE_SUBAGENT_TYPE,
-    description:
-      "General-purpose agent for researching complex questions, searching for code, and executing multi-step tasks. When you are searching for a keyword or file and are not confident that you will find the right match in the first few tries use this agent to perform the search for you.",
-    systemPrompt: GENERAL_PURPOSE_SYSTEM_PROMPT,
-    filePath: `<builtin:${GENERAL_PURPOSE_SUBAGENT_TYPE}>`,
-    scope: "builtin",
-    priority: 3,
-  };
-}
-
-/**
- * Create the Explore built-in subagent configuration
- * Specialized for codebase exploration and file search tasks
- */
-function createExploreSubagent(): SubagentConfiguration {
-  // Define allowed tools for read-only operations
-  const allowedTools = [
-    GLOB_TOOL_NAME,
-    GREP_TOOL_NAME,
-    READ_TOOL_NAME,
-    BASH_TOOL_NAME,
-    LSP_TOOL_NAME,
-  ];
-
-  return {
-    name: EXPLORE_SUBAGENT_TYPE,
-    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: EXPLORE_SUBAGENT_SYSTEM_PROMPT,
-    tools: allowedTools,
-    model: "fastModel", // Special value that will use parent's fastModel
-    filePath: `<builtin:${EXPLORE_SUBAGENT_TYPE}>`,
-    scope: "builtin",
-    priority: 3, // Lowest priority - can be overridden by user configs
-  };
-}
-
-/**
- * Create the Plan built-in subagent configuration
- * Specialized for designing implementation plans and exploring codebases in read-only mode
- */
-function createPlanSubagent(): SubagentConfiguration {
-  // Define allowed tools for read-only operations
-  const allowedTools = [
-    GLOB_TOOL_NAME,
-    GREP_TOOL_NAME,
-    READ_TOOL_NAME,
-    BASH_TOOL_NAME,
-    LSP_TOOL_NAME,
-  ];
-
-  return {
-    name: PLAN_SUBAGENT_TYPE,
-    description:
-      "Software architect agent for designing implementation plans. Use this when you need to plan the implementation strategy for a task. Returns step-by-step plans, identifies critical files, and considers architectural trade-offs.",
-    systemPrompt: PLAN_SUBAGENT_SYSTEM_PROMPT,
-    tools: allowedTools,
-    model: "inherit", // Uses parent agent's model
-    filePath: `<builtin:${PLAN_SUBAGENT_TYPE}>`,
-    scope: "builtin",
-    priority: 3, // Lowest priority - can be overridden by user configs
-  };
-}