@tangle-network/browser-agent-driver 0.6.0

package/dist/memory/knowledge.js

@@ -0,0 +1,115 @@
+/**
+ * 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.)
+ */
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+export class AppKnowledge {
+    path;
+    data;
+    constructor(path, domain) {
+        this.path = path;
+        this.data = this.load(domain);
+    }
+    /** Get all facts with confidence above threshold */
+    getFacts(minConfidence = 0.3) {
+        return this.data.facts.filter(f => f.confidence >= minConfidence);
+    }
+    /** Get facts of a specific type */
+    getFactsByType(type, minConfidence = 0.3) {
+        return this.data.facts.filter(f => f.type === type && f.confidence >= minConfidence);
+    }
+    /** Look up a specific fact by type and key */
+    getFact(type, key) {
+        return this.data.facts.find(f => f.type === type && f.key === key);
+    }
+    /**
+     * 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, key, value) {
+        const existing = this.data.facts.find(f => f.type === type && f.key === key);
+        const now = new Date().toISOString();
+        if (existing) {
+            if (existing.value === value) {
+                // Confirm — boost confidence (asymptotic toward 1.0)
+                existing.confidence = Math.min(1.0, existing.confidence + (1 - existing.confidence) * 0.2);
+                existing.sources++;
+                existing.lastSeen = now;
+            }
+            else {
+                // Contradict — decay old, add new
+                existing.confidence *= 0.5;
+                this.data.facts.push({
+                    type, key, value,
+                    confidence: 0.6,
+                    sources: 1,
+                    lastSeen: now,
+                });
+            }
+        }
+        else {
+            this.data.facts.push({
+                type, key, value,
+                confidence: 0.6,
+                sources: 1,
+                lastSeen: now,
+            });
+        }
+        // Prune low-confidence facts
+        this.data.facts = this.data.facts.filter(f => f.confidence >= 0.1);
+        this.data.updatedAt = now;
+    }
+    /** Merge multiple facts at once (e.g., from LLM extraction) */
+    recordFacts(facts) {
+        for (const f of facts) {
+            this.recordFact(f.type, f.key, f.value);
+        }
+    }
+    /** Format knowledge for injection into brain context */
+    formatForBrain() {
+        const facts = this.getFacts(0.5); // Only high-confidence facts
+        if (facts.length === 0)
+            return '';
+        const grouped = new Map();
+        for (const f of facts) {
+            const group = grouped.get(f.type) || [];
+            group.push(f);
+            grouped.set(f.type, group);
+        }
+        const lines = ['APP KNOWLEDGE (learned from previous runs):'];
+        for (const [type, typeFacts] of grouped) {
+            lines.push(`  ${type.toUpperCase()}:`);
+            for (const f of typeFacts.sort((a, b) => b.confidence - a.confidence)) {
+                const conf = (f.confidence * 100).toFixed(0);
+                lines.push(`    - ${f.key}: ${f.value} (${conf}% confidence, ${f.sources} observations)`);
+            }
+        }
+        return lines.join('\n');
+    }
+    /** Persist to disk */
+    save() {
+        writeFileSync(this.path, JSON.stringify(this.data, null, 2));
+    }
+    load(domain) {
+        if (existsSync(this.path)) {
+            try {
+                return JSON.parse(readFileSync(this.path, 'utf-8'));
+            }
+            catch {
+                // Corrupted file — start fresh
+            }
+        }
+        return { domain, facts: [], updatedAt: new Date().toISOString() };
+    }
+}
+//# sourceMappingURL=knowledge.js.map

package/dist/memory/knowledge.js.map

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

package/dist/memory/project-store.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Project Memory Store — manages the `.agent-memory/` directory layout.
+ *
+ * Provides domain-scoped storage for knowledge, selectors, and trajectories.
+ * The directory is git-committable and accumulates learning across runs.
+ *
+ * Layout:
+ *   .agent-memory/
+ *   ├── domains/
+ *   │   └── localhost_5173/          # sanitized origin
+ *   │       ├── knowledge.json       # accumulated facts about this app
+ *   │       ├── selectors.json       # element → best selector mappings
+ *   │       └── trajectories/        # successful run recordings
+ *   │           └── traj_*.json
+ *   ├── hints.json                   # cross-domain optimization hints
+ *   └── runs/
+ *       └── run_*.json               # suite result summaries
+ */
+import type { TestSuiteResult } from '../types.js';
+export declare class ProjectStore {
+    private root;
+    constructor(root?: string);
+    /** Get the root directory path */
+    getRoot(): string;
+    /** Get the domain directory for a given URL origin */
+    getDomainDir(url: string): string;
+    /** Get the trajectory store path for a domain */
+    getTrajectoryDir(url: string): string;
+    /** Get the knowledge file path for a domain */
+    getKnowledgePath(url: string): string;
+    /** Get the selector cache file path for a domain */
+    getSelectorCachePath(url: string): string;
+    /** Get the cross-domain hints file path */
+    getHintsPath(): string;
+    /** Save cross-domain optimization hints */
+    saveHints(hints: string): void;
+    /** Load cross-domain optimization hints */
+    loadHints(): string | null;
+    /** Save a run summary (lightweight — just metrics, no full traces) */
+    saveRunSummary(suite: TestSuiteResult): void;
+    private ensureDir;
+}
+//# sourceMappingURL=project-store.d.ts.map

package/dist/memory/project-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-store.d.ts","sourceRoot":"","sources":["../../src/memory/project-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAIH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,qBAAa,YAAY;IACvB,OAAO,CAAC,IAAI,CAAS;gBAET,IAAI,CAAC,EAAE,MAAM;IAOzB,kCAAkC;IAClC,OAAO,IAAI,MAAM;IAIjB,sDAAsD;IACtD,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAOjC,iDAAiD;IACjD,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAMrC,+CAA+C;IAC/C,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIrC,oDAAoD;IACpD,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAIzC,2CAA2C;IAC3C,YAAY,IAAI,MAAM;IAItB,2CAA2C;IAC3C,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAI9B,2CAA2C;IAC3C,SAAS,IAAI,MAAM,GAAG,IAAI;IAW1B,sEAAsE;IACtE,cAAc,CAAC,KAAK,EAAE,eAAe,GAAG,IAAI;IA4B5C,OAAO,CAAC,SAAS;CAKlB"}

package/dist/memory/project-store.js

@@ -0,0 +1,119 @@
+/**
+ * Project Memory Store — manages the `.agent-memory/` directory layout.
+ *
+ * Provides domain-scoped storage for knowledge, selectors, and trajectories.
+ * The directory is git-committable and accumulates learning across runs.
+ *
+ * Layout:
+ *   .agent-memory/
+ *   ├── domains/
+ *   │   └── localhost_5173/          # sanitized origin
+ *   │       ├── knowledge.json       # accumulated facts about this app
+ *   │       ├── selectors.json       # element → best selector mappings
+ *   │       └── trajectories/        # successful run recordings
+ *   │           └── traj_*.json
+ *   ├── hints.json                   # cross-domain optimization hints
+ *   └── runs/
+ *       └── run_*.json               # suite result summaries
+ */
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'fs';
+import { join } from 'path';
+export class ProjectStore {
+    root;
+    constructor(root) {
+        this.root = root || join(process.cwd(), '.agent-memory');
+        this.ensureDir(this.root);
+        this.ensureDir(join(this.root, 'domains'));
+        this.ensureDir(join(this.root, 'runs'));
+    }
+    /** Get the root directory path */
+    getRoot() {
+        return this.root;
+    }
+    /** Get the domain directory for a given URL origin */
+    getDomainDir(url) {
+        const domain = sanitizeDomain(url);
+        const dir = join(this.root, 'domains', domain);
+        this.ensureDir(dir);
+        return dir;
+    }
+    /** Get the trajectory store path for a domain */
+    getTrajectoryDir(url) {
+        const dir = join(this.getDomainDir(url), 'trajectories');
+        this.ensureDir(dir);
+        return dir;
+    }
+    /** Get the knowledge file path for a domain */
+    getKnowledgePath(url) {
+        return join(this.getDomainDir(url), 'knowledge.json');
+    }
+    /** Get the selector cache file path for a domain */
+    getSelectorCachePath(url) {
+        return join(this.getDomainDir(url), 'selectors.json');
+    }
+    /** Get the cross-domain hints file path */
+    getHintsPath() {
+        return join(this.root, 'hints.json');
+    }
+    /** Save cross-domain optimization hints */
+    saveHints(hints) {
+        writeFileSync(this.getHintsPath(), JSON.stringify({ hints, updatedAt: new Date().toISOString() }, null, 2));
+    }
+    /** Load cross-domain optimization hints */
+    loadHints() {
+        const path = this.getHintsPath();
+        if (!existsSync(path))
+            return null;
+        try {
+            const data = JSON.parse(readFileSync(path, 'utf-8'));
+            return data.hints || null;
+        }
+        catch {
+            return null;
+        }
+    }
+    /** Save a run summary (lightweight — just metrics, no full traces) */
+    saveRunSummary(suite) {
+        const id = `run_${Date.now()}_${Math.random().toString(36).slice(2, 6)}`;
+        const summary = {
+            id,
+            model: suite.model,
+            timestamp: suite.timestamp,
+            total: suite.summary.total,
+            passed: suite.summary.passed,
+            failed: suite.summary.failed,
+            passRate: suite.summary.passRate,
+            avgTurns: suite.summary.avgTurns,
+            avgDurationMs: suite.summary.avgDurationMs,
+            totalDurationMs: suite.summary.totalDurationMs,
+            tests: suite.results.map(r => ({
+                id: r.testCase.id,
+                name: r.testCase.name,
+                verified: r.verified,
+                turnsUsed: r.turnsUsed,
+                durationMs: r.durationMs,
+            })),
+        };
+        writeFileSync(join(this.root, 'runs', `${id}.json`), JSON.stringify(summary, null, 2));
+    }
+    ensureDir(dir) {
+        if (!existsSync(dir)) {
+            mkdirSync(dir, { recursive: true });
+        }
+    }
+}
+/**
+ * Sanitize a URL into a filesystem-safe domain key.
+ * "http://localhost:5173/foo/bar" → "localhost_5173"
+ */
+function sanitizeDomain(url) {
+    try {
+        const parsed = new URL(url);
+        return parsed.host.replace(/[^a-zA-Z0-9.-]/g, '_');
+    }
+    catch {
+        // Fallback: extract something useful from the string
+        return url.replace(/[^a-zA-Z0-9.-]/g, '_').slice(0, 50) || 'unknown';
+    }
+}
+//# sourceMappingURL=project-store.js.map

package/dist/memory/project-store.js.map

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

package/dist/memory/selectors.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Selector Cache — maps element identities to their best-known selectors.
+ *
+ * After each successful action, records which selector worked for a given
+ * element (identified by role+name from the a11y tree). On future runs,
+ * known-good selectors are injected into the brain context so the agent
+ * can skip trial-and-error.
+ *
+ * Each entry tracks:
+ * - The last successful @ref (changes between page loads)
+ * - The best stable selector (data-testid, aria-label, etc.)
+ * - Success count and last used timestamp
+ */
+export interface SelectorEntry {
+    /** Element identity from a11y tree (e.g., 'button "Send"') */
+    element: string;
+    /** Last known @ref ID (volatile — changes between sessions) */
+    lastRef?: string;
+    /** Best stable selector (data-testid, aria-label, etc.) */
+    stableSelector?: string;
+    /** Number of successful uses */
+    successCount: number;
+    /** Last successful use */
+    lastUsed: string;
+}
+export interface SelectorCacheData {
+    entries: Record<string, SelectorEntry>;
+    updatedAt: string;
+}
+export declare class SelectorCache {
+    private path;
+    private data;
+    constructor(path: string);
+    /** Record a successful selector use */
+    recordSuccess(element: string, selector: string): void;
+    /** Look up the best known selector for an element */
+    lookup(element: string): SelectorEntry | undefined;
+    /** Get all entries sorted by success count (most reliable first) */
+    getAll(): SelectorEntry[];
+    /** Get the most reliable selectors (high success count) for brain context */
+    formatForBrain(limit?: number): string;
+    /** Persist to disk */
+    save(): void;
+    private load;
+}
+//# sourceMappingURL=selectors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"selectors.d.ts","sourceRoot":"","sources":["../../src/memory/selectors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAIH,MAAM,WAAW,aAAa;IAC5B,8DAA8D;IAC9D,OAAO,EAAE,MAAM,CAAC;IAChB,+DAA+D;IAC/D,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,2DAA2D;IAC3D,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gCAAgC;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,0BAA0B;IAC1B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;IACvC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,IAAI,CAAoB;gBAEpB,IAAI,EAAE,MAAM;IAKxB,uCAAuC;IACvC,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI;IA6BtD,qDAAqD;IACrD,MAAM,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS;IAIlD,oEAAoE;IACpE,MAAM,IAAI,aAAa,EAAE;IAKzB,6EAA6E;IAC7E,cAAc,CAAC,KAAK,SAAK,GAAG,MAAM;IAYlC,sBAAsB;IACtB,IAAI,IAAI,IAAI;IAIZ,OAAO,CAAC,IAAI;CAUb"}

package/dist/memory/selectors.js

@@ -0,0 +1,89 @@
+/**
+ * Selector Cache — maps element identities to their best-known selectors.
+ *
+ * After each successful action, records which selector worked for a given
+ * element (identified by role+name from the a11y tree). On future runs,
+ * known-good selectors are injected into the brain context so the agent
+ * can skip trial-and-error.
+ *
+ * Each entry tracks:
+ * - The last successful @ref (changes between page loads)
+ * - The best stable selector (data-testid, aria-label, etc.)
+ * - Success count and last used timestamp
+ */
+import { existsSync, readFileSync, writeFileSync } from 'fs';
+export class SelectorCache {
+    path;
+    data;
+    constructor(path) {
+        this.path = path;
+        this.data = this.load();
+    }
+    /** Record a successful selector use */
+    recordSuccess(element, selector) {
+        const now = new Date().toISOString();
+        const existing = this.data.entries[element];
+        if (existing) {
+            existing.successCount++;
+            existing.lastUsed = now;
+            if (selector.startsWith('@')) {
+                existing.lastRef = selector;
+            }
+            else {
+                existing.stableSelector = selector;
+            }
+        }
+        else {
+            const entry = {
+                element,
+                successCount: 1,
+                lastUsed: now,
+            };
+            if (selector.startsWith('@')) {
+                entry.lastRef = selector;
+            }
+            else {
+                entry.stableSelector = selector;
+            }
+            this.data.entries[element] = entry;
+        }
+        this.data.updatedAt = now;
+    }
+    /** Look up the best known selector for an element */
+    lookup(element) {
+        return this.data.entries[element];
+    }
+    /** Get all entries sorted by success count (most reliable first) */
+    getAll() {
+        return Object.values(this.data.entries)
+            .sort((a, b) => b.successCount - a.successCount);
+    }
+    /** Get the most reliable selectors (high success count) for brain context */
+    formatForBrain(limit = 20) {
+        const entries = this.getAll().slice(0, limit);
+        if (entries.length === 0)
+            return '';
+        const lines = ['KNOWN SELECTORS (from previous runs):'];
+        for (const e of entries) {
+            const selector = e.stableSelector || e.lastRef || '(unknown)';
+            lines.push(`  - ${e.element} → ${selector} (used ${e.successCount}x)`);
+        }
+        return lines.join('\n');
+    }
+    /** Persist to disk */
+    save() {
+        writeFileSync(this.path, JSON.stringify(this.data, null, 2));
+    }
+    load() {
+        if (existsSync(this.path)) {
+            try {
+                return JSON.parse(readFileSync(this.path, 'utf-8'));
+            }
+            catch {
+                // Corrupted file — start fresh
+            }
+        }
+        return { entries: {}, updatedAt: new Date().toISOString() };
+    }
+}
+//# sourceMappingURL=selectors.js.map

package/dist/memory/selectors.js.map

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

package/dist/memory/store.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Trajectory Store — saves and loads successful trajectories for case-based reasoning.
+ *
+ * Stores trajectories as JSON files in a configurable directory (.trajectories/ by default).
+ * No fine-tuning needed — successful trajectories are injected into the system prompt
+ * as reference guides for similar future tasks.
+ */
+import type { Trajectory, Turn } from '../types.js';
+export interface TrajectoryStoreOptions {
+    similarityThreshold?: number;
+    enableScoring?: boolean;
+    ttlDays?: number;
+}
+export interface TrajectorySaveOptions {
+    origin?: string;
+}
+export interface TrajectoryMatchOptions {
+    origin?: string;
+}
+export declare class TrajectoryStore {
+    private storePath;
+    private cache;
+    private similarityThreshold;
+    private enableScoring;
+    private ttlDays;
+    constructor(storePath?: string, thresholdOrOptions?: number | TrajectoryStoreOptions);
+    /** Save a trajectory from a completed agent run */
+    save(goal: string, turns: Turn[], success: boolean, model: string, options?: TrajectorySaveOptions): Trajectory;
+    /** Load all trajectories (cached — invalidated on save) */
+    loadAll(): Trajectory[];
+    /** Find the best matching trajectory for a goal */
+    findBestMatch(goal: string, options?: TrajectoryMatchOptions): Trajectory | null;
+    private computeScore;
+    private computeRecencyScore;
+    private computeVerificationScore;
+    /** Format a trajectory as a human-readable reference for the brain */
+    formatAsReference(trajectory: Trajectory): string;
+}
+//# sourceMappingURL=store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/memory/store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,UAAU,EAAE,IAAI,EAAU,MAAM,aAAa,CAAC;AAG5D,MAAM,WAAW,sBAAsB;IACrC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,mBAAmB,CAAS;IACpC,OAAO,CAAC,aAAa,CAAU;IAC/B,OAAO,CAAC,OAAO,CAAS;gBAEZ,SAAS,CAAC,EAAE,MAAM,EAAE,kBAAkB,GAAE,MAAM,GAAG,sBAA4B;IAczF,mDAAmD;IACnD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,qBAA0B,GAAG,UAAU;IA0BnH,2DAA2D;IAC3D,OAAO,IAAI,UAAU,EAAE;IAiBvB,mDAAmD;IACnD,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,sBAA2B,GAAG,UAAU,GAAG,IAAI;IAoCpF,OAAO,CAAC,YAAY;IAUpB,OAAO,CAAC,mBAAmB;IAO3B,OAAO,CAAC,wBAAwB;IAMhC,sEAAsE;IACtE,iBAAiB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM;CAclD"}