skillware 0.3.6__tar.gz → 0.3.7__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: skillware
-Version: 0.3.6
+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

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

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

{skillware-0.3.6 → 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.6 → 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.7/skills/wellness/mental_coach/__init__.py

@@ -0,0 +1,3 @@
+from .skill import MentalCoachSkill
+
+__all__ = ["MentalCoachSkill"]

skillware-0.3.7/skills/wellness/mental_coach/card.json

@@ -0,0 +1,25 @@
+{
+  "name": "Mental Coach",
+  "description": "Wellness coaching guardrail with crisis triage and grounded KB retrieval.",
+  "issuer": {
+    "name": "Masa",
+    "email": "masa88keith@gmail.com",
+    "github": "mrmasa88",
+    "org": "AO"
+  },
+  "icon": "heart",
+  "color": "blue",
+  "ui_schema": {
+    "type": "card",
+    "fields": [
+      {
+        "key": "policy_status",
+        "label": "Policy Status"
+      },
+      {
+        "key": "scope",
+        "label": "Scope"
+      }
+    ]
+  }
+}

skillware-0.3.7/skills/wellness/mental_coach/constraints.py

@@ -0,0 +1,93 @@
+"""Load and apply hard constraints from kb/hard_constraints.yaml."""
+
+from __future__ import annotations
+
+import os
+import re
+from functools import lru_cache
+from typing import Any, Dict, List, Optional
+
+import yaml
+
+_CONSTRAINTS_PATH = os.path.join(
+    os.path.dirname(__file__), "kb", "hard_constraints.yaml"
+)
+
+CLINICAL_PATTERNS: Dict[str, List[str]] = {
+    "no_diagnosis": [
+        r"\bdiagnos(e|is|ing)\b",
+        r"\bdo i have (depression|anxiety|bipolar|adhd|ptsd|ocd)\b",
+        r"\bwhat (disorder|condition|illness) do i have\b",
+        r"\bam i (depressed|bipolar|schizophrenic)\b",
+    ],
+    "no_medication_advice": [
+        r"\b(should i|can i) (take|stop|start) (my )?(medication|meds|antidepressant)\b",
+        r"\bwhat medication\b",
+        r"\bwhat dose\b",
+        r"\bprescribe\b",
+        r"\b(increase|decrease) my (dose|dosage)\b",
+    ],
+    "no_clinical_interpretation": [
+        r"\binterpret my (lab|blood test|test results)\b",
+        r"\bwhat do my results mean\b",
+        r"\bclinical record\b",
+    ],
+}
+
+INJECTION_PATTERNS = [
+    r"ignore (your|all|previous) (rules|instructions|constraints)",
+    r"disregard (your|the) (policy|safety|guidelines)",
+    r"pretend you are (a )?(doctor|therapist|psychiatrist)",
+    r"jailbreak",
+    r"bypass (your|the) (rules|safety|filter)",
+]
+
+
+@lru_cache(maxsize=1)
+def load_constraints_config() -> Dict[str, Any]:
+    with open(_CONSTRAINTS_PATH, "r", encoding="utf-8") as handle:
+        data = yaml.safe_load(handle)
+    return data if isinstance(data, dict) else {}
+
+
+def get_disclaimers(kind: str = "default") -> List[str]:
+    config = load_constraints_config()
+    disclaimers = config.get("disclaimers_required", {})
+    items = disclaimers.get(kind, disclaimers.get("default", []))
+    return list(items) if isinstance(items, list) else []
+
+
+def detect_clinical_violation(text: str) -> Optional[str]:
+    normalized = text.lower()
+    for constraint_id, patterns in CLINICAL_PATTERNS.items():
+        for pattern in patterns:
+            if re.search(pattern, normalized):
+                return constraint_id
+    return None
+
+
+def detect_injection_attempt(text: str) -> bool:
+    normalized = text.lower()
+    return any(re.search(pattern, normalized) for pattern in INJECTION_PATTERNS)
+
+
+def get_playbook_entry(decision: str) -> Dict[str, Any]:
+    config = load_constraints_config()
+    playbook = config.get("escalation_playbook", {})
+    key = {
+        "ESCALATE": "on_escalate",
+        "CAUTION": "on_caution",
+        "OK": "on_ok",
+    }.get(decision, "on_ok")
+    entry = playbook.get(key, {})
+    return entry if isinstance(entry, dict) else {}
+
+
+def list_hard_constraint_ids() -> List[str]:
+    config = load_constraints_config()
+    items = config.get("hard_constraints", [])
+    ids: List[str] = []
+    for item in items:
+        if isinstance(item, dict) and item.get("id"):
+            ids.append(str(item["id"]))
+    return ids

skillware-0.3.7/skills/wellness/mental_coach/crisis_gate.py

@@ -0,0 +1,175 @@
+"""Deterministic crisis gate — runs before retrieval, no LLM dependency."""
+
+from __future__ import annotations
+
+import re
+import unicodedata
+from dataclasses import dataclass, field
+from typing import Dict, List, Sequence, Tuple
+
+# Minimal conservative signal sets (intent-level, not exhaustive lexicons).
+CRISIS_SIGNALS: Dict[str, Sequence[str]] = {
+    "suicidal_ideation": (
+        "kill myself",
+        "end my life",
+        "want to die",
+        "suicidal",
+        "not want to live",
+        "better off dead",
+        "end it all",
+    ),
+    "self_harm": (
+        "hurt myself",
+        "harm myself",
+        "cut myself",
+        "self harm",
+        "self-harm",
+    ),
+    "harm_to_others": (
+        "hurt someone",
+        "kill him",
+        "kill her",
+        "kill them",
+        "harm others",
+        "going to hurt",
+    ),
+    "abuse_or_violence": (
+        "being abused",
+        "he hits me",
+        "she hits me",
+        "sexually assaulted",
+        "domestic violence",
+        "partner hurts me",
+    ),
+    "acute_medical_emergency": (
+        "can't breathe",
+        "cannot breathe",
+        "chest pain",
+        "overdose",
+        "heart attack",
+        "having a stroke",
+    ),
+    "severe_acute_distress": (
+        "can't cope",
+        "cannot cope",
+        "falling apart",
+        "panic attack",
+        "overwhelmed can't function",
+        "completely overwhelmed",
+    ),
+}
+
+CATEGORY_ACTION = {
+    "suicidal_ideation": "ESCALATE",
+    "self_harm": "ESCALATE",
+    "harm_to_others": "ESCALATE",
+    "abuse_or_violence": "ESCALATE",
+    "acute_medical_emergency": "ESCALATE",
+    "severe_acute_distress": "CAUTION",
+}
+
+NEGATION_PREFIXES = (
+    "don't ",
+    "do not ",
+    "never ",
+    "not going to ",
+    "won't ",
+    "wouldn't ",
+)
+
+CJK_RE = re.compile(r"[\u3040-\u30ff\u3400-\u4dbf\u4e00-\u9fff\uac00-\ud7af]")
+NON_ASCII_RE = re.compile(r"[^\x00-\x7F]")
+
+
+@dataclass
+class LanguageAssessment:
+    is_english: bool
+    non_english: bool
+    reason: str = ""
+
+
+@dataclass
+class GateResult:
+    policy_status: str
+    crisis_categories: List[str] = field(default_factory=list)
+    ambiguous: bool = False
+
+
+def normalize_text(text: str) -> str:
+    normalized = unicodedata.normalize("NFKC", text or "")
+    normalized = re.sub(r"\s+", " ", normalized).strip().lower()
+    return normalized
+
+
+def assess_language(text: str) -> LanguageAssessment:
+    if not text.strip():
+        return LanguageAssessment(is_english=True, non_english=False)
+
+    if CJK_RE.search(text):
+        return LanguageAssessment(
+            is_english=False,
+            non_english=True,
+            reason="CJK characters detected; v0.1 is EN-first.",
+        )
+
+    non_ascii = len(NON_ASCII_RE.findall(text))
+    if non_ascii >= 8 or (len(text) > 0 and non_ascii / len(text) > 0.15):
+        return LanguageAssessment(
+            is_english=False,
+            non_english=True,
+            reason="High non-ASCII ratio; v0.1 is EN-first.",
+        )
+
+    return LanguageAssessment(is_english=True, non_english=False)
+
+
+def _has_negation_before(text: str, index: int) -> bool:
+    window = text[max(0, index - 48) : index]
+    return any(prefix in window for prefix in NEGATION_PREFIXES)
+
+
+def _match_signals(normalized: str) -> Tuple[List[str], bool]:
+    matched: List[str] = []
+    ambiguous = False
+    for category, signals in CRISIS_SIGNALS.items():
+        for signal in signals:
+            start = 0
+            while True:
+                idx = normalized.find(signal, start)
+                if idx < 0:
+                    break
+                if _has_negation_before(normalized, idx):
+                    ambiguous = True
+                else:
+                    matched.append(category)
+                start = idx + len(signal)
+    # Preserve order, dedupe
+    seen = set()
+    ordered: List[str] = []
+    for cat in matched:
+        if cat not in seen:
+            ordered.append(cat)
+            seen.add(cat)
+    return ordered, ambiguous
+
+
+def _resolve_policy(categories: Sequence[str], ambiguous: bool) -> str:
+    if categories:
+        if any(CATEGORY_ACTION.get(c) == "ESCALATE" for c in categories):
+            return "ESCALATE"
+        if any(CATEGORY_ACTION.get(c) == "CAUTION" for c in categories):
+            return "CAUTION"
+    if ambiguous:
+        return "CAUTION"
+    return "OK"
+
+
+def evaluate_crisis_gate(user_prompt: str) -> GateResult:
+    normalized = normalize_text(user_prompt)
+    categories, ambiguous = _match_signals(normalized)
+    policy_status = _resolve_policy(categories, ambiguous)
+    return GateResult(
+        policy_status=policy_status,
+        crisis_categories=categories,
+        ambiguous=ambiguous and policy_status != "ESCALATE",
+    )

skillware-0.3.7/skills/wellness/mental_coach/instructions.md

@@ -0,0 +1,37 @@
+# Operational Instructions: Mental Coach
+
+You are an agent equipped with the `wellness/mental_coach` skill.
+
+## When to use this skill
+
+- Before responding to wellness, stress, coping, or psychoeducation requests.
+- When you need deterministic crisis triage and non-clinical scope enforcement.
+- When you must ground coaching guidance in cited KB chunks with required disclaimers.
+
+## What this skill does
+
+1. Runs a deterministic crisis gate first (no LLM) and escalates on danger signals.
+2. Blocks clinical requests (diagnosis, medication advice, clinical interpretation).
+3. Retrieves grounded coaching chunks from the embedded public KB when safe to coach.
+4. Optionally runs a scope evaluator (Gemini) when `run_evaluator` is enabled.
+
+## How to interpret output
+
+- `policy_status: ESCALATE` — stop coaching; use `final_context_for_agent` and resources only.
+- `policy_status: BLOCKED` — decline the clinical request; offer non-clinical alternatives.
+- `policy_status: CAUTION` — proceed gently; include disclaimers and consider resources.
+- `policy_status: OK` — coaching path; follow retrieved citations exactly.
+
+Always surface `disclaimers_required` verbatim in the user-facing reply.
+
+## Limitations
+
+- Supportive coaching and psychoeducation only; not emergency services or licensed care.
+- v0.1 is English-first; non-English input is routed to CAUTION with resources.
+- Optional evaluator requires `GOOGLE_API_KEY` when enabled.
+
+## Example uses
+
+- User: "I feel stressed at work and need coping strategies." -> coaching retrieval path.
+- User: "Can you diagnose my anxiety?" -> blocked clinical path.
+- User: "I want to hurt myself." -> crisis escalation path (no coaching content).

skillware-0.3.7/skills/wellness/mental_coach/kb/corpus.json

@@ -0,0 +1,214 @@
+{
+  "_meta": {
+    "file": "corpus.json",
+    "skill": "wellness/mental_coach",
+    "purpose": "Public grounding KB with generic, publicly-citable coaching content.",
+    "version": "0.1-seed",
+    "language_scope": "EN (EU + North America launch markets)",
+    "content_policy": "All `text` fields are ORIGINAL PARAPHRASED SUMMARIES of public sources (no verbatim copying). `source_url` is provided for grounding and citation. Re-verify each release; some public pages change or note reduced update frequency.",
+    "verified_on": "2026-06-18",
+    "recheck_cadence": "Re-verify wording against source_url every release."
+  },
+  "chunks": [
+    {
+      "chunk_id": "scope-coaching-vs-therapy-0001",
+      "source_doc": "ICF Core Competencies (International Coaching Federation)",
+      "section": "Demonstrates ethical practice",
+      "jurisdiction": "GLOBAL",
+      "session_modes": [
+        "information"
+      ],
+      "framework": "scope",
+      "tags": [
+        "scope",
+        "coaching",
+        "boundary",
+        "referral"
+      ],
+      "text": "Coaching and psychoeducation are future-focused, growth-oriented forms of support for generally well-functioning people. They are distinct from psychotherapy and do not diagnose conditions or treat mental illness. Recognized coaching standards require keeping this distinction clear and referring people to qualified professionals when clinical support is needed.",
+      "safety": {
+        "suppress_in_crisis": true,
+        "requires_disclaimer": true
+      },
+      "source_url": "https://coachingfederation.org/credentialing/icf-core-competencies",
+      "visibility": "public",
+      "version": "0.1",
+      "updated": "2026-06-18"
+    },
+    {
+      "chunk_id": "self-care-not-cure-0002",
+      "source_doc": "NIMH - Caring for Your Mental Health",
+      "section": "Self-care",
+      "jurisdiction": "GLOBAL",
+      "session_modes": [
+        "information",
+        "coaching"
+      ],
+      "framework": "scope",
+      "tags": [
+        "self-care",
+        "limits",
+        "treatment"
+      ],
+      "text": "Self-care can help maintain wellbeing and manage mild symptoms, but it is not a cure for mental illness and does not replace professional treatment when that is needed.",
+      "safety": {
+        "suppress_in_crisis": true,
+        "requires_disclaimer": true
+      },
+      "source_url": "https://www.nimh.nih.gov/health/topics/caring-for-your-mental-health",
+      "visibility": "public",
+      "version": "0.1",
+      "updated": "2026-06-18"
+    },
+    {
+      "chunk_id": "when-to-seek-help-0003",
+      "source_doc": "NIMH - Caring for Your Mental Health",
+      "section": "When to seek professional help",
+      "jurisdiction": "GLOBAL",
+      "session_modes": [
+        "information"
+      ],
+      "framework": "help-seeking",
+      "tags": [
+        "seek-help",
+        "professional",
+        "primary-care"
+      ],
+      "text": "Consider seeking professional help if severe or distressing symptoms persist for two weeks or more. A useful first step is talking with a primary care provider, who can refer you to a qualified mental health professional.",
+      "safety": {
+        "suppress_in_crisis": true,
+        "requires_disclaimer": true
+      },
+      "source_url": "https://www.nimh.nih.gov/health/topics/caring-for-your-mental-health",
+      "visibility": "public",
+      "version": "0.1",
+      "updated": "2026-06-18"
+    },
+    {
+      "chunk_id": "urgent-help-uk-0004",
+      "source_doc": "NHS - Mental health",
+      "section": "Urgent help",
+      "jurisdiction": "UK",
+      "session_modes": [
+        "information"
+      ],
+      "framework": "help-seeking",
+      "tags": [
+        "urgent",
+        "uk",
+        "nhs-111",
+        "emergency"
+      ],
+      "text": "In England, urgent mental health support is available through NHS 111. If someone's life is at immediate risk, call 999 or go to A&E.",
+      "safety": {
+        "suppress_in_crisis": true,
+        "requires_disclaimer": true,
+        "notes": "Pairs with crisis_resources.json UK entries."
+      },
+      "source_url": "https://www.nhs.uk/mental-health/",
+      "visibility": "public",
+      "version": "0.1",
+      "updated": "2026-06-18"
+    },
+    {
+      "chunk_id": "mental-health-continuum-0005",
+      "source_doc": "WHO - Mental health fact sheet",
+      "section": "Concept",
+      "jurisdiction": "GLOBAL",
+      "session_modes": [
+        "information"
+      ],
+      "framework": "psychoeducation",
+      "tags": [
+        "definition",
+        "continuum",
+        "who"
+      ],
+      "text": "Mental health is more than the absence of illness. It exists on a continuum that differs between people and over time, shaped by individual, social, and structural factors, and many mental health conditions can be treated effectively.",
+      "safety": {
+        "suppress_in_crisis": true,
+        "requires_disclaimer": true
+      },
+      "source_url": "https://www.who.int/news-room/fact-sheets/detail/mental-health-strengthening-our-response",
+      "visibility": "public",
+      "version": "0.1",
+      "updated": "2026-06-18"
+    },
+    {
+      "chunk_id": "wellbeing-basics-0006",
+      "source_doc": "NIMH - Caring for Your Mental Health; NHS - Self-help",
+      "section": "Everyday wellbeing",
+      "jurisdiction": "GLOBAL",
+      "session_modes": [
+        "coaching",
+        "information"
+      ],
+      "framework": "wellbeing",
+      "tags": [
+        "sleep",
+        "exercise",
+        "nutrition",
+        "connection"
+      ],
+      "text": "Everyday practices that support wellbeing for many people include regular physical activity, balanced meals and staying hydrated, a consistent sleep routine, and staying socially connected. This is general guidance, not treatment.",
+      "safety": {
+        "suppress_in_crisis": true,
+        "requires_disclaimer": true
+      },
+      "source_url": "https://www.nimh.nih.gov/health/topics/caring-for-your-mental-health",
+      "visibility": "public",
+      "version": "0.1",
+      "updated": "2026-06-18"
+    },
+    {
+      "chunk_id": "mindfulness-general-0007",
+      "source_doc": "NHS - Mindfulness",
+      "section": "Mindfulness",
+      "jurisdiction": "GLOBAL",
+      "session_modes": [
+        "coaching",
+        "information"
+      ],
+      "framework": "wellbeing",
+      "tags": [
+        "mindfulness",
+        "stress",
+        "present-moment"
+      ],
+      "text": "Paying attention to the present moment can improve wellbeing for some people and may help with everyday stress. It does not suit everyone and is not a substitute for professional treatment.",
+      "safety": {
+        "suppress_in_crisis": true,
+        "requires_disclaimer": true
+      },
+      "source_url": "https://www.nhs.uk/mental-health/self-help/tips-and-support/mindfulness/",
+      "visibility": "public",
+      "version": "0.1",
+      "updated": "2026-06-18"
+    },
+    {
+      "chunk_id": "service-disclaimer-0008",
+      "source_doc": "NIMH - Help for Mental Illnesses",
+      "section": "Informational use",
+      "jurisdiction": "GLOBAL",
+      "session_modes": [
+        "information",
+        "coaching"
+      ],
+      "framework": "scope",
+      "tags": [
+        "disclaimer",
+        "informational",
+        "referral"
+      ],
+      "text": "This service provides general support and information only. It does not diagnose conditions, provide treatment, or give personal medical advice. For concerns about your health, consult a qualified professional.",
+      "safety": {
+        "suppress_in_crisis": true,
+        "requires_disclaimer": true
+      },
+      "source_url": "https://www.nimh.nih.gov/health/find-help",
+      "visibility": "public",
+      "version": "0.1",
+      "updated": "2026-06-18"
+    }
+  ]
+}