skillware 0.2.5__tar.gz → 0.2.6__tar.gz

{skillware-0.2.5 → skillware-0.2.6}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: skillware
-Version: 0.2.5
+Version: 0.2.6
 Summary: A framework for modular, self-contained AI skills.
 Author-email: ARPA Hellenic Logic Systems <skillware-os@arpacorp.net>
 License: MIT License
@@ -175,20 +175,25 @@ print(response.text)
 
 *   **[Core Logic & Philosophy](docs/introduction.md)**: Details on how Skillware decouples Logic, Cognition, and Governance.
 *   **[Testing Guidelines](docs/TESTING.md)**: Instructions for validating skills and checking local coverage.
+*   **[Usage guides](docs/usage/README.md)**: Provider adapters and navigation to integration docs.
+*   **[Agent loops](docs/usage/agent_loops.md)**: Shared load, tool-call, and `execute` pattern across providers.
 *   **[Usage Guide: Gemini](docs/usage/gemini.md)**: Integration with Google's GenAI SDK.
 *   **[Usage Guide: Claude](docs/usage/claude.md)**: Integration with Anthropic's SDK.
+*   **[Usage Guide: OpenAI](docs/usage/openai.md)**: Integration with OpenAI Chat Completions tool calling.
+*   **[Usage Guide: DeepSeek](docs/usage/deepseek.md)**: Integration with the DeepSeek API via `to_deepseek_tool()`.
 *   **[Usage Guide: Ollama](docs/usage/ollama.md)**: Native integration for local models via Ollama.
+*   **[API Keys for Skills](docs/usage/api_keys.md)**: Environment variables, cloud/CI setup, and security for skills that call external APIs.
 *   **[Skill Library](docs/skills/README.md)**: Available capabilities.
 
 ## Contributing
 
-We are building the "App Store" for Agents and require professional, robust, and safe skills.
+We are building the "App Store" for Agents and require professional, robust, and safe skills. We welcome contributions to the skill registry, documentation, tests, and core framework.
 
-We actively encourage both humans and autonomous agents to contribute to this repository!
-
-* Please read our **[Agent Code of Conduct](CODE_OF_CONDUCT.md)** which outlines our strict expectations for deterministic outputs, zero LLM code generation, and safety boundaries.
-* When submitting skills, our new **Agent-Friendly Pull Request Template** provides a checklist to ensure your logic aligns natively with `loader.py` and `base_skill.py`.
-* Please also review **[CONTRIBUTING.md](CONTRIBUTING.md)** for detailed guidelines on folder structure and schema definitions.
+* **[CONTRIBUTING.md](CONTRIBUTING.md)** — Contribution types, skill standard, pull request process, and navigation to all contributor docs.
+* **[Agent Contribution Workflow](docs/contributing/ai_native_workflow.md)** — Workflow for AI agents contributing to the repository (operators supervise).
+* **[Agent Code of Conduct](CODE_OF_CONDUCT.md)** — Deterministic outputs, safety boundaries, and acceptable use of skills.
+* **[TESTING.md](docs/TESTING.md)** — Local linting and pytest before you open a PR.
+* **[Pull request template](.github/PULL_REQUEST_TEMPLATE.md)** — Checklists for skills, docs, and framework changes (complete only the sections that apply).
 
 ## Comparison
 

{skillware-0.2.5 → skillware-0.2.6}/README.md

@@ -127,20 +127,25 @@ print(response.text)
 
 *   **[Core Logic & Philosophy](docs/introduction.md)**: Details on how Skillware decouples Logic, Cognition, and Governance.
 *   **[Testing Guidelines](docs/TESTING.md)**: Instructions for validating skills and checking local coverage.
+*   **[Usage guides](docs/usage/README.md)**: Provider adapters and navigation to integration docs.
+*   **[Agent loops](docs/usage/agent_loops.md)**: Shared load, tool-call, and `execute` pattern across providers.
 *   **[Usage Guide: Gemini](docs/usage/gemini.md)**: Integration with Google's GenAI SDK.
 *   **[Usage Guide: Claude](docs/usage/claude.md)**: Integration with Anthropic's SDK.
+*   **[Usage Guide: OpenAI](docs/usage/openai.md)**: Integration with OpenAI Chat Completions tool calling.
+*   **[Usage Guide: DeepSeek](docs/usage/deepseek.md)**: Integration with the DeepSeek API via `to_deepseek_tool()`.
 *   **[Usage Guide: Ollama](docs/usage/ollama.md)**: Native integration for local models via Ollama.
+*   **[API Keys for Skills](docs/usage/api_keys.md)**: Environment variables, cloud/CI setup, and security for skills that call external APIs.
 *   **[Skill Library](docs/skills/README.md)**: Available capabilities.
 
 ## Contributing
 
-We are building the "App Store" for Agents and require professional, robust, and safe skills.
+We are building the "App Store" for Agents and require professional, robust, and safe skills. We welcome contributions to the skill registry, documentation, tests, and core framework.
 
-We actively encourage both humans and autonomous agents to contribute to this repository!
-
-* Please read our **[Agent Code of Conduct](CODE_OF_CONDUCT.md)** which outlines our strict expectations for deterministic outputs, zero LLM code generation, and safety boundaries.
-* When submitting skills, our new **Agent-Friendly Pull Request Template** provides a checklist to ensure your logic aligns natively with `loader.py` and `base_skill.py`.
-* Please also review **[CONTRIBUTING.md](CONTRIBUTING.md)** for detailed guidelines on folder structure and schema definitions.
+* **[CONTRIBUTING.md](CONTRIBUTING.md)** — Contribution types, skill standard, pull request process, and navigation to all contributor docs.
+* **[Agent Contribution Workflow](docs/contributing/ai_native_workflow.md)** — Workflow for AI agents contributing to the repository (operators supervise).
+* **[Agent Code of Conduct](CODE_OF_CONDUCT.md)** — Deterministic outputs, safety boundaries, and acceptable use of skills.
+* **[TESTING.md](docs/TESTING.md)** — Local linting and pytest before you open a PR.
+* **[Pull request template](.github/PULL_REQUEST_TEMPLATE.md)** — Checklists for skills, docs, and framework changes (complete only the sections that apply).
 
 ## Comparison
 

{skillware-0.2.5 → skillware-0.2.6}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "skillware"
-version = "0.2.5"
+version = "0.2.6"
 description = "A framework for modular, self-contained AI skills."
 readme = "README.md"
 authors = [

{skillware-0.2.5 → skillware-0.2.6}/skillware/core/loader.py

@@ -1,4 +1,5 @@
 import os
+import re
 import yaml
 import json
 import importlib.util
@@ -126,6 +127,69 @@ class SkillLoader:
 
         return {"name": name, "description": description, "input_schema": parameters}
 
+    @staticmethod
+    def _sanitize_function_tool_name(name: str) -> str:
+        """
+        Normalizes manifest tool IDs for OpenAI-compatible function-calling APIs.
+        Allows letters, digits, underscores, and hyphens (max 64 characters).
+        """
+        if not name or not str(name).strip():
+            return "unknown_tool"
+        safe = re.sub(r"[^a-zA-Z0-9_-]", "_", str(name).replace("/", "_"))
+        safe = re.sub(r"_+", "_", safe).strip("_")
+        if not safe:
+            return "unknown_tool"
+        return safe[:64]
+
+    @staticmethod
+    def _sanitize_openai_tool_name(name: str) -> str:
+        return SkillLoader._sanitize_function_tool_name(name)
+
+    @staticmethod
+    def _sanitize_deepseek_tool_name(name: str) -> str:
+        return SkillLoader._sanitize_function_tool_name(name)
+
+    @staticmethod
+    def to_openai_tool(skill_bundle: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Converts a skill manifest to an OpenAI Chat Completions tool definition.
+        See: https://platform.openai.com/docs/guides/function-calling
+        """
+        manifest = skill_bundle.get("manifest", {})
+        raw_name = manifest.get("name", "unknown_tool")
+        description = manifest.get("description", "")
+        parameters = manifest.get("parameters", {})
+
+        return {
+            "type": "function",
+            "function": {
+                "name": SkillLoader._sanitize_openai_tool_name(raw_name),
+                "description": description,
+                "parameters": parameters,
+            },
+        }
+
+    @staticmethod
+    def to_deepseek_tool(skill_bundle: Dict[str, Any]) -> Dict[str, Any]:
+        """
+        Converts a skill manifest to a DeepSeek API tool definition.
+        DeepSeek uses an OpenAI-compatible tools schema; this adapter is separate from
+        to_openai_tool() by design. See: https://api-docs.deepseek.com/
+        """
+        manifest = skill_bundle.get("manifest", {})
+        raw_name = manifest.get("name", "unknown_tool")
+        description = manifest.get("description", "")
+        parameters = manifest.get("parameters", {})
+
+        return {
+            "type": "function",
+            "function": {
+                "name": SkillLoader._sanitize_deepseek_tool_name(raw_name),
+                "description": description,
+                "parameters": parameters,
+            },
+        }
+
     @staticmethod
     def to_ollama_prompt(skill_bundle: Dict[str, Any]) -> str:
         """

{skillware-0.2.5 → skillware-0.2.6}/skillware.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: skillware
-Version: 0.2.5
+Version: 0.2.6
 Summary: A framework for modular, self-contained AI skills.
 Author-email: ARPA Hellenic Logic Systems <skillware-os@arpacorp.net>
 License: MIT License
@@ -175,20 +175,25 @@ print(response.text)
 
 *   **[Core Logic & Philosophy](docs/introduction.md)**: Details on how Skillware decouples Logic, Cognition, and Governance.
 *   **[Testing Guidelines](docs/TESTING.md)**: Instructions for validating skills and checking local coverage.
+*   **[Usage guides](docs/usage/README.md)**: Provider adapters and navigation to integration docs.
+*   **[Agent loops](docs/usage/agent_loops.md)**: Shared load, tool-call, and `execute` pattern across providers.
 *   **[Usage Guide: Gemini](docs/usage/gemini.md)**: Integration with Google's GenAI SDK.
 *   **[Usage Guide: Claude](docs/usage/claude.md)**: Integration with Anthropic's SDK.
+*   **[Usage Guide: OpenAI](docs/usage/openai.md)**: Integration with OpenAI Chat Completions tool calling.
+*   **[Usage Guide: DeepSeek](docs/usage/deepseek.md)**: Integration with the DeepSeek API via `to_deepseek_tool()`.
 *   **[Usage Guide: Ollama](docs/usage/ollama.md)**: Native integration for local models via Ollama.
+*   **[API Keys for Skills](docs/usage/api_keys.md)**: Environment variables, cloud/CI setup, and security for skills that call external APIs.
 *   **[Skill Library](docs/skills/README.md)**: Available capabilities.
 
 ## Contributing
 
-We are building the "App Store" for Agents and require professional, robust, and safe skills.
+We are building the "App Store" for Agents and require professional, robust, and safe skills. We welcome contributions to the skill registry, documentation, tests, and core framework.
 
-We actively encourage both humans and autonomous agents to contribute to this repository!
-
-* Please read our **[Agent Code of Conduct](CODE_OF_CONDUCT.md)** which outlines our strict expectations for deterministic outputs, zero LLM code generation, and safety boundaries.
-* When submitting skills, our new **Agent-Friendly Pull Request Template** provides a checklist to ensure your logic aligns natively with `loader.py` and `base_skill.py`.
-* Please also review **[CONTRIBUTING.md](CONTRIBUTING.md)** for detailed guidelines on folder structure and schema definitions.
+* **[CONTRIBUTING.md](CONTRIBUTING.md)** — Contribution types, skill standard, pull request process, and navigation to all contributor docs.
+* **[Agent Contribution Workflow](docs/contributing/ai_native_workflow.md)** — Workflow for AI agents contributing to the repository (operators supervise).
+* **[Agent Code of Conduct](CODE_OF_CONDUCT.md)** — Deterministic outputs, safety boundaries, and acceptable use of skills.
+* **[TESTING.md](docs/TESTING.md)** — Local linting and pytest before you open a PR.
+* **[Pull request template](.github/PULL_REQUEST_TEMPLATE.md)** — Checklists for skills, docs, and framework changes (complete only the sections that apply).
 
 ## Comparison
 

{skillware-0.2.5 → skillware-0.2.6}/skillware.egg-info/SOURCES.txt

@@ -29,4 +29,5 @@ skillware/core/base_skill.py
 skillware/core/env.py
 skillware/core/loader.py
 tests/test_loader.py
-tests/test_mica_module.py
+tests/test_mica_module.py
+tests/test_skill_issuer.py

skillware-0.2.6/tests/test_loader.py

@@ -0,0 +1,122 @@
+import pytest
+from skillware.core.loader import SkillLoader
+
+
+def test_load_skill_not_found():
+    with pytest.raises(FileNotFoundError):
+        SkillLoader.load_skill("nonexistent_skill_path_12345")
+
+
+def test_to_ollama_prompt():
+    dummy_bundle = {
+        "manifest": {
+            "name": "test_ollama_skill",
+            "description": "A very useful test skill.",
+            "parameters": {
+                "type": "object",
+                "properties": {
+                    "arg1": {"type": "string", "description": "The first arg"}
+                },
+                "required": ["arg1"]
+            }
+        }
+    }
+
+    prompt = SkillLoader.to_ollama_prompt(dummy_bundle)
+    assert "### Tool: `test_ollama_skill`" in prompt
+    assert "**Description:** A very useful test skill." in prompt
+    assert "- `arg1` (string): The first arg [Required]" in prompt
+
+
+def test_to_gemini_tool():
+    dummy_bundle = {
+        "manifest": {
+            "name": "test_gemini_skill",
+            "parameters": {
+                "type": "object",
+                "properties": {
+                    "param1": {"type": "string"}
+                }
+            }
+        }
+    }
+    tool = SkillLoader.to_gemini_tool(dummy_bundle)
+    assert tool["name"] == "test_gemini_skill"
+    # Gemini requires UPPERCASE types for Protobufs
+    assert tool["parameters"]["type"] == "OBJECT"
+    assert tool["parameters"]["properties"]["param1"]["type"] == "STRING"
+
+
+def test_to_claude_tool():
+    dummy_bundle = {
+        "manifest": {
+            "name": "test_claude_skill",
+            "description": "desc",
+            "parameters": {
+                "type": "object",
+                "properties": {"arg_claude": {"type": "string"}}
+            }
+        }
+    }
+    tool = SkillLoader.to_claude_tool(dummy_bundle)
+    assert tool["name"] == "test_claude_skill"
+    assert tool["input_schema"]["type"] == "object"
+
+
+def test_sanitize_openai_tool_name():
+    assert (
+        SkillLoader._sanitize_openai_tool_name("compliance/tos_evaluator")
+        == "compliance_tos_evaluator"
+    )
+    assert SkillLoader._sanitize_openai_tool_name("wallet_screening") == "wallet_screening"
+    assert SkillLoader._sanitize_openai_tool_name("") == "unknown_tool"
+    assert SkillLoader._sanitize_openai_tool_name("a" * 80).startswith("a")
+    assert len(SkillLoader._sanitize_openai_tool_name("a" * 80)) == 64
+
+
+def test_to_openai_tool():
+    dummy_bundle = {
+        "manifest": {
+            "name": "compliance/tos_evaluator",
+            "description": "Evaluate site policy.",
+            "parameters": {
+                "type": "object",
+                "properties": {
+                    "target_url": {"type": "string", "description": "URL"}
+                },
+                "required": ["target_url"],
+            },
+        }
+    }
+    tool = SkillLoader.to_openai_tool(dummy_bundle)
+    assert tool["type"] == "function"
+    assert tool["function"]["name"] == "compliance_tos_evaluator"
+    assert tool["function"]["description"] == "Evaluate site policy."
+    assert tool["function"]["parameters"]["type"] == "object"
+    assert "target_url" in tool["function"]["parameters"]["properties"]
+
+
+def test_sanitize_deepseek_tool_name():
+    assert (
+        SkillLoader._sanitize_deepseek_tool_name("compliance/tos_evaluator")
+        == "compliance_tos_evaluator"
+    )
+
+
+def test_to_deepseek_tool():
+    dummy_bundle = {
+        "manifest": {
+            "name": "compliance/tos_evaluator",
+            "description": "Evaluate site policy.",
+            "parameters": {
+                "type": "object",
+                "properties": {
+                    "target_url": {"type": "string", "description": "URL"}
+                },
+                "required": ["target_url"],
+            },
+        }
+    }
+    tool = SkillLoader.to_deepseek_tool(dummy_bundle)
+    assert tool["type"] == "function"
+    assert tool["function"]["name"] == "compliance_tos_evaluator"

skillware-0.2.6/tests/test_skill_issuer.py

@@ -0,0 +1,89 @@
+"""Registry skills must declare issuer attribution (name + email required)."""
+
+import json
+from pathlib import Path
+
+import yaml
+
+REPO_ROOT = Path(__file__).resolve().parent.parent
+SKILLS_ROOT = REPO_ROOT / "skills"
+
+PLACEHOLDER_NAMES = frozenset({"your name"})
+PLACEHOLDER_EMAILS = frozenset({"you@example.com"})
+PLACEHOLDER_GITHUB = frozenset({"your_github_username"})
+PLACEHOLDER_ORGS = frozenset({"your org"})
+
+
+def _discover_skill_dirs():
+    if not SKILLS_ROOT.is_dir():
+        return []
+    return sorted(p.parent for p in SKILLS_ROOT.rglob("manifest.yaml"))
+
+
+def _load_manifest(skill_dir: Path) -> dict:
+    with open(skill_dir / "manifest.yaml", encoding="utf-8") as f:
+        data = yaml.safe_load(f)
+    return data if isinstance(data, dict) else {}
+
+
+def _assert_real_issuer(issuer: dict, context: str) -> None:
+    assert isinstance(issuer, dict), f"{context}: issuer must be a mapping"
+
+    name = (issuer.get("name") or "").strip()
+    email = (issuer.get("email") or "").strip()
+    assert name, f"{context}: issuer.name is required"
+    assert email, f"{context}: issuer.email is required"
+
+    assert name.lower() not in PLACEHOLDER_NAMES, (
+        f"{context}: issuer.name must not be a template placeholder"
+    )
+    assert email.lower() not in PLACEHOLDER_EMAILS, (
+        f"{context}: issuer.email must not be a template placeholder"
+    )
+
+    github = (issuer.get("github") or "").strip()
+    if github:
+        assert github.lower() not in PLACEHOLDER_GITHUB, (
+            f"{context}: issuer.github must not be a template placeholder"
+        )
+
+    org = (issuer.get("org") or "").strip()
+    if org:
+        assert org.lower() not in PLACEHOLDER_ORGS, (
+            f"{context}: issuer.org must not be a template placeholder"
+        )
+
+
+def test_registry_skills_declare_issuer():
+    skill_dirs = _discover_skill_dirs()
+    assert skill_dirs, "expected at least one skill under skills/"
+
+    for skill_dir in skill_dirs:
+        rel = skill_dir.relative_to(REPO_ROOT).as_posix()
+        manifest = _load_manifest(skill_dir)
+        _assert_real_issuer(manifest.get("issuer"), f"{rel} manifest.yaml")
+
+
+def test_registry_card_issuer_matches_manifest_when_present():
+    for skill_dir in _discover_skill_dirs():
+        rel = skill_dir.relative_to(REPO_ROOT).as_posix()
+        manifest_issuer = _load_manifest(skill_dir).get("issuer")
+        _assert_real_issuer(manifest_issuer, f"{rel} manifest.yaml")
+
+        card_path = skill_dir / "card.json"
+        if not card_path.is_file():
+            continue
+
+        with open(card_path, encoding="utf-8") as f:
+            card = json.load(f)
+
+        card_issuer = card.get("issuer")
+        assert card_issuer is not None, f"{rel} card.json should include issuer"
+        _assert_real_issuer(card_issuer, f"{rel} card.json")
+
+        assert (card_issuer.get("name") or "").strip() == (
+            manifest_issuer.get("name") or ""
+        ).strip(), f"{rel}: card issuer.name should match manifest"
+        assert (card_issuer.get("email") or "").strip() == (
+            manifest_issuer.get("email") or ""
+        ).strip(), f"{rel}: card issuer.email should match manifest"

skillware-0.2.5/tests/test_loader.py

@@ -1,63 +0,0 @@
-import pytest
-from skillware.core.loader import SkillLoader
-
-
-def test_load_skill_not_found():
-    with pytest.raises(FileNotFoundError):
-        SkillLoader.load_skill("nonexistent_skill_path_12345")
-
-
-def test_to_ollama_prompt():
-    dummy_bundle = {
-        "manifest": {
-            "name": "test_ollama_skill",
-            "description": "A very useful test skill.",
-            "parameters": {
-                "type": "object",
-                "properties": {
-                    "arg1": {"type": "string", "description": "The first arg"}
-                },
-                "required": ["arg1"]
-            }
-        }
-    }
-
-    prompt = SkillLoader.to_ollama_prompt(dummy_bundle)
-    assert "### Tool: `test_ollama_skill`" in prompt
-    assert "**Description:** A very useful test skill." in prompt
-    assert "- `arg1` (string): The first arg [Required]" in prompt
-
-
-def test_to_gemini_tool():
-    dummy_bundle = {
-        "manifest": {
-            "name": "test_gemini_skill",
-            "parameters": {
-                "type": "object",
-                "properties": {
-                    "param1": {"type": "string"}
-                }
-            }
-        }
-    }
-    tool = SkillLoader.to_gemini_tool(dummy_bundle)
-    assert tool["name"] == "test_gemini_skill"
-    # Gemini requires UPPERCASE types for Protobufs
-    assert tool["parameters"]["type"] == "OBJECT"
-    assert tool["parameters"]["properties"]["param1"]["type"] == "STRING"
-
-
-def test_to_claude_tool():
-    dummy_bundle = {
-        "manifest": {
-            "name": "test_claude_skill",
-            "description": "desc",
-            "parameters": {
-                "type": "object",
-                "properties": {"arg_claude": {"type": "string"}}
-            }
-        }
-    }
-    tool = SkillLoader.to_claude_tool(dummy_bundle)
-    assert tool["name"] == "test_claude_skill"
-    assert tool["input_schema"]["type"] == "object"