@goreal-ai/echo-pdk 0.8.1 → 0.10.0

package/scripts/bundle-for-graaljs.mjs

@@ -30,9 +30,12 @@ async function bundle() {
       'process.env': '{}',
       'process': '{"env":{}}',
     },
-    // Stub out crypto - only used for AI judge caching which we skip in Java
+    // Stub out Node.js built-ins not available in GraalJS
     alias: {
       'crypto': join(__dirname, 'stubs', 'crypto.mjs'),
+      'fs/promises': join(__dirname, 'stubs', 'fs-promises.mjs'),
+      'fs': join(__dirname, 'stubs', 'fs.mjs'),
+      'path': join(__dirname, 'stubs', 'path.mjs'),
     },
   });
 
@@ -142,6 +145,8 @@ var echoPdk = {
           }
         } else if (node.type === 'section') {
           visit(node.body);
+        } else if (node.type === 'role') {
+          visit(node.body);
         }
       }
     }
@@ -205,6 +210,39 @@ var echoPdk = {
    */
   runPrompt: function(options) {
     return EchoPDK.runPrompt(options);
+  },
+
+  /**
+   * Render a template to structured messages, tool definitions, and meta config (async).
+   * Returns { messages: [{ role, content }], tools: [{ type, function }], meta: {} }.
+   * @param {string} template - The Echo DSL template with [#ROLE] and [#TOOL] blocks
+   * @param {Object} context - Variables to substitute
+   * @param {Object} [config] - Optional configuration (may include metaTemplate)
+   * @returns {Promise<Object>} - { messages, tools, meta }
+   */
+  renderMessages: function(template, context, config) {
+    var metaTemplate = config && config.metaTemplate;
+    var echoConfig = {};
+    if (config) {
+      Object.keys(config).forEach(function(k) {
+        if (k !== 'metaTemplate') echoConfig[k] = config[k];
+      });
+    }
+    var echo = EchoPDK.createEcho(echoConfig);
+    var options = metaTemplate ? { metaTemplate: metaTemplate } : undefined;
+    return echo.renderMessages(template, context || {}, options).then(function(result) {
+      // Simplify content blocks to plain strings for Java interop
+      return {
+        messages: result.messages.map(function(m) {
+          var text = m.content.map(function(b) {
+            return b.type === 'text' ? b.text : '';
+          }).join('');
+          return { role: m.role, content: text };
+        }),
+        tools: result.tools,
+        meta: result.meta || {}
+      };
+    });
   }
 };
 `;

package/scripts/stubs/fs-promises.mjs

@@ -0,0 +1,27 @@
+/**
+ * fs/promises stub for GraalJS bundle.
+ * File system operations are only used by the CLI eval runner (loader.ts, dataset.ts, runner.ts).
+ * In Java, datasets and eval runs are managed via the database, not the filesystem.
+ */
+
+export async function readFile() {
+  throw new Error('fs/promises.readFile is not available in GraalJS');
+}
+
+export async function writeFile() {
+  throw new Error('fs/promises.writeFile is not available in GraalJS');
+}
+
+export async function readdir() {
+  throw new Error('fs/promises.readdir is not available in GraalJS');
+}
+
+export async function stat() {
+  throw new Error('fs/promises.stat is not available in GraalJS');
+}
+
+export async function mkdir() {
+  throw new Error('fs/promises.mkdir is not available in GraalJS');
+}
+
+export default { readFile, writeFile, readdir, stat, mkdir };

package/scripts/stubs/fs.mjs

@@ -0,0 +1,18 @@
+/**
+ * fs stub for GraalJS bundle.
+ * File system operations are not available in the GraalJS runtime.
+ */
+
+export function readFileSync() {
+  throw new Error('fs.readFileSync is not available in GraalJS');
+}
+
+export function writeFileSync() {
+  throw new Error('fs.writeFileSync is not available in GraalJS');
+}
+
+export function existsSync() {
+  return false;
+}
+
+export default { readFileSync, writeFileSync, existsSync };

package/scripts/stubs/path.mjs

@@ -0,0 +1,33 @@
+/**
+ * path stub for GraalJS bundle.
+ * Path operations are only used by the CLI eval runner (dataset.ts, runner.ts).
+ * In Java, file paths are managed by the JVM, not JavaScript.
+ */
+
+export function join(...parts) {
+  return parts.filter(Boolean).join('/');
+}
+
+export function resolve(...parts) {
+  return parts.filter(Boolean).join('/');
+}
+
+export function dirname(p) {
+  const i = p.lastIndexOf('/');
+  return i >= 0 ? p.substring(0, i) : '.';
+}
+
+export function basename(p, ext) {
+  let base = p.substring(p.lastIndexOf('/') + 1);
+  if (ext && base.endsWith(ext)) {
+    base = base.substring(0, base.length - ext.length);
+  }
+  return base;
+}
+
+export function extname(p) {
+  const i = p.lastIndexOf('.');
+  return i >= 0 ? p.substring(i) : '';
+}
+
+export default { join, resolve, dirname, basename, extname };