@cloudwarriors-ai/rlm 0.1.5

package/README.md

@@ -0,0 +1,208 @@
+# @cloudwarriors-ai/rlm
+
+Recursive Language Model - Process massive contexts (10M+ tokens) through recursive LLM decomposition.
+
+## Overview
+
+RLM enables processing of contexts far larger than typical LLM context windows by:
+
+1. Treating content as Python REPL variables
+2. Having the LLM write code to decompose and process chunks
+3. Recursively calling itself with subsets of context
+4. Aggregating results into a final answer
+
+## Installation
+
+```bash
+# From GitHub Packages (requires auth)
+npm install @cloudwarriors-ai/rlm
+
+# Or link locally during development
+npm link /path/to/rlm
+```
+
+## Quick Start
+
+```typescript
+import { createRLM } from '@cloudwarriors-ai/rlm';
+import fs from 'node:fs';
+
+const rlm = createRLM({
+  apiKey: process.env.OPENROUTER_API_KEY,
+});
+
+const result = await rlm.query(
+  fs.readFileSync('./massive-codebase.txt', 'utf-8'),
+  'Find all security vulnerabilities'
+);
+
+console.log(result.answer);
+console.log(`Cost: $${result.usage.costUsd.toFixed(4)}`);
+```
+
+## CLI Usage
+
+```bash
+# Install globally
+npm install -g @cloudwarriors-ai/rlm
+
+# Initialize config
+rlm config init
+rlm config set apiKey YOUR_OPENROUTER_API_KEY
+
+# Run a query
+rlm query --file ./large-file.txt --query "Summarize this document"
+
+# With options
+rlm query \
+  --file ./codebase.txt \
+  --query "Find security issues" \
+  --max-depth 5 \
+  --max-cost 5.00 \
+  --verbose
+```
+
+## Configuration
+
+### Environment Variables
+
+```bash
+OPENROUTER_API_KEY=sk-or-...     # Required
+RLM_MODEL=anthropic/claude-sonnet-4  # Default model
+RLM_MAX_DEPTH=5                   # Max recursion depth
+RLM_MAX_COST_USD=10               # Max cost per session
+RLM_MAX_TOKENS=1000000            # Max total tokens
+RLM_TIMEOUT_SECONDS=300           # Session timeout
+RLM_SANDBOX_MODE=strict           # strict|permissive|disabled
+```
+
+### Config File
+
+Create `~/.rlm/config.json`:
+
+```json
+{
+  "apiKey": "sk-or-...",
+  "model": "anthropic/claude-sonnet-4",
+  "maxRecursionDepth": 5,
+  "maxCostUsd": 10,
+  "maxTokens": 1000000,
+  "timeoutMs": 300000
+}
+```
+
+## API Reference
+
+### createRLM(options)
+
+Create an RLM service instance.
+
+```typescript
+const rlm = createRLM({
+  apiKey: 'sk-or-...',
+  model: 'anthropic/claude-sonnet-4',
+  config: {
+    maxRecursionDepth: 5,
+    maxCostUsd: 10,
+  },
+});
+```
+
+### rlm.query(context, query, config?)
+
+Execute an RLM query.
+
+```typescript
+const result = await rlm.query(
+  context,  // string or ContextInput
+  'Your question',
+  { maxRecursionDepth: 3 }  // optional overrides
+);
+```
+
+Returns `RLMResult`:
+
+```typescript
+interface RLMResult {
+  sessionId: string;
+  answer: string;
+  success: boolean;
+  error?: string;
+  trace: ExecutionTrace;
+  usage: ResourceUsage;
+}
+```
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                         CLI Layer                                │
+│                    (src/cli/)                                    │
+└─────────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+┌─────────────────────────────────────────────────────────────────┐
+│                     Application Layer                            │
+│                    (src/application/)                            │
+│         RLMService - orchestrates use cases                      │
+└─────────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+┌─────────────────────────────────────────────────────────────────┐
+│                       Domain Layer                               │
+│                    (src/domain/)                                 │
+│         Pure business logic, types, interfaces                   │
+└─────────────────────────────────────────────────────────────────┘
+                              │
+                              ▼
+┌─────────────────────────────────────────────────────────────────┐
+│                   Infrastructure Layer                           │
+│              (src/infrastructure/)                               │
+│         LLM providers, Python executor, persistence              │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+## Integration with Hermes
+
+```typescript
+// In Hermes project
+import { createRLM } from '@cloudwarriors-ai/rlm';
+import { db } from './db';
+import { eventBus } from './events';
+
+const rlm = createRLM({
+  apiKey: process.env.OPENROUTER_API_KEY,
+  sessionStore: new DrizzleSessionStore(db),
+  eventBus,
+});
+
+// Use in API routes
+app.post('/api/rlm/query', async (req, res) => {
+  const result = await rlm.query(req.body.context, req.body.query);
+  res.json(result);
+});
+```
+
+## Development
+
+```bash
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Run tests
+npm test
+
+# Type check
+npm run lint
+
+# Watch mode
+npm run dev
+```
+
+## License
+
+UNLICENSED - Private package for CloudWarriors AI

package/dist/application/index.d.ts

@@ -0,0 +1,4 @@
+export { RLMService, type RLMServiceOptions } from './rlm-service.js';
+export { SessionManager } from './session-manager.js';
+export { QueryHandler, type QueryResult } from './query-handler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/application/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/application/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/application/index.js

@@ -0,0 +1,4 @@
+export { RLMService } from './rlm-service.js';
+export { SessionManager } from './session-manager.js';
+export { QueryHandler } from './query-handler.js';
+//# sourceMappingURL=index.js.map

package/dist/application/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/application/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAA0B,MAAM,kBAAkB,CAAC;AACtE,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAoB,MAAM,oBAAoB,CAAC"}

package/dist/application/query-handler.d.ts

@@ -0,0 +1,49 @@
+import type { RLMConfig } from '../domain/types/config.js';
+import type { SessionState, RLMSession } from '../domain/types/session.js';
+import type { ExecutionStep } from '../domain/types/result.js';
+import type { ILLMProvider } from '../domain/interfaces/llm-provider.js';
+import type { ICodeExecutor } from '../domain/interfaces/code-executor.js';
+import type { IEventEmitter } from '../domain/interfaces/event-emitter.js';
+/**
+ * Result of executing a query
+ */
+export interface QueryResult {
+    /** The final answer */
+    answer: string;
+    /** Whether execution succeeded */
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+    /** Execution steps performed */
+    steps: ExecutionStep[];
+}
+/**
+ * Handles execution of RLM queries
+ */
+export declare class QueryHandler {
+    private readonly llmProvider;
+    private readonly codeExecutor;
+    private readonly eventEmitter;
+    constructor(llmProvider: ILLMProvider, codeExecutor: ICodeExecutor, eventEmitter: IEventEmitter);
+    /**
+     * Execute a query at the current recursion depth
+     */
+    execute(session: RLMSession, state: SessionState, config: RLMConfig): Promise<QueryResult>;
+    /**
+     * Generate Python code for the query
+     */
+    private generateCode;
+    /**
+     * Execute Python code and handle commands
+     */
+    private executeCode;
+    /**
+     * Handle llm_query command from Python
+     */
+    private handleLLMQueryCommand;
+    /**
+     * Attempt to recover from an error by asking the LLM to fix the code
+     */
+    private recoverFromError;
+}
+//# sourceMappingURL=query-handler.d.ts.map

package/dist/application/query-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-handler.d.ts","sourceRoot":"","sources":["../../src/application/query-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAuB,MAAM,2BAA2B,CAAC;AACpF,OAAO,KAAK,EAAE,YAAY,EAAW,MAAM,sCAAsC,CAAC;AAClF,OAAO,KAAK,EAAE,aAAa,EAAmB,MAAM,uCAAuC,CAAC;AAC5F,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uCAAuC,CAAC;AAgB3E;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,uBAAuB;IACvB,MAAM,EAAE,MAAM,CAAC;IAEf,kCAAkC;IAClC,OAAO,EAAE,OAAO,CAAC;IAEjB,8BAA8B;IAC9B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,gCAAgC;IAChC,KAAK,EAAE,aAAa,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,qBAAa,YAAY;IAErB,OAAO,CAAC,QAAQ,CAAC,WAAW;IAC5B,OAAO,CAAC,QAAQ,CAAC,YAAY;IAC7B,OAAO,CAAC,QAAQ,CAAC,YAAY;gBAFZ,WAAW,EAAE,YAAY,EACzB,YAAY,EAAE,aAAa,EAC3B,YAAY,EAAE,aAAa;IAG9C;;OAEG;IACG,OAAO,CACX,OAAO,EAAE,UAAU,EACnB,KAAK,EAAE,YAAY,EACnB,MAAM,EAAE,SAAS,GAChB,OAAO,CAAC,WAAW,CAAC;IA2CvB;;OAEG;YACW,YAAY;IAyF1B;;OAEG;YACW,WAAW;IAkIzB;;OAEG;YACW,qBAAqB;IAyFnC;;OAEG;YACW,gBAAgB;CAyC/B"}

package/dist/application/query-handler.js

@@ -0,0 +1,311 @@
+import { checkLimits, canRecurse, } from '../domain/services/limit-checker.js';
+import { formatSystemPrompt, extractPythonCode, formatErrorRecoveryPrompt, MAX_RECOVERY_ATTEMPTS, formatRecursiveQueryPrompt, } from '../infrastructure/llm/prompts/index.js';
+import { LimitExceededError, SessionCancelledError } from '../domain/errors/index.js';
+/**
+ * Handles execution of RLM queries
+ */
+export class QueryHandler {
+    llmProvider;
+    codeExecutor;
+    eventEmitter;
+    constructor(llmProvider, codeExecutor, eventEmitter) {
+        this.llmProvider = llmProvider;
+        this.codeExecutor = codeExecutor;
+        this.eventEmitter = eventEmitter;
+    }
+    /**
+     * Execute a query at the current recursion depth
+     */
+    async execute(session, state, config) {
+        const steps = [];
+        // Check limits before starting
+        const limitCheck = checkLimits(state, config);
+        if (!limitCheck.withinLimits) {
+            const exceeded = limitCheck.exceededLimits[0];
+            throw new LimitExceededError(exceeded.type, exceeded.current, exceeded.max, session.id);
+        }
+        // Check for cancellation
+        if (state.cancellationRequested) {
+            throw new SessionCancelledError(session.id);
+        }
+        // Generate code to process the query
+        const codeResult = await this.generateCode(session, state, config, steps);
+        if (!codeResult.success) {
+            return {
+                answer: '',
+                success: false,
+                error: codeResult.error,
+                steps,
+            };
+        }
+        // Execute the generated code
+        const execResult = await this.executeCode(codeResult.code, session, state, config, steps);
+        return execResult;
+    }
+    /**
+     * Generate Python code for the query
+     */
+    async generateCode(session, state, config, steps) {
+        const startedAt = new Date();
+        // Build context info for the prompt
+        const contextVars = Array.from(state.pythonVariables.entries()).map(([name, value]) => ({
+            name,
+            sizeHint: `${value.length} chars, ~${this.llmProvider.estimateTokens(value)} tokens`,
+        }));
+        const systemPrompt = formatSystemPrompt(contextVars, session.query);
+        const messages = [
+            { role: 'user', content: 'Generate Python code to accomplish the task.' },
+        ];
+        this.eventEmitter.emit({
+            type: 'rlm.llm.completed',
+            sessionId: session.id,
+            timestamp: new Date(),
+            model: config.model,
+            usage: { promptTokens: 0, completionTokens: 0, totalTokens: 0 },
+            cost: 0,
+            depth: state.currentDepth,
+        });
+        const response = await this.llmProvider.generate(messages, {
+            systemPrompt,
+            temperature: config.temperature,
+            maxTokens: 4000,
+        });
+        // Update state with token usage
+        state.totalTokens += response.usage.totalTokens;
+        state.totalCostUsd += response.cost;
+        state.llmCalls += 1;
+        const completedAt = new Date();
+        const durationMs = completedAt.getTime() - startedAt.getTime();
+        steps.push({
+            index: steps.length,
+            depth: state.currentDepth,
+            type: 'llm_call',
+            startedAt,
+            completedAt,
+            durationMs,
+            details: {
+                type: 'llm_call',
+                model: response.model,
+                promptTokens: response.usage.promptTokens,
+                completionTokens: response.usage.completionTokens,
+                cost: response.cost,
+            },
+        });
+        // Extract Python code from response
+        const code = extractPythonCode(response.content);
+        if (!code) {
+            return {
+                success: false,
+                code: '',
+                error: 'Failed to extract Python code from LLM response',
+            };
+        }
+        steps.push({
+            index: steps.length,
+            depth: state.currentDepth,
+            type: 'code_generation',
+            startedAt,
+            completedAt,
+            durationMs: 0,
+            details: {
+                type: 'code_generation',
+                codeLength: code.length,
+                codePreview: code.slice(0, 200) + (code.length > 200 ? '...' : ''),
+            },
+        });
+        return { success: true, code };
+    }
+    /**
+     * Execute Python code and handle commands
+     */
+    async executeCode(code, session, state, config, steps) {
+        const startedAt = new Date();
+        let currentCode = code;
+        let recoveryAttempts = 0;
+        while (recoveryAttempts <= MAX_RECOVERY_ATTEMPTS) {
+            // Validate code
+            const validation = this.codeExecutor.validate(currentCode);
+            if (!validation.valid) {
+                if (recoveryAttempts >= MAX_RECOVERY_ATTEMPTS) {
+                    return {
+                        answer: '',
+                        success: false,
+                        error: `Code validation failed: ${validation.errors.map((e) => e.message).join(', ')}`,
+                        steps,
+                    };
+                }
+                // Try to recover
+                currentCode = await this.recoverFromError(currentCode, `Validation errors: ${validation.errors.map((e) => e.message).join(', ')}`, undefined, session, state, config, steps);
+                recoveryAttempts++;
+                continue;
+            }
+            // Execute code
+            const execContext = {
+                variables: state.pythonVariables,
+                sessionId: session.id,
+                depth: state.currentDepth,
+                timeoutMs: Math.min(config.timeoutMs, 60000), // Max 60s per execution
+            };
+            const result = await this.codeExecutor.execute(currentCode, execContext);
+            const completedAt = new Date();
+            const durationMs = completedAt.getTime() - startedAt.getTime();
+            steps.push({
+                index: steps.length,
+                depth: state.currentDepth,
+                type: 'code_execution',
+                startedAt,
+                completedAt,
+                durationMs,
+                details: {
+                    type: 'code_execution',
+                    success: result.success,
+                    output: result.stdout.slice(0, 500),
+                    error: result.error,
+                },
+            });
+            if (!result.success) {
+                if (recoveryAttempts >= MAX_RECOVERY_ATTEMPTS) {
+                    return {
+                        answer: '',
+                        success: false,
+                        error: result.error ?? 'Code execution failed',
+                        steps,
+                    };
+                }
+                // Try to recover
+                currentCode = await this.recoverFromError(currentCode, result.error ?? 'Unknown error', result.stderr, session, state, config, steps);
+                recoveryAttempts++;
+                continue;
+            }
+            // Process commands from Python
+            for (const command of result.commands) {
+                if (command.type === 'llm_query') {
+                    await this.handleLLMQueryCommand(command, session, state, config, steps);
+                }
+                else if (command.type === 'set_variable') {
+                    state.pythonVariables.set(command.name, command.value);
+                }
+            }
+            // Check if we got a result
+            if (result.result) {
+                return {
+                    answer: result.result,
+                    success: true,
+                    steps,
+                };
+            }
+            // No result set, but execution succeeded
+            return {
+                answer: result.stdout || 'No result set',
+                success: true,
+                steps,
+            };
+        }
+        return {
+            answer: '',
+            success: false,
+            error: 'Max recovery attempts exceeded',
+            steps,
+        };
+    }
+    /**
+     * Handle llm_query command from Python
+     */
+    async handleLLMQueryCommand(command, session, state, config, steps) {
+        // Check if we can recurse
+        if (!canRecurse(state, config)) {
+            // Send error response to Python
+            await this.codeExecutor.respondToQuery(JSON.stringify({ error: 'Maximum recursion depth reached' }));
+            return;
+        }
+        // Increment depth for recursive call
+        state.currentDepth += 1;
+        state.recursiveCalls += 1;
+        state.maxDepthReached = Math.max(state.maxDepthReached, state.currentDepth);
+        const startedAt = new Date();
+        this.eventEmitter.emit({
+            type: 'rlm.recursive.started',
+            sessionId: session.id,
+            timestamp: startedAt,
+            query: command.query,
+            depth: state.currentDepth,
+        });
+        // Build context for the recursive query
+        const contextContent = command.contextVariables.join('\n\n');
+        const prompt = formatRecursiveQueryPrompt(contextContent, command.query);
+        const messages = [{ role: 'user', content: prompt }];
+        try {
+            const response = await this.llmProvider.generate(messages, {
+                temperature: config.temperature,
+                maxTokens: 4000,
+            });
+            // Update state
+            state.totalTokens += response.usage.totalTokens;
+            state.totalCostUsd += response.cost;
+            state.llmCalls += 1;
+            const completedAt = new Date();
+            const durationMs = completedAt.getTime() - startedAt.getTime();
+            steps.push({
+                index: steps.length,
+                depth: state.currentDepth,
+                type: 'recursive_call',
+                startedAt,
+                completedAt,
+                durationMs,
+                details: {
+                    type: 'recursive_call',
+                    query: command.query.slice(0, 100),
+                    contextSize: contextContent.length,
+                    depth: state.currentDepth,
+                },
+            });
+            this.eventEmitter.emit({
+                type: 'rlm.recursive.completed',
+                sessionId: session.id,
+                timestamp: completedAt,
+                depth: state.currentDepth,
+                resultLength: response.content.length,
+            });
+            // Send response back to Python
+            await this.codeExecutor.respondToQuery(JSON.stringify({ result: response.content }));
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            await this.codeExecutor.respondToQuery(JSON.stringify({ error: errorMessage }));
+        }
+        finally {
+            // Decrement depth after recursive call
+            state.currentDepth -= 1;
+        }
+    }
+    /**
+     * Attempt to recover from an error by asking the LLM to fix the code
+     */
+    async recoverFromError(previousCode, error, traceback, session, state, config, steps) {
+        const startedAt = new Date();
+        this.eventEmitter.emit({
+            type: 'rlm.recovery.started',
+            sessionId: session.id,
+            timestamp: startedAt,
+        });
+        const prompt = formatErrorRecoveryPrompt(previousCode, error, traceback);
+        const messages = [{ role: 'user', content: prompt }];
+        const response = await this.llmProvider.generate(messages, {
+            temperature: 0.2, // Lower temperature for more focused fixes
+            maxTokens: 4000,
+        });
+        // Update state
+        state.totalTokens += response.usage.totalTokens;
+        state.totalCostUsd += response.cost;
+        state.llmCalls += 1;
+        const completedAt = new Date();
+        this.eventEmitter.emit({
+            type: 'rlm.recovery.completed',
+            sessionId: session.id,
+            timestamp: completedAt,
+        });
+        const fixedCode = extractPythonCode(response.content);
+        return fixedCode ?? previousCode;
+    }
+}
+//# sourceMappingURL=query-handler.js.map

package/dist/application/query-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-handler.js","sourceRoot":"","sources":["../../src/application/query-handler.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,WAAW,EAEX,UAAU,GACX,MAAM,qCAAqC,CAAC;AAE7C,OAAO,EACL,kBAAkB,EAClB,iBAAiB,EACjB,yBAAyB,EACzB,qBAAqB,EACrB,0BAA0B,GAC3B,MAAM,wCAAwC,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAC;AAmBtF;;GAEG;AACH,MAAM,OAAO,YAAY;IAEJ;IACA;IACA;IAHnB,YACmB,WAAyB,EACzB,YAA2B,EAC3B,YAA2B;QAF3B,gBAAW,GAAX,WAAW,CAAc;QACzB,iBAAY,GAAZ,YAAY,CAAe;QAC3B,iBAAY,GAAZ,YAAY,CAAe;IAC3C,CAAC;IAEJ;;OAEG;IACH,KAAK,CAAC,OAAO,CACX,OAAmB,EACnB,KAAmB,EACnB,MAAiB;QAEjB,MAAM,KAAK,GAAoB,EAAE,CAAC;QAElC,+BAA+B;QAC/B,MAAM,UAAU,GAAG,WAAW,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;QAC9C,IAAI,CAAC,UAAU,CAAC,YAAY,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,UAAU,CAAC,cAAc,CAAC,CAAC,CAAE,CAAC;YAC/C,MAAM,IAAI,kBAAkB,CAC1B,QAAQ,CAAC,IAAI,EACb,QAAQ,CAAC,OAAO,EAChB,QAAQ,CAAC,GAAG,EACZ,OAAO,CAAC,EAAE,CACX,CAAC;QACJ,CAAC;QAED,yBAAyB;QACzB,IAAI,KAAK,CAAC,qBAAqB,EAAE,CAAC;YAChC,MAAM,IAAI,qBAAqB,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAC9C,CAAC;QAED,qCAAqC;QACrC,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC;QAC1E,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YACxB,OAAO;gBACL,MAAM,EAAE,EAAE;gBACV,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE,UAAU,CAAC,KAAK;gBACvB,KAAK;aACN,CAAC;QACJ,CAAC;QAED,6BAA6B;QAC7B,MAAM,UAAU,GAAG,MAAM,IAAI,CAAC,WAAW,CACvC,UAAU,CAAC,IAAI,EACf,OAAO,EACP,KAAK,EACL,MAAM,EACN,KAAK,CACN,CAAC;QAEF,OAAO,UAAU,CAAC;IACpB,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,YAAY,CACxB,OAAmB,EACnB,KAAmB,EACnB,MAAiB,EACjB,KAAsB;QAEtB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAE7B,oCAAoC;QACpC,MAAM,WAAW,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC,CAAC,GAAG,CACjE,CAAC,CAAC,IAAI,EAAE,KAAK,CAAC,EAAE,EAAE,CAAC,CAAC;YAClB,IAAI;YACJ,QAAQ,EAAE,GAAG,KAAK,CAAC,MAAM,YAAY,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,KAAK,CAAC,SAAS;SACrF,CAAC,CACH,CAAC;QAEF,MAAM,YAAY,GAAG,kBAAkB,CAAC,WAAW,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAEpE,MAAM,QAAQ,GAAc;YAC1B,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,8CAA8C,EAAE;SAC1E,CAAC;QAEF,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;YACrB,IAAI,EAAE,mBAAmB;YACzB,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,SAAS,EAAE,IAAI,IAAI,EAAE;YACrB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,KAAK,EAAE,EAAE,YAAY,EAAE,CAAC,EAAE,gBAAgB,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE;YAC/D,IAAI,EAAE,CAAC;YACP,KAAK,EAAE,KAAK,CAAC,YAAY;SAC1B,CAAC,CAAC;QAEH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,EAAE;YACzD,YAAY;YACZ,WAAW,EAAE,MAAM,CAAC,WAAW;YAC/B,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QAEH,gCAAgC;QAChC,KAAK,CAAC,WAAW,IAAI,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC;QAChD,KAAK,CAAC,YAAY,IAAI,QAAQ,CAAC,IAAI,CAAC;QACpC,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC;QAEpB,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;QAC/B,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;QAE/D,KAAK,CAAC,IAAI,CAAC;YACT,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,KAAK,EAAE,KAAK,CAAC,YAAY;YACzB,IAAI,EAAE,UAAU;YAChB,SAAS;YACT,WAAW;YACX,UAAU;YACV,OAAO,EAAE;gBACP,IAAI,EAAE,UAAU;gBAChB,KAAK,EAAE,QAAQ,CAAC,KAAK;gBACrB,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,YAAY;gBACzC,gBAAgB,EAAE,QAAQ,CAAC,KAAK,CAAC,gBAAgB;gBACjD,IAAI,EAAE,QAAQ,CAAC,IAAI;aACpB;SACF,CAAC,CAAC;QAEH,oCAAoC;QACpC,MAAM,IAAI,GAAG,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO;gBACL,OAAO,EAAE,KAAK;gBACd,IAAI,EAAE,EAAE;gBACR,KAAK,EAAE,iDAAiD;aACzD,CAAC;QACJ,CAAC;QAED,KAAK,CAAC,IAAI,CAAC;YACT,KAAK,EAAE,KAAK,CAAC,MAAM;YACnB,KAAK,EAAE,KAAK,CAAC,YAAY;YACzB,IAAI,EAAE,iBAAiB;YACvB,SAAS;YACT,WAAW;YACX,UAAU,EAAE,CAAC;YACb,OAAO,EAAE;gBACP,IAAI,EAAE,iBAAiB;gBACvB,UAAU,EAAE,IAAI,CAAC,MAAM;gBACvB,WAAW,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;aACnE;SACF,CAAC,CAAC;QAEH,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;IACjC,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,WAAW,CACvB,IAAY,EACZ,OAAmB,EACnB,KAAmB,EACnB,MAAiB,EACjB,KAAsB;QAEtB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAC7B,IAAI,WAAW,GAAG,IAAI,CAAC;QACvB,IAAI,gBAAgB,GAAG,CAAC,CAAC;QAEzB,OAAO,gBAAgB,IAAI,qBAAqB,EAAE,CAAC;YACjD,gBAAgB;YAChB,MAAM,UAAU,GAAG,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;YAC3D,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;gBACtB,IAAI,gBAAgB,IAAI,qBAAqB,EAAE,CAAC;oBAC9C,OAAO;wBACL,MAAM,EAAE,EAAE;wBACV,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,2BAA2B,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;wBACtF,KAAK;qBACN,CAAC;gBACJ,CAAC;gBAED,iBAAiB;gBACjB,WAAW,GAAG,MAAM,IAAI,CAAC,gBAAgB,CACvC,WAAW,EACX,sBAAsB,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAC1E,SAAS,EACT,OAAO,EACP,KAAK,EACL,MAAM,EACN,KAAK,CACN,CAAC;gBACF,gBAAgB,EAAE,CAAC;gBACnB,SAAS;YACX,CAAC;YAED,eAAe;YACf,MAAM,WAAW,GAAG;gBAClB,SAAS,EAAE,KAAK,CAAC,eAAe;gBAChC,SAAS,EAAE,OAAO,CAAC,EAAE;gBACrB,KAAK,EAAE,KAAK,CAAC,YAAY;gBACzB,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,EAAE,KAAK,CAAC,EAAE,wBAAwB;aACvE,CAAC;YAEF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,EAAE,WAAW,CAAC,CAAC;YAEzE,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;YAC/B,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;YAE/D,KAAK,CAAC,IAAI,CAAC;gBACT,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,KAAK,EAAE,KAAK,CAAC,YAAY;gBACzB,IAAI,EAAE,gBAAgB;gBACtB,SAAS;gBACT,WAAW;gBACX,UAAU;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,gBAAgB;oBACtB,OAAO,EAAE,MAAM,CAAC,OAAO;oBACvB,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;oBACnC,KAAK,EAAE,MAAM,CAAC,KAAK;iBACpB;aACF,CAAC,CAAC;YAEH,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACpB,IAAI,gBAAgB,IAAI,qBAAqB,EAAE,CAAC;oBAC9C,OAAO;wBACL,MAAM,EAAE,EAAE;wBACV,OAAO,EAAE,KAAK;wBACd,KAAK,EAAE,MAAM,CAAC,KAAK,IAAI,uBAAuB;wBAC9C,KAAK;qBACN,CAAC;gBACJ,CAAC;gBAED,iBAAiB;gBACjB,WAAW,GAAG,MAAM,IAAI,CAAC,gBAAgB,CACvC,WAAW,EACX,MAAM,CAAC,KAAK,IAAI,eAAe,EAC/B,MAAM,CAAC,MAAM,EACb,OAAO,EACP,KAAK,EACL,MAAM,EACN,KAAK,CACN,CAAC;gBACF,gBAAgB,EAAE,CAAC;gBACnB,SAAS;YACX,CAAC;YAED,+BAA+B;YAC/B,KAAK,MAAM,OAAO,IAAI,MAAM,CAAC,QAAQ,EAAE,CAAC;gBACtC,IAAI,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;oBACjC,MAAM,IAAI,CAAC,qBAAqB,CAC9B,OAAO,EACP,OAAO,EACP,KAAK,EACL,MAAM,EACN,KAAK,CACN,CAAC;gBACJ,CAAC;qBAAM,IAAI,OAAO,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;oBAC3C,KAAK,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;gBACzD,CAAC;YACH,CAAC;YAED,2BAA2B;YAC3B,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,OAAO;oBACL,MAAM,EAAE,MAAM,CAAC,MAAM;oBACrB,OAAO,EAAE,IAAI;oBACb,KAAK;iBACN,CAAC;YACJ,CAAC;YAED,yCAAyC;YACzC,OAAO;gBACL,MAAM,EAAE,MAAM,CAAC,MAAM,IAAI,eAAe;gBACxC,OAAO,EAAE,IAAI;gBACb,KAAK;aACN,CAAC;QACJ,CAAC;QAED,OAAO;YACL,MAAM,EAAE,EAAE;YACV,OAAO,EAAE,KAAK;YACd,KAAK,EAAE,gCAAgC;YACvC,KAAK;SACN,CAAC;IACJ,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,qBAAqB,CACjC,OAAwB,EACxB,OAAmB,EACnB,KAAmB,EACnB,MAAiB,EACjB,KAAsB;QAEtB,0BAA0B;QAC1B,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;YAC/B,gCAAgC;YAChC,MAAM,IAAI,CAAC,YAAY,CAAC,cAAc,CACpC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,iCAAiC,EAAE,CAAC,CAC7D,CAAC;YACF,OAAO;QACT,CAAC;QAED,qCAAqC;QACrC,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;QACxB,KAAK,CAAC,cAAc,IAAI,CAAC,CAAC;QAC1B,KAAK,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,YAAY,CAAC,CAAC;QAE5E,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAE7B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;YACrB,IAAI,EAAE,uBAAuB;YAC7B,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,SAAS,EAAE,SAAS;YACpB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,KAAK,EAAE,KAAK,CAAC,YAAY;SAC1B,CAAC,CAAC;QAEH,wCAAwC;QACxC,MAAM,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,0BAA0B,CAAC,cAAc,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;QAEzE,MAAM,QAAQ,GAAc,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAEhE,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,EAAE;gBACzD,WAAW,EAAE,MAAM,CAAC,WAAW;gBAC/B,SAAS,EAAE,IAAI;aAChB,CAAC,CAAC;YAEH,eAAe;YACf,KAAK,CAAC,WAAW,IAAI,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC;YAChD,KAAK,CAAC,YAAY,IAAI,QAAQ,CAAC,IAAI,CAAC;YACpC,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC;YAEpB,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;YAC/B,MAAM,UAAU,GAAG,WAAW,CAAC,OAAO,EAAE,GAAG,SAAS,CAAC,OAAO,EAAE,CAAC;YAE/D,KAAK,CAAC,IAAI,CAAC;gBACT,KAAK,EAAE,KAAK,CAAC,MAAM;gBACnB,KAAK,EAAE,KAAK,CAAC,YAAY;gBACzB,IAAI,EAAE,gBAAgB;gBACtB,SAAS;gBACT,WAAW;gBACX,UAAU;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,gBAAgB;oBACtB,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC;oBAClC,WAAW,EAAE,cAAc,CAAC,MAAM;oBAClC,KAAK,EAAE,KAAK,CAAC,YAAY;iBAC1B;aACF,CAAC,CAAC;YAEH,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;gBACrB,IAAI,EAAE,yBAAyB;gBAC/B,SAAS,EAAE,OAAO,CAAC,EAAE;gBACrB,SAAS,EAAE,WAAW;gBACtB,KAAK,EAAE,KAAK,CAAC,YAAY;gBACzB,YAAY,EAAE,QAAQ,CAAC,OAAO,CAAC,MAAM;aACtC,CAAC,CAAC;YAEH,+BAA+B;YAC/B,MAAM,IAAI,CAAC,YAAY,CAAC,cAAc,CACpC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,OAAO,EAAE,CAAC,CAC7C,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;YAC9E,MAAM,IAAI,CAAC,YAAY,CAAC,cAAc,CACpC,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CACxC,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,uCAAuC;YACvC,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC;QAC1B,CAAC;IACH,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,gBAAgB,CAC5B,YAAoB,EACpB,KAAa,EACb,SAA6B,EAC7B,OAAmB,EACnB,KAAmB,EACnB,MAAiB,EACjB,KAAsB;QAEtB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC;QAE7B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;YACrB,IAAI,EAAE,sBAA+B;YACrC,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,SAAS,EAAE,SAAS;SACd,CAAC,CAAC;QAEV,MAAM,MAAM,GAAG,yBAAyB,CAAC,YAAY,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC;QACzE,MAAM,QAAQ,GAAc,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;QAEhE,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,QAAQ,EAAE;YACzD,WAAW,EAAE,GAAG,EAAE,2CAA2C;YAC7D,SAAS,EAAE,IAAI;SAChB,CAAC,CAAC;QAEH,eAAe;QACf,KAAK,CAAC,WAAW,IAAI,QAAQ,CAAC,KAAK,CAAC,WAAW,CAAC;QAChD,KAAK,CAAC,YAAY,IAAI,QAAQ,CAAC,IAAI,CAAC;QACpC,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC;QAEpB,MAAM,WAAW,GAAG,IAAI,IAAI,EAAE,CAAC;QAE/B,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC;YACrB,IAAI,EAAE,wBAAiC;YACvC,SAAS,EAAE,OAAO,CAAC,EAAE;YACrB,SAAS,EAAE,WAAW;SAChB,CAAC,CAAC;QAEV,MAAM,SAAS,GAAG,iBAAiB,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;QACtD,OAAO,SAAS,IAAI,YAAY,CAAC;IACnC,CAAC;CACF"}

package/dist/application/rlm-service.d.ts

@@ -0,0 +1,68 @@
+import type { RLMConfig, RLMConfigInput } from '../domain/types/config.js';
+import type { ContextInput } from '../domain/types/context.js';
+import type { RLMResult } from '../domain/types/result.js';
+import type { RLMSession } from '../domain/types/session.js';
+import type { ILLMProvider } from '../domain/interfaces/llm-provider.js';
+import type { ICodeExecutor } from '../domain/interfaces/code-executor.js';
+import type { ISessionStore, SessionFilter } from '../domain/interfaces/session-store.js';
+import type { IEventEmitter } from '../domain/interfaces/event-emitter.js';
+/**
+ * Options for creating an RLM service
+ */
+export interface RLMServiceOptions {
+    /** LLM provider for generating responses */
+    readonly llmProvider: ILLMProvider;
+    /** Code executor for running Python */
+    readonly codeExecutor: ICodeExecutor;
+    /** Session store for persistence */
+    readonly sessionStore: ISessionStore;
+    /** Event emitter for notifications */
+    readonly eventEmitter: IEventEmitter;
+    /** Default configuration */
+    readonly config?: RLMConfigInput;
+}
+/**
+ * Main RLM service for processing queries
+ */
+export declare class RLMService {
+    private readonly llmProvider;
+    private readonly codeExecutor;
+    private readonly sessionManager;
+    private readonly queryHandler;
+    private readonly defaultConfig;
+    constructor(options: RLMServiceOptions);
+    /**
+     * Execute an RLM query
+     *
+     * @param context - The context to process (string or ContextInput)
+     * @param query - The query/task to perform
+     * @param config - Optional config overrides
+     * @returns The query result
+     */
+    query(context: string | ContextInput | readonly ContextInput[], query: string, config?: RLMConfigInput): Promise<RLMResult>;
+    /**
+     * Cancel a running session
+     */
+    cancelSession(sessionId: string): Promise<RLMSession | null>;
+    /**
+     * Get a session by ID
+     */
+    getSession(sessionId: string): Promise<RLMSession | null>;
+    /**
+     * List sessions
+     */
+    listSessions(filter?: SessionFilter): Promise<readonly RLMSession[]>;
+    /**
+     * Check if the LLM provider is healthy
+     */
+    healthCheck(): Promise<boolean>;
+    /**
+     * Get the current configuration
+     */
+    getConfig(): RLMConfig;
+    /**
+     * Normalize context input to ContextVariables
+     */
+    private normalizeContext;
+}
+//# sourceMappingURL=rlm-service.d.ts.map