Class SmartDynamicControllerManager

Manages notebook controllers with a main selector and runtime-specific controllers.

Implements

Disposable

Constructors

constructor

new SmartDynamicControllerManager(
    context: ExtensionContext,
    sdk: DatalayerClient,
    authProvider: SDKAuthProvider,
): SmartDynamicControllerManager
Creates a new SmartDynamicControllerManager instance.
Parameters
- context: ExtensionContext
  VS Code extension context for managing subscriptions
- sdk: DatalayerClient
  Datalayer SDK client for API communication
- authProvider: SDKAuthProvider
  Authentication provider for managing user login state
Returns SmartDynamicControllerManager
- Defined in src/providers/smartDynamicControllerManager.ts:73

Properties

`Private` `Readonly`_activeKernels

_activeKernels: Map<string, WebSocketKernelClient> = ...

Map of notebook URIs to active WebSocket kernel clients

`Private` `Readonly`_authProvider

_authProvider: SDKAuthProvider

Authentication provider for managing auth state

`Private` `Readonly`_context

_context: ExtensionContext

VS Code extension context for accessing API and managing subscriptions

`Private` `Readonly`_controllers

_controllers: Map<string, NotebookController> = ...

Map of notebook controller IDs to VS Code NotebookController instances

`Private`_disposed

_disposed: boolean = false

Flag to track if this manager has been disposed

`Private`_executionOrder

_executionOrder: number = 0

Counter for execution order tracking across cells

`Private` `Readonly`_kernelBridge

_kernelBridge: KernelBridge

Bridge for managing kernel connections and webview communication

`Private` `Readonly`_notebookRuntimes

_notebookRuntimes: Map<string, RuntimeDTO> = ...

Map of notebook URIs to their selected runtimes

`Private` `Readonly`_onRuntimeCreated

_onRuntimeCreated: EventEmitter<RuntimeDTO> = ...

Event emitter fired when a runtime is created or selected

`Private` `Readonly`_pyodideKernels

_pyodideKernels: Map<string, PyodideKernelClient> = ...

Map of notebook URIs to active Pyodide kernel clients

`Private` `Readonly`_runtimes

_runtimes: Map<string, RuntimeDTO> = ...

Map of controller IDs to runtime DTOs for reverse lookup

`Private` `Readonly`_sdk

_sdk: DatalayerClient

Datalayer SDK client for API communication

`Readonly`onRuntimeCreated

onRuntimeCreated: Event<RuntimeDTO> = ...

Event that fires when a runtime is created or selected, allows tree view refresh

Methods

`Private`createPyodideController

createPyodideController(): void
Creates the Pyodide controller for offline Python execution. This controller works with native .ipynb files without requiring server connectivity.

Returns void
- Defined in src/providers/smartDynamicControllerManager.ts:96

dispose

dispose(): void
Disposes of all resources.

Returns void
Implementation of vscode.Disposable.dispose
- Defined in src/providers/smartDynamicControllerManager.ts:573

ensureRuntimeController

ensureRuntimeController(runtime: RuntimeDTO): Promise<NotebookController>
Creates or gets a runtime-specific controller.
Parameters
- runtime: RuntimeDTO
Returns Promise<NotebookController>
- Defined in src/providers/smartDynamicControllerManager.ts:134

`Private`executeCell

executeCell(
    cell: NotebookCell,
    kernelClient: WebSocketKernelClient,
    controller: NotebookController,
): Promise<void>
Executes a single cell via WebSocket.
Parameters
- cell: NotebookCell
- kernelClient: WebSocketKernelClient
- controller: NotebookController
Returns Promise<void>
- Defined in src/providers/smartDynamicControllerManager.ts:268

`Private`executeCells

executeCells(
    cells: NotebookCell[],
    notebook: NotebookDocument,
    runtime: RuntimeDTO,
    executingController?: NotebookController,
): Promise<void>
Executes cells with the specified runtime.
Parameters
- cells: NotebookCell[]
  Cells to execute
- notebook: NotebookDocument
  The notebook document
- runtime: RuntimeDTO
  The runtime to use
- OptionalexecutingController: NotebookController
  The controller that is actually executing (might be Platform or Runtime controller)
Returns Promise<void>
- Defined in src/providers/smartDynamicControllerManager.ts:216

`Private`executePyodideCells

executePyodideCells(
    cells: NotebookCell[],
    notebook: NotebookDocument,
    controller: NotebookController,
): Promise<void>
Executes cells using Pyodide kernel (browser-based Python). Creates kernel on-demand and reuses it for the notebook lifetime.
Parameters
- cells: NotebookCell[]
  Cells to execute
- notebook: NotebookDocument
  Notebook document
- controller: NotebookController
  Pyodide controller
Returns Promise<void>
- Defined in src/providers/smartDynamicControllerManager.ts:345

getController

getController(controllerId: string): NotebookController
Get a controller by ID. Used by DatalayerRuntimeSelector to access controllers for QuickPick display.
Parameters
- controllerId: string
  Controller ID to retrieve
Returns NotebookController
The controller or undefined if not found
- Defined in src/providers/smartDynamicControllerManager.ts:125

`Private`getRuntimeControllerId

getRuntimeControllerId(runtime: RuntimeDTO): string
Gets the unique controller ID for a specific runtime.
Parameters
- runtime: RuntimeDTO
  The runtime DTO to get the controller ID for
Returns string
The unique controller identifier string
- Defined in src/providers/smartDynamicControllerManager.ts:403

onDidCloseNotebook

onDidCloseNotebook(notebook: NotebookDocument): void
Cleans up on notebook close.
Parameters
- notebook: NotebookDocument
Returns void
- Defined in src/providers/smartDynamicControllerManager.ts:460

refreshControllers

refreshControllers(): Promise<void>
Refreshes all controllers based on current authentication and available runtimes. Creates controllers for existing runtimes that don't have controllers yet. Removes controllers for runtimes that no longer exist.

Returns Promise<void>
- Defined in src/providers/smartDynamicControllerManager.ts:484

selectRuntimeForNotebook

selectRuntimeForNotebook(notebook: NotebookDocument): Promise<void>
Selects or switches a runtime for a specific notebook. This can be called anytime to select or switch runtimes.
Parameters
- notebook: NotebookDocument
  The notebook to select runtime for
Returns Promise<void>
- Defined in src/providers/smartDynamicControllerManager.ts:412

Class SmartDynamicControllerManager

Implements

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns SmartDynamicControllerManager

Properties

Private Readonly_activeKernels

Private Readonly_authProvider

Private Readonly_context

Private Readonly_controllers

Private_disposed

Private_executionOrder

Private Readonly_kernelBridge

Private Readonly_notebookRuntimes

Private Readonly_onRuntimeCreated

Private Readonly_pyodideKernels

Private Readonly_runtimes

Private Readonly_sdk

ReadonlyonRuntimeCreated

Methods

PrivatecreatePyodideController

Returns void

dispose

Returns void

ensureRuntimeController

Parameters

Returns Promise<NotebookController>

PrivateexecuteCell

Parameters

Returns Promise<void>

PrivateexecuteCells

Parameters

Returns Promise<void>

PrivateexecutePyodideCells

Parameters

Returns Promise<void>

getController

Parameters

Returns NotebookController

PrivategetRuntimeControllerId

Parameters

Returns string

onDidCloseNotebook

Parameters

Returns void

refreshControllers

Returns Promise<void>

selectRuntimeForNotebook

Parameters

Returns Promise<void>

Settings

On This Page

`Private` `Readonly`_activeKernels

`Private` `Readonly`_authProvider

`Private` `Readonly`_context

`Private` `Readonly`_controllers

`Private`_disposed

`Private`_executionOrder

`Private` `Readonly`_kernelBridge

`Private` `Readonly`_notebookRuntimes

`Private` `Readonly`_onRuntimeCreated

`Private` `Readonly`_pyodideKernels

`Private` `Readonly`_runtimes

`Private` `Readonly`_sdk

`Readonly`onRuntimeCreated

`Private`createPyodideController

`Private`executeCell

`Private`executeCells

`Private`executePyodideCells

`Private`getRuntimeControllerId