openclaw-mova 1.0.0 → 1.0.1

package/README.md

@@ -0,0 +1,115 @@
+---
+name: openclaw-mova
+description: MOVA contract execution ecosystem for OpenClaw. Provides 21 tools to execute AI contracts with human-in-the-loop decision gates, manage connectors, register and run custom contracts, and browse the public contract marketplace. Install this plugin first, then add the contract skills or ecosystem skills you need.
+license: MIT-0
+metadata: {"openclaw":{"plugin":{"name":"MOVA","installCmd":"openclaw plugins install openclaw-mova"},"dataSentToExternalServices":[{"service":"MOVA API (api.mova-lab.eu, EU-hosted)","data":"contract inputs, decision data, audit metadata, API key in Authorization header"},{"service":"No other external services","data":"All connector calls go through the MOVA API only — the plugin never opens direct connections to third-party systems"}],"security":{"fileIO":"none","arbitraryNetworkCalls":"none — only https://api.mova-lab.eu (configurable via baseUrl)","credentialStorage":"apiKey stored in OpenClaw plugin config, sent only to the configured baseUrl"}}}
+---
+
+# MOVA — Contract Execution for AI Agents
+
+## What is MOVA
+
+MOVA is a language and execution runtime for governed AI processes. At its core is the concept of a **contract** — a structured specification that defines:
+
+- what the agent does at each step
+- where it must stop and hand control to a human (HITL gate)
+- which policies are enforced (cannot be skipped or bypassed)
+- how every action is recorded
+
+A contract is not a script or a prompt. It is a MOVA-spec artifact: input definitions, execution steps, instruction profiles, and human control gates. The contract lives at the author's URL — GitHub, S3, or any HTTPS address. MOVA fetches it, validates it, and executes it.
+
+**What the user receives after execution:**
+
+- **Verdict** — `fulfilled` / `partially_fulfilled` / `failed`
+- **Step outputs** — structured data from each execution step
+- **Signed audit receipt** — an immutable record of every event: who initiated the run, what the agent did, what the human decided, at exactly what moment. Stored permanently, retrievable by `run_id`. Designed to satisfy EU AI Act, AMLD6, and GDPR auditability requirements.
+
+---
+
+## Two ways to use MOVA
+
+---
+
+### Path 1 — Use ready-made contracts
+
+Install the plugin, add the contract skills you need, and your agent immediately has complete AI-governed business workflows with HITL gates and full audit trails.
+
+**Required:**
+
+| Component | Type | Purpose |
+|---|---|---|
+| `openclaw-mova` (this plugin) | Plugin | Required. Provides all 21 execution tools |
+| `mova-connector-setup` | Ecosystem skill | Connect your real ERP, CRM, AML systems instead of sandbox mocks |
+
+**Contract skills — install whichever workflows your org needs:**
+
+| Skill | What it runs |
+|---|---|
+| `mova-invoice-ocr` | Invoice OCR extraction + AP approval gate |
+| `mova-po-approval` | Purchase order risk analysis + procurement approval gate |
+| `mova-aml-triage` | AML alert L1 triage + compliance officer decision gate |
+| `mova-complaints-handler` | EU customer complaint classification + handling gate |
+| `mova-crypto-review` | Crypto trade risk analysis + human approval gate |
+| `mova-compliance-audit` | GDPR / PCI-DSS / ISO 27001 / SOC 2 audit + sign-off gate |
+| `mova-credit-scoring` | Credit risk scoring + credit officer approval gate |
+| `mova-supply-chain-risk` | Supplier sanctions / ESG screening + procurement gate |
+| `mova-churn-prediction` | Customer churn prediction + retention campaign approval gate |
+| `mova-contract-generation` | Legal document generation (NDA, SLA) + section-by-section review gates |
+
+---
+
+### Path 2 — Build and publish your own contracts
+
+Go from raw idea to an executable, auditable MOVA contract. Keep it private, share it with your org, or publish it on ClawHub for others to use.
+
+**Required:**
+
+| Component | Type | Purpose |
+|---|---|---|
+| `openclaw-mova` (this plugin) | Plugin | Required |
+| `mova-intent-calibration` | Ecosystem skill | Crystallizes a raw request into a bounded, testable intent — the input for contract authoring |
+| `mova-spec-guide` | Ecosystem skill | Reference for the MOVA spec language: schemas, envelopes, verbs, instruction profiles |
+| `mova-spec-authoring` | Ecosystem skill | Authors a complete MOVA contract from a crystallized intent |
+| `mova-user-contract-setup` | Ecosystem skill | Registers your contract at MOVA and runs the first test |
+| `mova-contract-discovery` | Ecosystem skill | Finds and runs public contracts from other organizations |
+| `mova-connector-setup` | Ecosystem skill | Connects your real business systems |
+
+**The build path:**
+1. `mova-intent-calibration` — define exactly what the contract must do
+2. `mova-spec-guide` — understand the spec structure if needed
+3. `mova-spec-authoring` — write the contract from the crystallized intent
+4. Host the contract JSON at your GitHub / S3 / any HTTPS URL
+5. `mova-user-contract-setup` — register with MOVA and run the first test
+6. Optionally publish the skill on ClawHub so others can use it
+
+---
+
+## Setup
+
+```
+openclaw config set plugins.entries.mova.config.apiKey YOUR_KEY
+```
+
+Get your API key at **https://mova-lab.eu/register**
+
+Optional — override the base URL for self-hosted or staging:
+
+```
+openclaw config set plugins.entries.mova.config.baseUrl https://your-mova-instance.example.com
+```
+
+---
+
+## All 21 tools
+
+### HITL contract execution
+`mova_hitl_start` · `mova_hitl_start_po` · `mova_hitl_start_trade` · `mova_hitl_start_aml` · `mova_hitl_start_complaint` · `mova_hitl_start_compliance` · `mova_hitl_start_credit` · `mova_hitl_start_supply_chain` · `mova_hitl_start_churn` · `mova_hitl_start_contract_gen` · `mova_hitl_decide` · `mova_hitl_status` · `mova_hitl_audit` · `mova_hitl_audit_compact` · `mova_calibrate_intent`
+
+### Connector registry
+`mova_list_connectors` · `mova_list_connector_overrides` · `mova_register_connector` · `mova_delete_connector_override`
+
+### User contract registry & execution
+`mova_register_contract` · `mova_list_my_contracts` · `mova_set_contract_visibility` · `mova_delete_contract` · `mova_run_contract` · `mova_run_status`
+
+### Public marketplace
+`mova_discover_contracts`

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "mova",
   "name": "MOVA",
   "description": "HITL contract execution for business workflows — invoice OCR, PO approval, AML triage, complaints handling, crypto trade review, compliance audit, credit scoring, supply chain risk, churn prediction, contract generation, connector registry, and user contract registration and remote execution.",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "configSchema": {
     "type": "object",
     "required": ["apiKey"],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "openclaw-mova",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "MOVA HITL tools for OpenClaw — native agent tools for contract-driven business workflows",
   "type": "module",
   "license": "MIT-0",
@@ -34,7 +34,8 @@
   "files": [
     "dist",
     "openclaw.plugin.json",
-    "SKILL.md"
+    "SKILL.md",
+    "README.md"
   ],
   "peerDependencies": {
     "openclaw": "*"