legate 0.1.0

data/lib/legate/web/views/chat.slim

@@ -0,0 +1,192 @@
+/ File: lib/legate/web/views/chat.slim
+/ Agent chat / run view — 3 zones: header (name·model·status·sessions) ·
+/ transcript + composer · Run Details inspector. HTMX wires preserved.
+- agent_name = @agent_data[:name]
+- is_running = @agent_data[:running]
+- chat_model = (@agent_data[:model] && !@agent_data[:model].to_s.empty?) ? @agent_data[:model] : Legate::Agent::DEFAULT_MODEL
+- configured_tools = @agent_data[:configured_tools] || []
+- sessions_to_list = (@previous_sessions_list || []).reject { |s| @active_session_details && s.id == @active_session_details.id }
+
+div#chat_interface_wrapper
+  .chat-shell
+    .chat-main
+      / --- Header bar ---
+      .chat-header
+        a.chat-back(href="/agents/#{agent_name}" title="Back to agent")
+          span.icon
+            i.fas.fa-arrow-left
+        .chat-header-titles
+          h2.chat-agent-name= agent_name
+          span.mono-chip.model-chip(title="Language model")
+            span.icon.is-small
+              i.fas.fa-microchip
+            span= chat_model
+        .chat-header-actions
+          div#agent-chat-panel-status-display
+            p
+              span.tag.is-rounded class=(is_running ? 'is-success' : 'is-danger')
+                = is_running ? 'Running' : 'Stopped'
+          button.chat-new-session-btn#start-new-chat-button(hx-post="/agents/#{agent_name}/chat/session/new" hx-target="#chat_interface_wrapper" hx-indicator="#start-new-chat-button")
+            span.icon.is-small
+              i.fas.fa-plus
+            span New Session
+            span.icon.is-small.htmx-indicator
+              i.fas.fa-spinner.fa-pulse
+          .dropdown.is-right.chat-sessions-dropdown(_="on click toggle .is-active on the closest .dropdown")
+            .dropdown-trigger
+              button.chat-sessions-btn(type="button" aria-haspopup="true")
+                span.icon.is-small
+                  i.fas.fa-clock-rotate-left
+                span Sessions
+                span.icon.is-small
+                  i.fas.fa-angle-down
+            .dropdown-menu(role="menu")
+              .dropdown-content
+                - if @active_session_details
+                  .chat-session-current
+                    .chat-session-line
+                      span.chat-session-tag Current session
+                      form(hx-delete="/agents/#{agent_name}/chat/session/#{@active_session_details.id}" hx-target="#chat_interface_wrapper" hx-confirm="Delete this chat session? This cannot be undone.")
+                        button.chat-session-del(type="submit" title="Delete session")
+                          i.fas.fa-trash-alt
+                    p.chat-session-summary= summarize_session(@active_session_details)
+                - if sessions_to_list.any?
+                  hr.dropdown-divider
+                  - sessions_to_list.each do |session_item|
+                    form.chat-session-switch(hx-post="/agents/#{agent_name}/chat/session/switch" hx-target="#chat_interface_wrapper")
+                      input type="hidden" name="legate_session_to_switch_to" value="#{session_item.id}"
+                      button.chat-session-switch-btn(type="submit")
+                        span.icon.is-small
+                          i.fas.fa-comment-dots
+                        span= summarize_session(session_item)
+                - elsif !@active_session_details
+                  p.dropdown-item.has-text-grey No previous sessions.
+
+      / Session operation error display (hidden until HTMX swaps an error in)
+      div#session-operation-error.notification.is-danger.is-hidden.mb-3
+
+      / --- Transcript ---
+      #chat-log-container.chat-transcript(
+        hx-on::after-swap="this.scrollTop = this.scrollHeight"
+        _="init set my scrollTop to my scrollHeight end"
+      )
+        - if @chat_history_events && !@chat_history_events.empty?
+          - @chat_history_events.each do |event|
+            - if event.role == :user
+              .message.is-link.is-small.mb-2.user-message(id="event-#{event.event_id}")
+                .message-header
+                  p You
+                .message-body= event.content
+            - elsif event.role == :agent
+              - agent_response_content = event.content
+              - is_complex_content = (agent_response_content.is_a?(Hash) && agent_response_content.key?(:status)) || (agent_response_content.is_a?(Array) && agent_response_content.first.is_a?(Hash) && agent_response_content.first.key?(:status))
+              - msg_class = 'is-light'
+              - if is_complex_content
+                - status = agent_response_content.is_a?(Array) ? agent_response_content.first[:status] : agent_response_content[:status]
+                - case status
+                - when :error
+                  - msg_class = 'is-danger'
+                - when :pending
+                  - msg_class = 'is-warning'
+                - else
+                  - msg_class = 'is-success'
+              - else
+                - msg_class = 'is-success'
+
+              .message class="#{msg_class} agent-message is-small mb-4" id="event-#{event.event_id}"
+                .message-header
+                  p Agent (#{@agent_data[:name]})
+                  - raw_json_content = agent_response_content.to_json rescue "{}"
+                  - unless raw_json_content.empty? || raw_json_content == "{}"
+                    button.button.is-light.is-small.ml-auto( onclick="var el = document.getElementById('raw-#{event.event_id}'); el.style.display = (el.style.display == 'none' ? 'block' : 'none');" )
+                      | Raw JSON
+                .message-body
+                  div style="white-space: pre-wrap; word-break: break-word; margin-bottom: 0.5rem;" = format_historical_agent_content(agent_response_content)
+
+                  - if agent_response_content.is_a?(Hash) && agent_response_content[:plan_details].is_a?(Array) && !agent_response_content[:plan_details].empty?
+                    details.execution-plan-details
+                      summary.execution-plan-summary
+                        | Execution Plan (#{agent_response_content[:plan_details].size} step#{'s' if agent_response_content[:plan_details].size != 1})
+                      .execution-plan-steps
+                        - agent_response_content[:plan_details].each_with_index do |step_detail, index|
+                          .execution-plan-step
+                            p.step-title Step #{index + 1}: #{step_detail[:tool_name]}
+                            p.step-params-label Parameters:
+                            pre.step-params-pre= JSON.pretty_generate(step_detail[:params] || {})
+
+                            - result_status = step_detail.dig(:result, :status)
+                            - result_class = case result_status when :success then 'has-text-success-dark' when :error then 'has-text-danger-dark' when :pending then 'has-text-warning-dark' else 'has-text-grey' end
+
+                            p class="step-result-label #{result_class}" Result (#{result_status || "unknown"}):
+                            pre class="step-result-pre #{result_class}"= JSON.pretty_generate(step_detail[:result] || {}) rescue "{}"
+
+                  - raw_json_content = agent_response_content.to_json rescue "{}"
+                  - unless raw_json_content.empty? || raw_json_content == "{}"
+                    div.raw-json-container id="raw-#{event.event_id}" style="display: none;"
+                      pre.raw-json-pre= raw_json_content
+            - elsif event.role == :tool_request || event.role == :tool_result
+              / Hidden for a cleaner history; details live in the agent message's execution plan.
+            - else
+              p.notification.is-warning.is-light Unknown event role: #{event.role}
+        - else
+          .chat-empty-state
+            .chat-empty-emblem
+              i.fas.fa-gem
+            p.chat-empty-title Start a conversation
+            p.chat-empty-hint
+              - if is_running
+                = "Send a message to #{agent_name} below to begin."
+              - else
+                | Start the agent from its page to begin chatting.
+
+      / --- Composer ---
+      .chat-composer
+        form#chat-form(
+          hx-post="/agents/#{agent_name}/chat"
+          hx-target="#chat-log-container"
+          hx-swap="beforeend"
+          hx-indicator="#send-button-indicator"
+          _="on htmx:afterRequest call me.reset() then get #chat-log-container then set its scrollTop to its scrollHeight"
+        )
+          .chat-composer-row
+            .control.is-expanded.chat-input-wrap
+              input.input#chat-input(
+                type="text"
+                name="message"
+                placeholder="Message #{agent_name}…"
+                required=true
+                autofocus
+                disabled=(!is_running || !@active_session_details)
+              )
+              span.icon.is-small.is-right.htmx-indicator.chat-input-spinner
+                i.fas.fa-spinner.fa-spin
+            button.button.is-primary#send-button(
+              type="submit"
+              disabled=(!is_running || !@active_session_details)
+            )
+              span Send
+              span.icon.is-small.ml-1
+                i.fas.fa-paper-plane
+              span.icon.is-small#send-button-indicator.htmx-indicator.ml-1
+                i.fas.fa-spinner.fa-pulse
+
+          #chat-status-help-container.mt-2
+            - if @agent_data && !is_running
+              p.help.is-danger#chat-not-running-help Agent must be running to chat.
+            - elsif @agent_data && is_running && !@active_session_details
+              p.help.is-warning#chat-no-active-session-help No active chat session. Start a new session above.
+            - else
+              p.help.is-hidden No issues.
+
+    / --- Run Details inspector ---
+    aside.chat-inspector
+      h3.inspector-title Run Details
+      == slim :_active_session_info, locals: { active_session_details: @active_session_details }
+      .inspector-section
+        .inspector-label Available Tools
+        - if configured_tools.any?
+          .inspector-tools
+            - configured_tools.each do |t|
+              span.tool-chip= t
+        - else
+          p.inspector-empty No tools configured

data/lib/legate/web/views/docs_index.slim

@@ -0,0 +1,105 @@
+/ File: lib/legate/web/views/docs_index.slim
+
+.content.mb-5
+  h1.title.is-2 Legate Documentation
+  p.subtitle Browse available documentation for Legate.
+
+- if @categorized_documents.nil? || @categorized_documents.empty?
+  .notification.is-warning
+    p No documentation files found in 
+    code public/docs
+    p  or an error occurred while listing them.
+- else
+  .field.mb-4
+    .control.has-icons-left.search-with-shortcut
+      input.input#doc-search-input type="text" placeholder="Search documentation..." onkeyup="filterDocs()"
+      span.icon.is-left
+        i.fas.fa-search
+      span.keyboard-hint
+        kbd ⌘K
+
+  - @categorized_documents.each do |category, documents|
+    - unless documents.empty?
+      h3.title.is-4.mt-5 = category
+      .box.p-0
+        .table-container
+          table.table.is-fullwidth.is-hoverable.is-striped.documentation-index-table
+            thead
+              tr
+                th Document 
+                th Description
+                th.has-text-centered.action-column
+            tbody class="doc-category-body" data-category=category.downcase
+              - documents.each do |doc|
+                tr.doc-row data-title=doc[:title].downcase data-summary=doc[:summary].downcase data-path=doc[:path]
+                  td
+                    a.doc-title href="/docs/#{doc[:path]}" = doc[:title]
+                  td
+                    .doc-summary
+                      = doc[:summary]
+                      - if doc[:summary].empty?
+                        em.has-text-grey-light [No summary available]
+                  td.has-text-centered
+                    a.button.is-small.is-link.is-outlined href="/docs/#{doc[:path]}" 
+                      span.icon.is-small
+                        i.fas.fa-book
+                      span Read
+
+javascript:
+  function filterDocs() {
+    const input = document.getElementById('doc-search-input');
+    const filter = input.value.toLowerCase().trim();
+    const allRows = document.querySelectorAll('#doc-table-body .doc-row, .doc-category-body .doc-row'); // Select all rows
+    const categoryTitles = document.querySelectorAll('h3.title.is-4'); // Select all category titles
+
+    if (filter === '') {
+      // Show all rows and categories if search is empty
+      allRows.forEach(row => {
+        row.style.display = '';
+      });
+      categoryTitles.forEach(title => {
+        title.style.display = '';
+        const table = title.nextElementSibling.querySelector('table');
+        if(table) table.style.display = '';
+      });
+      input.placeholder = 'Search documentation...';
+      return;
+    }
+
+    let totalFoundCount = 0;
+
+    document.querySelectorAll('.doc-category-body').forEach(tableBody => {
+      let categoryFoundCount = 0;
+      const categoryRows = tableBody.querySelectorAll('.doc-row');
+      const selector = 'h3.title.is-4[data-category="' + tableBody.dataset.category + '"]'; 
+      const categoryTitleElement = document.querySelector(selector) || 
+                                 Array.from(categoryTitles).find(ct => ct.textContent.toLowerCase() === tableBody.dataset.category);
+      
+      categoryRows.forEach(row => {
+        const title = row.getAttribute('data-title');
+        const summary = row.getAttribute('data-summary');
+        
+        if (title.includes(filter) || summary.includes(filter)) {
+          row.style.display = '';
+          categoryFoundCount++;
+          totalFoundCount++;
+        } else {
+          row.style.display = 'none';
+        }
+      });
+
+      // Show/hide category title and table based on whether any docs in it matched
+      if (categoryTitleElement) {
+          const associatedTableContainer = categoryTitleElement.nextElementSibling; // Assuming .box.p-0 is next
+          if (categoryFoundCount > 0) {
+            categoryTitleElement.style.display = '';
+            if (associatedTableContainer) associatedTableContainer.style.display = '';
+          } else {
+            categoryTitleElement.style.display = 'none';
+            if (associatedTableContainer) associatedTableContainer.style.display = 'none';
+          }
+      }
+    });
+    
+    input.placeholder = `${totalFoundCount} result${totalFoundCount !== 1 ? 's' : ''} found`;
+  } 

data/lib/legate/web/views/docs_show.slim

@@ -0,0 +1,105 @@
+/ File: lib/legate/web/views/docs_show.slim
+
+.container
+  nav.breadcrumb.has-arrow-separator.p-4.has-background-info-light
+    ul
+      li
+        a href="/docs" Documentation
+      li.is-active
+        a href="#" aria-current="page" = @doc_title || "Document"
+
+  .content.mb-5
+    h1.title.is-2.mt-4 = @doc_title || "Document"
+
+  .box.documentation-content
+    / Add a table of contents for longer documents
+    - if @doc_html_content && !@doc_html_content.empty?
+      .columns
+        .column.is-9.pr-5
+          .content
+            == @doc_html_content
+        .column.is-3.is-hidden-mobile
+          .toc-container.is-sticky style="top: 80px; max-height: calc(100vh - 100px); overflow-y: auto; padding-right: 15px;"
+            .has-text-weight-bold.mb-2 Table of Contents
+            .table-of-contents
+              / This will be populated by JavaScript
+    - else
+      .notification.is-danger
+        p Error: Document content could not be loaded or rendered.
+
+/ Add JavaScript to generate a table of contents from headings
+javascript:
+  document.addEventListener('DOMContentLoaded', function() {
+    // Generate table of contents from headings
+    const content = document.querySelector('.documentation-content .content');
+    const toc = document.querySelector('.table-of-contents');
+    
+    if (content && toc) {
+      const headings = content.querySelectorAll('h2, h3, h4');
+      
+      if (headings.length > 0) {
+        const tocList = document.createElement('ul');
+        tocList.className = 'toc-list';
+        
+        headings.forEach((heading, index) => {
+          // Add ID to heading if it doesn't have one
+          if (!heading.id) {
+            heading.id = 'heading-' + index;
+          }
+          
+          const listItem = document.createElement('li');
+          listItem.className = 'toc-item toc-' + heading.tagName.toLowerCase();
+          
+          const link = document.createElement('a');
+          link.href = '#' + heading.id;
+          link.textContent = heading.textContent;
+          
+          listItem.appendChild(link);
+          tocList.appendChild(listItem);
+        });
+        
+        toc.appendChild(tocList);
+        
+        // Add styles for TOC items
+        const style = document.createElement('style');
+        style.textContent = `
+          .toc-list { 
+            list-style: none; 
+            padding-left: 0; 
+            margin-top: 0.5rem;
+          }
+          .toc-item { 
+            margin-bottom: 0.5rem;
+            font-size: 0.9rem;
+          }
+          .toc-h3 { 
+            padding-left: 1rem;
+            font-size: 0.85rem;
+          }
+          .toc-h4 { 
+            padding-left: 2rem;
+            font-size: 0.8rem;
+          }
+          .toc-item a {
+            color: #4a4a4a;
+            text-decoration: none;
+            display: block;
+            padding: 0.2rem 0;
+            border-left: 2px solid transparent;
+            padding-left: 0.5rem;
+          }
+          .toc-item a:hover {
+            color: #3273dc;
+            border-left: 2px solid #3273dc;
+          }
+          .is-sticky {
+            position: sticky;
+          }
+        `;
+        document.head.appendChild(style);
+      } else {
+        // If no headings, hide the TOC
+        document.querySelector('.toc-container').style.display = 'none';
+      }
+    }
+  });

data/lib/legate/web/views/error_404.slim

@@ -0,0 +1,5 @@
+.content
+   h1.title.is-danger= locals[:title] || "Error"
+   p= locals[:message] || "The requested page could not be found."
+   .mt-4
+     a.button href="/agents" Back to Agents List

data/lib/legate/web/views/index.slim

@@ -0,0 +1,148 @@
+/ File: lib/legate/web/views/index.slim
+
+/ Hero Welcome Section
+section.hero-welcome.mb-6
+  .hero-content
+    .hero-main
+      .hero-badge
+        i.fas.fa-gem
+      .hero-text
+        p.hero-eyebrow Legion Commander
+        h1.hero-title Command your AI legion
+        p.hero-subtitle Build, orchestrate, and run powerful AI agents in elegant Ruby.
+        button.hero-pronounce(type="button" title="Say it out loud" aria-label="Pronounce Legate")
+          span.respell
+            strong Legate
+            span.phon= "/ˈle·jit/"
+          span.pronounce-wink yep, like “legit” 😎
+          span.icon.pronounce-speaker
+            i.fas.fa-volume-up
+    .hero-actions
+      a.button.is-hero-primary.is-medium(href="/agents")
+        span.icon
+          i.fas.fa-plus
+        span Create Agent
+      a.button.is-hero-secondary.is-medium(href="/docs")
+        span.icon
+          i.fas.fa-book
+        span Documentation
+
+.columns.is-centered.is-multiline.index-dashboard-cards
+  .column.is-one-quarter
+    .card.dashboard-card.agents-card.has-text-centered
+      .card-content
+        span.icon.is-large.mb-3
+          i.fas.fa-robot.fa-3x style="color: var(--color-primary);"
+        h2.title.is-4 Agents
+        - if @running_count && @running_count > 0
+          p.is-size-2.has-text-weight-bold style="color: var(--color-primary);"
+            = @running_count
+          p.subtitle.is-6.mb-2 Running
+          p.is-size-7.has-text-grey
+            = "#{@agent_count} total defined"
+        - elsif @agent_count && @agent_count > 0
+          p.is-size-2.has-text-weight-bold style="color: var(--color-text-muted);"
+            = @agent_count
+          p.subtitle.is-6.mb-2 Defined
+          p.is-size-7.has-text-grey None running
+        - else
+          p.has-text-grey-light.is-italic.mb-2 No agents defined yet
+          p.is-size-7.has-text-grey Create your first agent
+      .card-footer
+        a.card-footer-item(href="/agents")
+          span View Agents
+          span.icon.is-small.ml-1
+            i.fas.fa-arrow-right
+        a.card-footer-item.quick-action(href="/agents" title="Create new agent")
+          span.icon
+            i.fas.fa-plus
+
+  .column.is-one-quarter
+    .card.dashboard-card.tools-card.has-text-centered
+      .card-content
+        span.icon.is-large.mb-3
+          i.fas.fa-wrench.fa-3x style="color: var(--color-primary);"
+        h2.title.is-4 Tools
+        - if @tool_count && @tool_count > 0
+          p.is-size-2.has-text-weight-bold style="color: var(--color-primary);"
+            = @tool_count
+          p.subtitle.is-6.mb-2 Available
+        - else
+          p.has-text-grey-light.is-italic.mb-2 No tools loaded
+      .card-footer
+        a.card-footer-item(href="/tools")
+          span View Tools
+          span.icon.is-small.ml-1
+            i.fas.fa-arrow-right
+        a.card-footer-item.quick-action(href="/tools" title="Build new tool with AI")
+          span.icon
+            i.fas.fa-plus
+
+  .column.is-one-quarter
+    .card.dashboard-card.auth-card.has-text-centered
+      .card-content
+        span.icon.is-large.mb-3
+          i.fas.fa-key.fa-3x style="color: var(--color-primary);"
+        h2.title.is-4 Authentication
+        - if @auth_scheme_count && @auth_scheme_count > 0
+          p.is-size-2.has-text-weight-bold style="color: var(--color-primary);"
+            = @auth_scheme_count
+          p.subtitle.is-6.mb-2 Schemes
+        - else
+          p.has-text-grey-light.is-italic.mb-2 Configure auth
+      .card-footer
+        a.card-footer-item(href="/auth")
+          span View Authentication
+          span.icon.is-small.ml-1
+            i.fas.fa-arrow-right
+
+  .column.is-one-quarter
+    .card.dashboard-card.docs-card.has-text-centered
+      .card-content
+        span.icon.is-large.mb-3
+          i.fas.fa-book-open.fa-3x style="color: var(--color-primary);"
+        h2.title.is-4 Documentation
+        p.has-text-grey Read guides and concepts about Legate.
+      .card-footer
+        a.card-footer-item(href="/docs")
+          span Read Docs
+          span.icon.is-small.ml-1
+            i.fas.fa-arrow-right
+
+/ Activity Stream Section
+.box.activity-stream-box.mt-5
+  .level.mb-4
+    .level-left
+      h3.title.is-5.mb-0
+        span.icon.mr-2
+          i.fas.fa-stream
+        | Recent Activity
+    .level-right
+      button.button.is-small.is-light(hx-get="/activity/recent" hx-target="#activity-list" hx-swap="innerHTML" title="Refresh activity")
+        span.icon.is-small
+          i.fas.fa-sync-alt
+  
+  #activity-list
+    == slim :_activity_list
+
+javascript:
+  (function () {
+    var btn = document.querySelector('.hero-pronounce');
+    if (!btn) return;
+    btn.addEventListener('click', function () {
+      btn.classList.remove('is-saying');
+      // restart the wink animation
+      void btn.offsetWidth;
+      btn.classList.add('is-saying');
+      try {
+        if ('speechSynthesis' in window) {
+          window.speechSynthesis.cancel();
+          var u = new SpeechSynthesisUtterance('Legate. Say it like legit.');
+          u.rate = 0.95;
+          u.pitch = 1.05;
+          window.speechSynthesis.speak(u);
+        }
+      } catch (e) { /* no audio, the wink still fires */ }
+      setTimeout(function () { btn.classList.remove('is-saying'); }, 900);
+    });
+  })();