databricks-tellr-app 0.4.3.dev34__tar.gz → 0.4.3.dev35__tar.gz

{databricks_tellr_app-0.4.3.dev34 → databricks_tellr_app-0.4.3.dev35}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: databricks-tellr-app
-Version: 0.4.3.dev34
+Version: 0.4.3.dev35
 Summary: Tellr application package for Databricks Apps
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -9,13 +9,16 @@ Requires-Dist: uvicorn==0.38.0
 Requires-Dist: python-multipart==0.0.20
 Requires-Dist: pydantic==2.12.4
 Requires-Dist: pydantic-settings==2.12.0
-Requires-Dist: databricks-langchain==0.9.0
-Requires-Dist: langchain==1.0.5
-Requires-Dist: langchain-core==1.0.4
-Requires-Dist: langchain-community==0.4.1
-Requires-Dist: langchain-text-splitters==1.0.0
+Requires-Dist: databricks-langchain==0.20.0
+Requires-Dist: databricks-openai==0.17.1
+Requires-Dist: langchain==1.3.14
+Requires-Dist: langchain-core==1.5.3
+Requires-Dist: langchain-community==0.4.2
+Requires-Dist: langchain-text-splitters==1.1.2
 Requires-Dist: litellm==1.80.11
 Requires-Dist: mcp==1.27.0
+Requires-Dist: openai==3.19.2
+Requires-Dist: openai-agents==0.22.2
 Requires-Dist: opentelemetry-api==1.38.0
 Requires-Dist: opentelemetry-sdk==1.38.0
 Requires-Dist: beautifulsoup4==4.14.2
@@ -47,9 +50,11 @@ Requires-Dist: databricks-ai-bridge==0.21.0
 Requires-Dist: databricks-ai-search==0.76
 Requires-Dist: databricks-connect==16.1.7
 Requires-Dist: databricks-vectorsearch==0.75
-Requires-Dist: langchain-classic==1.0.0
-Requires-Dist: langgraph==1.0.10
-Requires-Dist: langgraph-prebuilt==1.0.10
+Requires-Dist: langchain-classic==1.0.8
+Requires-Dist: langgraph==1.2.10
+Requires-Dist: langgraph-checkpoint==4.1.1
+Requires-Dist: langgraph-prebuilt==1.1.0
+Requires-Dist: langgraph-sdk==0.4.2
 Requires-Dist: langsmith==0.9.5
 Requires-Dist: unitycatalog-ai==0.3.2
 Requires-Dist: unitycatalog-langchain==0.3.0

{databricks_tellr_app-0.4.3.dev34 → databricks_tellr_app-0.4.3.dev35}/databricks_tellr_app/run.py

@@ -51,6 +51,40 @@ def init_database(seed_databricks_defaults: bool = False) -> None:
         logger.error(f"Failed to initialize database tables: {e}\n{tb}")
         raise SystemExit(1) from e
 
+    logger.info("Bootstrapping Graph Configuration...")
+    try:
+        from src.core.database import get_session_local
+        from src.services.graph_configuration import bootstrap_graph_configuration
+
+        result = bootstrap_graph_configuration(get_session_local())
+        logger.info(
+            "Graph Configuration ready: release_id=%s version=%s created=%s",
+            result.release_id,
+            result.version_number,
+            result.created,
+        )
+    except Exception as e:
+        tb = traceback.format_exc()
+        logger.error(f"Failed to bootstrap Graph Configuration: {e}\n{tb}")
+        raise SystemExit(1) from e
+
+    logger.info("Backfilling Conversation Pins...")
+    try:
+        from src.core.database import get_session_local
+        from src.services.conversation_pins import backfill_conversation_pins
+
+        result = backfill_conversation_pins(get_session_local())
+        logger.info(
+            "Conversation Pins ready: release_id=%s version=%s pinned=%s",
+            result.graph_release_id,
+            result.graph_version,
+            result.pinned_count,
+        )
+    except Exception as e:
+        tb = traceback.format_exc()
+        logger.error(f"Failed to backfill Conversation Pins: {e}\n{tb}")
+        raise SystemExit(1) from e
+
     # Data migrations/backfills that used to run in the FastAPI lifespan now run
     # HERE, once, before the server forks its workers — the uvicorn workers must
     # never execute migration code (4 of them racing the migration chain on boot
@@ -74,6 +108,29 @@ def init_database(seed_databricks_defaults: bool = False) -> None:
         logger.error(f"Failed to migrate profiles/sessions to agent_config: {e}\n{tb}")
         raise SystemExit(1) from e
 
+    # Row-per-slide (PR1): migrate historical deck_json blobs into session_slides
+    # rows. Runs HERE, pre-fork, for the same reason as the two migrations above —
+    # the uvicorn workers must never execute migration code. It originally lived in
+    # the FastAPI lifespan; main moved migrations out of the lifespan while this
+    # branch was in flight, so it was relocated on merge rather than dropped.
+    #
+    # Guarded by a per-deck NOT EXISTS anti-join over session_slides (index-only
+    # against its composite PK), so it is a no-op scan once every deck has rows.
+    # A deck whose blob will not parse is logged and skipped, never raised — one
+    # bad row must not abort startup.
+    logger.info("Backfilling session_slides rows...")
+    try:
+        from src.core.backfill_session_slides_startup import backfill_unmigrated_decks
+        from src.core.database import get_session_local
+
+        slide_decks = backfill_unmigrated_decks(get_session_local())
+        if slide_decks:
+            logger.info(f"Backfilled {slide_decks} deck(s) into session_slides rows")
+    except Exception as e:
+        tb = traceback.format_exc()
+        logger.error(f"Failed to backfill session_slides rows: {e}\n{tb}")
+        raise SystemExit(1) from e
+
     # Seed default content
     logger.info(f"Seeding defaults (include_databricks={seed_databricks_defaults})...")
     try:
@@ -97,6 +154,28 @@ def init_database(seed_databricks_defaults: bool = False) -> None:
         logger.error(f"Failed to ensure encryption key: {e}\n{tb}")
         raise SystemExit(1) from e
 
+    # Retired prompt overrides: strip 'system_prompt' and
+    # 'slide_editing_instructions' out of every stored agent_config blob. The
+    # physical columns are dropped inside init_db()'s migration chain, early,
+    # because a database that still has them cannot insert a profile; the BLOB
+    # strip runs LAST, deliberately — it is the one position no later step can
+    # undo by writing a fresh blob (seed_defaults above creates profiles).
+    # A blob that will not parse is logged and skipped, never raised, so one bad
+    # row cannot abort startup; anything else here is SystemExit(1) like the five
+    # steps above.
+    logger.info("Stripping retired prompt keys from agent_config blobs...")
+    try:
+        from src.core.database import get_session_local
+        from src.core.strip_retired_prompt_keys import strip_retired_prompt_keys
+
+        stripped = strip_retired_prompt_keys(get_session_local())
+        if stripped:
+            logger.info(f"Stripped retired prompt keys from {stripped} row(s)")
+    except Exception as e:
+        tb = traceback.format_exc()
+        logger.error(f"Failed to strip retired prompt keys from agent_config: {e}\n{tb}")
+        raise SystemExit(1) from e
+
 
 def main() -> None:
     """Start the uvicorn server."""

{databricks_tellr_app-0.4.3.dev34 → databricks_tellr_app-0.4.3.dev35}/databricks_tellr_app.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: databricks-tellr-app
-Version: 0.4.3.dev34
+Version: 0.4.3.dev35
 Summary: Tellr application package for Databricks Apps
 Requires-Python: >=3.10
 Description-Content-Type: text/markdown
@@ -9,13 +9,16 @@ Requires-Dist: uvicorn==0.38.0
 Requires-Dist: python-multipart==0.0.20
 Requires-Dist: pydantic==2.12.4
 Requires-Dist: pydantic-settings==2.12.0
-Requires-Dist: databricks-langchain==0.9.0
-Requires-Dist: langchain==1.0.5
-Requires-Dist: langchain-core==1.0.4
-Requires-Dist: langchain-community==0.4.1
-Requires-Dist: langchain-text-splitters==1.0.0
+Requires-Dist: databricks-langchain==0.20.0
+Requires-Dist: databricks-openai==0.17.1
+Requires-Dist: langchain==1.3.14
+Requires-Dist: langchain-core==1.5.3
+Requires-Dist: langchain-community==0.4.2
+Requires-Dist: langchain-text-splitters==1.1.2
 Requires-Dist: litellm==1.80.11
 Requires-Dist: mcp==1.27.0
+Requires-Dist: openai==3.19.2
+Requires-Dist: openai-agents==0.22.2
 Requires-Dist: opentelemetry-api==1.38.0
 Requires-Dist: opentelemetry-sdk==1.38.0
 Requires-Dist: beautifulsoup4==4.14.2
@@ -47,9 +50,11 @@ Requires-Dist: databricks-ai-bridge==0.21.0
 Requires-Dist: databricks-ai-search==0.76
 Requires-Dist: databricks-connect==16.1.7
 Requires-Dist: databricks-vectorsearch==0.75
-Requires-Dist: langchain-classic==1.0.0
-Requires-Dist: langgraph==1.0.10
-Requires-Dist: langgraph-prebuilt==1.0.10
+Requires-Dist: langchain-classic==1.0.8
+Requires-Dist: langgraph==1.2.10
+Requires-Dist: langgraph-checkpoint==4.1.1
+Requires-Dist: langgraph-prebuilt==1.1.0
+Requires-Dist: langgraph-sdk==0.4.2
 Requires-Dist: langsmith==0.9.5
 Requires-Dist: unitycatalog-ai==0.3.2
 Requires-Dist: unitycatalog-langchain==0.3.0

{databricks_tellr_app-0.4.3.dev34 → databricks_tellr_app-0.4.3.dev35}/databricks_tellr_app.egg-info/SOURCES.txt

@@ -19,6 +19,7 @@ setup.py
 ./src/api/routes/admin.py
 ./src/api/routes/admin_usage.py
 ./src/api/routes/agent_config.py
+./src/api/routes/agent_definitions.py
 ./src/api/routes/chat.py
 ./src/api/routes/deck_contributors.py
 ./src/api/routes/export.py
@@ -42,7 +43,10 @@ setup.py
 ./src/api/routes/settings/slide_styles.py
 ./src/api/schemas/__init__.py
 ./src/api/schemas/agent_config.py
+./src/api/schemas/agent_definitions.py
 ./src/api/schemas/feedback.py
+./src/api/schemas/graph_release_history.py
+./src/api/schemas/graph_releases.py
 ./src/api/schemas/requests.py
 ./src/api/schemas/responses.py
 ./src/api/schemas/streaming.py
@@ -51,16 +55,20 @@ setup.py
 ./src/api/schemas/settings/responses.py
 ./src/api/services/__init__.py
 ./src/api/services/chat_service.py
+./src/api/services/deck_level_writer.py
 ./src/api/services/export_job_queue.py
 ./src/api/services/feedback_service.py
 ./src/api/services/job_queue.py
 ./src/api/services/session_manager.py
 ./src/api/services/session_naming.py
+./src/api/services/slide_repository.py
 ./src/api/services/usage_events.py
 ./src/api/services/usage_service.py
 ./src/api/utils/__init__.py
 ./src/api/utils/validation.py
 ./src/core/__init__.py
+./src/core/backfill_session_slides_startup.py
+./src/core/checkpointer.py
 ./src/core/config_loader.py
 ./src/core/context_utils.py
 ./src/core/database.py
@@ -76,17 +84,29 @@ setup.py
 ./src/core/permission_context.py
 ./src/core/prompt_modules.py
 ./src/core/settings_db.py
+./src/core/strip_retired_prompt_keys.py
 ./src/core/user_context.py
+./src/core/skills/__init__.py
+./src/core/skills/architect.py
+./src/core/skills/build_reviewer.py
+./src/core/skills/builder.py
+./src/core/skills/data_analyst.py
+./src/core/skills/deck_reviewer.py
+./src/core/skills/fix_reviewer.py
+./src/core/skills/fixer.py
 ./src/database/__init__.py
 ./src/database/types.py
 ./src/database/models/__init__.py
 ./src/database/models/deck_contributor.py
+./src/database/models/deck_review.py
 ./src/database/models/design_system.py
 ./src/database/models/encryption_key.py
 ./src/database/models/feedback.py
 ./src/database/models/genie_space.py
 ./src/database/models/google_global_credentials.py
 ./src/database/models/google_oauth_token.py
+./src/database/models/graph_checkpoint.py
+./src/database/models/graph_configuration.py
 ./src/database/models/identity.py
 ./src/database/models/image.py
 ./src/database/models/profile.py
@@ -99,31 +119,67 @@ setup.py
 ./src/database/models/usage_event.py
 ./src/database/models/user_preference.py
 ./src/domain/__init__.py
+./src/domain/conversation_engine.py
+./src/domain/deck_spec.py
+./src/domain/finding.py
+./src/domain/skill_io.py
 ./src/domain/slide.py
 ./src/domain/slide_deck.py
 ./src/services/__init__.py
 ./src/services/agent.py
+./src/services/agent_definition_manifest_v1.py
 ./src/services/agent_factory.py
+./src/services/agent_model_payload.py
+./src/services/agent_resolution.py
+./src/services/agent_runtime.py
+./src/services/agent_runtime_identity.py
+./src/services/agent_schema_registry.py
+./src/services/agent_schema_types.py
+./src/services/agent_test_workbench.py
+./src/services/collaboration_history.py
 ./src/services/config_service.py
 ./src/services/config_validator.py
+./src/services/conversation_pins.py
+./src/services/deck_css_aggregator.py
+./src/services/deck_review_store.py
 ./src/services/design_system_compiler.py
 ./src/services/design_system_service.py
 ./src/services/design_system_templates.py
 ./src/services/drive_uploader.py
+./src/services/foreman_service.py
+./src/services/gateway_openai.py
 ./src/services/genie_service.py
 ./src/services/google_slides_auth.py
 ./src/services/google_slides_prompts_defaults.py
+./src/services/graph_configuration.py
+./src/services/graph_configuration_bootstrap.py
+./src/services/graph_configuration_content.py
+./src/services/graph_configuration_draft.py
+./src/services/graph_configuration_publication.py
+./src/services/graph_configuration_rollback.py
+./src/services/graph_configuration_seed.py
+./src/services/graph_configuration_workbench.py
+./src/services/graph_definition_manifest.py
+./src/services/graph_release_evidence.py
+./src/services/graph_release_history.py
 ./src/services/html_to_google_slides.py
 ./src/services/html_to_pptx.py
 ./src/services/identity_provider.py
 ./src/services/image_service.py
 ./src/services/image_tools.py
+./src/services/model_endpoint_catalog.py
+./src/services/model_endpoint_probe.py
 ./src/services/permission_service.py
+./src/services/persisted_graph_release.py
 ./src/services/pptx_from_html_huashu.py
 ./src/services/pptx_from_records.py
 ./src/services/pptx_prompts_defaults.py
 ./src/services/profile_service.py
+./src/services/prompt_assembler.py
+./src/services/shared_deck_attribution.py
+./src/services/spec_sync.py
 ./src/services/streaming_callback.py
+./src/services/template_sections.py
 ./src/services/validator.py
 ./src/services/converter_jail/__init__.py
 ./src/services/converter_jail/ast_guard.py
@@ -134,6 +190,12 @@ setup.py
 ./src/services/converter_jail/protocol.py
 ./src/services/evaluation/__init__.py
 ./src/services/evaluation/llm_judge.py
+./src/services/graph/__init__.py
+./src/services/graph/builder.py
+./src/services/graph/event_emitter.py
+./src/services/graph/nodes.py
+./src/services/graph/routers.py
+./src/services/graph/state.py
 ./src/services/identity_providers/__init__.py
 ./src/services/identity_providers/account_provider.py
 ./src/services/identity_providers/local_provider.py
@@ -149,6 +211,7 @@ setup.py
 ./src/utils/css_utils.py
 ./src/utils/ds_asset_utils.py
 ./src/utils/error_handling.py
+./src/utils/graph_safety.py
 ./src/utils/html_safety.py
 ./src/utils/html_utils.py
 ./src/utils/image_utils.py
@@ -181,6 +244,7 @@ src/api/routes/_authz.py
 src/api/routes/admin.py
 src/api/routes/admin_usage.py
 src/api/routes/agent_config.py
+src/api/routes/agent_definitions.py
 src/api/routes/chat.py
 src/api/routes/deck_contributors.py
 src/api/routes/export.py
@@ -204,7 +268,10 @@ src/api/routes/settings/identities.py
 src/api/routes/settings/slide_styles.py
 src/api/schemas/__init__.py
 src/api/schemas/agent_config.py
+src/api/schemas/agent_definitions.py
 src/api/schemas/feedback.py
+src/api/schemas/graph_release_history.py
+src/api/schemas/graph_releases.py
 src/api/schemas/requests.py
 src/api/schemas/responses.py
 src/api/schemas/streaming.py
@@ -213,16 +280,20 @@ src/api/schemas/settings/requests.py
 src/api/schemas/settings/responses.py
 src/api/services/__init__.py
 src/api/services/chat_service.py
+src/api/services/deck_level_writer.py
 src/api/services/export_job_queue.py
 src/api/services/feedback_service.py
 src/api/services/job_queue.py
 src/api/services/session_manager.py
 src/api/services/session_naming.py
+src/api/services/slide_repository.py
 src/api/services/usage_events.py
 src/api/services/usage_service.py
 src/api/utils/__init__.py
 src/api/utils/validation.py
 src/core/__init__.py
+src/core/backfill_session_slides_startup.py
+src/core/checkpointer.py
 src/core/config_loader.py
 src/core/context_utils.py
 src/core/database.py
@@ -238,17 +309,29 @@ src/core/otel_logging.py
 src/core/permission_context.py
 src/core/prompt_modules.py
 src/core/settings_db.py
+src/core/strip_retired_prompt_keys.py
 src/core/user_context.py
+src/core/skills/__init__.py
+src/core/skills/architect.py
+src/core/skills/build_reviewer.py
+src/core/skills/builder.py
+src/core/skills/data_analyst.py
+src/core/skills/deck_reviewer.py
+src/core/skills/fix_reviewer.py
+src/core/skills/fixer.py
 src/database/__init__.py
 src/database/types.py
 src/database/models/__init__.py
 src/database/models/deck_contributor.py
+src/database/models/deck_review.py
 src/database/models/design_system.py
 src/database/models/encryption_key.py
 src/database/models/feedback.py
 src/database/models/genie_space.py
 src/database/models/google_global_credentials.py
 src/database/models/google_oauth_token.py
+src/database/models/graph_checkpoint.py
+src/database/models/graph_configuration.py
 src/database/models/identity.py
 src/database/models/image.py
 src/database/models/profile.py
@@ -261,31 +344,67 @@ src/database/models/slide_style_library.py
 src/database/models/usage_event.py
 src/database/models/user_preference.py
 src/domain/__init__.py
+src/domain/conversation_engine.py
+src/domain/deck_spec.py
+src/domain/finding.py
+src/domain/skill_io.py
 src/domain/slide.py
 src/domain/slide_deck.py
 src/services/__init__.py
 src/services/agent.py
+src/services/agent_definition_manifest_v1.py
 src/services/agent_factory.py
+src/services/agent_model_payload.py
+src/services/agent_resolution.py
+src/services/agent_runtime.py
+src/services/agent_runtime_identity.py
+src/services/agent_schema_registry.py
+src/services/agent_schema_types.py
+src/services/agent_test_workbench.py
+src/services/collaboration_history.py
 src/services/config_service.py
 src/services/config_validator.py
+src/services/conversation_pins.py
+src/services/deck_css_aggregator.py
+src/services/deck_review_store.py
 src/services/design_system_compiler.py
 src/services/design_system_service.py
 src/services/design_system_templates.py
 src/services/drive_uploader.py
+src/services/foreman_service.py
+src/services/gateway_openai.py
 src/services/genie_service.py
 src/services/google_slides_auth.py
 src/services/google_slides_prompts_defaults.py
+src/services/graph_configuration.py
+src/services/graph_configuration_bootstrap.py
+src/services/graph_configuration_content.py
+src/services/graph_configuration_draft.py
+src/services/graph_configuration_publication.py
+src/services/graph_configuration_rollback.py
+src/services/graph_configuration_seed.py
+src/services/graph_configuration_workbench.py
+src/services/graph_definition_manifest.py
+src/services/graph_release_evidence.py
+src/services/graph_release_history.py
 src/services/html_to_google_slides.py
 src/services/html_to_pptx.py
 src/services/identity_provider.py
 src/services/image_service.py
 src/services/image_tools.py
+src/services/model_endpoint_catalog.py
+src/services/model_endpoint_probe.py
 src/services/permission_service.py
+src/services/persisted_graph_release.py
 src/services/pptx_from_html_huashu.py
 src/services/pptx_from_records.py
 src/services/pptx_prompts_defaults.py
 src/services/profile_service.py
+src/services/prompt_assembler.py
+src/services/shared_deck_attribution.py
+src/services/spec_sync.py
 src/services/streaming_callback.py
+src/services/template_sections.py
 src/services/validator.py
 src/services/converter_jail/__init__.py
 src/services/converter_jail/ast_guard.py
@@ -296,6 +415,12 @@ src/services/converter_jail/pptx_runner.py
 src/services/converter_jail/protocol.py
 src/services/evaluation/__init__.py
 src/services/evaluation/llm_judge.py
+src/services/graph/__init__.py
+src/services/graph/builder.py
+src/services/graph/event_emitter.py
+src/services/graph/nodes.py
+src/services/graph/routers.py
+src/services/graph/state.py
 src/services/identity_providers/__init__.py
 src/services/identity_providers/account_provider.py
 src/services/identity_providers/local_provider.py
@@ -311,6 +436,7 @@ src/utils/__init__.py
 src/utils/css_utils.py
 src/utils/ds_asset_utils.py
 src/utils/error_handling.py
+src/utils/graph_safety.py
 src/utils/html_safety.py
 src/utils/html_utils.py
 src/utils/image_utils.py

{databricks_tellr_app-0.4.3.dev34 → databricks_tellr_app-0.4.3.dev35}/databricks_tellr_app.egg-info/requires.txt

@@ -3,13 +3,16 @@ uvicorn==0.38.0
 python-multipart==0.0.20
 pydantic==2.12.4
 pydantic-settings==2.12.0
-databricks-langchain==0.9.0
-langchain==1.0.5
-langchain-core==1.0.4
-langchain-community==0.4.1
-langchain-text-splitters==1.0.0
+databricks-langchain==0.20.0
+databricks-openai==0.17.1
+langchain==1.3.14
+langchain-core==1.5.3
+langchain-community==0.4.2
+langchain-text-splitters==1.1.2
 litellm==1.80.11
 mcp==1.27.0
+openai==3.19.2
+openai-agents==0.22.2
 opentelemetry-api==1.38.0
 opentelemetry-sdk==1.38.0
 beautifulsoup4==4.14.2
@@ -41,9 +44,11 @@ databricks-ai-bridge==0.21.0
 databricks-ai-search==0.76
 databricks-connect==16.1.7
 databricks-vectorsearch==0.75
-langchain-classic==1.0.0
-langgraph==1.0.10
-langgraph-prebuilt==1.0.10
+langchain-classic==1.0.8
+langgraph==1.2.10
+langgraph-checkpoint==4.1.1
+langgraph-prebuilt==1.1.0
+langgraph-sdk==0.4.2
 langsmith==0.9.5
 unitycatalog-ai==0.3.2
 unitycatalog-langchain==0.3.0

{databricks_tellr_app-0.4.3.dev34 → databricks_tellr_app-0.4.3.dev35}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "databricks-tellr-app"
-version = "0.4.3.dev34"
+version = "0.4.3.dev35"
 description = "Tellr application package for Databricks Apps"
 readme = "README.md"
 requires-python = ">=3.10"
@@ -14,13 +14,19 @@ dependencies = [
     "python-multipart==0.0.20",
     "pydantic==2.12.4",
     "pydantic-settings==2.12.0",
-    "databricks-langchain==0.9.0",
-    "langchain==1.0.5",
-    "langchain-core==1.0.4",
-    "langchain-community==0.4.1",
-    "langchain-text-splitters==1.0.0",
+    "databricks-langchain==0.20.0",
+    "databricks-openai==0.17.1",
+    "langchain==1.3.14",
+    "langchain-core==1.5.3",
+    "langchain-community==0.4.2",
+    "langchain-text-splitters==1.1.2",
     "litellm==1.80.11",
     "mcp==1.27.0",
+    # agent_runtime.py and model_endpoint_probe.py import openai at module level;
+    # openai and openai-agents pinned to the versions databricks-openai 0.17.1 resolves
+    # to so the Apps build matches local tests.
+    "openai==3.19.2",
+    "openai-agents==0.22.2",
     "opentelemetry-api==1.38.0",
     "opentelemetry-sdk==1.38.0",
     "beautifulsoup4==4.14.2",
@@ -73,6 +79,13 @@ dependencies = [
     # `pip install databricks-tellr-app` is safe.
     # SDR-4437 MEDIUM-7 (July 2026): the 7 formerly-ranged direct deps above
     # this block are now exact-pinned too; same refresh discipline.
+    # PR2 LangGraph stack bump (August 2026): updated langchain 1.0.5→1.3.14,
+    # langchain-core 1.0.4→1.5.3, langchain-community 0.4.1→0.4.2,
+    # langchain-text-splitters 1.0.0→1.1.2, langchain-classic 1.0.0→1.0.8,
+    # langgraph 1.0.10→1.2.10, added langgraph-checkpoint==4.1.1,
+    # langgraph-prebuilt 1.0.10→1.1.0, added langgraph-sdk==0.4.2. These match
+    # the repo-root requirements.txt and pyproject.toml. MUST be re-verified via
+    # a devloop deploy on db-tellr-dev-pinfix or equivalent before PR3 ships.
     "databricks-sdk==0.120.0",
     "mlflow[databricks]==3.14.0",
     "mlflow-skinny==3.14.0",
@@ -81,9 +94,11 @@ dependencies = [
     "databricks-ai-search==0.76",
     "databricks-connect==16.1.7",
     "databricks-vectorsearch==0.75",
-    "langchain-classic==1.0.0",
-    "langgraph==1.0.10",
-    "langgraph-prebuilt==1.0.10",
+    "langchain-classic==1.0.8",
+    "langgraph==1.2.10",
+    "langgraph-checkpoint==4.1.1",
+    "langgraph-prebuilt==1.1.0",
+    "langgraph-sdk==0.4.2",
     "langsmith==0.9.5",
     "unitycatalog-ai==0.3.2",
     "unitycatalog-langchain==0.3.0",

{databricks_tellr_app-0.4.3.dev34 → databricks_tellr_app-0.4.3.dev35}/src/api/fixtures/tour_demo_deck.json

@@ -24,5 +24,56 @@
     }
   ],
   "chat_prompt": "Create 3 slides about the benefits of AI in modern healthcare, with a title slide, key advantages, and future outlook.",
-  "chat_reply": "Here's your deck with 3 slides! I've created:\n\n1. **Title Slide** — introducing AI in healthcare\n2. **Key Advantages** — early detection, personalized treatment, operational efficiency, and drug discovery\n3. **Future Outlook** — predictive monitoring, AI-assisted surgery, and global health equity\n\nFeel free to ask me to refine any slide, add new ones, or change the style."
+  "chat_reply": "Here's your deck with 3 slides! I've created:\n\n1. **Title Slide** — introducing AI in healthcare\n2. **Key Advantages** — early detection, personalized treatment, operational efficiency, and drug discovery\n3. **Future Outlook** — predictive monitoring, AI-assisted surgery, and global health equity\n\nFeel free to ask me to refine any slide, add new ones, or change the style.",
+  "deck_spec": {
+    "title": "Example Deck — AI in Healthcare",
+    "audience": "A first-time Tellr user taking the product tour: a general business audience, with no clinical or machine-learning background assumed.",
+    "purpose": "Show a new user what a finished Tellr deck looks like, on a subject that needs no domain briefing, so they can see structure and styling before they write their own prompt.",
+    "argument": "AI already delivers concrete benefits across diagnosis, treatment and research, and its near-term trajectory points at prevention and wider access, so it is worth engaging with now rather than watching.",
+    "call_to_action": "Ask the assistant to refine a slide, add a new one, or change the style: the next step of the tour.",
+    "narrative_arc": [
+      "Frame the subject: AI is already changing patient care, diagnostics and medical research, a transformation under way rather than a forecast.",
+      "Ground that claim in four advantages visible today: earlier disease detection, personalized treatment, operational efficiency, and faster drug discovery.",
+      "Extend today's gains into the near future and land on access: predictive monitoring, AI-assisted surgery, and specialist-level care reaching underserved communities."
+    ],
+    "design_contract": {
+      "design_system_id": null,
+      "template_id": null,
+      "slide_style_id": null
+    },
+    "resolved_data": {
+      "synthesis": "No live data was resolved for this deck. The tour ships fixed illustrative bytes so every user sees the same three slides; the claims are widely reported general benefits of AI in healthcare, not figures drawn from a source system.",
+      "figures": [],
+      "gaps": [
+        "No quantitative source: the deck cites no measured figure, so no claim in it is traceable to a dataset.",
+        "No organisation context: the tour deck is deliberately generic and names no customer, hospital or vendor."
+      ]
+    },
+    "slides": [
+      {
+        "position": 0,
+        "purpose": "Open the deck: name the subject and frame AI in healthcare as a transformation already under way.",
+        "content_brief": "Title slide. Badge reading 'AI & Healthcare', headline 'The Benefits of AI in Modern Healthcare', and a one-line standfirst naming the three areas the deck covers: patient care, diagnostics, and medical research.",
+        "assumes": "Nothing. This is the deck's first slide.",
+        "hands_off": "The reader knows the subject and expects concrete advantages next.",
+        "data_references": []
+      },
+      {
+        "position": 1,
+        "purpose": "Make the case with four concrete present-day advantages, so the benefit claim is specific rather than atmospheric.",
+        "content_brief": "Four bolded items, one explanatory clause each: early disease detection (imaging patterns a human reader can miss), personalized treatment plans (genetics, lifestyle, history), operational efficiency (scheduling, documentation, triage), and drug discovery acceleration (molecular simulation at scale).",
+        "assumes": "The reader has accepted the framing from the title slide.",
+        "hands_off": "The present-tense case is made; the reader is ready to look forward.",
+        "data_references": []
+      },
+      {
+        "position": 2,
+        "purpose": "Extend the argument from today's gains to the near future and close on access, so the deck ends on consequence rather than a list.",
+        "content_brief": "Three bolded forward-looking items: predictive health monitoring (wearables shifting medicine from reactive to proactive), AI-assisted surgery (robotics guided by real-time analysis), and global health equity (mobile diagnostics for underserved communities). Close on the italic line about healthcare becoming intelligent, personalized and accessible to all.",
+        "assumes": "The reader accepts the four present-day advantages from the previous slide.",
+        "hands_off": "The deck ends; the reader leaves with the equity claim as the takeaway.",
+        "data_references": []
+      }
+    ]
+  }
 }