zettcode-skills 0.4.1__py3-none-any.whl

zettcode/skills/__init__.py

@@ -0,0 +1,13 @@
+"""The skills of ZettCode: the ``@`` provider that offers them to the composer, and the extension that lists them for
+the model and lets it read one.
+
+A part of the program that lives in a distribution of its own, found through the ``zettcode.agent`` entry point and
+activated with the agent's other parts. ``[skills] enabled`` in the configuration is what turns it off.
+"""
+
+from __future__ import annotations
+
+from .mentions import SkillMentions
+from .plugin import SkillResources, SkillTool
+
+__all__ = ["SkillMentions", "SkillResources", "SkillTool"]

zettcode/skills/mentions.py

@@ -0,0 +1,47 @@
+"""The ``@`` provider for skills."""
+
+from __future__ import annotations
+
+from collections.abc import Sequence
+from pathlib import Path
+
+from zett_agent.extensions.skill import SkillExtension
+
+from zettcode.mention import Mention, MentionProvider
+
+
+class SkillMentions(MentionProvider):
+    """Skills discovered from the configured roots, named for the model to load."""
+
+    kind = "skill"
+    #: A skill is the more specific thing to mean when a repository holds a file of the same name, so it is asked
+    #: ahead of the files whatever order the plugins were registered in (a session still goes first).
+    precedence = -10
+
+    def __init__(self, roots: Sequence[Path]) -> None:
+        """Discover skills once, the same way the agent's skill extension does."""
+        self._skills = {skill.name: skill for skill in SkillExtension(roots).skills}
+
+    def candidates(self, query: str) -> Sequence[Mention]:
+        """List the discovered skills whose name starts with ``query``."""
+        return tuple(
+            Mention(token=f"@{skill.name}", kind=self.kind, name=skill.name, description=skill.description)
+            for skill in self._skills.values()
+            if skill.name.startswith(query)
+        )
+
+    def expand(self, name: str) -> str | None:
+        """Name the skill and leave loading its instructions to the model.
+
+        The system prompt already catalogs every skill, and ``read_skill`` loads
+        the file, so the message only has to say which one the user meant;
+        inlining the body would spend context on instructions that may not be
+        needed.
+        """
+        skill = self._skills.get(name)
+        if skill is None:
+            return None
+        return (
+            f'Use the "{skill.name}" skill: call read_skill(name="{skill.name}") '
+            "if its instructions are useful and not already in context."
+        )

zettcode/skills/plugin.py

@@ -0,0 +1,51 @@
+"""The plugins that offer skills: to the composer as ``@`` references, and to the model as a list and a tool."""
+
+from __future__ import annotations
+
+from typing import TYPE_CHECKING
+
+from zettcode.engine.plugins.plugin import Plugin, PluginSetting
+
+from .mentions import SkillMentions
+
+if TYPE_CHECKING:  # pragma: no cover - annotations only
+    from zett_agent.extensions.base import AgentExtension
+
+    from zettcode.engine.plugins.context import PluginContext
+    from zettcode.engine.plugins.state import AgentBuild
+
+
+class SkillResources(Plugin):
+    """The ``@`` resource provider for the skills on this machine.
+
+    Registering it from a plugin rather than inside the shell keeps the shell generic: it merges whatever providers
+    the bundle holds, and the skills are simply one of them.
+    """
+
+    name = "skills"
+    setting = PluginSetting("skills_enabled", "skills")
+
+    def activate(self, ctx: PluginContext) -> None:
+        """Offer the discovered skills as ``@`` resources, when skills are on."""
+        if ctx.config.skills_enabled:
+            ctx.agent.register_mention(SkillMentions(ctx.config.skill_search_roots()))
+
+
+class SkillTool(Plugin):
+    """The skills the model can load: their list in the prompt and the tool that reads one."""
+
+    name = "skill-tool"
+    description = "Skills the model can load"
+
+    def activate(self, ctx: PluginContext) -> None:
+        """Hand the agent the skills found under the configured roots, when skills are on."""
+        config = ctx.config
+        if not config.skills_enabled:
+            return
+
+        def build(_: AgentBuild) -> AgentExtension:
+            from zett_agent.extensions.skill import SkillExtension
+
+            return SkillExtension(config.skill_search_roots())
+
+        ctx.agent.register_extension_factory("SkillExtension", build)

zettcode_skills-0.4.1.dist-info/METADATA

@@ -0,0 +1,19 @@
+Metadata-Version: 2.5
+Name: zettcode-skills
+Version: 0.4.1
+Summary: The skills of ZettCode: the @ references and the tool that lets the model read one, 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,skills,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_skills-0.4.1.dist-info/RECORD

@@ -0,0 +1,8 @@
+zettcode/skills/__init__.py,sha256=udywuXGnKJHVs7ZJLgvOjxCGDEDOyfFt7BB_-8pHShM,554
+zettcode/skills/mentions.py,sha256=bmRe2AIqm--sUWhFKsR2XaOyPX5Jjet6nC6E3718FLE,1876
+zettcode/skills/plugin.py,sha256=jBEUpO6s4gqEj6H2wLIMf8MC0ldUQuLh_P2WyeRRGQo,1824
+zettcode/skills/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+zettcode_skills-0.4.1.dist-info/METADATA,sha256=_RI2AAzvdzuwAUCYZgCsW2dqzN_s43OTlk7QIjhjQIQ,826
+zettcode_skills-0.4.1.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+zettcode_skills-0.4.1.dist-info/entry_points.txt,sha256=QhYOHNFzsvThnzX7E5Ay0Gj21iavNXp61V6hlEVrJ8Y,110
+zettcode_skills-0.4.1.dist-info/RECORD,,

zettcode_skills-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_skills-0.4.1.dist-info/entry_points.txt

@@ -0,0 +1,3 @@
+[zettcode.agent]
+skill-tool = zettcode.skills.plugin:SkillTool
+skills = zettcode.skills.plugin:SkillResources