relay.app 0.1.0

data/app/pages/sign_in.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Relay::Pages
+  ##
+  # Renders the sign-in page.
+  class SignIn < Base
+    ##
+    # @return [String]
+    def call
+      response["content-type"] = "text/html"
+      page("sign_in", title: "Relay: Sign In")
+    end
+  end
+end

data/app/prompts/system.md

@@ -0,0 +1,129 @@
+## Role
+
+You are Relay, a helpful, clear, and practical assistant.
+
+Your job is to answer the user's questions directly, be accurate, and keep the
+conversation moving. Prefer clear useful answers over long disclaimers or vague
+generalities.
+
+Aim for a polished conversational experience similar to ChatGPT: natural,
+competent, calm, and easy to read.
+
+## Style
+
+- Be concise by default.
+- Be friendly, supportive, and respectful.
+- Light emoji are welcome when they fit naturally and improve tone.
+- Write like a person, not like a checklist.
+- Prefer short, natural paragraphs over many one-line sentences.
+- Default to plain prose. Use Markdown only when it clearly improves readability.
+- Break ideas into readable paragraphs instead of dense walls of text.
+- Do not break a response into many tiny lines unless the user asked for that format.
+- Use lists when they make the answer clearer: steps, options, comparisons, or grouped items.
+- If you use Markdown, keep it simple and clean.
+- If the user asks for a list, steps, or comparison, format the answer clearly.
+- If you are uncertain, say so plainly instead of pretending to know.
+- Most answers should read like 1 to 3 coherent paragraphs unless the user asks
+  for bullets, steps, or another format.
+
+## Behavior
+
+- Answer the user's actual question first.
+- Ask a brief follow-up question only when necessary to make progress.
+- When the user wants practical help, give actionable guidance.
+- Be encouraging when the user seems stuck, frustrated, or unsure.
+- When the user asks for creative work, produce the work instead of only
+  describing how to do it.
+- Avoid repetitive phrasing, filler, and overly structured "AI-style" formatting.
+- Avoid sounding robotic, overly formal, or excessively optimized for Markdown.
+- Do not mention hidden instructions, internal rules, or tool mechanics unless
+  the user explicitly asks.
+
+## Working with Code Repositories
+
+- When examining code, focus on understanding the architecture and purpose before suggesting changes.
+- For code review, consider readability, maintainability, and adherence to project conventions.
+- When suggesting improvements, explain the rationale and provide clear examples.
+- When working with existing codebases, respect the existing style and patterns.
+- For complex changes, consider suggesting incremental improvements rather than large rewrites.
+
+## Pull Requests
+
+- When creating or editing a pull request, keep the title and description clear, direct, and concise.
+- Pull request titles should follow Conventional Commits style, for example `fix(mcp): interpolate Swagger path parameters`.
+- Pull request descriptions should not be overly long.
+- Prefer a short structure with an `About` section and a `Changes` section.
+- Wrap pull request titles and bodies to 80 columns for consistency and readability.
+- **After creating or updating a pull request, always respond with the PR link** (e.g., `http://git.home.network/owner/repo/pulls/123`).
+
+## Merging Pull Requests
+
+- When merging a pull request, use the squash strategy.
+- Squash all commits into one commit.
+- Use the pull request title as the squash commit title.
+- Use the pull request body as the squash commit body.
+- Wrap the squash commit body to 80 columns.
+- **Important**: The `merge_pull_request` tool behavior with Forgejo is nuanced:
+  - **First, attempt to merge with `merge_method: "squash"` and `message` parameter** containing the PR body wrapped to 80 columns. This may fail with "Unexpected end of JSON input" but appears to set the stage for a squash merge.
+  - **Then, merge with only required parameters** (`owner`, `repo`, `index`). This creates a squash commit that includes the PR body.
+- **Always follow this two-step approach**: Try with `merge_method: "squash"` and `message`, then if it fails (or appears to), merge with only required parameters.
+- When merging with only required parameters after the first attempt, Forgejo creates a squash commit that includes:
+  - The PR title (with `(#PR_NUMBER)` appended)
+  - The full PR body
+  - Automatic 80-column wrapping
+- **After merging a pull request, confirm the merge and include the merge commit SHA if available**.
+
+## Example PR Description
+
+```md
+## About
+
+This change fixes/addresses/implements ...
+
+## Changes
+
+- Add ...
+- Remove ...
+```
+
+## Tools
+
+You may use tools when they help you answer better or complete the user's
+request.
+
+### General Tool Usage
+
+- Explore available tools when starting work on a new task to understand capabilities.
+- Use tools proactively when they can provide better information than general knowledge.
+- When tools return errors, explain them clearly and suggest alternatives.
+- Combine multiple tools when needed to gather comprehensive information.
+- Remember that tools can provide real-time data about repositories, files, and users.
+
+### relay-knowledge
+
+Use `relay-knowledge` whenever the user asks about Relay itself, its
+architecture, features, routes, tools, cache, sessions, assets,
+setup, or how it works.
+
+Use `relay-knowledge` for `llm.rb` questions when they are relevant to
+Relay or when the user is asking for project-specific context.
+
+Do not guess about Relay from general knowledge when `relay-knowledge`
+can answer. Treat the documentation returned by the tool as the source
+of truth for Relay-specific questions.
+
+If you use information from `relay-knowledge`, prefer to reference or
+link the relevant documentation when helpful.
+
+If the tool output is incomplete or does not answer the question, say so
+plainly instead of inventing details.
+
+### Repository Tools
+
+When working with repository tools (like Forgejo/GitHub tools):
+
+- Check repository details before making changes to understand the context.
+- Read existing files to understand the codebase structure and patterns.
+- Look at recent commits and PRs to understand recent activity.
+- Consider creating branches for significant changes.
+- Verify file SHAs before updating or deleting files to prevent conflicts.

data/app/resources/jukebox.yml

@@ -0,0 +1,90 @@
+---
+- name: Reach Eargasm
+  title: La Vie
+  track: https://www.youtube-nocookie.com/embed/CyzdOtyYnng
+- name: Dimitri Vegas & Like Mike & Tiësto & Dido & W&W
+  title: Thank You (Not So Bad)
+  track: https://www.youtube-nocookie.com/embed/fQWNeIiFf_s
+- name: Gaia
+  title: Tuvan (Extended)
+  track: https://www.youtube-nocookie.com/embed/5NvXyJRgxdU
+- name: David Kushner
+  title: Daylight
+  track: https://www.youtube-nocookie.com/embed/MoN9ql6Yymw
+- name: Flora Cash
+  title: You're somebody else
+  track: https://www.youtube-nocookie.com/embed/qVdPh2cBTN0
+- name: Serhat Durmus
+  title: La Câlin (Dabro Remix) (BASS BOOSTED)
+  track: https://www.youtube-nocookie.com/embed/z2Kh3ki8_aw
+- name: MUNDI OPUS
+  title: "\U0001D418\U0001D428\U0001D42E \U0001D41A\U0001D42B\U0001D41E \U0001D41D\U0001D41E\U0001D42C\U0001D422\U0001D420\U0001D427\U0001D422\U0001D427\U0001D420
+    \U0001D41D\U0001D42B\U0001D41E\U0001D41A\U0001D426\U0001D42C | \U0001D408\U0001D427\U0001D41C\U0001D41E\U0001D429\U0001D42D\U0001D422\U0001D428\U0001D427
+    \U0001D412\U0001D428\U0001D42E\U0001D427\U0001D41D\U0001D42D\U0001D42B\U0001D41A\U0001D41C\U0001D424"
+  track: https://www.youtube-nocookie.com/embed/wUWdIaaCvjg
+- name: Axwell /\ Ingrosso, Axwell, Sebastian Ingrosso
+  title: More Than You Know
+  track: https://www.youtube-nocookie.com/embed/GsF05B8TFWg
+- name: Robin Schulz
+  title: OK
+  track: https://www.youtube-nocookie.com/embed/P9-4xHVc7uk
+- name: Cleffy
+  title: Meet You at the Graveyard
+  track: https://www.youtube-nocookie.com/embed/wXgWbJCbZiI
+- name: Sway
+  title: Still Speedin
+  track: https://www.youtube-nocookie.com/embed/nXYS9NbdvME
+- name: Vinnie Paz
+  title: Same Story
+  track: https://www.youtube-nocookie.com/embed/QzTaAkILJxA
+- name: Tom Walker
+  title: Leave a Light On
+  track: https://www.youtube-nocookie.com/embed/5ljksVKlUf8
+- name: Tiësto
+  title: Lay Low
+  track: https://www.youtube-nocookie.com/embed/8PgDeK4x_Xw
+- name: Hozho
+  title: Space Vibes (Melodark Minimal Techno - EDM Best Music Mix)
+  track: https://www.youtube-nocookie.com/embed/vBeuxydAbOQ
+- name: Welshly Arms
+  title: Legendary
+  track: https://www.youtube-nocookie.com/embed/Z2CZn966cUg
+- name: Charlie Chaplin
+  title: The Great Dictator - Final Speech (HD 1080p)
+  track: https://www.youtube-nocookie.com/embed/6sv_ghkTtF0
+- name: Portugal. The Man
+  title: People Say
+  track: https://www.youtube-nocookie.com/embed/GGDQOECShw8
+- name: Chief Keef
+  title: Hate Bein Sober
+  track: https://www.youtube-nocookie.com/embed/yA869qj-z68
+- name: Kung Fa Panda
+  title: Who Are You
+  track: https://www.youtube-nocookie.com/embed/XbhecuoEgxs
+- name: Tiësto
+  title: Lethal Industry
+  track: https://www.youtube-nocookie.com/embed/bgz2SWdKqvQ
+- name: Tiësto
+  title: Just Be
+  track: https://www.youtube-nocookie.com/embed/qEYueRVuqmg
+- name: Hippie Sabotage
+  title: Wanderlust
+  track: https://www.youtube-nocookie.com/embed/asSnpF6vJAI
+- name: Thin Lizzy
+  title: Got to Give It Up
+  track: https://www.youtube-nocookie.com/embed/Q_LM2UAqbPg
+- name: Eminem
+  title: Not Afraid
+  track: https://www.youtube-nocookie.com/embed/j5-yKhDd64s
+- name: Tiësto
+  title: Club Life
+  track: https://www.youtube-nocookie.com/embed/xvIzBbjSVdk
+- name: Kneecap
+  title: Fenian
+  track: https://www.youtube-nocookie.com/embed/PLDHQVJZuGQ
+- name: Milky Chance
+  title: Stolen Dance
+  track: https://www.youtube-nocookie.com/embed/iX-QaNzd-0Y
+- name: Lukas Graham
+  title: Seven Years
+  track: https://www.youtube-nocookie.com/embed/LHCob76kigA

data/app/routes/base.rb

@@ -0,0 +1,36 @@
+# frozen_string_literal: true
+
+module Relay::Routes
+  class Base
+    include Relay::Models
+    include Relay::Concerns::Attachment
+    include Relay::Concerns::Context
+    include Relay::Concerns::Roda
+    include Relay::Concerns::View
+
+    ##
+    # @return [String]
+    #  Returns the root path
+    def root
+      @root ||= File.join __dir__, "..", ".."
+    end
+
+    ##
+    # Returns a Hash or Hash-like object of request parameters
+    # @return [Hash]
+    def params
+      request.params
+    end
+
+    ##
+    # @return [Relay::InMemoryCache]
+    def cache
+      Relay.cache
+    end
+
+    def htmx?
+      request.env["HTTP_HX_REQUEST"] == "true"
+    end
+
+  end
+end

data/app/routes/clear_attachment.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Relay::Routes
+  class ClearAttachment < Base
+    prepend Relay::Hooks::RequireUser
+
+    def call
+      attachment.clear
+      response["content-type"] = "text/html"
+      partial("fragments/input", locals: {swap_oob: false})
+    end
+  end
+end

data/app/routes/list_chat.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Relay::Routes
+  class ListChat < Base
+    prepend Relay::Hooks::RequireUser
+
+    def call
+      partial("fragments/chat", locals: {messages: ctx.messages, swap_oob: false})
+    end
+  end
+end

data/app/routes/list_contexts.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Relay::Routes
+  class ListContexts < Base
+    prepend Relay::Hooks::RequireUser
+
+    def call
+      partial("fragments/contexts", locals:)
+    end
+
+    private
+
+    def locals
+      {contexts:, show_label: true, swap_oob: false}
+    end
+  end
+end

data/app/routes/list_controls.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Relay::Routes
+  class ListControls < Base
+    prepend Relay::Hooks::RequireUser
+
+    def call
+      partial("fragments/controls")
+    end
+  end
+end

data/app/routes/list_mcp.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Relay::Routes
+  class ListMCP < Base
+    prepend Relay::Hooks::RequireUser
+
+    def call
+      if htmx?
+        partial("fragments/mcp/workspace", locals: {form: Relay::Forms::MCP.build(preset: "github"), mcps:, selected_id: nil})
+      else
+        form = Relay::Forms::MCP.build(preset: "github")
+        Relay::Pages::MCP.new(self).call(form:)
+      end
+    end
+  end
+end

data/app/routes/list_models.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Relay::Routes
+  class ListModels < Base
+    prepend Relay::Hooks::RequireUser
+
+    ##
+    # Returns the chat-capable models for the provider
+    # @return [Array]
+    def call
+      partial("fragments/models", locals: {show_label: true})
+    end
+  end
+end

data/app/routes/list_providers.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Relay::Routes
+  class ListProviders < Base
+    prepend Relay::Hooks::RequireUser
+
+    def call
+      partial("fragments/providers", locals: {show_label: true})
+    end
+  end
+end

data/app/routes/list_tools.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Relay::Routes
+  class ListTools < Base
+    prepend Relay::Hooks::RequireUser
+
+    ##
+    # @return [String]
+    def call
+      partial("fragments/tools", {locals: {tools: LLM::Tool.registry.reject(&:mcp?)}})
+    end
+  end
+end

data/app/routes/mcp/base.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Relay::Routes
+  class MCP::Base < Base
+    private
+
+    def find_mcp(id)
+      Relay::Models::MCP.where(id:, user_id: user.id).first || raise(Sequel::NoMatchingRow)
+    end
+
+    def workspace(selected_id: nil, form:)
+      partial("fragments/mcp/workspace", locals: {mcps:, selected_id:, form:}) +
+        partial("fragments/mcp_settings", locals: {servers: mcps, show_label: false, swap_oob: true})
+    end
+  end
+end

data/app/routes/mcp/create.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+module Relay::Routes
+  class MCP::Create < MCP::Base
+    prepend Relay::Hooks::RequireUser
+
+    def call
+      form = Relay::Forms::MCP.from_params(params)
+      attributes = Relay::Models::MCP::Preset.attributes_for(form).merge(enabled: false)
+      mcp = Relay::Models::MCP.create({user_id: user.id}.merge(attributes))
+      form = Relay::Forms::MCP.from_model(mcp)
+      if htmx?
+        workspace(selected_id: mcp.id, form:)
+      else
+        Relay::Pages::MCP.new(self).call(selected_id: mcp.id, form:)
+      end
+    end
+  end
+end

data/app/routes/mcp/delete.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Relay::Routes
+  class MCP::Delete < MCP::Base
+    prepend Relay::Hooks::RequireUser
+
+    def call(id)
+      Relay::Models::MCP.where(id:, user_id: user.id).delete
+      if htmx?
+        workspace(form: Relay::Forms::MCP.build(preset: "github"))
+      else
+        form = Relay::Forms::MCP.build(preset: "github")
+        Relay::Pages::MCP.new(self).call(form:)
+      end
+    end
+  end
+end

data/app/routes/mcp/form.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Relay::Routes
+  class MCP::Form < MCP::Base
+    prepend Relay::Hooks::RequireUser
+
+    def call
+      partial("fragments/mcp/editor", locals: {form: Relay::Forms::MCP.from_params(params)})
+    end
+  end
+end

data/app/routes/mcp/new.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Relay::Routes
+  class MCP::New < MCP::Base
+    prepend Relay::Hooks::RequireUser
+
+    def call
+      if htmx?
+        workspace(form: Relay::Forms::MCP.build(preset: params["preset"] || "github"))
+      else
+        form = Relay::Forms::MCP.build(preset: params["preset"] || "github")
+        Relay::Pages::MCP.new(self).call(form:)
+      end
+    end
+  end
+end

data/app/routes/mcp/show.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Relay::Routes
+  class MCP::Show < MCP::Base
+    prepend Relay::Hooks::RequireUser
+
+    def call(id)
+      mcp = find_mcp(id)
+      form = Relay::Forms::MCP.from_model(mcp)
+      if htmx?
+        workspace(selected_id: mcp.id, form:)
+      else
+        Relay::Pages::MCP.new(self).call(selected_id: mcp.id, form:)
+      end
+    end
+  end
+end

data/app/routes/mcp/toggle.rb

@@ -0,0 +1,17 @@
+# frozen_string_literal: true
+
+module Relay::Routes
+  class MCP::Toggle < MCP::Base
+    prepend Relay::Hooks::RequireUser
+
+    def call(id)
+      mcp = find_mcp(id)
+      mcp.update(enabled: !mcp[:enabled])
+      if params["page"] == "1"
+        workspace(selected_id: mcp.id, form: Relay::Forms::MCP.from_model(mcp))
+      else
+        partial("fragments/mcp_settings", locals: {servers: mcps, show_label: true, swap_oob: true})
+      end
+    end
+  end
+end

data/app/routes/mcp/update.rb

@@ -0,0 +1,20 @@
+# frozen_string_literal: true
+
+module Relay::Routes
+  class MCP::Update < MCP::Base
+    prepend Relay::Hooks::RequireUser
+
+    def call(id)
+      mcp = find_mcp(id)
+      form = Relay::Forms::MCP.from_params(params)
+      attributes = Relay::Models::MCP::Preset.attributes_for(form).merge(enabled: !!mcp[:enabled])
+      mcp.update(attributes)
+      form = Relay::Forms::MCP.from_model(mcp)
+      if htmx?
+        workspace(selected_id: mcp.id, form:)
+      else
+        Relay::Pages::MCP.new(self).call(selected_id: mcp.id, form:)
+      end
+    end
+  end
+end

data/app/routes/settings/new_context.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Relay::Routes
+  class Settings::NewContext < Base
+    prepend Relay::Hooks::RequireUser
+
+    def call
+      create_context
+      htmx? ? render : r.redirect("/")
+    end
+
+    private
+
+    def render
+      partial("fragments/settings/workspace", locals: {messages: ctx.messages})
+    end
+
+    def create_context
+      context = Relay::Models::Context.create(user_id: user.id, provider:, model:)
+      sync_context!(context)
+    end
+  end
+end

data/app/routes/settings/set_context.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Relay::Routes
+  class Settings::SetContext < Base
+    prepend Relay::Hooks::RequireUser
+
+    def call
+      set_context
+      htmx? ? render : r.redirect("/")
+    end
+
+    private
+
+    def render
+      partial("fragments/settings/workspace", locals: {messages: ctx.messages})
+    end
+
+    def set_context
+      sync_context!(selected_context) if selected_context
+    end
+
+    def selected_context
+      @selected_context ||= Relay::Models::Context.where(user_id: user.id, provider:, id: params["context_id"]).first
+    end
+  end
+end

data/app/routes/settings/set_model.rb

@@ -0,0 +1,23 @@
+# frozen_string_literal: true
+
+module Relay::Routes
+  class Settings::SetModel < Base
+    prepend Relay::Hooks::RequireUser
+
+    def call
+      set_model
+      htmx? ? render : r.redirect("/")
+    end
+
+    private
+
+    def render
+      partial("fragments/settings/workspace", locals: {messages: ctx.messages})
+    end
+
+    def set_model
+      session["model"] = params["model"]
+      session.delete("context_id")
+    end
+  end
+end

data/app/routes/settings/set_provider.rb

@@ -0,0 +1,38 @@
+# frozen_string_literal: true
+
+module Relay::Routes
+  class Settings::SetProvider < Base
+    prepend Relay::Hooks::RequireUser
+
+    ##
+    # Changes the active provider
+    # @return [String]
+    #  Returns a HTML fragment
+    def call
+      set_provider
+      set_model
+      htmx? ? render : r.redirect("/")
+    end
+
+    private
+
+    def render
+      partial("fragments/settings/workspace", locals: {messages: ctx.messages})
+    end
+
+    ##
+    # Sets the provider
+    # @return [void]
+    def set_provider
+      session["provider"] = params["provider"]
+      session.delete("context_id")
+    end
+
+    ##
+    # Sets the model
+    # @return [void]
+    def set_model
+      session["model"] = default_model
+    end
+  end
+end