@tangle-network/browser-agent-driver 0.33.3 → 0.34.0

package/dist/brain/model-client.js

@@ -0,0 +1,391 @@
+/**
+ * Transport layer for the Brain decision engine: provider/model-name
+ * resolution, lazy (cached) model-client instantiation, and the single
+ * `generate()` round-trip every Brain method funnels through.
+ *
+ * Extracted from brain/index.ts via the delegate + host-interface pattern.
+ * The Brain class keeps thin delegators; these free functions hold the method
+ * bodies verbatim and read Brain state through {@link BrainModelHost}. tsc
+ * proves the host surface is complete because Brain `implements` it.
+ */
+import { generateText, streamText } from 'ai';
+import { resolveProviderApiKey, resolveProviderModelName, isClaudeCodeRoutedModel, shouldSendTemperature, ZAI_OPENAI_BASE_URL, ZAI_ANTHROPIC_BASE_URL, } from '../provider-defaults.js';
+import { generateWithSandboxBackend } from '../providers/sandbox-backend.js';
+import { JSON_TEXT_OUTPUT, createForceNonStreamingFetch } from './provider-fetch.js';
+export function resolveModelNameImpl(self, provider, requestedModel) {
+    return resolveProviderModelName(provider, requestedModel, {
+        sandboxBackendType: provider === 'sandbox-backend' ? self.sandboxBackendType : undefined,
+    });
+}
+export function shouldSendTemperatureImpl(self, modelName = self.modelName) {
+    // Reasoning models reject an explicit temperature — see the shared
+    // capability check (GPT-5, o-series, Opus 4.8+, Kimi K2.6+, DeepSeek
+    // reasoner).
+    return shouldSendTemperature(modelName);
+}
+export function generationOptionsImpl(self, maxOutputTokens, selection) {
+    const providerName = selection?.provider || self.provider;
+    const modelName = resolveModelNameImpl(self, providerName, selection?.model || self.modelName);
+    // CLI-spawning providers (codex-cli, claude-code, and zai-coding-plan
+    // when routed through claude-code) don't accept maxOutputTokens through
+    // the AI SDK shape — the subprocess controls its own output.
+    const isCliSpawning = providerName === 'codex-cli' ||
+        providerName === 'claude-code' ||
+        providerName === 'sandbox-backend' ||
+        (providerName === 'zai-coding-plan' && isClaudeCodeRoutedModel(modelName));
+    const omitsLegacyMaxTokens = providerName === 'cli-bridge' || /(^|\/)gpt-5(?:[.-]|$)/i.test(modelName);
+    return {
+        ...(shouldSendTemperatureImpl(self, modelName) ? { temperature: 0 } : {}),
+        ...(isCliSpawning || omitsLegacyMaxTokens ? {} : { maxOutputTokens }),
+        // 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)
+            && !isProxiedOpenAIImpl(self, providerName)
+            ? {
+                providerOptions: {
+                    openai: {
+                        forceReasoning: true,
+                        maxCompletionTokens: maxOutputTokens,
+                    },
+                },
+            }
+            : {}),
+    };
+}
+/**
+ * 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.
+ */
+export function isProxiedOpenAIImpl(self, providerName) {
+    return providerName === 'openai' && Boolean(self.baseUrl);
+}
+/** Get a LLM model instance, optionally with provider/model override (e.g. for CAPTCHA fallback) */
+export async function getLanguageModelImpl(self, selection) {
+    return getModelImpl(self, selection);
+}
+/** Lazily create the LLM model instance based on provider config */
+export async function getModelImpl(self, selection) {
+    const providerName = selection?.provider || self.provider;
+    const modelName = resolveModelNameImpl(self, providerName, selection?.model || self.modelName);
+    const apiKey = resolveProviderApiKey(providerName, self.explicitApiKey);
+    const cacheKey = `${providerName}:${modelName}`;
+    const cached = self.modelCache.get(cacheKey);
+    if (cached)
+        return cached;
+    let model;
+    switch (providerName) {
+        case 'anthropic': {
+            const { createAnthropic } = await import('@ai-sdk/anthropic');
+            const provider = createAnthropic({
+                apiKey,
+                ...(self.baseUrl ? { baseURL: self.baseUrl } : {}),
+            });
+            model = provider(modelName);
+            break;
+        }
+        case 'google': {
+            const { createGoogleGenerativeAI } = await import('@ai-sdk/google');
+            const provider = createGoogleGenerativeAI({
+                apiKey,
+                ...(self.baseUrl ? { baseURL: self.baseUrl } : {}),
+            });
+            model = provider(modelName);
+            break;
+        }
+        case 'cli-bridge': {
+            const { createOpenAI } = await import('@ai-sdk/openai');
+            const rawUrl = self.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 = {};
+            if (apiKey)
+                env.OPENAI_API_KEY = apiKey;
+            model = codexExec(modelName, {
+                allowNpx: process.env.CODEX_ALLOW_NPX !== '0',
+                skipGitRepoCheck: true,
+                ...(process.env.CODEX_CLI_PATH ? { codexPath: process.env.CODEX_CLI_PATH } : {}),
+                ...(Object.keys(env).length > 0 ? { env } : {}),
+            });
+            break;
+        }
+        case 'claude-code': {
+            const { createClaudeCode } = await import('ai-sdk-provider-claude-code');
+            const env = {};
+            if (apiKey)
+                env.ANTHROPIC_API_KEY = apiKey;
+            const provider = createClaudeCode({
+                defaultSettings: {
+                    ...(process.env.CLAUDE_CODE_CLI_PATH ? { pathToClaudeCodeExecutable: process.env.CLAUDE_CODE_CLI_PATH } : {}),
+                    permissionMode: 'default',
+                    allowDangerouslySkipPermissions: false,
+                    // The Claude Code SDK only forwards image parts when streaming input
+                    // is on; the vision-judge wiring sets this so completeVision images
+                    // are not silently dropped. Left off for every other claude-code path.
+                    ...(self.claudeCodeStreamingInput ? { streamingInput: 'always' } : {}),
+                    ...(self.debug ? { verbose: true } : {}),
+                    ...(self.debug
+                        ? {
+                            stderr: (chunk) => {
+                                const line = chunk.trim();
+                                if (line)
+                                    console.error(`[claude-code] ${line}`);
+                            },
+                        }
+                        : {}),
+                    ...(Object.keys(env).length > 0 ? { env } : {}),
+                },
+            });
+            model = provider(modelName);
+            break;
+        }
+        case 'zai-coding-plan': {
+            // Z.ai coding plan: GLM models (glm-4.6, glm-4.5-air) at a fraction
+            // of Anthropic prices. Two backends:
+            //   1. Default — OpenAI-compatible endpoint, native GLM models
+            //   2. claude-code routed — spawn the Claude Code CLI subprocess
+            //      with ANTHROPIC_BASE_URL/AUTH_TOKEN env vars pointed at Z.ai's
+            //      Anthropic-compatible endpoint. The user gets the Claude Code
+            //      agent loop with Z.ai pricing.
+            if (!apiKey) {
+                throw new Error('zai-coding-plan: API key required (set ZAI_API_KEY env var or pass --api-key)');
+            }
+            if (isClaudeCodeRoutedModel(modelName)) {
+                const { createClaudeCode } = await import('ai-sdk-provider-claude-code');
+                const env = {
+                    // Override Claude Code's API base + auth at the env-var level.
+                    // The CLI subprocess inherits these and routes all Anthropic
+                    // API calls to Z.ai's Anthropic-compatible endpoint.
+                    ANTHROPIC_BASE_URL: ZAI_ANTHROPIC_BASE_URL,
+                    ANTHROPIC_AUTH_TOKEN: apiKey,
+                    // Some Claude Code versions still read ANTHROPIC_API_KEY — set
+                    // both so we don't depend on which env var name wins.
+                    ANTHROPIC_API_KEY: apiKey,
+                };
+                const provider = createClaudeCode({
+                    defaultSettings: {
+                        ...(process.env.CLAUDE_CODE_CLI_PATH ? { pathToClaudeCodeExecutable: process.env.CLAUDE_CODE_CLI_PATH } : {}),
+                        permissionMode: 'default',
+                        allowDangerouslySkipPermissions: false,
+                        ...(self.debug ? { verbose: true } : {}),
+                        ...(self.debug
+                            ? {
+                                stderr: (chunk) => {
+                                    const line = chunk.trim();
+                                    if (line)
+                                        console.error(`[zai-claude-code] ${line}`);
+                                },
+                            }
+                            : {}),
+                        env,
+                    },
+                });
+                // The Claude Code SDK takes a model alias (sonnet/haiku/opus); when
+                // the user passes a glm-* name we just hand it through — Claude
+                // Code passes it as the model param to the upstream API, which is
+                // Z.ai's Anthropic-compat endpoint that maps it to the right glm.
+                // For 'claude-code'/'cc' we default to 'sonnet' which Z.ai aliases
+                // to its strongest glm model under the coding plan.
+                const ccModel = modelName === 'claude-code' || modelName === 'cc' ? 'sonnet' : modelName;
+                model = provider(ccModel);
+                break;
+            }
+            // Default path — direct OpenAI-compatible API to Z.ai. Z.ai's
+            // paas/v4 endpoint only implements `/chat/completions` (no
+            // `/responses`), so we MUST use `provider.chat(model)` rather than
+            // the bare `provider(model)` call which now defaults to the new
+            // OpenAI Responses API in @ai-sdk/openai v3+.
+            const { createOpenAI } = await import('@ai-sdk/openai');
+            const provider = createOpenAI({
+                apiKey,
+                baseURL: ZAI_OPENAI_BASE_URL,
+            });
+            model = provider.chat(modelName);
+            break;
+        }
+        default: {
+            // 'openai' or any OpenAI-compatible API (LiteLLM, Together, etc.).
+            // Same reason as the zai-coding-plan branch above: most third-party
+            // OpenAI-compatible proxies (LiteLLM, vLLM, Together) implement
+            // `/chat/completions` but not the new `/responses` API. Use the
+            // chat factory explicitly so we hit a path the upstream actually
+            // serves.
+            const { createOpenAI } = await import('@ai-sdk/openai');
+            const usingProxy = isProxiedOpenAIImpl(self, providerName);
+            const provider = createOpenAI({
+                apiKey: apiKey || '',
+                ...(self.baseUrl ? { baseURL: self.baseUrl } : {}),
+                // 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;
+        }
+    }
+    self.modelCache.set(cacheKey, model);
+    return model;
+}
+export async function generateImpl(self, system, messages, selection, maxOutputTokens = 800) {
+    const providerName = selection?.provider || self.provider;
+    const modelName = resolveModelNameImpl(self, providerName, selection?.model || self.modelName);
+    // Sandbox backend doesn't accept structured system messages — flatten.
+    const systemForSandbox = typeof system === 'string'
+        ? system
+        : system.map(m => m.content).join('\n\n');
+    if (providerName === 'sandbox-backend') {
+        const result = await generateWithSandboxBackend({
+            system: systemForSandbox,
+            messages,
+            model: modelName,
+            timeoutMs: self.llmTimeoutMs,
+            debug: self.debug,
+            backendType: self.sandboxBackendType,
+            backendProfile: self.sandboxBackendProfile,
+            backendModelProvider: self.sandboxBackendProvider,
+        });
+        return { text: result.text };
+    }
+    const model = await getModelImpl(self, {
+        provider: providerName,
+        model: modelName,
+    });
+    // Anthropic supports structured system messages with cache_control. For
+    // every other provider, flatten back to a string — they ignore the array
+    // form's per-message provider options anyway, and some (claude-code,
+    // codex-cli) wrap their own subprocess CLI which only takes plain text.
+    const systemForRequest = providerName === 'anthropic' || typeof system === 'string'
+        ? system
+        : systemForSandbox;
+    const generationSettings = {
+        model,
+        system: systemForRequest,
+        messages,
+        ...(providerName === 'cli-bridge' ? { output: JSON_TEXT_OUTPUT } : {}),
+        ...generationOptionsImpl(self, maxOutputTokens, { provider: providerName, model: modelName }),
+        abortSignal: AbortSignal.timeout(self.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}
+    //
+    // These flow uniformly from every provider that supports prompt caching:
+    //   - OpenAI (gpt-5.4, gpt-4.1-mini): AUTOMATIC server-side caching for
+    //     >1024 token prefixes, no markers needed. Returns cached_tokens.
+    //   - Anthropic (claude-*): EXPLICIT cache_control markers required (we
+    //     set them in buildSystemForDecide). Returns cache_read_input_tokens.
+    //   - ZAI / GLM (zai-coding-plan via OpenAI-compatible endpoint): AUTOMATIC
+    //     server-side caching, returns cached_tokens in prompt_tokens_details.
+    //   - Google Gemini: explicit `cachedContent` ID-based caching (different
+    //     paradigm — not currently exercised).
+    //
+    // The unified inputTokenDetails fields mean we get cache observability
+    // for free across providers without per-provider extraction code.
+    const inputDetails = result.usage?.inputTokenDetails;
+    let cacheReadInputTokens = typeof inputDetails?.cacheReadTokens === 'number'
+        ? inputDetails.cacheReadTokens
+        : undefined;
+    let cacheCreationInputTokens = typeof inputDetails?.cacheWriteTokens === 'number'
+        ? inputDetails.cacheWriteTokens
+        : undefined;
+    // Fallback: some providers expose cache stats only via providerMetadata.
+    // Anthropic uses cacheReadInputTokens / cacheCreationInputTokens directly,
+    // OpenAI sometimes lands cached_tokens under providerMetadata.openai.
+    if (cacheReadInputTokens === undefined || cacheCreationInputTokens === undefined) {
+        const meta = result.providerMetadata;
+        const anthropicMeta = meta?.anthropic;
+        const openaiMeta = meta?.openai;
+        if (cacheReadInputTokens === undefined) {
+            const fromAnthropic = typeof anthropicMeta?.cacheReadInputTokens === 'number'
+                ? anthropicMeta.cacheReadInputTokens
+                : undefined;
+            const fromOpenAI = typeof openaiMeta?.cachedPromptTokens === 'number'
+                ? openaiMeta.cachedPromptTokens
+                : undefined;
+            cacheReadInputTokens = fromAnthropic ?? fromOpenAI;
+        }
+        if (cacheCreationInputTokens === undefined) {
+            const fromAnthropic = typeof anthropicMeta?.cacheCreationInputTokens === 'number'
+                ? anthropicMeta.cacheCreationInputTokens
+                : undefined;
+            cacheCreationInputTokens = fromAnthropic;
+        }
+    }
+    return {
+        text: result.text,
+        tokensUsed: result.usage?.totalTokens,
+        inputTokens: result.usage?.inputTokens ?? undefined,
+        outputTokens: result.usage?.outputTokens ?? undefined,
+        cacheReadInputTokens,
+        cacheCreationInputTokens,
+    };
+}
+/**
+ * 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.
+ */
+export async function completeImpl(self, system, user, options = {}) {
+    const result = await generateImpl(self, system, [{ role: 'user', content: user }], undefined, options.maxOutputTokens ?? 1500);
+    return { text: result.text, tokensUsed: result.tokensUsed };
+}
+/**
+ * Multimodal sibling of {@link completeImpl}: a single round-trip with a system
+ * prompt, a user prompt, and one-or-more already-encoded images. The narrow
+ * vision seam the reference-grounded taste judge binds to (one Brain per
+ * `{ provider, model }` ref), built on the same `generate` so it goes through
+ * the existing provider abstraction — any vision-capable backend works.
+ *
+ * Images arrive ENCODED (`{ image, mediaType }`, base64/data); the disk read +
+ * mediaType inference live in the judge's `createBrainVisionModel` adapter, so
+ * this method does no IO. It is NOT `auditDesign` — the page-audit seam stays
+ * off-limits to taste comparison by contract.
+ */
+export async function completeVisionImpl(self, system, user, images, options = {}) {
+    const content = [
+        { type: 'text', text: user },
+        ...images.map((img) => ({ type: 'image', image: img.image, mediaType: img.mediaType })),
+    ];
+    const result = await generateImpl(self, system, [{ role: 'user', content }], undefined, options.maxOutputTokens ?? 1500);
+    return { text: result.text, tokensUsed: result.tokensUsed };
+}
+//# sourceMappingURL=model-client.js.map

package/dist/brain/model-client.js.map

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

package/dist/brain/plan.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Whole-task planning for the Brain engine: a single LLM call that returns a
+ * structured, deterministically-executable Plan (or null when the response is
+ * unusable, signalling the runner to fall back to the per-action loop).
+ *
+ * Extracted from brain/index.ts via the delegate + host-interface pattern.
+ * The Brain class keeps a thin `plan` delegator; this free function holds the
+ * method body verbatim and reads Brain state through {@link BrainPlanHost},
+ * which Brain `implements` so tsc proves the host surface is complete.
+ * Behavior is byte-identical — same JSON tolerance, step validation, and
+ * fallback shapes.
+ */
+import type { ModelMessage, SystemModelMessage } from 'ai';
+import type { PageState, Plan } from '../types.js';
+import type { BrainProvider, ModelSelection, GenerateResult } from './model-client.js';
+/**
+ * The slice of Brain state the planner reads. Brain declares
+ * `implements BrainPlanHost`, so a missing or mistyped member is a compile
+ * error — this interface IS the safety gate for the extraction. All members
+ * are public on Brain by construction.
+ */
+export interface BrainPlanHost {
+    provider: BrainProvider;
+    modelName: string;
+    plannerModel?: string;
+    plannerProvider?: string;
+    observationMode: 'dom' | 'vision' | 'hybrid';
+    generate(system: string | SystemModelMessage[], messages: ModelMessage[], selection?: ModelSelection, maxOutputTokens?: number): Promise<GenerateResult>;
+}
+/**
+ * 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.
+ * Returns null when:
+ *   - the LLM response is unparseable JSON (fall through to per-action)
+ *   - the plan has zero steps
+ *   - any plan step has an invalid/unknown action shape
+ *
+ * The caller (BrowserAgent.run) treats null as "planner unavailable,
+ * use per-action loop".
+ */
+export declare function planImpl(self: BrainPlanHost, goal: string, state: PageState, options?: {
+    maxSteps?: number;
+    extraContext?: string;
+}): Promise<{
+    plan: Plan | null;
+    raw: string;
+    durationMs: number;
+    tokensUsed?: number;
+    inputTokens?: number;
+    outputTokens?: number;
+    cacheReadInputTokens?: number;
+    cacheCreationInputTokens?: number;
+    parseError?: string;
+}>;
+//# sourceMappingURL=plan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"plan.d.ts","sourceRoot":"","sources":["../../src/brain/plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,IAAI,CAAC;AAC3D,OAAO,KAAK,EAAU,SAAS,EAAE,IAAI,EAAY,MAAM,aAAa,CAAC;AAKrE,OAAO,KAAK,EAAE,aAAa,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEvF;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,aAAa,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,eAAe,EAAE,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAC;IAC7C,QAAQ,CACN,MAAM,EAAE,MAAM,GAAG,kBAAkB,EAAE,EACrC,QAAQ,EAAE,YAAY,EAAE,EACxB,SAAS,CAAC,EAAE,cAAc,EAC1B,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,cAAc,CAAC,CAAC;CAC5B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAsB,QAAQ,CAC5B,IAAI,EAAE,aAAa,EACnB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,SAAS,EAChB,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,CAAA;CAAE,GACrD,OAAO,CAAC;IACT,IAAI,EAAE,IAAI,GAAG,IAAI,CAAA;IACjB,GAAG,EAAE,MAAM,CAAA;IACX,UAAU,EAAE,MAAM,CAAA;IAClB,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,oBAAoB,CAAC,EAAE,MAAM,CAAA;IAC7B,wBAAwB,CAAC,EAAE,MAAM,CAAA;IACjC,UAAU,CAAC,EAAE,MAAM,CAAA;CACpB,CAAC,CAmLD"}