wave-agent-sdk 1.1.4 → 1.2.0

package/dist/agent.d.ts

@@ -1,11 +1,12 @@
 import { type QueuedMessage } from "./managers/messageQueue.js";
 import { SlashCommand, CustomSlashCommand, AgentOptions } from "./types/index.js";
 import type { Message, McpServerStatus, GatewayConfig, ModelConfig, Usage, PermissionMode, ForegroundTask, SkillMetadata } from "./types/index.js";
+import type { HookEvent, HookEventConfig } from "./types/hooks.js";
 import type { WorktreeSession } from "./utils/worktreeSession.js";
 export declare class Agent {
     private messageManager;
     private aiManager;
-    private bangManager;
+    private bashModeManager;
     private backgroundTaskManager;
     private logger?;
     private toolManager;
@@ -31,6 +32,8 @@ export declare class Agent {
     private taskManager;
     private foregroundTaskManager;
     private container;
+    /** Unregister module-level listeners registered during container setup; invoked at the end of destroy(). */
+    private teardown;
     private configurationService;
     private workdir;
     private systemPrompt?;
@@ -63,6 +66,10 @@ export declare class Agent {
     private constructor();
     get sessionId(): string;
     get messages(): Message[];
+    /** Full UI display message stream (includes pre-compaction history).
+     * Consumed by hosts for the full-list message view (getMessages RPC,
+     * CLI structural refresh); the API context stays on `messages`. */
+    get displayMessages(): Message[];
     get usages(): Usage[];
     get sessionFilePath(): string;
     get latestTotalTokens(): number;
@@ -85,6 +92,21 @@ export declare class Agent {
     get userMemory(): string;
     /** Get combined memory content (project + user + modular rules) */
     getCombinedMemory(): Promise<string>;
+    /**
+     * Read the user-level memory file (~/.wave/AGENTS.md). Unlike the cached
+     * `userMemory` getter this always reads fresh content (the settings UI edits
+     * the file while the agent may already hold a cache).
+     */
+    readUserMemoryContent(): Promise<string>;
+    /**
+     * Read the project-level memory file (<workdir>/AGENTS.md, CLAUDE.md
+     * fallback). Always reads fresh content for the settings UI.
+     */
+    readProjectMemoryContent(workdir: string): Promise<string>;
+    /** Persist the user-level memory file (~/.wave/AGENTS.md). */
+    writeUserMemoryContent(content: string): Promise<void>;
+    /** Persist the project-level memory file (<workdir>/AGENTS.md). */
+    writeProjectMemoryContent(workdir: string, content: string): Promise<void>;
     /** Get AI loading status */
     get isLoading(): boolean;
     /** Get message compaction status */
@@ -227,7 +249,7 @@ export declare class Agent {
      */
     restoreSession(sessionId: string): Promise<void>;
     abortAIMessage(): void;
-    /** Execute bash command (bang command) */
+    /** Execute a bash-mode command (`!command`) */
     bang(command: string): Promise<void>;
     clearMessages(): Promise<void>;
     /**
@@ -272,28 +294,6 @@ export declare class Agent {
      * @returns Promise that resolves to the AI's answer
      */
     askBtw(question: string, abortSignal?: AbortSignal, onContent?: (content: string) => void, onReasoning?: (content: string) => void): Promise<string>;
-    /**
-     * Start a fork subagent in the background (the "/subtask" command path).
-     *
-     * The fork inherits the parent's full conversation context — same system
-     * prompt, tools, model, and message prefix — so the prompt cache is reused,
-     * then works independently in the background. On completion its final
-     * response is delivered back to the main conversation as a task notification
-     * carrying the `<result>` tag. Recursion is prevented inside the fork (the
-     * Agent tool and Task tools are denied).
-     *
-     * @param prompt - The task description for the fork subagent
-     * @param options - Background task label and optional loose turn bound
-     * @param options.description - Display label for the background task
-     * @param options.maxTurns - Loose turn bound (defaults to 200, aligned with
-     * Claude Code's fork subagent)
-     * @param abortSignal - Optional signal to abort the fork
-     * @returns Promise that resolves to the background task ID
-     */
-    forkSubagent(prompt: string, options: {
-        description: string;
-        maxTurns?: number;
-    }, abortSignal?: AbortSignal): Promise<string>;
     /**
      * Send a message to the AI agent with optional images
      *
@@ -349,6 +349,15 @@ export declare class Agent {
     connectMcpServer(serverName: string): Promise<boolean>;
     /** Disconnect MCP server */
     disconnectMcpServer(serverName: string): Promise<boolean>;
+    /**
+     * Remove an MCP server from a persisted config file (user ~/.wave/mcp.json
+     * or project <workdir>/.mcp.json), then disconnect and drop it from memory.
+     */
+    removeMcpServer(scope: "user" | "project", serverName: string): Promise<boolean>;
+    /** The user-level MCP config path (~/.wave/mcp.json) */
+    getUserMcpConfigPath(): string;
+    /** The project-level MCP config path (<workdir>/.mcp.json) */
+    getProjectMcpConfigPath(): string;
     /** Get all available slash commands */
     getSlashCommands(): SlashCommand[];
     /** Check if slash command exists */
@@ -393,6 +402,14 @@ export declare class Agent {
      * Get the current plan file path (for testing and UI)
      */
     getPlanFilePath(): string | undefined;
+    /**
+     * Resolve once the plan file path has been generated and set after entering
+     * plan mode. Resolves `undefined` when no generation is in flight.
+     * Used by the CLI /plan command and the stdio getPlanFile RPC to avoid
+     * querying the model before the path is known (the plan mode reminder needs
+     * the path to be set).
+     */
+    awaitPlanFilePath(): Promise<string | undefined>;
     /**
      * Get all currently allowed rules (user-defined and default)
      */
@@ -428,6 +445,37 @@ export declare class Agent {
      * @returns The list of skill metadata
      */
     getSkillMetadata(): SkillMetadata[];
+    /**
+     * Delete a user/personal or project skill by removing its directory.
+     * Builtin and plugin skills are read-only and cannot be deleted.
+     * @param name - The skill name as shown in skill metadata
+     * @returns true if the skill was deleted
+     */
+    deleteSkill(name: string): Promise<boolean>;
+    /**
+     * Delete a user-level or project-level subagent by removing its markdown
+     * file. Builtin and plugin agents are read-only and cannot be deleted.
+     * @param name - The subagent name as shown in configurations
+     * @returns true if the subagent was deleted
+     */
+    deleteSubagent(name: string): Promise<boolean>;
+    /**
+     * Get hook configurations at a specific scope (user or project settings.json;
+     * plugin hooks come from the hook manager's plugin-registered set).
+     */
+    getHooksByScope(scope: "user" | "project" | "plugin"): Promise<Partial<Record<HookEvent, HookEventConfig[]>>>;
+    /**
+     * Absolute path of the settings.json holding hooks at `scope` — user
+     * `~/.wave/settings.json` or project `<workdir>/.wave/settings.json`. Hosts
+     * pass it to the GUI so editors / file panels can open the file (they cannot
+     * expand `~`).
+     */
+    getHookConfigPath(scope: "user" | "project"): string;
+    /**
+     * Delete a hook at a specific scope, identified by hookName of the form
+     * `Event:Matcher`.
+     */
+    deleteHook(scope: "user" | "project", hookName: string): Promise<void>;
     /**
      * Get currently active subagent instances (status active/initializing).
      * @returns The list of active subagent instances

package/dist/agent.js

@@ -51,11 +51,13 @@ export class Agent {
      * @param options - Configuration options for the Agent instance
      */
     constructor(options) {
-        this.bangManager = null;
+        this.bashModeManager = null;
         this.dispatchPromise = null; // Track current dispatch for teardown
         this.isAborting = false; // Transient guard: prevents tryDispatch from firing during abortMessage (reset when the abort completes)
         this.isDestroyed = false; // Terminal guard: set in destroy(), never reset — no dispatch may ever start after destroy
         this.dispatchAborted = false; // Set on abort while a dispatch is running: suppress the .finally re-check so preserved notifications don't get dispatched after abort
+        /** Unregister module-level listeners registered during container setup; invoked at the end of destroy(). */
+        this.teardown = () => { };
         this.sessionStartTime = Date.now();
         const { logger, workdir, systemPrompt, stream = true } = options;
         // Set working directory early as we need it for loading configuration
@@ -68,7 +70,7 @@ export class Agent {
         this.stream = stream; // Save streaming mode flag
         // Store options for dynamic configuration resolution
         this.options = options;
-        this.container = setupAgentContainer({
+        const { container, teardown } = setupAgentContainer({
             options,
             workdir: this.workdir,
             configurationService: this.configurationService,
@@ -92,6 +94,8 @@ export class Agent {
             addPermissionRule: (rule) => this.addPermissionRule(rule),
             addUsage: (usage) => this.messageManager.addUsage(usage),
         });
+        this.container = container;
+        this.teardown = teardown;
         // Retrieve managers from container
         this.foregroundTaskManager = this.container.get("ForegroundTaskManager");
         this.memoryRuleManager = this.container.get("MemoryRuleManager");
@@ -111,7 +115,7 @@ export class Agent {
         this.aiManager = this.container.get("AIManager");
         this.slashCommandManager = this.container.get("SlashCommandManager");
         this.pluginManager = this.container.get("PluginManager");
-        this.bangManager = this.container.get("BangManager");
+        this.bashModeManager = this.container.get("BashModeManager");
         this.cronManager = this.container.get("CronManager");
         this.messageQueue = this.container.get("MessageQueue");
         this.asyncWorkRegistry = this.container.get("AsyncWorkRegistry");
@@ -131,7 +135,7 @@ export class Agent {
                 this.tryDispatch();
         };
         // Wire up bang manager callback for command running changes
-        this.bangManager.onCommandRunningChange = (running) => {
+        this.bashModeManager.onCommandRunningChange = (running) => {
             this.options.callbacks?.onCommandRunningChange?.(running);
             if (!running)
                 this.tryDispatch();
@@ -148,6 +152,12 @@ export class Agent {
     get messages() {
         return this.messageManager.getMessages();
     }
+    /** Full UI display message stream (includes pre-compaction history).
+     * Consumed by hosts for the full-list message view (getMessages RPC,
+     * CLI structural refresh); the API context stays on `messages`. */
+    get displayMessages() {
+        return this.messageManager.getDisplayMessages();
+    }
     get usages() {
         return this.messageManager.getUsages();
     }
@@ -192,6 +202,33 @@ export class Agent {
     async getCombinedMemory() {
         return this.messageManager.getCombinedMemory();
     }
+    /**
+     * Read the user-level memory file (~/.wave/AGENTS.md). Unlike the cached
+     * `userMemory` getter this always reads fresh content (the settings UI edits
+     * the file while the agent may already hold a cache).
+     */
+    async readUserMemoryContent() {
+        const memoryService = this.container.get("MemoryService");
+        return (await memoryService?.getUserMemoryContent()) ?? "";
+    }
+    /**
+     * Read the project-level memory file (<workdir>/AGENTS.md, CLAUDE.md
+     * fallback). Always reads fresh content for the settings UI.
+     */
+    async readProjectMemoryContent(workdir) {
+        const memoryService = this.container.get("MemoryService");
+        return (await memoryService?.readMemoryFile(workdir)) ?? "";
+    }
+    /** Persist the user-level memory file (~/.wave/AGENTS.md). */
+    async writeUserMemoryContent(content) {
+        const memoryService = this.container.get("MemoryService");
+        await memoryService?.writeUserMemoryContent(content);
+    }
+    /** Persist the project-level memory file (<workdir>/AGENTS.md). */
+    async writeProjectMemoryContent(workdir, content) {
+        const memoryService = this.container.get("MemoryService");
+        await memoryService?.writeProjectMemoryContent(workdir, content);
+    }
     /** Get AI loading status */
     get isLoading() {
         return this.aiManager.isLoading;
@@ -202,7 +239,7 @@ export class Agent {
     }
     /** Get bash command execution status */
     get isCommandRunning() {
-        return this.bangManager?.isCommandRunning ?? false;
+        return this.bashModeManager?.isCommandRunning ?? false;
     }
     /** Get queued user-facing messages (excludes background notifications) */
     get queuedMessages() {
@@ -313,7 +350,7 @@ export class Agent {
         this.messageQueue.transitionTo("running");
         this.options.callbacks?.onQueuedMessagesChange?.(this.queuedMessages);
         if (next.type === "bang") {
-            await this.bangManager?.executeCommand(next.content);
+            await this.bashModeManager?.executeCommand(next.content);
             await this.messageManager.saveSession();
         }
         else if (next.type === "notification") {
@@ -512,7 +549,7 @@ export class Agent {
     abortAIMessage() {
         this.aiManager.abortAIMessage();
     }
-    /** Execute bash command (bang command) */
+    /** Execute a bash-mode command (`!command`) */
     async bang(command) {
         this.assertNotDestroyed();
         // If the agent is busy, enqueue the bang command
@@ -521,7 +558,7 @@ export class Agent {
             this.options.callbacks?.onQueuedMessagesChange?.(this.queuedMessages);
             return;
         }
-        await this.bangManager?.executeCommand(command);
+        await this.bashModeManager?.executeCommand(command);
         await this.messageManager.saveSession();
     }
     async clearMessages() {
@@ -616,7 +653,7 @@ export class Agent {
     }
     /** Interrupt bash command execution */
     abortBashCommand() {
-        this.bangManager?.abortCommand();
+        this.bashModeManager?.abortCommand();
     }
     /** Interrupt slash command execution */
     abortSlashCommand() {
@@ -717,6 +754,14 @@ export class Agent {
         if (!drained) {
             this.logger?.error(`Async work did not drain: ${this.asyncWorkRegistry.size} live work item(s) remain after destroy`);
         }
+        // Unregister module-level listeners (remote settings hot-update, auth
+        // change) so the agent's object graph becomes collectable. Without this,
+        // the module-level callback arrays pin every created agent via the
+        // per-agent closure contexts, even after the host drops its references.
+        this.teardown();
+        // Break the DI container's internal references (services/factories) so no
+        // per-agent manager is retained through it after destroy.
+        this.container.clear();
     }
     /**
      * Trigger the rewind UI callback
@@ -741,28 +786,6 @@ export class Agent {
         const result = await this.aiManager.runBtwFork(question, abortSignal, onContent, onReasoning);
         return result.content ?? result.error ?? "No response received";
     }
-    /**
-     * Start a fork subagent in the background (the "/subtask" command path).
-     *
-     * The fork inherits the parent's full conversation context — same system
-     * prompt, tools, model, and message prefix — so the prompt cache is reused,
-     * then works independently in the background. On completion its final
-     * response is delivered back to the main conversation as a task notification
-     * carrying the `<result>` tag. Recursion is prevented inside the fork (the
-     * Agent tool and Task tools are denied).
-     *
-     * @param prompt - The task description for the fork subagent
-     * @param options - Background task label and optional loose turn bound
-     * @param options.description - Display label for the background task
-     * @param options.maxTurns - Loose turn bound (defaults to 200, aligned with
-     * Claude Code's fork subagent)
-     * @param abortSignal - Optional signal to abort the fork
-     * @returns Promise that resolves to the background task ID
-     */
-    async forkSubagent(prompt, options, abortSignal) {
-        this.assertNotDestroyed();
-        return this.aiManager.runForkSubagent(prompt, options, abortSignal);
-    }
     /**
      * Send a message to the AI agent with optional images
      *
@@ -864,6 +887,21 @@ export class Agent {
     async disconnectMcpServer(serverName) {
         return await this.mcpManager.disconnectServer(serverName);
     }
+    /**
+     * Remove an MCP server from a persisted config file (user ~/.wave/mcp.json
+     * or project <workdir>/.mcp.json), then disconnect and drop it from memory.
+     */
+    async removeMcpServer(scope, serverName) {
+        return await this.mcpManager.removeServerFromConfig(scope, serverName);
+    }
+    /** The user-level MCP config path (~/.wave/mcp.json) */
+    getUserMcpConfigPath() {
+        return this.mcpManager.getUserConfigPath();
+    }
+    /** The project-level MCP config path (<workdir>/.mcp.json) */
+    getProjectMcpConfigPath() {
+        return this.mcpManager.getProjectConfigPath();
+    }
     // ========== Slash Command Management Methods ==========
     /** Get all available slash commands */
     getSlashCommands() {
@@ -939,6 +977,16 @@ export class Agent {
     getPlanFilePath() {
         return this.permissionManager.getPlanFilePath();
     }
+    /**
+     * Resolve once the plan file path has been generated and set after entering
+     * plan mode. Resolves `undefined` when no generation is in flight.
+     * Used by the CLI /plan command and the stdio getPlanFile RPC to avoid
+     * querying the model before the path is known (the plan mode reminder needs
+     * the path to be set).
+     */
+    awaitPlanFilePath() {
+        return this.planManager.awaitPlanFilePath();
+    }
     /**
      * Get all currently allowed rules (user-defined and default)
      */
@@ -991,6 +1039,50 @@ export class Agent {
     getSkillMetadata() {
         return this.skillManager.getAvailableSkills();
     }
+    /**
+     * Delete a user/personal or project skill by removing its directory.
+     * Builtin and plugin skills are read-only and cannot be deleted.
+     * @param name - The skill name as shown in skill metadata
+     * @returns true if the skill was deleted
+     */
+    async deleteSkill(name) {
+        return await this.skillManager.deleteSkill(name);
+    }
+    /**
+     * Delete a user-level or project-level subagent by removing its markdown
+     * file. Builtin and plugin agents are read-only and cannot be deleted.
+     * @param name - The subagent name as shown in configurations
+     * @returns true if the subagent was deleted
+     */
+    async deleteSubagent(name) {
+        return await this.subagentManager.deleteSubagent(name);
+    }
+    /**
+     * Get hook configurations at a specific scope (user or project settings.json;
+     * plugin hooks come from the hook manager's plugin-registered set).
+     */
+    async getHooksByScope(scope) {
+        if (scope === "plugin") {
+            return this.hookManager.getPluginHooks();
+        }
+        return await this.configurationService.getHooksByScope(this.workdir, scope);
+    }
+    /**
+     * Absolute path of the settings.json holding hooks at `scope` — user
+     * `~/.wave/settings.json` or project `<workdir>/.wave/settings.json`. Hosts
+     * pass it to the GUI so editors / file panels can open the file (they cannot
+     * expand `~`).
+     */
+    getHookConfigPath(scope) {
+        return this.configurationService.getHookConfigPath(this.workdir, scope);
+    }
+    /**
+     * Delete a hook at a specific scope, identified by hookName of the form
+     * `Event:Matcher`.
+     */
+    async deleteHook(scope, hookName) {
+        await this.configurationService.deleteHook(this.workdir, scope, hookName);
+    }
     /**
      * Get currently active subagent instances (status active/initializing).
      * @returns The list of active subagent instances

package/dist/builtin/plugins.js

@@ -41,6 +41,9 @@ const guidance = [
   "- 边界模糊时也先写 spec 草稿请用户确认，不要直接改代码。",
   "- 规格编写技能（specify）由 AI 自动触发：对话中涉及新需求或需求变更时主动创建或更新规格文件，不需要用户手动调用（不出现在斜杠命令列表中）。",
   \`- 新增或修改 spec 后运行校验：\${specCount}（自动检测 docs/specs/，否则 specs/，否则退出）。\`,
+  "- 规格确认与阶段衔接一次完成：通过 AskUserQuestion 单选让用户点击决策（选项只传「直接实现 / 制定技术方案」，并在问题文案中说明如需调整规格可选「其他」输入修改意见；「其他」由 AskUserQuestion 自动附加，勿手动添加；选「其他」=规格需调整，按反馈修改后再次询问）。",
+  "- 可选技术方案阶段：制定技术方案并批准后再编码；也可跳过——最短流程=规格+编码，最长=规格+技术方案+编码。",
+  "- 用 task 工具追踪进度：规格、技术方案、编码各阶段开始前用 TaskCreate 创建任务并标记进行中（TaskUpdate），完成/批准/确认后标记完成，让用户在任务列表中看到当前所处阶段。",
 ].join("\\n");
 
 // JSON form → parsed as hookSpecificOutput.additionalContext by the hook manager.
@@ -128,7 +131,7 @@ if (warnings.length) {
 `,
     "plugins/sdd/skills/specify/SKILL.md": `---
 name: specify
-description: 根据自然语言描述创建或更新功能规格说明，生成包含用户故事与验收场景的规格文件。
+description: 根据自然语言描述创建或更新功能规格说明，并通过单选衔接可选技术方案与编码阶段。
 user-invocable: false
 ---
 
@@ -144,6 +147,8 @@ $ARGUMENTS
 
 根据对话中的功能描述，执行以下步骤：
 
+0. **创建进度任务**：用 TaskCreate 创建「编写功能规格」任务，并用 TaskUpdate 标记进行中。后续每个阶段（技术方案、编码）同样在开始前创建任务、结束后更新状态，让用户在任务列表中看到当前进度。
+
 1. **确定规格文件路径**：
    - **确定规格根目录**：优先复用项目中已有的规格目录——若 \`docs/specs/\` 存在则用之，否则若 \`specs/\` 存在则用之，否则默认 \`specs/\`（并在完成报告中说明所选目录，便于用户纠正）。
    - **选择分组**：若规格目录下已有分组子目录，沿用其既有分组约定；否则默认扁平结构（直接放在规格根目录下）。
@@ -165,7 +170,17 @@ $ARGUMENTS
    - 将每个标记作为问题展示，附带建议答案
    - 等待用户回复后更新规格文件
 
-5. 报告完成，输出规格文件路径。
+5. **校验并确认规格**：
+   - 运行会话引导中给出的 spec-count 校验命令（自动检测 docs/specs/，否则 specs/，否则跳过）
+   - 输出规格文件路径，并通过 AskUserQuestion 单选请求决策（选项只传：直接实现 / 制定技术方案；AskUserQuestion 会自动附加「其他」选项，勿手动添加「其他」；在问题文案中说明如需调整规格可选「其他」并输入修改意见）
+   - 用户选「其他」并输入意见 → 视为规格需要调整：按用户反馈更新规格后重新校验，并再次单选
+   - 选「直接实现」→ 将「编写功能规格」任务标记完成，进入编码阶段
+   - 选「制定技术方案」→ 将「编写功能规格」任务标记完成；用 TaskCreate 创建「制定技术方案」任务并标记进行中；调用 EnterPlanMode 进入技术方案模式，制定技术方案（技术选型、架构设计、实现步骤）并写入计划文件；用 ExitPlanMode 请求批准——被拒绝则按反馈更新方案后重新请求，批准后标记任务完成
+
+6. **编码阶段**：
+   - 用 TaskCreate 创建「实现功能」任务并标记进行中
+   - 按已确认的规格实现；若批准了技术方案则遵循其架构
+   - 实现完成后将任务标记完成
 
 ## 指南
 

package/dist/builtin/skills/settings.js

@@ -702,7 +702,7 @@ You can extend the Safe Zone by adding \`additionalDirectories\` to your \`permi
 
 ## Permission Modes
 
-The \`permissionMode\` setting determines how Wave handles requests to use restricted tools (e.g., \`Bash\`, \`Edit\`, \`Write\`, \`AskUserQuestion\`).
+The \`defaultMode\` setting (under \`permissions\`, aligning with Claude Code's settings key) determines how Wave handles requests to use restricted tools (e.g., \`Bash\`, \`Edit\`, \`Write\`, \`AskUserQuestion\`).
 
 | Mode | Description |
 | :--- | :--- |
@@ -717,7 +717,7 @@ The \`permissionMode\` setting determines how Wave handles requests to use restr
 \`\`\`json
 {
   "permissions": {
-    "permissionMode": "default",
+    "defaultMode": "default",
     "additionalDirectories": ["/home/user/my-exports"],
     "allow": ["ls -R", "git status"],
     "deny": ["rm -rf"]
@@ -735,7 +735,7 @@ You can pre-approve or explicitly forbid specific operations using \`allow\` and
 When a tool is called, Wave checks:
 1. If the operation matches a \`deny\` rule, it is rejected.
 2. If the operation matches an \`allow\` rule, it is permitted.
-3. If no rules match, the behavior depends on the \`permissionMode\`.
+3. If no rules match, the behavior depends on the \`defaultMode\`.
 
 ### Rule Syntax
 
@@ -998,7 +998,7 @@ For detailed permission configuration and available permission modes, see [PERMI
   "permissions": {
     "allow": ["Bash", "Read"],
     "deny": ["Write"],
-    "permissionMode": "default",
+    "defaultMode": "default",
     "additionalDirectories": ["/tmp/wave-exports"]
   }
 }
@@ -1104,10 +1104,6 @@ The \`SKILL.md\` file uses YAML frontmatter for configuration and Markdown for i
 ---
 name: my-skill
 description: A brief description of what the skill does.
-context: fork
-allowed-tools:
-  - Bash
-  - Read
 ---
 
 # My Skill Instructions
@@ -1117,6 +1113,8 @@ When this skill is invoked, follow these steps:
 2. Use the \`Bash\` tool to run \`npm test\`.
 \`\`\`
 
+By default, new skills only include \`name\` and \`description\`. Only add \`context: fork\` or \`allowed-tools\` when the user explicitly asks for them.
+
 ### YAML Frontmatter Fields
 
 - \`name\`: (Required) Unique identifier (lowercase, numbers, hyphens).

package/dist/core/plugin.d.ts

@@ -56,6 +56,10 @@ export declare class PluginCore {
     removeMarketplace(name: string, scope?: Scope): Promise<void>;
     /**
      * Updates a specific marketplace or all marketplaces
+     *
+     * Pulls the latest marketplace source and reinstalls any plugins that are
+     * already installed from it, so a manual "update marketplace" also brings
+     * installed plugins up to date (mirrors Claude Code's refresh-and-bump).
      */
     updateMarketplace(name?: string): Promise<void>;
     /**

package/dist/core/plugin.js

@@ -121,9 +121,15 @@ export class PluginCore {
     }
     /**
      * Updates a specific marketplace or all marketplaces
+     *
+     * Pulls the latest marketplace source and reinstalls any plugins that are
+     * already installed from it, so a manual "update marketplace" also brings
+     * installed plugins up to date (mirrors Claude Code's refresh-and-bump).
      */
     async updateMarketplace(name) {
-        await this.marketplaceService.updateMarketplace(name);
+        await this.marketplaceService.updateMarketplace(name, {
+            updatePlugins: true,
+        });
     }
     /**
      * Lists all registered marketplaces

package/dist/index.d.ts

@@ -25,7 +25,8 @@ export * from "./utils/nameGenerator.js";
 export * from "./utils/pathEncoder.js";
 export * from "./utils/worktreeSession.js";
 export * from "./utils/worktreeUtils.js";
-export { loadMergedWaveConfig, loadUserConfigEnv, } from "./services/configurationService.js";
+export { loadMergedWaveConfig, loadUserConfigEnv, loadWaveConfigFromFile, } from "./services/configurationService.js";
+export { getUserConfigPaths, getProjectConfigPaths, } from "./utils/configPaths.js";
 export * from "./types/index.js";
 export type { SubagentConfiguration } from "./utils/subagentParser.js";
 export type { SubagentInstance } from "./managers/subagentManager.js";

package/dist/index.js

@@ -29,7 +29,8 @@ export * from "./utils/nameGenerator.js";
 export * from "./utils/pathEncoder.js";
 export * from "./utils/worktreeSession.js";
 export * from "./utils/worktreeUtils.js";
-export { loadMergedWaveConfig, loadUserConfigEnv, } from "./services/configurationService.js";
+export { loadMergedWaveConfig, loadUserConfigEnv, loadWaveConfigFromFile, } from "./services/configurationService.js";
+export { getUserConfigPaths, getProjectConfigPaths, } from "./utils/configPaths.js";
 export * from "./types/index.js";
 // Export tool building utilities
 export * from "./tools/buildTool.js";

package/dist/managers/aiManager.d.ts

@@ -189,30 +189,6 @@ export declare class AIManager {
         deniedToolMessage?: string;
         maxTurns?: number;
     }, abortSignal?: AbortSignal): Promise<ForkLoopResult>;
-    /**
-     * Fork subagent ("/subtask"): spawn a background agent that inherits the
-     * parent's full conversation context — the same system prompt, tools, model,
-     * and message prefix as the main loop — so the forked request prefix matches
-     * exactly and the prompt cache is reused. The fork runs to completion in the
-     * background via the shared BackgroundTaskManager (visible in /tasks, log at
-     * `os.tmpdir()/wave-subagent-<taskId>.log`); its final response is enqueued
-     * as a task notification carrying the `<result>` tag, so the main agent
-     * picks it up on the next turn and can act on it.
-     *
-     * Recursion is prevented by denying the Agent tool and the Task management
-     * tools (the fork cannot spawn further subagents or mutate the shared task
-     * list), and by honoring the parent's denied rules for everything else.
-     * Gate-approved tools execute locally in the stripped fork context (no
-     * permission prompts), mirroring the other fork paths.
-     *
-     * Returns the background task ID (empty string when no BackgroundTaskManager
-     * is registered, in which case the fork still runs but without task
-     * bookkeeping or notification).
-     */
-    runForkSubagent(prompt: string, options: {
-        description: string;
-        maxTurns?: number;
-    }, abortSignal?: AbortSignal): Promise<string>;
     /**
      * Parse a fork tool call's JSON arguments, recovering truncated JSON the
      * same way the main loop does. Unparseable arguments fall back to `{}` and