web-task-api 0.2.1

package/dist/src/agents/mock-agent.d.ts

@@ -0,0 +1,15 @@
+import type { AgentAdapter, AgentTurnInput, PlannedAction, TaskRequest } from "../tasks/schemas.js";
+export declare class MockAgent implements AgentAdapter {
+    private readonly request;
+    constructor(request: TaskRequest);
+    init(): Promise<void>;
+    nextAction(input: AgentTurnInput): Promise<PlannedAction>;
+    close(): Promise<void>;
+    debugInfo(): {
+        planner: string;
+        reason: string;
+    };
+    private lookupInput;
+    private findField;
+    private findButton;
+}

package/dist/src/agents/mock-agent.js

@@ -0,0 +1,132 @@
+export class MockAgent {
+    request;
+    constructor(request) {
+        this.request = request;
+    }
+    async init() { }
+    async nextAction(input) {
+        const queryValue = this.lookupInput(input, "query");
+        const text = input.snapshot.textPreview.toLowerCase();
+        const lastStep = input.history.at(-1);
+        const lastReadText = typeof input.lastToolResult?.text === "string" ? input.lastToolResult.text : undefined;
+        if (lastReadText) {
+            return {
+                type: "finish",
+                reason: "Structured fields were extracted from the visible result page.",
+                result: extractResult(lastReadText, input.outputSchema, input.request.input),
+            };
+        }
+        const queryField = this.findField(input, ["query", "search", "term", "keyword", "q"]);
+        const alreadyFilled = lastStep?.action.type === "fill";
+        if (queryValue && queryField && !alreadyFilled && !text.includes("product:")) {
+            return {
+                type: "fill",
+                elementId: queryField.id,
+                text: String(queryValue),
+                reason: "Fill the main query field from task input.",
+            };
+        }
+        const submit = this.findButton(input, ["search", "submit", "go", "find"]);
+        const alreadySubmitted = input.history.some((step) => step.action.type === "click" || step.action.type === "press");
+        if (submit && !alreadySubmitted && !text.includes("product:")) {
+            return {
+                type: "click",
+                elementId: submit.id,
+                reason: "Submit the obvious search action.",
+            };
+        }
+        if (text.includes("product:") || text.includes("price:") || text.includes("stock:")) {
+            return {
+                type: "read_page",
+                reason: "Result details are visible, so read the page for extraction.",
+                maxChars: 4_000,
+            };
+        }
+        if (input.request.startUrl && input.step === 1 && input.snapshot.url !== input.request.startUrl) {
+            return {
+                type: "navigate",
+                url: input.request.startUrl,
+                reason: "Navigate to the provided start URL first.",
+            };
+        }
+        return {
+            type: "fail",
+            reason: "The mock agent could not find a safe next step.",
+            error: "mock_agent_stuck",
+        };
+    }
+    async close() { }
+    debugInfo() {
+        return { planner: "mock", reason: "deterministic local test agent" };
+    }
+    lookupInput(input, key) {
+        const direct = input.request.input[key];
+        if (direct !== undefined) {
+            return direct;
+        }
+        const aliases = input.recipe?.inputAliases?.[key] ?? [];
+        for (const alias of aliases) {
+            if (input.request.input[alias] !== undefined) {
+                return input.request.input[alias];
+            }
+        }
+        return undefined;
+    }
+    findField(input, tokens) {
+        return input.snapshot.interactive.find((element) => {
+            if (!["input", "textarea"].includes(element.tag)) {
+                return false;
+            }
+            const haystack = [element.label, element.placeholder, element.name, element.text]
+                .filter(Boolean)
+                .join(" ")
+                .toLowerCase();
+            return tokens.some((token) => haystack.includes(token));
+        });
+    }
+    findButton(input, tokens) {
+        return input.snapshot.interactive.find((element) => {
+            const inputButton = element.tag === "input" && ["submit", "button"].includes(element.type ?? "");
+            if (!(element.tag === "button" || element.tag === "a" || inputButton)) {
+                return false;
+            }
+            const haystack = [element.text, element.label, element.name, element.placeholder]
+                .filter(Boolean)
+                .join(" ")
+                .toLowerCase();
+            return tokens.some((token) => haystack.includes(token));
+        });
+    }
+}
+function extractResult(text, schema, input) {
+    const result = {};
+    const schemaProperties = typeof schema?.properties === "object" && schema.properties !== null
+        ? schema.properties
+        : {};
+    for (const key of Object.keys(schemaProperties)) {
+        const label = key.replace(/_/g, " ");
+        const variants = [label, toTitleCase(label)];
+        for (const variant of variants) {
+            const regex = new RegExp(`${escapeRegex(variant)}\\s*:\\s*([^\\n]+)`, "i");
+            const match = text.match(regex);
+            if (match?.[1]) {
+                result[key] = match[1].trim();
+                break;
+            }
+        }
+    }
+    if (result.product === undefined && input.query !== undefined) {
+        result.product = input.query;
+    }
+    return result;
+}
+function toTitleCase(value) {
+    return value
+        .split(" ")
+        .map((part) => part.slice(0, 1).toUpperCase() + part.slice(1))
+        .join(" ");
+}
+function escapeRegex(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=mock-agent.js.map

package/dist/src/agents/mock-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock-agent.js","sourceRoot":"","sources":["../../../src/agents/mock-agent.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,SAAS;IACS;IAA7B,YAA6B,OAAoB;QAApB,YAAO,GAAP,OAAO,CAAa;IAAG,CAAC;IAErD,KAAK,CAAC,IAAI,KAAmB,CAAC;IAE9B,KAAK,CAAC,UAAU,CAAC,KAAqB;QACpC,MAAM,UAAU,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACpD,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC;QAEtD,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;QACtC,MAAM,YAAY,GAAG,OAAO,KAAK,CAAC,cAAc,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QAE5G,IAAI,YAAY,EAAE,CAAC;YACjB,OAAO;gBACL,IAAI,EAAE,QAAQ;gBACd,MAAM,EAAE,gEAAgE;gBACxE,MAAM,EAAE,aAAa,CAAC,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;aAC7E,CAAC;QACJ,CAAC;QAED,MAAM,UAAU,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC;QACtF,MAAM,aAAa,GAAG,QAAQ,EAAE,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC;QACvD,IAAI,UAAU,IAAI,UAAU,IAAI,CAAC,aAAa,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7E,OAAO;gBACL,IAAI,EAAE,MAAM;gBACZ,SAAS,EAAE,UAAU,CAAC,EAAE;gBACxB,IAAI,EAAE,MAAM,CAAC,UAAU,CAAC;gBACxB,MAAM,EAAE,4CAA4C;aACrD,CAAC;QACJ,CAAC;QAED,MAAM,MAAM,GAAG,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;QAC1E,MAAM,gBAAgB,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CACzC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,CACvE,CAAC;QACF,IAAI,MAAM,IAAI,CAAC,gBAAgB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9D,OAAO;gBACL,IAAI,EAAE,OAAO;gBACb,SAAS,EAAE,MAAM,CAAC,EAAE;gBACpB,MAAM,EAAE,mCAAmC;aAC5C,CAAC;QACJ,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;YACpF,OAAO;gBACL,IAAI,EAAE,WAAW;gBACjB,MAAM,EAAE,8DAA8D;gBACtE,QAAQ,EAAE,KAAK;aAChB,CAAC;QACJ,CAAC;QAED,IAAI,KAAK,CAAC,OAAO,CAAC,QAAQ,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,KAAK,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;YAChG,OAAO;gBACL,IAAI,EAAE,UAAU;gBAChB,GAAG,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ;gBAC3B,MAAM,EAAE,2CAA2C;aACpD,CAAC;QACJ,CAAC;QAED,OAAO;YACL,IAAI,EAAE,MAAM;YACZ,MAAM,EAAE,iDAAiD;YACzD,KAAK,EAAE,kBAAkB;SAC1B,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAK,KAAmB,CAAC;IAE/B,SAAS;QACP,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,gCAAgC,EAAE,CAAC;IACvE,CAAC;IAEO,WAAW,CAAC,KAAqB,EAAE,GAAW;QACpD,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QACxC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,MAAM,CAAC;QAChB,CAAC;QAED,MAAM,OAAO,GAAG,KAAK,CAAC,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;QACxD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,SAAS,EAAE,CAAC;gBAC7C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACpC,CAAC;QACH,CAAC;QACD,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,SAAS,CAAC,KAAqB,EAAE,MAAgB;QACvD,OAAO,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;YACjD,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;gBACjD,OAAO,KAAK,CAAC;YACf,CAAC;YACD,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC;iBAC9E,MAAM,CAAC,OAAO,CAAC;iBACf,IAAI,CAAC,GAAG,CAAC;iBACT,WAAW,EAAE,CAAC;YACjB,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;IACL,CAAC;IAEO,UAAU,CAAC,KAAqB,EAAE,MAAgB;QACxD,OAAO,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE;YACjD,MAAM,WAAW,GACf,OAAO,CAAC,GAAG,KAAK,OAAO,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YAC/E,IAAI,CAAC,CAAC,OAAO,CAAC,GAAG,KAAK,QAAQ,IAAI,OAAO,CAAC,GAAG,KAAK,GAAG,IAAI,WAAW,CAAC,EAAE,CAAC;gBACtE,OAAO,KAAK,CAAC;YACf,CAAC;YACD,MAAM,QAAQ,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC;iBAC9E,MAAM,CAAC,OAAO,CAAC;iBACf,IAAI,CAAC,GAAG,CAAC;iBACT,WAAW,EAAE,CAAC;YACjB,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;QAC1D,CAAC,CAAC,CAAC;IACL,CAAC;CACF;AAED,SAAS,aAAa,CACpB,IAAY,EACZ,MAA2C,EAC3C,KAA8B;IAE9B,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,MAAM,gBAAgB,GACpB,OAAO,MAAM,EAAE,UAAU,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU,KAAK,IAAI;QAClE,CAAC,CAAE,MAAM,CAAC,UAAsC;QAChD,CAAC,CAAC,EAAE,CAAC;IAET,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAChD,MAAM,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QACrC,MAAM,QAAQ,GAAG,CAAC,KAAK,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7C,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;YAC/B,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,OAAO,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAC;YAC3E,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAChC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACf,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;gBAC9B,MAAM;YACR,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,CAAC,KAAK,KAAK,SAAS,EAAE,CAAC;QAC9D,MAAM,CAAC,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC;IAC/B,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,KAAK;SACT,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SAC7D,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED,SAAS,WAAW,CAAC,KAAa;IAChC,OAAO,KAAK,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACtD,CAAC"}

package/dist/src/agents/opencode-agent.d.ts

@@ -0,0 +1,20 @@
+import type { AgentAdapter, AgentTurnInput, PlannedAction, TaskRequest } from "../tasks/schemas.js";
+export declare class OpencodeAgent implements AgentAdapter {
+    private readonly request;
+    private client;
+    private sessionId;
+    private server?;
+    constructor(request: TaskRequest);
+    init(): Promise<void>;
+    nextAction(input: AgentTurnInput): Promise<PlannedAction>;
+    close(): Promise<void>;
+    debugInfo(): {
+        planner: string;
+        reason: string;
+    };
+}
+export declare function extractOpencodeStructuredOutput(response: any): unknown;
+export declare function parseModel(model?: string): {
+    providerID: string;
+    modelID: string;
+} | undefined;

package/dist/src/agents/opencode-agent.js

@@ -0,0 +1,122 @@
+import { createOpencode, createOpencodeClient, } from "@opencode-ai/sdk";
+import { DEFAULT_OPENCODE_BASE_URL, DEFAULT_OPENCODE_MODEL, } from "../config.js";
+import { OPENCODE_ACTION_SCHEMA, buildPlannerPrompt, systemInstructions, validatePlannedAction, } from "./planner-prompt.js";
+export class OpencodeAgent {
+    request;
+    client;
+    sessionId;
+    server;
+    constructor(request) {
+        this.request = request;
+    }
+    async init() {
+        const baseUrl = DEFAULT_OPENCODE_BASE_URL ?? (await detectRunningOpencodeUrl());
+        if (baseUrl) {
+            this.client = createOpencodeClient({ baseUrl });
+        }
+        else {
+            const model = this.request.agent.model ?? DEFAULT_OPENCODE_MODEL;
+            const opencode = await createOpencode({
+                ...(model ? { config: { model } } : {}),
+            });
+            this.client = opencode.client;
+            this.server = opencode.server;
+        }
+        const session = await this.client.session.create({
+            body: { title: `web-task: ${this.request.goal.slice(0, 80)}` },
+        });
+        this.sessionId = session.data.id;
+        await this.client.session.prompt({
+            path: { id: this.sessionId },
+            body: {
+                noReply: true,
+                parts: [{ type: "text", text: systemInstructions() }],
+            },
+        });
+    }
+    async nextAction(input) {
+        const model = parseModel(this.request.agent.model ?? DEFAULT_OPENCODE_MODEL);
+        const response = await this.client.session.prompt({
+            path: { id: this.sessionId },
+            body: {
+                ...(model ? { model } : {}),
+                parts: [{ type: "text", text: buildPlannerPrompt(input) }],
+                format: {
+                    type: "json_schema",
+                    retryCount: 2,
+                    schema: OPENCODE_ACTION_SCHEMA,
+                },
+            },
+        });
+        const structured = normalizeOpencodeAction(extractOpencodeStructuredOutput(response));
+        if (!structured || typeof structured !== "object") {
+            throw new Error("OpenCode did not return structured_output for planner step.");
+        }
+        validatePlannedAction(structured);
+        return structured;
+    }
+    async close() {
+        if (this.server?.close) {
+            await this.server.close();
+        }
+    }
+    debugInfo() {
+        return {
+            planner: "opencode",
+            reason: "OpenCode local runtime or attached server selected",
+        };
+    }
+}
+export function extractOpencodeStructuredOutput(response) {
+    const info = response?.data?.info;
+    return info?.structured ?? info?.structured_output;
+}
+export function parseModel(model) {
+    if (!model) {
+        return undefined;
+    }
+    const [providerID, ...rest] = model.split("/");
+    const modelID = rest.join("/");
+    if (!providerID || !modelID) {
+        return undefined;
+    }
+    return { providerID, modelID };
+}
+async function detectRunningOpencodeUrl() {
+    const candidate = "http://127.0.0.1:4096";
+    try {
+        const response = await fetch(`${candidate}/global/health`);
+        if (response.ok) {
+            return candidate;
+        }
+    }
+    catch {
+        return undefined;
+    }
+    return undefined;
+}
+function normalizeOpencodeAction(action) {
+    if (!action || typeof action !== "object") {
+        return action;
+    }
+    const value = { ...action };
+    if (value.type === "fill" && typeof value.text !== "string" && typeof value.value === "string") {
+        value.text = value.value;
+    }
+    if (value.type === "select" && typeof value.value !== "string" && typeof value.text === "string") {
+        value.value = value.text;
+    }
+    if (value.type === "finish" && !value.result && typeof value.text === "string") {
+        try {
+            value.result = JSON.parse(value.text);
+        }
+        catch {
+            // ignore parse failure and let validator surface it
+        }
+    }
+    if (value.type === "fail" && typeof value.error !== "string" && typeof value.text === "string") {
+        value.error = value.text;
+    }
+    return value;
+}
+//# sourceMappingURL=opencode-agent.js.map

package/dist/src/agents/opencode-agent.js.map

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

package/dist/src/agents/planner-prompt.d.ts

@@ -0,0 +1,6 @@
+import type { AgentTurnInput } from "../tasks/schemas.js";
+export declare const ACTION_SCHEMA: Record<string, unknown>;
+export declare const OPENCODE_ACTION_SCHEMA: Record<string, unknown>;
+export declare function systemInstructions(): string;
+export declare function buildPlannerPrompt(input: AgentTurnInput): string;
+export declare function validatePlannedAction(action: unknown): void;

package/dist/src/agents/planner-prompt.js

@@ -0,0 +1,116 @@
+import AjvModule from "ajv";
+const AjvCtor = AjvModule;
+const ajv = new AjvCtor({ allErrors: true, strict: false });
+export const ACTION_SCHEMA = {
+    oneOf: [
+        actionVariant("navigate", ["url"]),
+        actionVariant("click", ["elementId"]),
+        actionVariant("fill", ["elementId", "text"]),
+        actionVariant("press", ["elementId", "key"]),
+        actionVariant("select", ["elementId", "value"]),
+        actionVariant("wait_for_text", ["text"]),
+        actionVariant("read_page", []),
+        actionVariant("finish", ["result"]),
+        actionVariant("fail", ["error"]),
+    ],
+};
+export const OPENCODE_ACTION_SCHEMA = {
+    type: "object",
+    additionalProperties: false,
+    required: ["type", "reason"],
+    properties: {
+        type: {
+            type: "string",
+            enum: [
+                "navigate",
+                "click",
+                "fill",
+                "press",
+                "select",
+                "wait_for_text",
+                "read_page",
+                "finish",
+                "fail",
+            ],
+        },
+        reason: { type: "string" },
+        url: { type: "string" },
+        elementId: { type: "string" },
+        text: { type: "string" },
+        key: { type: "string" },
+        value: { type: "string" },
+        timeoutMs: { type: "number" },
+        maxChars: { type: "number" },
+        error: { type: "string" },
+        result: { type: "object", additionalProperties: true },
+    },
+};
+export function systemInstructions() {
+    return [
+        "You are the planning agent for a browser-task API.",
+        "You do not click raw selectors. You only act through the current snapshot and element IDs.",
+        "Choose the next single best action. Do not emit multiple actions.",
+        "Prefer outcome-oriented progress: fill obvious fields, submit obvious forms, read the page, then finish.",
+        "When the task goal is satisfied, return type=finish with a result object that fits the output schema.",
+        "If the run is blocked or impossible, return type=fail with a short machine-readable error.",
+        "Do not invent fields that are not grounded in the page or task input.",
+    ].join(" ");
+}
+function actionVariant(type, extraRequired) {
+    return {
+        type: "object",
+        additionalProperties: false,
+        required: ["type", "reason", ...extraRequired],
+        properties: {
+            type: { type: "string", const: type },
+            reason: { type: "string" },
+            url: { type: "string" },
+            elementId: { type: "string" },
+            text: { type: "string" },
+            key: { type: "string" },
+            value: { type: "string" },
+            timeoutMs: { type: "number" },
+            maxChars: { type: "number" },
+            error: { type: "string" },
+            result: { type: "object", additionalProperties: true },
+        },
+    };
+}
+export function buildPlannerPrompt(input) {
+    const history = input.history.slice(-6).map((step) => ({
+        step: step.index,
+        action: step.action,
+        result: step.result,
+    }));
+    return JSON.stringify({
+        role: "browser-task-planner",
+        step: input.step,
+        maxSteps: input.maxSteps,
+        goal: input.request.goal,
+        mode: input.request.mode,
+        startUrl: input.request.startUrl,
+        taskInput: input.request.input,
+        outputSchema: input.outputSchema,
+        recipe: input.recipe,
+        sessionContext: input.sessionContext,
+        lastToolResult: input.lastToolResult,
+        snapshot: input.snapshot,
+        recentHistory: history,
+        instructions: [
+            "Return the next best action as JSON matching the provided schema.",
+            "Use current element IDs only.",
+            "If result information is visible but not fully parsed, use read_page next.",
+        ],
+    }, null, 2);
+}
+export function validatePlannedAction(action) {
+    const validate = ajv.compile(ACTION_SCHEMA);
+    if (validate(action)) {
+        return;
+    }
+    const message = validate.errors
+        ?.map((error) => `${error.instancePath || "$"} ${error.message ?? "is invalid"}`.trim())
+        .join("; ") ?? "invalid action";
+    throw new Error(`Planner returned invalid action: ${message}; action=${JSON.stringify(action)}`);
+}
+//# sourceMappingURL=planner-prompt.js.map

package/dist/src/agents/planner-prompt.js.map

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

package/dist/src/browser/session.d.ts

@@ -0,0 +1,41 @@
+import type { PageSnapshot, PlannedAction } from "../tasks/schemas.js";
+export type LaunchOptions = {
+    headless: boolean;
+    profile?: string | undefined;
+    userDataDir?: string | undefined;
+    storageStatePath?: string | undefined;
+    screenshotsDir: string;
+    preferChrome?: boolean | undefined;
+    protectedSiteMode?: boolean | undefined;
+};
+export declare class BrowserSession {
+    private readonly browser;
+    private readonly context;
+    private readonly page;
+    private readonly screenshotsDir;
+    private readonly profile?;
+    private readonly tempUserDataDir?;
+    private readonly storageStatePath?;
+    private constructor();
+    private currentElements;
+    static launch(options: LaunchOptions): Promise<BrowserSession>;
+    getProfile(): string | undefined;
+    getUserDataDirDebug(): string | undefined;
+    navigate(url: string): Promise<Record<string, unknown>>;
+    snapshot(): Promise<PageSnapshot>;
+    execute(action: Exclude<PlannedAction, {
+        type: "finish" | "fail";
+    }>): Promise<Record<string, unknown>>;
+    captureScreenshot(name: string): Promise<string>;
+    close(): Promise<void>;
+    private resolve;
+    private waitForSettled;
+    private isAntiBotPage;
+}
+export declare function resolveUserDataDir(profile?: string, sharedUserDataDir?: string | undefined, explicitUserDataDir?: string | undefined): Promise<{
+    userDataDir: string;
+    tempUserDataDir: undefined;
+} | {
+    userDataDir: undefined;
+    tempUserDataDir: undefined;
+}>;