@runtimed/node 0.7.0 → 0.8.0-nightly.42433965924

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -52,6 +52,22 @@ through the same local daemon used by nteract desktop.
52
52
 
53
53
  ## Embedding a notebook frontend
54
54
 
55
+ ### Native binding attribution
56
+
57
+ Native platform packages (`@runtimed/node-<platform>`) include `LICENSE.nteract`,
58
+ `THIRD_PARTY_NOTICES.txt`, and `sbom.cdx.json` beside the `.node` binary. Keep these
59
+ files when copying the binding into an Electron application or another host.
60
+ The wrapper installs the matching platform package as an optional dependency;
61
+ its README points to those target-specific materials rather than substituting
62
+ daemon notices for the binding's independent Rust dependency graph.
63
+
64
+ The SBOM records the npm release version, source commit, Rust target, and binary
65
+ SHA-256. It is a conservative dependency inventory, not a replacement for license
66
+ texts or copyright notices. Preserve accessible notices and make corresponding
67
+ MPL-covered source, including covered-file changes, available to recipients.
68
+ Downloaded kernels/tools, the daemon, notebook UI, and host additions have separate
69
+ attribution obligations. These files do not establish complete product compliance.
70
+
55
71
  ### Host telemetry permission
56
72
 
57
73
  Host-attributed telemetry is staged behind the daemon's default-off
@@ -69,7 +85,7 @@ notebook activity.
69
85
  ```js
70
86
  const runtime = require("@runtimed/node");
71
87
 
72
- // Older package versions and older daemons remain usable without attribution.
88
+ // Older packages and daemons remain usable without host-attributed telemetry.
73
89
  const telemetry = await runtime.openTelemetryRegistration?.({
74
90
  socketPath: selectedDaemonSocket,
75
91
  hostId: "example-desktop", // Product slug, never a machine or account identity.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@runtimed/node",
3
- "version": "0.7.0",
3
+ "version": "0.8.0-nightly.42433965924",
4
4
  "description": "Node.js bindings for controlling nteract runtimed notebooks and Python kernels.",
5
5
  "type": "module",
6
6
  "license": "BSD-3-Clause",
@@ -71,11 +71,11 @@
71
71
  "rxjs": "^7.8.2"
72
72
  },
73
73
  "optionalDependencies": {
74
- "@runtimed/node-darwin-arm64": "0.7.0",
75
- "@runtimed/node-linux-x64-gnu": "0.7.0",
76
- "@runtimed/node-linux-arm64-gnu": "0.7.0",
77
- "@runtimed/node-win32-x64-msvc": "0.7.0",
78
- "@runtimed/node-win32-arm64-msvc": "0.7.0"
74
+ "@runtimed/node-darwin-arm64": "0.8.0-nightly.42433965924",
75
+ "@runtimed/node-linux-x64-gnu": "0.8.0-nightly.42433965924",
76
+ "@runtimed/node-linux-arm64-gnu": "0.8.0-nightly.42433965924",
77
+ "@runtimed/node-win32-x64-msvc": "0.8.0-nightly.42433965924",
78
+ "@runtimed/node-win32-arm64-msvc": "0.8.0-nightly.42433965924"
79
79
  },
80
80
  "publishConfig": {
81
81
  "access": "public"
@@ -85,9 +85,9 @@
85
85
  "typescript": "~5.8.3"
86
86
  },
87
87
  "nteractRelease": {
88
- "channel": "stable",
89
- "sourceSha": "9c85319021bdcd4b03bdfe010ccb4bbc4dc8ed57",
90
- "runId": "39908619555"
88
+ "channel": "nightly",
89
+ "sourceSha": "943115c13706ab28b6bd1ddda775e57f3acf1b65",
90
+ "runId": "42433965924"
91
91
  },
92
92
  "scripts": {
93
93
  "assemble:platform": "node scripts/assemble-platform-package.mjs",
package/src/binding.cjs CHANGED
@@ -77,8 +77,8 @@ function requireNative() {
77
77
  try {
78
78
  const binding = require('@runtimed/node-android-arm64')
79
79
  const bindingPackageVersion = require('@runtimed/node-android-arm64/package.json').version
80
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
81
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
80
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
81
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
82
82
  }
83
83
  return binding
84
84
  } catch (e) {
@@ -93,8 +93,8 @@ function requireNative() {
93
93
  try {
94
94
  const binding = require('@runtimed/node-android-arm-eabi')
95
95
  const bindingPackageVersion = require('@runtimed/node-android-arm-eabi/package.json').version
96
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
97
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
96
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
97
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
98
98
  }
99
99
  return binding
100
100
  } catch (e) {
@@ -114,8 +114,8 @@ function requireNative() {
114
114
  try {
115
115
  const binding = require('@runtimed/node-win32-x64-gnu')
116
116
  const bindingPackageVersion = require('@runtimed/node-win32-x64-gnu/package.json').version
117
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
118
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
117
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
118
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
119
119
  }
120
120
  return binding
121
121
  } catch (e) {
@@ -130,8 +130,8 @@ function requireNative() {
130
130
  try {
131
131
  const binding = require('@runtimed/node-win32-x64-msvc')
132
132
  const bindingPackageVersion = require('@runtimed/node-win32-x64-msvc/package.json').version
133
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
134
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
133
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
134
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
135
135
  }
136
136
  return binding
137
137
  } catch (e) {
@@ -147,8 +147,8 @@ function requireNative() {
147
147
  try {
148
148
  const binding = require('@runtimed/node-win32-ia32-msvc')
149
149
  const bindingPackageVersion = require('@runtimed/node-win32-ia32-msvc/package.json').version
150
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
151
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
150
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
151
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
152
152
  }
153
153
  return binding
154
154
  } catch (e) {
@@ -163,8 +163,8 @@ function requireNative() {
163
163
  try {
164
164
  const binding = require('@runtimed/node-win32-arm64-msvc')
165
165
  const bindingPackageVersion = require('@runtimed/node-win32-arm64-msvc/package.json').version
166
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
167
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
166
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
167
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
168
168
  }
169
169
  return binding
170
170
  } catch (e) {
@@ -182,8 +182,8 @@ function requireNative() {
182
182
  try {
183
183
  const binding = require('@runtimed/node-darwin-universal')
184
184
  const bindingPackageVersion = require('@runtimed/node-darwin-universal/package.json').version
185
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
186
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
185
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
186
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
187
187
  }
188
188
  return binding
189
189
  } catch (e) {
@@ -198,8 +198,8 @@ function requireNative() {
198
198
  try {
199
199
  const binding = require('@runtimed/node-darwin-x64')
200
200
  const bindingPackageVersion = require('@runtimed/node-darwin-x64/package.json').version
201
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
202
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
201
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
202
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
203
203
  }
204
204
  return binding
205
205
  } catch (e) {
@@ -214,8 +214,8 @@ function requireNative() {
214
214
  try {
215
215
  const binding = require('@runtimed/node-darwin-arm64')
216
216
  const bindingPackageVersion = require('@runtimed/node-darwin-arm64/package.json').version
217
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
218
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
217
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
218
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
219
219
  }
220
220
  return binding
221
221
  } catch (e) {
@@ -234,8 +234,8 @@ function requireNative() {
234
234
  try {
235
235
  const binding = require('@runtimed/node-freebsd-x64')
236
236
  const bindingPackageVersion = require('@runtimed/node-freebsd-x64/package.json').version
237
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
238
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
237
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
238
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
239
239
  }
240
240
  return binding
241
241
  } catch (e) {
@@ -250,8 +250,8 @@ function requireNative() {
250
250
  try {
251
251
  const binding = require('@runtimed/node-freebsd-arm64')
252
252
  const bindingPackageVersion = require('@runtimed/node-freebsd-arm64/package.json').version
253
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
254
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
253
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
254
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
255
255
  }
256
256
  return binding
257
257
  } catch (e) {
@@ -271,8 +271,8 @@ function requireNative() {
271
271
  try {
272
272
  const binding = require('@runtimed/node-linux-x64-musl')
273
273
  const bindingPackageVersion = require('@runtimed/node-linux-x64-musl/package.json').version
274
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
275
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
274
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
275
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
276
276
  }
277
277
  return binding
278
278
  } catch (e) {
@@ -287,8 +287,8 @@ function requireNative() {
287
287
  try {
288
288
  const binding = require('@runtimed/node-linux-x64-gnu')
289
289
  const bindingPackageVersion = require('@runtimed/node-linux-x64-gnu/package.json').version
290
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
291
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
290
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
291
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
292
292
  }
293
293
  return binding
294
294
  } catch (e) {
@@ -305,8 +305,8 @@ function requireNative() {
305
305
  try {
306
306
  const binding = require('@runtimed/node-linux-arm64-musl')
307
307
  const bindingPackageVersion = require('@runtimed/node-linux-arm64-musl/package.json').version
308
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
309
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
308
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
309
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
310
310
  }
311
311
  return binding
312
312
  } catch (e) {
@@ -321,8 +321,8 @@ function requireNative() {
321
321
  try {
322
322
  const binding = require('@runtimed/node-linux-arm64-gnu')
323
323
  const bindingPackageVersion = require('@runtimed/node-linux-arm64-gnu/package.json').version
324
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
325
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
324
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
325
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
326
326
  }
327
327
  return binding
328
328
  } catch (e) {
@@ -339,8 +339,8 @@ function requireNative() {
339
339
  try {
340
340
  const binding = require('@runtimed/node-linux-arm-musleabihf')
341
341
  const bindingPackageVersion = require('@runtimed/node-linux-arm-musleabihf/package.json').version
342
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
343
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
342
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
343
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
344
344
  }
345
345
  return binding
346
346
  } catch (e) {
@@ -355,8 +355,8 @@ function requireNative() {
355
355
  try {
356
356
  const binding = require('@runtimed/node-linux-arm-gnueabihf')
357
357
  const bindingPackageVersion = require('@runtimed/node-linux-arm-gnueabihf/package.json').version
358
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
359
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
358
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
359
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
360
360
  }
361
361
  return binding
362
362
  } catch (e) {
@@ -373,8 +373,8 @@ function requireNative() {
373
373
  try {
374
374
  const binding = require('@runtimed/node-linux-loong64-musl')
375
375
  const bindingPackageVersion = require('@runtimed/node-linux-loong64-musl/package.json').version
376
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
377
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
376
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
377
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
378
378
  }
379
379
  return binding
380
380
  } catch (e) {
@@ -389,8 +389,8 @@ function requireNative() {
389
389
  try {
390
390
  const binding = require('@runtimed/node-linux-loong64-gnu')
391
391
  const bindingPackageVersion = require('@runtimed/node-linux-loong64-gnu/package.json').version
392
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
393
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
392
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
393
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
394
394
  }
395
395
  return binding
396
396
  } catch (e) {
@@ -407,8 +407,8 @@ function requireNative() {
407
407
  try {
408
408
  const binding = require('@runtimed/node-linux-riscv64-musl')
409
409
  const bindingPackageVersion = require('@runtimed/node-linux-riscv64-musl/package.json').version
410
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
411
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
410
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
411
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
412
412
  }
413
413
  return binding
414
414
  } catch (e) {
@@ -423,8 +423,8 @@ function requireNative() {
423
423
  try {
424
424
  const binding = require('@runtimed/node-linux-riscv64-gnu')
425
425
  const bindingPackageVersion = require('@runtimed/node-linux-riscv64-gnu/package.json').version
426
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
427
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
426
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
427
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
428
428
  }
429
429
  return binding
430
430
  } catch (e) {
@@ -440,8 +440,8 @@ function requireNative() {
440
440
  try {
441
441
  const binding = require('@runtimed/node-linux-ppc64-gnu')
442
442
  const bindingPackageVersion = require('@runtimed/node-linux-ppc64-gnu/package.json').version
443
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
444
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
443
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
444
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
445
445
  }
446
446
  return binding
447
447
  } catch (e) {
@@ -456,8 +456,8 @@ function requireNative() {
456
456
  try {
457
457
  const binding = require('@runtimed/node-linux-s390x-gnu')
458
458
  const bindingPackageVersion = require('@runtimed/node-linux-s390x-gnu/package.json').version
459
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
460
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
459
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
460
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
461
461
  }
462
462
  return binding
463
463
  } catch (e) {
@@ -476,8 +476,8 @@ function requireNative() {
476
476
  try {
477
477
  const binding = require('@runtimed/node-openharmony-arm64')
478
478
  const bindingPackageVersion = require('@runtimed/node-openharmony-arm64/package.json').version
479
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
480
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
479
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
480
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
481
481
  }
482
482
  return binding
483
483
  } catch (e) {
@@ -492,8 +492,8 @@ function requireNative() {
492
492
  try {
493
493
  const binding = require('@runtimed/node-openharmony-x64')
494
494
  const bindingPackageVersion = require('@runtimed/node-openharmony-x64/package.json').version
495
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
496
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
495
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
496
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
497
497
  }
498
498
  return binding
499
499
  } catch (e) {
@@ -508,8 +508,8 @@ function requireNative() {
508
508
  try {
509
509
  const binding = require('@runtimed/node-openharmony-arm')
510
510
  const bindingPackageVersion = require('@runtimed/node-openharmony-arm/package.json').version
511
- if (bindingPackageVersion !== '0.7.0' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
512
- throw new Error(`Native binding package version mismatch, expected 0.7.0 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
511
+ if (bindingPackageVersion !== '0.8.0-nightly.42433965924' && process.env.NAPI_RS_ENFORCE_VERSION_CHECK && process.env.NAPI_RS_ENFORCE_VERSION_CHECK !== '0') {
512
+ throw new Error(`Native binding package version mismatch, expected 0.8.0-nightly.42433965924 but got ${bindingPackageVersion}. You can reinstall dependencies to fix this issue.`)
513
513
  }
514
514
  return binding
515
515
  } catch (e) {
@@ -586,9 +586,11 @@ module.exports.createNotebook = nativeBinding.createNotebook
586
586
  module.exports.CreateNotebookEnvironmentMode = nativeBinding.CreateNotebookEnvironmentMode
587
587
  module.exports.createRelay = nativeBinding.createRelay
588
588
  module.exports.defaultSocketPath = nativeBinding.defaultSocketPath
589
+ module.exports.EnvironmentSelectionTargetKind = nativeBinding.EnvironmentSelectionTargetKind
589
590
  module.exports.getExecutionResult = nativeBinding.getExecutionResult
590
591
  module.exports.initializeEnvironmentYml = nativeBinding.initializeEnvironmentYml
591
592
  module.exports.listActiveNotebooks = nativeBinding.listActiveNotebooks
593
+ module.exports.LocalEnvironmentBindingState = nativeBinding.LocalEnvironmentBindingState
592
594
  module.exports.openNotebook = nativeBinding.openNotebook
593
595
  module.exports.openNotebookPath = nativeBinding.openNotebookPath
594
596
  module.exports.openRelayPath = nativeBinding.openRelayPath
package/src/binding.d.ts CHANGED
@@ -29,6 +29,11 @@ export declare class NativeRelaySession {
29
29
  export declare class Session {
30
30
  /** The notebook ID (always a UUID). */
31
31
  get notebookId(): string
32
+ /**
33
+ * Daemon verdict on `createNotebook({ localEnvironment })`. Null for
34
+ * opened sessions, when none was requested, or on older daemons.
35
+ */
36
+ get localEnvironment(): LocalEnvironmentStatus | null
32
37
  /** Subscribe to RuntimeStateDoc snapshots. Callback receives a JSON string. */
33
38
  onRuntimeState(callback: (arg0: string) => void): EventSubscription
34
39
  /** Subscribe to execution lifecycle transitions. Callback receives a JSON string. */
@@ -116,6 +121,31 @@ export declare class Session {
116
121
  dependencyFingerprint(): Promise<string | null>
117
122
  /** Approve and sign the current dependency metadata. */
118
123
  approveTrust(observedHeads?: Array<string> | undefined | null): Promise<void>
124
+ /**
125
+ * Trust a folder so project files at or below it may drive uv, pixi,
126
+ * or conda on this machine. `directory` must be the project file's
127
+ * folder or an ancestor of it. The daemon releases a room parked at
128
+ * `AwaitingProjectTrust`; launch the kernel afterwards.
129
+ */
130
+ approveProjectTrust(directory: string): Promise<void>
131
+ /**
132
+ * Use the notebook's own environment instead of the project file in
133
+ * `directory`. With `remember`, the choice persists for that folder on
134
+ * this machine; otherwise it lasts for this room. Launch afterwards.
135
+ */
136
+ declineProjectTrust(directory: string, remember?: boolean | undefined | null): Promise<void>
137
+ /** Read the staged and applied local environment selection. */
138
+ getEnvironmentSelection(): Promise<EnvironmentSelection>
139
+ /**
140
+ * Stage a local environment target. Does not touch the running kernel;
141
+ * call `applyEnvironmentSelection()` to launch with it.
142
+ */
143
+ setEnvironmentSelection(target: EnvironmentSelectionTarget, expectedRevision: number): Promise<EnvironmentSelection>
144
+ /**
145
+ * Start or restart the kernel with the staged selection after trust
146
+ * checks. `observedHeads` defaults to this session's current heads.
147
+ */
148
+ applyEnvironmentSelection(expectedRevision: number, observedHeads?: Array<string> | undefined | null): Promise<EnvironmentSelection>
119
149
  /**
120
150
  * Ask the daemon to hot-install any pending dependency changes into
121
151
  * the running kernel's env. Starts the kernel first if needed.
@@ -263,6 +293,8 @@ export interface CreateNotebookOptions {
263
293
  packageManager?: PackageManager
264
294
  /** Environment source mode. Defaults to auto. */
265
295
  environmentMode?: CreateNotebookEnvironmentMode
296
+ /** Existing environment prefix to use instead of the prewarmed fallback. */
297
+ localEnvironment?: LocalEnvironmentOptions
266
298
  }
267
299
 
268
300
  /** Create a notebook room and return its native typed-frame relay. */
@@ -289,6 +321,8 @@ export interface CreateRelayOptions {
289
321
  packageManager?: PackageManager
290
322
  /** Project/notebook environment inheritance mode. */
291
323
  environmentMode?: CreateNotebookEnvironmentMode
324
+ /** Existing environment prefix to use instead of the prewarmed fallback. */
325
+ localEnvironment?: LocalEnvironmentOptions
292
326
  }
293
327
 
294
328
  /** Daemon metadata needed by a Node host before it opens a notebook relay. */
@@ -330,8 +364,10 @@ export interface DependencyStatus {
330
364
  uv?: UvDependencyStatus
331
365
  conda?: CondaDependencyStatus
332
366
  pixi?: PixiDependencyStatus
367
+ pep723Dependencies: Array<string>
333
368
  fingerprint?: string
334
369
  trust: DependencyTrustStatus
370
+ projectTrust: ProjectTrustStatus
335
371
  }
336
372
 
337
373
  /** Notebook trust state for dependency metadata. */
@@ -344,6 +380,34 @@ export interface DependencyTrustStatus {
344
380
  approvedPixiPypiDependencies: Array<string>
345
381
  }
346
382
 
383
+ /** Daemon-session environment intent, separate from the running kernel. */
384
+ export interface EnvironmentSelection {
385
+ /** Pass back as `expectedRevision` to set or apply. */
386
+ revision: number
387
+ /** Staged target. Null means Automatic. */
388
+ selected?: LocalCondaEnvironmentInfo
389
+ /** Target the running kernel was applied with. Null means Automatic. */
390
+ applied?: LocalCondaEnvironmentInfo
391
+ applying: boolean
392
+ }
393
+
394
+ /**
395
+ * Target for `Session.setEnvironmentSelection()`. `prefix` is required for
396
+ * `"conda"` and ignored for `"automatic"`.
397
+ */
398
+ export interface EnvironmentSelectionTarget {
399
+ kind: EnvironmentSelectionTargetKind
400
+ prefix?: string
401
+ }
402
+
403
+ /** Kind of local environment selection target. */
404
+ export declare const enum EnvironmentSelectionTargetKind {
405
+ /** Use the daemon's automatic environment policy. */
406
+ Automatic = 'automatic',
407
+ /** Borrow an existing Conda prefix. */
408
+ Conda = 'conda'
409
+ }
410
+
347
411
  /** Options for `Session.executeCell()`. */
348
412
  export interface ExecuteCellOptions {
349
413
  /** Max milliseconds to wait for execution. Default 120_000 (2 min). */
@@ -418,6 +482,46 @@ export interface ListActiveNotebooksOptions {
418
482
  socketPath?: string
419
483
  }
420
484
 
485
+ /** A validated local Conda environment. */
486
+ export interface LocalCondaEnvironmentInfo {
487
+ id: string
488
+ name: string
489
+ prefix: string
490
+ pythonPath: string
491
+ pythonVersion?: string
492
+ }
493
+
494
+ /** Daemon verdict on a requested `localEnvironment`. */
495
+ export declare const enum LocalEnvironmentBindingState {
496
+ /** The prefix validated and is bound to the room. */
497
+ Bound = 'bound',
498
+ /** The prefix failed validation; the room uses normal auto selection. */
499
+ Rejected = 'rejected'
500
+ }
501
+
502
+ /**
503
+ * Existing Python environment bound to a new notebook room.
504
+ *
505
+ * The prefix must be an absolute Conda environment directory with Python and
506
+ * ipykernel. It replaces only the prewarmed fallback: inline dependencies,
507
+ * PEP 723 blocks, a captured environment, and a trusted project file still
508
+ * win. The daemon borrows the prefix and never deletes it.
509
+ */
510
+ export interface LocalEnvironmentOptions {
511
+ prefix: string
512
+ }
513
+
514
+ /**
515
+ * Verdict on `localEnvironment`, reported by the daemon at creation.
516
+ * Absent when none was requested or the daemon predates the option.
517
+ */
518
+ export interface LocalEnvironmentStatus {
519
+ status: LocalEnvironmentBindingState
520
+ /** Canonical prefix when bound; the requested prefix when rejected. */
521
+ prefix: string
522
+ error?: string
523
+ }
524
+
421
525
  /** Options for `Session.moveCell()`. */
422
526
  export interface MoveCellOptions {
423
527
  /** Move after this cell, or omit/null to move to the beginning. */
@@ -514,6 +618,42 @@ export interface PixiDependencyStatus {
514
618
  python?: string
515
619
  }
516
620
 
621
+ /**
622
+ * Project-folder trust for the project file that would drive the
623
+ * environment. When `lifecycle` is `"AwaitingProjectTrust"`, pass
624
+ * `projectDir` (or an ancestor such as `repoRoot`) to
625
+ * `approveProjectTrust()` or `declineProjectTrust()`.
626
+ */
627
+ export interface ProjectTrustStatus {
628
+ /**
629
+ * `"no_project"`, `"trusted"`, `"untrusted"`, or `"notebook_env"`.
630
+ * Absent until the daemon evaluates the room.
631
+ */
632
+ status?: string
633
+ needsApproval: boolean
634
+ manifestPath?: string
635
+ /** `"pyproject_toml"`, `"pixi_toml"`, or `"environment_yml"`. */
636
+ kind?: string
637
+ projectDir?: string
638
+ repoRoot?: string
639
+ trustedDir?: string
640
+ summary: ProjectTrustSummaryStatus
641
+ }
642
+
643
+ /**
644
+ * What trusting a project folder lets uv, pixi, or conda do. Parsed from
645
+ * the manifest only; no tool runs to produce it.
646
+ */
647
+ export interface ProjectTrustSummaryStatus {
648
+ dependencies: Array<string>
649
+ nonRegistrySources: Array<string>
650
+ indexesAndChannels: Array<string>
651
+ buildBackend?: string
652
+ activationScripts: Array<string>
653
+ outsideDirectory: Array<string>
654
+ environmentToBuild?: string
655
+ }
656
+
517
657
  /**
518
658
  * Probe the selected daemon and return its host-facing metadata when ready.
519
659
  *
@@ -564,7 +704,17 @@ export interface RelayInfo {
564
704
  actorLabel?: string
565
705
  connectionScope?: string
566
706
  localEnvironmentSelection?: boolean
707
+ /**
708
+ * Daemon verdict on `createRelay({ localEnvironment })`. Absent when none
709
+ * was requested or the daemon predates the option.
710
+ */
711
+ localEnvironment?: LocalEnvironmentStatus
567
712
  commentsDocId?: string
713
+ /**
714
+ * Keyed document kinds the daemon routes for this room; hosts pass them
715
+ * to the ready payload so the browser only syncs supported kinds.
716
+ */
717
+ keyedDocKinds: Array<string>
568
718
  /** JSON encoding of the daemon-authoritative notebook reference. */
569
719
  commentsNotebookRefJson?: string
570
720
  protocol: string
@@ -598,6 +748,7 @@ export interface RuntimeStatus {
598
748
  runtimeAgentId: string
599
749
  errorReason?: string
600
750
  errorDetails?: string
751
+ projectTrust: ProjectTrustStatus
601
752
  }
602
753
 
603
754
  /** Options for `Session.setCell()`. */
package/src/index.d.ts CHANGED
@@ -97,6 +97,28 @@ export const CreateNotebookEnvironmentMode: {
97
97
  export type CreateNotebookEnvironmentMode =
98
98
  (typeof CreateNotebookEnvironmentMode)[keyof typeof CreateNotebookEnvironmentMode];
99
99
 
100
+ /**
101
+ * Existing Python environment bound to a new notebook room. `prefix` must be
102
+ * an absolute Conda environment directory with Python and ipykernel. It
103
+ * replaces only the prewarmed fallback: inline dependencies, PEP 723 blocks,
104
+ * a captured environment, and a trusted project file still win. The daemon
105
+ * borrows the prefix and never deletes it.
106
+ */
107
+ export interface LocalEnvironmentOptions {
108
+ prefix: string;
109
+ }
110
+
111
+ /**
112
+ * Daemon verdict on `localEnvironment`. Absent when none was requested or the
113
+ * daemon predates the option. A rejected prefix falls back to normal selection.
114
+ */
115
+ export interface LocalEnvironmentStatus {
116
+ status: "bound" | "rejected";
117
+ /** Canonical prefix when bound; the requested prefix when rejected. */
118
+ prefix: string;
119
+ error?: string;
120
+ }
121
+
100
122
  export interface CreateNotebookOptions {
101
123
  runtime?: RuntimeKind;
102
124
  workingDir?: string;
@@ -106,6 +128,30 @@ export interface CreateNotebookOptions {
106
128
  dependencies?: string[];
107
129
  packageManager?: PackageManager;
108
130
  environmentMode?: CreateNotebookEnvironmentMode;
131
+ localEnvironment?: LocalEnvironmentOptions;
132
+ }
133
+
134
+ export type EnvironmentSelectionTarget =
135
+ | { kind: "automatic"; prefix?: undefined }
136
+ | { kind: "conda"; prefix: string };
137
+
138
+ export interface LocalCondaEnvironmentInfo {
139
+ id: string;
140
+ name: string;
141
+ prefix: string;
142
+ pythonPath: string;
143
+ pythonVersion?: string;
144
+ }
145
+
146
+ /** Daemon-session environment intent, separate from the running kernel. */
147
+ export interface EnvironmentSelection {
148
+ /** Pass back as `expectedRevision` to set or apply. */
149
+ revision: number;
150
+ /** Staged target. Absent means Automatic. */
151
+ selected?: LocalCondaEnvironmentInfo;
152
+ /** Target the running kernel was applied with. Absent means Automatic. */
153
+ applied?: LocalCondaEnvironmentInfo;
154
+ applying: boolean;
109
155
  }
110
156
 
111
157
  export interface OpenNotebookOptions {
@@ -210,6 +256,35 @@ export interface SetCellOptions {
210
256
  cellType?: "code" | "markdown" | "raw";
211
257
  }
212
258
 
259
+ /** What trusting a project folder lets uv, pixi, or conda do. Parse-only. */
260
+ export interface ProjectTrustSummary {
261
+ dependencies: string[];
262
+ nonRegistrySources: string[];
263
+ indexesAndChannels: string[];
264
+ buildBackend?: string;
265
+ activationScripts: string[];
266
+ outsideDirectory: string[];
267
+ environmentToBuild?: string;
268
+ }
269
+
270
+ /**
271
+ * Project-folder trust for the project file that would drive the environment.
272
+ * When `RuntimeStatus.lifecycle` is `"AwaitingProjectTrust"`, pass `projectDir`
273
+ * (or an ancestor such as `repoRoot`) to `approveProjectTrust()` or
274
+ * `declineProjectTrust()`, then launch the kernel.
275
+ */
276
+ export interface ProjectTrustStatus {
277
+ /** Absent until the daemon evaluates the room. */
278
+ status?: "no_project" | "trusted" | "untrusted" | "notebook_env" | (string & {});
279
+ needsApproval: boolean;
280
+ manifestPath?: string;
281
+ kind?: "pyproject_toml" | "pixi_toml" | "environment_yml" | (string & {});
282
+ projectDir?: string;
283
+ repoRoot?: string;
284
+ trustedDir?: string;
285
+ summary: ProjectTrustSummary;
286
+ }
287
+
213
288
  export interface RuntimeStatus {
214
289
  status: string;
215
290
  lifecycle: string;
@@ -221,6 +296,7 @@ export interface RuntimeStatus {
221
296
  runtimeAgentId: string;
222
297
  errorReason?: string;
223
298
  errorDetails?: string;
299
+ projectTrust: ProjectTrustStatus;
224
300
  }
225
301
 
226
302
  export interface DependencyStatus {
@@ -239,12 +315,16 @@ export interface DependencyStatus {
239
315
  channels: string[];
240
316
  python?: string;
241
317
  };
318
+ pep723Dependencies: string[];
242
319
  fingerprint?: string;
243
320
  trust?: unknown;
321
+ projectTrust: ProjectTrustStatus;
244
322
  }
245
323
 
246
324
  export class Session {
247
325
  readonly notebookId: string;
326
+ /** Daemon verdict on `createNotebook({ localEnvironment })`; null otherwise. */
327
+ readonly localEnvironment: LocalEnvironmentStatus | null;
248
328
  readonly runtimeState$: Observable<RuntimeState>;
249
329
  readonly executionTransitions$: Observable<ExecutionTransition>;
250
330
  readonly executionViewChanges$: Observable<ExecutionViewChangeset>;
@@ -288,7 +368,31 @@ export class Session {
288
368
  readonly executions: NotebookExecutionStore;
289
369
  dependencyFingerprint(): Promise<string | null>;
290
370
  approveTrust(observedHeads?: string[]): Promise<void>;
371
+ /**
372
+ * Trust a folder so project files at or below it may drive uv, pixi, or conda
373
+ * on this machine. `directory` must be the project file's folder or an
374
+ * ancestor; the daemon refuses folders that contain the home directory.
375
+ * Trust is local and never written into the notebook. Launch afterwards.
376
+ */
377
+ approveProjectTrust(directory: string): Promise<void>;
378
+ /**
379
+ * Use the notebook's own environment instead of the project file in
380
+ * `directory`. With `remember`, the choice persists for that folder on this
381
+ * machine; otherwise it lasts for this room. Launch afterwards.
382
+ */
383
+ declineProjectTrust(directory: string, remember?: boolean): Promise<void>;
291
384
  syncEnvironment(): Promise<void>;
385
+ getEnvironmentSelection(): Promise<EnvironmentSelection>;
386
+ /** Stage a target without touching the running kernel. */
387
+ setEnvironmentSelection(
388
+ target: EnvironmentSelectionTarget,
389
+ expectedRevision: number,
390
+ ): Promise<EnvironmentSelection>;
391
+ /** Launch with the staged target. `observedHeads` defaults to current heads. */
392
+ applyEnvironmentSelection(
393
+ expectedRevision: number,
394
+ observedHeads?: string[],
395
+ ): Promise<EnvironmentSelection>;
292
396
  close(): Promise<void>;
293
397
  }
294
398
 
package/src/relay.d.ts CHANGED
@@ -18,6 +18,24 @@ export interface CreateRelayOptions {
18
18
  dependencies?: string[];
19
19
  packageManager?: PackageManager;
20
20
  environmentMode?: CreateNotebookEnvironmentMode;
21
+ /**
22
+ * Existing Conda prefix (absolute, with Python and ipykernel) to use instead
23
+ * of the prewarmed fallback. Inline deps, PEP 723, a captured env, and a
24
+ * trusted project file still win. The daemon never deletes the prefix.
25
+ */
26
+ localEnvironment?: LocalEnvironmentOptions;
27
+ }
28
+
29
+ export interface LocalEnvironmentOptions {
30
+ prefix: string;
31
+ }
32
+
33
+ /** Daemon verdict on `localEnvironment`; a rejected prefix falls back to normal selection. */
34
+ export interface LocalEnvironmentStatus {
35
+ status: "bound" | "rejected";
36
+ /** Canonical prefix when bound; the requested prefix when rejected. */
37
+ prefix: string;
38
+ error?: string;
21
39
  }
22
40
 
23
41
  export interface OpenRelayOptions {
@@ -57,7 +75,11 @@ export interface RelayInfo {
57
75
  connectionScope?: string;
58
76
  /** Optional daemon feature support; absent older bindings must fail closed. */
59
77
  localEnvironmentSelection?: boolean;
78
+ /** Absent when no `localEnvironment` was requested or the daemon predates it. */
79
+ localEnvironment?: LocalEnvironmentStatus;
60
80
  commentsDocId?: string;
81
+ /** Keyed document kinds the daemon routes; pass as `keyed_doc_kinds` in the host ready payload. */
82
+ keyedDocKinds: string[];
61
83
  commentsNotebookRef: CommentsNotebookRef | null;
62
84
  protocol: string;
63
85
  protocolVersion?: number;
package/src/session.cjs CHANGED
@@ -68,6 +68,10 @@ class Session {
68
68
  return this._native.notebookId;
69
69
  }
70
70
 
71
+ get localEnvironment() {
72
+ return this._native.localEnvironment ?? null;
73
+ }
74
+
71
75
  queueCell(source, options) {
72
76
  return this._native.queueCell(source, options);
73
77
  }
@@ -156,8 +160,12 @@ class Session {
156
160
  return this._native.restartKernel();
157
161
  }
158
162
 
159
- shutdownNotebook() {
160
- return this._native.shutdownNotebook();
163
+ async shutdownNotebook() {
164
+ const removed = await this._native.shutdownNotebook();
165
+ if (removed) {
166
+ await this.close();
167
+ }
168
+ return removed;
161
169
  }
162
170
 
163
171
  addDependency(pkg, options) {
@@ -198,10 +206,30 @@ class Session {
198
206
  return this._native.approveTrust(observedHeads);
199
207
  }
200
208
 
209
+ approveProjectTrust(directory) {
210
+ return this._native.approveProjectTrust(directory);
211
+ }
212
+
213
+ declineProjectTrust(directory, remember) {
214
+ return this._native.declineProjectTrust(directory, remember);
215
+ }
216
+
201
217
  syncEnvironment() {
202
218
  return this._native.syncEnvironment();
203
219
  }
204
220
 
221
+ getEnvironmentSelection() {
222
+ return this._native.getEnvironmentSelection();
223
+ }
224
+
225
+ setEnvironmentSelection(target, expectedRevision) {
226
+ return this._native.setEnvironmentSelection(target, expectedRevision);
227
+ }
228
+
229
+ applyEnvironmentSelection(expectedRevision, observedHeads) {
230
+ return this._native.applyEnvironmentSelection(expectedRevision, observedHeads);
231
+ }
232
+
205
233
  getExecutionView() {
206
234
  return this.executions.getSnapshot();
207
235
  }