Translate comments to English

LICENSE

@@ -0,0 +1,17 @@
+GNU LESSER GENERAL PUBLIC LICENSE
+Version 3, 29 June 2007
+
+Copyright (C) 2025 H5N3RG
+
+This program is free software: you can redistribute it and/or modify
+it under the terms of the GNU Lesser General Public License as published
+by the Free Software Foundation, either version 3 of the License, or
+(at your option) any later version.
+
+This program is distributed in the hope that it will be useful,
+but WITHOUT ANY WARRANTY; without even the implied warranty of
+MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
+GNU Lesser General Public License for more details.
+
+You should have received a copy of the GNU Lesser General Public License
+along with this program. If not, see <https://www.gnu.org/licenses/>.

README.md

@@ -1,62 +1,299 @@
+
 # LLM Connect
 
-A Luanti (formerly Minetest) mod that connects the game to a Large Language Model (LLM) using an OpenAI-compatible API endpoint.
+**A Luanti (formerly Minetest) mod that integrates Large Language Models (LLMs) directly into the game with an AI-powered Lua IDE and building assistant.**
 
-## Purpose
+![License](https://img.shields.io/badge/license-LGPL--3.0--or--later-blue)
 
-This mod allows players to interact with an LLM directly within the Luanti chat.
+---
-It sends the player's chat message along with relevant in-game context—such as server info, installed mods, and available materials—to a remote API endpoint.
-This enables the LLM to provide highly specific and helpful answers, e.g., on crafting items or locating resources in-game.
 
-## Features
+## 🌟 Overview
 
-- **In-game AI Chat:** Send prompts to the LLM using a simple chat command. - **Context-Aware & Granular:** Automatically includes crucial server and material data in the prompts. **The inclusion of context elements (server info, mod list, materials, position) is now fully configurable via settings.** - **Configurable:** API key, endpoint URL, model, and all **context components** can be set via chat commands or the in-game menu. - **Conversation History:** Maintains short-term conversation history for more relevant responses. - **Robust Token Handling:** Supports sending `max_tokens` as an integer to avoid floating-point issues; optionally configurable via `settingtypes.txt` or chat commands.
+LLM Connect brings modern AI assistance into Luanti worlds.
+Players and developers can interact with a Large Language Model directly in-game to:
 
-## Implementation
+- ask questions
+- generate Lua code
+- analyze or refactor scripts
+- assist with WorldEdit building tasks
+- experiment with sandboxed Lua execution
 
-- Built with Luanti's HTTP API for sending requests to an external, OpenAI-compatible endpoint. - Structured to be understandable and extendable for new contributors.
+The mod combines an **AI chat interface**, a **Smart Lua IDE**, and **LLM-assisted building tools** into a single integrated workflow.
-- Version: **0.7.8**
 
-## Requirements
+---
 
-- A running Luanti server.
+## ✨ Core Features
-- An API key from a supported service. ## Supported API Endpoints
 
-Successfully tested with:
+### 🤖 AI Chat Interface
 
-- Open WebUI
+Interact with a Large Language Model directly inside Luanti.
+
+Features include:
+
+- In-game chat GUI
+- conversation context handling
+- player and world information awareness
+- configurable prompts and system instructions
+- support for OpenAI-compatible APIs
+
+The chat system automatically includes contextual information such as:
+
+- player position
+- installed mods
+- selected materials
+- server environment
+
+---
+
+### 💻 Smart Lua IDE
+
+LLM Connect includes a fully integrated **AI-assisted Lua development environment**.
+
+Capabilities include:
+
+- AI code generation from natural language prompts
+- semantic code explanation
+- automated refactoring
+- code analysis
+- interactive editing interface
+- integration with the game environment
+
+Developers can experiment with Lua snippets directly inside the game.
+
+---
+
+### 🧪 Sandboxed Code Execution
+
+Lua code can be executed inside a controlled environment.
+
+Security features include:
+
+- privilege-based execution access
+- sandboxed runtime
+- optional whitelist restrictions
+- prevention of filesystem access
+
+Execution results are returned to the IDE interface for inspection.
+
+---
+
+### 🏗️ WorldEdit AI Assistant
+
+LLM Connect can assist with building tasks using WorldEdit.
+
+Examples:
+
+- structure generation prompts
+- building suggestions
+- node/material selection
+- architectural transformations
+
+The system can combine:
+
+- player position
+- selected materials
+- worldedit context
+
+to produce context-aware instructions.
+
+---
+
+### 🧱 Material Selection Tools
+
+The mod includes a **material picker** interface that helps the AI understand:
+
+- available nodes
+- building palettes
+- player selections
+
+This improves the quality of building-related prompts.
+
+---
+
+## 🔐 Permission System
+
+Access to AI features is controlled through Luanti privileges.
+
+| Privilege | Description |
+|-----------|-------------|
+| `llm` | Basic AI chat access |
+| `llm_ide` | Access to the Smart Lua IDE |
+| `llm_dev` | Sandbox Lua execution |
+| `llm_root` | Full administrative control |
+
+Server operators should grant privileges carefully.
+
+---
+
+## 📋 Requirements
+
+- Luanti server **5.4.0 or newer recommended**
+- HTTP API enabled
+- Access to a compatible LLM endpoint
+
+Supported providers include:
+
+- OpenAI
+- Ollama
 - LM Studio
-- Mistral AI
+- LocalAI
-- OpenAI API
+- Open WebUI
-- Ollama and LocalAI (integer `max_tokens` ensures compatibility)
+- Mistral
+- Together AI
+- any OpenAI-compatible API
 
-## Commands
+---
 
-- `/llm_setkey <key> [url] [model]` – Sets the API key, URL, and model for the LLM. - `/llm_setmodel <model>` – Sets the LLM model to be used.
+## 🚀 Installation
-- `/llm_set_endpoint <url>` – Sets the API endpoint URL.
-- `/llm_set_context <count> [player]` – Sets the maximum context length for a player or all players.
-- `/llm_reset` – Resets the conversation history and the cached metadata for the current player.
-- `/llm <prompt>` – Sends a message to the LLM. - `/llm_integer` – Forces `max_tokens` to be sent as an integer (default).
-- `/llm_float` – Sends `max_tokens` as a float (optional, experimental).
 
-**Context Control (Configurable via In-Game Settings):**
+### ContentDB (recommended)
-The following context elements can be individually toggled `ON`/`OFF` in the Luanti main menu:
-* Send Server Info (`llm_context_send_server_info`)
-* Send Mod List (`llm_context_send_mod_list`)
-* Send Commands List (`llm_context_send_commands`)
-* Send Player Position (`llm_context_send_player_pos`)
-* Send Available Materials (`llm_context_send_materials`)
 
-## Potential for Expansion
+Install via ContentDB:
 
-- Add support for more API endpoints. - Integrate with additional in-game events or data sources (player inventory, world data).
+```
-- Improve error handling and performance.
-- Create a graphical user interface (formspec) for configuration instead of relying solely on chat commands.
 
-## Contributing
+Content → Mods → LLM Connect
+
+```
+
+---
+
+### Manual Installation
+
+1. Download the repository or release archive
+2. Extract into your `mods` folder
+3. Ensure the folder name is:
+
+```
+
+llm_connect
+
+```
+
+4. Enable HTTP API in `minetest.conf`
+
+```
+
+secure.http_mods = llm_connect
+
+```
+
+Restart the server.
+
+---
+
+## ⚙️ Configuration
+
+Configuration can be done via:
+
+- `/llm_config` GUI
+- `minetest.conf`
+
+Example:
+
+```
+
+llm_api_key = your-api-key
+llm_api_url = [https://api.openai.com/v1/chat/completions](https://api.openai.com/v1/chat/completions)
+llm_model = gpt-4
+
+llm_temperature = 0.7
+llm_max_tokens = 4000
+llm_timeout = 120
+
+```
+
+Context options:
+
+```
+
+llm_context_send_player_pos = true
+llm_context_send_mod_list = true
+llm_context_send_materials = true
+
+```
+
+---
+
+## 🎮 Commands
+
+| Command | Description |
+|-------|-------------|
+| `/llm` | Open AI chat |
+| `/llm_ide` | Open Smart Lua IDE |
+| `/llm_config` | Open configuration interface |
+
+---
+
+## 🔐 Security Notes
+
+LLM Connect includes multiple safety mechanisms:
+
+- privilege-based access control
+- sandboxed execution environment
+- optional Lua whitelist
+- no filesystem access in sandbox mode
+
+Server administrators should still review generated code carefully.
+
+---
+
+## 🧭 Roadmap
+
+See:
+
+```
+
+ROADMAP_090.md
+
+```
+
+for planned improvements and upcoming features.
+
+---
+
+## 🤝 Contributing
+
+Contributions are welcome.
+
+Typical workflow:
+
+1. fork repository
+2. create feature branch
+3. implement changes
+4. submit pull request
+
+Areas of interest:
+
+- new AI integrations
+- UI improvements
+- security auditing
+- building tools
+- documentation
+
+---
+
+## 📜 License
+
+LGPL-3.0-or-later
+
+See `LICENSE`.
+
+---
+
+## 🔗 Links
+
+ContentDB
+https://content.luanti.org/packages/H5N3RG/llm_connect/
+
+Luanti
+https://www.luanti.org/
+
+---
+
+**LLM Connect – Bringing AI-assisted development into Luanti.**
+```
 
-This project is in an early stage and welcomes contributions:
 
-- Even small fixes help, especially with API integration, UI improvements, and performance tuning. - Contributions from experienced developers are highly welcome. ```
 
 

ROADMAP_090.md

@@ -0,0 +1,109 @@
+# LLM Connect 0.9 Roadmap
+
+This document outlines the development goals and planned improvements
+for the 0.9 release of LLM Connect.
+
+The focus of this version is stability, improved context handling,
+and better integration between AI features and the Luanti environment.
+
+---
+
+## Overview
+
+Version 0.9 aims to refine the existing AI integration and extend
+the development tools provided by the Smart Lua IDE.
+
+Key areas include:
+
+- improved context awareness
+- better IDE workflow
+- enhanced WorldEdit integration
+- improved error handling and execution feedback
+
+---
+
+## Completed Features
+
+The following features are already implemented:
+
+- Improved request timeout handling
+- Expanded configuration options
+- Wider IDE layout and improved UI usability
+- Guide checkbox for code generation prompts
+- Custom file indexing system replacing `core.get_dir_list`
+- Improved proxy and API error handling
+
+---
+
+## In Progress
+
+These features are currently under active development:
+
+### IDE Context System
+
+The IDE will provide additional contextual information to the LLM.
+
+Planned context elements include:
+
+- active mods list
+- player position
+- currently opened file
+- execution output from previous runs
+
+This will allow the LLM to generate more accurate and relevant code.
+
+---
+
+## Planned Improvements
+
+### Execution Feedback Loop
+
+Improve the interaction between generated code and the execution system.
+
+Possible features:
+
+- automatic error detection
+- AI-assisted debugging
+- improved output visualization
+
+---
+
+### WorldEdit Integration
+
+Further improvements to AI-assisted building tools:
+
+- context-aware structure generation
+- material-aware building suggestions
+- improved prompt templates
+
+---
+
+### Prompt System Refinements
+
+Improve system prompts used for:
+
+- Lua code generation
+- WorldEdit assistance
+- general chat interactions
+
+The goal is more consistent and reliable responses.
+
+---
+
+## Future Ideas
+
+Ideas being explored for future versions:
+
+- agent-style AI workflows
+- multi-step code generation and correction
+- automatic debugging loops
+- extended IDE tooling
+- improved building automation tools
+
+---
+
+## Long-Term Vision
+
+LLM Connect aims to evolve into a complete AI-assisted development
+environment inside Luanti, enabling players and modders to experiment,
+prototype, and build complex systems directly within the game.

chat_context.lua

@@ -0,0 +1,135 @@
+-- chat_context.lua
+-- Collects game and world context for the LLM
+-- Uses settings from settingtypes.txt
+
+local core = core
+local M = {}
+
+local materials_cache = nil
+local materials_hash = nil
+
+-- Computes a hash of the registry to detect changes in nodes or items
+local function compute_registry_hash()
+    local count = 0
+    for _ in pairs(core.registered_nodes) do count = count + 1 end
+    for _ in pairs(core.registered_items) do count = count + 1 end
+    return tostring(count)
+end
+
+-- Generates a string context of registered materials (nodes, tools, items)
+local function get_materials_context()
+    local current_hash = compute_registry_hash()
+    if materials_cache and materials_hash == current_hash then
+        return materials_cache
+    end
+
+    local lines = {}
+    local categories = {
+        {list = core.registered_nodes, label = "Nodes"},
+        {list = core.registered_tools, label = "Tools"},
+        {list = core.registered_craftitems, label = "Items"}
+    }
+
+    for _, cat in ipairs(categories) do
+        local count = 0
+        local items = {}
+        for name, _ in pairs(cat.list) do
+            -- Filter out internal engine nodes
+            if not name:match("^__builtin") and not name:match("^ignore") and not name:match("^air") then
+                count = count + 1
+                if count <= 40 then
+                    table.insert(items, name)
+                end
+            end
+        end
+        table.insert(lines, cat.label .. ": " .. table.concat(items, ", "))
+    end
+
+    materials_cache = table.concat(lines, "\n")
+    materials_hash = current_hash
+    return materials_cache
+end
+
+-- Returns general information about the server and game state
+function M.get_server_info()
+    local info = {}
+    local version = core.get_version()
+    table.insert(info, "Game: " .. (core.get_game_info().name or "Luanti/Minetest"))
+    table.insert(info, "Engine Version: " .. (version.project or "unknown"))
+
+    if core.settings:get_bool("llm_context_send_mod_list") then
+        local mods = core.get_modnames()
+        table.sort(mods)
+        table.insert(info, "Active Mods: " .. table.concat(mods, ", "))
+    end
+
+    local time = core.get_timeofday() * 24000
+    local hour = math.floor(time / 1000)
+    local min = math.floor((time % 1000) / 1000 * 60)
+    table.insert(info, string.format("In-game Time: %02d:%02d", hour, min))
+
+    return table.concat(info, "\n")
+end
+
+-- Compiles all enabled context categories into a single string
+function M.get_context(name)
+    local ctx = {"--- START CONTEXT ---"}
+
+    -- 1. Server Info
+    if core.settings:get_bool("llm_context_send_server_info") ~= false then
+        table.insert(ctx, "--- SERVER INFO ---")
+        table.insert(ctx, M.get_server_info())
+    end
+
+    -- 2. Player Info
+    if core.settings:get_bool("llm_context_send_player_pos") ~= false then
+        local player = core.get_player_by_name(name)
+        if player then
+            local pos = player:get_pos()
+            local hp = player:get_hp()
+            local wielded = player:get_wielded_item():get_name()
+
+            table.insert(ctx, string.format("Current Player (%s): HP: %d, Pos: (x=%.1f, y=%.1f, z=%.1f)",
+                name, hp, pos.x, pos.y, pos.z))
+
+            if wielded ~= "" then
+                table.insert(ctx, "Holding item: " .. wielded)
+            end
+        end
+    end
+
+    -- 3. Chat Commands
+    if core.settings:get_bool("llm_context_send_commands") then
+        local cmds = {}
+        for cmd, _ in pairs(core.registered_chatcommands) do
+            table.insert(cmds, "/" .. cmd)
+        end
+        table.sort(cmds)
+        table.insert(ctx, "Available Commands (Top 50): " .. table.concat(cmds, ", ", 1, math.min(50, #cmds)))
+    end
+
+    -- 4. Materials
+    if core.settings:get_bool("llm_context_send_materials") then
+        table.insert(ctx, "--- REGISTERED MATERIALS ---")
+        table.insert(ctx, get_materials_context())
+    end
+
+    table.insert(ctx, "--- END CONTEXT ---")
+    return table.concat(ctx, "\n")
+end
+
+-- Injects the game context as a system message into the messages table
+function M.append_context(messages, name)
+    local context_str = M.get_context(name)
+
+    table.insert(messages, 1, {
+        role = "system",
+        content = "You are an AI assistant inside a Luanti (Minetest) game world. " ..
+                  "Use the following game context to answer the user's questions accurately.\n\n" ..
+                  context_str
+    })
+
+    return messages
+end
+
+return M

chat_gui.lua

@@ -0,0 +1,368 @@
+-- chat_gui.lua
+-- LLM Chat Interface v0.8.7
+-- Privilege model:
+--   llm          → Chat only
+--   llm_dev      → + IDE button
+--   llm_worldedit → + WE Single/Loop + Mats + Undo
+--   llm_root     → Superrole: implies all of the above + Config button
+
+local core = core
+local M = {}
+
+local mod_path = core.get_modpath("llm_connect")
+
+local context_ok, chat_context = pcall(dofile, mod_path .. "/chat_context.lua")
+if not context_ok then
+    core.log("error", "[chat_gui] Failed to load chat_context.lua: " .. tostring(chat_context))
+    chat_context = nil
+end
+
+-- material_picker: prefer already-loaded global, fallback to dofile
+local material_picker = _G.material_picker
+if not material_picker then
+    local ok, mp = pcall(dofile, mod_path .. "/material_picker.lua")
+    if ok and mp then
+        material_picker = mp
+    else
+        core.log("warning", "[chat_gui] material_picker not available: " .. tostring(mp))
+    end
+end
+
+local function get_llm_api()
+    if not _G.llm_api then error("[chat_gui] llm_api not available") end
+    return _G.llm_api
+end
+
+-- ============================================================
+-- Privilege helpers
+-- llm_root is a super-role: implies llm + llm_dev + llm_worldedit
+-- ============================================================
+
+local function raw_priv(name, priv)
+    local p = core.get_player_privs(name) or {}
+    return p[priv] == true
+end
+
+local function has_priv(name, priv)
+    if raw_priv(name, "llm_root") then return true end
+    return raw_priv(name, priv)
+end
+
+local function can_chat(name)       return has_priv(name, "llm") end
+local function can_ide(name)        return has_priv(name, "llm_dev") end
+local function can_worldedit(name)  return has_priv(name, "llm_worldedit") end
+local function can_config(name)     return raw_priv(name, "llm_root") end  -- root only, no implication upward
+
+-- ============================================================
+-- Session
+-- ============================================================
+
+local sessions = {}
+
+local WE_MODE_LABEL = {chat="Chat", single="WE Single", loop="WE Loop"}
+local WE_MODE_COLOR = {chat="#444455", single="#2a4a6a", loop="#4a2a6a"}
+local WE_MODE_COLOR_UNAVAIL = "#333333"
+
+local function get_session(name)
+    if not sessions[name] then
+        sessions[name] = {history={}, last_input="", we_mode="chat"}
+    end
+    return sessions[name]
+end
+
+local function we_available()
+    return type(_G.we_agency) == "table" and _G.we_agency.is_available()
+end
+
+local function cycle_we_mode(session, name)
+    if not we_available() then
+        core.chat_send_player(name, "[LLM] WorldEdit not available.")
+        return
+    end
+    local cur = session.we_mode
+    if     cur == "chat"   then session.we_mode = "single"
+    elseif cur == "single" then session.we_mode = "loop"
+    elseif cur == "loop"   then session.we_mode = "chat"
+    end
+    core.chat_send_player(name, "[LLM] Mode: " .. WE_MODE_LABEL[session.we_mode])
+end
+
+-- ============================================================
+-- Build Formspec
+-- ============================================================
+
+function M.show(name)
+    if not can_chat(name) then
+        core.chat_send_player(name, "[LLM] Missing privilege: llm")
+        return
+    end
+
+    local session = get_session(name)
+    local text_accum = ""
+
+    for _, msg in ipairs(session.history) do
+        if msg.role ~= "system" then
+            local content = msg.content or ""
+            if msg.role == "user" then
+                text_accum = text_accum .. "You: " .. content .. "\n\n"
+            else
+                text_accum = text_accum .. "[LLM]: " .. content .. "\n\n"
+            end
+        end
+    end
+    if text_accum == "" then
+        text_accum = "Welcome to LLM Chat!\nType your question below."
+    end
+
+    local W        = 16.0
+    local H        = 12.0
+    local PAD      = 0.25
+    local HEADER_H = 1.8
+    local INPUT_H  = 0.7
+    local CHAT_H   = H - HEADER_H - INPUT_H - (PAD * 6)
+
+    local fs = {
+        "formspec_version[6]",
+        "size[" .. W .. "," .. H .. "]",
+        "bgcolor[#0f0f0f;both]",
+        "style_type[*;bgcolor=#1a1a1a;textcolor=#e0e0e0]",
+    }
+
+    -- Header box
+    table.insert(fs, "box[0,0;" .. W .. "," .. HEADER_H .. ";#202020]")
+    table.insert(fs, "label[" .. PAD .. ",0.30;LLM Chat - " .. core.formspec_escape(name) .. "]")
+
+    -- ── Header row 1 right side: Config (root) + IDE (dev) ────
+    local right_x = W - PAD
+    if can_config(name) then
+        right_x = right_x - 2.0
+        table.insert(fs, "style[open_config;bgcolor=#2a2a1a;textcolor=#ffeeaa]")
+        table.insert(fs, "button[" .. right_x .. ",0.08;2.0,0.65;open_config;Config]")
+        table.insert(fs, "tooltip[open_config;Open LLM configuration (llm_root only)]")
+    end
+    if can_ide(name) then
+        right_x = right_x - 2.3 - 0.15
+        table.insert(fs, "style[open_ide;bgcolor=#1a1a2a;textcolor=#aaaaff]")
+        table.insert(fs, "button[" .. right_x .. ",0.08;2.3,0.65;open_ide;IDE]")
+        table.insert(fs, "tooltip[open_ide;Open Smart Lua IDE (llm_dev)]")
+    end
+
+    -- Header row 2: three direct WE-Mode buttons side by side
+    local mode = session.we_mode or "chat"
+    if can_worldedit(name) then
+        local we_ok = we_available()
+        local dim = "#2a2a2a"
+
+        local function we_btn(bname, bx, bw, blabel, active, color_on, color_dim, tip)
+            local bg  = we_ok and (active and color_on or color_dim) or dim
+            local fg  = active and "#ffffff" or (we_ok and "#889999" or "#555555")
+            table.insert(fs, "style[" .. bname .. ";bgcolor=" .. bg .. ";textcolor=" .. fg .. "]")
+            table.insert(fs, "button[" .. bx .. ",0.95;" .. bw .. ",0.65;" .. bname .. ";" .. blabel .. "]")
+            table.insert(fs, "tooltip[" .. bname .. ";" .. (we_ok and tip or "WorldEdit not loaded") .. "]")
+        end
+
+        we_btn("we_btn_chat",   PAD,        2.6, "Chat",      mode=="chat",   "#444466", "#1e1e2e", "Normal LLM chat mode")
+        we_btn("we_btn_single", PAD + 2.7,  2.8, "WE Single", mode=="single", "#2a4a7a", "#151d2a", "WorldEdit: one plan per message")
+        we_btn("we_btn_loop",   PAD + 5.6,  2.6, "WE Loop",   mode=="loop",   "#4a2a7a", "#1e1228", "WorldEdit: iterative build loop (up to 6 steps)")
+
+        if mode == "single" or mode == "loop" then
+            local mat_count = material_picker and #material_picker.get_materials(name) or 0
+            local mat_label = mat_count > 0 and ("Mats (" .. mat_count .. ")") or "Mats"
+            local mat_color = mat_count > 0 and "#1a3a1a" or "#252525"
+            table.insert(fs, "style[we_materials_open;bgcolor=" .. mat_color .. ";textcolor=#aaffaa]")
+            table.insert(fs, "button[" .. (PAD + 8.3) .. ",0.95;2.6,0.65;we_materials_open;" .. mat_label .. "]")
+            table.insert(fs, "tooltip[we_materials_open;Material picker: attach node names to LLM context]")
+        end
+
+        table.insert(fs, "style[we_undo;bgcolor=#3a2020;textcolor=#ffaaaa]")
+        table.insert(fs, "button[" .. (W - PAD - 2.1) .. ",0.95;2.1,0.65;we_undo;Undo]")
+        table.insert(fs, "tooltip[we_undo;Undo last WorldEdit agency operation]")
+    end
+
+    -- Chat history
+    table.insert(fs, "textarea[" .. PAD .. "," .. (HEADER_H + PAD) .. ";"
+        .. (W - PAD*2) .. "," .. CHAT_H
+        .. ";history_display;;" .. core.formspec_escape(text_accum) .. "]")
+    table.insert(fs, "style[history_display;textcolor=#e0e0e0;bgcolor=#1a1a1a;border=false]")
+
+    -- Input
+    local input_y = HEADER_H + PAD + CHAT_H + PAD
+    table.insert(fs, "field[" .. PAD .. "," .. input_y .. ";"
+        .. (W - PAD*2 - 2.5) .. "," .. INPUT_H
+        .. ";input;;" .. core.formspec_escape(session.last_input) .. "]")
+    table.insert(fs, "button[" .. (W - PAD - 2.2) .. "," .. input_y
+        .. ";2.2," .. INPUT_H .. ";send;Send]")
+    table.insert(fs, "field_close_on_enter[input;false]")
+
+    -- Toolbar
+    local tb_y = input_y + INPUT_H + PAD
+    table.insert(fs, "button[" .. PAD .. "," .. tb_y .. ";2.8,0.75;clear;Clear Chat]")
+
+    core.show_formspec(name, "llm_connect:chat", table.concat(fs))
+end
+
+-- ============================================================
+-- Formspec Handler
+-- ============================================================
+
+function M.handle_fields(name, formname, fields)
+    -- Forward to Material Picker
+    if formname:match("^llm_connect:material_picker") then
+        if material_picker then
+            local result = material_picker.handle_fields(name, formname, fields)
+            if fields.close_picker or fields.close_and_back or fields.quit then
+                M.show(name)
+            end
+            return result
+        end
+        return false
+    end
+
+    if not formname:match("^llm_connect:chat") then return false end
+
+    local session = get_session(name)
+    local updated = false
+
+    -- ── WE-Buttons (privilege-checked) ──────────────────────
+
+    if fields.we_btn_chat then
+        if can_worldedit(name) then session.we_mode = "chat"; updated = true end
+    elseif fields.we_btn_single then
+        if can_worldedit(name) and we_available() then session.we_mode = "single"; updated = true end
+    elseif fields.we_btn_loop then
+        if can_worldedit(name) and we_available() then session.we_mode = "loop"; updated = true end
+
+    elseif fields.we_materials_open then
+        if can_worldedit(name) and material_picker then
+            material_picker.show(name)
+        end
+        return true
+
+    elseif fields.we_undo then
+        if can_worldedit(name) and _G.we_agency then
+            local res = _G.we_agency.undo(name)
+            table.insert(session.history, {role="assistant",
+                content=(res.ok and "Undo: " or "Error: ") .. res.message})
+            updated = true
+        end
+
+    -- ── IDE / Config (privilege-checked) ────────────────────
+
+    elseif fields.open_ide then
+        if can_ide(name) and _G.ide_gui then
+            _G.ide_gui.show(name)
+        end
+        return true
+
+    elseif fields.open_config then
+        if can_config(name) and _G.config_gui then
+            _G.config_gui.show(name)
+        end
+        return true
+
+    -- ── Send ────────────────────────────────────────────────
+
+    elseif fields.send or fields.key_enter_field == "input" then
+        local input = (fields.input or ""):trim()
+
+        if input ~= "" then
+            table.insert(session.history, {role="user", content=input})
+            session.last_input = ""
+
+            -- WE Loop (nur llm_worldedit)
+            if session.we_mode == "loop" and can_worldedit(name) and we_available() then
+                table.insert(session.history, {role="assistant", content="(starting WE loop...)"})
+                updated = true
+                local mat_ctx = material_picker and material_picker.build_material_context(name)
+                local loop_input = mat_ctx and (input .. "\n\n" .. mat_ctx) or input
+                _G.we_agency.run_loop(name, loop_input, {
+                    max_iterations = (_G.llm_api and _G.llm_api.config.we_max_iterations or 6),
+                    timeout = (_G.llm_api and _G.llm_api.get_timeout("we") or 90),
+                    on_step = function(i, plan, results)
+                        local lines = {"[WE Loop] Step " .. i .. ": " .. plan}
+                        for _, r in ipairs(results) do
+                            table.insert(lines, "  " .. (r.ok and "v" or "x") .. " " .. r.tool .. ": " .. r.message)
+                        end
+                        core.chat_send_player(name, table.concat(lines, "\n"))
+                    end,
+                }, function(res)
+                    local reply = _G.we_agency.format_loop_results(res)
+                    for i = #session.history, 1, -1 do
+                        if session.history[i].content == "(starting WE loop...)" then
+                            session.history[i].content = reply; break
+                        end
+                    end
+                    M.show(name)
+                end)
+
+            -- WE Single (nur llm_worldedit)
+            elseif session.we_mode == "single" and can_worldedit(name) and we_available() then
+                table.insert(session.history, {role="assistant", content="(planning WE operations...)"})
+                updated = true
+                local mat_ctx = material_picker and material_picker.build_material_context(name)
+                local single_input = mat_ctx and (input .. "\n\n" .. mat_ctx) or input
+                _G.we_agency.request(name, single_input, function(res)
+                    local reply = not res.ok
+                        and ("Error: " .. (res.error or "unknown"))
+                        or  _G.we_agency.format_results(res.plan, res.results)
+                    for i = #session.history, 1, -1 do
+                        if session.history[i].content == "(planning WE operations...)" then
+                            session.history[i].content = reply; break
+                        end
+                    end
+                    M.show(name)
+                end)
+
+            -- Normal Chat (always allowed if llm privilege is present)
+            else
+                -- Reset WE-mode if player lacks privilege
+                if session.we_mode ~= "chat" and not can_worldedit(name) then
+                    session.we_mode = "chat"
+                end
+                local messages = {}
+                local context_added = false
+                if chat_context then
+                    messages = chat_context.append_context(messages, name)
+                    if #messages > 0 and messages[1].role == "system" then context_added = true end
+                end
+                if not context_added then
+                    table.insert(messages, 1, {role="system",
+                        content="You are a helpful assistant in the Luanti/Minetest game."})
+                end
+                for _, msg in ipairs(session.history) do table.insert(messages, msg) end
+                table.insert(session.history, {role="assistant", content="(thinking...)"})
+                updated = true
+                local llm_api = get_llm_api()
+                llm_api.request(messages, function(result)
+                    local content = result.success and result.content
+                        or "Error: " .. (result.error or "Unknown error")
+                    for i = #session.history, 1, -1 do
+                        if session.history[i].content == "(thinking...)" then
+                            session.history[i].content = content; break
+                        end
+                    end
+                    M.show(name)
+                end, {timeout = (_G.llm_api and _G.llm_api.get_timeout("chat") or 180)})
+            end
+        end
+
+    -- ── Clear ───────────────────────────────────────────────
+
+    elseif fields.clear then
+        session.history = {}
+        session.last_input = ""
+        updated = true
+
+    elseif fields.quit then
+        return true
+    end
+
+    if updated then M.show(name) end
+    return true
+end
+
+core.register_on_leaveplayer(function(player)
+    sessions[player:get_player_name()] = nil
+end)
+
+return M

code_executor.lua

@@ -0,0 +1,298 @@
+-- code_executor.lua
+-- Secure Lua code execution for LLM-Connect / Smart Lua IDE
+-- Privileges:
+--   llm_dev  → Sandbox + Whitelist, no persistent registrations
+--   llm_root → Unrestricted execution + persistent registrations possible
+
+local core = core
+local M = {}
+
+M.execution_history = {}  -- per player: {timestamp, code_snippet, success, output/error}
+
+local STARTUP_FILE = core.get_worldpath() .. DIR_DELIM .. "llm_startup.lua"
+
+-- =============================================================
+--  Helper functions
+-- =============================================================
+
+local function player_has_priv(name, priv)
+    local privs = core.get_player_privs(name) or {}
+    return privs[priv] == true
+end
+
+-- llm_root is a super-role: implies llm_dev and all others
+local function has_llm_priv(name, priv)
+    if player_has_priv(name, "llm_root") then return true end
+    return player_has_priv(name, priv)
+end
+
+local function is_llm_root(name)
+    return player_has_priv(name, "llm_root")
+end
+
+-- =============================================================
+--  Sandbox environment (for normal llm_dev / llm users)
+-- =============================================================
+
+local function create_sandbox_env(player_name)
+    local safe_core = {
+        -- Logging & Chat
+        log               = core.log,
+        chat_send_player  = core.chat_send_player,
+
+        -- Secure read access
+        get_node          = core.get_node,
+        get_node_or_nil   = core.get_node_or_nil,
+        find_node_near    = core.find_node_near,
+        find_nodes_in_area = core.find_nodes_in_area,
+        get_meta          = core.get_meta,
+        get_player_by_name = core.get_player_by_name,
+        get_connected_players = core.get_connected_players,
+    }
+
+    -- Block registration functions (require restart)
+    local function blocked_registration(name)
+        return function(...)
+            core.log("warning", ("[code_executor] Blocked registration call: %s by %s"):format(name, player_name))
+            core.chat_send_player(player_name, "Registrations are forbidden in sandbox mode.\nOnly llm_root may execute these persistently.")
+            return nil
+        end
+    end
+
+    safe_core.register_node      = blocked_registration("register_node")
+    safe_core.register_craftitem = blocked_registration("register_craftitem")
+    safe_core.register_tool      = blocked_registration("register_tool")
+    safe_core.register_craft     = blocked_registration("register_craft")
+    safe_core.register_entity    = blocked_registration("register_entity")
+
+    -- Allowed dynamic registrations (very restricted)
+    safe_core.register_chatcommand    = core.register_chatcommand
+    safe_core.register_on_chat_message = core.register_on_chat_message
+
+    -- Safe standard libraries (without dangerous functions)
+    local env = {
+        -- Lua basics
+        assert  = assert,
+        error   = error,
+        pairs   = pairs,
+        ipairs  = ipairs,
+        next    = next,
+        select  = select,
+        type    = type,
+        tostring = tostring,
+        tonumber = tonumber,
+        unpack  = table.unpack or unpack,
+
+        -- Safe string/table/math functions
+        string  = { byte=string.byte, char=string.char, find=string.find, format=string.format,
+                    gmatch=string.gmatch, gsub=string.gsub, len=string.len, lower=string.lower,
+                    match=string.match, rep=string.rep, reverse=string.reverse, sub=string.sub,
+                    upper=string.upper },
+        table   = { concat=table.concat, insert=table.insert, remove=table.remove, sort=table.sort },
+        math    = math,
+
+        -- Minetest-safe API
+        core    = safe_core,
+
+        -- Redirect print
+        print   = function(...) end,   -- will be overwritten later
+    }
+
+    -- Output buffer with limit
+    local output_buffer = {}
+    local output_size = 0
+    local MAX_OUTPUT = 100000  -- ~100 KB
+
+    env.print = function(...)
+        local parts = {}
+        for i = 1, select("#", ...) do
+            parts[i] = tostring(select(i, ...))
+        end
+        local line = table.concat(parts, "\t")
+
+        if output_size + #line > MAX_OUTPUT then
+            table.insert(output_buffer, "\n[OUTPUT TRUNCATED – 100 KB limit reached]")
+            return
+        end
+
+        table.insert(output_buffer, line)
+        output_size = output_size + #line
+    end
+
+    return env, output_buffer
+end
+
+-- =============================================================
+--  Append persistent startup code (llm_root only)
+-- =============================================================
+
+local function append_to_startup(code, player_name)
+    local f, err = io.open(STARTUP_FILE, "a")
+    if not f then
+        core.log("error", ("[code_executor] Cannot open startup file: %s"):format(tostring(err)))
+        return false, err
+    end
+
+    f:write(("\n-- Added by %s at %s\n"):format(player_name, os.date("%Y-%m-%d %H:%M:%S")))
+    f:write(code)
+    f:write("\n\n")
+    f:close()
+
+    core.log("action", ("[code_executor] Appended code to %s by %s"):format(STARTUP_FILE, player_name))
+    return true
+end
+
+-- =============================================================
+--  Main execution function
+-- =============================================================
+
+function M.execute(player_name, code, options)
+    options = options or {}
+    local result = { success = false }
+
+    if type(code) ~= "string" or code:trim() == "" then
+        result.error = "No or empty code provided"
+        return result
+    end
+
+    local is_root = is_llm_root(player_name)
+    local use_sandbox   = options.sandbox ~= false
+    local allow_persist = options.allow_persist or is_root
+
+    -- Check whether the player has execution rights at all
+    if not has_llm_priv(player_name, "llm_dev") then
+        result.error = "Missing privilege: llm_dev (or llm_root)"
+        return result
+    end
+
+    -- =============================================
+    --  1. Compile
+    -- =============================================
+    local func, compile_err = loadstring(code, "=(llm_ide)")
+    if not func then
+        result.error = "Compile error: " .. tostring(compile_err)
+        core.log("warning", ("[code_executor] Compile failed for %s: %s"):format(player_name, result.error))
+        return result
+    end
+
+    -- =============================================
+    --  2. Prepare environment & print redirection
+    -- =============================================
+    local output_buffer = {}
+    local env
+
+    if use_sandbox then
+        env, output_buffer = create_sandbox_env(player_name)
+        setfenv(func, env)   -- Lua 5.1 compatibility (Luanti mostly uses LuaJIT)
+    else
+        -- Unrestricted mode → Careful!
+        if not is_root then
+            result.error = "Unrestricted execution only allowed for llm_root"
+            return result
+        end
+
+        -- Redirect print (without overwriting _G)
+        local old_print = print
+        print = function(...)
+            local parts = {}
+            for i = 1, select("#", ...) do parts[#parts+1] = tostring(select(i, ...)) end
+            local line = table.concat(parts, "\t")
+            table.insert(output_buffer, line)
+        end
+    end
+
+    -- =============================================
+    --  3. Execute (with instruction limit)
+    -- =============================================
+    local ok, exec_res = pcall(function()
+        -- Instruction limit could be added here later (currently dummy)
+        return func()
+    end)
+
+    -- Reset print (if unrestricted)
+    if not use_sandbox then
+        print = old_print
+    end
+
+    -- =============================================
+    --  4. Process result
+    -- =============================================
+    result.output = table.concat(output_buffer, "\n")
+
+    if ok then
+        result.success = true
+        result.return_value = exec_res
+
+        core.log("action", ("[code_executor] Success by %s (sandbox=%s)"):format(player_name, tostring(use_sandbox)))
+    else
+        result.error = "Runtime error: " .. tostring(exec_res)
+        core.log("warning", ("[code_executor] Execution failed for %s: %s"):format(player_name, result.error))
+    end
+
+    -- =============================================
+    --  5. Check for registrations → Persistence?
+    -- =============================================
+    local has_registration = code:match("register_node%s*%(")     or
+                             code:match("register_tool%s*%(")      or
+                             code:match("register_craftitem%s*%(") or
+                             code:match("register_entity%s*%(")    or
+                             code:match("register_craft%s*%(")
+
+    if has_registration then
+        if allow_persist and is_root then
+            local saved, save_err = append_to_startup(code, player_name)
+            if saved then
+                local msg = "Code with registrations saved to llm_startup.lua.\nWill be active after server restart."
+                core.chat_send_player(player_name, msg)
+                result.output = (result.output or "") .. "\n\n" .. msg
+                result.persisted = true
+            else
+                result.error = (result.error or "") .. "\nPersistence failed: " .. tostring(save_err)
+            end
+        else
+            local msg = "Code contains registrations (node/tool/...). \nOnly llm_root can execute these persistently (restart required)."
+            core.chat_send_player(player_name, msg)
+            result.error = (result.error or "") .. "\n" .. msg
+            result.success = false   -- even if execution was ok
+        end
+    end
+
+    -- Save history
+    M.execution_history[player_name] = M.execution_history[player_name] or {}
+    table.insert(M.execution_history[player_name], {
+        timestamp = os.time(),
+        code      = code:sub(1, 200) .. (code:len() > 200 and "..." or ""),
+        success   = result.success,
+        output    = result.output,
+        error     = result.error,
+    })
+
+    return result
+end
+
+-- =============================================================
+--  History functions
+-- =============================================================
+
+function M.get_history(player_name, limit)
+    limit = limit or 10
+    local hist = M.execution_history[player_name] or {}
+    local res = {}
+    local start = math.max(1, #hist - limit + 1)
+    for i = start, #hist do
+        res[#res+1] = hist[i]
+    end
+    return res
+end
+
+function M.clear_history(player_name)
+    M.execution_history[player_name] = nil
+end
+
+-- Cleanup
+core.register_on_leaveplayer(function(player)
+    local name = player:get_player_name()
+    M.execution_history[name] = nil
+end)
+
+return M

config_gui.lua

@@ -0,0 +1,255 @@
+-- config_gui.lua
+-- LLM API Configuration GUI (llm_root only)
+-- v0.8.1: Added timeout field for better control
+
+local core = core
+local M = {}
+
+local function has_priv(name, priv)
+    local p = core.get_player_privs(name) or {}
+    return p[priv] == true
+end
+
+local function get_llm_api()
+    if not _G.llm_api then
+        error("[config_gui] llm_api not available")
+    end
+    return _G.llm_api
+end
+
+function M.show(name)
+    if not has_priv(name, "llm_root") then
+        core.chat_send_player(name, "Missing privilege: llm_root")
+        return
+    end
+
+    local llm_api = get_llm_api()
+    local cfg = llm_api.config
+
+    local W, H = 14.0, 14.5
+    local PAD = 0.3
+    local HEADER_H = 0.8
+    local FIELD_H = 0.8
+    local BTN_H = 0.9
+
+    local fs = {
+        "formspec_version[6]",
+        "size[" .. W .. "," .. H .. "]",
+        "bgcolor[#0f0f0f;both]",
+        "style_type[*;bgcolor=#1a1a1a;textcolor=#e0e0e0;font=mono]",
+    }
+
+    -- Header
+    table.insert(fs, "box[0,0;" .. W .. "," .. HEADER_H .. ";#202020]")
+    table.insert(fs, "label[" .. PAD .. "," .. (HEADER_H/2 - 0.2) .. ";LLM Configuration (llm_root only)]")
+    table.insert(fs, "label[" .. (W - 4) .. "," .. (HEADER_H/2 - 0.2) .. ";" .. os.date("%H:%M") .. "]")
+
+    local y = HEADER_H + PAD * 2
+
+    -- API Key
+    table.insert(fs, "label[" .. PAD .. "," .. y .. ";API Key:]")
+    y = y + 0.5
+    table.insert(fs, "field[" .. PAD .. "," .. y .. ";" .. (W - PAD*2) .. "," .. FIELD_H .. ";api_key;;" .. core.formspec_escape(cfg.api_key or "") .. "]")
+    table.insert(fs, "style[api_key;bgcolor=#1e1e1e]")
+    y = y + FIELD_H + PAD
+
+    -- API URL
+    table.insert(fs, "label[" .. PAD .. "," .. y .. ";API URL:]")
+    y = y + 0.5
+    table.insert(fs, "field[" .. PAD .. "," .. y .. ";" .. (W - PAD*2) .. "," .. FIELD_H .. ";api_url;;" .. core.formspec_escape(cfg.api_url or "") .. "]")
+    table.insert(fs, "style[api_url;bgcolor=#1e1e1e]")
+    y = y + FIELD_H + PAD
+
+    -- Model
+    table.insert(fs, "label[" .. PAD .. "," .. y .. ";Model:]")
+    y = y + 0.5
+    table.insert(fs, "field[" .. PAD .. "," .. y .. ";" .. (W - PAD*2) .. "," .. FIELD_H .. ";model;;" .. core.formspec_escape(cfg.model or "") .. "]")
+    table.insert(fs, "style[model;bgcolor=#1e1e1e]")
+    y = y + FIELD_H + PAD
+
+    -- Max Tokens & Temperature (side by side)
+    table.insert(fs, "label[" .. PAD .. "," .. y .. ";Max Tokens:]")
+    table.insert(fs, "label[" .. (W/2 + PAD) .. "," .. y .. ";Temperature:]")
+    y = y + 0.5
+
+    local half_w = (W - PAD*3) / 2
+    table.insert(fs, "field[" .. PAD .. "," .. y .. ";" .. half_w .. "," .. FIELD_H .. ";max_tokens;;" .. tostring(cfg.max_tokens or 4000) .. "]")
+    table.insert(fs, "style[max_tokens;bgcolor=#1e1e1e]")
+
+    table.insert(fs, "field[" .. (W/2 + PAD) .. "," .. y .. ";" .. half_w .. "," .. FIELD_H .. ";temperature;;" .. tostring(cfg.temperature or 0.7) .. "]")
+    table.insert(fs, "style[temperature;bgcolor=#1e1e1e]")
+    y = y + FIELD_H + PAD
+
+    -- Timeout field (new in v0.8.1)
+    table.insert(fs, "label[" .. PAD .. "," .. y .. ";Timeout (seconds):]")
+    y = y + 0.5
+    table.insert(fs, "field[" .. PAD .. "," .. y .. ";" .. half_w .. "," .. FIELD_H .. ";timeout;;" .. tostring(cfg.timeout or 120) .. "]")
+    table.insert(fs, "style[timeout;bgcolor=#1e1e1e]")
+    table.insert(fs, "tooltip[timeout;Global fallback timeout (30-600s). Per-mode overrides below override this.]")
+    y = y + FIELD_H + PAD
+
+    -- Per-mode timeout overrides
+    table.insert(fs, "label[" .. PAD .. "," .. y .. ";Per-mode timeout overrides (0 = use global):]")
+    y = y + 0.5
+    local third_w = (W - PAD * 2 - 0.2 * 2) / 3
+    local function tx(i) return PAD + i * (third_w + 0.2) end
+
+    table.insert(fs, "label[" .. tx(0) .. "," .. y .. ";Chat:]")
+    table.insert(fs, "label[" .. tx(1) .. "," .. y .. ";IDE:]")
+    table.insert(fs, "label[" .. tx(2) .. "," .. y .. ";WorldEdit:]")
+    y = y + 0.45
+
+    table.insert(fs, "field[" .. string.format("%.2f", tx(0)) .. "," .. y .. ";" .. string.format("%.2f", third_w) .. "," .. FIELD_H .. ";timeout_chat;;" .. tostring(cfg.timeout_chat or 0) .. "]")
+    table.insert(fs, "style[timeout_chat;bgcolor=#1e1e1e]")
+    table.insert(fs, "tooltip[timeout_chat;Chat mode timeout (0 = global)]")
+
+    table.insert(fs, "field[" .. string.format("%.2f", tx(1)) .. "," .. y .. ";" .. string.format("%.2f", third_w) .. "," .. FIELD_H .. ";timeout_ide;;" .. tostring(cfg.timeout_ide or 0) .. "]")
+    table.insert(fs, "style[timeout_ide;bgcolor=#1e1e1e]")
+    table.insert(fs, "tooltip[timeout_ide;IDE mode timeout (0 = global)]")
+
+    table.insert(fs, "field[" .. string.format("%.2f", tx(2)) .. "," .. y .. ";" .. string.format("%.2f", third_w) .. "," .. FIELD_H .. ";timeout_we;;" .. tostring(cfg.timeout_we or 0) .. "]")
+    table.insert(fs, "style[timeout_we;bgcolor=#1e1e1e]")
+    table.insert(fs, "tooltip[timeout_we;WorldEdit mode timeout (0 = global)]")
+    y = y + FIELD_H + PAD * 2
+
+    -- WEA toggle + separator
+    table.insert(fs, "box[" .. PAD .. "," .. y .. ";" .. (W - PAD*2) .. ",0.02;#333333]")
+    y = y + 0.18
+    local wea_val = core.settings:get_bool("llm_worldedit_additions", true)
+    local wea_label = "Enable WorldEditAdditions tools (torus, ellipsoid, erode, convolve...)"
+    local wea_is_installed = type(worldeditadditions) == "table"
+    if not wea_is_installed then
+        wea_label = wea_label .. "  [WEA mod not detected]"
+    end
+    table.insert(fs, "checkbox[" .. PAD .. "," .. y .. ";wea_enabled;" .. core.formspec_escape(wea_label) .. ";" .. (wea_val and "true" or "false") .. "]")
+    y = y + 0.55 + PAD
+
+    -- 4 buttons evenly distributed: Save, Reload, Test, Close
+    local btn_count   = 4
+    local btn_spacing = 0.2
+    local btn_w       = (W - PAD * 2 - btn_spacing * (btn_count - 1)) / btn_count
+    local function bx(i) return PAD + i * (btn_w + btn_spacing) end
+
+    table.insert(fs, "button["  .. string.format("%.2f", bx(0)) .. "," .. y .. ";" .. string.format("%.2f", btn_w) .. "," .. BTN_H .. ";save;Save Config]")
+    table.insert(fs, "button["  .. string.format("%.2f", bx(1)) .. "," .. y .. ";" .. string.format("%.2f", btn_w) .. "," .. BTN_H .. ";reload;Reload]")
+    table.insert(fs, "button["  .. string.format("%.2f", bx(2)) .. "," .. y .. ";" .. string.format("%.2f", btn_w) .. "," .. BTN_H .. ";test;Test Connection]")
+    table.insert(fs, "style[close;bgcolor=#3a1a1a;textcolor=#ffaaaa]")
+    table.insert(fs, "button["  .. string.format("%.2f", bx(3)) .. "," .. y .. ";" .. string.format("%.2f", btn_w) .. "," .. BTN_H .. ";close;✕ Close]")
+    y = y + BTN_H + PAD
+
+    -- Info label
+    table.insert(fs, "label[" .. PAD .. "," .. y .. ";Note: Runtime changes. Edit minetest.conf for persistence.]")
+
+    core.show_formspec(name, "llm_connect:config", table.concat(fs))
+end
+
+function M.handle_fields(name, formname, fields)
+    if not formname:match("^llm_connect:config") then
+        return false
+    end
+
+    if not has_priv(name, "llm_root") then
+        return true
+    end
+
+    local llm_api = get_llm_api()
+
+    -- WEA checkbox: instant toggle (no Save needed)
+    if fields.wea_enabled ~= nil then
+        local val = fields.wea_enabled == "true"
+        core.settings:set_bool("llm_worldedit_additions", val)
+        core.chat_send_player(name, "[LLM] WorldEditAdditions tools: " .. (val and "enabled" or "disabled"))
+        M.show(name)
+        return true
+    end
+
+    if fields.save then
+        -- Validation
+        local max_tokens = tonumber(fields.max_tokens)
+        local temperature = tonumber(fields.temperature)
+        local timeout = tonumber(fields.timeout)
+
+        if not max_tokens or max_tokens < 1 or max_tokens > 100000 then
+            core.chat_send_player(name, "[LLM] Error: max_tokens must be between 1 and 100000")
+            return true
+        end
+
+        if not temperature or temperature < 0 or temperature > 2 then
+            core.chat_send_player(name, "[LLM] Error: temperature must be between 0 and 2")
+            return true
+        end
+
+        if not timeout or timeout < 30 or timeout > 600 then
+            core.chat_send_player(name, "[LLM] Error: timeout must be between 30 and 600 seconds")
+            return true
+        end
+
+        local timeout_chat = tonumber(fields.timeout_chat) or 0
+        local timeout_ide  = tonumber(fields.timeout_ide)  or 0
+        local timeout_we   = tonumber(fields.timeout_we)   or 0
+
+        for _, t in ipairs({timeout_chat, timeout_ide, timeout_we}) do
+            if t ~= 0 and (t < 30 or t > 600) then
+                core.chat_send_player(name, "[LLM] Error: per-mode timeouts must be 0 or between 30-600")
+                return true
+            end
+        end
+
+        llm_api.set_config({
+            api_key = fields.api_key or "",
+            api_url = fields.api_url or "",
+            model = fields.model or "",
+            max_tokens = max_tokens,
+            temperature = temperature,
+            timeout = timeout,
+            timeout_chat = timeout_chat,
+            timeout_ide  = timeout_ide,
+            timeout_we   = timeout_we,
+        })
+
+        core.chat_send_player(name, "[LLM] Configuration updated (runtime only)")
+        core.log("action", "[llm_connect] Config updated by " .. name)
+        M.show(name)
+        return true
+
+    elseif fields.reload then
+        llm_api.reload_config()
+        core.chat_send_player(name, "[LLM] Configuration reloaded from settings")
+        core.log("action", "[llm_connect] Config reloaded by " .. name)
+        M.show(name)
+        return true
+
+    elseif fields.test then
+        -- Test LLM connection with a simple request
+        core.chat_send_player(name, "[LLM] Testing connection...")
+        
+        local messages = {
+            {role = "user", content = "Reply with just the word 'OK' if you can read this."}
+        }
+        
+        llm_api.request(messages, function(result)
+            if result.success then
+                core.chat_send_player(name, "[LLM] ✓ Connection test successful!")
+                core.chat_send_player(name, "[LLM] Response: " .. (result.content or "No content"))
+            else
+                core.chat_send_player(name, "[LLM] ✗ Connection test failed!")
+                core.chat_send_player(name, "[LLM] Error: " .. (result.error or "Unknown error"))
+            end
+        end, {timeout = 30})
+        
+        return true
+
+    elseif fields.close or fields.quit then
+        -- Return to chat_gui
+        if _G.chat_gui then
+            _G.chat_gui.show(name)
+        else
+            core.close_formspec(name, "llm_connect:config")
+        end
+        return true
+    end
+
+    return true
+end
+
+return M

ide_gui.lua

@@ -0,0 +1,671 @@
+-- ide_gui.lua
+-- Smart Lua IDE interface for LLM-Connect
+-- v0.9.0: File manager with dropdown, save/load from dedicated snippets folder
+
+local core = core
+local M = {}
+
+-- ======================================================
+-- File Storage
+-- ======================================================
+
+-- Resolve paths at load time (like sethome/init.lua does) – NOT lazily at runtime.
+-- Under mod security, io.open works reliably when called with paths
+-- resolved during the mod loading phase.
+local SNIPPETS_DIR = (core.get_worldpath or minetest.get_worldpath)() .. "/" .. "llm_snippets"
+local MKDIR_FN     = core.mkdir or minetest.mkdir
+
+-- Create snippets dir immediately at load time
+if MKDIR_FN then
+    MKDIR_FN(SNIPPETS_DIR)
+else
+    core.log("warning", "[ide_gui] mkdir not available – snippets dir may not exist")
+end
+
+core.log("action", "[ide_gui] snippets dir: " .. SNIPPETS_DIR)
+
+local function get_snippets_dir()
+    return SNIPPETS_DIR
+end
+
+local function ensure_snippets_dir()
+    -- Dir was already created at load time; this is now a no-op that just returns the path
+    return SNIPPETS_DIR
+end
+
+-- Index file tracks all saved snippets (avoids core.get_dir_list which is unreliable under mod security)
+local INDEX_PATH = SNIPPETS_DIR .. "/_index.txt"
+
+local function get_index_path()
+    return INDEX_PATH
+end
+
+local function read_index()
+    local path = get_index_path()
+    local f = io.open(path, "r")
+    if not f then return {} end
+    local files = {}
+    for line in f:lines() do
+        line = line:match("^%s*(.-)%s*$")
+        if line ~= "" then
+            table.insert(files, line)
+        end
+    end
+    f:close()
+    table.sort(files)
+    return files
+end
+
+local function write_index(files)
+    local path = get_index_path()
+    local sorted = {}
+    for _, v in ipairs(files) do table.insert(sorted, v) end
+    table.sort(sorted)
+    -- deduplicate
+    local seen = {}
+    local deduped = {}
+    for _, v in ipairs(sorted) do
+        if not seen[v] then seen[v] = true; table.insert(deduped, v) end
+    end
+    local ok = core.safe_file_write(path, table.concat(deduped, "\n"))
+    return ok
+end
+
+local function index_add(filename)
+    local files = read_index()
+    local exists = false
+    for _, v in ipairs(files) do
+        if v == filename then exists = true; break end
+    end
+    if not exists then
+        table.insert(files, filename)
+        write_index(files)
+    end
+end
+
+local function index_remove(filename)
+    local files = read_index()
+    local new = {}
+    for _, v in ipairs(files) do
+        if v ~= filename then table.insert(new, v) end
+    end
+    write_index(new)
+end
+
+-- One-time migration: if index is empty, probe known filenames via io.open
+-- and rebuild the index from whatever is actually on disk.
+-- Luanti doesn't give us reliable directory listing under mod security,
+-- so we use a best-effort scan of any names we can discover.
+local migration_done = false
+local function maybe_migrate()
+    if migration_done then return end
+    migration_done = true
+    local idx = read_index()
+    if #idx > 0 then return end  -- index already populated, nothing to do
+
+    -- We can't list the directory, but we can check for files the user
+    -- might have saved under common names in older versions.
+    local dir = ensure_snippets_dir()
+    local candidates = {"untitled.lua", "colorstones.lua", "test.lua", "init.lua", "startup.lua"}
+    local found = {}
+    for _, name in ipairs(candidates) do
+        local f = io.open(dir .. "/" .. name, "r")
+        if f then f:close(); table.insert(found, name) end
+    end
+    if #found > 0 then
+        write_index(found)
+        core.log("action", "[ide_gui] Migration: added " .. #found .. " existing snippets to index")
+    end
+end
+
+-- Public: returns sorted list of snippet filenames
+local function list_snippet_files()
+    maybe_migrate()
+    return read_index()
+end
+
+local function read_file(filepath)
+    local f, err = io.open(filepath, "r")
+    if not f then
+        core.log("warning", "[ide_gui] read_file failed: " .. tostring(filepath) .. " – " .. tostring(err))
+        return nil, err
+    end
+    local content = f:read("*a")
+    f:close()
+    return content
+end
+
+local function write_file(filepath, content)
+    -- core.safe_file_write does atomic write, preferred for snippets
+    local ok = core.safe_file_write(filepath, content)
+    if not ok then
+        -- fallback to io.open
+        local f, err = io.open(filepath, "w")
+        if not f then return false, err end
+        f:write(content)
+        f:close()
+    end
+    return true
+end
+
+-- ======================================================
+-- Module helpers
+-- ======================================================
+
+local function get_executor()
+    if not _G.executor then
+        error("[ide_gui] executor not available - init.lua failed?")
+    end
+    return _G.executor
+end
+
+local function get_llm_api()
+    if not _G.llm_api then
+        error("[ide_gui] llm_api not available - init.lua failed?")
+    end
+    return _G.llm_api
+end
+
+local prompts
+local function get_prompts()
+    if not prompts then
+        local ok, p = pcall(dofile, core.get_modpath("llm_connect") .. "/ide_system_prompts.lua")
+        if not ok then
+            core.log("error", "[ide_gui] Failed to load prompts: " .. tostring(p))
+            prompts = {
+                SYNTAX_FIXER      = "Fix syntax errors in this Lua/Minetest code. Return raw Lua only.",
+                SEMANTIC_ANALYZER = "Analyze this Minetest Lua code for logic errors.",
+                CODE_EXPLAINER    = "Explain this Minetest Lua code simply.",
+                CODE_GENERATOR    = "Generate clean Minetest Lua code based on the user request.",
+            }
+        else
+            prompts = p
+        end
+    end
+    return prompts
+end
+
+-- Session data per player
+local sessions = {}
+
+local DEFAULT_CODE = [[-- Welcome to Smart Lua IDE!
+-- Write your Luanti mod code here.
+
+core.register_node("example:test_node", {
+    description = "Test Node",
+    tiles = {"default_stone.png"},
+    groups = {cracky = 3},
+})
+]]
+
+local function get_session(name)
+    if not sessions[name] then
+        sessions[name] = {
+            code             = DEFAULT_CODE,
+            output           = "Ready!\nUse the toolbar buttons or type a prompt and click Generate.",
+            guiding_active   = false,  -- Naming guide toggle (off by default)
+            filename         = "untitled.lua",
+            pending_proposal = nil,
+            last_prompt      = "",
+            last_modified    = os.time(),
+            file_list        = {},
+            selected_file    = "",
+        }
+        sessions[name].file_list = list_snippet_files()
+    end
+    return sessions[name]
+end
+
+local function has_priv(name, priv)
+    local p = core.get_player_privs(name) or {}
+    return p[priv] == true
+end
+
+local function can_use_ide(name)
+    return has_priv(name, "llm_ide") or has_priv(name, "llm_dev") or has_priv(name, "llm_root")
+end
+
+local function can_execute(name)
+    return has_priv(name, "llm_dev") or has_priv(name, "llm_root")
+end
+
+local function is_root(name)
+    return has_priv(name, "llm_root")
+end
+
+-- ======================================================
+-- Main Formspec
+-- ======================================================
+
+function M.show(name)
+    if not can_use_ide(name) then
+        core.chat_send_player(name, "Missing privilege: llm_ide (or higher)")
+        return
+    end
+
+    local session = get_session(name)
+    -- Refresh file list on every render
+    session.file_list = list_snippet_files()
+
+    local code_esc   = core.formspec_escape(session.code or "")
+    local output_esc = core.formspec_escape(session.output or "")
+    local fn_esc     = core.formspec_escape(session.filename or "untitled.lua")
+    local prompt_esc = core.formspec_escape(session.last_prompt or "")
+
+    local W, H     = 19.2, 13.0
+    local PAD      = 0.2
+    local HEADER_H = 0.8
+    local TOOL_H   = 0.9
+    local FILE_H   = 0.9
+    local PROMPT_H = 0.8
+    local STATUS_H = 0.6
+
+    local tool_y   = HEADER_H + PAD
+    local file_y   = tool_y + TOOL_H + PAD
+    local prompt_y = file_y + FILE_H + PAD
+    local work_y   = prompt_y + PROMPT_H + PAD
+    local work_h   = H - work_y - STATUS_H - PAD * 2
+    local col_w    = (W - PAD * 3) / 2
+
+    local fs = {
+        "formspec_version[6]",
+        "size[" .. W .. "," .. H .. "]",
+        "bgcolor[#0f0f0f;both]",
+        "style_type[*;bgcolor=#1a1a1a;textcolor=#e8e8e8;font=mono]",
+    }
+
+    -- ── Header ───────────────────────────────────────────────
+    table.insert(fs, "box[0,0;" .. W .. "," .. HEADER_H .. ";#1e1e1e]")
+    table.insert(fs, "label[" .. PAD .. "," .. (HEADER_H/2 - 0.15) .. ";Smart Lua IDE  |  " .. fn_esc .. "]")
+    table.insert(fs, "label[" .. (W - 6.2) .. "," .. (HEADER_H/2 - 0.15) .. ";" .. os.date("%H:%M") .. "]")
+    table.insert(fs, "style[close_ide;bgcolor=#3a1a1a;textcolor=#ffaaaa]")
+    table.insert(fs, "button[" .. (W - PAD - 2.0) .. ",0.08;2.0,0.65;close_ide;x Close]")
+
+    -- ── Toolbar ───────────────────────────────────────────────
+    local bw   = 1.85
+    local bp   = 0.12
+    local bh   = TOOL_H - 0.05
+    local x    = PAD
+
+    local function add_btn(id, label, tip, enabled)
+        if not enabled then
+            table.insert(fs, "style[" .. id .. ";bgcolor=#444444;textcolor=#888888]")
+        end
+        table.insert(fs, "button[" .. x .. "," .. tool_y .. ";" .. bw .. "," .. bh .. ";" .. id .. ";" .. label .. "]")
+        if tip then table.insert(fs, "tooltip[" .. id .. ";" .. tip .. "]") end
+        x = x + bw + bp
+    end
+
+    add_btn("syntax",  "Syntax",   "Local syntax check + AI fix if errors found", true)
+    add_btn("analyze", "Analyze",  "AI: find logic & API issues", true)
+    add_btn("explain", "Explain",  "AI: explain the code in plain language", true)
+    add_btn("run",     "▶ Run",    can_execute(name) and "Execute in sandbox" or "Execute (needs llm_dev)", can_execute(name))
+
+    if session.pending_proposal then
+        table.insert(fs, "style[apply;bgcolor=#2a6a2a;textcolor=#ffffff]")
+        add_btn("apply", "✓ Apply", "Apply AI proposal into editor", true)
+    else
+        add_btn("apply", "Apply",  "No pending proposal yet", false)
+    end
+
+    -- ── File Manager Row ──────────────────────────────────────
+    -- Layout: [Dropdown (files)] [Load] [Filename field] [Save] [New]
+    local files   = session.file_list
+    local dd_str  = #files > 0 and table.concat(files, ",") or "(no files)"
+    -- Find index for pre-selection
+    local dd_idx  = 1
+    if session.selected_file ~= "" then
+        for i, f in ipairs(files) do
+            if f == session.selected_file then dd_idx = i; break end
+        end
+    end
+
+    local DD_W   = 4.5
+    local BTN_SM = 1.4
+    local FN_W   = W - PAD * 6 - DD_W - BTN_SM * 3
+    local fbh    = FILE_H - 0.05
+
+    -- Dropdown
+    table.insert(fs, "dropdown[" .. PAD .. "," .. file_y .. ";" .. DD_W .. "," .. fbh
+        .. ";file_dropdown;" .. dd_str .. ";" .. dd_idx .. ";false]")
+    table.insert(fs, "tooltip[file_dropdown;Select a saved snippet]")
+
+    local fx = PAD + DD_W + PAD
+
+    -- Load button
+    table.insert(fs, "button[" .. fx .. "," .. file_y .. ";" .. BTN_SM .. "," .. fbh .. ";file_load;Load]")
+    table.insert(fs, "tooltip[file_load;Load selected file into editor]")
+    fx = fx + BTN_SM + PAD
+
+    -- Filename input
+    table.insert(fs, "field[" .. fx .. "," .. file_y .. ";" .. FN_W .. "," .. fbh .. ";filename_input;;" .. fn_esc .. "]")
+    table.insert(fs, "field_close_on_enter[filename_input;false]")
+    table.insert(fs, "style[filename_input;bgcolor=#1e1e1e;textcolor=#e8e8e8]")
+    table.insert(fs, "tooltip[filename_input;Filename to save as (auto-appends .lua)]")
+    fx = fx + FN_W + PAD
+
+    -- Save / New (root only)
+    if is_root(name) then
+        table.insert(fs, "style[file_save;bgcolor=#2a4a6a;textcolor=#ffffff]")
+        table.insert(fs, "button[" .. fx .. "," .. file_y .. ";" .. BTN_SM .. "," .. fbh .. ";file_save;Save]")
+        table.insert(fs, "tooltip[file_save;Save editor content as the given filename]")
+        fx = fx + BTN_SM + PAD
+        table.insert(fs, "button[" .. fx .. "," .. file_y .. ";" .. BTN_SM .. "," .. fbh .. ";file_new;New]")
+        table.insert(fs, "tooltip[file_new;Clear editor for a new file]")
+    end
+
+    -- ── Prompt Row ────────────────────────────────────────────
+    -- Layout: [Prompt field ............] [☐ Guide] [Generate]
+    local gen_w   = 2.2
+    local guide_w = 3.2   -- checkbox + label
+    local pr_w    = W - PAD * 4 - guide_w - gen_w
+
+    table.insert(fs, "field[" .. PAD .. "," .. prompt_y .. ";" .. pr_w .. "," .. PROMPT_H
+        .. ";prompt_input;;" .. prompt_esc .. "]")
+    table.insert(fs, "field_close_on_enter[prompt_input;false]")
+    table.insert(fs, "style[prompt_input;bgcolor=#1e1e1e;textcolor=#e8e8e8]")
+    table.insert(fs, "tooltip[prompt_input;Describe what code to generate, then click Generate]")
+
+    -- Naming guide toggle checkbox
+    local guide_on = session.guiding_active == true
+    local cx = PAD + pr_w + PAD
+    local guide_color = guide_on and "#1a3a1a" or "#252525"
+    table.insert(fs, "style[guide_toggle;bgcolor=" .. guide_color .. ";textcolor=#aaffaa]")
+    table.insert(fs, "checkbox[" .. cx .. "," .. (prompt_y + 0.15) .. ";guide_toggle;llm_connect: guide;" .. (guide_on and "true" or "false") .. "]")
+    table.insert(fs, "tooltip[guide_toggle;Inject naming convention guide into Generate calls.\nTeaches the LLM to use the llm_connect: prefix for registrations.]")
+
+    local gx = cx + guide_w + PAD
+    if can_execute(name) then
+        table.insert(fs, "style[generate;bgcolor=#2a4a6a;textcolor=#ffffff]")
+    else
+        table.insert(fs, "style[generate;bgcolor=#444444;textcolor=#888888]")
+    end
+    table.insert(fs, "button[" .. gx .. "," .. prompt_y .. ";" .. gen_w .. "," .. PROMPT_H
+        .. ";generate;Generate]")
+    table.insert(fs, "tooltip[generate;"
+        .. (can_execute(name) and "AI: generate code from your prompt" or "Generate (needs llm_dev)")
+        .. "]")
+
+    -- ── Editor & Output ───────────────────────────────────────
+    table.insert(fs, "style[code;bgcolor=#1e1e1e;textcolor=#e8e8e8;border=true]")
+    table.insert(fs, "textarea[" .. PAD .. "," .. work_y .. ";" .. (col_w - PAD) .. "," .. work_h
+        .. ";code;;" .. code_esc .. "]")
+
+    table.insert(fs, "style[output;bgcolor=#181818;textcolor=#cccccc;border=true]")
+    table.insert(fs, "textarea[" .. (PAD + col_w + PAD) .. "," .. work_y .. ";" .. (col_w - PAD) .. "," .. work_h
+        .. ";output;;" .. output_esc .. "]")
+
+    -- ── Status Bar ────────────────────────────────────────────
+    local sy = H - STATUS_H - PAD
+    table.insert(fs, "box[0," .. sy .. ";" .. W .. "," .. STATUS_H .. ";#1e1e1e]")
+    local status = "File: " .. fn_esc .. "  |  Modified: " .. os.date("%H:%M", session.last_modified)
+    if session.pending_proposal then
+        status = status .. "  |  ★ PROPOSAL READY – click Apply"
+    end
+    table.insert(fs, "label[" .. PAD .. "," .. (sy + 0.22) .. ";" .. status .. "]")
+
+    core.show_formspec(name, "llm_connect:ide", table.concat(fs))
+end
+
+-- ======================================================
+-- Formspec Handler
+-- ======================================================
+
+function M.handle_fields(name, formname, fields)
+    if not formname:match("^llm_connect:ide") then return false end
+    if not can_use_ide(name) then return true end
+
+    local session = get_session(name)
+    local updated = false
+
+    -- Capture live editor/field state
+    if fields.code           then session.code         = fields.code; session.last_modified = os.time() end
+    if fields.prompt_input   then session.last_prompt  = fields.prompt_input end
+    if fields.guide_toggle ~= nil then
+        session.guiding_active = (fields.guide_toggle == "true")
+        M.show(name)
+        return true
+    end
+    if fields.filename_input and fields.filename_input ~= "" then
+        local fn = fields.filename_input:match("^%s*(.-)%s*$")
+        if fn ~= "" then
+            if not fn:match("%.lua$") then fn = fn .. ".lua" end
+            session.filename = fn
+        end
+    end
+
+    -- Dropdown: track selection
+    if fields.file_dropdown then
+        local val = fields.file_dropdown
+        if val ~= "(no files)" and val ~= "" then
+            -- index_event=false → val is the filename directly
+            -- Fallback: if val is a number string, resolve via file_list index
+            local as_num = tonumber(val)
+            if as_num and session.file_list and session.file_list[as_num] then
+                val = session.file_list[as_num]
+            end
+            session.selected_file = val
+        end
+        updated = true
+    end
+
+    -- ── File operations ───────────────────────────────────────
+    if fields.file_load then
+        local target = session.selected_file
+        if target == "" or target == "(no files)" then
+            session.output = "Please select a file in the dropdown first."
+        else
+            local path    = ensure_snippets_dir() .. DIR_DELIM .. target
+            local content, read_err = read_file(path)
+            if content then
+                session.code          = content
+                session.filename      = target
+                session.last_modified = os.time()
+                session.output        = "✓ Loaded: " .. target
+            else
+                session.output = "✗ Could not read: " .. target
+                    .. "\nPath: " .. path
+                    .. (read_err and ("\nError: " .. tostring(read_err)) or "")
+                -- Remove from index if file is gone
+                index_remove(target)
+                session.file_list = list_snippet_files()
+            end
+        end
+        updated = true
+
+    elseif fields.file_save and is_root(name) then
+        local fn = session.filename
+        if fn == "" then fn = "untitled.lua" end
+        if not fn:match("%.lua$") then fn = fn .. ".lua" end
+        fn = fn:match("([^/\\]+)$") or fn   -- prevent path traversal
+        session.filename = fn
+
+        local path      = ensure_snippets_dir() .. DIR_DELIM .. fn
+        local ok, err   = write_file(path, session.code)
+        if ok then
+            index_add(fn)
+            session.output        = "✓ Saved: " .. fn
+            session.last_modified = os.time()
+            session.file_list     = list_snippet_files()
+            session.selected_file = fn
+        else
+            session.output = "✗ Save failed: " .. tostring(err)
+        end
+        updated = true
+
+    elseif fields.file_new and is_root(name) then
+        session.code             = DEFAULT_CODE
+        session.filename         = "untitled.lua"
+        session.last_modified    = os.time()
+        session.pending_proposal = nil
+        session.output           = "New file ready. Write code and save."
+        updated = true
+
+    -- ── Toolbar actions ───────────────────────────────────────
+    elseif fields.syntax then
+        M.check_syntax(name); return true
+
+    elseif fields.analyze then
+        M.analyze_code(name); return true
+
+    elseif fields.explain then
+        M.explain_code(name); return true
+
+    elseif fields.generate and can_execute(name) then
+        M.generate_code(name); return true
+
+    elseif fields.run and can_execute(name) then
+        M.run_code(name); return true
+
+    elseif fields.apply then
+        if session.pending_proposal then
+            session.code             = session.pending_proposal
+            session.pending_proposal = nil
+            session.last_modified    = os.time()
+            session.output           = "✓ Applied proposal to editor."
+        else
+            session.output = "No pending proposal to apply."
+        end
+        updated = true
+
+    elseif fields.close_ide or fields.quit then
+        if _G.chat_gui then _G.chat_gui.show(name) end
+        return true
+    end
+
+    if updated then M.show(name) end
+    return true
+end
+
+-- ======================================================
+-- Actions (AI)
+-- ======================================================
+
+function M.check_syntax(name)
+    local session = get_session(name)
+    local func, err = loadstring(session.code)
+    if func then
+        session.output = "✓ Syntax OK – no errors found."
+        M.show(name)
+        return
+    end
+
+    session.output = "✗ Syntax error:\n" .. tostring(err) .. "\n\nAsking AI to fix…"
+    M.show(name)
+
+    local p = get_prompts()
+    get_llm_api().code(p.SYNTAX_FIXER, session.code, function(result)
+        if result.success then
+            local fixed = result.content
+            fixed = fixed:match("```lua\n(.-)```") or fixed:match("```\n(.-)```") or fixed
+            session.pending_proposal = fixed
+            session.output = "AI fix proposal:\n\n" .. fixed .. "\n\n→ Press [Apply] to use."
+        else
+            session.output = "Syntax error:\n" .. tostring(err)
+                .. "\n\nAI fix failed: " .. (result.error or "?")
+        end
+        M.show(name)
+    end)
+end
+
+function M.analyze_code(name)
+    local session = get_session(name)
+    session.output = "Analyzing code… (please wait)"
+    M.show(name)
+
+    local p = get_prompts()
+    get_llm_api().code(p.SEMANTIC_ANALYZER, session.code, function(result)
+        if result.success then
+            local content   = result.content
+            local code_part = content:match("```lua\n(.-)```") or content:match("```\n(.-)```")
+            local analysis  = content:match("%-%-%[%[(.-)%]%]") or content
+            if code_part then
+                session.pending_proposal = code_part
+                session.output = "Analysis:\n" .. analysis .. "\n\n→ Improved code ready. Press [Apply]."
+            else
+                session.output = "Analysis:\n" .. content
+            end
+        else
+            session.output = "Error: " .. (result.error or "No response")
+        end
+        M.show(name)
+    end)
+end
+
+function M.explain_code(name)
+    local session = get_session(name)
+    session.output = "Explaining code… (please wait)"
+    M.show(name)
+
+    local p = get_prompts()
+    get_llm_api().code(p.CODE_EXPLAINER, session.code, function(result)
+        session.output = result.success and result.content or ("Error: " .. (result.error or "?"))
+        M.show(name)
+    end)
+end
+
+function M.generate_code(name)
+    local session  = get_session(name)
+    local user_req = (session.last_prompt or ""):match("^%s*(.-)%s*$")
+
+    if user_req == "" then
+        session.output = "Please enter a prompt in the field above first."
+        M.show(name)
+        return
+    end
+
+    session.output = "Generating code… (please wait)"
+    M.show(name)
+
+    local p       = get_prompts()
+
+    -- Append naming guide if toggle is active in session
+    local guide_addendum = ""
+    if session.guiding_active and p.NAMING_GUIDE then
+        guide_addendum = p.NAMING_GUIDE
+    end
+
+    local sys_msg = p.CODE_GENERATOR .. guide_addendum .. "\n\nUser request: " .. user_req
+    get_llm_api().code(sys_msg, session.code, function(result)
+        if result.success and result.content then
+            local gen = result.content
+            gen = gen:match("```lua\n(.-)```") or gen:match("```\n(.-)```") or gen
+            session.pending_proposal = gen
+            session.output = "Generated code proposal:\n\n" .. gen
+                .. "\n\n→ Press [Apply] to insert into editor."
+        else
+            session.output = "Generation failed: " .. (result.error or "No response")
+        end
+        M.show(name)
+    end)
+end
+
+function M.run_code(name)
+    local session  = get_session(name)
+    local executor = get_executor()
+
+    session.output = "Executing… (please wait)"
+    M.show(name)
+
+    local res = executor.execute(name, session.code, {sandbox = true})
+    if res.success then
+        local out = "✓ Execution successful.\n\nOutput:\n"
+            .. (res.output ~= "" and res.output or "(no output)")
+        if res.return_value then out = out .. "\n\nReturn: " .. tostring(res.return_value) end
+        if res.persisted    then out = out .. "\n\n→ Startup file updated (restart needed)" end
+        session.output = out
+    else
+        session.output = "✗ Execution failed:\n" .. (res.error or "Unknown error")
+        if res.output and res.output ~= "" then
+            session.output = session.output .. "\n\nOutput before error:\n" .. res.output
+        end
+    end
+    M.show(name)
+end
+
+-- Cleanup
+core.register_on_leaveplayer(function(player)
+    sessions[player:get_player_name()] = nil
+end)
+
+return M

ide_languages.lua

@@ -0,0 +1,40 @@
+local LANGUAGE_NAMES = {
+    en = "English",
+    de = "German",
+    es = "Spanish",
+    fr = "French",
+    it = "Italian",
+    pt = "Portuguese",
+    ru = "Russian",
+    zh = "Chinese",
+    ja = "Japanese",
+    ko = "Korean",
+    ar = "Arabic",
+    hi = "Hindi",
+    tr = "Turkish",
+    nl = "Dutch",
+    pl = "Polish",
+    sv = "Swedish",
+    da = "Danish",
+    no = "Norwegian",
+    fi = "Finnish",
+    cs = "Czech",
+    hu = "Hungarian",
+    ro = "Romanian",
+    el = "Greek",
+    th = "Thai",
+    vi = "Vietnamese",
+    id = "Indonesian",
+    ms = "Malay",
+    he = "Hebrew",
+    bn = "Bengali",
+    uk = "Ukrainian",
+}
+
+function get_language_name(code)
+    return LANGUAGE_NAMES[code] or "English"
+end
+
+return {
+    get_language_name = get_language_name
+}

ide_system_prompts.lua

@@ -0,0 +1,120 @@
+-- smart_lua_ide/prompts.lua
+-- System prompts for different AI assistant modes
+
+local prompts = {}
+
+prompts.SYNTAX_FIXER = [[You are a Lua syntax corrector specialized in Minetest/Luanti mod development.
+
+Your task: Fix ONLY syntax errors in the provided code.
+
+Rules:
+1. Return ONLY the corrected Lua code
+2. NO explanations, NO markdown blocks, NO comments
+3. Preserve the original logic and structure
+4. Fix: missing 'end', unmatched parentheses, typos in keywords, etc.
+5. Do NOT refactor or optimize - only fix syntax
+6. Do NOT add any filesystem/network/system access
+
+Output format: Raw Lua code only.]]
+
+prompts.SEMANTIC_ANALYZER = [[You are a Lua code analyzer for Minetest/Luanti mods.
+
+Your task: Analyze code for logic errors, API misuse, and improvements.
+
+Context:
+- Minetest Lua API version 5.x
+- Common APIs: core.register_node, core.register_tool, core.register_chatcommand
+- Deprecated functions should be flagged
+
+Security rules:
+- Do NOT introduce os/io/debug/require/dofile/loadfile/package
+- Do NOT introduce core.request_http_api or core.request_insecure_environment
+
+Output format:
+1. First, provide the CORRECTED CODE
+2. Then, add a comment block explaining:
+  - What was wrong
+  - What was changed
+  - Why it matters
+
+Example format:
+-- [CORRECTED CODE HERE]
+--[[ ANALYSIS:
+- ...
+]]
+
+prompts.CODE_EXPLAINER = [[You are a Minetest/Luanti mod development tutor.
+
+Your task: Explain the provided Lua code in simple terms.
+
+Focus on:
+1. What the code does (high-level)
+2. Key Minetest API calls and their purpose
+3. Potential issues or improvements
+4. Best practices being followed/violated
+
+Be concise but educational.]]
+
+prompts.CODE_GENERATOR = [[You are a Minetest/Luanti mod code generator.
+
+Your task: Generate clean, functional Lua code based on the user's request.
+
+Requirements:
+1. Use modern Minetest API (5.x+)
+2. Include error handling where appropriate
+3. Add brief inline comments for complex logic
+4. Follow Minetest coding conventions
+5. Return ONLY executable Lua code
+
+Security requirements (important):
+- Do NOT use os/io/debug/package/require/dofile/loadfile
+- Do NOT use core.request_http_api or core.request_insecure_environment
+- Avoid privilege/auth manipulation APIs
+
+Output: Raw Lua code ready to execute.]]
+
+prompts.REFACTORER = [[You are a code refactoring expert for Minetest/Luanti mods.
+
+Your task: Improve code quality without changing functionality.
+
+Improvements:
+1. Better variable names
+2. Extract repeated code into functions
+3. Optimize performance (e.g., caching, avoiding repeated lookups)
+4. Improve readability and structure
+5. Add helpful comments
+
+Security requirements:
+- Do NOT add os/io/debug/package/require/dofile/loadfile
+- Do NOT add core.request_http_api or core.request_insecure_environment
+
+Output:
+1. Refactored code
+2. Brief comment explaining major changes]]
+
+-- ============================================================
+-- Naming Convention Guide (opt-in, injected when guide_toggle is active)
+-- Appended to CODE_GENERATOR when llm_connect: prefix guide is enabled.
+-- ============================================================
+
+prompts.NAMING_GUIDE = [[
+
+IMPORTANT – Luanti/Minetest Naming Conventions for this IDE:
+This code runs inside the "llm_connect" mod context.
+
+REGISTRATIONS – always use "llm_connect:" prefix:
+  Correct:   core.register_node("llm_connect:my_stone", { ... })
+  Correct:   core.register_craftitem("llm_connect:magic_dust", { ... })
+  Incorrect: core.register_node("mymod:my_stone", { ... })   -- fails
+  Incorrect: core.register_node("default:my_stone", { ... }) -- fails
+
+LUA STDLIB – Luanti uses LuaJIT, not standard Lua:
+  No string:capitalize() – use: (str:sub(1,1):upper() .. str:sub(2))
+  No string:split()      – use: string.gmatch or manual parsing
+
+READING other mods is always fine:
+  core.get_node(pos)                       -- ok
+  core.registered_nodes["default:stone"]   -- ok
+]]
+
+return prompts

init.lua

@@ -1,422 +1,226 @@
 -- ===========================================================================
---  LLM Connect Init v0.7.8
+--  LLM Connect Init v0.9.0-dev
 --  author: H5N3RG
 --  license: LGPL-3.0-or-later
---  Fix: max_tokens type handling, fully configurable, robust JSON
---  Added: metadata for ingame-commads
---  Enhancement: Dynamic metadata handling, player name in prompts
---  NEW: Automatic API endpoint completion for compatibility.
---  UPDATE: Configurable context sending
 -- ===========================================================================
 
 local core = core
+local mod_dir = core.get_modpath("llm_connect")
 
--- Load HTTP API
+-- === HTTP API ===
 local http = core.request_http_api()
 if not http then
     core.log("error", "[llm_connect] HTTP API not available! Add 'llm_connect' to secure.http_mods in minetest.conf!")
     return
 end
 
--- === Load settings from menu / settingtypes.txt ===
-local api_key    = core.settings:get("llm_api_key") or ""
-local api_url    = core.settings:get("llm_api_url") or ""
-local model_name = core.settings:get("llm_model") or ""
-
--- NEW Context Settings
-local send_server_info = core.settings:get_bool("llm_context_send_server_info")
-local send_mod_list    = core.settings:get_bool("llm_context_send_mod_list")
-local send_commands    = core.settings:get_bool("llm_context_send_commands")
-local send_player_pos  = core.settings:get_bool("llm_context_send_player_pos")
-local send_materials   = core.settings:get_bool("llm_context_send_materials")
-
--- NEW: Function to check and complete the API endpoint
-local function finalize_api_url(url)
-    if not url or url == "" then
-        return ""
-    end
-
-    -- 1. Remove trailing slash if present
-    local clean_url = url:gsub("/$", "")
-
-    -- Check if the URL contains a path component (everything after the host:port)
-    -- We assume any '/' after the protocol part (e.g., 'http://') or the host:port
-    -- indicates a user-defined path, which should not be overwritten.
-    -- Simple check: if the URL contains more than two slashes (e.g. 'http://host')
-    -- or if it contains any character after the host:port that is not part of the port number.
-
-    -- Attempt to find the end of the host/port part (first '/' after the protocol slashes)
-    local protocol_end = clean_url:find("://")
-    local host_end = 0
-
-    if protocol_end then
-        host_end = clean_url:find("/", protocol_end + 3) -- Find the first slash after '://'
-    end
-
-    -- If no further slash is found (host_end is nil), it means only the base address (host:port) is present.
-    if not host_end then
-        -- Append the default OpenAI-compatible path
-        return clean_url .. "/v1/chat/completions"
-    end
-
-    -- If a path is found, use the URL as is.
-    return url
-end
-
--- Apply the auto-completion/finalization logic
-api_url = finalize_api_url(api_url)
-
-
--- max_tokens type: default integer, override via settings
-local setting_val = core.settings:get_bool("llm_max_tokens_integer")
-local max_tokens_type = "integer"
-if setting_val == false then
-    max_tokens_type = "float"
-end
-
--- Storage for conversation history per player
-local history = {}
-local max_history = { ["default"] = 10 }
-local metadata_cache = {} -- Cache for metadata to detect changes
-
--- Helper functions
-local function get_history(name)
-    history[name] = history[name] or {}
-    return history[name]
-end
-
-local function get_max_history(name)
-    return max_history[name] or max_history["default"]
-end
-
-local function string_split(str, delim)
-    local res = {}
-    local i = 1
-    local str_len = #str
-    local delim_len = #delim
-    while i <= str_len do
-        local pos = string.find(str, delim, i, true)
-        if pos then
-            table.insert(res, string.sub(str, i, pos - 1))
-            i = pos + delim_len
-        else
-            table.insert(res, string.sub(str, i))
-            break
-        end
-    end
-    return res
-end
-
--- Load optional context files
-local mod_dir = core.get_modpath("llm_connect")
-local llm_materials_context = nil
-pcall(function()
-    llm_materials_context = dofile(mod_dir .. "/llm_materials_context.lua")
-end)
-
-local function read_file_content(filepath)
-    local f = io.open(filepath, "r")
-    if not f then return nil end
-    local content = f:read("*a")
-    f:close()
-    return content
-end
-
-local system_prompt_content = read_file_content(mod_dir .. "/system_prompt.txt") or ""
-
 -- === Privileges ===
-core.register_privilege("llm", { description = "Can chat with the LLM model", give_to_singleplayer=true, give_to_admin=true })
+core.register_privilege("llm", {
-core.register_privilege("llm_root", { description = "Can configure the LLM API key, model, and endpoint", give_to_singleplayer=true, give_to_admin=true })
+    description = "LLM Connect: /llm chat interface (chat mode only)",
+    give_to_singleplayer = true,
+    give_to_admin = true,
+})
 
--- === Metadata Functions ===
+core.register_privilege("llm_dev", {
-local meta_data_functions = {}
+    description = "LLM Connect: Smart Lua IDE + sandbox code execution (whitelist limited)",
-local function get_username(player_name) return player_name or "Unknown Player" end
+    give_to_singleplayer = false,
-local function get_installed_mods()
+    give_to_admin = false,
-    local mods = {}
+})
-    -- NOTE: core.get_mods is undocumented. Using core.get_modnames (documented) instead.
+
-    if core.get_modnames then
+core.register_privilege("llm_worldedit", {
-        -- core.get_modnames returns a table of mod names, already sorted alphabetically.
+    description = "LLM Connect: WorldEdit agency (WE Single + WE Loop + material picker)",
-        mods = core.get_modnames()
+    give_to_singleplayer = false,
-    else
+    give_to_admin = false,
-        -- Fallback for extremely old versions
+})
-        table.insert(mods,"Mod list not available (core.get_modnames missing)")
+
-    end
+core.register_privilege("llm_root", {
-    return mods
+    description = "LLM Connect: Full access (implies llm + llm_dev + llm_worldedit). Config, unrestricted execution, persistent code.",
+    give_to_singleplayer = false,
+    give_to_admin = true,
+})
+
+-- === Load central LLM API module ===
+local llm_api_ok, llm_api = pcall(dofile, mod_dir .. "/llm_api.lua")
+if not llm_api_ok or not llm_api then
+    core.log("error", "[llm_connect] Failed to load llm_api.lua: " .. tostring(llm_api))
+    return
+end
+if not llm_api.init(http) then
+    core.log("error", "[llm_connect] Failed to initialize llm_api")
+    return
 end
 
--- Function to collect chat commands
+-- === Load code executor ===
-local function get_installed_commands()
+local executor_ok, executor = pcall(dofile, mod_dir .. "/code_executor.lua")
-    local commands = {}
+if not executor_ok or not executor then
-    if core.chatcommands then
+    core.log("error", "[llm_connect] Failed to load code_executor.lua: " .. tostring(executor))
-        for name, cmd in pairs(core.chatcommands) do
+    return
-            if not name:match("^__builtin:") then
+end
-                local desc = cmd.description or "No description"
+
-                table.insert(commands, "/" .. name .. " " .. (cmd.params or "") .. " - " .. desc)
+-- === Load GUI modules ===
-            end
+local chat_gui_ok, chat_gui = pcall(dofile, mod_dir .. "/chat_gui.lua")
+if not chat_gui_ok then
+    core.log("error", "[llm_connect] Failed to load chat_gui.lua: " .. tostring(chat_gui))
+    return
+end
+
+local ide_gui_ok, ide_gui = pcall(dofile, mod_dir .. "/ide_gui.lua")
+if not ide_gui_ok then
+    core.log("error", "[llm_connect] Failed to load ide_gui.lua: " .. tostring(ide_gui))
+    return
+end
+
+local config_gui_ok, config_gui = pcall(dofile, mod_dir .. "/config_gui.lua")
+if not config_gui_ok then
+    core.log("error", "[llm_connect] Failed to load config_gui.lua: " .. tostring(config_gui))
+    return
+end
+
+-- === Load helpers ===
+local chat_context_ok, chat_context = pcall(dofile, mod_dir .. "/chat_context.lua")
+if not chat_context_ok then
+    core.log("warning", "[llm_connect] chat_context.lua not loaded: " .. tostring(chat_context))
+    chat_context = nil
+end
+
+-- === Load WorldEdit agency module (optional dependency) ===
+local we_agency_ok, we_agency = pcall(dofile, mod_dir .. "/llm_worldedit.lua")
+if not we_agency_ok then
+    core.log("warning", "[llm_connect] llm_worldedit.lua failed to load: " .. tostring(we_agency))
+    we_agency = nil
+elseif not we_agency.is_available() then
+    core.log("warning", "[llm_connect] WorldEdit not detected at load time – agency mode disabled")
+    core.log("warning", "[llm_connect] worldedit global type: " .. type(worldedit))
+    -- NOTE: we_agency is still set as global – we_available() checks at runtime
+    -- so WE buttons may still appear if worldedit loads later (should not happen with optional_depends)
+end
+
+-- === Load material picker ===
+local picker_ok, material_picker = pcall(dofile, mod_dir .. "/material_picker.lua")
+if not picker_ok then
+    core.log("warning", "[llm_connect] material_picker.lua not loaded: " .. tostring(material_picker))
+    material_picker = nil
+end
+
+-- === Make modules globally available ===
+_G.chat_gui        = chat_gui
+_G.llm_api         = llm_api
+_G.executor        = executor
+_G.we_agency       = we_agency
+_G.material_picker = material_picker
+_G.ide_gui         = ide_gui
+_G.config_gui      = config_gui
+
+-- === Startup code loader ===
+local startup_file = core.get_worldpath() .. "/llm_startup.lua"
+
+local function load_startup_code()
+    local f = io.open(startup_file, "r")
+    if f then
+        f:close()
+        core.log("action", "[llm_connect] Loading startup code from " .. startup_file)
+        local ok, err = pcall(dofile, startup_file)
+        if not ok then
+            core.log("error", "[llm_connect] Startup code error: " .. tostring(err))
+            core.log("error", "[llm_connect] Fix the error in llm_startup.lua and restart the server")
+        else
+            core.log("action", "[llm_connect] Startup code loaded successfully")
         end
-        table.sort(commands)
     else
-        table.insert(commands, "Command list not available.")
+        core.log("action", "[llm_connect] No llm_startup.lua found (this is normal on first run)")
     end
-    return commands
 end
 
-local function get_server_settings()
+load_startup_code()
-    local settings = {
-        server_name       = core.settings:get("server_name") or "Unnamed Server",
-        server_description= core.settings:get("server_description") or "No description",
-        motd              = core.settings:get("motd") or "No MOTD set",
-        port              = core.settings:get("port") or "Unknown",
-        gameid            = (core.get_game_info and core.get_game_info().id) or core.settings:get("gameid") or "Unknown",
-        game_name         = (core.get_game_info and core.get_game_info().name) or "Unknown",
-        worldpath         = core.get_worldpath() or "Unknown",
-        mapgen            = core.get_mapgen_setting("mg_name") or "Unknown",
-    }
-    return settings
-end
-
-function meta_data_functions.gather_context(player_name)
-    local context = {}
-    context.player = get_username(player_name)
-    context.installed_mods = get_installed_mods()
-    context.installed_commands = get_installed_commands()
-    context.server_settings = get_server_settings()
-    -- Add dynamic player data (e.g., position)
-    local player = core.get_player_by_name(player_name)
-    if player then
-        local pos = player:get_pos()
-        context.player_position = string.format("x=%.2f, y=%.2f, z=%.2f", pos.x, pos.y, pos.z)
-    else
-        context.player_position = "Unknown"
-    end
-    return context
-end
-
--- Compute a simple hash for metadata to detect changes
-local function compute_metadata_hash(context)
-    -- Hash calculation now depends on which fields are active to avoid unnecessary cache busts
-    local str = context.player
-    if send_server_info then str = str .. context.server_settings.server_name .. context.server_settings.worldpath end
-    if send_mod_list then str = str .. table.concat(context.installed_mods, ",") end
-    if send_commands then str = str .. table.concat(context.installed_commands, ",") end
-    if send_player_pos then str = str .. context.player_position end
-    -- Material context has its own hash in llm_materials_context.lua, so we don't include it here
-    return core.sha1(str)
-end
 
 -- === Chat Commands ===
-core.register_chatcommand("llm_setkey", {
-    params = "<key> [url] [model]",
-    description = "Sets the API key, URL, and model for the LLM.",
-    privs = {llm_root=true},
-    func = function(name,param)
-        if not core.check_player_privs(name,{llm_root=true}) then return false,"No permission!" end
-        local parts = string_split(param," ")
-        if #parts==0 then return false,"Please provide API key!" end
-        api_key = parts[1]
-        if parts[2] then api_url = finalize_api_url(parts[2]) end -- Apply finalization here too
-        if parts[3] then model_name = parts[3] end
-        core.chat_send_player(name,"[LLM] API key, URL and model set. (URL auto-corrected if only host:port was provided.)")
-        return true
-    end,
-})
 
-core.register_chatcommand("llm_setmodel", {
-    params = "<model>",
-    description = "Sets the LLM model.",
-    privs = {llm_root=true},
-    func = function(name,param)
-        if not core.check_player_privs(name,{llm_root=true}) then return false,"No permission!" end
-        if param=="" then return false,"Provide a model name!" end
-        model_name = param
-        core.chat_send_player(name,"[LLM] Model set to '"..model_name.."'.")
-        return true
-    end,
-})
-
-core.register_chatcommand("llm_set_endpoint", {
-    params = "<url>",
-    description = "Sets the API endpoint URL.",
-    privs = {llm_root=true},
-    func = function(name,param)
-        if not core.check_player_privs(name,{llm_root=true}) then return false,"No permission!" end
-        if param=="" then return false,"Provide URL!" end
-        api_url = finalize_api_url(param) -- Apply finalization here
-        core.chat_send_player(name,"[LLM] API endpoint set to "..api_url.." (URL auto-corrected if only host:port was provided.)")
-        return true
-    end,
-})
-
-core.register_chatcommand("llm_set_context", {
-    params = "<count> [player]",
-    description = "Sets the max context length.",
-    privs = {llm_root=true},
-    func = function(name,param)
-        if not core.check_player_privs(name,{llm_root=true}) then return false,"No permission!" end
-        local parts = string_split(param," ")
-        local count = tonumber(parts[1])
-        local target_player = parts[2]
-        if not count or count<1 then return false,"Provide number > 0!" end
-        if target_player and target_player~="" then max_history[target_player]=count
-        else max_history["default"]=count end
-        core.chat_send_player(name,"[LLM] Context length set.")
-        return true
-    end,
-})
-
-core.register_chatcommand("llm_float", {
-    description = "Set max_tokens as float",
-    privs = {llm_root=true},
-    func = function(name)
-        max_tokens_type="float"
-        core.chat_send_player(name,"[LLM] max_tokens now sent as float.")
-        return true
-    end,
-})
-
-core.register_chatcommand("llm_integer", {
-    description = "Set max_tokens as integer",
-    privs = {llm_root=true},
-    func = function(name)
-        max_tokens_type="integer"
-        core.chat_send_player(name,"[LLM] max_tokens now sent as integer.")
-        return true
-    end,
-})
-
-core.register_chatcommand("llm_reset", {
-    description = "Resets conversation and context.",
-    privs = {llm=true},
-    func = function(name)
-        history[name] = {}
-        metadata_cache[name] = nil -- Reset metadata cache
-        core.chat_send_player(name,"[LLM] Conversation and metadata reset.")
-    end,
-})
-
--- === Main Chat Command ===
 core.register_chatcommand("llm", {
-    params = "<prompt>",
+    description = "Opens the LLM chat interface",
-    description = "Sends prompt to the LLM",
+    privs = {llm = true},
-    privs = {llm=true},
+    func = function(name)
-    func = function(name,param)
+        chat_gui.show(name)
-        if not core.check_player_privs(name,{llm=true}) then return false,"No permission!" end
+        return true, "Opening LLM chat..."
-        if param=="" then return false,"Provide a prompt!" end
-        if api_key=="" or api_url=="" or model_name=="" then
-            return false,"[LLM] API key, URL, or Model not set! Check mod settings."
-        end
-
-        local player_history = get_history(name)
-        local max_hist = get_max_history(name)
-        -- Add player name to prompt for clarity
-        local user_prompt = "Player " .. name .. ": " .. param
-        table.insert(player_history,{role="user",content=user_prompt})
-        while #player_history>max_hist do table.remove(player_history,1) end
-
-        -- Gather and cache metadata
-        local context_data = meta_data_functions.gather_context(name)
-        local current_metadata_hash = compute_metadata_hash(context_data)
-        local needs_metadata_update = not metadata_cache[name] or metadata_cache[name].hash ~= current_metadata_hash
-
-        local messages = {}
-        -- Build dynamic system prompt with metadata
-        local dynamic_system_prompt = system_prompt_content
-        if needs_metadata_update then
-            local metadata_string = "\n\n--- METADATA ---\n" ..
-                                    "Player: " .. context_data.player .. "\n"
-
-            -- Conditional Player Position
-            if send_player_pos then
-                metadata_string = metadata_string .. "Player Position: " .. context_data.player_position .. "\n"
-            end
-
-            -- Conditional Server Info
-            if send_server_info then
-                metadata_string = metadata_string ..
-                    "Server Name: " .. context_data.server_settings.server_name .. "\n" ..
-                    "Server Description: " .. context_data.server_settings.server_description .. "\n" ..
-                    "MOTD: " .. context_data.server_settings.motd .. "\n" ..
-                    "Game: " .. context_data.server_settings.game_name .. " (" .. context_data.server_settings.gameid .. ")\n" ..
-                    "Mapgen: " .. context_data.server_settings.mapgen .. "\n" ..
-                    "World Path: " .. context_data.server_settings.worldpath .. "\n" ..
-                    "Port: " .. context_data.server_settings.port .. "\n"
-            end
-
-            -- Conditional Mod List
-            if send_mod_list then
-                local mods_list_str = table.concat(context_data.installed_mods,", ")
-                if #context_data.installed_mods>10 then mods_list_str="(More than 10 installed mods: "..#context_data.installed_mods..")" end
-                metadata_string = metadata_string ..
-                    "Installed Mods (" .. #context_data.installed_mods .. "): " .. mods_list_str .. "\n"
-            end
-
-            -- Conditional Command List
-            if send_commands then
-                local commands_list_str = table.concat(context_data.installed_commands, "\n")
-                metadata_string = metadata_string ..
-                    "Available Commands:\n" .. commands_list_str .. "\n"
-            end
-
-            -- Conditional Materials Context
-            if send_materials and llm_materials_context and llm_materials_context.get_available_materials then
-                metadata_string = metadata_string ..
-                    "\n--- AVAILABLE MATERIALS ---\n" .. llm_materials_context.get_available_materials()
-            end
-
-            dynamic_system_prompt = system_prompt_content .. metadata_string
-            metadata_cache[name] = { hash = current_metadata_hash, metadata = metadata_string }
-        else
-            dynamic_system_prompt = system_prompt_content .. metadata_cache[name].metadata
-        end
-
-        table.insert(messages,{role="system",content=dynamic_system_prompt})
-        for _,msg in ipairs(player_history) do table.insert(messages,msg) end
-
-        -- === max_tokens handling with final JSON fix ===
-        local max_tokens_value = 2000
-        if max_tokens_type == "integer" then
-            max_tokens_value = math.floor(max_tokens_value)
-        else
-            max_tokens_value = tonumber(max_tokens_value)
-        end
-
-        local body = core.write_json({ model=model_name, messages=messages, max_tokens=max_tokens_value })
-
-        -- Force integer in JSON string if needed (important for Go backends)
-        if max_tokens_type == "integer" then
-            body = body:gsub('"max_tokens"%s*:%s*(%d+)%.0', '"max_tokens": %1')
-        end
-
-        core.log("action", "[llm_connect DEBUG] max_tokens_type = " .. max_tokens_type)
-        core.log("action", "[llm_connect DEBUG] max_tokens_value = " .. tostring(max_tokens_value))
-        core.log("action", "[llm_connect DEBUG] API URL used: " .. api_url) -- Log the final URL
-
-        -- Send HTTP request
-        http.fetch({
-            url = api_url,
-            post_data = body,
-            method = "POST",
-            extra_headers = {
-                "Content-Type: application/json",
-                "Authorization: Bearer " .. api_key
-            },
-            timeout = 90,
-        }, function(result)
-            if result.succeeded then
-                local response = core.parse_json(result.data)
-                local text = "(no answer)"
-                if response and response.choices and response.choices[1] and response.choices[1].message then
-                    text = response.choices[1].message.content
-                    table.insert(player_history,{role="assistant",content=text})
-                elseif response and response.message and response.message.content then
-                    text = response.message.content
-                end
-                core.chat_send_player(name,"[LLM] "..text)
-            else
-                core.chat_send_player(name,"[LLM] Request failed: "..(result.error or "Unknown error"))
-            end
-        end)
-
-        return true,"Request sent..."
     end,
 })
+
+core.register_chatcommand("llm_msg", {
+    params = "<message>",
+    description = "Send a direct message to the LLM (text-only, no GUI)",
+    privs = {llm = true},
+    func = function(name, param)
+        if not param or param == "" then
+            return false, "Usage: /llm_msg <your question>"
+        end
+        local messages = {{role = "user", content = param}}
+        llm_api.request(messages, function(result)
+            if result.success then
+                core.chat_send_player(name, "[LLM] " .. (result.content or "(no response)"))
+            else
+                core.chat_send_player(name, "[LLM] Error: " .. (result.error or "unknown error"))
+            end
+        end, {timeout = llm_api.get_timeout("chat")})
+        return true, "Request sent..."
+    end,
+})
+
+core.register_chatcommand("llm_undo", {
+    description = "Undo the last WorldEdit agency operation",
+    privs = {llm = true},
+    func = function(name)
+        if not _G.we_agency then
+            return false, "WorldEdit agency module not loaded"
+        end
+        local res = _G.we_agency.undo(name)
+        return res.ok, "[LLM] " .. res.message
+    end,
+})
+
+core.register_chatcommand("llm_reload_startup", {
+    description = "Reload llm_startup.lua (WARNING: Cannot register new items!)",
+    privs = {llm_root = true},
+    func = function(name)
+        core.log("action", "[llm_connect] Manual startup reload triggered by " .. name)
+        core.chat_send_player(name, "[LLM] WARNING: Reloading startup code at runtime")
+        core.chat_send_player(name, "[LLM] New registrations will FAIL. Restart server for registrations.")
+        local f = io.open(startup_file, "r")
+        if f then
+            f:close()
+            local ok, err = pcall(dofile, startup_file)
+            if not ok then
+                core.chat_send_player(name, "[LLM] x Reload failed: " .. tostring(err))
+                return false, "Reload failed"
+            else
+                core.chat_send_player(name, "[LLM] Reloaded (restart needed for registrations)")
+                return true, "Code reloaded"
+            end
+        else
+            core.chat_send_player(name, "[LLM] x No llm_startup.lua found")
+            return false, "File not found"
+        end
+    end,
+})
+
+-- === Central formspec handler ===
+core.register_on_player_receive_fields(function(player, formname, fields)
+    if not player then return false end
+    local name = player:get_player_name()
+
+    if formname:match("^llm_connect:chat") or formname:match("^llm_connect:material_picker") then
+        return chat_gui.handle_fields(name, formname, fields)
+    elseif formname:match("^llm_connect:ide") then
+        return ide_gui.handle_fields(name, formname, fields)
+    elseif formname:match("^llm_connect:config") then
+        return config_gui.handle_fields(name, formname, fields)
+    end
+
+    return false
+end)
+
+-- === Logging ===
+core.log("action", "[llm_connect] LLM Connect v0.9.0 loaded")
+if llm_api.is_configured() then
+    core.log("action", "[llm_connect] LLM API ready - model: " .. tostring(llm_api.config.model))
+else
+    core.log("warning", "[llm_connect] LLM API not configured yet - use /llm and open Config button")
+end

license.txt

@@ -1,168 +0,0 @@
-
-
-            GNU LESSER GENERAL PUBLIC LICENSE
-                       Version 3, 29 June 2007
-
- Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
- Everyone is permitted to copy and distribute verbatim copies
- of this license document, but changing it is not allowed.
-
-This version of the GNU Lesser General Public License incorporates
-the terms and conditions of version 3 of the GNU General Public
-License, supplemented by the additional permissions listed below.
-
-  0. Additional Definitions.
-
-  "This License" refers to version 3 of the GNU Lesser General Public
-License.
-
-  "Copyright" also means copyright-like laws that apply to other kinds of
-works, such as semiconductor masks.
-
-  "The Library" refers to a covered work governed by this License,
-other than an Application or a Combined Work as defined below.
-
-  An "Application" is any work that makes use of an interface provided
-by the Library, but which is not otherwise based on the Library.
-Defining a subclass of a class defined by the Library is deemed a mode
-of using an interface provided by the Library.
-
-  A "Combined Work" is a work produced by combining or linking an
-Application with the Library.  The particular version of the Library
-with which the Combined Work was made is also called the "Linked
-Version".
-
-  The "Minimal Corresponding Source" for a Combined Work means the
-Corresponding Source for the Combined Work, excluding any source code
-for portions of the Combined Work that, considered in isolation, are
-based on the Application, and not on the Linked Version.
-
-  The "Corresponding Application Code" for a Combined Work means the
-object code and/or source code for the Application, including any data
-and utility programs needed for reproducing the Combined Work from the
-Application, but excluding the System Libraries of the Combined Work.
-
-  1. Exception to Section 3 of the GNU GPL.
-
-  You may convey a covered work under sections 3 and 4 of this License
-without being bound by section 3 of the GNU GPL.
-
-  2. Conveying Modified Versions.
-
-  If you modify a copy of the Library, and, in your modifications, a
-facility refers to a function or data to be supplied by an Application
-that uses the facility (other than as an argument passed when the
-facility is invoked), then you may convey a copy of the modified
-version:
-
-   a) under this License, provided that you make a good faith effort to
-   ensure that, in the event an Application does not supply the
-   function or data, the facility still operates, and performs
-   whatever part of its purpose remains meaningful, or
-
-   b) under the GNU GPL, with none of the additional permissions of
-   this License applicable to that copy.
-
-  3. Object Code Incorporating Material from Library Header Files.
-
-  The object code form of an Application may incorporate material from
-a header file that is part of the Library.  You may convey such object
-code under terms of your choice, provided that, if the incorporated
-material is not limited to numerical parameters, data structure
-layouts and accessors, or small macros, inline functions and templates
-(ten or fewer lines in length), you do both of the following:
-
-   a) Give prominent notice with each copy of the object code that the
-   Library is used in it and that the Library and its use are
-   covered by this License.
-
-   b) Accompany the object code with a copy of the GNU GPL and this license
-   document.
-
-  4. Combined Works.
-
-  You may convey a Combined Work under terms of your choice that,
-taken together, effectively do not restrict modification of the
-portions of the Library contained in the Combined Work and reverse
-engineering for debugging such modifications, if you also do each of
-the following:
-
-   a) Give prominent notice with each copy of the Combined Work that
-   the Library is used in it and that the Library and its use are
-   covered by this License.
-
-   b) Accompany the Combined Work with a copy of the GNU GPL and this license
-   document.
-
-   c) For a Combined Work that displays copyright notices during
-   execution, include the copyright notice for the Library among
-   these notices, as well as a reference directing the user to the
-   copies of the GNU GPL and this license document.
-
-   d) Do one of the following:
-
-       0) Convey the Minimal Corresponding Source under the terms of this
-       License, and the Corresponding Application Code in a form
-       suitable for, and under terms that permit, the user to
-       recombine or relink the Application with a modified version of
-       the Linked Version to produce a modified Combined Work, in the
-       manner specified by section 6 of the GNU GPL for conveying
-       Corresponding Source.
-
-       1) Use a suitable shared library mechanism for linking with the
-       Library.  A suitable mechanism is one that (a) uses at run time
-       a copy of the Library already present on the user's computer
-       system, and (b) will operate properly with a modified version
-       of the Library that is interface-compatible with the Linked
-       Version.
-
-   e) Provide Installation Information, but only if you would otherwise
-   be required to provide such information under section 6 of the GNU
-   GPL, and only to the extent that such information is
-   necessary to install and execute a modified version of the
-   Combined Work produced by recombining or relinking the
-   Application with a modified version of the Linked Version. (If
-   you use option 4d0, the Installation Information must accompany
-   the Minimal Corresponding Source and Corresponding Application
-   Code. If you use option 4d1, you must provide the Installation
-   Information in the manner specified by section 6 of the GNU GPL
-   for conveying Corresponding Source.)
-
-  5. Combined Libraries.
-
-  You may place library facilities that are a work based on the
-Library side by side in a single library together with other library
-facilities that are not Applications and are not covered by this
-License, and convey such a combined library under terms of your
-choice, if you do both of the following:
-
-   a) Accompany the combined library with a copy of the same work based
-   on the Library, uncombined with any other library facilities,
-   conveyed under the terms of this License.
-
-   b) Give prominent notice with the combined library that part of it
-   is a work based on the Library, and explaining where to find the
-   accompanying uncombined form of the same work.
-
-  6. Revised Versions of the GNU Lesser General Public License.
-
-  The Free Software Foundation may publish revised and/or new versions
-of the GNU Lesser General Public License from time to time. Such new
-versions will be similar in spirit to the present version, but may
-differ in detail to address new problems or concerns.
-
-  Each version is given a distinguishing version number. If the
-Library as you received it specifies that a certain numbered version
-of the GNU Lesser General Public License "or any later version"
-applies to it, you have the option of following the terms and
-conditions either of that published version or of any later version
-published by the Free Software Foundation. If the Library as you
-received it does not specify a version number of the GNU Lesser
-General Public License, you may choose any version of the GNU Lesser
-General Public License ever published by the Free Software Foundation.
-
-  If the Library as you received it specifies that a proxy can decide
-whether future versions of the GNU Lesser General Public License shall
-apply, that proxy's public statement of acceptance of any version is
-permanent authorization for you to choose that version for the
-Library.

llm_api.lua

@@ -0,0 +1,314 @@
+-- llm_api.lua
+-- Central LLM API interface for LLM-Connect (v0.8+)
+
+local core = core
+local M = {}
+
+-- Internal states
+M.http = nil
+M.config = {
+    api_key             = "",
+    api_url             = "",
+    model               = "",
+    max_tokens          = 4000,
+    max_tokens_integer  = true,
+    temperature         = 0.7,
+    top_p               = 0.9,
+    presence_penalty    = 0.0,
+    frequency_penalty   = 0.0,
+    timeout             = 120,    -- global fallback
+    timeout_chat        = 0,      -- 0 = use global
+    timeout_ide         = 0,
+    timeout_we          = 0,
+    language            = "en",
+    language_repeat     = 1,
+    -- context
+    context_max_history = 20,
+    -- ide
+    ide_naming_guide        = true,
+    ide_include_run_output  = true,
+    ide_context_mod_list    = true,
+    ide_context_node_sample = true,
+    ide_max_code_context    = 300,
+    -- worldedit
+    we_max_iterations       = 6,
+    we_snapshot             = true,
+}
+
+local language_instruction_cache = nil
+
+-- ============================================================
+-- Initialization
+-- ============================================================
+
+function M.init(http_api)
+    if not http_api then
+        core.log("error", "[llm_api] No HTTP API provided")
+        return false
+    end
+    M.http = http_api
+
+    -- Load settings once
+    M.reload_config()
+    return true
+end
+
+-- ============================================================
+-- Configuration loading / updating
+-- ============================================================
+
+function M.reload_config()
+    -- Read exact keys from settingtypes.txt
+    M.config.api_key    = core.settings:get("llm_api_key")    or ""
+    M.config.api_url    = core.settings:get("llm_api_url")    or ""
+    M.config.model      = core.settings:get("llm_model")      or ""
+
+    M.config.max_tokens = tonumber(core.settings:get("llm_max_tokens")) or 4000
+    M.config.max_tokens_integer = core.settings:get_bool("llm_max_tokens_integer", true)
+
+    M.config.temperature       = tonumber(core.settings:get("llm_temperature")) or 0.7
+    M.config.top_p             = tonumber(core.settings:get("llm_top_p")) or 0.9
+    M.config.presence_penalty  = tonumber(core.settings:get("llm_presence_penalty")) or 0.0
+    M.config.frequency_penalty = tonumber(core.settings:get("llm_frequency_penalty")) or 0.0
+
+    M.config.timeout          = tonumber(core.settings:get("llm_timeout")) or 120
+    M.config.timeout_chat     = tonumber(core.settings:get("llm_timeout_chat")) or 0
+    M.config.timeout_ide      = tonumber(core.settings:get("llm_timeout_ide"))  or 0
+    M.config.timeout_we       = tonumber(core.settings:get("llm_timeout_we"))   or 0
+
+    M.config.language         = core.settings:get("llm_language") or "en"
+    M.config.language_repeat  = tonumber(core.settings:get("llm_language_instruction_repeat")) or 1
+
+    M.config.context_max_history = tonumber(core.settings:get("llm_context_max_history")) or 20
+
+    M.config.ide_naming_guide        = core.settings:get_bool("llm_ide_naming_guide", true)
+    M.config.ide_include_run_output  = core.settings:get_bool("llm_ide_include_run_output", true)
+    M.config.ide_context_mod_list    = core.settings:get_bool("llm_ide_context_mod_list", true)
+    M.config.ide_context_node_sample = core.settings:get_bool("llm_ide_context_node_sample", true)
+    M.config.ide_max_code_context    = tonumber(core.settings:get("llm_ide_max_code_context")) or 300
+
+    M.config.we_max_iterations = tonumber(core.settings:get("llm_we_max_iterations")) or 6
+    M.config.we_snapshot       = core.settings:get_bool("llm_we_snapshot_before_exec", true)
+
+    -- Invalidate cache
+    language_instruction_cache = nil
+
+end
+
+-- Returns the effective timeout for a given mode ("chat", "ide", "we").
+-- Uses per-mode override if > 0, otherwise falls back to global llm_timeout.
+function M.get_timeout(mode)
+    local override = 0
+    if mode == "chat" then override = M.config.timeout_chat
+    elseif mode == "ide"  then override = M.config.timeout_ide
+    elseif mode == "we"   then override = M.config.timeout_we
+    end
+    if override and override > 0 then return override end
+    return M.config.timeout
+end    
+
+function M.set_config(updates)
+    for k, v in pairs(updates) do
+        if M.config[k] ~= nil then
+            M.config[k] = v
+        end
+    end
+    language_instruction_cache = nil
+end
+
+function M.is_configured()
+    return M.config.api_key ~= "" and
+           M.config.api_url ~= "" and
+           M.config.model  ~= ""
+end
+
+-- ============================================================
+-- Language instruction (cached)
+-- ============================================================
+
+local function get_language_instruction()
+    if language_instruction_cache then
+        return language_instruction_cache
+    end
+
+    local lang = M.config.language
+    local repeat_count = math.max(0, M.config.language_repeat or 1)
+
+    if lang == "en" or repeat_count == 0 then
+        language_instruction_cache = ""
+        return ""
+    end
+
+    local lang_name = "English"
+    local lang_mod_path = core.get_modpath("llm_connect") .. "/ide_languages.lua"
+    local ok, lang_mod = pcall(dofile, lang_mod_path)
+    if ok and lang_mod and lang_mod.get_language_name then
+        lang_name = lang_mod.get_language_name(lang) or lang_name
+    end
+
+    local instr = "Important: Answer exclusively in " .. lang_name .. "!\n" ..
+                  "All explanations, code, comments, output and any text you generate must be in " .. lang_name .. "."
+
+    local parts = {}
+    for _ = 1, repeat_count do
+        table.insert(parts, instr)
+    end
+
+    language_instruction_cache = table.concat(parts, "\n\n") .. "\n\n"
+    return language_instruction_cache
+end
+
+-- ============================================================
+-- Request Function
+-- ============================================================
+
+function M.request(messages, callback, options)
+    if not M.is_configured() then
+        callback({ success = false, error = "LLM API not configured (Check API Key/URL/Model)" })
+        return
+    end
+
+    options = options or {}
+    local cfg = M.config
+
+    local lang_instr = get_language_instruction()
+    if lang_instr ~= "" and (not messages[1] or messages[1].role ~= "system") then
+        table.insert(messages, 1, { role = "system", content = lang_instr })
+    end
+
+    local body_table = {
+        model               = options.model or cfg.model,
+        messages            = messages,
+        max_tokens          = options.max_tokens or cfg.max_tokens,
+        temperature         = options.temperature or cfg.temperature,
+        top_p               = options.top_p or cfg.top_p,
+        presence_penalty    = options.presence_penalty or cfg.presence_penalty,
+        frequency_penalty   = options.frequency_penalty or cfg.frequency_penalty,
+        stream              = options.stream == true,
+    }
+
+    if options.tools then
+        body_table.tools = options.tools
+        body_table.tool_choice = options.tool_choice or "auto"
+    end
+
+    local max_t = body_table.max_tokens
+    if cfg.max_tokens_integer then
+        body_table.max_tokens = math.floor(max_t)
+    else
+        body_table.max_tokens = tonumber(max_t)
+    end
+
+    local body = core.write_json(body_table)
+
+    if cfg.max_tokens_integer then
+        body = body:gsub('"max_tokens"%s*:%s*(%d+)%.0', '"max_tokens": %1')
+    end
+
+    if core.settings:get_bool("llm_debug") then
+        core.log("action", "[llm_api] Requesting " .. cfg.model .. " at " .. cfg.api_url)
+    end
+
+    M.http.fetch({
+        url     = cfg.api_url,
+        method  = "POST",
+        data    = body,
+        timeout = options.timeout or cfg.timeout,
+        extra_headers = {
+            "Content-Type: application/json",
+            "Authorization: Bearer " .. cfg.api_key,
+        },
+    }, function(result)
+        if not result.succeeded then
+            local err = "HTTP request failed"
+            if result.timeout then
+                err = "Request timed out (limit: " .. tostring(options.timeout or cfg.timeout) .. "s)"
+            elseif result.code then
+                err = "HTTP " .. tostring(result.code)
+            elseif result.error then
+                -- Proxy-level errors (Envoy overflow, connection reset, etc.)
+                local raw = tostring(result.error)
+                if raw:find("overflow") or raw:find("reset") or raw:find("upstream") then
+                    err = "Proxy/upstream error (possibly Mistral overload or rate limit). Retry in a moment."
+                else
+                    err = raw
+                end
+            end
+            callback({ success = false, error = err, code = result.code })
+            return
+        end
+
+        -- Handle non-JSON responses (proxy errors often return plain text)
+        local raw_data = tostring(result.data or "")
+        if raw_data:find("upstream connect error") or raw_data:find("reset reason") then
+            callback({ success = false, error = "Proxy/upstream error: " .. raw_data:sub(1, 80) .. " – possibly Mistral overload, retry in a moment." })
+            return
+        end
+
+        local response = core.parse_json(result.data)
+        if not response or type(response) ~= "table" then
+            local raw_preview = raw_data:sub(1, 120)
+            callback({ success = false, error = "Invalid JSON response: " .. raw_preview })
+            return
+        end
+
+        if response.error then
+            callback({
+                success = false,
+                error = response.error.message or "API error",
+                error_type = response.error.type,
+                code = response.error.code
+            })
+            return
+        end
+
+        local content = nil
+        if response.choices and response.choices[1] then
+            content = response.choices[1].message.content
+        elseif response.message and response.message.content then
+            content = response.message.content
+        end
+
+        local ret = {
+            success     = content ~= nil,
+            content     = content,
+            raw         = response,
+            finish_reason = response.choices and response.choices[1] and response.choices[1].finish_reason,
+            usage       = response.usage,
+        }
+
+        if response.choices and response.choices[1] and response.choices[1].message.tool_calls then
+            ret.tool_calls = response.choices[1].message.tool_calls
+        end
+
+        if core.settings:get_bool("llm_debug") then
+            core.log("action", "[llm_api DEBUG] Raw response: " .. tostring(result.data or "no data"))
+            core.log("action", "[llm_api DEBUG] Parsed: " .. core.write_json(response or {}, true))
+        end
+
+        callback(ret)
+    end)
+end
+
+-- ============================================================
+-- Helper Wrappers
+-- ============================================================
+
+function M.chat(messages, callback, options)
+    M.request(messages, callback, options)
+end
+
+function M.ask(system_prompt, user_message, callback, options)
+    local messages = {
+        { role = "system", content = system_prompt },
+        { role = "user",   content = user_message },
+    }
+    M.request(messages, callback, options)
+end
+
+function M.code(system_prompt, code_block, callback, options)
+    local user_msg = "```lua\n" .. code_block .. "\n```"
+    M.ask(system_prompt, user_msg, callback, options)
+end
+
+return M

llm_materials_context.lua

@@ -1,79 +0,0 @@
--- mods/llm_connect/llm_materials_context.lua
-
-local M = {}
-
--- Cache for materials to avoid recomputation
-local materials_cache = nil
-local materials_cache_hash = nil
-
--- Compute a hash for registered items to detect changes
-local function compute_materials_hash()
-    local str = ""
-    for name, _ in pairs(core.registered_nodes) do str = str .. name end
-    for name, _ in pairs(core.registered_craftitems) do str = str .. name end
-    for name, _ in pairs(core.registered_tools) do str = str .. name end
-    for name, _ in pairs(core.registered_entities) do str = str .. name end
-    return core.sha1(str)
-end
-
--- Function to collect available materials
-function M.get_available_materials()
-    local current_hash = compute_materials_hash()
-    if materials_cache and materials_cache_hash == current_hash then
-        return materials_cache
-    end
-
-    local materials_info = {}
-    local current_mod_name = core.get_current_modname()
-
-    -- Collect nodes
-    for name, def in pairs(core.registered_nodes) do
-        if not name:match("^__builtin:") and not name:match("^ignore$") and not name:match("^air$") then
-            table.insert(materials_info, "Node: " .. name)
-        end
-    end
-
-    -- Collect craftitems
-    for name, def in pairs(core.registered_craftitems) do
-        if not name:match("^__builtin:") then
-            table.insert(materials_info, "Craftitem: " .. name)
-        end
-    end
-
-    -- Collect tools
-    for name, def in pairs(core.registered_tools) do
-        if not name:match("^__builtin:") then
-            table.insert(materials_info, "Tool: " .. name)
-        end
-    end
-
-    -- Collect entities
-    for name, def in pairs(core.registered_entities) do
-        if not name:match("^__builtin:") then
-            table.insert(materials_info, "Entity: " .. name)
-        end
-    end
-
-    -- Limit the output
-    local max_items_to_list = 50 -- Reduced for token efficiency
-    local total_items = #materials_info
-    local output_string = ""
-
-    if total_items > 0 then
-        output_string = "Registered materials (" .. total_items .. " in total):\n"
-        for i = 1, math.min(total_items, max_items_to_list) do
-            output_string = output_string .. "  - " .. materials_info[i] .. "\n"
-        end
-        if total_items > max_items_to_list then
-            output_string = output_string .. "  ... and " .. (total_items - max_items_to_list) .. " more materials (truncated).\n"
-        end
-    else
-        output_string = "No registered materials found.\n"
-    end
-
-    materials_cache = output_string
-    materials_cache_hash = current_hash
-    return output_string
-end
-
-return M

material_picker.lua

@@ -0,0 +1,371 @@
+-- material_picker.lua  v2.0
+-- Inventory-style material selection for the LLM WorldEdit context
+--
+-- UI: Tiles with item icons (item_image) + colored highlight when active
+--     Search filter at the top, Toggle-All button, Remove-All button
+--     Tiles are buttons → click toggles selection
+--
+-- PUBLIC API (used by chat_gui.lua / llm_worldedit.lua):
+--   M.get_materials(player_name)           → sorted list of node name strings
+--   M.has_materials(player_name)           → bool
+--   M.build_material_context(player_name)  → string for LLM system prompt
+--   M.show(player_name)                    → open formspec
+--   M.handle_fields(player_name, formname, fields) → bool
+
+local core = core
+local M    = {}
+
+-- ============================================================
+-- Configuration
+-- ============================================================
+
+local COLS        = 8     -- tiles per row
+local TILE_SIZE   = 1.4   -- tile width/height in formspec units
+local TILE_PAD    = 0.08  -- spacing between tiles
+local MAX_NODES   = 128   -- max candidates to render
+
+-- ============================================================
+-- Session state
+-- ============================================================
+
+local sessions = {}
+
+local function get_session(name)
+    if not sessions[name] then
+        sessions[name] = {
+            materials  = {},   -- [node_name] = true
+            filter     = "",
+            page       = 1,    -- current page (pagination)
+        }
+    end
+    return sessions[name]
+end
+
+core.register_on_leaveplayer(function(player)
+    sessions[player:get_player_name()] = nil
+end)
+
+-- ============================================================
+-- PUBLIC API
+-- ============================================================
+
+function M.get_materials(player_name)
+    local sess = get_session(player_name)
+    local list = {}
+    for node in pairs(sess.materials) do
+        table.insert(list, node)
+    end
+    table.sort(list)
+    return list
+end
+
+function M.has_materials(player_name)
+    local sess = get_session(player_name)
+    for _ in pairs(sess.materials) do return true end
+    return false
+end
+
+function M.build_material_context(player_name)
+    local mats = M.get_materials(player_name)
+    if #mats == 0 then return nil end
+    return table.concat({
+        "--- PLAYER-SELECTED BUILD MATERIALS ---",
+        "The player has explicitly chosen the following node(s) for this build.",
+        "Prefer these exact node names when generating tool_calls.",
+        "Nodes: " .. table.concat(mats, ", "),
+        "--- END MATERIALS ---",
+    }, "\n")
+end
+
+-- ============================================================
+-- Registry filter
+-- ============================================================
+
+local function build_candidate_list(filter)
+    filter = (filter or ""):lower():trim()
+    local candidates = {}
+
+    for name, def in pairs(core.registered_nodes) do
+        if not name:match("^__builtin")
+            and name ~= "air" and name ~= "ignore"
+        then
+            if filter == ""
+                or name:lower():find(filter, 1, true)
+                or (def.description and def.description:lower():find(filter, 1, true))
+            then
+                table.insert(candidates, name)
+            end
+        end
+    end
+
+    table.sort(candidates)
+    return candidates
+end
+
+-- ============================================================
+-- Formspec builder
+-- ============================================================
+
+-- Calculates page count
+local function get_page_info(total, per_page, current_page)
+    local total_pages = math.max(1, math.ceil(total / per_page))
+    current_page = math.max(1, math.min(current_page, total_pages))
+    local first = (current_page - 1) * per_page + 1
+    local last  = math.min(total, current_page * per_page)
+    return current_page, total_pages, first, last
+end
+
+local ITEMS_PER_PAGE = COLS * 6  -- 6 rows = 48 tiles per page
+
+function M.show(player_name)
+    local sess       = get_session(player_name)
+    local filter     = sess.filter or ""
+    local candidates = build_candidate_list(filter)
+    local total      = #candidates
+
+    local page, total_pages, first, last =
+        get_page_info(total, ITEMS_PER_PAGE, sess.page)
+    sess.page = page  -- write corrected page back
+
+    local selected_count = 0
+    for _ in pairs(sess.materials) do selected_count = selected_count + 1 end
+
+    -- ── Dimensions ────────────────────────────────────────
+    local W       = COLS * (TILE_SIZE + TILE_PAD) + 0.5
+    local HDR_H   = 0.9
+    local SRCH_H  = 0.7
+    local INFO_H  = 0.4
+    local GRID_H  = 6 * (TILE_SIZE + TILE_PAD)
+    local NAV_H   = 0.7
+    local BTN_H   = 0.75
+    local PAD     = 0.25
+    local H       = HDR_H + PAD + SRCH_H + PAD + INFO_H + PAD + GRID_H + PAD + NAV_H + PAD + BTN_H + PAD
+
+    local fs = {
+        "formspec_version[6]",
+        "size[" .. string.format("%.2f", W) .. "," .. string.format("%.2f", H) .. "]",
+        "bgcolor[#0d0d0d;both]",
+        "style_type[*;bgcolor=#181818;textcolor=#e0e0e0]",
+    }
+
+    -- ── Header ─────────────────────────────────────────────
+    table.insert(fs, "box[0,0;" .. string.format("%.2f", W) .. "," .. HDR_H .. ";#1e1e2e]")
+    table.insert(fs, "label[" .. PAD .. ",0.35;⚙ Build Materials — "
+        .. core.formspec_escape(player_name)
+        .. " (" .. selected_count .. " selected)]")
+    table.insert(fs, "style[close_picker;bgcolor=#3a1a1a;textcolor=#ffaaaa]")
+    table.insert(fs, "button[" .. string.format("%.2f", W - PAD - 2.0) .. ",0.12;2.0,0.65;close_picker;✕ Close]")
+
+    local y = HDR_H + PAD
+
+    -- ── Search field ────────────────────────────────────────
+    local field_w = W - PAD * 2 - 2.6
+    table.insert(fs, "field[" .. PAD .. "," .. y .. ";" .. string.format("%.2f", field_w) .. "," .. SRCH_H
+        .. ";filter;;" .. core.formspec_escape(filter) .. "]")
+    table.insert(fs, "style[filter;bgcolor=#111122;textcolor=#ccccff]")
+    table.insert(fs, "field_close_on_enter[filter;false]")
+    table.insert(fs, "style[do_filter;bgcolor=#1a1a3a;textcolor=#aaaaff]")
+    table.insert(fs, "button[" .. string.format("%.2f", PAD + field_w + 0.1) .. "," .. y
+        .. ";2.4," .. SRCH_H .. ";do_filter;⟳ Search]")
+    y = y + SRCH_H + PAD
+
+    -- ── Info row + Toggle-All ─────────────────────────────
+    local info_str
+    if total == 0 then
+        info_str = "No nodes found"
+    else
+        info_str = string.format("%d node(s) — page %d/%d", total, page, total_pages)
+    end
+    table.insert(fs, "label[" .. PAD .. "," .. (y + 0.05) .. ";" .. core.formspec_escape(info_str) .. "]")
+
+    -- Toggle-All button (select/deselect all on this page)
+    local page_nodes = {}
+    for i = first, last do
+        table.insert(page_nodes, candidates[i])
+    end
+    local page_all_selected = #page_nodes > 0
+    for _, n in ipairs(page_nodes) do
+        if not sess.materials[n] then page_all_selected = false; break end
+    end
+    local toggle_label = page_all_selected and "☑ Deselect Page" or "☐ Select Page"
+    local toggle_color = page_all_selected and "#2a4a2a" or "#333344"
+    table.insert(fs, "style[toggle_page;bgcolor=" .. toggle_color .. ";textcolor=#ccffcc]")
+    table.insert(fs, "button[" .. string.format("%.2f", W - PAD - 3.5) .. "," .. (y - 0.05)
+        .. ";3.5," .. INFO_H+0.1 .. ";toggle_page;" .. toggle_label .. "]")
+    y = y + INFO_H + PAD
+
+    -- ── Tile grid ────────────────────────────────────────
+    -- Each tile = item_image_button (icon) + colored background when active
+    local col = 0
+    local row = 0
+    local IMG  = TILE_SIZE - 0.25
+    local STEP = TILE_SIZE + TILE_PAD
+
+    for idx, node_name in ipairs(page_nodes) do
+        local tx = PAD + col * STEP
+        local ty = y  + row * STEP
+
+        local is_sel = sess.materials[node_name] == true
+
+        -- Background box: green if selected, dark if not
+        local bg_color = is_sel and "#1a3a1a" or "#1a1a1a"
+        table.insert(fs, "box[" .. string.format("%.2f,%.2f;%.2f,%.2f", tx, ty, TILE_SIZE, TILE_SIZE)
+            .. ";" .. bg_color .. "]")
+
+        -- Item image button (clickable, shows icon)
+        -- button name encodes the candidate index: "tile_N"
+        local btn_name = "tile_" .. tostring((page - 1) * ITEMS_PER_PAGE + idx)
+        -- item_image_button[x,y;w,h;item;name;label]
+        table.insert(fs, "item_image_button["
+            .. string.format("%.2f,%.2f;%.2f,%.2f", tx + 0.05, ty + 0.05, IMG, IMG)
+            .. ";" .. core.formspec_escape(node_name)
+            .. ";" .. btn_name .. ";]")
+
+        -- Checkmark label top-right when selected
+        if is_sel then
+            table.insert(fs, "label["
+                .. string.format("%.2f,%.2f", tx + TILE_SIZE - 0.38, ty + 0.18)
+                .. ";§(c=#00ff00)✔]")
+        end
+
+        -- Tooltip: node name
+        local def = core.registered_nodes[node_name]
+        local desc = (def and def.description and def.description ~= "")
+            and def.description or node_name
+        table.insert(fs, "tooltip[" .. btn_name .. ";"
+            .. core.formspec_escape(desc .. "\n" .. node_name) .. "]")
+
+        col = col + 1
+        if col >= COLS then
+            col = 0
+            row = row + 1
+        end
+    end
+
+    y = y + GRID_H + PAD
+
+    -- ── Navigation ─────────────────────────────────────────
+    local nav_btn_w = 2.2
+    if total_pages > 1 then
+        table.insert(fs, "style[page_prev;bgcolor=#222233;textcolor=#aaaaff]")
+        table.insert(fs, "button[" .. PAD .. "," .. y .. ";" .. nav_btn_w .. "," .. NAV_H .. ";page_prev;◀ Prev]")
+        table.insert(fs, "style[page_next;bgcolor=#222233;textcolor=#aaaaff]")
+        table.insert(fs, "button[" .. string.format("%.2f", W - PAD - nav_btn_w) .. "," .. y
+            .. ";" .. nav_btn_w .. "," .. NAV_H .. ";page_next;Next ▶]")
+    end
+    y = y + NAV_H + PAD
+
+    -- ── Bottom buttons ──────────────────────────────────────
+    local b_w = (W - PAD * 3) / 2
+    table.insert(fs, "style[clear_all;bgcolor=#3a1a1a;textcolor=#ff8888]")
+    table.insert(fs, "button[" .. PAD .. "," .. y .. ";" .. string.format("%.2f", b_w) .. "," .. BTN_H
+        .. ";clear_all;✕ Clear All Selected]")
+
+    table.insert(fs, "style[close_and_back;bgcolor=#1a2a1a;textcolor=#aaffaa]")
+    table.insert(fs, "button[" .. string.format("%.2f", PAD * 2 + b_w) .. "," .. y
+        .. ";" .. string.format("%.2f", b_w) .. "," .. BTN_H .. ";close_and_back;✓ Done]")
+
+    core.show_formspec(player_name, "llm_connect:material_picker", table.concat(fs))
+end
+
+-- ============================================================
+-- Formspec handler
+-- ============================================================
+
+function M.handle_fields(player_name, formname, fields)
+    if not formname:match("^llm_connect:material_picker") then
+        return false
+    end
+
+    local sess = get_session(player_name)
+    local candidates = build_candidate_list(sess.filter)
+    local total      = #candidates
+
+    -- Update filter (live)
+    if fields.filter ~= nil then
+        sess.filter = fields.filter
+    end
+
+    -- ── Search / filter ──────────────────────────────────
+    if fields.do_filter or fields.key_enter_field == "filter" then
+        sess.page = 1
+        M.show(player_name)
+        return true
+    end
+
+    -- ── Pagination ──────────────────────────────────────
+    local page, total_pages = get_page_info(total, ITEMS_PER_PAGE, sess.page)
+
+    if fields.page_prev then
+        sess.page = math.max(1, page - 1)
+        M.show(player_name)
+        return true
+    end
+
+    if fields.page_next then
+        sess.page = math.min(total_pages, page + 1)
+        M.show(player_name)
+        return true
+    end
+
+    -- ── Toggle page ──────────────────────────────────────
+    if fields.toggle_page then
+        local _, _, first, last = get_page_info(total, ITEMS_PER_PAGE, sess.page)
+        -- Check if all are selected
+        local all_sel = true
+        for i = first, last do
+            if not sess.materials[candidates[i]] then all_sel = false; break end
+        end
+        -- Toggle
+        for i = first, last do
+            if all_sel then
+                sess.materials[candidates[i]] = nil
+            else
+                sess.materials[candidates[i]] = true
+            end
+        end
+        M.show(player_name)
+        return true
+    end
+
+    -- ── Clear all ────────────────────────────────────────
+    if fields.clear_all then
+        sess.materials = {}
+        M.show(player_name)
+        return true
+    end
+
+    -- ── Close / done ─────────────────────────────────────
+    if fields.close_picker or fields.close_and_back or fields.quit then
+        -- Signal to chat_gui: picker closed → re-open chat GUI
+        -- (handled in handle_fields of chat_gui.lua / init.lua)
+        return true
+    end
+
+    -- ── Tile buttons: tile_N ────────────────────────────
+    -- Format: tile_<global_index>  (1-based across all pages)
+    for field_name, _ in pairs(fields) do
+        local global_idx = field_name:match("^tile_(%d+)$")
+        if global_idx then
+            global_idx = tonumber(global_idx)
+            local node = candidates[global_idx]
+            if node then
+                if sess.materials[node] then
+                    sess.materials[node] = nil
+                    core.chat_send_player(player_name, "[LLM] ✕ " .. node)
+                else
+                    sess.materials[node] = true
+                    core.chat_send_player(player_name, "[LLM] ✓ " .. node)
+                end
+            end
+            M.show(player_name)
+            return true
+        end
+    end
+
+    return true
+end
+
+-- ============================================================
+core.log("action", "[llm_connect] material_picker.lua v2.0 loaded")
+return M

mod.conf

@@ -1,26 +1,7 @@
 name = llm_connect
-description = Connects your Luanti/Minetest server to an LLM (Large Language Model) using an OpenAI-compatible API endpoint.
+description = Connects your Luanti server to an LLM + integrated AI-powered Lua IDE
 title = LLM Connect
 author = H5N3RG
 license = LGPL-3.0-or-later
-media_license = LGPL-3.0-or-later
+version = 0.9.0-dev
-forum =
+optional_depends = worldedit, worldeditadditions
-depends =
-optional_depends =
-version = 0.7.8
-
-# === Default Settings ===
-llm_max_tokens_integer = true
-llm_api_key =
-llm_api_url =
-llm_model =
-
-# === Default Context Settings ===
-llm_context_send_server_info = true
-llm_context_send_mod_list = false
-llm_context_send_commands = true
-llm_context_send_player_pos = true
-llm_context_send_materials = false
-
-
-

settingtypes.txt

@@ -1,36 +1,92 @@
 # ===========================================================================
-# LLM Connect - Luanti/Minetest mod settings
+# LLM Connect - Luanti/Minetest Mod Settings
 # ===========================================================================
-# Configure the LLM connection and behavior in the in-game menu
+# LLM Connection, Chat, IDE, WorldEdit & Prompt Behavior
-# Internal name, (Label), Type, Default, [min max for int/float]
+# Version: 0.9.0
 # ===========================================================================
 
-# Determines whether max_tokens is sent as integer (true) or float (false)
+# === LLM API Base Settings ===
-llm_max_tokens_integer   (Send max_tokens as integer) bool true
 
-# Your API key for the LLM endpoint
+llm_api_key              (API Key)                            string
-llm_api_key              (API Key) string
+llm_api_url              (API URL – OpenAI compatible)        string
+llm_model                (Model Name)                         string
 
-# The URL of the OpenAI-compatible LLM endpoint
+llm_max_tokens           (Max Tokens – Response length)       int    4000   500   16384
-llm_api_url              (API URL) string
+llm_max_tokens_integer   (Send max_tokens as integer)         bool   true
 
-# The model to use
+llm_temperature          (Temperature – Creativity 0..2)      float  0.7    0.0   2.0
-[cite_start]for the LLM (leave empty for none) [cite: 34]
+llm_top_p                (Top P – Nucleus Sampling 0..1)      float  0.9    0.0   1.0
-llm_model                (Model) string
+llm_presence_penalty     (Presence Penalty – -2..2)           float  0.0   -2.0   2.0
+llm_frequency_penalty    (Frequency Penalty – -2..2)          float  0.0   -2.0   2.0
 
-# === Context Configuration ===
+# Global timeout for ALL LLM requests (chat, IDE, WorldEdit).
+# Per-mode overrides (llm_timeout_chat/ide/we) take precedence if set > 0.
+# Default: 120 seconds. Range: 30–600.
+llm_timeout              (Global Request Timeout in seconds)  int    120    30    600
 
-# Send server name, description, motd, gameid, port, worldpath, mapgen
+# Per-mode timeout overrides. Set to 0 to use the global llm_timeout.
-llm_context_send_server_info (Send Server Info) bool true
+llm_timeout_chat         (Chat mode timeout override, 0=global)      int  0   0   600
+llm_timeout_ide          (IDE mode timeout override, 0=global)       int  0   0   600
+llm_timeout_we           (WorldEdit mode timeout override, 0=global) int  0   0   600
 
-# Send the list of all installed mods
+llm_debug                (Enable debug logging)               bool   false
-llm_context_send_mod_list (Send Mod List) bool false
 
-# Send the list of all available chat commands
-llm_context_send_commands (Send Commands List) bool true
 
-# Send the player's current position (x,y,z)
+# === Chat Context ===
-llm_context_send_player_pos (Send Player Position) bool true
 
-# Send the list of registered nodes, craftitems, tools, and entities
+llm_context_send_server_info   (Send server info to LLM)           bool   true
-llm_context_send_materials (Send Available Materials) bool false
+llm_context_send_mod_list      (Send list of active mods)          bool   false
+llm_context_send_commands      (Send available chat commands)       bool   true
+llm_context_send_player_pos    (Send player position and HP)        bool   true
+llm_context_send_materials     (Send node/item/tool registry sample) bool  false
+
+# Max chat history messages sent per LLM request. Oldest dropped first.
+llm_context_max_history        (Max chat history messages sent)     int    20    2   100
+
+
+# === Language ===
+
+llm_language                   (Response language)                  enum   en   en,de,es,fr,it,pt,ru,zh,ja,ko,ar,hi,tr,nl,pl,sv,da,no,fi,cs,hu,ro,el,th,vi,id,ms,he,bn,uk
+llm_language_instruction_repeat (Repeat language instruction)       int    1    0   5
+
+
+# === IDE – Behavior ===
+
+llm_ide_hot_reload             (Hot-reload world after execution)         bool   true
+llm_ide_auto_save              (Auto-save code buffer)                    bool   true
+llm_ide_live_suggestions       (Live suggestions – not yet implemented)   bool   false
+llm_ide_whitelist_enabled      (Sandbox security whitelist)               bool   true
+
+# Send last run output to LLM so it can self-correct after a failed execution.
+llm_ide_include_run_output     (Send last run output for self-correction) bool   true
+
+# Max lines of code sent as context. Prevents token overflow. 0 = no limit.
+llm_ide_max_code_context       (Max code lines sent to LLM, 0=unlimited) int    300   0   2000
+
+
+# === IDE – Guiding Prompts ===
+
+# Inject naming-convention guide into IDE LLM calls.
+# Teaches the model that registrations must use the "llm_connect:" prefix.
+llm_ide_naming_guide           (Inject naming convention guide)           bool   true
+
+# Inject context about active mods and nodes into Generate calls.
+llm_ide_context_mod_list       (Send mod list in IDE context)             bool   true
+llm_ide_context_node_sample    (Send node sample in IDE context)          bool   true
+
+
+# === WorldEdit ===
+
+llm_worldedit_additions        (Enable WorldEditAdditions tools)          bool   true
+llm_we_max_iterations          (Max iterations in WE Loop mode)           int    6     1   20
+llm_we_snapshot_before_exec    (Snapshot before each WE execution)        bool   true
+
+
+# ===========================================================================
+# Notes:
+# - llm_timeout_*: 0 = inherit global llm_timeout
+# - llm_language "en" = no language instruction injected (saves tokens)
+# - llm_ide_* settings only affect the Smart Lua IDE
+# - llm_we_* settings only affect WorldEdit agency mode
+# - Timeout/config changes take effect after /llm_config reload or restart
+# ===========================================================================

system_prompt.txt

@@ -1 +0,0 @@
-YOU ARE A HELPFUL, KNOWLEDGEABLE, AND FRIENDLY AI ASSISTANT FOR THE LUANTI (FORMERLY MINETEST) GAME PLATFORM. 

worldedit_system_prompts.lua

@@ -0,0 +1,114 @@
+-- worldedit_system_prompts.lua
+-- System prompts for LLM WorldEdit agency mode
+-- Used by llm_worldedit.lua
+
+local P = {}
+
+-- ============================================================
+-- Base prompt (single-shot and loop mode)
+-- ============================================================
+
+P.SYSTEM_PROMPT = [[You are a WorldEdit agent inside a Luanti (Minetest) voxel game.
+Your job is to translate the player's natural language building request into a sequence of WorldEdit tool calls.
+
+You will receive:
+- The player's current position (x, y, z)
+- Their current WorldEdit selection (pos1, pos2) if any
+- A coarse sample of nearby nodes
+- The list of available tools
+
+Respond ONLY with a JSON object:
+{
+  "plan": "<one-sentence description of what you will do>",
+  "tool_calls": [
+    {"tool": "<tool_name>", "args": { ... }},
+    ...
+  ]
+}
+
+Do NOT add explanation text outside the JSON.
+Do NOT invent tool names not in the available list.
+Use "air" to remove/clear nodes.
+Coordinates must be integers.
+
+Example response:
+{
+  "plan": "Place a 5x3x5 stone platform 2 blocks below the player.",
+  "tool_calls": [
+    {"tool": "set_pos1", "args": {"x": -12, "y": 63, "z": 44}},
+    {"tool": "set_pos2", "args": {"x": -8,  "y": 65, "z": 48}},
+    {"tool": "set_region", "args": {"node": "default:stone"}}
+  ]
+}
+]]
+
+-- ============================================================
+-- Loop mode addendum (appended to SYSTEM_PROMPT for run_loop)
+-- ============================================================
+
+P.LOOP_ADDENDUM = [[
+
+ADDITIONAL RULES FOR ITERATIVE MODE:
+
+STEP 1 ONLY – On the very first step (when you receive only "Goal: ..."):
+  - First write a short OVERALL PLAN as your "plan" field describing ALL steps you intend to take.
+  - Then execute only the FIRST part of that plan in tool_calls.
+  - Example: Goal is "build a house" → plan = "Step 1/4: Place 10x5x10 stone floor. Then: hollow walls, add roof, add door."
+
+SUBSEQUENT STEPS – You receive "Completed steps so far:" plus your original goal:
+  - Your "plan" field should say which step of your overall plan this is (e.g. "Step 2/4: Hollow out walls")
+  - Only execute the CURRENT step, not the whole plan at once.
+  - If a previous step failed, note it and adapt. Never repeat a failing call unchanged.
+
+DONE SIGNAL:
+  - Set "done": true only when the entire structure is complete.
+  - Set "done": true also if you are stuck after a failure.
+  - Always set "done": false if there are more steps remaining.
+
+COORDINATE DISCIPLINE:
+  - Always use absolute integer coordinates.
+  - pos arguments for sphere/dome/cylinder/pyramid/cube must be {x,y,z} — never a string.
+  - pos1 and pos2 define the region for set_region, replace, copy, move, stack, flip, rotate.
+
+Response format (strict JSON, no extra text):
+{
+  "plan":       "<step N/total: what this step does>",
+  "tool_calls": [ {"tool": "...", "args": {...}}, ... ],
+  "done":       false,
+  "reason":     ""
+}
+]]
+
+-- ============================================================
+-- WorldEditAdditions addendum (appended when WEA is available)
+-- ============================================================
+
+P.WEA_ADDENDUM = [[
+When WorldEditAdditions (WEA) tools are available, you may use them alongside standard WorldEdit tools.
+WEA tools require pos1 to be set (torus, ellipsoid, floodfill) or both pos1+pos2 (overlay, replacemix, layers, erode, convolve).
+
+WEA tool examples:
+- Torus:      {"tool": "torus",      "args": {"radius_major": 10, "radius_minor": 3, "node": "default:stone"}}
+- Ellipsoid:  {"tool": "ellipsoid",  "args": {"rx": 8, "ry": 5, "rz": 8, "node": "default:dirt"}}
+- Overlay:    {"tool": "overlay",    "args": {"node": "default:dirt_with_grass"}}
+- Layers:     {"tool": "layers",     "args": {"layers": [{"node": "default:dirt_with_grass", "depth": 1}, {"node": "default:dirt", "depth": 3}]}}
+- Erode:      {"tool": "erode",      "args": {"algorithm": "snowballs", "iterations": 2}}
+- Convolve:   {"tool": "convolve",   "args": {"kernel": "gaussian", "size": 5}}
+- Replacemix: {"tool": "replacemix", "args": {"target": "default:stone", "replacements": [{"node": "default:cobble", "chance": 2}, {"node": "default:mossy_cobble", "chance": 1}]}}
+]]
+
+-- ============================================================
+-- Convenience: build full system prompt strings
+-- ============================================================
+
+-- Single-shot prompt (with optional WEA addendum)
+function P.build_single(wea)
+    return P.SYSTEM_PROMPT .. (wea and P.WEA_ADDENDUM or "")
+end
+
+-- Loop prompt (with optional WEA addendum)
+function P.build_loop(wea)
+    return P.SYSTEM_PROMPT .. P.LOOP_ADDENDUM .. (wea and P.WEA_ADDENDUM or "")
+end
+
+return P