@agentvoy/core 0.1.0

package/src/adapters/crewai.ts

@@ -0,0 +1,254 @@
+/**
+ * CrewAI Adapter
+ *
+ * Scaffolds projects using CrewAI (Python).
+ */
+
+import type {
+  FrameworkAdapter,
+  ScaffoldConfig,
+  ScaffoldResult,
+  AgentGuardConfig,
+  ValidationResult,
+  GeneratedFile,
+} from "../types.js";
+import { generateDefaultConfig } from "../config.js";
+
+export const crewaiAdapter: FrameworkAdapter = {
+  name: "crewai",
+  displayName: "CrewAI",
+  language: "python",
+
+  async scaffold(config: ScaffoldConfig): Promise<ScaffoldResult> {
+    const files: GeneratedFile[] = [
+      {
+        path: "crew.py",
+        content: generateCrewFile(config),
+      },
+      {
+        path: "agents.py",
+        content: generateAgentsFile(config),
+      },
+      {
+        path: "tasks.py",
+        content: generateTasksFile(config),
+      },
+      {
+        path: "tools.py",
+        content: generateToolsFile(),
+      },
+      {
+        path: "run.py",
+        content: generateRunFile(config),
+      },
+      {
+        path: "requirements.txt",
+        content: generateRequirements(),
+      },
+      {
+        path: ".env.example",
+        content: generateEnvExample(config),
+      },
+      {
+        path: "agent.guard.yml",
+        content: generateDefaultConfig(
+          config.projectName,
+          config.model.provider,
+          config.model.model
+        ),
+      },
+    ];
+
+    return {
+      files,
+      dependencies: {},
+      devDependencies: {},
+      scripts: {
+        start: "python run.py",
+      },
+      postInstallInstructions: [
+        "pip install -r requirements.txt",
+        "cp .env.example .env",
+        "Add your API key to .env",
+        "python run.py",
+      ],
+    };
+  },
+
+  validateConfig(config: AgentGuardConfig): ValidationResult {
+    const errors: { field: string; message: string }[] = [];
+    const warnings: { field: string; message: string }[] = [];
+
+    const supported = ["openai", "anthropic", "google", "ollama", "groq"];
+    if (!supported.includes(config.model.provider)) {
+      warnings.push({
+        field: "model.provider",
+        message: `CrewAI supports: ${supported.join(", ")}. Got "${config.model.provider}" — this may require additional configuration.`,
+      });
+    }
+
+    return { valid: errors.length === 0, errors, warnings };
+  },
+
+  getDependencies() {
+    return {
+      crewai: ">=0.80.0",
+      "crewai-tools": ">=0.14.0",
+      "python-dotenv": ">=1.0.0",
+    };
+  },
+};
+
+function generateCrewFile(config: ScaffoldConfig): string {
+  return `"""
+${config.projectName} Crew — Built with AgentVoy
+https://github.com/agentvoy
+"""
+
+from crewai import Crew, Process
+from agents import researcher, writer
+from tasks import research_task, write_task
+
+
+def create_crew() -> Crew:
+    """Create the crew with AgentVoy guardrails."""
+    crew = Crew(
+        agents=[researcher, writer],
+        tasks=[research_task, write_task],
+        process=Process.sequential,
+        verbose=True,
+    )
+    return crew
+`;
+}
+
+function generateAgentsFile(config: ScaffoldConfig): string {
+  const model = config.model.model || "gpt-4o";
+
+  return `"""
+Agent definitions for ${config.projectName}.
+"""
+
+from crewai import Agent
+from tools import search_tool
+
+
+researcher = Agent(
+    role="Research Analyst",
+    goal="Find accurate and comprehensive information on the given topic",
+    backstory="""You are an experienced research analyst with a keen eye
+for detail. You excel at finding relevant information and synthesizing
+it into clear insights.""",
+    tools=[search_tool],
+    llm="${model}",
+    verbose=True,
+)
+
+writer = Agent(
+    role="Content Writer",
+    goal="Create clear, engaging content based on research findings",
+    backstory="""You are a skilled writer who transforms complex research
+into readable, well-structured content. You focus on clarity and
+accuracy.""",
+    llm="${model}",
+    verbose=True,
+)
+`;
+}
+
+function generateTasksFile(config: ScaffoldConfig): string {
+  return `"""
+Task definitions for ${config.projectName}.
+"""
+
+from crewai import Task
+from agents import researcher, writer
+
+
+research_task = Task(
+    description="""Research the following topic thoroughly: {topic}
+
+    Provide:
+    - Key facts and findings
+    - Relevant statistics
+    - Expert opinions or notable perspectives
+    """,
+    expected_output="A detailed research summary with key findings and sources.",
+    agent=researcher,
+)
+
+write_task = Task(
+    description="""Using the research provided, write a clear and engaging
+    summary about: {topic}
+
+    The output should be well-structured and accessible to a general audience.
+    """,
+    expected_output="A well-written article or summary based on the research.",
+    agent=writer,
+)
+`;
+}
+
+function generateToolsFile(): string {
+  return `"""
+Agent tools — add your custom tools here.
+"""
+
+from crewai.tools import tool
+
+
+@tool("Search")
+def search_tool(query: str) -> str:
+    """Search for information on a given topic."""
+    # TODO: Implement your search logic (e.g., using SerperDev, Tavily, etc.)
+    return f"Search results for: {query}"
+`;
+}
+
+function generateRunFile(config: ScaffoldConfig): string {
+  return `"""
+Run the ${config.projectName} crew.
+"""
+
+from dotenv import load_dotenv
+from crew import create_crew
+
+load_dotenv()
+
+
+def main():
+    print("\\n🚀 ${config.projectName} — Powered by AgentVoy")
+    print("=" * 50)
+
+    topic = input("\\nEnter a topic to research: ")
+    if not topic.strip():
+        print("No topic provided. Exiting.")
+        return
+
+    crew = create_crew()
+    result = crew.kickoff(inputs={"topic": topic})
+
+    print("\\n" + "=" * 50)
+    print("RESULT:")
+    print("=" * 50)
+    print(result)
+
+
+if __name__ == "__main__":
+    main()
+`;
+}
+
+function generateRequirements(): string {
+  return `crewai>=0.80.0
+crewai-tools>=0.14.0
+python-dotenv>=1.0.0
+`;
+}
+
+function generateEnvExample(config: ScaffoldConfig): string {
+  const envVar =
+    config.model.api_key_env ||
+    `${config.model.provider.toUpperCase()}_API_KEY`;
+  return `${envVar}=your-api-key-here\n`;
+}

package/src/adapters/google-adk.ts

@@ -0,0 +1,167 @@
+/**
+ * Google Agent Development Kit (ADK) Adapter
+ *
+ * Scaffolds projects using Google's ADK (Python).
+ */
+
+import type {
+  FrameworkAdapter,
+  ScaffoldConfig,
+  ScaffoldResult,
+  AgentGuardConfig,
+  ValidationResult,
+  GeneratedFile,
+} from "../types.js";
+import { generateDefaultConfig } from "../config.js";
+
+export const googleAdkAdapter: FrameworkAdapter = {
+  name: "google-adk",
+  displayName: "Google ADK",
+  language: "python",
+
+  async scaffold(config: ScaffoldConfig): Promise<ScaffoldResult> {
+    const agentDir = config.projectName.replace(/-/g, "_");
+
+    const files: GeneratedFile[] = [
+      {
+        path: `${agentDir}/__init__.py`,
+        content: "",
+      },
+      {
+        path: `${agentDir}/agent.py`,
+        content: generateAgentFile(config),
+      },
+      {
+        path: `${agentDir}/tools.py`,
+        content: generateToolsFile(config),
+      },
+      {
+        path: "requirements.txt",
+        content: generateRequirements(),
+      },
+      {
+        path: ".env.example",
+        content: "GOOGLE_API_KEY=your-api-key-here\n",
+      },
+      {
+        path: "agent.guard.yml",
+        content: generateDefaultConfig(
+          config.projectName,
+          "google",
+          config.model.model || "gemini-2.0-flash"
+        ),
+      },
+    ];
+
+    return {
+      files,
+      dependencies: {},
+      devDependencies: {},
+      scripts: {
+        start: `adk run ${agentDir}`,
+        web: `adk web ${agentDir}`,
+      },
+      postInstallInstructions: [
+        "pip install -r requirements.txt",
+        "cp .env.example .env",
+        "Add your GOOGLE_API_KEY to .env",
+        `adk run ${agentDir}`,
+        `Or use the web UI: adk web ${agentDir}`,
+      ],
+    };
+  },
+
+  validateConfig(config: AgentGuardConfig): ValidationResult {
+    const errors: { field: string; message: string }[] = [];
+    const warnings: { field: string; message: string }[] = [];
+
+    if (config.model.provider !== "google") {
+      warnings.push({
+        field: "model.provider",
+        message: `Google ADK works best with provider "google", got "${config.model.provider}"`,
+      });
+    }
+
+    return { valid: errors.length === 0, errors, warnings };
+  },
+
+  getDependencies() {
+    return {
+      "google-adk": ">=1.0.0",
+      "python-dotenv": ">=1.0.0",
+    };
+  },
+};
+
+function generateAgentFile(config: ScaffoldConfig): string {
+  const model = config.model.model || "gemini-2.0-flash";
+
+  return `"""
+${config.projectName} — Built with AgentVoy
+https://github.com/agentvoy
+"""
+
+from google.adk.agents import Agent
+from .tools import search_web, read_file
+
+root_agent = Agent(
+    name="${config.projectName}",
+    model="${model}",
+    description="AI agent created with AgentVoy",
+    instruction="""You are a helpful AI assistant.
+
+Follow these guidelines:
+- Be concise and accurate
+- Ask for clarification when the request is ambiguous
+- Respect the guardrails defined in agent.guard.yml
+""",
+    tools=[search_web, read_file],
+)
+`;
+}
+
+function generateToolsFile(_config: ScaffoldConfig): string {
+  return `"""
+Agent tools — add your custom tools here.
+"""
+
+from google.adk.tools import FunctionTool
+
+
+def search_web(query: str) -> dict:
+    """Search the web for information.
+
+    Args:
+        query: The search query string.
+
+    Returns:
+        A dictionary with search results.
+    """
+    # TODO: Implement your search logic
+    return {"results": f"Search results for: {query}"}
+
+
+def read_file(path: str) -> dict:
+    """Read the contents of a file.
+
+    Args:
+        path: Path to the file to read.
+
+    Returns:
+        A dictionary with the file contents or an error message.
+    """
+    try:
+        with open(path, "r") as f:
+            return {"content": f.read()}
+    except FileNotFoundError:
+        return {"error": f"File not found: {path}"}
+    except PermissionError:
+        return {"error": f"Permission denied: {path}"}
+`;
+}
+
+function generateRequirements(): string {
+  return `google-adk>=1.0.0
+python-dotenv>=1.0.0
+`;
+}

package/src/adapters/index.ts

@@ -0,0 +1,17 @@
+/**
+ * Framework Adapters
+ *
+ * Auto-registers all built-in adapters on import.
+ */
+
+export { registerAdapter, getAdapter, listAdapters, listFrameworks, hasAdapter } from "./registry.js";
+
+import { registerAdapter } from "./registry.js";
+import { openaiAdapter } from "./openai.js";
+import { googleAdkAdapter } from "./google-adk.js";
+import { crewaiAdapter } from "./crewai.js";
+
+// Register built-in adapters
+registerAdapter(openaiAdapter);
+registerAdapter(googleAdkAdapter);
+registerAdapter(crewaiAdapter);

package/src/adapters/openai.ts

@@ -0,0 +1,214 @@
+/**
+ * OpenAI Agents SDK Adapter
+ *
+ * Scaffolds projects using the OpenAI Agents SDK (Python).
+ */
+
+import type {
+  FrameworkAdapter,
+  ScaffoldConfig,
+  ScaffoldResult,
+  AgentGuardConfig,
+  ValidationResult,
+  GeneratedFile,
+} from "../types.js";
+import { generateDefaultConfig } from "../config.js";
+
+export const openaiAdapter: FrameworkAdapter = {
+  name: "openai",
+  displayName: "OpenAI Agents SDK",
+  language: "python",
+
+  async scaffold(config: ScaffoldConfig): Promise<ScaffoldResult> {
+    const files: GeneratedFile[] = [
+      {
+        path: "agent.py",
+        content: generateAgentFile(config),
+      },
+      {
+        path: "tools.py",
+        content: generateToolsFile(config),
+      },
+      {
+        path: "run.py",
+        content: generateRunFile(config),
+      },
+      {
+        path: "requirements.txt",
+        content: generateRequirements(),
+      },
+      {
+        path: ".env.example",
+        content: "OPENAI_API_KEY=your-api-key-here\n",
+      },
+      {
+        path: "agent.guard.yml",
+        content: generateDefaultConfig(
+          config.projectName,
+          config.model.provider,
+          config.model.model
+        ),
+      },
+    ];
+
+    return {
+      files,
+      dependencies: {},
+      devDependencies: {},
+      scripts: {
+        start: "python run.py",
+      },
+      postInstallInstructions: [
+        "pip install -r requirements.txt",
+        "cp .env.example .env",
+        "Add your OPENAI_API_KEY to .env",
+        "python run.py",
+      ],
+    };
+  },
+
+  validateConfig(config: AgentGuardConfig): ValidationResult {
+    const errors: { field: string; message: string }[] = [];
+    const warnings: { field: string; message: string }[] = [];
+
+    if (config.model.provider !== "openai") {
+      warnings.push({
+        field: "model.provider",
+        message: `OpenAI adapter works best with provider "openai", got "${config.model.provider}"`,
+      });
+    }
+
+    return { valid: errors.length === 0, errors, warnings };
+  },
+
+  getDependencies() {
+    return {
+      "openai-agents": ">=0.1.0",
+      "python-dotenv": ">=1.0.0",
+    };
+  },
+};
+
+function generateAgentFile(config: ScaffoldConfig): string {
+  const guardConfig = config.guardrails?.behavior;
+  const maxTurns = guardConfig?.max_iterations || 20;
+
+  return `"""
+${config.projectName} — Built with AgentVoy
+https://github.com/agentvoy
+"""
+
+from agents import Agent, Runner
+from tools import get_tools
+
+
+def create_agent() -> Agent:
+    """Create and configure the agent with AgentVoy guardrails."""
+    tools = get_tools()
+
+    agent = Agent(
+        name="${config.projectName}",
+        instructions="""You are a helpful AI assistant.
+
+Follow these guidelines:
+- Be concise and accurate
+- Ask for clarification when the request is ambiguous
+- Respect the guardrails defined in agent.guard.yml
+""",
+        model="${config.model.model || "gpt-4o"}",
+        tools=tools,
+    )
+
+    return agent
+
+
+async def run_agent(prompt: str) -> str:
+    """Run the agent with the given prompt."""
+    agent = create_agent()
+    result = await Runner.run(
+        agent,
+        prompt,
+        max_turns=${maxTurns},
+    )
+    return result.final_output
+`;
+}
+
+function generateToolsFile(_config: ScaffoldConfig): string {
+  return `"""
+Agent tools — add your custom tools here.
+"""
+
+from agents import function_tool
+
+
+@function_tool
+def search_web(query: str) -> str:
+    """Search the web for information."""
+    # TODO: Implement your search logic
+    return f"Search results for: {query}"
+
+
+@function_tool
+def read_file(path: str) -> str:
+    """Read the contents of a file."""
+    try:
+        with open(path, "r") as f:
+            return f.read()
+    except FileNotFoundError:
+        return f"File not found: {path}"
+    except PermissionError:
+        return f"Permission denied: {path}"
+
+
+def get_tools() -> list:
+    """Return all available tools."""
+    return [search_web, read_file]
+`;
+}
+
+function generateRunFile(config: ScaffoldConfig): string {
+  return `"""
+Run the ${config.projectName} agent.
+"""
+
+import asyncio
+import os
+from dotenv import load_dotenv
+from agent import run_agent
+
+load_dotenv()
+
+
+async def main():
+    print("\\n🚀 ${config.projectName} — Powered by AgentVoy")
+    print("=" * 50)
+    print("Type your prompt (or 'quit' to exit):\\n")
+
+    while True:
+        try:
+            prompt = input("> ")
+            if prompt.lower() in ("quit", "exit", "q"):
+                print("\\nGoodbye!")
+                break
+            if not prompt.strip():
+                continue
+
+            print("\\nThinking...\\n")
+            result = await run_agent(prompt)
+            print(f"\\n{result}\\n")
+        except KeyboardInterrupt:
+            print("\\n\\nGoodbye!")
+            break
+
+
+if __name__ == "__main__":
+    asyncio.run(main())
+`;
+}
+
+function generateRequirements(): string {
+  return `openai-agents>=0.1.0
+python-dotenv>=1.0.0
+`;
+}

package/src/adapters/registry.ts

@@ -0,0 +1,37 @@
+/**
+ * Framework Adapter Registry
+ *
+ * Central registry for all supported agent framework adapters.
+ * Each adapter knows how to scaffold a project for its framework.
+ */
+
+import type { Framework, FrameworkAdapter } from "../types.js";
+
+const adapters = new Map<Framework, FrameworkAdapter>();
+
+export function registerAdapter(adapter: FrameworkAdapter): void {
+  adapters.set(adapter.name, adapter);
+}
+
+export function getAdapter(framework: Framework): FrameworkAdapter {
+  const adapter = adapters.get(framework);
+  if (!adapter) {
+    const available = Array.from(adapters.keys()).join(", ");
+    throw new Error(
+      `Unknown framework: "${framework}". Available: ${available}`
+    );
+  }
+  return adapter;
+}
+
+export function listAdapters(): FrameworkAdapter[] {
+  return Array.from(adapters.values());
+}
+
+export function listFrameworks(): Framework[] {
+  return Array.from(adapters.keys());
+}
+
+export function hasAdapter(framework: Framework): boolean {
+  return adapters.has(framework);
+}