@innominatum/agentforge-cli 1.0.1 → 1.0.7

package/.github/workflows/publish.yml

@@ -0,0 +1,36 @@
+name: Publish Package to npmjs
+
+on:
+  release:
+    types: [published]
+  # Alternatively, you can uncomment the following to publish whenever you push to main
+  # push:
+  #   branches:
+  #     - main
+
+jobs:
+  build-and-publish:
+    runs-on: ubuntu-latest
+    env:
+      FORCE_JAVASCRIPT_ACTIONS_TO_NODE24: true
+    permissions:
+      contents: read
+      id-token: write # Required for NPM Trusted Publishing (OIDC)
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '20.x'
+          registry-url: 'https://registry.npmjs.org'
+
+      - name: Install dependencies
+        run: npm ci
+
+      - name: Build TypeScript code
+        run: npm run build
+
+      - name: Publish to NPM
+        run: npm publish --access public --provenance

package/README.md

@@ -8,6 +8,14 @@ A powerful command-line interface to scaffold, manage, build, and deploy AI Agen
 
 ## Installation & Local Development
 
+### Global Installation (Recommended)
+You can install the AgentForge CLI globally directly from NPM:
+
+```bash
+npm install -g @innominatum/agentforge-cli
+```
+
+### Local Development
 Since you are modifying or maintaining the CLI source code, you should install and use it globally on your local machine using NPM's symlink feature:
 
 1. Clone this repository and navigate to its folder.
@@ -63,10 +71,23 @@ If you add a new command or change how the CLI works:
 
 ## NPM Publishing (Maintainers)
 
-When this CLI is ready for public release, ensure the following steps are taken:
-1. Update the `version` in `package.json` (e.g., `"version": "1.0.1"`).
-2. Ensure the `name` is correctly set to `"agentforge-cli"`.
-3. Verify that the `"bin"` property is pointing to `"./dist/index.js"`.
-4. Run `npm run build` to ensure the `dist/` directory is fully updated.
-5. Login to your npm account using `npm login`.
-6. Publish the package using `npm publish`.
+### Manual Publishing
+When this CLI is ready for a new release:
+1. Update the `version` in `package.json` (e.g., from `"1.0.1"` to `"1.0.2"`).
+2. Run `npm run build` to ensure the `dist/` directory is fully updated.
+3. Login to your npm account using `npm login`.
+4. Publish the package using `npm publish --access public` (you will be prompted for your 2FA security key).
+
+### Automated Publishing (Trusted Publishing / OIDC)
+To fully automate your CI/CD pipeline securely without using any hardcoded NPM tokens or bypassing 2FA, NPM provides "Trusted Publishing" with GitHub Actions:
+
+1. Go to the NPM website and navigate to the `@innominatum/agentforge-cli` package.
+2. Go to **Settings** > **Publishing Access**.
+3. Under **Trusted Publishers**, click **Add Publisher** > **GitHub Actions**.
+4. Fill in the repository details:
+   - **GitHub Organization/User:** `Innominatum-pt`
+   - **GitHub Repository:** `agentforge-cli`
+   - **Workflow file (optional):** `publish.yml`
+5. Click **Add Publisher**.
+
+Once configured, the `.github/workflows/publish.yml` workflow provided in this repository will automatically securely authenticate via OIDC and publish your package whenever you create a new GitHub Release.

package/dist/index.js

@@ -285,6 +285,19 @@ async function getConfig() {
     }
     return config;
 }
+async function resolveAgentId(slug, config) {
+    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 || [];
+        const agent = agents.find((a) => a.agent_key === slug);
+        return agent ? agent.id : null;
+    }
+    catch (error) {
+        return null;
+    }
+}
 const deployCmd = program
     .command("deploy")
     .description("Faz o deploy de entidades para a plataforma GoClaw");
@@ -336,34 +349,61 @@ deployCmd
         }
     }
 });
-async function deployContextFiles(slug, config) {
+async function deployContextFiles(slug, config, resolvedId) {
+    const agentId = resolvedId || (await resolveAgentId(slug, config)) || slug;
     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}".`);
+    // Identificar ficheiros de contexto e de memória
+    const memoryFileNames = ['MEMORY.md', 'memory.md'];
+    const memoryDirName = 'memory';
+    const contextFiles = files.filter(f => (f.endsWith('.md') || f.endsWith('.txt') || f.endsWith('.py')) &&
+        f !== 'README.md' &&
+        f !== 'agent.json' &&
+        !memoryFileNames.includes(f));
+    const hasMemoryDir = await fs_extra_1.default.pathExists(path_1.default.join(agentPath, memoryDirName));
+    const memoryFilesFound = files.filter(f => memoryFileNames.includes(f));
+    const hasMemory = hasMemoryDir || memoryFilesFound.length > 0;
+    if (contextFiles.length === 0 && !hasMemory) {
+        console.log(`Nenhum ficheiro de contexto ou memória encontrado para "${slug}".`);
         return;
     }
     const tempExportDir = path_1.default.join(basePath, `temp_export_${slug}`);
     const tempContextDir = path_1.default.join(tempExportDir, "context_files");
+    const tempMemoryDir = path_1.default.join(tempExportDir, "memory");
     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));
+        const sections = [];
+        if (contextFiles.length > 0) {
+            sections.push("context_files");
+            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));
+            }
+        }
+        if (hasMemory) {
+            sections.push("memory");
+            await fs_extra_1.default.ensureDir(tempMemoryDir);
+            // Copiar ficheiros de memória explícitos para a pasta memory no arquivo
+            for (const file of memoryFilesFound) {
+                await fs_extra_1.default.copy(path_1.default.join(agentPath, file), path_1.default.join(tempMemoryDir, file));
+            }
+            // Copiar conteúdo da pasta memory se existir
+            if (hasMemoryDir) {
+                await fs_extra_1.default.copy(path_1.default.join(agentPath, memoryDirName), tempMemoryDir);
+            }
         }
         await tar.c({
             gzip: true,
             file: tarPath,
             cwd: tempExportDir
-        }, ["context_files"]);
+        }, sections);
         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`;
+        const url = `${config.goclaw.api_url}/v1/agents/${agentId}/import?include=${sections.join(",")}`;
         await axios_1.default.post(url, form, {
             headers: {
                 ...form.getHeaders(),
@@ -371,7 +411,7 @@ async function deployContextFiles(slug, config) {
                 "X-GoClaw-User-Id": config.goclaw.username || "system"
             }
         });
-        console.log(`✅ Upload cirúrgico de ${contextFiles.length} arquivos concluído com sucesso!`);
+        console.log(`✅ Upload cirúrgico de ${contextFiles.length} ficheiros de contexto e ${hasMemory ? 'dados de memória' : 'sem memória'} concluído com sucesso!`);
     }
     finally {
         if (await fs_extra_1.default.pathExists(tempExportDir))
@@ -417,20 +457,8 @@ deployCmd
     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;
-            }
-        }
+        const agentId = await resolveAgentId(slug, config);
+        const exists = agentId !== null;
         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" }
@@ -438,13 +466,13 @@ deployCmd
             console.log("✅ Agente criado com sucesso.");
         }
         else {
-            await axios_1.default.put(`${config.goclaw.api_url}/v1/agents/${slug}`, agentConfig, {
+            await axios_1.default.put(`${config.goclaw.api_url}/v1/agents/${agentId}`, 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);
+        await deployContextFiles(slug, config, agentId);
         console.log("✅ Deploy completo concluído!");
     }
     catch (error) {
@@ -560,7 +588,7 @@ pullCmd
         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 url = `${config.goclaw.api_url}/v1/agents/${agent.id}/export?sections=config,context_files,memory`;
             const response = await axios_1.default.get(url, {
                 headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" },
                 responseType: "stream"
@@ -580,7 +608,7 @@ pullCmd
                     cwd: agentPath,
                     strip: 0,
                     filter: (path) => {
-                        return path === 'agent.json' || path.startsWith('context_files/');
+                        return path === 'agent.json' || path.startsWith('context_files/') || path.startsWith('memory/') || path === 'MEMORY.md' || path === 'memory.md';
                     }
                 });
                 const contextDir = path_1.default.join(agentPath, "context_files");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@innominatum/agentforge-cli",
-  "version": "1.0.1",
+  "version": "1.0.7",
   "description": "A powerful command-line interface to scaffold, manage, build, and deploy AI Agents and Skills for the GoClaw platform.",
   "main": "dist/index.js",
   "bin": {
@@ -16,6 +16,9 @@
     "type": "git",
     "url": "git+https://github.com/Innominatum-pt/agentforge-cli.git"
   },
+  "publishConfig": {
+    "access": "public"
+  },
   "keywords": [
     "ai",
     "agents",
@@ -49,4 +52,4 @@
     "tsx": "^4.21.0",
     "typescript": "^6.0.3"
   }
-}
+}

package/src/index.ts

@@ -297,6 +297,19 @@ async function getConfig() {
   return config;
 }
 
+async function resolveAgentId(slug: string, config: any): Promise<string | null> {
+  try {
+    const listResponse = await axios.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 || [];
+    const agent = agents.find((a: any) => a.agent_key === slug);
+    return agent ? agent.id : null;
+  } catch (error) {
+    return null;
+  }
+}
+
 const deployCmd = program
   .command("deploy")
   .description("Faz o deploy de entidades para a plataforma GoClaw");
@@ -354,7 +367,8 @@ deployCmd
     }
   });
 
-async function deployContextFiles(slug: string, config: any) {
+async function deployContextFiles(slug: string, config: any, resolvedId?: string | null) {
+  const agentId = resolvedId || (await resolveAgentId(slug, config)) || slug;
   const basePath = getWorkspaceRoot();
   const agentPath = path.join(basePath, "agents", slug);
   if (!(await fs.pathExists(agentPath))) {
@@ -362,33 +376,66 @@ async function deployContextFiles(slug: string, config: any) {
   }
 
   const files = await fs.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}".`);
+  
+  // Identificar ficheiros de contexto e de memória
+  const memoryFileNames = ['MEMORY.md', 'memory.md'];
+  const memoryDirName = 'memory';
+  
+  const contextFiles = files.filter(f => 
+    (f.endsWith('.md') || f.endsWith('.txt') || f.endsWith('.py')) && 
+    f !== 'README.md' && 
+    f !== 'agent.json' && 
+    !memoryFileNames.includes(f)
+  );
+  
+  const hasMemoryDir = await fs.pathExists(path.join(agentPath, memoryDirName));
+  const memoryFilesFound = files.filter(f => memoryFileNames.includes(f));
+  const hasMemory = hasMemoryDir || memoryFilesFound.length > 0;
+
+  if (contextFiles.length === 0 && !hasMemory) {
+    console.log(`Nenhum ficheiro de contexto ou memória encontrado para "${slug}".`);
     return;
   }
 
   const tempExportDir = path.join(basePath, `temp_export_${slug}`);
   const tempContextDir = path.join(tempExportDir, "context_files");
+  const tempMemoryDir = path.join(tempExportDir, "memory");
   const tarPath = path.join(basePath, `temp_export_${slug}.tar.gz`);
 
   try {
-    await fs.ensureDir(tempContextDir);
-    for (const file of contextFiles) {
-      await fs.copy(path.join(agentPath, file), path.join(tempContextDir, file));
+    const sections: string[] = [];
+    
+    if (contextFiles.length > 0) {
+      sections.push("context_files");
+      await fs.ensureDir(tempContextDir);
+      for (const file of contextFiles) {
+        await fs.copy(path.join(agentPath, file), path.join(tempContextDir, file));
+      }
+    }
+
+    if (hasMemory) {
+      sections.push("memory");
+      await fs.ensureDir(tempMemoryDir);
+      // Copiar ficheiros de memória explícitos para a pasta memory no arquivo
+      for (const file of memoryFilesFound) {
+        await fs.copy(path.join(agentPath, file), path.join(tempMemoryDir, file));
+      }
+      // Copiar conteúdo da pasta memory se existir
+      if (hasMemoryDir) {
+        await fs.copy(path.join(agentPath, memoryDirName), tempMemoryDir);
+      }
     }
 
     await tar.c({
       gzip: true,
       file: tarPath,
       cwd: tempExportDir
-    }, ["context_files"]);
+    }, sections);
 
     const form = new FormData();
     form.append("file", fs.createReadStream(tarPath));
 
-    const url = `${config.goclaw.api_url}/v1/agents/${slug}/import?include=context_files`;
+    const url = `${config.goclaw.api_url}/v1/agents/${agentId}/import?include=${sections.join(",")}`;
     await axios.post(url, form, {
       headers: {
         ...form.getHeaders(),
@@ -397,7 +444,7 @@ async function deployContextFiles(slug: string, config: any) {
       }
     });
 
-    console.log(`✅ Upload cirúrgico de ${contextFiles.length} arquivos concluído com sucesso!`);
+    console.log(`✅ Upload cirúrgico de ${contextFiles.length} ficheiros de contexto e ${hasMemory ? 'dados de memória' : 'sem memória'} concluído com sucesso!`);
   } finally {
     if (await fs.pathExists(tempExportDir)) await fs.remove(tempExportDir);
     if (await fs.pathExists(tarPath)) await fs.remove(tarPath);
@@ -446,18 +493,8 @@ deployCmd
     console.log(`🚀 Atualizando configuração do agente "${slug}"...`);
     
     try {
-      let exists = true;
-      try {
-         await axios.get(`${config.goclaw.api_url}/v1/agents/${slug}`, {
-           headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" }
-         });
-      } catch (e: any) {
-         if (e.response && e.response.status === 404) {
-           exists = false;
-         } else {
-           throw e;
-         }
-      }
+      const agentId = await resolveAgentId(slug, config);
+      const exists = agentId !== null;
 
       if (!exists) {
          await axios.post(`${config.goclaw.api_url}/v1/agents`, agentConfig, {
@@ -465,14 +502,14 @@ deployCmd
          });
          console.log("✅ Agente criado com sucesso.");
       } else {
-         await axios.put(`${config.goclaw.api_url}/v1/agents/${slug}`, agentConfig, {
+         await axios.put(`${config.goclaw.api_url}/v1/agents/${agentId}`, 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);
+      await deployContextFiles(slug, config, agentId);
 
       console.log("✅ Deploy completo concluído!");
     } catch (error: any) {
@@ -603,7 +640,7 @@ pullCmd
         const slug = agent.agent_key;
         console.log(`📦 Baixando agente: ${slug}...`);
         
-        const url = `${config.goclaw.api_url}/v1/agents/${agent.id}/export`;
+        const url = `${config.goclaw.api_url}/v1/agents/${agent.id}/export?sections=config,context_files,memory`;
         const response = await axios.get(url, {
           headers: { Authorization: `Bearer ${config.goclaw.token}`, "X-GoClaw-User-Id": config.goclaw.username || "system" },
           responseType: "stream"
@@ -628,7 +665,7 @@ pullCmd
             cwd: agentPath,
             strip: 0, 
             filter: (path) => {
-              return path === 'agent.json' || path.startsWith('context_files/');
+              return path === 'agent.json' || path.startsWith('context_files/') || path.startsWith('memory/') || path === 'MEMORY.md' || path === 'memory.md';
             }
           });