arcane-os 0.57.0 → 0.58.0

package/docs/reference/git-text-snapshot.md

@@ -0,0 +1,104 @@
+# Complete Git text snapshots
+
+`createGitTextSnapshot` from `arcane-os` reads application-selected UTF-8 text
+from one fetched Git revision. It uses a dedicated **bare object cache**, not a
+clone with a working checkout. It never reads uncommitted application files,
+checks out files, modifies a user checkout/index, or creates another worktree.
+Construction performs no I/O. The native host needs Git available on its PATH;
+Git owns remote access, authentication and its actual failures.
+
+```js
+import {createGitTextSnapshot} from 'arcane-os';
+
+const snapshot = createGitTextSnapshot({
+    cacheDirectory: applicationCacheDirectory,
+    remote: applicationRepository,
+    ref: applicationRef,
+    selectPath: function selectMoonDispatches(filename) {
+        return filename.startsWith('dispatches/') && filename.endsWith('.md');
+    }
+});
+
+const {revision, files} = await snapshot.refresh({signal});
+// files: [{path: 'dispatches/cheese-emergency.md', content: completeText}]
+await snapshot.close();
+```
+
+The application owns its remote, ref, path policy, repository identity, refresh
+schedule and Core service factory. The SDK does not select `main`, poll, parse
+Markdown/YAML, label or rewrite documents, or choose a product RPC method.
+`selectPath(path)` may return a boolean or a promise of one. It receives each
+complete repository-relative leaf path in Git tree order. Keep the selector's
+policy stable for the lifetime of its snapshot owner.
+
+## API and lifecycle
+
+`createGitTextSnapshot({cacheDirectory,remote,ref,selectPath,onEvent,run})`
+returns `{refresh,close,drain,dispose}`. `run` defaults to the SDK's existing
+`runProcess`; applications normally omit it. It is the same process adapter
+contract, not a second process supervisor. `onEvent` is the ordinary SDK event
+callback and follows its asynchronous completion/error contract.
+
+- `refresh({signal}={})` fetches the selected ref and returns
+  `{revision,files:[{path,content}]}`. `revision` is Git's opaque selected commit
+  name, not an SDK integrity record. Every file comes from that exact revision,
+  even if the remote moves during retrieval. Order follows Git's tree listing.
+- Concurrent calls share the active refresh. A later call fetches again; when
+  the selected revision is unchanged, it reuses the completed text retrieval.
+  Returned arrays and records are independent copies, so caller edits do not
+  alter retained results. Failed refreshes report errors, never stale success.
+- A caller's abort cancels only that caller's wait. Accepted shared refresh
+  continues, including when every caller leaves. There is no incomplete result
+  presented as a complete snapshot. A pre-aborted call starts no work.
+- `close()`, `drain()` and `dispose()` are the same idempotent operation. They
+  stop acceptance and await accepted refresh work and its process/event cleanup.
+  Calls after close reject with `CORE_CLOSING`. A failure during drain rejects
+  close. Connect this hook to the Core service's `drain`/`dispose` lifecycle;
+  do not terminate its process before accepted work settles.
+
+One application service owns each cache directory. Sharing that mutable bare
+cache across independent instances or processes requires coordination by its
+application owner; this factory does not install a daemon or cross-process lock.
+An empty cache is initialized once. An existing non-bare checkout is rejected
+without repurposing it. The cache is retained when the owner closes.
+
+## Complete text and observable failures
+
+Content is the exact Git blob text, including whitespace, CRLF, newlines,
+leading BOM and embedded NUL characters. No checkout filters, `textconv`,
+normalization, trimming, truncation, freezing or application size gate applies.
+Symlink blobs expose their stored target text; they are never followed.
+Selected submodules are not text blobs and produce an explicit error rather
+than being skipped or fetched as another repository. A selected path or blob
+that cannot be decoded as UTF-8 fails with `ARCANE_GIT_SNAPSHOT_NOT_TEXT` instead
+of silently substituting replacement characters. Git errors and complete
+diagnostics remain available to the caller and the existing process event owner.
+
+`git.snapshot.refreshing`, `git.snapshot.completed` and `git.snapshot.failed`
+describe the shared operation. Completion data contains `{revision,reused}`;
+failure data contains the actual error. These events supplement the complete
+result, never replace it. An event callback must not await a new refresh of the
+same owner from inside the operation it is currently observing.
+
+Initial refresh performs bare initialization/role discovery, then fetch,
+revision resolution, one tree listing and one batched blob process. Later
+unchanged revisions need only fetch and revision resolution. A changed revision
+uses one tree process and one blob process regardless of the selected file
+count. An empty selection needs no blob process. Blob requests use the shared
+async process-input owner; raw stdout is consumed by the Git parser with
+backpressure. Git's encoded body extent and object names remain local to its
+[batch protocol](https://git-scm.com/docs/git-cat-file#_batch_output); they do
+not become product metadata, byte progress, admission or integrity policy.
+
+## Core service composition
+
+The application wraps this mechanism in its own service factory and supplies its
+own public method and result fields. The handler can pass `context.signal` to
+`refresh` for request cancellation, then map `revision` to its chosen remote-ref
+field without changing any `content`. Return the snapshot owner's `drain` and
+`dispose` hooks from that service. Native launch configuration selects the
+cache location; browser code does not launch Git or reconstruct its protocol.
+
+This contract is portable Node source for Windows, Linux and macOS. Android
+requires a host that supplies the same Git/process capability; it is not a
+claim that every Android host ships Git.

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

@@ -1,23 +1,121 @@
 {
   "schemaVersion": 1,
-  "sdkVersion": "0.56.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": 254,
+  "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,id='llama.cpp'}={})",
+      "signature": "createCoreLocalAIProvider({client=getInstalledCoreClient(),id='llama.cpp'}={})",
       "entrypoints": ["arcane-os/ai/core-local"],
       "primaryImport": "arcane-os/ai/core-local",
       "group": "Core local AI",
@@ -35,9 +133,9 @@
       "entrypoints": ["arcane-os/core/local-ai"],
       "primaryImport": "arcane-os/core/local-ai",
       "group": "Core local AI",
-      "summary": "Composes selected native llama.cpp and Ollama engines as a Core service with retained process ownership and model lifecycle.",
+      "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 and Ollama native HTTP/NDJSON",
+      "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"
     },
     {
@@ -59,13 +157,13 @@
       "name": "ensureLocalAIRuntimes",
       "displayName": "ensureLocalAIRuntimes()",
       "kind": "function",
-      "signature": "ensureLocalAIRuntimes({runtimes=[],directory,platform,architecture,signal,onEvent}={})",
+      "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 and Ollama distributions.",
+      "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 downloads and host archive extraction",
+      "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"
     },
     {
@@ -73,7 +171,7 @@
       "name": "bundleLocalAIRuntimes",
       "displayName": "bundleLocalAIRuntimes()",
       "kind": "function",
-      "signature": "bundleLocalAIRuntimes({runtimes=[],directory,outputRoot,platform,architecture,signal,onEvent}={})",
+      "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",
@@ -1114,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"
@@ -1860,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",
@@ -2012,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"
@@ -3779,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",
@@ -3814,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",
@@ -3835,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",
@@ -3905,7 +4003,7 @@
       "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",
@@ -3984,12 +4082,96 @@
       "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": "readCoreLaunchContext({argv=process.argv.slice(2)}={})",
+      "signature": "async readCoreLaunchContext({argv=process.argv.slice(2)}={})",
       "entrypoints": ["arcane-os/core/host"],
       "primaryImport": "arcane-os/core/host",
       "group": "Native Core host composition",