@dobby.ai/dobby 0.1.0 → 0.1.2

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

@@ -1,228 +0,0 @@
-import { Ajv, type ErrorObject, type ValidateFunction } from "ajv";
-import { join } from "node:path";
-import pino from "pino";
-import type { ExtensionKind } from "../../core/types.js";
-import { ExtensionLoader } from "../../extension/loader.js";
-import { ExtensionRegistry } from "../../extension/registry.js";
-import { ensureGatewayConfigShape } from "./config-mutators.js";
-import { resolveDataRootDir } from "./config-io.js";
-import type { RawExtensionItemConfig, RawGatewayConfig } from "./config-types.js";
-
-export interface ContributionSchemaCatalogEntry {
-  contributionId: string;
-  packageName: string;
-  kind: ExtensionKind;
-  configSchema?: Record<string, unknown>;
-}
-
-export interface ContributionSchemaListItem {
-  contributionId: string;
-  packageName: string;
-  kind: ExtensionKind;
-  hasSchema: boolean;
-}
-
-interface InstanceValidationTask {
-  section: "providers" | "connectors" | "sandboxes";
-  instanceId: string;
-  instance: RawExtensionItemConfig;
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
-
-function decodeJsonPointerSegment(value: string): string {
-  return value.replaceAll("~1", "/").replaceAll("~0", "~");
-}
-
-function normalizeSchemaForValidation(schema: Record<string, unknown>): Record<string, unknown> {
-  const cloned = structuredClone(schema);
-  if (isRecord(cloned) && typeof cloned.$schema === "string") {
-    delete cloned.$schema;
-  }
-  return cloned;
-}
-
-function formatErrorPath(instancePath: string): string {
-  if (!instancePath) {
-    return "";
-  }
-
-  const segments = instancePath
-    .split("/")
-    .slice(1)
-    .map((segment) => decodeJsonPointerSegment(segment))
-    .filter((segment) => segment.length > 0);
-
-  if (segments.length === 0) {
-    return "";
-  }
-
-  let formatted = "";
-  for (const segment of segments) {
-    if (/^\d+$/.test(segment)) {
-      formatted += `[${segment}]`;
-      continue;
-    }
-
-    if (/^[a-zA-Z_$][\w$]*$/.test(segment)) {
-      formatted += `.${segment}`;
-      continue;
-    }
-
-    formatted += `['${segment.replaceAll("'", "\\'")}']`;
-  }
-
-  return formatted;
-}
-
-function buildValidationErrorMessage(
-  task: InstanceValidationTask,
-  contributionId: string,
-  errors: ErrorObject[] | null | undefined,
-): string {
-  const details = (errors ?? [])
-    .slice(0, 5)
-    .map((error) => {
-      const suffix = formatErrorPath(error.instancePath);
-      return `${task.section}.items['${task.instanceId}']${suffix}: ${error.message ?? "invalid"}`;
-    })
-    .join("; ");
-
-  return (
-    `Invalid config for instance '${task.instanceId}' (contribution '${contributionId}'). `
-    + (details.length > 0 ? details : "Schema validation failed.")
-  );
-}
-
-async function loadRegistryForConfig(
-  configPath: string,
-  rawConfig: RawGatewayConfig,
-): Promise<ExtensionRegistry> {
-  const normalized = ensureGatewayConfigShape(structuredClone(rawConfig));
-  const rootDir = resolveDataRootDir(configPath, normalized);
-  const loader = new ExtensionLoader(pino({ name: "dobby.config-schema", level: "silent" }), {
-    extensionsDir: join(rootDir, "extensions"),
-  });
-  const loadedPackages = await loader.loadAllowList(normalized.extensions.allowList);
-  const registry = new ExtensionRegistry();
-  registry.registerPackages(loadedPackages);
-  return registry;
-}
-
-/**
- * Loads contribution-level JSON Schema catalog from installed/allow-listed extensions.
- */
-export async function loadContributionSchemaCatalog(
-  configPath: string,
-  rawConfig: RawGatewayConfig,
-): Promise<ContributionSchemaCatalogEntry[]> {
-  const registry = await loadRegistryForConfig(configPath, rawConfig);
-  return registry.listContributionSchemas();
-}
-
-/**
- * Lists available contribution schemas with lightweight flags for CLI display.
- */
-export async function listContributionSchemas(
-  configPath: string,
-  rawConfig: RawGatewayConfig,
-): Promise<ContributionSchemaListItem[]> {
-  const catalog = await loadContributionSchemaCatalog(configPath, rawConfig);
-  return catalog.map((item) => ({
-    contributionId: item.contributionId,
-    packageName: item.packageName,
-    kind: item.kind,
-    hasSchema: Boolean(item.configSchema),
-  }));
-}
-
-/**
- * Returns one contribution schema entry, or null when not found.
- */
-export async function getContributionSchema(
-  configPath: string,
-  rawConfig: RawGatewayConfig,
-  contributionId: string,
-): Promise<ContributionSchemaCatalogEntry | null> {
-  const catalog = await loadContributionSchemaCatalog(configPath, rawConfig);
-  return catalog.find((item) => item.contributionId === contributionId) ?? null;
-}
-
-/**
- * Applies extension config defaults and validates provider/connector/sandbox instance configs with Ajv.
- */
-export async function applyAndValidateContributionSchemas(
-  configPath: string,
-  rawConfig: RawGatewayConfig,
-): Promise<RawGatewayConfig> {
-  const next = ensureGatewayConfigShape(structuredClone(rawConfig));
-  const catalog = await loadContributionSchemaCatalog(configPath, next);
-
-  const schemaByContribution = new Map<string, Record<string, unknown>>();
-  for (const entry of catalog) {
-    if (!entry.configSchema) {
-      continue;
-    }
-    schemaByContribution.set(entry.contributionId, normalizeSchemaForValidation(entry.configSchema));
-  }
-
-  const ajv = new Ajv({
-    allErrors: true,
-    strict: false,
-    useDefaults: true,
-  });
-  const validators = new Map<string, ValidateFunction>();
-
-  const tasks: InstanceValidationTask[] = [
-    ...Object.entries(next.providers.items).map(([instanceId, instance]) => ({
-      section: "providers" as const,
-      instanceId,
-      instance,
-    })),
-    ...Object.entries(next.connectors.items).map(([instanceId, instance]) => ({
-      section: "connectors" as const,
-      instanceId,
-      instance,
-    })),
-    ...Object.entries(next.sandboxes.items).map(([instanceId, instance]) => ({
-      section: "sandboxes" as const,
-      instanceId,
-      instance,
-    })),
-  ];
-
-  for (const task of tasks) {
-    const contributionId = task.instance.type;
-    const schema = schemaByContribution.get(contributionId);
-    if (!schema) {
-      continue;
-    }
-
-    let validate = validators.get(contributionId);
-    if (!validate) {
-      const compiled = ajv.compile(schema) as ValidateFunction;
-      validators.set(contributionId, compiled);
-      validate = compiled;
-    }
-
-    const { type: _type, ...instanceConfig } = task.instance;
-    const valid = validate(instanceConfig);
-    if (!valid) {
-      throw new Error(buildValidationErrorMessage(task, contributionId, validate.errors));
-    }
-
-    for (const key of Object.keys(task.instance)) {
-      if (key !== "type") {
-        delete task.instance[key];
-      }
-    }
-    Object.assign(task.instance, {
-      type: contributionId,
-      ...instanceConfig,
-    });
-  }
-
-  return next;
-}

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

@@ -1,121 +0,0 @@
-export interface RawExtensionPackageConfig {
-  package: string;
-  enabled?: boolean;
-}
-
-export interface RawExtensionItemConfig {
-  type: string;
-  [key: string]: unknown;
-}
-
-export interface RawRouteDefaults {
-  provider?: string;
-  sandbox?: string;
-  tools?: "full" | "readonly";
-  mentions?: "required" | "optional";
-  [key: string]: unknown;
-}
-
-export interface RawRouteProfile {
-  projectRoot: string;
-  tools?: "full" | "readonly";
-  systemPromptFile?: string;
-  mentions?: "required" | "optional";
-  provider?: string;
-  sandbox?: string;
-  [key: string]: unknown;
-}
-
-export interface RawBindingConfig {
-  connector: string;
-  source: {
-    type: "channel" | "chat";
-    id: string;
-    [key: string]: unknown;
-  };
-  route: string;
-  [key: string]: unknown;
-}
-
-export interface RawGatewayConfig {
-  extensions?: {
-    allowList?: RawExtensionPackageConfig[];
-    [key: string]: unknown;
-  };
-  providers?: {
-    default?: string;
-    items?: Record<string, RawExtensionItemConfig>;
-    [key: string]: unknown;
-  };
-  connectors?: {
-    items?: Record<string, RawExtensionItemConfig>;
-    [key: string]: unknown;
-  };
-  sandboxes?: {
-    default?: string;
-    items?: Record<string, RawExtensionItemConfig>;
-    [key: string]: unknown;
-  };
-  routes?: {
-    defaults?: RawRouteDefaults;
-    items?: Record<string, RawRouteProfile>;
-    [key: string]: unknown;
-  };
-  bindings?: {
-    items?: Record<string, RawBindingConfig>;
-    [key: string]: unknown;
-  };
-  data?: {
-    rootDir?: string;
-    dedupTtlMs?: number;
-    [key: string]: unknown;
-  };
-  [key: string]: unknown;
-}
-
-export interface NormalizedGatewayConfig extends RawGatewayConfig {
-  extensions: {
-    allowList: RawExtensionPackageConfig[];
-    [key: string]: unknown;
-  };
-  providers: {
-    default: string;
-    items: Record<string, RawExtensionItemConfig>;
-    [key: string]: unknown;
-  };
-  connectors: {
-    items: Record<string, RawExtensionItemConfig>;
-    [key: string]: unknown;
-  };
-  sandboxes: {
-    default: string;
-    items: Record<string, RawExtensionItemConfig>;
-    [key: string]: unknown;
-  };
-  routes: {
-    defaults: RawRouteDefaults;
-    items: Record<string, RawRouteProfile>;
-    [key: string]: unknown;
-  };
-  bindings: {
-    items: Record<string, RawBindingConfig>;
-    [key: string]: unknown;
-  };
-  data: {
-    rootDir: string;
-    dedupTtlMs: number;
-    [key: string]: unknown;
-  };
-}
-
-export interface ContributionInstanceTemplate {
-  id: string;
-  type: string;
-  config: Record<string, unknown>;
-}
-
-export interface ContributionTemplatesByKind {
-  providers: ContributionInstanceTemplate[];
-  connectors: ContributionInstanceTemplate[];
-  sandboxes: ContributionInstanceTemplate[];
-}