Skip to content

Kyvvu client instructions

This project requires kyvvu>=1.0.0,<2.0.0. Match contracts to the packages installed in the environment where the agent runs.

  • Start with kyvvu docs for each installed package's versioned documentation. The earliest supported Python client's agent index is https://docs.kyvvu.com/v/kyvvu/1.0.0/llms.txt.
  • Use the index's Markdown pages, manifest schema and OpenAPI links. Follow the installed version's reference when package versions differ.
  • Run kyvvu explain <rule_type> for a rule's description, parameter schema and example. Run kyvvu explain PolicyLoadError for its exception contract.
  • Validate manifest changes with kyvvu schema manifest --validate policies.yaml. Then exercise the intended allowed and blocked paths with kyvvu try --help and the documented replay format. An editor-schema pass alone is insufficient.
  • Keep governed steps inside kv.start_task() and kv.end_task(); the end flushes the task. In a new request or thread, select it with kv.resume_task(task_id).
  • Choose the policy source deliberately. Platform policies require api_url, api_key and agent_key; offline trials use a policy file. Never infer that zero loaded policies means enforcement succeeded.
  • Keep credentials out of source, prompts, traces and committed files. Use .env.example for variable names and keep the actual .env private.

The public issue tracker is https://github.com/Kyvvu/issues/issues. Report vulnerabilities privately to security@kyvvu.com.