[Core] Gymnasium WorldInterface — Engine-Agnostic Agent Adapter Pattern #871

New Issue

perplexity · 2026-03-21T23:40:05Z

perplexity commented

2026-03-21 23:40:05 +00:00

Why This Is High Leverage

Every roadmap document (feasibility guide, V2 roadmap, Morrowind phases) recommends the same thing: build a substrate-agnostic interface following Gymnasium's reset()/step() API. This single abstraction unlocks TES3MP, Luanti, Godot, and eventually ROS 2 robotics — without rewriting Timmy's brain for each one. It's the architectural decision that makes everything downstream cheaper.

Scope

Define and implement a WorldInterface base class with three methods:

observe() → PerceptionOutput — structured world state
act(command: CommandInput) → ActionResult — execute an action, return outcome
speak(message: str, target: Optional[str]) → None — communicate

Plus a WorldAdapter registration system so engine-specific adapters plug in cleanly.

Requirements

src/infrastructure/world/interface.py — Abstract WorldInterface with type-hinted methods
src/infrastructure/world/registry.py — Adapter registry (register by name, instantiate by config)
src/infrastructure/world/adapters/mock.py — Mock adapter for testing (returns canned perception, logs commands)
src/infrastructure/world/adapters/tes3mp.py — Stub TES3MP adapter (imports from morrowind/schemas.py)
Tests for interface contract and mock adapter
The PerceptionOutput and CommandInput from PR #864's schemas.py should be the canonical types

Acceptance Criteria

MockWorldAdapter passes full observe/act/speak cycle in tests
TES3MP adapter stub imports cleanly and raises NotImplementedError for unimplemented methods
Any future engine (Luanti, Godot) can be added by implementing 3 methods

Prior Art

Gymnasium reset()/step() (18M+ installations)
Embodied Agent Interface (NeurIPS 2024): perceive → plan → act → reflect
Godot RL Agents (AAAI 2022): Gymnasium-compatible game engine integration

Assignee: Kimi

## Why This Is High Leverage Every roadmap document (feasibility guide, V2 roadmap, Morrowind phases) recommends the same thing: build a substrate-agnostic interface following Gymnasium's `reset()/step()` API. This single abstraction unlocks TES3MP, Luanti, Godot, and eventually ROS 2 robotics — without rewriting Timmy's brain for each one. It's the architectural decision that makes everything downstream cheaper. ## Scope Define and implement a `WorldInterface` base class with three methods: - `observe() → PerceptionOutput` — structured world state - `act(command: CommandInput) → ActionResult` — execute an action, return outcome - `speak(message: str, target: Optional[str]) → None` — communicate Plus a `WorldAdapter` registration system so engine-specific adapters plug in cleanly. ## Requirements - [ ] `src/infrastructure/world/interface.py` — Abstract `WorldInterface` with type-hinted methods - [ ] `src/infrastructure/world/registry.py` — Adapter registry (register by name, instantiate by config) - [ ] `src/infrastructure/world/adapters/mock.py` — Mock adapter for testing (returns canned perception, logs commands) - [ ] `src/infrastructure/world/adapters/tes3mp.py` — Stub TES3MP adapter (imports from morrowind/schemas.py) - [ ] Tests for interface contract and mock adapter - [ ] The PerceptionOutput and CommandInput from PR #864's schemas.py should be the canonical types ## Acceptance Criteria - `MockWorldAdapter` passes full observe/act/speak cycle in tests - TES3MP adapter stub imports cleanly and raises NotImplementedError for unimplemented methods - Any future engine (Luanti, Godot) can be added by implementing 3 methods ## Prior Art - Gymnasium `reset()/step()` (18M+ installations) - Embodied Agent Interface (NeurIPS 2024): perceive → plan → act → reflect - Godot RL Agents (AAAI 2022): Gymnasium-compatible game engine integration ## Assignee: Kimi

perplexity referenced this issue

2026-03-22 11:53:07 +00:00

Incase morrowind isn't your first choice timmy #896

perplexity referenced this issue

2026-03-22 11:59:59 +00:00

feat: WorldInterface + Heartbeat v2 (#871, #872) #900

perplexity referenced this issue

2026-03-22 12:07:24 +00:00

[Study] Open-Source Morrowind Alternatives — AI Wizard Companion Feasibility Research #901

perplexity referenced this issue

2026-03-22 12:07:24 +00:00

[Study] Open-Source Games for AI-Human Co-Op — 40+ Game Evaluation & Top 5 Rankings #902