living-ai-documentation 2.0.0 → 2.3.0

package/dist/src/frontend/workspace/app.js

@@ -1,4 +1,4 @@
-import { loadWorkspaceState, saveWorkspaceState, } from "./persistence.js";
+import { loadWorkspaceState, saveWorkspaceState, testLlmConnection, listLlmModels, runAgentPrompt, } from "./persistence.js";
 const LEAF_WIDTH = 164;
 const LEAF_HEIGHT = 64;
 const ROOT_RADIUS = 132;
@@ -6,10 +6,10 @@ const PROVIDER_RADIUS = 78;
 const MIN_POLYGON_SIDES = 6;
 const GRID_MINOR = 24;
 const GRID_MAJOR = 96;
-const PANEL_MIN_WIDTH = 360;
-const PANEL_MAX_WIDTH = 520;
-const PANEL_VIEWPORT_RATIO = 1 / 3;
-const PANEL_HEIGHT = 650;
+const PANEL_MIN_WIDTH = 540;
+const PANEL_MAX_WIDTH = 780;
+const PANEL_VIEWPORT_RATIO = 1 / 2;
+const PANEL_HEIGHT = 9999;
 const PANEL_GAP = 44;
 const ROOT_CHILD_DISTANCE = 255;
 const PROVIDER_CHILD_DISTANCE = 178;
@@ -43,41 +43,70 @@ const ROOT_CLUSTER_RELAXATION_STEP = 48;
 const ROOT_CLUSTER_RELAXATION_ATTEMPTS = 7;
 const ROOT_CLUSTER_MAX_DISTANCE = ROOT_CHILD_DISTANCE + ROOT_CHILD_MAX_EXTRA_DISTANCE + 260;
 const SAVE_DEBOUNCE_MS = 450;
+const SAVE_TOAST_MS = 2600;
 const canvas = document.getElementById("workspaceCanvas");
 const ctx = canvas.getContext("2d");
 const apiStatus = document.getElementById("apiStatus");
 const addButton = document.getElementById("addButton");
 const fitButton = document.getElementById("fitButton");
-const resetButton = document.getElementById("resetButton");
+const testNodeButton = document.getElementById("testNodeButton");
+const loadModelsButton = document.getElementById("loadModelsButton");
+const closePanelButton = document.getElementById("closePanelButton");
 const deleteNodeButton = document.getElementById("deleteNodeButton");
+const renameConfirmOverlay = document.getElementById("renameConfirmOverlay");
+const renameConfirmMessage = document.getElementById("renameConfirmMessage");
+const cancelRenameButton = document.getElementById("cancelRenameButton");
+const confirmRenameButton = document.getElementById("confirmRenameButton");
 const deleteConfirmOverlay = document.getElementById("deleteConfirmOverlay");
 const deleteConfirmMessage = document.getElementById("deleteConfirmMessage");
 const cancelDeleteButton = document.getElementById("cancelDeleteButton");
 const confirmDeleteButton = document.getElementById("confirmDeleteButton");
+const agentRunOverlay = document.getElementById("agentRunOverlay");
+const agentRunTitle = document.getElementById("agentRunTitle");
+const agentRunHint = document.getElementById("agentRunHint");
+const agentRunInputField = document.getElementById("agentRunInputField");
+const agentRunInput = document.getElementById("agentRunInput");
+const agentRunResult = document.getElementById("agentRunResult");
+const cancelAgentRunButton = document.getElementById("cancelAgentRunButton");
+const executeAgentRunButton = document.getElementById("executeAgentRunButton");
 const fallbackPanelHost = document.getElementById("fallbackPanelHost");
 const configSurface = document.getElementById("configSurface");
 const form = configSurface;
+const workspaceToast = document.getElementById("workspaceToast");
+const workspaceToastIcon = document.getElementById("workspaceToastIcon");
+const workspaceToastMessage = document.getElementById("workspaceToastMessage");
+let toastTimerId = null;
+let savedAgentLabel = null;
+let savedAgentFolder = null;
+let agentRunTargetId = null;
 const fields = {
     name: document.getElementById("nodeName"),
     kind: document.getElementById("nodeKind"),
-    environment: document.getElementById("nodeEnvironment"),
     endpoint: document.getElementById("nodeEndpoint"),
     token: document.getElementById("nodeToken"),
+    model: document.getElementById("nodeModel"),
+    workspaceField: document.getElementById("agentWorkspaceField"),
+    workspaceFolder: document.getElementById("nodeWorkspaceFolder"),
     timeout: document.getElementById("nodeTimeout"),
-    retryPolicy: document.getElementById("nodeRetryPolicy"),
     description: document.getElementById("nodeDescription"),
     typeBadge: document.getElementById("nodeTypeBadge"),
-    healthBadge: document.getElementById("nodeHealthBadge"),
+    llmFields: document.getElementById("llmFields"),
     mcpInventory: document.getElementById("mcpInventory"),
+    agentSection: document.getElementById("agentSection"),
+    systemPrompt: document.getElementById("nodeSystemPrompt"),
+    requiresUserInput: document.getElementById("nodeRequiresUserInput"),
+    userInputDescriptionField: document.getElementById("agentUserInputDescriptionField"),
+    userInputDescription: document.getElementById("nodeUserInputDescription"),
+    expectedOutputMarker: document.getElementById("nodeExpectedOutputMarker"),
 };
 const initialEntities = [
     createEntity("root", "Living AI Documentation", "system", null),
-    createEntity("devstral", "DevStral2 LLM API", "llm", "root"),
-    createEntity("qwen", "Qwen2 LLM API", "llm", "root"),
     createEntity("mcp", "MCP", "mcp", "root"),
-    createEntity("review-agent", "Code Review Agent", "agent", "devstral"),
-    createEntity("sonar-agent", "Sonarqube Metrics Agent", "agent", "devstral"),
-    createEntity("doc-agent", "Documentation Agent", "agent", "qwen"),
+    //createEntity("devstral", "DevStral2 LLM API", "llm", "root"),
+    //createEntity("qwen", "Qwen2 LLM API", "llm", "root"),
+    //createEntity("review-agent", "Code Review Agent", "agent", "devstral"),
+    //createEntity("sonar-agent", "Sonarqube Metrics Agent", "agent", "devstral"),
+    //createEntity("doc-agent", "Documentation Agent", "agent", "qwen"),
 ];
 const state = {
     entities: cloneEntities(initialEntities),
@@ -135,16 +164,6 @@ fitButton.addEventListener("click", () => {
     scheduleWorkspaceSave();
     scheduleRender();
 });
-resetButton.addEventListener("click", () => {
-    state.entities = cloneEntities(initialEntities);
-    state.selectedId = null;
-    state.lastSaveAt = null;
-    layoutGraph();
-    resetView(true, true);
-    syncPanelFromSelection();
-    scheduleWorkspaceSave();
-    scheduleRender();
-});
 canvas.addEventListener("pointerdown", (event) => {
     if (event.target !== canvas) {
         return;
@@ -155,7 +174,8 @@ canvas.addEventListener("pointerdown", (event) => {
         .reverse()
         .find((entity) => isEntityHit(entity, worldPoint));
     if (hitEntity) {
-        selectEntity(hitEntity.id);
+        if (hitEntity.id !== "root")
+            selectEntity(hitEntity.id);
         return;
     }
     state.isPanning = true;
@@ -212,18 +232,23 @@ form.addEventListener("submit", (event) => {
     event.preventDefault();
     syncSelectedFromForm();
     state.lastSaveAt = new Date();
-    fields.healthBadge.textContent = "Applied";
     layoutGraph();
-    void saveWorkspaceNow();
+    void saveWorkspaceNow(true);
     scheduleRender();
 });
-form.addEventListener("input", () => {
+form.addEventListener("input", (event) => {
     syncSelectedFromForm();
-    fields.healthBadge.textContent = "Draft";
     layoutGraph();
-    scheduleWorkspaceSave();
+    // Don't auto-save while editing the name of an agent — wait for blur + popup
+    const isAgentNameEdit = event.target === fields.name && selectedEntity()?.kind === "agent";
+    if (!isAgentNameEdit) {
+        scheduleWorkspaceSave();
+    }
     scheduleRender();
 });
+closePanelButton.addEventListener("click", () => {
+    selectEntity(null);
+});
 deleteNodeButton.addEventListener("click", (event) => {
     event.preventDefault();
     event.stopPropagation();
@@ -246,9 +271,75 @@ confirmDeleteButton.addEventListener("click", () => {
     }
     closeDeleteConfirmation();
 });
-document.getElementById("testNodeButton").addEventListener("click", () => {
-    fields.healthBadge.textContent = "Tested";
-    scheduleRender();
+testNodeButton.addEventListener("click", () => {
+    const selected = selectedEntity();
+    if (selected?.kind === "agent") {
+        openAgentRunDialog();
+        return;
+    }
+    void testSelectedLlmConnection();
+});
+loadModelsButton.addEventListener("click", () => {
+    void loadModelsForSelect();
+});
+fields.name.addEventListener("blur", () => {
+    const selected = selectedEntity();
+    if (!selected || selected.kind !== "agent")
+        return;
+    const newName = fields.name.value.trim();
+    if (!newName ||
+        !savedAgentLabel ||
+        !savedAgentFolder ||
+        newName === savedAgentLabel)
+        return;
+    const newFolder = workspaceFolderForProvider(newName);
+    if (newFolder === savedAgentFolder)
+        return; // slug identique, pas de renommage nécessaire
+    renameConfirmMessage.textContent = `Renommer le dossier "${savedAgentFolder}" en "${newFolder}" ?`;
+    renameConfirmOverlay.hidden = false;
+    cancelRenameButton.focus();
+});
+cancelRenameButton.addEventListener("click", () => {
+    renameConfirmOverlay.hidden = true;
+    const selected = selectedEntity();
+    if (selected && savedAgentLabel) {
+        selected.label = savedAgentLabel;
+        fields.name.value = savedAgentLabel;
+        layoutGraph();
+        scheduleRender();
+    }
+});
+confirmRenameButton.addEventListener("click", () => {
+    renameConfirmOverlay.hidden = true;
+    const selected = selectedEntity();
+    if (!selected || !savedAgentFolder)
+        return;
+    // Remettre l'ancien chemin pour que le backend sache quoi renommer
+    selected.config.workspaceFolder = savedAgentFolder;
+    fields.workspaceFolder.value = savedAgentFolder;
+    const newName = fields.name.value.trim();
+    if (newName)
+        savedAgentLabel = newName;
+    savedAgentFolder = workspaceFolderForProvider(newName);
+    scheduleWorkspaceSave();
+});
+fields.model.addEventListener("change", () => {
+    testNodeButton.disabled = !fields.model.value;
+    const selected = selectedEntity();
+    if (selected) {
+        selected.config.model = fields.model.value;
+    }
+});
+cancelAgentRunButton.addEventListener("click", () => {
+    closeAgentRunDialog();
+});
+executeAgentRunButton.addEventListener("click", () => {
+    void executeAgentRunFromDialog();
+});
+agentRunOverlay.addEventListener("click", (event) => {
+    if (event.target === agentRunOverlay) {
+        closeAgentRunDialog();
+    }
 });
 void initializeWorkspace();
 function isolatePanelEvents() {
@@ -260,6 +351,8 @@ function isolatePanelEvents() {
 function isolateConfirmEvents() {
     for (const type of PANEL_EVENT_TYPES) {
         deleteConfirmOverlay.addEventListener(type, stopPanelEventPropagation);
+        renameConfirmOverlay.addEventListener(type, stopPanelEventPropagation);
+        agentRunOverlay.addEventListener(type, stopPanelEventPropagation);
     }
 }
 function stopPanelEventPropagation(event) {
@@ -272,7 +365,9 @@ async function initializeWorkspace() {
         state.cameraX = finiteNumber(persisted.camera?.x, state.cameraX);
         state.cameraY = finiteNumber(persisted.camera?.y, state.cameraY);
         state.zoom = clamp(finiteNumber(persisted.camera?.zoom, state.zoom), ZOOM_MIN, ZOOM_MAX);
-        state.lastSaveAt = persisted.updatedAt ? new Date(persisted.updatedAt) : null;
+        state.lastSaveAt = persisted.updatedAt
+            ? new Date(persisted.updatedAt)
+            : null;
     }
     state.isHydrated = true;
     layoutGraph();
@@ -289,13 +384,19 @@ function hydrateEntities(entities) {
     const hasRoot = hydrated.some((entity) => entity.id === "root");
     const hasMcp = hydrated.some((entity) => entity.id === "mcp");
     const withRequiredNodes = [
-        ...(hasRoot ? [] : [createEntity("root", "Living AI Documentation", "system", null)]),
+        ...(hasRoot
+            ? []
+            : [createEntity("root", "Living AI Documentation", "system", null)]),
         ...hydrated,
         ...(hasMcp ? [] : [createEntity("mcp", "MCP", "mcp", "root")]),
     ];
     const ids = new Set(withRequiredNodes.map((entity) => entity.id));
     return withRequiredNodes.map((entity) => {
-        const normalizedKind = entity.id === "root" ? "system" : entity.id === "mcp" ? "mcp" : entity.kind;
+        const normalizedKind = entity.id === "root"
+            ? "system"
+            : entity.id === "mcp"
+                ? "mcp"
+                : entity.kind;
         const normalizedParentId = entity.id === "root"
             ? null
             : entity.id === "mcp"
@@ -335,12 +436,17 @@ function hydrateEntity(input) {
         y: finiteNumber(input.y, 0),
         angle: finiteNumber(input.angle, 0),
         config: {
-            environment: stringValue(config.environment) || defaultEnvironment(kind),
             endpoint: stringValue(config.endpoint) || defaultEndpoint(id, kind),
             token: stringValue(config.token),
-            timeout: finiteNumber(config.timeout, kind === "agent" ? 45 : 30),
-            retryPolicy: stringValue(config.retryPolicy) || (kind === "llm" ? "exponential" : "linear"),
+            model: stringValue(config.model),
+            timeout: finiteNumber(config.timeout, 180),
             description: stringValue(config.description) || defaultDescription(kind),
+            workspaceFolder: stringValue(config.workspaceFolder) ||
+                (kind === "agent" ? workspaceFolderForProvider(label) : ""),
+            systemPrompt: stringValue(config.systemPrompt),
+            requiresUserInput: config.requiresUserInput === true,
+            userInputDescription: stringValue(config.userInputDescription),
+            expectedOutputMarker: stringValue(config.expectedOutputMarker),
         },
     };
 }
@@ -353,10 +459,10 @@ function scheduleWorkspaceSave() {
     }
     state.saveTimerId = window.setTimeout(() => {
         state.saveTimerId = null;
-        void saveWorkspaceNow();
+        void saveWorkspaceNow(false);
     }, SAVE_DEBOUNCE_MS);
 }
-async function saveWorkspaceNow() {
+async function saveWorkspaceNow(notify = false) {
     if (!state.isHydrated) {
         return;
     }
@@ -366,11 +472,41 @@ async function saveWorkspaceNow() {
     }
     const saved = await saveWorkspaceState(serializeWorkspace());
     if (saved) {
+        state.entities = hydrateEntities(saved.entities);
         state.lastSaveAt = new Date(saved.updatedAt);
         if (selectedEntity()) {
-            fields.healthBadge.textContent = "Applied";
+            syncPanelFromSelection();
+        }
+        if (notify) {
+            showSaveToast("Workspace saved");
         }
     }
+    else if (notify) {
+        showSaveToast("Save failed");
+    }
+}
+function showLoadingToast(message) {
+    if (toastTimerId) {
+        clearTimeout(toastTimerId);
+        toastTimerId = null;
+    }
+    workspaceToast.dataset.state = "loading";
+    workspaceToastIcon.textContent = "↻";
+    workspaceToastMessage.textContent = message;
+    workspaceToast.hidden = false;
+}
+function showSaveToast(message, state = "success") {
+    if (toastTimerId) {
+        clearTimeout(toastTimerId);
+    }
+    workspaceToast.dataset.state = state;
+    workspaceToastIcon.textContent = state === "error" ? "✕" : "✓";
+    workspaceToastMessage.textContent = message;
+    workspaceToast.hidden = false;
+    toastTimerId = window.setTimeout(() => {
+        workspaceToast.hidden = true;
+        toastTimerId = null;
+    }, SAVE_TOAST_MS);
 }
 function serializeWorkspace() {
     return {
@@ -400,7 +536,10 @@ function stringValue(input) {
     return typeof input === "string" ? input : "";
 }
 function nodeKindValue(input) {
-    return input === "system" || input === "llm" || input === "agent" || input === "mcp"
+    return input === "system" ||
+        input === "llm" ||
+        input === "agent" ||
+        input === "mcp"
         ? input
         : null;
 }
@@ -417,12 +556,16 @@ function createEntity(id, label, kind, parentId) {
         y: 0,
         angle: 0,
         config: {
-            environment: defaultEnvironment(kind),
             endpoint: defaultEndpoint(id, kind),
             token: "",
-            timeout: kind === "agent" ? 45 : 30,
-            retryPolicy: kind === "llm" ? "exponential" : "linear",
+            model: "",
+            timeout: 180,
             description: defaultDescription(kind),
+            workspaceFolder: kind === "agent" ? workspaceFolderForProvider(label) : "",
+            systemPrompt: "",
+            requiresUserInput: false,
+            userInputDescription: "",
+            expectedOutputMarker: "",
         },
     };
 }
@@ -432,21 +575,27 @@ function cloneEntities(entities) {
         config: { ...entity.config },
     }));
 }
-function defaultEnvironment(kind) {
-    if (kind === "llm" || kind === "mcp") {
-        return "production";
-    }
-    return "local";
-}
 function defaultEndpoint(id, kind) {
     if (kind === "llm") {
-        return `https://api.${id}.example/v1`;
+        return "http://localhost:11434";
     }
     if (kind === "mcp") {
         return "http://localhost:4321/mcp";
     }
     return "";
 }
+function workspaceFolderForProvider(label) {
+    return `AI/WORKSPACE/${slugify(label)}`;
+}
+function slugify(value) {
+    const slug = value
+        .normalize("NFKD")
+        .replace(/[\u0300-\u036f]/g, "")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "_")
+        .replace(/^_+|_+$/g, "");
+    return slug || "llm_provider";
+}
 function defaultDescription(kind) {
     const copy = {
         system: "Owns the documentation workspace, MCP access, providers, and agent topology.",
@@ -481,8 +630,7 @@ function addProvider() {
 }
 function addAgent(parentId) {
     const hadSelection = Boolean(state.selectedId);
-    const index = childrenOf(parentId).filter((entity) => entity.kind === "agent").length +
-        1;
+    const index = childrenOf(parentId).filter((entity) => entity.kind === "agent").length + 1;
     const id = `agent-${Date.now().toString(36)}`;
     const agent = createEntity(id, `Agent ${index}`, "agent", parentId);
     state.entities = [...state.entities, agent];
@@ -650,6 +798,13 @@ function collisionRadius(entity) {
 function selectEntity(id) {
     const hadSelection = Boolean(state.selectedId);
     state.selectedId = id;
+    const entity = id ? entityById(id) : null;
+    savedAgentLabel = entity?.kind === "agent" ? entity.label : null;
+    savedAgentFolder =
+        entity?.kind === "agent"
+            ? entity.config.workspaceFolder ||
+                workspaceFolderForProvider(entity.label)
+            : null;
     layoutGraph();
     syncCameraForPanelChange(hadSelection, Boolean(id), true);
     syncPanelFromSelection();
@@ -693,21 +848,38 @@ function syncPanelFromSelection() {
     fallbackPanelHost.hidden = !hasSelection || supportsHtmlInCanvas;
     if (!selected) {
         addButton.title = "Add LLM provider";
+        testNodeButton.textContent = "Test";
+        testNodeButton.hidden = true;
+        testNodeButton.disabled = true;
         return;
     }
     fields.name.value = selected.label;
     fields.kind.value = selected.kind;
-    fields.environment.value = selected.config.environment;
     fields.endpoint.value = selected.config.endpoint;
     fields.token.value = selected.config.token;
+    restoreModelSelect(selected.config.model);
+    fields.workspaceFolder.value = selected.config.workspaceFolder;
+    fields.workspaceField.hidden = selected.kind !== "agent";
     fields.timeout.value = String(selected.config.timeout);
-    fields.retryPolicy.value = selected.config.retryPolicy;
     fields.description.value = selected.config.description;
     fields.typeBadge.textContent = labelForBadge(selected.kind);
-    fields.healthBadge.textContent = state.lastSaveAt ? "Applied" : "Ready";
     fields.kind.disabled = true;
+    fields.llmFields.hidden =
+        selected.kind === "mcp" || selected.kind === "agent";
     fields.mcpInventory.hidden = selected.kind !== "mcp";
-    deleteNodeButton.disabled = isProtectedEntity(selected.id);
+    fields.agentSection.hidden = selected.kind !== "agent";
+    fields.systemPrompt.value = selected.config.systemPrompt;
+    fields.requiresUserInput.checked = selected.config.requiresUserInput;
+    syncUserInputDescriptionVisibility();
+    fields.userInputDescription.value = selected.config.userInputDescription;
+    fields.expectedOutputMarker.value = selected.config.expectedOutputMarker;
+    deleteNodeButton.hidden = isProtectedEntity(selected.id);
+    testNodeButton.textContent = "Test";
+    testNodeButton.hidden = selected.kind !== "llm" && selected.kind !== "agent";
+    testNodeButton.disabled =
+        selected.kind === "llm"
+            ? !selected.config.model
+            : selected.kind !== "agent";
     addButton.title =
         selected.kind === "llm" || entityById(selected.parentId)?.kind === "llm"
             ? "Add agent"
@@ -720,13 +892,198 @@ function syncSelectedFromForm() {
     }
     selected.label = fields.name.value.trim() || "Untitled node";
     selected.kind = fields.kind.value;
-    selected.config.environment = fields.environment.value;
     selected.config.endpoint = fields.endpoint.value;
     selected.config.token = fields.token.value;
+    selected.config.model = fields.model.value;
     selected.config.timeout = Number(fields.timeout.value || 30);
-    selected.config.retryPolicy = fields.retryPolicy.value;
     selected.config.description = fields.description.value;
+    selected.config.systemPrompt = fields.systemPrompt.value;
+    selected.config.requiresUserInput = fields.requiresUserInput.checked;
+    selected.config.userInputDescription = fields.userInputDescription.value;
+    selected.config.expectedOutputMarker = fields.expectedOutputMarker.value;
+    syncUserInputDescriptionVisibility();
     fields.typeBadge.textContent = labelForBadge(selected.kind);
+    // Propagate model + timeout to child agents
+    if (selected.kind === "llm") {
+        for (const entity of state.entities) {
+            if (entity.parentId === selected.id && entity.kind === "agent") {
+                entity.config.model = selected.config.model;
+                entity.config.timeout = selected.config.timeout;
+            }
+        }
+    }
+}
+function syncUserInputDescriptionVisibility() {
+    const shouldShow = selectedEntity()?.kind === "agent" && fields.requiresUserInput.checked;
+    fields.userInputDescriptionField.hidden = !shouldShow;
+    fields.userInputDescription.required = shouldShow;
+}
+function restoreModelSelect(savedModel) {
+    const existing = Array.from(fields.model.options).map((o) => o.value);
+    if (savedModel && !existing.includes(savedModel)) {
+        fields.model.innerHTML = "";
+        const opt = document.createElement("option");
+        opt.value = savedModel;
+        opt.textContent = savedModel;
+        fields.model.appendChild(opt);
+    }
+    fields.model.value = savedModel || (existing[0] ?? "");
+}
+function openAgentRunDialog() {
+    const selected = selectedEntity();
+    if (!selected || selected.kind !== "agent")
+        return;
+    syncSelectedFromForm();
+    const llm = entityById(selected.parentId ?? "");
+    if (!llm || llm.kind !== "llm") {
+        showSaveToast("No parent LLM found for this agent.", "error");
+        return;
+    }
+    if (!llm.config.model) {
+        showSaveToast("Parent LLM has no model selected.", "error");
+        return;
+    }
+    if (!selected.config.systemPrompt.trim()) {
+        showSaveToast("Write a system prompt first.", "error");
+        return;
+    }
+    if (selected.config.requiresUserInput &&
+        !selected.config.userInputDescription.trim()) {
+        showSaveToast("Describe the required user input first.", "error");
+        return;
+    }
+    agentRunTargetId = selected.id;
+    agentRunTitle.textContent = `Test ${selected.label}`;
+    agentRunHint.textContent = selected.config.requiresUserInput
+        ? selected.config.userInputDescription
+        : "Run this agent with its configured system prompt.";
+    agentRunInputField.hidden = !selected.config.requiresUserInput;
+    agentRunInput.required = selected.config.requiresUserInput;
+    agentRunInput.value = "";
+    agentRunResult.hidden = true;
+    agentRunResult.textContent = "";
+    executeAgentRunButton.disabled = false;
+    executeAgentRunButton.textContent = "Run";
+    agentRunOverlay.hidden = false;
+    if (selected.config.requiresUserInput) {
+        window.setTimeout(() => agentRunInput.focus(), 0);
+    }
+    else {
+        window.setTimeout(() => executeAgentRunButton.focus(), 0);
+    }
+}
+function closeAgentRunDialog() {
+    agentRunOverlay.hidden = true;
+    agentRunTargetId = null;
+}
+async function executeAgentRunFromDialog() {
+    if (agentRunInput.required && !agentRunInput.value.trim()) {
+        agentRunInput.reportValidity();
+        return;
+    }
+    const selected = agentRunTargetId ? entityById(agentRunTargetId) : null;
+    if (!selected || selected.kind !== "agent") {
+        showAgentRunResult("error", "The selected agent is no longer available.");
+        return;
+    }
+    const llm = entityById(selected.parentId ?? "");
+    if (!llm || llm.kind !== "llm") {
+        showAgentRunResult("error", "No parent LLM found for this agent.");
+        return;
+    }
+    executeAgentRunButton.disabled = true;
+    executeAgentRunButton.textContent = "Running…";
+    showAgentRunResult("loading", "Running agent…");
+    const mcpEntity = state.entities.find((e) => e.kind === "mcp");
+    const result = await runAgentPrompt({
+        endpoint: llm.config.endpoint,
+        token: llm.config.token,
+        model: llm.config.model,
+        systemPrompt: selected.config.systemPrompt,
+        userInput: agentRunInput.value.trim() || undefined,
+        timeout: llm.config.timeout,
+        mcpEndpoint: mcpEntity?.config.endpoint || undefined,
+        expectedOutputMarker: selected.config.expectedOutputMarker || undefined,
+    });
+    executeAgentRunButton.disabled = false;
+    executeAgentRunButton.textContent = "Run";
+    if (result.ok && result.content) {
+        showAgentRunResult("success", result.content);
+        showSaveToast("Agent responded.", "success");
+    }
+    else {
+        showAgentRunResult("error", result.error ?? "Agent failed.");
+        showSaveToast(result.error ?? "Agent failed.", "error");
+    }
+}
+function showAgentRunResult(state, message) {
+    agentRunResult.hidden = false;
+    agentRunResult.dataset.state = state;
+    agentRunResult.textContent = message;
+}
+async function loadModelsForSelect() {
+    const selected = selectedEntity();
+    if (!selected || selected.kind !== "llm")
+        return;
+    syncSelectedFromForm();
+    const endpoint = selected.config.endpoint;
+    if (!endpoint) {
+        showSaveToast("Set an endpoint first.");
+        return;
+    }
+    loadModelsButton.classList.add("loading");
+    loadModelsButton.disabled = true;
+    fields.model.disabled = true;
+    const result = await listLlmModels({
+        endpoint,
+        token: selected.config.token,
+    });
+    loadModelsButton.classList.remove("loading");
+    loadModelsButton.disabled = false;
+    fields.model.disabled = false;
+    if (!result.ok || !result.models?.length) {
+        showSaveToast(result.error ?? "No models found.");
+        return;
+    }
+    const previousValue = fields.model.value;
+    fields.model.innerHTML = "";
+    for (const id of result.models) {
+        const opt = document.createElement("option");
+        opt.value = id;
+        opt.textContent = id;
+        fields.model.appendChild(opt);
+    }
+    fields.model.value = result.models.includes(previousValue)
+        ? previousValue
+        : result.models[0];
+    selected.config.model = fields.model.value;
+    testNodeButton.disabled = !fields.model.value;
+    showSaveToast(`${result.models.length} model${result.models.length === 1 ? "" : "s"} loaded.`);
+    scheduleRender();
+}
+async function testSelectedLlmConnection() {
+    const selected = selectedEntity();
+    if (!selected || selected.kind !== "llm") {
+        return;
+    }
+    syncSelectedFromForm();
+    testNodeButton.disabled = true;
+    showLoadingToast(`Testing ${selected.config.model}…`);
+    scheduleRender();
+    const result = await testLlmConnection({
+        endpoint: selected.config.endpoint,
+        token: selected.config.token,
+        model: selected.config.model,
+        timeout: selected.config.timeout,
+    });
+    testNodeButton.disabled = false;
+    if (result.ok) {
+        showSaveToast(result.detail ?? "Connection OK", "success");
+    }
+    else {
+        showSaveToast(result.error || `Connection failed (${result.status || "no status"})`, "error");
+    }
+    scheduleRender();
 }
 function labelForBadge(kind) {
     const labels = {
@@ -901,7 +1258,7 @@ function drawConfigSurface(width, height) {
         return;
     }
     const panelWidth = panelWidthForViewport(width);
-    const panelHeight = Math.min(PANEL_HEIGHT, height - 48);
+    const panelHeight = Math.min(PANEL_HEIGHT, height - 118);
     const panelX = width - panelWidth - 24;
     const panelY = Math.max(24, (height - panelHeight) / 2);
     try {
@@ -939,9 +1296,25 @@ function resetView(animate, resetZoom) {
 }
 function syncCameraForPanelChange(hadSelection, hasSelection, animate) {
     if (hasSelection) {
-        const deltaX = selectedPanelAvoidanceDelta();
-        state.panelShiftX += Math.max(0, -deltaX);
-        translateCamera(deltaX, animate);
+        if (!hadSelection) {
+            // Panel was closed → center selected node in the left area
+            const selected = selectedEntity();
+            if (selected) {
+                const panelReserve = panelWidthForViewport(canvas.clientWidth) + PANEL_GAP;
+                const availableWidth = canvas.clientWidth - panelReserve;
+                const targetX = availableWidth / 2 - selected.x * state.zoom;
+                const appliedDelta = targetX - state.cameraX;
+                // Store negative delta so deselect reverses the shift
+                state.panelShiftX = -appliedDelta;
+                startViewAnimation(targetX, state.cameraY, state.zoom);
+            }
+        }
+        else {
+            // Panel already open → avoid occlusion only if needed
+            const deltaX = selectedPanelAvoidanceDelta();
+            state.panelShiftX += Math.max(0, -deltaX);
+            translateCamera(deltaX, animate);
+        }
         return;
     }
     if (!hadSelection) {
@@ -1121,8 +1494,7 @@ function rectangularBoundaryPoint(entity, angle) {
 function isEntityHit(entity, point) {
     if (entity.kind === "system" || entity.kind === "llm") {
         const radius = entity.kind === "system" ? ROOT_RADIUS : PROVIDER_RADIUS;
-        return (Math.hypot(point.x - entity.x, point.y - entity.y) <=
-            radius + HIT_PADDING);
+        return (Math.hypot(point.x - entity.x, point.y - entity.y) <= radius + HIT_PADDING);
     }
     const { width, height } = leafSize(entity);
     return (Math.abs(point.x - entity.x) <= width / 2 + HIT_PADDING &&