A JupyterLab extension that bridges the cell UI to a local OpenCode Serve process. The extension is a dual package: a Python server extension exposed under /opencode-bridge/*, plus a TypeScript frontend that registers per-cell toolbars. Backend (Python, tornado) - Slice 1: config + auth + OpenCode HTTP client (tornado.httpclient, no aiohttp). 4 settings in schema/plugin.json (url, user, password, request timeout). - Slice 2: handlers for /hello, /health, /providers, /edit. - Slice 2.1 (correction): SessionManager with 1 notebook = 1 session mapping, async-safe via per-path locks, 404 recovery via invalidate(). Two new endpoints: GET /sessions, DELETE /session?notebook=<path>. - 32 pytest tests pass. Frontend (TypeScript, JupyterLab 4.6) - src/types.ts: CellContext, OpenCodeRequest/Response, OpenCodeSettings. - src/context/cell_context.ts: extract CellContext from a CodeCell + its parent NotebookPanel, structured error collection. - src/api/opencode_client.ts: callOpenCodeEdit, callOpenCodeProviders. - src/components/opencode_cell_footer.ts: OpenCodeCellFooter Widget implementing ICellFooter with 3 buttons (optimize / fix / edit), resolved via this.parent instanceof CodeCell. NOT cellToolbar (does not exist in JL 4.6) and NOT Widget.findParent (removed in @lumino/widgets 2.x). - src/components/opencode_cell_factory.ts: Cell.ContentFactory subclass returning the OpenCodeCellFooter. - src/components/opencode_installer.ts: installOpenCodeEverywhere patches every notebook (existing + new) to use the custom factory. - src/index.ts: registers the factory, loads settings, fetches /providers on activation and logs the list to the console. - 23 jest tests pass (mocked JupyterLab boundary, pnpm path safe). Settings - 6 fields: 3 auth (url/user/password) + 1 timeout + 2 model selection (provider/model). Provider list is fetched at startup from /opencode-bridge/providers and printed to the browser console so users can copy values into Settings Editor. Docs - design.md: 6 sections covering architecture, UI flow, API contract, TS skeletons, session management (v0.2.1 correction), and provider/model selection (v0.2.2 addition). - CLAUDE.md: agent guidance for working in this repo. - TODO.md: remaining work for Slices 4-7 + v0.4+ backlog. CI - Gitea release workflow at .github/workflows/build.yml. - Bark notification helper (non-fatal on failure). Generated artefacts ignored: opencode_bridge/labextension/, _version.py, *.tsbuildinfo, junit.xml, test.ipynb scratch notebook.
37 lines
1.1 KiB
Python
37 lines
1.1 KiB
Python
try:
|
|
from ._version import __version__
|
|
except ImportError:
|
|
# Fallback when using the package in dev mode without installing
|
|
# in editable mode with pip. It is highly recommended to install
|
|
# the package from a stable release or in editable mode: https://pip.pypa.io/en/stable/topics/local-project-installs/#editable-installs
|
|
import warnings
|
|
warnings.warn("Importing 'opencode_bridge' outside a proper installation.")
|
|
__version__ = "dev"
|
|
from .routes import setup_route_handlers
|
|
|
|
|
|
def _jupyter_labextension_paths():
|
|
return [{
|
|
"src": "labextension",
|
|
"dest": "opencode_bridge"
|
|
}]
|
|
|
|
|
|
def _jupyter_server_extension_points():
|
|
return [{
|
|
"module": "opencode_bridge"
|
|
}]
|
|
|
|
|
|
def _load_jupyter_server_extension(server_app):
|
|
"""Registers the API handler to receive HTTP requests from the frontend extension.
|
|
|
|
Parameters
|
|
----------
|
|
server_app: jupyterlab.labapp.LabApp
|
|
JupyterLab application instance
|
|
"""
|
|
setup_route_handlers(server_app.web_app)
|
|
name = "opencode_bridge"
|
|
server_app.log.info(f"Registered {name} server extension")
|