kokorobox-native 0.16.5 → 0.16.7

package/README.md

@@ -83,3 +83,21 @@ NetworkManager/systemd-resolved and falls back to resolv.conf for inspection.
 Bootstrap repair is Desktop configuration policy: Desktop copies the observed
 system DNS addresses into `dns.default-nameserver` and restarts the core. Native
 does not expose an OS DNS mutation API for diagnostics.
+
+## macOS application routing logs
+
+`getMacosApplicationRoutingLogs(): Promise<MacosApplicationRoutingLog[]>` drains
+up to 100 activity/connection entries from the approved KokoroBox Network
+Extension via its provider-message channel. Records have `time`, `message` and
+`level`; connection messages contain protocol, application, destination, port and
+routing result. Older provider connection entries without timestamps return an
+empty `time` so the caller can use its receipt time.
+
+`clearMacosApplicationRoutingLogs(): Promise<void>` clears provider history after
+checking its acknowledgement. A stopped or absent session returns an empty batch
+and clearing it is a no-op. Other OS/provider failures reject. Calls run on N-API
+workers; the provider send runs on the main dispatch queue with a five-second
+reply timeout, following the bounded preferences load. Responses are checked for
+version, schema, count, size and invalid fields before crossing into JavaScript.
+The caller should serialize reads and clears and retain its own bounded history.
+These operations require macOS and do not activate an extension or change policy.

package/index.d.ts

@@ -24,6 +24,10 @@ export interface UwpLoopbackApp {
 }
 
 export interface NativeCapabilities {
+ serviceProcessStatus: boolean;
+ coreProfileValidation: boolean;
+  macosRoutingReconcile: boolean;
+  coreProcessControl: boolean;
   applicationInspection: boolean;
   executableDiscovery: boolean;
   windowsApplicationScan: boolean;
@@ -430,3 +434,24 @@ export interface SystemDnsDiagnostics {
 }
 /** Read-only system resolver probes and the current primary network DNS. */
 export declare function getSystemDnsDiagnostics(): Promise<SystemDnsDiagnostics>
+
+export interface CoreProcessIdentity { pid: number; executable: string; started: string; }
+export function inspectCoreProcess(pid: number, executable: string): Promise<CoreProcessIdentity | null>;
+export function stopCoreProcess(identity: CoreProcessIdentity): Promise<boolean>;
+
+export function reconcileMacosApplicationRouting(configuration: MacosApplicationRoutingConfiguration): Promise<MacosApplicationRoutingStatus & { proxyAvailable: boolean }>;
+
+export interface CoreValidationOptions { executable: string; configPath: string; workDir: string; safePaths: string[]; }
+export interface CoreValidationResult { outcome: 'valid' | 'invalid' | 'timeout' | 'output-limit'; output: string; }
+export function validateCoreProfile(options: CoreValidationOptions): Promise<CoreValidationResult>;
+
+export function getServiceProcessStatus(executable: string): Promise<'running' | 'stopped' | 'paused' | 'not-installed' | 'unknown'>;
+
+export interface MacosApplicationRoutingLog {
+  time: string;
+  message: string;
+  level: string;
+}
+/** Drains at most 100 entries from the Network Extension. */
+export function getMacosApplicationRoutingLogs(): Promise<MacosApplicationRoutingLog[]>;
+export function clearMacosApplicationRoutingLogs(): Promise<void>;

package/index.js

@@ -203,3 +203,15 @@ export const deleteServiceIdentity = diagnosticBinding.deleteServiceIdentity;
 export const getSystemProxyDiagnostics = diagnosticBinding.getSystemProxyDiagnostics;
 export const setSystemProxy = diagnosticBinding.setSystemProxy;
 export const getSystemDnsDiagnostics = diagnosticBinding.getSystemDnsDiagnostics;
+
+export const inspectCoreProcess = diagnosticBinding.inspectCoreProcess;
+export const stopCoreProcess = diagnosticBinding.stopCoreProcess;
+
+export const reconcileMacosApplicationRouting = diagnosticBinding.reconcileMacosApplicationRouting;
+
+export const validateCoreProfile = diagnosticBinding.validateCoreProfile;
+
+export const getServiceProcessStatus = diagnosticBinding.getServiceProcessStatus;
+
+export const getMacosApplicationRoutingLogs = diagnosticBinding.getMacosApplicationRoutingLogs;
+export const clearMacosApplicationRoutingLogs = diagnosticBinding.clearMacosApplicationRoutingLogs;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "kokorobox-native",
-  "version": "0.16.5",
+  "version": "0.16.7",
   "description": "KokoroBox native bridge",
   "type": "module",
   "main": "index.js",
@@ -50,11 +50,11 @@
     "access": "public"
   },
   "optionalDependencies": {
-    "kokorobox-native-win32-x64-msvc": "0.16.5",
-    "kokorobox-native-win32-arm64-msvc": "0.16.5",
-    "kokorobox-native-darwin-x64": "0.16.5",
-    "kokorobox-native-darwin-arm64": "0.16.5",
-    "kokorobox-native-linux-x64-gnu": "0.16.5",
-    "kokorobox-native-linux-arm64-gnu": "0.16.5"
+    "kokorobox-native-win32-x64-msvc": "0.16.7",
+    "kokorobox-native-win32-arm64-msvc": "0.16.7",
+    "kokorobox-native-darwin-x64": "0.16.7",
+    "kokorobox-native-darwin-arm64": "0.16.7",
+    "kokorobox-native-linux-x64-gnu": "0.16.7",
+    "kokorobox-native-linux-arm64-gnu": "0.16.7"
   }
 }