ciscollm-cli 1.0.1

package/dist/infrastructure/llm/LLMClient.js

@@ -0,0 +1,94 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LLMClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const ToolDefinitions_1 = require("./ToolDefinitions");
+class LLMClient {
+    provider;
+    endpoint;
+    modelName;
+    apiKey;
+    constructor(provider = 'local', endpoint, modelName, apiKey) {
+        this.provider = provider;
+        this.apiKey = apiKey;
+        if (this.provider === 'cloud') {
+            this.endpoint = endpoint || 'https://openrouter.ai/api/v1';
+            this.modelName = modelName || 'nvidia/nemotron-3-super-120b-a12b:free';
+        }
+        else {
+            this.endpoint = endpoint || 'http://127.0.0.1:11434/v1';
+            this.modelName = modelName || 'qwen3.5-4b';
+        }
+    }
+    async generateCompletion(messages, tools = ToolDefinitions_1.CiscoAgentTools) {
+        try {
+            const url = `${this.endpoint.replace(/\/$/, '')}/chat/completions`;
+            const headers = {
+                'Content-Type': 'application/json'
+            };
+            if (this.provider === 'cloud') {
+                const key = this.apiKey || process.env.OPENROUTER_API_KEY;
+                if (!key) {
+                    throw new Error('API key is required for cloud provider. Set OPENROUTER_API_KEY environment variable or pass --api-key.');
+                }
+                headers['Authorization'] = `Bearer ${key}`;
+                headers['HTTP-Referer'] = 'https://github.com/ThemeHackers/LearnSync';
+                headers['X-Title'] = 'ciscollm-cli';
+            }
+            const response = await axios_1.default.post(url, {
+                model: this.modelName,
+                messages: messages,
+                tools: tools,
+                tool_choice: 'auto',
+                temperature: 0.1
+            }, { headers });
+            return response.data.choices[0].message;
+        }
+        catch (error) {
+            let details = error.message;
+            if (error.response && error.response.data) {
+                details = typeof error.response.data === 'string'
+                    ? error.response.data
+                    : JSON.stringify(error.response.data);
+            }
+            throw new Error(`LLM Client Error [${this.provider}]: ${details}`);
+        }
+    }
+    async ensureReachable(timeoutMs = 3500) {
+        const base = this.endpoint.replace(/\/$/, '');
+        const probeUrls = [];
+        probeUrls.push(`${base}/models`);
+        if (this.provider === 'local') {
+            const withoutV1 = base.replace(/\/v1$/i, '');
+            if (withoutV1 !== base) {
+                probeUrls.push(`${withoutV1}/api/tags`);
+            }
+        }
+        const errors = [];
+        for (const url of probeUrls) {
+            try {
+                const response = await axios_1.default.get(url, { timeout: timeoutMs });
+                if (response.status >= 200 && response.status < 500) {
+                    return;
+                }
+                errors.push(`${url} -> HTTP ${response.status}`);
+            }
+            catch (err) {
+                errors.push(`${url} -> ${err.message}`);
+            }
+        }
+        const guidance = this.provider === 'local'
+            ? [
+                'For Ollama: run "ollama serve" and ensure your model is pulled (e.g., "ollama pull qwen3.5:4b").',
+                'For LM Studio: start the local server and use --local-type lmstudio --endpoint http://127.0.0.1:1234/v1.'
+            ].join(' ')
+            : 'Check endpoint URL, API key, network, and provider availability.';
+        throw new Error(`LLM endpoint preflight failed for [${this.provider}] at "${this.endpoint}". ` +
+            `Probes: ${errors.join(' | ')}. ${guidance}`);
+    }
+}
+exports.LLMClient = LLMClient;
+//# sourceMappingURL=LLMClient.js.map

package/dist/infrastructure/llm/LLMClient.js.map

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

package/dist/infrastructure/llm/LocalLLMClient.d.ts

@@ -0,0 +1,7 @@
+import { ChatMessage } from '../../shared/types';
+export declare class LocalLLMClient {
+    private endpoint;
+    private modelName;
+    constructor(endpoint?: string, modelName?: string);
+    generateCompletion(messages: ChatMessage[]): Promise<ChatMessage>;
+}

package/dist/infrastructure/llm/LocalLLMClient.js

@@ -0,0 +1,39 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalLLMClient = void 0;
+const axios_1 = __importDefault(require("axios"));
+const ToolDefinitions_1 = require("./ToolDefinitions");
+class LocalLLMClient {
+    endpoint;
+    modelName;
+    constructor(endpoint = 'http://127.0.0.1:11434/v1', modelName = 'llama3:8b') {
+        this.endpoint = endpoint;
+        this.modelName = modelName;
+    }
+    async generateCompletion(messages) {
+        try {
+            const response = await axios_1.default.post(`${this.endpoint}/chat/completions`, {
+                model: this.modelName,
+                messages: messages,
+                tools: ToolDefinitions_1.CiscoAgentTools,
+                tool_choice: 'auto',
+                temperature: 0.1 // Kept low to enforce analytical consistency
+            });
+            return response.data.choices[0].message;
+        }
+        catch (error) {
+            let details = error.message;
+            if (error.response && error.response.data) {
+                details = typeof error.response.data === 'string'
+                    ? error.response.data
+                    : JSON.stringify(error.response.data);
+            }
+            throw new Error(`LLM Service Error: ${details}`);
+        }
+    }
+}
+exports.LocalLLMClient = LocalLLMClient;
+//# sourceMappingURL=LocalLLMClient.js.map

package/dist/infrastructure/llm/LocalLLMClient.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"LocalLLMClient.js","sourceRoot":"","sources":["../../../src/infrastructure/llm/LocalLLMClient.ts"],"names":[],"mappings":";;;;;;AAAA,kDAA0B;AAC1B,uDAAoD;AAGpD,MAAa,cAAc;IACf,QAAQ,CAAS;IACjB,SAAS,CAAS;IAE1B,YAAY,QAAQ,GAAG,2BAA2B,EAAE,SAAS,GAAG,WAAW;QACvE,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC/B,CAAC;IAEM,KAAK,CAAC,kBAAkB,CAAC,QAAuB;QACnD,IAAI,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,eAAK,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,QAAQ,mBAAmB,EAAE;gBACnE,KAAK,EAAE,IAAI,CAAC,SAAS;gBACrB,QAAQ,EAAE,QAAQ;gBAClB,KAAK,EAAE,iCAAe;gBACtB,WAAW,EAAE,MAAM;gBACnB,WAAW,EAAE,GAAG,CAAC,6CAA6C;aACjE,CAAC,CAAC;YAEH,OAAO,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,IAAI,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC;YAC5B,IAAI,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACxC,OAAO,GAAG,OAAO,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,QAAQ;oBAC7C,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI;oBACrB,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC9C,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,sBAAsB,OAAO,EAAE,CAAC,CAAC;QACrD,CAAC;IACL,CAAC;CACJ;AA9BD,wCA8BC"}

package/dist/infrastructure/llm/ToolDefinitions.d.ts

@@ -0,0 +1,179 @@
+export declare const CiscoAgentTools: ({
+    type: string;
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties: {
+                command: {
+                    type: string;
+                    description: string;
+                };
+                device: {
+                    type: string;
+                    description: string;
+                };
+                destination?: undefined;
+                mode?: undefined;
+                name?: undefined;
+                value?: undefined;
+                variable?: undefined;
+                items?: undefined;
+                body?: undefined;
+            };
+            required: string[];
+        };
+    };
+} | {
+    type: string;
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties: {
+                destination: {
+                    type: string;
+                    description: string;
+                };
+                device: {
+                    type: string;
+                    description: string;
+                };
+                command?: undefined;
+                mode?: undefined;
+                name?: undefined;
+                value?: undefined;
+                variable?: undefined;
+                items?: undefined;
+                body?: undefined;
+            };
+            required: string[];
+        };
+    };
+} | {
+    type: string;
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties: {
+                mode: {
+                    type: string;
+                    enum: string[];
+                    description: string;
+                };
+                device: {
+                    type: string;
+                    description: string;
+                };
+                command?: undefined;
+                destination?: undefined;
+                name?: undefined;
+                value?: undefined;
+                variable?: undefined;
+                items?: undefined;
+                body?: undefined;
+            };
+            required: string[];
+        };
+    };
+} | {
+    type: string;
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties: {
+                name: {
+                    type: string;
+                    description: string;
+                };
+                value: {
+                    type: string;
+                    description: string;
+                };
+                device: {
+                    type: string;
+                    description: string;
+                };
+                command?: undefined;
+                destination?: undefined;
+                mode?: undefined;
+                variable?: undefined;
+                items?: undefined;
+                body?: undefined;
+            };
+            required: string[];
+        };
+    };
+} | {
+    type: string;
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties: {
+                variable: {
+                    type: string;
+                    description: string;
+                };
+                items: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                    description: string;
+                };
+                command: {
+                    type: string;
+                    description: string;
+                };
+                device: {
+                    type: string;
+                    description: string;
+                };
+                destination?: undefined;
+                mode?: undefined;
+                name?: undefined;
+                value?: undefined;
+                body?: undefined;
+            };
+            required: string[];
+        };
+    };
+} | {
+    type: string;
+    function: {
+        name: string;
+        description: string;
+        parameters: {
+            type: string;
+            properties: {
+                name: {
+                    type: string;
+                    description: string;
+                };
+                body: {
+                    type: string;
+                    description: string;
+                };
+                device: {
+                    type: string;
+                    description: string;
+                };
+                command?: undefined;
+                destination?: undefined;
+                mode?: undefined;
+                value?: undefined;
+                variable?: undefined;
+                items?: undefined;
+            };
+            required: string[];
+        };
+    };
+})[];

package/dist/infrastructure/llm/ToolDefinitions.js

@@ -0,0 +1,150 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CiscoAgentTools = void 0;
+exports.CiscoAgentTools = [
+    {
+        type: 'function',
+        function: {
+            name: 'execute_ios_command',
+            description: 'Executes a single raw Cisco IOS command onto a target device and returns raw terminal output.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    command: {
+                        type: 'string',
+                        description: 'Cisco IOS command string (e.g., "show ip interface brief", "vlan 10"). Do not chain commands.'
+                    },
+                    device: {
+                        type: 'string',
+                        description: 'Optional. The target device identifier (e.g., "COM3", "COM4"). Required if multiple devices are connected.'
+                    }
+                },
+                required: ['command']
+            }
+        }
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'ping_test',
+            description: 'Executes a network ping test from the local host or from a target Cisco device to verify connection to a destination IP.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    destination: {
+                        type: 'string',
+                        description: 'The target IP address to ping (e.g. "192.168.1.1").'
+                    },
+                    device: {
+                        type: 'string',
+                        description: 'Optional. The source device identifier (e.g., "COM3") to perform ping from. If omitted, executes ping from the local host.'
+                    }
+                },
+                required: ['destination']
+            }
+        }
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'enable_ios_shell',
+            description: 'Enables Cisco IOS Shell (IOS.sh) globally or for the current terminal session.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    mode: {
+                        type: 'string',
+                        enum: ['global', 'session'],
+                        description: 'Method to enable shell processing. "global" configures full processing globally, "session" enables it for the current terminal only.'
+                    },
+                    device: {
+                        type: 'string',
+                        description: 'Optional. The target device identifier (e.g., "COM3").'
+                    }
+                },
+                required: ['mode']
+            }
+        }
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'define_shell_variable',
+            description: 'Binds a value to a Cisco IOS Shell environment variable.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    name: {
+                        type: 'string',
+                        description: 'The variable identifier name (e.g., "IP_TARGET").'
+                    },
+                    value: {
+                        type: 'string',
+                        description: 'The value to associate with the variable (e.g., "10.0.1.1").'
+                    },
+                    device: {
+                        type: 'string',
+                        description: 'Optional. The target device identifier (e.g., "COM3").'
+                    }
+                },
+                required: ['name', 'value']
+            }
+        }
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'execute_shell_loop',
+            description: 'Runs a command loop over a list of items using Cisco IOS Shell syntax.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    variable: {
+                        type: 'string',
+                        description: 'The loop variable name (e.g., "i").'
+                    },
+                    items: {
+                        type: 'array',
+                        items: { type: 'string' },
+                        description: 'The list of items to iterate over.'
+                    },
+                    command: {
+                        type: 'string',
+                        description: 'The Cisco command to execute inside the loop body, using the variable (e.g., "ping 10.0.1.$i").'
+                    },
+                    device: {
+                        type: 'string',
+                        description: 'Optional. The target device identifier (e.g., "COM3").'
+                    }
+                },
+                required: ['variable', 'items', 'command']
+            }
+        }
+    },
+    {
+        type: 'function',
+        function: {
+            name: 'define_shell_function',
+            description: 'Creates a custom user-defined function in Cisco IOS Shell.',
+            parameters: {
+                type: 'object',
+                properties: {
+                    name: {
+                        type: 'string',
+                        description: 'The name of the function (e.g., "run_pings").'
+                    },
+                    body: {
+                        type: 'string',
+                        description: 'The command body of the function (e.g., "ping 10.0.1.1").'
+                    },
+                    device: {
+                        type: 'string',
+                        description: 'Optional. The target device identifier (e.g., "COM3").'
+                    }
+                },
+                required: ['name', 'body']
+            }
+        }
+    }
+];
+//# sourceMappingURL=ToolDefinitions.js.map

package/dist/infrastructure/llm/ToolDefinitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ToolDefinitions.js","sourceRoot":"","sources":["../../../src/infrastructure/llm/ToolDefinitions.ts"],"names":[],"mappings":";;;AAAa,QAAA,eAAe,GAAG;IAC3B;QACI,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACN,IAAI,EAAE,qBAAqB;YAC3B,WAAW,EAAE,+FAA+F;YAC5G,UAAU,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACR,OAAO,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,+FAA+F;qBAC/G;oBACD,MAAM,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,4GAA4G;qBAC5H;iBACJ;gBACD,QAAQ,EAAE,CAAC,SAAS,CAAC;aACxB;SACJ;KACJ;IACD;QACI,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACN,IAAI,EAAE,WAAW;YACjB,WAAW,EAAE,0HAA0H;YACvI,UAAU,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACR,WAAW,EAAE;wBACT,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,qDAAqD;qBACrE;oBACD,MAAM,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,4HAA4H;qBAC5I;iBACJ;gBACD,QAAQ,EAAE,CAAC,aAAa,CAAC;aAC5B;SACJ;KACJ;IACD;QACI,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACN,IAAI,EAAE,kBAAkB;YACxB,WAAW,EAAE,gFAAgF;YAC7F,UAAU,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACR,IAAI,EAAE;wBACF,IAAI,EAAE,QAAQ;wBACd,IAAI,EAAE,CAAC,QAAQ,EAAE,SAAS,CAAC;wBAC3B,WAAW,EAAE,sIAAsI;qBACtJ;oBACD,MAAM,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,wDAAwD;qBACxE;iBACJ;gBACD,QAAQ,EAAE,CAAC,MAAM,CAAC;aACrB;SACJ;KACJ;IACD;QACI,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACN,IAAI,EAAE,uBAAuB;YAC7B,WAAW,EAAE,0DAA0D;YACvE,UAAU,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACR,IAAI,EAAE;wBACF,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,mDAAmD;qBACnE;oBACD,KAAK,EAAE;wBACH,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,8DAA8D;qBAC9E;oBACD,MAAM,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,wDAAwD;qBACxE;iBACJ;gBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,OAAO,CAAC;aAC9B;SACJ;KACJ;IACD;QACI,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACN,IAAI,EAAE,oBAAoB;YAC1B,WAAW,EAAE,wEAAwE;YACrF,UAAU,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACR,QAAQ,EAAE;wBACN,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,qCAAqC;qBACrD;oBACD,KAAK,EAAE;wBACH,IAAI,EAAE,OAAO;wBACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;wBACzB,WAAW,EAAE,oCAAoC;qBACpD;oBACD,OAAO,EAAE;wBACL,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,iGAAiG;qBACjH;oBACD,MAAM,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,wDAAwD;qBACxE;iBACJ;gBACD,QAAQ,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,SAAS,CAAC;aAC7C;SACJ;KACJ;IACD;QACI,IAAI,EAAE,UAAU;QAChB,QAAQ,EAAE;YACN,IAAI,EAAE,uBAAuB;YAC7B,WAAW,EAAE,4DAA4D;YACzE,UAAU,EAAE;gBACR,IAAI,EAAE,QAAQ;gBACd,UAAU,EAAE;oBACR,IAAI,EAAE;wBACF,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,+CAA+C;qBAC/D;oBACD,IAAI,EAAE;wBACF,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,2DAA2D;qBAC3E;oBACD,MAAM,EAAE;wBACJ,IAAI,EAAE,QAAQ;wBACd,WAAW,EAAE,wDAAwD;qBACxE;iBACJ;gBACD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC;aAC7B;SACJ;KACJ;CACJ,CAAC"}

package/dist/infrastructure/protocols/BaseSession.d.ts

@@ -0,0 +1,10 @@
+import { SessionState } from '../../shared/types';
+export declare abstract class BaseSession {
+    protected state: SessionState;
+    abstract connect(): Promise<void>;
+    abstract execute(command: string, timeoutMs?: number): Promise<string>;
+    abstract disconnect(): Promise<void>;
+    getState(): SessionState;
+    isShellEnabled(): boolean;
+    protected updateStateFromPrompt(promptStr: string): void;
+}

package/dist/infrastructure/protocols/BaseSession.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseSession = void 0;
+class BaseSession {
+    state = { currentMode: 'UNKNOWN', hostname: 'Router', prompt: '>' };
+    getState() {
+        return { ...this.state };
+    }
+    isShellEnabled() {
+        return false;
+    }
+    updateStateFromPrompt(promptStr) {
+        const target = promptStr.trim();
+        if (!target)
+            return;
+        if (target.endsWith('>')) {
+            this.state.currentMode = 'USER_EXEC';
+        }
+        else if (target.endsWith('config-if)#')) {
+            this.state.currentMode = 'INTERFACE_CONFIG';
+        }
+        else if (target.endsWith('config)#')) {
+            this.state.currentMode = 'GLOBAL_CONFIG';
+        }
+        else if (target.endsWith('#')) {
+            this.state.currentMode = 'PRIVILEGED_EXEC';
+        }
+        else {
+            this.state.currentMode = 'UNKNOWN';
+        }
+        const hostMatch = /^([A-Za-z0-9_\-]+)/.exec(target);
+        if (hostMatch) {
+            this.state.hostname = hostMatch[1];
+        }
+        this.state.prompt = target;
+    }
+}
+exports.BaseSession = BaseSession;
+//# sourceMappingURL=BaseSession.js.map

package/dist/infrastructure/protocols/BaseSession.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseSession.js","sourceRoot":"","sources":["../../../src/infrastructure/protocols/BaseSession.ts"],"names":[],"mappings":";;;AAEA,MAAsB,WAAW;IACnB,KAAK,GAAiB,EAAE,WAAW,EAAE,SAAS,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IAMrF,QAAQ;QACX,OAAO,EAAE,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;IAEM,cAAc;QACjB,OAAO,KAAK,CAAC;IACjB,CAAC;IAGS,qBAAqB,CAAC,SAAiB;QAC7C,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC;QAChC,IAAI,CAAC,MAAM;YAAE,OAAO;QAEpB,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,WAAW,CAAC;QACzC,CAAC;aAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC;YACxC,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,kBAAkB,CAAC;QAChD,CAAC;aAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,eAAe,CAAC;QAC7C,CAAC;aAAM,IAAI,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;YAC9B,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,iBAAiB,CAAC;QAC/C,CAAC;aAAM,CAAC;YACJ,IAAI,CAAC,KAAK,CAAC,WAAW,GAAG,SAAS,CAAC;QACvC,CAAC;QAGD,MAAM,SAAS,GAAG,oBAAoB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACpD,IAAI,SAAS,EAAE,CAAC;YACZ,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QACvC,CAAC;QACD,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;IAC/B,CAAC;CACJ;AAvCD,kCAuCC"}

package/dist/infrastructure/protocols/MockSession.d.ts

@@ -0,0 +1,43 @@
+import { BaseSession } from './BaseSession';
+export declare class MockSession extends BaseSession {
+    private deviceId;
+    private interfaces;
+    private activeInterface;
+    private vlans;
+    private shellEnabled;
+    private shellVariables;
+    private shellFunctions;
+    private readonly commandPatterns;
+    constructor(deviceId?: string);
+    isShellEnabled(): boolean;
+    connect(): Promise<void>;
+    execute(command: string, timeoutMs?: number): Promise<string>;
+    executeBase(command: string, timeoutMs?: number): Promise<string>;
+    disconnect(): Promise<void>;
+    private updateMode;
+    private matchCommand;
+    private matchesPattern;
+    private formatInvalidInput;
+    private formatIncompleteCommand;
+    private findInvalidTokenIndex;
+    private transitionToGlobalConfig;
+    private transitionToPrivilegedExec;
+    private transitionToUserExec;
+    private toggleShell;
+    private requireGlobalConfigAndToggleShell;
+    private handleInterfaceCommand;
+    private handleVlanCommand;
+    private handleExitCommand;
+    private handleEndCommand;
+    private handleIpAddressCommand;
+    private handleNoIpAddressCommand;
+    private handleShutdownCommand;
+    private handleNoShutdownCommand;
+    private handleDescriptionCommand;
+    private handleNoDescriptionCommand;
+    private handleShowIpInterfaceBrief;
+    private handleShowRunningConfig;
+    private handleShowVlanBrief;
+    private formatBadInterfaceParameter;
+    private resolveInterfaceName;
+}