devharness 0.8.0

package/build/tools/console-tools.d.ts

@@ -0,0 +1,84 @@
+/**
+ * Console Monitoring Tools
+ */
+import { z } from 'zod';
+import { PuppeteerManager } from '../puppeteer-manager.js';
+import { ConsoleMonitor } from '../console-monitor.js';
+export declare function createConsoleTools(puppeteerManager: PuppeteerManager, consoleMonitor: ConsoleMonitor, resolveConnectionFromReason: (connectionReason: string) => Promise<any>): {
+    console: {
+        description: string;
+        zodSchema: z.ZodObject<{
+            action: z.ZodEnum<["list", "get", "recent", "search", "clear", "setObjectDepth"]>;
+            connectionReason: z.ZodString;
+            type: z.ZodOptional<z.ZodString>;
+            limit: z.ZodOptional<z.ZodNumber>;
+            offset: z.ZodOptional<z.ZodNumber>;
+            id: z.ZodOptional<z.ZodString>;
+            full: z.ZodOptional<z.ZodBoolean>;
+            textOffset: z.ZodOptional<z.ZodNumber>;
+            textLimit: z.ZodOptional<z.ZodNumber>;
+            argsIndex: z.ZodOptional<z.ZodNumber>;
+            pattern: z.ZodOptional<z.ZodString>;
+            flags: z.ZodOptional<z.ZodString>;
+            count: z.ZodOptional<z.ZodNumber>;
+            reason: z.ZodOptional<z.ZodString>;
+            depth: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            action: "clear" | "search" | "list" | "get" | "recent" | "setObjectDepth";
+            connectionReason: string;
+            count?: number | undefined;
+            type?: string | undefined;
+            full?: boolean | undefined;
+            id?: string | undefined;
+            reason?: string | undefined;
+            pattern?: string | undefined;
+            limit?: number | undefined;
+            offset?: number | undefined;
+            textOffset?: number | undefined;
+            textLimit?: number | undefined;
+            argsIndex?: number | undefined;
+            flags?: string | undefined;
+            depth?: number | undefined;
+        }, {
+            action: "clear" | "search" | "list" | "get" | "recent" | "setObjectDepth";
+            connectionReason: string;
+            count?: number | undefined;
+            type?: string | undefined;
+            full?: boolean | undefined;
+            id?: string | undefined;
+            reason?: string | undefined;
+            pattern?: string | undefined;
+            limit?: number | undefined;
+            offset?: number | undefined;
+            textOffset?: number | undefined;
+            textLimit?: number | undefined;
+            argsIndex?: number | undefined;
+            flags?: string | undefined;
+            depth?: number | undefined;
+        }>;
+        inputSchema: import("zod-to-json-schema").JsonSchema7Type & {
+            $schema?: string | undefined;
+            definitions?: {
+                [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+            } | undefined;
+        };
+        handler: (args: {
+            action: "clear" | "search" | "list" | "get" | "recent" | "setObjectDepth";
+            connectionReason: string;
+            count?: number | undefined;
+            type?: string | undefined;
+            full?: boolean | undefined;
+            id?: string | undefined;
+            reason?: string | undefined;
+            pattern?: string | undefined;
+            limit?: number | undefined;
+            offset?: number | undefined;
+            textOffset?: number | undefined;
+            textLimit?: number | undefined;
+            argsIndex?: number | undefined;
+            flags?: string | undefined;
+            depth?: number | undefined;
+        }, abortSignal?: AbortSignal) => Promise<any>;
+    };
+};
+//# sourceMappingURL=console-tools.d.ts.map

package/build/tools/console-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"console-tools.d.ts","sourceRoot":"","sources":["../../src/tools/console-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAwB,MAAM,uBAAuB,CAAC;AA8Q7E,wBAAgB,kBAAkB,CAChC,gBAAgB,EAAE,gBAAgB,EAClC,cAAc,EAAE,cAAc,EAC9B,2BAA2B,EAAE,CAAC,gBAAgB,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmCxE"}

package/build/tools/console-tools.js

@@ -0,0 +1,241 @@
+/**
+ * Console Monitoring Tools
+ */
+import { z } from 'zod';
+import { createTool } from '../validation-helpers.js';
+import { createSuccessResponse, createErrorResponse } from '../messages.js';
+import { DEFAULT_SUMMARY_TOKEN_BUDGET, estimateTokens, createMessagePreview, createMessageSummary, formatPreviewsWithStats, buildListResponseText, generateSummaryHints, extractTextPortion, extractArgByIndex, formatSummaryAsToon, formatMessageDetailAsToon, } from '../formatters/console-formatter.js';
+// =============================================================================
+// Schema
+// =============================================================================
+const consoleSchema = z.object({
+    action: z.enum(['list', 'get', 'recent', 'search', 'clear', 'setObjectDepth'])
+        .describe('Console action: list, get, recent, search, clear, setObjectDepth'),
+    connectionReason: z.string()
+        .describe('Connection reference (e.g., "unnamed-connection-default" or your renamed tab)'),
+    // Shared filters
+    type: z.string().optional()
+        .describe('Message type filter (log, error, warn, etc.)'),
+    limit: z.number().optional()
+        .describe('Max messages to return (default: 100 for list, 50 for search/recent)'),
+    // list-specific
+    offset: z.number().optional()
+        .describe('Messages to skip (for list action, default: 0)'),
+    // get-specific
+    id: z.string().optional()
+        .describe('Message ID (required for get)'),
+    full: z.boolean().optional()
+        .describe('Return full message without smart truncation (default: false)'),
+    textOffset: z.number().optional()
+        .describe('Character offset for text extraction'),
+    textLimit: z.number().optional()
+        .describe('Max characters to return from text'),
+    argsIndex: z.number().optional()
+        .describe('Specific args array index to return'),
+    // search-specific
+    pattern: z.string().optional()
+        .describe('Regex pattern (required for search)'),
+    flags: z.string().optional()
+        .describe('Regex flags (default: "")'),
+    // recent-specific
+    count: z.number().optional()
+        .describe('Number of recent messages (default: 50)'),
+    // clear-specific
+    reason: z.string().optional()
+        .describe('Why console needs clearing (required for clear)'),
+    // setObjectDepth-specific
+    depth: z.number().optional()
+        .describe('Object expansion depth 1-10 (default: 2)'),
+}).strict();
+// =============================================================================
+// Validation
+// =============================================================================
+const REQUIRED_PARAMS = {
+    get: { param: 'id', message: 'The "get" action requires an "id" parameter' },
+    search: { param: 'pattern', message: 'The "search" action requires a "pattern" parameter' },
+    clear: { param: 'reason', message: 'The "clear" action requires a "reason" parameter' },
+    setObjectDepth: { param: 'depth', message: 'The "setObjectDepth" action requires a "depth" parameter (1-10)' },
+};
+function validateRequiredParams(args) {
+    const requirement = REQUIRED_PARAMS[args.action];
+    if (requirement && args[requirement.param] === undefined) {
+        return createErrorResponse('MISSING_PARAMETER', {
+            action: args.action,
+            missing: requirement.param,
+            message: requirement.message,
+        });
+    }
+    return null;
+}
+// =============================================================================
+// Helpers
+// =============================================================================
+function ensureMonitoring(monitor, manager) {
+    if (!monitor.isActive() && manager.isConnected()) {
+        monitor.startMonitoring(manager.getPage());
+    }
+}
+function buildListResponse(messages, headerText, action, monitor) {
+    const previews = messages.map(createMessagePreview);
+    const { csv, truncatedCount, totalTokens } = formatPreviewsWithStats(previews);
+    return {
+        content: [{ type: 'text', text: buildListResponseText(headerText, csv, truncatedCount, totalTokens) }],
+        _meta: {
+            tool: 'console',
+            action,
+            timestamp: Date.now(),
+            console: {
+                totalCount: monitor.getCount(),
+                matchCount: messages.length,
+                errorCount: monitor.getCount('error'),
+                warnCount: monitor.getCount('warn'),
+                truncatedCount,
+                totalTokens,
+            },
+        },
+    };
+}
+// =============================================================================
+// Action Handlers
+// =============================================================================
+function handleList(monitor, manager, args) {
+    ensureMonitoring(monitor, manager);
+    const messages = monitor.getMessages({
+        type: args.type,
+        limit: args.limit ?? 100,
+        offset: args.offset ?? 0,
+    });
+    const totalCount = monitor.getCount(args.type);
+    const typeInfo = args.type ? ` (type: ${args.type})` : '';
+    const header = `Console Messages: ${messages.length} of ${totalCount}${typeInfo}`;
+    return buildListResponse(messages, header, 'list', monitor);
+}
+function handleRecent(monitor, manager, args) {
+    ensureMonitoring(monitor, manager);
+    const requestedCount = args.count ?? 50;
+    const messages = monitor.getRecentMessages(requestedCount, args.type);
+    const totalCount = monitor.getCount(args.type);
+    const typeInfo = args.type ? ` (type: ${args.type})` : '';
+    const header = `Recent Console Messages: ${messages.length} of ${requestedCount} requested (${totalCount} total)${typeInfo}`;
+    return buildListResponse(messages, header, 'recent', monitor);
+}
+function handleSearch(monitor, manager, args) {
+    ensureMonitoring(monitor, manager);
+    let regex;
+    try {
+        regex = new RegExp(args.pattern, args.flags ?? '');
+    }
+    catch (error) {
+        return createErrorResponse('INVALID_PATTERN', { message: `Invalid regex: ${error}` });
+    }
+    const allMessages = monitor.getMessages({ type: args.type });
+    const matches = allMessages
+        .filter((msg) => regex.test(msg.text))
+        .slice(0, args.limit ?? 50);
+    const typeInfo = args.type ? ` (type: ${args.type})` : '';
+    const header = `Console Search: ${matches.length} matches for /${args.pattern}/${args.flags ?? ''} (searched ${allMessages.length})${typeInfo}`;
+    return buildListResponse(matches, header, 'search', monitor);
+}
+function handleGet(monitor, args) {
+    const message = monitor.getMessage(args.id);
+    if (!message) {
+        return createErrorResponse('NOT_FOUND', {
+            message: `Console message ${args.id} not found. Use action "list" to see available messages.`,
+        });
+    }
+    const hasExtractionParams = args.textOffset !== undefined || args.textLimit !== undefined || args.argsIndex !== undefined;
+    const wantsFull = args.full === true;
+    const fullTokens = estimateTokens({ text: message.text, args: message.args, stackTrace: message.stackTrace });
+    // Smart summary mode: large message without explicit extraction or full flag
+    if (!hasExtractionParams && !wantsFull && fullTokens > DEFAULT_SUMMARY_TOKEN_BUDGET) {
+        const summary = createMessageSummary(message, DEFAULT_SUMMARY_TOKEN_BUDGET);
+        const hints = generateSummaryHints(summary);
+        const toon = formatSummaryAsToon(summary);
+        return {
+            content: [{
+                    type: 'text',
+                    text: `Console [${message.id}] ${message.type} - ${summary._tokens.returned}/${summary._tokens.full} tokens${hints}\n\n\`\`\`toon\n${toon}\n\`\`\``,
+                }],
+        };
+    }
+    // Full/extraction mode
+    const textResult = extractTextPortion(message.text, args.textOffset, args.textLimit);
+    let argsData = message.args;
+    let argsExtraction;
+    if (args.argsIndex !== undefined) {
+        const argResult = extractArgByIndex(message.args, args.argsIndex);
+        if ('error' in argResult) {
+            return createErrorResponse('INVALID_PARAMETER', { message: argResult.error });
+        }
+        argsData = argResult.args;
+        argsExtraction = argResult.extraction;
+    }
+    const data = {
+        id: message.id,
+        type: message.type,
+        text: textResult.text,
+        args: argsData,
+        location: message.location,
+        stackTrace: message.stackTrace,
+        timestamp: message.timestamp,
+        _tokens: { full: fullTokens, returned: estimateTokens({ text: textResult.text, args: argsData }) },
+        _textExtraction: textResult.extraction,
+        _argsExtraction: argsExtraction,
+    };
+    const toon = formatMessageDetailAsToon(data);
+    return {
+        content: [{
+                type: 'text',
+                text: `Console [${message.id}] ${message.type} - ${data._tokens.returned}/${data._tokens.full} tokens\n\n\`\`\`toon\n${toon}\n\`\`\``,
+            }],
+    };
+}
+function handleClear(monitor, connectionReason, reason) {
+    console.error(`[cdp-tools] clearConsole - Reason: ${reason}, Connection: ${connectionReason}`);
+    const count = monitor.getCount();
+    monitor.clear();
+    return createSuccessResponse('CONSOLE_CLEARED', { count });
+}
+function handleSetObjectDepth(monitor, depth) {
+    const oldDepth = monitor.getConsoleObjectDepth();
+    monitor.setConsoleObjectDepth(depth);
+    return {
+        content: [{
+                type: 'text',
+                text: `Console object depth: ${oldDepth} → ${monitor.getConsoleObjectDepth()}`,
+            }],
+    };
+}
+// =============================================================================
+// Tool Export
+// =============================================================================
+export function createConsoleTools(puppeteerManager, consoleMonitor, resolveConnectionFromReason) {
+    return {
+        console: createTool('Monitor and manage console messages. Actions: list, get, recent, search, clear, setObjectDepth', consoleSchema, async (args) => {
+            // Validate required params
+            const validationError = validateRequiredParams(args);
+            if (validationError)
+                return validationError;
+            // Resolve connection
+            const resolved = await resolveConnectionFromReason(args.connectionReason);
+            if (!resolved) {
+                return createErrorResponse('CONNECTION_NOT_FOUND', {
+                    message: 'No Chrome browser available. Use `launchChrome` first.',
+                });
+            }
+            const monitor = resolved.consoleMonitor || consoleMonitor;
+            const manager = resolved.puppeteerManager || puppeteerManager;
+            // Dispatch
+            switch (args.action) {
+                case 'list': return handleList(monitor, manager, args);
+                case 'recent': return handleRecent(monitor, manager, args);
+                case 'search': return handleSearch(monitor, manager, args);
+                case 'get': return handleGet(monitor, args);
+                case 'clear': return handleClear(monitor, args.connectionReason, args.reason);
+                case 'setObjectDepth': return handleSetObjectDepth(monitor, args.depth);
+                default: return createErrorResponse('INVALID_ACTION', { action: args.action });
+            }
+        }),
+    };
+}
+//# sourceMappingURL=console-tools.js.map

package/build/tools/console-tools.js.map

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

package/build/tools/content-tools.d.ts

@@ -0,0 +1,74 @@
+/**
+ * Content Extraction Tools
+ */
+import { z } from 'zod';
+import type { CDPManager } from '../cdp-manager.js';
+import { PuppeteerManager } from '../puppeteer-manager.js';
+import type { ConnectionManager } from '../connection-manager.js';
+import type { ClickableCache } from '../clickable-cache.js';
+export declare function createContentTools(puppeteerManager: PuppeteerManager, cdpManager: CDPManager, connectionManager: ConnectionManager, resolveConnectionFromReason: (connectionReason: string) => Promise<any>, clickableCache: ClickableCache): {
+    content: {
+        description: string;
+        zodSchema: z.ZodObject<{
+            action: z.ZodEnum<["extractText", "findInteractive", "verify", "parse"]>;
+            connectionReason: z.ZodString;
+            mode: z.ZodOptional<z.ZodEnum<["outline", "full", "section"]>>;
+            section: z.ZodOptional<z.ZodString>;
+            save: z.ZodOptional<z.ZodBoolean>;
+            types: z.ZodOptional<z.ZodArray<z.ZodEnum<["link", "button", "text", "email", "password", "number", "tel", "url", "search", "textarea", "select", "checkbox", "radio", "file", "date", "other"]>, "many">>;
+            showHidden: z.ZodOptional<z.ZodBoolean>;
+            search: z.ZodOptional<z.ZodString>;
+            limit: z.ZodOptional<z.ZodNumber>;
+            checks: z.ZodOptional<z.ZodArray<z.ZodEnum<["handlers", "viewport", "touch", "overflow", "clickability", "links", "scroll"]>, "many">>;
+            name: z.ZodOptional<z.ZodString>;
+            waitMs: z.ZodOptional<z.ZodNumber>;
+        }, "strict", z.ZodTypeAny, {
+            action: "findInteractive" | "extractText" | "verify" | "parse";
+            connectionReason: string;
+            search?: string | undefined;
+            name?: string | undefined;
+            limit?: number | undefined;
+            section?: string | undefined;
+            mode?: "full" | "outline" | "section" | undefined;
+            save?: boolean | undefined;
+            types?: ("number" | "search" | "link" | "url" | "date" | "file" | "other" | "text" | "button" | "email" | "password" | "tel" | "textarea" | "select" | "checkbox" | "radio")[] | undefined;
+            showHidden?: boolean | undefined;
+            checks?: ("viewport" | "scroll" | "touch" | "handlers" | "overflow" | "clickability" | "links")[] | undefined;
+            waitMs?: number | undefined;
+        }, {
+            action: "findInteractive" | "extractText" | "verify" | "parse";
+            connectionReason: string;
+            search?: string | undefined;
+            name?: string | undefined;
+            limit?: number | undefined;
+            section?: string | undefined;
+            mode?: "full" | "outline" | "section" | undefined;
+            save?: boolean | undefined;
+            types?: ("number" | "search" | "link" | "url" | "date" | "file" | "other" | "text" | "button" | "email" | "password" | "tel" | "textarea" | "select" | "checkbox" | "radio")[] | undefined;
+            showHidden?: boolean | undefined;
+            checks?: ("viewport" | "scroll" | "touch" | "handlers" | "overflow" | "clickability" | "links")[] | undefined;
+            waitMs?: number | undefined;
+        }>;
+        inputSchema: import("zod-to-json-schema").JsonSchema7Type & {
+            $schema?: string | undefined;
+            definitions?: {
+                [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+            } | undefined;
+        };
+        handler: (args: {
+            action: "findInteractive" | "extractText" | "verify" | "parse";
+            connectionReason: string;
+            search?: string | undefined;
+            name?: string | undefined;
+            limit?: number | undefined;
+            section?: string | undefined;
+            mode?: "full" | "outline" | "section" | undefined;
+            save?: boolean | undefined;
+            types?: ("number" | "search" | "link" | "url" | "date" | "file" | "other" | "text" | "button" | "email" | "password" | "tel" | "textarea" | "select" | "checkbox" | "radio")[] | undefined;
+            showHidden?: boolean | undefined;
+            checks?: ("viewport" | "scroll" | "touch" | "handlers" | "overflow" | "clickability" | "links")[] | undefined;
+            waitMs?: number | undefined;
+        }, abortSignal?: AbortSignal) => Promise<any>;
+    };
+};
+//# sourceMappingURL=content-tools.d.ts.map

package/build/tools/content-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-tools.d.ts","sourceRoot":"","sources":["../../src/tools/content-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAOlE,OAAO,KAAK,EAAE,cAAc,EAAoB,MAAM,uBAAuB,CAAC;AAsC9E,wBAAgB,kBAAkB,CAAC,gBAAgB,EAAE,gBAAgB,EAAE,UAAU,EAAE,UAAU,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,2BAA2B,EAAE,CAAC,gBAAgB,EAAE,MAAM,KAAK,OAAO,CAAC,GAAG,CAAC,EAAE,cAAc,EAAE,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAinB3O"}