arcane-os 0.5.17 → 0.5.19

package/runtime/arcane/modules/LocalAIReadiness.js

@@ -1,3 +1,6 @@
+import Is from 'strong-type';
+const is=new Is(false);
+
 import {AI_PREFERENCE_SLOT_KEYS} from './AIPreferenceTuple.js';
 import {
     getCoreLocalModelCatalog,
@@ -18,7 +21,7 @@ const LOCAL_SPEECH_PROVIDERS=new Set([
 ]);
 
 function token(value,{uppercase=false}={}){
-    const normalized=typeof value==='string'
+    const normalized=is.string(value)
         ?value.trim()
         :'';
 
@@ -37,7 +40,7 @@ function completeResult(value){
 }
 
 function positiveSafeInteger(value){
-    return Number.isSafeInteger(value)&&value>0
+    return is.safeInteger(value)&&value>0
         ?value
         :null;
 }
@@ -45,7 +48,7 @@ function positiveSafeInteger(value){
 function preferenceSlot(preferences,index){
     const value=preferences[index];
 
-    if(typeof value!=='string'||!value.trim()){
+    if(!is.string(value)||!value.trim()){
         throw new TypeError(
             'The AI preference for '
             +AI_PREFERENCE_SLOT_KEYS[index]
@@ -62,7 +65,7 @@ function preferenceSlot(preferences,index){
  * tuple or choose a replacement provider.
  */
 export function deriveLocalAIRequirements(preferences){
-    if(!Array.isArray(preferences)||preferences.length!==AI_PREFERENCE_SLOT_KEYS.length){
+    if(!is.array(preferences)||preferences.length!==AI_PREFERENCE_SLOT_KEYS.length){
         throw new TypeError(
             'AI preferences must contain exactly '
             +AI_PREFERENCE_SLOT_KEYS.length
@@ -138,7 +141,7 @@ function healthText(status,names){
  * aggregate ready proof.
  */
 export function evaluateLocalSpeechHealth(status){
-    if(!status||typeof status!=='object'||Array.isArray(status)){
+    if(!status||!is.object(status)||is.array(status)){
         return completeResult({
             reachable:false,
             ready:false,
@@ -232,7 +235,7 @@ function normalizedTimeout(value){
         return DEFAULT_TIMEOUT_MS;
     }
 
-    if(!Number.isSafeInteger(value)||value<1){
+    if(!is.safeInteger(value)||value<1){
         throw new RangeError('Local AI readiness timeout must be a positive integer.');
     }
 
@@ -240,13 +243,13 @@ function normalizedTimeout(value){
 }
 
 async function fetchJSON(fetchImpl,url,timeoutMs){
-    if(typeof fetchImpl!=='function'){
+    if(!is.function(fetchImpl)){
         const error=new Error('Browser fetch is unavailable.');
         error.code='BROWSER_FETCH_UNAVAILABLE';
         throw error;
     }
 
-    const controller=typeof AbortController==='function'
+    const controller=is.function(globalThis.AbortController)
         ?new AbortController()
         :null;
     let timer;
@@ -275,7 +278,7 @@ async function fetchJSON(fetchImpl,url,timeoutMs){
             throw error;
         }
 
-        if(typeof response.text!=='function'){
+        if(!is.function(response.text)){
             const error=new Error('The local readiness endpoint returned an invalid response.');
             error.code='LOCAL_AI_HEALTH_INVALID_RESPONSE';
             throw error;
@@ -283,7 +286,7 @@ async function fetchJSON(fetchImpl,url,timeoutMs){
 
         const text=await response.text();
 
-        if(typeof text!=='string'||!text){
+        if(!is.string(text)||!text){
             const error=new Error('The local readiness endpoint returned an invalid response.');
             error.code='LOCAL_AI_HEALTH_INVALID_RESPONSE';
             throw error;
@@ -299,7 +302,7 @@ async function fetchJSON(fetchImpl,url,timeoutMs){
             throw error;
         }
 
-        if(!parsed||typeof parsed!=='object'||Array.isArray(parsed)){
+        if(!parsed||!is.object(parsed)||is.array(parsed)){
             const error=new Error('The local readiness endpoint returned an invalid record.');
             error.code='LOCAL_AI_HEALTH_INVALID_RESPONSE';
             throw error;
@@ -316,7 +319,7 @@ async function fetchJSON(fetchImpl,url,timeoutMs){
 }
 
 async function probeNativeOllama(arcane,selectedModel){
-    if(typeof arcane?.localAI?.status!=='function'){
+    if(!is.function(arcane?.localAI?.status)){
         return completeResult({
             ready:false,
             model:null,
@@ -377,7 +380,7 @@ async function probeNativeOllama(arcane,selectedModel){
 }
 
 async function probeUserManagedLoopbackOllama(arcane,selectedModel){
-    if(typeof arcane?.localAI?.status!=='function'){
+    if(!is.function(arcane?.localAI?.status)){
         return completeResult({
             ready:false,
             model:null,
@@ -457,7 +460,7 @@ function unavailableBrowserOllama(){
 }
 
 async function probeNativeSpeech(arcane){
-    if(typeof arcane?.speech?.status!=='function'){
+    if(!is.function(arcane?.speech?.status)){
         return completeResult({
             ...evaluateLocalSpeechHealth(null),
             errorCode:'ARCANE_SPEECH_UNAVAILABLE'
@@ -506,7 +509,7 @@ async function resolveMode(runtime,arcane){
         return runtime;
     }
 
-    if(runtime!==undefined&&(!runtime||typeof runtime!=='object')){
+    if(runtime!==undefined&&(!runtime||!is.object(runtime))){
         throw new TypeError(
             'Local AI runtime must be "native", "browser", '
             +'"user-managed-loopback", or a runtime snapshot.'
@@ -515,7 +518,7 @@ async function resolveMode(runtime,arcane){
 
     let snapshot=runtime;
 
-    if(snapshot===undefined&&typeof arcane?.runtime?.current==='function'){
+    if(snapshot===undefined&&is.function(arcane?.runtime?.current)){
         try{
             snapshot=await arcane.runtime.current();
         }catch{
@@ -744,14 +747,14 @@ function guidance(mode,slots){
 
 function nativeRecovery(arcane,recover){
     if(recover!==undefined){
-        if(typeof recover!=='function'){
+        if(!is.function(recover)){
             throw new TypeError('Local AI recovery must be a function.');
         }
 
         return recover;
     }
 
-    return typeof arcane?.localAI?.recover==='function'
+    return is.function(arcane?.localAI?.recover)
         ?arcane.localAI.recover.bind(arcane.localAI)
         :null;
 }

package/runtime/arcane/modules/LocalAIReadinessController.js

@@ -1,3 +1,6 @@
+import Is from 'strong-type';
+const is=new Is(false);
+
 import { arcaneLogging } from 'arcane-os/logging';
 import {
     checkLocalAIReadiness,
@@ -36,7 +39,7 @@ function availabilityFromReport(report={}){
 }
 
 function selectedPreferences(source){
-    return typeof source==='function'?source():source;
+    return is.function(source)?source():source;
 }
 
 function pendingReport(requirements){
@@ -172,7 +175,7 @@ export function createLocalAIReadinessController({
         if(destroyed){
             return;
         }
-        if(typeof chat.setAIAvailability==='function'){
+        if(is.function(chat.setAIAvailability)){
             if(chatReadyListenerPending){
                 chat.removeEventListener('chat-ready',publishAvailability);
             }
@@ -239,7 +242,7 @@ export function createLocalAIReadinessController({
             }
             status?.present?.(latestReport);
             applyAvailability(latestReport);
-            if(typeof onChange==='function'){
+            if(is.function(onChange)){
                 onChange(latestReport);
             }
             const availability=availabilityFromReport(latestReport);

package/runtime/arcane/modules/MD.js

@@ -1,6 +1,6 @@
 import { arcaneLogging } from 'arcane-os/logging';
 import { marked } from './Marked.min.js';
-import Is from '../../node_modules/strong-type/index.js';
+import Is from 'strong-type';
 
 marked.use(
     {

package/runtime/arcane/modules/Mail.js

@@ -1,3 +1,6 @@
+import Is from 'strong-type';
+const is=new Is(false);
+
 import {createArcaneEventSource} from 'arcane-os/event-manager';
 import MailOutbox from './MailOutbox.mjs';
 import {
@@ -44,10 +47,10 @@ function codedError(message,code,ErrorType=Error){
 
 function validateMailSignal(signal){
     if(signal===null||signal===undefined) return null;
-    if(typeof signal!=='object'
-        ||typeof signal.aborted!=='boolean'
-        ||typeof signal.addEventListener!=='function'
-        ||typeof signal.removeEventListener!=='function'){
+    if(!is.object(signal)
+        ||!is.boolean(signal.aborted)
+        ||!is.function(signal.addEventListener)
+        ||!is.function(signal.removeEventListener)){
         throw new TypeError('Mail signal must be an AbortSignal');
     }
     return signal;
@@ -122,14 +125,14 @@ function waitForMailOperation(operation,signal){
 }
 
 function exactNativeMailResult(value){
-    if(!value||typeof value!=='object'||Array.isArray(value)
-        ||typeof value.requestId!=='string'
+    if(!value||!is.object(value)||is.array(value)
+        ||!is.string(value.requestId)
         ||!NATIVE_MAIL_REQUEST_ID_PATTERN.test(value.requestId)
         ||!Object.hasOwn(NATIVE_MAIL_RESPONSE_STATUS_CODES,value.status)
         ||value.statusCode!==NATIVE_MAIL_RESPONSE_STATUS_CODES[value.status]
-        ||typeof value.sent!=='boolean'
-        ||typeof value.partial!=='boolean'
-        ||typeof value.uncertain!=='boolean'
+        ||!is.boolean(value.sent)
+        ||!is.boolean(value.partial)
+        ||!is.boolean(value.uncertain)
         ||value.sent!==(value.status==='accepted')
         ||value.partial!==(value.status==='partially_accepted')
         ||value.uncertain!==(value.status==='delivery_uncertain')){
@@ -150,7 +153,7 @@ function normalizedNativeMailError(error){
     const retryable=uncertain||NATIVE_MAIL_RETRYABLE_ERROR_CODES.has(error?.code);
     if(!retryable) return error;
     const normalized=new Error(
-        typeof error?.message==='string'&&error.message
+        is.string(error?.message)&&error.message
             ?error.message
             :uncertain
                 ?'Native Arcane mail delivery has an uncertain outcome.'
@@ -162,7 +165,7 @@ function normalizedNativeMailError(error){
     normalized.retryable=true;
     normalized.uncertain=uncertain;
     const statusCode=Number(error?.statusCode??error?.status);
-    if(Number.isSafeInteger(statusCode)&&statusCode>=100&&statusCode<=599){
+    if(is.safeInteger(statusCode)&&statusCode>=100&&statusCode<=599){
         normalized.statusCode=statusCode;
     }
     return normalized;
@@ -178,7 +181,7 @@ async function loadRequiredMailStorage(){
         );
     }
     const storage=globalThis.dbopfs;
-    if(!storage||typeof storage!=='object'){
+    if(!storage||!is.object(storage)){
         throw codedError(
             'Mail outbox storage is unavailable.',
             'MAIL_OUTBOX_STORAGE_UNAVAILABLE'
@@ -245,17 +248,17 @@ export function resolveMailConfig(
     config=globalThis.arcane?.config?.mail||{},
     {document=globalThis.document,location=globalThis.location}={}
 ){
-    const supplied=config&&typeof config==='object'&&!Array.isArray(config)?config:{};
-    const appName=typeof supplied.appName==='string'&&supplied.appName.trim()
+    const supplied=config&&is.object(config)&&!is.array(config)?config:{};
+    const appName=is.string(supplied.appName)&&supplied.appName.trim()
         ? supplied.appName.trim()
         : declaredApplicationId(document);
     return completeResult({
         appName:ARCANE_APP_ID_PATTERN.test(appName) ? appName:'',
-        appKey:typeof supplied.appKey==='string' ? supplied.appKey:'',
-        endpoint:typeof supplied.endpoint==='string'&&supplied.endpoint.trim()
+        appKey:is.string(supplied.appKey) ? supplied.appKey:'',
+        endpoint:is.string(supplied.endpoint)&&supplied.endpoint.trim()
             ? supplied.endpoint.trim()
             : defaultMailEndpoint(location,supplied.baseDomain||declaredMailBaseDomain(document)),
-        requestTimeout:Number.isFinite(supplied.requestTimeout)
+        requestTimeout:is.finite(supplied.requestTimeout)
             ? supplied.requestTimeout
             : null,
     });
@@ -271,7 +274,7 @@ function escapeHtml(value){
 }
 
 function clonePayload(value){
-    if(typeof globalThis.structuredClone==='function'){
+    if(is.function(globalThis.structuredClone)){
         return globalThis.structuredClone(value);
     }
     return JSON.parse(JSON.stringify(value));
@@ -294,7 +297,7 @@ function serializePayload(value){
 let reportNonceSequence=0;
 
 function randomReportNonce(cryptoProvider){
-    if(typeof cryptoProvider?.randomUUID==='function'){
+    if(is.function(cryptoProvider?.randomUUID)){
         try{
             const value=cryptoProvider.randomUUID();
             if(/^[0-9a-f]{8}-[0-9a-f]{4}-[1-8][0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i.test(value)){
@@ -311,12 +314,12 @@ function createReportKey(timestamp,cryptoProvider){
 }
 
 function normalizeRecipients(values){
-    if(!Array.isArray(values)){
+    if(!is.array(values)){
         throw new TypeError('Mail recipients must be an array');
     }
     const recipients=[];
     for(const value of values){
-        if(typeof value!=='string'){
+        if(!is.string(value)){
             throw new TypeError('Every mail recipient must be an email address');
         }
         const address=value.trim().toLowerCase();
@@ -331,17 +334,17 @@ function normalizeRecipients(values){
 function profileValue(user,key){
     try{
         const value=user?.[key];
-        return typeof value==='string'?value:'';
+        return is.string(value)?value:'';
     }catch{
         return '';
     }
 }
 
 function normalizedDeliveryResult(value){
-    if(!value||typeof value!=='object'||Array.isArray(value)) return value;
-    let status=typeof value.status==='string'?value.status:'';
+    if(!value||!is.object(value)||is.array(value)) return value;
+    let status=is.string(value.status)?value.status:'';
     if(!status&&value.sent===true) status='accepted';
-    let classification=typeof value.classification==='string'?value.classification:'';
+    let classification=is.string(value.classification)?value.classification:'';
     if(!classification){
         classification={
             accepted:'accepted',
@@ -352,9 +355,9 @@ function normalizedDeliveryResult(value){
         }[status]||'';
     }
     const retryAfterMilliseconds=Number(value.retryAfterMs);
-    const retryAfterSeconds=Number.isSafeInteger(value.retryAfterSeconds)
+    const retryAfterSeconds=is.safeInteger(value.retryAfterSeconds)
         ? value.retryAfterSeconds
-        : Number.isFinite(retryAfterMilliseconds)&&retryAfterMilliseconds>0
+        : is.finite(retryAfterMilliseconds)&&retryAfterMilliseconds>0
             ? Math.ceil(retryAfterMilliseconds/1000)
             : null;
     return {
@@ -390,7 +393,7 @@ function safeDrainDetail(summary){
 }
 
 function normalizeMailOptions(options){
-    if(!options||typeof options!=='object'||Array.isArray(options)){
+    if(!options||!is.object(options)||is.array(options)){
         throw new TypeError('Mail options must be an object');
     }
     const deliver=options.deliver;
@@ -399,29 +402,29 @@ function normalizeMailOptions(options){
         return globalThis.navigator?.onLine!==false;
     };
     const onlineTarget=options.onlineTarget===undefined
-        ?typeof globalThis.addEventListener==='function'?globalThis:null
+        ?is.function(globalThis.addEventListener)?globalThis:null
         :options.onlineTarget;
     const includeContext=options.includeContext??false;
     const cryptoProvider=Object.hasOwn(options,'crypto')
         ?options.crypto
         :globalThis.crypto;
-    if(deliver!==undefined&&typeof deliver!=='function'){
+    if(deliver!==undefined&&!is.function(deliver)){
         throw new TypeError('Mail deliver must be a function');
     }
-    if(typeof clock!=='function'||typeof isOnline!=='function'){
+    if(!is.function(clock)||!is.function(isOnline)){
         throw new TypeError('Mail clock and isOnline hooks must be functions');
     }
     if(onlineTarget!==null&&(
-        typeof onlineTarget?.addEventListener!=='function'
-        ||typeof onlineTarget?.removeEventListener!=='function'
+        !is.function(onlineTarget?.addEventListener)
+        ||!is.function(onlineTarget?.removeEventListener)
     )){
         throw new TypeError('Mail onlineTarget must be an EventTarget');
     }
-    if(typeof includeContext!=='boolean'){
+    if(!is.boolean(includeContext)){
         throw new TypeError('Mail includeContext must be boolean');
     }
     if(cryptoProvider!==null&&cryptoProvider!==undefined
-        &&typeof cryptoProvider!=='object'){
+        &&!is.object(cryptoProvider)){
         throw new TypeError('Mail crypto must be a Web Crypto provider');
     }
     return {
@@ -533,7 +536,7 @@ class Mail {
 
     #assertConfigured(){
         const hasTransport=this.#deliver!==undefined
-            ||typeof globalThis.Arcane?.mail?.send==='function'
+            ||is.function(globalThis.Arcane?.mail?.send)
             ||Boolean(this.endpoint);
         if(!this.appName||!hasTransport){
             throw codedError('Mail transport is not configured.','MAIL_NOT_CONFIGURED');
@@ -550,8 +553,8 @@ class Mail {
     #time(){
         const value=this.#clock();
         const milliseconds=value instanceof Date?value.getTime():Number(value);
-        if(!Number.isSafeInteger(milliseconds)||milliseconds<0
-            ||Number.isNaN(new Date(milliseconds).getTime())){
+        if(!is.safeInteger(milliseconds)||milliseconds<0
+            ||is.NaN(new Date(milliseconds).getTime())){
             throw codedError('Mail clock returned an invalid time.','MAIL_CLOCK_INVALID');
         }
         return milliseconds;
@@ -811,20 +814,20 @@ class Mail {
 
     async send(to=[], subject='', payload={}, messageStyle='', messageType='') {
         this.#assertActive();
-        if(typeof subject!=='string'){
+        if(!is.string(subject)){
             throw new TypeError('Mail subject must be a string');
         }
         const normalizedSubject=subject;
-        if(!payload||typeof payload!=='object'||Array.isArray(payload)){
+        if(!payload||!is.object(payload)||is.array(payload)){
             throw new TypeError('Mail payload must be an object');
         }
-        if(typeof messageStyle!=='string'){
+        if(!is.string(messageStyle)){
             throw new TypeError('Mail message style must be a string');
         }
-        if(!Array.isArray(to)){
+        if(!is.array(to)){
             throw new TypeError('Mail recipients must be an array');
         }
-        if(typeof messageType!=='string'||!MAIL_TYPES.has(messageType)){
+        if(!is.string(messageType)||!MAIL_TYPES.has(messageType)){
             throw new TypeError('Mail type must be error, report, or crisis_detected');
         }