Initial commit: add .gitignore and README

fusionagi/skills/__init__.py

@@ -0,0 +1,4 @@
+from fusionagi.skills.library import SkillLibrary
+from fusionagi.skills.induction import SkillInduction
+from fusionagi.skills.versioning import SkillVersioning
+__all__ = ["SkillLibrary", "SkillInduction", "SkillVersioning"]

fusionagi/skills/induction.py

@@ -0,0 +1,19 @@
+from typing import Any
+from fusionagi.schemas.skill import Skill, SkillKind
+from fusionagi._logger import logger
+
+class SkillInduction:
+    def __init__(self, min_occurrences: int = 2) -> None:
+        self._min_occurrences = min_occurrences
+    def propose_from_traces(self, traces: list[list[dict[str, Any]]], task_ids: list[str] | None = None) -> list[Skill]:
+        candidates: list[Skill] = []
+        task_ids = task_ids or [f"task_{i}" for i in range(len(traces))]
+        for i, trace in enumerate(traces):
+            if not trace:
+                continue
+            step_ids = [t.get("step_id", t.get("tool", "")) for t in trace[:10]]
+            steps = [{"id": s, "description": str(s)} for s in step_ids]
+            skill_id = f"induced_{task_ids[i] if i < len(task_ids) else i}_{hash(tuple(step_ids)) % 10**6}"
+            candidates.append(Skill(skill_id=skill_id, name=f"Induced routine {i}", description=f"From trace: {step_ids[:3]}", kind=SkillKind.WORKFLOW, steps=steps, tool_names=list({t.get("tool", "") for t in trace if t.get("tool")}), version=1))
+        logger.info("SkillInduction proposed", extra={"count": len(candidates)})
+        return candidates

fusionagi/skills/library.py

@@ -0,0 +1,16 @@
+from fusionagi.schemas.skill import Skill
+from fusionagi.memory.procedural import ProceduralMemory
+from fusionagi._logger import logger
+
+class SkillLibrary:
+    def __init__(self, procedural: ProceduralMemory | None = None) -> None:
+        self._proc = procedural or ProceduralMemory()
+    def register(self, skill: Skill) -> None:
+        self._proc.add_skill(skill)
+        logger.info("Skill registered", extra={"skill_id": skill.skill_id, "name": skill.name})
+    def get(self, skill_id: str) -> Skill | None:
+        return self._proc.get_skill(skill_id)
+    def get_by_name(self, name: str) -> Skill | None:
+        return self._proc.get_skill_by_name(name)
+    def list_skills(self, limit: int = 200) -> list[Skill]:
+        return self._proc.list_skills(limit=limit)

fusionagi/skills/versioning.py

@@ -0,0 +1,48 @@
+"""Skill versioning: regression tests and performance tracking."""
+
+from typing import Any
+
+from fusionagi.schemas.skill import Skill, SkillVersionInfo
+from fusionagi._logger import logger
+
+
+class SkillVersioning:
+    """Tracks success/failure and regression test IDs per skill version."""
+
+    def __init__(self) -> None:
+        self._versions: dict[str, dict[int, SkillVersionInfo]] = {}  # skill_id -> {version -> info}
+
+    def record_success(self, skill_id: str, version: int = 1) -> None:
+        from datetime import datetime, timezone
+        self._versions.setdefault(skill_id, {})
+        info = self._versions[skill_id].get(version)
+        if not info:
+            info = SkillVersionInfo(skill_id=skill_id, version=version)
+        info = info.model_copy(
+            update={
+                "success_count": info.success_count + 1,
+                "last_success_at": datetime.now(timezone.utc),
+            }
+        )
+        self._versions[skill_id][version] = info
+
+    def record_failure(self, skill_id: str, version: int = 1) -> None:
+        self._versions.setdefault(skill_id, {})
+        info = self._versions[skill_id].get(version)
+        if not info:
+            info = SkillVersionInfo(skill_id=skill_id, version=version)
+        info = info.model_copy(update={"failure_count": info.failure_count + 1})
+        self._versions[skill_id][version] = info
+
+    def get_info(self, skill_id: str, version: int) -> SkillVersionInfo | None:
+        return self._versions.get(skill_id, {}).get(version)
+
+    def add_regression_test(self, skill_id: str, version: int, test_id: str) -> None:
+        self._versions.setdefault(skill_id, {})
+        info = self._versions[skill_id].get(version)
+        if not info:
+            info = SkillVersionInfo(skill_id=skill_id, version=version)
+        info = info.model_copy(
+            update={"regression_test_ids": list(info.regression_test_ids) + [test_id]}
+        )
+        self._versions[skill_id][version] = info