matryoshka-rlm 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 yogthos
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,303 @@
+# Recursive Language Model (RLM)
+
+Process documents 100x larger than your LLM's context window—without vector databases or chunking heuristics.
+
+## The Problem
+
+LLMs have fixed context windows. Traditional solutions (RAG, chunking) lose information or miss connections across chunks. RLM takes a different approach: the model writes code to explore documents programmatically, deciding at runtime how to decompose and analyze the data.
+
+Based on the [Recursive Language Models paper](https://arxiv.org/abs/2512.24601).
+
+## Installation
+
+### npm (recommended)
+
+```bash
+npm install -g matryoshka-rlm
+```
+
+### npx (no install)
+
+```bash
+npx matryoshka-rlm "Summarize this document" ./document.txt
+```
+
+### From source
+
+```bash
+git clone https://github.com/yogthos/Matryoshka.git
+cd Matryoshka
+npm install
+npm run build
+```
+
+## Configuration
+
+Copy `config.example.json` to `config.json` and configure your LLM provider:
+
+```json
+{
+  "llm": {
+    "provider": "ollama"
+  },
+  "providers": {
+    "ollama": {
+      "baseUrl": "http://localhost:11434",
+      "model": "qwen3-coder:30b",
+      "options": { "temperature": 0.2, "num_ctx": 8192 }
+    },
+    "deepseek": {
+      "baseUrl": "https://api.deepseek.com",
+      "apiKey": "${DEEPSEEK_API_KEY}",
+      "model": "deepseek-chat",
+      "options": { "temperature": 0.2 }
+    }
+  }
+}
+```
+
+## Usage
+
+### CLI
+
+```bash
+# Basic usage
+rlm "Summarize this document" ./path/to/document.txt
+
+# With options
+rlm "Find all error codes" ./logs.txt --max-turns 15 --verbose
+
+# See all options
+rlm --help
+```
+
+### MCP Integration
+
+RLM includes an MCP (Model Context Protocol) server that exposes the `analyze_document` tool. This allows Claude to analyze documents that exceed its context window.
+
+#### MCP Tool: `analyze_document`
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `query` | string | Yes | The question or task to perform on the document |
+| `filePath` | string | Yes | Absolute path to the document file |
+| `maxTurns` | number | No | Maximum exploration turns (default: 10) |
+| `timeoutMs` | number | No | Timeout per turn in milliseconds (default: 30000) |
+
+#### Claude Code
+
+Add the MCP server to Claude Code:
+
+```bash
+# Add to user config (available in all projects)
+claude mcp add --transport stdio --scope user rlm -- rlm-mcp
+
+# Or add to current project only
+claude mcp add --transport stdio rlm -- rlm-mcp
+
+# Verify it's connected
+claude mcp list
+```
+
+Then ask Claude to analyze documents:
+
+> Use the analyze_document tool to find all sales figures in /path/to/report.txt and calculate the total
+
+#### Claude Desktop
+
+Add to your Claude Desktop config file:
+
+**macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
+
+Using npx (no global install needed):
+
+```json
+{
+  "mcpServers": {
+    "rlm": {
+      "command": "npx",
+      "args": ["-y", "-p", "matryoshka-rlm", "rlm-mcp"]
+    }
+  }
+}
+```
+
+Or if installed globally:
+
+```json
+{
+  "mcpServers": {
+    "rlm": {
+      "command": "rlm-mcp"
+    }
+  }
+}
+```
+
+Restart Claude Desktop after updating the config. Look for the hammer icon to confirm the server loaded.
+
+#### Testing the MCP Server
+
+```bash
+# Verify the server starts correctly
+rlm-mcp --test
+# Output: MCP server ready
+# Output: Available tools: analyze_document
+```
+
+### Programmatic
+
+```typescript
+import { runRLM } from "matryoshka-rlm/rlm";
+import { createLLMClient } from "matryoshka-rlm";
+
+const llmClient = createLLMClient("ollama", {
+  baseUrl: "http://localhost:11434",
+  model: "qwen3-coder:30b",
+  options: { temperature: 0.2 }
+});
+
+const result = await runRLM("What are the main themes?", "./book.txt", {
+  llmClient,
+  maxTurns: 10,
+  turnTimeoutMs: 30000,
+});
+```
+
+## Architecture
+
+```mermaid
+sequenceDiagram
+    participant User
+    participant RLM as RLM Engine
+    participant Sandbox as JavaScript Sandbox
+    participant LLM as LLM Provider
+
+    User->>RLM: query + document path
+    RLM->>Sandbox: Create sandbox with document as `context`
+
+    loop Until FINAL or maxTurns
+        RLM->>LLM: System prompt + history
+        LLM-->>RLM: JavaScript code block
+        RLM->>Sandbox: Execute code (with timeout)
+        Sandbox-->>RLM: { result, logs, error }
+        Note over RLM: Append output to history
+    end
+
+    RLM-->>User: Final answer
+```
+
+### Components
+
+| Component | Purpose |
+|-----------|---------|
+| **RLM Engine** | Orchestrates the turn loop, builds prompts, extracts answers |
+| **Sandbox** | Isolated VM executing LLM-generated JavaScript with timeout protection |
+| **Tools** | `text_stats()`, `fuzzy_search()`, `llm_query()` available in sandbox |
+| **Memory** | Persistent array for accumulating findings across turns |
+
+### How It Works
+
+1. Document loads into sandbox as read-only `context` variable
+2. LLM receives system prompt with available tools and writes JavaScript
+3. Code executes in sandbox, results feed back to LLM
+4. LLM iterates until it outputs `<<<FINAL>>>answer<<<END>>>`
+5. Sub-queries via `llm_query()` enable recursive decomposition
+
+### Sandbox Tools
+
+The LLM has access to these tools when exploring documents:
+
+| Tool | Description |
+|------|-------------|
+| `text_stats()` | Returns document metadata: length, line count, samples from start/middle/end |
+| `fuzzy_search(query, limit?)` | Finds approximate matches, returns lines with scores |
+| `llm_query(prompt)` | Spawns a sub-LLM call for complex analysis (limited by `maxSubCalls`) |
+| `context` | The full document text (read-only string) |
+| `memory` | Persistent array to accumulate findings across turns |
+
+### Safety
+
+- Sandbox isolates code execution (no filesystem, network, or process access)
+- Configurable timeout per turn
+- `maxSubCalls` limit prevents infinite recursion
+- Sub-LLM calls receive only the prompt, never parent context
+- Auto-fixes common syntax errors in LLM-generated code
+
+## Troubleshooting
+
+### Model Answers Immediately Without Exploring
+
+**Symptom**: The model provides an answer on the first turn without running any code, often with hallucinated data.
+
+**Cause**: Smaller or less capable models may not follow the instruction to explore via code before answering.
+
+**Solutions**:
+
+1. **Use a more capable model** - Models like `deepseek-chat` or larger Ollama models follow instructions better
+2. **Make your query more specific** - Instead of vague queries, be explicit:
+   ```bash
+   # Vague (may cause hallucination)
+   rlm "What are the sales figures?" ./report.txt
+
+   # Specific (guides exploration)
+   rlm "Search for SALES_DATA entries and sum the dollar amounts" ./report.txt
+   ```
+3. **Include data patterns in your query** - If you know how data is formatted, mention it:
+   ```bash
+   rlm "Find lines matching 'Total:' and extract the numbers" ./data.txt
+   ```
+
+### Max Turns Reached Without Answer
+
+**Symptom**: Output shows "Max turns (N) reached without final answer"
+
+**Cause**: The model keeps exploring but never terminates properly.
+
+**Solutions**:
+
+1. Increase `--max-turns` for complex documents
+2. Check if the model is stuck in a loop (`--verbose` shows repeated patterns)
+3. Simplify the query to require less exploration
+
+### Sandbox Execution Errors
+
+**Symptom**: Repeated "Error: Unexpected token" or similar JavaScript errors
+
+**Cause**: The model is generating invalid JavaScript code.
+
+**Solutions**:
+
+1. The system auto-fixes common issues (missing semicolons, TypeScript syntax)
+2. If errors persist, try a different model - some are better at generating valid code
+3. Use `--verbose` to see what code the model is generating
+
+## Development
+
+```bash
+# Run tests
+npm test
+
+# Run with coverage
+npm test -- --coverage
+
+# E2E tests (requires Ollama running locally)
+RUN_E2E=1 npm test -- --run tests/e2e.test.ts
+
+# Build
+npm run build
+
+# Type check
+npm run typecheck
+```
+
+## License
+
+MIT
+
+## References
+
+- [RLM Paper](https://arxiv.org/abs/2512.24601)
+- [Original Implementation](https://github.com/alexzhang13/rlm)
+- [Model Context Protocol](https://modelcontextprotocol.io/)

package/config.example.json

@@ -0,0 +1,31 @@
+{
+  "llm": {
+    "provider": "ollama"
+  },
+  "providers": {
+    "ollama": {
+      "baseUrl": "http://localhost:11434",
+      "model": "qwen3-coder:30b",
+      "options": {
+        "temperature": 0.2,
+        "num_ctx": 8192
+      }
+    },
+    "deepseek": {
+      "baseUrl": "https://api.deepseek.com",
+      "apiKey": "${DEEPSEEK_API_KEY}",
+      "model": "deepseek-chat",
+      "options": {
+        "temperature": 0.2
+      }
+    }
+  },
+  "sandbox": {
+    "maxSubCalls": 10,
+    "turnTimeoutMs": 30000,
+    "memoryLimitMb": 128
+  },
+  "rlm": {
+    "maxTurns": 10
+  }
+}

package/dist/code-fixer.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Lightweight code fixer for common LLM-generated syntax errors
+ * Attempts to fix issues before sandbox execution to minimize retries
+ */
+export interface FixResult {
+    code: string;
+    fixed: boolean;
+    fixes: string[];
+}
+/**
+ * Check if code has valid syntax
+ */
+export declare function checkSyntax(code: string): {
+    valid: boolean;
+    error?: string;
+};
+/**
+ * Apply common fixes to code
+ */
+export declare function fixCode(code: string): FixResult;
+/**
+ * Attempt to fix code and return result
+ * Returns original code if fixes don't help
+ */
+export declare function tryFixCode(code: string): FixResult;
+//# sourceMappingURL=code-fixer.d.ts.map

package/dist/code-fixer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-fixer.d.ts","sourceRoot":"","sources":["../src/code-fixer.ts"],"names":[],"mappings":"AAAA;;;GAGG;AA2FH,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAS5E;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CA+G/C;AAED;;;GAGG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CASlD"}

package/dist/code-fixer.js

@@ -0,0 +1,209 @@
+/**
+ * Lightweight code fixer for common LLM-generated syntax errors
+ * Attempts to fix issues before sandbox execution to minimize retries
+ */
+import vm from "node:vm";
+/**
+ * Remove a block with balanced braces starting at a given position
+ * Returns the end index (exclusive) of the block, or -1 if not found
+ */
+function findBalancedBraceEnd(code, startIndex) {
+    let depth = 0;
+    let inString = false;
+    let stringChar = "";
+    for (let i = startIndex; i < code.length; i++) {
+        const char = code[i];
+        const prevChar = i > 0 ? code[i - 1] : "";
+        // Handle string literals (skip brace counting inside strings)
+        if ((char === '"' || char === "'" || char === "`") && prevChar !== "\\") {
+            if (!inString) {
+                inString = true;
+                stringChar = char;
+            }
+            else if (char === stringChar) {
+                inString = false;
+            }
+            continue;
+        }
+        if (inString)
+            continue;
+        if (char === "{") {
+            depth++;
+        }
+        else if (char === "}") {
+            depth--;
+            if (depth === 0) {
+                return i + 1; // Return position after closing brace
+            }
+        }
+    }
+    return -1; // Unbalanced
+}
+/**
+ * Remove TypeScript interface/type declarations with proper brace matching
+ */
+function removeTypeDeclarations(code) {
+    let result = code;
+    let removed = false;
+    // Match interface/type declarations and remove them with balanced braces
+    const declarationPattern = /^(interface|type)\s+\w+\s*(\{|=)/gm;
+    let match;
+    while ((match = declarationPattern.exec(result)) !== null) {
+        const startIndex = match.index;
+        const matchText = match[0];
+        if (matchText.endsWith("{")) {
+            // Interface with braces - find the balanced end
+            const braceStart = match.index + matchText.length - 1;
+            const endIndex = findBalancedBraceEnd(result, braceStart);
+            if (endIndex !== -1) {
+                // Remove the entire declaration including trailing whitespace/newline
+                let removeEnd = endIndex;
+                while (removeEnd < result.length && /[\s;]/.test(result[removeEnd])) {
+                    removeEnd++;
+                }
+                result = result.slice(0, startIndex) + result.slice(removeEnd);
+                removed = true;
+                declarationPattern.lastIndex = startIndex; // Reset to check from same position
+            }
+        }
+        else {
+            // Type alias with = (e.g., type Foo = string;)
+            const semicolonIndex = result.indexOf(";", match.index);
+            if (semicolonIndex !== -1) {
+                let removeEnd = semicolonIndex + 1;
+                while (removeEnd < result.length && result[removeEnd] === "\n") {
+                    removeEnd++;
+                }
+                result = result.slice(0, startIndex) + result.slice(removeEnd);
+                removed = true;
+                declarationPattern.lastIndex = startIndex;
+            }
+        }
+    }
+    return { code: result, removed };
+}
+/**
+ * Check if code has valid syntax
+ */
+export function checkSyntax(code) {
+    try {
+        // Wrap in async IIFE like sandbox does
+        const wrapped = `(async () => { ${code} })()`;
+        new vm.Script(wrapped);
+        return { valid: true };
+    }
+    catch (err) {
+        return { valid: false, error: err.message };
+    }
+}
+/**
+ * Apply common fixes to code
+ */
+export function fixCode(code) {
+    const fixes = [];
+    let fixedCode = code;
+    // ALWAYS remove imports/requires/exports first - they will fail at runtime in sandbox
+    // Do this even for syntactically valid code
+    // Remove import statements
+    const beforeImport = fixedCode;
+    fixedCode = fixedCode.replace(/^import\s+.*?from\s+['"].*?['"];?\s*\n?/gm, "");
+    if (fixedCode !== beforeImport) {
+        fixes.push("Removed import statements");
+    }
+    const beforeRequire = fixedCode;
+    fixedCode = fixedCode.replace(/^const\s+\w+\s*=\s*require\s*\(['"].*?['"]\);?\s*\n?/gm, "");
+    if (fixedCode !== beforeRequire) {
+        fixes.push("Removed require statements");
+    }
+    // Remove export statements
+    const beforeExport = fixedCode;
+    fixedCode = fixedCode.replace(/^export\s+(default\s+)?/gm, "");
+    if (fixedCode !== beforeExport) {
+        fixes.push("Removed export statements");
+    }
+    // If we made changes for runtime compatibility, check if code is now valid
+    if (fixes.length > 0) {
+        const afterRuntimeFixes = checkSyntax(fixedCode);
+        if (afterRuntimeFixes.valid) {
+            return { code: fixedCode, fixed: true, fixes };
+        }
+    }
+    // Check if original code (after runtime fixes) is already syntactically valid
+    const initial = checkSyntax(fixedCode);
+    if (initial.valid) {
+        // No further fixes needed
+        if (fixes.length > 0) {
+            return { code: fixedCode, fixed: true, fixes };
+        }
+        return { code: fixedCode, fixed: false, fixes: [] };
+    }
+    // Code has syntax errors - apply additional fixes
+    // Fix: Fix common template literal issues (unescaped backticks)
+    // This is tricky - skip for now
+    // Fix: Remove TypeScript type annotations that might cause issues
+    // Simple cases: `: string`, `: number`, `: any`, etc.
+    const beforeTypes = fixedCode;
+    fixedCode = fixedCode.replace(/:\s*(string|number|boolean|any|void|unknown|object|never)(\[\])?\s*([=,)\]}]|$)/g, "$3");
+    if (fixedCode !== beforeTypes) {
+        fixes.push("Removed TypeScript type annotations");
+    }
+    // Fix 5: Fix interface/type declarations (not valid JS) - with proper brace matching
+    const typeRemoval = removeTypeDeclarations(fixedCode);
+    if (typeRemoval.removed) {
+        fixedCode = typeRemoval.code;
+        fixes.push("Removed TypeScript interface/type declarations");
+    }
+    // Fix 6: Add missing semicolons after common patterns
+    // After closing braces that aren't part of control flow
+    fixedCode = fixedCode.replace(/\}(\s*)(const|let|var|function|class|if|for|while|switch|return|throw|console|memory|await)/g, "};\n$2");
+    // Fix 7: Remove trailing commas in function calls (less common issue)
+    fixedCode = fixedCode.replace(/,(\s*)\)/g, "$1)");
+    fixedCode = fixedCode.replace(/,(\s*)\]/g, "$1]");
+    // Check if fixes helped
+    const afterFixes = checkSyntax(fixedCode);
+    if (afterFixes.valid) {
+        if (fixes.length === 0)
+            fixes.push("Applied automatic syntax fixes");
+        return { code: fixedCode, fixed: true, fixes };
+    }
+    // If still invalid, try more aggressive fixes
+    // Fix 8: Balance brackets/braces
+    const openBraces = (fixedCode.match(/\{/g) || []).length;
+    const closeBraces = (fixedCode.match(/\}/g) || []).length;
+    if (openBraces > closeBraces) {
+        fixedCode += "\n" + "}".repeat(openBraces - closeBraces);
+        fixes.push(`Added ${openBraces - closeBraces} missing closing brace(s)`);
+    }
+    const openParens = (fixedCode.match(/\(/g) || []).length;
+    const closeParens = (fixedCode.match(/\)/g) || []).length;
+    if (openParens > closeParens) {
+        fixedCode += ")".repeat(openParens - closeParens);
+        fixes.push(`Added ${openParens - closeParens} missing closing paren(s)`);
+    }
+    const openBrackets = (fixedCode.match(/\[/g) || []).length;
+    const closeBrackets = (fixedCode.match(/\]/g) || []).length;
+    if (openBrackets > closeBrackets) {
+        fixedCode += "]".repeat(openBrackets - closeBrackets);
+        fixes.push(`Added ${openBrackets - closeBrackets} missing closing bracket(s)`);
+    }
+    // Final check
+    const finalCheck = checkSyntax(fixedCode);
+    return {
+        code: fixedCode,
+        fixed: finalCheck.valid && fixes.length > 0,
+        fixes: finalCheck.valid ? fixes : [],
+    };
+}
+/**
+ * Attempt to fix code and return result
+ * Returns original code if fixes don't help
+ */
+export function tryFixCode(code) {
+    const result = fixCode(code);
+    // If fixes didn't make it valid, return original
+    if (!result.fixed && !checkSyntax(code).valid && !checkSyntax(result.code).valid) {
+        return { code, fixed: false, fixes: [] };
+    }
+    return result;
+}
+//# sourceMappingURL=code-fixer.js.map

package/dist/code-fixer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"code-fixer.js","sourceRoot":"","sources":["../src/code-fixer.ts"],"names":[],"mappings":"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"}

package/dist/config.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Configuration file types
+ *
+ * Note: These types mirror some types in llm/types.ts but serve different purposes:
+ * - These types represent the JSON config file structure (fields may be optional)
+ * - llm/types.ts types represent runtime API contracts (required fields for operation)
+ */
+export interface LLMOptions {
+    temperature?: number;
+    num_ctx?: number;
+    max_tokens?: number;
+}
+export interface LLMConfig {
+    provider: string;
+    model?: string;
+    options?: LLMOptions;
+}
+export interface ProviderConfig {
+    baseUrl: string;
+    apiKey?: string;
+    model?: string;
+    options?: LLMOptions;
+}
+export interface SandboxConfig {
+    maxSubCalls: number;
+    turnTimeoutMs: number;
+    memoryLimitMb: number;
+}
+export interface RLMConfig {
+    maxTurns: number;
+}
+export interface Config {
+    llm: LLMConfig;
+    providers: Record<string, ProviderConfig>;
+    sandbox: SandboxConfig;
+    rlm: RLMConfig;
+}
+export declare function loadConfig(configPath?: string): Promise<Config>;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AAEH,MAAM,WAAW,UAAU;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,MAAM;IACrB,GAAG,EAAE,SAAS,CAAC;IACf,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IAC1C,OAAO,EAAE,aAAa,CAAC;IACvB,GAAG,EAAE,SAAS,CAAC;CAChB;AA0BD,wBAAsB,UAAU,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAqBrE"}