pum-agent 0.2.4-beta.1 → 0.2.5-beta.1

package/README.md

@@ -91,6 +91,8 @@ bun run start
 
 PUM opens the login panel automatically when no provider is available. Use `/login` later to add or update a provider. During browser-based login, PUM opens credential-free HTTP(S) authentication URLs with the platform browser. The URL remains selectable when automatic launch is unavailable.
 
+Custom OpenAI-compatible provider fields accept terminal bracketed paste and local `Ctrl+V` clipboard paste for endpoint URLs and API keys. PUM routes pasted API keys directly to the login controller and renders only a length mask. Remote sessions do not invoke a local host clipboard command.
+
 Resume the latest session for the current directory:
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pum-agent",
-  "version": "0.2.4-beta.1",
+  "version": "0.2.5-beta.1",
   "description": "A compact terminal coding agent powered by pi and OpenTUI.",
   "license": "MIT",
   "type": "module",

package/src/app.tsx

@@ -1,6 +1,6 @@
-import type { ScrollBoxRenderable, TextareaRenderable } from "@opentui/core";
+import { decodePasteBytes, type ScrollBoxRenderable, type TextareaRenderable } from "@opentui/core";
 import { randomUUID } from "node:crypto";
-import { useKeyboard, useTerminalDimensions } from "@opentui/react";
+import { useKeyboard, usePaste, useTerminalDimensions } from "@opentui/react";
 import type { Model } from "@earendil-works/pi-ai";
 import type { AgentSession, ModelRuntime } from "@earendil-works/pi-coding-agent";
 import { Fragment, useEffect, useMemo, useRef, useState } from "react";
@@ -121,6 +121,7 @@ import {
   type TriggerManagerLike,
 } from "./triggers/popup";
 import type { TerminalTitleController } from "./terminal-title";
+import { readClipboardText } from "./text-paste";
 
 type Stream = { kind: "assistant" | "thinking"; text: string } | null;
 type Transcript = { lines: Line[]; stream: Stream; pending: PendingLine[] };
@@ -341,6 +342,7 @@ export function App({
   promptHistoryStore = DEFAULT_PROMPT_HISTORY_STORE,
   promptStashStore = DEFAULT_PROMPT_STASH_STORE,
   captureImage = captureClipboardImage,
+  readPastedText = readClipboardText,
   onExit = () => process.exit(0),
   checkApprovalCoordinator,
   checkApprovalStore,
@@ -366,6 +368,7 @@ export function App({
   promptHistoryStore?: PromptHistoryStore;
   promptStashStore?: PromptStashStore;
   captureImage?: typeof captureClipboardImage;
+  readPastedText?: typeof readClipboardText;
   onExit?: () => void | Promise<void>;
   checkApprovalCoordinator?: CheckApprovalCoordinator;
   checkApprovalStore?: CheckApprovalStore;
@@ -507,6 +510,7 @@ export function App({
   const nextImageId = useRef(1);
   const lastInputValue = useRef("");
   const imagePasteBusy = useRef(false);
+  const loginTextPasteBusy = useRef(false);
   const viewDrafts = useRef(new Map<string, string>());
   const viewEditingStashIndices = useRef(new Map<string, number | null>());
   const spawnPreviewRestoreView = useRef<{ active: boolean; agentId: string | null }>({
@@ -787,6 +791,19 @@ export function App({
     }
   };
 
+  const pasteLoginClipboardText = async () => {
+    if (loginTextPasteBusy.current) return;
+    loginTextPasteBusy.current = true;
+    try {
+      const text = await readPastedText();
+      loginControllerRef.current?.pasteText(text);
+    } catch {
+      append({ kind: "text", role: "error", text: "text paste failed" });
+    } finally {
+      loginTextPasteBusy.current = false;
+    }
+  };
+
   const append = (line: Line) =>
     setTx((t) => {
       const f = flushed(t);
@@ -1698,6 +1715,13 @@ export function App({
     selectAgentView(ids[next] ?? null);
   };
 
+  usePaste((event) => {
+    const controller = loginControllerRef.current;
+    if (!loginOpen || !controller?.acceptsTextPaste()) return;
+    event.stopPropagation();
+    controller.pasteText(decodePasteBytes(event.bytes));
+  });
+
   useKeyboard((key) => {
     if (checkApproval) {
       key.stopPropagation();
@@ -1814,6 +1838,11 @@ export function App({
     }
 
     if (loginOpen) {
+      if (key.ctrl && key.name === "v" && loginControllerRef.current?.acceptsTextPaste()) {
+        key.stopPropagation();
+        void pasteLoginClipboardText();
+        return;
+      }
       if (loginControllerRef.current?.handleKey(key)) key.stopPropagation();
       return;
     }

package/src/login-controller.ts

@@ -20,6 +20,10 @@ export type LoginKey = {
   option?: boolean;
 };
 
+function pastedSingleLine(text: string): string {
+  return text.replace(/[\u0000-\u001f\u007f]/g, "");
+}
+
 export function filterLoginMethods(methods: readonly LoginMethod[], query: string): LoginMethod[] {
   const terms = query.trim().toLocaleLowerCase().split(/\s+/).filter(Boolean);
   if (terms.length === 0) return [...methods];
@@ -254,6 +258,41 @@ export class LoginController {
     return false;
   }
 
+  acceptsTextPaste(): boolean {
+    return this.page.kind === "custom-endpoint" ||
+      this.page.kind === "custom-key" ||
+      (this.page.kind === "prompt" && this.page.prompt.type !== "select");
+  }
+
+  pasteText(text: string): boolean {
+    if (!this.acceptsTextPaste()) return false;
+    const pasted = pastedSingleLine(text);
+    if (!pasted) return true;
+
+    if (this.page.kind === "prompt") {
+      const current = this.page;
+      if (current.prompt.type === "secret") {
+        this.secret += pasted;
+        this.setPage({ ...current, secretLength: this.secret.length });
+      } else {
+        this.setPage({ ...current, value: current.value + pasted });
+      }
+      return true;
+    }
+    if (this.page.kind === "custom-endpoint") {
+      this.endpoint = this.page.endpoint + pasted;
+      this.setPage({ kind: "custom-endpoint", endpoint: this.endpoint });
+      return true;
+    }
+    if (this.page.kind === "custom-key") {
+      const current = this.page;
+      this.customKey += pasted;
+      this.setPage({ ...current, secretLength: this.customKey.length });
+      return true;
+    }
+    return false;
+  }
+
   handleKey(key: LoginKey): boolean {
     const enter = key.name === "return" || key.name === "enter" || key.name === "kpenter" || key.name === "linefeed";
     if (key.name === "escape") {

package/src/text-paste.ts

@@ -0,0 +1,109 @@
+import { spawn } from "node:child_process";
+
+const MAX_CLIPBOARD_TEXT_BYTES = 64 * 1024;
+const WINDOWS_CLIPBOARD_TEXT_SCRIPT = [
+  "[Console]::OutputEncoding = [System.Text.UTF8Encoding]::new($false)",
+  "[Console]::Out.Write((Get-Clipboard -Raw))",
+].join("; ");
+
+type Environment = Record<string, string | undefined>;
+type NativeClipboard = { getText(): Promise<string> };
+type CommandRunner = (command: string, args: string[]) => Promise<string>;
+
+export type ClipboardTextOptions = {
+  platform?: NodeJS.Platform;
+  env?: Environment;
+  nativeClipboard?: NativeClipboard | null;
+  runner?: CommandRunner;
+};
+
+function isRemoteSession(env: Environment): boolean {
+  return Boolean(env.SSH_CONNECTION || env.SSH_CLIENT || env.MOSH_CONNECTION);
+}
+
+async function loadNativeClipboard(): Promise<NativeClipboard | null> {
+  try {
+    return await import("@mariozechner/clipboard");
+  } catch {
+    return null;
+  }
+}
+
+function runClipboardCommand(command: string, args: string[]): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const child = spawn(command, args, {
+      stdio: ["ignore", "pipe", "ignore"],
+      windowsHide: true,
+    });
+    const chunks: Buffer[] = [];
+    let size = 0;
+    let settled = false;
+    const finish = (error?: Error) => {
+      if (settled) return;
+      settled = true;
+      clearTimeout(timer);
+      if (error) reject(error);
+      else resolve(Buffer.concat(chunks).toString("utf8"));
+    };
+    const timer = setTimeout(() => {
+      child.kill();
+      finish(new Error("Clipboard read timed out"));
+    }, 5000);
+    child.stdout.on("data", (chunk: Buffer) => {
+      size += chunk.length;
+      if (size > MAX_CLIPBOARD_TEXT_BYTES) {
+        child.kill();
+        finish(new Error("Clipboard text is too large"));
+        return;
+      }
+      chunks.push(chunk);
+    });
+    child.on("error", () => finish(new Error("Clipboard command failed")));
+    child.on("close", (code) => finish(code === 0 ? undefined : new Error("Clipboard command failed")));
+  });
+}
+
+function checkedText(text: string): string {
+  if (Buffer.byteLength(text, "utf8") > MAX_CLIPBOARD_TEXT_BYTES) {
+    throw new Error("Clipboard text is too large");
+  }
+  return text;
+}
+
+/** Read local graphical clipboard text without a shell or visible clipboard output. */
+export async function readClipboardText(options: ClipboardTextOptions = {}): Promise<string> {
+  const platform = options.platform ?? process.platform;
+  const env = options.env ?? process.env;
+  if (isRemoteSession(env)) throw new Error("Clipboard text paste is unavailable in a remote session");
+
+  const clipboard = options.nativeClipboard === undefined
+    ? await loadNativeClipboard()
+    : options.nativeClipboard;
+  if (clipboard) {
+    try {
+      return checkedText(await clipboard.getText());
+    } catch {
+      // Use a direct platform command when native clipboard access fails.
+    }
+  }
+
+  const runner = options.runner ?? runClipboardCommand;
+  if (platform === "win32") {
+    return checkedText(await runner("powershell.exe", [
+      "-NoLogo",
+      "-NoProfile",
+      "-NonInteractive",
+      "-STA",
+      "-Command",
+      WINDOWS_CLIPBOARD_TEXT_SCRIPT,
+    ]));
+  }
+  if (platform === "darwin") return checkedText(await runner("pbpaste", []));
+  if (platform === "linux" && env.WAYLAND_DISPLAY) {
+    return checkedText(await runner("wl-paste", ["--no-newline", "--type", "text"]));
+  }
+  if (platform === "linux" && env.DISPLAY) {
+    return checkedText(await runner("xclip", ["-selection", "clipboard", "-o"]));
+  }
+  throw new Error("No supported graphical clipboard is available");
+}

package/src/transcript.tsx

@@ -1,4 +1,10 @@
-import { StyledText, bold, fg, type MarkdownRenderable, type SyntaxStyle } from "@opentui/core";
+import {
+  StyledText,
+  TextAttributes,
+  fg,
+  type MarkdownRenderable,
+  type SyntaxStyle,
+} from "@opentui/core";
 import type { MarkdownProps } from "@opentui/react";
 import {
   useBlinkingText,
@@ -360,7 +366,10 @@ function rejectedDetail(theme: Theme, detail: string): StyledText {
     return new StyledText([fg(theme.rejection)(detail)]);
   }
   return new StyledText([
-    bold(fg(theme.rejection)(CHECK_MODE_HARD_BLOCK_PREFIX)),
+    {
+      ...fg(theme.rejection)(CHECK_MODE_HARD_BLOCK_PREFIX),
+      attributes: TextAttributes.BOLD,
+    },
     fg(theme.rejection)(detail.slice(CHECK_MODE_HARD_BLOCK_PREFIX.length)),
   ]);
 }
@@ -398,11 +407,7 @@ export function ToolLine({
 
   return (
     <box style={{ flexDirection: "column", width: "100%" }}>
-      <Row
-        glyph={GUTTER}
-        glyphColor={toolColor}
-        background={rejected ? theme.rejectionBg : undefined}
-      >
+      <Row glyph={GUTTER} glyphColor={toolColor}>
         <box style={{ flexDirection: "row", flexGrow: 1, flexShrink: 1, minWidth: 0 }}>
           {prefix ? <text content={prefix} selectable style={{ flexShrink: 0 }} /> : null}
           <text
@@ -430,7 +435,7 @@ export function ToolLine({
         </box>
       </Row>
       {rejected && call.detail ? (
-        <Row glyph={GUTTER} glyphColor={theme.rejection} background={theme.rejectionBg}>
+        <Row glyph={GUTTER} glyphColor={theme.rejection}>
           <text
             content={rejectedDetail(theme, call.detail)}
             selectable