feat: enhance frontend module organization and error handling

- Updated `CLAUDE.md` to clarify the frontend module layout, emphasizing co-location of components, hooks, and stores for better feature cohesion.
- Refactored imports in various components to align with the new module structure, ensuring consistency across the application.
- Introduced translation support in the `ErrorBoundary` component for improved user experience during error handling.
- Deleted unused files and optimized imports to streamline the codebase.

Author: knqiufan

CLAUDE.md

@@ -146,6 +146,7 @@ cargo build          # Standalone Rust build when not using npm wrapper
 - Rust 2021 edition, standard module layout
 - TypeScript strict mode
 - No default exports (use named exports)
+- **Frontend module layout (co-location is intentional)**: `src/` is organized top-level by responsibility (`components/` `hooks/` `stores/` `lib/` `pages/` `locales/` `styles/`), and `components/` by feature (`ui/` shadcn primitives, `layout/` shell chrome, `chat/` the chat feature tree). **Co-locate a feature's `.tsx`, `.ts` helpers, and hooks together inside its feature folder** (e.g. `components/chat/composer/MessageInput.tsx` beside `attachmentUtils.ts`, `useComposerTextSelection.ts`) — this is deliberate feature cohesion, not "mixing"; do **not** split them out into separate `lib/services/hooks` trees. Cross-cutting hooks that serve the whole app live in `hooks/`; feature-specific hooks stay co-located. **Store imports are always direct** (`@/stores/<name>-store`); there is intentionally no `stores/` barrel.
 - **Frontend UI/UX**: Any time you author or refactor React UI or styling (`src/**/*.tsx`, shared CSS tokens, shell layout), **read and comply with** the project’s UI specs (they are complementary, not optional pick-one):
   - **Path-scoped reinforcement** (loads when editing matching files—reduces “forgot to load CLAUDE” cases):
     - **Cursor**: `.cursor/rules/misaka-frontend-ui-specs.mdc` (`globs`: `src/**/*.tsx`, `src/**/*.css`, `src/*.css`)

agent/_probe_winconsole.py

@@ -77,6 +77,3 @@ def bridge_provider_api_keys(settings_obj: Settings | None = None) -> None:
         bridged.append("OPENAI_API_KEY")
     if bridged:
         logger.info("Bridged provider API keys into process env: %s", ", ".join(bridged))
-
-
-settings = Settings()

agent/app/config.py

@@ -5,7 +5,7 @@
 
 from fastapi import FastAPI
 
-from app.config import bridge_provider_api_keys, settings
+from app.config import bridge_provider_api_keys, get_settings
 from app.dependencies import close_checkpointer, setup_checkpointer
 from app.routers.agent import router as agent_router
 from app.routers.health import router as health_router
@@ -29,7 +29,7 @@ async def lifespan(application: FastAPI):
     title="MisakaX Agent",
     version="0.1.0",
     description="MisakaX Agent Sidecar - LangGraph + PowerMem",
-    debug=settings.debug,
+    debug=get_settings().debug,
     lifespan=lifespan,
 )
 

agent/app/main.py

@@ -110,3 +110,29 @@ class InfoResponse(BaseModel):
     powermem_available: bool = False
 
     model_config = {"frozen": False, "extra": "ignore"}
+
+
+# --------------------------------------------------------------------------- #
+#  Memory models
+# --------------------------------------------------------------------------- #
+
+class MemoryItem(BaseModel):
+    """A single normalized memory entry returned by the memory REST API."""
+
+    id: str | None = None
+    content: str = ""
+    score: float | None = None
+    created_at: str | None = None
+    metadata: dict[str, Any] = Field(default_factory=dict)
+
+    model_config = {"frozen": False, "extra": "ignore"}
+
+
+class MemoryListResponse(BaseModel):
+    """Paginated list of memory items."""
+
+    items: list[MemoryItem]
+    offset: int = 0
+    limit: int = 20
+
+    model_config = {"frozen": False, "extra": "ignore"}

agent/app/models.py

@@ -6,28 +6,14 @@
 from typing import Any
 
 from fastapi import APIRouter, HTTPException, Query
-from pydantic import BaseModel, Field
 
 from app.memory import get_memory_engine
+from app.models import MemoryItem, MemoryListResponse
 
 router = APIRouter(prefix="/memory", tags=["memory"])
 logger = logging.getLogger(__name__)
 
 
-class MemoryItem(BaseModel):
-    id: str | None = None
-    content: str = ""
-    score: float | None = None
-    created_at: str | None = None
-    metadata: dict[str, Any] = Field(default_factory=dict)
-
-
-class MemoryListResponse(BaseModel):
-    items: list[MemoryItem]
-    offset: int = 0
-    limit: int = 20
-
-
 def _require_engine() -> Any:
     engine = get_memory_engine()
     if engine is None:

agent/app/routers/memory.py

@@ -62,12 +62,13 @@ def _get_windows_console_stream(_stream, _encoding, _errors):  # noqa: ANN001, A
 
 import uvicorn  # noqa: E402  (import after DLL dir registration)
 
-from app.config import settings  # noqa: E402
+from app.config import get_settings  # noqa: E402
 from app.main import app  # noqa: E402
 
 
 def main() -> None:
     multiprocessing.freeze_support()
+    settings = get_settings()
     uvicorn.run(
         app,
         host=settings.host,