@oya-ai/cli 1.0.73 → 1.0.75

package/dist/index.js

@@ -157,16 +157,57 @@ var Browser = class {
     if (result.liveViewUrl) result.liveViewUrl = new URL(result.liveViewUrl, this.http.baseUrl).href;
     return result;
   }
-  /** Natural-language control, using this key's configured model. */
-  async ask(prompt) {
+  /**
+   * Natural-language control, using this key's configured model. Refer to `data`
+   * as `{{name}}` in the prompt: the agent types the placeholder, the page gets the
+   * value, and the model never sees it.
+   */
+  async ask(prompt, { data } = {}) {
     const res = await this.http.request(
       "POST",
       `/api/browsers/${this.id}/chat`,
-      { messages: [{ role: "user", content: prompt }] },
+      { messages: [{ role: "user", content: prompt }], data },
       6e5
     );
+    if (res.error) throw new OyaError(res.error, 500, res);
     return res.text;
   }
+  /**
+   * Save the last `ask()` on this browser as a named playbook. Values that came
+   * from the prompt (names, IDs, dates) become variables; `code` is the same
+   * flow as a Playwright module, to read or run yourself.
+   */
+  toPlaybook(name) {
+    return this.http.request("POST", `/api/browsers/${this.id}/playbooks`, { name }, 12e4);
+  }
+  /**
+   * Replay a playbook with no LLM in the loop. Variables left out reuse the
+   * recorded values where there are any. If a step no longer fits the page and
+   * `autoHeal` is on (the default), the agent finishes the task and its fix is
+   * saved as a draft (`healed`, `draft`); off, the step's error is thrown.
+   * Play `'<name>:draft'` to try a draft before promoting it.
+   */
+  async play(name, data = {}, { autoHeal = true } = {}) {
+    const res = await this.http.request(
+      "POST",
+      `/api/browsers/${this.id}/playbooks/${encodeURIComponent(name)}/play`,
+      { variables: data, autoHeal },
+      6e5
+    );
+    if (res.error) throw new OyaError(res.error, 500, res);
+    return res;
+  }
+  /**
+   * Start a prompt or playbook in the background and hear back through callbacks.
+   * `onHumanAttention` fires for an unsolved CAPTCHA, an unfinished MFA, the agent
+   * asking for help, or a replay the agent could not heal; the run waits (up to 30
+   * minutes) until you call `respond()`.
+   */
+  async submit(task, options = {}) {
+    const { onSuccess, onFailure, onHumanAttention, onHealed, pollMs, ...body } = options;
+    const started = await this.http.request("POST", `/api/browsers/${this.id}/runs`, { ...task, ...body });
+    return new Run(this.http, started.id, { onSuccess, onFailure, onHumanAttention, onHealed }, pollMs);
+  }
   /**
    * Watch it work: the console, opened on this browser.
    *
@@ -238,6 +279,72 @@ var Browser = class {
     await this.stop();
   }
 };
+var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+var Run = class {
+  constructor(http, id, callbacks, pollMs = 2e3) {
+    this.http = http;
+    this.id = id;
+    this.done = this.watch(callbacks, pollMs);
+    this.done.catch(() => {
+    });
+  }
+  http;
+  id;
+  done;
+  status() {
+    return this.http.request("GET", `/api/runs/${encodeURIComponent(this.id)}`);
+  }
+  /** Answer the open attention request: `'done'` after handling it by hand, or your reply to the agent. */
+  async respond(response = "done") {
+    await this.http.request("POST", `/api/runs/${encodeURIComponent(this.id)}/respond`, { response });
+  }
+  async watch(cb, pollMs) {
+    const call = async (fn) => {
+      try {
+        await fn();
+      } catch (err) {
+        console.error("[oya] run callback threw:", err);
+      }
+    };
+    let seen;
+    for (let errors = 0; ; ) {
+      let run2;
+      try {
+        run2 = await this.status();
+        errors = 0;
+      } catch (err) {
+        if (++errors < 5) {
+          await sleep(pollMs);
+          continue;
+        }
+        const failure = err instanceof OyaError ? err : new OyaError(String(err), 0, null);
+        await call(() => cb.onFailure?.(failure));
+        throw failure;
+      }
+      if (run2.status === "needs_attention" && run2.attention && run2.attention.id !== seen) {
+        seen = run2.attention.id;
+        const request = {
+          ...run2.attention,
+          liveViewUrl: run2.attention.liveViewUrl && new URL(run2.attention.liveViewUrl, this.http.baseUrl).href,
+          respond: (response) => this.respond(response)
+        };
+        void call(() => cb.onHumanAttention?.(request));
+      }
+      if (run2.status === "succeeded") {
+        const result = run2.result || {};
+        if (result.healed) await call(() => cb.onHealed?.(result));
+        await call(() => cb.onSuccess?.(result));
+        return result;
+      }
+      if (run2.status === "failed") {
+        const failure = new OyaError(run2.error || "Run failed", 500, run2);
+        await call(() => cb.onFailure?.(failure));
+        throw failure;
+      }
+      await sleep(pollMs);
+    }
+  }
+};
 var DEFAULT_BASE_URL = "https://browser.getoya.ai";
 var READY_POLL_MS = 2e3;
 var env = (name) => globalThis.process?.env?.[name];
@@ -312,6 +419,16 @@ var Oya = class {
     removeWebhook: (id) => this.http.request("DELETE", `/api/control/webhooks/${encodeURIComponent(id)}`),
     replayDelivery: (id) => this.http.request("POST", `/api/control/deliveries/${encodeURIComponent(id)}/replay`, {})
   };
+  /** Playbooks saved with `browser.toPlaybook()`. */
+  playbooks = {
+    list: async () => (await this.http.request("GET", "/api/playbooks")).playbooks,
+    /** Delete a playbook and its draft, or only the draft with `'<name>:draft'`. */
+    remove: async (name) => {
+      await this.http.request("DELETE", `/api/playbooks/${encodeURIComponent(name)}`);
+    },
+    /** Replace a playbook with the draft a healed replay saved. Try it first with `browser.play('<name>:draft')`. */
+    promote: (name) => this.http.request("POST", `/api/playbooks/${encodeURIComponent(name)}/promote`, {})
+  };
   /**
    * Proxy exits for your personas. A persona takes one at first connect (by its
    * geo hint) or by `personas.pinProxy`, and keeps it.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oya-ai/cli",
-  "version": "1.0.73",
+  "version": "1.0.75",
   "description": "Command line for the Oya browser control plane.",
   "license": "MIT",
   "homepage": "https://browser.getoya.ai",
@@ -39,7 +39,7 @@
     "access": "public"
   },
   "devDependencies": {
-    "@oya-ai/browser": "1.0.73",
+    "@oya-ai/browser": "1.0.75",
     "@types/node": "^20.19.43",
     "tsup": "^8.0.0",
     "typescript": "^5.4.0"