agent-os-kernel 1.1.0__py3-none-any.whl → 1.2.0__py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (1051) hide show
  1. agent_os/__init__.py +66 -4
  2. agent_os/agents_compat.py +286 -0
  3. agent_os/base_agent.py +308 -0
  4. agent_os/cli.py +1079 -19
  5. agent_os/integrations/__init__.py +37 -2
  6. agent_os/integrations/openai_adapter.py +502 -0
  7. agent_os/integrations/semantic_kernel_adapter.py +569 -0
  8. agent_os/stateless.py +349 -0
  9. agent_os_kernel-1.2.0.dist-info/METADATA +676 -0
  10. agent_os_kernel-1.2.0.dist-info/RECORD +1053 -0
  11. {agent_os_kernel-1.1.0.dist-info → agent_os_kernel-1.2.0.dist-info}/entry_points.txt +0 -1
  12. modules/amb/.github/workflows/ci.yml +102 -0
  13. modules/amb/.github/workflows/publish.yml +146 -0
  14. modules/amb/.gitignore +134 -0
  15. modules/amb/CHANGELOG.md +118 -0
  16. modules/amb/CONTRIBUTING.md +141 -0
  17. modules/amb/LICENSE +21 -0
  18. modules/amb/README.md +188 -0
  19. modules/amb/amb_core/__init__.py +175 -0
  20. modules/amb/amb_core/adapters/__init__.py +55 -0
  21. modules/amb/amb_core/adapters/aws_sqs_broker.py +374 -0
  22. modules/amb/amb_core/adapters/azure_servicebus_broker.py +338 -0
  23. modules/amb/amb_core/adapters/kafka_broker.py +258 -0
  24. modules/amb/amb_core/adapters/nats_broker.py +283 -0
  25. modules/amb/amb_core/adapters/rabbitmq_broker.py +233 -0
  26. modules/amb/amb_core/adapters/redis_broker.py +260 -0
  27. modules/amb/amb_core/broker.py +143 -0
  28. modules/amb/amb_core/bus.py +479 -0
  29. modules/amb/amb_core/cloudevents.py +507 -0
  30. modules/amb/amb_core/dlq.py +343 -0
  31. modules/amb/amb_core/hf_utils.py +534 -0
  32. modules/amb/amb_core/memory_broker.py +408 -0
  33. modules/amb/amb_core/models.py +139 -0
  34. modules/amb/amb_core/persistence.py +527 -0
  35. modules/amb/amb_core/schema.py +292 -0
  36. modules/amb/amb_core/tracing.py +356 -0
  37. modules/amb/examples/advanced_features.py +223 -0
  38. modules/amb/examples/backpressure_demo.py +225 -0
  39. modules/amb/examples/basic_usage.py +117 -0
  40. modules/amb/examples/tracing_demo.py +104 -0
  41. modules/amb/experiments/README.md +52 -0
  42. modules/amb/experiments/reproduce_results.py +467 -0
  43. modules/amb/experiments/results.json +324 -0
  44. modules/amb/paper/README.md +40 -0
  45. modules/amb/paper/paper.tex +365 -0
  46. modules/amb/paper/whitepaper.md +377 -0
  47. modules/amb/pyproject.toml +117 -0
  48. modules/amb/tests/__init__.py +1 -0
  49. modules/amb/tests/test_backpressure_priority.py +280 -0
  50. modules/amb/tests/test_bus.py +198 -0
  51. modules/amb/tests/test_cloudevents.py +443 -0
  52. modules/amb/tests/test_features.py +531 -0
  53. modules/amb/tests/test_models.py +74 -0
  54. modules/amb/tests/test_tracing.py +254 -0
  55. modules/atr/.github/workflows/ci.yml +101 -0
  56. modules/atr/.github/workflows/publish.yml +140 -0
  57. modules/atr/.gitignore +134 -0
  58. modules/atr/.pre-commit-config.yaml +37 -0
  59. modules/atr/CHANGELOG.md +39 -0
  60. modules/atr/CONTRIBUTING.md +96 -0
  61. modules/atr/IMPLEMENTATION_SUMMARY.md +143 -0
  62. modules/atr/README.md +180 -0
  63. modules/atr/atr/__init__.py +638 -0
  64. modules/atr/atr/access.py +346 -0
  65. modules/atr/atr/composition.py +643 -0
  66. modules/atr/atr/decorator.py +355 -0
  67. modules/atr/atr/executor.py +382 -0
  68. modules/atr/atr/health.py +555 -0
  69. modules/atr/atr/hf_utils.py +447 -0
  70. modules/atr/atr/injection.py +420 -0
  71. modules/atr/atr/metrics.py +438 -0
  72. modules/atr/atr/policies.py +401 -0
  73. modules/atr/atr/py.typed +2 -0
  74. modules/atr/atr/registry.py +450 -0
  75. modules/atr/atr/schema.py +478 -0
  76. modules/atr/atr/tools/safe/__init__.py +73 -0
  77. modules/atr/atr/tools/safe/calculator.py +380 -0
  78. modules/atr/atr/tools/safe/datetime_tool.py +441 -0
  79. modules/atr/atr/tools/safe/file_reader.py +400 -0
  80. modules/atr/atr/tools/safe/http_client.py +314 -0
  81. modules/atr/atr/tools/safe/json_parser.py +372 -0
  82. modules/atr/atr/tools/safe/text_tool.py +526 -0
  83. modules/atr/atr/tools/safe/toolkit.py +173 -0
  84. modules/atr/docs/PYPI_SETUP.md +113 -0
  85. modules/atr/examples/README.md +27 -0
  86. modules/atr/examples/demo.py +144 -0
  87. modules/atr/examples/sandbox_demo.py +218 -0
  88. modules/atr/experiments/README.md +69 -0
  89. modules/atr/experiments/reproduce_results.py +509 -0
  90. modules/atr/experiments/results/.gitkeep +0 -0
  91. modules/atr/experiments/results/results_20260123_140334.json +71 -0
  92. modules/atr/paper/README.md +36 -0
  93. modules/atr/paper/figures/.gitkeep +0 -0
  94. modules/atr/paper/references.bib +84 -0
  95. modules/atr/paper/structure.tex +293 -0
  96. modules/atr/paper/whitepaper.md +234 -0
  97. modules/atr/pyproject.toml +148 -0
  98. modules/atr/requirements.txt +1 -0
  99. modules/atr/setup.py +30 -0
  100. modules/atr/tests/__init__.py +1 -0
  101. modules/atr/tests/test_decorator.py +317 -0
  102. modules/atr/tests/test_executor.py +245 -0
  103. modules/atr/tests/test_integration_executor.py +184 -0
  104. modules/atr/tests/test_registry.py +312 -0
  105. modules/atr/tests/test_schema.py +182 -0
  106. modules/atr/tests/test_v2_features.py +708 -0
  107. modules/caas/.dockerignore +63 -0
  108. modules/caas/.github/ISSUE_TEMPLATE/bug_report.md +38 -0
  109. modules/caas/.github/ISSUE_TEMPLATE/custom.md +10 -0
  110. modules/caas/.github/ISSUE_TEMPLATE/feature_request.md +20 -0
  111. modules/caas/.github/workflows/ci.yml +100 -0
  112. modules/caas/.github/workflows/lint.yml +39 -0
  113. modules/caas/.github/workflows/publish-pypi.yml +124 -0
  114. modules/caas/.gitignore +73 -0
  115. modules/caas/.pre-commit-config.yaml +33 -0
  116. modules/caas/CHANGELOG.md +58 -0
  117. modules/caas/CONTRIBUTING.md +346 -0
  118. modules/caas/Dockerfile +41 -0
  119. modules/caas/LICENSE +21 -0
  120. modules/caas/MANIFEST.in +11 -0
  121. modules/caas/README.md +158 -0
  122. modules/caas/benchmarks/README.md +255 -0
  123. modules/caas/benchmarks/create_hf_dataset.py +502 -0
  124. modules/caas/benchmarks/data/sample_corpus/README.md +86 -0
  125. modules/caas/benchmarks/data/sample_corpus/auth_module.py +211 -0
  126. modules/caas/benchmarks/data/sample_corpus/contribution_guide.md +185 -0
  127. modules/caas/benchmarks/data/sample_corpus/remote_work_policy.html +57 -0
  128. modules/caas/benchmarks/hf_dataset/README.md +214 -0
  129. modules/caas/benchmarks/hf_dataset/caas_benchmark_corpus.py +73 -0
  130. modules/caas/benchmarks/hf_dataset/corpus_preview.json +193 -0
  131. modules/caas/benchmarks/results/README.md +66 -0
  132. modules/caas/benchmarks/results/evaluation_2026-01-20.json +121 -0
  133. modules/caas/benchmarks/run_evaluation.py +561 -0
  134. modules/caas/benchmarks/statistical_tests.py +289 -0
  135. modules/caas/benchmarks/verify_sample_corpus.py +83 -0
  136. modules/caas/docker-compose.yml +38 -0
  137. modules/caas/docs/CONTEXT_TRIAD.md +462 -0
  138. modules/caas/docs/CONTRIBUTING.md +346 -0
  139. modules/caas/docs/ETHICS_AND_LIMITATIONS.md +336 -0
  140. modules/caas/docs/HEURISTIC_ROUTER.md +442 -0
  141. modules/caas/docs/IMPLEMENTATION_SUMMARY.md +363 -0
  142. modules/caas/docs/IMPLEMENTATION_SUMMARY_CONTEXT_TRIAD.md +277 -0
  143. modules/caas/docs/IMPLEMENTATION_SUMMARY_HEURISTIC_ROUTER.md +231 -0
  144. modules/caas/docs/IMPLEMENTATION_SUMMARY_METADATA_INJECTION.md +258 -0
  145. modules/caas/docs/IMPLEMENTATION_SUMMARY_PRAGMATIC_TRUTH.md +212 -0
  146. modules/caas/docs/IMPLEMENTATION_SUMMARY_TRUST_GATEWAY.md +319 -0
  147. modules/caas/docs/LAYER_1_PRIMITIVE.md +202 -0
  148. modules/caas/docs/METADATA_INJECTION.md +404 -0
  149. modules/caas/docs/PRAGMATIC_TRUTH.md +431 -0
  150. modules/caas/docs/RELATED_WORK.md +312 -0
  151. modules/caas/docs/RELEASE_CHECKLIST.md +219 -0
  152. modules/caas/docs/RELEASE_GUIDE.md +285 -0
  153. modules/caas/docs/REPRODUCIBILITY.md +386 -0
  154. modules/caas/docs/SLIDING_WINDOW.md +387 -0
  155. modules/caas/docs/STRUCTURE_AWARE_INDEXING.md +158 -0
  156. modules/caas/docs/TESTING.md +259 -0
  157. modules/caas/docs/THREAT_MODEL.md +247 -0
  158. modules/caas/docs/TRUST_GATEWAY.md +575 -0
  159. modules/caas/docs/VFS.md +298 -0
  160. modules/caas/examples/agents/enterprise_security_agent.py +414 -0
  161. modules/caas/examples/agents/intelligent_document_analyzer.py +380 -0
  162. modules/caas/examples/demos/demo.py +309 -0
  163. modules/caas/examples/demos/demo_context_triad.py +225 -0
  164. modules/caas/examples/demos/demo_conversation_manager.py +285 -0
  165. modules/caas/examples/demos/demo_heuristic_router.py +133 -0
  166. modules/caas/examples/demos/demo_metadata_injection.py +198 -0
  167. modules/caas/examples/demos/demo_pragmatic_truth.py +303 -0
  168. modules/caas/examples/demos/demo_structure_aware.py +140 -0
  169. modules/caas/examples/demos/demo_time_decay.py +247 -0
  170. modules/caas/examples/demos/demo_trust_gateway.py +383 -0
  171. modules/caas/examples/multi_agent/README.md +159 -0
  172. modules/caas/examples/multi_agent/research_team.py +369 -0
  173. modules/caas/examples/multi_agent/vfs_collaboration.py +393 -0
  174. modules/caas/examples/usage/auth_module.py +142 -0
  175. modules/caas/examples/usage/usage_example.py +173 -0
  176. modules/caas/experiments/README.md +42 -0
  177. modules/caas/experiments/reproduce_results.py +462 -0
  178. modules/caas/paper/ARXIV_METADATA.md +145 -0
  179. modules/caas/paper/ARXIV_README.md +47 -0
  180. modules/caas/paper/CHECKLIST.md +103 -0
  181. modules/caas/paper/GITHUB_RELEASE_NOTES.md +105 -0
  182. modules/caas/paper/README.md +71 -0
  183. modules/caas/paper/abstract.md +24 -0
  184. modules/caas/paper/arxiv_submission.tar +0 -0
  185. modules/caas/paper/arxiv_submission.zip +0 -0
  186. modules/caas/paper/build_pdf.py +355 -0
  187. modules/caas/paper/experiments.md +149 -0
  188. modules/caas/paper/figures/.gitkeep +0 -0
  189. modules/caas/paper/figures/README.md +237 -0
  190. modules/caas/paper/figures/fig1_system_architecture.png +0 -0
  191. modules/caas/paper/figures/fig1_system_architecture.svg +198 -0
  192. modules/caas/paper/figures/fig2_context_triad.png +0 -0
  193. modules/caas/paper/figures/fig2_context_triad.svg +105 -0
  194. modules/caas/paper/figures/fig3_ablation_results.png +0 -0
  195. modules/caas/paper/figures/fig3_ablation_results.svg +113 -0
  196. modules/caas/paper/figures/fig4_routing_latency.png +0 -0
  197. modules/caas/paper/figures/fig4_routing_latency.svg +97 -0
  198. modules/caas/paper/intro.md +103 -0
  199. modules/caas/paper/latex/figures/fig1_system_architecture.png +0 -0
  200. modules/caas/paper/latex/figures/fig2_context_triad.png +0 -0
  201. modules/caas/paper/latex/figures/fig3_ablation_results.png +0 -0
  202. modules/caas/paper/latex/figures/fig4_routing_latency.png +0 -0
  203. modules/caas/paper/latex/main.tex +468 -0
  204. modules/caas/paper/latex/references.bib +140 -0
  205. modules/caas/paper/method.md +350 -0
  206. modules/caas/paper/outline.md +123 -0
  207. modules/caas/paper/related_work.md +101 -0
  208. modules/caas/paper/tables/.gitkeep +0 -0
  209. modules/caas/paper/tables/results_tables.md +50 -0
  210. modules/caas/pyproject.toml +172 -0
  211. modules/caas/requirements.txt +11 -0
  212. modules/caas/src/caas/__init__.py +232 -0
  213. modules/caas/src/caas/api/__init__.py +7 -0
  214. modules/caas/src/caas/api/server.py +1326 -0
  215. modules/caas/src/caas/caching.py +832 -0
  216. modules/caas/src/caas/cli.py +208 -0
  217. modules/caas/src/caas/conversation.py +221 -0
  218. modules/caas/src/caas/decay.py +118 -0
  219. modules/caas/src/caas/detection/__init__.py +7 -0
  220. modules/caas/src/caas/detection/detector.py +236 -0
  221. modules/caas/src/caas/enrichment.py +127 -0
  222. modules/caas/src/caas/gateway/__init__.py +24 -0
  223. modules/caas/src/caas/gateway/trust_gateway.py +471 -0
  224. modules/caas/src/caas/hf_utils.py +477 -0
  225. modules/caas/src/caas/ingestion/__init__.py +21 -0
  226. modules/caas/src/caas/ingestion/processors.py +251 -0
  227. modules/caas/src/caas/ingestion/structure_parser.py +185 -0
  228. modules/caas/src/caas/models.py +354 -0
  229. modules/caas/src/caas/pragmatic_truth.py +441 -0
  230. modules/caas/src/caas/routing/__init__.py +8 -0
  231. modules/caas/src/caas/routing/heuristic_router.py +242 -0
  232. modules/caas/src/caas/storage/__init__.py +7 -0
  233. modules/caas/src/caas/storage/store.py +450 -0
  234. modules/caas/src/caas/triad.py +472 -0
  235. modules/caas/src/caas/tuning/__init__.py +7 -0
  236. modules/caas/src/caas/tuning/tuner.py +322 -0
  237. modules/caas/src/caas/vfs/__init__.py +12 -0
  238. modules/caas/src/caas/vfs/filesystem.py +450 -0
  239. modules/caas/tests/__init__.py +3 -0
  240. modules/caas/tests/conftest.py +8 -0
  241. modules/caas/tests/test_caching.py +628 -0
  242. modules/caas/tests/test_context_triad.py +385 -0
  243. modules/caas/tests/test_conversation_manager.py +289 -0
  244. modules/caas/tests/test_functionality.py +215 -0
  245. modules/caas/tests/test_heuristic_router.py +370 -0
  246. modules/caas/tests/test_metadata_injection.py +328 -0
  247. modules/caas/tests/test_pragmatic_truth.py +322 -0
  248. modules/caas/tests/test_structure_aware_indexing.py +283 -0
  249. modules/caas/tests/test_time_decay.py +268 -0
  250. modules/caas/tests/test_trust_gateway.py +445 -0
  251. modules/caas/tests/test_vfs.py +298 -0
  252. modules/cmvk/.github/FUNDING.yml +9 -0
  253. modules/cmvk/.github/dependabot.yml +54 -0
  254. modules/cmvk/.github/workflows/ci.yml +205 -0
  255. modules/cmvk/.github/workflows/publish.yml +143 -0
  256. modules/cmvk/.gitignore +147 -0
  257. modules/cmvk/.pre-commit-config.yaml +58 -0
  258. modules/cmvk/CHANGELOG.md +146 -0
  259. modules/cmvk/CITATION.cff +48 -0
  260. modules/cmvk/CONTRIBUTING.md +229 -0
  261. modules/cmvk/Dockerfile +87 -0
  262. modules/cmvk/HF_MODEL_CARD.md +185 -0
  263. modules/cmvk/LICENSE +21 -0
  264. modules/cmvk/README.md +149 -0
  265. modules/cmvk/SECURITY.md +114 -0
  266. modules/cmvk/config/prompts/generator_v1.txt +23 -0
  267. modules/cmvk/config/prompts/verifier_hostile.txt +32 -0
  268. modules/cmvk/config/settings.yaml +40 -0
  269. modules/cmvk/coverage_html/.gitignore +2 -0
  270. modules/cmvk/coverage_html/class_index.html +658 -0
  271. modules/cmvk/coverage_html/coverage_html_cb_188fc9a4.js +735 -0
  272. modules/cmvk/coverage_html/favicon_32_cb_c827f16f.png +0 -0
  273. modules/cmvk/coverage_html/function_index.html +1978 -0
  274. modules/cmvk/coverage_html/index.html +255 -0
  275. modules/cmvk/coverage_html/keybd_closed_cb_900cfef5.png +0 -0
  276. modules/cmvk/coverage_html/status.json +1 -0
  277. modules/cmvk/coverage_html/style_cb_5c747636.css +389 -0
  278. modules/cmvk/coverage_html/z_2c49bd2ed3e01e38___init___py.html +315 -0
  279. modules/cmvk/coverage_html/z_2c49bd2ed3e01e38_audit_py.html +499 -0
  280. modules/cmvk/coverage_html/z_2c49bd2ed3e01e38_benchmarks_py.html +575 -0
  281. modules/cmvk/coverage_html/z_2c49bd2ed3e01e38_constitutional_py.html +1001 -0
  282. modules/cmvk/coverage_html/z_2c49bd2ed3e01e38_hf_utils_py.html +398 -0
  283. modules/cmvk/coverage_html/z_2c49bd2ed3e01e38_metrics_py.html +570 -0
  284. modules/cmvk/coverage_html/z_2c49bd2ed3e01e38_profiles_py.html +397 -0
  285. modules/cmvk/coverage_html/z_2c49bd2ed3e01e38_types_py.html +109 -0
  286. modules/cmvk/coverage_html/z_2c49bd2ed3e01e38_verification_py.html +1053 -0
  287. modules/cmvk/docs/DIAGRAMS.md +325 -0
  288. modules/cmvk/docs/architecture.md +345 -0
  289. modules/cmvk/docs/features.md +308 -0
  290. modules/cmvk/docs/getting_started.md +279 -0
  291. modules/cmvk/docs/innovation_layer.md +377 -0
  292. modules/cmvk/docs/safety.md +281 -0
  293. modules/cmvk/docs/traceability.md +150 -0
  294. modules/cmvk/examples/basic_example.py +62 -0
  295. modules/cmvk/examples/demo_complete_pipeline.py +209 -0
  296. modules/cmvk/examples/demo_innovation_layer.py +197 -0
  297. modules/cmvk/examples/example.py +112 -0
  298. modules/cmvk/examples/model_diversity_comparison.py +110 -0
  299. modules/cmvk/examples/real_api_integration.py +121 -0
  300. modules/cmvk/examples/test_full_pipeline.py +303 -0
  301. modules/cmvk/experiments/FEATURE_2_LATERAL_THINKING.md +187 -0
  302. modules/cmvk/experiments/README.md +216 -0
  303. modules/cmvk/experiments/ablation_runner.py +666 -0
  304. modules/cmvk/experiments/baseline_runner.py +158 -0
  305. modules/cmvk/experiments/blind_spot_benchmark.py +364 -0
  306. modules/cmvk/experiments/datasets/README.md +85 -0
  307. modules/cmvk/experiments/datasets/humaneval_50.json +352 -0
  308. modules/cmvk/experiments/datasets/humaneval_full.json +1150 -0
  309. modules/cmvk/experiments/datasets/humaneval_sample.json +32 -0
  310. modules/cmvk/experiments/datasets/sabotage.json +262 -0
  311. modules/cmvk/experiments/datasets/sample.json +40 -0
  312. modules/cmvk/experiments/demo_with_traces.py +110 -0
  313. modules/cmvk/experiments/efficiency_curve.py +259 -0
  314. modules/cmvk/experiments/experiment_runner.py +243 -0
  315. modules/cmvk/experiments/paper_data_generator.py +183 -0
  316. modules/cmvk/experiments/reproduce_results.py +407 -0
  317. modules/cmvk/experiments/reproducible_runner.py +352 -0
  318. modules/cmvk/experiments/sabotage_stress_test.py +311 -0
  319. modules/cmvk/experiments/test_lateral_thinking.py +116 -0
  320. modules/cmvk/experiments/test_prosecutor.py +41 -0
  321. modules/cmvk/experiments/visualize_results.py +735 -0
  322. modules/cmvk/logs/traces/demo_HumanEval_0_20260121-204900.json +36 -0
  323. modules/cmvk/notebooks/analysis.ipynb +124 -0
  324. modules/cmvk/paper/PAPER.md +561 -0
  325. modules/cmvk/paper/arxiv_checklist.md +230 -0
  326. modules/cmvk/paper/cmvk_neurips.aux +77 -0
  327. modules/cmvk/paper/cmvk_neurips.bbl +81 -0
  328. modules/cmvk/paper/cmvk_neurips.blg +48 -0
  329. modules/cmvk/paper/cmvk_neurips.out +16 -0
  330. modules/cmvk/paper/cmvk_neurips.pdf +0 -0
  331. modules/cmvk/paper/cmvk_neurips.tex +309 -0
  332. modules/cmvk/paper/figures/ablation.png +0 -0
  333. modules/cmvk/paper/figures/ablation.svg +39 -0
  334. modules/cmvk/paper/figures/architecture.png +0 -0
  335. modules/cmvk/paper/figures/architecture.svg +115 -0
  336. modules/cmvk/paper/figures/results_bar.png +0 -0
  337. modules/cmvk/paper/figures/results_bar.svg +70 -0
  338. modules/cmvk/paper/generate_figures.py +383 -0
  339. modules/cmvk/paper/neurips_2024.sty +101 -0
  340. modules/cmvk/paper/references.bib +98 -0
  341. modules/cmvk/paper/structure.tex +200 -0
  342. modules/cmvk/pyproject.toml +189 -0
  343. modules/cmvk/requirements-dev.txt +19 -0
  344. modules/cmvk/requirements.txt +14 -0
  345. modules/cmvk/src/cmvk/__init__.py +216 -0
  346. modules/cmvk/src/cmvk/audit.py +400 -0
  347. modules/cmvk/src/cmvk/benchmarks.py +476 -0
  348. modules/cmvk/src/cmvk/constitutional.py +902 -0
  349. modules/cmvk/src/cmvk/hf_utils.py +299 -0
  350. modules/cmvk/src/cmvk/metrics.py +471 -0
  351. modules/cmvk/src/cmvk/profiles.py +298 -0
  352. modules/cmvk/src/cmvk/py.typed +0 -0
  353. modules/cmvk/src/cmvk/types.py +10 -0
  354. modules/cmvk/src/cmvk/verification.py +954 -0
  355. modules/cmvk/src/cross_model_verification_kernel/__init__.py +91 -0
  356. modules/cmvk/src/cross_model_verification_kernel/__main__.py +10 -0
  357. modules/cmvk/src/cross_model_verification_kernel/agents/__init__.py +16 -0
  358. modules/cmvk/src/cross_model_verification_kernel/agents/base_agent.py +142 -0
  359. modules/cmvk/src/cross_model_verification_kernel/agents/generator_openai.py +223 -0
  360. modules/cmvk/src/cross_model_verification_kernel/agents/verifier_anthropic.py +448 -0
  361. modules/cmvk/src/cross_model_verification_kernel/agents/verifier_gemini.py +481 -0
  362. modules/cmvk/src/cross_model_verification_kernel/cli.py +570 -0
  363. modules/cmvk/src/cross_model_verification_kernel/core/__init__.py +26 -0
  364. modules/cmvk/src/cross_model_verification_kernel/core/graph_memory.py +308 -0
  365. modules/cmvk/src/cross_model_verification_kernel/core/kernel.py +413 -0
  366. modules/cmvk/src/cross_model_verification_kernel/core/trace_logger.py +75 -0
  367. modules/cmvk/src/cross_model_verification_kernel/core/types.py +121 -0
  368. modules/cmvk/src/cross_model_verification_kernel/datasets/__init__.py +20 -0
  369. modules/cmvk/src/cross_model_verification_kernel/datasets/humaneval_loader.py +271 -0
  370. modules/cmvk/src/cross_model_verification_kernel/generator.py +118 -0
  371. modules/cmvk/src/cross_model_verification_kernel/kernel.py +292 -0
  372. modules/cmvk/src/cross_model_verification_kernel/models.py +111 -0
  373. modules/cmvk/src/cross_model_verification_kernel/py.typed +1 -0
  374. modules/cmvk/src/cross_model_verification_kernel/simple_kernel.py +185 -0
  375. modules/cmvk/src/cross_model_verification_kernel/tools/__init__.py +94 -0
  376. modules/cmvk/src/cross_model_verification_kernel/tools/huggingface_upload.py +394 -0
  377. modules/cmvk/src/cross_model_verification_kernel/tools/sandbox.py +159 -0
  378. modules/cmvk/src/cross_model_verification_kernel/tools/statistics.py +468 -0
  379. modules/cmvk/src/cross_model_verification_kernel/tools/visualizer.py +312 -0
  380. modules/cmvk/src/cross_model_verification_kernel/tools/web_search.py +86 -0
  381. modules/cmvk/src/cross_model_verification_kernel/verifier.py +257 -0
  382. modules/cmvk/tests/__init__.py +3 -0
  383. modules/cmvk/tests/conftest.py +61 -0
  384. modules/cmvk/tests/integration/__init__.py +1 -0
  385. modules/cmvk/tests/integration/test_anthropic_verifier.py +269 -0
  386. modules/cmvk/tests/integration/test_integration.py +53 -0
  387. modules/cmvk/tests/integration/test_lateral_thinking_integration.py +199 -0
  388. modules/cmvk/tests/integration/test_lateral_thinking_witness.py +208 -0
  389. modules/cmvk/tests/integration/test_prosecutor_mode.py +131 -0
  390. modules/cmvk/tests/test_constitutional.py +611 -0
  391. modules/cmvk/tests/test_enhanced_features.py +603 -0
  392. modules/cmvk/tests/test_verification.py +255 -0
  393. modules/cmvk/tests/unit/__init__.py +1 -0
  394. modules/cmvk/tests/unit/test_agents.py +64 -0
  395. modules/cmvk/tests/unit/test_cli.py +224 -0
  396. modules/cmvk/tests/unit/test_core.py +126 -0
  397. modules/cmvk/tests/unit/test_humaneval_loader.py +197 -0
  398. modules/cmvk/tests/unit/test_kernel.py +255 -0
  399. modules/cmvk/tests/unit/test_reproducibility.py +160 -0
  400. modules/cmvk/tests/unit/test_trace_logger.py +115 -0
  401. modules/cmvk/tests/unit/test_visualizer.py +218 -0
  402. modules/control-plane/.github/ISSUE_TEMPLATE/bug_report.yml +82 -0
  403. modules/control-plane/.github/ISSUE_TEMPLATE/config.yml +11 -0
  404. modules/control-plane/.github/ISSUE_TEMPLATE/feature_request.yml +104 -0
  405. modules/control-plane/.github/ISSUE_TEMPLATE/question.yml +70 -0
  406. modules/control-plane/.github/ISSUE_TEMPLATE/security_vulnerability.yml +84 -0
  407. modules/control-plane/.github/discussions.yml +73 -0
  408. modules/control-plane/.github/pull_request_template.md +82 -0
  409. modules/control-plane/.github/workflows/publish.yml +146 -0
  410. modules/control-plane/.github/workflows/release.yml +39 -0
  411. modules/control-plane/.github/workflows/tests.yml +58 -0
  412. modules/control-plane/.gitignore +55 -0
  413. modules/control-plane/CHANGELOG.md +203 -0
  414. modules/control-plane/CONTRIBUTING.md +311 -0
  415. modules/control-plane/CONTRIBUTORS.md +88 -0
  416. modules/control-plane/Dockerfile +82 -0
  417. modules/control-plane/LICENSE +21 -0
  418. modules/control-plane/MANIFEST.in +17 -0
  419. modules/control-plane/README.md +1264 -0
  420. modules/control-plane/ROADMAP.md +228 -0
  421. modules/control-plane/SECURITY.md +210 -0
  422. modules/control-plane/SUPPORT.md +106 -0
  423. modules/control-plane/acp-cli.py +212 -0
  424. modules/control-plane/benchmark/README.md +257 -0
  425. modules/control-plane/benchmark/__init__.py +19 -0
  426. modules/control-plane/benchmark/red_team_dataset.py +517 -0
  427. modules/control-plane/benchmark.py +563 -0
  428. modules/control-plane/build_and_publish.sh +130 -0
  429. modules/control-plane/docker-compose.yml +74 -0
  430. modules/control-plane/docs/ABLATION_STUDIES.md +528 -0
  431. modules/control-plane/docs/ADAPTER_GUIDE.md +544 -0
  432. modules/control-plane/docs/ADVANCED_FEATURES.md +543 -0
  433. modules/control-plane/docs/AIOS_COMPARISON.md +296 -0
  434. modules/control-plane/docs/BIBLIOGRAPHY.md +367 -0
  435. modules/control-plane/docs/CASE_STUDIES.md +645 -0
  436. modules/control-plane/docs/DOCKER_DEPLOYMENT.md +184 -0
  437. modules/control-plane/docs/ECOSYSTEM_STATUS.md +98 -0
  438. modules/control-plane/docs/HF_MODEL_CARD.md +168 -0
  439. modules/control-plane/docs/KERNEL_V1_RELEASE.md +454 -0
  440. modules/control-plane/docs/LAYER3_FRAMEWORK.md +227 -0
  441. modules/control-plane/docs/LIMITATIONS.md +523 -0
  442. modules/control-plane/docs/PYPI_PUBLISHING.md +195 -0
  443. modules/control-plane/docs/README.md +58 -0
  444. modules/control-plane/docs/RELATED_WORK.md +319 -0
  445. modules/control-plane/docs/RELEASE_v1.1.0.md +252 -0
  446. modules/control-plane/docs/REPRODUCIBILITY.md +540 -0
  447. modules/control-plane/docs/RESEARCH_FOUNDATION.md +197 -0
  448. modules/control-plane/docs/api/CORE.md +270 -0
  449. modules/control-plane/docs/architecture/architecture.md +120 -0
  450. modules/control-plane/docs/community/ANNOUNCEMENT_TEMPLATES.md +52 -0
  451. modules/control-plane/docs/guides/IMPLEMENTATION.md +225 -0
  452. modules/control-plane/docs/guides/PHILOSOPHY.md +354 -0
  453. modules/control-plane/docs/guides/QUICKSTART.md +217 -0
  454. modules/control-plane/examples/README.md +138 -0
  455. modules/control-plane/examples/a2a_demo.py +410 -0
  456. modules/control-plane/examples/adapter_demo.py +347 -0
  457. modules/control-plane/examples/advanced_features.py +403 -0
  458. modules/control-plane/examples/basic_usage.py +261 -0
  459. modules/control-plane/examples/benchmark_demo.py +186 -0
  460. modules/control-plane/examples/compliance_demo.py +333 -0
  461. modules/control-plane/examples/configuration.py +265 -0
  462. modules/control-plane/examples/getting_started.py +178 -0
  463. modules/control-plane/examples/hibernation_and_time_travel_demo.py +406 -0
  464. modules/control-plane/examples/interactive_tutorial.ipynb +497 -0
  465. modules/control-plane/examples/kernel_interceptor_demo.py +202 -0
  466. modules/control-plane/examples/kernel_v1_demo.py +273 -0
  467. modules/control-plane/examples/langchain_demo.py +281 -0
  468. modules/control-plane/examples/lifecycle_demo.py +724 -0
  469. modules/control-plane/examples/mcp_demo.py +378 -0
  470. modules/control-plane/examples/ml_safety_demo.py +157 -0
  471. modules/control-plane/examples/multimodal_demo.py +347 -0
  472. modules/control-plane/examples/observability_demo.py +370 -0
  473. modules/control-plane/examples/use_cases.py +336 -0
  474. modules/control-plane/experiments/long_horizon_purge.py +235 -0
  475. modules/control-plane/experiments/multi_agent_rag.py +165 -0
  476. modules/control-plane/experiments/reproduce_results.py +667 -0
  477. modules/control-plane/paper/ARXIV_SUBMISSION_INFO.txt +122 -0
  478. modules/control-plane/paper/ETHICS_STATEMENT.md +248 -0
  479. modules/control-plane/paper/PAPER_CHECKLIST.md +72 -0
  480. modules/control-plane/paper/Paper.pdf +0 -0
  481. modules/control-plane/paper/README.md +71 -0
  482. modules/control-plane/paper/appendix.md +152 -0
  483. modules/control-plane/paper/architecture.md +15 -0
  484. modules/control-plane/paper/arxiv/figures/ablation_chart.png +0 -0
  485. modules/control-plane/paper/arxiv/figures/architecture.png +0 -0
  486. modules/control-plane/paper/arxiv/figures/constraint_graphs.png +0 -0
  487. modules/control-plane/paper/arxiv/figures/results_chart.png +0 -0
  488. modules/control-plane/paper/arxiv/main.aux +97 -0
  489. modules/control-plane/paper/arxiv/main.bbl +112 -0
  490. modules/control-plane/paper/arxiv/main.blg +48 -0
  491. modules/control-plane/paper/arxiv/main.out +33 -0
  492. modules/control-plane/paper/arxiv/main.pdf +0 -0
  493. modules/control-plane/paper/arxiv/main.tex +479 -0
  494. modules/control-plane/paper/arxiv/references.bib +234 -0
  495. modules/control-plane/paper/arxiv_submission.tar +0 -0
  496. modules/control-plane/paper/arxiv_submission.zip +0 -0
  497. modules/control-plane/paper/build.sh +68 -0
  498. modules/control-plane/paper/figures/README.md +47 -0
  499. modules/control-plane/paper/figures/ablation_chart.pdf +0 -0
  500. modules/control-plane/paper/figures/ablation_chart.png +0 -0
  501. modules/control-plane/paper/figures/architecture.pdf +0 -0
  502. modules/control-plane/paper/figures/architecture.png +0 -0
  503. modules/control-plane/paper/figures/constraint_graphs.pdf +0 -0
  504. modules/control-plane/paper/figures/constraint_graphs.png +0 -0
  505. modules/control-plane/paper/figures/generate_figures.py +252 -0
  506. modules/control-plane/paper/figures/results_chart.pdf +0 -0
  507. modules/control-plane/paper/figures/results_chart.png +0 -0
  508. modules/control-plane/paper/main.md +273 -0
  509. modules/control-plane/paper/main.tex +214 -0
  510. modules/control-plane/paper/main_arxiv.aux +53 -0
  511. modules/control-plane/paper/main_arxiv.out +17 -0
  512. modules/control-plane/paper/main_arxiv.pdf +0 -0
  513. modules/control-plane/paper/main_arxiv.tex +264 -0
  514. modules/control-plane/paper/references.bib +234 -0
  515. modules/control-plane/pyproject.toml +124 -0
  516. modules/control-plane/reproducibility/ABLATIONS.md +136 -0
  517. modules/control-plane/reproducibility/README.md +288 -0
  518. modules/control-plane/reproducibility/commands.md +467 -0
  519. modules/control-plane/reproducibility/docker_config/Dockerfile +39 -0
  520. modules/control-plane/reproducibility/experiment_configs/purge_config.json +46 -0
  521. modules/control-plane/reproducibility/experiment_configs/rag_config.json +36 -0
  522. modules/control-plane/reproducibility/hardware_specs.md +317 -0
  523. modules/control-plane/reproducibility/requirements_frozen.txt +0 -0
  524. modules/control-plane/reproducibility/run_all_experiments.sh +45 -0
  525. modules/control-plane/reproducibility/seeds.json +106 -0
  526. modules/control-plane/scripts/prepare_pypi.py +46 -0
  527. modules/control-plane/scripts/prepare_release.py +176 -0
  528. modules/control-plane/scripts/upload_dataset_to_hf.py +316 -0
  529. modules/control-plane/setup.py +69 -0
  530. modules/control-plane/src/agent_control_plane/__init__.py +639 -0
  531. modules/control-plane/src/agent_control_plane/a2a_adapter.py +541 -0
  532. modules/control-plane/src/agent_control_plane/adapter.py +415 -0
  533. modules/control-plane/src/agent_control_plane/agent_hibernation.py +364 -0
  534. modules/control-plane/src/agent_control_plane/agent_kernel.py +464 -0
  535. modules/control-plane/src/agent_control_plane/compliance.py +718 -0
  536. modules/control-plane/src/agent_control_plane/constraint_graphs.py +475 -0
  537. modules/control-plane/src/agent_control_plane/control_plane.py +848 -0
  538. modules/control-plane/src/agent_control_plane/example_executors.py +193 -0
  539. modules/control-plane/src/agent_control_plane/execution_engine.py +229 -0
  540. modules/control-plane/src/agent_control_plane/flight_recorder.py +600 -0
  541. modules/control-plane/src/agent_control_plane/governance_layer.py +432 -0
  542. modules/control-plane/src/agent_control_plane/hf_utils.py +561 -0
  543. modules/control-plane/src/agent_control_plane/interfaces/__init__.py +53 -0
  544. modules/control-plane/src/agent_control_plane/interfaces/kernel_interface.py +359 -0
  545. modules/control-plane/src/agent_control_plane/interfaces/plugin_interface.py +495 -0
  546. modules/control-plane/src/agent_control_plane/interfaces/protocol_interfaces.py +385 -0
  547. modules/control-plane/src/agent_control_plane/kernel_space.py +707 -0
  548. modules/control-plane/src/agent_control_plane/langchain_adapter.py +422 -0
  549. modules/control-plane/src/agent_control_plane/lifecycle.py +3111 -0
  550. modules/control-plane/src/agent_control_plane/mcp_adapter.py +517 -0
  551. modules/control-plane/src/agent_control_plane/ml_safety.py +560 -0
  552. modules/control-plane/src/agent_control_plane/multimodal.py +724 -0
  553. modules/control-plane/src/agent_control_plane/mute_agent.py +419 -0
  554. modules/control-plane/src/agent_control_plane/observability.py +785 -0
  555. modules/control-plane/src/agent_control_plane/orchestrator.py +480 -0
  556. modules/control-plane/src/agent_control_plane/plugin_registry.py +748 -0
  557. modules/control-plane/src/agent_control_plane/policy_engine.py +525 -0
  558. modules/control-plane/src/agent_control_plane/shadow_mode.py +307 -0
  559. modules/control-plane/src/agent_control_plane/signals.py +491 -0
  560. modules/control-plane/src/agent_control_plane/supervisor_agents.py +427 -0
  561. modules/control-plane/src/agent_control_plane/time_travel_debugger.py +554 -0
  562. modules/control-plane/src/agent_control_plane/tool_registry.py +350 -0
  563. modules/control-plane/src/agent_control_plane/vfs.py +695 -0
  564. modules/control-plane/tests/README.md +33 -0
  565. modules/control-plane/tests/test_a2a_adapter.py +336 -0
  566. modules/control-plane/tests/test_adapter.py +422 -0
  567. modules/control-plane/tests/test_advanced_features.py +389 -0
  568. modules/control-plane/tests/test_benchmark.py +223 -0
  569. modules/control-plane/tests/test_compliance.py +214 -0
  570. modules/control-plane/tests/test_control_plane.py +295 -0
  571. modules/control-plane/tests/test_hibernation.py +274 -0
  572. modules/control-plane/tests/test_kernel_interception.py +284 -0
  573. modules/control-plane/tests/test_langchain_adapter.py +258 -0
  574. modules/control-plane/tests/test_lifecycle.py +1174 -0
  575. modules/control-plane/tests/test_mcp_adapter.py +293 -0
  576. modules/control-plane/tests/test_ml_safety.py +142 -0
  577. modules/control-plane/tests/test_multimodal.py +317 -0
  578. modules/control-plane/tests/test_new_features.py +435 -0
  579. modules/control-plane/tests/test_observability.py +338 -0
  580. modules/control-plane/tests/test_time_travel.py +387 -0
  581. modules/emk/.github/workflows/ci.yml +105 -0
  582. modules/emk/.github/workflows/publish.yml +144 -0
  583. modules/emk/.gitignore +74 -0
  584. modules/emk/CHANGELOG.md +41 -0
  585. modules/emk/CONTRIBUTING.md +295 -0
  586. modules/emk/IMPLEMENTATION.md +174 -0
  587. modules/emk/LICENSE +21 -0
  588. modules/emk/MANIFEST.in +8 -0
  589. modules/emk/README.md +135 -0
  590. modules/emk/RELEASE_NOTES.md +82 -0
  591. modules/emk/SECURITY.md +52 -0
  592. modules/emk/codecov.yml +39 -0
  593. modules/emk/docs/MEMORY_MANAGEMENT.md +285 -0
  594. modules/emk/emk/__init__.py +106 -0
  595. modules/emk/emk/hf_utils.py +419 -0
  596. modules/emk/emk/indexer.py +144 -0
  597. modules/emk/emk/py.typed +0 -0
  598. modules/emk/emk/schema.py +204 -0
  599. modules/emk/emk/sleep_cycle.py +345 -0
  600. modules/emk/emk/store.py +479 -0
  601. modules/emk/examples/basic_usage.py +123 -0
  602. modules/emk/examples/memory_features_demo.py +154 -0
  603. modules/emk/experiments/README.md +59 -0
  604. modules/emk/experiments/reproduce_results.py +461 -0
  605. modules/emk/experiments/results.json +61 -0
  606. modules/emk/paper/structure.tex +192 -0
  607. modules/emk/paper/whitepaper.md +273 -0
  608. modules/emk/pyproject.toml +91 -0
  609. modules/emk/setup.py +5 -0
  610. modules/emk/tests/test_file_adapter.py +195 -0
  611. modules/emk/tests/test_indexer.py +174 -0
  612. modules/emk/tests/test_init.py +55 -0
  613. modules/emk/tests/test_negative_memory.py +83 -0
  614. modules/emk/tests/test_schema.py +150 -0
  615. modules/emk/tests/test_semantic_rules.py +175 -0
  616. modules/emk/tests/test_sleep_cycle.py +335 -0
  617. modules/emk/tests/test_store_anti_patterns.py +239 -0
  618. modules/iatp/.github/workflows/docker-build.yml +124 -0
  619. modules/iatp/.github/workflows/publish.yml +174 -0
  620. modules/iatp/.github/workflows/python-package.yml +121 -0
  621. modules/iatp/.gitignore +67 -0
  622. modules/iatp/.pre-commit-config.yaml +64 -0
  623. modules/iatp/CHANGELOG.md +120 -0
  624. modules/iatp/Dockerfile +91 -0
  625. modules/iatp/IMPLEMENTATION_SUMMARY.md +218 -0
  626. modules/iatp/MANIFEST.in +9 -0
  627. modules/iatp/README.md +180 -0
  628. modules/iatp/docker/Dockerfile.agent +27 -0
  629. modules/iatp/docker/Dockerfile.sidecar-python +86 -0
  630. modules/iatp/docker/README.md +258 -0
  631. modules/iatp/docker-compose.yml +194 -0
  632. modules/iatp/docs/ARCHITECTURE.md +243 -0
  633. modules/iatp/docs/CLI_GUIDE.md +220 -0
  634. modules/iatp/docs/DEPLOYMENT.md +304 -0
  635. modules/iatp/examples/README.md +132 -0
  636. modules/iatp/examples/backend_agent.py +39 -0
  637. modules/iatp/examples/client.py +168 -0
  638. modules/iatp/examples/demo_attestation_reputation.py +274 -0
  639. modules/iatp/examples/demo_client.py +240 -0
  640. modules/iatp/examples/demo_rbac.py +143 -0
  641. modules/iatp/examples/integration_demo.py +245 -0
  642. modules/iatp/examples/manifests/coder_agent.json +20 -0
  643. modules/iatp/examples/manifests/reviewer_agent.json +19 -0
  644. modules/iatp/examples/manifests/secure_bank.json +14 -0
  645. modules/iatp/examples/manifests/standard_agent.json +14 -0
  646. modules/iatp/examples/manifests/untrusted_honeypot.json +14 -0
  647. modules/iatp/examples/run_secure_bank_sidecar.py +85 -0
  648. modules/iatp/examples/run_sidecar.py +105 -0
  649. modules/iatp/examples/run_untrusted_sidecar.py +77 -0
  650. modules/iatp/examples/secure_bank_agent.py +138 -0
  651. modules/iatp/examples/test_untrusted.py +82 -0
  652. modules/iatp/examples/untrusted_agent.py +119 -0
  653. modules/iatp/experiments/README.md +58 -0
  654. modules/iatp/experiments/cascading_hallucination/README.md +149 -0
  655. modules/iatp/experiments/cascading_hallucination/agent_a_user.py +41 -0
  656. modules/iatp/experiments/cascading_hallucination/agent_b_summarizer.py +54 -0
  657. modules/iatp/experiments/cascading_hallucination/agent_c_database.py +47 -0
  658. modules/iatp/experiments/cascading_hallucination/proof_of_concept.py +290 -0
  659. modules/iatp/experiments/cascading_hallucination/run_experiment.py +226 -0
  660. modules/iatp/experiments/cascading_hallucination/sidecar_c.py +61 -0
  661. modules/iatp/experiments/reproduce_results.py +574 -0
  662. modules/iatp/experiments/results.json +2336 -0
  663. modules/iatp/iatp/__init__.py +164 -0
  664. modules/iatp/iatp/attestation.py +401 -0
  665. modules/iatp/iatp/cli.py +253 -0
  666. modules/iatp/iatp/hf_utils.py +469 -0
  667. modules/iatp/iatp/ipc_pipes.py +578 -0
  668. modules/iatp/iatp/main.py +410 -0
  669. modules/iatp/iatp/models/__init__.py +445 -0
  670. modules/iatp/iatp/policy_engine.py +335 -0
  671. modules/iatp/iatp/py.typed +2 -0
  672. modules/iatp/iatp/recovery.py +319 -0
  673. modules/iatp/iatp/security/__init__.py +268 -0
  674. modules/iatp/iatp/sidecar/__init__.py +517 -0
  675. modules/iatp/iatp/telemetry/__init__.py +162 -0
  676. modules/iatp/iatp/tests/__init__.py +1 -0
  677. modules/iatp/iatp/tests/test_attestation.py +368 -0
  678. modules/iatp/iatp/tests/test_cli.py +129 -0
  679. modules/iatp/iatp/tests/test_models.py +128 -0
  680. modules/iatp/iatp/tests/test_policy_engine.py +345 -0
  681. modules/iatp/iatp/tests/test_recovery.py +279 -0
  682. modules/iatp/iatp/tests/test_security.py +220 -0
  683. modules/iatp/iatp/tests/test_sidecar.py +165 -0
  684. modules/iatp/iatp/tests/test_telemetry.py +173 -0
  685. modules/iatp/paper/BLOG.md +307 -0
  686. modules/iatp/paper/PAPER.md +236 -0
  687. modules/iatp/paper/RFC_SUBMISSION.md +299 -0
  688. modules/iatp/paper/whitepaper.md +369 -0
  689. modules/iatp/proto/README.md +200 -0
  690. modules/iatp/proto/generate_stubs.py +81 -0
  691. modules/iatp/proto/iatp.proto +552 -0
  692. modules/iatp/pyproject.toml +180 -0
  693. modules/iatp/requirements-dev.txt +2 -0
  694. modules/iatp/requirements.txt +6 -0
  695. modules/iatp/setup.py +60 -0
  696. modules/iatp/sidecar/README.md +487 -0
  697. modules/iatp/sidecar/go/Dockerfile +32 -0
  698. modules/iatp/sidecar/go/README.md +237 -0
  699. modules/iatp/sidecar/go/go.mod +8 -0
  700. modules/iatp/sidecar/go/main.go +488 -0
  701. modules/iatp/spec/001-handshake.md +436 -0
  702. modules/iatp/spec/002-reversibility.md +394 -0
  703. modules/iatp/spec/schema/capability_manifest.json +266 -0
  704. modules/iatp/test_integration.py +310 -0
  705. modules/mcp-kernel-server/README.md +261 -0
  706. modules/mcp-kernel-server/pyproject.toml +60 -0
  707. modules/mcp-kernel-server/src/mcp_kernel_server/__init__.py +26 -0
  708. modules/mcp-kernel-server/src/mcp_kernel_server/cli.py +229 -0
  709. modules/mcp-kernel-server/src/mcp_kernel_server/resources.py +215 -0
  710. modules/mcp-kernel-server/src/mcp_kernel_server/server.py +562 -0
  711. modules/mcp-kernel-server/src/mcp_kernel_server/tools.py +1172 -0
  712. modules/mute-agent/.github/workflows/safety_check.yml +45 -0
  713. modules/mute-agent/.gitignore +53 -0
  714. modules/mute-agent/ARCHITECTURE.md +531 -0
  715. modules/mute-agent/BENCHMARK_GUIDE.md +384 -0
  716. modules/mute-agent/COMPLETION_SUMMARY.md +293 -0
  717. modules/mute-agent/EXPERIMENT_SUMMARY.md +318 -0
  718. modules/mute-agent/IMPLEMENTATION_SUMMARY.md +212 -0
  719. modules/mute-agent/LICENSE +21 -0
  720. modules/mute-agent/PHASE3_SUMMARY.md +297 -0
  721. modules/mute-agent/README.md +360 -0
  722. modules/mute-agent/STEEL_MAN_RESULTS.md +353 -0
  723. modules/mute-agent/USAGE.md +505 -0
  724. modules/mute-agent/V2_IMPLEMENTATION_SUMMARY.md +253 -0
  725. modules/mute-agent/V2_STEEL_MAN_IMPLEMENTATION.md +274 -0
  726. modules/mute-agent/VERIFICATION_REPORT.md +435 -0
  727. modules/mute-agent/charts/cost_comparison.png +0 -0
  728. modules/mute-agent/charts/cost_vs_ambiguity.png +0 -0
  729. modules/mute-agent/charts/metrics_comparison.png +0 -0
  730. modules/mute-agent/charts/scenario_breakdown.png +0 -0
  731. modules/mute-agent/charts/trace_attack_blocked.html +140 -0
  732. modules/mute-agent/charts/trace_attack_blocked.png +0 -0
  733. modules/mute-agent/charts/trace_failure.html +140 -0
  734. modules/mute-agent/charts/trace_failure.png +0 -0
  735. modules/mute-agent/charts/trace_success.html +140 -0
  736. modules/mute-agent/charts/trace_success.png +0 -0
  737. modules/mute-agent/examples/__init__.py +1 -0
  738. modules/mute-agent/examples/advanced_example.py +384 -0
  739. modules/mute-agent/examples/graph_debugger_demo.py +241 -0
  740. modules/mute-agent/examples/listener_example.py +297 -0
  741. modules/mute-agent/examples/simple_example.py +242 -0
  742. modules/mute-agent/examples/steel_man_demo.py +297 -0
  743. modules/mute-agent/experiments/README.md +135 -0
  744. modules/mute-agent/experiments/__init__.py +3 -0
  745. modules/mute-agent/experiments/agent_comparison.csv +6 -0
  746. modules/mute-agent/experiments/agent_comparison_50runs.csv +6 -0
  747. modules/mute-agent/experiments/ambiguity_test.py +335 -0
  748. modules/mute-agent/experiments/ambiguity_test_results.csv +31 -0
  749. modules/mute-agent/experiments/ambiguity_test_results_50runs.csv +51 -0
  750. modules/mute-agent/experiments/baseline_agent.py +189 -0
  751. modules/mute-agent/experiments/benchmark.py +402 -0
  752. modules/mute-agent/experiments/demo.py +172 -0
  753. modules/mute-agent/experiments/generate_cost_curve.py +474 -0
  754. modules/mute-agent/experiments/jailbreak_test.py +137 -0
  755. modules/mute-agent/experiments/latent_state_scenario.py +361 -0
  756. modules/mute-agent/experiments/mute_agent_experiment.py +349 -0
  757. modules/mute-agent/experiments/run_extended_experiment.py +40 -0
  758. modules/mute-agent/experiments/run_v2_experiments.py +266 -0
  759. modules/mute-agent/experiments/run_v2_experiments_auto.py +247 -0
  760. modules/mute-agent/experiments/v2_scenarios/README.md +214 -0
  761. modules/mute-agent/experiments/v2_scenarios/__init__.py +4 -0
  762. modules/mute-agent/experiments/v2_scenarios/scenario_1_deep_dependency.py +325 -0
  763. modules/mute-agent/experiments/v2_scenarios/scenario_2_adversarial.py +328 -0
  764. modules/mute-agent/experiments/v2_scenarios/scenario_3_false_positive.py +303 -0
  765. modules/mute-agent/experiments/v2_scenarios/scenario_4_performance.py +319 -0
  766. modules/mute-agent/experiments/visualize.py +400 -0
  767. modules/mute-agent/mute_agent/__init__.py +66 -0
  768. modules/mute-agent/mute_agent/core/__init__.py +1 -0
  769. modules/mute-agent/mute_agent/core/execution_agent.py +164 -0
  770. modules/mute-agent/mute_agent/core/handshake_protocol.py +199 -0
  771. modules/mute-agent/mute_agent/core/reasoning_agent.py +236 -0
  772. modules/mute-agent/mute_agent/knowledge_graph/__init__.py +1 -0
  773. modules/mute-agent/mute_agent/knowledge_graph/graph_elements.py +63 -0
  774. modules/mute-agent/mute_agent/knowledge_graph/multidimensional_graph.py +168 -0
  775. modules/mute-agent/mute_agent/knowledge_graph/subgraph.py +222 -0
  776. modules/mute-agent/mute_agent/listener/__init__.py +41 -0
  777. modules/mute-agent/mute_agent/listener/adapters/__init__.py +29 -0
  778. modules/mute-agent/mute_agent/listener/adapters/base_adapter.py +187 -0
  779. modules/mute-agent/mute_agent/listener/adapters/caas_adapter.py +342 -0
  780. modules/mute-agent/mute_agent/listener/adapters/control_plane_adapter.py +434 -0
  781. modules/mute-agent/mute_agent/listener/adapters/iatp_adapter.py +330 -0
  782. modules/mute-agent/mute_agent/listener/adapters/scak_adapter.py +249 -0
  783. modules/mute-agent/mute_agent/listener/listener.py +608 -0
  784. modules/mute-agent/mute_agent/listener/state_observer.py +434 -0
  785. modules/mute-agent/mute_agent/listener/threshold_config.py +311 -0
  786. modules/mute-agent/mute_agent/super_system/__init__.py +1 -0
  787. modules/mute-agent/mute_agent/super_system/router.py +202 -0
  788. modules/mute-agent/mute_agent/visualization/__init__.py +8 -0
  789. modules/mute-agent/mute_agent/visualization/graph_debugger.py +495 -0
  790. modules/mute-agent/requirements-dev.txt +6 -0
  791. modules/mute-agent/requirements.txt +9 -0
  792. modules/mute-agent/setup.py +64 -0
  793. modules/mute-agent/src/__init__.py +0 -0
  794. modules/mute-agent/src/agents/__init__.py +0 -0
  795. modules/mute-agent/src/agents/baseline_agent.py +524 -0
  796. modules/mute-agent/src/agents/interactive_agent.py +113 -0
  797. modules/mute-agent/src/agents/mute_agent.py +622 -0
  798. modules/mute-agent/src/benchmarks/__init__.py +0 -0
  799. modules/mute-agent/src/benchmarks/evaluator.py +481 -0
  800. modules/mute-agent/src/benchmarks/scenarios.json +985 -0
  801. modules/mute-agent/src/core/__init__.py +0 -0
  802. modules/mute-agent/src/core/mock_state.py +320 -0
  803. modules/mute-agent/src/core/tools.py +441 -0
  804. modules/nexus/__init__.py +49 -0
  805. modules/nexus/arbiter.py +357 -0
  806. modules/nexus/client.py +464 -0
  807. modules/nexus/dmz.py +417 -0
  808. modules/nexus/escrow.py +428 -0
  809. modules/nexus/exceptions.py +284 -0
  810. modules/nexus/registry.py +391 -0
  811. modules/nexus/reputation.py +423 -0
  812. modules/nexus/schemas/__init__.py +49 -0
  813. modules/nexus/schemas/compliance.py +274 -0
  814. modules/nexus/schemas/escrow.py +249 -0
  815. modules/nexus/schemas/manifest.py +223 -0
  816. modules/nexus/schemas/receipt.py +206 -0
  817. modules/observability/README.md +192 -0
  818. modules/observability/alertmanager/alertmanager.yml +116 -0
  819. modules/observability/alerts/agent-os-alerts.yaml +197 -0
  820. modules/observability/docker-compose.yml +128 -0
  821. modules/observability/grafana/dashboards/agent-os-amb.json +448 -0
  822. modules/observability/grafana/dashboards/agent-os-cmvk.json +441 -0
  823. modules/observability/grafana/dashboards/agent-os-overview.json +268 -0
  824. modules/observability/grafana/dashboards/agent-os-performance.json +15 -0
  825. modules/observability/grafana/dashboards/agent-os-safety.json +50 -0
  826. modules/observability/grafana/provisioning/dashboards/dashboards.yml +15 -0
  827. modules/observability/grafana/provisioning/datasources/datasources.yml +33 -0
  828. modules/observability/otel/otel-collector-config.yml +61 -0
  829. modules/observability/prometheus/prometheus.yml +63 -0
  830. modules/observability/pyproject.toml +53 -0
  831. modules/observability/scripts/export_dashboards.py +55 -0
  832. modules/observability/src/agent_os_observability/__init__.py +25 -0
  833. modules/observability/src/agent_os_observability/dashboards.py +896 -0
  834. modules/observability/src/agent_os_observability/metrics.py +396 -0
  835. modules/observability/src/agent_os_observability/server.py +221 -0
  836. modules/observability/src/agent_os_observability/tracer.py +226 -0
  837. modules/primitives/.gitignore +8 -0
  838. modules/primitives/README.md +62 -0
  839. modules/primitives/agent_primitives/__init__.py +22 -0
  840. modules/primitives/agent_primitives/failures.py +82 -0
  841. modules/primitives/agent_primitives/py.typed +0 -0
  842. modules/primitives/pyproject.toml +68 -0
  843. modules/scak/.github/copilot-instructions.md +396 -0
  844. modules/scak/.github/workflows/release.yml +117 -0
  845. modules/scak/.gitignore +32 -0
  846. modules/scak/CHANGELOG.md +173 -0
  847. modules/scak/CITATION.cff +62 -0
  848. modules/scak/CONTRIBUTING.md +429 -0
  849. modules/scak/Dockerfile +58 -0
  850. modules/scak/ENTERPRISE_FEATURES.md +518 -0
  851. modules/scak/IMPLEMENTATION_SUMMARY.md +206 -0
  852. modules/scak/LIMITATIONS.md +565 -0
  853. modules/scak/MANIFEST.in +16 -0
  854. modules/scak/NOVELTY.md +535 -0
  855. modules/scak/README.md +928 -0
  856. modules/scak/RESEARCH.md +670 -0
  857. modules/scak/agent_kernel/__init__.py +66 -0
  858. modules/scak/agent_kernel/analyzer.py +432 -0
  859. modules/scak/agent_kernel/auditor.py +31 -0
  860. modules/scak/agent_kernel/completeness_auditor.py +234 -0
  861. modules/scak/agent_kernel/detector.py +200 -0
  862. modules/scak/agent_kernel/kernel.py +741 -0
  863. modules/scak/agent_kernel/memory_manager.py +82 -0
  864. modules/scak/agent_kernel/models.py +372 -0
  865. modules/scak/agent_kernel/nudge_mechanism.py +260 -0
  866. modules/scak/agent_kernel/outcome_analyzer.py +335 -0
  867. modules/scak/agent_kernel/patcher.py +579 -0
  868. modules/scak/agent_kernel/semantic_analyzer.py +313 -0
  869. modules/scak/agent_kernel/semantic_purge.py +346 -0
  870. modules/scak/agent_kernel/simulator.py +447 -0
  871. modules/scak/agent_kernel/teacher.py +82 -0
  872. modules/scak/agent_kernel/triage.py +149 -0
  873. modules/scak/build_and_publish.ps1 +74 -0
  874. modules/scak/build_and_publish.sh +74 -0
  875. modules/scak/cli.py +471 -0
  876. modules/scak/dashboard.py +462 -0
  877. modules/scak/datasets/DATASET_CARD.md +219 -0
  878. modules/scak/datasets/README.md +143 -0
  879. modules/scak/datasets/gaia_vague_queries/vague_queries.json +262 -0
  880. modules/scak/datasets/hf_upload/README.md +219 -0
  881. modules/scak/datasets/hf_upload/scak_gaia_laziness.jsonl +50 -0
  882. modules/scak/datasets/prepare_hf_datasets.py +145 -0
  883. modules/scak/datasets/red_team/jailbreak_patterns.json +202 -0
  884. modules/scak/docker-compose.yml +99 -0
  885. modules/scak/docs/Adaptive-Memory-Hierarchy.md +319 -0
  886. modules/scak/docs/Data-Contracts-and-Schemas.md +285 -0
  887. modules/scak/docs/Dual-Loop-Architecture.md +344 -0
  888. modules/scak/docs/Enhanced-Features.md +612 -0
  889. modules/scak/docs/LANGCHAIN_INTEGRATION.md +572 -0
  890. modules/scak/docs/README.md +128 -0
  891. modules/scak/docs/Reference-Implementations.md +163 -0
  892. modules/scak/docs/SCAK_V2.md +374 -0
  893. modules/scak/docs/Three-Failure-Types.md +178 -0
  894. modules/scak/examples/basic_example.py +155 -0
  895. modules/scak/examples/circuit_breaker_lazy_eval_demo.py +243 -0
  896. modules/scak/examples/langchain_integration_example.py +339 -0
  897. modules/scak/examples/layer4_demo.py +243 -0
  898. modules/scak/examples/production_features_demo.py +353 -0
  899. modules/scak/examples/quick_demo.py +79 -0
  900. modules/scak/examples/scak_v2_demo.py +252 -0
  901. modules/scak/experiments/README.md +438 -0
  902. modules/scak/experiments/ablation_studies/README.md +192 -0
  903. modules/scak/experiments/ablation_studies/ablation_no_audit.py +116 -0
  904. modules/scak/experiments/ablation_studies/ablation_no_purge.py +133 -0
  905. modules/scak/experiments/chaos_engineering/README.md +332 -0
  906. modules/scak/experiments/context_efficiency_test.py +328 -0
  907. modules/scak/experiments/gaia_benchmark/README.md +208 -0
  908. modules/scak/experiments/laziness_benchmark.py +179 -0
  909. modules/scak/experiments/long_horizon_task_experiment.py +252 -0
  910. modules/scak/experiments/multi_agent_rag_experiment.py +284 -0
  911. modules/scak/experiments/results/ablation_table.md +12 -0
  912. modules/scak/experiments/results/long_horizon.json +36 -0
  913. modules/scak/experiments/results/multi_agent_rag.json +66 -0
  914. modules/scak/experiments/run_comprehensive_ablations.py +332 -0
  915. modules/scak/experiments/test_auditor_patcher_integration.py +251 -0
  916. modules/scak/notebooks/getting_started.ipynb +33 -0
  917. modules/scak/paper/ARXIV_SUBMISSION_METADATA.txt +109 -0
  918. modules/scak/paper/PAPER_CHECKLIST.md +304 -0
  919. modules/scak/paper/Paper.pdf +0 -0
  920. modules/scak/paper/README.md +113 -0
  921. modules/scak/paper/appendix.md +351 -0
  922. modules/scak/paper/arxiv/bibliography.bib +284 -0
  923. modules/scak/paper/arxiv/fig1_ooda_architecture.pdf +0 -0
  924. modules/scak/paper/arxiv/fig2_memory_hierarchy.pdf +0 -0
  925. modules/scak/paper/arxiv/fig3_gaia_results.pdf +0 -0
  926. modules/scak/paper/arxiv/fig4_ablation_heatmap.pdf +0 -0
  927. modules/scak/paper/arxiv/fig5_context_reduction.pdf +0 -0
  928. modules/scak/paper/arxiv/fig6_mttr_boxplot.pdf +0 -0
  929. modules/scak/paper/arxiv/main.aux +103 -0
  930. modules/scak/paper/arxiv/main.bbl +113 -0
  931. modules/scak/paper/arxiv/main.blg +55 -0
  932. modules/scak/paper/arxiv/main.out +31 -0
  933. modules/scak/paper/arxiv/main.pdf +0 -0
  934. modules/scak/paper/arxiv/main.tex +482 -0
  935. modules/scak/paper/arxiv_submission/bibliography.bib +284 -0
  936. modules/scak/paper/arxiv_submission/fig1_ooda_architecture.pdf +0 -0
  937. modules/scak/paper/arxiv_submission/fig2_memory_hierarchy.pdf +0 -0
  938. modules/scak/paper/arxiv_submission/fig3_gaia_results.pdf +0 -0
  939. modules/scak/paper/arxiv_submission/fig4_ablation_heatmap.pdf +0 -0
  940. modules/scak/paper/arxiv_submission/fig5_context_reduction.pdf +0 -0
  941. modules/scak/paper/arxiv_submission/fig6_mttr_boxplot.pdf +0 -0
  942. modules/scak/paper/arxiv_submission/main.aux +103 -0
  943. modules/scak/paper/arxiv_submission/main.bbl +113 -0
  944. modules/scak/paper/arxiv_submission/main.blg +55 -0
  945. modules/scak/paper/arxiv_submission/main.out +31 -0
  946. modules/scak/paper/arxiv_submission/main.pdf +0 -0
  947. modules/scak/paper/arxiv_submission/main.tex +482 -0
  948. modules/scak/paper/arxiv_submission.tar.gz +0 -0
  949. modules/scak/paper/bibliography.bib +284 -0
  950. modules/scak/paper/build.sh +55 -0
  951. modules/scak/paper/figures/README.md +32 -0
  952. modules/scak/paper/figures/fig1_ooda_architecture.md +75 -0
  953. modules/scak/paper/figures/fig1_ooda_architecture.pdf +0 -0
  954. modules/scak/paper/figures/fig1_ooda_architecture.png +0 -0
  955. modules/scak/paper/figures/fig2_memory_hierarchy.md +83 -0
  956. modules/scak/paper/figures/fig2_memory_hierarchy.pdf +0 -0
  957. modules/scak/paper/figures/fig2_memory_hierarchy.png +0 -0
  958. modules/scak/paper/figures/fig3_gaia_results.md +64 -0
  959. modules/scak/paper/figures/fig3_gaia_results.pdf +0 -0
  960. modules/scak/paper/figures/fig3_gaia_results.png +0 -0
  961. modules/scak/paper/figures/fig4_ablation_heatmap.md +64 -0
  962. modules/scak/paper/figures/fig4_ablation_heatmap.pdf +0 -0
  963. modules/scak/paper/figures/fig4_ablation_heatmap.png +0 -0
  964. modules/scak/paper/figures/fig5_context_reduction.md +71 -0
  965. modules/scak/paper/figures/fig5_context_reduction.pdf +0 -0
  966. modules/scak/paper/figures/fig5_context_reduction.png +0 -0
  967. modules/scak/paper/figures/fig6_mttr_boxplot.md +80 -0
  968. modules/scak/paper/figures/fig6_mttr_boxplot.pdf +0 -0
  969. modules/scak/paper/figures/fig6_mttr_boxplot.png +0 -0
  970. modules/scak/paper/figures/generate_figures.py +463 -0
  971. modules/scak/paper/main.aux +103 -0
  972. modules/scak/paper/main.bbl +113 -0
  973. modules/scak/paper/main.blg +55 -0
  974. modules/scak/paper/main.md +192 -0
  975. modules/scak/paper/main.out +31 -0
  976. modules/scak/paper/main.pdf +0 -0
  977. modules/scak/paper/main.tex +482 -0
  978. modules/scak/reproducibility/ABLATIONS.md +225 -0
  979. modules/scak/reproducibility/Dockerfile.reproducibility +34 -0
  980. modules/scak/reproducibility/README.md +421 -0
  981. modules/scak/reproducibility/requirements-pinned.txt +32 -0
  982. modules/scak/reproducibility/run_all_experiments.py +395 -0
  983. modules/scak/reproducibility/seed_control.py +53 -0
  984. modules/scak/reproducibility/statistical_analysis.py +302 -0
  985. modules/scak/requirements.txt +50 -0
  986. modules/scak/setup.py +93 -0
  987. modules/scak/src/__init__.py +124 -0
  988. modules/scak/src/agents/__init__.py +13 -0
  989. modules/scak/src/agents/conflict_resolution.py +732 -0
  990. modules/scak/src/agents/orchestrator.py +761 -0
  991. modules/scak/src/agents/pubsub.py +484 -0
  992. modules/scak/src/agents/shadow_teacher.py +344 -0
  993. modules/scak/src/agents/swarm.py +661 -0
  994. modules/scak/src/agents/worker.py +357 -0
  995. modules/scak/src/integrations/__init__.py +81 -0
  996. modules/scak/src/integrations/cmvk_adapter.py +430 -0
  997. modules/scak/src/integrations/control_plane_adapter.py +601 -0
  998. modules/scak/src/integrations/langchain_integration.py +902 -0
  999. modules/scak/src/interfaces/__init__.py +59 -0
  1000. modules/scak/src/interfaces/llm_clients.py +505 -0
  1001. modules/scak/src/interfaces/openapi_tools.py +611 -0
  1002. modules/scak/src/interfaces/plugin_system.py +605 -0
  1003. modules/scak/src/interfaces/protocols.py +365 -0
  1004. modules/scak/src/interfaces/telemetry.py +464 -0
  1005. modules/scak/src/interfaces/tool_registry.py +547 -0
  1006. modules/scak/src/kernel/__init__.py +100 -0
  1007. modules/scak/src/kernel/auditor.py +305 -0
  1008. modules/scak/src/kernel/circuit_breaker.py +398 -0
  1009. modules/scak/src/kernel/core.py +724 -0
  1010. modules/scak/src/kernel/distributed.py +667 -0
  1011. modules/scak/src/kernel/evolution.py +455 -0
  1012. modules/scak/src/kernel/failover.py +621 -0
  1013. modules/scak/src/kernel/governance.py +710 -0
  1014. modules/scak/src/kernel/governance_v2.py +603 -0
  1015. modules/scak/src/kernel/lazy_evaluator.py +514 -0
  1016. modules/scak/src/kernel/load_testing.py +633 -0
  1017. modules/scak/src/kernel/memory.py +945 -0
  1018. modules/scak/src/kernel/patcher.py +581 -0
  1019. modules/scak/src/kernel/rubric.py +419 -0
  1020. modules/scak/src/kernel/schemas.py +390 -0
  1021. modules/scak/src/kernel/skill_mapper.py +309 -0
  1022. modules/scak/src/kernel/triage.py +149 -0
  1023. modules/scak/src/mocks/__init__.py +99 -0
  1024. modules/scak/tests/__init__.py +1 -0
  1025. modules/scak/tests/test_circuit_breaker.py +403 -0
  1026. modules/scak/tests/test_conflict_resolution.py +287 -0
  1027. modules/scak/tests/test_dual_loop.py +463 -0
  1028. modules/scak/tests/test_enhanced_features.py +421 -0
  1029. modules/scak/tests/test_failover_and_load.py +438 -0
  1030. modules/scak/tests/test_governance.py +185 -0
  1031. modules/scak/tests/test_kernel.py +359 -0
  1032. modules/scak/tests/test_langchain_integration.py +451 -0
  1033. modules/scak/tests/test_lazy_evaluator.py +465 -0
  1034. modules/scak/tests/test_llm_clients.py +122 -0
  1035. modules/scak/tests/test_memory_controller.py +528 -0
  1036. modules/scak/tests/test_orchestrator.py +181 -0
  1037. modules/scak/tests/test_phase3_integration.py +265 -0
  1038. modules/scak/tests/test_pubsub_swarm.py +203 -0
  1039. modules/scak/tests/test_reference_implementations.py +240 -0
  1040. modules/scak/tests/test_rubric.py +363 -0
  1041. modules/scak/tests/test_scak_v2.py +651 -0
  1042. modules/scak/tests/test_skill_mapper.py +217 -0
  1043. modules/scak/tests/test_specific_failures.py +393 -0
  1044. modules/scak/tests/test_tool_registry.py +264 -0
  1045. modules/scak/tests/test_tools_and_plugins.py +303 -0
  1046. modules/scak/tests/test_triage.py +596 -0
  1047. modules/scak/tests/test_write_through.py +319 -0
  1048. agent_os_kernel-1.1.0.dist-info/METADATA +0 -400
  1049. agent_os_kernel-1.1.0.dist-info/RECORD +0 -12
  1050. {agent_os_kernel-1.1.0.dist-info → agent_os_kernel-1.2.0.dist-info}/WHEEL +0 -0
  1051. {agent_os_kernel-1.1.0.dist-info → agent_os_kernel-1.2.0.dist-info}/licenses/LICENSE +0 -0
modules/cmvk/coverage_html/z_2c49bd2ed3e01e38_constitutional_py.html ADDED
@@ -0,0 +1,1001 @@
1
+ <!DOCTYPE html>
2
+ <html lang="en">
3
+ <head>
4
+ <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
5
+ <title>Coverage for src\cmvk\constitutional.py: 83%</title>
6
+ <link rel="icon" sizes="32x32" href="favicon_32_cb_c827f16f.png">
7
+ <link rel="stylesheet" href="style_cb_5c747636.css" type="text/css">
8
+ <script src="coverage_html_cb_188fc9a4.js" defer></script>
9
+ </head>
10
+ <body class="pyfile">
11
+ <header>
12
+ <div class="content">
13
+ <h1>
14
+ <span class="text">Coverage for </span><b>src&#8201;\&#8201;cmvk&#8201;\&#8201;constitutional.py</b>:
15
+ <span class="pc_cov">83%</span>
16
+ </h1>
17
+ <aside id="help_panel_wrapper">
18
+ <input id="help_panel_state" type="checkbox">
19
+ <label for="help_panel_state">
20
+ <img id="keyboard_icon" src="keybd_closed_cb_900cfef5.png" alt="Show/hide keyboard shortcuts">
21
+ </label>
22
+ <div id="help_panel">
23
+ <p class="legend">Shortcuts on this page</p>
24
+ <div class="keyhelp">
25
+ <p>
26
+ <kbd>r</kbd>
27
+ <kbd>m</kbd>
28
+ <kbd>x</kbd>
29
+ <kbd>p</kbd>
30
+ &nbsp; toggle line displays
31
+ </p>
32
+ <p>
33
+ <kbd>j</kbd>
34
+ <kbd>k</kbd>
35
+ &nbsp; next/prev highlighted chunk
36
+ </p>
37
+ <p>
38
+ <kbd>0</kbd> &nbsp; (zero) top of page
39
+ </p>
40
+ <p>
41
+ <kbd>1</kbd> &nbsp; (one) first highlighted chunk
42
+ </p>
43
+ <p>
44
+ <kbd>[</kbd>
45
+ <kbd>]</kbd>
46
+ &nbsp; prev/next file
47
+ </p>
48
+ <p>
49
+ <kbd>u</kbd> &nbsp; up to the index
50
+ </p>
51
+ <p>
52
+ <kbd>?</kbd> &nbsp; show/hide this help
53
+ </p>
54
+ </div>
55
+ </div>
56
+ </aside>
57
+ <h2>
58
+ <span class="text">231 statements &nbsp;</span>
59
+ <button type="button" class="run button_toggle_run" value="run" data-shortcut="r" title="Toggle lines run">201<span class="text"> run</span></button>
60
+ <button type="button" class="mis show_mis button_toggle_mis" value="mis" data-shortcut="m" title="Toggle lines missing">30<span class="text"> missing</span></button>
61
+ <button type="button" class="exc show_exc button_toggle_exc" value="exc" data-shortcut="x" title="Toggle lines excluded">0<span class="text"> excluded</span></button>
62
+ <button type="button" class="par run show_par button_toggle_par" value="par" data-shortcut="p" title="Toggle lines partially run">6<span class="text"> partial</span></button>
63
+ </h2>
64
+ <p class="text">
65
+ <a id="prevFileLink" class="nav" href="z_2c49bd2ed3e01e38_benchmarks_py.html">&#xab; prev</a> &nbsp; &nbsp;
66
+ <a id="indexLink" class="nav" href="index.html">&Hat; index</a> &nbsp; &nbsp;
67
+ <a id="nextFileLink" class="nav" href="z_2c49bd2ed3e01e38_hf_utils_py.html">&#xbb; next</a>
68
+ &nbsp; &nbsp; &nbsp;
69
+ <a class="nav" href="https://coverage.readthedocs.io/en/7.13.1">coverage.py v7.13.1</a>,
70
+ created at 2026-02-02 21:04 -0800
71
+ </p>
72
+ <aside class="hidden">
73
+ <button type="button" class="button_next_chunk" data-shortcut="j"></button>
74
+ <button type="button" class="button_prev_chunk" data-shortcut="k"></button>
75
+ <button type="button" class="button_top_of_page" data-shortcut="0"></button>
76
+ <button type="button" class="button_first_chunk" data-shortcut="1"></button>
77
+ <button type="button" class="button_prev_file" data-shortcut="["></button>
78
+ <button type="button" class="button_next_file" data-shortcut="]"></button>
79
+ <button type="button" class="button_to_index" data-shortcut="u"></button>
80
+ <button type="button" class="button_show_hide_help" data-shortcut="?"></button>
81
+ </aside>
82
+ </div>
83
+ </header>
84
+ <main id="source">
85
+ <p class="pln"><span class="n"><a id="t1" href="#t1">1</a></span><span class="t"><span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
86
+ <p class="pln"><span class="n"><a id="t2" href="#t2">2</a></span><span class="t"><span class="str">Constitutional Validator for CMVK</span>&nbsp;</span><span class="r"></span></p>
87
+ <p class="pln"><span class="n"><a id="t3" href="#t3">3</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
88
+ <p class="pln"><span class="n"><a id="t4" href="#t4">4</a></span><span class="t"><span class="str">This module provides a Constitutional Validator that checks AI outputs against</span>&nbsp;</span><span class="r"></span></p>
89
+ <p class="pln"><span class="n"><a id="t5" href="#t5">5</a></span><span class="t"><span class="str">natural language safety rules (principles). Inspired by Anthropic's Constitutional AI,</span>&nbsp;</span><span class="r"></span></p>
90
+ <p class="pln"><span class="n"><a id="t6" href="#t6">6</a></span><span class="t"><span class="str">this allows defining human-readable rules that are evaluated against outputs.</span>&nbsp;</span><span class="r"></span></p>
91
+ <p class="pln"><span class="n"><a id="t7" href="#t7">7</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
92
+ <p class="pln"><span class="n"><a id="t8" href="#t8">8</a></span><span class="t"><span class="str">Key Features:</span>&nbsp;</span><span class="r"></span></p>
93
+ <p class="pln"><span class="n"><a id="t9" href="#t9">9</a></span><span class="t"><span class="str"> - Define principles in natural language (not regex or code)</span>&nbsp;</span><span class="r"></span></p>
94
+ <p class="pln"><span class="n"><a id="t10" href="#t10">10</a></span><span class="t"><span class="str"> - Evaluate outputs against multiple principles</span>&nbsp;</span><span class="r"></span></p>
95
+ <p class="pln"><span class="n"><a id="t11" href="#t11">11</a></span><span class="t"><span class="str"> - Support for custom principle sets (safety, ethics, brand, regulatory)</span>&nbsp;</span><span class="r"></span></p>
96
+ <p class="pln"><span class="n"><a id="t12" href="#t12">12</a></span><span class="t"><span class="str"> - Async and sync interfaces</span>&nbsp;</span><span class="r"></span></p>
97
+ <p class="pln"><span class="n"><a id="t13" href="#t13">13</a></span><span class="t"><span class="str"> - Pluggable LLM backends for evaluation</span>&nbsp;</span><span class="r"></span></p>
98
+ <p class="pln"><span class="n"><a id="t14" href="#t14">14</a></span><span class="t"><span class="str"> - Detailed violation reports with explanations</span>&nbsp;</span><span class="r"></span></p>
99
+ <p class="pln"><span class="n"><a id="t15" href="#t15">15</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
100
+ <p class="pln"><span class="n"><a id="t16" href="#t16">16</a></span><span class="t"><span class="str">Example Usage:</span>&nbsp;</span><span class="r"></span></p>
101
+ <p class="pln"><span class="n"><a id="t17" href="#t17">17</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
102
+ <p class="pln"><span class="n"><a id="t18" href="#t18">18</a></span><span class="t"><span class="str"> from cmvk.constitutional import (</span>&nbsp;</span><span class="r"></span></p>
103
+ <p class="pln"><span class="n"><a id="t19" href="#t19">19</a></span><span class="t"><span class="str"> ConstitutionalValidator,</span>&nbsp;</span><span class="r"></span></p>
104
+ <p class="pln"><span class="n"><a id="t20" href="#t20">20</a></span><span class="t"><span class="str"> Principle,</span>&nbsp;</span><span class="r"></span></p>
105
+ <p class="pln"><span class="n"><a id="t21" href="#t21">21</a></span><span class="t"><span class="str"> PrincipleSet,</span>&nbsp;</span><span class="r"></span></p>
106
+ <p class="pln"><span class="n"><a id="t22" href="#t22">22</a></span><span class="t"><span class="str"> SAFETY_PRINCIPLES,</span>&nbsp;</span><span class="r"></span></p>
107
+ <p class="pln"><span class="n"><a id="t23" href="#t23">23</a></span><span class="t"><span class="str"> )</span>&nbsp;</span><span class="r"></span></p>
108
+ <p class="pln"><span class="n"><a id="t24" href="#t24">24</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
109
+ <p class="pln"><span class="n"><a id="t25" href="#t25">25</a></span><span class="t"><span class="str"> # Create validator with built-in safety principles</span>&nbsp;</span><span class="r"></span></p>
110
+ <p class="pln"><span class="n"><a id="t26" href="#t26">26</a></span><span class="t"><span class="str"> validator = ConstitutionalValidator(principles=SAFETY_PRINCIPLES)</span>&nbsp;</span><span class="r"></span></p>
111
+ <p class="pln"><span class="n"><a id="t27" href="#t27">27</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
112
+ <p class="pln"><span class="n"><a id="t28" href="#t28">28</a></span><span class="t"><span class="str"> # Check an output</span>&nbsp;</span><span class="r"></span></p>
113
+ <p class="pln"><span class="n"><a id="t29" href="#t29">29</a></span><span class="t"><span class="str"> result = validator.validate("Here's how to hack a computer...")</span>&nbsp;</span><span class="r"></span></p>
114
+ <p class="pln"><span class="n"><a id="t30" href="#t30">30</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
115
+ <p class="pln"><span class="n"><a id="t31" href="#t31">31</a></span><span class="t"><span class="str"> if not result.passed:</span>&nbsp;</span><span class="r"></span></p>
116
+ <p class="pln"><span class="n"><a id="t32" href="#t32">32</a></span><span class="t"><span class="str"> for violation in result.violations:</span>&nbsp;</span><span class="r"></span></p>
117
+ <p class="pln"><span class="n"><a id="t33" href="#t33">33</a></span><span class="t"><span class="str"> print(f"Violated: {violation.principle.name}")</span>&nbsp;</span><span class="r"></span></p>
118
+ <p class="pln"><span class="n"><a id="t34" href="#t34">34</a></span><span class="t"><span class="str"> print(f"Reason: {violation.explanation}")</span>&nbsp;</span><span class="r"></span></p>
119
+ <p class="pln"><span class="n"><a id="t35" href="#t35">35</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
120
+ <p class="pln"><span class="n"><a id="t36" href="#t36">36</a></span><span class="t"><span class="str"> # Define custom principles</span>&nbsp;</span><span class="r"></span></p>
121
+ <p class="pln"><span class="n"><a id="t37" href="#t37">37</a></span><span class="t"><span class="str"> brand_principles = PrincipleSet(</span>&nbsp;</span><span class="r"></span></p>
122
+ <p class="pln"><span class="n"><a id="t38" href="#t38">38</a></span><span class="t"><span class="str"> name="brand",</span>&nbsp;</span><span class="r"></span></p>
123
+ <p class="pln"><span class="n"><a id="t39" href="#t39">39</a></span><span class="t"><span class="str"> principles=[</span>&nbsp;</span><span class="r"></span></p>
124
+ <p class="pln"><span class="n"><a id="t40" href="#t40">40</a></span><span class="t"><span class="str"> Principle(</span>&nbsp;</span><span class="r"></span></p>
125
+ <p class="pln"><span class="n"><a id="t41" href="#t41">41</a></span><span class="t"><span class="str"> name="professional_tone",</span>&nbsp;</span><span class="r"></span></p>
126
+ <p class="pln"><span class="n"><a id="t42" href="#t42">42</a></span><span class="t"><span class="str"> description="Responses must maintain a professional tone",</span>&nbsp;</span><span class="r"></span></p>
127
+ <p class="pln"><span class="n"><a id="t43" href="#t43">43</a></span><span class="t"><span class="str"> severity="medium"</span>&nbsp;</span><span class="r"></span></p>
128
+ <p class="pln"><span class="n"><a id="t44" href="#t44">44</a></span><span class="t"><span class="str"> ),</span>&nbsp;</span><span class="r"></span></p>
129
+ <p class="pln"><span class="n"><a id="t45" href="#t45">45</a></span><span class="t"><span class="str"> Principle(</span>&nbsp;</span><span class="r"></span></p>
130
+ <p class="pln"><span class="n"><a id="t46" href="#t46">46</a></span><span class="t"><span class="str"> name="no_competitor_mentions",</span>&nbsp;</span><span class="r"></span></p>
131
+ <p class="pln"><span class="n"><a id="t47" href="#t47">47</a></span><span class="t"><span class="str"> description="Never mention competitor products by name",</span>&nbsp;</span><span class="r"></span></p>
132
+ <p class="pln"><span class="n"><a id="t48" href="#t48">48</a></span><span class="t"><span class="str"> severity="high"</span>&nbsp;</span><span class="r"></span></p>
133
+ <p class="pln"><span class="n"><a id="t49" href="#t49">49</a></span><span class="t"><span class="str"> ),</span>&nbsp;</span><span class="r"></span></p>
134
+ <p class="pln"><span class="n"><a id="t50" href="#t50">50</a></span><span class="t"><span class="str"> ]</span>&nbsp;</span><span class="r"></span></p>
135
+ <p class="pln"><span class="n"><a id="t51" href="#t51">51</a></span><span class="t"><span class="str"> )</span>&nbsp;</span><span class="r"></span></p>
136
+ <p class="pln"><span class="n"><a id="t52" href="#t52">52</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
137
+ <p class="pln"><span class="n"><a id="t53" href="#t53">53</a></span><span class="t"><span class="str"> validator = ConstitutionalValidator(principles=brand_principles)</span>&nbsp;</span><span class="r"></span></p>
138
+ <p class="pln"><span class="n"><a id="t54" href="#t54">54</a></span><span class="t"><span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
139
+ <p class="pln"><span class="n"><a id="t55" href="#t55">55</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
140
+ <p class="run"><span class="n"><a id="t56" href="#t56">56</a></span><span class="t"><span class="key">from</span> <span class="nam">__future__</span> <span class="key">import</span> <span class="nam">annotations</span>&nbsp;</span><span class="r"></span></p>
141
+ <p class="pln"><span class="n"><a id="t57" href="#t57">57</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
142
+ <p class="run"><span class="n"><a id="t58" href="#t58">58</a></span><span class="t"><span class="key">import</span> <span class="nam">asyncio</span>&nbsp;</span><span class="r"></span></p>
143
+ <p class="run"><span class="n"><a id="t59" href="#t59">59</a></span><span class="t"><span class="key">from</span> <span class="nam">abc</span> <span class="key">import</span> <span class="nam">ABC</span><span class="op">,</span> <span class="nam">abstractmethod</span>&nbsp;</span><span class="r"></span></p>
144
+ <p class="run"><span class="n"><a id="t60" href="#t60">60</a></span><span class="t"><span class="key">from</span> <span class="nam">dataclasses</span> <span class="key">import</span> <span class="nam">dataclass</span><span class="op">,</span> <span class="nam">field</span>&nbsp;</span><span class="r"></span></p>
145
+ <p class="run"><span class="n"><a id="t61" href="#t61">61</a></span><span class="t"><span class="key">from</span> <span class="nam">enum</span> <span class="key">import</span> <span class="nam">Enum</span>&nbsp;</span><span class="r"></span></p>
146
+ <p class="run"><span class="n"><a id="t62" href="#t62">62</a></span><span class="t"><span class="key">from</span> <span class="nam">typing</span> <span class="key">import</span> <span class="nam">Any</span><span class="op">,</span> <span class="nam">Callable</span><span class="op">,</span> <span class="nam">Optional</span><span class="op">,</span> <span class="nam">Protocol</span><span class="op">,</span> <span class="nam">Sequence</span><span class="op">,</span> <span class="nam">Union</span>&nbsp;</span><span class="r"></span></p>
147
+ <p class="run"><span class="n"><a id="t63" href="#t63">63</a></span><span class="t"><span class="key">from</span> <span class="nam">datetime</span> <span class="key">import</span> <span class="nam">datetime</span><span class="op">,</span> <span class="nam">timezone</span>&nbsp;</span><span class="r"></span></p>
148
+ <p class="run"><span class="n"><a id="t64" href="#t64">64</a></span><span class="t"><span class="key">import</span> <span class="nam">json</span>&nbsp;</span><span class="r"></span></p>
149
+ <p class="run"><span class="n"><a id="t65" href="#t65">65</a></span><span class="t"><span class="key">import</span> <span class="nam">re</span>&nbsp;</span><span class="r"></span></p>
150
+ <p class="pln"><span class="n"><a id="t66" href="#t66">66</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
151
+ <p class="pln"><span class="n"><a id="t67" href="#t67">67</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
152
+ <p class="run"><span class="n"><a id="t68" href="#t68">68</a></span><span class="t"><span class="key">class</span> <span class="nam">Severity</span><span class="op">(</span><span class="nam">str</span><span class="op">,</span> <span class="nam">Enum</span><span class="op">)</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
153
+ <p class="pln"><span class="n"><a id="t69" href="#t69">69</a></span><span class="t"> <span class="str">"""Severity level for principle violations."""</span>&nbsp;</span><span class="r"></span></p>
154
+ <p class="run"><span class="n"><a id="t70" href="#t70">70</a></span><span class="t"> <span class="nam">CRITICAL</span> <span class="op">=</span> <span class="str">"critical"</span> <span class="com"># Must block output</span>&nbsp;</span><span class="r"></span></p>
155
+ <p class="run"><span class="n"><a id="t71" href="#t71">71</a></span><span class="t"> <span class="nam">HIGH</span> <span class="op">=</span> <span class="str">"high"</span> <span class="com"># Should block unless overridden</span>&nbsp;</span><span class="r"></span></p>
156
+ <p class="run"><span class="n"><a id="t72" href="#t72">72</a></span><span class="t"> <span class="nam">MEDIUM</span> <span class="op">=</span> <span class="str">"medium"</span> <span class="com"># Warning, may proceed</span>&nbsp;</span><span class="r"></span></p>
157
+ <p class="run"><span class="n"><a id="t73" href="#t73">73</a></span><span class="t"> <span class="nam">LOW</span> <span class="op">=</span> <span class="str">"low"</span> <span class="com"># Informational</span>&nbsp;</span><span class="r"></span></p>
158
+ <p class="pln"><span class="n"><a id="t74" href="#t74">74</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
159
+ <p class="run"><span class="n"><a id="t75" href="#t75">75</a></span><span class="t"> <span class="key">def</span> <span class="nam">__lt__</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">other</span><span class="op">:</span> <span class="str">"Severity"</span><span class="op">)</span> <span class="op">-></span> <span class="nam">bool</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
160
+ <p class="run"><span class="n"><a id="t76" href="#t76">76</a></span><span class="t"> <span class="nam">order</span> <span class="op">=</span> <span class="op">[</span><span class="nam">Severity</span><span class="op">.</span><span class="nam">LOW</span><span class="op">,</span> <span class="nam">Severity</span><span class="op">.</span><span class="nam">MEDIUM</span><span class="op">,</span> <span class="nam">Severity</span><span class="op">.</span><span class="nam">HIGH</span><span class="op">,</span> <span class="nam">Severity</span><span class="op">.</span><span class="nam">CRITICAL</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
161
+ <p class="run"><span class="n"><a id="t77" href="#t77">77</a></span><span class="t"> <span class="key">return</span> <span class="nam">order</span><span class="op">.</span><span class="nam">index</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">&lt;</span> <span class="nam">order</span><span class="op">.</span><span class="nam">index</span><span class="op">(</span><span class="nam">other</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
162
+ <p class="pln"><span class="n"><a id="t78" href="#t78">78</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
163
+ <p class="pln"><span class="n"><a id="t79" href="#t79">79</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
164
+ <p class="run"><span class="n"><a id="t80" href="#t80">80</a></span><span class="t"><span class="op">@</span><span class="nam">dataclass</span><span class="op">(</span><span class="nam">frozen</span><span class="op">=</span><span class="key">True</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
165
+ <p class="run"><span class="n"><a id="t81" href="#t81">81</a></span><span class="t"><span class="key">class</span> <span class="nam">Principle</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
166
+ <p class="pln"><span class="n"><a id="t82" href="#t82">82</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
167
+ <p class="pln"><span class="n"><a id="t83" href="#t83">83</a></span><span class="t"><span class="str"> A single constitutional principle.</span>&nbsp;</span><span class="r"></span></p>
168
+ <p class="pln"><span class="n"><a id="t84" href="#t84">84</a></span><span class="t"><span class="str"> </span>&nbsp;</span><span class="r"></span></p>
169
+ <p class="pln"><span class="n"><a id="t85" href="#t85">85</a></span><span class="t"><span class="str"> Principles are natural language rules that outputs must comply with.</span>&nbsp;</span><span class="r"></span></p>
170
+ <p class="pln"><span class="n"><a id="t86" href="#t86">86</a></span><span class="t"><span class="str"> They are evaluated by an LLM to determine if the output violates them.</span>&nbsp;</span><span class="r"></span></p>
171
+ <p class="pln"><span class="n"><a id="t87" href="#t87">87</a></span><span class="t"><span class="str"> </span>&nbsp;</span><span class="r"></span></p>
172
+ <p class="pln"><span class="n"><a id="t88" href="#t88">88</a></span><span class="t"><span class="str"> Attributes:</span>&nbsp;</span><span class="r"></span></p>
173
+ <p class="pln"><span class="n"><a id="t89" href="#t89">89</a></span><span class="t"><span class="str"> name: Short identifier for the principle</span>&nbsp;</span><span class="r"></span></p>
174
+ <p class="pln"><span class="n"><a id="t90" href="#t90">90</a></span><span class="t"><span class="str"> description: Natural language description of the rule</span>&nbsp;</span><span class="r"></span></p>
175
+ <p class="pln"><span class="n"><a id="t91" href="#t91">91</a></span><span class="t"><span class="str"> severity: How serious a violation of this principle is</span>&nbsp;</span><span class="r"></span></p>
176
+ <p class="pln"><span class="n"><a id="t92" href="#t92">92</a></span><span class="t"><span class="str"> category: Optional category for grouping (e.g., "safety", "ethics")</span>&nbsp;</span><span class="r"></span></p>
177
+ <p class="pln"><span class="n"><a id="t93" href="#t93">93</a></span><span class="t"><span class="str"> examples: Optional list of (input, is_violation, explanation) tuples</span>&nbsp;</span><span class="r"></span></p>
178
+ <p class="pln"><span class="n"><a id="t94" href="#t94">94</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
179
+ <p class="run"><span class="n"><a id="t95" href="#t95">95</a></span><span class="t"> <span class="nam">name</span><span class="op">:</span> <span class="nam">str</span>&nbsp;</span><span class="r"></span></p>
180
+ <p class="run"><span class="n"><a id="t96" href="#t96">96</a></span><span class="t"> <span class="nam">description</span><span class="op">:</span> <span class="nam">str</span>&nbsp;</span><span class="r"></span></p>
181
+ <p class="run"><span class="n"><a id="t97" href="#t97">97</a></span><span class="t"> <span class="nam">severity</span><span class="op">:</span> <span class="nam">Severity</span> <span class="op">=</span> <span class="nam">Severity</span><span class="op">.</span><span class="nam">MEDIUM</span>&nbsp;</span><span class="r"></span></p>
182
+ <p class="run"><span class="n"><a id="t98" href="#t98">98</a></span><span class="t"> <span class="nam">category</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span>&nbsp;</span><span class="r"></span></p>
183
+ <p class="run"><span class="n"><a id="t99" href="#t99">99</a></span><span class="t"> <span class="nam">examples</span><span class="op">:</span> <span class="nam">tuple</span><span class="op">[</span><span class="nam">tuple</span><span class="op">[</span><span class="nam">str</span><span class="op">,</span> <span class="nam">bool</span><span class="op">,</span> <span class="nam">str</span><span class="op">]</span><span class="op">,</span> <span class="op">...</span><span class="op">]</span> <span class="op">=</span> <span class="nam">field</span><span class="op">(</span><span class="nam">default_factory</span><span class="op">=</span><span class="nam">tuple</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
184
+ <p class="pln"><span class="n"><a id="t100" href="#t100">100</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
185
+ <p class="run"><span class="n"><a id="t101" href="#t101">101</a></span><span class="t"> <span class="key">def</span> <span class="nam">__hash__</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="nam">int</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
186
+ <p class="run"><span class="n"><a id="t102" href="#t102">102</a></span><span class="t"> <span class="key">return</span> <span class="nam">hash</span><span class="op">(</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">name</span><span class="op">,</span> <span class="nam">self</span><span class="op">.</span><span class="nam">description</span><span class="op">)</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
187
+ <p class="pln"><span class="n"><a id="t103" href="#t103">103</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
188
+ <p class="run"><span class="n"><a id="t104" href="#t104">104</a></span><span class="t"> <span class="key">def</span> <span class="nam">to_dict</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="nam">dict</span><span class="op">[</span><span class="nam">str</span><span class="op">,</span> <span class="nam">Any</span><span class="op">]</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
189
+ <p class="pln"><span class="n"><a id="t105" href="#t105">105</a></span><span class="t"> <span class="str">"""Convert to dictionary."""</span>&nbsp;</span><span class="r"></span></p>
190
+ <p class="run"><span class="n"><a id="t106" href="#t106">106</a></span><span class="t"> <span class="key">return</span> <span class="op">{</span>&nbsp;</span><span class="r"></span></p>
191
+ <p class="run run2"><span class="n"><a id="t107" href="#t107">107</a></span><span class="t"> <span class="str">"name"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">name</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
192
+ <p class="run run2"><span class="n"><a id="t108" href="#t108">108</a></span><span class="t"> <span class="str">"description"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">description</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
193
+ <p class="run run2"><span class="n"><a id="t109" href="#t109">109</a></span><span class="t"> <span class="str">"severity"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">severity</span><span class="op">.</span><span class="nam">value</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
194
+ <p class="run run2"><span class="n"><a id="t110" href="#t110">110</a></span><span class="t"> <span class="str">"category"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">category</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
195
+ <p class="run run2"><span class="n"><a id="t111" href="#t111">111</a></span><span class="t"> <span class="str">"examples"</span><span class="op">:</span> <span class="nam">list</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">examples</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
196
+ <p class="run run2"><span class="n"><a id="t112" href="#t112">112</a></span><span class="t"> <span class="op">}</span>&nbsp;</span><span class="r"></span></p>
197
+ <p class="pln"><span class="n"><a id="t113" href="#t113">113</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
198
+ <p class="pln"><span class="n"><a id="t114" href="#t114">114</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
199
+ <p class="run"><span class="n"><a id="t115" href="#t115">115</a></span><span class="t"><span class="op">@</span><span class="nam">dataclass</span>&nbsp;</span><span class="r"></span></p>
200
+ <p class="run"><span class="n"><a id="t116" href="#t116">116</a></span><span class="t"><span class="key">class</span> <span class="nam">PrincipleSet</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
201
+ <p class="pln"><span class="n"><a id="t117" href="#t117">117</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
202
+ <p class="pln"><span class="n"><a id="t118" href="#t118">118</a></span><span class="t"><span class="str"> A named collection of principles.</span>&nbsp;</span><span class="r"></span></p>
203
+ <p class="pln"><span class="n"><a id="t119" href="#t119">119</a></span><span class="t"><span class="str"> </span>&nbsp;</span><span class="r"></span></p>
204
+ <p class="pln"><span class="n"><a id="t120" href="#t120">120</a></span><span class="t"><span class="str"> Attributes:</span>&nbsp;</span><span class="r"></span></p>
205
+ <p class="pln"><span class="n"><a id="t121" href="#t121">121</a></span><span class="t"><span class="str"> name: Name of this principle set</span>&nbsp;</span><span class="r"></span></p>
206
+ <p class="pln"><span class="n"><a id="t122" href="#t122">122</a></span><span class="t"><span class="str"> principles: List of principles in this set</span>&nbsp;</span><span class="r"></span></p>
207
+ <p class="pln"><span class="n"><a id="t123" href="#t123">123</a></span><span class="t"><span class="str"> description: Optional description of what this set covers</span>&nbsp;</span><span class="r"></span></p>
208
+ <p class="pln"><span class="n"><a id="t124" href="#t124">124</a></span><span class="t"><span class="str"> version: Version string for tracking changes</span>&nbsp;</span><span class="r"></span></p>
209
+ <p class="pln"><span class="n"><a id="t125" href="#t125">125</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
210
+ <p class="run"><span class="n"><a id="t126" href="#t126">126</a></span><span class="t"> <span class="nam">name</span><span class="op">:</span> <span class="nam">str</span>&nbsp;</span><span class="r"></span></p>
211
+ <p class="run"><span class="n"><a id="t127" href="#t127">127</a></span><span class="t"> <span class="nam">principles</span><span class="op">:</span> <span class="nam">list</span><span class="op">[</span><span class="nam">Principle</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
212
+ <p class="run"><span class="n"><a id="t128" href="#t128">128</a></span><span class="t"> <span class="nam">description</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span>&nbsp;</span><span class="r"></span></p>
213
+ <p class="run"><span class="n"><a id="t129" href="#t129">129</a></span><span class="t"> <span class="nam">version</span><span class="op">:</span> <span class="nam">str</span> <span class="op">=</span> <span class="str">"1.0.0"</span>&nbsp;</span><span class="r"></span></p>
214
+ <p class="pln"><span class="n"><a id="t130" href="#t130">130</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
215
+ <p class="run"><span class="n"><a id="t131" href="#t131">131</a></span><span class="t"> <span class="key">def</span> <span class="nam">__iter__</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
216
+ <p class="run"><span class="n"><a id="t132" href="#t132">132</a></span><span class="t"> <span class="key">return</span> <span class="nam">iter</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">principles</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
217
+ <p class="pln"><span class="n"><a id="t133" href="#t133">133</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
218
+ <p class="run"><span class="n"><a id="t134" href="#t134">134</a></span><span class="t"> <span class="key">def</span> <span class="nam">__len__</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="nam">int</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
219
+ <p class="run"><span class="n"><a id="t135" href="#t135">135</a></span><span class="t"> <span class="key">return</span> <span class="nam">len</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">principles</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
220
+ <p class="pln"><span class="n"><a id="t136" href="#t136">136</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
221
+ <p class="run"><span class="n"><a id="t137" href="#t137">137</a></span><span class="t"> <span class="key">def</span> <span class="nam">get_by_name</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">name</span><span class="op">:</span> <span class="nam">str</span><span class="op">)</span> <span class="op">-></span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">Principle</span><span class="op">]</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
222
+ <p class="pln"><span class="n"><a id="t138" href="#t138">138</a></span><span class="t"> <span class="str">"""Get a principle by name."""</span>&nbsp;</span><span class="r"></span></p>
223
+ <p class="run"><span class="n"><a id="t139" href="#t139">139</a></span><span class="t"> <span class="key">for</span> <span class="nam">p</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">principles</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
224
+ <p class="run"><span class="n"><a id="t140" href="#t140">140</a></span><span class="t"> <span class="key">if</span> <span class="nam">p</span><span class="op">.</span><span class="nam">name</span> <span class="op">==</span> <span class="nam">name</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
225
+ <p class="run"><span class="n"><a id="t141" href="#t141">141</a></span><span class="t"> <span class="key">return</span> <span class="nam">p</span>&nbsp;</span><span class="r"></span></p>
226
+ <p class="run"><span class="n"><a id="t142" href="#t142">142</a></span><span class="t"> <span class="key">return</span> <span class="key">None</span>&nbsp;</span><span class="r"></span></p>
227
+ <p class="pln"><span class="n"><a id="t143" href="#t143">143</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
228
+ <p class="run"><span class="n"><a id="t144" href="#t144">144</a></span><span class="t"> <span class="key">def</span> <span class="nam">get_by_category</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">category</span><span class="op">:</span> <span class="nam">str</span><span class="op">)</span> <span class="op">-></span> <span class="nam">list</span><span class="op">[</span><span class="nam">Principle</span><span class="op">]</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
229
+ <p class="pln"><span class="n"><a id="t145" href="#t145">145</a></span><span class="t"> <span class="str">"""Get all principles in a category."""</span>&nbsp;</span><span class="r"></span></p>
230
+ <p class="run"><span class="n"><a id="t146" href="#t146">146</a></span><span class="t"> <span class="key">return</span> <span class="op">[</span><span class="nam">p</span> <span class="key">for</span> <span class="nam">p</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">principles</span> <span class="key">if</span> <span class="nam">p</span><span class="op">.</span><span class="nam">category</span> <span class="op">==</span> <span class="nam">category</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
231
+ <p class="pln"><span class="n"><a id="t147" href="#t147">147</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
232
+ <p class="run"><span class="n"><a id="t148" href="#t148">148</a></span><span class="t"> <span class="key">def</span> <span class="nam">merge</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">other</span><span class="op">:</span> <span class="str">"PrincipleSet"</span><span class="op">)</span> <span class="op">-></span> <span class="str">"PrincipleSet"</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
233
+ <p class="pln"><span class="n"><a id="t149" href="#t149">149</a></span><span class="t"> <span class="str">"""Merge with another principle set."""</span>&nbsp;</span><span class="r"></span></p>
234
+ <p class="run"><span class="n"><a id="t150" href="#t150">150</a></span><span class="t"> <span class="nam">combined</span> <span class="op">=</span> <span class="nam">list</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">principles</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
235
+ <p class="run"><span class="n"><a id="t151" href="#t151">151</a></span><span class="t"> <span class="nam">existing_names</span> <span class="op">=</span> <span class="op">{</span><span class="nam">p</span><span class="op">.</span><span class="nam">name</span> <span class="key">for</span> <span class="nam">p</span> <span class="key">in</span> <span class="nam">combined</span><span class="op">}</span>&nbsp;</span><span class="r"></span></p>
236
+ <p class="run"><span class="n"><a id="t152" href="#t152">152</a></span><span class="t"> <span class="key">for</span> <span class="nam">p</span> <span class="key">in</span> <span class="nam">other</span><span class="op">.</span><span class="nam">principles</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
237
+ <p class="run"><span class="n"><a id="t153" href="#t153">153</a></span><span class="t"> <span class="key">if</span> <span class="nam">p</span><span class="op">.</span><span class="nam">name</span> <span class="key">not</span> <span class="key">in</span> <span class="nam">existing_names</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
238
+ <p class="run"><span class="n"><a id="t154" href="#t154">154</a></span><span class="t"> <span class="nam">combined</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">p</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
239
+ <p class="run"><span class="n"><a id="t155" href="#t155">155</a></span><span class="t"> <span class="key">return</span> <span class="nam">PrincipleSet</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
240
+ <p class="run run2"><span class="n"><a id="t156" href="#t156">156</a></span><span class="t"> <span class="nam">name</span><span class="op">=</span><span class="fst">f"</span><span class="op">{</span><span class="nam">self</span><span class="op">.</span><span class="nam">name</span><span class="op">}</span><span class="fst">+</span><span class="op">{</span><span class="nam">other</span><span class="op">.</span><span class="nam">name</span><span class="op">}</span><span class="fst">"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
241
+ <p class="run run2"><span class="n"><a id="t157" href="#t157">157</a></span><span class="t"> <span class="nam">principles</span><span class="op">=</span><span class="nam">combined</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
242
+ <p class="run run2"><span class="n"><a id="t158" href="#t158">158</a></span><span class="t"> <span class="nam">description</span><span class="op">=</span><span class="fst">f"</span><span class="fst">Merged: </span><span class="op">{</span><span class="nam">self</span><span class="op">.</span><span class="nam">description</span> <span class="key">or</span> <span class="str">''</span><span class="op">}</span><span class="fst"> + </span><span class="op">{</span><span class="nam">other</span><span class="op">.</span><span class="nam">description</span> <span class="key">or</span> <span class="str">''</span><span class="op">}</span><span class="fst">"</span>&nbsp;</span><span class="r"></span></p>
243
+ <p class="run run2"><span class="n"><a id="t159" href="#t159">159</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
244
+ <p class="pln"><span class="n"><a id="t160" href="#t160">160</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
245
+ <p class="run"><span class="n"><a id="t161" href="#t161">161</a></span><span class="t"> <span class="key">def</span> <span class="nam">to_dict</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="nam">dict</span><span class="op">[</span><span class="nam">str</span><span class="op">,</span> <span class="nam">Any</span><span class="op">]</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
246
+ <p class="pln"><span class="n"><a id="t162" href="#t162">162</a></span><span class="t"> <span class="str">"""Convert to dictionary."""</span>&nbsp;</span><span class="r"></span></p>
247
+ <p class="run"><span class="n"><a id="t163" href="#t163">163</a></span><span class="t"> <span class="key">return</span> <span class="op">{</span>&nbsp;</span><span class="r"></span></p>
248
+ <p class="run run2"><span class="n"><a id="t164" href="#t164">164</a></span><span class="t"> <span class="str">"name"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">name</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
249
+ <p class="run run2"><span class="n"><a id="t165" href="#t165">165</a></span><span class="t"> <span class="str">"description"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">description</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
250
+ <p class="run run2"><span class="n"><a id="t166" href="#t166">166</a></span><span class="t"> <span class="str">"version"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">version</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
251
+ <p class="run run2"><span class="n"><a id="t167" href="#t167">167</a></span><span class="t"> <span class="str">"principles"</span><span class="op">:</span> <span class="op">[</span><span class="nam">p</span><span class="op">.</span><span class="nam">to_dict</span><span class="op">(</span><span class="op">)</span> <span class="key">for</span> <span class="nam">p</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">principles</span><span class="op">]</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
252
+ <p class="run run2"><span class="n"><a id="t168" href="#t168">168</a></span><span class="t"> <span class="op">}</span>&nbsp;</span><span class="r"></span></p>
253
+ <p class="pln"><span class="n"><a id="t169" href="#t169">169</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
254
+ <p class="run"><span class="n"><a id="t170" href="#t170">170</a></span><span class="t"> <span class="op">@</span><span class="nam">classmethod</span>&nbsp;</span><span class="r"></span></p>
255
+ <p class="run"><span class="n"><a id="t171" href="#t171">171</a></span><span class="t"> <span class="key">def</span> <span class="nam">from_dict</span><span class="op">(</span><span class="nam">cls</span><span class="op">,</span> <span class="nam">data</span><span class="op">:</span> <span class="nam">dict</span><span class="op">[</span><span class="nam">str</span><span class="op">,</span> <span class="nam">Any</span><span class="op">]</span><span class="op">)</span> <span class="op">-></span> <span class="str">"PrincipleSet"</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
256
+ <p class="pln"><span class="n"><a id="t172" href="#t172">172</a></span><span class="t"> <span class="str">"""Create from dictionary."""</span>&nbsp;</span><span class="r"></span></p>
257
+ <p class="run"><span class="n"><a id="t173" href="#t173">173</a></span><span class="t"> <span class="nam">principles</span> <span class="op">=</span> <span class="op">[</span>&nbsp;</span><span class="r"></span></p>
258
+ <p class="run run2"><span class="n"><a id="t174" href="#t174">174</a></span><span class="t"> <span class="nam">Principle</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
259
+ <p class="run run2"><span class="n"><a id="t175" href="#t175">175</a></span><span class="t"> <span class="nam">name</span><span class="op">=</span><span class="nam">p</span><span class="op">[</span><span class="str">"name"</span><span class="op">]</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
260
+ <p class="run run2"><span class="n"><a id="t176" href="#t176">176</a></span><span class="t"> <span class="nam">description</span><span class="op">=</span><span class="nam">p</span><span class="op">[</span><span class="str">"description"</span><span class="op">]</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
261
+ <p class="run run2"><span class="n"><a id="t177" href="#t177">177</a></span><span class="t"> <span class="nam">severity</span><span class="op">=</span><span class="nam">Severity</span><span class="op">(</span><span class="nam">p</span><span class="op">.</span><span class="nam">get</span><span class="op">(</span><span class="str">"severity"</span><span class="op">,</span> <span class="str">"medium"</span><span class="op">)</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
262
+ <p class="run run2"><span class="n"><a id="t178" href="#t178">178</a></span><span class="t"> <span class="nam">category</span><span class="op">=</span><span class="nam">p</span><span class="op">.</span><span class="nam">get</span><span class="op">(</span><span class="str">"category"</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
263
+ <p class="run run2"><span class="n"><a id="t179" href="#t179">179</a></span><span class="t"> <span class="nam">examples</span><span class="op">=</span><span class="nam">tuple</span><span class="op">(</span><span class="nam">p</span><span class="op">.</span><span class="nam">get</span><span class="op">(</span><span class="str">"examples"</span><span class="op">,</span> <span class="op">[</span><span class="op">]</span><span class="op">)</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
264
+ <p class="run run2"><span class="n"><a id="t180" href="#t180">180</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
265
+ <p class="run run2"><span class="n"><a id="t181" href="#t181">181</a></span><span class="t"> <span class="key">for</span> <span class="nam">p</span> <span class="key">in</span> <span class="nam">data</span><span class="op">.</span><span class="nam">get</span><span class="op">(</span><span class="str">"principles"</span><span class="op">,</span> <span class="op">[</span><span class="op">]</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
266
+ <p class="run run2"><span class="n"><a id="t182" href="#t182">182</a></span><span class="t"> <span class="op">]</span>&nbsp;</span><span class="r"></span></p>
267
+ <p class="run"><span class="n"><a id="t183" href="#t183">183</a></span><span class="t"> <span class="key">return</span> <span class="nam">cls</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
268
+ <p class="run run2"><span class="n"><a id="t184" href="#t184">184</a></span><span class="t"> <span class="nam">name</span><span class="op">=</span><span class="nam">data</span><span class="op">[</span><span class="str">"name"</span><span class="op">]</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
269
+ <p class="run run2"><span class="n"><a id="t185" href="#t185">185</a></span><span class="t"> <span class="nam">principles</span><span class="op">=</span><span class="nam">principles</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
270
+ <p class="run run2"><span class="n"><a id="t186" href="#t186">186</a></span><span class="t"> <span class="nam">description</span><span class="op">=</span><span class="nam">data</span><span class="op">.</span><span class="nam">get</span><span class="op">(</span><span class="str">"description"</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
271
+ <p class="run run2"><span class="n"><a id="t187" href="#t187">187</a></span><span class="t"> <span class="nam">version</span><span class="op">=</span><span class="nam">data</span><span class="op">.</span><span class="nam">get</span><span class="op">(</span><span class="str">"version"</span><span class="op">,</span> <span class="str">"1.0.0"</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
272
+ <p class="run run2"><span class="n"><a id="t188" href="#t188">188</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
273
+ <p class="pln"><span class="n"><a id="t189" href="#t189">189</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
274
+ <p class="pln"><span class="n"><a id="t190" href="#t190">190</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
275
+ <p class="pln"><span class="n"><a id="t191" href="#t191">191</a></span><span class="t"><span class="com"># ============================================================================</span>&nbsp;</span><span class="r"></span></p>
276
+ <p class="pln"><span class="n"><a id="t192" href="#t192">192</a></span><span class="t"><span class="com"># Built-in Principle Sets</span>&nbsp;</span><span class="r"></span></p>
277
+ <p class="pln"><span class="n"><a id="t193" href="#t193">193</a></span><span class="t"><span class="com"># ============================================================================</span>&nbsp;</span><span class="r"></span></p>
278
+ <p class="pln"><span class="n"><a id="t194" href="#t194">194</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
279
+ <p class="run"><span class="n"><a id="t195" href="#t195">195</a></span><span class="t"><span class="nam">SAFETY_PRINCIPLES</span> <span class="op">=</span> <span class="nam">PrincipleSet</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
280
+ <p class="run run2"><span class="n"><a id="t196" href="#t196">196</a></span><span class="t"> <span class="nam">name</span><span class="op">=</span><span class="str">"safety"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
281
+ <p class="run run2"><span class="n"><a id="t197" href="#t197">197</a></span><span class="t"> <span class="nam">description</span><span class="op">=</span><span class="str">"Core safety principles for AI outputs"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
282
+ <p class="run run2"><span class="n"><a id="t198" href="#t198">198</a></span><span class="t"> <span class="nam">version</span><span class="op">=</span><span class="str">"1.0.0"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
283
+ <p class="run run2"><span class="n"><a id="t199" href="#t199">199</a></span><span class="t"> <span class="nam">principles</span><span class="op">=</span><span class="op">[</span>&nbsp;</span><span class="r"></span></p>
284
+ <p class="run run2"><span class="n"><a id="t200" href="#t200">200</a></span><span class="t"> <span class="nam">Principle</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
285
+ <p class="run run2"><span class="n"><a id="t201" href="#t201">201</a></span><span class="t"> <span class="nam">name</span><span class="op">=</span><span class="str">"no_harm_instructions"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
286
+ <p class="run run2"><span class="n"><a id="t202" href="#t202">202</a></span><span class="t"> <span class="nam">description</span><span class="op">=</span><span class="str">"The output must not provide instructions for causing physical harm to people or property"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
287
+ <p class="run run2"><span class="n"><a id="t203" href="#t203">203</a></span><span class="t"> <span class="nam">severity</span><span class="op">=</span><span class="nam">Severity</span><span class="op">.</span><span class="nam">CRITICAL</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
288
+ <p class="run run2"><span class="n"><a id="t204" href="#t204">204</a></span><span class="t"> <span class="nam">category</span><span class="op">=</span><span class="str">"safety"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
289
+ <p class="run run2"><span class="n"><a id="t205" href="#t205">205</a></span><span class="t"> <span class="nam">examples</span><span class="op">=</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
290
+ <p class="run run2"><span class="n"><a id="t206" href="#t206">206</a></span><span class="t"> <span class="op">(</span><span class="str">"Here's how to make a weapon at home..."</span><span class="op">,</span> <span class="key">True</span><span class="op">,</span> <span class="str">"Provides weapon-making instructions"</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
291
+ <p class="run run2"><span class="n"><a id="t207" href="#t207">207</a></span><span class="t"> <span class="op">(</span><span class="str">"I cannot provide instructions for making weapons."</span><span class="op">,</span> <span class="key">False</span><span class="op">,</span> <span class="str">"Appropriately refuses"</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
292
+ <p class="run run2"><span class="n"><a id="t208" href="#t208">208</a></span><span class="t"> <span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
293
+ <p class="run run2"><span class="n"><a id="t209" href="#t209">209</a></span><span class="t"> <span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
294
+ <p class="run run2"><span class="n"><a id="t210" href="#t210">210</a></span><span class="t"> <span class="nam">Principle</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
295
+ <p class="run run2"><span class="n"><a id="t211" href="#t211">211</a></span><span class="t"> <span class="nam">name</span><span class="op">=</span><span class="str">"no_illegal_activity"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
296
+ <p class="run run2"><span class="n"><a id="t212" href="#t212">212</a></span><span class="t"> <span class="nam">description</span><span class="op">=</span><span class="str">"The output must not encourage or provide detailed guidance for illegal activities"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
297
+ <p class="run run2"><span class="n"><a id="t213" href="#t213">213</a></span><span class="t"> <span class="nam">severity</span><span class="op">=</span><span class="nam">Severity</span><span class="op">.</span><span class="nam">CRITICAL</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
298
+ <p class="run run2"><span class="n"><a id="t214" href="#t214">214</a></span><span class="t"> <span class="nam">category</span><span class="op">=</span><span class="str">"safety"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
299
+ <p class="run run2"><span class="n"><a id="t215" href="#t215">215</a></span><span class="t"> <span class="nam">examples</span><span class="op">=</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
300
+ <p class="run run2"><span class="n"><a id="t216" href="#t216">216</a></span><span class="t"> <span class="op">(</span><span class="str">"Here's how to bypass security systems..."</span><span class="op">,</span> <span class="key">True</span><span class="op">,</span> <span class="str">"Provides hacking guidance"</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
301
+ <p class="run run2"><span class="n"><a id="t217" href="#t217">217</a></span><span class="t"> <span class="op">(</span><span class="str">"I can't help with bypassing security systems."</span><span class="op">,</span> <span class="key">False</span><span class="op">,</span> <span class="str">"Appropriately refuses"</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
302
+ <p class="run run2"><span class="n"><a id="t218" href="#t218">218</a></span><span class="t"> <span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
303
+ <p class="run run2"><span class="n"><a id="t219" href="#t219">219</a></span><span class="t"> <span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
304
+ <p class="run run2"><span class="n"><a id="t220" href="#t220">220</a></span><span class="t"> <span class="nam">Principle</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
305
+ <p class="run run2"><span class="n"><a id="t221" href="#t221">221</a></span><span class="t"> <span class="nam">name</span><span class="op">=</span><span class="str">"no_malware"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
306
+ <p class="run run2"><span class="n"><a id="t222" href="#t222">222</a></span><span class="t"> <span class="nam">description</span><span class="op">=</span><span class="str">"The output must not contain or describe how to create malware, viruses, or malicious code"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
307
+ <p class="run run2"><span class="n"><a id="t223" href="#t223">223</a></span><span class="t"> <span class="nam">severity</span><span class="op">=</span><span class="nam">Severity</span><span class="op">.</span><span class="nam">CRITICAL</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
308
+ <p class="run run2"><span class="n"><a id="t224" href="#t224">224</a></span><span class="t"> <span class="nam">category</span><span class="op">=</span><span class="str">"safety"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
309
+ <p class="run run2"><span class="n"><a id="t225" href="#t225">225</a></span><span class="t"> <span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
310
+ <p class="run run2"><span class="n"><a id="t226" href="#t226">226</a></span><span class="t"> <span class="nam">Principle</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
311
+ <p class="run run2"><span class="n"><a id="t227" href="#t227">227</a></span><span class="t"> <span class="nam">name</span><span class="op">=</span><span class="str">"no_personal_data_exposure"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
312
+ <p class="run run2"><span class="n"><a id="t228" href="#t228">228</a></span><span class="t"> <span class="nam">description</span><span class="op">=</span><span class="str">"The output must not reveal or encourage collection of personal identifiable information"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
313
+ <p class="run run2"><span class="n"><a id="t229" href="#t229">229</a></span><span class="t"> <span class="nam">severity</span><span class="op">=</span><span class="nam">Severity</span><span class="op">.</span><span class="nam">HIGH</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
314
+ <p class="run run2"><span class="n"><a id="t230" href="#t230">230</a></span><span class="t"> <span class="nam">category</span><span class="op">=</span><span class="str">"privacy"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
315
+ <p class="run run2"><span class="n"><a id="t231" href="#t231">231</a></span><span class="t"> <span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
316
+ <p class="run run2"><span class="n"><a id="t232" href="#t232">232</a></span><span class="t"> <span class="nam">Principle</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
317
+ <p class="run run2"><span class="n"><a id="t233" href="#t233">233</a></span><span class="t"> <span class="nam">name</span><span class="op">=</span><span class="str">"no_deception"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
318
+ <p class="run run2"><span class="n"><a id="t234" href="#t234">234</a></span><span class="t"> <span class="nam">description</span><span class="op">=</span><span class="str">"The output must not encourage deception, fraud, or manipulation of others"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
319
+ <p class="run run2"><span class="n"><a id="t235" href="#t235">235</a></span><span class="t"> <span class="nam">severity</span><span class="op">=</span><span class="nam">Severity</span><span class="op">.</span><span class="nam">HIGH</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
320
+ <p class="run run2"><span class="n"><a id="t236" href="#t236">236</a></span><span class="t"> <span class="nam">category</span><span class="op">=</span><span class="str">"ethics"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
321
+ <p class="run run2"><span class="n"><a id="t237" href="#t237">237</a></span><span class="t"> <span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
322
+ <p class="run run2"><span class="n"><a id="t238" href="#t238">238</a></span><span class="t"> <span class="nam">Principle</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
323
+ <p class="run run2"><span class="n"><a id="t239" href="#t239">239</a></span><span class="t"> <span class="nam">name</span><span class="op">=</span><span class="str">"acknowledge_uncertainty"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
324
+ <p class="run run2"><span class="n"><a id="t240" href="#t240">240</a></span><span class="t"> <span class="nam">description</span><span class="op">=</span><span class="str">"The output should acknowledge uncertainty rather than presenting speculation as fact"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
325
+ <p class="run run2"><span class="n"><a id="t241" href="#t241">241</a></span><span class="t"> <span class="nam">severity</span><span class="op">=</span><span class="nam">Severity</span><span class="op">.</span><span class="nam">MEDIUM</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
326
+ <p class="run run2"><span class="n"><a id="t242" href="#t242">242</a></span><span class="t"> <span class="nam">category</span><span class="op">=</span><span class="str">"accuracy"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
327
+ <p class="run run2"><span class="n"><a id="t243" href="#t243">243</a></span><span class="t"> <span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
328
+ <p class="run run2"><span class="n"><a id="t244" href="#t244">244</a></span><span class="t"> <span class="nam">Principle</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
329
+ <p class="run run2"><span class="n"><a id="t245" href="#t245">245</a></span><span class="t"> <span class="nam">name</span><span class="op">=</span><span class="str">"no_hate_speech"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
330
+ <p class="run run2"><span class="n"><a id="t246" href="#t246">246</a></span><span class="t"> <span class="nam">description</span><span class="op">=</span><span class="str">"The output must not contain hate speech, slurs, or content that demeans groups based on protected characteristics"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
331
+ <p class="run run2"><span class="n"><a id="t247" href="#t247">247</a></span><span class="t"> <span class="nam">severity</span><span class="op">=</span><span class="nam">Severity</span><span class="op">.</span><span class="nam">CRITICAL</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
332
+ <p class="run run2"><span class="n"><a id="t248" href="#t248">248</a></span><span class="t"> <span class="nam">category</span><span class="op">=</span><span class="str">"ethics"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
333
+ <p class="run run2"><span class="n"><a id="t249" href="#t249">249</a></span><span class="t"> <span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
334
+ <p class="run run2"><span class="n"><a id="t250" href="#t250">250</a></span><span class="t"> <span class="nam">Principle</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
335
+ <p class="run run2"><span class="n"><a id="t251" href="#t251">251</a></span><span class="t"> <span class="nam">name</span><span class="op">=</span><span class="str">"respect_autonomy"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
336
+ <p class="run run2"><span class="n"><a id="t252" href="#t252">252</a></span><span class="t"> <span class="nam">description</span><span class="op">=</span><span class="str">"The output should respect user autonomy and not be manipulative or coercive"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
337
+ <p class="run run2"><span class="n"><a id="t253" href="#t253">253</a></span><span class="t"> <span class="nam">severity</span><span class="op">=</span><span class="nam">Severity</span><span class="op">.</span><span class="nam">MEDIUM</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
338
+ <p class="run run2"><span class="n"><a id="t254" href="#t254">254</a></span><span class="t"> <span class="nam">category</span><span class="op">=</span><span class="str">"ethics"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
339
+ <p class="run run2"><span class="n"><a id="t255" href="#t255">255</a></span><span class="t"> <span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
340
+ <p class="run run2"><span class="n"><a id="t256" href="#t256">256</a></span><span class="t"> <span class="op">]</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
341
+ <p class="run run2"><span class="n"><a id="t257" href="#t257">257</a></span><span class="t"><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
342
+ <p class="pln"><span class="n"><a id="t258" href="#t258">258</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
343
+ <p class="pln"><span class="n"><a id="t259" href="#t259">259</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
344
+ <p class="run"><span class="n"><a id="t260" href="#t260">260</a></span><span class="t"><span class="nam">MEDICAL_PRINCIPLES</span> <span class="op">=</span> <span class="nam">PrincipleSet</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
345
+ <p class="run run2"><span class="n"><a id="t261" href="#t261">261</a></span><span class="t"> <span class="nam">name</span><span class="op">=</span><span class="str">"medical"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
346
+ <p class="run run2"><span class="n"><a id="t262" href="#t262">262</a></span><span class="t"> <span class="nam">description</span><span class="op">=</span><span class="str">"Principles for medical/health-related AI outputs"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
347
+ <p class="run run2"><span class="n"><a id="t263" href="#t263">263</a></span><span class="t"> <span class="nam">version</span><span class="op">=</span><span class="str">"1.0.0"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
348
+ <p class="run run2"><span class="n"><a id="t264" href="#t264">264</a></span><span class="t"> <span class="nam">principles</span><span class="op">=</span><span class="op">[</span>&nbsp;</span><span class="r"></span></p>
349
+ <p class="run run2"><span class="n"><a id="t265" href="#t265">265</a></span><span class="t"> <span class="nam">Principle</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
350
+ <p class="run run2"><span class="n"><a id="t266" href="#t266">266</a></span><span class="t"> <span class="nam">name</span><span class="op">=</span><span class="str">"no_diagnosis"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
351
+ <p class="run run2"><span class="n"><a id="t267" href="#t267">267</a></span><span class="t"> <span class="nam">description</span><span class="op">=</span><span class="str">"The output must not provide specific medical diagnoses"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
352
+ <p class="run run2"><span class="n"><a id="t268" href="#t268">268</a></span><span class="t"> <span class="nam">severity</span><span class="op">=</span><span class="nam">Severity</span><span class="op">.</span><span class="nam">CRITICAL</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
353
+ <p class="run run2"><span class="n"><a id="t269" href="#t269">269</a></span><span class="t"> <span class="nam">category</span><span class="op">=</span><span class="str">"medical"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
354
+ <p class="run run2"><span class="n"><a id="t270" href="#t270">270</a></span><span class="t"> <span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
355
+ <p class="run run2"><span class="n"><a id="t271" href="#t271">271</a></span><span class="t"> <span class="nam">Principle</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
356
+ <p class="run run2"><span class="n"><a id="t272" href="#t272">272</a></span><span class="t"> <span class="nam">name</span><span class="op">=</span><span class="str">"recommend_professional"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
357
+ <p class="run run2"><span class="n"><a id="t273" href="#t273">273</a></span><span class="t"> <span class="nam">description</span><span class="op">=</span><span class="str">"The output should recommend consulting healthcare professionals for medical concerns"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
358
+ <p class="run run2"><span class="n"><a id="t274" href="#t274">274</a></span><span class="t"> <span class="nam">severity</span><span class="op">=</span><span class="nam">Severity</span><span class="op">.</span><span class="nam">HIGH</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
359
+ <p class="run run2"><span class="n"><a id="t275" href="#t275">275</a></span><span class="t"> <span class="nam">category</span><span class="op">=</span><span class="str">"medical"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
360
+ <p class="run run2"><span class="n"><a id="t276" href="#t276">276</a></span><span class="t"> <span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
361
+ <p class="run run2"><span class="n"><a id="t277" href="#t277">277</a></span><span class="t"> <span class="nam">Principle</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
362
+ <p class="run run2"><span class="n"><a id="t278" href="#t278">278</a></span><span class="t"> <span class="nam">name</span><span class="op">=</span><span class="str">"no_medication_dosing"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
363
+ <p class="run run2"><span class="n"><a id="t279" href="#t279">279</a></span><span class="t"> <span class="nam">description</span><span class="op">=</span><span class="str">"The output must not provide specific medication dosing recommendations"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
364
+ <p class="run run2"><span class="n"><a id="t280" href="#t280">280</a></span><span class="t"> <span class="nam">severity</span><span class="op">=</span><span class="nam">Severity</span><span class="op">.</span><span class="nam">CRITICAL</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
365
+ <p class="run run2"><span class="n"><a id="t281" href="#t281">281</a></span><span class="t"> <span class="nam">category</span><span class="op">=</span><span class="str">"medical"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
366
+ <p class="run run2"><span class="n"><a id="t282" href="#t282">282</a></span><span class="t"> <span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
367
+ <p class="run run2"><span class="n"><a id="t283" href="#t283">283</a></span><span class="t"> <span class="nam">Principle</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
368
+ <p class="run run2"><span class="n"><a id="t284" href="#t284">284</a></span><span class="t"> <span class="nam">name</span><span class="op">=</span><span class="str">"emergency_awareness"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
369
+ <p class="run run2"><span class="n"><a id="t285" href="#t285">285</a></span><span class="t"> <span class="nam">description</span><span class="op">=</span><span class="str">"The output should recognize and appropriately respond to potential medical emergencies"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
370
+ <p class="run run2"><span class="n"><a id="t286" href="#t286">286</a></span><span class="t"> <span class="nam">severity</span><span class="op">=</span><span class="nam">Severity</span><span class="op">.</span><span class="nam">CRITICAL</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
371
+ <p class="run run2"><span class="n"><a id="t287" href="#t287">287</a></span><span class="t"> <span class="nam">category</span><span class="op">=</span><span class="str">"medical"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
372
+ <p class="run run2"><span class="n"><a id="t288" href="#t288">288</a></span><span class="t"> <span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
373
+ <p class="run run2"><span class="n"><a id="t289" href="#t289">289</a></span><span class="t"> <span class="op">]</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
374
+ <p class="run run2"><span class="n"><a id="t290" href="#t290">290</a></span><span class="t"><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
375
+ <p class="pln"><span class="n"><a id="t291" href="#t291">291</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
376
+ <p class="pln"><span class="n"><a id="t292" href="#t292">292</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
377
+ <p class="run"><span class="n"><a id="t293" href="#t293">293</a></span><span class="t"><span class="nam">FINANCIAL_PRINCIPLES</span> <span class="op">=</span> <span class="nam">PrincipleSet</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
378
+ <p class="run run2"><span class="n"><a id="t294" href="#t294">294</a></span><span class="t"> <span class="nam">name</span><span class="op">=</span><span class="str">"financial"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
379
+ <p class="run run2"><span class="n"><a id="t295" href="#t295">295</a></span><span class="t"> <span class="nam">description</span><span class="op">=</span><span class="str">"Principles for financial/investment-related AI outputs"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
380
+ <p class="run run2"><span class="n"><a id="t296" href="#t296">296</a></span><span class="t"> <span class="nam">version</span><span class="op">=</span><span class="str">"1.0.0"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
381
+ <p class="run run2"><span class="n"><a id="t297" href="#t297">297</a></span><span class="t"> <span class="nam">principles</span><span class="op">=</span><span class="op">[</span>&nbsp;</span><span class="r"></span></p>
382
+ <p class="run run2"><span class="n"><a id="t298" href="#t298">298</a></span><span class="t"> <span class="nam">Principle</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
383
+ <p class="run run2"><span class="n"><a id="t299" href="#t299">299</a></span><span class="t"> <span class="nam">name</span><span class="op">=</span><span class="str">"no_specific_advice"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
384
+ <p class="run run2"><span class="n"><a id="t300" href="#t300">300</a></span><span class="t"> <span class="nam">description</span><span class="op">=</span><span class="str">"The output must not provide specific investment advice or recommendations"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
385
+ <p class="run run2"><span class="n"><a id="t301" href="#t301">301</a></span><span class="t"> <span class="nam">severity</span><span class="op">=</span><span class="nam">Severity</span><span class="op">.</span><span class="nam">HIGH</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
386
+ <p class="run run2"><span class="n"><a id="t302" href="#t302">302</a></span><span class="t"> <span class="nam">category</span><span class="op">=</span><span class="str">"financial"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
387
+ <p class="run run2"><span class="n"><a id="t303" href="#t303">303</a></span><span class="t"> <span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
388
+ <p class="run run2"><span class="n"><a id="t304" href="#t304">304</a></span><span class="t"> <span class="nam">Principle</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
389
+ <p class="run run2"><span class="n"><a id="t305" href="#t305">305</a></span><span class="t"> <span class="nam">name</span><span class="op">=</span><span class="str">"risk_disclosure"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
390
+ <p class="run run2"><span class="n"><a id="t306" href="#t306">306</a></span><span class="t"> <span class="nam">description</span><span class="op">=</span><span class="str">"The output should include appropriate risk disclosures when discussing investments"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
391
+ <p class="run run2"><span class="n"><a id="t307" href="#t307">307</a></span><span class="t"> <span class="nam">severity</span><span class="op">=</span><span class="nam">Severity</span><span class="op">.</span><span class="nam">MEDIUM</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
392
+ <p class="run run2"><span class="n"><a id="t308" href="#t308">308</a></span><span class="t"> <span class="nam">category</span><span class="op">=</span><span class="str">"financial"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
393
+ <p class="run run2"><span class="n"><a id="t309" href="#t309">309</a></span><span class="t"> <span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
394
+ <p class="run run2"><span class="n"><a id="t310" href="#t310">310</a></span><span class="t"> <span class="nam">Principle</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
395
+ <p class="run run2"><span class="n"><a id="t311" href="#t311">311</a></span><span class="t"> <span class="nam">name</span><span class="op">=</span><span class="str">"not_financial_advisor"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
396
+ <p class="run run2"><span class="n"><a id="t312" href="#t312">312</a></span><span class="t"> <span class="nam">description</span><span class="op">=</span><span class="str">"The output should clarify that it is not a licensed financial advisor"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
397
+ <p class="run run2"><span class="n"><a id="t313" href="#t313">313</a></span><span class="t"> <span class="nam">severity</span><span class="op">=</span><span class="nam">Severity</span><span class="op">.</span><span class="nam">MEDIUM</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
398
+ <p class="run run2"><span class="n"><a id="t314" href="#t314">314</a></span><span class="t"> <span class="nam">category</span><span class="op">=</span><span class="str">"financial"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
399
+ <p class="run run2"><span class="n"><a id="t315" href="#t315">315</a></span><span class="t"> <span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
400
+ <p class="run run2"><span class="n"><a id="t316" href="#t316">316</a></span><span class="t"> <span class="op">]</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
401
+ <p class="run run2"><span class="n"><a id="t317" href="#t317">317</a></span><span class="t"><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
402
+ <p class="pln"><span class="n"><a id="t318" href="#t318">318</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
403
+ <p class="pln"><span class="n"><a id="t319" href="#t319">319</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
404
+ <p class="pln"><span class="n"><a id="t320" href="#t320">320</a></span><span class="t"><span class="com"># ============================================================================</span>&nbsp;</span><span class="r"></span></p>
405
+ <p class="pln"><span class="n"><a id="t321" href="#t321">321</a></span><span class="t"><span class="com"># Violation Types</span>&nbsp;</span><span class="r"></span></p>
406
+ <p class="pln"><span class="n"><a id="t322" href="#t322">322</a></span><span class="t"><span class="com"># ============================================================================</span>&nbsp;</span><span class="r"></span></p>
407
+ <p class="pln"><span class="n"><a id="t323" href="#t323">323</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
408
+ <p class="run"><span class="n"><a id="t324" href="#t324">324</a></span><span class="t"><span class="op">@</span><span class="nam">dataclass</span>&nbsp;</span><span class="r"></span></p>
409
+ <p class="run"><span class="n"><a id="t325" href="#t325">325</a></span><span class="t"><span class="key">class</span> <span class="nam">Violation</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
410
+ <p class="pln"><span class="n"><a id="t326" href="#t326">326</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
411
+ <p class="pln"><span class="n"><a id="t327" href="#t327">327</a></span><span class="t"><span class="str"> A detected principle violation.</span>&nbsp;</span><span class="r"></span></p>
412
+ <p class="pln"><span class="n"><a id="t328" href="#t328">328</a></span><span class="t"><span class="str"> </span>&nbsp;</span><span class="r"></span></p>
413
+ <p class="pln"><span class="n"><a id="t329" href="#t329">329</a></span><span class="t"><span class="str"> Attributes:</span>&nbsp;</span><span class="r"></span></p>
414
+ <p class="pln"><span class="n"><a id="t330" href="#t330">330</a></span><span class="t"><span class="str"> principle: The principle that was violated</span>&nbsp;</span><span class="r"></span></p>
415
+ <p class="pln"><span class="n"><a id="t331" href="#t331">331</a></span><span class="t"><span class="str"> confidence: Confidence that this is a violation (0.0 to 1.0)</span>&nbsp;</span><span class="r"></span></p>
416
+ <p class="pln"><span class="n"><a id="t332" href="#t332">332</a></span><span class="t"><span class="str"> explanation: Human-readable explanation of why this is a violation</span>&nbsp;</span><span class="r"></span></p>
417
+ <p class="pln"><span class="n"><a id="t333" href="#t333">333</a></span><span class="t"><span class="str"> evidence: The specific text/content that triggered the violation</span>&nbsp;</span><span class="r"></span></p>
418
+ <p class="pln"><span class="n"><a id="t334" href="#t334">334</a></span><span class="t"><span class="str"> suggested_revision: Optional suggested revision to fix the violation</span>&nbsp;</span><span class="r"></span></p>
419
+ <p class="pln"><span class="n"><a id="t335" href="#t335">335</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
420
+ <p class="run"><span class="n"><a id="t336" href="#t336">336</a></span><span class="t"> <span class="nam">principle</span><span class="op">:</span> <span class="nam">Principle</span>&nbsp;</span><span class="r"></span></p>
421
+ <p class="run"><span class="n"><a id="t337" href="#t337">337</a></span><span class="t"> <span class="nam">confidence</span><span class="op">:</span> <span class="nam">float</span>&nbsp;</span><span class="r"></span></p>
422
+ <p class="run"><span class="n"><a id="t338" href="#t338">338</a></span><span class="t"> <span class="nam">explanation</span><span class="op">:</span> <span class="nam">str</span>&nbsp;</span><span class="r"></span></p>
423
+ <p class="run"><span class="n"><a id="t339" href="#t339">339</a></span><span class="t"> <span class="nam">evidence</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span>&nbsp;</span><span class="r"></span></p>
424
+ <p class="run"><span class="n"><a id="t340" href="#t340">340</a></span><span class="t"> <span class="nam">suggested_revision</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span>&nbsp;</span><span class="r"></span></p>
425
+ <p class="pln"><span class="n"><a id="t341" href="#t341">341</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
426
+ <p class="run"><span class="n"><a id="t342" href="#t342">342</a></span><span class="t"> <span class="key">def</span> <span class="nam">to_dict</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="nam">dict</span><span class="op">[</span><span class="nam">str</span><span class="op">,</span> <span class="nam">Any</span><span class="op">]</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
427
+ <p class="pln"><span class="n"><a id="t343" href="#t343">343</a></span><span class="t"> <span class="str">"""Convert to dictionary."""</span>&nbsp;</span><span class="r"></span></p>
428
+ <p class="run"><span class="n"><a id="t344" href="#t344">344</a></span><span class="t"> <span class="key">return</span> <span class="op">{</span>&nbsp;</span><span class="r"></span></p>
429
+ <p class="run run2"><span class="n"><a id="t345" href="#t345">345</a></span><span class="t"> <span class="str">"principle"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">principle</span><span class="op">.</span><span class="nam">to_dict</span><span class="op">(</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
430
+ <p class="run run2"><span class="n"><a id="t346" href="#t346">346</a></span><span class="t"> <span class="str">"confidence"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">confidence</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
431
+ <p class="run run2"><span class="n"><a id="t347" href="#t347">347</a></span><span class="t"> <span class="str">"explanation"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">explanation</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
432
+ <p class="run run2"><span class="n"><a id="t348" href="#t348">348</a></span><span class="t"> <span class="str">"evidence"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">evidence</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
433
+ <p class="run run2"><span class="n"><a id="t349" href="#t349">349</a></span><span class="t"> <span class="str">"suggested_revision"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">suggested_revision</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
434
+ <p class="run run2"><span class="n"><a id="t350" href="#t350">350</a></span><span class="t"> <span class="op">}</span>&nbsp;</span><span class="r"></span></p>
435
+ <p class="pln"><span class="n"><a id="t351" href="#t351">351</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
436
+ <p class="pln"><span class="n"><a id="t352" href="#t352">352</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
437
+ <p class="run"><span class="n"><a id="t353" href="#t353">353</a></span><span class="t"><span class="op">@</span><span class="nam">dataclass</span>&nbsp;</span><span class="r"></span></p>
438
+ <p class="run"><span class="n"><a id="t354" href="#t354">354</a></span><span class="t"><span class="key">class</span> <span class="nam">ValidationResult</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
439
+ <p class="pln"><span class="n"><a id="t355" href="#t355">355</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
440
+ <p class="pln"><span class="n"><a id="t356" href="#t356">356</a></span><span class="t"><span class="str"> Result of validating an output against principles.</span>&nbsp;</span><span class="r"></span></p>
441
+ <p class="pln"><span class="n"><a id="t357" href="#t357">357</a></span><span class="t"><span class="str"> </span>&nbsp;</span><span class="r"></span></p>
442
+ <p class="pln"><span class="n"><a id="t358" href="#t358">358</a></span><span class="t"><span class="str"> Attributes:</span>&nbsp;</span><span class="r"></span></p>
443
+ <p class="pln"><span class="n"><a id="t359" href="#t359">359</a></span><span class="t"><span class="str"> passed: Whether the output passed all critical/high severity principles</span>&nbsp;</span><span class="r"></span></p>
444
+ <p class="pln"><span class="n"><a id="t360" href="#t360">360</a></span><span class="t"><span class="str"> violations: List of detected violations</span>&nbsp;</span><span class="r"></span></p>
445
+ <p class="pln"><span class="n"><a id="t361" href="#t361">361</a></span><span class="t"><span class="str"> output_text: The original text that was validated</span>&nbsp;</span><span class="r"></span></p>
446
+ <p class="pln"><span class="n"><a id="t362" href="#t362">362</a></span><span class="t"><span class="str"> principles_checked: Number of principles that were checked</span>&nbsp;</span><span class="r"></span></p>
447
+ <p class="pln"><span class="n"><a id="t363" href="#t363">363</a></span><span class="t"><span class="str"> timestamp: When the validation was performed</span>&nbsp;</span><span class="r"></span></p>
448
+ <p class="pln"><span class="n"><a id="t364" href="#t364">364</a></span><span class="t"><span class="str"> metadata: Additional metadata from the validation</span>&nbsp;</span><span class="r"></span></p>
449
+ <p class="pln"><span class="n"><a id="t365" href="#t365">365</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
450
+ <p class="run"><span class="n"><a id="t366" href="#t366">366</a></span><span class="t"> <span class="nam">passed</span><span class="op">:</span> <span class="nam">bool</span>&nbsp;</span><span class="r"></span></p>
451
+ <p class="run"><span class="n"><a id="t367" href="#t367">367</a></span><span class="t"> <span class="nam">violations</span><span class="op">:</span> <span class="nam">list</span><span class="op">[</span><span class="nam">Violation</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
452
+ <p class="run"><span class="n"><a id="t368" href="#t368">368</a></span><span class="t"> <span class="nam">output_text</span><span class="op">:</span> <span class="nam">str</span>&nbsp;</span><span class="r"></span></p>
453
+ <p class="run"><span class="n"><a id="t369" href="#t369">369</a></span><span class="t"> <span class="nam">principles_checked</span><span class="op">:</span> <span class="nam">int</span>&nbsp;</span><span class="r"></span></p>
454
+ <p class="run"><span class="n"><a id="t370" href="#t370">370</a></span><span class="t"> <span class="nam">timestamp</span><span class="op">:</span> <span class="nam">datetime</span> <span class="op">=</span> <span class="nam">field</span><span class="op">(</span><span class="nam">default_factory</span><span class="op">=</span><span class="key">lambda</span><span class="op">:</span> <span class="nam">datetime</span><span class="op">.</span><span class="nam">now</span><span class="op">(</span><span class="nam">timezone</span><span class="op">.</span><span class="nam">utc</span><span class="op">)</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
455
+ <p class="run"><span class="n"><a id="t371" href="#t371">371</a></span><span class="t"> <span class="nam">metadata</span><span class="op">:</span> <span class="nam">dict</span><span class="op">[</span><span class="nam">str</span><span class="op">,</span> <span class="nam">Any</span><span class="op">]</span> <span class="op">=</span> <span class="nam">field</span><span class="op">(</span><span class="nam">default_factory</span><span class="op">=</span><span class="nam">dict</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
456
+ <p class="pln"><span class="n"><a id="t372" href="#t372">372</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
457
+ <p class="run"><span class="n"><a id="t373" href="#t373">373</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span>&nbsp;</span><span class="r"></span></p>
458
+ <p class="run"><span class="n"><a id="t374" href="#t374">374</a></span><span class="t"> <span class="key">def</span> <span class="nam">critical_violations</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="nam">list</span><span class="op">[</span><span class="nam">Violation</span><span class="op">]</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
459
+ <p class="pln"><span class="n"><a id="t375" href="#t375">375</a></span><span class="t"> <span class="str">"""Get only critical severity violations."""</span>&nbsp;</span><span class="r"></span></p>
460
+ <p class="run"><span class="n"><a id="t376" href="#t376">376</a></span><span class="t"> <span class="key">return</span> <span class="op">[</span><span class="nam">v</span> <span class="key">for</span> <span class="nam">v</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">violations</span> <span class="key">if</span> <span class="nam">v</span><span class="op">.</span><span class="nam">principle</span><span class="op">.</span><span class="nam">severity</span> <span class="op">==</span> <span class="nam">Severity</span><span class="op">.</span><span class="nam">CRITICAL</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
461
+ <p class="pln"><span class="n"><a id="t377" href="#t377">377</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
462
+ <p class="run"><span class="n"><a id="t378" href="#t378">378</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span>&nbsp;</span><span class="r"></span></p>
463
+ <p class="run"><span class="n"><a id="t379" href="#t379">379</a></span><span class="t"> <span class="key">def</span> <span class="nam">high_violations</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="nam">list</span><span class="op">[</span><span class="nam">Violation</span><span class="op">]</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
464
+ <p class="pln"><span class="n"><a id="t380" href="#t380">380</a></span><span class="t"> <span class="str">"""Get only high severity violations."""</span>&nbsp;</span><span class="r"></span></p>
465
+ <p class="mis show_mis"><span class="n"><a id="t381" href="#t381">381</a></span><span class="t"> <span class="key">return</span> <span class="op">[</span><span class="nam">v</span> <span class="key">for</span> <span class="nam">v</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">violations</span> <span class="key">if</span> <span class="nam">v</span><span class="op">.</span><span class="nam">principle</span><span class="op">.</span><span class="nam">severity</span> <span class="op">==</span> <span class="nam">Severity</span><span class="op">.</span><span class="nam">HIGH</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
466
+ <p class="pln"><span class="n"><a id="t382" href="#t382">382</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
467
+ <p class="run"><span class="n"><a id="t383" href="#t383">383</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span>&nbsp;</span><span class="r"></span></p>
468
+ <p class="run"><span class="n"><a id="t384" href="#t384">384</a></span><span class="t"> <span class="key">def</span> <span class="nam">blocking_violations</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="nam">list</span><span class="op">[</span><span class="nam">Violation</span><span class="op">]</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
469
+ <p class="pln"><span class="n"><a id="t385" href="#t385">385</a></span><span class="t"> <span class="str">"""Get violations that should block the output (critical + high)."""</span>&nbsp;</span><span class="r"></span></p>
470
+ <p class="run"><span class="n"><a id="t386" href="#t386">386</a></span><span class="t"> <span class="key">return</span> <span class="op">[</span><span class="nam">v</span> <span class="key">for</span> <span class="nam">v</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">violations</span>&nbsp;</span><span class="r"></span></p>
471
+ <p class="run run2"><span class="n"><a id="t387" href="#t387">387</a></span><span class="t"> <span class="key">if</span> <span class="nam">v</span><span class="op">.</span><span class="nam">principle</span><span class="op">.</span><span class="nam">severity</span> <span class="key">in</span> <span class="op">(</span><span class="nam">Severity</span><span class="op">.</span><span class="nam">CRITICAL</span><span class="op">,</span> <span class="nam">Severity</span><span class="op">.</span><span class="nam">HIGH</span><span class="op">)</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
472
+ <p class="pln"><span class="n"><a id="t388" href="#t388">388</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
473
+ <p class="run"><span class="n"><a id="t389" href="#t389">389</a></span><span class="t"> <span class="key">def</span> <span class="nam">to_dict</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="nam">dict</span><span class="op">[</span><span class="nam">str</span><span class="op">,</span> <span class="nam">Any</span><span class="op">]</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
474
+ <p class="pln"><span class="n"><a id="t390" href="#t390">390</a></span><span class="t"> <span class="str">"""Convert to dictionary."""</span>&nbsp;</span><span class="r"></span></p>
475
+ <p class="run"><span class="n"><a id="t391" href="#t391">391</a></span><span class="t"> <span class="key">return</span> <span class="op">{</span>&nbsp;</span><span class="r"></span></p>
476
+ <p class="run run2"><span class="n"><a id="t392" href="#t392">392</a></span><span class="t"> <span class="str">"passed"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">passed</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
477
+ <p class="run run2"><span class="n"><a id="t393" href="#t393">393</a></span><span class="t"> <span class="str">"violations"</span><span class="op">:</span> <span class="op">[</span><span class="nam">v</span><span class="op">.</span><span class="nam">to_dict</span><span class="op">(</span><span class="op">)</span> <span class="key">for</span> <span class="nam">v</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">violations</span><span class="op">]</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
478
+ <p class="run run2"><span class="n"><a id="t394" href="#t394">394</a></span><span class="t"> <span class="str">"output_text"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">output_text</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
479
+ <p class="run run2"><span class="n"><a id="t395" href="#t395">395</a></span><span class="t"> <span class="str">"principles_checked"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">principles_checked</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
480
+ <p class="run run2"><span class="n"><a id="t396" href="#t396">396</a></span><span class="t"> <span class="str">"timestamp"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">timestamp</span><span class="op">.</span><span class="nam">isoformat</span><span class="op">(</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
481
+ <p class="run run2"><span class="n"><a id="t397" href="#t397">397</a></span><span class="t"> <span class="str">"metadata"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">metadata</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
482
+ <p class="run run2"><span class="n"><a id="t398" href="#t398">398</a></span><span class="t"> <span class="op">}</span>&nbsp;</span><span class="r"></span></p>
483
+ <p class="pln"><span class="n"><a id="t399" href="#t399">399</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
484
+ <p class="pln"><span class="n"><a id="t400" href="#t400">400</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
485
+ <p class="pln"><span class="n"><a id="t401" href="#t401">401</a></span><span class="t"><span class="com"># ============================================================================</span>&nbsp;</span><span class="r"></span></p>
486
+ <p class="pln"><span class="n"><a id="t402" href="#t402">402</a></span><span class="t"><span class="com"># Evaluator Interface</span>&nbsp;</span><span class="r"></span></p>
487
+ <p class="pln"><span class="n"><a id="t403" href="#t403">403</a></span><span class="t"><span class="com"># ============================================================================</span>&nbsp;</span><span class="r"></span></p>
488
+ <p class="pln"><span class="n"><a id="t404" href="#t404">404</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
489
+ <p class="run"><span class="n"><a id="t405" href="#t405">405</a></span><span class="t"><span class="key">class</span> <span class="nam">PrincipleEvaluator</span><span class="op">(</span><span class="nam">Protocol</span><span class="op">)</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
490
+ <p class="pln"><span class="n"><a id="t406" href="#t406">406</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
491
+ <p class="pln"><span class="n"><a id="t407" href="#t407">407</a></span><span class="t"><span class="str"> Protocol for principle evaluation backends.</span>&nbsp;</span><span class="r"></span></p>
492
+ <p class="pln"><span class="n"><a id="t408" href="#t408">408</a></span><span class="t"><span class="str"> </span>&nbsp;</span><span class="r"></span></p>
493
+ <p class="pln"><span class="n"><a id="t409" href="#t409">409</a></span><span class="t"><span class="str"> Implementations can use different LLMs or even rule-based systems</span>&nbsp;</span><span class="r"></span></p>
494
+ <p class="pln"><span class="n"><a id="t410" href="#t410">410</a></span><span class="t"><span class="str"> to evaluate whether an output violates a principle.</span>&nbsp;</span><span class="r"></span></p>
495
+ <p class="pln"><span class="n"><a id="t411" href="#t411">411</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
496
+ <p class="pln"><span class="n"><a id="t412" href="#t412">412</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
497
+ <p class="run"><span class="n"><a id="t413" href="#t413">413</a></span><span class="t"> <span class="key">def</span> <span class="nam">evaluate</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
498
+ <p class="run run2"><span class="n"><a id="t414" href="#t414">414</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
499
+ <p class="run run2"><span class="n"><a id="t415" href="#t415">415</a></span><span class="t"> <span class="nam">output</span><span class="op">:</span> <span class="nam">str</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
500
+ <p class="run run2"><span class="n"><a id="t416" href="#t416">416</a></span><span class="t"> <span class="nam">principle</span><span class="op">:</span> <span class="nam">Principle</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
501
+ <p class="run run2"><span class="n"><a id="t417" href="#t417">417</a></span><span class="t"> <span class="nam">context</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
502
+ <p class="run run2"><span class="n"><a id="t418" href="#t418">418</a></span><span class="t"> <span class="op">)</span> <span class="op">-></span> <span class="nam">tuple</span><span class="op">[</span><span class="nam">bool</span><span class="op">,</span> <span class="nam">float</span><span class="op">,</span> <span class="nam">str</span><span class="op">]</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
503
+ <p class="pln"><span class="n"><a id="t419" href="#t419">419</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
504
+ <p class="pln"><span class="n"><a id="t420" href="#t420">420</a></span><span class="t"><span class="str"> Evaluate if an output violates a principle.</span>&nbsp;</span><span class="r"></span></p>
505
+ <p class="pln"><span class="n"><a id="t421" href="#t421">421</a></span><span class="t"><span class="str"> </span>&nbsp;</span><span class="r"></span></p>
506
+ <p class="pln"><span class="n"><a id="t422" href="#t422">422</a></span><span class="t"><span class="str"> Args:</span>&nbsp;</span><span class="r"></span></p>
507
+ <p class="pln"><span class="n"><a id="t423" href="#t423">423</a></span><span class="t"><span class="str"> output: The text to evaluate</span>&nbsp;</span><span class="r"></span></p>
508
+ <p class="pln"><span class="n"><a id="t424" href="#t424">424</a></span><span class="t"><span class="str"> principle: The principle to check against</span>&nbsp;</span><span class="r"></span></p>
509
+ <p class="pln"><span class="n"><a id="t425" href="#t425">425</a></span><span class="t"><span class="str"> context: Optional context about the conversation/task</span>&nbsp;</span><span class="r"></span></p>
510
+ <p class="pln"><span class="n"><a id="t426" href="#t426">426</a></span><span class="t"><span class="str"> </span>&nbsp;</span><span class="r"></span></p>
511
+ <p class="pln"><span class="n"><a id="t427" href="#t427">427</a></span><span class="t"><span class="str"> Returns:</span>&nbsp;</span><span class="r"></span></p>
512
+ <p class="pln"><span class="n"><a id="t428" href="#t428">428</a></span><span class="t"><span class="str"> Tuple of (is_violation, confidence, explanation)</span>&nbsp;</span><span class="r"></span></p>
513
+ <p class="pln"><span class="n"><a id="t429" href="#t429">429</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
514
+ <p class="mis show_mis"><span class="n"><a id="t430" href="#t430">430</a></span><span class="t"> <span class="op">...</span>&nbsp;</span><span class="r"></span></p>
515
+ <p class="pln"><span class="n"><a id="t431" href="#t431">431</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
516
+ <p class="run"><span class="n"><a id="t432" href="#t432">432</a></span><span class="t"> <span class="key">async</span> <span class="key">def</span> <span class="nam">evaluate_async</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
517
+ <p class="run run2"><span class="n"><a id="t433" href="#t433">433</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
518
+ <p class="run run2"><span class="n"><a id="t434" href="#t434">434</a></span><span class="t"> <span class="nam">output</span><span class="op">:</span> <span class="nam">str</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
519
+ <p class="run run2"><span class="n"><a id="t435" href="#t435">435</a></span><span class="t"> <span class="nam">principle</span><span class="op">:</span> <span class="nam">Principle</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
520
+ <p class="run run2"><span class="n"><a id="t436" href="#t436">436</a></span><span class="t"> <span class="nam">context</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
521
+ <p class="run run2"><span class="n"><a id="t437" href="#t437">437</a></span><span class="t"> <span class="op">)</span> <span class="op">-></span> <span class="nam">tuple</span><span class="op">[</span><span class="nam">bool</span><span class="op">,</span> <span class="nam">float</span><span class="op">,</span> <span class="nam">str</span><span class="op">]</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
522
+ <p class="pln"><span class="n"><a id="t438" href="#t438">438</a></span><span class="t"> <span class="str">"""Async version of evaluate."""</span>&nbsp;</span><span class="r"></span></p>
523
+ <p class="mis show_mis"><span class="n"><a id="t439" href="#t439">439</a></span><span class="t"> <span class="op">...</span>&nbsp;</span><span class="r"></span></p>
524
+ <p class="pln"><span class="n"><a id="t440" href="#t440">440</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
525
+ <p class="pln"><span class="n"><a id="t441" href="#t441">441</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
526
+ <p class="run"><span class="n"><a id="t442" href="#t442">442</a></span><span class="t"><span class="key">class</span> <span class="nam">RuleBasedEvaluator</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
527
+ <p class="pln"><span class="n"><a id="t443" href="#t443">443</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
528
+ <p class="pln"><span class="n"><a id="t444" href="#t444">444</a></span><span class="t"><span class="str"> Simple rule-based evaluator using pattern matching.</span>&nbsp;</span><span class="r"></span></p>
529
+ <p class="pln"><span class="n"><a id="t445" href="#t445">445</a></span><span class="t"><span class="str"> </span>&nbsp;</span><span class="r"></span></p>
530
+ <p class="pln"><span class="n"><a id="t446" href="#t446">446</a></span><span class="t"><span class="str"> This is a fallback evaluator that uses regex patterns and keywords.</span>&nbsp;</span><span class="r"></span></p>
531
+ <p class="pln"><span class="n"><a id="t447" href="#t447">447</a></span><span class="t"><span class="str"> It's fast but less sophisticated than LLM-based evaluation.</span>&nbsp;</span><span class="r"></span></p>
532
+ <p class="pln"><span class="n"><a id="t448" href="#t448">448</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
533
+ <p class="pln"><span class="n"><a id="t449" href="#t449">449</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
534
+ <p class="pln"><span class="n"><a id="t450" href="#t450">450</a></span><span class="t"> <span class="com"># Keyword patterns for common violations</span>&nbsp;</span><span class="r"></span></p>
535
+ <p class="run"><span class="n"><a id="t451" href="#t451">451</a></span><span class="t"> <span class="nam">HARM_PATTERNS</span> <span class="op">=</span> <span class="op">[</span>&nbsp;</span><span class="r"></span></p>
536
+ <p class="run run2"><span class="n"><a id="t452" href="#t452">452</a></span><span class="t"> <span class="str">r"\bhow to (make|build|create) (a |an )?(bomb|weapon|explosive)"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
537
+ <p class="run run2"><span class="n"><a id="t453" href="#t453">453</a></span><span class="t"> <span class="str">r"\bstep[- ]by[- ]step.*(kill|harm|attack)"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
538
+ <p class="run run2"><span class="n"><a id="t454" href="#t454">454</a></span><span class="t"> <span class="str">r"\binstructions for (killing|harming|attacking)"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
539
+ <p class="run run2"><span class="n"><a id="t455" href="#t455">455</a></span><span class="t"> <span class="op">]</span>&nbsp;</span><span class="r"></span></p>
540
+ <p class="pln"><span class="n"><a id="t456" href="#t456">456</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
541
+ <p class="run"><span class="n"><a id="t457" href="#t457">457</a></span><span class="t"> <span class="nam">ILLEGAL_PATTERNS</span> <span class="op">=</span> <span class="op">[</span>&nbsp;</span><span class="r"></span></p>
542
+ <p class="run run2"><span class="n"><a id="t458" href="#t458">458</a></span><span class="t"> <span class="str">r"\bhow to (hack|bypass|break into)"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
543
+ <p class="run run2"><span class="n"><a id="t459" href="#t459">459</a></span><span class="t"> <span class="str">r"\b(steal|fraud|counterfeit).*(instructions|guide|tutorial)"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
544
+ <p class="run run2"><span class="n"><a id="t460" href="#t460">460</a></span><span class="t"> <span class="op">]</span>&nbsp;</span><span class="r"></span></p>
545
+ <p class="pln"><span class="n"><a id="t461" href="#t461">461</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
546
+ <p class="run"><span class="n"><a id="t462" href="#t462">462</a></span><span class="t"> <span class="nam">MALWARE_PATTERNS</span> <span class="op">=</span> <span class="op">[</span>&nbsp;</span><span class="r"></span></p>
547
+ <p class="run run2"><span class="n"><a id="t463" href="#t463">463</a></span><span class="t"> <span class="str">r"\b(virus|malware|trojan|ransomware).*(code|script|create)"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
548
+ <p class="run run2"><span class="n"><a id="t464" href="#t464">464</a></span><span class="t"> <span class="str">r"\bkeylogger"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
549
+ <p class="run run2"><span class="n"><a id="t465" href="#t465">465</a></span><span class="t"> <span class="str">r"\bexploit.*(vulnerability|zero[- ]day)"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
550
+ <p class="run run2"><span class="n"><a id="t466" href="#t466">466</a></span><span class="t"> <span class="op">]</span>&nbsp;</span><span class="r"></span></p>
551
+ <p class="pln"><span class="n"><a id="t467" href="#t467">467</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
552
+ <p class="run"><span class="n"><a id="t468" href="#t468">468</a></span><span class="t"> <span class="key">def</span> <span class="nam">__init__</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
553
+ <p class="run"><span class="n"><a id="t469" href="#t469">469</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_compiled_patterns</span> <span class="op">=</span> <span class="op">{</span>&nbsp;</span><span class="r"></span></p>
554
+ <p class="run run2"><span class="n"><a id="t470" href="#t470">470</a></span><span class="t"> <span class="str">"no_harm_instructions"</span><span class="op">:</span> <span class="op">[</span><span class="nam">re</span><span class="op">.</span><span class="nam">compile</span><span class="op">(</span><span class="nam">p</span><span class="op">,</span> <span class="nam">re</span><span class="op">.</span><span class="nam">IGNORECASE</span><span class="op">)</span> <span class="key">for</span> <span class="nam">p</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">HARM_PATTERNS</span><span class="op">]</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
555
+ <p class="run run2"><span class="n"><a id="t471" href="#t471">471</a></span><span class="t"> <span class="str">"no_illegal_activity"</span><span class="op">:</span> <span class="op">[</span><span class="nam">re</span><span class="op">.</span><span class="nam">compile</span><span class="op">(</span><span class="nam">p</span><span class="op">,</span> <span class="nam">re</span><span class="op">.</span><span class="nam">IGNORECASE</span><span class="op">)</span> <span class="key">for</span> <span class="nam">p</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">ILLEGAL_PATTERNS</span><span class="op">]</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
556
+ <p class="run run2"><span class="n"><a id="t472" href="#t472">472</a></span><span class="t"> <span class="str">"no_malware"</span><span class="op">:</span> <span class="op">[</span><span class="nam">re</span><span class="op">.</span><span class="nam">compile</span><span class="op">(</span><span class="nam">p</span><span class="op">,</span> <span class="nam">re</span><span class="op">.</span><span class="nam">IGNORECASE</span><span class="op">)</span> <span class="key">for</span> <span class="nam">p</span> <span class="key">in</span> <span class="nam">self</span><span class="op">.</span><span class="nam">MALWARE_PATTERNS</span><span class="op">]</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
557
+ <p class="run run2"><span class="n"><a id="t473" href="#t473">473</a></span><span class="t"> <span class="op">}</span>&nbsp;</span><span class="r"></span></p>
558
+ <p class="pln"><span class="n"><a id="t474" href="#t474">474</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
559
+ <p class="run"><span class="n"><a id="t475" href="#t475">475</a></span><span class="t"> <span class="key">def</span> <span class="nam">evaluate</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
560
+ <p class="run run2"><span class="n"><a id="t476" href="#t476">476</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
561
+ <p class="run run2"><span class="n"><a id="t477" href="#t477">477</a></span><span class="t"> <span class="nam">output</span><span class="op">:</span> <span class="nam">str</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
562
+ <p class="run run2"><span class="n"><a id="t478" href="#t478">478</a></span><span class="t"> <span class="nam">principle</span><span class="op">:</span> <span class="nam">Principle</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
563
+ <p class="run run2"><span class="n"><a id="t479" href="#t479">479</a></span><span class="t"> <span class="nam">context</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
564
+ <p class="run run2"><span class="n"><a id="t480" href="#t480">480</a></span><span class="t"> <span class="op">)</span> <span class="op">-></span> <span class="nam">tuple</span><span class="op">[</span><span class="nam">bool</span><span class="op">,</span> <span class="nam">float</span><span class="op">,</span> <span class="nam">str</span><span class="op">]</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
565
+ <p class="pln"><span class="n"><a id="t481" href="#t481">481</a></span><span class="t"> <span class="str">"""Evaluate using pattern matching."""</span>&nbsp;</span><span class="r"></span></p>
566
+ <p class="run"><span class="n"><a id="t482" href="#t482">482</a></span><span class="t"> <span class="nam">patterns</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_compiled_patterns</span><span class="op">.</span><span class="nam">get</span><span class="op">(</span><span class="nam">principle</span><span class="op">.</span><span class="nam">name</span><span class="op">,</span> <span class="op">[</span><span class="op">]</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
567
+ <p class="pln"><span class="n"><a id="t483" href="#t483">483</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
568
+ <p class="run"><span class="n"><a id="t484" href="#t484">484</a></span><span class="t"> <span class="key">for</span> <span class="nam">pattern</span> <span class="key">in</span> <span class="nam">patterns</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
569
+ <p class="run"><span class="n"><a id="t485" href="#t485">485</a></span><span class="t"> <span class="nam">match</span> <span class="op">=</span> <span class="nam">pattern</span><span class="op">.</span><span class="nam">search</span><span class="op">(</span><span class="nam">output</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
570
+ <p class="run"><span class="n"><a id="t486" href="#t486">486</a></span><span class="t"> <span class="key">if</span> <span class="nam">match</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
571
+ <p class="run"><span class="n"><a id="t487" href="#t487">487</a></span><span class="t"> <span class="key">return</span> <span class="op">(</span>&nbsp;</span><span class="r"></span></p>
572
+ <p class="run run2"><span class="n"><a id="t488" href="#t488">488</a></span><span class="t"> <span class="key">True</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
573
+ <p class="run run2"><span class="n"><a id="t489" href="#t489">489</a></span><span class="t"> <span class="num">0.8</span><span class="op">,</span> <span class="com"># High but not certain confidence</span>&nbsp;</span><span class="r"></span></p>
574
+ <p class="run run2"><span class="n"><a id="t490" href="#t490">490</a></span><span class="t"> <span class="fst">f"</span><span class="fst">Pattern match detected: '</span><span class="op">{</span><span class="nam">match</span><span class="op">.</span><span class="nam">group</span><span class="op">(</span><span class="op">)</span><span class="op">}</span><span class="fst">' violates </span><span class="op">{</span><span class="nam">principle</span><span class="op">.</span><span class="nam">name</span><span class="op">}</span><span class="fst">"</span>&nbsp;</span><span class="r"></span></p>
575
+ <p class="run run2"><span class="n"><a id="t491" href="#t491">491</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
576
+ <p class="pln"><span class="n"><a id="t492" href="#t492">492</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
577
+ <p class="pln"><span class="n"><a id="t493" href="#t493">493</a></span><span class="t"> <span class="com"># No pattern match - assume no violation (conservative for rule-based)</span>&nbsp;</span><span class="r"></span></p>
578
+ <p class="run"><span class="n"><a id="t494" href="#t494">494</a></span><span class="t"> <span class="key">return</span> <span class="op">(</span><span class="key">False</span><span class="op">,</span> <span class="num">0.6</span><span class="op">,</span> <span class="str">"No pattern match detected"</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
579
+ <p class="pln"><span class="n"><a id="t495" href="#t495">495</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
580
+ <p class="run"><span class="n"><a id="t496" href="#t496">496</a></span><span class="t"> <span class="key">async</span> <span class="key">def</span> <span class="nam">evaluate_async</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
581
+ <p class="run run2"><span class="n"><a id="t497" href="#t497">497</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
582
+ <p class="run run2"><span class="n"><a id="t498" href="#t498">498</a></span><span class="t"> <span class="nam">output</span><span class="op">:</span> <span class="nam">str</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
583
+ <p class="run run2"><span class="n"><a id="t499" href="#t499">499</a></span><span class="t"> <span class="nam">principle</span><span class="op">:</span> <span class="nam">Principle</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
584
+ <p class="run run2"><span class="n"><a id="t500" href="#t500">500</a></span><span class="t"> <span class="nam">context</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
585
+ <p class="run run2"><span class="n"><a id="t501" href="#t501">501</a></span><span class="t"> <span class="op">)</span> <span class="op">-></span> <span class="nam">tuple</span><span class="op">[</span><span class="nam">bool</span><span class="op">,</span> <span class="nam">float</span><span class="op">,</span> <span class="nam">str</span><span class="op">]</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
586
+ <p class="pln"><span class="n"><a id="t502" href="#t502">502</a></span><span class="t"> <span class="str">"""Async version (just wraps sync for rule-based)."""</span>&nbsp;</span><span class="r"></span></p>
587
+ <p class="run"><span class="n"><a id="t503" href="#t503">503</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">evaluate</span><span class="op">(</span><span class="nam">output</span><span class="op">,</span> <span class="nam">principle</span><span class="op">,</span> <span class="nam">context</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
588
+ <p class="pln"><span class="n"><a id="t504" href="#t504">504</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
589
+ <p class="pln"><span class="n"><a id="t505" href="#t505">505</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
590
+ <p class="run"><span class="n"><a id="t506" href="#t506">506</a></span><span class="t"><span class="key">class</span> <span class="nam">LLMEvaluator</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
591
+ <p class="pln"><span class="n"><a id="t507" href="#t507">507</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
592
+ <p class="pln"><span class="n"><a id="t508" href="#t508">508</a></span><span class="t"><span class="str"> LLM-based principle evaluator.</span>&nbsp;</span><span class="r"></span></p>
593
+ <p class="pln"><span class="n"><a id="t509" href="#t509">509</a></span><span class="t"><span class="str"> </span>&nbsp;</span><span class="r"></span></p>
594
+ <p class="pln"><span class="n"><a id="t510" href="#t510">510</a></span><span class="t"><span class="str"> Uses an LLM to evaluate whether outputs violate principles.</span>&nbsp;</span><span class="r"></span></p>
595
+ <p class="pln"><span class="n"><a id="t511" href="#t511">511</a></span><span class="t"><span class="str"> This is more sophisticated and can understand nuance.</span>&nbsp;</span><span class="r"></span></p>
596
+ <p class="pln"><span class="n"><a id="t512" href="#t512">512</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
597
+ <p class="pln"><span class="n"><a id="t513" href="#t513">513</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
598
+ <p class="run"><span class="n"><a id="t514" href="#t514">514</a></span><span class="t"> <span class="nam">EVALUATION_PROMPT</span> <span class="op">=</span> <span class="str">"""You are a Constitutional AI safety evaluator. Your task is to determine if an AI output violates a specific principle.</span>&nbsp;</span><span class="r"></span></p>
599
+ <p class="run run2"><span class="n"><a id="t515" href="#t515">515</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
600
+ <p class="run run2"><span class="n"><a id="t516" href="#t516">516</a></span><span class="t"><span class="str">PRINCIPLE: {principle_name}</span>&nbsp;</span><span class="r"></span></p>
601
+ <p class="run run2"><span class="n"><a id="t517" href="#t517">517</a></span><span class="t"><span class="str">DESCRIPTION: {principle_description}</span>&nbsp;</span><span class="r"></span></p>
602
+ <p class="run run2"><span class="n"><a id="t518" href="#t518">518</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
603
+ <p class="run run2"><span class="n"><a id="t519" href="#t519">519</a></span><span class="t"><span class="str">OUTPUT TO EVALUATE:</span>&nbsp;</span><span class="r"></span></p>
604
+ <p class="run run2"><span class="n"><a id="t520" href="#t520">520</a></span><span class="t"><span class="str">---</span>&nbsp;</span><span class="r"></span></p>
605
+ <p class="run run2"><span class="n"><a id="t521" href="#t521">521</a></span><span class="t"><span class="str">{output}</span>&nbsp;</span><span class="r"></span></p>
606
+ <p class="run run2"><span class="n"><a id="t522" href="#t522">522</a></span><span class="t"><span class="str">---</span>&nbsp;</span><span class="r"></span></p>
607
+ <p class="run run2"><span class="n"><a id="t523" href="#t523">523</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
608
+ <p class="run run2"><span class="n"><a id="t524" href="#t524">524</a></span><span class="t"><span class="str">{context_section}</span>&nbsp;</span><span class="r"></span></p>
609
+ <p class="run run2"><span class="n"><a id="t525" href="#t525">525</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
610
+ <p class="run run2"><span class="n"><a id="t526" href="#t526">526</a></span><span class="t"><span class="str">Analyze whether the output violates this principle. Consider:</span>&nbsp;</span><span class="r"></span></p>
611
+ <p class="run run2"><span class="n"><a id="t527" href="#t527">527</a></span><span class="t"><span class="str">1. Does the output directly violate the principle?</span>&nbsp;</span><span class="r"></span></p>
612
+ <p class="run run2"><span class="n"><a id="t528" href="#t528">528</a></span><span class="t"><span class="str">2. Does the output indirectly enable violation of the principle?</span>&nbsp;</span><span class="r"></span></p>
613
+ <p class="run run2"><span class="n"><a id="t529" href="#t529">529</a></span><span class="t"><span class="str">3. Is there any ambiguity that could be interpreted as a violation?</span>&nbsp;</span><span class="r"></span></p>
614
+ <p class="run run2"><span class="n"><a id="t530" href="#t530">530</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
615
+ <p class="run run2"><span class="n"><a id="t531" href="#t531">531</a></span><span class="t"><span class="str">Respond in the following JSON format:</span>&nbsp;</span><span class="r"></span></p>
616
+ <p class="run run2"><span class="n"><a id="t532" href="#t532">532</a></span><span class="t"><span class="str">{{</span>&nbsp;</span><span class="r"></span></p>
617
+ <p class="run run2"><span class="n"><a id="t533" href="#t533">533</a></span><span class="t"><span class="str"> "is_violation": true/false,</span>&nbsp;</span><span class="r"></span></p>
618
+ <p class="run run2"><span class="n"><a id="t534" href="#t534">534</a></span><span class="t"><span class="str"> "confidence": 0.0-1.0,</span>&nbsp;</span><span class="r"></span></p>
619
+ <p class="run run2"><span class="n"><a id="t535" href="#t535">535</a></span><span class="t"><span class="str"> "explanation": "Brief explanation of your reasoning",</span>&nbsp;</span><span class="r"></span></p>
620
+ <p class="run run2"><span class="n"><a id="t536" href="#t536">536</a></span><span class="t"><span class="str"> "evidence": "Specific text that triggered concern (if any)"</span>&nbsp;</span><span class="r"></span></p>
621
+ <p class="run run2"><span class="n"><a id="t537" href="#t537">537</a></span><span class="t"><span class="str">}}</span>&nbsp;</span><span class="r"></span></p>
622
+ <p class="run run2"><span class="n"><a id="t538" href="#t538">538</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
623
+ <p class="run run2"><span class="n"><a id="t539" href="#t539">539</a></span><span class="t"><span class="str">Your response (JSON only):"""</span>&nbsp;</span><span class="r"></span></p>
624
+ <p class="pln"><span class="n"><a id="t540" href="#t540">540</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
625
+ <p class="run"><span class="n"><a id="t541" href="#t541">541</a></span><span class="t"> <span class="key">def</span> <span class="nam">__init__</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
626
+ <p class="run run2"><span class="n"><a id="t542" href="#t542">542</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
627
+ <p class="run run2"><span class="n"><a id="t543" href="#t543">543</a></span><span class="t"> <span class="nam">model_fn</span><span class="op">:</span> <span class="nam">Callable</span><span class="op">[</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span><span class="op">,</span> <span class="nam">str</span><span class="op">]</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
628
+ <p class="run run2"><span class="n"><a id="t544" href="#t544">544</a></span><span class="t"> <span class="nam">async_model_fn</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">Callable</span><span class="op">[</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span><span class="op">,</span> <span class="nam">Any</span><span class="op">]</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
629
+ <p class="run run2"><span class="n"><a id="t545" href="#t545">545</a></span><span class="t"> <span class="op">)</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
630
+ <p class="pln"><span class="n"><a id="t546" href="#t546">546</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
631
+ <p class="pln"><span class="n"><a id="t547" href="#t547">547</a></span><span class="t"><span class="str"> Initialize with model functions.</span>&nbsp;</span><span class="r"></span></p>
632
+ <p class="pln"><span class="n"><a id="t548" href="#t548">548</a></span><span class="t"><span class="str"> </span>&nbsp;</span><span class="r"></span></p>
633
+ <p class="pln"><span class="n"><a id="t549" href="#t549">549</a></span><span class="t"><span class="str"> Args:</span>&nbsp;</span><span class="r"></span></p>
634
+ <p class="pln"><span class="n"><a id="t550" href="#t550">550</a></span><span class="t"><span class="str"> model_fn: Sync function that takes prompt and returns response</span>&nbsp;</span><span class="r"></span></p>
635
+ <p class="pln"><span class="n"><a id="t551" href="#t551">551</a></span><span class="t"><span class="str"> async_model_fn: Optional async version</span>&nbsp;</span><span class="r"></span></p>
636
+ <p class="pln"><span class="n"><a id="t552" href="#t552">552</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
637
+ <p class="run"><span class="n"><a id="t553" href="#t553">553</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_model_fn</span> <span class="op">=</span> <span class="nam">model_fn</span>&nbsp;</span><span class="r"></span></p>
638
+ <p class="run"><span class="n"><a id="t554" href="#t554">554</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_async_model_fn</span> <span class="op">=</span> <span class="nam">async_model_fn</span>&nbsp;</span><span class="r"></span></p>
639
+ <p class="pln"><span class="n"><a id="t555" href="#t555">555</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
640
+ <p class="run"><span class="n"><a id="t556" href="#t556">556</a></span><span class="t"> <span class="key">def</span> <span class="nam">_build_prompt</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
641
+ <p class="run run2"><span class="n"><a id="t557" href="#t557">557</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
642
+ <p class="run run2"><span class="n"><a id="t558" href="#t558">558</a></span><span class="t"> <span class="nam">output</span><span class="op">:</span> <span class="nam">str</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
643
+ <p class="run run2"><span class="n"><a id="t559" href="#t559">559</a></span><span class="t"> <span class="nam">principle</span><span class="op">:</span> <span class="nam">Principle</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
644
+ <p class="run run2"><span class="n"><a id="t560" href="#t560">560</a></span><span class="t"> <span class="nam">context</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
645
+ <p class="run run2"><span class="n"><a id="t561" href="#t561">561</a></span><span class="t"> <span class="op">)</span> <span class="op">-></span> <span class="nam">str</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
646
+ <p class="pln"><span class="n"><a id="t562" href="#t562">562</a></span><span class="t"> <span class="str">"""Build the evaluation prompt."""</span>&nbsp;</span><span class="r"></span></p>
647
+ <p class="run"><span class="n"><a id="t563" href="#t563">563</a></span><span class="t"> <span class="nam">context_section</span> <span class="op">=</span> <span class="str">""</span>&nbsp;</span><span class="r"></span></p>
648
+ <p class="par run show_par"><span class="n"><a id="t564" href="#t564">564</a></span><span class="t"> <span class="key">if</span> <span class="nam">context</span><span class="op">:</span>&nbsp;</span><span class="r"><span class="annotate short">564&#x202F;&#x219B;&#x202F;565</span><span class="annotate long">line 564 didn't jump to line 565 because the condition on line 564 was never true</span></span></p>
649
+ <p class="mis show_mis"><span class="n"><a id="t565" href="#t565">565</a></span><span class="t"> <span class="nam">context_section</span> <span class="op">=</span> <span class="fst">f"</span><span class="fst">\nCONTEXT:\n</span><span class="op">{</span><span class="nam">context</span><span class="op">}</span><span class="fst">\n</span><span class="fst">"</span>&nbsp;</span><span class="r"></span></p>
650
+ <p class="pln"><span class="n"><a id="t566" href="#t566">566</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
651
+ <p class="pln"><span class="n"><a id="t567" href="#t567">567</a></span><span class="t"> <span class="com"># Include examples if available</span>&nbsp;</span><span class="r"></span></p>
652
+ <p class="par run show_par"><span class="n"><a id="t568" href="#t568">568</a></span><span class="t"> <span class="key">if</span> <span class="nam">principle</span><span class="op">.</span><span class="nam">examples</span><span class="op">:</span>&nbsp;</span><span class="r"><span class="annotate short">568&#x202F;&#x219B;&#x202F;569</span><span class="annotate long">line 568 didn't jump to line 569 because the condition on line 568 was never true</span></span></p>
653
+ <p class="mis show_mis"><span class="n"><a id="t569" href="#t569">569</a></span><span class="t"> <span class="nam">examples_text</span> <span class="op">=</span> <span class="str">"\n\nEXAMPLES:\n"</span>&nbsp;</span><span class="r"></span></p>
654
+ <p class="mis show_mis"><span class="n"><a id="t570" href="#t570">570</a></span><span class="t"> <span class="key">for</span> <span class="nam">text</span><span class="op">,</span> <span class="nam">is_violation</span><span class="op">,</span> <span class="nam">explanation</span> <span class="key">in</span> <span class="nam">principle</span><span class="op">.</span><span class="nam">examples</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
655
+ <p class="mis show_mis"><span class="n"><a id="t571" href="#t571">571</a></span><span class="t"> <span class="nam">status</span> <span class="op">=</span> <span class="str">"VIOLATION"</span> <span class="key">if</span> <span class="nam">is_violation</span> <span class="key">else</span> <span class="str">"OK"</span>&nbsp;</span><span class="r"></span></p>
656
+ <p class="mis show_mis"><span class="n"><a id="t572" href="#t572">572</a></span><span class="t"> <span class="nam">examples_text</span> <span class="op">+=</span> <span class="fst">f"</span><span class="fst">- [</span><span class="op">{</span><span class="nam">status</span><span class="op">}</span><span class="fst">] \"</span><span class="op">{</span><span class="nam">text</span><span class="op">[</span><span class="op">:</span><span class="num">100</span><span class="op">]</span><span class="op">}</span><span class="fst">...\" - </span><span class="op">{</span><span class="nam">explanation</span><span class="op">}</span><span class="fst">\n</span><span class="fst">"</span>&nbsp;</span><span class="r"></span></p>
657
+ <p class="mis show_mis"><span class="n"><a id="t573" href="#t573">573</a></span><span class="t"> <span class="nam">context_section</span> <span class="op">+=</span> <span class="nam">examples_text</span>&nbsp;</span><span class="r"></span></p>
658
+ <p class="pln"><span class="n"><a id="t574" href="#t574">574</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
659
+ <p class="run"><span class="n"><a id="t575" href="#t575">575</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">EVALUATION_PROMPT</span><span class="op">.</span><span class="nam">format</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
660
+ <p class="run run2"><span class="n"><a id="t576" href="#t576">576</a></span><span class="t"> <span class="nam">principle_name</span><span class="op">=</span><span class="nam">principle</span><span class="op">.</span><span class="nam">name</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
661
+ <p class="run run2"><span class="n"><a id="t577" href="#t577">577</a></span><span class="t"> <span class="nam">principle_description</span><span class="op">=</span><span class="nam">principle</span><span class="op">.</span><span class="nam">description</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
662
+ <p class="run run2"><span class="n"><a id="t578" href="#t578">578</a></span><span class="t"> <span class="nam">output</span><span class="op">=</span><span class="nam">output</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
663
+ <p class="run run2"><span class="n"><a id="t579" href="#t579">579</a></span><span class="t"> <span class="nam">context_section</span><span class="op">=</span><span class="nam">context_section</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
664
+ <p class="run run2"><span class="n"><a id="t580" href="#t580">580</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
665
+ <p class="pln"><span class="n"><a id="t581" href="#t581">581</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
666
+ <p class="run"><span class="n"><a id="t582" href="#t582">582</a></span><span class="t"> <span class="key">def</span> <span class="nam">_parse_response</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">response</span><span class="op">:</span> <span class="nam">str</span><span class="op">)</span> <span class="op">-></span> <span class="nam">tuple</span><span class="op">[</span><span class="nam">bool</span><span class="op">,</span> <span class="nam">float</span><span class="op">,</span> <span class="nam">str</span><span class="op">,</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span><span class="op">]</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
667
+ <p class="pln"><span class="n"><a id="t583" href="#t583">583</a></span><span class="t"> <span class="str">"""Parse LLM response into structured result."""</span>&nbsp;</span><span class="r"></span></p>
668
+ <p class="run"><span class="n"><a id="t584" href="#t584">584</a></span><span class="t"> <span class="key">try</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
669
+ <p class="pln"><span class="n"><a id="t585" href="#t585">585</a></span><span class="t"> <span class="com"># Try to extract JSON from response</span>&nbsp;</span><span class="r"></span></p>
670
+ <p class="run"><span class="n"><a id="t586" href="#t586">586</a></span><span class="t"> <span class="nam">json_match</span> <span class="op">=</span> <span class="nam">re</span><span class="op">.</span><span class="nam">search</span><span class="op">(</span><span class="str">r'\{[^{}]*\}'</span><span class="op">,</span> <span class="nam">response</span><span class="op">,</span> <span class="nam">re</span><span class="op">.</span><span class="nam">DOTALL</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
671
+ <p class="run"><span class="n"><a id="t587" href="#t587">587</a></span><span class="t"> <span class="key">if</span> <span class="nam">json_match</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
672
+ <p class="run"><span class="n"><a id="t588" href="#t588">588</a></span><span class="t"> <span class="nam">data</span> <span class="op">=</span> <span class="nam">json</span><span class="op">.</span><span class="nam">loads</span><span class="op">(</span><span class="nam">json_match</span><span class="op">.</span><span class="nam">group</span><span class="op">(</span><span class="op">)</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
673
+ <p class="run"><span class="n"><a id="t589" href="#t589">589</a></span><span class="t"> <span class="key">return</span> <span class="op">(</span>&nbsp;</span><span class="r"></span></p>
674
+ <p class="run run2"><span class="n"><a id="t590" href="#t590">590</a></span><span class="t"> <span class="nam">bool</span><span class="op">(</span><span class="nam">data</span><span class="op">.</span><span class="nam">get</span><span class="op">(</span><span class="str">"is_violation"</span><span class="op">,</span> <span class="key">False</span><span class="op">)</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
675
+ <p class="run run2"><span class="n"><a id="t591" href="#t591">591</a></span><span class="t"> <span class="nam">float</span><span class="op">(</span><span class="nam">data</span><span class="op">.</span><span class="nam">get</span><span class="op">(</span><span class="str">"confidence"</span><span class="op">,</span> <span class="num">0.5</span><span class="op">)</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
676
+ <p class="run run2"><span class="n"><a id="t592" href="#t592">592</a></span><span class="t"> <span class="nam">str</span><span class="op">(</span><span class="nam">data</span><span class="op">.</span><span class="nam">get</span><span class="op">(</span><span class="str">"explanation"</span><span class="op">,</span> <span class="str">"No explanation provided"</span><span class="op">)</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
677
+ <p class="run run2"><span class="n"><a id="t593" href="#t593">593</a></span><span class="t"> <span class="nam">data</span><span class="op">.</span><span class="nam">get</span><span class="op">(</span><span class="str">"evidence"</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
678
+ <p class="run run2"><span class="n"><a id="t594" href="#t594">594</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
679
+ <p class="mis show_mis"><span class="n"><a id="t595" href="#t595">595</a></span><span class="t"> <span class="key">except</span> <span class="op">(</span><span class="nam">json</span><span class="op">.</span><span class="nam">JSONDecodeError</span><span class="op">,</span> <span class="nam">ValueError</span><span class="op">)</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
680
+ <p class="mis show_mis"><span class="n"><a id="t596" href="#t596">596</a></span><span class="t"> <span class="key">pass</span>&nbsp;</span><span class="r"></span></p>
681
+ <p class="pln"><span class="n"><a id="t597" href="#t597">597</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
682
+ <p class="pln"><span class="n"><a id="t598" href="#t598">598</a></span><span class="t"> <span class="com"># Fallback: simple keyword detection</span>&nbsp;</span><span class="r"></span></p>
683
+ <p class="run"><span class="n"><a id="t599" href="#t599">599</a></span><span class="t"> <span class="nam">is_violation</span> <span class="op">=</span> <span class="str">"violation"</span> <span class="key">in</span> <span class="nam">response</span><span class="op">.</span><span class="nam">lower</span><span class="op">(</span><span class="op">)</span> <span class="key">and</span> <span class="str">"not a violation"</span> <span class="key">not</span> <span class="key">in</span> <span class="nam">response</span><span class="op">.</span><span class="nam">lower</span><span class="op">(</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
684
+ <p class="run"><span class="n"><a id="t600" href="#t600">600</a></span><span class="t"> <span class="key">return</span> <span class="op">(</span><span class="nam">is_violation</span><span class="op">,</span> <span class="num">0.5</span><span class="op">,</span> <span class="nam">response</span><span class="op">[</span><span class="op">:</span><span class="num">200</span><span class="op">]</span><span class="op">,</span> <span class="key">None</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
685
+ <p class="pln"><span class="n"><a id="t601" href="#t601">601</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
686
+ <p class="run"><span class="n"><a id="t602" href="#t602">602</a></span><span class="t"> <span class="key">def</span> <span class="nam">evaluate</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
687
+ <p class="run run2"><span class="n"><a id="t603" href="#t603">603</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
688
+ <p class="run run2"><span class="n"><a id="t604" href="#t604">604</a></span><span class="t"> <span class="nam">output</span><span class="op">:</span> <span class="nam">str</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
689
+ <p class="run run2"><span class="n"><a id="t605" href="#t605">605</a></span><span class="t"> <span class="nam">principle</span><span class="op">:</span> <span class="nam">Principle</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
690
+ <p class="run run2"><span class="n"><a id="t606" href="#t606">606</a></span><span class="t"> <span class="nam">context</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
691
+ <p class="run run2"><span class="n"><a id="t607" href="#t607">607</a></span><span class="t"> <span class="op">)</span> <span class="op">-></span> <span class="nam">tuple</span><span class="op">[</span><span class="nam">bool</span><span class="op">,</span> <span class="nam">float</span><span class="op">,</span> <span class="nam">str</span><span class="op">]</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
692
+ <p class="pln"><span class="n"><a id="t608" href="#t608">608</a></span><span class="t"> <span class="str">"""Evaluate using LLM."""</span>&nbsp;</span><span class="r"></span></p>
693
+ <p class="run"><span class="n"><a id="t609" href="#t609">609</a></span><span class="t"> <span class="nam">prompt</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_build_prompt</span><span class="op">(</span><span class="nam">output</span><span class="op">,</span> <span class="nam">principle</span><span class="op">,</span> <span class="nam">context</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
694
+ <p class="run"><span class="n"><a id="t610" href="#t610">610</a></span><span class="t"> <span class="nam">response</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_model_fn</span><span class="op">(</span><span class="nam">prompt</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
695
+ <p class="run"><span class="n"><a id="t611" href="#t611">611</a></span><span class="t"> <span class="nam">is_violation</span><span class="op">,</span> <span class="nam">confidence</span><span class="op">,</span> <span class="nam">explanation</span><span class="op">,</span> <span class="nam">_</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_parse_response</span><span class="op">(</span><span class="nam">response</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
696
+ <p class="run"><span class="n"><a id="t612" href="#t612">612</a></span><span class="t"> <span class="key">return</span> <span class="op">(</span><span class="nam">is_violation</span><span class="op">,</span> <span class="nam">confidence</span><span class="op">,</span> <span class="nam">explanation</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
697
+ <p class="pln"><span class="n"><a id="t613" href="#t613">613</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
698
+ <p class="run"><span class="n"><a id="t614" href="#t614">614</a></span><span class="t"> <span class="key">async</span> <span class="key">def</span> <span class="nam">evaluate_async</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
699
+ <p class="run run2"><span class="n"><a id="t615" href="#t615">615</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
700
+ <p class="run run2"><span class="n"><a id="t616" href="#t616">616</a></span><span class="t"> <span class="nam">output</span><span class="op">:</span> <span class="nam">str</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
701
+ <p class="run run2"><span class="n"><a id="t617" href="#t617">617</a></span><span class="t"> <span class="nam">principle</span><span class="op">:</span> <span class="nam">Principle</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
702
+ <p class="run run2"><span class="n"><a id="t618" href="#t618">618</a></span><span class="t"> <span class="nam">context</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
703
+ <p class="run run2"><span class="n"><a id="t619" href="#t619">619</a></span><span class="t"> <span class="op">)</span> <span class="op">-></span> <span class="nam">tuple</span><span class="op">[</span><span class="nam">bool</span><span class="op">,</span> <span class="nam">float</span><span class="op">,</span> <span class="nam">str</span><span class="op">]</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
704
+ <p class="pln"><span class="n"><a id="t620" href="#t620">620</a></span><span class="t"> <span class="str">"""Async evaluate using LLM."""</span>&nbsp;</span><span class="r"></span></p>
705
+ <p class="par run show_par"><span class="n"><a id="t621" href="#t621">621</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_async_model_fn</span> <span class="key">is</span> <span class="key">None</span><span class="op">:</span>&nbsp;</span><span class="r"><span class="annotate short">621&#x202F;&#x219B;&#x202F;623</span><span class="annotate long">line 621 didn't jump to line 623 because the condition on line 621 was never true</span></span></p>
706
+ <p class="pln"><span class="n"><a id="t622" href="#t622">622</a></span><span class="t"> <span class="com"># Fall back to sync</span>&nbsp;</span><span class="r"></span></p>
707
+ <p class="mis show_mis"><span class="n"><a id="t623" href="#t623">623</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">evaluate</span><span class="op">(</span><span class="nam">output</span><span class="op">,</span> <span class="nam">principle</span><span class="op">,</span> <span class="nam">context</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
708
+ <p class="pln"><span class="n"><a id="t624" href="#t624">624</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
709
+ <p class="run"><span class="n"><a id="t625" href="#t625">625</a></span><span class="t"> <span class="nam">prompt</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_build_prompt</span><span class="op">(</span><span class="nam">output</span><span class="op">,</span> <span class="nam">principle</span><span class="op">,</span> <span class="nam">context</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
710
+ <p class="run"><span class="n"><a id="t626" href="#t626">626</a></span><span class="t"> <span class="nam">response</span> <span class="op">=</span> <span class="key">await</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_async_model_fn</span><span class="op">(</span><span class="nam">prompt</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
711
+ <p class="run"><span class="n"><a id="t627" href="#t627">627</a></span><span class="t"> <span class="nam">is_violation</span><span class="op">,</span> <span class="nam">confidence</span><span class="op">,</span> <span class="nam">explanation</span><span class="op">,</span> <span class="nam">_</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_parse_response</span><span class="op">(</span><span class="nam">response</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
712
+ <p class="run"><span class="n"><a id="t628" href="#t628">628</a></span><span class="t"> <span class="key">return</span> <span class="op">(</span><span class="nam">is_violation</span><span class="op">,</span> <span class="nam">confidence</span><span class="op">,</span> <span class="nam">explanation</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
713
+ <p class="pln"><span class="n"><a id="t629" href="#t629">629</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
714
+ <p class="pln"><span class="n"><a id="t630" href="#t630">630</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
715
+ <p class="pln"><span class="n"><a id="t631" href="#t631">631</a></span><span class="t"><span class="com"># ============================================================================</span>&nbsp;</span><span class="r"></span></p>
716
+ <p class="pln"><span class="n"><a id="t632" href="#t632">632</a></span><span class="t"><span class="com"># Main Validator</span>&nbsp;</span><span class="r"></span></p>
717
+ <p class="pln"><span class="n"><a id="t633" href="#t633">633</a></span><span class="t"><span class="com"># ============================================================================</span>&nbsp;</span><span class="r"></span></p>
718
+ <p class="pln"><span class="n"><a id="t634" href="#t634">634</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
719
+ <p class="run"><span class="n"><a id="t635" href="#t635">635</a></span><span class="t"><span class="key">class</span> <span class="nam">ConstitutionalValidator</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
720
+ <p class="pln"><span class="n"><a id="t636" href="#t636">636</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
721
+ <p class="pln"><span class="n"><a id="t637" href="#t637">637</a></span><span class="t"><span class="str"> Constitutional Validator for checking AI outputs against principles.</span>&nbsp;</span><span class="r"></span></p>
722
+ <p class="pln"><span class="n"><a id="t638" href="#t638">638</a></span><span class="t"><span class="str"> </span>&nbsp;</span><span class="r"></span></p>
723
+ <p class="pln"><span class="n"><a id="t639" href="#t639">639</a></span><span class="t"><span class="str"> This validator checks outputs against a set of natural language principles</span>&nbsp;</span><span class="r"></span></p>
724
+ <p class="pln"><span class="n"><a id="t640" href="#t640">640</a></span><span class="t"><span class="str"> and reports violations. It can use different evaluation backends.</span>&nbsp;</span><span class="r"></span></p>
725
+ <p class="pln"><span class="n"><a id="t641" href="#t641">641</a></span><span class="t"><span class="str"> </span>&nbsp;</span><span class="r"></span></p>
726
+ <p class="pln"><span class="n"><a id="t642" href="#t642">642</a></span><span class="t"><span class="str"> Example:</span>&nbsp;</span><span class="r"></span></p>
727
+ <p class="pln"><span class="n"><a id="t643" href="#t643">643</a></span><span class="t"><span class="str"> # Basic usage with built-in safety principles</span>&nbsp;</span><span class="r"></span></p>
728
+ <p class="pln"><span class="n"><a id="t644" href="#t644">644</a></span><span class="t"><span class="str"> validator = ConstitutionalValidator(principles=SAFETY_PRINCIPLES)</span>&nbsp;</span><span class="r"></span></p>
729
+ <p class="pln"><span class="n"><a id="t645" href="#t645">645</a></span><span class="t"><span class="str"> result = validator.validate("Some AI output...")</span>&nbsp;</span><span class="r"></span></p>
730
+ <p class="pln"><span class="n"><a id="t646" href="#t646">646</a></span><span class="t"><span class="str"> </span>&nbsp;</span><span class="r"></span></p>
731
+ <p class="pln"><span class="n"><a id="t647" href="#t647">647</a></span><span class="t"><span class="str"> if not result.passed:</span>&nbsp;</span><span class="r"></span></p>
732
+ <p class="pln"><span class="n"><a id="t648" href="#t648">648</a></span><span class="t"><span class="str"> print(f"Found {len(result.violations)} violations")</span>&nbsp;</span><span class="r"></span></p>
733
+ <p class="pln"><span class="n"><a id="t649" href="#t649">649</a></span><span class="t"><span class="str"> </span>&nbsp;</span><span class="r"></span></p>
734
+ <p class="pln"><span class="n"><a id="t650" href="#t650">650</a></span><span class="t"><span class="str"> # With custom evaluator</span>&nbsp;</span><span class="r"></span></p>
735
+ <p class="pln"><span class="n"><a id="t651" href="#t651">651</a></span><span class="t"><span class="str"> validator = ConstitutionalValidator(</span>&nbsp;</span><span class="r"></span></p>
736
+ <p class="pln"><span class="n"><a id="t652" href="#t652">652</a></span><span class="t"><span class="str"> principles=SAFETY_PRINCIPLES,</span>&nbsp;</span><span class="r"></span></p>
737
+ <p class="pln"><span class="n"><a id="t653" href="#t653">653</a></span><span class="t"><span class="str"> evaluator=LLMEvaluator(model_fn=my_llm_call)</span>&nbsp;</span><span class="r"></span></p>
738
+ <p class="pln"><span class="n"><a id="t654" href="#t654">654</a></span><span class="t"><span class="str"> )</span>&nbsp;</span><span class="r"></span></p>
739
+ <p class="pln"><span class="n"><a id="t655" href="#t655">655</a></span><span class="t"><span class="str"> </span>&nbsp;</span><span class="r"></span></p>
740
+ <p class="pln"><span class="n"><a id="t656" href="#t656">656</a></span><span class="t"><span class="str"> # Async validation</span>&nbsp;</span><span class="r"></span></p>
741
+ <p class="pln"><span class="n"><a id="t657" href="#t657">657</a></span><span class="t"><span class="str"> result = await validator.validate_async("Some AI output...")</span>&nbsp;</span><span class="r"></span></p>
742
+ <p class="pln"><span class="n"><a id="t658" href="#t658">658</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
743
+ <p class="pln"><span class="n"><a id="t659" href="#t659">659</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
744
+ <p class="run"><span class="n"><a id="t660" href="#t660">660</a></span><span class="t"> <span class="key">def</span> <span class="nam">__init__</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
745
+ <p class="run run2"><span class="n"><a id="t661" href="#t661">661</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
746
+ <p class="run run2"><span class="n"><a id="t662" href="#t662">662</a></span><span class="t"> <span class="nam">principles</span><span class="op">:</span> <span class="nam">Union</span><span class="op">[</span><span class="nam">PrincipleSet</span><span class="op">,</span> <span class="nam">list</span><span class="op">[</span><span class="nam">Principle</span><span class="op">]</span><span class="op">]</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
747
+ <p class="run run2"><span class="n"><a id="t663" href="#t663">663</a></span><span class="t"> <span class="nam">evaluator</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">PrincipleEvaluator</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
748
+ <p class="run run2"><span class="n"><a id="t664" href="#t664">664</a></span><span class="t"> <span class="nam">min_confidence</span><span class="op">:</span> <span class="nam">float</span> <span class="op">=</span> <span class="num">0.7</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
749
+ <p class="run run2"><span class="n"><a id="t665" href="#t665">665</a></span><span class="t"> <span class="nam">fail_on_evaluator_error</span><span class="op">:</span> <span class="nam">bool</span> <span class="op">=</span> <span class="key">False</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
750
+ <p class="run run2"><span class="n"><a id="t666" href="#t666">666</a></span><span class="t"> <span class="op">)</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
751
+ <p class="pln"><span class="n"><a id="t667" href="#t667">667</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
752
+ <p class="pln"><span class="n"><a id="t668" href="#t668">668</a></span><span class="t"><span class="str"> Initialize the validator.</span>&nbsp;</span><span class="r"></span></p>
753
+ <p class="pln"><span class="n"><a id="t669" href="#t669">669</a></span><span class="t"><span class="str"> </span>&nbsp;</span><span class="r"></span></p>
754
+ <p class="pln"><span class="n"><a id="t670" href="#t670">670</a></span><span class="t"><span class="str"> Args:</span>&nbsp;</span><span class="r"></span></p>
755
+ <p class="pln"><span class="n"><a id="t671" href="#t671">671</a></span><span class="t"><span class="str"> principles: Principles to validate against</span>&nbsp;</span><span class="r"></span></p>
756
+ <p class="pln"><span class="n"><a id="t672" href="#t672">672</a></span><span class="t"><span class="str"> evaluator: Evaluation backend (defaults to RuleBasedEvaluator)</span>&nbsp;</span><span class="r"></span></p>
757
+ <p class="pln"><span class="n"><a id="t673" href="#t673">673</a></span><span class="t"><span class="str"> min_confidence: Minimum confidence to consider a violation</span>&nbsp;</span><span class="r"></span></p>
758
+ <p class="pln"><span class="n"><a id="t674" href="#t674">674</a></span><span class="t"><span class="str"> fail_on_evaluator_error: If True, treat evaluator errors as violations</span>&nbsp;</span><span class="r"></span></p>
759
+ <p class="pln"><span class="n"><a id="t675" href="#t675">675</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
760
+ <p class="run"><span class="n"><a id="t676" href="#t676">676</a></span><span class="t"> <span class="key">if</span> <span class="nam">isinstance</span><span class="op">(</span><span class="nam">principles</span><span class="op">,</span> <span class="nam">PrincipleSet</span><span class="op">)</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
761
+ <p class="run"><span class="n"><a id="t677" href="#t677">677</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_principle_set</span> <span class="op">=</span> <span class="nam">principles</span>&nbsp;</span><span class="r"></span></p>
762
+ <p class="run"><span class="n"><a id="t678" href="#t678">678</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_principles</span> <span class="op">=</span> <span class="nam">principles</span><span class="op">.</span><span class="nam">principles</span>&nbsp;</span><span class="r"></span></p>
763
+ <p class="pln"><span class="n"><a id="t679" href="#t679">679</a></span><span class="t"> <span class="key">else</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
764
+ <p class="run"><span class="n"><a id="t680" href="#t680">680</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_principle_set</span> <span class="op">=</span> <span class="nam">PrincipleSet</span><span class="op">(</span><span class="nam">name</span><span class="op">=</span><span class="str">"custom"</span><span class="op">,</span> <span class="nam">principles</span><span class="op">=</span><span class="nam">principles</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
765
+ <p class="run"><span class="n"><a id="t681" href="#t681">681</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_principles</span> <span class="op">=</span> <span class="nam">principles</span>&nbsp;</span><span class="r"></span></p>
766
+ <p class="pln"><span class="n"><a id="t682" href="#t682">682</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
767
+ <p class="run"><span class="n"><a id="t683" href="#t683">683</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_evaluator</span> <span class="op">=</span> <span class="nam">evaluator</span> <span class="key">or</span> <span class="nam">RuleBasedEvaluator</span><span class="op">(</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
768
+ <p class="run"><span class="n"><a id="t684" href="#t684">684</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_min_confidence</span> <span class="op">=</span> <span class="nam">min_confidence</span>&nbsp;</span><span class="r"></span></p>
769
+ <p class="run"><span class="n"><a id="t685" href="#t685">685</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_fail_on_error</span> <span class="op">=</span> <span class="nam">fail_on_evaluator_error</span>&nbsp;</span><span class="r"></span></p>
770
+ <p class="run"><span class="n"><a id="t686" href="#t686">686</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_validation_count</span> <span class="op">=</span> <span class="num">0</span>&nbsp;</span><span class="r"></span></p>
771
+ <p class="pln"><span class="n"><a id="t687" href="#t687">687</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
772
+ <p class="run"><span class="n"><a id="t688" href="#t688">688</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span>&nbsp;</span><span class="r"></span></p>
773
+ <p class="run"><span class="n"><a id="t689" href="#t689">689</a></span><span class="t"> <span class="key">def</span> <span class="nam">principles</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="nam">list</span><span class="op">[</span><span class="nam">Principle</span><span class="op">]</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
774
+ <p class="pln"><span class="n"><a id="t690" href="#t690">690</a></span><span class="t"> <span class="str">"""Get the list of principles."""</span>&nbsp;</span><span class="r"></span></p>
775
+ <p class="run"><span class="n"><a id="t691" href="#t691">691</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_principles</span>&nbsp;</span><span class="r"></span></p>
776
+ <p class="pln"><span class="n"><a id="t692" href="#t692">692</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
777
+ <p class="run"><span class="n"><a id="t693" href="#t693">693</a></span><span class="t"> <span class="op">@</span><span class="nam">property</span>&nbsp;</span><span class="r"></span></p>
778
+ <p class="run"><span class="n"><a id="t694" href="#t694">694</a></span><span class="t"> <span class="key">def</span> <span class="nam">principle_set</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="nam">PrincipleSet</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
779
+ <p class="pln"><span class="n"><a id="t695" href="#t695">695</a></span><span class="t"> <span class="str">"""Get the principle set."""</span>&nbsp;</span><span class="r"></span></p>
780
+ <p class="run"><span class="n"><a id="t696" href="#t696">696</a></span><span class="t"> <span class="key">return</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_principle_set</span>&nbsp;</span><span class="r"></span></p>
781
+ <p class="pln"><span class="n"><a id="t697" href="#t697">697</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
782
+ <p class="run"><span class="n"><a id="t698" href="#t698">698</a></span><span class="t"> <span class="key">def</span> <span class="nam">add_principle</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">principle</span><span class="op">:</span> <span class="nam">Principle</span><span class="op">)</span> <span class="op">-></span> <span class="key">None</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
783
+ <p class="pln"><span class="n"><a id="t699" href="#t699">699</a></span><span class="t"> <span class="str">"""Add a principle to the validator."""</span>&nbsp;</span><span class="r"></span></p>
784
+ <p class="run"><span class="n"><a id="t700" href="#t700">700</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_principles</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">principle</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
785
+ <p class="pln"><span class="n"><a id="t701" href="#t701">701</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
786
+ <p class="run"><span class="n"><a id="t702" href="#t702">702</a></span><span class="t"> <span class="key">def</span> <span class="nam">remove_principle</span><span class="op">(</span><span class="nam">self</span><span class="op">,</span> <span class="nam">name</span><span class="op">:</span> <span class="nam">str</span><span class="op">)</span> <span class="op">-></span> <span class="nam">bool</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
787
+ <p class="pln"><span class="n"><a id="t703" href="#t703">703</a></span><span class="t"> <span class="str">"""Remove a principle by name. Returns True if found and removed."""</span>&nbsp;</span><span class="r"></span></p>
788
+ <p class="run"><span class="n"><a id="t704" href="#t704">704</a></span><span class="t"> <span class="key">for</span> <span class="nam">i</span><span class="op">,</span> <span class="nam">p</span> <span class="key">in</span> <span class="nam">enumerate</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_principles</span><span class="op">)</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
789
+ <p class="par run show_par"><span class="n"><a id="t705" href="#t705">705</a></span><span class="t"> <span class="key">if</span> <span class="nam">p</span><span class="op">.</span><span class="nam">name</span> <span class="op">==</span> <span class="nam">name</span><span class="op">:</span>&nbsp;</span><span class="r"><span class="annotate short">705&#x202F;&#x219B;&#x202F;704</span><span class="annotate long">line 705 didn't jump to line 704 because the condition on line 705 was always true</span></span></p>
790
+ <p class="run"><span class="n"><a id="t706" href="#t706">706</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_principles</span><span class="op">.</span><span class="nam">pop</span><span class="op">(</span><span class="nam">i</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
791
+ <p class="run"><span class="n"><a id="t707" href="#t707">707</a></span><span class="t"> <span class="key">return</span> <span class="key">True</span>&nbsp;</span><span class="r"></span></p>
792
+ <p class="run"><span class="n"><a id="t708" href="#t708">708</a></span><span class="t"> <span class="key">return</span> <span class="key">False</span>&nbsp;</span><span class="r"></span></p>
793
+ <p class="pln"><span class="n"><a id="t709" href="#t709">709</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
794
+ <p class="run"><span class="n"><a id="t710" href="#t710">710</a></span><span class="t"> <span class="key">def</span> <span class="nam">validate</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
795
+ <p class="run run2"><span class="n"><a id="t711" href="#t711">711</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
796
+ <p class="run run2"><span class="n"><a id="t712" href="#t712">712</a></span><span class="t"> <span class="nam">output</span><span class="op">:</span> <span class="nam">str</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
797
+ <p class="run run2"><span class="n"><a id="t713" href="#t713">713</a></span><span class="t"> <span class="nam">context</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
798
+ <p class="run run2"><span class="n"><a id="t714" href="#t714">714</a></span><span class="t"> <span class="nam">principles</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">list</span><span class="op">[</span><span class="nam">Principle</span><span class="op">]</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
799
+ <p class="run run2"><span class="n"><a id="t715" href="#t715">715</a></span><span class="t"> <span class="op">)</span> <span class="op">-></span> <span class="nam">ValidationResult</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
800
+ <p class="pln"><span class="n"><a id="t716" href="#t716">716</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
801
+ <p class="pln"><span class="n"><a id="t717" href="#t717">717</a></span><span class="t"><span class="str"> Validate an output against principles.</span>&nbsp;</span><span class="r"></span></p>
802
+ <p class="pln"><span class="n"><a id="t718" href="#t718">718</a></span><span class="t"><span class="str"> </span>&nbsp;</span><span class="r"></span></p>
803
+ <p class="pln"><span class="n"><a id="t719" href="#t719">719</a></span><span class="t"><span class="str"> Args:</span>&nbsp;</span><span class="r"></span></p>
804
+ <p class="pln"><span class="n"><a id="t720" href="#t720">720</a></span><span class="t"><span class="str"> output: The text to validate</span>&nbsp;</span><span class="r"></span></p>
805
+ <p class="pln"><span class="n"><a id="t721" href="#t721">721</a></span><span class="t"><span class="str"> context: Optional context about the conversation/task</span>&nbsp;</span><span class="r"></span></p>
806
+ <p class="pln"><span class="n"><a id="t722" href="#t722">722</a></span><span class="t"><span class="str"> principles: Optional subset of principles to check (defaults to all)</span>&nbsp;</span><span class="r"></span></p>
807
+ <p class="pln"><span class="n"><a id="t723" href="#t723">723</a></span><span class="t"><span class="str"> </span>&nbsp;</span><span class="r"></span></p>
808
+ <p class="pln"><span class="n"><a id="t724" href="#t724">724</a></span><span class="t"><span class="str"> Returns:</span>&nbsp;</span><span class="r"></span></p>
809
+ <p class="pln"><span class="n"><a id="t725" href="#t725">725</a></span><span class="t"><span class="str"> ValidationResult with any violations found</span>&nbsp;</span><span class="r"></span></p>
810
+ <p class="pln"><span class="n"><a id="t726" href="#t726">726</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
811
+ <p class="run"><span class="n"><a id="t727" href="#t727">727</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_validation_count</span> <span class="op">+=</span> <span class="num">1</span>&nbsp;</span><span class="r"></span></p>
812
+ <p class="run"><span class="n"><a id="t728" href="#t728">728</a></span><span class="t"> <span class="nam">principles_to_check</span> <span class="op">=</span> <span class="nam">principles</span> <span class="key">or</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_principles</span>&nbsp;</span><span class="r"></span></p>
813
+ <p class="run"><span class="n"><a id="t729" href="#t729">729</a></span><span class="t"> <span class="nam">violations</span><span class="op">:</span> <span class="nam">list</span><span class="op">[</span><span class="nam">Violation</span><span class="op">]</span> <span class="op">=</span> <span class="op">[</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
814
+ <p class="pln"><span class="n"><a id="t730" href="#t730">730</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
815
+ <p class="run"><span class="n"><a id="t731" href="#t731">731</a></span><span class="t"> <span class="key">for</span> <span class="nam">principle</span> <span class="key">in</span> <span class="nam">principles_to_check</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
816
+ <p class="run"><span class="n"><a id="t732" href="#t732">732</a></span><span class="t"> <span class="key">try</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
817
+ <p class="run"><span class="n"><a id="t733" href="#t733">733</a></span><span class="t"> <span class="nam">is_violation</span><span class="op">,</span> <span class="nam">confidence</span><span class="op">,</span> <span class="nam">explanation</span> <span class="op">=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_evaluator</span><span class="op">.</span><span class="nam">evaluate</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
818
+ <p class="run run2"><span class="n"><a id="t734" href="#t734">734</a></span><span class="t"> <span class="nam">output</span><span class="op">,</span> <span class="nam">principle</span><span class="op">,</span> <span class="nam">context</span>&nbsp;</span><span class="r"></span></p>
819
+ <p class="run run2"><span class="n"><a id="t735" href="#t735">735</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
820
+ <p class="pln"><span class="n"><a id="t736" href="#t736">736</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
821
+ <p class="run"><span class="n"><a id="t737" href="#t737">737</a></span><span class="t"> <span class="key">if</span> <span class="nam">is_violation</span> <span class="key">and</span> <span class="nam">confidence</span> <span class="op">>=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_min_confidence</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
822
+ <p class="run"><span class="n"><a id="t738" href="#t738">738</a></span><span class="t"> <span class="nam">violations</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">Violation</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
823
+ <p class="run run2"><span class="n"><a id="t739" href="#t739">739</a></span><span class="t"> <span class="nam">principle</span><span class="op">=</span><span class="nam">principle</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
824
+ <p class="run run2"><span class="n"><a id="t740" href="#t740">740</a></span><span class="t"> <span class="nam">confidence</span><span class="op">=</span><span class="nam">confidence</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
825
+ <p class="run run2"><span class="n"><a id="t741" href="#t741">741</a></span><span class="t"> <span class="nam">explanation</span><span class="op">=</span><span class="nam">explanation</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
826
+ <p class="run run2"><span class="n"><a id="t742" href="#t742">742</a></span><span class="t"> <span class="op">)</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
827
+ <p class="mis show_mis"><span class="n"><a id="t743" href="#t743">743</a></span><span class="t"> <span class="key">except</span> <span class="nam">Exception</span> <span class="key">as</span> <span class="nam">e</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
828
+ <p class="mis show_mis"><span class="n"><a id="t744" href="#t744">744</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_fail_on_error</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
829
+ <p class="mis show_mis"><span class="n"><a id="t745" href="#t745">745</a></span><span class="t"> <span class="nam">violations</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">Violation</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
830
+ <p class="mis mis2 show_mis"><span class="n"><a id="t746" href="#t746">746</a></span><span class="t"> <span class="nam">principle</span><span class="op">=</span><span class="nam">principle</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
831
+ <p class="mis mis2 show_mis"><span class="n"><a id="t747" href="#t747">747</a></span><span class="t"> <span class="nam">confidence</span><span class="op">=</span><span class="num">1.0</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
832
+ <p class="mis mis2 show_mis"><span class="n"><a id="t748" href="#t748">748</a></span><span class="t"> <span class="nam">explanation</span><span class="op">=</span><span class="fst">f"</span><span class="fst">Evaluator error (treating as violation): </span><span class="op">{</span><span class="nam">e</span><span class="op">}</span><span class="fst">"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
833
+ <p class="mis mis2 show_mis"><span class="n"><a id="t749" href="#t749">749</a></span><span class="t"> <span class="op">)</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
834
+ <p class="pln"><span class="n"><a id="t750" href="#t750">750</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
835
+ <p class="pln"><span class="n"><a id="t751" href="#t751">751</a></span><span class="t"> <span class="com"># Determine if passed (no critical or high violations)</span>&nbsp;</span><span class="r"></span></p>
836
+ <p class="run"><span class="n"><a id="t752" href="#t752">752</a></span><span class="t"> <span class="nam">blocking</span> <span class="op">=</span> <span class="op">[</span><span class="nam">v</span> <span class="key">for</span> <span class="nam">v</span> <span class="key">in</span> <span class="nam">violations</span>&nbsp;</span><span class="r"></span></p>
837
+ <p class="run run2"><span class="n"><a id="t753" href="#t753">753</a></span><span class="t"> <span class="key">if</span> <span class="nam">v</span><span class="op">.</span><span class="nam">principle</span><span class="op">.</span><span class="nam">severity</span> <span class="key">in</span> <span class="op">(</span><span class="nam">Severity</span><span class="op">.</span><span class="nam">CRITICAL</span><span class="op">,</span> <span class="nam">Severity</span><span class="op">.</span><span class="nam">HIGH</span><span class="op">)</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
838
+ <p class="run"><span class="n"><a id="t754" href="#t754">754</a></span><span class="t"> <span class="nam">passed</span> <span class="op">=</span> <span class="nam">len</span><span class="op">(</span><span class="nam">blocking</span><span class="op">)</span> <span class="op">==</span> <span class="num">0</span>&nbsp;</span><span class="r"></span></p>
839
+ <p class="pln"><span class="n"><a id="t755" href="#t755">755</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
840
+ <p class="run"><span class="n"><a id="t756" href="#t756">756</a></span><span class="t"> <span class="key">return</span> <span class="nam">ValidationResult</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
841
+ <p class="run run2"><span class="n"><a id="t757" href="#t757">757</a></span><span class="t"> <span class="nam">passed</span><span class="op">=</span><span class="nam">passed</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
842
+ <p class="run run2"><span class="n"><a id="t758" href="#t758">758</a></span><span class="t"> <span class="nam">violations</span><span class="op">=</span><span class="nam">violations</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
843
+ <p class="run run2"><span class="n"><a id="t759" href="#t759">759</a></span><span class="t"> <span class="nam">output_text</span><span class="op">=</span><span class="nam">output</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
844
+ <p class="run run2"><span class="n"><a id="t760" href="#t760">760</a></span><span class="t"> <span class="nam">principles_checked</span><span class="op">=</span><span class="nam">len</span><span class="op">(</span><span class="nam">principles_to_check</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
845
+ <p class="run run2"><span class="n"><a id="t761" href="#t761">761</a></span><span class="t"> <span class="nam">metadata</span><span class="op">=</span><span class="op">{</span>&nbsp;</span><span class="r"></span></p>
846
+ <p class="run run2"><span class="n"><a id="t762" href="#t762">762</a></span><span class="t"> <span class="str">"validation_id"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_validation_count</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
847
+ <p class="run run2"><span class="n"><a id="t763" href="#t763">763</a></span><span class="t"> <span class="str">"principle_set"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_principle_set</span><span class="op">.</span><span class="nam">name</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
848
+ <p class="run run2"><span class="n"><a id="t764" href="#t764">764</a></span><span class="t"> <span class="str">"evaluator"</span><span class="op">:</span> <span class="nam">type</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_evaluator</span><span class="op">)</span><span class="op">.</span><span class="nam">__name__</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
849
+ <p class="run run2"><span class="n"><a id="t765" href="#t765">765</a></span><span class="t"> <span class="op">}</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
850
+ <p class="run run2"><span class="n"><a id="t766" href="#t766">766</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
851
+ <p class="pln"><span class="n"><a id="t767" href="#t767">767</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
852
+ <p class="run"><span class="n"><a id="t768" href="#t768">768</a></span><span class="t"> <span class="key">async</span> <span class="key">def</span> <span class="nam">validate_async</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
853
+ <p class="run run2"><span class="n"><a id="t769" href="#t769">769</a></span><span class="t"> <span class="nam">self</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
854
+ <p class="run run2"><span class="n"><a id="t770" href="#t770">770</a></span><span class="t"> <span class="nam">output</span><span class="op">:</span> <span class="nam">str</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
855
+ <p class="run run2"><span class="n"><a id="t771" href="#t771">771</a></span><span class="t"> <span class="nam">context</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
856
+ <p class="run run2"><span class="n"><a id="t772" href="#t772">772</a></span><span class="t"> <span class="nam">principles</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">list</span><span class="op">[</span><span class="nam">Principle</span><span class="op">]</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
857
+ <p class="run run2"><span class="n"><a id="t773" href="#t773">773</a></span><span class="t"> <span class="nam">parallel</span><span class="op">:</span> <span class="nam">bool</span> <span class="op">=</span> <span class="key">True</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
858
+ <p class="run run2"><span class="n"><a id="t774" href="#t774">774</a></span><span class="t"> <span class="op">)</span> <span class="op">-></span> <span class="nam">ValidationResult</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
859
+ <p class="pln"><span class="n"><a id="t775" href="#t775">775</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
860
+ <p class="pln"><span class="n"><a id="t776" href="#t776">776</a></span><span class="t"><span class="str"> Async validate an output against principles.</span>&nbsp;</span><span class="r"></span></p>
861
+ <p class="pln"><span class="n"><a id="t777" href="#t777">777</a></span><span class="t"><span class="str"> </span>&nbsp;</span><span class="r"></span></p>
862
+ <p class="pln"><span class="n"><a id="t778" href="#t778">778</a></span><span class="t"><span class="str"> Args:</span>&nbsp;</span><span class="r"></span></p>
863
+ <p class="pln"><span class="n"><a id="t779" href="#t779">779</a></span><span class="t"><span class="str"> output: The text to validate</span>&nbsp;</span><span class="r"></span></p>
864
+ <p class="pln"><span class="n"><a id="t780" href="#t780">780</a></span><span class="t"><span class="str"> context: Optional context</span>&nbsp;</span><span class="r"></span></p>
865
+ <p class="pln"><span class="n"><a id="t781" href="#t781">781</a></span><span class="t"><span class="str"> principles: Optional subset of principles</span>&nbsp;</span><span class="r"></span></p>
866
+ <p class="pln"><span class="n"><a id="t782" href="#t782">782</a></span><span class="t"><span class="str"> parallel: If True, evaluate principles in parallel</span>&nbsp;</span><span class="r"></span></p>
867
+ <p class="pln"><span class="n"><a id="t783" href="#t783">783</a></span><span class="t"><span class="str"> </span>&nbsp;</span><span class="r"></span></p>
868
+ <p class="pln"><span class="n"><a id="t784" href="#t784">784</a></span><span class="t"><span class="str"> Returns:</span>&nbsp;</span><span class="r"></span></p>
869
+ <p class="pln"><span class="n"><a id="t785" href="#t785">785</a></span><span class="t"><span class="str"> ValidationResult with any violations found</span>&nbsp;</span><span class="r"></span></p>
870
+ <p class="pln"><span class="n"><a id="t786" href="#t786">786</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
871
+ <p class="run"><span class="n"><a id="t787" href="#t787">787</a></span><span class="t"> <span class="nam">self</span><span class="op">.</span><span class="nam">_validation_count</span> <span class="op">+=</span> <span class="num">1</span>&nbsp;</span><span class="r"></span></p>
872
+ <p class="run"><span class="n"><a id="t788" href="#t788">788</a></span><span class="t"> <span class="nam">principles_to_check</span> <span class="op">=</span> <span class="nam">principles</span> <span class="key">or</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_principles</span>&nbsp;</span><span class="r"></span></p>
873
+ <p class="run"><span class="n"><a id="t789" href="#t789">789</a></span><span class="t"> <span class="nam">violations</span><span class="op">:</span> <span class="nam">list</span><span class="op">[</span><span class="nam">Violation</span><span class="op">]</span> <span class="op">=</span> <span class="op">[</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
874
+ <p class="pln"><span class="n"><a id="t790" href="#t790">790</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
875
+ <p class="run"><span class="n"><a id="t791" href="#t791">791</a></span><span class="t"> <span class="key">async</span> <span class="key">def</span> <span class="nam">check_principle</span><span class="op">(</span><span class="nam">principle</span><span class="op">:</span> <span class="nam">Principle</span><span class="op">)</span> <span class="op">-></span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">Violation</span><span class="op">]</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
876
+ <p class="run"><span class="n"><a id="t792" href="#t792">792</a></span><span class="t"> <span class="key">try</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
877
+ <p class="run"><span class="n"><a id="t793" href="#t793">793</a></span><span class="t"> <span class="nam">is_violation</span><span class="op">,</span> <span class="nam">confidence</span><span class="op">,</span> <span class="nam">explanation</span> <span class="op">=</span> <span class="key">await</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_evaluator</span><span class="op">.</span><span class="nam">evaluate_async</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
878
+ <p class="run run2"><span class="n"><a id="t794" href="#t794">794</a></span><span class="t"> <span class="nam">output</span><span class="op">,</span> <span class="nam">principle</span><span class="op">,</span> <span class="nam">context</span>&nbsp;</span><span class="r"></span></p>
879
+ <p class="run run2"><span class="n"><a id="t795" href="#t795">795</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
880
+ <p class="par run show_par"><span class="n"><a id="t796" href="#t796">796</a></span><span class="t"> <span class="key">if</span> <span class="nam">is_violation</span> <span class="key">and</span> <span class="nam">confidence</span> <span class="op">>=</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_min_confidence</span><span class="op">:</span>&nbsp;</span><span class="r"><span class="annotate short">796&#x202F;&#x219B;&#x202F;797</span><span class="annotate long">line 796 didn't jump to line 797 because the condition on line 796 was never true</span></span></p>
881
+ <p class="mis show_mis"><span class="n"><a id="t797" href="#t797">797</a></span><span class="t"> <span class="key">return</span> <span class="nam">Violation</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
882
+ <p class="mis mis2 show_mis"><span class="n"><a id="t798" href="#t798">798</a></span><span class="t"> <span class="nam">principle</span><span class="op">=</span><span class="nam">principle</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
883
+ <p class="mis mis2 show_mis"><span class="n"><a id="t799" href="#t799">799</a></span><span class="t"> <span class="nam">confidence</span><span class="op">=</span><span class="nam">confidence</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
884
+ <p class="mis mis2 show_mis"><span class="n"><a id="t800" href="#t800">800</a></span><span class="t"> <span class="nam">explanation</span><span class="op">=</span><span class="nam">explanation</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
885
+ <p class="mis mis2 show_mis"><span class="n"><a id="t801" href="#t801">801</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
886
+ <p class="mis show_mis"><span class="n"><a id="t802" href="#t802">802</a></span><span class="t"> <span class="key">except</span> <span class="nam">Exception</span> <span class="key">as</span> <span class="nam">e</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
887
+ <p class="mis show_mis"><span class="n"><a id="t803" href="#t803">803</a></span><span class="t"> <span class="key">if</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_fail_on_error</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
888
+ <p class="mis show_mis"><span class="n"><a id="t804" href="#t804">804</a></span><span class="t"> <span class="key">return</span> <span class="nam">Violation</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
889
+ <p class="mis mis2 show_mis"><span class="n"><a id="t805" href="#t805">805</a></span><span class="t"> <span class="nam">principle</span><span class="op">=</span><span class="nam">principle</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
890
+ <p class="mis mis2 show_mis"><span class="n"><a id="t806" href="#t806">806</a></span><span class="t"> <span class="nam">confidence</span><span class="op">=</span><span class="num">1.0</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
891
+ <p class="mis mis2 show_mis"><span class="n"><a id="t807" href="#t807">807</a></span><span class="t"> <span class="nam">explanation</span><span class="op">=</span><span class="fst">f"</span><span class="fst">Evaluator error: </span><span class="op">{</span><span class="nam">e</span><span class="op">}</span><span class="fst">"</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
892
+ <p class="mis mis2 show_mis"><span class="n"><a id="t808" href="#t808">808</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
893
+ <p class="run"><span class="n"><a id="t809" href="#t809">809</a></span><span class="t"> <span class="key">return</span> <span class="key">None</span>&nbsp;</span><span class="r"></span></p>
894
+ <p class="pln"><span class="n"><a id="t810" href="#t810">810</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
895
+ <p class="par run show_par"><span class="n"><a id="t811" href="#t811">811</a></span><span class="t"> <span class="key">if</span> <span class="nam">parallel</span><span class="op">:</span>&nbsp;</span><span class="r"><span class="annotate short">811&#x202F;&#x219B;&#x202F;817</span><span class="annotate long">line 811 didn't jump to line 817 because the condition on line 811 was always true</span></span></p>
896
+ <p class="run"><span class="n"><a id="t812" href="#t812">812</a></span><span class="t"> <span class="nam">results</span> <span class="op">=</span> <span class="key">await</span> <span class="nam">asyncio</span><span class="op">.</span><span class="nam">gather</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
897
+ <p class="run run2"><span class="n"><a id="t813" href="#t813">813</a></span><span class="t"> <span class="op">*</span><span class="op">[</span><span class="nam">check_principle</span><span class="op">(</span><span class="nam">p</span><span class="op">)</span> <span class="key">for</span> <span class="nam">p</span> <span class="key">in</span> <span class="nam">principles_to_check</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
898
+ <p class="run run2"><span class="n"><a id="t814" href="#t814">814</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
899
+ <p class="run"><span class="n"><a id="t815" href="#t815">815</a></span><span class="t"> <span class="nam">violations</span> <span class="op">=</span> <span class="op">[</span><span class="nam">v</span> <span class="key">for</span> <span class="nam">v</span> <span class="key">in</span> <span class="nam">results</span> <span class="key">if</span> <span class="nam">v</span> <span class="key">is</span> <span class="key">not</span> <span class="key">None</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
900
+ <p class="pln"><span class="n"><a id="t816" href="#t816">816</a></span><span class="t"> <span class="key">else</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
901
+ <p class="mis show_mis"><span class="n"><a id="t817" href="#t817">817</a></span><span class="t"> <span class="key">for</span> <span class="nam">principle</span> <span class="key">in</span> <span class="nam">principles_to_check</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
902
+ <p class="mis show_mis"><span class="n"><a id="t818" href="#t818">818</a></span><span class="t"> <span class="nam">violation</span> <span class="op">=</span> <span class="key">await</span> <span class="nam">check_principle</span><span class="op">(</span><span class="nam">principle</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
903
+ <p class="mis show_mis"><span class="n"><a id="t819" href="#t819">819</a></span><span class="t"> <span class="key">if</span> <span class="nam">violation</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
904
+ <p class="mis show_mis"><span class="n"><a id="t820" href="#t820">820</a></span><span class="t"> <span class="nam">violations</span><span class="op">.</span><span class="nam">append</span><span class="op">(</span><span class="nam">violation</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
905
+ <p class="pln"><span class="n"><a id="t821" href="#t821">821</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
906
+ <p class="run"><span class="n"><a id="t822" href="#t822">822</a></span><span class="t"> <span class="nam">blocking</span> <span class="op">=</span> <span class="op">[</span><span class="nam">v</span> <span class="key">for</span> <span class="nam">v</span> <span class="key">in</span> <span class="nam">violations</span>&nbsp;</span><span class="r"></span></p>
907
+ <p class="run run2"><span class="n"><a id="t823" href="#t823">823</a></span><span class="t"> <span class="key">if</span> <span class="nam">v</span><span class="op">.</span><span class="nam">principle</span><span class="op">.</span><span class="nam">severity</span> <span class="key">in</span> <span class="op">(</span><span class="nam">Severity</span><span class="op">.</span><span class="nam">CRITICAL</span><span class="op">,</span> <span class="nam">Severity</span><span class="op">.</span><span class="nam">HIGH</span><span class="op">)</span><span class="op">]</span>&nbsp;</span><span class="r"></span></p>
908
+ <p class="run"><span class="n"><a id="t824" href="#t824">824</a></span><span class="t"> <span class="nam">passed</span> <span class="op">=</span> <span class="nam">len</span><span class="op">(</span><span class="nam">blocking</span><span class="op">)</span> <span class="op">==</span> <span class="num">0</span>&nbsp;</span><span class="r"></span></p>
909
+ <p class="pln"><span class="n"><a id="t825" href="#t825">825</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
910
+ <p class="run"><span class="n"><a id="t826" href="#t826">826</a></span><span class="t"> <span class="key">return</span> <span class="nam">ValidationResult</span><span class="op">(</span>&nbsp;</span><span class="r"></span></p>
911
+ <p class="run run2"><span class="n"><a id="t827" href="#t827">827</a></span><span class="t"> <span class="nam">passed</span><span class="op">=</span><span class="nam">passed</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
912
+ <p class="run run2"><span class="n"><a id="t828" href="#t828">828</a></span><span class="t"> <span class="nam">violations</span><span class="op">=</span><span class="nam">violations</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
913
+ <p class="run run2"><span class="n"><a id="t829" href="#t829">829</a></span><span class="t"> <span class="nam">output_text</span><span class="op">=</span><span class="nam">output</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
914
+ <p class="run run2"><span class="n"><a id="t830" href="#t830">830</a></span><span class="t"> <span class="nam">principles_checked</span><span class="op">=</span><span class="nam">len</span><span class="op">(</span><span class="nam">principles_to_check</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
915
+ <p class="run run2"><span class="n"><a id="t831" href="#t831">831</a></span><span class="t"> <span class="nam">metadata</span><span class="op">=</span><span class="op">{</span>&nbsp;</span><span class="r"></span></p>
916
+ <p class="run run2"><span class="n"><a id="t832" href="#t832">832</a></span><span class="t"> <span class="str">"validation_id"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_validation_count</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
917
+ <p class="run run2"><span class="n"><a id="t833" href="#t833">833</a></span><span class="t"> <span class="str">"principle_set"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_principle_set</span><span class="op">.</span><span class="nam">name</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
918
+ <p class="run run2"><span class="n"><a id="t834" href="#t834">834</a></span><span class="t"> <span class="str">"evaluator"</span><span class="op">:</span> <span class="nam">type</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_evaluator</span><span class="op">)</span><span class="op">.</span><span class="nam">__name__</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
919
+ <p class="run run2"><span class="n"><a id="t835" href="#t835">835</a></span><span class="t"> <span class="str">"parallel"</span><span class="op">:</span> <span class="nam">parallel</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
920
+ <p class="run run2"><span class="n"><a id="t836" href="#t836">836</a></span><span class="t"> <span class="op">}</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
921
+ <p class="run run2"><span class="n"><a id="t837" href="#t837">837</a></span><span class="t"> <span class="op">)</span>&nbsp;</span><span class="r"></span></p>
922
+ <p class="pln"><span class="n"><a id="t838" href="#t838">838</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
923
+ <p class="run"><span class="n"><a id="t839" href="#t839">839</a></span><span class="t"> <span class="key">def</span> <span class="nam">get_stats</span><span class="op">(</span><span class="nam">self</span><span class="op">)</span> <span class="op">-></span> <span class="nam">dict</span><span class="op">[</span><span class="nam">str</span><span class="op">,</span> <span class="nam">Any</span><span class="op">]</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
924
+ <p class="pln"><span class="n"><a id="t840" href="#t840">840</a></span><span class="t"> <span class="str">"""Get validator statistics."""</span>&nbsp;</span><span class="r"></span></p>
925
+ <p class="run"><span class="n"><a id="t841" href="#t841">841</a></span><span class="t"> <span class="key">return</span> <span class="op">{</span>&nbsp;</span><span class="r"></span></p>
926
+ <p class="run run2"><span class="n"><a id="t842" href="#t842">842</a></span><span class="t"> <span class="str">"validation_count"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_validation_count</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
927
+ <p class="run run2"><span class="n"><a id="t843" href="#t843">843</a></span><span class="t"> <span class="str">"principle_count"</span><span class="op">:</span> <span class="nam">len</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_principles</span><span class="op">)</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
928
+ <p class="run run2"><span class="n"><a id="t844" href="#t844">844</a></span><span class="t"> <span class="str">"principle_set"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_principle_set</span><span class="op">.</span><span class="nam">name</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
929
+ <p class="run run2"><span class="n"><a id="t845" href="#t845">845</a></span><span class="t"> <span class="str">"evaluator"</span><span class="op">:</span> <span class="nam">type</span><span class="op">(</span><span class="nam">self</span><span class="op">.</span><span class="nam">_evaluator</span><span class="op">)</span><span class="op">.</span><span class="nam">__name__</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
930
+ <p class="run run2"><span class="n"><a id="t846" href="#t846">846</a></span><span class="t"> <span class="str">"min_confidence"</span><span class="op">:</span> <span class="nam">self</span><span class="op">.</span><span class="nam">_min_confidence</span><span class="op">,</span>&nbsp;</span><span class="r"></span></p>
931
+ <p class="run run2"><span class="n"><a id="t847" href="#t847">847</a></span><span class="t"> <span class="op">}</span>&nbsp;</span><span class="r"></span></p>
932
+ <p class="pln"><span class="n"><a id="t848" href="#t848">848</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
933
+ <p class="pln"><span class="n"><a id="t849" href="#t849">849</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
934
+ <p class="pln"><span class="n"><a id="t850" href="#t850">850</a></span><span class="t"><span class="com"># ============================================================================</span>&nbsp;</span><span class="r"></span></p>
935
+ <p class="pln"><span class="n"><a id="t851" href="#t851">851</a></span><span class="t"><span class="com"># Convenience Functions</span>&nbsp;</span><span class="r"></span></p>
936
+ <p class="pln"><span class="n"><a id="t852" href="#t852">852</a></span><span class="t"><span class="com"># ============================================================================</span>&nbsp;</span><span class="r"></span></p>
937
+ <p class="pln"><span class="n"><a id="t853" href="#t853">853</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
938
+ <p class="run"><span class="n"><a id="t854" href="#t854">854</a></span><span class="t"><span class="key">def</span> <span class="nam">validate_safety</span><span class="op">(</span><span class="nam">output</span><span class="op">:</span> <span class="nam">str</span><span class="op">,</span> <span class="nam">context</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">)</span> <span class="op">-></span> <span class="nam">ValidationResult</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
939
+ <p class="pln"><span class="n"><a id="t855" href="#t855">855</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
940
+ <p class="pln"><span class="n"><a id="t856" href="#t856">856</a></span><span class="t"><span class="str"> Quick validation against safety principles.</span>&nbsp;</span><span class="r"></span></p>
941
+ <p class="pln"><span class="n"><a id="t857" href="#t857">857</a></span><span class="t"><span class="str"> </span>&nbsp;</span><span class="r"></span></p>
942
+ <p class="pln"><span class="n"><a id="t858" href="#t858">858</a></span><span class="t"><span class="str"> Args:</span>&nbsp;</span><span class="r"></span></p>
943
+ <p class="pln"><span class="n"><a id="t859" href="#t859">859</a></span><span class="t"><span class="str"> output: Text to validate</span>&nbsp;</span><span class="r"></span></p>
944
+ <p class="pln"><span class="n"><a id="t860" href="#t860">860</a></span><span class="t"><span class="str"> context: Optional context</span>&nbsp;</span><span class="r"></span></p>
945
+ <p class="pln"><span class="n"><a id="t861" href="#t861">861</a></span><span class="t"><span class="str"> </span>&nbsp;</span><span class="r"></span></p>
946
+ <p class="pln"><span class="n"><a id="t862" href="#t862">862</a></span><span class="t"><span class="str"> Returns:</span>&nbsp;</span><span class="r"></span></p>
947
+ <p class="pln"><span class="n"><a id="t863" href="#t863">863</a></span><span class="t"><span class="str"> ValidationResult</span>&nbsp;</span><span class="r"></span></p>
948
+ <p class="pln"><span class="n"><a id="t864" href="#t864">864</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
949
+ <p class="run"><span class="n"><a id="t865" href="#t865">865</a></span><span class="t"> <span class="nam">validator</span> <span class="op">=</span> <span class="nam">ConstitutionalValidator</span><span class="op">(</span><span class="nam">principles</span><span class="op">=</span><span class="nam">SAFETY_PRINCIPLES</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
950
+ <p class="run"><span class="n"><a id="t866" href="#t866">866</a></span><span class="t"> <span class="key">return</span> <span class="nam">validator</span><span class="op">.</span><span class="nam">validate</span><span class="op">(</span><span class="nam">output</span><span class="op">,</span> <span class="nam">context</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
951
+ <p class="pln"><span class="n"><a id="t867" href="#t867">867</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
952
+ <p class="pln"><span class="n"><a id="t868" href="#t868">868</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
953
+ <p class="run"><span class="n"><a id="t869" href="#t869">869</a></span><span class="t"><span class="key">def</span> <span class="nam">validate_medical</span><span class="op">(</span><span class="nam">output</span><span class="op">:</span> <span class="nam">str</span><span class="op">,</span> <span class="nam">context</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">)</span> <span class="op">-></span> <span class="nam">ValidationResult</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
954
+ <p class="pln"><span class="n"><a id="t870" href="#t870">870</a></span><span class="t"> <span class="str">"""Quick validation against medical principles."""</span>&nbsp;</span><span class="r"></span></p>
955
+ <p class="run"><span class="n"><a id="t871" href="#t871">871</a></span><span class="t"> <span class="nam">combined</span> <span class="op">=</span> <span class="nam">SAFETY_PRINCIPLES</span><span class="op">.</span><span class="nam">merge</span><span class="op">(</span><span class="nam">MEDICAL_PRINCIPLES</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
956
+ <p class="run"><span class="n"><a id="t872" href="#t872">872</a></span><span class="t"> <span class="nam">validator</span> <span class="op">=</span> <span class="nam">ConstitutionalValidator</span><span class="op">(</span><span class="nam">principles</span><span class="op">=</span><span class="nam">combined</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
957
+ <p class="run"><span class="n"><a id="t873" href="#t873">873</a></span><span class="t"> <span class="key">return</span> <span class="nam">validator</span><span class="op">.</span><span class="nam">validate</span><span class="op">(</span><span class="nam">output</span><span class="op">,</span> <span class="nam">context</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
958
+ <p class="pln"><span class="n"><a id="t874" href="#t874">874</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
959
+ <p class="pln"><span class="n"><a id="t875" href="#t875">875</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
960
+ <p class="run"><span class="n"><a id="t876" href="#t876">876</a></span><span class="t"><span class="key">def</span> <span class="nam">validate_financial</span><span class="op">(</span><span class="nam">output</span><span class="op">:</span> <span class="nam">str</span><span class="op">,</span> <span class="nam">context</span><span class="op">:</span> <span class="nam">Optional</span><span class="op">[</span><span class="nam">str</span><span class="op">]</span> <span class="op">=</span> <span class="key">None</span><span class="op">)</span> <span class="op">-></span> <span class="nam">ValidationResult</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
961
+ <p class="pln"><span class="n"><a id="t877" href="#t877">877</a></span><span class="t"> <span class="str">"""Quick validation against financial principles."""</span>&nbsp;</span><span class="r"></span></p>
962
+ <p class="run"><span class="n"><a id="t878" href="#t878">878</a></span><span class="t"> <span class="nam">combined</span> <span class="op">=</span> <span class="nam">SAFETY_PRINCIPLES</span><span class="op">.</span><span class="nam">merge</span><span class="op">(</span><span class="nam">FINANCIAL_PRINCIPLES</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
963
+ <p class="run"><span class="n"><a id="t879" href="#t879">879</a></span><span class="t"> <span class="nam">validator</span> <span class="op">=</span> <span class="nam">ConstitutionalValidator</span><span class="op">(</span><span class="nam">principles</span><span class="op">=</span><span class="nam">combined</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
964
+ <p class="run"><span class="n"><a id="t880" href="#t880">880</a></span><span class="t"> <span class="key">return</span> <span class="nam">validator</span><span class="op">.</span><span class="nam">validate</span><span class="op">(</span><span class="nam">output</span><span class="op">,</span> <span class="nam">context</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
965
+ <p class="pln"><span class="n"><a id="t881" href="#t881">881</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
966
+ <p class="pln"><span class="n"><a id="t882" href="#t882">882</a></span><span class="t">&nbsp;</span><span class="r"></span></p>
967
+ <p class="run"><span class="n"><a id="t883" href="#t883">883</a></span><span class="t"><span class="key">def</span> <span class="nam">create_validator_from_yaml</span><span class="op">(</span><span class="nam">yaml_str</span><span class="op">:</span> <span class="nam">str</span><span class="op">)</span> <span class="op">-></span> <span class="nam">ConstitutionalValidator</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
968
+ <p class="pln"><span class="n"><a id="t884" href="#t884">884</a></span><span class="t"> <span class="str">"""</span>&nbsp;</span><span class="r"></span></p>
969
+ <p class="pln"><span class="n"><a id="t885" href="#t885">885</a></span><span class="t"><span class="str"> Create a validator from YAML configuration.</span>&nbsp;</span><span class="r"></span></p>
970
+ <p class="pln"><span class="n"><a id="t886" href="#t886">886</a></span><span class="t"><span class="str"> </span>&nbsp;</span><span class="r"></span></p>
971
+ <p class="pln"><span class="n"><a id="t887" href="#t887">887</a></span><span class="t"><span class="str"> YAML format:</span>&nbsp;</span><span class="r"></span></p>
972
+ <p class="pln"><span class="n"><a id="t888" href="#t888">888</a></span><span class="t"><span class="str"> name: my_principles</span>&nbsp;</span><span class="r"></span></p>
973
+ <p class="pln"><span class="n"><a id="t889" href="#t889">889</a></span><span class="t"><span class="str"> description: Custom principles</span>&nbsp;</span><span class="r"></span></p>
974
+ <p class="pln"><span class="n"><a id="t890" href="#t890">890</a></span><span class="t"><span class="str"> principles:</span>&nbsp;</span><span class="r"></span></p>
975
+ <p class="pln"><span class="n"><a id="t891" href="#t891">891</a></span><span class="t"><span class="str"> - name: rule_1</span>&nbsp;</span><span class="r"></span></p>
976
+ <p class="pln"><span class="n"><a id="t892" href="#t892">892</a></span><span class="t"><span class="str"> description: First rule description</span>&nbsp;</span><span class="r"></span></p>
977
+ <p class="pln"><span class="n"><a id="t893" href="#t893">893</a></span><span class="t"><span class="str"> severity: high</span>&nbsp;</span><span class="r"></span></p>
978
+ <p class="pln"><span class="n"><a id="t894" href="#t894">894</a></span><span class="t"><span class="str"> category: safety</span>&nbsp;</span><span class="r"></span></p>
979
+ <p class="pln"><span class="n"><a id="t895" href="#t895">895</a></span><span class="t"><span class="str"> """</span>&nbsp;</span><span class="r"></span></p>
980
+ <p class="mis show_mis"><span class="n"><a id="t896" href="#t896">896</a></span><span class="t"> <span class="key">try</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
981
+ <p class="mis show_mis"><span class="n"><a id="t897" href="#t897">897</a></span><span class="t"> <span class="key">import</span> <span class="nam">yaml</span>&nbsp;</span><span class="r"></span></p>
982
+ <p class="mis show_mis"><span class="n"><a id="t898" href="#t898">898</a></span><span class="t"> <span class="nam">data</span> <span class="op">=</span> <span class="nam">yaml</span><span class="op">.</span><span class="nam">safe_load</span><span class="op">(</span><span class="nam">yaml_str</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
983
+ <p class="mis show_mis"><span class="n"><a id="t899" href="#t899">899</a></span><span class="t"> <span class="nam">principle_set</span> <span class="op">=</span> <span class="nam">PrincipleSet</span><span class="op">.</span><span class="nam">from_dict</span><span class="op">(</span><span class="nam">data</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
984
+ <p class="mis show_mis"><span class="n"><a id="t900" href="#t900">900</a></span><span class="t"> <span class="key">return</span> <span class="nam">ConstitutionalValidator</span><span class="op">(</span><span class="nam">principles</span><span class="op">=</span><span class="nam">principle_set</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
985
+ <p class="mis show_mis"><span class="n"><a id="t901" href="#t901">901</a></span><span class="t"> <span class="key">except</span> <span class="nam">ImportError</span><span class="op">:</span>&nbsp;</span><span class="r"></span></p>
986
+ <p class="mis show_mis"><span class="n"><a id="t902" href="#t902">902</a></span><span class="t"> <span class="key">raise</span> <span class="nam">ImportError</span><span class="op">(</span><span class="str">"PyYAML is required for YAML configuration. Install with: pip install pyyaml"</span><span class="op">)</span>&nbsp;</span><span class="r"></span></p>
987
+ </main>
988
+ <footer>
989
+ <div class="content">
990
+ <p>
991
+ <a class="nav" href="z_2c49bd2ed3e01e38_benchmarks_py.html">&#xab; prev</a> &nbsp; &nbsp;
992
+ <a class="nav" href="index.html">&Hat; index</a> &nbsp; &nbsp;
993
+ <a class="nav" href="z_2c49bd2ed3e01e38_hf_utils_py.html">&#xbb; next</a>
994
+ &nbsp; &nbsp; &nbsp;
995
+ <a class="nav" href="https://coverage.readthedocs.io/en/7.13.1">coverage.py v7.13.1</a>,
996
+ created at 2026-02-02 21:04 -0800
997
+ </p>
998
+ </div>
999
+ </footer>
1000
+ </body>
1001
+ </html>