portal-agent-cli 1.0.1 → 3.0.1

package/lib/paste.mjs

@@ -1,5 +1,7 @@
 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;
@@ -33,7 +35,7 @@ export async function dismissPaste(page) {
         try {
           await sib.click({ timeout: 1500 });
           await sleep(200);
-          return;
+          return true;
         } catch (e) {
           // fall through
         }
@@ -46,8 +48,9 @@ export async function dismissPaste(page) {
     } catch (e) {
       // ignore
     }
-    return;
+    return true;
   }
+  return false;
 }
 
 export async function composerEmpty(input, ms) {
@@ -57,7 +60,6 @@ export async function composerEmpty(input, ms) {
     try {
       v = await input.inputValue();
     } catch (e) {
-      // contenteditable composers have no inputValue. Treat as sent.
       return true;
     }
     if (!v || v.length === 0) return true;

package/lib/providers.mjs

@@ -3,19 +3,41 @@ export const PROVIDERS = {
     id: "deepseek",
     label: "DeepSeek",
     url: "https://chat.deepseek.com/",
-    input: "textarea",
-    submit: "button[aria-label=Send]",
-    response: "div.ds-markdown",
-    paste: true
+    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
   },
   chatgpt: {
     id: "chatgpt",
     label: "ChatGPT",
     url: "https://chatgpt.com/",
-    input: "#prompt-textarea",
-    submit: "button[data-testid=send-button]",
-    response: "[data-message-author-role=assistant]",
-    paste: false
+    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]"],
+    paste: false,
+    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]"],
+    paste: false,
+    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]"],
+    paste: false,
+    deepthink: false
   }
 };
 
@@ -23,7 +45,11 @@ export function getProvider(id) {
   const p = PROVIDERS[id];
   if (!p) {
     const names = Object.keys(PROVIDERS).join(", ");
-    throw new Error("unknown provider: " + id + ". Available: " + names);
+    throw new Error("unknown provider: " + id + "\nAvailable: " + names);
   }
   return p;
 }
+
+export function listProviders() {
+  return Object.keys(PROVIDERS).map(function (k) { return PROVIDERS[k]; });
+}

package/lib/repl.mjs

@@ -1,119 +1,4 @@
 import { createInterface } from "node:readline";
 import { existsSync } from "node:fs";
 import { resolve } from "node:path";
-import { launch } from "./browser.mjs";
-import { getProvider } from "./providers.mjs";
-import { waitForComposer } from "./wait.mjs";
-import { runTurn } from "./turn.mjs";
-import { setWs, getWs } from "./tools.mjs";
-
-export async function runRepl(opts) {
-  const provider = getProvider(opts.provider);
-  setWs(opts.ws);
-
-  console.log("");
-  console.log("Portal -- web AI in your terminal");
-  console.log("workspace: " + getWs());
-  console.log("provider:  " + provider.label);
-  console.log("");
-
-  const ctx = await launch();
-  const page = await ctx.newPage();
-  page.setDefaultTimeout(30000);
-
-  console.log("opening " + provider.label + "...");
-  await page.goto(provider.url);
-  console.log("");
-  console.log("Log in to " + provider.label + " in the Chrome window.");
-  console.log("Waiting up to " + Math.round(opts.loginTimeout / 1000) + "s.");
-  console.log("");
-
-  await waitForComposer(page, provider, opts.loginTimeout);
-
-  console.log("+ " + provider.label + " ready");
-  console.log("type /help for commands");
-  console.log("");
-
-  const rl = createInterface({
-    input: process.stdin,
-    output: process.stdout,
-    prompt: "> "
-  });
-  rl.prompt();
-
-  let busy = false;
-
-  rl.on("line", async function (line) {
-    const t = line.trim();
-
-    if (busy) {
-      rl.prompt();
-      return;
-    }
-    if (!t) {
-      rl.prompt();
-      return;
-    }
-    if (t === "/quit" || t === "/exit") {
-      rl.close();
-      return;
-    }
-    if (t === "/help") {
-      help();
-      rl.prompt();
-      return;
-    }
-    if (t === "/pwd") {
-      console.log(getWs());
-      rl.prompt();
-      return;
-    }
-    if (t.slice(0, 4) === "/cd ") {
-      changeDir(t.slice(4).trim(), rl);
-      return;
-    }
-
-    busy = true;
-    try {
-      await runTurn(page, provider, t, opts);
-    } catch (e) {
-      console.log("x " + (e.message || e));
-    }
-    busy = false;
-    console.log("");
-    rl.prompt();
-  });
-
-  rl.on("close", async function () {
-    console.log("");
-    console.log("closing browser...");
-    await ctx.close().catch(function () {});
-    process.exit(0);
-  });
-}
-
-function help() {
-  console.log("  /cd <folder>   change workspace");
-  console.log("  /pwd           show current workspace");
-  console.log("  /help          show this help");
-  console.log("  /quit          exit");
-}
-
-function changeDir(target, rl) {
-  if (!target) {
-    console.log("usage: /cd <folder>");
-    console.log("current: " + getWs());
-    rl.prompt();
-    return;
-  }
-  const clean = target.replace(/^"|"$/g, "");
-  const abs = resolve(clean);
-  if (!existsSync(abs)) {
-    console.log("not found: " + abs);
-    rl.prompt();
-    return;
-  }
-  setWs(abs);
-  console.log("workspace: " + getWs());
-  rl.prompt();
-}
+import { launch } from "./

package/lib/safety.mjs

@@ -0,0 +1 @@
+import

package/lib/send.mjs

@@ -1,88 +1,108 @@
-import { sleep, norm } from "./wait.mjs";
+import { sleep, norm, findFirstVisible } from "./wait.mjs";
 import { dismissPaste, composerEmpty } from "./paste.mjs";
+import { theme } from "./theme.mjs";
+
+const SETTLE_MS = 1500;
+const POLL_MS = 150;
+
+function makeStreamer() {
+  let printed = 0;
+  let lastLength = 0;
+  return function (text) {
+    if (!text) return;
+    const t = String(text);
+    if (t.length > lastLength) {
+      const delta = t.slice(printed);
+      process.stdout.write(delta);
+      printed = t.length;
+      lastLength = t.length;
+    }
+  };
+}
 
 export async function send(page, provider, prompt, timeoutMs) {
-  const input = page.locator(provider.input).last();
-  await input.waitFor({ state: "visible", timeout: 30000 });
-  const before = await page.locator(provider.response).count();
+  const input = await findFirstVisible(page, provider.input, 30000);
+  if (!input) throw new Error("composer not found");
+
+  const want = norm(prompt);
 
   await input.focus();
   try {
     await page.keyboard.press("Control+A");
     await page.keyboard.press("Delete");
   } catch (e) {
-    // composer may be empty
+    // empty composer
   }
 
   await page.keyboard.insertText(prompt);
   await sleep(300);
-
   if (provider.paste) await dismissPaste(page);
 
   try {
     await input.press("Enter");
   } catch (e) {
-    // fall through to button
+    // fall through
   }
 
   let ok = await composerEmpty(input, 5000);
-
   if (!ok) {
-    const btn = page.locator(provider.submit).last();
-    try {
-      if (await btn.isVisible({ timeout: 1500 })) await btn.click();
-    } catch (e) {
-      // no button
+    const btn = await findFirstVisible(page, provider.submit, 1500);
+    if (btn) {
+      try { await btn.click({ timeout: 1500 }); } catch (e) {}
     }
     ok = await composerEmpty(input, 3000);
   }
 
   if (!ok) {
     throw new Error(
-      "Message stayed in composer. Look at the Chrome window: if a " +
-      "Cancel/Send bar is showing, click Send manually once, then resend."
+      "Message stayed in composer.\n" +
+      "Check Chrome: if a Cancel/Send bar is showing, click Send manually, " +
+      "then resend."
     );
   }
 
-  const want = norm(prompt);
-  const end = Date.now() + timeoutMs;
-  let appeared = false;
-
-  while (Date.now() < end) {
-    const c = await page.locator(provider.response).count();
-    if (c > before) {
-      appeared = true;
-      break;
-    }
-    await sleep(300);
-  }
-
-  if (!appeared) throw new Error("No response appeared within the timeout.");
+  return waitForReply(page, provider, want, timeoutMs);
+}
 
+async function waitForReply(page, provider, want, timeoutMs) {
+  const end = Date.now() + timeoutMs;
   let last = "";
   let stab = Date.now();
+  let sawAnything = false;
+  const stream = makeStreamer();
+
+  process.stdout.write("\n" + theme.cyan("* ") + " ");
 
   while (Date.now() < end) {
-    const node = page.locator(provider.response).last();
-    let tx = "";
-    try {
-      tx = (await node.textContent()) || "";
-    } catch (e) {
-      tx = "";
-    }
-    const n = norm(tx);
-    if (!n || n === want) {
-      await sleep(300);
-      continue;
-    }
-    if (tx !== last) {
-      last = tx;
-      stab = Date.now();
-    } else if (Date.now() - stab > 1500) {
-      return tx;
+    const node = await findFirstVisible(page, provider.response, 1000);
+    if (node) {
+      let tx = "";
+      try { tx = (await node.textContent()) || ""; } catch (e) { tx = ""; }
+      const n = norm(tx);
+
+      if (!n || n === want) {
+        await sleep(POLL_MS);
+        continue;
+      }
+
+      if (tx !== last) {
+        stream(tx);
+        last = tx;
+        stab = Date.now();
+        sawAnything = true;
+      } else if (sawAnything && Date.now() - stab > SETTLE_MS) {
+        process.stdout.write("\n\n");
+        return tx;
+      }
     }
-    await sleep(300);
+    await sleep(POLL_MS);
   }
 
-  return last || "(timeout)";
+  process.stdout.write("\n\n");
+  if (last) return last;
+  throw new Error(
+    "Timed out waiting for a reply.\n" +
+    "Check the Chrome window. If the model answered but Portal missed it, " +
+    "send the task again."
+  );
 }

package/lib/sessions.mjs

@@ -0,0 +1 @@
+import { mk

package/lib/system.mjs

@@ -1,24 +1,4 @@
-import { CATALOG } from "./tools.mjs";
+import { CATALOG } from "./tools/index.mjs";
 
-export function buildSystem(ws) {
-  const shown = ws.split("\\").join("/");
-  return [
-    "You are a coding agent working in a terminal.",
-    "Workspace: " + shown,
-    "Use forward slashes in every path, even on Windows.",
-    "",
-    "To call a tool, write on its own line:",
-    "portal-tool: {\"tool\":\"name\",\"args\":{\"key\":\"value\"}}",
-    "",
-    "The JSON must use double quotes around keys and values.",
-    "Plain text only. Do not wrap the call in a code block.",
-    "One call per action. Never repeat a call with the same arguments.",
-    "",
-    "If a tool returns an empty result, that is final. Report it.",
-    "If unsure what to do, reply with plain prose and ask.",
-    "When done, reply with plain prose and no tool calls.",
-    "",
-    "Available tools:",
-    CATALOG
-  ].join("\n");
-}
+export function buildSystem(ws, instructions) {
+  const shown = ws.split("\\

package/lib/theme.mjs

@@ -0,0 +1,49 @@
+const E = String.fromCharCode(27);
+
+const MODE = process.env.NO_COLOR ? "plain" : "color";
+
+function c(code) {
+  if (MODE === "plain") return "";
+  return E + "[" + code + "m";
+}
+
+const R = c(0);
+const B = c(1);
+const D = c(90);
+const RED = c(31);
+const GRN = c(32);
+const YEL = c(33);
+const BLU = c(34);
+const MAG = c(35);
+const CYN = c(36);
+const BGRN = c(92);
+const BRED = c(91);
+const BCYN = c(96);
+
+function wrap(prefix, s) {
+  return prefix + String(s) + R;
+}
+
+export const theme = {
+  reset: R,
+  bold: function (s) { return wrap(B, s); },
+  dim: function (s) { return wrap(D, s); },
+  red: function (s) { return wrap(RED, s); },
+  error: function (s) { return wrap(BRED, s); },
+  green: function (s) { return wrap(GRN, s); },
+  ok: function (s) { return wrap(BGRN, s); },
+  yellow: function (s) { return wrap(YEL, s); },
+  warn: function (s) { return wrap(YEL, s); },
+  blue: function (s) { return wrap(BLU, s); },
+  magenta: function (s) { return wrap(MAG, s); },
+  cyan: function (s) { return wrap(BCYN, s); },
+  accent: function (s) { return wrap(CYN, s); },
+  user: function (s) { return wrap(BLU, s); },
+  tool: function (s) { return wrap(MAG, s); },
+  italic: function (s) { return c(3) + String(s) + R; },
+  underline: function (s) { return c(4) + String(s) + R; }
+};
+
+export function colorEnabled() {
+  return MODE === "color";
+}

package/lib/tools/delete.mjs

@@ -0,0 +1,2 @@
+import { stat, rename } from "node:fs/promises";
+import

package/lib/tools/edit.mjs

@@ -0,0 +1 @@
+import

package/lib/tools/find.mjs

@@ -0,0 +1 @@
+import { relative, sep } from "

package/lib/tools/git.mjs

@@ -0,0 +1,5 @@
+import { spawn } from "node:child_process";
+import { getWorkspace } from "./path.mjs";
+
+function run(args) {
+  return new

package/lib/tools/grep.mjs

@@ -0,0 +1,2 @@
+import { readFile, stat } from "node:fs/promises";
+import { relative }

package/lib/tools/index.mjs

@@ -0,0 +1,2 @@
+import { read_file } from "./read.mjs";
+import { write_file, append_file }

package/lib/tools/list.mjs

@@ -0,0 +1 @@
+import { readdir, stat } from "node:fs/prom

package/lib/tools/path.mjs

@@ -0,0 +1 @@
+import

package/lib/tools/read.mjs

@@ -0,0 +1,4 @@
+import { readFile } from "node:fs/promises";
+import { safePath } from "./path.mjs";
+
+const MAX_BYTES = 

package/lib/tools/shell.mjs

@@ -0,0 +1,5 @@
+import { spawn } from "node:child_process";
+import { getWorkspace } from "./path.mjs";
+
+const MAX_OUTPUT = 65000;
+const TIMEOUT_MS = 60000

package/lib/tools/walk.mjs

@@ -0,0 +1 @@
+import { readdir } from "node

package/lib/tools/write.mjs

@@ -0,0 +1,5 @@
+import { writeFile, mkdir, readFile } from "node:fs/promises";
+import { dirname } from "node:path";
+import { safePath } from "./path.mjs";
+
+export async function write_file

package/lib/turn.mjs

@@ -1,57 +1,2 @@
 import { send } from "./send.mjs";
-import { parseCalls, stripCalls } from "./parse.mjs";
-import { tools, getWs } from "./tools.mjs";
-import { buildSystem } from "./system.mjs";
-
-export async function runTurn(page, provider, prompt, opts) {
-  const sys = buildSystem(getWs());
-  const seen = new Map();
-  let next = sys + "\n\nTask: " + prompt;
-
-  for (let i = 0; i < opts.maxSteps; i++) {
-    console.log("  waiting for " + provider.label + "...");
-    const r = await send(page, provider, next, opts.timeout);
-    const calls = parseCalls(r);
-
-    if (!calls.length) {
-      const prose = stripCalls(r);
-      if (prose) console.log("\n" + prose + "\n");
-      return;
-    }
-
-    const results = [];
-    let stop = false;
-
-    for (const c of calls) {
-      const sig = c.tool + ":" + JSON.stringify(c.args || {});
-      const n = (seen.get(sig) || 0) + 1;
-      seen.set(sig, n);
-
-      if (n >= 3) {
-        console.log("loop detected: " + c.tool + " repeated. stopping.");
-        stop = true;
-        break;
-      }
-
-      console.log("> " + c.tool + " " + JSON.stringify(c.args || {}).slice(0, 120));
-
-      let out;
-      try {
-        const fn = tools[c.tool];
-        out = fn ? await fn(c.args || {}) : "unknown tool: " + c.tool;
-      } catch (e) {
-        out = "error: " + (e.message || e);
-      }
-
-      console.log("  " + String(out).slice(0, 240).split("\n").join("\n  "));
-      results.push(c.tool + ":\n" + out);
-    }
-
-    if (stop) return;
-
-    next = "Results:\n\n" + results.join("\n\n") +
-      "\n\nContinue. Do not repeat any call with the same arguments.";
-  }
-
-  console.log("max steps reached for this turn.");
-}
+import { parse

package/lib/wait.mjs

@@ -6,27 +6,58 @@ export function norm(s) {
   return String(s || "").replace(/\s+/g, " ").trim();
 }
 
-export async function waitForComposer(page, p, ms) {
+export async function findFirstVisible(page, selectors, ms) {
   const end = Date.now() + ms;
-  let hint = Date.now();
   while (Date.now() < end) {
-    const loc = page.locator(p.input).last();
-    let ok = false;
-    try {
-      ok = await loc.isVisible({ timeout: 250 });
-    } catch (e) {
-      ok = false;
+    for (const sel of selectors) {
+      const loc = page.locator(sel).last();
+      try {
+        if (await loc.isVisible({ timeout: 200 })) return loc;
+      } catch (e) {
+        // try next selector
+      }
+    }
+    await sleep(200);
+  }
+  return null;
+}
+
+export async function waitForComposer(page, provider, ms) {
+  const end = Date.now() + ms;
+  let lastHint = Date.now();
+  while (Date.now() < end) {
+    for (const sel of provider.input) {
+      const loc = page.locator(sel).last();
+      let ok = false;
+      try {
+        ok = await loc.isVisible({ timeout: 200 });
+      } catch (e) {
+        ok = false;
+      }
+      if (ok) return loc;
     }
-    if (ok) return loc;
-    if (Date.now() - hint > 15000) {
+    if (Date.now() - lastHint > 15000) {
       const left = Math.round((end - Date.now()) / 1000);
       process.stdout.write("  waiting for login (" + left + "s left)\n");
-      hint = Date.now();
+      lastHint = Date.now();
     }
     await sleep(1000);
   }
   throw new Error(
-    "Timed out waiting for the composer. Log in to the provider " +
-    "and try again, or raise --login-timeout."
+    "Timed out waiting for the composer.\n" +
+    "Log in to the provider in the Chrome window and try again, " +
+    "or raise --login-timeout."
   );
 }
+
+export async function countMatching(page, selectors) {
+  for (const sel of selectors) {
+    try {
+      const n = await page.locator(sel).count();
+      if (n > 0) return n;
+    } catch (e) {
+      // try next
+    }
+  }
+  return 0;
+}