wave-agent-sdk 1.1.5 → 1.3.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 { Message, McpServerStatus, GatewayConfig, ModelConfig, Usage, PermissionMode, ForegroundTask, SkillMetadata, PluginReloadResult } 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;
@@ -42,12 +43,39 @@ export declare class Agent {
     getGatewayConfig(): GatewayConfig;
     getModelConfig(): ModelConfig;
     getMaxInputTokens(): number;
-    getLanguage(): string | undefined;
+    getLanguage(): string;
+    /**
+     * Re-read the merged configuration (user/project/local settings.json + remote
+     * managed settings) and apply it to this session **without rebuilding it**:
+     * hooks / permissions / env follow immediately, the settings.json-derived
+     * values the running turn reads are re-pinned at the next turn start.
+     *
+     * THE save path calls this explicitly after writing the user-level
+     * settings.json: that file is commonly *created* by that very write, so the
+     * file watcher — armed at session start on a path that did not exist yet —
+     * must not be the only trigger (docs/specs/core/agent-config.md
+     * 「设置实时重载」). Idempotent with the watcher (a concurrent reload is
+     * de-duplicated).
+     */
+    reloadConfiguration(): Promise<void>;
+    /**
+     * Re-read every plugin from disk and swap its contribution into this running
+     * session in place — the `/reload-plugins` command. Commands, skills,
+     * agents, hooks, MCP servers and LSP servers all follow; the session itself
+     * (sessionId, transcript, in-flight work) is untouched, so this is not a
+     * rebuild. Every live session in the process must call this to see the new
+     * state; sessions created afterwards pick it up from disk on their own.
+     *
+     * Busts the prompt cache for the tool-schema prefix (the skill and agent
+     * lists are inlined) — deliberately accepted, see
+     * docs/specs/ecosystem/plugin.md「插件变更的就地重载」.
+     */
+    reloadPlugins(): Promise<PluginReloadResult>;
     /**
      * Set the active model for the agent session
      * @param model - The ID of the model to use
      */
-    setModel(model: string): void;
+    setModel(model: string): Promise<void>;
     /**
      * Get all configured models from settings.json and defaults
      * @returns Array of model IDs
@@ -65,6 +93,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;
@@ -87,6 +119,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 */
@@ -226,10 +273,37 @@ export declare class Agent {
     /**
      * Restore a session by ID, switching to the target session without destroying the Agent instance
      * @param sessionId - The ID of the session to restore
+     * @param options.workdir - The directory the target session lives in. Pass it
+     *   when the target was recorded under a different project directory (e.g.
+     *   another worktree of the same repo); the session transcript, project rules
+     *   and memory are then re-pointed at it.
      */
-    restoreSession(sessionId: string): Promise<void>;
+    restoreSession(sessionId: string, options?: {
+        workdir?: string;
+    }): Promise<void>;
+    /**
+     * Set this session's user-visible title.
+     *
+     * The title is appended to the session's own JSONL file as a `custom-title`
+     * entry (see `setSessionCustomTitle`), so every host that reads session files
+     * — this process, a later run, the IDE plugins, the desktop app — shows the
+     * same label. A blank title is a no-op.
+     */
+    renameSession(title: string): Promise<void>;
+    /** Shared wiring for the InteractionService entry points. */
+    private interactionContext;
+    /**
+     * Re-point every directory-derived piece of session state at `workdir`
+     * (used when restoring a session recorded in another directory).
+     *
+     * The memory cache needs no explicit clearing: moving to a session always
+     * changes the session id, and the resulting `onSessionIdChange` already
+     * clears it. Project rules do — they are discovered once at startup and
+     * resolved relative to the workdir.
+     */
+    private switchSessionWorkdir;
     abortAIMessage(): void;
-    /** Execute bash command (bang command) */
+    /** Execute a bash-mode command (`!command`) */
     bang(command: string): Promise<void>;
     clearMessages(): Promise<void>;
     /**
@@ -274,28 +348,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
      *
@@ -351,6 +403,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 */
@@ -395,6 +456,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)
      */
@@ -430,6 +499,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

@@ -3,8 +3,9 @@ import { configValidator } from "./utils/configValidator.js";
 import path from "node:path";
 import { parseTaskNotificationXml } from "./utils/notificationXml.js";
 import { InitializationService } from "./services/initializationService.js";
-import { InteractionService } from "./services/interactionService.js";
+import { InteractionService, } from "./services/interactionService.js";
 import { ConfigurationService } from "./services/configurationService.js";
+import { setSessionCustomTitle } from "./services/session.js";
 import { setupAgentContainer } from "./utils/containerSetup.js";
 import { initializeTelemetry, shutdownTelemetry, } from "./telemetry/instrumentation.js";
 import { logOTelEvent } from "./telemetry/events.js";
@@ -26,12 +27,47 @@ export class Agent {
     getLanguage() {
         return this.configurationService.resolveLanguage();
     }
+    /**
+     * Re-read the merged configuration (user/project/local settings.json + remote
+     * managed settings) and apply it to this session **without rebuilding it**:
+     * hooks / permissions / env follow immediately, the settings.json-derived
+     * values the running turn reads are re-pinned at the next turn start.
+     *
+     * THE save path calls this explicitly after writing the user-level
+     * settings.json: that file is commonly *created* by that very write, so the
+     * file watcher — armed at session start on a path that did not exist yet —
+     * must not be the only trigger (docs/specs/core/agent-config.md
+     * 「设置实时重载」). Idempotent with the watcher (a concurrent reload is
+     * de-duplicated).
+     */
+    async reloadConfiguration() {
+        await this.liveConfigManager.reload();
+    }
+    /**
+     * Re-read every plugin from disk and swap its contribution into this running
+     * session in place — the `/reload-plugins` command. Commands, skills,
+     * agents, hooks, MCP servers and LSP servers all follow; the session itself
+     * (sessionId, transcript, in-flight work) is untouched, so this is not a
+     * rebuild. Every live session in the process must call this to see the new
+     * state; sessions created afterwards pick it up from disk on their own.
+     *
+     * Busts the prompt cache for the tool-schema prefix (the skill and agent
+     * lists are inlined) — deliberately accepted, see
+     * docs/specs/ecosystem/plugin.md「插件变更的就地重载」.
+     */
+    async reloadPlugins() {
+        const result = await this.pluginManager.reloadAllPlugins();
+        // Plugin skills arrive after SkillManager.initialize(), so their slash
+        // commands have to be re-derived explicitly (same as at startup).
+        this.slashCommandManager.registerSkillCommands(this.skillManager.getAvailableSkills());
+        return result;
+    }
     /**
      * Set the active model for the agent session
      * @param model - The ID of the model to use
      */
-    setModel(model) {
-        this.configurationService.setModel(model);
+    async setModel(model) {
+        await this.configurationService.setModel(model);
         this.options.callbacks?.onModelChange?.(model);
     }
     /**
@@ -51,7 +87,7 @@ 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
@@ -115,7 +151,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");
@@ -135,7 +171,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();
@@ -152,6 +188,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();
     }
@@ -196,6 +238,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;
@@ -206,7 +275,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() {
@@ -317,7 +386,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") {
@@ -470,6 +539,11 @@ export class Agent {
             taskManager: this.taskManager,
             resolveAndValidateConfig: () => this.resolveAndValidateConfig(),
         }, options);
+        // Freeze the session-level bypass authorization now that settings.json (and
+        // thus `permissions.defaultMode`) has been loaded. Later mode switches and
+        // config reloads must not change it — it records what the user authorized
+        // when the session started.
+        this.permissionManager.captureBypassAuthorization();
         // Initialize OpenTelemetry (awaited to ensure ALS context is ready before
         // startInteractionSpan is called, preventing trace context fragmentation)
         const telemetryConfig = this.configurationService.resolveTelemetryConfig();
@@ -497,9 +571,33 @@ export class Agent {
     /**
      * Restore a session by ID, switching to the target session without destroying the Agent instance
      * @param sessionId - The ID of the session to restore
+     * @param options.workdir - The directory the target session lives in. Pass it
+     *   when the target was recorded under a different project directory (e.g.
+     *   another worktree of the same repo); the session transcript, project rules
+     *   and memory are then re-pointed at it.
+     */
+    async restoreSession(sessionId, options) {
+        await InteractionService.restoreSession(this.interactionContext(), sessionId, options);
+    }
+    /**
+     * Set this session's user-visible title.
+     *
+     * The title is appended to the session's own JSONL file as a `custom-title`
+     * entry (see `setSessionCustomTitle`), so every host that reads session files
+     * — this process, a later run, the IDE plugins, the desktop app — shows the
+     * same label. A blank title is a no-op.
      */
-    async restoreSession(sessionId) {
-        await InteractionService.restoreSession({
+    async renameSession(title) {
+        const applied = await setSessionCustomTitle(this.sessionId, this.workdir, title);
+        // Keep the in-memory value in step: it is what gets written back at the
+        // next flush point if the entry has since slid out of the tail window.
+        if (applied) {
+            this.messageManager.setCustomTitle(applied);
+        }
+    }
+    /** Shared wiring for the InteractionService entry points. */
+    interactionContext() {
+        return {
             messageManager: this.messageManager,
             slashCommandManager: this.slashCommandManager,
             hookManager: this.hookManager,
@@ -511,12 +609,27 @@ export class Agent {
             taskManager: this.taskManager,
             options: this.options,
             abortMessage: () => this.abortMessage(),
-        }, sessionId);
+            switchWorkdir: (workdir) => this.switchSessionWorkdir(workdir),
+        };
+    }
+    /**
+     * Re-point every directory-derived piece of session state at `workdir`
+     * (used when restoring a session recorded in another directory).
+     *
+     * The memory cache needs no explicit clearing: moving to a session always
+     * changes the session id, and the resulting `onSessionIdChange` already
+     * clears it. Project rules do — they are discovered once at startup and
+     * resolved relative to the workdir.
+     */
+    async switchSessionWorkdir(workdir) {
+        this.setWorkdir(workdir);
+        this.messageManager.setWorkdir(workdir);
+        await this.memoryRuleManager.setWorkdir(workdir);
     }
     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
@@ -525,7 +638,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() {
@@ -620,7 +733,7 @@ export class Agent {
     }
     /** Interrupt bash command execution */
     abortBashCommand() {
-        this.bangManager?.abortCommand();
+        this.bashModeManager?.abortCommand();
     }
     /** Interrupt slash command execution */
     abortSlashCommand() {
@@ -678,6 +791,10 @@ export class Agent {
             this.logger?.warn(`SessionEnd hooks failed: ${error.message}`);
         }
         await this.messageManager.saveSession();
+        // Flush point: the transcript is about to be left behind for other
+        // processes to list, so re-append the metadata entries at EOF. Must come
+        // after saveSession (which returns early when nothing is unsaved).
+        await this.messageManager.reAppendSessionMetadata();
         this.abortAIMessage(); // This will abort tools including Agent tool (subagents)
         this.abortBashCommand();
         this.abortSlashCommand();
@@ -753,28 +870,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
      *
@@ -821,19 +916,7 @@ export class Agent {
             }
             // Immediate slash command: fall through to InteractionService
         }
-        await InteractionService.sendMessage({
-            messageManager: this.messageManager,
-            slashCommandManager: this.slashCommandManager,
-            hookManager: this.hookManager,
-            workdir: this.workdir,
-            configurationService: this.configurationService,
-            logger: this.logger,
-            aiManager: this.aiManager,
-            subagentManager: this.subagentManager,
-            taskManager: this.taskManager,
-            options: this.options,
-            abortMessage: () => this.abortMessage(),
-        }, content, images);
+        await InteractionService.sendMessage(this.interactionContext(), content, images);
     }
     // ========== Additional Directories ==========
     /**
@@ -876,6 +959,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() {
@@ -951,6 +1049,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)
      */
@@ -1003,6 +1111,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/index.js

@@ -5,6 +5,7 @@ import { initSkill } from "./skills/init.js";
 import { loopSkill } from "./skills/loop.js";
 import { simplifySkill } from "./skills/simplify.js";
 import { settingsSkills } from "./skills/settings.js";
+import { waveDaemonSkill } from "./skills/wave-daemon.js";
 import { subagents } from "./subagents.js";
 import { sddPlugin } from "./plugins.js";
 export const BUILTIN_CONTENT = {
@@ -15,6 +16,7 @@ export const BUILTIN_CONTENT = {
     ...loopSkill,
     ...simplifySkill,
     ...settingsSkills,
+    ...waveDaemonSkill,
     ...subagents,
     ...sddPlugin,
 };