Class RuntimeService

Runtime service implementation using dependency injection. No global state, no singletons - all dependencies injected.

Hierarchy (View Summary)

BaseService
- RuntimeService

Implements

IRuntimeService

Constructors

constructor

new RuntimeService(sdk: AgentRuntimesClient, logger: ILogger): RuntimeService
Parameters
- sdk: AgentRuntimesClient
- logger: ILogger
Returns RuntimeService
Overrides BaseService.constructor
- Defined in renderer/services/runtime/RuntimeService.ts:64

Properties

`Private`allRuntimes

allRuntimes: RuntimeJSON[] = []

`Private`expirationTimers

expirationTimers: Map<string, Timeout> = ...

`Private`globalExpirationCallbacks

globalExpirationCallbacks: Set<(podName: string) => void> = ...

`Private`globalExpirationTimers

globalExpirationTimers: Map<string, Timeout> = ...

`Private`lastRuntimesFetch

lastRuntimesFetch: number | null = null

`Protected` `Readonly`logger

logger: ILogger

Logger instance for this service

`Protected` `Readonly`name

name: string

Service name for logging

`Private`notebookRuntimes

notebookRuntimes: Map<string, NotebookRuntime> = ...

`Private` `Readonly`RUNTIME_CACHE_TTL

RUNTIME_CACHE_TTL: 30000

`Private`runtimeCreationPromises

runtimeCreationPromises: Map<string, Promise<RuntimeJSON>> = ...

`Private`runtimeListRefreshCallbacks

runtimeListRefreshCallbacks: Set<(runtimes: RuntimeJSON[]) => void> = ...

`Private` `Readonly`sdk

sdk: AgentRuntimesClient

`Private`stateChangeCallbacks

stateChangeCallbacks: Set<RuntimeStateCallback> = ...

Accessors

state

get state(): ServiceState
Gets the current service state.

Returns ServiceState
Implementation of IRuntimeService.state

Inherited from BaseService.state
- Defined in renderer/services/core/BaseService.ts:59

Methods

`Protected`assertReady

assertReady(): void
Asserts that the service is ready for use. Throws an error if the service is not in the Ready state.

Returns void

Throws
Error if service is not ready
Inherited from BaseService.assertReady
- Defined in renderer/services/core/BaseService.ts:119

`Private`clearAllExpirationTimers

clearAllExpirationTimers(): void
Clear all expiration timers.

Returns void
- Defined in renderer/services/runtime/RuntimeService.ts:381

createRuntime

createRuntime(
    notebookId: string,
    notebookPath?: string,
    options?: RuntimeOptions,
): Promise<RuntimeJSON>
Create a runtime for a specific notebook.
Parameters
- notebookId: string
- OptionalnotebookPath: string
- Optionaloptions: RuntimeOptions
Returns Promise<RuntimeJSON>
Implementation of IRuntimeService.createRuntime
- Defined in renderer/services/runtime/RuntimeService.ts:97

`Private`createRuntimeInternal

createRuntimeInternal(
    notebookId: string,
    notebookPath?: string,
    options?: RuntimeOptions,
): Promise<RuntimeJSON>
Internal runtime creation method.
Parameters
- notebookId: string
- OptionalnotebookPath: string
- Optionaloptions: RuntimeOptions
Returns Promise<RuntimeJSON>
- Defined in renderer/services/runtime/RuntimeService.ts:137

dispose

dispose(): Promise<void>
Disposes the service and cleans up resources. Ensures disposal only happens once.

Returns Promise<void>
Implementation of IRuntimeService.dispose

Inherited from BaseService.dispose
- Defined in renderer/services/core/BaseService.ts:94

`Private`emitStateChange

emitStateChange(change: RuntimeStateChange): void
Emit state change to all listeners.
Parameters
- change: RuntimeStateChange
Returns void
- Defined in renderer/services/runtime/RuntimeService.ts:391

getRuntimeForNotebook

getRuntimeForNotebook(notebookId: string): RuntimeJSON | null
Get runtime for a notebook.
Parameters
- notebookId: string
Returns RuntimeJSON | null
Implementation of IRuntimeService.getRuntimeForNotebook
- Defined in renderer/services/runtime/RuntimeService.ts:288

getServiceManager

getServiceManager(notebookId: string): IManager | null
Get service manager for a notebook.
Parameters
- notebookId: string
Returns IManager | null
Implementation of IRuntimeService.getServiceManager
- Defined in renderer/services/runtime/RuntimeService.ts:295

`Private`handleGlobalRuntimeExpired

handleGlobalRuntimeExpired(podName: string): void
Parameters
- podName: string
Returns void
- Defined in renderer/services/runtime/RuntimeService.ts:556

`Private`handleRuntimeExpired

handleRuntimeExpired(runtimeUid: string): void
Handle runtime expiration.
Parameters
- runtimeUid: string
Returns void
- Defined in renderer/services/runtime/RuntimeService.ts:351

initialize

initialize(): Promise<void>
Initializes the service. Ensures initialization only happens once and tracks state.

Returns Promise<void>
Implementation of IRuntimeService.initialize

Inherited from BaseService.initialize
- Defined in renderer/services/core/BaseService.ts:67

listAllRuntimes

listAllRuntimes(): Promise<RuntimeJSON[]>
List all runtimes on the platform. Uses cached data if available and fresh (< 30 seconds old).

Returns Promise<RuntimeJSON[]>
Implementation of IRuntimeService.listAllRuntimes
- Defined in renderer/services/runtime/RuntimeService.ts:408

`Private`notifyRuntimeListRefreshed

notifyRuntimeListRefreshed(runtimes: RuntimeJSON[]): void
Notify all subscribers that the runtime list has been refreshed.
Parameters
- runtimes: RuntimeJSON[]
Returns void
- Defined in renderer/services/runtime/RuntimeService.ts:543

notifyRuntimeTerminated

notifyRuntimeTerminated(podName: string): void
Manually trigger runtime expiration (e.g., when user terminates a runtime) This will notify all subscribers that the runtime is no longer available
Parameters
- podName: string
Returns void
Implementation of IRuntimeService.notifyRuntimeTerminated
- Defined in renderer/services/runtime/RuntimeService.ts:525

`Protected`onDispose

onDispose(): Promise<void>
Implementation-specific disposal logic. Called once during dispose().

Returns Promise<void>
Overrides BaseService.onDispose
- Defined in renderer/services/runtime/RuntimeService.ts:76

`Protected`onInitialize

onInitialize(): Promise<void>
Implementation-specific initialization logic. Called once during initialize().

Returns Promise<void>
Overrides BaseService.onInitialize
- Defined in renderer/services/runtime/RuntimeService.ts:72

onRuntimeExpired

onRuntimeExpired(callback: (podName: string) => void): () => void
Subscribe to global runtime expiration events. Called when ANY runtime on the platform expires.
Parameters
- callback: (podName: string) => void
  Function to call with the expired runtime's podName
Returns () => void
Unsubscribe function
Implementation of IRuntimeService.onRuntimeExpired
- Defined in renderer/services/runtime/RuntimeService.ts:472

onRuntimeListRefreshed

onRuntimeListRefreshed(callback: (runtimes: RuntimeJSON[]) => void): () => void
Subscribe to runtime list refresh events. Called when the list of all runtimes has been updated.
Parameters
- callback: (runtimes: RuntimeJSON[]) => void
Returns () => void
Implementation of IRuntimeService.onRuntimeListRefreshed
- Defined in renderer/services/runtime/RuntimeService.ts:533

onRuntimeStateChanged

onRuntimeStateChanged(callback: RuntimeStateCallback): () => void
Subscribe to runtime state changes.
Parameters
- callback: RuntimeStateCallback
Returns () => void
Implementation of IRuntimeService.onRuntimeStateChanged
- Defined in renderer/services/runtime/RuntimeService.ts:319

refreshAllRuntimes

refreshAllRuntimes(): Promise<RuntimeJSON[]>
Refresh the list of all platform runtimes. Forces a fresh fetch even if cached data exists.

Returns Promise<RuntimeJSON[]>
Implementation of IRuntimeService.refreshAllRuntimes
- Defined in renderer/services/runtime/RuntimeService.ts:433

setServiceManager

setServiceManager(notebookId: string, manager: IManager): void
Set service manager for a notebook.
Parameters
- notebookId: string
- manager: IManager
Returns void
Implementation of IRuntimeService.setServiceManager
- Defined in renderer/services/runtime/RuntimeService.ts:302

`Private`startExpirationTimer

startExpirationTimer(runtime: RuntimeJSON): void
Start expiration timer for runtime.
Parameters
- runtime: RuntimeJSON
Returns void
- Defined in renderer/services/runtime/RuntimeService.ts:329

terminateRuntime

terminateRuntime(notebookId: string): Promise<void>
Terminate a runtime for a specific notebook.
Parameters
- notebookId: string
Returns Promise<void>
Implementation of IRuntimeService.terminateRuntime
- Defined in renderer/services/runtime/RuntimeService.ts:227

`Private`updateGlobalExpirationTimers

updateGlobalExpirationTimers(runtimes: RuntimeJSON[]): void
Update global expiration timers for all platform runtimes. This monitors ALL runtimes and notifies when they expire.
Parameters
- runtimes: RuntimeJSON[]
Returns void
- Defined in renderer/services/runtime/RuntimeService.ts:483

Class RuntimeService

Hierarchy (View Summary)

Implements

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns RuntimeService

Properties

PrivateallRuntimes

PrivateexpirationTimers

PrivateglobalExpirationCallbacks

PrivateglobalExpirationTimers

PrivatelastRuntimesFetch

Protected Readonlylogger

Protected Readonlyname

PrivatenotebookRuntimes

Private ReadonlyRUNTIME_CACHE_TTL

PrivateruntimeCreationPromises

PrivateruntimeListRefreshCallbacks

Private Readonlysdk

PrivatestateChangeCallbacks

Accessors

state

Returns ServiceState

Methods

ProtectedassertReady

Returns void

Throws

PrivateclearAllExpirationTimers

Returns void

createRuntime

Parameters

Returns Promise<RuntimeJSON>

PrivatecreateRuntimeInternal

Parameters

Returns Promise<RuntimeJSON>

dispose

Returns Promise<void>

PrivateemitStateChange

Parameters

Returns void

getRuntimeForNotebook

Parameters

Returns RuntimeJSON | null

getServiceManager

Parameters

Returns IManager | null

PrivatehandleGlobalRuntimeExpired

Parameters

Returns void

PrivatehandleRuntimeExpired

Parameters

Returns void

initialize

Returns Promise<void>

listAllRuntimes

Returns Promise<RuntimeJSON[]>

PrivatenotifyRuntimeListRefreshed

Parameters

Returns void

notifyRuntimeTerminated

Parameters

Returns void

ProtectedonDispose

Returns Promise<void>

ProtectedonInitialize

Returns Promise<void>

onRuntimeExpired

Parameters

Returns () => void

onRuntimeListRefreshed

Parameters

Returns () => void

onRuntimeStateChanged

Parameters

`Private`allRuntimes

`Private`expirationTimers

`Private`globalExpirationCallbacks

`Private`globalExpirationTimers

`Private`lastRuntimesFetch

`Protected` `Readonly`logger

`Protected` `Readonly`name

`Private`notebookRuntimes

`Private` `Readonly`RUNTIME_CACHE_TTL

`Private`runtimeCreationPromises

`Private`runtimeListRefreshCallbacks

`Private` `Readonly`sdk

`Private`stateChangeCallbacks

`Protected`assertReady

`Private`clearAllExpirationTimers

`Private`createRuntimeInternal

`Private`emitStateChange

`Private`handleGlobalRuntimeExpired

`Private`handleRuntimeExpired

`Private`notifyRuntimeListRefreshed

`Protected`onDispose

`Protected`onInitialize

`Private`startExpirationTimer

`Private`updateGlobalExpirationTimers