ciscollm-cli 1.0.1

package/dist/core/agent/CommandReferenceEngine.js

@@ -0,0 +1,366 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CommandReferenceEngine = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const pdf_parse_1 = require("pdf-parse");
+class CommandReferenceEngine {
+    static CACHE_VERSION = 1;
+    static CACHE_DIR = '.cache';
+    static CACHE_FILE = 'cf_command_ref.index.json';
+    static instance = null;
+    loaded = false;
+    loadError = null;
+    commands = [];
+    pdfPath = null;
+    strictMode = /^(1|true|yes|on)$/i.test(process.env.CISCOLLM_STRICT_COMMAND_REF || '');
+    lastWarmupTelemetry = {
+        source: 'error',
+        commandCount: 0,
+        durationMs: 0,
+        strictMode: this.strictMode,
+        cachePath: this.getCachePath(),
+        error: 'Reference warmup has not run yet.'
+    };
+    static getInstance() {
+        if (!CommandReferenceEngine.instance) {
+            CommandReferenceEngine.instance = new CommandReferenceEngine();
+        }
+        return CommandReferenceEngine.instance;
+    }
+    async warmup(pdfFileName = 'cf_command_ref.pdf') {
+        const startedAt = Date.now();
+        if (this.loaded) {
+            this.lastWarmupTelemetry = {
+                source: 'memory',
+                commandCount: this.commands.length,
+                durationMs: Date.now() - startedAt,
+                strictMode: this.strictMode,
+                cachePath: this.getCachePath(),
+                error: this.loadError || undefined
+            };
+            return;
+        }
+        const pdfPath = path_1.default.resolve(process.cwd(), pdfFileName);
+        this.pdfPath = pdfPath;
+        if (!fs_1.default.existsSync(pdfPath)) {
+            this.loadError = `Reference file not found: ${pdfPath}`;
+            this.loaded = true;
+            this.lastWarmupTelemetry = {
+                source: 'error',
+                commandCount: 0,
+                durationMs: Date.now() - startedAt,
+                strictMode: this.strictMode,
+                cachePath: this.getCachePath(),
+                error: this.loadError
+            };
+            return;
+        }
+        const stat = fs_1.default.statSync(pdfPath);
+        const cachePayload = this.loadCache(stat.mtimeMs, stat.size);
+        if (cachePayload) {
+            this.commands = cachePayload.commands;
+            this.loaded = true;
+            this.lastWarmupTelemetry = {
+                source: 'cache',
+                commandCount: this.commands.length,
+                durationMs: Date.now() - startedAt,
+                strictMode: this.strictMode,
+                cachePath: this.getCachePath(),
+                error: this.loadError || undefined
+            };
+            return;
+        }
+        const parser = new pdf_parse_1.PDFParse({ data: fs_1.default.readFileSync(pdfPath) });
+        try {
+            const result = await parser.getText();
+            this.commands = this.extractCommands(result.text || '');
+            if (!this.commands.length) {
+                this.loadError = 'No command candidates were extracted from cf_command_ref.pdf.';
+            }
+            else {
+                this.saveCache(stat.mtimeMs, stat.size, this.commands);
+            }
+        }
+        catch (err) {
+            this.loadError = `Failed to parse cf_command_ref.pdf: ${err.message}`;
+        }
+        finally {
+            await parser.destroy();
+            this.loaded = true;
+            this.lastWarmupTelemetry = {
+                source: this.loadError ? 'error' : 'pdf',
+                commandCount: this.commands.length,
+                durationMs: Date.now() - startedAt,
+                strictMode: this.strictMode,
+                cachePath: this.getCachePath(),
+                error: this.loadError || undefined
+            };
+        }
+    }
+    async getPromptHints(goal, limit = 12) {
+        await this.warmup();
+        if (this.loadError) {
+            return `Reference status: unavailable (${this.loadError}).`;
+        }
+        const matches = this.search(goal, limit);
+        if (!matches.length) {
+            return 'Reference status: loaded, but no close command matches found for this request.';
+        }
+        return matches
+            .map((m, idx) => `${idx + 1}. ${m.command}${m.context ? ` | context: ${m.context}` : ''}`)
+            .join('\n');
+    }
+    isStrictModeEnabled() {
+        return this.strictMode;
+    }
+    setStrictMode(enabled) {
+        this.strictMode = enabled;
+        this.lastWarmupTelemetry = {
+            ...this.lastWarmupTelemetry,
+            strictMode: enabled
+        };
+    }
+    getWarmupTelemetry() {
+        return this.lastWarmupTelemetry;
+    }
+    async validateCommand(command) {
+        await this.warmup();
+        const clean = command.trim();
+        if (!clean) {
+            return {
+                allowed: false,
+                reason: 'Command is empty.',
+                suggestions: []
+            };
+        }
+        if (!this.strictMode) {
+            return {
+                allowed: true,
+                reason: 'Strict command reference mode is disabled.',
+                suggestions: []
+            };
+        }
+        if (this.loadError) {
+            return {
+                allowed: false,
+                reason: `Strict mode is enabled but command reference is unavailable (${this.loadError}).`,
+                suggestions: []
+            };
+        }
+        const normalizedInput = this.normalizeCommand(clean);
+        const exact = this.commands.find(c => this.normalizeCommand(c.command) === normalizedInput);
+        if (exact) {
+            return {
+                allowed: true,
+                reason: 'Command matched reference exactly.',
+                suggestions: []
+            };
+        }
+        const best = this.search(clean, 5).map(c => c.command);
+        const allowedByPrefix = this.commands.some(c => this.isLikelySameCommandFamily(clean, c.command));
+        if (allowedByPrefix) {
+            return {
+                allowed: true,
+                reason: 'Command matched reference by command-family prefix.',
+                suggestions: best
+            };
+        }
+        return {
+            allowed: false,
+            reason: `Command "${clean}" was not found in cf_command_ref.pdf index.`,
+            suggestions: best
+        };
+    }
+    search(goal, limit) {
+        const tokens = this.tokenize(goal);
+        if (!tokens.length) {
+            return this.commands.slice(0, limit);
+        }
+        const scored = this.commands
+            .map(candidate => {
+            const haystack = `${candidate.command} ${candidate.context}`.toLowerCase();
+            let score = 0;
+            for (const token of tokens) {
+                if (candidate.command.toLowerCase().includes(token)) {
+                    score += 4;
+                }
+                if (haystack.includes(token)) {
+                    score += 1;
+                }
+            }
+            if (score === 0) {
+                return null;
+            }
+            score += Math.max(0, 6 - candidate.command.split(/\s+/).length) * 0.05;
+            return { candidate, score };
+        })
+            .filter((item) => !!item)
+            .sort((a, b) => b.score - a.score);
+        const unique = [];
+        const seen = new Set();
+        for (const item of scored) {
+            const key = item.candidate.command.toLowerCase();
+            if (!seen.has(key)) {
+                unique.push(item.candidate);
+                seen.add(key);
+            }
+            if (unique.length >= limit) {
+                break;
+            }
+        }
+        return unique;
+    }
+    normalizeCommand(command) {
+        return command
+            .toLowerCase()
+            .replace(/\s+/g, ' ')
+            .trim();
+    }
+    isLikelySameCommandFamily(input, reference) {
+        const inputTokens = this.normalizeCommand(input).split(' ');
+        const refTokens = this.normalizeCommand(reference).split(' ');
+        if (!inputTokens.length || !refTokens.length) {
+            return false;
+        }
+        const compareCount = Math.min(3, inputTokens.length, refTokens.length);
+        for (let i = 0; i < compareCount; i++) {
+            if (inputTokens[i] !== refTokens[i]) {
+                return false;
+            }
+        }
+        return true;
+    }
+    loadCache(pdfMtimeMs, pdfSize) {
+        try {
+            const cachePath = this.getCachePath();
+            if (!fs_1.default.existsSync(cachePath)) {
+                return null;
+            }
+            const raw = fs_1.default.readFileSync(cachePath, 'utf8');
+            const data = JSON.parse(raw);
+            if (data.version !== CommandReferenceEngine.CACHE_VERSION ||
+                data.pdfMtimeMs !== pdfMtimeMs ||
+                data.pdfSize !== pdfSize ||
+                !Array.isArray(data.commands)) {
+                return null;
+            }
+            return data;
+        }
+        catch {
+            return null;
+        }
+    }
+    saveCache(pdfMtimeMs, pdfSize, commands) {
+        try {
+            const cachePath = this.getCachePath();
+            const cacheDir = path_1.default.dirname(cachePath);
+            if (!fs_1.default.existsSync(cacheDir)) {
+                fs_1.default.mkdirSync(cacheDir, { recursive: true });
+            }
+            const payload = {
+                version: CommandReferenceEngine.CACHE_VERSION,
+                pdfMtimeMs,
+                pdfSize,
+                generatedAt: new Date().toISOString(),
+                commands
+            };
+            fs_1.default.writeFileSync(cachePath, JSON.stringify(payload, null, 2), 'utf8');
+        }
+        catch {
+        }
+    }
+    getCachePath() {
+        return path_1.default.resolve(process.cwd(), CommandReferenceEngine.CACHE_DIR, CommandReferenceEngine.CACHE_FILE);
+    }
+    tokenize(text) {
+        const stopWords = new Set([
+            'the', 'and', 'for', 'from', 'with', 'that', 'this', 'then', 'into',
+            'user', 'goal', 'please', 'need', 'want', 'configure', 'configuration',
+            'device', 'devices', 'switch', 'router', 'cisco', 'ios', 'show', 'set'
+        ]);
+        return text
+            .toLowerCase()
+            .split(/[^a-z0-9_\/-]+/)
+            .map(t => t.trim())
+            .filter(t => t.length >= 3 && !stopWords.has(t));
+    }
+    extractCommands(text) {
+        const lines = text
+            .split(/\r?\n/)
+            .map(line => line.trim())
+            .filter(Boolean);
+        const candidates = [];
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i];
+            if (!this.isCommandLine(line)) {
+                continue;
+            }
+            const contextParts = [];
+            for (let j = i + 1; j < Math.min(i + 4, lines.length); j++) {
+                const next = lines[j];
+                if (this.isStructuralNoise(next) || this.isCommandLine(next)) {
+                    break;
+                }
+                contextParts.push(next);
+            }
+            candidates.push({
+                command: line,
+                context: contextParts.join(' ').slice(0, 180)
+            });
+        }
+        const unique = new Map();
+        for (const candidate of candidates) {
+            const key = candidate.command.toLowerCase();
+            if (!unique.has(key)) {
+                unique.set(key, candidate);
+            }
+        }
+        return Array.from(unique.values());
+    }
+    isStructuralNoise(line) {
+        if (!line)
+            return true;
+        if (/^--\s*\d+\s+of\s+\d+\s*--$/i.test(line))
+            return true;
+        if (/^chapter\s+\d+/i.test(line))
+            return true;
+        if (/^cisco\s+ios\s+/i.test(line))
+            return true;
+        if (/^(table|figure)\s+\d+/i.test(line))
+            return true;
+        if (/^\d+\s*$/.test(line))
+            return true;
+        return false;
+    }
+    isCommandLine(line) {
+        if (this.isStructuralNoise(line)) {
+            return false;
+        }
+        if (line.length < 3 || line.length > 90) {
+            return false;
+        }
+        if (!/^[a-z][a-z0-9\-\s<>\[\]\{\}\/_\.,:()]*$/i.test(line)) {
+            return false;
+        }
+        if (/[A-Z]{4,}/.test(line)) {
+            return false;
+        }
+        if (/\b(the|this|that|when|where|example|configuration|command reference)\b/i.test(line)) {
+            return false;
+        }
+        if (/[.!?]$/.test(line)) {
+            return false;
+        }
+        const words = line.split(/\s+/);
+        if (words.length > 9) {
+            return false;
+        }
+        return true;
+    }
+}
+exports.CommandReferenceEngine = CommandReferenceEngine;
+//# sourceMappingURL=CommandReferenceEngine.js.map

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

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

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

@@ -0,0 +1,12 @@
+import { BaseSession } from '../../infrastructure/protocols/BaseSession';
+import { SessionState } from '../../shared/types';
+export declare class MultiAgentCoordinator {
+    private sessions;
+    registerSession(deviceId: string, session: BaseSession): void;
+    connectAll(): Promise<void>;
+    executeCommand(deviceId: string, command: string): Promise<string>;
+    getSessions(): Map<string, BaseSession>;
+    getSession(deviceId: string): BaseSession | undefined;
+    getAllStates(): Record<string, SessionState>;
+    disconnectAll(): Promise<void>;
+}

package/dist/core/agent/MultiAgentCoordinator.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MultiAgentCoordinator = void 0;
+class MultiAgentCoordinator {
+    sessions = new Map();
+    registerSession(deviceId, session) {
+        this.sessions.set(deviceId, session);
+    }
+    async connectAll() {
+        console.log(`[MultiAgentCoordinator]: Establishing connections to ${this.sessions.size} devices in parallel...`);
+        const promises = Array.from(this.sessions.entries()).map(async ([id, session]) => {
+            try {
+                await session.connect();
+                console.log(`[MultiAgentCoordinator]: Device "${id}" connected successfully.`);
+            }
+            catch (err) {
+                throw new Error(`Device "${id}" failed to connect: ${err.message}`);
+            }
+        });
+        await Promise.all(promises);
+    }
+    async executeCommand(deviceId, command) {
+        const session = this.sessions.get(deviceId);
+        if (!session) {
+            throw new Error(`Device "${deviceId}" is not registered in this coordinator session.`);
+        }
+        return await session.execute(command);
+    }
+    getSessions() {
+        return this.sessions;
+    }
+    getSession(deviceId) {
+        return this.sessions.get(deviceId);
+    }
+    getAllStates() {
+        const states = {};
+        for (const [id, session] of this.sessions.entries()) {
+            states[id] = session.getState();
+        }
+        return states;
+    }
+    async disconnectAll() {
+        console.log('[MultiAgentCoordinator]: Terminating all device connection channels...');
+        for (const [id, session] of this.sessions.entries()) {
+            try {
+                await session.disconnect();
+                console.log(`[MultiAgentCoordinator]: Device "${id}" disconnected cleanly.`);
+            }
+            catch (err) {
+                console.error(`[MultiAgentCoordinator Warning]: Device "${id}" failed to close cleanly: ${err.message}`);
+            }
+        }
+        this.sessions.clear();
+    }
+}
+exports.MultiAgentCoordinator = MultiAgentCoordinator;
+//# sourceMappingURL=MultiAgentCoordinator.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"MultiAgentCoordinator.js","sourceRoot":"","sources":["../../../src/core/agent/MultiAgentCoordinator.ts"],"names":[],"mappings":";;;AAGA,MAAa,qBAAqB;IACtB,QAAQ,GAA6B,IAAI,GAAG,EAAE,CAAC;IAEhD,eAAe,CAAC,QAAgB,EAAE,OAAoB;QACzD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC;IAEM,KAAK,CAAC,UAAU;QACnB,OAAO,CAAC,GAAG,CAAC,wDAAwD,IAAI,CAAC,QAAQ,CAAC,IAAI,yBAAyB,CAAC,CAAC;QACjH,MAAM,QAAQ,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE;YAC7E,IAAI,CAAC;gBACD,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;gBACxB,OAAO,CAAC,GAAG,CAAC,oCAAoC,EAAE,2BAA2B,CAAC,CAAC;YACnF,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAChB,MAAM,IAAI,KAAK,CAAC,WAAW,EAAE,wBAAwB,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YACxE,CAAC;QACL,CAAC,CAAC,CAAC;QACH,MAAM,OAAO,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IAEM,KAAK,CAAC,cAAc,CAAC,QAAgB,EAAE,OAAe;QACzD,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,MAAM,IAAI,KAAK,CAAC,WAAW,QAAQ,kDAAkD,CAAC,CAAC;QAC3F,CAAC;QACD,OAAO,MAAM,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAEM,WAAW;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAEM,UAAU,CAAC,QAAgB;QAC9B,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACvC,CAAC;IAEM,YAAY;QACf,MAAM,MAAM,GAAiC,EAAE,CAAC;QAChD,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YAClD,MAAM,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,QAAQ,EAAE,CAAC;QACpC,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC;IAEM,KAAK,CAAC,aAAa;QACtB,OAAO,CAAC,GAAG,CAAC,wEAAwE,CAAC,CAAC;QACtF,KAAK,MAAM,CAAC,EAAE,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;YAClD,IAAI,CAAC;gBACD,MAAM,OAAO,CAAC,UAAU,EAAE,CAAC;gBAC3B,OAAO,CAAC,GAAG,CAAC,oCAAoC,EAAE,yBAAyB,CAAC,CAAC;YACjF,CAAC;YAAC,OAAO,GAAQ,EAAE,CAAC;gBAChB,OAAO,CAAC,KAAK,CAAC,4CAA4C,EAAE,8BAA8B,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;YAC7G,CAAC;QACL,CAAC;QACD,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;IAC1B,CAAC;CACJ;AAxDD,sDAwDC"}

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

@@ -0,0 +1,3 @@
+export declare class PromptEngine {
+    static getSystemPrompt(stateInfo: string, commandReferenceHints?: string, strictReferenceMode?: boolean): string;
+}

package/dist/core/agent/PromptEngine.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PromptEngine = void 0;
+class PromptEngine {
+    static getSystemPrompt(stateInfo, commandReferenceHints = 'Reference status: not loaded.', strictReferenceMode = false) {
+        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.
+
+=========================================
+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}
+
+=========================================
+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 Requirement: Always verify any configuration changes immediately by calling "execute_ios_command" with inspection commands (e.g., "show running-config", "show ip interface brief") or by executing a "ping_test".
+5. Error Diagnostics: If a command fails or returns error markers (e.g., "% Unrecognized command", "% Invalid input"), stop. Do not repeat failed commands. Troubleshooting the cause (such as port state, interface context, or syntax) and correct it.
+6. Language Policy: All reasoning blocks, arguments, tool calls, and output explanations must be written strictly in English.
+
+=========================================
+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.
+- 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".`;
+    }
+}
+exports.PromptEngine = PromptEngine;
+//# sourceMappingURL=PromptEngine.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PromptEngine.js","sourceRoot":"","sources":["../../../src/core/agent/PromptEngine.ts"],"names":[],"mappings":";;;AAAA,MAAa,YAAY;IACf,MAAM,CAAC,eAAe,CACvB,SAAiB,EACjB,wBAAgC,+BAA+B,EAC/D,sBAA+B,KAAK;QAErC,OAAO;;;;;;EAMb,SAAS;;;;;;gCAMqB,mBAAmB,CAAC,CAAC,CAAC,gDAAgD,CAAC,CAAC,CAAC,0BAA0B;EACjI,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;+OAkCwN,CAAC;IAC5O,CAAC;CACJ;AAvDD,oCAuDC"}

package/dist/core/guardrails/CommandFirewall.d.ts

@@ -0,0 +1,10 @@
+export declare class CommandFirewall {
+    private protectedInterfaces;
+    constructor(protectedInterfaces?: string[]);
+    checkCommand(command: string, currentInterfaceContext: string | null): {
+        dangerous: boolean;
+        reason?: string;
+    };
+    private isProtected;
+    verifyWithHuman(command: string, reason: string): Promise<boolean>;
+}

package/dist/core/guardrails/CommandFirewall.js

@@ -0,0 +1,108 @@
+"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.CommandFirewall = void 0;
+const readline = __importStar(require("readline"));
+const chalk_1 = __importDefault(require("chalk"));
+const constants_1 = require("../../shared/constants");
+class CommandFirewall {
+    protectedInterfaces;
+    constructor(protectedInterfaces = constants_1.DEFAULT_PROTECTED_INTERFACES) {
+        this.protectedInterfaces = protectedInterfaces.map(i => i.toLowerCase().trim());
+    }
+    checkCommand(command, currentInterfaceContext) {
+        const normalized = command.toLowerCase().trim();
+        const matchedDestructive = constants_1.DESTRUCTIVE_TOKENS.find(token => normalized.startsWith(token) || normalized.includes(` ${token}`));
+        if (matchedDestructive) {
+            return {
+                dangerous: true,
+                reason: `Destructive keyword detected ("${matchedDestructive}")`
+            };
+        }
+        const interfaceMatch = /^interface\s+([A-Za-z0-9\/\.\-]+)/i.exec(command.trim());
+        if (interfaceMatch) {
+            const targetedInterface = interfaceMatch[1].toLowerCase().trim();
+            if (this.isProtected(targetedInterface) && normalized.includes('shutdown')) {
+                return {
+                    dangerous: true,
+                    reason: `Attempting to shutdown protected management interface: ${interfaceMatch[1]}`
+                };
+            }
+        }
+        if (currentInterfaceContext) {
+            const activeIntf = currentInterfaceContext.toLowerCase().trim();
+            if (this.isProtected(activeIntf)) {
+                if (normalized === 'shutdown') {
+                    return {
+                        dangerous: true,
+                        reason: `Cannot shutdown active protected management interface: ${currentInterfaceContext}`
+                    };
+                }
+                if (normalized.startsWith('no ip address') || normalized.startsWith('no ip add')) {
+                    return {
+                        dangerous: true,
+                        reason: `Cannot remove IP address configuration from protected interface: ${currentInterfaceContext}`
+                    };
+                }
+            }
+        }
+        return { dangerous: false };
+    }
+    isProtected(interfaceName) {
+        return this.protectedInterfaces.some(p => p === interfaceName ||
+            interfaceName.startsWith(p) ||
+            p.startsWith(interfaceName));
+    }
+    async verifyWithHuman(command, reason) {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        return new Promise((resolve) => {
+            console.warn('\n' + chalk_1.default.bold.red('⚠️  [GUARDRAIL WARNING]: High-Risk Command Blocked'));
+            console.warn(chalk_1.default.bold.red('============================================================'));
+            console.warn(`- The Agent requested to run: ${chalk_1.default.bold.yellow(`"${command}"`)}`);
+            console.warn(`- Protection Rule Match:      ${chalk_1.default.cyan(reason)}`);
+            console.warn(chalk_1.default.bold.red('============================================================'));
+            rl.question(chalk_1.default.bold.white('Do you want to authorize the execution of this command? (y/N): '), (answer) => {
+                rl.close();
+                console.log('');
+                resolve(answer.toLowerCase() === 'y');
+            });
+        });
+    }
+}
+exports.CommandFirewall = CommandFirewall;
+//# sourceMappingURL=CommandFirewall.js.map

package/dist/core/guardrails/CommandFirewall.js.map

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