openclacky 1.5.16 → 1.5.18

data/lib/clacky/default_skills/onboard/scripts/install_builtin_skills.rb

@@ -9,8 +9,7 @@ require_relative '../../skill-add/scripts/install_from_zip'
 
 class BuiltinSkillsInstaller
   PRIMARY_HOST     = ENV.fetch('CLACKY_LICENSE_SERVER', 'https://www.openclacky.com')
-  FALLBACK_HOST    = 'https://openclacky.up.railway.app'
-  API_HOSTS        = ENV['CLACKY_LICENSE_SERVER'] ? [PRIMARY_HOST] : [PRIMARY_HOST, FALLBACK_HOST]
+  API_HOSTS        = [PRIMARY_HOST]
   API_PATH         = '/api/v1/skills/builtin'
   API_OPEN_TIMEOUT = 5
   API_READ_TIMEOUT = 10

data/lib/clacky/default_skills/persist-memory/SKILL.md

@@ -1,5 +1,7 @@
 ---
 name: persist-memory
+name_zh: 记住信息
+description_zh: 把需要记住的内容写入长期记忆，自动归类合并。
 description: Persist information to long-term memory at ~/.clacky/memories/. Use when the user asks you to remember/note something, or when reviewing a finished conversation for facts worth keeping. Handles file naming, topic merging, frontmatter, and size limits.
 fork_agent: true
 user-invocable: false

data/lib/clacky/default_skills/personal-website/SKILL.md

@@ -1,5 +1,7 @@
 ---
 name: personal-website
+name_zh: 个人主页
+description_zh: 根据你的资料生成一张精美的个人主页并发布上线，得到可分享的链接。
 description: |
   Generate a beautiful personal homepage (linktree-style) and publish it online for the user.
   Reads user info from ~/.clacky/agents/USER.md and AI info from ~/.clacky/agents/SOUL.md.

data/lib/clacky/default_skills/personal-website/publish.rb

@@ -22,12 +22,9 @@ require "fileutils"
 
 # ── Config ───────────────────────────────────────────────────────────────────
 
-# Primary CDN-accelerated endpoint.
-# Fallback bypasses EdgeOne and is used when the primary times out or errors.
-PRIMARY_HOST  = ENV.fetch("CLACKY_LICENSE_SERVER", "https://www.openclacky.com")
-FALLBACK_HOST = "https://openclacky.up.railway.app"
-# When the env override is set we use only that host (dev/test mode).
-API_HOSTS     = ENV["CLACKY_LICENSE_SERVER"] ? [PRIMARY_HOST] : [PRIMARY_HOST, FALLBACK_HOST]
+# Platform endpoint; CLACKY_LICENSE_SERVER overrides it for dev/test.
+PRIMARY_HOST = ENV.fetch("CLACKY_LICENSE_SERVER", "https://www.openclacky.com")
+API_HOSTS    = [PRIMARY_HOST]
 
 HMAC_SECRET  = ENV.fetch("CARD_HMAC_SECRET", "openclacky-card-v1-default-secret-change-me")
 TOKEN_FILE   = File.expand_path("~/clacky_workspace/personal_website/token.json")
@@ -64,15 +61,14 @@ end
 
 # ── HTTP helpers ──────────────────────────────────────────────────────────────
 
-# Resilient HTTP request: retries on transient errors, then fails over to the
-# fallback host before giving up.
+# Resilient HTTP request: retries on transient errors before giving up.
 #
 # Returns [http_code_int, parsed_body_hash].
-# Calls exit(1) on network failure (all hosts/attempts exhausted).
+# Calls exit(1) on network failure (all attempts exhausted).
 def http_request(method, path, body: nil, extra_headers: {})
   last_error = nil
 
-  API_HOSTS.each_with_index do |base, host_index|
+  API_HOSTS.each do |base|
     ATTEMPTS_PER_HOST.times do |attempt|
       begin
         result = do_http_request(method, base, path, body: body, extra_headers: extra_headers)

data/lib/clacky/default_skills/product-help/SKILL.md

@@ -1,5 +1,7 @@
 ---
 name: product-help
+name_zh: 产品帮助
+description_zh: 解答关于产品本身的问题：安装、技能、配置、记忆、会话、品牌定制、故障排查等。
 description: 'Use this skill when the user asks about my own features, configuration, or usage — installation, skills, Web UI, CLI, API config, memory, sessions, encryption, white-label, publishing, pricing, troubleshooting, or restarting the server. Do NOT trigger for general coding tasks unrelated to me.'
 fork_agent: true
 user-invocable: false

data/lib/clacky/default_skills/recall-memory/SKILL.md

@@ -1,5 +1,7 @@
 ---
 name: recall-memory
+name_zh: 回忆记忆
+description_zh: 按主题从长期记忆中找出相关内容并整理成摘要。
 description: Recall relevant long-term memories on demand. Given a topic or question, judges relevance from pre-loaded metadata, loads only relevant files, and returns a concise summary to the main agent.
 fork_agent: true
 user-invocable: false

data/lib/clacky/default_skills/search-skills/SKILL.md

@@ -1,5 +1,7 @@
 ---
 name: search-skills
+name_zh: 搜索技能
+description_zh: 按关键词在所有已安装的技能中查找合适的技能。
 description: 'Search ALL installed skills (including ones not shown in AVAILABLE SKILLS) by keyword. Use this whenever you suspect a fitting skill might exist but is not listed in your system prompt — for example before building a new skill, when the user mentions a domain not covered by visible skills, or after seeing the (N more skills installed) hint. Triggers on phrases like search skills, find a skill for, is there a skill that, 查找skill, 有没有skill做.'
 disable-model-invocation: false
 user-invocable: true

data/lib/clacky/default_skills/skill-add/SKILL.md

@@ -1,5 +1,7 @@
 ---
 name: skill-add
+name_zh: 安装技能
+description_zh: 通过 zip 链接或本地 zip 文件安装技能。
 description: 'Install skills from a zip URL or local zip file path. Use this skill whenever the user wants to install a skill from a zip link or a local file, or uses commands like /skill-add with a URL or file path. Trigger on phrases like: install skill, install from zip, skill from zip, skill from url, add skill from zip, 安装skill, 从zip安装skill, 从本地安装skill.'
 disable-model-invocation: false
 user-invocable: true

data/lib/clacky/default_skills/skill-creator/SKILL.md

@@ -1,5 +1,7 @@
 ---
 name: skill-creator
+name_zh: 技能创建
+description_zh: 从零创建新技能，或修改、优化已有技能，并评估技能效果。
 description: Create new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.
 always-show: true
 ---

data/lib/clacky/extension/packager.rb

@@ -240,7 +240,7 @@ module Clacky
         src = source.to_s
         if src.match?(%r{\Ahttps?://})
           dest = File.join(tmp, "download.zip")
-          download(src, dest, on_progress: on_progress)
+          download_once(src, dest, on_progress: on_progress)
           dest
         else
           path = File.expand_path(src)
@@ -249,23 +249,6 @@ module Clacky
         end
       end
 
-      # Download url → dest file, retrying once on the secondary CDN host when
-      # the primary fails (same path/query). Both hosts serve the same backend,
-      # so ActiveStorage signed_ids resolve identically on either.
-      private def download(url, dest, on_progress: nil)
-        download_once(url, dest, on_progress: on_progress)
-      rescue Error
-        fallback = secondary_url(url)
-        raise unless fallback
-        download_once(fallback, dest, on_progress: on_progress)
-      end
-
-      private def secondary_url(url)
-        return nil unless url.start_with?(PlatformHttpClient::PRIMARY_HOST)
-
-        url.sub(PlatformHttpClient::PRIMARY_HOST, PlatformHttpClient::SECONDARY_HOST)
-      end
-
       # OpenURI's block form (`URI.open(url) { |io| ... }`) buffers the entire
       # response before yielding `io`, so reading `io` afterwards reports
       # progress only after the download has finished. We hook OpenURI's own
@@ -302,8 +285,8 @@ module Clacky
         end
       rescue Net::OpenTimeout, Net::ReadTimeout => e
         raise Error, "download timed out: #{e.message}"
-      # Catch-all so any transport-layer failure triggers download()'s
-      # secondary-host fallback instead of surfacing a raw error.
+      # Catch-all so any transport-layer failure surfaces as a packaged Error
+      # instead of a raw exception.
       rescue StandardError => e
         raise Error, "failed to download #{url}: #{e.message}"
       end

data/lib/clacky/locales/en.rb

@@ -8,7 +8,7 @@ module Clacky
       "llm.error.insufficient_credit"   => "Insufficient credit, please top up your account to continue",
       "llm.error.rate_limit_400"        => "Rate limit or service issue, retrying...",
       "llm.error.invalid_api_key"       => "API key is invalid or expired, please update it in Settings",
-      "llm.error.403.model_not_allowed" => "This model is not available on your current plan",
+      "llm.error.403.model_not_allowed" => "Free trial only supports the or-gemini-3-8-flash model. Switch to that model, or top up to use other models",
       "llm.error.403.api_key_revoked"   => "API key has been revoked, please generate a new one",
       "llm.error.403.api_key_expired"   => "API key has expired, please generate a new one",
       "llm.error.403.quota_exceeded"    => "API key quota exceeded. Please update the quota or disable the limit in the admin console",
@@ -20,11 +20,10 @@ module Clacky
       "llm.error.server_error"          => "Service temporarily unavailable (%<status>d), retrying...",
       "llm.error.unexpected"            => "Unexpected error (%<status>d)",
       "llm.error.html_response"         => "Service temporarily unavailable (received HTML error page), retrying...",
-      "llm.error.bad_request"           => "Bad request: invalid parameters. Please check your model configuration",
+      "llm.error.bad_request"           => "Model request failed. Please switch to another model and retry",
       "llm.error.request_timeout"       => "Request timed out after %<retries>d retries",
       "llm.error.network_failed"        => "Network connection failed after %<retries>d retries",
       "llm.error.service_unavailable"   => "Service unavailable after %<retries>d retries",
-      "llm.warn.switching_to_fallback_url" => "Primary endpoint unreachable. Switching to fallback gateway: %<url>s",
       "platform.error.invalid_proof"        => "Invalid license key — please check and try again.",
       "platform.error.invalid_signature"    => "Invalid request signature.",
       "platform.error.nonce_replayed"       => "Duplicate request detected. Please try again.",
@@ -42,7 +41,40 @@ module Clacky
       "platform.error.device_token_expired" => "This device's authorization has expired. Please re-authorize before publishing.",
       "platform.error.owner_user_not_found" => "No account found for this device. Please re-authorize it.",
       "platform.error.generic"              => "Request failed (HTTP %<code>s). Please contact support.",
-      "platform.error.generic_with_code"    => "Request failed (HTTP %<code>s, code: %<error_code>s). Please contact support."
+      "platform.error.generic_with_code"    => "Request failed (HTTP %<code>s, code: %<error_code>s). Please contact support.",
+      "channel.questions.context"              => "Context",
+      "channel.questions.single"               => "Question",
+      "channel.questions.numbered"             => "Question %<index>d",
+      "channel.questions.free_text_hint"       => "Or reply with your own answer.",
+      "channel.questions.recorded"             => "Answer recorded",
+      "channel.questions.expired"              => "This question is no longer active.",
+      "channel.questions.multi_hint"           => "Select all that apply, then submit.",
+      "channel.questions.submit"               => "Submit",
+      "channel.questions.incomplete"           => "Please answer every question first.",
+      "channel.progress.thinking"              => "Thinking...",
+      "channel.progress.working"               => "Working...",
+      "channel.progress.tool.browser"          => "Using the browser...",
+      "channel.progress.tool.edit"             => "Editing a file...",
+      "channel.progress.tool.file_reader"      => "Reading a file...",
+      "channel.progress.tool.glob"             => "Finding files...",
+      "channel.progress.tool.grep"             => "Searching files...",
+      "channel.progress.tool.invoke_skill"     => "Using a skill...",
+      "channel.progress.tool.terminal"         => "Running a command...",
+      "channel.progress.tool.todo_manager"     => "Updating the task plan...",
+      "channel.progress.tool.web_fetch"        => "Reading a web page...",
+      "channel.progress.tool.web_search"       => "Searching the web...",
+      "channel.progress.tool.write"            => "Writing a file...",
+      "channel.progress.task_interrupted"      => "Task interrupted.",
+      "channel.progress.waiting_response"      => "Waiting for your response.",
+      "channel.progress.step"                  => "%<count>d step",
+      "channel.progress.steps"                 => "%<count>d steps",
+      "channel.progress.error"                 => "Error: %<message>s",
+      "channel.progress.view_process"          => "View process",
+      "channel.progress.generating"            => "[Generating...]",
+      "channel.progress.status.waiting"        => "Waiting for input",
+      "channel.progress.status.success"        => "Done",
+      "channel.progress.status.failed"         => "Failed",
+      "channel.progress.status.interrupted"    => "Stopped"
     }.freeze
   end
 end

data/lib/clacky/locales/i18n.rb

@@ -9,13 +9,27 @@ module Clacky
       "zh" => Clacky::Locales::ZH,
       "en" => Clacky::Locales::EN
     }.freeze
+    DEFAULT_LOCALE = "en"
 
     def self.t(key, **vars)
-      table = LOCALES[locale] || LOCALES["en"]
-      msg   = table[key] || LOCALES["en"][key] || key
+      translate(locale, key, **vars)
+    end
+
+    def self.translate(code, key, **vars)
+      table = LOCALES[code] || LOCALES[DEFAULT_LOCALE]
+      msg   = table[key] || LOCALES[DEFAULT_LOCALE][key] || key
       vars.empty? ? msg : format(msg, **vars)
     end
 
+    # Builds { locale_code => value } for every supported locale.
+    def self.localized
+      LOCALES.keys.map { |code| [code, yield(code)] }.to_h
+    end
+
+    def self.translations(key, **vars)
+      localized { |code| translate(code, key, **vars) }
+    end
+
     def self.locale
       return Thread.current[:lang] if Thread.current[:lang]
 

data/lib/clacky/locales/zh.rb

@@ -5,10 +5,10 @@ module Clacky
     ZH = {
       "phase.skill_evolution"           => "正在复盘本次任务",
       "phase.memory_update"             => "正在更新长期记忆",
-      "llm.error.insufficient_credit"   => "账户余额不足，请前往控制台充值后继续使用",
+      "llm.error.insufficient_credit"   => "API Key 账户余额不足，请前往控制台充值后继续使用",
       "llm.error.rate_limit_400"        => "请求频率过高或服务暂时不可用，正在重试...",
       "llm.error.invalid_api_key"       => "API Key 无效或已过期，请到设置中重新配置",
-      "llm.error.403.model_not_allowed" => "当前模型不支持免费试用，请升级套餐或切换其他模型",
+      "llm.error.403.model_not_allowed" => "免费试用仅支持 or-gemini-3-8-flash 模型，请切换到该模型，或充值后使用其他模型",
       "llm.error.403.api_key_revoked"   => "API 密钥已被撤销，请前往控制台重新生成",
       "llm.error.403.api_key_expired"   => "API 密钥已过期，请前往控制台重新生成",
       "llm.error.403.quota_exceeded"    => "API Key 配额已超限，请在管理后台调整配额或关闭限制",
@@ -20,11 +20,10 @@ module Clacky
       "llm.error.server_error"          => "服务暂时不可用（%<status>d），正在重试...",
       "llm.error.unexpected"            => "请求失败（%<status>d）",
       "llm.error.html_response"         => "服务暂时不可用（收到 HTML 错误页），正在重试...",
-      "llm.error.bad_request"           => "请求参数有误，请检查模型配置或重试",
+      "llm.error.bad_request"           => "请求模型出错，请暂时切换其他模型重试",
       "llm.error.request_timeout"       => "请求超时（已重试 %<retries>d 次）",
       "llm.error.network_failed"        => "网络连接失败（已重试 %<retries>d 次）",
       "llm.error.service_unavailable"   => "服务暂时不可用（已重试 %<retries>d 次）",
-      "llm.warn.switching_to_fallback_url" => "主节点无法连接，正在切换到备用节点：%<url>s",
       "platform.error.invalid_proof"        => "许可证密钥无效，请检查后重试。",
       "platform.error.invalid_signature"    => "请求签名无效。",
       "platform.error.nonce_replayed"       => "检测到重复请求，请重试。",
@@ -42,7 +41,40 @@ module Clacky
       "platform.error.device_token_expired" => "此设备的授权已过期，请重新授权后再发布。",
       "platform.error.owner_user_not_found" => "未找到该设备对应的账户，请重新授权此设备。",
       "platform.error.generic"              => "请求失败（HTTP %<code>s），请联系客服。",
-      "platform.error.generic_with_code"    => "请求失败（HTTP %<code>s，错误码：%<error_code>s），请联系客服。"
+      "platform.error.generic_with_code"    => "请求失败（HTTP %<code>s，错误码：%<error_code>s），请联系客服。",
+      "channel.questions.context"              => "背景",
+      "channel.questions.single"               => "问题",
+      "channel.questions.numbered"             => "问题 %<index>d",
+      "channel.questions.free_text_hint"       => "也可以直接回复你自己的答案。",
+      "channel.questions.recorded"             => "已记录你的选择",
+      "channel.questions.expired"              => "该问题已失效。",
+      "channel.questions.multi_hint"           => "可多选，选好后点提交。",
+      "channel.questions.submit"               => "提交",
+      "channel.questions.incomplete"           => "请先完成所有问题。",
+      "channel.progress.thinking"              => "思考中...",
+      "channel.progress.working"               => "处理中...",
+      "channel.progress.tool.browser"          => "正在使用浏览器...",
+      "channel.progress.tool.edit"             => "正在编辑文件...",
+      "channel.progress.tool.file_reader"      => "正在读取文件...",
+      "channel.progress.tool.glob"             => "正在查找文件...",
+      "channel.progress.tool.grep"             => "正在搜索文件内容...",
+      "channel.progress.tool.invoke_skill"     => "正在使用技能...",
+      "channel.progress.tool.terminal"         => "正在执行命令...",
+      "channel.progress.tool.todo_manager"     => "正在更新任务计划...",
+      "channel.progress.tool.web_fetch"        => "正在读取网页...",
+      "channel.progress.tool.web_search"       => "正在联网搜索...",
+      "channel.progress.tool.write"            => "正在写入文件...",
+      "channel.progress.task_interrupted"      => "任务已中断。",
+      "channel.progress.waiting_response"      => "等待你的回复。",
+      "channel.progress.step"                  => "%<count>d 步",
+      "channel.progress.steps"                 => "%<count>d 步",
+      "channel.progress.error"                 => "错误：%<message>s",
+      "channel.progress.view_process"          => "查看过程",
+      "channel.progress.generating"            => "[生成中...]",
+      "channel.progress.status.waiting"        => "等待输入",
+      "channel.progress.status.success"        => "已完成",
+      "channel.progress.status.failed"         => "失败",
+      "channel.progress.status.interrupted"    => "已停止"
     }.freeze
   end
 end

data/lib/clacky/media/base.rb

@@ -53,7 +53,7 @@ module Clacky
 
       def generate_transcription(audio_base64:, mime_type:, **_kwargs)
         transcription_error_response(
-          error: "Speech-to-text is not supported by #{self.class.name.split("::").last}. Use the openclacky gateway with an STT model such as or-stt-gemini-3-5-flash.",
+          error: "Speech-to-text is not supported by #{self.class.name.split("::").last}. Use the openclacky gateway with an STT model such as or-stt-gemini-3-8-flash.",
           error_type: "not_implemented",
           provider: ""
         )
@@ -63,7 +63,7 @@ module Clacky
       #   video_understanding_error_response(...)
       def understand_video(video_base64:, mime_type:, prompt: nil, **_kwargs)
         video_understanding_error_response(
-          error: "Video understanding is not supported by #{self.class.name.split("::").last}. Use the openclacky gateway with a video understanding model such as or-gemini-3-5-flash.",
+          error: "Video understanding is not supported by #{self.class.name.split("::").last}. Use the openclacky gateway with a video understanding model such as or-gemini-3-8-flash.",
           error_type: "not_implemented",
           provider: ""
         )

data/lib/clacky/platform_http_client.rb

@@ -8,14 +8,12 @@ require_relative "locales/i18n"
 
 module Clacky
   # PlatformHttpClient provides a resilient HTTP client for all calls to the
-  # OpenClacky platform API (www.openclacky.com and its fallback domain).
+  # OpenClacky platform API (www.openclacky.com).
   #
   # Features:
   #   - Automatic retry with exponential back-off on transient failures
-  #   - Transparent domain failover: if the primary domain times out or returns a
-  #     5xx error, the request is automatically retried against the fallback domain
-  #   - Unified large-file download entry point (#download_file) that reuses the
-  #     same primary → fallback failover policy as API calls
+  #   - Unified large-file download entry point (#download_file) sharing the
+  #     same retry policy as API calls
   #   - Override via CLACKY_LICENSE_SERVER env var (auto-detected, used in development)
   #
   # Usage:
@@ -25,16 +23,12 @@ module Clacky
   #   #        or { success: false, error: "...", data: {} }
   class PlatformHttpClient
     # Primary endpoint
-    PRIMARY_HOST   = "https://www.openclacky.com"
-    # Secondary CDN-accelerated endpoint (China mainland)
-    SECONDARY_HOST = "https://api.1024code.com"
-    # Direct fallback — bypasses EdgeOne, used when the primary times out
-    FALLBACK_HOST  = "https://openclacky.up.railway.app"
-
-    # Number of attempts per domain (1 = no retry within the same domain)
-    ATTEMPTS_PER_HOST = 1
-    # Initial back-off between retries within the same domain (seconds)
-    INITIAL_BACKOFF   = 0.5
+    PRIMARY_HOST = "https://www.openclacky.com"
+
+    # Attempts per request: the initial try plus one retry
+    MAX_ATTEMPTS = 2
+    # Back-off before a retry (seconds), doubled on each further attempt
+    INITIAL_BACKOFF = 0.5
     # Connection / read timeouts (seconds) for API calls
     OPEN_TIMEOUT  = 5
     READ_TIMEOUT  = 15
@@ -53,15 +47,12 @@ module Clacky
       invalid_device_token device_token_revoked device_token_expired owner_user_not_found
     ].freeze
 
-    # Auto-detects the target host(s):
-    #   - When CLACKY_LICENSE_SERVER is set → single host (dev override, no failover)
-    #   - Otherwise                   → [PRIMARY_HOST, SECONDARY_HOST, FALLBACK_HOST]
+    # Auto-detects the platform endpoint:
+    #   - When CLACKY_LICENSE_SERVER is set → that URL (dev override)
+    #   - Otherwise                        → PRIMARY_HOST
     def initialize
-      if (override = ENV["CLACKY_LICENSE_SERVER"]) && !override.empty?
-        @hosts = [override]
-      else
-        @hosts = [PRIMARY_HOST, SECONDARY_HOST, FALLBACK_HOST]
-      end
+      override  = ENV["CLACKY_LICENSE_SERVER"]
+      @base_url = override && !override.empty? ? override : PRIMARY_HOST
     end
 
     # Send a POST request with a JSON body and return a normalised result hash.
@@ -71,7 +62,7 @@ module Clacky
     # @param headers [Hash]    Additional HTTP headers (optional)
     # @return [Hash]  { success: Boolean, data: Hash, error: String }
     def post(path, payload, headers: {})
-      request_with_failover(:post, path, payload, headers)
+      request_with_retry(:post, path, payload, headers)
     end
 
     # Send a GET request and return a normalised result hash.
@@ -81,17 +72,17 @@ module Clacky
     # @param headers [Hash]    Additional HTTP headers (optional)
     # @return [Hash]  { success: Boolean, data: Hash, error: String }
     def get(path, headers: {})
-      request_with_failover(:get, path, nil, headers)
+      request_with_retry(:get, path, nil, headers)
     end
 
     # Send a PATCH request.  Same contract as #post.
     def patch(path, payload, headers: {})
-      request_with_failover(:patch, path, payload, headers)
+      request_with_retry(:patch, path, payload, headers)
     end
 
     # Send a DELETE request (no body).
     def delete(path, headers: {})
-      request_with_failover(:delete, path, nil, headers)
+      request_with_retry(:delete, path, nil, headers)
     end
 
     # Send a multipart/form-data POST.
@@ -103,34 +94,27 @@ module Clacky
     # @return [Hash]  { success: Boolean, data: Hash, error: String }
     def multipart_post(path, body_bytes, boundary, read_timeout: READ_TIMEOUT)
       headers = { "Content-Type" => "multipart/form-data; boundary=#{boundary}" }
-      request_with_failover(:multipart_post, path, body_bytes, headers,
-                            read_timeout_override: read_timeout)
+      request_with_retry(:multipart_post, path, body_bytes, headers,
+                         read_timeout_override: read_timeout)
     end
 
     # Send a multipart/form-data PATCH.  Same contract as #multipart_post.
     def multipart_patch(path, body_bytes, boundary, read_timeout: READ_TIMEOUT)
       headers = { "Content-Type" => "multipart/form-data; boundary=#{boundary}" }
-      request_with_failover(:multipart_patch, path, body_bytes, headers,
-                            read_timeout_override: read_timeout)
+      request_with_retry(:multipart_patch, path, body_bytes, headers,
+                         read_timeout_override: read_timeout)
     end
 
-    # Stream a remote URL to a local file path, with automatic primary → secondary
-    # host failover.
+    # Stream a remote URL to a local file path, retrying transient failures.
     #
     # This is the unified entry point for all large-file downloads (brand skill
     # ZIPs, platform-hosted assets, etc.). Callers should NOT build their own
-    # Net::HTTP loops — failover, retry, redirects, and timeouts are handled here.
+    # Net::HTTP loops — retry, redirects, and timeouts are handled here.
     #
-    # Host failover policy:
-    #   - If +url+'s host matches PRIMARY_HOST and the request fails with a
-    #     retryable error (timeout, connection reset, SSL, 5xx), the URL is
-    #     rewritten to SECONDARY_HOST (same path/query) and retried.
-    #   - Both hosts serve the same Rails backend and share +secret_key_base+,
-    #     so ActiveStorage signed_ids resolve identically on either.
-    #   - Third-party hosts (e.g. S3 presigned URLs reached via redirect) are
-    #     fetched as-is without host rewriting.
+    # The URL is always fetched as-is: third-party hosts (S3 presigned URLs
+    # reached via redirect, CDNs, user-provided URLs) are never rewritten.
     #
-    # Each host gets ATTEMPTS_PER_HOST attempts with exponential back-off.
+    # The request gets MAX_ATTEMPTS attempts with exponential back-off.
     # Up to DOWNLOAD_MAX_REDIRECTS redirects are followed per attempt.
     #
     # @param url  [String]   Full URL to download
@@ -140,39 +124,23 @@ module Clacky
     # @param read_timeout [Integer] Override read timeout (seconds)
     # @return [Hash] { success: Boolean, bytes: Integer, error: String }
     def download_file(url, dest, read_timeout: DOWNLOAD_READ_TIMEOUT)
-      candidate_urls = [url]
-      # Only auto-add a secondary candidate when the URL is on our primary host.
-      # External hosts (S3, CDNs, user-provided URLs) are fetched as-is.
-      if primary_host_url?(url)
-        candidate_urls << swap_to_secondary_host(url)
-      end
-
       last_error = nil
       FileUtils.mkdir_p(File.dirname(dest))
       tmp_dest = "#{dest}.part"
 
-      candidate_urls.each_with_index do |candidate, host_index|
-        ATTEMPTS_PER_HOST.times do |attempt|
-          begin
-            bytes = stream_download(candidate, tmp_dest, read_timeout: read_timeout)
-            File.rename(tmp_dest, dest)
-            return { success: true, bytes: bytes, error: nil }
-          rescue RetryableNetworkError => e
-            last_error = e
-            backoff    = INITIAL_BACKOFF * (2**attempt)
-            Clacky::Logger.debug(
-              "[PlatformHTTP] DOWNLOAD #{candidate} attempt #{attempt + 1} failed: " \
-              "#{e.message} — retrying in #{backoff}s"
-            )
-            sleep(backoff)
-          end
-        end
-
-        if host_index + 1 < candidate_urls.size
+      MAX_ATTEMPTS.times do |attempt|
+        begin
+          bytes = stream_download(url, tmp_dest, read_timeout: read_timeout)
+          File.rename(tmp_dest, dest)
+          return { success: true, bytes: bytes, error: nil }
+        rescue RetryableNetworkError => e
+          last_error = e
+          backoff    = INITIAL_BACKOFF * (2**attempt)
           Clacky::Logger.debug(
-            "[PlatformHTTP] Primary host exhausted for download, switching to secondary: " \
-            "#{candidate_urls[host_index + 1]}"
+            "[PlatformHTTP] DOWNLOAD #{url} attempt #{attempt + 1} failed: " \
+            "#{e.message} — retrying in #{backoff}s"
           )
+          sleep(backoff)
         end
       end
 
@@ -180,34 +148,9 @@ module Clacky
       { success: false, bytes: 0, error: "Download failed: #{last_error&.message || "unknown"}" }
     end
 
-    # True when +url+ targets the primary platform host.
-    # Used by #download_file to decide whether secondary-host rewriting is safe.
-    private def primary_host_url?(url)
-      return false if url.nil? || url.empty?
-
-      uri = URI.parse(url)
-      primary = URI.parse(PRIMARY_HOST)
-      uri.host == primary.host
-    rescue URI::InvalidURIError
-      false
-    end
-
-    # Rewrite +url+ so its host is the secondary host (same path + query).
-    # Callers must have already confirmed the URL's host is PRIMARY_HOST via
-    # #primary_host_url? — this method does not validate that precondition.
-    private def swap_to_secondary_host(url)
-      uri       = URI.parse(url)
-      secondary = URI.parse(SECONDARY_HOST)
-      uri.scheme = secondary.scheme
-      uri.host   = secondary.host
-      # Only apply an explicit port when secondary declares a non-default one
-      uri.port = secondary.port if secondary.port && secondary.port != secondary.default_port
-      uri.to_s
-    end
-
     # Execute a streaming GET with redirect following, writing the response body
     # to +dest+ as it arrives. Raises RetryableNetworkError on any transient
-    # failure so the caller can decide whether to retry / failover.
+    # failure so the caller can decide whether to retry.
     #
     # @return [Integer] Number of bytes written
     private def stream_download(url, dest, read_timeout:)
@@ -247,7 +190,7 @@ module Clacky
               # 5xx is retryable, 4xx is terminal — but we don't have separate
               # handling in the existing API path and fallback is still useful
               # for e.g. upstream 502/503, so treat everything non-2xx/3xx as
-              # retryable to match the spirit of request_with_failover.
+              # retryable to match the spirit of request_with_retry.
               raise RetryableNetworkError, "HTTP #{resp.code}"
             end
           end
@@ -272,33 +215,25 @@ module Clacky
       raise RetryableNetworkError, e.message
     end
 
-    private def request_with_failover(method, path, payload, extra_headers, read_timeout_override: nil)
+    private def request_with_retry(method, path, payload, extra_headers, read_timeout_override: nil)
       last_error = nil
 
-      @hosts.each_with_index do |base, host_index|
-        ATTEMPTS_PER_HOST.times do |attempt|
-          begin
-            return execute_request(method, base, path, payload, extra_headers,
-                                   read_timeout_override: read_timeout_override)
-          rescue RetryableNetworkError => e
-            last_error = e
-            backoff    = INITIAL_BACKOFF * (2**attempt)
-            Clacky::Logger.debug(
-              "[PlatformHTTP] #{method.upcase} #{base}#{path} attempt #{attempt + 1} failed: " \
-              "#{e.message} — retrying in #{backoff}s"
-            )
-            sleep(backoff)
-          end
-        end
-
-        if host_index + 1 < @hosts.size
+      MAX_ATTEMPTS.times do |attempt|
+        begin
+          return execute_request(method, @base_url, path, payload, extra_headers,
+                                 read_timeout_override: read_timeout_override)
+        rescue RetryableNetworkError => e
+          last_error = e
+          backoff    = INITIAL_BACKOFF * (2**attempt)
           Clacky::Logger.debug(
-            "[PlatformHTTP] Primary host exhausted, switching to fallback: #{@hosts[host_index + 1]}"
+            "[PlatformHTTP] #{method.upcase} #{@base_url}#{path} attempt #{attempt + 1} failed: " \
+            "#{e.message} — retrying in #{backoff}s"
           )
+          sleep(backoff)
         end
       end
 
-      # All hosts / attempts exhausted
+      # All attempts exhausted
       { success: false, error: "Network error: #{last_error&.message || "unknown"}", data: {} }
     end