@hotmeshio/long-tail 0.1.3 → 0.1.5

package/build/system/mcp-servers/playwright/index.js

@@ -3,7 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.stopPlaywrightServer = exports.buildHandle = exports.ensureBrowser = exports.allocatePageId = exports.pages = void 0;
 exports.createPlaywrightServer = createPlaywrightServer;
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
-const logger_1 = require("../../../services/logger");
+const logger_1 = require("../../../lib/logger");
 const tools_atomic_1 = require("./tools-atomic");
 const tools_run_script_1 = require("./tools-run-script");
 // Re-export public API consumed by playwright-cli.ts and system/index.ts

package/build/system/mcp-servers/playwright/schemas.d.ts

@@ -68,6 +68,7 @@ export declare const screenshotSchema: z.ZodObject<{
     path: z.ZodString;
     full_page: z.ZodOptional<z.ZodBoolean>;
     selector: z.ZodOptional<z.ZodString>;
+    describe: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     path: string;
     url?: string | undefined;
@@ -77,9 +78,10 @@ export declare const screenshotSchema: z.ZodObject<{
         page_id: string;
         cdp_endpoint?: string | undefined;
     } | undefined;
-    selector?: string | undefined;
     wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
     full_page?: boolean | undefined;
+    selector?: string | undefined;
+    describe?: boolean | undefined;
 }, {
     path: string;
     url?: string | undefined;
@@ -89,9 +91,10 @@ export declare const screenshotSchema: z.ZodObject<{
         page_id: string;
         cdp_endpoint?: string | undefined;
     } | undefined;
-    selector?: string | undefined;
     wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
     full_page?: boolean | undefined;
+    selector?: string | undefined;
+    describe?: boolean | undefined;
 }>;
 export declare const clickSchema: z.ZodObject<{
     _handle: z.ZodOptional<z.ZodObject<{
@@ -273,6 +276,7 @@ export declare const runScriptStepSchema: z.ZodObject<{
     script: z.ZodOptional<z.ZodString>;
     timeout: z.ZodOptional<z.ZodNumber>;
     not: z.ZodOptional<z.ZodBoolean>;
+    describe: z.ZodOptional<z.ZodBoolean>;
 }, "strip", z.ZodTypeAny, {
     action: "fill" | "navigate" | "screenshot" | "click" | "wait_for" | "wait_for_url" | "wait" | "evaluate";
     value?: string | undefined;
@@ -280,9 +284,10 @@ export declare const runScriptStepSchema: z.ZodObject<{
     url?: string | undefined;
     path?: string | undefined;
     timeout?: number | undefined;
-    selector?: string | undefined;
     wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
     full_page?: boolean | undefined;
+    selector?: string | undefined;
+    describe?: boolean | undefined;
     script?: string | undefined;
 }, {
     action: "fill" | "navigate" | "screenshot" | "click" | "wait_for" | "wait_for_url" | "wait" | "evaluate";
@@ -291,9 +296,10 @@ export declare const runScriptStepSchema: z.ZodObject<{
     url?: string | undefined;
     path?: string | undefined;
     timeout?: number | undefined;
-    selector?: string | undefined;
     wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
     full_page?: boolean | undefined;
+    selector?: string | undefined;
+    describe?: boolean | undefined;
     script?: string | undefined;
 }>;
 export declare const runScriptSchema: z.ZodObject<{
@@ -321,6 +327,7 @@ export declare const runScriptSchema: z.ZodObject<{
         script: z.ZodOptional<z.ZodString>;
         timeout: z.ZodOptional<z.ZodNumber>;
         not: z.ZodOptional<z.ZodBoolean>;
+        describe: z.ZodOptional<z.ZodBoolean>;
     }, "strip", z.ZodTypeAny, {
         action: "fill" | "navigate" | "screenshot" | "click" | "wait_for" | "wait_for_url" | "wait" | "evaluate";
         value?: string | undefined;
@@ -328,9 +335,10 @@ export declare const runScriptSchema: z.ZodObject<{
         url?: string | undefined;
         path?: string | undefined;
         timeout?: number | undefined;
-        selector?: string | undefined;
         wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
         full_page?: boolean | undefined;
+        selector?: string | undefined;
+        describe?: boolean | undefined;
         script?: string | undefined;
     }, {
         action: "fill" | "navigate" | "screenshot" | "click" | "wait_for" | "wait_for_url" | "wait" | "evaluate";
@@ -339,9 +347,10 @@ export declare const runScriptSchema: z.ZodObject<{
         url?: string | undefined;
         path?: string | undefined;
         timeout?: number | undefined;
-        selector?: string | undefined;
         wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
         full_page?: boolean | undefined;
+        selector?: string | undefined;
+        describe?: boolean | undefined;
         script?: string | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
@@ -352,9 +361,10 @@ export declare const runScriptSchema: z.ZodObject<{
         url?: string | undefined;
         path?: string | undefined;
         timeout?: number | undefined;
-        selector?: string | undefined;
         wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
         full_page?: boolean | undefined;
+        selector?: string | undefined;
+        describe?: boolean | undefined;
         script?: string | undefined;
     }[];
     _handle?: {
@@ -370,9 +380,10 @@ export declare const runScriptSchema: z.ZodObject<{
         url?: string | undefined;
         path?: string | undefined;
         timeout?: number | undefined;
-        selector?: string | undefined;
         wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
         full_page?: boolean | undefined;
+        selector?: string | undefined;
+        describe?: boolean | undefined;
         script?: string | undefined;
     }[];
     _handle?: {

package/build/system/mcp-servers/playwright/schemas.js

@@ -31,6 +31,8 @@ exports.screenshotSchema = zod_1.z.object({
         .describe('Capture the full scrollable page (default: false)'),
     selector: zod_1.z.string().optional()
         .describe('CSS selector to screenshot a specific element'),
+    describe: zod_1.z.boolean().optional()
+        .describe('When true, automatically analyze the screenshot using a vision LLM and return a description alongside metadata. Use this when you need to understand the page content.'),
 });
 exports.clickSchema = zod_1.z.object({
     _handle: exports.handleProp,
@@ -78,6 +80,7 @@ exports.runScriptStepSchema = zod_1.z.object({
     script: zod_1.z.string().optional().describe('JavaScript for evaluate action'),
     timeout: zod_1.z.number().optional().describe('Timeout in ms for wait_for/wait_for_url/wait actions'),
     not: zod_1.z.boolean().optional().describe('For wait_for_url: wait until URL does NOT match (default: false)'),
+    describe: zod_1.z.boolean().optional().describe('For screenshot: auto-analyze via vision LLM and include description in result'),
 });
 exports.runScriptSchema = zod_1.z.object({
     _handle: exports.handleProp,

package/build/system/mcp-servers/playwright/tools-navigation.js

@@ -1,10 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerNavigationTools = registerNavigationTools;
-const logger_1 = require("../../../services/logger");
-const storage_1 = require("../../../services/storage");
+const logger_1 = require("../../../lib/logger");
+const storage_1 = require("../../../lib/storage");
 const browser_lifecycle_1 = require("./browser-lifecycle");
 const schemas_1 = require("./schemas");
+const vision_helper_1 = require("./vision-helper");
 function registerNavigationTools(srv) {
     // ── navigate ─────────────────────────────────────────────
     srv.registerTool('navigate', {
@@ -124,16 +125,28 @@ function registerNavigationTools(srv) {
         }
         const { size } = await backend.commitLocalPath(args.path, localPath);
         logger_1.loggerRegistry.info(`[lt-mcp:playwright] screenshot saved: ${args.path} (${size} bytes)`);
+        const metadata = {
+            page_id: pageId,
+            path: args.path,
+            size_bytes: size,
+            url: page.url(),
+            _handle: (0, browser_lifecycle_1.buildHandle)(pageId),
+        };
+        // Auto-analyze via vision LLM when requested
+        if (args.describe) {
+            try {
+                const description = await (0, vision_helper_1.analyzeScreenshot)(args.path);
+                metadata.description = description;
+            }
+            catch (err) {
+                metadata.description = null;
+                metadata.describe_error = err.message;
+            }
+        }
         return {
             content: [{
                     type: 'text',
-                    text: JSON.stringify({
-                        page_id: pageId,
-                        path: args.path,
-                        size_bytes: size,
-                        url: page.url(),
-                        _handle: (0, browser_lifecycle_1.buildHandle)(pageId),
-                    }),
+                    text: JSON.stringify(metadata),
                 }],
         };
     });

package/build/system/mcp-servers/playwright/tools-run-script.js

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerRunScript = registerRunScript;
-const logger_1 = require("../../../services/logger");
-const storage_1 = require("../../../services/storage");
+const logger_1 = require("../../../lib/logger");
+const storage_1 = require("../../../lib/storage");
 const types_1 = require("./types");
 const browser_lifecycle_1 = require("./browser-lifecycle");
 const schemas_1 = require("./schemas");
+const vision_helper_1 = require("./vision-helper");
 function registerRunScript(srv) {
     srv.registerTool('run_script', {
         title: 'Run Browser Script',
@@ -99,7 +100,17 @@ function registerRunScript(srv) {
                     }
                     const { size: ssSize } = await ssBackend.commitLocalPath(step.path, ssLocalPath);
                     logger_1.loggerRegistry.info(`[lt-mcp:playwright] screenshot saved: ${step.path} (${ssSize} bytes)`);
-                    stepResults.push({ step: i, action: 'screenshot', result: { path: step.path, size_bytes: ssSize, url: page.url() } });
+                    const ssResult = { path: step.path, size_bytes: ssSize, url: page.url() };
+                    if (step.describe) {
+                        try {
+                            ssResult.description = await (0, vision_helper_1.analyzeScreenshot)(step.path);
+                        }
+                        catch (err) {
+                            ssResult.description = null;
+                            ssResult.describe_error = err.message;
+                        }
+                    }
+                    stepResults.push({ step: i, action: 'screenshot', result: ssResult });
                     break;
                 }
                 case 'click': {
@@ -174,12 +185,18 @@ function registerRunScript(srv) {
                 }
             }
         }
+        // Collect screenshot paths for top-level wiring (compiler can't reach nested step results)
+        const screenshots = stepResults
+            .filter(s => s.action === 'screenshot' && s.result.path)
+            .map(s => s.result.path);
         return {
             content: [{
                     type: 'text',
                     text: JSON.stringify({
                         steps_completed: stepResults.length,
                         steps: stepResults,
+                        screenshots,
+                        last_screenshot_path: screenshots.length > 0 ? screenshots[screenshots.length - 1] : null,
                         page_id: pageId,
                         url: page?.url?.() ?? null,
                         _handle: pageId ? (0, browser_lifecycle_1.buildHandle)(pageId) : undefined,

package/build/system/mcp-servers/playwright/vision-helper.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shared vision analysis helper for playwright tools.
+ *
+ * Reads a screenshot from the storage backend and analyzes it
+ * via the secondary vision LLM. Used by both the standalone
+ * screenshot tool and run_script's screenshot steps.
+ */
+/**
+ * Read a screenshot from storage and analyze it via the vision LLM.
+ * Returns the raw LLM text response (typically JSON with description, objects, etc.).
+ */
+export declare function analyzeScreenshot(storagePath: string): Promise<string>;

package/build/system/mcp-servers/playwright/vision-helper.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * Shared vision analysis helper for playwright tools.
+ *
+ * Reads a screenshot from the storage backend and analyzes it
+ * via the secondary vision LLM. Used by both the standalone
+ * screenshot tool and run_script's screenshot steps.
+ */
+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.analyzeScreenshot = analyzeScreenshot;
+const path = __importStar(require("path"));
+const storage_1 = require("../../../lib/storage");
+const MIME_MAP = {
+    '.png': 'image/png', '.jpg': 'image/jpeg', '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif', '.webp': 'image/webp',
+};
+/**
+ * Read a screenshot from storage and analyze it via the vision LLM.
+ * Returns the raw LLM text response (typically JSON with description, objects, etc.).
+ */
+async function analyzeScreenshot(storagePath) {
+    const { callLLM, hasLLMApiKey } = await Promise.resolve().then(() => __importStar(require('../../../services/llm')));
+    const { LLM_MODEL_SECONDARY, LLM_MAX_TOKENS_VISION } = await Promise.resolve().then(() => __importStar(require('../../../modules/defaults')));
+    const { ANALYZE_IMAGE_PROMPT } = await Promise.resolve().then(() => __importStar(require('../vision-prompts')));
+    if (!hasLLMApiKey(LLM_MODEL_SECONDARY)) {
+        return 'Vision LLM not configured — set an API key to enable screenshot analysis.';
+    }
+    const backend = (0, storage_1.getStorageBackend)();
+    const { data } = await backend.read(storagePath);
+    const base64 = data.toString('base64');
+    const ext = path.extname(storagePath).toLowerCase();
+    const mime = MIME_MAP[ext] || 'image/png';
+    const response = await callLLM({
+        model: LLM_MODEL_SECONDARY,
+        messages: [
+            { role: 'system', content: ANALYZE_IMAGE_PROMPT },
+            {
+                role: 'user',
+                content: [
+                    { type: 'image_url', image_url: { url: `data:${mime};base64,${base64}` } },
+                ],
+            },
+        ],
+        max_tokens: LLM_MAX_TOKENS_VISION,
+        temperature: 0,
+    });
+    return response.content || 'No description generated.';
+}

package/build/system/mcp-servers/playwright-cli/helpers.js

@@ -2,8 +2,8 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.saveScreenshot = saveScreenshot;
 exports.errorResult = errorResult;
-const logger_1 = require("../../../services/logger");
-const storage_1 = require("../../../services/storage");
+const logger_1 = require("../../../lib/logger");
+const storage_1 = require("../../../lib/storage");
 async function saveScreenshot(page, filePath, fullPage) {
     const backend = (0, storage_1.getStorageBackend)();
     const localPath = await backend.getLocalPath(filePath);

package/build/system/mcp-servers/playwright-cli/index.js

@@ -2,7 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.createPlaywrightCliServer = createPlaywrightCliServer;
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
-const logger_1 = require("../../../services/logger");
+const logger_1 = require("../../../lib/logger");
 const tools_auth_1 = require("./tools-auth");
 const tools_capture_1 = require("./tools-capture");
 async function createPlaywrightCliServer(options) {

package/build/system/mcp-servers/playwright-cli/schemas.d.ts

@@ -13,25 +13,25 @@ export declare const loginAndCaptureSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     password: string;
     url: string;
-    username: string;
-    submit_selector: string;
     username_selector: string;
     password_selector: string;
+    username: string;
+    submit_selector: string;
     timeout?: number | undefined;
-    screenshot_path?: string | undefined;
     full_page?: boolean | undefined;
     wait_after_login?: string | undefined;
+    screenshot_path?: string | undefined;
 }, {
     password: string;
     url: string;
-    username: string;
-    submit_selector: string;
     username_selector: string;
     password_selector: string;
+    username: string;
+    submit_selector: string;
     timeout?: number | undefined;
-    screenshot_path?: string | undefined;
     full_page?: boolean | undefined;
     wait_after_login?: string | undefined;
+    screenshot_path?: string | undefined;
 }>;
 export declare const capturePageSchema: z.ZodObject<{
     url: z.ZodString;
@@ -46,20 +46,20 @@ export declare const capturePageSchema: z.ZodObject<{
     url: string;
     timeout?: number | undefined;
     page_id?: string | undefined;
-    screenshot_path?: string | undefined;
     wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
-    wait_ms?: number | undefined;
     full_page?: boolean | undefined;
+    screenshot_path?: string | undefined;
     wait_for_selector?: string | undefined;
+    wait_ms?: number | undefined;
 }, {
     url: string;
     timeout?: number | undefined;
     page_id?: string | undefined;
-    screenshot_path?: string | undefined;
     wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
-    wait_ms?: number | undefined;
     full_page?: boolean | undefined;
+    screenshot_path?: string | undefined;
     wait_for_selector?: string | undefined;
+    wait_ms?: number | undefined;
 }>;
 export declare const captureAuthenticatedPagesSchema: z.ZodObject<{
     login: z.ZodObject<{
@@ -74,19 +74,19 @@ export declare const captureAuthenticatedPagesSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         password: string;
         url: string;
-        username: string;
-        submit_selector: string;
         username_selector: string;
         password_selector: string;
+        username: string;
+        submit_selector: string;
         timeout?: number | undefined;
         wait_after_login?: string | undefined;
     }, {
         password: string;
         url: string;
-        username: string;
-        submit_selector: string;
         username_selector: string;
         password_selector: string;
+        username: string;
+        submit_selector: string;
         timeout?: number | undefined;
         wait_after_login?: string | undefined;
     }>;
@@ -99,51 +99,51 @@ export declare const captureAuthenticatedPagesSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         url: string;
         screenshot_path: string;
-        wait_ms?: number | undefined;
         full_page?: boolean | undefined;
         wait_for_selector?: string | undefined;
+        wait_ms?: number | undefined;
     }, {
         url: string;
         screenshot_path: string;
-        wait_ms?: number | undefined;
         full_page?: boolean | undefined;
         wait_for_selector?: string | undefined;
+        wait_ms?: number | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     login: {
         password: string;
         url: string;
-        username: string;
-        submit_selector: string;
         username_selector: string;
         password_selector: string;
+        username: string;
+        submit_selector: string;
         timeout?: number | undefined;
         wait_after_login?: string | undefined;
     };
     pages: {
         url: string;
         screenshot_path: string;
-        wait_ms?: number | undefined;
         full_page?: boolean | undefined;
         wait_for_selector?: string | undefined;
+        wait_ms?: number | undefined;
     }[];
 }, {
     login: {
         password: string;
         url: string;
-        username: string;
-        submit_selector: string;
         username_selector: string;
         password_selector: string;
+        username: string;
+        submit_selector: string;
         timeout?: number | undefined;
         wait_after_login?: string | undefined;
     };
     pages: {
         url: string;
         screenshot_path: string;
-        wait_ms?: number | undefined;
         full_page?: boolean | undefined;
         wait_for_selector?: string | undefined;
+        wait_ms?: number | undefined;
     }[];
 }>;
 export declare const extractContentSchema: z.ZodObject<{
@@ -161,21 +161,21 @@ export declare const extractContentSchema: z.ZodObject<{
     timeout?: number | undefined;
     page_id?: string | undefined;
     selector?: string | undefined;
+    script?: string | undefined;
+    wait_for_selector?: string | undefined;
     wait_ms?: number | undefined;
     extract_links?: boolean | undefined;
     extract_metadata?: boolean | undefined;
-    script?: string | undefined;
-    wait_for_selector?: string | undefined;
 }, {
     url?: string | undefined;
     timeout?: number | undefined;
     page_id?: string | undefined;
     selector?: string | undefined;
+    script?: string | undefined;
+    wait_for_selector?: string | undefined;
     wait_ms?: number | undefined;
     extract_links?: boolean | undefined;
     extract_metadata?: boolean | undefined;
-    script?: string | undefined;
-    wait_for_selector?: string | undefined;
 }>;
 export declare const submitFormSchema: z.ZodObject<{
     url: z.ZodString;
@@ -202,8 +202,8 @@ export declare const submitFormSchema: z.ZodObject<{
         selector: string;
     }[];
     timeout?: number | undefined;
-    screenshot_path?: string | undefined;
     full_page?: boolean | undefined;
+    screenshot_path?: string | undefined;
     wait_after_submit?: string | undefined;
 }, {
     url: string;
@@ -213,7 +213,7 @@ export declare const submitFormSchema: z.ZodObject<{
         selector: string;
     }[];
     timeout?: number | undefined;
-    screenshot_path?: string | undefined;
     full_page?: boolean | undefined;
+    screenshot_path?: string | undefined;
     wait_after_submit?: string | undefined;
 }>;

package/build/system/mcp-servers/playwright-cli/schemas.js

@@ -19,7 +19,7 @@ exports.loginAndCaptureSchema = zod_1.z.object({
 exports.capturePageSchema = zod_1.z.object({
     url: zod_1.z.string().describe('URL to navigate to and capture'),
     screenshot_path: zod_1.z.string().optional()
-        .describe('File path to save the screenshot PNG. If omitted, auto-derived from the URL path (e.g., /admin/users → screenshots/admin-users.png).'),
+        .describe('Storage path for the screenshot PNG (persisted to file storage). If omitted, auto-derived from the URL path (e.g., /admin/users → screenshots/admin-users.png). The screenshot is saved automatically — no separate write_file call is needed.'),
     page_id: zod_1.z.string().optional().describe('Reuse an existing page to preserve session (e.g., from login_and_capture)'),
     full_page: zod_1.z.boolean().optional().describe('Capture full scrollable page (default: true)'),
     wait_for_selector: zod_1.z.string().optional()

package/build/system/mcp-servers/playwright-cli/tools-auth.js

@@ -35,7 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerAuthTools = registerAuthTools;
 const path = __importStar(require("path"));
-const logger_1 = require("../../../services/logger");
+const logger_1 = require("../../../lib/logger");
 const playwright_1 = require("../playwright");
 const schemas_1 = require("./schemas");
 const helpers_1 = require("./helpers");

package/build/system/mcp-servers/playwright-cli/tools-capture.js

@@ -35,7 +35,7 @@ var __importStar = (this && this.__importStar) || (function () {
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.registerCaptureTools = registerCaptureTools;
 const path = __importStar(require("path"));
-const logger_1 = require("../../../services/logger");
+const logger_1 = require("../../../lib/logger");
 const playwright_1 = require("../playwright");
 const schemas_1 = require("./schemas");
 const helpers_1 = require("./helpers");
@@ -43,7 +43,8 @@ function registerCaptureTools(srv) {
     // capture_page
     srv.registerTool('capture_page', {
         title: 'Capture Page',
-        description: 'Navigate to a URL and capture a screenshot in one call. ' +
+        description: 'Navigate to a URL, capture a screenshot, and save it to persistent file storage in one call. ' +
+            'The returned `path` is the storage reference — no separate write_file call is needed. ' +
             'Optionally waits for a CSS selector or a fixed delay to ensure content is loaded. ' +
             'Pass page_id from a prior login_and_capture to reuse the authenticated session.',
         inputSchema: schemas_1.capturePageSchema,
@@ -102,6 +103,7 @@ function registerCaptureTools(srv) {
                             url: page.url(),
                             title: await page.title(),
                             ...screenshot,
+                            storage_ref: screenshot.path,
                             _handle: (0, playwright_1.buildHandle)(pageId),
                         }),
                     }],

package/build/system/mcp-servers/translation.d.ts

@@ -0,0 +1,14 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+/**
+ * Create the Translation MCP server.
+ *
+ * Returns a fresh McpServer instance each time. The MCP SDK only allows
+ * one transport per server, so each consumer needs its own instance.
+ */
+export declare function createTranslationServer(options?: {
+    name?: string;
+}): Promise<McpServer>;
+/**
+ * Stop a Translation MCP server instance.
+ */
+export declare function stopTranslationServer(): Promise<void>;