arcane-os 0.5.9 → 0.5.11

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.
Files changed (55) hide show
  1. package/CHANGELOG.md +28 -0
  2. package/README.md +117 -26
  3. package/browser-runtime/ai/browser-speech-providers.mjs +1 -1
  4. package/browser-runtime/ai/browser-wasm-llm-provider.mjs +63 -39
  5. package/docs/architecture.md +303 -0
  6. package/docs/compatibility.md +38 -0
  7. package/docs/event-manager.md +263 -0
  8. package/docs/platform-targets.md +104 -0
  9. package/docs/publishing.md +126 -0
  10. package/docs/reference/README.md +206 -0
  11. package/docs/reference/ai/browser-speech.md +813 -0
  12. package/docs/reference/ai/browser-wasm.md +637 -0
  13. package/docs/reference/ai/twin-cloud.md +156 -0
  14. package/docs/reference/arcane-ollama.md +288 -0
  15. package/docs/reference/availability-and-normalization.md +224 -0
  16. package/docs/reference/behavioral-testing.md +129 -0
  17. package/docs/reference/cli.md +820 -0
  18. package/docs/reference/core/README.md +61 -0
  19. package/docs/reference/core/arcane-ai-contracts.md +907 -0
  20. package/docs/reference/core/arcane-api.md +601 -0
  21. package/docs/reference/core/arcane-entities.md +59 -0
  22. package/docs/reference/core/arcane-events.md +134 -0
  23. package/docs/reference/core/ollama-module.md +181 -0
  24. package/docs/reference/core/reference/arcane-api/ai-and-ollama.md +1909 -0
  25. package/docs/reference/core/reference/arcane-api/applications-terminal-capabilities.md +1057 -0
  26. package/docs/reference/core/reference/arcane-api/core-and-events.md +320 -0
  27. package/docs/reference/core/reference/arcane-api/filesystem-storage-preferences-appearance.md +610 -0
  28. package/docs/reference/core/reference/arcane-api/namespaces.md +1157 -0
  29. package/docs/reference/core/reference/arcane-api/platform-installation-users-system.md +1423 -0
  30. package/docs/reference/core/reference/arcane-api/session-provisioning-diagnostics-development.md +315 -0
  31. package/docs/reference/event-manager.md +1409 -0
  32. package/docs/reference/inventory/package-api.json +3194 -0
  33. package/docs/reference/inventory/runtime-components.json +1015 -0
  34. package/docs/reference/inventory/runtime-entities.json +25 -0
  35. package/docs/reference/inventory/runtime-modules.json +1367 -0
  36. package/docs/reference/mail.md +309 -0
  37. package/docs/reference/protocols.md +749 -0
  38. package/docs/reference/runtime-components.md +1529 -0
  39. package/docs/reference/runtime-entities.md +305 -0
  40. package/docs/reference/runtime-modules.md +3275 -0
  41. package/docs/reference/sdk-api.md +6733 -0
  42. package/docs/roadmap.md +79 -0
  43. package/docs/work-amplification.md +66 -0
  44. package/examples/wasm-ai-demo/README.md +80 -0
  45. package/examples/wasm-ai-demo/app.js +787 -0
  46. package/examples/wasm-ai-demo/index.html +343 -0
  47. package/examples/wasm-ai-demo/profile-tools.js +217 -0
  48. package/examples/wasm-ai-demo/profiles/BOSS.Modelfile +106 -0
  49. package/examples/wasm-ai-demo/profiles/PreCrisis.Modelfile +693 -0
  50. package/examples/wasm-ai-demo/rag/boss-library.json +3006 -0
  51. package/examples/wasm-ai-demo/rag.js +295 -0
  52. package/examples/wasm-ai-demo/server.mjs +71 -0
  53. package/package.json +11 -2
  54. package/runtime/arcane/modules/AI.js +1 -1
  55. package/runtime/arcane/modules/AIProviderRuntime.js +26 -5
@@ -0,0 +1,3194 @@
1
+ {
2
+ "schemaVersion": 1,
3
+ "sdkVersion": "0.5.11",
4
+ "environment": {
5
+ "runtime": "Node.js for Node entrypoints; browser for browser-only entrypoints",
6
+ "minimumVersion": "22.23.2 for Node entrypoints",
7
+ "moduleSystem": "ESM"
8
+ },
9
+ "memberCount": 204,
10
+ "members": [
11
+ {
12
+ "id": "root:APP_BUNDLE_DESCRIPTOR_NAME",
13
+ "name": "APP_BUNDLE_DESCRIPTOR_NAME",
14
+ "displayName": "APP_BUNDLE_DESCRIPTOR_NAME",
15
+ "kind": "constant",
16
+ "signature": "const APP_BUNDLE_DESCRIPTOR_NAME",
17
+ "entrypoints": [
18
+ "arcane-os",
19
+ "arcane-os/release-bundle"
20
+ ],
21
+ "primaryImport": "arcane-os",
22
+ "group": "Packaging and release bundles",
23
+ "summary": "Canonical descriptor filename stored in an external application release bundle.",
24
+ "availability": "Node",
25
+ "protocol": "SDK packager and deterministic bundle contract",
26
+ "normalization": "Exact immutable SDK value"
27
+ },
28
+ {
29
+ "id": "root:APP_BUNDLE_EXTENSION",
30
+ "name": "APP_BUNDLE_EXTENSION",
31
+ "displayName": "APP_BUNDLE_EXTENSION",
32
+ "kind": "constant",
33
+ "signature": "const APP_BUNDLE_EXTENSION",
34
+ "entrypoints": [
35
+ "arcane-os",
36
+ "arcane-os/release-bundle"
37
+ ],
38
+ "primaryImport": "arcane-os",
39
+ "group": "Packaging and release bundles",
40
+ "summary": "Required filename extension for deterministic external application release bundles.",
41
+ "availability": "Node",
42
+ "protocol": "SDK packager and deterministic bundle contract",
43
+ "normalization": "Exact immutable SDK value"
44
+ },
45
+ {
46
+ "id": "root:APP_BUNDLE_FORMAT",
47
+ "name": "APP_BUNDLE_FORMAT",
48
+ "displayName": "APP_BUNDLE_FORMAT",
49
+ "kind": "constant",
50
+ "signature": "const APP_BUNDLE_FORMAT",
51
+ "entrypoints": [
52
+ "arcane-os",
53
+ "arcane-os/release-bundle"
54
+ ],
55
+ "primaryImport": "arcane-os",
56
+ "group": "Packaging and release bundles",
57
+ "summary": "Canonical archive encoding used by external application release bundles.",
58
+ "availability": "Node",
59
+ "protocol": "SDK packager and deterministic bundle contract",
60
+ "normalization": "Exact immutable SDK value"
61
+ },
62
+ {
63
+ "id": "root:APP_BUNDLE_KIND",
64
+ "name": "APP_BUNDLE_KIND",
65
+ "displayName": "APP_BUNDLE_KIND",
66
+ "kind": "constant",
67
+ "signature": "const APP_BUNDLE_KIND",
68
+ "entrypoints": [
69
+ "arcane-os",
70
+ "arcane-os/release-bundle"
71
+ ],
72
+ "primaryImport": "arcane-os",
73
+ "group": "Packaging and release bundles",
74
+ "summary": "Stable manifest kind identifying an Arcane application release bundle.",
75
+ "availability": "Node",
76
+ "protocol": "SDK packager and deterministic bundle contract",
77
+ "normalization": "Exact immutable SDK value"
78
+ },
79
+ {
80
+ "id": "root:APP_BUNDLE_MANIFEST_NAME",
81
+ "name": "APP_BUNDLE_MANIFEST_NAME",
82
+ "displayName": "APP_BUNDLE_MANIFEST_NAME",
83
+ "kind": "constant",
84
+ "signature": "const APP_BUNDLE_MANIFEST_NAME",
85
+ "entrypoints": [
86
+ "arcane-os",
87
+ "arcane-os/release-bundle"
88
+ ],
89
+ "primaryImport": "arcane-os",
90
+ "group": "Packaging and release bundles",
91
+ "summary": "Canonical bundle-envelope manifest filename.",
92
+ "availability": "Node",
93
+ "protocol": "SDK packager and deterministic bundle contract",
94
+ "normalization": "Exact immutable SDK value"
95
+ },
96
+ {
97
+ "id": "root:APP_BUNDLE_RELEASE_PATH",
98
+ "name": "APP_BUNDLE_RELEASE_PATH",
99
+ "displayName": "APP_BUNDLE_RELEASE_PATH",
100
+ "kind": "constant",
101
+ "signature": "const APP_BUNDLE_RELEASE_PATH",
102
+ "entrypoints": [
103
+ "arcane-os",
104
+ "arcane-os/release-bundle"
105
+ ],
106
+ "primaryImport": "arcane-os",
107
+ "group": "Packaging and release bundles",
108
+ "summary": "Canonical path of the packaged release manifest inside a bundle payload.",
109
+ "availability": "Node",
110
+ "protocol": "SDK packager and deterministic bundle contract",
111
+ "normalization": "Exact immutable SDK value"
112
+ },
113
+ {
114
+ "id": "root:APP_BUNDLE_SCHEMA_VERSION",
115
+ "name": "APP_BUNDLE_SCHEMA_VERSION",
116
+ "displayName": "APP_BUNDLE_SCHEMA_VERSION",
117
+ "kind": "constant",
118
+ "signature": "const APP_BUNDLE_SCHEMA_VERSION",
119
+ "entrypoints": [
120
+ "arcane-os",
121
+ "arcane-os/release-bundle"
122
+ ],
123
+ "primaryImport": "arcane-os",
124
+ "group": "Packaging and release bundles",
125
+ "summary": "Current immutable bundle-envelope schema version.",
126
+ "availability": "Node",
127
+ "protocol": "SDK packager and deterministic bundle contract",
128
+ "normalization": "Exact immutable SDK value"
129
+ },
130
+ {
131
+ "id": "root:APP_BUNDLE_SUPPORTED_SDK_VERSIONS",
132
+ "name": "APP_BUNDLE_SUPPORTED_SDK_VERSIONS",
133
+ "displayName": "APP_BUNDLE_SUPPORTED_SDK_VERSIONS",
134
+ "kind": "constant",
135
+ "signature": "const APP_BUNDLE_SUPPORTED_SDK_VERSIONS",
136
+ "entrypoints": [
137
+ "arcane-os/release-bundle"
138
+ ],
139
+ "primaryImport": "arcane-os/release-bundle",
140
+ "group": "Packaging and release bundles",
141
+ "summary": "Exact SDK generations accepted by this bundle verifier.",
142
+ "availability": "Node",
143
+ "protocol": "SDK packager and deterministic bundle contract",
144
+ "normalization": "Exact immutable SDK value"
145
+ },
146
+ {
147
+ "id": "root:APP_CONFIG_NAME",
148
+ "name": "APP_CONFIG_NAME",
149
+ "displayName": "APP_CONFIG_NAME",
150
+ "kind": "constant",
151
+ "signature": "const APP_CONFIG_NAME",
152
+ "entrypoints": [
153
+ "arcane-os/packager"
154
+ ],
155
+ "primaryImport": "arcane-os/packager",
156
+ "group": "Packaging and release bundles",
157
+ "summary": "Canonical schema-1 application package configuration filename used by the packager.",
158
+ "availability": "Node",
159
+ "protocol": "SDK packager and deterministic bundle contract",
160
+ "normalization": "Exact immutable SDK value"
161
+ },
162
+ {
163
+ "id": "root:APP_DESCRIPTOR_NAME",
164
+ "name": "APP_DESCRIPTOR_NAME",
165
+ "displayName": "APP_DESCRIPTOR_NAME",
166
+ "kind": "constant",
167
+ "signature": "const APP_DESCRIPTOR_NAME",
168
+ "entrypoints": [
169
+ "arcane-os"
170
+ ],
171
+ "primaryImport": "arcane-os",
172
+ "group": "Runtime and app descriptors",
173
+ "summary": "Canonical schema-2 application descriptor filename.",
174
+ "availability": "Node",
175
+ "protocol": "Node ESM",
176
+ "normalization": "Exact immutable SDK value"
177
+ },
178
+ {
179
+ "id": "root:APP_DESCRIPTOR_SCHEMA_VERSION",
180
+ "name": "APP_DESCRIPTOR_SCHEMA_VERSION",
181
+ "displayName": "APP_DESCRIPTOR_SCHEMA_VERSION",
182
+ "kind": "constant",
183
+ "signature": "const APP_DESCRIPTOR_SCHEMA_VERSION",
184
+ "entrypoints": [
185
+ "arcane-os"
186
+ ],
187
+ "primaryImport": "arcane-os",
188
+ "group": "Runtime and app descriptors",
189
+ "summary": "Current authored application descriptor schema version.",
190
+ "availability": "Node",
191
+ "protocol": "Node ESM",
192
+ "normalization": "Exact immutable SDK value"
193
+ },
194
+ {
195
+ "id": "root:ARCANE_INTEGRATED_PROVIDER_RELATIVE_PATH",
196
+ "name": "ARCANE_INTEGRATED_PROVIDER_RELATIVE_PATH",
197
+ "displayName": "ARCANE_INTEGRATED_PROVIDER_RELATIVE_PATH",
198
+ "kind": "constant",
199
+ "signature": "const ARCANE_INTEGRATED_PROVIDER_RELATIVE_PATH",
200
+ "entrypoints": [
201
+ "arcane-os",
202
+ "arcane-os/integrated-provider"
203
+ ],
204
+ "primaryImport": "arcane-os",
205
+ "group": "Targets, native plans, and providers",
206
+ "summary": "Frozen repository-relative path of Arcane OS's integrated shared-development provider.",
207
+ "availability": "Node; selected browser/native target or provider as documented",
208
+ "protocol": "arcane-target-adapter/1, arcane-native-build-plan/1, or provider protocol",
209
+ "normalization": "Exact immutable SDK value"
210
+ },
211
+ {
212
+ "id": "root:ARCANE_MACHINE_BUNDLE_VERSION",
213
+ "name": "ARCANE_MACHINE_BUNDLE_VERSION",
214
+ "displayName": "ARCANE_MACHINE_BUNDLE_VERSION",
215
+ "kind": "constant",
216
+ "signature": "const ARCANE_MACHINE_BUNDLE_VERSION",
217
+ "entrypoints": [
218
+ "arcane-os"
219
+ ],
220
+ "primaryImport": "arcane-os",
221
+ "group": "Identity and protocol constants",
222
+ "summary": "Exact Arcane machine-bundle generation paired with this SDK runtime.",
223
+ "availability": "Node",
224
+ "protocol": "Node ESM",
225
+ "normalization": "Exact immutable SDK value"
226
+ },
227
+ {
228
+ "id": "root:ARCANE_NATIVE_PROVIDER_PATHS",
229
+ "name": "ARCANE_NATIVE_PROVIDER_PATHS",
230
+ "displayName": "ARCANE_NATIVE_PROVIDER_PATHS",
231
+ "kind": "constant",
232
+ "signature": "const ARCANE_NATIVE_PROVIDER_PATHS",
233
+ "entrypoints": [
234
+ "arcane-os",
235
+ "arcane-os/native-provider"
236
+ ],
237
+ "primaryImport": "arcane-os",
238
+ "group": "Targets, native plans, and providers",
239
+ "summary": "Frozen target-to-provider path registry for native development providers.",
240
+ "availability": "Node; selected browser/native target or provider as documented",
241
+ "protocol": "arcane-target-adapter/1, arcane-native-build-plan/1, or provider protocol",
242
+ "normalization": "Exact immutable SDK value"
243
+ },
244
+ {
245
+ "id": "root:ARCANE_PROTOCOL",
246
+ "name": "ARCANE_PROTOCOL",
247
+ "displayName": "ARCANE_PROTOCOL",
248
+ "kind": "constant",
249
+ "signature": "const ARCANE_PROTOCOL",
250
+ "entrypoints": [
251
+ "arcane-os"
252
+ ],
253
+ "primaryImport": "arcane-os",
254
+ "group": "Identity and protocol constants",
255
+ "summary": "Application-facing Arcane bridge protocol required by this SDK.",
256
+ "availability": "Node",
257
+ "protocol": "Node ESM",
258
+ "normalization": "Exact immutable SDK value"
259
+ },
260
+ {
261
+ "id": "root:ARCANE_UPSTREAM_REPOSITORY",
262
+ "name": "ARCANE_UPSTREAM_REPOSITORY",
263
+ "displayName": "ARCANE_UPSTREAM_REPOSITORY",
264
+ "kind": "constant",
265
+ "signature": "const ARCANE_UPSTREAM_REPOSITORY",
266
+ "entrypoints": [
267
+ "arcane-os"
268
+ ],
269
+ "primaryImport": "arcane-os",
270
+ "group": "Identity and protocol constants",
271
+ "summary": "Canonical upstream Arcane OS repository URL.",
272
+ "availability": "Node",
273
+ "protocol": "Node ESM",
274
+ "normalization": "Exact immutable SDK value"
275
+ },
276
+ {
277
+ "id": "root:ArcaneError",
278
+ "name": "ArcaneError",
279
+ "displayName": "ArcaneError",
280
+ "kind": "class",
281
+ "signature": "new ArcaneError(code, message, {details, cause, exitCode}={})",
282
+ "entrypoints": [
283
+ "arcane-os"
284
+ ],
285
+ "primaryImport": "arcane-os",
286
+ "group": "Errors",
287
+ "summary": "Normalized SDK error class carrying a stable code, human message, optional resolution details, cause, and exit status.",
288
+ "availability": "Node",
289
+ "protocol": "Node ESM",
290
+ "normalization": "ArcaneError and JSON-safe error normalization"
291
+ },
292
+ {
293
+ "id": "root:assertIntegratedNativeToolchain",
294
+ "name": "assertIntegratedNativeToolchain",
295
+ "displayName": "assertIntegratedNativeToolchain()",
296
+ "kind": "function",
297
+ "signature": "assertIntegratedNativeToolchain({workspaceMode, workspaceRoot, toolchainRoot, target}={})",
298
+ "entrypoints": [
299
+ "arcane-os",
300
+ "arcane-os/toolchain"
301
+ ],
302
+ "primaryImport": "arcane-os",
303
+ "group": "Targets, native plans, and providers",
304
+ "summary": "Requires an integrated workspace and selected native toolchain root to resolve to the same canonical Arcane checkout.",
305
+ "availability": "Node; selected browser/native target or provider as documented",
306
+ "protocol": "arcane-target-adapter/1, arcane-native-build-plan/1, or provider protocol",
307
+ "normalization": "Normalized complete plan and result; target-specific artifact detail preserved"
308
+ },
309
+ {
310
+ "id": "root:assessArcaneOllama",
311
+ "name": "assessArcaneOllama",
312
+ "displayName": "assessArcaneOllama()",
313
+ "kind": "function",
314
+ "signature": "async assessArcaneOllama({ signal, onEvent, platform=process.platform, run=runProcess, fileExists=exists }={})",
315
+ "entrypoints": [
316
+ "arcane-os"
317
+ ],
318
+ "primaryImport": "arcane-os",
319
+ "group": "Workspace, doctor, repository, and server",
320
+ "summary": "Performs a read-only Microsoft NT assessment of the managed ArcaneOllama service and reports unsupported hosts honestly.",
321
+ "availability": "Node; Microsoft NT managed-service assessment",
322
+ "protocol": "Node ESM",
323
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
324
+ },
325
+ {
326
+ "id": "root:buildApplication",
327
+ "name": "buildApplication",
328
+ "displayName": "buildApplication()",
329
+ "kind": "function",
330
+ "signature": "async buildApplication(options={})",
331
+ "entrypoints": [
332
+ "arcane-os",
333
+ "arcane-os/toolchain"
334
+ ],
335
+ "primaryImport": "arcane-os",
336
+ "group": "Headless toolchain operations",
337
+ "summary": "Packages the selected app and builds one explicitly selected target; tests or checks run only when explicitly requested or required for the selected release output.",
338
+ "availability": "Node; selected operation may produce browser or native output",
339
+ "protocol": "Shared headless operation API + arcane-cli-events/1",
340
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
341
+ },
342
+ {
343
+ "id": "root:buildTarget",
344
+ "name": "buildTarget",
345
+ "displayName": "buildTarget()",
346
+ "kind": "function",
347
+ "signature": "async buildTarget(options={})",
348
+ "entrypoints": [
349
+ "arcane-os",
350
+ "arcane-os/targets"
351
+ ],
352
+ "primaryImport": "arcane-os",
353
+ "group": "Targets, native plans, and providers",
354
+ "summary": "Invokes one target adapter build with explicit app, target, and artifact inputs.",
355
+ "availability": "Node; selected browser/native target or provider as documented",
356
+ "protocol": "arcane-target-adapter/1, arcane-native-build-plan/1, or provider protocol",
357
+ "normalization": "Normalized complete plan and result; target-specific artifact detail preserved"
358
+ },
359
+ {
360
+ "id": "root:bumpVersion",
361
+ "name": "bumpVersion",
362
+ "displayName": "bumpVersion()",
363
+ "kind": "function",
364
+ "signature": "async bumpVersion(options)",
365
+ "entrypoints": [
366
+ "arcane-os/packager"
367
+ ],
368
+ "primaryImport": "arcane-os/packager",
369
+ "group": "Packaging and release bundles",
370
+ "summary": "Updates one selected app version with a validated semantic-version bump through the packager boundary.",
371
+ "availability": "Node",
372
+ "protocol": "SDK packager and deterministic bundle contract",
373
+ "normalization": "Normalized SDK validation with complete canonical archive and release content"
374
+ },
375
+ {
376
+ "id": "root:bundleApplication",
377
+ "name": "bundleApplication",
378
+ "displayName": "bundleApplication()",
379
+ "kind": "function",
380
+ "signature": "async bundleApplication(options={})",
381
+ "entrypoints": [
382
+ "arcane-os",
383
+ "arcane-os/toolchain"
384
+ ],
385
+ "primaryImport": "arcane-os",
386
+ "group": "Headless toolchain operations",
387
+ "summary": "Creates one deterministic external application bundle from one authenticated packaged release.",
388
+ "availability": "Node; selected operation may produce browser or native output",
389
+ "protocol": "Shared headless operation API + arcane-cli-events/1",
390
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
391
+ },
392
+ {
393
+ "id": "root:checkApplication",
394
+ "name": "checkApplication",
395
+ "displayName": "checkApplication()",
396
+ "kind": "function",
397
+ "signature": "async checkApplication(options={})",
398
+ "entrypoints": [
399
+ "arcane-os",
400
+ "arcane-os/toolchain"
401
+ ],
402
+ "primaryImport": "arcane-os",
403
+ "group": "Headless toolchain operations",
404
+ "summary": "Runs the selected application or integrated shared validation boundary.",
405
+ "availability": "Node; selected operation may produce browser or native output",
406
+ "protocol": "Shared headless operation API + arcane-cli-events/1",
407
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
408
+ },
409
+ {
410
+ "id": "root:CLI_EVENT_PROTOCOL",
411
+ "name": "CLI_EVENT_PROTOCOL",
412
+ "displayName": "CLI_EVENT_PROTOCOL",
413
+ "kind": "constant",
414
+ "signature": "const CLI_EVENT_PROTOCOL",
415
+ "entrypoints": [
416
+ "arcane-os"
417
+ ],
418
+ "primaryImport": "arcane-os",
419
+ "group": "Identity and protocol constants",
420
+ "summary": "Version identifier for normalized CLI JSON and NDJSON event envelopes.",
421
+ "availability": "Node",
422
+ "protocol": "Node ESM",
423
+ "normalization": "Exact immutable SDK value"
424
+ },
425
+ {
426
+ "id": "root:CLI_NAME",
427
+ "name": "CLI_NAME",
428
+ "displayName": "CLI_NAME",
429
+ "kind": "constant",
430
+ "signature": "const CLI_NAME",
431
+ "entrypoints": [
432
+ "arcane-os"
433
+ ],
434
+ "primaryImport": "arcane-os",
435
+ "group": "Identity and protocol constants",
436
+ "summary": "Primary command name presented by the SDK.",
437
+ "availability": "Node",
438
+ "protocol": "Node ESM",
439
+ "normalization": "Exact immutable SDK value"
440
+ },
441
+ {
442
+ "id": "root:createApplication",
443
+ "name": "createApplication",
444
+ "displayName": "createApplication()",
445
+ "kind": "function",
446
+ "signature": "async createApplication(options={})",
447
+ "entrypoints": [
448
+ "arcane-os",
449
+ "arcane-os/toolchain"
450
+ ],
451
+ "primaryImport": "arcane-os",
452
+ "group": "Headless toolchain operations",
453
+ "summary": "Creates one new external application workspace through the shared headless toolchain.",
454
+ "availability": "Node; selected operation may produce browser or native output",
455
+ "protocol": "Shared headless operation API + arcane-cli-events/1",
456
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
457
+ },
458
+ {
459
+ "id": "root:createAppReleaseBundle",
460
+ "name": "createAppReleaseBundle",
461
+ "displayName": "createAppReleaseBundle()",
462
+ "kind": "function",
463
+ "signature": "async createAppReleaseBundle({ receipt, releaseRoot, outputPath, overwrite=false, signal, onEvent }={})",
464
+ "entrypoints": [
465
+ "arcane-os",
466
+ "arcane-os/release-bundle"
467
+ ],
468
+ "primaryImport": "arcane-os",
469
+ "group": "Packaging and release bundles",
470
+ "summary": "Writes one deterministic USTAR+gzip external application bundle from the selected authored release state.",
471
+ "availability": "Node",
472
+ "protocol": "SDK packager and deterministic bundle contract",
473
+ "normalization": "Normalized SDK validation with complete canonical archive and release content"
474
+ },
475
+ {
476
+ "id": "root:createCanonicalUstarHeader",
477
+ "name": "createCanonicalUstarHeader",
478
+ "displayName": "createCanonicalUstarHeader()",
479
+ "kind": "function",
480
+ "signature": "createCanonicalUstarHeader(entryPath, size)",
481
+ "entrypoints": [
482
+ "arcane-os",
483
+ "arcane-os/release-bundle"
484
+ ],
485
+ "primaryImport": "arcane-os",
486
+ "group": "Packaging and release bundles",
487
+ "summary": "Builds the exact 512-byte canonical USTAR header for one validated bundle entry.",
488
+ "availability": "Node",
489
+ "protocol": "SDK packager and deterministic bundle contract",
490
+ "normalization": "Normalized SDK validation with complete canonical archive and release content"
491
+ },
492
+ {
493
+ "id": "root:createNativeBuildPlan",
494
+ "name": "createNativeBuildPlan",
495
+ "displayName": "createNativeBuildPlan()",
496
+ "kind": "function",
497
+ "signature": "async createNativeBuildPlan({ nativeBuilder, toolchainRoot, toolchainReceipt, appReleaseRoot, appReleaseReceipt, appDescriptor, dependencyReleases=[], providerGeneration, minimumCoreVersion, protectedRoots=[], outputRoot, targetRequest, signal, onEvent }={})",
498
+ "entrypoints": [
499
+ "arcane-os",
500
+ "arcane-os/native"
501
+ ],
502
+ "primaryImport": "arcane-os",
503
+ "group": "Targets, native plans, and providers",
504
+ "summary": "Creates one immutable, authenticated, single-attempt native plan binding app, dependencies, toolchain, request, and output roots.",
505
+ "availability": "Node; selected browser/native target or provider as documented",
506
+ "protocol": "arcane-target-adapter/1, arcane-native-build-plan/1, or provider protocol",
507
+ "normalization": "Normalized complete plan and result; target-specific artifact detail preserved"
508
+ },
509
+ {
510
+ "id": "root:createNativeTargetAdapter",
511
+ "name": "createNativeTargetAdapter",
512
+ "displayName": "createNativeTargetAdapter()",
513
+ "kind": "function",
514
+ "signature": "createNativeTargetAdapter({targetId, nativeBuilder}={})",
515
+ "entrypoints": [
516
+ "arcane-os",
517
+ "arcane-os/targets"
518
+ ],
519
+ "primaryImport": "arcane-os",
520
+ "group": "Targets, native plans, and providers",
521
+ "summary": "Adapts one validated native builder to the common target-adapter contract.",
522
+ "availability": "Node; selected browser/native target or provider as documented",
523
+ "protocol": "arcane-target-adapter/1, arcane-native-build-plan/1, or provider protocol",
524
+ "normalization": "Normalized complete plan and result; target-specific artifact detail preserved"
525
+ },
526
+ {
527
+ "id": "root:createReporter",
528
+ "name": "createReporter",
529
+ "displayName": "createReporter()",
530
+ "kind": "function",
531
+ "signature": "createReporter({ command, output='human', stdout=process.stdout, stderr=process.stderr, operationId=randomUUID(), clock=()=>new Date() }={})",
532
+ "entrypoints": [
533
+ "arcane-os",
534
+ "arcane-os/events"
535
+ ],
536
+ "primaryImport": "arcane-os",
537
+ "group": "Events, processes, and testing",
538
+ "summary": "Creates the ordered CLI reporter that normalizes accepted, progress, terminal, JSON, and NDJSON event delivery.",
539
+ "availability": "Node",
540
+ "protocol": "arcane-cli-events/1",
541
+ "normalization": "SDK event/error/report normalization"
542
+ },
543
+ {
544
+ "id": "root:createToolchain",
545
+ "name": "createToolchain",
546
+ "displayName": "createToolchain()",
547
+ "kind": "function",
548
+ "signature": "createToolchain(defaults={})",
549
+ "entrypoints": [
550
+ "arcane-os",
551
+ "arcane-os/toolchain"
552
+ ],
553
+ "primaryImport": "arcane-os",
554
+ "group": "Headless toolchain operations",
555
+ "summary": "Returns a frozen convenience object that applies shared defaults to every headless application operation.",
556
+ "availability": "Node; selected operation may produce browser or native output",
557
+ "protocol": "Shared headless operation API + arcane-cli-events/1",
558
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
559
+ },
560
+ {
561
+ "id": "root:createWorkspace",
562
+ "name": "createWorkspace",
563
+ "displayName": "createWorkspace()",
564
+ "kind": "function",
565
+ "signature": "async createWorkspace({ targetPath, appId, displayName, target='browser', initializeGit=false, signal, onEvent })",
566
+ "entrypoints": [
567
+ "arcane-os"
568
+ ],
569
+ "primaryImport": "arcane-os",
570
+ "group": "Workspace, doctor, repository, and server",
571
+ "summary": "Scaffolds one new external repository-shaped workspace and one selected application.",
572
+ "availability": "Node",
573
+ "protocol": "Node ESM",
574
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
575
+ },
576
+ {
577
+ "id": "root:default",
578
+ "name": "default",
579
+ "displayName": "default()",
580
+ "kind": "function",
581
+ "signature": "default(name, optionsOrCallback, maybeCallback)",
582
+ "entrypoints": [
583
+ "arcane-os/testing"
584
+ ],
585
+ "primaryImport": "arcane-os/testing",
586
+ "group": "Events, processes, and testing",
587
+ "summary": "Default-export alias of the public `test` registration function.",
588
+ "availability": "Node",
589
+ "protocol": "Node ESM / owned process or test lifecycle",
590
+ "normalization": "SDK event/error/report normalization"
591
+ },
592
+ {
593
+ "id": "root:DEFAULT_TEST_TIMEOUT_MS",
594
+ "name": "DEFAULT_TEST_TIMEOUT_MS",
595
+ "displayName": "DEFAULT_TEST_TIMEOUT_MS",
596
+ "kind": "constant",
597
+ "signature": "const DEFAULT_TEST_TIMEOUT_MS",
598
+ "entrypoints": [
599
+ "arcane-os",
600
+ "arcane-os/testing"
601
+ ],
602
+ "primaryImport": "arcane-os",
603
+ "group": "Events, processes, and testing",
604
+ "summary": "Default timeout applied by the public isolated test API.",
605
+ "availability": "Node",
606
+ "protocol": "Node ESM / owned process or test lifecycle",
607
+ "normalization": "Exact immutable SDK value"
608
+ },
609
+ {
610
+ "id": "root:describeTargets",
611
+ "name": "describeTargets",
612
+ "displayName": "describeTargets()",
613
+ "kind": "function",
614
+ "signature": "async describeTargets(options={})",
615
+ "entrypoints": [
616
+ "arcane-os",
617
+ "arcane-os/toolchain"
618
+ ],
619
+ "primaryImport": "arcane-os",
620
+ "group": "Headless toolchain operations",
621
+ "summary": "Returns the normalized target catalog through the headless operation lifecycle.",
622
+ "availability": "Node; selected operation may produce browser or native output",
623
+ "protocol": "Shared headless operation API + arcane-cli-events/1",
624
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
625
+ },
626
+ {
627
+ "id": "root:developApplication",
628
+ "name": "developApplication",
629
+ "displayName": "developApplication()",
630
+ "kind": "function",
631
+ "signature": "async developApplication(options={})",
632
+ "entrypoints": [
633
+ "arcane-os",
634
+ "arcane-os/toolchain"
635
+ ],
636
+ "primaryImport": "arcane-os",
637
+ "group": "Headless toolchain operations",
638
+ "summary": "Starts one owned browser development server for the selected application.",
639
+ "availability": "Node; selected operation may produce browser or native output",
640
+ "protocol": "Shared headless operation API + arcane-cli-events/1",
641
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
642
+ },
643
+ {
644
+ "id": "root:discoverPackagerApps",
645
+ "name": "discoverPackagerApps",
646
+ "displayName": "discoverPackagerApps()",
647
+ "kind": "function",
648
+ "signature": "async discoverPackagerApps({workspaceRoot:requestedWorkspaceRoot})",
649
+ "entrypoints": [
650
+ "arcane-os"
651
+ ],
652
+ "primaryImport": "arcane-os",
653
+ "group": "Packaging and release bundles",
654
+ "summary": "Root-entry alias for the packager-specific application discovery function.",
655
+ "availability": "Node",
656
+ "protocol": "SDK packager and deterministic bundle contract",
657
+ "normalization": "Normalized SDK validation with complete canonical archive and release content"
658
+ },
659
+ {
660
+ "id": "root:doctorApplication",
661
+ "name": "doctorApplication",
662
+ "displayName": "doctorApplication()",
663
+ "kind": "function",
664
+ "signature": "async doctorApplication(options={})",
665
+ "entrypoints": [
666
+ "arcane-os",
667
+ "arcane-os/toolchain"
668
+ ],
669
+ "primaryImport": "arcane-os",
670
+ "group": "Workspace, doctor, repository, and server",
671
+ "summary": "Runs the read-only SDK/runtime/workspace and optional local-AI diagnostic operation.",
672
+ "availability": "Node",
673
+ "protocol": "Node ESM",
674
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
675
+ },
676
+ {
677
+ "id": "root:doctorNativeTarget",
678
+ "name": "doctorNativeTarget",
679
+ "displayName": "doctorNativeTarget()",
680
+ "kind": "function",
681
+ "signature": "async doctorNativeTarget(options={})",
682
+ "entrypoints": [
683
+ "arcane-os",
684
+ "arcane-os/toolchain"
685
+ ],
686
+ "primaryImport": "arcane-os",
687
+ "group": "Targets, native plans, and providers",
688
+ "summary": "Loads and diagnoses one explicit native provider and target without building an application.",
689
+ "availability": "Node; selected browser/native target or provider as documented",
690
+ "protocol": "arcane-target-adapter/1, arcane-native-build-plan/1, or provider protocol",
691
+ "normalization": "Normalized complete plan and result; target-specific artifact detail preserved"
692
+ },
693
+ {
694
+ "id": "root:ERROR_CODES",
695
+ "name": "ERROR_CODES",
696
+ "displayName": "ERROR_CODES",
697
+ "kind": "constant",
698
+ "signature": "const ERROR_CODES",
699
+ "entrypoints": [
700
+ "arcane-os"
701
+ ],
702
+ "primaryImport": "arcane-os",
703
+ "group": "Errors",
704
+ "summary": "Frozen registry of stable SDK error-code strings.",
705
+ "availability": "Node",
706
+ "protocol": "Node ESM",
707
+ "normalization": "Exact immutable SDK value"
708
+ },
709
+ {
710
+ "id": "root:errorRecord",
711
+ "name": "errorRecord",
712
+ "displayName": "errorRecord()",
713
+ "kind": "function",
714
+ "signature": "errorRecord(error)",
715
+ "entrypoints": [
716
+ "arcane-os"
717
+ ],
718
+ "primaryImport": "arcane-os",
719
+ "group": "Errors",
720
+ "summary": "Projects an error into the JSON-safe normalized public error record.",
721
+ "availability": "Node",
722
+ "protocol": "Node ESM",
723
+ "normalization": "ArcaneError and JSON-safe error normalization"
724
+ },
725
+ {
726
+ "id": "root:executeNativeBuildPlan",
727
+ "name": "executeNativeBuildPlan",
728
+ "displayName": "executeNativeBuildPlan()",
729
+ "kind": "function",
730
+ "signature": "async executeNativeBuildPlan(plan, { expectedNativeBuilder, expectedTarget, signal, onEvent }={})",
731
+ "entrypoints": [
732
+ "arcane-os",
733
+ "arcane-os/native"
734
+ ],
735
+ "primaryImport": "arcane-os",
736
+ "group": "Targets, native plans, and providers",
737
+ "summary": "Consumes one authenticated single-attempt native plan through its bound builder and event/cancellation lifecycle.",
738
+ "availability": "Node; selected browser/native target or provider as documented",
739
+ "protocol": "arcane-target-adapter/1, arcane-native-build-plan/1, or provider protocol",
740
+ "normalization": "Normalized complete plan and result; target-specific artifact detail preserved"
741
+ },
742
+ {
743
+ "id": "root:executeOperation",
744
+ "name": "executeOperation",
745
+ "displayName": "executeOperation()",
746
+ "kind": "function",
747
+ "signature": "async executeOperation(command, options={})",
748
+ "entrypoints": [
749
+ "arcane-os",
750
+ "arcane-os/toolchain"
751
+ ],
752
+ "primaryImport": "arcane-os",
753
+ "group": "Headless toolchain operations",
754
+ "summary": "Dispatches one named headless SDK operation with normalized acceptance, events, cancellation, and failure.",
755
+ "availability": "Node; selected operation may produce browser or native output",
756
+ "protocol": "Shared headless operation API + arcane-cli-events/1",
757
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
758
+ },
759
+ {
760
+ "id": "root:fail",
761
+ "name": "fail",
762
+ "displayName": "fail()",
763
+ "kind": "function",
764
+ "signature": "fail(code, message, options)",
765
+ "entrypoints": [
766
+ "arcane-os"
767
+ ],
768
+ "primaryImport": "arcane-os",
769
+ "group": "Errors",
770
+ "summary": "Throws a normalized `ArcaneError` with the supplied code and context.",
771
+ "availability": "Node",
772
+ "protocol": "Node ESM",
773
+ "normalization": "ArcaneError and JSON-safe error normalization"
774
+ },
775
+ {
776
+ "id": "root:getSdkBrowserRuntimeRoot",
777
+ "name": "getSdkBrowserRuntimeRoot",
778
+ "displayName": "getSdkBrowserRuntimeRoot()",
779
+ "kind": "function",
780
+ "signature": "getSdkBrowserRuntimeRoot()",
781
+ "entrypoints": [
782
+ "arcane-os"
783
+ ],
784
+ "primaryImport": "arcane-os",
785
+ "group": "Runtime and app descriptors",
786
+ "summary": "Returns the absolute SDK browser-runtime root.",
787
+ "availability": "Node",
788
+ "protocol": "Node ESM",
789
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
790
+ },
791
+ {
792
+ "id": "root:getSdkRoot",
793
+ "name": "getSdkRoot",
794
+ "displayName": "getSdkRoot()",
795
+ "kind": "function",
796
+ "signature": "getSdkRoot()",
797
+ "entrypoints": [
798
+ "arcane-os"
799
+ ],
800
+ "primaryImport": "arcane-os",
801
+ "group": "Runtime and app descriptors",
802
+ "summary": "Returns the absolute installed SDK package root.",
803
+ "availability": "Node",
804
+ "protocol": "Node ESM",
805
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
806
+ },
807
+ {
808
+ "id": "root:getTargetAdapter",
809
+ "name": "getTargetAdapter",
810
+ "displayName": "getTargetAdapter()",
811
+ "kind": "function",
812
+ "signature": "getTargetAdapter(targetId)",
813
+ "entrypoints": [
814
+ "arcane-os",
815
+ "arcane-os/targets"
816
+ ],
817
+ "primaryImport": "arcane-os",
818
+ "group": "Targets, native plans, and providers",
819
+ "summary": "Returns the registered adapter for one exact target id or fails for an unknown target.",
820
+ "availability": "Node; selected browser/native target or provider as documented",
821
+ "protocol": "arcane-target-adapter/1, arcane-native-build-plan/1, or provider protocol",
822
+ "normalization": "Normalized complete plan and result; target-specific artifact detail preserved"
823
+ },
824
+ {
825
+ "id": "root:incrementSemver",
826
+ "name": "incrementSemver",
827
+ "displayName": "incrementSemver()",
828
+ "kind": "function",
829
+ "signature": "incrementSemver(value, bump, preid)",
830
+ "entrypoints": [
831
+ "arcane-os/packager"
832
+ ],
833
+ "primaryImport": "arcane-os/packager",
834
+ "group": "Packaging and release bundles",
835
+ "summary": "Returns a validated semantic version incremented by the requested bump and optional prerelease id.",
836
+ "availability": "Node",
837
+ "protocol": "SDK packager and deterministic bundle contract",
838
+ "normalization": "Normalized SDK validation with complete canonical archive and release content"
839
+ },
840
+ {
841
+ "id": "root:initializeApplication",
842
+ "name": "initializeApplication",
843
+ "displayName": "initializeApplication()",
844
+ "kind": "function",
845
+ "signature": "async initializeApplication(options={})",
846
+ "entrypoints": [
847
+ "arcane-os",
848
+ "arcane-os/toolchain"
849
+ ],
850
+ "primaryImport": "arcane-os",
851
+ "group": "Workspace, doctor, repository, and server",
852
+ "summary": "Initializes missing Arcane files for one app in an existing external or integrated workspace.",
853
+ "availability": "Node",
854
+ "protocol": "Node ESM",
855
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
856
+ },
857
+ {
858
+ "id": "root:initWorkspace",
859
+ "name": "initWorkspace",
860
+ "displayName": "initWorkspace()",
861
+ "kind": "function",
862
+ "signature": "async initWorkspace({ workspaceRoot=process.cwd(), appId, displayName, target='browser', signal, onEvent })",
863
+ "entrypoints": [
864
+ "arcane-os"
865
+ ],
866
+ "primaryImport": "arcane-os",
867
+ "group": "Workspace, doctor, repository, and server",
868
+ "summary": "Adds one application scaffold to an existing workspace without overwriting incompatible files.",
869
+ "availability": "Node",
870
+ "protocol": "Node ESM",
871
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
872
+ },
873
+ {
874
+ "id": "root:inspectApp",
875
+ "name": "inspectApp",
876
+ "displayName": "inspectApp()",
877
+ "kind": "function",
878
+ "signature": "async inspectApp({workspaceRoot, appId, signal}={})",
879
+ "entrypoints": [
880
+ "arcane-os",
881
+ "arcane-os/packager"
882
+ ],
883
+ "primaryImport": "arcane-os",
884
+ "group": "Packaging and release bundles",
885
+ "summary": "Loads one validated packager app plan, including the shared descriptor-admitted browser document inventory.",
886
+ "availability": "Node",
887
+ "protocol": "SDK packager and deterministic bundle contract",
888
+ "normalization": "Normalized SDK validation with complete canonical archive and release content"
889
+ },
890
+ {
891
+ "id": "root:inspectWorkspaceProfile",
892
+ "name": "inspectWorkspaceProfile",
893
+ "displayName": "inspectWorkspaceProfile()",
894
+ "kind": "function",
895
+ "signature": "async inspectWorkspaceProfile(workspaceRoot=process.cwd())",
896
+ "entrypoints": [
897
+ "arcane-os"
898
+ ],
899
+ "primaryImport": "arcane-os",
900
+ "group": "Workspace, doctor, repository, and server",
901
+ "summary": "Classifies one canonical workspace as external or integrated and reports its fixed layout.",
902
+ "availability": "Node",
903
+ "protocol": "Node ESM",
904
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
905
+ },
906
+ {
907
+ "id": "root:INTEGRATED_TOOLCHAIN_PROTOCOL",
908
+ "name": "INTEGRATED_TOOLCHAIN_PROTOCOL",
909
+ "displayName": "INTEGRATED_TOOLCHAIN_PROTOCOL",
910
+ "kind": "constant",
911
+ "signature": "const INTEGRATED_TOOLCHAIN_PROTOCOL",
912
+ "entrypoints": [
913
+ "arcane-os",
914
+ "arcane-os/integrated-provider"
915
+ ],
916
+ "primaryImport": "arcane-os",
917
+ "group": "Targets, native plans, and providers",
918
+ "summary": "Protocol required from the fixed integrated shared-development provider.",
919
+ "availability": "Node; selected browser/native target or provider as documented",
920
+ "protocol": "arcane-target-adapter/1, arcane-native-build-plan/1, or provider protocol",
921
+ "normalization": "Exact immutable SDK value"
922
+ },
923
+ {
924
+ "id": "root:listTargets",
925
+ "name": "listTargets",
926
+ "displayName": "listTargets()",
927
+ "kind": "function",
928
+ "signature": "listTargets()",
929
+ "entrypoints": [
930
+ "arcane-os",
931
+ "arcane-os/targets"
932
+ ],
933
+ "primaryImport": "arcane-os",
934
+ "group": "Targets, native plans, and providers",
935
+ "summary": "Returns the frozen target descriptors without running an operation lifecycle.",
936
+ "availability": "Node; selected browser/native target or provider as documented",
937
+ "protocol": "arcane-target-adapter/1, arcane-native-build-plan/1, or provider protocol",
938
+ "normalization": "Normalized complete plan and result; target-specific artifact detail preserved"
939
+ },
940
+ {
941
+ "id": "root:loadAppDescriptor",
942
+ "name": "loadAppDescriptor",
943
+ "displayName": "loadAppDescriptor()",
944
+ "kind": "function",
945
+ "signature": "async loadAppDescriptor({workspaceRoot, appRoot, appId, packageManifest})",
946
+ "entrypoints": [
947
+ "arcane-os"
948
+ ],
949
+ "primaryImport": "arcane-os",
950
+ "group": "Runtime and app descriptors",
951
+ "summary": "Loads an authored schema-2 descriptor or a complete package/registry projection with its source label.",
952
+ "availability": "Node",
953
+ "protocol": "Node ESM",
954
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
955
+ },
956
+ {
957
+ "id": "root:loadArcaneIntegratedProvider",
958
+ "name": "loadArcaneIntegratedProvider",
959
+ "displayName": "loadArcaneIntegratedProvider()",
960
+ "kind": "function",
961
+ "signature": "loadArcaneIntegratedProvider({ arcaneRoot, signal, onEvent, run=runProcess }={})",
962
+ "entrypoints": [
963
+ "arcane-os",
964
+ "arcane-os/integrated-provider"
965
+ ],
966
+ "primaryImport": "arcane-os",
967
+ "group": "Targets, native plans, and providers",
968
+ "summary": "Loads and authenticates the fixed Arcane-owned integrated development provider generation.",
969
+ "availability": "Node; selected browser/native target or provider as documented",
970
+ "protocol": "arcane-target-adapter/1, arcane-native-build-plan/1, or provider protocol",
971
+ "normalization": "Normalized complete plan and result; target-specific artifact detail preserved"
972
+ },
973
+ {
974
+ "id": "root:loadArcaneNativeProvider",
975
+ "name": "loadArcaneNativeProvider",
976
+ "displayName": "loadArcaneNativeProvider()",
977
+ "kind": "function",
978
+ "signature": "loadArcaneNativeProvider({ arcaneRoot, target, inspect=lstat, canonicalize=realpath, readModule=readFile, importModule=specifier=>import(specifier), generationCache=providerGenerationCache, signal, onEvent }={})",
979
+ "entrypoints": [
980
+ "arcane-os",
981
+ "arcane-os/native-provider"
982
+ ],
983
+ "primaryImport": "arcane-os",
984
+ "group": "Targets, native plans, and providers",
985
+ "summary": "Loads the fixed provider for one target from an explicitly selected Arcane OS checkout and authenticates that provider generation for the current SDK process.",
986
+ "availability": "Node; selected browser/native target or provider as documented",
987
+ "protocol": "arcane-target-adapter/1, arcane-native-build-plan/1, or provider protocol",
988
+ "normalization": "Normalized complete plan and result; target-specific artifact detail preserved"
989
+ },
990
+ {
991
+ "id": "root:listRuntimeFiles",
992
+ "name": "listRuntimeFiles",
993
+ "displayName": "listRuntimeFiles()",
994
+ "kind": "function",
995
+ "signature": "async listRuntimeFiles({runtimeRoot=path.join(sdkRoot, 'runtime'),signal}={})",
996
+ "entrypoints": [
997
+ "arcane-os"
998
+ ],
999
+ "primaryImport": "arcane-os",
1000
+ "group": "Runtime and app descriptors",
1001
+ "summary": "Lists the complete ordered relative-file inventory beneath one selected SDK runtime root.",
1002
+ "availability": "Node",
1003
+ "protocol": "Node ESM",
1004
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
1005
+ },
1006
+ {
1007
+ "id": "root:listSdkBrowserRuntimeFiles",
1008
+ "name": "listSdkBrowserRuntimeFiles",
1009
+ "displayName": "listSdkBrowserRuntimeFiles()",
1010
+ "kind": "function",
1011
+ "signature": "async listSdkBrowserRuntimeFiles({browserRuntimeRoot=defaultRoot,signal}={})",
1012
+ "entrypoints": [
1013
+ "arcane-os"
1014
+ ],
1015
+ "primaryImport": "arcane-os",
1016
+ "group": "Runtime and app descriptors",
1017
+ "summary": "Lists the complete ordered relative-file inventory beneath one selected SDK browser-runtime root.",
1018
+ "availability": "Node",
1019
+ "protocol": "Node ESM",
1020
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
1021
+ },
1022
+ {
1023
+ "id": "root:loadRuntimeRelease",
1024
+ "name": "loadRuntimeRelease",
1025
+ "displayName": "loadRuntimeRelease()",
1026
+ "kind": "function",
1027
+ "signature": "async loadRuntimeRelease({runtimeRoot=path.join(sdkRoot, 'runtime'),signal}={})",
1028
+ "entrypoints": [
1029
+ "arcane-os"
1030
+ ],
1031
+ "primaryImport": "arcane-os",
1032
+ "group": "Runtime and app descriptors",
1033
+ "summary": "Returns the selected runtime root, SDK version, and complete current file inventory derived from that directory.",
1034
+ "availability": "Node",
1035
+ "protocol": "Node ESM",
1036
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
1037
+ },
1038
+ {
1039
+ "id": "root:loadSdkBrowserRuntimeRelease",
1040
+ "name": "loadSdkBrowserRuntimeRelease",
1041
+ "displayName": "loadSdkBrowserRuntimeRelease()",
1042
+ "kind": "function",
1043
+ "signature": "async loadSdkBrowserRuntimeRelease({browserRuntimeRoot=defaultRoot,signal}={})",
1044
+ "entrypoints": [
1045
+ "arcane-os"
1046
+ ],
1047
+ "primaryImport": "arcane-os",
1048
+ "group": "Runtime and app descriptors",
1049
+ "summary": "Returns the selected browser-runtime root, SDK version, and complete current file inventory derived from that directory.",
1050
+ "availability": "Node",
1051
+ "protocol": "Node ESM",
1052
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
1053
+ },
1054
+ {
1055
+ "id": "root:materializeInstalledSdkRuntime",
1056
+ "name": "materializeInstalledSdkRuntime",
1057
+ "displayName": "materializeInstalledSdkRuntime()",
1058
+ "kind": "function",
1059
+ "signature": "async materializeInstalledSdkRuntime({workspaceRoot,sdkPackageSource,workspaceOperationLease,signal,onEvent}={})",
1060
+ "entrypoints": [
1061
+ "arcane-os"
1062
+ ],
1063
+ "primaryImport": "arcane-os",
1064
+ "group": "Runtime and app descriptors",
1065
+ "summary": "Materializes the complete installed SDK runtime and browser runtime, then replaces semantic arcane.lock.json metadata from the actual installed dependency and package.",
1066
+ "availability": "Node",
1067
+ "protocol": "Installed SDK runtime materialization",
1068
+ "normalization": "Complete installed runtime content and a mutable materialization result"
1069
+ },
1070
+ {
1071
+ "id": "root:materializeWorkspaceRuntimeContent",
1072
+ "name": "materializeWorkspaceRuntimeContent",
1073
+ "displayName": "materializeWorkspaceRuntimeContent()",
1074
+ "kind": "function",
1075
+ "signature": "async materializeWorkspaceRuntimeContent({workspaceRoot,runtimeRoot=path.join(getSdkRoot(), 'runtime'),browserRuntimeRoot=getSdkBrowserRuntimeRoot(),signal,onEvent}={})",
1076
+ "entrypoints": [
1077
+ "arcane-os"
1078
+ ],
1079
+ "primaryImport": "arcane-os",
1080
+ "group": "Runtime and app descriptors",
1081
+ "summary": "Replaces one workspace's complete projected runtime and browser-runtime content from selected source roots.",
1082
+ "availability": "Node",
1083
+ "protocol": "Workspace runtime materialization",
1084
+ "normalization": "Complete workspace runtime content and a mutable materialization result"
1085
+ },
1086
+ {
1087
+ "id": "root:NATIVE_BUILD_PLAN_PROTOCOL",
1088
+ "name": "NATIVE_BUILD_PLAN_PROTOCOL",
1089
+ "displayName": "NATIVE_BUILD_PLAN_PROTOCOL",
1090
+ "kind": "constant",
1091
+ "signature": "const NATIVE_BUILD_PLAN_PROTOCOL",
1092
+ "entrypoints": [
1093
+ "arcane-os",
1094
+ "arcane-os/native"
1095
+ ],
1096
+ "primaryImport": "arcane-os",
1097
+ "group": "Targets, native plans, and providers",
1098
+ "summary": "Protocol identifier for immutable authenticated native build plans.",
1099
+ "availability": "Node; selected browser/native target or provider as documented",
1100
+ "protocol": "arcane-target-adapter/1, arcane-native-build-plan/1, or provider protocol",
1101
+ "normalization": "Exact immutable SDK value"
1102
+ },
1103
+ {
1104
+ "id": "root:NATIVE_BUILDER_PROTOCOL",
1105
+ "name": "NATIVE_BUILDER_PROTOCOL",
1106
+ "displayName": "NATIVE_BUILDER_PROTOCOL",
1107
+ "kind": "constant",
1108
+ "signature": "const NATIVE_BUILDER_PROTOCOL",
1109
+ "entrypoints": [
1110
+ "arcane-os",
1111
+ "arcane-os/native"
1112
+ ],
1113
+ "primaryImport": "arcane-os",
1114
+ "group": "Targets, native plans, and providers",
1115
+ "summary": "Protocol identifier required from injected native builders.",
1116
+ "availability": "Node; selected browser/native target or provider as documented",
1117
+ "protocol": "arcane-target-adapter/1, arcane-native-build-plan/1, or provider protocol",
1118
+ "normalization": "Exact immutable SDK value"
1119
+ },
1120
+ {
1121
+ "id": "root:normalizeError",
1122
+ "name": "normalizeError",
1123
+ "displayName": "normalizeError()",
1124
+ "kind": "function",
1125
+ "signature": "normalizeError(error, fallbackCode=ERROR_CODES.operationFailed)",
1126
+ "entrypoints": [
1127
+ "arcane-os"
1128
+ ],
1129
+ "primaryImport": "arcane-os",
1130
+ "group": "Errors",
1131
+ "summary": "Converts an unknown thrown value into an `ArcaneError` while preserving an existing normalized error.",
1132
+ "availability": "Node",
1133
+ "protocol": "Node ESM",
1134
+ "normalization": "ArcaneError and JSON-safe error normalization"
1135
+ },
1136
+ {
1137
+ "id": "root:normalizeRelativePath",
1138
+ "name": "normalizeRelativePath",
1139
+ "displayName": "normalizeRelativePath()",
1140
+ "kind": "function",
1141
+ "signature": "normalizeRelativePath(value, label='path')",
1142
+ "entrypoints": [
1143
+ "arcane-os/packager"
1144
+ ],
1145
+ "primaryImport": "arcane-os/packager",
1146
+ "group": "Packaging and release bundles",
1147
+ "summary": "Normalizes one portable repository-relative path and rejects traversal, aliases, links, and unsafe names.",
1148
+ "availability": "Node",
1149
+ "protocol": "SDK packager and deterministic bundle contract",
1150
+ "normalization": "Normalized SDK validation with complete canonical archive and release content"
1151
+ },
1152
+ {
1153
+ "id": "root:OUTPUT_MODES",
1154
+ "name": "OUTPUT_MODES",
1155
+ "displayName": "OUTPUT_MODES",
1156
+ "kind": "constant",
1157
+ "signature": "const OUTPUT_MODES",
1158
+ "entrypoints": [
1159
+ "arcane-os"
1160
+ ],
1161
+ "primaryImport": "arcane-os",
1162
+ "group": "Identity and protocol constants",
1163
+ "summary": "Frozen supported CLI output modes: human, JSON, and NDJSON.",
1164
+ "availability": "Node",
1165
+ "protocol": "Node ESM",
1166
+ "normalization": "Exact immutable SDK value"
1167
+ },
1168
+ {
1169
+ "id": "root:packageApp",
1170
+ "name": "packageApp",
1171
+ "displayName": "packageApp()",
1172
+ "kind": "function",
1173
+ "signature": "async packageApp(options)",
1174
+ "entrypoints": [
1175
+ "arcane-os",
1176
+ "arcane-os/packager"
1177
+ ],
1178
+ "primaryImport": "arcane-os",
1179
+ "group": "Packaging and release bundles",
1180
+ "summary": "Builds one selected browser application release through the low-level packager API; it never runs tests or checks automatically.",
1181
+ "availability": "Node",
1182
+ "protocol": "SDK packager and deterministic bundle contract",
1183
+ "normalization": "Normalized SDK validation with complete canonical archive and release content"
1184
+ },
1185
+ {
1186
+ "id": "root:packageApplication",
1187
+ "name": "packageApplication",
1188
+ "displayName": "packageApplication()",
1189
+ "kind": "function",
1190
+ "signature": "async packageApplication(options={})",
1191
+ "entrypoints": [
1192
+ "arcane-os",
1193
+ "arcane-os/toolchain"
1194
+ ],
1195
+ "primaryImport": "arcane-os",
1196
+ "group": "Headless toolchain operations",
1197
+ "summary": "Runs the high-level package operation for one selected application.",
1198
+ "availability": "Node; selected operation may produce browser or native output",
1199
+ "protocol": "Shared headless operation API + arcane-cli-events/1",
1200
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
1201
+ },
1202
+ {
1203
+ "id": "root:PACKAGER_VERSION",
1204
+ "name": "PACKAGER_VERSION",
1205
+ "displayName": "PACKAGER_VERSION",
1206
+ "kind": "constant",
1207
+ "signature": "const PACKAGER_VERSION",
1208
+ "entrypoints": [
1209
+ "arcane-os/packager"
1210
+ ],
1211
+ "primaryImport": "arcane-os/packager",
1212
+ "group": "Packaging and release bundles",
1213
+ "summary": "Builder identity written into schema-1 application release manifests.",
1214
+ "availability": "Node",
1215
+ "protocol": "SDK packager and deterministic bundle contract",
1216
+ "normalization": "Exact immutable SDK value"
1217
+ },
1218
+ {
1219
+ "id": "packager:discoverApps",
1220
+ "name": "discoverApps",
1221
+ "displayName": "packager.discoverApps()",
1222
+ "kind": "function",
1223
+ "signature": "async discoverApps({workspaceRoot:requestedWorkspaceRoot})",
1224
+ "entrypoints": [
1225
+ "arcane-os/packager"
1226
+ ],
1227
+ "primaryImport": "arcane-os/packager",
1228
+ "group": "Packaging and release bundles",
1229
+ "summary": "Discovers packager application configurations and release boundaries beneath one workspace root.",
1230
+ "availability": "Node",
1231
+ "protocol": "SDK packager and deterministic bundle contract",
1232
+ "normalization": "Normalized SDK validation with complete canonical archive and release content"
1233
+ },
1234
+ {
1235
+ "id": "root:parseSemver",
1236
+ "name": "parseSemver",
1237
+ "displayName": "parseSemver()",
1238
+ "kind": "function",
1239
+ "signature": "parseSemver(value)",
1240
+ "entrypoints": [
1241
+ "arcane-os/packager"
1242
+ ],
1243
+ "primaryImport": "arcane-os/packager",
1244
+ "group": "Packaging and release bundles",
1245
+ "summary": "Parses one strict three-part semantic version with optional prerelease metadata.",
1246
+ "availability": "Node",
1247
+ "protocol": "SDK packager and deterministic bundle contract",
1248
+ "normalization": "Normalized SDK validation with complete canonical archive and release content"
1249
+ },
1250
+ {
1251
+ "id": "root:planApplication",
1252
+ "name": "planApplication",
1253
+ "displayName": "planApplication()",
1254
+ "kind": "function",
1255
+ "signature": "async planApplication(options={})",
1256
+ "entrypoints": [
1257
+ "arcane-os",
1258
+ "arcane-os/toolchain"
1259
+ ],
1260
+ "primaryImport": "arcane-os",
1261
+ "group": "Headless toolchain operations",
1262
+ "summary": "Creates one authenticated native build plan without executing the provider build.",
1263
+ "availability": "Node; selected operation may produce browser or native output",
1264
+ "protocol": "Shared headless operation API + arcane-cli-events/1",
1265
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
1266
+ },
1267
+ {
1268
+ "id": "root:prepareNativeTarget",
1269
+ "name": "prepareNativeTarget",
1270
+ "displayName": "prepareNativeTarget()",
1271
+ "kind": "function",
1272
+ "signature": "async prepareNativeTarget(options={})",
1273
+ "entrypoints": [
1274
+ "arcane-os",
1275
+ "arcane-os/toolchain"
1276
+ ],
1277
+ "primaryImport": "arcane-os",
1278
+ "group": "Targets, native plans, and providers",
1279
+ "summary": "Runs one provider toolchain preparation and returns its process-owned result.",
1280
+ "availability": "Node; selected browser/native target or provider as documented",
1281
+ "protocol": "arcane-target-adapter/1, arcane-native-build-plan/1, or provider protocol",
1282
+ "normalization": "Normalized complete plan and result; target-specific artifact detail preserved"
1283
+ },
1284
+ {
1285
+ "id": "root:projectNativeDescriptor",
1286
+ "name": "projectNativeDescriptor",
1287
+ "displayName": "projectNativeDescriptor()",
1288
+ "kind": "function",
1289
+ "signature": "projectNativeDescriptor(descriptor, {source}={})",
1290
+ "entrypoints": [
1291
+ "arcane-os"
1292
+ ],
1293
+ "primaryImport": "arcane-os",
1294
+ "group": "Runtime and app descriptors",
1295
+ "summary": "Projects the canonical app descriptor into the native registry shape consumed by paired builders.",
1296
+ "availability": "Node",
1297
+ "protocol": "Node ESM",
1298
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
1299
+ },
1300
+ {
1301
+ "id": "root:projectPackageManifest",
1302
+ "name": "projectPackageManifest",
1303
+ "displayName": "projectPackageManifest()",
1304
+ "kind": "function",
1305
+ "signature": "projectPackageManifest(descriptor)",
1306
+ "entrypoints": [
1307
+ "arcane-os"
1308
+ ],
1309
+ "primaryImport": "arcane-os",
1310
+ "group": "Runtime and app descriptors",
1311
+ "summary": "Projects a schema-2 descriptor into the compatible schema-1 application package contract.",
1312
+ "availability": "Node",
1313
+ "protocol": "Node ESM",
1314
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
1315
+ },
1316
+ {
1317
+ "id": "preference-store:default",
1318
+ "name": "default",
1319
+ "displayName": "PreferenceStore default export",
1320
+ "kind": "class",
1321
+ "signature": "default class PreferenceStore extends EventTarget",
1322
+ "entrypoints": ["arcane-os/preference-store"],
1323
+ "primaryImport": "arcane-os/preference-store",
1324
+ "group": "Portable runtime modules",
1325
+ "summary": "Default binding for the canonical PreferenceStore runtime class in Node and managed browsers.",
1326
+ "availability": "Node with injected adapters, or browser/native WebView storage",
1327
+ "protocol": "Node ESM / authenticated managed browser import map",
1328
+ "normalization": "Binding identity and namespace come directly from the canonical runtime module"
1329
+ },
1330
+ {
1331
+ "id": "preference-store:PREFERENCE_STORE_ERROR_CODES",
1332
+ "name": "PREFERENCE_STORE_ERROR_CODES",
1333
+ "displayName": "PREFERENCE_STORE_ERROR_CODES",
1334
+ "kind": "constant",
1335
+ "signature": "const PREFERENCE_STORE_ERROR_CODES",
1336
+ "entrypoints": ["arcane-os/preference-store"],
1337
+ "primaryImport": "arcane-os/preference-store",
1338
+ "group": "Portable runtime modules",
1339
+ "summary": "Frozen stable error-code vocabulary emitted by PreferenceStore.",
1340
+ "availability": "Node and browser",
1341
+ "protocol": "PreferenceStore runtime contract",
1342
+ "normalization": "Exact immutable code names from the canonical runtime module"
1343
+ },
1344
+ {
1345
+ "id": "preference-store:PREFERENCE_STORE_EVENT_TYPES",
1346
+ "name": "PREFERENCE_STORE_EVENT_TYPES",
1347
+ "displayName": "PREFERENCE_STORE_EVENT_TYPES",
1348
+ "kind": "constant",
1349
+ "signature": "const PREFERENCE_STORE_EVENT_TYPES",
1350
+ "entrypoints": ["arcane-os/preference-store"],
1351
+ "primaryImport": "arcane-os/preference-store",
1352
+ "group": "Portable runtime modules",
1353
+ "summary": "Frozen semantic event names published by PreferenceStore.",
1354
+ "availability": "Node and browser",
1355
+ "protocol": "PreferenceStore runtime contract",
1356
+ "normalization": "Exact load, change, and reset event names"
1357
+ },
1358
+ {
1359
+ "id": "preference-store:Preference",
1360
+ "name": "Preference",
1361
+ "displayName": "Preference",
1362
+ "kind": "class",
1363
+ "signature": "new Preference(data={})",
1364
+ "entrypoints": ["arcane-os/preference-store"],
1365
+ "primaryImport": "arcane-os/preference-store",
1366
+ "group": "Portable runtime modules",
1367
+ "summary": "Canonical Preference entity re-exported with the store namespace.",
1368
+ "availability": "Node and browser",
1369
+ "protocol": "Preference entity schema",
1370
+ "normalization": "Canonical entity validation and serialization"
1371
+ },
1372
+ {
1373
+ "id": "preference-store:preferenceSchema",
1374
+ "name": "preferenceSchema",
1375
+ "displayName": "preferenceSchema()",
1376
+ "kind": "function",
1377
+ "signature": "preferenceSchema(definitions=[])",
1378
+ "entrypoints": ["arcane-os/preference-store"],
1379
+ "primaryImport": "arcane-os/preference-store",
1380
+ "group": "Portable runtime modules",
1381
+ "summary": "Builds the canonical Preference strong-type schema for an admitted definition set.",
1382
+ "availability": "Node and browser",
1383
+ "protocol": "Preference entity schema",
1384
+ "normalization": "Returns the canonical runtime schema for the supplied definitions"
1385
+ },
1386
+ {
1387
+ "id": "speech-playback:default",
1388
+ "name": "default",
1389
+ "displayName": "SpeechPlayback default export",
1390
+ "kind": "class",
1391
+ "signature": "default class SpeechPlayback",
1392
+ "entrypoints": ["arcane-os/speech-playback"],
1393
+ "primaryImport": "arcane-os/speech-playback",
1394
+ "group": "Portable runtime modules",
1395
+ "summary": "Default binding for the canonical SpeechPlayback runtime class in Node and managed browsers.",
1396
+ "availability": "Node with injected media adapters, or browser/native WebView media",
1397
+ "protocol": "SpeechPlayback runtime contract",
1398
+ "normalization": "Binding identity and namespace come directly from the canonical runtime module"
1399
+ },
1400
+ {
1401
+ "id": "speech-playback:SPEECH_PLAYBACK_STATE_EVENT",
1402
+ "name": "SPEECH_PLAYBACK_STATE_EVENT",
1403
+ "displayName": "SPEECH_PLAYBACK_STATE_EVENT",
1404
+ "kind": "constant",
1405
+ "signature": "const SPEECH_PLAYBACK_STATE_EVENT",
1406
+ "entrypoints": ["arcane-os/speech-playback"],
1407
+ "primaryImport": "arcane-os/speech-playback",
1408
+ "group": "Portable runtime modules",
1409
+ "summary": "Canonical semantic event name for SpeechPlayback state transitions.",
1410
+ "availability": "Node and browser",
1411
+ "protocol": "SpeechPlayback runtime contract",
1412
+ "normalization": "Exact immutable speech-playback-state event name"
1413
+ },
1414
+ {
1415
+ "id": "speech-playback:SpeechPlayback",
1416
+ "name": "SpeechPlayback",
1417
+ "displayName": "SpeechPlayback",
1418
+ "kind": "class",
1419
+ "signature": "new SpeechPlayback(options={})",
1420
+ "entrypoints": ["arcane-os/speech-playback"],
1421
+ "primaryImport": "arcane-os/speech-playback",
1422
+ "group": "Portable runtime modules",
1423
+ "summary": "Named binding for the same canonical class exposed as the subpath default.",
1424
+ "availability": "Node with injected media adapters, or browser/native WebView media",
1425
+ "protocol": "SpeechPlayback runtime contract",
1426
+ "normalization": "Binding identity equals the default export; prepare preserves each nonblank part input exactly without trimming, splitting, or freezing it; provider and media availability remain host-owned"
1427
+ },
1428
+ {
1429
+ "id": "speech-playback:splitSpeechText",
1430
+ "name": "splitSpeechText",
1431
+ "displayName": "splitSpeechText()",
1432
+ "kind": "function",
1433
+ "signature": "splitSpeechText(value='')",
1434
+ "entrypoints": ["arcane-os/speech-playback"],
1435
+ "primaryImport": "arcane-os/speech-playback",
1436
+ "group": "Portable runtime modules",
1437
+ "summary": "Returns the caller's exact nonblank speech text as one segment.",
1438
+ "availability": "Node and browser",
1439
+ "protocol": "SpeechPlayback runtime contract",
1440
+ "normalization": "Uses trimming only to detect blank input; nonblank text is returned unchanged in one mutable array without trimming, splitting, or freezing"
1441
+ },
1442
+ {
1443
+ "id": "root:readRuntimeFile",
1444
+ "name": "readRuntimeFile",
1445
+ "displayName": "readRuntimeFile()",
1446
+ "kind": "function",
1447
+ "signature": "async readRuntimeFile({runtimeRoot=path.join(sdkRoot, 'runtime'),relativePath,signal}={})",
1448
+ "entrypoints": [
1449
+ "arcane-os"
1450
+ ],
1451
+ "primaryImport": "arcane-os",
1452
+ "group": "Runtime and app descriptors",
1453
+ "summary": "Reads one complete contained file from a selected SDK runtime root.",
1454
+ "availability": "Node",
1455
+ "protocol": "Node ESM",
1456
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
1457
+ },
1458
+ {
1459
+ "id": "root:readSdkBrowserRuntimeFile",
1460
+ "name": "readSdkBrowserRuntimeFile",
1461
+ "displayName": "readSdkBrowserRuntimeFile()",
1462
+ "kind": "function",
1463
+ "signature": "async readSdkBrowserRuntimeFile({browserRuntimeRoot=defaultRoot,relativePath,signal}={})",
1464
+ "entrypoints": [
1465
+ "arcane-os"
1466
+ ],
1467
+ "primaryImport": "arcane-os",
1468
+ "group": "Runtime and app descriptors",
1469
+ "summary": "Reads one complete contained file from a selected SDK browser-runtime root.",
1470
+ "availability": "Node",
1471
+ "protocol": "Node ESM",
1472
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
1473
+ },
1474
+ {
1475
+ "id": "root:registeredTestCount",
1476
+ "name": "registeredTestCount",
1477
+ "displayName": "registeredTestCount()",
1478
+ "kind": "function",
1479
+ "signature": "registeredTestCount()",
1480
+ "entrypoints": [
1481
+ "arcane-os",
1482
+ "arcane-os/testing"
1483
+ ],
1484
+ "primaryImport": "arcane-os",
1485
+ "group": "Events, processes, and testing",
1486
+ "summary": "Returns the number of tests registered in the current isolated test realm.",
1487
+ "availability": "Node",
1488
+ "protocol": "Node ESM / owned process or test lifecycle",
1489
+ "normalization": "SDK event/error/report normalization"
1490
+ },
1491
+ {
1492
+ "id": "root:RELEASE_MANIFEST_NAME",
1493
+ "name": "RELEASE_MANIFEST_NAME",
1494
+ "displayName": "RELEASE_MANIFEST_NAME",
1495
+ "kind": "constant",
1496
+ "signature": "const RELEASE_MANIFEST_NAME",
1497
+ "entrypoints": [
1498
+ "arcane-os/packager"
1499
+ ],
1500
+ "primaryImport": "arcane-os/packager",
1501
+ "group": "Packaging and release bundles",
1502
+ "summary": "Canonical packaged application release manifest filename.",
1503
+ "availability": "Node",
1504
+ "protocol": "SDK packager and deterministic bundle contract",
1505
+ "normalization": "Exact immutable SDK value"
1506
+ },
1507
+ {
1508
+ "id": "root:repositoryApplication",
1509
+ "name": "repositoryApplication",
1510
+ "displayName": "repositoryApplication()",
1511
+ "kind": "function",
1512
+ "signature": "async repositoryApplication(options={})",
1513
+ "entrypoints": [
1514
+ "arcane-os",
1515
+ "arcane-os/toolchain"
1516
+ ],
1517
+ "primaryImport": "arcane-os",
1518
+ "group": "Headless toolchain operations",
1519
+ "summary": "Dispatches one selected repository status, pull, or push operation through the headless lifecycle.",
1520
+ "availability": "Node; selected operation may produce browser or native output",
1521
+ "protocol": "Shared headless operation API + arcane-cli-events/1",
1522
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
1523
+ },
1524
+ {
1525
+ "id": "root:repositoryPull",
1526
+ "name": "repositoryPull",
1527
+ "displayName": "repositoryPull()",
1528
+ "kind": "function",
1529
+ "signature": "async repositoryPull({ workspaceRoot=process.cwd(), signal, onEvent, run=runProcess }={})",
1530
+ "entrypoints": [
1531
+ "arcane-os"
1532
+ ],
1533
+ "primaryImport": "arcane-os",
1534
+ "group": "Workspace, doctor, repository, and server",
1535
+ "summary": "Runs one fast-forward-only pull after proving the selected repository worktree is clean.",
1536
+ "availability": "Node; network-assisted Git",
1537
+ "protocol": "Node ESM",
1538
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
1539
+ },
1540
+ {
1541
+ "id": "root:repositoryPush",
1542
+ "name": "repositoryPush",
1543
+ "displayName": "repositoryPush()",
1544
+ "kind": "function",
1545
+ "signature": "async repositoryPush({ workspaceRoot=process.cwd(), signal, onEvent, run=runProcess }={})",
1546
+ "entrypoints": [
1547
+ "arcane-os"
1548
+ ],
1549
+ "primaryImport": "arcane-os",
1550
+ "group": "Workspace, doctor, repository, and server",
1551
+ "summary": "Pushes the selected attached branch through the repository's configured remote and credentials.",
1552
+ "availability": "Node; network-assisted Git",
1553
+ "protocol": "Node ESM",
1554
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
1555
+ },
1556
+ {
1557
+ "id": "root:repositoryStatus",
1558
+ "name": "repositoryStatus",
1559
+ "displayName": "repositoryStatus()",
1560
+ "kind": "function",
1561
+ "signature": "async repositoryStatus({ workspaceRoot=process.cwd(), signal, onEvent, run=runProcess }={})",
1562
+ "entrypoints": [
1563
+ "arcane-os"
1564
+ ],
1565
+ "primaryImport": "arcane-os",
1566
+ "group": "Workspace, doctor, repository, and server",
1567
+ "summary": "Reads one repository's branch and short worktree status through an owned child process.",
1568
+ "availability": "Node",
1569
+ "protocol": "Node ESM",
1570
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
1571
+ },
1572
+ {
1573
+ "id": "root:resolveNativeBuildOutputRoot",
1574
+ "name": "resolveNativeBuildOutputRoot",
1575
+ "displayName": "resolveNativeBuildOutputRoot()",
1576
+ "kind": "function",
1577
+ "signature": "resolveNativeBuildOutputRoot({target, workspaceMode, workspaceRoot, outputRoot}={})",
1578
+ "entrypoints": [
1579
+ "arcane-os",
1580
+ "arcane-os/toolchain"
1581
+ ],
1582
+ "primaryImport": "arcane-os",
1583
+ "group": "Targets, native plans, and providers",
1584
+ "summary": "Resolves and validates one native output root, including integrated-checkout non-overlap.",
1585
+ "availability": "Node; selected browser/native target or provider as documented",
1586
+ "protocol": "arcane-target-adapter/1, arcane-native-build-plan/1, or provider protocol",
1587
+ "normalization": "Normalized complete plan and result; target-specific artifact detail preserved"
1588
+ },
1589
+ {
1590
+ "id": "root:resolveWorkspace",
1591
+ "name": "resolveWorkspace",
1592
+ "displayName": "resolveWorkspace()",
1593
+ "kind": "function",
1594
+ "signature": "async resolveWorkspace({workspaceRoot=process.cwd(), appId}={})",
1595
+ "entrypoints": [
1596
+ "arcane-os"
1597
+ ],
1598
+ "primaryImport": "arcane-os",
1599
+ "group": "Workspace, doctor, repository, and server",
1600
+ "summary": "Resolves one workspace profile and selected app into canonical SDK paths.",
1601
+ "availability": "Node",
1602
+ "protocol": "Node ESM",
1603
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
1604
+ },
1605
+ {
1606
+ "id": "root:ROOT_CONFIG_NAME",
1607
+ "name": "ROOT_CONFIG_NAME",
1608
+ "displayName": "ROOT_CONFIG_NAME",
1609
+ "kind": "constant",
1610
+ "signature": "const ROOT_CONFIG_NAME",
1611
+ "entrypoints": [
1612
+ "arcane-os/packager"
1613
+ ],
1614
+ "primaryImport": "arcane-os/packager",
1615
+ "group": "Packaging and release bundles",
1616
+ "summary": "Canonical root packager configuration filename.",
1617
+ "availability": "Node",
1618
+ "protocol": "SDK packager and deterministic bundle contract",
1619
+ "normalization": "Exact immutable SDK value"
1620
+ },
1621
+ {
1622
+ "id": "root:discoverApps",
1623
+ "name": "discoverApps",
1624
+ "displayName": "discoverApps()",
1625
+ "kind": "function",
1626
+ "signature": "async discoverApps(workspaceRoot=process.cwd())",
1627
+ "entrypoints": [
1628
+ "arcane-os"
1629
+ ],
1630
+ "primaryImport": "arcane-os",
1631
+ "group": "Workspace, doctor, repository, and server",
1632
+ "summary": "Discovers application ids in one external or integrated workspace without selecting one.",
1633
+ "availability": "Node",
1634
+ "protocol": "Node ESM",
1635
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
1636
+ },
1637
+ {
1638
+ "id": "root:runApplication",
1639
+ "name": "runApplication",
1640
+ "displayName": "runApplication()",
1641
+ "kind": "function",
1642
+ "signature": "async runApplication(options={})",
1643
+ "entrypoints": [
1644
+ "arcane-os",
1645
+ "arcane-os/toolchain"
1646
+ ],
1647
+ "primaryImport": "arcane-os",
1648
+ "group": "Headless toolchain operations",
1649
+ "summary": "Runs a browser app or performs the retained native build/verify/launch lifecycle for one target.",
1650
+ "availability": "Node; selected operation may produce browser or native output",
1651
+ "protocol": "Shared headless operation API + arcane-cli-events/1",
1652
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
1653
+ },
1654
+ {
1655
+ "id": "root:runDoctor",
1656
+ "name": "runDoctor",
1657
+ "displayName": "runDoctor()",
1658
+ "kind": "function",
1659
+ "signature": "async runDoctor({ workspaceRoot, appId, arcaneRoot, requireLocalAI=false, signal, onEvent, platform=process.platform, run=runProcess }={})",
1660
+ "entrypoints": [
1661
+ "arcane-os"
1662
+ ],
1663
+ "primaryImport": "arcane-os",
1664
+ "group": "Workspace, doctor, repository, and server",
1665
+ "summary": "Runs the underlying read-only doctor checks and returns their normalized report.",
1666
+ "availability": "Node",
1667
+ "protocol": "Node ESM",
1668
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
1669
+ },
1670
+ {
1671
+ "id": "root:runProcess",
1672
+ "name": "runProcess",
1673
+ "displayName": "runProcess()",
1674
+ "kind": "function",
1675
+ "signature": "async runProcess(command, args=[], { cwd, env, signal, onEvent, heartbeatMs=5000, terminationGraceMs=DEFAULT_TERMINATION_GRACE_MS, allowNonzero=false, input }={})",
1676
+ "entrypoints": [
1677
+ "arcane-os"
1678
+ ],
1679
+ "primaryImport": "arcane-os",
1680
+ "group": "Events, processes, and testing",
1681
+ "summary": "Runs one shell-free child command with complete stdout and stderr, ordered stream events, heartbeats, and process-tree cancellation.",
1682
+ "availability": "Node",
1683
+ "protocol": "Node ESM / owned process or test lifecycle",
1684
+ "normalization": "SDK event/error/report normalization"
1685
+ },
1686
+ {
1687
+ "id": "root:runRegisteredTests",
1688
+ "name": "runRegisteredTests",
1689
+ "displayName": "runRegisteredTests()",
1690
+ "kind": "function",
1691
+ "signature": "async runRegisteredTests({signal, requireTests=true, onPhase}={})",
1692
+ "entrypoints": [
1693
+ "arcane-os",
1694
+ "arcane-os/testing"
1695
+ ],
1696
+ "primaryImport": "arcane-os",
1697
+ "group": "Events, processes, and testing",
1698
+ "summary": "Executes the current isolated realm's registered tests once and returns the normalized Vanilla Test report.",
1699
+ "availability": "Node",
1700
+ "protocol": "Node ESM / owned process or test lifecycle",
1701
+ "normalization": "SDK event/error/report normalization"
1702
+ },
1703
+ {
1704
+ "id": "root:runRepositoryAction",
1705
+ "name": "runRepositoryAction",
1706
+ "displayName": "runRepositoryAction()",
1707
+ "kind": "function",
1708
+ "signature": "async runRepositoryAction(action, options={})",
1709
+ "entrypoints": [
1710
+ "arcane-os"
1711
+ ],
1712
+ "primaryImport": "arcane-os",
1713
+ "group": "Workspace, doctor, repository, and server",
1714
+ "summary": "Selects and runs one repository action by name.",
1715
+ "availability": "Node",
1716
+ "protocol": "Node ESM",
1717
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
1718
+ },
1719
+ {
1720
+ "id": "root:runTarget",
1721
+ "name": "runTarget",
1722
+ "displayName": "runTarget()",
1723
+ "kind": "function",
1724
+ "signature": "async runTarget(options={})",
1725
+ "entrypoints": [
1726
+ "arcane-os",
1727
+ "arcane-os/targets"
1728
+ ],
1729
+ "primaryImport": "arcane-os",
1730
+ "group": "Targets, native plans, and providers",
1731
+ "summary": "Invokes one target adapter run method and fails honestly when the artifact kind is not runnable.",
1732
+ "availability": "Node; selected browser/native target or provider as documented",
1733
+ "protocol": "arcane-target-adapter/1, arcane-native-build-plan/1, or provider protocol",
1734
+ "normalization": "Normalized complete plan and result; target-specific artifact detail preserved"
1735
+ },
1736
+ {
1737
+ "id": "root:RUNTIME_ROOT",
1738
+ "name": "RUNTIME_ROOT",
1739
+ "displayName": "RUNTIME_ROOT",
1740
+ "kind": "constant",
1741
+ "signature": "const RUNTIME_ROOT",
1742
+ "entrypoints": [
1743
+ "arcane-os"
1744
+ ],
1745
+ "primaryImport": "arcane-os",
1746
+ "group": "Identity and protocol constants",
1747
+ "summary": "Absolute installed SDK runtime directory for the current process.",
1748
+ "availability": "Node",
1749
+ "protocol": "Node ESM",
1750
+ "normalization": "Exact immutable SDK value"
1751
+ },
1752
+ {
1753
+ "id": "root:SDK_NAME",
1754
+ "name": "SDK_NAME",
1755
+ "displayName": "SDK_NAME",
1756
+ "kind": "constant",
1757
+ "signature": "const SDK_NAME",
1758
+ "entrypoints": [
1759
+ "arcane-os"
1760
+ ],
1761
+ "primaryImport": "arcane-os",
1762
+ "group": "Identity and protocol constants",
1763
+ "summary": "Published npm package name.",
1764
+ "availability": "Node",
1765
+ "protocol": "Node ESM",
1766
+ "normalization": "Exact immutable SDK value"
1767
+ },
1768
+ {
1769
+ "id": "root:SDK_ROOT",
1770
+ "name": "SDK_ROOT",
1771
+ "displayName": "SDK_ROOT",
1772
+ "kind": "constant",
1773
+ "signature": "const SDK_ROOT",
1774
+ "entrypoints": [
1775
+ "arcane-os"
1776
+ ],
1777
+ "primaryImport": "arcane-os",
1778
+ "group": "Identity and protocol constants",
1779
+ "summary": "Absolute installed package root for the current process.",
1780
+ "availability": "Node",
1781
+ "protocol": "Node ESM",
1782
+ "normalization": "Exact immutable SDK value"
1783
+ },
1784
+ {
1785
+ "id": "root:SDK_VERSION",
1786
+ "name": "SDK_VERSION",
1787
+ "displayName": "SDK_VERSION",
1788
+ "kind": "constant",
1789
+ "signature": "const SDK_VERSION",
1790
+ "entrypoints": [
1791
+ "arcane-os"
1792
+ ],
1793
+ "primaryImport": "arcane-os",
1794
+ "group": "Identity and protocol constants",
1795
+ "summary": "Exact SDK package version.",
1796
+ "availability": "Node",
1797
+ "protocol": "Node ESM",
1798
+ "normalization": "Exact immutable SDK value"
1799
+ },
1800
+ {
1801
+ "id": "root:selectApp",
1802
+ "name": "selectApp",
1803
+ "displayName": "selectApp()",
1804
+ "kind": "function",
1805
+ "signature": "async selectApp(workspaceRoot=process.cwd(), appId)",
1806
+ "entrypoints": [
1807
+ "arcane-os"
1808
+ ],
1809
+ "primaryImport": "arcane-os",
1810
+ "group": "Workspace, doctor, repository, and server",
1811
+ "summary": "Selects one exact app id, or requires an unambiguous single discovered application.",
1812
+ "availability": "Node",
1813
+ "protocol": "Node ESM",
1814
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
1815
+ },
1816
+ {
1817
+ "id": "root:startDevServer",
1818
+ "name": "startDevServer",
1819
+ "displayName": "startDevServer()",
1820
+ "kind": "function",
1821
+ "signature": "async startDevServer(options={})",
1822
+ "entrypoints": [
1823
+ "arcane-os"
1824
+ ],
1825
+ "primaryImport": "arcane-os",
1826
+ "group": "Workspace, doctor, repository, and server",
1827
+ "summary": "Starts one owned browser development server with exact runtime/app route mappings and an unguessable session capability.",
1828
+ "availability": "Node control plane; browser data plane",
1829
+ "protocol": "Node ESM",
1830
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
1831
+ },
1832
+ {
1833
+ "id": "root:startSourceExampleServer",
1834
+ "name": "startSourceExampleServer",
1835
+ "displayName": "startSourceExampleServer()",
1836
+ "kind": "function",
1837
+ "signature": "async startSourceExampleServer(options={})",
1838
+ "entrypoints": [
1839
+ "arcane-os"
1840
+ ],
1841
+ "primaryImport": "arcane-os",
1842
+ "group": "Workspace, doctor, repository, and server",
1843
+ "summary": "Starts a generic source-example server over explicit directory mounts with complete streaming and HTTP range transport.",
1844
+ "availability": "Node control plane; browser data plane",
1845
+ "protocol": "Node ESM and HTTP/1.1 static source transport",
1846
+ "normalization": "Explicit URL mounts, optional file inclusion lists, lazy missing directories, and a closeable server result"
1847
+ },
1848
+ {
1849
+ "id": "root:TARGET_ADAPTER_PROTOCOL",
1850
+ "name": "TARGET_ADAPTER_PROTOCOL",
1851
+ "displayName": "TARGET_ADAPTER_PROTOCOL",
1852
+ "kind": "constant",
1853
+ "signature": "const TARGET_ADAPTER_PROTOCOL",
1854
+ "entrypoints": [
1855
+ "arcane-os"
1856
+ ],
1857
+ "primaryImport": "arcane-os",
1858
+ "group": "Targets, native plans, and providers",
1859
+ "summary": "Protocol required from target adapter descriptors and implementations.",
1860
+ "availability": "Node; selected browser/native target or provider as documented",
1861
+ "protocol": "arcane-target-adapter/1, arcane-native-build-plan/1, or provider protocol",
1862
+ "normalization": "Exact immutable SDK value"
1863
+ },
1864
+ {
1865
+ "id": "root:TARGET_IDS",
1866
+ "name": "TARGET_IDS",
1867
+ "displayName": "TARGET_IDS",
1868
+ "kind": "constant",
1869
+ "signature": "const TARGET_IDS",
1870
+ "entrypoints": [
1871
+ "arcane-os"
1872
+ ],
1873
+ "primaryImport": "arcane-os",
1874
+ "group": "Targets, native plans, and providers",
1875
+ "summary": "Frozen list of currently exposed target identifiers.",
1876
+ "availability": "Node; selected browser/native target or provider as documented",
1877
+ "protocol": "arcane-target-adapter/1, arcane-native-build-plan/1, or provider protocol",
1878
+ "normalization": "Exact immutable SDK value"
1879
+ },
1880
+ {
1881
+ "id": "root:test",
1882
+ "name": "test",
1883
+ "displayName": "test()",
1884
+ "kind": "function",
1885
+ "signature": "test(name, optionsOrCallback, maybeCallback)",
1886
+ "entrypoints": [
1887
+ "arcane-os",
1888
+ "arcane-os/testing"
1889
+ ],
1890
+ "primaryImport": "arcane-os",
1891
+ "group": "Events, processes, and testing",
1892
+ "summary": "Registers one public test, optional timeout, callback, nested cases, and FIFO cleanup in the isolated runner.",
1893
+ "availability": "Node",
1894
+ "protocol": "Node ESM / owned process or test lifecycle",
1895
+ "normalization": "SDK event/error/report normalization"
1896
+ },
1897
+ {
1898
+ "id": "root:testApplication",
1899
+ "name": "testApplication",
1900
+ "displayName": "testApplication()",
1901
+ "kind": "function",
1902
+ "signature": "async testApplication(options={})",
1903
+ "entrypoints": [
1904
+ "arcane-os",
1905
+ "arcane-os/toolchain"
1906
+ ],
1907
+ "primaryImport": "arcane-os",
1908
+ "group": "Headless toolchain operations",
1909
+ "summary": "Runs the selected application's exact test boundary or one integrated shared test.",
1910
+ "availability": "Node; selected operation may produce browser or native output",
1911
+ "protocol": "Shared headless operation API + arcane-cli-events/1",
1912
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
1913
+ },
1914
+ {
1915
+ "id": "root:throwIfAborted",
1916
+ "name": "throwIfAborted",
1917
+ "displayName": "throwIfAborted()",
1918
+ "kind": "function",
1919
+ "signature": "throwIfAborted(signal)",
1920
+ "entrypoints": [
1921
+ "arcane-os"
1922
+ ],
1923
+ "primaryImport": "arcane-os",
1924
+ "group": "Errors",
1925
+ "summary": "Throws the signal reason or a normalized cancellation error when an AbortSignal is already aborted.",
1926
+ "availability": "Node",
1927
+ "protocol": "Node ESM",
1928
+ "normalization": "ArcaneError and JSON-safe error normalization"
1929
+ },
1930
+ {
1931
+ "id": "root:validateAppBundlePath",
1932
+ "name": "validateAppBundlePath",
1933
+ "displayName": "validateAppBundlePath()",
1934
+ "kind": "function",
1935
+ "signature": "validateAppBundlePath(value, label='bundle path')",
1936
+ "entrypoints": [
1937
+ "arcane-os",
1938
+ "arcane-os/release-bundle"
1939
+ ],
1940
+ "primaryImport": "arcane-os",
1941
+ "group": "Packaging and release bundles",
1942
+ "summary": "Validates and normalizes one portable path admitted inside an external app bundle.",
1943
+ "availability": "Node",
1944
+ "protocol": "SDK packager and deterministic bundle contract",
1945
+ "normalization": "Normalized SDK validation with complete canonical archive and release content"
1946
+ },
1947
+ {
1948
+ "id": "root:validateAppConfig",
1949
+ "name": "validateAppConfig",
1950
+ "displayName": "validateAppConfig()",
1951
+ "kind": "function",
1952
+ "signature": "validateAppConfig(value, appId, rootConfig, configPath=`apps/${appId}/${APP_CONFIG_NAME}`)",
1953
+ "entrypoints": [
1954
+ "arcane-os/packager"
1955
+ ],
1956
+ "primaryImport": "arcane-os/packager",
1957
+ "group": "Packaging and release bundles",
1958
+ "summary": "Validates one schema-1 packager app configuration and its relationship to the root config.",
1959
+ "availability": "Node",
1960
+ "protocol": "SDK packager and deterministic bundle contract",
1961
+ "normalization": "Normalized SDK validation with complete canonical archive and release content"
1962
+ },
1963
+ {
1964
+ "id": "root:validateAppDescriptor",
1965
+ "name": "validateAppDescriptor",
1966
+ "displayName": "validateAppDescriptor()",
1967
+ "kind": "function",
1968
+ "signature": "validateAppDescriptor(value, {appId}={})",
1969
+ "entrypoints": [
1970
+ "arcane-os"
1971
+ ],
1972
+ "primaryImport": "arcane-os",
1973
+ "group": "Runtime and app descriptors",
1974
+ "summary": "Strictly validates and freezes one schema-2 app descriptor, including runtime-only cross-field rules.",
1975
+ "availability": "Node",
1976
+ "protocol": "Node ESM",
1977
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
1978
+ },
1979
+ {
1980
+ "id": "root:validateNativeBuilder",
1981
+ "name": "validateNativeBuilder",
1982
+ "displayName": "validateNativeBuilder()",
1983
+ "kind": "function",
1984
+ "signature": "validateNativeBuilder(provider)",
1985
+ "entrypoints": [
1986
+ "arcane-os",
1987
+ "arcane-os/native"
1988
+ ],
1989
+ "primaryImport": "arcane-os",
1990
+ "group": "Targets, native plans, and providers",
1991
+ "summary": "Validates a native builder's protocol and required describe/doctor/prepare/build/verify/run methods.",
1992
+ "availability": "Node; selected browser/native target or provider as documented",
1993
+ "protocol": "arcane-target-adapter/1, arcane-native-build-plan/1, or provider protocol",
1994
+ "normalization": "Normalized complete plan and result; target-specific artifact detail preserved"
1995
+ },
1996
+ {
1997
+ "id": "root:validateRootConfig",
1998
+ "name": "validateRootConfig",
1999
+ "displayName": "validateRootConfig()",
2000
+ "kind": "function",
2001
+ "signature": "validateRootConfig(value, configPath=ROOT_CONFIG_NAME)",
2002
+ "entrypoints": [
2003
+ "arcane-os/packager"
2004
+ ],
2005
+ "primaryImport": "arcane-os/packager",
2006
+ "group": "Packaging and release bundles",
2007
+ "summary": "Validates one root packager mapping and its fixed shared-route boundaries.",
2008
+ "availability": "Node",
2009
+ "protocol": "SDK packager and deterministic bundle contract",
2010
+ "normalization": "Normalized SDK validation with complete canonical archive and release content"
2011
+ },
2012
+ {
2013
+ "id": "root:validateWorkspace",
2014
+ "name": "validateWorkspace",
2015
+ "displayName": "validateWorkspace()",
2016
+ "kind": "function",
2017
+ "signature": "async validateWorkspace({workspaceRoot=process.cwd(), appId, allowMissingManagedImportMap=false, signal, onEvent}={})",
2018
+ "entrypoints": [
2019
+ "arcane-os"
2020
+ ],
2021
+ "primaryImport": "arcane-os",
2022
+ "group": "Workspace, doctor, repository, and server",
2023
+ "summary": "Runs canonical workspace, runtime, descriptor, selected-app, and exact installed-SDK validation with progress events.",
2024
+ "availability": "Node",
2025
+ "protocol": "Node ESM",
2026
+ "normalization": "Returns a frozen workspace record and, for external workspaces, the exact canonical or npm-alias-bound SDK installation authority"
2027
+ },
2028
+ {
2029
+ "id": "root:upgradeApplication",
2030
+ "name": "upgradeApplication",
2031
+ "displayName": "upgradeApplication()",
2032
+ "kind": "function",
2033
+ "signature": "async upgradeApplication(options={})",
2034
+ "entrypoints": [
2035
+ "arcane-os",
2036
+ "arcane-os/toolchain"
2037
+ ],
2038
+ "primaryImport": "arcane-os",
2039
+ "group": "Headless toolchain operations",
2040
+ "summary": "Runs an external application's ordinary npm upgrade command without a separate SDK lock, runtime, import-map, authentication, or reconciliation workflow.",
2041
+ "availability": "Node; selected operation may produce browser or native output",
2042
+ "protocol": "Shared headless operation API + arcane-cli-events/1",
2043
+ "normalization": "Returns a mutable application-upgrade record with the selected workspace fields and normal npm process result"
2044
+ },
2045
+ {
2046
+ "id": "root:verifyApp",
2047
+ "name": "verifyApp",
2048
+ "displayName": "verifyApp()",
2049
+ "kind": "function",
2050
+ "signature": "async verifyApp({workspaceRoot, appId, signal, onEvent})",
2051
+ "entrypoints": [
2052
+ "arcane-os",
2053
+ "arcane-os/packager"
2054
+ ],
2055
+ "primaryImport": "arcane-os",
2056
+ "group": "Packaging and release bundles",
2057
+ "summary": "Authenticates one existing browser app release through the low-level packager API.",
2058
+ "availability": "Node",
2059
+ "protocol": "SDK packager and deterministic bundle contract",
2060
+ "normalization": "Normalized SDK validation with complete canonical archive and release content"
2061
+ },
2062
+ {
2063
+ "id": "root:verifyApplication",
2064
+ "name": "verifyApplication",
2065
+ "displayName": "verifyApplication()",
2066
+ "kind": "function",
2067
+ "signature": "async verifyApplication(options={})",
2068
+ "entrypoints": [
2069
+ "arcane-os",
2070
+ "arcane-os/toolchain"
2071
+ ],
2072
+ "primaryImport": "arcane-os",
2073
+ "group": "Headless toolchain operations",
2074
+ "summary": "Runs the high-level verification operation for one selected browser release.",
2075
+ "availability": "Node; selected operation may produce browser or native output",
2076
+ "protocol": "Shared headless operation API + arcane-cli-events/1",
2077
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
2078
+ },
2079
+ {
2080
+ "id": "root:verifyAppReleaseBundle",
2081
+ "name": "verifyAppReleaseBundle",
2082
+ "displayName": "verifyAppReleaseBundle()",
2083
+ "kind": "function",
2084
+ "signature": "async verifyAppReleaseBundle({bundlePath, signal, onEvent}={})",
2085
+ "entrypoints": [
2086
+ "arcane-os",
2087
+ "arcane-os/release-bundle"
2088
+ ],
2089
+ "primaryImport": "arcane-os",
2090
+ "group": "Packaging and release bundles",
2091
+ "summary": "Parses and authenticates one deterministic app bundle without extraction.",
2092
+ "availability": "Node",
2093
+ "protocol": "SDK packager and deterministic bundle contract",
2094
+ "normalization": "Normalized SDK validation with complete canonical archive and release content"
2095
+ },
2096
+ {
2097
+ "id": "root:verifyBundleApplication",
2098
+ "name": "verifyBundleApplication",
2099
+ "displayName": "verifyBundleApplication()",
2100
+ "kind": "function",
2101
+ "signature": "async verifyBundleApplication(options={})",
2102
+ "entrypoints": [
2103
+ "arcane-os",
2104
+ "arcane-os/toolchain"
2105
+ ],
2106
+ "primaryImport": "arcane-os",
2107
+ "group": "Headless toolchain operations",
2108
+ "summary": "Runs the high-level external bundle verification operation.",
2109
+ "availability": "Node; selected operation may produce browser or native output",
2110
+ "protocol": "Shared headless operation API + arcane-cli-events/1",
2111
+ "normalization": "SDK-normalized inputs, errors, events, and documented result"
2112
+ },
2113
+ {
2114
+ "id": "root:verifyNativeArtifact",
2115
+ "name": "verifyNativeArtifact",
2116
+ "displayName": "verifyNativeArtifact()",
2117
+ "kind": "function",
2118
+ "signature": "async verifyNativeArtifact(options={})",
2119
+ "entrypoints": [
2120
+ "arcane-os",
2121
+ "arcane-os/toolchain"
2122
+ ],
2123
+ "primaryImport": "arcane-os",
2124
+ "group": "Targets, native plans, and providers",
2125
+ "summary": "Explicitly verifies one selected target artifact through the prepared provider and toolchain state.",
2126
+ "availability": "Node; selected browser/native target or provider as documented",
2127
+ "protocol": "arcane-target-adapter/1, arcane-native-build-plan/1, or provider protocol",
2128
+ "normalization": "Normalized complete plan and result; target-specific artifact detail preserved"
2129
+ },
2130
+ {
2131
+ "id": "root:verifyTarget",
2132
+ "name": "verifyTarget",
2133
+ "displayName": "verifyTarget()",
2134
+ "kind": "function",
2135
+ "signature": "async verifyTarget(options={})",
2136
+ "entrypoints": [
2137
+ "arcane-os",
2138
+ "arcane-os/targets"
2139
+ ],
2140
+ "primaryImport": "arcane-os",
2141
+ "group": "Targets, native plans, and providers",
2142
+ "summary": "Invokes one target adapter's artifact verification boundary.",
2143
+ "availability": "Node; selected browser/native target or provider as documented",
2144
+ "protocol": "arcane-target-adapter/1, arcane-native-build-plan/1, or provider protocol",
2145
+ "normalization": "Normalized complete plan and result; target-specific artifact detail preserved"
2146
+ },
2147
+ {
2148
+ "id": "root:ARCANE_EVENT_AUTHORITY_BRAND",
2149
+ "name": "ARCANE_EVENT_AUTHORITY_BRAND",
2150
+ "displayName": "ARCANE_EVENT_AUTHORITY_BRAND",
2151
+ "kind": "constant",
2152
+ "signature": "const ARCANE_EVENT_AUTHORITY_BRAND",
2153
+ "entrypoints": [
2154
+ "arcane-os",
2155
+ "arcane-os/event-manager"
2156
+ ],
2157
+ "primaryImport": "arcane-os/event-manager",
2158
+ "group": "Central events, time travel, and DOM instrumentation",
2159
+ "summary": "Global registry symbol used as a protocol marker on a created per-realm Arcane event authority.",
2160
+ "availability": "Node and browser/bundler",
2161
+ "protocol": "Symbol.for('arcane-os.arcane-events-authority') with arcane-event-authority/1",
2162
+ "normalization": "Exact global symbol key; a created authority receives an enumerable, writable, configurable marker property"
2163
+ },
2164
+ {
2165
+ "id": "root:ARCANE_EVENT_AUTHORITY_KIND",
2166
+ "name": "ARCANE_EVENT_AUTHORITY_KIND",
2167
+ "displayName": "ARCANE_EVENT_AUTHORITY_KIND",
2168
+ "kind": "constant",
2169
+ "signature": "const ARCANE_EVENT_AUTHORITY_KIND",
2170
+ "entrypoints": [
2171
+ "arcane-os",
2172
+ "arcane-os/event-manager"
2173
+ ],
2174
+ "primaryImport": "arcane-os/event-manager",
2175
+ "group": "Central events, time travel, and DOM instrumentation",
2176
+ "summary": "Identifies the canonical authority descriptor kind.",
2177
+ "availability": "Node and browser/bundler",
2178
+ "protocol": "arcane-event-authority",
2179
+ "normalization": "Exact descriptor-kind discriminator"
2180
+ },
2181
+ {
2182
+ "id": "root:ARCANE_EVENT_AUTHORITY_PROTOCOL",
2183
+ "name": "ARCANE_EVENT_AUTHORITY_PROTOCOL",
2184
+ "displayName": "ARCANE_EVENT_AUTHORITY_PROTOCOL",
2185
+ "kind": "constant",
2186
+ "signature": "const ARCANE_EVENT_AUTHORITY_PROTOCOL",
2187
+ "entrypoints": [
2188
+ "arcane-os",
2189
+ "arcane-os/event-manager"
2190
+ ],
2191
+ "primaryImport": "arcane-os/event-manager",
2192
+ "group": "Central events, time travel, and DOM instrumentation",
2193
+ "summary": "Identifies the current Arcane event-authority protocol.",
2194
+ "availability": "Node and browser/bundler",
2195
+ "protocol": "arcane-event-authority/1",
2196
+ "normalization": "Exact authority protocol discriminator; a global with this protocol and the required callable API is reused, otherwise the module installs a new authority when possible"
2197
+ },
2198
+ {
2199
+ "id": "root:ARCANE_EVENT_ERROR_CODES",
2200
+ "name": "ARCANE_EVENT_ERROR_CODES",
2201
+ "displayName": "ARCANE_EVENT_ERROR_CODES",
2202
+ "kind": "constant",
2203
+ "signature": "const ARCANE_EVENT_ERROR_CODES",
2204
+ "entrypoints": [
2205
+ "arcane-os",
2206
+ "arcane-os/event-manager"
2207
+ ],
2208
+ "primaryImport": "arcane-os/event-manager",
2209
+ "group": "Central events, time travel, and DOM instrumentation",
2210
+ "summary": "Mutable map of event-authority error-code names to their identical string values.",
2211
+ "availability": "Node and browser/bundler",
2212
+ "protocol": "arcane-event-authority/1 failures",
2213
+ "normalization": "Exact mutable string-to-itself code map"
2214
+ },
2215
+ {
2216
+ "id": "root:ARCANE_EVENT_LISTENER_ERROR_EVENT",
2217
+ "name": "ARCANE_EVENT_LISTENER_ERROR_EVENT",
2218
+ "displayName": "ARCANE_EVENT_LISTENER_ERROR_EVENT",
2219
+ "kind": "constant",
2220
+ "signature": "const ARCANE_EVENT_LISTENER_ERROR_EVENT",
2221
+ "entrypoints": [
2222
+ "arcane-os",
2223
+ "arcane-os/event-manager"
2224
+ ],
2225
+ "primaryImport": "arcane-os/event-manager",
2226
+ "group": "Central events, time travel, and DOM instrumentation",
2227
+ "summary": "Canonical observational event emitted for a listener failure.",
2228
+ "availability": "Node and browser/bundler",
2229
+ "protocol": "arcane.event.listener.error over arcane-event-authority/1",
2230
+ "normalization": "Mutable public detail includes the code, source identifiers, and complete normalized error snapshot; the raw error also reaches the owner-local callback"
2231
+ },
2232
+ {
2233
+ "id": "root:ARCANE_EVENT_OCCURRENCE_PROTOCOL",
2234
+ "name": "ARCANE_EVENT_OCCURRENCE_PROTOCOL",
2235
+ "displayName": "ARCANE_EVENT_OCCURRENCE_PROTOCOL",
2236
+ "kind": "constant",
2237
+ "signature": "const ARCANE_EVENT_OCCURRENCE_PROTOCOL",
2238
+ "entrypoints": [
2239
+ "arcane-os",
2240
+ "arcane-os/event-manager"
2241
+ ],
2242
+ "primaryImport": "arcane-os/event-manager",
2243
+ "group": "Central events, time travel, and DOM instrumentation",
2244
+ "summary": "Identifies canonical event occurrences.",
2245
+ "availability": "Node and browser/bundler",
2246
+ "protocol": "arcane-event-occurrence/1",
2247
+ "normalization": "Exact occurrence protocol discriminator; occurrences and their complete normalized detail are mutable"
2248
+ },
2249
+ {
2250
+ "id": "root:ARCANE_EVENT_SOURCE_DISPOSED_EVENT",
2251
+ "name": "ARCANE_EVENT_SOURCE_DISPOSED_EVENT",
2252
+ "displayName": "ARCANE_EVENT_SOURCE_DISPOSED_EVENT",
2253
+ "kind": "constant",
2254
+ "signature": "const ARCANE_EVENT_SOURCE_DISPOSED_EVENT",
2255
+ "entrypoints": [
2256
+ "arcane-os",
2257
+ "arcane-os/event-manager"
2258
+ ],
2259
+ "primaryImport": "arcane-os/event-manager",
2260
+ "group": "Central events, time travel, and DOM instrumentation",
2261
+ "summary": "Final noncancelable canonical occurrence published when a source is disposed.",
2262
+ "availability": "Node and browser/bundler",
2263
+ "protocol": "arcane.event.source.disposed over arcane-event-authority/1",
2264
+ "normalization": "Mutable normalized detail contains source, instanceId, and the exact source-disposed reason before source listener cleanup"
2265
+ },
2266
+ {
2267
+ "id": "root:ARCANE_EVENT_SOURCE_KIND",
2268
+ "name": "ARCANE_EVENT_SOURCE_KIND",
2269
+ "displayName": "ARCANE_EVENT_SOURCE_KIND",
2270
+ "kind": "constant",
2271
+ "signature": "const ARCANE_EVENT_SOURCE_KIND",
2272
+ "entrypoints": [
2273
+ "arcane-os",
2274
+ "arcane-os/event-manager"
2275
+ ],
2276
+ "primaryImport": "arcane-os/event-manager",
2277
+ "group": "Central events, time travel, and DOM instrumentation",
2278
+ "summary": "Identifies the canonical source descriptor kind.",
2279
+ "availability": "Node and browser/bundler",
2280
+ "protocol": "arcane-event-source",
2281
+ "normalization": "Exact descriptor-kind discriminator"
2282
+ },
2283
+ {
2284
+ "id": "root:ARCANE_EVENT_SOURCE_PROTOCOL",
2285
+ "name": "ARCANE_EVENT_SOURCE_PROTOCOL",
2286
+ "displayName": "ARCANE_EVENT_SOURCE_PROTOCOL",
2287
+ "kind": "constant",
2288
+ "signature": "const ARCANE_EVENT_SOURCE_PROTOCOL",
2289
+ "entrypoints": [
2290
+ "arcane-os",
2291
+ "arcane-os/event-manager"
2292
+ ],
2293
+ "primaryImport": "arcane-os/event-manager",
2294
+ "group": "Central events, time travel, and DOM instrumentation",
2295
+ "summary": "Identifies canonical event source handles and descriptors.",
2296
+ "availability": "Node and browser/bundler",
2297
+ "protocol": "arcane-event-source/1",
2298
+ "normalization": "Exact source protocol discriminator with declared event types and one realm-local instance id"
2299
+ },
2300
+ {
2301
+ "id": "root:ARCANE_EVENT_STACK_PROTOCOL",
2302
+ "name": "ARCANE_EVENT_STACK_PROTOCOL",
2303
+ "displayName": "ARCANE_EVENT_STACK_PROTOCOL",
2304
+ "kind": "constant",
2305
+ "signature": "const ARCANE_EVENT_STACK_PROTOCOL",
2306
+ "entrypoints": [
2307
+ "arcane-os",
2308
+ "arcane-os/event-manager"
2309
+ ],
2310
+ "primaryImport": "arcane-os/event-manager",
2311
+ "group": "Central events, time travel, and DOM instrumentation",
2312
+ "summary": "Identifies strict serialized event-stack documents and records as arcane-event-stack/1.",
2313
+ "availability": "Node and browser/bundler",
2314
+ "protocol": "arcane-event-stack/1",
2315
+ "normalization": "Exact protocol discriminator; no transport or host authority"
2316
+ },
2317
+ {
2318
+ "id": "root:DEFAULT_DOM_EVENT_TYPES",
2319
+ "name": "DEFAULT_DOM_EVENT_TYPES",
2320
+ "displayName": "DEFAULT_DOM_EVENT_TYPES",
2321
+ "kind": "constant",
2322
+ "signature": "const DEFAULT_DOM_EVENT_TYPES",
2323
+ "entrypoints": [
2324
+ "arcane-os",
2325
+ "arcane-os/event-manager"
2326
+ ],
2327
+ "primaryImport": "arcane-os/event-manager",
2328
+ "group": "Central events, time travel, and DOM instrumentation",
2329
+ "summary": "Mutable default set of 44 capture-phase DOM interaction event names.",
2330
+ "availability": "Node and browser/bundler; meaningful to browser DOM instrumentation",
2331
+ "protocol": "Synchronous DOM observation projected into arcane-event-stack/1 records",
2332
+ "normalization": "Exact mutable event-name list; host event objects are not retained"
2333
+ },
2334
+ {
2335
+ "id": "root:DOM_INTERACTION_EVENT",
2336
+ "name": "DOM_INTERACTION_EVENT",
2337
+ "displayName": "DOM_INTERACTION_EVENT",
2338
+ "kind": "constant",
2339
+ "signature": "const DOM_INTERACTION_EVENT",
2340
+ "entrypoints": [
2341
+ "arcane-os",
2342
+ "arcane-os/event-manager"
2343
+ ],
2344
+ "primaryImport": "arcane-os/event-manager",
2345
+ "group": "Central events, time travel, and DOM instrumentation",
2346
+ "summary": "Event type emitted for a complete DOM interaction diagnostic.",
2347
+ "availability": "Browser DOM or a DOM-compatible test host; constant imports in Node",
2348
+ "protocol": "In-process event-pubsub; optional arcane-event-stack/1 recording",
2349
+ "normalization": "Complete readable event fields, target values, selectors, URLs, markup or text content, and object details are retained"
2350
+ },
2351
+ {
2352
+ "id": "root:DOM_MUTATION_EVENT",
2353
+ "name": "DOM_MUTATION_EVENT",
2354
+ "displayName": "DOM_MUTATION_EVENT",
2355
+ "kind": "constant",
2356
+ "signature": "const DOM_MUTATION_EVENT",
2357
+ "entrypoints": [
2358
+ "arcane-os",
2359
+ "arcane-os/event-manager"
2360
+ ],
2361
+ "primaryImport": "arcane-os/event-manager",
2362
+ "group": "Central events, time travel, and DOM instrumentation",
2363
+ "summary": "Event type emitted for a complete DOM mutation diagnostic.",
2364
+ "availability": "Browser DOM or a DOM-compatible test host; constant imports in Node",
2365
+ "protocol": "MutationObserver projected through in-process events and optional arcane-event-stack/1 recording",
2366
+ "normalization": "Complete markup, text, selectors, URLs, character data, and attribute values are retained"
2367
+ },
2368
+ {
2369
+ "id": "root:DOM_OBSERVATION_STARTED_EVENT",
2370
+ "name": "DOM_OBSERVATION_STARTED_EVENT",
2371
+ "displayName": "DOM_OBSERVATION_STARTED_EVENT",
2372
+ "kind": "constant",
2373
+ "signature": "const DOM_OBSERVATION_STARTED_EVENT",
2374
+ "entrypoints": [
2375
+ "arcane-os",
2376
+ "arcane-os/event-manager"
2377
+ ],
2378
+ "primaryImport": "arcane-os/event-manager",
2379
+ "group": "Central events, time travel, and DOM instrumentation",
2380
+ "summary": "Lifecycle event emitted after DOM instrumentation starts successfully.",
2381
+ "availability": "Browser DOM or a DOM-compatible test host; constant imports in Node",
2382
+ "protocol": "In-process event-pubsub; optional arcane-event-stack/1 recording",
2383
+ "normalization": "Normalized root and capture-option diagnostic"
2384
+ },
2385
+ {
2386
+ "id": "root:DOM_OBSERVATION_STOPPED_EVENT",
2387
+ "name": "DOM_OBSERVATION_STOPPED_EVENT",
2388
+ "displayName": "DOM_OBSERVATION_STOPPED_EVENT",
2389
+ "kind": "constant",
2390
+ "signature": "const DOM_OBSERVATION_STOPPED_EVENT",
2391
+ "entrypoints": [
2392
+ "arcane-os",
2393
+ "arcane-os/event-manager"
2394
+ ],
2395
+ "primaryImport": "arcane-os/event-manager",
2396
+ "group": "Central events, time travel, and DOM instrumentation",
2397
+ "summary": "Lifecycle event emitted when active DOM instrumentation stops normally.",
2398
+ "availability": "Browser DOM or a DOM-compatible test host; constant imports in Node",
2399
+ "protocol": "In-process event-pubsub; optional arcane-event-stack/1 recording",
2400
+ "normalization": "Normalized root diagnostic; stopping an already inactive controller is idempotent and emits nothing"
2401
+ },
2402
+ {
2403
+ "id": "root:EventManager",
2404
+ "name": "EventManager",
2405
+ "displayName": "EventManager",
2406
+ "kind": "class",
2407
+ "signature": "new EventManager(options={})",
2408
+ "entrypoints": [
2409
+ "arcane-os",
2410
+ "arcane-os/event-manager"
2411
+ ],
2412
+ "primaryImport": "arcane-os/event-manager",
2413
+ "group": "Central events, time travel, and DOM instrumentation",
2414
+ "summary": "Runs synchronous pub/sub with optional complete, mutable time-travel history and DOM instrumentation.",
2415
+ "availability": "Node and browser/bundler; DOM capture requires a browser DOM or compatible host",
2416
+ "protocol": "Synchronous event-pubsub plus optional arcane-event-stack/1 export/import",
2417
+ "normalization": "Live listener arguments retain identity; recording preserves complete normalized values, URLs, public details, and captured stack text in mutable snapshots without a configured retention cap"
2418
+ },
2419
+ {
2420
+ "id": "root:PLAYBACK_CANCELLED_EVENT",
2421
+ "name": "PLAYBACK_CANCELLED_EVENT",
2422
+ "displayName": "PLAYBACK_CANCELLED_EVENT",
2423
+ "kind": "constant",
2424
+ "signature": "const PLAYBACK_CANCELLED_EVENT",
2425
+ "entrypoints": [
2426
+ "arcane-os",
2427
+ "arcane-os/event-manager"
2428
+ ],
2429
+ "primaryImport": "arcane-os/event-manager",
2430
+ "group": "Central events, time travel, and DOM instrumentation",
2431
+ "summary": "Lifecycle event emitted when an AbortSignal cancels event-stack playback.",
2432
+ "availability": "Node and browser/bundler",
2433
+ "protocol": "In-process playback lifecycle over an arcane-event-stack/1 source",
2434
+ "normalization": "Mutable summary with session, delivered count, cursor, completion flag, and a complete normalized error snapshot"
2435
+ },
2436
+ {
2437
+ "id": "root:PLAYBACK_COMPLETED_EVENT",
2438
+ "name": "PLAYBACK_COMPLETED_EVENT",
2439
+ "displayName": "PLAYBACK_COMPLETED_EVENT",
2440
+ "kind": "constant",
2441
+ "signature": "const PLAYBACK_COMPLETED_EVENT",
2442
+ "entrypoints": [
2443
+ "arcane-os",
2444
+ "arcane-os/event-manager"
2445
+ ],
2446
+ "primaryImport": "arcane-os/event-manager",
2447
+ "group": "Central events, time travel, and DOM instrumentation",
2448
+ "summary": "Lifecycle event emitted after selected event-stack records finish playback.",
2449
+ "availability": "Node and browser/bundler",
2450
+ "protocol": "In-process playback lifecycle over an arcane-event-stack/1 source",
2451
+ "normalization": "Mutable summary with session, delivered count, cursor, and completed=true"
2452
+ },
2453
+ {
2454
+ "id": "root:PLAYBACK_FAILED_EVENT",
2455
+ "name": "PLAYBACK_FAILED_EVENT",
2456
+ "displayName": "PLAYBACK_FAILED_EVENT",
2457
+ "kind": "constant",
2458
+ "signature": "const PLAYBACK_FAILED_EVENT",
2459
+ "entrypoints": [
2460
+ "arcane-os",
2461
+ "arcane-os/event-manager"
2462
+ ],
2463
+ "primaryImport": "arcane-os/event-manager",
2464
+ "group": "Central events, time travel, and DOM instrumentation",
2465
+ "summary": "Lifecycle event emitted when event-stack playback fails for a reason other than signal cancellation.",
2466
+ "availability": "Node and browser/bundler",
2467
+ "protocol": "In-process playback lifecycle over an arcane-event-stack/1 source",
2468
+ "normalization": "Mutable summary with session, delivered count, cursor, completion flag, and a complete normalized error snapshot"
2469
+ },
2470
+ {
2471
+ "id": "root:PLAYBACK_RECORD_EVENT",
2472
+ "name": "PLAYBACK_RECORD_EVENT",
2473
+ "displayName": "PLAYBACK_RECORD_EVENT",
2474
+ "kind": "constant",
2475
+ "signature": "const PLAYBACK_RECORD_EVENT",
2476
+ "entrypoints": [
2477
+ "arcane-os",
2478
+ "arcane-os/event-manager"
2479
+ ],
2480
+ "primaryImport": "arcane-os/event-manager",
2481
+ "group": "Central events, time travel, and DOM instrumentation",
2482
+ "summary": "Review-mode event that presents one validated mutable record without re-emitting its original type.",
2483
+ "availability": "Node and browser/bundler",
2484
+ "protocol": "In-process review projection of arcane-event-stack/1",
2485
+ "normalization": "Validated mutable event-stack record"
2486
+ },
2487
+ {
2488
+ "id": "root:PLAYBACK_STARTED_EVENT",
2489
+ "name": "PLAYBACK_STARTED_EVENT",
2490
+ "displayName": "PLAYBACK_STARTED_EVENT",
2491
+ "kind": "constant",
2492
+ "signature": "const PLAYBACK_STARTED_EVENT",
2493
+ "entrypoints": [
2494
+ "arcane-os",
2495
+ "arcane-os/event-manager"
2496
+ ],
2497
+ "primaryImport": "arcane-os/event-manager",
2498
+ "group": "Central events, time travel, and DOM instrumentation",
2499
+ "summary": "Lifecycle event emitted before the selected playback range is delivered.",
2500
+ "availability": "Node and browser/bundler",
2501
+ "protocol": "In-process playback lifecycle over an arcane-event-stack/1 source",
2502
+ "normalization": "Normalized session, range, count, speed, and mode summary"
2503
+ },
2504
+ {
2505
+ "id": "root:TIME_TRAVEL_SEEK_EVENT",
2506
+ "name": "TIME_TRAVEL_SEEK_EVENT",
2507
+ "displayName": "TIME_TRAVEL_SEEK_EVENT",
2508
+ "kind": "constant",
2509
+ "signature": "const TIME_TRAVEL_SEEK_EVENT",
2510
+ "entrypoints": [
2511
+ "arcane-os",
2512
+ "arcane-os/event-manager"
2513
+ ],
2514
+ "primaryImport": "arcane-os/event-manager",
2515
+ "group": "Central events, time travel, and DOM instrumentation",
2516
+ "summary": "Event emitted when the review cursor seeks to sequence zero or a retained sequence.",
2517
+ "availability": "Node and browser/bundler",
2518
+ "protocol": "In-process review cursor event; the retained stack remains unchanged",
2519
+ "normalization": "Normalized sessionId, requested sequence, and mutable matching record or null"
2520
+ },
2521
+ {
2522
+ "id": "root:arcaneEvents",
2523
+ "name": "arcaneEvents",
2524
+ "displayName": "arcaneEvents",
2525
+ "kind": "singleton",
2526
+ "signature": "const arcaneEvents",
2527
+ "entrypoints": [
2528
+ "arcane-os",
2529
+ "arcane-os/event-manager"
2530
+ ],
2531
+ "primaryImport": "arcane-os/event-manager",
2532
+ "group": "Central events, time travel, and DOM instrumentation",
2533
+ "summary": "Package-scoped EventManager singleton for applications that want one shared event bus.",
2534
+ "availability": "Node and browser/bundler; DOM capture requires a compatible DOM",
2535
+ "protocol": "Synchronous event-pubsub plus opt-in arcane-event-stack/1 recording",
2536
+ "normalization": "Same module singleton through root and focused subpath; time travel starts disabled; complete mutable recording is available when enabled"
2537
+ },
2538
+ {
2539
+ "id": "root:createArcaneEventSource",
2540
+ "name": "createArcaneEventSource",
2541
+ "displayName": "createArcaneEventSource()",
2542
+ "kind": "function",
2543
+ "signature": "createArcaneEventSource(owner, options)",
2544
+ "entrypoints": [
2545
+ "arcane-os",
2546
+ "arcane-os/event-manager"
2547
+ ],
2548
+ "primaryImport": "arcane-os/event-manager",
2549
+ "group": "Central events, time travel, and DOM instrumentation",
2550
+ "summary": "Registers one declared semantic event source for a non-null object or function owner.",
2551
+ "availability": "Node and browser/bundler",
2552
+ "protocol": "arcane-event-source/1 over the per-realm arcane-event-authority/1 singleton",
2553
+ "normalization": "Returns one mutable source handle with declared event types, a realm-local instance id, synchronous publication, and deterministic disposal"
2554
+ },
2555
+ {
2556
+ "id": "root:createDOMInstrumentation",
2557
+ "name": "createDOMInstrumentation",
2558
+ "displayName": "createDOMInstrumentation()",
2559
+ "kind": "function",
2560
+ "signature": "createDOMInstrumentation(options={})",
2561
+ "entrypoints": [
2562
+ "arcane-os",
2563
+ "arcane-os/event-manager"
2564
+ ],
2565
+ "primaryImport": "arcane-os/event-manager",
2566
+ "group": "Central events, time travel, and DOM instrumentation",
2567
+ "summary": "Creates a start/stop controller that projects DOM interactions and mutations into an EventManager.",
2568
+ "availability": "Browser DOM or a DOM-compatible test host",
2569
+ "protocol": "Capture-phase DOM events and MutationObserver projected to in-process EventManager events",
2570
+ "normalization": "Accepts eventManager, root, eventTypes, MutationObserver, captureMutations, and observeOpenShadowRoots; preserves complete readable event, value, markup, text, selector, URL, and mutation detail"
2571
+ },
2572
+ {
2573
+ "id": "root:createEventManager",
2574
+ "name": "createEventManager",
2575
+ "displayName": "createEventManager()",
2576
+ "kind": "function",
2577
+ "signature": "createEventManager(options)",
2578
+ "entrypoints": [
2579
+ "arcane-os",
2580
+ "arcane-os/event-manager"
2581
+ ],
2582
+ "primaryImport": "arcane-os/event-manager",
2583
+ "group": "Central events, time travel, and DOM instrumentation",
2584
+ "summary": "Constructs and returns an independent EventManager instance.",
2585
+ "availability": "Node and browser/bundler; DOM capture requires a compatible DOM",
2586
+ "protocol": "Synchronous event-pubsub plus optional arcane-event-stack/1",
2587
+ "normalization": "Equivalent constructor behavior without sharing the arcaneEvents singleton; accepts the current timeTravel, dom, clock, now, and sessionId options"
2588
+ },
2589
+ {
2590
+ "id": "root:describeDOMTarget",
2591
+ "name": "describeDOMTarget",
2592
+ "displayName": "describeDOMTarget()",
2593
+ "kind": "function",
2594
+ "signature": "describeDOMTarget(target, root)",
2595
+ "entrypoints": [
2596
+ "arcane-os",
2597
+ "arcane-os/event-manager"
2598
+ ],
2599
+ "primaryImport": "arcane-os/event-manager",
2600
+ "group": "Central events, time travel, and DOM instrumentation",
2601
+ "summary": "Returns a mutable diagnostic descriptor for a DOM target, including complete text or markup content when present.",
2602
+ "availability": "Browser DOM or DOM-compatible objects; importable in Node",
2603
+ "protocol": "Local DOM diagnostic helper",
2604
+ "normalization": "Normalizes document, shadow root, text, element, global, and generic event targets without retaining nodes"
2605
+ },
2606
+ {
2607
+ "id": "root:domSelector",
2608
+ "name": "domSelector",
2609
+ "displayName": "domSelector()",
2610
+ "kind": "function",
2611
+ "signature": "domSelector(target, root)",
2612
+ "entrypoints": [
2613
+ "arcane-os",
2614
+ "arcane-os/event-manager"
2615
+ ],
2616
+ "primaryImport": "arcane-os/event-manager",
2617
+ "group": "Central events, time travel, and DOM instrumentation",
2618
+ "summary": "Builds a diagnostic selector across light DOM and open shadow-root boundaries.",
2619
+ "availability": "Browser DOM or DOM-compatible objects; importable in Node",
2620
+ "protocol": "Local DOM diagnostic helper",
2621
+ "normalization": "Returns a best-effort selector or null; triple-chevron separates open shadow boundaries"
2622
+ },
2623
+ {
2624
+ "id": "root:isArcaneEventOccurrence",
2625
+ "name": "isArcaneEventOccurrence",
2626
+ "displayName": "isArcaneEventOccurrence()",
2627
+ "kind": "function",
2628
+ "signature": "isArcaneEventOccurrence(value)",
2629
+ "entrypoints": [
2630
+ "arcane-os",
2631
+ "arcane-os/event-manager"
2632
+ ],
2633
+ "primaryImport": "arcane-os/event-manager",
2634
+ "group": "Central events, time travel, and DOM instrumentation",
2635
+ "summary": "Recognizes canonical occurrences and source event views created by the current realm authority.",
2636
+ "availability": "Node and browser/bundler",
2637
+ "protocol": "arcane-event-occurrence/1 realm-local recognition",
2638
+ "normalization": "Returns a boolean from authority-owned identity records; protocol-shaped foreign objects are not admitted"
2639
+ },
2640
+ {
2641
+ "id": "root:parseEventStack",
2642
+ "name": "parseEventStack",
2643
+ "displayName": "parseEventStack()",
2644
+ "kind": "function",
2645
+ "signature": "parseEventStack(source)",
2646
+ "entrypoints": [
2647
+ "arcane-os",
2648
+ "arcane-os/event-manager"
2649
+ ],
2650
+ "primaryImport": "arcane-os/event-manager",
2651
+ "group": "Central events, time travel, and DOM instrumentation",
2652
+ "summary": "Strictly parses and validates an event-stack object or JSON string into a mutable normalized document.",
2653
+ "availability": "Node and browser/bundler",
2654
+ "protocol": "arcane-event-stack/1",
2655
+ "normalization": "Rejects extra keys, malformed nesting, unsafe values, invalid timing or session structure, and non-increasing sequences; returns a mutable null-prototype normalized document"
2656
+ },
2657
+ {
2658
+ "id": "root:projectArcaneDOMEvent",
2659
+ "name": "projectArcaneDOMEvent",
2660
+ "displayName": "projectArcaneDOMEvent()",
2661
+ "kind": "function",
2662
+ "signature": "projectArcaneDOMEvent(target, occurrence, options)",
2663
+ "entrypoints": [
2664
+ "arcane-os",
2665
+ "arcane-os/event-manager"
2666
+ ],
2667
+ "primaryImport": "arcane-os/event-manager",
2668
+ "group": "Central events, time travel, and DOM instrumentation",
2669
+ "summary": "Projects one canonical occurrence to one CustomEvent without republishing it into the authority.",
2670
+ "availability": "Browser DOM or a DOM-compatible test host",
2671
+ "protocol": "One-way arcane-event-occurrence/1 to CustomEvent projection",
2672
+ "normalization": "Adds mutable occurrence, source, instance, and operation identifiers; DOM cancellation propagates only to a cancelable occurrence"
2673
+ },
2674
+ {
2675
+ "id": "root:SDK_UPDATE_REGISTRY",
2676
+ "name": "SDK_UPDATE_REGISTRY",
2677
+ "displayName": "SDK_UPDATE_REGISTRY",
2678
+ "kind": "constant",
2679
+ "signature": "const SDK_UPDATE_REGISTRY",
2680
+ "entrypoints": [
2681
+ "arcane-os"
2682
+ ],
2683
+ "primaryImport": "arcane-os",
2684
+ "group": "Explicit SDK update checks",
2685
+ "summary": "Approved default npm registry origin for the on-demand SDK update check.",
2686
+ "availability": "Node; on-demand CLI or maintainer check only",
2687
+ "protocol": "Ordinary HTTP or HTTPS GET to the selected npm registry dist-tag endpoint",
2688
+ "normalization": "Exact default HTTPS registry string"
2689
+ },
2690
+ {
2691
+ "id": "root:SDK_UPDATE_TIMEOUT_MS",
2692
+ "name": "SDK_UPDATE_TIMEOUT_MS",
2693
+ "displayName": "SDK_UPDATE_TIMEOUT_MS",
2694
+ "kind": "constant",
2695
+ "signature": "const SDK_UPDATE_TIMEOUT_MS",
2696
+ "entrypoints": [
2697
+ "arcane-os"
2698
+ ],
2699
+ "primaryImport": "arcane-os",
2700
+ "group": "Explicit SDK update checks",
2701
+ "summary": "Default per-request timeout for one explicit SDK registry check.",
2702
+ "availability": "Node; on-demand CLI or maintainer check only",
2703
+ "protocol": "Ordinary HTTP or HTTPS GET to the selected npm registry dist-tag endpoint",
2704
+ "normalization": "Exact default millisecond integer"
2705
+ },
2706
+ {
2707
+ "id": "root:checkForSdkUpdate",
2708
+ "name": "checkForSdkUpdate",
2709
+ "displayName": "checkForSdkUpdate()",
2710
+ "kind": "function",
2711
+ "signature": "async checkForSdkUpdate({ packageName=SDK_NAME, currentVersion=SDK_VERSION, registry=SDK_UPDATE_REGISTRY, timeoutMs=SDK_UPDATE_TIMEOUT_MS, fetchImpl=globalThis.fetch, signal, onEvent, clock=()=>new Date() }={})",
2712
+ "entrypoints": [
2713
+ "arcane-os"
2714
+ ],
2715
+ "primaryImport": "arcane-os",
2716
+ "group": "Explicit SDK update checks",
2717
+ "summary": "Performs one ordinary registry read and reports whether the selected npm dist-tag is newer than the installed SDK.",
2718
+ "availability": "Node; on-demand CLI or maintainer check only",
2719
+ "protocol": "Ordinary HTTP or HTTPS GET to the selected npm registry dist-tag endpoint",
2720
+ "normalization": "Mutable current, ahead, or update-available result with complete registry data and normalized update-check failures"
2721
+ },
2722
+ {
2723
+ "id": "root:checkSdkUpdate",
2724
+ "name": "checkSdkUpdate",
2725
+ "displayName": "checkSdkUpdate()",
2726
+ "kind": "function",
2727
+ "signature": "async checkSdkUpdate(options={})",
2728
+ "entrypoints": [
2729
+ "arcane-os",
2730
+ "arcane-os/toolchain"
2731
+ ],
2732
+ "primaryImport": "arcane-os",
2733
+ "group": "Explicit SDK update checks",
2734
+ "summary": "Toolchain and CLI wrapper for exactly one checkForSdkUpdate invocation.",
2735
+ "availability": "Node; on-demand CLI or maintainer check only",
2736
+ "protocol": "Ordinary HTTP or HTTPS GET to the selected npm registry dist-tag endpoint",
2737
+ "normalization": "Preserves the direct check result, events, cancellation, and errors without scheduling another check"
2738
+ },
2739
+ {
2740
+ "id": "root:compareSdkVersions",
2741
+ "name": "compareSdkVersions",
2742
+ "displayName": "compareSdkVersions()",
2743
+ "kind": "function",
2744
+ "signature": "compareSdkVersions(leftValue, rightValue)",
2745
+ "entrypoints": [
2746
+ "arcane-os"
2747
+ ],
2748
+ "primaryImport": "arcane-os",
2749
+ "group": "Explicit SDK update checks",
2750
+ "summary": "Compares two strict semantic SDK versions without performing a registry request.",
2751
+ "availability": "Node; on-demand CLI or maintainer check only",
2752
+ "protocol": "In-process semantic-version comparison",
2753
+ "normalization": "Returns -1, 0, or 1; build metadata does not affect precedence"
2754
+ },
2755
+ {
2756
+ "id": "root:updateTagForVersion",
2757
+ "name": "updateTagForVersion",
2758
+ "displayName": "updateTagForVersion()",
2759
+ "kind": "function",
2760
+ "signature": "updateTagForVersion(value)",
2761
+ "entrypoints": [
2762
+ "arcane-os"
2763
+ ],
2764
+ "primaryImport": "arcane-os",
2765
+ "group": "Explicit SDK update checks",
2766
+ "summary": "Selects npm dev for a prerelease SDK version and latest for a stable version.",
2767
+ "availability": "Node; on-demand CLI or maintainer check only",
2768
+ "protocol": "In-process npm dist-tag selection",
2769
+ "normalization": "Exact dev or latest tag selected from strict semantic-version prerelease state"
2770
+ },
2771
+ {
2772
+ "id": "root:validateUpdateRegistry",
2773
+ "name": "validateUpdateRegistry",
2774
+ "displayName": "validateUpdateRegistry()",
2775
+ "kind": "function",
2776
+ "signature": "validateUpdateRegistry(value)",
2777
+ "entrypoints": [
2778
+ "arcane-os"
2779
+ ],
2780
+ "primaryImport": "arcane-os",
2781
+ "group": "Explicit SDK update checks",
2782
+ "summary": "Validates one ordinary HTTP or HTTPS registry URL.",
2783
+ "availability": "Node; on-demand CLI or maintainer check only",
2784
+ "protocol": "Ordinary HTTP or HTTPS registry URL",
2785
+ "normalization": "Returns the normalized URL object without a host, credential, port, path, query, fragment, or redirect policy"
2786
+ },
2787
+ {
2788
+ "id": "browser-wasm:BROWSER_WASM_RUNTIME_AUTHORITY",
2789
+ "name": "BROWSER_WASM_RUNTIME_AUTHORITY",
2790
+ "displayName": "BROWSER_WASM_RUNTIME_AUTHORITY",
2791
+ "kind": "constant",
2792
+ "signature": "const BROWSER_WASM_RUNTIME_AUTHORITY",
2793
+ "entrypoints": [
2794
+ "arcane-os/ai/browser-wasm"
2795
+ ],
2796
+ "primaryImport": "arcane-os/ai/browser-wasm",
2797
+ "group": "Browser-WASM local AI",
2798
+ "summary": "Mutable metadata for the packaged Wllama and llama.cpp runtime, upstream JS and WASM assets, licensing, and disabled compatibility-network policy.",
2799
+ "availability": "Browser metadata; import and inspection require neither DBOPFS nor a loaded model",
2800
+ "protocol": "arcane-ai-browser-wasm/2 over the provider-neutral arcane-ai-adapter/1 boundary",
2801
+ "normalization": "Complete mutable runtime/component metadata; it contains no model weights or model catalog"
2802
+ },
2803
+ {
2804
+ "id": "browser-wasm:adaptV1LlmProvider",
2805
+ "name": "adaptV1LlmProvider",
2806
+ "displayName": "adaptV1LlmProvider()",
2807
+ "kind": "function",
2808
+ "signature": "adaptV1LlmProvider(provider)",
2809
+ "entrypoints": [
2810
+ "arcane-os/ai/browser-wasm"
2811
+ ],
2812
+ "primaryImport": "arcane-os/ai/browser-wasm",
2813
+ "group": "Browser-WASM local AI",
2814
+ "summary": "Adapts one compatible browser LLM provider to the provider-neutral LLM role contract.",
2815
+ "availability": "Browser; the wrapped provider retains its own WebGPU, storage, model, and lifecycle requirements",
2816
+ "protocol": "arcane-ai-provider/2 adapted from the browser LLM adapter surface",
2817
+ "normalization": "Projects catalog, inspection, status, lifecycle, declaration/history-validated chat and stream, private automatic stream draining, complete all-choice content/reasoning FIFO projections, result-first buffering, terminal-only structural-call acceptance, exact per-choice observed/terminal complete-envelope correlation, prompt observed early-return cancellation, and disposal without adding a provider or fallback"
2818
+ },
2819
+ {
2820
+ "id": "browser-wasm:completeValueText",
2821
+ "name": "completeValueText",
2822
+ "displayName": "completeValueText()",
2823
+ "kind": "function",
2824
+ "signature": "completeValueText(value)",
2825
+ "entrypoints": [
2826
+ "arcane-os/ai/browser-wasm"
2827
+ ],
2828
+ "primaryImport": "arcane-os/ai/browser-wasm",
2829
+ "group": "Browser-WASM local AI",
2830
+ "summary": "Returns complete caller content as text, preserving strings and serializing supported non-string values without clipping.",
2831
+ "availability": "Compatible JavaScript module host; no provider, model, cache, storage, WebAssembly, or browser capability is required",
2832
+ "protocol": "Complete caller-value text normalization",
2833
+ "normalization": "Preserves complete string content and converts supported structured values to complete readable JSON text"
2834
+ },
2835
+ {
2836
+ "id": "browser-wasm:createArcaneAI",
2837
+ "name": "createArcaneAI",
2838
+ "displayName": "createArcaneAI()",
2839
+ "kind": "function",
2840
+ "signature": "createArcaneAI({ llm=null, provider=null, loadPolicy='on-demand', security }={})",
2841
+ "entrypoints": [
2842
+ "arcane-os/ai/browser-wasm"
2843
+ ],
2844
+ "primaryImport": "arcane-os/ai/browser-wasm",
2845
+ "group": "Browser-WASM local AI",
2846
+ "summary": "Creates the provider-neutral browser AI API module and LLM lifecycle controller around one compatible provider or controller.",
2847
+ "availability": "Browser; the selected provider observes its own WebAssembly, storage, and model readiness",
2848
+ "protocol": "arcane-ai-adapter/1",
2849
+ "normalization": "Normalizes lazy or manual load, mutable complete lifecycle status, cancellation, complete all-choice nonstructural stream projection, complete provider data callbacks, single-choice text or multi-choice terminal output, required structural arguments.message, and atomic exact matching nonblank all-ID tool-result sequencing without executing tools; an existing ModelController retains its preconfigured load policy and rejects a new security option"
2850
+ },
2851
+ {
2852
+ "id": "browser-wasm:createBrowserModelSource",
2853
+ "name": "createBrowserModelSource",
2854
+ "displayName": "createBrowserModelSource()",
2855
+ "kind": "function",
2856
+ "signature": "createBrowserModelSource(descriptor, { fetchImpl=null }={})",
2857
+ "entrypoints": [
2858
+ "arcane-os/ai/browser-wasm"
2859
+ ],
2860
+ "primaryImport": "arcane-os/ai/browser-wasm",
2861
+ "group": "Browser-WASM local AI",
2862
+ "summary": "Validates a caller-supplied ordered multi-file model descriptor with optional progress metadata and creates cancellable no-credentials HTTPS member downloads.",
2863
+ "availability": "Browser with Fetch and a readable response body; each direct member open performs its configured HTTPS fetch",
2864
+ "protocol": "Caller-supplied version-pinned HTTPS model-file URLs",
2865
+ "normalization": "Canonical mutable ordered descriptor with optional observational bytes plus a complete per-member download handle with nullable observed content length"
2866
+ },
2867
+ {
2868
+ "id": "browser-wasm:createBrowserWasmLlmProvider",
2869
+ "name": "createBrowserWasmLlmProvider",
2870
+ "displayName": "createBrowserWasmLlmProvider()",
2871
+ "kind": "function",
2872
+ "signature": "createBrowserWasmLlmProvider({ sources, store, loadDefaults={}, security, logger=console }={})",
2873
+ "entrypoints": [
2874
+ "arcane-os/ai/browser-wasm"
2875
+ ],
2876
+ "primaryImport": "arcane-os/ai/browser-wasm",
2877
+ "group": "Browser-WASM local AI",
2878
+ "summary": "Creates the packaged Wllama browser provider with complete serialized inference, streaming, abort, unload, and probe operations.",
2879
+ "availability": "Browser context with WebAssembly, OPFS/DBOPFS, and WebGPU; no CPU fallback",
2880
+ "protocol": "arcane-ai-adapter/1 with OpenAI-like chat completion and streaming envelopes",
2881
+ "normalization": "Mutable complete lifecycle/status records, declaration/history validation, atomic nonblank all-ID tool-result sequencing, complete all-choice nonstructural ordinary iterator projections, all-choice terminal validation, terminal-only structural-call acceptance, and exact structured tool-call data with required user-facing message and retained extension fields; the SDK never invokes application tools"
2882
+ },
2883
+ {
2884
+ "id": "browser-wasm:createDbopfsModelStore",
2885
+ "name": "createDbopfsModelStore",
2886
+ "displayName": "createDbopfsModelStore()",
2887
+ "kind": "function",
2888
+ "signature": "createDbopfsModelStore({ dbopfs, tableName='arcane_ai_browser_models', estimateStorage=null, downloadConcurrency=4 }={})",
2889
+ "entrypoints": [
2890
+ "arcane-os/ai/browser-wasm"
2891
+ ],
2892
+ "primaryImport": "arcane-os/ai/browser-wasm",
2893
+ "group": "Browser-WASM local AI",
2894
+ "summary": "Adapts an existing DBOPFS instance into a resumable model cache with bounded parallel shard or monolithic Range-part transfer and live aggregate byte progress.",
2895
+ "availability": "Browser with a ready DBOPFS instance and OPFS support",
2896
+ "protocol": "Resumable ordered model members and deterministic per-member Range parts over existing DBOPFS method semantics",
2897
+ "normalization": "Uses one bounded transfer axis, preserves ordered completed shards and deterministic current Range parts within any member across interruption, emits coalesced additive loaded/total/remaining/rate/ETA/active-worker telemetry, rolls discarded partial writes back out of progress, cleans superseded current Range parts after a complete replacement exists, and settles failed or cancelled peers while retaining completed work for retry"
2898
+ },
2899
+ {
2900
+ "id": "browser-speech:BROWSER_SPEECH_ARTIFACT_GRAPH_PROTOCOL",
2901
+ "name": "BROWSER_SPEECH_ARTIFACT_GRAPH_PROTOCOL",
2902
+ "displayName": "BROWSER_SPEECH_ARTIFACT_GRAPH_PROTOCOL",
2903
+ "kind": "constant",
2904
+ "signature": "const BROWSER_SPEECH_ARTIFACT_GRAPH_PROTOCOL",
2905
+ "entrypoints": [
2906
+ "arcane-os/ai/browser-speech"
2907
+ ],
2908
+ "primaryImport": "arcane-os/ai/browser-speech",
2909
+ "group": "Browser speech providers",
2910
+ "summary": "Stable protocol identifier for a complete caller-owned browser speech materialization graph.",
2911
+ "availability": "Browser metadata; graph construction is side-effect free and provider use requires the selected browser storage and Worker capabilities",
2912
+ "protocol": "arcane-ai-browser-speech-artifact-graph/1",
2913
+ "normalization": "Exact protocol string; the graph file inventory routes known materialized files and does not select artifacts or enforce edge policy"
2914
+ },
2915
+ {
2916
+ "id": "browser-speech:BROWSER_SPEECH_ARTIFACT_PROTOCOL",
2917
+ "name": "BROWSER_SPEECH_ARTIFACT_PROTOCOL",
2918
+ "displayName": "BROWSER_SPEECH_ARTIFACT_PROTOCOL",
2919
+ "kind": "constant",
2920
+ "signature": "const BROWSER_SPEECH_ARTIFACT_PROTOCOL",
2921
+ "entrypoints": [
2922
+ "arcane-os/ai/browser-speech"
2923
+ ],
2924
+ "primaryImport": "arcane-os/ai/browser-speech",
2925
+ "group": "Browser speech providers",
2926
+ "summary": "Stable protocol identifier for browser speech artifact stores.",
2927
+ "availability": "Browser metadata; model/runtime use requires DBOPFS, Web Locks, Workers, and caller-selected artifacts",
2928
+ "protocol": "arcane-ai-browser-speech-artifacts/1 over arcane-ai-provider/2",
2929
+ "normalization": "Exact protocol string; it grants no model authority and names no model download"
2930
+ },
2931
+ {
2932
+ "id": "browser-speech:createBrowserKokoroProvider",
2933
+ "name": "createBrowserKokoroProvider",
2934
+ "displayName": "createBrowserKokoroProvider()",
2935
+ "kind": "function",
2936
+ "signature": "createBrowserKokoroProvider(options={})",
2937
+ "entrypoints": [
2938
+ "arcane-os/ai/browser-speech"
2939
+ ],
2940
+ "primaryImport": "arcane-os/ai/browser-speech",
2941
+ "group": "Browser speech providers",
2942
+ "summary": "Creates a local-only Kokoro text-to-speech provider for the provider-neutral AI runtime.",
2943
+ "availability": "Browser with DBOPFS, Web Locks, Workers, object URLs, and caller-selected kokoro-js runtime/model content",
2944
+ "protocol": "arcane-ai-provider/2 tts/synthesize",
2945
+ "normalization": "Independent load, status, request, unload, cancellation, and disposal; provider-native requests return 24000 Hz Float32Array PCM, while shared AI.js requests use wav and return complete Uint8Array audio/wav data; never selects a cloud fallback"
2946
+ },
2947
+ {
2948
+ "id": "browser-speech:createBrowserSpeechArtifactGraph",
2949
+ "name": "createBrowserSpeechArtifactGraph",
2950
+ "displayName": "createBrowserSpeechArtifactGraph()",
2951
+ "kind": "function",
2952
+ "signature": "createBrowserSpeechArtifactGraph({ kind='browser-speech-authenticated-artifact-graph', security, providerId=null, role, model, runtime, files }={})",
2953
+ "entrypoints": [
2954
+ "arcane-os/ai/browser-speech"
2955
+ ],
2956
+ "primaryImport": "arcane-os/ai/browser-speech",
2957
+ "group": "Browser speech providers",
2958
+ "summary": "Normalizes one complete caller-owned browser speech materialization graph.",
2959
+ "availability": "Browser metadata; construction starts no fetch, cache, Worker, provider, or event operation",
2960
+ "protocol": "arcane-ai-browser-speech-artifact-graph/1",
2961
+ "normalization": "Returns one mutable graph with normalized file, model, runtime, and routing facts"
2962
+ },
2963
+ {
2964
+ "id": "browser-speech:createBrowserSpeechAuthority",
2965
+ "name": "createBrowserSpeechAuthority",
2966
+ "displayName": "createBrowserSpeechAuthority()",
2967
+ "kind": "function",
2968
+ "signature": "createBrowserSpeechAuthority({ providerId, role, model, runtime, security }={})",
2969
+ "entrypoints": [
2970
+ "arcane-os/ai/browser-speech"
2971
+ ],
2972
+ "primaryImport": "arcane-os/ai/browser-speech",
2973
+ "group": "Browser speech providers",
2974
+ "summary": "Validates and preserves one mutable caller-owned Whisper or Kokoro model/runtime authority.",
2975
+ "availability": "Browser descriptor construction; using the authority requires the selected storage and provider Web APIs",
2976
+ "protocol": "arcane-ai-model-authority/1",
2977
+ "normalization": "Requires an exact adapter role, unique paths and URLs, and a caller-supplied revision; returns one mutable normalized authority record"
2978
+ },
2979
+ {
2980
+ "id": "browser-speech:createBrowserWhisperProvider",
2981
+ "name": "createBrowserWhisperProvider",
2982
+ "displayName": "createBrowserWhisperProvider()",
2983
+ "kind": "function",
2984
+ "signature": "createBrowserWhisperProvider(options={})",
2985
+ "entrypoints": [
2986
+ "arcane-os/ai/browser-speech"
2987
+ ],
2988
+ "primaryImport": "arcane-os/ai/browser-speech",
2989
+ "group": "Browser speech providers",
2990
+ "summary": "Creates a local-only Whisper speech-to-text provider for the provider-neutral AI runtime.",
2991
+ "availability": "Browser with DBOPFS, Web Locks, Workers, object URLs, and caller-selected transformers-whisper runtime/model content",
2992
+ "protocol": "arcane-ai-provider/2 stt/transcribe",
2993
+ "normalization": "Independent load, status, request, unload, cancellation, and disposal; accepts provider-native Float32Array audio at exactly 16000 Hz or decodes the shared AI.js Blob/File payload to authoritative 16000 Hz mono PCM; never selects a cloud fallback"
2994
+ },
2995
+ {
2996
+ "id": "browser-speech:createDbopfsSpeechArtifactStore",
2997
+ "name": "createDbopfsSpeechArtifactStore",
2998
+ "displayName": "createDbopfsSpeechArtifactStore()",
2999
+ "kind": "function",
3000
+ "signature": "createDbopfsSpeechArtifactStore({ dbopfs, tableName='arcane_ai_browser_speech', fetchImpl=null, objectUrlFactory=null }={})",
3001
+ "entrypoints": [
3002
+ "arcane-os/ai/browser-speech"
3003
+ ],
3004
+ "primaryImport": "arcane-os/ai/browser-speech",
3005
+ "group": "Browser speech providers",
3006
+ "summary": "Adapts an existing DBOPFS instance into a caller-scoped speech runtime/model artifact store and ordinary module router.",
3007
+ "availability": "Browser with a ready DBOPFS instance, Web Locks, Fetch or an explicit fetch implementation, File/Blob, and object URLs",
3008
+ "protocol": "arcane-ai-browser-speech-artifacts/1 ordinary DBOPFS storage and module routing",
3009
+ "normalization": "Serializes complete caller-selected content, invalidates stale cache selections without byte identities, routes known materialized imports/fetches/Workers/cache reads, falls back to native browser behavior for unmapped operations, and keeps secure intent dormant"
3010
+ },
3011
+ {
3012
+ "id": "mail:MAIL_OUTBOX_IDEMPOTENCY_WINDOW_MS",
3013
+ "name": "MAIL_OUTBOX_IDEMPOTENCY_WINDOW_MS",
3014
+ "displayName": "MAIL_OUTBOX_IDEMPOTENCY_WINDOW_MS",
3015
+ "kind": "constant",
3016
+ "signature": "const MAIL_OUTBOX_IDEMPOTENCY_WINDOW_MS",
3017
+ "entrypoints": ["arcane-os/mail"],
3018
+ "primaryImport": "arcane-os/mail",
3019
+ "group": "Portable Mail",
3020
+ "summary": "Duration for same-key retry before an ambiguous delivery requires reconciliation.",
3021
+ "availability": "Node and browser metadata",
3022
+ "protocol": "arcane-mail-outbox/1",
3023
+ "normalization": "Exact immutable value of 86400000 milliseconds"
3024
+ },
3025
+ {
3026
+ "id": "mail:MAIL_OUTBOX_PROTOCOL",
3027
+ "name": "MAIL_OUTBOX_PROTOCOL",
3028
+ "displayName": "MAIL_OUTBOX_PROTOCOL",
3029
+ "kind": "constant",
3030
+ "signature": "const MAIL_OUTBOX_PROTOCOL",
3031
+ "entrypoints": ["arcane-os/mail"],
3032
+ "primaryImport": "arcane-os/mail",
3033
+ "group": "Portable Mail",
3034
+ "summary": "Stable protocol identifier written to durable Mail outbox records.",
3035
+ "availability": "Node and browser metadata",
3036
+ "protocol": "arcane-mail-outbox/1",
3037
+ "normalization": "Exact immutable protocol value"
3038
+ },
3039
+ {
3040
+ "id": "mail:MAIL_OUTBOX_STATES",
3041
+ "name": "MAIL_OUTBOX_STATES",
3042
+ "displayName": "MAIL_OUTBOX_STATES",
3043
+ "kind": "constant",
3044
+ "signature": "const MAIL_OUTBOX_STATES",
3045
+ "entrypoints": ["arcane-os/mail"],
3046
+ "primaryImport": "arcane-os/mail",
3047
+ "group": "Portable Mail",
3048
+ "summary": "Mutable ordered vocabulary for durable Mail outbox lifecycle states.",
3049
+ "availability": "Node and browser metadata",
3050
+ "protocol": "arcane-mail-outbox/1",
3051
+ "normalization": "Exact queued, sending, retry_wait, accepted, failed, and reconciliation_required state list"
3052
+ },
3053
+ {
3054
+ "id": "mail:MAIL_OUTBOX_TABLE",
3055
+ "name": "MAIL_OUTBOX_TABLE",
3056
+ "displayName": "MAIL_OUTBOX_TABLE",
3057
+ "kind": "constant",
3058
+ "signature": "const MAIL_OUTBOX_TABLE",
3059
+ "entrypoints": ["arcane-os/mail"],
3060
+ "primaryImport": "arcane-os/mail",
3061
+ "group": "Portable Mail",
3062
+ "summary": "Default DBOPFS-compatible table name for durable Mail outbox records.",
3063
+ "availability": "Node and browser metadata",
3064
+ "protocol": "arcane-mail-outbox/1",
3065
+ "normalization": "Exact immutable value mail_outbox"
3066
+ },
3067
+ {
3068
+ "id": "mail:Mail",
3069
+ "name": "Mail",
3070
+ "displayName": "Mail",
3071
+ "kind": "class",
3072
+ "signature": "new Mail(config=globalThis.arcane?.config?.mail||{}, options={})",
3073
+ "entrypoints": ["arcane-os/mail"],
3074
+ "primaryImport": "arcane-os/mail",
3075
+ "group": "Portable Mail",
3076
+ "summary": "Owns the application Mail singleton, durable lifecycle, report normalization, and explicit transport selection.",
3077
+ "availability": "Node with injected host adapters, or browser/native WebView with durable storage and Web Locks",
3078
+ "protocol": "arcane-mail-outbox/1 with native Arcane.mail or complete HTTP delivery",
3079
+ "normalization": "Validates complete reports, persists before delivery, and returns complete mutable provider-neutral send results"
3080
+ },
3081
+ {
3082
+ "id": "mail:MailOutbox",
3083
+ "name": "MailOutbox",
3084
+ "displayName": "MailOutbox",
3085
+ "kind": "class",
3086
+ "signature": "new MailOutbox(options={})",
3087
+ "entrypoints": ["arcane-os/mail"],
3088
+ "primaryImport": "arcane-os/mail",
3089
+ "group": "Portable Mail",
3090
+ "summary": "Persists complete reports before delivery and owns FIFO draining, retry classification, and explicit invalid-record maintenance.",
3091
+ "availability": "Node or browser with injected DBOPFS-compatible storage and a Web Locks-compatible lock manager",
3092
+ "protocol": "arcane-mail-outbox/1",
3093
+ "normalization": "Returns complete mutable records and summaries; accepted results require requestId, optional providerId and acceptanceAuthority remain transport metadata, and ambiguous attempts remain same-key retries or require reconciliation"
3094
+ },
3095
+ {
3096
+ "id": "mail:MailTransportError",
3097
+ "name": "MailTransportError",
3098
+ "displayName": "MailTransportError",
3099
+ "kind": "class",
3100
+ "signature": "new MailTransportError(message, options={})",
3101
+ "entrypoints": ["arcane-os/mail"],
3102
+ "primaryImport": "arcane-os/mail",
3103
+ "group": "Portable Mail",
3104
+ "summary": "Normalized Mail transport failure with stable retry, uncertainty, status, and delay metadata.",
3105
+ "availability": "Node and browser",
3106
+ "protocol": "Arcane Mail HTTP transport",
3107
+ "normalization": "Exposes code, retryable, retryAfterMs, statusCode, uncertain, and complete remote detail"
3108
+ },
3109
+ {
3110
+ "id": "mail:createMailOutbox",
3111
+ "name": "createMailOutbox",
3112
+ "displayName": "createMailOutbox()",
3113
+ "kind": "function",
3114
+ "signature": "createMailOutbox(options)",
3115
+ "entrypoints": ["arcane-os/mail"],
3116
+ "primaryImport": "arcane-os/mail",
3117
+ "group": "Portable Mail",
3118
+ "summary": "Creates a MailOutbox from caller-owned storage, locking, delivery, and lifecycle adapters.",
3119
+ "availability": "Node or browser with the required injected outbox adapters",
3120
+ "protocol": "arcane-mail-outbox/1",
3121
+ "normalization": "Returns the same validated MailOutbox contract as direct construction"
3122
+ },
3123
+ {
3124
+ "id": "mail:default",
3125
+ "name": "default",
3126
+ "displayName": "Mail default export",
3127
+ "kind": "class",
3128
+ "signature": "default as Mail",
3129
+ "entrypoints": ["arcane-os/mail"],
3130
+ "primaryImport": "arcane-os/mail",
3131
+ "group": "Portable Mail",
3132
+ "summary": "Default package binding for the same Mail class exposed by the named export.",
3133
+ "availability": "Node with injected host adapters, or browser/native WebView with durable storage and Web Locks",
3134
+ "protocol": "arcane-mail-outbox/1 with native Arcane.mail or complete HTTP delivery",
3135
+ "normalization": "Binding identity is exactly equal to the named Mail export"
3136
+ },
3137
+ {
3138
+ "id": "mail:normalizeMailEndpoint",
3139
+ "name": "normalizeMailEndpoint",
3140
+ "displayName": "normalizeMailEndpoint()",
3141
+ "kind": "function",
3142
+ "signature": "normalizeMailEndpoint(endpoint, base=globalThis.location?.href)",
3143
+ "entrypoints": ["arcane-os/mail"],
3144
+ "primaryImport": "arcane-os/mail",
3145
+ "group": "Portable Mail",
3146
+ "summary": "Resolves and validates one credential-free HTTPS or loopback-HTTP Mail endpoint.",
3147
+ "availability": "Node and browser with URL support; relative endpoints require an explicit or global base URL",
3148
+ "protocol": "Arcane Mail HTTP transport",
3149
+ "normalization": "Returns an absolute URL and rejects credentials, query strings, fragments, and insecure non-loopback transport"
3150
+ },
3151
+ {
3152
+ "id": "mail:resolveMailConfig",
3153
+ "name": "resolveMailConfig",
3154
+ "displayName": "resolveMailConfig()",
3155
+ "kind": "function",
3156
+ "signature": "resolveMailConfig(config=globalThis.arcane?.config?.mail||{}, options={})",
3157
+ "entrypoints": ["arcane-os/mail"],
3158
+ "primaryImport": "arcane-os/mail",
3159
+ "group": "Portable Mail",
3160
+ "summary": "Resolves application identity, key, endpoint, and timeout from explicit or host Mail configuration.",
3161
+ "availability": "Node with explicit configuration, or browser/native WebView with optional document and location defaults",
3162
+ "protocol": "Arcane Mail configuration",
3163
+ "normalization": "Returns a mutable appName, appKey, endpoint, and requestTimeout record without initiating delivery"
3164
+ },
3165
+ {
3166
+ "id": "mail:sendMailReport",
3167
+ "name": "sendMailReport",
3168
+ "displayName": "sendMailReport()",
3169
+ "kind": "function",
3170
+ "signature": "sendMailReport({ appKey, appName, endpoint, fetchImpl=globalThis.fetch, report, reportKey, requestTimeout=null, serializedReport, signal })",
3171
+ "entrypoints": ["arcane-os/mail"],
3172
+ "primaryImport": "arcane-os/mail",
3173
+ "group": "Portable Mail",
3174
+ "summary": "Sends one complete Mail report with an idempotency key through HTTP.",
3175
+ "availability": "Node and browser with Fetch and AbortController, or an explicit fetch implementation",
3176
+ "protocol": "Arcane Mail HTTP transport",
3177
+ "normalization": "Validates request identity and complete body equality, preserves the complete response subject only to HTTP framing, and returns normalized acceptance or throws MailTransportError"
3178
+ },
3179
+ {
3180
+ "id": "mail:serializeMailReport",
3181
+ "name": "serializeMailReport",
3182
+ "displayName": "serializeMailReport()",
3183
+ "kind": "function",
3184
+ "signature": "serializeMailReport(report)",
3185
+ "entrypoints": ["arcane-os/mail"],
3186
+ "primaryImport": "arcane-os/mail",
3187
+ "group": "Portable Mail",
3188
+ "summary": "Serializes one JSON-object Mail report for exact request-body comparison and delivery.",
3189
+ "availability": "Node and browser",
3190
+ "protocol": "Arcane Mail HTTP transport",
3191
+ "normalization": "Returns compact JSON and rejects non-object or non-serializable reports"
3192
+ }
3193
+ ]
3194
+ }