dirac-lang 0.1.31 → 0.1.33

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-MAPD5UUF.js → chunk-4LLFMVOW.js}

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

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

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

package/dist/{chunk-SIGINKX3.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 {
@@ -107,7 +143,9 @@ function createSession(config = {}) {
     isReturn: false,
     isBreak: false,
     skipSubroutineRegistration: false,
-    debug: config.debug || false
+    debug: config.debug || false,
+    currentFile: config.filePath
+    // Set current file from config for proper relative import resolution
   };
 }
 function setVariable(session, name, value, visible = false) {

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

@@ -3,7 +3,7 @@ import {
 } from "./chunk-HRHAMPOB.js";
 import {
   executeSubroutine
-} from "./chunk-FWD3RMQ7.js";
+} from "./chunk-4QLTSCDG.js";
 import {
   cleanSubroutinesToBoundary,
   cleanToBoundary,
@@ -25,7 +25,7 @@ import {
   substituteVariables,
   throwException,
   unsetExceptionBoundary
-} from "./chunk-SIGINKX3.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-W2MI62EG.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-CEGW4F6U.js");
+      const { integrateChildren: integrateChildren2 } = await import("./interpreter-F65BCAYX.js");
       await integrateChildren2(session, thenElement);
     }
   } else {
     if (elseElement) {
-      const { integrateChildren: integrateChildren2 } = await import("./interpreter-CEGW4F6U.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-CEGW4F6U.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-CEGW4F6U.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-CEGW4F6U.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-2OG5LRD4.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-3GP2CEDC.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,
@@ -987,10 +1012,11 @@ function resolveImportPath(src, currentDir) {
   return resolved.endsWith(".di") ? resolved : resolved + ".di";
 }
 async function executeImport(session, element) {
-  const src = element.attributes.src;
-  if (!src) {
+  const srcAttr = element.attributes.src;
+  if (!srcAttr) {
     throw new Error("<import> requires src attribute");
   }
+  const src = substituteAttribute(session, srcAttr);
   const currentDir = session.currentFile ? dirname2(session.currentFile) : process.cwd();
   const importPath = resolveImportPath(src, currentDir);
   if (session.debug) {
@@ -1236,7 +1262,7 @@ async function getBestTagMatch(candidate, allowed) {
   return { tag: allowed[bestIdx], score: bestScore };
 }
 async function executeTagCheck(session, element) {
-  const { getAvailableSubroutines } = await import("./session-2OG5LRD4.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));
@@ -1329,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-CEGW4F6U.js");
+      const { integrate: integrate2 } = await import("./interpreter-F65BCAYX.js");
       await integrate2(session, elementToExecute);
     }
   }
@@ -1338,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-CEGW4F6U.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-F65BCAYX.js");
   const exceptionDom = {
     tag: "exception-content",
     attributes: { name: exceptionName },
@@ -1351,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-CEGW4F6U.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-F65BCAYX.js");
   await integrateChildren2(session, element);
   unsetExceptionBoundary(session);
 }
@@ -1361,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-CEGW4F6U.js");
+    const { integrateChildren: integrateChildren2 } = await import("./interpreter-F65BCAYX.js");
     await integrateChildren2(session, element);
   }
   flushCurrentException(session);
@@ -1370,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-CEGW4F6U.js");
+  const { integrateChildren: integrateChildren2 } = await import("./interpreter-F65BCAYX.js");
   for (const exceptionDom of exceptions) {
     await integrateChildren2(session, exceptionDom);
   }
@@ -1510,7 +1536,7 @@ async function executeForeach(session, element) {
     const parser2 = new DiracParser2();
     try {
       const fromElement = parser2.parse(fromAttr);
-      const { integrate: integrate2 } = await import("./interpreter-CEGW4F6U.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,11 @@
 #!/usr/bin/env node
 import {
   execute
-} from "./chunk-MAPD5UUF.js";
-import "./chunk-YAGJPLVS.js";
+} from "./chunk-4LLFMVOW.js";
+import "./chunk-HPGONBNW.js";
 import "./chunk-HRHAMPOB.js";
-import "./chunk-FWD3RMQ7.js";
-import "./chunk-SIGINKX3.js";
+import "./chunk-4QLTSCDG.js";
+import "./chunk-GLXVY235.js";
 
 // src/cli.ts
 import "dotenv/config";
@@ -13,7 +13,7 @@ import "dotenv/config";
 // package.json
 var package_default = {
   name: "dirac-lang",
-  version: "0.1.31",
+  version: "0.1.33",
   description: "LLM-Augmented Declarative Execution",
   type: "module",
   main: "dist/index.js",

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-MAPD5UUF.js";
+} from "./chunk-4LLFMVOW.js";
 import {
   integrate
-} from "./chunk-YAGJPLVS.js";
+} from "./chunk-HPGONBNW.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";
-import "./chunk-FWD3RMQ7.js";
+import "./chunk-4QLTSCDG.js";
 import {
   createSession,
   getAvailableSubroutines,
   getOutput
-} from "./chunk-SIGINKX3.js";
+} from "./chunk-GLXVY235.js";
 export {
   DiracParser,
   createLLMAdapter,

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

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

package/dist/{session-2OG5LRD4.js → session-UBATJEND.js}

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

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

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

package/dist/{tag-validator-3GP2CEDC.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-2OG5LRD4.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-YAGJPLVS.js";
+} from "./chunk-HPGONBNW.js";
 import {
   DiracParser
 } from "./chunk-HRHAMPOB.js";
-import "./chunk-FWD3RMQ7.js";
+import "./chunk-4QLTSCDG.js";
 import {
   createSession,
   getOutput
-} from "./chunk-SIGINKX3.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.31",
+  "version": "0.1.33",
   "description": "LLM-Augmented Declarative Execution",
   "type": "module",
   "main": "dist/index.js",