dirac-lang 0.1.2

package/examples/direct-call.di

@@ -0,0 +1,17 @@
+#!/usr/bin/env dirac
+<dirac>
+  <import src="./lib/math.di" />
+  
+  <output>Direct Tag Call Test&#10;&#10;</output>
+  
+  <defvar name="x" value="9" />
+  <output>Using &lt;SQUARE /&gt;: </output>
+  <SQUARE />
+  <output>&#10;</output>
+  
+  <defvar name="a" value="100" />
+  <defvar name="b" value="200" />
+  <output>Using &lt;ADD /&gt;: </output>
+  <ADD />
+  <output>&#10;</output>
+</dirac>

package/examples/disk-analysis.di

@@ -0,0 +1,16 @@
+<dirac>
+  <!-- Get disk usage and ask LLM to summarize -->
+  <output>Analyzing disk usage...</output>
+  <output>&#10;</output>
+  
+  <llm>
+    <system>du -sh . 2>/dev/null</system>
+    <system>df -h . | tail -1</system>
+    
+    Above are two commands:
+    1. Total size of current directory
+    2. Disk space information for the filesystem
+    
+    Please tell me in one sentence: How much space is this directory using and what percentage of the disk is free?
+  </llm>
+</dirac>

package/examples/executable-hello.di

@@ -0,0 +1,7 @@
+#!/usr/bin/env dirac
+<!-- Executable Dirac Script -->
+<dirac>
+  <defvar name="name" value="World" />
+  <output>Hello, ${name}!&#10;</output>
+  <output>This script runs directly!&#10;</output>
+</dirac>

package/examples/execute-demo.di

@@ -0,0 +1,38 @@
+<!-- Simple Execute Demo - LLM generates and executes code -->
+<dirac>
+  <output>Demo: LLM-Generated Executable Code&#10;&#10;</output>
+  
+  <!-- Simple calculation task -->
+  <output>Task: Calculate 15 * 23 + 7&#10;</output>
+  <LLM output="mathCode" maxTokens="150">
+    Generate Dirac XML to calculate: 15 * 23 + 7
+    
+    Format:
+    &lt;dirac&gt;
+      &lt;eval name="result"&gt;return 15 * 23 + 7;&lt;/eval&gt;
+      &lt;output&gt;Result: ${result}&lt;/output&gt;
+    &lt;/dirac&gt;
+    
+    Return only XML, no markdown.
+  </LLM>
+  
+  <execute source="mathCode" />
+  <output>&#10;</output>
+  
+  <!-- File listing task -->
+  <output>Task: Count files in current directory&#10;</output>
+  <LLM output="fileCode" maxTokens="150">
+    Generate Dirac XML to count files in current directory.
+    
+    Format:
+    &lt;dirac&gt;
+      &lt;eval name="count"&gt;return fs.readdirSync('.').length;&lt;/eval&gt;
+      &lt;output&gt;Files: ${count}&lt;/output&gt;
+    &lt;/dirac&gt;
+    
+    Return only XML, no markdown.
+  </LLM>
+  
+  <execute source="fileCode" />
+  <output>&#10;Done!&#10;</output>
+</dirac>

package/examples/file-manager.di

@@ -0,0 +1,77 @@
+<!-- File Manager Agent - Operational Example -->
+<dirac>
+  <defvar name="targetDir" value="examples" />
+  
+  <output>Analyzing directory: ${targetDir}&#10;&#10;</output>
+  
+  <!-- Step 1: List files in directory -->
+  <output>Listing files...&#10;</output>
+  <eval name="fileList">
+    const files = fs.readdirSync(targetDir);
+    return files.join(', ');
+  </eval>
+  <output>Found: ${fileList}&#10;&#10;</output>
+  
+  <!-- Step 2: Ask LLM to analyze what's missing -->
+  <output>Asking LLM to analyze...&#10;</output>
+  <LLM output="analysis" maxTokens="200">
+    I have a directory with these files: ${fileList}
+    
+    These appear to be example files for a programming language.
+    Suggest ONE simple example file that would be useful to add.
+    
+    Respond with ONLY:
+    1. Filename (must end in .di)
+    2. Brief description (one line)
+    
+    Format:
+    FILENAME: name.di
+    DESCRIPTION: what it does
+  </LLM>
+  <output>${analysis}&#10;&#10;</output>
+  
+  <!-- Step 3: Extract filename from LLM response -->
+  <eval name="newFilename">
+    const text = analysis;
+    const match = text.match(/FILENAME:\s*(\S+\.di)/i);
+    return match ? match[1] : 'new-example.di';
+  </eval>
+  
+  <output>Creating file: ${newFilename}&#10;</output>
+  
+  <!-- Step 4: Ask LLM to generate the file content -->
+  <LLM output="fileContent" maxTokens="300">
+    Create the content for ${newFilename} based on this description:
+    ${analysis}
+    
+    The file should use Dirac XML syntax with these tags:
+    - &lt;dirac&gt; (root)
+    - &lt;defvar name="x" value="y" /&gt;
+    - &lt;output&gt;text&lt;/output&gt;
+    - &lt;LLM output="var"&gt;prompt&lt;/LLM&gt;
+    
+    Make it simple and functional. Include XML declaration and comment.
+  </LLM>
+  
+  <!-- Step 5: Write the file -->
+  <eval name="writeResult">
+    const filePath = path.join(targetDir, newFilename);
+    const content = fileContent;
+    fs.writeFileSync(filePath, content, 'utf-8');
+    return 'File written successfully to ' + filePath;
+  </eval>
+  
+  <output>&#10;Result: ${writeResult}&#10;</output>
+  
+  <!-- Step 6: Verify the file was created -->
+  <eval name="verification">
+    const filePath = path.join(targetDir, newFilename);
+    if (fs.existsSync(filePath)) {
+      const stats = fs.statSync(filePath);
+      return 'Verified! File size: ' + stats.size + ' bytes';
+    }
+    return 'Error: File not found';
+  </eval>
+  
+  <output>Verification: ${verification}&#10;</output>
+</dirac>

package/examples/file-stats.di

@@ -0,0 +1,18 @@
+#!/usr/bin/env dirac
+<!-- Executable Dirac Script: Quick File Analysis -->
+<dirac>
+  <eval name="fileCount">
+    return fs.readdirSync('.').length;
+  </eval>
+  
+  <eval name="diracFiles">
+    return fs.readdirSync('.')
+      .filter(f => f.endsWith('.di'))
+      .length;
+  </eval>
+  
+  <output>Current Directory Analysis&#10;</output>
+  <output>========================&#10;</output>
+  <output>Total files: ${fileCount}&#10;</output>
+  <output>Dirac scripts: ${diracFiles}&#10;</output>
+</dirac>

package/examples/hello.bk

@@ -0,0 +1 @@
+|output>Hello from bra-ket notation!

package/examples/hello.di

@@ -0,0 +1,5 @@
+<!-- Basic variable and output test -->
+<dirac>
+  <defvar name="greeting" value="Hello, World!" />
+  <output>${greeting}</output>
+</dirac>

package/examples/import-demo.di

@@ -0,0 +1,31 @@
+#!/usr/bin/env dirac
+<!-- Demo: Using imported libraries -->
+<dirac>
+  <output>Import Demo&#10;&#10;</output>
+  
+  <!-- Import libraries -->
+  <import src="./lib/math.di" />
+  <import src="./lib/fileops.di" />
+  
+  <output>Testing math library:&#10;</output>
+  <defvar name="x" value="5" />
+  <output>Square of ${x}: </output>
+  <call name="SQUARE" />
+  
+  <defvar name="a" value="10" />
+  <defvar name="b" value="20" />
+  <output>Add ${a} + ${b}: </output>
+  <call name="ADD" />
+  
+  <defvar name="num" value="5" />
+  <output>Factorial of ${num}: </output>
+  <call name="FACTORIAL" />
+  
+  <output>&#10;Testing file ops library:&#10;</output>
+  <defvar name="dir" value="." />
+  <call name="LIST_FILES" />
+  <call name="COUNT_FILES" />
+  
+  <defvar name="filepath" value="./package.json" />
+  <call name="FILE_EXISTS" />
+</dirac>

package/examples/inline-test.bk

@@ -0,0 +1,7 @@
+<greet|
+  |parameters select=@name>
+  |output>Hello, |variable name=name>!
+
+|greet name=Alice>
+|output>
+|greet name=Bob>

package/examples/lib/advanced-math.di

@@ -0,0 +1,81 @@
+<dirac>
+
+<subroutine name="MATH_SQRT">
+  <eval>
+    const caller = getParams();
+    const n = parseFloat(caller.attributes.n || 0);
+    if (n &lt; 0) {
+      console.log('NaN');
+      return;
+    }
+    let x = n;
+    let prev;
+    do {
+      prev = x;
+      x = (x + n / x) / 2;
+    } while (Math.abs(x - prev) &lt; 1e-10);
+    console.log(x);
+  </eval>
+</subroutine>
+
+<subroutine name="MATH_STATS">
+  <eval>
+    const caller = getParams();
+    const dataStr = caller.attributes.data || '[]';
+    const data = JSON.parse(dataStr);
+    if (data.length === 0) { console.log('{}'); return; }
+    const sum = data.reduce((a, b) =&gt; a + b, 0);
+    const mean = sum / data.length;
+    const variance = data.reduce((acc, x) =&gt; acc + Math.pow(x - mean, 2), 0) / data.length;
+    const stddev = Math.sqrt(variance);
+    const sorted = [...data].sort((a, b) =&gt; a - b);
+    const median = data.length % 2 === 0 ? (sorted[data.length/2 - 1] + sorted[data.length/2]) / 2 : sorted[Math.floor(data.length/2)];
+    const stats = { count: data.length, sum: sum, mean: mean, median: median, stddev: stddev, min: sorted[0], max: sorted[sorted.length - 1] };
+    console.log(JSON.stringify(stats, null, 2));
+  </eval>
+</subroutine>
+
+<subroutine name="MATH_RANDOM">
+  <eval>
+    const caller = getParams();
+    const min = parseFloat(caller.attributes.min || 0);
+    const max = parseFloat(caller.attributes.max || 1);
+    const random = Math.random() * (max - min) + min;
+    console.log(random);
+  </eval>
+</subroutine>
+
+<subroutine name="MATH_FACTORIAL">
+  <eval>
+    const caller = getParams();
+    const n = parseInt(caller.attributes.n || 0);
+    function factorial(x) { if (x &lt;= 1) return 1; return x * factorial(x - 1); }
+    console.log(factorial(n));
+  </eval>
+</subroutine>
+
+<subroutine name="MATH_GCD">
+  <eval>
+    const caller = getParams();
+    const a = parseInt(caller.attributes.a || 0);
+    const b = parseInt(caller.attributes.b || 0);
+    function gcd(x, y) { return y === 0 ? x : gcd(y, x % y); }
+    console.log(gcd(Math.abs(a), Math.abs(b)));
+  </eval>
+</subroutine>
+
+<subroutine name="MATH_PRIME">
+  <eval>
+    const caller = getParams();
+    const n = parseInt(caller.attributes.n || 0);
+    if (n &lt;= 1) { console.log(0); return; }
+    if (n &lt;= 3) { console.log(1); return; }
+    if (n % 2 === 0 || n % 3 === 0) { console.log(0); return; }
+    for (let i = 5; i * i &lt;= n; i += 6) {
+      if (n % i === 0 || n % (i + 2) === 0) { console.log(0); return; }
+    }
+    console.log(1);
+  </eval>
+</subroutine>
+
+</dirac>

package/examples/lib/fileops.di

@@ -0,0 +1,26 @@
+<!-- File operations library -->
+<dirac>
+  <!-- List files in directory -->
+  <subroutine name="LIST_FILES">
+    <eval name="files">
+      return fs.readdirSync(dir || '.').join(', ');
+    </eval>
+    <output>Files: ${files}&#10;</output>
+  </subroutine>
+  
+  <!-- Count files in directory -->
+  <subroutine name="COUNT_FILES">
+    <eval name="count">
+      return fs.readdirSync(dir || '.').length;
+    </eval>
+    <output>Count: ${count}&#10;</output>
+  </subroutine>
+  
+  <!-- Check if file exists -->
+  <subroutine name="FILE_EXISTS">
+    <eval name="exists">
+      return fs.existsSync(filepath) ? 'yes' : 'no';
+    </eval>
+    <output>Exists: ${exists}&#10;</output>
+  </subroutine>
+</dirac>

package/examples/lib/math.di

@@ -0,0 +1,25 @@
+<!-- Math utility library -->
+<dirac>
+  <!-- Square a number -->
+  <subroutine name="SQUARE">
+    <eval name="result">return x * x;</eval>
+    <output>${result}</output>
+  </subroutine>
+  
+  <!-- Add two numbers -->
+  <subroutine name="ADD">
+    <eval name="result">return a + b;</eval>
+    <output>${result}</output>
+  </subroutine>
+  
+  <!-- Calculate factorial -->
+  <subroutine name="FACTORIAL">
+    <eval name="result">
+      const n = parseInt(num);
+      let fact = 1;
+      for (let i = 2; i &lt;= n; i++) fact *= i;
+      return fact;
+    </eval>
+    <output>${result}</output>
+  </subroutine>
+</dirac>

package/examples/lib/mongodb.di

@@ -0,0 +1,96 @@
+<!-- MongoDB operations library for Dirac -->
+<dirac>
+  <!-- General MongoDB subroutine: supports find, aggregate, insert, count -->
+  <subroutine name="MONGODB">
+    <parameters select="@database" />
+    <parameters select="@collection" />
+    <parameters select="@action" />
+    <defvar name="body"><parameters select="*"/></defvar>
+
+    <require_module name="mongodb" var="mongo" />
+
+    <!-- mongo is: <variable name="mongo" />
+    and the dollar sign expression : ${mongo} -->
+   <!-- the body is ${body} -->
+   
+
+
+    <eval name="result">
+   {  let output = body;
+     const uri = process.env.MONGODB_URI || 'mongodb://localhost:27017';
+     console.log("action is:", action)
+     console.log('DEBUG: body content before JSON.parse:', body);
+     const query = body ? JSON.parse(body) : {};
+     const client = new mongo.MongoClient(uri);
+ 
+      
+     try {
+        await client.connect();
+        const db = database ? client.db(database) : undefined;
+        const col = db && collection ? db.collection(collection) : undefined;
+       
+        switch (action) {
+          case 'find':
+            output = await col.find(query).toArray();
+            break;
+          case 'count':
+            output = await col.countDocuments(query);
+            break;
+          case 'aggregate':
+            output = await col.aggregate(query).toArray();
+            break;
+          case 'insert':
+            output = await col.insertOne(query);
+            break;
+          default:
+           throw new Error('unknown action for MONGODB: ' + action);
+        }
+
+        
+
+     } finally {
+        await client.close();
+     } 
+     
+     return JSON.stringify(output, null, 2);
+   }
+    </eval>
+    
+    
+
+<!--
+    <eval name="result">
+      const uri = process.env.MONGODB_URI || 'mongodb://localhost:27017';
+      // database, collection, action, and body are available as variables
+      console.log('DEBUG: body content before JSON.parse:', body);
+      const query = body ? JSON.parse(body) : {};
+      const client = new mongo.MongoClient(uri);
+      let output;
+      try {
+        await client.connect();
+        const db = database ? client.db(database) : undefined;
+        const col = db && collection ? db.collection(collection) : undefined;
+        switch (action || 'find') {
+          case 'find':
+            output = await col.find(query).toArray();
+            break;
+          case 'aggregate':
+            output = await col.aggregate(query).toArray();
+            break;
+          case 'insert':
+            output = await col.insertOne(query);
+            break;
+          case 'count':
+            output = await col.countDocuments(query);
+            break;
+          default:
+            throw new Error('Unknown action for MONGODB: ' + action);
+        }
+      } finally {
+        await client.close();
+      } 
+      return JSON.stringify(output, null, 2);
+    </eval> -->
+   <output>${result}\n</output>
+  </subroutine>
+</dirac>

package/examples/llm-agent.di

@@ -0,0 +1,32 @@
+<!-- Agent with LLM-generated operations -->
+<dirac>
+  <defvar name="task" value="create a hello world file named greeting.txt" />
+  
+  <output>Task: ${task}&#10;&#10;</output>
+  
+  <!-- Ask LLM to generate Dirac code to accomplish the task -->
+  <output>Asking LLM to generate executable code...&#10;</output>
+  <LLM output="generatedCode" maxTokens="400">
+    You are a Dirac code generator. Generate valid Dirac XML to accomplish this task:
+    "${task}"
+    
+    Available tags:
+    - &lt;dirac&gt; (root element)
+    - &lt;defvar name="x" value="y" /&gt; (define variable)
+    - &lt;output&gt;text&lt;/output&gt; (print output)
+    - &lt;eval name="result"&gt;JavaScript code&lt;/eval&gt; (run JS, has fs and path modules)
+    
+    The eval tag can use fs.writeFileSync(filename, content) to write files.
+    Variables are accessed as plain JavaScript variables (not with ${}).
+    
+    Return ONLY valid Dirac XML starting with &lt;dirac&gt; tag. No explanations.
+  </LLM>
+  
+  <output>&#10;Generated code:&#10;${generatedCode}&#10;&#10;</output>
+  
+  <!-- Execute the LLM-generated code -->
+  <output>Executing generated code...&#10;</output>
+  <execute source="generatedCode" />
+  
+  <output>&#10;Task completed!&#10;</output>
+</dirac>

package/examples/llm-basic.di

@@ -0,0 +1,12 @@
+<!-- LLM integration example - THE INNOVATION -->
+<dirac>
+  <defvar name="topic" value="quantum computing" />
+  
+  <output>Asking LLM about ${topic}...&#10;&#10;</output>
+  
+  <LLM output="response" maxTokens="200">
+    Explain ${topic} in one sentence.
+  </LLM>
+  
+  <output>Response: ${response}&#10;</output>
+</dirac>

package/examples/llm-command-no-exec.di

@@ -0,0 +1,13 @@
+<dirac>
+
+  <subroutine name="background" description="set the background color." param-color="string:required:color name" >
+    <parameters select="@color"/>
+    <output> 
+    this is my color: <variable name="color" /> 
+    </output>
+  </subroutine>
+
+  <llm >set the background color to red</llm>
+
+  
+</dirac>

package/examples/llm-command.di

@@ -0,0 +1,13 @@
+<dirac>
+
+  <subroutine name="background" description="set the background color." param-color="string:required:color name" >
+    <parameters select="@color"/>
+    <output> 
+    this is my color: <variable name="color" /> 
+    </output>
+  </subroutine>
+
+  <llm execute="true">set the background color to red</llm>
+
+  
+</dirac>

package/examples/llm-complex.di

@@ -0,0 +1,141 @@
+<dirac>
+  <!-- UI Control Services -->
+  <!-- These subroutines are exposed as natural language endpoints -->
+
+  <subroutine name="background" 
+              description="Change the background color, do not generate other tags like <changeBackground /> use precise tag"
+              param-color="string:required:Background color:red|blue|green|yellow|orange|purple|pink|white|black">
+    <parameters select="@color"/>
+              
+    <eval>
+      console.log('Changing background color to: ' + color);
+    </eval>
+  </subroutine>
+
+  <subroutine name="set-text-size"
+              description="Adjust the text size"
+              param-size="string:required:Font size:12px|14px|16px|18px|20px|24px">
+    <parameters select="@size" />
+    <eval>
+      console.log("change text size to "+size );
+      document.body.style.fontSize = '${size}';
+    </eval>
+  </subroutine>
+
+  <subroutine name="reset-styles"
+              description="Reset all styles to default">
+    <eval>
+      console.log("reset all styles back");
+      document.body.style.backgroundColor = 'white';
+      document.body.style.fontSize = '16px';
+    </eval>
+  </subroutine>
+
+  <subroutine name="text-color"
+              description="Change the text color"
+              param-color="string:required:Text color:black|white|red|blue|green">
+   <parameters select="@color" />
+    <eval>
+      console.log("change color of text to "+color);
+      document.body.style.color = '${color}';
+    </eval>
+  </subroutine>
+
+  <!-- Event Generation Examples -->
+  
+  <subroutine name="click-button"
+              description="Simulate clicking a button"
+              param-selector="string:optional:CSS selector (default: #submit-button)">
+    <eval>
+      const selector = '${selector}' || '#submit-button';
+      const element = document.querySelector(selector);
+      if (element) {
+        const clickEvent = new MouseEvent('click', {
+          bubbles: true,
+          cancelable: true,
+          view: window
+        });
+        element.dispatchEvent(clickEvent);
+      } else {
+        throw new Error('Element not found: ' + selector);
+      }
+    </eval>
+  </subroutine>
+
+  <subroutine name="type-text"
+              description="Type text into an input field"
+              param-text="string:required:Text to type"
+              param-field="string:optional:Which field:name|email">
+    <parameters select="@text" />
+    <parameters select="@field" />
+    <eval>
+      const _field = typeof field !== 'undefined' && field ? field : 'name';
+      const selector = _field === 'email' ? '#email-input' : '#name-input';
+      const input = document.querySelector(selector);
+      if (input) {
+        input.value = text;
+        input.dispatchEvent(new Event('input', { bubbles: true }));
+        input.dispatchEvent(new Event('change', { bubbles: true }));
+      } else {
+        throw new Error('Input not found: ' + selector);
+      }
+    </eval>
+  </subroutine>
+
+  <subroutine name="check-terms"
+              description="Check or uncheck the terms checkbox"
+              param-checked="string:optional:Check state:true|false">
+    <eval>
+      const shouldCheck = '${checked}' !== 'false';
+      const checkbox = document.querySelector('#terms-checkbox');
+      if (checkbox) {
+        checkbox.checked = shouldCheck;
+        checkbox.dispatchEvent(new Event('change', { bubbles: true }));
+      } else {
+        throw new Error('Checkbox not found');
+      }
+    </eval>
+  </subroutine>
+
+  <subroutine name="clear-input"
+              description="Clear an input field"
+              param-field="string:optional:Which field:name|email">
+    <eval>
+      const field = '${field}' || 'name';
+      const selector = field === 'email' ? '#email-input' : '#name-input';
+      const input = document.querySelector(selector);
+      if (input) {
+        input.value = '';
+        input.dispatchEvent(new Event('input', { bubbles: true }));
+        input.dispatchEvent(new Event('change', { bubbles: true }));
+      } else {
+        throw new Error('Input not found: ' + selector);
+      }
+    </eval>
+  </subroutine>
+
+<!--
+  <subroutine name="modify-file" 
+   description="modify a file based on pattern and replacement field "
+   param-filename="string|required"
+   param-pattern="string|required"
+   param-replace="string|required"
+  >
+   <parameters select="@filename" />
+   <parameters select="@pattern" />
+   <parameters select="@replace" />
+   <system>
+     sed -e 's/${pattern}/${replace}/g' ${filename} 
+   </system>
+  </subroutine>
+  -->
+
+ <llm noextra="true" execute="false">
+  <system>
+   ls -tl 
+  </system>
+   find me the file with name hello.di and modify the pattern of World with Zhi
+   use the command <modify-file I listed to do this.
+ </llm>
+
+</dirac>