@ap3x/browser-agent 0.1.0 → 0.2.0

package/dist/{chunk-UZALZUEE.js → chunk-LXHBVRFM.js}

@@ -9,6 +9,70 @@ function isDoneResult(result) {
   return result.isDone === true;
 }
 
+// src/agent/postconditions.ts
+import { Type } from "@sinclair/typebox";
+var BrowserPostconditionSchema = Type.Union([
+  Type.Object(
+    { kind: Type.Literal("url"), equals: Type.String() },
+    { additionalProperties: false }
+  ),
+  Type.Object(
+    {
+      kind: Type.Literal("page_identity"),
+      title: Type.Optional(Type.String()),
+      textIncludes: Type.Optional(Type.String())
+    },
+    { additionalProperties: false }
+  ),
+  Type.Object(
+    { kind: Type.Literal("visible"), selector: Type.String() },
+    { additionalProperties: false }
+  ),
+  Type.Object(
+    { kind: Type.Literal("selected_value"), selector: Type.String(), value: Type.String() },
+    { additionalProperties: false }
+  )
+]);
+var PostconditionError = class extends Error {
+  constructor(condition) {
+    super(`Browser postcondition failed: ${condition.kind}`);
+    this.condition = condition;
+    this.name = "PostconditionError";
+  }
+  condition;
+  reasonCode = "postcondition_failed";
+};
+async function verifyPostconditions(conditions, driver, session, signal) {
+  if (!conditions.length) return;
+  const state = await driver.getState({ signal });
+  for (const condition of conditions) {
+    if (signal?.aborted) throw new DOMException("Aborted", "AbortError");
+    let passed = false;
+    switch (condition.kind) {
+      case "url":
+        passed = state.url === condition.equals;
+        break;
+      case "page_identity":
+        passed = (condition.title !== void 0 || condition.textIncludes !== void 0) && (condition.title === void 0 || state.title === condition.title) && (condition.textIncludes === void 0 || state.serializedText.includes(condition.textIncludes));
+        break;
+      case "visible":
+        passed = await session.evaluate(
+          `(()=>{const elements=document.querySelectorAll(${JSON.stringify(condition.selector)});if(elements.length!==1)return false;const e=elements[0];const s=getComputedStyle(e);const r=e.getBoundingClientRect();return s.display!=='none'&&s.visibility!=='hidden'&&r.width>0&&r.height>0;})()`,
+          { signal }
+        );
+        break;
+      case "selected_value":
+        passed = await session.evaluate(
+          `(()=>{const elements=document.querySelectorAll(${JSON.stringify(condition.selector)});return elements.length===1&&elements[0].value===${JSON.stringify(condition.value)};})()`,
+          { signal }
+        );
+        break;
+    }
+    if (signal?.aborted) throw new DOMException("Aborted", "AbortError");
+    if (!passed) throw new PostconditionError(condition);
+  }
+}
+
 // src/tools/sensitive.ts
 import { createHmac } from "crypto";
 import { matchUrlWithDomainPattern } from "@ap3x/browser";
@@ -124,8 +188,9 @@ function totp(seed, options = {}) {
 }
 
 // src/tools/registry.ts
+import { authorizeTool, currentRunContext, immutableArguments, uuidv7 } from "@ap3x/agent-core";
 import { matchUrlWithDomainPattern as matchUrlWithDomainPattern2 } from "@ap3x/browser";
-import { Type } from "@sinclair/typebox";
+import { Type as Type2 } from "@sinclair/typebox";
 import { Value } from "@sinclair/typebox/value";
 function defineAction(def) {
   return def;
@@ -150,6 +215,8 @@ var Registry = class _Registry {
       throw new Error(`Action "${def.name}" is already registered`);
     }
     this.actions.set(def.name, {
+      replaySafe: def.replaySafe ?? false,
+      postconditions: def.postconditions,
       name: def.name,
       description: def.description,
       schema: def.schema,
@@ -192,9 +259,9 @@ var Registry = class _Registry {
     const cached = this.unionCache.get(key);
     if (cached) return cached;
     const members = admitted.map(
-      (a) => Type.Object({ [a.name]: a.schema }, { additionalProperties: false, title: a.name })
+      (a) => Type2.Object({ [a.name]: a.schema }, { additionalProperties: false, title: a.name })
     );
-    const union = members.length === 0 ? Type.Never() : members.length === 1 ? members[0] : Type.Union(members);
+    const union = members.length === 0 ? Type2.Never() : members.length === 1 ? members[0] : Type2.Union(members);
     this.unionCache.set(key, union);
     return union;
   }
@@ -242,7 +309,14 @@ var Registry = class _Registry {
       });
     }
     try {
-      const result = await action.execute(params, ctx);
+      const context = currentRunContext();
+      const finalParams = immutableArguments(params);
+      await authorizeTool(context, name, uuidv7(), finalParams, ctx.signal);
+      context?.controller?.assertActive(ctx.signal);
+      context?.controller?.tool();
+      const result = await action.execute(finalParams, ctx);
+      if (result.error === void 0 && action.postconditions)
+        await verifyPostconditions(action.postconditions, ctx.driver, ctx.session, ctx.signal);
       return maskResultSecrets(result, resolved, allSensitiveData);
     } catch (error) {
       const message = error instanceof Error ? error.message : String(error);
@@ -363,7 +437,7 @@ async function readExternalFile(path) {
 // src/tools/actions.ts
 import { basename, join } from "path";
 import { InteractionError, PAGE_SCROLL_PX, asElementIndex, isPathContained } from "@ap3x/browser";
-import { Type as Type2 } from "@sinclair/typebox";
+import { Type as Type3 } from "@sinclair/typebox";
 var sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
 function nodeAt(ctx, index) {
   const node = ctx.session.getElementByIndex(index);
@@ -380,7 +454,7 @@ function nodeAt(ctx, index) {
 var navigate = defineAction({
   name: "navigate",
   description: "Navigate the current tab to a URL (opens a new tab when newTab is true).",
-  schema: Type2.Object({ url: Type2.String(), newTab: Type2.Optional(Type2.Boolean()) }),
+  schema: Type3.Object({ url: Type3.String(), newTab: Type3.Optional(Type3.Boolean()) }),
   terminatesSequence: true,
   async execute(params, ctx) {
     if (params.newTab) {
@@ -394,7 +468,7 @@ var navigate = defineAction({
 var goBack = defineAction({
   name: "go_back",
   description: "Go back one entry in the browser history.",
-  schema: Type2.Object({}),
+  schema: Type3.Object({}),
   terminatesSequence: true,
   async execute(_params, ctx) {
     await ctx.session.goBack();
@@ -404,7 +478,7 @@ var goBack = defineAction({
 var click = defineAction({
   name: "click",
   description: "Click an interactive element by its [index].",
-  schema: Type2.Object({ index: Type2.Integer({ minimum: 1 }) }),
+  schema: Type3.Object({ index: Type3.Integer({ minimum: 1 }) }),
   async execute(params, ctx) {
     const resolved = nodeAt(ctx, params.index);
     if (!resolved.ok) return resolved.result;
@@ -415,10 +489,10 @@ var click = defineAction({
 var inputText = defineAction({
   name: "input_text",
   description: "Type text into an element by its [index]. clear=false appends; text='' clears.",
-  schema: Type2.Object({
-    index: Type2.Integer({ minimum: 0 }),
-    text: Type2.String(),
-    clear: Type2.Optional(Type2.Boolean())
+  schema: Type3.Object({
+    index: Type3.Integer({ minimum: 0 }),
+    text: Type3.String(),
+    clear: Type3.Optional(Type3.Boolean())
   }),
   async execute(params, ctx) {
     const resolved = nodeAt(ctx, params.index);
@@ -436,10 +510,10 @@ var inputText = defineAction({
 var scroll = defineAction({
   name: "scroll",
   description: "Scroll the page (or an element by [index]) up/down by a number of pages.",
-  schema: Type2.Object({
-    down: Type2.Optional(Type2.Boolean()),
-    pages: Type2.Optional(Type2.Number()),
-    index: Type2.Optional(Type2.Integer({ minimum: 1 }))
+  schema: Type3.Object({
+    down: Type3.Optional(Type3.Boolean()),
+    pages: Type3.Optional(Type3.Number()),
+    index: Type3.Optional(Type3.Integer({ minimum: 1 }))
   }),
   async execute(params, ctx) {
     const pages = params.pages ?? 1;
@@ -459,7 +533,7 @@ var scroll = defineAction({
 var scrollToText = defineAction({
   name: "scroll_to_text",
   description: "Scroll to the first occurrence of the given text.",
-  schema: Type2.Object({ text: Type2.String() }),
+  schema: Type3.Object({ text: Type3.String() }),
   async execute(params, ctx) {
     try {
       await ctx.session.input.scrollToText(params.text, { signal: ctx.signal });
@@ -475,7 +549,7 @@ var scrollToText = defineAction({
 var sendKeys = defineAction({
   name: "send_keys",
   description: "Dispatch raw keyboard keys or a shortcut (e.g. 'Enter', 'Control+a').",
-  schema: Type2.Object({ keys: Type2.String() }),
+  schema: Type3.Object({ keys: Type3.String() }),
   async execute(params, ctx) {
     await ctx.session.input.sendKeys(params.keys, { signal: ctx.signal });
     return stepResult({ longTermMemory: `Sent keys ${params.keys}` });
@@ -484,7 +558,7 @@ var sendKeys = defineAction({
 var selectDropdown = defineAction({
   name: "select_dropdown",
   description: "Select a dropdown option by its exact text, on the element at [index].",
-  schema: Type2.Object({ index: Type2.Integer({ minimum: 1 }), text: Type2.String() }),
+  schema: Type3.Object({ index: Type3.Integer({ minimum: 1 }), text: Type3.String() }),
   async execute(params, ctx) {
     const resolved = nodeAt(ctx, params.index);
     if (!resolved.ok) return resolved.result;
@@ -501,8 +575,9 @@ var selectDropdown = defineAction({
 });
 var getDropdownOptions = defineAction({
   name: "get_dropdown_options",
+  replaySafe: true,
   description: "List the available options of the dropdown element at [index].",
-  schema: Type2.Object({ index: Type2.Integer({ minimum: 1 }) }),
+  schema: Type3.Object({ index: Type3.Integer({ minimum: 1 }) }),
   async execute(params, ctx) {
     const resolved = nodeAt(ctx, params.index);
     if (!resolved.ok) return resolved.result;
@@ -518,7 +593,7 @@ var getDropdownOptions = defineAction({
 var switchTab = defineAction({
   name: "switch_tab",
   description: "Focus another tab by its 4-char id.",
-  schema: Type2.Object({ tabId: Type2.String() }),
+  schema: Type3.Object({ tabId: Type3.String() }),
   terminatesSequence: true,
   async execute(params, ctx) {
     await ctx.driver.switchTab(params.tabId);
@@ -528,7 +603,7 @@ var switchTab = defineAction({
 var openTab = defineAction({
   name: "open_tab",
   description: "Open a new tab at a URL.",
-  schema: Type2.Object({ url: Type2.String() }),
+  schema: Type3.Object({ url: Type3.String() }),
   terminatesSequence: true,
   async execute(params, ctx) {
     const tabId = await ctx.session.openTab(params.url);
@@ -538,7 +613,7 @@ var openTab = defineAction({
 var closeTab = defineAction({
   name: "close_tab",
   description: "Close a tab by its 4-char id.",
-  schema: Type2.Object({ tabId: Type2.String() }),
+  schema: Type3.Object({ tabId: Type3.String() }),
   async execute(params, ctx) {
     await ctx.driver.closeTab(params.tabId);
     return stepResult({ longTermMemory: `Closed tab ${params.tabId}` });
@@ -547,7 +622,7 @@ var closeTab = defineAction({
 var uploadFile = defineAction({
   name: "upload_file",
   description: "Set a file on the file-input element at [index]. Path must be available.",
-  schema: Type2.Object({ index: Type2.Integer({ minimum: 0 }), path: Type2.String() }),
+  schema: Type3.Object({ index: Type3.Integer({ minimum: 0 }), path: Type3.String() }),
   async execute(params, ctx) {
     let uploadPath;
     const base = basename(params.path);
@@ -569,8 +644,9 @@ var uploadFile = defineAction({
 });
 var wait = defineAction({
   name: "wait",
+  replaySafe: true,
   description: "Wait for a number of seconds (capped at 30).",
-  schema: Type2.Object({ seconds: Type2.Optional(Type2.Number()) }),
+  schema: Type3.Object({ seconds: Type3.Optional(Type3.Number()) }),
   async execute(params) {
     const requested = params.seconds ?? 3;
     await sleep(Math.min(Math.max(requested - 1, 0), 30) * 1e3);
@@ -579,9 +655,10 @@ var wait = defineAction({
 });
 var extractContent = defineAction({
   name: "extract_content",
+  replaySafe: true,
   description: "Extract the page's readable content, guided by a query.",
-  schema: Type2.Object({
-    query: Type2.String()
+  schema: Type3.Object({
+    query: Type3.String()
   }),
   async execute(params, ctx) {
     const text = await ctx.driver.extract(params.query, { signal: ctx.signal });
@@ -599,10 +676,10 @@ ${content}`,
 var writeFile = defineAction({
   name: "write_file",
   description: "Write (replacing) a file in the agent workspace.",
-  schema: Type2.Object({
-    fileName: Type2.String(),
-    content: Type2.String(),
-    append: Type2.Optional(Type2.Boolean())
+  schema: Type3.Object({
+    fileName: Type3.String(),
+    content: Type3.String(),
+    append: Type3.Optional(Type3.Boolean())
   }),
   async execute(params, ctx) {
     const message = params.append ? await ctx.fileSystem.appendFile(params.fileName, params.content) : await ctx.fileSystem.writeFile(params.fileName, params.content);
@@ -612,7 +689,7 @@ var writeFile = defineAction({
 var appendFile = defineAction({
   name: "append_file",
   description: "Append content to a file in the agent workspace.",
-  schema: Type2.Object({ fileName: Type2.String(), content: Type2.String() }),
+  schema: Type3.Object({ fileName: Type3.String(), content: Type3.String() }),
   async execute(params, ctx) {
     const message = await ctx.fileSystem.appendFile(params.fileName, params.content);
     return stepResult({ extractedContent: message, longTermMemory: message });
@@ -621,7 +698,7 @@ var appendFile = defineAction({
 var replaceFile = defineAction({
   name: "replace_file",
   description: "Replace a substring in a workspace file (the todo.md checkbox primitive).",
-  schema: Type2.Object({ fileName: Type2.String(), oldStr: Type2.String(), newStr: Type2.String() }),
+  schema: Type3.Object({ fileName: Type3.String(), oldStr: Type3.String(), newStr: Type3.String() }),
   async execute(params, ctx) {
     const message = await ctx.fileSystem.replaceFileStr(
       params.fileName,
@@ -633,8 +710,9 @@ var replaceFile = defineAction({
 });
 var readFile = defineAction({
   name: "read_file",
+  replaySafe: true,
   description: "Read a workspace file, or a whitelisted external file (text, .pdf, or .docx).",
-  schema: Type2.Object({ fileName: Type2.String() }),
+  schema: Type3.Object({ fileName: Type3.String() }),
   async execute(params, ctx) {
     const managed = ctx.fileSystem.getFile(params.fileName);
     if (managed !== void 0) {
@@ -657,10 +735,10 @@ ${content}` });
 var done = defineAction({
   name: "done",
   description: "Finish the task. success=true ONLY when fully complete. text must report only observed facts.",
-  schema: Type2.Object({
-    text: Type2.String(),
-    success: Type2.Boolean(),
-    filesToDisplay: Type2.Optional(Type2.Array(Type2.String()))
+  schema: Type3.Object({
+    text: Type3.String(),
+    success: Type3.Boolean(),
+    filesToDisplay: Type3.Optional(Type3.Array(Type3.String()))
   }),
   execute(params, ctx) {
     const attachments = (params.filesToDisplay ?? []).map((name) => ctx.fileSystem.displayFile(name) !== void 0 ? name : void 0).filter((n) => n !== void 0);
@@ -979,28 +1057,28 @@ function isBinaryExtension(ext) {
 }
 
 // src/agent/output-schema.ts
-import { Type as Type3 } from "@sinclair/typebox";
+import { Type as Type4 } from "@sinclair/typebox";
 function buildAgentOutputSchema(actionUnion, variant) {
-  const action = Type3.Array(actionUnion, { minItems: 1 });
+  const action = Type4.Array(actionUnion, { minItems: 1 });
   if (variant === "flash") {
-    return Type3.Object(
-      { memory: Type3.String(), action },
+    return Type4.Object(
+      { memory: Type4.String(), action },
       { additionalProperties: false, title: "AgentOutput" }
     );
   }
   const fields = {
-    evaluation_previous_goal: Type3.String(),
-    memory: Type3.String(),
-    next_goal: Type3.String(),
+    evaluation_previous_goal: Type4.String(),
+    memory: Type4.String(),
+    next_goal: Type4.String(),
     action
   };
   if (variant === "thinking") {
-    return Type3.Object(
-      { thinking: Type3.Optional(Type3.String()), ...fields },
+    return Type4.Object(
+      { thinking: Type4.Optional(Type4.String()), ...fields },
       { additionalProperties: false, title: "AgentOutput" }
     );
   }
-  return Type3.Object(fields, { additionalProperties: false, title: "AgentOutput" });
+  return Type4.Object(fields, { additionalProperties: false, title: "AgentOutput" });
 }
 function parseAction(entry) {
   const keys = Object.keys(entry);
@@ -1682,6 +1760,7 @@ var CaptchaWatchdog = class {
 };
 
 // src/agent/step-loop.ts
+import { controlledProviderCall, currentRunContext as currentRunContext2 } from "@ap3x/agent-core";
 import {
   StructuredOutputError,
   generateObject
@@ -1689,7 +1768,7 @@ import {
 import {
   buildInteractedElement
 } from "@ap3x/browser";
-import { Type as Type4 } from "@sinclair/typebox";
+import { Type as Type5 } from "@sinclair/typebox";
 function anySignal(...signals) {
   const present = signals.filter((s) => s !== void 0);
   if (present.length === 0) return void 0;
@@ -1743,6 +1822,13 @@ var StepLoop = class {
     this.stopped = true;
     this.resume();
   }
+  /** Inject a mid-run course-correction: `text` rides into the NEXT step's
+   * messages as a transient nudge (drained per step, like the loop-detector's).
+   * Lets a caller steer a running agent without pausing or restarting it. */
+  steer(text) {
+    const trimmed = text.trim();
+    if (trimmed) this.pendingNudges.push(trimmed);
+  }
   get isDone() {
     return this.done;
   }
@@ -1886,10 +1972,14 @@ var StepLoop = class {
     let output;
     try {
       const llmSignal = anySignal(stepSignal, AbortSignal.timeout(this.deps.limits.llmTimeoutMs));
-      const { object, usage } = await generateObject(this.deps.model, messages, schema, {
-        ...this.deps.llmStreamOptions,
-        signal: llmSignal
-      });
+      currentRunContext2()?.controller?.turn();
+      const options = { ...this.deps.llmStreamOptions, signal: llmSignal };
+      const { object, usage } = await controlledProviderCall(
+        this.deps.model,
+        { messages },
+        options,
+        () => generateObject(this.deps.model, messages, schema, options)
+      );
       this.deps.ledger.record(this.deps.model.id, usage);
       output = object;
     } catch (error) {
@@ -2052,8 +2142,8 @@ var StepLoop = class {
   /** A single-key union carrying only `done` (forced-termination schema). */
   doneOnlyUnion() {
     const done2 = this.deps.registry.get("done");
-    const schema = done2?.schema ?? Type4.Object({ text: Type4.String(), success: Type4.Boolean() });
-    return Type4.Object({ done: schema }, { additionalProperties: false, title: "done" });
+    const schema = done2?.schema ?? Type5.Object({ text: Type5.String(), success: Type5.Boolean() });
+    return Type5.Object({ done: schema }, { additionalProperties: false, title: "done" });
   }
 };
 function historyState(state, sensitiveData) {
@@ -2259,17 +2349,18 @@ function generateRunGif(history, options = {}) {
 }
 
 // src/agent/judge.ts
+import { controlledProviderCall as controlledProviderCall2 } from "@ap3x/agent-core";
 import {
   generateObject as generateObject2
 } from "@ap3x/ai";
 import { PLACEHOLDER_SCREENSHOT as PLACEHOLDER_SCREENSHOT2 } from "@ap3x/browser";
-import { Type as Type5 } from "@sinclair/typebox";
-var JudgementResultSchema = Type5.Object({
-  reasoning: Type5.String(),
-  verdict: Type5.Boolean(),
-  failureReason: Type5.String(),
-  impossibleTask: Type5.Boolean(),
-  reachedCaptcha: Type5.Boolean()
+import { Type as Type6 } from "@sinclair/typebox";
+var JudgementResultSchema = Type6.Object({
+  reasoning: Type6.String(),
+  verdict: Type6.Boolean(),
+  failureReason: Type6.String(),
+  impossibleTask: Type6.Boolean(),
+  reachedCaptcha: Type6.Boolean()
 });
 var MAX_TEXT_CHARS = 4e4;
 var DEFAULT_MAX_IMAGES = 10;
@@ -2341,10 +2432,13 @@ async function judgeRun(model, task, history, options = {}) {
     { role: "user", content: system, timestamp: Date.now() },
     { role: "user", content: userParts, timestamp: Date.now() }
   ];
-  const { object, usage } = await generateObject2(model, messages, JudgementResultSchema, {
-    ...options.streamOptions,
-    signal: options.signal
-  });
+  const streamOptions = { ...options.streamOptions, signal: options.signal };
+  const { object, usage } = await controlledProviderCall2(
+    model,
+    { messages },
+    streamOptions,
+    () => generateObject2(model, messages, JudgementResultSchema, streamOptions)
+  );
   return { judgement: object, usage };
 }
 
@@ -2375,11 +2469,11 @@ import { randomUUID } from "crypto";
 import { tmpdir } from "os";
 import { join as join3 } from "path";
 import { BrowserDriver } from "@ap3x/browser";
-import { Type as Type6 } from "@sinclair/typebox";
+import { Type as Type7 } from "@sinclair/typebox";
 var screenshotAction = defineAction({
   name: "screenshot",
   description: "Capture a screenshot of the current page for visual inspection.",
-  schema: Type6.Object({}),
+  schema: Type7.Object({}),
   async execute(_params, ctx) {
     const data = await ctx.driver.screenshot({ signal: ctx.signal });
     return stepResult({
@@ -2435,6 +2529,7 @@ var Agent = class {
   stepLoop;
   pendingPaused = false;
   pendingStopped = false;
+  pendingSteers = [];
   /** Set once, after `run()` completes, when `output.generateGif` is on. */
   lastGif;
   /** Set once, after `run()` completes, when `output.recordHar` is on. */
@@ -2533,6 +2628,13 @@ var Agent = class {
     if (this.stepLoop) this.stepLoop.stop();
     else this.pendingStopped = true;
   }
+  /** Course-correct a running (or not-yet-started) run: `text` is delivered to
+   * the agent as a nudge on its next step. Buffered until the step loop exists
+   * (mirroring `pause`), then flushed in order. */
+  steer(text) {
+    if (this.stepLoop) this.stepLoop.steer(text);
+    else this.pendingSteers.push(text);
+  }
   // --- internals -------------------------------------------------------------
   /** Clone the caller's (or default) registry and apply the vision filter (E7). */
   buildRegistry() {
@@ -2646,6 +2748,7 @@ var Agent = class {
     });
     if (this.pendingStopped) this.stepLoop.stop();
     else if (this.pendingPaused) this.stepLoop.pause();
+    for (const steer of this.pendingSteers.splice(0)) this.stepLoop.steer(steer);
     return this.stepLoop;
   }
 };
@@ -2672,7 +2775,7 @@ import {
   CallToolRequestSchema,
   ListToolsRequestSchema
 } from "@modelcontextprotocol/sdk/types.js";
-import { Type as Type7 } from "@sinclair/typebox";
+import { Type as Type8 } from "@sinclair/typebox";
 var ACT_TOOLS = [
   { tool: "browser_navigate", action: "navigate" },
   { tool: "browser_click", action: "click" },
@@ -2683,12 +2786,12 @@ var ACT_TOOLS = [
   { tool: "browser_switch_tab", action: "switch_tab" },
   { tool: "browser_close_tab", action: "close_tab" }
 ];
-var GET_STATE_SCHEMA = Type7.Object({ include_screenshot: Type7.Optional(Type7.Boolean()) });
-var SCREENSHOT_SCHEMA = Type7.Object({ full_page: Type7.Optional(Type7.Boolean()) });
-var LIST_TABS_SCHEMA = Type7.Object({});
-var RUN_AGENT_SCHEMA = Type7.Object({
-  task: Type7.String(),
-  max_steps: Type7.Optional(Type7.Integer({ minimum: 1 }))
+var GET_STATE_SCHEMA = Type8.Object({ include_screenshot: Type8.Optional(Type8.Boolean()) });
+var SCREENSHOT_SCHEMA = Type8.Object({ full_page: Type8.Optional(Type8.Boolean()) });
+var LIST_TABS_SCHEMA = Type8.Object({});
+var RUN_AGENT_SCHEMA = Type8.Object({
+  task: Type8.String(),
+  max_steps: Type8.Optional(Type8.Integer({ minimum: 1 }))
 });
 function textResult(text) {
   return { content: [{ type: "text", text }] };
@@ -2857,6 +2960,9 @@ export {
   stepResult,
   doneResult,
   isDoneResult,
+  BrowserPostconditionSchema,
+  PostconditionError,
+  verifyPostconditions,
   resolveSecretsForUrl,
   applicablePlaceholders,
   sensitiveDataDescription,

package/dist/index.d.ts

@@ -34,4 +34,6 @@ export * from "./agent/judge";
 export * from "./agent/captcha-watchdog";
 export * from "./agent/video";
 export * from "./testing";
+export { verifyPostconditions, PostconditionError, type BrowserPostcondition, } from "./agent/postconditions";
+export { BrowserWorkflowCatalog, type BrowserWorkflow, type BrowserWorkflowStep, type BrowserWorkflowStepResult, type BrowserWorkflowResult, } from "./agent/workflow-catalog";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,wBAAwB,CAAC;AAC7C,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AAEzC,cAAc,4BAA4B,CAAC;AAG3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,cAAc,wBAAwB,CAAC;AACvC,cAAc,OAAO,CAAC;AAGtB,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gBAAgB,CAAC;AAI/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAG9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,eAAO,MAAM,OAAO,wBAAwB,CAAC;AAC7C,eAAO,MAAM,OAAO,UAAU,CAAC;AAE/B,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,0BAA0B,CAAC;AAEzC,cAAc,4BAA4B,CAAC;AAG3C,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,yBAAyB,CAAC;AACxC,cAAc,kBAAkB,CAAC;AACjC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,cAAc,wBAAwB,CAAC;AACvC,cAAc,OAAO,CAAC;AAGtB,cAAc,iBAAiB,CAAC;AAChC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,gBAAgB,CAAC;AAI/B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAG9B,cAAc,0BAA0B,CAAC;AACzC,cAAc,eAAe,CAAC;AAC9B,cAAc,WAAW,CAAC;AAE1B,OAAO,EACL,oBAAoB,EACpB,kBAAkB,EAClB,KAAK,oBAAoB,GAC1B,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACL,sBAAsB,EACtB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,qBAAqB,GAC3B,MAAM,0BAA0B,CAAC"}