@dobby.ai/dobby 0.1.0 → 0.1.2

package/src/cli/commands/extension.ts

@@ -1,205 +0,0 @@
-import { join } from "node:path";
-import { loadGatewayConfig } from "../../core/routing.js";
-import type { GatewayConfig } from "../../core/types.js";
-import { ExtensionStoreManager } from "../../extension/manager.js";
-import {
-  applyContributionTemplates,
-  buildContributionTemplates,
-  ensureGatewayConfigShape,
-  listContributionIds,
-  setDefaultProviderIfMissingOrInvalid,
-  upsertAllowListPackage,
-} from "../shared/config-mutators.js";
-import { readRawConfig, requireRawConfig, resolveConfigPath, resolveDataRootDir, writeConfigWithValidation } from "../shared/config-io.js";
-import type { RawGatewayConfig } from "../shared/config-types.js";
-import { createLogger } from "../shared/runtime.js";
-
-/**
- * Resolves extension store directory from normalized gateway config.
- */
-function extensionStoreDir(config: GatewayConfig): string {
-  return join(config.data.rootDir, "extensions");
-}
-
-/**
- * Resolves extension store directory directly from raw config plus config file location.
- */
-function extensionStoreDirFromRaw(configPath: string, rawConfig: RawGatewayConfig): string {
-  const rootDir = resolveDataRootDir(configPath, rawConfig);
-  return join(rootDir, "extensions");
-}
-
-/**
- * Installs an extension package, optionally enabling it in config and creating instance templates.
- */
-export async function runExtensionInstallCommand(options: {
-  spec: string;
-  enable?: boolean;
-  json?: boolean;
-}): Promise<void> {
-  const configPath = resolveConfigPath();
-  const logger = createLogger();
-
-  const rawConfig = (await readRawConfig(configPath)) ?? {};
-  const manager = new ExtensionStoreManager(logger, extensionStoreDirFromRaw(configPath, rawConfig));
-  const installed = await manager.install(options.spec);
-
-  if (!options.enable) {
-    const templates = buildContributionTemplates(installed.manifest.contributions);
-    if (options.json) {
-      console.log(
-        JSON.stringify(
-          {
-            package: installed.packageName,
-            version: installed.version,
-            contributions: installed.manifest.contributions,
-            templates,
-          },
-          null,
-          2,
-        ),
-      );
-      return;
-    }
-
-    console.log(`Installed ${installed.packageName}@${installed.version}`);
-    console.log("Contributions:");
-    for (const contribution of installed.manifest.contributions) {
-      console.log(`- ${contribution.kind}:${contribution.id} (${contribution.entry})`);
-    }
-
-    console.log("");
-    console.log("allowList template:");
-    console.log(JSON.stringify({ package: installed.packageName, enabled: true }, null, 2));
-
-    console.log("");
-    console.log("instances template:");
-    console.log(JSON.stringify(templates, null, 2));
-    return;
-  }
-
-  const next = ensureGatewayConfigShape(structuredClone(rawConfig));
-  upsertAllowListPackage(next, installed.packageName, true);
-
-  const templates = buildContributionTemplates(installed.manifest.contributions);
-  const addedInstanceIds = applyContributionTemplates(next, templates);
-  setDefaultProviderIfMissingOrInvalid(next);
-
-  await writeConfigWithValidation(configPath, next, {
-    validate: true,
-    createBackup: true,
-  });
-
-  if (options.json) {
-    console.log(
-      JSON.stringify(
-        {
-          package: installed.packageName,
-          version: installed.version,
-          enabled: true,
-          addedInstanceIds,
-        },
-        null,
-        2,
-      ),
-    );
-    return;
-  }
-
-  console.log(`Installed and enabled ${installed.packageName}@${installed.version}`);
-  console.log(`Updated ${configPath}`);
-  if (addedInstanceIds.providers.length > 0 || addedInstanceIds.connectors.length > 0 || addedInstanceIds.sandboxes.length > 0) {
-    console.log("Added instances:");
-    for (const providerId of addedInstanceIds.providers) {
-      console.log(`- provider: ${providerId}`);
-    }
-    for (const connectorId of addedInstanceIds.connectors) {
-      console.log(`- connector: ${connectorId}`);
-    }
-    for (const sandboxId of addedInstanceIds.sandboxes) {
-      console.log(`- sandbox: ${sandboxId}`);
-    }
-  }
-}
-
-/**
- * Uninstalls an extension package from store without mutating config references.
- */
-export async function runExtensionUninstallCommand(options: {
-  packageName: string;
-}): Promise<void> {
-  const configPath = resolveConfigPath();
-  const logger = createLogger();
-  const rawConfig = await requireRawConfig(configPath);
-  const manager = new ExtensionStoreManager(logger, extensionStoreDirFromRaw(configPath, rawConfig));
-
-  await manager.uninstall(options.packageName);
-  console.log(`Uninstalled ${options.packageName}`);
-  console.log("Remember to remove this package from extensions.allowList and related instance references.");
-}
-
-/**
- * Lists installed extension packages with enablement and contribution reference status.
- */
-export async function runExtensionListCommand(options: {
-  json?: boolean;
-}): Promise<void> {
-  const configPath = resolveConfigPath();
-  const logger = createLogger();
-
-  const rawConfig = await requireRawConfig(configPath);
-  const manager = new ExtensionStoreManager(logger, extensionStoreDirFromRaw(configPath, rawConfig));
-  const listed = await manager.listInstalled();
-
-  const normalized = ensureGatewayConfigShape(rawConfig);
-  const allowList = new Map((normalized.extensions?.allowList ?? []).map((item) => [item.package, item.enabled]));
-
-  const configuredContributionIds = listContributionIds(normalized);
-  const configuredContributionSet = new Set([
-    ...configuredContributionIds.providers,
-    ...configuredContributionIds.connectors,
-    ...configuredContributionIds.sandboxes,
-  ]);
-
-  const items = listed.map((item) => {
-    const contributions = item.manifest?.contributions ?? [];
-    const referencedContributions = contributions
-      .filter((contribution) => configuredContributionSet.has(contribution.id))
-      .map((contribution) => `${contribution.kind}:${contribution.id}`);
-
-    return {
-      package: item.packageName,
-      version: item.version,
-      enabled: allowList.get(item.packageName) ?? false,
-      contributions: contributions.map((contribution) => `${contribution.kind}:${contribution.id}`),
-      referencedContributions,
-      ...(item.error ? { error: item.error } : {}),
-    };
-  });
-
-  if (options.json) {
-    console.log(JSON.stringify({ configPath, items }, null, 2));
-    return;
-  }
-
-  if (items.length === 0) {
-    const config = await loadGatewayConfig(configPath);
-    console.log(`No extensions installed in ${extensionStoreDir(config)}`);
-    return;
-  }
-
-  console.log(`Extensions in ${extensionStoreDirFromRaw(configPath, normalized)}:`);
-  for (const item of items) {
-    const suffix = item.enabled ? "enabled" : "disabled";
-    if (item.error) {
-      console.log(`- ${item.package}@${item.version} (${suffix}, invalid: ${item.error})`);
-      continue;
-    }
-
-    console.log(`- ${item.package}@${item.version} (${suffix})`);
-    for (const contribution of item.contributions) {
-      const isReferenced = item.referencedContributions.includes(contribution);
-      console.log(`  * ${contribution}${isReferenced ? " [referenced]" : ""}`);
-    }
-  }
-}

package/src/cli/commands/init.ts

@@ -1,396 +0,0 @@
-import {
-  cancel,
-  confirm,
-  intro,
-  isCancel,
-  multiselect,
-  note,
-  outro,
-  password,
-  select,
-  spinner,
-  text,
-} from "@clack/prompts";
-import { ExtensionStoreManager } from "../../extension/manager.js";
-import {
-  ensureGatewayConfigShape,
-  upsertAllowListPackage,
-  upsertBinding,
-  upsertConnectorInstance,
-  upsertProviderInstance,
-  upsertRoute,
-} from "../shared/config-mutators.js";
-import { DEFAULT_DISCORD_BOT_NAME } from "../shared/discord-config.js";
-import { applyAndValidateContributionSchemas, loadContributionSchemaCatalog } from "../shared/config-schema.js";
-import {
-  readRawConfig,
-  resolveConfigPath,
-  resolveDataRootDir,
-  writeConfigWithValidation,
-} from "../shared/config-io.js";
-import {
-  createInitSelectionConfig,
-  isInitConnectorChoiceId,
-  isInitProviderChoiceId,
-  listInitConnectorChoices,
-  listInitProviderChoices,
-  type InitConnectorChoiceId,
-  type InitProviderChoiceId,
-} from "../shared/init-catalog.js";
-import { ensureProviderPiModelsFile } from "../shared/init-models-file.js";
-import { createLogger } from "../shared/runtime.js";
-import { promptConfigFromSchema } from "../shared/schema-prompts.js";
-
-interface InitInput {
-  providerChoiceIds: InitProviderChoiceId[];
-  routeProviderChoiceId: InitProviderChoiceId;
-  connectorChoiceId: InitConnectorChoiceId;
-  projectRoot: string;
-  channelId: string;
-  routeId: string;
-  botName: string;
-  botToken: string;
-  allowAllMessages: boolean;
-}
-
-/**
- * Repeatedly prompts for non-empty text input and aborts cleanly on cancel.
- */
-async function promptRequiredText(params: {
-  message: string;
-  placeholder?: string;
-  initialValue?: string;
-}): Promise<string> {
-  while (true) {
-    const promptOptions = {
-      message: params.message,
-      ...(params.placeholder !== undefined ? { placeholder: params.placeholder } : {}),
-      ...(params.initialValue !== undefined ? { initialValue: params.initialValue } : {}),
-    };
-    const result = await text(promptOptions);
-    if (isCancel(result)) {
-      cancel("Initialization cancelled.");
-      throw new Error("Initialization cancelled.");
-    }
-
-    const value = String(result ?? "").trim();
-    if (value.length > 0) {
-      return value;
-    }
-
-    await note("This field is required.", "Validation");
-  }
-}
-
-/**
- * Collects init inputs from interactive prompts.
- */
-async function collectInitInput(): Promise<InitInput> {
-  intro("dobby init");
-
-  const providerChoices = listInitProviderChoices();
-  const providerChoiceResult = await multiselect({
-    message: "Choose provider(s) (space to select multiple)",
-    options: providerChoices.map((item) => ({
-      value: item.id,
-      label: item.label,
-    })),
-    initialValues: ["provider.pi"],
-    required: true,
-  });
-  if (isCancel(providerChoiceResult)) {
-    cancel("Initialization cancelled.");
-    throw new Error("Initialization cancelled.");
-  }
-  const providerChoiceIds = (providerChoiceResult as unknown[]).map((value) => String(value));
-  if (providerChoiceIds.length === 0) {
-    throw new Error("At least one provider must be selected");
-  }
-  if (!providerChoiceIds.every((providerChoiceId) => isInitProviderChoiceId(providerChoiceId))) {
-    const invalidChoice = providerChoiceIds.find((providerChoiceId) => !isInitProviderChoiceId(providerChoiceId));
-    throw new Error(`Unsupported provider choice '${invalidChoice}'`);
-  }
-  const providerChoicesById = new Map(providerChoices.map((choice) => [choice.id, choice]));
-
-  let routeProviderChoiceId = providerChoiceIds[0] as InitProviderChoiceId;
-  if (providerChoiceIds.length > 1) {
-    const routeProviderChoiceResult = await select({
-      message: "Choose provider for the default route",
-      options: providerChoiceIds.map((providerChoiceId) => ({
-        value: providerChoiceId,
-        label: providerChoicesById.get(providerChoiceId as InitProviderChoiceId)?.label ?? providerChoiceId,
-      })),
-      initialValue: providerChoiceIds[0],
-    });
-    if (isCancel(routeProviderChoiceResult)) {
-      cancel("Initialization cancelled.");
-      throw new Error("Initialization cancelled.");
-    }
-
-    const routeProviderCandidate = String(routeProviderChoiceResult);
-    if (!isInitProviderChoiceId(routeProviderCandidate) || !providerChoiceIds.includes(routeProviderCandidate)) {
-      throw new Error(`Unsupported route provider choice '${routeProviderCandidate}'`);
-    }
-    routeProviderChoiceId = routeProviderCandidate;
-  }
-
-  const connectorChoices = listInitConnectorChoices();
-  const connectorChoiceResult = await select({
-    message: "Choose connector",
-    options: connectorChoices.map((item) => ({
-      value: item.id,
-      label: item.label,
-    })),
-    initialValue: "connector.discord",
-  });
-  if (isCancel(connectorChoiceResult)) {
-    cancel("Initialization cancelled.");
-    throw new Error("Initialization cancelled.");
-  }
-  const connectorChoiceId = String(connectorChoiceResult);
-  if (!isInitConnectorChoiceId(connectorChoiceId)) {
-    throw new Error(`Unsupported connector choice '${connectorChoiceId}'`);
-  }
-
-  const projectRoot = await promptRequiredText({
-    message: "Project root",
-    initialValue: process.cwd(),
-  });
-
-  const channelId = await promptRequiredText({
-    message: "Discord channel ID",
-    placeholder: "1234567890",
-  });
-
-  const routeIdResult = await text({
-    message: "Route ID",
-    initialValue: "main",
-  });
-  if (isCancel(routeIdResult)) {
-    cancel("Initialization cancelled.");
-    throw new Error("Initialization cancelled.");
-  }
-
-  const botNameResult = await text({
-    message: "Discord bot name",
-    initialValue: DEFAULT_DISCORD_BOT_NAME,
-  });
-  if (isCancel(botNameResult)) {
-    cancel("Initialization cancelled.");
-    throw new Error("Initialization cancelled.");
-  }
-
-  const botTokenResult = await password({
-    message: "Discord bot token",
-    mask: "*",
-    validate: (value) => (value.trim().length > 0 ? undefined : "Token is required"),
-  });
-  if (isCancel(botTokenResult)) {
-    cancel("Initialization cancelled.");
-    throw new Error("Initialization cancelled.");
-  }
-
-  const allowAllMessagesResult = await confirm({
-    message: "Allow all group messages (not mention-only)?",
-    initialValue: false,
-  });
-  if (isCancel(allowAllMessagesResult)) {
-    cancel("Initialization cancelled.");
-    throw new Error("Initialization cancelled.");
-  }
-
-  return {
-    providerChoiceIds: providerChoiceIds as InitProviderChoiceId[],
-    routeProviderChoiceId,
-    connectorChoiceId,
-    projectRoot,
-    channelId,
-    routeId: String(routeIdResult ?? "").trim() || "main",
-    botName: String(botNameResult ?? "").trim() || DEFAULT_DISCORD_BOT_NAME,
-    botToken: String(botTokenResult ?? "").trim(),
-    allowAllMessages: allowAllMessagesResult === true,
-  };
-}
-
-/**
- * Executes first-time initialization: install required extensions, write config, then validate.
- */
-export async function runInitCommand(): Promise<void> {
-  const configPath = resolveConfigPath();
-  const existingConfig = await readRawConfig(configPath);
-  if (existingConfig) {
-    throw new Error(
-      `Config '${configPath}' already exists. Use 'dobby config edit' or 'dobby configure' to update existing values.`,
-    );
-  }
-
-  const input = await collectInitInput();
-  const selected = createInitSelectionConfig(input.providerChoiceIds, input.connectorChoiceId, {
-    routeId: input.routeId,
-    projectRoot: input.projectRoot,
-    allowAllMessages: input.allowAllMessages,
-    botName: input.botName,
-    botToken: input.botToken,
-    channelId: input.channelId,
-    routeProviderChoiceId: input.routeProviderChoiceId,
-  });
-
-  const next = ensureGatewayConfigShape({});
-
-  const rootDir = resolveDataRootDir(configPath, next);
-  const manager = new ExtensionStoreManager(createLogger(), `${rootDir}/extensions`);
-
-  const installSpinner = spinner();
-  installSpinner.start(`Installing required extensions (${selected.extensionPackages.length} packages)`);
-  try {
-    const installedPackages = await manager.installMany(selected.extensionPackages);
-    for (const installed of installedPackages) {
-      upsertAllowListPackage(next, installed.packageName, true);
-    }
-    installSpinner.stop("Extensions installed");
-  } catch (error) {
-    installSpinner.stop("Extension installation failed");
-    throw error;
-  }
-
-  const catalog = await loadContributionSchemaCatalog(configPath, next);
-  const schemaByContributionId = new Map(
-    catalog
-      .filter((item) => item.configSchema)
-      .map((item) => [item.contributionId, item.configSchema!] as const),
-  );
-  const schemaStateByContributionId = new Map(
-    catalog.map((item) => [item.contributionId, item.configSchema ? "with_schema" : "without_schema"] as const),
-  );
-  const warnedSchemaFallback = new Set<string>();
-  const noteSchemaFallback = async (contributionId: string): Promise<"without_schema" | "not_loaded"> => {
-    if (warnedSchemaFallback.has(contributionId)) {
-      const existingState = schemaStateByContributionId.get(contributionId);
-      return existingState === "without_schema" ? "without_schema" : "not_loaded";
-    }
-    warnedSchemaFallback.add(contributionId);
-
-    const state = schemaStateByContributionId.get(contributionId);
-    if (state === "without_schema") {
-      await note(
-        `Contribution '${contributionId}' is loaded but does not expose configSchema. Falling back to built-in defaults/JSON.`,
-        "Schema",
-      );
-      return "without_schema";
-    }
-
-    await note(
-      `No loaded schema for contribution '${contributionId}'. The extension may be disabled or not installed.`,
-      "Schema",
-    );
-    return "not_loaded";
-  };
-
-  const resolveFallbackConfig = async (
-    kind: "provider" | "connector",
-    instanceId: string,
-    contributionId: string,
-    fallbackConfig: Record<string, unknown>,
-  ): Promise<Record<string, unknown>> => {
-    const state = await noteSchemaFallback(contributionId);
-    if (state === "not_loaded") {
-      throw new Error(
-        `Cannot initialize ${kind} '${instanceId}' because schema for contribution '${contributionId}' is not loaded. ` +
-        `Ensure the extension is installed and enabled, then retry.`,
-      );
-    }
-    return fallbackConfig;
-  };
-
-  for (const provider of selected.providerInstances) {
-    const schema = schemaByContributionId.get(provider.contributionId);
-    const providerConfig = schema
-      ? await promptConfigFromSchema(schema, provider.config, {
-        title: `Provider '${provider.instanceId}' (${provider.contributionId})`,
-      })
-      : await resolveFallbackConfig("provider", provider.instanceId, provider.contributionId, provider.config);
-    upsertProviderInstance(next, provider.instanceId, provider.contributionId, providerConfig);
-  }
-
-  const connectorSchema = schemaByContributionId.get(selected.connectorContributionId);
-  const connectorConfig = selected.connectorContributionId === "connector.discord"
-    ? selected.connectorConfig
-    : connectorSchema
-      ? await promptConfigFromSchema(connectorSchema, selected.connectorConfig, {
-        title: `Connector '${selected.connectorInstanceId}' (${selected.connectorContributionId})`,
-      })
-      : await resolveFallbackConfig(
-        "connector",
-        selected.connectorInstanceId,
-        selected.connectorContributionId,
-        selected.connectorConfig,
-      );
-  upsertConnectorInstance(next, selected.connectorInstanceId, selected.connectorContributionId, connectorConfig);
-
-  next.providers = {
-    ...next.providers,
-    default: selected.providerInstanceId,
-    items: next.providers.items,
-  };
-  next.routes = {
-    ...next.routes,
-    defaults: {
-      ...next.routes.defaults,
-      provider: selected.providerInstanceId,
-    },
-  };
-
-  upsertRoute(next, input.routeId, {
-    ...selected.routeProfile,
-    projectRoot: input.projectRoot,
-  });
-  upsertBinding(next, selected.bindingId, selected.bindingConfig);
-
-  const validatedConfig = await applyAndValidateContributionSchemas(configPath, next);
-
-  const createdModelsFiles: string[] = [];
-  for (const provider of selected.providerInstances) {
-    if (provider.contributionId !== "provider.pi") {
-      continue;
-    }
-
-    const resolvedProvider = validatedConfig.providers?.items?.[provider.instanceId];
-    const { type: _type, ...providerConfig } = resolvedProvider ?? {};
-    const ensured = await ensureProviderPiModelsFile(configPath, Object.keys(providerConfig).length > 0 ? providerConfig : provider.config);
-    if (ensured.created) {
-      createdModelsFiles.push(ensured.path);
-    }
-  }
-
-  await writeConfigWithValidation(configPath, validatedConfig, {
-    validate: true,
-    createBackup: false,
-  });
-
-  outro("Initialization completed.");
-
-  console.log(`Config written: ${configPath}`);
-  if (createdModelsFiles.length > 0) {
-    console.log("Generated model files:");
-    for (const path of createdModelsFiles) {
-      console.log(`- ${path}`);
-    }
-  }
-  console.log("Next steps:");
-  console.log("1. dobby start");
-
-  const showHint = await confirm({
-    message: "Show quick validation commands?",
-    initialValue: true,
-  });
-
-  if (!isCancel(showHint) && showHint) {
-    await note(
-      [
-        "dobby extension list",
-        "dobby doctor",
-      ].join("\n"),
-      "Validation",
-    );
-  }
-}