Interface IKernelBridge

Kernel bridge interface for managing kernel connections. Implementations should route connections to appropriate handlers.

interface IKernelBridge {
    broadcastKernelSelected(runtime: RuntimeDTO): Promise<void>;
    broadcastKernelTerminated(): Promise<void>;
    connectWebviewDocument(uri: Uri, runtime: RuntimeDTO): Promise<void>;
    connectWebviewDocumentToLocalKernel(
        uri: Uri,
        kernelInfo: NativeKernelInfo,
    ): Promise<void>;
    connectWebviewWithPyodide(uri: Uri): Promise<void>;
    detectNotebookType(uri: Uri): "webview" | "native";
    getLocalKernel(kernelId: string): LocalKernelClient;
    registerWebview(uri: Uri, webview: WebviewPanel): void;
    unregisterWebview(uri: Uri): void;
}

Index

Methods

broadcastKernelSelected broadcastKernelTerminated connectWebviewDocument connectWebviewDocumentToLocalKernel connectWebviewWithPyodide detectNotebookType getLocalKernel registerWebview unregisterWebview

Methods

broadcastKernelSelected

broadcastKernelSelected(runtime: RuntimeDTO): Promise<void>
Broadcasts kernel selection to all registered webviews. Used when a runtime is selected that should apply to multiple documents.
Parameters
- runtime: RuntimeDTO
  Selected runtime to broadcast
Returns Promise<void>
- Defined in src/services/interfaces/IKernelBridge.ts:91

broadcastKernelTerminated

broadcastKernelTerminated(): Promise<void>
Broadcasts kernel termination to all registered webviews. Used when a runtime is terminated that affects multiple documents.

Returns Promise<void>
- Defined in src/services/interfaces/IKernelBridge.ts:97

connectWebviewDocument

connectWebviewDocument(uri: Uri, runtime: RuntimeDTO): Promise<void>
Connects a webview document (notebook or lexical) to a runtime. Sends runtime information to the webview for ServiceManager creation.
Parameters
- uri: Uri
  Document URI
- runtime: RuntimeDTO
  Selected runtime
Returns Promise<void>
- Defined in src/services/interfaces/IKernelBridge.ts:55

connectWebviewDocumentToLocalKernel

connectWebviewDocumentToLocalKernel(
uri: Uri,
kernelInfo: NativeKernelInfo,
): Promise<void>
Connects a webview document to a local kernel (Python environment, Jupyter kernel, or Jupyter server). Starts the kernel and sends kernel information to the webview.
Parameters
- uri: Uri
  Document URI
- kernelInfo: NativeKernelInfo
  Native kernel information
Returns Promise<void>
- Defined in src/services/interfaces/IKernelBridge.ts:64

connectWebviewWithPyodide

connectWebviewWithPyodide(uri: Uri): Promise<void>
Connects a webview document (notebook or lexical) to Pyodide kernel. Sends Pyodide kernel type to the webview for in-browser execution.
Parameters
- uri: Uri
  Document URI
Returns Promise<void>
- Defined in src/services/interfaces/IKernelBridge.ts:75

detectNotebookType

detectNotebookType(uri: Uri): "webview" | "native"
Detects the type of notebook (native vs webview).
Parameters
- uri: Uri
  Notebook URI
Returns "webview" | "native"
"webview" for Datalayer notebooks, "native" for others
- Defined in src/services/interfaces/IKernelBridge.ts:83

getLocalKernel

getLocalKernel(kernelId: string): LocalKernelClient
Gets a local kernel client by ID. Used by network proxy to route messages to local ZMQ kernels.
Parameters
- kernelId: string
  Kernel identifier
Returns LocalKernelClient
Local kernel client or undefined
- Defined in src/services/interfaces/IKernelBridge.ts:31

registerWebview

registerWebview(uri: Uri, webview: WebviewPanel): void
Registers a webview panel for kernel communication.
Parameters
- uri: Uri
  Notebook URI
- webview: WebviewPanel
  Webview panel
Returns void
- Defined in src/services/interfaces/IKernelBridge.ts:39

unregisterWebview

unregisterWebview(uri: Uri): void
Unregisters a webview panel.
Parameters
- uri: Uri
  Notebook URI
Returns void
- Defined in src/services/interfaces/IKernelBridge.ts:46