Add REST API server with session management

- Add InstaVM-compatible REST API endpoints (/execute, /execute_async, /sessions)
- Implement session management with automatic cleanup
- Add multi-language support (Python, bash, JavaScript)
- Create API schemas matching InstaVM interface
- Update entrypoint to start both MCP and REST servers
- Expose REST API on port 8223 alongside MCP on 8222
- Add comprehensive error handling and health checks

Author: abhishek-anand

.aider.chat.history.md

@@ -0,0 +1,79 @@
+
+# aider chat started at 2025-07-09 14:48:55
+
+> You can skip this check with --no-gitignore  
+> Add .aider* to .gitignore (recommended)? (Y)es/(N)o [Yes]: y  
+> Added .aider* to .gitignore  
+> /Users/abhishekanand/.local/bin/aider --model azure/o4-mini --weak-model azure/o4-mini --no-auto-commits  
+> Aider v0.85.1  
+> Model: azure/o4-mini with diff edit format  
+> Git repo: .git with 21 files  
+> Repo-map: using 4096 tokens, auto refresh  
+
+#### analyze the project and suggest feature improvements and refactor suggestions  
+
+The key files you’ll most likely want to update for feature enhancements and refactoring are:
+
+• server.py  
+• requirements.txt  
+• Dockerfile  
+• entrypoint.sh  
+• README.md  
+
+Let me know which of these you’d like to add, and then I can propose precise changes.
+
+> Tokens: 2.9k sent, 59 received. Cost: $0.0035 message, $0.0035 session.  
+> Dockerfile  
+> Add file to the chat? (Y)es/(N)o/(A)ll/(S)kip all/(D)on't ask again [Yes]: a  
+> README.md  
+
+#### Add file to the chat? (Y)es/(N)o/(A)ll/(S)kip all/(D)on't ask again [Yes]: all  
+> Add file to the chat? (Y)es/(N)o/(A)ll/(S)kip all/(D)on't ask again [Yes]: a  
+> entrypoint.sh  
+
+#### Add file to the chat? (Y)es/(N)o/(A)ll/(S)kip all/(D)on't ask again [Yes]: all  
+> Add file to the chat? (Y)es/(N)o/(A)ll/(S)kip all/(D)on't ask again [Yes]: a  
+> requirements.txt  
+
+#### Add file to the chat? (Y)es/(N)o/(A)ll/(S)kip all/(D)on't ask again [Yes]: all  
+> Add file to the chat? (Y)es/(N)o/(A)ll/(S)kip all/(D)on't ask again [Yes]: a  
+> server.py  
+
+#### Add file to the chat? (Y)es/(N)o/(A)ll/(S)kip all/(D)on't ask again [Yes]: all  
+> Add file to the chat? (Y)es/(N)o/(A)ll/(S)kip all/(D)on't ask again [Yes]: a  
+
+Here are some high-level areas where we can improve and refactor without touching business logic:
+
+1. Modularize the Jupyter client  
+   • Move all WebSocket/Jupyter-API logic in server.py into its own `jupyter_client.py` module, with a clean public API (e.g. `execute(code: str) -> str`).  
+   • Improves testability, separation of concerns, and makes it easier to swap out Jupyter for other backends in the future.
+
+2. Configuration management  
+   • Replace hard-coded constants (JUPYTER_WS_URL, SHARED_DIR, timeouts) with a single `config.py` or use pydantic settings.  
+   • Allow overriding via environment variables or a `.env` file.
+
+3. Error handling & observability  
+   • Centralize exception handling in FastAPI middleware or in an MCP “error” tool decorator.  
+   • Add structured logging (e.g. JSON output) and metrics hooks (Prometheus) around execution times and error rates.
+
+4. Dependency hygiene  
+   • Pin all direct dependencies in `requirements.txt` to a specific patch version for reproducible builds.  
+   • Remove unused packages (e.g. does `httpx` really get used?).  
+   • Consider grouping dev/test deps separately.
+
+5. Dockerfile & entrypoint  
+   • Convert to a multi-stage build: use a slim runtime image (e.g. `python:3.13-slim`) for the final image.  
+   • Switch to a minimal init (e.g. `tini`) instead of full `systemd`.  
+   • In entrypoint.sh add `set -euo pipefail` and proper `trap` handlers, and simplify the “wait for Jupyter” loop.
+
+6. README & DX  
+   • Add a table of contents, development section (how to run locally/tests, code style rules).  
+   • Include CI status, test coverage badges.  
+   • Explicit example commands for running the server and tests.
+
+7. Testing  
+   • Add unit/integration tests for the Jupyter client module (mock websockets) and for the MCP tools.  
+
+Let me know which of these you’d like to tackle first (or if you’d like different suggestions), and I’ll draft the exact SEARCH/REPLACE edits.
+
+> Tokens: 6.3k sent, 470 received. Cost: $0.0090 message, $0.01 session.  

.aider.input.history

@@ -0,0 +1,9 @@
+
+# 2025-07-09 14:48:57.536441
++Y
+
+# 2025-07-09 14:49:14.828442
++analyze the project and suggest feature improvements and refactor suggestions
+
+# 2025-07-09 14:49:28.189666
++A