aether-context 0.3.0__py3-none-any.whl

aether_context/__init__.py

@@ -0,0 +1,29 @@
+# aether-context (Unlimited Context)
+# Copyright (c) 2026 Aether AI
+# SPDX-License-Identifier: Apache-2.0
+"""aether-context — virtual memory for an LLM's attention (local-first, numpy-only core).
+
+"Unlimited" means *reach, not attention*: the model keeps its native window; the engine
+externalizes overflow to a local pool and pages the right slices back in via retrieval.
+
+The whole product is three lines:
+
+    from aether_context import Session
+
+    s = Session(model="ollama/qwen2.5", pool_gb=5)
+    s.run("Build me a full-stack weightlifting tracker app.")
+
+No Ollama? ``Session(model="mock", pool_gb=5)`` runs the engine end-to-end with a built-in
+deterministic model (offline, zero deps) — great for trying the API, tests, and CI.
+
+Public surface (intentionally tiny):
+  * :class:`Session` — the lifecycle controller you drive.
+  * :func:`load_model` — resolve a model spec / bring-your-own backend to a ``LocalLLM``.
+  * :data:`__version__` — the package version.
+"""
+from aether_context.local_llm import load_model
+from aether_context.session import Session
+
+__version__ = "0.3.0"
+
+__all__ = ["Session", "load_model", "__version__"]

aether_context/_log.py

@@ -0,0 +1,33 @@
+# aether-context (Unlimited Context)
+# Copyright (c) 2026 Aether AI
+# SPDX-License-Identifier: Apache-2.0
+"""Logging seam for aether-context.
+
+Library discipline: a library never configures the root logger and never prints. Each
+module gets a named logger under the ``aether_context`` namespace with a ``NullHandler``
+attached, so it stays silent unless the host application configures logging. There is no
+``print()`` anywhere in the package — use ``get_logger(__name__)`` instead.
+"""
+from __future__ import annotations
+
+import logging
+
+_ROOT_NAME = "aether_context"
+
+
+def get_logger(name: str) -> logging.Logger:
+    """Return a namespaced logger with a ``NullHandler`` attached.
+
+    The logger is placed under the ``aether_context`` root namespace so a host app can
+    configure the whole package with one call (``logging.getLogger("aether_context")``).
+    A ``NullHandler`` is attached idempotently so the library is silent by default and
+    never emits "No handlers could be found" warnings.
+    """
+    full_name = name if name.startswith(_ROOT_NAME) else f"{_ROOT_NAME}.{name}"
+    logger = logging.getLogger(full_name)
+    if not any(isinstance(h, logging.NullHandler) for h in logger.handlers):
+        logger.addHandler(logging.NullHandler())
+    return logger
+
+
+__all__ = ["get_logger"]