@agentvoy/core 0.2.0 → 0.4.0

package/src/config.ts

@@ -1,315 +0,0 @@
-/**
- * AgentVoy Config Parser
- *
- * Loads, validates, and manages agent.guard.yml configuration files.
- * This is the core innovation — a universal, declarative guardrails
- * config that works across all agent frameworks.
- */
-
-import { readFileSync, existsSync } from "node:fs";
-import { resolve, dirname } from "node:path";
-import { parse as parseYaml, stringify as stringifyYaml } from "yaml";
-import type {
-  AgentGuardConfig,
-  ValidationResult,
-  ValidationError,
-  ValidationWarning,
-} from "./types.js";
-
-const CONFIG_FILENAMES = [
-  "agent.guard.yml",
-  "agent.guard.yaml",
-  "agentguard.yml",
-  "agentguard.yaml",
-];
-
-/**
- * Load and parse an agent.guard.yml config file
- */
-export function loadConfig(projectDir: string): AgentGuardConfig {
-  const configPath = findConfigFile(projectDir);
-  if (!configPath) {
-    throw new ConfigError(
-      `No agent.guard.yml found in ${projectDir}. Run 'agentvoy init' to create one.`
-    );
-  }
-
-  const raw = readFileSync(configPath, "utf-8");
-  const parsed = parseYaml(raw);
-
-  if (!parsed || typeof parsed !== "object") {
-    throw new ConfigError(`Invalid config file: ${configPath}`);
-  }
-
-  const validation = validateConfig(parsed as AgentGuardConfig);
-  if (!validation.valid) {
-    const errorMessages = validation.errors
-      .map((e) => `  - ${e.field}: ${e.message}`)
-      .join("\n");
-    throw new ConfigError(
-      `Invalid agent.guard.yml:\n${errorMessages}`
-    );
-  }
-
-  return applyDefaults(parsed as AgentGuardConfig);
-}
-
-/**
- * Find the config file by searching up the directory tree
- */
-export function findConfigFile(startDir: string): string | null {
-  let dir = resolve(startDir);
-
-  while (true) {
-    for (const filename of CONFIG_FILENAMES) {
-      const filePath = resolve(dir, filename);
-      if (existsSync(filePath)) {
-        return filePath;
-      }
-    }
-
-    const parentDir = dirname(dir);
-    if (parentDir === dir) break;
-    dir = parentDir;
-  }
-
-  return null;
-}
-
-/**
- * Validate an agent guard config
- */
-export function validateConfig(config: AgentGuardConfig): ValidationResult {
-  const errors: ValidationError[] = [];
-  const warnings: ValidationWarning[] = [];
-
-  // Required fields
-  if (!config.version) {
-    errors.push({ field: "version", message: "version is required" });
-  }
-
-  if (!config.identity) {
-    errors.push({ field: "identity", message: "identity is required" });
-  } else if (!config.identity.name) {
-    errors.push({ field: "identity.name", message: "agent name is required" });
-  }
-
-  if (!config.model) {
-    errors.push({ field: "model", message: "model configuration is required" });
-  } else {
-    if (!config.model.provider) {
-      errors.push({
-        field: "model.provider",
-        message: "model provider is required",
-      });
-    }
-    if (!config.model.model) {
-      errors.push({ field: "model.model", message: "model name is required" });
-    }
-  }
-
-  // Validate permissions
-  if (config.permissions?.network) {
-    const net = config.permissions.network;
-    if (net.mode === "restricted" && !net.allow?.length) {
-      warnings.push({
-        field: "permissions.network",
-        message:
-          "network mode is 'restricted' but no allow list specified — all network access will be blocked",
-      });
-    }
-  }
-
-  // Validate guardrails
-  if (config.guardrails?.behavior) {
-    const behavior = config.guardrails.behavior;
-    if (behavior.max_iterations !== undefined && behavior.max_iterations < 1) {
-      errors.push({
-        field: "guardrails.behavior.max_iterations",
-        message: "max_iterations must be at least 1",
-      });
-    }
-    if (behavior.timeout) {
-      if (!isValidDuration(behavior.timeout)) {
-        errors.push({
-          field: "guardrails.behavior.timeout",
-          message:
-            'timeout must be a valid duration string (e.g., "5m", "1h", "30s")',
-        });
-      }
-    }
-    if (behavior.cost_limit) {
-      if (!isValidCost(behavior.cost_limit)) {
-        errors.push({
-          field: "guardrails.behavior.cost_limit",
-          message:
-            'cost_limit must be a valid cost string (e.g., "$0.50", "$10")',
-        });
-      }
-    }
-  }
-
-  // Validate auth
-  if (config.auth) {
-    const validTypes = ["none", "api_key", "oauth2", "jwt"];
-    if (config.auth.type && !validTypes.includes(config.auth.type)) {
-      errors.push({
-        field: "auth.type",
-        message: `auth type must be one of: ${validTypes.join(", ")}`,
-      });
-    }
-  }
-
-  return {
-    valid: errors.length === 0,
-    errors,
-    warnings,
-  };
-}
-
-/**
- * Apply default values to a config
- */
-function applyDefaults(config: AgentGuardConfig): AgentGuardConfig {
-  return {
-    ...config,
-    version: config.version || "1.0",
-    permissions: {
-      network: { mode: "unrestricted", ...config.permissions?.network },
-      filesystem: { ...config.permissions?.filesystem },
-      tools: { ...config.permissions?.tools },
-      execution: {
-        allow_shell: false,
-        allow_subprocess: false,
-        ...config.permissions?.execution,
-      },
-    },
-    guardrails: {
-      input: {
-        block_prompt_injection: true,
-        pii_detection: "warn",
-        content_filter: "moderate",
-        ...config.guardrails?.input,
-      },
-      output: {
-        block_harmful_content: true,
-        pii_redaction: false,
-        hallucination_check: false,
-        ...config.guardrails?.output,
-      },
-      behavior: {
-        max_iterations: 50,
-        timeout: "10m",
-        retry_limit: 3,
-        ...config.guardrails?.behavior,
-      },
-    },
-    auth: config.auth || { type: "none" },
-    observability: {
-      tracing: false,
-      log_level: "info",
-      cost_tracking: true,
-      ...config.observability,
-    },
-  };
-}
-
-/**
- * Generate a default agent.guard.yml config
- */
-export function generateDefaultConfig(
-  agentName: string,
-  provider: string,
-  model: string
-): string {
-  const config: AgentGuardConfig = {
-    version: "1.0",
-    identity: {
-      name: agentName,
-      description: `AI agent created with AgentVoy`,
-      version: "0.1.0",
-    },
-    model: {
-      provider: provider as AgentGuardConfig["model"]["provider"],
-      model,
-      api_key_env: getDefaultApiKeyEnv(provider),
-    },
-    permissions: {
-      network: {
-        mode: "restricted",
-        allow: ["*"],
-      },
-      filesystem: {
-        read: ["./**"],
-        write: ["./output/**"],
-      },
-      tools: {
-        require_approval: ["delete_*", "send_*", "deploy_*"],
-        max_cost_per_run: "$1.00",
-      },
-      execution: {
-        allow_shell: false,
-        allow_subprocess: false,
-      },
-    },
-    guardrails: {
-      input: {
-        block_prompt_injection: true,
-        max_tokens: 4096,
-        pii_detection: "warn",
-        content_filter: "moderate",
-      },
-      output: {
-        block_harmful_content: true,
-        max_output_tokens: 8192,
-        pii_redaction: false,
-        hallucination_check: false,
-      },
-      behavior: {
-        max_iterations: 20,
-        timeout: "5m",
-        max_tool_calls: 50,
-        human_approval_after: 10,
-        retry_limit: 3,
-        cost_limit: "$1.00",
-      },
-    },
-    auth: {
-      type: "api_key",
-      token_storage: "env",
-    },
-    observability: {
-      tracing: true,
-      log_level: "info",
-      cost_tracking: true,
-    },
-  };
-
-  return stringifyYaml(config, { lineWidth: 0 });
-}
-
-function getDefaultApiKeyEnv(provider: string): string {
-  const envMap: Record<string, string> = {
-    openai: "OPENAI_API_KEY",
-    anthropic: "ANTHROPIC_API_KEY",
-    google: "GOOGLE_API_KEY",
-    groq: "GROQ_API_KEY",
-    mistral: "MISTRAL_API_KEY",
-  };
-  return envMap[provider] || `${provider.toUpperCase()}_API_KEY`;
-}
-
-function isValidDuration(duration: string): boolean {
-  return /^\d+[smhd]$/.test(duration);
-}
-
-function isValidCost(cost: string): boolean {
-  return /^\$\d+(\.\d{1,2})?$/.test(cost);
-}
-
-export class ConfigError extends Error {
-  constructor(message: string) {
-    super(message);
-    this.name = "ConfigError";
-  }
-}

package/src/index.ts

@@ -1,54 +0,0 @@
-/**
- * @agentvoy/core
- *
- * The universal agent development platform.
- * Scaffold, configure, and guard AI agents across any framework.
- *
- * https://github.com/agentvoy
- */
-
-// Types
-export type {
-  Framework,
-  ModelProvider,
-  AgentGuardConfig,
-  AgentIdentity,
-  ModelConfig,
-  PermissionsConfig,
-  NetworkPermissions,
-  FilesystemPermissions,
-  ToolPermissions,
-  ExecutionPermissions,
-  GuardrailsConfig,
-  InputGuardrails,
-  OutputGuardrails,
-  BehaviorGuardrails,
-  AuthConfig,
-  ObservabilityConfig,
-  FrameworkAdapter,
-  ScaffoldConfig,
-  ScaffoldResult,
-  GeneratedFile,
-  ValidationResult,
-  ValidationError,
-  ValidationWarning,
-  ProjectConfig,
-} from "./types.js";
-
-// Config
-export {
-  loadConfig,
-  findConfigFile,
-  validateConfig,
-  generateDefaultConfig,
-  ConfigError,
-} from "./config.js";
-
-// Adapters
-export {
-  registerAdapter,
-  getAdapter,
-  listAdapters,
-  listFrameworks,
-  hasAdapter,
-} from "./adapters/index.js";

package/src/types.ts

@@ -1,203 +0,0 @@
-/**
- * AgentVoy Core Types
- *
- * These types define the universal agent configuration, guardrails,
- * and framework adapter interfaces that power AgentVoy.
- */
-
-// ─── Supported Frameworks ────────────────────────────────────────
-
-export type Framework =
-  | "google-adk"
-  | "openai"
-  | "anthropic"
-  | "crewai"
-  | "langgraph"
-  | "llamaindex"
-  | "autogen"
-  | "custom";
-
-export type ModelProvider =
-  | "openai"
-  | "anthropic"
-  | "google"
-  | "ollama"
-  | "groq"
-  | "mistral"
-  | "azure"
-  | "bedrock"
-  | "custom";
-
-// ─── Agent Guard Config (agent.guard.yml) ────────────────────────
-
-export interface AgentGuardConfig {
-  version: string;
-  identity: AgentIdentity;
-  model: ModelConfig;
-  permissions: PermissionsConfig;
-  guardrails: GuardrailsConfig;
-  auth?: AuthConfig;
-  observability?: ObservabilityConfig;
-}
-
-export interface AgentIdentity {
-  name: string;
-  description?: string;
-  owner?: string;
-  version?: string;
-  tags?: string[];
-}
-
-export interface ModelConfig {
-  provider: ModelProvider;
-  model: string;
-  api_key_env?: string;
-  temperature?: number;
-  max_tokens?: number;
-  base_url?: string;
-}
-
-export interface PermissionsConfig {
-  network?: NetworkPermissions;
-  filesystem?: FilesystemPermissions;
-  tools?: ToolPermissions;
-  execution?: ExecutionPermissions;
-}
-
-export interface NetworkPermissions {
-  allow?: string[];
-  deny?: string[];
-  mode?: "unrestricted" | "restricted" | "blocked";
-}
-
-export interface FilesystemPermissions {
-  read?: string[];
-  write?: string[];
-  deny?: string[];
-}
-
-export interface ToolPermissions {
-  allowed?: string[];
-  denied?: string[];
-  require_approval?: string[];
-  max_cost_per_run?: string;
-}
-
-export interface ExecutionPermissions {
-  allow_shell?: boolean;
-  allow_subprocess?: boolean;
-  allowed_commands?: string[];
-  denied_commands?: string[];
-}
-
-export interface GuardrailsConfig {
-  input?: InputGuardrails;
-  output?: OutputGuardrails;
-  behavior?: BehaviorGuardrails;
-}
-
-export interface InputGuardrails {
-  block_prompt_injection?: boolean;
-  max_tokens?: number;
-  pii_detection?: "block" | "warn" | "off";
-  content_filter?: "strict" | "moderate" | "off";
-  custom_validators?: string[];
-}
-
-export interface OutputGuardrails {
-  block_harmful_content?: boolean;
-  validate_schema?: string;
-  max_output_tokens?: number;
-  pii_redaction?: boolean;
-  hallucination_check?: boolean;
-  custom_validators?: string[];
-}
-
-export interface BehaviorGuardrails {
-  max_iterations?: number;
-  timeout?: string;
-  max_tool_calls?: number;
-  human_approval_after?: number;
-  retry_limit?: number;
-  cost_limit?: string;
-}
-
-export interface AuthConfig {
-  type?: "none" | "api_key" | "oauth2" | "jwt";
-  scopes?: string[];
-  token_storage?: "env" | "keychain" | "file";
-  session_timeout?: string;
-}
-
-export interface ObservabilityConfig {
-  tracing?: boolean;
-  log_level?: "debug" | "info" | "warn" | "error";
-  export_to?: string;
-  cost_tracking?: boolean;
-}
-
-// ─── Framework Adapter Interface ──────────────────────────────────
-
-export interface FrameworkAdapter {
-  readonly name: Framework;
-  readonly displayName: string;
-  readonly language: "typescript" | "python";
-
-  /** Generate project files for this framework */
-  scaffold(config: ScaffoldConfig): Promise<ScaffoldResult>;
-
-  /** Validate that the guardrails config is compatible with this framework */
-  validateConfig(config: AgentGuardConfig): ValidationResult;
-
-  /** Get the list of dependencies required for this framework */
-  getDependencies(): Record<string, string>;
-}
-
-export interface ScaffoldConfig {
-  projectName: string;
-  projectDir: string;
-  framework: Framework;
-  model: ModelConfig;
-  guardrails?: GuardrailsConfig;
-  auth?: AuthConfig;
-  features?: string[];
-}
-
-export interface ScaffoldResult {
-  files: GeneratedFile[];
-  dependencies: Record<string, string>;
-  devDependencies: Record<string, string>;
-  scripts: Record<string, string>;
-  postInstallInstructions?: string[];
-}
-
-export interface GeneratedFile {
-  path: string;
-  content: string;
-  executable?: boolean;
-}
-
-export interface ValidationResult {
-  valid: boolean;
-  errors: ValidationError[];
-  warnings: ValidationWarning[];
-}
-
-export interface ValidationError {
-  field: string;
-  message: string;
-}
-
-export interface ValidationWarning {
-  field: string;
-  message: string;
-}
-
-// ─── Project Config ───────────────────────────────────────────────
-
-export interface ProjectConfig {
-  name: string;
-  framework: Framework;
-  model: ModelConfig;
-  guard: AgentGuardConfig;
-}

package/tsconfig.json

@@ -1,8 +0,0 @@
-{
-  "extends": "../../tsconfig.base.json",
-  "compilerOptions": {
-    "outDir": "dist",
-    "rootDir": "src"
-  },
-  "include": ["src/**/*"]
-}