anna-app-core 0.2.0a1__tar.gz

anna_app_core-0.2.0a1/.gitignore

@@ -0,0 +1,167 @@
+# matrix agent repository
+matrix/
+
+# git diff files
+git.diff
+
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[cod]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+# setuptools sdist MANIFEST (only at repo root — must NOT swallow the
+# packages/anna-app-schema/manifest/ schema bundle directory).
+/MANIFEST
+
+# PyInstaller
+# Anchored to repo root for the same reason — `*.manifest` is too broad
+# and was matching schema bundle files. Re-add specific paths if a real
+# PyInstaller .manifest ever ships.
+/*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py,cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+.python-version
+
+# pipenv
+Pipfile.lock
+
+# poetry
+poetry.lock
+
+# pdm
+.pdm.toml
+
+# PEP 582
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# IDE
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Project specific
+*.tmp
+*.bak
+
+# Security - RSA keys
+private_key.pem
+*.pem
+!public_key.pem
+
+scripts/nats_auth
+# Anna App runtime cache
+static/anna-apps-cache/

anna_app_core-0.2.0a1/PKG-INFO

@@ -0,0 +1,38 @@
+Metadata-Version: 2.4
+Name: anna-app-core
+Version: 0.2.0a1
+Summary: Anna App platform core: manifest schemas, RPC dispatcher, protocols, errors. Shared by matrix-nexus and the local-dev runtime.
+Project-URL: Documentation, https://github.com/talentai/matrix-nexus/blob/main/docs/design/anna-app-local-dev-and-test.md
+Author: Talent AI
+License: MIT
+Keywords: anna,anna-app,executa
+Requires-Python: >=3.10
+Requires-Dist: pydantic<3.0,>=2.0
+Description-Content-Type: text/markdown
+
+# anna-app-core
+
+Shared protocol/error/ACL primitives for the [Anna App](https://github.com/talentai/matrix-nexus/blob/main/docs/design/anna-app-local-dev-and-test.md) platform.
+
+This package is intentionally tiny. It exposes the **stable contract surface**
+that both `matrix-nexus` (production host) and `anna-app-runtime-local` (local
+dev harness) can depend on without pulling each other's runtime.
+
+## What's here (v0.1.x)
+
+- `WindowStoreProtocol` — minimum surface RPC handlers expect from a window store
+- `HostRpcError`, `WindowError`, `WindowPermissionError` — error types crossing the boundary
+- `host_api_allows(manifest_dict, ns, method) -> bool` — pure ACL check (manifest passed as `dict`)
+- `DISPATCHER_VERSION` / `SDK_VERSION` constants
+
+## What's NOT here yet
+
+- The full `dispatch()` function — still lives in `matrix-nexus`
+  (`src/services/anna_app_rpc_dispatcher.py`). Planned for `anna-app-core>=0.2`
+  once `event_stream` + `runtime_service` are abstracted behind protocols.
+- Pydantic `AppManifest` — see `anna-app-schema` (JSON Schema bundle).
+
+## Versioning
+
+`0.1.0a1` is the first PyPI release (alpha). Pin policy lives in the central
+[VERSIONS.md](../VERSIONS.md).

anna_app_core-0.2.0a1/README.md

@@ -0,0 +1,26 @@
+# anna-app-core
+
+Shared protocol/error/ACL primitives for the [Anna App](https://github.com/talentai/matrix-nexus/blob/main/docs/design/anna-app-local-dev-and-test.md) platform.
+
+This package is intentionally tiny. It exposes the **stable contract surface**
+that both `matrix-nexus` (production host) and `anna-app-runtime-local` (local
+dev harness) can depend on without pulling each other's runtime.
+
+## What's here (v0.1.x)
+
+- `WindowStoreProtocol` — minimum surface RPC handlers expect from a window store
+- `HostRpcError`, `WindowError`, `WindowPermissionError` — error types crossing the boundary
+- `host_api_allows(manifest_dict, ns, method) -> bool` — pure ACL check (manifest passed as `dict`)
+- `DISPATCHER_VERSION` / `SDK_VERSION` constants
+
+## What's NOT here yet
+
+- The full `dispatch()` function — still lives in `matrix-nexus`
+  (`src/services/anna_app_rpc_dispatcher.py`). Planned for `anna-app-core>=0.2`
+  once `event_stream` + `runtime_service` are abstracted behind protocols.
+- Pydantic `AppManifest` — see `anna-app-schema` (JSON Schema bundle).
+
+## Versioning
+
+`0.1.0a1` is the first PyPI release (alpha). Pin policy lives in the central
+[VERSIONS.md](../VERSIONS.md).

anna_app_core-0.2.0a1/pyproject.toml

@@ -0,0 +1,25 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "anna-app-core"
+version = "0.2.0a1"
+description = "Anna App platform core: manifest schemas, RPC dispatcher, protocols, errors. Shared by matrix-nexus and the local-dev runtime."
+readme = "README.md"
+requires-python = ">=3.10"
+license = { text = "MIT" }
+authors = [{ name = "Talent AI" }]
+keywords = ["anna", "anna-app", "executa"]
+
+# pydantic v2 is required for the AppManifest schema; everything else is
+# pure stdlib.
+dependencies = [
+    "pydantic>=2.0,<3.0",
+]
+
+[project.urls]
+Documentation = "https://github.com/talentai/matrix-nexus/blob/main/docs/design/anna-app-local-dev-and-test.md"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/anna_app_core"]

anna_app_core-0.2.0a1/src/anna_app_core/__init__.py

@@ -0,0 +1,58 @@
+"""anna-app-core: stable contract surface shared by matrix-nexus and
+anna-app-runtime-local.
+
+v0.2.0a1 — full extraction. The complete RPC dispatcher, manifest pydantic
+schemas, and helper functions now live here; matrix-nexus re-exports them
+for backward compatibility (see README.md).
+"""
+
+from .acl import host_api_allows
+from .dispatcher import dispatch
+from .errors import HostRpcError, WindowError, WindowPermissionError
+from .manifest import (
+    AppDevConfig,
+    AppManifest,
+    ManifestExecutaRef,
+    UiBundleSection,
+    UiHostApiSpec,
+    UiManifestSection,
+    UiSize,
+    UiViewSpec,
+    WindowViewMeta,
+)
+from .protocols import WindowStoreProtocol
+from .runtime import scopes_from_manifest, select_view, view_meta
+from .versions import DISPATCHER_VERSION, SDK_VERSION
+
+__version__ = "0.2.0a1"
+
+__all__ = [
+    # errors
+    "HostRpcError",
+    "WindowError",
+    "WindowPermissionError",
+    # protocols
+    "WindowStoreProtocol",
+    # acl
+    "host_api_allows",
+    # dispatcher
+    "dispatch",
+    # manifest schemas
+    "AppManifest",
+    "AppDevConfig",
+    "ManifestExecutaRef",
+    "UiBundleSection",
+    "UiHostApiSpec",
+    "UiManifestSection",
+    "UiSize",
+    "UiViewSpec",
+    "WindowViewMeta",
+    # runtime helpers
+    "select_view",
+    "scopes_from_manifest",
+    "view_meta",
+    # versions
+    "DISPATCHER_VERSION",
+    "SDK_VERSION",
+    "__version__",
+]

anna_app_core-0.2.0a1/src/anna_app_core/acl.py

@@ -0,0 +1,66 @@
+"""Host-API ACL check.
+
+Accepts either a typed ``AppManifest`` (preferred — production + harness)
+or a plain ``dict`` (e.g. JSON-loaded manifest before pydantic validation).
+
+Mirrors the pre-extraction implementation in
+``matrix-nexus/src/services/anna_app_runtime_service.py::host_api_allows``.
+"""
+
+from __future__ import annotations
+
+from typing import Any, Union
+
+from .manifest import AppManifest
+
+
+def _ui_host_api(
+    manifest: Union[AppManifest, dict[str, Any]],
+) -> dict[str, list[str]] | None:
+    """Return the ``ui.host_api`` mapping (ns -> list[method]) or ``None``
+    if the manifest has no UI section."""
+    if isinstance(manifest, AppManifest):
+        if manifest.ui is None:
+            return None
+        api = manifest.ui.host_api
+        return {
+            "tools": api.tools,
+            "chat": api.chat,
+            "artifact": api.artifact,
+            "llm": api.llm,
+            "fs": api.fs,
+            "storage": api.storage,
+            "prefs": api.prefs,
+        }
+    ui = manifest.get("ui") if isinstance(manifest, dict) else None
+    if ui is None:
+        return None
+    return ui.get("host_api") or {}
+
+
+def host_api_allows(
+    manifest: Union[AppManifest, dict[str, Any]],
+    ns: str,
+    method: str,
+) -> bool:
+    """Return ``True`` iff ``ns.method`` is granted by the manifest's ACL.
+
+    `window.*` is always granted. ``tools.invoke`` and ``tools.list`` are
+    granted whenever the ``tools`` set is non-empty (per-tool gating happens
+    inside the handler).
+    """
+    if ns == "window":
+        return True
+    api_map = _ui_host_api(manifest)
+    if api_map is None:
+        return False
+    methods = api_map.get(ns)
+    if not methods:
+        return False
+    if "*" in methods:
+        return True
+    if method in methods:
+        return True
+    if ns == "tools" and method in ("invoke", "list"):
+        return True
+    return False