agmem 0.1.6__py3-none-any.whl → 0.2.0__py3-none-any.whl

{agmem-0.1.6.dist-info → agmem-0.2.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: agmem
-Version: 0.1.6
+Version: 0.2.0
 Summary: Agentic Memory Version Control System - Git for AI agent memories
 Home-page: https://github.com/vivek-tiwari-vt/agmem
 Author: agmem Team
@@ -10,7 +10,7 @@ Project-URL: Homepage, https://github.com/vivek-tiwari-vt/agmem
 Project-URL: Documentation, https://github.com/vivek-tiwari-vt/agmem#readme
 Project-URL: Repository, https://github.com/vivek-tiwari-vt/agmem
 Project-URL: Bug Tracker, https://github.com/vivek-tiwari-vt/agmem/issues
-Keywords: ai,agent,memory,version-control,git,vcs,llm,merkle,audit,encryption,differential-privacy,trust,multi-agent
+Keywords: ai,agent,memory,version-control,git,vcs,llm,merkle,audit,encryption,differential-privacy,trust,multi-agent,health-monitoring,delta-encoding,ipfs,federated
 Classifier: Development Status :: 3 - Alpha
 Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
@@ -71,6 +71,10 @@ Provides-Extra: ipfs
 Requires-Dist: requests>=2.28.0; extra == "ipfs"
 Provides-Extra: ipfs-daemon
 Requires-Dist: ipfshttpclient>=0.8.0; extra == "ipfs-daemon"
+Provides-Extra: coordinator
+Requires-Dist: fastapi>=0.100.0; extra == "coordinator"
+Requires-Dist: uvicorn[standard]>=0.22.0; extra == "coordinator"
+Requires-Dist: pydantic>=2.0.0; extra == "coordinator"
 Provides-Extra: all
 Requires-Dist: mcp>=1.0.0; extra == "all"
 Requires-Dist: cryptography>=41.0.0; extra == "all"
@@ -88,6 +92,7 @@ Requires-Dist: networkx>=3.0; extra == "all"
 Requires-Dist: tiktoken>=0.5.0; extra == "all"
 Requires-Dist: presidio-analyzer>=2.2.0; extra == "all"
 Requires-Dist: requests>=2.28.0; extra == "all"
+Requires-Dist: pydantic>=2.0.0; extra == "all"
 Dynamic: author
 Dynamic: home-page
 Dynamic: license-file
@@ -137,8 +142,9 @@ agmem solves all of these problems with a familiar Git-like interface.
 - ✅ **Multi-provider LLM** — OpenAI and Anthropic via `memvcs.core.llm`; config/repo or env; used by gardener, distiller, consistency, merge
 - ✅ **Temporal querying** — Point-in-time and range queries in temporal index; frontmatter timestamps
 - ✅ **Federated collaboration** — `agmem federated push|pull`; real summaries (topic counts, fact hashes); optional DP on outbound; coordinator API in docs/FEDERATED.md
-- ✅ **Zero-knowledge proofs** — `agmem prove` (hash/signature-based): keyword containment (Merkle set membership), memory freshness (signed timestamp)
-- ✅ **Daemon health** — Periodic Merkle verification in daemon loop; safe auto-remediation hooks
+- ✅ **Zero-knowledge proofs** — `agmem prove` (hash/signature-based): keyword containment (Merkle set membership), memory freshness (signed timestamp). **Note:** Current implementation is proof-of-knowledge with known limitations; see docs for migration to true zk-SNARKs.
+- ✅ **Daemon health** — 4-point health monitoring (storage, redundancy, staleness, graph consistency) with periodic checks; visible warnings and JSON reports
+- ✅ **Delta encoding** — 5-10x compression for similar objects using Levenshtein distance and SequenceMatcher; optional feature in pack files
 - ✅ **GPU acceleration** — Vector store detects GPU for embedding model when available
 - ✅ **Optional** — `serve`, `daemon` (watch + auto-commit), `garden` (episode archival), MCP server; install extras as needed
 
@@ -469,8 +475,8 @@ The following 18 capabilities are implemented (or stubbed) per the agmem feature
 
 | # | Feature | Description |
 |---|---------|-------------|
-| **7** | **Differential privacy** | Epsilon/delta budget per repo in `.mem/privacy_budget.json`. **Usage:** `agmem distill --private`, `agmem garden --private`; blocks when budget exceeded. Config: `differential_privacy.max_epsilon`, `delta`. |
-| **8** | **Zero-knowledge proofs** | zk-SNARK-style proofs for keyword containment and memory freshness. **Command:** `agmem prove --memory <path> --property keyword|freshness --value <v> [-o out]` (stub). |
+| **7** | **Differential privacy** | Epsilon/delta budget per repo in `.mem/privacy_budget.json`. **Usage:** `agmem distill --private`, `agmem garden --private`; blocks when budget exceeded. Config: `differential_privacy.max_epsilon`, `delta`. **Note:** Now correctly applied to actual facts during extraction, not metadata counts. |
+| **8** | **Cryptographic proofs (proof-of-knowledge)** | Hash/signature-based proofs for keyword containment (Merkle set membership) and memory freshness (signed timestamp). **Command:** `agmem prove --memory <path> --property keyword\|freshness --value <v> [-o out]`. **IMPORTANT:** These are proof-of-knowledge, not true zero-knowledge proofs. Keyword proof leaks word count and allows verifier to test other words. Freshness proof relies on forgeable filesystem mtime. See `memvcs/core/zk_proofs.py` for details and migration path to zk-SNARKs. |
 
 ### Tier 4 — Storage and distribution
 

{agmem-0.1.6.dist-info → agmem-0.2.0.dist-info}/RECORD

@@ -1,4 +1,4 @@
-agmem-0.1.6.dist-info/licenses/LICENSE,sha256=X_S6RBErW-F0IDbM3FAEoDB-zxExFnl2m8640rTXphM,1067
+agmem-0.2.0.dist-info/licenses/LICENSE,sha256=X_S6RBErW-F0IDbM3FAEoDB-zxExFnl2m8640rTXphM,1067
 memvcs/__init__.py,sha256=pheWPxubHVcp2N6vk6M7hGXgkJQ06KajbWgCpOlUSJ8,193
 memvcs/cli.py,sha256=YF06oMNjKWUmiNahILmfjrIXgoXzU-5BJFmbunSb8Sc,6075
 memvcs/commands/__init__.py,sha256=A2D6xWaO6epU7iV4QSvqvF5TspnwRyDN7NojmGatPrE,510
@@ -11,10 +11,10 @@ memvcs/commands/checkout.py,sha256=xaYZSbCQ-MyLWPtwA2FdH6WqGMI3oF3R2JmCufGBVFg,3
 memvcs/commands/clean.py,sha256=e0OhSQdHfFnOPTRbyKbM8IcX4yJD5n_kaBKjIeoaRBo,1973
 memvcs/commands/clone.py,sha256=aB0LcugIWJE9IEez6y70KlpZu4eIF2EdXZxE24jXyac,3260
 memvcs/commands/commit.py,sha256=W4ulVZuEETJh1SHpscaQfNjyQMqeIE0AYZIbMbTrsq4,6801
-memvcs/commands/daemon.py,sha256=fV6aIz8bFP9VwB_MLudAb_lhhhBxSe2aV-Wjqe-nvPw,10708
+memvcs/commands/daemon.py,sha256=FlPBh41v-S__QhC68FzRYbsumARQgLbP2904k7jaZ6k,12522
 memvcs/commands/decay.py,sha256=QcgOTMJZxrfw_AOz94YHA3LGoNXRMDn69TxWlUrpSw4,2421
 memvcs/commands/diff.py,sha256=KcgD57_fae4uvQ8G9ZbXmLpAYYIDiWiBuVcjsDtyE1U,5480
-memvcs/commands/distill.py,sha256=reOldqg0lMgqIlpYEIKYfN_TxNwsjU9RnI8Uah1VqTQ,3088
+memvcs/commands/distill.py,sha256=eO9n2KxBaIhdvKBnqcrgYH5aoJ7dR5C2WNge_z6ITlw,3330
 memvcs/commands/federated.py,sha256=Zj4kxHnjdIs1xu4v7B8XosQXNYK8Alv4I0kJQpmJe6Y,1840
 memvcs/commands/fsck.py,sha256=AdJBMLA2myQ0cJJcjUgsYptsE3qvX4JQc9UAwVmSHlA,7772
 memvcs/commands/garden.py,sha256=8JiLe3JRkOhY-N-h-IDuvdJiECiSElnUzXVtxtU2QgY,4050
@@ -46,6 +46,8 @@ memvcs/commands/timeline.py,sha256=JkuhsQ-6wPWbsjlbJb_qM4mEkxkxcWWzniXXQB4Qtec,4
 memvcs/commands/tree.py,sha256=vdULq4vIXA_4gNfMnHn_Y78BwE0sJoeTBOnFJR3WsZ4,4927
 memvcs/commands/verify.py,sha256=04CVW5NYWkUlPJ5z1Kci6dfQFM6UmPTGZh9ZextFLMc,3887
 memvcs/commands/when.py,sha256=bxG_tEYnZNBTl2IPkoxpc2LUEbO_5ev1hRvEzxQQDmc,4773
+memvcs/coordinator/__init__.py,sha256=XJEXEXJFvvhtRInPeyAC9bFNXGbshSrtuK6wZo3wS6g,139
+memvcs/coordinator/server.py,sha256=-kCEyqUi7eLC45qqkH1KCk8zZk8T1NdJyffOY8133ec,7045
 memvcs/core/__init__.py,sha256=dkIC-4tS0GhwV2mZIbofEe8xR8uiFwrxslGf1aXwhYg,493
 memvcs/core/access_index.py,sha256=HhacnzSUASzRV2jhDHkwRFoPS3rtqh9n9yE1VV7JXpk,5596
 memvcs/core/audit.py,sha256=8APkm9Spl_-1rIdyRQz1elyxOeK3nlpwm0CLkpLlhTE,3732
@@ -55,8 +57,9 @@ memvcs/core/consistency.py,sha256=YOG8xhqZLKZCLbai2rdcP0KxYPNGFv5RRMwrQ6qCeyc,74
 memvcs/core/constants.py,sha256=WUjAb50BFcF0mbFi_GNteDLCxLihmViBm9Fb-JMPmbM,220
 memvcs/core/crypto_verify.py,sha256=DTuC7Kfx6z2b8UWOWziBTqP633LrjXbdtGmBBqrJTF0,10424
 memvcs/core/decay.py,sha256=ROGwnqngs7eJNkbKmwyOdij607m73vpmoJqzrIDLBzk,6581
+memvcs/core/delta.py,sha256=obXzojUSc2HaEUqH3L_1LF-GcJ63Wr_yYvIPM8iyeSg,7865
 memvcs/core/diff.py,sha256=koEHTLciIUxYKVJVuvmY0GDXMgDgGZP_qg5RayhF-iE,13226
-memvcs/core/distiller.py,sha256=ZOmrwYYhOla8rZncQP_0y0Ab9jCl3GjtdoH82HkXlsw,12621
+memvcs/core/distiller.py,sha256=QA4acLc005cLac09IvIaog1fJt5IGXWRiSdZq_Ya27g,14086
 memvcs/core/encryption.py,sha256=epny_nlW6ylllv1qxs1mAcFq-PrLIisgfot4llOoAqw,5289
 memvcs/core/federated.py,sha256=vUYMZ0xv80hqGDRKq645Od1i8N33l-pIAkklJbJUlVg,5445
 memvcs/core/gardener.py,sha256=lBWkyE72O-JMiHM-oqrnex9k_xSv7FvztjkOdLdB0Kk,18610
@@ -65,11 +68,11 @@ memvcs/core/ipfs_remote.py,sha256=xmEO14bn_7Ej-W5jhx2QJyBd-ljj9S2COOxMmcZBiTs,66
 memvcs/core/knowledge_graph.py,sha256=GY27e1rgraF2zMpz_jsumdUtpgTRk48yH5CAEQ3TDl4,16416
 memvcs/core/merge.py,sha256=x2eSaxr4f63Eq00FCJ6DDe2TZU8H5yHQpzKzMhYsaFw,19871
 memvcs/core/objects.py,sha256=Xgw1IpQnJLCG5o_7gDHVQ-TNGR9CSpDYWRXzLgLSuec,11006
-memvcs/core/pack.py,sha256=nTzpPNNk47e7_oN3z7bjaichpzI7q-ql2E8eI2UuGyM,9828
+memvcs/core/pack.py,sha256=Kq0hyMNroT0MwiS4pVJVuJO9nZ04P3wssep2tADvnpQ,15950
 memvcs/core/pii_scanner.py,sha256=T6gQ1APFrSDk980fjnv4ZMF-UztbJgmUFSwGrwWixEw,10802
 memvcs/core/privacy_budget.py,sha256=fOPlxoKEAmsKtda-OJCrSaKjTyw7ekcqdN7KfRBw1CY,2113
 memvcs/core/refs.py,sha256=4Nx2ZVRa_DzfUZ4O1AwzOHEjoGAEICJKqSd9GxaiD_g,16754
-memvcs/core/remote.py,sha256=1PINc6qYBIHRkNLMS8MLWM5DJIrX81uIfRrV6fXwwro,19495
+memvcs/core/remote.py,sha256=sZbAO9JEaDJM96PylB0CjpmR5UxWYdoXlq86sj3R2gU,22228
 memvcs/core/repository.py,sha256=NzC2UFPv6ePxi5lfiSKyZFLclH4bJpWJz88pY7tDiv4,20605
 memvcs/core/schema.py,sha256=_CrEWCdArc0yDJ04GT7fyvjHqkal7gegdFSsFOjVpBc,15287
 memvcs/core/staging.py,sha256=dptdGi_74lhDkcGqGVU39ZyTkb25j-Rnkz0GWi83W1k,7221
@@ -77,7 +80,7 @@ memvcs/core/temporal_index.py,sha256=81hZHlVElp2UpXjseFVCdDUwxGM45zIU-y1dDlOhFHI
 memvcs/core/test_runner.py,sha256=7-0jCvji63JRbVfy3LNQWIQ7VL5weulOoG7SY1-YJbw,11496
 memvcs/core/trust.py,sha256=msx80Cl3bxyQTY8mFUKWY9P6l3zb1s8FafympgHwtpo,3494
 memvcs/core/vector_store.py,sha256=yUAp5BlaAtjkrtsdY1I-vmAp_YIFgJykBoNlp5hcg0I,11063
-memvcs/core/zk_proofs.py,sha256=j9AyHucYe9tOSrlxDeUMGgpRHMvNFOl8s4Q0AQHLKP0,5514
+memvcs/core/zk_proofs.py,sha256=tvJnj5oLTNQ_wFIGcMuuVF5faigIX_32U_HojNMoNp0,7623
 memvcs/core/llm/__init__.py,sha256=vnjtE9Xlv9a2pZV88DMT9JaINkZ30hC9VLPL5lJRlps,236
 memvcs/core/llm/anthropic_provider.py,sha256=O1eaCb9r464ajLJz-Gy8lGxBie5ojRUZ_5HdgRXO5KY,1540
 memvcs/core/llm/base.py,sha256=qPzg3KPAMeoyWGc_2JoVR4-plpdft5Rc2g9uO-Z4fJQ,623
@@ -88,6 +91,8 @@ memvcs/core/storage/base.py,sha256=IK4To8Cb-LHv5ltlaQLdB6LE-69euFK3hNqBtMCe7-g,9
 memvcs/core/storage/gcs.py,sha256=-cWuGw1jkFh-Xig-Abmwr9HGwjW5lWQJuF2xcAR1l78,10632
 memvcs/core/storage/local.py,sha256=JAik9nta6RMe4mD7aMtgdFi8M4iZCeTqiP8pPisaO6U,6028
 memvcs/core/storage/s3.py,sha256=tY5rfz8FfkRRNaHOPX7Wk6yXdBBBhKV0Ju2qnBtHxeU,13814
+memvcs/health/__init__.py,sha256=YuxF8hVHJHNilAvVa0maptFLBWm4hcBymMjpA2dFJVU,546
+memvcs/health/monitor.py,sha256=2JQqkR6n0e5L-gsU97FEB3rxjrCNAaGRNFpa7LKZtOg,15545
 memvcs/integrations/__init__.py,sha256=hVtJoFaXt6ErAZwctcSBDZLXRHFs1CNgtltIBQiroQ0,103
 memvcs/integrations/mcp_server.py,sha256=PxBYJnbzPs6bcFH6EmH5jQqbu_9Vy5eSAA8ruWTn2Q4,9061
 memvcs/integrations/web_ui/__init__.py,sha256=MQIfgDKDgPctlcTUjwkwueS_MDsDssVRmIUnpECGS0k,51
@@ -99,8 +104,8 @@ memvcs/retrieval/recaller.py,sha256=8KY-XjMUz5_vcKf46zI64uk1DEM__u7wM92ShukOtsY,
 memvcs/retrieval/strategies.py,sha256=26yxQQubQfjxWQXknfVMxuzPHf2EcZxJg_B99BEdl5c,11458
 memvcs/utils/__init__.py,sha256=8psUzz4Ntv2GzbRebkeVsoyC6Ck-FIwi0_lfYdj5oho,185
 memvcs/utils/helpers.py,sha256=37zg_DcQ2y99b9NSLqxFkglHe13rJXKhFDpEbQ7iLhM,4121
-agmem-0.1.6.dist-info/METADATA,sha256=5Pwa47IVpid1YYz60_uGxR1xz_uzPJ6HmYVPnv1v3P4,41042
-agmem-0.1.6.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-agmem-0.1.6.dist-info/entry_points.txt,sha256=at7eWycgjqOo1wbUMECnXUsNo3gpCkJTU71OzrGLHu0,42
-agmem-0.1.6.dist-info/top_level.txt,sha256=HtMMsKuwLKLOdgF1GxqQztqFM54tTJctVdJuOec6B-4,7
-agmem-0.1.6.dist-info/RECORD,,
+agmem-0.2.0.dist-info/METADATA,sha256=Oh9LOeoQR_A9ZXrdrkt-sTFoiYA-peWVHvpVaUYncns,42100
+agmem-0.2.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+agmem-0.2.0.dist-info/entry_points.txt,sha256=at7eWycgjqOo1wbUMECnXUsNo3gpCkJTU71OzrGLHu0,42
+agmem-0.2.0.dist-info/top_level.txt,sha256=HtMMsKuwLKLOdgF1GxqQztqFM54tTJctVdJuOec6B-4,7
+agmem-0.2.0.dist-info/RECORD,,

memvcs/commands/daemon.py

@@ -227,11 +227,12 @@ class DaemonCommand:
             while running:
                 time.sleep(1)
 
-                # Periodic health check (Merkle/signature, optional). Alert only; no destructive action.
+                # Periodic health check (Merkle/signature + operational metrics). Alert only; no destructive action.
                 if (
                     health_check_interval
                     and (time.time() - last_health_check) >= health_check_interval
                 ):
+                    # Cryptographic integrity check
                     try:
                         from ..core.crypto_verify import verify_commit, load_public_key
 
@@ -251,6 +252,41 @@ class DaemonCommand:
                                     sys.stderr.write("Run 'agmem fsck' for safe integrity check.\n")
                     except Exception:
                         pass
+
+                    # Operational health checks (storage, redundancy, stale memory, graph consistency)
+                    try:
+                        from ..health.monitor import HealthMonitor
+
+                        health_monitor = HealthMonitor(repo.root)
+                        report = health_monitor.perform_all_checks()
+
+                        if report.get("warnings"):
+                            for warning in report["warnings"]:
+                                sys.stderr.write(f"Health warning: {warning}\n")
+
+                        # Log summary metrics
+                        if report.get("storage"):
+                            storage = report["storage"]
+                            if "total_size_mb" in storage:
+                                sys.stderr.write(
+                                    f"Storage: {storage['total_size_mb']:.1f}MB "
+                                    f"({storage['packed_objects']} packed objects)\n"
+                                )
+                        if report.get("redundancy"):
+                            red = report["redundancy"]
+                            if "redundancy_percentage" in red:
+                                sys.stderr.write(
+                                    f"Redundancy: {red['redundancy_percentage']:.1f}%\n"
+                                )
+                        if report.get("stale_memory"):
+                            stale = report["stale_memory"]
+                            if "stale_percentage" in stale:
+                                sys.stderr.write(
+                                    f"Stale memory: {stale['stale_percentage']:.1f}%\n"
+                                )
+                    except Exception:
+                        pass
+
                     last_health_check = time.time()
 
                 if handler.pending:

memvcs/commands/distill.py

@@ -46,6 +46,11 @@ class DistillCommand:
             action="store_true",
             help="Use differential privacy (spend epsilon from budget)",
         )
+        parser.add_argument(
+            "--no-compress",
+            action="store_true",
+            help="Disable compression pipeline preprocessing",
+        )
 
     @staticmethod
     def execute(args) -> int:
@@ -73,6 +78,7 @@ class DistillCommand:
             source_dir=args.source,
             target_dir=args.target,
             create_safety_branch=not args.no_branch,
+            use_compression_pipeline=not getattr(args, "no_compress", False),
             use_dp=use_dp,
             dp_epsilon=dp_epsilon,
             dp_delta=dp_delta,

memvcs/coordinator/__init__.py

@@ -0,0 +1,5 @@
+"""Coordinator package for federated collaboration."""
+
+from .server import app, FASTAPI_AVAILABLE
+
+__all__ = ["app", "FASTAPI_AVAILABLE"]

memvcs/coordinator/server.py

@@ -0,0 +1,223 @@
+"""
+Minimal Federated Coordinator Server for agmem.
+
+Implements the coordinator API from docs/FEDERATED.md:
+- POST /push: Accept agent summaries
+- GET /pull: Return merged summaries
+
+This is a reference implementation. For production:
+- Add authentication (API keys, OAuth)
+- Use persistent storage (PostgreSQL, Redis)
+- Add rate limiting
+- Enable HTTPS
+- Scale horizontally
+
+Install: pip install "agmem[coordinator]"
+Run: uvicorn memvcs.coordinator.server:app --host 0.0.0.0 --port 8000
+"""
+
+from datetime import datetime, timezone
+from typing import Dict, List, Optional, Any
+from pathlib import Path
+import json
+import hashlib
+
+try:
+    from fastapi import FastAPI, HTTPException, Request
+    from fastapi.responses import JSONResponse
+    from pydantic import BaseModel, Field
+
+    FASTAPI_AVAILABLE = True
+except ImportError:
+    FASTAPI_AVAILABLE = False
+
+    # Stub for when FastAPI not installed
+    class BaseModel:
+        pass
+
+    def Field(*args, **kwargs):
+        return None
+
+
+# Storage: In-memory for simplicity (use Redis/PostgreSQL for production)
+summaries_store: Dict[str, List[Dict[str, Any]]] = {}
+metadata_store: Dict[str, Any] = {
+    "coordinator_version": "0.1.6",
+    "started_at": datetime.now(timezone.utc).isoformat(),
+    "total_pushes": 0,
+    "total_agents": 0,
+}
+
+
+class AgentSummary(BaseModel):
+    """Agent summary for federated push."""
+
+    agent_id: str = Field(..., description="Unique agent identifier")
+    timestamp: str = Field(..., description="ISO 8601 timestamp")
+    topic_counts: Dict[str, int] = Field(default_factory=dict, description="Topic -> count")
+    fact_hashes: List[str] = Field(default_factory=list, description="SHA-256 hashes of facts")
+    metadata: Optional[Dict[str, Any]] = Field(default=None, description="Optional metadata")
+
+
+class PushRequest(BaseModel):
+    """Request body for /push endpoint."""
+
+    summary: AgentSummary
+
+
+class PullResponse(BaseModel):
+    """Response body for /pull endpoint."""
+
+    merged_topic_counts: Dict[str, int]
+    unique_fact_hashes: List[str]
+    contributing_agents: int
+    last_updated: str
+    metadata: Optional[Dict[str, Any]] = None
+
+
+if FASTAPI_AVAILABLE:
+    app = FastAPI(
+        title="agmem Federated Coordinator",
+        description="Minimal coordinator for federated agent memory collaboration",
+        version="0.1.6",
+    )
+
+    @app.get("/")
+    async def root():
+        """Health check and API info."""
+        return {
+            "service": "agmem-coordinator",
+            "version": metadata_store["coordinator_version"],
+            "status": "running",
+            "endpoints": {
+                "push": "POST /push",
+                "pull": "GET /pull",
+                "health": "GET /health",
+            },
+            "started_at": metadata_store["started_at"],
+            "total_pushes": metadata_store["total_pushes"],
+            "total_agents": metadata_store["total_agents"],
+        }
+
+    @app.get("/health")
+    async def health():
+        """Health check endpoint."""
+        return {
+            "status": "healthy",
+            "timestamp": datetime.now(timezone.utc).isoformat(),
+        }
+
+    @app.post("/push", response_model=Dict[str, Any])
+    async def push(request: PushRequest):
+        """
+        Accept agent summary and store it.
+
+        Returns:
+            Confirmation with push timestamp
+        """
+        summary = request.summary
+
+        # Validate timestamp
+        try:
+            datetime.fromisoformat(summary.timestamp.replace("Z", "+00:00"))
+        except ValueError:
+            raise HTTPException(
+                status_code=400, detail="Invalid timestamp format (expected ISO 8601)"
+            )
+
+        # Store summary by agent_id
+        if summary.agent_id not in summaries_store:
+            summaries_store[summary.agent_id] = []
+            metadata_store["total_agents"] += 1
+
+        summaries_store[summary.agent_id].append(summary.dict())
+        metadata_store["total_pushes"] += 1
+
+        return {
+            "status": "accepted",
+            "agent_id": summary.agent_id,
+            "timestamp": datetime.now(timezone.utc).isoformat(),
+            "message": f"Summary from {summary.agent_id} stored successfully",
+        }
+
+    @app.get("/pull", response_model=PullResponse)
+    async def pull():
+        """
+        Return merged summaries from all agents.
+
+        Returns:
+            Aggregated topic counts, unique fact hashes, contributing agent count
+        """
+        if not summaries_store:
+            return PullResponse(
+                merged_topic_counts={},
+                unique_fact_hashes=[],
+                contributing_agents=0,
+                last_updated=datetime.now(timezone.utc).isoformat(),
+            )
+
+        # Merge topic counts across all agents
+        merged_topics: Dict[str, int] = {}
+        all_fact_hashes = set()
+        latest_timestamp = None
+
+        for agent_id, summaries in summaries_store.items():
+            for summary in summaries:
+                # Aggregate topic counts
+                for topic, count in summary.get("topic_counts", {}).items():
+                    merged_topics[topic] = merged_topics.get(topic, 0) + count
+
+                # Collect unique fact hashes
+                for fact_hash in summary.get("fact_hashes", []):
+                    all_fact_hashes.add(fact_hash)
+
+                # Track latest update
+                ts = summary.get("timestamp")
+                if ts:
+                    if latest_timestamp is None or ts > latest_timestamp:
+                        latest_timestamp = ts
+
+        return PullResponse(
+            merged_topic_counts=merged_topics,
+            unique_fact_hashes=sorted(list(all_fact_hashes)),
+            contributing_agents=len(summaries_store),
+            last_updated=latest_timestamp or datetime.now(timezone.utc).isoformat(),
+            metadata={
+                "total_facts": len(all_fact_hashes),
+                "total_topics": len(merged_topics),
+            },
+        )
+
+    @app.delete("/admin/reset")
+    async def admin_reset(request: Request):
+        """
+        Admin endpoint to reset all stored data.
+        In production, protect this with authentication!
+        """
+        summaries_store.clear()
+        metadata_store["total_pushes"] = 0
+        metadata_store["total_agents"] = 0
+        metadata_store["started_at"] = datetime.now(timezone.utc).isoformat()
+
+        return {
+            "status": "reset",
+            "timestamp": datetime.now(timezone.utc).isoformat(),
+        }
+
+else:
+    # Stub when FastAPI not available
+    app = None
+    print("FastAPI not available. Install with: pip install 'agmem[coordinator]'")
+
+
+if __name__ == "__main__":
+    if not FASTAPI_AVAILABLE:
+        print("Error: FastAPI not installed")
+        print("Install with: pip install 'fastapi[all]' uvicorn")
+        exit(1)
+
+    import uvicorn
+
+    print("Starting agmem Federated Coordinator...")
+    print("API docs: http://localhost:8000/docs")
+    uvicorn.run(app, host="0.0.0.0", port=8000)