dirac-lang 0.1.32 → 0.1.34

package/README.md

@@ -255,3 +255,31 @@ npm install -g dirac-lang
 ---
 
 *"In the quantum realm, a bra meets a ket to produce reality. In Dirac, a declaration meets an LLM to produce execution."*
+
+## PAUL: The Human-Friendly Dirac Dialect
+
+Dirac’s XML-based language is designed for robust machine execution and symbolic reasoning. For human authors, we introduce **PAUL** (Programming AI Utility Language)—a concise, bra/ket-inspired notation for writing Dirac programs quickly and intuitively.
+
+- PAUL uses bra/ket syntax and positional arguments for readability.
+- It is ideal for human editing, rapid prototyping, and LLM prompts.
+- PAUL scripts are typically saved with the `.bk` extension.
+- The Dirac interpreter translates PAUL to XML Dirac for execution.
+
+**Example:**
+
+PAUL (.bk):
+```
+|greet Alice>
+```
+
+Dirac XML (.di):
+```xml
+<greet name="Alice" />
+```
+
+**Note:**
+- PAUL relies on conventions for mapping positional arguments to named parameters.
+- For machine execution, always convert PAUL to XML Dirac.
+- The `.bk` extension is recommended for PAUL scripts.
+
+PAUL is the human-centric dialect of Dirac—optimized for clarity, speed, and LLM interaction.

package/dist/{chunk-UYDP4ZFS.js → chunk-4LLFMVOW.js}

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

package/dist/{chunk-JMUUPZZA.js → chunk-4QLTSCDG.js}

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

package/dist/chunk-DRPHX3WX.js

@@ -0,0 +1,166 @@
+// src/runtime/braket-parser.ts
+var BraKetParser = class {
+  lines = [];
+  currentLine = 0;
+  /**
+   * Parse bra-ket notation and compile to XML
+   */
+  parse(source) {
+    this.lines = source.split("\n");
+    this.currentLine = 0;
+    const xml = ["<dirac>"];
+    this.parseBlock(xml, -1);
+    xml.push("</dirac>");
+    return xml.join("\n");
+  }
+  /**
+   * Parse a block of lines at a given indentation level
+   */
+  parseBlock(output, parentIndent) {
+    while (this.currentLine < this.lines.length) {
+      const line = this.parseLine(this.lines[this.currentLine]);
+      if (line.type === "empty") {
+        this.currentLine++;
+        continue;
+      }
+      if (line.indent <= parentIndent) {
+        break;
+      }
+      if (line.type === "bra") {
+        const attrs = line.attrs ? ` ${this.convertAttributes(line.attrs)}` : "";
+        output.push(`${"  ".repeat(line.indent)}<subroutine name="${line.tag}"${attrs}>`);
+        this.currentLine++;
+        this.parseBlock(output, line.indent);
+        output.push(`${"  ".repeat(line.indent)}</subroutine>`);
+        continue;
+      }
+      if (line.type === "ket") {
+        const indent = "  ".repeat(line.indent);
+        const attrs = line.attrs ? ` ${this.convertAttributes(line.attrs)}` : "";
+        const nextLine = this.currentLine + 1 < this.lines.length ? this.parseLine(this.lines[this.currentLine + 1]) : null;
+        if (nextLine && nextLine.indent > line.indent && nextLine.type !== "empty") {
+          output.push(`${indent}<${line.tag}${attrs}>`);
+          this.currentLine++;
+          this.parseBlock(output, line.indent);
+          output.push(`${indent}</${line.tag}>`);
+        } else {
+          if (line.text) {
+            const content = this.convertInlineKets(line.text);
+            output.push(`${indent}<${line.tag}${attrs}>${content}</${line.tag}>`);
+          } else {
+            output.push(`${indent}<${line.tag}${attrs}/>`);
+          }
+          this.currentLine++;
+        }
+        continue;
+      }
+      if (line.type === "text") {
+        const indent = "  ".repeat(line.indent);
+        const content = this.convertInlineKets(line.text || "");
+        output.push(`${indent}${content}`);
+        this.currentLine++;
+        continue;
+      }
+    }
+  }
+  /**
+   * Parse a single line into structured form
+   */
+  parseLine(raw) {
+    const match = raw.match(/^(\s*)(.*)/);
+    const indent = match ? Math.floor(match[1].length / 2) : 0;
+    const content = match ? match[2] : "";
+    if (!content.trim()) {
+      return { indent, type: "empty", raw };
+    }
+    const braMatch = content.match(/^<([a-zA-Z_][a-zA-Z0-9_-]*)\s*([^|]*)\|$/);
+    if (braMatch) {
+      return {
+        indent,
+        type: "bra",
+        tag: braMatch[1],
+        attrs: braMatch[2].trim() || void 0,
+        raw
+      };
+    }
+    const ketMatch = content.match(/^\|([a-zA-Z_][a-zA-Z0-9_-]*)\s*([^>]*?)>\s*(.*)/);
+    if (ketMatch) {
+      return {
+        indent,
+        type: "ket",
+        tag: ketMatch[1],
+        attrs: ketMatch[2].trim() || void 0,
+        text: ketMatch[3] || void 0,
+        raw
+      };
+    }
+    return {
+      indent,
+      type: "text",
+      text: content,
+      raw
+    };
+  }
+  /**
+   * Convert bra-ket attribute syntax to XML
+   * Examples:
+   *   name=value    → name="value"
+   *   x=5 y=10      → x="5" y="10"
+   *   select=@*     → select="@*"
+   */
+  convertAttributes(attrs) {
+    if (!attrs) return "";
+    const parts = [];
+    let current = "";
+    let inQuotes = false;
+    let quoteChar = "";
+    for (let i = 0; i < attrs.length; i++) {
+      const char = attrs[i];
+      if ((char === '"' || char === "'") && (i === 0 || attrs[i - 1] !== "\\")) {
+        if (!inQuotes) {
+          inQuotes = true;
+          quoteChar = char;
+          current += char;
+        } else if (char === quoteChar) {
+          inQuotes = false;
+          current += char;
+        } else {
+          current += char;
+        }
+      } else if (char === " " && !inQuotes) {
+        if (current.trim()) {
+          parts.push(current.trim());
+          current = "";
+        }
+      } else {
+        current += char;
+      }
+    }
+    if (current.trim()) {
+      parts.push(current.trim());
+    }
+    return parts.map((part) => {
+      const match = part.match(/^([a-zA-Z_][a-zA-Z0-9_-]*)=(.+)$/);
+      if (!match) return part;
+      const [, name, value] = match;
+      if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
+        return `${name}=${value}`;
+      }
+      return `${name}="${value}"`;
+    }).join(" ");
+  }
+  /**
+   * Convert inline kets within text content
+   * Example: "Hello |variable name=x> world" → "Hello <variable name="x"/> world"
+   */
+  convertInlineKets(text) {
+    return text.replace(/\|([a-zA-Z_][a-zA-Z0-9_-]*)\s*([^>]*?)>/g, (match, tag, attrs) => {
+      const attrStr = attrs.trim() ? ` ${this.convertAttributes(attrs.trim())}` : "";
+      return `<${tag}${attrStr}/>`;
+    });
+  }
+};
+
+export {
+  BraKetParser
+};

package/dist/{chunk-JIWLKB5O.js → chunk-GLXVY235.js}

@@ -51,6 +51,38 @@ var OllamaProvider = class {
   }
 };
 
+// src/llm/custom.ts
+var CustomLLMProvider = class {
+  client;
+  model;
+  constructor(options = {}) {
+    this.client = new CustomLLMClient(options);
+    this.model = options.model || "default";
+  }
+  async complete(prompt, opts = {}) {
+    const messages = opts.messages || [
+      { role: "user", content: prompt }
+    ];
+    return await this.client.chat({ messages });
+  }
+};
+var CustomLLMClient = class {
+  baseUrl;
+  constructor({ baseUrl = "http://localhost:5001" } = {}) {
+    this.baseUrl = baseUrl;
+  }
+  async chat({ messages }) {
+    const prompt = messages.map((m) => `${m.role}: ${m.content}`).join("\n");
+    const res = await fetch(`${this.baseUrl}/chat`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify({ message: prompt })
+    });
+    const data = await res.json();
+    return data.response;
+  }
+};
+
 // src/runtime/session.ts
 function substituteAttribute(session, value) {
   if (typeof value !== "string") return value;
@@ -81,8 +113,12 @@ function createSession(config = {}) {
         if (!openaiKey) throw new Error("OPENAI_API_KEY required for OpenAI provider");
         llmClient = new OpenAI({ apiKey: openaiKey });
         break;
+      case "custom":
+        const customBaseUrl = config.customLLMUrl || process.env.CUSTOM_LLM_URL || "http://localhost:5001";
+        llmClient = new CustomLLMProvider({ baseUrl: customBaseUrl, model: ollamaModel });
+        break;
       default:
-        throw new Error(`Unknown LLM provider: ${llmProvider}. Use 'ollama', 'anthropic', or 'openai'.`);
+        throw new Error(`Unknown LLM provider: ${llmProvider}. Use 'ollama', 'anthropic', 'openai', or 'custom'.`);
     }
   }
   return {

package/dist/{chunk-YRJ3SODI.js → chunk-HPGONBNW.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-HRHAMPOB.js";
 import {
   executeSubroutine
-} from "./chunk-JMUUPZZA.js";
+} from "./chunk-4QLTSCDG.js";
 import {
   cleanSubroutinesToBoundary,
   cleanToBoundary,
@@ -25,7 +25,7 @@ import {
   substituteVariables,
   throwException,
   unsetExceptionBoundary
-} from "./chunk-JIWLKB5O.js";
+} from "./chunk-GLXVY235.js";
 
 // src/tags/parameters.ts
 async function executeParameters(session, element) {
@@ -257,7 +257,7 @@ async function executeCall(session, element) {
   }
 }
 async function registerExtendChain(session, subroutine, currentName) {
-  const { executeSubroutine: executeSubroutine2 } = await import("./subroutine-I5XXJMFL.js");
+  const { executeSubroutine: executeSubroutine2 } = await import("./subroutine-V4D4LQIH.js");
   const extendsAttr = subroutine.attributes.extends;
   let parentName;
   if (extendsAttr) {
@@ -425,12 +425,12 @@ async function executeIf(session, element) {
   const condition = await evaluatePredicate(session, conditionElement);
   if (condition) {
     if (thenElement) {
-      const { integrateChildren: integrateChildren2 } = await import("./interpreter-WP3KMLST.js");
+      const { integrateChildren: integrateChildren2 } = await import("./interpreter-F65BCAYX.js");
       await integrateChildren2(session, thenElement);
     }
   } else {
     if (elseElement) {
-      const { integrateChildren: integrateChildren2 } = await import("./interpreter-WP3KMLST.js");
+      const { integrateChildren: integrateChildren2 } = await import("./interpreter-F65BCAYX.js");
       await integrateChildren2(session, elseElement);
     }
   }
@@ -443,7 +443,7 @@ async function evaluatePredicate(session, predicateElement) {
     return await evaluateCondition(session, predicateElement);
   }
   const outputLengthBefore = session.output.length;
-  const { integrate: integrate2 } = await import("./interpreter-WP3KMLST.js");
+  const { integrate: integrate2 } = await import("./interpreter-F65BCAYX.js");
   await integrate2(session, predicateElement);
   const newOutputChunks = session.output.slice(outputLengthBefore);
   const result = newOutputChunks.join("").trim();
@@ -466,11 +466,11 @@ async function evaluateCondition(session, condElement) {
   }
   const outputLengthBefore = session.output.length;
   const args = [];
-  const { integrate: integrate2 } = await import("./interpreter-WP3KMLST.js");
+  const { integrate: integrate2 } = await import("./interpreter-F65BCAYX.js");
   for (const child of condElement.children) {
     if (child.tag.toLowerCase() === "arg") {
       const argOutputStart = session.output.length;
-      const { integrateChildren: integrateChildren2 } = await import("./interpreter-WP3KMLST.js");
+      const { integrateChildren: integrateChildren2 } = await import("./interpreter-F65BCAYX.js");
       await integrateChildren2(session, child);
       const newChunks = session.output.slice(argOutputStart);
       const argValue = newChunks.join("");
@@ -531,7 +531,7 @@ function evaluateConditionType(evalType, args) {
 // src/tags/llm.ts
 async function executeLLM(session, element) {
   if (!session.llmClient) {
-    throw new Error("<llm> tag requires LLM configuration. Set LLM_PROVIDER (ollama/anthropic/openai) and appropriate API keys in environment or config.yml");
+    throw new Error("<llm> tag requires LLM configuration. Set LLM_PROVIDER (ollama/anthropic/openai/custom) and appropriate API keys in environment or config.yml");
   }
   if (session.limits.currentLLMCalls >= session.limits.maxLLMCalls) {
     throw new Error("Maximum LLM calls exceeded");
@@ -540,7 +540,8 @@ async function executeLLM(session, element) {
   const providerName = session.llmClient.constructor.name;
   const isOpenAI = providerName === "OpenAI";
   const isOllama = providerName === "OllamaProvider";
-  const defaultModel = isOpenAI ? "gpt-4.1-2025-04-14" : isOllama ? "llama2" : "claude-sonnet-4-20250514";
+  const isCustom = providerName === "CustomLLMProvider";
+  const defaultModel = isOpenAI ? "gpt-4.1-2025-04-14" : isOllama ? "llama2" : isCustom ? "custom-model" : "claude-sonnet-4-20250514";
   const model = element.attributes.model || process.env.DEFAULT_MODEL || defaultModel;
   const outputVar = element.attributes.output;
   const contextVar = element.attributes.context;
@@ -579,7 +580,7 @@ async function executeLLM(session, element) {
       console.error("[LLM] Full prompt sent to LLM (noextra):\n" + prompt + "\n");
     }
   } else {
-    const { getAvailableSubroutines } = await import("./session-UIWHLPTR.js");
+    const { getAvailableSubroutines } = await import("./session-UBATJEND.js");
     const subroutines = getAvailableSubroutines(session);
     if (session.debug) {
       console.error(
@@ -647,6 +648,14 @@ then you call it like
         temperature,
         max_tokens: maxTokens
       });
+    } else if (isCustom) {
+      const customPrompt = dialogHistory.map((m) => `${m.role}: ${m.content}`).join("\n");
+      result = await session.llmClient.complete(customPrompt, {
+        model,
+        temperature,
+        max_tokens: maxTokens,
+        messages: dialogHistory
+      });
     } else {
       const response = await session.llmClient.messages.create({
         model,
@@ -706,7 +715,7 @@ ${result}
           const parser = new DiracParser();
           let dynamicAST = parser.parse(diracCode);
           if (validateTags) {
-            const { validateDiracCode, applyCorrectedTags } = await import("./tag-validator-QX47WU2J.js");
+            const { validateDiracCode, applyCorrectedTags } = await import("./tag-validator-3RLLFTY6.js");
             let validation = await validateDiracCode(session, dynamicAST, { autocorrect });
             let retryCount = 0;
             while (!validation.valid && retryCount < maxRetries) {
@@ -735,6 +744,14 @@ Please fix these errors and generate valid Dirac XML again. Remember to only use
                   temperature,
                   max_tokens: maxTokens
                 });
+              } else if (isCustom) {
+                const customPrompt = dialogHistory.map((m) => `${m.role}: ${m.content}`).join("\n");
+                result = await session.llmClient.complete(customPrompt, {
+                  model,
+                  temperature,
+                  max_tokens: maxTokens,
+                  messages: dialogHistory
+                });
               } else {
                 const response = await session.llmClient.messages.create({
                   model,
@@ -815,6 +832,14 @@ ${feedbackPrompt}
                 temperature,
                 max_tokens: maxTokens
               });
+            } else if (isCustom) {
+              const customPrompt = dialogHistory.map((m) => `${m.role}: ${m.content}`).join("\n");
+              result = await session.llmClient.complete(customPrompt, {
+                model,
+                temperature,
+                max_tokens: maxTokens,
+                messages: dialogHistory
+              });
             } else {
               const response = await session.llmClient.messages.create({
                 model,
@@ -1237,7 +1262,7 @@ async function getBestTagMatch(candidate, allowed) {
   return { tag: allowed[bestIdx], score: bestScore };
 }
 async function executeTagCheck(session, element) {
-  const { getAvailableSubroutines } = await import("./session-UIWHLPTR.js");
+  const { getAvailableSubroutines } = await import("./session-UBATJEND.js");
   const subroutines = getAvailableSubroutines(session);
   const allowed = new Set(subroutines.map((s) => s.name));
   console.error("[tag-check] Allowed subroutines:", Array.from(allowed));
@@ -1330,7 +1355,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-WP3KMLST.js");
+      const { integrate: integrate2 } = await import("./interpreter-F65BCAYX.js");
       await integrate2(session, elementToExecute);
     }
   }
@@ -1339,7 +1364,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-WP3KMLST.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-F65BCAYX.js");
   const exceptionDom = {
     tag: "exception-content",
     attributes: { name: exceptionName },
@@ -1352,7 +1377,7 @@ async function executeThrow(session, element) {
 // src/tags/try.ts
 async function executeTry(session, element) {
   setExceptionBoundary(session);
-  const { integrateChildren: integrateChildren2 } = await import("./interpreter-WP3KMLST.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-F65BCAYX.js");
   await integrateChildren2(session, element);
   unsetExceptionBoundary(session);
 }
@@ -1362,7 +1387,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-WP3KMLST.js");
+    const { integrateChildren: integrateChildren2 } = await import("./interpreter-F65BCAYX.js");
     await integrateChildren2(session, element);
   }
   flushCurrentException(session);
@@ -1371,7 +1396,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-WP3KMLST.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-F65BCAYX.js");
   for (const exceptionDom of exceptions) {
     await integrateChildren2(session, exceptionDom);
   }
@@ -1511,7 +1536,7 @@ async function executeForeach(session, element) {
     const parser2 = new DiracParser2();
     try {
       const fromElement = parser2.parse(fromAttr);
-      const { integrate: integrate2 } = await import("./interpreter-WP3KMLST.js");
+      const { integrate: integrate2 } = await import("./interpreter-F65BCAYX.js");
       await integrate2(session, fromElement);
     } catch (e) {
       session.output = savedOutput;

package/dist/cli.js

@@ -1,11 +1,14 @@
 #!/usr/bin/env node
+import {
+  BraKetParser
+} from "./chunk-DRPHX3WX.js";
 import {
   execute
-} from "./chunk-UYDP4ZFS.js";
-import "./chunk-YRJ3SODI.js";
+} from "./chunk-4LLFMVOW.js";
+import "./chunk-HPGONBNW.js";
 import "./chunk-HRHAMPOB.js";
-import "./chunk-JMUUPZZA.js";
-import "./chunk-JIWLKB5O.js";
+import "./chunk-4QLTSCDG.js";
+import "./chunk-GLXVY235.js";
 
 // src/cli.ts
 import "dotenv/config";
@@ -13,7 +16,7 @@ import "dotenv/config";
 // package.json
 var package_default = {
   name: "dirac-lang",
-  version: "0.1.32",
+  version: "0.1.34",
   description: "LLM-Augmented Declarative Execution",
   type: "module",
   main: "dist/index.js",
@@ -63,175 +66,14 @@ var package_default = {
 import fs from "fs";
 import yaml from "js-yaml";
 import { resolve, extname } from "path";
-
-// src/runtime/braket-parser.ts
-var BraKetParser = class {
-  lines = [];
-  currentLine = 0;
-  /**
-   * Parse bra-ket notation and compile to XML
-   */
-  parse(source) {
-    this.lines = source.split("\n");
-    this.currentLine = 0;
-    const xml = ["<dirac>"];
-    this.parseBlock(xml, -1);
-    xml.push("</dirac>");
-    return xml.join("\n");
-  }
-  /**
-   * Parse a block of lines at a given indentation level
-   */
-  parseBlock(output, parentIndent) {
-    while (this.currentLine < this.lines.length) {
-      const line = this.parseLine(this.lines[this.currentLine]);
-      if (line.type === "empty") {
-        this.currentLine++;
-        continue;
-      }
-      if (line.indent <= parentIndent) {
-        break;
-      }
-      if (line.type === "bra") {
-        const attrs = line.attrs ? ` ${this.convertAttributes(line.attrs)}` : "";
-        output.push(`${"  ".repeat(line.indent)}<subroutine name="${line.tag}"${attrs}>`);
-        this.currentLine++;
-        this.parseBlock(output, line.indent);
-        output.push(`${"  ".repeat(line.indent)}</subroutine>`);
-        continue;
-      }
-      if (line.type === "ket") {
-        const indent = "  ".repeat(line.indent);
-        const attrs = line.attrs ? ` ${this.convertAttributes(line.attrs)}` : "";
-        const nextLine = this.currentLine + 1 < this.lines.length ? this.parseLine(this.lines[this.currentLine + 1]) : null;
-        if (nextLine && nextLine.indent > line.indent && nextLine.type !== "empty") {
-          output.push(`${indent}<${line.tag}${attrs}>`);
-          this.currentLine++;
-          this.parseBlock(output, line.indent);
-          output.push(`${indent}</${line.tag}>`);
-        } else {
-          if (line.text) {
-            const content = this.convertInlineKets(line.text);
-            output.push(`${indent}<${line.tag}${attrs}>${content}</${line.tag}>`);
-          } else {
-            output.push(`${indent}<${line.tag}${attrs}/>`);
-          }
-          this.currentLine++;
-        }
-        continue;
-      }
-      if (line.type === "text") {
-        const indent = "  ".repeat(line.indent);
-        const content = this.convertInlineKets(line.text || "");
-        output.push(`${indent}${content}`);
-        this.currentLine++;
-        continue;
-      }
-    }
-  }
-  /**
-   * Parse a single line into structured form
-   */
-  parseLine(raw) {
-    const match = raw.match(/^(\s*)(.*)/);
-    const indent = match ? Math.floor(match[1].length / 2) : 0;
-    const content = match ? match[2] : "";
-    if (!content.trim()) {
-      return { indent, type: "empty", raw };
-    }
-    const braMatch = content.match(/^<([a-zA-Z_][a-zA-Z0-9_-]*)\s*([^|]*)\|$/);
-    if (braMatch) {
-      return {
-        indent,
-        type: "bra",
-        tag: braMatch[1],
-        attrs: braMatch[2].trim() || void 0,
-        raw
-      };
-    }
-    const ketMatch = content.match(/^\|([a-zA-Z_][a-zA-Z0-9_-]*)\s*([^>]*?)>\s*(.*)/);
-    if (ketMatch) {
-      return {
-        indent,
-        type: "ket",
-        tag: ketMatch[1],
-        attrs: ketMatch[2].trim() || void 0,
-        text: ketMatch[3] || void 0,
-        raw
-      };
-    }
-    return {
-      indent,
-      type: "text",
-      text: content,
-      raw
-    };
-  }
-  /**
-   * Convert bra-ket attribute syntax to XML
-   * Examples:
-   *   name=value    → name="value"
-   *   x=5 y=10      → x="5" y="10"
-   *   select=@*     → select="@*"
-   */
-  convertAttributes(attrs) {
-    if (!attrs) return "";
-    const parts = [];
-    let current = "";
-    let inQuotes = false;
-    let quoteChar = "";
-    for (let i = 0; i < attrs.length; i++) {
-      const char = attrs[i];
-      if ((char === '"' || char === "'") && (i === 0 || attrs[i - 1] !== "\\")) {
-        if (!inQuotes) {
-          inQuotes = true;
-          quoteChar = char;
-          current += char;
-        } else if (char === quoteChar) {
-          inQuotes = false;
-          current += char;
-        } else {
-          current += char;
-        }
-      } else if (char === " " && !inQuotes) {
-        if (current.trim()) {
-          parts.push(current.trim());
-          current = "";
-        }
-      } else {
-        current += char;
-      }
-    }
-    if (current.trim()) {
-      parts.push(current.trim());
-    }
-    return parts.map((part) => {
-      const match = part.match(/^([a-zA-Z_][a-zA-Z0-9_-]*)=(.+)$/);
-      if (!match) return part;
-      const [, name, value] = match;
-      if (value.startsWith('"') && value.endsWith('"') || value.startsWith("'") && value.endsWith("'")) {
-        return `${name}=${value}`;
-      }
-      return `${name}="${value}"`;
-    }).join(" ");
-  }
-  /**
-   * Convert inline kets within text content
-   * Example: "Hello |variable name=x> world" → "Hello <variable name="x"/> world"
-   */
-  convertInlineKets(text) {
-    return text.replace(/\|([a-zA-Z_][a-zA-Z0-9_-]*)\s*([^>]*?)>/g, (match, tag, attrs) => {
-      const attrStr = attrs.trim() ? ` ${this.convertAttributes(attrs.trim())}` : "";
-      return `<${tag}${attrStr}/>`;
-    });
-  }
-};
-
-// src/cli.ts
 async function main() {
   const args = process.argv.slice(2);
   if (args.includes("--help") || args.includes("-h")) {
     console.log("Usage: dirac <file.di|file.bk>");
+    console.log("       dirac shell [options]");
+    console.log("");
+    console.log("Commands:");
+    console.log("  shell             Start interactive shell (REPL)");
     console.log("");
     console.log("File formats:");
     console.log("  .di               XML notation (verbose)");
@@ -245,14 +87,51 @@ async function main() {
     console.log("  --model <name>    Set default LLM model");
     console.log("  --max-llm <n>     Maximum LLM calls (default: 100)");
     console.log("  --max-depth <n>   Maximum recursion depth (default: 50)");
+    console.log("  -f, --config <path>  Path to config.yml file");
     process.exit(0);
   }
   if (args.includes("--version") || args.includes("-v")) {
     console.log(package_default.version);
     process.exit(0);
   }
+  if (args[0] === "shell") {
+    const { DiracShell } = await import("./shell-FHSPULIL.js");
+    const shellConfig = { debug: false };
+    for (let i = 1; i < args.length; i++) {
+      const arg = args[i];
+      if (arg === "--debug") {
+        shellConfig.debug = true;
+      } else if ((arg === "-f" || arg === "--config") && i + 1 < args.length) {
+        const configPath = resolve(args[++i]);
+        if (fs.existsSync(configPath)) {
+          const configData = yaml.load(fs.readFileSync(configPath, "utf-8"));
+          Object.assign(shellConfig, {
+            llmProvider: configData.llmProvider,
+            llmModel: configData.llmModel,
+            customLLMUrl: configData.customLLMUrl
+          });
+        }
+      }
+    }
+    if (!shellConfig.llmProvider) {
+      const defaultConfigPath = resolve(process.cwd(), "config.yml");
+      if (fs.existsSync(defaultConfigPath)) {
+        try {
+          const configData = yaml.load(fs.readFileSync(defaultConfigPath, "utf-8"));
+          shellConfig.llmProvider = shellConfig.llmProvider || configData.llmProvider;
+          shellConfig.llmModel = shellConfig.llmModel || configData.llmModel;
+          shellConfig.customLLMUrl = shellConfig.customLLMUrl || configData.customLLMUrl;
+        } catch (err) {
+        }
+      }
+    }
+    const shell = new DiracShell(shellConfig);
+    shell.start();
+    return;
+  }
   if (args.length === 0) {
     console.error("Usage: dirac <file.di|file.bk>");
+    console.error("       dirac shell [options]");
     console.error("Try dirac --help for more information.");
     process.exit(1);
   }

package/dist/index.d.ts

@@ -94,6 +94,7 @@ interface DiracConfig {
     filePath?: string;
     llmProvider?: string;
     llmModel?: string;
+    customLLMUrl?: string;
 }
 
 /**

package/dist/index.js

@@ -2,19 +2,19 @@ import {
   createLLMAdapter,
   execute,
   executeUserCommand
-} from "./chunk-UYDP4ZFS.js";
+} from "./chunk-4LLFMVOW.js";
 import {
   integrate
-} from "./chunk-YRJ3SODI.js";
+} from "./chunk-HPGONBNW.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";
-import "./chunk-JMUUPZZA.js";
+import "./chunk-4QLTSCDG.js";
 import {
   createSession,
   getAvailableSubroutines,
   getOutput
-} from "./chunk-JIWLKB5O.js";
+} from "./chunk-GLXVY235.js";
 export {
   DiracParser,
   createLLMAdapter,

package/dist/{interpreter-WP3KMLST.js → interpreter-F65BCAYX.js}

@@ -1,10 +1,10 @@
 import {
   integrate,
   integrateChildren
-} from "./chunk-YRJ3SODI.js";
+} from "./chunk-HPGONBNW.js";
 import "./chunk-HRHAMPOB.js";
-import "./chunk-JMUUPZZA.js";
-import "./chunk-JIWLKB5O.js";
+import "./chunk-4QLTSCDG.js";
+import "./chunk-GLXVY235.js";
 export {
   integrate,
   integrateChildren

package/dist/{session-UIWHLPTR.js → session-UBATJEND.js}

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

package/dist/shell-FHSPULIL.js

@@ -0,0 +1,290 @@
+#!/usr/bin/env node
+import {
+  BraKetParser
+} from "./chunk-DRPHX3WX.js";
+import {
+  integrate
+} from "./chunk-HPGONBNW.js";
+import {
+  DiracParser
+} from "./chunk-HRHAMPOB.js";
+import "./chunk-4QLTSCDG.js";
+import {
+  createSession
+} from "./chunk-GLXVY235.js";
+
+// src/shell.ts
+import * as readline from "readline";
+import * as fs from "fs";
+import * as path from "path";
+import * as os from "os";
+import yaml from "js-yaml";
+var HISTORY_FILE = path.join(os.homedir(), ".dirac_history");
+var MAX_HISTORY = 1e3;
+var DiracShell = class {
+  session;
+  braketParser;
+  xmlParser;
+  rl;
+  inputBuffer = [];
+  baseIndent = null;
+  config;
+  constructor(config = {}) {
+    this.config = config;
+    this.session = createSession(config);
+    this.braketParser = new BraKetParser();
+    this.xmlParser = new DiracParser();
+    this.rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+      prompt: "> ",
+      historySize: MAX_HISTORY
+    });
+    this.loadHistory();
+    this.setupHandlers();
+  }
+  loadHistory() {
+    try {
+      if (fs.existsSync(HISTORY_FILE)) {
+        const history = fs.readFileSync(HISTORY_FILE, "utf-8").split("\n").filter((line) => line.trim()).slice(-MAX_HISTORY);
+        this.rl.history = history.reverse();
+      }
+    } catch (err) {
+    }
+  }
+  saveHistory() {
+    try {
+      const history = this.rl.history.slice().reverse().join("\n");
+      fs.writeFileSync(HISTORY_FILE, history, "utf-8");
+    } catch (err) {
+    }
+  }
+  setupHandlers() {
+    this.rl.on("line", async (input) => {
+      await this.handleInput(input);
+    });
+    this.rl.on("close", () => {
+      this.saveHistory();
+      console.log("\nGoodbye!");
+      process.exit(0);
+    });
+    this.rl.on("SIGINT", () => {
+      if (this.inputBuffer.length > 0) {
+        this.inputBuffer = [];
+        this.baseIndent = null;
+        console.log("\n(Input cancelled)");
+        this.rl.setPrompt("> ");
+        this.rl.prompt();
+      } else {
+        this.rl.close();
+      }
+    });
+  }
+  async handleInput(input) {
+    if (!this.inputBuffer.length && input.trim().startsWith(":")) {
+      await this.handleCommand(input.trim());
+      this.rl.prompt();
+      return;
+    }
+    const indent = this.getIndent(input);
+    if (this.inputBuffer.length === 0) {
+      this.inputBuffer.push(input);
+      this.baseIndent = indent;
+      if (this.needsContinuation(input)) {
+        this.rl.setPrompt("... ");
+        console.log("    (Press Enter on empty line to execute, or Ctrl+C to cancel)");
+        this.rl.prompt();
+        return;
+      }
+    } else {
+      if (input.trim() === "") {
+        await this.executeBuffer();
+        this.rl.setPrompt("> ");
+        this.rl.prompt();
+        return;
+      }
+      this.inputBuffer.push(input);
+      this.rl.setPrompt("... ");
+      this.rl.prompt();
+      return;
+    }
+    await this.executeBuffer();
+    this.rl.prompt();
+  }
+  getIndent(line) {
+    const match = line.match(/^(\s*)/);
+    return match ? match[1].length : 0;
+  }
+  needsContinuation(line) {
+    const trimmed = line.trim();
+    if (trimmed.match(/^<[a-zA-Z_][a-zA-Z0-9_-]*.*\|$/)) {
+      return true;
+    }
+    const ketMatch = trimmed.match(/^\|([a-zA-Z_][a-zA-Z0-9_-]*)\s*([^>]*?)>\s*(.*)$/);
+    if (ketMatch && !ketMatch[3]) {
+      return true;
+    }
+    return false;
+  }
+  async executeBuffer() {
+    if (this.inputBuffer.length === 0) return;
+    const input = this.inputBuffer.join("\n");
+    this.inputBuffer = [];
+    this.baseIndent = null;
+    try {
+      this.session.output = [];
+      const xml = this.braketParser.parse(input);
+      if (this.config.debug) {
+        console.log("[Debug] Generated XML:\n", xml);
+      }
+      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:", error instanceof Error ? error.message : String(error));
+      if (this.config.debug && error instanceof Error && error.stack) {
+        console.error(error.stack);
+      }
+    }
+  }
+  async handleCommand(cmd) {
+    const parts = cmd.slice(1).split(/\s+/);
+    const command = parts[0];
+    const args = parts.slice(1);
+    switch (command) {
+      case "help":
+        console.log(`
+Dirac Shell - Interactive REPL
+
+Commands:
+  :help           Show this help
+  :vars           List all variables
+  :subs           List all subroutines
+  :clear          Clear session (reset variables and subroutines)
+  :debug          Toggle debug mode
+  :config         Show current configuration
+  :exit           Exit shell
+
+Syntax:
+  |tag attrs>text         Ket notation (most tags)
+  <name|                  Bra notation (subroutine definitions)
+    |output>content       Indented children
+  
+Multi-line Input:
+  - Type a line that needs continuation (like <greeting| or |llm>)
+  - Shell switches to '...' prompt
+  - Type your content lines (add spaces for indentation manually)
+  - Press ENTER on an empty line to execute
+  - Or press Ctrl+C to cancel
+  
+Note: You must manually add spaces for indentation (2 spaces per level)
+
+Examples:
+  |output>Hello World
+  |defvar name=count value=5>
+  |llm>create a greeting subroutine
+  <greeting| name=String
+    |output>Hello |variable name=name>
+  |greeting name=World>
+`);
+        break;
+      case "vars":
+        if (this.session.variables.length === 0) {
+          console.log("No variables defined");
+        } else {
+          console.log("Variables:");
+          for (const v of this.session.variables) {
+            if (v.visible) {
+              console.log(`  ${v.name} = ${JSON.stringify(v.value)}`);
+            }
+          }
+        }
+        break;
+      case "subs":
+        if (this.session.subroutines.length === 0) {
+          console.log("No subroutines defined");
+        } else {
+          console.log("Subroutines:");
+          for (const s of this.session.subroutines) {
+            const params = s.parameters?.map((p) => p.name).join(", ") || "";
+            console.log(`  ${s.name}(${params})`);
+            if (s.description) {
+              console.log(`    ${s.description}`);
+            }
+          }
+        }
+        break;
+      case "clear":
+        this.session.variables = [];
+        this.session.subroutines = [];
+        this.session.varBoundary = 0;
+        this.session.subBoundary = 0;
+        console.log("Session cleared");
+        break;
+      case "debug":
+        this.config.debug = !this.config.debug;
+        this.session.debug = this.config.debug;
+        console.log(`Debug mode: ${this.config.debug ? "ON" : "OFF"}`);
+        break;
+      case "config":
+        console.log("Configuration:");
+        console.log(`  LLM Provider: ${this.config.llmProvider || "none"}`);
+        console.log(`  LLM Model: ${this.config.llmModel || "default"}`);
+        console.log(`  Debug: ${this.config.debug ? "ON" : "OFF"}`);
+        if (this.config.customLLMUrl) {
+          console.log(`  Custom LLM URL: ${this.config.customLLMUrl}`);
+        }
+        break;
+      case "exit":
+      case "quit":
+        this.rl.close();
+        break;
+      default:
+        console.log(`Unknown command: ${command}. Type :help for available commands.`);
+    }
+  }
+  start() {
+    console.log("Dirac Shell v0.1.0");
+    console.log("Type :help for commands, :exit to quit\n");
+    if (this.config.llmProvider) {
+      console.log(`LLM: ${this.config.llmProvider} (${this.config.llmModel || "default"})
+`);
+    } else {
+      console.log("Warning: No LLM provider configured. Set LLM_PROVIDER environment variable.\n");
+    }
+    this.rl.prompt();
+  }
+};
+async function main() {
+  let config = {
+    debug: process.env.DEBUG === "1"
+  };
+  const configPath = path.join(process.cwd(), "config.yml");
+  if (fs.existsSync(configPath)) {
+    try {
+      const configData = yaml.load(fs.readFileSync(configPath, "utf-8"));
+      config = {
+        ...config,
+        llmProvider: configData.llmProvider || process.env.LLM_PROVIDER,
+        llmModel: configData.llmModel || process.env.LLM_MODEL,
+        customLLMUrl: configData.customLLMUrl || process.env.CUSTOM_LLM_URL
+      };
+    } catch (err) {
+      console.error("Warning: Could not load config.yml");
+    }
+  } else {
+    config.llmProvider = process.env.LLM_PROVIDER;
+    config.llmModel = process.env.LLM_MODEL;
+    config.customLLMUrl = process.env.CUSTOM_LLM_URL;
+  }
+  const shell = new DiracShell(config);
+  shell.start();
+}
+if (import.meta.url === `file://${process.argv[1]}`) {
+  main();
+}
+export {
+  DiracShell
+};

package/dist/{subroutine-I5XXJMFL.js → subroutine-V4D4LQIH.js}

@@ -1,7 +1,7 @@
 import {
   executeSubroutine
-} from "./chunk-JMUUPZZA.js";
-import "./chunk-JIWLKB5O.js";
+} from "./chunk-4QLTSCDG.js";
+import "./chunk-GLXVY235.js";
 export {
   executeSubroutine
 };

package/dist/{tag-validator-QX47WU2J.js → tag-validator-3RLLFTY6.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-UIWHLPTR.js");
+  const { getAvailableSubroutines } = await import("./session-UBATJEND.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-YRJ3SODI.js";
+} from "./chunk-HPGONBNW.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";
-import "./chunk-JMUUPZZA.js";
+import "./chunk-4QLTSCDG.js";
 import {
   createSession,
   getOutput
-} from "./chunk-JIWLKB5O.js";
+} from "./chunk-GLXVY235.js";
 
 // src/test-runner.ts
 import fs from "fs";

package/package.json

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