@tangle-network/browser-agent-driver 0.6.0

package/dist/index.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @tangle-network/browser-agent-driver
+ *
+ * LLM-driven browser agent for UI automation, testing, and evaluation.
+ * Built on Playwright with accessibility tree observation, planning,
+ * verification, recovery, and trajectory memory.
+ */
+export type { Action, ClickAction, TypeAction, PressAction, HoverAction, SelectAction, EvaluateAction, RunScriptAction, VerifyPreviewAction, ScrollAction, NavigateAction, WaitAction, CompleteAction, AbortAction, PageState, Scenario, AgentConfig, ObservabilityConfig, MicroPlanConfig, SupervisorConfig, SupervisorSignal, SupervisorDirective, Turn, AgentResult, SuccessCriterion, TestCase, TestResult, CriterionResult, TestSuiteResult, Trajectory, TrajectoryStep, DesignFinding, FlowAuditResult, DesignAuditReport, AuditFlow, GoalVerification, PreviewVerification, } from './types.js';
+export type { Driver, ActionResult, ResourceBlockingOptions } from './drivers/types.js';
+export { PlaywrightDriver } from './drivers/playwright.js';
+export type { PlaywrightDriverOptions, ObserveTiming } from './drivers/playwright.js';
+export { AriaSnapshotHelper, StaleRefError, dismissOverlays, stableHash, INTERACTIVE_ROLES } from './drivers/snapshot.js';
+export type { ParsedElement, SnapshotDiff } from './drivers/snapshot.js';
+export { ANALYTICS_PATTERNS, IMAGE_PATTERNS, MEDIA_PATTERNS } from './drivers/block-patterns.js';
+export { buildCdpSnapshot } from './drivers/cdp-snapshot.js';
+export type { CdpSnapshotResult } from './drivers/cdp-snapshot.js';
+export { getPageMetadata } from './drivers/cdp-page-state.js';
+export type { PageMetadata } from './drivers/cdp-page-state.js';
+export { Brain } from './brain/index.js';
+export type { BrainDecision, QualityEvaluation } from './brain/index.js';
+export { AgentRunner, runAgent } from './runner.js';
+export type { RunnerOptions } from './runner.js';
+export { TestRunner } from './test-runner.js';
+export type { TestRunnerOptions } from './test-runner.js';
+export { generateReport, compareReports } from './test-report.js';
+export type { ReportOptions } from './test-report.js';
+export { loadPricing, calculateCost, getModelPricing } from './model-pricing.js';
+export type { ModelPricing } from './model-pricing.js';
+export { verifyPreview } from './preview.js';
+export { DesignAuditor, generateDesignAuditReport } from './design-audit.js';
+export { analyzeRecovery, detectBlockingModal, detectStuck, detectSelectorFailures, detectLoadingState, parseSnapshotElements, } from './recovery.js';
+export { detectSupervisorSignal, formatSupervisorSignal } from './supervisor/policy.js';
+export { requestSupervisorDirective } from './supervisor/critic.js';
+export { ProjectStore } from './memory/project-store.js';
+export { AppKnowledge } from './memory/knowledge.js';
+export type { Fact, KnowledgeData } from './memory/knowledge.js';
+export { SelectorCache } from './memory/selectors.js';
+export type { SelectorEntry } from './memory/selectors.js';
+export { TrajectoryStore } from './memory/store.js';
+export type { TrajectoryStoreOptions } from './memory/store.js';
+export { TrajectoryAnalyzer } from './memory/analyzer.js';
+export type { RunAnalysis, ActionPattern, GoalPattern, TurnWaste } from './memory/analyzer.js';
+export { defineConfig, defineTests, loadConfig, mergeConfig, toAgentConfig } from './config.js';
+export type { DriverConfig } from './config.js';
+export { buildBrowserLaunchPlan } from './browser-launch.js';
+export type { BrowserLaunchPlan, BuildBrowserLaunchPlanOptions } from './browser-launch.js';
+export { DEFAULT_WALLET_ACTION_SELECTORS, DEFAULT_CONNECT_SELECTORS, DEFAULT_CONNECTOR_SELECTORS, DEFAULT_PROMPT_PATHS, resolveWalletExtensionId, startWalletAutoApprover, settleWalletPrompts, runWalletOriginPreflight, runWalletPreflight, } from './wallet/automation.js';
+export type { WalletAutomationOptions, WalletPreflightChainTarget, WalletPreflightOptions, WalletOriginPreflightResult, WalletPreflightResult, } from './wallet/automation.js';
+export { generateJUnitXml } from './reporters/junit.js';
+export { MultiActorSession, Actor } from './multi-actor.js';
+export type { ActorConfig, MultiActorSessionConfig } from './multi-actor.js';
+export { PERSONA_IDS, getPersonaDirective, withPersonaDirective, isPersonaId, listPersonaIds } from './personas.js';
+export type { PersonaId, PersonaDirectiveInput } from './personas.js';
+export type { Artifact, ArtifactSink, ArtifactType, ArtifactManifestEntry, ProgressEvent, } from './artifacts/types.js';
+export { FilesystemSink } from './artifacts/filesystem-sink.js';
+export { CompositeSink } from './artifacts/composite-sink.js';
+export { WebhookSink } from './artifacts/webhook-sink.js';
+export type { WebhookSinkOptions, WebhookPayload } from './artifacts/webhook-sink.js';
+export { slackFormatter } from './formatters/slack.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -0,0 +1,53 @@
+/**
+ * @tangle-network/browser-agent-driver
+ *
+ * LLM-driven browser agent for UI automation, testing, and evaluation.
+ * Built on Playwright with accessibility tree observation, planning,
+ * verification, recovery, and trajectory memory.
+ */
+export { PlaywrightDriver } from './drivers/playwright.js';
+export { AriaSnapshotHelper, StaleRefError, dismissOverlays, stableHash, INTERACTIVE_ROLES } from './drivers/snapshot.js';
+export { ANALYTICS_PATTERNS, IMAGE_PATTERNS, MEDIA_PATTERNS } from './drivers/block-patterns.js';
+export { buildCdpSnapshot } from './drivers/cdp-snapshot.js';
+export { getPageMetadata } from './drivers/cdp-page-state.js';
+// Brain (LLM decision engine)
+export { Brain } from './brain/index.js';
+// Agent runner (core observe -> decide -> execute loop)
+export { AgentRunner, runAgent } from './runner.js';
+// Test runner (suite orchestration, verification, parallelism)
+export { TestRunner } from './test-runner.js';
+export { generateReport, compareReports } from './test-report.js';
+// Model pricing (LiteLLM-backed cost calculation)
+export { loadPricing, calculateCost, getModelPricing } from './model-pricing.js';
+// Preview verification
+export { verifyPreview } from './preview.js';
+// Design audit
+export { DesignAuditor, generateDesignAuditReport } from './design-audit.js';
+// Recovery
+export { analyzeRecovery, detectBlockingModal, detectStuck, detectSelectorFailures, detectLoadingState, parseSnapshotElements, } from './recovery.js';
+// Supervisor
+export { detectSupervisorSignal, formatSupervisorSignal } from './supervisor/policy.js';
+export { requestSupervisorDirective } from './supervisor/critic.js';
+// Memory system
+export { ProjectStore } from './memory/project-store.js';
+export { AppKnowledge } from './memory/knowledge.js';
+export { SelectorCache } from './memory/selectors.js';
+export { TrajectoryStore } from './memory/store.js';
+export { TrajectoryAnalyzer } from './memory/analyzer.js';
+// Configuration
+export { defineConfig, defineTests, loadConfig, mergeConfig, toAgentConfig } from './config.js';
+export { buildBrowserLaunchPlan } from './browser-launch.js';
+// Wallet automation helpers
+export { DEFAULT_WALLET_ACTION_SELECTORS, DEFAULT_CONNECT_SELECTORS, DEFAULT_CONNECTOR_SELECTORS, DEFAULT_PROMPT_PATHS, resolveWalletExtensionId, startWalletAutoApprover, settleWalletPrompts, runWalletOriginPreflight, runWalletPreflight, } from './wallet/automation.js';
+// JUnit reporter
+export { generateJUnitXml } from './reporters/junit.js';
+// Multi-actor sessions (coordinated multi-user browser testing)
+export { MultiActorSession, Actor } from './multi-actor.js';
+// Persona directives
+export { PERSONA_IDS, getPersonaDirective, withPersonaDirective, isPersonaId, listPersonaIds } from './personas.js';
+export { FilesystemSink } from './artifacts/filesystem-sink.js';
+export { CompositeSink } from './artifacts/composite-sink.js';
+export { WebhookSink } from './artifacts/webhook-sink.js';
+// Payload formatters (for WebhookSink.formatPayload)
+export { slackFormatter } from './formatters/slack.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AA6CH,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAE3D,OAAO,EAAE,kBAAkB,EAAE,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAE1H,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AACjG,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAE7D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAG9D,8BAA8B;AAC9B,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAGzC,wDAAwD;AACxD,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGpD,+DAA+D;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAGlE,kDAAkD;AAClD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAGjF,uBAAuB;AACvB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,eAAe;AACf,OAAO,EAAE,aAAa,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAE7E,WAAW;AACX,OAAO,EACL,eAAe,EACf,mBAAmB,EACnB,WAAW,EACX,sBAAsB,EACtB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,eAAe,CAAC;AAEvB,aAAa;AACb,OAAO,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AACxF,OAAO,EAAE,0BAA0B,EAAE,MAAM,wBAAwB,CAAC;AAEpE,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAErD,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAG1D,gBAAgB;AAChB,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEhG,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,4BAA4B;AAC5B,OAAO,EACL,+BAA+B,EAC/B,yBAAyB,EACzB,2BAA2B,EAC3B,oBAAoB,EACpB,wBAAwB,EACxB,uBAAuB,EACvB,mBAAmB,EACnB,wBAAwB,EACxB,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAShC,iBAAiB;AACjB,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD,gEAAgE;AAChE,OAAO,EAAE,iBAAiB,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAG5D,qBAAqB;AACrB,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,oBAAoB,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAWpH,OAAO,EAAE,cAAc,EAAE,MAAM,gCAAgC,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAG1D,qDAAqD;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/memory/analyzer.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Trajectory Analyzer — extracts failure patterns and optimization hints from test runs.
+ *
+ * Examines TestSuiteResult traces to identify:
+ * - Wasted turns (errors, retries, repeated actions, stuck loops)
+ * - Failure patterns (which selectors, action types, and goals fail)
+ * - Verification gaps (agent says success, ground-truth says failure)
+ * - Turn efficiency (how many turns are productive vs wasted)
+ *
+ * Produces RunAnalysis with structured findings and generateHints() for
+ * injecting optimization context into the Brain's system prompt.
+ */
+import type { TestSuiteResult } from '../types.js';
+export interface ActionPattern {
+    action: string;
+    selector?: string;
+    occurrences: number;
+    failures: number;
+    failureRate: number;
+}
+export interface GoalPattern {
+    goalPrefix: string;
+    attempts: number;
+    successes: number;
+    avgTurns: number;
+    avgDurationMs: number;
+    commonFailures: string[];
+}
+export interface TurnWaste {
+    category: 'stale-ref' | 'repeated-action' | 'stuck-loop' | 'error' | 'unnecessary-wait';
+    turnNumbers: number[];
+    description: string;
+}
+export interface RunAnalysis {
+    timestamp: string;
+    suiteModel: string;
+    totalTests: number;
+    passRate: number;
+    turnEfficiency: {
+        totalTurns: number;
+        productiveTurns: number;
+        wastedTurns: number;
+        efficiencyRate: number;
+    };
+    verificationGaps: {
+        agentSaysSuccess: number;
+        groundTruthConfirms: number;
+        falsePositiveRate: number;
+    };
+    actionPatterns: ActionPattern[];
+    goalPatterns: GoalPattern[];
+    wasteBreakdown: TurnWaste[];
+    topFailureReasons: string[];
+}
+export declare class TrajectoryAnalyzer {
+    analyze(suite: TestSuiteResult): RunAnalysis;
+    generateHints(analysis: RunAnalysis): string;
+    private analyzeTurnEfficiency;
+    private isWastedTurn;
+    private analyzeVerificationGaps;
+    private analyzeActionPatterns;
+    private analyzeGoalPatterns;
+    private analyzeWaste;
+    private extractFailureReasons;
+    private actionKey;
+}
+//# sourceMappingURL=analyzer.d.ts.map

package/dist/memory/analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyzer.d.ts","sourceRoot":"","sources":["../../src/memory/analyzer.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,eAAe,EAA4B,MAAM,aAAa,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,WAAW,GAAG,iBAAiB,GAAG,YAAY,GAAG,OAAO,GAAG,kBAAkB,CAAC;IACxF,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC1B,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IAEjB,cAAc,EAAE;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,eAAe,EAAE,MAAM,CAAC;QACxB,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,EAAE,MAAM,CAAC;KACxB,CAAC;IAEF,gBAAgB,EAAE;QAChB,gBAAgB,EAAE,MAAM,CAAC;QACzB,mBAAmB,EAAE,MAAM,CAAC;QAC5B,iBAAiB,EAAE,MAAM,CAAC;KAC3B,CAAC;IAEF,cAAc,EAAE,aAAa,EAAE,CAAC;IAChC,YAAY,EAAE,WAAW,EAAE,CAAC;IAC5B,cAAc,EAAE,SAAS,EAAE,CAAC;IAC5B,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,KAAK,EAAE,eAAe,GAAG,WAAW;IAwB5C,aAAa,CAAC,QAAQ,EAAE,WAAW,GAAG,MAAM;IA0E5C,OAAO,CAAC,qBAAqB;IAwB7B,OAAO,CAAC,YAAY;IAOpB,OAAO,CAAC,uBAAuB;IAa/B,OAAO,CAAC,qBAAqB;IA6B7B,OAAO,CAAC,mBAAmB;IA6B3B,OAAO,CAAC,YAAY;IAgDpB,OAAO,CAAC,qBAAqB;IA2B7B,OAAO,CAAC,SAAS;CAgBlB"}

package/dist/memory/analyzer.js

@@ -0,0 +1,265 @@
+/**
+ * Trajectory Analyzer — extracts failure patterns and optimization hints from test runs.
+ *
+ * Examines TestSuiteResult traces to identify:
+ * - Wasted turns (errors, retries, repeated actions, stuck loops)
+ * - Failure patterns (which selectors, action types, and goals fail)
+ * - Verification gaps (agent says success, ground-truth says failure)
+ * - Turn efficiency (how many turns are productive vs wasted)
+ *
+ * Produces RunAnalysis with structured findings and generateHints() for
+ * injecting optimization context into the Brain's system prompt.
+ */
+export class TrajectoryAnalyzer {
+    analyze(suite) {
+        const nonSkipped = suite.results.filter(r => !r.skipped);
+        const turnEfficiency = this.analyzeTurnEfficiency(nonSkipped);
+        const verificationGaps = this.analyzeVerificationGaps(nonSkipped);
+        const actionPatterns = this.analyzeActionPatterns(nonSkipped);
+        const goalPatterns = this.analyzeGoalPatterns(nonSkipped);
+        const wasteBreakdown = this.analyzeWaste(nonSkipped);
+        const topFailureReasons = this.extractFailureReasons(nonSkipped);
+        return {
+            timestamp: new Date().toISOString(),
+            suiteModel: suite.model,
+            totalTests: suite.results.length,
+            passRate: suite.summary.passRate,
+            turnEfficiency,
+            verificationGaps,
+            actionPatterns,
+            goalPatterns,
+            wasteBreakdown,
+            topFailureReasons,
+        };
+    }
+    generateHints(analysis) {
+        const hints = [];
+        // Turn efficiency hints
+        if (analysis.turnEfficiency.efficiencyRate < 0.7) {
+            hints.push(`EFFICIENCY WARNING: Only ${(analysis.turnEfficiency.efficiencyRate * 100).toFixed(0)}% of turns are productive. ` +
+                `${analysis.turnEfficiency.wastedTurns} turns were wasted on errors, retries, or repeated actions.`);
+        }
+        // Verification gap hints
+        if (analysis.verificationGaps.falsePositiveRate > 0.1) {
+            hints.push(`ACCURACY WARNING: The agent reports success ${(analysis.verificationGaps.falsePositiveRate * 100).toFixed(0)}% more often than ground-truth confirms. ` +
+                `Be more conservative with "complete" — verify the goal state thoroughly before completing.`);
+        }
+        // Action pattern hints
+        const highFailureActions = analysis.actionPatterns
+            .filter(p => p.failureRate > 0.3 && p.occurrences >= 3)
+            .sort((a, b) => b.failureRate - a.failureRate);
+        if (highFailureActions.length > 0) {
+            const actionHints = highFailureActions
+                .slice(0, 3)
+                .map(p => {
+                const selector = p.selector ? ` on "${p.selector}"` : '';
+                return `"${p.action}"${selector} fails ${(p.failureRate * 100).toFixed(0)}% of the time (${p.failures}/${p.occurrences})`;
+            });
+            hints.push(`HIGH-FAILURE ACTIONS: ${actionHints.join('; ')}. Try alternative approaches.`);
+        }
+        // Waste pattern hints
+        const staleRefWaste = analysis.wasteBreakdown.filter(w => w.category === 'stale-ref');
+        if (staleRefWaste.length > 0) {
+            const totalStaleRefs = staleRefWaste.reduce((sum, w) => sum + w.turnNumbers.length, 0);
+            hints.push(`STALE REFS: ${totalStaleRefs} turns wasted on stale @ref selectors. ` +
+                `Always use refs from the CURRENT observation, not previous turns.`);
+        }
+        const stuckWaste = analysis.wasteBreakdown.filter(w => w.category === 'stuck-loop');
+        if (stuckWaste.length > 0) {
+            hints.push(`STUCK LOOPS DETECTED: The agent repeated the same action sequence ${stuckWaste.length} time(s). ` +
+                `When an action doesn't produce the expected effect after 2 attempts, try a completely different strategy.`);
+        }
+        // Goal-specific hints
+        const slowGoals = analysis.goalPatterns
+            .filter(p => p.avgTurns > 15 && p.attempts >= 2)
+            .sort((a, b) => b.avgTurns - a.avgTurns);
+        if (slowGoals.length > 0) {
+            const goalHints = slowGoals
+                .slice(0, 2)
+                .map(p => `"${p.goalPrefix}" averages ${p.avgTurns.toFixed(0)} turns`);
+            hints.push(`SLOW GOALS: ${goalHints.join('; ')}. Consider more direct navigation strategies.`);
+        }
+        // Top failure reasons
+        if (analysis.topFailureReasons.length > 0) {
+            hints.push(`COMMON FAILURES: ${analysis.topFailureReasons.slice(0, 3).join('; ')}`);
+        }
+        if (hints.length === 0)
+            return '';
+        return `FEEDBACK FROM PREVIOUS RUNS:\n${hints.map(h => `- ${h}`).join('\n')}`;
+    }
+    analyzeTurnEfficiency(results) {
+        let totalTurns = 0;
+        let wastedTurns = 0;
+        for (const r of results) {
+            const turns = r.agentResult.turns;
+            totalTurns += turns.length;
+            for (const turn of turns) {
+                if (this.isWastedTurn(turn)) {
+                    wastedTurns++;
+                }
+            }
+        }
+        const productiveTurns = totalTurns - wastedTurns;
+        return {
+            totalTurns,
+            productiveTurns,
+            wastedTurns,
+            efficiencyRate: totalTurns > 0 ? productiveTurns / totalTurns : 1,
+        };
+    }
+    isWastedTurn(turn) {
+        if (turn.error)
+            return true;
+        if (turn.action.action === 'wait' && 'ms' in turn.action && turn.action.ms === 0)
+            return true;
+        if (turn.verificationFailure)
+            return true;
+        return false;
+    }
+    analyzeVerificationGaps(results) {
+        const agentSaysSuccess = results.filter(r => r.agentSuccess).length;
+        const groundTruthConfirms = results.filter(r => r.agentSuccess && r.verified).length;
+        return {
+            agentSaysSuccess,
+            groundTruthConfirms,
+            falsePositiveRate: agentSaysSuccess > 0
+                ? (agentSaysSuccess - groundTruthConfirms) / agentSaysSuccess
+                : 0,
+        };
+    }
+    analyzeActionPatterns(results) {
+        const patternMap = new Map();
+        for (const r of results) {
+            for (const turn of r.agentResult.turns) {
+                const action = turn.action;
+                const selector = 'selector' in action ? String(action.selector) : undefined;
+                const key = `${action.action}:${selector || '*'}`;
+                const existing = patternMap.get(key) || { occurrences: 0, failures: 0, selector };
+                existing.occurrences++;
+                if (turn.error || turn.verificationFailure) {
+                    existing.failures++;
+                }
+                patternMap.set(key, existing);
+            }
+        }
+        return [...patternMap.entries()]
+            .map(([_key, v]) => ({
+            action: _key.split(':')[0],
+            selector: v.selector,
+            occurrences: v.occurrences,
+            failures: v.failures,
+            failureRate: v.occurrences > 0 ? v.failures / v.occurrences : 0,
+        }))
+            .sort((a, b) => b.occurrences - a.occurrences);
+    }
+    analyzeGoalPatterns(results) {
+        const goalMap = new Map();
+        for (const r of results) {
+            const prefix = r.testCase.goal.split('\n')[0].slice(0, 80);
+            const existing = goalMap.get(prefix) || {
+                attempts: 0, successes: 0, turns: [], durations: [], failures: [],
+            };
+            existing.attempts++;
+            if (r.verified)
+                existing.successes++;
+            existing.turns.push(r.turnsUsed);
+            existing.durations.push(r.durationMs);
+            if (!r.verified && r.verdict) {
+                existing.failures.push(r.verdict);
+            }
+            goalMap.set(prefix, existing);
+        }
+        return [...goalMap.entries()].map(([goalPrefix, v]) => ({
+            goalPrefix,
+            attempts: v.attempts,
+            successes: v.successes,
+            avgTurns: v.turns.reduce((a, b) => a + b, 0) / v.turns.length,
+            avgDurationMs: v.durations.reduce((a, b) => a + b, 0) / v.durations.length,
+            commonFailures: v.failures,
+        }));
+    }
+    analyzeWaste(results) {
+        const waste = [];
+        for (const r of results) {
+            const turns = r.agentResult.turns;
+            // Detect stale ref errors
+            const staleRefTurns = turns
+                .filter(t => t.error?.includes('Stale ref'))
+                .map(t => t.turn);
+            if (staleRefTurns.length > 0) {
+                waste.push({
+                    category: 'stale-ref',
+                    turnNumbers: staleRefTurns,
+                    description: `${r.testCase.name}: ${staleRefTurns.length} stale ref errors`,
+                });
+            }
+            // Detect stuck loops (same action repeated 3+ times consecutively)
+            for (let i = 2; i < turns.length; i++) {
+                const a1 = this.actionKey(turns[i - 2].action);
+                const a2 = this.actionKey(turns[i - 1].action);
+                const a3 = this.actionKey(turns[i].action);
+                if (a1 === a2 && a2 === a3) {
+                    waste.push({
+                        category: 'stuck-loop',
+                        turnNumbers: [turns[i - 2].turn, turns[i - 1].turn, turns[i].turn],
+                        description: `${r.testCase.name}: repeated "${a1}" at turns ${turns[i - 2].turn}-${turns[i].turn}`,
+                    });
+                }
+            }
+            // Detect error turns
+            const errorTurns = turns
+                .filter(t => t.error && !t.error.includes('Stale ref'))
+                .map(t => t.turn);
+            if (errorTurns.length > 0) {
+                waste.push({
+                    category: 'error',
+                    turnNumbers: errorTurns,
+                    description: `${r.testCase.name}: ${errorTurns.length} execution errors`,
+                });
+            }
+        }
+        return waste;
+    }
+    extractFailureReasons(results) {
+        const reasons = [];
+        for (const r of results) {
+            if (!r.verified && !r.skipped) {
+                if (r.criteriaResults) {
+                    for (const cr of r.criteriaResults) {
+                        if (!cr.passed && cr.detail) {
+                            reasons.push(cr.detail);
+                        }
+                    }
+                }
+                else if (r.verdict) {
+                    reasons.push(r.verdict);
+                }
+            }
+        }
+        // Deduplicate and return top reasons
+        const counts = new Map();
+        for (const reason of reasons) {
+            counts.set(reason, (counts.get(reason) || 0) + 1);
+        }
+        return [...counts.entries()]
+            .sort((a, b) => b[1] - a[1])
+            .map(([reason]) => reason);
+    }
+    actionKey(action) {
+        switch (action.action) {
+            case 'click':
+                return `click:${action.selector}`;
+            case 'type':
+                return `type:${action.selector}`;
+            case 'press':
+                return `press:${action.selector}:${action.key}`;
+            case 'scroll':
+                return `scroll:${action.direction}`;
+            case 'navigate':
+                return `navigate:${action.url}`;
+            default:
+                return action.action;
+        }
+    }
+}
+//# sourceMappingURL=analyzer.js.map

package/dist/memory/analyzer.js.map

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

package/dist/memory/knowledge.d.ts

@@ -0,0 +1,55 @@
+/**
+ * App Knowledge — domain-scoped fact accumulation with confidence scoring.
+ *
+ * Stores structured facts the agent discovers about a specific application,
+ * persisted across runs. Facts have confidence scores that increase with
+ * repeated confirmation and decay when contradicted.
+ *
+ * Fact types:
+ * - timing: wait durations, animation timings, load times
+ * - selector: reliable selectors for specific elements
+ * - pattern: multi-step interaction patterns (auth flows, navigation)
+ * - quirk: app-specific behaviors (shadow DOM, lazy loading, etc.)
+ */
+export interface Fact {
+    type: 'timing' | 'selector' | 'pattern' | 'quirk';
+    key: string;
+    value: string;
+    confidence: number;
+    sources: number;
+    lastSeen: string;
+}
+export interface KnowledgeData {
+    domain: string;
+    facts: Fact[];
+    updatedAt: string;
+}
+export declare class AppKnowledge {
+    private path;
+    private data;
+    constructor(path: string, domain: string);
+    /** Get all facts with confidence above threshold */
+    getFacts(minConfidence?: number): Fact[];
+    /** Get facts of a specific type */
+    getFactsByType(type: Fact['type'], minConfidence?: number): Fact[];
+    /** Look up a specific fact by type and key */
+    getFact(type: Fact['type'], key: string): Fact | undefined;
+    /**
+     * Record a fact. If a matching fact exists:
+     * - Same value: boost confidence and increment sources
+     * - Different value: decay old fact's confidence, add new fact
+     */
+    recordFact(type: Fact['type'], key: string, value: string): void;
+    /** Merge multiple facts at once (e.g., from LLM extraction) */
+    recordFacts(facts: Array<{
+        type: Fact['type'];
+        key: string;
+        value: string;
+    }>): void;
+    /** Format knowledge for injection into brain context */
+    formatForBrain(): string;
+    /** Persist to disk */
+    save(): void;
+    private load;
+}
+//# sourceMappingURL=knowledge.d.ts.map

package/dist/memory/knowledge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"knowledge.d.ts","sourceRoot":"","sources":["../../src/memory/knowledge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAC;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,IAAI,EAAE,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAgB;gBAEhB,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAKxC,oDAAoD;IACpD,QAAQ,CAAC,aAAa,SAAM,GAAG,IAAI,EAAE;IAIrC,mCAAmC;IACnC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,aAAa,SAAM,GAAG,IAAI,EAAE;IAI/D,8CAA8C;IAC9C,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAI1D;;;;OAIG;IACH,UAAU,CAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI;IAkChE,+DAA+D;IAC/D,WAAW,CAAC,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI;IAMnF,wDAAwD;IACxD,cAAc,IAAI,MAAM;IAwBxB,sBAAsB;IACtB,IAAI,IAAI,IAAI;IAIZ,OAAO,CAAC,IAAI;CAUb"}