@tangle-network/browser-agent-driver 0.33.3 → 0.35.0

package/dist/brain/tasks/evaluate.js

@@ -0,0 +1,55 @@
+/**
+ * Quality-evaluation task for the Brain decision engine: asks the LLM to rate
+ * the visual quality, design, and professional polish of the current page.
+ *
+ * Extracted from brain/index.ts via the delegate + host-interface pattern.
+ * Brain.evaluate keeps a thin delegator; the body lives here verbatim and reads
+ * Brain state through {@link BrainEvaluateHost}, which Brain `implements` so tsc
+ * proves the host surface is complete.
+ */
+import { EVALUATE_PROMPT } from '../prompts.js';
+export async function evaluateImpl(self, state, goal) {
+    const textContent = `GOAL that was being worked on: ${goal}
+
+CURRENT PAGE:
+URL: ${state.url}
+Title: ${state.title}
+
+Please evaluate the quality of this page/application.`;
+    const userContent = self.buildUserContent(textContent, state.screenshot, true);
+    const result = await self.generate(EVALUATE_PROMPT, [{ role: 'user', content: userContent }], undefined, 800);
+    const raw = result.text;
+    const tokensUsed = result.tokensUsed;
+    if (self.debug) {
+        console.log('[Brain] Evaluation:', raw.slice(0, 300));
+    }
+    try {
+        let text = raw.trim();
+        if (text.startsWith('```')) {
+            text = text.replace(/^```(?:json)?\n?/, '').replace(/\n?```$/, '');
+        }
+        const parsed = JSON.parse(text);
+        const rawScore = typeof parsed.score === 'number' ? parsed.score : 5;
+        return {
+            score: Math.max(1, Math.min(10, rawScore)),
+            assessment: parsed.assessment ?? 'No assessment provided',
+            strengths: Array.isArray(parsed.strengths) ? parsed.strengths : [],
+            issues: Array.isArray(parsed.issues) ? parsed.issues : [],
+            suggestions: Array.isArray(parsed.suggestions) ? parsed.suggestions : [],
+            raw,
+            tokensUsed,
+        };
+    }
+    catch {
+        return {
+            score: 5,
+            assessment: 'Failed to parse evaluation response',
+            strengths: [],
+            issues: [],
+            suggestions: [],
+            raw,
+            tokensUsed,
+        };
+    }
+}
+//# sourceMappingURL=evaluate.js.map

package/dist/brain/tasks/evaluate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"evaluate.js","sourceRoot":"","sources":["../../../src/brain/tasks/evaluate.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAoBhD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,IAAuB,EAAE,KAAgB,EAAE,IAAY;IACxF,MAAM,WAAW,GAAG,kCAAkC,IAAI;;;OAGrD,KAAK,CAAC,GAAG;SACP,KAAK,CAAC,KAAK;;sDAEkC,CAAC;IAErD,MAAM,WAAW,GAAG,IAAI,CAAC,gBAAgB,CAAC,WAAW,EAAE,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;IAE/E,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAChC,eAAe,EACf,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,EACxC,SAAS,EACT,GAAG,CACJ,CAAC;IAEF,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC;IACxB,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC;IAErC,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,qBAAqB,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,CAAC;QACH,IAAI,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;QACtB,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,MAAM,QAAQ,GAAG,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACrE,OAAO;YACL,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;YAC1C,UAAU,EAAE,MAAM,CAAC,UAAU,IAAI,wBAAwB;YACzD,SAAS,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE;YAClE,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE;YACzD,WAAW,EAAE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE;YACxE,GAAG;YACH,UAAU;SACX,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,KAAK,EAAE,CAAC;YACR,UAAU,EAAE,qCAAqC;YACjD,SAAS,EAAE,EAAE;YACb,MAAM,EAAE,EAAE;YACV,WAAW,EAAE,EAAE;YACf,GAAG;YACH,UAAU;SACX,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/brain/tasks/goal-verification.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Goal-verification task for the Brain decision engine: a fresh (history-free)
+ * LLM call that checks whether the agent's claimed result actually achieved the
+ * goal, kept separate from quality evaluation to avoid self-confirmation bias.
+ *
+ * Extracted from brain/index.ts via the delegate + host-interface pattern.
+ * Brain.verifyGoalCompletion keeps a thin delegator; the body lives here
+ * verbatim and reads Brain state through {@link BrainGoalVerificationHost}, which
+ * Brain `implements` so tsc proves the host surface is complete.
+ */
+import type { ModelMessage, SystemModelMessage } from 'ai';
+import type { PageState, GoalVerification } from '../../types.js';
+import type { UserContent } from '../types.js';
+import type { BrainProvider, ModelSelection, GenerateResult } from '../model-client.js';
+/**
+ * The slice of Brain state `verifyGoalCompletion` reads. All members are public
+ * on Brain by construction; `implements BrainGoalVerificationHost` makes a
+ * missing/mistyped member a compile error.
+ */
+export interface BrainGoalVerificationHost {
+    provider: BrainProvider;
+    debug: boolean;
+    adaptiveModelRouting: boolean;
+    navProvider?: BrainProvider;
+    navModelName?: string;
+    verifierProvider?: string;
+    verifierModel?: string;
+    buildUserContent(text: string, screenshot?: string, forceVision?: boolean): UserContent;
+    generate(system: string | SystemModelMessage[], messages: ModelMessage[], selection?: ModelSelection, maxOutputTokens?: number): Promise<GenerateResult>;
+}
+export declare function verifyGoalCompletionImpl(self: BrainGoalVerificationHost, state: PageState, goal: string, claimedResult: string): Promise<GoalVerification>;
+//# sourceMappingURL=goal-verification.d.ts.map

package/dist/brain/tasks/goal-verification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-verification.d.ts","sourceRoot":"","sources":["../../../src/brain/tasks/goal-verification.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAGlE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAExF;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,QAAQ,EAAE,aAAa,CAAC;IACxB,KAAK,EAAE,OAAO,CAAC;IACf,oBAAoB,EAAE,OAAO,CAAC;IAC9B,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;IACxF,QAAQ,CACN,MAAM,EAAE,MAAM,GAAG,kBAAkB,EAAE,EACrC,QAAQ,EAAE,YAAY,EAAE,EACxB,SAAS,CAAC,EAAE,cAAc,EAC1B,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5B;AAED,wBAAsB,wBAAwB,CAC5C,IAAI,EAAE,yBAAyB,EAC/B,KAAK,EAAE,SAAS,EAChB,IAAI,EAAE,MAAM,EACZ,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,gBAAgB,CAAC,CAgE3B"}

package/dist/brain/tasks/goal-verification.js

@@ -0,0 +1,68 @@
+/**
+ * Goal-verification task for the Brain decision engine: a fresh (history-free)
+ * LLM call that checks whether the agent's claimed result actually achieved the
+ * goal, kept separate from quality evaluation to avoid self-confirmation bias.
+ *
+ * Extracted from brain/index.ts via the delegate + host-interface pattern.
+ * Brain.verifyGoalCompletion keeps a thin delegator; the body lives here
+ * verbatim and reads Brain state through {@link BrainGoalVerificationHost}, which
+ * Brain `implements` so tsc proves the host surface is complete.
+ */
+import { buildFirstPartyBoundaryNote } from '../../domain-policy.js';
+import { budgetSnapshot } from '../snapshot-budget.js';
+export async function verifyGoalCompletionImpl(self, state, goal, claimedResult) {
+    const siteBoundaryNote = buildFirstPartyBoundaryNote(goal, state.url);
+    const textContent = `GOAL: ${goal}
+
+AGENT'S CLAIMED RESULT: ${claimedResult}
+
+CURRENT PAGE:
+URL: ${state.url}
+Title: ${state.title}
+
+ELEMENTS:
+${budgetSnapshot(state.snapshot)}${siteBoundaryNote ? `\n\n${siteBoundaryNote}` : ''}
+
+Was the goal actually achieved? Analyze the current page state carefully.`;
+    const userContent = self.buildUserContent(textContent, state.screenshot, true);
+    // Verifier can use its own model, then the navigation model, then main.
+    const verifyProvider = self.verifierProvider
+        ? self.verifierProvider
+        : (self.adaptiveModelRouting && self.navModelName ? (self.navProvider || self.provider) : undefined);
+    const verifyModel = self.verifierModel
+        || (self.adaptiveModelRouting && self.navModelName ? self.navModelName : undefined);
+    const result = await self.generate(`Verify whether the browser agent achieved its goal. Respond with ONLY JSON:
+{"achieved":true,"confidence":0.9,"evidence":["observation"],"missing":[]}
+
+Check: page state matches goal, no errors, URL is expected, claimed result matches visible data.
+SUPPLEMENTAL TOOL EVIDENCE / SCRIPT RESULT in claimed results = verified DOM data, trustworthy even if page navigated away. Multi-page data collection is valid.`, [{ role: 'user', content: userContent }], verifyProvider && verifyModel ? { provider: verifyProvider, model: verifyModel } : undefined, 600);
+    const raw = result.text;
+    if (self.debug) {
+        console.log('[Brain] Goal verification:', raw.slice(0, 300));
+    }
+    try {
+        let text = raw.trim();
+        if (text.startsWith('```')) {
+            text = text.replace(/^```(?:json)?\n?/, '').replace(/\n?```$/, '');
+        }
+        const parsed = JSON.parse(text);
+        return {
+            achieved: parsed.achieved === true,
+            confidence: typeof parsed.confidence === 'number'
+                ? Math.max(0, Math.min(1, parsed.confidence))
+                : 0.5,
+            evidence: Array.isArray(parsed.evidence) ? parsed.evidence : [],
+            missing: Array.isArray(parsed.missing) ? parsed.missing : [],
+        };
+    }
+    catch {
+        // Parse failure — assume not verified (conservative)
+        return {
+            achieved: false,
+            confidence: 0,
+            evidence: [],
+            missing: ['Failed to parse goal verification response'],
+        };
+    }
+}
+//# sourceMappingURL=goal-verification.js.map

package/dist/brain/tasks/goal-verification.js.map

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

package/dist/brain/tasks/knowledge.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Knowledge-extraction task for the Brain decision engine: distills a completed
+ * trajectory into reusable timing/selector/pattern/quirk facts that help an
+ * agent complete similar tasks faster next time.
+ *
+ * Extracted from brain/index.ts via the delegate + host-interface pattern.
+ * Brain.extractKnowledge keeps a thin delegator; the body lives here verbatim
+ * and reads Brain state through {@link BrainKnowledgeHost}, which Brain
+ * `implements` so tsc proves the host surface is complete.
+ */
+import type { ModelMessage, SystemModelMessage } from 'ai';
+import type { ModelSelection, GenerateResult } from '../model-client.js';
+/**
+ * The slice of Brain state `extractKnowledge` reads — just the transport funnel.
+ * `implements BrainKnowledgeHost` makes a missing/mistyped member a compile
+ * error.
+ */
+export interface BrainKnowledgeHost {
+    generate(system: string | SystemModelMessage[], messages: ModelMessage[], selection?: ModelSelection, maxOutputTokens?: number): Promise<GenerateResult>;
+}
+export declare function extractKnowledgeImpl(self: BrainKnowledgeHost, trajectoryText: string, domain: string): Promise<Array<{
+    type: 'timing' | 'selector' | 'pattern' | 'quirk';
+    key: string;
+    value: string;
+}>>;
+//# sourceMappingURL=knowledge.d.ts.map

package/dist/brain/tasks/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../../src/brain/tasks/knowledge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AAC3D,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzE;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CACN,MAAM,EAAE,MAAM,GAAG,kBAAkB,EAAE,EACrC,QAAQ,EAAE,YAAY,EAAE,EACxB,SAAS,CAAC,EAAE,cAAc,EAC1B,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5B;AAED,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,kBAAkB,EACxB,cAAc,EAAE,MAAM,EACtB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,KAAK,CAAC;IAAE,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC,CAmDnG"}

package/dist/brain/tasks/knowledge.js

@@ -0,0 +1,56 @@
+/**
+ * Knowledge-extraction task for the Brain decision engine: distills a completed
+ * trajectory into reusable timing/selector/pattern/quirk facts that help an
+ * agent complete similar tasks faster next time.
+ *
+ * Extracted from brain/index.ts via the delegate + host-interface pattern.
+ * Brain.extractKnowledge keeps a thin delegator; the body lives here verbatim
+ * and reads Brain state through {@link BrainKnowledgeHost}, which Brain
+ * `implements` so tsc proves the host surface is complete.
+ */
+export async function extractKnowledgeImpl(self, trajectoryText, domain) {
+    const result = await self.generate(`You are analyzing a browser automation trajectory to extract reusable knowledge.
+Extract facts that would help an agent complete similar tasks faster next time.
+
+Respond with ONLY a JSON array of facts:
+[
+  {"type": "timing", "key": "page-load", "value": "wait 3000ms after navigation for content to hydrate"},
+  {"type": "selector", "key": "send-button", "value": "[data-testid='chat-send-button'] is the reliable send button selector"},
+  {"type": "pattern", "key": "auth-flow", "value": "Click sign-in → fill email → fill password → click submit → wait for redirect"},
+  {"type": "quirk", "key": "lazy-loading", "value": "File tree loads asynchronously — wait for entries before asserting"}
+]
+
+Types:
+- timing: wait durations, delays that are necessary
+- selector: reliable selectors for important elements
+- pattern: multi-step interaction sequences
+- quirk: app-specific behaviors or gotchas
+
+Only include facts that are genuinely useful. Quality over quantity. Max 10 facts.`, [{
+            role: 'user',
+            content: `Domain: ${domain}\n\nTrajectory:\n${trajectoryText}`,
+        }], undefined, 800);
+    try {
+        let text = result.text.trim();
+        if (text.startsWith('```')) {
+            text = text.replace(/^```(?:json)?\n?/, '').replace(/\n?```$/, '');
+        }
+        const parsed = JSON.parse(text);
+        if (!Array.isArray(parsed))
+            return [];
+        const VALID_TYPES = new Set(['timing', 'selector', 'pattern', 'quirk']);
+        return parsed
+            .filter((f) => VALID_TYPES.has(f.type) &&
+            typeof f.key === 'string' &&
+            typeof f.value === 'string')
+            .map((f) => ({
+            type: f.type,
+            key: f.key,
+            value: f.value,
+        }));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/brain/tasks/knowledge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.js","sourceRoot":"","sources":["../../../src/brain/tasks/knowledge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAmBH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,IAAwB,EACxB,cAAsB,EACtB,MAAc;IAEd,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAChC;;;;;;;;;;;;;;;;;mFAiB+E,EAC/E,CAAC;YACC,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,WAAW,MAAM,oBAAoB,cAAc,EAAE;SAC/D,CAAC,EACF,SAAS,EACT,GAAG,CACJ,CAAC;IAEF,IAAI,CAAC;QACH,IAAI,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3B,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACrE,CAAC;QACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC;YAAE,OAAO,EAAE,CAAC;QAEtC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,CAAC,QAAQ,EAAE,UAAU,EAAE,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC;QACxE,OAAO,MAAM;aACV,MAAM,CAAC,CAAC,CAA0B,EAAE,EAAE,CACrC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,IAAc,CAAC;YACjC,OAAO,CAAC,CAAC,GAAG,KAAK,QAAQ;YACzB,OAAO,CAAC,CAAC,KAAK,KAAK,QAAQ,CAC5B;aACA,GAAG,CAAC,CAAC,CAA0B,EAAE,EAAE,CAAC,CAAC;YACpC,IAAI,EAAE,CAAC,CAAC,IAAmD;YAC3D,GAAG,EAAE,CAAC,CAAC,GAAa;YACpB,KAAK,EAAE,CAAC,CAAC,KAAe;SACzB,CAAC,CAAC,CAAC;IACR,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/brain/tasks/link-scout.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Link-scout task for the Brain decision engine: given a goal and a ranked set
+ * of deterministic link candidates, asks a cheap scout model to pick the single
+ * best next visible link (with a deterministic top-candidate fallback on parse
+ * failure).
+ *
+ * Extracted from brain/index.ts via the delegate + host-interface pattern.
+ * Brain.recommendLinkCandidate keeps a thin delegator; the body lives here
+ * verbatim and reads Brain state through {@link BrainLinkScoutHost}, which Brain
+ * `implements` so tsc proves the host surface is complete.
+ */
+import type { ModelMessage, SystemModelMessage } from 'ai';
+import type { PageState } from '../../types.js';
+import type { LinkScoutRecommendation, UserContent } from '../types.js';
+import type { BrainProvider, ModelSelection, GenerateResult } from '../model-client.js';
+/**
+ * The slice of Brain state `recommendLinkCandidate` reads. All members are
+ * public on Brain by construction; `implements BrainLinkScoutHost` makes a
+ * missing/mistyped member a compile error.
+ */
+export interface BrainLinkScoutHost {
+    provider: BrainProvider;
+    modelName: string;
+    navProvider?: BrainProvider;
+    navModelName?: string;
+    scoutProvider?: BrainProvider;
+    scoutModelName?: string;
+    scoutUseVision: boolean;
+    buildUserContent(text: string, screenshot?: string, forceVision?: boolean): UserContent;
+    generate(system: string | SystemModelMessage[], messages: ModelMessage[], selection?: ModelSelection, maxOutputTokens?: number): Promise<GenerateResult>;
+}
+export declare function recommendLinkCandidateImpl(self: BrainLinkScoutHost, goal: string, state: PageState, candidates: Array<{
+    ref: string;
+    text: string;
+    score: number;
+}>, extraContext?: string): Promise<LinkScoutRecommendation>;
+//# sourceMappingURL=link-scout.d.ts.map

package/dist/brain/tasks/link-scout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"link-scout.d.ts","sourceRoot":"","sources":["../../../src/brain/tasks/link-scout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AAC3D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAExF;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,aAAa,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,aAAa,CAAC;IAC5B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,OAAO,GAAG,WAAW,CAAC;IACxF,QAAQ,CACN,MAAM,EAAE,MAAM,GAAG,kBAAkB,EAAE,EACrC,QAAQ,EAAE,YAAY,EAAE,EACxB,SAAS,CAAC,EAAE,cAAc,EAC1B,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5B;AAED,wBAAsB,0BAA0B,CAC9C,IAAI,EAAE,kBAAkB,EACxB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,EAChB,UAAU,EAAE,KAAK,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC,EAC/D,YAAY,CAAC,EAAE,MAAM,GACpB,OAAO,CAAC,uBAAuB,CAAC,CAoElC"}

package/dist/brain/tasks/link-scout.js

@@ -0,0 +1,69 @@
+/**
+ * Link-scout task for the Brain decision engine: given a goal and a ranked set
+ * of deterministic link candidates, asks a cheap scout model to pick the single
+ * best next visible link (with a deterministic top-candidate fallback on parse
+ * failure).
+ *
+ * Extracted from brain/index.ts via the delegate + host-interface pattern.
+ * Brain.recommendLinkCandidate keeps a thin delegator; the body lives here
+ * verbatim and reads Brain state through {@link BrainLinkScoutHost}, which Brain
+ * `implements` so tsc proves the host surface is complete.
+ */
+import { LINK_SCOUT_PROMPT } from '../prompts.js';
+export async function recommendLinkCandidateImpl(self, goal, state, candidates, extraContext) {
+    const topCandidates = candidates.slice(0, 5);
+    // Scout only needs candidates + context, not the full snapshot (saves 2-8k tokens)
+    const lines = [
+        `GOAL: ${goal}`,
+        '',
+        `PAGE: ${state.url} — ${state.title}`,
+        '',
+        'CANDIDATES:',
+        ...topCandidates.map((candidate, index) => `${index + 1}. ${candidate.ref} — ${candidate.text} (score ${candidate.score})`),
+    ];
+    if (extraContext) {
+        lines.push('', extraContext);
+    }
+    lines.push('', 'Choose the single best next visible link.');
+    const userContent = self.buildUserContent(lines.join('\n'), state.screenshot, self.scoutUseVision);
+    const provider = self.scoutProvider || self.navProvider || self.provider;
+    const model = self.scoutModelName || self.navModelName || self.modelName;
+    const result = await self.generate(LINK_SCOUT_PROMPT, [{ role: 'user', content: userContent }], { provider, model }, 300);
+    const raw = result.text;
+    const tokensUsed = result.tokensUsed;
+    try {
+        let text = raw.trim();
+        if (text.startsWith('```')) {
+            text = text.replace(/^```(?:json)?\n?/, '').replace(/\n?```$/, '');
+        }
+        const parsed = JSON.parse(text);
+        const selector = typeof parsed.selector === 'string' ? parsed.selector.trim() : '';
+        const candidate = topCandidates.find((entry) => entry.ref === selector);
+        if (!candidate) {
+            throw new Error('invalid scout selector');
+        }
+        return {
+            selector,
+            reasoning: typeof parsed.reasoning === 'string' ? parsed.reasoning : 'No scout reasoning provided.',
+            confidence: typeof parsed.confidence === 'number'
+                ? Math.max(0, Math.min(1, parsed.confidence))
+                : 0.5,
+            raw,
+            tokensUsed,
+        };
+    }
+    catch {
+        const fallback = topCandidates[0];
+        if (!fallback) {
+            throw new Error('recommendLinkCandidate requires at least one candidate');
+        }
+        return {
+            selector: fallback.ref,
+            reasoning: 'Scout fallback: selected the top deterministic candidate after parse failure.',
+            confidence: 0.5,
+            raw,
+            tokensUsed,
+        };
+    }
+}
+//# sourceMappingURL=link-scout.js.map

package/dist/brain/tasks/link-scout.js.map

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

package/dist/brain/types.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Public result types for the LLM decision engine plus the internal
+ * UserContent shape. BrainDecision/QualityEvaluation/LinkScoutRecommendation are
+ * re-exported from brain/index.ts so existing import paths stay valid.
+ */
+import type { Action } from '../types.js';
+export interface BrainDecision {
+    action: Action;
+    nextActions?: Action[];
+    raw: string;
+    reasoning?: string;
+    plan?: string[];
+    currentStep?: number;
+    expectedEffect?: string;
+    tokensUsed?: number;
+    inputTokens?: number;
+    outputTokens?: number;
+    /**
+     * Prompt-cache hit tokens (provider-agnostic). Reads from the AI SDK's
+     * unified `usage.inputTokenDetails.cacheReadTokens` field. Populated by:
+     *   - OpenAI / ZAI / GLM via automatic server-side caching
+     *   - Anthropic via the cache_control markers set in buildSystemForDecide
+     */
+    cacheReadInputTokens?: number;
+    /** Prompt-cache write tokens (cache miss, first turn — provider-agnostic) */
+    cacheCreationInputTokens?: number;
+    /** Which model handled this decision (for cost tracking with adaptive routing) */
+    modelUsed?: string;
+}
+export interface QualityEvaluation {
+    score: number;
+    assessment: string;
+    strengths: string[];
+    issues: string[];
+    suggestions: string[];
+    raw: string;
+    tokensUsed?: number;
+}
+export interface LinkScoutRecommendation {
+    selector: string;
+    reasoning: string;
+    confidence: number;
+    raw: string;
+    tokensUsed?: number;
+}
+/** User message content — text-only or multimodal with screenshot */
+export type UserContent = string | Array<{
+    type: 'text';
+    text: string;
+} | {
+    type: 'image';
+    image: string;
+    mediaType: string;
+}>;
+//# sourceMappingURL=types.d.ts.map

package/dist/brain/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/brain/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;;;OAKG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,6EAA6E;IAC7E,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,iBAAiB;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,qEAAqE;AACrE,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC"}

package/dist/brain/types.js

@@ -0,0 +1,7 @@
+/**
+ * Public result types for the LLM decision engine plus the internal
+ * UserContent shape. BrainDecision/QualityEvaluation/LinkScoutRecommendation are
+ * re-exported from brain/index.ts so existing import paths stay valid.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/brain/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/brain/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/browser/stealth-init-script.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Stealth fingerprint patches injected into every Playwright-controlled
+ * context (never into real user browsers reached over CDP). Overrides the
+ * automation tells that anti-bot vendors fingerprint: navigator.webdriver,
+ * empty plugin/mimetype lists, headless WebGL vendor strings, the CDP
+ * screenX/screenY bug, missing navigator.connection, canvas readback, etc.
+ */
+export declare const STEALTH_INIT_SCRIPT = "\n        // navigator.webdriver \u2014 explicit override (backup for --disable-blink-features)\n        Object.defineProperty(navigator, 'webdriver', { get: () => undefined });\n        // navigator.plugins \u2014 empty in headless, non-empty in real browsers\n        Object.defineProperty(navigator, 'plugins', {\n          get: () => [\n            { name: 'Chrome PDF Plugin', filename: 'internal-pdf-viewer', description: 'Portable Document Format' },\n            { name: 'Chrome PDF Viewer', filename: 'mhjfbmdgcfjbbpaeojofohoefgiehjai', description: '' },\n            { name: 'Native Client', filename: 'internal-nacl-plugin', description: '' },\n          ],\n        });\n        // navigator.languages \u2014 must match Accept-Language header\n        Object.defineProperty(navigator, 'languages', { get: () => ['en-US', 'en'] });\n        // hardware signals \u2014 realistic desktop values\n        Object.defineProperty(navigator, 'hardwareConcurrency', { get: () => 8 });\n        Object.defineProperty(navigator, 'deviceMemory', { get: () => 8 });\n        // window.chrome \u2014 full stub matching real Chrome\n        if (!window.chrome) window.chrome = {};\n        if (!window.chrome.runtime) window.chrome.runtime = { id: undefined };\n        if (!window.chrome.app) window.chrome.app = { isInstalled: false, InstallState: { DISABLED: 'disabled', INSTALLED: 'installed', NOT_INSTALLED: 'not_installed' }, RunningState: { CANNOT_RUN: 'cannot_run', READY_TO_RUN: 'ready_to_run', RUNNING: 'running' } };\n        if (!window.chrome.csi) window.chrome.csi = function() { return { onloadT: Date.now(), startE: Date.now(), pageT: Date.now() - performance.timing.navigationStart }; };\n        if (!window.chrome.loadTimes) window.chrome.loadTimes = function() { return { commitLoadTime: Date.now() / 1000, connectionInfo: 'h2', finishDocumentLoadTime: Date.now() / 1000, finishLoadTime: Date.now() / 1000, firstPaintAfterLoadTime: 0, firstPaintTime: Date.now() / 1000, navigationType: 'Other', npnNegotiatedProtocol: 'h2', requestTime: Date.now() / 1000 - 0.16, startLoadTime: Date.now() / 1000 - 0.16, wasAlternateProtocolAvailable: false, wasFetchedViaSpdy: true, wasNpnNegotiated: true }; };\n        // WebGL vendor/renderer \u2014 match real GPU values\n        try {\n          const getParameter = WebGLRenderingContext.prototype.getParameter;\n          WebGLRenderingContext.prototype.getParameter = function(parameter) {\n            if (parameter === 37445) return 'Intel Inc.';\n            if (parameter === 37446) return 'Intel Iris OpenGL Engine';\n            return getParameter.call(this, parameter);\n          };\n        } catch (_) {}\n        try {\n          const getParameter2 = WebGL2RenderingContext.prototype.getParameter;\n          WebGL2RenderingContext.prototype.getParameter = function(parameter) {\n            if (parameter === 37445) return 'Intel Inc.';\n            if (parameter === 37446) return 'Intel Iris OpenGL Engine';\n            return getParameter2.call(this, parameter);\n          };\n        } catch (_) {}\n        // window.outerWidth/outerHeight \u2014 0 in headless, match viewport in real browsers\n        if (window.outerWidth === 0) Object.defineProperty(window, 'outerWidth', { get: () => window.innerWidth });\n        if (window.outerHeight === 0) Object.defineProperty(window, 'outerHeight', { get: () => window.innerHeight + 85 });\n        // Patch permissions API \u2014 cover all permission types bots commonly mis-handle\n        try {\n          const origQuery = navigator.permissions.query.bind(navigator.permissions);\n          navigator.permissions.query = (params) => {\n            const deny = ['notifications', 'geolocation', 'camera', 'microphone', 'payment-handler'];\n            if (deny.includes(params.name))\n              return Promise.resolve({ state: 'denied', onchange: null });\n            return origQuery(params);\n          };\n        } catch (_) {}\n        // Canvas fingerprint noise \u2014 add imperceptible per-session noise to canvas readback\n        // so each session produces a unique fingerprint (defeats static fingerprint matching)\n        try {\n          const seed = Math.random() * 0xffff | 0;\n          const noisify = (canvas) => {\n            try {\n              const ctx = canvas.getContext('2d');\n              if (!ctx) return;\n              const { width: w, height: h } = canvas;\n              if (w === 0 || h === 0) return;\n              const img = ctx.getImageData(0, 0, w, h);\n              const d = img.data;\n              for (let i = 0; i < d.length; i += 4) {\n                // deterministic per-pixel noise from seed + position\n                d[i] = d[i] ^ ((seed + i) & 1);\n              }\n              ctx.putImageData(img, 0, 0);\n            } catch (_) {}\n          };\n          const origToDataURL = HTMLCanvasElement.prototype.toDataURL;\n          HTMLCanvasElement.prototype.toDataURL = function(...args) {\n            noisify(this);\n            return origToDataURL.apply(this, args);\n          };\n          const origToBlob = HTMLCanvasElement.prototype.toBlob;\n          HTMLCanvasElement.prototype.toBlob = function(...args) {\n            noisify(this);\n            return origToBlob.apply(this, args);\n          };\n        } catch (_) {}\n        // Fix CDP screenX/screenY bug \u2014 CDP Input.dispatchMouseEvent sets\n        // screenX=clientX, screenY=clientY which never happens in real browsers.\n        // Cloudflare Turnstile actively checks this. Add a per-session window\n        // offset so screenX/screenY are realistic and internally consistent.\n        try {\n          const winX = Math.floor(Math.random() * 200) + 50;\n          const winY = Math.floor(Math.random() * 100) + 50;\n          const chrome = 85;\n          Object.defineProperty(MouseEvent.prototype, 'screenX', {\n            get() { return this.clientX + winX; },\n            configurable: true,\n          });\n          Object.defineProperty(MouseEvent.prototype, 'screenY', {\n            get() { return this.clientY + winY + chrome; },\n            configurable: true,\n          });\n        } catch (_) {}\n        // navigator.connection \u2014 missing in headless, present in real Chrome\n        try {\n          if (!navigator.connection) {\n            Object.defineProperty(navigator, 'connection', {\n              get: () => ({\n                effectiveType: '4g',\n                rtt: 50,\n                downlink: 10,\n                saveData: false,\n                onchange: null,\n              }),\n            });\n          }\n        } catch (_) {}\n        // Notification.permission \u2014 default differs in headless\n        try {\n          if (typeof Notification !== 'undefined' && Notification.permission === 'default') {\n            Object.defineProperty(Notification, 'permission', { get: () => 'denied' });\n          }\n        } catch (_) {}\n      ";
+//# sourceMappingURL=stealth-init-script.d.ts.map

package/dist/browser/stealth-init-script.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stealth-init-script.d.ts","sourceRoot":"","sources":["../../src/browser/stealth-init-script.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,mBAAmB,m0NAuHzB,CAAC"}

package/dist/browser/stealth-init-script.js

@@ -0,0 +1,128 @@
+/**
+ * Stealth fingerprint patches injected into every Playwright-controlled
+ * context (never into real user browsers reached over CDP). Overrides the
+ * automation tells that anti-bot vendors fingerprint: navigator.webdriver,
+ * empty plugin/mimetype lists, headless WebGL vendor strings, the CDP
+ * screenX/screenY bug, missing navigator.connection, canvas readback, etc.
+ */
+export const STEALTH_INIT_SCRIPT = `
+        // navigator.webdriver — explicit override (backup for --disable-blink-features)
+        Object.defineProperty(navigator, 'webdriver', { get: () => undefined });
+        // navigator.plugins — empty in headless, non-empty in real browsers
+        Object.defineProperty(navigator, 'plugins', {
+          get: () => [
+            { name: 'Chrome PDF Plugin', filename: 'internal-pdf-viewer', description: 'Portable Document Format' },
+            { name: 'Chrome PDF Viewer', filename: 'mhjfbmdgcfjbbpaeojofohoefgiehjai', description: '' },
+            { name: 'Native Client', filename: 'internal-nacl-plugin', description: '' },
+          ],
+        });
+        // navigator.languages — must match Accept-Language header
+        Object.defineProperty(navigator, 'languages', { get: () => ['en-US', 'en'] });
+        // hardware signals — realistic desktop values
+        Object.defineProperty(navigator, 'hardwareConcurrency', { get: () => 8 });
+        Object.defineProperty(navigator, 'deviceMemory', { get: () => 8 });
+        // window.chrome — full stub matching real Chrome
+        if (!window.chrome) window.chrome = {};
+        if (!window.chrome.runtime) window.chrome.runtime = { id: undefined };
+        if (!window.chrome.app) window.chrome.app = { isInstalled: false, InstallState: { DISABLED: 'disabled', INSTALLED: 'installed', NOT_INSTALLED: 'not_installed' }, RunningState: { CANNOT_RUN: 'cannot_run', READY_TO_RUN: 'ready_to_run', RUNNING: 'running' } };
+        if (!window.chrome.csi) window.chrome.csi = function() { return { onloadT: Date.now(), startE: Date.now(), pageT: Date.now() - performance.timing.navigationStart }; };
+        if (!window.chrome.loadTimes) window.chrome.loadTimes = function() { return { commitLoadTime: Date.now() / 1000, connectionInfo: 'h2', finishDocumentLoadTime: Date.now() / 1000, finishLoadTime: Date.now() / 1000, firstPaintAfterLoadTime: 0, firstPaintTime: Date.now() / 1000, navigationType: 'Other', npnNegotiatedProtocol: 'h2', requestTime: Date.now() / 1000 - 0.16, startLoadTime: Date.now() / 1000 - 0.16, wasAlternateProtocolAvailable: false, wasFetchedViaSpdy: true, wasNpnNegotiated: true }; };
+        // WebGL vendor/renderer — match real GPU values
+        try {
+          const getParameter = WebGLRenderingContext.prototype.getParameter;
+          WebGLRenderingContext.prototype.getParameter = function(parameter) {
+            if (parameter === 37445) return 'Intel Inc.';
+            if (parameter === 37446) return 'Intel Iris OpenGL Engine';
+            return getParameter.call(this, parameter);
+          };
+        } catch (_) {}
+        try {
+          const getParameter2 = WebGL2RenderingContext.prototype.getParameter;
+          WebGL2RenderingContext.prototype.getParameter = function(parameter) {
+            if (parameter === 37445) return 'Intel Inc.';
+            if (parameter === 37446) return 'Intel Iris OpenGL Engine';
+            return getParameter2.call(this, parameter);
+          };
+        } catch (_) {}
+        // window.outerWidth/outerHeight — 0 in headless, match viewport in real browsers
+        if (window.outerWidth === 0) Object.defineProperty(window, 'outerWidth', { get: () => window.innerWidth });
+        if (window.outerHeight === 0) Object.defineProperty(window, 'outerHeight', { get: () => window.innerHeight + 85 });
+        // Patch permissions API — cover all permission types bots commonly mis-handle
+        try {
+          const origQuery = navigator.permissions.query.bind(navigator.permissions);
+          navigator.permissions.query = (params) => {
+            const deny = ['notifications', 'geolocation', 'camera', 'microphone', 'payment-handler'];
+            if (deny.includes(params.name))
+              return Promise.resolve({ state: 'denied', onchange: null });
+            return origQuery(params);
+          };
+        } catch (_) {}
+        // Canvas fingerprint noise — add imperceptible per-session noise to canvas readback
+        // so each session produces a unique fingerprint (defeats static fingerprint matching)
+        try {
+          const seed = Math.random() * 0xffff | 0;
+          const noisify = (canvas) => {
+            try {
+              const ctx = canvas.getContext('2d');
+              if (!ctx) return;
+              const { width: w, height: h } = canvas;
+              if (w === 0 || h === 0) return;
+              const img = ctx.getImageData(0, 0, w, h);
+              const d = img.data;
+              for (let i = 0; i < d.length; i += 4) {
+                // deterministic per-pixel noise from seed + position
+                d[i] = d[i] ^ ((seed + i) & 1);
+              }
+              ctx.putImageData(img, 0, 0);
+            } catch (_) {}
+          };
+          const origToDataURL = HTMLCanvasElement.prototype.toDataURL;
+          HTMLCanvasElement.prototype.toDataURL = function(...args) {
+            noisify(this);
+            return origToDataURL.apply(this, args);
+          };
+          const origToBlob = HTMLCanvasElement.prototype.toBlob;
+          HTMLCanvasElement.prototype.toBlob = function(...args) {
+            noisify(this);
+            return origToBlob.apply(this, args);
+          };
+        } catch (_) {}
+        // Fix CDP screenX/screenY bug — CDP Input.dispatchMouseEvent sets
+        // screenX=clientX, screenY=clientY which never happens in real browsers.
+        // Cloudflare Turnstile actively checks this. Add a per-session window
+        // offset so screenX/screenY are realistic and internally consistent.
+        try {
+          const winX = Math.floor(Math.random() * 200) + 50;
+          const winY = Math.floor(Math.random() * 100) + 50;
+          const chrome = 85;
+          Object.defineProperty(MouseEvent.prototype, 'screenX', {
+            get() { return this.clientX + winX; },
+            configurable: true,
+          });
+          Object.defineProperty(MouseEvent.prototype, 'screenY', {
+            get() { return this.clientY + winY + chrome; },
+            configurable: true,
+          });
+        } catch (_) {}
+        // navigator.connection — missing in headless, present in real Chrome
+        try {
+          if (!navigator.connection) {
+            Object.defineProperty(navigator, 'connection', {
+              get: () => ({
+                effectiveType: '4g',
+                rtt: 50,
+                downlink: 10,
+                saveData: false,
+                onchange: null,
+              }),
+            });
+          }
+        } catch (_) {}
+        // Notification.permission — default differs in headless
+        try {
+          if (typeof Notification !== 'undefined' && Notification.permission === 'default') {
+            Object.defineProperty(Notification, 'permission', { get: () => 'denied' });
+          }
+        } catch (_) {}
+      `;
+//# sourceMappingURL=stealth-init-script.js.map

package/dist/browser/stealth-init-script.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stealth-init-script.js","sourceRoot":"","sources":["../../src/browser/stealth-init-script.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAuH5B,CAAC"}