dirac-lang 0.1.33 → 0.1.35

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/cli.js

@@ -1,4 +1,7 @@
 #!/usr/bin/env node
+import {
+  BraKetParser
+} from "./chunk-DRPHX3WX.js";
 import {
   execute
 } from "./chunk-4LLFMVOW.js";
@@ -13,7 +16,7 @@ import "dotenv/config";
 // package.json
 var package_default = {
   name: "dirac-lang",
-  version: "0.1.33",
+  version: "0.1.35",
   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-6ANKVL77.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/shell-6ANKVL77.js

@@ -0,0 +1,303 @@
+#!/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;
+  currentIndent = 0;
+  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;
+        this.currentIndent = 0;
+        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.currentIndent = (this.baseIndent || 0) + 2;
+        this.rl.setPrompt("... ");
+        console.log(`    (Indent with ${this.currentIndent} spaces, or press Enter on empty line to execute)`);
+        this.rl.prompt();
+        return;
+      }
+    } else {
+      if (input.trim() === "") {
+        await this.executeBuffer();
+        this.currentIndent = 0;
+        this.rl.setPrompt("> ");
+        this.rl.prompt();
+        return;
+      }
+      let processedInput = input;
+      if (this.currentIndent > 0 && indent < this.currentIndent) {
+        processedInput = " ".repeat(this.currentIndent) + input;
+      }
+      this.inputBuffer.push(processedInput);
+      const trimmed = input.trim();
+      const currentLineIndent = this.getIndent(processedInput);
+      if (trimmed.match(/^<[a-zA-Z_][a-zA-Z0-9_-]*.*\|$/) || trimmed.match(/^\|[a-zA-Z_][a-zA-Z0-9_-]*\s*[^>]*?>$/) && !trimmed.match(/>\s*.+$/)) {
+        this.currentIndent = currentLineIndent + 2;
+      } else {
+        this.currentIndent = currentLineIndent;
+      }
+      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 and shows expected indent level
+  - You can type spaces manually, or just type content (shell adds spaces)
+  - Press ENTER on an empty line to execute
+  - Or press Ctrl+C to cancel
+
+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/package.json

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