wave-agent-sdk 0.15.0 → 0.15.2

package/dist/services/initializationService.js

@@ -4,7 +4,7 @@ import { LspManager } from "../managers/lspManager.js";
 import { USER_MEMORY_FILE } from "../utils/constants.js";
 export class InitializationService {
     static async initialize(context, options) {
-        const { skillManager, subagentManager, container, toolManager, pluginManager, options: agentOptions, slashCommandManager, logger, mcpManager, workdir, lspManager, configurationService, hookManager, messageManager, memoryRuleManager, liveConfigManager, taskManager, setProjectMemory, setUserMemory, resolveAndValidateConfig, } = context;
+        const { skillManager, subagentManager, container, toolManager, pluginManager, options: agentOptions, slashCommandManager, logger, mcpManager, workdir, lspManager, configurationService, hookManager, messageManager, memoryRuleManager, liveConfigManager, taskManager, resolveAndValidateConfig, } = context;
         const startTime = performance.now();
         // Initialize managers first
         try {
@@ -162,40 +162,8 @@ export class InitializationService {
             logger?.error("Failed to initialize live configuration reload:", error);
             // Don't throw error to prevent app startup failure - continue without live reload
         }
-        // Load memory files during initialization
-        try {
-            const phaseStart = performance.now();
-            const memoryService = container.get("MemoryService");
-            if (!memoryService) {
-                throw new Error("MemoryService not found in container");
-            }
-            // Load project memory from AGENTS.md
-            try {
-                const projectMemoryContent = await memoryService.readMemoryFile(workdir);
-                setProjectMemory(projectMemoryContent);
-            }
-            catch (error) {
-                logger?.warn("Failed to load project memory file:", error);
-                setProjectMemory("");
-            }
-            // Load user memory
-            try {
-                const userMemoryContent = await memoryService.getUserMemoryContent();
-                setUserMemory(userMemoryContent);
-            }
-            catch (error) {
-                logger?.warn("Failed to load user memory file:", error);
-                setUserMemory("");
-            }
-            logger?.debug(`Initialization Phase [Memory Files Loading] took ${(performance.now() - phaseStart).toFixed(2)}ms`);
-        }
-        catch (error) {
-            // Ensure memory is always initialized even if loading fails
-            setProjectMemory("");
-            setUserMemory("");
-            logger?.error("Failed to load memory files:", error);
-            // Don't throw error to prevent app startup failure
-        }
+        // Memory is lazy-cached on first getCombinedMemoryContent call
+        // No explicit loading needed during initialization
         // Handle session restoration or set provided messages
         const sessionPhaseStart = performance.now();
         if (options?.messages) {

package/dist/services/jsonlHandler.d.ts

@@ -3,7 +3,7 @@
  * Handles reading and writing JSONL (JSON Lines) session files for improved performance
  */
 import type { Message } from "../types/index.js";
-import type { SessionMessage, SessionFilename } from "../types/session.js";
+import type { SessionFilename } from "../types/session.js";
 /**
  * JSONL write options
  */
@@ -31,15 +31,15 @@ export declare class JsonlHandler {
     /**
      * Append messages to JSONL file
      */
-    append(filePath: string, messages: SessionMessage[], options?: JsonlWriteOptions): Promise<void>;
+    append(filePath: string, messages: Message[], options?: JsonlWriteOptions): Promise<void>;
     /**
      * Read all messages from JSONL file (simplified - no metadata handling)
      */
-    read(filePath: string): Promise<SessionMessage[]>;
+    read(filePath: string): Promise<Message[]>;
     /**
      * Get the last message from JSONL file using efficient file reading (simplified)
      */
-    getLastMessage(filePath: string): Promise<SessionMessage | null>;
+    getLastMessage(filePath: string): Promise<Message | null>;
     /**
      * Validate messages before writing
      */

package/dist/services/jsonlHandler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jsonlHandler.d.ts","sourceRoot":"","sources":["../../src/services/jsonlHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3E;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAEhC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA8B;;IAQlE;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpD;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAc1E;;OAEG;IACG,MAAM,CACV,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,cAAc,EAAE,EAC1B,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAyChB;;OAEG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;IAoCvD;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;IAgCtE;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA4BxB;;OAEG;YACW,eAAe;IAW7B;;;;OAIG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe;IA6BvD;;;;OAIG;IACH,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAUjD;;;;;OAKG;IACH,uBAAuB,CACrB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAAG,UAAU,GAC/B,MAAM;CAcV"}
+{"version":3,"file":"jsonlHandler.d.ts","sourceRoot":"","sources":["../../src/services/jsonlHandler.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAEhC,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAA8B;;IAQlE;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQpD;;OAEG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAItE;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ1E;;OAEG;IACG,MAAM,CACV,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,OAAO,EAAE,EACnB,OAAO,CAAC,EAAE,iBAAiB,GAC1B,OAAO,CAAC,IAAI,CAAC;IAmChB;;OAEG;IACG,IAAI,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAoChD;;OAEG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAgC/D;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA4BxB;;OAEG;YACW,eAAe;IAW7B;;;;OAIG;IACH,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,eAAe;IA6BvD;;;;OAIG;IACH,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAUjD;;;;;OAKG;IACH,uBAAuB,CACrB,SAAS,EAAE,MAAM,EACjB,WAAW,EAAE,MAAM,GAAG,UAAU,GAC/B,MAAM;CAcV"}

package/dist/services/jsonlHandler.js

@@ -36,12 +36,7 @@ export class JsonlHandler {
         if (messages.length === 0) {
             return;
         }
-        // Convert to SessionMessage format with timestamps
-        const sessionMessages = messages.map((message) => ({
-            ...message,
-            timestamp: new Date().toISOString(),
-        }));
-        return this.append(filePath, sessionMessages);
+        return this.append(filePath, messages);
     }
     /**
      * Append messages to JSONL file
@@ -55,14 +50,10 @@ export class JsonlHandler {
         this.validateMessages(messages);
         // Ensure directory exists
         await this.ensureDirectory(dirname(filePath));
-        // Convert messages to JSONL lines (always compact JSON)
+        // Convert messages to JSONL lines (compact JSON, timestamp first)
         const lines = messages.map((message) => {
-            const { timestamp: existingTimestamp, ...messageWithoutTimestamp } = message;
-            const messageWithTimestamp = {
-                timestamp: existingTimestamp || new Date().toISOString(),
-                ...messageWithoutTimestamp,
-            };
-            return JSON.stringify(messageWithTimestamp);
+            const { timestamp, ...rest } = message;
+            return JSON.stringify({ timestamp, ...rest });
         });
         const content = lines.join("\n") + "\n";
         if (opts.atomic) {

package/dist/services/memory.d.ts

@@ -1,7 +1,13 @@
 import { Container } from "../utils/container.js";
 export declare class MemoryService {
     private container;
+    private _cachedProjectMemory;
+    private _cachedUserMemory;
+    private _cachedCombinedMemory;
     constructor(container: Container);
+    get cachedProjectMemory(): string;
+    get cachedUserMemory(): string;
+    clearCache(): void;
     /**
      * Get the project-specific auto-memory directory.
      * Uses the git common directory to ensure worktrees share the same memory.

package/dist/services/memory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/services/memory.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAIlD,qBAAa,aAAa;IACZ,OAAO,CAAC,SAAS;gBAAT,SAAS,EAAE,SAAS;IAExC;;;OAGG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAU/C;;OAEG;IACG,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B/D;;OAEG;IACG,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBtD,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IA8BrC,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC;IAevC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuBhD,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAqBjE"}
+{"version":3,"file":"memory.d.ts","sourceRoot":"","sources":["../../src/services/memory.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAIlD,qBAAa,aAAa;IAKZ,OAAO,CAAC,SAAS;IAJ7B,OAAO,CAAC,oBAAoB,CAAc;IAC1C,OAAO,CAAC,iBAAiB,CAAc;IACvC,OAAO,CAAC,qBAAqB,CAAuB;gBAEhC,SAAS,EAAE,SAAS;IAExC,IAAW,mBAAmB,IAAI,MAAM,CAEvC;IAED,IAAW,gBAAgB,IAAI,MAAM,CAEpC;IAEM,UAAU,IAAI,IAAI;IAMzB;;;OAGG;IACH,sBAAsB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM;IAU/C;;OAEG;IACG,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B/D;;OAEG;IACG,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAiBtD,oBAAoB,IAAI,OAAO,CAAC,IAAI,CAAC;IA8BrC,oBAAoB,IAAI,OAAO,CAAC,MAAM,CAAC;IAevC,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAuBhD,wBAAwB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAgBjE"}

package/dist/services/memory.js

@@ -8,6 +8,20 @@ import { pathEncoder } from "../utils/pathEncoder.js";
 export class MemoryService {
     constructor(container) {
         this.container = container;
+        this._cachedProjectMemory = "";
+        this._cachedUserMemory = "";
+        this._cachedCombinedMemory = null;
+    }
+    get cachedProjectMemory() {
+        return this._cachedProjectMemory;
+    }
+    get cachedUserMemory() {
+        return this._cachedUserMemory;
+    }
+    clearCache() {
+        this._cachedProjectMemory = "";
+        this._cachedUserMemory = "";
+        this._cachedCombinedMemory = null;
     }
     /**
      * Get the project-specific auto-memory directory.
@@ -133,21 +147,20 @@ export class MemoryService {
         }
     }
     async getCombinedMemoryContent(workdir) {
-        // Read memory file content
-        const memoryContent = await this.readMemoryFile(workdir);
-        // Read user-level memory content
-        const userMemoryContent = await this.getUserMemoryContent();
-        // Merge project memory and user memory
-        let combinedMemory = "";
-        if (memoryContent.trim()) {
-            combinedMemory += memoryContent;
+        if (this._cachedCombinedMemory !== null) {
+            return this._cachedCombinedMemory;
         }
-        if (userMemoryContent.trim()) {
-            if (combinedMemory) {
-                combinedMemory += "\n\n";
-            }
-            combinedMemory += userMemoryContent;
+        this._cachedProjectMemory = await this.readMemoryFile(workdir);
+        this._cachedUserMemory = await this.getUserMemoryContent();
+        let combined = "";
+        if (this._cachedProjectMemory.trim())
+            combined += this._cachedProjectMemory;
+        if (this._cachedUserMemory.trim()) {
+            if (combined)
+                combined += "\n\n";
+            combined += this._cachedUserMemory;
         }
-        return combinedMemory;
+        this._cachedCombinedMemory = combined;
+        return combined;
     }
 }

package/dist/services/session.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/services/session.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../src/services/session.ts"],"names":[],"mappings":"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"}

package/dist/services/session.js

@@ -147,17 +147,13 @@ export async function appendMessages(sessionId, newMessages, workdir, sessionTyp
     catch {
         throw new Error(`Session file not found: ${sessionId}. Use createSession() to create a new session first.`);
     }
-    const messagesWithTimestamp = newMessages.map((msg) => ({
-        timestamp: new Date().toISOString(),
-        ...msg,
-    }));
-    await jsonlHandler.append(filePath, messagesWithTimestamp, {
+    await jsonlHandler.append(filePath, newMessages, {
         atomic: false,
     });
     // Update index
     const encoder = new PathEncoder();
     const projectDir = await encoder.getProjectDirectory(workdir, SESSION_DIR);
-    const lastMessage = messagesWithTimestamp[messagesWithTimestamp.length - 1];
+    const lastMessage = newMessages[newMessages.length - 1];
     // Get first message content if it's a new session or we don't have it
     let firstMessage;
     try {
@@ -232,12 +228,7 @@ export async function loadSessionFromJsonl(sessionId, workdir, sessionType = "ma
             id: sessionId,
             rootSessionId: rootSessionId || sessionId,
             parentSessionId,
-            messages: messages.map((msg) => {
-                // Remove timestamp property for backward compatibility
-                const { timestamp: _ignored, ...messageWithoutTimestamp } = msg;
-                void _ignored; // Use the variable to avoid eslint error
-                return messageWithoutTimestamp;
-            }),
+            messages,
             metadata: {
                 workdir,
                 lastActiveAt: lastMessage

package/dist/tools/agentTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agentTool.d.ts","sourceRoot":"","sources":["../../src/tools/agentTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AAStE;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,UA4QvB,CAAC"}
+{"version":3,"file":"agentTool.d.ts","sourceRoot":"","sources":["../../src/tools/agentTool.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AAStE;;GAEG;AACH,eAAO,MAAM,SAAS,EAAE,UA+RvB,CAAC"}

package/dist/tools/agentTool.js

@@ -132,17 +132,29 @@ When using the Agent tool, you must specify a subagent_type parameter to select
                     return;
                 const messages = instance.messageManager.getMessages();
                 const tokens = instance.messageManager.getLatestTotalTokens();
-                const lastTools = instance.lastTools;
+                const usedTools = instance.usedTools;
                 const toolCount = countToolBlocks(messages);
                 const summary = formatToolTokenSummary(toolCount, tokens);
+                const getDisplayParam = (t) => {
+                    if ((t.stage === "end" || t.stage === "running") &&
+                        t.compactParams) {
+                        return t.compactParams;
+                    }
+                    const flat = t.parameters.replace(/\n/g, "\\n");
+                    return flat.length > 30 ? `…${flat.slice(-30)}` : flat;
+                };
                 let shortResult = "";
                 if (toolCount > 2) {
                     shortResult += "... ";
                 }
-                if (lastTools.length > 0) {
-                    shortResult += `${lastTools.join(", ")} `;
-                }
                 shortResult += summary;
+                if (usedTools.length > 0) {
+                    shortResult +=
+                        "\n" +
+                            usedTools
+                                .map((t) => `${t.name} ${getDisplayParam(t)}`)
+                                .join("\n");
+                }
                 context.onShortResultUpdate?.(shortResult);
             });
             return new Promise((resolve) => {

package/dist/tools/bashTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bashTool.d.ts","sourceRoot":"","sources":["../../src/tools/bashTool.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AAwCtE;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,UAobtB,CAAC"}
+{"version":3,"file":"bashTool.d.ts","sourceRoot":"","sources":["../../src/tools/bashTool.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AAwCtE;;GAEG;AACH,eAAO,MAAM,QAAQ,EAAE,UAibtB,CAAC"}

package/dist/tools/bashTool.js

@@ -63,7 +63,7 @@ export const bashTool = {
         },
     },
     prompt: () => `
-Executes a given bash command in a persistent shell session with optional timeout, ensuring proper handling and security measures.
+Executes a given bash command with optional timeout, ensuring proper handling and security measures. Each invocation runs in a fresh shell process starting from the project root.
 
 IMPORTANT: This tool is for terminal operations like git, npm, docker, etc. DO NOT use it for file operations (reading, writing, editing, searching, finding files) - use the specialized tools for this instead.
 
@@ -122,10 +122,7 @@ Use the gh command via the Bash tool for GitHub-related tasks including working
 - Do not retry failing commands in a sleep loop — diagnose the root cause.
 - If waiting for a background task you started with \`run_in_background\`, you will be notified when it completes — do not poll.
 - If you must poll an external process, use a check command (e.g. \`gh run view\`) rather than sleeping first.
-- If you must sleep, keep the duration short (1-5 seconds) to avoid blocking the user.
-
-# CWD management
-Try to maintain your current working directory throughout the session by using absolute paths and avoiding usage of \`cd\`. You may use \`cd\` if the User explicitly requests it. When you use \`cd\`, the shell working directory will be reset to the original working directory after the command completes.`,
+- If you must sleep, keep the duration short (1-5 seconds) to avoid blocking the user.`,
     execute: async (args, context) => {
         const command = args.command;
         const runInBackground = args.run_in_background;

package/dist/tools/cronCreateTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cronCreateTool.d.ts","sourceRoot":"","sources":["../../src/tools/cronCreateTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AAGjE,eAAO,MAAM,cAAc,EAAE,UAqE5B,CAAC"}
+{"version":3,"file":"cronCreateTool.d.ts","sourceRoot":"","sources":["../../src/tools/cronCreateTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AA+CjE,eAAO,MAAM,cAAc,EAAE,UAkG5B,CAAC"}

package/dist/tools/cronCreateTool.js

@@ -1,25 +1,67 @@
 import { CRON_CREATE_TOOL_NAME } from "../constants/tools.js";
+import { cronToHuman } from "../utils/cronToHuman.js";
+import { parseCronExpression } from "../utils/parseCronExpression.js";
+const DEFAULT_MAX_AGE_DAYS = 7;
+const MAX_JOBS = 50;
+const CRON_CREATE_DESCRIPTION = `Schedule a prompt to run at a future time within this Wave session — either recurring on a cron schedule, or once at a specific time.`;
+const CRON_CREATE_PROMPT = `Schedule a prompt to be enqueued at a future time. Use for both recurring schedules and one-shot reminders.
+
+Uses standard 5-field cron in the user's local timezone: minute hour day-of-month month day-of-week. "0 9 * * *" means 9am local — no timezone conversion needed.
+
+## One-shot tasks (recurring: false)
+
+For "remind me at X" or "at <time>, do Y" requests — fire once then auto-delete.
+Pin minute/hour/day-of-month/month to specific values:
+  "remind me at 2:30pm today to check the deploy" → cron: "30 14 <today_dom> <today_month> *", recurring: false
+  "tomorrow morning, run the smoke test" → cron: "57 8 <tomorrow_dom> <tomorrow_month> *", recurring: false
+
+## Recurring jobs (recurring: true, the default)
+
+For "every N minutes" / "every hour" / "weekdays at 9am" requests:
+  "*/5 * * * *" (every 5 min), "0 * * * *" (hourly), "0 9 * * 1-5" (weekdays at 9am local)
+
+## Avoid the :00 and :30 minute marks when the task allows it
+
+Every user who asks for "9am" gets \`0 9\`, and every user who asks for "hourly" gets \`0 *\` — which means requests from across the planet land on the API at the same instant. When the user's request is approximate, pick a minute that is NOT 0 or 30:
+  "every morning around 9" → "57 8 * * *" or "3 9 * * *" (not "0 9 * * *")
+  "hourly" → "7 * * * *" (not "0 * * * *")
+  "in an hour or so, remind me to..." → pick whatever minute you land on, don't round
+
+Only use minute 0 or 30 when the user names that exact time and clearly means it ("at 9:00 sharp", "at half past", coordinating with a meeting). When in doubt, nudge a few minutes early or late — the user will not notice, and the fleet will.
+
+## Session-only
+
+Jobs live only in this Wave session — nothing is written to disk, and the job is gone when Wave exits.
+
+## Runtime behavior
+
+Jobs only fire while the REPL is idle (not mid-query). The scheduler adds a small deterministic jitter on top of whatever you pick: recurring tasks fire up to 10% of their period late (max 15 min); one-shot tasks landing on :00 or :30 fire up to 90s early. Picking an off-minute is still the bigger lever.
+
+Recurring tasks auto-expire after ${DEFAULT_MAX_AGE_DAYS} days — they fire one final time, then are deleted. This bounds session lifetime. Tell the user about the ${DEFAULT_MAX_AGE_DAYS}-day limit when scheduling recurring jobs.
+
+Returns a job ID you can pass to CronDelete.`;
 export const cronCreateTool = {
     name: CRON_CREATE_TOOL_NAME,
+    shouldDefer: true,
     config: {
         type: "function",
         function: {
             name: CRON_CREATE_TOOL_NAME,
-            description: "Schedule a prompt to be enqueued at a future time. Use for both recurring schedules and one-shot reminders.",
+            description: CRON_CREATE_DESCRIPTION,
             parameters: {
                 type: "object",
                 properties: {
                     cron: {
                         type: "string",
-                        description: 'Standard 5-field cron expression in local time: "M H DoM Mon DoW"',
+                        description: 'Standard 5-field cron expression in local time: "M H DoM Mon DoW" (e.g. "*/5 * * * *" = every 5 minutes, "30 14 28 2 *" = Feb 28 at 2:30pm local once).',
                     },
                     prompt: {
                         type: "string",
-                        description: "The prompt to enqueue at each fire time",
+                        description: "The prompt to enqueue at each fire time.",
                     },
                     recurring: {
                         type: "boolean",
-                        description: "Default: true. true = fire on every cron match until deleted or auto-expired after 7 days. false = fire once at the next match, then auto-delete",
+                        description: `true (default) = fire on every cron match until deleted or auto-expired after ${DEFAULT_MAX_AGE_DAYS} days. false = fire once at the next match, then auto-delete. Use false for "remind me at X" one-shot requests with pinned minute/hour/dom/month.`,
                         default: true,
                     },
                 },
@@ -27,6 +69,7 @@ export const cronCreateTool = {
             },
         },
     },
+    prompt: () => CRON_CREATE_PROMPT,
     execute: async (args, context) => {
         const { cron, prompt, recurring = true, } = args;
         if (!context.cronManager) {
@@ -36,16 +79,38 @@ export const cronCreateTool = {
                 error: "CronManager not available",
             };
         }
+        // Validate cron expression
+        if (!parseCronExpression(cron)) {
+            return {
+                success: false,
+                content: "",
+                error: `Invalid cron expression '${cron}'. Expected 5 fields: M H DoM Mon DoW.`,
+            };
+        }
+        // Check max jobs limit
+        const existingJobs = context.cronManager.listJobs();
+        if (existingJobs.length >= MAX_JOBS) {
+            return {
+                success: false,
+                content: "",
+                error: `Too many scheduled jobs (max ${MAX_JOBS}). Cancel one first.`,
+            };
+        }
         try {
             const job = context.cronManager.createJob({
                 cron,
                 prompt,
                 recurring,
             });
+            const humanSchedule = cronToHuman(cron);
+            const where = "Session-only (not written to disk, dies when Wave exits)";
+            const resultMessage = recurring
+                ? `Scheduled recurring job ${job.id} (${humanSchedule}). ${where}. Auto-expires after ${DEFAULT_MAX_AGE_DAYS} days. Use CronDelete to cancel sooner.`
+                : `Scheduled one-shot task ${job.id} (${humanSchedule}). ${where}. It will fire once then auto-delete.`;
             return {
                 success: true,
-                content: JSON.stringify({ id: job.id }, null, 2),
-                shortResult: `Scheduled job ${job.id}`,
+                content: JSON.stringify({ id: job.id, humanSchedule, recurring }, null, 2),
+                shortResult: resultMessage,
             };
         }
         catch (error) {

package/dist/tools/cronDeleteTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cronDeleteTool.d.ts","sourceRoot":"","sources":["../../src/tools/cronDeleteTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AAGjE,eAAO,MAAM,cAAc,EAAE,UA2C5B,CAAC"}
+{"version":3,"file":"cronDeleteTool.d.ts","sourceRoot":"","sources":["../../src/tools/cronDeleteTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AAOjE,eAAO,MAAM,cAAc,EAAE,UA4C5B,CAAC"}

package/dist/tools/cronDeleteTool.js

@@ -1,11 +1,14 @@
 import { CRON_DELETE_TOOL_NAME } from "../constants/tools.js";
+const CRON_DELETE_DESCRIPTION = "Cancel a scheduled cron job by ID";
+const CRON_DELETE_PROMPT = `Cancel a cron job previously scheduled with CronCreate. Removes it from the in-memory session store.`;
 export const cronDeleteTool = {
     name: CRON_DELETE_TOOL_NAME,
+    shouldDefer: true,
     config: {
         type: "function",
         function: {
             name: CRON_DELETE_TOOL_NAME,
-            description: "Cancel a cron job previously scheduled with CronCreate. Removes it from the in-memory session store.",
+            description: CRON_DELETE_DESCRIPTION,
             parameters: {
                 type: "object",
                 properties: {
@@ -18,6 +21,7 @@ export const cronDeleteTool = {
             },
         },
     },
+    prompt: () => CRON_DELETE_PROMPT,
     execute: async (args, context) => {
         const { id } = args;
         if (!context.cronManager) {

package/dist/tools/cronListTool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cronListTool.d.ts","sourceRoot":"","sources":["../../src/tools/cronListTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AAGjE,eAAO,MAAM,YAAY,EAAE,UAkC1B,CAAC"}
+{"version":3,"file":"cronListTool.d.ts","sourceRoot":"","sources":["../../src/tools/cronListTool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AAOjE,eAAO,MAAM,YAAY,EAAE,UAmC1B,CAAC"}

package/dist/tools/cronListTool.js

@@ -1,17 +1,21 @@
 import { CRON_LIST_TOOL_NAME } from "../constants/tools.js";
+const CRON_LIST_DESCRIPTION = "List scheduled cron jobs";
+const CRON_LIST_PROMPT = `List all cron jobs scheduled via CronCreate in this session.`;
 export const cronListTool = {
     name: CRON_LIST_TOOL_NAME,
+    shouldDefer: true,
     config: {
         type: "function",
         function: {
             name: CRON_LIST_TOOL_NAME,
-            description: "List all cron jobs scheduled via CronCreate in this session.",
+            description: CRON_LIST_DESCRIPTION,
             parameters: {
                 type: "object",
                 properties: {},
             },
         },
     },
+    prompt: () => CRON_LIST_PROMPT,
     execute: async (_args, context) => {
         if (!context.cronManager) {
             return {

package/dist/tools/enterWorktreeTool.d.ts

@@ -0,0 +1,8 @@
+/**
+ * EnterWorktree tool - creates an isolated git worktree and switches the session into it.
+ * Mirrors Claude Code's EnterWorktree tool behavior and prompt.
+ */
+import type { ToolPlugin } from "./types.js";
+export declare const ENTER_WORKTREE_TOOL_PROMPT = "Use this tool ONLY when the user explicitly asks to work in a worktree. This tool creates an isolated git worktree and switches the current session into it.\n\n## When to Use\n\n- The user explicitly says \"worktree\" (e.g., \"start a worktree\", \"work in a worktree\", \"create a worktree\", \"use a worktree\")\n\n## When NOT to Use\n\n- The user asks to create a branch, switch branches, or work on a different branch \u2014 use git commands instead\n- The user asks to fix a bug or work on a feature \u2014 use normal git workflow unless they specifically mention worktrees\n- Never use this tool unless the user explicitly mentions \"worktree\"\n\n## Requirements\n\n- Must be in a git repository\n- Must not already be in a worktree\n\n## Behavior\n\n- Creates a new git worktree inside `.wave/worktrees/` with a new branch based on HEAD\n- Switches the session's working directory to the new worktree\n- Use ExitWorktree to leave the worktree mid-session (keep or remove). On session exit, if still in the worktree, the user will be prompted to keep or remove it\n\n## Parameters\n\n- `name` (optional): A name for the worktree. Each \"/\"-separated segment may contain only letters, digits, dots, underscores, and dashes; max 64 chars total. A random name is generated if not provided.\n";
+export declare const enterWorktreeTool: ToolPlugin;
+//# sourceMappingURL=enterWorktreeTool.d.ts.map

package/dist/tools/enterWorktreeTool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enterWorktreeTool.d.ts","sourceRoot":"","sources":["../../src/tools/enterWorktreeTool.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAA2B,MAAM,YAAY,CAAC;AAetE,eAAO,MAAM,0BAA0B,qxCA0BtC,CAAC;AAEF,eAAO,MAAM,iBAAiB,EAAE,UAsI/B,CAAC"}