databricks-tellr-app 0.4.3.dev3448__tar.gz → 0.4.3.dev3450__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 (232) hide show
  1. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/PKG-INFO +1 -1
  2. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/databricks_tellr_app.egg-info/PKG-INFO +1 -1
  3. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/pyproject.toml +1 -1
  4. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/_authz.py +40 -0
  5. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/sessions.py +53 -4
  6. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/services/chat_service.py +119 -28
  7. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/services/session_manager.py +7 -1
  8. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/checkpointer.py +24 -4
  9. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/database/models/usage_event.py +2 -1
  10. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/domain/conversation_engine.py +12 -0
  11. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/spec_sync.py +18 -0
  12. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/README.md +0 -0
  13. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/databricks_tellr_app/__init__.py +0 -0
  14. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/databricks_tellr_app/run.py +0 -0
  15. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/databricks_tellr_app.egg-info/SOURCES.txt +0 -0
  16. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/databricks_tellr_app.egg-info/dependency_links.txt +0 -0
  17. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/databricks_tellr_app.egg-info/requires.txt +0 -0
  18. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/databricks_tellr_app.egg-info/top_level.txt +0 -0
  19. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/setup.cfg +0 -0
  20. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/setup.py +0 -0
  21. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/__init__.py +0 -0
  22. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/__init__.py +0 -0
  23. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/_otel_bootstrap.py +0 -0
  24. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/fixtures/tour_demo_deck.json +0 -0
  25. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/main.py +0 -0
  26. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/mcp_auth.py +0 -0
  27. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/mcp_server.py +0 -0
  28. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/middleware/__init__.py +0 -0
  29. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/middleware/csrf.py +0 -0
  30. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/middleware/request_logging.py +0 -0
  31. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/middleware/security_headers.py +0 -0
  32. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/__init__.py +0 -0
  33. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/admin.py +0 -0
  34. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/admin_usage.py +0 -0
  35. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/agent_config.py +0 -0
  36. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/agent_definitions.py +0 -0
  37. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/chat.py +0 -0
  38. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/deck_contributors.py +0 -0
  39. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/export.py +0 -0
  40. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/feedback.py +0 -0
  41. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/google_slides.py +0 -0
  42. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/images.py +0 -0
  43. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/local_version.py +0 -0
  44. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/profiles.py +0 -0
  45. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/settings/__init__.py +0 -0
  46. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/settings/contributors.py +0 -0
  47. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/settings/deck_prompts.py +0 -0
  48. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/settings/design_systems.py +0 -0
  49. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/settings/identities.py +0 -0
  50. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/settings/slide_styles.py +0 -0
  51. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/setup.py +0 -0
  52. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/slides.py +0 -0
  53. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/tools.py +0 -0
  54. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/tour.py +0 -0
  55. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/verification.py +0 -0
  56. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/routes/version.py +0 -0
  57. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/schemas/__init__.py +0 -0
  58. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/schemas/agent_config.py +0 -0
  59. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/schemas/agent_definitions.py +0 -0
  60. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/schemas/feedback.py +0 -0
  61. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/schemas/graph_release_history.py +0 -0
  62. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/schemas/graph_releases.py +0 -0
  63. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/schemas/requests.py +0 -0
  64. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/schemas/responses.py +0 -0
  65. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/schemas/settings/__init__.py +0 -0
  66. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/schemas/settings/requests.py +0 -0
  67. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/schemas/settings/responses.py +0 -0
  68. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/schemas/streaming.py +0 -0
  69. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/services/__init__.py +0 -0
  70. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/services/deck_level_writer.py +0 -0
  71. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/services/export_job_queue.py +0 -0
  72. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/services/feedback_service.py +0 -0
  73. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/services/job_queue.py +0 -0
  74. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/services/session_naming.py +0 -0
  75. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/services/slide_repository.py +0 -0
  76. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/services/usage_events.py +0 -0
  77. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/services/usage_service.py +0 -0
  78. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/utils/__init__.py +0 -0
  79. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/api/utils/validation.py +0 -0
  80. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/__init__.py +0 -0
  81. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/backfill_session_slides_startup.py +0 -0
  82. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/config_loader.py +0 -0
  83. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/context_utils.py +0 -0
  84. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/database.py +0 -0
  85. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/databricks_client.py +0 -0
  86. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/defaults.py +0 -0
  87. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/encryption.py +0 -0
  88. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/init_default_profile.py +0 -0
  89. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/lakebase.py +0 -0
  90. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/migrate_profiles_to_agent_config.py +0 -0
  91. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/mlflow_agent_spans.py +0 -0
  92. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/mlflow_tracing.py +0 -0
  93. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/otel_logging.py +0 -0
  94. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/permission_context.py +0 -0
  95. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/prompt_modules.py +0 -0
  96. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/settings_db.py +0 -0
  97. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/skills/__init__.py +0 -0
  98. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/skills/architect.py +0 -0
  99. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/skills/build_reviewer.py +0 -0
  100. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/skills/builder.py +0 -0
  101. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/skills/data_analyst.py +0 -0
  102. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/skills/deck_reviewer.py +0 -0
  103. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/skills/fix_reviewer.py +0 -0
  104. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/skills/fixer.py +0 -0
  105. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/strip_retired_prompt_keys.py +0 -0
  106. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/core/user_context.py +0 -0
  107. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/database/__init__.py +0 -0
  108. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/database/models/__init__.py +0 -0
  109. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/database/models/deck_contributor.py +0 -0
  110. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/database/models/deck_review.py +0 -0
  111. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/database/models/design_system.py +0 -0
  112. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/database/models/encryption_key.py +0 -0
  113. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/database/models/feedback.py +0 -0
  114. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/database/models/genie_space.py +0 -0
  115. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/database/models/google_global_credentials.py +0 -0
  116. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/database/models/google_oauth_token.py +0 -0
  117. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/database/models/graph_checkpoint.py +0 -0
  118. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/database/models/graph_configuration.py +0 -0
  119. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/database/models/identity.py +0 -0
  120. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/database/models/image.py +0 -0
  121. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/database/models/profile.py +0 -0
  122. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/database/models/profile_contributor.py +0 -0
  123. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/database/models/prompts.py +0 -0
  124. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/database/models/request_log.py +0 -0
  125. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/database/models/session.py +0 -0
  126. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/database/models/slide_deck_prompt.py +0 -0
  127. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/database/models/slide_style_library.py +0 -0
  128. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/database/models/user_preference.py +0 -0
  129. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/database/types.py +0 -0
  130. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/domain/__init__.py +0 -0
  131. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/domain/deck_spec.py +0 -0
  132. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/domain/finding.py +0 -0
  133. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/domain/skill_io.py +0 -0
  134. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/domain/slide.py +0 -0
  135. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/domain/slide_deck.py +0 -0
  136. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/__init__.py +0 -0
  137. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/agent.py +0 -0
  138. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/agent_definition_manifest_v1.py +0 -0
  139. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/agent_factory.py +0 -0
  140. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/agent_model_payload.py +0 -0
  141. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/agent_resolution.py +0 -0
  142. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/agent_runtime.py +0 -0
  143. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/agent_runtime_identity.py +0 -0
  144. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/agent_schema_registry.py +0 -0
  145. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/agent_schema_types.py +0 -0
  146. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/agent_test_workbench.py +0 -0
  147. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/collaboration_history.py +0 -0
  148. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/config_service.py +0 -0
  149. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/config_validator.py +0 -0
  150. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/conversation_pins.py +0 -0
  151. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/converter_jail/__init__.py +0 -0
  152. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/converter_jail/ast_guard.py +0 -0
  153. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/converter_jail/codeprep.py +0 -0
  154. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/converter_jail/gslides_runner.py +0 -0
  155. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/converter_jail/jail.py +0 -0
  156. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/converter_jail/pptx_runner.py +0 -0
  157. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/converter_jail/protocol.py +0 -0
  158. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/deck_css_aggregator.py +0 -0
  159. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/deck_review_store.py +0 -0
  160. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/design_system_compiler.py +0 -0
  161. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/design_system_service.py +0 -0
  162. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/design_system_templates.py +0 -0
  163. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/drive_uploader.py +0 -0
  164. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/evaluation/__init__.py +0 -0
  165. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/evaluation/llm_judge.py +0 -0
  166. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/foreman_service.py +0 -0
  167. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/gateway_openai.py +0 -0
  168. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/genie_service.py +0 -0
  169. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/google_slides_auth.py +0 -0
  170. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/google_slides_prompts_defaults.py +0 -0
  171. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/graph/__init__.py +0 -0
  172. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/graph/builder.py +0 -0
  173. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/graph/event_emitter.py +0 -0
  174. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/graph/nodes.py +0 -0
  175. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/graph/routers.py +0 -0
  176. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/graph/state.py +0 -0
  177. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/graph_configuration.py +0 -0
  178. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/graph_configuration_bootstrap.py +0 -0
  179. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/graph_configuration_content.py +0 -0
  180. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/graph_configuration_draft.py +0 -0
  181. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/graph_configuration_publication.py +0 -0
  182. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/graph_configuration_rollback.py +0 -0
  183. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/graph_configuration_seed.py +0 -0
  184. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/graph_configuration_workbench.py +0 -0
  185. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/graph_definition_manifest.py +0 -0
  186. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/graph_release_evidence.py +0 -0
  187. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/graph_release_history.py +0 -0
  188. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/html_to_google_slides.py +0 -0
  189. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/html_to_pptx.py +0 -0
  190. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/identity_provider.py +0 -0
  191. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/identity_providers/__init__.py +0 -0
  192. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/identity_providers/account_provider.py +0 -0
  193. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/identity_providers/local_provider.py +0 -0
  194. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/identity_providers/scim_filter.py +0 -0
  195. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/identity_providers/workspace_provider.py +0 -0
  196. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/image_service.py +0 -0
  197. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/image_tools.py +0 -0
  198. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/model_endpoint_catalog.py +0 -0
  199. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/model_endpoint_probe.py +0 -0
  200. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/permission_service.py +0 -0
  201. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/persisted_graph_release.py +0 -0
  202. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/pptx_from_html_huashu.py +0 -0
  203. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/pptx_from_records.py +0 -0
  204. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/pptx_prompts_defaults.py +0 -0
  205. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/profile_service.py +0 -0
  206. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/prompt_assembler.py +0 -0
  207. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/shared_deck_attribution.py +0 -0
  208. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/streaming_callback.py +0 -0
  209. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/svg_sanitizer.py +0 -0
  210. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/template_sections.py +0 -0
  211. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/tools/__init__.py +0 -0
  212. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/tools/agent_bricks_tool.py +0 -0
  213. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/tools/ds_asset_tool.py +0 -0
  214. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/tools/genie_tool.py +0 -0
  215. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/tools/mcp_tool.py +0 -0
  216. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/tools/model_endpoint_tool.py +0 -0
  217. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/tools/vector_tool.py +0 -0
  218. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/services/validator.py +0 -0
  219. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/utils/__init__.py +0 -0
  220. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/utils/css_utils.py +0 -0
  221. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/utils/ds_asset_utils.py +0 -0
  222. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/utils/error_handling.py +0 -0
  223. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/utils/graph_safety.py +0 -0
  224. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/utils/html_safety.py +0 -0
  225. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/utils/html_utils.py +0 -0
  226. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/utils/image_utils.py +0 -0
  227. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/utils/js_validator.py +0 -0
  228. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/utils/logging_config.py +0 -0
  229. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/utils/pi_filter.py +0 -0
  230. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/utils/slide_hash.py +0 -0
  231. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/src/utils/spotlight.py +0 -0
  232. {databricks_tellr_app-0.4.3.dev3448 → databricks_tellr_app-0.4.3.dev3450}/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.4.3.dev3448
3
+ Version: 0.4.3.dev3450
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.4.3.dev3448
3
+ Version: 0.4.3.dev3450
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.4.3.dev3448"
7
+ version = "0.4.3.dev3450"
8
8
  description = "Tellr application package for Databricks Apps"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.10"
@@ -218,6 +218,46 @@ def _check_deck_permission_for_session(
218
218
  _require_session_access(session_info, db, min_permission)
219
219
 
220
220
 
221
+ def _require_conversation_creator(session_id: str) -> None:
222
+ """Refuse a change to a session's conversation by anyone but its creator.
223
+
224
+ Conversations are private (GET /api/sessions/{id}/messages is creator-only).
225
+ Deck permission resolves on the ROOT session, so a CAN_EDIT gate alone lets
226
+ any editor of a shared deck change the OWNER's (or another contributor's)
227
+ conversation by passing that session's id. Used by DELETE …/context; #317's
228
+ per-message delete reuses it.
229
+
230
+ The comparison is the same one GET /messages makes: the session's OWN
231
+ ``created_by`` against the caller, never the parent's or the root's. A
232
+ session with no recorded creator is refused for every caller.
233
+
234
+ Raises:
235
+ HTTPException 401: no authenticated user.
236
+ HTTPException 404: unknown session.
237
+ HTTPException 403: the caller did not create this session.
238
+ """
239
+ current_user = get_current_user()
240
+ if not current_user:
241
+ raise HTTPException(status_code=401, detail="Authentication required")
242
+
243
+ try:
244
+ session_info = get_session_manager().get_session(session_id)
245
+ except SessionNotFoundError:
246
+ raise HTTPException(
247
+ status_code=404,
248
+ detail=f"Session not found: {session_id}",
249
+ ) from None
250
+
251
+ if session_info.get("created_by") != current_user:
252
+ raise HTTPException(
253
+ status_code=403,
254
+ detail=(
255
+ "Conversations are private. "
256
+ "Only the session creator can change its conversation."
257
+ ),
258
+ )
259
+
260
+
221
261
  # ---------------------------------------------------------------------------
222
262
  # Job-ID access (export poll/download, Google Slides poll)
223
263
  # ---------------------------------------------------------------------------
@@ -20,10 +20,11 @@ from sqlalchemy.orm import Session
20
20
 
21
21
  from src.api.routes._authz import (
22
22
  _check_deck_permission_for_session,
23
+ _require_conversation_creator,
23
24
  _require_session_access,
24
25
  )
25
26
  from src.api.schemas.requests import CreateSessionRequest, DuplicateSessionRequest
26
- from src.api.services.chat_service import get_chat_service
27
+ from src.api.services.chat_service import ArcReviewInFlightError, get_chat_service
27
28
  from src.api.services.session_manager import (
28
29
  SessionAccessDeniedError,
29
30
  SessionNotFoundError,
@@ -52,6 +53,12 @@ logger = logging.getLogger(__name__)
52
53
 
53
54
  router = APIRouter(prefix="/api/sessions", tags=["sessions"])
54
55
 
56
+ # Any holder of the session lock: a chat turn, or a slide operation (slides.py:187-195).
57
+ CONVERSATION_BUSY_DETAIL = (
58
+ "Something is still running on this deck. "
59
+ "Wait for it to finish, then try again."
60
+ )
61
+
55
62
 
56
63
  class UpdateSessionRequest(BaseModel):
57
64
  """Optional body for PATCH /api/sessions/{session_id}."""
@@ -856,34 +863,65 @@ async def clear_session_context(session_id: str):
856
863
  ``deck_spec_json`` (the structured compaction of what was decided) and the
857
864
  earliest user message, which is what engine-mode resolution reads.
858
865
 
859
- Requires CAN_EDIT: the helper's default is CAN_VIEW, and taking the default
860
- would let a **viewer** wipe another user's transcript and graph thread.
866
+ Requires CAN_EDIT on the deck (the helper's default is CAN_VIEW, and taking
867
+ the default would let a **viewer** wipe another user's transcript and graph
868
+ thread) AND that the caller is the session's creator: conversations are
869
+ private, and deck permission resolves on the root deck, so CAN_EDIT alone
870
+ would let any editor of a shared deck clear the owner's (or another
871
+ contributor's) conversation.
872
+
873
+ Answers 409 while the session lock is held (a chat turn or a slide
874
+ operation is running); the lock is released only if this request took it.
875
+ The prune, the thread delete and the attribution row are one transaction.
861
876
 
862
877
  Args:
863
878
  session_id: Session whose context to clear
864
879
 
865
880
  Returns:
866
881
  Clear confirmation with the number of messages deleted
882
+
883
+ Raises:
884
+ HTTPException 401/403/404: not signed in, not an editor / not the
885
+ session's creator, unknown session.
886
+ HTTPException 409: a turn or slide operation holds the session lock,
887
+ or the deck's arc review is running a turn on this thread.
867
888
  """
868
889
  # Permission check: require CAN_EDIT on the deck — NOT the helper's default.
869
890
  await asyncio.to_thread(
870
891
  _check_deck_permission_for_session, session_id, PermissionLevel.CAN_EDIT
871
892
  )
893
+ # The deck gate resolves on the ROOT deck; the conversation is the
894
+ # session's own, so its creator alone may clear it.
895
+ await asyncio.to_thread(_require_conversation_creator, session_id)
896
+
897
+ current_user = get_current_user()
898
+ session_manager = get_session_manager()
899
+ locked = await asyncio.to_thread(session_manager.acquire_session_lock, session_id)
900
+ if not locked:
901
+ # The lock belongs to whoever holds it: do not release it.
902
+ raise HTTPException(status_code=409, detail=CONVERSATION_BUSY_DETAIL)
872
903
 
873
904
  try:
874
905
  chat_service = get_chat_service()
875
- result = await asyncio.to_thread(chat_service.clear_context, session_id)
906
+ result = await asyncio.to_thread(
907
+ chat_service.clear_context, session_id, cleared_by=current_user
908
+ )
876
909
 
877
910
  logger.info(
878
911
  "Session context cleared via API",
879
912
  extra={
880
913
  "session_id": session_id,
914
+ "cleared_by": current_user,
881
915
  "deleted_messages": result.get("deleted_messages"),
882
916
  },
883
917
  )
884
918
 
885
919
  return result
886
920
 
921
+ except ArcReviewInFlightError:
922
+ # The arc-review sweeper is running a turn on this thread without the
923
+ # session lock; the clear changed nothing and can be retried.
924
+ raise HTTPException(status_code=409, detail=CONVERSATION_BUSY_DETAIL)
887
925
  except SessionNotFoundError:
888
926
  raise HTTPException(
889
927
  status_code=404,
@@ -897,6 +935,17 @@ async def clear_session_context(session_id: str):
897
935
  status_code=500,
898
936
  detail="Failed to clear session context",
899
937
  ) from e
938
+ finally:
939
+ # By now the clear has committed (or failed with its own error). A
940
+ # release failure must neither turn a committed clear into a 500 nor
941
+ # mask the clear's own exception; the lock then goes stale on its own.
942
+ try:
943
+ await asyncio.to_thread(session_manager.release_session_lock, session_id)
944
+ except Exception:
945
+ logger.exception(
946
+ "Failed to release session lock after clear",
947
+ extra={"session_id": session_id},
948
+ )
900
949
 
901
950
 
902
951
  @router.get("/{session_id}/slides")
@@ -29,6 +29,7 @@ from src.core.databricks_client import (
29
29
  )
30
30
  from src.domain.conversation_engine import (
31
31
  AGENT_MODE_PHRASE as AGENT_MODE_PHRASE,
32
+ ENGINE_MODE_MARKER_MESSAGE_TYPE,
32
33
  LEGACY_MODE_PHRASE as LEGACY_MODE_PHRASE,
33
34
  selects_graph_engine,
34
35
  )
@@ -318,6 +319,50 @@ class GraphTurnFailedError(RuntimeError):
318
319
  super().__init__(GRAPH_TURN_FAILED_MESSAGE)
319
320
 
320
321
 
322
+ class ArcReviewInFlightError(RuntimeError):
323
+ """The deck's arc review is running a graph turn on this session's thread.
324
+
325
+ Raised by :meth:`ChatService.clear_context` before anything changes; the
326
+ route answers 409 with ``CONVERSATION_BUSY_DETAIL``.
327
+ """
328
+
329
+ def __init__(self, session_id: str) -> None:
330
+ super().__init__(f"An arc review is running on session {session_id}")
331
+ self.session_id = session_id
332
+
333
+
334
+ def _refuse_during_an_arc_review(db: Any, session: Any) -> None:
335
+ """Raise :class:`ArcReviewInFlightError` while an arc review runs on *session*.
336
+
337
+ The arc-review sweeper (``spec_sync.run_arc_review``) runs a whole graph
338
+ turn on the deck OWNER's thread (``thread_id`` is the session id) and takes
339
+ no session lock, so the lock the clear route checks does not exclude it.
340
+ That turn loaded the thread before its architect ran and writes a checkpoint
341
+ after every superstep, each carrying every channel it holds; a thread
342
+ deleted under it comes back with the pre-clear ``findings``, turn-scoped
343
+ state and a reply written from the cleared conversation, and the next turn
344
+ resumes it. So a clear waits for the review, and the review's claim is the
345
+ signal: :func:`spec_sync.review_in_flight`.
346
+
347
+ The deck row is read ``FOR UPDATE`` (a no-op on SQLite, which serialises
348
+ writers anyway): on PostgreSQL a claim that commits first is seen here, and
349
+ a claim that comes second blocks on this row until the clear commits, so
350
+ its review loads the already-deleted thread. A contributor session owns no
351
+ deck row and the sweeper never runs on its thread, so it is never refused.
352
+ """
353
+ from src.database.models.session import SessionSlideDeck
354
+ from src.services.spec_sync import review_in_flight
355
+
356
+ deck = (
357
+ db.query(SessionSlideDeck)
358
+ .filter(SessionSlideDeck.session_id == session.id)
359
+ .with_for_update()
360
+ .first()
361
+ )
362
+ if deck is not None and review_in_flight(deck, datetime.utcnow()):
363
+ raise ArcReviewInFlightError(session.session_id)
364
+
365
+
321
366
  def _pinned_graph_configuration_error_event() -> StreamEvent:
322
367
  """The one safe, typed event for an unavailable pinned graph configuration."""
323
368
  return StreamEvent(
@@ -2143,7 +2188,7 @@ class ChatService:
2143
2188
  session_title=title_container["title"],
2144
2189
  )
2145
2190
 
2146
- def clear_context(self, session_id: str) -> Dict[str, Any]:
2191
+ def clear_context(self, session_id: str, *, cleared_by: str) -> Dict[str, Any]:
2147
2192
  """Drop this session's conversation context, keeping the deck and its spec.
2148
2193
 
2149
2194
  The deck spec is a structured compaction of the conversation: once it
@@ -2155,10 +2200,25 @@ class ChatService:
2155
2200
  from it (:func:`resolve_engine_mode`), so deleting it would silently
2156
2201
  revert a graph-mode deck to the monolith on the next turn — the two
2157
2202
  halves of this PR would contradict each other. There is precedent:
2158
- ``restore_version`` also prunes messages selectively, and preserving the
2159
- first user row is safe for that pruning too because it predates every
2160
- save point. It is preserved unconditionally, in both modes, so clearing
2161
- never *changes* the mode in either direction.
2203
+ ``restore_version`` also prunes messages selectively -- it deletes this
2204
+ session's rows created after the save point, so the kept row survives a
2205
+ restore whenever it predates that save point (always true for a root
2206
+ deck's own first turn). A contributor's kept row can be removed by a
2207
+ restore; that is harmless, because engine mode resolves on the deck
2208
+ OWNER's rows. It is preserved unconditionally, in both modes, so
2209
+ clearing never *changes* the mode in either direction.
2210
+
2211
+ **The kept row is re-typed and hidden.** Its ``message_type`` becomes
2212
+ :data:`ENGINE_MODE_MARKER_MESSAGE_TYPE`, which every transcript read
2213
+ drops (:meth:`SessionManager.get_messages` -- and so the chat panel,
2214
+ ``GET /messages``, the architect's conversation and the monolith's
2215
+ history -- and save-point capture), so a cleared conversation is empty
2216
+ to every reader and the old first prompt is never replayed. The
2217
+ engine-mode, Conversation Pin and duplicate-carry reads go by ``role``
2218
+ only, so they still see the row and nothing about the engine changes;
2219
+ ``message_count`` still counts it, so the next turn is not a "first
2220
+ message" and the deck's title is not regenerated. The re-type is part of
2221
+ this transaction.
2162
2222
 
2163
2223
  **The graph thread is deleted** through the repo's own
2164
2224
  ``SqlAlchemyCheckpointSaver.delete_thread``, whose ``thread_id`` is the
@@ -2167,27 +2227,31 @@ class ChatService:
2167
2227
  cannot delete surfaces as a 500 on the route rather than skipping
2168
2228
  quietly.
2169
2229
 
2170
- **This is not one transaction, and the skew has a direction.**
2171
- ``delete_thread`` opens ``self._session()``
2172
- (``core/checkpointer.py:226``), which **commits on success** — its own
2173
- transaction, committed while this one is still open. So:
2174
-
2175
- * a **raise** from ``delete_thread`` propagates out of this ``with``
2176
- block and the transcript prune is rolled back: nothing is lost, and the
2177
- route 500s. That direction is safe, and it is why the call sits inside
2178
- the block rather than after it;
2179
- * a failure of **this** transaction's commit, after ``delete_thread``
2180
- returned, leaves the graph thread **deleted and the transcript intact**.
2181
- Recoverable rather than corrupting — the next graph turn starts a fresh
2182
- thread and the user can clear again — but it is a real half-state, and
2183
- no ordering of these two writes removes it while they are two
2184
- transactions. Do not read the placement as atomicity.
2185
-
2186
- A second consequence of the two connections: the bulk
2187
- ``delete(synchronize_session=False)`` below emits its DELETE immediately,
2188
- so the transcript rows are locked on this connection while the
2189
- checkpointer deletes on another. Different tables, so there is no
2190
- ordering cycle today; worth not deepening.
2230
+ **The clear is one transaction.** The transcript prune, the attribution
2231
+ row and the thread delete all run on this method's own ``db`` session:
2232
+ ``delete_thread(session_id, session=db)`` executes its two DELETEs on that
2233
+ session and does not commit, so they commit or roll back together with the
2234
+ rest. Any failure -- a raise from ``delete_thread``, a failed insert, a
2235
+ failed commit -- leaves the transcript, the graph thread and the
2236
+ attribution exactly as they were, and the route 500s. There is no
2237
+ half-state to recover from, and a retry is safe (deleting an absent thread
2238
+ is a no-op DELETE).
2239
+
2240
+ The earlier shape was two transactions, and that is why this is one:
2241
+ ``delete_thread`` used to open its own session and commit while this one
2242
+ was still open. The bulk ``delete(synchronize_session=False)`` below emits
2243
+ its DELETE immediately, so this connection held a write lock while the
2244
+ checkpointer wrote on a second connection -- on SQLite that
2245
+ self-deadlocks (``database is locked``), and on any database it left a
2246
+ real skew if this transaction's commit then failed (thread gone,
2247
+ transcript intact). The ``db.flush()`` after the attribution insert
2248
+ makes a failed insert raise before the thread is touched.
2249
+
2250
+ **Who cleared is recorded** as one ``usage_events`` row
2251
+ (``EVENT_CONTEXT_CLEARED``, ``username=cleared_by``, the session's internal
2252
+ id) written in the same transaction, so the row exists if and only if the
2253
+ clear committed. ``cleared_by`` is required: a falsy value is refused
2254
+ before anything changes.
2191
2255
 
2192
2256
  No hidden agent state can survive: every non-architect agent is built
2193
2257
  fresh per invocation and the monolith's history is hydrated from these
@@ -2197,20 +2261,33 @@ class ChatService:
2197
2261
  session_id: The session to clear. A contributor session clears its
2198
2262
  own transcript; the owner's marker (and so the deck's mode) is
2199
2263
  untouched, because a contributor's rows are its own.
2264
+ cleared_by: Username of the caller doing the clear; recorded in
2265
+ ``usage_events`` and the log line. Required and non-empty.
2200
2266
 
2201
2267
  Returns:
2202
2268
  ``{"status": "cleared", "session_id": ..., "deleted_messages": N,
2203
2269
  "preserved_message_id": id-or-None}``
2204
2270
 
2205
2271
  Raises:
2272
+ ValueError: ``cleared_by`` is empty or None (nothing is changed).
2206
2273
  SessionNotFoundError: session_id does not exist.
2274
+ ArcReviewInFlightError: the deck's arc review holds a live claim and
2275
+ is running a graph turn on this thread (nothing is changed); see
2276
+ :func:`_refuse_during_an_arc_review`.
2207
2277
  """
2278
+ if not cleared_by:
2279
+ raise ValueError("clear_context requires cleared_by: who cleared must be recorded")
2280
+
2208
2281
  from src.core.database import get_db_session
2209
2282
  from src.database.models.session import SessionMessage
2283
+ from src.database.models.usage_event import EVENT_CONTEXT_CLEARED, UsageEvent
2210
2284
 
2211
2285
  session_manager = get_session_manager()
2212
2286
  with get_db_session() as db:
2213
2287
  session = session_manager._get_session_or_raise(db, session_id)
2288
+ # Before anything changes: an arc review in flight would write the
2289
+ # thread back after the delete below.
2290
+ _refuse_during_an_arc_review(db, session)
2214
2291
 
2215
2292
  marker = (
2216
2293
  db.query(SessionMessage)
@@ -2229,16 +2306,30 @@ class ChatService:
2229
2306
  if marker_id is not None:
2230
2307
  doomed = doomed.filter(SessionMessage.id != marker_id)
2231
2308
  deleted_messages = doomed.delete(synchronize_session=False)
2309
+ if marker is not None:
2310
+ marker.message_type = ENGINE_MODE_MARKER_MESSAGE_TYPE
2311
+
2312
+ db.add(
2313
+ UsageEvent(
2314
+ username=cleared_by,
2315
+ event_type=EVENT_CONTEXT_CLEARED,
2316
+ session_id=session.id,
2317
+ )
2318
+ )
2319
+ # A failed insert raises here, before the thread is touched.
2320
+ db.flush()
2232
2321
 
2233
- # Inside the transaction on purpose — see the docstring.
2322
+ # On THIS session, so it commits or rolls back with the rest — see
2323
+ # the docstring.
2234
2324
  from src.core.checkpointer import get_checkpointer
2235
2325
 
2236
- get_checkpointer().delete_thread(session_id)
2326
+ get_checkpointer().delete_thread(session_id, session=db)
2237
2327
 
2238
2328
  logger.info(
2239
2329
  "Cleared session context",
2240
2330
  extra={
2241
2331
  "session_id": session_id,
2332
+ "cleared_by": cleared_by,
2242
2333
  "deleted_messages": deleted_messages,
2243
2334
  "preserved_message_id": marker_id,
2244
2335
  },
@@ -29,6 +29,7 @@ from src.database.models.session import (
29
29
  SlideDeckVersion,
30
30
  UserSession,
31
31
  )
32
+ from src.domain.conversation_engine import is_transcript_message
32
33
  from src.domain.finding import findings_from_record
33
34
  from src.services.conversation_pins import (
34
35
  get_conversation_graph_version,
@@ -1522,7 +1523,11 @@ class SessionManager:
1522
1523
  with get_db_session() as db:
1523
1524
  session = self._get_session_or_raise(db, session_id)
1524
1525
 
1525
- messages = session.messages
1526
+ # The row a clear keeps (engine-mode marker) is not part of the
1527
+ # conversation; drop it BEFORE ``limit`` so it never uses a slot.
1528
+ messages = [
1529
+ m for m in session.messages if is_transcript_message(m.message_type)
1530
+ ]
1526
1531
  if limit:
1527
1532
  messages = messages[-limit:]
1528
1533
 
@@ -2517,6 +2522,7 @@ class SessionManager:
2517
2522
  "created_at": m.created_at.isoformat(),
2518
2523
  }
2519
2524
  for m in session.messages
2525
+ if is_transcript_message(m.message_type)
2520
2526
  ]
2521
2527
 
2522
2528
  # Create new version on the deck owner's session.
@@ -69,7 +69,9 @@ differ because the migration is handed a schema and the saver is not.
69
69
 
70
70
  IMPLEMENTED SURFACE — exactly the five methods a compiled graph calls, all of
71
71
  which raise ``NotImplementedError`` on the base class: ``get_tuple``, ``list``,
72
- ``put``, ``put_writes``, ``delete_thread``.
72
+ ``put``, ``put_writes``, ``delete_thread``. ``delete_thread`` also takes an
73
+ optional keyword ``session``: with it the deletes run on the CALLER's session
74
+ and commit or roll back with the caller's transaction (see its docstring).
73
75
 
74
76
  ``get_next_version`` is NOT overridden, and not because it raises: probed on
75
77
  langgraph-checkpoint 4.1.1 the base class ships a WORKING integer increment
@@ -464,11 +466,29 @@ class SqlAlchemyCheckpointSaver(BaseCheckpointSaver[str]):
464
466
  },
465
467
  )
466
468
 
467
- def delete_thread(self, thread_id: str) -> None:
468
- """Delete every checkpoint AND every pending write for one thread."""
469
- with self._session() as session:
469
+ def delete_thread(self, thread_id: str, *, session: Any | None = None) -> None:
470
+ """Delete every checkpoint AND every pending write for one thread.
471
+
472
+ With ``session`` the two DELETEs run on the CALLER's session and are NOT
473
+ committed here: they commit or roll back with the caller's transaction.
474
+ ``ChatService.clear_context`` relies on this so a clear is one transaction,
475
+ and so it never holds a write open while a second connection writes (on
476
+ SQLite that self-deadlocks: ``database is locked``). The caller owns the
477
+ session's lifetime; nothing is retained on ``self``.
478
+
479
+ Without ``session`` it opens, commits and closes its own, as before.
480
+ """
481
+ if session is not None:
470
482
  session.execute(_DELETE_THREAD_WRITES, {"thread_id": thread_id})
471
483
  session.execute(_DELETE_THREAD_CHECKPOINTS, {"thread_id": thread_id})
484
+ logger.info(
485
+ "Deleted graph checkpoints for thread %s in the caller's transaction",
486
+ thread_id,
487
+ )
488
+ return
489
+ with self._session() as own:
490
+ own.execute(_DELETE_THREAD_WRITES, {"thread_id": thread_id})
491
+ own.execute(_DELETE_THREAD_CHECKPOINTS, {"thread_id": thread_id})
472
492
  logger.info("Cleared graph checkpoints for thread %s", thread_id)
473
493
 
474
494
 
@@ -13,10 +13,11 @@ from src.core.database import Base
13
13
  EVENT_LOGIN = "login"
14
14
  EVENT_DECK_CREATED = "deck_created"
15
15
  EVENT_DECK_RETRIEVED = "deck_retrieved"
16
+ EVENT_CONTEXT_CLEARED = "context_cleared"
16
17
 
17
18
 
18
19
  class UsageEvent(Base):
19
- """A single usage event (login, deck created, deck retrieved)."""
20
+ """A single usage event (login, deck created, deck retrieved, context cleared)."""
20
21
 
21
22
  __tablename__ = "usage_events"
22
23
 
@@ -17,6 +17,13 @@ LEGACY_MODE_PHRASE = "USE LEGACY MODE"
17
17
  # recognise the historical graph decks it was written to pin.
18
18
  AGENT_MODE_PHRASE = "USE AGENT MODE"
19
19
 
20
+ #: ``SessionMessage.message_type`` of the one row ``ChatService.clear_context`` keeps.
21
+ #: The deck's engine is read off its earliest role='user' row (role only), so a
22
+ #: clear cannot delete that row; this type hides it from every transcript read
23
+ #: (``SessionManager.get_messages``, save-point capture), and so from the chat
24
+ #: panel, the architect's conversation and the monolith's history.
25
+ ENGINE_MODE_MARKER_MESSAGE_TYPE = "engine_mode_marker"
26
+
20
27
 
21
28
  def selects_legacy_engine(content: str | None) -> bool:
22
29
  """Return whether ``content`` contains the case-sensitive legacy opt-out."""
@@ -43,3 +50,8 @@ def with_legacy_marker(content: str) -> str:
43
50
  if selects_legacy_engine(content):
44
51
  return content
45
52
  return f"{LEGACY_MODE_PHRASE}\n\n{content}"
53
+
54
+
55
+ def is_transcript_message(message_type: str | None) -> bool:
56
+ """Whether a persisted chat row belongs to the visible conversation."""
57
+ return message_type != ENGINE_MODE_MARKER_MESSAGE_TYPE
@@ -15,6 +15,7 @@ and the sweeper that drains the queue those three define:
15
15
  :data:`SWEEP_INTERVAL_SECONDS` how often the loop wakes
16
16
  :data:`CLAIM_TTL_SECONDS` how long a worker's lease is honoured
17
17
  :func:`claim_due_marker` ``(now) -> (owner_session_id, author) | None``
18
+ :func:`review_in_flight` ``(deck, now) -> bool`` — a live claim; the clear waits on it
18
19
  :func:`run_arc_review` ``(session_id, author) -> bool`` — never raises
19
20
  :func:`sweep_once` one tick: claim at most one marker and review it
20
21
  :func:`spec_review_sweeper_loop` the periodic loop, started in the FastAPI lifespan
@@ -523,6 +524,23 @@ def claim_due_marker(now: datetime) -> Optional[Tuple[str, str]]:
523
524
  return (owner_session_id, author)
524
525
 
525
526
 
527
+ def review_in_flight(deck: SessionSlideDeck, now: datetime) -> bool:
528
+ """True while an arc review holds a live claim on *deck*.
529
+
530
+ The inverse of :func:`claim_due_marker`'s ``unclaimed`` test: a claim younger
531
+ than :data:`CLAIM_TTL_SECONDS` means a review may be running a graph turn on
532
+ the deck owner's thread right now (the claim is taken before
533
+ :func:`run_arc_review` invokes the graph and released only after it
534
+ returns). ``ChatService.clear_context`` refuses on it, because that turn
535
+ takes no session lock and would write its pre-clear state back into the
536
+ thread the clear deletes.
537
+ """
538
+ claimed_at = deck.spec_dirty_claimed_at
539
+ return claimed_at is not None and claimed_at > now - timedelta(
540
+ seconds=CLAIM_TTL_SECONDS
541
+ )
542
+
543
+
526
544
  def _marker_write(db, deck_id: int, **values) -> None:
527
545
  """UPDATE the marker columns on *deck_id* and leave ``updated_at`` alone.
528
546