@innominatum/agentforge-cli 1.0.1

package/dist/index.js

@@ -0,0 +1,739 @@
+#!/usr/bin/env node
+"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 });
+const commander_1 = require("commander");
+const fs_extra_1 = __importDefault(require("fs-extra"));
+const path_1 = __importDefault(require("path"));
+const slugify_1 = __importDefault(require("slugify"));
+const adm_zip_1 = __importDefault(require("adm-zip"));
+const form_data_1 = __importDefault(require("form-data"));
+const tar = __importStar(require("tar"));
+const axios_1 = __importDefault(require("axios"));
+const readline = __importStar(require("readline"));
+function confirmOverwrite(entityType) {
+    const rl = readline.createInterface({
+        input: process.stdin,
+        output: process.stdout
+    });
+    return new Promise(resolve => {
+        rl.question(`⚠️ Atenção: O pull irá sobrescrever as suas ${entityType} locais. Quaisquer alterações não publicadas serão perdidas. Deseja continuar? (s/N) `, answer => {
+            rl.close();
+            const isYes = answer.toLowerCase() === 's' || answer.toLowerCase() === 'sim' || answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes';
+            resolve(isYes);
+        });
+    });
+}
+function getWorkspaceRoot() {
+    let dir = process.cwd();
+    while (dir !== path_1.default.parse(dir).root) {
+        if (fs_extra_1.default.existsSync(path_1.default.join(dir, "agentforge.json")) || fs_extra_1.default.existsSync(path_1.default.join(dir, "agentforge.yml"))) {
+            return dir;
+        }
+        dir = path_1.default.dirname(dir);
+    }
+    if (fs_extra_1.default.existsSync(path_1.default.join(dir, "agentforge.json")) || fs_extra_1.default.existsSync(path_1.default.join(dir, "agentforge.yml"))) {
+        return dir;
+    }
+    console.error("❌ Erro: Não foi possível encontrar a raiz do workspace (agentforge.json). Certifique-se de estar dentro do projeto.");
+    process.exit(1);
+}
+const program = new commander_1.Command();
+program
+    .name("agentforge")
+    .description("CLI para gerir agentes, equipas e templates de agentes")
+    .version("0.1.0");
+program
+    .command("init")
+    .alias("start")
+    .description("Cria a estrutura inicial do workspace de agentes")
+    .action(async () => {
+    const basePath = process.cwd();
+    const folders = [
+        "agents",
+        "documents",
+        "templates/default-agent",
+        "exports"
+    ];
+    for (const folder of folders) {
+        await fs_extra_1.default.ensureDir(path_1.default.join(basePath, folder));
+    }
+    const config = {
+        workspace: "agentforge",
+        version: 1,
+        goclaw: {
+            api_url: "http://localhost:18790",
+            username: "system",
+            token: "",
+            default_provider: "ollama-cloud",
+            default_model: "deepseek-v4-pro",
+            skills_import_endpoint: "/v1/skills/import",
+            skills_export_endpoint: "/v1/skills/export"
+        }
+    };
+    await fs_extra_1.default.writeJson(path_1.default.join(basePath, "agentforge.json"), config, { spaces: 2 });
+    // Copiar o manual da CLI para servir de README do workspace
+    const cliManualPath = path_1.default.join(__dirname, "../templates/CLI_MANUAL.md");
+    const workspaceReadmePath = path_1.default.join(basePath, "README.md");
+    if (await fs_extra_1.default.pathExists(cliManualPath)) {
+        await fs_extra_1.default.copy(cliManualPath, workspaceReadmePath);
+    }
+    else {
+        await fs_extra_1.default.writeFile(workspaceReadmePath, `# Agent Workspace\n\nWorkspace criado pela AgentForge CLI.\n`);
+    }
+    // Opcional: Copiar os templates originais da CLI para o workspace do usuário
+    const cliTemplatePath = path_1.default.join(__dirname, "../templates/default-agent");
+    const workspaceTemplatePath = path_1.default.join(basePath, "templates/default-agent");
+    if (await fs_extra_1.default.pathExists(cliTemplatePath)) {
+        await fs_extra_1.default.copy(cliTemplatePath, workspaceTemplatePath);
+    }
+    // Copiar documentação do GoClaw para a pasta documents
+    const cliDocPath = path_1.default.join(__dirname, "../goclaw-llms-full.txt");
+    const workspaceDocPath = path_1.default.join(basePath, "documents/goclaw-llms-full.txt");
+    if (await fs_extra_1.default.pathExists(cliDocPath)) {
+        await fs_extra_1.default.copy(cliDocPath, workspaceDocPath);
+    }
+    console.log("Workspace de agentes criado com sucesso.");
+});
+const newCmd = program
+    .command("new")
+    .description("Cria novas entidades (agentes, skills, etc)");
+program
+    .command("manual")
+    .alias("help-docs")
+    .description("Exibe o manual completo de uso da AgentForge CLI")
+    .action(async () => {
+    const cliManualPath = path_1.default.join(__dirname, "../templates/CLI_MANUAL.md");
+    if (await fs_extra_1.default.pathExists(cliManualPath)) {
+        const content = await fs_extra_1.default.readFile(cliManualPath, "utf-8");
+        console.log(content);
+    }
+    else {
+        console.error("❌ Manual não encontrado.");
+    }
+});
+newCmd
+    .command("agent <name>")
+    .description("Cria um novo agente com os ficheiros base da template")
+    .action(async (name) => {
+    const basePath = getWorkspaceRoot();
+    const slug = (0, slugify_1.default)(name, { lower: true, strict: true });
+    const agentPath = path_1.default.join(basePath, "agents", slug);
+    if (await fs_extra_1.default.pathExists(agentPath)) {
+        console.error(`❌ O agente "${name}" já existe em agents/${slug}.`);
+        process.exit(1);
+    }
+    await fs_extra_1.default.ensureDir(agentPath);
+    const workspaceTemplatePath = path_1.default.join(basePath, "templates/default-agent");
+    const cliTemplatePath = path_1.default.join(__dirname, "../templates/default-agent");
+    let sourceTemplatePath = "";
+    if (await fs_extra_1.default.pathExists(workspaceTemplatePath)) {
+        sourceTemplatePath = workspaceTemplatePath;
+    }
+    else if (await fs_extra_1.default.pathExists(cliTemplatePath)) {
+        sourceTemplatePath = cliTemplatePath;
+    }
+    if (sourceTemplatePath !== "") {
+        await fs_extra_1.default.copy(sourceTemplatePath, agentPath);
+        try {
+            const config = await getConfig();
+            const agentJson = {
+                agent_key: slug,
+                display_name: name,
+                agent_type: "custom",
+                status: "active",
+                emoji: "🔥",
+                context_window: 200000,
+                max_tool_iterations: 30,
+                provider: config.goclaw?.default_provider || "ollama cloud",
+                model: config.goclaw?.default_model || "deepseek-v4-pro",
+                frontmatter: `Expertise summary for ${name}`
+            };
+            await fs_extra_1.default.writeJson(path_1.default.join(agentPath, "agent.json"), agentJson, { spaces: 2 });
+        }
+        catch (err) {
+            // Fallback se não conseguir ler config
+        }
+        console.log(`✅ Agente "${name}" criado com sucesso em agents/${slug} usando templates!`);
+    }
+    else {
+        console.warn("⚠️ Nenhuma pasta de templates encontrada. Criando estrutura básica...");
+        try {
+            const config = await getConfig();
+            const agentJson = {
+                agent_key: slug,
+                display_name: name,
+                agent_type: "custom",
+                provider: config.goclaw?.default_provider || "ollama cloud",
+                model: config.goclaw?.default_model || "deepseek-v4-pro",
+                other_config: {
+                    description: `Agent ${name} created by AgentForge`
+                }
+            };
+            await fs_extra_1.default.writeJson(path_1.default.join(agentPath, "agent.json"), agentJson, { spaces: 2 });
+        }
+        catch (err) { }
+        await fs_extra_1.default.writeFile(path_1.default.join(agentPath, "SOUL.md"), `# ${name}\n\nAgente criado pela AgentForge CLI.\n`);
+        await fs_extra_1.default.writeFile(path_1.default.join(agentPath, "HEARTBEAT.md"), `# Instruções de Heartbeat\n`);
+        console.log(`✅ Agente "${name}" criado com sucesso em agents/${slug}.`);
+    }
+});
+newCmd
+    .command("skill <name>")
+    .description("Cria uma nova skill usando o template base")
+    .action(async (name) => {
+    const basePath = getWorkspaceRoot();
+    const slug = (0, slugify_1.default)(name, { lower: true, strict: true });
+    const skillPath = path_1.default.join(basePath, "skills", slug);
+    if (await fs_extra_1.default.pathExists(skillPath)) {
+        console.error(`❌ A skill "${name}" já existe em skills/${slug}.`);
+        process.exit(1);
+    }
+    await fs_extra_1.default.ensureDir(skillPath);
+    const workspaceTemplatePath = path_1.default.join(basePath, "templates/default-skill");
+    const cliTemplatePath = path_1.default.join(__dirname, "../templates/default-skill");
+    let sourceTemplatePath = "";
+    if (await fs_extra_1.default.pathExists(workspaceTemplatePath)) {
+        sourceTemplatePath = workspaceTemplatePath;
+    }
+    else if (await fs_extra_1.default.pathExists(cliTemplatePath)) {
+        sourceTemplatePath = cliTemplatePath;
+    }
+    if (sourceTemplatePath !== "") {
+        await fs_extra_1.default.copy(sourceTemplatePath, skillPath);
+        // Update the {{name}} placeholder in SKILL.md
+        const skillMdPath = path_1.default.join(skillPath, "SKILL.md");
+        if (await fs_extra_1.default.pathExists(skillMdPath)) {
+            let content = await fs_extra_1.default.readFile(skillMdPath, 'utf8');
+            content = content.replace(/{{name}}/g, name);
+            await fs_extra_1.default.writeFile(skillMdPath, content);
+        }
+        console.log(`✅ Skill "${name}" criada com sucesso em skills/${slug} usando templates!`);
+    }
+    else {
+        console.warn("⚠️ Nenhum template de skill encontrado. Criando um SKILL.md vazio.");
+        await fs_extra_1.default.writeFile(path_1.default.join(skillPath, "SKILL.md"), `---\nname: "${name}"\ndescription: "Skill description"\ndeps: []\n---\n\n## Instruções\n`);
+        console.log(`✅ Skill "${name}" criada com sucesso em skills/${slug}.`);
+    }
+});
+const buildCmd = program
+    .command("build")
+    .description("Realiza o build (empacotamento) de entidades");
+buildCmd
+    .command("skill <slug>")
+    .description("Empacota uma skill em um arquivo .zip na pasta exports/")
+    .action(async (slug) => {
+    const basePath = getWorkspaceRoot();
+    const skillPath = path_1.default.join(basePath, "skills", slug);
+    const exportsPath = path_1.default.join(basePath, "exports");
+    const zipPath = path_1.default.join(exportsPath, `${slug}.zip`);
+    if (!(await fs_extra_1.default.pathExists(skillPath))) {
+        console.error(`❌ A skill "${slug}" não foi encontrada em skills/${slug}.`);
+        process.exit(1);
+    }
+    await fs_extra_1.default.ensureDir(exportsPath);
+    const zip = new adm_zip_1.default();
+    zip.addLocalFolder(skillPath, "");
+    zip.writeZip(zipPath);
+    console.log(`✅ Build concluído: ${slug}.zip salvo na pasta exports/`);
+});
+async function getConfig() {
+    const root = getWorkspaceRoot();
+    const configPath = path_1.default.join(root, "agentforge.json");
+    if (!(await fs_extra_1.default.pathExists(configPath))) {
+        console.error("❌ Arquivo agentforge.json não encontrado. Execute 'agentforge init' primeiro.");
+        process.exit(1);
+    }
+    const config = await fs_extra_1.default.readJson(configPath);
+    if (config.goclaw && config.goclaw.api_url) {
+        config.goclaw.api_url = config.goclaw.api_url.replace(/\/$/, "");
+    }
+    return config;
+}
+const deployCmd = program
+    .command("deploy")
+    .description("Faz o deploy de entidades para a plataforma GoClaw");
+deployCmd
+    .command("skill <slug>")
+    .description("Faz o build da skill e envia para a API do GoClaw")
+    .action(async (slug) => {
+    const config = await getConfig();
+    if (!config.goclaw || !config.goclaw.token) {
+        console.error("❌ Configure sua chave de API (token) no agentforge.json antes de fazer o deploy.");
+        process.exit(1);
+    }
+    const basePath = getWorkspaceRoot();
+    const skillPath = path_1.default.join(basePath, "skills", slug);
+    const exportsPath = path_1.default.join(basePath, "exports");
+    const zipPath = path_1.default.join(exportsPath, `${slug}.zip`);
+    if (!(await fs_extra_1.default.pathExists(skillPath))) {
+        console.error(`❌ A skill "${slug}" não foi encontrada em skills/${slug}.`);
+        process.exit(1);
+    }
+    await fs_extra_1.default.ensureDir(exportsPath);
+    const zip = new adm_zip_1.default();
+    zip.addLocalFolder(skillPath, "");
+    zip.writeZip(zipPath);
+    console.log(`✅ Build concluído: ${slug}.zip preparado para envio.`);
+    console.log(`🚀 Fazendo upload para o GoClaw...`);
+    const form = new form_data_1.default();
+    form.append("file", fs_extra_1.default.createReadStream(zipPath));
+    try {
+        const url = `${config.goclaw.api_url}/v1/skills/upload`;
+        const response = await axios_1.default.post(url, form, {
+            headers: {
+                ...form.getHeaders(),
+                Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system"
+            }
+        });
+        const data = response.data;
+        if (data && data.version) {
+            console.log(`📌 Skill atualizada para a versão ${data.version}.`);
+        }
+    }
+    catch (error) {
+        console.error("❌ Erro durante o deploy:");
+        if (error.response) {
+            console.error(error.response.data);
+        }
+        else {
+            console.error(error.message);
+        }
+    }
+});
+async function deployContextFiles(slug, config) {
+    const basePath = getWorkspaceRoot();
+    const agentPath = path_1.default.join(basePath, "agents", slug);
+    if (!(await fs_extra_1.default.pathExists(agentPath))) {
+        throw new Error(`Agente não encontrado em agents/${slug}`);
+    }
+    const files = await fs_extra_1.default.readdir(agentPath);
+    const contextFiles = files.filter(f => f.endsWith('.md') || f.endsWith('.txt') || f.endsWith('.py')).filter(f => f !== 'README.md' && f !== 'agent.json');
+    if (contextFiles.length === 0) {
+        console.log(`Nenhum arquivo de contexto encontrado para "${slug}".`);
+        return;
+    }
+    const tempExportDir = path_1.default.join(basePath, `temp_export_${slug}`);
+    const tempContextDir = path_1.default.join(tempExportDir, "context_files");
+    const tarPath = path_1.default.join(basePath, `temp_export_${slug}.tar.gz`);
+    try {
+        await fs_extra_1.default.ensureDir(tempContextDir);
+        for (const file of contextFiles) {
+            await fs_extra_1.default.copy(path_1.default.join(agentPath, file), path_1.default.join(tempContextDir, file));
+        }
+        await tar.c({
+            gzip: true,
+            file: tarPath,
+            cwd: tempExportDir
+        }, ["context_files"]);
+        const form = new form_data_1.default();
+        form.append("file", fs_extra_1.default.createReadStream(tarPath));
+        const url = `${config.goclaw.api_url}/v1/agents/${slug}/import?include=context_files`;
+        await axios_1.default.post(url, form, {
+            headers: {
+                ...form.getHeaders(),
+                Authorization: `Bearer ${config.goclaw.token}`,
+                "X-GoClaw-User-Id": config.goclaw.username || "system"
+            }
+        });
+        console.log(`✅ Upload cirúrgico de ${contextFiles.length} arquivos concluído com sucesso!`);
+    }
+    finally {
+        if (await fs_extra_1.default.pathExists(tempExportDir))
+            await fs_extra_1.default.remove(tempExportDir);
+        if (await fs_extra_1.default.pathExists(tarPath))
+            await fs_extra_1.default.remove(tarPath);
+    }
+}
+deployCmd
+    .command("context <slug>")
+    .description("Faz upload dos arquivos de contexto diretamente para o agente usando a API de importação")
+    .action(async (slug) => {
+    const config = await getConfig();
+    if (!config.goclaw || !config.goclaw.token) {
+        console.error("❌ Configure sua chave de API (token) no agentforge.json.");
+        process.exit(1);
+    }
+    console.log(`🚀 Sincronizando arquivos de contexto do agente "${slug}"...`);
+    try {
+        await deployContextFiles(slug, config);
+        console.log("✅ Deploy de contexto concluído!");
+    }
+    catch (error) {
+        console.error("❌ Erro ao enviar contexto:", error.response?.data || error.message);
+    }
+});
+deployCmd
+    .command("agent <slug>")
+    .description("Faz deploy completo do agente (configuração + arquivos de contexto)")
+    .action(async (slug) => {
+    const config = await getConfig();
+    if (!config.goclaw || !config.goclaw.token) {
+        console.error("❌ Configure sua chave de API (token) no agentforge.json.");
+        process.exit(1);
+    }
+    const basePath = getWorkspaceRoot();
+    const agentPath = path_1.default.join(basePath, "agents", slug);
+    const agentJsonPath = path_1.default.join(agentPath, "agent.json");
+    if (!(await fs_extra_1.default.pathExists(agentJsonPath))) {
+        console.error(`❌ agent.json não encontrado em agents/${slug}.`);
+        process.exit(1);
+    }
+    const agentConfig = await fs_extra_1.default.readJson(agentJsonPath);
+    console.log(`🚀 Atualizando configuração do agente "${slug}"...`);
+    try {
+        let exists = true;
+        try {
+            await axios_1.default.get(`${config.goclaw.api_url}/v1/agents/${slug}`, {
+                headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
+            });
+        }
+        catch (e) {
+            if (e.response && e.response.status === 404) {
+                exists = false;
+            }
+            else {
+                throw e;
+            }
+        }
+        if (!exists) {
+            await axios_1.default.post(`${config.goclaw.api_url}/v1/agents`, agentConfig, {
+                headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
+            });
+            console.log("✅ Agente criado com sucesso.");
+        }
+        else {
+            await axios_1.default.put(`${config.goclaw.api_url}/v1/agents/${slug}`, agentConfig, {
+                headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
+            });
+            console.log("✅ Configurações do agente atualizadas.");
+        }
+        console.log(`🚀 Sincronizando arquivos de contexto...`);
+        await deployContextFiles(slug, config);
+        console.log("✅ Deploy completo concluído!");
+    }
+    catch (error) {
+        console.error(`❌ Erro no deploy da configuração:`, error.response?.data || error.message);
+    }
+});
+const pullCmd = program
+    .command("pull")
+    .description("Sincroniza entidades do GoClaw para o workspace local");
+pullCmd
+    .command("skills")
+    .description("Faz download do arquivo tar.gz de skills do GoClaw e extrai localmente")
+    .action(async () => {
+    const config = await getConfig();
+    if (!config.goclaw || !config.goclaw.token) {
+        console.error("❌ Configure sua chave de API (token) no agentforge.json antes de fazer o pull.");
+        process.exit(1);
+    }
+    if (!(await confirmOverwrite("skills"))) {
+        console.log("❌ Pull cancelado pelo utilizador.");
+        return;
+    }
+    console.log("📥 Baixando skills do GoClaw...");
+    try {
+        const url = `${config.goclaw.api_url}${config.goclaw.skills_export_endpoint || '/v1/skills/export'}`;
+        const response = await axios_1.default.get(url, {
+            headers: {
+                Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system"
+            },
+            responseType: "stream"
+        });
+        const tempTarPath = path_1.default.join(getWorkspaceRoot(), "temp_skills.tar.gz");
+        const writer = fs_extra_1.default.createWriteStream(tempTarPath);
+        response.data.pipe(writer);
+        await new Promise((resolve, reject) => {
+            writer.on("finish", resolve);
+            writer.on("error", reject);
+        });
+        console.log("📦 Extraindo skills para a pasta local...");
+        await tar.x({
+            file: tempTarPath,
+            cwd: getWorkspaceRoot()
+        });
+        await fs_extra_1.default.remove(tempTarPath);
+        console.log("📥 Baixando ficheiros de código das skills...");
+        const skillsListRes = await axios_1.default.get(`${config.goclaw.api_url}/v1/skills`, {
+            headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
+        });
+        const skills = skillsListRes.data.skills || [];
+        for (const skill of skills) {
+            try {
+                const isSystem = skill.is_system === true;
+                const targetFolder = isSystem ? path_1.default.join("system", skill.slug) : skill.slug;
+                if (isSystem) {
+                    const originalPath = path_1.default.join(getWorkspaceRoot(), "skills", skill.slug);
+                    const newPath = path_1.default.join(getWorkspaceRoot(), "skills", targetFolder);
+                    if (await fs_extra_1.default.pathExists(originalPath)) {
+                        await fs_extra_1.default.ensureDir(path_1.default.dirname(newPath));
+                        await fs_extra_1.default.move(originalPath, newPath, { overwrite: true });
+                    }
+                }
+                const filesRes = await axios_1.default.get(`${config.goclaw.api_url}/v1/skills/${skill.id}/files`, {
+                    headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
+                });
+                const files = filesRes.data.files || [];
+                for (const file of files) {
+                    if (file.isDir)
+                        continue;
+                    const fileContentRes = await axios_1.default.get(`${config.goclaw.api_url}/v1/skills/${skill.id}/files/${file.path}`, {
+                        headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
+                    });
+                    const filePath = path_1.default.join(getWorkspaceRoot(), "skills", targetFolder, file.path);
+                    await fs_extra_1.default.ensureDir(path_1.default.dirname(filePath));
+                    await fs_extra_1.default.writeFile(filePath, fileContentRes.data.content || "");
+                }
+            }
+            catch (fileErr) {
+                console.warn(`⚠️ Não foi possível transferir os ficheiros da skill ${skill.slug}: ${fileErr.message}`);
+            }
+        }
+        console.log("✅ Pull concluído com sucesso! As skills foram atualizadas localmente.");
+    }
+    catch (error) {
+        console.error("❌ Erro durante o pull das skills:");
+        if (error.response) {
+            console.error(`Status HTTP ${error.response.status}`);
+        }
+        else {
+            console.error(error.message);
+        }
+    }
+});
+pullCmd
+    .command("agents")
+    .description("Faz download cirúrgico dos agentes (configuração e contexto)")
+    .action(async () => {
+    const config = await getConfig();
+    if (!config.goclaw || !config.goclaw.token) {
+        console.error("❌ Configure sua chave de API (token) no agentforge.json antes de fazer o pull.");
+        process.exit(1);
+    }
+    if (!(await confirmOverwrite("agentes"))) {
+        console.log("❌ Pull cancelado pelo utilizador.");
+        return;
+    }
+    console.log("📥 Buscando lista de agentes do GoClaw...");
+    try {
+        const listResponse = await axios_1.default.get(`${config.goclaw.api_url}/v1/agents`, {
+            headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
+        });
+        const agents = listResponse.data.agents || [];
+        console.log(`Encontrados ${agents.length} agentes. Sincronizando...`);
+        for (const agent of agents) {
+            const slug = agent.agent_key;
+            console.log(`📦 Baixando agente: ${slug}...`);
+            const url = `${config.goclaw.api_url}/v1/agents/${agent.id}/export`;
+            const response = await axios_1.default.get(url, {
+                headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" },
+                responseType: "stream"
+            });
+            const tempTarPath = path_1.default.join(getWorkspaceRoot(), `temp_agent_${slug}.tar.gz`);
+            try {
+                const writer = fs_extra_1.default.createWriteStream(tempTarPath);
+                response.data.pipe(writer);
+                await new Promise((resolve, reject) => {
+                    writer.on("finish", resolve);
+                    writer.on("error", reject);
+                });
+                const agentPath = path_1.default.join(getWorkspaceRoot(), "agents", slug);
+                await fs_extra_1.default.ensureDir(agentPath);
+                await tar.x({
+                    file: tempTarPath,
+                    cwd: agentPath,
+                    strip: 0,
+                    filter: (path) => {
+                        return path === 'agent.json' || path.startsWith('context_files/');
+                    }
+                });
+                const contextDir = path_1.default.join(agentPath, "context_files");
+                if (await fs_extra_1.default.pathExists(contextDir)) {
+                    const contextFiles = await fs_extra_1.default.readdir(contextDir);
+                    for (const f of contextFiles) {
+                        await fs_extra_1.default.move(path_1.default.join(contextDir, f), path_1.default.join(agentPath, f), { overwrite: true });
+                    }
+                    await fs_extra_1.default.remove(contextDir);
+                }
+            }
+            finally {
+                if (await fs_extra_1.default.pathExists(tempTarPath)) {
+                    await fs_extra_1.default.remove(tempTarPath);
+                }
+            }
+        }
+        console.log("✅ Pull de agentes concluído com sucesso!");
+    }
+    catch (error) {
+        if (error.response && error.response.status) {
+            console.error(`❌ Erro durante o pull dos agentes: HTTP ${error.response.status} - Verifique suas credenciais e permissões no agentforge.json (username deve ser o dono do agente).`);
+        }
+        else {
+            console.error("❌ Erro durante o pull dos agentes:", error.message);
+        }
+    }
+});
+pullCmd
+    .command('all')
+    .description('Faz download cirúrgico de todos os agentes e skills do GoClaw para a pasta local')
+    .action(async () => {
+    const config = await getConfig();
+    if (!config.goclaw || !config.goclaw.token) {
+        console.error('❌ Configure sua chave de API (token) no agentforge.json antes de fazer o pull.');
+        process.exit(1);
+    }
+    if (!(await confirmOverwrite('TUDO (agentes e skills)'))) {
+        console.log('❌ Pull cancelado pelo utilizador.');
+        return;
+    }
+    console.log('🔄 Iniciando sincronização completa (pull all)...');
+    // PULL SKILLS INLINE
+    console.log('\n--- [1/2] SKILLS ---');
+    try {
+        const url = `${config.goclaw.api_url}${config.goclaw.skills_export_endpoint || '/v1/skills/export'}`;
+        const response = await axios_1.default.get(url, {
+            headers: { Authorization: `Bearer ${config.goclaw.token}`, 'X-GoClaw-User-Id': config.goclaw.username || 'system' },
+            responseType: 'stream'
+        });
+        const tempTarPath = path_1.default.join(getWorkspaceRoot(), 'temp_skills.tar.gz');
+        const writer = fs_extra_1.default.createWriteStream(tempTarPath);
+        response.data.pipe(writer);
+        await new Promise((resolve, reject) => {
+            writer.on('finish', resolve);
+            writer.on('error', reject);
+        });
+        await tar.x({ file: tempTarPath, cwd: getWorkspaceRoot() });
+        await fs_extra_1.default.remove(tempTarPath);
+        const skillsListRes = await axios_1.default.get(`${config.goclaw.api_url}/v1/skills`, {
+            headers: { Authorization: `Bearer ${config.goclaw.token}`, 'X-GoClaw-User-Id': config.goclaw.username || 'system' }
+        });
+        const skills = skillsListRes.data.skills || [];
+        for (const skill of skills) {
+            try {
+                const isSystem = skill.is_system === true;
+                const targetFolder = isSystem ? path_1.default.join('system', skill.slug) : skill.slug;
+                if (isSystem) {
+                    const originalPath = path_1.default.join(getWorkspaceRoot(), 'skills', skill.slug);
+                    const newPath = path_1.default.join(getWorkspaceRoot(), 'skills', targetFolder);
+                    if (await fs_extra_1.default.pathExists(originalPath)) {
+                        await fs_extra_1.default.ensureDir(path_1.default.dirname(newPath));
+                        await fs_extra_1.default.move(originalPath, newPath, { overwrite: true });
+                    }
+                }
+                const filesRes = await axios_1.default.get(`${config.goclaw.api_url}/v1/skills/${skill.id}/files`, {
+                    headers: { Authorization: `Bearer ${config.goclaw.token}`, 'X-GoClaw-User-Id': config.goclaw.username || 'system' }
+                });
+                const files = filesRes.data.files || [];
+                for (const file of files) {
+                    if (file.isDir)
+                        continue;
+                    const fileContentRes = await axios_1.default.get(`${config.goclaw.api_url}/v1/skills/${skill.id}/files/${file.path}`, {
+                        headers: { Authorization: `Bearer ${config.goclaw.token}`, 'X-GoClaw-User-Id': config.goclaw.username || 'system' }
+                    });
+                    const filePath = path_1.default.join(getWorkspaceRoot(), 'skills', targetFolder, file.path);
+                    await fs_extra_1.default.ensureDir(path_1.default.dirname(filePath));
+                    await fs_extra_1.default.writeFile(filePath, fileContentRes.data.content || '');
+                }
+            }
+            catch (fileErr) {
+                console.warn(`⚠️ Não foi possível transferir os ficheiros da skill ${skill.slug}: ${fileErr.message}`);
+            }
+        }
+        console.log('✅ Pull de skills concluído!');
+    }
+    catch (error) {
+        console.error('❌ Erro durante o pull das skills:', error.message);
+    }
+    // PULL AGENTS INLINE
+    console.log('\n--- [2/2] AGENTS ---');
+    try {
+        const listResponse = await axios_1.default.get(`${config.goclaw.api_url}/v1/agents`, {
+            headers: { Authorization: `Bearer ${config.goclaw.token}`, 'X-GoClaw-User-Id': config.goclaw.username || 'system' }
+        });
+        const agents = listResponse.data.agents || [];
+        console.log(`Encontrados ${agents.length} agentes. Sincronizando...`);
+        for (const agent of agents) {
+            const slug = agent.agent_key;
+            console.log(`📦 Baixando agente: ${slug}...`);
+            const url = `${config.goclaw.api_url}/v1/agents/${agent.id}/export`;
+            const response = await axios_1.default.get(url, {
+                headers: { Authorization: `Bearer ${config.goclaw.token}`, 'X-GoClaw-User-Id': config.goclaw.username || 'system' },
+                responseType: 'stream'
+            });
+            const tempTarPath = path_1.default.join(getWorkspaceRoot(), `temp_agent_${slug}.tar.gz`);
+            try {
+                const writer = fs_extra_1.default.createWriteStream(tempTarPath);
+                response.data.pipe(writer);
+                await new Promise((resolve, reject) => {
+                    writer.on('finish', resolve);
+                    writer.on('error', reject);
+                });
+                const agentPath = path_1.default.join(getWorkspaceRoot(), 'agents', slug);
+                await fs_extra_1.default.ensureDir(agentPath);
+                await tar.x({
+                    file: tempTarPath,
+                    cwd: agentPath,
+                    strip: 0,
+                    filter: (path) => {
+                        return path === 'agent.json' || path.startsWith('context_files/');
+                    }
+                });
+                const contextDir = path_1.default.join(agentPath, 'context_files');
+                if (await fs_extra_1.default.pathExists(contextDir)) {
+                    const contextFiles = await fs_extra_1.default.readdir(contextDir);
+                    for (const f of contextFiles) {
+                        await fs_extra_1.default.move(path_1.default.join(contextDir, f), path_1.default.join(agentPath, f), { overwrite: true });
+                    }
+                    await fs_extra_1.default.remove(contextDir);
+                }
+            }
+            finally {
+                if (await fs_extra_1.default.pathExists(tempTarPath)) {
+                    await fs_extra_1.default.remove(tempTarPath);
+                }
+            }
+        }
+        console.log('✅ Pull de agentes concluído!');
+    }
+    catch (error) {
+        console.error('❌ Erro durante o pull dos agentes:', error.message);
+    }
+    console.log('\n🚀 SYNC COMPLETO! Workspace atualizado.');
+});
+program.parse();