clayton-forge 0.1.0

package/dist/commands/new.d.ts

@@ -0,0 +1,2 @@
+export declare function commandNew(targetDir?: string): Promise<void>;
+//# sourceMappingURL=new.d.ts.map

package/dist/commands/new.js

@@ -0,0 +1,286 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commandNew = commandNew;
+const inquirer_1 = __importDefault(require("inquirer"));
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+// ─────────────────────────────────────────────
+// Helpers de display
+// ─────────────────────────────────────────────
+function header() {
+    console.log("");
+    console.log(chalk_1.default.bold.white("  ╔═══════════════════════════════════╗"));
+    console.log(chalk_1.default.bold.white("  ║") + chalk_1.default.bold.cyan("       CLAYTON FORGE — new        ") + chalk_1.default.bold.white("║"));
+    console.log(chalk_1.default.bold.white("  ╚═══════════════════════════════════╝"));
+    console.log("");
+    console.log(chalk_1.default.gray("  Let's create your agent. Answer a few questions."));
+    console.log(chalk_1.default.gray("  Press Ctrl+C at any time to cancel.\n"));
+}
+// ─────────────────────────────────────────────
+// Wizard
+// ─────────────────────────────────────────────
+async function commandNew(targetDir) {
+    header();
+    const answers = await inquirer_1.default.prompt([
+        {
+            type: "input",
+            name: "name",
+            message: chalk_1.default.white("Agent name") + chalk_1.default.gray(" (kebab-case, e.g. invoice-classifier):"),
+            validate: (v) => /^[a-z][a-z0-9-]*$/.test(v) || "Use lowercase letters, numbers, and hyphens only",
+        },
+        {
+            type: "input",
+            name: "description",
+            message: chalk_1.default.white("What does this agent do?"),
+            validate: (v) => v.trim().length > 5 || "Please write a short description",
+        },
+        {
+            type: "list",
+            name: "type",
+            message: chalk_1.default.white("Agent type:"),
+            choices: [
+                { name: "reactive    — receives input → processes → responds", value: "reactive" },
+                { name: "proactive   — acts on triggers without waiting for input", value: "proactive" },
+                { name: "pipeline    — sequential steps, each feeding the next", value: "pipeline" },
+                { name: "orchestrator— coordinates other agents", value: "orchestrator" },
+                { name: "worker      — executed by an orchestrator", value: "worker" },
+            ],
+        },
+        {
+            type: "list",
+            name: "llm_provider",
+            message: chalk_1.default.white("LLM provider:"),
+            choices: [
+                { name: "anthropic       (Claude — requires ANTHROPIC_API_KEY)", value: "anthropic" },
+                { name: "openai          (GPT — requires OPENAI_API_KEY)", value: "openai" },
+                { name: "ollama          (local — requires Ollama running)", value: "ollama" },
+                { name: "lmstudio        (local — requires LM Studio running)", value: "lmstudio" },
+                { name: "openai-compatible (any OpenAI-compatible API)", value: "openai-compatible" },
+                { name: "none            (rule-based, no LLM)", value: "none" },
+            ],
+        },
+        {
+            type: "input",
+            name: "llm_model",
+            message: chalk_1.default.white("Model name:"),
+            when: (a) => a.llm_provider !== "none",
+            default: (a) => {
+                const defaults = {
+                    anthropic: "claude-sonnet-4-6",
+                    openai: "gpt-4o-mini",
+                    ollama: "llama3",
+                    lmstudio: "local-model",
+                    "openai-compatible": "default",
+                };
+                return defaults[a.llm_provider] ?? "";
+            },
+        },
+        {
+            type: "list",
+            name: "output_format",
+            message: chalk_1.default.white("Output format:"),
+            choices: [
+                { name: "text     — plain text response", value: "text" },
+                { name: "json     — structured JSON (add output schema)", value: "json" },
+                { name: "markdown — formatted markdown", value: "markdown" },
+            ],
+        },
+        {
+            type: "list",
+            name: "trust_level",
+            message: chalk_1.default.white("Trust level:"),
+            choices: [
+                { name: "0 — sandboxed  (no external access)", value: 0 },
+                { name: "1 — read-only  (reads data, no writes)", value: 1 },
+                { name: "2 — write      (reads and writes)", value: 2 },
+                { name: "3 — admin      (full control)", value: 3 },
+            ],
+        },
+    ]);
+    // Destino
+    const projectName = answers.name;
+    const dest = targetDir ? path.resolve(targetDir, projectName) : path.resolve(process.cwd(), projectName);
+    // Verificar se pasta já existe
+    if (fs.existsSync(dest)) {
+        console.log(chalk_1.default.red(`\n✗ Directory already exists: ${dest}`));
+        process.exit(1);
+    }
+    const spinner = (0, ora_1.default)("Creating your agent...").start();
+    try {
+        // Criar pasta
+        fs.mkdirSync(dest, { recursive: true });
+        // Gerar agent.yaml
+        const apiKeyVar = getApiKeyVar(answers.llm_provider);
+        const agentYaml = buildAgentYaml(answers, apiKeyVar);
+        fs.writeFileSync(path.join(dest, "agent.yaml"), agentYaml);
+        // Gerar agent.test.yaml
+        const testYaml = buildTestYaml(answers.name);
+        fs.writeFileSync(path.join(dest, "agent.test.yaml"), testYaml);
+        // Gerar README.md
+        const readme = buildReadme(answers);
+        fs.writeFileSync(path.join(dest, "README.md"), readme);
+        // Gerar .env.example
+        if (apiKeyVar) {
+            fs.writeFileSync(path.join(dest, ".env.example"), `${apiKeyVar}=your-api-key-here\n`);
+        }
+        spinner.succeed(chalk_1.default.green("Agent created!"));
+        // Summary
+        console.log("");
+        console.log(chalk_1.default.bold("  📁 " + dest));
+        console.log(chalk_1.default.gray("  ├── agent.yaml"));
+        console.log(chalk_1.default.gray("  ├── agent.test.yaml"));
+        console.log(chalk_1.default.gray("  ├── README.md"));
+        if (apiKeyVar)
+            console.log(chalk_1.default.gray("  └── .env.example"));
+        console.log("");
+        console.log(chalk_1.default.bold.cyan("  Next steps:"));
+        console.log(chalk_1.default.white(`  $ cd ${projectName}`));
+        if (apiKeyVar)
+            console.log(chalk_1.default.white(`  $ cp .env.example .env   # add your API key`));
+        console.log(chalk_1.default.white(`  $ cforge run              # execute the agent`));
+        console.log(chalk_1.default.white(`  $ cforge test             # run tests`));
+        console.log("");
+    }
+    catch (err) {
+        spinner.fail("Failed to create agent");
+        console.error(err);
+        process.exit(1);
+    }
+}
+// ─────────────────────────────────────────────
+// Builders
+// ─────────────────────────────────────────────
+function getApiKeyVar(provider) {
+    const map = {
+        anthropic: "ANTHROPIC_API_KEY",
+        openai: "OPENAI_API_KEY",
+    };
+    return map[provider] ?? null;
+}
+function buildAgentYaml(answers, apiKeyVar) {
+    const lines = [
+        `name: "${answers.name}"`,
+        `version: "1.0.0"`,
+        `description: "${answers.description}"`,
+        `type: ${answers.type}`,
+        `trust_level: ${answers.trust_level}`,
+        ``,
+        `llm:`,
+        `  provider: ${answers.llm_provider}`,
+    ];
+    if (answers.llm_provider !== "none") {
+        lines.push(`  model: ${answers.llm_model}`);
+        if (apiKeyVar) {
+            lines.push(`  api_key: "\${${apiKeyVar}}"`);
+        }
+        lines.push(`  temperature: 0.1`);
+        lines.push(`  max_tokens: 1000`);
+    }
+    lines.push(``);
+    lines.push(`prompt:`);
+    lines.push(`  system: |`);
+    lines.push(`    You are ${answers.description}.`);
+    lines.push(`    Be concise, accurate, and helpful.`);
+    lines.push(`  user_template: "{{input}}"`);
+    lines.push(`  variables:`);
+    lines.push(`    - name: input`);
+    lines.push(`      required: true`);
+    lines.push(`      description: "The user's input"`);
+    lines.push(``);
+    lines.push(`output:`);
+    lines.push(`  format: ${answers.output_format}`);
+    lines.push(``);
+    lines.push(`tests:`);
+    lines.push(`  - file: agent.test.yaml`);
+    lines.push(``);
+    return lines.join("\n");
+}
+function buildTestYaml(agentName) {
+    return [
+        `agent: "${agentName}"`,
+        ``,
+        `cases:`,
+        `  - name: "basic test"`,
+        `    input:`,
+        `      input: "Hello, world!"`,
+        `    expected_contains:`,
+        `      - "Hello"    # adjust to match your agent's expected output`,
+        `    timeout_ms: 30000`,
+        ``,
+    ].join("\n");
+}
+function buildReadme(answers) {
+    return [
+        `# ${answers.name}`,
+        ``,
+        `> ${answers.description}`,
+        ``,
+        `## Overview`,
+        ``,
+        `| Field | Value |`,
+        `|-------|-------|`,
+        `| **Type** | ${answers.type} |`,
+        `| **LLM** | ${answers.llm_provider}${answers.llm_model ? ` / ${answers.llm_model}` : ""} |`,
+        `| **Output** | ${answers.output_format} |`,
+        `| **Trust Level** | ${answers.trust_level} |`,
+        ``,
+        `## Usage`,
+        ``,
+        `\`\`\`bash`,
+        `cforge run    # execute the agent`,
+        `cforge test   # run test suite`,
+        `\`\`\``,
+        ``,
+        `## Configuration`,
+        ``,
+        `Edit \`agent.yaml\` to customize the agent's behavior.`,
+        ``,
+        `## Tests`,
+        ``,
+        `Edit \`agent.test.yaml\` to add test cases.`,
+        ``,
+        `---`,
+        ``,
+        `Built with [Clayton Forge](https://github.com/devclaytonn10/clayton-forge)`,
+        ``,
+    ].join("\n");
+}
+//# sourceMappingURL=new.js.map

package/dist/commands/run.d.ts

@@ -0,0 +1,2 @@
+export declare function commandRun(agentDir?: string, inputArg?: string): Promise<void>;
+//# sourceMappingURL=run.d.ts.map

package/dist/commands/run.js

@@ -0,0 +1,121 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commandRun = commandRun;
+const readline = __importStar(require("readline"));
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+// ─────────────────────────────────────────────
+// cforge run [agent-dir]
+// ─────────────────────────────────────────────
+async function commandRun(agentDir, inputArg) {
+    const { parseAgentFile, findAgentFile, executeAgent } = await Promise.resolve().then(() => __importStar(require("@clayton-forge/core")));
+    // 1. Find agent.yaml
+    const searchDir = agentDir ? require("path").resolve(agentDir) : process.cwd();
+    const agentPath = require("fs").existsSync(require("path").join(searchDir, "agent.yaml"))
+        ? require("path").join(searchDir, "agent.yaml")
+        : findAgentFile(searchDir);
+    if (!agentPath) {
+        console.error(chalk_1.default.red("✗ No agent.yaml found. Run this command inside an agent directory."));
+        process.exit(1);
+    }
+    // 2. Parse
+    let agent;
+    try {
+        agent = parseAgentFile(agentPath);
+    }
+    catch (err) {
+        console.error(chalk_1.default.red("✗ Invalid agent.yaml:"), err instanceof Error ? err.message : err);
+        process.exit(1);
+    }
+    console.log("");
+    console.log(chalk_1.default.bold.cyan(`  ▶ ${agent.name}`) + chalk_1.default.gray(` v${agent.version}`));
+    console.log(chalk_1.default.gray(`  ${agent.description ?? ""}`));
+    console.log(chalk_1.default.gray(`  Provider: ${agent.llm.provider}${agent.llm.model ? ` / ${agent.llm.model}` : ""}`));
+    console.log("");
+    // 3. Collect input
+    const requiredVars = agent.prompt.variables.filter((v) => v.required);
+    const variables = {};
+    if (inputArg && requiredVars.length <= 1) {
+        // Se só tem uma variável obrigatória, usa o argumento direto
+        const varName = requiredVars[0]?.name ?? "input";
+        variables[varName] = inputArg;
+    }
+    else {
+        // Interactive input
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        const question = (prompt) => new Promise((resolve) => rl.question(prompt, resolve));
+        for (const variable of agent.prompt.variables) {
+            if (variable.required || !variable.default) {
+                const defaultHint = variable.default ? chalk_1.default.gray(` (default: ${variable.default})`) : "";
+                const descHint = variable.description ? chalk_1.default.gray(` — ${variable.description}`) : "";
+                const value = await question(`  ${chalk_1.default.white(variable.name)}${descHint}${defaultHint}: `);
+                variables[variable.name] = value || variable.default || "";
+            }
+        }
+        rl.close();
+    }
+    console.log("");
+    // 4. Execute
+    const spinner = (0, ora_1.default)("Running agent...").start();
+    const result = await executeAgent(agent, { variables });
+    if (result.success) {
+        spinner.succeed(chalk_1.default.green(`Done`) + chalk_1.default.gray(` (${result.duration_ms}ms)`));
+        console.log("");
+        console.log(chalk_1.default.bold("  Output:"));
+        console.log("");
+        // Format output based on type
+        const lines = result.output.split("\n");
+        for (const line of lines) {
+            console.log("  " + line);
+        }
+        if (result.llm_response?.usage) {
+            const { input_tokens, output_tokens } = result.llm_response.usage;
+            console.log("");
+            console.log(chalk_1.default.gray(`  Tokens: ${input_tokens ?? "?"} in / ${output_tokens ?? "?"} out`));
+        }
+    }
+    else {
+        spinner.fail(chalk_1.default.red("Execution failed"));
+        console.log("");
+        console.error(chalk_1.default.red("  Error:"), result.error);
+        process.exit(1);
+    }
+    console.log("");
+}
+//# sourceMappingURL=run.js.map

package/dist/commands/test.d.ts

@@ -0,0 +1,2 @@
+export declare function commandTest(agentDir?: string): Promise<void>;
+//# sourceMappingURL=test.d.ts.map

package/dist/commands/test.js

@@ -0,0 +1,136 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commandTest = commandTest;
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+const chalk_1 = __importDefault(require("chalk"));
+const ora_1 = __importDefault(require("ora"));
+// ─────────────────────────────────────────────
+// cforge test [agent-dir]
+// ─────────────────────────────────────────────
+async function commandTest(agentDir) {
+    const { parseAgentFile, parseTestFile, runTestSuite, findAgentFile } = await Promise.resolve().then(() => __importStar(require("@clayton-forge/core")));
+    // 1. Find agent.yaml
+    const searchDir = agentDir ? path.resolve(agentDir) : process.cwd();
+    const agentYamlPath = fs.existsSync(path.join(searchDir, "agent.yaml"))
+        ? path.join(searchDir, "agent.yaml")
+        : findAgentFile(searchDir);
+    if (!agentYamlPath) {
+        console.error(chalk_1.default.red("✗ No agent.yaml found."));
+        process.exit(1);
+    }
+    // 2. Parse agent
+    let agent;
+    try {
+        agent = parseAgentFile(agentYamlPath);
+    }
+    catch (err) {
+        console.error(chalk_1.default.red("✗ Invalid agent.yaml:"), err instanceof Error ? err.message : err);
+        process.exit(1);
+    }
+    // 3. Find test files
+    const agentDir2 = path.dirname(agentYamlPath);
+    const testFiles = (agent.tests ?? []).map((t) => path.resolve(agentDir2, t.file));
+    // Fallback: tenta agent.test.yaml se não há tests declarados
+    if (testFiles.length === 0) {
+        const fallback = path.join(agentDir2, "agent.test.yaml");
+        if (fs.existsSync(fallback))
+            testFiles.push(fallback);
+    }
+    if (testFiles.length === 0) {
+        console.error(chalk_1.default.red("✗ No test files found. Create agent.test.yaml first."));
+        process.exit(1);
+    }
+    console.log("");
+    console.log(chalk_1.default.bold.cyan(`  ⚗  Testing: ${agent.name}`) + chalk_1.default.gray(` v${agent.version}`));
+    console.log(chalk_1.default.gray(`  Provider: ${agent.llm.provider}${agent.llm.model ? ` / ${agent.llm.model}` : ""}`));
+    console.log("");
+    let totalPassed = 0;
+    let totalFailed = 0;
+    for (const testFile of testFiles) {
+        // 4. Parse test suite
+        let suite;
+        try {
+            suite = parseTestFile(testFile);
+        }
+        catch (err) {
+            console.error(chalk_1.default.red(`✗ Invalid test file ${testFile}:`), err instanceof Error ? err.message : err);
+            continue;
+        }
+        console.log(chalk_1.default.gray(`  File: ${path.basename(testFile)}`));
+        console.log(chalk_1.default.gray(`  Cases: ${suite.cases.length}`));
+        console.log("");
+        // 5. Run
+        const spinner = (0, ora_1.default)("Running tests...").start();
+        const summary = await runTestSuite(agent, suite);
+        spinner.stop();
+        // 6. Display results
+        for (const result of summary.results) {
+            if (result.passed) {
+                console.log(chalk_1.default.green("  ✓ PASS") +
+                    chalk_1.default.white(` ${result.name}`) +
+                    chalk_1.default.gray(` (${result.duration_ms}ms)`));
+            }
+            else {
+                console.log(chalk_1.default.red("  ✗ FAIL") +
+                    chalk_1.default.white(` ${result.name}`) +
+                    chalk_1.default.gray(` (${result.duration_ms}ms)`));
+                for (const failure of result.failures) {
+                    console.log(chalk_1.default.red("       ↳ " + failure));
+                }
+                if (result.error) {
+                    console.log(chalk_1.default.red("       Error: " + result.error));
+                }
+            }
+        }
+        totalPassed += summary.passed;
+        totalFailed += summary.failed;
+        console.log("");
+        console.log(chalk_1.default.gray("  ─────────────────────────────────────"));
+        const statusColor = summary.failed === 0 ? chalk_1.default.green : chalk_1.default.red;
+        console.log(statusColor(`  ${summary.passed}/${summary.total} passed`) +
+            chalk_1.default.gray(` · ${summary.duration_ms}ms`));
+    }
+    console.log("");
+    // Final exit code
+    if (totalFailed > 0) {
+        process.exit(1);
+    }
+}
+//# sourceMappingURL=test.js.map

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map