jupyterpack 0.2.1 → 0.4.0

package/README.md

@@ -10,6 +10,8 @@
 - **Python Web Apps**: Serve Python web applications directly in the browser using JupyterLite's in-browser Python kernel. `jupyterpack` currently supports Dash.
 - **JavaScript Web Apps**: Bundle and serve JavaScript web applications using in-browser bundlers.
 
+![Image](https://github.com/user-attachments/assets/22849fe8-199f-4d9f-ad45-055bccf88bad)
+
 ## Installation
 
 You can install `jupyterpack` using `pip` or `conda`

package/lib/document/commands.d.ts

@@ -0,0 +1,8 @@
+import { CommandRegistry } from '@lumino/commands';
+import { IJupyterpackDocTracker } from '../type';
+export declare const CommandIDs: {
+    RELOAD: string;
+    TOGGLE_AUTORELOAD: string;
+    OPEN_SPECTA: string;
+};
+export declare function addCommands(commands: CommandRegistry, tracker: IJupyterpackDocTracker): void;

package/lib/document/commands.js

@@ -0,0 +1,76 @@
+import { refreshIcon } from '@jupyterlab/ui-components';
+import { autoReloadIcon, linkIcon } from '../tools';
+import { PageConfig, URLExt } from '@jupyterlab/coreutils';
+export const CommandIDs = {
+    RELOAD: 'jupyterpack:reload',
+    TOGGLE_AUTORELOAD: 'jupyterpack:toggleAutoreload',
+    OPEN_SPECTA: 'jupyterpack:openInSpecta'
+};
+const labBaseUrl = PageConfig.getOption('baseUrl');
+function getCurrentIframPanel(tracker) {
+    var _a;
+    const current = (_a = tracker.currentWidget) === null || _a === void 0 ? void 0 : _a.content;
+    if (!current) {
+        return;
+    }
+    const widget = current.widgets[0];
+    if (!widget) {
+        return;
+    }
+    return widget;
+}
+export function addCommands(commands, tracker) {
+    commands.addCommand(CommandIDs.RELOAD, {
+        caption: 'Reload',
+        isEnabled: () => {
+            return tracker.currentWidget !== null;
+        },
+        icon: refreshIcon,
+        execute: async () => {
+            const widget = getCurrentIframPanel(tracker);
+            if (widget) {
+                await widget.reload();
+            }
+        }
+    });
+    const commandState = { toggled: false };
+    commands.addCommand(CommandIDs.TOGGLE_AUTORELOAD, {
+        isEnabled: () => {
+            return tracker.currentWidget !== null;
+        },
+        isToggled: () => {
+            const widget = getCurrentIframPanel(tracker);
+            return Boolean(widget === null || widget === void 0 ? void 0 : widget.autoreload);
+        },
+        icon: autoReloadIcon,
+        caption: e => {
+            return commandState.toggled
+                ? 'Auto-reload enabled'
+                : 'Auto-reload disabled';
+        },
+        execute: async () => {
+            const widget = getCurrentIframPanel(tracker);
+            if (widget) {
+                widget.autoreload = !(widget === null || widget === void 0 ? void 0 : widget.autoreload);
+                commands.notifyCommandChanged(CommandIDs.TOGGLE_AUTORELOAD);
+            }
+        }
+    });
+    commands.addCommand(CommandIDs.OPEN_SPECTA, {
+        caption: 'Open in Specta',
+        isEnabled: () => {
+            return tracker.currentWidget !== null;
+        },
+        icon: linkIcon,
+        execute: async () => {
+            var _a;
+            const context = (_a = tracker.currentWidget) === null || _a === void 0 ? void 0 : _a.context;
+            if (!context) {
+                return;
+            }
+            const spectaUrl = new URL(URLExt.join(labBaseUrl, 'specta'), window.location.origin);
+            spectaUrl.searchParams.set('path', context.path);
+            window.open(spectaUrl.toString(), '_blank');
+        }
+    });
+}

package/lib/document/iframePanel.d.ts

@@ -1,7 +1,10 @@
 import { Widget } from '@lumino/widgets';
-export declare class IFramePanel extends Widget {
+export declare abstract class IFramePanel extends Widget {
     constructor();
     toggleSpinner(show: boolean): void;
+    abstract reload(): Promise<void>;
+    abstract autoreload: boolean;
+    abstract isReady: Promise<void>;
     protected _iframe: HTMLIFrameElement;
     protected _spinner: HTMLDivElement;
 }

package/lib/document/plugin.d.ts

@@ -1,2 +1,3 @@
 import { JupyterFrontEndPlugin } from '@jupyterlab/application';
-export declare const spkPlugin: JupyterFrontEndPlugin<void>;
+import { IJupyterpackDocTracker } from '../type';
+export declare const spkPlugin: JupyterFrontEndPlugin<IJupyterpackDocTracker>;

package/lib/document/plugin.js

@@ -1,12 +1,20 @@
 import { JupyterPackWidgetFactory } from './widgetFactory';
-import { IConnectionManagerToken } from '../token';
+import { IConnectionManagerToken, IJupyterpackDocTrackerToken } from '../token';
+import { WidgetTracker } from '@jupyterlab/apputils';
+import { logoIcon } from '../tools';
+import { addCommands } from './commands';
 const FACTORY = 'jupyterpack';
 const CONTENT_TYPE = 'jupyterpack';
 export const spkPlugin = {
     id: 'jupyterpack:spkplugin',
     requires: [IConnectionManagerToken],
     autoStart: true,
+    provides: IJupyterpackDocTrackerToken,
     activate: (app, connectionManager) => {
+        const tracker = new WidgetTracker({
+            namespace: FACTORY
+        });
+        addCommands(app.commands, tracker);
         const widgetFactory = new JupyterPackWidgetFactory({
             name: FACTORY,
             modelName: 'text',
@@ -14,7 +22,8 @@ export const spkPlugin = {
             defaultFor: [CONTENT_TYPE],
             commands: app.commands,
             manager: app.serviceManager,
-            connectionManager
+            connectionManager,
+            tracker
         });
         // Registering the widget factory
         app.docRegistry.addWidgetFactory(widgetFactory);
@@ -22,10 +31,19 @@ export const spkPlugin = {
         app.docRegistry.addFileType({
             name: CONTENT_TYPE,
             displayName: 'SPK',
-            mimeTypes: ['text/json'],
+            mimeTypes: ['application/json'],
             extensions: ['.spk', '.SPK'],
             fileFormat: 'json',
-            contentType: CONTENT_TYPE
+            contentType: CONTENT_TYPE,
+            icon: logoIcon
+        });
+        widgetFactory.widgetCreated.connect((_, widget) => {
+            widget.title.icon = logoIcon;
+            widget.context.pathChanged.connect(() => {
+                tracker.save(widget);
+            });
+            tracker.add(widget);
         });
+        return tracker;
     }
 };

package/lib/document/toolbar.d.ts

@@ -0,0 +1,9 @@
+import { ReactiveToolbar } from '@jupyterlab/ui-components';
+import { CommandRegistry } from '@lumino/commands';
+import { IJupyterpackDocTracker } from '../type';
+export declare class ToolbarWidget extends ReactiveToolbar {
+    constructor(options: {
+        tracker: IJupyterpackDocTracker;
+        commands: CommandRegistry;
+    });
+}

package/lib/document/toolbar.js

@@ -0,0 +1,20 @@
+import { CommandToolbarButton, ReactiveToolbar } from '@jupyterlab/ui-components';
+import { CommandIDs } from './commands';
+export class ToolbarWidget extends ReactiveToolbar {
+    constructor(options) {
+        super();
+        this.addClass('jupyterpack-toolbar');
+        this.addItem('Reload', new CommandToolbarButton({
+            commands: options.commands,
+            id: CommandIDs.RELOAD
+        }));
+        this.addItem('Toggle Auto Reload', new CommandToolbarButton({
+            id: CommandIDs.TOGGLE_AUTORELOAD,
+            commands: options.commands
+        }));
+        this.addItem('Open Specta', new CommandToolbarButton({
+            id: CommandIDs.OPEN_SPECTA,
+            commands: options.commands
+        }));
+    }
+}

package/lib/document/widgetFactory.d.ts

@@ -1,12 +1,13 @@
 import { ABCWidgetFactory, DocumentRegistry } from '@jupyterlab/docregistry';
 import { ServiceManager } from '@jupyterlab/services';
 import { CommandRegistry } from '@lumino/commands';
-import { IConnectionManager } from '../type';
+import { IConnectionManager, IJupyterpackDocTracker } from '../type';
 import { JupyterPackDocWidget } from './jupyterpackDocWidget';
 interface IOptions extends DocumentRegistry.IWidgetFactoryOptions {
     commands: CommandRegistry;
     manager: ServiceManager.IManager;
     connectionManager: IConnectionManager;
+    tracker: IJupyterpackDocTracker;
 }
 export declare class JupyterPackWidgetFactory extends ABCWidgetFactory<JupyterPackDocWidget> {
     private options;

package/lib/document/widgetFactory.js

@@ -1,11 +1,12 @@
 import { ABCWidgetFactory } from '@jupyterlab/docregistry';
+import { UUID } from '@lumino/coreutils';
 import { Panel } from '@lumino/widgets';
-import { JupyterPackFramework } from '../type';
+import { PythonWidget } from '../pythonWidget/pythonWidget';
+import { PythonWidgetModel } from '../pythonWidget/pythonWidgetModel';
 import { SandpackPanel } from '../sandpackWidget/sandpackPanel';
+import { JupyterPackFramework } from '../type';
 import { JupyterPackDocWidget } from './jupyterpackDocWidget';
-import { PythonWidgetModel } from '../pythonWidget/pythonWidgetModel';
-import { UUID } from '@lumino/coreutils';
-import { PythonWidget } from '../pythonWidget/pythonWidget';
+import { ToolbarWidget } from './toolbar';
 export class JupyterPackWidgetFactory extends ABCWidgetFactory {
     constructor(options) {
         super(options);
@@ -32,8 +33,11 @@ export class JupyterPackWidgetFactory extends ABCWidgetFactory {
                     content.addWidget(jpContent);
                     break;
                 }
-                case JupyterPackFramework.DASH: {
+                case JupyterPackFramework.DASH:
+                case JupyterPackFramework.STREAMLIT:
+                case JupyterPackFramework.TORNADO: {
                     const model = new PythonWidgetModel({
+                        jpackModel,
                         context,
                         manager: this.options.manager,
                         contentsManager: this._contentsManager,
@@ -52,9 +56,14 @@ export class JupyterPackWidgetFactory extends ABCWidgetFactory {
                 }
             }
         });
+        const toolbar = new ToolbarWidget({
+            tracker: this.options.tracker,
+            commands: this.options.commands
+        });
         return new JupyterPackDocWidget({
             context,
-            content
+            content,
+            toolbar
         });
     }
 }

package/lib/index.d.ts

@@ -1,2 +1,2 @@
-declare const _default: (import("@jupyterlab/application").JupyterFrontEndPlugin<void> | import("@jupyterlab/application").JupyterFrontEndPlugin<import("./type").IConnectionManager>)[];
+declare const _default: (import("@jupyterlab/application").JupyterFrontEndPlugin<import("./type").IJupyterpackDocTracker> | import("@jupyterlab/application").JupyterFrontEndPlugin<import("./type").IConnectionManager>)[];
 export default _default;

package/lib/pythonServer/dash/dashServer.d.ts

@@ -0,0 +1,22 @@
+import { IDict } from '../../type';
+import { KernelExecutor } from '../kernelExecutor';
+export declare class DashServer extends KernelExecutor {
+    init(options: {
+        initCode?: string;
+        instanceId: string;
+        kernelClientId: string;
+    }): Promise<void>;
+    getResponseFunctionFactory(options: {
+        urlPath: string;
+        method: string;
+        headers: IDict;
+        params?: string;
+        content?: string;
+    }): string;
+    disposePythonServer(): Promise<void>;
+    reloadPythonServer(options: {
+        entryPath?: string;
+        initCode?: string;
+    }): Promise<void>;
+    private _DASH_SERVER_VAR;
+}

package/lib/pythonServer/dash/dashServer.js

@@ -0,0 +1,47 @@
+import { stringOrNone } from '../../tools';
+import { JupyterPackFramework } from '../../type';
+import { KernelExecutor } from '../kernelExecutor';
+export class DashServer extends KernelExecutor {
+    constructor() {
+        super(...arguments);
+        this._DASH_SERVER_VAR = '__jupyterpack_dash_server';
+    }
+    async init(options) {
+        await super.init(options);
+        const { initCode, instanceId, kernelClientId } = options;
+        const baseURL = this.buildBaseURL({
+            instanceId,
+            kernelClientId,
+            framework: JupyterPackFramework.DASH
+        });
+        await this.executeCode({
+            code: `
+      import os
+      os.environ["DASH_URL_BASE_PATHNAME"] = "${baseURL}"
+      `
+        });
+        if (initCode) {
+            await this.executeCode({ code: initCode });
+        }
+        const loaderCode = `
+      from jupyterpack.dash import DashServer
+      ${this._DASH_SERVER_VAR} = DashServer(app, "${baseURL}")
+      `;
+        await this.executeCode({ code: loaderCode });
+    }
+    getResponseFunctionFactory(options) {
+        const { method, urlPath, headers, params, content } = options;
+        const code = `${this._DASH_SERVER_VAR}.get_response("${method}", "${urlPath}", headers=${JSON.stringify(headers)} , content=${stringOrNone(content)}, params=${stringOrNone(params)})`;
+        return code;
+    }
+    async disposePythonServer() {
+        await this.executeCode({ code: `${this._DASH_SERVER_VAR}.dispose()` });
+    }
+    async reloadPythonServer(options) {
+        const { initCode } = options;
+        if (initCode) {
+            await this.executeCode({ code: initCode });
+        }
+        await this.executeCode({ code: `${this._DASH_SERVER_VAR}.reload(app)` }, true);
+    }
+}

package/lib/pythonServer/index.d.ts

@@ -0,0 +1,5 @@
+import { IKernelExecutor, JupyterPackFramework } from '../type';
+import { KernelExecutor } from './kernelExecutor';
+type KernelExecutorConstructor = new (options: KernelExecutor.IOptions) => IKernelExecutor;
+export declare const PYTHON_SERVER: Map<JupyterPackFramework, KernelExecutorConstructor>;
+export {};

package/lib/pythonServer/index.js

@@ -0,0 +1,9 @@
+import { JupyterPackFramework } from '../type';
+import { DashServer } from './dash/dashServer';
+import { StreamlitServer } from './streamlit/streamlitServer';
+import { TornadoServer } from './tornado/tornadoServer';
+export const PYTHON_SERVER = new Map([
+    [JupyterPackFramework.DASH, DashServer],
+    [JupyterPackFramework.STREAMLIT, StreamlitServer],
+    [JupyterPackFramework.TORNADO, TornadoServer]
+]);

package/lib/pythonServer/kernelExecutor.d.ts

@@ -0,0 +1,71 @@
+import { KernelMessage, Session } from '@jupyterlab/services';
+import { IDict, IKernelExecutor, JupyterPackFramework } from '../type';
+export declare abstract class KernelExecutor implements IKernelExecutor {
+    constructor(options: KernelExecutor.IOptions);
+    get isDisposed(): boolean;
+    abstract disposePythonServer(): Promise<void>;
+    abstract reloadPythonServer(options: {
+        entryPath?: string;
+        initCode?: string;
+    }): Promise<void>;
+    abstract getResponseFunctionFactory(options: {
+        urlPath: string;
+        method: string;
+        headers: IDict;
+        params?: string;
+        content?: string;
+    }): string;
+    init(options: {
+        entryPath?: string;
+        initCode?: string;
+        instanceId: string;
+        kernelClientId: string;
+    }): Promise<void>;
+    openWebsocketFunctionFactory(options: {
+        instanceId: string;
+        kernelId: string;
+        wsUrl: string;
+        protocol?: string;
+    }): string | undefined;
+    sendWebsocketMessageFunctionFactory(options: {
+        instanceId: string;
+        kernelId: string;
+        wsUrl: string;
+        message: string;
+    }): string | undefined;
+    openWebsocket(options: {
+        instanceId: string;
+        kernelId: string;
+        wsUrl: string;
+        protocol?: string;
+    }): Promise<void>;
+    sendWebsocketMessage(options: {
+        instanceId: string;
+        kernelId: string;
+        wsUrl: string;
+        message: string;
+    }): Promise<void>;
+    getResponse(options: {
+        method: string;
+        urlPath: string;
+        headers: IDict;
+        requestBody?: ArrayBuffer;
+        params?: string;
+    }): Promise<IDict>;
+    executeCode(code: KernelMessage.IExecuteRequestMsg['content'], waitForResult?: boolean): Promise<string | null>;
+    dispose(): void;
+    protected buildBaseURL(options: {
+        instanceId: string;
+        kernelClientId: string;
+        framework: JupyterPackFramework;
+    }): string;
+    protected _baseUrl: string | undefined;
+    private _isDisposed;
+    private _sessionConnection;
+    private _wsPatch;
+}
+export declare namespace KernelExecutor {
+    interface IOptions {
+        sessionConnection: Session.ISessionConnection;
+    }
+}

package/lib/pythonServer/kernelExecutor.js

@@ -0,0 +1,140 @@
+import { PageConfig, URLExt } from '@jupyterlab/coreutils';
+import stripAnsi from 'strip-ansi';
+import { arrayBufferToBase64, base64ToArrayBuffer, base64ToString, isBinaryContentType } from '../tools';
+import websocketPatch from '../websocket/websocket.js?raw';
+export class KernelExecutor {
+    constructor(options) {
+        this._isDisposed = false;
+        this._sessionConnection = options.sessionConnection;
+        this._wsPatch = websocketPatch.replaceAll('"use strict";', '');
+    }
+    get isDisposed() {
+        return this._isDisposed;
+    }
+    async init(options) {
+        const patchCode = `
+    from jupyterpack.common import patch_all
+    patch_all()
+    `;
+        await this.executeCode({ code: patchCode });
+    }
+    openWebsocketFunctionFactory(options) {
+        return undefined;
+    }
+    sendWebsocketMessageFunctionFactory(options) {
+        return undefined;
+    }
+    async openWebsocket(options) {
+        const code = this.openWebsocketFunctionFactory(options);
+        if (code) {
+            await this.executeCode({ code });
+        }
+    }
+    async sendWebsocketMessage(options) {
+        const code = this.sendWebsocketMessageFunctionFactory(options);
+        if (code) {
+            await this.executeCode({ code });
+        }
+    }
+    async getResponse(options) {
+        var _a;
+        const { method, urlPath, requestBody, params, headers } = options;
+        const content = requestBody ? arrayBufferToBase64(requestBody) : undefined;
+        const code = this.getResponseFunctionFactory({
+            method,
+            urlPath,
+            headers,
+            params,
+            content
+        });
+        const raw = await this.executeCode({ code }, true);
+        if (!raw) {
+            throw new Error(`Missing response for ${urlPath}`);
+        }
+        const jsonStr = raw.replaceAll("'", '');
+        const obj = JSON.parse(jsonStr);
+        const responseHeaders = JSON.parse(atob(obj.headers));
+        const contentType = (_a = responseHeaders === null || responseHeaders === void 0 ? void 0 : responseHeaders['Content-Type']) !== null && _a !== void 0 ? _a : responseHeaders === null || responseHeaders === void 0 ? void 0 : responseHeaders['content-type'];
+        let responseContent;
+        if (isBinaryContentType(contentType)) {
+            responseContent = base64ToArrayBuffer(obj.content);
+        }
+        else {
+            responseContent = base64ToString(obj.content);
+        }
+        if (contentType && contentType.toLowerCase() === 'text/html') {
+            responseContent = responseContent.replace('<head>', `<head>\n<script>\n${this._wsPatch}\n</script>\n`);
+        }
+        const decodedObj = {
+            status_code: obj.status_code,
+            headers: responseHeaders,
+            content: responseContent
+        };
+        return decodedObj;
+    }
+    async executeCode(code, waitForResult) {
+        var _a;
+        const kernel = (_a = this._sessionConnection) === null || _a === void 0 ? void 0 : _a.kernel;
+        if (!kernel) {
+            throw new Error('Session has no kernel.');
+        }
+        return new Promise((resolve, reject) => {
+            const future = kernel.requestExecute(code, false, undefined);
+            let executeResult = '';
+            future.onIOPub = (msg) => {
+                const msgType = msg.header.msg_type;
+                switch (msgType) {
+                    case 'execute_result': {
+                        if (waitForResult) {
+                            const content = msg.content
+                                .data['text/plain'];
+                            executeResult += content;
+                            resolve(executeResult);
+                        }
+                        break;
+                    }
+                    case 'stream': {
+                        const content = msg.content;
+                        if (content.text.length === 0) {
+                            break;
+                        }
+                        if (content.name === 'stderr') {
+                            console.error('Kernel stream:', content.text);
+                        }
+                        else {
+                            console.log('Kernel stream:', content.text);
+                        }
+                        break;
+                    }
+                    case 'error': {
+                        console.error('Kernel operation failed', code.code, msg.content.traceback
+                            .map((it) => stripAnsi(it))
+                            .join('\n'));
+                        reject(msg.content);
+                        break;
+                    }
+                    default:
+                        break;
+                }
+            };
+            if (!waitForResult) {
+                resolve(null);
+                // future.dispose() # TODO
+            }
+        });
+    }
+    dispose() {
+        if (this._isDisposed) {
+            return;
+        }
+        this._isDisposed = true;
+        this._sessionConnection.dispose();
+    }
+    buildBaseURL(options) {
+        const { instanceId, kernelClientId, framework } = options;
+        const fullLabextensionsUrl = PageConfig.getOption('fullLabextensionsUrl');
+        const baseURL = URLExt.join(fullLabextensionsUrl, 'jupyterpack/static', instanceId, framework, kernelClientId, '/');
+        this._baseUrl = baseURL;
+        return baseURL;
+    }
+}

package/lib/pythonServer/streamlit/streamlitServer.d.ts

@@ -0,0 +1,14 @@
+import { TornadoServer } from '../tornado/tornadoServer';
+export declare class StreamlitServer extends TornadoServer {
+    init(options: {
+        entryPath?: string;
+        initCode?: string;
+        instanceId: string;
+        kernelClientId: string;
+    }): Promise<void>;
+    reloadPythonServer(options: {
+        entryPath?: string;
+        initCode?: string;
+    }): Promise<void>;
+    protected _SERVER_VAR: string;
+}

package/lib/pythonServer/streamlit/streamlitServer.js

@@ -0,0 +1,51 @@
+import { JupyterPackFramework } from '../../type';
+import { TornadoServer } from '../tornado/tornadoServer';
+export class StreamlitServer extends TornadoServer {
+    constructor() {
+        super(...arguments);
+        this._SERVER_VAR = '__jupyterpack_streamlit_server';
+    }
+    async init(options) {
+        const { instanceId, kernelClientId, entryPath } = options;
+        if (!entryPath) {
+            throw new Error('Missing streamlit entry path, please check your SPK file');
+        }
+        const baseURL = this.buildBaseURL({
+            instanceId,
+            kernelClientId,
+            framework: JupyterPackFramework.STREAMLIT
+        });
+        const patchCode = `
+    from jupyterpack.common import set_base_url_env, patch_tornado, patch_all
+    patch_all()
+    patch_tornado()
+    set_base_url_env("${baseURL}")
+    `;
+        await this.executeCode({ code: patchCode });
+        const bootstrapCode = `
+    from jupyterpack.streamlit import patch_streamlit
+    patch_streamlit()
+    `;
+        await this.executeCode({ code: bootstrapCode });
+        const stCode = `
+      from jupyterpack.streamlit import StreamlitServer, create_streamlit_app
+      __jupyterpack_st_server, __jupyterpack_tor_app = await create_streamlit_app("${entryPath}", "${baseURL}")
+      ${this._SERVER_VAR} = StreamlitServer(__jupyterpack_tor_app, "${baseURL}", __jupyterpack_st_server)
+      `;
+        await this.executeCode({ code: stCode });
+    }
+    async reloadPythonServer(options) {
+        const { entryPath } = options;
+        if (!entryPath || !this._baseUrl) {
+            return;
+        }
+        const reloadCode = `
+      ${this._SERVER_VAR}.dispose()
+      __jupyterpack_st_server, __jupyterpack_tor_app = await create_streamlit_app("${entryPath}", "${this._baseUrl}")
+      ${this._SERVER_VAR}.reload(__jupyterpack_tor_app, __jupyterpack_st_server)
+      `;
+        await this.executeCode({
+            code: reloadCode
+        }, true);
+    }
+}

package/lib/pythonServer/tornado/tornadoServer.d.ts

@@ -0,0 +1,34 @@
+import { IDict } from '../../type';
+import { KernelExecutor } from '../kernelExecutor';
+export declare class TornadoServer extends KernelExecutor {
+    init(options: {
+        initCode?: string;
+        instanceId: string;
+        kernelClientId: string;
+    }): Promise<void>;
+    getResponseFunctionFactory(options: {
+        urlPath: string;
+        method: string;
+        headers: IDict;
+        params?: string;
+        content?: string;
+    }): string;
+    openWebsocketFunctionFactory(options: {
+        instanceId: string;
+        kernelId: string;
+        wsUrl: string;
+        protocol?: string;
+    }): string;
+    sendWebsocketMessageFunctionFactory(options: {
+        instanceId: string;
+        kernelId: string;
+        wsUrl: string;
+        message: string;
+    }): string;
+    disposePythonServer(): Promise<void>;
+    reloadPythonServer(options: {
+        entryPath?: string;
+        initCode?: string;
+    }): Promise<void>;
+    protected _SERVER_VAR: string;
+}