@runtimed/node 0.7.0 → 0.8.0-nightly.42413490472
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 +17 -1
- package/package.json +9 -9
- package/src/binding.cjs +54 -52
- package/src/binding.d.ts +151 -0
- package/src/index.d.ts +104 -0
- package/src/relay.d.ts +22 -0
- package/src/session.cjs +24 -0
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
|
|
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.
|
|
3
|
+
"version": "0.8.0-nightly.42413490472",
|
|
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.
|
|
75
|
-
"@runtimed/node-linux-x64-gnu": "0.
|
|
76
|
-
"@runtimed/node-linux-arm64-gnu": "0.
|
|
77
|
-
"@runtimed/node-win32-x64-msvc": "0.
|
|
78
|
-
"@runtimed/node-win32-arm64-msvc": "0.
|
|
74
|
+
"@runtimed/node-darwin-arm64": "0.8.0-nightly.42413490472",
|
|
75
|
+
"@runtimed/node-linux-x64-gnu": "0.8.0-nightly.42413490472",
|
|
76
|
+
"@runtimed/node-linux-arm64-gnu": "0.8.0-nightly.42413490472",
|
|
77
|
+
"@runtimed/node-win32-x64-msvc": "0.8.0-nightly.42413490472",
|
|
78
|
+
"@runtimed/node-win32-arm64-msvc": "0.8.0-nightly.42413490472"
|
|
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": "
|
|
89
|
-
"sourceSha": "
|
|
90
|
-
"runId": "
|
|
88
|
+
"channel": "nightly",
|
|
89
|
+
"sourceSha": "6fcf623be3e4ee1ffc1abe9328e5a7aab0956c3a",
|
|
90
|
+
"runId": "42413490472"
|
|
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.
|
|
81
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
80
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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.
|
|
97
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
96
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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.
|
|
118
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
117
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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.
|
|
134
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
133
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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.
|
|
151
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
150
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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.
|
|
167
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
166
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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.
|
|
186
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
185
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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.
|
|
202
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
201
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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.
|
|
218
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
217
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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.
|
|
238
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
237
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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.
|
|
254
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
253
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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.
|
|
275
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
274
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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.
|
|
291
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
290
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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.
|
|
309
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
308
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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.
|
|
325
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
324
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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.
|
|
343
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
342
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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.
|
|
359
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
358
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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.
|
|
377
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
376
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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.
|
|
393
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
392
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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.
|
|
411
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
410
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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.
|
|
427
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
426
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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.
|
|
444
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
443
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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.
|
|
460
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
459
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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.
|
|
480
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
479
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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.
|
|
496
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
495
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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.
|
|
512
|
-
throw new Error(`Native binding package version mismatch, expected 0.
|
|
511
|
+
if (bindingPackageVersion !== '0.8.0-nightly.42413490472' && 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.42413490472 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
|
}
|
|
@@ -198,10 +202,30 @@ class Session {
|
|
|
198
202
|
return this._native.approveTrust(observedHeads);
|
|
199
203
|
}
|
|
200
204
|
|
|
205
|
+
approveProjectTrust(directory) {
|
|
206
|
+
return this._native.approveProjectTrust(directory);
|
|
207
|
+
}
|
|
208
|
+
|
|
209
|
+
declineProjectTrust(directory, remember) {
|
|
210
|
+
return this._native.declineProjectTrust(directory, remember);
|
|
211
|
+
}
|
|
212
|
+
|
|
201
213
|
syncEnvironment() {
|
|
202
214
|
return this._native.syncEnvironment();
|
|
203
215
|
}
|
|
204
216
|
|
|
217
|
+
getEnvironmentSelection() {
|
|
218
|
+
return this._native.getEnvironmentSelection();
|
|
219
|
+
}
|
|
220
|
+
|
|
221
|
+
setEnvironmentSelection(target, expectedRevision) {
|
|
222
|
+
return this._native.setEnvironmentSelection(target, expectedRevision);
|
|
223
|
+
}
|
|
224
|
+
|
|
225
|
+
applyEnvironmentSelection(expectedRevision, observedHeads) {
|
|
226
|
+
return this._native.applyEnvironmentSelection(expectedRevision, observedHeads);
|
|
227
|
+
}
|
|
228
|
+
|
|
205
229
|
getExecutionView() {
|
|
206
230
|
return this.executions.getSnapshot();
|
|
207
231
|
}
|