npm - holosphere - Versions diffs - 2.0.0-alpha1 → 2.0.0-alpha10 - Mend

holosphere 2.0.0-alpha1 → 2.0.0-alpha10

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 (418) hide show

package/CHANGELOG.md +473 -0
package/FEATURES.md +431 -0
package/LICENSE +29 -166
package/LICENSE-AGPL.md +180 -0
package/README.md +97 -16
package/dist/2019-D2OG2idw.js +6680 -0
package/dist/2019-D2OG2idw.js.map +1 -0
package/dist/2019-EION3wKo.cjs +8 -0
package/dist/2019-EION3wKo.cjs.map +1 -0
package/dist/_commonjsHelpers-C37NGDzP.cjs +2 -0
package/dist/_commonjsHelpers-C37NGDzP.cjs.map +1 -0
package/dist/_commonjsHelpers-CUmg6egw.js +7 -0
package/dist/_commonjsHelpers-CUmg6egw.js.map +1 -0
package/dist/browser-BSniCNqO.js +3058 -0
package/dist/browser-BSniCNqO.js.map +1 -0
package/dist/browser-Cq59Ij19.cjs +2 -0
package/dist/browser-Cq59Ij19.cjs.map +1 -0
package/dist/cdn/holosphere.min.js +55 -0
package/dist/cdn/holosphere.min.js.map +1 -0
package/dist/cjs/holosphere.cjs +2 -0
package/dist/cjs/holosphere.cjs.map +1 -0
package/dist/esm/holosphere.js +53 -0
package/dist/esm/holosphere.js.map +1 -0
package/dist/index-DDGt_V9o.cjs +12 -0
package/dist/index-DDGt_V9o.cjs.map +1 -0
package/dist/index-DJXftyvB.js +39841 -0
package/dist/index-DJXftyvB.js.map +1 -0
package/dist/index-DMbdcMtK.cjs +18 -0
package/dist/index-DMbdcMtK.cjs.map +1 -0
package/dist/index-DeZ1xz_s.js +15104 -0
package/dist/index-DeZ1xz_s.js.map +1 -0
package/dist/indexeddb-storage-BFt6hMeF.js +176 -0
package/dist/indexeddb-storage-BFt6hMeF.js.map +1 -0
package/dist/indexeddb-storage-BK5tv4Sh.cjs +2 -0
package/dist/indexeddb-storage-BK5tv4Sh.cjs.map +1 -0
package/dist/memory-storage-C9HuoL2E.js +91 -0
package/dist/memory-storage-C9HuoL2E.js.map +1 -0
package/dist/memory-storage-Dao7jfYG.cjs +2 -0
package/dist/memory-storage-Dao7jfYG.cjs.map +1 -0
package/dist/secp256k1-BbKzbLtD.cjs +12 -0
package/dist/secp256k1-BbKzbLtD.cjs.map +1 -0
package/dist/secp256k1-CreY7Pcl.js +1890 -0
package/dist/secp256k1-CreY7Pcl.js.map +1 -0
package/docs/CONTRACTS.md +797 -0
package/docs/FOSDEM_PROPOSAL.md +388 -0
package/docs/LOCALFIRST.md +266 -0
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/docs/contracts/api-interface.md +793 -0
package/docs/data-model.md +476 -0
package/docs/gun-async-usage.md +338 -0
package/docs/plan.md +349 -0
package/docs/quickstart.md +674 -0
package/docs/research.md +362 -0
package/docs/spec.md +244 -0
package/docs/storage-backends.md +326 -0
package/docs/tasks.md +947 -0
package/examples/demo.html +47 -0
package/examples/holosphere-widget.js +1242 -0
package/examples/widget-demo.html +274 -0
package/examples/widget.html +703 -0
package/jsdoc.json +26 -0
package/package.json +25 -7
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/cdn-entry.js +22 -0
package/src/content/social-protocols.js +34 -25
package/src/contracts/abis/Appreciative.json +1280 -0
package/src/contracts/abis/AppreciativeFactory.json +101 -0
package/src/contracts/abis/Bundle.json +1438 -0
package/src/contracts/abis/BundleFactory.json +106 -0
package/src/contracts/abis/Holon.json +881 -0
package/src/contracts/abis/Holons.json +330 -0
package/src/contracts/abis/Managed.json +1262 -0
package/src/contracts/abis/ManagedFactory.json +149 -0
package/src/contracts/abis/Membrane.json +261 -0
package/src/contracts/abis/Splitter.json +1624 -0
package/src/contracts/abis/SplitterFactory.json +220 -0
package/src/contracts/abis/TestToken.json +321 -0
package/src/contracts/abis/Zoned.json +1461 -0
package/src/contracts/abis/ZonedFactory.json +154 -0
package/src/contracts/chain-manager.js +403 -0
package/src/contracts/deployer.js +500 -0
package/src/contracts/event-listener.js +539 -0
package/src/contracts/holon-contracts.js +359 -0
package/src/contracts/index.js +82 -0
package/src/contracts/networks.js +229 -0
package/src/contracts/operations.js +687 -0
package/src/contracts/queries.js +638 -0
package/src/core/holosphere.js +487 -6
package/src/crypto/nostr-utils.js +303 -0
package/src/crypto/secp256k1.js +7 -2
package/src/federation/handshake.js +475 -0
package/src/federation/hologram.js +117 -3
package/src/hierarchical/upcast.js +40 -25
package/src/index.js +1501 -1909
package/src/lib/ai-methods.js +657 -0
package/src/lib/contract-methods.js +442 -0
package/src/lib/errors.js +53 -0
package/src/lib/federation-methods.js +345 -0
package/src/lib/index.js +30 -0
package/src/schema/validator.js +22 -3
package/src/spatial/h3-operations.js +19 -3
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 +692 -50
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 +35 -3
package/src/storage/gun-async.js +75 -15
package/src/storage/gun-auth.js +373 -0
package/src/storage/gun-federation.js +785 -0
package/src/storage/gun-references.js +209 -0
package/src/storage/gun-schema.js +306 -0
package/src/storage/gun-wrapper.js +475 -54
package/src/storage/indexeddb-storage.js +112 -13
package/src/storage/key-storage-simple.js +32 -9
package/src/storage/key-storage.js +45 -13
package/src/storage/memory-storage.js +68 -2
package/src/storage/migration.js +20 -7
package/src/storage/nostr-async.js +412 -122
package/src/storage/nostr-client.js +749 -76
package/src/storage/nostr-wrapper.js +6 -2
package/src/storage/outbox-queue.js +55 -18
package/src/storage/persistent-storage.js +62 -14
package/src/storage/sync-service.js +51 -17
package/src/storage/unified-storage.js +154 -0
package/src/subscriptions/manager.js +34 -17
package/types/index.d.ts +133 -0
package/vite.config.cdn.js +60 -0
package/tests/unit/ai/aggregation.test.js +0 -295
package/tests/unit/ai/breakdown.test.js +0 -446
package/tests/unit/ai/classifier.test.js +0 -294
package/tests/unit/ai/council.test.js +0 -262
package/tests/unit/ai/embeddings.test.js +0 -384
package/tests/unit/ai/federation-ai.test.js +0 -344
package/tests/unit/ai/h3-ai.test.js +0 -458
package/tests/unit/ai/index.test.js +0 -304
package/tests/unit/ai/json-ops.test.js +0 -307
package/tests/unit/ai/llm-service.test.js +0 -390
package/tests/unit/ai/nl-query.test.js +0 -383
package/tests/unit/ai/relationships.test.js +0 -311
package/tests/unit/ai/schema-extractor.test.js +0 -384
package/tests/unit/ai/spatial.test.js +0 -279
package/tests/unit/ai/tts.test.js +0 -279
package/tests/unit/content.test.js +0 -332
package/tests/unit/contract/core.test.js +0 -88
package/tests/unit/contract/crypto.test.js +0 -198
package/tests/unit/contract/data.test.js +0 -223
package/tests/unit/contract/federation.test.js +0 -181
package/tests/unit/contract/hierarchical.test.js +0 -113
package/tests/unit/contract/schema.test.js +0 -114
package/tests/unit/contract/social.test.js +0 -217
package/tests/unit/contract/spatial.test.js +0 -110
package/tests/unit/contract/subscriptions.test.js +0 -128
package/tests/unit/contract/utils.test.js +0 -159
package/tests/unit/core.test.js +0 -152
package/tests/unit/crypto.test.js +0 -328
package/tests/unit/federation.test.js +0 -234
package/tests/unit/gun-async.test.js +0 -252
package/tests/unit/hierarchical.test.js +0 -399
package/tests/unit/integration/scenario-01-geographic-storage.test.js +0 -74
package/tests/unit/integration/scenario-02-federation.test.js +0 -76
package/tests/unit/integration/scenario-03-subscriptions.test.js +0 -102
package/tests/unit/integration/scenario-04-validation.test.js +0 -129
package/tests/unit/integration/scenario-05-hierarchy.test.js +0 -125
package/tests/unit/integration/scenario-06-social.test.js +0 -135
package/tests/unit/integration/scenario-07-persistence.test.js +0 -130
package/tests/unit/integration/scenario-08-authorization.test.js +0 -161
package/tests/unit/integration/scenario-09-cross-dimensional.test.js +0 -139
package/tests/unit/integration/scenario-10-cross-holosphere-capabilities.test.js +0 -357
package/tests/unit/integration/scenario-11-cross-holosphere-federation.test.js +0 -410
package/tests/unit/integration/scenario-12-capability-federated-read.test.js +0 -719
package/tests/unit/performance/benchmark.test.js +0 -85
package/tests/unit/schema.test.js +0 -213
package/tests/unit/spatial.test.js +0 -158
package/tests/unit/storage.test.js +0 -195
package/tests/unit/subscriptions.test.js +0 -328
package/tests/unit/test-data-permanence-debug.js +0 -197
package/tests/unit/test-data-permanence.js +0 -340
package/tests/unit/test-key-persistence-fixed.js +0 -148
package/tests/unit/test-key-persistence.js +0 -172
package/tests/unit/test-relay-permanence.js +0 -376
package/tests/unit/test-second-node.js +0 -95
package/tests/unit/test-simple-write.js +0 -89
/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/index.js.html ADDED Viewed

@@ -0,0 +1,1868 @@
+<!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: index.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">index.js</h1></header><article><pre class="prettyprint source lang-js"><code>/**
+ * @fileoverview HoloSphere - Holonic Geospatial Communication Infrastructure
+ *
+ * This is the main entry point for the HoloSphere library, providing a comprehensive
+ * distributed P2P geospatial communication system. It combines H3 hexagonal indexing
+ * for spatial organization, Nostr protocol for distributed storage, smart contracts
+ * for fund distribution, and AI services for intelligent data processing.
+ *
+ * @module holosphere
+ * @author HoloSphere Team
+ * @license MIT
+ */
+import { HoloSphere as HoloSphereCore } from './core/holosphere.js';
+import * as spatial from './spatial/h3-operations.js';
+import * as storage from './storage/unified-storage.js';
+import * as nostrStorage from './storage/nostr-wrapper.js';
+import * as nostrAsync from './storage/nostr-async.js';
+import * as globalTables from './storage/global-tables.js';
+import * as schema from './schema/validator.js';
+import { ValidationError } from './schema/validator.js';
+import * as federation from './federation/hologram.js';
+import * as handshake from './federation/handshake.js';
+import * as crypto from './crypto/secp256k1.js';
+import * as nostrUtils from './crypto/nostr-utils.js';
+import * as social from './content/social-protocols.js';
+import * as subscriptions from './subscriptions/manager.js';
+import * as hierarchical from './hierarchical/upcast.js';
+// AI Module imports
+import { LLMService } from './ai/llm-service.js';
+import { SchemaExtractor } from './ai/schema-extractor.js';
+import { JSONOps } from './ai/json-ops.js';
+import { Embeddings } from './ai/embeddings.js';
+import { Council } from './ai/council.js';
+import { TTS, VOICES, MODELS } from './ai/tts.js';
+import { NLQuery } from './ai/nl-query.js';
+import { Classifier } from './ai/classifier.js';
+import { SpatialAnalysis } from './ai/spatial.js';
+import { SmartAggregation } from './ai/aggregation.js';
+import { FederationAdvisor } from './ai/federation-ai.js';
+import { RelationshipDiscovery } from './ai/relationships.js';
+import { TaskBreakdown } from './ai/breakdown.js';
+import { H3AI } from './ai/h3-ai.js';
+// Contracts Module imports
+import { ChainManager } from './contracts/chain-manager.js';
+import { ContractDeployer, ABIs as ContractABIs } from './contracts/deployer.js';
+import { HolonContracts } from './contracts/holon-contracts.js';
+import { ContractOperations } from './contracts/operations.js';
+import { EventListener, SANKEY_EVENTS } from './contracts/event-listener.js';
+import { ContractQueries } from './contracts/queries.js';
+import * as networks from './contracts/networks.js';
+// Mixin imports
+import { withAIMethods } from './lib/ai-methods.js';
+import { withContractMethods } from './lib/contract-methods.js';
+import { withFederationMethods } from './lib/federation-methods.js';
+import { AuthorizationError } from './lib/errors.js';
+/**
+ * Base HoloSphere class with core data operations.
+ * Extends HoloSphereCore with schema validation, caching, subscriptions, and AI capabilities.
+ *
+ * @class HoloSphereBase
+ * @extends HoloSphereCore
+ */
+class HoloSphereBase extends HoloSphereCore {
+  /**
+   * Creates a new HoloSphereBase instance.
+   *
+   * @param {Object} config - Configuration options
+   * @param {string} config.appName - Application namespace for data isolation
+   * @param {string} [config.backend='nostr'] - Storage backend type ('nostr', 'gundb', 'activitypub')
+   * @param {string[]} [config.relays] - Nostr relay URLs for distributed storage
+   * @param {string} [config.openaiKey] - OpenAI API key for AI services
+   * @param {Object} [config.aiOptions] - AI service configuration
+   * @param {string} [config.aiOptions.model] - OpenAI model to use
+   * @param {number} [config.aiOptions.temperature] - Temperature for AI responses
+   */
+  constructor(config) {
+    super(config);
+    /** @type {Map&lt;string, {schema: Object, strict: boolean, timestamp: number}>} */
+    this.schemas = new Map();
+    /** @type {Map&lt;string, any>} */
+    this._cache = new Map();
+    /** @type {subscriptions.SubscriptionRegistry} */
+    this.subscriptionRegistry = new subscriptions.SubscriptionRegistry();
+    // Initialize AI services if openaiKey is provided or OPENAI_API_KEY env var is set
+    /** @type {Object|null} */
+    this._ai = null;
+    const openaiKey = config.openaiKey || this._getEnv('OPENAI_API_KEY');
+    if (openaiKey) {
+      const aiOptions = {
+        ...config.aiOptions,
+        model: config.aiOptions?.model || this._getEnv('HOLOSPHERE_AI_MODEL'),
+        temperature: config.aiOptions?.temperature ?? this._parseFloat(this._getEnv('HOLOSPHERE_AI_TEMPERATURE')),
+      };
+      this._initializeAI(openaiKey, aiOptions);
+    }
+    // Contracts module (lazy initialized)
+    /** @type {Object|null} */
+    this._contracts = null;
+  }
+  /**
+   * Gets an environment variable value (Node.js only).
+   *
+   * @private
+   * @param {string} name - Environment variable name
+   * @returns {string|undefined} Environment variable value or undefined
+   */
+  _getEnv(name) {
+    if (typeof process !== 'undefined' &amp;&amp; process.env) {
+      return process.env[name];
+    }
+    return undefined;
+  }
+  /**
+   * Parses a string value to a float.
+   *
+   * @private
+   * @param {string|undefined|null} value - Value to parse
+   * @returns {number|undefined} Parsed float or undefined if invalid
+   */
+  _parseFloat(value) {
+    if (value === undefined || value === null) return undefined;
+    const parsed = parseFloat(value);
+    return isNaN(parsed) ? undefined : parsed;
+  }
+  /**
+   * Initializes AI services with the provided API key.
+   *
+   * @private
+   * @param {string} apiKey - OpenAI API key
+   * @param {Object} [options={}] - AI configuration options
+   * @param {string} [options.model] - OpenAI model to use
+   * @param {number} [options.temperature] - Temperature for AI responses
+   */
+  _initializeAI(apiKey, options = {}) {
+    const llmOptions = {
+      ...options.llm,
+      model: options.model || options.llm?.model,
+      temperature: options.temperature ?? options.llm?.temperature,
+    };
+    this._ai = {
+      llm: new LLMService(apiKey, llmOptions),
+    };
+    const OpenAI = require('openai').default;
+    const openai = new OpenAI({ apiKey });
+    this._ai.openai = openai;
+    this._ai.embeddings = new Embeddings(openai, this);
+    this._ai.schemaExtractor = new SchemaExtractor(this._ai.llm);
+    this._ai.jsonOps = new JSONOps(this._ai.llm);
+    this._ai.council = new Council(this._ai.llm);
+    this._ai.tts = new TTS(openai);
+    this._ai.nlQuery = new NLQuery(this._ai.llm, this);
+    this._ai.classifier = new Classifier(this._ai.llm, this);
+    this._ai.spatial = new SpatialAnalysis(this._ai.llm, this);
+    this._ai.aggregation = new SmartAggregation(this._ai.llm, this);
+    this._ai.federationAdvisor = new FederationAdvisor(this._ai.llm, this, this._ai.embeddings);
+    this._ai.relationships = new RelationshipDiscovery(this._ai.llm, this, this._ai.embeddings);
+    this._ai.taskBreakdown = new TaskBreakdown(this._ai.llm, this);
+    this._ai.h3ai = new H3AI(this._ai.llm, this);
+  }
+  /**
+   * Checks if AI services are initialized.
+   *
+   * @returns {boolean} True if AI services are available
+   */
+  hasAI() {
+    return this._ai !== null;
+  }
+  /**
+   * Gets the initialized AI services object.
+   *
+   * @returns {Object|null} AI services object containing llm, embeddings, etc., or null if not initialized
+   */
+  getAIServices() {
+    return this._ai;
+  }
+  // === Spatial Operations ===
+  /**
+   * Converts geographic coordinates to an H3 holon ID.
+   *
+   * @param {number} lat - Latitude (-90 to 90)
+   * @param {number} lng - Longitude (-180 to 180)
+   * @param {number} resolution - H3 resolution level (0-15)
+   * @returns {Promise&lt;string>} H3 cell ID representing the holon
+   */
+  async toHolon(lat, lng, resolution) {
+    return spatial.toHolon(lat, lng, resolution);
+  }
+  /**
+   * Gets all parent holons at higher resolutions.
+   *
+   * @param {string} holonId - H3 cell ID
+   * @param {number} [maxResolution] - Maximum resolution to traverse up to
+   * @returns {Promise&lt;string[]>} Array of parent H3 cell IDs
+   */
+  async getParents(holonId, maxResolution) {
+    return spatial.getParents(holonId, maxResolution);
+  }
+  /**
+   * Gets all child holons at the next resolution level.
+   *
+   * @param {string} holonId - H3 cell ID
+   * @returns {Promise&lt;string[]>} Array of child H3 cell IDs
+   */
+  async getChildren(holonId) {
+    return spatial.getChildren(holonId);
+  }
+  /**
+   * Validates if a string is a valid H3 cell ID.
+   *
+   * @param {string} holonId - String to validate
+   * @returns {boolean} True if valid H3 cell ID
+   */
+  isValidH3(holonId) {
+    return spatial.isValidH3(holonId);
+  }
+  // === Data Operations ===
+  /**
+   * Writes data to a specific holon and lens.
+   *
+   * @param {string} holonId - H3 cell ID for the holon
+   * @param {string} lensName - Name of the lens (data category)
+   * @param {Object} data - Data object to write (must have or will be assigned an id)
+   * @param {Object} [options={}] - Write options
+   * @param {string} [options.capabilityToken] - Capability token for authorization
+   * @param {boolean} [options.validate=true] - Whether to validate against schema
+   * @param {boolean} [options.strict] - Override schema strict mode
+   * @param {boolean} [options.autoPropagate=true] - Whether to propagate to federated holons
+   * @param {Object} [options.propagationOptions] - Options for propagation
+   * @returns {Promise&lt;boolean>} True if write succeeded
+   * @throws {ValidationError} If holonId, lensName, or data is invalid
+   * @throws {AuthorizationError} If capability token is invalid
+   */
+  async write(holonId, lensName, data, options = {}) {
+    if (!holonId || typeof holonId !== 'string') {
+      throw new ValidationError('ValidationError: holonId must be a non-empty string');
+    }
+    if (!lensName || typeof lensName !== 'string') {
+      throw new ValidationError('ValidationError: lensName must be a non-empty string');
+    }
+    if (!data || typeof data !== 'object') {
+      throw new ValidationError('ValidationError: data must be an object');
+    }
+    const capToken = options.capabilityToken || options.capability;
+    if (capToken) {
+      const authorized = await this.verifyCapability(capToken, 'write', { holonId, lensName });
+      if (!authorized) {
+        throw new AuthorizationError('AuthorizationError: Invalid capability token for write operation', 'write');
+      }
+    }
+    if (!data.id) {
+      data.id = `${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+    }
+    const path = storage.buildPath(this.config.appName, holonId, lensName, data.id);
+    this._log('DEBUG', 'write', { holonId, lensName, dataId: data.id, path });
+    const existingData = await storage.read(this.client, path);
+    // Handle hologram writes
+    if (existingData &amp;&amp; existingData.hologram === true &amp;&amp; existingData.target) {
+      const hologramStructureFields = ['hologram', 'soul', 'target', 'id', '_meta'];
+      const localOverrideFields = Object.keys(existingData).filter(k => !hologramStructureFields.includes(k));
+      const localData = { ...existingData };
+      const sourceUpdates = {};
+      for (const [key, value] of Object.entries(data)) {
+        if (hologramStructureFields.includes(key) || key === '_hologram') continue;
+        if (localOverrideFields.includes(key)) {
+          localData[key] = value;
+        } else {
+          sourceUpdates[key] = value;
+        }
+      }
+      if (Object.keys(sourceUpdates).length > 0 &amp;&amp; options.validate !== false &amp;&amp; this.schemas.has(lensName)) {
+        const sourcePath = storage.buildPath(
+          existingData.target.appname || this.config.appName,
+          existingData.target.holonId,
+          existingData.target.lensName,
+          existingData.target.dataId
+        );
+        const currentSourceData = await storage.read(this.client, sourcePath);
+        const mergedSourceData = { ...currentSourceData, ...sourceUpdates };
+        const schemaObj = this.schemas.get(lensName);
+        const strict = options.strict !== undefined ? options.strict : schemaObj.strict;
+        if (schemaObj.schema &amp;&amp; typeof schemaObj.schema === 'object' &amp;&amp; !schemaObj.schema.$ref) {
+          schema.validate(mergedSourceData, schemaObj.schema, lensName, strict);
+        }
+      }
+      const startTime = Date.now();
+      await storage.write(this.client, path, localData);
+      if (Object.keys(sourceUpdates).length > 0) {
+        const sourcePath = storage.buildPath(
+          existingData.target.appname || this.config.appName,
+          existingData.target.holonId,
+          existingData.target.lensName,
+          existingData.target.dataId
+        );
+        await storage.update(this.client, sourcePath, sourceUpdates);
+        await federation.refreshActiveHolograms(
+          this.client,
+          existingData.target.appname || this.config.appName,
+          existingData.target.holonId,
+          existingData.target.lensName,
+          existingData.target.dataId
+        );
+      }
+      const endTime = Date.now();
+      this._metrics.writes++;
+      if (!this._metrics.totalWriteTime) this._metrics.totalWriteTime = 0;
+      this._metrics.totalWriteTime += (endTime - startTime);
+      return true;
+    }
+    // Regular write
+    if (!data._meta) data._meta = {};
+    data._meta.createdAt = data._meta.createdAt || Date.now();
+    data._meta.updatedAt = Date.now();
+    if (options.validate !== false &amp;&amp; this.schemas.has(lensName)) {
+      const schemaObj = this.schemas.get(lensName);
+      const strict = options.strict !== undefined ? options.strict : schemaObj.strict;
+      if (schemaObj.schema &amp;&amp; typeof schemaObj.schema === 'object' &amp;&amp; !schemaObj.schema.$ref) {
+        schema.validate(data, schemaObj.schema, lensName, strict);
+      }
+    }
+    const startTime = Date.now();
+    await storage.write(this.client, path, data);
+    const endTime = Date.now();
+    this._metrics.writes++;
+    if (!this._metrics.totalWriteTime) this._metrics.totalWriteTime = 0;
+    this._metrics.totalWriteTime += (endTime - startTime);
+    const { autoPropagate = true } = options;
+    if (autoPropagate &amp;&amp; !data.hologram) {
+      await this.propagate(holonId, lensName, data, options.propagationOptions || {});
+    }
+    return true;
+  }
+  /**
+   * Recursively resolves holograms (references) to their source data.
+   * Handles circular reference detection and local overrides.
+   *
+   * @private
+   * @param {Object|Array|null} data - Data that may contain holograms
+   * @param {Set&lt;string>} [visited=new Set()] - Set of visited paths for circular detection
+   * @returns {Promise&lt;Object|Array|null>} Resolved data with holograms replaced by source data
+   */
+  async _resolveHolograms(data, visited = new Set()) {
+    if (!data) return data;
+    if (Array.isArray(data)) {
+      const resolved = [];
+      for (const item of data) {
+        const resolvedItem = await this._resolveHolograms(item, new Set());
+        if (resolvedItem !== null) {
+          resolved.push(resolvedItem);
+        }
+      }
+      return resolved;
+    }
+    if (data &amp;&amp; typeof data === 'object') {
+      if (data.hologram === true &amp;&amp; data.target) {
+        const sourcePath = storage.buildPath(
+          data.target.appname || this.config.appName,
+          data.target.holonId,
+          data.target.lensName,
+          data.target.dataId
+        );
+        this._log('DEBUG', 'resolving hologram', {
+          hologramId: data.id,
+          sourcePath,
+          targetHolon: data.target.holonId,
+          targetLens: data.target.lensName,
+          targetDataId: data.target.dataId
+        });
+        // Circular reference detection
+        if (visited.has(sourcePath)) {
+          this._log('WARN', 'Circular hologram reference detected', { sourcePath });
+          return null;
+        }
+        visited.add(sourcePath);
+        let resolveOptions = {};
+        if (data.target.authorPubKey) {
+          resolveOptions.authors = [data.target.authorPubKey];
+          resolveOptions.includeAuthor = true;
+        }
+        const sourceData = await storage.read(this.client, sourcePath, resolveOptions);
+        this._log('DEBUG', 'hologram source fetched', { found: !!sourceData, sourcePath });
+        if (sourceData) {
+          // If source is also a hologram, recursively resolve it
+          let resolvedSource = sourceData;
+          if (sourceData.hologram === true &amp;&amp; sourceData.target) {
+            resolvedSource = await this._resolveHolograms(sourceData, visited);
+            if (resolvedSource === null) {
+              return null; // Circular reference or unresolvable
+            }
+          }
+          // Get local override fields from the hologram (excluding hologram structure fields)
+          const hologramStructureFields = ['hologram', 'soul', 'target', '_meta', 'id', 'capability', 'crossHolosphere'];
+          const localOverrides = {};
+          for (const [k, v] of Object.entries(data)) {
+            if (!hologramStructureFields.includes(k)) {
+              localOverrides[k] = v;
+            }
+          }
+          const merged = {
+            ...resolvedSource,
+            ...localOverrides,
+            _hologram: {
+              isHologram: true,
+              soul: data.soul,
+              sourceHolon: data.target.holonId,
+              source: data.target,
+              localOverrides: Object.keys(localOverrides),
+              crossHolosphere: data.crossHolosphere || false,
+            }
+          };
+          // Preserve source _meta but add hologram source info
+          if (resolvedSource._meta) {
+            merged._meta = { ...resolvedSource._meta, source: data.target.holonId };
+          } else {
+            merged._meta = { source: data.target.holonId };
+          }
+          return merged;
+        }
+        return null; // Source not found
+      }
+    }
+    return data;
+  }
+  /**
+   * Reads data from a specific holon and lens.
+   *
+   * @param {string} holonId - H3 cell ID for the holon
+   * @param {string} lensName - Name of the lens (data category)
+   * @param {string|null} [dataId=null] - Specific data ID, or null to read all
+   * @param {Object} [options={}] - Read options
+   * @param {string} [options.capabilityToken] - Capability token for authorization
+   * @param {boolean} [options.resolveHolograms=true] - Whether to resolve hologram references
+   * @returns {Promise&lt;Object|Array|null>} Data object, array of objects, or null if not found
+   * @throws {ValidationError} If holonId or lensName is invalid
+   * @throws {AuthorizationError} If capability token is invalid
+   */
+  async read(holonId, lensName, dataId = null, options = {}) {
+    if (!holonId || typeof holonId !== 'string') {
+      throw new ValidationError('ValidationError: holonId must be a non-empty string');
+    }
+    if (!lensName || typeof lensName !== 'string') {
+      throw new ValidationError('ValidationError: lensName must be a non-empty string');
+    }
+    const capToken = options.capabilityToken || options.capability;
+    if (capToken) {
+      const authorized = await this.verifyCapability(capToken, 'read', { holonId, lensName, dataId });
+      if (!authorized) {
+        throw new AuthorizationError('AuthorizationError: Invalid capability token for read operation', 'read');
+      }
+    }
+    const startTime = Date.now();
+    let result;
+    if (dataId) {
+      const path = storage.buildPath(this.config.appName, holonId, lensName, dataId);
+      this._log('DEBUG', 'read', { holonId, lensName, dataId, path });
+      result = await storage.read(this.client, path);
+      this._log('DEBUG', 'read result', { found: !!result, isHologram: result?.hologram === true });
+    } else {
+      const path = storage.buildPath(this.config.appName, holonId, lensName);
+      this._log('DEBUG', 'readAll', { holonId, lensName, path });
+      result = await storage.readAll(this.client, path);
+      this._log('DEBUG', 'readAll result', { count: Array.isArray(result) ? result.length : 0 });
+    }
+    const { resolveHolograms = true } = options;
+    if (resolveHolograms &amp;&amp; result) {
+      this._log('DEBUG', 'resolving holograms', { itemCount: Array.isArray(result) ? result.length : 1 });
+      result = await this._resolveHolograms(result);
+    }
+    const endTime = Date.now();
+    this._metrics.reads++;
+    if (!this._metrics.totalReadTime) this._metrics.totalReadTime = 0;
+    this._metrics.totalReadTime += (endTime - startTime);
+    return result;
+  }
+  /**
+   * Updates existing data in a specific holon and lens.
+   *
+   * @param {string} holonId - H3 cell ID for the holon
+   * @param {string} lensName - Name of the lens (data category)
+   * @param {string} dataId - ID of the data to update
+   * @param {Object} updates - Object containing fields to update
+   * @param {Object} [options={}] - Update options
+   * @param {string} [options.capabilityToken] - Capability token for authorization
+   * @param {boolean} [options.validate=true] - Whether to validate against schema
+   * @param {boolean} [options.strict] - Override schema strict mode
+   * @returns {Promise&lt;boolean>} True if update succeeded, false if data not found
+   * @throws {ValidationError} If holonId, lensName, dataId, or updates is invalid
+   * @throws {AuthorizationError} If capability token is invalid
+   */
+  async update(holonId, lensName, dataId, updates, options = {}) {
+    if (!holonId || typeof holonId !== 'string') {
+      throw new ValidationError('ValidationError: holonId must be a non-empty string');
+    }
+    if (!lensName || typeof lensName !== 'string') {
+      throw new ValidationError('ValidationError: lensName must be a non-empty string');
+    }
+    if (!dataId || typeof dataId !== 'string') {
+      throw new ValidationError('ValidationError: dataId must be a non-empty string');
+    }
+    if (!updates || typeof updates !== 'object') {
+      throw new ValidationError('ValidationError: updates must be an object');
+    }
+    const capToken = options.capabilityToken || options.capability;
+    if (capToken) {
+      const authorized = await this.verifyCapability(capToken, 'write', { holonId, lensName, dataId });
+      if (!authorized) {
+        throw new AuthorizationError('AuthorizationError: Invalid capability token for update operation', 'write');
+      }
+    }
+    const path = storage.buildPath(this.config.appName, holonId, lensName, dataId);
+    const existingData = await storage.read(this.client, path);
+    if (!existingData) {
+      return false;
+    }
+    // Handle hologram updates
+    if (existingData.hologram === true &amp;&amp; existingData.target) {
+      return this.write(holonId, lensName, { ...existingData, ...updates, id: dataId }, options);
+    }
+    const mergedData = { ...existingData, ...updates };
+    mergedData._meta = mergedData._meta || {};
+    mergedData._meta.updatedAt = Date.now();
+    if (options.validate !== false &amp;&amp; this.schemas.has(lensName)) {
+      const schemaObj = this.schemas.get(lensName);
+      const strict = options.strict !== undefined ? options.strict : schemaObj.strict;
+      if (schemaObj.schema &amp;&amp; typeof schemaObj.schema === 'object' &amp;&amp; !schemaObj.schema.$ref) {
+        schema.validate(mergedData, schemaObj.schema, lensName, strict);
+      }
+    }
+    const startTime = Date.now();
+    await storage.write(this.client, path, mergedData);
+    const endTime = Date.now();
+    this._metrics.writes++;
+    if (!this._metrics.totalWriteTime) this._metrics.totalWriteTime = 0;
+    this._metrics.totalWriteTime += (endTime - startTime);
+    if (existingData._meta &amp;&amp; existingData._meta.activeHolograms) {
+      await federation.refreshActiveHolograms(this.client, this.config.appName, holonId, lensName, dataId);
+    }
+    return true;
+  }
+  /**
+   * Deletes data from a specific holon and lens.
+   *
+   * @param {string} holonId - H3 cell ID for the holon
+   * @param {string} lensName - Name of the lens (data category)
+   * @param {string} dataId - ID of the data to delete
+   * @param {Object} [options={}] - Delete options
+   * @param {string} [options.capabilityToken] - Capability token for authorization
+   * @returns {Promise&lt;boolean>} True if deletion succeeded, false if data not found
+   * @throws {ValidationError} If holonId, lensName, or dataId is invalid
+   * @throws {AuthorizationError} If not owner and no valid capability token
+   */
+  async delete(holonId, lensName, dataId, options = {}) {
+    if (!holonId || typeof holonId !== 'string') {
+      throw new ValidationError('ValidationError: holonId must be a non-empty string');
+    }
+    if (!lensName || typeof lensName !== 'string') {
+      throw new ValidationError('ValidationError: lensName must be a non-empty string');
+    }
+    if (!dataId || typeof dataId !== 'string') {
+      throw new ValidationError('ValidationError: dataId must be a non-empty string');
+    }
+    const path = storage.buildPath(this.config.appName, holonId, lensName, dataId);
+    const existingData = await storage.read(this.client, path);
+    // Return false if data doesn't exist
+    if (!existingData) {
+      return false;
+    }
+    // Check authorization: owner can delete, others need capability token
+    const dataOwner = existingData.owner || existingData._creator;
+    const isOwner = !dataOwner || dataOwner === this.client.publicKey;
+    const capToken = options.capabilityToken || options.capability;
+    if (!isOwner) {
+      // Non-owner must provide a valid capability token
+      if (!capToken) {
+        throw new AuthorizationError('AuthorizationError: Capability token required for delete operation', 'delete');
+      }
+      const authorized = await this.verifyCapability(capToken, 'delete', { holonId, lensName, dataId });
+      if (!authorized) {
+        throw new AuthorizationError('AuthorizationError: Invalid capability token for delete operation', 'delete');
+      }
+    } else if (capToken) {
+      // Owner provided a token - validate it anyway
+      const authorized = await this.verifyCapability(capToken, 'delete', { holonId, lensName, dataId });
+      if (!authorized) {
+        throw new AuthorizationError('AuthorizationError: Invalid capability token for delete operation', 'delete');
+      }
+    }
+    if (existingData.hologram === true) {
+      return this.deleteHologram(holonId, lensName, dataId, options);
+    }
+    await storage.deleteData(this.client, path);
+    this._metrics.deletes++;
+    return true;
+  }
+  // === Global Tables ===
+  /**
+   * Writes data to a global table (not holon-specific).
+   *
+   * @param {string} table - Name of the global table
+   * @param {Object} data - Data object to write (must have an id field)
+   * @returns {Promise&lt;boolean>} True if write succeeded
+   */
+  async writeGlobal(table, data) {
+    return globalTables.writeGlobal(this.client, this.config.appName, table, data);
+  }
+  /**
+   * Reads data from a global table.
+   *
+   * @param {string} table - Name of the global table
+   * @param {string|null} [key=null] - Specific key to read, or null to read all
+   * @returns {Promise&lt;Object|Array|null>} Data object, array of objects, or null
+   */
+  async readGlobal(table, key = null) {
+    return globalTables.readGlobal(this.client, this.config.appName, table, key);
+  }
+  /**
+   * Updates data in a global table.
+   *
+   * @param {string} table - Name of the global table
+   * @param {string} key - Key of the data to update
+   * @param {Object} updates - Object containing fields to update
+   * @returns {Promise&lt;boolean>} True if update succeeded
+   */
+  async updateGlobal(table, key, updates) {
+    return globalTables.updateGlobal(this.client, this.config.appName, table, key, updates);
+  }
+  /**
+   * Deletes data from a global table.
+   *
+   * @param {string} table - Name of the global table
+   * @param {string} key - Key of the data to delete
+   * @returns {Promise&lt;boolean>} True if deletion succeeded
+   */
+  async deleteGlobal(table, key) {
+    return globalTables.deleteGlobal(this.client, this.config.appName, table, key);
+  }
+  /**
+   * Gets all data from a global table.
+   *
+   * @param {string} table - Name of the global table
+   * @returns {Promise&lt;Array>} Array of all data objects in the table
+   */
+  async getAllGlobal(table) {
+    return globalTables.getAllGlobal(this.client, this.config.appName, table);
+  }
+  /**
+   * Deletes all data from a global table.
+   *
+   * @param {string} table - Name of the global table
+   * @returns {Promise&lt;boolean>} True if deletion succeeded
+   */
+  async deleteAllGlobal(table) {
+    return globalTables.deleteAllGlobal(this.client, this.config.appName, table);
+  }
+  // === Batch Operations ===
+  /**
+   * Gets all data from a specific holon and lens.
+   *
+   * @param {string} holonId - H3 cell ID for the holon
+   * @param {string} lensName - Name of the lens (data category)
+   * @returns {Promise&lt;Array|null>} Array of data objects or null
+   */
+  async getAll(holonId, lensName) {
+    return this.read(holonId, lensName, null);
+  }
+  /**
+   * Deletes all data from a specific holon and lens.
+   *
+   * @param {string} holonId - H3 cell ID for the holon
+   * @param {string} lensName - Name of the lens (data category)
+   * @returns {Promise&lt;boolean>} True if deletion succeeded
+   */
+  async deleteAll(holonId, lensName) {
+    const path = storage.buildPath(this.config.appName, holonId, lensName);
+    return storage.deleteAll(this.client, path);
+  }
+  // === Schema Operations ===
+  /**
+   * Sets a JSON Schema for validating data in a specific lens.
+   *
+   * @param {string} lensName - Name of the lens to associate the schema with
+   * @param {Object|string} schemaInput - JSON Schema object or URI reference
+   * @param {boolean} [strict=false] - If true, validation will reject additional properties
+   * @returns {Promise&lt;void>}
+   * @throws {ValidationError} If lensName is invalid or schema format is invalid
+   */
+  async setSchema(lensName, schemaInput, strict = false) {
+    if (!lensName || typeof lensName !== 'string') {
+      throw new ValidationError('ValidationError: lensName must be a non-empty string');
+    }
+    // Handle null/undefined
+    if (schemaInput == null) {
+      throw new ValidationError('ValidationError: schema cannot be null or undefined');
+    }
+    let schemaObj;
+    // Handle URI string - store as $ref
+    if (typeof schemaInput === 'string') {
+      schemaObj = { $ref: schemaInput };
+    } else if (typeof schemaInput === 'object') {
+      // Validate it looks like a JSON Schema (must have type or $ref or properties or items)
+      const isValidSchema = schemaInput.$ref ||
+        schemaInput.type ||
+        schemaInput.properties ||
+        schemaInput.items ||
+        schemaInput.allOf ||
+        schemaInput.anyOf ||
+        schemaInput.oneOf ||
+        schemaInput.$schema;
+      if (!isValidSchema) {
+        throw new ValidationError('ValidationError: Invalid JSON Schema format');
+      }
+      schemaObj = schemaInput;
+    } else {
+      throw new ValidationError('ValidationError: schema must be an object or URI string');
+    }
+    this.schemas.set(lensName, { schema: schemaObj, strict, timestamp: Date.now() });
+  }
+  /**
+   * Gets the JSON Schema for a specific lens.
+   *
+   * @param {string} lensName - Name of the lens
+   * @returns {Promise&lt;Object|null>} The schema object or null if not set
+   */
+  async getSchema(lensName) {
+    const schemaObj = this.schemas.get(lensName);
+    return schemaObj ? schemaObj.schema : null;
+  }
+  /**
+   * Clears the JSON Schema for a specific lens.
+   *
+   * @param {string} lensName - Name of the lens
+   * @returns {Promise&lt;void>}
+   */
+  async clearSchema(lensName) {
+    this.schemas.delete(lensName);
+    // Returns undefined for contract compliance
+  }
+  // === Federation Operations ===
+  /**
+   * Sets up federation between two holons for a specific lens.
+   * Federation enables data sharing and synchronization between holons.
+   *
+   * @param {string} sourceHolon - Source holon H3 cell ID
+   * @param {string} targetHolon - Target holon H3 cell ID
+   * @param {string} lensName - Name of the lens to federate
+   * @param {Object} [options={}] - Federation options
+   * @param {string} [options.direction='outbound'] - Direction: 'inbound', 'outbound', or 'bidirectional'
+   * @param {string} [options.mode='reference'] - Mode: 'reference' (hologram) or 'copy'
+   * @param {Function} [options.filter] - Filter function to select which data to federate
+   * @returns {Promise&lt;boolean>} True if federation was set up successfully
+   * @throws {Error} If trying to federate a holon with itself or invalid direction
+   */
+  async federate(sourceHolon, targetHolon, lensName, options = {}) {
+    const { direction = 'outbound', mode = 'reference', filter = null } = options;
+    // Validation
+    if (sourceHolon === targetHolon) {
+      throw new Error('Cannot federate a holon with itself');
+    }
+    if (!['inbound', 'outbound', 'bidirectional'].includes(direction)) {
+      throw new Error(`Invalid direction: ${direction}. Must be 'inbound', 'outbound', or 'bidirectional'`);
+    }
+    // Store federation config
+    await federation.setupFederation(
+      this.client,
+      this.config.appName,
+      sourceHolon,
+      targetHolon,
+      lensName,
+      options
+    );
+    // Actually propagate existing data based on direction
+    if (direction === 'outbound' || direction === 'bidirectional') {
+      await this._propagateExistingData(sourceHolon, targetHolon, lensName, { mode, filter });
+    }
+    if (direction === 'inbound' || direction === 'bidirectional') {
+      await this._propagateExistingData(targetHolon, sourceHolon, lensName, { mode, filter });
+    }
+    this._metrics.federations = (this._metrics.federations || 0) + 1;
+    return true;
+  }
+  /**
+   * Propagates existing data from one holon to another.
+   *
+   * @private
+   * @param {string} fromHolon - Source holon H3 cell ID
+   * @param {string} toHolon - Target holon H3 cell ID
+   * @param {string} lensName - Name of the lens
+   * @param {Object} [options={}] - Propagation options
+   * @param {string} [options.mode='reference'] - Mode: 'reference' or 'copy'
+   * @param {Function} [options.filter] - Filter function to select data
+   * @returns {Promise&lt;void>}
+   */
+  async _propagateExistingData(fromHolon, toHolon, lensName, options = {}) {
+    const { mode = 'reference', filter = null } = options;
+    const existingData = await this.read(fromHolon, lensName, null, { resolveHolograms: false });
+    if (!existingData) return;
+    const items = Array.isArray(existingData) ? existingData : [existingData];
+    for (const item of items) {
+      // Skip holograms to avoid circular propagation
+      if (item.hologram === true) continue;
+      // Apply filter if provided
+      if (filter &amp;&amp; !filter(item)) continue;
+      await federation.propagateData(
+        this.client,
+        this.config.appName,
+        item,
+        fromHolon,
+        toHolon,
+        lensName,
+        mode
+      );
+    }
+  }
+  /**
+   * Gets federated data from a holon, optionally resolving holograms.
+   *
+   * @param {string} holonId - H3 cell ID for the holon
+   * @param {string} lensName - Name of the lens
+   * @param {Object} [options={}] - Options
+   * @param {boolean} [options.resolveHolograms=true] - Whether to resolve hologram references
+   * @returns {Promise&lt;Array|null>} Array of data objects or null
+   */
+  async getFederatedData(holonId, lensName, options = {}) {
+    const { resolveHolograms = true } = options;
+    const path = storage.buildPath(this.config.appName, holonId, lensName);
+    const data = await storage.readAll(this.client, path);
+    if (!data || !resolveHolograms) return data;
+    // Resolve holograms using existing method
+    return this._resolveHolograms(data);
+  }
+  /**
+   * Removes federation between two holons for a specific lens.
+   *
+   * @param {string} sourceHolon - Source holon H3 cell ID
+   * @param {string} targetHolon - Target holon H3 cell ID
+   * @param {string} lensName - Name of the lens
+   * @returns {Promise&lt;boolean>} Always returns true (idempotent operation)
+   */
+  async unfederate(sourceHolon, targetHolon, lensName) {
+    // Remove federation config for this relationship - idempotent
+    const configPath = storage.buildPath(this.config.appName, sourceHolon, lensName, '_federation');
+    try {
+      await storage.deleteData(this.client, configPath);
+    } catch (e) {
+      // Ignore errors - already unfederated or doesn't exist
+    }
+    return true;
+  }
+  /**
+   * Updates local override values on a hologram.
+   *
+   * @param {string} holonId - H3 cell ID where the hologram exists
+   * @param {string} lensName - Name of the lens
+   * @param {string} dataId - ID of the hologram
+   * @param {Object} overrides - Object containing local override values
+   * @returns {Promise&lt;boolean>} True if update succeeded
+   */
+  async updateHologramOverrides(holonId, lensName, dataId, overrides) {
+    return federation.updateHologramOverrides(
+      this.client,
+      this.config.appName,
+      holonId,
+      lensName,
+      dataId,
+      overrides
+    );
+  }
+  /**
+   * Creates a hologram (reference) object structure.
+   *
+   * @param {string} sourceHolon - Source holon H3 cell ID where the original data lives
+   * @param {string} lensName - Name of the lens
+   * @param {Object} data - Data object containing the id to reference
+   * @param {string} [targetHolon=null] - Target holon for the hologram, defaults to sourceHolon
+   * @returns {Object} Hologram object structure
+   */
+  createHologram(sourceHolon, lensName, data, targetHolon = null) {
+    return federation.createHologram(
+      sourceHolon,
+      targetHolon || sourceHolon,
+      lensName,
+      data.id,
+      this.config.appName
+    );
+  }
+  /**
+   * Gets all active holograms (references) pointing to a specific data item.
+   *
+   * @param {string} holonId - H3 cell ID of the source holon
+   * @param {string} lensName - Name of the lens
+   * @param {string} dataId - ID of the source data
+   * @returns {Promise&lt;Array>} Array of active hologram references
+   */
+  async getActiveHolograms(holonId, lensName, dataId) {
+    // Read the source data and return its activeHolograms list
+    const path = storage.buildPath(this.config.appName, holonId, lensName, dataId);
+    const sourceData = await storage.read(this.client, path);
+    if (!sourceData || !sourceData._meta || !sourceData._meta.activeHolograms) {
+      return [];
+    }
+    return sourceData._meta.activeHolograms;
+  }
+  /**
+   * Removes an active hologram reference from a source data item.
+   *
+   * @param {string} sourceHolon - Source holon H3 cell ID
+   * @param {string} lensName - Name of the lens
+   * @param {string} dataId - ID of the source data
+   * @param {string} targetHolon - Target holon where the hologram exists
+   * @returns {Promise&lt;boolean>} True if removal succeeded
+   */
+  async removeActiveHologram(sourceHolon, lensName, dataId, targetHolon) {
+    return federation.removeActiveHologram(
+      this.client,
+      this.config.appName,
+      sourceHolon,
+      lensName,
+      dataId,
+      targetHolon
+    );
+  }
+  /**
+   * Deletes a hologram and cleans up its references.
+   *
+   * @param {string} holonId - H3 cell ID where the hologram exists
+   * @param {string} lensName - Name of the lens
+   * @param {string} dataId - ID of the hologram to delete
+   * @param {Object} [options={}] - Delete options
+   * @returns {Promise&lt;boolean>} True if deletion succeeded
+   */
+  async deleteHologram(holonId, lensName, dataId, options = {}) {
+    return federation.deleteHologram(
+      this.client,
+      this.config.appName,
+      holonId,
+      lensName,
+      dataId,
+      options
+    );
+  }
+  /**
+   * Propagates data from source holon to target holon.
+   *
+   * @param {Object} data - Data to propagate
+   * @param {string} sourceHolon - Source holon H3 cell ID
+   * @param {string} targetHolon - Target holon H3 cell ID
+   * @param {string} lensName - Name of the lens
+   * @param {Object} [options={}] - Propagation options
+   * @param {string} [options.mode='reference'] - Mode: 'reference' creates hologram, 'copy' duplicates data
+   * @returns {Promise&lt;Object>} Result of propagation
+   */
+  async propagateData(data, sourceHolon, targetHolon, lensName, options = {}) {
+    // Extract mode from options, default to 'reference' for hologram creation
+    const mode = options.mode || 'reference';
+    return federation.propagateData(
+      this.client,
+      this.config.appName,
+      data,
+      sourceHolon,
+      targetHolon,
+      lensName,
+      mode
+    );
+  }
+  /**
+   * Resolves a hologram to its source data.
+   *
+   * @param {Object} hologram - Hologram object to resolve
+   * @param {Object} [options={}] - Resolution options
+   * @returns {Promise&lt;Object|null>} Resolved data or null if source not found
+   */
+  async resolveHologram(hologram, options = {}) {
+    return federation.resolveHologram(this.client, hologram, new Set(), [], { ...options, appname: this.config.appName });
+  }
+  /**
+   * Checks if an object is a hologram (unresolved reference).
+   *
+   * @param {Object} data - Data object to check
+   * @returns {boolean} True if the object is a hologram
+   */
+  isHologram(data) {
+    return federation.isHologram(data);
+  }
+  /**
+   * Checks if an object is a resolved hologram (has _hologram metadata).
+   *
+   * @param {Object} data - Data object to check
+   * @returns {boolean} True if the object is a resolved hologram
+   */
+  isResolvedHologram(data) {
+    return federation.isResolvedHologram(data);
+  }
+  /**
+   * Gets the source information from a hologram or resolved hologram.
+   *
+   * @param {Object} data - Hologram or resolved hologram object
+   * @returns {Object|null} Source information or null
+   */
+  getHologramSource(data) {
+    return federation.getHologramSource(data);
+  }
+  /**
+   * Cleans up circular hologram references in a holon.
+   *
+   * @param {string} holonId - H3 cell ID of the holon
+   * @param {string} lensName - Name of the lens
+   * @param {Object} [options={}] - Cleanup options
+   * @returns {Promise&lt;Object>} Cleanup results
+   */
+  async cleanupCircularHolograms(holonId, lensName, options = {}) {
+    return federation.cleanupCircularHolograms(
+      this.client,
+      this.config.appName,
+      holonId,
+      lensName,
+      options
+    );
+  }
+  /**
+   * Cleans up circular hologram references for specific data IDs.
+   *
+   * @param {string} holonId - H3 cell ID of the holon
+   * @param {string} lensName - Name of the lens
+   * @param {string[]} dataIds - Array of data IDs to check
+   * @param {Object} [options={}] - Cleanup options
+   * @returns {Promise&lt;Object>} Cleanup results
+   */
+  async cleanupCircularHologramsByIds(holonId, lensName, dataIds, options = {}) {
+    return federation.cleanupCircularHologramsByIds(
+      this.client,
+      this.config.appName,
+      holonId,
+      lensName,
+      dataIds,
+      options
+    );
+  }
+  /**
+   * Propagates data to all federated holons.
+   *
+   * @param {string} holonId - Source holon H3 cell ID
+   * @param {string} lensName - Name of the lens
+   * @param {Object} data - Data to propagate
+   * @param {Object} [options={}] - Propagation options
+   * @param {boolean} [options.useHolograms=true] - Whether to create holograms
+   * @param {boolean} [options.resolveExisting=true] - Whether to resolve existing data
+   * @returns {Promise&lt;Array|undefined>} Array of propagation results or undefined if no targets
+   */
+  async propagate(holonId, lensName, data, options = {}) {
+    const federationData = await this.getFederation(holonId);
+    // getFederation returns an object with federated array, not an array directly
+    const targets = federationData?.federated || federationData?.outbound || [];
+    if (!targets || targets.length === 0) return;
+    const { useHolograms = true, resolveExisting = true } = options;
+    const results = [];
+    for (const targetHolonId of targets) {
+      const result = await this.propagateData(
+        data,
+        holonId,
+        targetHolonId,
+        lensName,
+        { useHolograms, resolveExisting }
+      );
+      results.push({ parent: targetHolonId, ...result });
+    }
+    return results;
+  }
+  /**
+   * Gets the federation configuration for a holon.
+   *
+   * @param {string} holonId - H3 cell ID of the holon
+   * @returns {Promise&lt;Object|null>} Federation configuration object or null
+   * @throws {Error} If holonId is not provided
+   */
+  async getFederation(holonId) {
+    if (!holonId) {
+      throw new Error('getFederation: Missing holon ID');
+    }
+    const data = await this.readGlobal('federation', holonId);
+    if (!data) return null;
+    if (!Array.isArray(data.inbound)) data.inbound = [];
+    if (!Array.isArray(data.outbound)) data.outbound = [];
+    if (!data.lensConfig || typeof data.lensConfig !== 'object') data.lensConfig = {};
+    if (!data.partnerNames || typeof data.partnerNames !== 'object') data.partnerNames = {};
+    if (!Array.isArray(data.federated)) {
+      const allFederated = new Set([...data.inbound, ...data.outbound]);
+      data.federated = Array.from(allFederated);
+    }
+    return data;
+  }
+  /**
+   * Establishes a holon-level federation relationship.
+   *
+   * @param {string} sourceHolon - Source holon H3 cell ID
+   * @param {string} targetHolon - Target holon H3 cell ID
+   * @param {Object} [options={}] - Federation options
+   * @param {Object} [options.lensConfig] - Lens configuration for federation
+   * @param {string[]} [options.lensConfig.inbound] - Lenses for inbound federation
+   * @param {string[]} [options.lensConfig.outbound] - Lenses for outbound federation
+   * @param {string} [options.partnerName] - Human-readable name for the partner holon
+   * @param {boolean} [options.skipPropagation=false] - Skip propagating existing data
+   * @returns {Promise&lt;boolean>} True if federation was established
+   * @throws {Error} If trying to federate a holon with itself
+   */
+  async federateHolon(sourceHolon, targetHolon, options = {}) {
+    const { lensConfig = { inbound: [], outbound: [] }, partnerName = null, skipPropagation = false } = options;
+    if (sourceHolon === targetHolon) {
+      throw new Error('Cannot federate a holon with itself');
+    }
+    let federationData = await this.readGlobal('federation', sourceHolon) || {
+      id: sourceHolon,
+      name: sourceHolon,
+      federated: [],
+      inbound: [],
+      outbound: [],
+      lensConfig: {},
+      partnerNames: {},
+      timestamp: Date.now()
+    };
+    if (!Array.isArray(federationData.federated)) federationData.federated = [];
+    if (!Array.isArray(federationData.inbound)) federationData.inbound = [];
+    if (!Array.isArray(federationData.outbound)) federationData.outbound = [];
+    if (!federationData.lensConfig || typeof federationData.lensConfig !== 'object') federationData.lensConfig = {};
+    if (!federationData.partnerNames || typeof federationData.partnerNames !== 'object') federationData.partnerNames = {};
+    if (!federationData.federated.includes(targetHolon)) {
+      federationData.federated.push(targetHolon);
+    }
+    // Store the partner's name if provided
+    if (partnerName) {
+      federationData.partnerNames[targetHolon] = partnerName;
+    }
+    if (lensConfig.outbound &amp;&amp; lensConfig.outbound.length > 0) {
+      if (!federationData.outbound.includes(targetHolon)) {
+        federationData.outbound.push(targetHolon);
+      }
+    } else {
+      federationData.outbound = federationData.outbound.filter(id => id !== targetHolon);
+    }
+    if (lensConfig.inbound &amp;&amp; lensConfig.inbound.length > 0) {
+      if (!federationData.inbound.includes(targetHolon)) {
+        federationData.inbound.push(targetHolon);
+      }
+    } else {
+      federationData.inbound = federationData.inbound.filter(id => id !== targetHolon);
+    }
+    federationData.lensConfig[targetHolon] = {
+      inbound: lensConfig.inbound || [],
+      outbound: lensConfig.outbound || [],
+      timestamp: Date.now()
+    };
+    const success = await this.writeGlobal('federation', federationData);
+    this.clearCache('federation');
+    // Only propagate existing data if skipPropagation is false
+    if (success &amp;&amp; !skipPropagation) {
+      for (const lens of (lensConfig.inbound || [])) {
+        await this.federate(targetHolon, sourceHolon, lens, { direction: 'outbound', mode: 'reference' });
+      }
+      for (const lens of (lensConfig.outbound || [])) {
+        await this.federate(sourceHolon, targetHolon, lens, { direction: 'outbound', mode: 'reference' });
+      }
+    }
+    return success;
+  }
+  /**
+   * Removes a holon-level federation relationship.
+   *
+   * @param {string} sourceHolon - Source holon H3 cell ID
+   * @param {string} targetHolon - Target holon H3 cell ID
+   * @returns {Promise&lt;boolean>} True if unfederation succeeded, false if no federation existed
+   */
+  async unfederateHolon(sourceHolon, targetHolon) {
+    const federationData = await this.readGlobal('federation', sourceHolon);
+    if (!federationData) return false;
+    const lensConfig = federationData.lensConfig?.[targetHolon];
+    federationData.federated = (federationData.federated || []).filter(id => id !== targetHolon);
+    federationData.inbound = (federationData.inbound || []).filter(id => id !== targetHolon);
+    federationData.outbound = (federationData.outbound || []).filter(id => id !== targetHolon);
+    if (federationData.lensConfig) {
+      delete federationData.lensConfig[targetHolon];
+    }
+    const success = await this.writeGlobal('federation', federationData);
+    this.clearCache('federation');
+    if (success &amp;&amp; lensConfig) {
+      for (const lens of (lensConfig.inbound || [])) {
+        await this.unfederate(targetHolon, sourceHolon, lens);
+      }
+      for (const lens of (lensConfig.outbound || [])) {
+        await this.unfederate(sourceHolon, targetHolon, lens);
+      }
+    }
+    return success;
+  }
+  /**
+   * Gets the federation configuration between two holons.
+   *
+   * @param {string} sourceHolon - Source holon H3 cell ID
+   * @param {string} targetHolon - Target holon H3 cell ID
+   * @returns {Promise&lt;Object|null>} Lens configuration or null
+   */
+  async getFederatedConfig(sourceHolon, targetHolon) {
+    const federationData = await this.readGlobal('federation', sourceHolon);
+    if (!federationData || !federationData.lensConfig) return null;
+    return federationData.lensConfig[targetHolon] || null;
+  }
+  // === Hierarchical Operations ===
+  /**
+   * Performs hierarchical upcast aggregation.
+   * Aggregates data from child holons up to parent holons in the H3 hierarchy.
+   *
+   * @param {string} holonId - Starting holon H3 cell ID
+   * @param {string} lensName - Name of the lens
+   * @param {string} dataId - ID of the data to upcast
+   * @param {Object} [options={}] - Upcast options
+   * @returns {Promise&lt;Object>} Aggregation result
+   */
+  async upcast(holonId, lensName, dataId, options = {}) {
+    return hierarchical.upcast(this, holonId, lensName, dataId, options);
+  }
+  // === Subscriptions ===
+  /**
+   * Subscribes to real-time updates for a holon and lens.
+   *
+   * @param {string} holonId - H3 cell ID for the holon
+   * @param {string} lensName - Name of the lens
+   * @param {Function} callback - Callback function called with updated data
+   * @param {Object} [options={}] - Subscription options
+   * @returns {{unsubscribe: Function}} Subscription object with unsubscribe method
+   * @throws {TypeError} If callback is not a function
+   */
+  subscribe(holonId, lensName, callback, options = {}) {
+    if (typeof callback !== 'function') {
+      throw new TypeError('callback must be a function');
+    }
+    const path = storage.buildPath(this.config.appName, holonId, lensName);
+    const subscriptionOptions = { realtimeOnly: true, ...options };
+    const subscriptionId = `${holonId}-${lensName}-${Date.now()}-${Math.random().toString(36).substr(2, 9)}`;
+    let innerSubscription = null;
+    let unsubscribeCalled = false;
+    subscriptions.createSubscription(this.client, path, callback, subscriptionOptions)
+      .then(subscription => {
+        innerSubscription = subscription;
+        if (unsubscribeCalled) {
+          subscription.unsubscribe();
+        } else {
+          this.subscriptionRegistry.register(subscriptionId, subscription);
+        }
+      })
+      .catch(err => {
+        this._log('ERROR', 'Subscription setup failed', { path, error: err.message });
+      });
+    this._metrics.subscriptions = (this._metrics.subscriptions || 0) + 1;
+    return {
+      unsubscribe: () => {
+        unsubscribeCalled = true;
+        if (innerSubscription) {
+          this.subscriptionRegistry.unregister(subscriptionId);
+        }
+      }
+    };
+  }
+  /**
+   * Subscribes to real-time updates for a global table.
+   *
+   * @param {string} table - Name of the global table
+   * @param {string} key - Key to subscribe to
+   * @param {Function} callback - Callback function called with updated data
+   * @param {Object} [options={}] - Subscription options
+   * @returns {Promise&lt;{unsubscribe: Function}>} Subscription object
+   */
+  async subscribeGlobal(table, key, callback, options = {}) {
+    return globalTables.subscribeGlobal(
+      this.client,
+      this.config.appName,
+      table,
+      key,
+      callback,
+      options
+    );
+  }
+  // === Crypto Operations ===
+  /**
+   * Derives a public key from a private key.
+   *
+   * @param {string} privateKey - Hex-encoded private key
+   * @returns {Promise&lt;string>} Hex-encoded public key
+   */
+  async getPublicKey(privateKey) {
+    return crypto.getPublicKey(privateKey);
+  }
+  /**
+   * Signs content with a private key.
+   *
+   * @param {string|Object} content - Content to sign
+   * @param {string} privateKey - Hex-encoded private key
+   * @returns {Promise&lt;string>} Hex-encoded signature
+   */
+  async sign(content, privateKey) {
+    return crypto.sign(content, privateKey);
+  }
+  /**
+   * Verifies a signature against content and public key.
+   *
+   * @param {string|Object} content - Original content
+   * @param {string} signature - Hex-encoded signature
+   * @param {string} publicKey - Hex-encoded public key
+   * @returns {Promise&lt;boolean>} True if signature is valid
+   */
+  async verify(content, signature, publicKey) {
+    return crypto.verify(content, signature, publicKey);
+  }
+  /**
+   * Issues a capability token for authorization.
+   *
+   * @param {string[]} permissions - Array of permissions ('read', 'write', 'delete')
+   * @param {Object} scope - Scope of the capability (holonId, lensName, etc.)
+   * @param {string} recipient - Public key of the recipient
+   * @param {Object} [options] - Additional options
+   * @returns {Promise&lt;string>} Signed capability token
+   */
+  async issueCapability(permissions, scope, recipient, options) {
+    return crypto.issueCapability(permissions, scope, recipient, options);
+  }
+  /**
+   * Verifies a capability token.
+   *
+   * @param {string} token - Capability token to verify
+   * @param {string} requiredPermission - Required permission to check
+   * @param {Object} scope - Scope to verify against
+   * @returns {Promise&lt;boolean>} True if token is valid and has required permission
+   */
+  async verifyCapability(token, requiredPermission, scope) {
+    return crypto.verifyCapability(token, requiredPermission, scope);
+  }
+  // === Social Protocol Operations ===
+  /**
+   * Publishes a Nostr event to a holon.
+   *
+   * @param {Object} event - Nostr event object
+   * @param {number} event.kind - Event kind
+   * @param {string} event.content - Event content
+   * @param {Array} [event.tags] - Event tags
+   * @param {string} holonId - H3 cell ID for the holon
+   * @param {string} [lensName='social'] - Name of the lens
+   * @returns {Promise&lt;boolean>} True if publish succeeded
+   */
+  async publishNostr(event, holonId, lensName = 'social') {
+    // Validate Nostr event format
+    social.validateNostrEvent(event, true, true); // partial=true, throwOnError=true
+    const enrichedEvent = {
+      ...event,
+      tags: [...(event.tags || []), ['h', holonId], ['l', lensName]],
+    };
+    const signedEvent = nostrUtils.signEvent(enrichedEvent, this.client.privateKey);
+    // Add protocol field for querySocial filtering
+    const eventWithProtocol = {
+      ...signedEvent,
+      protocol: 'nostr',
+    };
+    const path = storage.buildPath(this.config.appName, holonId, lensName, signedEvent.id);
+    await storage.write(this.client, path, eventWithProtocol);
+    return true;
+  }
+  /**
+   * Publishes an ActivityPub object to a holon.
+   *
+   * @param {Object} object - ActivityPub object
+   * @param {string} object.type - ActivityPub type (Note, Article, etc.)
+   * @param {string} [object.actor] - Actor ID (defaults to client public key)
+   * @param {string} holonId - H3 cell ID for the holon
+   * @param {string} [lensName='social'] - Name of the lens
+   * @returns {Promise&lt;boolean>} True if publish succeeded
+   */
+  async publishActivityPub(object, holonId, lensName = 'social') {
+    // Validate ActivityPub object format
+    social.validateActivityPubObject(object, true); // throwOnError=true
+    const activity = social.transformActivityPubObject({
+      ...object,
+      actor: object.actor || this.client.publicKey,
+    });
+    return this.write(holonId, lensName, activity);
+  }
+  /**
+   * Queries social protocol data from a holon.
+   *
+   * @param {string} holonId - H3 cell ID for the holon
+   * @param {Object} [options={}] - Query options
+   * @param {string} [options.lens='social'] - Name of the lens
+   * @param {string} [options.protocol] - Filter by protocol ('nostr', 'activitypub', 'all')
+   * @param {string} [options.type] - Filter by content type
+   * @param {number} [options.since] - Filter events after this timestamp
+   * @param {number} [options.until] - Filter events before this timestamp
+   * @returns {Promise&lt;Array>} Array of matching social items
+   */
+  async querySocial(holonId, options = {}) {
+    const lensName = options.lens || 'social';
+    const data = await this.read(holonId, lensName);
+    if (!data) return [];
+    const items = Array.isArray(data) ? data : [data];
+    return items.filter(item => {
+      // 'all' means don't filter by protocol
+      if (options.protocol &amp;&amp; options.protocol !== 'all' &amp;&amp; item.protocol !== options.protocol) return false;
+      if (options.type &amp;&amp; item.type !== options.type) return false;
+      if (options.since &amp;&amp; item.created_at &lt; options.since) return false;
+      if (options.until &amp;&amp; item.created_at > options.until) return false;
+      return true;
+    });
+  }
+  /**
+   * Verifies a Nostr event signature.
+   *
+   * @param {Object} event - Nostr event to verify
+   * @param {string} event.id - Event ID
+   * @param {string} event.pubkey - Author public key
+   * @param {number} event.created_at - Creation timestamp
+   * @param {number} event.kind - Event kind
+   * @param {Array} event.tags - Event tags
+   * @param {string} event.content - Event content
+   * @param {string} event.sig - Event signature
+   * @returns {Promise&lt;boolean>} True if event signature is valid
+   */
+  async verifyNostrEvent(event) {
+    // Extract only standard Nostr event fields for verification
+    // (nostr-tools can't serialize events with extra properties like 'protocol')
+    const { id, pubkey, created_at, kind, tags, content, sig } = event;
+    const standardEvent = { id, pubkey, created_at, kind, tags, content, sig };
+    return nostrUtils.verifyEvent(standardEvent);
+  }
+  // === Metrics ===
+  /**
+   * Gets performance metrics for this HoloSphere instance.
+   *
+   * @returns {Object} Metrics object
+   * @returns {number} return.reads - Number of read operations
+   * @returns {number} return.writes - Number of write operations
+   * @returns {number} return.deletes - Number of delete operations
+   * @returns {number} return.federations - Number of federation operations
+   * @returns {number} return.subscriptions - Number of active subscriptions
+   * @returns {number} return.avgReadTime - Average read time in milliseconds
+   * @returns {number} return.avgWriteTime - Average write time in milliseconds
+   */
+  metrics() {
+    const reads = this._metrics.reads || 0;
+    const writes = this._metrics.writes || 0;
+    const totalReadTime = this._metrics.totalReadTime || 0;
+    const totalWriteTime = this._metrics.totalWriteTime || 0;
+    return {
+      reads,
+      writes,
+      deletes: this._metrics.deletes || 0,
+      federations: this._metrics.federations || 0,
+      subscriptions: this._metrics.subscriptions || 0,
+      avgReadTime: reads > 0 ? totalReadTime / reads : 0,
+      avgWriteTime: writes > 0 ? totalWriteTime / writes : 0,
+    };
+  }
+  // === Aliases ===
+  /**
+   * Alias for {@link HoloSphereBase#write}.
+   * @param {string} holonId - H3 cell ID for the holon
+   * @param {string} lensName - Name of the lens
+   * @param {Object} data - Data to write
+   * @param {Object} [options] - Write options
+   * @returns {Promise&lt;boolean>}
+   */
+  async put(holonId, lensName, data, options = {}) {
+    return this.write(holonId, lensName, data, options);
+  }
+  /**
+   * Alias for {@link HoloSphereBase#read}.
+   * @param {string} holonId - H3 cell ID for the holon
+   * @param {string} lensName - Name of the lens
+   * @param {string|null} [dataId] - Specific data ID or null
+   * @param {Object} [options] - Read options
+   * @returns {Promise&lt;Object|Array|null>}
+   */
+  async get(holonId, lensName, dataId = null, options = {}) {
+    return this.read(holonId, lensName, dataId, options);
+  }
+  /**
+   * Alias for {@link HoloSphereBase#delete}.
+   * @param {string} holonId - H3 cell ID for the holon
+   * @param {string} lensName - Name of the lens
+   * @param {string} dataId - Data ID to delete
+   * @param {Object} [options] - Delete options
+   * @returns {Promise&lt;boolean>}
+   */
+  async remove(holonId, lensName, dataId, options = {}) {
+    return this.delete(holonId, lensName, dataId, options);
+  }
+  /**
+   * Alias for {@link HoloSphereBase#writeGlobal}.
+   * @param {string} table - Global table name
+   * @param {Object} data - Data to write
+   * @returns {Promise&lt;boolean>}
+   */
+  async putGlobal(table, data) {
+    return this.writeGlobal(table, data);
+  }
+  /**
+   * Alias for {@link HoloSphereBase#readGlobal}.
+   * @param {string} table - Global table name
+   * @param {string|null} [key] - Key to read
+   * @returns {Promise&lt;Object|Array|null>}
+   */
+  async getGlobal(table, key = null) {
+    return this.readGlobal(table, key);
+  }
+  /**
+   * Alias for {@link HoloSphereBase#deleteGlobal}.
+   * @param {string} table - Global table name
+   * @param {string} key - Key to delete
+   * @returns {Promise&lt;boolean>}
+   */
+  async removeGlobal(table, key) {
+    return this.deleteGlobal(table, key);
+  }
+  /**
+   * Alias for {@link HoloSphereBase#setSchema}.
+   * @param {string} lensName - Lens name
+   * @param {Object|string} schemaObj - Schema object or URI
+   * @param {boolean} [strict] - Strict mode
+   * @returns {Promise&lt;void>}
+   */
+  async defineSchema(lensName, schemaObj, strict = false) {
+    return this.setSchema(lensName, schemaObj, strict);
+  }
+  /**
+   * Alias for {@link HoloSphereBase#getSchema}.
+   * @param {string} lensName - Lens name
+   * @returns {Promise&lt;Object|null>}
+   */
+  async fetchSchema(lensName) {
+    return this.getSchema(lensName);
+  }
+  /**
+   * Alias for {@link HoloSphereBase#clearSchema}.
+   * @param {string} lensName - Lens name
+   * @returns {Promise&lt;void>}
+   */
+  async removeSchema(lensName) {
+    return this.clearSchema(lensName);
+  }
+  /**
+   * Alias for {@link HoloSphereBase#write}.
+   * @param {string} holonId - H3 cell ID for the holon
+   * @param {string} lensName - Name of the lens
+   * @param {Object} data - Data to write
+   * @param {Object} [options] - Write options
+   * @returns {Promise&lt;boolean>}
+   */
+  async store(holonId, lensName, data, options = {}) {
+    return this.write(holonId, lensName, data, options);
+  }
+  /**
+   * Alias for {@link HoloSphereBase#read}.
+   * @param {string} holonId - H3 cell ID for the holon
+   * @param {string} lensName - Name of the lens
+   * @param {string|null} [dataId] - Specific data ID or null
+   * @param {Object} [options] - Read options
+   * @returns {Promise&lt;Object|Array|null>}
+   */
+  async fetch(holonId, lensName, dataId = null, options = {}) {
+    return this.read(holonId, lensName, dataId, options);
+  }
+  /**
+   * Alias for {@link HoloSphereBase#write}.
+   * @param {string} holonId - H3 cell ID for the holon
+   * @param {string} lensName - Name of the lens
+   * @param {Object} data - Data to write
+   * @param {Object} [options] - Write options
+   * @returns {Promise&lt;boolean>}
+   */
+  async save(holonId, lensName, data, options = {}) {
+    return this.write(holonId, lensName, data, options);
+  }
+  /**
+   * Alias for {@link HoloSphereBase#read}.
+   * @param {string} holonId - H3 cell ID for the holon
+   * @param {string} lensName - Name of the lens
+   * @param {string|null} [dataId] - Specific data ID or null
+   * @param {Object} [options] - Read options
+   * @returns {Promise&lt;Object|Array|null>}
+   */
+  async load(holonId, lensName, dataId = null, options = {}) {
+    return this.read(holonId, lensName, dataId, options);
+  }
+  // === Cache ===
+  /**
+   * Clears the internal cache.
+   *
+   * @param {string|null} [pattern=null] - If provided, only clear cache entries matching this pattern
+   */
+  clearCache(pattern = null) {
+    if (pattern) {
+      for (const key of this._cache.keys()) {
+        if (key.includes(pattern)) {
+          this._cache.delete(key);
+        }
+      }
+    } else {
+      this._cache.clear();
+    }
+  }
+}
+/**
+ * Main HoloSphere class - composed from base + all mixins
+ */
+export const HoloSphere = withContractMethods(
+  withFederationMethods(
+    withAIMethods(HoloSphereBase)
+  )
+);
+// Export error classes
+export { AuthorizationError };
+export { ValidationError };
+// Re-export AI module classes
+export {
+  LLMService,
+  SchemaExtractor,
+  JSONOps,
+  Embeddings,
+  Council,
+  TTS,
+  VOICES,
+  MODELS,
+  NLQuery,
+  Classifier,
+  SpatialAnalysis,
+  SmartAggregation,
+  FederationAdvisor,
+  RelationshipDiscovery,
+  TaskBreakdown,
+  H3AI,
+};
+// Re-export types and utilities
+export { spatial, storage, schema, federation, handshake, crypto, nostrUtils, social, subscriptions, hierarchical };
+// Re-export specific utilities used in tests
+export { matchScope } from './crypto/secp256k1.js';
+export { createHologram } from './federation/hologram.js';
+// Export AI factory function
+export { createAIServices } from './ai/index.js';
+// Export Contracts module classes for standalone use
+export {
+  ChainManager,
+  ContractDeployer,
+  HolonContracts,
+  ContractOperations,
+  ContractABIs,
+  EventListener,
+  ContractQueries,
+  SANKEY_EVENTS
+};
+// Export network utilities
+export {
+  NETWORKS,
+  getNetwork,
+  getNetworksByType,
+  listNetworks,
+  isNetworkSupported,
+  getTxUrl,
+  getAddressUrl
+} from './contracts/networks.js';
+// Export contracts namespace
+export { networks };
+// Default export for backward compatibility
+export default HoloSphere;
+</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>