zettcode-engine 0.3.4__tar.gz

zettcode_engine-0.3.4/.gitignore

@@ -0,0 +1,37 @@
+**/.venv/
+**/__pycache__/
+*.py[cod]
+*.egg-info/
+build/
+dist/
+.smoke/
+.coverage
+**/.pytest_cache/
+**/.ruff_cache/
+.zett-tool-output/
+.env
+.DS_Store
+
+# viztracer writes its trace here by default.
+/result.json
+
+# The docs site: dependencies, build output, and VitePress' cache.
+node_modules/
+docs/.vitepress/dist/
+docs/.vitepress/cache/
+docs/.vitepress/.temp/
+
+# The TypeScript client is built from its sources; only dist/ is published.
+clients/typescript/dist/
+
+# The gateway's page is built from clients/gateway into the package when a distribution is made (`make gateway-ui`);
+# the build output is not kept in the repository. pyproject's `artifacts` puts it in the wheel all the same.
+packages/zettcode-gateway/src/zettcode/gateway/static/
+
+# The palette gallery is generated by `make palettes`: every widget painted in
+# every palette, written by docs/scripts/palette_gallery.py. Regenerate it
+# rather than committing a 2 MB copy that goes stale the moment a colour moves.
+docs/internal/palettes.html
+
+# The release order is generated from the pyproject.toml files (`make order`); it is not kept in git.
+packages/order.txt

zettcode_engine-0.3.4/PKG-INFO

@@ -0,0 +1,23 @@
+Metadata-Version: 2.5
+Name: zettcode-engine
+Version: 0.3.4
+Summary: The agent core of ZettCode: the runtime over zett-agent, and the leaf types it is written on
+Project-URL: Repository, https://github.com/Chang-LeHung/zettcode
+Author: Chang-LeHung
+License-Expression: MIT
+Keywords: agent,llm,runtime,zettcode
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3.15
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: exceptiongroup<2,>=1.2; python_version < '3.11'
+Requires-Dist: pydantic<3,>=2
+Requires-Dist: tomli<3,>=2; python_version < '3.11'
+Requires-Dist: zett-agent<0.3,>=0.2.7
+Provides-Extra: tiktoken
+Requires-Dist: tiktoken<1,>=0.12; extra == 'tiktoken'

zettcode_engine-0.3.4/pyproject.toml

@@ -0,0 +1,56 @@
+[project]
+name = "zettcode-engine"
+description = "The agent core of ZettCode: the runtime over zett-agent, and the leaf types it is written on"
+requires-python = ">=3.10"
+dynamic = ["version"]
+license = "MIT"
+authors = [{name = "Chang-LeHung"}]
+keywords = ["zettcode", "agent", "llm", "runtime"]
+classifiers = [
+  "Development Status :: 5 - Production/Stable",
+  "Programming Language :: Python :: 3.10",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Programming Language :: Python :: 3.14",
+  "Programming Language :: Python :: 3.15",
+  "Typing :: Typed",
+]
+dependencies = [
+  # The runtime this is a core over. Imported directly: the agent, the message types, the approval mode.
+  "zett-agent>=0.2.7,<0.3",
+  # The session store's records are pydantic models.
+  "pydantic>=2,<3",
+  # The stdlib gained both of these in 3.11; older runtimes take the backports.
+  "exceptiongroup>=1.2,<2; python_version < '3.11'",
+  "tomli>=2,<3; python_version < '3.11'",
+]
+
+[project.optional-dependencies]
+# Counting the context with the provider's own tokenizer. Without it the runtime estimates by characters, which is
+# what a plugin that only needs the engine gets; the program installs this extra.
+tiktoken = ["tiktoken>=0.12,<1"]
+
+[project.urls]
+Repository = "https://github.com/Chang-LeHung/zettcode"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+# Every other distribution reads this file (`../zettcode-engine/src/zettcode/version.py`). A wheel built from an
+# sdist takes the version from the sdist's `PKG-INFO` instead, so a builder never needs this tree beside it.
+path = "src/zettcode/version.py"
+
+# `zettcode/` is a PEP 420 namespace: the wheel ships `zettcode/engine/**` and the leaves beside it, and no
+# `zettcode/__init__.py`, so the namespace is the union of what is installed.
+[tool.hatch.build.targets.wheel]
+packages = ["src/zettcode"]
+
+[tool.hatch.build.targets.sdist]
+include = ["/src", "/pyproject.toml"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+asyncio_mode = "auto"

zettcode_engine-0.3.4/src/zettcode/_compat.py

@@ -0,0 +1,35 @@
+"""Small shims for the language versions this project supports.
+
+ZettCode runs on Python 3.10 through 3.15, so the few things the standard
+library grew in between live here instead of behind version checks at each use.
+"""
+
+from __future__ import annotations
+
+import sys
+from enum import Enum
+
+if sys.version_info >= (3, 11):
+    from builtins import BaseExceptionGroup, ExceptionGroup
+
+    import tomllib
+else:  # pragma: no cover - the branch only the 3.10 runtime takes
+    import tomli as tomllib
+    from exceptiongroup import BaseExceptionGroup, ExceptionGroup
+
+
+__all__ = ["BaseExceptionGroup", "ExceptionGroup", "StrEnum", "tomllib"]
+
+
+class StrEnum(str, Enum):
+    """A string-valued enum, for the versions before ``enum.StrEnum``.
+
+    The standard library's version formats as its value, so ``f"{member}"`` is
+    ``"ready"`` rather than ``"Activity.READY"``; the status line and the stored
+    metadata rely on that, so every interpreter uses this class instead of the
+    standard one and the wording cannot drift with the version.
+    """
+
+    def __str__(self) -> str:
+        """Return the member's value, as ``enum.StrEnum`` does."""
+        return str(self.value)

zettcode_engine-0.3.4/src/zettcode/budget.py

@@ -0,0 +1,24 @@
+"""What a context budget is made of: the vocabulary the engine measures with and the views draw with.
+
+A leaf with no imports, shared like :mod:`zettcode.statusline` and :mod:`zettcode.providers`, so the engine that counts
+the request and the page that shows the count agree on the names without either importing the other.
+"""
+
+from __future__ import annotations
+
+__all__ = ["CHARS_PER_TOKEN", "SOURCES"]
+
+#: Characters per token when no tokenizer is available. The rule of thumb is close for English prose and low for CJK,
+#: which is why a report names the estimate it used instead of presenting it as exact.
+CHARS_PER_TOKEN = 4
+
+#: One row per source, in the order the request is assembled.
+SOURCES = (
+    "System prompt",
+    "Environment notes",
+    "Tool schemas",
+    "User messages",
+    "Assistant messages",
+    "Tool output",
+    "Compaction summary",
+)