@oya-ai/cli 1.0.125 → 1.0.129

package/dist/index.js

@@ -586,7 +586,8 @@ function wouldClone(where) {
 
 // src/install/llm.ts
 var LLM_PRESETS = {
-  anthropic: { base: "https://api.anthropic.com/v1", model: "claude-sonnet-5", label: "Anthropic (Claude)" },
+  // Same defaults as the server's catalog (server/src/modules/config/llm-catalog.ts).
+  anthropic: { base: "https://api.anthropic.com/v1", model: "claude-opus-5", label: "Anthropic (Claude)" },
   openai: { base: "https://api.openai.com/v1", model: "gpt-4o-mini", label: "OpenAI" },
   gemini: {
     base: "https://generativelanguage.googleapis.com/v1beta/openai",
@@ -598,14 +599,16 @@ var LLM_PRESETS = {
     base: "https://aiplatform.googleapis.com/v1/publishers/google",
     model: "gemini-2.5-flash",
     label: "Gemini Enterprise (Vertex AI)"
-  }
+  },
+  openrouter: { base: "https://openrouter.ai/api/v1", model: "anthropic/claude-sonnet-5", label: "OpenRouter" }
 };
 var LLM_OPTIONS = [
   { id: "anthropic", label: "Anthropic (Claude)" },
   { id: "openai", label: "OpenAI" },
   { id: "gemini", label: "Gemini (Google)" },
   { id: "vertex", label: "Gemini Enterprise (Vertex AI)", note: "express-mode API key" },
-  { id: "compatible", label: "An OpenAI-compatible endpoint", note: "OpenRouter, Together, Groq, Azure" },
+  { id: "openrouter", label: "OpenRouter", note: "one key for Claude, GPT, Gemini, Grok, DeepSeek and more" },
+  { id: "compatible", label: "An OpenAI-compatible endpoint", note: "Together, Groq, Azure" },
   { id: "local", label: "A local model", note: "Ollama, vLLM, LM Studio" },
   { id: "skip", label: "Skip", note: "no agent control; add it later with `oya config`" }
 ];
@@ -1423,6 +1426,7 @@ var Status2 = {
   /** A quota or a persona concurrency cap. */
   TOO_MANY_REQUESTS: 429
 };
+var MODELS_SHOWN = 8;
 
 // src/config.ts
 var FILE = join6(process.env.OYA_CONFIG_HOME || join6(homedir(), ".oya"), "config.json");
@@ -1499,6 +1503,9 @@ var Status3 = {
   /** A browser did not come up in time. */
   GATEWAY_TIMEOUT: 504
 };
+var DESKTOP_PROVIDER = "oya-desktop";
+var DESKTOP_TIMEOUT_MS = 3e5;
+var DESKTOP_DOWNLOAD_URL = "https://oyabrowser.com/#download";
 var OyaError = class extends Error {
   /** The HTTP status, or the SDK's own status for errors it raises itself. */
   status;
@@ -1536,6 +1543,18 @@ function savedConfig() {
     return {};
   }
 }
+var PRIVATE_FILE = 384;
+var JSON_INDENT3 = 2;
+function saveKey(apiKey, baseUrl) {
+  const fs = builtin("node:fs");
+  const file2 = configFile();
+  if (!fs || !file2 || savedConfig().apiKey) return false;
+  fs.mkdirSync(file2.slice(0, file2.lastIndexOf("/")), { recursive: true });
+  fs.writeFileSync(file2, JSON.stringify({ ...savedConfig(), apiKey, baseUrl }, null, JSON_INDENT3), {
+    mode: PRIVATE_FILE
+  });
+  return true;
+}
 var OPTIONS_ORIGIN = { apiKeyFrom: "the apiKey option", baseUrlFrom: "the baseUrl option", savedKey: false };
 var Http = class {
   /** Stores where to call, with which key, how long to wait, which fetch to use, and where the key and address came from. */
@@ -2257,6 +2276,81 @@ async function assertNotEnded(checks, id) {
     if (!(e instanceof OyaError) || e.status !== Status3.NOT_FOUND) throw e;
   }
 }
+var NO_KEY = "signup";
+var solves = (crypto, challenge, nonce, zeros) => crypto.createHash("sha256").update(challenge + nonce).digest("hex").startsWith(zeros);
+function solve({ challenge, difficulty }) {
+  const crypto = builtin("node:crypto");
+  if (!crypto) throw new Error("Oya.signup() needs Node 22.3 or newer.");
+  const zeros = "0".repeat(difficulty);
+  let nonce = 0;
+  while (!solves(crypto, challenge, nonce, zeros)) nonce++;
+  return String(nonce);
+}
+async function signup(options) {
+  const http = createHttp({ baseUrl: options.baseUrl, fetch: options.fetch, apiKey: NO_KEY });
+  const puzzle = await http.request("GET", "/api/auth/agent/challenge");
+  const body = { email: options.email, challenge: puzzle.challenge, nonce: solve(puzzle) };
+  const answer = await http.request("POST", "/api/auth/agent/signup", body);
+  const saved = options.save !== false && saveKey(answer.api_key, http.baseUrl);
+  return { apiKey: answer.api_key, claimUrl: answer.claim_url, cloudBrowsers: answer.cloud_browsers, saved };
+}
+var desktopOf = (all, persona) => all.find(
+  (b) => b.provider === DESKTOP_PROVIDER && b.health !== "dead" && (!persona || b.persona === persona || b.personaName === persona)
+);
+async function pairingLink(http, persona) {
+  const { code } = await http.request("POST", "/api/pairing", {
+    persona
+  });
+  const server = `${http.baseUrl.replace(/^http/, "ws")}/ws`;
+  return `oya://connect?code=${encodeURIComponent(code)}&server=${encodeURIComponent(server)}`;
+}
+var OPENERS = {
+  darwin: ["open"],
+  linux: ["xdg-open"],
+  win32: ["rundll32", "url.dll,FileProtocolHandler"]
+};
+function openLink(link) {
+  const platform = globalThis.process?.platform ?? "";
+  const cp = builtin("node:child_process");
+  if (!cp || !Object.hasOwn(OPENERS, platform)) return;
+  const [cmd, ...args] = OPENERS[platform];
+  const child = cp.spawn(cmd, [...args, link], { detached: true, stdio: "ignore" });
+  child.on("error", () => {
+  });
+  child.unref();
+}
+async function waitForDesktop(list2, link, timeoutMs, persona) {
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    const found = desktopOf(await list2(), persona);
+    if (found) return found;
+    await new Promise((r) => setTimeout(r, READY_POLL_MS2));
+  }
+  const how = `Install it from ${DESKTOP_DOWNLOAD_URL} if needed, then open ${link} and click Connect.`;
+  throw new OyaError(`The Oya desktop app did not connect. ${how}`, Status3.GATEWAY_TIMEOUT, { link });
+}
+async function handleOn(http, id) {
+  const found = await http.request("GET", `/api/browsers/${segment(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) => ({
+  /**
+   * 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
+   * the app (with "Import my logins" ticked, their Chrome logins come along),
+   * and this waits until it is up. With `persona`, a running app signed in as
+   * another persona is switched the same way: the link reconnects it as this one.
+   */
+  connect: async (options = {}) => {
+    const running = desktopOf(await list2(), 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);
+    return handleOn(http(), found.id);
+  }
+});
 var MAX_FILE_BYTES = MAX_FILE_MB * BYTES_PER_MB;
 var Oya = class {
   /** The one HTTP path every call goes through. */
@@ -2270,6 +2364,18 @@ var Oya = class {
     () => this.http,
     (id, timeoutMs) => this.waitUntilConnected(id, timeoutMs)
   );
+  /** The person's own desktop browser, with their logins: `await oya.desktop.connect()` pairs it when it is not up yet. */
+  desktop = desktopApi(
+    () => this.http,
+    () => this.browser.list()
+  );
+  /**
+   * An agent's own key, with no person or dashboard: `await Oya.signup({ email })`.
+   * Saved to ~/.oya/config.json, so a later `new Oya()` finds it.
+   */
+  static signup(options) {
+    return signup(options);
+  }
   /** Durable operational controls, including disconnected and cleanup-pending sessions. */
   control = controlApi(() => this.http);
   /** Playbooks saved with `browser.toPlaybook()`. */
@@ -2403,30 +2509,39 @@ function signedIn(baseUrl) {
 }
 
 // src/commands/init.ts
-var PRESETS = {
-  anthropic: { name: "Anthropic", model: "claude-sonnet-5" },
-  openai: { name: "OpenAI", model: "gpt-4o-mini" },
-  gemini: { name: "Gemini", model: "gemini-3.8-flash" },
-  vertex: { name: "Gemini Enterprise", model: "gemini-2.5-flash" }
-};
+var LEGACY_CATALOG = [
+  { id: "anthropic", label: "Claude (Anthropic)", model: "claude-opus-5" },
+  { id: "openai", label: "OpenAI", model: "gpt-4o-mini" },
+  { id: "gemini", label: "Gemini (Google)", model: "gemini-3.8-flash" },
+  { id: "vertex", label: "Gemini Enterprise (Vertex AI)", model: "gemini-2.5-flash" }
+];
+var catalogOf = (current) => current.llm_catalog?.length ? current.llm_catalog : LEGACY_CATALOG;
 var modelOptions = (current) => [
-  { id: "anthropic", label: "Claude (Anthropic)" },
-  { id: "openai", label: "OpenAI" },
-  { id: "gemini", label: "Gemini (Google)" },
-  { id: "vertex", label: "Gemini Enterprise (Vertex AI)" },
+  ...catalogOf(current).map((p) => ({ id: p.id, label: p.label })),
   { id: "skip", label: "Skip", note: current.has_openai_key ? "keep what is configured" : "no agent control" }
 ];
+function llmUpdates(current, provider, key, model) {
+  const updates = { llm_provider: provider, chat_model: model || null };
+  if (key) updates.openai_api_key = key;
+  if (provider !== current.llm_provider) updates.openai_base_url = null;
+  return updates;
+}
+function showModels(choice) {
+  const ids = (choice.models || []).map((m) => m.id);
+  const more = ids.length > MODELS_SHOWN ? ", \u2026" : "";
+  if (ids.length) console.log(`   Models: ${ids.slice(0, MODELS_SHOWN).join(", ")}${more}`);
+}
 async function askModel(current, updates) {
   console.log("\n\u2500\u2500 1. Your model \u2500\u2500");
   const llm = await choose("Which LLM should agents use?", modelOptions(current));
-  if (llm !== "skip") await askModelDetails(llm, updates);
-}
-async function askModelDetails(llm, updates) {
-  updates.llm_provider = llm;
-  const key = await askSecret(`${PRESETS[llm].name} API key:`);
-  if (key) updates.openai_api_key = key;
-  const model = await ask("Default model:", PRESETS[llm].model);
-  if (model) updates.chat_model = model;
+  const choice = catalogOf(current).find((p) => p.id === llm);
+  if (choice) Object.assign(updates, await askModelDetails(current, choice));
+}
+async function askModelDetails(current, choice) {
+  const key = await askSecret(`${choice.label} API key:`);
+  showModels(choice);
+  const model = await ask("Default model:", choice.model);
+  return llmUpdates(current, choice.id, key, model);
 }
 var needsNote = (p) => p.needs.some((f) => f.endsWith("_url")) ? "needs its ws:// address" : "needs an API key";
 function fieldLabel(p, field) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oya-ai/cli",
-  "version": "1.0.125",
+  "version": "1.0.129",
   "description": "Command line for the Oya browser control plane.",
   "license": "MIT",
   "homepage": "https://oyabrowser.com",
@@ -19,7 +19,18 @@
     "browserbase",
     "steel",
     "browser-use",
-    "mcp"
+    "mcp",
+    "ai-agent",
+    "agent-browser",
+    "browser-agent",
+    "agent-skills",
+    "claude-code",
+    "codex",
+    "openclaw",
+    "hermes-agent",
+    "computer-use",
+    "mcp-server",
+    "llms-txt"
   ],
   "type": "module",
   "bin": {
@@ -39,7 +50,7 @@
     "access": "public"
   },
   "devDependencies": {
-    "@oya-ai/browser": "1.0.125",
+    "@oya-ai/browser": "1.0.129",
     "@types/node": "^20.19.43",
     "tsup": "^8.0.0",
     "typescript": "^5.4.0"