@codebolt/codeboltjs 5.0.8 → 5.0.9

package/dist/core/Codebolt.d.ts

@@ -413,11 +413,7 @@ declare class Codebolt {
         importTodos: (params: {
             data: string;
             format?: "json" | "markdown";
-            mergeStrategy? /**
-             * @method isReady
-             * @description Checks if the Codebolt instance is ready for use.
-             * @returns {boolean} True if the instance is ready, false otherwise.
-             */: "replace" | "merge";
+            mergeStrategy?: "replace" | "merge";
             listId?: string;
         }) => Promise<import("@codebolt/types/sdk").ImportTodosResponse>;
     };
@@ -551,6 +547,7 @@ declare class Codebolt {
         updateAgentStatus: (swarmId: string, agentId: string, data: import("@codebolt/types/sdk").AgentStatusUpdate) => Promise<import("@codebolt/types/sdk").UpdateStatusResponse>;
         getSwarmStatusSummary: (swarmId: string) => Promise<import("@codebolt/types/sdk").GetStatusSummaryResponse>;
         getDefaultJobGroup: (swarmId: string) => Promise<import("@codebolt/types/sdk").GetDefaultJobGroupResponse>;
+        getSwarmConfig: (swarmId: string) => Promise<import("@codebolt/types/sdk").GetSwarmConfigResponse>;
     };
     calendar: {
         createEvent: (params: import("../modules/calendar").ICreateEventParams) => Promise<import("../modules/calendar").ICreateEventResponse>;
@@ -901,6 +898,15 @@ declare class Codebolt {
         getPendingExternalEventCount: () => number;
         waitForAnyExternalEvent: () => Promise<import("../modules/agentEventQueue").UnifiedExternalEvent>;
     };
+    dynamicPanel: {
+        open: (panelId: string, title: string, html: string, opts?: import("../modules/dynamicPanel").DynamicPanelOpenOptions) => Promise<import("../modules/dynamicPanel").DynamicPanelOpenResponse>;
+        update: (panelId: string, html: string) => Promise<import("../modules/dynamicPanel").DynamicPanelResponse>;
+        close: (panelId: string) => Promise<import("../modules/dynamicPanel").DynamicPanelResponse>;
+        send: (panelId: string, data: any) => Promise<import("../modules/dynamicPanel").DynamicPanelResponse>;
+        list: () => Promise<import("../modules/dynamicPanel").DynamicPanelListResponse>;
+        onMessage: (panelId: string, handler: (data: any) => void) => void;
+        offMessage: (panelId: string) => void;
+    };
     /**
      * User message utilities for accessing current user message and context
      */
@@ -989,6 +995,24 @@ declare class Codebolt {
      * @returns {void}
      */
     onProviderStart(handler: (initvars: ProviderInitVars) => void | Promise<void> | any | Promise<any>): void;
+    /**
+     * Sets up a listener for plugin start events.
+     * Called when a plugin process connects and receives its context from the server.
+     * @param {Function} handler - The handler function to call when the plugin receives its start message.
+     * @returns {void}
+     */
+    onPluginStart(handler: (context: {
+        pluginId: string;
+        pluginDir: string;
+        manifest: any;
+    }) => void | Promise<void> | any | Promise<any>): void;
+    /**
+     * Sets up a listener for graceful plugin stop requests from the server.
+     * The handler should perform cleanup (close panels, unsubscribe events, etc.)
+     * @param {Function} handler - The handler function to call when the server requests plugin stop.
+     * @returns {void}
+     */
+    onPluginStop(handler: () => void | Promise<void>): void;
     /**
      * Sets up a listener for provider agent start events.
      * @param {Function} handler - The handler function to call when provider agent starts.

package/dist/core/Codebolt.js

@@ -65,6 +65,7 @@ const agentPortfolio_1 = __importDefault(require("../modules/agentPortfolio"));
 const orchestrator_1 = __importDefault(require("../modules/orchestrator"));
 const backgroundChildThreads_1 = __importDefault(require("../modules/backgroundChildThreads"));
 const agentEventQueue_1 = __importDefault(require("../modules/agentEventQueue"));
+const dynamicPanel_1 = __importDefault(require("../modules/dynamicPanel"));
 /**
  * @class Codebolt
  * @description This class provides a unified interface to interact with various modules.
@@ -139,6 +140,7 @@ class Codebolt {
         this.orchestrator = orchestrator_1.default;
         this.backgroundChildThreads = backgroundChildThreads_1.default;
         this.agentEventQueue = agentEventQueue_1.default;
+        this.dynamicPanel = dynamicPanel_1.default;
         /**
          * User message utilities for accessing current user message and context
          */
@@ -475,6 +477,62 @@ class Codebolt {
             console.error('Failed to set up provider start handler:', error);
         });
     }
+    /**
+     * Sets up a listener for plugin start events.
+     * Called when a plugin process connects and receives its context from the server.
+     * @param {Function} handler - The handler function to call when the plugin receives its start message.
+     * @returns {void}
+     */
+    onPluginStart(handler) {
+        this.waitForReady().then(() => {
+            const handlePluginStart = async (response) => {
+                if (response.type === "pluginStartMessage") {
+                    try {
+                        await handler({
+                            pluginId: response.pluginId,
+                            pluginDir: response.pluginDir,
+                            manifest: response.manifest,
+                        });
+                    }
+                    catch (error) {
+                        console.error('Error in plugin start handler:', error);
+                    }
+                }
+            };
+            websocket_1.default.messageManager.on('message', handlePluginStart);
+        }).catch(error => {
+            console.error('Failed to set up plugin start handler:', error);
+        });
+    }
+    /**
+     * Sets up a listener for graceful plugin stop requests from the server.
+     * The handler should perform cleanup (close panels, unsubscribe events, etc.)
+     * @param {Function} handler - The handler function to call when the server requests plugin stop.
+     * @returns {void}
+     */
+    onPluginStop(handler) {
+        this.waitForReady().then(() => {
+            const handlePluginStop = async (response) => {
+                if (response.type === "pluginStopMessage") {
+                    try {
+                        await handler();
+                        websocket_1.default.messageManager.send({ type: 'pluginStopResponse', success: true });
+                    }
+                    catch (error) {
+                        console.error('Error in plugin stop handler:', error);
+                        websocket_1.default.messageManager.send({
+                            type: 'pluginStopResponse',
+                            success: false,
+                            error: error instanceof Error ? error.message : 'Unknown error',
+                        });
+                    }
+                }
+            };
+            websocket_1.default.messageManager.on('message', handlePluginStop);
+        }).catch(error => {
+            console.error('Failed to set up plugin stop handler:', error);
+        });
+    }
     /**
      * Sets up a listener for provider agent start events.
      * @param {Function} handler - The handler function to call when provider agent starts.

package/dist/core/websocket.js

@@ -65,31 +65,29 @@ class cbws {
         const socketPort = process.env.SOCKET_PORT || '12345';
         const serverUrl = process.env.CODEBOLT_SERVER_URL || 'localhost';
         const threadToken = process.env.threadToken || null;
-        // console.log('[WebSocket] Logging all relevant variables:');
-        // console.log('uniqueConnectionId:', uniqueConnectionId);
-        // console.log('initialMessage:', initialMessage);
-        // console.log('agentIdParam:', agentIdParam);
-        // console.log('parentIdParam:', parentIdParam);
-        // console.log('parentAgentInstanceIdParam:', parentAgentInstanceIdParam);
-        // console.log('agentTask:', agentTask);
-        // console.log('socketPort:', socketPort);
-        // console.log('serverUrl:', serverUrl);
-        // console.log('threadToken:', threadToken);
-        // console.log('[WebSocket] Environment variables check:');
-        // console.log('process.env.agentId:', process.env.agentId);
-        // console.log('process.env.threadToken:', process.env.threadToken);
-        // console.log('process.env.parentId:', process.env.parentId);
-        // console.log('process.env.agentTask:', process.env.agentTask);
+        // Plugin mode detection
+        const isPlugin = process.env.IS_PLUGIN === 'true';
+        const pluginId = process.env.pluginId || '';
+        const pluginToken = process.env.pluginToken || '';
         const threadTokenParam = threadToken ? `&threadToken=${encodeURIComponent(threadToken)}` : '';
         // Add all custom environment variables as URL parameters
-        const knownEnvVars = ['SOCKET_PORT', 'CODEBOLT_SERVER_URL', 'agentId', 'parentId', 'parentAgentInstanceId', 'agentTask', 'threadToken', 'Is_Dev', 'PATH', 'NODE_ENV', 'HOME', 'USER', 'SHELL'];
+        const knownEnvVars = ['SOCKET_PORT', 'CODEBOLT_SERVER_URL', 'agentId', 'parentId', 'parentAgentInstanceId', 'agentTask', 'threadToken', 'Is_Dev', 'PATH', 'NODE_ENV', 'HOME', 'USER', 'SHELL', 'IS_PLUGIN', 'pluginId', 'pluginToken', 'PLUGIN_DIR', 'instanceId'];
         let customParams = '';
         for (const [key, value] of Object.entries(process.env)) {
             if (!knownEnvVars.includes(key) && value && !key.startsWith('npm_') && !key.startsWith('_')) {
                 customParams += `&${encodeURIComponent(key)}=${encodeURIComponent(value)}`;
             }
         }
-        const wsUrl = `ws://${serverUrl}:${socketPort}/codebolt?id=${uniqueConnectionId}${agentIdParam}${parentIdParam}${parentAgentInstanceIdParam}${agentTask}${threadTokenParam}${customParams}${process.env.Is_Dev ? '&dev=true' : ''}`;
+        let wsUrl;
+        if (isPlugin) {
+            // Plugins connect to /plugin endpoint with pluginId/pluginToken
+            wsUrl = `ws://${serverUrl}:${socketPort}/plugin?id=${uniqueConnectionId}&pluginId=${encodeURIComponent(pluginId)}&pluginToken=${encodeURIComponent(pluginToken)}${customParams}`;
+            console.log('[WebSocket] Plugin mode detected, connecting to /plugin endpoint');
+        }
+        else {
+            // Agents connect to /codebolt endpoint (existing behavior)
+            wsUrl = `ws://${serverUrl}:${socketPort}/codebolt?id=${uniqueConnectionId}${agentIdParam}${parentIdParam}${parentAgentInstanceIdParam}${agentTask}${threadTokenParam}${customParams}${process.env.Is_Dev ? '&dev=true' : ''}`;
+        }
         console.log('[WebSocket] Connecting to:', serverUrl);
         this.websocket = new ws_1.default(wsUrl);
         return new Promise((resolve, reject) => {

package/dist/index.d.ts

@@ -125,5 +125,7 @@ export { default as codemap } from './modules/codemap';
 export { default as projectStructure } from './modules/projectStructure';
 export { default as codebaseSearch } from './modules/codebaseSearch';
 export { default as backgroundChildThreads } from './modules/backgroundChildThreads';
+export { default as dynamicPanel } from './modules/dynamicPanel';
+export type { DynamicPanelOpenOptions, DynamicPanelOpenResponse, DynamicPanelResponse, DynamicPanelInfo, DynamicPanelListResponse, DynamicPanelMessageEvent, } from './modules/dynamicPanel';
 export { default as tools } from './tools';
 export { Kind, ToolErrorType, ToolConfirmationOutcome, type ToolResult as ToolFrameworkResult, type ToolLocation, type ToolInvocation, type ToolBuilder, type OpenAIToolSchema, type OpenAIFunctionCall, type ToolCallConfirmationDetails, type AnyDeclarativeTool, type AnyToolInvocation, BaseToolInvocation, DeclarativeTool, BaseDeclarativeTool, ToolRegistry, defaultRegistry, allTools, fileTools, searchTools, terminalTools, gitTools, browserTools, agentTools, threadTools, taskTools, orchestratorTools, ReadFileTool, WriteFileTool, EditTool, ListDirectoryTool, ReadManyFilesTool, GlobTool, GrepTool, SearchFilesTool, CodebaseSearchTool, SearchMcpToolTool, ListCodeDefinitionNamesTool, ExecuteCommandTool, GitInitTool, GitStatusTool, GitAddTool, GitCommitTool, GitPushTool, GitPullTool, GitCheckoutTool, GitBranchTool, GitLogsTool, GitDiffTool, GitCloneTool, BrowserNavigateTool, BrowserScreenshotTool, BrowserClickTool, BrowserTypeTool, BrowserScrollTool, BrowserGetContentTool, BrowserGetHtmlTool, BrowserGetMarkdownTool, BrowserGetUrlTool, BrowserCloseTool, BrowserEnterTool, BrowserSearchTool, TaskCreateTool, TaskUpdateTool, TaskDeleteTool, TaskListTool, TaskGetTool, TaskAssignTool, TaskExecuteTool, AgentFindTool, AgentStartTool, AgentListTool, AgentDetailsTool, ThreadCreateTool, ThreadCreateStartTool, ThreadCreateBackgroundTool, ThreadListTool, ThreadGetTool, ThreadStartTool, ThreadUpdateTool, ThreadDeleteTool, ThreadGetMessagesTool, ThreadUpdateStatusTool, OrchestratorListTool, OrchestratorGetTool, OrchestratorGetSettingsTool, OrchestratorCreateTool, OrchestratorUpdateTool, OrchestratorUpdateSettingsTool, OrchestratorDeleteTool, OrchestratorUpdateStatusTool, } from './tools';

package/dist/index.js

@@ -5,9 +5,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AgentCompletionNotify = exports.AgentInitNotify = exports.SubagentTaskCompletedNotify = exports.StartSubagentTaskResponseNotify = exports.StartSubagentTaskRequestNotify = exports.notificationFunctions = exports.todoNotifications = exports.terminalNotifications = exports.systemNotifications = exports.searchNotifications = exports.mcpNotifications = exports.llmNotifications = exports.historyNotifications = exports.gitNotifications = exports.fsNotifications = exports.dbmemoryNotifications = exports.crawlerNotifications = exports.codeutilsNotifications = exports.chatNotifications = exports.browserNotifications = exports.agentNotifications = exports.executeOnInstance = exports.closeBrowserInstance = exports.openNewBrowserInstance = exports.setActiveBrowserInstance = exports.getBrowserInstance = exports.listBrowserInstances = exports.editFileAndApplyDiff = exports.queryVectorItems = exports.queryVectorItem = exports.addVectorItem = exports.getVector = exports.utils = exports.getMessageId = exports.getUserMessageTimestamp = exports.getUserSessionData = exports.setUserSessionData = exports.getUploadedImages = exports.getRemixPrompt = exports.getSelection = exports.getCurrentFile = exports.getMentionedMCPs = exports.getMentionedFiles = exports.clearUserMessage = exports.hasCurrentUserMessage = exports.getUserMessageText = exports.getCurrentUserMessage = exports.userMessageUtilities = exports.logType = exports.Codebolt = void 0;
 exports.knowledge = exports.search = exports.crawler = exports.codeutils = exports.terminal = exports.chat = exports.browser = exports.agentDeliberation = exports.groupFeedback = exports.mail = exports.llm = exports.git = exports.fs = exports.agentEventQueue = exports.AgentEventPriority = exports.AgentEventStatus = exports.AgentEventType = exports.agentPortfolio = exports.contextRuleEngine = exports.contextAssembly = exports.memoryIngestion = exports.hook = exports.knowledgeGraph = exports.eventLog = exports.orchestrator = exports.persistentMemory = exports.kvStore = exports.reviewMergeRequest = exports.projectStructureUpdateRequest = exports.fileUpdateIntent = exports.episodicMemory = exports.calendar = exports.swarm = exports.requirementPlan = exports.actionBlock = exports.capability = exports.sideExecution = exports.GitStatusRequestNotify = exports.GitRemoteAddRequestNotify = exports.GitPushRequestNotify = exports.GitPullRequestNotify = exports.GitLogsRequestNotify = exports.GitInitRequestNotify = exports.GitDiffRequestNotify = exports.GitCommitRequestNotify = exports.GitCloneRequestNotify = exports.GitCheckoutRequestNotify = exports.GitBranchRequestNotify = exports.GitAddRequestNotify = exports.CommandExecutionRequestNotify = void 0;
-exports.SearchFilesTool = exports.GrepTool = exports.GlobTool = exports.ReadManyFilesTool = exports.ListDirectoryTool = exports.EditTool = exports.WriteFileTool = exports.ReadFileTool = exports.orchestratorTools = exports.taskTools = exports.threadTools = exports.agentTools = exports.browserTools = exports.gitTools = exports.terminalTools = exports.searchTools = exports.fileTools = exports.allTools = exports.defaultRegistry = exports.ToolRegistry = exports.BaseDeclarativeTool = exports.DeclarativeTool = exports.BaseToolInvocation = exports.ToolConfirmationOutcome = exports.ToolErrorType = exports.Kind = exports.tools = exports.backgroundChildThreads = exports.codebaseSearch = exports.projectStructure = exports.codemap = exports.roadmap = exports.autoTesting = exports.job = exports.todo = exports.actionPlan = exports.memory = exports.agent = exports.mcp = exports.chatSummary = exports.tokenizer = exports.debug = exports.vectordb = exports.thread = exports.task = exports.state = exports.dbmemory = exports.project = exports.outputparsers = exports.rag = void 0;
-exports.OrchestratorGetTool = exports.OrchestratorListTool = exports.ThreadUpdateStatusTool = exports.ThreadGetMessagesTool = exports.ThreadDeleteTool = exports.ThreadUpdateTool = exports.ThreadStartTool = exports.ThreadGetTool = exports.ThreadListTool = exports.ThreadCreateBackgroundTool = exports.ThreadCreateStartTool = exports.ThreadCreateTool = exports.AgentDetailsTool = exports.AgentListTool = exports.AgentStartTool = exports.AgentFindTool = exports.TaskExecuteTool = exports.TaskAssignTool = exports.TaskGetTool = exports.TaskListTool = exports.TaskDeleteTool = exports.TaskUpdateTool = exports.TaskCreateTool = exports.BrowserSearchTool = exports.BrowserEnterTool = exports.BrowserCloseTool = exports.BrowserGetUrlTool = exports.BrowserGetMarkdownTool = exports.BrowserGetHtmlTool = exports.BrowserGetContentTool = exports.BrowserScrollTool = exports.BrowserTypeTool = exports.BrowserClickTool = exports.BrowserScreenshotTool = exports.BrowserNavigateTool = exports.GitCloneTool = exports.GitDiffTool = exports.GitLogsTool = exports.GitBranchTool = exports.GitCheckoutTool = exports.GitPullTool = exports.GitPushTool = exports.GitCommitTool = exports.GitAddTool = exports.GitStatusTool = exports.GitInitTool = exports.ExecuteCommandTool = exports.ListCodeDefinitionNamesTool = exports.SearchMcpToolTool = exports.CodebaseSearchTool = void 0;
-exports.OrchestratorUpdateStatusTool = exports.OrchestratorDeleteTool = exports.OrchestratorUpdateSettingsTool = exports.OrchestratorUpdateTool = exports.OrchestratorCreateTool = exports.OrchestratorGetSettingsTool = void 0;
+exports.GrepTool = exports.GlobTool = exports.ReadManyFilesTool = exports.ListDirectoryTool = exports.EditTool = exports.WriteFileTool = exports.ReadFileTool = exports.orchestratorTools = exports.taskTools = exports.threadTools = exports.agentTools = exports.browserTools = exports.gitTools = exports.terminalTools = exports.searchTools = exports.fileTools = exports.allTools = exports.defaultRegistry = exports.ToolRegistry = exports.BaseDeclarativeTool = exports.DeclarativeTool = exports.BaseToolInvocation = exports.ToolConfirmationOutcome = exports.ToolErrorType = exports.Kind = exports.tools = exports.dynamicPanel = exports.backgroundChildThreads = exports.codebaseSearch = exports.projectStructure = exports.codemap = exports.roadmap = exports.autoTesting = exports.job = exports.todo = exports.actionPlan = exports.memory = exports.agent = exports.mcp = exports.chatSummary = exports.tokenizer = exports.debug = exports.vectordb = exports.thread = exports.task = exports.state = exports.dbmemory = exports.project = exports.outputparsers = exports.rag = void 0;
+exports.OrchestratorListTool = exports.ThreadUpdateStatusTool = exports.ThreadGetMessagesTool = exports.ThreadDeleteTool = exports.ThreadUpdateTool = exports.ThreadStartTool = exports.ThreadGetTool = exports.ThreadListTool = exports.ThreadCreateBackgroundTool = exports.ThreadCreateStartTool = exports.ThreadCreateTool = exports.AgentDetailsTool = exports.AgentListTool = exports.AgentStartTool = exports.AgentFindTool = exports.TaskExecuteTool = exports.TaskAssignTool = exports.TaskGetTool = exports.TaskListTool = exports.TaskDeleteTool = exports.TaskUpdateTool = exports.TaskCreateTool = exports.BrowserSearchTool = exports.BrowserEnterTool = exports.BrowserCloseTool = exports.BrowserGetUrlTool = exports.BrowserGetMarkdownTool = exports.BrowserGetHtmlTool = exports.BrowserGetContentTool = exports.BrowserScrollTool = exports.BrowserTypeTool = exports.BrowserClickTool = exports.BrowserScreenshotTool = exports.BrowserNavigateTool = exports.GitCloneTool = exports.GitDiffTool = exports.GitLogsTool = exports.GitBranchTool = exports.GitCheckoutTool = exports.GitPullTool = exports.GitPushTool = exports.GitCommitTool = exports.GitAddTool = exports.GitStatusTool = exports.GitInitTool = exports.ExecuteCommandTool = exports.ListCodeDefinitionNamesTool = exports.SearchMcpToolTool = exports.CodebaseSearchTool = exports.SearchFilesTool = void 0;
+exports.OrchestratorUpdateStatusTool = exports.OrchestratorDeleteTool = exports.OrchestratorUpdateSettingsTool = exports.OrchestratorUpdateTool = exports.OrchestratorCreateTool = exports.OrchestratorGetSettingsTool = exports.OrchestratorGetTool = void 0;
 const Codebolt_1 = __importDefault(require("./core/Codebolt"));
 exports.Codebolt = Codebolt_1.default;
 // ================================
@@ -312,6 +312,9 @@ Object.defineProperty(exports, "codebaseSearch", { enumerable: true, get: functi
 // Background Child Threads module
 var backgroundChildThreads_1 = require("./modules/backgroundChildThreads");
 Object.defineProperty(exports, "backgroundChildThreads", { enumerable: true, get: function () { return __importDefault(backgroundChildThreads_1).default; } });
+// DynamicPanel module
+var dynamicPanel_1 = require("./modules/dynamicPanel");
+Object.defineProperty(exports, "dynamicPanel", { enumerable: true, get: function () { return __importDefault(dynamicPanel_1).default; } });
 // ================================
 // Tools Module - LLM-ready tool definitions
 // ================================

package/dist/modules/dynamicPanel.d.ts

@@ -0,0 +1,106 @@
+export interface DynamicPanelOpenOptions {
+    /** If true, the open() call blocks until the panel sends a { type: 'submit' } message */
+    waitForResponse?: boolean;
+    /** Timeout in milliseconds for waitForResponse mode (default: 300000 = 5 min) */
+    timeout?: number;
+}
+export interface DynamicPanelOpenResponse {
+    type: string;
+    success: boolean;
+    data?: {
+        success: boolean;
+        panelId: string;
+        data?: any;
+    };
+    error?: string;
+    requestId?: string;
+}
+export interface DynamicPanelResponse {
+    type: string;
+    success: boolean;
+    data?: any;
+    error?: string;
+    requestId?: string;
+}
+export interface DynamicPanelInfo {
+    panelId: string;
+    title: string;
+    html: string;
+    pluginId?: string;
+    createdAt: string;
+}
+export interface DynamicPanelListResponse {
+    type: string;
+    success: boolean;
+    data?: {
+        panels: DynamicPanelInfo[];
+    };
+    error?: string;
+    requestId?: string;
+}
+export interface DynamicPanelMessageEvent {
+    type: 'dynamicPanel.message';
+    panelId: string;
+    data: any;
+    messageId?: string;
+    threadId?: string;
+}
+declare const cbdynamicPanel: {
+    /**
+     * Opens a new DynamicPanel with the given HTML content.
+     *
+     * When `opts.waitForResponse` is true the call **blocks** until the panel
+     * iframe sends a `{ type: 'submit', data: {...} }` message via
+     * `window.parent.postMessage()`.  The resolved value then contains the
+     * submitted data.
+     *
+     * @param panelId  Unique identifier for the panel
+     * @param title    Human-readable panel title shown in the tab
+     * @param html     Full HTML document rendered inside the panel iframe
+     * @param opts     Optional: `waitForResponse`, `timeout`
+     */
+    open: (panelId: string, title: string, html: string, opts?: DynamicPanelOpenOptions) => Promise<DynamicPanelOpenResponse>;
+    /**
+     * Replaces the HTML content of an existing DynamicPanel.
+     *
+     * @param panelId  The panel to update
+     * @param html     New HTML content
+     */
+    update: (panelId: string, html: string) => Promise<DynamicPanelResponse>;
+    /**
+     * Closes a DynamicPanel and removes it from the UI.
+     *
+     * @param panelId  The panel to close
+     */
+    close: (panelId: string) => Promise<DynamicPanelResponse>;
+    /**
+     * Pushes arbitrary data into the panel's iframe via `postMessage`.
+     * The iframe receives this in its `window.addEventListener('message', ...)` handler.
+     *
+     * @param panelId  The target panel
+     * @param data     Any JSON-serializable payload
+     */
+    send: (panelId: string, data: any) => Promise<DynamicPanelResponse>;
+    /**
+     * Lists all currently active DynamicPanels.
+     */
+    list: () => Promise<DynamicPanelListResponse>;
+    /**
+     * Registers a handler for messages coming **from** a specific panel's iframe.
+     * The iframe sends messages via `window.parent.postMessage({ type: '...', data: {...} }, '*')`.
+     *
+     * Only one handler per panelId is supported.  Calling this again for the
+     * same panelId replaces the previous handler.
+     *
+     * @param panelId  The panel to listen to
+     * @param handler  Callback receiving the message data
+     */
+    onMessage: (panelId: string, handler: (data: any) => void) => void;
+    /**
+     * Removes the message handler for a specific panel.
+     *
+     * @param panelId  The panel to stop listening to
+     */
+    offMessage: (panelId: string) => void;
+};
+export default cbdynamicPanel;

package/dist/modules/dynamicPanel.js

@@ -0,0 +1,122 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const websocket_1 = __importDefault(require("../core/websocket"));
+// ---------------------------------------------------------------------------
+// Message handler tracking
+// ---------------------------------------------------------------------------
+const panelMessageHandlers = new Map();
+let messageRouteCleanup = null;
+/**
+ * Ensures the global message route for dynamicPanel.message is registered.
+ * Incoming messages are dispatched to per-panel handlers.
+ */
+function ensureMessageRoute() {
+    if (messageRouteCleanup)
+        return;
+    messageRouteCleanup = websocket_1.default.messageManager.registerRoute({
+        messageTypes: ['dynamicPanel.message'],
+        handler: (message) => {
+            const handler = panelMessageHandlers.get(message.panelId);
+            if (handler) {
+                handler(message.data);
+            }
+        },
+    });
+}
+// ---------------------------------------------------------------------------
+// DynamicPanel SDK module
+// ---------------------------------------------------------------------------
+const cbdynamicPanel = {
+    /**
+     * Opens a new DynamicPanel with the given HTML content.
+     *
+     * When `opts.waitForResponse` is true the call **blocks** until the panel
+     * iframe sends a `{ type: 'submit', data: {...} }` message via
+     * `window.parent.postMessage()`.  The resolved value then contains the
+     * submitted data.
+     *
+     * @param panelId  Unique identifier for the panel
+     * @param title    Human-readable panel title shown in the tab
+     * @param html     Full HTML document rendered inside the panel iframe
+     * @param opts     Optional: `waitForResponse`, `timeout`
+     */
+    open: async (panelId, title, html, opts) => {
+        return websocket_1.default.messageManager.sendAndWaitForResponse({
+            type: 'dynamicPanel.open',
+            params: { panelId, title, html, ...opts },
+        }, 'dynamicPanelOpenResponse', (opts === null || opts === void 0 ? void 0 : opts.waitForResponse) ? (opts.timeout || 300000) : 0);
+    },
+    /**
+     * Replaces the HTML content of an existing DynamicPanel.
+     *
+     * @param panelId  The panel to update
+     * @param html     New HTML content
+     */
+    update: async (panelId, html) => {
+        return websocket_1.default.messageManager.sendAndWaitForResponse({
+            type: 'dynamicPanel.update',
+            params: { panelId, html },
+        }, 'dynamicPanelUpdateResponse');
+    },
+    /**
+     * Closes a DynamicPanel and removes it from the UI.
+     *
+     * @param panelId  The panel to close
+     */
+    close: async (panelId) => {
+        // Unregister any local message handler for this panel
+        panelMessageHandlers.delete(panelId);
+        return websocket_1.default.messageManager.sendAndWaitForResponse({
+            type: 'dynamicPanel.close',
+            params: { panelId },
+        }, 'dynamicPanelCloseResponse');
+    },
+    /**
+     * Pushes arbitrary data into the panel's iframe via `postMessage`.
+     * The iframe receives this in its `window.addEventListener('message', ...)` handler.
+     *
+     * @param panelId  The target panel
+     * @param data     Any JSON-serializable payload
+     */
+    send: async (panelId, data) => {
+        return websocket_1.default.messageManager.sendAndWaitForResponse({
+            type: 'dynamicPanel.send',
+            params: { panelId, data },
+        }, 'dynamicPanelSendResponse');
+    },
+    /**
+     * Lists all currently active DynamicPanels.
+     */
+    list: async () => {
+        return websocket_1.default.messageManager.sendAndWaitForResponse({
+            type: 'dynamicPanel.list',
+            params: {},
+        }, 'dynamicPanelListResponse');
+    },
+    /**
+     * Registers a handler for messages coming **from** a specific panel's iframe.
+     * The iframe sends messages via `window.parent.postMessage({ type: '...', data: {...} }, '*')`.
+     *
+     * Only one handler per panelId is supported.  Calling this again for the
+     * same panelId replaces the previous handler.
+     *
+     * @param panelId  The panel to listen to
+     * @param handler  Callback receiving the message data
+     */
+    onMessage: (panelId, handler) => {
+        ensureMessageRoute();
+        panelMessageHandlers.set(panelId, handler);
+    },
+    /**
+     * Removes the message handler for a specific panel.
+     *
+     * @param panelId  The panel to stop listening to
+     */
+    offMessage: (panelId) => {
+        panelMessageHandlers.delete(panelId);
+    },
+};
+exports.default = cbdynamicPanel;

package/dist/modules/mcp.js

@@ -183,6 +183,9 @@ const codeboltMCP = {
      */
     executeTool: async (toolbox, toolName, params) => {
         // Handle local codebolt tools
+        if (toolbox == undefined) {
+            toolbox = "codebolt";
+        }
         if (isCodeboltToolbox(toolbox)) {
             // Extract actual tool name (in case it comes prefixed)
             const actualToolName = extractToolName(toolName);

package/dist/modules/swarm.d.ts

@@ -1,5 +1,5 @@
-import type { CreateSwarmRequest, AgentRegistration, CreateTeamRequest, CreateRoleRequest, CreateVacancyRequest, AgentStatusUpdate, CreateSwarmResponse, ListSwarmsResponse, GetSwarmResponse, GetSwarmAgentsResponse, RegisterAgentResponse, UnregisterAgentResponse, CreateTeamResponse, ListTeamsResponse, GetTeamResponse, JoinTeamResponse, LeaveTeamResponse, DeleteTeamResponse, CreateRoleResponse, ListRolesResponse, GetRoleResponse, AssignRoleResponse, UnassignRoleResponse, GetAgentsByRoleResponse, DeleteRoleResponse, CreateVacancyResponse, ListVacanciesResponse, ApplyForVacancyResponse, CloseVacancyResponse, UpdateStatusResponse, GetStatusSummaryResponse, GetDefaultJobGroupResponse } from '@codebolt/types/lib';
-export type { CreateSwarmRequest, AgentRegistration, CreateTeamRequest, CreateRoleRequest, CreateVacancyRequest, AgentStatusUpdate, Swarm, SwarmAgent, Team, Role, Vacancy, StatusSummary, SwarmResponse, CreateSwarmResponse, ListSwarmsResponse, GetSwarmResponse, GetSwarmAgentsResponse, RegisterAgentResponse, UnregisterAgentResponse, CreateTeamResponse, ListTeamsResponse, GetTeamResponse, JoinTeamResponse, LeaveTeamResponse, DeleteTeamResponse, CreateRoleResponse, ListRolesResponse, GetRoleResponse, AssignRoleResponse, UnassignRoleResponse, GetAgentsByRoleResponse, DeleteRoleResponse, CreateVacancyResponse, ListVacanciesResponse, ApplyForVacancyResponse, CloseVacancyResponse, UpdateStatusResponse, GetStatusSummaryResponse, GetDefaultJobGroupResponse } from '@codebolt/types/lib';
+import type { CreateSwarmRequest, AgentRegistration, CreateTeamRequest, CreateRoleRequest, CreateVacancyRequest, AgentStatusUpdate, CreateSwarmResponse, ListSwarmsResponse, GetSwarmResponse, GetSwarmAgentsResponse, RegisterAgentResponse, UnregisterAgentResponse, CreateTeamResponse, ListTeamsResponse, GetTeamResponse, JoinTeamResponse, LeaveTeamResponse, DeleteTeamResponse, CreateRoleResponse, ListRolesResponse, GetRoleResponse, AssignRoleResponse, UnassignRoleResponse, GetAgentsByRoleResponse, DeleteRoleResponse, CreateVacancyResponse, ListVacanciesResponse, ApplyForVacancyResponse, CloseVacancyResponse, UpdateStatusResponse, GetStatusSummaryResponse, GetDefaultJobGroupResponse, GetSwarmConfigResponse } from '@codebolt/types/lib';
+export type { CreateSwarmRequest, AgentRegistration, CreateTeamRequest, CreateRoleRequest, CreateVacancyRequest, AgentStatusUpdate, Swarm, SwarmAgent, Team, Role, Vacancy, StatusSummary, SwarmResponse, CreateSwarmResponse, ListSwarmsResponse, GetSwarmResponse, GetSwarmAgentsResponse, RegisterAgentResponse, UnregisterAgentResponse, CreateTeamResponse, ListTeamsResponse, GetTeamResponse, JoinTeamResponse, LeaveTeamResponse, DeleteTeamResponse, CreateRoleResponse, ListRolesResponse, GetRoleResponse, AssignRoleResponse, UnassignRoleResponse, GetAgentsByRoleResponse, DeleteRoleResponse, CreateVacancyResponse, ListVacanciesResponse, ApplyForVacancyResponse, CloseVacancyResponse, UpdateStatusResponse, GetStatusSummaryResponse, GetDefaultJobGroupResponse, GetSwarmConfigResponse } from '@codebolt/types/lib';
 /**
  * Swarm Module
  * Provides functionality for managing swarms, agents, teams, roles, and vacancies
@@ -185,5 +185,11 @@ declare const codeboltSwarm: {
      * @returns Promise resolving to the default job group ID
      */
     getDefaultJobGroup: (swarmId: string) => Promise<GetDefaultJobGroupResponse>;
+    /**
+     * Get the configuration for a specific swarm
+     * @param swarmId - ID of the swarm
+     * @returns Promise resolving to swarm configuration
+     */
+    getSwarmConfig: (swarmId: string) => Promise<GetSwarmConfigResponse>;
 };
 export default codeboltSwarm;

package/dist/modules/swarm.js

@@ -442,6 +442,20 @@ const codeboltSwarm = {
             requestId,
             swarmId
         }, 'swarmResponse');
+    },
+    /**
+     * Get the configuration for a specific swarm
+     * @param swarmId - ID of the swarm
+     * @returns Promise resolving to swarm configuration
+     */
+    getSwarmConfig: (swarmId) => {
+        const requestId = (0, crypto_1.randomUUID)();
+        return websocket_1.default.messageManager.sendAndWaitForResponse({
+            type: 'swarmEvent',
+            action: 'getConfig',
+            requestId,
+            swarmId
+        }, 'swarmResponse');
     }
 };
 exports.default = codeboltSwarm;

package/dist/tools/actionBlock/action-block-start.js

@@ -24,10 +24,7 @@ class StartActionBlockInvocation extends base_tool_1.BaseToolInvocation {
                     error: { message: response.error || 'Unknown error', type: types_1.ToolErrorType.EXECUTION_FAILED },
                 };
             }
-            const content = response.sideExecutionId
-                ? `ActionBlock "${this.params.actionBlockName}" started. ID: ${response.sideExecutionId}`
-                : `ActionBlock "${this.params.actionBlockName}" started`;
-            return { llmContent: content, returnDisplay: content };
+            return { llmContent: JSON.stringify(response), returnDisplay: JSON.stringify(response) };
         }
         catch (error) {
             return {

package/dist/tools/actionPlan/action-plan-create.js

@@ -12,7 +12,6 @@ class CreateActionPlanInvocation extends base_tool_1.BaseToolInvocation {
         super(params);
     }
     async execute(_signal) {
-        var _a;
         try {
             const { name, description, agentId, agentName, status, planId } = this.params;
             const response = await actionPlan_1.default.createActionPlan({ name, description, agentId, agentName, status, planId });
@@ -23,7 +22,7 @@ class CreateActionPlanInvocation extends base_tool_1.BaseToolInvocation {
                     error: { message: response.error || 'Unknown error', type: types_1.ToolErrorType.EXECUTION_FAILED },
                 };
             }
-            const content = `Action plan "${name}" created successfully. ID: ${(_a = response.plan) === null || _a === void 0 ? void 0 : _a.planId}`;
+            const content = JSON.stringify(response, null, 2);
             return { llmContent: content, returnDisplay: content };
         }
         catch (error) {

package/dist/tools/completion/attempt-completion.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Attempt Completion Tool - Signals the completion of a task
+ */
+import { BaseDeclarativeTool, ToolInvocation, ToolResult } from '../base-tool';
+/**
+ * Parameters for the AttemptCompletion tool
+ */
+export interface AttemptCompletionToolParams {
+    /**
+     * The final result of the task
+     */
+    result: Record<string, any>;
+    /**
+     * Optional explanation of the completion
+     */
+    explanation?: string;
+}
+/**
+ * Implementation of the AttemptCompletion tool
+ */
+export declare class AttemptCompletionTool extends BaseDeclarativeTool<AttemptCompletionToolParams, ToolResult> {
+    static readonly Name: string;
+    constructor();
+    protected createInvocation(params: AttemptCompletionToolParams): ToolInvocation<AttemptCompletionToolParams, ToolResult>;
+}

package/dist/tools/completion/attempt-completion.js

@@ -0,0 +1,45 @@
+"use strict";
+/**
+ * Attempt Completion Tool - Signals the completion of a task
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AttemptCompletionTool = void 0;
+const base_tool_1 = require("../base-tool");
+class AttemptCompletionToolInvocation extends base_tool_1.BaseToolInvocation {
+    constructor(params) {
+        super(params);
+    }
+    async execute() {
+        return {
+            llmContent: JSON.stringify(this.params.result, null, 2),
+            returnDisplay: `Task Completed.\n\nResult:\n\`\`\`json\n${JSON.stringify(this.params.result, null, 2)}\n\`\`\``,
+        };
+    }
+}
+/**
+ * Implementation of the AttemptCompletion tool
+ */
+class AttemptCompletionTool extends base_tool_1.BaseDeclarativeTool {
+    constructor() {
+        super(AttemptCompletionTool.Name, 'AttemptCompletion', 'Signals the completion of the task and returns the final result.', base_tool_1.Kind.Other, {
+            type: 'object',
+            properties: {
+                result: {
+                    type: 'object',
+                    description: 'The final result of the task. The structure of this object should match the format specified in the system prompt.',
+                    additionalProperties: true,
+                },
+                explanation: {
+                    type: 'string',
+                    description: 'Optional explanation of why the task is receiving this result.',
+                },
+            },
+            required: ['result'],
+        });
+    }
+    createInvocation(params) {
+        return new AttemptCompletionToolInvocation(params);
+    }
+}
+exports.AttemptCompletionTool = AttemptCompletionTool;
+AttemptCompletionTool.Name = 'attempt_completion';

package/dist/tools/completion/index.d.ts

@@ -0,0 +1,3 @@
+import { AttemptCompletionTool } from './attempt-completion';
+export { AttemptCompletionTool, type AttemptCompletionToolParams, } from './attempt-completion';
+export declare const completionTools: AttemptCompletionTool[];

package/dist/tools/completion/index.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.completionTools = exports.AttemptCompletionTool = void 0;
+const attempt_completion_1 = require("./attempt-completion");
+var attempt_completion_2 = require("./attempt-completion");
+Object.defineProperty(exports, "AttemptCompletionTool", { enumerable: true, get: function () { return attempt_completion_2.AttemptCompletionTool; } });
+exports.completionTools = [
+    new attempt_completion_1.AttemptCompletionTool(),
+];