RubyGems - rubyllm-observ - Versions diffs - 0.5.0 - Mend

rubyllm-observ 0.5.0

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 (209) hide show

checksums.yaml +7 -0
data/README.md +778 -0
data/Rakefile +49 -0
data/app/assets/javascripts/observ/application.js +12 -0
data/app/assets/javascripts/observ/controllers/autoscroll_controller.js +33 -0
data/app/assets/javascripts/observ/controllers/chat_form_controller.js +93 -0
data/app/assets/javascripts/observ/controllers/copy_controller.js +43 -0
data/app/assets/javascripts/observ/controllers/dashboard_controller.js +58 -0
data/app/assets/javascripts/observ/controllers/drawer_controller.js +58 -0
data/app/assets/javascripts/observ/controllers/expandable_controller.js +33 -0
data/app/assets/javascripts/observ/controllers/filter_controller.js +36 -0
data/app/assets/javascripts/observ/controllers/index.js +52 -0
data/app/assets/javascripts/observ/controllers/json_viewer_controller.js +260 -0
data/app/assets/javascripts/observ/controllers/message_form_controller.js +58 -0
data/app/assets/javascripts/observ/controllers/prompt_variables_controller.js +64 -0
data/app/assets/javascripts/observ/controllers/text_select_controller.js +14 -0
data/app/assets/stylesheets/observ/_annotations.scss +127 -0
data/app/assets/stylesheets/observ/_card.scss +52 -0
data/app/assets/stylesheets/observ/_chat.scss +156 -0
data/app/assets/stylesheets/observ/_components.scss +460 -0
data/app/assets/stylesheets/observ/_dashboard.scss +40 -0
data/app/assets/stylesheets/observ/_datasets.scss +697 -0
data/app/assets/stylesheets/observ/_drawer.scss +273 -0
data/app/assets/stylesheets/observ/_json_viewer.scss +120 -0
data/app/assets/stylesheets/observ/_layout.scss +256 -0
data/app/assets/stylesheets/observ/_metrics.scss +99 -0
data/app/assets/stylesheets/observ/_observations.scss +160 -0
data/app/assets/stylesheets/observ/_pagination.scss +143 -0
data/app/assets/stylesheets/observ/_prompts.scss +365 -0
data/app/assets/stylesheets/observ/_table.scss +53 -0
data/app/assets/stylesheets/observ/_variables.scss +53 -0
data/app/assets/stylesheets/observ/application.scss +15 -0
data/app/controllers/observ/annotations_controller.rb +144 -0
data/app/controllers/observ/application_controller.rb +8 -0
data/app/controllers/observ/chats_controller.rb +58 -0
data/app/controllers/observ/dashboard_controller.rb +159 -0
data/app/controllers/observ/dataset_items_controller.rb +85 -0
data/app/controllers/observ/dataset_run_items_controller.rb +84 -0
data/app/controllers/observ/dataset_runs_controller.rb +110 -0
data/app/controllers/observ/datasets_controller.rb +74 -0
data/app/controllers/observ/messages_controller.rb +26 -0
data/app/controllers/observ/observations_controller.rb +59 -0
data/app/controllers/observ/prompt_versions_controller.rb +148 -0
data/app/controllers/observ/prompts_controller.rb +205 -0
data/app/controllers/observ/sessions_controller.rb +45 -0
data/app/controllers/observ/traces_controller.rb +86 -0
data/app/forms/observ/prompt_form.rb +96 -0
data/app/helpers/observ/application_helper.rb +9 -0
data/app/helpers/observ/chats_helper.rb +47 -0
data/app/helpers/observ/dashboard_helper.rb +154 -0
data/app/helpers/observ/datasets_helper.rb +62 -0
data/app/helpers/observ/pagination_helper.rb +38 -0
data/app/jobs/observ/application_job.rb +4 -0
data/app/jobs/observ/dataset_runner_job.rb +49 -0
data/app/mailers/observ/application_mailer.rb +6 -0
data/app/models/concerns/observ/agent_phaseable.rb +124 -0
data/app/models/concerns/observ/agent_selectable.rb +50 -0
data/app/models/concerns/observ/chat_enhancements.rb +109 -0
data/app/models/concerns/observ/message_enhancements.rb +31 -0
data/app/models/concerns/observ/observability_instrumentation.rb +124 -0
data/app/models/concerns/observ/prompt_management.rb +320 -0
data/app/models/concerns/observ/trace_association.rb +9 -0
data/app/models/observ/annotation.rb +23 -0
data/app/models/observ/application_record.rb +5 -0
data/app/models/observ/dataset.rb +51 -0
data/app/models/observ/dataset_item.rb +41 -0
data/app/models/observ/dataset_run.rb +104 -0
data/app/models/observ/dataset_run_item.rb +111 -0
data/app/models/observ/generation.rb +56 -0
data/app/models/observ/null_prompt.rb +59 -0
data/app/models/observ/observation.rb +38 -0
data/app/models/observ/prompt.rb +315 -0
data/app/models/observ/score.rb +51 -0
data/app/models/observ/session.rb +131 -0
data/app/models/observ/span.rb +13 -0
data/app/models/observ/trace.rb +135 -0
data/app/presenters/observ/agent_select_presenter.rb +59 -0
data/app/services/observ/agent_executor_service.rb +174 -0
data/app/services/observ/agent_provider.rb +60 -0
data/app/services/observ/agent_selection_service.rb +53 -0
data/app/services/observ/chat_instrumenter.rb +523 -0
data/app/services/observ/dataset_runner_service.rb +153 -0
data/app/services/observ/evaluator_runner_service.rb +58 -0
data/app/services/observ/evaluators/base_evaluator.rb +51 -0
data/app/services/observ/evaluators/contains_evaluator.rb +53 -0
data/app/services/observ/evaluators/exact_match_evaluator.rb +23 -0
data/app/services/observ/evaluators/json_structure_evaluator.rb +44 -0
data/app/services/observ/prompt_manager/cache_statistics.rb +82 -0
data/app/services/observ/prompt_manager/caching.rb +167 -0
data/app/services/observ/prompt_manager/comparison.rb +49 -0
data/app/services/observ/prompt_manager/version_management.rb +96 -0
data/app/services/observ/prompt_manager.rb +40 -0
data/app/services/observ/trace_text_formatter.rb +349 -0
data/app/validators/observ/prompt_config_validator.rb +187 -0
data/app/views/kaminari/_first_page.html.erb +11 -0
data/app/views/kaminari/_gap.html.erb +8 -0
data/app/views/kaminari/_last_page.html.erb +11 -0
data/app/views/kaminari/_next_page.html.erb +11 -0
data/app/views/kaminari/_page.html.erb +12 -0
data/app/views/kaminari/_paginator.html.erb +25 -0
data/app/views/kaminari/_prev_page.html.erb +11 -0
data/app/views/kaminari/observ/_first_page.html.erb +11 -0
data/app/views/kaminari/observ/_gap.html.erb +8 -0
data/app/views/kaminari/observ/_last_page.html.erb +11 -0
data/app/views/kaminari/observ/_next_page.html.erb +11 -0
data/app/views/kaminari/observ/_page.html.erb +12 -0
data/app/views/kaminari/observ/_paginator.html.erb +25 -0
data/app/views/kaminari/observ/_prev_page.html.erb +11 -0
data/app/views/layouts/observ/application.html.erb +88 -0
data/app/views/observ/annotations/_annotation.html.erb +13 -0
data/app/views/observ/annotations/_form.html.erb +28 -0
data/app/views/observ/annotations/index.html.erb +28 -0
data/app/views/observ/annotations/sessions_index.html.erb +48 -0
data/app/views/observ/annotations/traces_index.html.erb +48 -0
data/app/views/observ/chats/_form.html.erb +45 -0
data/app/views/observ/chats/index.html.erb +67 -0
data/app/views/observ/chats/new.html.erb +17 -0
data/app/views/observ/chats/show.html.erb +34 -0
data/app/views/observ/dashboard/index.html.erb +236 -0
data/app/views/observ/dataset_items/_form.html.erb +49 -0
data/app/views/observ/dataset_items/edit.html.erb +18 -0
data/app/views/observ/dataset_items/index.html.erb +95 -0
data/app/views/observ/dataset_items/new.html.erb +18 -0
data/app/views/observ/dataset_run_items/_score_close_drawer.html.erb +4 -0
data/app/views/observ/dataset_run_items/_score_drawer.html.erb +75 -0
data/app/views/observ/dataset_run_items/_score_success.html.erb +29 -0
data/app/views/observ/dataset_run_items/_scores_cell.html.erb +19 -0
data/app/views/observ/dataset_run_items/details_drawer.turbo_stream.erb +80 -0
data/app/views/observ/dataset_run_items/score_drawer.turbo_stream.erb +7 -0
data/app/views/observ/dataset_runs/index.html.erb +108 -0
data/app/views/observ/dataset_runs/new.html.erb +57 -0
data/app/views/observ/dataset_runs/review.html.erb +155 -0
data/app/views/observ/dataset_runs/show.html.erb +166 -0
data/app/views/observ/datasets/_form.html.erb +62 -0
data/app/views/observ/datasets/_items_tab.html.erb +66 -0
data/app/views/observ/datasets/_runs_tab.html.erb +82 -0
data/app/views/observ/datasets/edit.html.erb +32 -0
data/app/views/observ/datasets/index.html.erb +105 -0
data/app/views/observ/datasets/new.html.erb +18 -0
data/app/views/observ/datasets/show.html.erb +67 -0
data/app/views/observ/messages/_content.html.erb +1 -0
data/app/views/observ/messages/_form.html.erb +33 -0
data/app/views/observ/messages/_message.html.erb +14 -0
data/app/views/observ/messages/_tool_calls.html.erb +10 -0
data/app/views/observ/messages/create.turbo_stream.erb +9 -0
data/app/views/observ/observations/index.html.erb +97 -0
data/app/views/observ/observations/show_generation.html.erb +195 -0
data/app/views/observ/observations/show_span.html.erb +93 -0
data/app/views/observ/prompts/_diff_content.html.erb +16 -0
data/app/views/observ/prompts/_form.html.erb +111 -0
data/app/views/observ/prompts/_new_form.html.erb +102 -0
data/app/views/observ/prompts/_prompt_actions.html.erb +4 -0
data/app/views/observ/prompts/_prompt_content_highlighted.html.erb +4 -0
data/app/views/observ/prompts/_version_actions.html.erb +40 -0
data/app/views/observ/prompts/compare.html.erb +155 -0
data/app/views/observ/prompts/edit.html.erb +17 -0
data/app/views/observ/prompts/index.html.erb +108 -0
data/app/views/observ/prompts/new.html.erb +17 -0
data/app/views/observ/prompts/show.html.erb +138 -0
data/app/views/observ/prompts/versions.html.erb +87 -0
data/app/views/observ/sessions/annotations_drawer.turbo_stream.erb +25 -0
data/app/views/observ/sessions/drawer_test.turbo_stream.erb +49 -0
data/app/views/observ/sessions/index.html.erb +91 -0
data/app/views/observ/sessions/show.html.erb +251 -0
data/app/views/observ/traces/add_to_dataset_drawer.turbo_stream.erb +48 -0
data/app/views/observ/traces/annotations_drawer.turbo_stream.erb +25 -0
data/app/views/observ/traces/index.html.erb +87 -0
data/app/views/observ/traces/show.html.erb +285 -0
data/app/views/observ/traces/text_output_drawer.turbo_stream.erb +48 -0
data/app/views/shared/_drawer.html.erb +26 -0
data/config/routes.rb +80 -0
data/db/migrate/001_create_observ_sessions.rb +21 -0
data/db/migrate/002_create_observ_traces.rb +25 -0
data/db/migrate/003_create_observ_observations.rb +42 -0
data/db/migrate/004_add_message_id_to_observ_traces.rb +7 -0
data/db/migrate/005_create_observ_prompts.rb +21 -0
data/db/migrate/006_fix_prompt_config_strings.rb +23 -0
data/db/migrate/007_create_observ_annotations.rb +12 -0
data/db/migrate/009_add_prompt_fields_to_observ_chats.rb +11 -0
data/db/migrate/010_create_observ_datasets.rb +15 -0
data/db/migrate/011_create_observ_dataset_items.rb +17 -0
data/db/migrate/012_create_observ_dataset_runs.rb +22 -0
data/db/migrate/013_create_observ_dataset_run_items.rb +16 -0
data/db/migrate/014_create_observ_scores.rb +26 -0
data/lib/generators/observ/add_phase_tracking/add_phase_tracking_generator.rb +150 -0
data/lib/generators/observ/add_phase_tracking/templates/migration.rb.tt +6 -0
data/lib/generators/observ/install/USAGE +27 -0
data/lib/generators/observ/install/install_generator.rb +270 -0
data/lib/generators/observ/install_chat/install_chat_generator.rb +313 -0
data/lib/generators/observ/install_chat/templates/agents/base_agent.rb.tt +147 -0
data/lib/generators/observ/install_chat/templates/agents/simple_agent.rb.tt +55 -0
data/lib/generators/observ/install_chat/templates/concerns/observ_chat_enhancements.rb.tt +34 -0
data/lib/generators/observ/install_chat/templates/concerns/observ_message_enhancements.rb.tt +18 -0
data/lib/generators/observ/install_chat/templates/initializers/observability.rb.tt +20 -0
data/lib/generators/observ/install_chat/templates/jobs/chat_response_job.rb.tt +56 -0
data/lib/generators/observ/install_chat/templates/migrations/add_agent_class_name.rb.tt +6 -0
data/lib/generators/observ/install_chat/templates/migrations/add_observability_session_id.rb.tt +6 -0
data/lib/generators/observ/install_chat/templates/tools/think_tool.rb.tt +29 -0
data/lib/generators/observ/install_chat/templates/views/messages/_content.html.erb.tt +1 -0
data/lib/observ/asset_installer.rb +130 -0
data/lib/observ/asset_syncer.rb +104 -0
data/lib/observ/configuration.rb +108 -0
data/lib/observ/engine.rb +50 -0
data/lib/observ/index_file_generator.rb +142 -0
data/lib/observ/instrumenter/ruby_llm.rb +6 -0
data/lib/observ/version.rb +3 -0
data/lib/observ.rb +29 -0
data/lib/tasks/observ_tasks.rake +75 -0
metadata +453 -0

data/app/views/observ/sessions/index.html.erb ADDED Viewed

@@ -0,0 +1,91 @@
+<% content_for :title, "Sessions" %>
+<% content_for :page_header do %>
+  <div class="observ-page-header__content">
+    <h1 class="observ-page-header__title">Sessions</h1>
+  </div>
+<% end %>
+<div class="observ-container">
+  <section class="observ-card">
+    <div class="observ-card__body">
+      <% if @sessions.any? %>
+        <table class="observ-table">
+          <thead class="observ-table__header">
+            <tr class="observ-table__row">
+              <th class="observ-table__cell">Session ID</th>
+              <th class="observ-table__cell">Agent</th>
+              <th class="observ-table__cell">User ID</th>
+              <th class="observ-table__cell">Start Time</th>
+              <th class="observ-table__cell">Duration</th>
+              <th class="observ-table__cell observ-table__cell--numeric">Traces</th>
+              <th class="observ-table__cell observ-table__cell--numeric">Tokens</th>
+              <th class="observ-table__cell observ-table__cell--numeric">Cost</th>
+              <th class="observ-table__cell observ-table__cell--numeric">Annotations</th>
+              <th class="observ-table__cell">Status</th>
+              <th class="observ-table__cell"></th>
+            </tr>
+          </thead>
+          <tbody>
+            <% @sessions.each do |session| %>
+              <tr class="observ-table__row">
+                <td class="observ-table__cell">
+                  <code class="observ-code observ-code--inline"><%= truncate_id(session.session_id, 12) %></code>
+                </td>
+                <td class="observ-table__cell">
+                  <%= session.metadata&.dig("agent_type") || "—" %>
+                </td>
+                <td class="observ-table__cell">
+                  <% if session.user_id.present? %>
+                    <code class="observ-code observ-code--inline"><%= truncate_id(session.user_id, 8) %></code>
+                  <% else %>
+                    <span class="observ-text--muted">—</span>
+                  <% end %>
+                </td>
+                <td class="observ-table__cell">
+                  <%= observ_timestamp(session.start_time) %>
+                </td>
+                <td class="observ-table__cell">
+                  <% if session.duration_s %>
+                    <%= format_duration_s(session.duration_s) %>
+                  <% else %>
+                    <span class="observ-text--muted">In Progress</span>
+                  <% end %>
+                </td>
+                <td class="observ-table__cell observ-table__cell--numeric">
+                  <%= session.end_time ? session.total_traces_count : session.traces.count %>
+                </td>
+                <td class="observ-table__cell observ-table__cell--numeric">
+                  <%= format_tokens(session.end_time ? session.total_tokens : session.traces.sum(:total_tokens)) %>
+                </td>
+                <td class="observ-table__cell observ-table__cell--numeric">
+                  <%= format_currency(session.end_time ? session.total_cost : session.traces.sum(:total_cost)) %>
+                </td>
+                <td class="observ-table__cell observ-table__cell--numeric">
+                  <% if session.annotations.any? %>
+                    <span class="observ-badge observ-badge--info"><%= session.annotations.count %></span>
+                  <% else %>
+                    <span class="observ-text--muted">—</span>
+                  <% end %>
+                </td>
+                <td class="observ-table__cell">
+                  <%= observ_status_badge(observ_session_status(session)) %>
+                </td>
+                <td class="observ-table__cell observ-table__cell--actions">
+                  <%= link_to "View", session_path(session), class: "observ-button observ-button--sm" %>
+                </td>
+              </tr>
+            <% end %>
+          </tbody>
+        </table>
+      <% else %>
+        <div class="observ-card__empty">
+          <p>No sessions found.</p>
+      </div>
+    <% end %>
+  </section>
+  <%= observ_pagination(@sessions) %>
+</div>
+  </section>
+</div>

data/app/views/observ/sessions/show.html.erb ADDED Viewed

@@ -0,0 +1,251 @@
+<% content_for :title, "Session #{truncate_id(@session.session_id, 12)}" %>
+<% content_for :page_header do %>
+  <div class="observ-page-header__content">
+    <div class="observ-page-header__breadcrumb">
+      <%= link_to "Sessions", sessions_path, class: "observ-link" %> /
+    </div>
+    <h1 class="observ-page-header__title">
+      Session <code class="observ-code observ-code--inline"><%= truncate_id(@session.session_id, 12) %></code>
+    </h1>
+    <div class="observ-page-header__meta">
+      <%= observ_status_badge(observ_session_status(@session)) %>
+    </div>
+  </div>
+  <div class="observ-page-header__actions">
+    <%= link_to "#",
+        class: "observ-button observ-button--primary observ-button--sm",
+        data: {
+          action: "click->observ--drawer#open",
+          drawer_url_param: annotations_drawer_session_path(@session)
+        } do %>
+      Annotate
+      <% if @session.annotations.any? %>
+        <span class="observ-badge observ-badge--light"><%= @session.annotations.count %></span>
+      <% end %>
+    <% end %>
+  </div>
+<% end %>
+<div class="observ-container">
+  <section class="observ-metrics-grid observ-metrics-grid--4col">
+    <div class="observ-metric-card">
+      <div class="observ-metric-card__header">
+        <h3 class="observ-metric-card__label">Traces</h3>
+      </div>
+      <div class="observ-metric-card__body">
+        <p class="observ-metric-card__value"><%= @session_metrics[:total_traces] %></p>
+      </div>
+    </div>
+    <div class="observ-metric-card">
+      <div class="observ-metric-card__header">
+        <h3 class="observ-metric-card__label">LLM Calls</h3>
+      </div>
+      <div class="observ-metric-card__body">
+        <p class="observ-metric-card__value"><%= @session_metrics[:total_llm_calls] %></p>
+      </div>
+    </div>
+    <div class="observ-metric-card">
+      <div class="observ-metric-card__header">
+        <h3 class="observ-metric-card__label">Total Tokens</h3>
+      </div>
+      <div class="observ-metric-card__body">
+        <p class="observ-metric-card__value"><%= format_tokens(@session_metrics[:total_tokens]) %></p>
+      </div>
+    </div>
+    <div class="observ-metric-card observ-metric-card--highlighted">
+      <div class="observ-metric-card__header">
+        <h3 class="observ-metric-card__label">Total Cost</h3>
+      </div>
+      <div class="observ-metric-card__body">
+        <p class="observ-metric-card__value"><%= format_currency(@session_metrics[:total_cost]) %></p>
+      </div>
+    </div>
+    <div class="observ-metric-card">
+      <div class="observ-metric-card__header">
+        <h3 class="observ-metric-card__label">Duration</h3>
+      </div>
+      <div class="observ-metric-card__body">
+        <p class="observ-metric-card__value">
+          <% if @session_metrics[:duration_s] %>
+            <%= format_duration_s(@session_metrics[:duration_s]) %>
+          <% else %>
+            <span class="observ-text--muted">In Progress</span>
+          <% end %>
+        </p>
+      </div>
+    </div>
+    <div class="observ-metric-card">
+      <div class="observ-metric-card__header">
+        <h3 class="observ-metric-card__label">Avg Latency</h3>
+      </div>
+      <div class="observ-metric-card__body">
+        <p class="observ-metric-card__value"><%= format_duration_ms(@session_metrics[:average_llm_latency_ms]) %></p>
+      </div>
+    </div>
+    <div class="observ-metric-card">
+      <div class="observ-metric-card__header">
+        <h3 class="observ-metric-card__label">Total LLM Time</h3>
+      </div>
+      <div class="observ-metric-card__body">
+        <p class="observ-metric-card__value"><%= format_duration_ms(@session_metrics[:total_llm_duration_ms]) %></p>
+      </div>
+    </div>
+    <div class="observ-metric-card">
+      <div class="observ-metric-card__header">
+        <h3 class="observ-metric-card__label">Started</h3>
+      </div>
+      <div class="observ-metric-card__body">
+        <p class="observ-metric-card__value observ-metric-card__value--small">
+          <%= observ_relative_time(@session.start_time) %>
+        </p>
+      </div>
+    </div>
+  </section>
+  <% if @session.metadata.present? && @session.metadata.any? %>
+    <section class="observ-card">
+      <header class="observ-card__header">
+        <h2 class="observ-card__title">Metadata</h2>
+      </header>
+      <div class="observ-card__body">
+        <dl class="observ-definition-list">
+          <% @session.metadata.each do |key, value| %>
+            <div class="observ-definition-list__item">
+              <dt class="observ-definition-list__term"><%= key %></dt>
+              <dd class="observ-definition-list__definition"><%= value %></dd>
+            </div>
+          <% end %>
+        </dl>
+      </div>
+    </section>
+  <% end %>
+  <section class="observ-card">
+    <header class="observ-card__header">
+      <h2 class="observ-card__title">Traces (<%= @traces.count %>)</h2>
+    </header>
+    <div class="observ-card__body">
+      <% if @traces.any? %>
+        <table class="observ-table">
+          <thead class="observ-table__header">
+            <tr class="observ-table__row">
+              <th class="observ-table__cell">Trace ID</th>
+              <th class="observ-table__cell">Name</th>
+              <th class="observ-table__cell">Model(s)</th>
+              <th class="observ-table__cell">Start Time</th>
+              <th class="observ-table__cell">Duration</th>
+              <th class="observ-table__cell observ-table__cell--numeric">Observations</th>
+              <th class="observ-table__cell observ-table__cell--numeric">Tokens</th>
+              <th class="observ-table__cell observ-table__cell--numeric">Cost</th>
+              <th class="observ-table__cell">Status</th>
+              <th class="observ-table__cell"></th>
+            </tr>
+          </thead>
+          <tbody>
+            <% @traces.each do |trace| %>
+              <tr class="observ-table__row">
+                <td class="observ-table__cell">
+                  <code class="observ-code observ-code--inline"><%= truncate_id(trace.trace_id, 12) %></code>
+                </td>
+                <td class="observ-table__cell">
+                  <%= trace.name || "—" %>
+                </td>
+                <td class="observ-table__cell">
+                  <% models = trace.models_used %>
+                  <% if models.any? %>
+                    <%= models.join(", ") %>
+                  <% else %>
+                    <span class="observ-text--muted">—</span>
+                  <% end %>
+                </td>
+                <td class="observ-table__cell">
+                  <%= observ_timestamp(trace.start_time) %>
+                </td>
+                <td class="observ-table__cell">
+                  <% if trace.duration_ms %>
+                    <%= format_duration_ms(trace.duration_ms) %>
+                  <% else %>
+                    <span class="observ-text--muted">—</span>
+                  <% end %>
+                </td>
+                <td class="observ-table__cell observ-table__cell--numeric">
+                  <%= trace.observations.count %>
+                </td>
+                <td class="observ-table__cell observ-table__cell--numeric">
+                  <%= format_tokens(trace.total_tokens) %>
+                </td>
+                <td class="observ-table__cell observ-table__cell--numeric">
+                  <%= format_currency(trace.total_cost) %>
+                </td>
+                <td class="observ-table__cell">
+                  <%= observ_status_badge(observ_trace_status(trace)) %>
+                </td>
+                <td class="observ-table__cell observ-table__cell--actions">
+                  <%= link_to "View", trace_path(trace), class: "observ-button observ-button--sm" %>
+                </td>
+              </tr>
+            <% end %>
+          </tbody>
+        </table>
+      <% else %>
+        <div class="observ-card__empty">
+          <p>No traces found for this session.</p>
+        </div>
+      <% end %>
+    </div>
+  </section>
+  <% if @chat.present? %>
+    <section class="observ-card">
+      <header class="observ-card__header">
+        <h2 class="observ-card__title">Chat Conversation</h2>
+        <div class="observ-card__actions">
+          <%= link_to "View Chat", chat_path(@chat), class: "observ-button observ-button--sm" %>
+        </div>
+      </header>
+      <div class="observ-card__body">
+        <% if @chat.messages.any? %>
+          <div class="observ-chat-messages">
+            <% @chat.messages.order(created_at: :asc).each do |message| %>
+              <div class="observ-chat-message observ-chat-message--<%= message.role %>">
+                <div class="observ-chat-message__header">
+                  <span class="observ-chat-message__role"><%= message.role.capitalize %></span>
+                  <span class="observ-chat-message__time"><%= observ_relative_time(message.created_at) %></span>
+                  <% if message.traces.exists? %>
+                    <%= link_to "View Trace", trace_path(message.traces.first), class: "observ-chat-message__trace-link" %>
+                  <% end %>
+                  <% if message.input_tokens || message.output_tokens %>
+                    <span class="observ-chat-message__tokens">
+                      <% if message.input_tokens %>
+                        <span>In: <%= format_tokens(message.input_tokens) %></span>
+                      <% end %>
+                      <% if message.output_tokens %>
+                        <span>Out: <%= format_tokens(message.output_tokens) %></span>
+                      <% end %>
+                    </span>
+                  <% end %>
+                </div>
+                <div class="observ-chat-message__content">
+                  <%= simple_format(message.content) %>
+                </div>
+              </div>
+            <% end %>
+          </div>
+        <% else %>
+          <div class="observ-card__empty">
+            <p>No messages found in this chat.</p>
+          </div>
+        <% end %>
+      </div>
+    </section>
+  <% end %>
+</div>

data/app/views/observ/traces/add_to_dataset_drawer.turbo_stream.erb ADDED Viewed

@@ -0,0 +1,48 @@
+<%= turbo_stream.update "drawer-header-title" do %>
+  Add to Dataset
+<% end %>
+<%= turbo_stream.update "drawer-content" do %>
+  <div class="observ-drawer__section">
+    <% if @datasets.any? %>
+      <%= form_with url: add_to_dataset_trace_path(@trace), method: :post, class: "observ-form" do |f| %>
+        <div class="observ-form__group">
+          <%= f.label :dataset_id, "Select Dataset", class: "observ-form__label" %>
+          <%= f.select :dataset_id,
+            options_for_select(@datasets.map { |d| ["#{d.name} (#{d.agent_class})", d.id] }),
+            { prompt: "Choose a dataset..." },
+            class: "observ-form__select", required: true %>
+          <p class="observ-form__hint">The trace will be added as a new item in the selected dataset.</p>
+        </div>
+        <div class="observ-form__group">
+          <label class="observ-form__label">Input (from trace)</label>
+          <pre class="observ-code-block observ-code-block--compact observ-code-block--preview"><%= format_trace_data(@trace.input) %></pre>
+        </div>
+        <div class="observ-form__group">
+          <%= f.label :expected_output, "Expected Output", class: "observ-form__label" %>
+          <%= f.text_area :expected_output,
+            value: format_trace_data(@trace.output),
+            class: "observ-form__textarea observ-form__textarea--code",
+            rows: 6,
+            placeholder: "Leave empty to use trace output as expected output" %>
+          <p class="observ-form__hint">Optional. Pre-filled with trace output. Edit if needed.</p>
+        </div>
+        <div class="observ-form__actions">
+          <%= f.submit "Add to Dataset", class: "observ-button observ-button--primary" %>
+          <button type="button" class="observ-button" data-action="click->observ--drawer#close">
+            Cancel
+          </button>
+        </div>
+      <% end %>
+    <% else %>
+      <div class="observ-card__empty">
+        <p class="observ-card__empty-text">No datasets available</p>
+        <p class="observ-card__empty-subtext">Create a dataset first to add traces to it.</p>
+        <%= link_to "Create Dataset", new_dataset_path, class: "observ-button observ-button--primary" %>
+      </div>
+    <% end %>
+  </div>
+<% end %>

data/app/views/observ/traces/annotations_drawer.turbo_stream.erb ADDED Viewed

@@ -0,0 +1,25 @@
+<%= turbo_stream.update "drawer-header-title" do %>
+  Trace Annotations
+<% end %>
+<%= turbo_stream.update "drawer-content" do %>
+  <div class="observ-drawer__section">
+    <%= render "observ/annotations/form", annotatable: @trace, annotation: @annotation %>
+  </div>
+  <div class="observ-drawer__section">
+    <h3 class="observ-drawer__section-title">
+      Annotations (<span id="annotations-count"><%= @annotations.count %></span>)
+    </h3>
+    <div id="annotations-list" class="observ-annotations-list">
+      <% if @annotations.any? %>
+        <%= render partial: "observ/annotations/annotation", collection: @annotations, locals: { annotatable: @trace } %>
+      <% else %>
+        <div id="annotations-empty-state" class="observ-empty-state">
+          <p class="observ-empty-state__text">No annotations yet</p>
+        </div>
+      <% end %>
+    </div>
+  </div>
+<% end %>

data/app/views/observ/traces/index.html.erb ADDED Viewed

@@ -0,0 +1,87 @@
+<% content_for :title, "Traces" %>
+<% content_for :page_header do %>
+  <div class="observ-page-header__content">
+    <h1 class="observ-page-header__title">Traces</h1>
+  </div>
+<% end %>
+<div class="observ-container">
+  <section class="observ-card">
+    <div class="observ-card__body">
+      <% if @traces.any? %>
+        <table class="observ-table">
+          <thead class="observ-table__header">
+            <tr class="observ-table__row">
+              <th class="observ-table__cell">Trace ID</th>
+              <th class="observ-table__cell">Session ID</th>
+              <th class="observ-table__cell">Name</th>
+              <th class="observ-table__cell">Start Time</th>
+              <th class="observ-table__cell">Duration</th>
+              <th class="observ-table__cell observ-table__cell--numeric">Observations</th>
+              <th class="observ-table__cell observ-table__cell--numeric">Tokens</th>
+              <th class="observ-table__cell observ-table__cell--numeric">Cost</th>
+              <th class="observ-table__cell observ-table__cell--numeric">Annotations</th>
+              <th class="observ-table__cell">Status</th>
+              <th class="observ-table__cell"></th>
+            </tr>
+          </thead>
+          <tbody>
+            <% @traces.each do |trace| %>
+              <tr class="observ-table__row">
+                <td class="observ-table__cell">
+                  <code class="observ-code observ-code--inline"><%= truncate_id(trace.trace_id, 12) %></code>
+                </td>
+                <td class="observ-table__cell">
+                  <%= link_to truncate_id(trace.observ_session.session_id, 8), session_path(trace.observ_session), class: "observ-link" %>
+                </td>
+                <td class="observ-table__cell">
+                  <%= trace.name || "—" %>
+                </td>
+                <td class="observ-table__cell">
+                  <%= observ_timestamp(trace.start_time) %>
+                </td>
+                <td class="observ-table__cell">
+                  <% if trace.duration_ms %>
+                    <%= format_duration_ms(trace.duration_ms) %>
+                  <% else %>
+                    <span class="observ-text--muted">In Progress</span>
+                  <% end %>
+                </td>
+                <td class="observ-table__cell observ-table__cell--numeric">
+                  <%= trace.observations.count %>
+                </td>
+                <td class="observ-table__cell observ-table__cell--numeric">
+                  <%= format_tokens(trace.total_tokens) %>
+                </td>
+                <td class="observ-table__cell observ-table__cell--numeric">
+                  <%= format_currency(trace.total_cost) %>
+                </td>
+                <td class="observ-table__cell observ-table__cell--numeric">
+                  <% if trace.annotations.any? %>
+                    <span class="observ-badge observ-badge--info"><%= trace.annotations.count %></span>
+                  <% else %>
+                    <span class="observ-text--muted">—</span>
+                  <% end %>
+                </td>
+                <td class="observ-table__cell">
+                  <%= observ_status_badge(observ_trace_status(trace)) %>
+                </td>
+                <td class="observ-table__cell observ-table__cell--actions">
+                  <%= link_to "View", trace_path(trace), class: "observ-button observ-button--sm" %>
+                </td>
+              </tr>
+            <% end %>
+          </tbody>
+        </table>
+      <% else %>
+        <div class="observ-card__empty">
+          <p>No traces found.</p>
+      </div>
+    <% end %>
+  </section>
+  <%= observ_pagination(@traces) %>
+</div>
+  </section>
+</div>