arcane-os 0.5.16 → 0.5.18

package/src/testing.mjs

@@ -1,5 +1,8 @@
+import Is from 'strong-type';
 import VanillaTest from 'vanilla-test';
 
+const is = new Is(false);
+
 export const DEFAULT_TEST_TIMEOUT_MS=30_000;
 
 const MAX_TEST_TIMEOUT_MS=3_600_000;
@@ -26,14 +29,14 @@ class TestCancellationError extends Error{
 }
 
 function assertName(name){
-    if(typeof name!=='string'||name.trim()===''){
+    if(!is.string(name)||name.trim()===''){
         throw new TypeError('A test name must be a nonempty string.');
     }
 }
 
 function testTimeout(options){
     const timeout=options.timeout??DEFAULT_TEST_TIMEOUT_MS;
-    if(!Number.isSafeInteger(timeout)||timeout<1||timeout>MAX_TEST_TIMEOUT_MS){
+    if(!is.safeInteger(timeout)||timeout<1||timeout>MAX_TEST_TIMEOUT_MS){
         throw new TypeError(
             `Test timeout must be an integer from 1 through ${String(MAX_TEST_TIMEOUT_MS)} milliseconds.`
         );
@@ -43,13 +46,13 @@ function testTimeout(options){
 
 function definition(name,optionsOrCallback,maybeCallback){
     assertName(name);
-    const hasOptions=typeof optionsOrCallback!=='function';
+    const hasOptions=!is.function(optionsOrCallback);
     const options=hasOptions?optionsOrCallback:{};
     const callback=hasOptions?maybeCallback:optionsOrCallback;
-    if(options===null||typeof options!=='object'||Array.isArray(options)){
+    if(options===null||!is.object(options)||is.array(options)){
         throw new TypeError('Test options must be an object.');
     }
-    if(typeof callback!=='function'){
+    if(!is.function(callback)){
         throw new TypeError(`Test "${name}" requires a callback function.`);
     }
     return {name,timeoutMs:testTimeout(options),callback};
@@ -226,7 +229,7 @@ async function executeDefinition(current,path,outcomes,{parentSignal,state,onPha
             if(state.cancelled||state.fatalError||controller.signal.aborted){
                 throw state.fatalError??cancellationError(controller.signal);
             }
-            if(typeof callback!=='function'){
+            if(!is.function(callback)){
                 throw new TypeError('t.after() requires a callback function.');
             }
             cleanups.push(callback);
@@ -365,7 +368,7 @@ export async function runRegisteredTests({signal,requireTests=true,onPhase}={}){
     if(lifecycle!=='collecting'){
         throw new ReferenceError('The registered test suite can run only once.');
     }
-    if(onPhase!==undefined&&typeof onPhase!=='function'){
+    if(onPhase!==undefined&&!is.function(onPhase)){
         throw new TypeError('onPhase must be a function when provided.');
     }
     lifecycle='running';

package/src/toolchain.mjs

@@ -1,3 +1,4 @@
+import Is from 'strong-type';
 import path from 'node:path';
 import {readdir,lstat,realpath} from 'node:fs/promises';
 import {createWorkspace,initWorkspace} from './scaffold.mjs';
@@ -39,6 +40,8 @@ import {
     verifyAppReleaseBundle
 } from './release-bundle.mjs';
 
+const is = new Is(false);
+
 async function emit(onEvent,event){
     await onEvent?.(event);
 }
@@ -63,10 +66,10 @@ function isOuterCommitEvent(label,event){
 
 function hasCommittedOuterResult(label,result){
     if(label==='import-map')return result?.committed===true;
-    if(label==='package')return typeof result?.outputRoot==='string';
-    if(label==='bundle')return typeof result?.bundlePath==='string';
+    if(label==='package')return is.string(result?.outputRoot);
+    if(label==='bundle')return is.string(result?.bundlePath);
     if(label!=='build')return false;
-    return result?.artifact!=null||typeof result?.release?.outputRoot==='string';
+    return result?.artifact!=null||is.string(result?.release?.outputRoot);
 }
 
 async function ownedWork(label,work,{
@@ -245,8 +248,8 @@ async function preparedWorkspace(options){
     });
     const external=workspace.workspaceMode==='external';
     if(external&&(!workspace.sdkInstallation
-        ||typeof workspace.sdkInstallation.runtimeRoot!=='string'
-        ||typeof workspace.sdkInstallation.browserRuntimeRoot!=='string')){
+        ||!is.string(workspace.sdkInstallation.runtimeRoot)
+        ||!is.string(workspace.sdkInstallation.browserRuntimeRoot))){
         throw new ArcaneError(
             ERROR_CODES.workspaceInvalid,
             'Validated external workspace is missing its SDK runtime directories.'
@@ -397,7 +400,7 @@ async function runPreparedApplicationTests(prepared,options={}){
 export async function testApplication(options={}){
     throwIfAborted(options.signal);
     if(operationScope(options)==='shared'){
-        if(typeof options.testFile!=='string'||!options.testFile){
+        if(!is.string(options.testFile)||!options.testFile){
             throw new ArcaneError(
                 ERROR_CODES.usage,
                 'Shared testing requires one exact repo-relative .test.mjs file.'
@@ -521,7 +524,7 @@ export async function verifyApplication(options={}){
 
 export async function bundleApplication(options={}){
     assertApplicationScope(options,'Release bundling');
-    if(options.overwrite!==undefined&&typeof options.overwrite!=='boolean'){
+    if(options.overwrite!==undefined&&!is.boolean(options.overwrite)){
         throw new ArcaneError(ERROR_CODES.usage,'overwrite must be a literal boolean.');
     }
     const prepared=await preparedWorkspace(options);
@@ -658,7 +661,7 @@ function sameOrDescendant(parent,candidate){
 }
 
 export function resolveNativeBuildOutputRoot({target,workspaceMode,workspaceRoot,outputRoot}={}){
-    if(typeof target!=='string'||!target||target==='browser'){
+    if(!is.string(target)||!target||target==='browser'){
         throw new ArcaneError(ERROR_CODES.usage,'A native output root requires one explicit native target.');
     }
     if(workspaceMode==='integrated'&&!outputRoot){
@@ -696,7 +699,7 @@ function sameCanonicalPath(left,right){
 
 export function assertIntegratedNativeToolchain({workspaceMode,workspaceRoot,toolchainRoot,target}={}){
     if(workspaceMode!=='integrated')return;
-    if(typeof toolchainRoot!=='string'||!sameCanonicalPath(workspaceRoot,toolchainRoot)){
+    if(!is.string(toolchainRoot)||!sameCanonicalPath(workspaceRoot,toolchainRoot)){
         throw new ArcaneError(
             ERROR_CODES.policyDenied,
             `An integrated ${target??'native'} build must use the same Arcane OS checkout for --workspace and --arcane-root.`
@@ -972,7 +975,7 @@ function nativeBuildResult(assembly){
 
 function usesWorkspaceNativeAssembly(options){
     return options.nativeBuilder!=null
-        &&typeof options.workspaceRoot==='string'
+        &&is.string(options.workspaceRoot)
         &&options.release==null
         &&options.appReleaseRoot==null
         &&options.appDescriptor==null;

package/src/update-check.mjs

@@ -1,7 +1,10 @@
+import Is from 'strong-type';
 import {ArcaneError,ERROR_CODES,throwIfAborted} from './errors.mjs';
 import {parseSemver} from './packager/core.mjs';
 import {SDK_NAME,SDK_VERSION} from './constants.mjs';
 
+const is = new Is(false);
+
 export const SDK_UPDATE_REGISTRY='https://registry.npmjs.org/';
 export const SDK_UPDATE_TIMEOUT_MS=2500;
 
@@ -13,7 +16,7 @@ function updateFailure(message,{cause,details}={}){
 }
 
 function plainObject(value){
-    return value!==null&&typeof value==='object'&&!Array.isArray(value);
+    return value!==null&&is.object(value)&&!is.array(value);
 }
 
 function canonicalPackageName(value){
@@ -41,7 +44,7 @@ function registryEndpoint(registry,packageName){
 }
 
 function validateTimeout(value){
-    if(!Number.isSafeInteger(value)||value<1){
+    if(!is.safeInteger(value)||value<1){
         throw updateFailure('The SDK update timeout must be a positive integer of milliseconds.');
     }
     return value;
@@ -76,7 +79,7 @@ async function responseText(response){
     if(!/^(?:application\/json|application\/[A-Za-z0-9.+-]+\+json)(?:\s*;|$)/iu.test(contentType)){
         throw updateFailure('The npm registry returned a non-JSON update response.');
     }
-    if(!response.body||typeof response.body.getReader!=='function'){
+    if(!response.body||!is.function(response.body.getReader)){
         throw updateFailure('The npm registry returned no readable update response.');
     }
     const reader=response.body.getReader();
@@ -113,7 +116,7 @@ function canonicalDistTags(value){
     const tags=Object.create(null);
     for(const [tag,version] of entries){
         if(!DIST_TAG_PATTERN.test(tag)||FORBIDDEN_DIST_TAG_KEYS.has(tag)
-            ||typeof version!=='string'){
+            ||!is.string(version)){
             throw updateFailure('The npm registry update response contained an invalid dist-tag.');
         }
         try{
@@ -180,7 +183,7 @@ export async function checkForSdkUpdate({
     const selectedPackage=canonicalPackageName(packageName);
     const selectedRegistry=validateUpdateRegistry(registry);
     const selectedTimeout=validateTimeout(timeoutMs);
-    if(typeof fetchImpl!=='function'){
+    if(!is.function(fetchImpl)){
         throw updateFailure('The SDK update HTTP client is unavailable.');
     }
     const tag=updateTagForVersion(currentVersion);
@@ -198,7 +201,7 @@ export async function checkForSdkUpdate({
             signal:linked.signal
         });
         throwIfAborted(signal);
-        if(!response||typeof response.status!=='number'){
+        if(!response||!is.number(response.status)){
             throw updateFailure('The npm registry update response is unavailable.');
         }
         if(response.status!==200){

package/src/workspace-operation-lock.mjs

@@ -1,8 +1,11 @@
+import Is from 'strong-type';
 import {randomUUID} from 'node:crypto';
 import {constants as FS_CONSTANTS} from 'node:fs';
 import {lstat,mkdir,open,readFile,realpath,rm} from 'node:fs/promises';
 import path from 'node:path';
 
+const is = new Is(false);
+
 const LOCK_DIRECTORY='.arcane';
 const LOCK_NAME='workspace-operation.lock.json';
 const LOCK_TTL_MILLISECONDS=6*60*60*1000;
@@ -44,7 +47,7 @@ function samePath(left,right){
 }
 
 function validOperation(value){
-    return typeof value==='string'&&/^[a-z][a-z0-9._-]*$/u.test(value);
+    return is.string(value)&&/^[a-z][a-z0-9._-]*$/u.test(value);
 }
 
 function trackedLeaseState(fields){
@@ -96,7 +99,7 @@ async function ensureLockDirectory(workspace){
 }
 
 function ownerIsAlive(pid){
-    if(!Number.isSafeInteger(pid)||pid<1)return false;
+    if(!is.safeInteger(pid)||pid<1)return false;
     try{
         process.kill(pid,0);
         return true;
@@ -106,21 +109,21 @@ function ownerIsAlive(pid){
 }
 
 function lockDocument(value,{workspaceRoot,now=Date.now()}={}){
-    if(!value||typeof value!=='object'||Array.isArray(value)
+    if(!value||!is.object(value)||is.array(value)
         ||value.schemaVersion!==1
         ||value.kind!=='arcane-workspace-operation-lock'
         ||!validOperation(value.operation)
-        ||typeof value.nonce!=='string'||!value.nonce
-        ||!value.owner||!Number.isSafeInteger(value.owner.pid)
-        ||typeof value.scope!=='string'||!samePath(value.scope,workspaceRoot)
-        ||typeof value.acquiredAt!=='string'
-        ||typeof value.expiresAt!=='string'
+        ||!is.string(value.nonce)||!value.nonce
+        ||!value.owner||!is.safeInteger(value.owner.pid)
+        ||!is.string(value.scope)||!samePath(value.scope,workspaceRoot)
+        ||!is.string(value.acquiredAt)
+        ||!is.string(value.expiresAt)
         ||value.releaseProcedure!==RELEASE_PROCEDURE
         ||value.staleRecovery!==STALE_RECOVERY){
         return null;
     }
     const expiresAt=Date.parse(value.expiresAt);
-    if(!Number.isFinite(expiresAt))return null;
+    if(!is.finite(expiresAt))return null;
     return {...value,expired:expiresAt<=now};
 }
 
@@ -227,7 +230,7 @@ async function acquire({
     onEvent
 }){
     throwIfAborted(signal);
-    if(typeof workspaceRoot!=='string'||!workspaceRoot.trim()){
+    if(!is.string(workspaceRoot)||!workspaceRoot.trim()){
         throw new TypeError('workspaceRoot is required for an Arcane workspace operation lock.');
     }
     if(!validOperation(operation)){
@@ -404,7 +407,7 @@ function attachReleaseError(workError,releaseError){
 }
 
 export async function withWorkspaceOperationLock(options,work){
-    if(typeof work!=='function')throw new TypeError('Workspace operation lock work must be a function.');
+    if(!is.function(work))throw new TypeError('Workspace operation lock work must be a function.');
     const acquired=await acquire(options);
     let result;
     let workError;

package/src/workspace-runtime.mjs

@@ -1,3 +1,4 @@
+import Is from 'strong-type';
 import {randomUUID} from 'node:crypto';
 import {copyFile,lstat,mkdir,readFile,readdir,realpath,rename,rm,writeFile} from 'node:fs/promises';
 import path from 'node:path';
@@ -6,6 +7,8 @@ import {rewriteAssetReferences} from './import-map.mjs';
 import {getSdkRoot} from './runtime.mjs';
 import {getSdkBrowserRuntimeRoot} from './sdk-browser-runtime.mjs';
 
+const is = new Is(false);
+
 const STAGING_PREFIX='.arcane-runtime-content-staging-';
 const BACKUP_PREFIX='.arcane-runtime-content-backup-';
 
@@ -23,7 +26,7 @@ function throwIfAborted(signal){
 }
 
 async function emit(onEvent,event){
-    if(typeof onEvent==='function')await onEvent(event);
+    if(is.function(onEvent))await onEvent(event);
 }
 
 function compareText(left,right){

package/src/workspace.mjs

@@ -1,3 +1,4 @@
+import Is from 'strong-type';
 import {readFile,readdir,realpath,stat} from 'node:fs/promises';
 import path from 'node:path';
 import {
@@ -9,6 +10,8 @@ import {loadAppDescriptor} from './app-descriptor.mjs';
 import {SDK_NAME as EXPECTED_SDK_NAME} from './constants.mjs';
 import {inspectImportMapHtml} from './import-map.mjs';
 
+const is = new Is(false);
+
 const APP_ID_PATTERN=/^[a-z][a-z0-9]*(?:-[a-z0-9]+)*$/;
 const NPM_PACKAGE_NAME_PATTERN=/^(?:@[a-z0-9][a-z0-9._-]*\/)?[a-z0-9][a-z0-9._-]*$/u;
 const ROOT_CONFIG_NAME='arcane-packager.json';
@@ -22,7 +25,7 @@ function fail(message,code='ARCANE_WORKSPACE_INVALID'){
 }
 
 function isObject(value){
-    return value!==null&&typeof value==='object'&&!Array.isArray(value);
+    return value!==null&&is.object(value)&&!is.array(value);
 }
 
 function ordinal(left,right){
@@ -37,7 +40,7 @@ function throwIfAborted(signal){
 }
 
 async function emit(onEvent,event){
-    if(typeof onEvent==='function')await onEvent(event);
+    if(is.function(onEvent))await onEvent(event);
 }
 
 async function readJson(filePath,label){
@@ -71,7 +74,7 @@ function sameDirectoryPath(left,right){
 }
 
 function sdkPackageSourceForDependency(dependencyName){
-    if(typeof dependencyName!=='string'||dependencyName.length>214
+    if(!is.string(dependencyName)||dependencyName.length>214
         ||!NPM_PACKAGE_NAME_PATTERN.test(dependencyName)){
         fail(`Invalid installed SDK dependency name: ${String(dependencyName)}.`);
     }
@@ -85,7 +88,7 @@ function sdkPackageSourceForDependency(dependencyName){
 }
 
 function dependencyNameForSdkPackageSource(source){
-    if(typeof source!=='string'||!source.startsWith('node_modules/'))return null;
+    if(!is.string(source)||!source.startsWith('node_modules/'))return null;
     const dependencyName=source.slice('node_modules/'.length);
     try{
         return sdkPackageSourceForDependency(dependencyName)===source?dependencyName:null;
@@ -95,7 +98,7 @@ function dependencyNameForSdkPackageSource(source){
 }
 
 function routeIncludeMatches(actual,wanted,optionalSecurity){
-    if(!Array.isArray(actual)||!Array.isArray(wanted))return false;
+    if(!is.array(actual)||!is.array(wanted))return false;
     if(actual.length===wanted.length
         &&actual.every(function sameIncludedPath(value,index){return value===wanted[index];})){
         return true;
@@ -118,11 +121,11 @@ export function resolveSdkPackageDeclaration(rootPackage,{
         if(!isObject(group))fail(`package.json ${groupName} must be a JSON object.`);
         for(const [dependencyName,specifier] of Object.entries(group)){
             const canonicalName=dependencyName===EXPECTED_SDK_NAME;
-            const aliasTarget=typeof specifier==='string'
+            const aliasTarget=is.string(specifier)
                 &&(specifier===`npm:${EXPECTED_SDK_NAME}`
                     ||specifier.startsWith(`npm:${EXPECTED_SDK_NAME}@`));
             if(!canonicalName&&!aliasTarget)continue;
-            if(typeof specifier!=='string'||!specifier.trim()){
+            if(!is.string(specifier)||!specifier.trim()){
                 fail(`package.json ${groupName}.${dependencyName} must declare an SDK package version or source.`);
             }
             candidates.push(completeValue({
@@ -155,7 +158,7 @@ export function resolveSdkPackageDeclaration(rootPackage,{
 function classifyRootConfig(config){
     const validated=validatePackagerRootConfig(config,ROOT_CONFIG_NAME);
     const routes=validated.sharedPayloads['browser-runtime'];
-    if(!Array.isArray(routes))fail(`${ROOT_CONFIG_NAME} must define browser-runtime routes.`);
+    if(!is.array(routes))fail(`${ROOT_CONFIG_NAME} must define browser-runtime routes.`);
     const externalPackageSource=routes.length===2
         &&dependencyNameForSdkPackageSource(routes[1]?.source)!==null
         ?routes[1].source
@@ -194,7 +197,7 @@ function classifyRootConfig(config){
                     optionalArcaneSecurity&&index===0
                         &&wanted.source==='arcane'&&wanted.destination==='arcane'
                 )
-                &&Array.isArray(route.exclude)&&route.exclude.length===0;
+                &&is.array(route.exclude)&&route.exclude.length===0;
         });
     };
     let workspaceMode;
@@ -272,7 +275,7 @@ export async function inspectWorkspaceProfile(workspaceRoot=process.cwd()){
 
 export async function selectApp(workspaceRoot=process.cwd(),appId){
     const apps=await discoverApps(workspaceRoot);
-    if(appId!==undefined&&(typeof appId!=='string'||!APP_ID_PATTERN.test(appId))){
+    if(appId!==undefined&&(!is.string(appId)||!APP_ID_PATTERN.test(appId))){
         fail(`Invalid app id: ${String(appId)}.`,'ARCANE_USAGE');
     }
     if(appId){
@@ -292,7 +295,7 @@ export async function resolveWorkspace({workspaceRoot=process.cwd(),appId}={}){
     const canonicalRoot=profile.workspaceRoot;
     const config=profile.config;
     const apps=await discoverAppsInRoot(canonicalRoot,config);
-    if(appId!==undefined&&(typeof appId!=='string'||!APP_ID_PATTERN.test(appId))){
+    if(appId!==undefined&&(!is.string(appId)||!APP_ID_PATTERN.test(appId))){
         fail(`Invalid app id: ${String(appId)}.`,'ARCANE_USAGE');
     }
     let app;
@@ -330,7 +333,7 @@ export async function resolveInstalledSdkInstallation(workspaceRoot,declaration)
         path.join(canonicalPackageRoot,'package.json'),
         'installed SDK package manifest'
     );
-    if(installedPackage.name!==EXPECTED_SDK_NAME||typeof installedPackage.version!=='string'){
+    if(installedPackage.name!==EXPECTED_SDK_NAME||!is.string(installedPackage.version)){
         fail(`Installed SDK package must identify as ${EXPECTED_SDK_NAME}.`);
     }
     const runtimeRoot=path.join(canonicalPackageRoot,'runtime');
@@ -427,8 +430,8 @@ export async function validateDiscoveredApplication({
     onEvent
 }={}){
     throwIfAborted(signal);
-    if(!app||typeof app.appId!=='string'||!APP_ID_PATTERN.test(app.appId)
-        ||typeof app.appRoot!=='string'
+    if(!app||!is.string(app.appId)||!APP_ID_PATTERN.test(app.appId)
+        ||!is.string(app.appRoot)
         ||!app.manifest||!app.descriptor){
         fail('A discovered Arcane application is required for focused validation.');
     }

package/runtime/arcane/modules/AIResponseLength.js

@@ -1,32 +0,0 @@
-export const AI_RESPONSE_LENGTH_DEFAULT='medium';
-
-export const AI_RESPONSE_LENGTH_OPTIONS=[
-    {value:'low',label:'Complete'},
-    {value:'medium',label:'Complete'},
-    {value:'high',label:'Complete'}
-];
-
-const RESPONSE_LENGTH_BY_VALUE=new Map(
-    AI_RESPONSE_LENGTH_OPTIONS.map(option=>[option.value,option])
-);
-
-export function normalizeAIResponseLength(value){
-    const normalized=typeof value==='string'?value.trim().toLowerCase():'';
-    return RESPONSE_LENGTH_BY_VALUE.has(normalized)
-        ?normalized
-        :AI_RESPONSE_LENGTH_DEFAULT;
-}
-
-export function aiResponseLengthInstruction(value){
-    normalizeAIResponseLength(value);
-    return '';
-}
-
-export function applyAIResponseLength(systemPrompt,value){
-    if(typeof systemPrompt!=='string'){
-        throw new TypeError('systemPrompt must be a string');
-    }
-
-    normalizeAIResponseLength(value);
-    return systemPrompt;
-}