@tangle-network/browser-agent-driver 0.6.0

package/dist/runner/utils.js

@@ -0,0 +1,119 @@
+/**
+ * Runner utility functions — retry logic, snapshot helpers, text normalization.
+ */
+const DEFAULT_MAX_GOAL_VERIFICATION_EVIDENCE = 5;
+/** Retry wrapper for transient failures. Respects AbortSignal between attempts. */
+export async function withRetry(fn, retries, delayMs, onRetry, signal) {
+    let lastError;
+    for (let attempt = 1; attempt <= retries; attempt++) {
+        if (signal?.aborted)
+            throw new Error(signal.reason || 'Cancelled');
+        try {
+            return await fn();
+        }
+        catch (err) {
+            lastError = err instanceof Error ? err : new Error(String(err));
+            if (attempt < retries) {
+                onRetry?.(attempt, lastError);
+                await new Promise((resolve, reject) => {
+                    let onAbort;
+                    const timer = setTimeout(() => {
+                        if (onAbort)
+                            signal?.removeEventListener('abort', onAbort);
+                        resolve();
+                    }, delayMs * attempt);
+                    if (signal) {
+                        onAbort = () => { clearTimeout(timer); reject(new Error(signal.reason || 'Cancelled')); };
+                        if (signal.aborted) {
+                            clearTimeout(timer);
+                            reject(new Error(signal.reason || 'Cancelled'));
+                            return;
+                        }
+                        signal.addEventListener('abort', onAbort, { once: true });
+                    }
+                });
+            }
+        }
+    }
+    throw lastError ?? new Error('withRetry: no attempts made');
+}
+/**
+ * Extract the element identity (e.g., 'button "Send"') for a given @ref
+ * from an a11y snapshot. Returns undefined if the ref is not found.
+ */
+export function findElementForRef(snapshot, selector) {
+    if (!selector.startsWith('@'))
+        return undefined;
+    const bareRef = selector.slice(1);
+    // Match: role "name" [ref=XXX] in the snapshot
+    const regex = new RegExp(`(\\w+ "[^"]*")\\s*\\[ref=${bareRef}\\]`);
+    const match = snapshot.match(regex);
+    return match?.[1];
+}
+export function safeHostname(url) {
+    try {
+        return new URL(url).hostname.toLowerCase();
+    }
+    catch {
+        return undefined;
+    }
+}
+export function requiresSearchWorkflowEvidence(goal) {
+    const goalLower = goal.toLowerCase();
+    return (goalLower.includes("site's search feature")
+        || goalLower.includes('\u2019s search feature')
+        || goalLower.includes('site search'));
+}
+export function requiresPressReleaseLikeContent(goal) {
+    const goalLower = goal.toLowerCase();
+    return PRESS_RELEASE_RE.test(goalLower);
+}
+/** Matches press-release / news-release mentions in text. */
+export const PRESS_RELEASE_RE = /\bpress release\b|\bnews release\b/i;
+/** Matches NIH non-release content signals (research matters, fact sheets, topic pages). */
+export const NON_RELEASE_CONTENT_RE = /\bnih research matters\b|\bnews in health\b|\bcatalyst\b|\bfact sheet\b|\bwhat causes\b|\bwhat are the signs\b|\btreated\b/i;
+/** Matches URL path patterns typical of non-release content pages. */
+export const NON_RELEASE_URL_RE = /\/nih-research-matters\/|\/science-updates\/|\/health\/|\/research\/|\/blog\//i;
+export function looksLikeSearchResultsPage(state) {
+    const haystack = `${state.url}\n${state.title}\n${state.snapshot}`.toLowerCase();
+    return /\bsearch\b|\bsearch results\b|\bquery=/.test(haystack);
+}
+export function normalizeLooseText(value) {
+    return value.toLowerCase().replace(/[^a-z0-9]+/g, ' ').trim();
+}
+export function extractRelevantSnapshotExcerpt(snapshot, terms) {
+    const lines = snapshot.split('\n');
+    const normalizedTerms = terms
+        .map((term) => term.toLowerCase())
+        .filter(Boolean);
+    const matchingIndexes = lines
+        .map((line, index) => ({ line: line.toLowerCase(), index }))
+        .filter(({ line }) => normalizedTerms.some((term) => line.includes(term)))
+        .map(({ index }) => index);
+    if (matchingIndexes.length === 0) {
+        return lines.slice(0, 12).join('\n');
+    }
+    const start = Math.max(0, matchingIndexes[0] - 2);
+    const end = Math.min(lines.length, matchingIndexes[matchingIndexes.length - 1] + 3);
+    return lines.slice(start, end).join('\n');
+}
+export function findLinkRefByExactText(snapshot, text) {
+    const escaped = text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const match = snapshot.match(new RegExp(`- link "${escaped}" \\[ref=([^\\]]+)\\]`));
+    return match?.[1] ? `@${match[1]}` : undefined;
+}
+export function findLinkRefContainingText(snapshot, text) {
+    const escaped = text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    const match = snapshot.match(new RegExp(`- link "([^"]*${escaped}[^"]*)" \\[ref=([^\\]]+)\\]`, 'i'));
+    return match?.[2] ? `@${match[2]}` : undefined;
+}
+export function pushGoalVerificationEvidence(target, entry) {
+    target.push(entry);
+    if (target.length > DEFAULT_MAX_GOAL_VERIFICATION_EVIDENCE) {
+        target.splice(0, target.length - DEFAULT_MAX_GOAL_VERIFICATION_EVIDENCE);
+    }
+}
+export function hasFullDate(text) {
+    return /\b(january|february|march|april|may|june|july|august|september|october|november|december)\s+\d{1,2},\s+\d{4}\b/i.test(text);
+}
+//# sourceMappingURL=utils.js.map

package/dist/runner/utils.js.map

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

package/dist/runner.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Runner barrel — backwards-compatible re-export from src/runner/ modules.
+ *
+ * All existing imports from './runner.js' or '../src/runner.js' continue to work.
+ */
+export { AgentRunner, runAgent, withRetry, buildSearchResultsGuidance, rankSearchCandidates, buildVisibleLinkRecommendation, getVisibleLinkRecommendation, getRankedVisibleLinkCandidates, buildGoalVerificationClaim, collectSearchWorkflowEvidence, shouldAcceptSearchWorkflowCompletion, shouldAcceptScriptBackedCompletion, detectCompletionContentTypeMismatch, detectAiTangleVerifiedOutputState, detectAiTanglePartnerTemplateVisibleState, shouldUseVisibleLinkScout, shouldUseVisibleLinkScoutPage, shouldUseBoundedBranchExplorer, scoreBranchPreview, chooseVisibleLinkOverride, chooseScoutLinkOverride, chooseBranchLinkOverride, chooseSearchResultsNewsTabOverride, chooseSearchQueryOverride, chooseNewsReleasesHubOverride, chooseVisibleNewsReleaseResultOverride, chooseVisibleSearchResultOverride, chooseExpandableListCompletionOverride, } from './runner/index.js';
+export type { RunnerOptions } from './runner/index.js';
+//# sourceMappingURL=runner.d.ts.map

package/dist/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAEL,WAAW,EACX,QAAQ,EAGR,SAAS,EAGT,0BAA0B,EAC1B,oBAAoB,EACpB,8BAA8B,EAC9B,4BAA4B,EAC5B,8BAA8B,EAG9B,0BAA0B,EAC1B,6BAA6B,EAC7B,oCAAoC,EACpC,kCAAkC,EAClC,mCAAmC,EAGnC,iCAAiC,EACjC,yCAAyC,EAGzC,yBAAyB,EACzB,6BAA6B,EAC7B,8BAA8B,EAC9B,kBAAkB,EAGlB,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,kCAAkC,EAClC,yBAAyB,EACzB,6BAA6B,EAC7B,sCAAsC,EACtC,iCAAiC,EACjC,sCAAsC,GACvC,MAAM,mBAAmB,CAAC;AAE3B,YAAY,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/runner.js

@@ -0,0 +1,21 @@
+/**
+ * Runner barrel — backwards-compatible re-export from src/runner/ modules.
+ *
+ * All existing imports from './runner.js' or '../src/runner.js' continue to work.
+ */
+export { 
+// Core
+AgentRunner, runAgent, 
+// Utilities
+withRetry, 
+// Search guidance
+buildSearchResultsGuidance, rankSearchCandidates, buildVisibleLinkRecommendation, getVisibleLinkRecommendation, getRankedVisibleLinkCandidates, 
+// Goal verification
+buildGoalVerificationClaim, collectSearchWorkflowEvidence, shouldAcceptSearchWorkflowCompletion, shouldAcceptScriptBackedCompletion, detectCompletionContentTypeMismatch, 
+// Page analysis
+detectAiTangleVerifiedOutputState, detectAiTanglePartnerTemplateVisibleState, 
+// Scout
+shouldUseVisibleLinkScout, shouldUseVisibleLinkScoutPage, shouldUseBoundedBranchExplorer, scoreBranchPreview, 
+// Overrides
+chooseVisibleLinkOverride, chooseScoutLinkOverride, chooseBranchLinkOverride, chooseSearchResultsNewsTabOverride, chooseSearchQueryOverride, chooseNewsReleasesHubOverride, chooseVisibleNewsReleaseResultOverride, chooseVisibleSearchResultOverride, chooseExpandableListCompletionOverride, } from './runner/index.js';
+//# sourceMappingURL=runner.js.map

package/dist/runner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../src/runner.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO;AACL,OAAO;AACP,WAAW,EACX,QAAQ;AAER,YAAY;AACZ,SAAS;AAET,kBAAkB;AAClB,0BAA0B,EAC1B,oBAAoB,EACpB,8BAA8B,EAC9B,4BAA4B,EAC5B,8BAA8B;AAE9B,oBAAoB;AACpB,0BAA0B,EAC1B,6BAA6B,EAC7B,oCAAoC,EACpC,kCAAkC,EAClC,mCAAmC;AAEnC,gBAAgB;AAChB,iCAAiC,EACjC,yCAAyC;AAEzC,QAAQ;AACR,yBAAyB,EACzB,6BAA6B,EAC7B,8BAA8B,EAC9B,kBAAkB;AAElB,YAAY;AACZ,yBAAyB,EACzB,uBAAuB,EACvB,wBAAwB,EACxB,kCAAkC,EAClC,yBAAyB,EACzB,6BAA6B,EAC7B,sCAAsC,EACtC,iCAAiC,EACjC,sCAAsC,GACvC,MAAM,mBAAmB,CAAC"}

package/dist/supervisor/critic.d.ts

@@ -0,0 +1,29 @@
+import type { PageState, SupervisorDirective, SupervisorSignal, Turn } from '../types.js';
+export interface SupervisorCriticInput {
+    goal: string;
+    currentState: PageState;
+    recentTurns: Turn[];
+    signal: SupervisorSignal;
+    provider: 'openai' | 'anthropic' | 'google' | 'codex-cli' | 'claude-code' | 'sandbox-backend';
+    model: string;
+    useVision?: boolean;
+    apiKey?: string;
+    baseUrl?: string;
+    timeoutMs?: number;
+    debug?: boolean;
+    sandboxBackendType?: string;
+    sandboxBackendProfile?: string;
+    sandboxBackendProvider?: string;
+}
+type SupervisorUserContent = string | Array<{
+    type: 'text';
+    text: string;
+} | {
+    type: 'image';
+    image: string;
+    mediaType: string;
+}>;
+export declare function requestSupervisorDirective(input: SupervisorCriticInput): Promise<SupervisorDirective>;
+export declare function buildSupervisorUserContent(text: string, currentState: PageState, useVision: boolean): SupervisorUserContent;
+export {};
+//# sourceMappingURL=critic.d.ts.map

package/dist/supervisor/critic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"critic.d.ts","sourceRoot":"","sources":["../../src/supervisor/critic.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAEV,SAAS,EACT,mBAAmB,EACnB,gBAAgB,EAChB,IAAI,EACL,MAAM,aAAa,CAAC;AAIrB,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,SAAS,CAAC;IACxB,WAAW,EAAE,IAAI,EAAE,CAAC;IACpB,MAAM,EAAE,gBAAgB,CAAC;IACzB,QAAQ,EAAE,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,aAAa,GAAG,iBAAiB,CAAC;IAC9F,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,KAAK,qBAAqB,GACtB,MAAM,GACN,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAiChG,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC,mBAAmB,CAAC,CA+B9B;AAED,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,SAAS,EACvB,SAAS,EAAE,OAAO,GACjB,qBAAqB,CAavB"}

package/dist/supervisor/critic.js

@@ -0,0 +1,320 @@
+import { generateText } from 'ai';
+import { resolveProviderApiKey, resolveProviderModelName } from '../provider-defaults.js';
+import { generateWithSandboxBackend } from '../providers/sandbox-backend.js';
+const SUPERVISOR_PROMPT = `You are a supervising browser-automation strategist.
+
+You are invoked ONLY when the worker agent is hard-stalled.
+Return one intervention that is most likely to recover progress.
+
+You may receive:
+- a screenshot showing the actual visual layout and modal state
+- a text accessibility snapshot listing interactive elements and @ref IDs
+
+Use BOTH when available. Trust the accessibility snapshot for valid selectors.
+
+DECISIONS:
+- "none": no intervention
+- "inject_feedback": send tactical guidance to the worker agent
+- "force_action": execute one browser action immediately
+- "abort": end the run when progress is impossible
+
+FOR "force_action":
+- Choose one action from: click, type, press, hover, select, scroll, navigate, wait
+- If using selector, use ONLY refs present in ELEMENTS as "@refId"
+- Prefer low-risk unblock actions before destructive actions
+
+Respond ONLY JSON:
+{
+  "decision": "inject_feedback",
+  "reason": "why this intervention should work",
+  "feedback": "clear tactical instruction for the worker",
+  "confidence": 0.78,
+  "action": { "action": "click", "selector": "@abc123" }
+}`;
+export async function requestSupervisorDirective(input) {
+    const turnSummary = summarizeTurns(input.recentTurns);
+    const text = [
+        `GOAL: ${input.goal}`,
+        '',
+        `STALL SIGNAL: severity=${input.signal.severity}; reasons=${input.signal.reasons.join(', ') || 'none'}`,
+        `METRICS: unchangedTurns=${input.signal.unchangedTurns}, repeatedActionCount=${input.signal.repeatedActionCount}, errorTurns=${input.signal.errorTurns}, verificationFailures=${input.signal.verificationFailures}`,
+        '',
+        'RECENT TURNS:',
+        turnSummary || '(none)',
+        '',
+        'CURRENT PAGE:',
+        `URL: ${input.currentState.url}`,
+        `Title: ${input.currentState.title}`,
+        'ELEMENTS:',
+        input.currentState.snapshot,
+        '',
+        'Pick the best intervention now.',
+    ].join('\n');
+    const userContent = buildSupervisorUserContent(text, input.currentState, input.useVision !== false);
+    const raw = (await generateSupervisorText(input, userContent)).trim();
+    if (input.debug) {
+        console.log('[Supervisor] Critic response:', raw.slice(0, 400));
+    }
+    if (!raw) {
+        return { decision: 'none', reason: 'empty supervisor response' };
+    }
+    return parseDirective(raw, input.currentState.snapshot);
+}
+export function buildSupervisorUserContent(text, currentState, useVision) {
+    if (!useVision || !currentState.screenshot) {
+        return text;
+    }
+    return [
+        { type: 'text', text },
+        {
+            type: 'image',
+            image: currentState.screenshot,
+            mediaType: 'image/jpeg',
+        },
+    ];
+}
+function summarizeTurns(turns) {
+    return turns
+        .slice(-8)
+        .map((turn) => {
+        const status = turn.error
+            ? `error=${turn.error}`
+            : turn.verificationFailure
+                ? `verifyFail=${turn.verificationFailure}`
+                : 'ok';
+        return `- T${turn.turn}: ${turn.action.action} @ ${truncate(turn.state.url, 80)} | ${status}`;
+    })
+        .join('\n');
+}
+function truncate(input, maxLen) {
+    if (input.length <= maxLen)
+        return input;
+    return `${input.slice(0, maxLen - 3)}...`;
+}
+function parseDirective(raw, snapshot) {
+    try {
+        let text = raw.trim();
+        if (text.startsWith('```')) {
+            text = text.replace(/^```(?:json)?\n?/, '').replace(/\n?```$/, '');
+        }
+        const parsed = JSON.parse(text);
+        const decision = normalizeDecision(parsed.decision);
+        const reason = typeof parsed.reason === 'string' ? parsed.reason : undefined;
+        const feedback = typeof parsed.feedback === 'string' ? parsed.feedback : undefined;
+        const confidence = clampConfidence(parsed.confidence);
+        if (decision !== 'force_action') {
+            return { decision, reason, feedback, confidence, raw };
+        }
+        const candidateAction = normalizeAction(parsed.action);
+        if (!candidateAction) {
+            return {
+                decision: 'inject_feedback',
+                reason: reason || 'invalid force_action payload',
+                feedback: feedback || 'Force action was invalid. Re-plan with a different strategy.',
+                confidence,
+                raw,
+            };
+        }
+        if (!validateSelectorRefs(candidateAction, snapshot)) {
+            return {
+                decision: 'inject_feedback',
+                reason: reason || 'force_action selector not present in current snapshot',
+                feedback: feedback || 'Use only selectors visible in current ELEMENTS refs.',
+                confidence,
+                raw,
+            };
+        }
+        return { decision, action: candidateAction, reason, feedback, confidence, raw };
+    }
+    catch {
+        return { decision: 'none', reason: 'failed to parse supervisor JSON', raw };
+    }
+}
+function normalizeDecision(value) {
+    if (value === 'inject_feedback' || value === 'force_action' || value === 'abort') {
+        return value;
+    }
+    return 'none';
+}
+function clampConfidence(value) {
+    if (typeof value !== 'number' || Number.isNaN(value))
+        return undefined;
+    return Math.max(0, Math.min(1, value));
+}
+function normalizeAction(value) {
+    if (!value || typeof value !== 'object')
+        return null;
+    const data = value;
+    const actionType = typeof data.action === 'string' ? data.action : '';
+    const requireStr = (field) => {
+        const v = data[field];
+        return typeof v === 'string' && v.length > 0 ? v : null;
+    };
+    const optionalStr = (field) => {
+        const v = data[field];
+        return typeof v === 'string' ? v : '';
+    };
+    const asNumber = (field, fallback) => {
+        const v = data[field];
+        return typeof v === 'number' && Number.isFinite(v) ? v : fallback;
+    };
+    switch (actionType) {
+        case 'click': {
+            const selector = requireStr('selector');
+            return selector ? { action: 'click', selector } : null;
+        }
+        case 'type': {
+            const selector = requireStr('selector');
+            if (!selector)
+                return null;
+            return { action: 'type', selector, text: optionalStr('text') };
+        }
+        case 'press': {
+            const selector = requireStr('selector');
+            const key = requireStr('key');
+            if (!selector || !key)
+                return null;
+            return { action: 'press', selector, key };
+        }
+        case 'hover': {
+            const selector = requireStr('selector');
+            return selector ? { action: 'hover', selector } : null;
+        }
+        case 'select': {
+            const selector = requireStr('selector');
+            if (!selector)
+                return null;
+            return { action: 'select', selector, value: optionalStr('value') };
+        }
+        case 'scroll': {
+            const direction = data.direction === 'up' ? 'up' : 'down';
+            const amount = asNumber('amount', 500);
+            const selector = typeof data.selector === 'string' ? data.selector : undefined;
+            return { action: 'scroll', direction, amount, ...(selector ? { selector } : {}) };
+        }
+        case 'navigate': {
+            const url = requireStr('url');
+            if (!url || !/^https?:\/\//i.test(url))
+                return null;
+            return { action: 'navigate', url };
+        }
+        case 'wait':
+            return { action: 'wait', ms: asNumber('ms', 1000) };
+        default:
+            return null;
+    }
+}
+function validateSelectorRefs(action, snapshot) {
+    if (!('selector' in action) || typeof action.selector !== 'string')
+        return true;
+    const selector = action.selector.trim();
+    if (!selector.startsWith('@'))
+        return true;
+    const knownRefs = new Set(Array.from(snapshot.matchAll(/\[ref=([^\]]+)\]/g)).map((match) => `@${match[1]}`));
+    return knownRefs.has(selector);
+}
+function shouldSendTemperature(modelName) {
+    return !/^gpt-5(?:[.-]|$)/i.test(modelName);
+}
+async function getModel(config) {
+    const modelName = resolveProviderModelName(config.provider, config.model);
+    const apiKey = resolveProviderApiKey(config.provider, config.apiKey);
+    switch (config.provider) {
+        case 'anthropic': {
+            const { createAnthropic } = await import('@ai-sdk/anthropic');
+            const provider = createAnthropic({
+                apiKey,
+                ...(config.baseUrl ? { baseURL: config.baseUrl } : {}),
+            });
+            return provider(modelName);
+        }
+        case 'google': {
+            const { createGoogleGenerativeAI } = await import('@ai-sdk/google');
+            const provider = createGoogleGenerativeAI({
+                apiKey,
+                ...(config.baseUrl ? { baseURL: config.baseUrl } : {}),
+            });
+            return provider(modelName);
+        }
+        case 'codex-cli': {
+            const { codexExec } = await import('ai-sdk-provider-codex-cli');
+            const env = {};
+            if (apiKey)
+                env.OPENAI_API_KEY = apiKey;
+            return 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 } : {}),
+            });
+        }
+        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,
+                    ...(config.debug ? { verbose: true } : {}),
+                    ...(config.debug
+                        ? {
+                            stderr: (chunk) => {
+                                const line = chunk.trim();
+                                if (line)
+                                    console.error(`[claude-code] ${line}`);
+                            },
+                        }
+                        : {}),
+                    ...(Object.keys(env).length > 0 ? { env } : {}),
+                },
+            });
+            return provider(modelName);
+        }
+        default: {
+            const { createOpenAI } = await import('@ai-sdk/openai');
+            const provider = createOpenAI({
+                apiKey: apiKey || '',
+                ...(config.baseUrl ? { baseURL: config.baseUrl } : {}),
+            });
+            return provider(modelName);
+        }
+    }
+}
+async function generateSupervisorText(input, userContent) {
+    const modelName = resolveProviderModelName(input.provider, input.model, {
+        sandboxBackendType: input.provider === 'sandbox-backend' ? input.sandboxBackendType : undefined,
+    });
+    if (input.provider === 'sandbox-backend') {
+        const result = await generateWithSandboxBackend({
+            model: modelName,
+            system: SUPERVISOR_PROMPT,
+            messages: [{ role: 'user', content: userContent }],
+            timeoutMs: input.timeoutMs ?? 45_000,
+            debug: input.debug,
+            backendType: input.sandboxBackendType,
+            backendProfile: input.sandboxBackendProfile,
+            backendModelProvider: input.sandboxBackendProvider,
+        });
+        return result.text ?? '';
+    }
+    const model = await getModel({
+        provider: input.provider,
+        model: modelName,
+        apiKey: input.apiKey,
+        baseUrl: input.baseUrl,
+        debug: input.debug,
+    });
+    const result = await generateText({
+        model,
+        system: SUPERVISOR_PROMPT,
+        messages: [{ role: 'user', content: userContent }],
+        ...(shouldSendTemperature(modelName) ? { temperature: 0 } : {}),
+        ...(input.provider === 'codex-cli' || input.provider === 'claude-code' ? {} : { maxOutputTokens: 700 }),
+        abortSignal: AbortSignal.timeout(input.timeoutMs ?? 45_000),
+    });
+    return result.text ?? '';
+}
+//# sourceMappingURL=critic.js.map

package/dist/supervisor/critic.js.map

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

package/dist/supervisor/policy.d.ts

@@ -0,0 +1,11 @@
+import type { PageState, SupervisorSignal, Turn } from '../types.js';
+export interface SupervisorPolicyInput {
+    recentTurns: Turn[];
+    currentState: PageState;
+    currentTurn: number;
+    maxTurns: number;
+    window?: number;
+}
+export declare function detectSupervisorSignal(input: SupervisorPolicyInput): SupervisorSignal;
+export declare function formatSupervisorSignal(signal: SupervisorSignal): string;
+//# sourceMappingURL=policy.d.ts.map

package/dist/supervisor/policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"policy.d.ts","sourceRoot":"","sources":["../../src/supervisor/policy.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAU,SAAS,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAE7E,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,IAAI,EAAE,CAAC;IACpB,YAAY,EAAE,SAAS,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,qBAAqB,GAAG,gBAAgB,CA4DrF;AAED,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,gBAAgB,GAAG,MAAM,CAUvE"}