feat: Integrate Kokoro TTS with WebGPU and fallback

TODO.md

@@ -1,99 +1,99 @@
-# Project Implementation Plan
-
-## Phase 1: Project Setup and Basic Structure
-- [x] Define project goals and specifications
-- [x] Set up project structure
-  - [x] Create core directories (src, data, tests)
-  - [x] Initialize Node.js/npm project
-  - [x] Set up TypeScript configuration
-  - [ ] Configure ESLint and Prettier for code quality
-- [ ] Choose and set up testing framework
-- [x] Create basic documentation structure
-
-## Phase 2: World Model Implementation
-- [ ] Define YAML schema for world elements
-  - [ ] Room schema (description, exits, objects, characters)
-  - [ ] Object schema (description, properties, allowed actions)
-  - [ ] NPC schema (description, dialogue, behavior)
-  - [ ] Action schema (conditions, effects)
-- [x] Implement YAML parser and validator
-- [ ] Create the world model core
-  - [ ] Game state management
-  - [ ] Room navigation
-  - [ ] Object interaction
-  - [ ] NPC interaction
-  - [ ] Action processing logic
-- [x] Create a simple test world in YAML format
-- [ ] Implement unit tests for world model
-
-## Phase 3: LLM Integration
-- [x] Research and select appropriate OpenRouter model
-- [x] Implement OpenRouter API client
-  - [x] Configuration and authentication
-  - [x] API request/response handling
-  - [ ] Rate limiting and error handling
-- [ ] Design LLM prompting strategy
-  - [ ] System prompts for action translation
-  - [ ] System prompts for narrative generation
-  - [ ] Context management for conversation history
-- [ ] Create adapter between LLM and world model
-  - [ ] Define the interface for action translation
-  - [ ] Define the interface for narrative generation
-
-## Phase 4: Game Engine Core
-- [x] Implement the game loop
-  - [x] Input handling
-  - [ ] Action processing via LLM
-  - [ ] World model updating
-  - [ ] Response generation via LLM
-  - [ ] Output formatting
-- [ ] Implement saving/loading game state
-- [ ] Add game configuration options
-- [ ] Implement logging for debugging
-
-## Phase 5: User Interface
-- [x] Create a command-line interface
-  - [x] Input handling
-  - [x] Text output formatting
-  - [ ] Command history
-- [x] Implement a simple web interface
-  - [x] Basic HTML/CSS structure
-  - [x] JavaScript for interaction
-  - [x] Responsive design
-- [x] Text processing utilities
-  - [x] Implement smartypants.js for typographical improvements
-  - [ ] Add hyphenation support
-
-## Phase 6: Advanced Features
-- [ ] Implement integration layer for Z-machine
-  - [ ] Research Z-machine libraries
-  - [ ] Create adapter for Z-machine to world model interface
-  - [ ] Test with classic Infocom games
-- [ ] Add advanced LLM features
-  - [ ] Character styles and narrative tones
-  - [ ] Memory and reference to past events
-  - [ ] Player character personality modeling
-- [ ] Create plugin system for extending world model capabilities
-
-## Phase 7: Testing and Refinement
-- [ ] Comprehensive testing
-  - [ ] Unit tests for core components
-  - [ ] Integration tests for LLM integration
-  - [ ] End-to-end game flow tests
-  - [ ] User testing and feedback
-- [ ] Performance optimization
-  - [ ] Minimize LLM token usage
-  - [ ] Optimize world model for larger games
-- [ ] Refine prompting strategies based on testing
-
-## Phase 8: Documentation and Release
-- [x] Complete user documentation
-  - [x] Installation guide
-  - [ ] World creation guide
-  - [ ] Configuration reference
-- [ ] Complete developer documentation
-  - [ ] Architecture overview
-  - [ ] API reference
-  - [ ] Extension guide
-- [ ] Create example worlds and games
+# Project Implementation Plan
+
+## Phase 1: Project Setup and Basic Structure
+- [x] Define project goals and specifications
+- [x] Set up project structure
+  - [x] Create core directories (src, data, tests)
+  - [x] Initialize Node.js/npm project
+  - [x] Set up TypeScript configuration
+  - [ ] Configure ESLint and Prettier for code quality
+- [ ] Choose and set up testing framework
+- [x] Create basic documentation structure
+
+## Phase 2: World Model Implementation
+- [ ] Define YAML schema for world elements
+  - [ ] Room schema (description, exits, objects, characters)
+  - [ ] Object schema (description, properties, allowed actions)
+  - [ ] NPC schema (description, dialogue, behavior)
+  - [ ] Action schema (conditions, effects)
+- [x] Implement YAML parser and validator
+- [ ] Create the world model core
+  - [ ] Game state management
+  - [ ] Room navigation
+  - [ ] Object interaction
+  - [ ] NPC interaction
+  - [ ] Action processing logic
+- [x] Create a simple test world in YAML format
+- [ ] Implement unit tests for world model
+
+## Phase 3: LLM Integration
+- [x] Research and select appropriate OpenRouter model
+- [x] Implement OpenRouter API client
+  - [x] Configuration and authentication
+  - [x] API request/response handling
+  - [ ] Rate limiting and error handling
+- [ ] Design LLM prompting strategy
+  - [ ] System prompts for action translation
+  - [ ] System prompts for narrative generation
+  - [ ] Context management for conversation history
+- [ ] Create adapter between LLM and world model
+  - [ ] Define the interface for action translation
+  - [ ] Define the interface for narrative generation
+
+## Phase 4: Game Engine Core
+- [x] Implement the game loop
+  - [x] Input handling
+  - [ ] Action processing via LLM
+  - [ ] World model updating
+  - [ ] Response generation via LLM
+  - [ ] Output formatting
+- [ ] Implement saving/loading game state
+- [ ] Add game configuration options
+- [ ] Implement logging for debugging
+
+## Phase 5: User Interface
+- [x] Create a command-line interface
+  - [x] Input handling
+  - [x] Text output formatting
+  - [ ] Command history
+- [x] Implement a simple web interface
+  - [x] Basic HTML/CSS structure
+  - [x] JavaScript for interaction
+  - [x] Responsive design
+- [x] Text processing utilities
+  - [x] Implement smartypants.js for typographical improvements
+  - [ ] Add hyphenation support
+
+## Phase 6: Advanced Features
+- [ ] Implement integration layer for Z-machine
+  - [ ] Research Z-machine libraries
+  - [ ] Create adapter for Z-machine to world model interface
+  - [ ] Test with classic Infocom games
+- [ ] Add advanced LLM features
+  - [ ] Character styles and narrative tones
+  - [ ] Memory and reference to past events
+  - [ ] Player character personality modeling
+- [ ] Create plugin system for extending world model capabilities
+
+## Phase 7: Testing and Refinement
+- [ ] Comprehensive testing
+  - [ ] Unit tests for core components
+  - [ ] Integration tests for LLM integration
+  - [ ] End-to-end game flow tests
+  - [ ] User testing and feedback
+- [ ] Performance optimization
+  - [ ] Minimize LLM token usage
+  - [ ] Optimize world model for larger games
+- [ ] Refine prompting strategies based on testing
+
+## Phase 8: Documentation and Release
+- [x] Complete user documentation
+  - [x] Installation guide
+  - [ ] World creation guide
+  - [ ] Configuration reference
+- [ ] Complete developer documentation
+  - [ ] Architecture overview
+  - [ ] API reference
+  - [ ] Extension guide
+- [ ] Create example worlds and games
 - [ ] Prepare for initial release