@difizen/libro-kernel 0.0.2-alpha.0

package/es/session/libro-session.js

@@ -0,0 +1,19 @@
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
+var _dec, _class;
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+import { transient, inject } from '@difizen/mana-app';
+import { SessionMetaOption } from "./libro-session-protocol.js";
+export var LibroSession = (_dec = transient(), _dec(_class = /*#__PURE__*/_createClass(function LibroSession(meta) {
+  _classCallCheck(this, LibroSession);
+  this.id = meta.id;
+  this.name = meta.name;
+  this.type = meta.type;
+  this.path = meta.path;
+  this.kernel = meta.kernel;
+  this.notebook = meta.notebook;
+})) || _class);
+LibroSession = inject(SessionMetaOption)(LibroSession, undefined, 0) || LibroSession;

package/es/session/restapi.d.ts

@@ -0,0 +1,28 @@
+import type { ISettings } from '../server/index.js';
+import { ServerConnection } from '../server/server-connection.js';
+import type { ISessionOptions, SessionIModel, SessionMeta } from './libro-session-protocol.js';
+export declare const SESSION_SERVICE_URL = "api/sessions";
+export type DeepPartial<T> = {
+    [P in keyof T]?: DeepPartial<T[P]>;
+};
+/**
+ * Get a session url.
+ */
+export declare function getSessionUrl(baseUrl: string, id: string): string;
+export declare class SessionRestAPI {
+    serverConnection: ServerConnection;
+    /**
+     * Create a new session, or return an existing session if the session path
+     * already exists.
+     */
+    startSession(options: ISessionOptions, serverSettings?: Partial<ISettings>): Promise<SessionIModel>;
+    /**
+     * List the running sessions.
+     */
+    listRunning(serverSettings?: Partial<ISettings>): Promise<SessionMeta[]>;
+    /**
+     * Send a PATCH to the server, updating the session path or the kernel.
+     */
+    updateSession(model: Pick<SessionIModel, 'id'> & DeepPartial<Omit<SessionIModel, 'id'>>, serverSettings?: Partial<ISettings>): Promise<SessionIModel>;
+}
+//# sourceMappingURL=restapi.d.ts.map

package/es/session/restapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"restapi.d.ts","sourceRoot":"","sources":["../../src/session/restapi.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAEpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC;AAElE,OAAO,KAAK,EACV,eAAe,EACf,aAAa,EACb,WAAW,EACZ,MAAM,6BAA6B,CAAC;AAGrC,eAAO,MAAM,mBAAmB,iBAAiB,CAAC;AAElD,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KAC1B,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CACnC,CAAC;AAEF;;GAEG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAEjE;AAED,qBACa,cAAc;IACC,gBAAgB,EAAE,gBAAgB,CAAC;IAuB7D;;;OAGG;IACG,YAAY,CAChB,OAAO,EAAE,eAAe,EACxB,cAAc,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAClC,OAAO,CAAC,aAAa,CAAC;IAmBzB;;OAEG;IACG,WAAW,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC;IAoB9E;;OAEG;IACG,aAAa,CACjB,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,GAAG,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC,EACzE,cAAc,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,GAClC,OAAO,CAAC,aAAa,CAAC;CAiB1B"}

package/es/session/restapi.js

@@ -0,0 +1,214 @@
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
+var _dec, _dec2, _class, _class2, _descriptor;
+function _regeneratorRuntime() { "use strict"; /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/facebook/regenerator/blob/main/LICENSE */ _regeneratorRuntime = function _regeneratorRuntime() { return exports; }; var exports = {}, Op = Object.prototype, hasOwn = Op.hasOwnProperty, defineProperty = Object.defineProperty || function (obj, key, desc) { obj[key] = desc.value; }, $Symbol = "function" == typeof Symbol ? Symbol : {}, iteratorSymbol = $Symbol.iterator || "@@iterator", asyncIteratorSymbol = $Symbol.asyncIterator || "@@asyncIterator", toStringTagSymbol = $Symbol.toStringTag || "@@toStringTag"; function define(obj, key, value) { return Object.defineProperty(obj, key, { value: value, enumerable: !0, configurable: !0, writable: !0 }), obj[key]; } try { define({}, ""); } catch (err) { define = function define(obj, key, value) { return obj[key] = value; }; } function wrap(innerFn, outerFn, self, tryLocsList) { var protoGenerator = outerFn && outerFn.prototype instanceof Generator ? outerFn : Generator, generator = Object.create(protoGenerator.prototype), context = new Context(tryLocsList || []); return defineProperty(generator, "_invoke", { value: makeInvokeMethod(innerFn, self, context) }), generator; } function tryCatch(fn, obj, arg) { try { return { type: "normal", arg: fn.call(obj, arg) }; } catch (err) { return { type: "throw", arg: err }; } } exports.wrap = wrap; var ContinueSentinel = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} var IteratorPrototype = {}; define(IteratorPrototype, iteratorSymbol, function () { return this; }); var getProto = Object.getPrototypeOf, NativeIteratorPrototype = getProto && getProto(getProto(values([]))); NativeIteratorPrototype && NativeIteratorPrototype !== Op && hasOwn.call(NativeIteratorPrototype, iteratorSymbol) && (IteratorPrototype = NativeIteratorPrototype); var Gp = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(IteratorPrototype); function defineIteratorMethods(prototype) { ["next", "throw", "return"].forEach(function (method) { define(prototype, method, function (arg) { return this._invoke(method, arg); }); }); } function AsyncIterator(generator, PromiseImpl) { function invoke(method, arg, resolve, reject) { var record = tryCatch(generator[method], generator, arg); if ("throw" !== record.type) { var result = record.arg, value = result.value; return value && "object" == _typeof(value) && hasOwn.call(value, "__await") ? PromiseImpl.resolve(value.__await).then(function (value) { invoke("next", value, resolve, reject); }, function (err) { invoke("throw", err, resolve, reject); }) : PromiseImpl.resolve(value).then(function (unwrapped) { result.value = unwrapped, resolve(result); }, function (error) { return invoke("throw", error, resolve, reject); }); } reject(record.arg); } var previousPromise; defineProperty(this, "_invoke", { value: function value(method, arg) { function callInvokeWithMethodAndArg() { return new PromiseImpl(function (resolve, reject) { invoke(method, arg, resolve, reject); }); } return previousPromise = previousPromise ? previousPromise.then(callInvokeWithMethodAndArg, callInvokeWithMethodAndArg) : callInvokeWithMethodAndArg(); } }); } function makeInvokeMethod(innerFn, self, context) { var state = "suspendedStart"; return function (method, arg) { if ("executing" === state) throw new Error("Generator is already running"); if ("completed" === state) { if ("throw" === method) throw arg; return doneResult(); } for (context.method = method, context.arg = arg;;) { var delegate = context.delegate; if (delegate) { var delegateResult = maybeInvokeDelegate(delegate, context); if (delegateResult) { if (delegateResult === ContinueSentinel) continue; return delegateResult; } } if ("next" === context.method) context.sent = context._sent = context.arg;else if ("throw" === context.method) { if ("suspendedStart" === state) throw state = "completed", context.arg; context.dispatchException(context.arg); } else "return" === context.method && context.abrupt("return", context.arg); state = "executing"; var record = tryCatch(innerFn, self, context); if ("normal" === record.type) { if (state = context.done ? "completed" : "suspendedYield", record.arg === ContinueSentinel) continue; return { value: record.arg, done: context.done }; } "throw" === record.type && (state = "completed", context.method = "throw", context.arg = record.arg); } }; } function maybeInvokeDelegate(delegate, context) { var methodName = context.method, method = delegate.iterator[methodName]; if (undefined === method) return context.delegate = null, "throw" === methodName && delegate.iterator.return && (context.method = "return", context.arg = undefined, maybeInvokeDelegate(delegate, context), "throw" === context.method) || "return" !== methodName && (context.method = "throw", context.arg = new TypeError("The iterator does not provide a '" + methodName + "' method")), ContinueSentinel; var record = tryCatch(method, delegate.iterator, context.arg); if ("throw" === record.type) return context.method = "throw", context.arg = record.arg, context.delegate = null, ContinueSentinel; var info = record.arg; return info ? info.done ? (context[delegate.resultName] = info.value, context.next = delegate.nextLoc, "return" !== context.method && (context.method = "next", context.arg = undefined), context.delegate = null, ContinueSentinel) : info : (context.method = "throw", context.arg = new TypeError("iterator result is not an object"), context.delegate = null, ContinueSentinel); } function pushTryEntry(locs) { var entry = { tryLoc: locs[0] }; 1 in locs && (entry.catchLoc = locs[1]), 2 in locs && (entry.finallyLoc = locs[2], entry.afterLoc = locs[3]), this.tryEntries.push(entry); } function resetTryEntry(entry) { var record = entry.completion || {}; record.type = "normal", delete record.arg, entry.completion = record; } function Context(tryLocsList) { this.tryEntries = [{ tryLoc: "root" }], tryLocsList.forEach(pushTryEntry, this), this.reset(!0); } function values(iterable) { if (iterable) { var iteratorMethod = iterable[iteratorSymbol]; if (iteratorMethod) return iteratorMethod.call(iterable); if ("function" == typeof iterable.next) return iterable; if (!isNaN(iterable.length)) { var i = -1, next = function next() { for (; ++i < iterable.length;) if (hasOwn.call(iterable, i)) return next.value = iterable[i], next.done = !1, next; return next.value = undefined, next.done = !0, next; }; return next.next = next; } } return { next: doneResult }; } function doneResult() { return { value: undefined, done: !0 }; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, defineProperty(Gp, "constructor", { value: GeneratorFunctionPrototype, configurable: !0 }), defineProperty(GeneratorFunctionPrototype, "constructor", { value: GeneratorFunction, configurable: !0 }), GeneratorFunction.displayName = define(GeneratorFunctionPrototype, toStringTagSymbol, "GeneratorFunction"), exports.isGeneratorFunction = function (genFun) { var ctor = "function" == typeof genFun && genFun.constructor; return !!ctor && (ctor === GeneratorFunction || "GeneratorFunction" === (ctor.displayName || ctor.name)); }, exports.mark = function (genFun) { return Object.setPrototypeOf ? Object.setPrototypeOf(genFun, GeneratorFunctionPrototype) : (genFun.__proto__ = GeneratorFunctionPrototype, define(genFun, toStringTagSymbol, "GeneratorFunction")), genFun.prototype = Object.create(Gp), genFun; }, exports.awrap = function (arg) { return { __await: arg }; }, defineIteratorMethods(AsyncIterator.prototype), define(AsyncIterator.prototype, asyncIteratorSymbol, function () { return this; }), exports.AsyncIterator = AsyncIterator, exports.async = function (innerFn, outerFn, self, tryLocsList, PromiseImpl) { void 0 === PromiseImpl && (PromiseImpl = Promise); var iter = new AsyncIterator(wrap(innerFn, outerFn, self, tryLocsList), PromiseImpl); return exports.isGeneratorFunction(outerFn) ? iter : iter.next().then(function (result) { return result.done ? result.value : iter.next(); }); }, defineIteratorMethods(Gp), define(Gp, toStringTagSymbol, "Generator"), define(Gp, iteratorSymbol, function () { return this; }), define(Gp, "toString", function () { return "[object Generator]"; }), exports.keys = function (val) { var object = Object(val), keys = []; for (var key in object) keys.push(key); return keys.reverse(), function next() { for (; keys.length;) { var key = keys.pop(); if (key in object) return next.value = key, next.done = !1, next; } return next.done = !0, next; }; }, exports.values = values, Context.prototype = { constructor: Context, reset: function reset(skipTempReset) { if (this.prev = 0, this.next = 0, this.sent = this._sent = undefined, this.done = !1, this.delegate = null, this.method = "next", this.arg = undefined, this.tryEntries.forEach(resetTryEntry), !skipTempReset) for (var name in this) "t" === name.charAt(0) && hasOwn.call(this, name) && !isNaN(+name.slice(1)) && (this[name] = undefined); }, stop: function stop() { this.done = !0; var rootRecord = this.tryEntries[0].completion; if ("throw" === rootRecord.type) throw rootRecord.arg; return this.rval; }, dispatchException: function dispatchException(exception) { if (this.done) throw exception; var context = this; function handle(loc, caught) { return record.type = "throw", record.arg = exception, context.next = loc, caught && (context.method = "next", context.arg = undefined), !!caught; } for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i], record = entry.completion; if ("root" === entry.tryLoc) return handle("end"); if (entry.tryLoc <= this.prev) { var hasCatch = hasOwn.call(entry, "catchLoc"), hasFinally = hasOwn.call(entry, "finallyLoc"); if (hasCatch && hasFinally) { if (this.prev < entry.catchLoc) return handle(entry.catchLoc, !0); if (this.prev < entry.finallyLoc) return handle(entry.finallyLoc); } else if (hasCatch) { if (this.prev < entry.catchLoc) return handle(entry.catchLoc, !0); } else { if (!hasFinally) throw new Error("try statement without catch or finally"); if (this.prev < entry.finallyLoc) return handle(entry.finallyLoc); } } } }, abrupt: function abrupt(type, arg) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.tryLoc <= this.prev && hasOwn.call(entry, "finallyLoc") && this.prev < entry.finallyLoc) { var finallyEntry = entry; break; } } finallyEntry && ("break" === type || "continue" === type) && finallyEntry.tryLoc <= arg && arg <= finallyEntry.finallyLoc && (finallyEntry = null); var record = finallyEntry ? finallyEntry.completion : {}; return record.type = type, record.arg = arg, finallyEntry ? (this.method = "next", this.next = finallyEntry.finallyLoc, ContinueSentinel) : this.complete(record); }, complete: function complete(record, afterLoc) { if ("throw" === record.type) throw record.arg; return "break" === record.type || "continue" === record.type ? this.next = record.arg : "return" === record.type ? (this.rval = this.arg = record.arg, this.method = "return", this.next = "end") : "normal" === record.type && afterLoc && (this.next = afterLoc), ContinueSentinel; }, finish: function finish(finallyLoc) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.finallyLoc === finallyLoc) return this.complete(entry.completion, entry.afterLoc), resetTryEntry(entry), ContinueSentinel; } }, catch: function _catch(tryLoc) { for (var i = this.tryEntries.length - 1; i >= 0; --i) { var entry = this.tryEntries[i]; if (entry.tryLoc === tryLoc) { var record = entry.completion; if ("throw" === record.type) { var thrown = record.arg; resetTryEntry(entry); } return thrown; } } throw new Error("illegal catch attempt"); }, delegateYield: function delegateYield(iterable, resultName, nextLoc) { return this.delegate = { iterator: values(iterable), resultName: resultName, nextLoc: nextLoc }, "next" === this.method && (this.arg = undefined), ContinueSentinel; } }, exports; }
+function ownKeys(object, enumerableOnly) { var keys = Object.keys(object); if (Object.getOwnPropertySymbols) { var symbols = Object.getOwnPropertySymbols(object); enumerableOnly && (symbols = symbols.filter(function (sym) { return Object.getOwnPropertyDescriptor(object, sym).enumerable; })), keys.push.apply(keys, symbols); } return keys; }
+function _objectSpread(target) { for (var i = 1; i < arguments.length; i++) { var source = null != arguments[i] ? arguments[i] : {}; i % 2 ? ownKeys(Object(source), !0).forEach(function (key) { _defineProperty(target, key, source[key]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(target, Object.getOwnPropertyDescriptors(source)) : ownKeys(Object(source)).forEach(function (key) { Object.defineProperty(target, key, Object.getOwnPropertyDescriptor(source, key)); }); } return target; }
+function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
+function asyncGeneratorStep(gen, resolve, reject, _next, _throw, key, arg) { try { var info = gen[key](arg); var value = info.value; } catch (error) { reject(error); return; } if (info.done) { resolve(value); } else { Promise.resolve(value).then(_next, _throw); } }
+function _asyncToGenerator(fn) { return function () { var self = this, args = arguments; return new Promise(function (resolve, reject) { var gen = fn.apply(self, args); function _next(value) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "next", value); } function _throw(err) { asyncGeneratorStep(gen, resolve, reject, _next, _throw, "throw", err); } _next(undefined); }); }; }
+function _initializerDefineProperty(target, property, descriptor, context) { if (!descriptor) return; Object.defineProperty(target, property, { enumerable: descriptor.enumerable, configurable: descriptor.configurable, writable: descriptor.writable, value: descriptor.initializer ? descriptor.initializer.call(context) : void 0 }); }
+function _classCallCheck(instance, Constructor) { if (!(instance instanceof Constructor)) { throw new TypeError("Cannot call a class as a function"); } }
+function _defineProperties(target, props) { for (var i = 0; i < props.length; i++) { var descriptor = props[i]; descriptor.enumerable = descriptor.enumerable || false; descriptor.configurable = true; if ("value" in descriptor) descriptor.writable = true; Object.defineProperty(target, _toPropertyKey(descriptor.key), descriptor); } }
+function _createClass(Constructor, protoProps, staticProps) { if (protoProps) _defineProperties(Constructor.prototype, protoProps); if (staticProps) _defineProperties(Constructor, staticProps); Object.defineProperty(Constructor, "prototype", { writable: false }); return Constructor; }
+function _toPropertyKey(arg) { var key = _toPrimitive(arg, "string"); return _typeof(key) === "symbol" ? key : String(key); }
+function _toPrimitive(input, hint) { if (_typeof(input) !== "object" || input === null) return input; var prim = input[Symbol.toPrimitive]; if (prim !== undefined) { var res = prim.call(input, hint || "default"); if (_typeof(res) !== "object") return res; throw new TypeError("@@toPrimitive must return a primitive value."); } return (hint === "string" ? String : Number)(input); }
+function _applyDecoratedDescriptor(target, property, decorators, descriptor, context) { var desc = {}; Object.keys(descriptor).forEach(function (key) { desc[key] = descriptor[key]; }); desc.enumerable = !!desc.enumerable; desc.configurable = !!desc.configurable; if ('value' in desc || desc.initializer) { desc.writable = true; } desc = decorators.slice().reverse().reduce(function (desc, decorator) { return decorator(target, property, desc) || desc; }, desc); if (context && desc.initializer !== void 0) { desc.value = desc.initializer ? desc.initializer.call(context) : void 0; desc.initializer = undefined; } if (desc.initializer === void 0) { Object.defineProperty(target, property, desc); desc = null; } return desc; }
+function _initializerWarningHelper(descriptor, context) { throw new Error('Decorating class property failed. Please ensure that ' + 'transform-class-properties is enabled and runs after the decorators transform.'); }
+// import { default as axios } from 'axios';
+import { URL } from '@difizen/libro-common';
+import { inject, singleton } from '@difizen/mana-app';
+import { createResponseError } from "../server/index.js";
+import { ServerConnection } from "../server/server-connection.js";
+import { updateLegacySessionModel, validateModel } from "./validate.js";
+export var SESSION_SERVICE_URL = 'api/sessions';
+/**
+ * Get a session url.
+ */
+export function getSessionUrl(baseUrl, id) {
+  return URL.join(baseUrl, SESSION_SERVICE_URL, id);
+}
+export var SessionRestAPI = (_dec = singleton(), _dec2 = inject(ServerConnection), _dec(_class = (_class2 = /*#__PURE__*/function () {
+  function SessionRestAPI() {
+    _classCallCheck(this, SessionRestAPI);
+    _initializerDefineProperty(this, "serverConnection", _descriptor, this);
+  }
+  _createClass(SessionRestAPI, [{
+    key: "startSession",
+    value: // async startNewSession(params: {
+    //   fileName: string;
+    //   kernelName: string;
+    //   path: string;
+    //   type: string;
+    // }) {
+    //   try {
+    //     const res = await axios.post(`/api/sessions`, {
+    //       kernel: { name: params.kernelName }, // 来源于当前文件选择了哪一个kernel，名称来自于kernelspecs
+    //       name: params.fileName,
+    //       path: params.path,
+    //       type: params.type,
+    //     });
+    //     if (res.status === 201 && res.data) {
+    //       return res.data;
+    //     }
+    //   } catch (ex) {
+    //     return undefined;
+    //   }
+    // }
+    /**
+     * Create a new session, or return an existing session if the session path
+     * already exists.
+     */
+    function () {
+      var _startSession = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee(options, serverSettings) {
+        var settings, url, init, response, err, data;
+        return _regeneratorRuntime().wrap(function _callee$(_context) {
+          while (1) switch (_context.prev = _context.next) {
+            case 0:
+              settings = _objectSpread(_objectSpread({}, this.serverConnection.settings), serverSettings);
+              url = URL.join(settings.baseUrl, SESSION_SERVICE_URL);
+              init = {
+                method: 'POST',
+                body: JSON.stringify(options)
+              };
+              _context.next = 5;
+              return this.serverConnection.makeRequest(url, init, settings);
+            case 5:
+              response = _context.sent;
+              if (!(response.status !== 201)) {
+                _context.next = 11;
+                break;
+              }
+              _context.next = 9;
+              return createResponseError(response);
+            case 9:
+              err = _context.sent;
+              throw err;
+            case 11:
+              _context.next = 13;
+              return response.json();
+            case 13:
+              data = _context.sent;
+              updateLegacySessionModel(data);
+              validateModel(data);
+              return _context.abrupt("return", data);
+            case 17:
+            case "end":
+              return _context.stop();
+          }
+        }, _callee, this);
+      }));
+      function startSession(_x, _x2) {
+        return _startSession.apply(this, arguments);
+      }
+      return startSession;
+    }()
+    /**
+     * List the running sessions.
+     */
+  }, {
+    key: "listRunning",
+    value: function () {
+      var _listRunning = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee2(serverSettings) {
+        var settings, url, response, err, data;
+        return _regeneratorRuntime().wrap(function _callee2$(_context2) {
+          while (1) switch (_context2.prev = _context2.next) {
+            case 0:
+              settings = _objectSpread(_objectSpread({}, this.serverConnection.settings), serverSettings);
+              url = URL.join(settings.baseUrl, SESSION_SERVICE_URL);
+              _context2.next = 4;
+              return this.serverConnection.makeRequest(url, {}, settings);
+            case 4:
+              response = _context2.sent;
+              if (!(response.status !== 200)) {
+                _context2.next = 10;
+                break;
+              }
+              _context2.next = 8;
+              return createResponseError(response);
+            case 8:
+              err = _context2.sent;
+              throw err;
+            case 10:
+              _context2.next = 12;
+              return response.json();
+            case 12:
+              data = _context2.sent;
+              if (Array.isArray(data)) {
+                _context2.next = 15;
+                break;
+              }
+              throw new Error('Invalid Session list');
+            case 15:
+              data.forEach(function (m) {
+                updateLegacySessionModel(m);
+                validateModel(m);
+              });
+              return _context2.abrupt("return", data);
+            case 17:
+            case "end":
+              return _context2.stop();
+          }
+        }, _callee2, this);
+      }));
+      function listRunning(_x3) {
+        return _listRunning.apply(this, arguments);
+      }
+      return listRunning;
+    }()
+    /**
+     * Send a PATCH to the server, updating the session path or the kernel.
+     */
+  }, {
+    key: "updateSession",
+    value: function () {
+      var _updateSession = _asyncToGenerator( /*#__PURE__*/_regeneratorRuntime().mark(function _callee3(model, serverSettings) {
+        var settings, url, init, response, err, data;
+        return _regeneratorRuntime().wrap(function _callee3$(_context3) {
+          while (1) switch (_context3.prev = _context3.next) {
+            case 0:
+              settings = _objectSpread(_objectSpread({}, this.serverConnection.settings), serverSettings);
+              url = getSessionUrl(settings.baseUrl, model.id);
+              init = {
+                method: 'PATCH',
+                body: JSON.stringify(model)
+              };
+              _context3.next = 5;
+              return this.serverConnection.makeRequest(url, init, settings);
+            case 5:
+              response = _context3.sent;
+              if (!(response.status !== 200)) {
+                _context3.next = 11;
+                break;
+              }
+              _context3.next = 9;
+              return createResponseError(response);
+            case 9:
+              err = _context3.sent;
+              throw err;
+            case 11:
+              _context3.next = 13;
+              return response.json();
+            case 13:
+              data = _context3.sent;
+              updateLegacySessionModel(data);
+              validateModel(data);
+              return _context3.abrupt("return", data);
+            case 17:
+            case "end":
+              return _context3.stop();
+          }
+        }, _callee3, this);
+      }));
+      function updateSession(_x4, _x5) {
+        return _updateSession.apply(this, arguments);
+      }
+      return updateSession;
+    }()
+  }]);
+  return SessionRestAPI;
+}(), (_descriptor = _applyDecoratedDescriptor(_class2.prototype, "serverConnection", [_dec2], {
+  configurable: true,
+  enumerable: true,
+  writable: true,
+  initializer: null
+})), _class2)) || _class);

package/es/session/session-module.d.ts

@@ -0,0 +1,3 @@
+import { ManaModule } from '@difizen/mana-app';
+export declare const LibroSessionModule: ManaModule;
+//# sourceMappingURL=session-module.d.ts.map

package/es/session/session-module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-module.d.ts","sourceRoot":"","sources":["../../src/session/session-module.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAQ/C,eAAO,MAAM,kBAAkB,YAiB9B,CAAC"}

package/es/session/session-module.js

@@ -0,0 +1,18 @@
+import { ManaModule } from '@difizen/mana-app';
+import { LibroSessionManager } from "./libro-session-manager.js";
+import { LibroSessionFactory, SessionMetaOption } from "./libro-session-protocol.js";
+import { LibroSession } from "./libro-session.js";
+import { SessionRestAPI } from "./restapi.js";
+export var LibroSessionModule = ManaModule.create().register(SessionRestAPI, LibroSession, LibroSessionManager, {
+  token: LibroSessionFactory,
+  useFactory: function useFactory(ctx) {
+    return function (sessionMeta) {
+      var child = ctx.container.createChild();
+      child.register({
+        token: SessionMetaOption,
+        useValue: sessionMeta
+      });
+      return child.get(LibroSession);
+    };
+  }
+});

package/es/session/validate.d.ts

@@ -0,0 +1,14 @@
+import type { SessionMeta } from './libro-session-protocol.js';
+/**
+ * Validate an `Session.IModel` object.
+ */
+export declare function validateModel(data: any): asserts data is SessionMeta;
+/**
+ * Update model from legacy session data.
+ */
+export declare function updateLegacySessionModel(data: any): void;
+/**
+ * Validate an array of `Session.IModel` objects.
+ */
+export declare function validateModels(models: SessionMeta[]): asserts models is SessionMeta[];
+//# sourceMappingURL=validate.d.ts.map

package/es/session/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../src/session/validate.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAE/D;;GAEG;AAEH,wBAAgB,aAAa,CAAC,IAAI,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,IAAI,WAAW,CAOpE;AAED;;GAEG;AAEH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI,CAMxD;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,MAAM,IAAI,WAAW,EAAE,CAKrF"}

package/es/session/validate.js

@@ -0,0 +1,37 @@
+import { validateModel as validateKernelModel } from "../kernel/validate.js";
+import { validateProperty } from "../validate-property.js";
+/**
+ * Validate an `Session.IModel` object.
+ */ // eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
+export function validateModel(data) {
+  validateProperty(data, 'id', 'string');
+  validateProperty(data, 'type', 'string');
+  validateProperty(data, 'name', 'string');
+  validateProperty(data, 'path', 'string');
+  validateProperty(data, 'kernel', 'object');
+  validateKernelModel(data.kernel);
+}
+
+/**
+ * Update model from legacy session data.
+ */
+// eslint-disable-next-line @typescript-eslint/explicit-module-boundary-types
+export function updateLegacySessionModel(data) {
+  if (data.path === undefined && data.notebook !== undefined) {
+    data.path = data.notebook.path;
+    data.type = 'notebook';
+    data.name = '';
+  }
+}
+
+/**
+ * Validate an array of `Session.IModel` objects.
+ */
+export function validateModels(models) {
+  if (!Array.isArray(models)) {
+    throw new Error('Invalid session list');
+  }
+  models.forEach(function (d) {
+    return validateModel(d);
+  });
+}

package/es/utils.d.ts

@@ -0,0 +1,4 @@
+export declare const getPersist: (key?: string, needParse?: boolean, defaultVal?: string | undefined) => any;
+export declare const setPersist: (key?: string, val?: string) => void;
+export declare const removePersist: (key?: string) => void;
+//# sourceMappingURL=utils.d.ts.map

package/es/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,UAAU,mDAGT,MAAM,GAAG,SAAS,QAc/B,CAAC;AAGF,eAAO,MAAM,UAAU,sCAEtB,CAAC;AAEF,eAAO,MAAM,aAAa,wBAEzB,CAAC"}

package/es/utils.js

@@ -0,0 +1,29 @@
+// 从localstorage获取值
+export var getPersist = function getPersist() {
+  var key = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : '';
+  var needParse = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
+  var defaultVal = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : undefined;
+  var jsonStr = window.localStorage.getItem(key) || defaultVal;
+  if (!needParse) {
+    return jsonStr;
+  }
+  try {
+    if (!jsonStr) {
+      return defaultVal;
+    }
+    return JSON.parse(jsonStr);
+  } catch (ex) {
+    return defaultVal;
+  }
+};
+
+// 向localstorage更新值
+export var setPersist = function setPersist() {
+  var key = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : '';
+  var val = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : '';
+  window.localStorage.setItem(key, val);
+};
+export var removePersist = function removePersist() {
+  var key = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : '';
+  window.localStorage.removeItem(key);
+};

package/es/validate-property.d.ts

@@ -0,0 +1,2 @@
+export declare function validateProperty(object: any, name: string, typeName?: string, values?: any[]): void;
+//# sourceMappingURL=validate-property.d.ts.map

package/es/validate-property.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-property.d.ts","sourceRoot":"","sources":["../src/validate-property.ts"],"names":[],"mappings":"AAAA,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,GAAG,EACX,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,EACjB,MAAM,GAAE,GAAG,EAAO,GACjB,IAAI,CAgCN"}

package/es/validate-property.js

@@ -0,0 +1,35 @@
+function _typeof(obj) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (obj) { return typeof obj; } : function (obj) { return obj && "function" == typeof Symbol && obj.constructor === Symbol && obj !== Symbol.prototype ? "symbol" : typeof obj; }, _typeof(obj); }
+export function validateProperty(object, name, typeName) {
+  var values = arguments.length > 3 && arguments[3] !== undefined ? arguments[3] : [];
+  // eslint-disable-next-line no-prototype-builtins
+  if (!object.hasOwnProperty(name)) {
+    throw new Error("Missing property '".concat(name));
+  }
+  var value = object[name];
+  if (typeName !== void 0) {
+    var valid = true;
+    if (typeName === 'array') {
+      valid = Array.isArray(value);
+    } else if (typeName === 'object') {
+      valid = typeof value !== 'undefined';
+    } else {
+      valid = _typeof(value) === typeName;
+    }
+    if (!valid) {
+      throw new Error("Property '".concat(name, "' is not of type '").concat(typeName, "'"));
+    }
+    if (values.length > 0) {
+      var isValid = true;
+      if (['string', 'number', 'boolean'].includes(typeName)) {
+        isValid = values.includes(value);
+      } else {
+        isValid = values.findIndex(function (v) {
+          return v === value;
+        }) >= 0;
+      }
+      if (!isValid) {
+        throw new Error("Property '".concat(name, "' is not one of the valid values ").concat(JSON.stringify(values)));
+      }
+    }
+  }
+}

package/package.json

@@ -0,0 +1,62 @@
+{
+  "name": "@difizen/libro-kernel",
+  "version": "0.0.2-alpha.0",
+  "description": "",
+  "keywords": [
+    "ai-infra",
+    "ai-infra-fe"
+  ],
+  "repository": "git@github.com:difizen/libro.git",
+  "license": "MIT",
+  "type": "module",
+  "exports": {
+    ".": {
+      "typings": "./es/index.d.ts",
+      "default": "./es/index.js"
+    },
+    "./mock": {
+      "typings": "./es/mock/index.d.ts",
+      "default": "./es/mock/index.js"
+    },
+    "./es/mock": {
+      "typings": "./es/mock/index.d.ts",
+      "default": "./es/mock/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "main": "es/index.js",
+  "module": "es/index.js",
+  "typings": "es/index.d.ts",
+  "files": [
+    "es",
+    "src"
+  ],
+  "dependencies": {
+    "@difizen/libro-common": "^0.0.2-alpha.0",
+    "@difizen/libro-core": "^0.0.2-alpha.0",
+    "@difizen/mana-app": "alpha",
+    "minimist": "^1.2.8",
+    "query-string": "^8.1.0",
+    "uuid": "^9.0.0"
+  },
+  "peerDependencies": {
+    "react": "^18.2.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.2.25",
+    "@types/uuid": "^9.0.5"
+  },
+  "scripts": {
+    "setup": "father build",
+    "build": "father build",
+    "test": ": Note: lint task is delegated to test:* scripts",
+    "test:vitest": "vitest run",
+    "test:jest": "jest",
+    "coverage": ": Note: lint task is delegated to coverage:* scripts",
+    "coverage:vitest": "vitest run --coverage",
+    "coverage:jest": "jest --coverage",
+    "lint": ": Note: lint task is delegated to lint:* scripts",
+    "lint:eslint": "eslint src",
+    "lint:tsc": "tsc --noEmit"
+  }
+}

package/src/basemanager.ts

@@ -0,0 +1,133 @@
+import type { Disposable, Event as ManaEvent } from '@difizen/mana-app';
+import { Emitter } from '@difizen/mana-app';
+import { singleton } from '@difizen/mana-app';
+
+import type { ISettings, NetworkError } from './server/index.js';
+/**
+ * A disposable object with an observable `disposed` signal.
+ */
+export interface ObservableDisposable extends Disposable {
+  /**
+   * A signal emitted when the object is disposed.
+   */
+  readonly onDisposed: ManaEvent<void>;
+}
+
+/**
+ * Object which manages kernel instances for a given base url.
+ *
+ * #### Notes
+ * The manager is responsible for maintaining the state of kernel specs.
+ */
+export interface IManager extends ObservableDisposable {
+  /**
+   * A signal emitted when there is a connection failure.
+   */
+  connectionFailure: ManaEvent<NetworkError>;
+
+  /**
+   * The server settings for the manager.
+   */
+  readonly serverSettings: ISettings;
+
+  /**
+   * Whether the manager is ready.
+   */
+  readonly isReady: boolean;
+
+  /**
+   * A promise that resolves when the manager is initially ready.
+   */
+  readonly ready: Promise<void>;
+
+  /**
+   * Whether the manager is active.
+   */
+  readonly isActive: boolean;
+}
+
+@singleton()
+export class BaseManager implements IManager {
+  // constructor(options: BaseManager.IOptions) {
+  //   this.serverSettings = options.serverSettings ?? ServerConnection.makeSettings();
+  // }
+  /**
+   * A signal emitted when the delegate is disposed.
+   */
+  get onDisposed(): ManaEvent<void> {
+    return this.onDisposedEmitter.event;
+  }
+
+  /**
+   * A signal emitted when there is a connection failure.
+   */
+  get connectionFailure(): ManaEvent<Error> {
+    return this.connectionFailureEmitter.event;
+  }
+
+  /**
+   * Test whether the delegate has been disposed.
+   */
+  get isDisposed(): boolean {
+    return this._isDisposed;
+  }
+
+  /**
+   * Test whether the manager is ready.
+   */
+  get isReady(): boolean {
+    return this._isReady;
+  }
+
+  /**
+   * A promise that fulfills when the manager is ready.
+   */
+  get ready(): Promise<void> {
+    return this._ready;
+  }
+
+  /**
+   * Whether the manager is active.
+   */
+  get isActive(): boolean {
+    return true;
+  }
+
+  /**
+   * Dispose of the delegate and invoke the callback function.
+   */
+  dispose(): void {
+    if (this.isDisposed) {
+      return;
+    }
+    this.onDisposedEmitter.fire(undefined);
+    this.onDisposedEmitter.dispose();
+  }
+
+  /**
+   * The server settings of the manager.
+   */
+  readonly serverSettings: ISettings;
+
+  protected _isDisposed = false;
+  protected onDisposedEmitter = new Emitter<void>();
+
+  protected connectionFailureEmitter = new Emitter<Error>();
+  _isReady = false;
+  _ready: Promise<void>;
+}
+
+/**
+ * The namespace for `BaseManager` class statics.
+ */
+export namespace BaseManager {
+  /**
+   * The options used to initialize a SessionManager.
+   */
+  export interface IOptions {
+    /**
+     * The server settings for the manager.
+     */
+    serverSettings?: ISettings;
+  }
+}