Skip to content

SKILL.md

Latest commit

 

History

History
171 lines (135 loc) · 6.25 KB

SKILL.md

File metadata and controls

171 lines (135 loc) · 6.25 KB
Raw
name civilis-risk-os
description Use this skill when an AI agent needs an installable skill for protected agent commerce on X Layer. Covers the narrow runtime flow quote -> buy -> claim -> resolve -> requote, plus the bundled local runtime and the public hosted bundled runtime. Do NOT use this skill to overclaim generalized insurance, decentralized arbitration, generic buyer wallet-signature proof, on-chain premium collection, Uniswap integration, or a fully multi-tenant production SaaS.
license MIT
metadata
author version homepage
CivilisAI
0.1.0

Civilis Risk OS

Installable skill for protected agent commerce on X Layer.

Quickstart

git clone https://github.com/CivilisAI/Civilis-Risk-OS.git
cd Civilis-Risk-OS
npm install
npm run demo
npm run runtime -- help

Or from another workspace:

npm install github:CivilisAI/Civilis-Risk-OS
npx civilis-risk-os-runtime help
npx civilis-risk-os-runtime health --base-url https://civilis-risk-os-runtime.ceolaexekiel.workers.dev

When the package is used in bundled local mode, the runtime command surface starts the bundled local runtime profile automatically and uses bundled claimant and evaluator auth defaults.

The same package also supports the public hosted bundled runtime at:

  • https://civilis-risk-os-runtime.ceolaexekiel.workers.dev

Use This Skill For

  • quoting seller risk before payment
  • selecting instant or challengeable settlement
  • creating protected purchases
  • preparing and filing buyer claims
  • preparing and filing evaluator resolutions
  • running requote after outcome history is applied

Onchain OS Modules In The Reference Runtime

  • okx-x402-payment
  • okx-agentic-wallet
  • okx-security via onchainos security token-scan --address <sellerWallet> --chain xlayer
  • okx-dex-token via onchainos token advanced-info --chain xlayer --address <token>
  • okx-dex-token via onchainos token holders --chain xlayer --address <token>
  • ERC-8183 / ACP
  • ERC-8004

AI Evaluator Advisory

When the runtime has RISK_OS_ENABLE_LLM_EVALUATOR=true and a configured OpenAI-compatible LLM_* endpoint, resolve-proof and resolve may consume an evaluator advisory that returns:

  • decision
  • reasoning
  • confidence

Explicit evaluator decisions still win when they are supplied.

Do Not Use This Skill For

  • generalized insurance workflows
  • decentralized arbitration flows
  • partial refund logic
  • overclaiming generic buyer wallet-signature proof
  • overclaiming on-chain premium collection
  • overclaiming Uniswap integration
  • overclaiming a fully multi-tenant production SaaS

Runtime Commands

The primary runtime command surface is:

  • health
  • quote
  • buy
  • purchase
  • claim-proof
  • claim
  • resolve-proof
  • resolve
  • requote
  • full-loop

Parameter Rules

  • --base-url <url>: compatible Risk OS runtime endpoint, optional in bundled local mode and defaulting to the bundled local runtime profile started by the package
  • the public hosted bundled runtime is https://civilis-risk-os-runtime.ceolaexekiel.workers.dev
  • --item <intelItemId>: reference item id for quote, buy, requote
  • --buyer <agentId>: buyer agent id, default sage
  • --quote <quoteId>: required for buy
  • --purchase <protectedPurchaseId>: required for purchase, claim-proof, claim
  • --claim <claimId>: required for resolve-proof, resolve
  • --mode <instant|challengeable>: settlement mode for buy
  • --decision <release|refund>: explicit evaluator outcome; optional for resolve-proof and resolve when the runtime has LLM evaluator advisory enabled
  • --reason <text>: required for claim, optional for resolve-proof and resolve when proof or advisory generation supplies it
  • --claimant-token <token> or --claimant-signature <sig>: buyer auth
  • --evaluator-token <token> or --evaluator-signature <sig>: evaluator auth
  • in bundled local mode, claimant and evaluator auth are already supplied by the package
  • in the public hosted bundled runtime, the package also auto-supplies bundled claimant and evaluator auth after the runtime identifies itself as bundled
  • in the public hosted bundled runtime, the package also auto-manages a runtime session so protected-commerce state stays isolated per caller

Command Examples

npm run runtime -- health
npm run runtime -- quote --item 501 --buyer sage
npm run runtime -- buy --item 501 --buyer sage --mode challengeable --quote 1
npm run runtime -- purchase --purchase 1
npm run runtime -- claim-proof --purchase 1 --reason "delivery was misleading"
npm run runtime -- claim --purchase 1 --reason "delivery was misleading"
npm run runtime -- resolve-proof --claim 1 --decision refund --reason "quality below threshold"
npm run runtime -- resolve --claim 1 --decision refund --reason "quality below threshold"
npm run runtime -- resolve-proof --claim 1
npm run runtime -- requote --item 501 --buyer sage
npm run verify:protected-loop

Command Contract

  • quote returns riskScore, recommendedMode, premiumAmount, and quote reasoning
  • buy returns protectedPurchaseId, purchase mode, and protected commerce state
  • claim-proof returns the deterministic buyer claim message and hash
  • claim returns the filed claim state
  • resolve-proof returns the evaluator resolution message and hash
  • resolve returns the final protected outcome and the trigger for requote
  • requote returns the next quote after protected outcome history is applied

Output Contract

Always return:

  • the command executed
  • the acting role
  • the structured JSON response
  • any remaining UNVERIFIED boundary that affects the result

References

Bundled Supporting Modules

The primary install surface is this Skill. Bundled supporting modules are also available for narrower tasks:

  • civilis-risk-os-runtime
  • civilis-risk-os-canonical-replay
  • civilis-risk-os-external-consumer
  • civilis-risk-os-proof-boundaries
  • civilis-risk-os-integration-check