arcane-os 0.56.0 → 0.58.0

package/docs/reference/inventory/package-api.json

@@ -1,17 +1,185 @@
 {
   "schemaVersion": 1,
-  "sdkVersion": "0.55.0",
+  "sdkVersion": "0.57.0",
   "environment": {
     "runtime": "Node.js for Node entrypoints; browser for browser-only entrypoints",
     "minimumVersion": "22.23.2 for Node entrypoints",
     "moduleSystem": "ESM"
   },
-  "memberCount": 244,
+  "memberCount": 267,
   "runtimeSubpathPatterns": {
     "arcane-os/modules/*": "./runtime/arcane/modules/*",
     "arcane-os/entities/*": "./runtime/arcane/entities/*"
   },
   "members": [
+    {
+      "id": "local-ai-onnx:createONNXRuntime",
+      "name": "createONNXRuntime",
+      "displayName": "createONNXRuntime()",
+      "kind": "function",
+      "signature": "createONNXRuntime({modulePath,signal,onEvent}={})",
+      "entrypoints": ["arcane-os/local-ai/onnx"],
+      "primaryImport": "arcane-os/local-ai/onnx",
+      "group": "Core local AI",
+      "summary": "Owns explicitly loaded ONNX graphs and complete named tensor inference in retained native workers.",
+      "availability": "Node on Windows/Linux/macOS x64/arm64 with prepared onnxruntime-node; Android needs host adaptation",
+      "protocol": "Per-session worker lifecycle with structured-clone tensors and replaying state",
+      "normalization": "Returns load/run/unload/current/subscribe/close; explicit model and session IDs; native calls may delay worker termination, and close observes actual exit"
+    },
+    {
+      "id": "core-onnx:createCoreONNXRuntime",
+      "name": "createCoreONNXRuntime",
+      "displayName": "createCoreONNXRuntime()",
+      "kind": "function",
+      "signature": "createCoreONNXRuntime({client=getInstalledCoreClient()}={})",
+      "entrypoints": ["arcane-os/ai/core-onnx"],
+      "primaryImport": "arcane-os/ai/core-onnx",
+      "group": "Core local AI",
+      "summary": "Accesses local system ONNX through an existing Core client with complete tensor transport.",
+      "availability": "Browser with available Core ONNX service; construction installs no runtime or model",
+      "protocol": "arcane/1 onnx.status/load/run/unload and localai.state",
+      "normalization": "Returns load/run/unload/inspect/current/subscribe/close; preserves typed and string tensors; accessor close cancels its requests without closing shared Core or implicitly unloading shared models"
+    },
+    {
+      "id": "root:createGitTextSnapshot",
+      "name": "createGitTextSnapshot",
+      "displayName": "createGitTextSnapshot()",
+      "kind": "function",
+      "signature": "createGitTextSnapshot({cacheDirectory,remote,ref,selectPath,onEvent,run=runProcess}={})",
+      "entrypoints": ["arcane-os"],
+      "primaryImport": "arcane-os",
+      "group": "Workspace, doctor, repository, and server",
+      "summary": "Reads complete selected text from one fetched revision using a dedicated bare Git object cache and batched retrieval.",
+      "availability": "Node with Git; Android requires a host supplying Git/process capability",
+      "protocol": "Git tree and batched blob transport through the shared process owner",
+      "normalization": "Returns {refresh,close,drain,dispose}; refresh yields {revision,files:[{path,content}]}, shares concurrent work, reuses unchanged revisions, preserves exact UTF-8 text, isolates caller cancellation and drains accepted work. See git-text-snapshot.md."
+    },
+    {
+      "id": "diarization:createDiarization",
+      "name": "createDiarization",
+      "displayName": "createDiarization()",
+      "kind": "function",
+      "signature": "createDiarization({executable,modelPath,runtime,onEvent}={})",
+      "entrypoints": ["arcane-os/diarization"],
+      "primaryImport": "arcane-os/diarization",
+      "group": "Native speaker diarization",
+      "summary": "Retains one selected Nemotron 3 model helper and independently owned caller-fed audio streams.",
+      "availability": "Node with a host-built first-party helper, official NeMo-Speech.cpp CPU libraries and caller-selected model",
+      "protocol": "Owned native helper transport and replayable model lifecycle; mono Float32 audio streams",
+      "normalization": "Preserves complete audio, timed segments and requested probability frames; generic speaker labels are not person identity; finish/cancel/close retain native drain and complete failures"
+    },
+    {
+      "id": "diarization-build:buildDiarizationHelper",
+      "name": "buildDiarizationHelper",
+      "displayName": "buildDiarizationHelper()",
+      "kind": "function",
+      "signature": "async buildDiarizationHelper({runtime,outputRoot,signal,onEvent}={})",
+      "entrypoints": ["arcane-os/diarization/build"],
+      "primaryImport": "arcane-os/diarization/build",
+      "group": "Native speaker diarization",
+      "summary": "Builds the first-party helper against the explicitly installed NeMoSpeech Diarization component.",
+      "availability": "Node, installed CMake/C++17 toolchain and matching official CPU runtime for the current host",
+      "protocol": "CMake configure, build and install using runtime.cmakeDirectory",
+      "normalization": "Returns actual platform, architecture, root, executable and complete diagnostics; no compiler or model download"
+    },
+    {
+      "id": "core-diarization:createDiarizationService",
+      "name": "createDiarizationService",
+      "displayName": "createDiarizationService()",
+      "kind": "function",
+      "signature": "createDiarizationService(options={},launch={})",
+      "entrypoints": ["arcane-os/core/diarization"],
+      "primaryImport": "arcane-os/core/diarization",
+      "group": "Native speaker diarization",
+      "summary": "Composes lazy native diarization as an application-selected Core service.",
+      "availability": "Node Core runtime with explicitly selected helper, runtime and model",
+      "protocol": "arcane/1 diarization methods and state/update/probability events; f32le audio transport",
+      "normalization": "Resolves relative paths from selected workspaceRoot or appRoot; session audio uses service lifetime, recording cancellation is independent, and model loading never blocks Core startup"
+    },
+    {
+      "id": "core-diarization:default",
+      "name": "default",
+      "displayName": "createDiarizationService default export",
+      "kind": "function",
+      "signature": "default as createDiarizationService",
+      "entrypoints": ["arcane-os/core/diarization"],
+      "primaryImport": "arcane-os/core/diarization",
+      "group": "Native speaker diarization",
+      "summary": "Default binding for the same native Core diarization service factory.",
+      "availability": "Node Core runtime",
+      "protocol": "arcane/1 service definition",
+      "normalization": "Binding identity equals the named createDiarizationService export"
+    },
+    {
+      "id": "core-local:createCoreLocalAIProvider",
+      "name": "createCoreLocalAIProvider",
+      "displayName": "createCoreLocalAIProvider()",
+      "kind": "function",
+      "signature": "createCoreLocalAIProvider({client=getInstalledCoreClient(),id='llama.cpp'}={})",
+      "entrypoints": ["arcane-os/ai/core-local"],
+      "primaryImport": "arcane-os/ai/core-local",
+      "group": "Core local AI",
+      "summary": "Browser llama.cpp provider through an explicitly connected Core, with application-owned model selection and complete response streaming.",
+      "availability": "Browser with an available Core local AI service; construction installs no runtime or model",
+      "protocol": "arcane-ai-provider/2 LLM lifecycle over arcane/1",
+      "normalization": "Preserves complete payloads and original parsed chunks; waits for the exact requested model and cancels on observed readiness loss"
+    },
+    {
+      "id": "core-local-ai:createLocalAIService",
+      "name": "createLocalAIService",
+      "displayName": "createLocalAIService()",
+      "kind": "function",
+      "signature": "createLocalAIService(configuration,{appRoot,runtimes=[],signal,onEvent}={})",
+      "entrypoints": ["arcane-os/core/local-ai"],
+      "primaryImport": "arcane-os/core/local-ai",
+      "group": "Core local AI",
+      "summary": "Composes selected native llama.cpp, Ollama and ONNX engines as a Core service with retained process/worker ownership and model lifecycle.",
+      "availability": "Node with selected upstream runtime distributions or available configured system services",
+      "protocol": "arcane/1 methods and events; llama.cpp OpenAI HTTP/SSE, Ollama native HTTP/NDJSON and ONNX tensor transport",
+      "normalization": "Application-owned runtime and model requirements; independent startup, complete responses and exact owned-process cleanup"
+    },
+    {
+      "id": "core-local-ai:default",
+      "name": "default",
+      "displayName": "createLocalAIService default export",
+      "kind": "function",
+      "signature": "default as createLocalAIService",
+      "entrypoints": ["arcane-os/core/local-ai"],
+      "primaryImport": "arcane-os/core/local-ai",
+      "group": "Core local AI",
+      "summary": "Default binding for the same native Core local AI service factory.",
+      "availability": "Node",
+      "protocol": "arcane/1 service definition",
+      "normalization": "Binding identity equals the named createLocalAIService export"
+    },
+    {
+      "id": "local-ai:ensureLocalAIRuntimes",
+      "name": "ensureLocalAIRuntimes",
+      "displayName": "ensureLocalAIRuntimes()",
+      "kind": "function",
+      "signature": "async ensureLocalAIRuntimes({runtimes=[],directory,platform=process.platform,architecture=process.arch,signal,onEvent}={})",
+      "entrypoints": ["arcane-os/local-ai"],
+      "primaryImport": "arcane-os/local-ai",
+      "group": "Core local AI",
+      "summary": "Reuses selected managed native runtimes or installs complete official llama.cpp/Ollama distributions, ONNX npm runtime trees or NeMo libraries.",
+      "availability": "Node; upstream platform and architecture assets determine runtime availability",
+      "protocol": "Official upstream release archives or selected ONNX npm installation",
+      "normalization": "Returns absolute runtime records; shares matching concurrent installs, preserves libraries and reports failures without changing global PATH or services"
+    },
+    {
+      "id": "local-ai:bundleLocalAIRuntimes",
+      "name": "bundleLocalAIRuntimes",
+      "displayName": "bundleLocalAIRuntimes()",
+      "kind": "function",
+      "signature": "async bundleLocalAIRuntimes({runtimes=[],directory,outputRoot,platform=process.platform,architecture=process.arch,signal,onEvent}={})",
+      "entrypoints": ["arcane-os/local-ai"],
+      "primaryImport": "arcane-os/local-ai",
+      "group": "Core local AI",
+      "summary": "Copies selected complete runtime distributions into a fresh native artifact staging root.",
+      "availability": "Node; supports bundling published upstream platform assets independently of the build host",
+      "protocol": "Artifact-relative runtime/local-ai layout",
+      "normalization": "Returns {runtimes,files} with relative runtime records and the complete emitted inventory; model resources remain application-owned"
+    },
     {
       "id": "root:WS",
       "name": "WS",
@@ -380,7 +548,7 @@
       ],
       "primaryImport": "arcane-os",
       "group": "Headless toolchain operations",
-      "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.",
+      "summary": "Packages the selected app and builds one explicitly selected target; paired native assembly applies each selected and bundled app's nativeResources and separate input output directory, preserving complete release records and explicit providers. Tests or checks run only when explicitly requested or required for the selected release output.",
       "availability": "Node; selected operation may produce browser or native output",
       "protocol": "Shared headless operation API + arcane-cli-events/1",
       "normalization": "SDK-normalized inputs, errors, events, and documented result"
@@ -937,14 +1105,14 @@
       "name": "inspectApp",
       "displayName": "inspectApp()",
       "kind": "function",
-      "signature": "async inspectApp({workspaceRoot, appId, signal}={})",
+      "signature": "async inspectApp({workspaceRoot, appId, signal, target, outputDirectory}={})",
       "entrypoints": [
         "arcane-os",
         "arcane-os/packager"
       ],
       "primaryImport": "arcane-os",
       "group": "Packaging and release bundles",
-      "summary": "Loads one validated packager app plan, including the shared descriptor-admitted browser document inventory and final workspace-relative output selected by app outputDirectory or default dist/appId.",
+      "summary": "Inspects one complete app plan without copying files. Target defaults to browser; nonbrowser selection adds explicit nativeResources outside browserDocuments and uses dist/.native/target/appId for a nonempty native include list. Explicit operation outputDirectory wins; other calls retain the saved outputDirectory or dist/appId.",
       "availability": "Node",
       "protocol": "SDK packager and deterministic bundle contract",
       "normalization": "Normalized SDK validation with complete canonical archive and release content"
@@ -1044,7 +1212,7 @@
       ],
       "primaryImport": "arcane-os",
       "group": "Targets, native plans, and providers",
-      "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.",
+      "summary": "Loads the installed SDK provider for portable or windows-x64 when arcaneRoot is omitted, or retains the explicitly selected Arcane OS checkout provider route.",
       "availability": "Node; selected browser/native target or provider as documented",
       "protocol": "arcane-target-adapter/1, arcane-native-build-plan/1, or provider protocol",
       "normalization": "Normalized complete plan and result; target-specific artifact detail preserved"
@@ -1239,7 +1407,7 @@
       ],
       "primaryImport": "arcane-os",
       "group": "Packaging and release bundles",
-      "summary": "Builds one selected browser application release into app outputDirectory or default dist/appId through staged whole-directory replacement, preserving source and unrelated prior destinations; it never runs tests or checks automatically.",
+      "summary": "Builds one complete app release with browser selection by default. Nonbrowser targets add explicit nativeResources through a late complete-content copy and separate native input output; moduleFormat is independent. Adapters receive actual target and effective browserPwa. Explicit operation outputDirectory wins; staged replacement preserves source and unrelated outputs. No tests or checks run automatically.",
       "availability": "Node",
       "protocol": "SDK packager and deterministic bundle contract",
       "normalization": "Normalized SDK validation with complete canonical archive and release content"
@@ -1256,7 +1424,7 @@
       ],
       "primaryImport": "arcane-os",
       "group": "Headless toolchain operations",
-      "summary": "Runs the high-level package operation for one selected application using the same app-selected final outputDirectory, defaulting to dist/appId, with no separate destination override.",
+      "summary": "Runs the high-level browser package operation for one selected application using the saved outputDirectory or dist/appId, with no separate destination override. Paired native buildApplication separately applies actual target and nativeResources selection.",
       "availability": "Node; selected operation may produce browser or native output",
       "protocol": "Shared headless operation API + arcane-cli-events/1",
       "normalization": "SDK-normalized inputs, errors, events, and documented result"
@@ -1370,7 +1538,7 @@
       ],
       "primaryImport": "arcane-os",
       "group": "Runtime and app descriptors",
-      "summary": "Projects a schema-2 descriptor into the compatible schema-1 application package contract.",
+      "summary": "Projects a schema-2 descriptor into the compatible schema-1 package contract, including optional package.nativeResources as top-level nativeResources; omitted selection stays omitted, empty include stays empty, and omitted exclude becomes an empty array.",
       "availability": "Node",
       "protocol": "Node ESM",
       "normalization": "SDK-normalized inputs, errors, events, and documented result"
@@ -1790,16 +1958,16 @@
       "name": "runProcess",
       "displayName": "runProcess()",
       "kind": "function",
-      "signature": "async runProcess(command, args=[], { cwd, env, signal, onEvent, heartbeatMs=5000, terminationGraceMs=DEFAULT_TERMINATION_GRACE_MS, allowNonzero=false, input }={})",
+      "signature": "async runProcess(command, args=[], { cwd, env, signal, onEvent, onOutput, captureOutput=true, emitOutputEvents=true, outputEncoding='utf8', heartbeatMs=5000, terminationGraceMs=DEFAULT_TERMINATION_GRACE_MS, allowNonzero=false, input, cancellationMode='terminate-tree' }={})",
       "entrypoints": [
         "arcane-os"
       ],
       "primaryImport": "arcane-os",
       "group": "Events, processes, and testing",
-      "summary": "Runs one shell-free child command with complete stdout and stderr, ordered stream events, heartbeats, and process-tree cancellation.",
+      "summary": "Runs one shell-free child command with complete output and ordered events; default tree termination or explicit close-input cancellation waits for the selected child lifecycle.",
       "availability": "Node",
       "protocol": "Node ESM / owned process or test lifecycle",
-      "normalization": "SDK event/error/report normalization"
+      "normalization": "Defaults to complete UTF-8 capture/events. AsyncIterable input and awaited onOutput retain backpressure. Explicit null outputEncoding delivers native Buffers only to a selected onOutput owner with capture and line events disabled for that stream; failures retain complete chunks and drained process diagnostics."
     },
     {
       "id": "root:runRegisteredTests",
@@ -1942,7 +2110,7 @@
       ],
       "primaryImport": "arcane-os",
       "group": "Workspace, doctor, repository, and server",
-      "summary": "Starts one owned browser development server with exact runtime/app route mappings and an unguessable session capability.",
+      "summary": "Starts an owned source or packaged browser server with complete selected routes, HTTPS by default, explicit HTTP selection, listener readiness and shutdown.",
       "availability": "Node control plane; browser data plane",
       "protocol": "Node ESM",
       "normalization": "SDK-normalized inputs, errors, events, and documented result"
@@ -2073,7 +2241,7 @@
       ],
       "primaryImport": "arcane-os/packager",
       "group": "Packaging and release bundles",
-      "summary": "Validates one schema-1 packager app configuration and its relationship to the root config, including optional workspace-relative final outputDirectory without changing source layout or app identity.",
+      "summary": "Validates one schema-1 packager app configuration, optional nativeResources literal include/exclude selection and workspace-relative outputDirectory without changing source layout or app identity. Native include may be empty; exclude defaults to an empty array.",
       "availability": "Node",
       "protocol": "SDK packager and deterministic bundle contract",
       "normalization": "Normalized SDK validation with complete canonical archive and release content"
@@ -2172,7 +2340,7 @@
       ],
       "primaryImport": "arcane-os",
       "group": "Packaging and release bundles",
-      "summary": "Authenticates one existing browser app release through the low-level packager API.",
+      "summary": "Reads an existing app release and compares its complete file inventory with its manifest. Pass a target-selected native release's output as outputDirectory; this API does not infer a native target or execute services or hosts.",
       "availability": "Node",
       "protocol": "SDK packager and deterministic bundle contract",
       "normalization": "Normalized SDK validation with complete canonical archive and release content"
@@ -3709,14 +3877,14 @@
       "name": "createCoreClient",
       "displayName": "createCoreClient()",
       "kind": "function",
-      "signature": "createCoreClient({global=globalThis,transport=null,eventOwner=arcaneEvents,eventOwnerReady,autoConnect=true,replayRuntimeState=false,onError}={})",
+      "signature": "createCoreClient({global=globalThis,transport=null,eventOwner=arcaneEvents,eventOwnerReady,autoConnect=true,replayRuntimeState=false,webKitDocumentLifecycle=false,onError}={})",
       "entrypoints": ["arcane-os/core/client"],
       "primaryImport": "arcane-os/core/client",
       "group": "Core browser client",
       "summary": "Creates one correlated Arcane Core RPC client with explicit transport, readiness, events, cancellation and lifetime ownership.",
       "availability": "Browser and native WebView JavaScript hosts; custom transports require a callable send(frame)",
       "protocol": "arcane/1 over the selected host transport",
-      "normalization": "Preserves complete request, result and event data; retains FIFO event-owner handoff; failTransport(error) settles pending RPCs and acknowledgements with the complete failure and releases the client lifetime; opt-in replayRuntimeState sends one observed nonblocking runtime.replay control after transport readiness"
+      "normalization": "Preserves complete request, result and event data; retains FIFO event-owner handoff; failTransport(error) settles pending RPCs and acknowledgements with the complete failure and releases the client lifetime; opt-in replayRuntimeState sends one observed nonblocking runtime.replay control after transport readiness. Optional webKitDocumentLifecycle selects WithReply activate/frame/retire metadata outside unchanged Core JSON, synchronous acceptsNativeDelivery(activation), guarded receive/failure delivery, page-hide retirement and fresh restored activation with current-state replay. Requests cancelled while awaiting attachment are never submitted afterward. Subscriptions survive restoration; retired renderer promises abort while accepted service-lifetime work continues. Existing transport behavior is unchanged when omitted; see core-client.md for the native ownership and acknowledgement contract"
     },
     {
       "id": "core-client:createCoreFacade",
@@ -3744,7 +3912,7 @@
       "summary": "Installs one synchronous global Arcane facade, native receive callback and terminal transport-failure callback for the selected renderer lifetime.",
       "availability": "Browser and native WebView JavaScript hosts",
       "protocol": "arcane/1 renderer facade",
-      "normalization": "Repeated installation returns the same client; close/failTransport release owned resources and restore prior globals only while still owned; __arcaneTransportFailed preserves the complete host failure without killing Core"
+      "normalization": "Repeated installation returns the same client; close/failTransport release owned resources and restore prior globals only while still owned; __arcaneTransportFailed preserves the complete host failure without killing Core. Forwards optional webKitDocumentLifecycle:false by default; when selected, __arcaneWebKitDocumentCurrent(activation) probes the executing realm and __arcaneReceive(json,activation)/__arcaneTransportFailed(error,activation) reject delivery to retired or different activations before changing installation ownership"
     },
     {
       "id": "core-client:getInstalledCoreClient",
@@ -3765,14 +3933,14 @@
       "name": "createCoreClassicSource",
       "displayName": "createCoreClassicSource()",
       "kind": "function",
-      "signature": "async createCoreClassicSource({eventOwnerModuleURL,replayRuntimeState=false}={})",
+      "signature": "async createCoreClassicSource({eventOwnerModuleURL,replayRuntimeState=false,webKitDocumentLifecycle=false}={})",
       "entrypoints": ["arcane-os/core/classic-source"],
       "primaryImport": "arcane-os/core/classic-source",
       "group": "Core classic client projection",
       "summary": "Generates the native host's classic injection script from the installed canonical Core client and contracts.",
       "availability": "Node; generated source runs in browser and native WebView renderers",
       "protocol": "arcane/1 classic-script injection",
-      "normalization": "Returns the complete canonical client projection; installs synchronous facade shapes while deferring only the event-owner module connection when document parsing is incomplete; forwards explicit runtime replay selection with a false default"
+      "normalization": "Returns the complete canonical client projection; installs synchronous facade shapes while deferring only the event-owner module connection when document parsing is incomplete; forwards explicit replayRuntimeState and webKitDocumentLifecycle selections with false defaults. Optional WebKit lifetime requires a native WithReply lifecycle host and the existing runtime.replay control; restoration requests current state after fresh activation while rendering and independent Core startup continue"
     },
     {
       "id": "core-runtime:createCoreRuntime",
@@ -3835,14 +4003,14 @@
       "name": "createPortableNativeProvider",
       "displayName": "createPortableNativeProvider()",
       "kind": "function",
-      "signature": "createPortableNativeProvider({services=[]}={})",
+      "signature": "createPortableNativeProvider({services,packagedWeb=false,webKitDocumentLifecycle=false}={})",
       "entrypoints": ["arcane-os/native/portable-provider"],
       "primaryImport": "arcane-os/native/portable-provider",
       "group": "Portable native provider",
       "summary": "Creates the SDK-owned provider that assembles one selected app and explicit services into a portable Core payload.",
       "availability": "Node; produces a portable payload rather than an executable host",
       "protocol": "arcane-native-builder/1 portable provider",
-      "normalization": "Preserves complete selected app and dependency releases, uses explicit service module factories, reports executable:false and never substitutes for an unavailable platform host"
+      "normalization": "Preserves complete selected app and dependency releases; an explicit services selection overrides appDescriptor.native.services, otherwise the descriptor selection is used; reports executable:false and never substitutes for an unavailable platform host"
     },
     {
       "id": "native-portable-provider:arcaneNativeBuilderProvider",
@@ -3872,6 +4040,146 @@
       "protocol": "arcane-native-builder/1 portable provider",
       "normalization": "Binding identity is exactly equal to the named arcaneNativeBuilderProvider export"
     },
+    {
+      "id": "native-windows-provider:createWindowsNativeProvider",
+      "name": "createWindowsNativeProvider",
+      "displayName": "createWindowsNativeProvider()",
+      "kind": "function",
+      "signature": "createWindowsNativeProvider({services,hostDirectory}={})",
+      "entrypoints": ["arcane-os/native/windows-provider"],
+      "primaryImport": "arcane-os/native/windows-provider",
+      "group": "Windows native provider",
+      "summary": "Assembles selected application services and browser content with the SDK-owned Windows x64 WebView2 and SEA host.",
+      "availability": "Node for assembly; Windows x64 with WebView2 Runtime for execution",
+      "protocol": "arcane-native-builder/1 windows-x64 provider",
+      "normalization": "Uses a selected hostDirectory or the exact installed SDK version's numeric release asset; preserves complete payloads; run cancellation closes stdin and waits for host-owned graceful shutdown"
+    },
+    {
+      "id": "native-windows-provider:arcaneNativeBuilderProvider",
+      "name": "arcaneNativeBuilderProvider",
+      "displayName": "arcaneNativeBuilderProvider",
+      "kind": "singleton",
+      "signature": "const arcaneNativeBuilderProvider",
+      "entrypoints": ["arcane-os/native/windows-provider"],
+      "primaryImport": "arcane-os/native/windows-provider",
+      "group": "Windows native provider",
+      "summary": "SDK-owned Windows provider selected by the ordinary windows-x64 build command without an OS checkout.",
+      "availability": "Node for assembly; Windows x64 with WebView2 Runtime for execution",
+      "protocol": "arcane-native-builder/1 windows-x64 provider",
+      "normalization": "Uses appDescriptor.native.services and the exact SDK release host asset; binding is identical to the default export"
+    },
+    {
+      "id": "native-windows-provider:default",
+      "name": "default",
+      "displayName": "arcaneNativeBuilderProvider default export",
+      "kind": "singleton",
+      "signature": "default as arcaneNativeBuilderProvider",
+      "entrypoints": ["arcane-os/native/windows-provider"],
+      "primaryImport": "arcane-os/native/windows-provider",
+      "group": "Windows native provider",
+      "summary": "Default binding for the SDK Windows executable provider.",
+      "availability": "Node for assembly; Windows x64 with WebView2 Runtime for execution",
+      "protocol": "arcane-native-builder/1 windows-x64 provider",
+      "normalization": "Binding identity is exactly equal to the named arcaneNativeBuilderProvider export"
+    },
+    {
+      "id": "native-macos-provider:createMacOSNativeProvider",
+      "name": "createMacOSNativeProvider",
+      "displayName": "createMacOSNativeProvider()",
+      "kind": "function",
+      "signature": "createMacOSNativeProvider({services,hostDirectory}={})",
+      "entrypoints": ["arcane-os/native/macos-provider"],
+      "primaryImport": "arcane-os/native/macos-provider",
+      "group": "macOS native provider",
+      "summary": "Composes a complete selected portable payload with the architecture-selected SDK Mac host in an application bundle.",
+      "availability": "Node assembly; matching Darwin architecture and selected host artifact for execution",
+      "protocol": "arcane-native-builder/1 macos-arm64 and macos-x64 provider",
+      "normalization": "Resources remains target.rootDir; bundleRoot names the app bundle; selected hostDirectory or exact-version host assets; run closes stdin and awaits graceful drain; source availability does not establish artifact publication or Mac execution"
+    },
+    {
+      "id": "native-macos-provider:arcaneNativeBuilderProvider",
+      "name": "arcaneNativeBuilderProvider",
+      "displayName": "arcaneNativeBuilderProvider",
+      "kind": "singleton",
+      "signature": "const arcaneNativeBuilderProvider",
+      "entrypoints": ["arcane-os/native/macos-provider"],
+      "primaryImport": "arcane-os/native/macos-provider",
+      "group": "macOS native provider",
+      "summary": "SDK-owned Mac provider selected by macos-arm64 and macos-x64 CLI routes.",
+      "availability": "Node assembly; matching Darwin architecture and selected host artifact for execution",
+      "protocol": "arcane-native-builder/1",
+      "normalization": "Uses descriptor services and selected exact-version host; identical to the default binding"
+    },
+    {
+      "id": "native-macos-provider:default",
+      "name": "default",
+      "displayName": "arcaneNativeBuilderProvider default export",
+      "kind": "singleton",
+      "signature": "default as arcaneNativeBuilderProvider",
+      "entrypoints": ["arcane-os/native/macos-provider"],
+      "primaryImport": "arcane-os/native/macos-provider",
+      "group": "macOS native provider",
+      "summary": "Default binding for the same SDK Mac native provider.",
+      "availability": "Node assembly; matching Darwin architecture and selected host artifact for execution",
+      "protocol": "arcane-native-builder/1",
+      "normalization": "Identical to named arcaneNativeBuilderProvider export"
+    },
+    {
+      "id": "core-packaged-web:createPackagedWebService",
+      "name": "createPackagedWebService",
+      "displayName": "createPackagedWebService()",
+      "kind": "function",
+      "signature": "createPackagedWebService({artifactRoot},context={})",
+      "entrypoints": ["arcane-os/core/packaged-web"],
+      "primaryImport": "arcane-os/core/packaged-web",
+      "group": "Native packaged web serving",
+      "summary": "Owns one packaged HTTP listener, persisted loopback port, real readiness and draining shutdown inside Core.",
+      "availability": "Node Core service lifetime",
+      "protocol": "arcane/1 core.web.ready and core.web.failed events",
+      "normalization": "Preserves full webRoot and start URL; stateRoot keeps the selected port across launches; no origin fallback on conflicts; unchanged launch record; explicit ready/failure events and complete listener lifecycle"
+    },
+    {
+      "id": "core-preferences:createPreferencesService",
+      "name": "createPreferencesService",
+      "displayName": "createPreferencesService()",
+      "kind": "function",
+      "signature": "createPreferencesService({file}={})",
+      "entrypoints": ["arcane-os/core/preferences"],
+      "primaryImport": "arcane-os/core/preferences",
+      "group": "Core preference persistence",
+      "summary": "Supplies the five existing preference RPC methods with application-selected file storage.",
+      "availability": "Node Core runtime",
+      "protocol": "arcane/1 preferences methods and schemaVersion 1 entries file",
+      "normalization": "Preserves exact keys, complete JSON values and existing metadata; writes use service lifetime and flush before acknowledgment; unreadable files remain untouched and drain waits for accepted work"
+    },
+    {
+      "id": "core-preferences:default",
+      "name": "default",
+      "displayName": "createPreferencesService default export",
+      "kind": "function",
+      "signature": "default as createPreferencesService",
+      "entrypoints": ["arcane-os/core/preferences"],
+      "primaryImport": "arcane-os/core/preferences",
+      "group": "Core preference persistence",
+      "summary": "Default binding for the same Core preferences service factory.",
+      "availability": "Node Core runtime",
+      "protocol": "arcane/1 preferences methods and schemaVersion 1 entries file",
+      "normalization": "Binding identity is exactly equal to the named createPreferencesService export"
+    },
+    {
+      "id": "core-host:readCoreLaunchContext",
+      "name": "readCoreLaunchContext",
+      "displayName": "readCoreLaunchContext()",
+      "kind": "function",
+      "signature": "async readCoreLaunchContext({argv=process.argv.slice(2)}={})",
+      "entrypoints": ["arcane-os/core/host"],
+      "primaryImport": "arcane-os/core/host",
+      "group": "Native Core host composition",
+      "summary": "Reads the complete JSON object explicitly selected by --arcane-launch-config for native service launch context.",
+      "availability": "Node, including the selected external-entry SEA launcher",
+      "protocol": "Explicit launch arguments and JSON configuration",
+      "normalization": "Returns an empty record without the flag; preserves every supplied field and value, surfaces file and JSON failures, and performs no configuration search, rewrite or environment mutation"
+    },
     {
       "id": "core-host:startCoreHost",
       "name": "startCoreHost",