arcane-os 0.5.16 → 0.5.18

package/runtime/arcane/modules/CommunicationProviderRegistry.js

@@ -1,3 +1,6 @@
+import Is from 'strong-type';
+const is=new Is(false);
+
 const PROVIDER_ID=/^[a-z0-9][a-z0-9._-]{1,63}$/;
 
 export default class CommunicationProviderRegistry{
@@ -5,7 +8,7 @@ export default class CommunicationProviderRegistry{
     register(provider){
         const id=String(provider?.id||'').trim().toLowerCase();
         if(!PROVIDER_ID.test(id)) throw new TypeError('Communication provider id is invalid.');
-        for(const method of ['listThreads','getMessages','send']) if(typeof provider[method]!=='function') throw new TypeError(`Provider ${id} must implement ${method}().`);
+        for(const method of ['listThreads','getMessages','send']) if(!is.function(provider[method])) throw new TypeError(`Provider ${id} must implement ${method}().`);
         if(this.providers.has(id)) throw new RangeError(`Communication provider already registered: ${id}`);
         this.providers.set(id,{...provider,id,label:String(provider.label||id),channels:Object.freeze(Array.from(provider.channels||['other'])),listThreads:provider.listThreads.bind(provider),getMessages:provider.getMessages.bind(provider),send:provider.send.bind(provider)});
         return this.get(id);

package/runtime/arcane/modules/ComponentContracts.js

@@ -1,3 +1,6 @@
+import Is from 'strong-type';
+const is=new Is(false);
+
 import { arcaneLogging } from 'arcane-os/logging';
 import {
     createArcaneEventSource,
@@ -46,7 +49,7 @@ function projectSTTActivationEvent(
     EventClass,
     options={}
 ){
-    if(typeof globalThis.CustomEvent!=='function'){
+    if(!is.function(globalThis.CustomEvent)){
         throw codedError(
             'The STT activation DOM compatibility projection requires CustomEvent.',
             STT_ACTIVATION_ERROR_CODES.domProjectionUnavailable
@@ -81,14 +84,14 @@ function record(value,label){
     if(value===undefined){
         return {};
     }
-    if(!value||typeof value!=='object'||Array.isArray(value)){
+    if(!value||!is.object(value)||is.array(value)){
         throw new TypeError(`${label} must be an object`);
     }
     return value;
 }
 
 function string(value,fallback='',allowEmpty=false){
-    if(typeof value!=='string'){
+    if(!is.string(value)){
         return fallback;
     }
     const normalized=value.trim();
@@ -96,7 +99,7 @@ function string(value,fallback='',allowEmpty=false){
 }
 
 function text(value,fallback='',allowEmpty=false){
-    if(typeof value!=='string'){
+    if(!is.string(value)){
         return fallback;
     }
     return value||(allowEmpty?'':fallback);
@@ -126,10 +129,10 @@ function optionAlias(input,previous,keys,fallback){
 
 function optionalCallback(input,previous,keys,label=keys[0]){
     const value=optionAlias(input,previous,keys,null);
-    if(value!==null&&value!==undefined&&typeof value!=='function'){
+    if(value!==null&&value!==undefined&&!is.function(value)){
         throw new TypeError(`${label} must be a function or null`);
     }
-    return typeof value==='function'?value:null;
+    return is.function(value)?value:null;
 }
 
 function finiteNumber(value,label){
@@ -137,7 +140,7 @@ function finiteNumber(value,label){
         return null;
     }
     const normalized=Number(value);
-    if(!Number.isFinite(normalized)){
+    if(!is.finite(normalized)){
         throw new TypeError(`${label} must be a finite number or null`);
     }
     return normalized;
@@ -147,7 +150,7 @@ function stringRecord(value,defaults,label){
     value=record(value,label);
     const normalized={...defaults};
     for(const [key,item] of Object.entries(value)){
-        if(typeof item!=='string'){
+        if(!is.string(item)){
             throw new TypeError(`${label}.${key} must be a string`);
         }
         normalized[key]=item;
@@ -189,7 +192,7 @@ function normalizeChartOptions(input={},previous={}){
     };
 
     for(const [source,target] of Object.entries(aliases)){
-        if(typeof input[source]==='string'){
+        if(is.string(input[source])){
             labels[target]=input[source];
         }
     }
@@ -208,8 +211,8 @@ function normalizeChartOptions(input={},previous={}){
     const chartOptions=option(input,previous,'chartOptions',null);
     if(
         chartOptions!==null
-        &&typeof chartOptions!=='function'
-        &&(!chartOptions||typeof chartOptions!=='object'||Array.isArray(chartOptions))
+        &&!is.function(chartOptions)
+        &&(!chartOptions||!is.object(chartOptions)||is.array(chartOptions))
     ){
         throw new TypeError('chartOptions must be an object, function, or null');
     }
@@ -237,7 +240,7 @@ function normalizeChartOptions(input={},previous={}){
         parseY:optionalCallback(input,previous,['parseY']),
         formatTime:optionalCallback(input,previous,['formatTime']),
         formatValue:optionalCallback(input,previous,['formatValue']),
-        chartOptions:typeof chartOptions==='object'&&chartOptions!==null
+        chartOptions:is.object(chartOptions)&&chartOptions!==null
             ?{...chartOptions}
             :chartOptions,
         data
@@ -249,22 +252,22 @@ function numericX(value,time=true){
         return value.getTime();
     }
     const number=Number(value);
-    if(Number.isFinite(number)){
+    if(is.finite(number)){
         return number;
     }
-    if(time&&typeof value==='string'){
+    if(time&&is.string(value)){
         const parsed=Date.parse(value);
-        return Number.isFinite(parsed)?parsed:NaN;
+        return is.finite(parsed)?parsed:NaN;
     }
     return NaN;
 }
 
 function normalizeChartRows(data=[],options={}){
     const config=normalizeChartOptions(options);
-    if(data&&typeof data==='object'&&!Array.isArray(data)){
+    if(data&&is.object(data)&&!is.array(data)){
         data=Object.entries(data);
     }
-    if(!Array.isArray(data)){
+    if(!is.array(data)){
         return [];
     }
     const normalized=[];
@@ -272,12 +275,12 @@ function normalizeChartRows(data=[],options={}){
     for(let index=0;index<data.length;index++){
         const original=data[index];
         const item=config.mapRow?config.mapRow(original,index):original;
-        const x=Array.isArray(item)
+        const x=is.array(item)
             ?item[0]
             :config.xKey
                 ?item?.[config.xKey]
                 :item?.date??item?.timestamp??item?.x;
-        const y=Array.isArray(item)
+        const y=is.array(item)
             ?item[1]
             :config.yKey
                 ?item?.[config.yKey]
@@ -287,7 +290,7 @@ function normalizeChartRows(data=[],options={}){
         const normalizedX=numericX(parsedX,config.time);
         const normalizedY=Number(parsedY);
 
-        if(Number.isFinite(normalizedX)&&Number.isFinite(normalizedY)){
+        if(is.finite(normalizedX)&&is.finite(normalizedY)){
             normalized.push([normalizedX,normalizedY]);
         }
     }
@@ -297,7 +300,7 @@ function normalizeChartRows(data=[],options={}){
 }
 
 function normalizeDashboardDefinitions(values=[]){
-    if(!Array.isArray(values)){
+    if(!is.array(values)){
         throw new TypeError('Dashboard definitions must be an array');
     }
     const keys=new Set();
@@ -349,7 +352,7 @@ function normalizeDashboardVisibility(values={}){
     values=record(values,'Dashboard visibility');
     const visibility={};
     for(const [key,value] of Object.entries(values)){
-        if(typeof value==='boolean'){
+        if(is.boolean(value)){
             visibility[key]=value;
         }
     }
@@ -372,7 +375,7 @@ function normalizeDashboardOptions(input={},previous={}){
         triggerLabel:'trigger'
     };
     for(const [source,target] of Object.entries(aliases)){
-        if(typeof input[source]==='string'){
+        if(is.string(input[source])){
             labels[target]=input[source];
         }
     }
@@ -380,7 +383,7 @@ function normalizeDashboardOptions(input={},previous={}){
         labels,
         definitions:own(input,'definitions')
             ?normalizeDashboardDefinitions(input.definitions)
-            :Array.isArray(previous.definitions)
+            :is.array(previous.definitions)
                 ?normalizeDashboardDefinitions(previous.definitions)
                 :[],
         visibility:own(input,'visibility')
@@ -396,7 +399,7 @@ function effectiveDashboardVisibility(definitions=[],visibility={}){
         definitions.map(
             definition=>[
                 definition.key,
-                typeof visibility[definition.key]==='boolean'
+                is.boolean(visibility[definition.key])
                     ?visibility[definition.key]
                     :definition.defaultVisible
             ]
@@ -405,16 +408,16 @@ function effectiveDashboardVisibility(definitions=[],visibility={}){
 }
 
 function formatAIRuntimeProgress(progress,fallback){
-    const phase=typeof progress?.phase==='string'&&progress.phase
+    const phase=is.string(progress?.phase)&&progress.phase
         ?progress.phase
         :fallback;
     const completed=progress?.completed;
     const total=progress?.total;
-    const unit=typeof progress?.unit==='string'
+    const unit=is.string(progress?.unit)
         ?progress.unit
         :'';
-    if(!Number.isFinite(completed)
-        ||!Number.isFinite(total)
+    if(!is.finite(completed)
+        ||!is.finite(total)
         ||total<=0
         ||!unit){
         return phase;
@@ -429,15 +432,15 @@ function createSTTActivationController({
     EventClass=globalThis.CustomEvent,
     eventSource=null
 }){
-    if(!host||typeof host.dispatchEvent!=='function'
-        ||typeof host.requestSTTActivation!=='function'){
+    if(!host||!is.function(host.dispatchEvent)
+        ||!is.function(host.requestSTTActivation)){
         throw codedError(
             'The STT activation host must provide dispatchEvent() and requestSTTActivation().',
             STT_ACTIVATION_ERROR_CODES.hostInvalid,
             TypeError
         );
     }
-    if(typeof EventClass!=='function'){
+    if(!is.function(EventClass)){
         throw codedError(
             'The STT activation event class must be a constructor.',
             STT_ACTIVATION_ERROR_CODES.eventClassInvalid,
@@ -445,15 +448,15 @@ function createSTTActivationController({
         );
     }
     if(!button
-        ||typeof button.addEventListener!=='function'
-        ||typeof button.removeEventListener!=='function'){
+        ||!is.function(button.addEventListener)
+        ||!is.function(button.removeEventListener)){
         throw codedError(
             'The STT activation button must provide addEventListener() and removeEventListener().',
             STT_ACTIVATION_ERROR_CODES.buttonInvalid,
             TypeError
         );
     }
-    if(typeof onChange!=='function'){
+    if(!is.function(onChange)){
         throw codedError(
             'The STT activation onChange callback must be a function.',
             STT_ACTIVATION_ERROR_CODES.onChangeInvalid,
@@ -462,10 +465,10 @@ function createSTTActivationController({
     }
     if(eventSource!==null
         &&(
-            typeof eventSource!=='object'
-            ||typeof eventSource.dispatch!=='function'
-            ||typeof eventSource.dispose!=='function'
-            ||typeof eventSource.instanceId!=='string'
+            !is.object(eventSource)
+            ||!is.function(eventSource.dispatch)
+            ||!is.function(eventSource.dispose)
+            ||!is.string(eventSource.instanceId)
         )){
         throw codedError(
             'The STT activation event source must be a compatible Arcane event source.',
@@ -489,7 +492,7 @@ function createSTTActivationController({
     let destroyed=false;
 
     function visibleError(error,fallback){
-        const message=typeof error?.message==='string'
+        const message=is.string(error?.message)
             ?error.message
             :'';
         return message||fallback;
@@ -504,9 +507,9 @@ function createSTTActivationController({
     }
 
     function selected(){
-        return typeof role?.providerId==='string'
+        return is.string(role?.providerId)
             &&role.providerId.length>0
-            &&typeof role?.modelId==='string'
+            &&is.string(role?.modelId)
             &&role.modelId.length>0;
     }
 
@@ -622,7 +625,7 @@ function createSTTActivationController({
                         action:nextAction,
                         reason:STT_ACTIVATION_REASONS.explicitRequest,
                         state:role.state,
-                        roleOperationId:typeof role?.operationId==='string'
+                        roleOperationId:is.string(role?.operationId)
                             ?role.operationId
                             :null
                     }
@@ -692,7 +695,7 @@ function createSTTActivationController({
                         action:nextAction,
                         code,
                         reason,
-                        causeCode:typeof error?.code==='string'
+                        causeCode:is.string(error?.code)
                             ?error.code
                             :null
                     }
@@ -851,13 +854,13 @@ function normalizeVoiceOptions(input={},previous={}){
         transcriptionLabel:'transcription'
     };
     for(const [source,target] of Object.entries(aliases)){
-        if(typeof input[source]==='string'){
+        if(is.string(input[source])){
             labels[target]=input[source];
         }
     }
 
     const constraints=option(input,previous,'mediaConstraints',{audio:true});
-    if(!constraints||typeof constraints!=='object'||Array.isArray(constraints)){
+    if(!constraints||!is.object(constraints)||is.array(constraints)){
         throw new TypeError('mediaConstraints must be an object');
     }
     if(!own(constraints,'audio')||constraints.audio===false){
@@ -869,14 +872,14 @@ function normalizeVoiceOptions(input={},previous={}){
         'mimeTypes',
         ['audio/webm;codecs=opus','audio/mp4','audio/webm']
     );
-    if(!Array.isArray(mimeTypes)){
+    if(!is.array(mimeTypes)){
         throw new TypeError('mimeTypes must be an array');
     }
-    if(mimeTypes.some(value=>typeof value!=='string')){
+    if(mimeTypes.some(value=>!is.string(value))){
         throw new TypeError('mimeTypes must contain only strings');
     }
     const separator=option(input,previous,'separator','\n\n');
-    if(typeof separator!=='string'){
+    if(!is.string(separator)){
         throw new TypeError('separator must be a string');
     }
 
@@ -936,7 +939,7 @@ const MARKDOWN_LABELS=completeValue({
 });
 
 function normalizeMarkdownFormats(values=MARKDOWN_FORMATS){
-    if(!Array.isArray(values)){
+    if(!is.array(values)){
         throw new TypeError('Markdown formats must be an array');
     }
     const ids=new Set();
@@ -984,7 +987,7 @@ function normalizeMarkdownOptions(input={},previous={}){
         toolbarLabel:'toolbar'
     };
     for(const [source,target] of Object.entries(aliases)){
-        if(typeof input[source]==='string'){
+        if(is.string(input[source])){
             labels[target]=input[source];
         }
     }
@@ -1012,11 +1015,11 @@ function applyMarkdownFormat(value='',selectionStart=0,selectionEnd=selectionSta
     const rawEnd=Number(selectionEnd);
     const start=Math.max(
         0,
-        Math.min(value.length,Number.isFinite(rawStart)?rawStart:0)
+        Math.min(value.length,is.finite(rawStart)?rawStart:0)
     );
     const end=Math.max(
         start,
-        Math.min(value.length,Number.isFinite(rawEnd)?rawEnd:start)
+        Math.min(value.length,is.finite(rawEnd)?rawEnd:start)
     );
     const selected=value.slice(start,end);
     const content=selected||format.placeholder;

package/runtime/arcane/modules/ConfiguredAIChatSession.js

@@ -1,3 +1,6 @@
+import Is from 'strong-type';
+const is=new Is(false);
+
 import {recurringChatMessages} from './ChatRecords.js';
 
 const FORBIDDEN_REQUEST_FIELDS=new Set([
@@ -12,7 +15,7 @@ const FORBIDDEN_REQUEST_FIELDS=new Set([
 ]);
 
 function isPlainRecord(value){
-    if(!value||typeof value!=='object'||Array.isArray(value))return false;
+    if(!value||!is.object(value)||is.array(value))return false;
     const prototype=Object.getPrototypeOf(value);
     return prototype===Object.prototype||prototype===null;
 }
@@ -23,7 +26,7 @@ function coded(error,code){
 }
 
 function contentText(value,label,{optional=false}={}){
-    if(typeof value!=='string') throw new TypeError(`${label} must be a string.`);
+    if(!is.string(value)) throw new TypeError(`${label} must be a string.`);
     if(!value.trim()){
         if(optional) return null;
         throw new TypeError(`${label} must contain text.`);
@@ -33,7 +36,7 @@ function contentText(value,label,{optional=false}={}){
 
 function optionalMetadata(value,label){
     if(value===undefined||value===null||value==='') return null;
-    if(typeof value!=='string'){
+    if(!is.string(value)){
         throw coded(new TypeError(`${label} must be a string when provided.`),'AI_CHAT_INVALID_RESPONSE');
     }
     if(!value.trim()) return null;
@@ -41,12 +44,12 @@ function optionalMetadata(value,label){
 }
 
 function usageCount(value){
-    return Number.isSafeInteger(value)&&value>=0?value:null;
+    return is.safeInteger(value)&&value>=0?value:null;
 }
 
 function providerUsageCount(value,label){
     if(value===undefined) return null;
-    if(!Number.isSafeInteger(value)||value<0){
+    if(!is.safeInteger(value)||value<0){
         throw coded(
             new TypeError(`${label} must be a nonnegative integer when provided.`),
             'AI_CHAT_INVALID_RESPONSE',
@@ -57,10 +60,10 @@ function providerUsageCount(value,label){
 
 function signalLike(value){
     return value===undefined||value===null||(
-        typeof value==='object'
-        &&typeof value.aborted==='boolean'
-        &&typeof value.addEventListener==='function'
-        &&typeof value.removeEventListener==='function'
+        is.object(value)
+        &&is.boolean(value.aborted)
+        &&is.function(value.addEventListener)
+        &&is.function(value.removeEventListener)
     );
 }
 
@@ -76,7 +79,7 @@ function assertMessageKeys(value,allowed,label){
 }
 
 function toolCallArgumentMessage(value,label){
-    if(typeof value!=='string'){
+    if(!is.string(value)){
         throw new TypeError(`${label} must be a JSON string.`);
     }
     let argumentsRecord;
@@ -94,7 +97,7 @@ function toolCallArgumentMessage(value,label){
             'AI_CHAT_INVALID_TOOL_CALL',
         );
     }
-    if(typeof argumentsRecord.message!=='string'||!argumentsRecord.message.trim()){
+    if(!is.string(argumentsRecord.message)||!argumentsRecord.message.trim()){
         throw coded(
             new TypeError(`${label}.message must contain user-facing text.`),
             'AI_CHAT_TOOL_MESSAGE_REQUIRED',
@@ -105,7 +108,7 @@ function toolCallArgumentMessage(value,label){
 
 function requireToolMessageSchemas(value,label){
     if(value===undefined) return;
-    if(!Array.isArray(value)) throw new TypeError(`${label} must be an array.`);
+    if(!is.array(value)) throw new TypeError(`${label} must be an array.`);
     for(let index=0;index<value.length;index++){
         const tool=value[index];
         const parameters=tool?.function?.parameters;
@@ -119,9 +122,9 @@ function requireToolMessageSchemas(value,label){
             ||!isPlainRecord(parameters.properties)
             ||!isPlainRecord(messageSchema)
             ||messageSchema.type!=='string'
-            ||!Number.isInteger(messageSchema.minLength)
+            ||!is.integer(messageSchema.minLength)
             ||messageSchema.minLength<1
-            ||!Array.isArray(parameters.required)
+            ||!is.array(parameters.required)
             ||!parameters.required.includes('message')
         ){
             throw coded(
@@ -141,7 +144,7 @@ function normalizeRequestOptions(value,label){
     if(forbidden) throw new TypeError(`${label}.${forbidden} is managed by the chat session.`);
     requireToolMessageSchemas(value.tools,`${label}.tools`);
     for(const key of ['parallelToolCalls','parallel_tool_calls']){
-        if(Object.hasOwn(value,key)&&typeof value[key]!=='boolean'){
+        if(Object.hasOwn(value,key)&&!is.boolean(value[key])){
             throw new TypeError(`${label}.${key} must be a boolean when provided.`);
         }
     }
@@ -151,12 +154,12 @@ function normalizeRequestOptions(value,label){
 export function normalizeStructuralToolCall(call,label='Structural tool call'){
     try{
         if(!isPlainRecord(call)) throw new TypeError(`${label} must be a plain object.`);
-        if(typeof call.id!=='string'||!call.id.trim()){
+        if(!is.string(call.id)||!call.id.trim()){
             throw new TypeError(`${label}.id must contain text.`);
         }
         if(call.type!=='function') throw new TypeError(`${label}.type must be function.`);
         if(!isPlainRecord(call.function)) throw new TypeError(`${label}.function must be a plain object.`);
-        if(typeof call.function.name!=='string'||!call.function.name.trim()){
+        if(!is.string(call.function.name)||!call.function.name.trim()){
             throw new TypeError(`${label}.function.name must contain text.`);
         }
         toolCallArgumentMessage(call.function.arguments,`${label}.function.arguments`);
@@ -177,7 +180,7 @@ export function normalizeStructuralToolCall(call,label='Structural tool call'){
 
 function normalizeToolCalls(value,label){
     if(value===undefined) return null;
-    if(!Array.isArray(value)){
+    if(!is.array(value)){
         throw new TypeError(`${label} must be an array of structural tool calls.`);
     }
     const ids=new Set();
@@ -204,13 +207,13 @@ function normalizeMessage(value,label,allowedRoles){
     if(
         value.role==='assistant'
         &&Object.hasOwn(value,'reasoning_content')
-        &&typeof value.reasoning_content!=='string'
+        &&!is.string(value.reasoning_content)
     ){
         throw new TypeError(`${label}.reasoning_content must be a string when provided.`);
     }
     const hasReasoning=Boolean(
         value.role==='assistant'
-        &&typeof value.reasoning_content==='string'
+        &&is.string(value.reasoning_content)
         &&value.reasoning_content.length
     );
     let content;
@@ -274,7 +277,7 @@ function publicMessage(value){
 
 function normalizeInitialMessages(value){
     if(value===undefined) return [];
-    if(!Array.isArray(value)) throw new TypeError('initialMessages must be an array.');
+    if(!is.array(value)) throw new TypeError('initialMessages must be an array.');
     const messages=value.map((item,index)=>normalizeMessage(
         item,
         `initialMessages[${index}]`,
@@ -285,14 +288,14 @@ function normalizeInitialMessages(value){
 }
 
 function normalizeInputMessages(value){
-    if(typeof value==='string'){
+    if(is.string(value)){
         return [normalizeMessage(
             {role:'user',content:value},
             'The user message',
             new Set(['user']),
         )];
     }
-    if(Array.isArray(value)){
+    if(is.array(value)){
         if(!value.length){
             throw new TypeError('The request tool-result batch must not be empty.');
         }
@@ -375,7 +378,7 @@ function pendingToolCallIds(messages,validate=false){
 
 async function configuredArcaneChat(request){
     const api=globalThis.Arcane?.ai;
-    if(typeof api?.chat!=='function'){
+    if(!is.function(api?.chat)){
         throw coded(
             new Error('The configured Arcane AI chat capability is unavailable.'),
             'AI_CHAT_UNAVAILABLE',
@@ -427,7 +430,7 @@ function normalizeSessionResponse(response){
 }
 
 function normalizeOpenAICompatibleResponse(response){
-    if(!Array.isArray(response.choices)||response.choices.length===0){
+    if(!is.array(response.choices)||response.choices.length===0){
         throw coded(
             new TypeError('The chat provider completion must contain at least one choice.'),
             'AI_CHAT_INVALID_RESPONSE',
@@ -530,8 +533,8 @@ export default class ConfiguredAIChatSession{
         const chat=options.chat===undefined?configuredArcaneChat:options.chat;
         const contextBuilder=options.contextBuilder??null;
         const request=normalizeRequestOptions(options.request,'request');
-        if(typeof chat!=='function') throw new TypeError('chat must be a function.');
-        if(contextBuilder!==null&&typeof contextBuilder!=='function'){
+        if(!is.function(chat)) throw new TypeError('chat must be a function.');
+        if(contextBuilder!==null&&!is.function(contextBuilder)){
             throw new TypeError('contextBuilder must be a function when provided.');
         }
         const rawSystemPrompt=options.systemPrompt??'';