dirac-lang 0.1.97 → 0.1.98

package/dist/{agent-MJSTQERB.js → agent-5Q5MQOV2.js}

@@ -2,11 +2,11 @@ import {
   SessionServer,
   getSocketPath,
   isSessionRunning
-} from "./chunk-KFMG6CZW.js";
-import "./chunk-4TBIVB4X.js";
-import "./chunk-ECAW4X46.js";
+} from "./chunk-33DMGFRM.js";
+import "./chunk-LAEYP4OQ.js";
 import "./chunk-SLGJRZ3P.js";
 import "./chunk-HRHAMPOB.js";
+import "./chunk-ECAW4X46.js";
 import "./chunk-PPH7KYKH.js";
 
 // src/agent.ts

package/dist/{chunk-KFMG6CZW.js → chunk-33DMGFRM.js}

@@ -1,6 +1,6 @@
 import {
   integrate
-} from "./chunk-4TBIVB4X.js";
+} from "./chunk-LAEYP4OQ.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";

package/dist/{chunk-4TBIVB4X.js → chunk-LAEYP4OQ.js}

@@ -1,6 +1,3 @@
-import {
-  executeSubroutine
-} from "./chunk-ECAW4X46.js";
 import {
   executeIndexSubroutines,
   executeRegistryStats,
@@ -10,6 +7,9 @@ import {
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";
+import {
+  executeSubroutine
+} from "./chunk-ECAW4X46.js";
 import {
   CustomLLMProvider,
   OllamaProvider,
@@ -487,12 +487,12 @@ async function executeIf(session, element) {
   const condition = await evaluatePredicate(session, conditionElement);
   if (condition) {
     if (thenElement) {
-      const { integrateChildren: integrateChildren2 } = await import("./interpreter-4CIWAOBY.js");
+      const { integrateChildren: integrateChildren2 } = await import("./interpreter-D6ZF3OJA.js");
       await integrateChildren2(session, thenElement);
     }
   } else {
     if (elseElement) {
-      const { integrateChildren: integrateChildren2 } = await import("./interpreter-4CIWAOBY.js");
+      const { integrateChildren: integrateChildren2 } = await import("./interpreter-D6ZF3OJA.js");
       await integrateChildren2(session, elseElement);
     }
   }
@@ -505,7 +505,7 @@ async function evaluatePredicate(session, predicateElement) {
     return await evaluateCondition(session, predicateElement);
   }
   const outputLengthBefore = session.output.length;
-  const { integrate: integrate2 } = await import("./interpreter-4CIWAOBY.js");
+  const { integrate: integrate2 } = await import("./interpreter-D6ZF3OJA.js");
   await integrate2(session, predicateElement);
   const newOutputChunks = session.output.slice(outputLengthBefore);
   const result = newOutputChunks.join("").trim();
@@ -528,11 +528,11 @@ async function evaluateCondition(session, condElement) {
   }
   const outputLengthBefore = session.output.length;
   const args = [];
-  const { integrate: integrate2 } = await import("./interpreter-4CIWAOBY.js");
+  const { integrate: integrate2 } = await import("./interpreter-D6ZF3OJA.js");
   for (const child of condElement.children) {
     if (child.tag.toLowerCase() === "arg") {
       const argOutputStart = session.output.length;
-      const { integrateChildren: integrateChildren2 } = await import("./interpreter-4CIWAOBY.js");
+      const { integrateChildren: integrateChildren2 } = await import("./interpreter-D6ZF3OJA.js");
       await integrateChildren2(session, child);
       const newChunks = session.output.slice(argOutputStart);
       const argValue = newChunks.join("");
@@ -1075,6 +1075,7 @@ ${result}
           console.error(`[LLM] Feedback iteration ${iteration}/${maxIterations}`);
         }
         let correctionMessages = [];
+        let hasTagCorrections = false;
         let diracCode = result.trim();
         if (replaceTick && diracCode.startsWith("```")) {
           const match = diracCode.match(/^```(\w+)?\n?/m);
@@ -1086,16 +1087,20 @@ ${result}
             diracCode = diracCode.replace(/^```(?:xml|html|dirac)?\n?/m, "").replace(/\n?```$/m, "").trim();
           }
         }
-        const outputBefore = feedbackMode ? session.output.slice() : [];
+        const outputBefore = session.output.length;
         try {
+          console.error(`[LLM] Iteration ${iteration}: Parsing LLM response`);
           const parser = new DiracParser();
           let dynamicAST = parser.parse(diracCode);
+          console.error(`[LLM] Iteration ${iteration}: Parse successful`);
           if (validateTags) {
+            console.error(`[LLM] Iteration ${iteration}: Starting validation (autocorrect: ${autocorrect}, deepValidation: true)`);
             if (session.debug) {
               console.error(`[LLM] Validation enabled, autocorrect: ${autocorrect}`);
             }
-            const { validateDiracCode, applyCorrectedTags } = await import("./tag-validator-REN6XLMT.js");
+            const { validateDiracCode, applyCorrectedTags } = await import("./tag-validator-DS7OCXCG.js");
             let validation = await validateDiracCode(session, dynamicAST, { autocorrect, deepValidation: true });
+            console.error(`[LLM] Iteration ${iteration}: Validation complete - valid: ${validation.valid}, errors: ${validation.errorMessages.length}`);
             if (session.debug) {
               console.error(`[LLM] Validation result: valid=${validation.valid}, results count=${validation.results.length}`);
               if (validation.results.length > 0) {
@@ -1112,10 +1117,15 @@ ${result}
               console.error(`[LLM] Applying corrections from initial ${validation.results.length} validation results`);
               for (const result2 of validation.results) {
                 if (result2.corrected) {
+                  hasTagCorrections = true;
                   correctionMessages.push(`Auto-corrected: <${result2.originalTag}> \u2192 <${result2.tagName}> (similarity: ${result2.similarity?.toFixed(2)})`);
                 }
                 if (result2.warnings.length > 0) {
-                  correctionMessages.push(...result2.warnings);
+                  const nonScopeWarnings = result2.warnings.filter((w) => !w.startsWith("Scope:"));
+                  if (nonScopeWarnings.length > 0) {
+                    hasTagCorrections = true;
+                    correctionMessages.push(...nonScopeWarnings);
+                  }
                 }
               }
               console.error("[LLM] Initial correction messages collected:", correctionMessages.length);
@@ -1128,8 +1138,10 @@ ${result}
               console.error(`[LLM] Re-validation after corrections: valid=${validation.valid}`);
             }
             let retryCount = 0;
+            console.error(`[LLM] Iteration ${iteration}: Entering retry loop (validation.valid: ${validation.valid}, maxRetries: ${maxRetries})`);
             while (!validation.valid && retryCount < maxRetries) {
               retryCount++;
+              console.error(`[LLM] Iteration ${iteration}: Retry ${retryCount}/${maxRetries} - validation failed with errors:`, validation.errorMessages);
               if (session.debug) {
                 console.error(`[LLM] Validation failed (attempt ${retryCount}/${maxRetries}):`, validation.errorMessages);
               }
@@ -1191,10 +1203,13 @@ ${result}
               validation = await validateDiracCode(session, dynamicAST, { autocorrect, deepValidation: true });
             }
             if (!validation.valid) {
+              console.error(`[LLM] Iteration ${iteration}: VALIDATION FAILED after ${maxRetries} retries. Throwing error.`);
               throw new Error(`Tag validation failed after ${maxRetries} retries:
 ${validation.errorMessages.join("\n")}`);
             }
-            if (correctionMessages.length > 0 && feedbackMode) {
+            console.error(`[LLM] Iteration ${iteration}: Validation passed, checking for corrections (hasTagCorrections: ${hasTagCorrections}, correctionMessages: ${correctionMessages.length})`);
+            if (hasTagCorrections && correctionMessages.length > 0 && feedbackMode) {
+              console.error(`[LLM] Iteration ${iteration}: Has tag corrections, preparing feedback (confirmCorrections: ${confirmCorrections})`);
               const correctedCodeLines = [];
               for (const child of dynamicAST.children) {
                 if (child.tag && child.tag !== "DIRAC-ROOT") {
@@ -1272,11 +1287,18 @@ ${correctedCode}
               }
             }
           }
+          console.error(`[LLM] Iteration ${iteration}: About to execute code`);
           let executionError = null;
           try {
+            console.error(`[LLM] Iteration ${iteration}: Calling integrate()`);
             await integrate(session, dynamicAST);
+            console.error(`[LLM] Iteration ${iteration}: integrate() completed successfully`);
+            if (session.output.length === outputBefore) {
+              setVariable(session, "__llm_silent_execution__", result, false);
+            }
           } catch (execError) {
             executionError = execError instanceof Error ? execError.message : String(execError);
+            console.error(`[LLM] Iteration ${iteration}: EXECUTION ERROR: ${executionError}`);
             console.error(`[LLM] Execution error: ${executionError}`);
             if (feedbackMode && iteration < maxIterations) {
               const errorFeedback = `System: Your code executed but encountered a runtime error:
@@ -1289,6 +1311,38 @@ Please fix the error and try again.`;
               } else if (saveDialog) {
                 setVariable(session, "__llm_dialog__", JSON.stringify(dialogHistory), true);
               }
+              if (isOpenAI) {
+                const response = await llmClient.chat.completions.create({
+                  model,
+                  max_tokens: maxTokens,
+                  temperature,
+                  messages: dialogHistory
+                });
+                result = response.choices[0]?.message?.content || "";
+              } else if (isOllama) {
+                const ollamaPrompt = dialogHistory.map((m) => `${m.role.charAt(0).toUpperCase() + m.role.slice(1)}: ${m.content}`).join("\n");
+                result = await llmClient.complete(ollamaPrompt, {
+                  model,
+                  temperature,
+                  max_tokens: maxTokens
+                });
+              } else if (isCustom) {
+                const customPrompt = dialogHistory.map((m) => `${m.role}: ${m.content}`).join("\n");
+                result = await llmClient.complete(customPrompt, {
+                  model,
+                  temperature,
+                  max_tokens: maxTokens,
+                  messages: dialogHistory
+                });
+              } else {
+                result = await callAnthropic(llmClient, model, maxTokens, temperature, dialogHistory);
+              }
+              dialogHistory.push({ role: "assistant", content: result });
+              if (contextVar) {
+                setVariable(session, contextVar, JSON.stringify(dialogHistory), true);
+              } else if (saveDialog) {
+                setVariable(session, "__llm_dialog__", JSON.stringify(dialogHistory), true);
+              }
               continue;
             } else {
               throw execError;
@@ -1321,7 +1375,7 @@ Please fix the error and try again.`;
           }
           if (feedbackMode) {
             const outputAfter = session.output.slice();
-            const executionOutput = outputAfter.slice(outputBefore.length).join("");
+            const executionOutput = outputAfter.slice(outputBefore).join("");
             if (executionOutput) {
               process.stdout.write(executionOutput);
             }
@@ -1391,13 +1445,72 @@ ${result}
             break;
           }
         } catch (parseError) {
-          if (session.debug) {
-            console.error(`[LLM] Failed to parse as Dirac, treating as text: ${parseError}`);
+          console.error(`[LLM] Iteration ${iteration}: ERROR CAUGHT: ${parseError instanceof Error ? parseError.message : String(parseError)}`);
+          const errorMsg = parseError instanceof Error ? parseError.message : String(parseError);
+          const isValidationError = errorMsg.includes("Tag validation failed") || errorMsg.includes("Attribute") || errorMsg.includes("contains <variable> tag");
+          if (isValidationError && feedbackMode && iteration < maxIterations) {
+            console.error(`[LLM] Iteration ${iteration}: VALIDATION ERROR - sending to LLM for correction`);
+            const errorFeedback = `System: Your code had validation errors:
+${errorMsg}
+
+Please fix these errors and generate valid Dirac XML code. Remember:
+- Use \${varname} syntax in attributes instead of <variable name="..." /> tags
+- Only use allowed tags and attributes`;
+            dialogHistory.push({ role: "user", content: errorFeedback });
+            if (contextVar) {
+              setVariable(session, contextVar, JSON.stringify(dialogHistory), true);
+            } else if (saveDialog) {
+              setVariable(session, "__llm_dialog__", JSON.stringify(dialogHistory), true);
+            }
+            if (isOpenAI) {
+              const response = await llmClient.chat.completions.create({
+                model,
+                max_tokens: maxTokens,
+                temperature,
+                messages: dialogHistory
+              });
+              result = response.choices[0]?.message?.content || "";
+            } else if (isOllama) {
+              const ollamaPrompt = dialogHistory.map((m) => `${m.role.charAt(0).toUpperCase() + m.role.slice(1)}: ${m.content}`).join("\n");
+              result = await llmClient.complete(ollamaPrompt, {
+                model,
+                temperature,
+                max_tokens: maxTokens
+              });
+            } else if (isCustom) {
+              const customPrompt = dialogHistory.map((m) => `${m.role}: ${m.content}`).join("\n");
+              result = await llmClient.complete(customPrompt, {
+                model,
+                temperature,
+                max_tokens: maxTokens,
+                messages: dialogHistory
+              });
+            } else {
+              result = await callAnthropic(llmClient, model, maxTokens, temperature, dialogHistory);
+            }
+            dialogHistory.push({ role: "assistant", content: result });
+            if (contextVar) {
+              setVariable(session, contextVar, JSON.stringify(dialogHistory), true);
+            } else if (saveDialog) {
+              setVariable(session, "__llm_dialog__", JSON.stringify(dialogHistory), true);
+            }
+            if (session.debug) {
+              console.error(`[LLM] LLM correction response:
+${result}
+`);
+            }
+            continue;
+          } else {
+            console.error(`[LLM] Iteration ${iteration}: PARSE ERROR (or no feedback): ${errorMsg}`);
+            if (session.debug) {
+              console.error(`[LLM] Failed to parse as Dirac, treating as text: ${parseError}`);
+            }
+            emit(session, result);
+            break;
           }
-          emit(session, result);
-          break;
         }
       }
+      console.error(`[LLM] Exited feedback loop after ${iteration} iterations`);
     } else {
       emit(session, result);
     }
@@ -1948,7 +2061,7 @@ async function executeTagCheck(session, element) {
       const executeTag = correctedTag || tagName;
       console.error(`[tag-check] Executing <${executeTag}/> as all checks passed and execute=true.`);
       const elementToExecute = correctedTag ? { ...child, tag: correctedTag } : child;
-      const { integrate: integrate2 } = await import("./interpreter-4CIWAOBY.js");
+      const { integrate: integrate2 } = await import("./interpreter-D6ZF3OJA.js");
       await integrate2(session, elementToExecute);
     }
   }
@@ -1957,7 +2070,7 @@ async function executeTagCheck(session, element) {
 // src/tags/throw.ts
 async function executeThrow(session, element) {
   const exceptionName = element.attributes?.name || "exception";
-  const { integrateChildren: integrateChildren2 } = await import("./interpreter-4CIWAOBY.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-D6ZF3OJA.js");
   const exceptionDom = {
     tag: "exception-content",
     attributes: { name: exceptionName },
@@ -1970,7 +2083,7 @@ async function executeThrow(session, element) {
 // src/tags/try.ts
 async function executeTry(session, element) {
   setExceptionBoundary(session);
-  const { integrateChildren: integrateChildren2 } = await import("./interpreter-4CIWAOBY.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-D6ZF3OJA.js");
   await integrateChildren2(session, element);
   unsetExceptionBoundary(session);
 }
@@ -1980,7 +2093,7 @@ async function executeCatch(session, element) {
   const exceptionName = element.attributes?.name || "exception";
   const caughtCount = lookupException(session, exceptionName);
   if (caughtCount > 0) {
-    const { integrateChildren: integrateChildren2 } = await import("./interpreter-4CIWAOBY.js");
+    const { integrateChildren: integrateChildren2 } = await import("./interpreter-D6ZF3OJA.js");
     await integrateChildren2(session, element);
   }
   flushCurrentException(session);
@@ -1989,7 +2102,7 @@ async function executeCatch(session, element) {
 // src/tags/exception.ts
 async function executeException(session, element) {
   const exceptions = getCurrentExceptions(session);
-  const { integrateChildren: integrateChildren2 } = await import("./interpreter-4CIWAOBY.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-D6ZF3OJA.js");
   for (const exceptionDom of exceptions) {
     await integrateChildren2(session, exceptionDom);
   }
@@ -2190,7 +2303,7 @@ async function executeLoadContext(session, element) {
     query = element.text.trim();
   }
   if (!query && element.children.length > 0) {
-    const { integrate: integrate2 } = await import("./interpreter-4CIWAOBY.js");
+    const { integrate: integrate2 } = await import("./interpreter-D6ZF3OJA.js");
     const beforeOutput = session.output.length;
     for (const child of element.children) {
       await integrate2(session, child);
@@ -3034,7 +3147,7 @@ async function executeForeach(session, element) {
     const parser2 = new DiracParser2();
     try {
       const fromElement = parser2.parse(fromAttr);
-      const { integrate: integrate2 } = await import("./interpreter-4CIWAOBY.js");
+      const { integrate: integrate2 } = await import("./interpreter-D6ZF3OJA.js");
       await integrate2(session, fromElement);
     } catch (e) {
       session.output = savedOutput;

package/dist/{chunk-CDTZNFCJ.js → chunk-MYWEN36N.js}

@@ -1,6 +1,6 @@
 import {
   integrate
-} from "./chunk-4TBIVB4X.js";
+} from "./chunk-LAEYP4OQ.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";

package/dist/cli.js

@@ -1,13 +1,13 @@
 #!/usr/bin/env node
 import {
   execute
-} from "./chunk-CDTZNFCJ.js";
+} from "./chunk-MYWEN36N.js";
 import {
   BraKetParser
-} from "./chunk-4TBIVB4X.js";
-import "./chunk-ECAW4X46.js";
+} from "./chunk-LAEYP4OQ.js";
 import "./chunk-SLGJRZ3P.js";
 import "./chunk-HRHAMPOB.js";
+import "./chunk-ECAW4X46.js";
 import "./chunk-PPH7KYKH.js";
 
 // src/cli.ts
@@ -16,7 +16,7 @@ import "dotenv/config";
 // package.json
 var package_default = {
   name: "dirac-lang",
-  version: "0.1.96",
+  version: "0.1.98",
   description: "LLM-Augmented Declarative Execution",
   type: "module",
   main: "dist/index.js",
@@ -150,7 +150,7 @@ async function main() {
   const args = process.argv.slice(2);
   const calledAs = process.argv[1];
   if (calledAs && calledAs.endsWith("/dish")) {
-    const { DiracShell } = await import("./shell-CY5XIPQC.js");
+    const { DiracShell } = await import("./shell-KNEQHL3Y.js");
     const shellConfig = loadShellConfig(args);
     const shell = new DiracShell(shellConfig);
     await shell.start();
@@ -199,11 +199,11 @@ async function main() {
   if (args[0] === "agent") {
     const subcommand = args[1];
     if (subcommand === "daemon") {
-      const { runAgentDaemon } = await import("./agent-MJSTQERB.js");
+      const { runAgentDaemon } = await import("./agent-5Q5MQOV2.js");
       await runAgentDaemon();
       return;
     }
-    const { AgentCLI } = await import("./agent-MJSTQERB.js");
+    const { AgentCLI } = await import("./agent-5Q5MQOV2.js");
     const agent = new AgentCLI();
     switch (subcommand) {
       case "start":
@@ -230,8 +230,8 @@ async function main() {
     return;
   }
   if (args[0] === "shell") {
-    const { DiracShell } = await import("./shell-CY5XIPQC.js");
-    const { SessionServer, isSessionRunning, getSocketPath } = await import("./session-server-TQPJVLA4.js");
+    const { DiracShell } = await import("./shell-KNEQHL3Y.js");
+    const { SessionServer, isSessionRunning, getSocketPath } = await import("./session-server-N53QIJO5.js");
     const { SessionClient } = await import("./session-client-3VTC5MLO.js");
     const daemonMode = args.includes("--daemon") || args.includes("-d");
     const agentMode = args.includes("--agent") || args.includes("-a");
@@ -277,7 +277,7 @@ async function main() {
     return;
   }
   if (args[0] === "daemon") {
-    const { SessionServer } = await import("./session-server-TQPJVLA4.js");
+    const { SessionServer } = await import("./session-server-N53QIJO5.js");
     const server = new SessionServer();
     await server.start();
     console.log("Session daemon started");

package/dist/{cron-2J3SEPZW.js → cron-VCUFU2WU.js}

@@ -3,10 +3,10 @@ import {
   listCronJobs,
   stopAllCronJobs,
   stopCronJob
-} from "./chunk-4TBIVB4X.js";
-import "./chunk-ECAW4X46.js";
+} from "./chunk-LAEYP4OQ.js";
 import "./chunk-SLGJRZ3P.js";
 import "./chunk-HRHAMPOB.js";
+import "./chunk-ECAW4X46.js";
 import "./chunk-PPH7KYKH.js";
 export {
   executeCron,

package/dist/index.js

@@ -2,15 +2,15 @@ import {
   createLLMAdapter,
   execute,
   executeUserCommand
-} from "./chunk-CDTZNFCJ.js";
+} from "./chunk-MYWEN36N.js";
 import {
   integrate
-} from "./chunk-4TBIVB4X.js";
-import "./chunk-ECAW4X46.js";
+} from "./chunk-LAEYP4OQ.js";
 import "./chunk-SLGJRZ3P.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";
+import "./chunk-ECAW4X46.js";
 import {
   createSession,
   getAvailableSubroutines,

package/dist/{interpreter-4CIWAOBY.js → interpreter-D6ZF3OJA.js}

@@ -1,10 +1,10 @@
 import {
   integrate,
   integrateChildren
-} from "./chunk-4TBIVB4X.js";
-import "./chunk-ECAW4X46.js";
+} from "./chunk-LAEYP4OQ.js";
 import "./chunk-SLGJRZ3P.js";
 import "./chunk-HRHAMPOB.js";
+import "./chunk-ECAW4X46.js";
 import "./chunk-PPH7KYKH.js";
 export {
   integrate,

package/dist/{run-at-MHURF5PL.js → run-at-P43PK5JU.js}

@@ -3,10 +3,10 @@ import {
   cancelScheduledRun,
   executeRunAt,
   listScheduledRuns
-} from "./chunk-4TBIVB4X.js";
-import "./chunk-ECAW4X46.js";
+} from "./chunk-LAEYP4OQ.js";
 import "./chunk-SLGJRZ3P.js";
 import "./chunk-HRHAMPOB.js";
+import "./chunk-ECAW4X46.js";
 import "./chunk-PPH7KYKH.js";
 export {
   cancelAllScheduledRuns,

package/dist/{schedule-KMBLI46W.js → schedule-3EJJHG3B.js}

@@ -3,10 +3,10 @@ import {
   listScheduledTasks,
   stopAllScheduledTasks,
   stopScheduledTask
-} from "./chunk-4TBIVB4X.js";
-import "./chunk-ECAW4X46.js";
+} from "./chunk-LAEYP4OQ.js";
 import "./chunk-SLGJRZ3P.js";
 import "./chunk-HRHAMPOB.js";
+import "./chunk-ECAW4X46.js";
 import "./chunk-PPH7KYKH.js";
 export {
   executeSchedule,

package/dist/scope-validator-TVQIOEAI.js

@@ -0,0 +1,171 @@
+// src/utils/scope-validator.ts
+function extractParameterNames(element) {
+  const params = [];
+  for (const attr in element.attributes) {
+    if (attr.startsWith("param-")) {
+      const paramName = attr.slice(6);
+      params.push(paramName);
+    }
+  }
+  return params;
+}
+function extractVariableReferences(text) {
+  const pattern = /\$\{([a-zA-Z_][a-zA-Z0-9_-]*)\}/g;
+  const matches = [];
+  let match;
+  while ((match = pattern.exec(text)) !== null) {
+    matches.push(match[1]);
+  }
+  return matches;
+}
+var ScopeContext = class {
+  parameters;
+  // Declared parameters
+  declaredVariables;
+  // Variables declared with <defvar>
+  referencedVariables;
+  // Variables referenced with <variable> or ${}
+  referencedParameters;
+  // Parameters actually used
+  constructor(parameters) {
+    this.parameters = new Set(parameters);
+    this.declaredVariables = /* @__PURE__ */ new Set();
+    this.referencedVariables = /* @__PURE__ */ new Set();
+    this.referencedParameters = /* @__PURE__ */ new Set();
+  }
+  /**
+   * Check if a name is available in current scope
+   * Priority: parameters -> declared variables
+   */
+  isInScope(name) {
+    return this.parameters.has(name) || this.declaredVariables.has(name);
+  }
+  /**
+   * Record a variable declaration
+   */
+  declareVariable(name) {
+    this.declaredVariables.add(name);
+  }
+  /**
+   * Record a variable/parameter reference
+   */
+  referenceVariable(name) {
+    this.referencedVariables.add(name);
+    if (this.parameters.has(name)) {
+      this.referencedParameters.add(name);
+    }
+  }
+};
+function validateScope(element, scope, errors, warnings) {
+  if (element.tag === "defvar") {
+    const varName = element.attributes.name;
+    if (varName) {
+      scope.declareVariable(varName);
+    }
+  }
+  if (element.tag === "variable") {
+    const varName = element.attributes.name;
+    if (varName) {
+      scope.referenceVariable(varName);
+      if (!scope.isInScope(varName)) {
+        warnings.push(
+          `Variable reference '${varName}' not found in local scope (may be from parent scope)`
+        );
+      }
+    }
+  }
+  if (element.tag === "parameters") {
+    const select = element.attributes.select;
+    if (select && select.startsWith("@")) {
+      const paramName = select.slice(1);
+      scope.referenceVariable(paramName);
+      if (!scope.isInScope(paramName)) {
+        warnings.push(
+          `Parameter reference '${paramName}' not found in subroutine parameters`
+        );
+      }
+    }
+  }
+  for (const [attrName, attrValue] of Object.entries(element.attributes)) {
+    if (typeof attrValue === "string") {
+      const varRefs = extractVariableReferences(attrValue);
+      for (const varRef of varRefs) {
+        scope.referenceVariable(varRef);
+        if (!scope.isInScope(varRef)) {
+          warnings.push(
+            `Variable substitution '\${${varRef}}' in attribute not found in local scope (may be from parent scope)`
+          );
+        }
+      }
+      const dollarVarPattern = /\$([a-zA-Z_][a-zA-Z0-9_-]*)/g;
+      let dollarMatch;
+      while ((dollarMatch = dollarVarPattern.exec(attrValue)) !== null) {
+        const varName = dollarMatch[1];
+        scope.referenceVariable(varName);
+      }
+    }
+  }
+  for (const child of element.children) {
+    validateScope(child, scope, errors, warnings);
+  }
+}
+function validateSubroutineScope(subroutine) {
+  const errors = [];
+  const warnings = [];
+  const parameters = extractParameterNames(subroutine);
+  const scope = new ScopeContext(parameters);
+  for (const child of subroutine.children) {
+    validateScope(child, scope, errors, warnings);
+  }
+  const unusedParameters = parameters.filter((p) => !scope.referencedParameters.has(p));
+  if (unusedParameters.length > 0) {
+    warnings.push(
+      `Unused parameters: ${unusedParameters.join(", ")}`
+    );
+  }
+  const unusedVariables = Array.from(scope.declaredVariables).filter(
+    (v) => !scope.referencedVariables.has(v)
+  );
+  if (unusedVariables.length > 0) {
+    warnings.push(
+      `Unused variables: ${unusedVariables.join(", ")}`
+    );
+  }
+  const undefinedReferences = Array.from(scope.referencedVariables).filter(
+    (v) => !scope.isInScope(v)
+  );
+  const undefinedParameters = undefinedReferences.filter(
+    (v) => !scope.declaredVariables.has(v)
+  );
+  const undefinedVariables = undefinedReferences.filter(
+    (v) => scope.declaredVariables.has(v)
+  );
+  return {
+    valid: errors.length === 0,
+    errors,
+    warnings,
+    undefinedParameters,
+    undefinedVariables,
+    unusedParameters,
+    unusedVariables
+  };
+}
+function validateAllSubroutineScopes(ast) {
+  const results = /* @__PURE__ */ new Map();
+  function findSubroutines(element) {
+    if (element.tag === "subroutine") {
+      const name = element.attributes.name || "anonymous";
+      const result = validateSubroutineScope(element);
+      results.set(name, result);
+    }
+    for (const child of element.children) {
+      findSubroutines(child);
+    }
+  }
+  findSubroutines(ast);
+  return results;
+}
+export {
+  validateAllSubroutineScopes,
+  validateSubroutineScope
+};

package/dist/{session-server-TQPJVLA4.js → session-server-N53QIJO5.js}

@@ -2,11 +2,11 @@ import {
   SessionServer,
   getSocketPath,
   isSessionRunning
-} from "./chunk-KFMG6CZW.js";
-import "./chunk-4TBIVB4X.js";
-import "./chunk-ECAW4X46.js";
+} from "./chunk-33DMGFRM.js";
+import "./chunk-LAEYP4OQ.js";
 import "./chunk-SLGJRZ3P.js";
 import "./chunk-HRHAMPOB.js";
+import "./chunk-ECAW4X46.js";
 import "./chunk-PPH7KYKH.js";
 export {
   SessionServer,

package/dist/{shell-CY5XIPQC.js → shell-KNEQHL3Y.js}

@@ -2,12 +2,12 @@
 import {
   BraKetParser,
   integrate
-} from "./chunk-4TBIVB4X.js";
-import "./chunk-ECAW4X46.js";
+} from "./chunk-LAEYP4OQ.js";
 import "./chunk-SLGJRZ3P.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";
+import "./chunk-ECAW4X46.js";
 import {
   createSession
 } from "./chunk-PPH7KYKH.js";
@@ -358,7 +358,7 @@ var DiracShell = class {
     if (this.client) {
       this.client.disconnect();
     }
-    import("./schedule-KMBLI46W.js").then(({ stopAllScheduledTasks }) => {
+    import("./schedule-3EJJHG3B.js").then(({ stopAllScheduledTasks }) => {
       stopAllScheduledTasks();
       console.log("\nGoodbye!");
       process.exit(0);
@@ -504,6 +504,15 @@ var DiracShell = class {
       if (this.session.output.length > 0) {
         console.log(this.session.output.join(""));
       }
+      const silentExecution = this.session.variables.find((v) => v.name === "__llm_silent_execution__");
+      if (silentExecution?.value) {
+        console.error(`
+[LLM generated]
+${silentExecution.value}
+`);
+        const idx = this.session.variables.findIndex((v) => v.name === "__llm_silent_execution__");
+        if (idx !== -1) this.session.variables.splice(idx, 1);
+      }
     } catch (error) {
       console.error("Error:", error instanceof Error ? error.message : String(error));
       if (this.config.debug && error instanceof Error && error.stack) {
@@ -763,7 +772,7 @@ Examples:
         break;
       case "tasks":
         try {
-          const { listScheduledTasks } = await import("./schedule-KMBLI46W.js");
+          const { listScheduledTasks } = await import("./schedule-3EJJHG3B.js");
           const tasks = listScheduledTasks();
           if (tasks.length === 0) {
             console.log("No scheduled tasks running.");
@@ -782,7 +791,7 @@ Examples:
           console.log("Usage: :stop <task-name>");
         } else {
           try {
-            const { stopScheduledTask } = await import("./schedule-KMBLI46W.js");
+            const { stopScheduledTask } = await import("./schedule-3EJJHG3B.js");
             const taskName = args[0];
             const stopped = stopScheduledTask(taskName);
             if (stopped) {
@@ -797,7 +806,7 @@ Examples:
         break;
       case "stopall":
         try {
-          const { stopAllScheduledTasks } = await import("./schedule-KMBLI46W.js");
+          const { stopAllScheduledTasks } = await import("./schedule-3EJJHG3B.js");
           stopAllScheduledTasks();
           console.log("All scheduled tasks stopped.");
         } catch (error) {
@@ -806,7 +815,7 @@ Examples:
         break;
       case "crons":
         try {
-          const { listCronJobs } = await import("./cron-2J3SEPZW.js");
+          const { listCronJobs } = await import("./cron-VCUFU2WU.js");
           const jobs = listCronJobs();
           if (jobs.length === 0) {
             console.log("No cron jobs running.");
@@ -826,7 +835,7 @@ Examples:
           console.log("Usage: :stopcron <job-name>");
         } else {
           try {
-            const { stopCronJob } = await import("./cron-2J3SEPZW.js");
+            const { stopCronJob } = await import("./cron-VCUFU2WU.js");
             const jobName = args[0];
             const stopped = stopCronJob(jobName);
             if (stopped) {
@@ -841,7 +850,7 @@ Examples:
         break;
       case "stopallcrons":
         try {
-          const { stopAllCronJobs } = await import("./cron-2J3SEPZW.js");
+          const { stopAllCronJobs } = await import("./cron-VCUFU2WU.js");
           stopAllCronJobs();
           console.log("All cron jobs stopped.");
         } catch (error) {
@@ -850,7 +859,7 @@ Examples:
         break;
       case "scheduled":
         try {
-          const { listScheduledRuns } = await import("./run-at-MHURF5PL.js");
+          const { listScheduledRuns } = await import("./run-at-P43PK5JU.js");
           const runs = listScheduledRuns();
           if (runs.length === 0) {
             console.log("No scheduled runs pending.");
@@ -870,7 +879,7 @@ Examples:
           console.log("Usage: :cancel <run-name>");
         } else {
           try {
-            const { cancelScheduledRun } = await import("./run-at-MHURF5PL.js");
+            const { cancelScheduledRun } = await import("./run-at-P43PK5JU.js");
             const runName = args[0];
             const cancelled = cancelScheduledRun(runName);
             if (cancelled) {
@@ -885,7 +894,7 @@ Examples:
         break;
       case "cancelall":
         try {
-          const { cancelAllScheduledRuns } = await import("./run-at-MHURF5PL.js");
+          const { cancelAllScheduledRuns } = await import("./run-at-P43PK5JU.js");
           cancelAllScheduledRuns();
           console.log("All scheduled runs cancelled.");
         } catch (error) {

package/dist/{tag-validator-REN6XLMT.js → tag-validator-DS7OCXCG.js}

@@ -77,6 +77,21 @@ function validateParameterType(paramName, value, expectedType) {
   }
   return { valid: true };
 }
+function validateAttributeValue(attrName, value) {
+  if (value.includes("<variable")) {
+    return {
+      valid: false,
+      error: `Attribute '${attrName}' contains <variable> tag - use \${varname} syntax in attributes instead`
+    };
+  }
+  if (/<[a-zA-Z]/.test(value) && !value.includes("${")) {
+    return {
+      valid: false,
+      warning: `Attribute '${attrName}' appears to contain XML tags - attribute values should use \${} syntax for variables`
+    };
+  }
+  return { valid: true };
+}
 async function validateNestedTags(session, element, options = {}) {
   const results = [];
   for (const child of element.children) {
@@ -107,7 +122,8 @@ async function validateTag(session, element, options = {}) {
     warnings: [],
     attributeCorrections: {},
     typeErrors: [],
-    nestedValidation: []
+    nestedValidation: [],
+    scopeValidation: void 0
   };
   if (allowed.has(tagName)) {
     console.error(`[VALIDATE] Tag <${tagName}> is valid`);
@@ -160,8 +176,16 @@ async function validateTag(session, element, options = {}) {
       }
       for (const attr in element.attributes) {
         const param = sub.parameters.find((p) => p.name === attr);
+        const attrValue = element.attributes[attr];
+        const attrValueCheck = validateAttributeValue(attr, attrValue);
+        if (!attrValueCheck.valid && attrValueCheck.error) {
+          result.errors.push(attrValueCheck.error);
+        }
+        if (attrValueCheck.warning) {
+          result.warnings.push(attrValueCheck.warning);
+        }
         if (param && param.type) {
-          const typeCheck = validateParameterType(attr, element.attributes[attr], param.type);
+          const typeCheck = validateParameterType(attr, attrValue, param.type);
           if (!typeCheck.valid && typeCheck.error) {
             result.typeErrors.push(typeCheck.error);
             result.errors.push(typeCheck.error);
@@ -176,6 +200,22 @@ async function validateTag(session, element, options = {}) {
             result.warnings.push(`Nested tag <${nestedResult.originalTag}>: ${nestedResult.errors.join(", ")}`);
           }
         }
+        const { validateSubroutineScope } = await import("./scope-validator-TVQIOEAI.js");
+        result.scopeValidation = validateSubroutineScope(element);
+        console.error(`[VALIDATE] Scope validation for <subroutine name="${element.attributes.name}">:`, {
+          errors: result.scopeValidation.errors.length,
+          warnings: result.scopeValidation.warnings.length,
+          undefinedParams: result.scopeValidation.undefinedParameters,
+          undefinedVars: result.scopeValidation.undefinedVariables,
+          unusedParams: result.scopeValidation.unusedParameters,
+          unusedVars: result.scopeValidation.unusedVariables
+        });
+        if (result.scopeValidation.warnings.length > 0) {
+          result.warnings.push(...result.scopeValidation.warnings.map((w) => `Scope: ${w}`));
+        }
+        if (result.scopeValidation.errors.length > 0) {
+          result.errors.push(...result.scopeValidation.errors.map((e) => `Scope: ${e}`));
+        }
       }
     }
     result.valid = result.errors.length === 0;
@@ -230,6 +270,49 @@ async function validateDiracCode(session, ast, options = {}) {
   const results = [];
   const errorMessages = [];
   const typeErrors = [];
+  const localSubroutineNames = /* @__PURE__ */ new Set();
+  const localSubroutineElements = /* @__PURE__ */ new Map();
+  function extractLocalSubroutines(element) {
+    if (element.tag === "subroutine" && element.attributes.name) {
+      localSubroutineNames.add(element.attributes.name);
+      localSubroutineElements.set(element.attributes.name, element);
+    }
+    for (const child of element.children) {
+      extractLocalSubroutines(child);
+    }
+  }
+  extractLocalSubroutines(ast);
+  if (localSubroutineNames.size > 0) {
+    console.error(`[VALIDATE] Found ${localSubroutineNames.size} local subroutine definitions:`, Array.from(localSubroutineNames));
+  }
+  const tempSubroutines = [];
+  for (const subName of localSubroutineNames) {
+    const subElement = localSubroutineElements.get(subName);
+    const parameters = [];
+    for (const attr in subElement.attributes) {
+      if (attr.startsWith("param-")) {
+        const paramName = attr.slice(6);
+        const paramSpec = subElement.attributes[attr];
+        const parts = paramSpec.split(":");
+        parameters.push({
+          name: paramName,
+          type: parts[0] || "string",
+          required: parts[1] === "required",
+          description: parts[2] || "",
+          example: parts[3] || ""
+        });
+      }
+    }
+    console.error(`[VALIDATE] Temp subroutine '${subName}' has ${parameters.length} parameters:`, parameters.map((p) => p.name));
+    const tempSub = {
+      name: subName,
+      element: subElement,
+      boundary: session.variables.length,
+      parameters
+    };
+    session.subroutines.push(tempSub);
+    tempSubroutines.push(tempSub);
+  }
   async function validateElement(element) {
     if (element.tag && element.tag !== "dirac" && element.tag !== "DIRAC-ROOT" && element.tag.trim() !== "") {
       const result = await validateTag(session, element, options);
@@ -246,6 +329,12 @@ async function validateDiracCode(session, ast, options = {}) {
     }
   }
   await validateElement(ast);
+  for (const tempSub of tempSubroutines) {
+    const index = session.subroutines.indexOf(tempSub);
+    if (index > -1) {
+      session.subroutines.splice(index, 1);
+    }
+  }
   return {
     valid: errorMessages.length === 0,
     results,
@@ -256,26 +345,28 @@ async function validateDiracCode(session, ast, options = {}) {
 function applyCorrectedTags(ast, results) {
   let resultIndex = 0;
   function correctElement(element) {
-    if (element.tag && element.tag !== "dirac" && element.tag !== "DIRAC-ROOT" && element.tag.trim() !== "") {
+    const shouldProcess = element.tag && element.tag !== "dirac" && element.tag !== "DIRAC-ROOT" && element.tag.trim() !== "";
+    if (shouldProcess && resultIndex < results.length) {
       const result = results[resultIndex++];
-      if (result) {
-        if (result.corrected && result.tagName !== element.tag) {
-          console.error(`[APPLY-CORRECTION] Tag: ${element.tag} \u2192 ${result.tagName}`);
-          element = { ...element, tag: result.tagName };
-        }
-        if (result.attributeCorrections && Object.keys(result.attributeCorrections).length > 0) {
-          console.error(`[APPLY-CORRECTION] Attributes on <${element.tag}>:`, result.attributeCorrections);
-          const newAttributes = {};
-          for (const [oldAttr, value] of Object.entries(element.attributes)) {
-            const newAttr = result.attributeCorrections[oldAttr] || oldAttr;
-            if (newAttr !== oldAttr) {
-              console.error(`[APPLY-CORRECTION]   ${oldAttr}="${value}" \u2192 ${newAttr}="${value}"`);
-            }
-            newAttributes[newAttr] = value;
+      console.error(`[APPLY-CORRECTION] Processing <${element.tag}> with result #${resultIndex - 1} for <${result.originalTag}>, corrected: ${result.corrected}`);
+      if (result.corrected && result.tagName !== element.tag) {
+        console.error(`[APPLY-CORRECTION] Tag: ${element.tag} \u2192 ${result.tagName}`);
+        element = { ...element, tag: result.tagName };
+      }
+      if (result.attributeCorrections && Object.keys(result.attributeCorrections).length > 0) {
+        console.error(`[APPLY-CORRECTION] Attributes on <${element.tag}>:`, result.attributeCorrections);
+        const newAttributes = {};
+        for (const [oldAttr, value] of Object.entries(element.attributes)) {
+          const newAttr = result.attributeCorrections[oldAttr] || oldAttr;
+          if (newAttr !== oldAttr) {
+            console.error(`[APPLY-CORRECTION]   ${oldAttr}="${value}" \u2192 ${newAttr}="${value}"`);
           }
-          element = { ...element, attributes: newAttributes };
+          newAttributes[newAttr] = value;
         }
+        element = { ...element, attributes: newAttributes };
       }
+    } else if (shouldProcess) {
+      console.error(`[APPLY-CORRECTION] WARNING: No result for <${element.tag}> at index ${resultIndex} (total results: ${results.length})`);
     }
     return {
       ...element,

package/dist/test-runner.js

@@ -1,11 +1,11 @@
 import {
   integrate
-} from "./chunk-4TBIVB4X.js";
-import "./chunk-ECAW4X46.js";
+} from "./chunk-LAEYP4OQ.js";
 import "./chunk-SLGJRZ3P.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";
+import "./chunk-ECAW4X46.js";
 import {
   createSession,
   getOutput

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dirac-lang",
-  "version": "0.1.97",
+  "version": "0.1.98",
   "description": "LLM-Augmented Declarative Execution",
   "type": "module",
   "main": "dist/index.js",