@lhi/n8m 0.3.2 → 1.0.0

package/README.md

@@ -1,11 +1,19 @@
-# n8m: The Agentic CLI for n8n
+<div align="center">
+  <img src="n8m-cover.png" alt="n8m — agentic n8n workflow generator" width="100%" />
+</div>
 
 > Generate, modify, test, and deploy n8n workflows from the command line using
 > AI.
 
+[![npm](https://img.shields.io/npm/v/@lhi/n8m.svg)](https://www.npmjs.com/package/@lhi/n8m)
+[![npm downloads](https://img.shields.io/npm/dm/@lhi/n8m.svg)](https://www.npmjs.com/package/@lhi/n8m)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
 [![TypeScript](https://badgen.net/badge/Built%20with/TypeScript/blue)](https://typescriptlang.org/)
 [![oclif](https://badgen.net/badge/CLI/oclif/purple)](https://oclif.io/)
 [![n8n](https://badgen.net/badge/n8n/Compatible/orange)](https://n8n.io)
+[![Sponsor](https://img.shields.io/badge/Sponsor-%E2%9D%A4-pink?logo=github)](https://github.com/Lee-Holdings-International/n8m#sponsors)
+[![Discussions](https://img.shields.io/badge/Discussions-Join-blue?logo=github)](https://github.com/Lee-Holdings-International/n8m/discussions)
+[![Contributor Covenant](https://img.shields.io/badge/Contributor%20Covenant-2.1-4baaaa.svg)](CODE_OF_CONDUCT.md)
 
 **Stop clicking. Start shipping.** `n8m` is an open-source CLI that wraps your
 n8n instance with an agentic AI layer. Describe what you want in plain English —
@@ -46,8 +54,8 @@ npx n8m config --ai-provider gemini --ai-key AIza...
 npx n8m config --ai-base-url http://localhost:11434/v1 --ai-key ollama --ai-model llama3
 ```
 
-You can also use environment variables or a `.env` file — env vars take priority
-over stored config:
+You can also use environment variables or a `.env` file — stored config takes
+priority; env vars are used as fallback when no config file value is set:
 
 | Variable      | Description                                              |
 | ------------- | -------------------------------------------------------- |
@@ -281,6 +289,12 @@ n8m deploy ./workflows/my-flow.json
 
 # Activate the workflow immediately after deployment
 n8m deploy ./workflows/my-flow.json --activate
+
+# Non-interactive: always update the existing workflow (useful in CI)
+n8m deploy ./workflows/my-flow.json --update
+
+# Non-interactive: always create a new workflow, ignoring any existing ID
+n8m deploy ./workflows/my-flow.json --force-create
 ```
 
 ---
@@ -374,12 +388,18 @@ n8m mcp
 # → Starting n8m MCP Server...
 ```
 
-The server runs over stdio and registers two tools:
+The server runs over stdio and registers the following tools:
 
 | Tool | Description |
 |---|---|
 | `create_workflow` | Generate an n8n workflow from a natural-language goal |
+| `modify_workflow` | Modify an existing workflow JSON using natural language instructions |
 | `test_workflow` | Deploy a workflow ephemerally to n8n and validate it |
+| `deploy_workflow` | Create or update a workflow on the configured n8n instance |
+| `get_workflow` | Fetch a workflow from n8n by ID |
+| `list_workflows` | List all workflows on the n8n instance |
+| `delete_workflow` | Delete a workflow from n8n by ID |
+| `generate_docs` | Generate a Mermaid diagram and README for a workflow JSON |
 
 Add it to your MCP client config (e.g. Claude Desktop's `claude_desktop_config.json`):
 
@@ -503,7 +523,7 @@ Developer → n8m learn <workflow.json>
 ## Local Development
 
 ```bash
-git clone https://github.com/lcanady/n8m.git
+git clone https://github.com/Lee-Holdings-International/n8m.git
 cd n8m
 npm install
 
@@ -518,7 +538,25 @@ npm run dev
 
 ## Sponsors
 
-### Partially Sponsored By
+n8m is MIT-licensed and free forever. Sponsorship directly funds AI API costs,
+continued development, and the time it takes to keep up with n8n's rapidly
+evolving node ecosystem.
+
+### Sponsor tiers
+
+| Tier | Amount | What you get |
+|------|--------|--------------|
+| **Supporter** | $5 / mo | Name in the README sponsors list |
+| **Studio** | $25 / mo | Logo in the README + priority issue responses |
+| **Enterprise** | $100 / mo | Logo + a direct line for feature requests and integration questions |
+
+[Become a sponsor on Ko-fi](https://ko-fi.com/lcanady) · [GitHub Sponsors](https://github.com/sponsors/lcanady)
+
+---
+
+### Current Sponsors
+
+#### Partial Sponsors
 
 [The Daily Caller](https://dailycaller.com)
 
@@ -528,7 +566,7 @@ npm run dev
 
 ### Shipped
 
-- [x] Agentic graph (Architect → Engineer → QA)
+- [x] Agentic graph (Architect → Engineer → Supervisor → Reviewer → QA)
 - [x] SQLite session persistence
 - [x] HITL interrupts and resume
 - [x] Sub-workflow dependency resolution in tests
@@ -544,13 +582,15 @@ npm run dev
 - [x] Pattern library — extract & reuse knowledge from validated workflows (`n8m learn`)
 - [x] GitHub pattern archive import (`n8m learn --github owner/repo`)
 - [x] MCP server — expose n8m as tools for Claude Desktop and other MCP clients
+- [x] **`n8m rollback`** — restore a workflow to a previous git-tracked version with a single command
+- [x] **Credential awareness** — AI consults available credential types on the target instance so it stops generating nodes it can't authenticate
+- [x] **MCP server expanded to 8 tools** — full workflow lifecycle from any MCP client: create, modify, test, deploy, get, list, delete, generate docs
+- [x] **Non-interactive deploy flags** — `--update` and `--force-create` for CI/scripted use without interactive prompts
 
 ### Near-term
 
 - [ ] **`n8m watch`** — file-system watcher that auto-deploys on save with live reload in the n8n editor
-- [ ] **`n8m diff`** — human-readable structural diff between two versions of a workflow (nodes added/removed/changed)
-- [ ] **`n8m rollback`** — restore a workflow to a previous git-tracked version with a single command
-- [ ] **Credential awareness** — AI consults available credential types on the target instance so it stops generating nodes it can't authenticate
+- [ ] **`n8m diff`** — human-readable structural diff between two workflow versions (nodes added/removed/changed)
 - [ ] **Parallel test runs** — fire multiple fixture payloads concurrently and report aggregate pass/fail
 
 ### Medium-term

package/banner.txt

@@ -0,0 +1,9 @@
+
+$$\   $$\  $$$$$$\  $$\      $$\ 
+$$$\  $$ |$$  __$$\ $$$\    $$$ |
+$$$$\ $$ |$$ /  $$ |$$$$\  $$$$ |
+$$ $$\$$ | $$$$$$  |$$\$$\$$ $$ |
+$$ \$$$$ |$$  __$$< $$ \$$$  $$ |
+$$ |\$$$ |$$ /  $$ |$$ |\$  /$$ |
+$$ | \$$ |\$$$$$$  |$$ | \_/ $$ |
+\__|  \__| \______/ \__|     \__|

package/dist/agentic/graph.d.ts

@@ -9,6 +9,7 @@ export declare const graph: import("@langchain/langgraph").CompiledStateGraph<{
     validationStatus: "passed" | "failed";
     availableNodeTypes: string[];
     revisionCount: number;
+    availableCredentials: import("../utils/n8nClient.js").N8nCredential[];
     strategies: any[];
     candidates: any[];
     customTools: Record<string, string>;
@@ -26,6 +27,7 @@ export declare const graph: import("@langchain/langgraph").CompiledStateGraph<{
     validationStatus?: "passed" | "failed" | undefined;
     availableNodeTypes?: string[] | undefined;
     revisionCount?: number | undefined;
+    availableCredentials?: import("../utils/n8nClient.js").N8nCredential[] | undefined;
     strategies?: any[] | undefined;
     candidates?: any[] | undefined;
     customTools?: Record<string, string> | undefined;
@@ -75,6 +77,7 @@ export declare const graph: import("@langchain/langgraph").CompiledStateGraph<{
         (annotation: import("@langchain/langgraph").SingleReducer<number, number>): import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
         Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
     };
+    availableCredentials: import("@langchain/langgraph").BinaryOperatorAggregate<import("../utils/n8nClient.js").N8nCredential[], import("../utils/n8nClient.js").N8nCredential[]>;
     strategies: {
         (): import("@langchain/langgraph").LastValue<any[]>;
         (annotation: import("@langchain/langgraph").SingleReducer<any[], any[]>): import("@langchain/langgraph").BinaryOperatorAggregate<any[], any[]>;
@@ -136,6 +139,7 @@ export declare const graph: import("@langchain/langgraph").CompiledStateGraph<{
         (annotation: import("@langchain/langgraph").SingleReducer<number, number>): import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
         Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
     };
+    availableCredentials: import("@langchain/langgraph").BinaryOperatorAggregate<import("../utils/n8nClient.js").N8nCredential[], import("../utils/n8nClient.js").N8nCredential[]>;
     strategies: {
         (): import("@langchain/langgraph").LastValue<any[]>;
         (annotation: import("@langchain/langgraph").SingleReducer<any[], any[]>): import("@langchain/langgraph").BinaryOperatorAggregate<any[], any[]>;
@@ -252,6 +256,7 @@ export declare const graph: import("@langchain/langgraph").CompiledStateGraph<{
             (annotation: import("@langchain/langgraph").SingleReducer<number, number>): import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
             Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
         };
+        availableCredentials: import("@langchain/langgraph").BinaryOperatorAggregate<import("../utils/n8nClient.js").N8nCredential[], import("../utils/n8nClient.js").N8nCredential[]>;
         strategies: {
             (): import("@langchain/langgraph").LastValue<any[]>;
             (annotation: import("@langchain/langgraph").SingleReducer<any[], any[]>): import("@langchain/langgraph").BinaryOperatorAggregate<any[], any[]>;
@@ -321,6 +326,7 @@ export declare const graph: import("@langchain/langgraph").CompiledStateGraph<{
             (annotation: import("@langchain/langgraph").SingleReducer<number, number>): import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
             Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
         };
+        availableCredentials: import("@langchain/langgraph").BinaryOperatorAggregate<import("../utils/n8nClient.js").N8nCredential[], import("../utils/n8nClient.js").N8nCredential[]>;
         strategies: {
             (): import("@langchain/langgraph").LastValue<any[]>;
             (annotation: import("@langchain/langgraph").SingleReducer<any[], any[]>): import("@langchain/langgraph").BinaryOperatorAggregate<any[], any[]>;
@@ -390,6 +396,7 @@ export declare const runAgenticWorkflow: (goal: string, initialState?: Partial<t
         (annotation: import("@langchain/langgraph").SingleReducer<number, number>): import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
         Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
     };
+    availableCredentials: import("@langchain/langgraph").BinaryOperatorAggregate<import("../utils/n8nClient.js").N8nCredential[], import("../utils/n8nClient.js").N8nCredential[]>;
     strategies: {
         (): import("@langchain/langgraph").LastValue<any[]>;
         (annotation: import("@langchain/langgraph").SingleReducer<any[], any[]>): import("@langchain/langgraph").BinaryOperatorAggregate<any[], any[]>;
@@ -415,7 +422,7 @@ export declare const runAgenticWorkflow: (goal: string, initialState?: Partial<t
  * @param goal The user's goal string
  * @returns AsyncIterable for events
  */
-export declare const runAgenticWorkflowStream: (goal: string, threadId?: string) => Promise<import("@langchain/core/utils/stream").IterableReadableStream<{
+export declare const runAgenticWorkflowStream: (goal: string, threadId?: string, initialState?: Partial<typeof TeamState.State>) => Promise<import("@langchain/core/utils/stream").IterableReadableStream<{
     architect?: {
         spec: any;
         collaborationLog: string[];
@@ -512,6 +519,7 @@ export declare const runAgenticWorkflowStream: (goal: string, threadId?: string)
             (annotation: import("@langchain/langgraph").SingleReducer<number, number>): import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
             Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
         };
+        availableCredentials: import("@langchain/langgraph").BinaryOperatorAggregate<import("../utils/n8nClient.js").N8nCredential[], import("../utils/n8nClient.js").N8nCredential[]>;
         strategies: {
             (): import("@langchain/langgraph").LastValue<any[]>;
             (annotation: import("@langchain/langgraph").SingleReducer<any[], any[]>): import("@langchain/langgraph").BinaryOperatorAggregate<any[], any[]>;
@@ -581,6 +589,7 @@ export declare const runAgenticWorkflowStream: (goal: string, threadId?: string)
             (annotation: import("@langchain/langgraph").SingleReducer<number, number>): import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
             Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
         };
+        availableCredentials: import("@langchain/langgraph").BinaryOperatorAggregate<import("../utils/n8nClient.js").N8nCredential[], import("../utils/n8nClient.js").N8nCredential[]>;
         strategies: {
             (): import("@langchain/langgraph").LastValue<any[]>;
             (annotation: import("@langchain/langgraph").SingleReducer<any[], any[]>): import("@langchain/langgraph").BinaryOperatorAggregate<any[], any[]>;
@@ -647,6 +656,7 @@ export declare const resumeAgenticWorkflow: (threadId: string, input?: any) => P
         (annotation: import("@langchain/langgraph").SingleReducer<number, number>): import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
         Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
     };
+    availableCredentials: import("@langchain/langgraph").BinaryOperatorAggregate<import("../utils/n8nClient.js").N8nCredential[], import("../utils/n8nClient.js").N8nCredential[]>;
     strategies: {
         (): import("@langchain/langgraph").LastValue<any[]>;
         (annotation: import("@langchain/langgraph").SingleReducer<any[], any[]>): import("@langchain/langgraph").BinaryOperatorAggregate<any[], any[]>;

package/dist/agentic/graph.js

@@ -72,12 +72,13 @@ export const runAgenticWorkflow = async (goal, initialState = {}, threadId = "de
  * @param goal The user's goal string
  * @returns AsyncIterable for events
  */
-export const runAgenticWorkflowStream = async (goal, threadId = "default_session") => {
+export const runAgenticWorkflowStream = async (goal, threadId = "default_session", initialState = {}) => {
     return await graph.stream({
         userGoal: goal,
         messages: [],
         validationErrors: [],
         revisionCount: 0,
+        ...initialState,
     }, {
         configurable: { thread_id: threadId }
     });

package/dist/agentic/nodes/architect.js

@@ -17,13 +17,14 @@ export const architectNode = async (state) => {
         };
     }
     try {
-        const spec = await aiService.generateSpec(state.userGoal);
+        const credentials = state.availableCredentials ?? [];
+        const spec = await aiService.generateSpec(state.userGoal, credentials);
         // Check if the spec requires clarification
         const questions = spec.questions;
         const needsClarification = questions && questions.length > 0;
         // Multi-agent collaboration: generate an alternative strategy in parallel with the primary.
         // Both are handed off to separate Engineer agents that run concurrently.
-        const alternativeSpec = await aiService.generateAlternativeSpec(state.userGoal, spec);
+        const alternativeSpec = await aiService.generateAlternativeSpec(state.userGoal, spec, credentials);
         const alternativeModel = aiService.getAlternativeModel();
         const strategies = [
             {

package/dist/agentic/nodes/engineer.js

@@ -1,4 +1,4 @@
-import { AIService } from "../../services/ai.service.js";
+import { AIService, buildCredentialContext } from "../../services/ai.service.js";
 import { NodeDefinitionsService } from "../../services/node-definitions.service.js";
 import { jsonrepair } from "jsonrepair";
 import { theme } from "../../utils/theme.js";
@@ -75,13 +75,15 @@ export const engineerNode = async (state) => {
     if (!state.spec) {
         throw new Error("Workflow specification is missing.");
     }
+    const credentialContext = buildCredentialContext(state.availableCredentials ?? []);
     try {
         const prompt = `You are an n8n Workflow Engineer.
        Generate the valid n8n workflow JSON(s) based on the following approved Specification.
-       
+
        Specification:
        ${JSON.stringify(state.spec, null, 2)}
        ${ragContext}
+       ${credentialContext}
        ${state.userFeedback ? `\n\nUSER FEEDBACK / REFINEMENTS:\n${state.userFeedback}\n(Incorporate this feedback into the generation process)` : ""}
        
        IMPORTANT:

package/dist/agentic/state.d.ts

@@ -1,4 +1,5 @@
 import { BaseMessage } from "@langchain/core/messages";
+import type { N8nCredential } from '../utils/n8nClient.js';
 export declare const TeamState: import("@langchain/langgraph").AnnotationRoot<{
     userGoal: {
         (): import("@langchain/langgraph").LastValue<string>;
@@ -41,6 +42,7 @@ export declare const TeamState: import("@langchain/langgraph").AnnotationRoot<{
         (annotation: import("@langchain/langgraph").SingleReducer<number, number>): import("@langchain/langgraph").BinaryOperatorAggregate<number, number>;
         Root: <S extends import("@langchain/langgraph").StateDefinition>(sd: S) => import("@langchain/langgraph").AnnotationRoot<S>;
     };
+    availableCredentials: import("@langchain/langgraph").BinaryOperatorAggregate<N8nCredential[], N8nCredential[]>;
     strategies: {
         (): import("@langchain/langgraph").LastValue<any[]>;
         (annotation: import("@langchain/langgraph").SingleReducer<any[], any[]>): import("@langchain/langgraph").BinaryOperatorAggregate<any[], any[]>;

package/dist/agentic/state.js

@@ -12,6 +12,10 @@ export const TeamState = Annotation.Root({
     validationStatus: (Annotation),
     availableNodeTypes: (Annotation),
     revisionCount: (Annotation),
+    availableCredentials: Annotation({
+        value: (_x, y) => y ?? [],
+        default: () => [],
+    }),
     // Parallel Execution Support
     strategies: (Annotation),
     candidates: Annotation({

package/dist/commands/create.js

@@ -78,9 +78,23 @@ export default class Create extends Command {
         // 2. AGENTIC EXECUTION
         const threadId = randomUUID();
         this.log(theme.info(`\nInitializing Agentic Workflow for: "${description}" (Session: ${threadId})`));
+        // Fetch available credentials for AI guidance (gracefully skipped if n8n not configured)
+        let availableCredentials = [];
+        {
+            const preConfig = await ConfigManager.load();
+            const preUrl = process.env.N8N_API_URL || preConfig.n8nUrl;
+            const preKey = process.env.N8N_API_KEY || preConfig.n8nKey;
+            if (preUrl && preKey) {
+                const preClient = new N8nClient({ apiUrl: preUrl, apiKey: preKey });
+                availableCredentials = await preClient.getCredentials();
+                if (availableCredentials.length > 0) {
+                    this.log(theme.muted(`  Found ${availableCredentials.length} credential(s) on n8n instance — AI will use these for node selection.`));
+                }
+            }
+        }
         let lastWorkflowJson = null;
         try {
-            const stream = await runAgenticWorkflowStream(description, threadId);
+            const stream = await runAgenticWorkflowStream(description, threadId, { availableCredentials });
             for await (const event of stream) {
                 // event keys correspond to node names that just finished
                 const nodeName = Object.keys(event)[0];
@@ -184,7 +198,6 @@ export default class Create extends Command {
                             this.log(theme.header('\nCHATTING WITH THE ENGINEER'));
                             this.log(theme.muted(`  Plan: ${currentSpec?.suggestedName}`));
                             this.log(theme.muted(`  Type your question or request. Enter "done" when ready to build.\n`));
-                            // eslint-disable-next-line no-constant-condition
                             while (true) {
                                 const { message } = await inquirer.prompt([{
                                         type: 'input',

package/dist/commands/deploy.d.ts

@@ -9,6 +9,8 @@ export default class Deploy extends Command {
         instance: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         activate: import("@oclif/core/interfaces").BooleanFlag<boolean>;
         dir: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+        update: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        'force-create': import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/dist/commands/deploy.js

@@ -64,6 +64,14 @@ export default class Deploy extends Command {
             char: 'd',
             description: 'Directory to scan for workflows (default: ./workflows)',
         }),
+        update: Flags.boolean({
+            description: 'Update existing workflow without prompting (non-interactive)',
+            default: false,
+        }),
+        'force-create': Flags.boolean({
+            description: 'Always create as a new workflow, ignoring any existing ID (non-interactive)',
+            default: false,
+        }),
     };
     async run() {
         this.log(theme.brand());
@@ -126,14 +134,23 @@ export default class Deploy extends Command {
                     // not found — will create
                 }
                 if (existsRemotely) {
-                    const { default: select } = await import('@inquirer/select');
-                    const action = await select({
-                        message: `Workflow "${workflowData.name}" already exists in n8n (ID: ${workflowData.id}). What would you like to do?`,
-                        choices: [
-                            { name: 'Update existing workflow', value: 'update' },
-                            { name: 'Create as new workflow', value: 'create' },
-                        ],
-                    });
+                    let action;
+                    if (flags.update) {
+                        action = 'update';
+                    }
+                    else if (flags['force-create']) {
+                        action = 'create';
+                    }
+                    else {
+                        const { default: select } = await import('@inquirer/select');
+                        action = await select({
+                            message: `Workflow "${workflowData.name}" already exists in n8n (ID: ${workflowData.id}). What would you like to do?`,
+                            choices: [
+                                { name: 'Update existing workflow', value: 'update' },
+                                { name: 'Create as new workflow', value: 'create' },
+                            ],
+                        });
+                    }
                     if (action === 'update') {
                         await client.updateWorkflow(workflowData.id, workflowData);
                         deployedId = workflowData.id;

package/dist/commands/fixture.js

@@ -26,6 +26,7 @@ export default class Fixture extends Command {
         '<%= config.bin %> fixture capture abc123    # pull latest real execution for a specific workflow ID',
     ];
     async run() {
+        this.log(theme.brand());
         const { args } = await this.parse(Fixture);
         if (args.action === 'init') {
             await this.initFixture(args.workflowId);

package/dist/commands/learn.js

@@ -162,7 +162,7 @@ export default class Learn extends Command {
             return;
         }
         this.log(theme.info(`Found ${mdFiles.length} pattern(s).`));
-        const { checkbox } = await import('inquirer');
+        const { default: checkbox } = await import('@inquirer/checkbox');
         const selected = await checkbox({
             message: 'Select patterns to import:',
             choices: mdFiles.map(f => ({ name: f.path, value: f.path, checked: true })),

package/dist/commands/modify.js

@@ -55,6 +55,17 @@ export default class Modify extends Command {
         catch (e) {
             this.log(theme.warn(`⚠ Failed to fetch node types: ${e.message}`));
         }
+        // 1b. Fetch available credentials for AI guidance
+        let availableCredentials = [];
+        try {
+            availableCredentials = await client.getCredentials();
+            if (availableCredentials.length > 0) {
+                this.log(theme.muted(`  Found ${availableCredentials.length} credential(s) — AI will use these for node selection.`));
+            }
+        }
+        catch {
+            // Non-fatal — proceed without credential context
+        }
         // 2. Resolve Workflow
         let workflowData;
         let workflowName = 'Untitled';
@@ -152,7 +163,8 @@ export default class Modify extends Command {
             messages: [],
             validationErrors: [],
             workflowJson: workflowData,
-            availableNodeTypes: validNodeTypes
+            availableNodeTypes: validNodeTypes,
+            availableCredentials,
         };
         try {
             const stream = await graph.stream({

package/dist/commands/rollback.d.ts

@@ -0,0 +1,31 @@
+import { Command } from '@oclif/core';
+import type { GitCommit } from '../services/git.service.js';
+export interface RollbackChoice {
+    name: string;
+    value: string;
+}
+/**
+ * Build the interactive select choices from a list of git commits.
+ * The most-recent commit is labelled "(HEAD)" to make it easy to identify.
+ * Pure function — safe to unit test.
+ */
+export declare function buildRollbackChoices(commits: GitCommit[]): RollbackChoice[];
+/**
+ * Build a human-readable diff preview comparing the current on-disk version
+ * of a workflow against the version about to be restored.
+ * Pure function — safe to unit test.
+ */
+export declare function buildRollbackPreview(currentJson: any, targetJson: any): string;
+export default class Rollback extends Command {
+    static args: {
+        workflow: import("@oclif/core/interfaces").Arg<string | undefined, Record<string, unknown>>;
+    };
+    static description: string;
+    static examples: string[];
+    static flags: {
+        instance: import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
+        deploy: import("@oclif/core/interfaces").BooleanFlag<boolean>;
+        dir: import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
+    };
+    run(): Promise<void>;
+}