@hotmeshio/long-tail 0.1.4 → 0.1.6

package/build/system/mcp-servers/knowledge.js

@@ -0,0 +1,137 @@
+"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.createKnowledgeServer = createKnowledgeServer;
+const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
+const zod_1 = require("zod");
+const logger_1 = require("../../lib/logger");
+const knowledge = __importStar(require("../activities/knowledge"));
+const storeSchema = zod_1.z.object({
+    domain: zod_1.z.string().describe('Knowledge domain (namespace)'),
+    key: zod_1.z.string().describe('Unique key within domain'),
+    data: zod_1.z.record(zod_1.z.any()).describe('JSONB payload to store'),
+    tags: zod_1.z.array(zod_1.z.string()).optional().describe('Categorization tags'),
+});
+const getSchema = zod_1.z.object({
+    domain: zod_1.z.string().describe('Knowledge domain'),
+    key: zod_1.z.string().describe('Document key'),
+});
+const searchSchema = zod_1.z.object({
+    domain: zod_1.z.string().describe('Knowledge domain to search'),
+    query: zod_1.z.record(zod_1.z.any()).describe('JSONB containment query (e.g. {"type":"screenshot"})'),
+    tags: zod_1.z.array(zod_1.z.string()).optional().describe('Filter by tags (any match)'),
+    limit: zod_1.z.number().optional().describe('Max results (default 50, max 200)'),
+});
+const listSchema = zod_1.z.object({
+    domain: zod_1.z.string().describe('Knowledge domain'),
+    tags: zod_1.z.array(zod_1.z.string()).optional().describe('Filter by tags (any match)'),
+    limit: zod_1.z.number().optional().describe('Max results (default 50, max 200)'),
+    offset: zod_1.z.number().optional().describe('Pagination offset'),
+});
+const deleteSchema = zod_1.z.object({
+    domain: zod_1.z.string().describe('Knowledge domain'),
+    key: zod_1.z.string().describe('Document key to delete'),
+});
+const appendSchema = zod_1.z.object({
+    domain: zod_1.z.string().describe('Knowledge domain'),
+    key: zod_1.z.string().describe('Document key'),
+    path: zod_1.z.string().describe('JSONB path to array field (e.g. "screenshots" or "analysis.variations")'),
+    value: zod_1.z.any().refine((v) => v !== undefined, 'value is required').describe('Value to append to the array'),
+});
+function registerTools(server) {
+    server.registerTool('store_knowledge', {
+        title: 'Store Knowledge',
+        description: 'Store or update a knowledge entry. Upserts by domain+key: merges data and unions tags if the entry already exists.',
+        inputSchema: storeSchema,
+    }, async (args) => {
+        const result = await knowledge.storeKnowledge(args);
+        return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    });
+    server.registerTool('get_knowledge', {
+        title: 'Get Knowledge',
+        description: 'Retrieve a single knowledge entry by domain and key.',
+        inputSchema: getSchema,
+    }, async (args) => {
+        const result = await knowledge.getKnowledge(args);
+        return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    });
+    server.registerTool('search_knowledge', {
+        title: 'Search Knowledge',
+        description: 'Search knowledge entries using JSONB containment queries. The query object matches entries whose data contains the specified key-value pairs.',
+        inputSchema: searchSchema,
+    }, async (args) => {
+        const result = await knowledge.searchKnowledge(args);
+        return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    });
+    server.registerTool('list_knowledge', {
+        title: 'List Knowledge',
+        description: 'List knowledge entries in a domain, optionally filtered by tags. Returns most recently updated first.',
+        inputSchema: listSchema,
+    }, async (args) => {
+        const result = await knowledge.listKnowledge(args);
+        return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    });
+    server.registerTool('delete_knowledge', {
+        title: 'Delete Knowledge',
+        description: 'Delete a knowledge entry by domain and key.',
+        inputSchema: deleteSchema,
+    }, async (args) => {
+        const result = await knowledge.deleteKnowledge(args);
+        return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    });
+    server.registerTool('list_domains', {
+        title: 'List Knowledge Domains',
+        description: 'List all knowledge domains with entry counts and last-updated timestamps.',
+        inputSchema: zod_1.z.object({}),
+    }, async () => {
+        const result = await knowledge.listDomains();
+        return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    });
+    server.registerTool('append_knowledge', {
+        title: 'Append to Knowledge',
+        description: 'Append a value to an array field within a knowledge entry. Creates the entry and array if they do not exist.',
+        inputSchema: appendSchema,
+    }, async (args) => {
+        const result = await knowledge.appendKnowledge(args);
+        return { content: [{ type: 'text', text: JSON.stringify(result) }] };
+    });
+}
+async function createKnowledgeServer(options) {
+    const name = options?.name || 'long-tail-knowledge';
+    const instance = new mcp_js_1.McpServer({ name, version: '1.0.0' });
+    registerTools(instance);
+    logger_1.loggerRegistry.info(`[lt-mcp:knowledge] ${name} ready`);
+    return instance;
+}

package/build/system/mcp-servers/oauth.js

@@ -36,7 +36,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.createOAuthServer = createOAuthServer;
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const zod_1 = require("zod");
-const logger_1 = require("../../services/logger");
+const logger_1 = require("../../lib/logger");
 const oauth = __importStar(require("../activities/oauth"));
 const getAccessTokenSchema = zod_1.z.object({
     provider: zod_1.z.string().describe('OAuth provider name (google, github, microsoft, anthropic, etc.)'),

package/build/system/mcp-servers/playwright/browser-lifecycle.js

@@ -7,7 +7,7 @@ exports.resolvePage = resolvePage;
 exports.buildHandle = buildHandle;
 exports.stopPlaywrightServer = stopPlaywrightServer;
 const playwright_1 = require("playwright");
-const logger_1 = require("../../../services/logger");
+const logger_1 = require("../../../lib/logger");
 const types_1 = require("./types");
 // ── Browser lifecycle ────────────────────────────────────────────────────────
 // Shared browser instance across tool calls within a single server lifetime.

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,30 +68,33 @@ 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;
     page_id?: string | undefined;
     _handle?: {
         type: "playwright_page";
         page_id: string;
         cdp_endpoint?: string | undefined;
     } | undefined;
+    url?: string | undefined;
     selector?: string | undefined;
     wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
     full_page?: boolean | undefined;
+    describe?: boolean | undefined;
 }, {
     path: string;
-    url?: string | undefined;
     page_id?: string | undefined;
     _handle?: {
         type: "playwright_page";
         page_id: string;
         cdp_endpoint?: string | undefined;
     } | undefined;
+    url?: string | undefined;
     selector?: string | undefined;
     wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
     full_page?: boolean | undefined;
+    describe?: boolean | undefined;
 }>;
 export declare const clickSchema: z.ZodObject<{
     _handle: z.ZodOptional<z.ZodObject<{
@@ -181,22 +184,22 @@ export declare const waitForSchema: z.ZodObject<{
     timeout: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     selector: string;
-    timeout?: number | undefined;
     page_id?: string | undefined;
     _handle?: {
         type: "playwright_page";
         page_id: string;
         cdp_endpoint?: string | undefined;
     } | undefined;
+    timeout?: number | undefined;
 }, {
     selector: string;
-    timeout?: number | undefined;
     page_id?: string | undefined;
     _handle?: {
         type: "playwright_page";
         page_id: string;
         cdp_endpoint?: string | undefined;
     } | undefined;
+    timeout?: number | undefined;
 }>;
 export declare const evaluateSchema: z.ZodObject<{
     _handle: z.ZodOptional<z.ZodObject<{
@@ -273,16 +276,18 @@ 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;
     not?: boolean | undefined;
     url?: string | undefined;
     path?: string | undefined;
-    timeout?: number | undefined;
     selector?: string | undefined;
     wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
+    timeout?: number | undefined;
     full_page?: boolean | undefined;
+    describe?: boolean | undefined;
     script?: string | undefined;
 }, {
     action: "fill" | "navigate" | "screenshot" | "click" | "wait_for" | "wait_for_url" | "wait" | "evaluate";
@@ -290,10 +295,11 @@ export declare const runScriptStepSchema: z.ZodObject<{
     not?: boolean | undefined;
     url?: string | undefined;
     path?: string | undefined;
-    timeout?: number | undefined;
     selector?: string | undefined;
     wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
+    timeout?: number | undefined;
     full_page?: boolean | undefined;
+    describe?: boolean | undefined;
     script?: string | undefined;
 }>;
 export declare const runScriptSchema: z.ZodObject<{
@@ -321,16 +327,18 @@ 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;
         not?: boolean | undefined;
         url?: string | undefined;
         path?: string | undefined;
-        timeout?: number | undefined;
         selector?: string | undefined;
         wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
+        timeout?: number | undefined;
         full_page?: boolean | undefined;
+        describe?: boolean | undefined;
         script?: string | undefined;
     }, {
         action: "fill" | "navigate" | "screenshot" | "click" | "wait_for" | "wait_for_url" | "wait" | "evaluate";
@@ -338,10 +346,11 @@ export declare const runScriptSchema: z.ZodObject<{
         not?: boolean | undefined;
         url?: string | undefined;
         path?: string | undefined;
-        timeout?: number | undefined;
         selector?: string | undefined;
         wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
+        timeout?: number | undefined;
         full_page?: boolean | undefined;
+        describe?: boolean | undefined;
         script?: string | undefined;
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
@@ -351,10 +360,11 @@ export declare const runScriptSchema: z.ZodObject<{
         not?: boolean | undefined;
         url?: string | undefined;
         path?: string | undefined;
-        timeout?: number | undefined;
         selector?: string | undefined;
         wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
+        timeout?: number | undefined;
         full_page?: boolean | undefined;
+        describe?: boolean | undefined;
         script?: string | undefined;
     }[];
     _handle?: {
@@ -369,10 +379,11 @@ export declare const runScriptSchema: z.ZodObject<{
         not?: boolean | undefined;
         url?: string | undefined;
         path?: string | undefined;
-        timeout?: number | undefined;
         selector?: string | undefined;
         wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
+        timeout?: number | undefined;
         full_page?: boolean | 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

@@ -17,8 +17,8 @@ export declare const loginAndCaptureSchema: z.ZodObject<{
     submit_selector: string;
     username_selector: string;
     password_selector: string;
-    timeout?: number | undefined;
     screenshot_path?: string | undefined;
+    timeout?: number | undefined;
     full_page?: boolean | undefined;
     wait_after_login?: string | undefined;
 }, {
@@ -28,8 +28,8 @@ export declare const loginAndCaptureSchema: z.ZodObject<{
     submit_selector: string;
     username_selector: string;
     password_selector: string;
-    timeout?: number | undefined;
     screenshot_path?: string | undefined;
+    timeout?: number | undefined;
     full_page?: boolean | undefined;
     wait_after_login?: string | undefined;
 }>;
@@ -44,19 +44,19 @@ export declare const capturePageSchema: z.ZodObject<{
     timeout: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     url: string;
-    timeout?: number | undefined;
     page_id?: string | undefined;
     screenshot_path?: string | undefined;
     wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
+    timeout?: number | undefined;
     wait_ms?: number | undefined;
     full_page?: boolean | undefined;
     wait_for_selector?: string | undefined;
 }, {
     url: string;
-    timeout?: number | undefined;
     page_id?: string | undefined;
     screenshot_path?: string | undefined;
     wait_until?: "load" | "domcontentloaded" | "networkidle" | undefined;
+    timeout?: number | undefined;
     wait_ms?: number | undefined;
     full_page?: boolean | undefined;
     wait_for_selector?: string | undefined;
@@ -157,20 +157,20 @@ export declare const extractContentSchema: z.ZodObject<{
     wait_ms: z.ZodOptional<z.ZodNumber>;
     timeout: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
-    url?: string | undefined;
-    timeout?: number | undefined;
     page_id?: string | undefined;
+    url?: string | undefined;
     selector?: string | undefined;
+    timeout?: number | 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;
+    url?: string | undefined;
     selector?: string | undefined;
+    timeout?: number | undefined;
     wait_ms?: number | undefined;
     extract_links?: boolean | undefined;
     extract_metadata?: boolean | undefined;
@@ -201,8 +201,8 @@ export declare const submitFormSchema: z.ZodObject<{
         value: string;
         selector: string;
     }[];
-    timeout?: number | undefined;
     screenshot_path?: string | undefined;
+    timeout?: number | undefined;
     full_page?: boolean | undefined;
     wait_after_submit?: string | undefined;
 }, {
@@ -212,8 +212,8 @@ export declare const submitFormSchema: z.ZodObject<{
         value: string;
         selector: string;
     }[];
-    timeout?: number | undefined;
     screenshot_path?: string | undefined;
+    timeout?: number | undefined;
     full_page?: boolean | 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");