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/federation_hologram.js.html ADDED Viewed

@@ -0,0 +1,1053 @@
+<!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: federation/hologram.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">federation_hologram.js</h1></header><article><pre class="prettyprint source lang-js"><code>/**
+ * @fileoverview Federation and Hologram (Reference) Management.
+ *
+ * Provides hologram (lightweight reference) creation, resolution, and management.
+ * Holograms enable data to appear in multiple holons while maintaining a single
+ * source of truth. Supports circular reference detection and cross-holosphere
+ * federation with capability-based access control.
+ *
+ * @module federation/hologram
+ */
+import { buildPath, write, read, update } from '../storage/unified-storage.js';
+import { verifyCapability } from '../crypto/secp256k1.js';
+import { getCapabilityForAuthor } from './registry.js';
+/** @constant {number} Maximum depth for hologram resolution chain */
+const MAX_RESOLUTION_DEPTH = 10;
+/**
+ * Check if creating a hologram would result in a circular reference
+ * This follows the chain from the source to see if it eventually points back to the target
+ * @param {Object} client - Nostr client instance
+ * @param {string} appname - Application namespace
+ * @param {string} sourceHolon - Source holon ID (where original data lives)
+ * @param {string} targetHolon - Target holon ID (where hologram would be created)
+ * @param {string} lensName - Lens name
+ * @param {string} dataId - Data ID
+ * @returns {Promise&lt;Object>} Result with { isCircular, chain }
+ */
+export async function wouldCreateCircularHologram(client, appname, sourceHolon, targetHolon, lensName, dataId) {
+  const visited = new Set();
+  const chain = [];
+  let currentHolon = sourceHolon;
+  let currentLens = lensName;
+  let currentDataId = dataId;
+  let currentAppname = appname;
+  // Follow the chain to see if we eventually reach targetHolon
+  while (visited.size &lt; MAX_RESOLUTION_DEPTH) {
+    const key = `${currentAppname}:${currentHolon}:${currentLens}:${currentDataId}`;
+    if (visited.has(key)) {
+      // Already visited this node - there's a cycle in the existing chain
+      return { isCircular: true, chain, reason: 'existing_cycle' };
+    }
+    visited.add(key);
+    chain.push({ holon: currentHolon, lens: currentLens, dataId: currentDataId });
+    // Check if current holon is our target - this would create a circular reference
+    if (currentHolon === targetHolon) {
+      return { isCircular: true, chain, reason: 'would_create_cycle' };
+    }
+    // Read the data at current location
+    const path = buildPath(currentAppname, currentHolon, currentLens, currentDataId);
+    const data = await read(client, path);
+    if (!data) {
+      // Data doesn't exist - no circular reference possible from this chain
+      return { isCircular: false, chain };
+    }
+    if (!data.hologram || !data.target) {
+      // Not a hologram - chain ends here, no circular reference
+      return { isCircular: false, chain };
+    }
+    // Follow the hologram to its target
+    currentAppname = data.target.appname || currentAppname;
+    currentHolon = data.target.holonId;
+    currentLens = data.target.lensName || currentLens;
+    currentDataId = data.target.dataId || currentDataId;
+  }
+  // Max depth reached - treat as potential circular to be safe
+  return { isCircular: true, chain, reason: 'max_depth_exceeded' };
+}
+/**
+ * Create a hologram (lightweight reference)
+ * @param {string} sourceHolon - Source holon ID
+ * @param {string} targetHolon - Target holon ID
+ * @param {string} lensName - Lens name
+ * @param {string} dataId - Data ID
+ * @param {string} appname - Application namespace
+ * @param {Object} options - Optional cross-holosphere settings
+ * @param {string} options.authorPubKey - Source author's public key (for cross-holosphere)
+ * @param {string} options.capability - Capability token (for cross-holosphere)
+ * @returns {Object} Hologram object
+ */
+export function createHologram(sourceHolon, targetHolon, lensName, dataId, appname, options = {}) {
+  const { authorPubKey = null, capability = null } = options;
+  const soul = buildPath(appname, sourceHolon, lensName, dataId);
+  const hologram = {
+    id: dataId,
+    hologram: true,
+    soul,
+    target: {
+      appname,
+      holonId: sourceHolon,
+      lensName,
+      dataId,
+    },
+    _meta: {
+      created: Date.now(),
+      sourceHolon,
+      source: sourceHolon,  // Alias for compatibility
+    },
+  };
+  // Cross-holosphere enhancements
+  if (authorPubKey) {
+    hologram.crossHolosphere = true;
+    hologram.target.authorPubKey = authorPubKey;
+    hologram._meta.sourcePubKey = authorPubKey;
+  }
+  if (capability) {
+    hologram.capability = capability;
+    hologram._meta.grantedAt = Date.now();
+  }
+  return hologram;
+}
+/**
+ * Resolve hologram to actual data, merging local overrides
+ * Supports cross-holosphere holograms with capability token verification
+ * @param {Object} client - Nostr client instance
+ * @param {Object} hologram - Hologram object
+ * @param {Set} visited - Visited souls (circular reference detection)
+ * @param {Array} chain - Chain of souls for debugging circular references
+ * @param {Object} options - Resolution options
+ * @param {string} options.appname - Application namespace (for registry lookup)
+ * @param {boolean} options.deleteCircular - If true, delete circular holograms when detected (default: true)
+ * @param {string} options.hologramPath - Path of the hologram being resolved (for deletion)
+ * @returns {Promise&lt;Object|null>} Resolved data with _hologram metadata, or null
+ */
+export async function resolveHologram(client, hologram, visited = new Set(), chain = [], options = {}) {
+  const { deleteCircular = true, hologramPath = null } = options;
+  if (!hologram || !hologram.hologram) {
+    return hologram; // Not a hologram, return as-is
+  }
+  const { soul } = hologram;
+  const target = hologram.target || {};
+  // Circular reference detection
+  if (visited.has(soul)) {
+    const chainStr = [...chain, soul].join(' → ');
+    console.warn(`🔄 Circular reference detected - removing hologram`);
+    console.warn(`   Soul: ${soul}`);
+    console.warn(`   Chain: ${chainStr}`);
+    console.warn(`   Source holon: ${target.holonId || 'unknown'}`);
+    console.warn(`   Lens: ${target.lensName || 'unknown'}`);
+    console.warn(`   Data ID: ${target.dataId || hologram.id || 'unknown'}`);
+    console.warn(`   Resolution depth: ${visited.size}`);
+    // Delete the circular hologram
+    if (deleteCircular &amp;&amp; hologramPath) {
+      console.info(`   🗑️ Deleting circular hologram at: ${hologramPath}`);
+      await write(client, hologramPath, null);
+    }
+    return null;
+  }
+  if (visited.size >= MAX_RESOLUTION_DEPTH) {
+    const chainStr = [...chain, soul].join(' → ');
+    console.warn(`⚠️ Max resolution depth (${MAX_RESOLUTION_DEPTH}) exceeded - removing hologram`);
+    console.warn(`   Current soul: ${soul}`);
+    console.warn(`   Chain: ${chainStr}`);
+    console.warn(`   Source holon: ${target.holonId || 'unknown'}`);
+    console.warn(`   Lens: ${target.lensName || 'unknown'}`);
+    // Delete the problematic hologram
+    if (deleteCircular &amp;&amp; hologramPath) {
+      console.info(`   🗑️ Deleting deep chain hologram at: ${hologramPath}`);
+      await write(client, hologramPath, null);
+    }
+    return null;
+  }
+  visited.add(soul);
+  chain.push(soul);
+  let sourceData;
+  // Handle cross-holosphere holograms
+  if (hologram.crossHolosphere &amp;&amp; target.authorPubKey) {
+    // Get capability - try embedded first, then registry fallback
+    let capability = hologram.capability;
+    if (!capability &amp;&amp; options.appname) {
+      // Fallback to registry lookup
+      const capEntry = await getCapabilityForAuthor(
+        client,
+        options.appname,
+        target.authorPubKey,
+        {
+          holonId: target.holonId,
+          lensName: target.lensName,
+          dataId: target.dataId,
+        }
+      );
+      if (capEntry) {
+        capability = capEntry.token;
+      }
+    }
+    // Verify capability before resolving
+    if (!capability) {
+      console.warn(`❌ Cross-holosphere hologram missing capability: ${soul}`);
+      return null;
+    }
+    const isValid = await verifyCapability(
+      capability,
+      'read',
+      {
+        holonId: target.holonId,
+        lensName: target.lensName,
+        dataId: target.dataId,
+      }
+    );
+    if (!isValid) {
+      console.warn(`❌ Capability verification failed for cross-holosphere hologram: ${soul}`);
+      return null;
+    }
+    // Read from federated source (different author)
+    sourceData = await read(client, soul, {
+      authors: [target.authorPubKey]
+    });
+  } else {
+    // Same-holosphere resolution (original behavior)
+    sourceData = await read(client, soul);
+  }
+  if (!sourceData) {
+    return null;
+  }
+  // If source data is also a hologram, recursively resolve
+  if (sourceData.hologram) {
+    // Pass the soul as the hologramPath so circular holograms can be deleted
+    return resolveHologram(client, sourceData, visited, chain, { ...options, hologramPath: soul });
+  }
+  // Merge hologram with source data
+  return mergeHologramWithSource(hologram, sourceData);
+}
+/**
+ * Merge hologram local overrides with source data
+ * @private
+ * @param {Object} hologram - Hologram object
+ * @param {Object} sourceData - Source data
+ * @returns {Object} Merged data with _hologram metadata
+ */
+function mergeHologramWithSource(hologram, sourceData) {
+  // Extract local overrides from the hologram (exclude hologram-specific fields)
+  const hologramOnlyFields = ['hologram', 'soul', 'target', '_meta', 'id', 'capability', 'crossHolosphere'];
+  const localOverrides = {};
+  const localOverrideKeys = [];
+  for (const key of Object.keys(hologram)) {
+    if (!hologramOnlyFields.includes(key)) {
+      localOverrides[key] = hologram[key];
+      localOverrideKeys.push(key);
+    }
+  }
+  // Merge: source data + local overrides + hologram metadata
+  const sourceHolon = hologram._meta?.sourceHolon || hologram._meta?.source || hologram.target?.holonId;
+  const resolved = {
+    ...sourceData,           // Original data from source
+    ...localOverrides,       // Local overrides (x, y, pinned, etc.)
+    _hologram: {
+      isHologram: true,
+      soul: hologram.soul,
+      sourceHolon: sourceHolon,
+      localOverrides: localOverrideKeys,
+      crossHolosphere: hologram.crossHolosphere || false,
+      sourcePubKey: hologram._meta?.sourcePubKey || null,
+    }
+  };
+  // Preserve original _meta and add source from hologram
+  if (sourceData._meta) {
+    resolved._meta = { ...sourceData._meta, source: sourceHolon };
+  } else {
+    resolved._meta = { source: sourceHolon };
+  }
+  return resolved;
+}
+/**
+ * Setup federation between holons
+ * @param {Object} client - Nostr client instance
+ * @param {string} appname - Application namespace
+ * @param {string} sourceHolon - Source holon ID
+ * @param {string} targetHolon - Target holon ID
+ * @param {string} lensName - Lens name
+ * @param {Object} options - Federation options
+ * @param {string} options.direction - 'inbound' or 'outbound'
+ * @param {string} options.mode - 'reference' or 'copy'
+ * @returns {Promise&lt;boolean>} Success indicator
+ */
+export async function setupFederation(
+  client,
+  appname,
+  sourceHolon,
+  targetHolon,
+  lensName,
+  options = {}
+) {
+  const { direction = 'outbound', mode = 'reference' } = options;
+  const federationConfig = {
+    sourceHolon,
+    targetHolon,
+    lensName,
+    direction,
+    mode,
+    created: Date.now(),
+  };
+  // Store federation config
+  const configPath = buildPath(appname, sourceHolon, lensName, '_federation');
+  return write(client, configPath, federationConfig);
+}
+/**
+ * Propagate data to federated location
+ * @param {Object} client - Nostr client instance
+ * @param {string} appname - Application namespace
+ * @param {Object} data - Data to propagate
+ * @param {string} sourceHolon - Source holon ID
+ * @param {string} targetHolon - Target holon ID
+ * @param {string} lensName - Lens name
+ * @param {string} mode - 'reference' or 'copy'
+ * @returns {Promise&lt;boolean>} Success indicator
+ */
+export async function propagateData(
+  client,
+  appname,
+  data,
+  sourceHolon,
+  targetHolon,
+  lensName,
+  mode = 'reference'
+) {
+  const dataId = data.id;
+  // Don't create hologram to the same holon - it would point to itself
+  if (sourceHolon === targetHolon) {
+    console.info(`⏭️ Skipping propagation - source and target are the same holon: ${sourceHolon}`);
+    return true;
+  }
+  // Don't propagate holograms back to avoid circular references
+  // If this data is already a hologram pointing to the target, skip it
+  if (data.hologram === true) {
+    // Check if this hologram would create a circular reference
+    if (data.target &amp;&amp; data.target.holonId === targetHolon) {
+      console.info(`🔄 Skipping propagation - would create circular reference:`);
+      console.info(`   Data ID: ${dataId}`);
+      console.info(`   Source holon: ${sourceHolon}`);
+      console.info(`   Target holon: ${targetHolon}`);
+      console.info(`   Hologram points to: ${data.target.holonId}`);
+      console.info(`   Lens: ${lensName}`);
+      console.info(`   Original soul: ${data.soul || 'unknown'}`);
+      return true;
+    }
+    // Check if targetHolon is already in the original source's activeHolograms
+    // This prevents creating duplicate holograms when the target already has one
+    if (data.target) {
+      const originalSourcePath = buildPath(
+        data.target.appname || appname,
+        data.target.holonId,
+        data.target.lensName || lensName,
+        data.target.dataId || dataId
+      );
+      const originalSource = await read(client, originalSourcePath);
+      if (originalSource?._meta?.activeHolograms) {
+        const alreadyHasHologram = originalSource._meta.activeHolograms.some(
+          h => h.targetHolon === targetHolon
+        );
+        if (alreadyHasHologram) {
+          console.info(`⏭️ Skipping propagation - target already in activeHolograms:`);
+          console.info(`   Data ID: ${dataId}`);
+          console.info(`   Original source: ${data.target.holonId}`);
+          console.info(`   Target holon: ${targetHolon}`);
+          return true;
+        }
+      }
+    }
+    // Deep circular check for hologram copy - ensure the original source doesn't eventually point to target
+    const originalSourceHolon = data.target.holonId;
+    const originalDataId = data.target.dataId || dataId;
+    const originalLens = data.target.lensName || lensName;
+    const originalAppname = data.target.appname || appname;
+    const circularCheck = await wouldCreateCircularHologram(
+      client, originalAppname, originalSourceHolon, targetHolon, originalLens, originalDataId
+    );
+    if (circularCheck.isCircular) {
+      const chainStr = circularCheck.chain.map(c => c.holon).join(' → ');
+      console.warn(`🔄 Preventing circular hologram copy:`);
+      console.warn(`   Data ID: ${dataId}`);
+      console.warn(`   Original source: ${originalSourceHolon}`);
+      console.warn(`   Would copy to: ${targetHolon}`);
+      console.warn(`   Existing chain: ${chainStr}`);
+      console.warn(`   Reason: ${circularCheck.reason}`);
+      return false;
+    }
+    // When propagating a hologram, copy it instead of creating a hologram of a hologram
+    // This maintains the reference to the original source
+    const targetPath = buildPath(appname, targetHolon, lensName, dataId);
+    const copiedHologram = {
+      ...data,
+      _meta: {
+        ...data._meta,
+        copiedFrom: sourceHolon,
+        copiedAt: Date.now()
+      }
+    };
+    const success = await write(client, targetPath, copiedHologram);
+    // Add this new location to the original source's activeHolograms
+    if (success &amp;&amp; data.target) {
+      await addActiveHologram(
+        client,
+        data.target.appname || appname,
+        data.target.holonId,
+        data.target.lensName || lensName,
+        data.target.dataId || dataId,
+        targetHolon
+      );
+      console.info(`📋 Copied hologram to ${targetHolon}:`);
+      console.info(`   Data ID: ${dataId}`);
+      console.info(`   Original source: ${data.target.holonId}`);
+      console.info(`   Copied from: ${sourceHolon}`);
+    }
+    return success;
+  }
+  // For non-hologram data, check if targetHolon is already in activeHolograms
+  if (mode === 'reference' &amp;&amp; data._meta?.activeHolograms) {
+    const alreadyHasHologram = data._meta.activeHolograms.some(
+      h => h.targetHolon === targetHolon
+    );
+    if (alreadyHasHologram) {
+      console.info(`⏭️ Skipping propagation - target already in activeHolograms:`);
+      console.info(`   Data ID: ${dataId}`);
+      console.info(`   Source holon: ${sourceHolon}`);
+      console.info(`   Target holon: ${targetHolon}`);
+      return true;
+    }
+  }
+  if (mode === 'reference') {
+    // Deep circular reference check - follow the chain from source to see if it would loop back
+    const circularCheck = await wouldCreateCircularHologram(
+      client, appname, sourceHolon, targetHolon, lensName, dataId
+    );
+    if (circularCheck.isCircular) {
+      const chainStr = circularCheck.chain.map(c => c.holon).join(' → ');
+      console.warn(`🔄 Preventing circular hologram creation:`);
+      console.warn(`   Data ID: ${dataId}`);
+      console.warn(`   Would create: ${sourceHolon} → ${targetHolon}`);
+      console.warn(`   Existing chain: ${chainStr}`);
+      console.warn(`   Reason: ${circularCheck.reason}`);
+      return false;
+    }
+    // Create hologram in target
+    const hologram = createHologram(sourceHolon, targetHolon, lensName, dataId, appname);
+    const targetPath = buildPath(appname, targetHolon, lensName, dataId);
+    const success = await write(client, targetPath, hologram);
+    // Add hologram to source data's _meta.activeHolograms for tracking
+    if (success) {
+      await addActiveHologram(client, appname, sourceHolon, lensName, dataId, targetHolon);
+    }
+    return success;
+  } else {
+    // Copy data to target
+    const targetPath = buildPath(appname, targetHolon, lensName, dataId);
+    return write(client, targetPath, { ...data, _meta: { ...data._meta, source: sourceHolon } });
+  }
+}
+/**
+ * Update local overrides on an existing hologram
+ * This allows storing holon-specific data (position, pinned status, etc.) on a hologram
+ * @param {Object} client - Nostr client instance
+ * @param {string} appname - Application namespace
+ * @param {string} holonId - Holon where the hologram lives
+ * @param {string} lensName - Lens name
+ * @param {string} dataId - Data ID
+ * @param {Object} overrides - Local override fields to set (e.g., { x: 100, y: 200, pinned: true })
+ * @returns {Promise&lt;boolean>} Success indicator
+ */
+export async function updateHologramOverrides(client, appname, holonId, lensName, dataId, overrides) {
+  const path = buildPath(appname, holonId, lensName, dataId);
+  // Read existing hologram
+  const existing = await read(client, path);
+  if (!existing) {
+    console.warn(`Hologram not found at ${path}`);
+    return false;
+  }
+  // Only update if it's actually a hologram
+  if (!existing.hologram) {
+    console.warn(`Data at ${path} is not a hologram, cannot update overrides`);
+    return false;
+  }
+  // Merge overrides into hologram (but don't allow overriding hologram-specific fields)
+  const protectedFields = ['hologram', 'soul', 'target', '_meta', 'id'];
+  const safeOverrides = {};
+  for (const [key, value] of Object.entries(overrides)) {
+    if (!protectedFields.includes(key)) {
+      safeOverrides[key] = value;
+    }
+  }
+  const updated = {
+    ...existing,
+    ...safeOverrides
+  };
+  return write(client, path, updated);
+}
+/**
+ * Check if data is a hologram (unresolved reference)
+ * @param {Object} data - Data to check
+ * @returns {boolean} True if data is an unresolved hologram
+ */
+export function isHologram(data) {
+  return data &amp;&amp; data.hologram === true;
+}
+/**
+ * Check if data was resolved from a hologram
+ * @param {Object} data - Data to check
+ * @returns {boolean} True if data was resolved from a hologram
+ */
+export function isResolvedHologram(data) {
+  return data &amp;&amp; data._hologram &amp;&amp; data._hologram.isHologram === true;
+}
+/**
+ * Get hologram source information from resolved data
+ * @param {Object} data - Resolved data
+ * @returns {Object|null} Source info { soul, sourceHolon, localOverrides } or null
+ */
+export function getHologramSource(data) {
+  if (!isResolvedHologram(data)) {
+    return null;
+  }
+  return {
+    soul: data._hologram.soul,
+    sourceHolon: data._hologram.sourceHolon,
+    localOverrides: data._hologram.localOverrides || []
+  };
+}
+/**
+ * Add a hologram reference to the source data's _meta.activeHolograms
+ * This tracks all holograms pointing to this specific data item
+ * If the source is itself a hologram, follows the chain to find the real source
+ * @param {Object} client - Nostr client instance
+ * @param {string} appname - Application namespace
+ * @param {string} sourceHolon - Source holon ID (where original data lives)
+ * @param {string} lensName - Lens name
+ * @param {string} dataId - Data ID
+ * @param {string} targetHolon - Target holon ID (where hologram lives)
+ * @returns {Promise&lt;boolean>} Success indicator
+ */
+export async function addActiveHologram(client, appname, sourceHolon, lensName, dataId, targetHolon) {
+  let currentAppname = appname;
+  let currentHolon = sourceHolon;
+  let currentLens = lensName;
+  let currentDataId = dataId;
+  let sourcePath = buildPath(currentAppname, currentHolon, currentLens, currentDataId);
+  // Read existing source data
+  let sourceData = await read(client, sourcePath);
+  if (!sourceData) {
+    console.warn(`Source data not found at ${sourcePath}`);
+    return false;
+  }
+  // If source is a hologram, follow the chain to find the real source
+  // This ensures activeHolograms is always tracked on the actual data, not on holograms
+  let depth = 0;
+  const maxDepth = 10;
+  while (sourceData.hologram === true &amp;&amp; sourceData.target &amp;&amp; depth &lt; maxDepth) {
+    depth++;
+    currentAppname = sourceData.target.appname || currentAppname;
+    currentHolon = sourceData.target.holonId;
+    currentLens = sourceData.target.lensName || currentLens;
+    currentDataId = sourceData.target.dataId || currentDataId;
+    sourcePath = buildPath(currentAppname, currentHolon, currentLens, currentDataId);
+    sourceData = await read(client, sourcePath);
+    if (!sourceData) {
+      console.warn(`Real source data not found at ${sourcePath}`);
+      return false;
+    }
+  }
+  if (depth > 0) {
+    console.info(`📍 Followed hologram chain (depth: ${depth}) to real source: ${currentHolon}/${currentLens}/${currentDataId}`);
+  }
+  // Initialize _meta and activeHolograms if needed
+  if (!sourceData._meta) {
+    sourceData._meta = {};
+  }
+  if (!Array.isArray(sourceData._meta.activeHolograms)) {
+    sourceData._meta.activeHolograms = [];
+  }
+  const now = Date.now();
+  // Check if this hologram already exists
+  const existingIndex = sourceData._meta.activeHolograms.findIndex(
+    h => h.targetHolon === targetHolon
+  );
+  if (existingIndex >= 0) {
+    // Update existing entry
+    sourceData._meta.activeHolograms[existingIndex].lastUpdated = now;
+  } else {
+    // Add new entry
+    sourceData._meta.activeHolograms.push({
+      targetHolon,
+      created: now,
+      lastUpdated: now
+    });
+  }
+  // Write to the real source path (not the original one if we followed a chain)
+  return write(client, sourcePath, sourceData);
+}
+/**
+ * Remove a hologram reference from the source data's _meta.activeHolograms
+ * If the source is itself a hologram, follows the chain to find the real source
+ * @param {Object} client - Nostr client instance
+ * @param {string} appname - Application namespace
+ * @param {string} sourceHolon - Source holon ID
+ * @param {string} lensName - Lens name
+ * @param {string} dataId - Data ID
+ * @param {string} targetHolon - Target holon ID
+ * @returns {Promise&lt;boolean>} Success indicator
+ */
+export async function removeActiveHologram(client, appname, sourceHolon, lensName, dataId, targetHolon) {
+  let currentAppname = appname;
+  let currentHolon = sourceHolon;
+  let currentLens = lensName;
+  let currentDataId = dataId;
+  let sourcePath = buildPath(currentAppname, currentHolon, currentLens, currentDataId);
+  // Read existing source data
+  let sourceData = await read(client, sourcePath);
+  if (!sourceData) {
+    return false;
+  }
+  // If source is a hologram, follow the chain to find the real source
+  let depth = 0;
+  const maxDepth = 10;
+  while (sourceData.hologram === true &amp;&amp; sourceData.target &amp;&amp; depth &lt; maxDepth) {
+    depth++;
+    currentAppname = sourceData.target.appname || currentAppname;
+    currentHolon = sourceData.target.holonId;
+    currentLens = sourceData.target.lensName || currentLens;
+    currentDataId = sourceData.target.dataId || currentDataId;
+    sourcePath = buildPath(currentAppname, currentHolon, currentLens, currentDataId);
+    sourceData = await read(client, sourcePath);
+    if (!sourceData) {
+      return false;
+    }
+  }
+  if (!sourceData._meta || !Array.isArray(sourceData._meta.activeHolograms)) {
+    return false;
+  }
+  const initialLength = sourceData._meta.activeHolograms.length;
+  sourceData._meta.activeHolograms = sourceData._meta.activeHolograms.filter(
+    h => h.targetHolon !== targetHolon
+  );
+  // Only write if something changed
+  if (sourceData._meta.activeHolograms.length &lt; initialLength) {
+    return write(client, sourcePath, sourceData);
+  }
+  return false;
+}
+/**
+ * Refresh lastUpdated timestamps on all activeHolograms in source data
+ * Also updates the hologram objects in target holons
+ * Called when source data is updated
+ * @param {Object} client - Nostr client instance
+ * @param {string} appname - Application namespace
+ * @param {string} sourceHolon - Source holon ID
+ * @param {string} lensName - Lens name
+ * @param {string} dataId - Data ID that was updated
+ * @param {Object} sourceData - The source data object (already read, to avoid re-reading)
+ * @returns {Promise&lt;Object>} Result with refreshed count
+ */
+export async function refreshActiveHolograms(client, appname, sourceHolon, lensName, dataId, sourceData = null) {
+  // Read source data if not provided
+  if (!sourceData) {
+    const sourcePath = buildPath(appname, sourceHolon, lensName, dataId);
+    sourceData = await read(client, sourcePath);
+  }
+  if (!sourceData || !sourceData._meta || !Array.isArray(sourceData._meta.activeHolograms)) {
+    return { refreshed: 0, holograms: [] };
+  }
+  const now = Date.now();
+  const refreshed = [];
+  // Update timestamps on all activeHolograms
+  for (const hologramEntry of sourceData._meta.activeHolograms) {
+    hologramEntry.lastUpdated = now;
+    // Also update the hologram itself in the target holon
+    const hologramPath = buildPath(appname, hologramEntry.targetHolon, lensName, dataId);
+    const hologram = await read(client, hologramPath);
+    if (hologram &amp;&amp; hologram.hologram === true) {
+      // Update hologram's _meta.lastUpdated
+      if (!hologram._meta) hologram._meta = {};
+      hologram._meta.lastUpdated = now;
+      await write(client, hologramPath, hologram);
+      refreshed.push({
+        targetHolon: hologramEntry.targetHolon,
+        dataId,
+        timestamp: now
+      });
+    }
+  }
+  // Source data's activeHolograms timestamps are updated in-place
+  // The caller should save sourceData if needed
+  return { refreshed: refreshed.length, holograms: refreshed, sourceData };
+}
+/**
+ * Delete a hologram and clean up the activeHolograms list on the original source
+ * @param {Object} client - Nostr client instance
+ * @param {string} appname - Application namespace
+ * @param {string} holonId - Holon where the hologram lives (to be deleted from)
+ * @param {string} lensName - Lens name
+ * @param {string} dataId - Data ID of the hologram
+ * @param {Object} options - Optional settings
+ * @param {boolean} options.deleteData - If true, actually delete the data (default: true)
+ * @returns {Promise&lt;Object>} Result with deletion info
+ */
+export async function deleteHologram(client, appname, holonId, lensName, dataId, options = {}) {
+  const { deleteData = true } = options;
+  const path = buildPath(appname, holonId, lensName, dataId);
+  const result = {
+    success: false,
+    wasHologram: false,
+    sourceHolon: null,
+    activeHologramsUpdated: false,
+    error: null
+  };
+  try {
+    // Read the hologram to get source information
+    const hologram = await read(client, path);
+    if (!hologram) {
+      console.warn(`🗑️ Hologram not found at ${path}`);
+      result.error = 'Hologram not found';
+      return result;
+    }
+    // Check if it's actually a hologram
+    if (hologram.hologram === true &amp;&amp; hologram.target) {
+      result.wasHologram = true;
+      result.sourceHolon = hologram.target.holonId;
+      console.info(`🗑️ Deleting hologram:`);
+      console.info(`   Path: ${path}`);
+      console.info(`   Data ID: ${dataId}`);
+      console.info(`   From holon: ${holonId}`);
+      console.info(`   Source holon: ${hologram.target.holonId}`);
+      console.info(`   Lens: ${lensName}`);
+      // Remove from source's activeHolograms list
+      const removed = await removeActiveHologram(
+        client,
+        hologram.target.appname || appname,
+        hologram.target.holonId,
+        hologram.target.lensName || lensName,
+        hologram.target.dataId || dataId,
+        holonId
+      );
+      result.activeHologramsUpdated = removed;
+      if (removed) {
+        console.info(`   ✓ Removed from activeHolograms on source`);
+      } else {
+        console.warn(`   ⚠️ Could not update activeHolograms on source (may already be removed)`);
+      }
+    } else {
+      console.info(`🗑️ Deleting non-hologram data at ${path}`);
+    }
+    // Delete the hologram data if requested
+    if (deleteData) {
+      // Write null to delete (or use a delete function if available)
+      const deleted = await write(client, path, null);
+      result.success = deleted;
+      if (deleted) {
+        console.info(`   ✓ Hologram deleted successfully`);
+      } else {
+        console.warn(`   ⚠️ Failed to delete hologram data`);
+        result.error = 'Failed to delete hologram data';
+      }
+    } else {
+      result.success = true;
+    }
+    return result;
+  } catch (error) {
+    console.error(`❌ Error deleting hologram at ${path}:`, error);
+    result.error = error.message || 'Unknown error';
+    return result;
+  }
+}
+/**
+ * Cleanup circular holograms in a holon's lens
+ * This detects and removes holograms that create circular references (A→B→A)
+ * Useful for cleaning up existing bad data created before circular reference prevention was added
+ * @param {Object} client - Nostr client instance
+ * @param {string} appname - Application namespace
+ * @param {string} holonId - Holon to clean up
+ * @param {string} lensName - Lens name to check
+ * @param {Object} options - Optional settings
+ * @param {boolean} options.dryRun - If true, only report what would be deleted (default: false)
+ * @returns {Promise&lt;Object>} Result with cleanup info
+ */
+export async function cleanupCircularHolograms(client, appname, holonId, lensName, options = {}) {
+  const { dryRun = false } = options;
+  const result = {
+    scanned: 0,
+    circularFound: 0,
+    deleted: 0,
+    errors: [],
+    details: []
+  };
+  console.info(`🧹 ${dryRun ? '[DRY RUN] ' : ''}Cleaning up circular holograms in ${holonId}/${lensName}...`);
+  try {
+    // Get all data in this lens
+    const basePath = buildPath(appname, holonId, lensName);
+    // We need to iterate through all items - this requires listing capability
+    // For now, we'll rely on the caller to provide a list of IDs to check
+    // or we can use a different approach
+    // Alternative: Read the lens index if it exists
+    const lensIndexPath = buildPath(appname, holonId, lensName, '_index');
+    const lensIndex = await read(client, lensIndexPath);
+    if (!lensIndex || !Array.isArray(lensIndex.items)) {
+      console.warn(`   No index found for ${holonId}/${lensName}, cannot scan for circular references`);
+      console.info(`   Tip: Provide specific IDs to check using cleanupCircularHologramsByIds()`);
+      return result;
+    }
+    for (const itemId of lensIndex.items) {
+      result.scanned++;
+      const itemPath = buildPath(appname, holonId, lensName, itemId);
+      const item = await read(client, itemPath);
+      if (!item || item.hologram !== true || !item.target) {
+        continue; // Not a hologram, skip
+      }
+      // This is a hologram - check if it creates a circular reference
+      const sourceHolon = item.target.holonId;
+      const sourceDataId = item.target.dataId || itemId;
+      const sourceLens = item.target.lensName || lensName;
+      // Read the source data
+      const sourcePath = buildPath(item.target.appname || appname, sourceHolon, sourceLens, sourceDataId);
+      const sourceData = await read(client, sourcePath);
+      if (sourceData &amp;&amp; sourceData.hologram === true &amp;&amp; sourceData.target) {
+        // Source is also a hologram - check if it points back
+        if (sourceData.target.holonId === holonId) {
+          result.circularFound++;
+          const detail = {
+            itemId,
+            path: itemPath,
+            pointsTo: `${sourceHolon}/${sourceLens}/${sourceDataId}`,
+            circularWith: `${sourceData.target.holonId}/${sourceData.target.lensName}/${sourceData.target.dataId}`
+          };
+          result.details.push(detail);
+          console.warn(`   🔄 Found circular hologram:`);
+          console.warn(`      ${holonId}/${lensName}/${itemId} → ${sourceHolon}/${sourceLens}/${sourceDataId} → ${holonId}`);
+          if (!dryRun) {
+            // Delete this hologram
+            const deleteResult = await deleteHologram(client, appname, holonId, lensName, itemId);
+            if (deleteResult.success) {
+              result.deleted++;
+              console.info(`      ✓ Deleted circular hologram`);
+            } else {
+              result.errors.push({ itemId, error: deleteResult.error });
+              console.error(`      ❌ Failed to delete: ${deleteResult.error}`);
+            }
+          }
+        }
+      }
+    }
+    console.info(`🧹 Cleanup complete for ${holonId}/${lensName}:`);
+    console.info(`   Scanned: ${result.scanned}`);
+    console.info(`   Circular found: ${result.circularFound}`);
+    console.info(`   Deleted: ${result.deleted}`);
+    if (result.errors.length > 0) {
+      console.warn(`   Errors: ${result.errors.length}`);
+    }
+    return result;
+  } catch (error) {
+    console.error(`❌ Error during cleanup:`, error);
+    result.errors.push({ error: error.message });
+    return result;
+  }
+}
+/**
+ * Cleanup circular holograms for a specific list of IDs
+ * Use this when you don't have an index but know which IDs to check
+ * @param {Object} client - Nostr client instance
+ * @param {string} appname - Application namespace
+ * @param {string} holonId - Holon to clean up
+ * @param {string} lensName - Lens name
+ * @param {string[]} dataIds - Array of data IDs to check
+ * @param {Object} options - Optional settings
+ * @param {boolean} options.dryRun - If true, only report what would be deleted
+ * @returns {Promise&lt;Object>} Result with cleanup info
+ */
+export async function cleanupCircularHologramsByIds(client, appname, holonId, lensName, dataIds, options = {}) {
+  const { dryRun = false } = options;
+  const result = {
+    scanned: 0,
+    circularFound: 0,
+    deleted: 0,
+    errors: [],
+    details: []
+  };
+  console.info(`🧹 ${dryRun ? '[DRY RUN] ' : ''}Cleaning up circular holograms for ${dataIds.length} IDs in ${holonId}/${lensName}...`);
+  for (const itemId of dataIds) {
+    result.scanned++;
+    const itemPath = buildPath(appname, holonId, lensName, itemId);
+    const item = await read(client, itemPath);
+    if (!item || item.hologram !== true || !item.target) {
+      continue; // Not a hologram, skip
+    }
+    // This is a hologram - check if it creates a circular reference
+    const sourceHolon = item.target.holonId;
+    const sourceDataId = item.target.dataId || itemId;
+    const sourceLens = item.target.lensName || lensName;
+    // Read the source data
+    const sourcePath = buildPath(item.target.appname || appname, sourceHolon, sourceLens, sourceDataId);
+    const sourceData = await read(client, sourcePath);
+    if (sourceData &amp;&amp; sourceData.hologram === true &amp;&amp; sourceData.target) {
+      // Source is also a hologram - check if it points back
+      if (sourceData.target.holonId === holonId) {
+        result.circularFound++;
+        const detail = {
+          itemId,
+          path: itemPath,
+          pointsTo: `${sourceHolon}/${sourceLens}/${sourceDataId}`,
+          circularWith: `${sourceData.target.holonId}/${sourceData.target.lensName}/${sourceData.target.dataId}`
+        };
+        result.details.push(detail);
+        console.warn(`   🔄 Found circular hologram: ${itemId}`);
+        console.warn(`      Chain: ${holonId} → ${sourceHolon} → ${holonId}`);
+        if (!dryRun) {
+          // Delete this hologram
+          const deleteResult = await deleteHologram(client, appname, holonId, lensName, itemId);
+          if (deleteResult.success) {
+            result.deleted++;
+            console.info(`      ✓ Deleted`);
+          } else {
+            result.errors.push({ itemId, error: deleteResult.error });
+            console.error(`      ❌ Failed: ${deleteResult.error}`);
+          }
+        }
+      }
+    }
+  }
+  console.info(`🧹 Cleanup complete: scanned=${result.scanned}, circular=${result.circularFound}, deleted=${result.deleted}`);
+  return result;
+}
+</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>