@pcamarajr/scout 0.6.0 → 0.7.1

package/dist/runner/ai-runner.d.ts

@@ -1,40 +1,16 @@
 import type { ScoutConfig } from "../config.js";
-import type { Scenario, Step, Verdict } from "../types.js";
+import type { Scenario } from "../types.js";
+import { describeNoVerdict, relativizeUrl, type AiRunOutcome, type QueryEndInfo } from "./engines/types.js";
 import { BrowserSession } from "./browser.js";
-export interface AiRunOutcome {
-    verdict: Verdict;
-    reason: string;
-    steps: Step[];
-    transcript: string[];
-    /**
-     * Set when the runner itself failed to produce a verdict (agent never called
-     * scout_verdict) — NOT a UI judgment. Callers may retry and must report it
-     * as an infrastructure failure, never as "the scenario is blocked by the UI".
-     */
-    runnerFailure?: string;
-}
-/** How the SDK query ended, for no-verdict diagnostics. */
-export interface QueryEndInfo {
-    subtype: string;
-    numTurns?: number;
-    errors?: string[];
-}
+export { describeNoVerdict, relativizeUrl };
+export type { AiRunOutcome, QueryEndInfo };
 /**
- * Human-readable cause for a run that ended without scout_verdict.
- * Distinguishes runner-infrastructure causes (turn budget, SDK errors) from
- * an agent that simply stopped talking.
- */
-export declare function describeNoVerdict(end: QueryEndInfo | undefined, maxTurns: number): string;
-/**
- * Records navigation relative to the configured baseUrl so cached scripts
- * survive --base-url / SCOUT_BASE_URL pointing at another server. URLs that
- * merely share the prefix (http://localhost:3000x) or live on other hosts
- * stay absolute.
- */
-export declare function relativizeUrl(url: string, baseUrl: string): string;
-/**
- * AI-driven run: a Claude agent navigates the real browser to verify the
- * scenario. Every successful action is recorded as a deterministic Step so
- * subsequent runs can replay without the LLM.
+ * AI-driven run, engine-neutral orchestrator. A Claude agent (via the Agent SDK
+ * by default, or the Vercel AI SDK when selected) navigates the real browser to
+ * verify the scenario. Every successful action is recorded as a deterministic
+ * Step so subsequent runs can replay without the LLM.
+ *
+ * Verdict capture, the forced-verdict rescue, and outcome assembly live HERE,
+ * above both engines, so behavior is identical regardless of engine.
  */
 export declare function runWithAgent(session: BrowserSession, scenario: Scenario, config: ScoutConfig): Promise<AiRunOutcome>;

package/dist/runner/ai-runner.js

@@ -1,187 +1,30 @@
-import { createSdkMcpServer, query, tool } from "@anthropic-ai/claude-agent-sdk";
-import { z } from "zod";
-import { resolveEnvValue } from "./browser.js";
+import { inferProvider } from "../credentials.js";
+import { createScoutTools } from "./agent-tools.js";
+import { selectEngine } from "./engines/index.js";
+import { describeNoVerdict, relativizeUrl, } from "./engines/types.js";
+// Re-exported from their new home so existing importers (src/index.ts, callers)
+// keep working unchanged.
+export { describeNoVerdict, relativizeUrl };
 /**
- * Human-readable cause for a run that ended without scout_verdict.
- * Distinguishes runner-infrastructure causes (turn budget, SDK errors) from
- * an agent that simply stopped talking.
- */
-export function describeNoVerdict(end, maxTurns) {
-    if (!end)
-        return "a sessão do agente terminou sem emitir resultado (subprocesso morreu?)";
-    switch (end.subtype) {
-        case "error_max_turns":
-            return `o agente estourou o limite de ${maxTurns} turns sem chamar scout_verdict`;
-        case "error_during_execution":
-            return `erro durante a execução do agente${end.errors?.length ? `: ${end.errors.join("; ")}` : ""}`;
-        case "success":
-            return "o agente encerrou normalmente sem chamar scout_verdict";
-        default:
-            return `a sessão do agente terminou com "${end.subtype}"${end.errors?.length ? `: ${end.errors.join("; ")}` : ""}`;
-    }
-}
-/**
- * Records navigation relative to the configured baseUrl so cached scripts
- * survive --base-url / SCOUT_BASE_URL pointing at another server. URLs that
- * merely share the prefix (http://localhost:3000x) or live on other hosts
- * stay absolute.
- */
-export function relativizeUrl(url, baseUrl) {
-    const base = baseUrl.replace(/\/+$/, "");
-    if (url === base || url === `${base}/`)
-        return "/";
-    if (url.startsWith(base)) {
-        const rest = url.slice(base.length);
-        if (rest.startsWith("/") || rest.startsWith("?") || rest.startsWith("#"))
-            return rest;
-    }
-    return url;
-}
-/**
- * AI-driven run: a Claude agent navigates the real browser to verify the
- * scenario. Every successful action is recorded as a deterministic Step so
- * subsequent runs can replay without the LLM.
+ * AI-driven run, engine-neutral orchestrator. A Claude agent (via the Agent SDK
+ * by default, or the Vercel AI SDK when selected) navigates the real browser to
+ * verify the scenario. Every successful action is recorded as a deterministic
+ * Step so subsequent runs can replay without the LLM.
+ *
+ * Verdict capture, the forced-verdict rescue, and outcome assembly live HERE,
+ * above both engines, so behavior is identical regardless of engine.
  */
 export async function runWithAgent(session, scenario, config) {
     const steps = [];
     const transcript = [];
     let verdict;
-    const record = (step) => steps.push(step);
-    const afterAction = async () => {
-        const snap = await session.snapshot();
-        return session.formatSnapshot(snap);
-    };
-    const ok = (text) => ({ content: [{ type: "text", text }] });
-    const fail = (error) => ({
-        content: [{ type: "text", text: `ERRO: ${error instanceof Error ? error.message : String(error)}` }],
-        isError: true,
-    });
-    const browserServer = createSdkMcpServer({
-        name: "browser",
-        version: "1.0.0",
-        tools: [
-            tool("browser_navigate", "Navega para uma URL (absoluta ou relativa ao baseUrl do app). Para tokens/segredos na URL use placeholder $ENV:VAR_NAME — resolvido em runtime, nunca passa por você.", { url: z.string().describe("Ex: /login, /renovar?token=$ENV:TOKEN ou https://...") }, async ({ url }) => {
-                try {
-                    await session.navigate(url);
-                    record({ kind: "navigate", url: relativizeUrl(url, config.baseUrl) });
-                    return ok(await afterAction());
-                }
-                catch (e) {
-                    return fail(e);
-                }
-            }),
-            tool("browser_snapshot", "Retorna o estado atual da página: URL, título, elementos interativos numerados [ref] e texto visível. Use sempre que precisar decidir a próxima ação.", {}, async () => {
-                try {
-                    return ok(await afterAction());
-                }
-                catch (e) {
-                    return fail(e);
-                }
-            }),
-            tool("browser_click", "Clica no elemento identificado pelo [ref] do último snapshot.", { ref: z.number().int().describe("Ref numérico do snapshot") }, async ({ ref }) => {
-                try {
-                    const target = await session.click(ref);
-                    record({ kind: "click", target });
-                    return ok(`Cliquei em ${target.description}.\n\n${await afterAction()}`);
-                }
-                catch (e) {
-                    return fail(e);
-                }
-            }),
-            tool("browser_fill", "Preenche um campo. Para credenciais/segredos use placeholder $ENV:VAR_NAME — o valor real vem do ambiente e nunca passa por você.", {
-                ref: z.number().int(),
-                value: z.string().describe("Texto literal ou $ENV:VAR_NAME"),
-            }, async ({ ref, value }) => {
-                try {
-                    const target = await session.fill(ref, resolveEnvValue(value));
-                    record({ kind: "fill", target, value });
-                    return ok(`Preenchi ${target.description}.`);
-                }
-                catch (e) {
-                    return fail(e);
-                }
-            }),
-            tool("browser_select", "Seleciona uma opção em um <select> pelo value ou label.", { ref: z.number().int(), value: z.string() }, async ({ ref, value }) => {
-                try {
-                    const target = await session.select(ref, resolveEnvValue(value));
-                    record({ kind: "select", target, value });
-                    return ok(`Selecionei "${value}" em ${target.description}.\n\n${await afterAction()}`);
-                }
-                catch (e) {
-                    return fail(e);
-                }
-            }),
-            tool("browser_press", "Pressiona uma tecla (Enter, Escape, Tab, ArrowDown...).", { key: z.string() }, async ({ key }) => {
-                try {
-                    await session.press(key);
-                    record({ kind: "press", key });
-                    return ok(await afterAction());
-                }
-                catch (e) {
-                    return fail(e);
-                }
-            }),
-            tool("browser_wait_for", "Espera texto aparecer na página OU a URL conter um trecho. Use após ações que disparam carregamento.", {
-                text: z.string().optional().describe("Texto que deve ficar visível"),
-                urlContains: z.string().optional().describe("Trecho esperado na URL"),
-            }, async ({ text, urlContains }) => {
-                try {
-                    if (text) {
-                        await session.waitForText(text);
-                        record({ kind: "waitForText", text });
-                    }
-                    if (urlContains) {
-                        await session.waitForUrl(urlContains);
-                        record({ kind: "waitForUrl", pattern: urlContains });
-                    }
-                    return ok(await afterAction());
-                }
-                catch (e) {
-                    return fail(e);
-                }
-            }),
-            tool("browser_assert", "Registra uma verificação do comportamento esperado. Use para CADA expectativa do cenário — essas asserções viram o teste determinístico.", {
-                visibleText: z.string().optional().describe("Texto que DEVE estar visível"),
-                notVisibleText: z.string().optional().describe("Texto que NÃO deve estar visível"),
-                urlContains: z.string().optional().describe("Trecho que a URL deve conter"),
-            }, async ({ visibleText, notVisibleText, urlContains }) => {
-                try {
-                    if (visibleText) {
-                        await session.assertVisible(visibleText);
-                        record({ kind: "assertVisible", text: visibleText });
-                    }
-                    if (notVisibleText) {
-                        await session.assertNotVisible(notVisibleText);
-                        record({ kind: "assertNotVisible", text: notVisibleText });
-                    }
-                    if (urlContains) {
-                        await session.assertUrl(urlContains);
-                        record({ kind: "assertUrl", pattern: urlContains });
-                    }
-                    return ok("Asserção passou.");
-                }
-                catch (e) {
-                    return fail(e);
-                }
-            }),
-            tool("browser_screenshot", "Captura screenshot como evidência. Use em momentos-chave (estado final, paywall, erro encontrado).", { label: z.string().describe("Rótulo curto, ex: 'paywall-exibido'") }, async ({ label }) => {
-                try {
-                    await session.screenshot(label);
-                    record({ kind: "screenshot", label });
-                    return ok(`Screenshot "${label}" salvo.`);
-                }
-                catch (e) {
-                    return fail(e);
-                }
-            }),
-            tool("scout_verdict", "OBRIGATÓRIO ao final: registra o veredito da verificação. Após chamar, encerre.", {
-                verdict: z.enum(["verified", "failed", "partial", "blocked"]),
-                reason: z.string().describe("Justificativa objetiva, citando o que foi observado"),
-            }, async (args) => {
-                verdict = args;
-                return ok("Veredito registrado. Encerre agora.");
-            }),
-        ],
+    const tools = createScoutTools({
+        session,
+        config,
+        record: (step) => steps.push(step),
+        setVerdict: (v) => {
+            verdict = v;
+        },
     });
     const profileInfo = scenario.profile
         ? `Sessão autenticada com o profile "${scenario.profile}"${config.profiles[scenario.profile]?.description ? ` (${config.profiles[scenario.profile].description})` : ""}. Você JÁ está logado — não faça login de novo a menos que o cenário peça.`
@@ -214,65 +57,29 @@ Regras:
 - Não re-preencha um campo que você já preencheu, a menos que a página tenha limpado o valor — cada ação sua vira um passo do script gravado, e passos duplicados são ruído que fragiliza o replay.
 - Seja econômico: não explore além do cenário. Seu orçamento é de ${config.maxTurns} ações.
 - Se você está repetindo tentativas sem progresso (overlay bloqueando, elemento que não aparece), PARE e chame scout_verdict (partial ou blocked) explicando o obstáculo — um veredito parcial vale mais que morrer sem veredito.`;
-    const baseOptions = {
+    const userPrompt = `Verifique este cenário de QA:\n\n## ${scenario.name}\n\n${scenario.scenario}${scenario.notes ? `\n\nNotas: ${scenario.notes}` : ""}`;
+    const provider = inferProvider(config.model);
+    const engine = selectEngine(provider, config.engine);
+    const run = await engine.run({
+        provider,
         model: config.model,
         systemPrompt,
-        mcpServers: { browser: browserServer },
-        allowedTools: ["mcp__browser__*"],
-        tools: [],
-        settingSources: [],
-        permissionMode: "bypassPermissions",
-    };
-    let sessionId;
-    let endInfo;
-    /** Drains a query, collecting transcript/session/end info. Always aborts at the end so no claude-agent-sdk subprocess outlives the run. */
-    const drain = async (q, controller) => {
-        try {
-            for await (const message of q) {
-                if ("session_id" in message && message.session_id)
-                    sessionId = message.session_id;
-                if (message.type === "assistant") {
-                    for (const block of message.message.content) {
-                        if (block.type === "text" && block.text.trim())
-                            transcript.push(block.text.trim());
-                    }
-                }
-                if (message.type === "result") {
-                    endInfo = {
-                        subtype: message.subtype,
-                        numTurns: message.num_turns,
-                        errors: "errors" in message ? message.errors : undefined,
-                    };
-                    break;
-                }
-            }
-        }
-        finally {
-            controller.abort();
-        }
-    };
-    const mainController = new AbortController();
-    try {
-        await drain(query({
-            prompt: `Verifique este cenário de QA:\n\n## ${scenario.name}\n\n${scenario.scenario}${scenario.notes ? `\n\nNotas: ${scenario.notes}` : ""}`,
-            options: { ...baseOptions, maxTurns: config.maxTurns, abortController: mainController },
-        }), mainController);
-    }
-    catch (error) {
-        endInfo = { subtype: "sdk_error", errors: [error instanceof Error ? error.message : String(error)] };
-    }
+        userPrompt,
+        tools,
+        maxTurns: config.maxTurns,
+    });
+    transcript.push(...run.transcript);
+    let endInfo = run.end;
     // Forced-verdict rescue: the agent died mute (typically error_max_turns).
     // Resume the same session with a tiny turn budget and demand scout_verdict
     // with whatever it observed — a partial verdict beats a silent death.
     const mainCause = verdict ? undefined : describeNoVerdict(endInfo, config.maxTurns);
-    if (!verdict && sessionId) {
+    if (!verdict) {
         transcript.push(`[scout] Agente encerrou sem veredito (${mainCause}) — resgate: exigindo scout_verdict com o que foi observado.`);
-        const rescueController = new AbortController();
         try {
-            await drain(query({
-                prompt: "Sua verificação atingiu o limite de ações. NÃO execute mais nenhuma ação de browser. Chame scout_verdict AGORA com base no que você já observou: 'partial' se a verificação ficou incompleta, 'blocked' se você nem chegou ao fluxo, 'failed'/'verified' apenas se já tinha evidência suficiente.",
-                options: { ...baseOptions, maxTurns: 4, resume: sessionId, abortController: rescueController },
-            }), rescueController);
+            const rescue = await run.resume("Sua verificação atingiu o limite de ações. NÃO execute mais nenhuma ação de browser. Chame scout_verdict AGORA com base no que você já observou: 'partial' se a verificação ficou incompleta, 'blocked' se você nem chegou ao fluxo, 'failed'/'verified' apenas se já tinha evidência suficiente.", 4);
+            transcript.push(...rescue.transcript);
+            endInfo = rescue.end;
         }
         catch (error) {
             transcript.push(`[scout] Resgate de veredito falhou: ${error instanceof Error ? error.message : String(error)}`);

package/dist/runner/ai-runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"ai-runner.js","sourceRoot":"","sources":["../../src/runner/ai-runner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,gCAAgC,CAAC;AACjF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAkB,eAAe,EAAE,MAAM,cAAc,CAAC;AAsB/D;;;;GAIG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAA6B,EAAE,QAAgB;IAC/E,IAAI,CAAC,GAAG;QAAE,OAAO,wEAAwE,CAAC;IAC1F,QAAQ,GAAG,CAAC,OAAO,EAAE,CAAC;QACpB,KAAK,iBAAiB;YACpB,OAAO,iCAAiC,QAAQ,iCAAiC,CAAC;QACpF,KAAK,wBAAwB;YAC3B,OAAO,oCAAoC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACtG,KAAK,SAAS;YACZ,OAAO,wDAAwD,CAAC;QAClE;YACE,OAAO,oCAAoC,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;IACvH,CAAC;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,GAAW,EAAE,OAAe;IACxD,MAAM,IAAI,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACzC,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IACnD,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,OAAO,IAAI,CAAC;IACxF,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,OAAuB,EACvB,QAAkB,EAClB,MAAmB;IAEnB,MAAM,KAAK,GAAW,EAAE,CAAC;IACzB,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,OAAyD,CAAC;IAE9D,MAAM,MAAM,GAAG,CAAC,IAAU,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEhD,MAAM,WAAW,GAAG,KAAK,IAAqB,EAAE;QAC9C,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,QAAQ,EAAE,CAAC;QACtC,OAAO,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC;IAEF,MAAM,EAAE,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,CAAC,EAAE,CAAC,CAAC;IAC9E,MAAM,IAAI,GAAG,CAAC,KAAc,EAAE,EAAE,CAAC,CAAC;QAChC,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,SAAS,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC;QAC7G,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;IAEH,MAAM,aAAa,GAAG,kBAAkB,CAAC;QACvC,IAAI,EAAE,SAAS;QACf,OAAO,EAAE,OAAO;QAChB,KAAK,EAAE;YACL,IAAI,CACF,kBAAkB,EAClB,uKAAuK,EACvK,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sDAAsD,CAAC,EAAE,EACpF,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;gBAChB,IAAI,CAAC;oBACH,MAAM,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;oBAC5B,MAAM,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,GAAG,EAAE,aAAa,CAAC,GAAG,EAAE,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;oBACtE,OAAO,EAAE,CAAC,MAAM,WAAW,EAAE,CAAC,CAAC;gBACjC,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;gBACjB,CAAC;YACH,CAAC,CACF;YACD,IAAI,CACF,kBAAkB,EAClB,uJAAuJ,EACvJ,EAAE,EACF,KAAK,IAAI,EAAE;gBACT,IAAI,CAAC;oBACH,OAAO,EAAE,CAAC,MAAM,WAAW,EAAE,CAAC,CAAC;gBACjC,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;gBACjB,CAAC;YACH,CAAC,CACF;YACD,IAAI,CACF,eAAe,EACf,+DAA+D,EAC/D,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,0BAA0B,CAAC,EAAE,EAC9D,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;gBAChB,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBACxC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;oBAClC,OAAO,EAAE,CAAC,cAAc,MAAM,CAAC,WAAW,QAAQ,MAAM,WAAW,EAAE,EAAE,CAAC,CAAC;gBAC3E,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;gBACjB,CAAC;YACH,CAAC,CACF;YACD,IAAI,CACF,cAAc,EACd,mIAAmI,EACnI;gBACE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE;gBACrB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,gCAAgC,CAAC;aAC7D,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE;gBACvB,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;oBAC/D,MAAM,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;oBACxC,OAAO,EAAE,CAAC,YAAY,MAAM,CAAC,WAAW,GAAG,CAAC,CAAC;gBAC/C,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;gBACjB,CAAC;YACH,CAAC,CACF;YACD,IAAI,CACF,gBAAgB,EAChB,yDAAyD,EACzD,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EAC5C,KAAK,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,EAAE,EAAE;gBACvB,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;oBACjE,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;oBAC1C,OAAO,EAAE,CAAC,eAAe,KAAK,QAAQ,MAAM,CAAC,WAAW,QAAQ,MAAM,WAAW,EAAE,EAAE,CAAC,CAAC;gBACzF,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;gBACjB,CAAC;YACH,CAAC,CACF;YACD,IAAI,CACF,eAAe,EACf,yDAAyD,EACzD,EAAE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,EACnB,KAAK,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE;gBAChB,IAAI,CAAC;oBACH,MAAM,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;oBACzB,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC;oBAC/B,OAAO,EAAE,CAAC,MAAM,WAAW,EAAE,CAAC,CAAC;gBACjC,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;gBACjB,CAAC;YACH,CAAC,CACF;YACD,IAAI,CACF,kBAAkB,EAClB,sGAAsG,EACtG;gBACE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;gBACpE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wBAAwB,CAAC;aACtE,EACD,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,EAAE,EAAE,EAAE;gBAC9B,IAAI,CAAC;oBACH,IAAI,IAAI,EAAE,CAAC;wBACT,MAAM,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;wBAChC,MAAM,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;oBACxC,CAAC;oBACD,IAAI,WAAW,EAAE,CAAC;wBAChB,MAAM,OAAO,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;wBACtC,MAAM,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;oBACvD,CAAC;oBACD,OAAO,EAAE,CAAC,MAAM,WAAW,EAAE,CAAC,CAAC;gBACjC,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;gBACjB,CAAC;YACH,CAAC,CACF;YACD,IAAI,CACF,gBAAgB,EAChB,0IAA0I,EAC1I;gBACE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;gBAC3E,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,kCAAkC,CAAC;gBAClF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8BAA8B,CAAC;aAC5E,EACD,KAAK,EAAE,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,EAAE,EAAE;gBACrD,IAAI,CAAC;oBACH,IAAI,WAAW,EAAE,CAAC;wBAChB,MAAM,OAAO,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC;wBACzC,MAAM,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;oBACvD,CAAC;oBACD,IAAI,cAAc,EAAE,CAAC;wBACnB,MAAM,OAAO,CAAC,gBAAgB,CAAC,cAAc,CAAC,CAAC;wBAC/C,MAAM,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC;oBAC7D,CAAC;oBACD,IAAI,WAAW,EAAE,CAAC;wBAChB,MAAM,OAAO,CAAC,SAAS,CAAC,WAAW,CAAC,CAAC;wBACrC,MAAM,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;oBACtD,CAAC;oBACD,OAAO,EAAE,CAAC,kBAAkB,CAAC,CAAC;gBAChC,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;gBACjB,CAAC;YACH,CAAC,CACF;YACD,IAAI,CACF,oBAAoB,EACpB,oGAAoG,EACpG,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qCAAqC,CAAC,EAAE,EACrE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;gBAClB,IAAI,CAAC;oBACH,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;oBAChC,MAAM,CAAC,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;oBACtC,OAAO,EAAE,CAAC,eAAe,KAAK,UAAU,CAAC,CAAC;gBAC5C,CAAC;gBAAC,OAAO,CAAC,EAAE,CAAC;oBACX,OAAO,IAAI,CAAC,CAAC,CAAC,CAAC;gBACjB,CAAC;YACH,CAAC,CACF;YACD,IAAI,CACF,eAAe,EACf,iFAAiF,EACjF;gBACE,OAAO,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC;gBAC7D,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;aACnF,EACD,KAAK,EAAE,IAAI,EAAE,EAAE;gBACb,OAAO,GAAG,IAAI,CAAC;gBACf,OAAO,EAAE,CAAC,qCAAqC,CAAC,CAAC;YACnD,CAAC,CACF;SACF;KACF,CAAC,CAAC;IAEH,MAAM,WAAW,GAAG,QAAQ,CAAC,OAAO;QAClC,CAAC,CAAC,qCAAqC,QAAQ,CAAC,OAAO,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC,EAAE,4EAA4E;QAClP,CAAC,CAAC,8BAA8B,CAAC;IAEnC,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACvF,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM;QAC5B,CAAC,CAAC,kGAAkG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;QACjJ,CAAC,CAAC,EAAE,CAAC;IAEP,MAAM,YAAY,GAAG;;YAEX,MAAM,CAAC,OAAO;EACxB,WAAW;EACX,OAAO;;;;;;;;;;;;;;;;;;oEAkB2D,MAAM,CAAC,QAAQ;kOAC+I,CAAC;IAEjO,MAAM,WAAW,GAAG;QAClB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,YAAY;QACZ,UAAU,EAAE,EAAE,OAAO,EAAE,aAAa,EAAE;QACtC,YAAY,EAAE,CAAC,iBAAiB,CAAC;QACjC,KAAK,EAAE,EAAQ;QACf,cAAc,EAAE,EAAQ;QACxB,cAAc,EAAE,mBAA4B;KAC7C,CAAC;IAEF,IAAI,SAA6B,CAAC;IAClC,IAAI,OAAiC,CAAC;IAEtC,2IAA2I;IAC3I,MAAM,KAAK,GAAG,KAAK,EAAE,CAA2B,EAAE,UAA2B,EAAiB,EAAE;QAC9F,IAAI,CAAC;YACH,IAAI,KAAK,EAAE,MAAM,OAAO,IAAI,CAAC,EAAE,CAAC;gBAC9B,IAAI,YAAY,IAAI,OAAO,IAAI,OAAO,CAAC,UAAU;oBAAE,SAAS,GAAG,OAAO,CAAC,UAAU,CAAC;gBAClF,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;oBACjC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;wBAC5C,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;4BAAE,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;oBACrF,CAAC;gBACH,CAAC;gBACD,IAAI,OAAO,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;oBAC9B,OAAO,GAAG;wBACR,OAAO,EAAE,OAAO,CAAC,OAAO;wBACxB,QAAQ,EAAE,OAAO,CAAC,SAAS;wBAC3B,MAAM,EAAE,QAAQ,IAAI,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;qBACzD,CAAC;oBACF,MAAM;gBACR,CAAC;YACH,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,UAAU,CAAC,KAAK,EAAE,CAAC;QACrB,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,cAAc,GAAG,IAAI,eAAe,EAAE,CAAC;IAC7C,IAAI,CAAC;QACH,MAAM,KAAK,CACT,KAAK,CAAC;YACJ,MAAM,EAAE,uCAAuC,QAAQ,CAAC,IAAI,OAAO,QAAQ,CAAC,QAAQ,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE;YAC7I,OAAO,EAAE,EAAE,GAAG,WAAW,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,eAAe,EAAE,cAAc,EAAE;SACxF,CAAC,EACF,cAAc,CACf,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;IACvG,CAAC;IAED,0EAA0E;IAC1E,2EAA2E;IAC3E,sEAAsE;IACtE,MAAM,SAAS,GAAG,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;IACpF,IAAI,CAAC,OAAO,IAAI,SAAS,EAAE,CAAC;QAC1B,UAAU,CAAC,IAAI,CACb,yCAAyC,SAAS,8DAA8D,CACjH,CAAC;QACF,MAAM,gBAAgB,GAAG,IAAI,eAAe,EAAE,CAAC;QAC/C,IAAI,CAAC;YACH,MAAM,KAAK,CACT,KAAK,CAAC;gBACJ,MAAM,EACJ,mSAAmS;gBACrS,OAAO,EAAE,EAAE,GAAG,WAAW,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,eAAe,EAAE,gBAAgB,EAAE;aAC/F,CAAC,EACF,gBAAgB,CACjB,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,UAAU,CAAC,IAAI,CAAC,uCAAuC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACnH,CAAC;IACH,CAAC;IAED,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,KAAK,GAAG,SAAS,IAAI,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QACvE,OAAO;YACL,OAAO,EAAE,SAAS;YAClB,MAAM,EAAE,wCAAwC,KAAK,6DAA6D;YAClH,KAAK;YACL,UAAU;YACV,aAAa,EAAE,KAAK;SACrB,CAAC;IACJ,CAAC;IAED,OAAO,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC;AAC3C,CAAC"}
+{"version":3,"file":"ai-runner.js","sourceRoot":"","sources":["../../src/runner/ai-runner.ts"],"names":[],"mappings":"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"}

package/dist/runner/engines/ai-sdk.d.ts

@@ -0,0 +1,58 @@
+import { type FinishReason, type LanguageModel } from "ai";
+import type { AiProvider } from "../../credentials.js";
+import type { AgentEngine, EngineRunSpec, EngineSession, QueryEndInfo } from "./types.js";
+/**
+ * Optional injection seam. Production leaves `model` unset and we resolve the
+ * provider model from the spec's provider + model id; tests pass a
+ * MockLanguageModelV3 so the tool-calling loop runs deterministically with no
+ * network.
+ */
+export interface AiSdkEngineOptions {
+    model?: LanguageModel;
+}
+/**
+ * Maps a provider + model id onto the matching AI SDK `LanguageModel`.
+ *
+ *   anthropic → @ai-sdk/anthropic
+ *   openai    → @ai-sdk/openai
+ *   google    → @ai-sdk/google when a Gemini/Generative-AI API key is present;
+ *               otherwise @ai-sdk/google-vertex (keyless, via Application Default
+ *               Credentials). The split is driven by the same credential ladder
+ *               `detectAiCredentials("google")` reports, so the engine and
+ *               `scout doctor` agree on which sub-provider runs.
+ *
+ * For Vertex we pass `project` from GOOGLE_CLOUD_PROJECT when set (the provider
+ * otherwise reads GOOGLE_VERTEX_PROJECT) and default `location` to
+ * GOOGLE_VERTEX_LOCATION or "us-central1" — the Vertex provider requires a
+ * location eagerly at model construction, so we supply a sensible default to
+ * keep the keyless path zero-config. ADC itself comes from google-auth-library.
+ */
+export declare function resolveModel(provider: AiProvider, modelId: string): LanguageModel;
+/**
+ * Second engine, built on the Vercel AI SDK. It runs the SAME engine-neutral
+ * ScoutTool set through `generateText`'s tool-calling loop, against Anthropic,
+ * Google (Gemini API key or Vertex ADC) or OpenAI — selected per the spec's
+ * provider via {@link resolveModel}. The shared orchestrator owns prompts,
+ * verdict capture and the forced-verdict rescue — this class only drives the SDK
+ * loop and maps the SDK's `finishReason` into the QueryEndInfo vocabulary the
+ * rescue understands.
+ */
+export declare class AiSdkEngine implements AgentEngine {
+    private readonly opts;
+    constructor(opts?: AiSdkEngineOptions);
+    run(spec: EngineRunSpec): Promise<EngineSession>;
+}
+/**
+ * Maps the AI SDK `finishReason` onto the QueryEndInfo.subtype vocabulary that
+ * {@link describeNoVerdict} and the forced-verdict rescue already speak.
+ *
+ *   tool-calls / length  → "error_max_turns"        (hit the step budget mid-flight)
+ *   stop                 → "success"                 (model ended its turn cleanly)
+ *   error / content-filter / other → "error_during_execution"
+ *
+ * Rationale: when the loop stops on `tool-calls` it means `stopWhen` cut it off
+ * with a tool call still pending — i.e. it would have kept going, the budget ran
+ * out (exactly the Agent SDK's `error_max_turns`). `length` is the token-budget
+ * analog. Only a clean `stop` means the model chose to end its turn.
+ */
+export declare function toEndInfo(finishReason: FinishReason, numTurns: number): QueryEndInfo;

package/dist/runner/engines/ai-sdk.js

@@ -0,0 +1,144 @@
+import { anthropic } from "@ai-sdk/anthropic";
+import { createGoogleGenerativeAI } from "@ai-sdk/google";
+import { createVertex } from "@ai-sdk/google-vertex";
+import { openai } from "@ai-sdk/openai";
+import { generateText, stepCountIs, tool, } from "ai";
+import { detectAiCredentials } from "../../credentials.js";
+/**
+ * Maps a provider + model id onto the matching AI SDK `LanguageModel`.
+ *
+ *   anthropic → @ai-sdk/anthropic
+ *   openai    → @ai-sdk/openai
+ *   google    → @ai-sdk/google when a Gemini/Generative-AI API key is present;
+ *               otherwise @ai-sdk/google-vertex (keyless, via Application Default
+ *               Credentials). The split is driven by the same credential ladder
+ *               `detectAiCredentials("google")` reports, so the engine and
+ *               `scout doctor` agree on which sub-provider runs.
+ *
+ * For Vertex we pass `project` from GOOGLE_CLOUD_PROJECT when set (the provider
+ * otherwise reads GOOGLE_VERTEX_PROJECT) and default `location` to
+ * GOOGLE_VERTEX_LOCATION or "us-central1" — the Vertex provider requires a
+ * location eagerly at model construction, so we supply a sensible default to
+ * keep the keyless path zero-config. ADC itself comes from google-auth-library.
+ */
+export function resolveModel(provider, modelId) {
+    switch (provider) {
+        case "anthropic":
+            return anthropic(modelId);
+        case "openai":
+            return openai(modelId);
+        case "google": {
+            const status = detectAiCredentials("google");
+            const usesApiKey = status.ok && status.source !== undefined && /API_KEY$/.test(status.source);
+            if (usesApiKey)
+                return createGoogleGenerativeAI()(modelId);
+            const project = process.env.GOOGLE_CLOUD_PROJECT?.trim();
+            const location = process.env.GOOGLE_VERTEX_LOCATION?.trim() || "us-central1";
+            return createVertex({ location, ...(project ? { project } : {}) })(modelId);
+        }
+    }
+}
+/**
+ * Second engine, built on the Vercel AI SDK. It runs the SAME engine-neutral
+ * ScoutTool set through `generateText`'s tool-calling loop, against Anthropic,
+ * Google (Gemini API key or Vertex ADC) or OpenAI — selected per the spec's
+ * provider via {@link resolveModel}. The shared orchestrator owns prompts,
+ * verdict capture and the forced-verdict rescue — this class only drives the SDK
+ * loop and maps the SDK's `finishReason` into the QueryEndInfo vocabulary the
+ * rescue understands.
+ */
+export class AiSdkEngine {
+    opts;
+    constructor(opts = {}) {
+        this.opts = opts;
+    }
+    async run(spec) {
+        const model = this.opts.model ?? resolveModel(spec.provider, spec.model);
+        const tools = buildAiSdkTools(spec.tools);
+        const transcript = [];
+        // Running conversation so resume() can append the rescue prompt and
+        // continue from where the agent left off.
+        const messages = [{ role: "user", content: spec.userPrompt }];
+        const abortController = new AbortController();
+        const step = async (maxTurns) => {
+            try {
+                const result = await generateText({
+                    model,
+                    system: spec.systemPrompt,
+                    messages,
+                    tools,
+                    stopWhen: stepCountIs(maxTurns),
+                    abortSignal: abortController.signal,
+                });
+                // Collect assistant text across every step in order.
+                for (const s of result.steps) {
+                    if (s.text && s.text.trim())
+                        transcript.push(s.text.trim());
+                }
+                // Persist the full assistant/tool exchange so the next step continues it.
+                messages.push(...result.response.messages);
+                return toEndInfo(result.finishReason, result.steps.length);
+            }
+            catch (error) {
+                return {
+                    subtype: "error_during_execution",
+                    errors: [error instanceof Error ? error.message : String(error)],
+                };
+            }
+        };
+        const end = await step(spec.maxTurns);
+        const resume = async (prompt, maxTurns) => {
+            const before = transcript.length;
+            messages.push({ role: "user", content: prompt });
+            const resumeEnd = await step(maxTurns);
+            return { end: resumeEnd, transcript: transcript.slice(before) };
+        };
+        return { end, transcript, resume };
+    }
+}
+/**
+ * Maps the AI SDK `finishReason` onto the QueryEndInfo.subtype vocabulary that
+ * {@link describeNoVerdict} and the forced-verdict rescue already speak.
+ *
+ *   tool-calls / length  → "error_max_turns"        (hit the step budget mid-flight)
+ *   stop                 → "success"                 (model ended its turn cleanly)
+ *   error / content-filter / other → "error_during_execution"
+ *
+ * Rationale: when the loop stops on `tool-calls` it means `stopWhen` cut it off
+ * with a tool call still pending — i.e. it would have kept going, the budget ran
+ * out (exactly the Agent SDK's `error_max_turns`). `length` is the token-budget
+ * analog. Only a clean `stop` means the model chose to end its turn.
+ */
+export function toEndInfo(finishReason, numTurns) {
+    switch (finishReason) {
+        case "tool-calls":
+        case "length":
+            return { subtype: "error_max_turns", numTurns };
+        case "stop":
+            return { subtype: "success", numTurns };
+        default:
+            return { subtype: "error_during_execution", numTurns, errors: [`finishReason=${finishReason}`] };
+    }
+}
+/**
+ * Adapts the engine-neutral ScoutTool set into AI SDK tools. `execute` returns
+ * the tool text; on a tool error we return the error string (prefixed "ERRO:",
+ * same as the handler produces) rather than throwing. Returning a string keeps
+ * the model in the loop with the failure visible — the same recovery affordance
+ * the Agent SDK gives via an isError tool result — instead of aborting the run.
+ */
+function buildAiSdkTools(scoutTools) {
+    const entries = scoutTools.map((scoutTool) => [
+        scoutTool.name,
+        tool({
+            description: scoutTool.description,
+            inputSchema: scoutTool.schema,
+            execute: async (args) => {
+                const result = await scoutTool.handler(args);
+                return result.text;
+            },
+        }),
+    ]);
+    return Object.fromEntries(entries);
+}
+//# sourceMappingURL=ai-sdk.js.map

package/dist/runner/engines/ai-sdk.js.map

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

package/dist/runner/engines/claude-agent-sdk.d.ts

@@ -0,0 +1,11 @@
+import type { AgentEngine, EngineRunSpec, EngineSession } from "./types.js";
+/**
+ * The original, trusted engine: runs the verification through the
+ * `@anthropic-ai/claude-agent-sdk` subprocess. Behavior here is intentionally
+ * IDENTICAL to the pre-refactor ai-runner: bypassPermissions, empty
+ * settingSources, allowedTools scoped to the in-process MCP browser server, the
+ * query()+drain() loop, and an abort-in-finally so no subprocess outlives a run.
+ */
+export declare class ClaudeAgentSdkEngine implements AgentEngine {
+    run(spec: EngineRunSpec): Promise<EngineSession>;
+}