@minded-ai/mindedjs 2.0.27 → 2.0.28-beta.1

package/dist/platform/toolExecutor.js

@@ -21,22 +21,20 @@ class ToolExecutor {
         // Clear existing tools to prevent stale registrations
         this.tools.clear();
         tools.forEach((tool) => {
-            if (tool.allowExecutionRequests === true) {
-                this.tools.set(tool.name, tool);
-            }
+            this.tools.set(tool.name, tool);
         });
     }
     /**
      * Execute a tool by name with given parameters
      * This is called when browser-use requests tool execution via socket
      */
-    async executeTool(request) {
+    async executeTool(request, source) {
         var _a, _b;
         const { toolName, toolParams, sessionId, cdpUrl } = request;
         try {
             // Find the tool
             const tool = this.tools.get(toolName);
-            if (!tool) {
+            if (!tool || (source === 'browser-use' && !tool.allowExecutionRequests)) {
                 throw new Error(`Tool not found: ${toolName}`);
             }
             // We only allow to execute tools that are marked as allowed to be executed

package/dist/platform/toolExecutor.js.map

@@ -1 +1 @@
-{"version":3,"file":"toolExecutor.js","sourceRoot":"","sources":["../../src/platform/toolExecutor.ts"],"names":[],"mappings":";;;AAEA,4CAAyC;AAgBzC,MAAa,YAAY;IAGvB,YAAoB,KAAY;QAAZ,UAAK,GAAL,KAAK,CAAO;QAFxB,UAAK,GAAgC,IAAI,GAAG,EAAE,CAAC;IAEpB,CAAC;IAEpC;;OAEG;IACH,UAAU;QACR,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED;;;OAGG;IACH,aAAa,CAAC,KAAuB;QACnC,sDAAsD;QACtD,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAEnB,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YACrB,IAAI,IAAI,CAAC,sBAAsB,KAAK,IAAI,EAAE,CAAC;gBACzC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAClC,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CAAC,OAA6B;;QAC7C,MAAM,EAAE,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;QAE5D,IAAI,CAAC;YACH,gBAAgB;YAChB,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACtC,IAAI,CAAC,IAAI,EAAE,CAAC;gBACV,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;YACjD,CAAC;YAED,2EAA2E;YAE3E,eAAM,CAAC,KAAK,CAAC;gBACX,GAAG,EAAE,+BAA+B;gBACpC,QAAQ;gBACR,SAAS;gBACT,SAAS,EAAE,CAAC,CAAC,MAAM;aACpB,CAAC,CAAC;YAEH,wCAAwC;YACxC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;YACnD,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,MAAM,IAAI,KAAK,CAAC,4BAA4B,SAAS,EAAE,CAAC,CAAC;YAC3D,CAAC;YAED,mBAAmB;YACnB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAE7B,IAAI,MAAM,EAAE,CAAC;gBACX,KAAK,CAAC,GAAG,GAAG;oBACV,GAAG,EAAE,MAAM;oBACX,SAAS,EAAE,CAAA,MAAA,KAAK,CAAC,GAAG,0CAAE,SAAS,KAAI,IAAI;oBACvC,OAAO,EAAE,CAAA,MAAA,KAAK,CAAC,GAAG,0CAAE,OAAO,KAAI,IAAI;iBACpC,CAAC;YACJ,CAAC;YAED,MAAM,IAAI,CAAC,OAAO,CAAC;gBACjB,KAAK,EAAE,UAAU;gBACjB,KAAK;gBACL,KAAK,EAAE,IAAI,CAAC,KAAK;aAClB,CAAC,CAAC;YACH,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAE3B,eAAM,CAAC,KAAK,CAAC;gBACX,GAAG,EAAE,yCAAyC;gBAC9C,QAAQ;gBACR,eAAe,EAAE,OAAO,GAAG,SAAS;aACrC,CAAC,CAAC;YAEH,2DAA2D;YAC3D,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;YAEnD,OAAO;gBACL,KAAK;aACN,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,eAAM,CAAC,KAAK,CAAC;gBACX,OAAO,EAAE,qCAAqC;gBAC9C,QAAQ;gBACR,GAAG;aACJ,CAAC,CAAC;YAEH,OAAO;gBACL,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;aACxD,CAAC;QACJ,CAAC;IACH,CAAC;CACF;AAlGD,oCAkGC"}
+{"version":3,"file":"toolExecutor.js","sourceRoot":"","sources":["../../src/platform/toolExecutor.ts"],"names":[],"mappings":"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"}

package/dist/toolsLibrary/withBrowserSession.d.ts

@@ -0,0 +1,7 @@
+import { Page } from "playwright";
+import { BrowserTaskMode } from "../browserTask/types";
+export declare const withBrowserSession: <T>({ sessionId, browserTaskMode }: {
+    sessionId: string;
+    browserTaskMode: BrowserTaskMode;
+}, callback: (page: Page) => Promise<T>) => Promise<T>;
+//# sourceMappingURL=withBrowserSession.d.ts.map

package/dist/toolsLibrary/withBrowserSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"withBrowserSession.d.ts","sourceRoot":"","sources":["../../src/toolsLibrary/withBrowserSession.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqC,IAAI,EAAE,MAAM,YAAY,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAyCvD,eAAO,MAAM,kBAAkB,GAAU,CAAC,EAAE,gCAAgC;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,eAAe,EAAE,eAAe,CAAA;CAAE,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,KAAG,OAAO,CAAC,CAAC,CA4EpL,CAAA"}

package/dist/toolsLibrary/withBrowserSession.js

@@ -0,0 +1,154 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withBrowserSession = void 0;
+const playwright_1 = require("playwright");
+const types_1 = require("../browserTask/types");
+const executeBrowserTask_1 = require("../browserTask/executeBrowserTask");
+const logger_1 = require("../utils/logger");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const CookieStore_1 = require("../browserTask/CookieStore");
+// Initialize cookie store
+const cookieStore = new CookieStore_1.CookieStore(path.join(process.cwd(), 'local_storage', 'cookies'));
+// Helper function to load cookies for a session
+const loadCookiesForSession = async (context, sessionId) => {
+    const stored = await cookieStore.load();
+    if (!stored || stored.length === 0) {
+        logger_1.logger.info({ message: 'No stored cookies to load', sessionId });
+        return;
+    }
+    try {
+        await context.addCookies(stored);
+        logger_1.logger.info({ message: 'Loaded cookies into browser session', sessionId, count: stored.length });
+    }
+    catch (error) {
+        logger_1.logger.warn({ message: 'Failed to add cookies to context', sessionId, error });
+    }
+};
+// Helper function to save cookies for a session
+const saveCookiesForSession = async (context, sessionId) => {
+    try {
+        const cookies = await context.cookies();
+        if (cookies && cookies.length > 0) {
+            await cookieStore.save(cookies);
+            logger_1.logger.info({ message: 'Saved cookies from browser session', sessionId, count: cookies.length });
+        }
+        else {
+            logger_1.logger.info({ message: 'No cookies found in browser session', sessionId });
+        }
+    }
+    catch (error) {
+        logger_1.logger.warn({ message: 'Failed to get/save cookies from session', sessionId, error: JSON.stringify(error) });
+    }
+};
+const withBrowserSession = async ({ sessionId, browserTaskMode }, callback) => {
+    var _a, _b;
+    const { cdpUrl } = await (0, executeBrowserTask_1.createBrowserSession)({ sessionId, browserTaskMode });
+    if (!cdpUrl) {
+        throw new Error('CDP URL was not provided by the browser session.');
+    }
+    logger_1.logger.info({ msg: 'Connecting to CDP', cdpUrl, sessionId });
+    let maxTries = 30;
+    let browser = null;
+    while (maxTries > 0) {
+        try {
+            browser = await playwright_1.chromium.connectOverCDP(cdpUrl);
+            break;
+        }
+        catch (error) {
+            logger_1.logger.warn({ msg: 'Failed to connect to CDP', sessionId, error });
+            maxTries--;
+            await delay(1000);
+        }
+    }
+    if (!browser) {
+        throw new Error('Failed to connect to CDP');
+    }
+    logger_1.logger.info({ msg: 'Connected to CDP', cdpUrl, sessionId });
+    const context = (_a = browser.contexts()[0]) !== null && _a !== void 0 ? _a : await browser.newContext();
+    const page = (_b = context.pages()[0]) !== null && _b !== void 0 ? _b : await context.newPage();
+    logger_1.logger.info({ msg: 'Created page', sessionId });
+    // Load cookies for this session (only for local mode, best-effort)
+    if (browserTaskMode === types_1.BrowserTaskMode.LOCAL) {
+        try {
+            await loadCookiesForSession(context, sessionId);
+        }
+        catch (error) {
+            logger_1.logger.warn({ message: 'Failed to load cookies for session', sessionId, error });
+        }
+    }
+    try {
+        return await callback(page);
+    }
+    catch (e) {
+        logger_1.logger.error({ msg: 'Error in browser session callback', sessionId, error: e });
+        // Save screenshot and HTML content for debugging
+        try {
+            const resultsDir = path.join(process.cwd(), 'rpaTestResults');
+            if (!fs.existsSync(resultsDir)) {
+                fs.mkdirSync(resultsDir, { recursive: true });
+            }
+            const screenshotPath = path.join(resultsDir, `screenshot.jpeg`);
+            const htmlPath = path.join(resultsDir, `content.html`);
+            // Take screenshot with 80% quality
+            await page.screenshot({ path: screenshotPath, type: 'jpeg', quality: 80 });
+            logger_1.logger.info({ msg: 'Saved error screenshot', path: screenshotPath, sessionId });
+            // Save HTML content
+            const htmlContent = await page.content();
+            fs.writeFileSync(htmlPath, htmlContent, 'utf8');
+            logger_1.logger.info({ msg: 'Saved error HTML content', path: htmlPath, sessionId });
+        }
+        catch (saveError) {
+            logger_1.logger.warn({ msg: 'Failed to save error artifacts', sessionId, error: saveError });
+        }
+        throw e;
+    }
+    finally {
+        // Save cookies before destroying session (only for local mode, best-effort)
+        if (browserTaskMode === types_1.BrowserTaskMode.LOCAL) {
+            try {
+                await saveCookiesForSession(context, sessionId);
+            }
+            catch (error) {
+                logger_1.logger.warn({ message: 'Failed to save cookies before session destruction', sessionId, error });
+            }
+        }
+        (0, executeBrowserTask_1.destroyBrowserSession)({ sessionId, localRun: browserTaskMode === types_1.BrowserTaskMode.LOCAL, onPrem: browserTaskMode === types_1.BrowserTaskMode.ON_PREM }).catch(() => { });
+    }
+};
+exports.withBrowserSession = withBrowserSession;
+const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+//# sourceMappingURL=withBrowserSession.js.map

package/dist/toolsLibrary/withBrowserSession.js.map

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

package/dist/utils/extractStateMemoryResponse.d.ts

@@ -0,0 +1,5 @@
+import { ToolMessage } from '@langchain/core/messages';
+import { State } from '../types/LangGraph.types';
+declare const extractToolStateResponse: (toolMessage: ToolMessage) => Partial<State>;
+export default extractToolStateResponse;
+//# sourceMappingURL=extractStateMemoryResponse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extractStateMemoryResponse.d.ts","sourceRoot":"","sources":["../../src/utils/extractStateMemoryResponse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,WAAW,EAA0C,MAAM,0BAA0B,CAAC;AAE5G,OAAO,EAAE,KAAK,EAAE,MAAM,0BAA0B,CAAC;AAEjD,QAAA,MAAM,wBAAwB,GAAI,aAAa,WAAW,KAAG,OAAO,CAAC,KAAK,CAazE,CAAC;AA4EF,eAAe,wBAAwB,CAAC"}

package/dist/utils/extractStateMemoryResponse.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const messages_1 = require("@langchain/core/messages");
+const logger_1 = require("./logger");
+const extractToolStateResponse = (toolMessage) => {
+    try {
+        const parsed = JSON.parse(toolMessage.content);
+        if (typeof parsed === 'object' && parsed !== null && 'state' in parsed) {
+            if (parsed.state.messages) {
+                parsed.state.messages = constructMessagesFromToolMessage(parsed.state.messages);
+            }
+            return parsed.state;
+        }
+    }
+    catch (err) {
+        logger_1.logger.error({ message: 'Error parsing tool state response', err });
+    }
+    return {};
+};
+const constructMessagesFromToolMessage = (messages) => {
+    if (!Array.isArray(messages)) {
+        logger_1.logger.error({ msg: 'Expected messages to be an array', messages });
+        return [];
+    }
+    return messages
+        .map((messageObj) => {
+        try {
+            // Handle case where message is already a BaseMessage instance
+            if (messageObj instanceof messages_1.BaseMessage) {
+                return messageObj;
+            }
+            // Handle case where message is a plain object that needs reconstruction
+            const messageType = messageObj.id[2];
+            const content = messageObj.kwargs.content || '';
+            const id = messageObj.kwargs.id;
+            const additionalKwargs = messageObj.additional_kwargs || {};
+            switch (messageType) {
+                case 'AIMessage':
+                    return new messages_1.AIMessage({
+                        content,
+                        id,
+                        additional_kwargs: additionalKwargs,
+                        tool_calls: messageObj.tool_calls || [],
+                        invalid_tool_calls: messageObj.invalid_tool_calls || [],
+                    });
+                case 'HumanMessage':
+                    return new messages_1.HumanMessage({
+                        content,
+                        id,
+                        additional_kwargs: additionalKwargs,
+                    });
+                case 'SystemMessage':
+                    return new messages_1.SystemMessage({
+                        content,
+                        id,
+                        additional_kwargs: additionalKwargs,
+                    });
+                case 'ToolMessage':
+                    return new messages_1.ToolMessage({
+                        content,
+                        id,
+                        additional_kwargs: additionalKwargs,
+                        tool_call_id: messageObj.tool_call_id || '',
+                    });
+                default:
+                    // Default to HumanMessage for unknown types
+                    logger_1.logger.warn({
+                        msg: 'Unknown message type, defaulting to HumanMessage',
+                        messageType,
+                        messageObj,
+                    });
+                    return null;
+            }
+        }
+        catch (err) {
+            logger_1.logger.error({
+                msg: 'Error reconstructing message',
+                err,
+                messageObj,
+            });
+            // Return a fallback HumanMessage in case of error
+            return new messages_1.HumanMessage({
+                content: messageObj.content || 'Error reconstructing message',
+                id: messageObj.id,
+            });
+        }
+    })
+        .filter(Boolean);
+};
+exports.default = extractToolStateResponse;
+//# sourceMappingURL=extractStateMemoryResponse.js.map

package/dist/utils/extractStateMemoryResponse.js.map

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

package/dist/utils/extractToolMemoryResponse.d.ts

@@ -0,0 +1,4 @@
+import { ToolMessage } from '@langchain/core/messages';
+declare const extractToolMemoryResponse: <Memory>(toolMessage: ToolMessage) => Partial<Memory>;
+export default extractToolMemoryResponse;
+//# sourceMappingURL=extractToolMemoryResponse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"extractToolMemoryResponse.d.ts","sourceRoot":"","sources":["../../src/utils/extractToolMemoryResponse.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,QAAA,MAAM,yBAAyB,GAAI,MAAM,EAAE,aAAa,WAAW,KAAG,OAAO,CAAC,MAAM,CAUnF,CAAC;AAEF,eAAe,yBAAyB,CAAC"}

package/dist/utils/extractToolMemoryResponse.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const extractToolMemoryResponse = (toolMessage) => {
+    try {
+        const parsed = JSON.parse(toolMessage.content);
+        if (typeof parsed === 'object' && parsed !== null && 'memory' in parsed) {
+            return parsed.memory;
+        }
+    }
+    catch (error) {
+        console.error('Error parsing tool memory response', error);
+    }
+    return {};
+};
+exports.default = extractToolMemoryResponse;
+//# sourceMappingURL=extractToolMemoryResponse.js.map

package/dist/utils/extractToolMemoryResponse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractToolMemoryResponse.js","sourceRoot":"","sources":["../../src/utils/extractToolMemoryResponse.ts"],"names":[],"mappings":";;AAEA,MAAM,yBAAyB,GAAG,CAAS,WAAwB,EAAmB,EAAE;IACtF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,OAAiB,CAAC,CAAC;QACzD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,IAAI,IAAI,QAAQ,IAAI,MAAM,EAAE,CAAC;YACxE,OAAO,MAAM,CAAC,MAAM,CAAC;QACvB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,oCAAoC,EAAE,KAAK,CAAC,CAAC;IAC7D,CAAC;IACD,OAAO,EAAE,CAAC;AACZ,CAAC,CAAC;AAEF,kBAAe,yBAAyB,CAAC"}

package/dist/utils/parseDirectToolExecutionArgs.d.ts

@@ -0,0 +1,5 @@
+export declare function parseDirectToolExecutionArgs(args: string[]): {
+    toolName: string;
+    params: Record<string, any>;
+};
+//# sourceMappingURL=parseDirectToolExecutionArgs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parseDirectToolExecutionArgs.d.ts","sourceRoot":"","sources":["../../src/utils/parseDirectToolExecutionArgs.ts"],"names":[],"mappings":"AAAA,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAAE,CA8B9G"}

package/dist/utils/parseDirectToolExecutionArgs.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseDirectToolExecutionArgs = parseDirectToolExecutionArgs;
+function parseDirectToolExecutionArgs(args) {
+    if (args.length === 0) {
+        throw new Error('Usage: npm run tool <toolName> [key=value ...]');
+    }
+    const toolName = args[0];
+    const params = {};
+    // Parse key=value pairs
+    for (let i = 1; i < args.length; i++) {
+        const arg = args[i];
+        const equalIndex = arg.indexOf('=');
+        if (equalIndex === -1) {
+            throw new Error(`Invalid argument format: ${arg}. Expected key=value`);
+        }
+        const key = arg.substring(0, equalIndex);
+        const rawValue = arg.substring(equalIndex + 1);
+        // Try to parse as JSON (for objects, arrays, booleans, numbers)
+        try {
+            params[key] = JSON.parse(rawValue);
+        }
+        catch (_a) {
+            // If not valid JSON, treat as string
+            params[key] = rawValue;
+        }
+    }
+    return { toolName, params };
+}
+//# sourceMappingURL=parseDirectToolExecutionArgs.js.map

package/dist/utils/parseDirectToolExecutionArgs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseDirectToolExecutionArgs.js","sourceRoot":"","sources":["../../src/utils/parseDirectToolExecutionArgs.ts"],"names":[],"mappings":";;AAAA,oEA8BC;AA9BD,SAAgB,4BAA4B,CAAC,IAAc;IACzD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;IACpE,CAAC;IAED,MAAM,QAAQ,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACzB,MAAM,MAAM,GAAwB,EAAE,CAAC;IAEvC,wBAAwB;IACxB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,UAAU,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAEpC,IAAI,UAAU,KAAK,CAAC,CAAC,EAAE,CAAC;YACtB,MAAM,IAAI,KAAK,CAAC,4BAA4B,GAAG,sBAAsB,CAAC,CAAC;QACzE,CAAC;QAED,MAAM,GAAG,GAAG,GAAG,CAAC,SAAS,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;QACzC,MAAM,QAAQ,GAAG,GAAG,CAAC,SAAS,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;QAE/C,gEAAgE;QAChE,IAAI,CAAC;YACH,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QACrC,CAAC;QAAC,WAAM,CAAC;YACP,qCAAqC;YACrC,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC9B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@minded-ai/mindedjs",
-  "version": "2.0.27",
+  "version": "2.0.28-beta.1",
   "description": "MindedJS is a TypeScript library for building agents.",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -72,4 +72,4 @@
   "peerDependencies": {
     "playwright": "^1.55.0"
   }
-}
+}

package/src/agent.ts

@@ -53,6 +53,7 @@ import { destroyBrowserSession } from './browserTask/executeBrowserTask';
 import { BrowserTaskMode } from './browserTask/types';
 import { AnalyticsEventName } from './types/Analytics.types';
 import { trackAnalyticsEvent } from './internalTools/analytics';
+import { parseDirectToolExecutionArgs } from './utils/parseDirectToolExecutionArgs';
 import { convertPlatformLLMConfig } from './utils/llmConfigConverter';
 
 type CreateAgentParams<Memory> = {
@@ -177,6 +178,9 @@ export class Agent {
 
     // Register default analytics handler
     this.registerDefaultAnalyticsHandler();
+
+    // Check if running in tool execution mode
+    this.handleToolExecutionMode();
   }
 
   private async init(): Promise<void> {
@@ -276,7 +280,7 @@ export class Agent {
           logger.debug({ msg: '[Agent] Received tool execution request', toolName: request.toolName, sessionId: request.sessionId });
 
           try {
-            const response = await this.executeTool(request);
+            const response = await this.executeTool(request, 'browser-use');
             // Send response back via socket
             return {
               ...response,
@@ -821,7 +825,7 @@ export class Agent {
     } else if (runLocally) {
       throw new Error(
         'No LLM configuration found in minded.json. When running locally, you must provide LLM configuration in minded.json. ' +
-          'Add an "llm" section to your minded.json file with provider and model settings.',
+        'Add an "llm" section to your minded.json file with provider and model settings.',
       );
     } else {
       throw new Error('No LLM configuration found. Please configure LLM in Organization Settings or add it to minded.json');
@@ -983,10 +987,10 @@ export class Agent {
    * Execute a tool by name with given parameters
    * This is used for standalone tool execution (e.g., from browser-use)
    */
-  async executeTool(request: ToolExecutionRequest): Promise<ToolExecutionResponse> {
+  async executeTool(request: ToolExecutionRequest, source: 'browser-use' | 'direct'): Promise<ToolExecutionResponse> {
     await this.waitForInitialization();
     try {
-      return await this.toolExecutor.executeTool(request);
+      return await this.toolExecutor.executeTool(request, source);
     } catch (err) {
       logger.error({ message: '[Agent] Error executing tool', err });
       return { error: 'Failed to execute tool' };
@@ -1180,4 +1184,60 @@ export class Agent {
     this.sigtermHandlerRegistered = true;
     logger.debug({ msg: '[Agent] SIGTERM handler registered' });
   }
+
+  /**
+   * Handle tool execution mode when agent is run with 'runTool' argument
+   * This allows running tools directly via: npm run tool <toolName> [params...]
+   * 
+   * @private
+   */
+  private async handleToolExecutionMode(): Promise<void> {
+    if (!process.argv.includes('runTool')) {
+      return;
+    }
+
+    try {
+      await this.waitForInitialization();
+
+      const toolArgIndex = process.argv.indexOf('runTool');
+      const toolArgs = process.argv.slice(toolArgIndex + 1);
+
+      const { toolName, params } = parseDirectToolExecutionArgs(toolArgs);
+
+      logger.info({
+        message: '[runTool] Executing tool',
+        toolName,
+        params,
+      });
+
+      const result = await this.executeTool({
+        toolName,
+        toolParams: params,
+        sessionId: uuidv4(),
+        requestId: uuidv4()
+      }, 'direct');
+
+      if (result.error) {
+        logger.error({
+          message: '[runTool] Tool execution failed',
+          error: result.error,
+        });
+        process.exit(1);
+      }
+
+      logger.info({
+        message: '[runTool] Tool execution completed',
+        result: result.result,
+        state: result.state,
+      });
+
+      process.exit(0);
+    } catch (err) {
+      logger.error({
+        message: '[runTool] Error executing tool',
+        err,
+      });
+      process.exit(1);
+    }
+  }
 }

package/src/index.ts

@@ -107,5 +107,6 @@ export { AnalyticsEventName } from './types/Analytics.types';
 export type { AnalyticsEvent } from './types/Analytics.types';
 
 export { createBrowserSession, destroyBrowserSession } from './browserTask/executeBrowserTask';
-
+export { withBrowserSession } from './toolsLibrary/withBrowserSession';
+export { BrowserTaskMode } from './browserTask/types';
 export { LLMDebugCallbackHandler } from './debugging';

package/src/platform/toolExecutor.ts

@@ -19,7 +19,7 @@ export interface ToolExecutionResponse {
 export class ToolExecutor {
   private tools: Map<string, Tool<any, any>> = new Map();
 
-  constructor(private agent: Agent) {}
+  constructor(private agent: Agent) { }
 
   /**
    * Clear all registered tools
@@ -37,9 +37,7 @@ export class ToolExecutor {
     this.tools.clear();
 
     tools.forEach((tool) => {
-      if (tool.allowExecutionRequests === true) {
-        this.tools.set(tool.name, tool);
-      }
+      this.tools.set(tool.name, tool);
     });
   }
 
@@ -47,13 +45,13 @@ export class ToolExecutor {
    * Execute a tool by name with given parameters
    * This is called when browser-use requests tool execution via socket
    */
-  async executeTool(request: ToolExecutionRequest): Promise<ToolExecutionResponse> {
+  async executeTool(request: ToolExecutionRequest, source: 'browser-use' | 'direct'): Promise<ToolExecutionResponse> {
     const { toolName, toolParams, sessionId, cdpUrl } = request;
 
     try {
       // Find the tool
       const tool = this.tools.get(toolName);
-      if (!tool) {
+      if (!tool || (source === 'browser-use' && !tool.allowExecutionRequests)) {
         throw new Error(`Tool not found: ${toolName}`);
       }