databricks-tellr-app 0.4.3.dev3449__tar.gz → 0.4.3.dev3451__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 (233) hide show
  1. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/PKG-INFO +1 -1
  2. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/databricks_tellr_app.egg-info/PKG-INFO +1 -1
  3. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/databricks_tellr_app.egg-info/SOURCES.txt +2 -0
  4. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/pyproject.toml +1 -1
  5. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/chat.py +2 -1
  6. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/services/session_manager.py +7 -0
  7. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/graph/nodes.py +188 -47
  8. databricks_tellr_app-0.4.3.dev3451/src/services/graph/user_notices.py +311 -0
  9. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/README.md +0 -0
  10. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/databricks_tellr_app/__init__.py +0 -0
  11. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/databricks_tellr_app/run.py +0 -0
  12. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/databricks_tellr_app.egg-info/dependency_links.txt +0 -0
  13. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/databricks_tellr_app.egg-info/requires.txt +0 -0
  14. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/databricks_tellr_app.egg-info/top_level.txt +0 -0
  15. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/setup.cfg +0 -0
  16. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/setup.py +0 -0
  17. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/__init__.py +0 -0
  18. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/__init__.py +0 -0
  19. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/_otel_bootstrap.py +0 -0
  20. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/fixtures/tour_demo_deck.json +0 -0
  21. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/main.py +0 -0
  22. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/mcp_auth.py +0 -0
  23. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/mcp_server.py +0 -0
  24. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/middleware/__init__.py +0 -0
  25. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/middleware/csrf.py +0 -0
  26. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/middleware/request_logging.py +0 -0
  27. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/middleware/security_headers.py +0 -0
  28. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/__init__.py +0 -0
  29. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/_authz.py +0 -0
  30. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/admin.py +0 -0
  31. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/admin_usage.py +0 -0
  32. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/agent_config.py +0 -0
  33. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/agent_definitions.py +0 -0
  34. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/deck_contributors.py +0 -0
  35. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/export.py +0 -0
  36. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/feedback.py +0 -0
  37. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/google_slides.py +0 -0
  38. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/images.py +0 -0
  39. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/local_version.py +0 -0
  40. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/profiles.py +0 -0
  41. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/sessions.py +0 -0
  42. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/settings/__init__.py +0 -0
  43. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/settings/contributors.py +0 -0
  44. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/settings/deck_prompts.py +0 -0
  45. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/settings/design_systems.py +0 -0
  46. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/settings/identities.py +0 -0
  47. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/settings/slide_styles.py +0 -0
  48. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/setup.py +0 -0
  49. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/slides.py +0 -0
  50. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/tools.py +0 -0
  51. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/tour.py +0 -0
  52. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/verification.py +0 -0
  53. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/routes/version.py +0 -0
  54. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/schemas/__init__.py +0 -0
  55. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/schemas/agent_config.py +0 -0
  56. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/schemas/agent_definitions.py +0 -0
  57. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/schemas/feedback.py +0 -0
  58. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/schemas/graph_release_history.py +0 -0
  59. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/schemas/graph_releases.py +0 -0
  60. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/schemas/requests.py +0 -0
  61. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/schemas/responses.py +0 -0
  62. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/schemas/settings/__init__.py +0 -0
  63. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/schemas/settings/requests.py +0 -0
  64. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/schemas/settings/responses.py +0 -0
  65. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/schemas/streaming.py +0 -0
  66. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/services/__init__.py +0 -0
  67. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/services/chat_service.py +0 -0
  68. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/services/deck_level_writer.py +0 -0
  69. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/services/export_job_queue.py +0 -0
  70. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/services/feedback_service.py +0 -0
  71. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/services/job_queue.py +0 -0
  72. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/services/session_naming.py +0 -0
  73. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/services/slide_repository.py +0 -0
  74. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/services/usage_events.py +0 -0
  75. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/services/usage_service.py +0 -0
  76. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/utils/__init__.py +0 -0
  77. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/api/utils/validation.py +0 -0
  78. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/__init__.py +0 -0
  79. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/backfill_session_slides_startup.py +0 -0
  80. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/checkpointer.py +0 -0
  81. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/config_loader.py +0 -0
  82. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/context_utils.py +0 -0
  83. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/database.py +0 -0
  84. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/databricks_client.py +0 -0
  85. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/defaults.py +0 -0
  86. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/encryption.py +0 -0
  87. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/init_default_profile.py +0 -0
  88. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/lakebase.py +0 -0
  89. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/migrate_profiles_to_agent_config.py +0 -0
  90. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/mlflow_agent_spans.py +0 -0
  91. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/mlflow_tracing.py +0 -0
  92. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/otel_logging.py +0 -0
  93. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/permission_context.py +0 -0
  94. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/prompt_modules.py +0 -0
  95. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/settings_db.py +0 -0
  96. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/skills/__init__.py +0 -0
  97. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/skills/architect.py +0 -0
  98. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/skills/build_reviewer.py +0 -0
  99. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/skills/builder.py +0 -0
  100. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/skills/data_analyst.py +0 -0
  101. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/skills/deck_reviewer.py +0 -0
  102. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/skills/fix_reviewer.py +0 -0
  103. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/skills/fixer.py +0 -0
  104. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/strip_retired_prompt_keys.py +0 -0
  105. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/core/user_context.py +0 -0
  106. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/database/__init__.py +0 -0
  107. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/database/models/__init__.py +0 -0
  108. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/database/models/deck_contributor.py +0 -0
  109. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/database/models/deck_review.py +0 -0
  110. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/database/models/design_system.py +0 -0
  111. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/database/models/encryption_key.py +0 -0
  112. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/database/models/feedback.py +0 -0
  113. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/database/models/genie_space.py +0 -0
  114. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/database/models/google_global_credentials.py +0 -0
  115. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/database/models/google_oauth_token.py +0 -0
  116. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/database/models/graph_checkpoint.py +0 -0
  117. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/database/models/graph_configuration.py +0 -0
  118. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/database/models/identity.py +0 -0
  119. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/database/models/image.py +0 -0
  120. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/database/models/profile.py +0 -0
  121. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/database/models/profile_contributor.py +0 -0
  122. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/database/models/prompts.py +0 -0
  123. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/database/models/request_log.py +0 -0
  124. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/database/models/session.py +0 -0
  125. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/database/models/slide_deck_prompt.py +0 -0
  126. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/database/models/slide_style_library.py +0 -0
  127. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/database/models/usage_event.py +0 -0
  128. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/database/models/user_preference.py +0 -0
  129. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/database/types.py +0 -0
  130. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/domain/__init__.py +0 -0
  131. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/domain/conversation_engine.py +0 -0
  132. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/domain/deck_spec.py +0 -0
  133. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/domain/finding.py +0 -0
  134. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/domain/skill_io.py +0 -0
  135. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/domain/slide.py +0 -0
  136. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/domain/slide_deck.py +0 -0
  137. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/__init__.py +0 -0
  138. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/agent.py +0 -0
  139. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/agent_definition_manifest_v1.py +0 -0
  140. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/agent_factory.py +0 -0
  141. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/agent_model_payload.py +0 -0
  142. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/agent_resolution.py +0 -0
  143. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/agent_runtime.py +0 -0
  144. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/agent_runtime_identity.py +0 -0
  145. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/agent_schema_registry.py +0 -0
  146. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/agent_schema_types.py +0 -0
  147. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/agent_test_workbench.py +0 -0
  148. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/collaboration_history.py +0 -0
  149. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/config_service.py +0 -0
  150. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/config_validator.py +0 -0
  151. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/conversation_pins.py +0 -0
  152. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/converter_jail/__init__.py +0 -0
  153. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/converter_jail/ast_guard.py +0 -0
  154. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/converter_jail/codeprep.py +0 -0
  155. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/converter_jail/gslides_runner.py +0 -0
  156. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/converter_jail/jail.py +0 -0
  157. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/converter_jail/pptx_runner.py +0 -0
  158. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/converter_jail/protocol.py +0 -0
  159. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/deck_css_aggregator.py +0 -0
  160. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/deck_review_store.py +0 -0
  161. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/design_system_compiler.py +0 -0
  162. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/design_system_service.py +0 -0
  163. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/design_system_templates.py +0 -0
  164. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/drive_uploader.py +0 -0
  165. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/evaluation/__init__.py +0 -0
  166. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/evaluation/llm_judge.py +0 -0
  167. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/foreman_service.py +0 -0
  168. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/gateway_openai.py +0 -0
  169. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/genie_service.py +0 -0
  170. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/google_slides_auth.py +0 -0
  171. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/google_slides_prompts_defaults.py +0 -0
  172. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/graph/__init__.py +0 -0
  173. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/graph/builder.py +0 -0
  174. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/graph/event_emitter.py +0 -0
  175. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/graph/routers.py +0 -0
  176. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/graph/state.py +0 -0
  177. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/graph_configuration.py +0 -0
  178. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/graph_configuration_bootstrap.py +0 -0
  179. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/graph_configuration_content.py +0 -0
  180. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/graph_configuration_draft.py +0 -0
  181. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/graph_configuration_publication.py +0 -0
  182. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/graph_configuration_rollback.py +0 -0
  183. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/graph_configuration_seed.py +0 -0
  184. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/graph_configuration_workbench.py +0 -0
  185. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/graph_definition_manifest.py +0 -0
  186. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/graph_release_evidence.py +0 -0
  187. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/graph_release_history.py +0 -0
  188. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/html_to_google_slides.py +0 -0
  189. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/html_to_pptx.py +0 -0
  190. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/identity_provider.py +0 -0
  191. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/identity_providers/__init__.py +0 -0
  192. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/identity_providers/account_provider.py +0 -0
  193. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/identity_providers/local_provider.py +0 -0
  194. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/identity_providers/scim_filter.py +0 -0
  195. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/identity_providers/workspace_provider.py +0 -0
  196. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/image_service.py +0 -0
  197. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/image_tools.py +0 -0
  198. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/model_endpoint_catalog.py +0 -0
  199. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/model_endpoint_probe.py +0 -0
  200. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/permission_service.py +0 -0
  201. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/persisted_graph_release.py +0 -0
  202. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/pptx_from_html_huashu.py +0 -0
  203. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/pptx_from_records.py +0 -0
  204. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/pptx_prompts_defaults.py +0 -0
  205. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/profile_service.py +0 -0
  206. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/prompt_assembler.py +0 -0
  207. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/shared_deck_attribution.py +0 -0
  208. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/spec_sync.py +0 -0
  209. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/streaming_callback.py +0 -0
  210. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/svg_sanitizer.py +0 -0
  211. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/template_sections.py +0 -0
  212. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/tools/__init__.py +0 -0
  213. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/tools/agent_bricks_tool.py +0 -0
  214. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/tools/ds_asset_tool.py +0 -0
  215. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/tools/genie_tool.py +0 -0
  216. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/tools/mcp_tool.py +0 -0
  217. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/tools/model_endpoint_tool.py +0 -0
  218. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/tools/vector_tool.py +0 -0
  219. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/services/validator.py +0 -0
  220. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/utils/__init__.py +0 -0
  221. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/utils/css_utils.py +0 -0
  222. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/utils/ds_asset_utils.py +0 -0
  223. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/utils/error_handling.py +0 -0
  224. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/utils/graph_safety.py +0 -0
  225. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/utils/html_safety.py +0 -0
  226. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/utils/html_utils.py +0 -0
  227. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/utils/image_utils.py +0 -0
  228. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/utils/js_validator.py +0 -0
  229. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/utils/logging_config.py +0 -0
  230. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/utils/pi_filter.py +0 -0
  231. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/utils/slide_hash.py +0 -0
  232. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/src/utils/spotlight.py +0 -0
  233. {databricks_tellr_app-0.4.3.dev3449 → databricks_tellr_app-0.4.3.dev3451}/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.dev3449
3
+ Version: 0.4.3.dev3451
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.dev3449
3
+ Version: 0.4.3.dev3451
4
4
  Summary: Tellr application package for Databricks Apps
5
5
  Requires-Python: >=3.10
6
6
  Description-Content-Type: text/markdown
@@ -197,6 +197,7 @@ setup.py
197
197
  ./src/services/graph/nodes.py
198
198
  ./src/services/graph/routers.py
199
199
  ./src/services/graph/state.py
200
+ ./src/services/graph/user_notices.py
200
201
  ./src/services/identity_providers/__init__.py
201
202
  ./src/services/identity_providers/account_provider.py
202
203
  ./src/services/identity_providers/local_provider.py
@@ -424,6 +425,7 @@ src/services/graph/event_emitter.py
424
425
  src/services/graph/nodes.py
425
426
  src/services/graph/routers.py
426
427
  src/services/graph/state.py
428
+ src/services/graph/user_notices.py
427
429
  src/services/identity_providers/__init__.py
428
430
  src/services/identity_providers/account_provider.py
429
431
  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.dev3449"
7
+ version = "0.4.3.dev3451"
8
8
  description = "Tellr application package for Databricks Apps"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.10"
@@ -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
@@ -3386,6 +3386,7 @@ class SessionManager:
3386
3386
  event_type = "assistant" # User messages use assistant type for display
3387
3387
 
3388
3388
  metadata = msg.get("metadata") or {}
3389
+ details = metadata.get("details")
3389
3390
 
3390
3391
  return {
3391
3392
  "type": event_type,
@@ -3394,6 +3395,12 @@ class SessionManager:
3394
3395
  "tool_input": metadata.get("tool_input"),
3395
3396
  "tool_output": msg["content"] if event_type == "tool_result" else None,
3396
3397
  "message_id": msg["id"],
3398
+ # Only a failure notice's technical detail (#321) — never the row's whole
3399
+ # metadata, which for a tool row carries its input. None on every other
3400
+ # row, including every row persisted before notices had details.
3401
+ "metadata": (
3402
+ {"details": details} if isinstance(details, dict) and details else None
3403
+ ),
3397
3404
  }
3398
3405
 
3399
3406
  def cleanup_stale_requests(self, max_age_hours: int = 24) -> int:
@@ -49,7 +49,7 @@ import logging
49
49
  import threading
50
50
  import time
51
51
  from contextvars import ContextVar
52
- from typing import Any, Dict, List, Optional, Set, get_type_hints
52
+ from typing import Any, Dict, List, Literal, Optional, Set, get_type_hints
53
53
 
54
54
  from src.api.schemas.agent_config import AgentConfig, resolve_agent_config
55
55
  from src.api.schemas.streaming import StreamEvent, StreamEventType
@@ -67,7 +67,7 @@ from src.domain.finding import (
67
67
  make_finding_id,
68
68
  )
69
69
  from src.domain.slide_deck import SlideDeck
70
- from src.services.agent import SAFETY_RETRY_NOTICE
70
+ from src.services.agent import SAFETY_RETRY_NOTICE, UnsafeContentError
71
71
  from src.services.agent_runtime import (
72
72
  AgentAssemblyContext,
73
73
  get_agent_runtime,
@@ -96,6 +96,16 @@ from src.services.graph.event_emitter import (
96
96
  get_slide_cursor,
97
97
  )
98
98
  from src.services.graph.state import GraphState, scoped, scoped_vals
99
+ from src.services.graph.user_notices import (
100
+ FailureNotice,
101
+ deck_not_updated_notice,
102
+ deck_review_failed_notice,
103
+ placeholder_notice,
104
+ slide_number,
105
+ slides_phrase,
106
+ unfinished_slides_notice,
107
+ unreviewed_slide_notice,
108
+ )
99
109
  from src.services.persisted_graph_release import PersistedRuntimeError
100
110
  from src.services.shared_deck_attribution import (
101
111
  DeckMutationContext,
@@ -1159,7 +1169,9 @@ def _write_reviewed_row(
1159
1169
  return content_hash
1160
1170
 
1161
1171
 
1162
- def _surface_notice(session_id: str, message: str) -> None:
1172
+ def _surface_notice(
1173
+ session_id: str, message: str, *, details: Optional[Dict[str, str]] = None
1174
+ ) -> None:
1163
1175
  """Persist a machine-generated advisory as an ``info`` chat message.
1164
1176
 
1165
1177
  The shipped channel for advisories the user must see, and the graph's ONE
@@ -1193,6 +1205,11 @@ def _surface_notice(session_id: str, message: str) -> None:
1193
1205
  the SSE path and the sweeper. The ``info`` TYPE is unchanged and must stay:
1194
1206
  it is what keeps these notices out of ``_conversation``, so the architect
1195
1207
  never reads a machine advisory back as its own prose.
1208
+
1209
+ ``details`` is the technical half of a plain-language notice (#321): the
1210
+ stage, the error class or code, and the request id. It is persisted as the
1211
+ row's ``metadata["details"]`` and shown behind a collapsed disclosure in chat,
1212
+ never as the headline. It never carries exception text.
1196
1213
  """
1197
1214
  try:
1198
1215
  get_session_manager().add_message(
@@ -1201,11 +1218,57 @@ def _surface_notice(session_id: str, message: str) -> None:
1201
1218
  content=message,
1202
1219
  message_type="info",
1203
1220
  request_id=get_chat_request_id(),
1221
+ metadata={"details": dict(details)} if details else None,
1204
1222
  )
1205
1223
  except Exception:
1206
1224
  logger.warning("Could not surface a failure notice", exc_info=True)
1207
1225
 
1208
1226
 
1227
+ def _surface_failure_notice(session_id: str, notice: FailureNotice) -> None:
1228
+ """Log and persist a plain-language failure notice (#321).
1229
+
1230
+ The only sanctioned way to write a details-bearing notice: it writes the one
1231
+ ``graph_failure_notice`` WARNING for the failure, then the ``info`` chat row
1232
+ through :func:`_surface_notice` with the notice's ``details`` as the row's
1233
+ metadata. A site that called ``_surface_notice(..., details=...)`` directly
1234
+ would skip the log line, which is why an AST test forbids it.
1235
+
1236
+ The log fields go in the **message**, not only in ``extra``: the production
1237
+ root logger formats the message alone, so a field that lived only in ``extra``
1238
+ would never reach the deployed log. ``extra`` is kept for any structured
1239
+ handler wired later. ``positions=`` is labelled as positions because the
1240
+ values are **0-based**; nobody should read them as slide numbers. The
1241
+ ``request_id`` is the repo's own key for the turn's id.
1242
+
1243
+ Never raises. A failed log line must not cost the chat row, and
1244
+ :func:`_surface_notice` already swallows its own write failure.
1245
+ """
1246
+ try:
1247
+ request_id = notice.details.get("request_id")
1248
+ positions = list(notice.positions)
1249
+ logger.warning(
1250
+ "graph_failure_notice kind=%s stage=%s error=%s positions=%s "
1251
+ "request_id=%s session_id=%s",
1252
+ notice.kind,
1253
+ notice.stage,
1254
+ notice.error,
1255
+ positions,
1256
+ request_id,
1257
+ session_id,
1258
+ extra={
1259
+ "notice_kind": notice.kind,
1260
+ "graph_stage": notice.stage,
1261
+ "error_class": notice.error,
1262
+ "positions": positions,
1263
+ "request_id": request_id,
1264
+ "session_id": session_id,
1265
+ },
1266
+ )
1267
+ except Exception:
1268
+ logger.warning("Could not log a failure notice", exc_info=True)
1269
+ _surface_notice(session_id, notice.text, details=notice.details)
1270
+
1271
+
1209
1272
  def _placehold_failed_position(
1210
1273
  position: int,
1211
1274
  *,
@@ -1213,6 +1276,7 @@ def _placehold_failed_position(
1213
1276
  node: str,
1214
1277
  reason: str,
1215
1278
  mutation: DeckMutationContext,
1279
+ error: Optional[BaseException] = None,
1216
1280
  ) -> bool:
1217
1281
  """Commit a terminal placeholder for one failed branch, visibly.
1218
1282
 
@@ -1230,7 +1294,8 @@ def _placehold_failed_position(
1230
1294
 
1231
1295
  **Every path that placeholds a position takes this one function and gets the
1232
1296
  same three surfaces**: the row's error marker, an ``ERROR`` stream event, and
1233
- a durable ``info`` chat line. All four of them — the three pipeline stages
1297
+ a durable ``info`` chat line (plain language, through
1298
+ :func:`_surface_failure_notice`). All four of them — the three pipeline stages
1234
1299
  (``builder``, ``build_reviewer``, ``fix_reviewer``'s undeliverable-row
1235
1300
  path) and ``placeholder_node``'s stall path. There is no flag to make one quieter
1236
1301
  than another, deliberately: the emitter is optional and is ``None`` on the
@@ -1257,13 +1322,34 @@ def _placehold_failed_position(
1257
1322
  So the failure is never silent, whichever node hit it, and the exception is
1258
1323
  logged with its traceback either way.
1259
1324
 
1325
+ **What the user reads (#321).** The chat line and the event are plain
1326
+ language from :func:`placeholder_notice`, numbered 1-based as the UI numbers
1327
+ slides, with the technical side (``stage``, ``error``, ``request_id``) behind
1328
+ ``details``. ``position`` is the 0-based position everywhere in data (event
1329
+ metadata, the row marker, the log). The event is emitted before the commit,
1330
+ when no placeholder exists yet, so it carries the notice's ``headline``, which
1331
+ claims nothing about the slide's state; the chat line, written only after the
1332
+ placeholder reads back, carries the full ``text`` and the one
1333
+ ``graph_failure_notice`` log record. ``reason`` is the row's error marker and
1334
+ goes to ``commit_placeholder`` verbatim. ``error`` is the caught exception,
1335
+ when there is one: it is used only to recognise a safety-gate block
1336
+ (``UnsafeContentError``), and only its class name, never its text, can reach
1337
+ the notice.
1338
+
1260
1339
  ``commit_placeholder`` takes neither ``modified_by`` nor ``deck_spec_slide``
1261
1340
  (Ruling C-15), so these rows ship with a NULL author here too.
1262
1341
  """
1342
+ notice = placeholder_notice(
1343
+ position,
1344
+ stage=node,
1345
+ error=reason,
1346
+ unsafe=isinstance(error, UnsafeContentError),
1347
+ request_id=get_chat_request_id(),
1348
+ )
1263
1349
  _emit(
1264
1350
  StreamEventType.ERROR,
1265
- error=f"Slide {position} could not be generated.",
1266
- metadata={"node": node, "position": position},
1351
+ error=notice.headline,
1352
+ metadata={"node": node, "position": position, "details": dict(notice.details)},
1267
1353
  )
1268
1354
  writer = SlideWriter()
1269
1355
  try:
@@ -1288,11 +1374,7 @@ def _placehold_failed_position(
1288
1374
  position,
1289
1375
  )
1290
1376
  return False
1291
- _surface_notice(
1292
- session_id,
1293
- f"Slide {position} could not be generated and has been left as a "
1294
- f"placeholder ({node}: {reason}). The rest of the deck is unaffected.",
1295
- )
1377
+ _surface_failure_notice(session_id, notice)
1296
1378
  return True
1297
1379
 
1298
1380
 
@@ -1870,7 +1952,7 @@ def architect_node(state: dict) -> Dict[str, Any]:
1870
1952
  f"The deck's brief changed, so I re-checked all "
1871
1953
  f"{len(verdicts['committed'])} slide(s) against it. "
1872
1954
  + (
1873
- f"Rebuilding {len(rebuild)}: {rebuild}."
1955
+ f"Rebuilding {slides_phrase(rebuild)}."
1874
1956
  if rebuild
1875
1957
  else "Every slide still fits, so I am rebuilding none."
1876
1958
  )
@@ -2178,13 +2260,31 @@ def foreman_node(state: dict) -> Dict[str, Any]:
2178
2260
  f"positions {outstanding}."
2179
2261
  )
2180
2262
  logger.error("Foreman reached END with uncommitted positions: %s", outstanding)
2181
- _emit(StreamEventType.ERROR, error=message, metadata={"node": "foreman"})
2182
- # Through `_surface_notice`, the shipped ungated writer, rather than a
2183
- # hand-rolled `add_message`: that is where the request-id tag lives, and an
2184
- # untagged row never reaches `GET /chat/poll`. NOT through `_say` — this
2185
- # notice is a machine advisory that must be durable on every turn, and `_say`
2186
- # suppresses a describe-only one.
2187
- _surface_notice(state["session_id"], message)
2263
+ # The technical `message` above stays for the log and `error_state`; the user
2264
+ # reads the plain-language notice instead (#321). Guarded on `outstanding`:
2265
+ # the catalogue refuses an empty position list, and the foreman must never
2266
+ # crash the turn over the wording of its own failure notice. `error_state` is
2267
+ # set either way.
2268
+ if outstanding:
2269
+ notice = unfinished_slides_notice(
2270
+ outstanding, request_id=get_chat_request_id()
2271
+ )
2272
+ _emit(
2273
+ StreamEventType.ERROR,
2274
+ error=notice.text,
2275
+ metadata={
2276
+ "node": "foreman",
2277
+ "positions": outstanding,
2278
+ "details": dict(notice.details),
2279
+ },
2280
+ )
2281
+ # Through `_surface_failure_notice` -> `_surface_notice`, the shipped
2282
+ # ungated writer, rather than a hand-rolled `add_message`: that is where
2283
+ # the request-id tag lives, and an untagged row never reaches
2284
+ # `GET /chat/poll`. NOT through `_say` — this notice is a machine
2285
+ # advisory that must be durable on every turn, and `_say` suppresses a
2286
+ # describe-only one.
2287
+ _surface_failure_notice(state["session_id"], notice)
2188
2288
  updates["error_state"] = {
2189
2289
  "node": "foreman",
2190
2290
  "code": "end_with_outstanding_positions",
@@ -2320,6 +2420,7 @@ def builder_node(payload: dict) -> Dict[str, Any]:
2320
2420
  session_id=session_id,
2321
2421
  node="builder",
2322
2422
  reason=type(exc).__name__,
2423
+ error=exc,
2323
2424
  mutation=mutation,
2324
2425
  ):
2325
2426
  return {}
@@ -2459,7 +2560,7 @@ def build_reviewer_node(payload: dict) -> Dict[str, Any]:
2459
2560
  )
2460
2561
  _emit(
2461
2562
  StreamEventType.ASSISTANT,
2462
- content=f"Slide {position} reviewed: {verdict}.",
2563
+ content=f"Slide {slide_number(position)} reviewed: {verdict}.",
2463
2564
  metadata={"node": "build_reviewer", "position": position,
2464
2565
  "verdict": verdict},
2465
2566
  )
@@ -2492,6 +2593,7 @@ def build_reviewer_node(payload: dict) -> Dict[str, Any]:
2492
2593
  session_id=session_id,
2493
2594
  node="build_reviewer",
2494
2595
  reason=type(exc).__name__,
2596
+ error=exc,
2495
2597
  mutation=mutation,
2496
2598
  ):
2497
2599
  return {}
@@ -2928,6 +3030,7 @@ def fix_reviewer_node(state: dict) -> Dict[str, Any]:
2928
3030
  session_id=session_id,
2929
3031
  node="fix_reviewer",
2930
3032
  reason=type(exc).__name__,
3033
+ error=exc,
2931
3034
  mutation=mutation,
2932
3035
  ):
2933
3036
  updates["placeheld_positions"] = scoped(turn_id, {position})
@@ -2935,7 +3038,7 @@ def fix_reviewer_node(state: dict) -> Dict[str, Any]:
2935
3038
 
2936
3039
  _emit(
2937
3040
  StreamEventType.ASSISTANT,
2938
- content=f"Slide {position} fix reviewed: {verdict}.",
3041
+ content=f"Slide {slide_number(position)} fix reviewed: {verdict}.",
2939
3042
  metadata={"node": "fix_reviewer", "position": position, "verdict": verdict},
2940
3043
  )
2941
3044
 
@@ -2997,12 +3100,30 @@ def _fix_slots() -> threading.BoundedSemaphore:
2997
3100
  return _fix_slots_var.get() or _DEFAULT_FIX_SLOTS
2998
3101
 
2999
3102
 
3000
- def _transient_failure_notice(session_id: str, position: int, what: str) -> None:
3001
- """Say in chat which slide could not be finished because a model call failed."""
3002
- _surface_notice(
3103
+ def _transient_failure_notice(
3104
+ session_id: str, position: int, *, during: Literal["review", "fix"]
3105
+ ) -> None:
3106
+ """Say in chat which slide was kept as built because a model call failed.
3107
+
3108
+ Plain language (#321): :func:`unreviewed_slide_notice` names the slide by its
3109
+ 1-based number (*position* is the 0-based position), says the AI service was
3110
+ briefly unavailable, and offers one action. ``during`` is the literal
3111
+ ``"review"`` (the slide was not checked) or ``"fix"`` (its automatic fix was
3112
+ skipped); anything else raises in the catalogue, so callers pass only those
3113
+ two literals. The notice carries ``details`` (stage, the fixed error code and
3114
+ the request id) and is logged once through :func:`_surface_failure_notice`.
3115
+
3116
+ The caught exception is deliberately **not** a parameter: a transient fault
3117
+ is always a ``PersistedRuntimeError`` subclass, whose name must never reach a
3118
+ user-visible disclosure (#271), and ``str(exc)`` can echo model output. The
3119
+ useful cause is on the ``raise ... from`` chain, which the caller's
3120
+ ``logger.warning(..., exc_info=True)`` already logs.
3121
+ """
3122
+ _surface_failure_notice(
3003
3123
  session_id,
3004
- f"Slide {position}: the model was briefly unavailable while it was being "
3005
- f"{what}, so it is shown as built.",
3124
+ unreviewed_slide_notice(
3125
+ position, during=during, request_id=get_chat_request_id()
3126
+ ),
3006
3127
  )
3007
3128
 
3008
3129
 
@@ -3157,7 +3278,7 @@ def slide_pipeline_node(payload: dict) -> Dict[str, Any]:
3157
3278
  position,
3158
3279
  exc_info=True,
3159
3280
  )
3160
- _transient_failure_notice(session_id, position, "reviewed")
3281
+ _transient_failure_notice(session_id, position, during="review")
3161
3282
  _fold(
3162
3283
  acc,
3163
3284
  {
@@ -3198,7 +3319,7 @@ def slide_pipeline_node(payload: dict) -> Dict[str, Any]:
3198
3319
  position,
3199
3320
  exc_info=True,
3200
3321
  )
3201
- _transient_failure_notice(session_id, position, "fixed")
3322
+ _transient_failure_notice(session_id, position, during="fix")
3202
3323
  _fold(
3203
3324
  acc,
3204
3325
  {
@@ -3381,6 +3502,10 @@ def deck_reviewer_node(state: dict) -> Dict[str, Any]:
3381
3502
  # ("leave the stored value alone"), so omitting one erases nothing.
3382
3503
  deck_write: Dict[str, Any] = {}
3383
3504
  derivation_error: Optional[str] = None
3505
+ # Set on the two paths whose advisory is a plain-language failure notice
3506
+ # (derivation failed, review failed); `None` on the success path, whose
3507
+ # advisory text (#316) and metadata stay exactly as they were.
3508
+ advisory_notice: Optional[FailureNotice] = None
3384
3509
  try:
3385
3510
  deck_dict = manager.get_slide_deck(session_id) or {}
3386
3511
  deck = SlideDeck.from_dict(deck_dict)
@@ -3439,11 +3564,13 @@ def deck_reviewer_node(state: dict) -> Dict[str, Any]:
3439
3564
  "code": "deck_level_write_failed",
3440
3565
  "message": type(exc).__name__,
3441
3566
  }
3442
- _surface_notice(
3567
+ _surface_failure_notice(
3443
3568
  session_id,
3444
- "The deck's slides were saved, but the deck's own record of them "
3445
- "could not be updated this turn "
3446
- f"(deck_reviewer: {type(exc).__name__}).",
3569
+ deck_not_updated_notice(
3570
+ review_skipped=False,
3571
+ error=type(exc).__name__,
3572
+ request_id=get_chat_request_id(),
3573
+ ),
3447
3574
  )
3448
3575
 
3449
3576
  if derivation_error is not None:
@@ -3452,11 +3579,12 @@ def deck_reviewer_node(state: dict) -> Dict[str, Any]:
3452
3579
  # user "no narrative issues found across the deck" about a deck this node
3453
3580
  # could not read — the misleading half of the F1b outcome. The advisory
3454
3581
  # IS the notice on this path, so the user gets exactly one honest line.
3455
- advisory = (
3456
- "Your slides were saved, but the deck's own record of them could not "
3457
- "be updated this turn, so the deck-level review was skipped "
3458
- f"(deck_reviewer: {derivation_error})."
3582
+ advisory_notice = deck_not_updated_notice(
3583
+ review_skipped=True,
3584
+ error=derivation_error,
3585
+ request_id=get_chat_request_id(),
3459
3586
  )
3587
+ advisory = advisory_notice.text
3460
3588
  else:
3461
3589
  try:
3462
3590
  digest = compute_deck_digest(slide_htmls)
@@ -3500,30 +3628,43 @@ def deck_reviewer_node(state: dict) -> Dict[str, Any]:
3500
3628
  except Exception as exc:
3501
3629
  _raise_if_persisted_runtime_failure(exc)
3502
3630
  logger.exception("Deck review failed; the delivered deck stands")
3503
- advisory = (
3504
- "The deck is complete, but the deck-level review could not be "
3505
- "completed this turn."
3631
+ advisory_notice = deck_review_failed_notice(
3632
+ error=type(exc).__name__,
3633
+ request_id=get_chat_request_id(),
3506
3634
  )
3635
+ advisory = advisory_notice.text
3507
3636
  updates["error_state"] = {
3508
3637
  "node": "deck_reviewer",
3509
3638
  "code": "deck_review_failed",
3510
3639
  "message": type(exc).__name__,
3511
3640
  }
3512
3641
 
3513
- # Through `_surface_notice`, the shipped ungated writer, rather than a
3514
- # hand-rolled `add_message`: that is where the request-id tag lives, and an
3515
- # untagged row never reaches `GET /chat/poll`. NOT through `_say`, which
3516
- # suppresses a describe-only turn's write — a describe-only turn cannot reach
3517
- # this node today (`architect_router` ends it first) but the unit suite calls
3518
- # this node directly with the flag set and PINS that the advisory still lands,
3642
+ # Through `_surface_notice` (a failure notice through `_surface_failure_notice`,
3643
+ # which calls it), the shipped ungated writer, rather than a hand-rolled
3644
+ # `add_message`: that is where the request-id tag lives, and an untagged row
3645
+ # never reaches `GET /chat/poll`. NOT through `_say`, which suppresses a
3646
+ # describe-only turn's write — a describe-only turn cannot reach this node
3647
+ # today (`architect_router` ends it first) but the unit suite calls this node
3648
+ # directly with the flag set and PINS that the advisory still lands,
3519
3649
  # deliberately: "gating the advisory is a change to what the user is told".
3520
3650
  # The `info` TYPE is load-bearing and unchanged — its exclusion from
3521
3651
  # `_AI_TYPES` keeps this advisory out of the architect's replayed conversation.
3522
- _surface_notice(session_id, advisory)
3652
+ # The success path's advisory (`_advisory_text`, #316) carries no `details`.
3653
+ if advisory_notice is not None:
3654
+ _surface_failure_notice(session_id, advisory_notice)
3655
+ else:
3656
+ _surface_notice(session_id, advisory)
3523
3657
  _emit(
3524
3658
  StreamEventType.ASSISTANT,
3525
3659
  content=advisory,
3526
- metadata={"node": "deck_reviewer"},
3660
+ metadata={
3661
+ "node": "deck_reviewer",
3662
+ **(
3663
+ {"details": dict(advisory_notice.details)}
3664
+ if advisory_notice is not None
3665
+ else {}
3666
+ ),
3667
+ },
3527
3668
  )
3528
3669
 
3529
3670
  return updates