skillware 0.5.0__tar.gz → 0.5.2__tar.gz

{skillware-0.5.0/skillware.egg-info → skillware-0.5.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: skillware
-Version: 0.5.0
+Version: 0.5.2
 Summary: A framework for modular, self-contained AI skills.
 Author-email: ARPA Hellenic Logical Systems <skillware-os@arpacorp.net>
 License: MIT License
@@ -25,12 +25,23 @@ License: MIT License
         OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
         SOFTWARE.
         
-Project-URL: Homepage, https://arpacorp.net
-Project-URL: Repository, https://github.com/arpahls/skillware
+Project-URL: Homepage, https://skillware.site
+Project-URL: Repository, https://github.com/ARPAHLS/skillware
+Project-URL: Documentation, https://github.com/ARPAHLS/skillware/blob/main/docs/introduction.md
+Project-URL: Issues, https://github.com/ARPAHLS/skillware/issues
+Project-URL: Changelog, https://github.com/ARPAHLS/skillware/blob/main/CHANGELOG.md
 Project-URL: DOI, https://doi.org/10.5281/zenodo.21552745
-Classifier: Programming Language :: Python :: 3
+Keywords: ai,agents,skills,llm,tools,framework,agent-tools,registry
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
 Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
 License-File: LICENSE
@@ -100,6 +111,7 @@ Provides-Extra: office-pdf-form-filler
 Requires-Dist: pymupdf; extra == "office-pdf-form-filler"
 Requires-Dist: anthropic; extra == "office-pdf-form-filler"
 Provides-Extra: optimization-prompt-rewriter
+Provides-Extra: security-deceptive-ui-guard
 Provides-Extra: security-prompt-injection-firewall
 Provides-Extra: wellness-mental-coach
 Requires-Dist: google-genai; extra == "wellness-mental-coach"
@@ -380,7 +392,7 @@ PyPI download counts show how often `skillware` is installed from the package in
 
 <a href="https://doi.org/10.5281/zenodo.21552745"><img src="https://img.shields.io/badge/DOI-10.5281%2Fzenodo.21552745-c7d2fe?style=flat-square" alt="DOI 10.5281/zenodo.21552745"></a>
 
-If you use Skillware in research or products, please cite it using [CITATION.cff](CITATION.cff) (GitHub **Cite this repository**) or the Zenodo **concept DOI** above. That DOI is stable across releases. For reproducibility, also record the **Skillware version** you used (PyPI or Git tag, for example `0.5.0`).
+If you use Skillware in research or products, please cite it using [CITATION.cff](CITATION.cff) (GitHub **Cite this repository**) or the Zenodo **concept DOI** above. That DOI is stable across releases. For reproducibility, also record the **Skillware version** you used (PyPI or Git tag, for example `0.5.2`).
 
 ## Contact
 

{skillware-0.5.0 → skillware-0.5.2}/README.md

@@ -263,7 +263,7 @@ PyPI download counts show how often `skillware` is installed from the package in
 
 <a href="https://doi.org/10.5281/zenodo.21552745"><img src="https://img.shields.io/badge/DOI-10.5281%2Fzenodo.21552745-c7d2fe?style=flat-square" alt="DOI 10.5281/zenodo.21552745"></a>
 
-If you use Skillware in research or products, please cite it using [CITATION.cff](CITATION.cff) (GitHub **Cite this repository**) or the Zenodo **concept DOI** above. That DOI is stable across releases. For reproducibility, also record the **Skillware version** you used (PyPI or Git tag, for example `0.5.0`).
+If you use Skillware in research or products, please cite it using [CITATION.cff](CITATION.cff) (GitHub **Cite this repository**) or the Zenodo **concept DOI** above. That DOI is stable across releases. For reproducibility, also record the **Skillware version** you used (PyPI or Git tag, for example `0.5.2`).
 
 ## Contact
 

{skillware-0.5.0 → skillware-0.5.2}/pyproject.toml

@@ -4,18 +4,24 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "skillware"
-version = "0.5.0"
+version = "0.5.2"
 description = "A framework for modular, self-contained AI skills."
 readme = "README.md"
 authors = [
   { name = "ARPA Hellenic Logical Systems", email = "skillware-os@arpacorp.net" },
 ]
-urls = { "Homepage" = "https://arpacorp.net", "Repository" = "https://github.com/arpahls/skillware", "DOI" = "https://doi.org/10.5281/zenodo.21552745" }
 license = { file = "LICENSE" }
 classifiers = [
-    "Programming Language :: Python :: 3",
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
     "License :: OSI Approved :: MIT License",
     "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Artificial Intelligence",
+    "Topic :: Software Development :: Libraries :: Python Modules",
 ]
 dependencies = [
     "requests",
@@ -28,6 +34,16 @@ dependencies = [
 ]
 requires-python = ">=3.10"
 
+keywords = ["ai", "agents", "skills", "llm", "tools", "framework", "agent-tools", "registry"]
+
+[project.urls]
+Homepage = "https://skillware.site"
+Repository = "https://github.com/ARPAHLS/skillware"
+Documentation = "https://github.com/ARPAHLS/skillware/blob/main/docs/introduction.md"
+Issues = "https://github.com/ARPAHLS/skillware/issues"
+Changelog = "https://github.com/ARPAHLS/skillware/blob/main/CHANGELOG.md"
+DOI = "https://doi.org/10.5281/zenodo.21552745"
+
 [project.scripts]
 skillware = "skillware.cli:main"
 
@@ -135,6 +151,8 @@ office_pdf_form_filler = [
 
 optimization_prompt_rewriter = []
 
+security_deceptive_ui_guard = []
+
 security_prompt_injection_firewall = []
 
 wellness_mental_coach = [
@@ -164,6 +182,7 @@ include = ["skillware*", "skills*"]
 # Non-Python skill assets (yaml, md, json, data/) ship via MANIFEST.in (graft skills)
 # and this wildcard. No per-skill entries needed when adding registry skills.
 [tool.setuptools.package-data]
+skillware = ["branding/*"]
 skills = ["**/*"]
 
 [tool.pytest.ini_options]

{skillware-0.5.0 → skillware-0.5.2}/skills/finance/uk_companies_house_handler/data/terminology_map.yaml

@@ -81,8 +81,12 @@ intent_to_action:
   lookup: resolve_company
   look_up: resolve_company
   who_is: get_officers
+  director: get_officers
   directors: get_officers
+  officer: get_officers
   officers: get_officers
+  officer_name: get_officers
+  officer_names: get_officers
   board: get_officers
   management: get_officers
   leadership: get_officers
@@ -98,6 +102,10 @@ intent_to_action:
   filing: get_filing_history
   accounts: get_filing_history
   annual_return: get_filing_history
+  annual_report: get_filing_history
+  10k: get_filing_history
+  10_k: get_filing_history
+  financial_statements: get_filing_history
   documents: get_filing_history
   profile: get_company_profile
   details: get_company_profile
@@ -105,3 +113,6 @@ intent_to_action:
   information: get_company_profile
   status: get_company_profile
   registered: get_company_profile
+  secretary: get_officers
+  corporate_secretary: get_officers
+  beneficial_ownership: get_pscs

skillware-0.5.2/skills/finance/uk_companies_house_handler/instructions.md

@@ -0,0 +1,85 @@
+# UK Companies House Handler
+
+You are using the `finance/uk_companies_house_handler` skill.
+
+This skill wraps the UK Companies House REST API (`api.company-information.service.gov.uk`) with deterministic actions. It returns structured JSON envelopes (`ready`, `partial`, `needs_input`, `error`) — it does not parse conversational user text. **You** infer intent, choose actions, pass clean parameters (`query`, `company_number`, `role_hint`, `category`), handle disambiguation with the user, and render record lists in your reply.
+
+`data/terminology_map.yaml` is a **reference lexicon** for UK/US/finance term equivalents and keyword hints; it is not a substitute for your reasoning. Prefer explicit parameters over relying on keyword routing alone.
+
+## When to use
+
+Use this skill when the user:
+
+- Asks about a UK company (England, Wales, Scotland, or Northern Ireland).
+- Wants directors, officers, secretaries, PSCs, or filing history for a UK entity.
+- Mentions Companies House or a UK company number (8 characters, e.g. `00445790`).
+- Needs multi-step registry lookups that benefit from `run_pipeline` or composite actions.
+
+## UK terminology (present only when the user used non-UK terms)
+
+| User may say | UK registry term | Typical action |
+| :--- | :--- | :--- |
+| CEO, president, chairman | Director | `get_officers` + optional `role_hint: "ceo"` |
+| Owner, shareholder, beneficial owner | Person with Significant Control (PSC) | `get_pscs` |
+| Secretary, corporate secretary | Secretary | `get_officers` |
+| Annual report, 10-K, financials | Accounts / confirmation statement | `get_filing_history` (+ optional `category`) |
+| Company, corporation, LLC | Ltd, PLC, LLP | `resolve_company` |
+
+Only explain terminology when the user used informal or US-centric wording. Do not add disclaimers during disambiguation prompts.
+
+## Available actions
+
+| Action | Purpose | Required params | Optional params |
+| :--- | :--- | :--- | :--- |
+| `resolve_company` | Search by name; ranked candidates | `query` (clean company name) | `limit` |
+| `get_company_profile` | Full profile by number | `company_number` | |
+| `get_officers` | Directors and secretaries | `company_number` | `active_only` (default **true**), `limit`, `role_hint`, `officer_filter` |
+| `get_pscs` | Persons with significant control | `company_number` | `active_only` |
+| `get_filing_history` | Filings (accounts, returns, etc.) | `company_number` | `category`, `limit` |
+| `map_intent` | Suggest an action pipeline from keywords | `intent_keywords` and/or `entities` | `entities.company_query` when actions need a company |
+| `run_pipeline` | Run ordered atomic steps; halt on `needs_input`/`error` | `steps` or resume via `context` | `company_number`, `pipeline`, `stop_on`, `context` |
+| `resolve_and_get_officers` | Resolve + list officers in one call | `query` **or** `company_number` | `role_hint`, `active_only`, `limit`, `officer_filter` |
+| `resolve_and_get_filings` | Resolve + list filings in one call | `query` **or** `company_number` | `category`, `limit` |
+
+**Parameter hygiene:** Pass a **clean** company name in `query` / `entities.company_query` (e.g. `Barclays`, not `Who is the CEO of Barclays?`). Pass conversational role intent via `role_hint` (e.g. `"ceo"`, `"chairman"`). Strip trailing punctuation (`?`, `.`) yourself or rely on the skill's light normalization.
+
+## Playbook — disambiguation and multi-step queries
+
+### Example: "Who is the CEO of Barclays?"
+
+1. **Do not** pass the full sentence as `query`. Call `resolve_and_get_officers` with `query: "Barclays"`, `role_hint: "ceo"` (or `run_pipeline` / `map_intent` + pipeline if you prefer).
+2. If `status` is **`needs_input`**, present `candidates` (e.g. Barclays Bank PLC vs other Barclays entities) and ask the user to pick.
+3. After confirmation, call `get_officers` with the chosen `company_number` (and `role_hint` if still relevant), or resume `run_pipeline` with `company_number` + remaining `steps` / `context`.
+4. Answer the role question using UK director terminology when appropriate, then **render the full `officers[]` list** (name, role, appointed date).
+
+### Multi-intent queries
+
+For combined asks (e.g. *"officers and filings for BP"*):
+
+1. Optionally call `map_intent` with `intent_keywords: "officers, filings"` and `entities: {"company_query": "BP"}` to obtain `suggested_pipeline`.
+2. Execute via `run_pipeline` with atomic steps only (`resolve_company`, `get_officers`, `get_filing_history`, …). Never nest composites inside `run_pipeline`.
+3. On `needs_input`, pause, disambiguate, then resume with `company_number` and updated `context` / `pipeline`.
+
+### Single-intent shortcuts
+
+- Officers only: `resolve_and_get_officers` with clean `query` + optional `role_hint`.
+- Filings only: `resolve_and_get_filings` with clean `query` + optional `category`.
+
+## Understanding responses
+
+| Status | Meaning |
+| :--- | :--- |
+| `ready` | Complete result — present data clearly. |
+| `partial` | Preview (default limit 10 officers or filings). **Always list returned records** and state total counts from the envelope / `agent_hint`. |
+| `needs_input` | Ambiguous search or missing company name for pipeline — use `candidates` or `agent_hint`. |
+| `error` | Check `error_code` and `message`. Use `agent_hint` for retry guidance (`rate_limited`, `timeout`, `connection_error`). |
+
+Every response includes `fetched_at`, `source`, and usually `context`. Pipeline/composite responses may include `pipeline: {"completed_steps": N, "total_steps": M}`.
+
+Common `error_code` values: `not_found`, `no_results`, `rate_limited`, `timeout`, `connection_error`, `missing_query`, `missing_company_number`.
+
+## Limitations
+
+- Read-only public registry data; no document downloads or filing submission (later v2 phases).
+- Rate limit: 600 requests per 5 minutes per API key.
+- Not legal or accounting advice — cite `company_number` and `fetched_at` when presenting data.

skillware-0.5.2/skills/finance/uk_companies_house_handler/manifest.yaml

@@ -0,0 +1,140 @@
+name: finance/uk_companies_house_handler
+version: 1.2.0
+description: |
+  Deterministic UK Companies House API handler for agents. Provides structured
+  operations for company search, profile lookup, officer and PSC listing, filing
+  history, pipeline orchestration, and intent-to-operation mapping with UK corporate
+  terminology translation. Returns status-based responses (ready, partial,
+  needs_input, error) with disambiguation support. The agent owns natural-language
+  dialogue; the skill returns structured candidates and next actions.
+short_description: "UK Companies House search, officers, PSC, filings, and pipeline orchestration via structured actions."
+issuer:
+  name: Areen Agrawal
+  email: agrawalareen09@gmail.com
+  github: Areen-09
+  org: ARPAHLS
+parameters:
+  type: object
+  properties:
+    action:
+      type: string
+      description: >
+        The operation to perform. One of: resolve_company, get_company_profile,
+        get_officers, get_pscs, get_filing_history, map_intent, run_pipeline,
+        resolve_and_get_officers, resolve_and_get_filings.
+      enum:
+        - resolve_company
+        - get_company_profile
+        - get_officers
+        - get_pscs
+        - get_filing_history
+        - map_intent
+        - run_pipeline
+        - resolve_and_get_officers
+        - resolve_and_get_filings
+    query:
+      type: string
+      description: "Company name or partial name for search (resolve_company)."
+    company_query:
+      type: string
+      description: "Company name query for composite actions (resolve_and_get_officers, resolve_and_get_filings)."
+    company_number:
+      type: string
+      description: "8-character UK company number (required for profile/officers/pscs/filing)."
+    active_only:
+      type: boolean
+      description: "Filter to current/active records only. Default true for get_officers."
+    limit:
+      type: integer
+      description: "Max results to return (resolve_company). Default 5."
+    category:
+      type: string
+      description: "Filing category filter (get_filing_history, resolve_and_get_filings)."
+    officer_filter:
+      type: string
+      description: "Name or filter term for officers."
+    role_hint:
+      type: string
+      description: "Requested role or title hint (e.g. 'ceo', 'cfo', 'chairman') for officers lookup and UK terminology note."
+    intent_keywords:
+      type: string
+      description: "Comma-separated keywords from user intent for map_intent action."
+    entities:
+      type: object
+      description: "Extracted entities for map_intent (e.g. company_query, role)."
+    steps:
+      type: array
+      description: "Ordered list of step objects with action and params to execute sequentially (run_pipeline)."
+      items:
+        type: object
+        properties:
+          action:
+            type: string
+          params:
+            type: object
+        required:
+          - action
+    stop_on:
+      type: array
+      description: "List of status strings on which run_pipeline should pause/halt execution. Default: ['needs_input', 'error']."
+      items:
+        type: string
+    context:
+      type: object
+      description: "State carried over from prior skill turns (e.g. company_number, company_name)."
+    pipeline:
+      type: object
+      description: "State of an executing multi-step pipeline (e.g. completed_steps, total_steps) to carry forward."
+  required:
+    - action
+outputs:
+  status:
+    type: string
+    description: "Envelope status: ready, partial, needs_input, or error."
+  source:
+    type: string
+    description: "Data provenance (typically companies_house_api)."
+  fetched_at:
+    type: string
+    description: "UTC ISO timestamp when the response was built."
+  context:
+    type: object
+    description: "Session state to pass on the next call (company_number, role_hint, next_actions, pipeline)."
+  pipeline:
+    type: object
+    description: "Multi-step progress when using run_pipeline or composite actions."
+  agent_hint:
+    type: string
+    description: "Optional guidance for the host agent (disambiguation, partial previews, retries)."
+  company_number:
+    type: string
+    description: "Resolved 8-character company number when applicable."
+  company_name:
+    type: string
+    description: "Registered company name when applicable."
+  officers:
+    type: array
+    description: "Officer records from get_officers or merged pipeline output."
+  filings:
+    type: array
+    description: "Filing records from get_filing_history or merged pipeline output."
+  suggested_pipeline:
+    type: array
+    description: "Ordered steps suggested by map_intent."
+  terminology_map:
+    type: object
+    description: "Keyword-to-UK-registry translations from map_intent."
+constitution: |
+  1. Use only publicly available Companies House data.
+  2. Require COMPANIES_HOUSE_API_KEY via environment; never hardcode or log the key.
+  3. Do not cache personal data (officer names, addresses) beyond the current request.
+  4. Always cite company_number and data timestamp (fetched_at) in responses.
+  5. Never guess a company number; return ranked search hits when ambiguous.
+  6. This skill provides company information, not legal or accounting advice.
+  7. Do not submit filings or modify Companies House records.
+env_vars:
+  COMPANIES_HOUSE_API_KEY:
+    description: "API key from the Companies House Developer Hub. Used as HTTP Basic username with empty password."
+    required: true
+requirements:
+  - requests