databricks-tellr-app 0.4.3.dev3457__tar.gz → 0.4.3.dev3459__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 (241) hide show
  1. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/PKG-INFO +1 -1
  2. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/databricks_tellr_app.egg-info/PKG-INFO +1 -1
  3. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/databricks_tellr_app.egg-info/SOURCES.txt +16 -0
  4. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/pyproject.toml +1 -1
  5. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/_authz.py +40 -0
  6. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/chat.py +12 -2
  7. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/sessions.py +143 -4
  8. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/slides.py +37 -14
  9. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/schemas/streaming.py +7 -0
  10. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/services/chat_service.py +417 -175
  11. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/services/session_manager.py +665 -97
  12. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/services/slide_repository.py +240 -13
  13. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/checkpointer.py +24 -4
  14. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/database.py +244 -129
  15. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/skills/architect.py +49 -4
  16. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/database/models/__init__.py +2 -0
  17. databricks_tellr_app-0.4.3.dev3459/src/database/models/data_migration.py +26 -0
  18. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/database/models/session.py +7 -0
  19. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/database/models/usage_event.py +5 -1
  20. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/domain/conversation_engine.py +12 -0
  21. databricks_tellr_app-0.4.3.dev3459/src/domain/conversation_turns.py +45 -0
  22. databricks_tellr_app-0.4.3.dev3459/src/domain/deck_spec_slides.py +347 -0
  23. databricks_tellr_app-0.4.3.dev3459/src/domain/finding_copy.py +155 -0
  24. databricks_tellr_app-0.4.3.dev3459/src/domain/slide_alignment.py +198 -0
  25. databricks_tellr_app-0.4.3.dev3459/src/domain/slide_numbering.py +468 -0
  26. databricks_tellr_app-0.4.3.dev3459/src/services/agent_definition_manifest_v1.py +3 -0
  27. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/agent_model_payload.py +2 -0
  28. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/graph/builder.py +10 -1
  29. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/graph/nodes.py +846 -123
  30. databricks_tellr_app-0.4.3.dev3459/src/services/graph/progress.py +260 -0
  31. databricks_tellr_app-0.4.3.dev3459/src/services/graph/user_notices.py +311 -0
  32. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/spec_sync.py +18 -0
  33. databricks_tellr_app-0.4.3.dev3457/src/services/agent_definition_manifest_v1.py +0 -3
  34. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/README.md +0 -0
  35. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/databricks_tellr_app/__init__.py +0 -0
  36. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/databricks_tellr_app/run.py +0 -0
  37. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/databricks_tellr_app.egg-info/dependency_links.txt +0 -0
  38. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/databricks_tellr_app.egg-info/requires.txt +0 -0
  39. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/databricks_tellr_app.egg-info/top_level.txt +0 -0
  40. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/setup.cfg +0 -0
  41. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/setup.py +0 -0
  42. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/__init__.py +0 -0
  43. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/__init__.py +0 -0
  44. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/_otel_bootstrap.py +0 -0
  45. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/fixtures/tour_demo_deck.json +0 -0
  46. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/main.py +0 -0
  47. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/mcp_auth.py +0 -0
  48. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/mcp_server.py +0 -0
  49. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/middleware/__init__.py +0 -0
  50. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/middleware/csrf.py +0 -0
  51. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/middleware/request_logging.py +0 -0
  52. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/middleware/security_headers.py +0 -0
  53. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/__init__.py +0 -0
  54. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/admin.py +0 -0
  55. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/admin_usage.py +0 -0
  56. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/agent_config.py +0 -0
  57. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/agent_definitions.py +0 -0
  58. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/deck_contributors.py +0 -0
  59. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/export.py +0 -0
  60. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/feedback.py +0 -0
  61. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/google_slides.py +0 -0
  62. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/images.py +0 -0
  63. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/local_version.py +0 -0
  64. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/profiles.py +0 -0
  65. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/settings/__init__.py +0 -0
  66. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/settings/contributors.py +0 -0
  67. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/settings/deck_prompts.py +0 -0
  68. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/settings/design_systems.py +0 -0
  69. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/settings/identities.py +0 -0
  70. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/settings/slide_styles.py +0 -0
  71. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/setup.py +0 -0
  72. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/tools.py +0 -0
  73. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/tour.py +0 -0
  74. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/verification.py +0 -0
  75. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/routes/version.py +0 -0
  76. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/schemas/__init__.py +0 -0
  77. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/schemas/agent_config.py +0 -0
  78. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/schemas/agent_definitions.py +0 -0
  79. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/schemas/feedback.py +0 -0
  80. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/schemas/graph_release_history.py +0 -0
  81. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/schemas/graph_releases.py +0 -0
  82. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/schemas/requests.py +0 -0
  83. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/schemas/responses.py +0 -0
  84. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/schemas/settings/__init__.py +0 -0
  85. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/schemas/settings/requests.py +0 -0
  86. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/schemas/settings/responses.py +0 -0
  87. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/services/__init__.py +0 -0
  88. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/services/deck_level_writer.py +0 -0
  89. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/services/export_job_queue.py +0 -0
  90. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/services/feedback_service.py +0 -0
  91. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/services/job_queue.py +0 -0
  92. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/services/session_naming.py +0 -0
  93. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/services/usage_events.py +0 -0
  94. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/services/usage_service.py +0 -0
  95. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/utils/__init__.py +0 -0
  96. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/api/utils/validation.py +0 -0
  97. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/__init__.py +0 -0
  98. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/backfill_session_slides_startup.py +0 -0
  99. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/config_loader.py +0 -0
  100. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/context_utils.py +0 -0
  101. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/databricks_client.py +0 -0
  102. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/defaults.py +0 -0
  103. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/encryption.py +0 -0
  104. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/init_default_profile.py +0 -0
  105. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/lakebase.py +0 -0
  106. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/migrate_profiles_to_agent_config.py +0 -0
  107. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/mlflow_agent_spans.py +0 -0
  108. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/mlflow_tracing.py +0 -0
  109. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/otel_logging.py +0 -0
  110. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/permission_context.py +0 -0
  111. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/prompt_modules.py +0 -0
  112. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/settings_db.py +0 -0
  113. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/skills/__init__.py +0 -0
  114. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/skills/build_reviewer.py +0 -0
  115. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/skills/builder.py +0 -0
  116. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/skills/data_analyst.py +0 -0
  117. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/skills/deck_reviewer.py +0 -0
  118. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/skills/fix_reviewer.py +0 -0
  119. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/skills/fixer.py +0 -0
  120. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/strip_retired_prompt_keys.py +0 -0
  121. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/core/user_context.py +0 -0
  122. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/database/__init__.py +0 -0
  123. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/database/models/deck_contributor.py +0 -0
  124. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/database/models/deck_review.py +0 -0
  125. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/database/models/design_system.py +0 -0
  126. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/database/models/encryption_key.py +0 -0
  127. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/database/models/feedback.py +0 -0
  128. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/database/models/genie_space.py +0 -0
  129. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/database/models/google_global_credentials.py +0 -0
  130. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/database/models/google_oauth_token.py +0 -0
  131. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/database/models/graph_checkpoint.py +0 -0
  132. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/database/models/graph_configuration.py +0 -0
  133. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/database/models/identity.py +0 -0
  134. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/database/models/image.py +0 -0
  135. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/database/models/profile.py +0 -0
  136. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/database/models/profile_contributor.py +0 -0
  137. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/database/models/prompts.py +0 -0
  138. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/database/models/request_log.py +0 -0
  139. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/database/models/slide_deck_prompt.py +0 -0
  140. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/database/models/slide_style_library.py +0 -0
  141. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/database/models/user_preference.py +0 -0
  142. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/database/types.py +0 -0
  143. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/domain/__init__.py +0 -0
  144. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/domain/deck_spec.py +0 -0
  145. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/domain/finding.py +0 -0
  146. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/domain/skill_io.py +0 -0
  147. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/domain/slide.py +0 -0
  148. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/domain/slide_deck.py +0 -0
  149. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/__init__.py +0 -0
  150. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/agent.py +0 -0
  151. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/agent_factory.py +0 -0
  152. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/agent_resolution.py +0 -0
  153. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/agent_runtime.py +0 -0
  154. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/agent_runtime_identity.py +0 -0
  155. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/agent_schema_registry.py +0 -0
  156. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/agent_schema_types.py +0 -0
  157. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/agent_test_workbench.py +0 -0
  158. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/collaboration_history.py +0 -0
  159. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/config_service.py +0 -0
  160. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/config_validator.py +0 -0
  161. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/conversation_pins.py +0 -0
  162. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/converter_jail/__init__.py +0 -0
  163. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/converter_jail/ast_guard.py +0 -0
  164. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/converter_jail/codeprep.py +0 -0
  165. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/converter_jail/gslides_runner.py +0 -0
  166. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/converter_jail/jail.py +0 -0
  167. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/converter_jail/pptx_runner.py +0 -0
  168. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/converter_jail/protocol.py +0 -0
  169. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/deck_css_aggregator.py +0 -0
  170. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/deck_review_store.py +0 -0
  171. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/design_system_compiler.py +0 -0
  172. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/design_system_service.py +0 -0
  173. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/design_system_templates.py +0 -0
  174. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/drive_uploader.py +0 -0
  175. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/evaluation/__init__.py +0 -0
  176. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/evaluation/llm_judge.py +0 -0
  177. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/foreman_service.py +0 -0
  178. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/gateway_openai.py +0 -0
  179. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/genie_service.py +0 -0
  180. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/google_slides_auth.py +0 -0
  181. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/google_slides_prompts_defaults.py +0 -0
  182. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/graph/__init__.py +0 -0
  183. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/graph/event_emitter.py +0 -0
  184. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/graph/routers.py +0 -0
  185. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/graph/state.py +0 -0
  186. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/graph_configuration.py +0 -0
  187. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/graph_configuration_bootstrap.py +0 -0
  188. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/graph_configuration_content.py +0 -0
  189. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/graph_configuration_draft.py +0 -0
  190. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/graph_configuration_publication.py +0 -0
  191. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/graph_configuration_rollback.py +0 -0
  192. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/graph_configuration_seed.py +0 -0
  193. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/graph_configuration_workbench.py +0 -0
  194. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/graph_definition_manifest.py +0 -0
  195. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/graph_release_evidence.py +0 -0
  196. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/graph_release_history.py +0 -0
  197. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/html_to_google_slides.py +0 -0
  198. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/html_to_pptx.py +0 -0
  199. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/identity_provider.py +0 -0
  200. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/identity_providers/__init__.py +0 -0
  201. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/identity_providers/account_provider.py +0 -0
  202. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/identity_providers/local_provider.py +0 -0
  203. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/identity_providers/scim_filter.py +0 -0
  204. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/identity_providers/workspace_provider.py +0 -0
  205. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/image_service.py +0 -0
  206. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/image_tools.py +0 -0
  207. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/model_endpoint_catalog.py +0 -0
  208. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/model_endpoint_probe.py +0 -0
  209. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/permission_service.py +0 -0
  210. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/persisted_graph_release.py +0 -0
  211. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/pptx_from_html_huashu.py +0 -0
  212. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/pptx_from_records.py +0 -0
  213. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/pptx_prompts_defaults.py +0 -0
  214. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/profile_service.py +0 -0
  215. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/prompt_assembler.py +0 -0
  216. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/shared_deck_attribution.py +0 -0
  217. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/streaming_callback.py +0 -0
  218. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/svg_sanitizer.py +0 -0
  219. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/template_sections.py +0 -0
  220. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/tools/__init__.py +0 -0
  221. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/tools/agent_bricks_tool.py +0 -0
  222. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/tools/ds_asset_tool.py +0 -0
  223. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/tools/genie_tool.py +0 -0
  224. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/tools/mcp_tool.py +0 -0
  225. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/tools/model_endpoint_tool.py +0 -0
  226. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/tools/vector_tool.py +0 -0
  227. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/services/validator.py +0 -0
  228. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/utils/__init__.py +0 -0
  229. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/utils/css_utils.py +0 -0
  230. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/utils/ds_asset_utils.py +0 -0
  231. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/utils/error_handling.py +0 -0
  232. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/utils/graph_safety.py +0 -0
  233. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/utils/html_safety.py +0 -0
  234. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/utils/html_utils.py +0 -0
  235. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/utils/image_utils.py +0 -0
  236. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/utils/js_validator.py +0 -0
  237. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/utils/logging_config.py +0 -0
  238. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/utils/pi_filter.py +0 -0
  239. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/utils/slide_hash.py +0 -0
  240. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/src/utils/spotlight.py +0 -0
  241. {databricks_tellr_app-0.4.3.dev3457 → databricks_tellr_app-0.4.3.dev3459}/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.dev3457
3
+ Version: 0.4.3.dev3459
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.dev3457
3
+ Version: 0.4.3.dev3459
4
4
  Summary: Tellr application package for Databricks Apps
5
5
  Requires-Python: >=3.10
6
6
  Description-Content-Type: text/markdown
@@ -97,6 +97,7 @@ setup.py
97
97
  ./src/database/__init__.py
98
98
  ./src/database/types.py
99
99
  ./src/database/models/__init__.py
100
+ ./src/database/models/data_migration.py
100
101
  ./src/database/models/deck_contributor.py
101
102
  ./src/database/models/deck_review.py
102
103
  ./src/database/models/design_system.py
@@ -120,11 +121,16 @@ setup.py
120
121
  ./src/database/models/user_preference.py
121
122
  ./src/domain/__init__.py
122
123
  ./src/domain/conversation_engine.py
124
+ ./src/domain/conversation_turns.py
123
125
  ./src/domain/deck_spec.py
126
+ ./src/domain/deck_spec_slides.py
124
127
  ./src/domain/finding.py
128
+ ./src/domain/finding_copy.py
125
129
  ./src/domain/skill_io.py
126
130
  ./src/domain/slide.py
131
+ ./src/domain/slide_alignment.py
127
132
  ./src/domain/slide_deck.py
133
+ ./src/domain/slide_numbering.py
128
134
  ./src/services/__init__.py
129
135
  ./src/services/agent.py
130
136
  ./src/services/agent_definition_manifest_v1.py
@@ -195,8 +201,10 @@ setup.py
195
201
  ./src/services/graph/builder.py
196
202
  ./src/services/graph/event_emitter.py
197
203
  ./src/services/graph/nodes.py
204
+ ./src/services/graph/progress.py
198
205
  ./src/services/graph/routers.py
199
206
  ./src/services/graph/state.py
207
+ ./src/services/graph/user_notices.py
200
208
  ./src/services/identity_providers/__init__.py
201
209
  ./src/services/identity_providers/account_provider.py
202
210
  ./src/services/identity_providers/local_provider.py
@@ -324,6 +332,7 @@ src/core/skills/fixer.py
324
332
  src/database/__init__.py
325
333
  src/database/types.py
326
334
  src/database/models/__init__.py
335
+ src/database/models/data_migration.py
327
336
  src/database/models/deck_contributor.py
328
337
  src/database/models/deck_review.py
329
338
  src/database/models/design_system.py
@@ -347,11 +356,16 @@ src/database/models/usage_event.py
347
356
  src/database/models/user_preference.py
348
357
  src/domain/__init__.py
349
358
  src/domain/conversation_engine.py
359
+ src/domain/conversation_turns.py
350
360
  src/domain/deck_spec.py
361
+ src/domain/deck_spec_slides.py
351
362
  src/domain/finding.py
363
+ src/domain/finding_copy.py
352
364
  src/domain/skill_io.py
353
365
  src/domain/slide.py
366
+ src/domain/slide_alignment.py
354
367
  src/domain/slide_deck.py
368
+ src/domain/slide_numbering.py
355
369
  src/services/__init__.py
356
370
  src/services/agent.py
357
371
  src/services/agent_definition_manifest_v1.py
@@ -422,8 +436,10 @@ src/services/graph/__init__.py
422
436
  src/services/graph/builder.py
423
437
  src/services/graph/event_emitter.py
424
438
  src/services/graph/nodes.py
439
+ src/services/graph/progress.py
425
440
  src/services/graph/routers.py
426
441
  src/services/graph/state.py
442
+ src/services/graph/user_notices.py
427
443
  src/services/identity_providers/__init__.py
428
444
  src/services/identity_providers/account_provider.py
429
445
  src/services/identity_providers/local_provider.py
@@ -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.dev3457"
7
+ version = "0.4.3.dev3459"
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
  # ---------------------------------------------------------------------------
@@ -847,7 +847,8 @@ async def poll_chat(
847
847
 
848
848
  **The slides do NOT come through ``msg_to_stream_event``.** ws4d D3 does not
849
849
  persist slide-ready as a ``SessionMessage``: that converter returns a fixed
850
- six-key dict with nowhere to put ``position``/``html``/``scripts``, so a
850
+ message projection that carries no slide payload, with nowhere to put
851
+ ``position``/``html``/``scripts``, so a
851
852
  converter that learned the type still could not carry the data — and build
852
853
  mechanics in the transcript pollute a view that is now user-visible and
853
854
  clearable. This reads **committed rows** instead, via
@@ -869,7 +870,7 @@ async def poll_chat(
869
870
 
870
871
  Returns:
871
872
  Dictionary with status, events, last_message_id, result, error, slides,
872
- slide_cursor, slide_revisions and revision_mark
873
+ slide_cursor, slide_revisions, revision_mark and turn_progress
873
874
 
874
875
  Raises:
875
876
  HTTPException: 404 if request not found, 403 if caller is not the
@@ -964,4 +965,13 @@ async def poll_chat(
964
965
  ),
965
966
  "slide_revisions": slide_revisions,
966
967
  "revision_mark": revision_mark,
968
+ # #319 — the graph turn's latest stage summary, read off this request's
969
+ # row, so any worker serves the same value. Null once the request is
970
+ # terminal (a finished turn never shows a stale stage) and null for a
971
+ # monolith turn, which never writes one.
972
+ "turn_progress": (
973
+ chat_request.get("turn_progress")
974
+ if chat_request["status"] not in ("completed", "error")
975
+ else None
976
+ ),
967
977
  }
@@ -20,11 +20,13 @@ 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 (
29
+ MessageNotFoundError,
28
30
  SessionAccessDeniedError,
29
31
  SessionNotFoundError,
30
32
  get_session_manager,
@@ -52,6 +54,16 @@ logger = logging.getLogger(__name__)
52
54
 
53
55
  router = APIRouter(prefix="/api/sessions", tags=["sessions"])
54
56
 
57
+ # Any holder of the session lock: a chat turn, or a slide operation (slides.py:187-195).
58
+ CONVERSATION_BUSY_DETAIL = (
59
+ "Something is still running on this deck. "
60
+ "Wait for it to finish, then try again."
61
+ )
62
+
63
+ # One text for every "no such message here" case (absent, another session's,
64
+ # not a user message, already hidden), so a 404 is no oracle for other ids.
65
+ MESSAGE_NOT_FOUND_DETAIL = "That message is not in this conversation."
66
+
55
67
 
56
68
  class UpdateSessionRequest(BaseModel):
57
69
  """Optional body for PATCH /api/sessions/{session_id}."""
@@ -856,34 +868,65 @@ async def clear_session_context(session_id: str):
856
868
  ``deck_spec_json`` (the structured compaction of what was decided) and the
857
869
  earliest user message, which is what engine-mode resolution reads.
858
870
 
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.
871
+ Requires CAN_EDIT on the deck (the helper's default is CAN_VIEW, and taking
872
+ the default would let a **viewer** wipe another user's transcript and graph
873
+ thread) AND that the caller is the session's creator: conversations are
874
+ private, and deck permission resolves on the root deck, so CAN_EDIT alone
875
+ would let any editor of a shared deck clear the owner's (or another
876
+ contributor's) conversation.
877
+
878
+ Answers 409 while the session lock is held (a chat turn or a slide
879
+ operation is running); the lock is released only if this request took it.
880
+ The prune, the thread delete and the attribution row are one transaction.
861
881
 
862
882
  Args:
863
883
  session_id: Session whose context to clear
864
884
 
865
885
  Returns:
866
886
  Clear confirmation with the number of messages deleted
887
+
888
+ Raises:
889
+ HTTPException 401/403/404: not signed in, not an editor / not the
890
+ session's creator, unknown session.
891
+ HTTPException 409: a turn or slide operation holds the session lock,
892
+ or the deck's arc review is running a turn on this thread.
867
893
  """
868
894
  # Permission check: require CAN_EDIT on the deck — NOT the helper's default.
869
895
  await asyncio.to_thread(
870
896
  _check_deck_permission_for_session, session_id, PermissionLevel.CAN_EDIT
871
897
  )
898
+ # The deck gate resolves on the ROOT deck; the conversation is the
899
+ # session's own, so its creator alone may clear it.
900
+ await asyncio.to_thread(_require_conversation_creator, session_id)
901
+
902
+ current_user = get_current_user()
903
+ session_manager = get_session_manager()
904
+ locked = await asyncio.to_thread(session_manager.acquire_session_lock, session_id)
905
+ if not locked:
906
+ # The lock belongs to whoever holds it: do not release it.
907
+ raise HTTPException(status_code=409, detail=CONVERSATION_BUSY_DETAIL)
872
908
 
873
909
  try:
874
910
  chat_service = get_chat_service()
875
- result = await asyncio.to_thread(chat_service.clear_context, session_id)
911
+ result = await asyncio.to_thread(
912
+ chat_service.clear_context, session_id, cleared_by=current_user
913
+ )
876
914
 
877
915
  logger.info(
878
916
  "Session context cleared via API",
879
917
  extra={
880
918
  "session_id": session_id,
919
+ "cleared_by": current_user,
881
920
  "deleted_messages": result.get("deleted_messages"),
882
921
  },
883
922
  )
884
923
 
885
924
  return result
886
925
 
926
+ except ArcReviewInFlightError:
927
+ # The arc-review sweeper is running a turn on this thread without the
928
+ # session lock; the clear changed nothing and can be retried.
929
+ raise HTTPException(status_code=409, detail=CONVERSATION_BUSY_DETAIL)
887
930
  except SessionNotFoundError:
888
931
  raise HTTPException(
889
932
  status_code=404,
@@ -897,6 +940,102 @@ async def clear_session_context(session_id: str):
897
940
  status_code=500,
898
941
  detail="Failed to clear session context",
899
942
  ) from e
943
+ finally:
944
+ # By now the clear has committed (or failed with its own error). A
945
+ # release failure must neither turn a committed clear into a 500 nor
946
+ # mask the clear's own exception; the lock then goes stale on its own.
947
+ try:
948
+ await asyncio.to_thread(session_manager.release_session_lock, session_id)
949
+ except Exception:
950
+ logger.exception(
951
+ "Failed to release session lock after clear",
952
+ extra={"session_id": session_id},
953
+ )
954
+
955
+
956
+ @router.delete("/{session_id}/messages/{message_id}")
957
+ async def delete_session_message(session_id: str, message_id: int):
958
+ """Delete one message of this session's conversation, with the replies to it.
959
+
960
+ The unit is the turn (``ChatService.delete_message``). The session's
961
+ earliest user message is hidden rather than deleted, the graph thread is
962
+ deleted, and the deck, its Spec and its save points are NOT rolled back.
963
+
964
+ Gates, in order, exactly as ``clear_session_context``: CAN_EDIT on the deck,
965
+ then the session's creator (a contributor edits only their own session),
966
+ then the session lock (409 while a turn or slide operation runs; released
967
+ only if this request took it).
968
+
969
+ Raises:
970
+ HTTPException 401/403/404: not signed in, not an editor / not the
971
+ session's creator, unknown session or a message not in it.
972
+ HTTPException 409: a turn or slide operation holds the session lock,
973
+ or the deck's arc review is running a turn on this thread.
974
+ HTTPException 422: ``message_id`` is not an integer.
975
+ """
976
+ await asyncio.to_thread(
977
+ _check_deck_permission_for_session, session_id, PermissionLevel.CAN_EDIT
978
+ )
979
+ await asyncio.to_thread(_require_conversation_creator, session_id)
980
+
981
+ current_user = get_current_user()
982
+ session_manager = get_session_manager()
983
+ locked = await asyncio.to_thread(session_manager.acquire_session_lock, session_id)
984
+ if not locked:
985
+ # The lock belongs to whoever holds it: do not release it.
986
+ raise HTTPException(status_code=409, detail=CONVERSATION_BUSY_DETAIL)
987
+
988
+ try:
989
+ chat_service = get_chat_service()
990
+ result = await asyncio.to_thread(
991
+ chat_service.delete_message, session_id, message_id, deleted_by=current_user
992
+ )
993
+
994
+ logger.info(
995
+ "Conversation message deleted via API",
996
+ extra={
997
+ "session_id": session_id,
998
+ "message_id": message_id,
999
+ "deleted_by": current_user,
1000
+ "deleted_messages": result.get("deleted_messages"),
1001
+ },
1002
+ )
1003
+
1004
+ return result
1005
+
1006
+ except ArcReviewInFlightError:
1007
+ # The arc-review sweeper is running a turn on this thread without the
1008
+ # session lock; the delete changed nothing and can be retried.
1009
+ raise HTTPException(status_code=409, detail=CONVERSATION_BUSY_DETAIL)
1010
+ except MessageNotFoundError:
1011
+ raise HTTPException(status_code=404, detail=MESSAGE_NOT_FOUND_DETAIL)
1012
+ except SessionNotFoundError:
1013
+ raise HTTPException(
1014
+ status_code=404,
1015
+ detail=f"Session not found: {session_id}",
1016
+ )
1017
+ except HTTPException:
1018
+ raise
1019
+ except Exception as e:
1020
+ logger.error(
1021
+ f"Failed to delete message: {e}",
1022
+ exc_info=True,
1023
+ extra={"session_id": session_id, "message_id": message_id, "deleted_by": current_user},
1024
+ )
1025
+ raise HTTPException(
1026
+ status_code=500,
1027
+ detail="Failed to delete the message",
1028
+ ) from e
1029
+ finally:
1030
+ # As in clear_session_context: a release failure must neither turn a
1031
+ # committed delete into a 500 nor mask the delete's own exception.
1032
+ try:
1033
+ await asyncio.to_thread(session_manager.release_session_lock, session_id)
1034
+ except Exception:
1035
+ logger.exception(
1036
+ "Failed to release session lock after a message delete",
1037
+ extra={"session_id": session_id},
1038
+ )
900
1039
 
901
1040
 
902
1041
  @router.get("/{session_id}/slides")
@@ -11,7 +11,10 @@ Slide access is controlled by session permissions:
11
11
  The spec-dirty trigger lives in THIS module and nowhere else
12
12
  ------------------------------------------------------------
13
13
  Five handlers below call ``spec_sync.mark_dirty`` after their mutation commits:
14
- insert, reorder, update, duplicate and delete. That is the whole of the trigger surface —
14
+ insert, reorder, update, duplicate and delete. Insert marks only when it carries
15
+ ``html``: a blank insert (the viewer's "New slide") splices a spec entry that is
16
+ already the exact description of the blank, in the same transaction as the rows, so
17
+ there is nothing for the sweeper to describe. That is the whole of the trigger surface —
15
18
  the LangGraph deck build calls the ``chat_service`` / ``slide_repository`` /
16
19
  ``deck_level_writer`` methods these handlers wrap, and never issues an HTTP
17
20
  request, so "arrived via a route" *means* "a human did this" by construction. No
@@ -41,9 +44,12 @@ from src.api.routes._authz import (
41
44
  _check_deck_permission_for_session,
42
45
  _require_slide_permission,
43
46
  )
44
- from src.api.services.chat_service import get_chat_service
47
+ from src.api.routes.sessions import CONVERSATION_BUSY_DETAIL
48
+ from src.api.services.chat_service import ArcReviewInFlightError, get_chat_service
45
49
  from src.api.services.session_manager import (
50
+ DeckBusyError,
46
51
  SessionNotFoundError,
52
+ SlideRowsChangedError,
47
53
  VersionConflictError,
48
54
  get_session_manager,
49
55
  )
@@ -58,6 +64,12 @@ logger = logging.getLogger(__name__)
58
64
 
59
65
  router = APIRouter(prefix="/api/slides", tags=["slides"])
60
66
 
67
+ # The insert's rows moved between the viewer's deck and the write (another editor, or
68
+ # a stale worker cache): nothing was written, and a refresh followed by a retry works.
69
+ DECK_CHANGED_DETAIL = (
70
+ "The deck changed while the slide was being added. Refresh and try again."
71
+ )
72
+
61
73
 
62
74
  class ReorderRequest(BaseModel):
63
75
  """Request to reorder slides."""
@@ -93,8 +105,8 @@ class InsertSlideRequest(BaseModel):
93
105
  as counting backwards from the end and land the slide somewhere the caller did
94
106
  not ask for.
95
107
 
96
- ``html`` is optional: omitted, an empty slide is inserted for a human or the
97
- architect to fill.
108
+ ``html`` is optional: omitted, the deck's blank shell (its own slide frame with
109
+ nothing on it) is inserted for a human or the architect to fill.
98
110
  """
99
111
 
100
112
  session_id: str
@@ -168,12 +180,15 @@ async def insert_slide(request: InsertSlideRequest, db: Session = Depends(get_db
168
180
  request: InsertSlideRequest with session_id, position and optional html
169
181
 
170
182
  Returns:
171
- Updated slide deck
183
+ Updated slide deck, plus ``inserted_slide_id`` and ``inserted_position``
184
+ (the viewer selects the slide it just inserted from them)
172
185
 
173
186
  Raises:
174
187
  HTTPException: 403 if no permission, 400 for validation errors, 409 if
175
- session busy or version conflict, 423 if another user holds the
176
- editing lock, 500 on error
188
+ something is running on the deck (``CONVERSATION_BUSY_DETAIL``), the
189
+ deck's rows moved under the insert (``DECK_CHANGED_DETAIL``) or the
190
+ version is stale, 423 if another user holds the editing lock, 500 on
191
+ error
177
192
  """
178
193
  _require_slide_permission(request.session_id, db, PermissionLevel.CAN_EDIT)
179
194
 
@@ -189,10 +204,8 @@ async def insert_slide(request: InsertSlideRequest, db: Session = Depends(get_db
189
204
  request.session_id,
190
205
  )
191
206
  if not locked:
192
- raise HTTPException(
193
- status_code=409,
194
- detail="Session is currently processing another request. Please wait.",
195
- )
207
+ # The lock belongs to whoever holds it: do not release it.
208
+ raise HTTPException(status_code=409, detail=CONVERSATION_BUSY_DETAIL)
196
209
 
197
210
  try:
198
211
  chat_service = get_chat_service()
@@ -202,6 +215,7 @@ async def insert_slide(request: InsertSlideRequest, db: Session = Depends(get_db
202
215
  request.position,
203
216
  html=request.html,
204
217
  expected_version=request.expected_version,
218
+ inserted_by=get_current_user(),
205
219
  )
206
220
 
207
221
  logger.info(
@@ -209,11 +223,20 @@ async def insert_slide(request: InsertSlideRequest, db: Session = Depends(get_db
209
223
  extra={"position": request.position, "session_id": request.session_id},
210
224
  )
211
225
  # A slide was added: the deck's slide list no longer matches the spec's.
212
- # The service gave the new position a PLACEHOLDER spec entry with no
213
- # purpose, so this is also what schedules the description of it.
214
- await asyncio.to_thread(mark_dirty, request.session_id, get_current_user())
226
+ # An insert that carries HTML has no description yet (the spliced spec entry
227
+ # is blank), so this is what schedules the arc review of it. A blank insert
228
+ # (no html) is already exactly described by that blank entry, so it
229
+ # schedules nothing.
230
+ if request.html is not None:
231
+ await asyncio.to_thread(mark_dirty, request.session_id, get_current_user())
215
232
  return result
216
233
 
234
+ except (ArcReviewInFlightError, DeckBusyError):
235
+ # An arc review holds a claim on the deck, or a turn is running on another
236
+ # session of it; nothing was written and the insert can be retried.
237
+ raise HTTPException(status_code=409, detail=CONVERSATION_BUSY_DETAIL)
238
+ except SlideRowsChangedError:
239
+ raise HTTPException(status_code=409, detail=DECK_CHANGED_DETAIL)
217
240
  except VersionConflictError as e:
218
241
  raise HTTPException(status_code=409, detail=str(e))
219
242
  except PermissionError as e:
@@ -21,6 +21,7 @@ class StreamEventType(str, Enum):
21
21
  SESSION_TITLE = "session_title" # Auto-generated session title
22
22
  SESSION_CREATED = "session_created" # New session created on first message
23
23
  SLIDE_READY = "slide_ready" # One committed slide released by the reorder buffer
24
+ TURN_PROGRESS = "turn_progress" # Graph turn's stage summary for the chat placeholder (#319)
24
25
 
25
26
 
26
27
  class StreamEvent(BaseModel):
@@ -40,6 +41,7 @@ class StreamEvent(BaseModel):
40
41
  scripts: One slide's per-slide JavaScript (for slide_ready events)
41
42
  agent: Which agent produced this event's subject (§7.3 attribution)
42
43
  slide_cursor: The next position not yet released (for slide_ready events)
44
+ turn_progress: The graph turn's stage summary (for turn_progress events)
43
45
  """
44
46
 
45
47
  type: StreamEventType = Field(..., description="Event type")
@@ -75,6 +77,11 @@ class StreamEvent(BaseModel):
75
77
  slide_cursor: Optional[int] = Field(
76
78
  default=None, description="Next slide position not yet released"
77
79
  )
80
+ # #319 — the graph turn's stage summary ({seq, phase, slides}); see
81
+ # src/services/graph/progress.py for the contract. Only on turn_progress events.
82
+ turn_progress: Optional[Dict[str, Any]] = Field(
83
+ default=None, description="Graph turn stage summary (for turn_progress events)"
84
+ )
78
85
 
79
86
  def to_sse(self) -> str:
80
87
  """Format event as SSE data line.