@mlola/browser-runtime 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MLola
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,33 @@
+# @mlola/browser-runtime
+
+Reliable browser use with a fast path: a local-first browser runtime where
+browser mechanics, safety, verification and recovery are deterministic, the
+fast decision path (TypeSafe Jev) handles routine steps, stronger models handle
+planning and recovery, and a person can take over whenever needed.
+
+```bash
+npm install @mlola/browser-runtime
+```
+
+```ts
+import { BrowserAgent } from "@mlola/browser-runtime";
+
+const agent = new BrowserAgent({ decision: { provider: "typesafe" } });
+
+const run = await agent.run({
+  goal: "Download my latest invoice, attach it to a new claim, then stop before submitting",
+  startUrl: "https://billing.example.com/invoices",
+  stopBefore: ["submit claim"],
+});
+
+console.log(run.status, run.verification?.status, run.artifacts);
+```
+
+- Models never produce selectors, coordinates or code — only choices from the
+  runtime's own action space.
+- `DONE` is a claim; completion is verified by independent evidence (artifacts,
+  URL/state, DOM, runtime events) or a person.
+- Secrets (passwords, OTP, cards) are a takeover floor and never enter model
+  state or traces.
+
+Full documentation: <https://mlola.com/browser-runtime>

package/dist/agent.d.ts

@@ -0,0 +1,25 @@
+/**
+ * BrowserAgent — the public SDK surface (PRD §58).
+ *
+ *   const agent = new BrowserAgent(config);
+ *   const run = await agent.run({ goal: "Download the latest invoice" });
+ *   agent.pause(); agent.resume(); agent.stop();
+ *   agent.on("step", handler);
+ */
+import type { RunEvent, RunResult, TaskSpec } from "@mlola/browser-protocol";
+import { type BrowserAgentConfig } from "./config.ts";
+export type AgentEventName = "step" | "takeover-required" | "approval-required" | "artifact-created" | "fallback" | "completed" | "failed" | "event";
+export type AgentEventHandler = (event: RunEvent) => void;
+export declare class BrowserAgent {
+    #private;
+    constructor(config?: BrowserAgentConfig);
+    get status(): string;
+    /** Raw event log for the run in progress (or the last run). */
+    get events(): readonly RunEvent[];
+    on(event: AgentEventName, handler: AgentEventHandler): () => void;
+    run(task: TaskSpec | string): Promise<RunResult>;
+    pause(reason?: string): void;
+    resume(reason?: string): void;
+    stop(reason?: string): void;
+}
+//# sourceMappingURL=agent.d.ts.map

package/dist/agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAE7E,OAAO,EAAsB,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAE1E,MAAM,MAAM,cAAc,GACtB,MAAM,GACN,mBAAmB,GACnB,mBAAmB,GACnB,kBAAkB,GAClB,UAAU,GACV,WAAW,GACX,QAAQ,GACR,OAAO,CAAC;AAEZ,MAAM,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,QAAQ,KAAK,IAAI,CAAC;AAE1D,qBAAa,YAAY;;gBAMX,MAAM,GAAE,kBAAuB;IAI3C,IAAI,MAAM,IAAI,MAAM,CAEnB;IAED,+DAA+D;IAC/D,IAAI,MAAM,IAAI,SAAS,QAAQ,EAAE,CAEhC;IAED,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,iBAAiB,GAAG,MAAM,IAAI;IAc3D,GAAG,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IA4DtD,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAI5B,MAAM,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAI7B,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;CAG5B"}

package/dist/agent.js

@@ -0,0 +1,106 @@
+/**
+ * BrowserAgent — the public SDK surface (PRD §58).
+ *
+ *   const agent = new BrowserAgent(config);
+ *   const run = await agent.run({ goal: "Download the latest invoice" });
+ *   agent.pause(); agent.resume(); agent.stop();
+ *   agent.on("step", handler);
+ */
+import { TaskOrchestrator } from "@mlola/browser-core";
+import { resolveAgentConfig } from "./config.js";
+export class BrowserAgent {
+    #config;
+    #orchestrator;
+    #handlers = new Map();
+    #events = [];
+    constructor(config = {}) {
+        this.#config = config;
+    }
+    get status() {
+        return this.#orchestrator?.status ?? "created";
+    }
+    /** Raw event log for the run in progress (or the last run). */
+    get events() {
+        return this.#events;
+    }
+    on(event, handler) {
+        const set = this.#handlers.get(event) ?? new Set();
+        set.add(handler);
+        this.#handlers.set(event, set);
+        return () => {
+            set.delete(handler);
+        };
+    }
+    #emit(event, payload) {
+        for (const handler of this.#handlers.get("event") ?? [])
+            handler(payload);
+        for (const handler of this.#handlers.get(event) ?? [])
+            handler(payload);
+    }
+    async run(task) {
+        const spec = typeof task === "string" ? { goal: task } : task;
+        const resolved = resolveAgentConfig({
+            ...this.#config,
+            ...(spec.browser ? { browser: { ...this.#config.browser, ...spec.browser } } : {}),
+            ...(spec.policy ? { policy: { ...this.#config.policy, ...spec.policy } } : {}),
+            ...(spec.screenshot ? { screenshot: spec.screenshot } : {}),
+        });
+        this.#events = [];
+        this.#orchestrator = new TaskOrchestrator({
+            backend: resolved.backend,
+            providers: resolved.providers,
+            approvals: resolved.approvals,
+            policy: resolved.policy,
+            screenshot: resolved.screenshot,
+            ...(resolved.humanHelp ? { humanHelp: resolved.humanHelp } : {}),
+            ...(resolved.home ? { home: resolved.home } : {}),
+            onEvent: (event) => {
+                this.#events.push(event);
+                resolved.onEvent?.(event);
+                switch (event.type) {
+                    case "STEP_COMPLETED":
+                        this.#emit("step", event);
+                        break;
+                    case "HUMAN_HELP_REQUESTED":
+                        this.#emit("takeover-required", event);
+                        break;
+                    case "APPROVAL_REQUESTED":
+                        this.#emit("approval-required", event);
+                        break;
+                    case "ARTIFACT_CREATED":
+                        this.#emit("artifact-created", event);
+                        break;
+                    case "FALLBACK_STARTED":
+                        this.#emit("fallback", event);
+                        break;
+                    case "RUN_COMPLETED":
+                        this.#emit("completed", event);
+                        break;
+                    case "RUN_FAILED":
+                        this.#emit("failed", event);
+                        break;
+                    default:
+                        break;
+                }
+            },
+        });
+        // Establish the fast-path connection while the browser is starting; the
+        // first decision of a session otherwise pays the TLS handshake premium.
+        const decision = resolved.providers.decision;
+        void decision.warmup?.().catch(() => undefined);
+        return this.#orchestrator.run({
+            ...spec,
+            budgets: { ...(this.#config.budgets ?? {}), ...(spec.budgets ?? {}) },
+        });
+    }
+    pause(reason) {
+        this.#orchestrator?.pause(reason);
+    }
+    resume(reason) {
+        this.#orchestrator?.resume(reason);
+    }
+    stop(reason) {
+        this.#orchestrator?.cancel(reason);
+    }
+}
+//# sourceMappingURL=agent.js.map

package/dist/agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent.js","sourceRoot":"","sources":["../src/agent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAA2B,MAAM,aAAa,CAAC;AAc1E,MAAM,OAAO,YAAY;IACvB,OAAO,CAAqB;IAC5B,aAAa,CAA+B;IAC5C,SAAS,GAAG,IAAI,GAAG,EAA0C,CAAC;IAC9D,OAAO,GAAe,EAAE,CAAC;IAEzB,YAAY,SAA6B,EAAE;QACzC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;IACxB,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,aAAa,EAAE,MAAM,IAAI,SAAS,CAAC;IACjD,CAAC;IAED,+DAA+D;IAC/D,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,EAAE,CAAC,KAAqB,EAAE,OAA0B;QAClD,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,IAAI,GAAG,EAAqB,CAAC;QACtE,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACjB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC/B,OAAO,GAAG,EAAE;YACV,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACtB,CAAC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,KAAqB,EAAE,OAAiB;QAC5C,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE;YAAE,OAAO,CAAC,OAAO,CAAC,CAAC;QAC1E,KAAK,MAAM,OAAO,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE;YAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1E,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAuB;QAC/B,MAAM,IAAI,GAAa,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QACxE,MAAM,QAAQ,GAAG,kBAAkB,CAAC;YAClC,GAAG,IAAI,CAAC,OAAO;YACf,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAClF,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9E,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC5D,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,aAAa,GAAG,IAAI,gBAAgB,CAAC;YACxC,OAAO,EAAE,QAAQ,CAAC,OAAO;YACzB,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,MAAM,EAAE,QAAQ,CAAC,MAAM;YACvB,UAAU,EAAE,QAAQ,CAAC,UAAU;YAC/B,GAAG,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAChE,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACjD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBACjB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACzB,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,CAAC,CAAC;gBAC1B,QAAQ,KAAK,CAAC,IAAI,EAAE,CAAC;oBACnB,KAAK,gBAAgB;wBACnB,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;wBAC1B,MAAM;oBACR,KAAK,sBAAsB;wBACzB,IAAI,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;wBACvC,MAAM;oBACR,KAAK,oBAAoB;wBACvB,IAAI,CAAC,KAAK,CAAC,mBAAmB,EAAE,KAAK,CAAC,CAAC;wBACvC,MAAM;oBACR,KAAK,kBAAkB;wBACrB,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAAE,KAAK,CAAC,CAAC;wBACtC,MAAM;oBACR,KAAK,kBAAkB;wBACrB,IAAI,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC;wBAC9B,MAAM;oBACR,KAAK,eAAe;wBAClB,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC;wBAC/B,MAAM;oBACR,KAAK,YAAY;wBACf,IAAI,CAAC,KAAK,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC;wBAC5B,MAAM;oBACR;wBACE,MAAM;gBACV,CAAC;YACH,CAAC;SACF,CAAC,CAAC;QAEH,wEAAwE;QACxE,wEAAwE;QACxE,MAAM,QAAQ,GAAG,QAAQ,CAAC,SAAS,CAAC,QAA4C,CAAC;QACjF,KAAK,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAEhD,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC;YAC5B,GAAG,IAAI;YACP,OAAO,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC,EAAE;SACtE,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAe;QACnB,IAAI,CAAC,aAAa,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,MAAe;QACpB,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;IAED,IAAI,CAAC,MAAe;QAClB,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC;IACrC,CAAC;CACF"}

package/dist/config.d.ts

@@ -0,0 +1,55 @@
+/**
+ * Agent configuration resolution (PRD §58).
+ *
+ * Turns a declarative config into concrete providers and a backend. Every
+ * provider is optional except the decision provider; when a provider is absent
+ * the runtime escalates to the person instead of guessing.
+ */
+import { DEFAULT_POLICY, type ActionRisk, type Budgets, type BrowserConfig, type DecisionProvider, type PlannerProvider, type PolicyConfig, type TextProvider, type VisionProvider } from "@mlola/browser-protocol";
+import { ApprovalBroker, type ApprovalBrokerOptions } from "@mlola/browser-policy";
+import { type OrchestratorProviders } from "@mlola/browser-core";
+import type { BrowserBackend } from "@mlola/browser-backend";
+import type { HumanHelpHost } from "@mlola/browser-takeover";
+export type DecisionProviderChoice = "typesafe" | "keyword" | DecisionProvider;
+export type OptionalProviderChoice<T> = "auto" | "none" | T;
+export interface BrowserAgentConfig {
+    browser?: Partial<BrowserConfig>;
+    /** Fast-path decision provider. Default: TypeSafe Jev. */
+    decision?: DecisionProviderChoice | {
+        provider: DecisionProviderChoice;
+        model?: string;
+        apiKey?: string;
+        baseUrl?: string;
+    };
+    /** Text helper for generated field values. */
+    text?: OptionalProviderChoice<TextProvider>;
+    /** Planner / strong-model fallback. */
+    planner?: OptionalProviderChoice<PlannerProvider>;
+    vision?: VisionProvider;
+    policy?: Partial<PolicyConfig>;
+    budgets?: Partial<Budgets>;
+    humanHelp?: HumanHelpHost;
+    /** Approval behaviour for `ask` policy modes. A broker instance is used as-is. */
+    approvals?: ApprovalBroker | (ApprovalBrokerOptions & {
+        autoApprove?: ActionRisk[];
+    });
+    /** Screenshot policy; default off in normal runs. */
+    screenshot?: "off" | "on-failure" | "always";
+    home?: string;
+    onEvent?: (event: import("@mlola/browser-protocol").RunEvent) => void;
+}
+export interface ResolvedAgentConfig {
+    backend: BrowserBackend;
+    providers: OrchestratorProviders;
+    policy: Partial<PolicyConfig>;
+    budgets?: Partial<Budgets>;
+    approvals: ApprovalBroker;
+    humanHelp?: HumanHelpHost;
+    home?: string;
+    screenshot: "off" | "on-failure" | "always";
+    onEvent?: (event: import("@mlola/browser-protocol").RunEvent) => void;
+}
+export declare const resolveAgentConfig: (config?: BrowserAgentConfig) => ResolvedAgentConfig;
+export { DEFAULT_POLICY };
+export type { ApprovalBrokerOptions };
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EACL,cAAc,EAEd,KAAK,UAAU,EACf,KAAK,OAAO,EACZ,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnF,OAAO,EAAkC,KAAK,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAGjG,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAE7D,MAAM,MAAM,sBAAsB,GAAG,UAAU,GAAG,SAAS,GAAG,gBAAgB,CAAC;AAC/E,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI,MAAM,GAAG,MAAM,GAAG,CAAC,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IACjC,OAAO,CAAC,EAAE,OAAO,CAAC,aAAa,CAAC,CAAC;IACjC,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,sBAAsB,GAAG;QAAE,QAAQ,EAAE,sBAAsB,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC5H,8CAA8C;IAC9C,IAAI,CAAC,EAAE,sBAAsB,CAAC,YAAY,CAAC,CAAC;IAC5C,uCAAuC;IACvC,OAAO,CAAC,EAAE,sBAAsB,CAAC,eAAe,CAAC,CAAC;IAClD,MAAM,CAAC,EAAE,cAAc,CAAC;IACxB,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,kFAAkF;IAClF,SAAS,CAAC,EAAE,cAAc,GAAG,CAAC,qBAAqB,GAAG;QAAE,WAAW,CAAC,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC,CAAC;IACtF,qDAAqD;IACrD,UAAU,CAAC,EAAE,KAAK,GAAG,YAAY,GAAG,QAAQ,CAAC;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,yBAAyB,EAAE,QAAQ,KAAK,IAAI,CAAC;CACvE;AAED,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,cAAc,CAAC;IACxB,SAAS,EAAE,qBAAqB,CAAC;IACjC,MAAM,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IAC9B,OAAO,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,SAAS,EAAE,cAAc,CAAC;IAC1B,SAAS,CAAC,EAAE,aAAa,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,KAAK,GAAG,YAAY,GAAG,QAAQ,CAAC;IAC5C,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,yBAAyB,EAAE,QAAQ,KAAK,IAAI,CAAC;CACvE;AA4DD,eAAO,MAAM,kBAAkB,GAAI,SAAQ,kBAAuB,KAAG,mBAgCpE,CAAC;AAEF,OAAO,EAAE,cAAc,EAAE,CAAC;AAC1B,YAAY,EAAE,qBAAqB,EAAE,CAAC"}

package/dist/config.js

@@ -0,0 +1,105 @@
+/**
+ * Agent configuration resolution (PRD §58).
+ *
+ * Turns a declarative config into concrete providers and a backend. Every
+ * provider is optional except the decision provider; when a provider is absent
+ * the runtime escalates to the person instead of guessing.
+ */
+import { DEFAULT_POLICY, RuntimeError, } from "@mlola/browser-protocol";
+import { ApprovalBroker } from "@mlola/browser-policy";
+import { createFallbackDecisionProvider } from "@mlola/browser-core";
+import { JevDecisionProvider, KeywordDecisionProvider, OpenAIPlannerProvider, OpenAITextProvider } from "@mlola/decision-jev";
+import { playwrightBackendFactory } from "@mlola/backend-playwright";
+const buildBackend = (config) => {
+    const kind = config.browser?.backend ?? "playwright";
+    if (kind === "playwright")
+        return playwrightBackendFactory.create();
+    throw new RuntimeError("INTERNAL", `browser backend "${kind}" is not available in this build`, {
+        detail: "the Chrome extension backend arrives with the extension runtime; use backend: 'playwright'",
+        retryable: false,
+    });
+};
+const buildDecisionProvider = (config) => {
+    const spec = config.decision ?? "typesafe";
+    if (typeof spec === "object" && "decide" in spec)
+        return spec;
+    const choice = typeof spec === "string" ? spec : spec.provider;
+    const options = typeof spec === "object" ? spec : undefined;
+    switch (choice) {
+        case "keyword":
+            return new KeywordDecisionProvider();
+        case "typesafe":
+            return new JevDecisionProvider({
+                ...(options?.model ? { model: options.model } : {}),
+                ...(options?.apiKey ? { apiKey: options.apiKey } : {}),
+                ...(options?.baseUrl ? { baseUrl: options.baseUrl } : {}),
+            });
+        default:
+            throw new RuntimeError("INTERNAL", `unknown decision provider "${String(choice)}"`, { retryable: false });
+    }
+};
+const resolvePlanner = (choice) => {
+    if (choice === "none")
+        return undefined;
+    if (choice && choice !== "auto")
+        return choice;
+    const hasKey = Boolean(process.env["MLOLA_PLANNER_API_KEY"] ?? process.env["OPENAI_API_KEY"]);
+    if (!hasKey && choice === "auto")
+        return undefined;
+    if (!hasKey && choice === undefined)
+        return undefined;
+    try {
+        return new OpenAIPlannerProvider();
+    }
+    catch {
+        return undefined;
+    }
+};
+const resolveText = (choice) => {
+    if (choice === "none")
+        return undefined;
+    if (choice && choice !== "auto")
+        return choice;
+    const hasKey = Boolean(process.env["MLOLA_TEXT_API_KEY"] ??
+        process.env["MLOLA_PLANNER_API_KEY"] ??
+        process.env["OPENAI_API_KEY"]);
+    if (!hasKey)
+        return undefined;
+    try {
+        return new OpenAITextProvider();
+    }
+    catch {
+        return undefined;
+    }
+};
+export const resolveAgentConfig = (config = {}) => {
+    const decision = buildDecisionProvider(config);
+    const planner = resolvePlanner(config.planner);
+    const text = resolveText(config.text);
+    const providers = {
+        decision,
+        ...(planner ? { planner } : {}),
+        ...(text ? { text } : {}),
+        ...(config.vision ? { vision: config.vision } : {}),
+    };
+    if (planner?.chooseAction) {
+        providers.fallbackDecision = createFallbackDecisionProvider(planner);
+    }
+    const approvalsConfig = config.approvals;
+    const approvals = approvalsConfig !== undefined && typeof approvalsConfig.resolve === "function"
+        ? approvalsConfig
+        : new ApprovalBroker(approvalsConfig ?? {});
+    return {
+        backend: buildBackend(config),
+        providers,
+        policy: config.policy ?? {},
+        ...(config.budgets ? { budgets: config.budgets } : {}),
+        approvals,
+        ...(config.humanHelp ? { humanHelp: config.humanHelp } : {}),
+        ...(config.home ? { home: config.home } : {}),
+        screenshot: config.screenshot ?? "off",
+        ...(config.onEvent ? { onEvent: config.onEvent } : {}),
+    };
+};
+export { DEFAULT_POLICY };
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @mlola/browser-runtime — the public SDK.
+ *
+ * A reliable, model-routed browser runtime: deterministic browser mechanics,
+ * safety, verification and recovery, with a fast decision path (Jev) and
+ * selective escalation to a planner or a person.
+ */
+export { BrowserAgent, type AgentEventName, type AgentEventHandler } from "./agent.ts";
+export { resolveAgentConfig, DEFAULT_POLICY, type BrowserAgentConfig, type DecisionProviderChoice, type OptionalProviderChoice, type ResolvedAgentConfig, } from "./config.ts";
+export { JevClient, JevDecisionProvider, OpenAIPlannerProvider, OpenAITextProvider, KeywordDecisionProvider, ScriptedDecisionProvider, buildQuestions, renderDecisionState, } from "@mlola/decision-jev";
+export { PlaywrightBackend, playwrightBackendFactory, createPlaywrightBackend } from "@mlola/backend-playwright";
+export { BackendRegistry } from "@mlola/browser-backend";
+export type { BrowserBackend, BrowserSession, ActionOutcome, PreflightResult } from "@mlola/browser-backend";
+export { TaskOrchestrator, Executor, BudgetManager, buildActionSpace, validateDecision, verifyStep, verifyCompletion, inferCompletionCriteria, resolveText, extractLiterals, createFallbackDecisionProvider, type OrchestratorOptions, type OrchestratorProviders, } from "@mlola/browser-core";
+export { PolicyEngine, ApprovalBroker, assessRisk, quarantineCandidates, findInjectionSignals, type ApprovalBrokerOptions, } from "@mlola/browser-policy";
+export { LoopDetector, nextStrategy, classifyError } from "@mlola/browser-recovery";
+export { ArtifactRegistry, validateUpload, classifyDocumentType, sniffMime } from "@mlola/browser-artifacts";
+export { HumanHelpBroker, UnavailableHumanHelpHost, evaluateCriteria } from "@mlola/browser-takeover";
+export type { HumanHelpHost } from "@mlola/browser-takeover";
+export { EventLog, computeMetrics, formatMetrics, listRuns, readRunEvents, readRunSummary, resolveHome, runPaths, } from "@mlola/browser-trace";
+export * from "@mlola/browser-protocol";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,cAAc,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACvF,OAAO,EACL,kBAAkB,EAClB,cAAc,EACd,KAAK,kBAAkB,EACvB,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,GACzB,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACjH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,YAAY,EAAE,cAAc,EAAE,cAAc,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAG7G,OAAO,EACL,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,uBAAuB,EACvB,WAAW,EACX,eAAe,EACf,8BAA8B,EAC9B,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,GAC3B,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,YAAY,EACZ,cAAc,EACd,UAAU,EACV,oBAAoB,EACpB,oBAAoB,EACpB,KAAK,qBAAqB,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC7G,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AACtG,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAG7D,OAAO,EACL,QAAQ,EACR,cAAc,EACd,aAAa,EACb,QAAQ,EACR,aAAa,EACb,cAAc,EACd,WAAW,EACX,QAAQ,GACT,MAAM,sBAAsB,CAAC;AAG9B,cAAc,yBAAyB,CAAC"}

package/dist/index.js

@@ -0,0 +1,26 @@
+/**
+ * @mlola/browser-runtime — the public SDK.
+ *
+ * A reliable, model-routed browser runtime: deterministic browser mechanics,
+ * safety, verification and recovery, with a fast decision path (Jev) and
+ * selective escalation to a planner or a person.
+ */
+export { BrowserAgent } from "./agent.js";
+export { resolveAgentConfig, DEFAULT_POLICY, } from "./config.js";
+// Provider implementations, so SDK users can compose their own stacks.
+export { JevClient, JevDecisionProvider, OpenAIPlannerProvider, OpenAITextProvider, KeywordDecisionProvider, ScriptedDecisionProvider, buildQuestions, renderDecisionState, } from "@mlola/decision-jev";
+// Browser backends.
+export { PlaywrightBackend, playwrightBackendFactory, createPlaywrightBackend } from "@mlola/backend-playwright";
+export { BackendRegistry } from "@mlola/browser-backend";
+// Runtime engine pieces.
+export { TaskOrchestrator, Executor, BudgetManager, buildActionSpace, validateDecision, verifyStep, verifyCompletion, inferCompletionCriteria, resolveText, extractLiterals, createFallbackDecisionProvider, } from "@mlola/browser-core";
+// Policy, recovery, artifacts, takeover.
+export { PolicyEngine, ApprovalBroker, assessRisk, quarantineCandidates, findInjectionSignals, } from "@mlola/browser-policy";
+export { LoopDetector, nextStrategy, classifyError } from "@mlola/browser-recovery";
+export { ArtifactRegistry, validateUpload, classifyDocumentType, sniffMime } from "@mlola/browser-artifacts";
+export { HumanHelpBroker, UnavailableHumanHelpHost, evaluateCriteria } from "@mlola/browser-takeover";
+// Trace utilities.
+export { EventLog, computeMetrics, formatMetrics, listRuns, readRunEvents, readRunSummary, resolveHome, runPaths, } from "@mlola/browser-trace";
+// Protocol surface (types are the contract).
+export * from "@mlola/browser-protocol";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,YAAY,EAA+C,MAAM,YAAY,CAAC;AACvF,OAAO,EACL,kBAAkB,EAClB,cAAc,GAKf,MAAM,aAAa,CAAC;AAErB,uEAAuE;AACvE,OAAO,EACL,SAAS,EACT,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,uBAAuB,EACvB,wBAAwB,EACxB,cAAc,EACd,mBAAmB,GACpB,MAAM,qBAAqB,CAAC;AAE7B,oBAAoB;AACpB,OAAO,EAAE,iBAAiB,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AACjH,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAGzD,yBAAyB;AACzB,OAAO,EACL,gBAAgB,EAChB,QAAQ,EACR,aAAa,EACb,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,uBAAuB,EACvB,WAAW,EACX,eAAe,EACf,8BAA8B,GAG/B,MAAM,qBAAqB,CAAC;AAE7B,yCAAyC;AACzC,OAAO,EACL,YAAY,EACZ,cAAc,EACd,UAAU,EACV,oBAAoB,EACpB,oBAAoB,GAErB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACpF,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAC7G,OAAO,EAAE,eAAe,EAAE,wBAAwB,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAGtG,mBAAmB;AACnB,OAAO,EACL,QAAQ,EACR,cAAc,EACd,aAAa,EACb,QAAQ,EACR,aAAa,EACb,cAAc,EACd,WAAW,EACX,QAAQ,GACT,MAAM,sBAAsB,CAAC;AAE9B,6CAA6C;AAC7C,cAAc,yBAAyB,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@mlola/browser-runtime",
+  "version": "0.1.0",
+  "description": "Public SDK: BrowserAgent over the core runtime with the default Jev + Playwright stack.",
+  "type": "module",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "development": "./src/index.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "sideEffects": false,
+  "engines": {
+    "node": ">=22.18"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mlolahq/browser-runtime.git"
+  },
+  "homepage": "https://mlola.com/browser-runtime",
+  "bugs": {
+    "url": "https://github.com/mlolahq/browser-runtime.git/issues"
+  },
+  "keywords": [
+    "browser-automation",
+    "browser-agent",
+    "runtime",
+    "playwright",
+    "agent",
+    "jev",
+    "llm",
+    "automation"
+  ],
+  "scripts": {
+    "build": "tsc -b"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@mlola/browser-protocol": "0.1.0",
+    "@mlola/browser-core": "0.1.0",
+    "@mlola/decision-jev": "0.1.0",
+    "@mlola/backend-playwright": "0.1.0"
+  }
+}