databricks-tellr-app 0.5.2.dev3__tar.gz → 0.5.2.dev5__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 (253) hide show
  1. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/PKG-INFO +1 -1
  2. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/databricks_tellr_app.egg-info/PKG-INFO +1 -1
  3. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/pyproject.toml +1 -1
  4. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/services/session_manager.py +2 -0
  5. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/scope_errors.py +57 -10
  6. databricks_tellr_app-0.5.2.dev5/src/services/agent_tools/genie_one.py +496 -0
  7. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/agent_tools/registry.py +6 -3
  8. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/graph/nodes.py +128 -52
  9. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/utils/spotlight.py +12 -2
  10. databricks_tellr_app-0.5.2.dev3/src/services/agent_tools/genie_one.py +0 -286
  11. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/README.md +0 -0
  12. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/databricks_tellr_app/__init__.py +0 -0
  13. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/databricks_tellr_app/run.py +0 -0
  14. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/databricks_tellr_app.egg-info/SOURCES.txt +0 -0
  15. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/databricks_tellr_app.egg-info/dependency_links.txt +0 -0
  16. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/databricks_tellr_app.egg-info/requires.txt +0 -0
  17. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/databricks_tellr_app.egg-info/top_level.txt +0 -0
  18. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/setup.cfg +0 -0
  19. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/setup.py +0 -0
  20. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/__init__.py +0 -0
  21. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/__init__.py +0 -0
  22. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/_otel_bootstrap.py +0 -0
  23. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/fixtures/tour_demo_deck.json +0 -0
  24. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/main.py +0 -0
  25. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/mcp_auth.py +0 -0
  26. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/mcp_server.py +0 -0
  27. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/middleware/__init__.py +0 -0
  28. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/middleware/csrf.py +0 -0
  29. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/middleware/request_logging.py +0 -0
  30. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/middleware/security_headers.py +0 -0
  31. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/__init__.py +0 -0
  32. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/_authz.py +0 -0
  33. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/admin.py +0 -0
  34. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/admin_usage.py +0 -0
  35. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/agent_config.py +0 -0
  36. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/agent_definitions.py +0 -0
  37. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/chat.py +0 -0
  38. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/deck_contributors.py +0 -0
  39. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/export.py +0 -0
  40. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/feedback.py +0 -0
  41. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/google_slides.py +0 -0
  42. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/graph_shipping.py +0 -0
  43. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/images.py +0 -0
  44. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/local_version.py +0 -0
  45. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/profiles.py +0 -0
  46. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/sessions.py +0 -0
  47. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/settings/__init__.py +0 -0
  48. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/settings/contributors.py +0 -0
  49. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/settings/deck_prompts.py +0 -0
  50. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/settings/design_systems.py +0 -0
  51. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/settings/identities.py +0 -0
  52. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/settings/slide_styles.py +0 -0
  53. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/setup.py +0 -0
  54. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/slides.py +0 -0
  55. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/tools.py +0 -0
  56. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/tour.py +0 -0
  57. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/verification.py +0 -0
  58. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/routes/version.py +0 -0
  59. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/schemas/__init__.py +0 -0
  60. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/schemas/agent_config.py +0 -0
  61. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/schemas/agent_definitions.py +0 -0
  62. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/schemas/feedback.py +0 -0
  63. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/schemas/graph_release_history.py +0 -0
  64. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/schemas/graph_releases.py +0 -0
  65. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/schemas/requests.py +0 -0
  66. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/schemas/responses.py +0 -0
  67. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/schemas/settings/__init__.py +0 -0
  68. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/schemas/settings/requests.py +0 -0
  69. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/schemas/settings/responses.py +0 -0
  70. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/schemas/streaming.py +0 -0
  71. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/services/__init__.py +0 -0
  72. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/services/chat_service.py +0 -0
  73. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/services/deck_level_writer.py +0 -0
  74. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/services/export_job_queue.py +0 -0
  75. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/services/feedback_service.py +0 -0
  76. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/services/job_queue.py +0 -0
  77. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/services/session_naming.py +0 -0
  78. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/services/slide_repository.py +0 -0
  79. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/services/slide_style_preview_queue.py +0 -0
  80. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/services/usage_events.py +0 -0
  81. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/services/usage_service.py +0 -0
  82. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/utils/__init__.py +0 -0
  83. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/api/utils/validation.py +0 -0
  84. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/__init__.py +0 -0
  85. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/backfill_session_slides_startup.py +0 -0
  86. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/checkpointer.py +0 -0
  87. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/config_loader.py +0 -0
  88. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/context_utils.py +0 -0
  89. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/database.py +0 -0
  90. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/databricks_client.py +0 -0
  91. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/defaults.py +0 -0
  92. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/encryption.py +0 -0
  93. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/init_default_profile.py +0 -0
  94. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/lakebase.py +0 -0
  95. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/migrate_profiles_to_agent_config.py +0 -0
  96. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/mlflow_agent_spans.py +0 -0
  97. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/mlflow_tracing.py +0 -0
  98. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/otel_logging.py +0 -0
  99. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/permission_context.py +0 -0
  100. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/prompt_modules.py +0 -0
  101. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/settings_db.py +0 -0
  102. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/skills/__init__.py +0 -0
  103. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/skills/architect.py +0 -0
  104. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/skills/build_reviewer.py +0 -0
  105. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/skills/builder.py +0 -0
  106. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/skills/data_analyst.py +0 -0
  107. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/skills/deck_reviewer.py +0 -0
  108. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/skills/fix_reviewer.py +0 -0
  109. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/skills/fixer.py +0 -0
  110. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/strip_retired_prompt_keys.py +0 -0
  111. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/core/user_context.py +0 -0
  112. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/__init__.py +0 -0
  113. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/models/__init__.py +0 -0
  114. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/models/data_migration.py +0 -0
  115. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/models/deck_contributor.py +0 -0
  116. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/models/deck_review.py +0 -0
  117. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/models/design_system.py +0 -0
  118. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/models/encryption_key.py +0 -0
  119. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/models/feedback.py +0 -0
  120. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/models/genie_space.py +0 -0
  121. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/models/google_global_credentials.py +0 -0
  122. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/models/google_oauth_token.py +0 -0
  123. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/models/graph_checkpoint.py +0 -0
  124. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/models/graph_configuration.py +0 -0
  125. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/models/identity.py +0 -0
  126. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/models/image.py +0 -0
  127. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/models/profile.py +0 -0
  128. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/models/profile_contributor.py +0 -0
  129. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/models/prompts.py +0 -0
  130. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/models/request_log.py +0 -0
  131. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/models/session.py +0 -0
  132. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/models/slide_deck_prompt.py +0 -0
  133. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/models/slide_style_library.py +0 -0
  134. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/models/slide_style_preview.py +0 -0
  135. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/models/usage_event.py +0 -0
  136. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/models/user_preference.py +0 -0
  137. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/database/types.py +0 -0
  138. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/domain/__init__.py +0 -0
  139. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/domain/conversation_engine.py +0 -0
  140. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/domain/conversation_turns.py +0 -0
  141. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/domain/deck_spec.py +0 -0
  142. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/domain/deck_spec_slides.py +0 -0
  143. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/domain/finding.py +0 -0
  144. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/domain/finding_copy.py +0 -0
  145. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/domain/skill_io.py +0 -0
  146. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/domain/slide.py +0 -0
  147. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/domain/slide_alignment.py +0 -0
  148. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/domain/slide_deck.py +0 -0
  149. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/domain/slide_numbering.py +0 -0
  150. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/domain/slide_operations.py +0 -0
  151. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/__init__.py +0 -0
  152. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/agent.py +0 -0
  153. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/agent_definition_manifest_v1.py +0 -0
  154. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/agent_factory.py +0 -0
  155. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/agent_model_payload.py +0 -0
  156. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/agent_resolution.py +0 -0
  157. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/agent_runtime.py +0 -0
  158. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/agent_runtime_identity.py +0 -0
  159. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/agent_schema_registry.py +0 -0
  160. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/agent_schema_types.py +0 -0
  161. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/agent_test_workbench.py +0 -0
  162. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/agent_tools/__init__.py +0 -0
  163. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/agent_tools/toolset.py +0 -0
  164. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/collaboration_history.py +0 -0
  165. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/config_service.py +0 -0
  166. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/config_validator.py +0 -0
  167. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/conversation_pins.py +0 -0
  168. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/converter_jail/__init__.py +0 -0
  169. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/converter_jail/ast_guard.py +0 -0
  170. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/converter_jail/codeprep.py +0 -0
  171. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/converter_jail/gslides_runner.py +0 -0
  172. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/converter_jail/jail.py +0 -0
  173. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/converter_jail/pptx_runner.py +0 -0
  174. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/converter_jail/protocol.py +0 -0
  175. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/deck_css_aggregator.py +0 -0
  176. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/deck_review_store.py +0 -0
  177. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/design_system_compiler.py +0 -0
  178. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/design_system_service.py +0 -0
  179. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/design_system_templates.py +0 -0
  180. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/drive_uploader.py +0 -0
  181. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/evaluation/__init__.py +0 -0
  182. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/evaluation/llm_judge.py +0 -0
  183. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/foreman_service.py +0 -0
  184. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/gateway_openai.py +0 -0
  185. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/genie_service.py +0 -0
  186. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/google_slides_auth.py +0 -0
  187. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/google_slides_prompts_defaults.py +0 -0
  188. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/graph/__init__.py +0 -0
  189. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/graph/builder.py +0 -0
  190. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/graph/event_emitter.py +0 -0
  191. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/graph/progress.py +0 -0
  192. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/graph/routers.py +0 -0
  193. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/graph/state.py +0 -0
  194. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/graph/user_notices.py +0 -0
  195. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/graph_configuration.py +0 -0
  196. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/graph_configuration_bootstrap.py +0 -0
  197. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/graph_configuration_content.py +0 -0
  198. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/graph_configuration_draft.py +0 -0
  199. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/graph_configuration_publication.py +0 -0
  200. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/graph_configuration_rollback.py +0 -0
  201. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/graph_configuration_seed.py +0 -0
  202. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/graph_configuration_shipping.py +0 -0
  203. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/graph_configuration_workbench.py +0 -0
  204. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/graph_definition_manifest.py +0 -0
  205. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/graph_release_evidence.py +0 -0
  206. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/graph_release_history.py +0 -0
  207. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/html_to_google_slides.py +0 -0
  208. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/html_to_pptx.py +0 -0
  209. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/identity_provider.py +0 -0
  210. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/identity_providers/__init__.py +0 -0
  211. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/identity_providers/account_provider.py +0 -0
  212. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/identity_providers/local_provider.py +0 -0
  213. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/identity_providers/scim_filter.py +0 -0
  214. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/identity_providers/workspace_provider.py +0 -0
  215. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/image_service.py +0 -0
  216. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/image_tools.py +0 -0
  217. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/model_endpoint_catalog.py +0 -0
  218. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/model_endpoint_probe.py +0 -0
  219. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/permission_service.py +0 -0
  220. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/persisted_graph_release.py +0 -0
  221. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/pptx_from_html_huashu.py +0 -0
  222. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/pptx_from_records.py +0 -0
  223. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/pptx_prompts_defaults.py +0 -0
  224. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/profile_service.py +0 -0
  225. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/prompt_assembler.py +0 -0
  226. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/shared_deck_attribution.py +0 -0
  227. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/slide_style_preview_fixture.py +0 -0
  228. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/slide_style_preview_storage.py +0 -0
  229. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/spec_sync.py +0 -0
  230. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/streaming_callback.py +0 -0
  231. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/svg_sanitizer.py +0 -0
  232. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/template_sections.py +0 -0
  233. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/tools/__init__.py +0 -0
  234. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/tools/agent_bricks_tool.py +0 -0
  235. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/tools/ds_asset_tool.py +0 -0
  236. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/tools/genie_tool.py +0 -0
  237. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/tools/mcp_tool.py +0 -0
  238. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/tools/model_endpoint_tool.py +0 -0
  239. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/tools/vector_tool.py +0 -0
  240. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/services/validator.py +0 -0
  241. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/utils/__init__.py +0 -0
  242. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/utils/css_utils.py +0 -0
  243. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/utils/ds_asset_utils.py +0 -0
  244. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/utils/error_handling.py +0 -0
  245. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/utils/graph_safety.py +0 -0
  246. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/utils/html_safety.py +0 -0
  247. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/utils/html_utils.py +0 -0
  248. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/utils/image_utils.py +0 -0
  249. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/utils/js_validator.py +0 -0
  250. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/utils/logging_config.py +0 -0
  251. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/utils/pi_filter.py +0 -0
  252. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/utils/slide_hash.py +0 -0
  253. {databricks_tellr_app-0.5.2.dev3 → databricks_tellr_app-0.5.2.dev5}/src/utils/text_caps.py +0 -0
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: databricks-tellr-app
3
- Version: 0.5.2.dev3
3
+ Version: 0.5.2.dev5
4
4
  Summary: Tellr application package for Databricks Apps
5
5
  Requires-Python: >=3.10
6
6
  Description-Content-Type: text/markdown
@@ -1,6 +1,6 @@
1
1
  Metadata-Version: 2.4
2
2
  Name: databricks-tellr-app
3
- Version: 0.5.2.dev3
3
+ Version: 0.5.2.dev5
4
4
  Summary: Tellr application package for Databricks Apps
5
5
  Requires-Python: >=3.10
6
6
  Description-Content-Type: text/markdown
@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
4
4
 
5
5
  [project]
6
6
  name = "databricks-tellr-app"
7
- version = "0.5.2.dev3"
7
+ version = "0.5.2.dev5"
8
8
  description = "Tellr application package for Databricks Apps"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.10"
@@ -4218,6 +4218,8 @@ class SessionManager:
4218
4218
  "tool_input": metadata.get("tool_input"),
4219
4219
  "tool_output": msg["content"] if event_type == "tool_result" else None,
4220
4220
  "message_id": msg["id"],
4221
+ # Which agent spoke (the data analyst's report is drawn as its own card).
4222
+ "agent": metadata.get("agent"),
4221
4223
  # Only a failure notice's technical detail (#321) — never the row's whole
4222
4224
  # metadata, which for a tool row carries its input. None on every other
4223
4225
  # row, including every row persisted before notices had details.
@@ -13,6 +13,15 @@ _SCOPE_RE = re.compile(r"(required scopes|invalid scope)", re.I)
13
13
 
14
14
  _PLACEHOLDER_CLIENT_ID = "<this app's OAuth client ID>"
15
15
 
16
+ #: A token scoped ``all-apis`` (a CLI or PAT-style OAuth token) may call every
17
+ #: API, so it holds every narrower scope too.
18
+ _ALL_APIS_SCOPE = "all-apis"
19
+
20
+
21
+ def mentions_missing_scope(text: str) -> bool:
22
+ """True if *text* says a scope is missing (``required scopes`` / ``invalid scope``)."""
23
+ return _SCOPE_RE.search(text) is not None
24
+
16
25
 
17
26
  def is_missing_scope_error(exc: BaseException) -> bool:
18
27
  """True if exc, its cause/context chain or any exception group member mentions a missing scope."""
@@ -23,7 +32,7 @@ def is_missing_scope_error(exc: BaseException) -> bool:
23
32
  if id(current) in seen:
24
33
  continue
25
34
  seen.add(id(current))
26
- if _SCOPE_RE.search(str(current)):
35
+ if mentions_missing_scope(str(current)):
27
36
  return True
28
37
  if current.__cause__ is not None:
29
38
  stack.append(current.__cause__)
@@ -34,18 +43,24 @@ def is_missing_scope_error(exc: BaseException) -> bool:
34
43
  return False
35
44
 
36
45
 
46
+ def _jwt_payload(token: str | None) -> dict | None:
47
+ """The payload of a JWT, decoded WITHOUT verifying it; ``None`` if *token* is not one."""
48
+ if not token:
49
+ return None
50
+ parts = token.split(".")
51
+ if len(parts) != 3:
52
+ return None
53
+ segment = parts[1]
54
+ segment += "=" * (-len(segment) % 4)
55
+ payload = json.loads(base64.urlsafe_b64decode(segment.encode("ascii")))
56
+ return payload if isinstance(payload, dict) else None
57
+
58
+
37
59
  def oauth_client_id_from_token(token: str | None) -> str | None:
38
60
  """Read client_id (else azp) from a JWT payload without verifying it. Never raises."""
39
61
  try:
40
- if not token:
41
- return None
42
- parts = token.split(".")
43
- if len(parts) != 3:
44
- return None
45
- segment = parts[1]
46
- segment += "=" * (-len(segment) % 4)
47
- payload = json.loads(base64.urlsafe_b64decode(segment.encode("ascii")))
48
- if not isinstance(payload, dict):
62
+ payload = _jwt_payload(token)
63
+ if payload is None:
49
64
  return None
50
65
  value = payload.get("client_id") or payload.get("azp")
51
66
  return value if isinstance(value, str) and value else None
@@ -53,6 +68,38 @@ def oauth_client_id_from_token(token: str | None) -> str | None:
53
68
  return None
54
69
 
55
70
 
71
+ def oauth_scopes_from_token(token: str | None) -> frozenset[str] | None:
72
+ """The OAuth scopes a JWT says it carries, read WITHOUT verifying it. Never raises.
73
+
74
+ Reads the ``scope`` claim (else ``scp``): a space-separated string or a list
75
+ of strings. ``None`` means "not known": *token* is not a JWT, or neither
76
+ claim names a scope. Callers act only on a known set, so an unreadable
77
+ token is never refused for a scope it may well have.
78
+ """
79
+ try:
80
+ payload = _jwt_payload(token)
81
+ if payload is None:
82
+ return None
83
+ for claim in ("scope", "scp"):
84
+ value = payload.get(claim)
85
+ if isinstance(value, str):
86
+ scopes = value.split()
87
+ elif isinstance(value, list):
88
+ scopes = [s for item in value if isinstance(item, str) for s in item.split()]
89
+ else:
90
+ continue
91
+ if scopes:
92
+ return frozenset(scopes)
93
+ return None
94
+ except Exception:
95
+ return None
96
+
97
+
98
+ def scopes_grant(scopes: frozenset[str], scope: str) -> bool:
99
+ """True if a token carrying *scopes* holds *scope* (``all-apis`` holds every scope)."""
100
+ return scope in scopes or _ALL_APIS_SCOPE in scopes
101
+
102
+
56
103
  def consent_message(*, oauth_client_id: str | None) -> str:
57
104
  client_id = oauth_client_id or _PLACEHOLDER_CLIENT_ID
58
105
  return (
@@ -0,0 +1,496 @@
1
+ """Genie One MCP client (ask / poll / result / cancel), deterministic figures and model text.
2
+
3
+ Calls the AI Gateway Genie One MCP service as the user. Figures are built from
4
+ result rows, never from model prose.
5
+ """
6
+
7
+ from __future__ import annotations
8
+
9
+ import asyncio
10
+ import builtins
11
+ import logging
12
+ import re
13
+ import threading
14
+ import time
15
+ from collections.abc import AsyncGenerator, Callable, Generator
16
+ from concurrent.futures import ThreadPoolExecutor
17
+ from concurrent.futures import TimeoutError as FuturesTimeoutError
18
+ from dataclasses import dataclass
19
+ from typing import Any, Final, Literal, Protocol
20
+
21
+ import httpx
22
+ from databricks.sdk.errors import PermissionDenied
23
+
24
+ from src.core.scope_errors import is_missing_scope_error, mentions_missing_scope, scopes_grant
25
+ from src.domain.deck_spec import ResolvedFigure
26
+ from src.utils.spotlight import neutralize_delimiters
27
+
28
+ logger = logging.getLogger(__name__)
29
+
30
+ GENIE_ONE_SERVICE_PATH: Final = "/ai-gateway/mcp-services/system.ai.genie_one_mcp"
31
+ GENIE_ONE_SOURCE: Final = "Genie One"
32
+ #: The OAuth scope the AI Gateway requires of the user's token.
33
+ GENIE_ONE_SCOPE: Final = "ai-gateway"
34
+
35
+ #: The longest any one MCP call may take.
36
+ _CALL_TIMEOUT_SECONDS: Final = 60
37
+ #: Within a question, a call gets what is left of its deadline plus this much, so
38
+ #: a cancel or a result fetch made at the deadline still has time to answer.
39
+ _CALL_GRACE_SECONDS: Final = 10
40
+ #: How much of an error response's body is searched for a scope message.
41
+ _ERROR_BODY_CHARS: Final = 500
42
+ _DENIED_RE: Final = re.compile(r"\b403\b|Forbidden|PERMISSION_DENIED")
43
+ _GROUP: Final = getattr(builtins, "BaseExceptionGroup", ())
44
+ _COMMENT_RE = re.compile(r"<!--.*?-->", re.DOTALL)
45
+
46
+
47
+ class GenieOneError(Exception):
48
+ """A Genie One call failed."""
49
+
50
+
51
+ class GenieOneAccessError(GenieOneError):
52
+ """The user cannot use Genie One (missing OAuth scope or no access)."""
53
+
54
+ def __init__(self, message: str, *, kind: Literal["missing_scope", "access_denied"]) -> None:
55
+ super().__init__(message)
56
+ self.kind = kind
57
+
58
+
59
+ @dataclass(frozen=True)
60
+ class GenieOneQueryResult:
61
+ item_id: str
62
+ sql: str | None
63
+ columns: tuple[str, ...]
64
+ rows: tuple[tuple[str | None, ...], ...]
65
+ total_row_count: int | None
66
+ truncated: bool
67
+
68
+
69
+ @dataclass(frozen=True)
70
+ class GenieOneAnswer:
71
+ conversation_id: str
72
+ response_id: str
73
+ status: Literal["completed", "incomplete", "failed", "timed_out"]
74
+ final_answer: str | None
75
+ deep_link: str | None
76
+ query_results: tuple[GenieOneQueryResult, ...]
77
+
78
+
79
+ class CallTool(Protocol):
80
+ """Calls one Genie One MCP tool and returns mcp's ``CallToolResult``.
81
+
82
+ ``timeout_seconds`` bounds the call; past it, the call raises ``GenieOneError``.
83
+ """
84
+
85
+ def __call__(self, name: str, args: dict[str, Any], *, timeout_seconds: float) -> Any: ...
86
+
87
+
88
+ def _walk(exc: BaseException):
89
+ seen: set[int] = set()
90
+ stack = [exc]
91
+ while stack:
92
+ cur = stack.pop()
93
+ if id(cur) in seen:
94
+ continue
95
+ seen.add(id(cur))
96
+ yield cur
97
+ for nxt in (cur.__cause__, cur.__context__):
98
+ if nxt is not None:
99
+ stack.append(nxt)
100
+ if _GROUP and isinstance(cur, _GROUP):
101
+ stack.extend(cur.exceptions)
102
+
103
+
104
+ def _has_denied_marker(text: str) -> bool:
105
+ return _DENIED_RE.search(text) is not None
106
+
107
+
108
+ def _http_status(exc: BaseException) -> int | None:
109
+ """The HTTP status an exception carries (``httpx.HTTPStatusError``), else ``None``."""
110
+ status = getattr(getattr(exc, "response", None), "status_code", None)
111
+ return status if isinstance(status, int) else None
112
+
113
+
114
+ def _error_body(exc: BaseException) -> str:
115
+ """The error response's body, if the call path read it (``""`` otherwise)."""
116
+ try:
117
+ text = exc.response.text # type: ignore[attr-defined]
118
+ except Exception: # noqa: BLE001 - no response, or a streamed body nobody read
119
+ return ""
120
+ return text[:_ERROR_BODY_CHARS] if isinstance(text, str) else ""
121
+
122
+
123
+ def _leaf(exc: BaseException) -> BaseException:
124
+ """The exception that says what failed: the first in the walk with an HTTP
125
+ status, else the first that is neither a group nor a cancellation."""
126
+ fallback: BaseException | None = None
127
+ for cur in _walk(exc):
128
+ if _http_status(cur) is not None:
129
+ return cur
130
+ if fallback is None and not (
131
+ (_GROUP and isinstance(cur, _GROUP)) or isinstance(cur, asyncio.CancelledError)
132
+ ):
133
+ fallback = cur
134
+ return fallback or exc
135
+
136
+
137
+ def _describe(exc: BaseException) -> str:
138
+ """``"<leaf type> (HTTP <status>): <leaf text>"``: what an error message says."""
139
+ leaf = _leaf(exc)
140
+ status = _http_status(leaf)
141
+ head = type(leaf).__name__ + (f" (HTTP {status})" if status is not None else "")
142
+ text = str(leaf)
143
+ return f"{head}: {text}" if text else head
144
+
145
+
146
+ def _map_exception(exc: BaseException, *, lacks_gateway_scope: bool) -> GenieOneError:
147
+ """Classify a failed call; every rule looks at the whole cause/context/group walk.
148
+
149
+ 1. A scope message, in any exception's text or in an error body: missing
150
+ scope. (Its text also says "403 Forbidden", so it is checked first.)
151
+ 2. Any HTTP 401: missing scope.
152
+ 3. A 403 (the status, an SDK ``PermissionDenied``, or "403" / "Forbidden" /
153
+ "PERMISSION_DENIED" in the text): missing scope when the token's scopes
154
+ are known and lack ``ai-gateway`` (*lacks_gateway_scope*), else a denied
155
+ grant. Unknown scopes leave a 403 a denied grant.
156
+ """
157
+ if isinstance(exc, GenieOneError):
158
+ return exc
159
+ message = _describe(exc)
160
+ chain = list(_walk(exc))
161
+ if is_missing_scope_error(exc) or any(mentions_missing_scope(_error_body(c)) for c in chain):
162
+ return GenieOneAccessError(message, kind="missing_scope")
163
+ if any(_http_status(c) == 401 for c in chain):
164
+ return GenieOneAccessError(message, kind="missing_scope")
165
+ if any(
166
+ _http_status(c) == 403 or isinstance(c, PermissionDenied) or _has_denied_marker(str(c))
167
+ for c in chain
168
+ ):
169
+ kind: Literal["missing_scope", "access_denied"] = (
170
+ "missing_scope" if lacks_gateway_scope else "access_denied"
171
+ )
172
+ return GenieOneAccessError(message, kind=kind)
173
+ return GenieOneError(message)
174
+
175
+
176
+ class _UserBearerAuth(httpx.Auth):
177
+ """The signed-in user's token on every request, and nothing else.
178
+
179
+ It replaces databricks_mcp's ``DatabricksOAuthClientProvider``, which answers
180
+ a 401 by starting an OAuth discovery flow (from an empty server URL) that dies
181
+ on an unrelated ``httpx`` error, so a missing scope could not be told apart
182
+ from any other failure. Here a 401 or a 403 surfaces as
183
+ ``httpx.HTTPStatusError`` with its status; an error body is read first,
184
+ because ``raise_for_status`` leaves a streamed body unread and a scope message
185
+ in it would be lost. Only the header is read from the workspace client
186
+ (static for a ``pat`` client), so one instance is safe to share across threads.
187
+ """
188
+
189
+ def __init__(self, workspace_client: Any) -> None:
190
+ self._workspace_client = workspace_client
191
+
192
+ def auth_flow(self, request: httpx.Request) -> Generator[httpx.Request, httpx.Response, None]:
193
+ request.headers.update(self._workspace_client.config.authenticate())
194
+ yield request
195
+
196
+ async def async_auth_flow(
197
+ self, request: httpx.Request
198
+ ) -> AsyncGenerator[httpx.Request, httpx.Response]:
199
+ request.headers.update(self._workspace_client.config.authenticate())
200
+ response = yield request
201
+ if response.status_code >= 400:
202
+ await response.aread()
203
+
204
+
205
+ def _build_mcp_client(host: str, token: str) -> Any:
206
+ """A ``DatabricksMCPClient`` for Genie One, as the user whose ``host`` and ``token`` these are.
207
+
208
+ Imported here, not at module level: the MCP stack is needed only when a
209
+ question is actually asked.
210
+ """
211
+ from databricks.sdk import WorkspaceClient
212
+ from databricks_mcp import DatabricksMCPClient
213
+ from mcp.client.session import ClientSession
214
+ from mcp.client.streamable_http import streamable_http_client
215
+
216
+ class _GenieOneMCPClient(DatabricksMCPClient):
217
+ """``DatabricksMCPClient`` with :class:`_UserBearerAuth` in place of its OAuth provider.
218
+
219
+ The same session as the base's ``_call_tools_async``; only the auth
220
+ differs. ``call_tool`` (its ``asyncio.run`` and error handling) is the base's.
221
+ """
222
+
223
+ async def _call_tools_async(
224
+ self, tool_name: str, arguments: dict[str, Any] | None = None
225
+ ) -> Any:
226
+ async with httpx.AsyncClient(
227
+ auth=_UserBearerAuth(self.client),
228
+ timeout=httpx.Timeout(30, read=300),
229
+ follow_redirects=True,
230
+ ) as http_client:
231
+ async with streamable_http_client(self.server_url, http_client=http_client) as (
232
+ read_stream,
233
+ write_stream,
234
+ _,
235
+ ):
236
+ async with ClientSession(read_stream, write_stream) as session:
237
+ await session.initialize()
238
+ return await session.call_tool(tool_name, arguments)
239
+
240
+ workspace_client = WorkspaceClient(host=host, token=token, auth_type="pat")
241
+ return _GenieOneMCPClient(
242
+ server_url=f"{host}{GENIE_ONE_SERVICE_PATH}", workspace_client=workspace_client
243
+ )
244
+
245
+
246
+ class _McpCallTool:
247
+ """The real call path: each call in a clean worker thread, with a timeout.
248
+
249
+ The thread is needed because ``DatabricksMCPClient`` calls ``asyncio.run``,
250
+ which cannot run inside a running event loop. The MCP client, and the
251
+ ``WorkspaceClient`` inside it, are built ONCE per instance (so once per
252
+ ``GenieOneClient``), inside the first call's worker thread so that call's
253
+ timeout also covers the host-metadata fetch construction makes, and are then
254
+ reused by every later call. Reuse across threads is safe: each call runs its
255
+ own event loop and HTTP client, and the workspace client is only asked for the
256
+ user's static bearer header.
257
+ """
258
+
259
+ def __init__(self, host: str, token: str) -> None:
260
+ self._host = host
261
+ self._token = token
262
+ self._lock = threading.Lock()
263
+ self._client: Any = None
264
+
265
+ def _mcp_client(self) -> Any:
266
+ with self._lock:
267
+ if self._client is None:
268
+ self._client = _build_mcp_client(self._host, self._token)
269
+ return self._client
270
+
271
+ def __call__(
272
+ self, name: str, args: dict[str, Any], *, timeout_seconds: float = _CALL_TIMEOUT_SECONDS
273
+ ) -> Any:
274
+ def run() -> Any:
275
+ return self._mcp_client().call_tool(name, args)
276
+
277
+ # Not a `with` block: its exit would wait on a timed-out thread.
278
+ executor = ThreadPoolExecutor(max_workers=1)
279
+ try:
280
+ return executor.submit(run).result(timeout=timeout_seconds)
281
+ except FuturesTimeoutError as exc:
282
+ raise GenieOneError(
283
+ f"Genie One did not respond within {timeout_seconds:g} seconds"
284
+ ) from exc
285
+ finally:
286
+ executor.shutdown(wait=False)
287
+
288
+
289
+ def _default_call_tool(host: str, token: str) -> CallTool:
290
+ return _McpCallTool(host, token)
291
+
292
+
293
+ def _result_text(result: Any) -> str:
294
+ parts = [getattr(item, "text", None) for item in (getattr(result, "content", None) or [])]
295
+ return "\n".join(p for p in parts if isinstance(p, str))
296
+
297
+
298
+ class GenieOneClient:
299
+ """Asks Genie One one question at a time, as one user.
300
+
301
+ ``token_scopes`` are the scopes the user's token says it carries
302
+ (``oauth_scopes_from_token``), or ``None`` if unknown; with a known set that
303
+ lacks ``ai-gateway``, a gateway 403 is a missing scope, not a denied grant.
304
+ """
305
+
306
+ def __init__(
307
+ self,
308
+ *,
309
+ host: str,
310
+ token: str,
311
+ call_tool: CallTool | None = None,
312
+ sleep: Callable[[float], None] = time.sleep,
313
+ clock: Callable[[], float] = time.monotonic,
314
+ poll_interval_seconds: float = 3.0,
315
+ token_scopes: frozenset[str] | None = None,
316
+ ) -> None:
317
+ self._call_tool = call_tool or _default_call_tool(host, token)
318
+ self._sleep = sleep
319
+ self._clock = clock
320
+ self._poll_interval = poll_interval_seconds
321
+ self._lacks_gateway_scope = token_scopes is not None and not scopes_grant(
322
+ token_scopes, GENIE_ONE_SCOPE
323
+ )
324
+
325
+ def _timeout_for(self, deadline: float | None) -> float:
326
+ """A call's timeout: at most 60 s, and no longer than the deadline plus the grace."""
327
+ if deadline is None:
328
+ return _CALL_TIMEOUT_SECONDS
329
+ remaining = max(0.0, deadline - self._clock())
330
+ return min(_CALL_TIMEOUT_SECONDS, remaining + _CALL_GRACE_SECONDS)
331
+
332
+ def _call(
333
+ self, name: str, args: dict[str, Any], *, deadline: float | None = None
334
+ ) -> dict[str, Any]:
335
+ """Call a tool and return its structuredContent. Raise GenieOneError on failure."""
336
+ try:
337
+ result = self._call_tool(name, args, timeout_seconds=self._timeout_for(deadline))
338
+ except Exception as exc:
339
+ mapped = _map_exception(exc, lacks_gateway_scope=self._lacks_gateway_scope)
340
+ logger.warning("Genie One %s failed: %s", name, mapped, exc_info=exc)
341
+ if mapped is exc:
342
+ raise
343
+ raise mapped from exc
344
+ if getattr(result, "isError", False):
345
+ text = _result_text(result)
346
+ # A scope message first: it may also say 403.
347
+ if mentions_missing_scope(text):
348
+ raise GenieOneAccessError(text, kind="missing_scope")
349
+ if _has_denied_marker(text):
350
+ raise GenieOneAccessError(text, kind="access_denied")
351
+ raise GenieOneError(text)
352
+ structured = getattr(result, "structuredContent", None)
353
+ return structured if isinstance(structured, dict) else {}
354
+
355
+ def ask(
356
+ self, question: str, *, conversation_id: str | None, timeout_seconds: float
357
+ ) -> GenieOneAnswer:
358
+ deadline = self._clock() + timeout_seconds
359
+ args: dict[str, Any] = {"question": question}
360
+ if conversation_id:
361
+ args["conversation_id"] = conversation_id
362
+ started = self._call("genie_ask", args, deadline=deadline)
363
+ conv_id = started.get("conversation_id") or conversation_id or ""
364
+ response_id = started.get("response_id") or ""
365
+ ids = {"conversation_id": conv_id, "response_id": response_id}
366
+
367
+ while True:
368
+ try:
369
+ polled = self._call("genie_poll_response", dict(ids), deadline=deadline)
370
+ except GenieOneError:
371
+ # The question may still be running: stop it (best effort).
372
+ self._cancel(conv_id, deadline=deadline)
373
+ raise
374
+ status = polled.get("status")
375
+ if status != "in_progress":
376
+ break
377
+ if self._clock() >= deadline:
378
+ self._cancel(conv_id, deadline=deadline)
379
+ return GenieOneAnswer(conv_id, response_id, "timed_out", None, None, ())
380
+ self._sleep(self._poll_interval)
381
+
382
+ results: list[GenieOneQueryResult] = []
383
+ if status == "completed":
384
+ for item in polled.get("query_items") or []:
385
+ fetched = self._fetch_item(ids, item, deadline=deadline)
386
+ if fetched is not None:
387
+ results.append(fetched)
388
+ return GenieOneAnswer(
389
+ conversation_id=conv_id,
390
+ response_id=response_id,
391
+ status=status, # type: ignore[arg-type]
392
+ final_answer=polled.get("final_answer"),
393
+ deep_link=polled.get("deep_link"),
394
+ query_results=tuple(results),
395
+ )
396
+
397
+ def _cancel(self, conversation_id: str, *, deadline: float | None = None) -> None:
398
+ try:
399
+ self._call(
400
+ "genie_cancel_response", {"conversation_id": conversation_id}, deadline=deadline
401
+ )
402
+ except Exception:
403
+ logger.warning("Genie One cancel failed (ignored)", exc_info=True)
404
+
405
+ def _fetch_item(
406
+ self, ids: dict[str, str], item: dict[str, Any], *, deadline: float | None = None
407
+ ) -> GenieOneQueryResult | None:
408
+ item_id = item.get("item_id", "")
409
+ try:
410
+ data = self._call(
411
+ "genie_get_query_result", {**ids, "item_id": item_id}, deadline=deadline
412
+ )
413
+ except GenieOneAccessError:
414
+ raise
415
+ except GenieOneError as exc:
416
+ logger.warning("Genie One query result %s skipped: %s", item_id, exc)
417
+ return None
418
+ return GenieOneQueryResult(
419
+ item_id=item_id,
420
+ sql=item.get("sql"),
421
+ columns=tuple(c.get("name", "") for c in data.get("columns") or []),
422
+ rows=tuple(tuple(r) for r in data.get("rows") or []),
423
+ total_row_count=data.get("total_row_count"),
424
+ truncated=bool(data.get("truncated")),
425
+ )
426
+
427
+
428
+ def _cell(value: str | None) -> str:
429
+ return "null" if value is None else str(value)
430
+
431
+
432
+ def _label_width(result: GenieOneQueryResult) -> int:
433
+ """Shortest count of leading columns whose values are unique per row (0 if none)."""
434
+ for k in range(1, len(result.columns)):
435
+ labels = [tuple(row[:k]) for row in result.rows]
436
+ if len(set(labels)) == len(labels):
437
+ return k
438
+ return 0
439
+
440
+
441
+ def figures_from_answer(answer: GenieOneAnswer, *, max_figures: int = 60) -> list[ResolvedFigure]:
442
+ figures: list[ResolvedFigure] = []
443
+ taken: set[str] = set()
444
+
445
+ for n, result in enumerate(answer.query_results, start=1):
446
+ if not result.rows or not result.columns:
447
+ continue
448
+ cols = result.columns
449
+ pairs: list[tuple[str, str | None]] = []
450
+ if len(result.rows) == 1:
451
+ pairs = list(zip(cols, result.rows[0], strict=False))
452
+ elif len(cols) >= 2:
453
+ k = _label_width(result)
454
+ for i, row in enumerate(result.rows):
455
+ cells = list(zip(cols, row, strict=False))
456
+ if k:
457
+ label = ", ".join(f"{c}={_cell(v)}" for c, v in cells[:k])
458
+ pairs.extend((f"{col} ({label})", cell) for col, cell in cells[k:])
459
+ else:
460
+ pairs.extend((f"{col} [{i + 1}]", cell) for col, cell in cells[1:])
461
+ else:
462
+ pairs = [(f"{cols[0]} [{i + 1}]", row[0]) for i, row in enumerate(result.rows)]
463
+
464
+ for key, cell in pairs:
465
+ if len(figures) >= max_figures:
466
+ return figures
467
+ # Column names and cells are Genie One's output: no figure may carry a
468
+ # real <untrusted-data> delimiter into a later spotlighted payload.
469
+ key = neutralize_delimiters(key)
470
+ if key in taken:
471
+ key = f"{key} (query {n})"
472
+ taken.add(key)
473
+ figures.append(
474
+ ResolvedFigure(
475
+ key=key, value=neutralize_delimiters(_cell(cell)), source=GENIE_ONE_SOURCE
476
+ )
477
+ )
478
+ return figures
479
+
480
+
481
+ def render_answer_for_model(answer: GenieOneAnswer, *, max_rows: int = 50) -> str:
482
+ lines = [f"Status: {answer.status}"]
483
+ if answer.final_answer:
484
+ lines += ["", _COMMENT_RE.sub("", answer.final_answer).strip()]
485
+ for result in answer.query_results:
486
+ lines.append("")
487
+ if result.sql:
488
+ lines.append(f"SQL: {result.sql}")
489
+ lines.append("| " + " | ".join(result.columns) + " |")
490
+ lines.append("| " + " | ".join("---" for _ in result.columns) + " |")
491
+ for row in result.rows[:max_rows]:
492
+ lines.append("| " + " | ".join(_cell(c) for c in row) + " |")
493
+ total = result.total_row_count if result.total_row_count is not None else len(result.rows)
494
+ if len(result.rows) > max_rows or total > max_rows:
495
+ lines.append(f"(showing {min(max_rows, len(result.rows))} of {total} rows)")
496
+ return "\n".join(lines)
@@ -27,6 +27,7 @@ from typing import Final
27
27
  from pydantic import BaseModel, Field
28
28
 
29
29
  from src.api.schemas.agent_config import AgentConfig, GenieOneTool
30
+ from src.core.scope_errors import oauth_scopes_from_token
30
31
  from src.services.agent_tools.genie_one import (
31
32
  GenieOneAccessError,
32
33
  GenieOneAnswer,
@@ -154,14 +155,16 @@ def build_analyst_toolset(
154
155
  ) -> tuple[AgentToolset, GenieOneAgentTool] | None:
155
156
  """The data analyst's toolset for *agent_config*, or ``None`` without Genie One.
156
157
 
157
- The client runs as the user whose ``host`` and ``token`` these are; the
158
- stored ``conversation_id`` (that row's own) is continued.
158
+ The client runs as the user whose ``host`` and ``token`` these are, and
159
+ knows the scopes that token says it carries (so a gateway 403 for a token
160
+ without ``ai-gateway`` is a missing scope); the stored ``conversation_id``
161
+ (that row's own) is continued.
159
162
  """
160
163
  entry = next((t for t in agent_config.tools if isinstance(t, GenieOneTool)), None)
161
164
  if entry is None:
162
165
  return None
163
166
  tool = GenieOneAgentTool(
164
- GenieOneClient(host=host, token=token),
167
+ GenieOneClient(host=host, token=token, token_scopes=oauth_scopes_from_token(token)),
165
168
  conversation_id=entry.conversation_id,
166
169
  on_question=on_question,
167
170
  session_id=session_id,