portal-agent-cli 3.0.3 → 3.0.5

package/LICENSE

@@ -4,18 +4,3 @@ Copyright (c) 2026
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in
-all copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
-THE SOFTWARE.

package/README.md

@@ -1,28 +1 @@
 # portal-agent
-
-Drive web AI products from the terminal with local tools.
-
-Supports DeepSeek, ChatGPT, Gemini, and Grok.
-
-## Install
-
-npm install -g portal-agent-cli
-
-## Run
-
-portal-agent --workspace F:/projects/my-app
-
-## Commands
-
-/help, /cd, /pwd, /provider, /providers, /deepthink,
-/sessions, /queue, /status, /clear, /quit
-
-## Tools
-
-read_file, write_file, edit_file, append_file, undo_file,
-list_files, find_files, grep_search, delete_file, move_file,
-shell, git_status, git_diff, git_log
-
-## License
-
-MIT

package/lib/args.mjs

@@ -4,15 +4,8 @@ import { resolve } from "node:path";
 export function parseArgs() {
   const a = process.argv.slice(2);
   const o = {
-    ws: null,
-    provider: null,
-    maxSteps: null,
-    timeout: null,
-    loginTimeout: null,
-    exec: null,
-    verbose: false,
-    yolo: false,
-    session: null,
+    ws: null, provider: null, maxSteps: null, timeout: null,
+    loginTimeout: null, exec: null, verbose: false, yolo: false,
     resume: null
   };
 
@@ -24,13 +17,12 @@ export function parseArgs() {
     else if (t === "--timeout") o.timeout = Number(a[++i]);
     else if (t === "--login-timeout") o.loginTimeout = Number(a[++i]);
     else if (t === "--max-steps") o.maxSteps = Number(a[++i]);
-    else if (t === "--session") o.session = a[++i];
     else if (t === "--resume") o.resume = a[++i];
     else if (t === "--verbose" || t === "-V") o.verbose = true;
     else if (t === "--yolo") o.yolo = true;
     else if (t === "exec") { o.exec = a.slice(i + 1).join(" "); break; }
     else if (t === "--help" || t === "-h") { help(); process.exit(0); }
-    else if (t === "--version" || t === "-v") { console.log("3.0.2"); process.exit(0); }
+    else if (t === "--version" || t === "-v") { console.log("3.0.4"); process.exit(0); }
     i++;
   }
 
@@ -51,7 +43,6 @@ function help() {
   console.log("  portal-agent [options]");
   console.log("  portal-agent [options] exec <task>");
   console.log("");
-  console.log("Options:");
   console.log("  -w, --workspace <dir>     folder the agent works in");
   console.log("  -p, --provider <name>     deepseek | chatgpt | gemini | grok");
   console.log("  --timeout <ms>            response timeout (default 180000)");

package/lib/browser.mjs

@@ -18,45 +18,30 @@ const CANDIDATES = [
 ];
 
 export function findBrowser() {
-  for (const p of CANDIDATES) {
-    if (p && existsSync(p)) return p;
-  }
+  for (const p of CANDIDATES) if (p && existsSync(p)) return p;
   return null;
 }
 
 export async function launch() {
   const exe = findBrowser();
-  if (!exe) {
-    throw new Error(
-      "No Chrome, Chromium, Edge, or Brave found. " +
-      "Set PORTAL_BROWSER_PATH to your browser executable."
-    );
-  }
+  if (!exe) throw new Error("No Chrome found. Set PORTAL_BROWSER_PATH.");
 
   const profileDir = join(homedir(), ".portal-agent", "browser");
   await mkdir(profileDir, { recursive: true });
 
   try {
     const ctx = await chromium.launchPersistentContext(profileDir, {
-      executablePath: exe,
-      headless: false,
+      executablePath: exe, headless: false,
       viewport: { width: 1280, height: 900 }
     });
-
     ctx.on("page", function (page) {
-      page.on("dialog", function (d) {
-        d.dismiss().catch(function () {});
-      });
+      page.on("dialog", function (d) { d.dismiss().catch(function () {}); });
     });
-
     return ctx;
   } catch (e) {
     const m = e.message || String(e);
     if (m.indexOf("ProcessSingleton") >= 0 || m.indexOf("already running") >= 0) {
-      throw new Error(
-        "Another Chrome window is using the Portal profile. " +
-        "Close every Chrome window and try again."
-      );
+      throw new Error("Another Chrome window is using the Portal profile.");
     }
     throw new Error("Failed to launch Chromium: " + m);
   }

package/lib/config.mjs

@@ -8,7 +8,6 @@ const DEFAULTS = {
   timeout: 180000,
   loginTimeout: 600000,
   yolo: false,
-  verbose: false,
   ignored: [
     "node_modules", ".git", ".hg", ".svn", "dist", "build", "out",
     ".next", ".nuxt", ".turbo", ".cache", "target", "__pycache__",
@@ -23,23 +22,17 @@ function configPath() {
 function readGlobal() {
   const p = configPath();
   if (!existsSync(p)) return {};
-  try {
-    return JSON.parse(readFileSync(p, "utf8"));
-  } catch (e) {
-    return {};
-  }
+  try { return JSON.parse(readFileSync(p, "utf8")); } catch (e) { return {}; }
 }
 
 export async function loadConfig(args) {
   const g = readGlobal();
-
   const config = {
     provider: g.provider || DEFAULTS.provider,
     maxSteps: g.maxSteps || DEFAULTS.maxSteps,
     timeout: g.timeout || DEFAULTS.timeout,
     loginTimeout: g.loginTimeout || DEFAULTS.loginTimeout,
     yolo: g.yolo || false,
-    verbose: g.verbose || false,
     ignored: g.ignored || DEFAULTS.ignored,
     ws: args.ws || process.env.PORTAL_WORKSPACE || process.cwd(),
     exec: args.exec,
@@ -52,20 +45,13 @@ export async function loadConfig(args) {
   if (args.timeout) config.timeout = args.timeout;
   if (args.loginTimeout) config.loginTimeout = args.loginTimeout;
   if (args.yolo || process.env.PORTAL_YOLO === "true") config.yolo = true;
-  if (args.verbose) config.verbose = true;
 
   config.ws = resolve(config.ws);
-  if (!existsSync(config.ws)) {
-    throw new Error("workspace does not exist: " + config.ws);
-  }
+  if (!existsSync(config.ws)) throw new Error("workspace does not exist: " + config.ws);
 
   const localPath = join(config.ws, "portal.config.json");
   if (existsSync(localPath)) {
-    try {
-      const local = JSON.parse(readFileSync(localPath, "utf8"));
-      Object.assign(config, local);
-    } catch (e) {}
+    try { Object.assign(config, JSON.parse(readFileSync(localPath, "utf8"))); } catch (e) {}
   }
-
   return config;
 }

package/lib/deepthink.mjs

@@ -1,45 +1,24 @@
 export async function enableDeepThink(page) {
   if (process.env.PORTAL_DEEPTHINK === "off") return false;
-
   const btns = page.locator("button, [role=button], div[role=button]");
   let total = 0;
-  try {
-    total = await btns.count();
-  } catch (e) {
-    return false;
-  }
+  try { total = await btns.count(); } catch (e) { return false; }
   if (total === 0 || total > 400) return false;
 
   for (let i = 0; i < total; i++) {
     const b = btns.nth(i);
     let text = "";
-    try {
-      text = ((await b.textContent()) || "").trim();
-    } catch (e) {
-      continue;
-    }
+    try { text = ((await b.textContent()) || "").trim(); } catch (e) { continue; }
     if (!text) continue;
-
-    const hit = text === "DeepThink" ||
-      text === "Deep Think" ||
-      text.indexOf("DeepThink") >= 0;
-
-    if (!hit) continue;
+    if (text.indexOf("DeepThink") < 0 && text.indexOf("Deep Think") < 0) continue;
 
     let pressed = "";
     let cls = "";
     try { pressed = (await b.getAttribute("aria-pressed")) || ""; } catch (e) {}
     try { cls = (await b.getAttribute("class")) || ""; } catch (e) {}
-
     if (pressed === "true" || /active|selected|on\b/i.test(cls)) return true;
 
-    try {
-      await b.click({ timeout: 2000 });
-      await new Promise(function (r) { setTimeout(r, 400); });
-      return true;
-    } catch (e) {
-      return false;
-    }
+    try { await b.click({ timeout: 2000 }); await new Promise(function (r) { setTimeout(r, 400); }); return true; } catch (e) { return false; }
   }
   return false;
 }

package/lib/exec.mjs

@@ -1,47 +1,2 @@
 import { launch } from "./browser.mjs";
-import { getProvider } from "./providers.mjs";
-import { waitForComposer } from "./wait.mjs";
-import { enableDeepThink } from "./deepthink.mjs";
-import { runTurn } from "./turn.mjs";
-import { setWorkspace } from "./tools/path.mjs";
-import { setIgnore } from "./tools/walk.mjs";
-import { loadInstructions } from "./instructions.mjs";
-import { info, error } from "./log.mjs";
-
-export async function runExec(config) {
-  const provider = getProvider(config.provider);
-  setWorkspace(config.ws);
-  setIgnore(config.ignored);
-
-  config.instructionsText = await loadInstructions(config.ws);
-
-  const ctx = await launch();
-  const page = await ctx.newPage();
-  page.setDefaultTimeout(30000);
-
-  info("opening " + provider.label + "...");
-  await page.goto(provider.url);
-  await waitForComposer(page, provider, config.loginTimeout);
-
-  if (provider.deepthink) await enableDeepThink(page);
-
-  const session = {
-    id: "exec-" + Date.now(),
-    ws: config.ws,
-    provider: config.provider,
-    turns: [],
-    approvedAlways: [],
-    startedAt: Date.now(),
-    updatedAt: Date.now()
-  };
-
-  try {
-    await runTurn(page, provider, config.exec, config, session);
-    process.exitCode = 0;
-  } catch (e) {
-    error(e.message || String(e));
-    process.exitCode = 1;
-  } finally {
-    await ctx.close().catch(function () {});
-  }
-}
+import { get

package/lib/instructions.mjs

@@ -2,7 +2,6 @@ import { readFile, stat } from "node:fs/promises";
 import { join } from "node:path";
 
 const FILENAMES = ["PORTAL.md", "AGENTS.md", ".portal.md", "CLAUDE.md"];
-
 let cache = null;
 let cacheKey = "";
 
@@ -10,35 +9,6 @@ export async function loadInstructions(ws) {
   for (const name of FILENAMES) {
     const path = join(ws, name);
     let info;
-    try {
-      info = await stat(path);
-    } catch (e) {
-      continue;
-    }
-
+    try { info = await stat(path); } catch (e) { continue; }
     const key = path + ":" + info.mtimeMs;
-    if (cache && cacheKey === key) return cache;
-
-    try {
-      const content = await readFile(path, "utf8");
-      const trimmed = content.trim();
-      if (!trimmed) return null;
-      cache = [
-        "# Project instructions",
-        "",
-        "The user placed these instructions in " + name + ". Follow them.",
-        "",
-        trimmed
-      ].join("\n");
-      cacheKey = key;
-      return cache;
-    } catch (e) {
-      continue;
-    }
-  }
-  return null;
-}
-
-export function activeInstructionFile() {
-  return cacheKey ? cacheKey.split(":")[0] : null;
-}
+    if (

package/lib/log.mjs

@@ -1,24 +1,10 @@
 import { theme } from "./theme.mjs";
 
-export function info(s) {
-  process.stdout.write(theme.dim(s) + "\n");
-}
-
-export function warn(s) {
-  process.stdout.write(theme.warn("! " + s) + "\n");
-}
-
-export function error(s) {
-  process.stderr.write(theme.error("x " + s) + "\n");
-}
-
-export function ok(s) {
-  process.stdout.write(theme.ok("+ " + s) + "\n");
-}
-
-export function status(s) {
-  process.stdout.write(theme.dim("  " + s) + "\n");
-}
+export function info(s) { process.stdout.write(theme.dim(s) + "\n"); }
+export function warn(s) { process.stdout.write(theme.warn("! " + s) + "\n"); }
+export function error(s) { process.stderr.write(theme.error("x " + s) + "\n"); }
+export function ok(s) { process.stdout.write(theme.ok("+ " + s) + "\n"); }
+export function status(s) { process.stdout.write(theme.dim("  " + s) + "\n"); }
 
 export function tool(name, args) {
   const preview = args ? JSON.stringify(args).slice(0, 140) : "";
@@ -30,8 +16,3 @@ export function toolResult(text, isError) {
   const prefix = isError ? theme.red("  x ") : theme.dim("    ");
   process.stdout.write(prefix + body + "\n");
 }
-
-export function reply(text) {
-  if (!text) return;
-  process.stdout.write("\n" + theme.cyan("* ") + text + "\n");
-}

package/lib/parse.mjs

@@ -1,7 +1,5 @@
 function findJsonEnd(s, i) {
-  let depth = 0;
-  let inStr = false;
-  let esc = false;
+  let depth = 0, inStr = false, esc = false;
   for (let j = i; j < s.length; j++) {
     const c = s[j];
     if (esc) { esc = false; continue; }
@@ -9,10 +7,7 @@ function findJsonEnd(s, i) {
     if (c === String.fromCharCode(34)) { inStr = !inStr; continue; }
     if (inStr) continue;
     if (c === "{") depth++;
-    else if (c === "}") {
-      depth--;
-      if (!depth) return j + 1;
-    }
+    else if (c === "}") { depth--; if (!depth) return j + 1; }
   }
   return -1;
 }
@@ -37,11 +32,8 @@ export function parseCalls(text) {
     const raw = text.slice(b, e);
     if (seen.has(raw)) continue;
     seen.add(raw);
-    try {
-      out.push(JSON.parse(raw));
-    } catch (x) {
-      try { out.push(JSON.parse(repair(raw))); } catch (y) {}
-    }
+    try { out.push(JSON.parse(raw)); }
+    catch (x) { try { out.push(JSON.parse(repair(raw))); } catch (y) {} }
   }
   return out;
 }

package/lib/paste.mjs

@@ -3,45 +3,26 @@ import { sleep } from "./wait.mjs";
 export async function dismissPaste(page) {
   const btns = page.locator("button, [role=button]");
   let total = 0;
-  try {
-    total = await btns.count();
-  } catch (e) {
-    return false;
-  }
+  try { total = await btns.count(); } catch (e) { return false; }
   if (total === 0 || total > 300) return false;
 
   for (let i = 0; i < total; i++) {
     const b = btns.nth(i);
     let text = "";
-    try {
-      text = ((await b.textContent()) || "").trim();
-    } catch (e) {
-      continue;
-    }
+    try { text = ((await b.textContent()) || "").trim(); } catch (e) { continue; }
     if (text !== "Cancel") continue;
 
     for (let j = 0; j < total; j++) {
       if (j === i) continue;
       const sib = btns.nth(j);
       let st = "";
-      try {
-        st = ((await sib.textContent()) || "").trim();
-      } catch (e) {
-        continue;
-      }
+      try { st = ((await sib.textContent()) || "").trim(); } catch (e) { continue; }
       if (st === "Send") {
-        try {
-          await sib.click({ timeout: 1500 });
-          await sleep(200);
-          return true;
-        } catch (e) {}
+        try { await sib.click({ timeout: 1500 }); await sleep(200); return true; } catch (e) {}
       }
     }
 
-    try {
-      await page.keyboard.press("Enter");
-      await sleep(150);
-    } catch (e) {}
+    try { await page.keyboard.press("Enter"); await sleep(150); } catch (e) {}
     return true;
   }
   return false;
@@ -51,11 +32,7 @@ export async function composerEmpty(input, ms) {
   const end = Date.now() + ms;
   while (Date.now() < end) {
     let v = "";
-    try {
-      v = await input.inputValue();
-    } catch (e) {
-      return true;
-    }
+    try { v = await input.inputValue(); } catch (e) { return true; }
     if (!v || v.length === 0) return true;
     await sleep(150);
   }

package/lib/providers.mjs

@@ -1,52 +1,41 @@
 export const PROVIDERS = {
   deepseek: {
-    id: "deepseek",
-    label: "DeepSeek",
+    id: "deepseek", label: "DeepSeek",
     url: "https://chat.deepseek.com/",
     input: ["textarea#chat-input", "textarea", "[contenteditable=true]"],
     submit: ["button[aria-label=Send]", "button[data-testid=send-button]"],
     response: ["div.ds-markdown", "div[class*=message]"],
-    paste: true,
-    deepthink: true
+    paste: true, deepthink: true
   },
   chatgpt: {
-    id: "chatgpt",
-    label: "ChatGPT",
+    id: "chatgpt", label: "ChatGPT",
     url: "https://chatgpt.com/",
-    input: ["#prompt-textarea", "div[contenteditable=true][id=prompt-textarea]"],
-    submit: ["button[data-testid=send-button]", "button[aria-label*=Send]"],
+    input: ["#prompt-textarea"],
+    submit: ["button[data-testid=send-button]"],
     response: ["[data-message-author-role=assistant]"],
-    paste: false,
-    deepthink: false
+    paste: false, deepthink: false
   },
   gemini: {
-    id: "gemini",
-    label: "Gemini",
+    id: "gemini", label: "Gemini",
     url: "https://gemini.google.com/app",
     input: ["div[contenteditable=true][role=textbox]"],
     submit: ["button[aria-label*=Send]"],
     response: ["message-content"],
-    paste: false,
-    deepthink: false
+    paste: false, deepthink: false
   },
   grok: {
-    id: "grok",
-    label: "Grok",
+    id: "grok", label: "Grok",
     url: "https://grok.com/",
     input: ["textarea", "div[contenteditable=true]"],
     submit: ["button[type=submit]"],
     response: ["div[class*=message]"],
-    paste: false,
-    deepthink: false
+    paste: false, deepthink: false
   }
 };
 
 export function getProvider(id) {
   const p = PROVIDERS[id];
-  if (!p) {
-    const names = Object.keys(PROVIDERS).join(", ");
-    throw new Error("unknown provider: " + id + " | available: " + names);
-  }
+  if (!p) throw new Error("unknown provider: " + id);
   return p;
 }