@pellux/goodvibes-agent 0.1.0

package/src/types/grid.ts

@@ -0,0 +1,48 @@
+/**
+ * Cell - The atomic unit of the terminal surface grid.
+ */
+export interface Cell {
+  char: string;
+  fg: string;
+  bg: string;
+  bold: boolean;
+  dim: boolean;
+  underline: boolean;
+  italic: boolean;
+  strikethrough: boolean;
+  link?: string;
+}
+
+/**
+ * Line - A single horizontal row of Cells.
+ */
+export type Line = Cell[];
+
+export const createEmptyCell = (): Cell => ({
+  char: ' ',
+  fg: '',
+  bg: '',
+  bold: false,
+  dim: false,
+  underline: false,
+  italic: false,
+  strikethrough: false,
+});
+
+export const createEmptyLine = (width: number): Line =>
+  Array.from({ length: width }, createEmptyCell);
+
+/**
+ * createStyledCell - Create a Cell with all defaults, applying only the provided overrides.
+ */
+export const createStyledCell = (char: string, overrides: Partial<Omit<Cell, 'char'>> = {}): Cell => ({
+  char,
+  fg: overrides.fg ?? '',
+  bg: overrides.bg ?? '',
+  bold: overrides.bold ?? false,
+  dim: overrides.dim ?? false,
+  underline: overrides.underline ?? false,
+  italic: overrides.italic ?? false,
+  strikethrough: overrides.strikethrough ?? false,
+  link: overrides.link,
+});

package/src/types/sql-js.d.ts

@@ -0,0 +1,15 @@
+declare module 'sql.js' {
+  interface Database {
+    run(sql: string, params?: (string | number | Uint8Array | null)[]): void;
+    exec(sql: string, params?: (string | number)[]): Array<{ columns: string[]; values: unknown[][] }>;
+    export(): Uint8Array;
+    close(): void;
+  }
+
+  interface SqlJsStatic {
+    Database: new (data?: Uint8Array | Buffer) => Database;
+  }
+
+  function initSqlJs(): Promise<SqlJsStatic>;
+  export default initSqlJs;
+}

package/src/utils/clipboard.ts

@@ -0,0 +1,22 @@
+import { logger } from '@pellux/goodvibes-sdk/platform/utils';
+import { summarizeError } from '@pellux/goodvibes-sdk/platform/utils';
+import { allowTerminalWrite } from '../runtime/terminal-output-guard.ts';
+
+/**
+ * copyToClipboard - Uses OSC 52 escape sequence to copy text to the terminal clipboard.
+ * Terminal-specific: only works in terminals that support OSC 52.
+ */
+export function copyToClipboard(text: string) {
+  if (!text) return;
+  logger.info('Clipboard: Attempting to copy via OSC 52', { length: text.length });
+  try {
+    const base64 = Buffer.from(text).toString('base64');
+    const sequence = `\x1b]52;c;${base64}\x07`;
+    allowTerminalWrite(() => process.stdout.write(sequence));
+    logger.info('Clipboard: OSC 52 sequence written');
+  } catch (err: unknown) {
+    logger.error('Clipboard: OSC 52 copy failed', { error: summarizeError(err) });
+  }
+}
+
+export { pasteFromClipboard, pasteImageFromClipboard, MIN_IMAGE_BYTES } from '@pellux/goodvibes-sdk/platform/utils';

package/src/utils/splash-lines.ts

@@ -0,0 +1,46 @@
+import { center, getDisplayWidth } from './terminal-width.ts';
+import { VERSION } from '../version.ts';
+
+const ART_LINES = [
+  ' ██████╗    ██████╗    ██████╗   ██████╗   ██╗   ██╗  ██╗  ██████╗   ███████╗  ███████╗',
+  '██╔════╝   ██╔═══██╗  ██╔═══██╗  ██╔══██╗  ██║   ██║  ██║  ██╔══██╗  ██╔════╝  ██╔════╝',
+  '██║  ███╗  ██║   ██║  ██║   ██║  ██║  ██║  ██║   ██║  ██║  ██████╔╝  █████╗    ███████╗',
+  '██║   ██║  ██║   ██║  ██║   ██║  ██║  ██║  ╚██╗ ██╔╝  ██║  ██╔══██╗  ██╔══╝    ╚════██║',
+  '╚██████╔╝  ╚██████╔╝  ╚██████╔╝  ██████╔╝   ╚████╔╝   ██║  ██████╔╝  ███████╗  ███████║',
+  ' ╚═════╝    ╚═════╝    ╚═════╝   ╚═════╝     ╚═══╝    ╚═╝  ╚═════╝   ╚══════╝  ╚══════╝',
+] as const;
+
+const ART_W = Math.max(...ART_LINES.map((line) => getDisplayWidth(line)));
+const TOP_BORDER = '━'.repeat(ART_W);
+const SEPARATOR = '━'.repeat(ART_W);
+
+/**
+ * Audit Fix: Full-width English characters for vaporwave aesthetic.
+ * ｇｏｏｄ ｖｉｂｅｓ ・ Ａ Ｉ ・ いい雰囲気
+ */
+const TAGLINE = '[ ｇｏｏｄ ｖｉｂｅｓ ・ Ａ Ｉ ・ いい雰囲気 ]';
+
+const VERSION_LINE = `　✦　v${VERSION}　█　terminal AI assistant　█　自動ｺｰﾄﾞ 　✦`;
+
+export interface SplashOptions {
+  workingDir?: string;
+  model?: string;
+  provider?: string;
+  toolCount?: number;
+}
+
+export function getSplashLines(columns: number, opts: SplashOptions = {}): string[] {
+  const splashHint = 'start chatting or type /help for commands';
+  const lines: string[] = [
+    center(TOP_BORDER, columns),
+    ...ART_LINES.map((line) => center(line, columns)),
+    center(SEPARATOR, columns),
+    center(TAGLINE, columns),
+    center(VERSION_LINE, columns),
+    '',
+  ];
+
+  lines.push(center(splashHint, columns));
+
+  return lines;
+}

package/src/utils/terminal-width.ts

@@ -0,0 +1,185 @@
+/**
+ * Calculates the visual width of a string in the terminal.
+ * Handles CJK characters, emoji (including ZWJ sequences), and
+ * variation selectors correctly as double-width.
+ */
+export function getDisplayWidth(text: string): number {
+  let width = 0;
+  let i = 0;
+  while (i < text.length) {
+    const code = text.codePointAt(i)!;
+    const charLen = code > 0xFFFF ? 2 : 1;
+
+    if (code < 32 || code === 127) {
+      i += charLen;
+      continue;
+    }
+
+    if (
+      code === 0x200d ||
+      code === 0xfe0f ||
+      code === 0xfe0e ||
+      (code >= 0x0300 && code <= 0x036f) ||
+      (code >= 0x1ab0 && code <= 0x1aff) ||
+      (code >= 0x20d0 && code <= 0x20ff) ||
+      (code >= 0xfe20 && code <= 0xfe2f) ||
+      (code >= 0xe0100 && code <= 0xe01ef)
+    ) {
+      i += charLen;
+      continue;
+    }
+
+    if (
+      code === 0x2713 ||
+      code === 0x2717 ||
+      code === 0x2714 ||
+      code === 0x2718 ||
+      code === 0x2022 ||
+      code === 0x258d ||
+      (code >= 0x2500 && code <= 0x257f)
+    ) {
+      width += 1;
+      i += charLen;
+      continue;
+    }
+
+    if (
+      (code >= 0x1f300 && code <= 0x1f9ff) ||
+      (code >= 0x1fa00 && code <= 0x1faff) ||
+      (code >= 0x2600 && code <= 0x27bf) ||
+      (code >= 0x2300 && code <= 0x23ff) ||
+      (code >= 0x2b50 && code <= 0x2b55) ||
+      (code >= 0xfe00 && code <= 0xfe0f) ||
+      (code >= 0x1f000 && code <= 0x1f02f) ||
+      (code >= 0x1f680 && code <= 0x1f6ff) ||
+      code === 0x200d ||
+      (code >= 0xe000 && code <= 0xf8ff) ||
+      code === 0x2764 || code === 0x2763 ||
+      code === 0x270a || code === 0x270b || code === 0x270c ||
+      code === 0x261d || code === 0x2639 || code === 0x263a
+    ) {
+      width += 2;
+      i += charLen;
+      continue;
+    }
+
+    if (
+      (code >= 0x1100 && code <= 0x115f) ||
+      (code >= 0x2e80 && code <= 0xa4cf && code !== 0x303f) ||
+      (code >= 0xac00 && code <= 0xd7a3) ||
+      (code >= 0xf900 && code <= 0xfaff) ||
+      (code >= 0xff00 && code <= 0xff60) ||
+      (code >= 0x20000 && code <= 0x2fffd) ||
+      (code >= 0x30000 && code <= 0x3fffd)
+    ) {
+      width += 2;
+      i += charLen;
+      continue;
+    }
+
+    width += 1;
+    i += charLen;
+  }
+  return width;
+}
+
+export function center(text: string, width: number): string {
+  const displayWidth = getDisplayWidth(text);
+  if (displayWidth >= width) return text;
+  const left = Math.floor((width - displayWidth) / 2);
+  return ' '.repeat(left) + text;
+}
+
+export function truncateDisplay(text: string, width: number, ellipsis = '…'): string {
+  if (width <= 0) return '';
+  if (getDisplayWidth(text) <= width) return text;
+  const ellipsisWidth = getDisplayWidth(ellipsis);
+  if (ellipsisWidth >= width) return truncateDisplay(ellipsis, width, '');
+
+  let result = '';
+  let currentWidth = 0;
+  for (const char of text) {
+    const charWidth = getDisplayWidth(char);
+    if (currentWidth + charWidth + ellipsisWidth > width) break;
+    result += char;
+    currentWidth += charWidth;
+  }
+  return result + ellipsis;
+}
+
+export function padDisplayEnd(text: string, width: number): string {
+  const currentWidth = getDisplayWidth(text);
+  if (currentWidth >= width) return text;
+  return text + ' '.repeat(width - currentWidth);
+}
+
+export function fitDisplay(text: string, width: number, ellipsis = '…'): string {
+  return padDisplayEnd(truncateDisplay(text, width, ellipsis), width);
+}
+
+export function wrapText(text: string, width: number): string[] {
+  if (width <= 0) return [text];
+  const lines: string[] = [];
+  const paragraphs = text.split('\n');
+
+  for (const paragraph of paragraphs) {
+    if (paragraph.length === 0) {
+      lines.push('');
+      continue;
+    }
+
+    const words = paragraph.split(' ');
+    let currentLine = '';
+
+    for (const word of words) {
+      const wordWidth = getDisplayWidth(word);
+      const currentLineWidth = getDisplayWidth(currentLine);
+
+      if (wordWidth > width) {
+        if (currentLine) lines.push(currentLine);
+        let remaining = word;
+        while (getDisplayWidth(remaining) > width) {
+          let splitIdx = 0;
+          let currentWidth = 0;
+          for (let i = 0; i < remaining.length; i++) {
+            const charWidth = getDisplayWidth(remaining[i]!);
+            if (currentWidth + charWidth > width) break;
+            currentWidth += charWidth;
+            splitIdx = i + 1;
+          }
+          lines.push(remaining.slice(0, splitIdx));
+          remaining = remaining.slice(splitIdx);
+        }
+        currentLine = remaining;
+        continue;
+      }
+
+      if ((currentLineWidth + wordWidth + (currentLine ? 1 : 0)) <= width) {
+        currentLine += `${currentLine ? ' ' : ''}${word}`;
+      } else {
+        lines.push(currentLine);
+        currentLine = word;
+      }
+    }
+
+    if (currentLine) lines.push(currentLine);
+  }
+
+  return lines;
+}
+
+export function interpolateColor(startHex: string, endHex: string, factor: number): string {
+  const parse = (hex: string) => {
+    const r = parseInt(hex.slice(1, 3), 16);
+    const g = parseInt(hex.slice(3, 5), 16);
+    const b = parseInt(hex.slice(5, 7), 16);
+    return [r, g, b];
+  };
+
+  const [r1, g1, b1] = parse(startHex);
+  const [r2, g2, b2] = parse(endHex);
+  const r = Math.round(r1 + factor * (r2 - r1));
+  const g = Math.round(g1 + factor * (g2 - g1));
+  const b = Math.round(b1 + factor * (b2 - b1));
+  return `${r};${g};${b}`;
+}