@n8n-as-code/n8nac 2026.4.0 → 2026.5.0-next.8

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @n8n-as-code/n8nac
 
+## [2026.4.1](https://github.com/EtienneLescot/n8n-as-code/compare/@n8n-as-code/n8nac@v2026.4.0...@n8n-as-code/n8nac@v2026.4.1) (2026-03-30)
+
+### Bug Fixes
+
+* make agent workflow testing and sync state resilient ([5850d07](https://github.com/EtienneLescot/n8n-as-code/commit/5850d07d8136ffb24c5106c7391b2d49d4dd2e5d))
+
 ## [2026.4.0](https://github.com/EtienneLescot/n8n-as-code/compare/@n8n-as-code/n8nac@v2026.3.1...@n8n-as-code/n8nac@v2026.4.0) (2026-03-17)
 
 ### Features

package/README.md

@@ -23,7 +23,7 @@ Restart the gateway, then run the setup wizard:
 openclaw n8nac:setup
 ```
 
-The wizard asks for your n8n host URL and API key once, saves them via
+The wizard asks for your n8n host URL and API key once, saves an instance config via
 `n8nac init-auth`, selects your project, and generates an AI context file
 (`AGENTS.md`) in the workspace (`~/.openclaw/n8nac/`).
 
@@ -63,7 +63,7 @@ All files live in `~/.openclaw/n8nac/`:
 
 ```
 ~/.openclaw/n8nac/
-  n8nac-config.json     ← project binding (written by n8nac init-project)
+  n8nac-config.json     ← saved instance configs + active selection
   AGENTS.md             ← AI context (written by n8nac update-ai)
   workflows/            ← .workflow.ts files (your n8n workflows)
 ```
@@ -119,7 +119,7 @@ openclaw n8nac:setup
 ```
 
 Enter your n8n host and API key when prompted. The wizard writes
-`~/.openclaw/n8nac/n8nac-config.json` and generates `AGENTS.md`.
+`~/.openclaw/n8nac/n8nac-config.json` with the saved instance configs and active selection, then generates `AGENTS.md`.
 
 ### 4. Iterate on the code
 
@@ -141,7 +141,7 @@ The plugin prefixes all `api.logger` calls with `[n8nac]`.
 
 ```
 ~/.openclaw/n8nac/
-  n8nac-config.json   ← written by init-project
+  n8nac-config.json   ← saved instance configs + active selection
   AGENTS.md           ← written by update-ai
   workflows/          ← .workflow.ts files
 ```

package/index.ts

@@ -1,9 +1,9 @@
-import { accessSync, constants, existsSync, mkdirSync, readFileSync } from "node:fs";
+import { accessSync, constants, mkdirSync } from "node:fs";
 import { join } from "node:path";
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 import { registerN8nAcCli } from "./src/cli.js";
 import { createN8nAcTool } from "./src/tool.js";
-import { getWorkspaceDir, isWorkspaceInitialized } from "./src/workspace.js";
+import { getWorkspaceDir, isWorkspaceInitialized, readWorkspaceBinding } from "./src/workspace.js";
 
 // ---------------------------------------------------------------------------
 // Lightweight prompt context
@@ -21,17 +21,8 @@ Once you have both, call the \`n8nac\` tool with \`action: "init_auth"\`, then
 \`action: "init_project"\` to finish setup.
 `;
 
-function readConfig(workspaceDir: string): Record<string, string> {
-  try {
-    const raw = readFileSync(join(workspaceDir, "n8nac-config.json"), "utf-8");
-    return JSON.parse(raw) as Record<string, string>;
-  } catch {
-    return {};
-  }
-}
-
 function buildStatusHeader(workspaceDir: string): string {
-  const cfg = readConfig(workspaceDir);
+  const cfg = readWorkspaceBinding(workspaceDir);
   const host = cfg.host ?? "(unknown)";
   const project = cfg.projectName ?? cfg.projectId ?? "(unknown)";
   return [
@@ -40,6 +31,7 @@ function buildStatusHeader(workspaceDir: string): string {
     "**The workspace is already fully initialized. Do NOT ask the user for credentials.**",
     "",
     `- Workspace directory: \`${workspaceDir}\``,
+    `- Active instance: \`${cfg.activeInstanceName ?? cfg.activeInstanceId ?? "(unknown)"}\``,
     `- n8n host: \`${host}\``,
     `- Active project: \`${project}\``,
   ].join("\n");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@n8n-as-code/n8nac",
-  "version": "2026.4.0",
+  "version": "2026.5.0-next.8",
   "description": "OpenClaw plugin for n8n-as-code — create and manage n8n workflows from OpenClaw",
   "keywords": [
     "n8n",
@@ -15,7 +15,7 @@
     "url": "git+https://github.com/EtienneLescot/n8n-as-code.git",
     "directory": "plugins/openclaw/n8n-as-code"
   },
-  "license": "Apache-2.0",
+  "license": "MIT",
   "type": "module",
   "scripts": {
     "build": "npm run typecheck",

package/skills/n8n-architect/SKILL.md

@@ -20,6 +20,10 @@ Use this skill only for explicit n8n workflow work.
 - Use `action: "skills"` whenever you need node search or schema details.
 - Never guess node parameters. The schema lookup is the source of truth.
 - Treat `AGENTS.md` as the authoritative workflow-engineering protocol once this skill is active.
+- When a workflow fails due to missing credentials (Class A), identify the missing credentials clearly and use the documented `n8nac` CLI commands from `AGENTS.md` (for example `npx --yes n8nac workflow credential-required <workflowId> --json`, `npx --yes n8nac credential schema <type>`, `npx --yes n8nac credential create --type <type> --name "<name>" --file cred.json --json`, and `npx --yes n8nac workflow activate <workflowId>`). Do not invent unsupported `n8nac` tool actions or CLI flags; use `--help` if you are unsure.
+- When `n8nac test` reports that a webhook is not registered, treat that as a runtime-state issue first, not as a workflow-code bug. For classic Webhook/Form triggers, the test URL usually requires a manual arm step in the n8n editor (`Execute workflow` or `Listen for test event`). There is no documented public API here to arm test webhooks automatically.
+- When a webhook call succeeds but the workflow still seems broken, inspect the resulting execution with the documented CLI commands from `AGENTS.md` (for example `npx --yes n8nac execution list --workflow-id <workflowId> --limit 5 --json` then `npx --yes n8nac execution get <executionId> --include-data --json`).
+- For GET/HEAD webhooks, prefer `n8nac test --query <json>` when the workflow reads from `$json.query`. Do not invent flags like `--query` unless they are documented in the current `--help`.
 
 ## Reading workflow files efficiently
 

package/src/workspace.ts

@@ -2,6 +2,15 @@ import { existsSync, readFileSync } from "node:fs";
 import { homedir } from "node:os";
 import { join } from "node:path";
 
+export type WorkspaceBinding = {
+  host?: string;
+  projectId?: string;
+  projectName?: string;
+  syncFolder?: string;
+  activeInstanceId?: string;
+  activeInstanceName?: string;
+};
+
 /**
  * Fixed workspace directory for V1.
  * All n8nac files (n8nac-config.json, AGENTS.md, workflows/) live here.
@@ -10,22 +19,63 @@ export function getWorkspaceDir(): string {
   return join(homedir(), ".openclaw", "n8nac");
 }
 
-/**
- * Returns true when n8nac has been initialized in the given directory,
- * meaning the config exists and contains a selected project + sync folder.
- */
-export function isWorkspaceInitialized(workspaceDir: string): boolean {
+function readString(value: unknown): string {
+  return typeof value === "string" ? value.trim() : "";
+}
+
+function resolveActiveInstance(config: Record<string, unknown>): Record<string, unknown> | undefined {
+  if (!Array.isArray(config.instances)) {
+    return undefined;
+  }
+
+  const instances = config.instances.filter((value): value is Record<string, unknown> => !!value && typeof value === "object");
+  if (!instances.length) {
+    return undefined;
+  }
+
+  const activeInstanceId = readString(config.activeInstanceId);
+  if (activeInstanceId) {
+    return instances.find((instance) => readString(instance.id) === activeInstanceId) || instances[0];
+  }
+
+  return instances[0];
+}
+
+export function readWorkspaceBinding(workspaceDir: string): WorkspaceBinding {
   const configPath = join(workspaceDir, "n8nac-config.json");
-  if (!existsSync(configPath)) return false;
+  if (!existsSync(configPath)) {
+    return {};
+  }
 
   try {
     const raw = readFileSync(configPath, "utf-8");
     const config = JSON.parse(raw) as Record<string, unknown>;
-    const projectId = typeof config.projectId === "string" ? config.projectId.trim() : "";
-    const projectName = typeof config.projectName === "string" ? config.projectName.trim() : "";
-    const syncFolder = typeof config.syncFolder === "string" ? config.syncFolder.trim() : "";
-    return projectId.length > 0 && projectName.length > 0 && syncFolder.length > 0;
+    const activeInstance = resolveActiveInstance(config);
+    const configActiveInstanceId = readString(config.activeInstanceId);
+    const resolvedActiveInstanceId = readString(activeInstance?.id);
+    const activeInstanceId =
+      resolvedActiveInstanceId && resolvedActiveInstanceId === configActiveInstanceId
+        ? configActiveInstanceId
+        : resolvedActiveInstanceId || undefined;
+
+    return {
+      host: readString(activeInstance?.host) || readString(config.host) || undefined,
+      projectId: readString(activeInstance?.projectId) || readString(config.projectId) || undefined,
+      projectName: readString(activeInstance?.projectName) || readString(config.projectName) || undefined,
+      syncFolder: readString(activeInstance?.syncFolder) || readString(config.syncFolder) || undefined,
+      activeInstanceId,
+      activeInstanceName: readString(activeInstance?.name) || undefined,
+    };
   } catch {
-    return false;
+    return {};
   }
 }
+
+/**
+ * Returns true when n8nac has been initialized in the given directory,
+ * meaning the config exists and contains a selected project + sync folder.
+ */
+export function isWorkspaceInitialized(workspaceDir: string): boolean {
+  const binding = readWorkspaceBinding(workspaceDir);
+  return Boolean(binding.projectId && binding.projectName && binding.syncFolder);
+}