skillware 0.4.2__tar.gz → 0.4.5__tar.gz

{skillware-0.4.2/skillware.egg-info → skillware-0.4.5}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: skillware
-Version: 0.4.2
+Version: 0.4.5
 Summary: A framework for modular, self-contained AI skills.
 Author-email: ARPA Hellenic Logical Systems <skillware-os@arpacorp.net>
 License: MIT License
@@ -38,35 +38,77 @@ Requires-Dist: pyyaml
 Requires-Dist: python-dotenv
 Requires-Dist: beautifulsoup4
 Requires-Dist: packaging
+Requires-Dist: jsonschema>=4.0
 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
 Provides-Extra: gemini
 Requires-Dist: google-genai; extra == "gemini"
 Provides-Extra: claude
 Requires-Dist: anthropic; extra == "claude"
 Provides-Extra: openai
 Requires-Dist: openai; extra == "openai"
-Provides-Extra: office
-Requires-Dist: pymupdf; extra == "office"
+Provides-Extra: agents
+Requires-Dist: google-genai; extra == "agents"
+Requires-Dist: anthropic; extra == "agents"
+Requires-Dist: openai; extra == "agents"
+Provides-Extra: compliance
+Requires-Dist: google-genai; extra == "compliance"
+Provides-Extra: creative
+Requires-Dist: onnxruntime; extra == "creative"
+Requires-Dist: pillow; extra == "creative"
+Requires-Dist: rembg>=2.0.0; extra == "creative"
+Provides-Extra: data-engineering
+Requires-Dist: fastembed; extra == "data-engineering"
+Requires-Dist: numpy; extra == "data-engineering"
 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: dev-tools
+Provides-Extra: finance
+Provides-Extra: monitoring
+Provides-Extra: office
+Requires-Dist: anthropic; extra == "office"
+Requires-Dist: pymupdf; extra == "office"
+Provides-Extra: optimization
+Provides-Extra: wellness
+Requires-Dist: google-genai; extra == "wellness"
+Provides-Extra: compliance-mica-module
+Requires-Dist: google-genai; extra == "compliance-mica-module"
+Provides-Extra: compliance-pii-masker
+Provides-Extra: compliance-tos-evaluator
+Provides-Extra: creative-bg-remover
+Requires-Dist: rembg>=2.0.0; extra == "creative-bg-remover"
+Requires-Dist: pillow; extra == "creative-bg-remover"
+Requires-Dist: onnxruntime; extra == "creative-bg-remover"
+Provides-Extra: data-engineering-novelty-extractor
+Requires-Dist: fastembed; extra == "data-engineering-novelty-extractor"
+Requires-Dist: numpy; extra == "data-engineering-novelty-extractor"
+Provides-Extra: data-engineering-synthetic-generator
+Provides-Extra: defi-evm-tx-handler
+Requires-Dist: web3>=6.0.0; extra == "defi-evm-tx-handler"
+Provides-Extra: dev-tools-issue-resolver
+Provides-Extra: finance-uk-companies-house-handler
+Provides-Extra: finance-wallet-screening
+Provides-Extra: monitoring-token-limiter
+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: wellness-mental-coach
+Requires-Dist: google-genai; extra == "wellness-mental-coach"
 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: google-genai; extra == "all"
 Requires-Dist: numpy; extra == "all"
+Requires-Dist: onnxruntime; extra == "all"
+Requires-Dist: pillow; extra == "all"
+Requires-Dist: pymupdf; extra == "all"
+Requires-Dist: rembg>=2.0.0; extra == "all"
+Requires-Dist: web3>=6.0.0; extra == "all"
 Dynamic: license-file
 
 <div align="center">
@@ -183,21 +225,24 @@ cd skillware
 pip install -e ".[dev,all]"
 ```
 
-For documentation-only work, `pip install -e ".[dev]"` is enough. Skill and framework contributors should use `[dev,all]` to match CI (see [TESTING.md](docs/TESTING.md)).
+For documentation-only work, `pip install -e ".[dev]"` is enough. Skill and framework contributors should use `[dev,all]` to match CI (see [TESTING.md](docs/TESTING.md) and [Install extras](docs/usage/install_extras.md)).
 
-> **Note**: Individual skills may have their own dependencies. The `SkillLoader` validates `manifest.yaml` and warns of missing packages (e.g., `requests`, `pandas`) upon loading a skill.
+> **Note**: Every skill has a dedicated pip extra (`pip install "skillware[category_skill]"`). The `SkillLoader` validates `manifest.yaml` on load and suggests the matching extra when packages are missing. See [Install extras](docs/usage/install_extras.md).
 
 ### 2. Verify your installation
 
 ```bash
 skillware list
+skillware paths
 ```
 
 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. As optional checks you can also run `skillware test` to
-execute bundle tests, and `skillware examples` to browse the runnable example
-index (fetched from GitHub when no local `examples/README.md` is present).
+and path resolution are working. `skillware paths` shows the same root order
+the loader uses (external → project → bundled), tier labels, and shadowing.
+Running `skillware` with no arguments opens the interactive menu. As optional
+checks you can also run `skillware test` to execute bundle tests, and
+`skillware examples` to browse the runnable example index (fetched from GitHub
+when no local `examples/README.md` is present).
 
 If `skillware` is not recognized, Python's `Scripts` directory may not be on
 your PATH — use `python -m skillware list` as a fallback. See
@@ -221,6 +266,8 @@ Copy-Item .env.example .env
 
 Edit `.env` with agent keys (for example Gemini) and any keys your skills need. Agent keys power your LLM client; skill keys are declared per skill in the [Skill library](docs/skills/README.md). See [API keys for skills](docs/usage/api_keys.md) for setup, security, and framework variables.
 
+> Note: any loaded skill runs in your process and can read every variable in `os.environ`. Before wiring in real keys — especially with skills you did not write — see the [skill trust model](docs/security/skill-trust-model.md).
+
 ### 4. Usage Example (Gemini)
 
 This example requires the Google SDK optional extra: `pip install "skillware[gemini]"` (local dev: `pip install -e ".[gemini]"`). See the [Gemini usage guide](docs/usage/gemini.md) for setup details.
@@ -289,14 +336,15 @@ For other providers and shared integration patterns, see the [usage guides index
 | Topic | Links |
 | :--- | :--- |
 | **Introduction** | [Introduction](docs/introduction.md) · [Vision](docs/vision.md) · [Comparison](COMPARISON.md) |
-| **Usage guides** | [Skill Library](docs/skills/README.md) · [Usage Guide](docs/usage/README.md) · [Examples](examples/README.md) · [Agent Loops](docs/usage/agent_loops.md) · [API Keys](docs/usage/api_keys.md) · [CLI](docs/usage/cli.md) |
+| **Usage guides** | [Skill Library](docs/skills/README.md) · [Usage Guide](docs/usage/README.md) · [Install extras](docs/usage/install_extras.md) · [Examples](examples/README.md) · [Agent Loops](docs/usage/agent_loops.md) · [API Keys](docs/usage/api_keys.md) · [CLI](docs/usage/cli.md) |
+| **Security** | [Skill trust model](docs/security/skill-trust-model.md) · [SECURITY.md](SECURITY.md) |
 | **Contributing** | [Contributing](CONTRIBUTING.md) · [Agent Native Workflow](docs/contributing/ai_native_workflow.md) · [Testing](docs/TESTING.md) · [Changelog](CHANGELOG.md) |
 
 ## Contributing
 
 We are building the "App Store" for Agents. Skills are the main contribution, but documentation, tests, and framework fixes are welcome too. Human operators and supervised agents follow the same standards: scoped PRs, deterministic behavior, and verified tests.
 
-See the **Contributing** row in [Documentation](#documentation) for the full path, [Contributing](CONTRIBUTING.md) (types, skill standard, PR process), [Agent Native Workflow](docs/contributing/ai_native_workflow.md) (for autonomous and semi-autonomous agents), [Testing](docs/TESTING.md) (Black, Flake8, framework and skill pytest, pre-PR checklist), and [Changelog](CHANGELOG.md) (user-facing entries under `[Unreleased]`).
+Start with [Contributing](CONTRIBUTING.md) (types, skill standard, PR process), [Agent Native Workflow](docs/contributing/ai_native_workflow.md) (for autonomous and semi-autonomous agents), [Testing](docs/TESTING.md) (Black, Flake8, framework and skill pytest, pre-PR checklist), and [Changelog](CHANGELOG.md) (user-facing entries under `[Unreleased]`).
 
 Also read the [Agent Code of Conduct](CODE_OF_CONDUCT.md). Open PRs with the [pull request template](.github/PULL_REQUEST_TEMPLATE.md) and complete only the sections that apply.
 

{skillware-0.4.2 → skillware-0.4.5}/README.md

@@ -112,21 +112,24 @@ cd skillware
 pip install -e ".[dev,all]"
 ```
 
-For documentation-only work, `pip install -e ".[dev]"` is enough. Skill and framework contributors should use `[dev,all]` to match CI (see [TESTING.md](docs/TESTING.md)).
+For documentation-only work, `pip install -e ".[dev]"` is enough. Skill and framework contributors should use `[dev,all]` to match CI (see [TESTING.md](docs/TESTING.md) and [Install extras](docs/usage/install_extras.md)).
 
-> **Note**: Individual skills may have their own dependencies. The `SkillLoader` validates `manifest.yaml` and warns of missing packages (e.g., `requests`, `pandas`) upon loading a skill.
+> **Note**: Every skill has a dedicated pip extra (`pip install "skillware[category_skill]"`). The `SkillLoader` validates `manifest.yaml` on load and suggests the matching extra when packages are missing. See [Install extras](docs/usage/install_extras.md).
 
 ### 2. Verify your installation
 
 ```bash
 skillware list
+skillware paths
 ```
 
 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. As optional checks you can also run `skillware test` to
-execute bundle tests, and `skillware examples` to browse the runnable example
-index (fetched from GitHub when no local `examples/README.md` is present).
+and path resolution are working. `skillware paths` shows the same root order
+the loader uses (external → project → bundled), tier labels, and shadowing.
+Running `skillware` with no arguments opens the interactive menu. As optional
+checks you can also run `skillware test` to execute bundle tests, and
+`skillware examples` to browse the runnable example index (fetched from GitHub
+when no local `examples/README.md` is present).
 
 If `skillware` is not recognized, Python's `Scripts` directory may not be on
 your PATH — use `python -m skillware list` as a fallback. See
@@ -150,6 +153,8 @@ Copy-Item .env.example .env
 
 Edit `.env` with agent keys (for example Gemini) and any keys your skills need. Agent keys power your LLM client; skill keys are declared per skill in the [Skill library](docs/skills/README.md). See [API keys for skills](docs/usage/api_keys.md) for setup, security, and framework variables.
 
+> Note: any loaded skill runs in your process and can read every variable in `os.environ`. Before wiring in real keys — especially with skills you did not write — see the [skill trust model](docs/security/skill-trust-model.md).
+
 ### 4. Usage Example (Gemini)
 
 This example requires the Google SDK optional extra: `pip install "skillware[gemini]"` (local dev: `pip install -e ".[gemini]"`). See the [Gemini usage guide](docs/usage/gemini.md) for setup details.
@@ -218,14 +223,15 @@ For other providers and shared integration patterns, see the [usage guides index
 | Topic | Links |
 | :--- | :--- |
 | **Introduction** | [Introduction](docs/introduction.md) · [Vision](docs/vision.md) · [Comparison](COMPARISON.md) |
-| **Usage guides** | [Skill Library](docs/skills/README.md) · [Usage Guide](docs/usage/README.md) · [Examples](examples/README.md) · [Agent Loops](docs/usage/agent_loops.md) · [API Keys](docs/usage/api_keys.md) · [CLI](docs/usage/cli.md) |
+| **Usage guides** | [Skill Library](docs/skills/README.md) · [Usage Guide](docs/usage/README.md) · [Install extras](docs/usage/install_extras.md) · [Examples](examples/README.md) · [Agent Loops](docs/usage/agent_loops.md) · [API Keys](docs/usage/api_keys.md) · [CLI](docs/usage/cli.md) |
+| **Security** | [Skill trust model](docs/security/skill-trust-model.md) · [SECURITY.md](SECURITY.md) |
 | **Contributing** | [Contributing](CONTRIBUTING.md) · [Agent Native Workflow](docs/contributing/ai_native_workflow.md) · [Testing](docs/TESTING.md) · [Changelog](CHANGELOG.md) |
 
 ## Contributing
 
 We are building the "App Store" for Agents. Skills are the main contribution, but documentation, tests, and framework fixes are welcome too. Human operators and supervised agents follow the same standards: scoped PRs, deterministic behavior, and verified tests.
 
-See the **Contributing** row in [Documentation](#documentation) for the full path, [Contributing](CONTRIBUTING.md) (types, skill standard, PR process), [Agent Native Workflow](docs/contributing/ai_native_workflow.md) (for autonomous and semi-autonomous agents), [Testing](docs/TESTING.md) (Black, Flake8, framework and skill pytest, pre-PR checklist), and [Changelog](CHANGELOG.md) (user-facing entries under `[Unreleased]`).
+Start with [Contributing](CONTRIBUTING.md) (types, skill standard, PR process), [Agent Native Workflow](docs/contributing/ai_native_workflow.md) (for autonomous and semi-autonomous agents), [Testing](docs/TESTING.md) (Black, Flake8, framework and skill pytest, pre-PR checklist), and [Changelog](CHANGELOG.md) (user-facing entries under `[Unreleased]`).
 
 Also read the [Agent Code of Conduct](CODE_OF_CONDUCT.md). Open PRs with the [pull request template](.github/PULL_REQUEST_TEMPLATE.md) and complete only the sections that apply.
 

{skillware-0.4.2 → skillware-0.4.5}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "skillware"
-version = "0.4.2"
+version = "0.4.5"
 description = "A framework for modular, self-contained AI skills."
 readme = "README.md"
 authors = [
@@ -23,6 +23,7 @@ dependencies = [
     "python-dotenv",
     "beautifulsoup4",
     "packaging",
+    "jsonschema>=4.0",
     "rich>=13.0",
 ]
 requires-python = ">=3.10"
@@ -37,7 +38,6 @@ dev = [
     "flake8",
     "black",
 ]
-cli = []
 gemini = [
     "google-genai",
 ]
@@ -47,27 +47,108 @@ claude = [
 openai = [
     "openai",
 ]
-office = [
-    "pymupdf",
+agents = [
+    "google-genai",
+    "anthropic",
+    "openai",
+]
+
+# --- extras: begin generated by scripts/sync_extras.py ---
+
+compliance = [
+    "google-genai",
+]
+
+creative = [
+    "onnxruntime",
+    "pillow",
+    "rembg>=2.0.0",
+]
+
+data_engineering = [
+    "fastembed",
+    "numpy",
 ]
+
 defi = [
     "web3>=6.0.0",
 ]
-embeddings = [
+
+dev_tools = []
+
+finance = []
+
+monitoring = []
+
+office = [
+    "anthropic",
+    "pymupdf",
+]
+
+optimization = []
+
+wellness = [
+    "google-genai",
+]
+
+compliance_mica_module = [
+    "google-genai",
+]
+
+compliance_pii_masker = []
+
+compliance_tos_evaluator = []
+
+creative_bg_remover = [
+    "rembg>=2.0.0",
+    "pillow",
+    "onnxruntime",
+]
+
+data_engineering_novelty_extractor = [
     "fastembed",
     "numpy",
 ]
-all = [
-    "rich>=13.0",
+
+data_engineering_synthetic_generator = []
+
+defi_evm_tx_handler = [
+    "web3>=6.0.0",
+]
+
+dev_tools_issue_resolver = []
+
+finance_uk_companies_house_handler = []
+
+finance_wallet_screening = []
+
+monitoring_token_limiter = []
+
+office_pdf_form_filler = [
+    "pymupdf",
+    "anthropic",
+]
+
+optimization_prompt_rewriter = []
+
+wellness_mental_coach = [
     "google-genai",
+]
+
+all = [
     "anthropic",
-    "openai",
-    "pymupdf",
-    "web3>=6.0.0",
     "fastembed",
+    "google-genai",
     "numpy",
+    "onnxruntime",
+    "pillow",
+    "pymupdf",
+    "rembg>=2.0.0",
+    "web3>=6.0.0",
 ]
 
+# --- extras: end generated by scripts/sync_extras.py ---
+
 [tool.setuptools]
 include-package-data = true
 

skillware-0.4.5/skills/creative/bg_remover/card.json

@@ -0,0 +1,41 @@
+{
+  "name": "Background Remover",
+  "description": "Remove image backgrounds locally using rembg and return transparent PNGs.",
+  "issuer": {
+    "name": "Ayush Srivastava",
+    "email": "ayush.sri0705@gmail.com",
+    "github": "AyushSrivastava1818",
+    "org": ""
+  },
+  "icon": "photo",
+  "color": "violet",
+  "ui_schema": {
+    "type": "card",
+    "fields": [
+      {
+        "key": "success",
+        "label": "Status",
+        "type": "status_badge"
+      },
+      {
+        "key": "width",
+        "label": "Width",
+        "type": "count"
+      },
+      {
+        "key": "height",
+        "label": "Height",
+        "type": "count"
+      },
+      {
+        "key": "model_used",
+        "label": "Model"
+      },
+      {
+        "key": "output_path",
+        "label": "Output",
+        "type": "file_path"
+      }
+    ]
+  }
+}

skillware-0.4.5/skills/creative/bg_remover/instructions.md

@@ -0,0 +1,118 @@
+# Background Remover (`creative/bg_remover`)
+
+Removes backgrounds from **still images** locally using rembg. Accepts base64 or a local file path; returns a transparent PNG in `image_base64` and optionally writes to `output_path`. Does not fetch URLs or call cloud APIs.
+
+## When to use
+
+Invoke when the user asks to:
+
+- remove the background from an image
+- create a transparent PNG or PNG with alpha
+- cut out, isolate, or extract a product, person, logo, or subject
+- prepare an image for design, e-commerce, or compositing workflows
+
+Trigger phrases include: "remove background", "transparent background", "cut out", "isolate product/person", "PNG with alpha", "no background".
+
+## When not to use
+
+Do **not** invoke for:
+
+- videos or animated media
+- batch folders or bulk directory processing
+- requests to edit only in Photoshop, Canva, or other cloud editors when no local image bytes are available to pass in
+- workflows where neither `image` nor `input_path` can be supplied
+
+## Before calling
+
+If the user wants background removal but has **not** provided an image, file path, or chat attachment, **ask** for one first. Do not call until input exists.
+
+This skill does **not** fetch URLs. When the user provides an `https://…` link, download to a temp file first, then pass `input_path`.
+
+For S3, GCS, Azure Blob, or Cloudflare R2: download the object to a temp file → `input_path` → after success upload from `output_path`. Auth and SDK calls stay in the host; this skill is local-only.
+
+On the **first run** in a fresh environment, processing may take a few minutes while rembg downloads the ONNX model (~176 MB for `isnet-general-use`). Later runs reuse the cache and are much faster.
+
+## Input (one required: `image` OR `input_path`)
+
+| Scenario | Parameter |
+| :--- | :--- |
+| Uploaded, pasted, or **attached** image in chat | `image` (base64 from host encoding) |
+| Local path (e.g. `D:\photos\cat.png`) | `input_path` (absolute path preferred on Windows) |
+| URL | Download to temp file, then `input_path` |
+| Cloud object storage | Download object → temp file → `input_path` |
+
+If **both** `image` and `input_path` are sent, **`image` wins** (do not double-submit).
+
+### Example payloads
+
+Chat / attachment:
+
+```json
+{"image": "<base64>"}
+```
+
+Local file with output beside source:
+
+```json
+{
+  "input_path": "D:\\photos\\1223.png",
+  "output_path": "D:\\photos\\1223_no_bg.png"
+}
+```
+
+URL (host downloads first; URL is not a skill parameter):
+
+1. Download `https://example.com/product.jpg` → `/tmp/product.jpg`
+2. Execute:
+
+```json
+{
+  "input_path": "/tmp/product.jpg",
+  "output_path": "/tmp/product_no_bg.png"
+}
+```
+
+## Model and quality options
+
+| User intent | Suggested args |
+| :--- | :--- |
+| General product, logo, or scene (default) | `model`: `isnet-general-use` |
+| Person, portrait, or human subject | `model`: `u2net_human_seg` |
+| Legacy / simple scenes | `model`: `u2net` or `silueta` |
+| Hair, fur, glass, or fine edges need cleaner alpha | `alpha_matting`: `true` (slower) |
+
+Omit `model` for default `isnet-general-use`. Set `alpha_matting` only when edge quality matters or the user mentions hair, fur, or wispy details.
+
+## Output
+
+| Scenario | Parameters / handling |
+| :--- | :--- |
+| File on disk | Set `output_path`. Prefer `{same_dir}/{stem}_no_bg.png`. Do **not** overwrite the source unless asked. |
+| Chat or API only | Omit `output_path`; use `image_base64` from the result (always present on success). |
+| Save next to original | Same directory, new name (e.g. `1223_no_bg.png`). |
+
+## Interpreting a successful result
+
+When `success` is `true`:
+
+- `image_base64` — transparent PNG bytes (always set); decode or attach for the user when no file path was requested
+- `mime_type` — always `image/png`
+- `width`, `height` — output dimensions; mention when useful
+- `model_used` — rembg model that ran
+- `output_path` — echo of the path written when provided; confirm the file exists on disk
+
+Do not call again for the same request unless the user asks for another image or different settings.
+
+## Dependencies
+
+Runtime: `rembg`, `pillow`, `onnxruntime`. Install: `pip install "skillware[creative_bg_remover]"` or `pip install "skillware[creative]"`.
+
+First `execute()` downloads the ONNX model to the rembg cache (`~/.u2net/` on Linux/macOS, `%USERPROFILE%\.u2net\` on Windows).
+
+## Errors
+
+| `error_code` | Response |
+| :--- | :--- |
+| `INVALID_INPUT` | Ask for an upload, attachment, base64 payload, or local `input_path`. |
+| `MISSING_DEPENDENCY` | Ask the user to run `pip install "skillware[creative_bg_remover]"` (or `pip install rembg pillow onnxruntime`), then retry. |
+| `PROCESSING_FAILED` | Surface the `error` string; input may be missing, corrupt, or unsupported. |

skillware-0.4.5/skills/creative/bg_remover/manifest.yaml

@@ -0,0 +1,96 @@
+name: "creative/bg_remover"
+version: "0.1.0"
+description: "Remove image backgrounds locally using rembg."
+short_description: "Offline background removal using rembg with transparent PNG output."
+
+issuer:
+  name: Ayush Srivastava
+  email: "ayush.sri0705@gmail.com"
+  github: AyushSrivastava1818
+  org: ""
+
+category: "creative"
+
+parameters:
+  type: object
+  properties:
+    image:
+      type: string
+      description: "Base64-encoded still image (preferred for chat/upload handoff)."
+
+    input_path:
+      type: string
+      description: "Absolute or relative path to a local still image file."
+
+    output_path:
+      type: string
+      description: "Optional path to write PNG; if omitted, result is base64-only in image_base64."
+
+    model:
+      type: string
+      description: "rembg model; default isnet-general-use. Use u2net_human_seg for people."
+      enum:
+        - isnet-general-use
+        - u2net
+        - u2net_human_seg
+        - silueta
+      default: isnet-general-use
+
+    alpha_matting:
+      type: boolean
+      description: "Enable alpha matting for finer edges (hair, fur); slower when true."
+      default: false
+  required: []
+
+outputs:
+  success:
+    type: boolean
+    description: "True when background removal completed successfully."
+
+  image_base64:
+    type: string
+    description: "Base64-encoded transparent PNG (always set on success)."
+
+  mime_type:
+    type: string
+    description: "Output MIME type (image/png on success)."
+
+  output_path:
+    type: string
+    description: "Echo of the requested output path when provided."
+
+  width:
+    type: integer
+    description: "Output image width in pixels."
+
+  height:
+    type: integer
+    description: "Output image height in pixels."
+
+  model_used:
+    type: string
+    description: "rembg model used for processing."
+
+  error:
+    type: string
+    description: "Human-readable error message when success is false."
+
+  error_code:
+    type: string
+    description: "INVALID_INPUT, MISSING_DEPENDENCY, or PROCESSING_FAILED."
+
+requirements:
+  - rembg>=2.0.0
+  - pillow
+  - onnxruntime
+
+constitution: |
+  1. IMAGE_ONLY: Process still images only.
+  2. LOCAL_FIRST: Never use cloud APIs.
+  3. PRIVACY: Never store image bytes.
+  4. DETERMINISTIC: Same input produces same output.
+  5. FAIL_CLOSED: Return structured errors on invalid input.
+
+presentation:
+  icon: "photo"
+  color: "#8b5cf6"