@deadragdoll/tellymcp 0.0.11 → 0.0.13

package/dist/services/features/telegram-mcp/browser.service.js

@@ -21,6 +21,36 @@ const TelegramMcpBrowserService = {
                 return this.getBrowserService().getConsole(ctx.params);
             },
         },
+        listAttachedInstancesRemote: {
+            params: { $$strict: false },
+            async handler(ctx) {
+                return this.getBrowserService().listAttachedInstances(ctx.params);
+            },
+        },
+        listTabsRemote: {
+            params: { $$strict: false },
+            async handler(ctx) {
+                return this.getBrowserService().listTabs(ctx.params);
+            },
+        },
+        startRecordingRemote: {
+            params: { $$strict: false },
+            async handler(ctx) {
+                return this.getBrowserService().startRecording(ctx.params);
+            },
+        },
+        stopRecordingRemote: {
+            params: { $$strict: false },
+            async handler(ctx) {
+                return this.getBrowserService().stopRecording(ctx.params);
+            },
+        },
+        getRecordingStatusRemote: {
+            params: { $$strict: false },
+            async handler(ctx) {
+                return this.getBrowserService().getRecordingStatus(ctx.params);
+            },
+        },
         clickRemote: {
             params: { $$strict: false },
             async handler(ctx) {
@@ -33,6 +63,12 @@ const TelegramMcpBrowserService = {
                 return this.getBrowserService().fill(ctx.params);
             },
         },
+        injectScriptRemote: {
+            params: { $$strict: false },
+            async handler(ctx) {
+                return this.getBrowserService().injectScript(ctx.params);
+            },
+        },
         pressRemote: {
             params: { $$strict: false },
             async handler(ctx) {
@@ -119,7 +155,8 @@ const TelegramMcpBrowserService = {
         }
         const runtime = await runtimeService.waitUntilReady();
         this.logger.info("Starting telegram_mcp browser service");
-        this.browserService = new browserService_1.BrowserService(runtime.config, runtime.sessionStore, runtime.maintenanceStore, runtime.stateStore, runtime.stateStore, runtime.objectStore, runtime.telegramTransport, runtime.logger, runtime.projectIdentityResolver, new remoteConsoleActionClient_1.RemoteConsoleActionClient((actionName, params) => this.broker.call(actionName, params, { meta: { internal_call: true } })));
+        const firefoxAttachServer = runtime.firefoxAttachServer;
+        this.browserService = new browserService_1.BrowserService(runtime.config, runtime.sessionStore, runtime.maintenanceStore, runtime.stateStore, runtime.stateStore, runtime.objectStore, runtime.telegramTransport, runtime.logger, runtime.projectIdentityResolver, new remoteConsoleActionClient_1.RemoteConsoleActionClient((actionName, params) => this.broker.call(actionName, params, { meta: { internal_call: true } })), firefoxAttachServer);
         this.logger.info("telegram_mcp browser service is ready");
     },
     async stopped() {

package/dist/services/features/telegram-mcp/gateway-socket.service.js

@@ -1226,6 +1226,13 @@ const TelegramMcpGatewaySocketService = {
                             }))
                             : [],
                     }, { meta: { internal_call: true } });
+                    await runtime.telegramTransport.hydrateGatewayClientOwnerRoute({
+                        clientUuid: hello.client_uuid,
+                        ...(hello.gateway_user_uuid
+                            ? { gatewayUserUuid: hello.gateway_user_uuid }
+                            : {}),
+                    });
+                    runtime.telegramTransport.ensurePromptScanRunning();
                 }
                 const localVersionInfo = this.getLocalVersionInfo?.() ?? {
                     packageVersion: "0.0.0-unknown",
@@ -2002,6 +2009,9 @@ const TelegramMcpGatewaySocketService = {
                             }
                         }
                     }
+                    if ((this.connectedClientsByUuid?.size ?? 0) === 0) {
+                        runtime.telegramTransport.pausePromptScan();
+                    }
                     this.connectedClientToolsAlerts?.delete(socket);
                     this.connectedClients?.delete(socket);
                     runtime.logger.warn("Gateway WS client disconnected", {

package/dist/services/features/telegram-mcp/mcp-server.service.js

@@ -18,9 +18,15 @@ const browserConsoleTool_1 = require("./src/features/browser/model/browserConsol
 const browserDomTool_1 = require("./src/features/browser/model/browserDomTool");
 const browserErrorsTool_1 = require("./src/features/browser/model/browserErrorsTool");
 const browserFillTool_1 = require("./src/features/browser/model/browserFillTool");
+const browserInjectScriptTool_1 = require("./src/features/browser/model/browserInjectScriptTool");
+const browserListAttachedInstancesTool_1 = require("./src/features/browser/model/browserListAttachedInstancesTool");
+const browserListTabsTool_1 = require("./src/features/browser/model/browserListTabsTool");
 const browserNetworkFailuresTool_1 = require("./src/features/browser/model/browserNetworkFailuresTool");
 const browserOpenTool_1 = require("./src/features/browser/model/browserOpenTool");
 const browserPressTool_1 = require("./src/features/browser/model/browserPressTool");
+const browserRecordingStartTool_1 = require("./src/features/browser/model/browserRecordingStartTool");
+const browserRecordingStatusTool_1 = require("./src/features/browser/model/browserRecordingStatusTool");
+const browserRecordingStopTool_1 = require("./src/features/browser/model/browserRecordingStopTool");
 const browserReloadTool_1 = require("./src/features/browser/model/browserReloadTool");
 const browserScreenshotTool_1 = require("./src/features/browser/model/browserScreenshotTool");
 const browserWaitForTool_1 = require("./src/features/browser/model/browserWaitForTool");
@@ -76,10 +82,16 @@ const TelegramMcpMcpServerService = {
                 new notifyTelegramTool_1.NotifyTelegramTool(notifyService.getNotifyService()),
                 new sendFileToTelegramTool_1.SendFileToTelegramTool(notifyService.getNotifyService()),
                 new askUserTelegram_1.AskUserTelegramTool(approvalService.getApprovalOrchestrator()),
+                new browserListAttachedInstancesTool_1.BrowserListAttachedInstancesTool(browserService.getBrowserService()),
+                new browserListTabsTool_1.BrowserListTabsTool(browserService.getBrowserService()),
+                new browserRecordingStartTool_1.BrowserRecordingStartTool(browserService.getBrowserService()),
+                new browserRecordingStopTool_1.BrowserRecordingStopTool(browserService.getBrowserService()),
+                new browserRecordingStatusTool_1.BrowserRecordingStatusTool(browserService.getBrowserService()),
                 new browserOpenTool_1.BrowserOpenTool(browserService.getBrowserService()),
                 new browserReloadTool_1.BrowserReloadTool(browserService.getBrowserService()),
                 new browserClickTool_1.BrowserClickTool(browserService.getBrowserService()),
                 new browserFillTool_1.BrowserFillTool(browserService.getBrowserService()),
+                new browserInjectScriptTool_1.BrowserInjectScriptTool(browserService.getBrowserService()),
                 new browserPressTool_1.BrowserPressTool(browserService.getBrowserService()),
                 new browserWaitForTool_1.BrowserWaitForTool(browserService.getBrowserService()),
                 new browserWaitForUrlTool_1.BrowserWaitForUrlTool(browserService.getBrowserService()),

package/dist/services/features/telegram-mcp/src/app/bootstrap/runtime.js

@@ -12,6 +12,7 @@ const transport_1 = require("../../shared/integrations/telegram/transport");
 const minioExchangeStore_1 = require("../../shared/integrations/object-storage/minioExchangeStore");
 const gatewayHttpService_1 = require("../../features/distributed-gateway/model/gatewayHttpService");
 const gatewayClientAccess_1 = require("../../features/distributed-client/model/gatewayClientAccess");
+const firefoxAttachServer_1 = require("../../features/browser-attach/model/firefoxAttachServer");
 const client_2 = require("../../shared/integrations/terminal/client");
 const ptyRegistry_1 = require("../../shared/integrations/terminal/ptyRegistry");
 async function createAppRuntime(input) {
@@ -63,6 +64,15 @@ async function createAppRuntime(input) {
             nudgeDebounceSeconds: config.terminal.nudgeDebounceSeconds,
             nudgeCooldownSeconds: config.terminal.nudgeCooldownSeconds,
         },
+        browser: {
+            enabled: config.browser.enabled,
+            headless: config.browser.headless,
+            devtools: config.browser.devtools,
+            attachEnabled: config.browser.attach.enabled,
+            attachHost: config.browser.attach.host,
+            attachPort: config.browser.attach.port,
+            attachPath: config.browser.attach.path,
+        },
         telegram: {
             webhookEnabled: config.telegram.webhook.enabled,
             webhookPath: config.telegram.webhook.path,
@@ -200,6 +210,8 @@ async function createAppRuntime(input) {
     await telegramTransport.sendStartupNotifications();
     logger.info("Startup Telegram notifications completed");
     const gatewayHttpService = new gatewayHttpService_1.GatewayHttpService(config, input.callBroker);
+    const firefoxAttachServer = new firefoxAttachServer_1.FirefoxAttachServer(config, logger, stateStore, stateStore);
+    await firefoxAttachServer.start();
     return {
         callBroker: input.callBroker,
         config,
@@ -217,8 +229,10 @@ async function createAppRuntime(input) {
         projectIdentityResolver,
         webAppLaunchRegistry,
         gatewayHttpService,
+        firefoxAttachServer,
         shutdown: async () => {
             logger.info("Shutdown started");
+            await firefoxAttachServer.stop();
             await telegramTransport.stop();
             (0, ptyRegistry_1.stopAllPtyTargets)();
             redis.disconnect();

package/dist/services/features/telegram-mcp/src/app/config/env.js

@@ -211,6 +211,13 @@ const envSchema = z.object({
     BROWSER_EXECUTABLE_PATH: optionalNonEmptyString,
     BROWSER_CHANNEL: z.preprocess(emptyStringToUndefined, z.enum(["chrome", "chromium", "msedge"]).optional()),
     BROWSER_SLOW_MO_MS: z.coerce.number().int().nonnegative().default(0),
+    BROWSER_ATTACH_ENABLED: z
+        .string()
+        .optional()
+        .transform((value) => value === "true"),
+    BROWSER_ATTACH_WS_HOST: z.string().min(1).default("127.0.0.1"),
+    BROWSER_ATTACH_WS_PORT: z.coerce.number().int().positive().default(9999),
+    BROWSER_ATTACH_WS_PATH: z.string().min(1).default("/browser-attach/ws"),
     PROXY_USE: z.preprocess(emptyStringToUndefined, z.enum(["http", "socks5"]).optional()),
     HTTP_PROXY: optionalNonEmptyString,
     SOCKS5_PROXY: optionalNonEmptyString,
@@ -417,6 +424,12 @@ function loadConfig() {
                 : {}),
             ...(parsed.BROWSER_CHANNEL ? { channel: parsed.BROWSER_CHANNEL } : {}),
             slowMoMs: parsed.BROWSER_SLOW_MO_MS,
+            attach: {
+                enabled: parsed.BROWSER_ATTACH_ENABLED,
+                host: parsed.BROWSER_ATTACH_WS_HOST,
+                port: parsed.BROWSER_ATTACH_WS_PORT,
+                path: parsed.BROWSER_ATTACH_WS_PATH,
+            },
         },
         project: {
             ...(parsed.PROJECT_NAME ? { name: parsed.PROJECT_NAME } : {}),

package/dist/services/features/telegram-mcp/src/entities/request/model/schema.js

@@ -33,8 +33,8 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.sendPartnerFileInputSchema = exports.sendPartnerNoteInputSchema = exports.browserCloseOutputSchema = exports.browserCloseInputSchema = exports.browserScreenshotOutputSchema = exports.browserScreenshotInputSchema = exports.browserComputedStyleOutputSchema = exports.browserComputedStyleInputSchema = exports.browserDomOutputSchema = exports.browserDomInputSchema = exports.browserClearLogsOutputSchema = exports.browserClearLogsInputSchema = exports.browserNetworkFailuresOutputSchema = exports.browserNetworkFailuresInputSchema = exports.browserErrorsOutputSchema = exports.browserErrorsInputSchema = exports.browserConsoleOutputSchema = exports.browserConsoleInputSchema = exports.browserWaitForUrlOutputSchema = exports.browserWaitForUrlInputSchema = exports.browserWaitForOutputSchema = exports.browserWaitForInputSchema = exports.browserPressOutputSchema = exports.browserPressInputSchema = exports.browserFillOutputSchema = exports.browserFillInputSchema = exports.browserClickOutputSchema = exports.browserClickInputSchema = exports.browserReloadOutputSchema = exports.browserReloadInputSchema = exports.browserOpenOutputSchema = exports.browserOpenInputSchema = exports.clearSessionContextOutputSchema = exports.clearSessionContextInputSchema = exports.getSessionContextOutputSchema = exports.getSessionContextInputSchema = exports.setSessionContextOutputSchema = exports.renameSessionOutputSchema = exports.renameSessionInputSchema = exports.setSessionContextInputSchema = exports.refreshToolsMarkdownOutputSchema = exports.refreshToolsMarkdownInputSchema = exports.listGatewaySessionsOutputSchema = exports.listGatewaySessionsInputSchema = exports.sendFileToTelegramOutputSchema = exports.sendFileToTelegramInputSchema = exports.notifyTelegramOutputSchema = exports.notifyTelegramInputSchema = exports.askUserTelegramOutputSchema = exports.askUserTelegramInputSchema = void 0;
-exports.markXchangeRecordReadOutputSchema = exports.markXchangeRecordReadInputSchema = exports.getXchangeRecordOutputSchema = exports.getXchangeRecordInputSchema = exports.listXchangeRecordsOutputSchema = exports.listXchangeRecordsInputSchema = exports.sendPartnerNoteOutputSchema = void 0;
+exports.browserConsoleInputSchema = exports.browserWaitForUrlOutputSchema = exports.browserWaitForUrlInputSchema = exports.browserWaitForOutputSchema = exports.browserWaitForInputSchema = exports.browserInjectScriptOutputSchema = exports.browserInjectScriptInputSchema = exports.browserPressOutputSchema = exports.browserPressInputSchema = exports.browserFillOutputSchema = exports.browserFillInputSchema = exports.browserClickOutputSchema = exports.browserClickInputSchema = exports.browserReloadOutputSchema = exports.browserReloadInputSchema = exports.browserRecordingStatusOutputSchema = exports.browserRecordingStatusInputSchema = exports.browserRecordingStopOutputSchema = exports.browserRecordingStopInputSchema = exports.browserRecordingStartOutputSchema = exports.browserRecordingStartInputSchema = exports.browserDetachTabOutputSchema = exports.browserDetachTabInputSchema = exports.browserAttachTabOutputSchema = exports.browserAttachTabInputSchema = exports.browserAttachActiveTabInputSchema = exports.browserListTabsOutputSchema = exports.browserListTabsInputSchema = exports.browserListAttachedInstancesOutputSchema = exports.browserListAttachedInstancesInputSchema = exports.browserOpenOutputSchema = exports.browserOpenInputSchema = exports.clearSessionContextOutputSchema = exports.clearSessionContextInputSchema = exports.getSessionContextOutputSchema = exports.getSessionContextInputSchema = exports.setSessionContextOutputSchema = exports.renameSessionOutputSchema = exports.renameSessionInputSchema = exports.setSessionContextInputSchema = exports.refreshToolsMarkdownOutputSchema = exports.refreshToolsMarkdownInputSchema = exports.listGatewaySessionsOutputSchema = exports.listGatewaySessionsInputSchema = exports.sendFileToTelegramOutputSchema = exports.sendFileToTelegramInputSchema = exports.notifyTelegramOutputSchema = exports.notifyTelegramInputSchema = exports.askUserTelegramOutputSchema = exports.askUserTelegramInputSchema = void 0;
+exports.markXchangeRecordReadOutputSchema = exports.markXchangeRecordReadInputSchema = exports.getXchangeRecordOutputSchema = exports.getXchangeRecordInputSchema = exports.listXchangeRecordsOutputSchema = exports.listXchangeRecordsInputSchema = exports.sendPartnerNoteOutputSchema = exports.sendPartnerFileInputSchema = exports.sendPartnerNoteInputSchema = exports.browserCloseOutputSchema = exports.browserCloseInputSchema = exports.browserScreenshotOutputSchema = exports.browserScreenshotInputSchema = exports.browserComputedStyleOutputSchema = exports.browserComputedStyleInputSchema = exports.browserDomOutputSchema = exports.browserDomInputSchema = exports.browserClearLogsOutputSchema = exports.browserClearLogsInputSchema = exports.browserNetworkFailuresOutputSchema = exports.browserNetworkFailuresInputSchema = exports.browserErrorsOutputSchema = exports.browserErrorsInputSchema = exports.browserConsoleOutputSchema = void 0;
 const z = __importStar(require("zod/v4"));
 const partnerNoteKindSchema = z.enum([
     "share",
@@ -194,6 +194,8 @@ exports.clearSessionContextOutputSchema = z.object({
 exports.browserOpenInputSchema = z.object({
     session_id: z.string().trim().min(1).optional(),
     url: z.string().trim().min(1),
+    width: z.number().int().positive().max(10000).optional(),
+    height: z.number().int().positive().max(10000).optional(),
     wait_until: z
         .enum(["load", "domcontentloaded", "networkidle", "commit"])
         .optional(),
@@ -205,6 +207,133 @@ exports.browserOpenOutputSchema = z.object({
     created_context: z.boolean(),
     url: z.string().url(),
     title: z.string().optional(),
+    viewport_width: z.number().int().positive().optional(),
+    viewport_height: z.number().int().positive().optional(),
+});
+exports.browserListAttachedInstancesInputSchema = z.object({
+    session_id: z.string().trim().min(1).optional(),
+});
+exports.browserListAttachedInstancesOutputSchema = z.object({
+    session_id: z.string().trim().min(1).optional(),
+    total: z.number().int().nonnegative(),
+    instances: z.array(z.object({
+        instance_id: z.string().trim().min(1),
+        browser: z.literal("firefox"),
+        extension_version: z.string().trim().min(1),
+        profile_name: z.string().trim().min(1).optional(),
+        connected_at: z.string().trim().min(1),
+        last_seen_at: z.string().trim().min(1),
+        capabilities: z.array(z.string().trim().min(1)),
+        tab_count: z.number().int().nonnegative(),
+        active_tab: z
+            .object({
+            tab_id: z.number().int().nonnegative(),
+            window_id: z.number().int().nonnegative().optional(),
+            active: z.boolean(),
+            title: z.string(),
+            url: z.string(),
+            status: z.string().optional(),
+        })
+            .optional(),
+    })),
+});
+exports.browserListTabsInputSchema = z.object({
+    session_id: z.string().trim().min(1).optional(),
+    instance_id: z.string().trim().min(1).optional(),
+});
+exports.browserListTabsOutputSchema = z.object({
+    session_id: z.string().trim().min(1).optional(),
+    instance_id: z.string().trim().min(1),
+    total: z.number().int().nonnegative(),
+    tabs: z.array(z.object({
+        tab_id: z.number().int().nonnegative(),
+        window_id: z.number().int().nonnegative().optional(),
+        active: z.boolean(),
+        selected: z.boolean().optional(),
+        title: z.string(),
+        url: z.string(),
+        status: z.string().optional(),
+    })),
+});
+exports.browserAttachActiveTabInputSchema = z.object({
+    session_id: z.string().trim().min(1).optional(),
+    instance_id: z.string().trim().min(1).optional(),
+});
+exports.browserAttachTabInputSchema = z.object({
+    session_id: z.string().trim().min(1).optional(),
+    instance_id: z.string().trim().min(1).optional(),
+    tab_id: z.number().int().nonnegative(),
+});
+exports.browserAttachTabOutputSchema = z.object({
+    session_id: z.string().trim().min(1),
+    backend: z.literal("firefox-attached"),
+    instance_id: z.string().trim().min(1),
+    tab_id: z.number().int().nonnegative(),
+    attached_at: z.string().trim().min(1),
+    title: z.string().optional(),
+    url: z.string().optional(),
+});
+exports.browserDetachTabInputSchema = z.object({
+    session_id: z.string().trim().min(1).optional(),
+});
+exports.browserDetachTabOutputSchema = z.object({
+    session_id: z.string().trim().min(1),
+    detached: z.boolean(),
+});
+exports.browserRecordingStartInputSchema = z.object({
+    session_id: z.string().trim().min(1).optional(),
+    instance_id: z.string().trim().min(1).optional(),
+});
+exports.browserRecordingStartOutputSchema = z.object({
+    session_id: z.string().trim().min(1),
+    backend: z.literal("firefox-attached"),
+    started: z.boolean(),
+    recording_id: z.string().trim().min(1),
+    instance_id: z.string().trim().min(1),
+    tab_id: z.number().int().nonnegative(),
+    tab_title: z.string().optional(),
+    tab_url: z.string().optional(),
+    bundle_dir_name: z.string().trim().min(1),
+    bundle_relative_path: z.string().trim().min(1),
+    bundle_path: z.string().trim().min(1),
+    started_at: z.string().trim().min(1),
+});
+exports.browserRecordingStopInputSchema = z.object({
+    session_id: z.string().trim().min(1).optional(),
+});
+exports.browserRecordingStopOutputSchema = z.object({
+    session_id: z.string().trim().min(1),
+    stopped: z.boolean(),
+    recording_id: z.string().trim().min(1).optional(),
+    bundle_dir_name: z.string().trim().min(1).optional(),
+    bundle_relative_path: z.string().trim().min(1).optional(),
+    bundle_path: z.string().trim().min(1).optional(),
+    stopped_at: z.string().trim().min(1).optional(),
+});
+exports.browserRecordingStatusInputSchema = z.object({
+    session_id: z.string().trim().min(1).optional(),
+});
+exports.browserRecordingStatusOutputSchema = z.object({
+    session_id: z.string().trim().min(1),
+    active: z.boolean(),
+    recording: z
+        .object({
+        backend: z.literal("firefox-attached"),
+        recording_id: z.string().trim().min(1),
+        instance_id: z.string().trim().min(1),
+        tab_id: z.number().int().nonnegative(),
+        tab_title: z.string().optional(),
+        tab_url: z.string().optional(),
+        bundle_dir_name: z.string().trim().min(1),
+        bundle_relative_path: z.string().trim().min(1),
+        bundle_path: z.string().trim().min(1),
+        started_at: z.string().trim().min(1),
+        stopped_at: z.string().trim().min(1).optional(),
+        status: z.enum(["recording", "stopped"]),
+        event_count: z.number().int().nonnegative(),
+        last_event_at: z.string().trim().min(1).optional(),
+    })
+        .optional(),
 });
 exports.browserReloadInputSchema = z.object({
     session_id: z.string().trim().min(1).optional(),
@@ -274,6 +403,26 @@ exports.browserPressOutputSchema = z.object({
     url: z.string().url(),
     title: z.string().optional(),
 });
+exports.browserInjectScriptInputSchema = z
+    .object({
+    session_id: z.string().trim().min(1).optional(),
+    source: z.string().optional(),
+    file_path: z.string().trim().min(1).optional(),
+    namespace: z.string().trim().min(1).optional(),
+})
+    .refine((input) => Boolean(input.source?.trim() || input.file_path?.trim()), {
+    message: "Provide source or file_path.",
+    path: ["source"],
+});
+exports.browserInjectScriptOutputSchema = z.object({
+    session_id: z.string(),
+    injected: z.boolean(),
+    namespace: z.string(),
+    source_type: z.enum(["inline", "file"]),
+    bytes: z.number().int().nonnegative(),
+    url: z.string().url(),
+    title: z.string().optional(),
+});
 exports.browserWaitForInputSchema = z
     .object({
     ...browserLocatorInputShape,

package/dist/services/features/telegram-mcp/src/features/browser/model/browserClickTool.js

@@ -13,7 +13,7 @@ class BrowserClickTool {
     register(server) {
         server.registerTool("browser_click", {
             title: "Browser Click",
-            description: "Click an element in the session browser page by CSS selector or visible text.",
+            description: "Click an element in the current session browser target by CSS selector or visible text. If the session has a selected attached Firefox tab, click there; otherwise use the isolated Playwright page.",
             inputSchema: schema_1.browserClickInputSchema,
             outputSchema: schema_1.browserClickOutputSchema,
         }, async (args) => {

package/dist/services/features/telegram-mcp/src/features/browser/model/browserDomTool.js

@@ -13,7 +13,7 @@ class BrowserDomTool {
     register(server) {
         server.registerTool("browser_dom", {
             title: "Browser DOM",
-            description: "Inspect a DOM element in the Playwright tab for the current session and return text, HTML, attributes, and visibility.",
+            description: "Inspect a DOM element in the current session browser target and return text, HTML, attributes, and visibility. If the session has a selected attached Firefox tab, inspect that tab; otherwise use the isolated Playwright page.",
             inputSchema: schema_1.browserDomInputSchema,
             outputSchema: schema_1.browserDomOutputSchema,
         }, async (args) => {

package/dist/services/features/telegram-mcp/src/features/browser/model/browserFillTool.js

@@ -13,7 +13,7 @@ class BrowserFillTool {
     register(server) {
         server.registerTool("browser_fill", {
             title: "Browser Fill",
-            description: "Fill an input or textarea in the session browser page by CSS selector or visible text.",
+            description: "Fill an input or textarea in the current session browser target by CSS selector or visible text. If the session has a selected attached Firefox tab, fill there; otherwise use the isolated Playwright page.",
             inputSchema: schema_1.browserFillInputSchema,
             outputSchema: schema_1.browserFillOutputSchema,
         }, async (args) => {

package/dist/services/features/telegram-mcp/src/features/browser/model/browserInjectScriptTool.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserInjectScriptTool = void 0;
+const schema_1 = require("../../../entities/request/model/schema");
+function createContent(output) {
+    return [{ type: "text", text: JSON.stringify(output, null, 2) }];
+}
+class BrowserInjectScriptTool {
+    browserService;
+    constructor(browserService) {
+        this.browserService = browserService;
+    }
+    register(server) {
+        server.registerTool("browser_inject_script", {
+            title: "Browser Inject Script",
+            description: "Inject JavaScript into the current session browser target. If the session has a selected attached browser tab, inject into that real tab; otherwise inject into the isolated Playwright page. The script is wrapped so window[namespace] exists, with namespace defaulting to TELLY.",
+            inputSchema: schema_1.browserInjectScriptInputSchema,
+            outputSchema: schema_1.browserInjectScriptOutputSchema,
+        }, async (args) => {
+            const output = await this.browserService.injectScript(args);
+            return {
+                content: createContent(output),
+                structuredContent: output,
+            };
+        });
+    }
+}
+exports.BrowserInjectScriptTool = BrowserInjectScriptTool;

package/dist/services/features/telegram-mcp/src/features/browser/model/browserListAttachedInstancesTool.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserListAttachedInstancesTool = void 0;
+const schema_1 = require("../../../entities/request/model/schema");
+function createContent(output) {
+    return [
+        {
+            type: "text",
+            text: JSON.stringify(output, null, 2),
+        },
+    ];
+}
+class BrowserListAttachedInstancesTool {
+    browserService;
+    constructor(browserService) {
+        this.browserService = browserService;
+    }
+    register(server) {
+        server.registerTool("browser_list_attached_instances", {
+            title: "Browser List Attached Instances",
+            description: "List Firefox browser instances currently attached through the local browser-attach extension bridge for the current console.",
+            inputSchema: schema_1.browserListAttachedInstancesInputSchema,
+            outputSchema: schema_1.browserListAttachedInstancesOutputSchema,
+        }, async (args) => {
+            const output = await this.browserService.listAttachedInstances(args);
+            return {
+                content: createContent(output),
+                structuredContent: output,
+            };
+        });
+    }
+}
+exports.BrowserListAttachedInstancesTool = BrowserListAttachedInstancesTool;

package/dist/services/features/telegram-mcp/src/features/browser/model/browserListTabsTool.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserListTabsTool = void 0;
+const schema_1 = require("../../../entities/request/model/schema");
+function createContent(output) {
+    return [
+        {
+            type: "text",
+            text: JSON.stringify(output, null, 2),
+        },
+    ];
+}
+class BrowserListTabsTool {
+    browserService;
+    constructor(browserService) {
+        this.browserService = browserService;
+    }
+    register(server) {
+        server.registerTool("browser_list_tabs", {
+            title: "Browser List Tabs",
+            description: "List tabs from a Firefox browser instance attached through the local browser-attach extension bridge. If only one instance is connected, instance_id can be omitted. Note: active=true is per Firefox window; for the tab selected for the current MCP session, use selected=true.",
+            inputSchema: schema_1.browserListTabsInputSchema,
+            outputSchema: schema_1.browserListTabsOutputSchema,
+        }, async (args) => {
+            const output = await this.browserService.listTabs(args);
+            return {
+                content: createContent(output),
+                structuredContent: output,
+            };
+        });
+    }
+}
+exports.BrowserListTabsTool = BrowserListTabsTool;

package/dist/services/features/telegram-mcp/src/features/browser/model/browserOpenTool.js

@@ -18,7 +18,7 @@ class BrowserOpenTool {
     register(server) {
         server.registerTool("browser_open", {
             title: "Browser Open",
-            description: "Open a URL in the isolated Playwright browser context for the current session. Reuse the existing tab unless reset_context=true.",
+            description: "Open a URL in the isolated Playwright browser context for the current session. Reuse the existing tab unless reset_context=true. Optionally pass width and height to control the viewport.",
             inputSchema: schema_1.browserOpenInputSchema,
             outputSchema: schema_1.browserOpenOutputSchema,
         }, async (args) => {

package/dist/services/features/telegram-mcp/src/features/browser/model/browserPressTool.js

@@ -13,7 +13,7 @@ class BrowserPressTool {
     register(server) {
         server.registerTool("browser_press", {
             title: "Browser Press",
-            description: "Send a key press to the session browser page or to a targeted element.",
+            description: "Send a key press to the current session browser target or to a targeted element. If the session has a selected attached Firefox tab, press there; otherwise use the isolated Playwright page.",
             inputSchema: schema_1.browserPressInputSchema,
             outputSchema: schema_1.browserPressOutputSchema,
         }, async (args) => {

package/dist/services/features/telegram-mcp/src/features/browser/model/browserRecordingStartTool.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserRecordingStartTool = void 0;
+const schema_1 = require("../../../entities/request/model/schema");
+function createContent(output) {
+    return [{ type: "text", text: JSON.stringify(output, null, 2) }];
+}
+class BrowserRecordingStartTool {
+    browserService;
+    constructor(browserService) {
+        this.browserService = browserService;
+    }
+    register(server) {
+        server.registerTool("browser_recording_start", {
+            title: "Browser Recording Start",
+            description: "Start a structured browser recording bundle for the Firefox tab selected for this MCP session through the local browser-attach extension. The recording is written under .mcp-xchange/web/{tab-title-slug}-{timestamp}/ with session.json, timeline.ndjson, pages/, network/, and console/ artifacts.",
+            inputSchema: schema_1.browserRecordingStartInputSchema,
+            outputSchema: schema_1.browserRecordingStartOutputSchema,
+        }, async (args) => {
+            const output = await this.browserService.startRecording(args);
+            return {
+                content: createContent(output),
+                structuredContent: output,
+            };
+        });
+    }
+}
+exports.BrowserRecordingStartTool = BrowserRecordingStartTool;

package/dist/services/features/telegram-mcp/src/features/browser/model/browserRecordingStatusTool.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserRecordingStatusTool = void 0;
+const schema_1 = require("../../../entities/request/model/schema");
+function createContent(output) {
+    return [{ type: "text", text: JSON.stringify(output, null, 2) }];
+}
+class BrowserRecordingStatusTool {
+    browserService;
+    constructor(browserService) {
+        this.browserService = browserService;
+    }
+    register(server) {
+        server.registerTool("browser_recording_status", {
+            title: "Browser Recording Status",
+            description: "Report whether a structured browser recording is active for the current MCP session, and return the current bundle path and metadata if it exists.",
+            inputSchema: schema_1.browserRecordingStatusInputSchema,
+            outputSchema: schema_1.browserRecordingStatusOutputSchema,
+        }, async (args) => {
+            const output = await this.browserService.getRecordingStatus(args);
+            return {
+                content: createContent(output),
+                structuredContent: output,
+            };
+        });
+    }
+}
+exports.BrowserRecordingStatusTool = BrowserRecordingStatusTool;

package/dist/services/features/telegram-mcp/src/features/browser/model/browserRecordingStopTool.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserRecordingStopTool = void 0;
+const schema_1 = require("../../../entities/request/model/schema");
+function createContent(output) {
+    return [{ type: "text", text: JSON.stringify(output, null, 2) }];
+}
+class BrowserRecordingStopTool {
+    browserService;
+    constructor(browserService) {
+        this.browserService = browserService;
+    }
+    register(server) {
+        server.registerTool("browser_recording_stop", {
+            title: "Browser Recording Stop",
+            description: "Stop the active structured browser recording for the current session. The bundle remains in .mcp-xchange/web/... for later analysis by the agent.",
+            inputSchema: schema_1.browserRecordingStopInputSchema,
+            outputSchema: schema_1.browserRecordingStopOutputSchema,
+        }, async (args) => {
+            const output = await this.browserService.stopRecording(args);
+            return {
+                content: createContent(output),
+                structuredContent: output,
+            };
+        });
+    }
+}
+exports.BrowserRecordingStopTool = BrowserRecordingStopTool;

package/dist/services/features/telegram-mcp/src/features/browser/model/browserScreenshotTool.js

@@ -13,7 +13,7 @@ class BrowserScreenshotTool {
     register(server) {
         server.registerTool("browser_screenshot", {
             title: "Browser Screenshot",
-            description: "Capture a screenshot from the Playwright tab for the current session. By default it is saved into .mcp-xchange. If the user wants the screenshot sent back to the human in Telegram, set send_to_telegram=true so the PNG is delivered through the gateway route instead of forcing a separate file-delivery workaround.",
+            description: "Capture a screenshot from the current session browser target. If the session has a selected attached Firefox tab, capture that real browser tab; otherwise use the isolated Playwright page. By default it is saved into .mcp-xchange. If the user wants the screenshot sent back to the human in Telegram, set send_to_telegram=true so the PNG is delivered through the gateway route instead of forcing a separate file-delivery workaround.",
             inputSchema: schema_1.browserScreenshotInputSchema,
             outputSchema: schema_1.browserScreenshotOutputSchema,
         }, async (args) => {