zettcode-guidance 0.4.1__py3-none-any.whl

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/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)

zettcode_guidance-0.4.1.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,7 @@
+zettcode/guidance/__init__.py,sha256=z4dg5PZR4lQuwk6nOZ4WuJGEY5VkvyGCoiaV8jdc8Rw,542
+zettcode/guidance/plugin.py,sha256=_uGhZOLzBpoz2Jynh5TjQdssb4WU8mlei2dOVYuK3Xw,1273
+zettcode/guidance/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+zettcode_guidance-0.4.1.dist-info/METADATA,sha256=c7bWxGjBiGszezHHB3JESXptvENBGXDFzKOVmvnHdZw,795
+zettcode_guidance-0.4.1.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+zettcode_guidance-0.4.1.dist-info/entry_points.txt,sha256=uWo066U8BhCS3qPupylWP3AcurZtg-dSUgnVgdeGOo8,74
+zettcode_guidance-0.4.1.dist-info/RECORD,,

zettcode_guidance-0.4.1.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.33.0
+Root-Is-Purelib: true
+Tag: py3-none-any

zettcode_guidance-0.4.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[zettcode.plugin]
+tool-guidelines = zettcode.guidance.plugin:ToolGuidance