unique_web_search 2026.46.0.dev3__tar.gz → 2026.46.0.dev4__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 (129) hide show
  1. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/PKG-INFO +2 -2
  2. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/pyproject.toml +2 -2
  3. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/metrics.py +7 -0
  4. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/service.py +6 -1
  5. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/query_elicitation.py +67 -4
  6. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/README.md +0 -0
  7. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/__init__.py +0 -0
  8. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/client_settings.py +0 -0
  9. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/config.py +0 -0
  10. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/invocation_stats.py +0 -0
  11. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/prompts.py +0 -0
  12. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/schema.py +0 -0
  13. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/_registry.py +0 -0
  14. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/argument_screening/__init__.py +0 -0
  15. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/argument_screening/config.py +0 -0
  16. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/argument_screening/exceptions.py +0 -0
  17. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/argument_screening/prompts/__init__.py +0 -0
  18. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/argument_screening/prompts/guidelines.j2 +0 -0
  19. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/argument_screening/prompts/guidelines_with_keywords.j2 +0 -0
  20. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/argument_screening/prompts/rejection_response.j2 +0 -0
  21. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/argument_screening/prompts/system_prompt.j2 +0 -0
  22. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/argument_screening/prompts/user_prompt.j2 +0 -0
  23. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/argument_screening/service.py +0 -0
  24. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/client/http_client.py +0 -0
  25. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/content_processing/__init__.py +0 -0
  26. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/content_processing/cleaning/__init__.py +0 -0
  27. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/content_processing/cleaning/character_sanitize.py +0 -0
  28. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/content_processing/cleaning/clean.py +0 -0
  29. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/content_processing/cleaning/config.py +0 -0
  30. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/content_processing/config.py +0 -0
  31. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/content_processing/processing_strategies/base.py +0 -0
  32. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/content_processing/processing_strategies/config.py +0 -0
  33. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/content_processing/processing_strategies/llm_guard_judge.py +0 -0
  34. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/content_processing/processing_strategies/llm_keyword_redact.py +0 -0
  35. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/content_processing/processing_strategies/llm_process.py +0 -0
  36. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/content_processing/processing_strategies/prompts/__init__.py +0 -0
  37. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/content_processing/processing_strategies/prompts/judge_and_sanitize_prompt.j2 +0 -0
  38. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/content_processing/processing_strategies/prompts/judge_prompt.j2 +0 -0
  39. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/content_processing/processing_strategies/prompts/keyword_extract_prompt.j2 +0 -0
  40. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/content_processing/processing_strategies/prompts/page_context.j2 +0 -0
  41. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/content_processing/processing_strategies/prompts/sanitize_rules.j2 +0 -0
  42. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/content_processing/processing_strategies/prompts/system_prompt.j2 +0 -0
  43. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/content_processing/processing_strategies/prompts/user_prompt.j2 +0 -0
  44. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/content_processing/processing_strategies/schema.py +0 -0
  45. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/content_processing/processing_strategies/settings.py +0 -0
  46. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/content_processing/processing_strategies/truncate.py +0 -0
  47. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/content_processing/service.py +0 -0
  48. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/crawlers/README.md +0 -0
  49. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/crawlers/__init__.py +0 -0
  50. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/crawlers/base.py +0 -0
  51. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/crawlers/basic.py +0 -0
  52. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/crawlers/firecrawl.py +0 -0
  53. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/crawlers/jina.py +0 -0
  54. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/crawlers/registry.py +0 -0
  55. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/crawlers/tavily.py +0 -0
  56. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/crawlers/url_safety/__init__.py +0 -0
  57. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/crawlers/utils.py +0 -0
  58. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/README.md +0 -0
  59. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/__init__.py +0 -0
  60. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/base_config.py +0 -0
  61. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/base_executor.py +0 -0
  62. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/context.py +0 -0
  63. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/modes.py +0 -0
  64. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v1/__init__.py +0 -0
  65. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v1/config.py +0 -0
  66. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v1/executor.py +0 -0
  67. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v1/prompts/__init__.py +0 -0
  68. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v1/prompts/refine_query_system_prompt.j2 +0 -0
  69. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v1/prompts/tool_description.j2 +0 -0
  70. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v1/prompts/tool_description_for_system_prompt.j2 +0 -0
  71. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v1/schema.py +0 -0
  72. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v1/strategy.py +0 -0
  73. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v2/__init__.py +0 -0
  74. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v2/config.py +0 -0
  75. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v2/executor.py +0 -0
  76. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v2/prompts/__init__.py +0 -0
  77. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v2/prompts/step_query_description.j2 +0 -0
  78. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v2/prompts/tool_description.j2 +0 -0
  79. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v2/prompts/tool_description_for_system_prompt.j2 +0 -0
  80. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v2/schema.py +0 -0
  81. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v2/strategy.py +0 -0
  82. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v3/__init__.py +0 -0
  83. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v3/config.py +0 -0
  84. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v3/executor.py +0 -0
  85. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v3/prompts/__init__.py +0 -0
  86. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v3/prompts/tool_description.j2 +0 -0
  87. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v3/prompts/tool_description_for_system_prompt.j2 +0 -0
  88. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v3/schema.py +0 -0
  89. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/executors/v3/strategy.py +0 -0
  90. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/helpers.py +0 -0
  91. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/httpx_logging.py +0 -0
  92. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/message_log.py +0 -0
  93. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/proxy/__init__.py +0 -0
  94. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/proxy/bridge.py +0 -0
  95. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/proxy/mappers.py +0 -0
  96. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/README.md +0 -0
  97. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/__init__.py +0 -0
  98. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/base.py +0 -0
  99. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/bing.py +0 -0
  100. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/brave.py +0 -0
  101. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/custom_api.py +0 -0
  102. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/google.py +0 -0
  103. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/perplexity.py +0 -0
  104. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/registry.py +0 -0
  105. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/schema.py +0 -0
  106. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/utils/google/schema.py +0 -0
  107. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/utils/grounding/__init__.py +0 -0
  108. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/utils/grounding/bing/__init__.py +0 -0
  109. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/utils/grounding/bing/citation_instructions.j2 +0 -0
  110. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/utils/grounding/bing/citation_parsing.py +0 -0
  111. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/utils/grounding/bing/client.py +0 -0
  112. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/utils/grounding/bing/models.py +0 -0
  113. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/utils/grounding/bing/runner.py +0 -0
  114. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/utils/grounding/models.py +0 -0
  115. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/utils/grounding/response_parsing.py +0 -0
  116. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/utils/grounding/vertexai/__init__.py +0 -0
  117. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/utils/grounding/vertexai/client.py +0 -0
  118. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/utils/grounding/vertexai/exceptions.py +0 -0
  119. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/utils/grounding/vertexai/gemini.py +0 -0
  120. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/utils/grounding/vertexai/response_handler.py +0 -0
  121. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/search_engine/vertexai.py +0 -0
  122. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/snippet_judge/__init__.py +0 -0
  123. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/snippet_judge/prompts.py +0 -0
  124. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/snippet_judge/schema.py +0 -0
  125. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/snippet_judge/service.py +0 -0
  126. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/services/structured_llm.py +0 -0
  127. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/settings.py +0 -0
  128. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/skills/web-search-v3.md +0 -0
  129. {unique_web_search-2026.46.0.dev3 → unique_web_search-2026.46.0.dev4}/src/unique_web_search/utils.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.3
2
2
  Name: unique-web-search
3
- Version: 2026.46.0.dev3
3
+ Version: 2026.46.0.dev4
4
4
  Summary:
5
5
  Author: Andreas Hauri, Gustav Hartz, Rami Azouz
6
6
  Author-email: Andreas Hauri <andreas@unique.ch>, Gustav Hartz <gustav.hartz.ext@unique.ch>, Rami Azouz <rami.ext@unique.ch>
@@ -16,7 +16,7 @@ Requires-Dist: tavily-python>=0.7.11,<1
16
16
  Requires-Dist: unidecode>=1.4.0,<2
17
17
  Requires-Dist: azure-ai-projects>=2.3,<3
18
18
  Requires-Dist: azure-identity>=1.25.0,<2
19
- Requires-Dist: unique-toolkit[monitoring]>=2026.46.0.dev3,<2026.46.0rc0
19
+ Requires-Dist: unique-toolkit[monitoring]>=2026.46.0.dev8,<2026.46.0rc0
20
20
  Requires-Dist: azure-core>=1.36.0,<2
21
21
  Requires-Dist: google-cloud-aiplatform>=1.128.0,<2
22
22
  Requires-Dist: google-auth>=2.43.0,<3
@@ -1,6 +1,6 @@
1
1
  [project]
2
2
  name = "unique_web_search"
3
- version = "2026.46.0.dev3"
3
+ version = "2026.46.0.dev4"
4
4
  description = ""
5
5
  readme = "README.md"
6
6
  requires-python = ">=3.12,<4.0"
@@ -22,7 +22,7 @@ dependencies = [
22
22
  "unidecode>=1.4.0,<2",
23
23
  "azure-ai-projects>=2.3,<3",
24
24
  "azure-identity>=1.25.0,<2",
25
- "unique-toolkit[monitoring]>=2026.46.0.dev3,<2026.46.0rc0",
25
+ "unique-toolkit[monitoring]>=2026.46.0.dev8,<2026.46.0rc0",
26
26
  "azure-core>=1.36.0,<2",
27
27
  "google-cloud-aiplatform>=1.128.0,<2",
28
28
  "google-auth>=2.43.0,<3",
@@ -31,6 +31,13 @@ grounding_dropped_lines = m.counter(
31
31
  ["engine", "reason"],
32
32
  )
33
33
 
34
+ query_length = m.histogram(
35
+ "query_length_characters",
36
+ "Length of AI-proposed search queries, before Query Review shortens them",
37
+ ["engine", "query_review"],
38
+ buckets=[50, 100, 150, 200, 300, 400, 500, 750, 1000, 2000],
39
+ )
40
+
34
41
  # End-to-End Tool (P1)
35
42
  tool_duration = m.histogram(
36
43
  "tool_duration_seconds",
@@ -147,7 +147,11 @@ class WebSearchTool(Tool[WebSearchConfig]):
147
147
  )
148
148
 
149
149
  def tool_description_for_system_prompt(self) -> str:
150
- return self._mode_strategy.system_prompt(self._tool_context())
150
+ system_prompt = self._mode_strategy.system_prompt(self._tool_context())
151
+ instruction = self.config.query_elicitation_config.query_length_instruction()
152
+ if instruction is None:
153
+ return system_prompt
154
+ return f"{system_prompt}\n\n{instruction}"
151
155
 
152
156
  def tool_format_information_for_system_prompt(self) -> str:
153
157
  return self._mode_strategy.format_information_for_system_prompt(
@@ -273,6 +277,7 @@ class WebSearchTool(Tool[WebSearchConfig]):
273
277
  display_name=self.display_name(),
274
278
  config=self.config.query_elicitation_config,
275
279
  debug_info=debug_info,
280
+ engine=self.search_engine_service.config.engine.value,
276
281
  )
277
282
 
278
283
  services = ExecutorServiceContext(
@@ -6,9 +6,10 @@ allowing users to review and modify proposed search queries before execution.
6
6
 
7
7
  import asyncio
8
8
  import logging
9
- from typing import Self
9
+ from typing import Annotated, Self
10
10
 
11
11
  from pydantic import BaseModel, ConfigDict, Field, create_model
12
+ from unique_toolkit._common.pydantic.rjsf_tags import RJSFMetaTag
12
13
  from unique_toolkit._common.pydantic_helpers import get_configuration_dict
13
14
  from unique_toolkit.chat.service import ChatService
14
15
  from unique_toolkit.elicitation import (
@@ -20,6 +21,7 @@ from unique_toolkit.elicitation import (
20
21
  ElicitationStatus,
21
22
  )
22
23
 
24
+ from unique_web_search.metrics import query_length
23
25
  from unique_web_search.schema import WebSearchDebugInfo
24
26
 
25
27
  _LOGGER = logging.getLogger(__name__)
@@ -40,6 +42,34 @@ class QueryElicitationConfig(BaseModel):
40
42
  ge=1,
41
43
  le=300,
42
44
  )
45
+ max_query_length: Annotated[
46
+ int | None,
47
+ RJSFMetaTag(
48
+ {
49
+ "ui:field": "nullableActive",
50
+ "ui:fieldReplacesAnyOrOneOf": True,
51
+ "ui:widget": "updown",
52
+ "ui:options": {
53
+ "activeLabel": "Limit query length",
54
+ "activeValue": 200,
55
+ },
56
+ }
57
+ ),
58
+ ] = Field(
59
+ default=None,
60
+ title="Maximum Query Length",
61
+ description="Limits the number of characters in each search query.",
62
+ ge=1,
63
+ )
64
+
65
+ def query_length_instruction(self) -> str | None:
66
+ """Return the system-prompt sentence for the query length limit, or ``None`` when no limit applies."""
67
+ if not self.enable_elicitation or self.max_query_length is None:
68
+ return None
69
+ return (
70
+ f"Keep each search query under {self.max_query_length} characters. "
71
+ "Longer queries are cut off before the user reviews them."
72
+ )
43
73
 
44
74
 
45
75
  class QueryElicitationModel(BaseModel):
@@ -54,7 +84,9 @@ class QueryElicitationModel(BaseModel):
54
84
  queries: list[str] = Field(description="The queries to search the web for")
55
85
 
56
86
  @classmethod
57
- def create_model_with_default_queries(cls, queries: list[str]) -> type[Self]:
87
+ def create_model_with_default_queries(
88
+ cls, queries: list[str], max_length: int | None
89
+ ) -> type[Self]:
58
90
  """Create a model with default query values.
59
91
 
60
92
  This method dynamically creates a Pydantic model where the root field
@@ -64,6 +96,8 @@ class QueryElicitationModel(BaseModel):
64
96
 
65
97
  Args:
66
98
  queries: List of default query strings to pre-populate
99
+ max_length: Maximum number of characters per query, exposed to the
100
+ form as the items' ``maxLength``. ``None`` means no limit.
67
101
 
68
102
  Returns:
69
103
  A new model class with default values set
@@ -71,7 +105,7 @@ class QueryElicitationModel(BaseModel):
71
105
  model = create_model(
72
106
  cls.__name__,
73
107
  queries=(
74
- list[str],
108
+ list[Annotated[str, Field(max_length=max_length)]],
75
109
  Field(
76
110
  default=queries,
77
111
  ),
@@ -95,6 +129,7 @@ class QueryElicitationService:
95
129
  display_name: str,
96
130
  config: QueryElicitationConfig,
97
131
  debug_info: WebSearchDebugInfo,
132
+ engine: str,
98
133
  ):
99
134
  """Initialize the query elicitation service.
100
135
 
@@ -103,19 +138,29 @@ class QueryElicitationService:
103
138
  display_name: Display name for the tool in elicitation UI
104
139
  config: Elicitation configuration
105
140
  debug_info: Web search debug information updated with the outcome
141
+ engine: Search engine name, used as a metric label
106
142
  """
107
143
  self._chat_service = chat_service
108
144
  self._display_name = display_name
109
145
  self._config = config
110
146
  self._debug_info = debug_info
147
+ self._engine = engine
111
148
 
112
149
  async def __call__(self, queries: list[str]) -> list[str]:
150
+ self._record_query_lengths(queries)
151
+
113
152
  if not self._config.enable_elicitation:
114
153
  return queries
115
154
 
155
+ max_length = self._config.max_query_length
156
+ if max_length is not None:
157
+ queries = [query[:max_length] for query in queries]
158
+
116
159
  _LOGGER.info("Creating elicitation...")
117
160
 
118
- model = QueryElicitationModel.create_model_with_default_queries(queries)
161
+ model = QueryElicitationModel.create_model_with_default_queries(
162
+ queries, max_length
163
+ )
119
164
  elicitation = await self._chat_service.elicitation.create_async(
120
165
  mode=ElicitationMode.FORM,
121
166
  tool_name=self._display_name,
@@ -155,6 +200,16 @@ class QueryElicitationService:
155
200
  "Ask if they would like to retry the search with specific queries, or if they can describe what information they're looking for so you can help formulate appropriate search queries for the next approval.",
156
201
  )
157
202
 
203
+ if max_length is not None and any(
204
+ len(query) > max_length for query in submitted_queries
205
+ ):
206
+ raise ElicitationFailedException(
207
+ context=f"The user approved the web search request, but at least one search query is longer than the {max_length}-character limit.",
208
+ instruction="The web search tool did not execute. "
209
+ f"Tell the user that each search query can be at most {max_length} characters, "
210
+ "and ask them to retry with shorter queries.",
211
+ )
212
+
158
213
  return submitted_queries
159
214
 
160
215
  elif elicitation.status == ElicitationStatus.DECLINED:
@@ -172,3 +227,11 @@ class QueryElicitationService:
172
227
  raise ElicitationExpiredException(
173
228
  f"Query elicitation {elicitation.id} not accepted"
174
229
  )
230
+
231
+ def _record_query_lengths(self, queries: list[str]) -> None:
232
+ labels = query_length.labels(
233
+ engine=self._engine,
234
+ query_review=str(self._config.enable_elicitation).lower(),
235
+ )
236
+ for query in queries:
237
+ labels.observe(len(query))