zettcode-guidance 0.4.1__tar.gz

zettcode_guidance-0.4.1/.gitignore

@@ -0,0 +1,42 @@
+**/.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
+
+# The desktop and phone apps build the gateway's page into their own folders, and electron-builder writes its
+# installers under release/.
+clients/desktop/renderer/
+clients/desktop/release/

zettcode_guidance-0.4.1/PKG-INFO

@@ -0,0 +1,19 @@
+Metadata-Version: 2.5
+Name: zettcode-guidance
+Version: 0.4.1
+Summary: The per-tool guidance ZettCode gives the model, 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,guidance,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.10
+Requires-Dist: zettcode-engine

zettcode_guidance-0.4.1/pyproject.toml

@@ -0,0 +1,51 @@
+[project]
+name = "zettcode-guidance"
+description = "The per-tool guidance ZettCode gives the model, 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", "guidance", "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, and the factory the extension is built from (`engine.extensions.guidance`).
+  "zettcode-engine",
+  # The type the factory returns; the module is only imported by the type checker.
+  "zett-agent>=0.2.10,<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 nothing turns it off: every agent this program builds describes its
+# tools the same way.
+[project.entry-points."zettcode.plugin"]
+tool-guidelines = "zettcode.guidance.plugin:ToolGuidance"
+
+[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_guidance-0.4.1/src/zettcode/guidance/__init__.py

@@ -0,0 +1,12 @@
+"""Per-tool guidance in each tool's description: the plugin that hands the extension to the agent.
+
+A part of the program that lives in a distribution of its own, found through the ``zettcode.plugin`` entry point. The
+extension itself stays in the engine (`zettcode.engine.extensions.guidance`), because every child agent the engine's
+``task`` tool builds carries it, so the runtime needs the factory whether or not this part is installed.
+"""
+
+from __future__ import annotations
+
+from .plugin import ToolGuidance
+
+__all__ = ["ToolGuidance"]

zettcode_guidance-0.4.1/src/zettcode/guidance/plugin.py

@@ -0,0 +1,32 @@
+"""The plugin that registers the guidance each tool carries in its own description."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from zettcode.engine.plugins.context import PluginContext
+from zettcode.engine.plugins.plugin import Plugin
+
+if TYPE_CHECKING:  # pragma: no cover - annotations only
+    from zett_agent.extensions.base import AgentExtension
+
+    from zettcode.engine.plugins.state import AgentBuild
+
+
+class ToolGuidance(Plugin[PluginContext]):
+    """The guidance each tool carries: its call shapes, guidelines and return type, in the tool's own description."""
+
+    name = "tool-guidelines"
+    description = "Per-tool guidance in each tool's description"
+
+    def activate(self, ctx: PluginContext) -> None:
+        """Register the extension as a factory: it is built with the agent, not while the first frame is drawn."""
+
+        # Imported in the factory: the extension imports the framework's tool-guidelines module, which a launch that
+        # never builds an agent does not need.
+        def build(_: AgentBuild) -> AgentExtension:
+            from zettcode.engine.extensions.guidance import tool_guidance
+
+            return tool_guidance()
+
+        ctx.agent.register_extension_factory("ToolGuidelinesExtension", build)