@deadragdoll/tellymcp 0.0.12 → 0.0.13

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",
@@ -210,6 +210,131 @@ exports.browserOpenOutputSchema = z.object({
     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(),
     wait_until: z
@@ -278,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/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) => {