@oya-ai/cli 1.0.129 → 1.0.131

package/dist/index.js

@@ -1931,9 +1931,8 @@ var Browser = class {
   /**
    * 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.
+   * `autoHeal` is on (the default), the agent finishes the task and its fix
+   * replaces the broken steps in the playbook (`healed`); off, the step's error is thrown.
    */
   async play(name, data = {}, { autoHeal = true } = {}) {
     const path = `/api/browsers/${this.id}/playbooks/${segment(name, "name")}/play`;
@@ -2153,7 +2152,24 @@ var playbookApi = (http) => ({
     await http().request("DELETE", playbook(name));
   },
   /** Replace a playbook with the draft a healed replay saved. Try it first with `browser.play('<name>:draft')`. */
-  promote: async (name) => http().request("POST", `${playbook(name)}/promote`, {})
+  promote: async (name) => http().request("POST", `${playbook(name)}/promote`, {}),
+  ...transferApi(http)
+});
+var transferApi = (http) => ({
+  /** The playbook as one JSON document, to move it to another environment with `import()`. Secrets travel by name only. */
+  export: async (name) => http().request("GET", `${playbook(name)}/export`),
+  /**
+   * Save an exported playbook here, as `name` or the name it was exported with. A name
+   * already taken is refused unless `overwrite` is true.
+   */
+  import: async (doc, options = {}) => http().request("POST", "/api/playbooks/import", { playbook: doc, ...options })
+});
+var llmApi = (http) => ({
+  /**
+   * The text for one free-text field, written by this key's model: what an exported
+   * playbook calls as `oya.llm.answer(question, vars)` for a comment or a question's answer.
+   */
+  answer: async (question, values = {}, task) => (await http().request("POST", "/api/playbooks/answer", { question, values, task })).answer
 });
 var proxyApi = (http) => ({
   /** Every proxy this key can use, shared ones included. */
@@ -2226,7 +2242,7 @@ var jarCalls = (http) => ({
   /** Every cookie in the jar; `format: 'playwright'` is ready for `context.addCookies()`. */
   cookies: async (id, format = "json") => (await http().request("GET", `${jarPath(id)}&format=${encodeURIComponent(format)}`)).cookies,
   /** Merge cookies into the jar. The persona's browsers pick them up on their next visit to each site. */
-  importCookies: async (id, list2) => http().request("PUT", jarPath(id), { cookies: list2 })
+  importCookies: async (id, list3) => http().request("PUT", jarPath(id), { cookies: list3 })
 });
 var cookieCalls = (http) => ({
   ...jarCalls(http),
@@ -2319,10 +2335,10 @@ function openLink(link) {
   });
   child.unref();
 }
-async function waitForDesktop(list2, link, timeoutMs, persona) {
+async function waitForDesktop(list3, link, timeoutMs, persona) {
   const deadline = Date.now() + timeoutMs;
   while (Date.now() < deadline) {
-    const found = desktopOf(await list2(), persona);
+    const found = desktopOf(await list3(), persona);
     if (found) return found;
     await new Promise((r) => setTimeout(r, READY_POLL_MS2));
   }
@@ -2334,7 +2350,7 @@ async function handleOn(http, id) {
   const started = { id, provider: DESKTOP_PROVIDER, persona: found.persona || "default", cdpUrl: found.cdpUrl };
   return new Browser(http, { ...started, status: "ready", reused: true }, false);
 }
-var desktopApi = (http, list2) => ({
+var desktopApi = (http, list3) => ({
   /**
    * The person's own desktop browser, signed in to their sites. When it is not
    * connected yet this pairs it: it opens a link, the person clicks Connect in
@@ -2343,11 +2359,11 @@ var desktopApi = (http, list2) => ({
    * another persona is switched the same way: the link reconnects it as this one.
    */
   connect: async (options = {}) => {
-    const running = desktopOf(await list2(), options.persona);
+    const running = desktopOf(await list3(), options.persona);
     if (running) return handleOn(http(), running.id);
     const link = await pairingLink(http(), options.persona);
     if (options.open !== false) openLink(link);
-    const found = await waitForDesktop(list2, link, options.timeoutMs ?? DESKTOP_TIMEOUT_MS, options.persona);
+    const found = await waitForDesktop(list3, link, options.timeoutMs ?? DESKTOP_TIMEOUT_MS, options.persona);
     return handleOn(http(), found.id);
   }
 });
@@ -2380,6 +2396,8 @@ var Oya = class {
   control = controlApi(() => this.http);
   /** Playbooks saved with `browser.toPlaybook()`. */
   playbooks = playbookApi(() => this.http);
+  /** This key's model for one-off text: `oya.llm.answer(question, vars)` fills a playbook's free-text field. */
+  llm = llmApi(() => this.http);
   /**
    * Proxy exits for your personas. A persona takes one at first connect (by its
    * geo hint) or by `personas.pinProxy`, and keeps it.
@@ -2841,9 +2859,9 @@ var exportJar = async (oya, rest, flags) => {
 };
 function cookiesIn(file) {
   const parsed = readJsonFile(file);
-  const list2 = Array.isArray(parsed) ? parsed : parsed?.cookies;
-  if (!Array.isArray(list2)) throw usage(`${file} holds no list of cookies.`);
-  return list2;
+  const list3 = Array.isArray(parsed) ? parsed : parsed?.cookies;
+  if (!Array.isArray(list3)) throw usage(`${file} holds no list of cookies.`);
+  return list3;
 }
 var importJar = async (oya, rest, flags) => {
   if (!rest[0] || !rest[1])
@@ -2873,6 +2891,39 @@ async function cmdCookies(args, flags) {
   await SUBCOMMANDS2[sub](client(flags), rest, flags);
 }
 
+// src/commands/playbooks.ts
+import { writeFileSync as writeFileSync6 } from "fs";
+var list2 = async (oya, _rest, flags) => {
+  const playbooks = await oya.playbooks.list();
+  out(flags, playbooks, () => {
+    if (!playbooks.length) return console.log("No playbooks yet: save a run with browser.toPlaybook().");
+    for (const p of playbooks) console.log(`${p.name}  ${p.steps} steps  ${p.variables.join(", ") || "(no inputs)"}`);
+  });
+};
+var exportOne = async (oya, rest, flags) => {
+  if (!rest[0]) throw usage("oya playbooks export needs a name: oya playbooks export <name> [--out <file>].");
+  const doc = await oya.playbooks.export(rest[0]);
+  const file = flagStr(flags, "out");
+  if (!file) return console.log(JSON.stringify(doc, null, JSON_INDENT2));
+  writeFileSync6(file, JSON.stringify(doc, null, JSON_INDENT2) + "\n");
+  out(flags, { ok: true, name: rest[0], file }, () => console.log(`\u2705 ${rest[0]} written to ${file}`));
+};
+var importOne = async (oya, rest, flags) => {
+  if (!rest[0])
+    throw usage("oya playbooks import needs a file: oya playbooks import <file> [--name <name>] [--replace].");
+  const doc = readJsonFile(rest[0]);
+  const name = flagStr(flags, "name") || void 0;
+  const saved = await oya.playbooks.import(doc, { name, overwrite: flags.replace === true });
+  out(flags, saved, () => console.log(`\u2705 imported ${saved.name}: ${saved.steps} steps`));
+};
+var SUBCOMMANDS3 = { list: list2, export: exportOne, import: importOne };
+async function cmdPlaybooks(args, flags) {
+  const [sub = "list", ...rest] = args;
+  if (!Object.hasOwn(SUBCOMMANDS3, sub))
+    throw usage(`Unknown playbooks subcommand "${sub}". Use list, export or import.`);
+  await SUBCOMMANDS3[sub](client(flags), rest, flags);
+}
+
 // src/commands/settings.ts
 function parsePairs(args) {
   const updates = {};
@@ -3034,6 +3085,11 @@ Personas and cookies
   oya cookies copy <from> <to>               One persona's logins into another
   oya cookies clear <persona>                Delete a persona's logins
 
+Playbooks
+  oya playbooks                              List saved playbooks
+  oya playbooks export <name>                One playbook as JSON; [--out <file>]
+  oya playbooks import <file>                Save an export here; [--name <name>] [--replace]
+
 Account
   oya config [key=value ...]                 Show or change this key's settings
   oya usage                                  What this key has spent
@@ -3105,6 +3161,7 @@ var COMMANDS = {
   stop: cmdRm,
   personas: cmdPersonas,
   cookies: cmdCookies,
+  playbooks: cmdPlaybooks,
   open: (_args, flags) => cmdOpen(flags),
   config: cmdConfig,
   usage: (_args, flags) => cmdUsage(flags),

package/package.json

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