wave-agent-sdk 0.4.0 → 0.6.1

package/dist/agent.d.ts

@@ -1,9 +1,9 @@
 import { type MessageManagerCallbacks } from "./managers/messageManager.js";
 import { type SubagentManagerCallbacks } from "./managers/subagentManager.js";
 import { type McpManagerCallbacks } from "./managers/mcpManager.js";
-import { type BackgroundBashManagerCallbacks } from "./managers/backgroundBashManager.js";
+import { type BackgroundTaskManagerCallbacks } from "./managers/backgroundTaskManager.js";
 import type { SlashCommand, CustomSlashCommand, ILspManager, PluginConfig } from "./types/index.js";
-import type { Message, Logger, McpServerStatus, GatewayConfig, ModelConfig, Usage, PermissionMode, PermissionCallback } from "./types/index.js";
+import type { Message, Logger, McpServerStatus, GatewayConfig, ModelConfig, Usage, PermissionMode, PermissionCallback, BackgroundTask, ForegroundTask } from "./types/index.js";
 import { ClientOptions } from "openai";
 /**
  * Configuration options for Agent instances
@@ -44,14 +44,18 @@ export interface AgentOptions {
     /**Optional local plugins to load */
     plugins?: PluginConfig[];
 }
-export interface AgentCallbacks extends MessageManagerCallbacks, BackgroundBashManagerCallbacks, McpManagerCallbacks, SubagentManagerCallbacks {
+export interface AgentCallbacks extends MessageManagerCallbacks, BackgroundTaskManagerCallbacks, McpManagerCallbacks, SubagentManagerCallbacks {
+    onTasksChange?: (tasks: BackgroundTask[]) => void;
+    onSessionTasksChange?: (tasks: import("./types/tasks.js").Task[]) => void;
     onPermissionModeChange?: (mode: PermissionMode) => void;
+    onSubagentLatestTotalTokensChange?: (subagentId: string, tokens: number) => void;
+    onBackgroundCurrentTask?: () => void;
 }
 export declare class Agent {
     private messageManager;
     private aiManager;
     private bashManager;
-    private backgroundBashManager;
+    private backgroundTaskManager;
     private logger?;
     private toolManager;
     private mcpManager;
@@ -66,6 +70,8 @@ export declare class Agent {
     private reversionManager;
     private memoryRuleManager;
     private liveConfigManager;
+    private taskManager;
+    private foregroundTaskManager;
     private configurationService;
     private workdir;
     private systemPrompt?;
@@ -103,7 +109,6 @@ export declare class Agent {
      */
     private addUsage;
     get latestTotalTokens(): number;
-    get userInputHistory(): string[];
     /** Get working directory */
     get workingDirectory(): string;
     /** Get project memory content */
@@ -111,7 +116,7 @@ export declare class Agent {
     /** Get user memory content */
     get userMemory(): string;
     /** Get combined memory content (project + user + modular rules) */
-    get combinedMemory(): string;
+    getCombinedMemory(): Promise<string>;
     /** Get AI loading status */
     get isLoading(): boolean;
     /** Get message compression status */
@@ -126,6 +131,14 @@ export declare class Agent {
     } | null;
     /** Kill background bash shell */
     killBackgroundShell(id: string): boolean;
+    /** Get background task output */
+    getBackgroundTaskOutput(id: string, filter?: string): {
+        stdout: string;
+        stderr: string;
+        status: string;
+    } | null;
+    /** Stop background task */
+    stopBackgroundTask(id: string): boolean;
     /**
      * Static async factory method for creating Agent instances
      *
@@ -188,16 +201,25 @@ export declare class Agent {
     abortAIMessage(): void;
     /** Execute bash command */
     executeBashCommand(command: string): Promise<void>;
-    /** Clear messages and input history */
     clearMessages(): void;
     /** Unified interrupt method, interrupts both AI messages and command execution */
     abortMessage(): void;
-    /** Add to input history */
-    private addToInputHistory;
     /** Interrupt bash command execution */
     abortBashCommand(): void;
     /** Interrupt slash command execution */
     abortSlashCommand(): void;
+    /**
+     * Register a foreground task that can be backgrounded
+     */
+    registerForegroundTask(task: ForegroundTask): void;
+    /**
+     * Unregister a foreground task
+     */
+    unregisterForegroundTask(id: string): void;
+    /**
+     * Background the current foreground task
+     */
+    backgroundCurrentTask(): Promise<void>;
     /** Destroy managers, clean up resources */
     destroy(): Promise<void>;
     /**
@@ -239,8 +261,6 @@ export declare class Agent {
         path: string;
         mimeType: string;
     }>): Promise<void>;
-    /** Save memory to project or user memory file */
-    saveMemory(message: string, type: "project" | "user"): Promise<void>;
     /** Get all MCP server status */
     getMcpServers(): McpServerStatus[];
     /** Connect MCP server */
@@ -275,6 +295,13 @@ export declare class Agent {
      * @param index - The index of the user message to truncate to.
      */
     truncateHistory(index: number): Promise<void>;
+    /**
+     * Get the full message thread including parent sessions
+     */
+    getFullMessageThread(): Promise<{
+        messages: Message[];
+        sessionIds: string[];
+    }>;
     /**
      * Get the current plan file path (for testing and UI)
      */
@@ -297,5 +324,9 @@ export declare class Agent {
      * @param mode - The current effective permission mode
      */
     private handlePlanModeTransition;
+    /**
+     * Get the current task list ID
+     */
+    get taskListId(): string;
 }
 //# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAEL,KAAK,wBAAwB,EAC9B,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAc,KAAK,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAGhF,OAAO,EAEL,KAAK,8BAA8B,EACpC,MAAM,qCAAqC,CAAC;AAQ7C,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,WAAW,EACX,YAAY,EACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EACV,OAAO,EACP,MAAM,EACN,eAAe,EACf,aAAa,EACb,WAAW,EACX,KAAK,EACL,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,cAAc,EACf,MAAM,kBAAkB,CAAC;AAgB1B,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IAE3B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,YAAY,CAAC,EAAE,aAAa,CAAC,cAAc,CAAC,CAAC;IAC7C,KAAK,CAAC,EAAE,aAAa,CAAC,OAAO,CAAC,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAGlB,SAAS,CAAC,EAAE,cAAc,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,OAAO,EAAE,CAAC;IACrB,6DAA6D;IAC7D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,iFAAiF;IACjF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,6CAA6C;IAC7C,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,gCAAgC;IAChC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IAChC,uEAAuE;IACvE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,qFAAqF;IACrF,UAAU,CAAC,EAAE,WAAW,CAAC;IACzB,oCAAoC;IACpC,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,cACf,SAAQ,uBAAuB,EAC7B,8BAA8B,EAC9B,mBAAmB,EACnB,wBAAwB;IAC1B,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,KAAK,IAAI,CAAC;IAClD,oBAAoB,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,kBAAkB,EAAE,IAAI,EAAE,KAAK,IAAI,CAAC;IAC1E,sBAAsB,CAAC,EAAE,CAAC,IAAI,EAAE,cAAc,KAAK,IAAI,CAAC;IACxD,iCAAiC,CAAC,EAAE,CAClC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,MAAM,KACX,IAAI,CAAC;IACV,uBAAuB,CAAC,EAAE,MAAM,IAAI,CAAC;CACtC;AAED,qBAAa,KAAK;IAChB,OAAO,CAAC,cAAc,CAAiB;IACvC,OAAO,CAAC,SAAS,CAAY;IAE7B,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,qBAAqB,CAAwB;IACrD,OAAO,CAAC,MAAM,CAAC,CAAS;IACxB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,UAAU,CAAc;IAChC,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,eAAe,CAAkB;IACzC,OAAO,CAAC,mBAAmB,CAAsB;IACjD,OAAO,CAAC,aAAa,CAAgB;IACrC,OAAO,CAAC,YAAY,CAAe;IACnC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,gBAAgB,CAAmB;IAC3C,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,iBAAiB,CAAoB;IAC7C,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,qBAAqB,CAAwB;IACrD,OAAO,CAAC,oBAAoB,CAAuB;IACnD,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,YAAY,CAAC,CAAS;IAC9B,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,MAAM,CAAU;IAGxB,OAAO,CAAC,OAAO,CAAe;IAG9B,OAAO,CAAC,qBAAqB,CAAc;IAC3C,OAAO,CAAC,kBAAkB,CAAc;IAGjC,gBAAgB,IAAI,aAAa;IAUjC,cAAc,IAAI,WAAW;IAS7B,iBAAiB,IAAI,MAAM;IAM3B,WAAW,IAAI,MAAM,GAAG,SAAS;IAIxC;;;;;;;;OAQG;IACH,OAAO;IAoQP,IAAW,SAAS,IAAI,MAAM,CAE7B;IAED,IAAW,QAAQ,IAAI,OAAO,EAAE,CAE/B;IAED,IAAW,MAAM,IAAI,KAAK,EAAE,CAE3B;IAED,IAAW,eAAe,IAAI,MAAM,CAEnC;IAED;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAWhC;;;OAGG;IACH,OAAO,CAAC,QAAQ;IAKhB,IAAW,iBAAiB,IAAI,MAAM,CAErC;IAED,4BAA4B;IAC5B,IAAW,gBAAgB,IAAI,MAAM,CAEpC;IAED,iCAAiC;IACjC,IAAW,aAAa,IAAI,MAAM,CAEjC;IAED,8BAA8B;IAC9B,IAAW,UAAU,IAAI,MAAM,CAE9B;IAED,mEAAmE;IACtD,iBAAiB,IAAI,OAAO,CAAC,MAAM,CAAC;IAIjD,4BAA4B;IAC5B,IAAW,SAAS,IAAI,OAAO,CAE9B;IAED,qCAAqC;IACrC,IAAW,aAAa,IAAI,OAAO,CAElC;IAED,wCAAwC;IACxC,IAAW,gBAAgB,IAAI,OAAO,CAErC;IAED,uCAAuC;IAChC,wBAAwB,CAC7B,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,MAAM,GACd;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAI5D,iCAAiC;IAC1B,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI/C,iCAAiC;IAC1B,uBAAuB,CAC5B,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,MAAM,GACd;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAI5D,2BAA2B;IACpB,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI9C;;;;;;;;OAQG;IACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OA6BG;WACU,MAAM,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,KAAK,CAAC;IAW1D;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;IAehC,wEAAwE;YAC1D,UAAU;IA2MxB;;;OAGG;YACW,uBAAuB;IA2ErC;;;OAGG;IACU,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA6CtD,cAAc,IAAI,IAAI;IAI7B,2BAA2B;IACd,kBAAkB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIxD,aAAa,IAAI,IAAI;IAI5B,kFAAkF;IAC3E,YAAY,IAAI,IAAI;IAM3B,uCAAuC;IAChC,gBAAgB,IAAI,IAAI;IAI/B,wCAAwC;IACjC,iBAAiB,IAAI,IAAI;IAIhC;;OAEG;IACI,sBAAsB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IAIzD;;OAEG;IACI,wBAAwB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAIjD;;OAEG;IACU,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAKnD,2CAA2C;IAC9B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IA2BrC;;;OAGG;IACI,mBAAmB,CACxB,UAAU,EAAE,MAAM,GACjB,OAAO,+BAA+B,EAAE,gBAAgB,GAAG,IAAI;IAIlE;;OAEG;IACI,iBAAiB,IAAI,IAAI;IAIhC;;;;;;;;;;;;;;;;;;;;;;;;;OAyBG;IACU,WAAW,CACtB,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC,GACjD,OAAO,CAAC,IAAI,CAAC;IAiFhB,gCAAgC;IACzB,aAAa,IAAI,eAAe,EAAE;IAIzC,yBAAyB;IACZ,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAInE,4BAA4B;IACf,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAMtE,uCAAuC;IAChC,gBAAgB,IAAI,YAAY,EAAE;IAIzC,oCAAoC;IAC7B,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IAIlD,6BAA6B;IACtB,oBAAoB,IAAI,IAAI;IAInC,iCAAiC;IAC1B,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAI1E,8BAA8B;IACvB,iBAAiB,IAAI,kBAAkB,EAAE;IAIhD;;OAEG;IACI,oBAAoB,CAAC,OAAO,EAAE,YAAY,GAAG,IAAI;IAIxD;;OAEG;IACI,iBAAiB,IAAI,cAAc;IAI1C;;;OAGG;IACI,iBAAiB,CAAC,IAAI,EAAE,cAAc,GAAG,IAAI;IASpD;;;OAGG;IACU,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI1D;;OAEG;IACU,oBAAoB,IAAI,OAAO,CAAC;QAC3C,QAAQ,EAAE,OAAO,EAAE,CAAC;QACpB,UAAU,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;IAIF;;OAEG;IACI,eAAe,IAAI,MAAM,GAAG,SAAS;IAI5C;;OAEG;IACI,eAAe,IAAI,MAAM,EAAE;IAIlC;;OAEG;IACU,eAAe,CAC1B,OAAO,EAAE,OAAO,wBAAwB,EAAE,qBAAqB,GAC9D,OAAO,CAAC,OAAO,wBAAwB,EAAE,kBAAkB,CAAC;IAI/D;;;OAGG;IACU,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAkC3D;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAgBhC;;OAEG;IACH,IAAW,UAAU,IAAI,MAAM,CAE9B;CACF"}

package/dist/agent.js

@@ -1,12 +1,12 @@
+import { ForegroundTaskManager } from "./managers/foregroundTaskManager.js";
 import { MessageManager, } from "./managers/messageManager.js";
 import { AIManager } from "./managers/aiManager.js";
 import { ToolManager } from "./managers/toolManager.js";
 import { SubagentManager, } from "./managers/subagentManager.js";
-import * as memory from "./services/memory.js";
 import { McpManager } from "./managers/mcpManager.js";
 import { LspManager } from "./managers/lspManager.js";
 import { BashManager } from "./managers/bashManager.js";
-import { BackgroundBashManager, } from "./managers/backgroundBashManager.js";
+import { BackgroundTaskManager, } from "./managers/backgroundTaskManager.js";
 import { SlashCommandManager } from "./managers/slashCommandManager.js";
 import { PluginManager } from "./managers/pluginManager.js";
 import { HookManager } from "./managers/hookManager.js";
@@ -18,6 +18,7 @@ import { MemoryRuleManager } from "./managers/MemoryRuleManager.js";
 import { LiveConfigManager } from "./managers/liveConfigManager.js";
 import { configValidator } from "./utils/configValidator.js";
 import { SkillManager } from "./managers/skillManager.js";
+import { TaskManager } from "./services/taskManager.js";
 import { loadSessionFromJsonl, handleSessionRestoration, } from "./services/session.js";
 import { setGlobalLogger } from "./utils/globalLogger.js";
 import { ConfigurationService } from "./services/configurationService.js";
@@ -63,8 +64,47 @@ export class Agent {
         this.stream = stream; // Save streaming mode flag
         // Store options for dynamic configuration resolution
         this.options = options;
-        this.backgroundBashManager = new BackgroundBashManager({
-            callbacks,
+        this.foregroundTaskManager = new ForegroundTaskManager();
+        // Initialize memory rule manager
+        this.memoryRuleManager = new MemoryRuleManager({
+            workdir: this.workdir,
+        });
+        // Initialize MessageManager
+        this.messageManager = new MessageManager({
+            callbacks: {
+                ...callbacks,
+                onSessionIdChange: (sessionId) => {
+                    // When session ID changes (e.g. due to compression),
+                    // we update the task manager to use the root session ID
+                    // to ensure the task list remains consistent.
+                    this.taskManager.setTaskListId(this.messageManager.getRootSessionId());
+                    callbacks.onSessionIdChange?.(sessionId);
+                },
+                onSubagentTaskStopRequested: (subagentId) => {
+                    this.backgroundTaskManager.stopTask(subagentId);
+                },
+            },
+            workdir: this.workdir,
+            logger: this.logger,
+            memoryRuleManager: this.memoryRuleManager,
+        });
+        // Resolve taskListId once during construction to ensure stability
+        const resolvedTaskListId = this.configurationService.getEnvironmentVars().WAVE_TASK_LIST_ID ||
+            process.env.WAVE_TASK_LIST_ID ||
+            this.messageManager.getRootSessionId();
+        this.taskManager = new TaskManager(resolvedTaskListId);
+        this.taskManager.on("tasksChange", async () => {
+            const tasks = await this.taskManager.listTasks();
+            this.options.callbacks?.onSessionTasksChange?.(tasks);
+        });
+        // Initialize BackgroundTaskManager
+        this.backgroundTaskManager = new BackgroundTaskManager({
+            callbacks: {
+                ...callbacks,
+                onTasksChange: (tasks) => {
+                    callbacks.onTasksChange?.(tasks);
+                },
+            },
             workdir: this.workdir,
         });
         this.mcpManager = new McpManager({ callbacks, logger: this.logger }); // Initialize MCP manager
@@ -88,18 +128,8 @@ export class Agent {
             logger: this.logger,
             workdir: this.workdir,
         });
-        // Initialize MessageManager
-        this.messageManager = new MessageManager({
-            callbacks,
-            workdir: this.workdir,
-            logger: this.logger,
-        });
-        // Initialize ReversionManager
+        // ReversionManager depends on MessageManager
         this.reversionManager = new ReversionManager(new ReversionService(this.messageManager.getTranscriptPath()));
-        // Initialize memory rule manager
-        this.memoryRuleManager = new MemoryRuleManager({
-            workdir: this.workdir,
-        });
         // Create a wrapper for canUseTool that triggers notification hooks
         const canUseToolWithNotification = options.canUseTool
             ? async (context) => {
@@ -146,6 +176,9 @@ export class Agent {
             reversionManager: this.reversionManager,
             permissionMode: options.permissionMode, // Let PermissionManager handle defaultMode resolution
             canUseToolCallback: canUseToolWithNotification,
+            taskManager: this.taskManager,
+            backgroundTaskManager: this.backgroundTaskManager,
+            foregroundTaskManager: this.foregroundTaskManager,
         }); // Initialize tool registry with permission support
         this.liveConfigManager = new LiveConfigManager({
             workdir: this.workdir,
@@ -167,6 +200,7 @@ export class Agent {
                 onSubagentAssistantReasoningUpdated: callbacks.onSubagentAssistantReasoningUpdated,
                 onSubagentToolBlockUpdated: callbacks.onSubagentToolBlockUpdated,
                 onSubagentMessagesChange: callbacks.onSubagentMessagesChange,
+                onSubagentLatestTotalTokensChange: callbacks.onSubagentLatestTotalTokensChange,
             }, // Pass subagent callbacks for forwarding
             logger: this.logger,
             getGatewayConfig: () => this.getGatewayConfig(),
@@ -175,13 +209,17 @@ export class Agent {
             getLanguage: () => this.getLanguage(),
             hookManager: this.hookManager,
             onUsageAdded: (usage) => this.addUsage(usage),
+            backgroundTaskManager: this.backgroundTaskManager,
+            taskManager: this.taskManager,
+            memoryRuleManager: this.memoryRuleManager,
         });
         // Initialize AI manager with resolved configuration
         this.aiManager = new AIManager({
             messageManager: this.messageManager,
             toolManager: this.toolManager,
+            taskManager: this.taskManager,
             logger: this.logger,
-            backgroundBashManager: this.backgroundBashManager,
+            backgroundTaskManager: this.backgroundTaskManager,
             hookManager: this.hookManager,
             permissionManager: this.permissionManager,
             callbacks: {
@@ -204,6 +242,8 @@ export class Agent {
         this.slashCommandManager = new SlashCommandManager({
             messageManager: this.messageManager,
             aiManager: this.aiManager,
+            backgroundTaskManager: this.backgroundTaskManager,
+            taskManager: this.taskManager,
             workdir: this.workdir,
             logger: this.logger,
         });
@@ -266,9 +306,6 @@ export class Agent {
     get latestTotalTokens() {
         return this.messageManager.getlatestTotalTokens();
     }
-    get userInputHistory() {
-        return this.messageManager.getUserInputHistory();
-    }
     /** Get working directory */
     get workingDirectory() {
         return this.workdir;
@@ -282,31 +319,8 @@ export class Agent {
         return this._userMemoryContent;
     }
     /** Get combined memory content (project + user + modular rules) */
-    get combinedMemory() {
-        let combined = "";
-        if (this._projectMemoryContent.trim()) {
-            combined += this._projectMemoryContent;
-        }
-        if (this._userMemoryContent.trim()) {
-            if (combined) {
-                combined += "\n\n";
-            }
-            combined += this._userMemoryContent;
-        }
-        // Add modular memory rules
-        const filesInContext = this.messageManager.getFilesInContext();
-        const activeRules = this.memoryRuleManager.getActiveRules(filesInContext);
-        if (activeRules.length > 0) {
-            this.logger?.debug(`Active modular rules (${activeRules.length}): ${activeRules.map((r) => r.id).join(", ")}`);
-            if (combined) {
-                combined += "\n\n";
-            }
-            combined += activeRules.map((r) => r.content).join("\n\n");
-        }
-        else {
-            this.logger?.debug("No active modular rules for current context");
-        }
-        return combined;
+    async getCombinedMemory() {
+        return this.messageManager.getCombinedMemory();
     }
     /** Get AI loading status */
     get isLoading() {
@@ -322,11 +336,19 @@ export class Agent {
     }
     /** Get background bash shell output */
     getBackgroundShellOutput(id, filter) {
-        return this.backgroundBashManager.getOutput(id, filter);
+        return this.backgroundTaskManager.getOutput(id, filter);
     }
     /** Kill background bash shell */
     killBackgroundShell(id) {
-        return this.backgroundBashManager.killShell(id);
+        return this.backgroundTaskManager.stopTask(id);
+    }
+    /** Get background task output */
+    getBackgroundTaskOutput(id, filter) {
+        return this.backgroundTaskManager.getOutput(id, filter);
+    }
+    /** Stop background task */
+    stopBackgroundTask(id) {
+        return this.backgroundTaskManager.stopTask(id);
     }
     /**
      * Static async factory method for creating Agent instances
@@ -529,8 +551,14 @@ export class Agent {
             this.rebuildUsageFromMessages(sessionToRestore?.messages || []);
             // After main session is restored, restore any associated subagent sessions
             await this.restoreSubagentSessions(sessionToRestore?.messages || []);
-            if (sessionToRestore)
+            if (sessionToRestore) {
                 this.messageManager.initializeFromSession(sessionToRestore);
+                // Update task manager with the root session ID to ensure continuity across compressions
+                this.taskManager.setTaskListId(sessionToRestore.rootSessionId || sessionToRestore.id);
+                // After session is initialized, load tasks for the session
+                const tasks = await this.taskManager.listTasks();
+                this.options.callbacks?.onSessionTasksChange?.(tasks);
+            }
         }
     }
     /**
@@ -622,17 +650,19 @@ export class Agent {
         await this.restoreSubagentSessions(sessionData.messages);
         // 6. Initialize session state last
         this.messageManager.initializeFromSession(sessionData);
+        // Update task manager with the root session ID to ensure continuity across compressions
+        this.taskManager.setTaskListId(sessionData.rootSessionId || sessionData.id);
+        // 7. Load tasks for the restored session
+        const tasks = await this.taskManager.listTasks();
+        this.options.callbacks?.onSessionTasksChange?.(tasks);
     }
     abortAIMessage() {
         this.aiManager.abortAIMessage();
     }
     /** Execute bash command */
     async executeBashCommand(command) {
-        // Add user message to history (but not displayed in UI)
-        this.addToInputHistory(`!${command}`);
         await this.bashManager?.executeCommand(command);
     }
-    /** Clear messages and input history */
     clearMessages() {
         this.messageManager.clearMessages();
     }
@@ -642,10 +672,6 @@ export class Agent {
         this.abortBashCommand();
         this.abortSlashCommand();
     }
-    /** Add to input history */
-    addToInputHistory(input) {
-        this.messageManager.addToInputHistory(input);
-    }
     /** Interrupt bash command execution */
     abortBashCommand() {
         this.bashManager?.abortCommand();
@@ -654,14 +680,33 @@ export class Agent {
     abortSlashCommand() {
         this.slashCommandManager.abortCurrentCommand();
     }
+    /**
+     * Register a foreground task that can be backgrounded
+     */
+    registerForegroundTask(task) {
+        this.foregroundTaskManager.registerForegroundTask(task);
+    }
+    /**
+     * Unregister a foreground task
+     */
+    unregisterForegroundTask(id) {
+        this.foregroundTaskManager.unregisterForegroundTask(id);
+    }
+    /**
+     * Background the current foreground task
+     */
+    async backgroundCurrentTask() {
+        await this.foregroundTaskManager.backgroundCurrentTask();
+        this.options.callbacks?.onBackgroundCurrentTask?.();
+    }
     /** Destroy managers, clean up resources */
     async destroy() {
         await this.messageManager.saveSession();
         this.abortAIMessage(); // This will abort tools including Task tool (subagents)
         this.abortBashCommand();
         this.abortSlashCommand();
-        // Cleanup background bash manager
-        this.backgroundBashManager.cleanup();
+        // Cleanup background task manager
+        this.backgroundTaskManager.cleanup();
         // Cleanup MCP connections
         await this.mcpManager.cleanup();
         // Cleanup LSP connections
@@ -730,16 +775,12 @@ export class Agent {
                 if (isValid && commandId !== undefined) {
                     // Execute valid slash command
                     await this.slashCommandManager.executeCommand(commandId, args);
-                    // Add slash command to history
-                    this.addToInputHistory(command);
                     return;
                 }
                 // If command doesn't exist, continue as normal message processing
                 // Don't add to history, let normal message processing logic below handle it
             }
             // Handle normal AI message
-            // Add user message to history
-            this.addToInputHistory(content);
             // Add user message first, will automatically sync to UI
             this.messageManager.addUserMessage({
                 content,
@@ -783,60 +824,6 @@ export class Agent {
             // Loading state will be automatically updated by the useEffect that watches messages
         }
     }
-    /** Save memory to project or user memory file */
-    async saveMemory(message, type) {
-        try {
-            // Ensure the message starts with # for memory functions
-            const formattedMessage = message.startsWith("#")
-                ? message
-                : `#${message}`;
-            if (type === "project") {
-                await memory.addMemory(formattedMessage, this.workdir);
-                // Update internal state after successful save
-                this._projectMemoryContent = await memory.readMemoryFile(this.workdir);
-            }
-            else {
-                await memory.addUserMemory(formattedMessage);
-                // Update internal state after successful save
-                this._userMemoryContent = await memory.getUserMemoryContent();
-            }
-            // Add successful MemoryBlock to the last assistant message
-            const memoryText = message.substring(1).trim();
-            const typeLabel = type === "project" ? "Project Memory" : "User Memory";
-            const storagePath = "AGENTS.md";
-            const messages = this.messageManager.getMessages();
-            const lastMessage = messages[messages.length - 1];
-            if (lastMessage && lastMessage.role === "assistant") {
-                lastMessage.blocks.push({
-                    type: "memory",
-                    content: `${typeLabel}: ${memoryText}`,
-                    isSuccess: true,
-                    memoryType: type,
-                    storagePath,
-                });
-                this.messageManager.setMessages(messages);
-            }
-        }
-        catch (error) {
-            // Add failed MemoryBlock to the last assistant message
-            const memoryText = message.substring(1).trim();
-            const typeLabel = type === "project" ? "Project Memory" : "User Memory";
-            const storagePath = "AGENTS.md";
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            const messages = this.messageManager.getMessages();
-            const lastMessage = messages[messages.length - 1];
-            if (lastMessage && lastMessage.role === "assistant") {
-                lastMessage.blocks.push({
-                    type: "memory",
-                    content: `${typeLabel}: ${memoryText} - Error: ${errorMessage}`,
-                    isSuccess: false,
-                    memoryType: type,
-                    storagePath,
-                });
-                this.messageManager.setMessages(messages);
-            }
-        }
-    }
     // ========== MCP Management Methods ==========
     /** Get all MCP server status */
     getMcpServers() {
@@ -900,6 +887,12 @@ export class Agent {
     async truncateHistory(index) {
         await this.messageManager.truncateHistory(index, this.reversionManager);
     }
+    /**
+     * Get the full message thread including parent sessions
+     */
+    async getFullMessageThread() {
+        return this.messageManager.getFullMessageThread();
+    }
     /**
      * Get the current plan file path (for testing and UI)
      */
@@ -958,7 +951,7 @@ export class Agent {
     handlePlanModeTransition(mode) {
         if (mode === "plan") {
             this.planManager
-                .getOrGeneratePlanFilePath()
+                .getOrGeneratePlanFilePath(this.messageManager.getRootSessionId())
                 .then(({ path }) => {
                 this.logger?.debug("Plan file path generated", { path });
                 this.permissionManager.setPlanFilePath(path);
@@ -971,4 +964,10 @@ export class Agent {
             this.permissionManager.setPlanFilePath(undefined);
         }
     }
+    /**
+     * Get the current task list ID
+     */
+    get taskListId() {
+        return this.taskManager.getTaskListId();
+    }
 }

package/dist/constants/prompts.d.ts

@@ -1,20 +1,24 @@
+import { ToolPlugin } from "../tools/types.js";
 export declare const BASE_SYSTEM_PROMPT = "You are an interactive CLI tool that helps users with software engineering tasks. Use the instructions below and the tools available to you to assist the user.\n\n# Doing tasks\nThe user will primarily request you perform software engineering tasks. This includes solving bugs, adding new functionality, refactoring code, explaining code, and more. For these tasks the following steps are recommended:\n- NEVER propose changes to code you haven't read. If a user asks about or wants you to modify a file, read it first. Understand existing code before suggesting modifications.\n- Be careful not to introduce security vulnerabilities such as command injection, XSS, SQL injection, and other OWASP top 10 vulnerabilities. If you notice that you wrote insecure code, immediately fix it.\n- Avoid over-engineering. Only make changes that are directly requested or clearly necessary. Keep solutions simple and focused.\n  - Don't add features, refactor code, or make \"improvements\" beyond what was asked. A bug fix doesn't need surrounding code cleaned up. A simple feature doesn't need extra configurability. Don't add docstrings, comments, or type annotations to code you didn't change. Only add comments where the logic isn't self-evident.\n  - Don't add error handling, fallbacks, or validation for scenarios that can't happen. Trust internal code and framework guarantees. Only validate at system boundaries (user input, external APIs). Don't use feature flags or backwards-compatibility shims when you can just change the code.\n  - Don't create helpers, utilities, or abstractions for one-time operations. Don't design for hypothetical future requirements. The right amount of complexity is the minimum needed for the current task\u2014three similar lines of code is better than a premature abstraction.\n- Avoid backwards-compatibility hacks like renaming unused `_vars`, re-exporting types, adding `// removed` comments for removed code, etc. If something is unused, delete it completely.\n\n# Tool usage policy\n- You can call multiple tools in a single response. If you intend to call multiple tools and there are no dependencies between them, make all independent tool calls in parallel. Maximize use of parallel tool calls where possible to increase efficiency.\n- However, if some tool calls depend on previous calls to inform dependent values, do NOT call these tools in parallel and instead call them sequentially. For instance, if one operation must complete before another starts, run these operations sequentially instead. Never use placeholders or guess missing parameters in tool calls.\n- If the user specifies that they want you to run tools \"in parallel\", you MUST send a single message with multiple tool use content blocks.";
-export declare const TASK_MANAGEMENT_POLICY = "\n# Task Management\nYou have access to the TodoWrite tools to help you manage and plan tasks. Use these tools VERY frequently to ensure that you are tracking your tasks and giving the user visibility into your progress.\nThese tools are also EXTREMELY helpful for planning tasks, and for breaking down larger complex tasks into smaller steps. If you do not use this tool when planning, you may forget to do important tasks - and that is unacceptable.\nIt is critical that you mark todos as completed as soon as you are done with a task. Do not batch up multiple tasks before marking them as completed.";
-export declare const ASK_USER_POLICY = "\n# Asking questions as you work\nYou have access to the AskUserQuestion tool to ask the user questions when you need clarification, want to validate assumptions, or need to make a decision you're unsure about. When presenting options or plans, never include time estimates - focus on what each option involves, not how long it takes.";
-export declare const SUBAGENT_POLICY = "\n- When doing file search, prefer to use the Task tool in order to reduce context usage.\n- You should proactively use the Task tool with specialized agents when the task at hand matches the agent's description.\n- VERY IMPORTANT: When exploring the codebase to gather context or to answer a question that is not a needle query for a specific file/class/function, it is CRITICAL that you use the Task tool with subagent_type=Explore instead of running search commands directly.";
-export declare const FILE_TOOL_POLICY_PREFIX = "\n- Use specialized tools instead of bash commands when possible, as this provides a better user experience. For file operations, use dedicated tools:";
-export declare const READ_FILE_POLICY = " Read for reading files instead of cat/head/tail";
-export declare const EDIT_FILE_POLICY = " Edit/MultiEdit for editing instead of sed/awk";
-export declare const WRITE_FILE_POLICY = " Write for creating files instead of cat with heredoc or echo redirection";
-export declare const SEARCH_FILE_POLICY = " LS/Glob/Grep for searching and listing files instead of find/ls/grep";
-export declare const BASH_POLICY = "\n- Reserve bash tools exclusively for actual system commands and terminal operations that require shell execution. NEVER use bash echo or other command-line tools to communicate thoughts, explanations, or instructions to the user. Output all communication directly in your response text instead.\n- When making multiple bash tool calls, you MUST send a single message with multiple tools calls to run the calls in parallel. For example, if you need to run \"git status\" and \"git diff\", send a single message with two tool calls to run the calls in parallel.";
+export declare const TASK_MANAGEMENT_POLICY = "\n# Task Management\nYou have access to the TaskCreate, TaskGet, TaskUpdate, and TaskList tools to help you manage and plan tasks. Use these tools VERY frequently to ensure that you are tracking your tasks and giving the user visibility into your progress.\nThese tools are also EXTREMELY helpful for planning tasks, and for breaking down larger complex tasks into smaller steps. If you do not use this tool when planning, you may forget to do important tasks - and that is unacceptable.\nIt is critical that you mark tasks as completed as soon as you are done with a task. Do not batch up multiple tasks before marking them as completed.";
+export declare function buildPlanModePrompt(planFilePath: string, planExists: boolean): string;
 export declare const DEFAULT_SYSTEM_PROMPT = "You are an interactive CLI tool that helps users with software engineering tasks. Use the instructions below and the tools available to you to assist the user.\n\n# Doing tasks\nThe user will primarily request you perform software engineering tasks. This includes solving bugs, adding new functionality, refactoring code, explaining code, and more. For these tasks the following steps are recommended:\n- NEVER propose changes to code you haven't read. If a user asks about or wants you to modify a file, read it first. Understand existing code before suggesting modifications.\n- Be careful not to introduce security vulnerabilities such as command injection, XSS, SQL injection, and other OWASP top 10 vulnerabilities. If you notice that you wrote insecure code, immediately fix it.\n- Avoid over-engineering. Only make changes that are directly requested or clearly necessary. Keep solutions simple and focused.\n  - Don't add features, refactor code, or make \"improvements\" beyond what was asked. A bug fix doesn't need surrounding code cleaned up. A simple feature doesn't need extra configurability. Don't add docstrings, comments, or type annotations to code you didn't change. Only add comments where the logic isn't self-evident.\n  - Don't add error handling, fallbacks, or validation for scenarios that can't happen. Trust internal code and framework guarantees. Only validate at system boundaries (user input, external APIs). Don't use feature flags or backwards-compatibility shims when you can just change the code.\n  - Don't create helpers, utilities, or abstractions for one-time operations. Don't design for hypothetical future requirements. The right amount of complexity is the minimum needed for the current task\u2014three similar lines of code is better than a premature abstraction.\n- Avoid backwards-compatibility hacks like renaming unused `_vars`, re-exporting types, adding `// removed` comments for removed code, etc. If something is unused, delete it completely.\n\n# Tool usage policy\n- You can call multiple tools in a single response. If you intend to call multiple tools and there are no dependencies between them, make all independent tool calls in parallel. Maximize use of parallel tool calls where possible to increase efficiency.\n- However, if some tool calls depend on previous calls to inform dependent values, do NOT call these tools in parallel and instead call them sequentially. For instance, if one operation must complete before another starts, run these operations sequentially instead. Never use placeholders or guess missing parameters in tool calls.\n- If the user specifies that they want you to run tools \"in parallel\", you MUST send a single message with multiple tool use content blocks.";
+export declare const BASH_SUBAGENT_SYSTEM_PROMPT = "You are a command execution specialist. Your role is to execute bash commands efficiently and safely.\n\nGuidelines:\n- Execute commands precisely as instructed\n- For git operations, follow git safety protocols\n- Report command output clearly and concisely\n- If a command fails, explain the error and suggest solutions\n- Use command chaining (&&) for dependent operations\n- Quote paths with spaces properly\n- For clear communication, avoid using emojis\n\nComplete the requested operations efficiently.";
 export declare const GENERAL_PURPOSE_SYSTEM_PROMPT = "You are an agent. Given the user's message, you should use the tools available to complete the task. Do what has been asked; nothing more, nothing less. When you complete the task simply respond with a detailed writeup.\n\nYour strengths:\n- Searching for code, configurations, and patterns across large codebases\n- Analyzing multiple files to understand system architecture\n- Investigating complex questions that require exploring many files\n- Performing multi-step research tasks\n\nGuidelines:\n- For file searches: Use Grep or Glob when you need to search broadly. Use Read when you know the specific file path.\n- For analysis: Start broad and narrow down. Use multiple search strategies if the first doesn't yield results.\n- Be thorough: Check multiple locations, consider different naming conventions, look for related files.\n- NEVER create files unless they're absolutely necessary for achieving your goal. ALWAYS prefer editing an existing file to creating a new one.\n- NEVER proactively create documentation files (*.md) or README files. Only create documentation files if explicitly requested.\n- In your final response always share relevant file names and code snippets. Any file paths you return in your response MUST be absolute. Do NOT use relative paths.\n- For clear communication, avoid using emojis.";
+export declare const PLAN_SUBAGENT_SYSTEM_PROMPT = "You are a software architect and planning specialist. Your role is to explore the codebase and design implementation plans.\n\n=== CRITICAL: READ-ONLY MODE - NO FILE MODIFICATIONS ===\nThis is a READ-ONLY planning task. You are STRICTLY PROHIBITED from:\n- Creating new files (no Write, touch, or file creation of any kind)\n- Modifying existing files (no Edit operations)\n- Deleting files (no rm or deletion)\n- Moving or copying files (no mv or cp)\n- Creating temporary files anywhere, including /tmp\n- Using redirect operators (>, >>, |) or heredocs to write to files\n- Running ANY commands that change system state\n\nYour role is EXCLUSIVELY to explore the codebase and design implementation plans. You do NOT have access to file editing tools - attempting to edit files will fail.\n\nYou will be provided with a set of requirements and optionally a perspective on how to approach the design process.\n\n## Your Process\n\n1. **Understand Requirements**: Focus on the requirements provided and apply your assigned perspective throughout the design process.\n\n2. **Explore Thoroughly**:\n   - Read any files provided to you in the initial prompt\n   - Find existing patterns and conventions using Glob, Grep, and Read\n   - Understand the current architecture\n   - Identify similar features as reference\n   - Trace through relevant code paths\n   - Use Bash ONLY for read-only operations (ls, git status, git log, git diff, find, cat, head, tail)\n   - NEVER use Bash for: mkdir, touch, rm, cp, mv, git add, git commit, npm install, pip install, or any file creation/modification\n\n3. **Design Solution**:\n   - Create implementation approach based on your assigned perspective\n   - Consider trade-offs and architectural decisions\n   - Follow existing patterns where appropriate\n\n4. **Detail the Plan**:\n   - Provide step-by-step implementation strategy\n   - Identify dependencies and sequencing\n   - Anticipate potential challenges\n\n## Required Output\n\nEnd your response with:\n\n### Critical Files for Implementation\nList 3-5 files most critical for implementing this plan:\n- path/to/file1.ts - [Brief reason: e.g., \"Core logic to modify\"]\n- path/to/file2.ts - [Brief reason: e.g., \"Interfaces to implement\"]\n- path/to/file3.ts - [Brief reason: e.g., \"Pattern to follow\"]\n\nREMEMBER: You can ONLY explore and plan. You CANNOT and MUST NOT write, edit, or modify any files. You do NOT have access to file editing tools.";
 export declare const INIT_PROMPT = "Please analyze this codebase and create a AGENTS.md file, which will be given to future instances of Agent to operate in this repository.\n\nWhat to add:\n1. Commands that will be commonly used, such as how to build, lint, and run tests. Include the necessary commands to develop in this codebase, such as how to run a single test.\n2. High-level code architecture and structure so that future instances can be productive more quickly. Focus on the \"big picture\" architecture that requires reading multiple files to understand.\n\nUsage notes:\n- If there's already a AGENTS.md, suggest improvements to it.\n- When you make the initial AGENTS.md, do not repeat yourself and do not include obvious instructions like \"Provide helpful error messages to users\", \"Write unit tests for all new utilities\", \"Never include sensitive information (API keys, tokens) in code or commits\".\n- Avoid listing every component or file structure that can be easily discovered.\n- Don't include generic development practices.\n- If there are Cursor rules (in .cursor/rules/ or .cursorrules) or Copilot rules (in .github/copilot-instructions.md), make sure to include the important parts.\n- If there is a README.md, make sure to include the important parts.\n- Do not make up information such as \"Common Development Tasks\", \"Tips for Development\", \"Support and Documentation\" unless this is expressly included in other files that you read.\n- Be sure to prefix the file with the following text:\n\n```\n# AGENTS.md\n\nThis file provides guidance to Agent when working with code in this repository.\n```";
-export declare function buildSystemPrompt(basePrompt: string, tools: {
-    name?: string;
-    function?: {
-        name: string;
+export declare const COMPRESS_MESSAGES_SYSTEM_PROMPT = "You have been working on the task described above but have not yet completed it. Write a continuation summary that will allow you (or another instance of yourself) to resume work efficiently in a future context window where the conversation history will be replaced with this summary. Your summary should be structured, concise, and actionable. Include:\n1. Task Overview\nThe user's core request and success criteria\nAny clarifications or constraints they specified\n2. Current State\nWhat has been completed so far\nFiles created, modified, or analyzed (with paths if relevant)\nKey outputs or artifacts produced\n3. Important Discoveries\nTechnical constraints or requirements uncovered\nDecisions made and their rationale\nErrors encountered and how they were resolved\nWhat approaches were tried that didn't work (and why)\n4. Next Steps\nSpecific actions needed to complete the task\nAny blockers or open questions to resolve\nPriority order if multiple steps remain\n5. Context to Preserve\nUser preferences or style requirements\nDomain-specific details that aren't obvious\nAny promises made to the user\nBe concise but complete\u2014err on the side of including information that would prevent duplicate work or repeated mistakes. Write in a way that enables immediate resumption of the task.\nWrap your summary in <summary></summary> tags.";
+export declare function buildSystemPrompt(basePrompt: string | undefined, tools: ToolPlugin[], options?: {
+    workdir?: string;
+    isGitRepo?: string;
+    platform?: string;
+    osVersion?: string;
+    today?: string;
+    memory?: string;
+    language?: string;
+    planMode?: {
+        planFilePath: string;
+        planExists: boolean;
     };
-}[]): string;
+}): string;
 //# sourceMappingURL=prompts.d.ts.map

package/dist/constants/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/constants/prompts.ts"],"names":[],"mappings":"AAcA,eAAO,MAAM,kBAAkB,ksFAe8G,CAAC;AAE9I,eAAO,MAAM,sBAAsB,+lBAImH,CAAC;AAEvJ,eAAO,MAAM,eAAe,mVAEgS,CAAC;AAE7T,eAAO,MAAM,eAAe,meAG0P,CAAC;AAEvR,eAAO,MAAM,uBAAuB,2JAA2J,CAAC;AAChM,eAAO,MAAM,gBAAgB,qDAAkE,CAAC;AAChG,eAAO,MAAM,gBAAgB,mDAA8E,CAAC;AAC5G,eAAO,MAAM,iBAAiB,8EAA2F,CAAC;AAC1H,eAAO,MAAM,kBAAkB,0EAAiH,CAAC;AAEjJ,eAAO,MAAM,WAAW,sjBAE4O,CAAC;AAErQ,eAAO,MAAM,qBAAqB,ksFAAqB,CAAC;AAExD,eAAO,MAAM,6BAA6B,izCAeK,CAAC;AAEhD,eAAO,MAAM,WAAW,kkDAoBjB,CAAC;AAER,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE;IAAE,IAAI,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,EAAE,GACtD,MAAM,CAsDR"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/constants/prompts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAe/C,eAAO,MAAM,kBAAkB,ksFAe8G,CAAC;AAE9I,eAAO,MAAM,sBAAsB,moBAImH,CAAC;AAEvJ,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,OAAO,GAClB,MAAM,CAWR;AAED,eAAO,MAAM,qBAAqB,ksFAAqB,CAAC;AAExD,eAAO,MAAM,2BAA2B,igBAWO,CAAC;AAEhD,eAAO,MAAM,6BAA6B,izCAeK,CAAC;AAEhD,eAAO,MAAM,2BAA2B,25EAiDyG,CAAC;AAElJ,eAAO,MAAM,WAAW,kkDAoBjB,CAAC;AAER,eAAO,MAAM,+BAA+B,20CAsBG,CAAC;AAEhD,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,MAAM,GAAG,SAAS,EAC9B,KAAK,EAAE,UAAU,EAAE,EACnB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE;QACT,YAAY,EAAE,MAAM,CAAC;QACrB,UAAU,EAAE,OAAO,CAAC;KACrB,CAAC;CACE,GACL,MAAM,CA8CR"}