@agentvoy/core 0.2.0 → 0.4.0

package/README.md

@@ -0,0 +1,65 @@
+# @agentvoy/core
+
+Core engine for [AgentVoy](https://agentvoy.com) — the universal AI agent development platform.
+
+[![npm version](https://img.shields.io/npm/v/@agentvoy/core.svg)](https://www.npmjs.com/package/@agentvoy/core)
+[![License](https://img.shields.io/badge/license-Apache%202.0-blue.svg)](https://github.com/agentvoy/agentvoy/blob/main/LICENSE)
+
+## What's in here
+
+This package provides the foundation for AgentVoy:
+
+- **Framework adapter interface** — `FrameworkAdapter` type that every framework plugin implements
+- **Adapter registry** — register and look up adapters by name
+- **Config parser** — parse and validate `agent.guard.yml`
+- **Default config generator** — generate guardrail configs for scaffolded projects
+- **Built-in adapters** — OpenAI Agents SDK, Google ADK, CrewAI, LangGraph, Anthropic SDK
+
+## Usage
+
+This package is consumed internally by the `agentvoy` CLI and `create-agentvoy`. You typically don't need to install it directly.
+
+If you're **building a custom adapter**, implement the `FrameworkAdapter` interface:
+
+```typescript
+import type { FrameworkAdapter, ScaffoldConfig, ScaffoldResult } from "@agentvoy/core";
+
+export const myAdapter: FrameworkAdapter = {
+  name: "my-framework",
+  displayName: "My Framework",
+  language: "python",
+
+  async scaffold(config: ScaffoldConfig): Promise<ScaffoldResult> {
+    return {
+      files: [
+        { path: "agent.py", content: "..." },
+        { path: "requirements.txt", content: "my-framework\nagentvoy-guard>=0.1.0\n" },
+      ],
+      dependencies: {},
+      devDependencies: {},
+      scripts: { start: "python run.py" },
+      postInstallInstructions: ["pip install -r requirements.txt", "python run.py"],
+    };
+  },
+
+  validateConfig(config) {
+    return { valid: true, errors: [], warnings: [] };
+  },
+
+  getDependencies() {
+    return { "my-framework": ">=1.0.0" };
+  },
+};
+```
+
+See [CONTRIBUTING.md](https://github.com/agentvoy/agentvoy/blob/main/CONTRIBUTING.md) for the full guide.
+
+## Links
+
+- [GitHub](https://github.com/agentvoy/agentvoy)
+- [Website](https://agentvoy.com)
+- [npm: agentvoy CLI](https://www.npmjs.com/package/agentvoy)
+
+## License
+
+Apache 2.0

package/dist/adapters/anthropic.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/adapters/anthropic.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAMjB,MAAM,aAAa,CAAC;AAGrB,eAAO,MAAM,gBAAgB,EAAE,gBAyE9B,CAAC"}
+{"version":3,"file":"anthropic.d.ts","sourceRoot":"","sources":["../../src/adapters/anthropic.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAMjB,MAAM,aAAa,CAAC;AAIrB,eAAO,MAAM,gBAAgB,EAAE,gBA6D9B,CAAC"}

package/dist/adapters/anthropic.js

@@ -7,50 +7,43 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.anthropicAdapter = void 0;
 const config_js_1 = require("../config.js");
+const app_scaffold_js_1 = require("./app-scaffold.js");
 exports.anthropicAdapter = {
     name: "anthropic",
     displayName: "Anthropic SDK",
     language: "python",
     async scaffold(config) {
-        const files = [
-            {
-                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: "ANTHROPIC_API_KEY=your-api-key-here\n",
-            },
-            {
-                path: "agent.guard.yml",
-                content: (0, config_js_1.generateDefaultConfig)(config.projectName, "anthropic", config.model.model || "claude-sonnet-4-20250514"),
-            },
-        ];
+        const isApp = config.buildMode === "app";
+        const agentNames = config.agentNames ?? ["agent"];
+        const files = [];
+        if (isApp) {
+            for (const agentName of agentNames) {
+                files.push({ path: `src/agents/${agentName}.py`, content: generateAgentFile(config, agentName) });
+            }
+            files.push({ path: "src/tools/tools.py", content: generateToolsFile(config) });
+            for (const f of (0, app_scaffold_js_1.generateAppInfraFiles)(config))
+                files.push(f);
+        }
+        else {
+            files.push({ path: "agent.py", content: generateAgentFile(config, "agent") });
+            files.push({ path: "tools.py", content: generateToolsFile(config) });
+            files.push({ path: "run.py", content: generateRunFile(config) });
+        }
+        const baseReqs = `anthropic>=0.40.0\npython-dotenv>=1.0.0\nagentvoy-guard>=0.1.0\n`;
+        files.push({ path: "requirements.txt", content: isApp ? (0, app_scaffold_js_1.appendAppRequirements)(baseReqs) : baseReqs });
+        files.push({ path: ".env.example", content: "ANTHROPIC_API_KEY=your-api-key-here\n" });
+        files.push({
+            path: "agent.guard.yml",
+            content: (0, config_js_1.generateDefaultConfig)(config.projectName, "anthropic", config.model.model || "claude-sonnet-4-20250514"),
+        });
         return {
             files,
             dependencies: {},
             devDependencies: {},
-            scripts: {
-                start: "python run.py",
-            },
-            postInstallInstructions: [
-                "pip install -r requirements.txt",
-                "cp .env.example .env",
-                "Add your ANTHROPIC_API_KEY to .env",
-                "python run.py",
-            ],
+            scripts: { start: isApp ? "uvicorn server:app --reload --port 8080" : "python run.py" },
+            postInstallInstructions: isApp
+                ? (0, app_scaffold_js_1.appPostInstallInstructions)("ANTHROPIC_API_KEY")
+                : ["pip install -r requirements.txt", "cp .env.example .env", "Add your ANTHROPIC_API_KEY to .env", "python run.py"],
         };
     },
     validateConfig(config) {
@@ -71,16 +64,20 @@ exports.anthropicAdapter = {
         };
     },
 };
-function generateAgentFile(config) {
+function generateAgentFile(config, _agentName = "agent") {
     const model = config.model.model || "claude-sonnet-4-20250514";
     const maxIterations = config.guardrails?.behavior?.max_iterations || 20;
+    const isApp = config.buildMode === "app";
+    const toolsImport = isApp
+        ? "from src.tools.tools import get_tools, process_tool_call"
+        : "from tools import get_tools, process_tool_call";
     return `"""
 ${config.projectName} — Built with AgentVoy
 https://github.com/agentvoy
 """
 
 import anthropic
-from tools import get_tools, process_tool_call
+${toolsImport}
 
 
 def create_client() -> anthropic.Anthropic:
@@ -89,48 +86,50 @@ def create_client() -> anthropic.Anthropic:
 
 
 def run_agent(prompt: str) -> str:
-    """Run the agent with an agentic loop."""
+    """Run the agent with an agentic loop, enforcing agent.guard.yml at runtime."""
+    from agentvoy_guard import Guard
+    guard = Guard.from_config()
+
     client = create_client()
     tools = get_tools()
     messages = [{"role": "user", "content": prompt}]
 
-    iteration = 0
-    max_iterations = ${maxIterations}
-
-    while iteration < max_iterations:
-        iteration += 1
-
-        response = client.messages.create(
-            model="${model}",
-            max_tokens=8096,
-            tools=tools,
-            messages=messages,
-        )
-
-        # Add assistant response to messages
-        messages.append({"role": "assistant", "content": response.content})
-
-        # If no tool calls, we're done
-        if response.stop_reason == "end_turn":
-            # Extract final text response
-            for block in response.content:
-                if hasattr(block, "text"):
-                    return block.text
-            return "Done."
-
-        # Process tool calls
-        if response.stop_reason == "tool_use":
-            tool_results = []
-            for block in response.content:
-                if block.type == "tool_use":
-                    result = process_tool_call(block.name, block.input)
-                    tool_results.append({
-                        "type": "tool_result",
-                        "tool_use_id": block.id,
-                        "content": str(result),
-                    })
-
-            messages.append({"role": "user", "content": tool_results})
+    with guard.session() as session:
+        session.check_input(prompt)
+
+        while True:
+            session.tick()
+
+            response = client.messages.create(
+                model="${model}",
+                max_tokens=8096,
+                tools=tools,
+                messages=messages,
+            )
+
+            session.track_usage(response.usage)
+            messages.append({"role": "assistant", "content": response.content})
+
+            if response.stop_reason == "end_turn":
+                for block in response.content:
+                    if hasattr(block, "text"):
+                        session.check_output(block.text)
+                        print(f"[guard] {guard.last_summary}")
+                        return block.text
+                return "Done."
+
+            if response.stop_reason == "tool_use":
+                tool_results = []
+                for block in response.content:
+                    if block.type == "tool_use":
+                        session.tick_tool()
+                        result = process_tool_call(block.name, block.input)
+                        tool_results.append({
+                            "type": "tool_result",
+                            "tool_use_id": block.id,
+                            "content": str(result),
+                        })
+                messages.append({"role": "user", "content": tool_results})
 
     return "Max iterations reached."
 `;
@@ -242,6 +241,7 @@ if __name__ == "__main__":
 function generateRequirements() {
     return `anthropic>=0.40.0
 python-dotenv>=1.0.0
+agentvoy-guard>=0.1.0
 `;
 }
 //# sourceMappingURL=anthropic.js.map

package/dist/adapters/anthropic.js.map

@@ -1 +1 @@
-{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/adapters/anthropic.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAUH,4CAAqD;AAExC,QAAA,gBAAgB,GAAqB;IAChD,IAAI,EAAE,WAAW;IACjB,WAAW,EAAE,eAAe;IAC5B,QAAQ,EAAE,QAAQ;IAElB,KAAK,CAAC,QAAQ,CAAC,MAAsB;QACnC,MAAM,KAAK,GAAoB;YAC7B;gBACE,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC;aACnC;YACD;gBACE,IAAI,EAAE,UAAU;gBAChB,OAAO,EAAE,iBAAiB,CAAC,MAAM,CAAC;aACnC;YACD;gBACE,IAAI,EAAE,QAAQ;gBACd,OAAO,EAAE,eAAe,CAAC,MAAM,CAAC;aACjC;YACD;gBACE,IAAI,EAAE,kBAAkB;gBACxB,OAAO,EAAE,oBAAoB,EAAE;aAChC;YACD;gBACE,IAAI,EAAE,cAAc;gBACpB,OAAO,EAAE,uCAAuC;aACjD;YACD;gBACE,IAAI,EAAE,iBAAiB;gBACvB,OAAO,EAAE,IAAA,iCAAqB,EAC5B,MAAM,CAAC,WAAW,EAClB,WAAW,EACX,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,0BAA0B,CACjD;aACF;SACF,CAAC;QAEF,OAAO;YACL,KAAK;YACL,YAAY,EAAE,EAAE;YAChB,eAAe,EAAE,EAAE;YACnB,OAAO,EAAE;gBACP,KAAK,EAAE,eAAe;aACvB;YACD,uBAAuB,EAAE;gBACvB,iCAAiC;gBACjC,sBAAsB;gBACtB,oCAAoC;gBACpC,eAAe;aAChB;SACF,CAAC;IACJ,CAAC;IAED,cAAc,CAAC,MAAwB;QACrC,MAAM,MAAM,GAAyC,EAAE,CAAC;QACxD,MAAM,QAAQ,GAAyC,EAAE,CAAC;QAE1D,IAAI,MAAM,CAAC,KAAK,CAAC,QAAQ,KAAK,WAAW,EAAE,CAAC;YAC1C,QAAQ,CAAC,IAAI,CAAC;gBACZ,KAAK,EAAE,gBAAgB;gBACvB,OAAO,EAAE,gEAAgE,MAAM,CAAC,KAAK,CAAC,QAAQ,GAAG;aAClG,CAAC,CAAC;QACL,CAAC;QAED,OAAO,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAC1D,CAAC;IAED,eAAe;QACb,OAAO;YACL,SAAS,EAAE,UAAU;YACrB,eAAe,EAAE,SAAS;SAC3B,CAAC;IACJ,CAAC;CACF,CAAC;AAEF,SAAS,iBAAiB,CAAC,MAAsB;IAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,KAAK,IAAI,0BAA0B,CAAC;IAC/D,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,EAAE,QAAQ,EAAE,cAAc,IAAI,EAAE,CAAC;IAExE,OAAO;EACP,MAAM,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;uBAoBG,aAAa;;;;;;qBAMf,KAAK;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgCzB,CAAC;AACF,CAAC;AAED,SAAS,iBAAiB,CAAC,OAAuB;IAChD,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgER,CAAC;AACF,CAAC;AAED,SAAS,eAAe,CAAC,MAAsB;IAC7C,OAAO;UACC,MAAM,CAAC,WAAW;;;;;;;;;;mBAUT,MAAM,CAAC,WAAW;;;;;;;;;;;;;;;;;;;;;;;CAuBpC,CAAC;AACF,CAAC;AAED,SAAS,oBAAoB;IAC3B,OAAO;;CAER,CAAC;AACF,CAAC"}
+{"version":3,"file":"anthropic.js","sourceRoot":"","sources":["../../src/adapters/anthropic.ts"],"names":[],"mappings":"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"}

package/dist/adapters/app-scaffold.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Shared helpers for app-mode scaffolding.
+ * Used by all framework adapters when buildMode="app".
+ */
+import type { ScaffoldConfig, GeneratedFile } from "../types.js";
+/** Common infrastructure files for the src/ app structure */
+export declare function generateAppInfraFiles(config: ScaffoldConfig): GeneratedFile[];
+/** Append app deployment dependencies to a requirements string */
+export declare function appendAppRequirements(base: string): string;
+/** Post-install instructions for app mode */
+export declare function appPostInstallInstructions(envVar: string): string[];
+//# sourceMappingURL=app-scaffold.d.ts.map

package/dist/adapters/app-scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-scaffold.d.ts","sourceRoot":"","sources":["../../src/adapters/app-scaffold.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjE,6DAA6D;AAC7D,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,aAAa,EAAE,CAiB7E;AAED,kEAAkE;AAClE,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAQ1D;AAED,6CAA6C;AAC7C,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAQnE"}

package/dist/adapters/app-scaffold.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * Shared helpers for app-mode scaffolding.
+ * Used by all framework adapters when buildMode="app".
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateAppInfraFiles = generateAppInfraFiles;
+exports.appendAppRequirements = appendAppRequirements;
+exports.appPostInstallInstructions = appPostInstallInstructions;
+/** Common infrastructure files for the src/ app structure */
+function generateAppInfraFiles(config) {
+    return [
+        { path: "src/__init__.py", content: "" },
+        { path: "src/agents/__init__.py", content: "" },
+        { path: "src/tools/__init__.py", content: "" },
+        { path: "src/config/__init__.py", content: "" },
+        {
+            path: "src/config/settings.py",
+            content: `"""App settings — Generated by AgentVoy"""
+import os
+
+PORT = int(os.getenv("PORT", "8080"))
+DEBUG = os.getenv("DEBUG", "false").lower() == "true"
+AGENT_NAME = "${config.projectName}"
+`,
+        },
+    ];
+}
+/** Append app deployment dependencies to a requirements string */
+function appendAppRequirements(base) {
+    const appDeps = [
+        "fastapi>=0.115.0",
+        "uvicorn[standard]>=0.34.0",
+        "streamlit>=1.40.0",
+        "requests>=2.32.0",
+    ];
+    return base.trimEnd() + "\n" + appDeps.join("\n") + "\n";
+}
+/** Post-install instructions for app mode */
+function appPostInstallInstructions(envVar) {
+    return [
+        "pip install -r requirements.txt",
+        "cp .env.example .env",
+        `Add your ${envVar} to .env`,
+        "uvicorn server:app --reload --port 8080",
+        "streamlit run streamlit_app.py  # in a second terminal",
+    ];
+}
+//# sourceMappingURL=app-scaffold.js.map

package/dist/adapters/app-scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-scaffold.js","sourceRoot":"","sources":["../../src/adapters/app-scaffold.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAKH,sDAiBC;AAGD,sDAQC;AAGD,gEAQC;AAxCD,6DAA6D;AAC7D,SAAgB,qBAAqB,CAAC,MAAsB;IAC1D,OAAO;QACL,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,EAAE,EAAE;QACxC,EAAE,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,EAAE,EAAE;QAC/C,EAAE,IAAI,EAAE,uBAAuB,EAAE,OAAO,EAAE,EAAE,EAAE;QAC9C,EAAE,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,EAAE,EAAE;QAC/C;YACE,IAAI,EAAE,wBAAwB;YAC9B,OAAO,EAAE;;;;;gBAKC,MAAM,CAAC,WAAW;CACjC;SACI;KACF,CAAC;AACJ,CAAC;AAED,kEAAkE;AAClE,SAAgB,qBAAqB,CAAC,IAAY;IAChD,MAAM,OAAO,GAAG;QACd,kBAAkB;QAClB,2BAA2B;QAC3B,mBAAmB;QACnB,kBAAkB;KACnB,CAAC;IACF,OAAO,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;AAC3D,CAAC;AAED,6CAA6C;AAC7C,SAAgB,0BAA0B,CAAC,MAAc;IACvD,OAAO;QACL,iCAAiC;QACjC,sBAAsB;QACtB,YAAY,MAAM,UAAU;QAC5B,yCAAyC;QACzC,wDAAwD;KACzD,CAAC;AACJ,CAAC"}

package/dist/adapters/autogen.d.ts

@@ -0,0 +1,8 @@
+/**
+ * AutoGen Adapter
+ *
+ * Scaffolds projects using Microsoft AutoGen (Python).
+ */
+import type { FrameworkAdapter } from "../types.js";
+export declare const autogenAdapter: FrameworkAdapter;
+//# sourceMappingURL=autogen.d.ts.map

package/dist/adapters/autogen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"autogen.d.ts","sourceRoot":"","sources":["../../src/adapters/autogen.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAMjB,MAAM,aAAa,CAAC;AAIrB,eAAO,MAAM,cAAc,EAAE,gBAqE5B,CAAC"}

package/dist/adapters/autogen.js

@@ -0,0 +1,259 @@
+"use strict";
+/**
+ * AutoGen Adapter
+ *
+ * Scaffolds projects using Microsoft AutoGen (Python).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.autogenAdapter = void 0;
+const config_js_1 = require("../config.js");
+const app_scaffold_js_1 = require("./app-scaffold.js");
+exports.autogenAdapter = {
+    name: "autogen",
+    displayName: "AutoGen",
+    language: "python",
+    async scaffold(config) {
+        const isApp = config.buildMode === "app";
+        const agentNames = config.agentNames ?? ["agent"];
+        const files = [];
+        if (isApp) {
+            for (const agentName of agentNames) {
+                files.push({
+                    path: `src/agents/${agentName}.py`,
+                    content: generateAgentFile(config, agentName),
+                });
+            }
+            files.push({ path: "src/tools/tools.py", content: generateToolsFile(config) });
+            for (const f of (0, app_scaffold_js_1.generateAppInfraFiles)(config))
+                files.push(f);
+        }
+        else {
+            files.push({ path: "agent.py", content: generateAgentFile(config, "agent") });
+            files.push({ path: "tools.py", content: generateToolsFile(config) });
+            files.push({ path: "run.py", content: generateRunFile(config) });
+        }
+        const envVar = getEnvVar(config.model.provider);
+        files.push({ path: "requirements.txt", content: generateRequirements(isApp) });
+        files.push({ path: ".env.example", content: `${envVar}=your-api-key-here\n` });
+        files.push({
+            path: "agent.guard.yml",
+            content: (0, config_js_1.generateDefaultConfig)(config.projectName, config.model.provider, config.model.model),
+        });
+        return {
+            files,
+            dependencies: {},
+            devDependencies: {},
+            scripts: { start: isApp ? "uvicorn server:app --reload --port 8080" : "python run.py" },
+            postInstallInstructions: isApp
+                ? (0, app_scaffold_js_1.appPostInstallInstructions)(envVar)
+                : [
+                    "pip install -r requirements.txt",
+                    "cp .env.example .env",
+                    `Add your ${envVar} to .env`,
+                    "python run.py",
+                ],
+        };
+    },
+    validateConfig(config) {
+        const errors = [];
+        const warnings = [];
+        if (!["openai", "anthropic"].includes(config.model.provider)) {
+            warnings.push({
+                field: "model.provider",
+                message: `AutoGen works best with openai or anthropic. Got "${config.model.provider}"`,
+            });
+        }
+        return { valid: errors.length === 0, errors, warnings };
+    },
+    getDependencies() {
+        return {
+            "pyautogen": ">=0.4.0",
+            "python-dotenv": ">=1.0.0",
+        };
+    },
+};
+function getLLMConfig(config) {
+    const model = config.model.model || "gpt-4o";
+    const provider = config.model.provider;
+    if (provider === "anthropic") {
+        return `llm_config = {
+    "config_list": [
+        {
+            "model": "${model}",
+            "api_type": "anthropic",
+            "api_key": os.environ["ANTHROPIC_API_KEY"],
+        }
+    ],
+}`;
+    }
+    return `llm_config = {
+    "config_list": [
+        {
+            "model": "${model}",
+            "api_key": os.environ["OPENAI_API_KEY"],
+        }
+    ],
+}`;
+}
+function getEnvVar(provider) {
+    const map = {
+        openai: "OPENAI_API_KEY",
+        anthropic: "ANTHROPIC_API_KEY",
+        google: "GOOGLE_API_KEY",
+        groq: "GROQ_API_KEY",
+        mistral: "MISTRAL_API_KEY",
+    };
+    return map[provider] || "OPENAI_API_KEY";
+}
+function generateAgentFile(config, agentName) {
+    const isApp = config.buildMode === "app";
+    const toolsImport = isApp
+        ? "from src.tools.tools import get_tool_functions"
+        : "from tools import get_tool_functions";
+    const llmConfig = getLLMConfig(config);
+    const maxReplies = config.guardrails?.behavior?.max_iterations || 20;
+    return `"""
+${agentName} agent — Part of ${config.projectName} (Built with AgentVoy)
+"""
+
+import os
+import asyncio
+from dotenv import load_dotenv
+from autogen import AssistantAgent, UserProxyAgent
+${toolsImport}
+
+load_dotenv()
+
+${llmConfig}
+
+
+def create_agent() -> AssistantAgent:
+    """Create and configure the AutoGen assistant agent."""
+    tools = get_tool_functions()
+
+    assistant = AssistantAgent(
+        name="${agentName}",
+        system_message="""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
+""",
+        llm_config=llm_config,
+        max_consecutive_auto_reply=${maxReplies},
+    )
+
+    # Register tools
+    for tool_fn in tools:
+        assistant.register_for_llm(description=tool_fn.__doc__ or "")(tool_fn)
+
+    return assistant
+
+
+def run_agent(prompt: str) -> str:
+    """Run the agent with the given prompt, enforcing agent.guard.yml at runtime."""
+    import asyncio
+    from agentvoy_guard import Guard
+    guard = Guard.from_config()
+
+    async def _run():
+        assistant = create_agent()
+
+        user_proxy = UserProxyAgent(
+            name="user_proxy",
+            human_input_mode="NEVER",
+            max_consecutive_auto_reply=1,
+            is_termination_msg=lambda msg: msg.get("content", "").rstrip().endswith("TERMINATE"),
+            code_execution_config=False,
+        )
+
+        await user_proxy.a_initiate_chat(
+            assistant,
+            message=prompt,
+            max_turns=2,
+        )
+
+        chat_history = user_proxy.chat_messages.get(assistant, [])
+        return next(
+            (m["content"] for m in reversed(chat_history) if m.get("role") == "assistant"),
+            "",
+        )
+
+    with guard.session() as session:
+        session.check_input(prompt)
+        final = asyncio.run(_run())
+        session.check_output(final)
+
+    print(f"[guard] {guard.last_summary}")
+    return final
+`;
+}
+function generateToolsFile(_config) {
+    return `"""
+Agent tools — add your custom tools here.
+"""
+
+
+def search_web(query: str) -> str:
+    """Search the web for information."""
+    # TODO: Implement your search logic
+    return f"Search results for: {query}"
+
+
+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_tool_functions() -> list:
+    """Return all available tool functions."""
+    return [search_web, read_file]
+`;
+}
+function generateRunFile(config) {
+    return `"""
+Run the ${config.projectName} agent.
+"""
+
+import asyncio
+from agent import run_agent
+
+
+async def main():
+    print("\\n${config.projectName} — Powered by AgentVoy + AutoGen")
+    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(isApp = false) {
+    const base = `pyautogen>=0.4.0\npython-dotenv>=1.0.0\nagentvoy-guard>=0.1.0\n`;
+    return isApp ? (0, app_scaffold_js_1.appendAppRequirements)(base) : base;
+}
+//# sourceMappingURL=autogen.js.map

package/dist/adapters/autogen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"autogen.js","sourceRoot":"","sources":["../../src/adapters/autogen.ts"],"names":[],"mappings":"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"}

package/dist/adapters/crewai.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"crewai.d.ts","sourceRoot":"","sources":["../../src/adapters/crewai.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAMjB,MAAM,aAAa,CAAC;AAGrB,eAAO,MAAM,aAAa,EAAE,gBAmF3B,CAAC"}
+{"version":3,"file":"crewai.d.ts","sourceRoot":"","sources":["../../src/adapters/crewai.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAMjB,MAAM,aAAa,CAAC;AAIrB,eAAO,MAAM,aAAa,EAAE,gBAiE3B,CAAC"}