portal-agent-cli 3.0.1 → 3.0.2

package/LICENSE

@@ -2,4 +2,20 @@ MIT License
 
 Copyright (c) 2026
 
-Permission is hereby granted, free of charge, to any
+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,63 +1,28 @@
 # portal-agent
 
-Drive web AI products from the terminal with local tools. Uses a real
-Chromium browser against the provider's own website. No
-```
+Drive web AI products from the terminal with local tools.
 
-npm install -g portal-agent-cli
+Supports DeepSeek, ChatGPT, Gemini, and Grok.
 
-```
+## Install
 
-## Run
+npm install -g portal-agent-cli
 
-```
+## Run
 
 portal-agent --workspace F:/projects/my-app
 
-```
-
-Or without installing:
-
-```
-
-npx portal-agent-cli --workspace F:/projects/my-app
-
-```
+## Commands
 
-On first run, Chrome
-```
-
-portal-agent --workspace F:/proj exec "list the files here"
-
-```
+/help, /cd, /pwd, /provider, /providers, /deepthink,
+/sessions, /queue, /status, /clear, /quit
 
 ## Tools
 
-| Tool | Description |
-|------|-------------|
-| `read_file(path, start_line?, end_line?)` | read with line numbers |
-| `write_file(path, content)` | write a whole file (backs up existing) |
-| `edit_file(path, old_string, new_string, replace_all?)`
-```
-
-- approval required
-tool: shell
-{
-"command": "npm test"
-}
-allow? yes / always / no:
-
-```
-
-Answering `a` approves that tool for the rest of the session.
-
-## Safety
-
-- 
-```
-
-portal-tool: {"tool":"read_file","args":{"path":"notes.txt"}}
+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
 
-Portal parses that line, runs the tool locally, and sends
+MIT

package/lib/args.mjs

@@ -1,13 +1,11 @@
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
-import { theme } from "./theme.mjs";
 
 export function parseArgs() {
   const a = process.argv.slice(2);
   const o = {
     ws: null,
     provider: null,
-    model: null,
     maxSteps: null,
     timeout: null,
     loginTimeout: null,
@@ -15,8 +13,7 @@ export function parseArgs() {
     verbose: false,
     yolo: false,
     session: null,
-    resume: null,
-    theme: "auto"
+    resume: null
   };
 
   let i = 0;
@@ -24,18 +21,16 @@ export function parseArgs() {
     const t = a[i];
     if (t === "-w" || t === "--workspace") o.ws = a[++i];
     else if (t === "-p" || t === "--provider") o.provider = a[++i];
-    else if (t === "--model") o.model = a[++i];
     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 === "--theme") o.theme = 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.1"); process.exit(0); }
+    else if (t === "--version" || t === "-v") { console.log("3.0.2"); process.exit(0); }
     i++;
   }
 
@@ -46,46 +41,25 @@ export function parseArgs() {
       process.exit(2);
     }
   }
-
   return o;
 }
 
 function help() {
-  const t = theme;
   console.log("");
-  console.log(t.bold("portal-agent") + t.dim(" -- drive web AI from the terminal"));
+  console.log("portal-agent -- drive web AI from the terminal");
   console.log("");
-  console.log(t.bold("USAGE"));
   console.log("  portal-agent [options]");
   console.log("  portal-agent [options] exec <task>");
   console.log("");
-  console.log(t.bold("OPTIONS"));
+  console.log("Options:");
   console.log("  -w, --workspace <dir>     folder the agent works in");
   console.log("  -p, --provider <name>     deepseek | chatgpt | gemini | grok");
-  console.log("  --model <name>            provider-specific model hint");
   console.log("  --timeout <ms>            response timeout (default 180000)");
   console.log("  --login-timeout <ms>      login wait (default 600000)");
-  console.log("  --max-steps <n>           max tool steps per turn (default 12)");
-  console.log("  --session <name>          start or reuse a named session");
+  console.log("  --max-steps <n>           max steps per turn (default 12)");
   console.log("  --resume <name>           resume a saved session");
-  console.log("  --theme <name>            auto | dark | light");
-  console.log("  -V, --verbose             print config on startup");
   console.log("  --yolo                    auto-approve every tool call");
   console.log("  -h, --help                show this help");
   console.log("  -v, --version             show version");
   console.log("");
-  console.log(t.bold("ENVIRONMENT"));
-  console.log("  PORTAL_WORKSPACE          same as --workspace");
-  console.log("  PORTAL_PROVIDER           default provider");
-  console.log("  PORTAL_BROWSER_PATH       explicit browser executable");
-  console.log("  PORTAL_DEEPTHINK          set to off to skip DeepThink toggle");
-  console.log("  PORTAL_DEBUG              print stack traces on error");
-  console.log("  PORTAL_YOLO               same as --yolo");
-  console.log("  NO_COLOR                  disable color output");
-  console.log("");
-  console.log(t.bold("EXAMPLES"));
-  console.log("  portal-agent --workspace F:/projects/app");
-  console.log("  portal-agent -w . -p chatgpt");
-  console.log("  portal-agent exec \"list the files here\"");
-  console.log("");
 }

package/lib/browser.mjs

@@ -11,16 +11,10 @@ const CANDIDATES = [
   "C:/Program Files (x86)/Google/Chrome/Application/chrome.exe",
   "C:/Program Files (x86)/Microsoft/Edge/Application/msedge.exe",
   "C:/Program Files/BraveSoftware/Brave-Browser/Application/brave.exe",
-  "C:/Program Files (x86)/BraveSoftware/Brave-Browser/Application/brave.exe",
   "/Applications/Google Chrome.app/Contents/MacOS/Google Chrome",
   "/Applications/Chromium.app/Contents/MacOS/Chromium",
-  "/Applications/Brave Browser.app/Contents/MacOS/Brave Browser",
-  "/Applications/Microsoft Edge.app/Contents/MacOS/Microsoft Edge",
   "/usr/bin/google-chrome",
-  "/usr/bin/google-chrome-stable",
-  "/usr/bin/chromium",
-  "/usr/bin/chromium-browser",
-  "/usr/bin/microsoft-edge"
+  "/usr/bin/chromium"
 ];
 
 export function findBrowser() {
@@ -30,20 +24,12 @@ export function findBrowser() {
   return null;
 }
 
-export function listBrowsers() {
-  const found = [];
-  for (const p of CANDIDATES) {
-    if (p && existsSync(p)) found.push(p);
-  }
-  return found;
-}
-
 export async function launch() {
   const exe = findBrowser();
   if (!exe) {
     throw new Error(
-      "No Chrome, Chromium, Edge, or Brave found.\n" +
-      "Install one, or set PORTAL_BROWSER_PATH to the full path of your browser."
+      "No Chrome, Chromium, Edge, or Brave found. " +
+      "Set PORTAL_BROWSER_PATH to your browser executable."
     );
   }
 
@@ -54,8 +40,7 @@ export async function launch() {
     const ctx = await chromium.launchPersistentContext(profileDir, {
       executablePath: exe,
       headless: false,
-      viewport: { width: 1280, height: 900 },
-      args: ["--disable-blink-features=AutomationControlled"]
+      viewport: { width: 1280, height: 900 }
     });
 
     ctx.on("page", function (page) {
@@ -67,9 +52,9 @@ export async function launch() {
     return ctx;
   } catch (e) {
     const m = e.message || String(e);
-    if (/ProcessSingleton|already running|profile/i.test(m)) {
+    if (m.indexOf("ProcessSingleton") >= 0 || m.indexOf("already running") >= 0) {
       throw new Error(
-        "Another Chrome window is using the Portal profile.\n" +
+        "Another Chrome window is using the Portal profile. " +
         "Close every Chrome window and try again."
       );
     }

package/lib/config.mjs

@@ -1,17 +1,14 @@
 import { existsSync, readFileSync } from "node:fs";
-import { resolve, join, dirname } from "node:path";
+import { resolve, join } from "node:path";
 import { homedir } from "node:os";
-import { mkdir, writeFile } from "node:fs/promises";
 
 const DEFAULTS = {
   provider: "deepseek",
   maxSteps: 12,
   timeout: 180000,
   loginTimeout: 600000,
-  theme: "auto",
   yolo: false,
   verbose: false,
-  instructions: ["PORTAL.md", "AGENTS.md", ".portal.md"],
   ignored: [
     "node_modules", ".git", ".hg", ".svn", "dist", "build", "out",
     ".next", ".nuxt", ".turbo", ".cache", "target", "__pycache__",
@@ -19,11 +16,11 @@ const DEFAULTS = {
   ]
 };
 
-export function configPath() {
+function configPath() {
   return join(homedir(), ".portal-agent", "config.json");
 }
 
-export function readGlobalConfig() {
+function readGlobal() {
   const p = configPath();
   if (!existsSync(p)) return {};
   try {
@@ -33,31 +30,30 @@ export function readGlobalConfig() {
   }
 }
 
-export async function writeGlobalConfig(obj) {
-  const p = configPath();
-  await mkdir(dirname(p), { recursive: true });
-  await writeFile(p, JSON.stringify(obj, null, 2), "utf8");
-}
-
 export async function loadConfig(args) {
-  const global = readGlobalConfig();
+  const g = readGlobal();
 
   const config = {
-    ...DEFAULTS,
-    ...global,
+    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(),
-    provider: args.provider || process.env.PORTAL_PROVIDER || global.provider || DEFAULTS.provider,
-    maxSteps: args.maxSteps || global.maxSteps || DEFAULTS.maxSteps,
-    timeout: args.timeout || global.timeout || DEFAULTS.timeout,
-    loginTimeout: args.loginTimeout || global.loginTimeout || DEFAULTS.loginTimeout,
-    theme: args.theme || global.theme || DEFAULTS.theme,
-    yolo: args.yolo || process.env.PORTAL_YOLO === "true" || global.yolo || DEFAULTS.yolo,
-    verbose: args.verbose || global.verbose || DEFAULTS.verbose,
     exec: args.exec,
-    session: args.session || null,
     resume: args.resume || null
   };
 
+  if (args.provider) config.provider = args.provider;
+  if (process.env.PORTAL_PROVIDER) config.provider = process.env.PORTAL_PROVIDER;
+  if (args.maxSteps) config.maxSteps = args.maxSteps;
+  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);
@@ -68,9 +64,7 @@ export async function loadConfig(args) {
     try {
       const local = JSON.parse(readFileSync(localPath, "utf8"));
       Object.assign(config, local);
-    } catch (e) {
-      // ignore malformed local config
-    }
+    } catch (e) {}
   }
 
   return config;

package/lib/deepthink.mjs

@@ -1,50 +1,40 @@
-// Toggle DeepSeek's DeepThink reasoning mode. Without this, DeepSeek answers
-// with the fast model and the output is shorter and less thorough.
-//
-// The button sits in the composer row with a label like "DeepThink" or
-// "Deep Think". After clicking, it gains an active class or aria-pressed=true.
-
 export async function enableDeepThink(page) {
   if (process.env.PORTAL_DEEPTHINK === "off") return false;
 
-  const candidates = page.locator("button, [role=button], div[role=button]");
+  const btns = page.locator("button, [role=button], div[role=button]");
   let total = 0;
   try {
-    total = await candidates.count();
+    total = await btns.count();
   } catch (e) {
     return false;
   }
   if (total === 0 || total > 400) return false;
 
   for (let i = 0; i < total; i++) {
-    const btn = candidates.nth(i);
+    const b = btns.nth(i);
     let text = "";
     try {
-      text = ((await btn.textContent()) || "").trim();
+      text = ((await b.textContent()) || "").trim();
     } catch (e) {
       continue;
     }
     if (!text) continue;
 
-    const isDeepthink = text === "DeepThink" ||
+    const hit = text === "DeepThink" ||
       text === "Deep Think" ||
-      text.indexOf("DeepThink") >= 0 ||
-      text.indexOf("Deep Think") >= 0;
+      text.indexOf("DeepThink") >= 0;
 
-    if (!isDeepthink) continue;
+    if (!hit) continue;
 
     let pressed = "";
     let cls = "";
-    try { pressed = (await btn.getAttribute("aria-pressed")) || ""; } catch (e) {}
-    try { cls = (await btn.getAttribute("class")) || ""; } catch (e) {}
-
-    const alreadyOn = pressed === "true" ||
-      /active|selected|on\b|enabled/i.test(cls);
+    try { pressed = (await b.getAttribute("aria-pressed")) || ""; } catch (e) {}
+    try { cls = (await b.getAttribute("class")) || ""; } catch (e) {}
 
-    if (alreadyOn) return true;
+    if (pressed === "true" || /active|selected|on\b/i.test(cls)) return true;
 
     try {
-      await btn.click({ timeout: 2000 });
+      await b.click({ timeout: 2000 });
       await new Promise(function (r) { setTimeout(r, 400); });
       return true;
     } catch (e) {

package/lib/exec.mjs

@@ -1,3 +1,47 @@
 import { launch } from "./browser.mjs";
 import { getProvider } from "./providers.mjs";
-import { waitForComposer } from "./wait
+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 () {});
+  }
+}

package/lib/instructions.mjs

@@ -1 +1,44 @@
-import {
+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 = "";
+
+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;
+    }
+
+    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;
+}

package/lib/log.mjs

@@ -35,7 +35,3 @@ export function reply(text) {
   if (!text) return;
   process.stdout.write("\n" + theme.cyan("* ") + text + "\n");
 }
-
-export function blank() {
-  process.stdout.write("\n");
-}

package/lib/parse.mjs

@@ -1,13 +1,3 @@
-// Tool call protocol:
-//
-//   portal-tool: {"tool":"name","args":{"key":"value"}}
-//
-// Written as plain text on its own line. The parser scans for the literal
-// string "portal-tool", finds the balanced JSON object that follows, and
-// tries to parse it. If parse fails, common Windows backslash escapes are
-// repaired first (models copy "L:\this\file" and JSON sees \t, \h, \w as
-// escapes that blow up the parse).
-
 function findJsonEnd(s, i) {
   let depth = 0;
   let inStr = false;
@@ -17,4 +7,45 @@ function findJsonEnd(s, i) {
     if (esc) { esc = false; continue; }
     if (c === "\\") { esc = true; continue; }
     if (c === String.fromCharCode(34)) { inStr = !inStr; continue; }
-    if (inStr
+    if (inStr) continue;
+    if (c === "{") depth++;
+    else if (c === "}") {
+      depth--;
+      if (!depth) return j + 1;
+    }
+  }
+  return -1;
+}
+
+function repair(raw) {
+  let s = raw;
+  const bad = ["\\t", "\\h", "\\w", "\\d", "\\p"];
+  for (const b of bad) s = s.split(b).join("/");
+  return s;
+}
+
+export function parseCalls(text) {
+  const out = [];
+  const seen = new Set();
+  const re = /portal-tool[:\s]*/g;
+  let m;
+  while ((m = re.exec(text))) {
+    const b = text.indexOf("{", m.index + m[0].length);
+    if (b < 0) continue;
+    const e = findJsonEnd(text, b);
+    if (e < 0) continue;
+    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) {}
+    }
+  }
+  return out;
+}
+
+export function stripCalls(text) {
+  return text.replace(/portal-tool[\s\S]*?\n\}/g, "").trim();
+}

package/lib/paste.mjs

@@ -1,16 +1,14 @@
 import { sleep } from "./wait.mjs";
 
-// DeepSeek shows a Cancel/Send confirmation bar when a large paste is
-// detected. Find the Cancel button, locate its Send sibling, click that.
 export async function dismissPaste(page) {
   const btns = page.locator("button, [role=button]");
   let total = 0;
   try {
     total = await btns.count();
   } catch (e) {
-    return;
+    return false;
   }
-  if (total === 0 || total > 300) return;
+  if (total === 0 || total > 300) return false;
 
   for (let i = 0; i < total; i++) {
     const b = btns.nth(i);
@@ -36,18 +34,14 @@ export async function dismissPaste(page) {
           await sib.click({ timeout: 1500 });
           await sleep(200);
           return true;
-        } catch (e) {
-          // fall through
-        }
+        } catch (e) {}
       }
     }
 
     try {
       await page.keyboard.press("Enter");
       await sleep(150);
-    } catch (e) {
-      // ignore
-    }
+    } catch (e) {}
     return true;
   }
   return false;

package/lib/providers.mjs

@@ -15,7 +15,7 @@ export const PROVIDERS = {
     url: "https://chatgpt.com/",
     input: ["#prompt-textarea", "div[contenteditable=true][id=prompt-textarea]"],
     submit: ["button[data-testid=send-button]", "button[aria-label*=Send]"],
-    response: ["[data-message-author-role=assistant]", "article[data-testid^=conversation-turn]"],
+    response: ["[data-message-author-role=assistant]"],
     paste: false,
     deepthink: false
   },
@@ -23,9 +23,9 @@ export const PROVIDERS = {
     id: "gemini",
     label: "Gemini",
     url: "https://gemini.google.com/app",
-    input: ["div[contenteditable=true][role=textbox]", "rich-textarea div[contenteditable=true]"],
-    submit: ["button[aria-label*=Send]", "button[aria-label=Send message]"],
-    response: ["message-content", "div[class*=model-response-text]"],
+    input: ["div[contenteditable=true][role=textbox]"],
+    submit: ["button[aria-label*=Send]"],
+    response: ["message-content"],
     paste: false,
     deepthink: false
   },
@@ -34,8 +34,8 @@ export const PROVIDERS = {
     label: "Grok",
     url: "https://grok.com/",
     input: ["textarea", "div[contenteditable=true]"],
-    submit: ["button[type=submit]", "button[aria-label*=Send]"],
-    response: ["div[class*=message]", "div[class*=response]"],
+    submit: ["button[type=submit]"],
+    response: ["div[class*=message]"],
     paste: false,
     deepthink: false
   }
@@ -45,7 +45,7 @@ export function getProvider(id) {
   const p = PROVIDERS[id];
   if (!p) {
     const names = Object.keys(PROVIDERS).join(", ");
-    throw new Error("unknown provider: " + id + "\nAvailable: " + names);
+    throw new Error("unknown provider: " + id + " | available: " + names);
   }
   return p;
 }