dirac-lang 0.1.98 → 0.1.100

package/README.md

@@ -252,6 +252,21 @@ Dirac is more than a language—it's a **paradigm shift** in how we think about
 npm install -g dirac-lang
 ```
 
+## Documentation
+
+For detailed guides on using Dirac:
+
+- **[Getting Started](GETTING-STARTED.md)** - Installation and first programs
+- **[Quick Start Library Guide](QUICKSTART-LIBRARY.md)** - Building reusable libraries
+- **[LLM Integration](LLM-DIALOG-CONTEXT.md)** - Working with LLMs in Dirac
+- **[Subroutine Management](SUBROUTINE-MANAGEMENT.md)** - Stack operations and subroutine control
+- **[Training Data Export](TRAINING-DATA-EXPORT.md)** - Creating fine-tuning datasets
+- **[Debugging](DEBUGGING.md)** - Debug mode and troubleshooting
+- **[Exception Handling](EXCEPTION-HANDLING.md)** - Error handling and recovery
+- **[Namespaces](NAMESPACES.md)** - Organizing code with namespaces
+- **[Libraries](LIBRARIES.md)** - Using and creating libraries
+- **[Conditional Tags](CONDITIONAL-TAGS.md)** - Control flow patterns
+
 ---
 
 *"In the quantum realm, a bra meets a ket to produce reality. In Dirac, a declaration meets an LLM to produce execution."*

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

@@ -2,12 +2,12 @@ import {
   SessionServer,
   getSocketPath,
   isSessionRunning
-} from "./chunk-33DMGFRM.js";
-import "./chunk-LAEYP4OQ.js";
-import "./chunk-SLGJRZ3P.js";
+} from "./chunk-TIQ36H2U.js";
+import "./chunk-OUCAV57A.js";
+import "./chunk-53QJQ2CC.js";
 import "./chunk-HRHAMPOB.js";
-import "./chunk-ECAW4X46.js";
-import "./chunk-PPH7KYKH.js";
+import "./chunk-EAM7IZWA.js";
+import "./chunk-ZYSWVMID.js";
 
 // src/agent.ts
 import fs from "fs";

package/dist/{chunk-SLGJRZ3P.js → chunk-53QJQ2CC.js}

@@ -4,7 +4,7 @@ import {
 import {
   emit,
   setVariable
-} from "./chunk-PPH7KYKH.js";
+} from "./chunk-ZYSWVMID.js";
 
 // src/runtime/subroutine-registry.ts
 import * as fs from "fs";

package/dist/{chunk-MYWEN36N.js → chunk-7MSWEFH5.js}

@@ -1,6 +1,6 @@
 import {
   integrate
-} from "./chunk-LAEYP4OQ.js";
+} from "./chunk-OUCAV57A.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";
@@ -8,7 +8,7 @@ import {
   createSession,
   getAvailableSubroutines,
   getOutput
-} from "./chunk-PPH7KYKH.js";
+} from "./chunk-ZYSWVMID.js";
 
 // src/utils/llm-adapter.ts
 function createLLMAdapter(session) {

package/dist/{chunk-ECAW4X46.js → chunk-EAM7IZWA.js}

@@ -1,6 +1,6 @@
 import {
   registerSubroutine
-} from "./chunk-PPH7KYKH.js";
+} from "./chunk-ZYSWVMID.js";
 
 // src/tags/subroutine.ts
 function executeSubroutine(session, element) {

package/dist/{chunk-LAEYP4OQ.js → chunk-OUCAV57A.js}

@@ -3,13 +3,13 @@ import {
   executeRegistryStats,
   executeSearchSubroutines,
   registry
-} from "./chunk-SLGJRZ3P.js";
+} from "./chunk-53QJQ2CC.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";
 import {
   executeSubroutine
-} from "./chunk-ECAW4X46.js";
+} from "./chunk-EAM7IZWA.js";
 import {
   CustomLLMProvider,
   OllamaProvider,
@@ -34,7 +34,7 @@ import {
   substituteVariables,
   throwException,
   unsetExceptionBoundary
-} from "./chunk-PPH7KYKH.js";
+} from "./chunk-ZYSWVMID.js";
 
 // src/tags/parameters.ts
 async function executeParameters(session, element) {
@@ -297,7 +297,7 @@ async function executeCall(session, element) {
   }
 }
 async function registerExtendChain(session, subroutine, currentName) {
-  const { executeSubroutine: executeSubroutine2 } = await import("./subroutine-7JJKHTV4.js");
+  const { executeSubroutine: executeSubroutine2 } = await import("./subroutine-O3YGYHRZ.js");
   const extendsAttr = subroutine.attributes.extends;
   let parentName;
   if (extendsAttr) {
@@ -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-D6ZF3OJA.js");
+      const { integrateChildren: integrateChildren2 } = await import("./interpreter-KOWJFLNS.js");
       await integrateChildren2(session, thenElement);
     }
   } else {
     if (elseElement) {
-      const { integrateChildren: integrateChildren2 } = await import("./interpreter-D6ZF3OJA.js");
+      const { integrateChildren: integrateChildren2 } = await import("./interpreter-KOWJFLNS.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-D6ZF3OJA.js");
+  const { integrate: integrate2 } = await import("./interpreter-KOWJFLNS.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-D6ZF3OJA.js");
+  const { integrate: integrate2 } = await import("./interpreter-KOWJFLNS.js");
   for (const child of condElement.children) {
     if (child.tag.toLowerCase() === "arg") {
       const argOutputStart = session.output.length;
-      const { integrateChildren: integrateChildren2 } = await import("./interpreter-D6ZF3OJA.js");
+      const { integrateChildren: integrateChildren2 } = await import("./interpreter-KOWJFLNS.js");
       await integrateChildren2(session, child);
       const newChunks = session.output.slice(argOutputStart);
       const argValue = newChunks.join("");
@@ -852,7 +852,7 @@ async function executeLLM(session, element) {
   let systemPrompt = "";
   let currentUserPrompt = userPrompt;
   if (!noExtra) {
-    const { getAvailableSubroutines: getAvailableSubroutines2 } = await import("./session-IH5LO7FS.js");
+    const { getAvailableSubroutines: getAvailableSubroutines2 } = await import("./session-6WX5O74B.js");
     const allSubroutines = getAvailableSubroutines2(session);
     if (session.debug) {
       console.error(`[LLM] Total subroutines from session: ${allSubroutines.length}`);
@@ -1053,6 +1053,13 @@ ${result}
       const maxRetries = parseInt(element.attributes["max-retries"] || "0", 10);
       const feedbackMode = element.attributes["feedback"] === "true";
       const confirmCorrections = element.attributes["confirm-corrections"] === "true";
+      console.error(`
+${"=".repeat(60)}`);
+      console.error(`[LLM Original Response]`);
+      console.error(`${"=".repeat(60)}`);
+      console.error(result);
+      console.error(`${"=".repeat(60)}
+`);
       console.error(`[LLM] Execute mode - validate: ${validateTags}, autocorrect: ${autocorrect}, feedback: ${feedbackMode}, confirm-corrections: ${confirmCorrections}, debug: ${session.debug}`);
       const maxIterationsAttr = substituteAttribute(session, element.attributes["max-iterations"] || "3");
       const maxIterations = parseInt(maxIterationsAttr, 10);
@@ -1098,7 +1105,7 @@ ${result}
             if (session.debug) {
               console.error(`[LLM] Validation enabled, autocorrect: ${autocorrect}`);
             }
-            const { validateDiracCode, applyCorrectedTags } = await import("./tag-validator-DS7OCXCG.js");
+            const { validateDiracCode, applyCorrectedTags } = await import("./tag-validator-PWJG4OAM.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) {
@@ -1132,7 +1139,7 @@ ${result}
               if (correctionMessages.length > 0) {
                 console.error("[LLM] Corrections:", correctionMessages.join("; "));
               }
-              dynamicAST = applyCorrectedTags(dynamicAST, validation.results);
+              dynamicAST = applyCorrectedTags(session, dynamicAST, validation.results);
               console.error("[LLM] Applied initial auto-corrections to AST");
               validation = await validateDiracCode(session, dynamicAST, { autocorrect: false, deepValidation: true });
               console.error(`[LLM] Re-validation after corrections: valid=${validation.valid}`);
@@ -1183,6 +1190,13 @@ Please fix these errors and generate valid Dirac XML again. Remember to only use
               } else if (saveDialog) {
                 setVariable(session, "__llm_dialog__", JSON.stringify(dialogHistory), true);
               }
+              console.error(`
+${"=".repeat(60)}`);
+              console.error(`[LLM Original Response - Retry ${retryCount}]`);
+              console.error(`${"=".repeat(60)}`);
+              console.error(result);
+              console.error(`${"=".repeat(60)}
+`);
               if (session.debug) {
                 console.error(`[LLM] Retry ${retryCount} response:
 ${result}
@@ -1266,6 +1280,13 @@ If you resubmit this corrected code, I will execute it for you. Please review an
                 } else if (saveDialog) {
                   setVariable(session, "__llm_dialog__", JSON.stringify(dialogHistory), true);
                 }
+                console.error(`
+${"=".repeat(60)}`);
+                console.error(`[LLM Original Response - Confirmation]`);
+                console.error(`${"=".repeat(60)}`);
+                console.error(result);
+                console.error(`${"=".repeat(60)}
+`);
                 console.error(`[LLM] LLM confirmation response:
 ${result}
 `);
@@ -1343,6 +1364,13 @@ Please fix the error and try again.`;
               } else if (saveDialog) {
                 setVariable(session, "__llm_dialog__", JSON.stringify(dialogHistory), true);
               }
+              console.error(`
+${"=".repeat(60)}`);
+              console.error(`[LLM Original Response - After Error]`);
+              console.error(`${"=".repeat(60)}`);
+              console.error(result);
+              console.error(`${"=".repeat(60)}
+`);
               continue;
             } else {
               throw execError;
@@ -1428,6 +1456,13 @@ ${feedbackPrompt}
             } else if (saveDialog) {
               setVariable(session, "__llm_dialog__", JSON.stringify(dialogHistory), true);
             }
+            console.error(`
+${"=".repeat(60)}`);
+            console.error(`[LLM Original Response - Feedback Loop]`);
+            console.error(`${"=".repeat(60)}`);
+            console.error(result);
+            console.error(`${"=".repeat(60)}
+`);
             if (session.debug) {
               console.error(`[LLM] Feedback response:
 ${result}
@@ -1494,6 +1529,13 @@ Please fix these errors and generate valid Dirac XML code. Remember:
             } else if (saveDialog) {
               setVariable(session, "__llm_dialog__", JSON.stringify(dialogHistory), true);
             }
+            console.error(`
+${"=".repeat(60)}`);
+            console.error(`[LLM Original Response - After Parse Error]`);
+            console.error(`${"=".repeat(60)}`);
+            console.error(result);
+            console.error(`${"=".repeat(60)}
+`);
             if (session.debug) {
               console.error(`[LLM] LLM correction response:
 ${result}
@@ -1968,7 +2010,7 @@ async function getBestTagMatch(candidate, allowed) {
   return { tag: allowed[bestIdx], score: bestScore };
 }
 async function executeTagCheck(session, element) {
-  const { getAvailableSubroutines: getAvailableSubroutines2 } = await import("./session-IH5LO7FS.js");
+  const { getAvailableSubroutines: getAvailableSubroutines2 } = await import("./session-6WX5O74B.js");
   const subroutines = getAvailableSubroutines2(session);
   const allowed = new Set(subroutines.map((s) => s.name));
   console.error("[tag-check] Allowed subroutines:", Array.from(allowed));
@@ -2061,7 +2103,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-D6ZF3OJA.js");
+      const { integrate: integrate2 } = await import("./interpreter-KOWJFLNS.js");
       await integrate2(session, elementToExecute);
     }
   }
@@ -2070,7 +2112,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-D6ZF3OJA.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-KOWJFLNS.js");
   const exceptionDom = {
     tag: "exception-content",
     attributes: { name: exceptionName },
@@ -2083,7 +2125,7 @@ async function executeThrow(session, element) {
 // src/tags/try.ts
 async function executeTry(session, element) {
   setExceptionBoundary(session);
-  const { integrateChildren: integrateChildren2 } = await import("./interpreter-D6ZF3OJA.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-KOWJFLNS.js");
   await integrateChildren2(session, element);
   unsetExceptionBoundary(session);
 }
@@ -2093,7 +2135,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-D6ZF3OJA.js");
+    const { integrateChildren: integrateChildren2 } = await import("./interpreter-KOWJFLNS.js");
     await integrateChildren2(session, element);
   }
   flushCurrentException(session);
@@ -2102,7 +2144,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-D6ZF3OJA.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-KOWJFLNS.js");
   for (const exceptionDom of exceptions) {
     await integrateChildren2(session, exceptionDom);
   }
@@ -2303,7 +2345,7 @@ async function executeLoadContext(session, element) {
     query = element.text.trim();
   }
   if (!query && element.children.length > 0) {
-    const { integrate: integrate2 } = await import("./interpreter-D6ZF3OJA.js");
+    const { integrate: integrate2 } = await import("./interpreter-KOWJFLNS.js");
     const beforeOutput = session.output.length;
     for (const child of element.children) {
       await integrate2(session, child);
@@ -2372,7 +2414,7 @@ async function executeLoadContext(session, element) {
       parameters: s.parameters.map((p) => p.name),
       filePath: s.filePath
     }));
-    const { setVariable: setVariable2 } = await import("./session-IH5LO7FS.js");
+    const { setVariable: setVariable2 } = await import("./session-6WX5O74B.js");
     setVariable2(session, outputVar, JSON.stringify(summary, null, 2), false);
   }
 }
@@ -3147,7 +3189,7 @@ async function executeForeach(session, element) {
     const parser2 = new DiracParser2();
     try {
       const fromElement = parser2.parse(fromAttr);
-      const { integrate: integrate2 } = await import("./interpreter-D6ZF3OJA.js");
+      const { integrate: integrate2 } = await import("./interpreter-KOWJFLNS.js");
       await integrate2(session, fromElement);
     } catch (e) {
       session.output = savedOutput;

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

@@ -1,12 +1,12 @@
 import {
   integrate
-} from "./chunk-LAEYP4OQ.js";
+} from "./chunk-OUCAV57A.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";
 import {
   createSession
-} from "./chunk-PPH7KYKH.js";
+} from "./chunk-ZYSWVMID.js";
 
 // src/session-server.ts
 import net from "net";

package/dist/{chunk-PPH7KYKH.js → chunk-ZYSWVMID.js}

@@ -260,6 +260,11 @@ function cleanSubroutinesToBoundary(session, callerSubroutine) {
     session.subroutines = session.subroutines.slice(0, session.subBoundary);
   }
 }
+function removeSubroutine(session, name) {
+  const initialLength = session.subroutines.length;
+  session.subroutines = session.subroutines.filter((s) => s.name !== name);
+  return session.subroutines.length < initialLength;
+}
 function substituteVariables(session, text) {
   return text.replace(/&#10;/g, "\n").replace(/&#13;/g, "\r").replace(/&#9;/g, "	").replace(/&lt;/g, "<").replace(/&gt;/g, ">").replace(/&amp;/g, "&").replace(/&quot;/g, '"').replace(/&apos;/g, "'");
 }
@@ -351,6 +356,7 @@ export {
   setSubroutineBoundary,
   popSubroutinesToBoundary,
   cleanSubroutinesToBoundary,
+  removeSubroutine,
   substituteVariables,
   emit,
   getOutput,

package/dist/cli.js

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   execute
-} from "./chunk-MYWEN36N.js";
+} from "./chunk-7MSWEFH5.js";
 import {
   BraKetParser
-} from "./chunk-LAEYP4OQ.js";
-import "./chunk-SLGJRZ3P.js";
+} from "./chunk-OUCAV57A.js";
+import "./chunk-53QJQ2CC.js";
 import "./chunk-HRHAMPOB.js";
-import "./chunk-ECAW4X46.js";
-import "./chunk-PPH7KYKH.js";
+import "./chunk-EAM7IZWA.js";
+import "./chunk-ZYSWVMID.js";
 
 // src/cli.ts
 import "dotenv/config";
@@ -16,7 +16,7 @@ import "dotenv/config";
 // package.json
 var package_default = {
   name: "dirac-lang",
-  version: "0.1.98",
+  version: "0.1.99",
   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-KNEQHL3Y.js");
+    const { DiracShell } = await import("./shell-GXXSZYY7.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-5Q5MQOV2.js");
+      const { runAgentDaemon } = await import("./agent-CWCOOLLO.js");
       await runAgentDaemon();
       return;
     }
-    const { AgentCLI } = await import("./agent-5Q5MQOV2.js");
+    const { AgentCLI } = await import("./agent-CWCOOLLO.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-KNEQHL3Y.js");
-    const { SessionServer, isSessionRunning, getSocketPath } = await import("./session-server-N53QIJO5.js");
+    const { DiracShell } = await import("./shell-GXXSZYY7.js");
+    const { SessionServer, isSessionRunning, getSocketPath } = await import("./session-server-QXL2SQWJ.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-N53QIJO5.js");
+    const { SessionServer } = await import("./session-server-QXL2SQWJ.js");
     const server = new SessionServer();
     await server.start();
     console.log("Session daemon started");

package/dist/{cron-VCUFU2WU.js → cron-3W32GKBD.js}

@@ -3,11 +3,11 @@ import {
   listCronJobs,
   stopAllCronJobs,
   stopCronJob
-} from "./chunk-LAEYP4OQ.js";
-import "./chunk-SLGJRZ3P.js";
+} from "./chunk-OUCAV57A.js";
+import "./chunk-53QJQ2CC.js";
 import "./chunk-HRHAMPOB.js";
-import "./chunk-ECAW4X46.js";
-import "./chunk-PPH7KYKH.js";
+import "./chunk-EAM7IZWA.js";
+import "./chunk-ZYSWVMID.js";
 export {
   executeCron,
   listCronJobs,

package/dist/index.js

@@ -2,20 +2,20 @@ import {
   createLLMAdapter,
   execute,
   executeUserCommand
-} from "./chunk-MYWEN36N.js";
+} from "./chunk-7MSWEFH5.js";
 import {
   integrate
-} from "./chunk-LAEYP4OQ.js";
-import "./chunk-SLGJRZ3P.js";
+} from "./chunk-OUCAV57A.js";
+import "./chunk-53QJQ2CC.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";
-import "./chunk-ECAW4X46.js";
+import "./chunk-EAM7IZWA.js";
 import {
   createSession,
   getAvailableSubroutines,
   getOutput
-} from "./chunk-PPH7KYKH.js";
+} from "./chunk-ZYSWVMID.js";
 export {
   DiracParser,
   createLLMAdapter,

package/dist/interpreter-KOWJFLNS.js

@@ -0,0 +1,12 @@
+import {
+  integrate,
+  integrateChildren
+} from "./chunk-OUCAV57A.js";
+import "./chunk-53QJQ2CC.js";
+import "./chunk-HRHAMPOB.js";
+import "./chunk-EAM7IZWA.js";
+import "./chunk-ZYSWVMID.js";
+export {
+  integrate,
+  integrateChildren
+};

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

@@ -3,11 +3,11 @@ import {
   cancelScheduledRun,
   executeRunAt,
   listScheduledRuns
-} from "./chunk-LAEYP4OQ.js";
-import "./chunk-SLGJRZ3P.js";
+} from "./chunk-OUCAV57A.js";
+import "./chunk-53QJQ2CC.js";
 import "./chunk-HRHAMPOB.js";
-import "./chunk-ECAW4X46.js";
-import "./chunk-PPH7KYKH.js";
+import "./chunk-EAM7IZWA.js";
+import "./chunk-ZYSWVMID.js";
 export {
   cancelAllScheduledRuns,
   cancelScheduledRun,

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

@@ -3,11 +3,11 @@ import {
   listScheduledTasks,
   stopAllScheduledTasks,
   stopScheduledTask
-} from "./chunk-LAEYP4OQ.js";
-import "./chunk-SLGJRZ3P.js";
+} from "./chunk-OUCAV57A.js";
+import "./chunk-53QJQ2CC.js";
 import "./chunk-HRHAMPOB.js";
-import "./chunk-ECAW4X46.js";
-import "./chunk-PPH7KYKH.js";
+import "./chunk-EAM7IZWA.js";
+import "./chunk-ZYSWVMID.js";
 export {
   executeSchedule,
   listScheduledTasks,

package/dist/{session-IH5LO7FS.js → session-6WX5O74B.js}

@@ -18,6 +18,7 @@ import {
   popToBoundary,
   pushParameters,
   registerSubroutine,
+  removeSubroutine,
   setBoundary,
   setExceptionBoundary,
   setSubroutineBoundary,
@@ -26,7 +27,7 @@ import {
   substituteVariables,
   throwException,
   unsetExceptionBoundary
-} from "./chunk-PPH7KYKH.js";
+} from "./chunk-ZYSWVMID.js";
 export {
   cleanSubroutinesToBoundary,
   cleanToBoundary,
@@ -47,6 +48,7 @@ export {
   popToBoundary,
   pushParameters,
   registerSubroutine,
+  removeSubroutine,
   setBoundary,
   setExceptionBoundary,
   setSubroutineBoundary,

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

@@ -2,12 +2,12 @@ import {
   SessionServer,
   getSocketPath,
   isSessionRunning
-} from "./chunk-33DMGFRM.js";
-import "./chunk-LAEYP4OQ.js";
-import "./chunk-SLGJRZ3P.js";
+} from "./chunk-TIQ36H2U.js";
+import "./chunk-OUCAV57A.js";
+import "./chunk-53QJQ2CC.js";
 import "./chunk-HRHAMPOB.js";
-import "./chunk-ECAW4X46.js";
-import "./chunk-PPH7KYKH.js";
+import "./chunk-EAM7IZWA.js";
+import "./chunk-ZYSWVMID.js";
 export {
   SessionServer,
   getSocketPath,

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

@@ -2,15 +2,15 @@
 import {
   BraKetParser,
   integrate
-} from "./chunk-LAEYP4OQ.js";
-import "./chunk-SLGJRZ3P.js";
+} from "./chunk-OUCAV57A.js";
+import "./chunk-53QJQ2CC.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";
-import "./chunk-ECAW4X46.js";
+import "./chunk-EAM7IZWA.js";
 import {
   createSession
-} from "./chunk-PPH7KYKH.js";
+} from "./chunk-ZYSWVMID.js";
 
 // src/shell.ts
 import * as readline from "readline";
@@ -358,7 +358,7 @@ var DiracShell = class {
     if (this.client) {
       this.client.disconnect();
     }
-    import("./schedule-3EJJHG3B.js").then(({ stopAllScheduledTasks }) => {
+    import("./schedule-6RWIIII3.js").then(({ stopAllScheduledTasks }) => {
       stopAllScheduledTasks();
       console.log("\nGoodbye!");
       process.exit(0);
@@ -541,6 +541,8 @@ Commands:
   :search <query> Search indexed subroutines
   :load <query>   Load context (search and import subroutines)
   :save <name> [file]  Save subroutine (default: ~/.dirac/lib/TIMESTAMP/name.di)
+  :edit <name>    Edit subroutine in external editor
+  :remove <name>  Remove subroutine from session stack (not from disk)
   :stats          Show registry statistics
   :tasks          List all scheduled tasks
   :stop <name>    Stop a scheduled task
@@ -552,6 +554,7 @@ Commands:
   :cancel <name>  Cancel a scheduled run
   :cancelall      Cancel all scheduled runs
   :save-training [mode=full|pruned|both]  Save LLM dialog as training data (opens in editor)
+  :save-subroutine-training <name>  Save subroutine as training data with description
   :exit           Exit shell
 
 Syntax:
@@ -758,6 +761,49 @@ Examples:
           }
         }
         break;
+      case "edit":
+        if (args.length === 0) {
+          console.log("Usage: :edit <subroutine-name>");
+          console.log("  Opens the subroutine in your default editor ($EDITOR or vi)");
+          console.log("Examples:");
+          console.log("  :edit greet                    # edit greet subroutine in default editor");
+          console.log("  Use :save after editing to persist changes to disk");
+        } else {
+          const subName = args[0];
+          try {
+            const xml = `<edit-subroutine name="${subName}" />`;
+            const ast = this.xmlParser.parse(xml);
+            await integrate(this.session, ast);
+            if (this.session.output.length > 0) {
+              console.log(this.session.output.join(""));
+            }
+          } catch (error) {
+            console.error("Error editing subroutine:", error instanceof Error ? error.message : String(error));
+          }
+        }
+        break;
+      case "remove":
+        if (args.length === 0) {
+          console.log("Usage: :remove <subroutine-name>");
+          console.log("  Removes all instances of the subroutine from the session stack");
+          console.log("  Note: This does NOT delete the subroutine from disk");
+          console.log("Examples:");
+          console.log("  :remove greet                  # remove greet subroutine from session");
+        } else {
+          const subName = args[0];
+          try {
+            const { removeSubroutine } = await import("./session-6WX5O74B.js");
+            const removed = removeSubroutine(this.session, subName);
+            if (removed) {
+              console.log(`Removed subroutine '${subName}' from session stack`);
+            } else {
+              console.log(`Subroutine '${subName}' not found in session`);
+            }
+          } catch (error) {
+            console.error("Error removing subroutine:", error instanceof Error ? error.message : String(error));
+          }
+        }
+        break;
       case "stats":
         try {
           const xml = "<registry-stats />";
@@ -772,7 +818,7 @@ Examples:
         break;
       case "tasks":
         try {
-          const { listScheduledTasks } = await import("./schedule-3EJJHG3B.js");
+          const { listScheduledTasks } = await import("./schedule-6RWIIII3.js");
           const tasks = listScheduledTasks();
           if (tasks.length === 0) {
             console.log("No scheduled tasks running.");
@@ -791,7 +837,7 @@ Examples:
           console.log("Usage: :stop <task-name>");
         } else {
           try {
-            const { stopScheduledTask } = await import("./schedule-3EJJHG3B.js");
+            const { stopScheduledTask } = await import("./schedule-6RWIIII3.js");
             const taskName = args[0];
             const stopped = stopScheduledTask(taskName);
             if (stopped) {
@@ -806,7 +852,7 @@ Examples:
         break;
       case "stopall":
         try {
-          const { stopAllScheduledTasks } = await import("./schedule-3EJJHG3B.js");
+          const { stopAllScheduledTasks } = await import("./schedule-6RWIIII3.js");
           stopAllScheduledTasks();
           console.log("All scheduled tasks stopped.");
         } catch (error) {
@@ -815,7 +861,7 @@ Examples:
         break;
       case "crons":
         try {
-          const { listCronJobs } = await import("./cron-VCUFU2WU.js");
+          const { listCronJobs } = await import("./cron-3W32GKBD.js");
           const jobs = listCronJobs();
           if (jobs.length === 0) {
             console.log("No cron jobs running.");
@@ -835,7 +881,7 @@ Examples:
           console.log("Usage: :stopcron <job-name>");
         } else {
           try {
-            const { stopCronJob } = await import("./cron-VCUFU2WU.js");
+            const { stopCronJob } = await import("./cron-3W32GKBD.js");
             const jobName = args[0];
             const stopped = stopCronJob(jobName);
             if (stopped) {
@@ -850,7 +896,7 @@ Examples:
         break;
       case "stopallcrons":
         try {
-          const { stopAllCronJobs } = await import("./cron-VCUFU2WU.js");
+          const { stopAllCronJobs } = await import("./cron-3W32GKBD.js");
           stopAllCronJobs();
           console.log("All cron jobs stopped.");
         } catch (error) {
@@ -859,7 +905,7 @@ Examples:
         break;
       case "scheduled":
         try {
-          const { listScheduledRuns } = await import("./run-at-P43PK5JU.js");
+          const { listScheduledRuns } = await import("./run-at-S37OQ7RA.js");
           const runs = listScheduledRuns();
           if (runs.length === 0) {
             console.log("No scheduled runs pending.");
@@ -879,7 +925,7 @@ Examples:
           console.log("Usage: :cancel <run-name>");
         } else {
           try {
-            const { cancelScheduledRun } = await import("./run-at-P43PK5JU.js");
+            const { cancelScheduledRun } = await import("./run-at-S37OQ7RA.js");
             const runName = args[0];
             const cancelled = cancelScheduledRun(runName);
             if (cancelled) {
@@ -894,13 +940,99 @@ Examples:
         break;
       case "cancelall":
         try {
-          const { cancelAllScheduledRuns } = await import("./run-at-P43PK5JU.js");
+          const { cancelAllScheduledRuns } = await import("./run-at-S37OQ7RA.js");
           cancelAllScheduledRuns();
           console.log("All scheduled runs cancelled.");
         } catch (error) {
           console.error("Error cancelling runs:", error instanceof Error ? error.message : String(error));
         }
         break;
+      case "save-subroutine-training":
+        if (args.length === 0) {
+          console.log("Usage: :save-subroutine-training <subroutine-name>");
+          console.log("  Saves a subroutine as training data (opens in editor)");
+          console.log("  You will be prompted to provide a description for the training example");
+          console.log("Examples:");
+          console.log("  :save-subroutine-training greet");
+        } else {
+          const subName = args[0];
+          try {
+            let subroutine = void 0;
+            const subroutines = this.client ? (await this.client.getState()).subroutines || [] : this.session.subroutines;
+            for (let i = subroutines.length - 1; i >= 0; i--) {
+              if (subroutines[i].name === subName) {
+                subroutine = subroutines[i];
+                break;
+              }
+            }
+            if (!subroutine) {
+              console.log(`Subroutine '${subName}' not found in session`);
+              break;
+            }
+            const description = await new Promise((resolve2) => {
+              this.rl.question(`Enter description (user's request that would generate this subroutine): `, resolve2);
+            });
+            if (!description.trim()) {
+              console.log("Cancelled (no description provided)");
+              break;
+            }
+            const { serializeSubroutineForTraining } = await import("./subroutine-serializer-LNFHABUC.js");
+            const subroutineContent = serializeSubroutineForTraining(subroutine);
+            const trainingExample = {
+              messages: [
+                { role: "user", content: description.trim() },
+                { role: "assistant", content: subroutineContent }
+              ]
+            };
+            const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").split("T")[0] + "-" + Date.now();
+            const tempFile = path.join(os.tmpdir(), `dirac-subroutine-training-${timestamp}.jsonl`);
+            const tempContent = JSON.stringify(trainingExample, null, 2);
+            fs.writeFileSync(tempFile, tempContent, "utf-8");
+            console.log("Opening in editor...");
+            const editor = process.env.EDITOR || process.env.VISUAL || "vi";
+            const { spawnSync } = await import("child_process");
+            const result = spawnSync(editor, [tempFile], {
+              stdio: "inherit",
+              shell: true
+            });
+            if (result.error) {
+              fs.unlinkSync(tempFile);
+              console.error(`Failed to open editor: ${result.error.message}`);
+              break;
+            }
+            if (result.status !== 0) {
+              fs.unlinkSync(tempFile);
+              console.error(`Editor exited with code ${result.status}`);
+              break;
+            }
+            const answer = await new Promise((resolve2) => {
+              this.rl.question("Save to file (or press Enter to cancel): ", resolve2);
+            });
+            if (!answer.trim()) {
+              fs.unlinkSync(tempFile);
+              console.log("Cancelled");
+              break;
+            }
+            let savePath;
+            if (answer.startsWith("/") || answer.startsWith("~")) {
+              savePath = answer.replace(/^~/, os.homedir());
+            } else if (answer.includes("/")) {
+              savePath = path.resolve(answer);
+            } else {
+              const trainingDir = path.join(os.homedir(), ".dirac", "training");
+              fs.mkdirSync(trainingDir, { recursive: true });
+              savePath = path.join(trainingDir, answer.endsWith(".jsonl") ? answer : `${answer}.jsonl`);
+            }
+            const editedContent = fs.readFileSync(tempFile, "utf-8");
+            const editedData = JSON.parse(editedContent);
+            fs.appendFileSync(savePath, JSON.stringify(editedData) + "\n");
+            console.log(`\u2713 Saved training example for '${subName}' to ${savePath}`);
+            fs.unlinkSync(tempFile);
+          } catch (error) {
+            console.error("Error saving subroutine training data:", error instanceof Error ? error.message : String(error));
+          }
+        }
+        break;
       case "save-training":
         try {
           const fullCommand = cmd.slice(1);
@@ -1162,7 +1294,7 @@ ${JSON.stringify(prunedExample, null, 2)}`;
       console.log("Set ANTHROPIC_API_KEY or OPENAI_API_KEY environment variable,");
       console.log("or create ~/.dirac/config.yml with llmProvider and llmModel.\n");
     }
-    const { registry } = await import("./subroutine-index-RVJSWWJ7.js");
+    const { registry } = await import("./subroutine-index-GB3OSH56.js");
     const wasIndexed = await registry.autoIndexStdlib();
     await this.loadEssentialSubroutines();
     if (this.config.initScript) {

package/dist/{subroutine-7JJKHTV4.js → subroutine-O3YGYHRZ.js}

@@ -1,7 +1,7 @@
 import {
   executeSubroutine
-} from "./chunk-ECAW4X46.js";
-import "./chunk-PPH7KYKH.js";
+} from "./chunk-EAM7IZWA.js";
+import "./chunk-ZYSWVMID.js";
 export {
   executeSubroutine
 };

package/dist/{subroutine-index-RVJSWWJ7.js → subroutine-index-GB3OSH56.js}

@@ -3,9 +3,9 @@ import {
   executeRegistryStats,
   executeSearchSubroutines,
   registry
-} from "./chunk-SLGJRZ3P.js";
+} from "./chunk-53QJQ2CC.js";
 import "./chunk-HRHAMPOB.js";
-import "./chunk-PPH7KYKH.js";
+import "./chunk-ZYSWVMID.js";
 export {
   executeIndexSubroutines,
   executeRegistryStats,

package/dist/subroutine-serializer-LNFHABUC.js

@@ -0,0 +1,160 @@
+// src/utils/subroutine-serializer.ts
+function serializeSubroutineForTraining(sub) {
+  const lines = [];
+  serializeElement(sub.element, lines, "");
+  return lines.join("\n");
+}
+function serializeSubroutineToXML(sub) {
+  const lines = [];
+  lines.push("<!-- Editing subroutine: " + sub.name + " -->");
+  lines.push("");
+  serializeElement(sub.element, lines, "");
+  return lines.join("\n");
+}
+function serializeElement(el, lines, indent) {
+  if (!el.tag || el.tag === "") {
+    if (el.text) {
+      let lastIdx = lines.length - 1;
+      if (lastIdx >= 0 && !lines[lastIdx].endsWith(">")) {
+        lines[lastIdx] += el.text;
+      } else {
+        lines.push(indent + el.text);
+      }
+    }
+    return;
+  }
+  let tag = `${indent}<${el.tag}`;
+  if (el.attributes) {
+    for (const [key, value] of Object.entries(el.attributes)) {
+      if (typeof value === "string") {
+        tag += ` ${key}="${value.replace(/"/g, "&quot;")}"`;
+      }
+    }
+  }
+  const hasChildren = el.children && el.children.length > 0;
+  if (!hasChildren) {
+    let lastIdx = lines.length - 1;
+    if (lastIdx >= 0 && !lines[lastIdx].endsWith(">") && !lines[lastIdx].trim().startsWith("<")) {
+      lines[lastIdx] += tag.slice(indent.length) + " />";
+    } else {
+      lines.push(tag + " />");
+    }
+  } else {
+    let lastIdx = lines.length - 1;
+    const shouldInline = lastIdx >= 0 && !lines[lastIdx].endsWith(">");
+    if (shouldInline) {
+      lines[lastIdx] += tag.slice(indent.length) + ">";
+    } else {
+      lines.push(tag + ">");
+    }
+    let allInline = true;
+    for (let i = 0; i < el.children.length; i++) {
+      const child = el.children[i];
+      if (!child.tag || child.tag === "") {
+        if (child.text) {
+          lastIdx = lines.length - 1;
+          lines[lastIdx] += child.text;
+        }
+      } else {
+        const isComplex = child.children && child.children.length > 0;
+        if (isComplex) {
+          allInline = false;
+          serializeElement(child, lines, indent + "  ");
+        } else {
+          let childTag = `<${child.tag}`;
+          if (child.attributes) {
+            for (const [key, value] of Object.entries(child.attributes)) {
+              if (typeof value === "string") {
+                childTag += ` ${key}="${value.replace(/"/g, "&quot;")}"`;
+              }
+            }
+          }
+          childTag += " />";
+          lastIdx = lines.length - 1;
+          lines[lastIdx] += childTag;
+        }
+      }
+    }
+    lastIdx = lines.length - 1;
+    if (allInline && lines[lastIdx].indexOf("<") > 0) {
+      lines[lastIdx] += `</${el.tag}>`;
+    } else {
+      lines.push(`${indent}</${el.tag}>`);
+    }
+  }
+}
+function serializeSubroutineToBraKet(sub) {
+  const lines = [];
+  lines.push("<!-- Editing subroutine: " + sub.name + " -->");
+  lines.push("");
+  serializeElementToBraKet(sub.element, lines, 0);
+  return lines.join("\n");
+}
+function serializeElementToBraKet(el, lines, indent) {
+  const indentStr = "  ".repeat(indent);
+  if (!el.tag || el.tag === "") {
+    if (el.text) {
+      lines.push(indentStr + el.text);
+    }
+    return;
+  }
+  if (el.tag === "subroutine") {
+    const name = el.attributes?.name || "unnamed";
+    let braLine = `${indentStr}<${name}|`;
+    if (el.attributes) {
+      for (const [key, value] of Object.entries(el.attributes)) {
+        if (key === "name") continue;
+        const needsQuotes = typeof value === "string" && (value.includes(" ") || value.includes("="));
+        braLine += ` ${key}=${needsQuotes ? '"' + value + '"' : value}`;
+      }
+    }
+    lines.push(braLine);
+    if (el.children && el.children.length > 0) {
+      for (const child of el.children) {
+        serializeElementToBraKet(child, lines, indent + 1);
+      }
+    }
+    return;
+  }
+  let ketLine = `${indentStr}|${el.tag}`;
+  if (el.attributes) {
+    for (const [key, value] of Object.entries(el.attributes)) {
+      if (typeof value === "string") {
+        const needsQuotes = value.includes(" ") || value.includes("=");
+        ketLine += ` ${key}=${needsQuotes ? '"' + value + '"' : value}`;
+      }
+    }
+  }
+  ketLine += ">";
+  if (el.children && el.children.length > 0) {
+    const hasComplexChildren = el.children.some(
+      (c) => c.tag && c.tag !== "variable" && (c.children?.length > 0 || c.tag === "subroutine")
+    );
+    if (!hasComplexChildren) {
+      let inlineContent = "";
+      for (const child of el.children) {
+        if (!child.tag || child.tag === "") {
+          inlineContent += child.text || "";
+        } else if (child.tag === "variable") {
+          const varName = child.attributes?.name || "";
+          inlineContent += `|variable name=${varName}>`;
+        } else {
+          inlineContent += `|${child.tag}>`;
+        }
+      }
+      lines.push(ketLine + inlineContent);
+    } else {
+      lines.push(ketLine);
+      for (const child of el.children) {
+        serializeElementToBraKet(child, lines, indent + 1);
+      }
+    }
+  } else {
+    lines.push(ketLine);
+  }
+}
+export {
+  serializeSubroutineForTraining,
+  serializeSubroutineToBraKet,
+  serializeSubroutineToXML
+};

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

@@ -108,8 +108,10 @@ async function validateNestedTags(session, element, options = {}) {
 }
 async function validateTag(session, element, options = {}) {
   const { autocorrect = false, similarityCutoff = SIMILARITY_CUTOFF, deepValidation = false } = options;
-  console.error(`[VALIDATE] Tag: <${element.tag}>, autocorrect: ${autocorrect}, attributes:`, Object.keys(element.attributes));
-  const { getAvailableSubroutines } = await import("./session-IH5LO7FS.js");
+  if (session.debug) {
+    console.error(`[VALIDATE] Tag: <${element.tag}>, autocorrect: ${autocorrect}, attributes:`, Object.keys(element.attributes));
+  }
+  const { getAvailableSubroutines } = await import("./session-6WX5O74B.js");
   const subroutines = getAvailableSubroutines(session);
   const allowed = new Set(subroutines.map((s) => s.name));
   const tagName = element.tag;
@@ -126,11 +128,15 @@ async function validateTag(session, element, options = {}) {
     scopeValidation: void 0
   };
   if (allowed.has(tagName)) {
-    console.error(`[VALIDATE] Tag <${tagName}> is valid`);
+    if (session.debug) {
+      console.error(`[VALIDATE] Tag <${tagName}> is valid`);
+    }
     const sub = subroutines.find((s) => s.name === tagName);
     if (sub && Array.isArray(sub.parameters)) {
       const paramNames = sub.parameters.map((p) => p.name);
-      console.error(`[VALIDATE] Tag <${tagName}> has ${paramNames.length} parameters:`, paramNames);
+      if (session.debug) {
+        console.error(`[VALIDATE] Tag <${tagName}> has ${paramNames.length} parameters:`, paramNames);
+      }
       for (const param of sub.parameters) {
         if (param.required && !(param.name in element.attributes)) {
           result.errors.push(`Missing required parameter: ${param.name}`);
@@ -138,11 +144,15 @@ async function validateTag(session, element, options = {}) {
       }
       for (const attr in element.attributes) {
         if (tagName === "subroutine" && (attr.startsWith("param-") || attr.startsWith("meta-"))) {
-          console.error(`[VALIDATE] Skipping validation for wildcard attribute '${attr}' on <subroutine>`);
+          if (session.debug) {
+            console.error(`[VALIDATE] Skipping validation for wildcard attribute '${attr}' on <subroutine>`);
+          }
           continue;
         }
         if (!paramNames.includes(attr)) {
-          console.error(`[VALIDATE] Unknown attribute '${attr}' on <${tagName}>`);
+          if (session.debug) {
+            console.error(`[VALIDATE] Unknown attribute '${attr}' on <${tagName}>`);
+          }
           if (autocorrect && paramNames.length > 0) {
             let correctedAttr = null;
             let similarityScore = 0;
@@ -152,21 +162,31 @@ async function validateTag(session, element, options = {}) {
               result.attributeCorrections[attr] = correctedAttr;
               result.corrected = true;
               result.warnings.push(`Auto-corrected attribute: ${attr}="${element.attributes[attr]}" \u2192 ${correctedAttr}="${element.attributes[attr]}" (only parameter available)`);
-              console.error(`[VALIDATE] Auto-corrected (single param): ${attr} \u2192 ${correctedAttr}`);
+              if (session.debug) {
+                console.error(`[VALIDATE] Auto-corrected (single param): ${attr} \u2192 ${correctedAttr}`);
+              }
             } else {
-              console.error(`[VALIDATE] Checking similarity for '${attr}' against:`, paramNames);
+              if (session.debug) {
+                console.error(`[VALIDATE] Checking similarity for '${attr}' against:`, paramNames);
+              }
               const best = await getBestTagMatch(attr, paramNames);
-              console.error(`[VALIDATE] Best match: ${best.tag} with score ${best.score.toFixed(2)}, cutoff: ${similarityCutoff}`);
+              if (session.debug) {
+                console.error(`[VALIDATE] Best match: ${best.tag} with score ${best.score.toFixed(2)}, cutoff: ${similarityCutoff}`);
+              }
               if (best.score >= similarityCutoff) {
                 correctedAttr = best.tag;
                 similarityScore = best.score;
                 result.attributeCorrections[attr] = correctedAttr;
                 result.corrected = true;
                 result.warnings.push(`Auto-corrected attribute: ${attr}="${element.attributes[attr]}" \u2192 ${correctedAttr}="${element.attributes[attr]}" (similarity: ${similarityScore.toFixed(2)})`);
-                console.error(`[VALIDATE] Auto-corrected (similarity): ${attr} \u2192 ${correctedAttr}`);
+                if (session.debug) {
+                  console.error(`[VALIDATE] Auto-corrected (similarity): ${attr} \u2192 ${correctedAttr}`);
+                }
               } else {
                 result.warnings.push(`Unknown attribute: ${attr} (no similar match found, best: ${best.tag} with score ${best.score.toFixed(2)})`);
-                console.error(`[VALIDATE] No correction (score too low): ${attr}, best was ${best.tag} (${best.score.toFixed(2)})`);
+                if (session.debug) {
+                  console.error(`[VALIDATE] No correction (score too low): ${attr}, best was ${best.tag} (${best.score.toFixed(2)})`);
+                }
               }
             }
           } else {
@@ -193,7 +213,9 @@ async function validateTag(session, element, options = {}) {
         }
       }
       if (deepValidation && tagName === "subroutine" && element.children && element.children.length > 0) {
-        console.error(`[VALIDATE] Deep validation of <subroutine name="${element.attributes.name}">`);
+        if (session.debug) {
+          console.error(`[VALIDATE] Deep validation of <subroutine name="${element.attributes.name}">`);
+        }
         result.nestedValidation = await validateNestedTags(session, element, options);
         for (const nestedResult of result.nestedValidation) {
           if (!nestedResult.valid) {
@@ -202,14 +224,16 @@ async function validateTag(session, element, options = {}) {
         }
         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 (session.debug) {
+          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}`));
         }
@@ -282,7 +306,7 @@ async function validateDiracCode(session, ast, options = {}) {
     }
   }
   extractLocalSubroutines(ast);
-  if (localSubroutineNames.size > 0) {
+  if (localSubroutineNames.size > 0 && session.debug) {
     console.error(`[VALIDATE] Found ${localSubroutineNames.size} local subroutine definitions:`, Array.from(localSubroutineNames));
   }
   const tempSubroutines = [];
@@ -303,7 +327,9 @@ async function validateDiracCode(session, ast, options = {}) {
         });
       }
     }
-    console.error(`[VALIDATE] Temp subroutine '${subName}' has ${parameters.length} parameters:`, parameters.map((p) => p.name));
+    if (session.debug) {
+      console.error(`[VALIDATE] Temp subroutine '${subName}' has ${parameters.length} parameters:`, parameters.map((p) => p.name));
+    }
     const tempSub = {
       name: subName,
       element: subElement,
@@ -342,30 +368,36 @@ async function validateDiracCode(session, ast, options = {}) {
     typeErrors
   };
 }
-function applyCorrectedTags(ast, results) {
+function applyCorrectedTags(session, ast, results) {
   let resultIndex = 0;
   function correctElement(element) {
     const shouldProcess = element.tag && element.tag !== "dirac" && element.tag !== "DIRAC-ROOT" && element.tag.trim() !== "";
     if (shouldProcess && resultIndex < results.length) {
       const result = results[resultIndex++];
-      console.error(`[APPLY-CORRECTION] Processing <${element.tag}> with result #${resultIndex - 1} for <${result.originalTag}>, corrected: ${result.corrected}`);
+      if (session.debug) {
+        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}`);
+        if (session.debug) {
+          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);
+        if (session.debug) {
+          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) {
+          if (newAttr !== oldAttr && session.debug) {
             console.error(`[APPLY-CORRECTION]   ${oldAttr}="${value}" \u2192 ${newAttr}="${value}"`);
           }
           newAttributes[newAttr] = value;
         }
         element = { ...element, attributes: newAttributes };
       }
-    } else if (shouldProcess) {
+    } else if (shouldProcess && session.debug) {
       console.error(`[APPLY-CORRECTION] WARNING: No result for <${element.tag}> at index ${resultIndex} (total results: ${results.length})`);
     }
     return {

package/dist/test-runner.js

@@ -1,15 +1,15 @@
 import {
   integrate
-} from "./chunk-LAEYP4OQ.js";
-import "./chunk-SLGJRZ3P.js";
+} from "./chunk-OUCAV57A.js";
+import "./chunk-53QJQ2CC.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";
-import "./chunk-ECAW4X46.js";
+import "./chunk-EAM7IZWA.js";
 import {
   createSession,
   getOutput
-} from "./chunk-PPH7KYKH.js";
+} from "./chunk-ZYSWVMID.js";
 
 // src/test-runner.ts
 import fs from "fs";

package/lib/native-tags.di

@@ -219,7 +219,8 @@
   meta-hide-from-llm="true"
   description="Edit subroutine definition in external editor"
   param-name="string:required:Subroutine name to edit"
-  param-editor="string:optional:Editor command (default: $EDITOR or vi)">
+  param-editor="string:optional:Editor command (default: $EDITOR or vi)"
+  param-format="string:optional:format (braket or xml, default:braket)">
   <!-- Opens subroutine in temp file with editor (blocking) -->
   <!-- After save/exit, automatically re-imports into session -->
   <!-- Changes take effect immediately but are NOT saved to disk -->

package/package.json

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

package/dist/interpreter-D6ZF3OJA.js

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