@owloops/browserbird 1.0.1 → 1.0.3

package/src/cli/jobs.ts

@@ -1,166 +0,0 @@
-/** @fileoverview Jobs command: inspect and manage the job queue. */
-
-import { parseArgs } from 'node:util';
-import { logger } from '../core/logger.ts';
-import { printTable, unknownSubcommand } from '../core/utils.ts';
-import { c } from './style.ts';
-import {
-  openDatabase,
-  closeDatabase,
-  listJobs,
-  getJobStats,
-  retryJob,
-  retryAllFailedJobs,
-  deleteJob,
-  clearJobs,
-  resolveDbPathFromArgv,
-} from '../db/index.ts';
-
-export const JOBS_HELP = `
-${c('cyan', 'usage:')} browserbird jobs [subcommand] [options]
-
-inspect and manage the job queue.
-
-${c('dim', 'subcommands:')}
-
-  ${c('cyan', 'list')}             list job queue entries (default)
-  ${c('cyan', 'stats')}            show job queue statistics
-  ${c('cyan', 'retry')} <id>       retry a failed job (or --all-failed)
-  ${c('cyan', 'delete')} <id>      delete a job
-  ${c('cyan', 'clear')}            clear completed or failed jobs
-
-${c('dim', 'options:')}
-
-  ${c('yellow', '--status')} <s>     filter by status: pending, running, completed, failed (with list)
-  ${c('yellow', '--name')} <s>       filter by job name (with list)
-  ${c('yellow', '--all-failed')}     retry all failed jobs (with retry)
-  ${c('yellow', '--completed')}      clear completed jobs (with clear)
-  ${c('yellow', '--failed')}         clear failed jobs (with clear)
-  ${c('yellow', '--json')}           output as JSON (with list, stats)
-  ${c('yellow', '--db')} <path>      database file path (env: BROWSERBIRD_DB)
-  ${c('yellow', '--config')} <path>  config file path
-  ${c('yellow', '-h, --help')}       show this help
-`.trim();
-
-export function handleJobs(argv: string[]): void {
-  const { values, positionals } = parseArgs({
-    args: argv,
-    options: {
-      status: { type: 'string' },
-      name: { type: 'string' },
-      'all-failed': { type: 'boolean', default: false },
-      completed: { type: 'boolean', default: false },
-      failed: { type: 'boolean', default: false },
-      json: { type: 'boolean', default: false },
-    },
-    allowPositionals: true,
-    strict: false,
-  });
-
-  const subcommand = positionals[0] ?? 'list';
-  openDatabase(resolveDbPathFromArgv(argv));
-  try {
-    switch (subcommand) {
-      case 'list': {
-        const result = listJobs(1, 100, {
-          status: values.status as string | undefined,
-          name: values.name as string | undefined,
-        });
-        if (values.json) {
-          console.log(JSON.stringify(result.items, null, 2));
-          break;
-        }
-        console.log(`jobs (${result.totalItems} total):`);
-        if (result.items.length === 0) {
-          console.log('\n  no jobs found');
-          return;
-        }
-        console.log('');
-        const rows = result.items.map((job) => [
-          String(job.id),
-          job.status,
-          job.name,
-          `${job.attempts}/${job.max_attempts}`,
-          job.created_at.slice(0, 19),
-          job.error ?? '',
-        ]);
-        printTable(['id', 'status', 'name', 'attempts', 'created', 'error'], rows, [
-          undefined,
-          undefined,
-          30,
-          undefined,
-          undefined,
-          40,
-        ]);
-        break;
-      }
-      case 'stats': {
-        const stats = getJobStats();
-        if (values.json) {
-          console.log(JSON.stringify(stats, null, 2));
-          break;
-        }
-        console.log('job queue statistics');
-        console.log('');
-        console.log(`  pending:    ${stats.pending}`);
-        console.log(`  running:    ${stats.running}`);
-        console.log(`  completed:  ${stats.completed}`);
-        console.log(`  failed:     ${stats.failed}`);
-        console.log('              --');
-        console.log(`  total:      ${stats.total}`);
-        break;
-      }
-      case 'retry': {
-        if (values['all-failed']) {
-          const count = retryAllFailedJobs();
-          logger.success(`reset ${count} failed job(s) to pending`);
-          return;
-        }
-        const id = Number(positionals[1]);
-        if (!Number.isFinite(id)) {
-          logger.error('usage: browserbird jobs retry <id> | --all-failed');
-          process.exitCode = 1;
-          return;
-        }
-        if (retryJob(id)) {
-          logger.success(`job #${id} reset to pending`);
-        } else {
-          logger.error(`job #${id} not found or not in failed state`);
-          process.exitCode = 1;
-        }
-        break;
-      }
-      case 'delete': {
-        const id = Number(positionals[1]);
-        if (!Number.isFinite(id)) {
-          logger.error('usage: browserbird jobs delete <id>');
-          process.exitCode = 1;
-          return;
-        }
-        if (deleteJob(id)) {
-          logger.success(`job #${id} deleted`);
-        } else {
-          logger.error(`job #${id} not found`);
-          process.exitCode = 1;
-        }
-        break;
-      }
-      case 'clear': {
-        if (!values.completed && !values.failed) {
-          logger.error('usage: browserbird jobs clear --completed | --failed');
-          process.exitCode = 1;
-          return;
-        }
-        let total = 0;
-        if (values.completed) total += clearJobs('completed');
-        if (values.failed) total += clearJobs('failed');
-        logger.success(`cleared ${total} job(s)`);
-        break;
-      }
-      default:
-        unknownSubcommand(subcommand, 'jobs', ['stats', 'retry', 'delete', 'clear']);
-    }
-  } finally {
-    closeDatabase();
-  }
-}

package/src/cli/logs.ts

@@ -1,67 +0,0 @@
-/** @fileoverview Logs command: show recent log entries from the database. */
-
-import { parseArgs } from 'node:util';
-import { logger } from '../core/logger.ts';
-import { printTable } from '../core/utils.ts';
-import { c } from './style.ts';
-import { openDatabase, closeDatabase, getRecentLogs, resolveDbPathFromArgv } from '../db/index.ts';
-
-export const LOGS_HELP = `
-${c('cyan', 'usage:')} browserbird logs [options]
-
-show recent log entries (default: error level).
-
-${c('dim', 'options:')}
-
-  ${c('yellow', '--level')} <lvl>    filter by level: error, warn, info (default: error)
-  ${c('yellow', '--limit')} <n>      number of entries to show (default: 20)
-  ${c('yellow', '--json')}           output as JSON
-  ${c('yellow', '--db')} <path>      database file path (env: BROWSERBIRD_DB)
-  ${c('yellow', '--config')} <path>  config file path
-  ${c('yellow', '-h, --help')}       show this help
-`.trim();
-
-export function handleLogs(argv: string[]): void {
-  const { values } = parseArgs({
-    args: argv,
-    options: {
-      level: { type: 'string' },
-      limit: { type: 'string' },
-      json: { type: 'boolean', default: false },
-    },
-    allowPositionals: true,
-    strict: false,
-  });
-
-  const level = values.level as string | undefined;
-  const perPage = values.limit != null ? Number(values.limit) : 20;
-  if (!Number.isFinite(perPage) || perPage < 1) {
-    logger.error('--limit must be a positive number');
-    process.exitCode = 1;
-    return;
-  }
-
-  openDatabase(resolveDbPathFromArgv(argv));
-  try {
-    const result = getRecentLogs(1, perPage, level ?? 'error');
-    if (values.json) {
-      console.log(JSON.stringify(result.items, null, 2));
-      return;
-    }
-    console.log(`logs (${result.totalItems} total, showing ${result.items.length}):`);
-    if (result.items.length === 0) {
-      console.log('\n  no logs recorded');
-      return;
-    }
-    console.log('');
-    const rows = result.items.map((entry) => [
-      entry.created_at.slice(11, 19),
-      entry.level,
-      entry.source,
-      entry.message,
-    ]);
-    printTable(['time', 'level', 'source', 'message'], rows, [undefined, undefined, undefined, 80]);
-  } finally {
-    closeDatabase();
-  }
-}

package/src/cli/run.ts

@@ -1,148 +0,0 @@
-/** @fileoverview CLI entry point: argument parsing and command routing. */
-
-import { parseArgs } from 'node:util';
-import type { Command } from '../core/types.ts';
-import { COMMANDS } from '../core/types.ts';
-import { logger } from '../core/logger.ts';
-import { unknownSubcommand } from '../core/utils.ts';
-import { startDaemon } from '../daemon.ts';
-import { BANNER, VERSION } from './banner.ts';
-import { c } from './style.ts';
-import { handleSessions } from './sessions.ts';
-import { SESSIONS_HELP } from './sessions.ts';
-import { handleBirds } from './birds.ts';
-import { BIRDS_HELP } from './birds.ts';
-import { handleLogs } from './logs.ts';
-import { LOGS_HELP } from './logs.ts';
-import { handleJobs } from './jobs.ts';
-import { JOBS_HELP } from './jobs.ts';
-import { handleConfig } from './config.ts';
-import { CONFIG_HELP } from './config.ts';
-import { handleDoctor } from './doctor.ts';
-import { DOCTOR_HELP } from './doctor.ts';
-
-const MAIN_HELP =
-  BANNER +
-  `
-${c('cyan', 'usage:')} browserbird [command] [options]
-
-${c('dim', 'commands:')}
-
-  ${c('cyan', 'sessions')}    manage sessions
-  ${c('cyan', 'birds')}       manage scheduled birds
-  ${c('cyan', 'config')}      view configuration
-  ${c('cyan', 'logs')}        show recent log entries
-  ${c('cyan', 'jobs')}        inspect and manage the job queue
-  ${c('cyan', 'doctor')}      check system dependencies
-
-${c('dim', 'options:')}
-
-  ${c('yellow', '-h, --help')}     show this help
-  ${c('yellow', '-v, --version')}  show version
-  ${c('yellow', '--verbose')}      enable debug logging
-  ${c('yellow', '--config')}       config file path (env: BROWSERBIRD_CONFIG)
-  ${c('yellow', '--db')}           database file path (env: BROWSERBIRD_DB)
-
-run 'browserbird <command> --help' for command-specific options.`.trimEnd();
-
-const COMMAND_HELP: Record<string, string> = {
-  sessions: SESSIONS_HELP,
-  birds: BIRDS_HELP,
-  config: CONFIG_HELP,
-  logs: LOGS_HELP,
-  jobs: JOBS_HELP,
-  doctor: DOCTOR_HELP,
-};
-
-export async function run(argv: string[]): Promise<void> {
-  const command = argv[0];
-
-  if (command === '--help' || command === '-h') {
-    console.log(MAIN_HELP);
-    return;
-  }
-
-  if (!command) {
-    await startDaemon(parseGlobalFlags(argv));
-    return;
-  }
-
-  if (command === '--version' || command === '-v') {
-    console.log(VERSION);
-    return;
-  }
-
-  const rest = argv.slice(1);
-  const isHelp = rest.includes('--help') || rest.includes('-h');
-
-  if (command === '--verbose' || command === '--config' || command === '--no-color') {
-    await startDaemon(parseGlobalFlags(argv));
-    return;
-  }
-
-  switch (command as Command) {
-    case COMMANDS.SESSIONS:
-      if (isHelp) {
-        console.log(COMMAND_HELP.sessions);
-        return;
-      }
-      handleSessions(rest);
-      break;
-    case COMMANDS.BIRDS:
-      if (isHelp) {
-        console.log(COMMAND_HELP.birds);
-        return;
-      }
-      handleBirds(rest);
-      break;
-    case COMMANDS.CONFIG:
-      if (isHelp) {
-        console.log(COMMAND_HELP.config);
-        return;
-      }
-      handleConfig(rest);
-      break;
-    case COMMANDS.LOGS:
-      if (isHelp) {
-        console.log(COMMAND_HELP.logs);
-        return;
-      }
-      handleLogs(rest);
-      break;
-    case COMMANDS.JOBS:
-      if (isHelp) {
-        console.log(COMMAND_HELP.jobs);
-        return;
-      }
-      handleJobs(rest);
-      break;
-    case COMMANDS.DOCTOR:
-      handleDoctor();
-      break;
-    default:
-      unknownSubcommand(command, '', ['sessions', 'birds', 'config', 'logs', 'jobs', 'doctor']);
-  }
-}
-
-function parseGlobalFlags(argv: string[]): {
-  flags: { verbose: boolean; config?: string; db?: string };
-} {
-  const { values } = parseArgs({
-    args: argv,
-    options: {
-      verbose: { type: 'boolean', default: false },
-      config: { type: 'string' },
-      db: { type: 'string' },
-    },
-    allowPositionals: true,
-    strict: false,
-  });
-  if (values.verbose) logger.setLevel('debug');
-  return {
-    flags: {
-      verbose: values.verbose as boolean,
-      config: values.config as string | undefined,
-      db: values.db as string | undefined,
-    },
-  };
-}

package/src/cli/sessions.ts

@@ -1,158 +0,0 @@
-/** @fileoverview Sessions command: list and inspect sessions. */
-
-import { parseArgs } from 'node:util';
-import { logger } from '../core/logger.ts';
-import { shortUid } from '../core/uid.ts';
-import { printTable, unknownSubcommand } from '../core/utils.ts';
-import { c } from './style.ts';
-import {
-  openDatabase,
-  closeDatabase,
-  resolveByUid,
-  listSessions,
-  getSessionMessages,
-  getSessionTokenStats,
-  resolveDbPathFromArgv,
-} from '../db/index.ts';
-import type { SessionRow } from '../db/index.ts';
-
-export const SESSIONS_HELP = `
-${c('cyan', 'usage:')} browserbird sessions <subcommand> [options]
-
-manage sessions.
-
-${c('dim', 'subcommands:')}
-
-  ${c('cyan', 'list')}          list recent sessions
-  ${c('cyan', 'logs')} <uid>    show session detail and message history
-
-${c('dim', 'options:')}
-
-  ${c('yellow', '--json')}       output as JSON (with list, logs)
-  ${c('yellow', '--db')} <path>  database file path (env: BROWSERBIRD_DB)
-  ${c('yellow', '-h, --help')}   show this help
-`.trim();
-
-export function handleSessions(argv: string[]): void {
-  const subcommand = argv[0] ?? 'list';
-  const args = argv.slice(1);
-
-  const dbPath = resolveDbPathFromArgv(argv);
-
-  const { values, positionals } = parseArgs({
-    args,
-    options: {
-      json: { type: 'boolean', default: false },
-    },
-    allowPositionals: true,
-    strict: false,
-  });
-
-  if (subcommand === 'list') {
-    openDatabase(dbPath);
-    try {
-      const { items, totalItems } = listSessions(1, 20);
-      if (values.json) {
-        console.log(JSON.stringify(items, null, 2));
-        return;
-      }
-      console.log(`sessions (${totalItems} total):`);
-      if (items.length === 0) {
-        console.log('\n  no sessions found');
-        return;
-      }
-      console.log('');
-      const rows = items.map((s) => [
-        c('dim', shortUid(s.uid)),
-        s.channel_id,
-        s.agent_id,
-        String(s.message_count),
-        s.last_active.slice(0, 19),
-      ]);
-      printTable(['uid', 'channel', 'agent', 'messages', 'last active'], rows);
-    } finally {
-      closeDatabase();
-    }
-    return;
-  }
-
-  if (subcommand !== 'logs') {
-    unknownSubcommand(subcommand, 'sessions', ['list', 'logs']);
-    return;
-  }
-
-  const uidPrefix = positionals[0];
-  if (!uidPrefix) {
-    logger.error('usage: browserbird sessions logs <uid>');
-    process.exitCode = 1;
-    return;
-  }
-
-  openDatabase(dbPath);
-
-  try {
-    const result = resolveByUid<SessionRow>('sessions', uidPrefix);
-    if (!result) {
-      logger.error(`session ${uidPrefix} not found`);
-      process.exitCode = 1;
-      return;
-    }
-    if ('ambiguous' in result) {
-      logger.error(
-        `ambiguous session ID "${uidPrefix}" matches ${result.count} sessions, use a longer prefix`,
-      );
-      process.exitCode = 1;
-      return;
-    }
-    const session = result.row;
-
-    const tokenStats = getSessionTokenStats(session.channel_id, session.thread_id);
-
-    if (values.json) {
-      const msgResult = getSessionMessages(session.channel_id, session.thread_id, 1, 50);
-      console.log(JSON.stringify({ session, messages: msgResult.items }, null, 2));
-      return;
-    }
-
-    console.log(`session ${c('cyan', shortUid(session.uid))}`);
-    console.log(c('dim', '------------------'));
-    console.log(`${c('dim', 'uid:')}          ${session.uid}`);
-    console.log(`${c('dim', 'channel:')}      ${session.channel_id}`);
-    console.log(`${c('dim', 'thread:')}       ${session.thread_id ?? '(none)'}`);
-    console.log(`${c('dim', 'agent:')}        ${session.agent_id}`);
-    console.log(`${c('dim', 'provider id:')}  ${session.provider_session_id}`);
-    console.log(`${c('dim', 'created:')}      ${session.created_at}`);
-    console.log(`${c('dim', 'last active:')}  ${session.last_active}`);
-    console.log(`${c('dim', 'messages:')}     ${session.message_count}`);
-    console.log(
-      `${c('dim', 'tokens:')}       ${tokenStats.totalTokensIn} in / ${tokenStats.totalTokensOut} out`,
-    );
-    console.log('');
-
-    const msgResult = getSessionMessages(session.channel_id, session.thread_id, 1, 50);
-
-    if (msgResult.items.length === 0) {
-      console.log('no messages recorded.');
-      return;
-    }
-
-    console.log(
-      `messages (${msgResult.totalItems} total, showing page 1 of ${msgResult.totalPages}):`,
-    );
-    console.log('------------------');
-
-    for (const msg of msgResult.items) {
-      const dir = msg.direction === 'in' ? c('green', '->') : c('cyan', '<-');
-      const tokens =
-        msg.tokens_in != null || msg.tokens_out != null
-          ? `  [in:${msg.tokens_in ?? 0} out:${msg.tokens_out ?? 0}]`
-          : '';
-      const preview = (msg.content ?? '').slice(0, 120);
-      const truncated = (msg.content?.length ?? 0) > 120 ? '...' : '';
-      console.log(`${dir} ${msg.user_id}  ${msg.created_at}${tokens}`);
-      if (preview) console.log(`   ${preview}${truncated}`);
-    }
-  } finally {
-    closeDatabase();
-  }
-}

package/src/cli/style.ts

@@ -1,19 +0,0 @@
-/** @fileoverview CLI color utilities. Safe palette per terminal theme compatibility. */
-
-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.stdout.isTTY === true;
-}
-
-const useColor = shouldUseColor();
-
-type Format = Parameters<typeof styleText>[0];
-
-export function c(format: Format, text: string): string {
-  if (!useColor) return text;
-  return styleText(format, text);
-}