dirac-lang 0.1.54 → 0.1.56

package/dist/{chunk-C6DBZRQZ.js → chunk-AJSYOXXZ.js}

@@ -73,6 +73,9 @@ var BraKetParser = class {
     if (!content.trim()) {
       return { indent, type: "empty", raw };
     }
+    if (content.startsWith("#")) {
+      return { indent, type: "empty", raw };
+    }
     if (content.startsWith("<") && content.endsWith("|")) {
       const tagMatch = content.match(/^<([a-zA-Z_][a-zA-Z0-9_-]*)\s*/);
       if (tagMatch) {

package/dist/{chunk-A4SFB5W4.js → chunk-IN55WRFB.js}

@@ -315,6 +315,8 @@ function getCurrentExceptions(session) {
 }
 
 export {
+  OllamaProvider,
+  CustomLLMProvider,
   substituteAttribute,
   createSession,
   setVariable,

package/dist/{chunk-QZGTAT3E.js → chunk-M43Y5X5P.js}

@@ -3,8 +3,10 @@ import {
 } from "./chunk-HRHAMPOB.js";
 import {
   executeSubroutine
-} from "./chunk-ZY37RS4P.js";
+} from "./chunk-WX7VHQYL.js";
 import {
+  CustomLLMProvider,
+  OllamaProvider,
   cleanSubroutinesToBoundary,
   cleanToBoundary,
   emit,
@@ -26,7 +28,7 @@ import {
   substituteVariables,
   throwException,
   unsetExceptionBoundary
-} from "./chunk-A4SFB5W4.js";
+} from "./chunk-IN55WRFB.js";
 
 // src/tags/parameters.ts
 async function executeParameters(session, element) {
@@ -282,7 +284,7 @@ async function executeCall(session, element) {
   }
 }
 async function registerExtendChain(session, subroutine, currentName) {
-  const { executeSubroutine: executeSubroutine2 } = await import("./subroutine-VIACWZPF.js");
+  const { executeSubroutine: executeSubroutine2 } = await import("./subroutine-RBTBNR2T.js");
   const extendsAttr = subroutine.attributes.extends;
   let parentName;
   if (extendsAttr) {
@@ -472,12 +474,12 @@ async function executeIf(session, element) {
   const condition = await evaluatePredicate(session, conditionElement);
   if (condition) {
     if (thenElement) {
-      const { integrateChildren: integrateChildren2 } = await import("./interpreter-I4SRKXYK.js");
+      const { integrateChildren: integrateChildren2 } = await import("./interpreter-RV7UVTYE.js");
       await integrateChildren2(session, thenElement);
     }
   } else {
     if (elseElement) {
-      const { integrateChildren: integrateChildren2 } = await import("./interpreter-I4SRKXYK.js");
+      const { integrateChildren: integrateChildren2 } = await import("./interpreter-RV7UVTYE.js");
       await integrateChildren2(session, elseElement);
     }
   }
@@ -490,7 +492,7 @@ async function evaluatePredicate(session, predicateElement) {
     return await evaluateCondition(session, predicateElement);
   }
   const outputLengthBefore = session.output.length;
-  const { integrate: integrate2 } = await import("./interpreter-I4SRKXYK.js");
+  const { integrate: integrate2 } = await import("./interpreter-RV7UVTYE.js");
   await integrate2(session, predicateElement);
   const newOutputChunks = session.output.slice(outputLengthBefore);
   const result = newOutputChunks.join("").trim();
@@ -513,11 +515,11 @@ async function evaluateCondition(session, condElement) {
   }
   const outputLengthBefore = session.output.length;
   const args = [];
-  const { integrate: integrate2 } = await import("./interpreter-I4SRKXYK.js");
+  const { integrate: integrate2 } = await import("./interpreter-RV7UVTYE.js");
   for (const child of condElement.children) {
     if (child.tag.toLowerCase() === "arg") {
       const argOutputStart = session.output.length;
-      const { integrateChildren: integrateChildren2 } = await import("./interpreter-I4SRKXYK.js");
+      const { integrateChildren: integrateChildren2 } = await import("./interpreter-RV7UVTYE.js");
       await integrateChildren2(session, child);
       const newChunks = session.output.slice(argOutputStart);
       const argValue = newChunks.join("");
@@ -576,9 +578,31 @@ function evaluateConditionType(evalType, args) {
 }
 
 // src/tags/llm.ts
+import Anthropic from "@anthropic-ai/sdk";
+import OpenAI from "openai";
 import * as fs2 from "fs";
 import * as path2 from "path";
 import * as os from "os";
+function createLLMClient(provider, model) {
+  const anthropicKey = process.env.ANTHROPIC_API_KEY;
+  const openaiKey = process.env.OPENAI_API_KEY;
+  const ollamaModel = model || process.env.LLM_MODEL || "llama2";
+  const customBaseUrl = process.env.CUSTOM_LLM_URL || "http://localhost:5001";
+  switch (provider) {
+    case "ollama":
+      return new OllamaProvider({ model: ollamaModel });
+    case "anthropic":
+      if (!anthropicKey) throw new Error("ANTHROPIC_API_KEY required for Anthropic provider");
+      return new Anthropic({ apiKey: anthropicKey });
+    case "openai":
+      if (!openaiKey) throw new Error("OPENAI_API_KEY required for OpenAI provider");
+      return new OpenAI({ apiKey: openaiKey });
+    case "custom":
+      return new CustomLLMProvider({ baseUrl: customBaseUrl, model: ollamaModel });
+    default:
+      throw new Error(`Unknown LLM provider: ${provider}. Use 'ollama', 'anthropic', 'openai', or 'custom'.`);
+  }
+}
 function dumpGeneratedSubroutines(session, diracCode, userPrompt) {
   try {
     let findSubroutines2 = function(element) {
@@ -687,7 +711,19 @@ async function executeLLM(session, element) {
     throw new Error("Maximum LLM calls exceeded");
   }
   session.limits.currentLLMCalls++;
-  const providerName = session.llmClient.constructor.name;
+  const requestedProvider = element.attributes.provider;
+  let llmClient = session.llmClient;
+  if (requestedProvider) {
+    const requestedModel = element.attributes.model || process.env.DEFAULT_MODEL;
+    llmClient = createLLMClient(requestedProvider, requestedModel);
+    if (session.debug) {
+      console.error(`[LLM] Switching to provider: ${requestedProvider}`);
+    }
+  }
+  if (!llmClient) {
+    throw new Error("No LLM provider configured. Set provider attribute or configure session with LLM_PROVIDER.");
+  }
+  const providerName = llmClient.constructor.name;
   const isOpenAI = providerName === "OpenAI";
   const isOllama = providerName === "OllamaProvider";
   const isCustom = providerName === "CustomLLMProvider";
@@ -729,15 +765,26 @@ async function executeLLM(session, element) {
       dialogHistory = [...existing];
       hasExistingDialog = dialogHistory.length > 0;
     } else if (existing) {
-      dialogHistory = [{ role: "system", content: String(existing) }];
-      hasExistingDialog = true;
+      try {
+        const parsed = JSON.parse(String(existing));
+        if (Array.isArray(parsed)) {
+          dialogHistory = parsed;
+          hasExistingDialog = dialogHistory.length > 0;
+        } else {
+          dialogHistory = [{ role: "system", content: String(existing) }];
+          hasExistingDialog = true;
+        }
+      } catch {
+        dialogHistory = [{ role: "system", content: String(existing) }];
+        hasExistingDialog = true;
+      }
     }
   }
   const noExtra = element.attributes.noextra === "true";
   let systemPrompt = "";
   let currentUserPrompt = userPrompt;
   if (!noExtra) {
-    const { getAvailableSubroutines: getAvailableSubroutines2 } = await import("./session-5PEIMBGV.js");
+    const { getAvailableSubroutines: getAvailableSubroutines2 } = await import("./session-MRU57VMJ.js");
     const subroutines = getAvailableSubroutines2(session);
     if (session.debug) {
       console.error(
@@ -828,7 +875,7 @@ CRITICAL: When defining parameters:
   try {
     let result;
     if (isOpenAI) {
-      const response = await session.llmClient.chat.completions.create({
+      const response = await llmClient.chat.completions.create({
         model,
         max_tokens: maxTokens,
         temperature,
@@ -837,21 +884,21 @@ CRITICAL: When defining parameters:
       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 session.llmClient.complete(ollamaPrompt, {
+      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 session.llmClient.complete(customPrompt, {
+      result = await llmClient.complete(customPrompt, {
         model,
         temperature,
         max_tokens: maxTokens,
         messages: dialogHistory
       });
     } else {
-      result = await callAnthropic(session.llmClient, model, maxTokens, temperature, dialogHistory);
+      result = await callAnthropic(llmClient, model, maxTokens, temperature, dialogHistory);
     }
     if (session.debug) {
       console.error(`[LLM] Response length: ${result.length}`);
@@ -865,7 +912,7 @@ ${result}
       if (session.debug) {
         console.error(`[LLM] Saving dialog history (${dialogHistory.length} messages) to: ${varName}`);
       }
-      setVariable(session, varName, dialogHistory, true);
+      setVariable(session, varName, JSON.stringify(dialogHistory), true);
     }
     if (outputVar) {
       setVariable(session, outputVar, result, false);
@@ -909,7 +956,7 @@ ${result}
           const parser = new DiracParser();
           let dynamicAST = parser.parse(diracCode);
           if (validateTags) {
-            const { validateDiracCode, applyCorrectedTags } = await import("./tag-validator-AZXYIKQV.js");
+            const { validateDiracCode, applyCorrectedTags } = await import("./tag-validator-BTBNFPJD.js");
             let validation = await validateDiracCode(session, dynamicAST, { autocorrect });
             let retryCount = 0;
             while (!validation.valid && retryCount < maxRetries) {
@@ -924,7 +971,7 @@ ${errorFeedback}
 Please fix these errors and generate valid Dirac XML again. Remember to only use the allowed tags.`;
               dialogHistory.push({ role: "user", content: retryPrompt });
               if (isOpenAI) {
-                const response = await session.llmClient.chat.completions.create({
+                const response = await llmClient.chat.completions.create({
                   model,
                   max_tokens: maxTokens,
                   temperature,
@@ -933,21 +980,21 @@ Please fix these errors and generate valid Dirac XML again. Remember to only use
                 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 session.llmClient.complete(ollamaPrompt, {
+                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 session.llmClient.complete(customPrompt, {
+                result = await llmClient.complete(customPrompt, {
                   model,
                   temperature,
                   max_tokens: maxTokens,
                   messages: dialogHistory
                 });
               } else {
-                result = await callAnthropic(session.llmClient, model, maxTokens, temperature, dialogHistory);
+                result = await callAnthropic(llmClient, model, maxTokens, temperature, dialogHistory);
               }
               dialogHistory.push({ role: "assistant", content: result });
               if (contextVar) {
@@ -1010,7 +1057,7 @@ ${feedbackPrompt}
             }
             dialogHistory.push({ role: "user", content: feedbackPrompt });
             if (isOpenAI) {
-              const response = await session.llmClient.chat.completions.create({
+              const response = await llmClient.chat.completions.create({
                 model,
                 max_tokens: maxTokens,
                 temperature,
@@ -1019,21 +1066,21 @@ ${feedbackPrompt}
               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 session.llmClient.complete(ollamaPrompt, {
+              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 session.llmClient.complete(customPrompt, {
+              result = await llmClient.complete(customPrompt, {
                 model,
                 temperature,
                 max_tokens: maxTokens,
                 messages: dialogHistory
               });
             } else {
-              result = await callAnthropic(session.llmClient, model, maxTokens, temperature, dialogHistory);
+              result = await callAnthropic(llmClient, model, maxTokens, temperature, dialogHistory);
             }
             dialogHistory.push({ role: "assistant", content: result });
             if (contextVar) {
@@ -1520,7 +1567,7 @@ async function getBestTagMatch(candidate, allowed) {
   return { tag: allowed[bestIdx], score: bestScore };
 }
 async function executeTagCheck(session, element) {
-  const { getAvailableSubroutines: getAvailableSubroutines2 } = await import("./session-5PEIMBGV.js");
+  const { getAvailableSubroutines: getAvailableSubroutines2 } = await import("./session-MRU57VMJ.js");
   const subroutines = getAvailableSubroutines2(session);
   const allowed = new Set(subroutines.map((s) => s.name));
   console.error("[tag-check] Allowed subroutines:", Array.from(allowed));
@@ -1613,7 +1660,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-I4SRKXYK.js");
+      const { integrate: integrate2 } = await import("./interpreter-RV7UVTYE.js");
       await integrate2(session, elementToExecute);
     }
   }
@@ -1622,7 +1669,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-I4SRKXYK.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-RV7UVTYE.js");
   const exceptionDom = {
     tag: "exception-content",
     attributes: { name: exceptionName },
@@ -1635,7 +1682,7 @@ async function executeThrow(session, element) {
 // src/tags/try.ts
 async function executeTry(session, element) {
   setExceptionBoundary(session);
-  const { integrateChildren: integrateChildren2 } = await import("./interpreter-I4SRKXYK.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-RV7UVTYE.js");
   await integrateChildren2(session, element);
   unsetExceptionBoundary(session);
 }
@@ -1645,7 +1692,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-I4SRKXYK.js");
+    const { integrateChildren: integrateChildren2 } = await import("./interpreter-RV7UVTYE.js");
     await integrateChildren2(session, element);
   }
   flushCurrentException(session);
@@ -1654,7 +1701,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-I4SRKXYK.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-RV7UVTYE.js");
   for (const exceptionDom of exceptions) {
     await integrateChildren2(session, exceptionDom);
   }
@@ -2122,7 +2169,7 @@ async function executeLoadContext(session, element) {
     query = element.text.trim();
   }
   if (!query && element.children.length > 0) {
-    const { integrate: integrate2 } = await import("./interpreter-I4SRKXYK.js");
+    const { integrate: integrate2 } = await import("./interpreter-RV7UVTYE.js");
     const beforeOutput = session.output.length;
     for (const child of element.children) {
       await integrate2(session, child);
@@ -2191,7 +2238,7 @@ async function executeLoadContext(session, element) {
       parameters: s.parameters.map((p) => p.name),
       filePath: s.filePath
     }));
-    const { setVariable: setVariable2 } = await import("./session-5PEIMBGV.js");
+    const { setVariable: setVariable2 } = await import("./session-MRU57VMJ.js");
     setVariable2(session, outputVar, JSON.stringify(summary, null, 2), false);
   }
 }
@@ -2375,7 +2422,7 @@ async function executeForeach(session, element) {
     const parser2 = new DiracParser2();
     try {
       const fromElement = parser2.parse(fromAttr);
-      const { integrate: integrate2 } = await import("./interpreter-I4SRKXYK.js");
+      const { integrate: integrate2 } = await import("./interpreter-RV7UVTYE.js");
       await integrate2(session, fromElement);
     } catch (e) {
       session.output = savedOutput;

package/dist/{chunk-EXP3R5ZJ.js → chunk-NK2ZTQGT.js}

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

package/dist/{chunk-ZY37RS4P.js → chunk-WX7VHQYL.js}

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

package/dist/cli.js

@@ -1,14 +1,14 @@
 #!/usr/bin/env node
 import {
   BraKetParser
-} from "./chunk-C6DBZRQZ.js";
+} from "./chunk-AJSYOXXZ.js";
 import {
   execute
-} from "./chunk-EXP3R5ZJ.js";
-import "./chunk-QZGTAT3E.js";
+} from "./chunk-NK2ZTQGT.js";
+import "./chunk-M43Y5X5P.js";
 import "./chunk-HRHAMPOB.js";
-import "./chunk-ZY37RS4P.js";
-import "./chunk-A4SFB5W4.js";
+import "./chunk-WX7VHQYL.js";
+import "./chunk-IN55WRFB.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.53",
+  version: "0.1.56",
   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-XIJKOMBE.js");
+    const { DiracShell } = await import("./shell-WMXFN2EX.js");
     const shellConfig = { debug: false };
     for (let i = 1; i < args.length; i++) {
       const arg = args[i];

package/dist/index.js

@@ -2,19 +2,19 @@ import {
   createLLMAdapter,
   execute,
   executeUserCommand
-} from "./chunk-EXP3R5ZJ.js";
+} from "./chunk-NK2ZTQGT.js";
 import {
   integrate
-} from "./chunk-QZGTAT3E.js";
+} from "./chunk-M43Y5X5P.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";
-import "./chunk-ZY37RS4P.js";
+import "./chunk-WX7VHQYL.js";
 import {
   createSession,
   getAvailableSubroutines,
   getOutput
-} from "./chunk-A4SFB5W4.js";
+} from "./chunk-IN55WRFB.js";
 export {
   DiracParser,
   createLLMAdapter,

package/dist/{interpreter-I4SRKXYK.js → interpreter-RV7UVTYE.js}

@@ -1,10 +1,10 @@
 import {
   integrate,
   integrateChildren
-} from "./chunk-QZGTAT3E.js";
+} from "./chunk-M43Y5X5P.js";
 import "./chunk-HRHAMPOB.js";
-import "./chunk-ZY37RS4P.js";
-import "./chunk-A4SFB5W4.js";
+import "./chunk-WX7VHQYL.js";
+import "./chunk-IN55WRFB.js";
 export {
   integrate,
   integrateChildren

package/dist/{schedule-7ZFCWNEF.js → schedule-2LAUKHZX.js}

@@ -3,10 +3,10 @@ import {
   listScheduledTasks,
   stopAllScheduledTasks,
   stopScheduledTask
-} from "./chunk-QZGTAT3E.js";
+} from "./chunk-M43Y5X5P.js";
 import "./chunk-HRHAMPOB.js";
-import "./chunk-ZY37RS4P.js";
-import "./chunk-A4SFB5W4.js";
+import "./chunk-WX7VHQYL.js";
+import "./chunk-IN55WRFB.js";
 export {
   executeSchedule,
   listScheduledTasks,

package/dist/{session-5PEIMBGV.js → session-MRU57VMJ.js}

@@ -26,7 +26,7 @@ import {
   substituteVariables,
   throwException,
   unsetExceptionBoundary
-} from "./chunk-A4SFB5W4.js";
+} from "./chunk-IN55WRFB.js";
 export {
   cleanSubroutinesToBoundary,
   cleanToBoundary,

package/dist/{shell-XIJKOMBE.js → shell-WMXFN2EX.js}

@@ -1,17 +1,17 @@
 #!/usr/bin/env node
 import {
   BraKetParser
-} from "./chunk-C6DBZRQZ.js";
+} from "./chunk-AJSYOXXZ.js";
 import {
   integrate
-} from "./chunk-QZGTAT3E.js";
+} from "./chunk-M43Y5X5P.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";
-import "./chunk-ZY37RS4P.js";
+import "./chunk-WX7VHQYL.js";
 import {
   createSession
-} from "./chunk-A4SFB5W4.js";
+} from "./chunk-IN55WRFB.js";
 
 // src/shell.ts
 import * as readline from "readline";
@@ -52,11 +52,23 @@ var DiracShell = class {
       const attrPartial = attrMatch[2];
       const subroutine = this.session.subroutines.find((sub) => sub.name === tagName);
       if (subroutine && subroutine.parameters && subroutine.parameters.length > 0) {
-        const paramNames = subroutine.parameters.map((p) => p.name);
-        const matches = paramNames.filter(
-          (name) => name.toLowerCase().startsWith(attrPartial.toLowerCase())
+        const matches = subroutine.parameters.filter(
+          (p) => p.name.toLowerCase().startsWith(attrPartial.toLowerCase())
         );
-        const completions = matches.map((name) => `${name}=`);
+        if (matches.length > 1) {
+          console.log("\n");
+          matches.forEach((p) => {
+            const parts = [];
+            if (p.type) parts.push(p.type);
+            if (p.required) parts.push("required");
+            if (p.description) parts.push(p.description);
+            if (p.options && p.options.length > 0) parts.push(`[${p.options.join(",")}]`);
+            if (p.examples && p.examples.length > 0) parts.push(`eg:${p.examples[0]}`);
+            const info = parts.length > 0 ? ` (${parts.join(" | ")})` : "";
+            console.log(`  ${p.name}=${info}`);
+          });
+        }
+        const completions = matches.map((p) => `${p.name}=`);
         return [completions, attrPartial];
       }
     }
@@ -65,11 +77,18 @@ var DiracShell = class {
       const tagName = tagCompleteMatch[1];
       const subroutine = this.session.subroutines.find((sub) => sub.name === tagName);
       if (subroutine && subroutine.parameters && subroutine.parameters.length > 0) {
-        const paramSuggestions = subroutine.parameters.map((p) => {
-          const required = p.required ? "*" : "";
-          const typeInfo = p.type || "string";
-          return `${p.name}=${required}${typeInfo}`;
+        console.log("\n");
+        subroutine.parameters.forEach((p) => {
+          const parts = [];
+          if (p.type) parts.push(p.type);
+          if (p.required) parts.push("required");
+          if (p.description) parts.push(p.description);
+          if (p.options && p.options.length > 0) parts.push(`[${p.options.join(",")}]`);
+          if (p.examples && p.examples.length > 0) parts.push(`eg:${p.examples[0]}`);
+          const info = parts.length > 0 ? ` (${parts.join(" | ")})` : "";
+          console.log(`  ${p.name}=${info}`);
         });
+        const paramSuggestions = subroutine.parameters.map((p) => `${p.name}=`);
         return [paramSuggestions, ""];
       }
       const subroutineNames = this.session.subroutines.map((sub) => sub.name);
@@ -131,7 +150,7 @@ var DiracShell = class {
     });
     this.rl.on("close", () => {
       this.saveHistory();
-      import("./schedule-7ZFCWNEF.js").then(({ stopAllScheduledTasks }) => {
+      import("./schedule-2LAUKHZX.js").then(({ stopAllScheduledTasks }) => {
         stopAllScheduledTasks();
         console.log("\nGoodbye!");
         process.exit(0);
@@ -452,7 +471,7 @@ Examples:
         break;
       case "tasks":
         try {
-          const { listScheduledTasks } = await import("./schedule-7ZFCWNEF.js");
+          const { listScheduledTasks } = await import("./schedule-2LAUKHZX.js");
           const tasks = listScheduledTasks();
           if (tasks.length === 0) {
             console.log("No scheduled tasks running.");
@@ -471,7 +490,7 @@ Examples:
           console.log("Usage: :stop <task-name>");
         } else {
           try {
-            const { stopScheduledTask } = await import("./schedule-7ZFCWNEF.js");
+            const { stopScheduledTask } = await import("./schedule-2LAUKHZX.js");
             const taskName = args[0];
             const stopped = stopScheduledTask(taskName);
             if (stopped) {
@@ -486,7 +505,7 @@ Examples:
         break;
       case "stopall":
         try {
-          const { stopAllScheduledTasks } = await import("./schedule-7ZFCWNEF.js");
+          const { stopAllScheduledTasks } = await import("./schedule-2LAUKHZX.js");
           stopAllScheduledTasks();
           console.log("All scheduled tasks stopped.");
         } catch (error) {

package/dist/{subroutine-VIACWZPF.js → subroutine-RBTBNR2T.js}

@@ -1,7 +1,7 @@
 import {
   executeSubroutine
-} from "./chunk-ZY37RS4P.js";
-import "./chunk-A4SFB5W4.js";
+} from "./chunk-WX7VHQYL.js";
+import "./chunk-IN55WRFB.js";
 export {
   executeSubroutine
 };

package/dist/{tag-validator-AZXYIKQV.js → tag-validator-BTBNFPJD.js}

@@ -49,7 +49,7 @@ async function getBestTagMatch(candidate, allowed) {
 }
 async function validateTag(session, element, options = {}) {
   const { autocorrect = false, similarityCutoff = SIMILARITY_CUTOFF } = options;
-  const { getAvailableSubroutines } = await import("./session-5PEIMBGV.js");
+  const { getAvailableSubroutines } = await import("./session-MRU57VMJ.js");
   const subroutines = getAvailableSubroutines(session);
   const allowed = new Set(subroutines.map((s) => s.name));
   const tagName = element.tag;

package/dist/test-runner.js

@@ -1,14 +1,14 @@
 import {
   integrate
-} from "./chunk-QZGTAT3E.js";
+} from "./chunk-M43Y5X5P.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";
-import "./chunk-ZY37RS4P.js";
+import "./chunk-WX7VHQYL.js";
 import {
   createSession,
   getOutput
-} from "./chunk-A4SFB5W4.js";
+} from "./chunk-IN55WRFB.js";
 
 // src/test-runner.ts
 import fs from "fs";

package/package.json

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