@oceanum/oceanumlab 4.6.0

package/lib/conversationPin.js

@@ -0,0 +1,120 @@
+/**
+ * The notebook the current conversation lives in: what the agent is shown,
+ * and where its answers go.
+ *
+ * Pinned when the conversation starts -- New chat, or the first message after
+ * the panel opens -- to the notebook in the ACTIVE TAB or, when that tab is
+ * not a notebook, to a new notebook made the active tab. Kept for the whole
+ * conversation: switching tabs does not move it, a rename is followed, and a
+ * pinned notebook that has been closed is opened again when an answer has
+ * cells to place in it. The active tab rather than the tracker's current
+ * notebook, which is the LAST-FOCUSED notebook even with a terminal or a text
+ * file in front.
+ */
+export class ConversationPin {
+    constructor(_host) {
+        this._host = _host;
+        this._panel = null;
+        // Kept separately so a closed notebook can be found again.
+        this._path = null;
+        this._started = false;
+        // Starting, re-opening and creating happen one at a time: a second New chat
+        // must find the notebook the first one created as the active tab rather
+        // than create another.
+        this._queue = Promise.resolve();
+    }
+    /** Start a new conversation. Resolves to its notebook's name. */
+    start() {
+        return this._serial(() => this._startNow());
+    }
+    /**
+     * Start the conversation if nothing has, and report its notebook's name
+     * either way.
+     */
+    ensure() {
+        return this._serial(async () => this._started ? this.name() : this._startNow());
+    }
+    /**
+     * The conversation's notebook if it is open, starting the conversation if
+     * nothing has -- but NOT opening a closed one again: that is for placing an
+     * answer, not for asking a question. See path() for reading a closed one.
+     */
+    current() {
+        return this._serial(async () => {
+            if (!this._started) {
+                await this._startNow();
+            }
+            return this._live();
+        });
+    }
+    /**
+     * The conversation's notebook, opened again if it has been closed. When it
+     * cannot be -- deleted, or gone some other way -- a new notebook takes its
+     * place, so the conversation always has one. Null only if none can be made.
+     */
+    notebook() {
+        return this._serial(async () => {
+            if (!this._started) {
+                await this._startNow();
+            }
+            const live = this._live();
+            if (live) {
+                return live;
+            }
+            const reopened = this._path ? await this._host.reopen(this._path) : null;
+            this._pin(reopened !== null && reopened !== void 0 ? reopened : (await this._host.create()));
+            return this._panel;
+        });
+    }
+    /** The conversation's notebook, brought to the front: see notebook(). */
+    async show() {
+        const panel = await this.notebook();
+        if (panel) {
+            this._host.activate(panel);
+        }
+        return panel;
+    }
+    /** Where the notebook's file is -- its last known place while it is closed. */
+    path() {
+        return this._path;
+    }
+    /** The notebook's name -- its last known one while it is closed. */
+    name() {
+        var _a;
+        const live = this._live();
+        if (live) {
+            return live.title.label;
+        }
+        return this._path ? ((_a = this._path.split('/').pop()) !== null && _a !== void 0 ? _a : this._path) : null;
+    }
+    _live() {
+        return this._panel && !this._panel.isDisposed ? this._panel : null;
+    }
+    async _startNow() {
+        var _a;
+        this._pin((_a = this._host.activeTab()) !== null && _a !== void 0 ? _a : (await this._host.create()));
+        this._started = true;
+        return this.name();
+    }
+    _pin(panel) {
+        var _a, _b;
+        (_a = this._panel) === null || _a === void 0 ? void 0 : _a.context.pathChanged.disconnect(this._onPathChanged, this);
+        this._panel = panel;
+        this._path = (_b = panel === null || panel === void 0 ? void 0 : panel.context.path) !== null && _b !== void 0 ? _b : null;
+        // Follows a rename or move made while it is open, so that a notebook
+        // renamed and then closed is found again under its new name.
+        panel === null || panel === void 0 ? void 0 : panel.context.pathChanged.connect(this._onPathChanged, this);
+    }
+    _onPathChanged(_, path) {
+        this._path = path;
+    }
+    _serial(task) {
+        const run = this._queue.then(task);
+        // A failed step is reported to its caller; it must not block the next.
+        this._queue = run.catch(() => {
+            /* swallowed here only */
+        });
+        return run;
+    }
+}
+//# sourceMappingURL=conversationPin.js.map

package/lib/conversationPin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversationPin.js","sourceRoot":"","sources":["../src/conversationPin.ts"],"names":[],"mappings":"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"}

package/lib/handler.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Call the API extension
+ *
+ * @param endPoint API REST end point for the extension
+ * @param init Initial values for the request
+ * @returns The response body interpreted as JSON
+ */
+export declare function requestAPI<T>(endPoint?: string, init?: RequestInit): Promise<T>;

package/lib/handler.js

@@ -0,0 +1,36 @@
+import { URLExt } from '@jupyterlab/coreutils';
+import { ServerConnection } from '@jupyterlab/services';
+/**
+ * Call the API extension
+ *
+ * @param endPoint API REST end point for the extension
+ * @param init Initial values for the request
+ * @returns The response body interpreted as JSON
+ */
+export async function requestAPI(endPoint = '', init = {}) {
+    // Make request to Jupyter API
+    const settings = ServerConnection.makeSettings();
+    const requestUrl = URLExt.join(settings.baseUrl, 'oceanum', // API Namespace
+    endPoint);
+    let response;
+    try {
+        response = await ServerConnection.makeRequest(requestUrl, init, settings);
+    }
+    catch (error) {
+        throw new ServerConnection.NetworkError(error);
+    }
+    let data = await response.text();
+    if (data.length > 0) {
+        try {
+            data = JSON.parse(data);
+        }
+        catch (error) {
+            console.log('Not a JSON response body.', response);
+        }
+    }
+    if (!response.ok) {
+        throw new ServerConnection.ResponseError(response, data.message || data);
+    }
+    return data;
+}
+//# sourceMappingURL=handler.js.map

package/lib/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../src/handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAExD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAC9B,QAAQ,GAAG,EAAE,EACb,OAAoB,EAAE;IAEtB,8BAA8B;IAC9B,MAAM,QAAQ,GAAG,gBAAgB,CAAC,YAAY,EAAE,CAAC;IACjD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAC5B,QAAQ,CAAC,OAAO,EAChB,SAAS,EAAE,gBAAgB;IAC3B,QAAQ,CACT,CAAC;IAEF,IAAI,QAAkB,CAAC;IACvB,IAAI,CAAC;QACH,QAAQ,GAAG,MAAM,gBAAgB,CAAC,WAAW,CAAC,UAAU,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC5E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,gBAAgB,CAAC,YAAY,CAAC,KAAY,CAAC,CAAC;IACxD,CAAC;IAED,IAAI,IAAI,GAAQ,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;IAEtC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,IAAI,CAAC;YACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC1B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,GAAG,CAAC,2BAA2B,EAAE,QAAQ,CAAC,CAAC;QACrD,CAAC;IACH,CAAC;IAED,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;QACjB,MAAM,IAAI,gBAAgB,CAAC,aAAa,CAAC,QAAQ,EAAE,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,CAAC;IAC3E,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,16 @@
+import { JupyterFrontEndPlugin } from '@jupyterlab/application';
+import { LabIcon } from '@jupyterlab/ui-components';
+import '../style/index.css';
+export declare const oceanumIcon: LabIcon;
+/**
+ * Initialization data for the extension.
+ */
+export declare const datamesh_connect_extension: JupyterFrontEndPlugin<void>;
+/**
+ * Second plugin: Oceanum AI chat integration.
+ * Wires ChatRouter → KernelHandoff and exposes the
+ * `oceanum-ai:submit-prompt` command.
+ */
+export declare const oceanum_ai_extension: JupyterFrontEndPlugin<void>;
+declare const _default: JupyterFrontEndPlugin<void>[];
+export default _default;

package/lib/index.js

@@ -0,0 +1,273 @@
+import { ILayoutRestorer, ILabStatus } from '@jupyterlab/application';
+import { ICommandPalette, Notification } from '@jupyterlab/apputils';
+import { LabIcon } from '@jupyterlab/ui-components';
+import { find } from '@lumino/algorithm';
+import { ISettingRegistry } from '@jupyterlab/settingregistry';
+import { IStateDB } from '@jupyterlab/statedb';
+import { INotebookTracker } from '@jupyterlab/notebook';
+import { DatameshConnectWidget } from './DatameshWidget';
+import { DatameshUI } from './DatameshUI';
+import { requestAPI } from './handler';
+import { ChatRouter, ChatRouterError } from './chatRouter';
+import { reporterFor } from './progress';
+import { ConversationPin } from './conversationPin';
+import { snapshotFromIpynb, snapshotOf } from './notebookContext';
+import { notebookHost } from './notebookHost';
+import { KernelHandoff } from './kernelHandoff';
+import { runChatLoop, STOPPED } from './aiLoop';
+import { MAX_OBSERVE_ROUNDS } from './constants';
+import '../style/index.css';
+import oceanumSvg from '../style/icons/oceanum.svg';
+// Theme-adaptive icon using currentColor (auto-adapts to light/dark themes)
+export const oceanumIcon = new LabIcon({
+    name: 'oceanum:icon',
+    svgstr: oceanumSvg
+});
+const PLUGIN_ID = '@oceanum/oceanumlab:datamesh-connect';
+/**
+ * Initialization data for the extension.
+ */
+export const datamesh_connect_extension = {
+    id: PLUGIN_ID,
+    autoStart: true,
+    requires: [
+        ICommandPalette,
+        ILayoutRestorer,
+        ILabStatus,
+        ISettingRegistry,
+        IStateDB
+    ],
+    activate: (app, palette, restorer, status, settingRegistry) => {
+        console.log('Oceanum datamesh connect extension is loaded');
+        //Try to get the datamesh token from the settings
+        const updateSettings = (set) => {
+            const token = set.get('datameshToken');
+            if (token && token.user) {
+                window.datameshToken = token.user;
+                requestAPI('env/', {
+                    method: 'POST',
+                    body: JSON.stringify({ DATAMESH_TOKEN: token.user })
+                }).then(res => console.log(res));
+            }
+            window.injectToken = set.get('injectToken').user;
+        };
+        //Try to get the datamesh token from the envars
+        Promise.all([app.restored, settingRegistry.load(PLUGIN_ID)])
+            .then(([, setting]) => {
+            // Read the settings
+            updateSettings(setting);
+            // Listen for your plugin setting changes using Signal
+            setting.changed.connect(updateSettings);
+        })
+            .catch(reason => {
+            console.error(`Something went wrong when reading the Oceanumlab settings.\n${reason}`);
+        });
+        const getCurrentWidget = () => {
+            return app.shell.currentWidget;
+        };
+        const openDatameshUI = (event) => {
+            const widgetId = 'datamesh-ui';
+            const openWidget = find(app.shell.widgets('main'), (widget, index) => {
+                return widget.id === widgetId;
+            });
+            if (openWidget) {
+                app.shell.activateById(widgetId);
+                return;
+            }
+            const datameshUIWidget = new DatameshUI();
+            datameshUIWidget.title.label = 'Oceanum Datamesh';
+            datameshUIWidget.id = widgetId;
+            datameshUIWidget.title.closable = true;
+            datameshUIWidget.title.icon = oceanumIcon;
+            datameshUIWidget.addClass('datamesh-ui');
+            app.shell.add(datameshUIWidget, 'main');
+        };
+        const datameshConnectWidget = new DatameshConnectWidget({
+            app,
+            name: 'Datamesh Connect',
+            icon: oceanumIcon,
+            openDatameshUI: openDatameshUI,
+            commands: app.commands,
+            getCurrentWidget
+        });
+        datameshConnectWidget.id = 'datamesh-connect';
+        datameshConnectWidget.title.icon = oceanumIcon;
+        datameshConnectWidget.title.caption = 'Datamesh Connect';
+        restorer.add(datameshConnectWidget, 'datamesh-connect');
+        // Rank has been chosen somewhat arbitrarily to give priority to the running
+        // sessions widget in the sidebar.
+        app.shell.add(datameshConnectWidget, 'left', { rank: 900 });
+        app.commands.addCommand('datamesh-ui:open', {
+            execute: (args) => {
+                openDatameshUI(args);
+            }
+        });
+    }
+};
+/**
+ * Second plugin: Oceanum AI chat integration.
+ * Wires ChatRouter → KernelHandoff and exposes the
+ * `oceanum-ai:submit-prompt` command.
+ */
+export const oceanum_ai_extension = {
+    id: '@oceanum/oceanumlab:ai-chat',
+    autoStart: true,
+    requires: [INotebookTracker, ISettingRegistry],
+    activate: (app, notebookTracker, settingRegistry) => {
+        console.log('Oceanum AI chat extension is loaded');
+        const SETTINGS_ID = '@oceanum/oceanumlab:datamesh-connect';
+        settingRegistry
+            .load(SETTINGS_ID)
+            .then(settings => {
+            // The notebook the current conversation lives in: what the agent is
+            // shown, and where its answers go.
+            const pin = new ConversationPin(notebookHost(app, notebookTracker));
+            // What a request carries from the conversation's notebook. An open
+            // notebook is read as it stands; a closed one is read from its file
+            // rather than opened again, which is left for an answer that has
+            // cells to place.
+            // The panel the current request read its selected cell from, if the
+            // notebook was open: a code answer may replace that cell only there.
+            let readFrom = null;
+            const router = new ChatRouter(settings, async () => {
+                const open = await pin.current();
+                readFrom = open;
+                if (open) {
+                    return snapshotOf(open.content);
+                }
+                const path = pin.path();
+                if (!path) {
+                    return null;
+                }
+                try {
+                    const file = await app.serviceManager.contents.get(path, {
+                        content: true
+                    });
+                    return snapshotFromIpynb(file.content);
+                }
+                catch (_a) {
+                    // Gone: an answer's cells will go into a new notebook instead.
+                    return null;
+                }
+            });
+            // Asked only when an answer has blocks to place: brings the
+            // conversation's notebook to the front, opening it again if closed.
+            const handoff = new KernelHandoff(() => pin.show(), () => readFrom);
+            // The run in flight, if any. Command args must be JSON, so a signal
+            // cannot be passed in; Stop is a second command that reaches it here.
+            let current = null;
+            app.commands.addCommand('oceanum-ai:stop', {
+                label: 'Stop the current Oceanum AI response',
+                execute: () => {
+                    current === null || current === void 0 ? void 0 : current.abort();
+                }
+            });
+            app.commands.addCommand('oceanum-ai:new-chat', {
+                label: 'Start a new Oceanum AI chat',
+                execute: () => {
+                    // The run in flight belongs to the conversation being thrown away:
+                    // stop it placing anything more. The panel discards its result.
+                    // It stops being the current run now, not once it has finished
+                    // unwinding, so it cannot report progress into the new chat.
+                    const run = current;
+                    current = null;
+                    run === null || run === void 0 ? void 0 : run.abort();
+                    return pin.start();
+                }
+            });
+            app.commands.addCommand('oceanum-ai:chat-context', {
+                label: 'The notebook the current Oceanum AI chat is about',
+                // Starts the conversation if nothing has -- so the first message of
+                // one nobody started with New chat pins the same way -- and reports
+                // its notebook either way.
+                execute: () => pin.ensure()
+            });
+            app.commands.addCommand('oceanum-ai:submit-prompt', {
+                label: 'Submit prompt to Oceanum AI',
+                execute: async (args) => {
+                    var _a;
+                    const prompt = args['prompt'];
+                    const chatHistory = (_a = args['chatHistory']) !== null && _a !== void 0 ? _a : [];
+                    if (!prompt) {
+                        return;
+                    }
+                    // A caller that skipped 'oceanum-ai:chat-context' still gets a
+                    // conversation pinned the same way.
+                    await pin.ensure();
+                    // Read per prompt, not once at load, so a settings change applies
+                    // to the next question without a reload.
+                    const autoRunCode = settings.get('autoRunCode')
+                        .composite;
+                    const iterate = settings.get('iterate').composite;
+                    current === null || current === void 0 ? void 0 : current.abort();
+                    const controller = new AbortController();
+                    current = controller;
+                    // This run's progress, heard only while it is the current run.
+                    const report = reporterFor(() => current === controller);
+                    try {
+                        // Cleared in the `finally` below however this ends, so the last
+                        // phase does not sit on screen after the answer has arrived --
+                        // or after Stop.
+                        return await runChatLoop(prompt, chatHistory, {
+                            route: (p, h, signal) => router.route(p, h, signal, report),
+                            observe: (p, h, runs, signal) => {
+                                // The agent's turn again: the notebook's "Running the
+                                // code…" must not stay up while the agent reads what the
+                                // code printed.
+                                report({ phase: 'interpreting' });
+                                return router.observe(p, h, runs, signal, report);
+                            },
+                            place: (response, opts) => {
+                                // The notebook's turn, not the agent's. Without this the
+                                // last phase the AGENT reported stays on screen while a
+                                // cell is running, so the user is told the agent is
+                                // reading dataset details when what is actually happening
+                                // is their own code executing. That is a worse claim than
+                                // the "Thinking…" it replaced, which was vague rather than
+                                // wrong. And "running" only when there is code that will.
+                                if (response.blocks.length > 0) {
+                                    const runsCode = autoRunCode &&
+                                        response.blocks.some(block => block.type === 'code' && block.content.trim());
+                                    report({ phase: runsCode ? 'running' : 'placing' });
+                                }
+                                return handoff.inject(response, opts);
+                            }
+                        }, {
+                            autoRunCode,
+                            iterate,
+                            maxRounds: MAX_OBSERVE_ROUNDS,
+                            signal: controller.signal
+                        });
+                    }
+                    catch (err) {
+                        // Anything that failed because the user pressed Stop is not an
+                        // error to them: the aborted fetch, or its body read.
+                        if (controller.signal.aborted) {
+                            return STOPPED;
+                        }
+                        if (err instanceof ChatRouterError) {
+                            Notification.error(err.message, { autoClose: 5000 });
+                        }
+                        else {
+                            console.error('Oceanum AI: unexpected error', err);
+                        }
+                    }
+                    finally {
+                        // However this ended -- answered, failed, or stopped -- the
+                        // agent is no longer doing anything, so the last phase must not
+                        // sit on screen claiming otherwise.
+                        report(null);
+                        if (current === controller) {
+                            current = null;
+                        }
+                    }
+                }
+            });
+        })
+            .catch(reason => {
+            console.error(`Oceanum AI: could not load settings from ${SETTINGS_ID}.\n${reason}`);
+        });
+    }
+};
+export default [datamesh_connect_extension, oceanum_ai_extension];
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,eAAe,EACf,UAAU,EACX,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACrE,OAAO,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACpD,OAAO,EAAE,IAAI,EAAE,MAAM,mBAAmB,CAAC;AAEzC,OAAO,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAiB,MAAM,sBAAsB,CAAC;AACvE,OAAO,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AACvC,OAAO,EAAE,UAAU,EAAE,eAAe,EAAe,MAAM,cAAc,CAAC;AACxE,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,oBAAoB,CAAC;AAE5B,OAAO,UAAU,MAAM,4BAA4B,CAAC;AAEpD,4EAA4E;AAC5E,MAAM,CAAC,MAAM,WAAW,GAAG,IAAI,OAAO,CAAC;IACrC,IAAI,EAAE,cAAc;IACpB,MAAM,EAAE,UAAU;CACnB,CAAC,CAAC;AAEH,MAAM,SAAS,GAAG,sCAAsC,CAAC;AAEzD;;GAEG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAgC;IACrE,EAAE,EAAE,SAAS;IACb,SAAS,EAAE,IAAI;IACf,QAAQ,EAAE;QACR,eAAe;QACf,eAAe;QACf,UAAU;QACV,gBAAgB;QAChB,QAAQ;KACT;IACD,QAAQ,EAAE,CACR,GAAoB,EACpB,OAAwB,EACxB,QAAyB,EACzB,MAAkB,EAClB,eAAiC,EACjC,EAAE;QACF,OAAO,CAAC,GAAG,CAAC,8CAA8C,CAAC,CAAC;QAE5D,iDAAiD;QACjD,MAAM,cAAc,GAAG,CAAC,GAA+B,EAAE,EAAE;YACzD,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YACvC,IAAI,KAAK,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC;gBACxB,MAAM,CAAC,aAAa,GAAG,KAAK,CAAC,IAAc,CAAC;gBAC5C,UAAU,CAAC,MAAM,EAAE;oBACjB,MAAM,EAAE,MAAM;oBACd,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,cAAc,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;iBACrD,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;YACnC,CAAC;YACD,MAAM,CAAC,WAAW,GAAG,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,IAAe,CAAC;QAC9D,CAAC,CAAC;QACF,+CAA+C;QAE/C,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,eAAe,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;aACzD,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,EAAE;YACpB,oBAAoB;YACpB,cAAc,CAAC,OAAO,CAAC,CAAC;YAExB,sDAAsD;YACtD,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QAC1C,CAAC,CAAC;aACD,KAAK,CAAC,MAAM,CAAC,EAAE;YACd,OAAO,CAAC,KAAK,CACX,+DAA+D,MAAM,EAAE,CACxE,CAAC;QACJ,CAAC,CAAC,CAAC;QAEL,MAAM,gBAAgB,GAAG,GAAW,EAAE;YACpC,OAAO,GAAG,CAAC,KAAM,CAAC,aAAc,CAAC;QACnC,CAAC,CAAC;QAEF,MAAM,cAAc,GAAG,CAAC,KAAU,EAAQ,EAAE;YAC1C,MAAM,QAAQ,GAAG,aAAa,CAAC;YAC/B,MAAM,UAAU,GAAG,IAAI,CACrB,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EACzB,CAAC,MAAc,EAAE,KAAa,EAAE,EAAE;gBAChC,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ,CAAC;YAChC,CAAC,CACF,CAAC;YACF,IAAI,UAAU,EAAE,CAAC;gBACf,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;gBACjC,OAAO;YACT,CAAC;YAED,MAAM,gBAAgB,GAAG,IAAI,UAAU,EAAE,CAAC;YAC1C,gBAAgB,CAAC,KAAK,CAAC,KAAK,GAAG,kBAAkB,CAAC;YAClD,gBAAgB,CAAC,EAAE,GAAG,QAAQ,CAAC;YAC/B,gBAAgB,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;YACvC,gBAAgB,CAAC,KAAK,CAAC,IAAI,GAAG,WAAW,CAAC;YAC1C,gBAAgB,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC;YACzC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,gBAAgB,EAAE,MAAM,CAAC,CAAC;QAC1C,CAAC,CAAC;QAEF,MAAM,qBAAqB,GAAG,IAAI,qBAAqB,CAAC;YACtD,GAAG;YACH,IAAI,EAAE,kBAAkB;YACxB,IAAI,EAAE,WAAW;YACjB,cAAc,EAAE,cAAc;YAC9B,QAAQ,EAAE,GAAG,CAAC,QAAQ;YACtB,gBAAgB;SACjB,CAAC,CAAC;QACH,qBAAqB,CAAC,EAAE,GAAG,kBAAkB,CAAC;QAC9C,qBAAqB,CAAC,KAAK,CAAC,IAAI,GAAG,WAAW,CAAC;QAC/C,qBAAqB,CAAC,KAAK,CAAC,OAAO,GAAG,kBAAkB,CAAC;QAEzD,QAAQ,CAAC,GAAG,CAAC,qBAAqB,EAAE,kBAAkB,CAAC,CAAC;QAExD,4EAA4E;QAC5E,kCAAkC;QAClC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,qBAAqB,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QAE5D,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,kBAAkB,EAAE;YAC1C,OAAO,EAAE,CAAC,IAAS,EAAE,EAAE;gBACrB,cAAc,CAAC,IAAI,CAAC,CAAC;YACvB,CAAC;SACF,CAAC,CAAC;IACL,CAAC;CACF,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAgC;IAC/D,EAAE,EAAE,6BAA6B;IACjC,SAAS,EAAE,IAAI;IACf,QAAQ,EAAE,CAAC,gBAAgB,EAAE,gBAAgB,CAAC;IAC9C,QAAQ,EAAE,CACR,GAAoB,EACpB,eAAiC,EACjC,eAAiC,EACjC,EAAE;QACF,OAAO,CAAC,GAAG,CAAC,qCAAqC,CAAC,CAAC;QAEnD,MAAM,WAAW,GAAG,sCAAsC,CAAC;QAE3D,eAAe;aACZ,IAAI,CAAC,WAAW,CAAC;aACjB,IAAI,CAAC,QAAQ,CAAC,EAAE;YACf,oEAAoE;YACpE,mCAAmC;YACnC,MAAM,GAAG,GAAG,IAAI,eAAe,CAAC,YAAY,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,CAAC;YAEpE,mEAAmE;YACnE,oEAAoE;YACpE,iEAAiE;YACjE,kBAAkB;YAClB,oEAAoE;YACpE,qEAAqE;YACrE,IAAI,QAAQ,GAAyB,IAAI,CAAC;YAC1C,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;gBACjD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,OAAO,EAAE,CAAC;gBACjC,QAAQ,GAAG,IAAI,CAAC;gBAChB,IAAI,IAAI,EAAE,CAAC;oBACT,OAAO,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBAClC,CAAC;gBACD,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,EAAE,CAAC;gBACxB,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,OAAO,IAAI,CAAC;gBACd,CAAC;gBACD,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE;wBACvD,OAAO,EAAE,IAAI;qBACd,CAAC,CAAC;oBACH,OAAO,iBAAiB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;gBACzC,CAAC;gBAAC,WAAM,CAAC;oBACP,+DAA+D;oBAC/D,OAAO,IAAI,CAAC;gBACd,CAAC;YACH,CAAC,CAAC,CAAC;YACH,4DAA4D;YAC5D,oEAAoE;YACpE,MAAM,OAAO,GAAG,IAAI,aAAa,CAC/B,GAAG,EAAE,CAAC,GAAG,CAAC,IAAI,EAAE,EAChB,GAAG,EAAE,CAAC,QAAQ,CACf,CAAC;YAEF,oEAAoE;YACpE,sEAAsE;YACtE,IAAI,OAAO,GAA2B,IAAI,CAAC;YAE3C,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,iBAAiB,EAAE;gBACzC,KAAK,EAAE,sCAAsC;gBAC7C,OAAO,EAAE,GAAG,EAAE;oBACZ,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,EAAE,CAAC;gBACnB,CAAC;aACF,CAAC,CAAC;YAEH,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,qBAAqB,EAAE;gBAC7C,KAAK,EAAE,6BAA6B;gBACpC,OAAO,EAAE,GAAG,EAAE;oBACZ,mEAAmE;oBACnE,gEAAgE;oBAChE,+DAA+D;oBAC/D,6DAA6D;oBAC7D,MAAM,GAAG,GAAG,OAAO,CAAC;oBACpB,OAAO,GAAG,IAAI,CAAC;oBACf,GAAG,aAAH,GAAG,uBAAH,GAAG,CAAE,KAAK,EAAE,CAAC;oBACb,OAAO,GAAG,CAAC,KAAK,EAAE,CAAC;gBACrB,CAAC;aACF,CAAC,CAAC;YAEH,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,yBAAyB,EAAE;gBACjD,KAAK,EAAE,mDAAmD;gBAC1D,oEAAoE;gBACpE,oEAAoE;gBACpE,2BAA2B;gBAC3B,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,MAAM,EAAE;aAC5B,CAAC,CAAC;YAEH,GAAG,CAAC,QAAQ,CAAC,UAAU,CAAC,0BAA0B,EAAE;gBAClD,KAAK,EAAE,6BAA6B;gBACpC,OAAO,EAAE,KAAK,EAAE,IAA6B,EAAE,EAAE;;oBAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAuB,CAAC;oBACpD,MAAM,WAAW,GAAG,MAAC,IAAI,CAAC,aAAa,CAAmB,mCAAI,EAAE,CAAC;oBACjE,IAAI,CAAC,MAAM,EAAE,CAAC;wBACZ,OAAO;oBACT,CAAC;oBACD,+DAA+D;oBAC/D,oCAAoC;oBACpC,MAAM,GAAG,CAAC,MAAM,EAAE,CAAC;oBACnB,kEAAkE;oBAClE,yCAAyC;oBACzC,MAAM,WAAW,GAAG,QAAQ,CAAC,GAAG,CAAC,aAAa,CAAC;yBAC5C,SAAoB,CAAC;oBACxB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,SAAoB,CAAC;oBAE7D,OAAO,aAAP,OAAO,uBAAP,OAAO,CAAE,KAAK,EAAE,CAAC;oBACjB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;oBACzC,OAAO,GAAG,UAAU,CAAC;oBACrB,+DAA+D;oBAC/D,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,OAAO,KAAK,UAAU,CAAC,CAAC;oBACzD,IAAI,CAAC;wBACH,gEAAgE;wBAChE,+DAA+D;wBAC/D,iBAAiB;wBACjB,OAAO,MAAM,WAAW,CACtB,MAAM,EACN,WAAW,EACX;4BACE,KAAK,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC;4BAC3D,OAAO,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE;gCAC9B,sDAAsD;gCACtD,yDAAyD;gCACzD,gBAAgB;gCAChB,MAAM,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;gCAClC,OAAO,MAAM,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;4BACpD,CAAC;4BACD,KAAK,EAAE,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAE;gCACxB,yDAAyD;gCACzD,wDAAwD;gCACxD,oDAAoD;gCACpD,0DAA0D;gCAC1D,0DAA0D;gCAC1D,2DAA2D;gCAC3D,0DAA0D;gCAC1D,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oCAC/B,MAAM,QAAQ,GACZ,WAAW;wCACX,QAAQ,CAAC,MAAM,CAAC,IAAI,CAClB,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,CACvD,CAAC;oCACJ,MAAM,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC;gCACtD,CAAC;gCACD,OAAO,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;4BACxC,CAAC;yBACF,EACD;4BACE,WAAW;4BACX,OAAO;4BACP,SAAS,EAAE,kBAAkB;4BAC7B,MAAM,EAAE,UAAU,CAAC,MAAM;yBAC1B,CACF,CAAC;oBACJ,CAAC;oBAAC,OAAO,GAAG,EAAE,CAAC;wBACb,+DAA+D;wBAC/D,sDAAsD;wBACtD,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;4BAC9B,OAAO,OAAO,CAAC;wBACjB,CAAC;wBACD,IAAI,GAAG,YAAY,eAAe,EAAE,CAAC;4BACnC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;wBACvD,CAAC;6BAAM,CAAC;4BACN,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAC;wBACrD,CAAC;oBACH,CAAC;4BAAS,CAAC;wBACT,4DAA4D;wBAC5D,gEAAgE;wBAChE,oCAAoC;wBACpC,MAAM,CAAC,IAAI,CAAC,CAAC;wBACb,IAAI,OAAO,KAAK,UAAU,EAAE,CAAC;4BAC3B,OAAO,GAAG,IAAI,CAAC;wBACjB,CAAC;oBACH,CAAC;gBACH,CAAC;aACF,CAAC,CAAC;QACL,CAAC,CAAC;aACD,KAAK,CAAC,MAAM,CAAC,EAAE;YACd,OAAO,CAAC,KAAK,CACX,4CAA4C,WAAW,MAAM,MAAM,EAAE,CACtE,CAAC;QACJ,CAAC,CAAC,CAAC;IACP,CAAC;CACF,CAAC;AAEF,eAAe,CAAC,0BAA0B,EAAE,oBAAoB,CAAC,CAAC"}

package/lib/kernelHandoff.d.ts

@@ -0,0 +1,61 @@
+import { NotebookPanel } from '@jupyterlab/notebook';
+import { OceanumResponse } from './chatRouter';
+import type { PlacedResponse } from './aiLoop';
+export interface InjectOptions {
+    /** If true, replace the selected code cell instead of inserting a new one */
+    replaceCodeCell?: boolean;
+    /** Run each code cell as it is placed. A user setting, not a build constant. */
+    autoRun?: boolean;
+    /**
+     * Stop. Once aborted, no further block is placed or run, and a cell that is
+     * executing is interrupted -- the kernel is the half of a round that an
+     * aborted fetch cannot reach.
+     */
+    signal?: AbortSignal;
+}
+export declare class KernelHandoff {
+    private _target;
+    private _readFrom;
+    /**
+     * @param _target The conversation's notebook, brought to the front -- and
+     *   opened again first, if it was closed. Asked only when there is
+     *   something to place, so an answer with no blocks leaves the tabs alone.
+     * @param _readFrom The panel the request read its selected cell from, if
+     *   any. A code answer replaces the selected cell only in that same panel:
+     *   one opened since has some other cell selected, and replacing it would
+     *   overwrite the user's work.
+     */
+    constructor(_target: () => Promise<NotebookPanel | null>, _readFrom: () => NotebookPanel | null);
+    /**
+     * Place every block the response carries, in order, and return the message
+     * for the chat window.
+     *
+     * This used to switch on `response.type`, because a response was exactly one
+     * of text, code or markdown. It can now carry any number of blocks in any
+     * combination (OCE-173) — a markdown table describing a dataset followed by
+     * the query that produced it is one response, not two — so the branch became
+     * a loop. No blocks is the commonest case and still touches no notebook.
+     */
+    inject(response: OceanumResponse, options?: InjectOptions): Promise<PlacedResponse>;
+    /**
+     * Execute one cell and report what happened, and whether it happened at all.
+     *
+     * `runCells` resolves false for a kernel error (the traceback is in the
+     * outputs) and for some of the ways a cell can fail to execute at all
+     * (pending input, interrupted); it resolves TRUE with nothing run when there
+     * is no kernel, when the kernel is terminating, or when the kernel is still
+     * starting (`CodeCell.execute` bails silently on a session without a
+     * kernel); and it rejects when the kernel is dead. None of the did-not-run
+     * paths touch the outputs, so a replaced cell would still show its previous
+     * run; they are cleared first so that whatever is there afterwards came from
+     * this run. The execution count is cleared with them and only a kernel
+     * reply sets it again, so a null count afterwards means nothing ran,
+     * whatever `runCells` resolved to; that is reported as an error rather than
+     * as a clean, silent run.
+     *
+     * Pending input is refused BEFORE clearing: clearing the outputs of a cell
+     * that is waiting on `input()` disposes the prompt widget, and the kernel
+     * then waits forever for an answer nobody can give.
+     */
+    private _run;
+}