@tangle-network/browser-agent-driver 0.6.0

package/dist/memory/store.js

@@ -0,0 +1,193 @@
+/**
+ * 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 { existsSync, mkdirSync, readFileSync, writeFileSync, readdirSync } from 'fs';
+import { join } from 'path';
+import { snapshotHash } from '../recovery.js';
+export class TrajectoryStore {
+    storePath;
+    cache = null;
+    similarityThreshold;
+    enableScoring;
+    ttlDays;
+    constructor(storePath, thresholdOrOptions = 0.5) {
+        const opts = typeof thresholdOrOptions === 'number'
+            ? { similarityThreshold: thresholdOrOptions }
+            : thresholdOrOptions;
+        this.storePath = storePath || join(process.cwd(), '.trajectories');
+        this.similarityThreshold = opts.similarityThreshold ?? 0.5;
+        this.enableScoring = opts.enableScoring === true;
+        this.ttlDays = opts.ttlDays ?? 30;
+        if (!existsSync(this.storePath)) {
+            mkdirSync(this.storePath, { recursive: true });
+        }
+    }
+    /** Save a trajectory from a completed agent run */
+    save(goal, turns, success, model, options = {}) {
+        const normalizedOrigin = normalizeOrigin(options.origin);
+        const trajectory = {
+            id: `traj_${Date.now()}_${Math.random().toString(36).slice(2, 8)}`,
+            goal,
+            origin: normalizedOrigin,
+            steps: turns
+                .filter((t) => t.action.action !== 'complete' && t.action.action !== 'abort')
+                .map((t) => ({
+                url: t.state.url,
+                action: t.action,
+                snapshotHash: snapshotHash(t.state.snapshot).toString(),
+                verified: t.verified,
+            })),
+            success,
+            durationMs: turns.reduce((sum, t) => sum + t.durationMs, 0),
+            model,
+            timestamp: new Date().toISOString(),
+        };
+        const filePath = join(this.storePath, `${trajectory.id}.json`);
+        writeFileSync(filePath, JSON.stringify(trajectory, null, 2));
+        this.cache = null; // Invalidate cache on write
+        return trajectory;
+    }
+    /** Load all trajectories (cached — invalidated on save) */
+    loadAll() {
+        if (this.cache)
+            return this.cache;
+        if (!existsSync(this.storePath))
+            return [];
+        this.cache = readdirSync(this.storePath)
+            .filter((f) => f.endsWith('.json'))
+            .map((f) => {
+            try {
+                return JSON.parse(readFileSync(join(this.storePath, f), 'utf-8'));
+            }
+            catch {
+                return null;
+            }
+        })
+            .filter((t) => t !== null);
+        return this.cache;
+    }
+    /** Find the best matching trajectory for a goal */
+    findBestMatch(goal, options = {}) {
+        const now = Date.now();
+        const maxAgeMs = this.ttlDays * 24 * 60 * 60 * 1000;
+        let trajectories = this.loadAll().filter((t) => {
+            if (!t.success)
+                return false;
+            const ts = Date.parse(t.timestamp);
+            if (Number.isNaN(ts))
+                return true;
+            return now - ts <= maxAgeMs;
+        });
+        const requestedOrigin = normalizeOrigin(options.origin);
+        if (requestedOrigin) {
+            trajectories = trajectories.filter((trajectory) => normalizeOrigin(trajectory.origin) === requestedOrigin);
+        }
+        if (trajectories.length === 0)
+            return null;
+        const scored = trajectories.map((trajectory) => {
+            const similarity = goalSimilarity(goal, trajectory.goal);
+            const score = this.enableScoring
+                ? this.computeScore(similarity, trajectory, now)
+                : similarity;
+            return { trajectory, score, similarity };
+        });
+        scored.sort((a, b) => b.score - a.score);
+        if (scored[0].similarity > this.similarityThreshold) {
+            return scored[0].trajectory;
+        }
+        return null;
+    }
+    computeScore(similarity, trajectory, nowMs) {
+        const recency = this.computeRecencyScore(trajectory.timestamp, nowMs);
+        const durationScore = 1 / (1 + trajectory.durationMs / 60_000);
+        const verificationScore = this.computeVerificationScore(trajectory);
+        // Weighted blend tuned for stable reuse:
+        // similarity dominates, then recency, then execution quality proxies.
+        return (similarity * 0.6) + (recency * 0.2) + (durationScore * 0.1) + (verificationScore * 0.1);
+    }
+    computeRecencyScore(timestamp, nowMs) {
+        const ts = Date.parse(timestamp);
+        if (Number.isNaN(ts))
+            return 0.5;
+        const ageDays = Math.max(0, (nowMs - ts) / (24 * 60 * 60 * 1000));
+        return Math.exp(-ageDays / 14);
+    }
+    computeVerificationScore(trajectory) {
+        if (trajectory.steps.length === 0)
+            return 0.5;
+        const verified = trajectory.steps.filter((step) => step.verified === true).length;
+        return verified / trajectory.steps.length;
+    }
+    /** Format a trajectory as a human-readable reference for the brain */
+    formatAsReference(trajectory) {
+        const lines = [];
+        lines.push(`Goal: ${trajectory.goal}`);
+        lines.push(`Steps (${trajectory.steps.length} total):`);
+        for (let i = 0; i < trajectory.steps.length; i++) {
+            const step = trajectory.steps[i];
+            const actionStr = formatAction(step.action);
+            const verified = step.verified ? ' [verified]' : '';
+            lines.push(`  ${i + 1}. ${actionStr} (on ${step.url})${verified}`);
+        }
+        return lines.join('\n');
+    }
+}
+function normalizeOrigin(origin) {
+    if (!origin)
+        return undefined;
+    try {
+        return new URL(origin).origin;
+    }
+    catch {
+        return undefined;
+    }
+}
+/**
+ * Compute similarity between two goal strings.
+ * Uses word overlap (Jaccard coefficient) — simple and effective.
+ */
+function goalSimilarity(a, b) {
+    const wordsA = new Set(tokenize(a));
+    const wordsB = new Set(tokenize(b));
+    if (wordsA.size === 0 && wordsB.size === 0)
+        return 1;
+    if (wordsA.size === 0 || wordsB.size === 0)
+        return 0;
+    let intersection = 0;
+    for (const w of wordsA) {
+        if (wordsB.has(w))
+            intersection++;
+    }
+    const union = new Set([...wordsA, ...wordsB]).size;
+    return intersection / union;
+}
+function tokenize(text) {
+    return text
+        .toLowerCase()
+        .replace(/[^a-z0-9\s]/g, '')
+        .split(/\s+/)
+        .filter((w) => w.length > 1); // Skip single-char words
+}
+function formatAction(action) {
+    switch (action.action) {
+        case 'click':
+            return `click ${action.selector}`;
+        case 'type':
+            return `type "${action.text}" into ${action.selector}`;
+        case 'press':
+            return `press ${action.key} on ${action.selector}`;
+        case 'scroll':
+            return `scroll ${action.direction}`;
+        case 'navigate':
+            return `navigate to ${action.url}`;
+        case 'wait':
+            return `wait ${action.ms}ms`;
+        default:
+            return JSON.stringify(action);
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/memory/store.js.map

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

package/dist/model-pricing.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Model pricing — fetched from LiteLLM's community-maintained pricing database.
+ *
+ * Source: https://github.com/BerriAI/litellm/blob/main/model_prices_and_context_window.json
+ *
+ * Pricing is fetched once on first use, cached in memory and on disk (24h TTL).
+ * Falls back to a minimal hardcoded table if the fetch fails.
+ */
+export interface ModelPricing {
+    /** Cost per token (USD) */
+    inputCostPerToken: number;
+    outputCostPerToken: number;
+    cacheReadCostPerToken?: number;
+}
+/**
+ * Load the pricing database. Tries (in order):
+ * 1. In-memory cache
+ * 2. Disk cache (24h TTL)
+ * 3. Fetch from GitHub
+ * 4. Hardcoded fallback
+ */
+export declare function loadPricing(): Promise<Map<string, ModelPricing>>;
+/** Synchronous version — returns fallback if not yet loaded */
+export declare function getPricingSync(): Map<string, ModelPricing>;
+/**
+ * Look up pricing for a model. Tries exact match, then prefix match.
+ */
+export declare function getModelPricing(model: string): ModelPricing | null;
+/**
+ * Calculate estimated cost in USD for a set of tokens.
+ *
+ * @param model - Model name
+ * @param inputTokens - Total input tokens (summed across all calls)
+ * @param outputTokens - Total output tokens
+ * @param cacheReadTokens - Tokens served from cache (discounted rate)
+ * @param maxInputPerCall - Largest single-call input context size.
+ *   Used to determine tiered pricing (e.g., gpt-5.4 charges 2x above 272K context).
+ *   If not provided, uses base tier pricing.
+ */
+export declare function calculateCost(model: string, inputTokens: number, outputTokens: number, cacheReadTokens?: number, maxInputPerCall?: number): number;
+//# sourceMappingURL=model-pricing.d.ts.map

package/dist/model-pricing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-pricing.d.ts","sourceRoot":"","sources":["../src/model-pricing.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH,MAAM,WAAW,YAAY;IAC3B,2BAA2B;IAC3B,iBAAiB,EAAE,MAAM,CAAC;IAC1B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC;AAsFD;;;;;;GAMG;AACH,wBAAsB,WAAW,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,CA+BtE;AAED,+DAA+D;AAC/D,wBAAgB,cAAc,IAAI,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAU1D;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI,CAclE;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,eAAe,SAAI,EACnB,eAAe,SAAI,GAClB,MAAM,CAuBR"}

package/dist/model-pricing.js

@@ -0,0 +1,197 @@
+/**
+ * Model pricing — fetched from LiteLLM's community-maintained pricing database.
+ *
+ * Source: https://github.com/BerriAI/litellm/blob/main/model_prices_and_context_window.json
+ *
+ * Pricing is fetched once on first use, cached in memory and on disk (24h TTL).
+ * Falls back to a minimal hardcoded table if the fetch fails.
+ */
+import { existsSync, readFileSync, writeFileSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+const LITELLM_PRICING_URL = 'https://raw.githubusercontent.com/BerriAI/litellm/main/model_prices_and_context_window.json';
+const CACHE_PATH = join(tmpdir(), 'browser-agent-driver-model-pricing.json');
+const CACHE_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+/**
+ * Context-length-based tiered pricing overrides.
+ * Some models (e.g., gpt-5.4) charge more above a context threshold.
+ * LiteLLM's database only has the base tier, so we handle overrides here.
+ * Pricing is per 1M tokens.
+ */
+const TIERED_PRICING = {
+    'gpt-5.4': { threshold: 272_000, input: 5.00, output: 22.50 },
+    'gpt-5.4-2026-03-05': { threshold: 272_000, input: 5.00, output: 22.50 },
+    'gpt-5.2': { threshold: 200_000, input: 3.50, output: 21.00 },
+};
+/** Parsed pricing map: model name → pricing */
+let pricingCache = null;
+/**
+ * Minimal fallback pricing (per 1M tokens) for when the fetch fails.
+ * These are last-known-good values — always prefer the fetched database.
+ */
+const FALLBACK_PRICING = {
+    'gpt-5.4': { input: 2.50, output: 15.00, cacheRead: 0.25 },
+    'gpt-5.2': { input: 1.75, output: 14.00, cacheRead: 0.175 },
+    'gpt-5.1': { input: 1.25, output: 10.00, cacheRead: 0.125 },
+    'gpt-5.3-codex': { input: 1.75, output: 14.00, cacheRead: 0.175 },
+    'gpt-4.1': { input: 2.00, output: 8.00, cacheRead: 0.20 },
+    'gpt-4.1-mini': { input: 0.40, output: 1.60, cacheRead: 0.04 },
+    'gpt-4.1-nano': { input: 0.10, output: 0.40, cacheRead: 0.01 },
+    'gpt-4o': { input: 2.50, output: 10.00, cacheRead: 1.25 },
+    'gpt-4o-mini': { input: 0.15, output: 0.60, cacheRead: 0.075 },
+    'claude-opus-4-6': { input: 5.00, output: 25.00, cacheRead: 0.50 },
+    'claude-sonnet-4-6': { input: 3.00, output: 15.00, cacheRead: 0.30 },
+    'claude-haiku-4-5': { input: 1.00, output: 5.00, cacheRead: 0.10 },
+};
+function parseLiteLLMPricing(raw) {
+    const map = new Map();
+    for (const [key, value] of Object.entries(raw)) {
+        if (key === 'sample_spec')
+            continue;
+        const entry = value;
+        const inputCost = entry.input_cost_per_token;
+        const outputCost = entry.output_cost_per_token;
+        if (typeof inputCost !== 'number' || typeof outputCost !== 'number')
+            continue;
+        map.set(key, {
+            inputCostPerToken: inputCost,
+            outputCostPerToken: outputCost,
+            cacheReadCostPerToken: typeof entry.cache_read_input_token_cost === 'number'
+                ? entry.cache_read_input_token_cost
+                : undefined,
+        });
+    }
+    return map;
+}
+function loadDiskCache() {
+    try {
+        if (!existsSync(CACHE_PATH))
+            return null;
+        const raw = JSON.parse(readFileSync(CACHE_PATH, 'utf-8'));
+        if (Date.now() - raw.fetchedAt > CACHE_TTL_MS)
+            return null;
+        return parseLiteLLMPricing(raw.data);
+    }
+    catch {
+        return null;
+    }
+}
+function saveDiskCache(data) {
+    try {
+        writeFileSync(CACHE_PATH, JSON.stringify({ fetchedAt: Date.now(), data }));
+    }
+    catch {
+        // Best-effort
+    }
+}
+function buildFallbackMap() {
+    const map = new Map();
+    for (const [key, { input, output, cacheRead }] of Object.entries(FALLBACK_PRICING)) {
+        map.set(key, {
+            inputCostPerToken: input / 1_000_000,
+            outputCostPerToken: output / 1_000_000,
+            cacheReadCostPerToken: cacheRead != null ? cacheRead / 1_000_000 : undefined,
+        });
+    }
+    return map;
+}
+/**
+ * Load the pricing database. Tries (in order):
+ * 1. In-memory cache
+ * 2. Disk cache (24h TTL)
+ * 3. Fetch from GitHub
+ * 4. Hardcoded fallback
+ */
+export async function loadPricing() {
+    if (pricingCache)
+        return pricingCache;
+    // Try disk cache
+    const diskCached = loadDiskCache();
+    if (diskCached && diskCached.size > 50) {
+        pricingCache = diskCached;
+        return pricingCache;
+    }
+    // Fetch from GitHub
+    try {
+        const response = await fetch(LITELLM_PRICING_URL, {
+            signal: AbortSignal.timeout(10_000),
+        });
+        if (response.ok) {
+            const data = await response.json();
+            const parsed = parseLiteLLMPricing(data);
+            if (parsed.size > 50) {
+                pricingCache = parsed;
+                saveDiskCache(data);
+                return pricingCache;
+            }
+        }
+    }
+    catch {
+        // Network failure — fall through to fallback
+    }
+    // Fallback
+    pricingCache = buildFallbackMap();
+    return pricingCache;
+}
+/** Synchronous version — returns fallback if not yet loaded */
+export function getPricingSync() {
+    if (pricingCache)
+        return pricingCache;
+    // Try disk cache synchronously
+    const diskCached = loadDiskCache();
+    if (diskCached && diskCached.size > 50) {
+        pricingCache = diskCached;
+        return pricingCache;
+    }
+    pricingCache = buildFallbackMap();
+    return pricingCache;
+}
+/**
+ * Look up pricing for a model. Tries exact match, then prefix match.
+ */
+export function getModelPricing(model) {
+    const pricing = getPricingSync();
+    // Exact match
+    if (pricing.has(model))
+        return pricing.get(model);
+    // Prefix match (e.g., "gpt-5.4-turbo" matches "gpt-5.4")
+    for (const [key, value] of pricing) {
+        if (model.startsWith(key) || key.startsWith(model)) {
+            return value;
+        }
+    }
+    return null;
+}
+/**
+ * Calculate estimated cost in USD for a set of tokens.
+ *
+ * @param model - Model name
+ * @param inputTokens - Total input tokens (summed across all calls)
+ * @param outputTokens - Total output tokens
+ * @param cacheReadTokens - Tokens served from cache (discounted rate)
+ * @param maxInputPerCall - Largest single-call input context size.
+ *   Used to determine tiered pricing (e.g., gpt-5.4 charges 2x above 272K context).
+ *   If not provided, uses base tier pricing.
+ */
+export function calculateCost(model, inputTokens, outputTokens, cacheReadTokens = 0, maxInputPerCall = 0) {
+    let pricing = getModelPricing(model);
+    if (!pricing)
+        return 0;
+    if (inputTokens === 0 && outputTokens === 0)
+        return 0;
+    // Check for context-length tiered pricing override
+    const tiered = TIERED_PRICING[model];
+    if (tiered && maxInputPerCall > tiered.threshold) {
+        pricing = {
+            ...pricing,
+            inputCostPerToken: tiered.input / 1_000_000,
+            outputCostPerToken: tiered.output / 1_000_000,
+        };
+    }
+    const nonCachedInput = Math.max(0, inputTokens - cacheReadTokens);
+    const cacheReadCost = pricing.cacheReadCostPerToken ?? pricing.inputCostPerToken;
+    return (nonCachedInput * pricing.inputCostPerToken +
+        cacheReadTokens * cacheReadCost +
+        outputTokens * pricing.outputCostPerToken);
+}
+//# sourceMappingURL=model-pricing.js.map

package/dist/model-pricing.js.map

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

package/dist/multi-actor.d.ts

@@ -0,0 +1,108 @@
+/**
+ * Multi-Actor Session — coordinated multi-user browser testing
+ *
+ * Each actor gets an isolated BrowserContext (separate cookies, localStorage,
+ * auth state) while sharing the same Browser instance. Consumers orchestrate
+ * with standard async/await for sequential flows and Promise.all() for parallel.
+ *
+ * ```typescript
+ * const session = await MultiActorSession.create(browser, {
+ *   actors: {
+ *     admin:   { storageState: '.auth/admin.json' },
+ *     partner: { storageState: '.auth/partner.json' },
+ *     user1:   {},
+ *   },
+ *   agentConfig: { model: 'gpt-4o', vision: true },
+ * });
+ *
+ * await session.actor('admin').run({ goal: 'Create quest', startUrl: '/admin' });
+ * await session.actor('partner').run({ goal: 'Approve quest' });
+ *
+ * await session.parallel(
+ *   ['user1', { goal: 'Start quest' }],
+ *   ['admin', { goal: 'Monitor dashboard' }],
+ * );
+ *
+ * await session.close();
+ * ```
+ */
+import type { Browser, BrowserContext, BrowserContextOptions, Page } from 'playwright';
+import { PlaywrightDriver } from './drivers/playwright.js';
+import type { PlaywrightDriverOptions } from './drivers/playwright.js';
+import { AgentRunner } from './runner.js';
+import type { Scenario, AgentConfig, AgentResult, Turn } from './types.js';
+import type { ProjectStore } from './memory/project-store.js';
+export interface ActorConfig {
+    /** Playwright storage state for pre-authenticated sessions */
+    storageState?: string | BrowserContextOptions['storageState'];
+    /** Setup hook called after context+page creation (e.g., manual login) */
+    setup?: (page: Page) => Promise<void>;
+    /** Agent config overrides for this actor (merged on top of shared config) */
+    agentConfig?: Partial<AgentConfig>;
+    /** Playwright context options (viewport, locale, etc.) */
+    contextOptions?: BrowserContextOptions;
+    /** Playwright driver options (timeout, screenshots) */
+    driverOptions?: PlaywrightDriverOptions;
+}
+export interface MultiActorSessionConfig {
+    /** Named actors keyed by role/identity */
+    actors: Record<string, ActorConfig>;
+    /** Shared agent config applied to all actors (per-actor overrides win) */
+    agentConfig?: AgentConfig;
+    /** Turn callback receives actor name + turn for cross-actor logging */
+    onTurn?: (actorName: string, turn: Turn) => void;
+    /** Project memory store shared across actors */
+    projectStore?: ProjectStore;
+}
+export declare class Actor {
+    readonly name: string;
+    private _context;
+    private _page;
+    private _driver;
+    private _runner;
+    private _results;
+    constructor(name: string, _context: BrowserContext, _page: Page, _driver: PlaywrightDriver, _runner: AgentRunner);
+    /** Run a scenario with this actor's agent. Results accumulate across calls. */
+    run(scenario: Scenario): Promise<AgentResult>;
+    /** Raw Playwright page for direct operations / assertions */
+    get page(): Page;
+    /** BrowserContext for cookie/storage inspection */
+    get context(): BrowserContext;
+    /** PlaywrightDriver for low-level driver access */
+    get driver(): PlaywrightDriver;
+    /** All results from this actor's runs */
+    get results(): readonly AgentResult[];
+    /** Most recent result, or undefined if no runs yet */
+    get lastResult(): AgentResult | undefined;
+}
+export declare class MultiActorSession {
+    private _actors;
+    private _closed;
+    private constructor();
+    /**
+     * Create a session with isolated browser contexts per actor.
+     *
+     * 1. Creates BrowserContext + Page + PlaywrightDriver + AgentRunner per actor
+     * 2. Calls setup() hooks if provided
+     * 3. Returns session ready for orchestration
+     */
+    static create(browser: Browser, config: MultiActorSessionConfig): Promise<MultiActorSession>;
+    /** Get an actor by name. Throws with available names on miss. */
+    actor(name: string): Actor;
+    /**
+     * Run multiple actors in parallel. Returns a Map of actor name → result.
+     *
+     * If any actor fails (throws), all results collected so far are still
+     * available via each actor's `.results` array.
+     */
+    parallel(...tasks: [actorName: string, scenario: Scenario][]): Promise<Map<string, AgentResult>>;
+    /** Close all browser contexts. Pages close with their contexts. */
+    close(): Promise<void>;
+    /** All results across all actors, keyed by actor name */
+    get results(): Map<string, readonly AgentResult[]>;
+    /** All actors for iteration */
+    get allActors(): Actor[];
+    /** Actor names */
+    get actorNames(): string[];
+}
+//# sourceMappingURL=multi-actor.d.ts.map

package/dist/multi-actor.d.ts.map

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