devharness 0.8.0

package/build/utils/port-check.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=port-check.test.d.ts.map

package/build/utils/port-check.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"port-check.test.d.ts","sourceRoot":"","sources":["../../src/utils/port-check.test.ts"],"names":[],"mappings":""}

package/build/utils/port-check.test.js

@@ -0,0 +1,66 @@
+import { describe, it, expect } from 'vitest';
+import { checkPort, parseUrlForPortCheck, checkUrlPort } from './port-check.js';
+describe('port-check', () => {
+    describe('parseUrlForPortCheck', () => {
+        it('should parse localhost URL with explicit port', () => {
+            const result = parseUrlForPortCheck('http://localhost:3000');
+            expect(result).toEqual({ host: 'localhost', port: 3000 });
+        });
+        it('should parse 127.0.0.1 URL with explicit port', () => {
+            const result = parseUrlForPortCheck('http://127.0.0.1:8080/path');
+            expect(result).toEqual({ host: '127.0.0.1', port: 8080 });
+        });
+        it('should use default port 80 for http', () => {
+            const result = parseUrlForPortCheck('http://localhost');
+            expect(result).toEqual({ host: 'localhost', port: 80 });
+        });
+        it('should use default port 443 for https', () => {
+            const result = parseUrlForPortCheck('https://example.com');
+            expect(result).toEqual({ host: 'example.com', port: 443 });
+        });
+        it('should return null for invalid URL', () => {
+            const result = parseUrlForPortCheck('not-a-url');
+            expect(result).toBeNull();
+        });
+        it('should return null for file:// URLs', () => {
+            const result = parseUrlForPortCheck('file:///path/to/file');
+            expect(result).toBeNull();
+        });
+    });
+    describe('checkPort', () => {
+        it('should return open: false for closed port', async () => {
+            // Port 59999 is very unlikely to be in use
+            const result = await checkPort(59999, 'localhost', 500);
+            expect(result.open).toBe(false);
+            expect(result.port).toBe(59999);
+            expect(result.host).toBe('localhost');
+            expect(result.error).toBeDefined();
+        });
+        it('should timeout for unreachable host', async () => {
+            // Use a short timeout and non-routable IP
+            const result = await checkPort(80, '10.255.255.1', 100);
+            expect(result.open).toBe(false);
+        });
+    });
+    describe('checkUrlPort', () => {
+        it('should return null for non-localhost URLs', async () => {
+            const result = await checkUrlPort('https://example.com');
+            expect(result).toBeNull();
+        });
+        it('should check localhost URLs', async () => {
+            const result = await checkUrlPort('http://localhost:59999', 500);
+            expect(result).not.toBeNull();
+            expect(result?.open).toBe(false);
+        });
+        it('should check 127.0.0.1 URLs', async () => {
+            const result = await checkUrlPort('http://127.0.0.1:59999', 500);
+            expect(result).not.toBeNull();
+            expect(result?.open).toBe(false);
+        });
+        it('should return null for invalid URL', async () => {
+            const result = await checkUrlPort('not-a-url');
+            expect(result).toBeNull();
+        });
+    });
+});
+//# sourceMappingURL=port-check.test.js.map

package/build/utils/port-check.test.js.map

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

package/build/utils/selector-resolver.d.ts

@@ -0,0 +1,66 @@
+/**
+ * Extended Selector Resolver
+ *
+ * Supports Playwright-style extended selectors that aren't native CSS:
+ * - :has-text("text") - matches elements containing text (case-insensitive partial match)
+ * - :text("text") - matches elements with exact text content
+ * - :text-is("text") - alias for :text()
+ *
+ * Text matching includes: textContent, aria-label, and title attributes.
+ *
+ * Examples:
+ *   button:has-text("Submit")      -> finds <button>Submit Form</button>
+ *   a:has-text("Login")            -> finds <a href="/login">Login</a>
+ *   a:has-text("Homepage")         -> finds <a aria-label="Homepage">...</a>
+ *   div:text("Exact Match")        -> finds <div>Exact Match</div> (exact only)
+ *   :has-text("Search")            -> finds any element containing "Search"
+ */
+export interface ResolvedSelector {
+    /** The resolved CSS selector that can be used with querySelector */
+    selector: string;
+    /** Number of elements that matched */
+    matchCount: number;
+    /** Warning message if multiple matches found */
+    warning?: string;
+}
+export interface SelectorError {
+    error: string;
+    originalSelector: string;
+    suggestion?: string;
+}
+/**
+ * Parse extended selector syntax and extract components
+ * (exported for the wait tool, which needs the raw base-selector + text-match
+ * pieces to build a self-contained polling predicate instead of marking
+ * elements with data attributes that would not survive a navigation)
+ */
+export declare function parseExtendedSelector(selector: string): {
+    baseSelector: string;
+    textMatch: {
+        type: 'has-text' | 'text' | 'text-is';
+        value: string;
+    } | null;
+} | {
+    error: string;
+};
+/**
+ * Check if a selector uses extended syntax
+ */
+export declare function isExtendedSelector(selector: string): boolean;
+/**
+ * Resolve an extended selector to a standard CSS selector
+ *
+ * For extended selectors, this finds matching elements and returns a
+ * data-attribute based selector that uniquely identifies the first match.
+ *
+ * @param page - Puppeteer page instance
+ * @param selector - The selector (may include extended syntax like :has-text())
+ * @returns Resolved selector info or error
+ */
+export declare function resolveSelector(page: any, selector: string): Promise<ResolvedSelector | SelectorError>;
+/**
+ * Clean up the temporary data attribute after use
+ * Should be called after the selector has been used
+ */
+export declare function cleanupResolvedSelector(page: any, selector: string): Promise<void>;
+//# sourceMappingURL=selector-resolver.d.ts.map

package/build/utils/selector-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector-resolver.d.ts","sourceRoot":"","sources":["../../src/utils/selector-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,MAAM,WAAW,gBAAgB;IAC/B,oEAAoE;IACpE,QAAQ,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,MAAM,GAAG;IACvD,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE;QAAE,IAAI,EAAE,UAAU,GAAG,MAAM,GAAG,SAAS,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC5E,GAAG;IAAE,KAAK,EAAE,MAAM,CAAA;CAAE,CAoEpB;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE5D;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,IAAI,EAAE,GAAG,EACT,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,gBAAgB,GAAG,aAAa,CAAC,CAuG3C;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAAC,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAWxF"}

package/build/utils/selector-resolver.js

@@ -0,0 +1,200 @@
+/**
+ * Extended Selector Resolver
+ *
+ * Supports Playwright-style extended selectors that aren't native CSS:
+ * - :has-text("text") - matches elements containing text (case-insensitive partial match)
+ * - :text("text") - matches elements with exact text content
+ * - :text-is("text") - alias for :text()
+ *
+ * Text matching includes: textContent, aria-label, and title attributes.
+ *
+ * Examples:
+ *   button:has-text("Submit")      -> finds <button>Submit Form</button>
+ *   a:has-text("Login")            -> finds <a href="/login">Login</a>
+ *   a:has-text("Homepage")         -> finds <a aria-label="Homepage">...</a>
+ *   div:text("Exact Match")        -> finds <div>Exact Match</div> (exact only)
+ *   :has-text("Search")            -> finds any element containing "Search"
+ */
+/**
+ * Parse extended selector syntax and extract components
+ * (exported for the wait tool, which needs the raw base-selector + text-match
+ * pieces to build a self-contained polling predicate instead of marking
+ * elements with data attributes that would not survive a navigation)
+ */
+export function parseExtendedSelector(selector) {
+    // Check if this looks like an extended selector
+    const extendedMatch = selector.match(/:(?:has-text|text|text-is)\(/);
+    if (!extendedMatch) {
+        return { baseSelector: selector, textMatch: null };
+    }
+    // Find the pseudo-class start position
+    const pseudoStart = extendedMatch.index;
+    const beforePart = selector.substring(0, pseudoStart);
+    // Extract the type (has-text, text, or text-is)
+    const typeMatch = selector.substring(pseudoStart).match(/^:(has-text|text|text-is)\(/);
+    if (!typeMatch) {
+        return { error: 'Invalid extended selector syntax' };
+    }
+    const matchType = typeMatch[1];
+    const afterTypeStart = pseudoStart + typeMatch[0].length;
+    // Parse the quoted string - handle both single and double quotes
+    const remaining = selector.substring(afterTypeStart);
+    const quoteChar = remaining[0];
+    if (quoteChar !== '"' && quoteChar !== "'") {
+        return { error: `Expected quote after :${matchType}(, got: ${quoteChar || 'end of string'}` };
+    }
+    // Find the closing quote, handling escaped quotes
+    let textValue = '';
+    let i = 1;
+    while (i < remaining.length) {
+        const char = remaining[i];
+        if (char === '\\' && i + 1 < remaining.length) {
+            // Escaped character - include the next char literally
+            textValue += remaining[i + 1];
+            i += 2;
+        }
+        else if (char === quoteChar) {
+            // Found closing quote
+            break;
+        }
+        else {
+            textValue += char;
+            i++;
+        }
+    }
+    if (i >= remaining.length || remaining[i] !== quoteChar) {
+        return { error: `Unterminated string in :${matchType}() selector` };
+    }
+    // Check for closing paren
+    if (remaining[i + 1] !== ')') {
+        return { error: `Expected ) after closing quote in :${matchType}() selector` };
+    }
+    // Get any remaining selector after the extended part
+    const afterPart = remaining.substring(i + 2);
+    // Combine before and after parts
+    let baseSelector = (beforePart + afterPart).trim();
+    if (!baseSelector) {
+        baseSelector = '*';
+    }
+    return {
+        baseSelector,
+        textMatch: { type: matchType, value: textValue },
+    };
+}
+/**
+ * Check if a selector uses extended syntax
+ */
+export function isExtendedSelector(selector) {
+    return /:(?:has-text|text|text-is)\(/.test(selector);
+}
+/**
+ * Resolve an extended selector to a standard CSS selector
+ *
+ * For extended selectors, this finds matching elements and returns a
+ * data-attribute based selector that uniquely identifies the first match.
+ *
+ * @param page - Puppeteer page instance
+ * @param selector - The selector (may include extended syntax like :has-text())
+ * @returns Resolved selector info or error
+ */
+export async function resolveSelector(page, selector) {
+    // Check if it's an extended selector
+    if (!isExtendedSelector(selector)) {
+        // Standard CSS selector - return as-is, let caller validate
+        return {
+            selector,
+            matchCount: 1,
+        };
+    }
+    const parsed = parseExtendedSelector(selector);
+    if ('error' in parsed) {
+        return {
+            error: parsed.error,
+            originalSelector: selector,
+            suggestion: 'Check the selector syntax. Format: element:has-text("text") or element:text("exact text")',
+        };
+    }
+    const { baseSelector, textMatch } = parsed;
+    if (!textMatch) {
+        // Shouldn't happen since we checked isExtendedSelector, but handle it
+        return { selector, matchCount: 1 };
+    }
+    // Find matching elements and mark the first one with a unique attribute
+    const result = await page.evaluate((base, matchType, matchText) => {
+        const elements = globalThis.document.querySelectorAll(base);
+        const matches = [];
+        let firstMatchElement = null;
+        elements.forEach((el) => {
+            const textContent = el.textContent?.trim() || '';
+            const ariaLabel = el.getAttribute('aria-label') || '';
+            const title = el.getAttribute('title') || '';
+            // Combine all text sources for matching
+            const allText = [textContent, ariaLabel, title].filter(Boolean).join(' ');
+            let isMatch = false;
+            if (matchType === 'has-text') {
+                isMatch = allText.toLowerCase().includes(matchText.toLowerCase());
+            }
+            else {
+                // 'text' or 'text-is' - exact match (check each source separately)
+                isMatch = textContent === matchText || ariaLabel === matchText || title === matchText;
+            }
+            if (isMatch) {
+                if (!firstMatchElement) {
+                    firstMatchElement = el;
+                }
+                const displayText = textContent || ariaLabel || title;
+                matches.push({
+                    text: displayText.substring(0, 60) + (displayText.length > 60 ? '...' : ''),
+                    tagName: el.tagName.toLowerCase(),
+                });
+            }
+        });
+        if (matches.length === 0) {
+            return { error: 'no_match' };
+        }
+        // Mark the first matching element with a unique data attribute
+        const uniqueId = `cdp-ext-${Date.now()}-${Math.random().toString(36).substring(2, 8)}`;
+        firstMatchElement.setAttribute('data-cdp-selector-match', uniqueId);
+        return {
+            uniqueId,
+            matchCount: matches.length,
+            matches: matches.slice(0, 5), // Return first 5 for context
+            tagName: matches[0].tagName,
+        };
+    }, baseSelector, textMatch.type, textMatch.value);
+    if ('error' in result && result.error === 'no_match') {
+        return {
+            error: `Element not found: \`${selector}\``,
+            originalSelector: selector,
+            suggestion: `No ${baseSelector === '*' ? 'element' : `\`${baseSelector}\``} contains text "${textMatch.value}". Use \`content({ action: 'findInteractive', search: '${textMatch.value}' })\` to see available elements.`,
+        };
+    }
+    // Build response
+    const resolvedSelector = `[data-cdp-selector-match="${result.uniqueId}"]`;
+    let warning;
+    if (result.matchCount > 1) {
+        const othersText = result.matches.slice(1).map((m) => `"${m.text}"`).join(', ');
+        warning = `Found ${result.matchCount} matches. Using first match. Other matches: ${othersText}${result.matchCount > 5 ? ` (and ${result.matchCount - 5} more)` : ''}`;
+    }
+    return {
+        selector: resolvedSelector,
+        matchCount: result.matchCount,
+        warning,
+    };
+}
+/**
+ * Clean up the temporary data attribute after use
+ * Should be called after the selector has been used
+ */
+export async function cleanupResolvedSelector(page, selector) {
+    if (!selector.startsWith('[data-cdp-selector-match=')) {
+        return;
+    }
+    await page.evaluate((sel) => {
+        const el = globalThis.document.querySelector(sel);
+        if (el) {
+            el.removeAttribute('data-cdp-selector-match');
+        }
+    }, selector);
+}
+//# sourceMappingURL=selector-resolver.js.map

package/build/utils/selector-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"selector-resolver.js","sourceRoot":"","sources":["../../src/utils/selector-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAiBH;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,QAAgB;IAIpD,gDAAgD;IAChD,MAAM,aAAa,GAAG,QAAQ,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACrE,IAAI,CAAC,aAAa,EAAE,CAAC;QACnB,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC;IACrD,CAAC;IAED,uCAAuC;IACvC,MAAM,WAAW,GAAG,aAAa,CAAC,KAAM,CAAC;IACzC,MAAM,UAAU,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;IAEtD,gDAAgD;IAChD,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;IACvF,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,EAAE,KAAK,EAAE,kCAAkC,EAAE,CAAC;IACvD,CAAC;IAED,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAoC,CAAC;IAClE,MAAM,cAAc,GAAG,WAAW,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAEzD,iEAAiE;IACjE,MAAM,SAAS,GAAG,QAAQ,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC;IACrD,MAAM,SAAS,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IAE/B,IAAI,SAAS,KAAK,GAAG,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;QAC3C,OAAO,EAAE,KAAK,EAAE,yBAAyB,SAAS,WAAW,SAAS,IAAI,eAAe,EAAE,EAAE,CAAC;IAChG,CAAC;IAED,kDAAkD;IAClD,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,IAAI,CAAC,GAAG,CAAC,CAAC;IACV,OAAO,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,IAAI,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC;YAC9C,sDAAsD;YACtD,SAAS,IAAI,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;YAC9B,CAAC,IAAI,CAAC,CAAC;QACT,CAAC;aAAM,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9B,sBAAsB;YACtB,MAAM;QACR,CAAC;aAAM,CAAC;YACN,SAAS,IAAI,IAAI,CAAC;YAClB,CAAC,EAAE,CAAC;QACN,CAAC;IACH,CAAC;IAED,IAAI,CAAC,IAAI,SAAS,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QACxD,OAAO,EAAE,KAAK,EAAE,2BAA2B,SAAS,aAAa,EAAE,CAAC;IACtE,CAAC;IAED,0BAA0B;IAC1B,IAAI,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;QAC7B,OAAO,EAAE,KAAK,EAAE,sCAAsC,SAAS,aAAa,EAAE,CAAC;IACjF,CAAC;IAED,qDAAqD;IACrD,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAE7C,iCAAiC;IACjC,IAAI,YAAY,GAAG,CAAC,UAAU,GAAG,SAAS,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,IAAI,CAAC,YAAY,EAAE,CAAC;QAClB,YAAY,GAAG,GAAG,CAAC;IACrB,CAAC;IAED,OAAO;QACL,YAAY;QACZ,SAAS,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;KACjD,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,QAAgB;IACjD,OAAO,8BAA8B,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACvD,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAS,EACT,QAAgB;IAEhB,qCAAqC;IACrC,IAAI,CAAC,kBAAkB,CAAC,QAAQ,CAAC,EAAE,CAAC;QAClC,4DAA4D;QAC5D,OAAO;YACL,QAAQ;YACR,UAAU,EAAE,CAAC;SACd,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,qBAAqB,CAAC,QAAQ,CAAC,CAAC;IAE/C,IAAI,OAAO,IAAI,MAAM,EAAE,CAAC;QACtB,OAAO;YACL,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,gBAAgB,EAAE,QAAQ;YAC1B,UAAU,EAAE,2FAA2F;SACxG,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,GAAG,MAAM,CAAC;IAE3C,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,sEAAsE;QACtE,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;IACrC,CAAC;IAED,wEAAwE;IACxE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAChC,CAAC,IAAY,EAAE,SAAiB,EAAE,SAAiB,EAAE,EAAE;QACrD,MAAM,QAAQ,GAAI,UAAkB,CAAC,QAAQ,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACrE,MAAM,OAAO,GAA6C,EAAE,CAAC;QAC7D,IAAI,iBAAiB,GAAQ,IAAI,CAAC;QAElC,QAAQ,CAAC,OAAO,CAAC,CAAC,EAAO,EAAE,EAAE;YAC3B,MAAM,WAAW,GAAG,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YACjD,MAAM,SAAS,GAAG,EAAE,CAAC,YAAY,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC;YACtD,MAAM,KAAK,GAAG,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAC7C,wCAAwC;YACxC,MAAM,OAAO,GAAG,CAAC,WAAW,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAC1E,IAAI,OAAO,GAAG,KAAK,CAAC;YAEpB,IAAI,SAAS,KAAK,UAAU,EAAE,CAAC;gBAC7B,OAAO,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,WAAW,EAAE,CAAC,CAAC;YACpE,CAAC;iBAAM,CAAC;gBACN,mEAAmE;gBACnE,OAAO,GAAG,WAAW,KAAK,SAAS,IAAI,SAAS,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,CAAC;YACxF,CAAC;YAED,IAAI,OAAO,EAAE,CAAC;gBACZ,IAAI,CAAC,iBAAiB,EAAE,CAAC;oBACvB,iBAAiB,GAAG,EAAE,CAAC;gBACzB,CAAC;gBACD,MAAM,WAAW,GAAG,WAAW,IAAI,SAAS,IAAI,KAAK,CAAC;gBACtD,OAAO,CAAC,IAAI,CAAC;oBACX,IAAI,EAAE,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,WAAW,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC3E,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE;iBAClC,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACzB,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;QAC/B,CAAC;QAED,+DAA+D;QAC/D,MAAM,QAAQ,GAAG,WAAW,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;QACvF,iBAAkB,CAAC,YAAY,CAAC,yBAAyB,EAAE,QAAQ,CAAC,CAAC;QAErE,OAAO;YACL,QAAQ;YACR,UAAU,EAAE,OAAO,CAAC,MAAM;YAC1B,OAAO,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,6BAA6B;YAC3D,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO;SAC5B,CAAC;IACJ,CAAC,EACD,YAAY,EACZ,SAAS,CAAC,IAAI,EACd,SAAS,CAAC,KAAK,CAChB,CAAC;IAEF,IAAI,OAAO,IAAI,MAAM,IAAI,MAAM,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;QACrD,OAAO;YACL,KAAK,EAAE,wBAAwB,QAAQ,IAAI;YAC3C,gBAAgB,EAAE,QAAQ;YAC1B,UAAU,EAAE,MAAM,YAAY,KAAK,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,YAAY,IAAI,mBAAmB,SAAS,CAAC,KAAK,0DAA0D,SAAS,CAAC,KAAK,mCAAmC;SACzN,CAAC;IACJ,CAAC;IAED,iBAAiB;IACjB,MAAM,gBAAgB,GAAG,6BAA6B,MAAM,CAAC,QAAQ,IAAI,CAAC;IAE1E,IAAI,OAA2B,CAAC;IAChC,IAAI,MAAM,CAAC,UAAU,GAAG,CAAC,EAAE,CAAC;QAC1B,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACrF,OAAO,GAAG,SAAS,MAAM,CAAC,UAAU,+CAA+C,UAAU,GAAG,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,MAAM,CAAC,UAAU,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACxK,CAAC;IAED,OAAO;QACL,QAAQ,EAAE,gBAAgB;QAC1B,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,OAAO;KACR,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAAC,IAAS,EAAE,QAAgB;IACvE,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,2BAA2B,CAAC,EAAE,CAAC;QACtD,OAAO;IACT,CAAC;IAED,MAAM,IAAI,CAAC,QAAQ,CAAC,CAAC,GAAW,EAAE,EAAE;QAClC,MAAM,EAAE,GAAI,UAAkB,CAAC,QAAQ,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC;QAC3D,IAAI,EAAE,EAAE,CAAC;YACP,EAAE,CAAC,eAAe,CAAC,yBAAyB,CAAC,CAAC;QAChD,CAAC;IACH,CAAC,EAAE,QAAQ,CAAC,CAAC;AACf,CAAC"}

package/build/validation-helpers.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Zod Validation Helpers
+ * Provides utilities for validating tool parameters with Zod schemas
+ */
+import { z } from 'zod';
+/**
+ * Result of parameter validation
+ */
+export type ValidationResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: any;
+};
+/**
+ * Validates parameters against a Zod schema
+ * Returns validated data or formatted error response
+ *
+ * Supports an out-of-band `continuationToken` param: if a prior call to the
+ * same tool failed with missing required params, the caller can retry with
+ * just { continuationToken, <missing fields> } and this merges it with the
+ * originally-supplied args instead of requiring a full resend.
+ */
+export declare function validateParams<T extends z.ZodTypeAny>(params: unknown, schema: T, toolName: string): ValidationResult<z.infer<T>>;
+/**
+ * Helper to create tool definitions with Zod schemas
+ * Automatically generates JSON Schema for MCP ListTools response
+ */
+export declare function createTool<T extends z.ZodTypeAny>(description: string, zodSchema: T, handler: (args: z.infer<T>, abortSignal?: AbortSignal) => Promise<any>): {
+    description: string;
+    zodSchema: T;
+    inputSchema: import("zod-to-json-schema").JsonSchema7Type & {
+        $schema?: string | undefined;
+        definitions?: {
+            [key: string]: import("zod-to-json-schema").JsonSchema7Type;
+        } | undefined;
+    };
+    handler: (args: z.infer<T>, abortSignal?: AbortSignal) => Promise<any>;
+};
+//# sourceMappingURL=validation-helpers.d.ts.map

package/build/validation-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation-helpers.d.ts","sourceRoot":"","sources":["../src/validation-helpers.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB;;GAEG;AACH,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAC1B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,GAAG,CAAA;CAAE,CAAC;AAyGnC;;;;;;;;GAQG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EACnD,MAAM,EAAE,OAAO,EACf,MAAM,EAAE,CAAC,EACT,QAAQ,EAAE,MAAM,GACf,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAoF9B;AA0DD;;;GAGG;AACH,wBAAgB,UAAU,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAC/C,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,CAAC,EACZ,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,GAAG,CAAC;;;;;;;;;oBAAtD,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,gBAAgB,WAAW,KAAK,OAAO,CAAC,GAAG,CAAC;EAYvE"}

package/build/validation-helpers.js

@@ -0,0 +1,236 @@
+/**
+ * Zod Validation Helpers
+ * Provides utilities for validating tool parameters with Zod schemas
+ */
+import { z } from 'zod';
+import { zodToJsonSchema } from 'zod-to-json-schema';
+import { randomUUID } from 'crypto';
+const CONTINUATION_TTL_MS = 5 * 60 * 1000;
+const pendingContinuations = new Map();
+function sweepExpiredContinuations() {
+    const now = Date.now();
+    for (const [token, entry] of pendingContinuations) {
+        if (entry.expiresAt < now)
+            pendingContinuations.delete(token);
+    }
+}
+function isMissingRequiredIssue(issue) {
+    return issue.code === 'invalid_type' && issue.received === 'undefined';
+}
+/**
+ * Unwraps optional/default/nullable wrappers to get at the underlying type
+ * for describing enums, etc.
+ */
+function unwrapZodType(schema) {
+    let current = schema;
+    while (current instanceof z.ZodOptional ||
+        current instanceof z.ZodNullable ||
+        current instanceof z.ZodDefault) {
+        current = current instanceof z.ZodDefault ? current._def.innerType : current.unwrap();
+    }
+    return current;
+}
+/**
+ * Best-effort lookup of a field's Zod definition to describe what's expected.
+ * Only handles flat/dotted top-level object fields; falls back to a bare
+ * shape if the schema isn't a ZodObject or the path can't be resolved.
+ */
+function describeMissingField(schema, fieldPath) {
+    const info = { name: fieldPath, type: 'unknown' };
+    let currentSchema = schema;
+    let fieldSchema;
+    for (const part of fieldPath.split('.')) {
+        if (!(currentSchema instanceof z.ZodObject)) {
+            fieldSchema = undefined;
+            break;
+        }
+        fieldSchema = currentSchema.shape[part];
+        currentSchema = fieldSchema;
+    }
+    if (!fieldSchema)
+        return info;
+    info.description = fieldSchema._def?.description;
+    if (fieldSchema instanceof z.ZodDefault) {
+        try {
+            info.default = fieldSchema._def.defaultValue();
+        }
+        catch {
+            // ignore
+        }
+    }
+    const unwrapped = unwrapZodType(fieldSchema);
+    if (unwrapped instanceof z.ZodEnum) {
+        info.type = 'enum';
+        info.enum = unwrapped.options;
+    }
+    else if (unwrapped instanceof z.ZodString) {
+        info.type = 'string';
+    }
+    else if (unwrapped instanceof z.ZodNumber) {
+        info.type = 'number';
+    }
+    else if (unwrapped instanceof z.ZodBoolean) {
+        info.type = 'boolean';
+    }
+    else if (unwrapped instanceof z.ZodArray) {
+        info.type = 'array';
+    }
+    else if (unwrapped instanceof z.ZodObject) {
+        info.type = 'object';
+    }
+    else {
+        info.type = unwrapped._def?.typeName || 'unknown';
+    }
+    return info;
+}
+/**
+ * Validates parameters against a Zod schema
+ * Returns validated data or formatted error response
+ *
+ * Supports an out-of-band `continuationToken` param: if a prior call to the
+ * same tool failed with missing required params, the caller can retry with
+ * just { continuationToken, <missing fields> } and this merges it with the
+ * originally-supplied args instead of requiring a full resend.
+ */
+export function validateParams(params, schema, toolName) {
+    sweepExpiredContinuations();
+    let effectiveParams = params;
+    let continuationToken;
+    if (params && typeof params === 'object' && 'continuationToken' in params) {
+        const { continuationToken: token, ...rest } = params;
+        if (typeof token === 'string') {
+            continuationToken = token;
+            const pending = pendingContinuations.get(token);
+            effectiveParams = pending && pending.toolName === toolName
+                ? { ...pending.args, ...rest }
+                : rest;
+        }
+        else {
+            effectiveParams = rest;
+        }
+    }
+    const result = schema.safeParse(effectiveParams);
+    if (!result.success) {
+        const missingIssues = result.error.issues.filter(isMissingRequiredIssue);
+        const otherIssues = result.error.issues.filter(issue => !isMissingRequiredIssue(issue));
+        // Any failure keeps (or opens) a continuation slot with the latest attempt's
+        // args, so the caller can retry with just a fix/addition rather than the
+        // whole payload - whether the problem was a missing field or a bad value.
+        const token = continuationToken && pendingContinuations.has(continuationToken)
+            ? continuationToken
+            : randomUUID();
+        pendingContinuations.set(token, {
+            toolName,
+            args: effectiveParams,
+            expiresAt: Date.now() + CONTINUATION_TTL_MS
+        });
+        const instructions = `Call '${toolName}' again with { continuationToken: '${token}', ...<only the field(s) to add/fix> }. Previously supplied arguments are cached for ${Math.round(CONTINUATION_TTL_MS / 60000)} minutes and merged automatically - no need to resend them.`;
+        if (missingIssues.length > 0) {
+            const missingParameters = missingIssues.map(issue => describeMissingField(schema, issue.path.join('.')));
+            const error = {
+                success: false,
+                error: `Missing required parameter(s) for tool '${toolName}'`,
+                code: otherIssues.length > 0 ? 'INVALID_PARAMS' : 'MISSING_PARAMETERS',
+                missingParameters,
+                continuationToken: token,
+                instructions
+            };
+            if (otherIssues.length > 0) {
+                error.validationErrors = formatZodErrors(result.error, otherIssues);
+            }
+            return { success: false, error };
+        }
+        // Only non-missing issues (bad types/enums/etc on values actually supplied)
+        return {
+            success: false,
+            error: {
+                success: false,
+                error: `Invalid parameters for tool '${toolName}'`,
+                code: 'INVALID_PARAMS',
+                validationErrors: formatZodErrors(result.error),
+                continuationToken: token,
+                instructions
+            }
+        };
+    }
+    // Validation succeeded - the token's job (merging args) is done. Resuming a
+    // call that's blocked *after* this point by an unrelated guard (port
+    // failure, dead server, etc.) is already handled by the existing command
+    // recorder / replay({ action: 'repeat' }) mechanism, which records this same
+    // merged `result.data` right after this call returns - no need to keep the
+    // continuation cache alive for that case too.
+    if (continuationToken)
+        pendingContinuations.delete(continuationToken);
+    return { success: true, data: result.data };
+}
+/**
+ * Converts Zod validation errors to user-friendly messages
+ */
+function formatZodErrors(error, issues = error.issues) {
+    return issues.map(issue => {
+        const path = issue.path.length > 0 ? issue.path.join('.') : 'root';
+        switch (issue.code) {
+            case 'invalid_type':
+                if (issue.received === 'undefined') {
+                    return `Missing required parameter: ${path}`;
+                }
+                return `Parameter '${path}' must be ${issue.expected}, got ${issue.received}`;
+            case 'unrecognized_keys':
+                return `Unknown parameter(s): ${issue.keys.join(', ')}`;
+            case 'too_small':
+                if (issue.type === 'string') {
+                    return `Parameter '${path}' must be at least ${issue.minimum} characters`;
+                }
+                else if (issue.type === 'number') {
+                    return `Parameter '${path}' must be at least ${issue.minimum}`;
+                }
+                else if (issue.type === 'array') {
+                    return `Parameter '${path}' must contain at least ${issue.minimum} items`;
+                }
+                return `Parameter '${path}' is too small`;
+            case 'too_big':
+                if (issue.type === 'string') {
+                    return `Parameter '${path}' must be at most ${issue.maximum} characters`;
+                }
+                else if (issue.type === 'number') {
+                    return `Parameter '${path}' must be at most ${issue.maximum}`;
+                }
+                else if (issue.type === 'array') {
+                    return `Parameter '${path}' must contain at most ${issue.maximum} items`;
+                }
+                return `Parameter '${path}' is too big`;
+            case 'invalid_enum_value':
+                return `Parameter '${path}' must be one of: ${issue.options.join(', ')}`;
+            case 'invalid_string':
+                if (issue.validation === 'email') {
+                    return `Parameter '${path}' must be a valid email address`;
+                }
+                else if (issue.validation === 'url') {
+                    return `Parameter '${path}' must be a valid URL`;
+                }
+                else if (issue.validation === 'regex') {
+                    return `Parameter '${path}' does not match required pattern`;
+                }
+                return `Parameter '${path}' is invalid`;
+            default:
+                return issue.message || `Parameter '${path}' is invalid`;
+        }
+    });
+}
+/**
+ * Helper to create tool definitions with Zod schemas
+ * Automatically generates JSON Schema for MCP ListTools response
+ */
+export function createTool(description, zodSchema, handler) {
+    return {
+        description,
+        zodSchema,
+        inputSchema: zodToJsonSchema(zodSchema, {
+            $refStrategy: 'none', // Inline all schemas for compatibility
+            target: 'jsonSchema7',
+            strictUnions: true
+        }),
+        handler
+    };
+}
+//# sourceMappingURL=validation-helpers.js.map

package/build/validation-helpers.js.map

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