npm - holosphere - Versions diffs - 2.0.0-alpha8 → 2.0.0-alpha9 - Mend

holosphere 2.0.0-alpha8 → 2.0.0-alpha9

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (321) hide show

package/CHANGELOG.md +446 -0
package/FEATURES.md +431 -0
package/LICENSE +29 -166
package/LICENSE-AGPL.md +180 -0
package/dist/cdn/holosphere.min.js +55 -0
package/dist/cdn/holosphere.min.js.map +1 -0
package/dist/cjs/holosphere.cjs +1 -1
package/dist/esm/holosphere.js +1 -1
package/dist/{index-CKffQDmQ.cjs → index-DDGt_V9o.cjs} +2 -2
package/dist/{index-CKffQDmQ.cjs.map → index-DDGt_V9o.cjs.map} +1 -1
package/dist/{index-4XHHKe6S.js → index-DJXftyvB.js} +1905 -337
package/dist/index-DJXftyvB.js.map +1 -0
package/dist/{index-Dz5kOZMI.cjs → index-DMbdcMtK.cjs} +17 -4
package/dist/index-DMbdcMtK.cjs.map +1 -0
package/dist/{index-BjP1TXGz.js → index-DeZ1xz_s.js} +2 -2
package/dist/{index-BjP1TXGz.js.map → index-DeZ1xz_s.js.map} +1 -1
package/dist/{indexeddb-storage-lExjjFlV.js → indexeddb-storage-BFt6hMeF.js} +48 -4
package/dist/indexeddb-storage-BFt6hMeF.js.map +1 -0
package/dist/{indexeddb-storage-DD7EFBVc.cjs → indexeddb-storage-BK5tv4Sh.cjs} +2 -2
package/dist/indexeddb-storage-BK5tv4Sh.cjs.map +1 -0
package/dist/{memory-storage-C68adso2.js → memory-storage-C9HuoL2E.js} +44 -4
package/dist/memory-storage-C9HuoL2E.js.map +1 -0
package/dist/{memory-storage-DD_6yyXT.cjs → memory-storage-Dao7jfYG.cjs} +2 -2
package/dist/memory-storage-Dao7jfYG.cjs.map +1 -0
package/dist/{secp256k1-DYELiqgx.cjs → secp256k1-BbKzbLtD.cjs} +2 -2
package/dist/{secp256k1-DYELiqgx.cjs.map → secp256k1-BbKzbLtD.cjs.map} +1 -1
package/dist/{secp256k1-OM8siPyy.js → secp256k1-CreY7Pcl.js} +2 -2
package/dist/{secp256k1-OM8siPyy.js.map → secp256k1-CreY7Pcl.js.map} +1 -1
package/docs/api/ai_aggregation.js.html +333 -0
package/docs/api/ai_breakdown.js.html +524 -0
package/docs/api/ai_classifier.js.html +231 -0
package/docs/api/ai_council.js.html +246 -0
package/docs/api/ai_embeddings.js.html +304 -0
package/docs/api/ai_federation-ai.js.html +338 -0
package/docs/api/ai_h3-ai.js.html +970 -0
package/docs/api/ai_index.js.html +124 -0
package/docs/api/ai_json-ops.js.html +241 -0
package/docs/api/ai_llm-service.js.html +239 -0
package/docs/api/ai_nl-query.js.html +236 -0
package/docs/api/ai_relationships.js.html +367 -0
package/docs/api/ai_schema-extractor.js.html +235 -0
package/docs/api/ai_spatial.js.html +307 -0
package/docs/api/ai_tts.js.html +214 -0
package/docs/api/content_social-protocols.js.html +180 -0
package/docs/api/core_holosphere.js.html +757 -0
package/docs/api/crypto_nostr-utils.js.html +306 -0
package/docs/api/crypto_secp256k1.js.html +267 -0
package/docs/api/data/search.json +1 -0
package/docs/api/federation_discovery.js.html +337 -0
package/docs/api/federation_handshake.js.html +478 -0
package/docs/api/federation_hologram.js.html +1053 -0
package/docs/api/federation_registry.js.html +389 -0
package/docs/api/fonts/Inconsolata-Regular.ttf +0 -0
package/docs/api/fonts/OpenSans-Regular.ttf +0 -0
package/docs/api/fonts/WorkSans-Bold.ttf +0 -0
package/docs/api/global.html +3 -0
package/docs/api/hierarchical_upcast.js.html +128 -0
package/docs/api/index.html +265 -0
package/docs/api/index.js.html +1868 -0
package/docs/api/lib_ai-methods.js.html +660 -0
package/docs/api/lib_contract-methods.js.html +445 -0
package/docs/api/lib_errors.js.html +56 -0
package/docs/api/lib_federation-methods.js.html +348 -0
package/docs/api/lib_index.js.html +33 -0
package/docs/api/module-ai.html +5 -0
package/docs/api/module-ai_aggregation-SmartAggregation.html +6 -0
package/docs/api/module-ai_aggregation.SmartAggregation.html +3 -0
package/docs/api/module-ai_aggregation.html +3 -0
package/docs/api/module-ai_breakdown-TaskBreakdown.html +5 -0
package/docs/api/module-ai_breakdown.TaskBreakdown.html +3 -0
package/docs/api/module-ai_breakdown.html +3 -0
package/docs/api/module-ai_classifier-Classifier.html +6 -0
package/docs/api/module-ai_classifier.Classifier.html +3 -0
package/docs/api/module-ai_classifier.html +3 -0
package/docs/api/module-ai_council-Council.html +6 -0
package/docs/api/module-ai_council.Council.html +3 -0
package/docs/api/module-ai_council.html +3 -0
package/docs/api/module-ai_embeddings-Embeddings.html +5 -0
package/docs/api/module-ai_embeddings.Embeddings.html +3 -0
package/docs/api/module-ai_embeddings.html +3 -0
package/docs/api/module-ai_federation-ai-FederationAdvisor.html +6 -0
package/docs/api/module-ai_federation-ai.FederationAdvisor.html +3 -0
package/docs/api/module-ai_federation-ai.html +3 -0
package/docs/api/module-ai_h3-ai-H3AI.html +6 -0
package/docs/api/module-ai_h3-ai.H3AI.html +3 -0
package/docs/api/module-ai_h3-ai.html +3 -0
package/docs/api/module-ai_json-ops-JSONOps.html +5 -0
package/docs/api/module-ai_json-ops.JSONOps.html +3 -0
package/docs/api/module-ai_json-ops.html +3 -0
package/docs/api/module-ai_llm-service-LLMService.html +5 -0
package/docs/api/module-ai_llm-service.LLMService.html +3 -0
package/docs/api/module-ai_llm-service.html +3 -0
package/docs/api/module-ai_nl-query-NLQuery.html +5 -0
package/docs/api/module-ai_nl-query.NLQuery.html +3 -0
package/docs/api/module-ai_nl-query.html +3 -0
package/docs/api/module-ai_relationships-RelationshipDiscovery.html +6 -0
package/docs/api/module-ai_relationships.RelationshipDiscovery.html +3 -0
package/docs/api/module-ai_relationships.html +3 -0
package/docs/api/module-ai_schema-extractor-SchemaExtractor.html +5 -0
package/docs/api/module-ai_schema-extractor.SchemaExtractor.html +3 -0
package/docs/api/module-ai_schema-extractor.html +3 -0
package/docs/api/module-ai_spatial-SpatialAnalysis.html +6 -0
package/docs/api/module-ai_spatial.SpatialAnalysis.html +3 -0
package/docs/api/module-ai_spatial.html +3 -0
package/docs/api/module-ai_tts-TTS.html +5 -0
package/docs/api/module-ai_tts.TTS.html +3 -0
package/docs/api/module-ai_tts.html +3 -0
package/docs/api/module-content_social-protocols.html +3 -0
package/docs/api/module-core_holosphere-HoloSphere.html +6 -0
package/docs/api/module-core_holosphere.HoloSphere.html +3 -0
package/docs/api/module-core_holosphere.html +3 -0
package/docs/api/module-crypto_nostr-utils.html +3 -0
package/docs/api/module-crypto_secp256k1.html +3 -0
package/docs/api/module-federation_hologram.html +3 -0
package/docs/api/module-hierarchical_upcast.html +3 -0
package/docs/api/module-holosphere-HoloSphereBase.html +3 -0
package/docs/api/module-holosphere.html +3 -0
package/docs/api/module-lib_ai-methods.html +3 -0
package/docs/api/module-lib_contract-methods.html +3 -0
package/docs/api/module-lib_errors-AuthorizationError.html +3 -0
package/docs/api/module-lib_errors-ValidationError.html +3 -0
package/docs/api/module-lib_errors.AuthorizationError.html +3 -0
package/docs/api/module-lib_errors.ValidationError.html +3 -0
package/docs/api/module-lib_errors.html +3 -0
package/docs/api/module-lib_federation-methods.html +3 -0
package/docs/api/module-lib_index.html +3 -0
package/docs/api/module-schema_validator-ValidationError.html +3 -0
package/docs/api/module-schema_validator.ValidationError.html +3 -0
package/docs/api/module-schema_validator.html +3 -0
package/docs/api/module-spatial_h3-operations.html +4 -0
package/docs/api/module-storage_backend-factory.BackendFactory.html +3 -0
package/docs/api/module-storage_backend-factory.html +3 -0
package/docs/api/module-storage_backend-interface-StorageBackend.html +3 -0
package/docs/api/module-storage_backend-interface.StorageBackend.html +3 -0
package/docs/api/module-storage_backend-interface.html +3 -0
package/docs/api/module-storage_backends_activitypub-backend-ActivityPubBackend.html +7 -0
package/docs/api/module-storage_backends_activitypub-backend.ActivityPubBackend.html +3 -0
package/docs/api/module-storage_backends_activitypub-backend.html +3 -0
package/docs/api/module-storage_backends_activitypub_server-ActivityPubServer.html +8 -0
package/docs/api/module-storage_backends_activitypub_server.ActivityPubServer.html +3 -0
package/docs/api/module-storage_backends_activitypub_server.html +3 -0
package/docs/api/module-storage_backends_gundb-backend-GunDBBackend.html +7 -0
package/docs/api/module-storage_backends_gundb-backend.GunDBBackend.html +3 -0
package/docs/api/module-storage_backends_gundb-backend.html +3 -0
package/docs/api/module-storage_backends_nostr-backend-NostrBackend.html +8 -0
package/docs/api/module-storage_backends_nostr-backend.NostrBackend.html +3 -0
package/docs/api/module-storage_backends_nostr-backend.html +3 -0
package/docs/api/module-storage_filesystem-storage-FileSystemStorage.html +5 -0
package/docs/api/module-storage_filesystem-storage-browser-FileSystemStorage.html +3 -0
package/docs/api/module-storage_filesystem-storage-browser.FileSystemStorage.html +3 -0
package/docs/api/module-storage_filesystem-storage-browser.html +3 -0
package/docs/api/module-storage_filesystem-storage.FileSystemStorage.html +3 -0
package/docs/api/module-storage_filesystem-storage.html +3 -0
package/docs/api/module-storage_global-tables.html +3 -0
package/docs/api/module-storage_gun-async.html +3 -0
package/docs/api/module-storage_gun-auth-GunAuth.html +5 -0
package/docs/api/module-storage_gun-auth.GunAuth.html +3 -0
package/docs/api/module-storage_gun-auth.html +3 -0
package/docs/api/module-storage_gun-federation.html +3 -0
package/docs/api/module-storage_gun-references-GunReferenceHandler.html +5 -0
package/docs/api/module-storage_gun-references.GunReferenceHandler.html +3 -0
package/docs/api/module-storage_gun-references.html +3 -0
package/docs/api/module-storage_gun-schema-GunSchemaValidator.html +5 -0
package/docs/api/module-storage_gun-schema.GunSchemaValidator.html +3 -0
package/docs/api/module-storage_gun-schema.html +3 -0
package/docs/api/module-storage_gun-wrapper.html +11 -0
package/docs/api/module-storage_indexeddb-storage-IndexedDBStorage.html +5 -0
package/docs/api/module-storage_indexeddb-storage.IndexedDBStorage.html +3 -0
package/docs/api/module-storage_indexeddb-storage.html +3 -0
package/docs/api/module-storage_key-storage-simple.html +3 -0
package/docs/api/module-storage_key-storage.html +4 -0
package/docs/api/module-storage_memory-storage-MemoryStorage.html +5 -0
package/docs/api/module-storage_memory-storage.MemoryStorage.html +3 -0
package/docs/api/module-storage_memory-storage.html +3 -0
package/docs/api/module-storage_migration-MigrationTool.html +6 -0
package/docs/api/module-storage_migration.MigrationTool.html +3 -0
package/docs/api/module-storage_migration.html +3 -0
package/docs/api/module-storage_nostr-async.html +18 -0
package/docs/api/module-storage_nostr-client-LRUCache.html +3 -0
package/docs/api/module-storage_nostr-client-NostrClient.html +7 -0
package/docs/api/module-storage_nostr-client.NostrClient.html +15 -0
package/docs/api/module-storage_nostr-client.html +6 -0
package/docs/api/module-storage_nostr-wrapper.html +3 -0
package/docs/api/module-storage_outbox-queue-OutboxQueue.html +4 -0
package/docs/api/module-storage_outbox-queue.OutboxQueue.html +3 -0
package/docs/api/module-storage_outbox-queue.html +3 -0
package/docs/api/module-storage_persistent-storage-PersistentStorage.html +3 -0
package/docs/api/module-storage_persistent-storage.html +4 -0
package/docs/api/module-storage_sync-service-SyncService.html +5 -0
package/docs/api/module-storage_sync-service.SyncService.html +3 -0
package/docs/api/module-storage_sync-service.html +3 -0
package/docs/api/module-storage_unified-storage.html +3 -0
package/docs/api/module-subscriptions_manager.SubscriptionRegistry.html +3 -0
package/docs/api/module-subscriptions_manager.html +3 -0
package/docs/api/schema_validator.js.html +113 -0
package/docs/api/scripts/core.js +726 -0
package/docs/api/scripts/core.min.js +23 -0
package/docs/api/scripts/resize.js +90 -0
package/docs/api/scripts/search.js +265 -0
package/docs/api/scripts/search.min.js +6 -0
package/docs/api/scripts/third-party/Apache-License-2.0.txt +202 -0
package/docs/api/scripts/third-party/fuse.js +9 -0
package/docs/api/scripts/third-party/hljs-line-num-original.js +369 -0
package/docs/api/scripts/third-party/hljs-line-num.js +1 -0
package/docs/api/scripts/third-party/hljs-original.js +5171 -0
package/docs/api/scripts/third-party/hljs.js +1 -0
package/docs/api/scripts/third-party/popper.js +5 -0
package/docs/api/scripts/third-party/tippy.js +1 -0
package/docs/api/scripts/third-party/tocbot.js +672 -0
package/docs/api/scripts/third-party/tocbot.min.js +1 -0
package/docs/api/spatial_h3-operations.js.html +129 -0
package/docs/api/storage_backend-factory.js.html +133 -0
package/docs/api/storage_backend-interface.js.html +164 -0
package/docs/api/storage_backends_activitypub-backend.js.html +298 -0
package/docs/api/storage_backends_activitypub_server.js.html +678 -0
package/docs/api/storage_backends_gundb-backend.js.html +878 -0
package/docs/api/storage_backends_nostr-backend.js.html +254 -0
package/docs/api/storage_filesystem-storage-browser.js.html +83 -0
package/docs/api/storage_filesystem-storage.js.html +207 -0
package/docs/api/storage_global-tables.js.html +116 -0
package/docs/api/storage_gun-async.js.html +344 -0
package/docs/api/storage_gun-auth.js.html +376 -0
package/docs/api/storage_gun-federation.js.html +788 -0
package/docs/api/storage_gun-references.js.html +212 -0
package/docs/api/storage_gun-schema.js.html +309 -0
package/docs/api/storage_gun-wrapper.js.html +645 -0
package/docs/api/storage_indexeddb-storage.js.html +224 -0
package/docs/api/storage_key-storage-simple.js.html +102 -0
package/docs/api/storage_key-storage.js.html +171 -0
package/docs/api/storage_memory-storage.js.html +128 -0
package/docs/api/storage_migration.js.html +354 -0
package/docs/api/storage_nostr-async.js.html +1076 -0
package/docs/api/storage_nostr-client.js.html +1598 -0
package/docs/api/storage_nostr-wrapper.js.html +218 -0
package/docs/api/storage_outbox-queue.js.html +248 -0
package/docs/api/storage_persistent-storage.js.html +160 -0
package/docs/api/storage_sync-service.js.html +201 -0
package/docs/api/storage_unified-storage.js.html +157 -0
package/docs/api/styles/clean-jsdoc-theme-base.css +1159 -0
package/docs/api/styles/clean-jsdoc-theme-dark.css +412 -0
package/docs/api/styles/clean-jsdoc-theme-light.css +482 -0
package/docs/api/styles/clean-jsdoc-theme-scrollbar.css +30 -0
package/docs/api/styles/clean-jsdoc-theme-without-scrollbar.min.css +1 -0
package/docs/api/styles/clean-jsdoc-theme.min.css +1 -0
package/docs/api/subscriptions_manager.js.html +162 -0
package/jsdoc.json +26 -0
package/package.json +14 -3
package/src/ai/aggregation.js +13 -2
package/src/ai/breakdown.js +12 -2
package/src/ai/classifier.js +14 -3
package/src/ai/council.js +22 -7
package/src/ai/embeddings.js +37 -15
package/src/ai/federation-ai.js +13 -2
package/src/ai/h3-ai.js +14 -2
package/src/ai/index.js +16 -7
package/src/ai/json-ops.js +18 -5
package/src/ai/llm-service.js +62 -31
package/src/ai/nl-query.js +12 -2
package/src/ai/relationships.js +13 -2
package/src/ai/schema-extractor.js +24 -10
package/src/ai/spatial.js +13 -2
package/src/ai/tts.js +25 -8
package/src/content/social-protocols.js +34 -25
package/src/contracts/chain-manager.js +68 -40
package/src/contracts/deployer.js +70 -42
package/src/contracts/event-listener.js +61 -29
package/src/contracts/holon-contracts.js +46 -31
package/src/contracts/index.js +5 -6
package/src/contracts/networks.js +19 -14
package/src/contracts/operations.js +58 -41
package/src/contracts/queries.js +54 -20
package/src/core/holosphere.js +35 -6
package/src/crypto/nostr-utils.js +82 -76
package/src/crypto/secp256k1.js +7 -2
package/src/federation/handshake.js +7 -7
package/src/federation/hologram.js +9 -1
package/src/hierarchical/upcast.js +34 -20
package/src/index.js +655 -5
package/src/lib/ai-methods.js +352 -3
package/src/lib/contract-methods.js +152 -3
package/src/lib/errors.js +31 -1
package/src/lib/federation-methods.js +110 -3
package/src/lib/index.js +9 -5
package/src/schema/validator.js +22 -3
package/src/spatial/h3-operations.js +17 -1
package/src/storage/backend-factory.js +7 -2
package/src/storage/backend-interface.js +21 -2
package/src/storage/backends/activitypub/server.js +25 -3
package/src/storage/backends/activitypub-backend.js +25 -2
package/src/storage/backends/gundb-backend.js +29 -2
package/src/storage/backends/nostr-backend.js +116 -1
package/src/storage/filesystem-storage-browser.js +42 -2
package/src/storage/filesystem-storage.js +72 -5
package/src/storage/global-tables.js +7 -2
package/src/storage/gun-async.js +20 -11
package/src/storage/gun-auth.js +15 -4
package/src/storage/gun-federation.js +14 -5
package/src/storage/gun-references.js +16 -5
package/src/storage/gun-schema.js +25 -10
package/src/storage/gun-wrapper.js +99 -36
package/src/storage/indexeddb-storage.js +65 -4
package/src/storage/key-storage-simple.js +32 -9
package/src/storage/key-storage.js +45 -13
package/src/storage/memory-storage.js +65 -4
package/src/storage/migration.js +20 -7
package/src/storage/nostr-async.js +157 -67
package/src/storage/nostr-client.js +173 -49
package/src/storage/nostr-wrapper.js +6 -2
package/src/storage/outbox-queue.js +55 -18
package/src/storage/persistent-storage.js +56 -13
package/src/storage/sync-service.js +51 -17
package/src/storage/unified-storage.js +7 -2
package/src/subscriptions/manager.js +33 -16
package/dist/index-4XHHKe6S.js.map +0 -1
package/dist/index-Dz5kOZMI.cjs.map +0 -1
package/dist/indexeddb-storage-DD7EFBVc.cjs.map +0 -1
package/dist/indexeddb-storage-lExjjFlV.js.map +0 -1
package/dist/memory-storage-C68adso2.js.map +0 -1
package/dist/memory-storage-DD_6yyXT.cjs.map +0 -1
/package/{cleanup-test-data.js → scripts/cleanup-test-data.js} +0 -0
/package/{test-ai-real-api.js → scripts/test-ai-real-api.js} +0 -0

package/docs/api/core_holosphere.js.html ADDED Viewed

@@ -0,0 +1,757 @@
+<!DOCTYPE html><html lang="en" style="font-size:16px"><head><meta charset="utf-8"><meta name="viewport" content="width=device-width,initial-scale=1"><title>Source: core/holosphere.js</title><!--[if lt IE 9]>
+      <script src="//html5shiv.googlecode.com/svn/trunk/html5.js"></script>
+    <![endif]--><script src="scripts/third-party/hljs.js" defer="defer"></script><script src="scripts/third-party/hljs-line-num.js" defer="defer"></script><script src="scripts/third-party/popper.js" defer="defer"></script><script src="scripts/third-party/tippy.js" defer="defer"></script><script src="scripts/third-party/tocbot.min.js"></script><script>var baseURL="/",locationPathname="";baseURL=(locationPathname=document.location.pathname).substr(0,locationPathname.lastIndexOf("/")+1)</script><link rel="stylesheet" href="styles/clean-jsdoc-theme.min.css"><svg aria-hidden="true" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" style="display:none"><defs><symbol id="copy-icon" viewbox="0 0 488.3 488.3"><g><path d="M314.25,85.4h-227c-21.3,0-38.6,17.3-38.6,38.6v325.7c0,21.3,17.3,38.6,38.6,38.6h227c21.3,0,38.6-17.3,38.6-38.6V124    C352.75,102.7,335.45,85.4,314.25,85.4z M325.75,449.6c0,6.4-5.2,11.6-11.6,11.6h-227c-6.4,0-11.6-5.2-11.6-11.6V124    c0-6.4,5.2-11.6,11.6-11.6h227c6.4,0,11.6,5.2,11.6,11.6V449.6z"/><path d="M401.05,0h-227c-21.3,0-38.6,17.3-38.6,38.6c0,7.5,6,13.5,13.5,13.5s13.5-6,13.5-13.5c0-6.4,5.2-11.6,11.6-11.6h227    c6.4,0,11.6,5.2,11.6,11.6v325.7c0,6.4-5.2,11.6-11.6,11.6c-7.5,0-13.5,6-13.5,13.5s6,13.5,13.5,13.5c21.3,0,38.6-17.3,38.6-38.6    V38.6C439.65,17.3,422.35,0,401.05,0z"/></g></symbol><symbol id="search-icon" viewBox="0 0 512 512"><g><g><path d="M225.474,0C101.151,0,0,101.151,0,225.474c0,124.33,101.151,225.474,225.474,225.474    c124.33,0,225.474-101.144,225.474-225.474C450.948,101.151,349.804,0,225.474,0z M225.474,409.323    c-101.373,0-183.848-82.475-183.848-183.848S124.101,41.626,225.474,41.626s183.848,82.475,183.848,183.848    S326.847,409.323,225.474,409.323z"/></g></g><g><g><path d="M505.902,476.472L386.574,357.144c-8.131-8.131-21.299-8.131-29.43,0c-8.131,8.124-8.131,21.306,0,29.43l119.328,119.328    c4.065,4.065,9.387,6.098,14.715,6.098c5.321,0,10.649-2.033,14.715-6.098C514.033,497.778,514.033,484.596,505.902,476.472z"/></g></g></symbol><symbol id="font-size-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M11.246 15H4.754l-2 5H.6L7 4h2l6.4 16h-2.154l-2-5zm-.8-2L8 6.885 5.554 13h4.892zM21 12.535V12h2v8h-2v-.535a4 4 0 1 1 0-6.93zM19 18a2 2 0 1 0 0-4 2 2 0 0 0 0 4z"/></symbol><symbol id="add-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M11 11V5h2v6h6v2h-6v6h-2v-6H5v-2z"/></symbol><symbol id="minus-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M5 11h14v2H5z"/></symbol><symbol id="dark-theme-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M10 7a7 7 0 0 0 12 4.9v.1c0 5.523-4.477 10-10 10S2 17.523 2 12 6.477 2 12 2h.1A6.979 6.979 0 0 0 10 7zm-6 5a8 8 0 0 0 15.062 3.762A9 9 0 0 1 8.238 4.938 7.999 7.999 0 0 0 4 12z"/></symbol><symbol id="light-theme-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M12 18a6 6 0 1 1 0-12 6 6 0 0 1 0 12zm0-2a4 4 0 1 0 0-8 4 4 0 0 0 0 8zM11 1h2v3h-2V1zm0 19h2v3h-2v-3zM3.515 4.929l1.414-1.414L7.05 5.636 5.636 7.05 3.515 4.93zM16.95 18.364l1.414-1.414 2.121 2.121-1.414 1.414-2.121-2.121zm2.121-14.85l1.414 1.415-2.121 2.121-1.414-1.414 2.121-2.121zM5.636 16.95l1.414 1.414-2.121 2.121-1.414-1.414 2.121-2.121zM23 11v2h-3v-2h3zM4 11v2H1v-2h3z"/></symbol><symbol id="reset-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M18.537 19.567A9.961 9.961 0 0 1 12 22C6.477 22 2 17.523 2 12S6.477 2 12 2s10 4.477 10 10c0 2.136-.67 4.116-1.81 5.74L17 12h3a8 8 0 1 0-2.46 5.772l.997 1.795z"/></symbol><symbol id="down-icon" viewBox="0 0 16 16"><path fill-rule="evenodd" clip-rule="evenodd" d="M12.7803 6.21967C13.0732 6.51256 13.0732 6.98744 12.7803 7.28033L8.53033 11.5303C8.23744 11.8232 7.76256 11.8232 7.46967 11.5303L3.21967 7.28033C2.92678 6.98744 2.92678 6.51256 3.21967 6.21967C3.51256 5.92678 3.98744 5.92678 4.28033 6.21967L8 9.93934L11.7197 6.21967C12.0126 5.92678 12.4874 5.92678 12.7803 6.21967Z"></path></symbol><symbol id="codepen-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M16.5 13.202L13 15.535v3.596L19.197 15 16.5 13.202zM14.697 12L12 10.202 9.303 12 12 13.798 14.697 12zM20 10.869L18.303 12 20 13.131V10.87zM19.197 9L13 4.869v3.596l3.5 2.333L19.197 9zM7.5 10.798L11 8.465V4.869L4.803 9 7.5 10.798zM4.803 15L11 19.131v-3.596l-3.5-2.333L4.803 15zM4 13.131L5.697 12 4 10.869v2.262zM2 9a1 1 0 0 1 .445-.832l9-6a1 1 0 0 1 1.11 0l9 6A1 1 0 0 1 22 9v6a1 1 0 0 1-.445.832l-9 6a1 1 0 0 1-1.11 0l-9-6A1 1 0 0 1 2 15V9z"/></symbol><symbol id="close-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M12 10.586l4.95-4.95 1.414 1.414-4.95 4.95 4.95 4.95-1.414 1.414-4.95-4.95-4.95 4.95-1.414-1.414 4.95-4.95-4.95-4.95L7.05 5.636z"/></symbol><symbol id="menu-icon" viewBox="0 0 24 24"><path fill="none" d="M0 0h24v24H0z"/><path d="M3 4h18v2H3V4zm0 7h18v2H3v-2zm0 7h18v2H3v-2z"/></symbol></defs></svg></head><body data-theme="dark"><div class="sidebar-container"><div class="sidebar" id="sidebar"><div class="sidebar-items-container"><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-modules"><div>Modules</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="module-ai.html">ai</a></div><div class="sidebar-section-children"><a href="module-ai_aggregation.html">ai/aggregation</a></div><div class="sidebar-section-children"><a href="module-ai_breakdown.html">ai/breakdown</a></div><div class="sidebar-section-children"><a href="module-ai_classifier.html">ai/classifier</a></div><div class="sidebar-section-children"><a href="module-ai_council.html">ai/council</a></div><div class="sidebar-section-children"><a href="module-ai_embeddings.html">ai/embeddings</a></div><div class="sidebar-section-children"><a href="module-ai_federation-ai.html">ai/federation-ai</a></div><div class="sidebar-section-children"><a href="module-ai_h3-ai.html">ai/h3-ai</a></div><div class="sidebar-section-children"><a href="module-ai_json-ops.html">ai/json-ops</a></div><div class="sidebar-section-children"><a href="module-ai_llm-service.html">ai/llm-service</a></div><div class="sidebar-section-children"><a href="module-ai_nl-query.html">ai/nl-query</a></div><div class="sidebar-section-children"><a href="module-ai_relationships.html">ai/relationships</a></div><div class="sidebar-section-children"><a href="module-ai_schema-extractor.html">ai/schema-extractor</a></div><div class="sidebar-section-children"><a href="module-ai_spatial.html">ai/spatial</a></div><div class="sidebar-section-children"><a href="module-ai_tts.html">ai/tts</a></div><div class="sidebar-section-children"><a href="module-content_social-protocols.html">content/social-protocols</a></div><div class="sidebar-section-children"><a href="module-core_holosphere.html">core/holosphere</a></div><div class="sidebar-section-children"><a href="module-crypto_nostr-utils.html">crypto/nostr-utils</a></div><div class="sidebar-section-children"><a href="module-crypto_secp256k1.html">crypto/secp256k1</a></div><div class="sidebar-section-children"><a href="module-federation_hologram.html">federation/hologram</a></div><div class="sidebar-section-children"><a href="module-hierarchical_upcast.html">hierarchical/upcast</a></div><div class="sidebar-section-children"><a href="module-holosphere.html">holosphere</a></div><div class="sidebar-section-children"><a href="module-lib_ai-methods.html">lib/ai-methods</a></div><div class="sidebar-section-children"><a href="module-lib_contract-methods.html">lib/contract-methods</a></div><div class="sidebar-section-children"><a href="module-lib_errors.html">lib/errors</a></div><div class="sidebar-section-children"><a href="module-lib_federation-methods.html">lib/federation-methods</a></div><div class="sidebar-section-children"><a href="module-lib_index.html">lib/index</a></div><div class="sidebar-section-children"><a href="module-schema_validator.html">schema/validator</a></div><div class="sidebar-section-children"><a href="module-spatial_h3-operations.html">spatial/h3-operations</a></div><div class="sidebar-section-children"><a href="module-storage_backend-factory.html">storage/backend-factory</a></div><div class="sidebar-section-children"><a href="module-storage_backend-interface.html">storage/backend-interface</a></div><div class="sidebar-section-children"><a href="module-storage_backends_activitypub-backend.html">storage/backends/activitypub-backend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_activitypub_server.html">storage/backends/activitypub/server</a></div><div class="sidebar-section-children"><a href="module-storage_backends_gundb-backend.html">storage/backends/gundb-backend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_nostr-backend.html">storage/backends/nostr-backend</a></div><div class="sidebar-section-children"><a href="module-storage_filesystem-storage.html">storage/filesystem-storage</a></div><div class="sidebar-section-children"><a href="module-storage_filesystem-storage-browser.html">storage/filesystem-storage-browser</a></div><div class="sidebar-section-children"><a href="module-storage_global-tables.html">storage/global-tables</a></div><div class="sidebar-section-children"><a href="module-storage_gun-async.html">storage/gun-async</a></div><div class="sidebar-section-children"><a href="module-storage_gun-auth.html">storage/gun-auth</a></div><div class="sidebar-section-children"><a href="module-storage_gun-federation.html">storage/gun-federation</a></div><div class="sidebar-section-children"><a href="module-storage_gun-references.html">storage/gun-references</a></div><div class="sidebar-section-children"><a href="module-storage_gun-schema.html">storage/gun-schema</a></div><div class="sidebar-section-children"><a href="module-storage_gun-wrapper.html">storage/gun-wrapper</a></div><div class="sidebar-section-children"><a href="module-storage_indexeddb-storage.html">storage/indexeddb-storage</a></div><div class="sidebar-section-children"><a href="module-storage_key-storage.html">storage/key-storage</a></div><div class="sidebar-section-children"><a href="module-storage_key-storage-simple.html">storage/key-storage-simple</a></div><div class="sidebar-section-children"><a href="module-storage_memory-storage.html">storage/memory-storage</a></div><div class="sidebar-section-children"><a href="module-storage_migration.html">storage/migration</a></div><div class="sidebar-section-children"><a href="module-storage_nostr-async.html">storage/nostr-async</a></div><div class="sidebar-section-children"><a href="module-storage_nostr-client.html">storage/nostr-client</a></div><div class="sidebar-section-children"><a href="module-storage_nostr-wrapper.html">storage/nostr-wrapper</a></div><div class="sidebar-section-children"><a href="module-storage_outbox-queue.html">storage/outbox-queue</a></div><div class="sidebar-section-children"><a href="module-storage_persistent-storage.html">storage/persistent-storage</a></div><div class="sidebar-section-children"><a href="module-storage_sync-service.html">storage/sync-service</a></div><div class="sidebar-section-children"><a href="module-storage_unified-storage.html">storage/unified-storage</a></div><div class="sidebar-section-children"><a href="module-subscriptions_manager.html">subscriptions/manager</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-classes"><div>Classes</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="module-ai_aggregation.SmartAggregation.html">SmartAggregation</a></div><div class="sidebar-section-children"><a href="module-ai_aggregation-SmartAggregation.html">SmartAggregation</a></div><div class="sidebar-section-children"><a href="module-ai_breakdown.TaskBreakdown.html">TaskBreakdown</a></div><div class="sidebar-section-children"><a href="module-ai_breakdown-TaskBreakdown.html">TaskBreakdown</a></div><div class="sidebar-section-children"><a href="module-ai_classifier.Classifier.html">Classifier</a></div><div class="sidebar-section-children"><a href="module-ai_classifier-Classifier.html">Classifier</a></div><div class="sidebar-section-children"><a href="module-ai_council.Council.html">Council</a></div><div class="sidebar-section-children"><a href="module-ai_council-Council.html">Council</a></div><div class="sidebar-section-children"><a href="module-ai_embeddings.Embeddings.html">Embeddings</a></div><div class="sidebar-section-children"><a href="module-ai_embeddings-Embeddings.html">Embeddings</a></div><div class="sidebar-section-children"><a href="module-ai_federation-ai.FederationAdvisor.html">FederationAdvisor</a></div><div class="sidebar-section-children"><a href="module-ai_federation-ai-FederationAdvisor.html">FederationAdvisor</a></div><div class="sidebar-section-children"><a href="module-ai_h3-ai.H3AI.html">H3AI</a></div><div class="sidebar-section-children"><a href="module-ai_h3-ai-H3AI.html">H3AI</a></div><div class="sidebar-section-children"><a href="module-ai_json-ops.JSONOps.html">JSONOps</a></div><div class="sidebar-section-children"><a href="module-ai_json-ops-JSONOps.html">JSONOps</a></div><div class="sidebar-section-children"><a href="module-ai_llm-service.LLMService.html">LLMService</a></div><div class="sidebar-section-children"><a href="module-ai_llm-service-LLMService.html">LLMService</a></div><div class="sidebar-section-children"><a href="module-ai_nl-query.NLQuery.html">NLQuery</a></div><div class="sidebar-section-children"><a href="module-ai_nl-query-NLQuery.html">NLQuery</a></div><div class="sidebar-section-children"><a href="module-ai_relationships.RelationshipDiscovery.html">RelationshipDiscovery</a></div><div class="sidebar-section-children"><a href="module-ai_relationships-RelationshipDiscovery.html">RelationshipDiscovery</a></div><div class="sidebar-section-children"><a href="module-ai_schema-extractor.SchemaExtractor.html">SchemaExtractor</a></div><div class="sidebar-section-children"><a href="module-ai_schema-extractor-SchemaExtractor.html">SchemaExtractor</a></div><div class="sidebar-section-children"><a href="module-ai_spatial.SpatialAnalysis.html">SpatialAnalysis</a></div><div class="sidebar-section-children"><a href="module-ai_spatial-SpatialAnalysis.html">SpatialAnalysis</a></div><div class="sidebar-section-children"><a href="module-ai_tts.TTS.html">TTS</a></div><div class="sidebar-section-children"><a href="module-ai_tts-TTS.html">TTS</a></div><div class="sidebar-section-children"><a href="module-core_holosphere.HoloSphere.html">HoloSphere</a></div><div class="sidebar-section-children"><a href="module-core_holosphere-HoloSphere.html">HoloSphere</a></div><div class="sidebar-section-children"><a href="module-holosphere-HoloSphereBase.html">HoloSphereBase</a></div><div class="sidebar-section-children"><a href="module-holosphere-HoloSphereBase.html">HoloSphereBase</a></div><div class="sidebar-section-children"><a href="module-lib_errors.AuthorizationError.html">AuthorizationError</a></div><div class="sidebar-section-children"><a href="module-lib_errors.ValidationError.html">ValidationError</a></div><div class="sidebar-section-children"><a href="module-lib_errors-AuthorizationError.html">AuthorizationError</a></div><div class="sidebar-section-children"><a href="module-lib_errors-ValidationError.html">ValidationError</a></div><div class="sidebar-section-children"><a href="module-schema_validator.ValidationError.html">ValidationError</a></div><div class="sidebar-section-children"><a href="module-schema_validator-ValidationError.html">ValidationError</a></div><div class="sidebar-section-children"><a href="module-storage_backend-factory.BackendFactory.html">BackendFactory</a></div><div class="sidebar-section-children"><a href="module-storage_backend-interface.StorageBackend.html">StorageBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backend-interface-StorageBackend.html">StorageBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_activitypub-backend.ActivityPubBackend.html">ActivityPubBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_activitypub-backend-ActivityPubBackend.html">ActivityPubBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_activitypub_server.ActivityPubServer.html">ActivityPubServer</a></div><div class="sidebar-section-children"><a href="module-storage_backends_activitypub_server-ActivityPubServer.html">ActivityPubServer</a></div><div class="sidebar-section-children"><a href="module-storage_backends_gundb-backend.GunDBBackend.html">GunDBBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_gundb-backend-GunDBBackend.html">GunDBBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_nostr-backend.NostrBackend.html">NostrBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_nostr-backend-NostrBackend.html">NostrBackend</a></div><div class="sidebar-section-children"><a href="module-storage_filesystem-storage-browser.FileSystemStorage.html">FileSystemStorage</a></div><div class="sidebar-section-children"><a href="module-storage_filesystem-storage-browser-FileSystemStorage.html">FileSystemStorage</a></div><div class="sidebar-section-children"><a href="module-storage_filesystem-storage.FileSystemStorage.html">FileSystemStorage</a></div><div class="sidebar-section-children"><a href="module-storage_filesystem-storage-FileSystemStorage.html">FileSystemStorage</a></div><div class="sidebar-section-children"><a href="module-storage_gun-auth.GunAuth.html">GunAuth</a></div><div class="sidebar-section-children"><a href="module-storage_gun-auth-GunAuth.html">GunAuth</a></div><div class="sidebar-section-children"><a href="module-storage_gun-references.GunReferenceHandler.html">GunReferenceHandler</a></div><div class="sidebar-section-children"><a href="module-storage_gun-references-GunReferenceHandler.html">GunReferenceHandler</a></div><div class="sidebar-section-children"><a href="module-storage_gun-schema.GunSchemaValidator.html">GunSchemaValidator</a></div><div class="sidebar-section-children"><a href="module-storage_gun-schema-GunSchemaValidator.html">GunSchemaValidator</a></div><div class="sidebar-section-children"><a href="module-storage_indexeddb-storage.IndexedDBStorage.html">IndexedDBStorage</a></div><div class="sidebar-section-children"><a href="module-storage_indexeddb-storage-IndexedDBStorage.html">IndexedDBStorage</a></div><div class="sidebar-section-children"><a href="module-storage_memory-storage.MemoryStorage.html">MemoryStorage</a></div><div class="sidebar-section-children"><a href="module-storage_memory-storage-MemoryStorage.html">MemoryStorage</a></div><div class="sidebar-section-children"><a href="module-storage_migration.MigrationTool.html">MigrationTool</a></div><div class="sidebar-section-children"><a href="module-storage_migration-MigrationTool.html">MigrationTool</a></div><div class="sidebar-section-children"><a href="module-storage_nostr-client.NostrClient.html">NostrClient</a></div><div class="sidebar-section-children"><a href="module-storage_nostr-client-LRUCache.html">LRUCache</a></div><div class="sidebar-section-children"><a href="module-storage_nostr-client-NostrClient.html">NostrClient</a></div><div class="sidebar-section-children"><a href="module-storage_outbox-queue.OutboxQueue.html">OutboxQueue</a></div><div class="sidebar-section-children"><a href="module-storage_outbox-queue-OutboxQueue.html">OutboxQueue</a></div><div class="sidebar-section-children"><a href="module-storage_persistent-storage-PersistentStorage.html">PersistentStorage</a></div><div class="sidebar-section-children"><a href="module-storage_sync-service.SyncService.html">SyncService</a></div><div class="sidebar-section-children"><a href="module-storage_sync-service-SyncService.html">SyncService</a></div><div class="sidebar-section-children"><a href="module-subscriptions_manager.SubscriptionRegistry.html">SubscriptionRegistry</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-global"><div>Global</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="global.html#FederationRequestPayload">FederationRequestPayload</a></div><div class="sidebar-section-children"><a href="global.html#FederationResponsePayload">FederationResponsePayload</a></div><div class="sidebar-section-children"><a href="global.html#acceptFederationRequest">acceptFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#acceptFederationRequest">acceptFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#addFederatedPartner">addFederatedPartner</a></div><div class="sidebar-section-children"><a href="global.html#cleanupExpiredCapabilities">cleanupExpiredCapabilities</a></div><div class="sidebar-section-children"><a href="global.html#createFederationRequest">createFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#createFederationResponse">createFederationResponse</a></div><div class="sidebar-section-children"><a href="global.html#declineFederationRequest">declineFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#getCapabilityForAuthor">getCapabilityForAuthor</a></div><div class="sidebar-section-children"><a href="global.html#getFederatedAuthors">getFederatedAuthors</a></div><div class="sidebar-section-children"><a href="global.html#getFederatedAuthorsForScope">getFederatedAuthorsForScope</a></div><div class="sidebar-section-children"><a href="global.html#getFederatedPartner">getFederatedPartner</a></div><div class="sidebar-section-children"><a href="global.html#getFederationRegistry">getFederationRegistry</a></div><div class="sidebar-section-children"><a href="global.html#getPendingFederationRequests">getPendingFederationRequests</a></div><div class="sidebar-section-children"><a href="global.html#initiateFederationHandshake">initiateFederationHandshake</a></div><div class="sidebar-section-children"><a href="global.html#isFederationRequest">isFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#isFederationResponse">isFederationResponse</a></div><div class="sidebar-section-children"><a href="global.html#rejectFederationRequest">rejectFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#removeFederatedPartner">removeFederatedPartner</a></div><div class="sidebar-section-children"><a href="global.html#revokeOutboundCapability">revokeOutboundCapability</a></div><div class="sidebar-section-children"><a href="global.html#saveFederationRegistry">saveFederationRegistry</a></div><div class="sidebar-section-children"><a href="global.html#sendFederationRequest">sendFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#sendFederationRequest">sendFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#sendFederationResponse">sendFederationResponse</a></div><div class="sidebar-section-children"><a href="global.html#storeInboundCapability">storeInboundCapability</a></div><div class="sidebar-section-children"><a href="global.html#storeOutboundCapability">storeOutboundCapability</a></div><div class="sidebar-section-children"><a href="global.html#subscribeFederationAcceptances">subscribeFederationAcceptances</a></div><div class="sidebar-section-children"><a href="global.html#subscribeFederationDeclines">subscribeFederationDeclines</a></div><div class="sidebar-section-children"><a href="global.html#subscribeFederationRequests">subscribeFederationRequests</a></div><div class="sidebar-section-children"><a href="global.html#subscribeToFederationDMs">subscribeToFederationDMs</a></div><div class="sidebar-section-children"><a href="global.html#updateDiscoverySettings">updateDiscoverySettings</a></div></div></div></div></div><div class="navbar-container" id="VuAckcnZhf"><nav class="navbar"><div class="navbar-left-items"></div><div class="navbar-right-items"><div class="navbar-right-item"><button class="icon-button search-button" aria-label="open-search"><svg><use xlink:href="#search-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button theme-toggle" aria-label="toggle-theme"><svg><use class="theme-svg-use" xlink:href="#light-theme-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button font-size" aria-label="change-font-size"><svg><use xlink:href="#font-size-icon"></use></svg></button></div></div><nav></nav></nav></div><div class="toc-container"><div class="toc-content"><span class="bold">On this page</span><div id="eed4d2a0bfd64539bb9df78095dec881"></div></div></div><div class="body-wrapper"><div class="main-content"><div class="main-wrapper"><section id="source-page" class="source-page"><header><h1 id="title" class="has-anchor">core_holosphere.js</h1></header><article><pre class="prettyprint source lang-js"><code>/**
+ * @fileoverview Core HoloSphere class providing the foundational infrastructure
+ * for holonic geospatial communication.
+ *
+ * This module implements the core HoloSphere class that supports multiple storage
+ * backends (Nostr, GunDB, ActivityPub) and provides essential operations for
+ * distributed P2P communication and data management.
+ *
+ * @module core/holosphere
+ */
+import { createClient } from '../storage/nostr-client.js';
+import { BackendFactory } from '../storage/backend-factory.js';
+import * as gunWrapper from '../storage/gun-wrapper.js';
+import * as gunFederation from '../storage/gun-federation.js';
+import { GunDBBackend } from '../storage/backends/gundb-backend.js';
+import pkg from '../../package.json' with { type: 'json' };
+/** @type {Function|null} Gun constructor, loaded dynamically */
+let Gun = null;
+/** @type {Promise&lt;Function>|null} Promise for Gun loading */
+let gunLoadPromise = null;
+/**
+ * Dynamically loads the Gun module.
+ * Uses lazy loading to reduce initial bundle size and improve startup time.
+ *
+ * @private
+ * @returns {Promise&lt;Function>} Gun constructor
+ */
+async function loadGun() {
+  if (Gun) return Gun;
+  if (gunLoadPromise) return gunLoadPromise;
+  gunLoadPromise = import('gun').then(module => {
+    Gun = module.default || module;
+    return Gun;
+  });
+  return gunLoadPromise;
+}
+/**
+ * Get environment variable (works in Node.js, returns undefined in browser)
+ * @param {string} name - Environment variable name
+ * @returns {string|undefined}
+ */
+function getEnv(name) {
+  if (typeof process !== 'undefined' &amp;&amp; process.env) {
+    return process.env[name];
+  }
+  return undefined;
+}
+/**
+ * Parse relay URLs from environment variable or use defaults
+ * @returns {string[]}
+ */
+function getDefaultRelays() {
+  const envRelays = getEnv('HOLOSPHERE_RELAYS');
+  if (envRelays) {
+    return envRelays.split(',').map(r => r.trim()).filter(r => r);
+  }
+  return ['wss://relay.holons.io'];
+}
+/**
+ * HoloSphere - Holonic Geospatial Communication Infrastructure.
+ *
+ * The core class that combines H3 hexagonal indexing with distributed P2P storage.
+ * Supports multiple storage backends including Nostr, GunDB, and ActivityPub.
+ *
+ * @class HoloSphere
+ * @example
+ * // Create with Nostr backend (default)
+ * const hs = new HoloSphere({ appName: 'myapp', relays: ['wss://relay.example.com'] });
+ *
+ * @example
+ * // Create with GunDB backend
+ * const hs = new HoloSphere({ appName: 'myapp', backend: 'gundb' });
+ * await hs.ready(); // Wait for async initialization
+ */
+export class HoloSphere {
+  /**
+   * @param {Object} config - Configuration options
+   * @param {string} config.appName - Application namespace (default: 'holosphere')
+   * @param {string} config.backend - Storage backend: 'nostr' | 'gundb' | 'activitypub' (default: 'nostr')
+   * @param {string[]} config.relays - Nostr relay URLs (default from HOLOSPHERE_RELAYS env or ['wss://relay.holons.io', 'wss://relay.nostr.band'])
+   * @param {string} config.privateKey - Private key for signing (hex format, optional)
+   * @param {string} config.logLevel - Log verbosity: ERROR|WARN|INFO|DEBUG (default: 'INFO')
+   * @param {boolean} config.hybridMode - Enable hybrid mode (local + relay queries) (default: true)
+   * @param {Object} config.gundb - GunDB-specific configuration
+   * @param {Object} config.activitypub - ActivityPub-specific configuration
+   */
+  constructor(config = {}) {
+    // Allow string as shorthand for appName (backward compatibility)
+    if (typeof config === 'string') {
+      config = { appName: config };
+    }
+    // Validate config
+    if (config &amp;&amp; typeof config !== 'object') {
+      throw new TypeError('Config must be an object');
+    }
+    // Validate individual config properties
+    if (config.appName !== undefined &amp;&amp; typeof config.appName !== 'string') {
+      throw new TypeError('config.appName must be a string');
+    }
+    if (config.relays !== undefined &amp;&amp; !Array.isArray(config.relays)) {
+      throw new TypeError('config.relays must be an array');
+    }
+    if (config.logLevel !== undefined &amp;&amp; !['ERROR', 'WARN', 'INFO', 'DEBUG'].includes(config.logLevel)) {
+      throw new TypeError('config.logLevel must be one of: ERROR, WARN, INFO, DEBUG');
+    }
+    if (config.backend !== undefined &amp;&amp; !BackendFactory.isAvailable(config.backend)) {
+      throw new TypeError(`config.backend must be one of: ${BackendFactory.getAvailableBackends().join(', ')}`);
+    }
+    // Set defaults (with environment variable fallbacks)
+    this.config = {
+      appName: config.appName || getEnv('HOLOSPHERE_APP_NAME') || 'holosphere',
+      backend: config.backend || 'nostr',
+      relays: config.relays || getDefaultRelays(),
+      privateKey: config.privateKey || getEnv('HOLOSPHERE_PRIVATE_KEY'),
+      logLevel: config.logLevel || getEnv('HOLOSPHERE_LOG_LEVEL') || 'INFO',
+      hybridMode: config.hybridMode !== false, // Enable by default
+    };
+    // Store raw config for backend initialization
+    this._rawConfig = config;
+    // Initialize logging
+    this.logLevels = { ERROR: 0, WARN: 1, INFO: 2, DEBUG: 3 };
+    this.currentLogLevel = this.logLevels[this.config.logLevel] || 1;
+    // Backend instance (set during initialization)
+    this._backend = null;
+    // For backward compatibility with Nostr, initialize synchronously
+    // GunDB and other backends use async initialization via _backendReady
+    if (this.config.backend === 'nostr') {
+      this._initNostrSync(config);
+    } else if (this.config.backend === 'gundb') {
+      // GunDB uses async init due to dynamic import
+      this._backendReady = this._initGunDBAsync(config);
+    } else {
+      // Async initialization for other backends
+      this._backendReady = this._initBackendAsync(config);
+    }
+    // Metrics tracking
+    this._metrics = {
+      writes: 0,
+      reads: 0,
+      subscriptions: 0,
+    };
+  }
+  /**
+   * Initialize Nostr backend synchronously (for backward compatibility)
+   * @private
+   */
+  _initNostrSync(config) {
+    try {
+      this.client = createClient({
+        relays: this.config.relays,
+        privateKey: this.config.privateKey,
+        enableReconnect: config.enableReconnect !== false,
+        enablePing: config.enablePing !== false,
+        appName: this.config.appName,
+        radisk: config.radisk !== false,
+        persistence: config.persistence !== false,
+        dataDir: config.dataDir,
+      });
+      // Log startup information
+      this._logStartup({
+        version: pkg.version,
+        appName: this.config.appName,
+        backend: 'nostr',
+        relays: this.config.relays,
+        publicKey: this.client.publicKey,
+        logLevel: this.config.logLevel,
+        persistence: config.persistence !== false,
+        reconnect: config.enableReconnect !== false,
+        dataDir: config.dataDir,
+      });
+      // Backend ready immediately for Nostr
+      this._backendReady = Promise.resolve();
+    } catch (error) {
+      this._log('ERROR', 'Nostr client initialization failed', { error: error.message });
+      throw new Error(`Nostr client initialization failed: ${error.message}`);
+    }
+  }
+  /**
+   * Initialize GunDB backend asynchronously (for browser compatibility with dynamic import)
+   * @private
+   */
+  async _initGunDBAsync(config) {
+    try {
+      const gundbConfig = config.gundb || {};
+      // Create the full-featured GunDB backend
+      this._backend = new GunDBBackend({
+        appName: this.config.appName,
+        peers: gundbConfig.peers || [],
+        radisk: gundbConfig.radisk !== false,
+        localStorage: gundbConfig.localStorage !== false,
+        dataDir: config.dataDir,
+        privateKey: this.config.privateKey,
+        strict: gundbConfig.strict || false,
+        schemaCacheMaxAge: gundbConfig.schemaCacheMaxAge || 3600000,
+      });
+      // Initialize the backend
+      await this._backend.init();
+      // Set public key from backend
+      this.publicKey = this._backend.publicKey;
+      // Store Gun instance for direct access
+      this._gun = this._backend.gun;
+      // Create a client-like interface for compatibility
+      this.client = {
+        publicKey: this.publicKey,
+        gun: this._gun,
+        write: (path, data) => this._backend.write(path, data),
+        read: (path, options) => this._backend.read(path, options),
+        readAll: (path, options) => this._backend.readAll(path, options),
+        update: (path, updates) => this._backend.update(path, updates),
+        delete: (path) => this._backend.delete(path),
+        subscribe: (path, callback, options) => this._backend.subscribe(path, callback, options),
+        buildPath: gunWrapper.buildPath,
+      };
+      // Store Gun wrapper functions for direct access
+      this._gunWrapper = gunWrapper;
+      // Log startup information
+      this._logStartup({
+        version: pkg.version,
+        appName: this.config.appName,
+        backend: 'gundb',
+        peers: gundbConfig.peers || [],
+        publicKey: this.publicKey,
+        logLevel: this.config.logLevel,
+        persistence: gundbConfig.radisk !== false,
+        dataDir: config.dataDir,
+      });
+    } catch (error) {
+      this._log('ERROR', 'GunDB client initialization failed', { error: error.message });
+      throw new Error(`GunDB client initialization failed: ${error.message}`);
+    }
+  }
+  /**
+   * Initialize non-Nostr backends asynchronously
+   * @private
+   */
+  async _initBackendAsync(config) {
+    const backendType = this.config.backend;
+    const backendSpecificConfig = config[backendType] || {};
+    try {
+      // Merge common config with backend-specific config
+      const backendConfig = {
+        appName: this.config.appName,
+        privateKey: this.config.privateKey,
+        persistence: config.persistence !== false,
+        dataDir: config.dataDir,
+        ...backendSpecificConfig,
+      };
+      this._backend = await BackendFactory.create(backendType, backendConfig);
+      // For compatibility, also set client if backend has one
+      this.client = this._backend.client || this._backend;
+      // Log startup information
+      this._logStartup({
+        version: pkg.version,
+        appName: this.config.appName,
+        backend: backendType,
+        publicKey: this._backend.publicKey,
+        logLevel: this.config.logLevel,
+        persistence: config.persistence !== false,
+        ...this._backend.getStatus(),
+      });
+    } catch (error) {
+      this._log('ERROR', `${backendType} backend initialization failed`, { error: error.message });
+      throw new Error(`${backendType} backend initialization failed: ${error.message}`);
+    }
+  }
+  /**
+   * Ensure backend is ready before operations
+   * @returns {Promise&lt;void>}
+   */
+  async ready() {
+    if (this._backendReady) {
+      await this._backendReady;
+    }
+  }
+  /**
+   * Get the storage backend instance
+   * @returns {StorageBackend|null}
+   */
+  get backend() {
+    return this._backend;
+  }
+  /**
+   * Internal structured logging
+   * @private
+   */
+  _log(level, message, data = {}) {
+    if (this.logLevels[level] &lt;= this.currentLogLevel) {
+      const logEntry = {
+        timestamp: Date.now(),
+        level,
+        message,
+        app: this.config.appName,
+        ...data,
+      };
+      console.log(JSON.stringify(logEntry));
+    }
+  }
+  /**
+   * Log startup information in a user-friendly format
+   * @private
+   */
+  _logStartup(info) {
+    // Only log if INFO or DEBUG level
+    if (this.currentLogLevel >= this.logLevels.INFO) {
+      console.log('\n' + '='.repeat(60));
+      console.log('  HoloSphere - Holonic Geospatial Infrastructure');
+      console.log('='.repeat(60));
+      console.log(`  Version:        ${info.version}`);
+      console.log(`  App Name:       ${info.appName}`);
+      console.log(`  Backend:        ${info.backend || 'nostr'}`);
+      console.log(`  Public Key:     ${info.publicKey ? info.publicKey.substring(0, 16) + '...' : 'N/A'}`);
+      console.log(`  Log Level:      ${info.logLevel}`);
+      console.log(`  Persistence:    ${info.persistence ? 'Enabled' : 'Disabled'}${info.dataDir ? ` (${info.dataDir})` : ''}`);
+      // Backend-specific info
+      if (info.backend === 'nostr' || !info.backend) {
+        console.log(`  Auto-reconnect: ${info.reconnect ? 'Enabled' : 'Disabled'}`);
+        console.log('\n  Connected Relays:');
+        if (!info.relays || info.relays.length === 0) {
+          console.log('    (none - running in local mode)');
+        } else {
+          info.relays.forEach((relay, idx) => {
+            console.log(`    ${idx + 1}. ${relay}`);
+          });
+        }
+      } else if (info.backend === 'gundb') {
+        console.log('\n  Gun Peers:');
+        if (!info.peers || info.peers.length === 0) {
+          console.log('    (none - running in local mode)');
+        } else {
+          info.peers.forEach((peer, idx) => {
+            console.log(`    ${idx + 1}. ${peer}`);
+          });
+        }
+      } else if (info.backend === 'activitypub') {
+        console.log(`  Server URL:     ${info.serverUrl || 'N/A'}`);
+        console.log(`  Actor ID:       ${info.actorId || 'N/A'}`);
+      }
+      console.log('='.repeat(60) + '\n');
+    }
+  }
+  /**
+   * Get metrics
+   * @returns {Object} Operation counts
+   */
+  metrics() {
+    return { ...this._metrics };
+  }
+  // ============================================================================
+  // GUNDB-SPECIFIC METHODS
+  // These methods are only available when using the 'gundb' backend
+  // ============================================================================
+  /**
+   * Check if using GunDB backend
+   * @private
+   */
+  _requireGunDB() {
+    if (this.config.backend !== 'gundb') {
+      throw new Error('This method requires the GunDB backend');
+    }
+    if (!this._backend) {
+      throw new Error('Backend not initialized. Call ready() first.');
+    }
+  }
+  // ============================================================================
+  // GLOBAL TABLE OPERATIONS
+  // ============================================================================
+  /**
+   * Write data to a global table
+   * @param {string} tableName - Global table name (e.g., 'federation', 'schemas')
+   * @param {Object} data - Data to write (must have 'id' field)
+   * @returns {Promise&lt;boolean>} Success indicator
+   */
+  async putGlobal(tableName, data) {
+    await this.ready();
+    this._requireGunDB();
+    return this._backend.writeGlobal(tableName, data);
+  }
+  /**
+   * Read data from a global table
+   * @param {string} tableName - Global table name
+   * @param {string} key - Data key
+   * @returns {Promise&lt;Object|null>} Data or null if not found
+   */
+  async getGlobal(tableName, key) {
+    await this.ready();
+    this._requireGunDB();
+    return this._backend.readGlobal(tableName, key);
+  }
+  /**
+   * Read all data from a global table
+   * @param {string} tableName - Global table name
+   * @returns {Promise&lt;Object[]>} Array of data objects
+   */
+  async getAllGlobal(tableName) {
+    await this.ready();
+    this._requireGunDB();
+    return this._backend.readAllGlobal(tableName);
+  }
+  /**
+   * Delete data from a global table
+   * @param {string} tableName - Global table name
+   * @param {string} key - Data key
+   * @returns {Promise&lt;boolean>} Success indicator
+   */
+  async deleteGlobal(tableName, key) {
+    await this.ready();
+    this._requireGunDB();
+    return this._backend.deleteGlobal(tableName, key);
+  }
+  // ============================================================================
+  // REFERENCE OPERATIONS
+  // ============================================================================
+  /**
+   * Create a reference to data
+   * @param {string} holon - Holon ID
+   * @param {string} lens - Lens name
+   * @param {Object} data - Data object (must have 'id' field)
+   * @returns {Object} Reference object with id and soul
+   */
+  createReference(holon, lens, data) {
+    this._requireGunDB();
+    return this._backend.createReference(holon, lens, data);
+  }
+  /**
+   * Check if data is a reference
+   * @param {Object} data - Data to check
+   * @returns {boolean} True if data is a reference
+   */
+  isReference(data) {
+    this._requireGunDB();
+    return this._backend.isReference(data);
+  }
+  /**
+   * Resolve a reference to get actual data
+   * @param {Object} reference - Reference object
+   * @param {Object} options - Resolution options
+   * @returns {Promise&lt;Object|null>} Resolved data or null
+   */
+  async resolveReference(reference, options = {}) {
+    await this.ready();
+    this._requireGunDB();
+    return this._backend.resolveReference(reference, options);
+  }
+  // ============================================================================
+  // AUTHENTICATION OPERATIONS
+  // ============================================================================
+  /**
+   * Authenticate for a holon
+   * @param {string} holonId - Holon ID
+   * @param {string} password - Password
+   * @returns {Promise&lt;Object>} Authenticated user object
+   */
+  async authenticate(holonId, password) {
+    await this.ready();
+    this._requireGunDB();
+    return this._backend.authenticate(holonId, password);
+  }
+  /**
+   * Create a new user for a holon
+   * @param {string} holonId - Holon ID
+   * @param {string} password - Password
+   * @returns {Promise&lt;Object>} Created user object
+   */
+  async createUser(holonId, password) {
+    await this.ready();
+    this._requireGunDB();
+    return this._backend.createUser(holonId, password);
+  }
+  /**
+   * Logout current user
+   */
+  logout() {
+    this._requireGunDB();
+    this._backend.logout();
+  }
+  /**
+   * Check if authenticated
+   * @returns {boolean} True if authenticated
+   */
+  isAuthenticated() {
+    this._requireGunDB();
+    return this._backend.isAuthenticated();
+  }
+  /**
+   * Write to private storage (requires authentication)
+   * @param {string} lens - Lens name
+   * @param {string} key - Data key
+   * @param {Object} data - Data to write
+   * @returns {Promise&lt;boolean>} Success indicator
+   */
+  async writePrivate(lens, key, data) {
+    await this.ready();
+    this._requireGunDB();
+    return this._backend.writePrivate(lens, key, data);
+  }
+  /**
+   * Read from private storage (requires authentication)
+   * @param {string} lens - Lens name
+   * @param {string} key - Data key
+   * @returns {Promise&lt;Object|null>} Data or null
+   */
+  async readPrivate(lens, key) {
+    await this.ready();
+    this._requireGunDB();
+    return this._backend.readPrivate(lens, key);
+  }
+  // ============================================================================
+  // SCHEMA OPERATIONS
+  // ============================================================================
+  /**
+   * Set a schema for a lens
+   * @param {string} lens - Lens name
+   * @param {Object} schema - JSON Schema definition
+   * @returns {Promise&lt;boolean>} Success indicator
+   */
+  async setSchema(lens, schema) {
+    await this.ready();
+    this._requireGunDB();
+    return this._backend.setSchema(lens, schema);
+  }
+  /**
+   * Get a schema for a lens
+   * @param {string} lens - Lens name
+   * @returns {Promise&lt;Object|null>} Schema or null
+   */
+  async getSchema(lens) {
+    await this.ready();
+    this._requireGunDB();
+    return this._backend.getSchema(lens);
+  }
+  /**
+   * Validate data against a lens schema
+   * @param {string} lens - Lens name
+   * @param {Object} data - Data to validate
+   * @returns {Promise&lt;Object>} Validation result { valid: boolean, errors: Array }
+   */
+  async validateData(lens, data) {
+    await this.ready();
+    this._requireGunDB();
+    return this._backend.validateData(lens, data);
+  }
+  // ============================================================================
+  // FEDERATION OPERATIONS
+  // ============================================================================
+  /**
+   * Create a federation relationship between two spaces
+   * @param {string} spaceId1 - First space ID
+   * @param {string} spaceId2 - Second space ID
+   * @param {boolean} bidirectional - Whether to set up bidirectional notifications (default: true)
+   * @returns {Promise&lt;boolean>} True if federation was created
+   */
+  async federate(spaceId1, spaceId2, bidirectional = true) {
+    await this.ready();
+    this._requireGunDB();
+    return gunFederation.federate(this._backend, spaceId1, spaceId2, bidirectional);
+  }
+  /**
+   * Remove a federation relationship
+   * @param {string} spaceId1 - First space ID
+   * @param {string} spaceId2 - Second space ID
+   * @returns {Promise&lt;boolean>} True if federation was removed
+   */
+  async unfederate(spaceId1, spaceId2) {
+    await this.ready();
+    this._requireGunDB();
+    return gunFederation.unfederate(this._backend, spaceId1, spaceId2);
+  }
+  /**
+   * Get federation info for a space
+   * @param {string} spaceId - Space ID
+   * @returns {Promise&lt;Object|null>} Federation info or null
+   */
+  async getFederation(spaceId) {
+    await this.ready();
+    this._requireGunDB();
+    return gunFederation.getFederation(this._backend, spaceId);
+  }
+  /**
+   * Reset all federation relationships for a space
+   * @param {string} spaceId - Space ID
+   * @param {Object} options - Reset options
+   * @returns {Promise&lt;Object>} Result object
+   */
+  async resetFederation(spaceId, options = {}) {
+    await this.ready();
+    this._requireGunDB();
+    return gunFederation.resetFederation(this._backend, spaceId, options);
+  }
+  /**
+   * Propagate data to federated spaces
+   * @param {string} holon - Holon identifier
+   * @param {string} lens - Lens identifier
+   * @param {Object} data - Data to propagate
+   * @param {Object} options - Propagation options
+   * @returns {Promise&lt;Object>} Result with success count and errors
+   */
+  async propagate(holon, lens, data, options = {}) {
+    await this.ready();
+    this._requireGunDB();
+    return gunFederation.propagate(this._backend, holon, lens, data, options);
+  }
+  /**
+   * Get combined data from local and federated sources
+   * @param {string} holon - Local holon name
+   * @param {string} lens - Lens to query
+   * @param {Object} options - Options for data retrieval and aggregation
+   * @returns {Promise&lt;Array>} Combined array of local and federated data
+   */
+  async getFederated(holon, lens, options = {}) {
+    await this.ready();
+    this._requireGunDB();
+    return gunFederation.getFederated(this._backend, holon, lens, options);
+  }
+  /**
+   * Subscribe to federation notifications for a space
+   * @param {string} spaceId - Space ID to subscribe to
+   * @param {Function} callback - Callback to execute on notifications
+   * @param {Object} options - Subscription options
+   * @returns {Promise&lt;Object>} Subscription object with unsubscribe() method
+   */
+  async subscribeFederation(spaceId, callback, options = {}) {
+    await this.ready();
+    this._requireGunDB();
+    return gunFederation.subscribeFederation(this._backend, spaceId, callback, options);
+  }
+  /**
+   * Track a federated message across different chats
+   * @param {string} originalChatId - Original chat ID
+   * @param {string} messageId - Original message ID
+   * @param {string} federatedChatId - Federated chat ID
+   * @param {string} federatedMessageId - Federated message ID
+   * @param {string} type - Message type
+   * @returns {Promise&lt;void>}
+   */
+  async federateMessage(originalChatId, messageId, federatedChatId, federatedMessageId, type = 'generic') {
+    await this.ready();
+    this._requireGunDB();
+    return gunFederation.federateMessage(this._backend, originalChatId, messageId, federatedChatId, federatedMessageId, type);
+  }
+  /**
+   * Get all federated messages for a given original message
+   * @param {string} originalChatId - Original chat ID
+   * @param {string} messageId - Original message ID
+   * @returns {Promise&lt;Object|null>} Tracking information for the message
+   */
+  async getFederatedMessages(originalChatId, messageId) {
+    await this.ready();
+    this._requireGunDB();
+    return gunFederation.getFederatedMessages(this._backend, originalChatId, messageId);
+  }
+  /**
+   * Update a federated message across all federated chats
+   * @param {string} originalChatId - Original chat ID
+   * @param {string} messageId - Original message ID
+   * @param {Function} updateCallback - Function to update the message in each chat
+   * @returns {Promise&lt;void>}
+   */
+  async updateFederatedMessages(originalChatId, messageId, updateCallback) {
+    await this.ready();
+    this._requireGunDB();
+    return gunFederation.updateFederatedMessages(this._backend, originalChatId, messageId, updateCallback);
+  }
+  // ============================================================================
+  // LIFECYCLE
+  // ============================================================================
+  /**
+   * Closes the backend and cleans up resources.
+   * Should be called when done using the HoloSphere instance.
+   *
+   * @returns {void}
+   */
+  close() {
+    if (this._backend) {
+      this._backend.close();
+    }
+    if (this.client &amp;&amp; typeof this.client.close === 'function') {
+      this.client.close();
+    }
+  }
+}
+</code></pre></article></section></div></div></div><div class="search-container" id="PkfLWpAbet" style="display:none"><div class="wrapper" id="iCxFxjkHbP"><button class="icon-button search-close-button" id="VjLlGakifb" aria-label="close search"><svg><use xlink:href="#close-icon"></use></svg></button><div class="search-box-c"><svg><use xlink:href="#search-icon"></use></svg> <input type="text" id="vpcKVYIppa" class="search-input" placeholder="Search..." autofocus></div><div class="search-result-c" id="fWwVHRuDuN"><span class="search-result-c-text">Type anything to view search result</span></div></div></div><div class="mobile-menu-icon-container"><button class="icon-button" id="mobile-menu" data-isopen="false" aria-label="menu"><svg><use xlink:href="#menu-icon"></use></svg></button></div><div id="mobile-sidebar" class="mobile-sidebar-container"><div class="mobile-sidebar-wrapper"><div class="mobile-nav-links"></div><div class="mobile-sidebar-items-c"><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-modules"><div>Modules</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="module-ai.html">ai</a></div><div class="sidebar-section-children"><a href="module-ai_aggregation.html">ai/aggregation</a></div><div class="sidebar-section-children"><a href="module-ai_breakdown.html">ai/breakdown</a></div><div class="sidebar-section-children"><a href="module-ai_classifier.html">ai/classifier</a></div><div class="sidebar-section-children"><a href="module-ai_council.html">ai/council</a></div><div class="sidebar-section-children"><a href="module-ai_embeddings.html">ai/embeddings</a></div><div class="sidebar-section-children"><a href="module-ai_federation-ai.html">ai/federation-ai</a></div><div class="sidebar-section-children"><a href="module-ai_h3-ai.html">ai/h3-ai</a></div><div class="sidebar-section-children"><a href="module-ai_json-ops.html">ai/json-ops</a></div><div class="sidebar-section-children"><a href="module-ai_llm-service.html">ai/llm-service</a></div><div class="sidebar-section-children"><a href="module-ai_nl-query.html">ai/nl-query</a></div><div class="sidebar-section-children"><a href="module-ai_relationships.html">ai/relationships</a></div><div class="sidebar-section-children"><a href="module-ai_schema-extractor.html">ai/schema-extractor</a></div><div class="sidebar-section-children"><a href="module-ai_spatial.html">ai/spatial</a></div><div class="sidebar-section-children"><a href="module-ai_tts.html">ai/tts</a></div><div class="sidebar-section-children"><a href="module-content_social-protocols.html">content/social-protocols</a></div><div class="sidebar-section-children"><a href="module-core_holosphere.html">core/holosphere</a></div><div class="sidebar-section-children"><a href="module-crypto_nostr-utils.html">crypto/nostr-utils</a></div><div class="sidebar-section-children"><a href="module-crypto_secp256k1.html">crypto/secp256k1</a></div><div class="sidebar-section-children"><a href="module-federation_hologram.html">federation/hologram</a></div><div class="sidebar-section-children"><a href="module-hierarchical_upcast.html">hierarchical/upcast</a></div><div class="sidebar-section-children"><a href="module-holosphere.html">holosphere</a></div><div class="sidebar-section-children"><a href="module-lib_ai-methods.html">lib/ai-methods</a></div><div class="sidebar-section-children"><a href="module-lib_contract-methods.html">lib/contract-methods</a></div><div class="sidebar-section-children"><a href="module-lib_errors.html">lib/errors</a></div><div class="sidebar-section-children"><a href="module-lib_federation-methods.html">lib/federation-methods</a></div><div class="sidebar-section-children"><a href="module-lib_index.html">lib/index</a></div><div class="sidebar-section-children"><a href="module-schema_validator.html">schema/validator</a></div><div class="sidebar-section-children"><a href="module-spatial_h3-operations.html">spatial/h3-operations</a></div><div class="sidebar-section-children"><a href="module-storage_backend-factory.html">storage/backend-factory</a></div><div class="sidebar-section-children"><a href="module-storage_backend-interface.html">storage/backend-interface</a></div><div class="sidebar-section-children"><a href="module-storage_backends_activitypub-backend.html">storage/backends/activitypub-backend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_activitypub_server.html">storage/backends/activitypub/server</a></div><div class="sidebar-section-children"><a href="module-storage_backends_gundb-backend.html">storage/backends/gundb-backend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_nostr-backend.html">storage/backends/nostr-backend</a></div><div class="sidebar-section-children"><a href="module-storage_filesystem-storage.html">storage/filesystem-storage</a></div><div class="sidebar-section-children"><a href="module-storage_filesystem-storage-browser.html">storage/filesystem-storage-browser</a></div><div class="sidebar-section-children"><a href="module-storage_global-tables.html">storage/global-tables</a></div><div class="sidebar-section-children"><a href="module-storage_gun-async.html">storage/gun-async</a></div><div class="sidebar-section-children"><a href="module-storage_gun-auth.html">storage/gun-auth</a></div><div class="sidebar-section-children"><a href="module-storage_gun-federation.html">storage/gun-federation</a></div><div class="sidebar-section-children"><a href="module-storage_gun-references.html">storage/gun-references</a></div><div class="sidebar-section-children"><a href="module-storage_gun-schema.html">storage/gun-schema</a></div><div class="sidebar-section-children"><a href="module-storage_gun-wrapper.html">storage/gun-wrapper</a></div><div class="sidebar-section-children"><a href="module-storage_indexeddb-storage.html">storage/indexeddb-storage</a></div><div class="sidebar-section-children"><a href="module-storage_key-storage.html">storage/key-storage</a></div><div class="sidebar-section-children"><a href="module-storage_key-storage-simple.html">storage/key-storage-simple</a></div><div class="sidebar-section-children"><a href="module-storage_memory-storage.html">storage/memory-storage</a></div><div class="sidebar-section-children"><a href="module-storage_migration.html">storage/migration</a></div><div class="sidebar-section-children"><a href="module-storage_nostr-async.html">storage/nostr-async</a></div><div class="sidebar-section-children"><a href="module-storage_nostr-client.html">storage/nostr-client</a></div><div class="sidebar-section-children"><a href="module-storage_nostr-wrapper.html">storage/nostr-wrapper</a></div><div class="sidebar-section-children"><a href="module-storage_outbox-queue.html">storage/outbox-queue</a></div><div class="sidebar-section-children"><a href="module-storage_persistent-storage.html">storage/persistent-storage</a></div><div class="sidebar-section-children"><a href="module-storage_sync-service.html">storage/sync-service</a></div><div class="sidebar-section-children"><a href="module-storage_unified-storage.html">storage/unified-storage</a></div><div class="sidebar-section-children"><a href="module-subscriptions_manager.html">subscriptions/manager</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-classes"><div>Classes</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="module-ai_aggregation.SmartAggregation.html">SmartAggregation</a></div><div class="sidebar-section-children"><a href="module-ai_aggregation-SmartAggregation.html">SmartAggregation</a></div><div class="sidebar-section-children"><a href="module-ai_breakdown.TaskBreakdown.html">TaskBreakdown</a></div><div class="sidebar-section-children"><a href="module-ai_breakdown-TaskBreakdown.html">TaskBreakdown</a></div><div class="sidebar-section-children"><a href="module-ai_classifier.Classifier.html">Classifier</a></div><div class="sidebar-section-children"><a href="module-ai_classifier-Classifier.html">Classifier</a></div><div class="sidebar-section-children"><a href="module-ai_council.Council.html">Council</a></div><div class="sidebar-section-children"><a href="module-ai_council-Council.html">Council</a></div><div class="sidebar-section-children"><a href="module-ai_embeddings.Embeddings.html">Embeddings</a></div><div class="sidebar-section-children"><a href="module-ai_embeddings-Embeddings.html">Embeddings</a></div><div class="sidebar-section-children"><a href="module-ai_federation-ai.FederationAdvisor.html">FederationAdvisor</a></div><div class="sidebar-section-children"><a href="module-ai_federation-ai-FederationAdvisor.html">FederationAdvisor</a></div><div class="sidebar-section-children"><a href="module-ai_h3-ai.H3AI.html">H3AI</a></div><div class="sidebar-section-children"><a href="module-ai_h3-ai-H3AI.html">H3AI</a></div><div class="sidebar-section-children"><a href="module-ai_json-ops.JSONOps.html">JSONOps</a></div><div class="sidebar-section-children"><a href="module-ai_json-ops-JSONOps.html">JSONOps</a></div><div class="sidebar-section-children"><a href="module-ai_llm-service.LLMService.html">LLMService</a></div><div class="sidebar-section-children"><a href="module-ai_llm-service-LLMService.html">LLMService</a></div><div class="sidebar-section-children"><a href="module-ai_nl-query.NLQuery.html">NLQuery</a></div><div class="sidebar-section-children"><a href="module-ai_nl-query-NLQuery.html">NLQuery</a></div><div class="sidebar-section-children"><a href="module-ai_relationships.RelationshipDiscovery.html">RelationshipDiscovery</a></div><div class="sidebar-section-children"><a href="module-ai_relationships-RelationshipDiscovery.html">RelationshipDiscovery</a></div><div class="sidebar-section-children"><a href="module-ai_schema-extractor.SchemaExtractor.html">SchemaExtractor</a></div><div class="sidebar-section-children"><a href="module-ai_schema-extractor-SchemaExtractor.html">SchemaExtractor</a></div><div class="sidebar-section-children"><a href="module-ai_spatial.SpatialAnalysis.html">SpatialAnalysis</a></div><div class="sidebar-section-children"><a href="module-ai_spatial-SpatialAnalysis.html">SpatialAnalysis</a></div><div class="sidebar-section-children"><a href="module-ai_tts.TTS.html">TTS</a></div><div class="sidebar-section-children"><a href="module-ai_tts-TTS.html">TTS</a></div><div class="sidebar-section-children"><a href="module-core_holosphere.HoloSphere.html">HoloSphere</a></div><div class="sidebar-section-children"><a href="module-core_holosphere-HoloSphere.html">HoloSphere</a></div><div class="sidebar-section-children"><a href="module-holosphere-HoloSphereBase.html">HoloSphereBase</a></div><div class="sidebar-section-children"><a href="module-holosphere-HoloSphereBase.html">HoloSphereBase</a></div><div class="sidebar-section-children"><a href="module-lib_errors.AuthorizationError.html">AuthorizationError</a></div><div class="sidebar-section-children"><a href="module-lib_errors.ValidationError.html">ValidationError</a></div><div class="sidebar-section-children"><a href="module-lib_errors-AuthorizationError.html">AuthorizationError</a></div><div class="sidebar-section-children"><a href="module-lib_errors-ValidationError.html">ValidationError</a></div><div class="sidebar-section-children"><a href="module-schema_validator.ValidationError.html">ValidationError</a></div><div class="sidebar-section-children"><a href="module-schema_validator-ValidationError.html">ValidationError</a></div><div class="sidebar-section-children"><a href="module-storage_backend-factory.BackendFactory.html">BackendFactory</a></div><div class="sidebar-section-children"><a href="module-storage_backend-interface.StorageBackend.html">StorageBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backend-interface-StorageBackend.html">StorageBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_activitypub-backend.ActivityPubBackend.html">ActivityPubBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_activitypub-backend-ActivityPubBackend.html">ActivityPubBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_activitypub_server.ActivityPubServer.html">ActivityPubServer</a></div><div class="sidebar-section-children"><a href="module-storage_backends_activitypub_server-ActivityPubServer.html">ActivityPubServer</a></div><div class="sidebar-section-children"><a href="module-storage_backends_gundb-backend.GunDBBackend.html">GunDBBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_gundb-backend-GunDBBackend.html">GunDBBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_nostr-backend.NostrBackend.html">NostrBackend</a></div><div class="sidebar-section-children"><a href="module-storage_backends_nostr-backend-NostrBackend.html">NostrBackend</a></div><div class="sidebar-section-children"><a href="module-storage_filesystem-storage-browser.FileSystemStorage.html">FileSystemStorage</a></div><div class="sidebar-section-children"><a href="module-storage_filesystem-storage-browser-FileSystemStorage.html">FileSystemStorage</a></div><div class="sidebar-section-children"><a href="module-storage_filesystem-storage.FileSystemStorage.html">FileSystemStorage</a></div><div class="sidebar-section-children"><a href="module-storage_filesystem-storage-FileSystemStorage.html">FileSystemStorage</a></div><div class="sidebar-section-children"><a href="module-storage_gun-auth.GunAuth.html">GunAuth</a></div><div class="sidebar-section-children"><a href="module-storage_gun-auth-GunAuth.html">GunAuth</a></div><div class="sidebar-section-children"><a href="module-storage_gun-references.GunReferenceHandler.html">GunReferenceHandler</a></div><div class="sidebar-section-children"><a href="module-storage_gun-references-GunReferenceHandler.html">GunReferenceHandler</a></div><div class="sidebar-section-children"><a href="module-storage_gun-schema.GunSchemaValidator.html">GunSchemaValidator</a></div><div class="sidebar-section-children"><a href="module-storage_gun-schema-GunSchemaValidator.html">GunSchemaValidator</a></div><div class="sidebar-section-children"><a href="module-storage_indexeddb-storage.IndexedDBStorage.html">IndexedDBStorage</a></div><div class="sidebar-section-children"><a href="module-storage_indexeddb-storage-IndexedDBStorage.html">IndexedDBStorage</a></div><div class="sidebar-section-children"><a href="module-storage_memory-storage.MemoryStorage.html">MemoryStorage</a></div><div class="sidebar-section-children"><a href="module-storage_memory-storage-MemoryStorage.html">MemoryStorage</a></div><div class="sidebar-section-children"><a href="module-storage_migration.MigrationTool.html">MigrationTool</a></div><div class="sidebar-section-children"><a href="module-storage_migration-MigrationTool.html">MigrationTool</a></div><div class="sidebar-section-children"><a href="module-storage_nostr-client.NostrClient.html">NostrClient</a></div><div class="sidebar-section-children"><a href="module-storage_nostr-client-LRUCache.html">LRUCache</a></div><div class="sidebar-section-children"><a href="module-storage_nostr-client-NostrClient.html">NostrClient</a></div><div class="sidebar-section-children"><a href="module-storage_outbox-queue.OutboxQueue.html">OutboxQueue</a></div><div class="sidebar-section-children"><a href="module-storage_outbox-queue-OutboxQueue.html">OutboxQueue</a></div><div class="sidebar-section-children"><a href="module-storage_persistent-storage-PersistentStorage.html">PersistentStorage</a></div><div class="sidebar-section-children"><a href="module-storage_sync-service.SyncService.html">SyncService</a></div><div class="sidebar-section-children"><a href="module-storage_sync-service-SyncService.html">SyncService</a></div><div class="sidebar-section-children"><a href="module-subscriptions_manager.SubscriptionRegistry.html">SubscriptionRegistry</a></div></div><div class="sidebar-section-title with-arrow" data-isopen="false" id="sidebar-global"><div>Global</div><svg><use xlink:href="#down-icon"></use></svg></div><div class="sidebar-section-children-container"><div class="sidebar-section-children"><a href="global.html#FederationRequestPayload">FederationRequestPayload</a></div><div class="sidebar-section-children"><a href="global.html#FederationResponsePayload">FederationResponsePayload</a></div><div class="sidebar-section-children"><a href="global.html#acceptFederationRequest">acceptFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#acceptFederationRequest">acceptFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#addFederatedPartner">addFederatedPartner</a></div><div class="sidebar-section-children"><a href="global.html#cleanupExpiredCapabilities">cleanupExpiredCapabilities</a></div><div class="sidebar-section-children"><a href="global.html#createFederationRequest">createFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#createFederationResponse">createFederationResponse</a></div><div class="sidebar-section-children"><a href="global.html#declineFederationRequest">declineFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#getCapabilityForAuthor">getCapabilityForAuthor</a></div><div class="sidebar-section-children"><a href="global.html#getFederatedAuthors">getFederatedAuthors</a></div><div class="sidebar-section-children"><a href="global.html#getFederatedAuthorsForScope">getFederatedAuthorsForScope</a></div><div class="sidebar-section-children"><a href="global.html#getFederatedPartner">getFederatedPartner</a></div><div class="sidebar-section-children"><a href="global.html#getFederationRegistry">getFederationRegistry</a></div><div class="sidebar-section-children"><a href="global.html#getPendingFederationRequests">getPendingFederationRequests</a></div><div class="sidebar-section-children"><a href="global.html#initiateFederationHandshake">initiateFederationHandshake</a></div><div class="sidebar-section-children"><a href="global.html#isFederationRequest">isFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#isFederationResponse">isFederationResponse</a></div><div class="sidebar-section-children"><a href="global.html#rejectFederationRequest">rejectFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#removeFederatedPartner">removeFederatedPartner</a></div><div class="sidebar-section-children"><a href="global.html#revokeOutboundCapability">revokeOutboundCapability</a></div><div class="sidebar-section-children"><a href="global.html#saveFederationRegistry">saveFederationRegistry</a></div><div class="sidebar-section-children"><a href="global.html#sendFederationRequest">sendFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#sendFederationRequest">sendFederationRequest</a></div><div class="sidebar-section-children"><a href="global.html#sendFederationResponse">sendFederationResponse</a></div><div class="sidebar-section-children"><a href="global.html#storeInboundCapability">storeInboundCapability</a></div><div class="sidebar-section-children"><a href="global.html#storeOutboundCapability">storeOutboundCapability</a></div><div class="sidebar-section-children"><a href="global.html#subscribeFederationAcceptances">subscribeFederationAcceptances</a></div><div class="sidebar-section-children"><a href="global.html#subscribeFederationDeclines">subscribeFederationDeclines</a></div><div class="sidebar-section-children"><a href="global.html#subscribeFederationRequests">subscribeFederationRequests</a></div><div class="sidebar-section-children"><a href="global.html#subscribeToFederationDMs">subscribeToFederationDMs</a></div><div class="sidebar-section-children"><a href="global.html#updateDiscoverySettings">updateDiscoverySettings</a></div></div></div><div class="mobile-navbar-actions"><div class="navbar-right-item"><button class="icon-button search-button" aria-label="open-search"><svg><use xlink:href="#search-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button theme-toggle" aria-label="toggle-theme"><svg><use class="theme-svg-use" xlink:href="#light-theme-icon"></use></svg></button></div><div class="navbar-right-item"><button class="icon-button font-size" aria-label="change-font-size"><svg><use xlink:href="#font-size-icon"></use></svg></button></div></div></div></div><script type="text/javascript" src="scripts/core.min.js"></script><script src="scripts/search.min.js" defer="defer"></script><script src="scripts/third-party/fuse.js" defer="defer"></script><script type="text/javascript">var tocbotInstance=tocbot.init({tocSelector:"#eed4d2a0bfd64539bb9df78095dec881",contentSelector:".main-content",headingSelector:"h1, h2, h3",hasInnerContainers:!0,scrollContainer:".main-content",headingsOffset:130,onClick:bringLinkToView})</script></body></html>