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:76

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

`Private`_selectingRuntime

_selectingRuntime: boolean = false

Guard flag to prevent re-entry during runtime selection

`Readonly`onRuntimeCreated

onRuntimeCreated: Event<RuntimeDTO> = ...

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

Methods

`Private`createMainController

createMainController(): void
Creates the main "Datalayer Platform" controller. This controller acts as an entry point for runtime selection. When selected, it immediately shows the runtime picker.

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

`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:137

dispose

dispose(): void
Disposes of all resources.

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

`Private`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:162

`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:377

`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:325

`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:454

`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:512

onDidCloseNotebook

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

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:594

`Private`selectRuntime

selectRuntime(): Promise<RuntimeDTO>
Shows runtime selector dialog and returns the selected runtime. Prompts for login if not authenticated.

Returns Promise<RuntimeDTO>
The selected runtime DTO, or undefined if user cancels or not authenticated
- Defined in src/providers/smartDynamicControllerManager.ts:242

selectRuntimeForNotebook

selectRuntimeForNotebook(notebook: NotebookDocument): Promise<void>
Selects or switches a runtime for a specific notebook. This can be called anytime, even if Platform controller is already selected.
Parameters
- notebook: NotebookDocument
  The notebook to select runtime for
Returns Promise<void>
- Defined in src/providers/smartDynamicControllerManager.ts:521

`Private`showRuntimeSelector

showRuntimeSelector(notebook: NotebookDocument): Promise<void>
Shows runtime selector and switches to selected runtime. This is the main method for switching runtimes.
Parameters
- notebook: NotebookDocument
Returns Promise<void>
- Defined in src/providers/smartDynamicControllerManager.ts:258

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

Private_selectingRuntime

ReadonlyonRuntimeCreated

Methods

PrivatecreateMainController

Returns void

PrivatecreatePyodideController

Returns void

dispose

Returns void

PrivateensureRuntimeController

Parameters

Returns Promise<NotebookController>

PrivateexecuteCell

Parameters

Returns Promise<void>

PrivateexecuteCells

Parameters

Returns Promise<void>

PrivateexecutePyodideCells

Parameters

Returns Promise<void>

PrivategetRuntimeControllerId

Parameters

Returns string

onDidCloseNotebook

Parameters

Returns void

refreshControllers

Returns Promise<void>

PrivateselectRuntime

Returns Promise<RuntimeDTO>

selectRuntimeForNotebook

Parameters

Returns Promise<void>

PrivateshowRuntimeSelector

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

`Private`_selectingRuntime

`Readonly`onRuntimeCreated

`Private`createMainController

`Private`createPyodideController

`Private`ensureRuntimeController

`Private`executeCell

`Private`executeCells

`Private`executePyodideCells

`Private`getRuntimeControllerId

`Private`selectRuntime

`Private`showRuntimeSelector