SDKs

CLI

villow and villow-node: validate, serve, pair, and run conformance.

The CLI is the local loop. Studio is the product loop. Conformance is the gate before review.

Commands

Command	What it does
`validate`	Check agent.yaml against the same schema the API uses.
`dev --app --pair`	Serve with reload, tunnel if cloudflared/ngrok is on PATH, post the public URL to Studio.
`conformance --agent`	Ask the platform to probe your endpoints. Exits 1 on fail.
`contract-test`	Hit a local server with the mock harness contract suite.

Environment

bash

export VILLOW_API_BASE=https://api.example
export VILLOW_API_TOKEN=…          # publisher session token
export VILLOW_SIGNING_SECRET=…     # minted once at register

The pair code is not the signing secret. Rotate the secret from publisher settings if it leaks.