wave-agent-sdk 0.10.3 → 0.11.0

package/dist/types/hooks.js

@@ -31,7 +31,7 @@ export function isValidHookEvent(event) {
         "UserPromptSubmit",
         "Stop",
         "SubagentStop",
-        "Notification",
+        "PermissionRequest",
         "WorktreeCreate",
     ].includes(event);
 }

package/dist/types/index.d.ts

@@ -31,4 +31,5 @@ export * from "./memoryRule.js";
 export * from "./history.js";
 export * from "./tasks.js";
 export * from "./agent.js";
+export * from "./cron.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,cAAc,WAAW,CAAC;AAG1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,cAAc,WAAW,CAAC;AAG1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,kBAAkB,CAAC;AACjC,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,UAAU,CAAC;AACzB,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC"}

package/dist/types/index.js

@@ -33,3 +33,4 @@ export * from "./memoryRule.js";
 export * from "./history.js";
 export * from "./tasks.js";
 export * from "./agent.js";
+export * from "./cron.js";

package/dist/types/messaging.d.ts

@@ -8,7 +8,7 @@ export declare enum MessageSource {
     HOOK = "hook"
 }
 export interface Message {
-    id?: string;
+    id: string;
     role: "user" | "assistant";
     blocks: MessageBlock[];
     usage?: Usage;

package/dist/types/messaging.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"messaging.d.ts","sourceRoot":"","sources":["../../src/types/messaging.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAEvC,oBAAY,aAAa;IACvB,IAAI,SAAS;IACb,IAAI,SAAS;CACd;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,UAAU,GACV,SAAS,GACT,UAAU,GACV,SAAS,GACT,aAAa,GACb,cAAc,GACd,gBAAgB,CAAC;AAErB,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,KAAK,CAAC;QAEb,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,GAAG,KAAK,CAAC;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,OAAO,gBAAgB,EAAE,YAAY,EAAE,CAAC;CACpD"}
+{"version":3,"file":"messaging.d.ts","sourceRoot":"","sources":["../../src/types/messaging.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AAEvC,oBAAY,aAAa;IACvB,IAAI,SAAS;IACb,IAAI,SAAS;CACd;AAED,MAAM,WAAW,OAAO;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,GAAG,WAAW,CAAC;IAC3B,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC5C;AAED,MAAM,MAAM,YAAY,GACpB,SAAS,GACT,UAAU,GACV,SAAS,GACT,UAAU,GACV,SAAS,GACT,aAAa,GACb,cAAc,GACd,gBAAgB,CAAC;AAErB,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,MAAM,CAAC,EAAE,aAAa,CAAC;CACxB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,KAAK,CAAC;QAEb,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,CAAC,EAAE,MAAM,CAAC;KACpB,CAAC,CAAC;IACH,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;;;;;OAMG;IACH,KAAK,EAAE,OAAO,GAAG,WAAW,GAAG,SAAS,GAAG,KAAK,CAAC;IACjD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sBAAsB,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,UAAU,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,WAAW,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,EAAE,OAAO,gBAAgB,EAAE,YAAY,EAAE,CAAC;CACpD"}

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

@@ -1 +1 @@
-{"version":3,"file":"containerSetup.d.ts","sourceRoot":"","sources":["../../src/utils/containerSetup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAoB3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAG3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EACV,cAAc,EACd,KAAK,EACL,IAAI,EACJ,cAAc,EAEf,MAAM,mBAAmB,CAAC;AAI3B,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAGhB,uBAAuB,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC;IAC3D,aAAa,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC;IACvC,sBAAsB,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IACvD,wBAAwB,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IACzD,iBAAiB,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IAClD,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,0BAA0B,GACvC,SAAS,CAoNX"}
+{"version":3,"file":"containerSetup.d.ts","sourceRoot":"","sources":["../../src/utils/containerSetup.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAqB3C,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAI3E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,KAAK,EACV,cAAc,EACd,KAAK,EACL,IAAI,EACJ,cAAc,EAEf,MAAM,mBAAmB,CAAC;AAI3B,MAAM,WAAW,0BAA0B;IACzC,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB,EAAE,oBAAoB,CAAC;IAC3C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,OAAO,CAAC;IAGhB,uBAAuB,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC;IAC3D,aAAa,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC;IACvC,sBAAsB,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IACvD,wBAAwB,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IACzD,iBAAiB,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IAClD,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC;AAED,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,0BAA0B,GACvC,SAAS,CAoPX"}

package/dist/utils/containerSetup.js

@@ -14,20 +14,27 @@ import { SkillManager } from "../managers/skillManager.js";
 import { SlashCommandManager } from "../managers/slashCommandManager.js";
 import { PluginManager } from "../managers/pluginManager.js";
 import { BangManager } from "../managers/bangManager.js";
+import { CronManager } from "../managers/cronManager.js";
 import { MemoryRuleManager } from "../managers/MemoryRuleManager.js";
 import { ReversionManager } from "../managers/reversionManager.js";
 import { SubagentManager } from "../managers/subagentManager.js";
 import { LiveConfigManager } from "../managers/liveConfigManager.js";
 import { ReversionService } from "../services/reversionService.js";
 import { MemoryService } from "../services/memory.js";
+import { getGitMainRepoRoot } from "./gitUtils.js";
 import { logger } from "./globalLogger.js";
 export function setupAgentContainer(setupOptions) {
     const { options, workdir, configurationService, systemPrompt, stream, onBackgroundTasksChange, onTasksChange, onPermissionModeChange, handlePlanModeTransition, setPermissionMode, addPermissionRule, addUsage, } = setupOptions;
     const callbacks = options.callbacks || {};
     const container = new Container();
+    container.register("AgentOptions", options);
     const foregroundTaskManager = new ForegroundTaskManager(container);
     container.register("ForegroundTaskManager", foregroundTaskManager);
     container.register("ConfigurationService", configurationService);
+    if (options.worktreeName) {
+        container.register("WorktreeName", options.worktreeName);
+        container.register("MainRepoRoot", getGitMainRepoRoot(workdir));
+    }
     const memoryService = new MemoryService(container);
     container.register("MemoryService", memoryService);
     const memoryRuleManager = new MemoryRuleManager(container, { workdir });
@@ -75,13 +82,17 @@ export function setupAgentContainer(setupOptions) {
     container.register("McpManager", mcpManager);
     const lspManager = options.lspManager || new LspManager(container);
     container.register("LspManager", lspManager);
-    const permissionManager = new PermissionManager(container, { workdir });
+    const permissionManager = new PermissionManager(container, {
+        workdir,
+        instanceAllowedRules: options.allowedTools,
+        instanceDeniedRules: options.disallowedTools,
+    });
     if (configurationService.resolveAutoMemoryEnabled()) {
         const autoMemoryDir = memoryService.getAutoMemoryDirectory(workdir);
         permissionManager.addSystemAdditionalDirectory(autoMemoryDir);
     }
     container.register("PermissionManager", permissionManager);
-    permissionManager.setOnConfiguredDefaultModeChange((mode) => {
+    permissionManager.setOnConfiguredPermissionModeChange((mode) => {
         handlePlanModeTransition(mode);
         onPermissionModeChange(mode);
     });
@@ -94,27 +105,37 @@ export function setupAgentContainer(setupOptions) {
         watch: options.watchSkills ?? true,
     });
     container.register("SkillManager", skillManager);
-    container.register("ReversionService", new ReversionService(messageManager.getTranscriptPath()));
+    const rootSessionId = messageManager.getRootSessionId();
+    container.register("ReversionService", new ReversionService(rootSessionId));
     const reversionManager = new ReversionManager(container);
     container.register("ReversionManager", reversionManager);
-    const canUseToolWithNotification = options.canUseTool
+    const canUseToolWithPermissionRequest = options.canUseTool
         ? async (context) => {
             try {
-                const notificationMessage = `Claude needs your permission to use ${context.toolName}`;
-                await hookManager.executeHooks("Notification", {
-                    event: "Notification",
+                const results = await hookManager.executeHooks("PermissionRequest", {
+                    event: "PermissionRequest",
                     projectDir: workdir,
                     timestamp: new Date(),
                     sessionId: messageManager.getSessionId(),
                     transcriptPath: messageManager.getTranscriptPath(),
                     cwd: workdir,
-                    message: notificationMessage,
-                    notificationType: "permission_prompt",
+                    toolName: context.toolName,
+                    toolInput: context.toolInput,
                     env: configurationService.getEnvironmentVars(),
                 });
+                if (results.length > 0) {
+                    const processResult = hookManager.processHookResults("PermissionRequest", results, messageManager);
+                    if (processResult.shouldBlock) {
+                        return {
+                            behavior: "deny",
+                            message: processResult.errorMessage ||
+                                "Permission denied by hook execution",
+                        };
+                    }
+                }
             }
             catch (error) {
-                logger.warn("Failed to execute notification hooks", {
+                logger.warn("Failed to execute permission request hooks", {
                     toolName: context.toolName,
                     error: error instanceof Error ? error.message : String(error),
                 });
@@ -145,9 +166,9 @@ export function setupAgentContainer(setupOptions) {
     container.register("ToolManager", toolManager);
     container.register("PermissionMode", options.permissionMode);
     logger.info("Registering CanUseToolCallback", {
-        hasCallback: !!canUseToolWithNotification,
+        hasCallback: !!canUseToolWithPermissionRequest,
     });
-    container.register("CanUseToolCallback", canUseToolWithNotification);
+    container.register("CanUseToolCallback", canUseToolWithPermissionRequest);
     const liveConfigManager = new LiveConfigManager(container, { workdir });
     container.register("LiveConfigManager", liveConfigManager);
     const subagentManager = new SubagentManager(container, {
@@ -158,10 +179,13 @@ export function setupAgentContainer(setupOptions) {
             onSubagentAssistantContentUpdated: callbacks.onSubagentAssistantContentUpdated,
             onSubagentAssistantReasoningUpdated: callbacks.onSubagentAssistantReasoningUpdated,
             onSubagentToolBlockUpdated: callbacks.onSubagentToolBlockUpdated,
-            onSubagentMessagesChange: callbacks.onSubagentMessagesChange,
+            onSubagentMessagesChange: (subagentId, messages) => {
+                callbacks.onSubagentMessagesChange?.(subagentId, messages);
+            },
             onSubagentLatestTotalTokensChange: callbacks.onSubagentLatestTotalTokensChange,
         },
         onUsageAdded: (usage) => addUsage(usage),
+        stream,
     });
     container.register("SubagentManager", subagentManager);
     const aiManager = new AIManager(container, {
@@ -181,5 +205,8 @@ export function setupAgentContainer(setupOptions) {
     container.register("PluginManager", pluginManager);
     const bangManager = new BangManager(container, { workdir });
     container.register("BangManager", bangManager);
+    const cronManager = new CronManager(container);
+    container.register("CronManager", cronManager);
+    cronManager.start();
     return container;
 }

package/dist/utils/mcpUtils.d.ts

@@ -1,5 +1,5 @@
 import { ChatCompletionFunctionTool } from "openai/resources.js";
-import type { ToolPlugin } from "../tools/types.js";
+import type { ToolPlugin, ToolContext } from "../tools/types.js";
 import type { McpTool, McpServerStatus } from "../types/index.js";
 /**
  * Convert MCP tool to OpenAI function tool format
@@ -8,7 +8,7 @@ export declare function mcpToolToOpenAITool(mcpTool: McpTool, serverName: string
 /**
  * Create a tool plugin wrapper for an MCP tool
  */
-export declare function createMcpToolPlugin(mcpTool: McpTool, serverName: string, executeTool: (name: string, args: Record<string, unknown>) => Promise<{
+export declare function createMcpToolPlugin(mcpTool: McpTool, serverName: string, executeTool: (name: string, args: Record<string, unknown>, context?: ToolContext) => Promise<{
     success: boolean;
     content: string;
     serverName?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"mcpUtils.d.ts","sourceRoot":"","sources":["../../src/utils/mcpUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAA2B,MAAM,mBAAmB,CAAC;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AA8ClE;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,GACjB,0BAA0B,CAgB5B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC1B,OAAO,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD,CAAC,GACD,UAAU,CA4BZ;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,eAAe,EAAE,GACzB,eAAe,GAAG,SAAS,CAK7B"}
+{"version":3,"file":"mcpUtils.d.ts","sourceRoot":"","sources":["../../src/utils/mcpUtils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAc,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAC7E,OAAO,KAAK,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AA8ClE;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,GACjB,0BAA0B,CAgB5B;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,OAAO,EAChB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,CACX,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC7B,OAAO,CAAC,EAAE,WAAW,KAClB,OAAO,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CACtD,CAAC,GACD,UAAU,CAwBZ;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,eAAe,EAAE,GACzB,eAAe,GAAG,SAAS,CAK7B"}

package/dist/utils/mcpUtils.js

@@ -59,11 +59,7 @@ export function createMcpToolPlugin(mcpTool, serverName, executeTool) {
         config: mcpToolToOpenAITool(mcpTool, serverName),
         async execute(args, context) {
             try {
-                // Context is available for future use when MCP tools need execution context
-                if (context) {
-                    // Future: Could pass working directory or other context to MCP tools
-                }
-                const result = await executeTool(prefixedName, args);
+                const result = await executeTool(prefixedName, args, context);
                 return {
                     success: true,
                     content: result.content || `Executed ${mcpTool.name}`,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wave-agent-sdk",
-  "version": "0.10.3",
+  "version": "0.11.0",
   "description": "SDK for building AI-powered development tools and agents",
   "keywords": [
     "ai",
@@ -29,6 +29,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.18.2",
     "chokidar": "^5.0.0",
+    "cron-parser": "^5.5.0",
     "fuzzysort": "^3.1.0",
     "glob": "^13.0.0",
     "minimatch": "^10.0.3",

package/src/agent.ts

@@ -6,6 +6,7 @@ import { SubagentManager } from "./managers/subagentManager.js";
 import { McpManager } from "./managers/mcpManager.js";
 import { LspManager } from "./managers/lspManager.js";
 import { BangManager } from "./managers/bangManager.js";
+import { CronManager } from "./managers/cronManager.js";
 import { BackgroundTaskManager } from "./managers/backgroundTaskManager.js";
 import { SlashCommandManager } from "./managers/slashCommandManager.js";
 import { PluginManager } from "./managers/pluginManager.js";
@@ -56,6 +57,7 @@ export class Agent {
   private slashCommandManager: SlashCommandManager; // Add slash command manager instance
   private pluginManager: PluginManager; // Add plugin manager instance
   private skillManager: SkillManager; // Add skill manager instance
+  private cronManager: CronManager; // Add cron manager instance
   private hookManager: HookManager; // Add hooks manager instance
   private reversionManager: ReversionManager;
   private memoryRuleManager: MemoryRuleManager; // Add memory rule manager instance
@@ -168,6 +170,7 @@ export class Agent {
     this.slashCommandManager = this.container.get("SlashCommandManager")!;
     this.pluginManager = this.container.get("PluginManager")!;
     this.bangManager = this.container.get("BangManager")!;
+    this.cronManager = this.container.get("CronManager")!;
 
     // Set initial permission mode if provided
     if (options.permissionMode) {
@@ -411,8 +414,8 @@ export class Agent {
     await this.bangManager?.executeCommand(command);
   }
 
-  public clearMessages(): void {
-    this.messageManager.clearMessages();
+  public async clearMessages(): Promise<void> {
+    await this.slashCommandManager.executeCommand("clear");
   }
 
   /** Unified interrupt method, interrupts both AI messages and command execution */
@@ -460,6 +463,7 @@ export class Agent {
     this.abortAIMessage(); // This will abort tools including Agent tool (subagents)
     this.abortBashCommand();
     this.abortSlashCommand();
+    this.cronManager.stop();
     // Cleanup background task manager
     this.backgroundTaskManager.cleanup();
     // Cleanup MCP connections
@@ -484,16 +488,6 @@ export class Agent {
     // Cleanup memory store
   }
 
-  /**
-   * Get a subagent instance by its ID
-   * @param subagentId - The ID of the subagent instance
-   */
-  public getSubagentInstance(
-    subagentId: string,
-  ): import("./managers/subagentManager.js").SubagentInstance | null {
-    return this.subagentManager.getInstance(subagentId);
-  }
-
   /**
    * Trigger the rewind UI callback
    */
@@ -688,6 +682,17 @@ export class Agent {
     await this.permissionManager.addPermissionRule(rule);
   }
 
+  /**
+   * Get subagent instance by ID
+   * @param subagentId - The ID of the subagent instance
+   * @returns The subagent instance or null if not found
+   */
+  public getSubagentInstance(
+    subagentId: string,
+  ): import("./managers/subagentManager.js").SubagentInstance | null {
+    return this.subagentManager.getInstance(subagentId);
+  }
+
   /**
    * Get the current task list ID
    */

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

@@ -0,0 +1,53 @@
+---
+name: loop
+description: Parses user input into an interval and prompt, converts the interval to a cron expression, and schedules a recurring task
+allowed-tools: CronCreate, Skill
+---
+# /loop — schedule a recurring prompt
+
+Parse the input below into `[interval] <prompt…>` and schedule it with CronCreate.
+
+## Parsing (in priority order)
+
+1. **Leading token**: if the first whitespace-delimited token matches `^\d+[smhd]$` (e.g. `5m`, `2h`), that's the interval; the rest is the prompt.
+2. **Trailing "every" clause**: otherwise, if the input ends with `every <N><unit>` or `every <N> <unit-word>` (e.g. `every 20m`, `every 5 minutes`, `every 2 hours`), extract that as the interval and strip it from the prompt. Only match when what follows "every" is a time expression — `check every PR` has no interval.
+3. **Default**: otherwise, interval is `10m` and the entire input is the prompt.
+
+If the resulting prompt is empty, show usage `/loop [interval] <prompt>` and stop — do not call CronCreate.
+
+Examples:
+- `5m /babysit-prs` → interval `5m`, prompt `/babysit-prs` (rule 1)
+- `check the deploy every 20m` → interval `20m`, prompt `check the deploy` (rule 2)
+- `run tests every 5 minutes` → interval `5m`, prompt `run tests` (rule 2)
+- `check the deploy` → interval `10m`, prompt `check the deploy` (rule 3)
+- `check every PR` → interval `10m`, prompt `check every PR` (rule 3 — "every" not followed by time)
+- `5m` → empty prompt → show usage
+
+## Interval → cron
+
+Supported suffixes: `s` (seconds, rounded up to nearest minute, min 1), `m` (minutes), `h` (hours), `d` (days). Convert:
+
+| Interval pattern      | Cron expression     | Notes                                    |
+|-----------------------|---------------------|------------------------------------------|
+| `Nm` where N ≤ 59   | `*/N * * * *`     | every N minutes                          |
+| `Nm` where N ≥ 60   | `0 */H * * *`     | round to hours (H = N/60, must divide 24)|
+| `Nh` where N ≤ 23   | `0 */N * * *`     | every N hours                            |
+| `Nd`                | `0 0 */N * *`     | every N days at midnight local           |
+| `Ns`                | treat as `ceil(N/60)m` | cron minimum granularity is 1 minute  |
+
+**If the interval doesn't cleanly divide its unit** (e.g. `7m` → `*/7 * * * *` gives uneven gaps at :56→:00; `90m` → 1.5h which cron can't express), pick the nearest clean interval and tell the user what you rounded to before scheduling.
+
+**Thundering herd prevention**: For approximate requests like "hourly" or "every morning", pick a random minute (e.g., 7) instead of 0 to avoid global sync issues.
+
+## Action
+
+1. Call CronCreate with:
+   - `cron`: the expression from the table above
+   - `prompt`: the parsed prompt from above, verbatim (slash commands are passed through unchanged)
+   - `recurring`: `true`
+2. Briefly confirm: what's scheduled, the cron expression, the human-readable cadence, that recurring tasks auto-expire after 7 days, and that they can cancel sooner with CronDelete (include the job ID).
+3. **Then immediately execute the parsed prompt now** — don't wait for the first cron fire. If it's a slash command, invoke it via the Skill tool; otherwise act on it directly.
+
+## Input
+
+$ARGUMENTS

package/src/builtin-skills/loop/parsing.ts

@@ -0,0 +1,159 @@
+export interface ParsedLoop {
+  interval: string;
+  prompt: string;
+  originalInterval?: string;
+  roundedTo?: string;
+}
+
+export function parseLoopInput(
+  input: string,
+  defaultInterval: string = "10m",
+): ParsedLoop {
+  const trimmedInput = input.trim();
+  if (!trimmedInput) {
+    return { interval: defaultInterval, prompt: "" };
+  }
+
+  // 1. Leading token: ^\d+[smhd]$
+  const tokens = trimmedInput.split(/\s+/);
+  if (tokens[0].match(/^\d+[smhd]$/)) {
+    const interval = tokens[0];
+    const prompt = tokens.slice(1).join(" ");
+    return { interval, prompt };
+  }
+
+  // 2. Trailing "every" clause: every <N><unit> or every <N> <unit-word>
+  // Units: s, m, h, d, second(s), minute(s), hour(s), day(s)
+  const everyRegex =
+    /\s+every\s+(\d+)\s*(s|m|h|d|seconds?|minutes?|hours?|days?)$/i;
+  const match = trimmedInput.match(everyRegex);
+  if (match) {
+    const n = match[1];
+    const unitWord = match[2].toLowerCase();
+    const unit = unitWord[0];
+    const interval = `${n}${unit}`;
+    const prompt = trimmedInput.substring(0, match.index).trim();
+    return { interval, prompt };
+  }
+
+  // 3. Default
+  return { interval: defaultInterval, prompt: trimmedInput };
+}
+
+const CLEAN_MINUTES = [1, 2, 3, 4, 5, 6, 10, 12, 15, 20, 30];
+const CLEAN_HOURS = [1, 2, 3, 4, 6, 8, 12];
+
+function getNearestClean(value: number, cleanValues: number[]): number {
+  let nearest = cleanValues[0];
+  let minDiff = Math.abs(value - nearest);
+  for (const clean of cleanValues) {
+    const diff = Math.abs(value - clean);
+    if (diff < minDiff) {
+      minDiff = diff;
+      nearest = clean;
+    } else if (diff === minDiff) {
+      // If equal diff, prefer the larger one? Or smaller?
+      // Let's prefer the larger one to be less frequent
+      if (clean > nearest) {
+        nearest = clean;
+      }
+    }
+  }
+  return nearest;
+}
+
+export function intervalToCron(interval: string): {
+  cron: string;
+  roundedTo?: string;
+  cadence: string;
+} {
+  const match = interval.match(/^(\d+)([smhd])$/);
+  if (!match) {
+    throw new Error(`Invalid interval format: ${interval}`);
+  }
+
+  let n = parseInt(match[1], 10);
+  const unit = match[2];
+  let roundedTo: string | undefined;
+
+  if (unit === "s") {
+    const minutes = Math.ceil(n / 60);
+    const result = intervalToCron(`${minutes}m`);
+    return {
+      ...result,
+      roundedTo:
+        result.roundedTo || (minutes * 60 !== n ? `${minutes}m` : undefined),
+    };
+  }
+
+  if (unit === "m") {
+    if (n >= 60) {
+      const hours = Math.round(n / 60);
+      const result = intervalToCron(`${hours}h`);
+      return {
+        ...result,
+        roundedTo:
+          result.roundedTo || (hours * 60 !== n ? `${hours}h` : undefined),
+      };
+    }
+
+    if (!CLEAN_MINUTES.includes(n)) {
+      const nearest = getNearestClean(n, CLEAN_MINUTES);
+      roundedTo = `${nearest}m`;
+      n = nearest;
+    }
+
+    // For minutes, we use */N. Thundering herd is less of an issue for high frequency,
+    // but we could still offset it. However, the spec says "random minute for approximate requests like 'hourly'".
+    // So for minutes, we'll stick to */N.
+    return {
+      cron: `*/${n} * * * *`,
+      roundedTo,
+      cadence: `every ${n} minute${n > 1 ? "s" : ""}`,
+    };
+  }
+
+  if (unit === "h") {
+    if (n > 23) {
+      const days = Math.round(n / 24);
+      const result = intervalToCron(`${days}d`);
+      return {
+        ...result,
+        roundedTo:
+          result.roundedTo || (days * 24 !== n ? `${days}d` : undefined),
+      };
+    }
+
+    if (!CLEAN_HOURS.includes(n)) {
+      const nearest = getNearestClean(n, CLEAN_HOURS);
+      roundedTo = `${nearest}h`;
+      n = nearest;
+    }
+
+    // Thundering herd prevention: pick a random minute
+    const randomMinute = Math.floor(Math.random() * 60);
+    return {
+      cron: `${randomMinute} */${n} * * *`,
+      roundedTo,
+      cadence: `every ${n} hour${n > 1 ? "s" : ""}`,
+    };
+  }
+
+  if (unit === "d") {
+    if (![1, 2, 3, 4, 5, 6, 7, 10, 14, 30].includes(n)) {
+      // For days, we don't have a strict "clean" list in spec, but let's use some common ones if needed.
+      // Actually, cron supports any */N for days.
+    }
+
+    // Thundering herd prevention: pick a random minute and hour
+    const randomMinute = Math.floor(Math.random() * 60);
+    const randomHour = Math.floor(Math.random() * 24);
+    return {
+      cron: `${randomMinute} ${randomHour} */${n} * *`,
+      roundedTo,
+      cadence: `every ${n} day${n > 1 ? "s" : ""}`,
+    };
+  }
+
+  throw new Error(`Unsupported unit: ${unit}`);
+}