portal-agent-cli 3.0.0 → 3.0.2

package/LICENSE

@@ -1,3 +1,21 @@
 MIT License
 
 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,55 +1,28 @@
 # portal-agent
 
-Drive
-```
+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 opens at the provider site. Log in there. The session
-```
-
-portal-agent --workspace F:/proj exec "list the files here"
-
-```
+/help, /cd, /pwd, /provider, /providers, /deepthink,
+/sessions, /queue, /status, /clear, /quit
 
 ## Tools
 
-| Tool | Description |
-|-|-|
-```
-
-- approval required
-tool: shell
-{
-"command": "npm test"
-}
-allow? yes / always / no:
-
-```
-
-Answer
-```
-
-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 the result back
-into the same conversation. This
+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("2.0.0"); process.exit(0); }
+    else if (t === "--version" || t === "-v") { console.log("3.0.2"); process.exit(0); }
     i++;
   }
 
@@ -46,44 +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_DEBUG              print stack traces on error");
-  console.log("  PORTAL_YOLO               same as --yolo");
-  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(opts) {
+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,12 +40,9 @@ export async function launch(opts) {
     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 }
     });
 
-    // Auto-dismiss dialogs (alert, confirm, prompt) so a stray modal cannot
-    // freeze the session.
     ctx.on("page", function (page) {
       page.on("dialog", function (d) {
         d.dismiss().catch(function () {});
@@ -69,9 +52,9 @@ export async function launch(opts) {
     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,45 +30,41 @@ 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);
   }
 
-  // Per-project config file
   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) {
-      // ignore malformed local config
-    }
+    } catch (e) {}
   }
 
   return config;

package/lib/deepthink.mjs

@@ -0,0 +1,45 @@
+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;
+  }
+  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;
+    }
+    if (!text) continue;
+
+    const hit = text === "DeepThink" ||
+      text === "Deep Think" ||
+      text.indexOf("DeepThink") >= 0;
+
+    if (!hit) 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;
+    }
+  }
+  return false;
+}

package/lib/exec.mjs

@@ -1,6 +1,7 @@
 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";
@@ -22,6 +23,8 @@ export async function runExec(config) {
   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,
@@ -29,4 +32,16 @@ export async function runExec(config) {
     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/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;
@@ -27,9 +17,9 @@ function findJsonEnd(s, i) {
   return -1;
 }
 
-function repairBackslashes(raw) {
+function repair(raw) {
   let s = raw;
-  const bad = ["\\t", "\\h", "\\w", "\\d", "\\p", "\\v", "\\x", "\\c"];
+  const bad = ["\\t", "\\h", "\\w", "\\d", "\\p"];
   for (const b of bad) s = s.split(b).join("/");
   return s;
 }
@@ -50,11 +40,7 @@ export function parseCalls(text) {
     try {
       out.push(JSON.parse(raw));
     } catch (x) {
-      try {
-        out.push(JSON.parse(repairBackslashes(raw)));
-      } catch (y) {
-        // skip malformed
-      }
+      try { out.push(JSON.parse(repair(raw))); } catch (y) {}
     }
   }
   return out;
@@ -63,7 +49,3 @@ export function parseCalls(text) {
 export function stripCalls(text) {
   return text.replace(/portal-tool[\s\S]*?\n\}/g, "").trim();
 }
-
-export function hasToolCall(text) {
-  return /portal-tool[:\s]*\{/.test(text);
-}

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,25 +34,19 @@ 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;
 }
 
-// Poll the composer for emptiness. A thrown inputValue() means the composer
-// is a contenteditable with no inputValue method, so treat that as sent.
 export async function composerEmpty(input, ms) {
   const end = Date.now() + ms;
   while (Date.now() < end) {

package/lib/providers.mjs

@@ -7,7 +7,7 @@ export const PROVIDERS = {
     submit: ["button[aria-label=Send]", "button[data-testid=send-button]"],
     response: ["div.ds-markdown", "div[class*=message]"],
     paste: true,
-    notes: "DeepSeek renders the user prompt with the same class as the reply."
+    deepthink: true
   },
   chatgpt: {
     id: "chatgpt",
@@ -15,29 +15,29 @@ 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,
-    notes: "ChatGPT does not show a paste dialog."
+    deepthink: false
   },
   gemini: {
     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,
-    notes: "Gemini uses a rich-textarea web component."
+    deepthink: false
   },
   grok: {
     id: "grok",
     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,
-    notes: "Grok selectors are best-effort and may need updating."
+    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;
 }