@ridit/lens 0.3.7 → 0.3.9

package/src/tools/pdf.ts

@@ -1,164 +0,0 @@
-// Generates PDFs from markdown content — useful for exporting codebase reports and documentation.
-
-import path from "path";
-import { existsSync, mkdirSync, writeFileSync } from "fs";
-
-export async function generatePdf(
-  filePath: string,
-  content: string,
-  repoPath: string,
-): Promise<string> {
-  const fullPath = path.isAbsolute(filePath)
-    ? filePath
-    : path.join(repoPath, filePath);
-
-  try {
-    const dir = path.dirname(fullPath);
-    if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
-
-    const PDFDocument = require("pdfkit");
-    const doc = new PDFDocument({ margin: 72 });
-    const chunks: Buffer[] = [];
-
-    doc.on("data", (chunk: Buffer) => chunks.push(chunk));
-
-    return new Promise((resolve) => {
-      doc.on("end", () => {
-        try {
-          writeFileSync(fullPath, Buffer.concat(chunks));
-          resolve(`PDF generated: ${fullPath}`);
-        } catch (err) {
-          resolve(
-            `Error writing PDF: ${err instanceof Error ? err.message : String(err)}`,
-          );
-        }
-      });
-
-      doc.on("error", (err: Error) => {
-        resolve(`Error generating PDF: ${err.message}`);
-      });
-
-      const lines = content.split("\n");
-      let firstElement = true;
-
-      const addSpacingBefore = () => {
-        if (!firstElement) doc.moveDown(0.5);
-        firstElement = false;
-      };
-
-      const bullets: string[] = [];
-
-      const flushBullets = () => {
-        if (bullets.length === 0) return;
-        addSpacingBefore();
-        for (const bullet of bullets) {
-          doc
-            .fontSize(11)
-            .fillColor("#333333")
-            .text(`• ${bullet}`, { indent: 20, lineGap: 3 });
-        }
-        bullets.length = 0;
-      };
-
-      for (const raw of lines) {
-        const line = raw.trimEnd();
-
-        if (line.startsWith("# ")) {
-          flushBullets();
-          addSpacingBefore();
-          doc
-            .fontSize(22)
-            .fillColor("#000000")
-            .font("Helvetica-Bold")
-            .text(line.slice(2));
-          doc.moveDown(0.2);
-          doc
-            .moveTo(72, doc.y)
-            .lineTo(doc.page.width - 72, doc.y)
-            .strokeColor("#000000")
-            .lineWidth(1)
-            .stroke();
-          doc.moveDown(0.4);
-          doc.font("Helvetica");
-        } else if (line.startsWith("## ")) {
-          flushBullets();
-          addSpacingBefore();
-          doc
-            .fontSize(16)
-            .fillColor("#111111")
-            .font("Helvetica-Bold")
-            .text(line.slice(3));
-          doc.moveDown(0.2);
-          doc
-            .moveTo(72, doc.y)
-            .lineTo(doc.page.width - 72, doc.y)
-            .strokeColor("#999999")
-            .lineWidth(0.5)
-            .stroke();
-          doc.moveDown(0.3);
-          doc.font("Helvetica");
-        } else if (line.startsWith("### ")) {
-          flushBullets();
-          addSpacingBefore();
-          doc
-            .fontSize(13)
-            .fillColor("#222222")
-            .font("Helvetica-Bold")
-            .text(line.slice(4));
-          doc.font("Helvetica");
-        } else if (line.startsWith("- ") || line.startsWith("* ")) {
-          bullets.push(line.slice(2));
-        } else if (line.startsWith("---")) {
-          flushBullets();
-          doc.moveDown(0.5);
-          doc
-            .moveTo(72, doc.y)
-            .lineTo(doc.page.width - 72, doc.y)
-            .strokeColor("#cccccc")
-            .lineWidth(0.5)
-            .stroke();
-          doc.moveDown(0.5);
-        } else if (line === "") {
-          flushBullets();
-        } else {
-          flushBullets();
-          addSpacingBefore();
-          // handle inline bold (**text**) and inline code (`text`)
-          const segments = line.split(/(\*\*[^*]+\*\*|`[^`]+`)/g);
-          let isFirst = true;
-          for (const seg of segments) {
-            if (seg.startsWith("**") && seg.endsWith("**")) {
-              doc
-                .fontSize(11)
-                .fillColor("#333333")
-                .font("Helvetica-Bold")
-                .text(seg.slice(2, -2), { continued: true, lineGap: 3 });
-              doc.font("Helvetica");
-            } else if (seg.startsWith("`") && seg.endsWith("`")) {
-              doc
-                .fontSize(10)
-                .fillColor("#c0392b")
-                .font("Courier")
-                .text(seg.slice(1, -1), { continued: true, lineGap: 3 });
-              doc.font("Helvetica").fontSize(11).fillColor("#333333");
-            } else if (seg.length > 0) {
-              doc
-                .fontSize(11)
-                .fillColor("#333333")
-                .font("Helvetica")
-                .text(seg, { continued: true, lineGap: 3 });
-            }
-            isFirst = false;
-          }
-          // end the continued text
-          doc.text("", { continued: false });
-        }
-      }
-
-      flushBullets();
-      doc.end();
-    });
-  } catch (err) {
-    return `Error generating PDF: ${err instanceof Error ? err.message : String(err)}`;
-  }
-}

package/src/tools/shell.ts

@@ -1,96 +0,0 @@
-import { execSync } from "child_process";
-
-export async function runShell(command: string, cwd: string): Promise<string> {
-  return new Promise((resolve) => {
-    const { spawn } =
-      require("child_process") as typeof import("child_process");
-    const isWin = process.platform === "win32";
-    const shell = isWin ? "cmd.exe" : "/bin/sh";
-    const shellFlag = isWin ? "/c" : "-c";
-
-    const proc = spawn(shell, [shellFlag, command], {
-      cwd,
-      env: process.env,
-      stdio: ["ignore", "pipe", "pipe"],
-    });
-
-    const chunks: Buffer[] = [];
-    const errChunks: Buffer[] = [];
-
-    proc.stdout.on("data", (d: Buffer) => chunks.push(d));
-    proc.stderr.on("data", (d: Buffer) => errChunks.push(d));
-
-    const killTimer = setTimeout(
-      () => {
-        proc.kill();
-        resolve("(command timed out after 5 minutes)");
-      },
-      5 * 60 * 1000,
-    );
-
-    proc.on("close", (code: number | null) => {
-      clearTimeout(killTimer);
-      const stdout = Buffer.concat(chunks).toString("utf-8").trim();
-      const stderr = Buffer.concat(errChunks).toString("utf-8").trim();
-      const combined = [stdout, stderr].filter(Boolean).join("\n");
-      resolve(combined || (code === 0 ? "(no output)" : `exit code ${code}`));
-    });
-
-    proc.on("error", (err: Error) => {
-      clearTimeout(killTimer);
-      resolve(`Error: ${err.message}`);
-    });
-  });
-}
-
-export function readClipboard(): string {
-  try {
-    const platform = process.platform;
-    if (platform === "win32") {
-      return execSync("powershell -noprofile -command Get-Clipboard", {
-        encoding: "utf-8",
-        timeout: 2000,
-      })
-        .replace(/\r\n/g, "\n")
-        .trimEnd();
-    }
-    if (platform === "darwin") {
-      return execSync("pbpaste", {
-        encoding: "utf-8",
-        timeout: 2000,
-      }).trimEnd();
-    }
-    for (const cmd of [
-      "xclip -selection clipboard -o",
-      "xsel --clipboard --output",
-      "wl-paste",
-    ]) {
-      try {
-        return execSync(cmd, { encoding: "utf-8", timeout: 2000 }).trimEnd();
-      } catch {
-        continue;
-      }
-    }
-    return "";
-  } catch {
-    return "";
-  }
-}
-
-export function openUrl(url: string): string {
-  try {
-    const { execSync: exec } =
-      require("child_process") as typeof import("child_process");
-    const platform = process.platform;
-    if (platform === "win32") {
-      exec(`start "" "${url}"`, { stdio: "ignore" });
-    } else if (platform === "darwin") {
-      exec(`open "${url}"`, { stdio: "ignore" });
-    } else {
-      exec(`xdg-open "${url}"`, { stdio: "ignore" });
-    }
-    return `Opened: ${url}`;
-  } catch (err) {
-    return `Error opening URL: ${err instanceof Error ? err.message : String(err)}`;
-  }
-}

package/src/tools/view-image.ts

@@ -1,335 +0,0 @@
-// ── tools/view-image.ts ───────────────────────────────────────────────────────
-//
-// Display images in the terminal using the best available protocol:
-//
-//   1. iTerm2 inline image protocol (OSC 1337)
-//      Supported by: iTerm2, WezTerm, VSCode integrated terminal,
-//                    Windows Terminal (via some builds), Tabby, Hyper
-//
-//   2. Kitty graphics protocol
-//      Supported by: Kitty, WezTerm
-//
-//   3. Sixel
-//      Supported by: Windows Terminal 1.22+, xterm, mlterm, WezTerm
-//      Requires: chafa or img2sixel on PATH (auto-detected)
-//
-//   4. Half-block fallback via terminal-image
-//      Works everywhere that supports 256 colors.
-//      Quality is limited to block characters (▄▀) — better than nothing.
-//
-// Protocol is auto-detected from environment variables and terminal responses.
-// Can be overridden by passing "protocol" in the JSON input.
-
-import path from "path";
-import { existsSync, readFileSync } from "fs";
-import type { Tool } from "@ridit/lens-sdk";
-import { execSync } from "child_process";
-
-// ── input ─────────────────────────────────────────────────────────────────────
-
-type Protocol = "iterm2" | "kitty" | "sixel" | "halfblock" | "auto";
-
-interface ViewImageInput {
-  /** File path (repo-relative or absolute) or URL */
-  src: string;
-  /** Width: percentage "50%" or column count 40. Default "80%" */
-  width?: string | number;
-  /** Force a specific protocol instead of auto-detecting */
-  protocol?: Protocol;
-}
-
-function parseViewImageInput(body: string): ViewImageInput | null {
-  const trimmed = body.trim();
-  if (!trimmed) return null;
-
-  if (trimmed.startsWith("{")) {
-    try {
-      const p = JSON.parse(trimmed) as {
-        src?: string;
-        path?: string;
-        url?: string;
-        width?: string | number;
-        protocol?: Protocol;
-      };
-      const src = p.src ?? p.path ?? p.url ?? "";
-      if (!src) return null;
-      return { src, width: p.width ?? "80%", protocol: p.protocol ?? "auto" };
-    } catch {
-      return null;
-    }
-  }
-
-  return { src: trimmed, width: "80%", protocol: "auto" };
-}
-
-// ── fetch image bytes ─────────────────────────────────────────────────────────
-
-async function fetchBytes(src: string, repoPath: string): Promise<Buffer> {
-  if (src.startsWith("http://") || src.startsWith("https://")) {
-    const res = await fetch(src, { signal: AbortSignal.timeout(20_000) });
-    if (!res.ok) throw new Error(`HTTP ${res.status}: ${res.statusText}`);
-    return Buffer.from(await res.arrayBuffer());
-  }
-  const resolved = path.isAbsolute(src) ? src : path.join(repoPath, src);
-  if (!existsSync(resolved)) throw new Error(`File not found: ${resolved}`);
-  return readFileSync(resolved);
-}
-
-// ── protocol detection ────────────────────────────────────────────────────────
-
-function detectProtocol(): Exclude<Protocol, "auto"> {
-  const term = (process.env["TERM"] ?? "").toLowerCase();
-  const termProgram = (process.env["TERM_PROGRAM"] ?? "").toLowerCase();
-  const termEmulator = (process.env["TERM_EMULATOR"] ?? "").toLowerCase();
-
-  // Kitty
-  if (term === "xterm-kitty" || process.env["KITTY_WINDOW_ID"]) {
-    return "kitty";
-  }
-
-  // iTerm2
-  if (
-    termProgram === "iterm.app" ||
-    termProgram === "iterm2" ||
-    process.env["ITERM_SESSION_ID"]
-  ) {
-    return "iterm2";
-  }
-
-  // WezTerm — supports both kitty and iterm2; prefer kitty
-  if (termProgram === "wezterm" || process.env["WEZTERM_EXECUTABLE"]) {
-    return "kitty";
-  }
-
-  // VSCode integrated terminal — supports iTerm2 protocol
-  if (
-    process.env["TERM_PROGRAM"] === "vscode" ||
-    process.env["VSCODE_INJECTION"] ||
-    process.env["VSCODE_GIT_ASKPASS_NODE"]
-  ) {
-    return "iterm2";
-  }
-
-  // Windows Terminal 1.22+ supports Sixel
-  // WT_SESSION is set in Windows Terminal
-  if (process.env["WT_SESSION"]) {
-    // Check if chafa or img2sixel is available for sixel encoding
-    if (commandExists("chafa") || commandExists("img2sixel")) {
-      return "sixel";
-    }
-    // Fall through to halfblock — Windows Terminal also does colors fine
-  }
-
-  // Tabby / Hyper typically support iTerm2
-  if (termEmulator.includes("tabby") || termEmulator.includes("hyper")) {
-    return "iterm2";
-  }
-
-  // xterm with sixel support
-  if (term.includes("xterm") && commandExists("img2sixel")) {
-    return "sixel";
-  }
-
-  return "halfblock";
-}
-
-function commandExists(cmd: string): boolean {
-  try {
-    execSync(process.platform === "win32" ? `where ${cmd}` : `which ${cmd}`, {
-      stdio: "pipe",
-      timeout: 2000,
-    });
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-// ── renderers ─────────────────────────────────────────────────────────────────
-
-// iTerm2 inline image protocol (OSC 1337)
-function renderITerm2(buf: Buffer, width: string | number): string {
-  const b64 = buf.toString("base64");
-  const widthParam =
-    typeof width === "number" ? `width=${width}` : `width=${width}`;
-  // ESC ] 1337 ; File=inline=1;width=...: <base64> BEL
-  return `\x1b]1337;File=inline=1;${widthParam};preserveAspectRatio=1:${b64}\x07\n`;
-}
-
-// Kitty graphics protocol (APC, chunked base64)
-function renderKitty(buf: Buffer, width: string | number): string {
-  const b64 = buf.toString("base64");
-  const chunkSize = 4096;
-  const chunks: string[] = [];
-  for (let i = 0; i < b64.length; i += chunkSize) {
-    chunks.push(b64.slice(i, i + chunkSize));
-  }
-
-  const cols =
-    typeof width === "number"
-      ? width
-      : width.endsWith("%")
-        ? Math.floor((process.stdout.columns ?? 80) * (parseInt(width) / 100))
-        : parseInt(width);
-
-  let result = "";
-  chunks.forEach((chunk, idx) => {
-    const isLast = idx === chunks.length - 1;
-    const more = isLast ? 0 : 1;
-    if (idx === 0) {
-      // First chunk: f=100 (PNG), a=T (transmit+display), c=columns
-      result += `\x1b_Ga=T,f=100,m=${more},c=${cols};${chunk}\x1b\\`;
-    } else {
-      result += `\x1b_Gm=${more};${chunk}\x1b\\`;
-    }
-  });
-  return result + "\n";
-}
-
-// Sixel via chafa (preferred, auto-detects format) or img2sixel
-function renderSixel(
-  buf: Buffer,
-  src: string,
-  repoPath: string,
-  width: string | number,
-): string {
-  const widthCols =
-    typeof width === "number"
-      ? width
-      : width.endsWith("%")
-        ? Math.floor((process.stdout.columns ?? 80) * (parseInt(width) / 100))
-        : parseInt(width);
-
-  // Write buf to a temp file so we can pass it to CLI tools
-  const tmpPath = path.join(
-    process.env["TEMP"] ?? process.env["TMPDIR"] ?? "/tmp",
-    `lens_img_${Date.now()}.bin`,
-  );
-  const { writeFileSync, unlinkSync } = require("fs") as typeof import("fs");
-  writeFileSync(tmpPath, buf);
-
-  try {
-    if (commandExists("chafa")) {
-      const result = execSync(
-        `chafa --format sixel --size ${widthCols}x40 "${tmpPath}"`,
-        { encoding: "utf-8", stdio: ["pipe", "pipe", "pipe"], timeout: 15_000 },
-      );
-      return result + "\n";
-    }
-    if (commandExists("img2sixel")) {
-      const result = execSync(`img2sixel -w ${widthCols * 8} "${tmpPath}"`, {
-        encoding: "utf-8",
-        stdio: ["pipe", "pipe", "pipe"],
-        timeout: 15_000,
-      });
-      return result + "\n";
-    }
-    throw new Error("no sixel encoder found");
-  } finally {
-    try {
-      unlinkSync(tmpPath);
-    } catch {
-      /* ignore */
-    }
-  }
-}
-
-// Half-block fallback via terminal-image
-async function renderHalfBlock(
-  buf: Buffer,
-  width: string | number,
-): Promise<string> {
-  let terminalImage: any;
-  try {
-    terminalImage = await import("terminal-image");
-    terminalImage = terminalImage.default ?? terminalImage;
-  } catch {
-    return (
-      "Error: terminal-image not installed (npm install terminal-image).\n" +
-      "For better image display, install chafa: https://hpjansson.org/chafa/\n" +
-      "  Windows: winget install hpjansson.chafa\n" +
-      "  macOS:   brew install chafa\n" +
-      "  Linux:   sudo apt install chafa"
-    );
-  }
-  return await terminalImage.buffer(buf, {
-    width,
-    preserveAspectRatio: true,
-  });
-}
-
-// ── main render ───────────────────────────────────────────────────────────────
-
-async function renderImage(
-  input: ViewImageInput,
-  repoPath: string,
-): Promise<string> {
-  const buf = await fetchBytes(input.src, repoPath);
-  const width = input.width ?? "80%";
-  const protocol =
-    input.protocol === "auto" || !input.protocol
-      ? detectProtocol()
-      : input.protocol;
-
-  switch (protocol) {
-    case "iterm2":
-      return renderITerm2(buf, width);
-
-    case "kitty":
-      return renderKitty(buf, width);
-
-    case "sixel":
-      try {
-        return renderSixel(buf, input.src, repoPath, width);
-      } catch (e: any) {
-        // Sixel encoder missing — fall through to halfblock
-        return (
-          `(sixel encoder not found — install chafa for better quality)\n` +
-          (await renderHalfBlock(buf, width))
-        );
-      }
-
-    case "halfblock":
-    default:
-      return await renderHalfBlock(buf, width);
-  }
-}
-
-// ── tool ──────────────────────────────────────────────────────────────────────
-
-export const viewImageTool: Tool<ViewImageInput> = {
-  name: "view-image",
-  description:
-    "display an image in the terminal (auto-detects iTerm2/Kitty/Sixel/half-block)",
-  safe: true,
-  permissionLabel: "view image",
-
-  systemPromptEntry: (i) =>
-    [
-      `### ${i}. view-image — display an image in the terminal`,
-      `<view-image>screenshot.png</view-image>`,
-      `<view-image>https://example.com/banner.jpg</view-image>`,
-      `<view-image>{"src": "assets/logo.png", "width": "60%"}</view-image>`,
-      `<view-image>{"src": "photo.jpg", "width": "80%", "protocol": "iterm2"}</view-image>`,
-      `Protocols: auto (default), iterm2, kitty, sixel, halfblock`,
-      `Width: percentage "50%" or column count 40. Default "80%"`,
-      `Supported formats: PNG, JPG, GIF, WebP, BMP, TIFF`,
-    ].join("\n"),
-
-  parseInput: parseViewImageInput,
-
-  summariseInput: ({ src, width }) =>
-    `${path.basename(src)} (${width ?? "80%"})`,
-
-  execute: async (input, ctx) => {
-    try {
-      const ansi = await renderImage(input, ctx.repoPath);
-      return { kind: "image" as any, value: ansi };
-    } catch (err) {
-      return {
-        kind: "text",
-        value: `Error: ${err instanceof Error ? err.message : String(err)}`,
-      };
-    }
-  },
-};