recursive-llm-ts 5.0.2 → 5.2.3

package/README.md

@@ -44,11 +44,8 @@ npm install recursive-llm-ts
 
 ### Prerequisites
 
-- **Node.js 16+** or **Bun 1.0+**
+- **Node.js 16+**
 - **Go 1.25+** (for building from source during install)
-
-> **Note**: The package includes pre-built binaries for common platforms. Go is only needed if building from source.
-
 ### Go Binary (Automatic)
 
 The `postinstall` script automatically builds the Go binary during installation. If Go is not available, the script will warn but not fail.
@@ -72,13 +69,11 @@ export RLM_GO_BINARY=/custom/path/to/rlm-go
 
 ## Usage
 
-### Automatic Runtime Detection (Recommended)
-
+### Quick Start
 ```typescript
 import { RLM } from 'recursive-llm-ts';
 
 // Initialize RLM with a model
-// Automatically detects Node.js or Bun and uses appropriate bridge
 const rlm = new RLM('gpt-4o-mini', {
   max_iterations: 15,
   api_key: process.env.OPENAI_API_KEY
@@ -420,9 +415,6 @@ const rlmGo = new RLM('gpt-4o-mini', {
   api_key: process.env.OPENAI_API_KEY
 }, 'go');
 
-// Legacy: Use Python bridges (bunpy for Bun, pythonia for Node)
-// Note: Requires separate Python dependencies
-const rlmPython = new RLM('gpt-4o-mini', {}, 'bunpy');
 ```
 
 
@@ -781,7 +773,6 @@ interface RLMConfig {
   // Execution limits
   max_depth?: number;            // Maximum recursion depth (default: 5)
   max_iterations?: number;       // Maximum REPL iterations per call (default: 30)
-  pythonia_timeout?: number;     // Python bridge timeout in ms (default: 100000ms = 100s)
   go_binary_path?: string;       // Override path for Go binary (optional)
 
   // Meta-agent configuration
@@ -1005,7 +996,6 @@ For large documents or queue-based processing that may take longer than the defa
 ```typescript
 const rlm = new RLM('gpt-4o-mini', {
   max_iterations: 50,           // Allow more iterations for complex processing
-  pythonia_timeout: 600000,     // 10 minutes timeout for Python bridge
   timeout: 300                  // 5 minutes timeout for LLM API calls
 });
 

package/dist/cjs/bridge-factory.d.ts

@@ -0,0 +1,7 @@
+import { Bridge } from './bridge-interface';
+export type BridgeType = 'go';
+/**
+ * Create the Go bridge for RLM communication.
+ * Throws if the Go binary is not available.
+ */
+export declare function createBridge(bridgeType?: BridgeType): Promise<Bridge>;

package/dist/cjs/bridge-factory.js

@@ -0,0 +1,96 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBridge = createBridge;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const pkg_dir_1 = require("./pkg-dir");
+const DEFAULT_GO_BINARY = process.platform === 'win32' ? 'rlm-go.exe' : 'rlm-go';
+function resolveDefaultGoBinary() {
+    return path.join(pkg_dir_1.PKG_ROOT_DIR, 'bin', DEFAULT_GO_BINARY);
+}
+/** Platform-specific npm package names for pre-built binaries */
+const PLATFORM_PACKAGES = {
+    'darwin-arm64': '@recursive-llm/darwin-arm64',
+    'darwin-x64': '@recursive-llm/darwin-x64',
+    'linux-x64': '@recursive-llm/linux-x64',
+    'linux-arm64': '@recursive-llm/linux-arm64',
+    'win32-x64': '@recursive-llm/win32-x64',
+};
+function isPlatformBinaryAvailable() {
+    const key = `${process.platform}-${process.arch}`;
+    const pkgName = PLATFORM_PACKAGES[key];
+    if (!pkgName)
+        return false;
+    try {
+        const pkgDir = path.dirname(require.resolve(`${pkgName}/package.json`));
+        return fs.existsSync(path.join(pkgDir, 'bin', DEFAULT_GO_BINARY));
+    }
+    catch (_a) {
+        return false;
+    }
+}
+function isGoBinaryAvailable() {
+    const envPath = process.env.RLM_GO_BINARY;
+    if (envPath && fs.existsSync(envPath)) {
+        return true;
+    }
+    if (isPlatformBinaryAvailable())
+        return true;
+    return fs.existsSync(resolveDefaultGoBinary());
+}
+/**
+ * Create the Go bridge for RLM communication.
+ * Throws if the Go binary is not available.
+ */
+function createBridge() {
+    return __awaiter(this, arguments, void 0, function* (bridgeType = 'go') {
+        if (!isGoBinaryAvailable()) {
+            throw new Error('Go RLM binary not found. Build it with: node scripts/build-go-binary.js\n' +
+                'Ensure Go 1.25+ is installed: https://go.dev/dl/');
+        }
+        const { GoBridge } = yield Promise.resolve().then(() => __importStar(require('./go-bridge')));
+        return new GoBridge();
+    });
+}

package/dist/{bridge-interface.d.ts → cjs/bridge-interface.d.ts}

@@ -205,7 +205,6 @@ export interface RLMConfig {
     api_key?: string;
     max_depth?: number;
     max_iterations?: number;
-    pythonia_timeout?: number;
     go_binary_path?: string;
     meta_agent?: MetaAgentConfig;
     observability?: ObservabilityConfig;
@@ -264,7 +263,7 @@ export interface FileStorageConfig {
     /** File extensions to include (e.g. ['.ts', '.md', '.txt']) */
     extensions?: string[];
 }
-export interface PythonBridge {
+export interface Bridge {
     completion(model: string, query: string, context: string, rlmConfig: RLMConfig): Promise<RLMResult>;
     cleanup(): Promise<void>;
 }

package/dist/{config.js → cjs/config.js}

@@ -15,7 +15,6 @@ const KNOWN_CONFIG_KEYS = new Set([
     'api_key',
     'max_depth',
     'max_iterations',
-    'pythonia_timeout',
     'go_binary_path',
     'meta_agent',
     'observability',
@@ -58,11 +57,6 @@ function validateConfig(config) {
             issues.push({ level: 'error', field: 'max_iterations', message: 'max_iterations must be a positive integer' });
         }
     }
-    if (config.pythonia_timeout !== undefined) {
-        if (typeof config.pythonia_timeout !== 'number' || config.pythonia_timeout < 0) {
-            issues.push({ level: 'error', field: 'pythonia_timeout', message: 'pythonia_timeout must be a non-negative number (milliseconds)' });
-        }
-    }
     // Validate API base URL
     if (config.api_base !== undefined && typeof config.api_base === 'string') {
         try {

package/dist/{coordinator.js → cjs/coordinator.js}

@@ -12,7 +12,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.RLMAgentCoordinator = void 0;
 const rlm_1 = require("./rlm");
 class RLMAgentCoordinator {
-    constructor(model, rlmConfig = {}, bridgeType = 'auto', coordinatorConfig = {}) {
+    constructor(model, rlmConfig = {}, bridgeType = 'go', coordinatorConfig = {}) {
         var _a, _b, _c;
         this.rlm = new rlm_1.RLM(model, rlmConfig, bridgeType);
         this.config = {

package/dist/{go-bridge.d.ts → cjs/go-bridge.d.ts}

@@ -1,5 +1,5 @@
-import { PythonBridge, RLMConfig, RLMResult } from './bridge-interface';
-export declare class GoBridge implements PythonBridge {
+import { Bridge, RLMConfig, RLMResult } from './bridge-interface';
+export declare class GoBridge implements Bridge {
     completion(model: string, query: string, context: string, rlmConfig?: RLMConfig): Promise<RLMResult>;
     cleanup(): Promise<void>;
 }

package/dist/{go-bridge.js → cjs/go-bridge.js}

@@ -57,16 +57,48 @@ exports.GoBridge = void 0;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const child_process_1 = require("child_process");
+const pkg_dir_1 = require("./pkg-dir");
 const DEFAULT_BINARY_NAME = process.platform === 'win32' ? 'rlm-go.exe' : 'rlm-go';
+/** Platform-specific npm package names for pre-built binaries */
+const PLATFORM_PACKAGES = {
+    'darwin-arm64': '@recursive-llm/darwin-arm64',
+    'darwin-x64': '@recursive-llm/darwin-x64',
+    'linux-x64': '@recursive-llm/linux-x64',
+    'linux-arm64': '@recursive-llm/linux-arm64',
+    'win32-x64': '@recursive-llm/win32-x64',
+};
+function resolvePlatformBinary() {
+    const platform = process.platform;
+    const arch = process.arch;
+    const key = `${platform}-${arch}`;
+    const pkgName = PLATFORM_PACKAGES[key];
+    if (!pkgName)
+        return null;
+    try {
+        // require.resolve works in both CJS and ESM (via createRequire)
+        const pkgDir = path.dirname(require.resolve(`${pkgName}/package.json`));
+        const binPath = path.join(pkgDir, 'bin', DEFAULT_BINARY_NAME);
+        if (fs.existsSync(binPath))
+            return binPath;
+    }
+    catch (_a) {
+        // Package not installed — fall through
+    }
+    return null;
+}
 function resolveBinaryPath(rlmConfig) {
     const configuredPath = rlmConfig.go_binary_path || process.env.RLM_GO_BINARY;
     if (configuredPath) {
         return configuredPath;
     }
-    // Try multiple locations
+    // 1. Try platform-specific npm package (pre-built binary)
+    const platformBin = resolvePlatformBinary();
+    if (platformBin)
+        return platformBin;
+    // 2. Try local locations
     const possiblePaths = [
-        path.join(__dirname, '..', 'bin', DEFAULT_BINARY_NAME), // NPM package (primary)
-        path.join(__dirname, '..', 'go', DEFAULT_BINARY_NAME), // Development fallback
+        path.join(pkg_dir_1.PKG_ROOT_DIR, 'bin', DEFAULT_BINARY_NAME), // NPM package (primary)
+        path.join(pkg_dir_1.PKG_ROOT_DIR, 'go', DEFAULT_BINARY_NAME), // Development fallback
     ];
     for (const p of possiblePaths) {
         if (fs.existsSync(p)) {
@@ -82,7 +114,7 @@ function assertBinaryExists(binaryPath) {
     }
 }
 function sanitizeConfig(config) {
-    const { pythonia_timeout, go_binary_path, structured } = config, sanitized = __rest(config, ["pythonia_timeout", "go_binary_path", "structured"]);
+    const { go_binary_path, structured } = config, sanitized = __rest(config, ["go_binary_path", "structured"]);
     return { config: sanitized, structured };
 }
 class GoBridge {

package/dist/cjs/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/dist/cjs/pkg-dir.d.ts

@@ -0,0 +1,7 @@
+/** Directory containing the compiled JS file (dist/cjs or dist/esm or dist) */
+export declare const PKG_DIST_DIR: string;
+/**
+ * Package root directory.
+ * Handles both flat (dist/) and nested (dist/cjs/, dist/esm/) layouts.
+ */
+export declare const PKG_ROOT_DIR: string;

package/dist/cjs/pkg-dir.js

@@ -0,0 +1,79 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PKG_ROOT_DIR = exports.PKG_DIST_DIR = void 0;
+/**
+ * Portable package directory resolution.
+ *
+ * Works in both CommonJS and ESM contexts by detecting the available
+ * globals and falling back gracefully. The resolved path always points
+ * to the package root (parent of the dist/cjs or dist/esm directory).
+ */
+const path = __importStar(require("path"));
+const url_1 = require("url");
+function resolveCurrentDir() {
+    // CJS — __dirname is defined natively by Node
+    if (typeof __dirname !== 'undefined') {
+        return __dirname;
+    }
+    // ESM — derive from import.meta.url via indirect eval to avoid CJS parse errors.
+    // This branch only runs in ESM where import.meta is valid syntax.
+    try {
+        const meta = new Function('return import.meta')();
+        if (meta && typeof meta.url === 'string') {
+            return path.dirname((0, url_1.fileURLToPath)(meta.url));
+        }
+    }
+    catch (_a) {
+        // Not in ESM or import.meta not supported
+    }
+    // Last resort: use process.cwd()
+    return process.cwd();
+}
+/** Directory containing the compiled JS file (dist/cjs or dist/esm or dist) */
+exports.PKG_DIST_DIR = resolveCurrentDir();
+/**
+ * Package root directory.
+ * Handles both flat (dist/) and nested (dist/cjs/, dist/esm/) layouts.
+ */
+exports.PKG_ROOT_DIR = (() => {
+    const parent = path.dirname(exports.PKG_DIST_DIR);
+    const parentBase = path.basename(parent);
+    // If parent is 'dist', we're in dist/cjs or dist/esm — go up one more
+    if (parentBase === 'dist') {
+        return path.dirname(parent);
+    }
+    return parent;
+})();

package/dist/{rlm.d.ts → cjs/rlm.d.ts}

@@ -111,7 +111,7 @@ export declare class RLM {
      *
      * @param model - The LLM model identifier (e.g., 'gpt-4o-mini', 'claude-sonnet-4-20250514')
      * @param rlmConfig - Configuration options for the RLM engine
-     * @param bridgeType - Bridge selection: 'auto' (default), 'go', 'pythonia', 'bunpy'
+     * @param bridgeType - Bridge selection: 'go' (default)
      *
      * @example
      * ```typescript

package/dist/{rlm.js → cjs/rlm.js}

@@ -119,7 +119,7 @@ exports.RLMResultFormatter = RLMResultFormatter;
 class RLMBuilder {
     constructor(model) {
         this.config = {};
-        this.bridgeType = 'auto';
+        this.bridgeType = 'go';
         this.model = model;
     }
     /** Set the API key */
@@ -208,7 +208,7 @@ class RLM {
      *
      * @param model - The LLM model identifier (e.g., 'gpt-4o-mini', 'claude-sonnet-4-20250514')
      * @param rlmConfig - Configuration options for the RLM engine
-     * @param bridgeType - Bridge selection: 'auto' (default), 'go', 'pythonia', 'bunpy'
+     * @param bridgeType - Bridge selection: 'go' (default)
      *
      * @example
      * ```typescript
@@ -220,7 +220,7 @@ class RLM {
      * });
      * ```
      */
-    constructor(model, rlmConfig = {}, bridgeType = 'auto') {
+    constructor(model, rlmConfig = {}, bridgeType = 'go') {
         this.bridge = null;
         this.lastTraceEvents = [];
         this.model = model;

package/dist/esm/bridge-factory.d.ts

@@ -0,0 +1,7 @@
+import { Bridge } from './bridge-interface';
+export type BridgeType = 'go';
+/**
+ * Create the Go bridge for RLM communication.
+ * Throws if the Go binary is not available.
+ */
+export declare function createBridge(bridgeType?: BridgeType): Promise<Bridge>;

package/dist/esm/bridge-factory.js

@@ -0,0 +1,60 @@
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+import * as fs from 'fs';
+import * as path from 'path';
+import { PKG_ROOT_DIR } from './pkg-dir.js';
+const DEFAULT_GO_BINARY = process.platform === 'win32' ? 'rlm-go.exe' : 'rlm-go';
+function resolveDefaultGoBinary() {
+    return path.join(PKG_ROOT_DIR, 'bin', DEFAULT_GO_BINARY);
+}
+/** Platform-specific npm package names for pre-built binaries */
+const PLATFORM_PACKAGES = {
+    'darwin-arm64': '@recursive-llm/darwin-arm64',
+    'darwin-x64': '@recursive-llm/darwin-x64',
+    'linux-x64': '@recursive-llm/linux-x64',
+    'linux-arm64': '@recursive-llm/linux-arm64',
+    'win32-x64': '@recursive-llm/win32-x64',
+};
+function isPlatformBinaryAvailable() {
+    const key = `${process.platform}-${process.arch}`;
+    const pkgName = PLATFORM_PACKAGES[key];
+    if (!pkgName)
+        return false;
+    try {
+        const pkgDir = path.dirname(require.resolve(`${pkgName}/package.json`));
+        return fs.existsSync(path.join(pkgDir, 'bin', DEFAULT_GO_BINARY));
+    }
+    catch (_a) {
+        return false;
+    }
+}
+function isGoBinaryAvailable() {
+    const envPath = process.env.RLM_GO_BINARY;
+    if (envPath && fs.existsSync(envPath)) {
+        return true;
+    }
+    if (isPlatformBinaryAvailable())
+        return true;
+    return fs.existsSync(resolveDefaultGoBinary());
+}
+/**
+ * Create the Go bridge for RLM communication.
+ * Throws if the Go binary is not available.
+ */
+export function createBridge() {
+    return __awaiter(this, arguments, void 0, function* (bridgeType = 'go') {
+        if (!isGoBinaryAvailable()) {
+            throw new Error('Go RLM binary not found. Build it with: node scripts/build-go-binary.js\n' +
+                'Ensure Go 1.25+ is installed: https://go.dev/dl/');
+        }
+        const { GoBridge } = yield import('./go-bridge.js');
+        return new GoBridge();
+    });
+}