arcane-os 0.57.0 → 0.59.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arcane-os",
-  "version": "0.57.0",
+  "version": "0.59.0",
   "description": "Arcane OS JavaScript SDK, project-local CLI, browser runtime, and repository-portable application packager.",
   "type": "module",
   "main": "./src/index.mjs",
@@ -40,6 +40,7 @@
     "./speech-text": "./browser-runtime/speech-text.mjs",
     "./ai/browser-wasm": "./browser-runtime/ai/browser-wasm.mjs",
     "./ai/core-local": "./browser-runtime/ai/core-local.mjs",
+    "./ai/core-onnx": "./browser-runtime/ai/core-onnx.mjs",
     "./ai/browser-decisions": "./browser-runtime/ai/browser-decisions.mjs",
     "./ai/tool-text-stream": "./browser-runtime/ai/tool-text-stream.mjs",
     "./ai/twin-cloud": "./browser-runtime/ai/twin-cloud.mjs",
@@ -51,14 +52,21 @@
     "./native-provider": "./src/native-provider-loader.mjs",
     "./native/portable-provider": "./src/native/portable-provider.mjs",
     "./native/windows-provider": "./src/native/windows-provider.mjs",
+    "./native/macos-provider": "./src/native/macos-provider.mjs",
     "./core/client": "./browser-runtime/core/client.mjs",
     "./core/contracts": "./browser-runtime/core/contracts.mjs",
     "./core/classic-source": "./src/core-classic-source.mjs",
     "./core/runtime": "./src/core/runtime.mjs",
     "./core/stdio": "./src/core/stdio.mjs",
     "./core/host": "./src/core/host.mjs",
+    "./core/packaged-web": "./src/core/services/packaged-web.mjs",
+    "./core/preferences": "./src/core/services/preferences.mjs",
+    "./core/diarization": "./src/diarization/service.mjs",
     "./core/local-ai": "./src/core/services/local-ai.mjs",
+    "./diarization": "./src/diarization/index.mjs",
+    "./diarization/build": "./src/diarization/build.mjs",
     "./local-ai": "./src/local-ai/install.mjs",
+    "./local-ai/onnx": "./src/local-ai/onnx.mjs",
     "./integrated-provider": "./src/integrated-provider-loader.mjs",
     "./packager": "./src/packager/core.mjs",
     "./release-bundle": "./src/release-bundle.mjs",
@@ -100,8 +108,8 @@
     "test": "npm run test:unit && npm run test:functional && npm run test:integration && npm run test:regression",
     "test:release": "node ./bin/arcane-test.mjs test/npm-release.test.mjs",
     "test:unit": "node ./bin/arcane-test.mjs test/app-descriptor.test.mjs test/app-schema.test.mjs test/app-selection.test.mjs test/contracts.test.mjs test/conversation-closing-report.test.mjs test/doctor.test.mjs test/mail-credentials.test.mjs test/mail-outbox.test.mjs test/mail-public-api.test.mjs test/mail-send.test.mjs test/mail-transport.test.mjs test/targets.test.mjs test/workspace-operation-lock.test.mjs",
-    "test:functional": "node ./bin/arcane-test.mjs test/ai-request-model.test.mjs test/ai-request-retry.test.mjs test/ai-stream-cancellation.test.mjs test/browser-decisions.test.mjs test/browser-speech-providers.test.mjs test/browser-wasm-gpu-notice.test.mjs test/browser-wasm-download-resume.test.mjs test/chat-input.test.mjs test/chat-stream-speech.test.mjs test/chat-transcript-scroll.test.mjs test/chat-transient-retention.test.mjs test/cli.test.mjs test/continuous-voice-capture.test.mjs test/core-classic-source.test.mjs test/core-client.test.mjs test/core-host.test.mjs test/core-runtime.test.mjs test/core-stdio.test.mjs test/dbopfs-document-library.test.mjs test/dbopfs-png.test.mjs test/dbopfs.test.mjs test/dev-server.test.mjs test/dev-pwa.test.mjs test/dom-event-instrumentation.test.mjs test/event-manager.test.mjs test/events.test.mjs test/file-preview.test.mjs test/import-map.test.mjs test/mail-cli.test.mjs test/mail-runtime.test.mjs test/mail-server.test.mjs test/markdown-editor.test.mjs test/markdown-media.test.mjs test/markdown-source-map.test.mjs test/modal.test.mjs test/native-module-packaging.test.mjs test/native-module-resource-references.test.mjs test/packaging.test.mjs test/pwa-packaging.test.mjs test/pwa-client.test.mjs test/pwa-install.test.mjs test/pwa-worker.test.mjs test/persistent-ai-chat-session.test.mjs test/reference-completeness.test.mjs test/rendered-print.test.mjs test/runtime-api-behavior.test.mjs test/runtime.test.mjs test/scaffold.test.mjs test/speech-playback.test.mjs test/site.test.mjs test/theme-manager.test.mjs test/twin-cloud-images.test.mjs test/twin-cloud.test.mjs test/websocket-client-import-map.test.mjs test/websocket.test.mjs test/update-check.test.mjs test/user-explicit-updates.test.mjs",
-    "test:integration": "node ./bin/arcane-test.mjs test/installed-package-runtime.test.mjs test/root-app-layout.test.mjs test/integrated-shared.test.mjs test/integrated-workspace.test.mjs test/mail-browser.test.mjs test/native-plan.test.mjs test/native-portable-provider.test.mjs test/native-provider-loader.test.mjs test/npm-release.test.mjs test/release-bundle.test.mjs test/release-capability-smoke.test.mjs test/shared-payload-batch.test.mjs test/tarball.test.mjs test/browser-wasm-cpu.test.mjs test/wllama-webgpu-runtime.test.mjs",
+    "test:functional": "node ./bin/arcane-test.mjs test/ai-request-model.test.mjs test/ai-request-retry.test.mjs test/ai-stream-cancellation.test.mjs test/browser-decisions.test.mjs test/browser-speech-providers.test.mjs test/browser-wasm-gpu-notice.test.mjs test/browser-wasm-download-resume.test.mjs test/chat-input.test.mjs test/chat-stream-speech.test.mjs test/chat-transcript-scroll.test.mjs test/chat-transient-retention.test.mjs test/cli.test.mjs test/continuous-voice-capture.test.mjs test/core-classic-source.test.mjs test/core-client.test.mjs test/core-host.test.mjs test/core-packaged-web.test.mjs test/core-runtime.test.mjs test/core-stdio.test.mjs test/dbopfs-document-library.test.mjs test/dbopfs-png.test.mjs test/dbopfs.test.mjs test/dev-server.test.mjs test/dev-pwa.test.mjs test/dom-event-instrumentation.test.mjs test/event-manager.test.mjs test/events.test.mjs test/file-preview.test.mjs test/import-map.test.mjs test/mail-cli.test.mjs test/mail-runtime.test.mjs test/mail-server.test.mjs test/markdown-editor.test.mjs test/markdown-media.test.mjs test/markdown-source-map.test.mjs test/modal.test.mjs test/native-module-packaging.test.mjs test/native-module-resource-references.test.mjs test/packaging.test.mjs test/pwa-packaging.test.mjs test/pwa-client.test.mjs test/pwa-install.test.mjs test/pwa-worker.test.mjs test/persistent-ai-chat-session.test.mjs test/reference-completeness.test.mjs test/rendered-print.test.mjs test/runtime-api-behavior.test.mjs test/runtime.test.mjs test/scaffold.test.mjs test/speech-playback.test.mjs test/site.test.mjs test/theme-manager.test.mjs test/twin-cloud-images.test.mjs test/twin-cloud.test.mjs test/websocket-client-import-map.test.mjs test/websocket.test.mjs test/update-check.test.mjs test/user-explicit-updates.test.mjs",
+    "test:integration": "node ./bin/arcane-test.mjs test/installed-package-runtime.test.mjs test/root-app-layout.test.mjs test/integrated-shared.test.mjs test/integrated-workspace.test.mjs test/mail-browser.test.mjs test/native-macos-provider.test.mjs test/native-plan.test.mjs test/native-portable-provider.test.mjs test/native-provider-loader.test.mjs test/npm-release.test.mjs test/release-bundle.test.mjs test/release-capability-smoke.test.mjs test/shared-payload-batch.test.mjs test/tarball.test.mjs test/browser-wasm-cpu.test.mjs test/wllama-webgpu-runtime.test.mjs",
     "test:regression": "node ./bin/arcane-test.mjs test/channel-workflows.test.mjs test/html-import-registration.test.mjs test/html-import-packaged-script.test.mjs test/logging-regression.test.mjs test/markdown-speech.test.mjs test/prepared-speech.test.mjs test/native-provider-generation.test.mjs test/speech-queue-regression.test.mjs test/testing.test.mjs test/test-sets.test.mjs",
     "check": "node tools/check-source.mjs && npm test",
     "check:release": "node tools/check-source.mjs --package-only && npm run test:release",

package/schemas/arcane-app.schema.json

@@ -180,7 +180,7 @@
       "minItems": 1,
       "uniqueItems": true,
       "items": {
-        "enum": ["android-arm64", "browser", "linux-arm64", "linux-x64", "portable", "windows-x64"]
+        "enum": ["android-arm64", "browser", "linux-arm64", "linux-x64", "macos-arm64", "macos-x64", "portable", "windows-x64"]
       }
     }
   },
@@ -262,12 +262,12 @@
           "type": "array",
           "items": {
             "oneOf": [
-              { "enum": ["llama.cpp", "ollama"] },
+              { "enum": ["llama.cpp", "ollama", "onnx"] },
               {
                 "type": "object",
                 "required": ["id"],
                 "properties": {
-                  "id": { "enum": ["llama.cpp", "ollama"] },
+                  "id": { "enum": ["llama.cpp", "ollama", "onnx"] },
                   "version": { "type": "string" },
                   "url": { "type": "string" }
                 }

package/schemas/arcane-package.schema.json

@@ -156,12 +156,12 @@
           "type": "array",
           "items": {
             "oneOf": [
-              { "enum": ["llama.cpp", "ollama"] },
+              { "enum": ["llama.cpp", "ollama", "onnx"] },
               {
                 "type": "object",
                 "required": ["id"],
                 "properties": {
-                  "id": { "enum": ["llama.cpp", "ollama"] },
+                  "id": { "enum": ["llama.cpp", "ollama", "onnx"] },
                   "version": { "type": "string" },
                   "url": { "type": "string" }
                 }

package/schemas/native-build-plan.schema.json

@@ -117,7 +117,7 @@
             {
               "properties": {
                 "target": { "const": "portable" },
-                "platform": { "enum": ["windows", "linux"] },
+                "platform": { "enum": ["windows", "linux", "macos"] },
                 "architecture": { "enum": ["x64", "arm64"] },
                 "format": { "const": "portable" }
               }
@@ -163,6 +163,32 @@
             }
           ]
         },
+        {
+          "allOf": [
+            { "$ref": "#/$defs/unsignedTargetRequest" },
+            {
+              "properties": {
+                "target": { "const": "macos-arm64" },
+                "platform": { "const": "macos" },
+                "architecture": { "const": "arm64" },
+                "format": { "const": "app" }
+              }
+            }
+          ]
+        },
+        {
+          "allOf": [
+            { "$ref": "#/$defs/unsignedTargetRequest" },
+            {
+              "properties": {
+                "target": { "const": "macos-x64" },
+                "platform": { "const": "macos" },
+                "architecture": { "const": "x64" },
+                "format": { "const": "app" }
+              }
+            }
+          ]
+        },
         {
           "type": "object",
           "required": ["target", "platform", "architecture", "format", "signing", "signingProfileId"],

package/schemas/target-adapter.schema.json

@@ -48,6 +48,7 @@
           "any",
           "windows",
           "linux",
+          "macos",
           "android"
         ]
       }
@@ -73,6 +74,7 @@
           "directory",
           "portable",
           "exe",
+          "app",
           "appimage",
           "deb",
           "rpm",

package/src/app-descriptor.mjs

@@ -449,7 +449,7 @@ function synthesizedDescriptor(packageManifest,nativeDescriptor){
             features:[]
         },
         targets:nativeDescriptor!==undefined
-            ?['android-arm64','browser','linux-arm64','linux-x64','portable','windows-x64']
+            ?['android-arm64','browser','linux-arm64','linux-x64','macos-arm64','macos-x64','portable','windows-x64']
             :['browser']
     },{appId:packageManifest.id});
 }

package/src/cli/main.mjs

@@ -67,7 +67,7 @@ Usage:
   ${CLI_NAME} upgrade [--workspace <directory>] [--app <id>]
   ${CLI_NAME} doctor [--workspace <directory>] [--arcane-root <directory>]
   ${CLI_NAME} import-map [--workspace <directory>] [--app <id>]
-  ${CLI_NAME} dev [--app <id>] [--public] [--http | --https] [--cert <pem>] [--key <pem>] [--host <address>] [--port 8000] [--http-port 0] [--sdk-runtime-source <sdk-root>] [--local-ai llama.cpp,ollama]
+  ${CLI_NAME} dev [--app <id>] [--public] [--http | --https] [--cert <pem>] [--key <pem>] [--host <address>] [--port 8000] [--http-port 0] [--sdk-runtime-source <sdk-root>] [--local-ai llama.cpp,ollama,onnx]
   ${CLI_NAME} test [--app <id>] [--scope app]
   ${CLI_NAME} test --scope shared --test-file <repo-relative.test.mjs>
   ${CLI_NAME} check [--app <id>] [--scope app] [--skip-tests]
@@ -738,6 +738,16 @@ function operationOptions(command,parsed,cwd){
 }
 
 const NATIVE_REQUESTS={
+    'macos-arm64':{
+        platform:'macos',architecture:'arm64',defaultFormat:'app',formats:new Set(['app']),
+        defaultSigning:'unsigned-local-test',defaultProfileId:null,
+        signingModes:new Set(['unsigned-local-test'])
+    },
+    'macos-x64':{
+        platform:'macos',architecture:'x64',defaultFormat:'app',formats:new Set(['app']),
+        defaultSigning:'unsigned-local-test',defaultProfileId:null,
+        signingModes:new Set(['unsigned-local-test'])
+    },
     'windows-x64':{
         platform:'windows',architecture:'x64',defaultFormat:'exe',formats:new Set(['exe']),
         defaultSigning:'unsigned-local-test',defaultProfileId:null,
@@ -761,9 +771,9 @@ const NATIVE_REQUESTS={
 };
 
 function portableRequestDefinition(){
-    const platform=process.platform==='win32'?'windows':process.platform;
+    const platform=process.platform==='win32'?'windows':process.platform==='darwin'?'macos':process.platform;
     const architecture=process.arch==='x64'?'x64':process.arch==='arm64'?'arm64':process.arch;
-    if(!['windows','linux'].includes(platform)||!['x64','arm64'].includes(architecture)){
+    if(!['windows','linux','macos'].includes(platform)||!['x64','arm64'].includes(architecture)){
         throw new ArcaneError(
             ERROR_CODES.targetUnavailable,
             `The portable native provider does not support ${process.platform}/${process.arch}.`
@@ -817,7 +827,7 @@ async function pairNativeProvider(command,options,loadProvider,{signal,onEvent}=
         usage(`${command} requires one native target.`);
     }
     const targetRequest=createNativeTargetRequest(options);
-    if(!options.arcaneRoot&&!['portable','windows-x64'].includes(options.target)){
+    if(!options.arcaneRoot&&!['portable','windows-x64','macos-arm64','macos-x64'].includes(options.target)){
         usage(`${command} for target ${options.target} requires --arcane-root <directory>.`);
     }
     const loaded=await loadProvider({

package/src/constants.mjs

@@ -27,6 +27,8 @@ export const TARGET_IDS=[
     'browser',
     'portable',
     'windows-x64',
+    'macos-arm64',
+    'macos-x64',
     'linux-x64',
     'linux-arm64',
     'android-arm64'

package/src/core/host.mjs

@@ -6,13 +6,22 @@ import {startCoreStdio} from './stdio.mjs';
 const is = new Is(false);
 
 /**
- * Read only the explicitly supplied --arcane-launch-config filename.
- * Return the complete JSON object for the service factories' second argument;
- * field meanings belong to the launch owner and individual services.
+ * The host's separate state-root argument supplies a launch-context default.
+ * Every field in an explicitly selected launch JSON object takes precedence
+ * unchanged; field meanings belong to the launch owner and individual services.
  */
 export async function readCoreLaunchContext({argv = process.argv.slice(2)} = {}) {
+    const stateFlag = argv.indexOf('--arcane-host-state-root');
+    const defaults = {};
+    if (stateFlag !== -1) {
+        const stateRoot = argv[stateFlag + 1];
+        if (stateRoot === undefined || stateRoot === '') {
+            throw new TypeError('--arcane-host-state-root requires a directory.');
+        }
+        defaults.stateRoot = stateRoot;
+    }
     const flag = argv.indexOf('--arcane-launch-config');
-    if (flag === -1) return {};
+    if (flag === -1) return defaults;
     const filename = argv[flag + 1];
     if (filename === undefined || filename === '') {
         throw new TypeError('--arcane-launch-config requires a filename.');
@@ -21,7 +30,7 @@ export async function readCoreLaunchContext({argv = process.argv.slice(2)} = {})
     if (context === null || !is.object(context) || is.array(context)) {
         throw new TypeError('Core launch configuration must be a JSON object.');
     }
-    return context;
+    return {...defaults, ...context};
 }
 
 /** Compose app services with the shared dispatcher and draining transport. */

package/src/core/hosts/macos/ArcaneHost.h

@@ -0,0 +1,86 @@
+#import <AppKit/AppKit.h>
+#import <WebKit/WebKit.h>
+#import "ArcaneCoreProcess.h"
+
+NS_ASSUME_NONNULL_BEGIN
+
+@class ArcaneHost;
+
+/**
+ * Main-thread callbacks. Return promptly; process readers never wait for these
+ * callbacks. Output and frame callbacks expose complete native diagnostics,
+ * including responses whose original document activation has retired.
+ * The delegate is retained until the host finishes closing.
+ * Bridge failures preserve NSError domain/code and full nested userInfo;
+ * NSURL and NSData use explicit reversible transport records. If an actual
+ * native value cannot cross WebKit, the bridge reports that representation
+ * failure and the delegate retains the complete original diagnostic.
+ */
+@protocol ArcaneHostDelegate <NSObject>
+- (void)host:(ArcaneHost *)host didLaunchCoreProcess:(pid_t)processIdentifier;
+- (void)host:(ArcaneHost *)host receivedOutputData:(NSData *)data stream:(ArcaneCoreOutputStream)stream;
+- (void)host:(ArcaneHost *)host receivedFrameData:(NSData *)data;
+- (void)host:(ArcaneHost *)host didEncounterError:(NSError *)error;
+- (void)host:(ArcaneHost *)host didExitCoreProcessWithStatus:(int)status reason:(NSTaskTerminationReason)reason;
+- (void)host:(ArcaneHost *)host coreDidCompleteWithErrors:(NSArray<NSError *> *)errors;
+@end
+
+/**
+ * Generic AppKit/WebKit composition. Compile with Objective-C ARC and blocks,
+ * linking only AppKit, WebKit and Foundation plus ArcaneCoreProcess.
+ * Public methods and properties belong to the main thread.
+ */
+API_AVAILABLE(macos(11.0))
+@interface ArcaneHost : NSWindowController
+
+/**
+ * Opens immediately while the explicit Core executable starts on its own queue.
+ * Supply an already-serving applicationURL to load immediately, or nil and call
+ * loadApplicationURL: when the serving owner's listener-ready result arrives.
+ * Process creation is not listener readiness. The caller owns NSApplication,
+ * its menus/delegate, actual serving origin, selected start URL and website
+ * data store. Navigation keeps Core and accepted service-lifetime work alive.
+ *
+ * Supply canonical createCoreClassicSource({eventOwnerModuleURL,
+ * replayRuntimeState:true,webKitDocumentLifecycle:true}) output. It is installed
+ * unchanged at document start in the main frame's page world, before app code.
+ * No file/custom-scheme serving, application client copy or certificate policy
+ * is provided here. Arguments exclude argv[0]; Core inherits the environment.
+ * Events broadcast to the current document; periods without one remain fully
+ * observable through native diagnostics. The shared client replays current
+ * runtime state after activation instead of replaying old transient events.
+ */
++ (instancetype)openApplicationURL:(NSURL * _Nullable)applicationURL
+                  websiteDataStore:(WKWebsiteDataStore *)websiteDataStore
+                             title:(NSString *)title
+                      contentFrame:(NSRect)contentFrame
+                     classicSource:(NSString *)classicSource
+                     executableURL:(NSURL *)executableURL
+                         arguments:(NSArray<NSString *> *)arguments
+               workingDirectoryURL:(NSURL *)workingDirectoryURL
+                          delegate:(id<ArcaneHostDelegate>)delegate;
+
+@property(nonatomic, readonly) WKWebView *webView;
+
+/** True after a host/window close requests the existing Core drain. */
+@property(nonatomic, readonly, getter=isClosing) BOOL closing;
+
+/** Loads the selected app URL after its serving owner is ready. */
+- (WKNavigation * _Nullable)loadApplicationURL:(NSURL *)applicationURL;
+
+/**
+ * Idempotent, nonblocking shutdown: stop accepting writes, send ordered stdin
+ * EOF, drain process output/exit and pending native deliveries, then close the
+ * window. Direct NSWindow.close is also observed and drains while hidden.
+ * Each supplied completion runs once on the main thread with all host errors.
+ * The caller can use this completion with NSApplicationTerminateLater and its
+ * own replyToApplicationShouldTerminate:, without replacing its app delegate.
+ */
+- (void)closeWithCompletion:(void (^ _Nullable)(NSArray<NSError *> *errors))completion;
+- (void)close;
+
+- (instancetype)init NS_UNAVAILABLE;
++ (instancetype)new NS_UNAVAILABLE;
+@end
+
+NS_ASSUME_NONNULL_END