@innominatum/agentforge-cli 1.0.1 → 1.0.6

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,7 +349,8 @@ 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))) {
@@ -363,7 +377,7 @@ async function deployContextFiles(slug, config) {
         }, ["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`;
+        const url = `${config.goclaw.api_url}/v1/agents/${agentId}/import?include=context_files`;
         await axios_1.default.post(url, form, {
             headers: {
                 ...form.getHeaders(),
@@ -417,20 +431,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 +440,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) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@innominatum/agentforge-cli",
-  "version": "1.0.1",
+  "version": "1.0.6",
   "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))) {
@@ -388,7 +402,7 @@ async function deployContextFiles(slug: string, config: any) {
     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=context_files`;
     await axios.post(url, form, {
       headers: {
         ...form.getHeaders(),
@@ -446,18 +460,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 +469,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) {