zettcode-todos 0.4.1__tar.gz

zettcode_todos-0.4.1/.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_todos-0.4.1/PKG-INFO

@@ -0,0 +1,19 @@
+Metadata-Version: 2.5
+Name: zettcode-todos
+Version: 0.4.1
+Summary: The todo_write tool and the plan it keeps, as a part of the agent that lives apart from it
+Project-URL: Repository, https://github.com/Chang-LeHung/zettcode
+Author: Chang-LeHung
+License-Expression: MIT
+Keywords: agent,todos,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: zett-agent<0.3,>=0.2.7
+Requires-Dist: zettcode-engine

zettcode_todos-0.4.1/pyproject.toml

@@ -0,0 +1,50 @@
+[project]
+name = "zettcode-todos"
+description = "The todo_write tool and the plan it keeps, as a part of the agent that lives apart from it"
+requires-python = ">=3.10"
+dynamic = ["version"]
+license = "MIT"
+authors = [{name = "Chang-LeHung"}]
+keywords = ["zettcode", "todos", "agent"]
+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 plugin base classes, the name the plan is provided under, and the switch the runtime provides.
+  "zettcode-engine",
+  # The extension the plan is.
+  "zett-agent>=0.2.7,<0.3",
+]
+
+# A part of the program, not a plugin: the `[tool.zettcode] plugin = true` marker is what the plugin release line looks for. It is
+# activated with the agent's other parts and `[harness] todowrite` is what gives the model the tool.
+[project.entry-points."zettcode.plugin"]
+todos = "zettcode.todos.plugin:TodoPlan"
+
+[project.urls]
+Repository = "https://github.com/Chang-LeHung/zettcode"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.version]
+# One version for the whole repository: the engine ships the file.
+path = "../zettcode-engine/src/zettcode/version.py"
+
+[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_todos-0.4.1/src/zettcode/todos/__init__.py

@@ -0,0 +1,12 @@
+"""The ``todo_write`` tool and the plan it keeps: the plugin that provides them to the agent and to the shell.
+
+A part of the program that lives in a distribution of its own, found through the ``zettcode.plugin`` entry point.
+``[harness] todowrite`` is what gives the model the tool; the plan itself is provided as a service either way, because
+the shell asks for it on every turn.
+"""
+
+from __future__ import annotations
+
+from .plugin import TodoPlan
+
+__all__ = ["TodoPlan"]

zettcode_todos-0.4.1/src/zettcode/todos/plugin.py

@@ -0,0 +1,29 @@
+"""The plugin that keeps the plan the shell's panel draws."""
+
+from __future__ import annotations
+
+from zettcode.engine.plugins.context import PluginContext
+from zettcode.engine.plugins.plugin import Plugin, PluginSetting
+from zettcode.engine.plugins.services import TODOS
+
+
+class TodoPlan(Plugin[PluginContext]):
+    """The ``todo_write`` tool, and the plan it keeps, shown in the shell's panel.
+
+    The extension is provided as a service whether or not the tool is on, because the shell asks it for the
+    plan on every turn and an extension nobody registered simply has none to show. Only
+    ``[harness] todowrite`` decides whether the model is given the tool.
+    """
+
+    name = "todos"
+    description = "The todo_write tool and the plan it keeps"
+    setting = PluginSetting("todowrite_enabled", "harness", "todowrite")
+
+    def activate(self, ctx: PluginContext) -> None:
+        """Provide the extension, and hand it to the agent when the tool is on."""
+        from zett_agent.extensions.todo import TodoWriteExtension
+
+        extension = TodoWriteExtension()
+        ctx.agent.provide(TODOS, extension)
+        if ctx.config.todowrite_enabled:
+            ctx.agent.register_extension(extension)