@runtimed/node 0.2.0 → 0.2.2

package/README.md

@@ -26,7 +26,6 @@ async function main() {
     workingDir: process.cwd(),
     // Record these before the first cell runs.
     dependencies: ["numpy", "matplotlib"],
-    packageManager: "uv",
     description: "plotting smoke test",
   });
 
@@ -61,11 +60,15 @@ main().catch((error) => {
 ## Notebook Dependencies
 
 `createNotebook()` accepts `dependencies` so agent code can declare packages
-up-front instead of failing the first import and retrying after `addUvDependency()`.
-The `packageManager` option is typed from the native binding's `PackageManager`
-string enum (`"uv"`, `"conda"`, or `"pixi"`) and is converted to the shared
-notebook protocol enum before the daemon handshake. `description` can be used
-as a human-readable peer label for agent-created sessions.
+up-front instead of failing the first import and retrying after `addDependencies()`.
+When `packageManager` is omitted, the daemon/user environment choice remains in
+charge. Later dependency edits also infer the manager from the running kernel,
+inline notebook metadata (`uv`, then `conda`, then `pixi`), or detected project
+file, falling back to UV for fresh Python notebooks with no other signal. Pass
+the native binding's `PackageManager` string enum (`"uv"`, `"conda"`, or
+`"pixi"`) only when you need to target a specific metadata section.
+`description` can be used as a human-readable peer label for agent-created
+sessions.
 
 ## API Surface
 
@@ -94,17 +97,22 @@ as a human-readable peer label for agent-created sessions.
 - `Session.runCell(source, options)` creates, runs, and waits for a cell.
 - `Session.queueCell(source, options)` queues a cell 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.addDependency(spec, { packageManager })` /
   `Session.addDependencies(specs, { packageManager })` and
   `Session.removeDependency(spec, { packageManager })` /
   `Session.removeDependencies(specs, { packageManager })` edit notebook
-  dependency metadata for UV, Conda, or Pixi. Batch variants use one CRDT
+  dependency metadata for UV, Conda, or Pixi. Omit `packageManager` to follow
+  the notebook's running/configured manager. Batch variants use one CRDT
   metadata transaction.
 - `Session.getDependencyStatus()` returns dependency metadata, fingerprint, and
   trust state in one call.
 - `Session.getRuntimeStatus()` returns kernel lifecycle, activity, env source,
   and startup error details.
-- `Session.addUvDependency(spec)` records a UV dependency for the notebook.
 - `Session.syncEnvironment()` installs recorded notebook dependencies.
 - `Session.saveNotebook(path?)` saves the notebook.
 - `Session.close()` releases the daemon connection.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtimed/node",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "Node.js bindings for controlling nteract runtimed notebooks and Python kernels.",
   "type": "module",
   "license": "BSD-3-Clause",
@@ -35,6 +35,8 @@
     "README.md",
     "src/index.cjs",
     "src/index.d.ts",
+    "src/session.cjs",
+    "src/napi-observables.cjs",
     "src/binding.cjs",
     "src/binding.d.ts"
   ],
@@ -46,10 +48,14 @@
       "x86_64-pc-windows-msvc"
     ]
   },
+  "dependencies": {
+    "rxjs": "^7.8.2",
+    "runtimed": "0.2.4"
+  },
   "optionalDependencies": {
-    "@runtimed/node-linux-x64-gnu": "0.2.0",
-    "@runtimed/node-darwin-arm64": "0.2.0",
-    "@runtimed/node-win32-x64-msvc": "0.2.0"
+    "@runtimed/node-darwin-arm64": "0.2.2",
+    "@runtimed/node-linux-x64-gnu": "0.2.2",
+    "@runtimed/node-win32-x64-msvc": "0.2.2"
   },
   "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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.2' && 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.2 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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.2' && 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.2 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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.2' && 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.2 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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.2' && 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.2 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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.2' && 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.2 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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.2' && 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.2 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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.2.2' && 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.2 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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.2' && 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.2 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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.2' && 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.2 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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.2' && 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.2 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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.2' && 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.2 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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.2' && 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.2 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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.2' && 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.2 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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.2' && 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.2 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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.2' && 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.2 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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.2' && 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.2 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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.2' && 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.2 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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.2' && 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.2 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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.2' && 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.2 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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.2' && 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.2 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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.2.2' && 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.2 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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.2' && 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.2 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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.2' && 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.2 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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.2' && 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.2 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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.2' && 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.2 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.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.2.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.2.2' && 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.2 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -576,6 +576,7 @@ if (!nativeBinding) {
 }
 
 module.exports = nativeBinding
+module.exports.EventSubscription = nativeBinding.EventSubscription
 module.exports.Session = nativeBinding.Session
 module.exports.createNotebook = nativeBinding.createNotebook
 module.exports.defaultSocketPath = nativeBinding.defaultSocketPath

package/src/binding.d.ts

@@ -1,9 +1,39 @@
 /* auto-generated by NAPI-RS */
 /* eslint-disable */
+/** A live event subscription returned by `Session.on*` methods. */
+export declare class EventSubscription {
+  /** Stop delivering events to the callback. */
+  dispose(): void
+}
+
 /** A connected notebook session. */
 export declare class Session {
   /** The notebook ID (always a UUID). */
   get notebookId(): string
+  /** Subscribe to RuntimeStateDoc snapshots. Callback receives a JSON string. */
+  onRuntimeState(callback: (arg0: string) => void): EventSubscription
+  /** Subscribe to execution lifecycle transitions. Callback receives a JSON string. */
+  onExecutionTransition(callback: (arg0: string) => void): EventSubscription
+  /**
+   * Subscribe to resolved progress snapshots for one execution.
+   *
+   * Callback receives the same JSON shape as `CellResult`, emitted whenever
+   * the RuntimeStateDoc entry for the execution changes. The subscription
+   * ends after an authoritative terminal snapshot, including kernel
+   * failure/close.
+   */
+  onExecutionProgress(executionId: string, cellId: string | undefined | null, callback: (arg0: string) => void): EventSubscription
+  /**
+   * Subscribe to notebook document changes. Callback receives a JSON string.
+   *
+   * The native handle currently reports `null` as a full-materialization
+   * marker, matching the browser SyncEngine's no-changeset fallback.
+   */
+  onCellChange(callback: (arg0: string) => void): EventSubscription
+  /** Subscribe to comm broadcasts. Callback receives a JSON string. */
+  onBroadcast(callback: (arg0: string) => void): EventSubscription
+  /** Subscribe to handshake/readiness status updates. Callback receives a JSON string. */
+  onSessionStatus(callback: (arg0: string) => void): EventSubscription
   /**
    * Save the notebook to disk. If a path is given, saves to that path
    * (creating the file if needed). Otherwise saves to the original location.
@@ -12,22 +42,26 @@ export declare class Session {
   /** Close the session and release the underlying connection. */
   close(): Promise<void>
   /**
-   * Add dependencies to the selected package manager (defaults to UV) in one CRDT transaction.
+   * Add dependencies to the selected package manager in one CRDT transaction.
+   * When no manager is provided, the running/configured notebook manager is used.
    * Call `syncEnvironment()` or restart the kernel to install them.
    */
   addDependencies(packages: Array<string>, options?: DependencyEditOptions | undefined | null): Promise<void>
   /**
-   * Add a dependency to the selected package manager (defaults to UV).
+   * Add a dependency to the selected package manager.
+   * When no manager is provided, the running/configured notebook manager is used.
    * Call `syncEnvironment()` or restart the kernel to install it.
    */
   addDependency(pkg: string, options?: DependencyEditOptions | undefined | null): Promise<void>
   /**
-   * Remove dependencies from the selected package manager (defaults to UV) in one CRDT transaction.
+   * Remove dependencies from the selected package manager in one CRDT transaction.
+   * When no manager is provided, the running/configured notebook manager is used.
    * Returns the number of dependencies removed.
    */
   removeDependencies(packages: Array<string>, options?: DependencyEditOptions | undefined | null): Promise<number>
   /**
-   * Remove a dependency from the selected package manager (defaults to UV).
+   * Remove a dependency from the selected package manager.
+   * When no manager is provided, the running/configured notebook manager is used.
    * Returns true if a dependency was removed.
    */
   removeDependency(pkg: string, options?: DependencyEditOptions | undefined | null): Promise<boolean>
@@ -165,7 +199,10 @@ export declare function defaultSocketPath(): string
 
 /** Options for dependency edit methods. */
 export interface DependencyEditOptions {
-  /** Dependency manager to edit. Defaults to `uv` for Python notebooks. */
+  /**
+   * Dependency manager to edit. Defaults to the running/configured manager,
+   * falling back to UV for fresh Python notebooks.
+   */
   packageManager?: PackageManager
 }
 

package/src/index.cjs

@@ -8,5 +8,20 @@
 "use strict";
 
 const binding = require("./binding.cjs");
+const { Session } = require("./session.cjs");
 
-module.exports = binding;
+async function createNotebook(options) {
+  return new Session(await binding.createNotebook(options));
+}
+
+async function openNotebook(notebookId, options) {
+  return new Session(await binding.openNotebook(notebookId, options));
+}
+
+module.exports = {
+  ...binding,
+  createNotebook,
+  openNotebook,
+  NativeSession: binding.Session,
+  Session,
+};

package/src/index.d.ts

@@ -1,7 +1,203 @@
-/**
- * @runtimed/node — Node.js bindings for the runtimed daemon.
- *
- * This file re-exports the types generated by napi-rs into binding.d.ts.
- */
+import type { Observable } from "rxjs";
+import type { ExecutionTransition, RuntimeState, SessionStatus } from "runtimed";
 
-export * from "./binding.cjs";
+export type RuntimeKind = "python" | "deno" | (string & {});
+export type PackageManager = "uv" | "conda" | "pixi";
+
+export const PackageManager: {
+  readonly Uv: "uv";
+  readonly Conda: "conda";
+  readonly Pixi: "pixi";
+};
+
+export interface CreateNotebookOptions {
+  runtime?: RuntimeKind;
+  workingDir?: string;
+  socketPath?: string;
+  peerLabel?: string;
+  description?: string;
+  dependencies?: string[];
+  packageManager?: PackageManager;
+}
+
+export interface OpenNotebookOptions {
+  socketPath?: string;
+  peerLabel?: string;
+  description?: string;
+}
+
+export interface RunCellOptions {
+  timeoutMs?: number;
+  cellType?: "code" | "markdown" | "raw";
+  onUpdate?: (progress: CellResult) => void;
+}
+
+export interface QueueCellOptions {
+  cellType?: "code" | "markdown" | "raw";
+}
+
+export interface DependencyEditOptions {
+  packageManager?: PackageManager;
+}
+
+export interface WaitExecutionOptions {
+  cellId?: string;
+  timeoutMs?: number;
+  onUpdate?: (progress: CellResult) => void;
+}
+
+export interface QueuedExecution {
+  cellId: string;
+  executionId: string;
+}
+
+export interface JsOutput {
+  outputType: string;
+  name?: string;
+  text?: string;
+  dataJson?: string;
+  ename?: string;
+  evalue?: string;
+  traceback?: string[];
+  executionCount?: number;
+  blobUrlsJson?: string;
+  blobPathsJson?: string;
+}
+
+export interface CellResult {
+  cellId: string;
+  executionId: string;
+  executionCount?: number;
+  status:
+    | "done"
+    | "error"
+    | "timeout"
+    | "kernel_error"
+    | "kernel_failed"
+    | "closed"
+    | "queued"
+    | "running"
+    | (string & {});
+  success: boolean;
+  outputs: JsOutput[];
+}
+
+export interface EventSubscription {
+  dispose(): void;
+}
+
+export interface CellSnapshot {
+  id: string;
+  cellType: string;
+  position: string;
+  source: string;
+  metadataJson: string;
+  executionCount?: string;
+}
+
+export interface CreateCellOptions {
+  cellType?: "code" | "markdown" | "raw";
+  afterCellId?: string | null;
+}
+
+export interface SetCellOptions {
+  source?: string;
+  cellType?: "code" | "markdown" | "raw";
+}
+
+export interface RuntimeStatus {
+  status: string;
+  lifecycle: string;
+  activity?: string;
+  startingPhase: string;
+  name: string;
+  language: string;
+  envSource: string;
+  runtimeAgentId: string;
+  errorReason?: string;
+  errorDetails?: string;
+}
+
+export interface DependencyStatus {
+  uv?: {
+    dependencies: string[];
+    requiresPython?: string;
+  };
+  conda?: {
+    dependencies: string[];
+    channels: string[];
+    python?: string;
+  };
+  pixi?: {
+    dependencies: string[];
+    pypiDependencies: string[];
+    channels: string[];
+    python?: string;
+  };
+  fingerprint?: string;
+  trust?: unknown;
+}
+
+export class Session {
+  readonly notebookId: string;
+  readonly runtimeState$: Observable<RuntimeState>;
+  readonly executionTransitions$: Observable<ExecutionTransition>;
+  readonly cellChanges$: Observable<null>;
+  readonly broadcasts$: Observable<unknown>;
+  readonly sessionStatus$: Observable<SessionStatus>;
+
+  queueCell(source: string, options?: QueueCellOptions): Promise<QueuedExecution>;
+  waitForExecution(executionId: string, options?: WaitExecutionOptions): Promise<CellResult>;
+  runCell(source: string, options?: RunCellOptions): Promise<CellResult>;
+  saveNotebook(path?: string): Promise<void>;
+  listCells(): Promise<CellSnapshot[]>;
+  getCell(cellId: string): Promise<CellSnapshot | null>;
+  createCell(source: string, options?: CreateCellOptions): Promise<string>;
+  setCell(cellId: string, options: SetCellOptions): Promise<boolean>;
+  deleteCell(cellId: string): Promise<boolean>;
+  moveCell(cellId: string, afterCellId?: string | null): Promise<string>;
+  executeCell(cellId: string, options?: { timeoutMs?: number }): Promise<CellResult>;
+  showNotebook(): Promise<unknown>;
+  interruptKernel(): Promise<void>;
+  shutdownKernel(): Promise<void>;
+  restartKernel(): Promise<void>;
+  shutdownNotebook(): Promise<boolean>;
+  addDependency(pkg: string, options?: DependencyEditOptions): Promise<void>;
+  addDependencies(packages: string[], options?: DependencyEditOptions): Promise<void>;
+  removeDependency(pkg: string, options?: DependencyEditOptions): Promise<boolean>;
+  removeDependencies(packages: string[], options?: DependencyEditOptions): Promise<number>;
+  getDependencyStatus(): Promise<DependencyStatus>;
+  getRuntimeStatus(): Promise<RuntimeStatus>;
+  dependencyFingerprint(): Promise<string | null>;
+  approveTrust(observedHeads?: string[]): Promise<void>;
+  syncEnvironment(): Promise<void>;
+  close(): Promise<void>;
+}
+
+export const NativeSession: unknown;
+
+export function defaultSocketPath(): string;
+export function socketPathForChannel(channel: "stable" | "nightly"): string;
+export function createNotebook(options?: CreateNotebookOptions): Promise<Session>;
+export function openNotebook(notebookId: string, options?: OpenNotebookOptions): Promise<Session>;
+export function getExecutionResult(
+  executionId: string,
+  options?: { socketPath?: string },
+): Promise<CellResult>;
+
+export function readParquetFile(
+  filePath: string,
+  offset: number,
+  limit: number,
+): {
+  columns: string[];
+  rows: string[][];
+  totalRows: number;
+  offset: number;
+};
+
+export function summarizeParquetFile(filePath: string): {
+  numRows: number;
+  numBytes: number;
+  columns: Array<{ name: string; dataType: string; nullCount: number; statsJson: string }>;
+};

package/src/napi-observables.cjs

@@ -0,0 +1,9 @@
+"use strict";
+
+function parseJsonEvent(json) {
+  return typeof json === "string" ? JSON.parse(json) : json;
+}
+
+module.exports = {
+  parseJsonEvent,
+};

package/src/session.cjs

@@ -0,0 +1,217 @@
+"use strict";
+
+const { Subject } = require("rxjs");
+const { parseJsonEvent } = require("./napi-observables.cjs");
+
+class Session {
+  constructor(nativeSession) {
+    this._native = nativeSession;
+    this._subscriptions = [];
+    this._runtimeStateSubject = new Subject();
+    this._executionTransitionsSubject = 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.cellChanges$ = this._cellChangesSubject.asObservable();
+    this.broadcasts$ = this._broadcastsSubject.asObservable();
+    this.sessionStatus$ = this._sessionStatusSubject.asObservable();
+
+    if (typeof nativeSession.onRuntimeState === "function") {
+      this._subscriptions.push(
+        nativeSession.onRuntimeState((json) =>
+          this._runtimeStateSubject.next(parseJsonEvent(json)),
+        ),
+      );
+    }
+    if (typeof nativeSession.onCellChange === "function") {
+      this._subscriptions.push(
+        nativeSession.onCellChange((json) => this._cellChangesSubject.next(parseJsonEvent(json))),
+      );
+    }
+    if (typeof nativeSession.onBroadcast === "function") {
+      this._subscriptions.push(
+        nativeSession.onBroadcast((json) => this._broadcastsSubject.next(parseJsonEvent(json))),
+      );
+    }
+    if (typeof nativeSession.onSessionStatus === "function") {
+      this._subscriptions.push(
+        nativeSession.onSessionStatus((json) =>
+          this._sessionStatusSubject.next(parseJsonEvent(json)),
+        ),
+      );
+    }
+    if (typeof nativeSession.onExecutionTransition === "function") {
+      this._subscriptions.push(
+        nativeSession.onExecutionTransition((json) =>
+          this._executionTransitionsSubject.next(parseJsonEvent(json)),
+        ),
+      );
+    }
+  }
+
+  get notebookId() {
+    return this._native.notebookId;
+  }
+
+  queueCell(source, options) {
+    return this._native.queueCell(source, options);
+  }
+
+  async waitForExecution(executionId, options = {}) {
+    const { onUpdate, ...nativeOptions } = options ?? {};
+    const cellId = nativeOptions.cellId;
+    let progressSubscription = null;
+    if (typeof onUpdate === "function" && typeof this._native.onExecutionProgress === "function") {
+      progressSubscription = this._native.onExecutionProgress(
+        executionId,
+        cellId ?? null,
+        (json) => {
+          onUpdate(parseJsonEvent(json));
+        },
+      );
+    }
+
+    try {
+      return await this._native.waitForExecution(executionId, nativeOptions);
+    } finally {
+      progressSubscription?.dispose?.();
+    }
+  }
+
+  async runCell(source, options = {}) {
+    if (typeof options?.onUpdate !== "function") {
+      return this._native.runCell(source, options);
+    }
+    const queued = await this.queueCell(source, options);
+    return this.waitForExecution(queued.executionId, {
+      ...options,
+      cellId: queued.cellId,
+    });
+  }
+
+  saveNotebook(path) {
+    return this._native.saveNotebook(path);
+  }
+
+  listCells() {
+    return this._native.listCells();
+  }
+
+  getCell(cellId) {
+    return this._native.getCell(cellId);
+  }
+
+  createCell(source, options) {
+    return this._native.createCell(source, options);
+  }
+
+  setCell(cellId, options) {
+    return this._native.setCell(cellId, options);
+  }
+
+  deleteCell(cellId) {
+    return this._native.deleteCell(cellId);
+  }
+
+  moveCell(cellId, afterCellId) {
+    return this._native.moveCell(cellId, { afterCellId: afterCellId ?? null });
+  }
+
+  executeCell(cellId, options) {
+    return this._native.executeCell(cellId, options);
+  }
+
+  showNotebook() {
+    return this._native.showNotebook();
+  }
+
+  interruptKernel() {
+    return this._native.interruptKernel();
+  }
+
+  shutdownKernel() {
+    return this._native.shutdownKernel();
+  }
+
+  restartKernel() {
+    return this._native.restartKernel();
+  }
+
+  shutdownNotebook() {
+    return this._native.shutdownNotebook();
+  }
+
+  addDependency(pkg, options) {
+    return this._native.addDependency(pkg, normalizeDependencyOptions(options));
+  }
+
+  addDependencies(packages, options) {
+    return this._native.addDependencies(
+      normalizePackages(packages),
+      normalizeDependencyOptions(options),
+    );
+  }
+
+  removeDependency(pkg, options) {
+    return this._native.removeDependency(pkg, normalizeDependencyOptions(options));
+  }
+
+  removeDependencies(packages, options) {
+    return this._native.removeDependencies(
+      normalizePackages(packages),
+      normalizeDependencyOptions(options),
+    );
+  }
+
+  getDependencyStatus() {
+    return this._native.getDependencyStatus();
+  }
+
+  getRuntimeStatus() {
+    return this._native.getRuntimeStatus();
+  }
+
+  dependencyFingerprint() {
+    return this._native.dependencyFingerprint();
+  }
+
+  approveTrust(observedHeads) {
+    return this._native.approveTrust(observedHeads);
+  }
+
+  syncEnvironment() {
+    return this._native.syncEnvironment();
+  }
+
+  close() {
+    for (const subscription of this._subscriptions.splice(0)) {
+      subscription?.dispose?.();
+    }
+    this._runtimeStateSubject.complete();
+    this._executionTransitionsSubject.complete();
+    this._cellChangesSubject.complete();
+    this._broadcastsSubject.complete();
+    this._sessionStatusSubject.complete();
+    return this._native.close();
+  }
+}
+
+function normalizePackages(packages) {
+  if (!Array.isArray(packages)) {
+    throw new TypeError("packages must be an array of dependency specifiers");
+  }
+  return Array.from(new Set(packages.map((pkg) => String(pkg).trim()).filter(Boolean)));
+}
+
+function normalizeDependencyOptions(options) {
+  if (!options?.packageManager) {
+    return undefined;
+  }
+  return { packageManager: options.packageManager };
+}
+
+module.exports = {
+  Session,
+};