devharness 0.8.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-tools.d.ts","sourceRoot":"","sources":["../../src/tools/source-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAY3D,wBAAgB,iBAAiB,CAC/B,UAAU,EAAE,UAAU,EACtB,gBAAgB,EAAE,gBAAgB,EAClC,2BAA2B,CAAC,EAAE,CAAC,gBAAgB,EAAE,MAAM,KAAK,OAAO,CAAC;IAClE,UAAU,EAAE,GAAG,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;IACvB,gBAAgB,EAAE,GAAG,CAAC;IACtB,cAAc,EAAE,GAAG,CAAC;IACpB,cAAc,EAAE,GAAG,CAAC;CACrB,GAAG,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAyCV"}

package/build/tools/source-tools.js

@@ -0,0 +1,47 @@
+/**
+ * Source Code Tools
+ */
+import { z } from 'zod';
+import { createTool } from '../validation-helpers.js';
+import { createSuccessResponse, createErrorResponse } from '../messages.js';
+// Schema for getSourceCode
+const getSourceCodeSchema = z.object({
+    url: z.string().describe('File URL or path'),
+    startLine: z.number().optional().describe('Start line number'),
+    endLine: z.number().optional().describe('End line number'),
+    connectionReason: z.string().optional().describe('Connection reference (use the reference from launchChrome output, e.g., "unnamed-connection-default" or your renamed tab)'),
+}).strict();
+export function createSourceTools(cdpManager, sourceMapHandler, resolveConnectionFromReason) {
+    return {
+        getSourceCode: createTool('Get source code at line range', getSourceCodeSchema, async (args) => {
+            const { url, startLine, endLine, connectionReason } = args;
+            // Resolve connection if connectionReason is provided
+            let targetCdpManager = cdpManager;
+            if (connectionReason && resolveConnectionFromReason) {
+                const resolved = await resolveConnectionFromReason(connectionReason);
+                if (!resolved) {
+                    return createErrorResponse('CONNECTION_NOT_FOUND');
+                }
+                targetCdpManager = resolved.cdpManager;
+            }
+            try {
+                const sourceCode = await targetCdpManager.getSourceCode(url, startLine, endLine);
+                // Build response with code directly (already formatted with line numbers)
+                const actualStart = startLine || 1;
+                const actualEnd = endLine || (startLine ? Math.min(sourceCode.totalLines, startLine + 9) : sourceCode.totalLines);
+                // Pass code as string, not wrapped in object, to avoid JSON stringification
+                const metadata = `Total lines: ${sourceCode.totalLines}${sourceCode.hasSourceMap ? ' (source map available)' : ''}`;
+                const codeBlock = '```javascript\n' + sourceCode.code + '\n```';
+                return createSuccessResponse('SOURCE_CODE_SUCCESS', {
+                    url,
+                    startLine: actualStart.toString(),
+                    endLine: actualEnd.toString(),
+                }, metadata + '\n\n' + codeBlock);
+            }
+            catch (error) {
+                return createErrorResponse('SOURCE_CODE_FAILED', { error: `${error}` });
+            }
+        }),
+    };
+}
+//# sourceMappingURL=source-tools.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"source-tools.js","sourceRoot":"","sources":["../../src/tools/source-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE5E,2BAA2B;AAC3B,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,kBAAkB,CAAC;IAC5C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mBAAmB,CAAC;IAC9D,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,iBAAiB,CAAC;IAC1D,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2HAA2H,CAAC;CAC9K,CAAC,CAAC,MAAM,EAAE,CAAC;AAEZ,MAAM,UAAU,iBAAiB,CAC/B,UAAsB,EACtB,gBAAkC,EAClC,2BAMS;IAET,OAAO;QACL,aAAa,EAAE,UAAU,CACvB,+BAA+B,EAC/B,mBAAmB,EACnB,KAAK,EAAE,IAAI,EAAE,EAAE;YACb,MAAM,EAAE,GAAG,EAAE,SAAS,EAAE,OAAO,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;YAE3D,qDAAqD;YACrD,IAAI,gBAAgB,GAAG,UAAU,CAAC;YAClC,IAAI,gBAAgB,IAAI,2BAA2B,EAAE,CAAC;gBACpD,MAAM,QAAQ,GAAG,MAAM,2BAA2B,CAAC,gBAAgB,CAAC,CAAC;gBACrE,IAAI,CAAC,QAAQ,EAAE,CAAC;oBACd,OAAO,mBAAmB,CAAC,sBAAsB,CAAC,CAAC;gBACrD,CAAC;gBACD,gBAAgB,GAAG,QAAQ,CAAC,UAAU,CAAC;YACzC,CAAC;YAED,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,MAAM,gBAAgB,CAAC,aAAa,CAAC,GAAG,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC;gBAEjF,0EAA0E;gBAC1E,MAAM,WAAW,GAAG,SAAS,IAAI,CAAC,CAAC;gBACnC,MAAM,SAAS,GAAG,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,UAAU,EAAE,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;gBAElH,4EAA4E;gBAC5E,MAAM,QAAQ,GAAG,gBAAgB,UAAU,CAAC,UAAU,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;gBACpH,MAAM,SAAS,GAAG,iBAAiB,GAAG,UAAU,CAAC,IAAI,GAAG,OAAO,CAAC;gBAEhE,OAAO,qBAAqB,CAAC,qBAAqB,EAAE;oBAClD,GAAG;oBACH,SAAS,EAAE,WAAW,CAAC,QAAQ,EAAE;oBACjC,OAAO,EAAE,SAAS,CAAC,QAAQ,EAAE;iBAC9B,EAAE,QAAQ,GAAG,MAAM,GAAG,SAAS,CAAC,CAAC;YACpC,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,mBAAmB,CAAC,oBAAoB,EAAE,EAAE,KAAK,EAAE,GAAG,KAAK,EAAE,EAAE,CAAC,CAAC;YAC1E,CAAC;QACH,CAAC,CACF;KACF,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,141 @@
+/**
+ * Storage Access Tools
+ */
+import { z } from 'zod';
+import type { CDPManager } from '../cdp-manager.js';
+import { PuppeteerManager } from '../puppeteer-manager.js';
+import type { StorageToolMeta } from '../tool-response.js';
+/**
+ * Describe an arbitrary structured-clone value as JSON-expressible data.
+ *
+ * IndexedDB stores structured-clone values, and several of the most interesting
+ * ones (a non-extractable `CryptoKey`, a `Blob`, an `ArrayBuffer`) serialize to
+ * `{}` under JSON - which is exactly the case the caller most wants to assert
+ * on. Instead of dropping them, emit a typed descriptor:
+ *
+ *   { __type: 'CryptoKey', keyType, algorithm, extractable, usages }
+ *
+ * so "an unwrappable signing key is present, P-256, non-extractable" is
+ * observable even though the key material is not.
+ *
+ * BUDGETS: `maxDepth`/`maxItems` are per-path and per-container, so they
+ * multiply rather than bound - a 500-wide array whose elements share a 500-wide
+ * array, repeated, is 500^6 visited nodes and pins the page's main thread. Two
+ * TOTAL budgets bound the whole walk instead: `maxNodes` (values visited) and
+ * `maxTotalChars` (characters emitted). Long strings are capped individually by
+ * `maxStringLength`. Whenever a budget or a string cap trips, an explicit
+ * marker is emitted ({__type:'BudgetExceeded'} / {__type:'String',truncated})
+ * and the top-level result is flagged, so a truncated read is never mistaken
+ * for a complete one.
+ *
+ * IMPORTANT: this function is injected into the page by stringifying it (see
+ * `SERIALIZER_SOURCE`), so it must be entirely self-contained - no imports, no
+ * closure variables, no references to anything outside its own body. Everything
+ * it needs is defined inline. It is exported so it can be unit-tested directly
+ * in Node without a browser.
+ */
+export declare function describeStructuredValue(value: any, options?: {
+    maxDepth?: number;
+    maxItems?: number;
+    maxNodes?: number;
+    maxTotalChars?: number;
+    maxStringLength?: number;
+}): any;
+/**
+ * Presence for a localStorage/sessionStorage read, structurally. `getItem`
+ * returns null only when the key is absent, so a stored empty string still
+ * counts as present - which reading the rendered JSON could not tell apart.
+ */
+export declare function webStorageMeta(items: any, key?: string | number): StorageToolMeta;
+export declare function createStorageTools(puppeteerManager: PuppeteerManager, cdpManager: CDPManager, resolveConnectionFromReason?: (connectionReason: string) => Promise<{
+    connection: any;
+    cdpManager: CDPManager;
+    puppeteerManager: any;
+    consoleMonitor: any;
+    networkMonitor: any;
+} | null>): {
+    storage: {
+        description: string;
+        zodSchema: z.ZodObject<{
+            action: z.ZodEnum<["getCookies", "setCookie", "getLocalStorage", "setLocalStorage", "removeLocalStorage", "getSessionStorage", "setSessionStorage", "removeSessionStorage", "idbListDatabases", "idbListStores", "idbGet", "idbGetAll", "idbPut", "idbDelete", "clear"]>;
+            connectionReason: z.ZodOptional<z.ZodString>;
+            url: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            value: z.ZodOptional<z.ZodString>;
+            domain: z.ZodOptional<z.ZodString>;
+            path: z.ZodOptional<z.ZodString>;
+            expires: z.ZodOptional<z.ZodNumber>;
+            httpOnly: z.ZodOptional<z.ZodBoolean>;
+            secure: z.ZodOptional<z.ZodBoolean>;
+            key: z.ZodOptional<z.ZodUnion<[z.ZodString, z.ZodNumber]>>;
+            db: z.ZodOptional<z.ZodString>;
+            store: z.ZodOptional<z.ZodString>;
+            record: z.ZodOptional<z.ZodAny>;
+            limit: z.ZodOptional<z.ZodNumber>;
+            reason: z.ZodOptional<z.ZodString>;
+            types: z.ZodOptional<z.ZodArray<z.ZodEnum<["cookies", "localStorage", "sessionStorage", "indexedDB"]>, "many">>;
+        }, "strict", z.ZodTypeAny, {
+            action: "clear" | "getCookies" | "getLocalStorage" | "idbGet" | "idbGetAll" | "setCookie" | "setLocalStorage" | "removeLocalStorage" | "getSessionStorage" | "setSessionStorage" | "removeSessionStorage" | "idbListDatabases" | "idbListStores" | "idbPut" | "idbDelete";
+            value?: string | undefined;
+            path?: string | undefined;
+            url?: string | undefined;
+            key?: string | number | undefined;
+            name?: string | undefined;
+            reason?: string | undefined;
+            record?: any;
+            connectionReason?: string | undefined;
+            limit?: number | undefined;
+            db?: string | undefined;
+            store?: string | undefined;
+            types?: ("localStorage" | "indexedDB" | "cookies" | "sessionStorage")[] | undefined;
+            domain?: string | undefined;
+            expires?: number | undefined;
+            httpOnly?: boolean | undefined;
+            secure?: boolean | undefined;
+        }, {
+            action: "clear" | "getCookies" | "getLocalStorage" | "idbGet" | "idbGetAll" | "setCookie" | "setLocalStorage" | "removeLocalStorage" | "getSessionStorage" | "setSessionStorage" | "removeSessionStorage" | "idbListDatabases" | "idbListStores" | "idbPut" | "idbDelete";
+            value?: string | undefined;
+            path?: string | undefined;
+            url?: string | undefined;
+            key?: string | number | undefined;
+            name?: string | undefined;
+            reason?: string | undefined;
+            record?: any;
+            connectionReason?: string | undefined;
+            limit?: number | undefined;
+            db?: string | undefined;
+            store?: string | undefined;
+            types?: ("localStorage" | "indexedDB" | "cookies" | "sessionStorage")[] | undefined;
+            domain?: string | undefined;
+            expires?: number | undefined;
+            httpOnly?: boolean | undefined;
+            secure?: boolean | 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" | "getCookies" | "getLocalStorage" | "idbGet" | "idbGetAll" | "setCookie" | "setLocalStorage" | "removeLocalStorage" | "getSessionStorage" | "setSessionStorage" | "removeSessionStorage" | "idbListDatabases" | "idbListStores" | "idbPut" | "idbDelete";
+            value?: string | undefined;
+            path?: string | undefined;
+            url?: string | undefined;
+            key?: string | number | undefined;
+            name?: string | undefined;
+            reason?: string | undefined;
+            record?: any;
+            connectionReason?: string | undefined;
+            limit?: number | undefined;
+            db?: string | undefined;
+            store?: string | undefined;
+            types?: ("localStorage" | "indexedDB" | "cookies" | "sessionStorage")[] | undefined;
+            domain?: string | undefined;
+            expires?: number | undefined;
+            httpOnly?: boolean | undefined;
+            secure?: boolean | undefined;
+        }, abortSignal?: AbortSignal) => Promise<any>;
+    };
+};
+//# sourceMappingURL=storage-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage-tools.d.ts","sourceRoot":"","sources":["../../src/tools/storage-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;AAI3D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,GAAG,EACV,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B,GACA,GAAG,CAuNL;AASD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,eAAe,CAMjF;AAkCD,wBAAgB,kBAAkB,CAChC,gBAAgB,EAAE,gBAAgB,EAClC,UAAU,EAAE,UAAU,EACtB,2BAA2B,CAAC,EAAE,CAAC,gBAAgB,EAAE,MAAM,KAAK,OAAO,CAAC;IAClE,UAAU,EAAE,GAAG,CAAC;IAChB,UAAU,EAAE,UAAU,CAAC;IACvB,gBAAgB,EAAE,GAAG,CAAC;IACtB,cAAc,EAAE,GAAG,CAAC;IACpB,cAAc,EAAE,GAAG,CAAC;CACrB,GAAG,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmpBV"}