skillware 0.3.5__tar.gz → 0.3.7__tar.gz

{skillware-0.3.5/skillware.egg-info → skillware-0.3.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: skillware
-Version: 0.3.5
+Version: 0.3.7
 Summary: A framework for modular, self-contained AI skills.
 Author-email: ARPA Hellenic Logical Systems <skillware-os@arpacorp.net>
 License: MIT License
@@ -38,13 +38,13 @@ Requires-Dist: pyyaml
 Requires-Dist: python-dotenv
 Requires-Dist: beautifulsoup4
 Requires-Dist: packaging
+Requires-Dist: rich>=13.0
 Provides-Extra: dev
 Requires-Dist: pytest; extra == "dev"
 Requires-Dist: pytest-mock; extra == "dev"
 Requires-Dist: flake8; extra == "dev"
 Requires-Dist: black; extra == "dev"
 Provides-Extra: cli
-Requires-Dist: rich>=13.0; extra == "cli"
 Provides-Extra: gemini
 Requires-Dist: google-genai; extra == "gemini"
 Provides-Extra: claude
@@ -53,12 +53,20 @@ Provides-Extra: openai
 Requires-Dist: openai; extra == "openai"
 Provides-Extra: office
 Requires-Dist: pymupdf; extra == "office"
+Provides-Extra: defi
+Requires-Dist: web3>=6.0.0; extra == "defi"
+Provides-Extra: embeddings
+Requires-Dist: fastembed; extra == "embeddings"
+Requires-Dist: numpy; extra == "embeddings"
 Provides-Extra: all
 Requires-Dist: rich>=13.0; extra == "all"
 Requires-Dist: google-genai; extra == "all"
 Requires-Dist: anthropic; extra == "all"
 Requires-Dist: openai; extra == "all"
 Requires-Dist: pymupdf; extra == "all"
+Requires-Dist: web3>=6.0.0; extra == "all"
+Requires-Dist: fastembed; extra == "all"
+Requires-Dist: numpy; extra == "all"
 Dynamic: license-file
 
 <div align="center">
@@ -118,7 +126,7 @@ documentation. Runnable provider scripts are indexed in
 ```text
 Skillware/
 ├── docs/                       # Introduction, testing, skill catalog, usage guides (docs/usage/)
-├── examples/                   # Provider reference scripts (Gemini, Claude, OpenAI, Ollama, ...)
+├── examples/                   # Provider reference scripts — usage demos, not pytest (see examples/README.md)
 ├── skills/                     # Skill Registry
 │   └── category/               # Domain boundaries (e.g., finance)
 │       └── skill_name/         # The Skill bundle
@@ -126,7 +134,7 @@ Skillware/
 │           ├── skill.py        # Executable Python logic
 │           ├── instructions.md # Cognitive map for the LLM
 │           ├── card.json       # Optional UI presentation metadata
-│           └── test_skill.py   # Unit tests and schema validation
+│           └── test_skill.py   # Bundle test (required for new skills; see docs/TESTING.md)
 ├── skillware/                  # Core Framework Package
 │   ├── cli.py                  # Command-line interface
 │   └── core/
@@ -135,7 +143,9 @@ Skillware/
 │       └── loader.py           # Universal Skill Loader and Model Adapter
 ├── templates/                  # Boilerplate templates for new skills
 │   └── python_skill/           # Standard template with required files
-└── tests/                      # Automated test suite
+└── tests/                      # Clone-repo tests (framework + optional maintainer skill tests)
+    ├── test_*.py               # Framework tests (loader, CLI, issuer, …)
+    └── skills/                 # Optional maintainer skill tests (edge cases)
 ```
 
 ## Quick Start
@@ -161,11 +171,16 @@ pip install -e .
 ### 2. Verify your installation
 
 ```bash
-pip install "skillware[cli]"
 skillware list
 ```
 
-This prints a table of all locally available skills and confirms the install and path resolution are working. Running `skillware` with no arguments opens the interactive menu.
+This prints a table of all locally available skills and confirms the install
+and path resolution are working. Running `skillware` with no arguments opens
+the interactive menu.
+
+If `skillware` is not recognized, Python's `Scripts` directory may not be on
+your PATH — use `python -m skillware list` as a fallback. See
+[CLI Reference](docs/usage/cli.md#running-the-cli) for details.
 
 ### 3. Configuration
 

{skillware-0.3.5 → skillware-0.3.7}/README.md

@@ -55,7 +55,7 @@ documentation. Runnable provider scripts are indexed in
 ```text
 Skillware/
 ├── docs/                       # Introduction, testing, skill catalog, usage guides (docs/usage/)
-├── examples/                   # Provider reference scripts (Gemini, Claude, OpenAI, Ollama, ...)
+├── examples/                   # Provider reference scripts — usage demos, not pytest (see examples/README.md)
 ├── skills/                     # Skill Registry
 │   └── category/               # Domain boundaries (e.g., finance)
 │       └── skill_name/         # The Skill bundle
@@ -63,7 +63,7 @@ Skillware/
 │           ├── skill.py        # Executable Python logic
 │           ├── instructions.md # Cognitive map for the LLM
 │           ├── card.json       # Optional UI presentation metadata
-│           └── test_skill.py   # Unit tests and schema validation
+│           └── test_skill.py   # Bundle test (required for new skills; see docs/TESTING.md)
 ├── skillware/                  # Core Framework Package
 │   ├── cli.py                  # Command-line interface
 │   └── core/
@@ -72,7 +72,9 @@ Skillware/
 │       └── loader.py           # Universal Skill Loader and Model Adapter
 ├── templates/                  # Boilerplate templates for new skills
 │   └── python_skill/           # Standard template with required files
-└── tests/                      # Automated test suite
+└── tests/                      # Clone-repo tests (framework + optional maintainer skill tests)
+    ├── test_*.py               # Framework tests (loader, CLI, issuer, …)
+    └── skills/                 # Optional maintainer skill tests (edge cases)
 ```
 
 ## Quick Start
@@ -98,11 +100,16 @@ pip install -e .
 ### 2. Verify your installation
 
 ```bash
-pip install "skillware[cli]"
 skillware list
 ```
 
-This prints a table of all locally available skills and confirms the install and path resolution are working. Running `skillware` with no arguments opens the interactive menu.
+This prints a table of all locally available skills and confirms the install
+and path resolution are working. Running `skillware` with no arguments opens
+the interactive menu.
+
+If `skillware` is not recognized, Python's `Scripts` directory may not be on
+your PATH — use `python -m skillware list` as a fallback. See
+[CLI Reference](docs/usage/cli.md#running-the-cli) for details.
 
 ### 3. Configuration
 

{skillware-0.3.5 → skillware-0.3.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "skillware"
-version = "0.3.5"
+version = "0.3.7"
 description = "A framework for modular, self-contained AI skills."
 readme = "README.md"
 authors = [
@@ -23,6 +23,7 @@ dependencies = [
     "python-dotenv",
     "beautifulsoup4",
     "packaging",
+    "rich>=13.0",
 ]
 requires-python = ">=3.10"
 
@@ -36,9 +37,7 @@ dev = [
     "flake8",
     "black",
 ]
-cli = [
-    "rich>=13.0",
-]
+cli = []
 gemini = [
     "google-genai",
 ]
@@ -51,12 +50,22 @@ openai = [
 office = [
     "pymupdf",
 ]
+defi = [
+    "web3>=6.0.0",
+]
+embeddings = [
+    "fastembed",
+    "numpy",
+]
 all = [
     "rich>=13.0",
     "google-genai",
     "anthropic",
     "openai",
     "pymupdf",
+    "web3>=6.0.0",
+    "fastembed",
+    "numpy",
 ]
 
 [tool.setuptools]
@@ -70,6 +79,10 @@ include = ["skillware*", "skills*"]
 [tool.setuptools.package-data]
 skills = ["**/*"]
 
+[tool.pytest.ini_options]
+testpaths = ["tests", "skills"]
+addopts = "--ignore=examples"
+
 [tool.black]
 line-length = 88
 target-version = ["py310"]

skillware-0.3.7/skills/compliance/mica_module/test_skill.py

@@ -0,0 +1,67 @@
+import os
+
+import pytest
+import yaml
+
+from .skill import MiCAModuleSkill
+
+
+@pytest.fixture
+def skill():
+    return MiCAModuleSkill()
+
+
+@pytest.fixture
+def manifest():
+    manifest_path = os.path.join(os.path.dirname(__file__), "manifest.yaml")
+    with open(manifest_path, "r", encoding="utf-8") as f:
+        return yaml.safe_load(f)
+
+
+def test_skill_manifest_consistency(skill, manifest):
+    skill_manifest = skill.manifest
+    assert skill_manifest["name"] == manifest["name"]
+    assert skill_manifest["version"] == manifest["version"]
+
+
+def test_stateless_rag_execution(skill):
+    result = skill.execute(
+        {
+            "user_prompt": (
+                "I want to issue an asset-referenced token. "
+                "What are the authorization rules?"
+            ),
+            "run_evaluator": False,
+        }
+    )
+    assert result["policy_status"] == "CAUTION"
+    assert "retrieved_sections" in result
+    assert "final_context_for_agent" in result
+    assert "Evaluator disabled" in result["gemini_evaluator_feedback"]["holes_found"]
+
+
+def test_router_normalization(skill):
+    mock_corpus = [
+        {
+            "title_num": "Title V",
+            "article_num": "Article 59",
+            "keywords": ["authorisation", "casp"],
+            "content": "CASP Authorization rules...",
+        }
+    ]
+    matched = skill._route_and_fetch("Authorization of a CASP", mock_corpus)
+    assert len(matched) > 0
+    assert matched[0]["article_num"] == "Article 59"
+
+
+def test_router_deduplication(skill):
+    mock_corpus = [
+        {
+            "title_num": "Title V",
+            "article_num": "Article 59",
+            "keywords": ["authorisation", "casp"],
+            "content": "CASP Authorization rules...",
+        }
+    ]
+    matched = skill._route_and_fetch("authorisation casp", mock_corpus)
+    assert len(matched) == 1

skillware-0.3.7/skills/compliance/pii_masker/test_skill.py

@@ -0,0 +1,58 @@
+import os
+
+import pytest
+import yaml
+
+from .skill import PIIMaskerSkill
+
+
+@pytest.fixture
+def skill():
+    return PIIMaskerSkill()
+
+
+@pytest.fixture
+def manifest():
+    manifest_path = os.path.join(os.path.dirname(__file__), "manifest.yaml")
+    with open(manifest_path, "r", encoding="utf-8") as f:
+        return yaml.safe_load(f)
+
+
+def test_skill_manifest_consistency(skill, manifest):
+    skill_manifest = skill.manifest
+    assert skill_manifest["name"] == manifest["name"]
+    assert skill_manifest["version"] == manifest["version"]
+
+
+def test_pii_masker_modes(mocker, skill):
+    mock_response = (
+        "Hello [PERSON_1], your wallet [CRYPTO_ADDRESS] and [EMAIL] have been verified."
+    )
+    mocker.patch.object(
+        skill,
+        "_call_ollama",
+        return_value=(mock_response, ["PERSON_1", "CRYPTO_ADDRESS", "EMAIL"]),
+    )
+
+    sample_text = (
+        "Hello John Doe, your wallet 0xabc and john@doe.com have been verified."
+    )
+
+    result_mask = skill.execute({"text": sample_text})
+    assert (
+        result_mask["sanitized_text"]
+        == "Hello [PERSON_1], your wallet [CRYPTO_ADDRESS] and [EMAIL] have been verified."
+    )
+    assert "PERSON" in result_mask["metadata"]["detected_entities"]
+    assert "CRYPTO_ADDRESS" in result_mask["metadata"]["detected_entities"]
+
+    result_redact = skill.execute({"text": sample_text, "mode": "redact"})
+    assert (
+        result_redact["sanitized_text"]
+        == "Hello XXXX, your wallet XXXX and XXXX have been verified."
+    )
+
+    result_remove = skill.execute({"text": sample_text, "mode": "remove"})
+    assert (
+        result_remove["sanitized_text"] == "Hello , your wallet and have been verified."
+    )

{skillware-0.3.5 → skillware-0.3.7}/skills/data_engineering/novelty_extractor/test_skill.py

@@ -1,32 +1,66 @@
+import os
+from unittest.mock import MagicMock
+
+import numpy as np
 import pytest
 import yaml
-import os
+
 from .skill import NoveltyExtractor
 
 
+def _mock_embed_vectors(texts):
+    """Deterministic keyword vectors — no HuggingFace download in CI."""
+    vectors = []
+    for text in texts:
+        t = text.lower()
+        if "bitcoin" in t:
+            vectors.append(np.array([1.0, 0.0, 0.0], dtype=float))
+        elif "sky" in t or "blue" in t:
+            vectors.append(np.array([0.0, 1.0, 0.0], dtype=float))
+        elif "python" in t:
+            vectors.append(np.array([0.0, 0.0, 1.0], dtype=float))
+        else:
+            vectors.append(np.array([0.1, 0.1, 0.1], dtype=float))
+    return vectors
+
+
+@pytest.fixture(autouse=True)
+def mock_embedding_model(monkeypatch):
+    """Bundle tests must stay offline; mock fastembed to avoid HF rate limits in CI."""
+    NoveltyExtractor._model = None
+    mock_model = MagicMock()
+    mock_model.embed.side_effect = _mock_embed_vectors
+
+    @classmethod
+    def _fake_get_model(cls):
+        if cls._model is None:
+            cls._model = mock_model
+        return cls._model
+
+    monkeypatch.setattr(NoveltyExtractor, "_get_model", _fake_get_model)
+    yield
+    NoveltyExtractor._model = None
+
+
 @pytest.fixture
 def skill():
-    """Fixture to initialize the skill."""
     return NoveltyExtractor()
 
 
 @pytest.fixture
 def manifest():
-    """Fixture to load manifest.yaml for validation."""
     manifest_path = os.path.join(os.path.dirname(__file__), "manifest.yaml")
     with open(manifest_path, "r", encoding="utf-8") as f:
         return yaml.safe_load(f)
 
 
 def test_skill_manifest_consistency(skill, manifest):
-    """Verify the skill manifest matches manifest.yaml."""
     skill_manifest = skill.manifest
     assert skill_manifest["name"] == manifest["name"]
     assert skill_manifest["version"] == manifest["version"]
 
 
 def test_skill_returns_dict(skill):
-    """Execution result must be a dictionary."""
     result = skill.execute(
         {
             "dataset_chunk": "Bitcoin is going to rise.\n\nThe sky is blue.",
@@ -37,7 +71,6 @@ def test_skill_returns_dict(skill):
 
 
 def test_skill_output_keys(skill):
-    """Result must contain the three expected output keys."""
     result = skill.execute(
         {
             "dataset_chunk": "Bitcoin is going to rise.\n\nThe sky is blue.",
@@ -50,7 +83,6 @@ def test_skill_output_keys(skill):
 
 
 def test_skill_filters_redundant_chunks(skill):
-    """Semantically similar chunks should be filtered out."""
     result = skill.execute(
         {
             "dataset_chunk": (
@@ -67,7 +99,6 @@ def test_skill_filters_redundant_chunks(skill):
 
 
 def test_skill_empty_input(skill):
-    """Empty input should return empty result without crashing."""
     result = skill.execute(
         {
             "dataset_chunk": "",
@@ -79,7 +110,6 @@ def test_skill_empty_input(skill):
 
 
 def test_skill_baseline_filters_seen_content(skill):
-    """Chunks already in baseline should be filtered out."""
     baseline = "Bitcoin is going to rise.\n\nThe sky is blue."
     result = skill.execute(
         {
@@ -93,7 +123,6 @@ def test_skill_baseline_filters_seen_content(skill):
 
 
 def test_skill_sentence_strategy(skill):
-    """Sentence chunking strategy should work without crashing."""
     result = skill.execute(
         {
             "dataset_chunk": "Bitcoin is going to rise. The sky is blue. Python is great.",

skillware-0.3.7/skills/data_engineering/synthetic_generator/test_skill.py

@@ -0,0 +1,58 @@
+import os
+
+import pytest
+import yaml
+
+from .skill import SyntheticGeneratorSkill
+
+
+@pytest.fixture
+def skill():
+    return SyntheticGeneratorSkill()
+
+
+@pytest.fixture
+def manifest():
+    manifest_path = os.path.join(os.path.dirname(__file__), "manifest.yaml")
+    with open(manifest_path, "r", encoding="utf-8") as f:
+        return yaml.safe_load(f)
+
+
+def test_skill_manifest_consistency(skill, manifest):
+    skill_manifest = skill.manifest
+    assert skill_manifest["name"] == manifest["name"]
+    assert skill_manifest["version"] == manifest["version"]
+
+
+def test_entropy_score(skill):
+    low_entropy_text = "test " * 100
+    score_low = skill._calculate_entropy_score(low_entropy_text)
+
+    high_text = "The brown fox jumps over the dog. Programming is fun!"
+    score_high = skill._calculate_entropy_score(high_text)
+
+    assert score_high > score_low
+
+
+def test_execute_success(mocker, skill):
+    mock_json_response = """```json
+[
+  {"instruction": "x", "input": "y", "output": "z"}
+]
+```"""
+    mocker.patch.object(skill, "_call_gemini", return_value=mock_json_response)
+
+    result = skill.execute(
+        {
+            "domain": "test domain",
+            "num_samples": 1,
+            "diversity_prompt": "be diverse",
+            "model_provider": "gemini",
+        }
+    )
+
+    assert result["status"] == "success"
+    assert result["provider_used"] == "gemini"
+    assert result["samples_generated"] == 1
+    assert "samples" in result
+    assert result["samples"][0]["instruction"] == "x"

{skillware-0.3.5 → skillware-0.3.7}/skills/finance/wallet_screening/card.json

@@ -12,10 +12,10 @@
   "ui_schema": {
     "type": "card",
     "fields": [
-      {"key": "summary.address", "label": "Address"},
-      {"key": "summary.sanctioned", "label": "Sanctioned", "type": "status_badge"},
-      {"key": "summary.malicious_interactions_count", "label": "Risky Interactions", "type": "count"},
-      {"key": "summary.pnl_eth", "label": "PnL (ETH)", "type": "currency"}
+      {"key": "metadata.wallet_address", "label": "Address"},
+      {"key": "summary.sanctioned_entity_match", "label": "Sanctioned", "type": "status_badge"},
+      {"key": "summary.malicious_interaction_count", "label": "Risky Interactions", "type": "count"},
+      {"key": "financial_analysis.pnl_eth", "label": "PnL (ETH)", "type": "currency"}
     ]
   }
 }

{skillware-0.3.5 → skillware-0.3.7}/skills/finance/wallet_screening/instructions.md

@@ -1,6 +1,6 @@
 # Wallet Screening Skill Instructions
 
-You are equipped with the `wallet_screening` skill. This tool allows you to perform due diligence on Ethereum addresses.
+You are equipped with the `finance/wallet_screening` skill. This tool allows you to perform due diligence on Ethereum addresses.
 
 ## When to use
 Use this skill when the user:
@@ -13,10 +13,10 @@ Use this skill when the user:
 The tool returns a JSON object. You should summarize this for the user in a professional, "Compliance Officer" tone.
 
 ### Key Fields to Check:
-1.  **`summary.sanctioned` (Boolean)**: If `true`, this is CRITICAL. Report the `sanctions_hits` immediately.
-2.  **`summary.malicious_interactions` (Integer)**: If > 0, the wallet has touched bad actors. List the `malicious_contracts_check.matches`.
-3.  **`summary.pnl`**: Profit and Loss. Useful for determining if it's a profitable trader or a victim.
-4.  **`counterparty_analysis`**: Who are they sending money to?
+1.  **`summary.sanctioned_entity_match` (Boolean)**: If `true`, this is CRITICAL. Report the `risk_details.sanctions_hits` immediately.
+2.  **`summary.malicious_interaction_count` (Integer)**: If > 0, the wallet has touched bad actors. List the `risk_details.malicious_interactions`.
+3.  **`financial_analysis.pnl_eth` / `pnl_usd`**: Profit and Loss. Useful for determining if it's a profitable trader or a victim.
+4.  **`network_analysis.top_10_counterparties`**: Who are they sending money to?
 
 ## Safety Protocol
 *   If a wallet is **Sanctioned**: severe warning. "⚠️ WARNING: This wallet appears on the following sanctions lists..."

{skillware-0.3.5 → skillware-0.3.7}/skills/finance/wallet_screening/manifest.yaml

@@ -1,4 +1,4 @@
-name: wallet_screening
+name: finance/wallet_screening
 version: 1.0.0
 description: |
   A comprehensive crypto wallet screening tool. Checks Ethereum addresses against sanctions lists (OFAC, FBI, etc.) and known malicious contracts (Mixers, Scams). analyze transaction history for risk.

{skillware-0.3.5 → skillware-0.3.7}/skills/finance/wallet_screening/skill.py

@@ -3,6 +3,7 @@ import os
 import re
 import requests
 import glob
+import yaml
 from typing import Any, Dict, List, Optional
 from datetime import datetime
 from skillware.core.base_skill import BaseSkill
@@ -44,6 +45,10 @@ class WalletScreeningSkill(BaseSkill):
 
     @property
     def manifest(self) -> Dict[str, Any]:
+        manifest_path = os.path.join(os.path.dirname(__file__), "manifest.yaml")
+        if os.path.exists(manifest_path):
+            with open(manifest_path, "r", encoding="utf-8") as f:
+                return yaml.safe_load(f)
         return {}
 
     def execute(self, params: Dict[str, Any]) -> Dict[str, Any]:

skillware-0.3.7/skills/finance/wallet_screening/test_skill.py

@@ -0,0 +1,84 @@
+import os
+from unittest.mock import MagicMock, patch
+
+import pytest
+import yaml
+
+from .skill import WalletScreeningSkill
+
+
+@pytest.fixture
+def skill():
+    return WalletScreeningSkill()
+
+
+@pytest.fixture
+def manifest():
+    manifest_path = os.path.join(os.path.dirname(__file__), "manifest.yaml")
+    with open(manifest_path, "r", encoding="utf-8") as f:
+        return yaml.safe_load(f)
+
+
+def test_skill_manifest_consistency(skill, manifest):
+    skill_manifest = skill.manifest
+    assert skill_manifest["name"] == manifest["name"]
+    assert skill_manifest["version"] == manifest["version"]
+
+
+def test_invalid_address(skill):
+    result = skill.execute({"address": "invalid_addr"})
+    assert "error" in result
+    assert "Invalid Ethereum address" in result["error"]
+
+
+def test_missing_api_key(skill):
+    skill.etherscan_api_key = None
+    result = skill.execute({"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"})
+    assert "error" in result
+    assert "Missing ETHERSCAN_API_KEY" in result["error"]
+
+
+@patch("skills.finance.wallet_screening.skill.requests.get")
+def test_execute_success(mock_get, skill):
+    skill.etherscan_api_key = "dummy_key"
+
+    mock_eth_balance = MagicMock()
+    mock_eth_balance.json.return_value = {
+        "status": "1",
+        "result": "1000000000000000000",
+    }
+
+    mock_txs = MagicMock()
+    mock_txs.json.return_value = {
+        "status": "1",
+        "result": [
+            {
+                "from": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045".lower(),
+                "to": "0x123",
+                "value": "500000000000000000",
+                "isError": "0",
+                "gasUsed": "21000",
+                "gasPrice": "1000000000",
+            }
+        ],
+    }
+
+    mock_price = MagicMock()
+    mock_price.json.return_value = {"ethereum": {"usd": 2000.0, "eur": 1800.0}}
+
+    def get_side_effect(url, **kwargs):
+        params = kwargs.get("params") or {}
+        if params.get("action") == "balance":
+            return mock_eth_balance
+        if params.get("action") == "txlist":
+            return mock_txs
+        return mock_price
+
+    mock_get.side_effect = get_side_effect
+
+    result = skill.execute({"address": "0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045"})
+
+    assert "error" not in result
+    assert "summary" in result
+    assert result["summary"]["balance_eth"] == 1.0
+    assert result["summary"]["balance_usd"] == 2000.0