@tangle-network/browser-agent-driver 0.28.0 → 0.30.0

package/README.md

@@ -278,11 +278,43 @@ See [Configuration Reference](./docs/guides/configuration.md) for all options.
 
 ```bash
 bad run [options]              # Run tasks
+bad snapshot --url <url>       # Headless accessibility-tree dump (no LLM)
 bad design-audit [options]     # Design quality analysis
 bad view <run-dir>             # Open session viewer
 bad competitive [options]      # Head-to-head framework comparison
 ```
 
+### `bad snapshot`
+
+Deterministic, no-LLM DOM dump. Loads a URL, dismisses consent dialogs, waits for
+the chosen network state, emits the accessibility-tree snapshot. Intended for CI
+and downstream quality pipelines where the agentic loop is overkill.
+
+```bash
+bad snapshot --url https://example.com --json --out snap.json
+bad snapshot --url http://localhost:3000 --wait domcontentloaded
+```
+
+| Flag | Description |
+|------|-------------|
+| `--url URL` | URL to snapshot (required) |
+| `--json` | Emit structured JSON instead of human-readable text |
+| `--out FILE` | Write to file instead of stdout |
+| `--wait load\|domcontentloaded\|networkidle\|commit` | Playwright waitUntil. Default `networkidle` |
+| `--timeout MS` | Per-action timeout. Default `15000` |
+| `--no-dismiss-modals` | Skip consent/cookie dialog dismissal |
+| `--headed` | Show the browser window (default headless) |
+
+JSON shape: `{ schemaVersion, url, finalUrl, title, snapshot, timing, dismissed, errors }`.
+Exits non-zero on navigation failure or aria-snapshot error.
+
+### Report schema
+
+`<sink>/report.json` carries a top-level `schemaVersion` field. The current
+version is `"1"`. Consumers should verify this before destructuring. Adding an
+optional field is non-breaking; the version bumps only on removed fields,
+renamed fields, or changed value semantics.
+
 ### Run options
 
 | Flag | Description |

package/dist/brain/index.d.ts

@@ -86,7 +86,7 @@ export declare class Brain {
     private generationOptions;
     /** Get a LLM model instance, optionally with provider/model override (e.g. for CAPTCHA fallback) */
     getLanguageModel(selection?: {
-        provider?: 'openai' | 'anthropic' | 'google';
+        provider?: 'openai' | 'anthropic' | 'google' | 'cli-bridge';
         model?: string;
     }): Promise<LanguageModel>;
     /** Lazily create the LLM model instance based on provider config */
@@ -279,6 +279,20 @@ export declare class Brain {
         key: string;
         value: string;
     }>>;
+    /**
+     * Generic text-completion entry point for non-agent uses (GEPA reflective
+     * mutation, ad-hoc rubric authoring, knowledge distillation). Returns the
+     * raw text + token usage; callers parse JSON themselves.
+     *
+     * No tool use, no decode-loop heuristics — just a single round-trip through
+     * the configured provider/model.
+     */
+    complete(system: string, user: string, options?: {
+        maxOutputTokens?: number;
+    }): Promise<{
+        text: string;
+        tokensUsed?: number;
+    }>;
     private parse;
 }
 /**

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

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

package/dist/brain/index.js

@@ -4,7 +4,7 @@
  *
  * Uses Vercel AI SDK for multi-provider support (OpenAI, Anthropic, Google, Codex CLI, Claude Code).
  */
-import { generateText } from 'ai';
+import { generateText, streamText } from 'ai';
 import { AriaSnapshotHelper } from '../drivers/snapshot.js';
 import { resolveProviderApiKey, resolveProviderModelName, isClaudeCodeRoutedModel, ZAI_OPENAI_BASE_URL, ZAI_ANTHROPIC_BASE_URL, } from '../provider-defaults.js';
 import { buildFirstPartyBoundaryNote } from '../domain-policy.js';
@@ -157,7 +157,13 @@ ACTIONS:
 - {"action": "fanOut", "subGoals": [...]} — spawn up to 8 parallel sub-agents in separate tabs (same session/cookies). See FAN-OUT section below for full rules + worked example.
 
 FAN-OUT — PARALLEL INVESTIGATION:
-fanOut is the way to investigate N independent candidates in PARALLEL instead of serially. When the current page shows a list of candidates or you have a queue of independent sub-tasks, emit ONE fanOut action with up to 8 subGoals instead of processing them one at a time. The system spawns N sub-agents in fresh tabs of the same session; they run concurrently; their results are merged and returned to you as structured JSON in the NEXT turn's feedback.
+fanOut is the way to investigate N independent candidates in PARALLEL instead of serially. When the current page shows a list of candidates or you have a queue of independent sub-tasks, emit ONE fanOut action instead of processing them one at a time. The system spawns N sub-agents in fresh tabs of the same session; they run concurrently; their results are merged and returned to you as structured JSON in the NEXT turn's feedback.
+
+STRONGLY PREFER THE SHORTHAND FORM when every branch shares a URL + instruction template. It emits tiny JSON that can't malform:
+
+  {"action":"fanOut","baseUrl":"https://site.example/","goalTemplate":"Investigate {item} — report outcome","items":["X","Y","Z"]}
+
+The string {item} in goalTemplate is replaced with each array entry. Labels default to the item. This is the RIGHT shape for N>=3 branches.
 
 USE fanOut WHEN:
 - A search returned multiple results and each needs investigation (click in / extract / return verdict per row).
@@ -386,6 +392,19 @@ Respond with ONLY a JSON object:
 }
 
 Score: 1-3 = poor, 4-5 = needs work, 6-7 = acceptable, 8-9 = good, 10 = excellent`;
+const JSON_TEXT_OUTPUT = {
+    name: 'json-text',
+    responseFormat: Promise.resolve({ type: 'json' }),
+    async parseCompleteOutput({ text }) {
+        return text;
+    },
+    async parsePartialOutput({ text }) {
+        return { partial: text };
+    },
+    createElementStreamTransform() {
+        return undefined;
+    },
+};
 export class Brain {
     modelCache = new Map();
     provider;
@@ -468,7 +487,7 @@ export class Brain {
     }
     shouldSendTemperature(modelName = this.modelName) {
         // OpenAI GPT-5 reasoning family currently rejects explicit temperature.
-        return !/^gpt-5(?:[.-]|$)/i.test(modelName);
+        return !/(^|\/)gpt-5(?:[.-]|$)/i.test(modelName);
     }
     generationOptions(maxOutputTokens, selection) {
         const providerName = selection?.provider || this.provider;
@@ -480,9 +499,20 @@ export class Brain {
             providerName === 'claude-code' ||
             providerName === 'sandbox-backend' ||
             (providerName === 'zai-coding-plan' && isClaudeCodeRoutedModel(modelName));
+        const omitsLegacyMaxTokens = providerName === 'cli-bridge' || /(^|\/)gpt-5(?:[.-]|$)/i.test(modelName);
         return {
             ...(this.shouldSendTemperature(modelName) ? { temperature: 0 } : {}),
-            ...(isCliSpawning ? {} : { maxOutputTokens }),
+            ...(isCliSpawning || omitsLegacyMaxTokens ? {} : { maxOutputTokens }),
+            ...(providerName === 'openai' && /(^|\/)gpt-5(?:[.-]|$)/i.test(modelName)
+                ? {
+                    providerOptions: {
+                        openai: {
+                            forceReasoning: true,
+                            maxCompletionTokens: maxOutputTokens,
+                        },
+                    },
+                }
+                : {}),
         };
     }
     /** Get a LLM model instance, optionally with provider/model override (e.g. for CAPTCHA fallback) */
@@ -518,6 +548,20 @@ export class Brain {
                 model = provider(modelName);
                 break;
             }
+            case 'cli-bridge': {
+                const { createOpenAI } = await import('@ai-sdk/openai');
+                const rawUrl = this.baseUrl || process.env.CLI_BRIDGE_URL;
+                if (!rawUrl) {
+                    throw new Error('cli-bridge provider requires CLI_BRIDGE_URL or --base-url');
+                }
+                const baseURL = rawUrl.endsWith('/v1') ? rawUrl : `${rawUrl.replace(/\/+$/, '')}/v1`;
+                const provider = createOpenAI({
+                    apiKey: apiKey || '',
+                    baseURL,
+                });
+                model = provider.chat(modelName);
+                break;
+            }
             case 'codex-cli': {
                 const { codexExec } = await import('ai-sdk-provider-codex-cli');
                 const env = {};
@@ -678,13 +722,25 @@ export class Brain {
         const systemForRequest = providerName === 'anthropic' || typeof system === 'string'
             ? system
             : systemForSandbox;
-        const result = await generateText({
+        const generationSettings = {
             model,
             system: systemForRequest,
             messages,
+            ...(providerName === 'cli-bridge' ? { output: JSON_TEXT_OUTPUT } : {}),
             ...this.generationOptions(maxOutputTokens, { provider: providerName, model: modelName }),
             abortSignal: AbortSignal.timeout(this.llmTimeoutMs),
-        });
+        };
+        const result = providerName === 'cli-bridge'
+            ? await (async () => {
+                const streamed = streamText(generationSettings);
+                const [text, usage, providerMetadata] = await Promise.all([
+                    streamed.text,
+                    streamed.totalUsage,
+                    streamed.providerMetadata,
+                ]);
+                return { text, usage, providerMetadata };
+            })()
+            : await generateText(generationSettings);
         // Extract prompt-cache stats from the AI SDK's PROVIDER-AGNOSTIC fields:
         //   result.usage.inputTokenDetails.{cacheReadTokens, cacheWriteTokens}
         //
@@ -1238,6 +1294,15 @@ ${visibleSnapshot}`;
                         raw = retryResult.text;
                         parsed = retryParsed;
                     }
+                    else if (this.baseUrl) {
+                        // Both the initial parse and the format-hint retry failed while a
+                        // custom LLM_BASE_URL is set. Strong signal the gateway is
+                        // returning a shape the scout can't consume (e.g. SSE streams,
+                        // non-JSON wrappers). Surface the likely cause instead of
+                        // burning silent retries turn after turn.
+                        console.error(`[Brain] scout_json_parse_failed: LLM_BASE_URL=${this.baseUrl} returned a response the scout could not parse even after a format-hint retry. ` +
+                            `Suggestion: switch to an Anthropic-native endpoint, or verify the gateway supports non-streaming chat/completions with { "response_format": { "type": "json_object" } }.`);
+                    }
                     tokensUsed = (tokensUsed ?? 0) + (retryResult.tokensUsed ?? 0);
                     inputTokens = (inputTokens ?? 0) + (retryResult.inputTokens ?? 0);
                     outputTokens = (outputTokens ?? 0) + (retryResult.outputTokens ?? 0);
@@ -1944,6 +2009,18 @@ Only include facts that are genuinely useful. Quality over quantity. Max 10 fact
             return [];
         }
     }
+    /**
+     * Generic text-completion entry point for non-agent uses (GEPA reflective
+     * mutation, ad-hoc rubric authoring, knowledge distillation). Returns the
+     * raw text + token usage; callers parse JSON themselves.
+     *
+     * No tool use, no decode-loop heuristics — just a single round-trip through
+     * the configured provider/model.
+     */
+    async complete(system, user, options = {}) {
+        const result = await this.generate(system, [{ role: 'user', content: user }], undefined, options.maxOutputTokens ?? 1500);
+        return { text: result.text, tokensUsed: result.tokensUsed };
+    }
     parse(raw) {
         let text = raw.trim();
         // Strip markdown code blocks
@@ -1961,9 +2038,41 @@ Only include facts that are genuinely useful. Quality over quantity. Max 10 fact
             // Gen 29: macro dispatch. The driver validates the macro name at
             // execute time; here we just accept the shape.
             'macro',
+            // Gen 33: parallel fan-out. Runner handles dispatch; validator
+            // only checks shape (subGoals[] or baseUrl+goalTemplate+items).
+            'fanOut',
         ]);
+        // Parse strategy: exact → first-{/last-} extraction.
+        // Some OpenAI-compat gateways (router.tangle.tools, LiteLLM proxies, etc.)
+        // wrap model output in prose preambles ("Here's your response:\n{...}")
+        // that markdown-fence stripping doesn't catch. Fall back to extracting the
+        // outermost object literal before giving up.
+        let parsed = null;
+        let parseError = '';
+        try {
+            parsed = JSON.parse(text);
+        }
+        catch (err) {
+            parseError = err instanceof Error ? err.message : String(err);
+            const firstBrace = text.indexOf('{');
+            const lastBrace = text.lastIndexOf('}');
+            if (firstBrace >= 0 && lastBrace > firstBrace) {
+                try {
+                    parsed = JSON.parse(text.slice(firstBrace, lastBrace + 1));
+                    parseError = '';
+                }
+                catch { /* fall through to retry fallback */ }
+            }
+        }
+        if (!parsed) {
+            return {
+                // Do not hard-abort the scenario on transient JSON formatting issues.
+                // Waiting one turn lets the loop continue and recover on the next model call.
+                action: { action: 'wait', ms: 1000 },
+                reasoning: `Malformed LLM JSON response (${parseError}). Retrying next turn.`,
+            };
+        }
         try {
-            const parsed = JSON.parse(text);
             const actionObj = parsed.action && typeof parsed.action === 'object' ? parsed.action : parsed;
             const actionType = typeof parsed.action === 'string' ? parsed.action : actionObj?.action;
             if (!actionType) {
@@ -1972,24 +2081,24 @@ Only include facts that are genuinely useful. Quality over quantity. Max 10 fact
             if (!VALID_ACTIONS.has(actionType)) {
                 throw new Error(`Unknown action "${actionType}". Valid: ${[...VALID_ACTIONS].join(', ')}`);
             }
-            const actionData = typeof parsed.action === 'object' ? parsed.action : parsed;
+            const actionData = parsed.action && typeof parsed.action === 'object'
+                ? parsed.action
+                : parsed;
             const action = validateAction(actionType, actionData);
             return {
                 action,
                 nextActions: parseNextActions(parsed, VALID_ACTIONS),
-                reasoning: parsed.reasoning || parsed.thought || parsed.thinking,
+                reasoning: (parsed.reasoning || parsed.thought || parsed.thinking),
                 plan: Array.isArray(parsed.plan) ? parsed.plan : undefined,
                 currentStep: typeof parsed.currentStep === 'number' ? parsed.currentStep : undefined,
-                expectedEffect: parsed.expectedEffect || parsed.expected_effect,
+                expectedEffect: (parsed.expectedEffect || parsed.expected_effect),
             };
         }
         catch (err) {
-            const parseError = err instanceof Error ? err.message : String(err);
+            const validationError = err instanceof Error ? err.message : String(err);
             return {
-                // Do not hard-abort the scenario on transient JSON formatting issues.
-                // Waiting one turn lets the loop continue and recover on the next model call.
                 action: { action: 'wait', ms: 1000 },
-                reasoning: `Malformed LLM JSON response (${parseError}). Retrying next turn.`,
+                reasoning: `Malformed LLM JSON response (${validationError}). Retrying next turn.`,
             };
         }
     }
@@ -2327,6 +2436,38 @@ function validateAction(actionType, data) {
                 ...(Object.keys(args).length > 0 ? { args } : {}),
             };
         }
+        case 'fanOut': {
+            // Accept either explicit subGoals[] or the shorthand
+            // baseUrl+goalTemplate+items trio. resolveSubGoals() in
+            // runner/fan-out.ts expands shorthand → subGoals at execute time.
+            const subGoals = Array.isArray(data.subGoals)
+                ? data.subGoals
+                    .filter((s) => s && typeof s === 'object')
+                    .map((s) => ({
+                    url: typeof s.url === 'string' ? s.url : '',
+                    goal: typeof s.goal === 'string' ? s.goal : '',
+                    ...(typeof s.label === 'string' ? { label: s.label } : {}),
+                    ...(typeof s.maxTurns === 'number' ? { maxTurns: s.maxTurns } : {}),
+                }))
+                    .filter((s) => s.url && s.goal)
+                : undefined;
+            const baseUrl = typeof data.baseUrl === 'string' ? data.baseUrl : undefined;
+            const goalTemplate = typeof data.goalTemplate === 'string' ? data.goalTemplate : undefined;
+            const items = Array.isArray(data.items) && data.items.every((i) => typeof i === 'string')
+                ? data.items
+                : undefined;
+            const hasExplicit = subGoals && subGoals.length > 0;
+            const hasShorthand = baseUrl && goalTemplate && items && items.length > 0;
+            if (!hasExplicit && !hasShorthand) {
+                throw new Error('fanOut action requires either "subGoals" (array of {url,goal}) or the shorthand trio "baseUrl" + "goalTemplate" + "items" (non-empty string[])');
+            }
+            return {
+                action: 'fanOut',
+                ...(hasExplicit ? { subGoals } : {}),
+                ...(hasShorthand ? { baseUrl, goalTemplate, items } : {}),
+                ...(typeof data.summarize === 'string' ? { summarize: data.summarize } : {}),
+            };
+        }
         default:
             throw new Error(`Unknown action type: ${actionType}`);
     }