@owloops/browserbird 1.0.2 → 1.0.4

package/src/config.ts

@@ -1,291 +0,0 @@
-/** @fileoverview Configuration loading from JSON with env: variable resolution. */
-
-import { readFileSync, writeFileSync, renameSync, existsSync } from 'node:fs';
-import { resolve } from 'node:path';
-import type { Config } from './core/types.ts';
-import { logger } from './core/logger.ts';
-
-const VALID_PROVIDERS = new Set<string>(['claude', 'opencode']);
-export const DEFAULTS: Config = {
-  timezone: 'UTC',
-  slack: {
-    botToken: '',
-    appToken: '',
-    requireMention: true,
-    coalesce: { debounceMs: 3000, bypassDms: true },
-    channels: ['*'],
-    quietHours: { enabled: false, start: '23:00', end: '08:00', timezone: 'UTC' },
-  },
-  agents: [
-    {
-      id: 'default',
-      name: 'BrowserBird',
-      provider: 'claude',
-      model: 'sonnet',
-      maxTurns: 50,
-      systemPrompt: 'You are responding in a Slack workspace. Be concise, helpful, and natural.',
-      channels: ['*'],
-    },
-  ],
-  sessions: {
-    ttlHours: 24,
-    maxConcurrent: 5,
-    processTimeoutMs: 300_000,
-  },
-  database: {
-    retentionDays: 30,
-  },
-  browser: {
-    enabled: false,
-    mcpConfigPath: undefined,
-    vncPort: 5900,
-    novncPort: 6080,
-    novncHost: 'localhost',
-  },
-  birds: { maxAttempts: 3 },
-  web: { enabled: true, host: '127.0.0.1', port: 18800, corsOrigin: '' },
-};
-
-/**
- * Resolves `"env:VAR_NAME"` strings to their environment variable values.
- * Throws if the env var is not set.
- */
-function resolveEnvValue(value: unknown): unknown {
-  if (typeof value === 'string' && value.startsWith('env:')) {
-    const envKey = value.slice(4);
-    const envValue = process.env[envKey];
-    if (envValue == null) {
-      throw new Error(`Environment variable ${envKey} is not set (referenced as "${value}")`);
-    }
-    return envValue;
-  }
-  if (Array.isArray(value)) {
-    return value.map(resolveEnvValue);
-  }
-  if (value !== null && typeof value === 'object') {
-    return resolveEnvValues(value as Record<string, unknown>);
-  }
-  return value;
-}
-
-function resolveEnvValues(obj: Record<string, unknown>): Record<string, unknown> {
-  const resolved: Record<string, unknown> = {};
-  for (const [key, value] of Object.entries(obj)) {
-    resolved[key] = resolveEnvValue(value);
-  }
-  return resolved;
-}
-
-export function deepMerge(
-  target: Record<string, unknown>,
-  source: Record<string, unknown>,
-): Record<string, unknown> {
-  const result = { ...target };
-  for (const [key, value] of Object.entries(source)) {
-    const targetValue = target[key];
-    if (
-      value !== null &&
-      typeof value === 'object' &&
-      !Array.isArray(value) &&
-      targetValue !== null &&
-      typeof targetValue === 'object' &&
-      !Array.isArray(targetValue)
-    ) {
-      result[key] = deepMerge(
-        targetValue as Record<string, unknown>,
-        value as Record<string, unknown>,
-      );
-    } else {
-      result[key] = value;
-    }
-  }
-  return result;
-}
-
-/**
- * Loads configuration from a JSON file, merges with defaults, and resolves env: references.
- * Searches for browserbird.json in the current directory, then falls back to defaults.
- */
-export function loadConfig(configPath?: string): Config {
-  const filePath = configPath ?? resolve('browserbird.json');
-
-  if (!existsSync(filePath)) {
-    logger.warn(`no config file found at ${filePath}, using defaults`);
-    return DEFAULTS;
-  }
-
-  logger.info(`loading config from ${filePath}`);
-  const raw = readFileSync(filePath, 'utf-8');
-
-  let parsed: Record<string, unknown>;
-  try {
-    parsed = JSON.parse(raw) as Record<string, unknown>;
-  } catch {
-    throw new Error(`Failed to parse config file: ${filePath}`);
-  }
-
-  const merged = deepMerge(DEFAULTS as unknown as Record<string, unknown>, parsed);
-  const resolved = resolveEnvValues(merged);
-  const config = resolved as unknown as Config;
-
-  validateConfig(config);
-
-  return config;
-}
-
-/** Validates merged config and throws on invalid values, warns on risky combinations. */
-function validateConfig(config: Config): void {
-  if (!Array.isArray(config.agents) || config.agents.length === 0) {
-    throw new Error('at least one agent must be configured');
-  }
-
-  for (const agent of config.agents) {
-    if (!agent.id || !agent.name) {
-      throw new Error('each agent must have an "id" and "name"');
-    }
-    if (!VALID_PROVIDERS.has(agent.provider)) {
-      throw new Error(
-        `agent "${agent.id}": unknown provider "${agent.provider}" (expected: ${[...VALID_PROVIDERS].join(', ')})`,
-      );
-    }
-    if (!agent.model) {
-      throw new Error(`agent "${agent.id}": "model" is required`);
-    }
-    if (!Array.isArray(agent.channels) || agent.channels.length === 0) {
-      throw new Error(`agent "${agent.id}": "channels" must be a non-empty array`);
-    }
-    if (agent.fallbackModel && agent.fallbackModel === agent.model) {
-      throw new Error(
-        `agent "${agent.id}": fallbackModel cannot be the same as model ("${agent.model}")`,
-      );
-    }
-  }
-
-  const browserMode = process.env['BROWSER_MODE'] ?? 'persistent';
-  if (config.browser.enabled && browserMode === 'persistent' && config.sessions.maxConcurrent > 1) {
-    logger.warn(
-      'persistent browser mode with maxConcurrent > 1 will cause lock contention; use "isolated" or set maxConcurrent to 1',
-    );
-  }
-}
-
-/**
- * Reads and merges JSON config with DEFAULTS but skips env: resolution.
- * Returns raw config data suitable for reading/modifying before writing back.
- */
-export function loadRawConfig(configPath?: string): Record<string, unknown> {
-  const filePath = configPath ?? resolve('browserbird.json');
-  if (!existsSync(filePath)) {
-    return JSON.parse(JSON.stringify(DEFAULTS)) as Record<string, unknown>;
-  }
-  const raw = readFileSync(filePath, 'utf-8');
-  let parsed: Record<string, unknown>;
-  try {
-    parsed = JSON.parse(raw) as Record<string, unknown>;
-  } catch {
-    throw new Error(`Failed to parse config file: ${filePath}`);
-  }
-  return deepMerge(DEFAULTS as unknown as Record<string, unknown>, parsed);
-}
-
-/**
- * Checks whether both Slack tokens are present and resolvable.
- * Literal strings must be non-empty; `"env:VAR"` references must point to a set env var.
- */
-export function hasSlackTokens(configPath?: string): boolean {
-  const filePath = configPath ?? resolve('browserbird.json');
-  if (!existsSync(filePath)) return false;
-
-  let parsed: Record<string, unknown>;
-  try {
-    parsed = JSON.parse(readFileSync(filePath, 'utf-8')) as Record<string, unknown>;
-  } catch {
-    return false;
-  }
-
-  const slack = parsed['slack'] as Record<string, unknown> | undefined;
-  if (!slack) return false;
-
-  return isTokenResolvable(slack['botToken']) && isTokenResolvable(slack['appToken']);
-}
-
-function isTokenResolvable(value: unknown): boolean {
-  if (typeof value !== 'string' || !value) return false;
-  if (value.startsWith('env:')) {
-    const envKey = value.slice(4);
-    return !!process.env[envKey];
-  }
-  return true;
-}
-
-/** Atomic write: writes to a .tmp file then renames over the target. */
-export function saveConfig(configPath: string, data: Record<string, unknown>): void {
-  const tmp = configPath + '.tmp';
-  writeFileSync(tmp, JSON.stringify(data, null, 2) + '\n', 'utf-8');
-  renameSync(tmp, configPath);
-}
-
-/**
- * Reads an existing .env file, updates/appends entries, and writes atomically.
- * Preserves comments, blank lines, and ordering of existing entries.
- */
-export function saveEnvFile(envPath: string, vars: Record<string, string>): void {
-  const remaining = new Map(Object.entries(vars));
-  const lines: string[] = [];
-
-  if (existsSync(envPath)) {
-    const content = readFileSync(envPath, 'utf-8');
-    for (const line of content.split('\n')) {
-      const trimmed = line.trim();
-      if (!trimmed || trimmed.startsWith('#')) {
-        lines.push(line);
-        continue;
-      }
-      const eqIdx = trimmed.indexOf('=');
-      if (eqIdx === -1) {
-        lines.push(line);
-        continue;
-      }
-      const key = trimmed.slice(0, eqIdx).trim();
-      if (remaining.has(key)) {
-        lines.push(`${key}=${remaining.get(key)}`);
-        remaining.delete(key);
-      } else {
-        lines.push(line);
-      }
-    }
-  }
-
-  for (const [key, value] of remaining) {
-    lines.push(`${key}=${value}`);
-  }
-
-  const finalContent = lines.join('\n').replace(/\n{3,}/g, '\n\n');
-  const tmp = envPath + '.tmp';
-  writeFileSync(tmp, finalContent.endsWith('\n') ? finalContent : finalContent + '\n', 'utf-8');
-  renameSync(tmp, envPath);
-}
-
-/**
- * Reads a .env file and injects entries into process.env.
- * Handles comments, blank lines, and optionally quoted values.
- */
-export function loadDotEnv(envPath: string): void {
-  if (!existsSync(envPath)) return;
-  const content = readFileSync(envPath, 'utf-8');
-  for (const line of content.split('\n')) {
-    const trimmed = line.trim();
-    if (!trimmed || trimmed.startsWith('#')) continue;
-    const eqIdx = trimmed.indexOf('=');
-    if (eqIdx === -1) continue;
-    const key = trimmed.slice(0, eqIdx).trim();
-    let value = trimmed.slice(eqIdx + 1).trim();
-    if (
-      (value.startsWith('"') && value.endsWith('"')) ||
-      (value.startsWith("'") && value.endsWith("'"))
-    ) {
-      value = value.slice(1, -1);
-    }
-    process.env[key] = value;
-  }
-}

package/src/core/logger.ts

@@ -1,78 +0,0 @@
-/** @fileoverview Structured logger. Writes to stderr, respects NO_COLOR. */
-
-import { styleText } from 'node:util';
-
-function shouldUseColor(): boolean {
-  if (process.env['NO_COLOR'] !== undefined) return false;
-  if (process.env['TERM'] === 'dumb') return false;
-  if (process.argv.includes('--no-color')) return false;
-  return process.stderr.isTTY === true;
-}
-
-const useColor = shouldUseColor();
-
-function style(format: string | string[], text: string): string {
-  if (!useColor) return text;
-  return styleText(format as Parameters<typeof styleText>[0], text);
-}
-
-const LOG_LEVELS = {
-  ERROR: 0,
-  WARN: 1,
-  INFO: 2,
-  DEBUG: 3,
-} as const;
-
-type LogLevel = (typeof LOG_LEVELS)[keyof typeof LOG_LEVELS];
-
-let currentLevel: LogLevel = LOG_LEVELS.INFO;
-
-function timestamp(): string {
-  return new Date().toISOString().slice(11, 23);
-}
-
-function write(prefix: string, message: string): void {
-  process.stderr.write(`${style('dim', timestamp())} ${prefix} ${message}\n`);
-}
-
-export const logger = {
-  error(message: string): void {
-    if (currentLevel >= LOG_LEVELS.ERROR) {
-      write(style('red', '[error]'), message);
-    }
-  },
-
-  warn(message: string): void {
-    if (currentLevel >= LOG_LEVELS.WARN) {
-      write(style('yellow', '[warn]'), message);
-    }
-  },
-
-  info(message: string): void {
-    if (currentLevel >= LOG_LEVELS.INFO) {
-      write(style('blue', '[info]'), message);
-    }
-  },
-
-  debug(message: string): void {
-    if (currentLevel >= LOG_LEVELS.DEBUG) {
-      write(style('dim', '[debug]'), message);
-    }
-  },
-
-  success(message: string): void {
-    if (currentLevel >= LOG_LEVELS.INFO) {
-      write(style('green', '[ok]'), message);
-    }
-  },
-
-  setLevel(level: 'error' | 'warn' | 'info' | 'debug'): void {
-    const map: Record<string, LogLevel> = {
-      error: LOG_LEVELS.ERROR,
-      warn: LOG_LEVELS.WARN,
-      info: LOG_LEVELS.INFO,
-      debug: LOG_LEVELS.DEBUG,
-    };
-    currentLevel = map[level] ?? LOG_LEVELS.INFO;
-  },
-};

package/src/core/redact.ts

@@ -1,75 +0,0 @@
-/** @fileoverview Output redaction: scrubs known secrets and token patterns from agent output. */
-
-const REDACTED = '[redacted]';
-
-const SENSITIVE_NAME_RE = /KEY|SECRET|TOKEN|PASSWORD/i;
-
-/**
- * Token prefix patterns. Each entry is [prefix, minLength] where minLength
- * is the shortest plausible token including the prefix (avoids false positives
- * on short strings that happen to start with a prefix).
- */
-const TOKEN_PATTERNS: Array<[string, number]> = [
-  ['xoxb-', 20],
-  ['xapp-', 20],
-  ['sk-ant-api', 20],
-  ['sk-ant-oat', 20],
-  ['sk-or-', 20],
-];
-
-let knownSecrets: string[] | undefined;
-
-function collectSecrets(): string[] {
-  const secrets: string[] = [];
-  for (const [name, value] of Object.entries(process.env)) {
-    if (value && SENSITIVE_NAME_RE.test(name) && value.length >= 8) {
-      secrets.push(value);
-    }
-  }
-  secrets.sort((a, b) => b.length - a.length);
-  return secrets;
-}
-
-function getSecrets(): string[] {
-  if (!knownSecrets) {
-    knownSecrets = collectSecrets();
-  }
-  return knownSecrets;
-}
-
-/** Re-collects secrets from process.env. Call after env changes (e.g. onboarding). */
-export function refreshSecrets(): void {
-  knownSecrets = collectSecrets();
-}
-
-function escapeForRegex(s: string): string {
-  return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
-}
-
-function buildPatternRegex(): RegExp {
-  const parts = TOKEN_PATTERNS.map(([prefix, minLength]) => {
-    const escaped = escapeForRegex(prefix);
-    const remaining = minLength - prefix.length;
-    return `${escaped}[A-Za-z0-9_\\-]{${remaining},}`;
-  });
-  return new RegExp(parts.join('|'), 'g');
-}
-
-const patternRegex = buildPatternRegex();
-
-/** Replaces known secret values and token patterns in text with [redacted]. */
-export function redact(text: string): string {
-  if (!text) return text;
-
-  let result = text;
-
-  for (const secret of getSecrets()) {
-    if (result.includes(secret)) {
-      result = result.replaceAll(secret, REDACTED);
-    }
-  }
-
-  result = result.replace(patternRegex, REDACTED);
-
-  return result;
-}

package/src/core/types.ts

@@ -1,83 +0,0 @@
-/** @fileoverview Shared interfaces and type definitions for BrowserBird. */
-
-import type { ProviderName } from '../provider/types.ts';
-
-export interface SlackConfig {
-  botToken: string;
-  appToken: string;
-  requireMention: boolean;
-  coalesce: {
-    debounceMs: number;
-    bypassDms: boolean;
-  };
-  channels: string[];
-  quietHours: {
-    enabled: boolean;
-    start: string;
-    end: string;
-    timezone: string;
-  };
-}
-
-export interface AgentConfig {
-  id: string;
-  name: string;
-  provider: ProviderName;
-  model: string;
-  fallbackModel?: string;
-  maxTurns: number;
-  systemPrompt: string;
-  channels: string[];
-  processTimeoutMs?: number;
-}
-
-export interface SessionsConfig {
-  ttlHours: number;
-  maxConcurrent: number;
-  processTimeoutMs: number;
-}
-
-export interface BrowserConfig {
-  enabled: boolean;
-  mcpConfigPath: string | undefined;
-  vncPort: number;
-  novncPort: number;
-  novncHost: string;
-}
-
-export interface DatabaseConfig {
-  retentionDays: number;
-}
-
-export interface BirdsConfig {
-  maxAttempts: number;
-}
-
-export interface WebConfig {
-  enabled: boolean;
-  host: string;
-  port: number;
-  corsOrigin: string;
-}
-
-export interface Config {
-  timezone: string;
-  slack: SlackConfig;
-  agents: AgentConfig[];
-  sessions: SessionsConfig;
-  database: DatabaseConfig;
-  browser: BrowserConfig;
-  birds: BirdsConfig;
-  web: WebConfig;
-}
-
-export const COMMANDS = {
-  SESSIONS: 'sessions',
-  BIRDS: 'birds',
-  CONFIG: 'config',
-  LOGS: 'logs',
-  JOBS: 'jobs',
-  DOCTOR: 'doctor',
-} as const;
-
-export type Command = (typeof COMMANDS)[keyof typeof COMMANDS];

package/src/core/uid.ts

@@ -1,26 +0,0 @@
-/** @fileoverview Prefixed short ID generation (PocketBase/Motebase pattern). */
-
-import { randomBytes } from 'node:crypto';
-
-const ALPHABET = 'abcdefghijklmnopqrstuvwxyz0123456789';
-
-export const UID_PREFIX = {
-  bird: 'br_',
-  flight: 'fl_',
-  session: 'ss_',
-} as const;
-
-export function generateUid(prefix: string): string {
-  const bytes = randomBytes(15);
-  let id = prefix;
-  for (let i = 0; i < 15; i++) {
-    id += ALPHABET[bytes[i]! % 36];
-  }
-  return id;
-}
-
-export function shortUid(uid: string): string {
-  const i = uid.indexOf('_');
-  if (i === -1) return uid.slice(0, 10);
-  return uid.slice(0, i + 1 + 7);
-}

package/src/core/utils.ts

@@ -1,137 +0,0 @@
-/** @fileoverview Shared utilities: formatting, time ranges, and CLI table output. */
-
-const BIRD_NAME_MAX_LENGTH = 50;
-
-export function formatDuration(ms: number): string {
-  const totalSeconds = Math.round(ms / 1000);
-  const minutes = Math.floor(totalSeconds / 60);
-  const seconds = totalSeconds % 60;
-  if (minutes === 0) return `${seconds}s`;
-  return `${minutes}m ${seconds}s`;
-}
-
-export function deriveBirdName(prompt: string): string {
-  return prompt.trim().slice(0, BIRD_NAME_MAX_LENGTH);
-}
-
-/**
- * Returns true if the current time in the given timezone falls within a HH:MM time range.
- * Handles wrap-around ranges (e.g. 22:00-06:00 spanning midnight).
- */
-export function isWithinTimeRange(
-  start: string,
-  end: string,
-  date: Date,
-  timezone: string,
-): boolean {
-  const parts = new Intl.DateTimeFormat('en-US', {
-    timeZone: timezone,
-    hour: 'numeric',
-    minute: 'numeric',
-    hour12: false,
-  }).formatToParts(date);
-
-  const h = Number(parts.find((p) => p.type === 'hour')?.value ?? 0);
-  const m = Number(parts.find((p) => p.type === 'minute')?.value ?? 0);
-  const nowMinutes = h * 60 + m;
-
-  const startMinutes = parseHHMM(start);
-  const endMinutes = parseHHMM(end);
-
-  if (startMinutes <= endMinutes) {
-    return nowMinutes >= startMinutes && nowMinutes < endMinutes;
-  }
-  return nowMinutes >= startMinutes || nowMinutes < endMinutes;
-}
-
-function parseHHMM(s: string): number {
-  const [hh, mm] = s.split(':');
-  const h = Number(hh);
-  const m = Number(mm ?? 0);
-  if (!Number.isFinite(h) || !Number.isFinite(m)) return 0;
-  return h * 60 + m;
-}
-
-// eslint-disable-next-line no-control-regex
-const ANSI_RE = /\x1b\[[0-9;]*m/g;
-
-function visibleLength(s: string): number {
-  return s.replace(ANSI_RE, '').length;
-}
-
-/** Print a formatted table with auto-calculated column widths to stdout. */
-export function printTable(
-  headers: string[],
-  rows: string[][],
-  maxWidths?: Array<number | undefined>,
-): void {
-  const widths = headers.map((h) => h.length);
-
-  for (const row of rows) {
-    for (let i = 0; i < row.length; i++) {
-      const cellLen = visibleLength(row[i] ?? '');
-      const maxW = maxWidths?.[i];
-      const capped = maxW != null ? Math.min(cellLen, maxW) : cellLen;
-      widths[i] = Math.max(widths[i] ?? 0, capped);
-    }
-  }
-
-  function pad(s: string, width: number, max?: number): string {
-    const vis = visibleLength(s);
-    const truncated = max != null && vis > max ? s.slice(0, max - 3) + '...' : s;
-    const padLen = width - visibleLength(truncated);
-    return padLen > 0 ? truncated + ' '.repeat(padLen) : truncated;
-  }
-
-  const indent = '  ';
-  console.log(indent + headers.map((h, i) => pad(h, widths[i]!)).join('  '));
-  console.log(indent + widths.map((w) => '-'.repeat(w)).join('  '));
-  for (const row of rows) {
-    console.log(
-      indent + row.map((cell, i) => pad(cell ?? '', widths[i]!, maxWidths?.[i])).join('  '),
-    );
-  }
-}
-
-function levenshtein(a: string, b: string): number {
-  const m = a.length;
-  const n = b.length;
-  const dp: number[][] = Array.from({ length: m + 1 }, () =>
-    Array.from({ length: n + 1 }, () => 0),
-  );
-  for (let i = 0; i <= m; i++) dp[i]![0] = i;
-  for (let j = 0; j <= n; j++) dp[0]![j] = j;
-  for (let i = 1; i <= m; i++) {
-    for (let j = 1; j <= n; j++) {
-      const cost = a[i - 1] === b[j - 1] ? 0 : 1;
-      dp[i]![j] = Math.min(dp[i - 1]![j]! + 1, dp[i]![j - 1]! + 1, dp[i - 1]![j - 1]! + cost);
-    }
-  }
-  return dp[m]![n]!;
-}
-
-export function unknownSubcommand(
-  subcommand: string,
-  command: string,
-  validCommands?: string[],
-): void {
-  const label = command ? 'subcommand' : 'command';
-  process.stderr.write(`error: unknown ${label}: ${subcommand}\n`);
-  if (validCommands && validCommands.length > 0) {
-    let bestMatch = '';
-    let bestDist = Infinity;
-    for (const cmd of validCommands) {
-      const dist = levenshtein(subcommand, cmd);
-      if (dist < bestDist) {
-        bestDist = dist;
-        bestMatch = cmd;
-      }
-    }
-    if (bestDist <= 2 && bestMatch) {
-      process.stderr.write(`did you mean '${bestMatch}'?\n`);
-    }
-  }
-  const helpCmd = command ? `browserbird ${command} --help` : 'browserbird --help';
-  process.stderr.write(`run '${helpCmd}' for usage\n`);
-  process.exitCode = 1;
-}