@owloops/browserbird 1.0.2 → 1.0.3

package/src/cli/birds.ts

@@ -1,396 +0,0 @@
-/** @fileoverview Birds command: manage scheduled birds (cron jobs). */
-
-import { parseArgs } from 'node:util';
-import { logger } from '../core/logger.ts';
-import { shortUid } from '../core/uid.ts';
-import { formatDuration, deriveBirdName, printTable, unknownSubcommand } from '../core/utils.ts';
-import { c } from './style.ts';
-import {
-  openDatabase,
-  closeDatabase,
-  resolveByUid,
-  listCronJobs,
-  createCronJob,
-  updateCronJob,
-  setCronJobEnabled,
-  deleteCronJob,
-  listFlights,
-  resolveDbPathFromArgv,
-} from '../db/index.ts';
-import type { CronJobRow } from '../db/index.ts';
-import { enqueue } from '../jobs.ts';
-
-export const BIRDS_HELP = `
-${c('cyan', 'usage:')} browserbird birds <subcommand> [options]
-
-manage scheduled birds.
-
-${c('dim', 'subcommands:')}
-
-  ${c('cyan', 'list')}                         list all birds
-  ${c('cyan', 'add')} <schedule> <prompt>      add a new bird
-  ${c('cyan', 'edit')} <uid>                   edit a bird
-  ${c('cyan', 'remove')} <uid>                 remove a bird
-  ${c('cyan', 'enable')} <uid>                 enable a bird
-  ${c('cyan', 'disable')} <uid>                disable a bird
-  ${c('cyan', 'fly')} <uid>                    trigger a bird manually
-  ${c('cyan', 'flights')} <uid>                show flight history for a bird
-
-${c('dim', 'options:')}
-
-  ${c('yellow', '--channel')} <id>       target slack channel
-  ${c('yellow', '--agent')} <id>         target agent id
-  ${c('yellow', '--schedule')} <expr>    cron schedule expression
-  ${c('yellow', '--prompt')} <text>      prompt text
-  ${c('yellow', '--timezone')} <tz>      IANA timezone (default: UTC)
-  ${c('yellow', '--active-hours')} <range>  restrict runs to a time window (e.g. "09:00-17:00")
-  ${c('yellow', '--limit')} <n>          number of flights to show (default: 10)
-  ${c('yellow', '--json')}              output as JSON (with list, flights)
-  ${c('yellow', '--db')} <path>          database file path (env: BROWSERBIRD_DB)
-  ${c('yellow', '-h, --help')}           show this help
-`.trim();
-
-function statusColor(status: string | null | undefined): string {
-  if (status == null) return '-';
-  switch (status) {
-    case 'success':
-    case 'completed':
-      return c('green', status);
-    case 'running':
-      return c('blue', status);
-    case 'failed':
-      return c('red', status);
-    default:
-      return status;
-  }
-}
-
-function parseActiveHours(raw: string): { start: string; end: string } | null {
-  const match = raw.match(/^(\d{1,2}:\d{2})\s*-\s*(\d{1,2}:\d{2})$/);
-  if (!match) return null;
-  return { start: match[1]!, end: match[2]! };
-}
-
-function resolveBird(uidPrefix: string): CronJobRow | undefined {
-  const result = resolveByUid<CronJobRow>('cron_jobs', uidPrefix);
-  if (!result) {
-    logger.error(`bird ${uidPrefix} not found`);
-    process.exitCode = 1;
-    return undefined;
-  }
-  if ('ambiguous' in result) {
-    logger.error(
-      `ambiguous bird ID "${uidPrefix}" matches ${result.count} birds, use a longer prefix`,
-    );
-    process.exitCode = 1;
-    return undefined;
-  }
-  return result.row;
-}
-
-export function handleBirds(argv: string[]): void {
-  const subcommand = argv[0] ?? 'list';
-  const rest = argv.slice(1);
-
-  const { values, positionals } = parseArgs({
-    args: rest,
-    options: {
-      channel: { type: 'string' },
-      agent: { type: 'string' },
-      schedule: { type: 'string' },
-      prompt: { type: 'string' },
-      timezone: { type: 'string' },
-      'active-hours': { type: 'string' },
-      limit: { type: 'string' },
-      json: { type: 'boolean', default: false },
-    },
-    allowPositionals: true,
-    strict: false,
-  });
-
-  openDatabase(resolveDbPathFromArgv(argv));
-
-  try {
-    switch (subcommand) {
-      case 'list': {
-        const result = listCronJobs(1, 100);
-        if (values.json) {
-          console.log(JSON.stringify(result.items, null, 2));
-          break;
-        }
-        console.log(`birds (${result.totalItems} total):`);
-        if (result.items.length === 0) {
-          console.log('\n  no birds configured');
-          return;
-        }
-        console.log('');
-        const rows = result.items.map((job) => [
-          c('dim', shortUid(job.uid)),
-          job.enabled ? c('green', 'enabled') : c('yellow', 'disabled'),
-          job.schedule,
-          job.agent_id,
-          job.target_channel_id ?? '-',
-          statusColor(job.last_status),
-          job.prompt.slice(0, 50),
-        ]);
-        printTable(['uid', 'status', 'schedule', 'agent', 'channel', 'last', 'prompt'], rows, [
-          undefined,
-          undefined,
-          undefined,
-          undefined,
-          undefined,
-          undefined,
-          50,
-        ]);
-        break;
-      }
-
-      case 'add': {
-        const schedule = positionals[0];
-        const prompt = positionals.slice(1).join(' ') || (values.prompt as string | undefined);
-        if (!schedule || !prompt) {
-          logger.error(
-            'usage: browserbird birds add <schedule> <prompt> [--channel <id>] [--agent <id>]',
-          );
-          process.exitCode = 1;
-          return;
-        }
-        const activeHoursRaw = values['active-hours'] as string | undefined;
-        let activeStart: string | undefined;
-        let activeEnd: string | undefined;
-        if (activeHoursRaw) {
-          const parsed = parseActiveHours(activeHoursRaw);
-          if (!parsed) {
-            logger.error('--active-hours must be HH:MM-HH:MM (e.g. "09:00-17:00")');
-            process.exitCode = 1;
-            return;
-          }
-          activeStart = parsed.start;
-          activeEnd = parsed.end;
-        }
-        const job = createCronJob(
-          deriveBirdName(prompt),
-          schedule,
-          prompt,
-          values.channel as string | undefined,
-          values.agent as string | undefined,
-          values.timezone as string | undefined,
-          activeStart,
-          activeEnd,
-        );
-        logger.success(`bird ${shortUid(job.uid)} created: "${schedule}"`);
-        process.stderr.write(
-          c('dim', `  hint: run 'browserbird birds fly ${shortUid(job.uid)}' to trigger it now`) +
-            '\n',
-        );
-        break;
-      }
-
-      case 'edit': {
-        const uidPrefix = positionals[0];
-        if (!uidPrefix) {
-          logger.error(
-            'usage: browserbird birds edit <uid> [--schedule <expr>] [--prompt <text>] [--channel <id>] [--agent <id>] [--timezone <tz>] [--active-hours <range>]',
-          );
-          process.exitCode = 1;
-          return;
-        }
-        const bird = resolveBird(uidPrefix);
-        if (!bird) return;
-        const channel = values.channel as string | undefined;
-        const agent = values.agent as string | undefined;
-        const schedule = values.schedule as string | undefined;
-        const prompt = values.prompt as string | undefined;
-        const timezone = values.timezone as string | undefined;
-        const editActiveHoursRaw = values['active-hours'] as string | undefined;
-        let editActiveStart: string | null | undefined;
-        let editActiveEnd: string | null | undefined;
-        if (editActiveHoursRaw === '') {
-          editActiveStart = null;
-          editActiveEnd = null;
-        } else if (editActiveHoursRaw) {
-          const parsed = parseActiveHours(editActiveHoursRaw);
-          if (!parsed) {
-            logger.error('--active-hours must be HH:MM-HH:MM (e.g. "09:00-17:00"), or "" to clear');
-            process.exitCode = 1;
-            return;
-          }
-          editActiveStart = parsed.start;
-          editActiveEnd = parsed.end;
-        }
-        if (
-          !schedule &&
-          !prompt &&
-          !channel &&
-          !agent &&
-          !timezone &&
-          editActiveStart === undefined
-        ) {
-          logger.error(
-            'provide at least one of: --schedule, --prompt, --channel, --agent, --timezone, --active-hours',
-          );
-          process.exitCode = 1;
-          return;
-        }
-        const updated = updateCronJob(bird.uid, {
-          schedule,
-          prompt,
-          name: prompt ? deriveBirdName(prompt) : undefined,
-          targetChannelId: channel !== undefined ? channel || null : undefined,
-          agentId: agent,
-          timezone,
-          activeHoursStart: editActiveStart,
-          activeHoursEnd: editActiveEnd,
-        });
-        if (updated) {
-          logger.success(`bird ${shortUid(bird.uid)} updated`);
-          process.stderr.write(
-            c('dim', `  hint: run 'browserbird birds list' to see updated birds`) + '\n',
-          );
-        } else {
-          logger.error(`bird ${shortUid(bird.uid)} not found`);
-          process.exitCode = 1;
-        }
-        break;
-      }
-
-      case 'remove': {
-        const uidPrefix = positionals[0];
-        if (!uidPrefix) {
-          logger.error('usage: browserbird birds remove <uid>');
-          process.exitCode = 1;
-          return;
-        }
-        const bird = resolveBird(uidPrefix);
-        if (!bird) return;
-        if (deleteCronJob(bird.uid)) {
-          logger.success(`bird ${shortUid(bird.uid)} removed`);
-        } else {
-          logger.error(`bird ${shortUid(bird.uid)} not found`);
-          process.exitCode = 1;
-        }
-        break;
-      }
-
-      case 'enable':
-      case 'disable': {
-        const uidPrefix = positionals[0];
-        if (!uidPrefix) {
-          logger.error(`usage: browserbird birds ${subcommand} <uid>`);
-          process.exitCode = 1;
-          return;
-        }
-        const bird = resolveBird(uidPrefix);
-        if (!bird) return;
-        const enabled = subcommand === 'enable';
-        if (setCronJobEnabled(bird.uid, enabled)) {
-          logger.success(`bird ${shortUid(bird.uid)} ${enabled ? 'enabled' : 'disabled'}`);
-          if (enabled) {
-            process.stderr.write(
-              c(
-                'dim',
-                `  hint: run 'browserbird birds fly ${shortUid(bird.uid)}' to trigger it now`,
-              ) + '\n',
-            );
-          }
-        } else {
-          logger.error(`bird ${shortUid(bird.uid)} not found`);
-          process.exitCode = 1;
-        }
-        break;
-      }
-
-      case 'fly': {
-        const uidPrefix = positionals[0];
-        if (!uidPrefix) {
-          logger.error('usage: browserbird birds fly <uid>');
-          process.exitCode = 1;
-          return;
-        }
-        const cronJob = resolveBird(uidPrefix);
-        if (!cronJob) return;
-        const enqueuedJob = enqueue(
-          'cron_run',
-          {
-            cronJobUid: cronJob.uid,
-            prompt: cronJob.prompt,
-            channelId: cronJob.target_channel_id,
-            agentId: cronJob.agent_id,
-          },
-          { cronJobUid: cronJob.uid },
-        );
-        logger.success(`enqueued job #${enqueuedJob.id} for bird ${shortUid(cronJob.uid)}`);
-        process.stderr.write(
-          c(
-            'dim',
-            `  hint: run 'browserbird birds flights ${shortUid(cronJob.uid)}' to check results`,
-          ) + '\n',
-        );
-        break;
-      }
-
-      case 'flights': {
-        const uidPrefix = positionals[0];
-        if (!uidPrefix) {
-          logger.error('usage: browserbird birds flights <uid>');
-          process.exitCode = 1;
-          return;
-        }
-        const bird = resolveBird(uidPrefix);
-        if (!bird) return;
-        const perPage = values.limit != null ? Number(values.limit) : 10;
-        if (!Number.isFinite(perPage) || perPage < 1) {
-          logger.error('--limit must be a positive number');
-          process.exitCode = 1;
-          return;
-        }
-        const result = listFlights(1, perPage, { birdUid: bird.uid });
-        if (values.json) {
-          console.log(JSON.stringify(result.items, null, 2));
-          break;
-        }
-        console.log(`flight history for bird ${shortUid(bird.uid)} (${result.totalItems} total):`);
-        if (result.items.length === 0) {
-          console.log('\n  no flights recorded');
-          return;
-        }
-        console.log('');
-        const rows = result.items.map((flight) => {
-          const durationMs = flight.finished_at
-            ? new Date(flight.finished_at).getTime() - new Date(flight.started_at).getTime()
-            : null;
-          const duration = durationMs == null ? '-' : formatDuration(durationMs);
-          return [
-            c('dim', shortUid(flight.uid)),
-            statusColor(flight.status),
-            duration,
-            flight.started_at.slice(0, 19),
-            flight.error ?? flight.result?.slice(0, 60) ?? '',
-          ];
-        });
-        printTable(['flight', 'status', 'duration', 'started', 'error / result'], rows, [
-          undefined,
-          undefined,
-          undefined,
-          undefined,
-          60,
-        ]);
-        break;
-      }
-
-      default:
-        unknownSubcommand(subcommand, 'birds', [
-          'list',
-          'add',
-          'edit',
-          'remove',
-          'enable',
-          'disable',
-          'fly',
-          'flights',
-        ]);
-    }
-  } finally {
-    closeDatabase();
-  }
-}

package/src/cli/config.ts

@@ -1,77 +0,0 @@
-/** @fileoverview Config command: display merged configuration. */
-
-import { parseArgs } from 'node:util';
-import { loadRawConfig } from '../config.ts';
-import type { Config } from '../core/types.ts';
-import { c } from './style.ts';
-
-export const CONFIG_HELP = `
-${c('cyan', 'usage:')} browserbird config [options]
-
-view full configuration (defaults merged with browserbird.json).
-
-${c('dim', 'options:')}
-
-  ${c('yellow', '--config')} <path>  config file path
-  ${c('yellow', '-h, --help')}       show this help
-`.trim();
-
-export function handleConfig(argv: string[]): void {
-  const { values } = parseArgs({
-    args: argv,
-    options: { config: { type: 'string' } },
-    allowPositionals: false,
-    strict: false,
-  });
-  printConfig(values.config as string | undefined);
-}
-
-function printConfig(configPath?: string): void {
-  const config = loadRawConfig(configPath) as unknown as Config;
-
-  console.log(c('cyan', 'config'));
-  console.log(c('dim', '------'));
-  console.log(`\n${c('dim', 'timezone:')} ${config.timezone}`);
-
-  console.log(`\n${c('cyan', 'agents:')}`);
-  for (const a of config.agents) {
-    console.log(`  ${c('cyan', a.id)} (${a.name})`);
-    console.log(`    ${c('dim', 'provider:')}  ${a.provider}`);
-    console.log(`    ${c('dim', 'model:')}     ${a.model}`);
-    console.log(`    ${c('dim', 'max turns:')} ${a.maxTurns}`);
-    console.log(`    ${c('dim', 'channels:')}  ${a.channels.join(', ') || '*'}`);
-  }
-
-  console.log(`\n${c('cyan', 'sessions:')}`);
-  console.log(`  ${c('dim', 'max concurrent:')}  ${config.sessions.maxConcurrent}`);
-  console.log(`  ${c('dim', 'ttl:')}             ${config.sessions.ttlHours}h`);
-  console.log(`  ${c('dim', 'timeout:')}         ${config.sessions.processTimeoutMs / 1000}s`);
-
-  console.log(`\n${c('cyan', 'slack:')}`);
-  console.log(`  ${c('dim', 'require mention:')} ${config.slack.requireMention ? 'yes' : 'no'}`);
-  console.log(`  ${c('dim', 'debounce:')}        ${config.slack.coalesce.debounceMs}ms`);
-  console.log(
-    `  ${c('dim', 'bypass dms:')}      ${config.slack.coalesce.bypassDms ? 'yes' : 'no'}`,
-  );
-  console.log(`  ${c('dim', 'channels:')}        ${config.slack.channels.join(', ') || '(all)'}`);
-  console.log(
-    `  ${c('dim', 'quiet hours:')}     ${config.slack.quietHours.enabled ? `${config.slack.quietHours.start}-${config.slack.quietHours.end} (${config.slack.quietHours.timezone})` : 'disabled'}`,
-  );
-
-  console.log(`\n${c('cyan', 'birds:')}`);
-  console.log(`  ${c('dim', 'max attempts:')} ${config.birds.maxAttempts}`);
-
-  console.log(`\n${c('cyan', 'browser:')}`);
-  console.log(`  ${c('dim', 'enabled:')}    ${config.browser.enabled ? 'yes' : 'no'}`);
-  if (config.browser.enabled) {
-    console.log(`  ${c('dim', 'mode:')}       ${process.env['BROWSER_MODE'] ?? 'persistent'}`);
-    console.log(`  ${c('dim', 'vnc port:')}   ${config.browser.vncPort}`);
-    console.log(`  ${c('dim', 'novnc port:')} ${config.browser.novncPort}`);
-  }
-
-  console.log(`\n${c('cyan', 'database:')}`);
-  console.log(`  ${c('dim', 'retention:')} ${config.database.retentionDays}d`);
-
-  console.log(`\n${c('cyan', 'web:')}`);
-  console.log(`  ${c('dim', 'port:')} ${config.web.port}`);
-}

package/src/cli/doctor.ts

@@ -1,63 +0,0 @@
-/** @fileoverview Doctor command: checks system dependencies. */
-
-import { execFileSync } from 'node:child_process';
-import { logger } from '../core/logger.ts';
-import { c } from './style.ts';
-
-export const DOCTOR_HELP = `
-${c('cyan', 'usage:')} browserbird doctor
-
-check system dependencies (agent clis, node.js).
-`.trim();
-
-interface CliStatus {
-  available: boolean;
-  version: string | null;
-}
-
-export interface DoctorResult {
-  claude: CliStatus;
-  opencode: CliStatus;
-  node: string;
-}
-
-function checkCli(binary: string, versionArgs: string[]): CliStatus {
-  try {
-    const output = execFileSync(binary, versionArgs, {
-      timeout: 5000,
-      encoding: 'utf-8',
-      stdio: ['ignore', 'pipe', 'ignore'],
-    });
-    const version = (output.trim().split('\n')[0] ?? '').replace(/\s*\(.*\)$/, '') || null;
-    return { available: true, version };
-  } catch {
-    return { available: false, version: null };
-  }
-}
-
-export function checkDoctor(): DoctorResult {
-  return {
-    claude: checkCli('claude', ['--version']),
-    opencode: checkCli('opencode', ['--version']),
-    node: process.version,
-  };
-}
-
-export function handleDoctor(): void {
-  const result = checkDoctor();
-  console.log(c('cyan', 'doctor'));
-  console.log(c('dim', '------'));
-  if (result.claude.available) {
-    logger.success(`claude cli: ${result.claude.version}`);
-  } else {
-    logger.error('claude cli: not found');
-    process.stderr.write('  install: npm install -g @anthropic-ai/claude-code\n');
-  }
-  if (result.opencode.available) {
-    logger.success(`opencode cli: ${result.opencode.version}`);
-  } else {
-    logger.warn('opencode cli: not found (optional)');
-    process.stderr.write('  install: npm install -g opencode\n');
-  }
-  logger.success(`node.js: ${result.node}`);
-}

package/src/cli/index.ts

@@ -1,5 +0,0 @@
-/** @fileoverview CLI barrel: public API for the CLI module. */
-
-export { run } from './run.ts';
-export { checkDoctor } from './doctor.ts';
-export type { DoctorResult } from './doctor.ts';