@dobby.ai/dobby 0.1.1 → 0.1.2

package/src/cli/program.ts

@@ -1,314 +0,0 @@
-import { existsSync, readFileSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-import { Command } from "commander";
-import {
-  runConfigListCommand,
-  runConfigSchemaListCommand,
-  runConfigSchemaShowCommand,
-  runConfigShowCommand,
-} from "./commands/config.js";
-import {
-  runCronAddCommand,
-  runCronListCommand,
-  runCronPauseCommand,
-  runCronRemoveCommand,
-  runCronResumeCommand,
-  runCronRunCommand,
-  runCronStatusCommand,
-  runCronUpdateCommand,
-} from "./commands/cron.js";
-import { runDoctorCommand } from "./commands/doctor.js";
-import {
-  runExtensionInstallCommand,
-  runExtensionListCommand,
-  runExtensionUninstallCommand,
-} from "./commands/extension.js";
-import { runInitCommand } from "./commands/init.js";
-import { runStartCommand } from "./commands/start.js";
-
-function loadCliVersion(): string {
-  const candidates = [
-    fileURLToPath(new URL("../../package.json", import.meta.url)),
-    fileURLToPath(new URL("../../../package.json", import.meta.url)),
-  ];
-  const fallbackCandidate = fileURLToPath(new URL("../../package.json", import.meta.url));
-  const packageJsonPath = candidates.find((candidate) => existsSync(candidate)) ?? fallbackCandidate;
-  return JSON.parse(readFileSync(packageJsonPath, "utf-8")).version as string;
-}
-
-const CLI_VERSION = loadCliVersion();
-
-/**
- * Builds the top-level dobby CLI program and registers all subcommands.
- */
-export function buildProgram(): Command {
-  const program = new Command();
-  program
-    .name("dobby")
-    .version(CLI_VERSION)
-    .description("Discord-first local agent gateway")
-    .showHelpAfterError()
-    .action(async () => {
-      await runStartCommand();
-    });
-
-  program
-    .command("start")
-    .description("Start the gateway")
-    .action(async () => {
-      await runStartCommand();
-    });
-
-  program
-    .command("init")
-    .description("Initialize minimal runnable gateway config")
-    .action(async () => {
-      await runInitCommand();
-    });
-
-  const configCommand = program.command("config").description("Inspect config");
-
-  configCommand
-    .command("show")
-    .description("Show full config or one section")
-    .argument("[section]", "Section: providers|connectors|routes|bindings|sandboxes|data|extensions")
-    .option("--json", "Output JSON", false)
-    .action(async (section: string | undefined, opts) => {
-      await runConfigShowCommand({
-        ...(typeof section === "string" ? { section } : {}),
-        json: Boolean(opts.json),
-      });
-    });
-
-  configCommand
-    .command("list")
-    .description("List config keys with type and preview")
-    .argument("[section]", "Section: providers|connectors|routes|bindings|sandboxes|data|extensions")
-    .option("--json", "Output JSON", false)
-    .action(async (section: string | undefined, opts) => {
-      await runConfigListCommand({
-        ...(typeof section === "string" ? { section } : {}),
-        json: Boolean(opts.json),
-      });
-    });
-
-  const configSchemaCommand = configCommand.command("schema").description("Inspect extension config schemas");
-
-  configSchemaCommand
-    .command("list")
-    .description("List loaded contributions and schema availability")
-    .option("--json", "Output JSON", false)
-    .action(async (opts) => {
-      await runConfigSchemaListCommand({
-        json: Boolean(opts.json),
-      });
-    });
-
-  configSchemaCommand
-    .command("show")
-    .description("Show one contribution config schema")
-    .argument("<contributionId>", "Contribution ID")
-    .option("--json", "Output JSON", false)
-    .action(async (contributionId: string, opts) => {
-      await runConfigSchemaShowCommand({
-        contributionId,
-        json: Boolean(opts.json),
-      });
-    });
-
-  const extensionCommand = program.command("extension").description("Manage extensions");
-
-  extensionCommand
-    .command("install")
-    .description("Install extension package")
-    .argument("<packageSpec>", "npm package spec")
-    .option("--enable", "Enable extension in config after install", false)
-    .option("--json", "Output JSON", false)
-    .action(async (packageSpec: string, opts) => {
-      await runExtensionInstallCommand({
-        spec: packageSpec,
-        enable: Boolean(opts.enable),
-        json: Boolean(opts.json),
-      });
-    });
-
-  extensionCommand
-    .command("uninstall")
-    .description("Uninstall extension package")
-    .argument("<packageName>", "Package name")
-    .action(async (packageName: string) => {
-      await runExtensionUninstallCommand({
-        packageName,
-      });
-    });
-
-  extensionCommand
-    .command("list")
-    .description("List installed extension packages")
-    .option("--json", "Output JSON", false)
-    .action(async (opts) => {
-      await runExtensionListCommand({
-        json: Boolean(opts.json),
-      });
-    });
-
-  program
-    .command("doctor")
-    .description("Validate configuration and common runtime risks")
-    .option("--fix", "Apply conservative fixes", false)
-    .action(async (opts) => {
-      await runDoctorCommand({
-        fix: Boolean(opts.fix),
-      });
-    });
-
-  const cronCommand = program.command("cron").description("Manage scheduled cron jobs");
-
-  cronCommand
-    .command("add")
-    .description("Create one cron job")
-    .argument("<name>", "Job name")
-    .requiredOption("--prompt <text>", "Prompt text for each run")
-    .requiredOption("--connector <id>", "Connector instance ID")
-    .requiredOption("--route <id>", "Route ID")
-    .requiredOption("--channel <id>", "Delivery channel/chat ID")
-    .option("--thread <id>", "Delivery thread ID")
-    .option("--session-policy <policy>", "Session policy: stateless|shared-session", "stateless")
-    .option("--at <iso>", "Run once at ISO timestamp")
-    .option("--every-ms <ms>", "Run at fixed interval in milliseconds")
-    .option("--cron <expr>", "Cron expression")
-    .option("--tz <tz>", "Timezone for cron expression")
-    .option("--cron-config <path>", "Override cron config path")
-    .action(async (name: string, opts) => {
-      const parsedEveryMs = typeof opts.everyMs === "string" ? Number(opts.everyMs) : null;
-      await runCronAddCommand({
-        name,
-        prompt: opts.prompt as string,
-        connectorId: opts.connector as string,
-        routeId: opts.route as string,
-        channelId: opts.channel as string,
-        ...(typeof opts.thread === "string" ? { threadId: opts.thread as string } : {}),
-        sessionPolicy: opts.sessionPolicy as "stateless" | "shared-session",
-        ...(typeof opts.at === "string" ? { at: opts.at as string } : {}),
-        ...(parsedEveryMs !== null && Number.isFinite(parsedEveryMs) ? { everyMs: parsedEveryMs } : {}),
-        ...(typeof opts.cron === "string" ? { cronExpr: opts.cron as string } : {}),
-        ...(typeof opts.tz === "string" ? { tz: opts.tz as string } : {}),
-        ...(typeof opts.cronConfig === "string" ? { cronConfigPath: opts.cronConfig as string } : {}),
-      });
-    });
-
-  cronCommand
-    .command("list")
-    .description("List cron jobs")
-    .option("--json", "Output JSON", false)
-    .option("--cron-config <path>", "Override cron config path")
-    .action(async (opts) => {
-      await runCronListCommand({
-        json: Boolean(opts.json),
-        ...(typeof opts.cronConfig === "string" ? { cronConfigPath: opts.cronConfig as string } : {}),
-      });
-    });
-
-  cronCommand
-    .command("status")
-    .description("Show status for all jobs or one job")
-    .argument("[jobId]", "Cron job ID")
-    .option("--json", "Output JSON", false)
-    .option("--cron-config <path>", "Override cron config path")
-    .action(async (jobId: string | undefined, opts) => {
-      await runCronStatusCommand({
-        ...(typeof jobId === "string" ? { jobId } : {}),
-        json: Boolean(opts.json),
-        ...(typeof opts.cronConfig === "string" ? { cronConfigPath: opts.cronConfig as string } : {}),
-      });
-    });
-
-  cronCommand
-    .command("run")
-    .description("Queue one cron job for immediate execution")
-    .argument("<jobId>", "Cron job ID")
-    .option("--cron-config <path>", "Override cron config path")
-    .action(async (jobId: string, opts) => {
-      await runCronRunCommand({
-        jobId,
-        ...(typeof opts.cronConfig === "string" ? { cronConfigPath: opts.cronConfig as string } : {}),
-      });
-    });
-
-  cronCommand
-    .command("update")
-    .description("Update one cron job")
-    .argument("<jobId>", "Cron job ID")
-    .option("--name <name>", "Job name")
-    .option("--prompt <text>", "Job prompt")
-    .option("--connector <id>", "Connector instance ID")
-    .option("--route <id>", "Route ID")
-    .option("--channel <id>", "Delivery channel/chat ID")
-    .option("--thread <id>", "Delivery thread ID")
-    .option("--clear-thread", "Unset delivery thread", false)
-    .option("--session-policy <policy>", "Session policy: stateless|shared-session")
-    .option("--at <iso>", "Run once at ISO timestamp")
-    .option("--every-ms <ms>", "Run at fixed interval in milliseconds")
-    .option("--cron <expr>", "Cron expression")
-    .option("--tz <tz>", "Timezone for cron expression")
-    .option("--cron-config <path>", "Override cron config path")
-    .action(async (jobId: string, opts) => {
-      const parsedEveryMs = typeof opts.everyMs === "string" ? Number(opts.everyMs) : null;
-      await runCronUpdateCommand({
-        jobId,
-        ...(typeof opts.name === "string" ? { name: opts.name as string } : {}),
-        ...(typeof opts.prompt === "string" ? { prompt: opts.prompt as string } : {}),
-        ...(typeof opts.connector === "string" ? { connectorId: opts.connector as string } : {}),
-        ...(typeof opts.route === "string" ? { routeId: opts.route as string } : {}),
-        ...(typeof opts.channel === "string" ? { channelId: opts.channel as string } : {}),
-        ...(typeof opts.thread === "string" ? { threadId: opts.thread as string } : {}),
-        clearThread: Boolean(opts.clearThread),
-        ...(typeof opts.sessionPolicy === "string"
-          ? { sessionPolicy: opts.sessionPolicy as "stateless" | "shared-session" }
-          : {}),
-        ...(typeof opts.at === "string" ? { at: opts.at as string } : {}),
-        ...(parsedEveryMs !== null && Number.isFinite(parsedEveryMs) ? { everyMs: parsedEveryMs } : {}),
-        ...(typeof opts.cron === "string" ? { cronExpr: opts.cron as string } : {}),
-        ...(typeof opts.tz === "string" ? { tz: opts.tz as string } : {}),
-        ...(typeof opts.cronConfig === "string" ? { cronConfigPath: opts.cronConfig as string } : {}),
-      });
-    });
-
-  cronCommand
-    .command("remove")
-    .description("Remove one cron job")
-    .argument("<jobId>", "Cron job ID")
-    .option("--cron-config <path>", "Override cron config path")
-    .action(async (jobId: string, opts) => {
-      await runCronRemoveCommand({
-        jobId,
-        ...(typeof opts.cronConfig === "string" ? { cronConfigPath: opts.cronConfig as string } : {}),
-      });
-    });
-
-  cronCommand
-    .command("pause")
-    .description("Pause one cron job")
-    .argument("<jobId>", "Cron job ID")
-    .option("--cron-config <path>", "Override cron config path")
-    .action(async (jobId: string, opts) => {
-      await runCronPauseCommand({
-        jobId,
-        ...(typeof opts.cronConfig === "string" ? { cronConfigPath: opts.cronConfig as string } : {}),
-      });
-    });
-
-  cronCommand
-    .command("resume")
-    .description("Resume one cron job")
-    .argument("<jobId>", "Cron job ID")
-    .option("--cron-config <path>", "Override cron config path")
-    .action(async (jobId: string, opts) => {
-      await runCronResumeCommand({
-        jobId,
-        ...(typeof opts.cronConfig === "string" ? { cronConfigPath: opts.cronConfig as string } : {}),
-      });
-    });
-
-  return program;
-}

package/src/cli/shared/config-io.ts

@@ -1,245 +0,0 @@
-import { access, mkdir, readFile, rename, rm, writeFile } from "node:fs/promises";
-import { dirname, isAbsolute, resolve } from "node:path";
-import { homedir } from "node:os";
-import { loadGatewayConfig } from "../../core/routing.js";
-import { findDobbyRepoRoot, isDobbyRepoRoot } from "../../shared/dobby-repo.js";
-import type { RawGatewayConfig } from "./config-types.js";
-
-/**
- * Default config file path used by all CLI commands.
- */
-export const DEFAULT_CONFIG_PATH = resolve(homedir(), ".dobby", "gateway.json");
-
-/**
- * Expands "~" prefixed paths to the current user's home directory.
- */
-function expandHome(value: string): string {
-  if (value === "~") {
-    return homedir();
-  }
-
-  if (value.startsWith("~/") || value.startsWith("~\\")) {
-    return resolve(homedir(), value.slice(2));
-  }
-
-  return value;
-}
-
-type ConfigPathSource = "env" | "repo" | "default";
-
-interface ConfigPathResolutionInput {
-  cwd?: string;
-  env?: NodeJS.ProcessEnv;
-}
-
-interface ResolvedConfigPathInfo {
-  path: string;
-  source: ConfigPathSource;
-}
-
-function resolveConfigBaseDir(configPath: string): string {
-  const absoluteConfigPath = resolve(configPath);
-  const configDir = dirname(absoluteConfigPath);
-  const repoRoot = dirname(configDir);
-
-  if (absoluteConfigPath === resolve(repoRoot, "config", "gateway.json") && isDobbyRepoRoot(repoRoot)) {
-    return repoRoot;
-  }
-
-  return configDir;
-}
-
-/**
- * Scans current directory and ancestors to find a local dobby repo config path.
- */
-function findDobbyRepoConfigPath(startDir: string): string | null {
-  const repoRoot = findDobbyRepoRoot(startDir);
-  return repoRoot ? resolve(repoRoot, "config", "gateway.json") : null;
-}
-
-/**
- * Resolves config path source by priority: env override -> local repo -> default home path.
- */
-function resolveConfigPathInfo(input?: ConfigPathResolutionInput): ResolvedConfigPathInfo {
-  const env = input?.env ?? process.env;
-  const cwd = input?.cwd ?? process.cwd();
-  const rawOverride = env.DOBBY_CONFIG_PATH;
-  const override = typeof rawOverride === "string" ? rawOverride.trim() : "";
-
-  if (override.length > 0) {
-    const expanded = expandHome(override);
-    return {
-      path: isAbsolute(expanded) ? resolve(expanded) : resolve(cwd, expanded),
-      source: "env",
-    };
-  }
-
-  const localRepoConfigPath = findDobbyRepoConfigPath(cwd);
-  if (localRepoConfigPath) {
-    return {
-      path: localRepoConfigPath,
-      source: "repo",
-    };
-  }
-
-  return {
-    path: DEFAULT_CONFIG_PATH,
-    source: "default",
-  };
-}
-
-/**
- * Resolves config path with dev-friendly detection and env override support.
- */
-export function resolveConfigPath(input?: ConfigPathResolutionInput): string {
-  return resolveConfigPathInfo(input).path;
-}
-
-/**
- * Formats a user-facing init command hint for missing-config errors.
- */
-function initCommandHint(): string {
-  return "dobby init";
-}
-
-/**
- * Resolves data.rootDir into an absolute path using config-file-relative semantics.
- */
-export function resolveDataRootDir(configPath: string, rawConfig: RawGatewayConfig): string {
-  const absoluteConfigPath = resolve(configPath);
-  const baseDir = resolveConfigBaseDir(absoluteConfigPath);
-  const rawRootDir = typeof rawConfig.data?.rootDir === "string" && rawConfig.data.rootDir.trim().length > 0
-    ? rawConfig.data.rootDir
-    : "./data";
-
-  const expanded = expandHome(rawRootDir);
-  if (isAbsolute(expanded)) {
-    return resolve(expanded);
-  }
-
-  return resolve(baseDir, expanded);
-}
-
-/**
- * Checks whether a file exists without throwing for missing paths.
- */
-async function fileExists(path: string): Promise<boolean> {
-  try {
-    await access(path);
-    return true;
-  } catch {
-    return false;
-  }
-}
-
-/**
- * Reads and parses the raw JSON config file.
- */
-export async function readRawConfig(configPath: string): Promise<RawGatewayConfig | null> {
-  const absolutePath = resolve(configPath);
-  if (!(await fileExists(absolutePath))) {
-    return null;
-  }
-
-  const raw = await readFile(absolutePath, "utf-8");
-  const parsed = JSON.parse(raw) as unknown;
-  if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
-    throw new Error(`Config at '${absolutePath}' must be a JSON object`);
-  }
-
-  return parsed as RawGatewayConfig;
-}
-
-/**
- * Writes config content atomically via temp file + rename.
- */
-async function writeAtomic(configPath: string, content: string): Promise<void> {
-  const absolutePath = resolve(configPath);
-  const configDir = dirname(absolutePath);
-  await mkdir(configDir, { recursive: true });
-
-  const tempPath = `${absolutePath}.tmp-${Date.now()}-${Math.random().toString(16).slice(2)}`;
-  await writeFile(tempPath, content, "utf-8");
-  await rename(tempPath, absolutePath);
-}
-
-/**
- * Serializes and writes the config file with normalized JSON formatting.
- */
-export async function writeRawConfig(configPath: string, rawConfig: RawGatewayConfig): Promise<void> {
-  const payload = `${JSON.stringify(rawConfig, null, 2)}\n`;
-  await writeAtomic(configPath, payload);
-}
-
-/**
- * Creates a timestamped backup beside the target config file.
- */
-export async function backupConfig(configPath: string): Promise<string | null> {
-  const absolutePath = resolve(configPath);
-  if (!(await fileExists(absolutePath))) {
-    return null;
-  }
-
-  const content = await readFile(absolutePath, "utf-8");
-  const backupPath = `${absolutePath}.bak-${Date.now()}`;
-  await writeFile(backupPath, content, "utf-8");
-  return backupPath;
-}
-
-/**
- * Writes config, validates with loadGatewayConfig, and rolls back on any failure.
- */
-export async function writeConfigWithValidation(
-  configPath: string,
-  rawConfig: RawGatewayConfig,
-  options?: {
-    validate?: boolean;
-    createBackup?: boolean;
-  },
-): Promise<{ backupPath: string | null }> {
-  const absolutePath = resolve(configPath);
-  const validate = options?.validate !== false;
-
-  const previousExists = await fileExists(absolutePath);
-  const previousContent = previousExists ? await readFile(absolutePath, "utf-8") : null;
-  const backupPath = options?.createBackup ? await backupConfig(absolutePath) : null;
-
-  try {
-    await writeRawConfig(absolutePath, rawConfig);
-    if (!validate) {
-      return { backupPath };
-    }
-
-    await loadGatewayConfig(absolutePath);
-    return { backupPath };
-  } catch (error) {
-    if (previousContent === null) {
-      await rm(absolutePath, { force: true });
-    } else {
-      await writeAtomic(absolutePath, previousContent);
-    }
-    throw error;
-  }
-}
-
-/**
- * Reads config and throws a user-oriented error when the file is missing.
- */
-export async function requireRawConfig(configPath: string): Promise<RawGatewayConfig> {
-  const raw = await readRawConfig(configPath);
-  if (!raw) {
-    const resolvedConfigPath = resolve(configPath);
-    const currentResolution = resolveConfigPathInfo();
-    let sourceHint = "";
-    if (resolvedConfigPath === currentResolution.path && currentResolution.source === "env") {
-      sourceHint = ` Source: DOBBY_CONFIG_PATH='${process.env.DOBBY_CONFIG_PATH ?? ""}'.`;
-    } else if (resolvedConfigPath === currentResolution.path && currentResolution.source === "repo") {
-      sourceHint = " Source: detected dobby repo, using ./config/gateway.json.";
-    }
-
-    throw new Error(
-      `Config '${resolvedConfigPath}' does not exist.${sourceHint} Run '${initCommandHint()}' first.`,
-    );
-  }
-  return raw;
-}