@tangle-network/browser-agent-driver 0.31.0 → 0.33.0

package/dist/artifacts/filesystem-sink.d.ts

@@ -6,7 +6,7 @@
  *   ├── {testId}/
  *   │   ├── turn-05.jpg
  *   │   ├── recording.webm
- *   │   ├── events.jsonl    ← Gen 5: sub-turn TurnEvents from the bus
+ *   │   ├── events.jsonl    ← sub-turn TurnEvents from the bus
  *   │   └── trajectory.json
  *   ├── suite/
  *   │   ├── report.json

package/dist/artifacts/filesystem-sink.js

@@ -6,7 +6,7 @@
  *   ├── {testId}/
  *   │   ├── turn-05.jpg
  *   │   ├── recording.webm
- *   │   ├── events.jsonl    ← Gen 5: sub-turn TurnEvents from the bus
+ *   │   ├── events.jsonl    ← sub-turn TurnEvents from the bus
  *   │   └── trajectory.json
  *   ├── suite/
  *   │   ├── report.json

package/dist/brain/index.d.ts

@@ -84,6 +84,17 @@ export declare class Brain {
     private resolveModelName;
     private shouldSendTemperature;
     private generationOptions;
+    /**
+     * True iff we're hitting an OpenAI-compatible *proxy* (router.tangle.tools,
+     * LiteLLM, etc.) rather than OpenAI direct. Used to downshift to the lowest
+     * common denominator API surface — chat-completions, no Responses API,
+     * non-streaming — that every OpenAI-compatible proxy is guaranteed to serve.
+     *
+     * The single source of truth for "we're talking to a proxy, be conservative
+     * about API features"; both `createForceNonStreamingFetch()` and the
+     * `forceReasoning` gate route through this predicate.
+     */
+    private isProxiedOpenAI;
     /** Get a LLM model instance, optionally with provider/model override (e.g. for CAPTCHA fallback) */
     getLanguageModel(selection?: {
         provider?: 'openai' | 'anthropic' | 'google' | 'cli-bridge';
@@ -203,21 +214,17 @@ export declare class Brain {
         forceVision?: boolean;
     }): Promise<BrainDecision>;
     /**
-     * Gen 13: Vision-first decision path. The screenshot is the primary
+     * Vision-first decision path. The screenshot is the primary
      * observation; DOM snapshot is minimal context (URL, title only in pure
      * vision mode, or compact DOM in hybrid mode). The LLM outputs
      * coordinate-based actions (clickAt, typeAt) in 1024×768 virtual space.
      */
     private decideVision;
     /**
-     * Gen 7: ONE LLM call generates a structured plan for the entire task.
+     * Generate a structured plan for the entire task with one LLM call.
      *
      * The runner executes the plan deterministically (no LLM between steps),
      * falling back to per-action `decide()` only when verification fails.
-     * This is the architectural shift that breaks the "1 LLM call per
-     * action" assumption — a 9-action task becomes 1 plan call + 9
-     * deterministic executes instead of 9 LLM calls.
-     *
      * Returns null when:
      *   - the LLM response is unparseable JSON (fall through to per-action)
      *   - the plan has zero steps
@@ -268,6 +275,7 @@ export declare class Brain {
         raw: string;
         tokensUsed?: number;
         designSystemScore?: Record<string, unknown>;
+        parseError?: string;
     }>;
     /**
      * Extract reusable knowledge from a completed trajectory.
@@ -303,9 +311,8 @@ export declare class Brain {
  *      like MDN, Python docs, W3C spec where the value the agent needs lives in
  *      a `<dl>/<code>/<pre>` block, not in an interactive element)
  *
- * Gen 10C raised the default from 16k to 24k to give planners on extraction
- * pages more room before truncation kicks in. The 8k same-page budget remains
- * unchanged because by then the LLM has already seen the full snapshot once.
+ * New-page callers use a larger default budget; same-page callers can pass a
+ * tighter budget after the model has already seen the full snapshot once.
  */
 export declare function budgetSnapshot(snapshot: string, maxChars?: number): string;
 //# sourceMappingURL=index.d.ts.map

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

@@ -79,13 +79,13 @@ const DATA_EXTRACTION_RULES = `
 21. EFFICIENT COMPLETION: When you have enough data to answer the goal, complete immediately. Do not navigate to additional pages for "confirmation" if the data was already extracted or is visible in the current a11y tree. Include all extracted data in the completion result
 22. EXTRACT BEFORE NAVIGATING: On search results, directory listings, or any page showing multiple items, ALWAYS extract ALL needed data BEFORE clicking into individual items. Use extractWithIndex with a wide query for unknown structure, or runScript with document.querySelectorAll('.result-card') if the structure is well-known. Many sites use anti-bot protection on detail pages but leave listing pages accessible. If you can answer the goal from list-level data, do so without navigating deeper.
 23. FILTER vs SEARCH: When a goal asks to filter results (e.g., "under $50", "4+ stars"), look for filter controls (sliders, dropdowns, checkboxes in a sidebar or toolbar) rather than typing filter values into the search box. Search boxes are for keyword queries, not numeric filters. After applying a filter: (1) wait 2-3 seconds for results to update, (2) verify the filter took effect by checking the updated results, (3) extract the filtered data. Do NOT keep searching for more filter controls after one is applied — extract and complete
-25. EXTRACTWITHINDEX RECOVERY: If a previous runScript returned null/empty/{x:null} on an extraction task, the selector was wrong. DO NOT retry the same runScript or guess a similar selector — the LLM cannot guess CSS class names that aren't visible in the snapshot. Switch to extractWithIndex with a WIDE query: \`'p, span, dd, code, strong, em'\` plus a \`contains\` filter naming the expected text fragment (e.g. contains: "downloads" for npm download counts, contains: "callbackFn" for MDN method signatures). The response shows you the actual text per element so you can pick by content match. This is the Gen 10 recovery pattern — pick-by-content beats pick-by-selector on every page where the planner couldn't see the data at plan time.`;
+25. EXTRACTWITHINDEX RECOVERY: If a previous runScript returned null/empty/{x:null} on an extraction task, the selector was wrong. DO NOT retry the same runScript or guess a similar selector — the LLM cannot guess CSS class names that aren't visible in the snapshot. Switch to extractWithIndex with a WIDE query: \`'p, span, dd, code, strong, em'\` plus a \`contains\` filter naming the expected text fragment (e.g. contains: "downloads" for npm download counts, contains: "callbackFn" for MDN method signatures). The response shows you the actual text per element so you can pick by content match. Pick-by-content beats pick-by-selector on pages where the planner couldn't see the data at plan time.`;
 /** Heavy page rules (19-20, 24): injected when snapshot is large or turn count is high */
 const HEAVY_PAGE_RULES = `
 19. FORM FIELD TARGETING: Before typing, verify you are targeting the correct input field using its @ref from the ELEMENTS list. If multiple inputs are visible (e.g., search box + price filter), ensure you select the right one by checking its label or placeholder text in the a11y tree. Never assume focus — always specify the exact @ref
 20. SECTION NAVIGATION: When you need to find a specific section (e.g., rugby, sports, travel) and the nav links aren't in the truncated a11y tree, use runScript to discover navigation: JSON.stringify(Array.from(document.querySelectorAll('nav a, header a, [role="navigation"] a, .nav a')).slice(0, 30).map(a => ({text: a.textContent.trim(), href: a.href}))). Then navigate directly to the matching section URL
 24. HEAVY PAGE RECOVERY: If a page takes very long to load or seems stuck, do NOT wait — use runScript to check document.readyState and extract whatever content is already in the DOM. Partial data is better than a timeout. If the page is completely blank, try navigating to a simpler version (mobile site, search page) instead of waiting`;
-/** Gen 24: URL-first navigation — GENERAL PURPOSE, not site-specific.
+/** URL-first navigation rules for complex forms and search pages.
  * Teaches the agent to construct search/results URLs from goal text
  * instead of fighting form UIs. Works on any site with URL parameters. */
 const URL_FIRST_RULES = `
@@ -139,7 +139,7 @@ EXAMPLE 3 — Batch fill a multi-field form (one turn instead of ten):
 {"plan":["Fill all visible Personal Info fields","Click Next","Fill Contact step","Submit"],"currentStep":0,"action":{"action":"fill","fields":{"@firstname":"Jordan","@lastname":"Rivera","@dob":"1990-04-15"},"selects":{"@gender":"other"}},"reasoning":"Step 1 of the form has 3 text fields and 1 select all visible at once. Filling them in a single batch action saves 7 turns vs typing each individually.","expectedEffect":"All four Step 1 fields populated with the supplied values"}`;
 /** Full static prompt (all rules) — used as default when config.systemPrompt is not set */
 const SYSTEM_PROMPT = CORE_RULES + SEARCH_RULES + DATA_EXTRACTION_RULES + HEAVY_PAGE_RULES + REASONING_SUFFIX;
-// Gen 13: Vision-first system prompt (pure coordinate actions).
+// Vision-first system prompt for pure coordinate actions.
 const VISION_FIRST_PROMPT = `You are a browser automation agent. You operate by looking at screenshots and clicking on elements using pixel coordinates.
 
 The screenshot shows the current page state at 1024×768 resolution. You identify elements visually and specify where to click using (x, y) coordinates in this coordinate space.
@@ -239,7 +239,7 @@ REASONING FRAMEWORK:
 2. Where is the element I need to interact with? Estimate its (x, y) coordinates.
 3. What is the smallest action that makes progress toward the goal?
 4. If my last action failed, WHY did it fail? Try a different location or strategy.`;
-// Gen 15: Unified vision+DOM prompt. The model sees BOTH the screenshot AND
+// Unified vision+DOM prompt. The model sees BOTH the screenshot AND
 // the ARIA snapshot with @refs. It can use EITHER coordinate actions (clickAt/
 // typeAt for visual targets) OR ref actions (click/type/fill for DOM elements).
 // This lets it pick the best tool per interaction: vision for visual layout,
@@ -427,7 +427,7 @@ export class Brain {
     scoutModelName;
     scoutProvider;
     scoutUseVision;
-    // Gen 28: per-role model overrides
+    // Per-role model overrides.
     plannerModel;
     plannerProvider;
     verifierModel;
@@ -466,7 +466,7 @@ export class Brain {
         this.scoutModelName = config.scout?.model;
         this.scoutProvider = config.scout?.provider;
         this.scoutUseVision = config.scout?.useVision === true;
-        // Gen 28: per-role model overrides
+        // Per-role model overrides.
         this.plannerModel = config.models?.planner?.model;
         this.plannerProvider = config.models?.planner?.provider;
         this.verifierModel = config.models?.verifier?.model;
@@ -503,7 +503,15 @@ export class Brain {
         return {
             ...(this.shouldSendTemperature(modelName) ? { temperature: 0 } : {}),
             ...(isCliSpawning || omitsLegacyMaxTokens ? {} : { maxOutputTokens }),
-            ...(providerName === 'openai' && /(^|\/)gpt-5(?:[.-]|$)/i.test(modelName)
+            // forceReasoning routes the AI SDK to OpenAI's Responses API
+            // (`/v1/responses`). Most third-party OpenAI-compatible proxies
+            // (router.tangle.tools, LiteLLM, Together, vLLM, etc.) only implement
+            // /v1/chat/completions — Responses API requests come back 503 / 4xx
+            // and the SDK throws "Invalid JSON response". Disable on proxied
+            // openai routes; only OpenAI direct supports the Responses API today.
+            ...(providerName === 'openai'
+                && /(^|\/)gpt-5(?:[.-]|$)/i.test(modelName)
+                && !this.isProxiedOpenAI(providerName)
                 ? {
                     providerOptions: {
                         openai: {
@@ -515,6 +523,19 @@ export class Brain {
                 : {}),
         };
     }
+    /**
+     * True iff we're hitting an OpenAI-compatible *proxy* (router.tangle.tools,
+     * LiteLLM, etc.) rather than OpenAI direct. Used to downshift to the lowest
+     * common denominator API surface — chat-completions, no Responses API,
+     * non-streaming — that every OpenAI-compatible proxy is guaranteed to serve.
+     *
+     * The single source of truth for "we're talking to a proxy, be conservative
+     * about API features"; both `createForceNonStreamingFetch()` and the
+     * `forceReasoning` gate route through this predicate.
+     */
+    isProxiedOpenAI(providerName) {
+        return providerName === 'openai' && Boolean(this.baseUrl);
+    }
     /** Get a LLM model instance, optionally with provider/model override (e.g. for CAPTCHA fallback) */
     async getLanguageModel(selection) {
         return this.getModel(selection);
@@ -673,16 +694,18 @@ export class Brain {
                 // chat factory explicitly so we hit a path the upstream actually
                 // serves.
                 const { createOpenAI } = await import('@ai-sdk/openai');
+                const usingProxy = this.isProxiedOpenAI(providerName);
                 const provider = createOpenAI({
                     apiKey: apiKey || '',
                     ...(this.baseUrl ? { baseURL: this.baseUrl } : {}),
-                    // Gen 30: some OpenAI-compatible routers (notably router.tangle.tools)
-                    // default to SSE streaming when the client omits `stream`. The AI SDK's
-                    // generateText expects non-streaming responses and errors out with
-                    // "Invalid JSON response" on SSE. Force `stream: false` on every
-                    // chat-completions body the provider sends, but only when a custom
-                    // baseUrl is set — the real OpenAI endpoint defaults correctly.
-                    ...(this.baseUrl ? { fetch: createForceNonStreamingFetch() } : {}),
+                    // Proxy downshift — see isProxiedOpenAI(). Routes like
+                    // router.tangle.tools default chat-completions to SSE when the
+                    // client omits `stream`, and the AI SDK's generateText errors with
+                    // "Invalid JSON response" on SSE. Force stream: false on every
+                    // chat-completions body. Paired with the forceReasoning gate in
+                    // generationOptions() so all "talk to a proxy" downshifts share
+                    // one predicate.
+                    ...(usingProxy ? { fetch: createForceNonStreamingFetch() } : {}),
                 });
                 model = provider.chat(modelName);
                 break;
@@ -808,9 +831,8 @@ export class Brain {
     shouldUseNavigationModel(state, extraContext, turnInfo) {
         if (!this.adaptiveModelRouting || !this.navModelName)
             return false;
-        // Gen 22: use cheap model for DOM-only same-page turns (form filling,
-        // clicking known elements). Keep expensive model for first turn, new
-        // pages, and error recovery where reasoning matters.
+        // Use the navigation model for DOM-only same-page turns. Keep the primary
+        // model for first turns, new pages, and error recovery.
         const isFirstTurn = !turnInfo || turnInfo.current <= 1;
         const samePageAsPrevious = this.lastDecisionUrl === state.url;
         const hasError = extraContext?.includes('REJECTED') || extraContext?.includes('ERROR');
@@ -1039,8 +1061,7 @@ export class Brain {
         //   Zone 1 (intact):         last 2 turns — full content
         //   Zone 2 (standard):       turns 3-5 back — ELEMENTS stripped from user msgs
         //   Zone 3 (deep compact):   turns 6+ back — both user and assistant ultra-compacted
-        // REVERTED from aggressive 8/20 — the hard prune at 20 messages caused
-        // Google Flights to lose essential history on 30-turn runs.
+        // Keep enough older history for long multi-step travel workflows.
         const deepCompactBefore = Math.max(0, this.history.length - 10);
         return this.history.map((msg, idx) => {
             // Zone 1: keep recent turns intact
@@ -1158,7 +1179,7 @@ export class Brain {
         });
     }
     async decide(goal, state, extraContext, turnInfo, options) {
-        // Gen 13: vision-first or hybrid mode — delegate to the vision path
+        // Vision-first and hybrid modes delegate to the vision path.
         if (this.observationMode === 'vision' || this.observationMode === 'hybrid') {
             return this.decideVision(goal, state, extraContext, turnInfo);
         }
@@ -1177,10 +1198,8 @@ export class Brain {
             && diffChanges > 0
             && diffTotal > 0
             && diffChanges / diffTotal < 0.3;
-        // Tighter snapshot budget on same-page turns — agent already saw the full page.
-        // Gen 10C: raised new-page budget from 16k to 24k so extraction tasks (MDN/Python
-        // docs/W3C spec) get the full <dl>/<code>/<pre> content the LLM needs to write
-        // a working runScript on the first try.
+        // Tighter snapshot budget on same-page turns; new pages keep enough
+        // content for extraction from docs/spec pages.
         const snapshotBudget = samePageAsPrevious ? 8_000 : 24_000;
         let visibleSnapshot;
         let elementsHeader;
@@ -1338,17 +1357,15 @@ ${visibleSnapshot}`;
         };
     }
     /**
-     * Gen 13: Vision-first decision path. The screenshot is the primary
+     * Vision-first decision path. The screenshot is the primary
      * observation; DOM snapshot is minimal context (URL, title only in pure
      * vision mode, or compact DOM in hybrid mode). The LLM outputs
      * coordinate-based actions (clickAt, typeAt) in 1024×768 virtual space.
      */
     async decideVision(goal, state, extraContext, turnInfo) {
         this.lastDecisionUrl = state.url;
-        // Gen 18: adaptive observation — diff-focused on same-page turns.
-        // When the page changed slightly after an action (modal opened, dropdown
-        // expanded, content loaded), the DIFF is the signal. Send only what
-        // changed instead of the full snapshot. Saves 3-5k tokens per turn.
+        // Adaptive observation: on same-page hybrid turns, send only changed
+        // elements when the diff is small.
         const isHybrid = this.observationMode === 'hybrid';
         const samePageAsPrevious = this.lastDecisionUrl === state.url;
         const isFirstTurn = !turnInfo || turnInfo.current <= 1;
@@ -1413,10 +1430,8 @@ Title: ${state.title}`;
             { type: 'text', text: textContent },
             { type: 'image', image: state.screenshot, mediaType: 'image/jpeg' },
         ];
-        // Gen 14: strip ALL screenshots from history. The current turn's
-        // screenshot is the only image the model needs — old screenshots are
-        // dead weight that pushes cumulative token count past the cost cap.
-        // This alone fixes 3/5 Gen 13 failures (cost_cap at 101-106k).
+        // Strip old screenshots from history; the current screenshot is the only
+        // image the model needs for this turn.
         const compacted = this.compactHistory().map((msg) => {
             if (msg.role !== 'user' || !Array.isArray(msg.content))
                 return msg;
@@ -1430,13 +1445,12 @@ Title: ${state.title}`;
             ...compacted,
             { role: 'user', content: userContent },
         ];
-        // REVERTED: vision model cascade to gpt-4.1-mini caused 14x token
-        // inflation (99k/turn vs 6.8k/turn). gpt-4.1-mini counts image tokens
-        // differently, hitting cost cap in 3 turns. Vision turns stay on main model.
+        // Vision turns stay on the main model because smaller model routes can
+        // count image tokens differently and exhaust the token budget.
         const modelOpts = { provider: this.provider, model: this.modelName };
         const nearingEnd = turnInfo && turnInfo.current >= turnInfo.max - 3;
         const maxTokens = nearingEnd ? 1200 : 600;
-        // Gen 15: hybrid uses the unified prompt with both action vocabularies
+        // Hybrid mode uses the unified prompt with both action vocabularies.
         const systemPrompt = isHybrid ? UNIFIED_VISION_DOM_PROMPT : VISION_FIRST_PROMPT;
         const result = await this.generate(systemPrompt, messages, modelOpts, maxTokens);
         const raw = result.text;
@@ -1465,14 +1479,10 @@ Title: ${state.title}`;
         };
     }
     /**
-     * Gen 7: ONE LLM call generates a structured plan for the entire task.
+     * Generate a structured plan for the entire task with one LLM call.
      *
      * The runner executes the plan deterministically (no LLM between steps),
      * falling back to per-action `decide()` only when verification fails.
-     * This is the architectural shift that breaks the "1 LLM call per
-     * action" assumption — a 9-action task becomes 1 plan call + 9
-     * deterministic executes instead of 9 LLM calls.
-     *
      * Returns null when:
      *   - the LLM response is unparseable JSON (fall through to per-action)
      *   - the plan has zero steps
@@ -1485,11 +1495,8 @@ Title: ${state.title}`;
         const startedAt = Date.now();
         const maxSteps = options?.maxSteps ?? 12;
         const extraContext = options?.extraContext;
-        // Snapshot budget for the planner: Gen 10C raised from 12k to 24k. The
-        // planner is the most important caller for extraction tasks because it
-        // writes the runScript that runs on the first observation. Without enough
-        // snapshot context (especially `<dl>/<dt>/<code>/<pre>` content lines that
-        // Gen 10C now preserves), the planner emits selectors that don't exist.
+        // Planner snapshots keep enough context for extraction tasks, especially
+        // docs/spec pages with data in `<dl>`, `<code>`, and `<pre>` blocks.
         const snapshot = budgetSnapshot(state.snapshot, 24_000);
         const planSystemPrompt = `You are a planning engine for a browser automation agent.
 
@@ -1560,10 +1567,8 @@ ELEMENTS:
 ${snapshot}
 ${extraContext ? `\n${extraContext}\n` : ''}
 What is the complete plan?`;
-        // Gen 20: vision-aware planner. When hybrid mode is active AND a
-        // screenshot is available, send the screenshot alongside the DOM so
-        // the planner can see the visual layout. This helps on sites like
-        // Google Flights where the DOM doesn't convey form structure well.
+        // In vision-capable modes, include the screenshot so the planner can use
+        // visual layout when the DOM does not capture form structure.
         const isVisionPlanner = (this.observationMode === 'hybrid' || this.observationMode === 'vision') && !!state.screenshot;
         const userContent = isVisionPlanner
             ? [
@@ -1571,7 +1576,7 @@ What is the complete plan?`;
                 { type: 'image', image: state.screenshot, mediaType: 'image/jpeg' },
             ]
             : userText;
-        // Gen 28: planner can use a different model (e.g., Claude Opus for reasoning)
+        // Planner can use its own model override.
         const planModelOpts = this.plannerModel
             ? { provider: (this.plannerProvider || this.provider), model: this.plannerModel }
             : { provider: this.provider, model: this.modelName };
@@ -1831,7 +1836,7 @@ ${budgetSnapshot(state.snapshot)}${siteBoundaryNote ? `\n\n${siteBoundaryNote}`
 
 Was the goal actually achieved? Analyze the current page state carefully.`;
         const userContent = this.buildUserContent(textContent, state.screenshot, true);
-        // Gen 28: verifier can use its own model, falls back to nav model, then main
+        // Verifier can use its own model, then the navigation model, then main.
         const verifyProvider = this.verifierProvider
             ? this.verifierProvider
             : (this.adaptiveModelRouting && this.navModelName ? (this.navProvider || this.provider) : undefined);
@@ -1930,12 +1935,16 @@ Audit this page for design quality, UX issues, and visual bugs.`;
                     suggestion: String(f.suggestion ?? ''),
                     ...(f.cssSelector ? { cssSelector: String(f.cssSelector) } : {}),
                     ...(f.cssFix ? { cssFix: String(f.cssFix) } : {}),
-                    // Gen 3 ROI fields
+                    // Optional ROI fields.
                     ...(clampScore(f.impact) !== undefined ? { impact: clampScore(f.impact) } : {}),
                     ...(clampScore(f.effort) !== undefined ? { effort: clampScore(f.effort) } : {}),
                     ...(VALID_BLAST.has(f.blast)
                         ? { blast: f.blast }
                         : {}),
+                    // Layer 2 — preserve raw patches array (untyped passthrough). The
+                    // parsePatches/validatePatch pipeline in build-result.ts converts
+                    // these into typed, validated Patch objects.
+                    ...(Array.isArray(f.patches) ? { rawPatches: f.patches } : {}),
                 }))
                 : [];
             const designSystemScore = parsed.designSystemScore && typeof parsed.designSystemScore === 'object'
@@ -1950,12 +1959,13 @@ Audit this page for design quality, UX issues, and visual bugs.`;
                 designSystemScore,
             };
         }
-        catch {
+        catch (err) {
             return {
                 score: 5,
                 findings: [],
                 raw,
                 tokensUsed,
+                parseError: err instanceof Error ? err.message : String(err),
             };
         }
     }
@@ -2035,11 +2045,9 @@ Only include facts that are genuinely useful. Quality over quantity. Max 10 fact
             'fill', 'clickSequence',
             'clickAt', 'typeAt',
             'clickLabel', 'typeLabel',
-            // Gen 29: macro dispatch. The driver validates the macro name at
-            // execute time; here we just accept the shape.
+            // Macro dispatch. The driver validates the macro name at execute time.
             'macro',
-            // Gen 33: parallel fan-out. Runner handles dispatch; validator
-            // only checks shape (subGoals[] or baseUrl+goalTemplate+items).
+            // Parallel fan-out. Runner handles dispatch; validator checks shape.
             'fanOut',
         ]);
         // Parse strategy: exact → first-{/last-} extraction.
@@ -2223,9 +2231,8 @@ function deduplicateSnapshot(snapshot) {
  *      like MDN, Python docs, W3C spec where the value the agent needs lives in
  *      a `<dl>/<code>/<pre>` block, not in an interactive element)
  *
- * Gen 10C raised the default from 16k to 24k to give planners on extraction
- * pages more room before truncation kicks in. The 8k same-page budget remains
- * unchanged because by then the LLM has already seen the full snapshot once.
+ * New-page callers use a larger default budget; same-page callers can pass a
+ * tighter budget after the model has already seen the full snapshot once.
  */
 export function budgetSnapshot(snapshot, maxChars = 24_000) {
     // Skip dedup on small snapshots — not enough repetition to justify the O(n) scan
@@ -2409,19 +2416,18 @@ function validateAction(actionType, data) {
                 ...(typeof data.intervalMs === 'number' ? { intervalMs: data.intervalMs } : {}),
             };
         }
-        // Gen 13: Vision-first coordinate actions
+        // Vision-first coordinate actions.
         case 'clickAt':
             return { action: 'clickAt', x: num(data.x, 0), y: num(data.y, 0) };
         case 'typeAt':
             return { action: 'typeAt', x: num(data.x, 0), y: num(data.y, 0), text: optStr('text') };
-        // Gen 23: SoM label-based actions
+        // Set-of-Marks label-based actions.
         case 'clickLabel':
             return { action: 'clickLabel', label: num(data.label, 0) };
         case 'typeLabel':
             return { action: 'typeLabel', label: num(data.label, 0), text: optStr('text') };
-        // Gen 29: macro invocation. The driver validates the name + required
-        // args at execute time. We only require `name` here because args may
-        // legitimately be omitted for macros that declare no params.
+        // Macro invocation. The driver validates the name and required args at
+        // execute time; macros without params may omit args.
         case 'macro': {
             const args = {};
             if (data.args && typeof data.args === 'object' && !Array.isArray(data.args)) {
@@ -2483,11 +2489,8 @@ function isStringRecord(value) {
     return true;
 }
 /**
- * Gen 30: build a fetch-replacement that forces `"stream": false` on every
- * /chat/completions body. Necessary for OpenAI-compatible gateways that
- * default to SSE streaming when the client omits the field (observed on
- * router.tangle.tools). The AI SDK's generateText path does not handle
- * SSE, and we can't rely on the gateway respecting the absence of `stream`.
+ * Build a fetch replacement that forces `"stream": false` on chat completions
+ * bodies for OpenAI-compatible gateways that default to SSE streaming.
  */
 function createForceNonStreamingFetch() {
     return async (input, init) => {