{
"interval": {
"intervalStart": "2026-01-18T00:00:00.000Z",
"intervalEnd": "2026-01-25T00:00:00.000Z",
"intervalType": "week"
},
"repository": "elizaos/eliza",
"overview": "From 2026-01-18 to 2026-01-25, elizaos/eliza had 4 new PRs (2 merged), 2 new issues, and 14 active contributors.",
"topIssues": [
{
"id": "I_kwDOMT5cIs7j4-a7",
"title": "[Migration] Eligibility Mismatch & Snapshot Bug - Tangem Hardware Wallet",
"author": "Zenobow",
"number": 6369,
"repository": "elizaos/eliza",
"body": "Description: I am reporting a discrepancy in my $ai16z migration eligibility. My current $ai16z holdings are consolidated in my Tangem hardware wallet. During the official snapshot on Nov 11, 2025 (11:40 UTC), this wallet held the bulk of my tokens.\n\nThe Problem: When I connect to the migration portal (migrate.elizafoundation.ai), the system only recognizes a small fraction (710 tokens) which were held in a separate Solflare hot-wallet at the time. My Tangem wallet's snapshot balance is not being correctly identified or synced by the portal.\n\nVerified On-Chain Evidence (Tangem Wallet):\n\nHolding Address: 2SELmng3aKdrPKad41PEZA5XAt5Hex8TCpKrwY8AX8K8\n\nSnapshot Balance (Nov 11): 70,000 $ai16z\n\nSupporting Transaction Hashes:\n\n4gPGjNc31yPwJrSomHEgwGAWQyJcPmgYUKw8iu4NaMTQhTgEjvdd1TdwyEphg2qfhHvqmony5kHzJFhQa6syDNWb [43,000 ai16z]\n\n363QaEUbGTnDVK9Uvm9xqnDaphpdSY5YaQjgdC9xi3AcbNZJpW7H7gbEvaCLL5fcSoD1PeGqwddfgXbo6pC5Jfav [17,000 ai16z]\n\n5KDLm7qA71yrGfUW6SxzVTWY4KxBeYxuAPiWZWTAG4Y6xMex1JbjfzAYuDWTR86oKTXMcy2WDLAdnSgagKbR9x6q [8,000 ai16z]\n\n36UzzHTLVVN6xsi96YWZqCApkUfA8Z9T5AuXRuBi8ti1nvpQ6aS2tgcBYbRz497dAzAkdanefBZSGYm2Qyp9TSEi [2,000 ai16z]\n\nRequest: Please manually verify the snapshot data for address 2SELmng3aKdrPKad41PEZA5XAt5Hex8TCpKrwY8AX8K8 and whitelist the full eligible amount for the 1:6 $ELIZAOS swap. As Tangem does not support seed phrase export and has connection issues with the portal, I need this backend update to proceed before the February 4th deadline.\n\nThank you for your help!",
"createdAt": "2026-01-16T19:31:32Z",
"closedAt": "2026-01-22T17:10:29Z",
"state": "CLOSED",
"commentCount": 1
},
{
"id": "I_kwDOMT5cIs7hFeIt",
"title": "Public agent link format: elizacloud.ai/chat/[username]",
"author": "borisudovicic",
"number": 6304,
"repository": "elizaos/eliza",
"body": "",
"createdAt": "2026-01-02T12:50:16Z",
"closedAt": "2026-01-21T11:03:30Z",
"state": "CLOSED",
"commentCount": 0
},
{
"id": "I_kwDOMT5cIs7hFaKq",
"title": "Add agent discovery module to landing page and dashboard (Last)",
"author": "borisudovicic",
"number": 6302,
"repository": "elizaos/eliza",
"body": "Public agents will be listed here. \n\nSorting by newest/oldest, popular (we should bring back that chat count like character.ai), featured (allows us to manually showcase certain agents). Search by username?",
"createdAt": "2026-01-02T12:40:13Z",
"closedAt": "2026-01-21T11:03:32Z",
"state": "CLOSED",
"commentCount": 0
},
{
"id": "I_kwDOMT5cIs7h2AmG",
"title": "Fix TOCTOU race condition in credit deduction for streaming endpoints",
"author": "linear",
"number": 6338,
"repository": "elizaos/eliza",
"body": "Implement \"deduct-before, reconcile-after\" pattern to fix TOCTOU (Time-Of-Check-To-Time-Of-Use) race condition in streaming API endpoints.
Clean unification (we already do a good TOCTOU in MCP!
\n\n```markdown\nBEFORE (Vulnerable - Race Condition)\n════════════════════════════════════════════════════════════════════════════\n\n Request 1 ──┐\n Request 2 ──┼──▶ CHECK balance ≥ $0.02? ──▶ ✅ YES ──┐\n Request 3 ──┤ (all pass) │\n Request N ──┘ │\n ▼\n ┌──────────────────────────────────────────┐\n │ STREAMING (10+ sec) │\n │ No lock held on balance │\n └──────────────────────────────────────────┘\n │\n ▼\n All requests ──────────────────────────────▶ DEDUCT $0.02 each\n │\n ▼\n 💥 Balance goes NEGATIVE\n or deductions FAIL silently\n\n\nAFTER (Fixed - Atomic Reservation)\n════════════════════════════════════════════════════════════════════════════\n\n Request 1 ──┐ ┌─────────────────────────────────────────┐\n Request 2 ──┼──▶ │ ATOMIC: SELECT FOR UPDATE + DEDUCT │\n Request 3 ──┤ │ (PostgreSQL row lock on org balance) │\n Request N ──┘ └─────────────────────────────────────────┘\n │\n ┌─────────────────────────────┼─────────────────────────────┐\n │ │ │\n ▼ ▼ ▼\n Request 1 Request 2-N \n ✅ RESERVED ❌ 402 REJECTED\n $0.03 (with buffer) \"Insufficient credits\"\n │ \n ▼ \n ┌──────────────────────────────────────────┐\n │ STREAMING (10+ sec) │\n │ Credits already deducted │\n └──────────────────────────────────────────┘\n │\n ▼\n ┌──────────────────────────────────────────┐\n │ RECONCILE: actual cost = $0.012 │\n │ REFUND: $0.03 - $0.012 = $0.018 │\n └──────────────────────────────────────────┘\n │\n ▼\n ✅ Balance NEVER negative\n```",
"createdAt": "2026-01-07T14:38:08Z",
"closedAt": "2026-01-19T17:03:14Z",
"state": "CLOSED",
"commentCount": 0
},
{
"id": "I_kwDOMT5cIs7h041E",
"title": "Message processing parallelization",
"author": "linear",
"number": 6337,
"repository": "elizaos/eliza",
"body": "* Try/check if we can parallelize: saveMessage + getUserState + processAttachments\n* Fire-and-forget embedding queue could be a solution, check that",
"createdAt": "2026-01-07T13:18:39Z",
"closedAt": "2026-01-22T16:32:10Z",
"state": "CLOSED",
"commentCount": 0
}
],
"topPRs": [
{
"id": "PR_kwDOMT5cIs680DbX",
"title": "fix(v2.0.0): Python example testing & fixes",
"author": "odilitime",
"number": 6358,
"body": "- Add Python quickstart documentation (docs/python-quickstart.md)\r\n- Fix chat example to include inmemorydb plugin for database support\r\n- Add dotenv loading to chat example for .env file support\r\n- Fix inmemorydb plugin to use proper Plugin class instead of dict\r\n- Fix inmemorydb adapter to accept params dict in get_memories()\r\n- Fix inmemorydb adapter to handle Pydantic models in create_memory/update_memory\r\n- Fix character provider to use getattr for optional attributes\r\n- Add get_available_actions() method to AgentRuntime\r\n- Add get_entity() alias method to AgentRuntime\r\n- Update get_memories() to accept keyword arguments\r\n\r\nThe Python port had issues because:\r\nPlugin export - was a dict instead of Plugin object\r\nMethod signatures - expected dicts but got Pydantic models\r\nNo type enforcement - Python doesn't catch these at compile time\r\nThe Rust type system prevents these bugs automatically. The Python fixes we made bring it to parity with the working Rust implementation.\r\n\r\n# Risks\r\n\r\nMedium\r\n\r\n# Background\r\n\r\n## What does this PR do?\r\n\r\nFix examples/chat/python\r\n\r\n## What kind of change is this?\r\n\r\nBug fixes (non-breaking change which fixes an issue)\r\n\r\n## Why are we doing this? Any context or related work?\r\nReview\r\n\r\n# Documentation changes needed?\r\n\r\nmaybe\r\n\r\n\n\n---\n\n> [!NOTE]\n> Introduces true streaming and stabilizes Python runtime/plugins, plus major example and training additions.\n> \n> - Adds streaming text APIs: new `ModelType.TEXT_*_STREAM`, `AgentRuntime.use_model_stream()`/`register_streaming_model()`, and `DefaultMessageService.handle_message_stream()` with `StreamingMessageResult`\n> - OpenAI plugin implements streaming handlers; core exports updated to include streaming types\n> - Fixes `plugin-inmemorydb`: converted to proper `Plugin`, adapter now accepts `params`/kwargs, handles Pydantic models (camelCase keys), and corrects pagination/filters\n> - Hardens character provider to safely access optional fields via `getattr`\n> - AgentRuntime enhancements: `get_available_actions()`, `get_entity()` alias, `get_memories()` kwargs support\n> - A2A FastAPI server uses true token-by-token SSE streaming and includes `inmemorydb`; requirements updated\n> - Chat example loads `.env` and includes `inmemorydb` plugin\n> - ART Tic‑Tac‑Toe: adds heuristic agent, refines config (`opponent`, `ai_player`), winner/draw handling, and CLI updates\n> - New Atropos TextWorld package: environment/agents, trajectory + tokenizer tooling, offline data generation, BaseEnv factory, and CLI; README expanded\n> - Core Python README and example docs updated for setup and usage\n> \n> Written by [Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit 21f8c31fc22b7778f998d85c754ee82a0a8e2253. This will update automatically on new commits. Configure [here](https://cursor.com/dashboard?tab=bugbot).\n\n\n\r\n\r\n\r\n\r\nGreptile Overview
\r\n\r\n### Greptile Summary\r\n\r\nThis PR fixes the Python chat example and inmemorydb plugin to work together, adds Python quickstart documentation, and improves Character attribute handling. The changes include:\r\n\r\n**Key Improvements:**\r\n- Adds comprehensive Python quickstart documentation with examples\r\n- Fixes inmemorydb plugin to use proper Plugin class instead of dict\r\n- Enhances inmemorydb adapter to handle Pydantic models in create_memory/update_memory\r\n- Updates character provider to safely access optional attributes with getattr()\r\n- Adds dotenv support to chat example for .env file loading\r\n- Adds useful helper methods to AgentRuntime (get_available_actions, get_entity alias)\r\n- Enhances get_memories() to accept keyword arguments\r\n\r\n**Critical Issues Found:**\r\n1. **Bug in adapter.py line 329**: The update_memory() method references the wrong variable name (`memory` instead of `memory_dict`), which will cause AttributeError when processing Pydantic models\r\n2. **Bug in character.py lines 70-73**: Inconsistent attribute access - uses getattr() in function body but direct access in return data dict, causing AttributeError for optional attributes\r\n3. **Missing dependency in chat.py**: Imports python-dotenv but it's not in requirements.txt\r\n4. **Incomplete documentation**: Quickstart guide doesn't include inmemorydb plugin installation that the chat example now requires\r\n\r\n**Impact:**\r\nThe bugs in adapter.py and character.py are critical and will cause runtime errors. The missing dependencies will prevent users from running the example successfully.\r\n\r\n### Confidence Score: 1/5\r\n\r\n- This PR contains critical bugs that will cause runtime failures and prevent the chat example from working\r\n- Score reflects two critical logic errors (wrong variable reference in adapter.py:329 and inconsistent attribute access in character.py:70-73) plus missing dependencies that will cause import errors. These issues will break the example for users and cause AttributeErrors at runtime.\r\n- Pay close attention to plugins/plugin-inmemorydb/python/elizaos_plugin_inmemorydb/adapter.py (line 329 bug), packages/python/elizaos/bootstrap/providers/character.py (lines 70-73 inconsistency), and examples/chat/python/chat.py (missing python-dotenv dependency)\r\n\r\nImportant Files Changed
\r\n\r\n\r\n\r\nFile Analysis\r\n\r\n\r\n\r\n| Filename | Score | Overview |\r\n|----------|-------|----------|\r\n| docs/python-quickstart.md | 3/5 | New documentation file added. Missing plugin-inmemorydb installation instruction that the chat example now requires. |\r\n| examples/chat/python/chat.py | 2/5 | Added dotenv and inmemorydb support. Missing python-dotenv dependency in requirements, which will cause import errors. |\r\n| packages/python/elizaos/bootstrap/providers/character.py | 2/5 | Fixed to use getattr for optional character attributes. Critical bug: return data dict directly accesses attributes without getattr, causing AttributeError. |\r\n| plugins/plugin-inmemorydb/python/elizaos_plugin_inmemorydb/adapter.py | 1/5 | Enhanced get_memories(), create_memory(), and update_memory() to handle Pydantic models. Critical bug in update_memory line 329: uses wrong variable name. |\r\n\r\n\r\n\r\n\r\n\r\nSequence Diagram
\r\n\r\n```mermaid\r\nsequenceDiagram\r\n participant User\r\n participant chat.py\r\n participant dotenv\r\n participant AgentRuntime\r\n participant OpenAIPlugin\r\n participant InMemoryDBPlugin\r\n participant InMemoryAdapter\r\n participant CharacterProvider\r\n\r\n User->>chat.py: Run python chat.py\r\n chat.py->>dotenv: load_dotenv(env_path)\r\n dotenv-->>chat.py: Load .env from repo root\r\n \r\n chat.py->>AgentRuntime: Create with character and plugins\r\n AgentRuntime->>OpenAIPlugin: Initialize OpenAI plugin\r\n AgentRuntime->>InMemoryDBPlugin: Initialize InMemoryDB plugin\r\n InMemoryDBPlugin->>InMemoryAdapter: create_database_adapter(agent_id)\r\n InMemoryAdapter-->>InMemoryDBPlugin: Return adapter instance\r\n InMemoryDBPlugin->>AgentRuntime: register_database_adapter(adapter)\r\n \r\n AgentRuntime->>CharacterProvider: get_character_context()\r\n CharacterProvider->>CharacterProvider: Use getattr() for optional attributes\r\n CharacterProvider-->>AgentRuntime: Return character context\r\n \r\n AgentRuntime-->>chat.py: Runtime initialized\r\n \r\n User->>chat.py: Type message\r\n chat.py->>AgentRuntime: handle_message(runtime, memory)\r\n AgentRuntime->>InMemoryAdapter: get_memories(params)\r\n InMemoryAdapter-->>AgentRuntime: Return memories\r\n AgentRuntime->>OpenAIPlugin: Generate response\r\n OpenAIPlugin-->>AgentRuntime: Return response\r\n AgentRuntime->>InMemoryAdapter: create_memory(memory_dict)\r\n InMemoryAdapter-->>AgentRuntime: Memory stored\r\n AgentRuntime-->>chat.py: Return result\r\n chat.py-->>User: Display response\r\n```\r\n\r\n\r\n\r\n\n\n\n## Summary by CodeRabbit\n\n* **New Features**\n * In-memory database plugin for agent memory.\n * Token-by-token streaming for chat responses and streaming endpoints.\n * Atropos data-generation, trajectory tooling, and TextWorld agent integrations.\n * New Tic‑Tac‑Toe AI/player options and interactive configuration.\n\n* **Documentation**\n * Expanded developer setup, examples, runnable chat walkthroughs, and new Atropos CLI flags.\n\n* **Other**\n * Updated Python packaging/requirements and repository-root .env loading for examples.\n\n✏️ Tip: You can customize this high-level summary in your review settings.\n",
"repository": "elizaos/eliza",
"createdAt": "2026-01-13T00:34:32Z",
"mergedAt": "2026-01-22T01:20:54Z",
"additions": 17483,
"deletions": 8280
},
{
"id": "PR_kwDOMT5cIs6-HSpn",
"title": "V2.0.0: dynamic execution engine (test if context is going to blown)",
"author": "odilitime",
"number": 6384,
"body": "Redo #6113 for 2.0.0, first pass\n\n\n---\n\n> [!NOTE]\n> Introduces a validation-aware, schema-driven prompt execution path and applies it across runtimes and message flows.\n> \n> - Adds `dynamic_prompt_exec_from_state`/`dynamicPromptExecFromState` (TS/Python/Rust) with per-field/checkpoint UUID validation codes, required-field checks, and retry with backoff; supports XML/JSON\n> - Refactors message handling (should-respond, single-shot, multi-step decision, final summary) to use structured schemas instead of ad-hoc parsing\n> - Implements streaming support in TS with `ValidationStreamExtractor`, `MarkableExtractor`, and streaming context helpers; emits rich `StreamEvent`s\n> - Introduces shared types: `SchemaRow`, `RetryBackoffConfig`, `StreamEvent(Type)` in Python/Rust/TS type modules\n> - Adds XML parsing utilities (nested-safe) and normalizes structured responses; basic templating in Rust, Handlebars in TS\n> - Exposes validation level configuration (0–3) and model selection; defaults to large text models\n> \n> Written by [Cursor Bugbot](https://cursor.com/dashboard?tab=bugbot) for commit 1e447bbc005cbad715eb819aba27eb35b54aa5b8. This will update automatically on new commits. Configure [here](https://cursor.com/dashboard?tab=bugbot).\n\n\n\n\n## Summary by CodeRabbit\n\n* **New Features**\n * Added dynamic prompt execution with state injection and schema-driven validation.\n * Enabled validation-aware streaming with configurable validation levels (0-3).\n * Introduced built-in retry logic with exponential backoff for improved resilience.\n * Support for structured output validation across JSON and XML formats.\n * Per-field and checkpoint-level validation for enhanced data integrity.\n\n✏️ Tip: You can customize this high-level summary in your review settings.\n\n\n\n\n\nGreptile Summary
\n\n\nIntroduces `dynamicPromptExecFromState()` across Python, Rust, and TypeScript runtimes to provide schema-driven prompt execution with context validation via UUID codes. The implementation detects when LLMs truncate output due to limited context windows by injecting validation codes at strategic positions (start/middle/end or per-field). Supports four validation levels (0=trusted to 3=full), exponential backoff retries, and optional validation-aware streaming via `ValidationStreamExtractor`.\n\n**Key changes:**\n- Cross-language API consistency for dynamic prompt execution with state injection\n- Validation code system to detect context overflow (4 levels: trusted, progressive, checkpoint, full)\n- Streaming integration with progressive validation and retry support\n- Schema-based structured output parsing (XML/JSON) with required field validation\n- Performance metrics tracking per model+schema combination (TypeScript only)\n- Comprehensive type definitions (`SchemaRow`, `RetryBackoffConfig`, `StreamEvent`)\n\n**Critical issues in Python implementation:**\n- Callable prompt invocation wraps state incorrectly (`{\"state\": state}` vs direct state access)\n- Template substitution assumes `state.values` has dynamic attributes accessible via `dir()`, incompatible with protobuf State\n- XML parsing regex `\\w+` won't match validation field names with underscores like `code_text_start`\n\n**Minor issues:**\n- Rust template rendering uses basic string replacement instead of full Handlebars compiler\n- TypeScript `_smartRetryContext` deletion during retry loop prevents reuse on subsequent attempts\n- ValidationStreamExtractor abort handling may leave inconsistent state\n\nConfidence Score: 3/5
\n\n\n- Python implementation has runtime errors that will break production usage; TypeScript and Rust implementations are safer but need testing\n- Score reflects critical logical errors in Python (3 bugs that will cause runtime failures), plus architecture differences across languages. TypeScript implementation is most complete with metrics and full Handlebars support. Python bugs must be fixed before merge to avoid breaking callers.\n- `packages/python/elizaos/runtime.py` requires immediate fixes for callable invocation, state.values access pattern, and XML regex. Test the Python implementation thoroughly before merging.\n\nImportant Files Changed
\n\n\n\n\n| Filename | Overview |\n|----------|----------|\n| packages/python/elizaos/runtime.py | Adds `dynamic_prompt_exec_from_state` with validation codes and retry logic; has critical bugs in callable invocation, state.values access, and XML parsing regex |\n| packages/rust/src/runtime.rs | Implements `dynamic_prompt_exec_from_state` with validation and retry; template rendering is basic string replacement vs full Handlebars |\n| packages/typescript/src/runtime.ts | Implements `dynamicPromptExecFromState` with metrics, streaming, and validation; minor issue with `_smartRetryContext` deletion timing |\n| packages/typescript/src/utils/streaming.ts | Implements validation-aware streaming with multiple extractor types; minor state inconsistency on abort signal |\n\n\n\n\n\nSequence Diagram
\n\n```mermaid\nsequenceDiagram\n participant Client\n participant Runtime\n participant ValidationExtractor\n participant LLM\n participant Parser\n\n Client->>Runtime: dynamicPromptExecFromState(state, schema, options)\n \n Note over Runtime: Generate validation codes
(UUID snippets)\n \n Runtime->>Runtime: Build extended schema
with validation fields\n \n Runtime->>Runtime: Inject codes into prompt
(initial, middle, end)\n \n Runtime->>Runtime: Compile template with
Handlebars/state values\n \n alt Streaming enabled\n Runtime->>ValidationExtractor: Create extractor
(level, schema, codes)\n end\n \n loop Retry attempts (0 to maxRetries)\n Runtime->>LLM: Generate text with prompt\n \n alt Streaming\n loop Stream chunks\n LLM-->>ValidationExtractor: chunk\n ValidationExtractor->>ValidationExtractor: Extract field content\n ValidationExtractor->>ValidationExtractor: Check per-field codes
(level 0-1)\n ValidationExtractor-->>Client: Stream validated content\n end\n else Non-streaming\n LLM-->>Runtime: Complete response\n end\n \n Runtime->>Runtime: Clean response
(remove tags)\n \n Runtime->>Parser: Parse XML/JSON response\n Parser-->>Runtime: Parsed fields object\n \n Runtime->>Runtime: Normalize structured response\n \n alt Validation level 0-1\n loop For each field with code\n Runtime->>Runtime: Check start/end codes match\n end\n else Validation level 2-3\n Runtime->>Runtime: Check checkpoint codes
(one_initial, one_middle, etc)\n end\n \n Runtime->>Runtime: Validate required fields
are present and non-empty\n \n alt All validations pass\n alt Streaming (level 2-3)\n Runtime->>ValidationExtractor: flush()\n ValidationExtractor-->>Client: Buffered content\n end\n Runtime->>Runtime: Remove validation code fields\n Runtime->>Runtime: Update success metrics\n Runtime-->>Client: Return parsed response\n else Validation fails\n alt Has retries remaining\n Runtime->>Runtime: Calculate backoff delay\n Runtime->>Runtime: Wait for backoff\n Note over Runtime: Loop continues with retry\n else No retries left\n Runtime->>Runtime: Update failure metrics\n Runtime-->>Client: Return null\n end\n end\n end\n```\n\n\n\n",
"repository": "elizaos/eliza",
"createdAt": "2026-01-20T02:29:59Z",
"mergedAt": null,
"additions": 4309,
"deletions": 1591
},
{
"id": "PR_kwDOMT5cIs69CGSx",
"title": "feat(v2.0.0): wasm agent runtime",
"author": "revlentless",
"number": 6363,
"body": "# Summary\r\n\r\nRust WASM implementation for elizaOS v2.0.0 - enabling the Rust core to run in browser/Node.js environments via WebAssembly.\r\n\r\n# Risks\r\n\r\n**Low risk.** This PR:\r\n- Makes no breaking API changes to existing Rust code\r\n- Uses conditional compilation (`#[cfg]`) so native builds are unaffected\r\n- All existing tests continue to pass\r\n- Adds new WASM-specific code paths that only activate when building for `wasm32-unknown-unknown`\r\n\r\n# Background\r\n\r\n## What does this PR do?\r\n\r\nThis PR makes the elizaOS Rust core **fully WASM-compatible**, enabling it to run in browsers and Node.js via WebAssembly. The existing Rust crate had WASM bindings but they were stubs - the `WasmAgentRuntime` was a placeholder that didn't actually wrap the real `AgentRuntime`.\r\n\r\nThe key challenge was that Rust's `async_trait` and many traits require `Send + Sync` bounds for thread-safety, but WASM is single-threaded and doesn't support these traits. This PR implements platform-aware macros and conditional compilation to provide the correct bounds for each target.\r\n\r\n### Key Changes\r\n\r\n#### 1. Platform-Aware Macros (`src/platform.rs`)\r\n\r\n```rust\r\n// Native: #[async_trait] (requires Send)\r\n// WASM: #[async_trait(?Send)] (no Send requirement)\r\nplatform_async_trait! {\r\n pub trait MyTrait { ... }\r\n}\r\n\r\n// Native: pub trait MyTrait: Send + Sync { ... }\r\n// WASM: pub trait MyTrait { ... }\r\ndefine_platform_trait! {\r\n pub trait MyTrait { ... }\r\n}\r\n```\r\n\r\n#### 2. Core Trait Migration\r\n\r\nAll core traits now compile for both targets:\r\n- `ActionHandler`, `ProviderHandler`, `EvaluatorHandler`\r\n- `DatabaseAdapter`, `Service`, `IAgentRuntime`\r\n- Bootstrap traits: `Action`, `Provider`, `Evaluator`, `Service`\r\n\r\n#### 3. Real WasmAgentRuntime\r\n\r\nThe `WasmAgentRuntime` now wraps the actual `AgentRuntime` using WASM-appropriate primitives:\r\n\r\n```rust\r\npub struct WasmAgentRuntime {\r\n inner: Rc>>, // Not Arc - WASM is single-threaded\r\n character: RefCell,\r\n agent_id: UUID,\r\n}\r\n```\r\n\r\n#### 4. Structured WASM Errors\r\n\r\nRich error objects for JavaScript consumers:\r\n\r\n```rust\r\npub struct WasmError {\r\n pub code: String, // \"VALIDATION_ERROR\", \"RUNTIME_ERROR\", etc.\r\n pub message: String, // Human-readable message\r\n pub source: Option, // Field/component that caused error\r\n}\r\n```\r\n\r\n#### 5. JavaScript Shims\r\n\r\nType-safe wrappers for JS callbacks:\r\n\r\n```rust\r\npub struct JsModelHandler {\r\n js_object: JsValue,\r\n handle_func: Function,\r\n}\r\n```\r\n\r\n#### 6. Bug Fix: ChannelType Serialization\r\n\r\nFixed `ChannelType` enum to serialize correctly:\r\n- Before: `VoiceDm` → `\"VOICEDM\"` ❌\r\n- After: `VoiceDm` → `\"VOICE_DM\"` ✅\r\n\r\n## What kind of change is this?\r\n\r\n- **Features** (non-breaking change which adds functionality)\r\n- **Bug fixes** (ChannelType serialization)\r\n- **Improvements** (structured errors, better WASM integration)\r\n\r\n# Documentation changes needed?\r\n\r\nMy changes require a change to the project documentation:\r\n- Added `examples/README.md` with usage instructions for native and WASM examples\r\n- WASM module includes JSDoc comments for all exports\r\n\r\n# Testing\r\n\r\n## Where should a reviewer start?\r\n\r\n1. `src/platform.rs` - Platform macros (foundation of the approach)\r\n2. `src/types/components.rs` - Core handler traits with conditional compilation\r\n3. `src/wasm/mod.rs` - WasmAgentRuntime implementation\r\n4. `__tests__/wasm/` - TypeScript tests verifying WASM bindings\r\n\r\n## Detailed testing steps\r\n\r\n### Native Tests (Rust)\r\n```bash\r\ncd packages/rust\r\ncargo test --features native\r\n# Expected: 79 tests pass\r\n```\r\n\r\n### WASM Binding Tests (TypeScript/Vitest)\r\n```bash\r\ncd packages/rust\r\nnpx vitest run __tests__/wasm/wasm-bindings.test.ts\r\n# Expected: 16 tests pass\r\n```\r\n\r\n### Full Test Suite\r\n```bash\r\ncd packages/rust\r\n./run-all-tests.sh\r\n# Expected: 108 passed, 0 failed, 2 skipped\r\n```\r\n\r\n### Native Examples\r\n```bash\r\ncargo run --example basic_runtime --features native\r\ncargo run --example with_handlers --features native\r\n```\r\n\r\n### WASM Examples (Bun)\r\n```bash\r\nbun run examples/wasm/basic.ts\r\nbun run examples/wasm/runtime.ts\r\nbun run examples/wasm/chat.ts # Interactive\r\n```\r\n\r\n## Test Coverage\r\n\r\n| Suite | Tests | Status |\r\n|-------|-------|--------|\r\n| Rust native (`cargo test`) | 79 | ✅ |\r\n| WASM bindings (Vitest) | 16 | ✅ |\r\n| Interop equivalence (Vitest) | 16 | ✅ |\r\n| Python serialization | 22 | ✅ |\r\n| **Total** | **133** | ✅ |\r\n\r\n# Commits\r\n\r\n| Commit | Description |\r\n|--------|-------------|\r\n| `2ea503d` | feat(rust): improved WASM foundation with structured errors and JS shims |\r\n| `d00b690` | chore(rust): add wasm-test.sh for running WASM tests |\r\n| `e2b9ff7` | fix(rust): gate tokio tests for native-only, fix WASM test imports |\r\n| `f74293d` | feat(rust): add platform-aware macros for native/WASM compatibility |\r\n| `90c3e0e` | fix(rust): correct ChannelType serialization to match TypeScript |\r\n| `9c87349` | feat(rust): make core traits WASM-compatible |\r\n| `fbffb3d` | test(rust): expand WASM test coverage |\r\n| `9c3bc11` | test(rust): add WASM tests for platform macros |\r\n| `368f0aa` | test(rust): add WASM tests for core handler traits |\r\n| `17bfad1` | feat(rust): make all async_trait impls WASM-compatible |\r\n| `15c96d4` | feat(rust): upgrade WasmAgentRuntime to wrap real AgentRuntime |\r\n| `a4f717e` | test(rust): add comprehensive WASM integration tests |\r\n| `629d30a` | style: apply cargo fmt across all files |\r\n| `6a58014` | docs(rust): add native and WASM examples |\r\n| `85a4043` | fix(rust): fix WASM tests to match Rust type definitions |\r\n| `cbaea5a` | fix(rust): fix TypeScript type errors in WASM tests |\r\n\r\n# Files Changed\r\n\r\n```\r\npackages/rust/\r\n├── src/\r\n│ ├── platform.rs # NEW: Platform macros\r\n│ ├── lib.rs # Export platform module\r\n│ ├── runtime.rs # Conditional Send+Sync on traits\r\n│ ├── types/\r\n│ │ ├── components.rs # ActionHandler, ProviderHandler, EvaluatorHandler\r\n│ │ ├── service.rs # Service, TypedService traits\r\n│ │ └── environment.rs # ChannelType serialization fix\r\n│ ├── bootstrap/\r\n│ │ ├── runtime.rs # IAgentRuntime trait\r\n│ │ ├── actions/mod.rs # Action trait\r\n│ │ ├── providers/mod.rs # Provider trait\r\n│ │ ├── evaluators/mod.rs # Evaluator trait\r\n│ │ └── services/mod.rs # Service trait\r\n│ └── wasm/\r\n│ ├── mod.rs # WasmAgentRuntime (upgraded)\r\n│ ├── error.rs # NEW: WasmError struct\r\n│ └── shims/\r\n│ ├── mod.rs # NEW: JS shim exports\r\n│ └── model_handler.rs # NEW: JsModelHandler\r\n├── __tests__/\r\n│ └── wasm/\r\n│ ├── wasm-bindings.test.ts # WASM binding tests\r\n│ └── interop-equivalence.test.ts # Serialization equivalence tests\r\n├── examples/\r\n│ ├── README.md # NEW: Examples documentation\r\n│ ├── basic_runtime.rs # NEW: Native example\r\n│ ├── with_handlers.rs # NEW: Native example\r\n│ └── wasm/\r\n│ ├── basic.ts # NEW: WASM/Bun example\r\n│ ├── runtime.ts # NEW: WASM/Bun example\r\n│ └── chat.ts # NEW: Interactive chat example\r\n├── Cargo.toml # Example entries\r\n├── package.json # npm scripts for examples\r\n├── run-all-tests.sh # Updated test runner\r\n└── wasm-test.sh # NEW: WASM test script\r\n```\r\n\r\n# Architecture\r\n\r\n```\r\n┌─────────────────────────────────────────────────────────────┐\r\n│ Conditional Compilation │\r\n├─────────────────────────────────────────────────────────────┤\r\n│ #[cfg(not(target_arch = \"wasm32\"))] │ #[cfg(wasm32)] │\r\n├───────────────────────────────────────┼─────────────────────┤\r\n│ trait Foo: Send + Sync │ trait Foo │\r\n│ #[async_trait] │ #[async_trait(?Send)]│\r\n│ Arc │ Rc> │\r\n│ tokio runtime │ wasm-bindgen-futures│\r\n└───────────────────────────────────────┴─────────────────────┘\r\n │\r\n ▼\r\n┌─────────────────────────────────────────────────────────────┐\r\n│ WasmAgentRuntime │\r\n├─────────────────────────────────────────────────────────────┤\r\n│ inner: Rc>> │\r\n│ │\r\n│ Methods: │\r\n│ - create(character_json) → WasmAgentRuntime │\r\n│ - initialize() → Promise │\r\n│ - handleMessage(msg_json) → Promise │\r\n│ - registerModelHandler(type, JsModelHandler) │\r\n│ - stop() │\r\n└─────────────────────────────────────────────────────────────┘\r\n │\r\n ▼\r\n┌─────────────────────────────────────────────────────────────┐\r\n│ JavaScript Usage │\r\n├─────────────────────────────────────────────────────────────┤\r\n│ import { WasmAgentRuntime, JsModelHandler } from 'elizaos';│\r\n│ │\r\n│ const runtime = WasmAgentRuntime.create(characterJson); │\r\n│ await runtime.initialize(); │\r\n│ │\r\n│ runtime.registerModelHandler('TEXT_LARGE', new JsModelHandler({│\r\n│ handle: async (params) => { /* call LLM */ } │\r\n│ })); │\r\n│ │\r\n│ const response = await runtime.handleMessage(messageJson); │\r\n└─────────────────────────────────────────────────────────────┘\r\n```\n\n\n\n# Greptile Summary
\n\n\n- Implements comprehensive WASM compatibility for elizaOS Rust core, enabling the runtime to execute in browsers and Node.js environments via WebAssembly without breaking existing native functionality\n- Introduces platform-aware macros and conditional compilation patterns to handle Send+Sync trait differences between native (multi-threaded) and WASM (single-threaded) targets\n- Upgrades `WasmAgentRuntime` from a stub implementation to a fully functional wrapper around the real `AgentRuntime`, with structured error handling, JavaScript interop shims, and comprehensive test coverage\n\n# Important Files Changed\n\n| Filename | Overview |\n|----------|----------|\n| `packages/rust/src/platform.rs` | New platform abstraction module providing macros for conditional async_trait bounds and Send+Sync requirements |\n| `packages/rust/src/wasm/mod.rs` | Upgraded WasmAgentRuntime implementation wrapping real AgentRuntime with WASM-compatible primitives and structured errors |\n| `packages/rust/src/types/components.rs` | Core handler traits migrated to use platform-aware conditional compilation for ActionHandler, ProviderHandler, and EvaluatorHandler |\n| `packages/rust/tests/wasm_tests.rs` | New comprehensive WASM test suite with 1506 lines validating cross-platform compatibility and JavaScript interoperability |\n| `packages/rust/src/types/environment.rs` | Fixed ChannelType serialization to use SCREAMING_SNAKE_CASE format for TypeScript compatibility (\"VOICE_DM\" instead of \"VOICEDM\") |\n\n# Confidence score: 5/5\n\n- This PR is extremely safe to merge with minimal risk of production issues\n- Score reflects excellent architectural approach using conditional compilation, comprehensive test coverage (133 tests passing), and non-breaking changes that preserve all native functionality while adding new WASM capabilities\n- All files demonstrate consistent application of platform-aware patterns with proper error handling and thorough documentation\n\nSequence Diagram
\n\n```mermaid\nsequenceDiagram\n participant User\n participant WasmAgentRuntime\n participant JsModelHandler\n participant AgentRuntime\n participant Character\n participant State\n participant ModelHandler\n\n User->>WasmAgentRuntime: create(characterJson)\n WasmAgentRuntime->>Character: parse JSON\n Character-->>WasmAgentRuntime: Character instance\n WasmAgentRuntime-->>User: WasmAgentRuntime\n\n User->>WasmAgentRuntime: initialize()\n WasmAgentRuntime->>AgentRuntime: new(RuntimeOptions)\n AgentRuntime-->>WasmAgentRuntime: AgentRuntime instance\n WasmAgentRuntime-->>User: Promise\n\n User->>WasmAgentRuntime: registerModelHandler(type, handler)\n WasmAgentRuntime->>JsModelHandler: store handler\n JsModelHandler-->>WasmAgentRuntime: registered\n\n User->>WasmAgentRuntime: handleMessage(messageJson)\n WasmAgentRuntime->>Memory: parse message JSON\n Memory-->>WasmAgentRuntime: Memory instance\n WasmAgentRuntime->>AgentRuntime: compose_state(message)\n AgentRuntime->>State: build state\n State-->>AgentRuntime: State instance\n WasmAgentRuntime->>Character: get character data\n Character-->>WasmAgentRuntime: character info\n WasmAgentRuntime->>WasmAgentRuntime: build prompt\n WasmAgentRuntime->>JsModelHandler: call(params)\n JsModelHandler->>ModelHandler: handle(paramsJson)\n ModelHandler-->>JsModelHandler: responseJson\n JsModelHandler-->>WasmAgentRuntime: response text\n WasmAgentRuntime->>Memory: create response memory\n Memory-->>WasmAgentRuntime: response memory\n WasmAgentRuntime-->>User: Promise\n\n User->>WasmAgentRuntime: stop()\n WasmAgentRuntime->>JsModelHandler: clear handlers\n WasmAgentRuntime->>AgentRuntime: cleanup\n WasmAgentRuntime-->>User: stopped\n```\n\n\n\nContext used (3)
\n\n- Context from `dashboard` - CLAUDE.md ([source](https://app.greptile.com/review/custom-context?memory=8ef4c9a3-e221-4aef-8556-8c9b88bf6bbb))\n- Context from `dashboard` - .cursorrules ([source](https://app.greptile.com/review/custom-context?memory=00074882-001f-44b1-89c4-859ed3656db9))\n- Context from `dashboard` - AGENTS.md ([source](https://app.greptile.com/review/custom-context?memory=51febe90-8918-4f18-be1f-d43bb68d696c))\n