@oya-ai/cli 1.0.107 → 1.0.110

package/README.md

@@ -102,6 +102,24 @@ oya personas edit <id> --max 4 --geo US
 oya personas rm <id>
 ```
 
+### Moving logins (`oya cookies`)
+
+A persona's cookie jar is its logins. Sign in once, then carry the session to wherever it is needed:
+
+```bash
+# Save a persona's logins to a file (owner-readable only: it holds live sessions)
+oya cookies export <persona> --out logins.json
+
+# The same, shaped for Playwright's context.addCookies()
+oya cookies export <persona> --format playwright --out pw-cookies.json
+
+# Bring logins in from a file: an export, or any JSON list of cookies
+oya cookies import <persona> logins.json
+
+# Give one persona another persona's logins (each keeps its own device)
+oya cookies copy <from-persona> <to-persona>
+```
+
 ### Human-in-the-Loop Takeover
 
 When automation encounters hardware 2FA, phone biometric approvals, or complex verification:

package/dist/index.js

@@ -1270,6 +1270,7 @@ var ARGV_SKIP = 2;
 var JSON_INDENT2 = 2;
 var DEFAULT_BASE_URL = "https://oyabrowser.com";
 var CONFIG_FILE_MODE = 384;
+var PRIVATE_FILE_MODE = 384;
 var LsColumns = {
   /** Provider name. */
   PROVIDER: 14,
@@ -2009,11 +2010,28 @@ var loginCalls = (http) => ({
     await http().request("DELETE", `/api/personas/${id}/credentials?domain=${encodeURIComponent(domain)}`);
   }
 });
+var jarPath = (id) => `/api/pool/cookies?persona=${encodeURIComponent(id)}`;
+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=${format}`)).cookies,
+  /** Merge cookies into the jar. The persona's browsers pick them up on their next visit to each site. */
+  importCookies: (id, list2) => http().request("PUT", jarPath(id), { cookies: list2 })
+});
+var cookieCalls = (http) => ({
+  ...jarCalls(http),
+  /** Copy every login of persona `from` into persona `to`, which keeps its own device. */
+  copyCookies: async (from, to) => jarCalls(http).importCookies(to, await jarCalls(http).cookies(from)),
+  /** Forget every cookie in the jar: signs the persona out everywhere. */
+  clearCookies: async (id) => {
+    await http().request("DELETE", jarPath(id));
+  }
+});
 var personaApi = (http) => ({
   ...identityCalls(http),
   ...deviceCalls(http),
   ...mfaCalls(http),
-  ...loginCalls(http)
+  ...loginCalls(http),
+  ...cookieCalls(http)
 });
 var configApi = (http) => ({
   /** This key's settings. Secrets read back masked. */
@@ -2389,6 +2407,52 @@ async function cmdPersonas(args2, flags2) {
   await run2(oya, rest, flags2);
 }
 
+// src/commands/cookies.ts
+import { readFileSync as readFileSync4, writeFileSync as writeFileSync5 } from "fs";
+var USAGE = `Usage: oya cookies export <persona> [--format json|playwright] [--out <file>]
+       oya cookies import <persona> <file.json>
+       oya cookies copy <from-persona> <to-persona>
+       oya cookies clear <persona>`;
+var exportJar = async (oya, rest, flags2) => {
+  if (!rest[0]) throw new Error("Usage: oya cookies export <persona> [--format json|playwright] [--out <file>]");
+  const cookies = await oya.personas.cookies(rest[0], flagStr(flags2, "format") || "json");
+  const file = flagStr(flags2, "out");
+  if (!file) return console.log(JSON.stringify(cookies, null, JSON_INDENT2));
+  writeFileSync5(file, JSON.stringify(cookies, null, JSON_INDENT2) + "\n", { mode: PRIVATE_FILE_MODE });
+  console.log(`\u2705 ${cookies.length} cookie${cookies.length === 1 ? "" : "s"} written to ${file}`);
+};
+function cookiesIn(file) {
+  const parsed = JSON.parse(readFileSync4(file, "utf8"));
+  const list2 = Array.isArray(parsed) ? parsed : parsed?.cookies;
+  if (!Array.isArray(list2)) throw new Error(`${file} holds no list of cookies`);
+  return list2;
+}
+var importJar = async (oya, rest, flags2) => {
+  if (!rest[0] || !rest[1]) throw new Error("Usage: oya cookies import <persona> <file.json>");
+  const done = await oya.personas.importCookies(rest[0], cookiesIn(rest[1]));
+  out(
+    flags2,
+    done,
+    () => console.log(`\u2705 ${done.imported} imported, ${done.skipped} skipped, ${done.total} in the jar`)
+  );
+};
+var copy = async (oya, rest, flags2) => {
+  if (!rest[0] || !rest[1]) throw new Error("Usage: oya cookies copy <from-persona> <to-persona>");
+  const done = await oya.personas.copyCookies(rest[0], rest[1]);
+  out(flags2, done, () => console.log(`\u2705 ${done.imported} copied to ${rest[1]}, ${done.total} in its jar`));
+};
+var clear = async (oya, rest) => {
+  if (!rest[0]) throw new Error("Usage: oya cookies clear <persona>");
+  await oya.personas.clearCookies(rest[0]);
+  console.log(`\u2705 cleared ${rest[0]}`);
+};
+var SUBCOMMANDS2 = { export: exportJar, import: importJar, copy, clear };
+async function cmdCookies(args2, flags2) {
+  const [sub, ...rest] = args2;
+  if (sub === void 0 || !Object.hasOwn(SUBCOMMANDS2, sub)) throw new Error(USAGE);
+  await SUBCOMMANDS2[sub](client(flags2), rest, flags2);
+}
+
 // src/commands/settings.ts
 function parsePairs(args2) {
   const updates = {};
@@ -2511,6 +2575,9 @@ var HELP = `oya, thousands of browsers, one API
   oya personas new [name]         --platform Win32|MacIntel|Linux --tz <zone> --locale <l> --max <n>
   oya personas edit <id>          --name <n> --max <n> --geo <cc>
   oya personas clone|rm <id>      A new device of the same kind \xB7 delete
+  oya cookies export <persona>    Logins to stdout or --out <file>; --format playwright for addCookies()
+  oya cookies import <persona> <file>   Logins from a JSON file
+  oya cookies copy <from> <to>    One persona's logins into another
   oya status [--id <id>]          Health, counters and what it has been doing
   oya open [--id <id>]            Open the live view in your browser
   oya config [key=value ...]      Show or change this key's settings
@@ -2554,6 +2621,7 @@ var COMMANDS2 = {
   rm: cmdRm,
   stop: cmdRm,
   personas: cmdPersonas,
+  cookies: cmdCookies,
   open: (_args, flags2) => cmdOpen(flags2),
   config: cmdConfig,
   usage: (_args, flags2) => cmdUsage(flags2),

package/package.json

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