zettcode-instructions 0.4.1__py3-none-any.whl

zettcode/instructions/__init__.py

@@ -0,0 +1,12 @@
+"""The workspace's ``AGENTS.md`` instructions of ZettCode: the plugin that hands them to the agent.
+
+A part of the program that lives in a distribution of its own, found through the ``zettcode.plugin`` entry point.
+``[agents_md] enabled`` in the configuration is what turns it off. The extension is imported by the factory, so a launch
+that never builds an agent does not pay for it.
+"""
+
+from __future__ import annotations
+
+from .plugin import ProjectInstructions
+
+__all__ = ["ProjectInstructions"]

zettcode/instructions/plugin.py

@@ -0,0 +1,34 @@
+"""The plugin that hands the agent the workspace's project instructions."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from zettcode.engine.plugins.context import PluginContext
+from zettcode.engine.plugins.plugin import Plugin, PluginSetting
+
+if TYPE_CHECKING:  # pragma: no cover - annotations only
+    from zett_agent.extensions.base import AgentExtension
+
+    from zettcode.engine.plugins.state import AgentBuild
+
+
+class ProjectInstructions(Plugin[PluginContext]):
+    """The workspace's ``AGENTS.md`` files, read again for every request so an edit applies at once."""
+
+    name = "project-instructions"
+    description = "The workspace's AGENTS.md instructions"
+    setting = PluginSetting("agents_md_enabled", "agents_md")
+
+    def activate(self, ctx: PluginContext) -> None:
+        """Hand the agent the instructions, unless the configuration turned them off."""
+        config = ctx.config
+        if not config.agents_md_enabled:
+            return
+
+        def build(_: AgentBuild) -> AgentExtension:
+            from zett_agent.extensions.agents_md import AgentsMdExtension
+
+            return AgentsMdExtension(config.workspace)
+
+        ctx.agent.register_extension_factory("AgentsMdExtension", build)

zettcode_instructions-0.4.1.dist-info/METADATA

@@ -0,0 +1,19 @@
+Metadata-Version: 2.5
+Name: zettcode-instructions
+Version: 0.4.1
+Summary: The workspace's AGENTS.md instructions of ZettCode, 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,agents-md,instructions,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_instructions-0.4.1.dist-info/RECORD

@@ -0,0 +1,7 @@
+zettcode/instructions/__init__.py,sha256=PbYnECscI13cEhGkMycuEDj1EKneBsfW2Tss7IcX66w,500
+zettcode/instructions/plugin.py,sha256=Zm5OYfNjsqr4l4B3zq9ASz-IEokxTX_-N3p--EOyCOk,1243
+zettcode/instructions/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+zettcode_instructions-0.4.1.dist-info/METADATA,sha256=gnXNMSi_ffel2kub4_A6-6BMoF_Enar9hazSV14r3Lc,816
+zettcode_instructions-0.4.1.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+zettcode_instructions-0.4.1.dist-info/entry_points.txt,sha256=WXtasd3WmikibSVF4rtbK6q8LiaYw7HGkIxjIO5Kjn4,90
+zettcode_instructions-0.4.1.dist-info/RECORD,,

zettcode_instructions-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_instructions-0.4.1.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[zettcode.plugin]
+project-instructions = zettcode.instructions.plugin:ProjectInstructions