@oceanum/oceanumlab 4.6.0

package/lib/progress.d.ts

@@ -0,0 +1,43 @@
+/**
+ * What the agent is doing right now, from the extension host to the widget
+ * (OCE-175).
+ *
+ * A channel is needed because the widget does not call the router: it issues
+ * the `oceanum-ai:submit-prompt` COMMAND, and command arguments must be JSON,
+ * so a callback cannot cross. The Stop button has the same constraint and
+ * solves it the same way -- an AbortController held in the plugin's closure.
+ *
+ * A module singleton rather than a JupyterLab `Signal`, because a Signal wants
+ * an owner object and there is no natural one here: the producer is a command
+ * handler and the consumer is a React component that mounts and unmounts
+ * independently of it.
+ */
+/** A phase the backend named, and the tool it is using if that is the phase. */
+export interface Progress {
+    phase: string;
+    tool?: string;
+}
+type Listener = (progress: Progress | null) => void;
+/** Subscribe. Returns the unsubscribe, for a React effect's cleanup. */
+export declare function onProgress(listener: Listener): () => void;
+/**
+ * Publish. `null` means "no longer working", which the widget uses to fall
+ * back to its own wording rather than leaving the last phase on screen after
+ * the answer has arrived.
+ *
+ * A listener that throws must not stop the others hearing, nor break the
+ * request: this is decoration, and a broken indicator is not worth failing an
+ * answer over.
+ */
+export declare function reportProgress(progress: Progress | null): void;
+/**
+ * A reporter for one run: it publishes only while `isCurrent()` holds.
+ *
+ * A run that New chat or a newer prompt replaced is aborted, but it can take a
+ * while to unwind -- a cell that ignores the interrupt keeps it in its handoff
+ * -- and whatever it reports on the way out, a phase or its "no longer
+ * working", would land on the new run's progress line.
+ */
+export declare function reporterFor(isCurrent: () => boolean): (progress: Progress | null) => void;
+export declare function describeProgress(progress: Progress | null): string;
+export {};

package/lib/progress.js

@@ -0,0 +1,103 @@
+/**
+ * What the agent is doing right now, from the extension host to the widget
+ * (OCE-175).
+ *
+ * A channel is needed because the widget does not call the router: it issues
+ * the `oceanum-ai:submit-prompt` COMMAND, and command arguments must be JSON,
+ * so a callback cannot cross. The Stop button has the same constraint and
+ * solves it the same way -- an AbortController held in the plugin's closure.
+ *
+ * A module singleton rather than a JupyterLab `Signal`, because a Signal wants
+ * an owner object and there is no natural one here: the producer is a command
+ * handler and the consumer is a React component that mounts and unmounts
+ * independently of it.
+ */
+const listeners = new Set();
+/** Subscribe. Returns the unsubscribe, for a React effect's cleanup. */
+export function onProgress(listener) {
+    listeners.add(listener);
+    return () => {
+        listeners.delete(listener);
+    };
+}
+/**
+ * Publish. `null` means "no longer working", which the widget uses to fall
+ * back to its own wording rather than leaving the last phase on screen after
+ * the answer has arrived.
+ *
+ * A listener that throws must not stop the others hearing, nor break the
+ * request: this is decoration, and a broken indicator is not worth failing an
+ * answer over.
+ */
+export function reportProgress(progress) {
+    for (const listener of listeners) {
+        try {
+            listener(progress);
+        }
+        catch (err) {
+            console.error('Oceanum AI: a progress listener threw', err);
+        }
+    }
+}
+/**
+ * A reporter for one run: it publishes only while `isCurrent()` holds.
+ *
+ * A run that New chat or a newer prompt replaced is aborted, but it can take a
+ * while to unwind -- a cell that ignores the interrupt keeps it in its handoff
+ * -- and whatever it reports on the way out, a phase or its "no longer
+ * working", would land on the new run's progress line.
+ */
+export function reporterFor(isCurrent) {
+    return progress => {
+        if (isCurrent()) {
+            reportProgress(progress);
+        }
+    };
+}
+/**
+ * What each phase is, in the user's terms.
+ *
+ * An unlisted phase or tool falls back to something generic rather than
+ * showing its internal name: a new server-side tool should read as progress,
+ * not as a leak of what the agent is made of. And no phase at all reads as
+ * "Thinking…", which is what this said before there was anything better to
+ * say -- so a backend that does not stream, or a proxy that buffered the
+ * stream away, degrades to exactly the old behaviour rather than to a blank.
+ */
+const TOOL_LABELS = {
+    search_catalog: 'Searching the catalogue…',
+    get_datasource_info: 'Reading dataset details…',
+    save_memory: 'Saving a note…'
+};
+const PHASE_LABELS = {
+    generating: 'Thinking…',
+    interpreting: 'Reading the result…',
+    // Reported by the client, not the server: these two are the notebook's turn.
+    // Everything else here names something the agent is doing, and saying so
+    // while a cell runs would be actively false rather than merely vague.
+    running: 'Running the code…',
+    placing: 'Adding the code to the notebook…'
+};
+export function describeProgress(progress) {
+    var _a, _b;
+    if (!progress) {
+        return 'Thinking…';
+    }
+    if (progress.phase === 'tool') {
+        return (_a = labelFor(TOOL_LABELS, progress.tool)) !== null && _a !== void 0 ? _a : 'Looking something up…';
+    }
+    return (_b = labelFor(PHASE_LABELS, progress.phase)) !== null && _b !== void 0 ? _b : 'Working…';
+}
+/**
+ * The label `labels` itself gives `name`, if any. Only its own entries: the
+ * name comes off the stream -- a tool name is whatever the model called -- and
+ * `__proto__` or `toString` must not reach into Object.prototype. That hands
+ * React an object or a function to render, and an object breaks the panel.
+ */
+function labelFor(labels, name) {
+    return name !== undefined &&
+        Object.prototype.hasOwnProperty.call(labels, name)
+        ? labels[name]
+        : undefined;
+}
+//# sourceMappingURL=progress.js.map

package/lib/progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"progress.js","sourceRoot":"","sources":["../src/progress.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAUH,MAAM,SAAS,GAAG,IAAI,GAAG,EAAY,CAAC;AAEtC,wEAAwE;AACxE,MAAM,UAAU,UAAU,CAAC,QAAkB;IAC3C,SAAS,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IACxB,OAAO,GAAG,EAAE;QACV,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC7B,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,cAAc,CAAC,QAAyB;IACtD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC;YACH,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACrB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,KAAK,CAAC,uCAAuC,EAAE,GAAG,CAAC,CAAC;QAC9D,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,WAAW,CACzB,SAAwB;IAExB,OAAO,QAAQ,CAAC,EAAE;QAChB,IAAI,SAAS,EAAE,EAAE,CAAC;YAChB,cAAc,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,WAAW,GAA2B;IAC1C,cAAc,EAAE,0BAA0B;IAC1C,mBAAmB,EAAE,0BAA0B;IAC/C,WAAW,EAAE,gBAAgB;CAC9B,CAAC;AAEF,MAAM,YAAY,GAA2B;IAC3C,UAAU,EAAE,WAAW;IACvB,YAAY,EAAE,qBAAqB;IACnC,6EAA6E;IAC7E,yEAAyE;IACzE,sEAAsE;IACtE,OAAO,EAAE,mBAAmB;IAC5B,OAAO,EAAE,kCAAkC;CAC5C,CAAC;AAEF,MAAM,UAAU,gBAAgB,CAAC,QAAyB;;IACxD,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,WAAW,CAAC;IACrB,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,KAAK,MAAM,EAAE,CAAC;QAC9B,OAAO,MAAA,QAAQ,CAAC,WAAW,EAAE,QAAQ,CAAC,IAAI,CAAC,mCAAI,uBAAuB,CAAC;IACzE,CAAC;IACD,OAAO,MAAA,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,KAAK,CAAC,mCAAI,UAAU,CAAC;AAC9D,CAAC;AAED;;;;;GAKG;AACH,SAAS,QAAQ,CACf,MAA8B,EAC9B,IAAwB;IAExB,OAAO,IAAI,KAAK,SAAS;QACvB,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC;QAClD,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;QACd,CAAC,CAAC,SAAS,CAAC;AAChB,CAAC"}

package/lib/sse.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Reading a Server-Sent Events body (OCE-175).
+ *
+ * Small and local rather than a dependency: SSE is a line format, the backend
+ * emits one `data:` line per event, and a library would bring a parser for the
+ * multi-line and retry-directive cases this stream does not use.
+ *
+ * Note it is NOT `EventSource`. That only issues GETs, and these are POSTs with
+ * a body and an auth header, which is why every client of this API hand-rolls
+ * the read.
+ */
+/** One frame off the wire. `data` is raw; the caller parses it. */
+export interface SseEvent {
+    event: string;
+    data: string;
+    id?: string;
+}
+/**
+ * Yield each event as it arrives.
+ *
+ * Decodes with `stream: true` so a multi-byte character split across two
+ * network chunks is reassembled rather than mangled -- a UTF-8 sequence has no
+ * obligation to arrive whole, and a dataset name with an accent in it is the
+ * kind of thing that finds this bug in production rather than in a test.
+ */
+export declare function readSse(body: ReadableStream<Uint8Array>, signal?: AbortSignal): AsyncGenerator<SseEvent>;

package/lib/sse.js

@@ -0,0 +1,112 @@
+/**
+ * Reading a Server-Sent Events body (OCE-175).
+ *
+ * Small and local rather than a dependency: SSE is a line format, the backend
+ * emits one `data:` line per event, and a library would bring a parser for the
+ * multi-line and retry-directive cases this stream does not use.
+ *
+ * Note it is NOT `EventSource`. That only issues GETs, and these are POSTs with
+ * a body and an auth header, which is why every client of this API hand-rolls
+ * the read.
+ */
+/**
+ * Yield each event as it arrives.
+ *
+ * Decodes with `stream: true` so a multi-byte character split across two
+ * network chunks is reassembled rather than mangled -- a UTF-8 sequence has no
+ * obligation to arrive whole, and a dataset name with an accent in it is the
+ * kind of thing that finds this bug in production rather than in a test.
+ */
+export async function* readSse(body, signal) {
+    const reader = body.getReader();
+    const decoder = new TextDecoder();
+    let buffer = '';
+    /** Every complete frame currently in the buffer. Events are separated by a
+     * blank line; anything after the last one is partial and stays put. */
+    function* drain() {
+        let split = buffer.indexOf('\n\n');
+        while (split !== -1) {
+            const frame = buffer.slice(0, split);
+            buffer = buffer.slice(split + 2);
+            const parsed = parseFrame(frame);
+            if (parsed) {
+                yield parsed;
+            }
+            split = buffer.indexOf('\n\n');
+        }
+    }
+    try {
+        while (true) {
+            if (signal === null || signal === void 0 ? void 0 : signal.aborted) {
+                return;
+            }
+            const { done, value } = await reader.read();
+            if (done) {
+                // Flush the deferred `\r`, if any: no further chunk is coming, so it
+                // cannot be half of a CRLF and IS a line ending. Without this a stream
+                // using bare CR loses its final frame -- the terminator never forms.
+                buffer = normaliseNewlines(buffer, true);
+                yield* drain();
+                break;
+            }
+            buffer = normaliseNewlines(buffer + decoder.decode(value, { stream: true }));
+            yield* drain();
+        }
+    }
+    finally {
+        // Releases the reader's lock whether the consumer finished, threw, or
+        // stopped early -- a `break` in a for-await runs this. It does not cancel
+        // the body: the backend ends the stream after `done` or `error`, and Stop's
+        // abort closes the connection itself.
+        reader.releaseLock();
+    }
+}
+/**
+ * Collapse CRLF and bare CR to LF, so the rest of the parser can look for a
+ * single line ending.
+ *
+ * The spec allows all three, and our own backend sends LF -- but "our backend
+ * sends LF" is a statement about one hop. Anything between it and the browser
+ * may rewrite line endings, and the failure if it does is total rather than
+ * partial: the frame separator `\n\n` never matches `\r\n\r\n`, so ZERO events
+ * parse, the stream looks empty, and the caller reports the response as
+ * incomplete. Measured before this existed: 0 events from a well-formed CRLF
+ * stream.
+ *
+ * The trailing `\r` is held back, and that is the whole subtlety. A chunk may
+ * end mid-CRLF, with the `\n` arriving next; converting that `\r` to `\n` now
+ * and meeting its partner later would manufacture a blank line -- a frame
+ * boundary that was never sent, splitting one event into two malformed ones.
+ * So it waits for the next chunk, exactly as a split multi-byte character does.
+ */
+function normaliseNewlines(buffer, final = false) {
+    const held = !final && buffer.endsWith('\r') ? '\r' : '';
+    const body = held ? buffer.slice(0, -1) : buffer;
+    return body.replace(/\r\n/g, '\n').replace(/\r/g, '\n') + held;
+}
+function parseFrame(frame) {
+    let event = 'message';
+    let id;
+    const data = [];
+    for (const line of frame.split('\n')) {
+        // A comment. The backend sends these as keepalives during a long wait, and
+        // they carry nothing.
+        if (line.startsWith(':')) {
+            continue;
+        }
+        if (line.startsWith('event:')) {
+            event = line.slice('event:'.length).trim();
+        }
+        else if (line.startsWith('data:')) {
+            data.push(line.slice('data:'.length).trim());
+        }
+        else if (line.startsWith('id:')) {
+            id = line.slice('id:'.length).trim();
+        }
+    }
+    if (data.length === 0) {
+        return null;
+    }
+    return { event, data: data.join('\n'), id };
+}
+//# sourceMappingURL=sse.js.map

package/lib/sse.js.map

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

package/package.json

@@ -0,0 +1,151 @@
+{
+    "name": "@oceanum/oceanumlab",
+    "version": "4.6.0",
+    "description": "A Jupyterlab extension to interact with the Oceanum.io platform",
+    "keywords": [
+        "jupyter",
+        "jupyterlab",
+        "jupyterlab-extension"
+    ],
+    "homepage": "https://github.com/oceanum-io/oceanumlab.git",
+    "bugs": {
+        "url": "https://github.com/oceanum-io/oceanumlab.git/issues"
+    },
+    "license": "BSD-3-Clause",
+    "author": {
+        "name": "Oceanum",
+        "email": "developers@oceanum.science"
+    },
+    "files": [
+        "lib/**/*.{d.ts,eot,gif,html,jpg,js,js.map,json,png,svg,woff2,ttf}",
+        "style/**/*.{css,js,eot,gif,html,jpg,json,png,svg,woff2,ttf}",
+        "src/**/*.{ts,tsx}",
+        "schema/*.json"
+    ],
+    "main": "lib/index.js",
+    "types": "lib/index.d.ts",
+    "style": "style/index.css",
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/oceanum-io/oceanumlab.git"
+    },
+    "scripts": {
+        "build": "jlpm build:lib && jlpm build:labextension:dev",
+        "build:prod": "jlpm clean && jlpm build:lib:prod && jlpm build:labextension",
+        "build:labextension": "jupyter labextension build .",
+        "build:labextension:dev": "jupyter labextension build --development True .",
+        "build:lib": "tsc --sourceMap",
+        "build:lib:prod": "tsc",
+        "clean": "jlpm clean:lib",
+        "clean:lib": "rimraf lib tsconfig.tsbuildinfo",
+        "clean:lintcache": "rimraf .eslintcache .stylelintcache",
+        "clean:labextension": "rimraf oceanumlab/labextension oceanumlab/_version.py",
+        "clean:all": "jlpm clean:lib && jlpm clean:labextension && jlpm clean:lintcache",
+        "eslint": "jlpm eslint:check --fix",
+        "eslint:check": "ESLINT_USE_FLAT_CONFIG=false eslint . --cache --ext .ts,.tsx",
+        "install:extension": "jlpm build",
+        "lint": "jlpm stylelint && jlpm prettier && jlpm eslint",
+        "lint:check": "jlpm stylelint:check && jlpm prettier:check && jlpm eslint:check",
+        "prettier": "jlpm prettier:base --write --list-different",
+        "prettier:base": "prettier \"**/*{.ts,.tsx,.js,.jsx,.css,.json,.md}\"",
+        "prettier:check": "jlpm prettier:base --check",
+        "stylelint": "jlpm stylelint:check --fix",
+        "stylelint:check": "stylelint --cache \"style/**/*.css\"",
+        "test": "jest --coverage",
+        "watch": "run-p watch:src watch:labextension",
+        "watch:src": "tsc -w --sourceMap",
+        "watch:labextension": "jupyter labextension watch ."
+    },
+    "dependencies": {
+        "@jupyterlab/application": "^4.6.3",
+        "@jupyterlab/apputils": "^4.7.3",
+        "@jupyterlab/cells": "^4.6.3",
+        "@jupyterlab/notebook": "^4.6.3",
+        "@jupyterlab/settingregistry": "^4.6.3",
+        "@phosphor-icons/react": "^2.1.10",
+        "marked": "^18.0.13"
+    },
+    "devDependencies": {
+        "@jupyterlab/builder": "^4.5.10",
+        "@jupyterlab/testutils": "^4.6.3",
+        "@types/jest": "^29.5.12",
+        "@types/json-schema": "^7.0.15",
+        "@types/react": "^18.2.75",
+        "@types/react-addons-linked-state-mixin": "^0.14.27",
+        "@typescript-eslint/eslint-plugin": "^7.6.0",
+        "@typescript-eslint/parser": "^7.6.0",
+        "css-loader": "^7.1.5",
+        "eslint": "^9.0.0",
+        "eslint-config-prettier": "^10.1.8",
+        "eslint-plugin-prettier": "^5.5.6",
+        "jest": "^29.7.0",
+        "npm-run-all": "^4.1.5",
+        "prettier": "^3.9.6",
+        "rimraf": "^6.1.3",
+        "source-map-loader": "^5.0.0",
+        "style-loader": "^4.0.0",
+        "stylelint": "^17.15.0",
+        "stylelint-config-recommended": "^18.0.0",
+        "stylelint-config-standard": "^40.0.0",
+        "stylelint-csstree-validator": "^4.0.0",
+        "stylelint-prettier": "^5.0.3",
+        "typescript": "~5.9.3",
+        "yjs": "^13.6.32"
+    },
+    "sideEffects": [
+        "style/*.css",
+        "style/index.js"
+    ],
+    "styleModule": "style/index.js",
+    "publishConfig": {
+        "access": "public"
+    },
+    "jupyterlab": {
+        "extension": true,
+        "outputDir": "oceanumlab/labextension",
+        "schemaDir": "schema",
+        "webpackConfig": "./webpack.config.js"
+    },
+    "eslintIgnore": [
+        "node_modules",
+        "dist",
+        "coverage",
+        "**/*.d.ts",
+        "tests",
+        "**/__tests__",
+        "ui-tests"
+    ],
+    "prettier": {
+        "singleQuote": true,
+        "trailingComma": "none",
+        "arrowParens": "avoid",
+        "endOfLine": "auto",
+        "overrides": [
+            {
+                "files": "package.json",
+                "options": {
+                    "tabWidth": 4
+                }
+            }
+        ]
+    },
+    "stylelint": {
+        "extends": [
+            "stylelint-config-recommended",
+            "stylelint-config-standard",
+            "stylelint-prettier/recommended"
+        ],
+        "plugins": [
+            "stylelint-csstree-validator"
+        ],
+        "rules": {
+            "csstree/validator": true,
+            "custom-property-pattern": null,
+            "no-descending-specificity": null,
+            "property-no-vendor-prefix": null,
+            "selector-class-pattern": "^([a-z][A-z\\d]*)(-{1,2}[A-z\\d]+)*$",
+            "selector-no-vendor-prefix": null,
+            "value-no-vendor-prefix": null
+        }
+    }
+}

package/schema/datamesh-connect.json

@@ -0,0 +1,35 @@
+{
+  "jupyter.lab.shortcuts": [],
+  "jupyter.lab.setting-icon": "oceanum:icon",
+  "jupyter.lab.setting-icon-label": "Oceanum",
+  "title": "Oceanum.io",
+  "description": "Oceanum.io JupyterLab extension settings",
+  "type": "object",
+  "properties": {
+    "datameshToken": {
+      "type": "string",
+      "title": "Datamesh token",
+      "description": "Your Oceanum Datamesh token or JWT. Obtain at https://home.oceanum.io/account.",
+      "default": ""
+    },
+    "injectToken": {
+      "type": "boolean",
+      "title": "Inject token",
+      "description": "Inject Datamesh token into code.",
+      "default": false
+    },
+    "autoRunCode": {
+      "type": "boolean",
+      "title": "Auto-run code",
+      "description": "Run code cells the AI inserts as soon as they are placed.",
+      "default": false
+    },
+    "iterate": {
+      "type": "boolean",
+      "title": "Iterate",
+      "description": "After running, send each cell's output back to the AI so it can fix an error or take the next step. Only takes effect with Auto-run code on.",
+      "default": false
+    }
+  },
+  "additionalProperties": false
+}

package/src/DatameshUI.tsx

@@ -0,0 +1,15 @@
+import React from 'react';
+import { ReactWidget } from '@jupyterlab/apputils';
+
+declare const DATAMESH_UI_SERVICE: string;
+
+export class DatameshUI extends ReactWidget {
+  render(): React.ReactElement {
+    return (
+      <iframe
+        src={`${DATAMESH_UI_SERVICE}`}
+        className="datamesh-iframe"
+      ></iframe>
+    );
+  }
+}