ciscollm-cli 1.1.4 → 1.2.0

package/dist/core/agent/AutoHealer.js

@@ -0,0 +1,387 @@
+"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 });
+exports.AutoHealer = void 0;
+const TransactionManager_1 = require("../rollback/TransactionManager");
+const ui_1 = require("../../cli/ui/ui");
+const CommandFirewall_1 = require("../guardrails/CommandFirewall");
+const AuditLogger_1 = require("../guardrails/AuditLogger");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const chalk_1 = __importDefault(require("chalk"));
+class AutoHealer {
+    llmClient;
+    coordinator;
+    isRunning = false;
+    healingDevices = new Set();
+    logFilePath;
+    minConfidence;
+    nonInteractive;
+    firewall = new CommandFirewall_1.CommandFirewall();
+    triggerHistory = new Map();
+    blockedUntil = new Map();
+    constructor(llmClient, coordinator, options = {}) {
+        this.llmClient = llmClient;
+        this.coordinator = coordinator;
+        this.logFilePath = path.resolve(process.cwd(), options.logFile || 'healing-audit.log');
+        this.minConfidence = options.minConfidence ?? 0.80;
+        this.nonInteractive = options.nonInteractive ?? false;
+        if (this.nonInteractive) {
+            process.env.CISCOLLM_NON_INTERACTIVE = 'true';
+        }
+    }
+    start() {
+        if (this.isRunning)
+            return;
+        this.isRunning = true;
+        ui_1.logger.info(`AutoHealer started. Listening for syslog triggers: %LINK-3-UPDOWN, %LINEPROTO-5-UPDOWN, %OSPF-5-ADJCHG...`);
+        this.coordinator.on('notification', (msg, deviceId) => {
+            this.handleNotification(msg, deviceId).catch(err => {
+                ui_1.logger.error(`Error handling notification for device ${deviceId}: ${err.message}`);
+            });
+        });
+    }
+    stop() {
+        this.isRunning = false;
+        ui_1.logger.info(`AutoHealer stopped.`);
+    }
+    async handleNotification(msg, deviceId) {
+        const isTrigger = /%(LINK-3-UPDOWN|LINEPROTO-5-UPDOWN|OSPF-5-ADJCHG):/.test(msg);
+        if (!isTrigger)
+            return;
+        const now = Date.now();
+        const blockTime = this.blockedUntil.get(deviceId);
+        if (blockTime && now < blockTime) {
+            const minutesLeft = Math.ceil((blockTime - now) / 60000);
+            ui_1.logger.warn(`[AutoHealer Cooldown] Healing triggers for ${deviceId} are blocked for another ${minutesLeft} minute(s) due to rapid repetitive alerts.`);
+            this.logToAudit(`[BLOCKED-COOLDOWN] Device: ${deviceId} | Cooldown active for another ${minutesLeft} mins`);
+            return;
+        }
+        if (this.healingDevices.has(deviceId)) {
+            ui_1.logger.info(`[Telemetry Alert] Alert received for ${deviceId} but device is already undergoing healing.`);
+            return;
+        }
+        let history = this.triggerHistory.get(deviceId) || [];
+        history = history.filter(ts => now - ts < 600000);
+        history.push(now);
+        this.triggerHistory.set(deviceId, history);
+        if (history.length > 3) {
+            this.blockedUntil.set(deviceId, now + 900000);
+            ui_1.logger.error(`[AutoHealer Cooldown] CRITICAL: Device ${deviceId} triggered healing ${history.length} times in less than 10 minutes. Activating 15-minute cooldown to prevent remediation loop.`);
+            this.logToAudit(`[ACTIVATED-COOLDOWN] Device: ${deviceId} | Blocked for 15 mins due to repetitive triggers.`);
+            return;
+        }
+        this.healingDevices.add(deviceId);
+        ui_1.logger.heading(`Closed-Loop Healing Event Triggered on ${deviceId}`);
+        ui_1.logger.info(`Syslog Received: ${chalk_1.default.yellow(msg)}`);
+        this.logToAudit(`[TRIGGERED] Device: ${deviceId} | Syslog: ${msg}`);
+        const spinner = (0, ui_1.createSpinner)('OODA Loop: Initiating recovery sequence...').start();
+        try {
+            spinner.text = 'OODA Loop (Orient): Gathering diagnostic context...';
+            const context = await this.gatherContext(deviceId, msg);
+            spinner.info(`Diagnostic context gathered (${context.commandsRun.length} commands).`);
+            const decideSpinner = (0, ui_1.createSpinner)('OODA Loop (Decide): Querying AI for Root Cause & Remediation...').start();
+            const diagnosis = await this.diagnose(deviceId, msg, context.outputs);
+            decideSpinner.succeed('Root Cause Analysis completed.');
+            ui_1.logger.diamond(`AI Detected Issue: ${chalk_1.default.white.bold(diagnosis.detected_issue)}`);
+            ui_1.logger.diamond(`AI Root Cause: ${chalk_1.default.gray.italic(diagnosis.root_cause)}`);
+            ui_1.logger.diamond(`AI Confidence: ${chalk_1.default.cyan(diagnosis.confidence)}`);
+            ui_1.logger.diamond(`Remediation: ${chalk_1.default.green(diagnosis.remediation_commands.join(', '))}`);
+            ui_1.logger.diamond(`Verification: ${chalk_1.default.blue(diagnosis.verification_commands.join(', '))}`);
+            if (diagnosis.confidence < this.minConfidence) {
+                ui_1.logger.warn(`AI confidence (${diagnosis.confidence}) is below threshold (${this.minConfidence}). Skipping automatic healing.`);
+                this.logToAudit(`[SKIPPED] Device: ${deviceId} | Confidence too low: ${diagnosis.confidence}`);
+                this.healingDevices.delete(deviceId);
+                return;
+            }
+            if (!this.nonInteractive) {
+                ui_1.logger.warn('Interactive Mode: Human verification required to apply remediation.');
+                const rl = require('readline').createInterface({
+                    input: process.stdin,
+                    output: process.stdout
+                });
+                const approved = await new Promise((resolve) => {
+                    rl.question(chalk_1.default.yellow(`Apply remediation? (y/N): `), (answer) => {
+                        rl.close();
+                        resolve(answer.trim().toLowerCase() === 'y');
+                    });
+                });
+                if (!approved) {
+                    ui_1.logger.error('Remediation denied by human administrator.');
+                    this.logToAudit(`[DENIED] Device: ${deviceId} | Blocked by administrator.`);
+                    this.healingDevices.delete(deviceId);
+                    return;
+                }
+            }
+            const actSpinner = (0, ui_1.createSpinner)('OODA Loop (Act): Applying remediation commands...').start();
+            const session = this.coordinator.getSession(deviceId);
+            if (!session) {
+                throw new Error(`Device connection lost for ${deviceId}`);
+            }
+            const tx = new TransactionManager_1.TransactionManager();
+            await tx.initializeBackup(session);
+            let remediationSuccess = true;
+            let appliedCommands = [];
+            for (const cmd of diagnosis.remediation_commands) {
+                try {
+                    const firewallResult = this.firewall.checkCommand(cmd, null);
+                    if (firewallResult.dangerous) {
+                        const approved = await this.firewall.verifyWithHuman(cmd, firewallResult.reason || 'High-risk token');
+                        if (!approved) {
+                            AuditLogger_1.AuditLogger.log({
+                                timestamp: new Date().toISOString(),
+                                deviceId: deviceId,
+                                role: 'auto-healer',
+                                command: cmd,
+                                status: 'BLOCKED',
+                                reason: firewallResult.reason || 'Command denied by administrator.'
+                            });
+                            throw new Error(`Command "${cmd}" was blocked by CommandFirewall safety policy.`);
+                        }
+                    }
+                    actSpinner.text = `OODA Loop (Act): Executing command: "${cmd}"...`;
+                    tx.trackMutation(cmd);
+                    const out = await session.execute(cmd);
+                    const check = require('../guardrails/ErrorAnalyzer').ErrorAnalyzer.checkOutput(out);
+                    if (check.hasError) {
+                        throw new Error(`CLI Command error: ${check.errorType} - ${out}`);
+                    }
+                    appliedCommands.push(cmd);
+                    AuditLogger_1.AuditLogger.log({
+                        timestamp: new Date().toISOString(),
+                        deviceId: deviceId,
+                        role: 'auto-healer',
+                        command: cmd,
+                        status: 'SUCCESS',
+                        outputSnippet: out
+                    });
+                }
+                catch (e) {
+                    remediationSuccess = false;
+                    actSpinner.fail(`Failed to execute command: "${cmd}". Error: ${e.message}`);
+                    AuditLogger_1.AuditLogger.log({
+                        timestamp: new Date().toISOString(),
+                        deviceId: deviceId,
+                        role: 'auto-healer',
+                        command: cmd,
+                        status: 'FAILED',
+                        reason: e.message
+                    });
+                    break;
+                }
+            }
+            if (!remediationSuccess) {
+                actSpinner.text = 'Automated Rollback: Reverting partial config mutations...';
+                const rbLogs = await tx.executeRollback(session);
+                actSpinner.fail('Remediation failed. Automated rollback executed.');
+                this.logToAudit(`[FAILED-ACT] Device: ${deviceId} | Applied: ${appliedCommands.join(', ')} | Error during act. Rollback executed.`);
+                AuditLogger_1.AuditLogger.log({
+                    timestamp: new Date().toISOString(),
+                    deviceId: deviceId,
+                    role: 'auto-healer',
+                    command: 'automated_rollback',
+                    status: 'ROLLBACK',
+                    reason: 'Config recovery due to healing failure'
+                });
+                this.healingDevices.delete(deviceId);
+                return;
+            }
+            actSpinner.succeed('Remediation commands successfully applied.');
+            const verifySpinner = (0, ui_1.createSpinner)('OODA Loop (Verify): Executing verification checks...').start();
+            let verifyOutputs = '';
+            for (const cmd of diagnosis.verification_commands) {
+                try {
+                    verifySpinner.text = `OODA Loop (Verify): Executing verification: "${cmd}"...`;
+                    const out = await session.execute(cmd);
+                    verifyOutputs += `Command: "${cmd}"\nOutput:\n${out}\n\n`;
+                    AuditLogger_1.AuditLogger.log({
+                        timestamp: new Date().toISOString(),
+                        deviceId: deviceId,
+                        role: 'auto-healer',
+                        command: cmd,
+                        status: 'SUCCESS',
+                        outputSnippet: out
+                    });
+                }
+                catch (e) {
+                    verifyOutputs += `Command: "${cmd}" failed: ${e.message}\n\n`;
+                    AuditLogger_1.AuditLogger.log({
+                        timestamp: new Date().toISOString(),
+                        deviceId: deviceId,
+                        role: 'auto-healer',
+                        command: cmd,
+                        status: 'FAILED',
+                        reason: e.message
+                    });
+                }
+            }
+            const isHealed = await this.verifyFixWithLLM(deviceId, msg, diagnosis.detected_issue, verifyOutputs);
+            if (isHealed) {
+                verifySpinner.succeed('Verification PASSED: Device recovered successfully.');
+                this.logToAudit(`[SUCCESS] Device: ${deviceId} | Issue: ${diagnosis.detected_issue} | Remediation: ${appliedCommands.join(', ')}`);
+            }
+            else {
+                verifySpinner.fail('Verification FAILED: The issue is not fully resolved. Triggering rollback...');
+                const rbLogs = await tx.executeRollback(session);
+                verifySpinner.fail(`Rollback completed successfully.`);
+                this.logToAudit(`[FAILED-VERIFY] Device: ${deviceId} | Issue: ${diagnosis.detected_issue} | Verification failed. Rollback executed.`);
+                AuditLogger_1.AuditLogger.log({
+                    timestamp: new Date().toISOString(),
+                    deviceId: deviceId,
+                    role: 'auto-healer',
+                    command: 'automated_rollback',
+                    status: 'ROLLBACK',
+                    reason: 'Config recovery due to verification failure'
+                });
+            }
+        }
+        catch (e) {
+            spinner.fail(`Healing sequence failed: ${e.message}`);
+            this.logToAudit(`[ERROR] Device: ${deviceId} | Sequence failed: ${e.message}`);
+        }
+        finally {
+            this.healingDevices.delete(deviceId);
+        }
+    }
+    async gatherContext(deviceId, msg) {
+        const session = this.coordinator.getSession(deviceId);
+        if (!session) {
+            return { commandsRun: [], outputs: 'Connection not available.' };
+        }
+        const commands = [];
+        const ifMatch = /Interface\s+(\S+?)(?:,|\s+changed|$)/i.exec(msg);
+        const ifName = ifMatch ? ifMatch[1] : null;
+        commands.push('show ip interface brief');
+        if (ifName) {
+            commands.push(`show interface ${ifName}`);
+            commands.push(`show running-config interface ${ifName}`);
+        }
+        if (msg.includes('OSPF')) {
+            commands.push('show ip ospf neighbor');
+            commands.push('show ip ospf interface');
+        }
+        commands.push('show ip route');
+        let outputs = '';
+        for (const cmd of commands) {
+            try {
+                const res = await session.execute(cmd);
+                outputs += `========================================\nCOMMAND: ${cmd}\n========================================\n${res}\n\n`;
+            }
+            catch (err) {
+                outputs += `========================================\nCOMMAND: ${cmd}\n========================================\nFailed to run: ${err.message}\n\n`;
+            }
+        }
+        return { commandsRun: commands, outputs };
+    }
+    async diagnose(deviceId, syslog, context) {
+        const systemPrompt = `You are an expert Cisco network diagnostic AI agent operating in an AIOps closed-loop healing framework.
+Your task is to analyze the triggering syslog alert and the current state output of the device to:
+1. Identify the detected issue.
+2. Determine the root cause.
+3. Formulate the precise list of Cisco IOS configuration commands to remediate the issue (e.g. going into interface configuration mode if necessary, applying changes, ensuring no shutdown is run if the port was disabled).
+4. Formulate verification commands to check if the remediation succeeded.
+
+You MUST think step-by-step (Chain of Thought).
+Your response MUST end with a single, valid JSON block matching this schema:
+{
+  "detected_issue": "short description of issue",
+  "root_cause": "root cause description",
+  "confidence": 0.0 to 1.0,
+  "remediation_commands": ["list", "of", "commands"],
+  "verification_commands": ["list", "of", "commands"]
+}
+
+Ensure the configuration commands are completely accurate for Cisco IOS syntax. For instance, to modify an interface, you must include the "interface GigabitEthernet0/1" command first.`;
+        const userMsg = `Syslog Alert: "${syslog}"\n\nCollected Device Context:\n${context}`;
+        const messages = [
+            { role: 'system', content: systemPrompt },
+            { role: 'user', content: userMsg }
+        ];
+        const res = await this.llmClient.generateCompletion(messages);
+        const rawText = res.content || '';
+        const jsonMatch = /\{[\s\S]*\}/.exec(rawText);
+        if (!jsonMatch) {
+            throw new Error(`Failed to parse JSON from AI response: ${rawText}`);
+        }
+        try {
+            const parsed = JSON.parse(jsonMatch[0]);
+            if (!parsed.remediation_commands || !parsed.verification_commands) {
+                throw new Error(`Parsed JSON lacks required fields: ${jsonMatch[0]}`);
+            }
+            return {
+                detected_issue: parsed.detected_issue || 'Unknown',
+                root_cause: parsed.root_cause || 'Unknown',
+                confidence: typeof parsed.confidence === 'number' ? parsed.confidence : 0.5,
+                remediation_commands: parsed.remediation_commands || [],
+                verification_commands: parsed.verification_commands || []
+            };
+        }
+        catch (err) {
+            throw new Error(`JSON parse error of AI response: ${err.message}. Original block: ${jsonMatch[0]}`);
+        }
+    }
+    async verifyFixWithLLM(deviceId, syslog, issue, outputs) {
+        const systemPrompt = `You are a network verification validator. Analyze:
+1. The original syslog alert.
+2. The detected issue.
+3. The post-remediation verification command outputs.
+
+Determine if the issue has been successfully resolved (e.g. the line protocol changed to up/up, or routing neighbor state is now FULL).
+Your response MUST end with either "SUCCESS" or "FAILED". Do not output any other text after.`;
+        const userMsg = `Syslog Alert: "${syslog}"\nDetected Issue: "${issue}"\n\nPost-Remediation Verification Outputs:\n${outputs}`;
+        const messages = [
+            { role: 'system', content: systemPrompt },
+            { role: 'user', content: userMsg }
+        ];
+        const res = await this.llmClient.generateCompletion(messages);
+        const result = (res.content || '').trim().toUpperCase();
+        return result.includes('SUCCESS');
+    }
+    logToAudit(message) {
+        const timestamp = new Date().toISOString();
+        const formatted = `[${timestamp}] ${message}\n`;
+        try {
+            fs.appendFileSync(this.logFilePath, formatted, 'utf8');
+        }
+        catch (e) {
+            console.error(`Failed to write to healing audit log:`, e);
+        }
+    }
+}
+exports.AutoHealer = AutoHealer;
+//# sourceMappingURL=AutoHealer.js.map

package/dist/core/agent/AutoHealer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AutoHealer.js","sourceRoot":"","sources":["../../../src/core/agent/AutoHealer.ts"],"names":[],"mappings":"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"}

package/dist/core/agent/HierarchicalAgentManager.js

@@ -58,11 +58,11 @@ class HierarchicalAgentManager {
         return 'ACCESS';
     }
     static getHierarchicalAgentPrompt() {
-        return `You are operating as a Hierarchical Network Swarm. Tasks are segregated into three agent layers:
-- CORE AGENT (Core Routing, OSPF, BGP, Static Routes)
-- DISTRIBUTION AGENT (VLANs, ACLs, Security policies, NAT)
-- ACCESS AGENT (User ports, Interfaces, Speed/Duplex, IP Assignment)
-
+        return `You are operating as a Hierarchical Network Swarm. Tasks are segregated into three agent layers:
+- CORE AGENT (Core Routing, OSPF, BGP, Static Routes)
+- DISTRIBUTION AGENT (VLANs, ACLs, Security policies, NAT)
+- ACCESS AGENT (User ports, Interfaces, Speed/Duplex, IP Assignment)
+
 Always specify in your thoughts which agent layer is executing the command (e.g. "[AccessAgent] Modifying interface GigabitEthernet0/1").`;
     }
 }

package/dist/core/agent/MultiAgentCoordinator.d.ts

@@ -1,8 +1,10 @@
 import { BaseSession } from '../../infrastructure/protocols/BaseSession';
 import { NetworkTopology, SessionState } from '../../shared/types';
-export declare class MultiAgentCoordinator {
+import { EventEmitter } from 'events';
+export declare class MultiAgentCoordinator extends EventEmitter {
     private sessions;
     private topology;
+    constructor();
     registerSession(deviceId: string, session: BaseSession): void;
     connectAll(): Promise<void>;
     executeCommand(deviceId: string, command: string): Promise<string>;

package/dist/core/agent/MultiAgentCoordinator.js

@@ -6,15 +6,25 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.MultiAgentCoordinator = void 0;
 const TopologyDiscovery_1 = require("../topology/TopologyDiscovery");
 const chalk_1 = __importDefault(require("chalk"));
-class MultiAgentCoordinator {
+const events_1 = require("events");
+class MultiAgentCoordinator extends events_1.EventEmitter {
     sessions = new Map();
     topology = {
         discoveredAt: new Date(0).toISOString(),
         nodes: [],
         links: []
     };
+    constructor() {
+        super();
+    }
     registerSession(deviceId, session) {
+        session.deviceId = deviceId;
         this.sessions.set(deviceId, session);
+        if (typeof session.onNotification === 'function') {
+            session.onNotification((msg, devId) => {
+                this.emit('notification', msg, devId);
+            });
+        }
     }
     async connectAll() {
         console.log(chalk_1.default.cyan(`❯ Establishing parallel connections to ${this.sessions.size} target device(s)...`));

package/dist/core/agent/MultiAgentCoordinator.js.map

@@ -1 +1 @@
-{"version":3,"file":"MultiAgentCoordinator.js","sourceRoot":"","sources":["../../../src/core/agent/MultiAgentCoordinator.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"MultiAgentCoordinator.js","sourceRoot":"","sources":["../../../src/core/agent/MultiAgentCoordinator.ts"],"names":[],"mappings":"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"}

package/dist/core/agent/PromptEngine.js

@@ -3,73 +3,73 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PromptEngine = void 0;
 class PromptEngine {
     static getSystemPrompt(stateInfo, commandReferenceHints = 'Reference status: not loaded.', strictReferenceMode = false, topologyInfo = 'Topology not discovered yet.') {
-        return `You are a Senior Network Automation Engineer Agent executing operations on Cisco Enterprise Hardware (Switches & Routers).
-Your objective is to accomplish the user's network configuration and troubleshooting goals safely, using step-by-step tool calls.
-
-=========================================
-HIERARCHICAL NETWORK SWARM & RBAC:
-=========================================
-You operate as a Hierarchical Network Agent Swarm to focus execution and reduce context overhead:
-1. CORE AGENT: Manages core routing tables, dynamic routing protocols (OSPF, BGP, RIP), static routes, and IP SLAs.
-2. DISTRIBUTION AGENT: Manages VLAN databases, trunking protocols, authentication (AAA), ACL firewalls, and NAT mappings.
-3. ACCESS AGENT: Manages physical port assignments, speed/duplex, interface shut/no shut, port descriptions, and interface IPs.
-Specify which layer is performing the action in your thoughts (e.g., "[CORE AGENT] Configuring static route").
-Your actions are monitored by a Context-Aware Pre-Execution Validator and restricted by your current RBAC Role.
-
-=========================================
-CURRENT CONNECTED DEVICES & MODE CONTEXT:
-=========================================
-${stateInfo}
-
-=========================================
-CF COMMAND REFERENCE (cf_command_ref.pdf):
-=========================================
-The following hints were extracted from the official command reference and ranked for the current request. Prefer these exact command forms and syntax whenever relevant.
-Strict reference enforcement: ${strictReferenceMode ? 'ENABLED (unsupported commands will be blocked)' : 'DISABLED (advisory mode)'}
-${commandReferenceHints}
-
-=========================================
-DISCOVERED NETWORK TOPOLOGY MAP:
-=========================================
-${topologyInfo}
-Interpret the map as network-wide intent context. Prefer plans that keep end-to-end reachability and avoid asymmetric intermediate states.
-
-=========================================
-CISCO IOS SHELL (IOS.sh) AUTOMATION GUIDE:
-=========================================
-1. Capabilities: The connected Cisco devices support Cisco IOS Shell. You can utilize:
-   - Variables: E.g., "TARGET_IP=10.0.1.5", and reference them as "$TARGET_IP" in commands.
-   - Loop Constructs: E.g., "for i in 1 2; do ping 10.0.1.$i; done" to check connectivity.
-   - Piping & Output Filtering: E.g., "| include GigabitEthernet" or "| grep ip" to filter CLI outputs.
-   - Functions: E.g., "my_ping() { ping 10.0.1.1; }" to bind commands.
-2. Activation:
-   - Session-wide: Execute "terminal shell" in Privileged EXEC mode (Switch#).
-   - Global Config: Execute "shell processing full" in Global Configuration mode (Switch(config)#).
-   - Use the specialized tool "enable_ios_shell" to activate the shell instead of running raw activation commands.
-
-=========================================
-OPERATIONAL COMPLIANCE RULES:
-=========================================
-1. Navigational Awareness: Verify the current device access level (e.g., USER_EXEC ">", PRIVILEGED_EXEC "#", GLOBAL_CONFIG "(config)#", INTERFACE_CONFIG "(config-if)#"). Change modes appropriately before running commands (e.g., issue "enable", "configure terminal").
-2. Multi-Device Scope: When multiple target devices are connected, you must specify the "device" parameter in all tool calls to designate the destination.
-3. Chaining Constraint: Issue commands step-by-step. Do not combine multiple unrelated configuration actions into a single tool call.
-4. Validation Discipline: Use at most one inspection pass before a configuration block. Do not repeat show commands unless the device state changed or a command failed. After the configuration block completes, verify once with an inspection command or a ping_test, then stop if the verification is clean.
-5. Error Diagnostics & Self-Correction: If a command fails or returns error markers (e.g., "% Unrecognized command", "% Invalid input"), stop. Do not repeat failed commands. Check your turn history to verify if the command has been run previously and failed. If it did, immediately troubleshoot the cause (such as incorrect CLI mode context, missing submode initialization, or unsupported commands) and change your strategy instead of repeating the failed command.
-6. Language Policy: All reasoning blocks, arguments, tool calls, and output explanations must be written strictly in English.
-7. Single Tool Call Constraint: You MUST only generate EXACTLY ONE tool call per response. Never generate multiple parallel tool calls (e.g. do not call execute_ios_command multiple times in a single turn). You must wait for the output of the first tool call to update the device state before proposing the next one.
-8. Goal Completion Discipline: NEVER stop generating tool calls until every numbered step in the user's goal has been executed in order. Do not produce a summary or declare success while steps remain pending. Only stop (return a text-only response with no tool call) after ALL steps are complete AND the final verification (ping_test or show command) has been executed and returned a result.
-9. Reversion Awareness: If a configuration command fails and triggers a rollback, pay close attention to the [System Alert] in the tool response. Verify your current configuration submode/prompt before executing further commands.
-
-=========================================
-RESPONSE FORMAT PROTOCOL (CRITICAL):
-=========================================
-- You MUST always populate the "content" field of your response with a detailed, step-by-step Chain-of-Thought (CoT) reasoning block BEFORE proposing any tool calls.
-- You MUST format your thoughts by explicitly structuring them into these three sections:
-  1. CURRENT STATE ANALYSIS: [What is the current device status, context, and access level?]
-  2. TECHNICAL PLAN: [What is the detailed sequential plan, variables, loops, or shell configurations needed to achieve the goal?]
-  3. NEXT ACTION DETAILS: [What specific tool are you calling right now, what arguments/commands are you sending, and why?]
-- NEVER return an empty or whitespace-only "content" string when generating tool calls. The user must see your structured thoughts before execution occurs.
-- Do NOT use markdown bold formatting (e.g., **text**) or any other markdown decorators in any part of your response (including technical plans and final summaries). All responses must be clean, plain text.
+        return `You are a Senior Network Automation Engineer Agent executing operations on Cisco Enterprise Hardware (Switches & Routers).
+Your objective is to accomplish the user's network configuration and troubleshooting goals safely, using step-by-step tool calls.
+
+=========================================
+HIERARCHICAL NETWORK SWARM & RBAC:
+=========================================
+You operate as a Hierarchical Network Agent Swarm to focus execution and reduce context overhead:
+1. CORE AGENT: Manages core routing tables, dynamic routing protocols (OSPF, BGP, RIP), static routes, and IP SLAs.
+2. DISTRIBUTION AGENT: Manages VLAN databases, trunking protocols, authentication (AAA), ACL firewalls, and NAT mappings.
+3. ACCESS AGENT: Manages physical port assignments, speed/duplex, interface shut/no shut, port descriptions, and interface IPs.
+Specify which layer is performing the action in your thoughts (e.g., "[CORE AGENT] Configuring static route").
+Your actions are monitored by a Context-Aware Pre-Execution Validator and restricted by your current RBAC Role.
+
+=========================================
+CURRENT CONNECTED DEVICES & MODE CONTEXT:
+=========================================
+${stateInfo}
+
+=========================================
+CF COMMAND REFERENCE (cf_command_ref.pdf):
+=========================================
+The following hints were extracted from the official command reference and ranked for the current request. Prefer these exact command forms and syntax whenever relevant.
+Strict reference enforcement: ${strictReferenceMode ? 'ENABLED (unsupported commands will be blocked)' : 'DISABLED (advisory mode)'}
+${commandReferenceHints}
+
+=========================================
+DISCOVERED NETWORK TOPOLOGY MAP:
+=========================================
+${topologyInfo}
+Interpret the map as network-wide intent context. Prefer plans that keep end-to-end reachability and avoid asymmetric intermediate states.
+
+=========================================
+CISCO IOS SHELL (IOS.sh) AUTOMATION GUIDE:
+=========================================
+1. Capabilities: The connected Cisco devices support Cisco IOS Shell. You can utilize:
+   - Variables: E.g., "TARGET_IP=10.0.1.5", and reference them as "$TARGET_IP" in commands.
+   - Loop Constructs: E.g., "for i in 1 2; do ping 10.0.1.$i; done" to check connectivity.
+   - Piping & Output Filtering: E.g., "| include GigabitEthernet" or "| grep ip" to filter CLI outputs.
+   - Functions: E.g., "my_ping() { ping 10.0.1.1; }" to bind commands.
+2. Activation:
+   - Session-wide: Execute "terminal shell" in Privileged EXEC mode (Switch#).
+   - Global Config: Execute "shell processing full" in Global Configuration mode (Switch(config)#).
+   - Use the specialized tool "enable_ios_shell" to activate the shell instead of running raw activation commands.
+
+=========================================
+OPERATIONAL COMPLIANCE RULES:
+=========================================
+1. Navigational Awareness: Verify the current device access level (e.g., USER_EXEC ">", PRIVILEGED_EXEC "#", GLOBAL_CONFIG "(config)#", INTERFACE_CONFIG "(config-if)#"). Change modes appropriately before running commands (e.g., issue "enable", "configure terminal").
+2. Multi-Device Scope: When multiple target devices are connected, you must specify the "device" parameter in all tool calls to designate the destination.
+3. Chaining Constraint: Issue commands step-by-step. Do not combine multiple unrelated configuration actions into a single tool call.
+4. Validation Discipline: Use at most one inspection pass before a configuration block. Do not repeat show commands unless the device state changed or a command failed. After the configuration block completes, verify once with an inspection command or a ping_test, then stop if the verification is clean.
+5. Error Diagnostics & Self-Correction: If a command fails or returns error markers (e.g., "% Unrecognized command", "% Invalid input"), stop. Do not repeat failed commands. Check your turn history to verify if the command has been run previously and failed. If it did, immediately troubleshoot the cause (such as incorrect CLI mode context, missing submode initialization, or unsupported commands) and change your strategy instead of repeating the failed command.
+6. Language Policy: All reasoning blocks, arguments, tool calls, and output explanations must be written strictly in English.
+7. Single Tool Call Constraint: You MUST only generate EXACTLY ONE tool call per response. Never generate multiple parallel tool calls (e.g. do not call execute_ios_command multiple times in a single turn). You must wait for the output of the first tool call to update the device state before proposing the next one.
+8. Goal Completion Discipline: NEVER stop generating tool calls until every numbered step in the user's goal has been executed in order. Do not produce a summary or declare success while steps remain pending. Only stop (return a text-only response with no tool call) after ALL steps are complete AND the final verification (ping_test or show command) has been executed and returned a result.
+9. Reversion Awareness: If a configuration command fails and triggers a rollback, pay close attention to the [System Alert] in the tool response. Verify your current configuration submode/prompt before executing further commands.
+
+=========================================
+RESPONSE FORMAT PROTOCOL (CRITICAL):
+=========================================
+- You MUST always populate the "content" field of your response with a detailed, step-by-step Chain-of-Thought (CoT) reasoning block BEFORE proposing any tool calls.
+- You MUST format your thoughts by explicitly structuring them into these three sections:
+  1. CURRENT STATE ANALYSIS: [What is the current device status, context, and access level?]
+  2. TECHNICAL PLAN: [What is the detailed sequential plan, variables, loops, or shell configurations needed to achieve the goal?]
+  3. NEXT ACTION DETAILS: [What specific tool are you calling right now, what arguments/commands are you sending, and why?]
+- NEVER return an empty or whitespace-only "content" string when generating tool calls. The user must see your structured thoughts before execution occurs.
+- Do NOT use markdown bold formatting (e.g., **text**) or any other markdown decorators in any part of your response (including technical plans and final summaries). All responses must be clean, plain text.
 - When you are done and no additional tool call is required, your final response must be a direct user-facing outcome summary with concrete results and next actions (if any). Do not end with meta statements such as "I should" or "I will".`;
     }
 }