dirac-lang 0.1.44 → 0.1.46

package/dist/{chunk-2SNN7MBU.js → chunk-TISVDOGD.js}

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

package/dist/{chunk-4ROK7OUQ.js → chunk-TXL3RV74.js}

@@ -460,12 +460,12 @@ async function executeIf(session, element) {
   const condition = await evaluatePredicate(session, conditionElement);
   if (condition) {
     if (thenElement) {
-      const { integrateChildren: integrateChildren2 } = await import("./interpreter-Y2BOWVF4.js");
+      const { integrateChildren: integrateChildren2 } = await import("./interpreter-XH3RFKVP.js");
       await integrateChildren2(session, thenElement);
     }
   } else {
     if (elseElement) {
-      const { integrateChildren: integrateChildren2 } = await import("./interpreter-Y2BOWVF4.js");
+      const { integrateChildren: integrateChildren2 } = await import("./interpreter-XH3RFKVP.js");
       await integrateChildren2(session, elseElement);
     }
   }
@@ -478,7 +478,7 @@ async function evaluatePredicate(session, predicateElement) {
     return await evaluateCondition(session, predicateElement);
   }
   const outputLengthBefore = session.output.length;
-  const { integrate: integrate2 } = await import("./interpreter-Y2BOWVF4.js");
+  const { integrate: integrate2 } = await import("./interpreter-XH3RFKVP.js");
   await integrate2(session, predicateElement);
   const newOutputChunks = session.output.slice(outputLengthBefore);
   const result = newOutputChunks.join("").trim();
@@ -501,11 +501,11 @@ async function evaluateCondition(session, condElement) {
   }
   const outputLengthBefore = session.output.length;
   const args = [];
-  const { integrate: integrate2 } = await import("./interpreter-Y2BOWVF4.js");
+  const { integrate: integrate2 } = await import("./interpreter-XH3RFKVP.js");
   for (const child of condElement.children) {
     if (child.tag.toLowerCase() === "arg") {
       const argOutputStart = session.output.length;
-      const { integrateChildren: integrateChildren2 } = await import("./interpreter-Y2BOWVF4.js");
+      const { integrateChildren: integrateChildren2 } = await import("./interpreter-XH3RFKVP.js");
       await integrateChildren2(session, child);
       const newChunks = session.output.slice(argOutputStart);
       const argValue = newChunks.join("");
@@ -564,10 +564,113 @@ function evaluateConditionType(evalType, args) {
 }
 
 // src/tags/llm.ts
+import * as fs2 from "fs";
+import * as path2 from "path";
+import * as os from "os";
+function dumpGeneratedSubroutines(session, diracCode, userPrompt) {
+  try {
+    let findSubroutines2 = function(element) {
+      if (element.tag === "subroutine") {
+        subroutines.push(element);
+      }
+      if (element.children) {
+        for (const child of element.children) {
+          findSubroutines2(child);
+        }
+      }
+    };
+    var findSubroutines = findSubroutines2;
+    const parser = new DiracParser();
+    const ast = parser.parse(diracCode);
+    const subroutines = [];
+    findSubroutines2(ast);
+    if (subroutines.length === 0) {
+      return;
+    }
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, -5);
+    const dumpDir = path2.join(os.homedir(), ".dirac", "lib", timestamp);
+    if (!fs2.existsSync(dumpDir)) {
+      fs2.mkdirSync(dumpDir, { recursive: true });
+    }
+    for (const sub of subroutines) {
+      const subName = sub.attributes.name || "unnamed";
+      const filePath = path2.join(dumpDir, `${subName}.di`);
+      const xml = serializeElement(sub, userPrompt);
+      fs2.writeFileSync(filePath, xml, "utf-8");
+      if (session.debug) {
+        console.error(`[LLM] Dumped subroutine '${subName}' to: ${filePath}`);
+      }
+    }
+    if (session.debug) {
+      console.error(`[LLM] Dumped ${subroutines.length} subroutine(s) to: ${dumpDir}`);
+    }
+  } catch (error) {
+    if (session.debug) {
+      console.error(`[LLM] Failed to dump subroutines: ${error}`);
+    }
+  }
+}
+function serializeElement(element, prompt) {
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+  const lines = [];
+  lines.push("<!--");
+  lines.push(`  Created: ${timestamp}`);
+  lines.push(`  Generated by: LLM`);
+  lines.push(`  Prompt: ${prompt.replace(/-->/g, "--&gt;")}`);
+  lines.push("-->");
+  lines.push("");
+  function serialize(el, indent = "") {
+    if (el.text && !el.tag) {
+      lines.push(indent + el.text);
+      return;
+    }
+    if (!el.tag) return;
+    let tag = `${indent}<${el.tag}`;
+    if (el.attributes) {
+      for (const [key, value] of Object.entries(el.attributes)) {
+        tag += ` ${key}="${value.replace(/"/g, "&quot;")}"`;
+      }
+    }
+    if (!el.children || el.children.length === 0) {
+      if (el.text) {
+        lines.push(tag + ">");
+        lines.push(indent + "  " + el.text);
+        lines.push(`${indent}</${el.tag}>`);
+      } else {
+        lines.push(tag + " />");
+      }
+    } else {
+      lines.push(tag + ">");
+      for (const child of el.children) {
+        serialize(child, indent + "  ");
+      }
+      lines.push(`${indent}</${el.tag}>`);
+    }
+  }
+  serialize(element);
+  return lines.join("\n");
+}
 async function executeLLM(session, element) {
   if (!session.llmClient) {
     throw new Error("<llm> tag requires LLM configuration. Set LLM_PROVIDER (ollama/anthropic/openai/custom) and appropriate API keys in environment or config.yml");
   }
+  const callAnthropic = async (client, model2, maxTokens2, temperature2, messages) => {
+    const systemMessages = messages.filter((m) => m.role === "system");
+    const userAssistantMessages = messages.filter((m) => m.role !== "system");
+    const systemContent = systemMessages.map((m) => m.content).join("\n\n");
+    const anthropicParams = {
+      model: model2,
+      max_tokens: maxTokens2,
+      temperature: temperature2,
+      messages: userAssistantMessages
+    };
+    if (systemContent) {
+      anthropicParams.system = systemContent;
+    }
+    const response = await client.messages.create(anthropicParams);
+    const content = response.content[0];
+    return content.type === "text" ? content.text : "";
+  };
   if (session.limits.currentLLMCalls >= session.limits.maxLLMCalls) {
     throw new Error("Maximum LLM calls exceeded");
   }
@@ -580,6 +683,7 @@ async function executeLLM(session, element) {
   const model = element.attributes.model || process.env.DEFAULT_MODEL || defaultModel;
   const outputVar = element.attributes.output;
   const contextVar = element.attributes.context;
+  const saveDialog = element.attributes["save-dialog"] === "true";
   const executeMode = element.attributes.execute === "true";
   const temperature = parseFloat(element.attributes.temperature || "1.0");
   const maxTokens = parseInt(element.attributes.maxTokens || "4096", 10);
@@ -598,23 +702,29 @@ async function executeLLM(session, element) {
     throw new Error("<LLM> requires prompt content");
   }
   let dialogHistory = [];
-  if (contextVar) {
-    const existing = getVariable(session, contextVar);
+  let hasExistingDialog = false;
+  if (contextVar || saveDialog) {
+    const varName = contextVar || "__llm_dialog__";
+    const existing = getVariable(session, varName);
+    if (session.debug) {
+      console.error(`[LLM] Checking for dialog context in variable: ${varName}`);
+      console.error(`[LLM] Existing value type: ${Array.isArray(existing) ? "array" : typeof existing}`);
+      if (Array.isArray(existing)) {
+        console.error(`[LLM] Existing dialog length: ${existing.length} messages`);
+      }
+    }
     if (Array.isArray(existing)) {
       dialogHistory = [...existing];
+      hasExistingDialog = dialogHistory.length > 0;
     } else if (existing) {
       dialogHistory = [{ role: "system", content: String(existing) }];
+      hasExistingDialog = true;
     }
   }
   const noExtra = element.attributes.noextra === "true";
-  let prompt;
   let systemPrompt = "";
-  if (noExtra) {
-    prompt = userPrompt;
-    if (session.debug || process.env.DIRAC_LOG_PROMPT === "1") {
-      console.error("[LLM] Full prompt sent to LLM (noextra):\n" + prompt + "\n");
-    }
-  } else {
+  let currentUserPrompt = userPrompt;
+  if (!noExtra) {
     const { getAvailableSubroutines: getAvailableSubroutines2 } = await import("./session-UBATJEND.js");
     const subroutines = getAvailableSubroutines2(session);
     if (session.debug) {
@@ -623,48 +733,85 @@ async function executeLLM(session, element) {
         subroutines.map((s) => ({ name: s.name, description: s.description, parameters: s.parameters }))
       );
     }
-    systemPrompt = `Dirac is a XML based language, you define the subroutine like
+    if (hasExistingDialog && (contextVar || saveDialog)) {
+      systemPrompt = "Updated available Dirac XML tags:";
+      for (const sub of subroutines) {
+        systemPrompt += `
+- ${sub.name} : ${sub.description || ""}`;
+        systemPrompt += `
+	Ex: <${sub.name}`;
+        if (sub.parameters && sub.parameters.length > 0) {
+          for (const p of sub.parameters) {
+            systemPrompt += ` ${p.name}="${p.example || "string"}"`;
+          }
+        }
+        let example = sub.meta?.body?.example || "";
+        example = example.replace(/&quot;/g, '"').replace(/&#58;/g, ":");
+        systemPrompt += ">" + example + "</" + sub.name + ">";
+      }
+      currentUserPrompt = systemPrompt + "\n\nUser request: " + userPrompt;
+      if (session.debug || process.env.DIRAC_LOG_PROMPT === "1") {
+        console.error("[LLM] Continuing dialog with updated subroutines\n");
+      }
+    } else {
+      systemPrompt = `Dirac is a XML-based language. To define a subroutine with parameters:
+
 \`\`\`xml
-<subroutine name=background param-color="string">
- <paint_the_color_somewhere />
+<subroutine name="greet" param-name="string">
+  <!-- param-name defines a parameter called "name" -->
+  <!-- Access it inside using: <variable name="name"/> -->
+  <output>Hello, <variable name="name"/>!</output>
 </subroutine>
 \`\`\`
-then you call it like
+
+To call it:
 \`\`\`xml
-<background color="blue" />
+<greet name="Alice" />
+<!-- Use just the parameter name (name), NOT param-name -->
 \`\`\`
+
+CRITICAL: When defining parameters:
+- Use param-NAME="type" format where NAME is the parameter's name
+- Example: param-username="string" means parameter is called "username"
+- Inside the subroutine, access with: <variable name="username"/>
+- When calling: <mytag username="John" /> (use parameter name directly)
 `;
-    systemPrompt += "Now, You are an expert Dirac XML code generator.\nAllowed Dirac XML tags (use ONLY these tags):";
-    for (const sub of subroutines) {
-      systemPrompt += `
+      systemPrompt += "Now, You are an expert Dirac XML code generator.\nAllowed Dirac XML tags (use ONLY these tags):";
+      for (const sub of subroutines) {
+        systemPrompt += `
 - ${sub.name} : ${sub.description || ""}`;
-      systemPrompt += `
+        systemPrompt += `
 	Ex: <${sub.name}`;
-      if (sub.parameters && sub.parameters.length > 0) {
-        for (const p of sub.parameters) {
-          systemPrompt += ` ${p.name}="${p.example || "string"}"`;
+        if (sub.parameters && sub.parameters.length > 0) {
+          for (const p of sub.parameters) {
+            systemPrompt += ` ${p.name}="${p.example || "string"}"`;
+          }
         }
+        let example = sub.meta?.body?.example || "";
+        example = example.replace(/&quot;/g, '"').replace(/&#58;/g, ":");
+        systemPrompt += ">" + example + "</" + sub.name + ">";
+      }
+      systemPrompt += "\n\nIMPORTANT INSTRUCTIONS:";
+      systemPrompt += "\n1. Output ONLY valid XML tags from the list above";
+      systemPrompt += "\n2. Do NOT include any explanations, descriptions, or extra text";
+      systemPrompt += "\n3. Do NOT use bullet points or formatting - just pure XML";
+      systemPrompt += "\n4. Do NOT invent tags - only use tags from the list above";
+      systemPrompt += "\n5. Start your response directly with the XML tag (e.g., <add ...>)";
+      systemPrompt += "\n\nDouble-check: Does your response contain ONLY XML tags? If not, remove all non-XML text.";
+      if (dialogHistory.length === 0) {
+        dialogHistory.push({ role: "system", content: systemPrompt });
+      }
+      currentUserPrompt = userPrompt;
+      if (session.debug || process.env.DIRAC_LOG_PROMPT === "1") {
+        console.error("[LLM] First call - sending full system prompt\n");
       }
-      let example = sub.meta?.body?.example || "";
-      example = example.replace(/&quot;/g, '"').replace(/&#58;/g, ":");
-      systemPrompt += ">" + example + "</" + sub.name + ">";
-    }
-    systemPrompt += "\n\nIMPORTANT INSTRUCTIONS:";
-    systemPrompt += "\n1. Output ONLY valid XML tags from the list above";
-    systemPrompt += "\n2. Do NOT include any explanations, descriptions, or extra text";
-    systemPrompt += "\n3. Do NOT use bullet points or formatting - just pure XML";
-    systemPrompt += "\n4. Do NOT invent tags - only use tags from the list above";
-    systemPrompt += "\n5. Start your response directly with the XML tag (e.g., <add ...>)";
-    systemPrompt += "\n\nDouble-check: Does your response contain ONLY XML tags? If not, remove all non-XML text.";
-    prompt = systemPrompt + "\nUser: " + userPrompt + "\nOutput:";
-    if (session.debug || process.env.DIRAC_LOG_PROMPT === "1") {
-      console.error("[LLM] Full prompt sent to LLM:\n" + prompt + "\n");
-    }
-  }
-  dialogHistory.push({ role: "user", content: noExtra ? userPrompt : prompt });
+    }
+  }
+  dialogHistory.push({ role: "user", content: currentUserPrompt });
   if (session.debug) {
-    console.error(`[LLM] Calling ${model} with prompt length: ${prompt.length}`);
+    console.error(`[LLM] Calling ${model}`);
     console.error(`[LLM] Dialog history length: ${dialogHistory.length} messages`);
+    console.error(`[LLM] Has existing dialog: ${hasExistingDialog}`);
   }
   try {
     let result;
@@ -692,21 +839,21 @@ then you call it like
         messages: dialogHistory
       });
     } else {
-      const response = await session.llmClient.messages.create({
-        model,
-        max_tokens: maxTokens,
-        temperature,
-        messages: dialogHistory
-      });
-      const content = response.content[0];
-      result = content.type === "text" ? content.text : "";
+      result = await callAnthropic(session.llmClient, model, maxTokens, temperature, dialogHistory);
     }
     if (session.debug) {
       console.error(`[LLM] Response length: ${result.length}`);
+      console.error(`[LLM] Generated code:
+${result}
+`);
     }
-    if (contextVar) {
-      dialogHistory.push({ role: "assistant", content: result });
-      setVariable(session, contextVar, dialogHistory, true);
+    dialogHistory.push({ role: "assistant", content: result });
+    const varName = contextVar || (saveDialog ? "__llm_dialog__" : null);
+    if (varName) {
+      if (session.debug) {
+        console.error(`[LLM] Saving dialog history (${dialogHistory.length} messages) to: ${varName}`);
+      }
+      setVariable(session, varName, dialogHistory, true);
     }
     if (outputVar) {
       setVariable(session, outputVar, result, false);
@@ -788,18 +935,13 @@ Please fix these errors and generate valid Dirac XML again. Remember to only use
                   messages: dialogHistory
                 });
               } else {
-                const response = await session.llmClient.messages.create({
-                  model,
-                  max_tokens: maxTokens,
-                  temperature,
-                  messages: dialogHistory
-                });
-                const content = response.content[0];
-                result = content.type === "text" ? content.text : "";
+                result = await callAnthropic(session.llmClient, model, maxTokens, temperature, dialogHistory);
               }
               dialogHistory.push({ role: "assistant", content: result });
               if (contextVar) {
                 setVariable(session, contextVar, dialogHistory, true);
+              } else if (saveDialog) {
+                setVariable(session, "__llm_dialog__", dialogHistory, true);
               }
               if (session.debug) {
                 console.error(`[LLM] Retry ${retryCount} response:
@@ -832,6 +974,9 @@ ${validation.errorMessages.join("\n")}`);
             }
           }
           await integrate(session, dynamicAST);
+          if (iteration === 1) {
+            dumpGeneratedSubroutines(session, diracCode, userPrompt);
+          }
           if (feedbackMode) {
             const outputAfter = session.output.slice();
             const executionOutput = outputAfter.slice(outputBefore.length).join("");
@@ -876,18 +1021,13 @@ ${feedbackPrompt}
                 messages: dialogHistory
               });
             } else {
-              const response = await session.llmClient.messages.create({
-                model,
-                max_tokens: maxTokens,
-                temperature,
-                messages: dialogHistory
-              });
-              const content = response.content[0];
-              result = content.type === "text" ? content.text : "";
+              result = await callAnthropic(session.llmClient, model, maxTokens, temperature, dialogHistory);
             }
             dialogHistory.push({ role: "assistant", content: result });
             if (contextVar) {
               setVariable(session, contextVar, dialogHistory, true);
+            } else if (saveDialog) {
+              setVariable(session, "__llm_dialog__", dialogHistory, true);
             }
             if (session.debug) {
               console.error(`[LLM] Feedback response:
@@ -945,11 +1085,11 @@ ${expr}
     for (const v of session.variables) {
       context[v.name] = v.value;
     }
-    const { default: fs5 } = await import("fs");
-    const { default: path3 } = await import("path");
+    const { default: fs6 } = await import("fs");
+    const { default: path4 } = await import("path");
     const { fileURLToPath } = await import("url");
-    context.fs = fs5;
-    context.path = path3;
+    context.fs = fs6;
+    context.path = path4;
     context.__dirname = process.cwd();
     context.getParams = () => {
       const params = session.parameterStack[session.parameterStack.length - 1];
@@ -1003,8 +1143,8 @@ ${diracCode}
 }
 
 // src/tags/import.ts
-import { readFileSync, existsSync as existsSync2 } from "fs";
-import { resolve, dirname as dirname2, join } from "path";
+import { readFileSync, existsSync as existsSync3 } from "fs";
+import { resolve, dirname as dirname2, join as join2 } from "path";
 function resolveImportPath(src, currentDir) {
   if (src.startsWith("./") || src.startsWith("../") || src.startsWith("/")) {
     const resolved2 = resolve(currentDir, src);
@@ -1012,26 +1152,26 @@ function resolveImportPath(src, currentDir) {
   }
   let searchDir = currentDir;
   while (true) {
-    const nodeModulesPath = join(searchDir, "node_modules", src);
-    if (existsSync2(nodeModulesPath)) {
-      const packageJsonPath = join(nodeModulesPath, "package.json");
-      if (existsSync2(packageJsonPath)) {
+    const nodeModulesPath = join2(searchDir, "node_modules", src);
+    if (existsSync3(nodeModulesPath)) {
+      const packageJsonPath = join2(nodeModulesPath, "package.json");
+      if (existsSync3(packageJsonPath)) {
         try {
           const packageJson = JSON.parse(readFileSync(packageJsonPath, "utf-8"));
           const mainFile = packageJson.main || "lib/index.di";
-          const entryPath = join(nodeModulesPath, mainFile);
-          if (existsSync2(entryPath)) {
+          const entryPath = join2(nodeModulesPath, mainFile);
+          if (existsSync3(entryPath)) {
             return entryPath;
           }
         } catch (err) {
         }
       }
       const fallbacks = [
-        join(nodeModulesPath, "lib", "index.di"),
-        join(nodeModulesPath, "index.di")
+        join2(nodeModulesPath, "lib", "index.di"),
+        join2(nodeModulesPath, "index.di")
       ];
       for (const fallback of fallbacks) {
-        if (existsSync2(fallback)) {
+        if (existsSync3(fallback)) {
           return fallback;
         }
       }
@@ -1252,13 +1392,13 @@ async function executeRequireModule(session, element) {
 }
 
 // src/tags/tag-check.ts
-import fs2 from "fs";
+import fs3 from "fs";
 import yaml from "js-yaml";
 var SIMILARITY_CUTOFF = 0.75;
 function getEmbeddingServerConfig() {
   try {
     const configPath = process.env.DIRAC_CONFIG || "config.yml";
-    const config = yaml.load(fs2.readFileSync(configPath, "utf8"));
+    const config = yaml.load(fs3.readFileSync(configPath, "utf8"));
     const host = config.embeddingServer?.host || "localhost";
     const port = config.embeddingServer?.port || 11434;
     const model = config.embeddingServer?.model || "embeddinggemma";
@@ -1394,7 +1534,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-Y2BOWVF4.js");
+      const { integrate: integrate2 } = await import("./interpreter-XH3RFKVP.js");
       await integrate2(session, elementToExecute);
     }
   }
@@ -1403,7 +1543,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-Y2BOWVF4.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-XH3RFKVP.js");
   const exceptionDom = {
     tag: "exception-content",
     attributes: { name: exceptionName },
@@ -1416,7 +1556,7 @@ async function executeThrow(session, element) {
 // src/tags/try.ts
 async function executeTry(session, element) {
   setExceptionBoundary(session);
-  const { integrateChildren: integrateChildren2 } = await import("./interpreter-Y2BOWVF4.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-XH3RFKVP.js");
   await integrateChildren2(session, element);
   unsetExceptionBoundary(session);
 }
@@ -1426,7 +1566,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-Y2BOWVF4.js");
+    const { integrateChildren: integrateChildren2 } = await import("./interpreter-XH3RFKVP.js");
     await integrateChildren2(session, element);
   }
   flushCurrentException(session);
@@ -1435,7 +1575,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-Y2BOWVF4.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-XH3RFKVP.js");
   for (const exceptionDom of exceptions) {
     await integrateChildren2(session, exceptionDom);
   }
@@ -1630,23 +1770,23 @@ function formatAsText(subroutines) {
 }
 
 // src/runtime/subroutine-registry.ts
-import * as fs3 from "fs";
-import * as path2 from "path";
-import * as os from "os";
+import * as fs4 from "fs";
+import * as path3 from "path";
+import * as os2 from "os";
 var SubroutineRegistry = class {
   indexPath;
   index;
   constructor(indexPath) {
-    this.indexPath = indexPath || path2.join(os.homedir(), ".dirac", "subroutine-index.json");
+    this.indexPath = indexPath || path3.join(os2.homedir(), ".dirac", "subroutine-index.json");
     this.index = this.loadIndex();
   }
   /**
    * Load index from disk
    */
   loadIndex() {
-    if (fs3.existsSync(this.indexPath)) {
+    if (fs4.existsSync(this.indexPath)) {
       try {
-        const data = fs3.readFileSync(this.indexPath, "utf-8");
+        const data = fs4.readFileSync(this.indexPath, "utf-8");
         return JSON.parse(data);
       } catch (err) {
         console.error("Error loading subroutine index:", err);
@@ -1661,12 +1801,12 @@ var SubroutineRegistry = class {
    * Save index to disk
    */
   saveIndex() {
-    const dir = path2.dirname(this.indexPath);
-    if (!fs3.existsSync(dir)) {
-      fs3.mkdirSync(dir, { recursive: true });
+    const dir = path3.dirname(this.indexPath);
+    if (!fs4.existsSync(dir)) {
+      fs4.mkdirSync(dir, { recursive: true });
     }
     this.index.lastUpdated = Date.now();
-    fs3.writeFileSync(this.indexPath, JSON.stringify(this.index, null, 2), "utf-8");
+    fs4.writeFileSync(this.indexPath, JSON.stringify(this.index, null, 2), "utf-8");
   }
   /**
    * Scan a directory for .di files and index all subroutines
@@ -1674,9 +1814,9 @@ var SubroutineRegistry = class {
   async indexDirectory(dirPath) {
     let count = 0;
     const scanDir = (dir) => {
-      const entries = fs3.readdirSync(dir, { withFileTypes: true });
+      const entries = fs4.readdirSync(dir, { withFileTypes: true });
       for (const entry of entries) {
-        const fullPath = path2.join(dir, entry.name);
+        const fullPath = path3.join(dir, entry.name);
         if (entry.isDirectory()) {
           scanDir(fullPath);
         } else if (entry.isFile() && entry.name.endsWith(".di")) {
@@ -1693,7 +1833,7 @@ var SubroutineRegistry = class {
    */
   indexFile(filePath) {
     try {
-      const content = fs3.readFileSync(filePath, "utf-8");
+      const content = fs4.readFileSync(filePath, "utf-8");
       const parser = new DiracParser();
       const ast = parser.parse(content);
       this.index.subroutines = this.index.subroutines.filter((s) => s.filePath !== filePath);
@@ -1898,7 +2038,7 @@ async function executeLoadContext(session, element) {
     query = element.text.trim();
   }
   if (!query && element.children.length > 0) {
-    const { integrate: integrate2 } = await import("./interpreter-Y2BOWVF4.js");
+    const { integrate: integrate2 } = await import("./interpreter-XH3RFKVP.js");
     const beforeOutput = session.output.length;
     for (const child of element.children) {
       await integrate2(session, child);
@@ -1973,18 +2113,17 @@ async function executeLoadContext(session, element) {
 }
 
 // src/tags/save-subroutine.ts
-import { writeFileSync as writeFileSync2, mkdirSync as mkdirSync3 } from "fs";
-import { resolve as resolve2, dirname as dirname4 } from "path";
+import { writeFileSync as writeFileSync3, mkdirSync as mkdirSync4, existsSync as existsSync5 } from "fs";
+import { resolve as resolve2, dirname as dirname4, join as join4 } from "path";
+import { homedir as homedir3 } from "os";
 async function executeSaveSubroutine(session, element) {
   const name = element.attributes.name;
   const file = element.attributes.file;
+  const pathAttr = element.attributes.path;
   const format = element.attributes.format || "xml";
   if (!name) {
     throw new Error("<save-subroutine> requires name attribute");
   }
-  if (!file) {
-    throw new Error("<save-subroutine> requires file attribute");
-  }
   let subroutine = void 0;
   for (let i = session.subroutines.length - 1; i >= 0; i--) {
     if (session.subroutines[i].name === name) {
@@ -2001,12 +2140,27 @@ async function executeSaveSubroutine(session, element) {
   } else {
     content = generateXMLNotation(subroutine);
   }
-  const filePath = resolve2(process.cwd(), file);
+  let filePath;
+  if (file) {
+    filePath = resolve2(process.cwd(), file);
+  } else if (pathAttr) {
+    const targetDir = join4(homedir3(), ".dirac", "lib", pathAttr);
+    filePath = join4(targetDir, `${name}.di`);
+  } else {
+    const timestamp = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-").slice(0, -5);
+    const defaultDir = join4(homedir3(), ".dirac", "lib", timestamp);
+    filePath = join4(defaultDir, `${name}.di`);
+  }
   const dir = dirname4(filePath);
-  mkdirSync3(dir, { recursive: true });
-  writeFileSync2(filePath, content, "utf-8");
+  if (!existsSync5(dir)) {
+    mkdirSync4(dir, { recursive: true });
+  }
+  writeFileSync3(filePath, content, "utf-8");
   emit(session, `Subroutine '${name}' saved to: ${filePath}
 `);
+  if (session.debug) {
+    console.error(`[save-subroutine] Saved '${name}' to: ${filePath}`);
+  }
 }
 function generateXMLNotation(subroutine) {
   let xml = "<!-- Exported subroutine -->\n\n";
@@ -2137,7 +2291,7 @@ async function executeForeach(session, element) {
     const parser2 = new DiracParser2();
     try {
       const fromElement = parser2.parse(fromAttr);
-      const { integrate: integrate2 } = await import("./interpreter-Y2BOWVF4.js");
+      const { integrate: integrate2 } = await import("./interpreter-XH3RFKVP.js");
       await integrate2(session, fromElement);
     } catch (e) {
       session.output = savedOutput;
@@ -2285,7 +2439,7 @@ async function executeEnvironment(session, element) {
 }
 
 // src/tags/input.ts
-import * as fs4 from "fs";
+import * as fs5 from "fs";
 import * as readline from "readline";
 var fileReaders = /* @__PURE__ */ new Map();
 var fileIterators = /* @__PURE__ */ new Map();
@@ -2309,11 +2463,11 @@ async function executeInput(session, element) {
       throw new Error(`<input> invalid mode: ${mode}. Use 'all' or 'line'`);
     }
   } else if (source === "file") {
-    const path3 = substituteAttribute(session, pathAttr);
+    const path4 = substituteAttribute(session, pathAttr);
     if (mode === "all") {
-      value = fs4.readFileSync(path3, "utf-8");
+      value = fs5.readFileSync(path4, "utf-8");
     } else if (mode === "line") {
-      value = await readLineFromFile(path3);
+      value = await readLineFromFile(path4);
     } else {
       throw new Error(`<input> invalid mode: ${mode}. Use 'all' or 'line'`);
     }
@@ -2370,23 +2524,23 @@ async function readLineStdin() {
   }
   return result.value;
 }
-async function readLineFromFile(path3) {
-  if (!fileReaders.has(path3)) {
-    const fileStream = fs4.createReadStream(path3);
+async function readLineFromFile(path4) {
+  if (!fileReaders.has(path4)) {
+    const fileStream = fs5.createReadStream(path4);
     const rl = readline.createInterface({
       input: fileStream,
       crlfDelay: Infinity
     });
-    fileReaders.set(path3, rl);
-    fileIterators.set(path3, rl[Symbol.asyncIterator]());
+    fileReaders.set(path4, rl);
+    fileIterators.set(path4, rl[Symbol.asyncIterator]());
   }
-  const iterator = fileIterators.get(path3);
+  const iterator = fileIterators.get(path4);
   const result = await iterator.next();
   if (result.done) {
-    const reader = fileReaders.get(path3);
+    const reader = fileReaders.get(path4);
     reader.close();
-    fileReaders.delete(path3);
-    fileIterators.delete(path3);
+    fileReaders.delete(path4);
+    fileIterators.delete(path4);
     return "";
   }
   return result.value;

package/dist/cli.js

@@ -4,8 +4,8 @@ import {
 } from "./chunk-UEFKQRYN.js";
 import {
   execute
-} from "./chunk-2SNN7MBU.js";
-import "./chunk-4ROK7OUQ.js";
+} from "./chunk-TISVDOGD.js";
+import "./chunk-TXL3RV74.js";
 import "./chunk-HRHAMPOB.js";
 import "./chunk-4QLTSCDG.js";
 import "./chunk-GLXVY235.js";
@@ -16,7 +16,7 @@ import "dotenv/config";
 // package.json
 var package_default = {
   name: "dirac-lang",
-  version: "0.1.44",
+  version: "0.1.46",
   description: "LLM-Augmented Declarative Execution",
   type: "module",
   main: "dist/index.js",
@@ -96,7 +96,7 @@ async function main() {
     process.exit(0);
   }
   if (args[0] === "shell") {
-    const { DiracShell } = await import("./shell-3ZZUMKP3.js");
+    const { DiracShell } = await import("./shell-LGNPK4GO.js");
     const shellConfig = { debug: false };
     for (let i = 1; i < args.length; i++) {
       const arg = args[i];
@@ -142,6 +142,9 @@ async function main() {
   let filePath;
   let emitXml = false;
   let configFile;
+  if (process.env.DEBUG === "1") {
+    config.debug = true;
+  }
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
     if (arg === "--debug") {

package/dist/index.js

@@ -2,10 +2,10 @@ import {
   createLLMAdapter,
   execute,
   executeUserCommand
-} from "./chunk-2SNN7MBU.js";
+} from "./chunk-TISVDOGD.js";
 import {
   integrate
-} from "./chunk-4ROK7OUQ.js";
+} from "./chunk-TXL3RV74.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";

package/dist/{interpreter-Y2BOWVF4.js → interpreter-XH3RFKVP.js}

@@ -1,7 +1,7 @@
 import {
   integrate,
   integrateChildren
-} from "./chunk-4ROK7OUQ.js";
+} from "./chunk-TXL3RV74.js";
 import "./chunk-HRHAMPOB.js";
 import "./chunk-4QLTSCDG.js";
 import "./chunk-GLXVY235.js";

package/dist/{schedule-DZ2SPHSX.js → schedule-5HZCREEP.js}

@@ -3,7 +3,7 @@ import {
   listScheduledTasks,
   stopAllScheduledTasks,
   stopScheduledTask
-} from "./chunk-4ROK7OUQ.js";
+} from "./chunk-TXL3RV74.js";
 import "./chunk-HRHAMPOB.js";
 import "./chunk-4QLTSCDG.js";
 import "./chunk-GLXVY235.js";

package/dist/{shell-3ZZUMKP3.js → shell-LGNPK4GO.js}

@@ -4,7 +4,7 @@ import {
 } from "./chunk-UEFKQRYN.js";
 import {
   integrate
-} from "./chunk-4ROK7OUQ.js";
+} from "./chunk-TXL3RV74.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";
@@ -66,7 +66,7 @@ var DiracShell = class {
     });
     this.rl.on("close", () => {
       this.saveHistory();
-      import("./schedule-DZ2SPHSX.js").then(({ stopAllScheduledTasks }) => {
+      import("./schedule-5HZCREEP.js").then(({ stopAllScheduledTasks }) => {
         stopAllScheduledTasks();
         console.log("\nGoodbye!");
         process.exit(0);
@@ -195,7 +195,7 @@ Commands:
   :index <path>   Index subroutines from directory
   :search <query> Search indexed subroutines
   :load <query>   Load context (search and import subroutines)
-  :save <name> <file>  Save subroutine to file
+  :save <name> [file]  Save subroutine (default: ~/.dirac/lib/TIMESTAMP/name.di)
   :stats          Show registry statistics
   :tasks          List all scheduled tasks
   :stop <name>    Stop a scheduled task
@@ -335,13 +335,27 @@ Examples:
         }
         break;
       case "save":
-        if (args.length < 2) {
-          console.log("Usage: :save <subroutine-name> <file>");
+        if (args.length === 0) {
+          console.log("Usage: :save <subroutine-name> [file]");
+          console.log("  If file is omitted, saves to ~/.dirac/lib/TIMESTAMP/NAME.di");
+          console.log("Examples:");
+          console.log("  :save greet                    # saves to ~/.dirac/lib/TIMESTAMP/greet.di");
+          console.log("  :save greet ./my-lib/greet.di  # saves to specific file");
+          console.log("  :save greet utils              # saves to ~/.dirac/lib/utils/greet.di");
         } else {
           const subName = args[0];
-          const fileName = args[1];
+          const fileName = args.length > 1 ? args[1] : void 0;
           try {
-            const xml = `<save-subroutine name="${subName}" file="${fileName}" format="xml" />`;
+            let xml;
+            if (fileName) {
+              if (fileName.includes("/") || fileName.includes(".di")) {
+                xml = `<save-subroutine name="${subName}" file="${fileName}" format="xml" />`;
+              } else {
+                xml = `<save-subroutine name="${subName}" path="${fileName}" format="xml" />`;
+              }
+            } else {
+              xml = `<save-subroutine name="${subName}" format="xml" />`;
+            }
             const ast = this.xmlParser.parse(xml);
             await integrate(this.session, ast);
             if (this.session.output.length > 0) {
@@ -366,7 +380,7 @@ Examples:
         break;
       case "tasks":
         try {
-          const { listScheduledTasks } = await import("./schedule-DZ2SPHSX.js");
+          const { listScheduledTasks } = await import("./schedule-5HZCREEP.js");
           const tasks = listScheduledTasks();
           if (tasks.length === 0) {
             console.log("No scheduled tasks running.");
@@ -385,7 +399,7 @@ Examples:
           console.log("Usage: :stop <task-name>");
         } else {
           try {
-            const { stopScheduledTask } = await import("./schedule-DZ2SPHSX.js");
+            const { stopScheduledTask } = await import("./schedule-5HZCREEP.js");
             const taskName = args[0];
             const stopped = stopScheduledTask(taskName);
             if (stopped) {
@@ -400,7 +414,7 @@ Examples:
         break;
       case "stopall":
         try {
-          const { stopAllScheduledTasks } = await import("./schedule-DZ2SPHSX.js");
+          const { stopAllScheduledTasks } = await import("./schedule-5HZCREEP.js");
           stopAllScheduledTasks();
           console.log("All scheduled tasks stopped.");
         } catch (error) {

package/dist/test-runner.js

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

package/package.json

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