aether-cache 0.1.5__tar.gz → 0.1.6__tar.gz

{aether_cache-0.1.5 → aether_cache-0.1.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: aether-cache
-Version: 0.1.5
+Version: 0.1.6
 Summary: Shared memory for AI coding tools that stays true to your code.
 Project-URL: Homepage, https://anishchugh05.github.io/Aether-Cache-Redis-Compatible-Vector-Store/
 Project-URL: Repository, https://github.com/anishchugh05/Aether-Cache-Redis-Compatible-Vector-Store
@@ -13,12 +13,14 @@ Requires-Dist: mcp>=1.2
 Requires-Dist: redis>=5.0
 Description-Content-Type: text/markdown
 
-[![progress-banner](https://backend.codecrafters.io/progress/redis/f43a7cd3-11e6-45dc-a8ba-9d6690c73ac0)](https://app.codecrafters.io/users/anishchugh05?r=2qF)
+[![Aether Cache: memory that stays true to your code](https://anishchugh05.github.io/Aether-Cache-Redis-Compatible-Vector-Store/assets/og-image.png)](https://anishchugh05.github.io/Aether-Cache-Redis-Compatible-Vector-Store/)
 
 # Aether Cache
 
 **Shared memory for AI coding tools that stays true to your code.**
 
+<!-- mcp-name: io.github.anishchugh05/aether-cache -->
+
 **[Website](https://anishchugh05.github.io/Aether-Cache-Redis-Compatible-Vector-Store/)** · **[PyPI](https://pypi.org/project/aether-cache/)**
 
 Claude Code, Cursor, and other AI tools each forget your project between sessions, and when they do remember things,
@@ -63,7 +65,14 @@ other tools ─┘   (Python: embeddings,│          memories, HNSW vector inde
 
 ## What it looks like
 
-A memory linked to a file, the file changes, and the next lookup catches it:
+The dashboard (`aether-cache ui`): memories whose files changed wait for a decision, with the file versions side by side.
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://anishchugh05.github.io/Aether-Cache-Redis-Compatible-Vector-Store/assets/dashboard-dark.png">
+  <img alt="The Aether Cache dashboard showing stale memories and a possible conflict" src="https://anishchugh05.github.io/Aether-Cache-Redis-Compatible-Vector-Store/assets/dashboard-light.png">
+</picture>
+
+And from your AI tool's side, a memory linked to a file, the file changes, and the next lookup catches it:
 
 ```
 > remember("The database runs Postgres via docker compose", files=["docker-compose.yml"])
@@ -203,6 +212,8 @@ A Redis-compatible server written from scratch in Java. It speaks RESP, so `redi
 [CodeCrafters "Build Your Own Redis"](https://codecrafters.io/challenges/redis) challenge; the vector index,
 persistence hardening, and the memory layer are my own additions.
 
+[![progress-banner](https://backend.codecrafters.io/progress/redis/f43a7cd3-11e6-45dc-a8ba-9d6690c73ac0)](https://app.codecrafters.io/users/anishchugh05?r=2qF)
+
 ### Throughput vs. official Redis
 
 `redis-benchmark -t set,get`, 100K requests, 50 parallel clients, 3-byte values, same machine:

{aether_cache-0.1.5 → aether_cache-0.1.6}/README.md

@@ -1,9 +1,11 @@
-[![progress-banner](https://backend.codecrafters.io/progress/redis/f43a7cd3-11e6-45dc-a8ba-9d6690c73ac0)](https://app.codecrafters.io/users/anishchugh05?r=2qF)
+[![Aether Cache: memory that stays true to your code](https://anishchugh05.github.io/Aether-Cache-Redis-Compatible-Vector-Store/assets/og-image.png)](https://anishchugh05.github.io/Aether-Cache-Redis-Compatible-Vector-Store/)
 
 # Aether Cache
 
 **Shared memory for AI coding tools that stays true to your code.**
 
+<!-- mcp-name: io.github.anishchugh05/aether-cache -->
+
 **[Website](https://anishchugh05.github.io/Aether-Cache-Redis-Compatible-Vector-Store/)** · **[PyPI](https://pypi.org/project/aether-cache/)**
 
 Claude Code, Cursor, and other AI tools each forget your project between sessions, and when they do remember things,
@@ -48,7 +50,14 @@ other tools ─┘   (Python: embeddings,│          memories, HNSW vector inde
 
 ## What it looks like
 
-A memory linked to a file, the file changes, and the next lookup catches it:
+The dashboard (`aether-cache ui`): memories whose files changed wait for a decision, with the file versions side by side.
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="https://anishchugh05.github.io/Aether-Cache-Redis-Compatible-Vector-Store/assets/dashboard-dark.png">
+  <img alt="The Aether Cache dashboard showing stale memories and a possible conflict" src="https://anishchugh05.github.io/Aether-Cache-Redis-Compatible-Vector-Store/assets/dashboard-light.png">
+</picture>
+
+And from your AI tool's side, a memory linked to a file, the file changes, and the next lookup catches it:
 
 ```
 > remember("The database runs Postgres via docker compose", files=["docker-compose.yml"])
@@ -188,6 +197,8 @@ A Redis-compatible server written from scratch in Java. It speaks RESP, so `redi
 [CodeCrafters "Build Your Own Redis"](https://codecrafters.io/challenges/redis) challenge; the vector index,
 persistence hardening, and the memory layer are my own additions.
 
+[![progress-banner](https://backend.codecrafters.io/progress/redis/f43a7cd3-11e6-45dc-a8ba-9d6690c73ac0)](https://app.codecrafters.io/users/anishchugh05?r=2qF)
+
 ### Throughput vs. official Redis
 
 `redis-benchmark -t set,get`, 100K requests, 50 parallel clients, 3-byte values, same machine:

{aether_cache-0.1.5 → aether_cache-0.1.6}/aether_cache/__init__.py

@@ -1,3 +1,3 @@
 """Aether Cache: shared memory for AI coding tools that stays true to your code."""
 
-__version__ = "0.1.5"
+__version__ = "0.1.6"

{aether_cache-0.1.5 → aether_cache-0.1.6}/aether_cache/engine.py

@@ -224,7 +224,7 @@ def start(wait: float = 60) -> str:
             upgraded = True
         if state == "other":
             raise EngineError(port_taken_message())
-        java, _ = find_java()
+        java = _java_or_download()
         note = _migrate_old_data()
         config.DATA_DIR.mkdir(parents=True, exist_ok=True)
         command = [java, "-Xmx1g", "-jar", str(JAR),
@@ -264,6 +264,31 @@ def start(wait: float = 60) -> str:
         raise EngineError(f"The engine didn't answer within {int(wait)} seconds. See {config.LOG_FILE}.")
 
 
+def _java_or_download() -> str:
+    """Java for starting the engine. If there isn't any, downloads Aether Cache's private copy, so the engine
+    also starts for people whose AI tool runs the server without `aether-cache setup` having run first.
+    Called while holding the start lock, so several sessions starting at once download it only once."""
+    try:
+        return find_java()[0]
+    except EngineError as missing:
+        if os.environ.get("AETHER_NO_JAVA_DOWNLOAD"):
+            raise
+        from . import javart
+        notice = (f"{str(missing).splitlines()[0]} Downloading a private copy of Java {javart.FEATURE_VERSION} "
+                  f"for Aether Cache into {javart.JAVA_DIR} (about 50 MB, only the first time).")
+        print(notice, file=sys.stderr, flush=True)  # stderr: stdout carries the MCP protocol
+        try:
+            with open(config.LOG_FILE, "a") as log:
+                log.write(f"\n{time.strftime('%Y-%m-%d %H:%M:%S')} {notice}\n")
+        except OSError:
+            pass
+        try:
+            javart.download(progress=lambda done, total: None)
+        except javart.JavaDownloadError as e:
+            raise EngineError(f"{str(missing).splitlines()[0]}\n{e}")
+        return find_java()[0]
+
+
 def ensure_running() -> None:
     if probe() != "aether" or needs_upgrade():
         start()

{aether_cache-0.1.5 → aether_cache-0.1.6}/aether_cache/server.py

@@ -16,7 +16,7 @@ from typing import List, Optional
 
 import redis
 
-from . import config, engine
+from . import __version__, config, engine
 
 try:
     from mcp.server.mcpserver import MCPServer  # mcp 2.x
@@ -39,10 +39,14 @@ INSTRUCTIONS = (
     "replace_memory."
 )
 
-mcp = MCPServer(
-    "aether-cache",
-    instructions=INSTRUCTIONS,
-)
+try:
+    mcp = MCPServer("aether-cache", instructions=INSTRUCTIONS, version=__version__)
+except Exception:  # mcp 1.x has no version argument; set it on the underlying server instead
+    mcp = MCPServer("aether-cache", instructions=INSTRUCTIONS)
+    try:
+        mcp._mcp_server.version = __version__
+    except AttributeError:
+        pass
 
 def quiet_libraries() -> None:
     """Hides the download libraries' request logs, warnings and progress bars, which otherwise flood the

{aether_cache-0.1.5 → aether_cache-0.1.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "aether-cache"
-version = "0.1.5"
+version = "0.1.6"
 description = "Shared memory for AI coding tools that stays true to your code."
 readme = "README.md"
 requires-python = ">=3.10"