portal-agent-cli 3.0.0 → 3.0.1

package/LICENSE

@@ -1,3 +1,5 @@
 MIT License
 
 Copyright (c) 2026
+
+Permission is hereby granted, free of charge, to any

package/README.md

@@ -1,6 +1,7 @@
 # portal-agent
 
-Drive
+Drive web AI products from the terminal with local tools. Uses a real
+Chromium browser against the provider's own website. No
 ```
 
 npm install -g portal-agent-cli
@@ -15,14 +16,15 @@ portal-agent --workspace F:/projects/my-app
 
 ```
 
-Or without installing
+Or without installing:
+
 ```
 
 npx portal-agent-cli --workspace F:/projects/my-app
 
 ```
 
-On first run, Chrome opens at the provider site. Log in there. The session
+On first run, Chrome
 ```
 
 portal-agent --workspace F:/proj exec "list the files here"
@@ -32,7 +34,10 @@ portal-agent --workspace F:/proj exec "list the files here"
 ## 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
@@ -44,12 +49,15 @@ allow? yes / always / no:
 
 ```
 
-Answer
+Answering `a` approves that tool for the rest of the session.
+
+## Safety
+
+- 
 ```
 
 portal-tool: {"tool":"read_file","args":{"path":"notes.txt"}}
 
 ```
 
-Portal parses that line, runs the tool locally, and sends the result back
-into the same conversation. This
+Portal parses that line, runs the tool locally, and sends

package/lib/args.mjs

@@ -35,7 +35,7 @@ export function parseArgs() {
     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.1"); process.exit(0); }
     i++;
   }
 
@@ -78,8 +78,10 @@ function help() {
   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");

package/lib/browser.mjs

@@ -38,7 +38,7 @@ export function listBrowsers() {
   return found;
 }
 
-export async function launch(opts) {
+export async function launch() {
   const exe = findBrowser();
   if (!exe) {
     throw new Error(
@@ -58,8 +58,6 @@ export async function launch(opts) {
       args: ["--disable-blink-features=AutomationControlled"]
     });
 
-    // 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 () {});

package/lib/config.mjs

@@ -63,7 +63,6 @@ export async function loadConfig(args) {
     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 {

package/lib/deepthink.mjs

@@ -0,0 +1,55 @@
+// 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]");
+  let total = 0;
+  try {
+    total = await candidates.count();
+  } catch (e) {
+    return false;
+  }
+  if (total === 0 || total > 400) return false;
+
+  for (let i = 0; i < total; i++) {
+    const btn = candidates.nth(i);
+    let text = "";
+    try {
+      text = ((await btn.textContent()) || "").trim();
+    } catch (e) {
+      continue;
+    }
+    if (!text) continue;
+
+    const isDeepthink = text === "DeepThink" ||
+      text === "Deep Think" ||
+      text.indexOf("DeepThink") >= 0 ||
+      text.indexOf("Deep Think") >= 0;
+
+    if (!isDeepthink) 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);
+
+    if (alreadyOn) return true;
+
+    try {
+      await btn.click({ timeout: 2000 });
+      await new Promise(function (r) { setTimeout(r, 400); });
+      return true;
+    } catch (e) {
+      return false;
+    }
+  }
+  return false;
+}

package/lib/exec.mjs

@@ -1,32 +1,3 @@
 import { launch } from "./browser.mjs";
 import { getProvider } from "./providers.mjs";
-import { waitForComposer } from "./wait.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);
-
-  const session = {
-    id: "exec-" + Date.now(),
-    ws: config.ws,
-    provider: config.provider,
-    turns: [],
-    approvedAlways: [],
-    startedAt: Date.now(),
-   
+import { waitForComposer } from "./wait

package/lib/instructions.mjs

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

package/lib/parse.mjs

@@ -17,53 +17,4 @@ function findJsonEnd(s, i) {
     if (esc) { esc = false; continue; }
     if (c === "\\") { esc = true; continue; }
     if (c === String.fromCharCode(34)) { inStr = !inStr; continue; }
-    if (inStr) continue;
-    if (c === "{") depth++;
-    else if (c === "}") {
-      depth--;
-      if (!depth) return j + 1;
-    }
-  }
-  return -1;
-}
-
-function repairBackslashes(raw) {
-  let s = raw;
-  const bad = ["\\t", "\\h", "\\w", "\\d", "\\p", "\\v", "\\x", "\\c"];
-  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(repairBackslashes(raw)));
-      } catch (y) {
-        // skip malformed
-      }
-    }
-  }
-  return out;
-}
-
-export function stripCalls(text) {
-  return text.replace(/portal-tool[\s\S]*?\n\}/g, "").trim();
-}
-
-export function hasToolCall(text) {
-  return /portal-tool[:\s]*\{/.test(text);
-}
+    if (inStr

package/lib/paste.mjs

@@ -53,8 +53,6 @@ export async function dismissPaste(page) {
   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",
@@ -17,7 +17,7 @@ export const PROVIDERS = {
     submit: ["button[data-testid=send-button]", "button[aria-label*=Send]"],
     response: ["[data-message-author-role=assistant]", "article[data-testid^=conversation-turn]"],
     paste: false,
-    notes: "ChatGPT does not show a paste dialog."
+    deepthink: false
   },
   gemini: {
     id: "gemini",
@@ -27,7 +27,7 @@ export const PROVIDERS = {
     submit: ["button[aria-label*=Send]", "button[aria-label=Send message]"],
     response: ["message-content", "div[class*=model-response-text]"],
     paste: false,
-    notes: "Gemini uses a rich-textarea web component."
+    deepthink: false
   },
   grok: {
     id: "grok",
@@ -37,7 +37,7 @@ export const PROVIDERS = {
     submit: ["button[type=submit]", "button[aria-label*=Send]"],
     response: ["div[class*=message]", "div[class*=response]"],
     paste: false,
-    notes: "Grok selectors are best-effort and may need updating."
+    deepthink: false
   }
 };
 

package/lib/repl.mjs

@@ -1,286 +1,4 @@
 import { createInterface } from "node:readline";
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
-import { launch } from "./browser.mjs";
-import { getProvider, listProviders } from "./providers.mjs";
-import { waitForComposer } from "./wait.mjs";
-import { runTurn } from "./turn.mjs";
-import { setWorkspace, getWorkspace } from "./tools/path.mjs";
-import { setIgnore } from "./tools/walk.mjs";
-import { loadInstructions, activeInstructionFile } from "./instructions.mjs";
-import {
-  newSessionId,
-  saveSession,
-  loadSession,
-  listSessions
-} from "./sessions.mjs";
-import { theme } from "./theme.mjs";
-import { info, warn, error, ok } from "./log.mjs";
-
-export async function runRepl(config) {
-  const provider = getProvider(config.provider);
-  setWorkspace(config.ws);
-  setIgnore(config.ignored);
-
-  const instructionsText = await loadInstructions(config.ws);
-  config.instructionsText = instructionsText;
-
-  // Session handling
-  let session;
-  if (config.resume) {
-    session = await loadSession(config.resume);
-    if (!session) {
-      warn("session not found: " + config.resume + ". starting fresh.");
-      session = newSession(config);
-    }
-  } else {
-    session = newSession(config);
-  }
-
-  // Banner
-  process.stdout.write("\n");
-  process.stdout.write(theme.bold(theme.cyan("Portal")) + theme.dim(" v2.0.0") + "\n");
-  process.stdout.write(theme.dim("workspace: ") + theme.accent(getWorkspace()) + "\n");
-  process.stdout.write(theme.dim("provider:  ") + theme.accent(provider.label) + "\n");
-  process.stdout.write(theme.dim("session:   ") + theme.accent(session.id) + "\n");
-  if (instructionsText) {
-    process.stdout.write(theme.dim("instructions: ") +
-      theme.accent(activeInstructionFile() || "?") + "\n");
-  }
-  if (config.yolo) {
-    process.stdout.write(theme.warn("yolo mode: all tool calls auto-approved") + "\n");
-  }
-  process.stdout.write("\n");
-
-  const ctx = await launch();
-  const page = await ctx.newPage();
-  page.setDefaultTimeout(30000);
-
-  info("opening " + provider.label + "...");
-  await page.goto(provider.url);
-
-  process.stdout.write("\n");
-  process.stdout.write(theme.yellow("Log in to " + provider.label +
-    " in the Chrome window.") + "\n");
-  process.stdout.write(theme.dim("Waiting up to " +
-    Math.round(config.loginTimeout / 1000) + "s.") + "\n");
-  process.stdout.write("\n");
-
-  await waitForComposer(page, provider, config.loginTimeout);
-
-  ok(provider.label + " ready");
-  process.stdout.write(theme.dim("type /help for commands") + "\n");
-  process.stdout.write("\n");
-
-  // REPL
-  const rl = createInterface({
-    input: process.stdin,
-    output: process.stdout,
-    prompt: theme.user("> ")
-  });
-  rl.prompt();
-
-  let busy = false;
-  const queue = [];
-
-  async function drain() {
-    if (busy) return;
-    const next = queue.shift();
-    if (!next) return;
-    busy = true;
-    try {
-      await runTurn(page, provider, next, config, session);
-      await saveSession(session.id, session);
-    } catch (e) {
-      error(e.message || String(e));
-    }
-    busy = false;
-    process.stdout.write("\n");
-    rl.prompt();
-    if (queue.length > 0) drain();
-  }
-
-  rl.on("line", async function (line) {
-    const t = line.trim();
-    if (!t) { rl.prompt(); return; }
-
-    // Slash commands
-    if (t === "/quit" || t === "/exit") { rl.close(); return; }
-    if (t === "/help" || t === "/?") { showHelp(); rl.prompt(); return; }
-    if (t === "/pwd") { process.stdout.write(getWorkspace() + "\n"); rl.prompt(); return; }
-    if (t === "/queue") { showQueue(queue); rl.prompt(); return; }
-    if (t === "/status") { showStatus(config, session, queue, busy); rl.prompt(); return; }
-    if (t === "/history") { showHistory(session); rl.prompt(); return; }
-    if (t === "/clear") { clearScreen(); rl.prompt(); return; }
-    if (t === "/sessions") { await showSessions(); rl.prompt(); return; }
-    if (t === "/providers") { showProviders(); rl.prompt(); return; }
-    if (t.slice(0, 4) === "/cd ") { changeDir(t.slice(4).trim()); rl.prompt(); return; }
-    if (t.slice(0, 10) === "/provider ") {
-      await changeProvider(t.slice(10).trim(), page, config, provider);
-      rl.prompt();
-      return;
-    }
-
-    // Queue or execute
-    if (busy) {
-      queue.push(t);
-      process.stdout.write(theme.dim("queued (" + queue.length + " waiting)") + "\n");
-      rl.prompt();
-      return;
-    }
-    queue.push(t);
-    drain();
-  });
-
-  rl.on("close", async function () {
-    process.stdout.write("\n");
-    process.stdout.write(theme.dim("saving session...") + "\n");
-    await saveSession(session.id, session).catch(function () {});
-    process.stdout.write(theme.dim("closing browser...") + "\n");
-    await ctx.close().catch(function () {});
-    process.stdout.write(theme.ok("+ done") + "\n");
-    process.exit(0);
-  });
-}
-
-function newSession(config) {
-  return {
-    id: newSessionId(),
-    ws: config.ws,
-    provider: config.provider,
-    turns: [],
-    approvedAlways: [],
-    startedAt: Date.now(),
-    updatedAt: Date.now()
-  };
-}
-
-function showHelp() {
-  const lines = [
-    "COMMANDS",
-    "  /help              show this",
-    "  /cd <folder>       change workspace",
-    "  /pwd               show current workspace",
-    "  /provider <name>   switch provider",
-    "  /providers         list providers",
-    "  /sessions          list saved sessions",
-    "  /history           show recent turns",
-    "  /queue             list tasks waiting to run",
-    "  /status            show session status",
-    "  /clear             clear the screen",
-    "  /quit              exit",
-    "",
-    "Anything else is sent to the model as a task.",
-    "Tasks typed while the model is busy are queued."
-  ];
-  for (const l of lines) {
-    process.stdout.write((l.startsWith("  ") ? theme.dim(l) : theme.bold(l)) + "\n");
-  }
-}
-
-function showQueue(queue) {
-  if (!queue.length) {
-    process.stdout.write(theme.dim("(queue empty)") + "\n");
-    return;
-  }
-  process.stdout.write(theme.bold(queue.length + " task(s) waiting:") + "\n");
-  queue.forEach(function (x, i) {
-    process.stdout.write(theme.dim("  " + (i + 1) + ". ") + x + "\n");
-  });
-}
-
-function showStatus(config, session, queue, busy) {
-  process.stdout.write(theme.bold("session status") + "\n");
-  process.stdout.write(theme.dim("  id:        ") + session.id + "\n");
-  process.stdout.write(theme.dim("  workspace: ") + getWorkspace() + "\n");
-  process.stdout.write(theme.dim("  provider:  ") + session.provider + "\n");
-  process.stdout.write(theme.dim("  turns:     ") + session.turns.length + "\n");
-  process.stdout.write(theme.dim("  busy:      ") + (busy ? "yes" : "no") + "\n");
-  process.stdout.write(theme.dim("  queued:    ") + queue.length + "\n");
-  process.stdout.write(theme.dim("  yolo:      ") + (config.yolo ? "on" : "off") + "\n");
-}
-
-function showHistory(session) {
-  if (!session.turns.length) {
-    process.stdout.write(theme.dim("(no turns yet)") + "\n");
-    return;
-  }
-  const recent = session.turns.slice(-10);
-  for (const t of recent) {
-    const tag = t.role === "user" ? theme.user("you") : theme.cyan("ai");
-    const text = String(t.text || "").slice(0, 200);
-    process.stdout.write(tag + ": " + text + "\n");
-  }
-}
-
-async function showSessions() {
-  const list = await listSessions();
-  if (!list.length) {
-    process.stdout.write(theme.dim("(no saved sessions)") + "\n");
-    return;
-  }
-  process.stdout.write(theme.bold("saved sessions:") + "\n");
-  for (const s of list.slice(0, 15)) {
-    const when = timeAgo(s.updatedAt);
-    process.stdout.write(theme.dim("  " + s.id + "  " + when + "  " +
-      s.provider + "  " + s.turns + " turns") + "\n");
-  }
-}
-
-function showProviders() {
-  const list = listProviders();
-  process.stdout.write(theme.bold("providers:") + "\n");
-  for (const p of list) {
-    process.stdout.write(theme.dim("  " + p.id.padEnd(10)) + " " + p.label + "\n");
-  }
-}
-
-function changeDir(target) {
-  if (!target) {
-    process.stdout.write(theme.dim("usage: /cd <folder>") + "\n");
-    process.stdout.write(theme.dim("current: ") + getWorkspace() + "\n");
-    return;
-  }
-  const clean = target.replace(/^"|"$/g, "");
-  const abs = resolve(clean);
-  if (!existsSync(abs)) {
-    warn("not found: " + abs);
-    return;
-  }
-  setWorkspace(abs);
-  ok("workspace: " + getWorkspace());
-}
-
-async function changeProvider(name, page, config, current) {
-  if (name === current.id) {
-    process.stdout.write(theme.dim("already on " + name) + "\n");
-    return;
-  }
-  let next;
-  try {
-    next = getProvider(name);
-  } catch (e) {
-    error(e.message);
-    return;
-  }
-  info("switching to " + next.label + "...");
-  await page.goto(next.url);
-  await waitForComposer(page, next, 60000);
-  config.provider = name;
-  ok("switched to " + next.label);
-}
-
-function clearScreen() {
-  process.stdout.write(String.fromCharCode(27) + "[2J");
-  process.stdout.write(String.fromCharCode(27) + "[H");
-}
-
-function timeAgo(ms) {
-  const s = Math.floor((Date.now() - ms) / 1000);
-  if (s < 60) return s + "s ago";
-  const m = Math.floor(s / 60);
-  if (m < 60) return m + "m ago";
-  const h = Math.floor(m / 60);
-  if (h < 24) return h + "h ago";
-  return Math.floor(h / 24) + "d ago";
-}
+import { launch } from "./