content-addressed blob storage: blob_storage.py, memory, local, and S3 adapters

src/kontextual_engine/__init__.py

@@ -12,6 +12,9 @@ from .artifacts import (
     content_digest,
 )
 from .adapters.memory import InMemoryAssetRegistryRepository
+from .adapters.memory import InMemoryBlobStorage
+from .adapters.local_files import LocalBlobStorage
+from .adapters.s3 import S3BlobStorage
 from .adapters.sqlite import SQLiteAssetRegistryRepository
 from .api import ServiceRuntime, create_app
 from .context import ContextAssembler, ContextItem, ContextPackage
@@ -98,6 +101,10 @@ from .ingestion import IngestionRequest, IngestionResult, IngestionService
 from .ports import (
     AllowAllPolicyGateway,
     AssetRegistryRepository,
+    BlobCleanupResult,
+    BlobRef,
+    BlobStorage,
+    BlobWriteResult,
     DirectorySourceConnector,
     FormatExtractor,
     PolicyGateway,
@@ -122,6 +129,9 @@ from .services import (
     RelationshipQueryItem,
     RelationshipQueryRequest,
     RelationshipQueryResult,
+    RepresentationContentResult,
+    RepresentationContentStream,
+    RepresentationContentService,
     RetrievalFeedbackRequest,
     RetrievalFeedbackResult,
     RetrievalQualityMetrics,
@@ -168,6 +178,10 @@ __all__ = [
     "AssetRegistryRepository",
     "AssetRegistryService",
     "AssetRetrievalService",
+    "BlobCleanupResult",
+    "BlobRef",
+    "BlobStorage",
+    "BlobWriteResult",
     "AssetVersion",
     "AuditEvent",
     "AuditOutcome",
@@ -202,6 +216,7 @@ __all__ = [
     "ExtractorCapability",
     "FormatExtractor",
     "InMemoryAssetRegistryRepository",
+    "InMemoryBlobStorage",
     "InMemoryKnowledgeRepository",
     "IngestionRequest",
     "IngestionResult",
@@ -217,6 +232,7 @@ __all__ = [
     "KontextualError",
     "LexicalIndexRefreshResult",
     "LifecycleState",
+    "LocalBlobStorage",
     "MetadataFieldDefinition",
     "MetadataRecord",
     "MetadataSchema",
@@ -240,6 +256,9 @@ __all__ = [
     "RelationshipQueryItem",
     "RelationshipQueryRequest",
     "RelationshipQueryResult",
+    "RepresentationContentResult",
+    "RepresentationContentStream",
+    "RepresentationContentService",
     "RelationshipTargetKind",
     "RelationshipType",
     "RepresentationKind",
@@ -256,6 +275,7 @@ __all__ = [
     "SourceReference",
     "SourceConnector",
     "SourcePayload",
+    "S3BlobStorage",
     "SQLiteAssetRegistryRepository",
     "TransformationExecutionContext",
     "TransformationOperation",