@runtimed/node 0.5.5 → 0.5.6-nightly.36546986351

package/README.md

@@ -52,6 +52,48 @@ through the same local daemon used by nteract desktop.
 
 ## Embedding a notebook frontend
 
+### Explicit project manifest creation
+
+The local Node host can create a missing `environment.yml` after the user or
+host explicitly requests it. Supply an existing absolute directory and the
+desired Conda specs; opening a notebook never calls this helper automatically.
+
+```js
+const { initializeEnvironmentYml } = require("@runtimed/node");
+
+const manifestPath = await initializeEnvironmentYml({
+  directory: "/absolute/path/to/project",
+  name: "analysis",
+  python: ">=3.11,<3.13",
+  dependencies: ["numpy>=2,<3", "pandas"],
+  channels: ["conda-forge"],
+});
+```
+
+The helper validates the manifest with the same parser as daemon discovery,
+then publishes the complete file without replacing an existing file or symlink.
+The helper checks for an existing `environment.yaml` before creating anything.
+Hosts must coordinate with other writers creating that alternate filename; only
+publication of `environment.yml` itself is atomic. On Unix, new manifest
+permissions honor the host process's umask.
+It rejects invalid specs and missing/unwritable directories. The name is optional;
+channel priority follows the supplied array. Python can be specified in `python`
+or `dependencies`, but not both. This initializer supports Conda dependencies;
+pip subsections and other manifest formats remain separate work.
+
+This is a local filesystem operation for a host process that already has write
+authority over the chosen directory. It is not exposed by the Electron renderer
+bridge or a remote notebook request. It does not contact the daemon, install
+packages, approve environment trust, or launch/change a running kernel.
+
+Open or reopen a notebook in that directory to use normal project discovery.
+Existing project precedence still applies (`pyproject.toml`, `pixi.toml`, then
+`environment.yml`). Installing an environment and launching a kernel use the
+usual explicit launch and approval flow. Creation does not change the environment
+of a notebook that is already running.
+
+### Notebook relay
+
 `@runtimed/node/relay` exposes the native byte pipe used by desktop notebook
 hosts. The browser/WASM frontend remains the Automerge peer; Node owns the
 daemon socket, handshake, framing, and liveness heartbeat and forwards opaque
@@ -75,17 +117,22 @@ Hosts that supervise the daemon can use `defaultSocketPath()`,
 `socketPathForChannel("stable" | "nightly")`, and
 `queryDaemonInfo({ socketPath })` from the same subpath. The explicit channel
 resolver is useful when the host's release channel differs from the package's
-compile-time default. The query returns `null` until the daemon is ready, so
-the host does not need to duplicate the pool wire protocol just to probe
-readiness.
+compile-time default. The query returns `null` when metadata is unavailable,
+including absent or unready endpoints and older daemons that cannot answer the
+query. A responding daemon returns `protocolVersion`, `daemonApiVersion`, and
+an optional `compatibilityError` computed by the shared Rust client checker.
+The semantic API version is zero when the daemon does not report it. Hosts can
+surface the diagnostic without duplicating supported-version policy in JavaScript;
+the probe never starts or replaces a daemon.
 
 `RelaySession.info.daemonVersion` is the identity carried by that notebook's
 exact handshake. It is intentionally left undefined when an older daemon omits
 it rather than being filled from a later pool query, which could race a daemon
 restart. Treat that artifact version as diagnostic metadata. Compatibility is
 determined by the negotiated protocol number and, for optional semantics, the
-capabilities advertised by the connection. Use `queryDaemonInfo()` only for
-readiness and diagnostics.
+capabilities advertised by the connection. The pool probe is a compatibility
+preflight and diagnostic, not authentication or proof about a later notebook
+connection: the daemon can change between the probe and that connection.
 
 Frames include the one-byte notebook frame discriminator and omit the daemon
 socket's length prefix; an empty buffer is not a frame and is rejected. The
@@ -258,6 +305,15 @@ sessions.
   and startup error details.
 - `Session.syncEnvironment()` installs recorded notebook dependencies.
 - `Session.saveNotebook(path?)` saves the notebook.
+- `Session.confirmNotebookSync()` returns the current NotebookDoc heads after
+  the connected local daemon accepts them. Later edits are outside that receipt.
+  Timeout, close, disconnect, rejected edits, and unsupported daemons reject the
+  promise; there is no best-effort fallback. A missing handshake capability
+  rejects before sending a request, leaving older daemon sessions usable.
+  Persistent local rooms journal edits
+  before acknowledging them, while ephemeral rooms promise acceptance only.
+  This does not export an `.ipynb`, acknowledge other document streams, or confirm
+  hosted persistence. Hosted bridge rooms currently reject this operation.
 - `Session.close()` releases the daemon connection.
 
 ## Daemon Requirements
@@ -295,5 +351,92 @@ installed through `@runtimed/node`:
 
 - `@runtimed/node-darwin-arm64`
 - `@runtimed/node-linux-x64-gnu`
+- `@runtimed/node-linux-arm64-gnu` (publication requires the bootstrap described in `RELEASING.md`)
+- `@runtimed/node-win32-x64-msvc`
+- `@runtimed/node-win32-arm64-msvc`
 
 They contain only the compiled native `.node` binary for their target platform.
+
+
+### Shared execution state
+
+Each `Session` owns `session.executions`, the same synchronous execution-store
+implementation used by the React frontend. Native execution changesets update
+this store before `executionViewChanges$` emits. Command APIs and pi's existing
+changeset subscription are unchanged. Construction adds no readiness promise,
+transport, timer, or WASM instance.
+
+```js
+const store = session.executions;
+const unsubscribe = store.subscribeExecutionById(executionId)(() => {
+  console.log(store.getExecutionById(executionId));
+});
+console.log(store.getExecutionById(executionId)); // initial read
+// Later:
+unsubscribe();
+```
+
+`getExecutionView()` now returns a cached, immutable snapshot, not a mutable
+copy. Entity snapshots and output-ID arrays are owned and frozen by the store;
+unchanged output membership retains its array identity. Make an explicit copy
+if mutable data is needed. Retained snapshots do not change after later events.
+Removing an execution also clears its current cell pointer, even if its snapshot
+has not arrived. An explicit queue update without a notebook projection clears
+the notebook queue; an absent queue field leaves it unchanged.
+`setNotebookQueueProjection()` updates the notebook projection in an existing
+aggregate queue before notifying subscribers. Before any runtime queue arrives,
+the aggregate queue stays `null`; a cell-only projection cannot infer execution
+queue membership.
+
+Subscriptions invalidate synchronously per write. A changeset is applied in
+upsert, removal, pointer, then queue order; it is not one atomic notification.
+Listeners added during delivery begin on a subsequent notification, unsubscribed
+listeners are skipped, and listener errors do not stop other listeners.
+Unsubscribe functions are idempotent, including when the same callback is later
+registered again.
+`close()` disposes native subscriptions and completes the RxJS streams; owners
+must release their store subscriptions too. The last state remains readable.
+
+The implementation source is `packages/runtimed/src/execution-store.ts`.
+`build:stores` generates this package's CommonJS module and declarations;
+`check:stores` checks freshness and runs before packing. The published package
+does not depend on the private TypeScript workspace package.
+
+A small framework-neutral readable adapter in
+`packages/runtimed/examples/execution-readable.ts` demonstrates Svelte's initial
+value and unsubscribe contract. It wraps the same instance and holds no second
+copy of notebook state. Cells, output content, and a complete Svelte shell are
+separate follow-ups.
+
+### Session status
+
+`session.sessionStatus$` forwards the native `SyncStatus` JSON unchanged.
+`connection` is `"Connected"` or `"Disconnected"`; `notebook_doc` is `"Pending"`,
+`"Syncing"`, or `"Interactive"`; `runtime_state` is `"Pending"`, `"Syncing"`, or
+`"Ready"`. `initial_load` is `"NotNeeded"`, `"Streaming"`, `"Ready"`, or
+`{ Failed: { reason: string } }`. These are case-sensitive values, distinct
+from the session-control wire representation. Subscribe to detect connection
+loss and bootstrap failures; `close()` completes the stream.
+Callers using the earlier lowercase declarations or `initial_load.phase` must
+update their comparisons to these native values; runtime serialization is unchanged.
+
+### Native session verification
+
+Build the native binding and daemon, then run the callback and shared-store
+contract against an isolated daemon without a Python kernel:
+
+```bash
+pnpm --dir packages/runtimed-node build:debug
+pnpm --dir packages/runtimed-node typecheck:contracts
+cargo xtask artifacts ensure runtime,sift,renderer
+cargo build -p runtimed
+RUNTIMED_NODE_NATIVE_INTEGRATION=1 \
+  pnpm test:run packages/runtimed-node/tests/native-session.test.ts
+```
+
+Add `RUNTIMED_NODE_EXECUTION_INTEGRATION=1` to exercise Python execution,
+reruns, progress callbacks, and retained snapshots too. This creates a notebook
+environment with `ipykernel` and may download Python packages. The suite starts
+and stops its own daemon and disables background environment pools.
+CI runs this Python execution and recovery coverage in a separate step with both
+flags enabled.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@runtimed/node",
-  "version": "0.5.5",
+  "version": "0.5.6-nightly.36546986351",
   "description": "Node.js bindings for controlling nteract runtimed notebooks and Python kernels.",
   "type": "module",
   "license": "BSD-3-Clause",
@@ -53,38 +53,51 @@
     "src/session.cjs",
     "src/napi-observables.cjs",
     "src/binding.cjs",
-    "src/binding.d.ts"
+    "src/binding.d.ts",
+    "src/execution-store.cjs",
+    "src/execution-store.d.cts"
   ],
   "napi": {
     "binaryName": "runtimed-node",
     "targets": [
       "aarch64-apple-darwin",
       "x86_64-unknown-linux-gnu",
-      "x86_64-pc-windows-msvc"
+      "aarch64-unknown-linux-gnu",
+      "x86_64-pc-windows-msvc",
+      "aarch64-pc-windows-msvc"
     ]
   },
   "dependencies": {
     "rxjs": "^7.8.2"
   },
   "optionalDependencies": {
-    "@runtimed/node-darwin-arm64": "0.5.5",
-    "@runtimed/node-linux-x64-gnu": "0.5.5",
-    "@runtimed/node-win32-x64-msvc": "0.5.5"
+    "@runtimed/node-darwin-arm64": "0.5.6-nightly.36546986351",
+    "@runtimed/node-linux-x64-gnu": "0.5.6-nightly.36546986351",
+    "@runtimed/node-win32-x64-msvc": "0.5.6-nightly.36546986351"
   },
   "publishConfig": {
     "access": "public"
   },
   "devDependencies": {
-    "@napi-rs/cli": "^3.6.2"
+    "@napi-rs/cli": "^3.6.2",
+    "typescript": "~5.8.3"
+  },
+  "nteractRelease": {
+    "channel": "nightly",
+    "sourceSha": "d6959be66205165cb1d422d29fbf9b54a3b80d54",
+    "runId": "36546986351"
   },
   "scripts": {
     "assemble:platform": "node scripts/assemble-platform-package.mjs",
-    "build": "napi build --platform --release --js binding.cjs --dts binding.d.ts --manifest-path ../../crates/runtimed-node/Cargo.toml --output-dir src",
-    "build:debug": "napi build --platform --js binding.cjs --dts binding.d.ts --manifest-path ../../crates/runtimed-node/Cargo.toml --output-dir src",
+    "build": "pnpm build:stores && napi build --platform --release --js binding.cjs --dts binding.d.ts --manifest-path ../../crates/runtimed-node/Cargo.toml --output-dir src",
+    "build:debug": "pnpm build:stores && napi build --platform --js binding.cjs --dts binding.d.ts --manifest-path ../../crates/runtimed-node/Cargo.toml --output-dir src",
     "pack:platform:dry-run": "node scripts/assemble-platform-package.mjs --pack-dry-run",
     "pack:dry-run": "pnpm pack --dry-run",
     "smoke": "node -e \"const m = require('./src/index.cjs'); console.log('defaultSocketPath:', m.defaultSocketPath());\"",
     "smoke:relay": "node scripts/smoke-relay.cjs",
-    "smoke:api": "node scripts/smoke-api.cjs"
+    "smoke:api": "node scripts/smoke-api.cjs",
+    "build:stores": "node scripts/build-execution-store.mjs",
+    "typecheck:contracts": "tsc --project tsconfig.contracts.json",
+    "check:stores": "node scripts/build-execution-store.mjs --check"
   }
-}
+}

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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+      if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+          if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 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.5.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.5.5 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
+        if (bindingPackageVersion !== '0.5.6-nightly.36546986351' && 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.5.6-nightly.36546986351 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
         }
         return binding
       } catch (e) {
@@ -586,6 +586,7 @@ module.exports.CreateNotebookEnvironmentMode = nativeBinding.CreateNotebookEnvir
 module.exports.createRelay = nativeBinding.createRelay
 module.exports.defaultSocketPath = nativeBinding.defaultSocketPath
 module.exports.getExecutionResult = nativeBinding.getExecutionResult
+module.exports.initializeEnvironmentYml = nativeBinding.initializeEnvironmentYml
 module.exports.listActiveNotebooks = nativeBinding.listActiveNotebooks
 module.exports.openNotebook = nativeBinding.openNotebook
 module.exports.openNotebookPath = nativeBinding.openNotebookPath

package/src/binding.d.ts

@@ -40,8 +40,10 @@ export declare class Session {
    *
    * 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.
+   * ends after a terminal execution snapshot, kernel failure after the
+   * execution has been observed, or connection close. An execution that
+   * never appears stays pending until the subscription is disposed or the
+   * connection closes.
    */
   onExecutionProgress(executionId: string, cellId: string | undefined | null, callback: (arg0: string) => void): EventSubscription
   /**
@@ -68,6 +70,13 @@ export declare class Session {
    * `NotebookDoc` + `RuntimeStateDoc` + `CommsDoc` snapshot triplet.
    */
   exportSnapshotPair(): Promise<SnapshotPair>
+  /**
+   * Acknowledge the current NotebookDoc frontier at the connected daemon.
+   * Returns the captured heads; later edits are not covered. Rejects on
+   * timeout, close, disconnect, unsupported peers, or daemon rejection.
+   * This does not save an .ipynb or acknowledge other document streams.
+   */
+  confirmNotebookSync(): Promise<Array<string>>
   /** Close the session and release the underlying connection. */
   close(): Promise<void>
   /**
@@ -273,6 +282,11 @@ export interface CreateRelayOptions {
 /** Daemon metadata needed by a Node host before it opens a notebook relay. */
 export interface DaemonInfo {
   version: string
+  protocolVersion: number
+  /** Zero means the daemon predates semantic API version reporting. */
+  daemonApiVersion: number
+  /** Shared Rust compatibility diagnostic; absent when supported by this client. */
+  compatibilityError?: string
   socketPath: string
   isDevMode: boolean
   blobPort?: number
@@ -329,6 +343,29 @@ export interface GetExecutionResultOptions {
   socketPath?: string
 }
 
+/**
+ * Create environment.yml without overwriting an existing file or symlink.
+ *
+ * This uses the local Node process's filesystem authority. It does not contact
+ * the daemon, install packages, approve trust, or launch/change a kernel.
+ * Returns the absolute path of the newly created manifest.
+ */
+export declare function initializeEnvironmentYml(options: InitializeEnvironmentYmlOptions): Promise<string>
+
+/** Options for the local host's explicit manifest creation request. */
+export interface InitializeEnvironmentYmlOptions {
+  /** An existing absolute directory the host is authorized to write. */
+  directory: string
+  /** Optional environment name: letters, numbers, '.', '_' and '-'. */
+  name?: string
+  /** Conda match specs; pip subsections are not supported by this initializer. */
+  dependencies: Array<string>
+  /** Optional Python version constraint, e.g. "3.12" or ">=3.11,<3.13". */
+  python?: string
+  /** At least one channel, in priority order. No channels are inferred. */
+  channels: Array<string>
+}
+
 /** A notebook cell snapshot. */
 export interface JsCellSnapshot {
   id: string