open-code-review-toolkit 0.14.7__tar.gz → 0.14.8__tar.gz

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 (187) hide show
  1. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/PKG-INFO +1 -1
  2. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/_version.py +2 -2
  3. open_code_review_toolkit-0.14.8/src/ocr_toolkit/common/provider_http.py +25 -0
  4. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/configure.py +4 -0
  5. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/native_capabilities.py +13 -1
  6. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/gitlab.py +40 -4
  7. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/preflight.py +46 -6
  8. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/provider_config.py +38 -3
  9. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/providers/gitlab.py +32 -3
  10. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/providers/gitlab_ci.py +22 -3
  11. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/providers/gitlab_discussions.py +19 -3
  12. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/review_runner.py +11 -1
  13. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/.gitignore +0 -0
  14. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/LICENSE +0 -0
  15. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/README.md +0 -0
  16. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/pyproject.toml +0 -0
  17. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/__init__.py +0 -0
  18. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/cli.py +0 -0
  19. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/common/__init__.py +0 -0
  20. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/common/filesystem.py +0 -0
  21. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/common/git.py +0 -0
  22. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/common/language.py +0 -0
  23. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/common/literal_context.py +0 -0
  24. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/common/markdown.py +0 -0
  25. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/common/redaction.py +0 -0
  26. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/common/value_boundaries.py +0 -0
  27. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/config_writer.py +0 -0
  28. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/__init__.py +0 -0
  29. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/broker.py +0 -0
  30. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/ci_outcomes.py +0 -0
  31. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/code_text.py +0 -0
  32. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/contracts.py +0 -0
  33. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/dlp/__init__.py +0 -0
  34. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/dlp/admission.py +0 -0
  35. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/dlp/credentials.py +0 -0
  36. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/dlp/datetimes.py +0 -0
  37. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/dlp/decoding.py +0 -0
  38. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/dlp/email.py +0 -0
  39. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/dlp/markup.py +0 -0
  40. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/dlp/numeric.py +0 -0
  41. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/dlp/presentation.py +0 -0
  42. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/dlp/projection.py +0 -0
  43. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/dlp/result_prose.py +0 -0
  44. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/mcp.py +0 -0
  45. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/policy.py +0 -0
  46. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/recognizers.py +0 -0
  47. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/context/store.py +0 -0
  48. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/diagrams/__init__.py +0 -0
  49. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/diagrams/admission.py +0 -0
  50. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/diagrams/collector.py +0 -0
  51. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/diagrams/contracts.py +0 -0
  52. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/diagrams/diagnostics.py +0 -0
  53. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/diagrams/lifecycle.py +0 -0
  54. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/diagrams/mcp.py +0 -0
  55. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/diagrams/persistence.py +0 -0
  56. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/diagrams/sources.py +0 -0
  57. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/dlp_audit/__init__.py +0 -0
  58. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/dlp_audit/__main__.py +0 -0
  59. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/dlp_audit/cli.py +0 -0
  60. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/dlp_audit/corpus.py +0 -0
  61. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/dlp_audit/limits.py +0 -0
  62. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/dlp_audit/proof.py +0 -0
  63. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/dlp_audit/report.py +0 -0
  64. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/dlp_audit/scanner.py +0 -0
  65. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/dlp_audit/state.py +0 -0
  66. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/dlp_audit/worker_process.py +0 -0
  67. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/__init__.py +0 -0
  68. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/__main__.py +0 -0
  69. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/actions.py +0 -0
  70. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/artifacts.py +0 -0
  71. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/categorize.py +0 -0
  72. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/collect.py +0 -0
  73. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/collectors/__init__.py +0 -0
  74. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/collectors/graphs.py +0 -0
  75. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/collectors/orchestration.py +0 -0
  76. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/collectors/projections.py +0 -0
  77. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/collectors/registry.py +0 -0
  78. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/collectors/sources.py +0 -0
  79. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/coverage.py +0 -0
  80. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/ecosystems/__init__.py +0 -0
  81. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/ecosystems/ansible/__init__.py +0 -0
  82. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/ecosystems/ansible/requirements.py +0 -0
  83. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/ecosystems/ansible/topology.py +0 -0
  84. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/ecosystems/contracts.py +0 -0
  85. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/ecosystems/go.py +0 -0
  86. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/ecosystems/javascript.py +0 -0
  87. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/ecosystems/php.py +0 -0
  88. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/ecosystems/python.py +0 -0
  89. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/frameworks/__init__.py +0 -0
  90. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/frameworks/contracts.py +0 -0
  91. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/frameworks/detection.py +0 -0
  92. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/frameworks/providers/__init__.py +0 -0
  93. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/frameworks/providers/frontend.py +0 -0
  94. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/frameworks/providers/go.py +0 -0
  95. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/frameworks/providers/php.py +0 -0
  96. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/frameworks/providers/python.py +0 -0
  97. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/frameworks/registry.py +0 -0
  98. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/frameworks/schema.py +0 -0
  99. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/frameworks/templates.py +0 -0
  100. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/gitlink_projection.py +0 -0
  101. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/gitlinks.py +0 -0
  102. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/infrastructure.py +0 -0
  103. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/invocation.py +0 -0
  104. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/mcp.py +0 -0
  105. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/model.py +0 -0
  106. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/opaque_code.py +0 -0
  107. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/policy/__init__.py +0 -0
  108. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/policy/contracts.py +0 -0
  109. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/policy/decisions.py +0 -0
  110. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/policy/guidance.py +0 -0
  111. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/policy/registry.py +0 -0
  112. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/policy/schema.py +0 -0
  113. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/policy/scopes.py +0 -0
  114. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/project.py +0 -0
  115. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/repository.py +0 -0
  116. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/review_context.py +0 -0
  117. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/review_range.py +0 -0
  118. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/source_reader.py +0 -0
  119. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/source_syntax.py +0 -0
  120. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/store/__init__.py +0 -0
  121. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/store/atomic.py +0 -0
  122. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/store/contracts.py +0 -0
  123. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/store/core.py +0 -0
  124. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/store/readback.py +0 -0
  125. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/store/values.py +0 -0
  126. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/text_contracts.py +0 -0
  127. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/text_excerpts.py +0 -0
  128. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/evidence/text_metadata.py +0 -0
  129. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/federation/__init__.py +0 -0
  130. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/federation/admission.py +0 -0
  131. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/federation/contracts.py +0 -0
  132. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/federation/gateway.py +0 -0
  133. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/federation/registry.py +0 -0
  134. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/federation/relay.py +0 -0
  135. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/federation/runtime.py +0 -0
  136. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/federation/transport.py +0 -0
  137. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/local_chatgpt.py +0 -0
  138. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/mcp_config.py +0 -0
  139. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/ocr_result.py +0 -0
  140. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/__init__.py +0 -0
  141. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/__main__.py +0 -0
  142. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/approval.py +0 -0
  143. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/comments.py +0 -0
  144. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/formatting.py +0 -0
  145. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/freshness.py +0 -0
  146. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/gitlab_approval.py +0 -0
  147. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/markers.py +0 -0
  148. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/payloads.py +0 -0
  149. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/reconciliation.py +0 -0
  150. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/result.py +0 -0
  151. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/settings.py +0 -0
  152. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/snapshot.py +0 -0
  153. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/source_suggestions.py +0 -0
  154. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/suggestions.py +0 -0
  155. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/transaction.py +0 -0
  156. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/posting/workflow.py +0 -0
  157. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/pre_execution.py +0 -0
  158. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/provider_failure.py +0 -0
  159. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/providers/__init__.py +0 -0
  160. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/providers/gitlab_context.py +0 -0
  161. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/providers/gitlab_identity.py +0 -0
  162. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/providers/gitlab_remediation.py +0 -0
  163. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/providers/local.py +0 -0
  164. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/providers/local_config.py +0 -0
  165. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/py.typed +0 -0
  166. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/__init__.py +0 -0
  167. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/diagram.py +0 -0
  168. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/diagram_layout.py +0 -0
  169. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/dlp.py +0 -0
  170. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/federation.py +0 -0
  171. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/metadata.py +0 -0
  172. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/model.py +0 -0
  173. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/outcome.py +0 -0
  174. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/result.py +0 -0
  175. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/sections.py +0 -0
  176. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/text.py +0 -0
  177. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/usage.py +0 -0
  178. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/reporting/warnings.py +0 -0
  179. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/repository_coverage.py +0 -0
  180. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/result_contract.py +0 -0
  181. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/result_usage.py +0 -0
  182. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/review_debug.py +0 -0
  183. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/review_identity.py +0 -0
  184. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/review_progress.py +0 -0
  185. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/review_range.py +0 -0
  186. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/review_receipt.py +0 -0
  187. {open_code_review_toolkit-0.14.7 → open_code_review_toolkit-0.14.8}/src/ocr_toolkit/review_trace.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.5
2
2
  Name: open-code-review-toolkit
3
- Version: 0.14.7
3
+ Version: 0.14.8
4
4
  Summary: Unofficial GitLab CI integration layer for Open Code Review
5
5
  Project-URL: Homepage, https://github.com/xeonvs/open-code-review-toolkit
6
6
  Project-URL: Repository, https://github.com/xeonvs/open-code-review-toolkit
@@ -18,7 +18,7 @@ version_tuple: tuple[int | str, ...]
18
18
  commit_id: str | None
19
19
  __commit_id__: str | None
20
20
 
21
- __version__ = version = '0.14.7'
22
- __version_tuple__ = version_tuple = (0, 14, 7)
21
+ __version__ = version = '0.14.8'
22
+ __version_tuple__ = version_tuple = (0, 14, 8)
23
23
 
24
24
  __commit_id__ = commit_id = None
@@ -0,0 +1,25 @@
1
+ """Small provider-neutral policy for outbound forge API request identity."""
2
+
3
+ from collections.abc import Mapping
4
+
5
+ DEFAULT_FORGE_API_USER_AGENT = "open-code-review-toolkit-provider/1"
6
+ FORGE_API_USER_AGENT_VARIABLE = "OCR_FORGE_API_USER_AGENT"
7
+ _UNSET = object()
8
+
9
+
10
+ def resolve_forge_api_user_agent(environment: Mapping[str, str]) -> str:
11
+ """Resolve a bounded printable ASCII agent without exposing invalid input."""
12
+
13
+ value = environment.get(FORGE_API_USER_AGENT_VARIABLE, _UNSET)
14
+ if value is _UNSET:
15
+ return DEFAULT_FORGE_API_USER_AGENT
16
+ if (
17
+ not isinstance(value, str)
18
+ or not 1 <= len(value) <= 256
19
+ or any(not 32 <= ord(character) <= 126 for character in value)
20
+ or not value.strip()
21
+ ):
22
+ raise ValueError(
23
+ f"{FORGE_API_USER_AGENT_VARIABLE} must be nonblank printable ASCII (1-256 bytes)"
24
+ )
25
+ return value
@@ -13,6 +13,7 @@ from ocr_toolkit.local_chatgpt import LocalChatGPTError, auth_mode, provider_ent
13
13
  from ocr_toolkit.provider_config import (
14
14
  ProviderConfigError,
15
15
  provider_config_from_environment,
16
+ provider_url_notice,
16
17
  )
17
18
 
18
19
 
@@ -74,6 +75,9 @@ def build_config_updates(*, local: bool = False) -> dict[str, Any]:
74
75
  updates["llm.extra_headers"] = request_controls.extra_headers
75
76
  if request_controls.extra_body is not None:
76
77
  updates["llm.extra_body"] = request_controls.extra_body
78
+ notice = provider_url_notice(provider)
79
+ if notice:
80
+ print(f"WARNING: {redact_sensitive(notice)}", file=sys.stderr)
77
81
  except (ProviderConfigError, LocalChatGPTError) as exc:
78
82
  raise OCRRuntimeConfigError(str(exc)) from exc
79
83
 
@@ -3,8 +3,9 @@
3
3
  from __future__ import annotations
4
4
 
5
5
  from typing import Literal
6
+ from urllib.parse import urlsplit
6
7
 
7
- NativeCapability = Literal["diagram_output", "gitlink_projection"]
8
+ NativeCapability = Literal["diagram_output", "gitlink_projection", "inference_query"]
8
9
 
9
10
  # Adjacent patches require the real controlled-peer consumer suite before entry.
10
11
  # A supported OCR version does not automatically qualify an optional handoff.
@@ -14,6 +15,7 @@ _QUALIFIED_HANDOFFS = {
14
15
  "1.13.5": frozenset({"diagram_output", "gitlink_projection"}),
15
16
  "1.13.6": frozenset({"diagram_output", "gitlink_projection"}),
16
17
  "1.13.7": frozenset({"diagram_output", "gitlink_projection"}),
18
+ "1.13.8": frozenset({"diagram_output", "gitlink_projection"}),
17
19
  }
18
20
 
19
21
 
@@ -21,3 +23,13 @@ def supports_native_capability(version: str | None, capability: NativeCapability
21
23
  """Fail closed for absent, noncanonical or unqualified versions/capabilities."""
22
24
 
23
25
  return isinstance(version, str) and capability in _QUALIFIED_HANDOFFS.get(version, ())
26
+
27
+
28
+ def require_native_inference_url(version: str, url: str) -> None:
29
+ """Reject a valid URL when the exact native client cannot preserve its query."""
30
+
31
+ if urlsplit(url).query and not supports_native_capability(version, "inference_query"):
32
+ raise ValueError(
33
+ "The qualified OCR client does not support OCR_LLM_URL query parameters; "
34
+ "use a query-free endpoint or provider-supported headers"
35
+ )
@@ -3,6 +3,7 @@
3
3
  from __future__ import annotations
4
4
 
5
5
  import json
6
+ import os
6
7
  import re
7
8
  import secrets
8
9
  import sys
@@ -13,6 +14,11 @@ import urllib.request
13
14
  from dataclasses import dataclass
14
15
  from typing import Any
15
16
 
17
+ from ocr_toolkit.common.provider_http import (
18
+ DEFAULT_FORGE_API_USER_AGENT,
19
+ FORGE_API_USER_AGENT_VARIABLE,
20
+ resolve_forge_api_user_agent,
21
+ )
16
22
  from ocr_toolkit.common.redaction import redact_sensitive
17
23
  from ocr_toolkit.posting.payloads import (
18
24
  build_marked_note_body,
@@ -49,6 +55,7 @@ class GitLabConfig:
49
55
  auth_header: str
50
56
  current_user_id: int | None
51
57
  current_username: str | None
58
+ forge_api_user_agent: str = DEFAULT_FORGE_API_USER_AGENT
52
59
 
53
60
  @property
54
61
  def api_base(self) -> str:
@@ -162,7 +169,7 @@ class _SameOriginRedirectHandler(urllib.request.HTTPRedirectHandler):
162
169
 
163
170
 
164
171
  def _open_gitlab_request(request: urllib.request.Request) -> Any:
165
- """Open one GitLab request with redirect handling disabled."""
172
+ """Allow same-origin HTTPS read redirects and refuse mutation redirects."""
166
173
 
167
174
  return urllib.request.build_opener(_SameOriginRedirectHandler()).open(
168
175
  request, timeout=DEFAULT_HTTP_TIMEOUT_SECONDS
@@ -209,12 +216,19 @@ def api_request_url(
209
216
  auth_header: str,
210
217
  data: dict[str, Any] | None = None,
211
218
  method: str = "GET",
219
+ *,
220
+ user_agent: str | None = None,
212
221
  ) -> Any | None:
213
222
  """Call a GitLab API URL and return parsed JSON, `{}` for empty success, or None."""
214
223
 
224
+ if user_agent is None:
225
+ user_agent = resolve_forge_api_user_agent(os.environ)
226
+ else:
227
+ user_agent = resolve_forge_api_user_agent({FORGE_API_USER_AGENT_VARIABLE: user_agent})
215
228
  headers = {
216
229
  auth_header: api_token,
217
230
  "Content-Type": "application/json",
231
+ "User-Agent": user_agent,
218
232
  }
219
233
 
220
234
  body = json.dumps(data).encode("utf-8") if data is not None else None
@@ -311,15 +325,21 @@ def api_write_url_detailed(
311
325
  *,
312
326
  create_kind: str | None = None,
313
327
  write_id: str | None = None,
328
+ user_agent: str | None = None,
314
329
  ) -> GitLabWriteResult:
315
330
  """Call one write once and classify create ambiguity without retrying."""
316
331
 
317
332
  if create_kind not in {None, "draft", "discussion"}:
318
333
  raise ValueError("unsupported GitLab create response kind")
319
334
 
335
+ if user_agent is None:
336
+ user_agent = resolve_forge_api_user_agent(os.environ)
337
+ else:
338
+ user_agent = resolve_forge_api_user_agent({FORGE_API_USER_AGENT_VARIABLE: user_agent})
320
339
  headers = {
321
340
  auth_header: api_token,
322
341
  "Content-Type": "application/json",
342
+ "User-Agent": user_agent,
323
343
  }
324
344
  body = json.dumps(data).encode("utf-8")
325
345
  request = urllib.request.Request(url, data=body, headers=headers, method=method)
@@ -413,14 +433,16 @@ def print_user_id_failure_banner(reason: str) -> None:
413
433
 
414
434
 
415
435
  def fetch_posting_identity(
416
- server_url: str, api_token: str, auth_header: str
436
+ server_url: str, api_token: str, auth_header: str, *, user_agent: str | None = None
417
437
  ) -> tuple[int | None, str | None]:
418
438
  """Return the validated live GitLab id and username, or a closed failure."""
419
439
 
420
440
  try:
421
441
  identity = fetch_current_user_identity(
422
442
  f"{server_url}/api/v4",
423
- lambda url: api_request_url(url, api_token, auth_header, method="GET"),
443
+ lambda url: api_request_url(
444
+ url, api_token, auth_header, method="GET", user_agent=user_agent
445
+ ),
424
446
  )
425
447
  except GitLabIdentityError as exc:
426
448
  print_user_id_failure_banner(str(exc))
@@ -472,8 +494,16 @@ def load_gitlab_config() -> GitLabConfig | None:
472
494
  print("CI_SERVER_URL must be an absolute HTTPS URL.", file=sys.stderr)
473
495
  return None
474
496
 
497
+ try:
498
+ user_agent = resolve_forge_api_user_agent(os.environ)
499
+ except ValueError as exc:
500
+ print(str(exc), file=sys.stderr)
501
+ return None
502
+
475
503
  auth_header = "PRIVATE-TOKEN"
476
- current_user_id, current_username = fetch_posting_identity(server_url, api_token, auth_header)
504
+ current_user_id, current_username = fetch_posting_identity(
505
+ server_url, api_token, auth_header, user_agent=user_agent
506
+ )
477
507
 
478
508
  return GitLabConfig(
479
509
  server_url=server_url,
@@ -483,6 +513,7 @@ def load_gitlab_config() -> GitLabConfig | None:
483
513
  auth_header=auth_header,
484
514
  current_user_id=current_user_id,
485
515
  current_username=current_username,
516
+ forge_api_user_agent=user_agent,
486
517
  )
487
518
 
488
519
 
@@ -500,6 +531,7 @@ def api_request(
500
531
  auth_header=config.auth_header,
501
532
  data=data,
502
533
  method=method,
534
+ user_agent=config.forge_api_user_agent,
503
535
  )
504
536
 
505
537
 
@@ -672,6 +704,7 @@ def update_plain_note(config: GitLabConfig, note_id: int, body: str) -> GitLabWr
672
704
  auth_header=config.auth_header,
673
705
  data={"body": build_marked_note_body(body)},
674
706
  method="PUT",
707
+ user_agent=config.forge_api_user_agent,
675
708
  )
676
709
 
677
710
 
@@ -683,6 +716,7 @@ def approve_merge_request(config: GitLabConfig, sha: str) -> GitLabWriteResult:
683
716
  api_token=config.api_token,
684
717
  auth_header=config.auth_header,
685
718
  data={"sha": sha},
719
+ user_agent=config.forge_api_user_agent,
686
720
  )
687
721
 
688
722
 
@@ -776,6 +810,7 @@ def post_inline_note_detailed(
776
810
  },
777
811
  create_kind="discussion",
778
812
  write_id=write_id,
813
+ user_agent=config.forge_api_user_agent,
779
814
  )
780
815
 
781
816
 
@@ -809,6 +844,7 @@ def post_inline_draft_note_detailed(
809
844
  },
810
845
  create_kind="draft",
811
846
  write_id=write_id,
847
+ user_agent=config.forge_api_user_agent,
812
848
  )
813
849
 
814
850
 
@@ -14,6 +14,9 @@ import urllib.parse
14
14
  import urllib.request
15
15
  from typing import Any
16
16
 
17
+ from ocr_toolkit.common.provider_http import (
18
+ resolve_forge_api_user_agent,
19
+ )
17
20
  from ocr_toolkit.common.redaction import redact_sensitive
18
21
  from ocr_toolkit.local_chatgpt import (
19
22
  LocalChatGPTError,
@@ -22,10 +25,14 @@ from ocr_toolkit.local_chatgpt import (
22
25
  provider_entry,
23
26
  require_supported_version,
24
27
  )
28
+ from ocr_toolkit.native_capabilities import require_native_inference_url
25
29
  from ocr_toolkit.provider_config import (
26
30
  HEADER_NAME_RE,
31
+ ProviderConfig,
27
32
  ProviderConfigError,
28
33
  provider_config_from_environment,
34
+ provider_endpoint_summary,
35
+ provider_url_notice,
29
36
  )
30
37
  from ocr_toolkit.providers.gitlab import (
31
38
  TARGET_PROTECTION_MODE_VARIABLE,
@@ -42,7 +49,7 @@ DEFAULT_REQUEST_HEADERS = {
42
49
  "Accept": "application/json",
43
50
  "User-Agent": "open-code-review-ci-preflight/1.0",
44
51
  }
45
- RECOMMENDED_OCR_VERSION = "1.13.7"
52
+ RECOMMENDED_OCR_VERSION = "1.13.8"
46
53
  SUPPORTED_OCR_VERSIONS = (
47
54
  "1.12.0",
48
55
  "1.12.1",
@@ -66,6 +73,7 @@ SUPPORTED_OCR_VERSIONS = (
66
73
  "1.13.5",
67
74
  "1.13.6",
68
75
  "1.13.7",
76
+ "1.13.8",
69
77
  )
70
78
  DEPRECATED_OCR_VERSIONS = (
71
79
  "1.11.0",
@@ -110,7 +118,12 @@ def _set_response_timeout(response: Any, timeout: float) -> None:
110
118
  def _safe_url(url: str) -> str:
111
119
  """Return a URL safe for CI diagnostics."""
112
120
 
113
- return redact_sensitive(url)
121
+ try:
122
+ parsed = urllib.parse.urlsplit(url)
123
+ except ValueError:
124
+ return "<invalid URL>"
125
+ safe = parsed._replace(netloc=parsed.netloc.rsplit("@", 1)[-1], query="", fragment="")
126
+ return redact_sensitive(urllib.parse.urlunsplit(safe))
114
127
 
115
128
 
116
129
  def _env(name: str, default: str = "") -> str:
@@ -213,6 +226,10 @@ def _request_json(url: str, headers: dict[str, str]) -> Any:
213
226
  def validate_gitlab_access() -> None:
214
227
  """Verify the configured bot token can read this project and MR."""
215
228
 
229
+ try:
230
+ user_agent = resolve_forge_api_user_agent(os.environ)
231
+ except ValueError as exc:
232
+ raise PreflightError(str(exc)) from exc
216
233
  token = _env("GITLAB_API_TOKEN")
217
234
  project_id = _env("CI_PROJECT_ID")
218
235
  mr_iid = _env("CI_MERGE_REQUEST_IID")
@@ -223,7 +240,7 @@ def validate_gitlab_access() -> None:
223
240
 
224
241
  api_root = _gitlab_api_root()
225
242
  project_id_encoded = urllib.parse.quote_plus(project_id)
226
- headers = {"PRIVATE-TOKEN": token}
243
+ headers = {"PRIVATE-TOKEN": token, "User-Agent": user_agent}
227
244
 
228
245
  print("Validating GitLab token access to project and merge request")
229
246
  _request_json(f"{api_root}/user", headers)
@@ -348,11 +365,28 @@ def _validate_allowed_model(model_id: str) -> bool:
348
365
  return True
349
366
 
350
367
 
351
- def validate_llm_model() -> None:
352
- """Verify the selected model exists in OpenAI-compatible metadata."""
368
+ def validate_llm_configuration() -> ProviderConfig:
369
+ """Require all API review inputs before any provider or GitLab HTTP request."""
353
370
 
354
371
  try:
355
372
  provider = provider_config_from_environment()
373
+ provider.require_inference_url()
374
+ provider.require_token()
375
+ provider.require_model()
376
+ except ProviderConfigError as exc:
377
+ raise PreflightError(str(exc)) from exc
378
+ notice = provider_url_notice(provider)
379
+ if notice:
380
+ print(f"WARNING: {redact_sensitive(notice)}", file=sys.stderr)
381
+ print(redact_sensitive(provider_endpoint_summary(provider)))
382
+ return provider
383
+
384
+
385
+ def validate_llm_model(provider: ProviderConfig | None = None) -> None:
386
+ """Verify the selected model exists in OpenAI-compatible metadata."""
387
+
388
+ try:
389
+ provider = provider or provider_config_from_environment()
356
390
  model_id = provider.require_model()
357
391
  except ProviderConfigError as exc:
358
392
  raise PreflightError(str(exc)) from exc
@@ -423,7 +457,13 @@ def main(*, local: bool = False) -> int:
423
457
  raise PreflightError(str(exc)) from exc
424
458
  if mode == "chatgpt":
425
459
  provider_entry(os.environ)
460
+ provider = validate_llm_configuration() if mode == "api-key" else None
426
461
  version = validate_ocr_binary()
462
+ if provider is not None:
463
+ try:
464
+ require_native_inference_url(version, provider.require_inference_url())
465
+ except ValueError as exc:
466
+ raise PreflightError(str(exc)) from exc
427
467
  if mode == "chatgpt":
428
468
  require_supported_version(version)
429
469
  native_store(os.environ)
@@ -436,7 +476,7 @@ def main(*, local: bool = False) -> int:
436
476
  if not local:
437
477
  validate_gitlab_review_settings()
438
478
  validate_gitlab_access()
439
- validate_llm_model()
479
+ validate_llm_model(provider)
440
480
  except (PreflightError, LocalChatGPTError) as exc:
441
481
  print(f"OCR preflight failed: {redact_sensitive(str(exc))}", file=sys.stderr)
442
482
  return 1
@@ -51,6 +51,7 @@ class ProviderConfig:
51
51
  model: str | None
52
52
  token: str | None = field(repr=False)
53
53
  request_controls: ProviderRequestControls = field(repr=False)
54
+ defaulted_api_version: bool = False
54
55
 
55
56
  def require_inference_url(self) -> str:
56
57
  """Return the normalized OCR API root or reject missing review configuration."""
@@ -66,6 +67,13 @@ class ProviderConfig:
66
67
  raise ProviderConfigError("OCR_LLM_MODEL is required")
67
68
  return self.model
68
69
 
70
+ def require_inference_endpoint(self) -> str:
71
+ """Project the native request endpoint from the already canonical API root."""
72
+
73
+ root = urlsplit(self.require_inference_url())
74
+ path = root.path.rstrip("/") + TERMINAL_ENDPOINTS[self.request_controls.protocol]
75
+ return urlunsplit(root._replace(path=path))
76
+
69
77
  def require_token(self) -> str:
70
78
  """Return the configured provider credential without rendering it."""
71
79
 
@@ -199,12 +207,13 @@ def _parse_https_url(value: str, name: str) -> SplitResult:
199
207
 
200
208
  def _canonical_provider_urls(
201
209
  llm_url: str, models_url: str, protocol: str
202
- ) -> tuple[str | None, str | None, str | None]:
210
+ ) -> tuple[str | None, str | None, str | None, bool]:
203
211
  """Return normalized inference, API-root, and auxiliary provider URLs."""
204
212
 
205
213
  inference: str | None = None
206
214
  api_root: str | None = None
207
215
  derived_models: str | None = None
216
+ defaulted_api_version = False
208
217
  if llm_url:
209
218
  parsed = _parse_https_url(llm_url, "OCR_LLM_URL")
210
219
  path = parsed.path
@@ -219,6 +228,9 @@ def _canonical_provider_urls(
219
228
  "OCR_LLM_URL terminal endpoint conflicts with OCR_LLM_PROTOCOL; "
220
229
  f"use {protocol!r} endpoint semantics or provide the API root"
221
230
  )
231
+ if matched_protocol is None and not path and protocol in {"openai", "openai-responses"}:
232
+ path = "/v1"
233
+ defaulted_api_version = True
222
234
  root_parts = SplitResult(parsed.scheme, parsed.netloc, path, "", "")
223
235
  api_root = urlunsplit(root_parts)
224
236
  inference = urlunsplit(root_parts._replace(query=parsed.query))
@@ -228,7 +240,29 @@ def _canonical_provider_urls(
228
240
  explicit_models: str | None = None
229
241
  if models_url:
230
242
  explicit_models = urlunsplit(_parse_https_url(models_url, "OCR_LLM_MODELS_URL"))
231
- return inference, api_root, explicit_models or derived_models
243
+ return inference, api_root, explicit_models or derived_models, defaulted_api_version
244
+
245
+
246
+ def provider_endpoint_summary(provider: ProviderConfig) -> str:
247
+ """Describe the selected request path without credential-bearing query values."""
248
+
249
+ endpoint = urlsplit(provider.require_inference_endpoint())
250
+ safe_endpoint = urlunsplit(endpoint._replace(query=""))
251
+ return (
252
+ f"OCR LLM endpoint: protocol={provider.request_controls.protocol} "
253
+ f"base={provider.api_root_url} inference={safe_endpoint}"
254
+ )
255
+
256
+
257
+ def provider_url_notice(provider: ProviderConfig) -> str | None:
258
+ """Return one optional normalization notice; emission belongs to the caller."""
259
+
260
+ if not provider.defaulted_api_version:
261
+ return None
262
+ return (
263
+ f"OCR_LLM_URL has no API path; using {provider.api_root_url} for "
264
+ f"{provider.request_controls.protocol}. Set OCR_LLM_URL to this API root explicitly."
265
+ )
232
266
 
233
267
 
234
268
  def _apply_reasoning_effort(extra_body: dict[str, Any], *, protocol: str, value: str) -> None:
@@ -314,7 +348,7 @@ def provider_config_from_environment(
314
348
 
315
349
  values: Mapping[str, str] = dict(os.environ) if environment is None else dict(environment)
316
350
  request_controls = request_controls_from_environment(values)
317
- inference_url, api_root_url, models_url = _canonical_provider_urls(
351
+ inference_url, api_root_url, models_url, defaulted_api_version = _canonical_provider_urls(
318
352
  _env(values, "OCR_LLM_URL"),
319
353
  _env(values, "OCR_LLM_MODELS_URL"),
320
354
  request_controls.protocol,
@@ -326,4 +360,5 @@ def provider_config_from_environment(
326
360
  model=_env(values, "OCR_LLM_MODEL") or None,
327
361
  token=_env(values, "OCR_LLM_TOKEN") or None,
328
362
  request_controls=request_controls,
363
+ defaulted_api_version=defaulted_api_version,
329
364
  )
@@ -12,6 +12,11 @@ from collections.abc import Mapping
12
12
  from dataclasses import dataclass
13
13
  from typing import Any, Literal
14
14
 
15
+ from ocr_toolkit.common.provider_http import (
16
+ DEFAULT_FORGE_API_USER_AGENT,
17
+ FORGE_API_USER_AGENT_VARIABLE,
18
+ resolve_forge_api_user_agent,
19
+ )
15
20
  from ocr_toolkit.evidence.invocation import MAX_CI_IDENTIFIER_CHARS, InvocationIdentifier
16
21
  from ocr_toolkit.evidence.review_context import (
17
22
  MergeRequestContext,
@@ -182,9 +187,15 @@ def _api_root(environment: Mapping[str, str]) -> str:
182
187
  return raw
183
188
 
184
189
 
185
- def _read_json(url: str, token: str, *, deadline: float) -> object:
190
+ def _read_json(
191
+ url: str, token: str, *, deadline: float, user_agent: str = DEFAULT_FORGE_API_USER_AGENT
192
+ ) -> object:
186
193
  """Read one complete bounded provider response without redirects or retries."""
187
194
 
195
+ try:
196
+ user_agent = resolve_forge_api_user_agent({FORGE_API_USER_AGENT_VARIABLE: user_agent})
197
+ except ValueError as exc:
198
+ raise GitLabProviderError(str(exc)) from exc
188
199
  if not token or "\r" in token or "\n" in token or len(token) > 16_384:
189
200
  raise GitLabProviderError("GITLAB_API_TOKEN is missing or malformed")
190
201
  remaining = deadline - time.monotonic()
@@ -195,7 +206,7 @@ def _read_json(url: str, token: str, *, deadline: float) -> object:
195
206
  headers={
196
207
  "Accept": "application/json",
197
208
  "PRIVATE-TOKEN": token,
198
- "User-Agent": "open-code-review-toolkit-provider/1",
209
+ "User-Agent": user_agent,
199
210
  },
200
211
  method="GET",
201
212
  )
@@ -360,6 +371,7 @@ def _current_diff_identity(
360
371
  token: str,
361
372
  deadline: float,
362
373
  source_sha: str,
374
+ user_agent: str = DEFAULT_FORGE_API_USER_AGENT,
363
375
  ) -> tuple[str, str, str, int]:
364
376
  """Bind current MR diff refs to its current authenticated version."""
365
377
 
@@ -384,6 +396,7 @@ def _current_diff_identity(
384
396
  f"{api_root}/projects/{project}/merge_requests/{merge_request_iid}/versions?per_page=1",
385
397
  token,
386
398
  deadline=deadline,
399
+ user_agent=user_agent,
387
400
  )
388
401
  if not isinstance(versions, list) or not versions:
389
402
  raise GitLabProviderError(
@@ -407,7 +420,13 @@ def _current_diff_identity(
407
420
 
408
421
 
409
422
  def _branch_snapshot(
410
- *, api_root: str, project: str, branch_name: str, token: str, deadline: float
423
+ *,
424
+ api_root: str,
425
+ project: str,
426
+ branch_name: str,
427
+ token: str,
428
+ deadline: float,
429
+ user_agent: str = DEFAULT_FORGE_API_USER_AGENT,
411
430
  ) -> tuple[bool, str]:
412
431
  """Read a named branch's protected state and immutable head over HTTPS."""
413
432
 
@@ -416,6 +435,7 @@ def _branch_snapshot(
416
435
  f"{api_root}/projects/{project}/repository/branches/{encoded_branch}",
417
436
  token,
418
437
  deadline=deadline,
438
+ user_agent=user_agent,
419
439
  )
420
440
  if not isinstance(branch, dict):
421
441
  raise GitLabProviderError("GitLab branch metadata must be an object")
@@ -438,6 +458,10 @@ def acquire_review_snapshot(
438
458
  project_id = _numeric_identifier(environment, "CI_PROJECT_ID")
439
459
  merge_request_iid = _numeric_identifier(environment, "CI_MERGE_REQUEST_IID")
440
460
  token = environment.get("GITLAB_API_TOKEN", "").strip()
461
+ try:
462
+ user_agent = resolve_forge_api_user_agent(environment)
463
+ except ValueError as exc:
464
+ raise GitLabProviderError(str(exc)) from exc
441
465
  api_root = _api_root(environment)
442
466
  project = urllib.parse.quote(project_id, safe="")
443
467
  deadline = time.monotonic() + PROVIDER_TIMEOUT_SECONDS
@@ -445,6 +469,7 @@ def acquire_review_snapshot(
445
469
  f"{api_root}/projects/{project}/merge_requests/{merge_request_iid}",
446
470
  token,
447
471
  deadline=deadline,
472
+ user_agent=user_agent,
448
473
  )
449
474
  if not isinstance(mr, dict):
450
475
  raise GitLabProviderError("GitLab merge-request metadata must be an object")
@@ -482,6 +507,7 @@ def acquire_review_snapshot(
482
507
  token=token,
483
508
  deadline=deadline,
484
509
  source_sha=source_sha,
510
+ user_agent=user_agent,
485
511
  )
486
512
  protected, target_sha = _branch_snapshot(
487
513
  api_root=api_root,
@@ -489,6 +515,7 @@ def acquire_review_snapshot(
489
515
  branch_name=target_branch,
490
516
  token=token,
491
517
  deadline=deadline,
518
+ user_agent=user_agent,
492
519
  )
493
520
  if not protected and protection_mode != "unprotected":
494
521
  if protection_mode == "required":
@@ -497,6 +524,7 @@ def acquire_review_snapshot(
497
524
  f"{api_root}/projects/{project}",
498
525
  token,
499
526
  deadline=deadline,
527
+ user_agent=user_agent,
500
528
  )
501
529
  if not isinstance(project_metadata, dict):
502
530
  raise GitLabProviderError("GitLab project metadata must be an object")
@@ -509,6 +537,7 @@ def acquire_review_snapshot(
509
537
  branch_name=policy_branch,
510
538
  token=token,
511
539
  deadline=deadline,
540
+ user_agent=user_agent,
512
541
  )
513
542
  if not policy_protected:
514
543
  raise GitLabProviderError("GitLab default branch is not protected policy authority")
@@ -11,6 +11,11 @@ import urllib.request
11
11
  from collections.abc import Mapping
12
12
  from typing import Any
13
13
 
14
+ from ocr_toolkit.common.provider_http import (
15
+ DEFAULT_FORGE_API_USER_AGENT,
16
+ FORGE_API_USER_AGENT_VARIABLE,
17
+ resolve_forge_api_user_agent,
18
+ )
14
19
  from ocr_toolkit.context.ci_outcomes import CIOutcome, CIOutcomeSnapshot
15
20
  from ocr_toolkit.context.contracts import CIOutcomePolicy
16
21
  from ocr_toolkit.providers.gitlab import GitLabProviderError, _api_root, _numeric_identifier
@@ -37,9 +42,15 @@ def _pairs(pairs: list[tuple[str, Any]]) -> dict[str, Any]:
37
42
  return result
38
43
 
39
44
 
40
- def _read_page(url: str, token: str, *, deadline: float) -> tuple[object, bool]:
45
+ def _read_page(
46
+ url: str, token: str, *, deadline: float, user_agent: str = DEFAULT_FORGE_API_USER_AGENT
47
+ ) -> tuple[object, bool]:
41
48
  """Read one bounded JSON page and report whether another page exists."""
42
49
 
50
+ try:
51
+ user_agent = resolve_forge_api_user_agent({FORGE_API_USER_AGENT_VARIABLE: user_agent})
52
+ except ValueError as exc:
53
+ raise GitLabProviderError(str(exc)) from exc
43
54
  if not token or "\r" in token or "\n" in token or len(token) > 16_384:
44
55
  raise GitLabProviderError("GITLAB_API_TOKEN is missing or malformed")
45
56
  remaining = deadline - time.monotonic()
@@ -50,7 +61,7 @@ def _read_page(url: str, token: str, *, deadline: float) -> tuple[object, bool]:
50
61
  headers={
51
62
  "Accept": "application/json",
52
63
  "PRIVATE-TOKEN": token,
53
- "User-Agent": "open-code-review-toolkit-ci-outcomes/1",
64
+ "User-Agent": user_agent,
54
65
  },
55
66
  method="GET",
56
67
  )
@@ -107,6 +118,10 @@ def _raw_snapshot(
107
118
  """Normalize one bounded provider read without retaining raw identities."""
108
119
 
109
120
  token = environment.get("GITLAB_API_TOKEN", "").strip()
121
+ try:
122
+ user_agent = resolve_forge_api_user_agent(environment)
123
+ except ValueError as exc:
124
+ raise GitLabProviderError(str(exc)) from exc
110
125
  api_root = _api_root(environment)
111
126
  project = urllib.parse.quote(project_id, safe="")
112
127
  query = urllib.parse.urlencode(
@@ -119,7 +134,10 @@ def _raw_snapshot(
119
134
  }
120
135
  )
121
136
  pipelines, pipeline_more = _read_page(
122
- f"{api_root}/projects/{project}/pipelines?{query}", token, deadline=deadline
137
+ f"{api_root}/projects/{project}/pipelines?{query}",
138
+ token,
139
+ deadline=deadline,
140
+ user_agent=user_agent,
123
141
  )
124
142
  if not isinstance(pipelines, list) or len(pipelines) > MAX_PIPELINES:
125
143
  raise GitLabProviderError("GitLab CI pipeline list is invalid")
@@ -144,6 +162,7 @@ def _raw_snapshot(
144
162
  f"?include_retried=true&per_page={MAX_JOBS_PER_PIPELINE}&page=1",
145
163
  token,
146
164
  deadline=deadline,
165
+ user_agent=user_agent,
147
166
  )
148
167
  if not isinstance(jobs, list) or len(jobs) > MAX_JOBS_PER_PIPELINE:
149
168
  raise GitLabProviderError("GitLab CI job list is invalid")