recursive-llm-ts 5.0.2 → 5.1.1

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/bridge-factory.d.ts

@@ -1,6 +1,7 @@
-import { PythonBridge } from './bridge-interface';
-export type BridgeType = 'go' | 'pythonia' | 'bunpy' | 'auto';
+import { Bridge } from './bridge-interface';
+export type BridgeType = 'go';
 /**
- * Create appropriate Python bridge based on runtime or explicit choice
+ * Create the Go bridge for RLM communication.
+ * Throws if the Go binary is not available.
  */
-export declare function createBridge(bridgeType?: BridgeType): Promise<PythonBridge>;
+export declare function createBridge(bridgeType?: BridgeType): Promise<Bridge>;

package/dist/bridge-factory.js

@@ -57,78 +57,16 @@ function isGoBinaryAvailable() {
     return fs.existsSync(resolveDefaultGoBinary());
 }
 /**
- * Detect the current JavaScript runtime
- */
-function detectRuntime() {
-    // Check for Bun
-    if (typeof globalThis.Bun !== 'undefined') {
-        return 'bun';
-    }
-    // Check for Node.js
-    if (typeof process !== 'undefined' && process.versions && process.versions.node) {
-        return 'node';
-    }
-    return 'unknown';
-}
-/**
- * Create appropriate Python bridge based on runtime or explicit choice
+ * 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 = 'auto') {
-        let selectedBridge;
-        if (bridgeType === 'auto') {
-            if (isGoBinaryAvailable()) {
-                selectedBridge = 'go';
-            }
-            else {
-                const runtime = detectRuntime();
-                if (runtime === 'bun') {
-                    selectedBridge = 'bunpy';
-                }
-                else if (runtime === 'node') {
-                    selectedBridge = 'pythonia';
-                }
-                else {
-                    throw new Error('Unable to detect runtime. Please explicitly specify bridge type.\n' +
-                        'Supported runtimes: Go binary, Node.js (pythonia), or Bun (bunpy)');
-                }
-            }
-        }
-        else {
-            selectedBridge = bridgeType;
-        }
-        if (selectedBridge === 'go') {
-            const { GoBridge } = yield Promise.resolve().then(() => __importStar(require('./go-bridge')));
-            return new GoBridge();
-        }
-        if (selectedBridge === 'bunpy') {
-            try {
-                const { BunpyBridge } = yield Promise.resolve().then(() => __importStar(require('./bunpy-bridge')));
-                return new BunpyBridge();
-            }
-            catch (error) {
-                const errorMsg = (error === null || error === void 0 ? void 0 : error.code) === 'MODULE_NOT_FOUND'
-                    ? 'bunpy bridge not available (Python dependencies removed in v3.0)'
-                    : error.message;
-                if (bridgeType === 'auto') {
-                    console.warn(`[recursive-llm-ts] ${errorMsg}, falling back to pythonia`);
-                    selectedBridge = 'pythonia';
-                }
-                else {
-                    throw new Error(`${errorMsg}. Use 'go' bridge instead (default in v3.0).`);
-                }
-            }
-        }
-        if (selectedBridge === 'pythonia') {
-            try {
-                const { PythoniaBridge } = yield Promise.resolve().then(() => __importStar(require('./rlm-bridge')));
-                return new PythoniaBridge();
-            }
-            catch (error) {
-                throw new Error('pythonia bridge not available (Python dependencies removed in v3.0). ' +
-                    'Use the Go bridge instead (default) or install bunpy/pythonia separately.');
-            }
+    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/');
         }
-        throw new Error('Failed to initialize bridge');
+        const { GoBridge } = yield Promise.resolve().then(() => __importStar(require('./go-bridge')));
+        return new GoBridge();
     });
 }

package/dist/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

@@ -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

@@ -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

@@ -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

@@ -82,7 +82,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/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

@@ -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/package.json

@@ -1,9 +1,16 @@
 {
   "name": "recursive-llm-ts",
-  "version": "5.0.2",
+  "version": "5.1.1",
   "description": "TypeScript bridge for recursive-llm: Recursive Language Models for unbounded context processing with structured outputs",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
   "files": [
     "dist",
     "go/cmd",
@@ -66,5 +73,13 @@
     "ts-node": "^10.9.2",
     "typescript": "^5.3.3",
     "vitest": "^4.0.18"
+  },
+  "peerDependencies": {
+    "@aws-sdk/client-s3": "^3.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@aws-sdk/client-s3": {
+      "optional": true
+    }
   }
 }

package/scripts/build-go-binary.js

@@ -19,21 +19,34 @@ function goAvailable() {
 }
 
 if (!fs.existsSync(goRoot)) {
-  console.warn('[recursive-llm-ts] Go source directory not found; skipping Go build');
+  // No Go source — this is fine for pre-built binary installs
+  process.exit(0);
+}
+
+if (fs.existsSync(binaryPath)) {
+  console.log('[recursive-llm-ts] ✓ Go binary already exists at ' + binaryPath);
   process.exit(0);
 }
 
 if (!goAvailable()) {
-  console.warn('[recursive-llm-ts] Go is not installed; skipping Go binary build');
-  console.warn('[recursive-llm-ts] Install Go 1.25+ and rerun: node scripts/build-go-binary.js');
+  console.warn('');
+  console.warn('╔══════════════════════════════════════════════════════════════════╗');
+  console.warn('║  recursive-llm-ts: Go binary could not be built                 ║');
+  console.warn('║                                                                  ║');
+  console.warn('║  Go 1.25+ is required to compile the backend binary.             ║');
+  console.warn('║  Without it, all RLM operations will fail at runtime.            ║');
+  console.warn('║                                                                  ║');
+  console.warn('║  Install Go: https://go.dev/dl/                                  ║');
+  console.warn('║  Then run:   node scripts/build-go-binary.js                     ║');
+  console.warn('╚══════════════════════════════════════════════════════════════════╝');
+  console.warn('');
   process.exit(0);
 }
 
 try {
   fs.mkdirSync(binDir, { recursive: true });
-  // Build with optimization: -s removes symbol table, -w removes DWARF debug info
   execFileSync('go', ['build', '-ldflags=-s -w', '-o', binaryPath, './cmd/rlm'], { stdio: 'inherit', cwd: goRoot });
-  console.log(`[recursive-llm-ts] ✓ Go binary built at ${binaryPath}`);
+  console.log('[recursive-llm-ts] ✓ Go binary built at ' + binaryPath);
 } catch (error) {
   console.warn('[recursive-llm-ts] Warning: Failed to build Go binary');
   console.warn(error.message || error);

package/dist/bunpy-bridge.d.ts

@@ -1,7 +0,0 @@
-import { PythonBridge, RLMConfig, RLMResult } from './bridge-interface';
-export declare class BunpyBridge implements PythonBridge {
-    constructor();
-    initialize(_model: string, _config: RLMConfig): Promise<void>;
-    completion(_query: string, _context: string): Promise<RLMResult>;
-    cleanup(): Promise<void>;
-}

package/dist/bunpy-bridge.js

@@ -1,37 +0,0 @@
-"use strict";
-// Stub file for bunpy bridge (removed in v3.0)
-// Python dependencies are no longer included by default
-// To use bunpy bridge, install: npm install bunpy
-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.BunpyBridge = void 0;
-class BunpyBridge {
-    constructor() {
-        throw new Error('bunpy bridge is not available (Python dependencies removed in v3.0). ' +
-            'Please use the Go bridge (default) or install bunpy separately: npm install bunpy');
-    }
-    initialize(_model, _config) {
-        return __awaiter(this, void 0, void 0, function* () {
-            throw new Error('bunpy bridge not available');
-        });
-    }
-    completion(_query, _context) {
-        return __awaiter(this, void 0, void 0, function* () {
-            throw new Error('bunpy bridge not available');
-        });
-    }
-    cleanup() {
-        return __awaiter(this, void 0, void 0, function* () {
-            // No-op
-        });
-    }
-}
-exports.BunpyBridge = BunpyBridge;

package/dist/rlm-bridge.d.ts

@@ -1,8 +0,0 @@
-import { PythonBridge, RLMConfig, RLMResult } from './bridge-interface';
-export declare class PythoniaBridge implements PythonBridge {
-    private rlmModule;
-    private python;
-    private ensureRLMModule;
-    completion(model: string, query: string, context: string, rlmConfig?: RLMConfig): Promise<RLMResult>;
-    cleanup(): Promise<void>;
-}

package/dist/rlm-bridge.js

@@ -1,179 +0,0 @@
-"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());
-    });
-};
-var __rest = (this && this.__rest) || function (s, e) {
-    var t = {};
-    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
-        t[p] = s[p];
-    if (s != null && typeof Object.getOwnPropertySymbols === "function")
-        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
-            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
-                t[p[i]] = s[p[i]];
-        }
-    return t;
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PythoniaBridge = void 0;
-const path = __importStar(require("path"));
-const fs = __importStar(require("fs"));
-class PythoniaBridge {
-    constructor() {
-        this.rlmModule = null;
-        this.python = null;
-    }
-    ensureRLMModule() {
-        return __awaiter(this, void 0, void 0, function* () {
-            var _a;
-            if (this.rlmModule)
-                return;
-            // Lazy load pythonia to avoid errors in Bun environments
-            if (!this.python) {
-                try {
-                    // @ts-ignore - Optional dependency, may not be installed
-                    const pythonia = yield Promise.resolve().then(() => __importStar(require('pythonia')));
-                    this.python = pythonia.python;
-                }
-                catch (error) {
-                    throw new Error('pythonia is not available (Python dependencies removed in v3.0). ' +
-                        'Please use the Go bridge (default) or install pythonia separately: npm install pythonia\n' +
-                        'Note: pythonia only works with Node.js runtime, not Bun');
-                }
-            }
-            const pythonPackagePath = path.join(__dirname, '..', 'recursive-llm');
-            // Import sys module to add path
-            const sys = yield this.python('sys');
-            const pythonExecutable = String((yield sys.executable) || 'python');
-            const pythonCmd = pythonExecutable.includes(' ') ? `"${pythonExecutable}"` : pythonExecutable;
-            const pipCmd = `${pythonCmd} -m pip install -e "${pythonPackagePath}"`;
-            const pythonDepsPath = path.join(pythonPackagePath, '.pydeps');
-            const pyprojectPath = path.join(pythonPackagePath, 'pyproject.toml');
-            const dependencySpecifiers = (() => {
-                try {
-                    const pyproject = fs.readFileSync(pyprojectPath, 'utf8');
-                    const depsBlock = pyproject.match(/dependencies\s*=\s*\[[\s\S]*?\]/);
-                    if (!depsBlock)
-                        return [];
-                    return Array.from(depsBlock[0].matchAll(/"([^"]+)"/g), (match) => match[1]);
-                }
-                catch (_a) {
-                    return [];
-                }
-            })();
-            const depsInstallCmd = dependencySpecifiers.length > 0
-                ? `${pythonCmd} -m pip install --upgrade --target "${pythonDepsPath}" ${dependencySpecifiers.map((dep) => `"${dep}"`).join(' ')}`
-                : '';
-            const installCmd = depsInstallCmd || pipCmd;
-            const pathList = yield sys.path;
-            fs.mkdirSync(pythonDepsPath, { recursive: true });
-            yield pathList.insert(0, pythonDepsPath);
-            yield pathList.insert(0, path.join(pythonPackagePath, 'src'));
-            // Try to import rlm, install deps if import fails
-            try {
-                this.rlmModule = yield this.python('rlm');
-            }
-            catch (error) {
-                // If import fails, try installing dependencies
-                if ((_a = error.message) === null || _a === void 0 ? void 0 : _a.includes('No module named')) {
-                    console.log('[recursive-llm-ts] Installing Python dependencies locally (first time only)...');
-                    try {
-                        const { execSync } = yield Promise.resolve().then(() => __importStar(require('child_process')));
-                        execSync(installCmd, { stdio: 'inherit' });
-                        console.log('[recursive-llm-ts] ✓ Python dependencies installed');
-                        // Try import again
-                        this.rlmModule = yield this.python('rlm');
-                    }
-                    catch (installError) {
-                        throw new Error('Failed to import rlm module after installing dependencies.\n' +
-                            `Manual installation: ${installCmd}\n` +
-                            `Error: ${installError.message || installError}`);
-                    }
-                }
-                else {
-                    throw new Error('Failed to import rlm module.\n' +
-                        `Run: ${installCmd}\n` +
-                        `Original error: ${error.message || error}`);
-                }
-            }
-        });
-    }
-    completion(model_1, query_1, context_1) {
-        return __awaiter(this, arguments, void 0, function* (model, query, context, rlmConfig = {}) {
-            yield this.ensureRLMModule();
-            try {
-                // Extract pythonia timeout (default: 100000ms)
-                const pythoniaTimeout = rlmConfig.pythonia_timeout || 100000;
-                // Remove pythonia_timeout from config passed to Python
-                const { pythonia_timeout } = rlmConfig, pythonConfig = __rest(rlmConfig, ["pythonia_timeout"]);
-                // Create RLM instance with config, passing timeout to pythonia
-                const RLMClass = yield this.rlmModule.RLM;
-                const rlmInstance = yield RLMClass(model, Object.assign(Object.assign({}, pythonConfig), { $timeout: pythoniaTimeout }));
-                // Call completion method with timeout
-                const result = yield rlmInstance.completion(query, context, { $timeout: pythoniaTimeout });
-                const stats = yield rlmInstance.stats;
-                // Convert Python stats dict to JS object
-                const statsObj = {
-                    llm_calls: yield stats.llm_calls,
-                    iterations: yield stats.iterations,
-                    depth: yield stats.depth
-                };
-                return {
-                    result: String(result),
-                    stats: statsObj
-                };
-            }
-            catch (error) {
-                throw new Error(`RLM completion failed: ${error.message || error}`);
-            }
-        });
-    }
-    cleanup() {
-        return __awaiter(this, void 0, void 0, function* () {
-            if (this.python && this.rlmModule) {
-                this.python.exit();
-                this.rlmModule = null;
-                this.python = null;
-            }
-        });
-    }
-}
-exports.PythoniaBridge = PythoniaBridge;