vaf 0.1.0a17__py3-none-any.whl

vaf/__init__.py

@@ -0,0 +1,36 @@
+# SPDX-FileCopyrightText: 2026 Veyllo GmbH
+# SPDX-License-Identifier: AGPL-3.0-or-later
+# Additional permissions and terms under AGPL Section 7: see LICENSING.md
+from typing import TYPE_CHECKING
+
+from .version import __version__
+
+if TYPE_CHECKING:
+    # Static type-checkers only (mypy / Pyright / VS Code): resolve the lazy public
+    # API to the real classes so `from vaf import Agent` autocompletes and type-checks.
+    # No runtime import here — `import vaf` stays cheap (the real loading is in
+    # __getattr__ below). Paired with the vaf/py.typed marker (PEP 561).
+    from .framework import Agent, CoreAgent
+
+__all__ = ["__version__", "Agent", "CoreAgent", "markers"]
+
+
+def __getattr__(name):
+    # Lazy public API (PEP 562). Keeps `import vaf` cheap: the ~9k-line core
+    # engine and its dependency chain (incl. the latent Agent<->thinking_mode
+    # cycle, which resolves fine at call time) are only loaded on first access
+    # to `vaf.Agent` / `vaf.CoreAgent`.
+    if name in ("Agent", "CoreAgent"):
+        from .framework import Agent, CoreAgent
+        return {"Agent": Agent, "CoreAgent": CoreAgent}[name]
+    if name == "markers":
+        # importlib, not `from . import`: the latter re-enters this
+        # __getattr__ while the submodule is being set and recurses.
+        import importlib
+
+        return importlib.import_module(".markers", __name__)
+    raise AttributeError(f"module 'vaf' has no attribute {name!r}")
+
+
+def __dir__():
+    return sorted(__all__)

vaf/api/__init__.py

@@ -0,0 +1,8 @@
+# SPDX-FileCopyrightText: 2026 Veyllo GmbH
+# SPDX-License-Identifier: AGPL-3.0-or-later
+# Additional permissions and terms under AGPL Section 7: see LICENSING.md
+"""
+VAF API Routes
+
+External integration endpoints for Discord, Telegram, etc.
+"""