@runtimed/node 0.2.5 → 0.3.0

package/README.md

@@ -87,21 +87,28 @@ sessions.
 - `Session.listCells()` and `Session.getCell(cellId)` inspect notebook cells.
 - `Session.createCell(source, options)`, `Session.setCell(cellId, options)`,
   `Session.deleteCell(cellId)`, and `Session.moveCell(cellId, options)` provide
-  direct notebook editing without MCP JSON round-trips.
+  direct notebook editing without MCP JSON round-trips. `createCell()` appends
+  by default; pass `index: 0` to prepend or `afterCellId` to insert after
+  another cell.
 - `Session.executeCell(cellId, options)` runs an existing code cell.
 - `Session.showNotebook()` opens the session in nteract Desktop when a display
   is available.
 - `Session.interruptKernel()`, `Session.shutdownKernel()`, and
   `Session.restartKernel()` manage the running kernel.
 - `Session.shutdownNotebook()` shuts down this notebook room and closes the session.
-- `Session.runCell(source, options)` creates, runs, and waits for a cell.
-- `Session.queueCell(source, options)` queues a cell and returns IDs.
+- `Session.runCell(source, options)` appends, runs, and waits for a cell.
+- `Session.queueCell(source, options)` appends a cell, queues it, and returns IDs.
 - `Session.waitForExecution(executionId, options)` waits for queued work.
   Pass `onUpdate(progress)` to receive resolved output snapshots while the
   execution is still running.
 - `Session.runtimeState$`, `Session.executionTransitions$`,
-  `Session.cellChanges$`, `Session.broadcasts$`, and `Session.sessionStatus$`
-  expose the same projected event families used by the browser sync engine.
+  `Session.executionViewChanges$`, `Session.cellChanges$`, `Session.broadcasts$`,
+  and `Session.sessionStatus$` expose the same projected event families used by
+  the browser sync engine.
+- `Session.getExecutionView()` returns the current materialized execution view:
+  non-null notebook cell pointers, execution snapshots keyed by `execution_id`,
+  and the execution-ID-first queue projection. Use this for status surfaces;
+  use `executionViewChanges$` when you need every pointer-clear transition.
 - `Session.addDependency(spec, { packageManager })` /
   `Session.addDependencies(specs, { packageManager })` and
   `Session.removeDependency(spec, { packageManager })` /

package/package.json

@@ -1,17 +1,17 @@
 {
   "name": "@runtimed/node",
-  "version": "0.2.5",
+  "version": "0.3.0",
   "description": "Node.js bindings for controlling nteract runtimed notebooks and Python kernels.",
   "type": "module",
   "license": "BSD-3-Clause",
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/nteract/desktop.git",
+    "url": "git+https://github.com/nteract/nteract.git",
     "directory": "packages/runtimed-node"
   },
-  "homepage": "https://github.com/nteract/desktop/tree/main/packages/runtimed-node#readme",
+  "homepage": "https://github.com/nteract/nteract/tree/main/packages/runtimed-node#readme",
   "bugs": {
-    "url": "https://github.com/nteract/desktop/issues"
+    "url": "https://github.com/nteract/nteract/issues"
   },
   "keywords": [
     "nteract",
@@ -52,9 +52,9 @@
     "rxjs": "^7.8.2"
   },
   "optionalDependencies": {
-    "@runtimed/node-darwin-arm64": "0.2.5",
-    "@runtimed/node-win32-x64-msvc": "0.2.5",
-    "@runtimed/node-linux-x64-gnu": "0.2.5"
+    "@runtimed/node-darwin-arm64": "0.3.0",
+    "@runtimed/node-win32-x64-msvc": "0.3.0",
+    "@runtimed/node-linux-x64-gnu": "0.3.0"
   },
   "publishConfig": {
     "access": "public"

package/src/binding.cjs

@@ -77,8 +77,8 @@ function requireNative() {
       try {
         const binding = require('@runtimed/node-android-arm64')
         const bindingPackageVersion = require('@runtimed/node-android-arm64/package.json').version
-        if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -93,8 +93,8 @@ function requireNative() {
       try {
         const binding = require('@runtimed/node-android-arm-eabi')
         const bindingPackageVersion = require('@runtimed/node-android-arm-eabi/package.json').version
-        if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -114,8 +114,8 @@ function requireNative() {
       try {
         const binding = require('@runtimed/node-win32-x64-gnu')
         const bindingPackageVersion = require('@runtimed/node-win32-x64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -130,8 +130,8 @@ function requireNative() {
       try {
         const binding = require('@runtimed/node-win32-x64-msvc')
         const bindingPackageVersion = require('@runtimed/node-win32-x64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -147,8 +147,8 @@ function requireNative() {
       try {
         const binding = require('@runtimed/node-win32-ia32-msvc')
         const bindingPackageVersion = require('@runtimed/node-win32-ia32-msvc/package.json').version
-        if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -163,8 +163,8 @@ function requireNative() {
       try {
         const binding = require('@runtimed/node-win32-arm64-msvc')
         const bindingPackageVersion = require('@runtimed/node-win32-arm64-msvc/package.json').version
-        if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -182,8 +182,8 @@ function requireNative() {
     try {
       const binding = require('@runtimed/node-darwin-universal')
       const bindingPackageVersion = require('@runtimed/node-darwin-universal/package.json').version
-      if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-        throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+        throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
       }
       return binding
     } catch (e) {
@@ -198,8 +198,8 @@ function requireNative() {
       try {
         const binding = require('@runtimed/node-darwin-x64')
         const bindingPackageVersion = require('@runtimed/node-darwin-x64/package.json').version
-        if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -214,8 +214,8 @@ function requireNative() {
       try {
         const binding = require('@runtimed/node-darwin-arm64')
         const bindingPackageVersion = require('@runtimed/node-darwin-arm64/package.json').version
-        if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -234,8 +234,8 @@ function requireNative() {
       try {
         const binding = require('@runtimed/node-freebsd-x64')
         const bindingPackageVersion = require('@runtimed/node-freebsd-x64/package.json').version
-        if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -250,8 +250,8 @@ function requireNative() {
       try {
         const binding = require('@runtimed/node-freebsd-arm64')
         const bindingPackageVersion = require('@runtimed/node-freebsd-arm64/package.json').version
-        if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -271,8 +271,8 @@ function requireNative() {
         try {
           const binding = require('@runtimed/node-linux-x64-musl')
           const bindingPackageVersion = require('@runtimed/node-linux-x64-musl/package.json').version
-          if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -287,8 +287,8 @@ function requireNative() {
         try {
           const binding = require('@runtimed/node-linux-x64-gnu')
           const bindingPackageVersion = require('@runtimed/node-linux-x64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -305,8 +305,8 @@ function requireNative() {
         try {
           const binding = require('@runtimed/node-linux-arm64-musl')
           const bindingPackageVersion = require('@runtimed/node-linux-arm64-musl/package.json').version
-          if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -321,8 +321,8 @@ function requireNative() {
         try {
           const binding = require('@runtimed/node-linux-arm64-gnu')
           const bindingPackageVersion = require('@runtimed/node-linux-arm64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -339,8 +339,8 @@ function requireNative() {
         try {
           const binding = require('@runtimed/node-linux-arm-musleabihf')
           const bindingPackageVersion = require('@runtimed/node-linux-arm-musleabihf/package.json').version
-          if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -355,8 +355,8 @@ function requireNative() {
         try {
           const binding = require('@runtimed/node-linux-arm-gnueabihf')
           const bindingPackageVersion = require('@runtimed/node-linux-arm-gnueabihf/package.json').version
-          if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -373,8 +373,8 @@ function requireNative() {
         try {
           const binding = require('@runtimed/node-linux-loong64-musl')
           const bindingPackageVersion = require('@runtimed/node-linux-loong64-musl/package.json').version
-          if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -389,8 +389,8 @@ function requireNative() {
         try {
           const binding = require('@runtimed/node-linux-loong64-gnu')
           const bindingPackageVersion = require('@runtimed/node-linux-loong64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -407,8 +407,8 @@ function requireNative() {
         try {
           const binding = require('@runtimed/node-linux-riscv64-musl')
           const bindingPackageVersion = require('@runtimed/node-linux-riscv64-musl/package.json').version
-          if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -423,8 +423,8 @@ function requireNative() {
         try {
           const binding = require('@runtimed/node-linux-riscv64-gnu')
           const bindingPackageVersion = require('@runtimed/node-linux-riscv64-gnu/package.json').version
-          if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-            throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+            throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
           }
           return binding
         } catch (e) {
@@ -440,8 +440,8 @@ function requireNative() {
       try {
         const binding = require('@runtimed/node-linux-ppc64-gnu')
         const bindingPackageVersion = require('@runtimed/node-linux-ppc64-gnu/package.json').version
-        if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -456,8 +456,8 @@ function requireNative() {
       try {
         const binding = require('@runtimed/node-linux-s390x-gnu')
         const bindingPackageVersion = require('@runtimed/node-linux-s390x-gnu/package.json').version
-        if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -476,8 +476,8 @@ function requireNative() {
       try {
         const binding = require('@runtimed/node-openharmony-arm64')
         const bindingPackageVersion = require('@runtimed/node-openharmony-arm64/package.json').version
-        if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -492,8 +492,8 @@ function requireNative() {
       try {
         const binding = require('@runtimed/node-openharmony-x64')
         const bindingPackageVersion = require('@runtimed/node-openharmony-x64/package.json').version
-        if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -508,8 +508,8 @@ function requireNative() {
       try {
         const binding = require('@runtimed/node-openharmony-arm')
         const bindingPackageVersion = require('@runtimed/node-openharmony-arm/package.json').version
-        if (bindingPackageVersion !== '0.2.5' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
-          throw new Error(`Native binding package version mismatch, expected 0.2.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.3.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
+          throw new Error(`Native binding package version mismatch, expected 0.3.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {

package/src/binding.d.ts

@@ -14,6 +14,8 @@ export declare class Session {
   onRuntimeState(callback: (arg0: string) => void): EventSubscription
   /** Subscribe to execution lifecycle transitions. Callback receives a JSON string. */
   onExecutionTransition(callback: (arg0: string) => void): EventSubscription
+  /** Subscribe to shared execution-view changes. Callback receives a JSON string. */
+  onExecutionViewChange(callback: (arg0: string) => void): EventSubscription
   /**
    * Subscribe to resolved progress snapshots for one execution.
    *
@@ -39,6 +41,14 @@ export declare class Session {
    * (creating the file if needed). Otherwise saves to the original location.
    */
   saveNotebook(path?: string | undefined | null): Promise<void>
+  /**
+   * Export the live synced notebook and runtime-state documents.
+   *
+   * This waits for both document channels to converge with the daemon
+   * before serializing, so hosted publish clients can upload a coherent
+   * `NotebookDoc` + `RuntimeStateDoc` snapshot pair.
+   */
+  exportSnapshotPair(): Promise<SnapshotPair>
   /** Close the session and release the underlying connection. */
   close(): Promise<void>
   /**
@@ -160,8 +170,13 @@ export interface CondaDependencyStatus {
 export interface CreateCellOptions {
   /** Cell source type: `"code"` (default), `"markdown"`, or `"raw"`. */
   cellType?: string
-  /** Insert after this cell, or omit to insert at the beginning. */
+  /** Insert after this cell, or omit to append at the end. */
   afterCellId?: string
+  /**
+   * Position to insert at. Omit to append; 0 prepends; out-of-range appends.
+   * Cannot be combined with `afterCellId`.
+   */
+  index?: number
 }
 
 /** Create a new (ephemeral) notebook against the daemon. */
@@ -433,6 +448,17 @@ export interface ShutdownNotebookOptions {
   socketPath?: string
 }
 
+/** Serialized notebook + runtime-state snapshots for hosted publishing. */
+export interface SnapshotPair {
+  notebookId: string
+  notebookBytes: Buffer
+  runtimeStateBytes: Buffer
+  notebookHeads: Array<string>
+  runtimeStateHeads: Array<string>
+  blobBaseUrl?: string
+  blobStorePath?: string
+}
+
 /**
  * Return the daemon socket path for a specific channel ("stable" or
  * "nightly"). Ignores `RUNTIMED_SOCKET_PATH`.

package/src/index.d.ts

@@ -17,11 +17,46 @@ export interface SessionStatus {
 
 export interface ExecutionTransition {
   execution_id: string;
-  cell_id: string;
   kind: "started" | "done" | "error";
   execution_count: number | null;
 }
 
+export interface ExecutionViewSnapshot {
+  execution_count: number | null;
+  status: "queued" | "running" | "done" | "error" | (string & {});
+  success: boolean | null;
+  output_ids: string[];
+  submitted_by_actor_label?: string | null;
+}
+
+export interface ExecutionQueueProjection {
+  executing_execution_id?: string | null;
+  queued_execution_ids: string[];
+  notebook?: {
+    executing_cell_id?: string | null;
+    queued_cell_ids: string[];
+  } | null;
+}
+
+export interface ExecutionViewChangeset {
+  cell_pointer_changes?: Array<[cell_id: string, execution_id: string | null]>;
+  execution_upserts?: Array<[execution_id: string, snapshot: ExecutionViewSnapshot]>;
+  removed_execution_ids?: string[];
+  queue?: ExecutionQueueProjection;
+}
+
+export interface ExecutionView {
+  /**
+   * Current non-null NotebookDoc cell -> execution_id pointers.
+   *
+   * Cleared or deleted cells are omitted. Subscribe to `executionViewChanges$`
+   * when null pointer transitions matter.
+   */
+  cell_execution_ids: Record<string, string>;
+  executions: Record<string, ExecutionViewSnapshot>;
+  queue: ExecutionQueueProjection | null;
+}
+
 export type RuntimeState = Record<string, unknown>;
 
 export type RuntimeKind = "python" | "deno" | (string & {});
@@ -114,6 +149,16 @@ export interface CellResult {
   outputs: JsOutput[];
 }
 
+export interface SnapshotPair {
+  notebookId: string;
+  notebookBytes: Uint8Array;
+  runtimeStateBytes: Uint8Array;
+  notebookHeads: string[];
+  runtimeStateHeads: string[];
+  blobBaseUrl?: string | null;
+  blobStorePath?: string | null;
+}
+
 export interface EventSubscription {
   dispose(): void;
 }
@@ -129,7 +174,12 @@ export interface CellSnapshot {
 
 export interface CreateCellOptions {
   cellType?: "code" | "markdown" | "raw";
-  afterCellId?: string | null;
+  /** Omit to append at the end. 0 prepends; out-of-range values append. */
+  index?: number;
+  /**
+   * Insert after this cell. Cannot be combined with index.
+   */
+  afterCellId?: string;
 }
 
 export interface SetCellOptions {
@@ -174,6 +224,7 @@ export class Session {
   readonly notebookId: string;
   readonly runtimeState$: Observable<RuntimeState>;
   readonly executionTransitions$: Observable<ExecutionTransition>;
+  readonly executionViewChanges$: Observable<ExecutionViewChangeset>;
   readonly cellChanges$: Observable<null>;
   readonly broadcasts$: Observable<unknown>;
   readonly sessionStatus$: Observable<SessionStatus>;
@@ -182,6 +233,7 @@ export class Session {
   waitForExecution(executionId: string, options?: WaitExecutionOptions): Promise<CellResult>;
   runCell(source: string, options?: RunCellOptions): Promise<CellResult>;
   saveNotebook(path?: string): Promise<void>;
+  exportSnapshotPair(): Promise<SnapshotPair>;
   listCells(): Promise<CellSnapshot[]>;
   getCell(cellId: string): Promise<CellSnapshot | null>;
   createCell(source: string, options?: CreateCellOptions): Promise<string>;
@@ -200,6 +252,7 @@ export class Session {
   removeDependencies(packages: string[], options?: DependencyEditOptions): Promise<number>;
   getDependencyStatus(): Promise<DependencyStatus>;
   getRuntimeStatus(): Promise<RuntimeStatus>;
+  getExecutionView(): ExecutionView;
   dependencyFingerprint(): Promise<string | null>;
   approveTrust(observedHeads?: string[]): Promise<void>;
   syncEnvironment(): Promise<void>;

package/src/session.cjs

@@ -7,13 +7,16 @@ class Session {
   constructor(nativeSession) {
     this._native = nativeSession;
     this._subscriptions = [];
+    this._executionView = emptyExecutionView();
     this._runtimeStateSubject = new Subject();
     this._executionTransitionsSubject = new Subject();
+    this._executionViewChangesSubject = new Subject();
     this._cellChangesSubject = new Subject();
     this._broadcastsSubject = new Subject();
     this._sessionStatusSubject = new Subject();
     this.runtimeState$ = this._runtimeStateSubject.asObservable();
     this.executionTransitions$ = this._executionTransitionsSubject.asObservable();
+    this.executionViewChanges$ = this._executionViewChangesSubject.asObservable();
     this.cellChanges$ = this._cellChangesSubject.asObservable();
     this.broadcasts$ = this._broadcastsSubject.asObservable();
     this.sessionStatus$ = this._sessionStatusSubject.asObservable();
@@ -49,6 +52,15 @@ class Session {
         ),
       );
     }
+    if (typeof nativeSession.onExecutionViewChange === "function") {
+      this._subscriptions.push(
+        nativeSession.onExecutionViewChange((json) => {
+          const changeset = parseJsonEvent(json);
+          applyExecutionViewChangeset(this._executionView, changeset);
+          this._executionViewChangesSubject.next(changeset);
+        }),
+      );
+    }
   }
 
   get notebookId() {
@@ -95,6 +107,10 @@ class Session {
     return this._native.saveNotebook(path);
   }
 
+  exportSnapshotPair() {
+    return this._native.exportSnapshotPair();
+  }
+
   listCells() {
     return this._native.listCells();
   }
@@ -116,7 +132,7 @@ class Session {
   }
 
   moveCell(cellId, afterCellId) {
-    return this._native.moveCell(cellId, { afterCellId: afterCellId ?? null });
+    return this._native.moveCell(cellId, afterCellId == null ? undefined : { afterCellId });
   }
 
   executeCell(cellId, options) {
@@ -185,12 +201,17 @@ class Session {
     return this._native.syncEnvironment();
   }
 
+  getExecutionView() {
+    return cloneExecutionView(this._executionView);
+  }
+
   close() {
     for (const subscription of this._subscriptions.splice(0)) {
       subscription?.dispose?.();
     }
     this._runtimeStateSubject.complete();
     this._executionTransitionsSubject.complete();
+    this._executionViewChangesSubject.complete();
     this._cellChangesSubject.complete();
     this._broadcastsSubject.complete();
     this._sessionStatusSubject.complete();
@@ -212,6 +233,71 @@ function normalizeDependencyOptions(options) {
   return { packageManager: options.packageManager };
 }
 
+function emptyExecutionView() {
+  return {
+    cell_execution_ids: {},
+    executions: {},
+    queue: null,
+  };
+}
+
+function applyExecutionViewChangeset(view, changeset) {
+  for (const [cellId, executionId] of changeset?.cell_pointer_changes ?? []) {
+    if (executionId == null) {
+      delete view.cell_execution_ids[cellId];
+    } else {
+      view.cell_execution_ids[cellId] = executionId;
+    }
+  }
+
+  for (const [executionId, snapshot] of changeset?.execution_upserts ?? []) {
+    view.executions[executionId] = cloneExecutionSnapshot(snapshot);
+  }
+
+  for (const executionId of changeset?.removed_execution_ids ?? []) {
+    delete view.executions[executionId];
+  }
+
+  if (Object.hasOwn(changeset ?? {}, "queue")) {
+    view.queue = cloneQueueProjection(changeset.queue ?? null);
+  }
+}
+
+function cloneExecutionView(view) {
+  return {
+    cell_execution_ids: { ...view.cell_execution_ids },
+    executions: Object.fromEntries(
+      Object.entries(view.executions).map(([executionId, snapshot]) => [
+        executionId,
+        cloneExecutionSnapshot(snapshot),
+      ]),
+    ),
+    queue: cloneQueueProjection(view.queue),
+  };
+}
+
+function cloneExecutionSnapshot(snapshot) {
+  return {
+    ...snapshot,
+    output_ids: Array.from(snapshot?.output_ids ?? []),
+  };
+}
+
+function cloneQueueProjection(queue) {
+  if (queue == null) return null;
+  return {
+    executing_execution_id: queue.executing_execution_id ?? null,
+    queued_execution_ids: Array.from(queue.queued_execution_ids ?? []),
+    notebook:
+      queue.notebook == null
+        ? queue.notebook
+        : {
+            executing_cell_id: queue.notebook.executing_cell_id ?? null,
+            queued_cell_ids: Array.from(queue.notebook.queued_cell_ids ?? []),
+          },
+  };
+}
+
 module.exports = {
   Session,
 };