socratic-debug 0.0.1__tar.gz

socratic_debug-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Mohamed Alawakey
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

socratic_debug-0.0.1/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: socratic-debug
+Version: 0.0.1
+Summary: Autonomous pedagogical debugging mentor powered by LangGraph, Rich, and LangSmith
+Author: Mohamed Elawakey
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: PyQt6>=6.6.0
+Requires-Dist: langgraph>=1.2.0
+Requires-Dist: langchain>=1.4.0
+Requires-Dist: langchain-ollama>=1.1.0
+Requires-Dist: langchain-openrouter>=0.2.0
+Dynamic: license-file
+
+# 🧠 Socratic Debug (`socratic`)
+
+> **Stop copying stack traces. Start mastering your bugs.**  
+> An autonomous pedagogical debugger and mentor powered by LangGraph, PyQt6, and LangSmith.
+
+[![CI](https://github.com/mohamedelawakey/socratic/actions/workflows/ci.yml/badge.svg)](https://github.com/mohamedelawakey/socratic/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/socratic-debug.svg?color=blue)](https://pypi.org/project/socratic-debug/)
+[![Python Version](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+---
+
+## 💡 Why Socratic?
+
+When a runtime crash happens, most developers find themselves trapped in one of two extremes:
+1. **The Intimidating Traceback:** Staring at a terrifying wall of 50-line red terminal text, unsure which line actually caused the root flaw.
+2. **The "Copier" Reflex:** Blindly copying the error into an LLM chat, pasting the patch without understanding *why* it failed, only to trigger the exact same design mistake minutes later.
+
+**Socratic Debug changes the game.**  
+Instead of dumping stack traces or spoon-feeding copy-paste patches, `socratic` intercepts uncaught runtime crashes and launches a **dedicated desktop mentorship window**. It analyzes the bug silently and guides you through a calibrated, interactive dialogue to help you **discover, understand, and fix the root cause yourself.**
+
+---
+
+## ✨ Features
+
+- 🖥️ **Standalone Desktop Window:** Launches an isolated, dark-themed GUI terminal window right at the center of your screen. No terminal pollution.
+- 🌍 **Pure Native BiDi & Arabic Support:** Flawlessly displays English and Arabic with full Right-to-Left (RTL) text shaping and formatting.
+- 🎯 **Calibrated Socratic Mentorship:** 3-tier adaptive hints (Observation ➔ Mechanism ➔ Idiomatic Prevention).
+- 🧠 **Smart Evaluator:** Distinguishes between partial observations (e.g., stating a variable's value) and true comprehension before unlocking the defensive code solution.
+- 🔌 **Universal LLM Support:** Plug into local models via **Ollama** (Gemma, Llama, Qwen) or cloud providers via **OpenRouter** / **Google Gemini**.
+- 📊 **Built-in Observability:** Native tracing with **LangSmith** to monitor latency, tokens, and node execution graphs.
+- 🌐 **Cross-Platform:** Runs seamlessly on **Linux**, **macOS**, and **Windows**.
+
+---
+
+## 🚀 Quick Start
+
+### Installation
+
+The cleanest, recommended way to install `socratic` globally across your system without virtual environment conflicts:
+
+```bash
+# Recommended (isolated global CLI)
+pipx install socratic-debug
+
+# Or via standard pip
+pip install socratic-debug
+```
+
+Alternatively, use the one-line install script:
+```bash
+# Linux & macOS
+curl -sSL https://raw.githubusercontent.com/mohamedelawakey/socratic/main/install.sh | bash
+
+# Windows (PowerShell)
+irm https://raw.githubusercontent.com/mohamedelawakey/socratic/main/install.ps1 | iex
+```
+
+---
+
+## 🛠️ Usage
+
+You can use `socratic` in two distinct ways:
+
+### Method 1: Zero-Code-Change CLI Runner (Recommended)
+You don't need to add any code or imports to your script! Simply prefix your execution:
+
+```bash
+socratic run my_script.py
+```
+- If your script runs successfully, it outputs normally.
+- If an unhandled exception occurs, the **Socratic Mentor Window** springs to life immediately!
+
+### Method 2: In-Process Runtime Hook
+If you are building an application or library and want Socratic guidance baked directly into development runs:
+
+```python
+import socratic
+socratic.install()
+
+# Your regular application code
+number_1 = 10
+number_2 = 0
+print(number_1 / number_2)  # <-- ZeroDivisionError triggers Socratic window!
+```
+
+---
+
+## ⚙️ Configuration (`.socratic.yaml`)
+
+When you run `socratic` for the first time, it automatically creates a `.socratic.yaml` config file in your project or home directory:
+
+```yaml
+# LLM Provider: "ollama" or "openrouter"
+provider: "ollama"
+provider_name: "gemma4:31b-cloud"
+provider_link: "http://localhost:11434"
+
+# API Key (for cloud providers like OpenRouter)
+api_key: "your_api_key_here"
+
+# Mentor Personality & Language ("Arabic" or "English")
+socratic_language: "Arabic"
+socratic_style: "friendly"
+
+# Observability with LangSmith (Optional)
+LANGSMITH_TRACING: "true"
+LANGSMITH_API_KEY: "lsv2_pt_..."
+LANGSMITH_PROJECT: "socratic-debug"
+```
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions! Please review our [CONTRIBUTING.md](CONTRIBUTING.md) guidelines:
+- For large architectural changes or new features, **please open a GitHub Discussion first**.
+- For minor bug fixes, direct Pull Requests are warmly welcome.
+
+Please note that this project adheres to the [Contributor Covenant Code of Conduct](CODE_OF_CONDUCT.md).
+
+---
+
+## 📄 License
+
+Distributed under the **MIT License**. See [LICENSE](LICENSE) for full details.

socratic_debug-0.0.1/README.md

@@ -0,0 +1,126 @@
+# 🧠 Socratic Debug (`socratic`)
+
+> **Stop copying stack traces. Start mastering your bugs.**  
+> An autonomous pedagogical debugger and mentor powered by LangGraph, PyQt6, and LangSmith.
+
+[![CI](https://github.com/mohamedelawakey/socratic/actions/workflows/ci.yml/badge.svg)](https://github.com/mohamedelawakey/socratic/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/socratic-debug.svg?color=blue)](https://pypi.org/project/socratic-debug/)
+[![Python Version](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+---
+
+## 💡 Why Socratic?
+
+When a runtime crash happens, most developers find themselves trapped in one of two extremes:
+1. **The Intimidating Traceback:** Staring at a terrifying wall of 50-line red terminal text, unsure which line actually caused the root flaw.
+2. **The "Copier" Reflex:** Blindly copying the error into an LLM chat, pasting the patch without understanding *why* it failed, only to trigger the exact same design mistake minutes later.
+
+**Socratic Debug changes the game.**  
+Instead of dumping stack traces or spoon-feeding copy-paste patches, `socratic` intercepts uncaught runtime crashes and launches a **dedicated desktop mentorship window**. It analyzes the bug silently and guides you through a calibrated, interactive dialogue to help you **discover, understand, and fix the root cause yourself.**
+
+---
+
+## ✨ Features
+
+- 🖥️ **Standalone Desktop Window:** Launches an isolated, dark-themed GUI terminal window right at the center of your screen. No terminal pollution.
+- 🌍 **Pure Native BiDi & Arabic Support:** Flawlessly displays English and Arabic with full Right-to-Left (RTL) text shaping and formatting.
+- 🎯 **Calibrated Socratic Mentorship:** 3-tier adaptive hints (Observation ➔ Mechanism ➔ Idiomatic Prevention).
+- 🧠 **Smart Evaluator:** Distinguishes between partial observations (e.g., stating a variable's value) and true comprehension before unlocking the defensive code solution.
+- 🔌 **Universal LLM Support:** Plug into local models via **Ollama** (Gemma, Llama, Qwen) or cloud providers via **OpenRouter** / **Google Gemini**.
+- 📊 **Built-in Observability:** Native tracing with **LangSmith** to monitor latency, tokens, and node execution graphs.
+- 🌐 **Cross-Platform:** Runs seamlessly on **Linux**, **macOS**, and **Windows**.
+
+---
+
+## 🚀 Quick Start
+
+### Installation
+
+The cleanest, recommended way to install `socratic` globally across your system without virtual environment conflicts:
+
+```bash
+# Recommended (isolated global CLI)
+pipx install socratic-debug
+
+# Or via standard pip
+pip install socratic-debug
+```
+
+Alternatively, use the one-line install script:
+```bash
+# Linux & macOS
+curl -sSL https://raw.githubusercontent.com/mohamedelawakey/socratic/main/install.sh | bash
+
+# Windows (PowerShell)
+irm https://raw.githubusercontent.com/mohamedelawakey/socratic/main/install.ps1 | iex
+```
+
+---
+
+## 🛠️ Usage
+
+You can use `socratic` in two distinct ways:
+
+### Method 1: Zero-Code-Change CLI Runner (Recommended)
+You don't need to add any code or imports to your script! Simply prefix your execution:
+
+```bash
+socratic run my_script.py
+```
+- If your script runs successfully, it outputs normally.
+- If an unhandled exception occurs, the **Socratic Mentor Window** springs to life immediately!
+
+### Method 2: In-Process Runtime Hook
+If you are building an application or library and want Socratic guidance baked directly into development runs:
+
+```python
+import socratic
+socratic.install()
+
+# Your regular application code
+number_1 = 10
+number_2 = 0
+print(number_1 / number_2)  # <-- ZeroDivisionError triggers Socratic window!
+```
+
+---
+
+## ⚙️ Configuration (`.socratic.yaml`)
+
+When you run `socratic` for the first time, it automatically creates a `.socratic.yaml` config file in your project or home directory:
+
+```yaml
+# LLM Provider: "ollama" or "openrouter"
+provider: "ollama"
+provider_name: "gemma4:31b-cloud"
+provider_link: "http://localhost:11434"
+
+# API Key (for cloud providers like OpenRouter)
+api_key: "your_api_key_here"
+
+# Mentor Personality & Language ("Arabic" or "English")
+socratic_language: "Arabic"
+socratic_style: "friendly"
+
+# Observability with LangSmith (Optional)
+LANGSMITH_TRACING: "true"
+LANGSMITH_API_KEY: "lsv2_pt_..."
+LANGSMITH_PROJECT: "socratic-debug"
+```
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions! Please review our [CONTRIBUTING.md](CONTRIBUTING.md) guidelines:
+- For large architectural changes or new features, **please open a GitHub Discussion first**.
+- For minor bug fixes, direct Pull Requests are warmly welcome.
+
+Please note that this project adheres to the [Contributor Covenant Code of Conduct](CODE_OF_CONDUCT.md).
+
+---
+
+## 📄 License
+
+Distributed under the **MIT License**. See [LICENSE](LICENSE) for full details.

socratic_debug-0.0.1/pyproject.toml

@@ -0,0 +1,30 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "socratic-debug"
+version = "0.0.1"
+description = "Autonomous pedagogical debugging mentor powered by LangGraph, Rich, and LangSmith"
+authors = [{ name = "Mohamed Elawakey" }]
+readme = "README.md"
+requires-python = ">=3.10"
+dependencies = [
+    "pyyaml>=6.0",
+    "rich>=13.7.0",
+    "PyQt6>=6.6.0",
+    "langgraph>=1.2.0",
+    "langchain>=1.4.0",
+    "langchain-ollama>=1.1.0",
+    "langchain-openrouter>=0.2.0",
+]
+
+[project.scripts]
+socratic = "src.cli:main"
+
+[tool.setuptools]
+py-modules = ["socratic"]
+
+[tool.setuptools.packages.find]
+where = ["."]
+include = ["src*", "ui*"]

socratic_debug-0.0.1/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

socratic_debug-0.0.1/socratic.py

@@ -0,0 +1,8 @@
+"""
+Socratic Debug — Autonomous pedagogical debugging mentor.
+"""
+
+from src.hook import install
+from src.agent.runner import run_socratic_agent
+
+__all__ = ["install", "run_socratic_agent"]

socratic_debug-0.0.1/socratic_debug.egg-info/PKG-INFO

@@ -0,0 +1,143 @@
+Metadata-Version: 2.4
+Name: socratic-debug
+Version: 0.0.1
+Summary: Autonomous pedagogical debugging mentor powered by LangGraph, Rich, and LangSmith
+Author: Mohamed Elawakey
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: rich>=13.7.0
+Requires-Dist: PyQt6>=6.6.0
+Requires-Dist: langgraph>=1.2.0
+Requires-Dist: langchain>=1.4.0
+Requires-Dist: langchain-ollama>=1.1.0
+Requires-Dist: langchain-openrouter>=0.2.0
+Dynamic: license-file
+
+# 🧠 Socratic Debug (`socratic`)
+
+> **Stop copying stack traces. Start mastering your bugs.**  
+> An autonomous pedagogical debugger and mentor powered by LangGraph, PyQt6, and LangSmith.
+
+[![CI](https://github.com/mohamedelawakey/socratic/actions/workflows/ci.yml/badge.svg)](https://github.com/mohamedelawakey/socratic/actions/workflows/ci.yml)
+[![PyPI version](https://img.shields.io/pypi/v/socratic-debug.svg?color=blue)](https://pypi.org/project/socratic-debug/)
+[![Python Version](https://img.shields.io/badge/python-3.10%20%7C%203.11%20%7C%203.12%20%7C%203.13-blue)](https://www.python.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+---
+
+## 💡 Why Socratic?
+
+When a runtime crash happens, most developers find themselves trapped in one of two extremes:
+1. **The Intimidating Traceback:** Staring at a terrifying wall of 50-line red terminal text, unsure which line actually caused the root flaw.
+2. **The "Copier" Reflex:** Blindly copying the error into an LLM chat, pasting the patch without understanding *why* it failed, only to trigger the exact same design mistake minutes later.
+
+**Socratic Debug changes the game.**  
+Instead of dumping stack traces or spoon-feeding copy-paste patches, `socratic` intercepts uncaught runtime crashes and launches a **dedicated desktop mentorship window**. It analyzes the bug silently and guides you through a calibrated, interactive dialogue to help you **discover, understand, and fix the root cause yourself.**
+
+---
+
+## ✨ Features
+
+- 🖥️ **Standalone Desktop Window:** Launches an isolated, dark-themed GUI terminal window right at the center of your screen. No terminal pollution.
+- 🌍 **Pure Native BiDi & Arabic Support:** Flawlessly displays English and Arabic with full Right-to-Left (RTL) text shaping and formatting.
+- 🎯 **Calibrated Socratic Mentorship:** 3-tier adaptive hints (Observation ➔ Mechanism ➔ Idiomatic Prevention).
+- 🧠 **Smart Evaluator:** Distinguishes between partial observations (e.g., stating a variable's value) and true comprehension before unlocking the defensive code solution.
+- 🔌 **Universal LLM Support:** Plug into local models via **Ollama** (Gemma, Llama, Qwen) or cloud providers via **OpenRouter** / **Google Gemini**.
+- 📊 **Built-in Observability:** Native tracing with **LangSmith** to monitor latency, tokens, and node execution graphs.
+- 🌐 **Cross-Platform:** Runs seamlessly on **Linux**, **macOS**, and **Windows**.
+
+---
+
+## 🚀 Quick Start
+
+### Installation
+
+The cleanest, recommended way to install `socratic` globally across your system without virtual environment conflicts:
+
+```bash
+# Recommended (isolated global CLI)
+pipx install socratic-debug
+
+# Or via standard pip
+pip install socratic-debug
+```
+
+Alternatively, use the one-line install script:
+```bash
+# Linux & macOS
+curl -sSL https://raw.githubusercontent.com/mohamedelawakey/socratic/main/install.sh | bash
+
+# Windows (PowerShell)
+irm https://raw.githubusercontent.com/mohamedelawakey/socratic/main/install.ps1 | iex
+```
+
+---
+
+## 🛠️ Usage
+
+You can use `socratic` in two distinct ways:
+
+### Method 1: Zero-Code-Change CLI Runner (Recommended)
+You don't need to add any code or imports to your script! Simply prefix your execution:
+
+```bash
+socratic run my_script.py
+```
+- If your script runs successfully, it outputs normally.
+- If an unhandled exception occurs, the **Socratic Mentor Window** springs to life immediately!
+
+### Method 2: In-Process Runtime Hook
+If you are building an application or library and want Socratic guidance baked directly into development runs:
+
+```python
+import socratic
+socratic.install()
+
+# Your regular application code
+number_1 = 10
+number_2 = 0
+print(number_1 / number_2)  # <-- ZeroDivisionError triggers Socratic window!
+```
+
+---
+
+## ⚙️ Configuration (`.socratic.yaml`)
+
+When you run `socratic` for the first time, it automatically creates a `.socratic.yaml` config file in your project or home directory:
+
+```yaml
+# LLM Provider: "ollama" or "openrouter"
+provider: "ollama"
+provider_name: "gemma4:31b-cloud"
+provider_link: "http://localhost:11434"
+
+# API Key (for cloud providers like OpenRouter)
+api_key: "your_api_key_here"
+
+# Mentor Personality & Language ("Arabic" or "English")
+socratic_language: "Arabic"
+socratic_style: "friendly"
+
+# Observability with LangSmith (Optional)
+LANGSMITH_TRACING: "true"
+LANGSMITH_API_KEY: "lsv2_pt_..."
+LANGSMITH_PROJECT: "socratic-debug"
+```
+
+---
+
+## 🤝 Contributing
+
+We welcome contributions! Please review our [CONTRIBUTING.md](CONTRIBUTING.md) guidelines:
+- For large architectural changes or new features, **please open a GitHub Discussion first**.
+- For minor bug fixes, direct Pull Requests are warmly welcome.
+
+Please note that this project adheres to the [Contributor Covenant Code of Conduct](CODE_OF_CONDUCT.md).
+
+---
+
+## 📄 License
+
+Distributed under the **MIT License**. See [LICENSE](LICENSE) for full details.

socratic_debug-0.0.1/socratic_debug.egg-info/SOURCES.txt

@@ -0,0 +1,44 @@
+LICENSE
+README.md
+pyproject.toml
+socratic.py
+socratic_debug.egg-info/PKG-INFO
+socratic_debug.egg-info/SOURCES.txt
+socratic_debug.egg-info/dependency_links.txt
+socratic_debug.egg-info/entry_points.txt
+socratic_debug.egg-info/requires.txt
+socratic_debug.egg-info/top_level.txt
+src/__init__.py
+src/cli.py
+src/config_creator.py
+src/config_template.py
+src/extractor.py
+src/hook.py
+src/agent/runner.py
+src/agent/graph/graph.py
+src/agent/llm/factory.py
+src/agent/llm/providers/__init__.py
+src/agent/llm/providers/ollama.py
+src/agent/llm/providers/openrouter.py
+src/agent/nodes/diagnose_node.py
+src/agent/nodes/evaluate_node.py
+src/agent/nodes/human_input_node.py
+src/agent/nodes/questioner_node.py
+src/agent/nodes/solution_node.py
+src/agent/prompts/diagnose_prompt.py
+src/agent/prompts/evaluation_prompt.py
+src/agent/prompts/mentor_prompt.py
+src/agent/prompts/questioner_prompt.py
+src/agent/prompts/solution_prompt.py
+src/agent/state/state.py
+src/utils/read_yaml.py
+test/test_hock.py
+ui/__init__.py
+ui/app.py
+ui/bidi.py
+ui/console.py
+ui/styles.py
+ui/templates.py
+ui/translations.py
+ui/views.py
+ui/window.py

socratic_debug-0.0.1/socratic_debug.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

socratic_debug-0.0.1/socratic_debug.egg-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+socratic = src.cli:main

socratic_debug-0.0.1/socratic_debug.egg-info/requires.txt

@@ -0,0 +1,7 @@
+pyyaml>=6.0
+rich>=13.7.0
+PyQt6>=6.6.0
+langgraph>=1.2.0
+langchain>=1.4.0
+langchain-ollama>=1.1.0
+langchain-openrouter>=0.2.0

socratic_debug-0.0.1/socratic_debug.egg-info/top_level.txt

@@ -0,0 +1,3 @@
+socratic
+src
+ui

socratic_debug-0.0.1/src/__init__.py

@@ -0,0 +1 @@
+# socratic package

socratic_debug-0.0.1/src/agent/graph/graph.py

@@ -0,0 +1,47 @@
+from langgraph.graph import StateGraph, END, START
+from src.agent.state.state import SocraticAgentState
+from src.agent.nodes.diagnose_node import DiagnoseNode
+from src.agent.nodes.questioner_node import QuestionerNode
+from src.agent.nodes.human_input_node import HumanInputNode
+from src.agent.nodes.evaluate_node import EvaluationNode
+from src.agent.nodes.solution_node import SolutionNode
+
+def decision_router(state: SocraticAgentState) -> str:
+    if state.get("is_solved"):
+        return "solution"
+    if state.get("hint_level", 1) > 3:
+        return "solution"
+    return "questioner"
+
+
+class SocraticGraph:
+    @staticmethod
+    def build_graph():
+    # We will assemble nodes and edges here
+        graph = StateGraph(SocraticAgentState)
+
+        # add nodes
+        graph.add_node("diagnose", DiagnoseNode.diagnose_node)
+        graph.add_node("questioner", QuestionerNode.questioner_node)
+        graph.add_node("human_input", HumanInputNode.human_input_node)
+        graph.add_node("evaluate", EvaluationNode.evaluation_node)
+        graph.add_node("solution", SolutionNode.solution_node)
+
+        # edges
+        graph.add_edge(START, "diagnose")
+        graph.add_edge("diagnose", "questioner")
+        graph.add_edge("questioner", "human_input")
+        graph.add_edge("human_input", "evaluate")
+
+        graph.add_conditional_edges(
+            "evaluate",
+            decision_router,
+            {
+                "solution": "solution",
+                "questioner": "questioner",
+            }
+        )
+        graph.add_edge("solution", END)
+
+        return graph.compile()
+

socratic_debug-0.0.1/src/agent/llm/factory.py

@@ -0,0 +1,15 @@
+from src.agent.llm.providers import *
+from src.utils.read_yaml import ReadYaml
+
+
+class LLMFactory:
+    @staticmethod
+    def get_llm():
+        config = ReadYaml.read_yaml()
+
+        if config["provider"] == "openrouter":
+            return OpenRouterLLM.openrouter_llm()
+        elif config["provider"] == "ollama":
+            return OllamaLLM.ollama_llm()
+        else:
+            raise ValueError("Invalid provider")

socratic_debug-0.0.1/src/agent/llm/providers/__init__.py

@@ -0,0 +1,8 @@
+from src.agent.llm.providers.openrouter import OpenRouterLLM
+from src.agent.llm.providers.ollama import OllamaLLM
+
+
+__all__ = [
+    "OpenRouterLLM",
+    "OllamaLLM",
+]

socratic_debug-0.0.1/src/agent/llm/providers/ollama.py

@@ -0,0 +1,13 @@
+from langchain_ollama import ChatOllama
+from src.utils.read_yaml import ReadYaml
+
+
+class OllamaLLM:
+    @staticmethod
+    def ollama_llm():
+        config = ReadYaml.read_yaml()
+
+        return ChatOllama (
+            model=config["provider_name"],
+            base_url=config["provider_link"],
+        )

socratic_debug-0.0.1/src/agent/llm/providers/openrouter.py

@@ -0,0 +1,14 @@
+from langchain_openrouter import ChatOpenRouter
+from src.utils.read_yaml import ReadYaml
+
+
+class OpenRouterLLM:
+    @staticmethod
+    def openrouter_llm():
+        config = ReadYaml.read_yaml()
+
+        return ChatOpenRouter(
+            model=config["provider_name"],
+            base_url=config["provider_link"],
+            api_key=config["api_key"],
+        )

socratic_debug-0.0.1/src/agent/nodes/diagnose_node.py

@@ -0,0 +1,21 @@
+from src.agent.prompts.diagnose_prompt import DiagnosePrompt
+from src.agent.state.state import SocraticAgentState
+from src.agent.llm.factory import LLMFactory
+
+
+class DiagnoseNode:
+    @staticmethod
+    def diagnose_node(state: SocraticAgentState) -> dict:
+        prompt = DiagnosePrompt.diagnose_prompt(
+            error_type=state["error_type"],
+            error_name=state["error_name"],
+            file_path=state["file_path"],
+            line_number=state["line_number"],
+            line_content=state["line_content"],
+            code_snippet=state["code_snippet"],
+            function_name=state.get("function_name") or "",
+        )
+
+        response = LLMFactory.get_llm().invoke(prompt)
+
+        return {"root_cause": response.content}