@xyo-network/os-runtime 5.0.13 → 6.0.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xyo-network/os-runtime",
-  "version": "5.0.13",
+  "version": "6.0.0",
   "description": "Primary SDK for using XYO Protocol 2.0",
   "homepage": "https://xyo.network",
   "bugs": {
@@ -35,64 +35,64 @@
     "xyos": "./scripts/xyos.mjs"
   },
   "dependencies": {
-    "@xylabs/array": "^4.11.10",
-    "@xylabs/assert": "^4.11.10",
-    "@xylabs/base": "^4.11.10",
-    "@xylabs/events": "^4.11.10",
-    "@xylabs/forget": "^4.11.10",
-    "@xylabs/hex": "^4.11.10",
-    "@xylabs/object": "^4.11.10",
-    "@xylabs/promise": "^4.11.10",
-    "@xyo-network/account-model": "^3.18.2",
-    "@xyo-network/archivist": "^3.18.2",
-    "@xyo-network/archivist-indexeddb": "^3.18.2",
-    "@xyo-network/archivist-memory": "^3.18.2",
-    "@xyo-network/archivist-model": "^3.18.2",
-    "@xyo-network/bios": "^5.0.13",
-    "@xyo-network/bridge-model": "^3.18.2",
-    "@xyo-network/diviner-abstract": "^3.18.2",
-    "@xyo-network/diviner-model": "^3.18.2",
-    "@xyo-network/diviner-payload-generic": "^3.18.2",
-    "@xyo-network/diviner-payload-indexeddb": "^3.18.2",
-    "@xyo-network/diviner-payload-model": "^3.18.2",
-    "@xyo-network/diviner-temporal-indexing-model": "^3.18.2",
-    "@xyo-network/kernel": "^5.0.13",
-    "@xyo-network/kernel-model": "^5.0.13",
-    "@xyo-network/manifest": "^3.18.2",
-    "@xyo-network/manifest-wrapper": "^3.18.2",
-    "@xyo-network/module-factory-locator": "^3.18.2",
-    "@xyo-network/module-model": "^3.18.2",
-    "@xyo-network/module-resolver": "^3.18.2",
-    "@xyo-network/node-model": "^3.18.2",
-    "@xyo-network/os-model": "^5.0.13",
-    "@xyo-network/payload-builder": "^3.18.2",
-    "@xyo-network/payload-model": "^3.18.2",
-    "@xyo-network/storage-model": "^5.0.13",
-    "@xyo-network/wallet": "^3.18.2",
-    "@xyo-network/wallet-model": "^3.18.2",
+    "@xylabs/array": "^4.12.31",
+    "@xylabs/assert": "^4.12.31",
+    "@xylabs/base": "^4.12.31",
+    "@xylabs/events": "^4.12.31",
+    "@xylabs/forget": "^4.12.31",
+    "@xylabs/hex": "^4.12.31",
+    "@xylabs/object": "^4.12.31",
+    "@xylabs/promise": "^4.12.31",
+    "@xyo-network/account-model": "^4.0.1",
+    "@xyo-network/archivist": "^4.0.1",
+    "@xyo-network/archivist-indexeddb": "^4.0.1",
+    "@xyo-network/archivist-memory": "^4.0.1",
+    "@xyo-network/archivist-model": "^4.0.1",
+    "@xyo-network/bios": "^6.0.0",
+    "@xyo-network/bridge-model": "^4.0.1",
+    "@xyo-network/diviner-abstract": "^4.0.1",
+    "@xyo-network/diviner-model": "^4.0.1",
+    "@xyo-network/diviner-payload-generic": "^4.0.1",
+    "@xyo-network/diviner-payload-indexeddb": "^4.0.1",
+    "@xyo-network/diviner-payload-model": "^4.0.1",
+    "@xyo-network/diviner-temporal-indexing-model": "^4.0.1",
+    "@xyo-network/kernel": "^6.0.0",
+    "@xyo-network/kernel-model": "^6.0.0",
+    "@xyo-network/manifest": "^4.0.1",
+    "@xyo-network/manifest-wrapper": "^4.0.1",
+    "@xyo-network/module-factory-locator": "^4.0.1",
+    "@xyo-network/module-model": "^4.0.1",
+    "@xyo-network/module-resolver": "^4.0.1",
+    "@xyo-network/node-model": "^4.0.1",
+    "@xyo-network/os-model": "^6.0.0",
+    "@xyo-network/payload-builder": "^4.0.1",
+    "@xyo-network/payload-model": "^4.0.1",
+    "@xyo-network/storage-model": "^6.0.0",
+    "@xyo-network/wallet": "^4.0.1",
+    "@xyo-network/wallet-model": "^4.0.1",
     "async-mutex": "^0.5.0",
     "chalk": "^5.4.1",
     "cosmiconfig": "^9.0.0",
     "cosmiconfig-typescript-loader": "^6.1.0",
-    "ethers": "^6.14.3",
+    "ethers": "^6.15.0",
     "semver": "^7.7.2",
     "terminal-kit": "^3.1.2",
     "uuid": "^11.1.0",
     "yargs": "^18.0.0"
   },
   "devDependencies": {
-    "@types/node": "^22.15.29",
+    "@types/node": "^24.0.10",
     "@types/semver": "^7.7.0",
     "@types/terminal-kit": "^2.5.7",
     "@types/uuid": "^10.0.0",
     "@types/yargs": "^17.0.33",
-    "@xylabs/ts-scripts-yarn3": "^6.5.7",
-    "@xylabs/tsconfig": "^6.5.7",
-    "@xyo-network/archivist-memory": "^3.18.2",
-    "@xyo-network/bios-model": "^5.0.13",
-    "@xyo-network/bios-nodejs": "^5.0.13",
+    "@xylabs/ts-scripts-yarn3": "^6.5.12",
+    "@xylabs/tsconfig": "^6.5.12",
+    "@xyo-network/archivist-memory": "^4.0.1",
+    "@xyo-network/bios-model": "^6.0.0",
+    "@xyo-network/bios-nodejs": "^6.0.0",
     "typescript": "^5.8.3",
-    "vitest": "^3.2.1"
+    "vitest": "^3.2.4"
   },
   "publishConfig": {
     "access": "public"

package/src/DappCallerBase.ts

@@ -19,7 +19,7 @@ export class DappCallerBase {
       await this.context.root.resolve(DappArchivistModuleName),
       () => `${DappArchivistModuleName} not found [${toJsonString(this.context.root.publicChildren())}]`,
     )
-    return asArchivistInstance(mod, () => `${DappArchivistModuleName} is not an archivist`)
+    return asArchivistInstance(mod, () => `${DappArchivistModuleName} is not an archivist`, { required: true })
   }
 
   /**
@@ -30,7 +30,7 @@ export class DappCallerBase {
       await this.context.root.resolve(DappArchivistPayloadDivinerModuleName),
       () => `${DappArchivistPayloadDivinerModuleName} not found`,
     )
-    return asDivinerInstance(mod, () => `${DappArchivistPayloadDivinerModuleName} is not a diviner`)
+    return asDivinerInstance(mod, () => `${DappArchivistPayloadDivinerModuleName} is not a diviner`, { required: true })
   }
 
   /**
@@ -38,7 +38,7 @@ export class DappCallerBase {
    */
   async getDappIntentArchivist() {
     const mod = assertEx(await this.context.root.resolve(IntentArchivistModuleName), () => `${IntentArchivistModuleName} not found`)
-    return asArchivistInstance(mod, () => `${IntentArchivistModuleName} is not an archivist`)
+    return asArchivistInstance(mod, () => `${IntentArchivistModuleName} is not an archivist`, { required: true })
   }
 
   // Get the IntentArchivistPayloadDiviner
@@ -47,6 +47,6 @@ export class DappCallerBase {
       await this.context.root.resolve(IntentArchivistPayloadDivinerModuleName),
       () => `${IntentArchivistPayloadDivinerModuleName} not found`,
     )
-    return asDivinerInstance(mod, () => `${IntentArchivistPayloadDivinerModuleName} is not a diviner`)
+    return asDivinerInstance(mod, () => `${IntentArchivistPayloadDivinerModuleName} is not a diviner`, { required: true })
   }
 }

package/src/OsCallerBase.ts

@@ -14,7 +14,7 @@ export class OsCallerBase {
   // Get the dapps archivist
   async getDappsArchivist() {
     const mod = assertEx(await this.context.root.resolve(DappsArchivistModuleName), () => `${DappsArchivistModuleName} not found`)
-    return asArchivistInstance(mod, () => `${DappsArchivistModuleName} is not an archivist`)
+    return asArchivistInstance(mod, () => `${DappsArchivistModuleName} is not an archivist`, { required: true })
   }
 
   // Get the dapps archivist development
@@ -23,7 +23,7 @@ export class OsCallerBase {
       await this.context.root.resolve(DappsArchivistDevelopmentModuleName),
       () => `${DappsArchivistDevelopmentModuleName} not found`,
     )
-    return asArchivistInstance(mod, () => `${DappsArchivistDevelopmentModuleName} is not an archivist`)
+    return asArchivistInstance(mod, () => `${DappsArchivistDevelopmentModuleName} is not an archivist`, { required: true })
   }
 
   // Get the dapps archivist payload diviner
@@ -32,7 +32,7 @@ export class OsCallerBase {
       await this.context.root.resolve(DappsArchivistPayloadDivinerModuleName),
       () => `${DappsArchivistPayloadDivinerModuleName} not found`,
     )
-    return asDivinerInstance(mod, () => `${DappsArchivistPayloadDivinerModuleName} is not a diviner`)
+    return asDivinerInstance(mod, () => `${DappsArchivistPayloadDivinerModuleName} is not a diviner`, { required: true })
   }
 
   // Get the dapps archivist payload diviner development
@@ -41,7 +41,7 @@ export class OsCallerBase {
       await this.context.root.resolve(DappsArchivistPayloadDevelopmentDivinerModuleName),
       () => `${DappsArchivistPayloadDevelopmentDivinerModuleName} not found`,
     )
-    return asDivinerInstance(mod, () => `${DappsArchivistPayloadDevelopmentDivinerModuleName} is not a diviner`)
+    return asDivinerInstance(mod, () => `${DappsArchivistPayloadDevelopmentDivinerModuleName} is not a diviner`, { required: true })
   }
 
   // Get the registered dapp interfaces archivist
@@ -50,6 +50,6 @@ export class OsCallerBase {
       await this.context.root.resolve(RegisteredDappInterfacesArchivistModuleName),
       () => `${RegisteredDappInterfacesArchivistModuleName} not found`,
     )
-    return asArchivistInstance(mod, () => `${RegisteredDappInterfacesArchivistModuleName} is not an archivist`)
+    return asArchivistInstance(mod, () => `${RegisteredDappInterfacesArchivistModuleName} is not an archivist`, { required: true })
   }
 }

package/src/PubSubBridgeCaller.ts

@@ -25,6 +25,6 @@ export class PubSubBridgeCaller {
 
   private async getPubSubBridge() {
     const mod = assertEx(await this.node.resolve(BridgedPubSubModuleName), () => `${BridgedPubSubModuleName} not found`)
-    return asBridgeInstance(mod, () => `${BridgedPubSubModuleName} is not a bridge`)
+    return asBridgeInstance(mod, () => `${BridgedPubSubModuleName} is not a bridge`, { required: true })
   }
 }

package/src/access/Caller.ts

@@ -55,7 +55,7 @@ export class DappAccessCaller extends OsCallerBase implements PostRegistrationHa
   private async cacheAccessNode(dappAccessor: RegisteredDappAccess, context: XyOsContext) {
     const accessNodeId = dappAccessor.rootModuleId
     const accessNodeModule = assertEx(await context.root.resolve(accessNodeId), () => 'Access Node Module not found')
-    const accessNode = asNodeInstance(accessNodeModule, () => 'Access Node Module is not a NodeInstance')
+    const accessNode = asNodeInstance(accessNodeModule, () => 'Access Node Module is not a NodeInstance', { required: true })
 
     RunningDappAccessCache.set(dappAccessor.registeringDappId, accessNode)
   }

package/src/access/interfaces/registered-names/helpers/AccessNodeQueries.ts

@@ -36,7 +36,7 @@ export class AccessNodeQueries {
   private async getArchivistFromDappNode() {
     const archivistPath = this.accessRequest?.destinationArchivist || 'DappArchivist'
     const mod = assertEx(await this.xyOsContext.root.resolve(archivistPath), () => `Unable to find archivist at ${archivistPath}`)
-    return asArchivistInstance(mod, () => `Module at ${archivistPath} is not an archivist`)
+    return asArchivistInstance(mod, () => `Module at ${archivistPath} is not an archivist`, { required: true })
   }
 
   private async getPayloadsFromAccessNode() {
@@ -55,6 +55,6 @@ export class AccessNodeQueries {
       await this.nameServiceNamesAccessNode.resolve('PublicXnsArchivist'),
       () => 'Unable to find archivist at PublicXnsArchivist',
     )
-    return asArchivistInstance(archivist, () => 'PublicXnsArchivist is not an archivist')
+    return asArchivistInstance(archivist, () => 'PublicXnsArchivist is not an archivist', { required: true })
   }
 }

package/src/access/interfaces/registered-names/helpers/resource/AbstractXnsCaller.ts

@@ -15,7 +15,7 @@ export abstract class AbstractXnsCaller {
   async getXnsArchivist(pathPrefix?: string) {
     const fullyQualifiedPath = pathPrefix ? `${pathPrefix}:${XnsArchivistModuleName}` : XnsArchivistModuleName
     const mod = assertEx(await this.context.root.resolve(fullyQualifiedPath), () => `${fullyQualifiedPath} not found`)
-    return asArchivistInstance(mod, () => `${fullyQualifiedPath} is not an archivist`)
+    return asArchivistInstance(mod, () => `${fullyQualifiedPath} is not an archivist`, { required: true })
   }
 
   /**
@@ -24,7 +24,7 @@ export abstract class AbstractXnsCaller {
   async getXnsArchivistPayloadDiviner(pathPrefix?: string) {
     const fullyQualifiedPath = pathPrefix ? `${pathPrefix}:${XnsArchivistPayloadDivinerModuleName}` : XnsArchivistPayloadDivinerModuleName
     const mod = assertEx(await this.context.root.resolve(fullyQualifiedPath), () => `${fullyQualifiedPath} not found`)
-    return asDivinerInstance(mod, () => `${fullyQualifiedPath} is not an diviner`)
+    return asDivinerInstance(mod, () => `${fullyQualifiedPath} is not an diviner`, { required: true })
   }
 
   /**
@@ -33,6 +33,6 @@ export abstract class AbstractXnsCaller {
   async getXnsRegistrationsArchivist(pathPrefix?: string) {
     const fullyQualifiedPath = pathPrefix ? `${pathPrefix}:${XnsRegistrationsArchivistModuleName}` : XnsRegistrationsArchivistModuleName
     const mod = assertEx(await this.context.root.resolve(fullyQualifiedPath), () => `${fullyQualifiedPath} not found`)
-    return asArchivistInstance(mod, () => `${fullyQualifiedPath} is not an archivist`)
+    return asArchivistInstance(mod, () => `${fullyQualifiedPath} is not an archivist`, { required: true })
   }
 }

package/src/adapter/Base.ts

@@ -78,14 +78,14 @@ export class NodeAdapterBase extends BaseEmitter<BaseParams, NodeAdapterBaseEven
 
   private async getEventsArchivist() {
     const mod = assertEx(await (await this.kernel.getNode()).resolve('KernelNode:ModuleEvents'), () => 'KernelNode:ModuleEvents not found')
-    return asArchivistInstance(mod, () => `${mod.id} is not an archivist`)
+    return asArchivistInstance(mod, () => `${mod.id} is not an archivist`, { required: true })
   }
 
   private validateAndReturnDriver() {
     const mod = this.kernel.initialized[this.driverName]
     if (mod) {
       // confirm expected shape
-      const node = asAttachableNodeInstance(mod, () => `${mod.id} is not a node`)
+      const node = asAttachableNodeInstance(mod, () => `${mod.id} is not a node`, { required: true })
 
       // set the initialized flag
       this.initialized = true

package/src/classes/settings/CallerBase.ts

@@ -11,7 +11,7 @@ export class OsSettingsCallerBase {
 
   async getOsSettingsArchivist() {
     const mod = assertEx(await this.context.root.resolve(OsSettingsArchivistModuleName), () => `${OsSettingsArchivistModuleName} not found`)
-    return asArchivistInstance(mod, () => `${OsSettingsArchivistModuleName} is not an archivist`)
+    return asArchivistInstance(mod, () => `${OsSettingsArchivistModuleName} is not an archivist`, { required: true })
   }
 
   async getOsSettingsPayloadDiviner() {
@@ -19,6 +19,6 @@ export class OsSettingsCallerBase {
       await this.context.root.resolve(OsSettingsArchivistPayloadDivinerModuleName),
       () => `${OsSettingsArchivistPayloadDivinerModuleName} not found`,
     )
-    return asDivinerInstance(mod, () => `${OsSettingsArchivistPayloadDivinerModuleName} is not a diviner`)
+    return asDivinerInstance(mod, () => `${OsSettingsArchivistPayloadDivinerModuleName} is not a diviner`, { required: true })
   }
 }

package/src/dapp/context/creator/createDappContext.ts

@@ -14,7 +14,7 @@ const GenericPayloadDivinerTags = { 'network.xyo.generic.payload.diviner': 'Gene
 
 const resolveLocator = (existingLocator?: ModuleFactoryLocatorInstance): ModuleFactoryLocatorInstance => {
   const locator = existingLocator ?? new ModuleFactoryLocator()
-  locator.register(GenericPayloadDiviner, GenericPayloadDivinerTags)
+  locator.register(GenericPayloadDiviner.factory(), GenericPayloadDivinerTags)
   return locator
 }
 

package/src/event/bus/EventBus.ts

@@ -44,6 +44,7 @@ export class EventBus implements EventBusInterface {
     return asArchivistInstance(
       assertEx(this._archivist, () => 'Archivist not found.  Did you forget to call start()?'),
       'not a valid archivist instance',
+      { required: true },
     )
   }
 

package/src/loadOsNode.ts

@@ -14,8 +14,8 @@ const OS_NODE_PATH = "1'"
 
 const getDefaultOsNodeLocator = (): ModuleFactoryLocator => {
   const locator = new ModuleFactoryLocator()
-  locator.register(IndexedDbArchivist, { 'network.xyo.archivist.persistence.scope': 'device' })
-  locator.register(IndexedDbPayloadDiviner, { 'network.xyo.archivist.persistence.scope': 'device' })
+  locator.register(IndexedDbArchivist.factory(), { 'network.xyo.archivist.persistence.scope': 'device' })
+  locator.register(IndexedDbPayloadDiviner.factory(), { 'network.xyo.archivist.persistence.scope': 'device' })
   return locator
 }
 

package/src/stack/Base.ts

@@ -134,7 +134,7 @@ export class StackBase extends BaseEmitter<BaseParams, StackBaseEvents> implemen
 
   private async getStackNode() {
     const mod = assertEx(await this.context.root.resolve(this.stackNodeModuleId), () => `${this.stackNodeModuleId} not found`)
-    return asAttachableNodeInstance(mod, () => `${this.stackNodeModuleId} not a NodeInstance`)
+    return asAttachableNodeInstance(mod, () => `${this.stackNodeModuleId} not a NodeInstance`, { required: true })
   }
 
   private async handleDriverReady(node: AttachableNodeInstance) {