databricks-tellr-app 0.4.3.dev3453__tar.gz → 0.4.3.dev3454__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 (235) hide show
  1. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/PKG-INFO +1 -1
  2. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/databricks_tellr_app.egg-info/PKG-INFO +1 -1
  3. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/databricks_tellr_app.egg-info/SOURCES.txt +2 -2
  4. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/pyproject.toml +1 -1
  5. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/services/session_manager.py +0 -11
  6. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/skills/architect.py +14 -0
  7. databricks_tellr_app-0.4.3.dev3454/src/domain/slide_numbering.py +468 -0
  8. databricks_tellr_app-0.4.3.dev3454/src/services/agent_definition_manifest_v1.py +3 -0
  9. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/agent_model_payload.py +2 -0
  10. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/graph/nodes.py +82 -48
  11. databricks_tellr_app-0.4.3.dev3453/src/domain/finding_copy.py +0 -155
  12. databricks_tellr_app-0.4.3.dev3453/src/services/agent_definition_manifest_v1.py +0 -3
  13. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/README.md +0 -0
  14. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/databricks_tellr_app/__init__.py +0 -0
  15. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/databricks_tellr_app/run.py +0 -0
  16. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/databricks_tellr_app.egg-info/dependency_links.txt +0 -0
  17. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/databricks_tellr_app.egg-info/requires.txt +0 -0
  18. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/databricks_tellr_app.egg-info/top_level.txt +0 -0
  19. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/setup.cfg +0 -0
  20. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/setup.py +0 -0
  21. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/__init__.py +0 -0
  22. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/__init__.py +0 -0
  23. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/_otel_bootstrap.py +0 -0
  24. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/fixtures/tour_demo_deck.json +0 -0
  25. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/main.py +0 -0
  26. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/mcp_auth.py +0 -0
  27. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/mcp_server.py +0 -0
  28. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/middleware/__init__.py +0 -0
  29. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/middleware/csrf.py +0 -0
  30. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/middleware/request_logging.py +0 -0
  31. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/middleware/security_headers.py +0 -0
  32. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/__init__.py +0 -0
  33. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/_authz.py +0 -0
  34. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/admin.py +0 -0
  35. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/admin_usage.py +0 -0
  36. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/agent_config.py +0 -0
  37. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/agent_definitions.py +0 -0
  38. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/chat.py +0 -0
  39. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/deck_contributors.py +0 -0
  40. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/export.py +0 -0
  41. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/feedback.py +0 -0
  42. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/google_slides.py +0 -0
  43. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/images.py +0 -0
  44. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/local_version.py +0 -0
  45. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/profiles.py +0 -0
  46. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/sessions.py +0 -0
  47. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/settings/__init__.py +0 -0
  48. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/settings/contributors.py +0 -0
  49. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/settings/deck_prompts.py +0 -0
  50. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/settings/design_systems.py +0 -0
  51. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/settings/identities.py +0 -0
  52. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/settings/slide_styles.py +0 -0
  53. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/setup.py +0 -0
  54. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/slides.py +0 -0
  55. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/tools.py +0 -0
  56. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/tour.py +0 -0
  57. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/verification.py +0 -0
  58. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/routes/version.py +0 -0
  59. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/schemas/__init__.py +0 -0
  60. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/schemas/agent_config.py +0 -0
  61. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/schemas/agent_definitions.py +0 -0
  62. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/schemas/feedback.py +0 -0
  63. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/schemas/graph_release_history.py +0 -0
  64. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/schemas/graph_releases.py +0 -0
  65. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/schemas/requests.py +0 -0
  66. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/schemas/responses.py +0 -0
  67. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/schemas/settings/__init__.py +0 -0
  68. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/schemas/settings/requests.py +0 -0
  69. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/schemas/settings/responses.py +0 -0
  70. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/schemas/streaming.py +0 -0
  71. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/services/__init__.py +0 -0
  72. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/services/chat_service.py +0 -0
  73. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/services/deck_level_writer.py +0 -0
  74. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/services/export_job_queue.py +0 -0
  75. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/services/feedback_service.py +0 -0
  76. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/services/job_queue.py +0 -0
  77. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/services/session_naming.py +0 -0
  78. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/services/slide_repository.py +0 -0
  79. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/services/usage_events.py +0 -0
  80. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/services/usage_service.py +0 -0
  81. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/utils/__init__.py +0 -0
  82. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/api/utils/validation.py +0 -0
  83. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/__init__.py +0 -0
  84. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/backfill_session_slides_startup.py +0 -0
  85. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/checkpointer.py +0 -0
  86. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/config_loader.py +0 -0
  87. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/context_utils.py +0 -0
  88. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/database.py +0 -0
  89. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/databricks_client.py +0 -0
  90. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/defaults.py +0 -0
  91. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/encryption.py +0 -0
  92. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/init_default_profile.py +0 -0
  93. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/lakebase.py +0 -0
  94. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/migrate_profiles_to_agent_config.py +0 -0
  95. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/mlflow_agent_spans.py +0 -0
  96. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/mlflow_tracing.py +0 -0
  97. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/otel_logging.py +0 -0
  98. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/permission_context.py +0 -0
  99. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/prompt_modules.py +0 -0
  100. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/settings_db.py +0 -0
  101. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/skills/__init__.py +0 -0
  102. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/skills/build_reviewer.py +0 -0
  103. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/skills/builder.py +0 -0
  104. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/skills/data_analyst.py +0 -0
  105. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/skills/deck_reviewer.py +0 -0
  106. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/skills/fix_reviewer.py +0 -0
  107. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/skills/fixer.py +0 -0
  108. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/strip_retired_prompt_keys.py +0 -0
  109. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/core/user_context.py +0 -0
  110. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/database/__init__.py +0 -0
  111. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/database/models/__init__.py +0 -0
  112. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/database/models/deck_contributor.py +0 -0
  113. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/database/models/deck_review.py +0 -0
  114. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/database/models/design_system.py +0 -0
  115. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/database/models/encryption_key.py +0 -0
  116. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/database/models/feedback.py +0 -0
  117. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/database/models/genie_space.py +0 -0
  118. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/database/models/google_global_credentials.py +0 -0
  119. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/database/models/google_oauth_token.py +0 -0
  120. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/database/models/graph_checkpoint.py +0 -0
  121. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/database/models/graph_configuration.py +0 -0
  122. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/database/models/identity.py +0 -0
  123. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/database/models/image.py +0 -0
  124. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/database/models/profile.py +0 -0
  125. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/database/models/profile_contributor.py +0 -0
  126. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/database/models/prompts.py +0 -0
  127. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/database/models/request_log.py +0 -0
  128. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/database/models/session.py +0 -0
  129. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/database/models/slide_deck_prompt.py +0 -0
  130. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/database/models/slide_style_library.py +0 -0
  131. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/database/models/usage_event.py +0 -0
  132. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/database/models/user_preference.py +0 -0
  133. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/database/types.py +0 -0
  134. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/domain/__init__.py +0 -0
  135. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/domain/conversation_engine.py +0 -0
  136. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/domain/deck_spec.py +0 -0
  137. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/domain/finding.py +0 -0
  138. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/domain/skill_io.py +0 -0
  139. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/domain/slide.py +0 -0
  140. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/domain/slide_deck.py +0 -0
  141. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/__init__.py +0 -0
  142. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/agent.py +0 -0
  143. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/agent_factory.py +0 -0
  144. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/agent_resolution.py +0 -0
  145. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/agent_runtime.py +0 -0
  146. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/agent_runtime_identity.py +0 -0
  147. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/agent_schema_registry.py +0 -0
  148. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/agent_schema_types.py +0 -0
  149. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/agent_test_workbench.py +0 -0
  150. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/collaboration_history.py +0 -0
  151. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/config_service.py +0 -0
  152. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/config_validator.py +0 -0
  153. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/conversation_pins.py +0 -0
  154. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/converter_jail/__init__.py +0 -0
  155. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/converter_jail/ast_guard.py +0 -0
  156. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/converter_jail/codeprep.py +0 -0
  157. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/converter_jail/gslides_runner.py +0 -0
  158. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/converter_jail/jail.py +0 -0
  159. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/converter_jail/pptx_runner.py +0 -0
  160. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/converter_jail/protocol.py +0 -0
  161. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/deck_css_aggregator.py +0 -0
  162. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/deck_review_store.py +0 -0
  163. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/design_system_compiler.py +0 -0
  164. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/design_system_service.py +0 -0
  165. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/design_system_templates.py +0 -0
  166. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/drive_uploader.py +0 -0
  167. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/evaluation/__init__.py +0 -0
  168. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/evaluation/llm_judge.py +0 -0
  169. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/foreman_service.py +0 -0
  170. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/gateway_openai.py +0 -0
  171. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/genie_service.py +0 -0
  172. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/google_slides_auth.py +0 -0
  173. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/google_slides_prompts_defaults.py +0 -0
  174. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/graph/__init__.py +0 -0
  175. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/graph/builder.py +0 -0
  176. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/graph/event_emitter.py +0 -0
  177. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/graph/routers.py +0 -0
  178. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/graph/state.py +0 -0
  179. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/graph_configuration.py +0 -0
  180. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/graph_configuration_bootstrap.py +0 -0
  181. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/graph_configuration_content.py +0 -0
  182. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/graph_configuration_draft.py +0 -0
  183. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/graph_configuration_publication.py +0 -0
  184. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/graph_configuration_rollback.py +0 -0
  185. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/graph_configuration_seed.py +0 -0
  186. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/graph_configuration_workbench.py +0 -0
  187. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/graph_definition_manifest.py +0 -0
  188. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/graph_release_evidence.py +0 -0
  189. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/graph_release_history.py +0 -0
  190. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/html_to_google_slides.py +0 -0
  191. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/html_to_pptx.py +0 -0
  192. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/identity_provider.py +0 -0
  193. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/identity_providers/__init__.py +0 -0
  194. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/identity_providers/account_provider.py +0 -0
  195. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/identity_providers/local_provider.py +0 -0
  196. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/identity_providers/scim_filter.py +0 -0
  197. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/identity_providers/workspace_provider.py +0 -0
  198. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/image_service.py +0 -0
  199. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/image_tools.py +0 -0
  200. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/model_endpoint_catalog.py +0 -0
  201. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/model_endpoint_probe.py +0 -0
  202. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/permission_service.py +0 -0
  203. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/persisted_graph_release.py +0 -0
  204. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/pptx_from_html_huashu.py +0 -0
  205. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/pptx_from_records.py +0 -0
  206. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/pptx_prompts_defaults.py +0 -0
  207. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/profile_service.py +0 -0
  208. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/prompt_assembler.py +0 -0
  209. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/shared_deck_attribution.py +0 -0
  210. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/spec_sync.py +0 -0
  211. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/streaming_callback.py +0 -0
  212. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/svg_sanitizer.py +0 -0
  213. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/template_sections.py +0 -0
  214. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/tools/__init__.py +0 -0
  215. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/tools/agent_bricks_tool.py +0 -0
  216. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/tools/ds_asset_tool.py +0 -0
  217. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/tools/genie_tool.py +0 -0
  218. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/tools/mcp_tool.py +0 -0
  219. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/tools/model_endpoint_tool.py +0 -0
  220. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/tools/vector_tool.py +0 -0
  221. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/services/validator.py +0 -0
  222. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/utils/__init__.py +0 -0
  223. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/utils/css_utils.py +0 -0
  224. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/utils/ds_asset_utils.py +0 -0
  225. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/utils/error_handling.py +0 -0
  226. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/utils/graph_safety.py +0 -0
  227. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/utils/html_safety.py +0 -0
  228. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/utils/html_utils.py +0 -0
  229. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/utils/image_utils.py +0 -0
  230. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/utils/js_validator.py +0 -0
  231. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/utils/logging_config.py +0 -0
  232. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/utils/pi_filter.py +0 -0
  233. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/utils/slide_hash.py +0 -0
  234. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/src/utils/spotlight.py +0 -0
  235. {databricks_tellr_app-0.4.3.dev3453 → databricks_tellr_app-0.4.3.dev3454}/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.dev3453
3
+ Version: 0.4.3.dev3454
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.dev3453
3
+ Version: 0.4.3.dev3454
4
4
  Summary: Tellr application package for Databricks Apps
5
5
  Requires-Python: >=3.10
6
6
  Description-Content-Type: text/markdown
@@ -122,10 +122,10 @@ setup.py
122
122
  ./src/domain/conversation_engine.py
123
123
  ./src/domain/deck_spec.py
124
124
  ./src/domain/finding.py
125
- ./src/domain/finding_copy.py
126
125
  ./src/domain/skill_io.py
127
126
  ./src/domain/slide.py
128
127
  ./src/domain/slide_deck.py
128
+ ./src/domain/slide_numbering.py
129
129
  ./src/services/__init__.py
130
130
  ./src/services/agent.py
131
131
  ./src/services/agent_definition_manifest_v1.py
@@ -350,10 +350,10 @@ src/domain/__init__.py
350
350
  src/domain/conversation_engine.py
351
351
  src/domain/deck_spec.py
352
352
  src/domain/finding.py
353
- src/domain/finding_copy.py
354
353
  src/domain/skill_io.py
355
354
  src/domain/slide.py
356
355
  src/domain/slide_deck.py
356
+ src/domain/slide_numbering.py
357
357
  src/services/__init__.py
358
358
  src/services/agent.py
359
359
  src/services/agent_definition_manifest_v1.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.dev3453"
7
+ version = "0.4.3.dev3454"
8
8
  description = "Tellr application package for Databricks Apps"
9
9
  readme = "README.md"
10
10
  requires-python = ">=3.10"
@@ -30,7 +30,6 @@ from src.database.models.session import (
30
30
  UserSession,
31
31
  )
32
32
  from src.domain.finding import findings_from_record
33
- from src.domain.finding_copy import plain_finding_issue, plain_finding_message
34
33
  from src.services.conversation_pins import (
35
34
  get_conversation_graph_version,
36
35
  get_conversation_graph_versions,
@@ -196,21 +195,11 @@ def _finding_to_camel(finding: Any) -> Dict[str, Any]:
196
195
  added to ``Finding`` mirrors automatically;
197
196
  ``tests/unit/test_finding_conformance.py`` is the guard that the TypeScript
198
197
  declaration gained the same field.
199
-
200
- ``plainMessage`` and ``plainIssue`` are the two projection-only keys: they are
201
- derived here at read time (``src/domain/finding_copy.py``), are not ``Finding``
202
- fields, and are never persisted. ``PROJECTION_ONLY_FIELDS`` in
203
- ``tests/unit/test_finding_conformance.py`` pins them.
204
198
  """
205
199
  camel: Dict[str, Any] = {}
206
200
  for key, value in finding.model_dump().items():
207
201
  head, *rest = key.split("_")
208
202
  camel[head + "".join(part.capitalize() for part in rest)] = value
209
- # Derived, read-time only (#316): never Finding fields (that would move the
210
- # reviewers' output-schema digests) and never persisted. See
211
- # src/domain/finding_copy.py.
212
- camel["plainMessage"] = plain_finding_message(finding)
213
- camel["plainIssue"] = plain_finding_issue(finding)
214
203
  return camel
215
204
 
216
205
 
@@ -114,6 +114,20 @@ INSTRUCTIONS: str = (
114
114
  "markup. Style assets are identity, not evidence.\n"
115
115
  "Do not plan exhibits onto missing data; prefer `ask_data`.\n\n"
116
116
  "SLIDE NUMBERS\n"
117
+ "The user numbers slides from 1, in the order the deck is presented, as the "
118
+ "UI shows them. A slide's `position` is its 0-indexed identity in deck_spec "
119
+ "and is never the number the user says. The payload's `slide_numbering` maps "
120
+ "each slide of the current deck from its `slide_number` to its `position`, "
121
+ "and `slide_references` lists the slides the user's latest message names by "
122
+ "number or ordinal, already resolved to `positions`. Take target_positions "
123
+ "from `slide_references` when the user's phrase was resolved; for a slide "
124
+ "number or ordinal it does not resolve, look the slide up in "
125
+ "`slide_numbering`. Never compute a position as the slide number minus one. "
126
+ "A reference with numbers in `out_of_range` names a slide this deck does not "
127
+ "have: do not edit; use discuss and say how many slides the deck has. When "
128
+ "the user names a slide by its content rather than its number, find it in "
129
+ "current_deck_spec. A reference says which slide the user means, not that "
130
+ "they want it changed: decide the intent from what the user asks for.\n"
117
131
  "In `message` only, speak about slides 1-indexed, matching the UI. "
118
132
  "`position` and `target_positions` stay 0-indexed.\n\n"
119
133
  "Return an ArchitectOutput. Do not include prose outside the structured output."
@@ -0,0 +1,468 @@
1
+ """Deterministic slide numbers: resolve what a user typed to ``SlideSpec.position``.
2
+
3
+ Users say "slide 2", "the second slide", "the last slide" or "slides 2-4"; the
4
+ architect needs ``SlideSpec.position`` values. Left to the model, "slide 2" is
5
+ sometimes read as 0-indexed (position 2 instead of 1). This module does the
6
+ mapping in code, so ``architect_node`` can hand the model positions to copy.
7
+ It is pure: no I/O, no state, and it imports only ``re`` and ``typing``.
8
+
9
+ Issue #314 (insert a slide) builds on the rules below; they are pinned by
10
+ ``tests/unit/test_slide_numbering.py``. Extending the grammar is a deliberate,
11
+ test-visible change.
12
+
13
+ D1 - slide number versus position
14
+ ---------------------------------
15
+ Slide N is the N-th slide of the current deck in ascending ``position`` order,
16
+ which is the number the slide panel shows. It is NOT ``N - 1``. Routes keep
17
+ positions contiguous, so normally position == N - 1, but a gapped deck (for
18
+ example positions 0, 2, 5) numbers its slides 1, 2, 3 and "slide 3" is
19
+ position 5. Callers pass the positions of the deck as the user sees it
20
+ (committed rows when there are any, else the persisted spec's positions).
21
+ Duplicate and unordered positions are numbered as their distinct ascending set.
22
+
23
+ D3 - the reference grammar
24
+ --------------------------
25
+ Matching is case-insensitive, at word boundaries, left to right without
26
+ overlap, and the longest form at a start wins. ``text`` is the exact matched
27
+ substring, without a leading "the". Numbers are 1-3 digits or the cardinal
28
+ words one..twenty; ordinals are 1-3 digits plus ``st``/``nd``/``rd``/``th``
29
+ (the suffix is not checked against the number) or the words first..twentieth.
30
+ Number and ordinal words refuse a hyphen on either side, so "twenty-one",
31
+ "twenty-first" and "thirty-second" are never misread as "one", "first" or
32
+ "second".
33
+
34
+ * F1, singular ``slide``: "slide 2", "slide #2", "slide number 2", "slide two",
35
+ "slide 2-4" (a digit dash range, no spaces), "slide 2 and 3", "slide 2 & 3".
36
+ It abstains on a continuation it cannot read: the WHOLE singular match fails
37
+ (no shorter "slide 2" is emitted) when the item list is followed by a dash and
38
+ a digit, with or without spaces ("slide 2 - 4", "slide 2 -4"), by ``to``/
39
+ ``through``/``thru`` and a number ("move slide 2 to 5" is no reference, not
40
+ slide 2), or by a comma list: a comma, a number, then ``,``, ``and`` or ``&``
41
+ ("Slide 2, 3 and 4"). A continuation that is not a number keeps the
42
+ reference: "Change slide 2 to a chart" and "Compare slide 2 to slide 5" read
43
+ slide 2, and a lone comma ("On slide 2, 3 cards ...") is slide 2 only.
44
+ * F2, a span: "slide 2 through slide 5", "slide two thru slide four", "slide 2
45
+ up to / until / till / through to slide 5", "slide #2 through slide #5",
46
+ "slides 2 through slide 5" are one inclusive range, never the two truncated
47
+ ends. Plain ``to`` is not a span ("move the chart from slide 2 to slide 5"
48
+ names two slides).
49
+ * F3, plural ``slides``: items separated by ``,``, ``, and``, ``and`` or ``&``.
50
+ An item is a number, a dash range of digits (en and em dashes too, optional
51
+ spaces around the dash), or two numbers joined by ``to``/``through``/``thru``:
52
+ "slides 2-4", "slides 2 to 4", "slides 2, 3 and 5", "slides 2-4 and 6".
53
+ * A lone digit item is never the head of a dash range its form could not read
54
+ (F1: a tight dash; F3: a dash with optional spaces): "slides 1-1000" and
55
+ "slide 2-1000" (a 4-digit end) are no reference, never "slides 1" or
56
+ "slide 2". In a list such an item is simply not consumed: "slides 2 and
57
+ 5-1000" is slides 2.
58
+ * F4, an ordinal before the singular ``slide``: "the second slide", "the 4th
59
+ slide", "last slide: ...". ``last`` and ``final`` are the slide count;
60
+ ``penultimate``, ``second-to-last``, ``second to last``, ``second-last`` and
61
+ ``second last`` are the count minus one. The ordinal is NOT a reference when
62
+ ``slide`` is a compound noun or begins a relative tail: it is followed by a
63
+ hyphen and a word ("the second slide-deck"), by ``deck``, ``template``,
64
+ ``count`` or ``master``, optionally plural ("the last slide deck you made",
65
+ "the final slide count"), by ``from`` plus an optional ``the`` and ``end``,
66
+ ``last``, ``back`` or ``bottom`` ("the second slide from the end"), or by
67
+ ``but one`` ("the last slide but one"). "the last slide.", "the last slide,
68
+ please" and "the last slide's chart" stay references.
69
+ * Indefinite exclusion: an F4 match immediately preceded by ``a``, ``an``,
70
+ ``another``, ``new``, ``extra``, ``additional``, ``one`` or ``one more`` is
71
+ NOT a reference. "Add a final slide", "Add one last slide", "I need a third
72
+ slide" and "a new second slide" name a slide that does not exist yet.
73
+ Definite or bare forms ("the last slide", "last slide: ...", "Add a chart to
74
+ the second slide") are references.
75
+ * Count-relative tail exclusion: ``last``/``final`` immediately preceded by
76
+ ``next to`` or by an ordinal (second.., 2nd..) plus ``to``/``from`` and an
77
+ optional ``the`` is NOT a reference: in "the third to last slide", "the
78
+ second from the last slide" and "the next to last slide" it is the tail of
79
+ a count-relative ordinal, not the last slide. "put it next to the last
80
+ slide" is still the last slide.
81
+ * Ranges are inclusive and may run in either order. A range spanning more than
82
+ ``MAX_RANGE_SPAN`` numbers drops the whole reference.
83
+ * At most ``MAX_REFERENCES`` (20) references are returned. An identical
84
+ reference (same ``text`` and ``slide_numbers``) is emitted once, at its first
85
+ position; duplicates are removed before the cap, so they never use it up.
86
+ "slide 2" and "the second slide" are different phrases and are both kept.
87
+
88
+ Each reference is ``{"text", "slide_numbers", "positions", "out_of_range"}``.
89
+ ``slide_numbers`` is sorted and deduplicated; ``positions`` maps the in-range
90
+ numbers through D1 in the same order; ``out_of_range`` holds the numbers below 1
91
+ or above the slide count, sorted. Numbers are reported, never clamped. There
92
+ are no references when there is no deck.
93
+
94
+ Deliberately unresolved (each is tested; the model looks these up in
95
+ ``slide_numbering`` instead):
96
+
97
+ * count-relative plurals ("the last two slides") and plural ordinals ("the
98
+ second and third slides");
99
+ * a singular ``slide`` followed by an unreadable continuation ("slide 2
100
+ through 5", "slide 2 - 4", "slide 2, 3 and 4", "move slide 2 to 5"), and an
101
+ ordinal ``slide`` that is a compound noun or has a relative tail ("the first
102
+ slide template", "the second slide from the end", "the last slide but one");
103
+ * count-relative ordinals other than the count-minus-one forms above ("the
104
+ third to last slide", "the second from last slide", "the next to last
105
+ slide", "the 2nd-to-last slide");
106
+ * deictic and semantic phrases: "this slide", "the next slide", "the cover",
107
+ "the agenda slide", "a new slide";
108
+ * slide counts ("a 10-slide deck", "10 slides", "five slides"), "slideshow",
109
+ "Slidev", and "slides" on its own;
110
+ * "or" is not a separator ("slides 2 or 3" is slides 2 only);
111
+ * a range spanning more than ``MAX_RANGE_SPAN`` numbers.
112
+
113
+ Known limits, each pinned by a test: a bare-comma plural such as "On slides 2, 3
114
+ bullets each" resolves to slides 2 and 3, because F3 accepts a bare comma as a
115
+ separator and cannot tell a count from a slide; and "Put 3 KPIs on slide 2 and
116
+ 4 on slide 3" resolves "slide 2 and 4" (slides 2 and 4) and "slide 3", because
117
+ the singular form accepts ``and`` as a separator and reads the count as a slide.
118
+
119
+ References are lexical. They say which existing slide a phrase names, not that
120
+ the user wants it changed or what the phrase means for the edit: "after slide
121
+ 3" resolves "slide 3", and what the anchor means is issue #314's to decide.
122
+
123
+ D4 - which text is resolved, and when nothing is
124
+ ------------------------------------------------
125
+ ``latest_user_message`` picks the text: the content of the latest turn whose
126
+ role is ``user``, falling back to the ``message`` argument when there is none
127
+ (or when that turn's content is not a string; an older user turn is never
128
+ used). After the analyst returns, ``message`` is the analyst's synthesis, and the
129
+ user's "slide 4" must still resolve. On a describe-only turn the references
130
+ are empty, because the latest user turn predates the hand edit that triggered
131
+ the describe, so its "slide 2" may now name a different slide; the numbering is
132
+ still sent because it describes the current deck. ``architect_slide_payload``
133
+ is the one helper that builds both payload keys.
134
+
135
+ D5 - the guard
136
+ --------------
137
+ ``edit_ignores_references`` is true when the references resolve at least one
138
+ in-range position and the edit's target positions share none with them. The
139
+ caller only logs it.
140
+ """
141
+
142
+ from __future__ import annotations
143
+
144
+ import re
145
+ from typing import Iterable, Mapping, Sequence
146
+
147
+ MAX_RANGE_SPAN = 100
148
+ MAX_REFERENCES = 20
149
+
150
+ # ---------------------------------------------------------------------------
151
+ # Word tables
152
+ # ---------------------------------------------------------------------------
153
+
154
+ _CARDINALS = {
155
+ word: number
156
+ for number, word in enumerate(
157
+ (
158
+ "one two three four five six seven eight nine ten eleven twelve thirteen "
159
+ "fourteen fifteen sixteen seventeen eighteen nineteen twenty"
160
+ ).split(),
161
+ start=1,
162
+ )
163
+ }
164
+ _ORDINALS = {
165
+ word: number
166
+ for number, word in enumerate(
167
+ (
168
+ "first second third fourth fifth sixth seventh eighth ninth tenth eleventh "
169
+ "twelfth thirteenth fourteenth fifteenth sixteenth seventeenth eighteenth "
170
+ "nineteenth twentieth"
171
+ ).split(),
172
+ start=1,
173
+ )
174
+ }
175
+
176
+ # ---------------------------------------------------------------------------
177
+ # Patterns (compiled once; all matching is case-insensitive)
178
+ # ---------------------------------------------------------------------------
179
+
180
+
181
+ def _word(alternatives: str) -> str:
182
+ """Wrap number/ordinal words so a hyphen on either side refuses the match.
183
+
184
+ The trailing ``\\b`` stops a short word matching the front of a longer one
185
+ ("six" in "sixteen"); the hyphen guards stop "twenty-one" being read as
186
+ "one" and "twenty-first" as "first".
187
+ """
188
+ return rf"(?<![-\w])(?:{alternatives})\b(?!-[a-z])"
189
+
190
+
191
+ _DIGITS = r"(?<!\d)\d{1,3}(?!\d)"
192
+ _DASH = r"[-–—]"
193
+ _CARDINAL_WORD = _word("|".join(_CARDINALS))
194
+ _NUMBER = rf"(?:{_CARDINAL_WORD}|{_DIGITS})"
195
+
196
+ # Items: a lone number or a range. Singular ranges are digits joined by a
197
+ # tight dash; plural ranges also allow spaces around the dash and to/through.
198
+ _TIGHT_RANGE = rf"{_DIGITS}{_DASH}{_DIGITS}"
199
+ _LOOSE_RANGE = rf"{_DIGITS}\s*{_DASH}\s*{_DIGITS}"
200
+ _WORD_RANGE = rf"{_NUMBER}\s+(?:to|through|thru)\s+{_NUMBER}"
201
+ # A lone digit item is never the head of a dash range its form failed to read:
202
+ # "slides 1-1000" (a 4-digit end) is no reference, not "slides 1".
203
+ _LONE_SINGULAR = rf"(?:{_CARDINAL_WORD}|{_DIGITS}(?!{_DASH}\d))"
204
+ _LONE_PLURAL = rf"(?:{_CARDINAL_WORD}|{_DIGITS}(?!\s*{_DASH}\s*\d))"
205
+ _SINGULAR_ITEM = rf"(?:{_TIGHT_RANGE}|{_LONE_SINGULAR})"
206
+ _PLURAL_ITEM = rf"(?:{_WORD_RANGE}|{_LOOSE_RANGE}|{_LONE_PLURAL})"
207
+
208
+ _SINGULAR_SEP = r"(?:\s+and\s+|\s*&\s*)"
209
+ _PLURAL_SEP = r"(?:\s*,\s*and\s+|\s*,\s*|\s+and\s+|\s*&\s*)"
210
+
211
+ # After the singular item list, a continuation F1 cannot read: a dash and a digit,
212
+ # to/through/thru and a number, or a comma list (", <number>" then a comma, "and"
213
+ # or "&"). The singular match then fails whole, so it abstains instead of
214
+ # emitting "slide 2" for "slide 2 through 5".
215
+ _SINGULAR_UNREADABLE = (
216
+ rf"(?!\s*{_DASH}\s*\d"
217
+ rf"|\s+(?:to|through|thru)\s+{_NUMBER}"
218
+ rf"|\s*,\s*{_NUMBER}(?:\s*,|\s+and\b|\s*&))"
219
+ )
220
+
221
+ # F3: "slides 2-4", "slides 2, 3 and 5". F1: "slide 2", "slide #2", "slide 2 and 3".
222
+ # The F1 item list is read inside a lookahead and then re-consumed with a
223
+ # backreference. A lookahead never backtracks once it has matched, so a failed
224
+ # ``_SINGULAR_UNREADABLE`` cannot retry a shorter list ("slide 2" out of "slide 2
225
+ # and 3 through 5"); an atomic group ``(?>...)`` would do the same but needs
226
+ # Python 3.11, and the package supports 3.10.
227
+ _PLURAL_FORM = rf"\bslides\s+(?P<plural_items>{_PLURAL_ITEM}(?:{_PLURAL_SEP}{_PLURAL_ITEM})*)"
228
+ _SINGULAR_FORM = (
229
+ r"\bslide(?:\s+number\s+|\s*#\s*|\s+)"
230
+ rf"(?=(?P<singular_items>{_SINGULAR_ITEM}(?:{_SINGULAR_SEP}{_SINGULAR_ITEM})*))"
231
+ r"(?P=singular_items)"
232
+ f"{_SINGULAR_UNREADABLE}"
233
+ )
234
+
235
+ # F4: an ordinal, then the singular "slide". Relative ordinals come before the
236
+ # plain ones so "second-to-last" is never read as "second".
237
+ _JOIN = r"(?:-|\s+)"
238
+ _ORDINAL_TOKEN = _word(
239
+ rf"(?P<ordinal_relative>penultimate|second(?:{_JOIN}to)?{_JOIN}last)"
240
+ r"|(?P<ordinal_last>last|final)"
241
+ rf"|(?P<ordinal_word>{'|'.join(_ORDINALS)})"
242
+ r"|(?P<ordinal_digits>\d{1,3})(?:st|nd|rd|th)"
243
+ )
244
+ # "slide" must not be a compound noun ("the first slide template", "slide-deck")
245
+ # or begin a relative tail ("the second slide from the end", "the last slide but
246
+ # one"): neither names the slide the ordinal seems to.
247
+ _ORDINAL_SLIDE_END = (
248
+ r"slide\b(?!-\w"
249
+ r"|\s+(?:deck|template|count|master)s?\b"
250
+ r"|\s+from\s+(?:the\s+)?(?:end|last|back|bottom)\b"
251
+ r"|\s+but\s+one\b)"
252
+ )
253
+ _ORDINAL_FORM = rf"(?P<ordinal>{_ORDINAL_TOKEN})\s+{_ORDINAL_SLIDE_END}"
254
+
255
+ # One alternation, tried in this order at each start: F3, then F1, then F4.
256
+ # F2: "slide 2 through slide 5" names a range, so it is read as one, never as the
257
+ # two truncated ends. "to" is left to F1 ("compare slide 2 to slide 5" and "move
258
+ # the chart from slide 2 to slide 5" name two slides). Tried first, so it wins
259
+ # over F1 at the same start.
260
+ _SPAN_PREFIX = r"(?:number\s+|#\s*)?"
261
+ _SPAN_WORD = r"(?:through(?:\s+to)?|thru|up\s+to|until|till)"
262
+ _SPAN_FORM = (
263
+ rf"\bslides?\s+{_SPAN_PREFIX}(?P<span_items>{_NUMBER}\s+{_SPAN_WORD}\s+"
264
+ rf"slides?\s+{_SPAN_PREFIX}{_NUMBER})\b"
265
+ )
266
+
267
+ _REFERENCE_RE = re.compile(
268
+ f"{_SPAN_FORM}|{_PLURAL_FORM}|{_SINGULAR_FORM}|{_ORDINAL_FORM}", re.IGNORECASE
269
+ )
270
+
271
+ # Used to split a matched item list back into items, and an item into numbers.
272
+ _ITEM_RE = re.compile(_PLURAL_ITEM, re.IGNORECASE)
273
+ _NUMBER_RE = re.compile(_NUMBER, re.IGNORECASE)
274
+
275
+ # "a final slide" names a slide that does not exist yet (#314 owns add/insert).
276
+ _INDEFINITE_BEFORE_RE = re.compile(
277
+ r"\b(?:a|an|another|new|extra|additional|one(?:\s+more)?)\s+\Z", re.IGNORECASE
278
+ )
279
+
280
+ # "the third to last slide", "the second from the last slide", "the next to last
281
+ # slide": "last slide" is the tail of a count-relative ordinal there, not the
282
+ # last slide, so it is no reference (the hyphenated spellings are refused by
283
+ # the word guards already).
284
+ _RELATIVE_TAIL_BEFORE_RE = re.compile(
285
+ r"\b(?:next\s+to"
286
+ rf"|(?:{'|'.join(list(_ORDINALS)[1:])}|\d{{1,3}}(?:st|nd|rd|th))\s+(?:to|from)(?:\s+the)?"
287
+ r")\s+\Z",
288
+ re.IGNORECASE,
289
+ )
290
+
291
+ # The exclusions look only this far back from an ordinal, so a long message with
292
+ # many ordinals stays linear. ``\b`` still sees the character before the window.
293
+ _LOOKBACK = 64
294
+
295
+
296
+ # ---------------------------------------------------------------------------
297
+ # Numbering and resolution
298
+ # ---------------------------------------------------------------------------
299
+
300
+
301
+ def slide_numbering(positions: Iterable[int]) -> list[dict[str, int]]:
302
+ """``[{"slide_number": 1, "position": p0}, ...]`` over the DISTINCT positions, ascending."""
303
+ return [
304
+ {"slide_number": number, "position": position}
305
+ for number, position in enumerate(_ordered_positions(positions), start=1)
306
+ ]
307
+
308
+
309
+ def resolve_slide_references(text: str | None, positions: Iterable[int]) -> list[dict]:
310
+ """Each D3 reference in ``text``, in order of appearance.
311
+
312
+ Every entry is ``{"text": str, "slide_numbers": [int], "positions": [int],
313
+ "out_of_range": [int]}``. The result is ``[]`` when ``text`` is empty or
314
+ ``None`` or when ``positions`` is empty. An identical reference (same
315
+ ``text`` and ``slide_numbers``) is kept once, at its first position, and
316
+ at most ``MAX_REFERENCES`` distinct references are returned.
317
+ """
318
+ ordered = _ordered_positions(positions)
319
+ if not text or not ordered:
320
+ return []
321
+ references: list[dict] = []
322
+ seen: set[tuple[str, tuple[int, ...]]] = set()
323
+ for match in _REFERENCE_RE.finditer(text):
324
+ if _is_indefinite(text, match):
325
+ continue
326
+ if _is_relative_tail(text, match):
327
+ continue
328
+ numbers = _match_numbers(match, len(ordered))
329
+ if numbers is None:
330
+ continue
331
+ key = (match.group(0), tuple(numbers))
332
+ if key in seen:
333
+ continue
334
+ seen.add(key)
335
+ references.append(_build_reference(match.group(0), numbers, ordered))
336
+ if len(references) >= MAX_REFERENCES:
337
+ break
338
+ return references
339
+
340
+
341
+ def latest_user_message(
342
+ conversation: Sequence[Mapping] | None, fallback: str | None
343
+ ) -> str | None:
344
+ """Content of the last turn whose role is ``"user"``; ``fallback`` when there is none (D4).
345
+
346
+ A latest user turn whose content is not a string (``None``, a list of
347
+ content blocks) also gives ``fallback``: never an older user turn, whose
348
+ slide numbers may be stale.
349
+ """
350
+ for turn in reversed(conversation or ()):
351
+ if turn.get("role") == "user":
352
+ content = turn.get("content")
353
+ return content if isinstance(content, str) else fallback
354
+ return fallback
355
+
356
+
357
+ def architect_slide_payload(
358
+ conversation: Sequence[Mapping] | None,
359
+ message: str | None,
360
+ positions: Iterable[int],
361
+ *,
362
+ describe_only: bool = False,
363
+ ) -> dict[str, list]:
364
+ """The architect payload's ``slide_numbering`` and ``slide_references`` keys.
365
+
366
+ The one helper that ``architect_node``, the eval generators and the agentic
367
+ test payloads all call. References are resolved from the latest user turn
368
+ (falling back to ``message``) and are ``[]`` on a describe-only turn (D4).
369
+ """
370
+ positions = list(positions)
371
+ references = (
372
+ []
373
+ if describe_only
374
+ else resolve_slide_references(latest_user_message(conversation, message), positions)
375
+ )
376
+ return {
377
+ "slide_numbering": slide_numbering(positions),
378
+ "slide_references": references,
379
+ }
380
+
381
+
382
+ def edit_ignores_references(
383
+ target_positions: Iterable[int], references: Sequence[Mapping]
384
+ ) -> bool:
385
+ """True iff the references resolve at least one in-range position and
386
+ ``target_positions`` shares none of them (D5)."""
387
+ referenced = {position for reference in references for position in reference["positions"]}
388
+ return bool(referenced) and referenced.isdisjoint(target_positions)
389
+
390
+
391
+ # ---------------------------------------------------------------------------
392
+ # Helpers
393
+ # ---------------------------------------------------------------------------
394
+
395
+
396
+ def _ordered_positions(positions: Iterable[int]) -> list[int]:
397
+ """The distinct positions, ascending: ``ordered[n - 1]`` is slide ``n``'s position."""
398
+ return sorted({int(position) for position in positions})
399
+
400
+
401
+ def _is_indefinite(text: str, match: re.Match[str]) -> bool:
402
+ """Whether an F4 match sits right after "a", "another", "new", ... (D3 exclusion)."""
403
+ return match.group("ordinal") is not None and _preceded_by(
404
+ _INDEFINITE_BEFORE_RE, text, match.start()
405
+ )
406
+
407
+
408
+ def _is_relative_tail(text: str, match: re.Match[str]) -> bool:
409
+ """Whether a ``last``/``final`` match ends "third to last", "next to last", ..."""
410
+ return match.group("ordinal_last") is not None and _preceded_by(
411
+ _RELATIVE_TAIL_BEFORE_RE, text, match.start()
412
+ )
413
+
414
+
415
+ def _preceded_by(pattern: re.Pattern[str], text: str, start: int) -> bool:
416
+ """Whether *pattern* (anchored by ``\\Z``) matches the text just before *start*."""
417
+ return pattern.search(text, max(0, start - _LOOKBACK), start) is not None
418
+
419
+
420
+ def _match_numbers(match: re.Match[str], slide_count: int) -> list[int] | None:
421
+ """The sorted, distinct slide numbers a match names, or ``None`` to drop it."""
422
+ span = match.group("span_items")
423
+ if span is not None:
424
+ low, high = sorted(_cardinal_value(t) for t in _NUMBER_RE.findall(span))
425
+ if high - low + 1 > MAX_RANGE_SPAN:
426
+ return None
427
+ return list(range(low, high + 1))
428
+ items = match.group("plural_items") or match.group("singular_items")
429
+ if items is not None:
430
+ return _item_list_numbers(items)
431
+ return [_ordinal_number(match, slide_count)]
432
+
433
+
434
+ def _item_list_numbers(items: str) -> list[int] | None:
435
+ """Expand "2-4 and 6" to [2, 3, 4, 6]; ``None`` if any range spans too many numbers."""
436
+ numbers: set[int] = set()
437
+ for item in _ITEM_RE.finditer(items):
438
+ values = [_cardinal_value(token) for token in _NUMBER_RE.findall(item.group(0))]
439
+ low, high = min(values), max(values) # one value for a number, two for a range
440
+ if high - low + 1 > MAX_RANGE_SPAN:
441
+ return None
442
+ numbers.update(range(low, high + 1))
443
+ return sorted(numbers)
444
+
445
+
446
+ def _cardinal_value(token: str) -> int:
447
+ return int(token) if token.isdigit() else _CARDINALS[token.lower()]
448
+
449
+
450
+ def _ordinal_number(match: re.Match[str], slide_count: int) -> int:
451
+ if match.group("ordinal_relative"):
452
+ return slide_count - 1
453
+ if match.group("ordinal_last"):
454
+ return slide_count
455
+ if match.group("ordinal_digits"):
456
+ return int(match.group("ordinal_digits"))
457
+ return _ORDINALS[match.group("ordinal_word").lower()]
458
+
459
+
460
+ def _build_reference(text: str, numbers: list[int], ordered: list[int]) -> dict:
461
+ in_range = [number for number in numbers if 1 <= number <= len(ordered)]
462
+ out_of_range = [number for number in numbers if not 1 <= number <= len(ordered)]
463
+ return {
464
+ "text": text,
465
+ "slide_numbers": numbers,
466
+ "positions": [ordered[number - 1] for number in in_range],
467
+ "out_of_range": out_of_range,
468
+ }