openclacky 1.0.0 → 1.0.2

metadata

@@ -1,13 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: openclacky
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.2
 platform: ruby
 authors:
 - windy
+autorequire:
 bindir: bin
 cert_chain: []
-date: 1980-01-02 00:00:00.000000000 Z
+date: 2026-05-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: faraday
@@ -252,8 +253,8 @@ email:
 - yafei@dao42.com
 executables:
 - clacky
-- clarky
 - openclacky
+- clarky
 extensions: []
 extra_rdoc_files: []
 files:
@@ -318,11 +319,8 @@ files:
 - lib/clacky/banner.rb
 - lib/clacky/block_font.rb
 - lib/clacky/brand_config.rb
-- lib/clacky/clacky_auth_client.rb
-- lib/clacky/clacky_cloud_config.rb
 - lib/clacky/cli.rb
 - lib/clacky/client.rb
-- lib/clacky/cloud_project_client.rb
 - lib/clacky/default_agents/SOUL.md
 - lib/clacky/default_agents/USER.md
 - lib/clacky/default_agents/base_prompt.md
@@ -333,6 +331,8 @@ files:
 - lib/clacky/default_parsers/doc_parser.rb
 - lib/clacky/default_parsers/docx_parser.rb
 - lib/clacky/default_parsers/pdf_parser.rb
+- lib/clacky/default_parsers/pdf_parser_ocr.py
+- lib/clacky/default_parsers/pdf_parser_plumber.py
 - lib/clacky/default_parsers/pptx_parser.rb
 - lib/clacky/default_parsers/xlsx_parser.rb
 - lib/clacky/default_skills/browser-setup/SKILL.md
@@ -343,18 +343,11 @@ files:
 - lib/clacky/default_skills/cron-task-creator/SKILL.md
 - lib/clacky/default_skills/cron-task-creator/evals/evals.json
 - lib/clacky/default_skills/deploy/SKILL.md
-- lib/clacky/default_skills/deploy/scripts/rails_deploy.rb
-- lib/clacky/default_skills/deploy/tools/check_health.rb
-- lib/clacky/default_skills/deploy/tools/create_database_service.rb
-- lib/clacky/default_skills/deploy/tools/execute_deployment.rb
-- lib/clacky/default_skills/deploy/tools/fetch_runtime_logs.rb
-- lib/clacky/default_skills/deploy/tools/list_services.rb
-- lib/clacky/default_skills/deploy/tools/report_deploy_status.rb
-- lib/clacky/default_skills/deploy/tools/set_deploy_variables.rb
 - lib/clacky/default_skills/new/SKILL.md
-- lib/clacky/default_skills/new/scripts/cloud_project_init.sh
 - lib/clacky/default_skills/new/scripts/create_rails_project.sh
 - lib/clacky/default_skills/onboard/SKILL.md
+- lib/clacky/default_skills/onboard/scripts/import_external_skills.rb
+- lib/clacky/default_skills/onboard/scripts/install_builtin_skills.rb
 - lib/clacky/default_skills/personal-website/SKILL.md
 - lib/clacky/default_skills/personal-website/publish.rb
 - lib/clacky/default_skills/product-help/SKILL.md
@@ -377,7 +370,6 @@ files:
 - lib/clacky/default_skills/skill-creator/scripts/run_loop.py
 - lib/clacky/default_skills/skill-creator/scripts/utils.py
 - lib/clacky/default_skills/skill-creator/scripts/validate_skill_frontmatter.rb
-- lib/clacky/deploy_api_client.rb
 - lib/clacky/idle_compression_timer.rb
 - lib/clacky/json_ui_controller.rb
 - lib/clacky/message_format/anthropic.rb
@@ -426,6 +418,7 @@ files:
 - lib/clacky/tools/terminal.rb
 - lib/clacky/tools/terminal/output_cleaner.rb
 - lib/clacky/tools/terminal/persistent_session.rb
+- lib/clacky/tools/terminal/safe_rm.sh
 - lib/clacky/tools/terminal/session_manager.rb
 - lib/clacky/tools/todo_manager.rb
 - lib/clacky/tools/trash_manager.rb
@@ -491,13 +484,17 @@ files:
 - lib/clacky/web/index.html
 - lib/clacky/web/marked.min.js
 - lib/clacky/web/onboard.js
+- lib/clacky/web/profile.js
 - lib/clacky/web/sessions.js
 - lib/clacky/web/settings.js
+- lib/clacky/web/sidebar.js
 - lib/clacky/web/skills.js
 - lib/clacky/web/tasks.js
 - lib/clacky/web/theme.js
+- lib/clacky/web/trash.js
 - lib/clacky/web/version.js
 - lib/clacky/web/weixin-qr.html
+- lib/clacky/web/ws-dispatcher.js
 - lib/clacky/web/ws.js
 - scripts/build/build.sh
 - scripts/build/lib/apt.sh
@@ -529,6 +526,7 @@ metadata:
   homepage_uri: https://github.com/yafeilee/clacky
   source_code_uri: https://github.com/yafeilee/clacky
   changelog_uri: https://github.com/yafeilee/clacky/blob/main/CHANGELOG.md
+post_install_message:
 rdoc_options: []
 require_paths:
 - lib
@@ -543,7 +541,8 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 4.0.4
+rubygems_version: 3.5.22
+signing_key:
 specification_version: 4
 summary: A command-line interface for AI models (Claude, OpenAI, etc.)
 test_files: []

data/lib/clacky/clacky_auth_client.rb

@@ -1,152 +0,0 @@
-# frozen_string_literal: true
-
-require "faraday"
-require "json"
-
-module Clacky
-  # ClackyAuthClient - Fetches LLM keys from a Clacky workspace via API
-  #
-  # Usage:
-  #   client = ClackyAuthClient.new("clacky_ak_xxx", base_url: "https://api.example.com")
-  #   result = client.fetch_workspace_keys
-  #   # => { success: true, llm_key: "ABSK...", model_name: "jp.anthropic.claude-sonnet-4-6",
-  #   #      base_url: "https://...", anthropic_format: false }
-  class ClackyAuthClient
-    WORKSPACE_KEYS_PATH = "/openclacky/v1/workspace/keys"
-    REQUEST_TIMEOUT     = 15   # seconds
-    OPEN_TIMEOUT        = 5    # seconds
-
-    # Default model to use when the workspace/keys response does not specify one
-    DEFAULT_MODEL = "jp.anthropic.claude-sonnet-4-6"
-
-    def initialize(workspace_api_key, base_url:)
-      @workspace_api_key = workspace_api_key.to_s.strip
-      @base_url          = base_url.to_s.strip.sub(%r{/+$}, "")
-    end
-
-    # Fetch workspace keys from the Clacky backend.
-    #
-    # @return [Hash]
-    #   On success:
-    #     { success: true,
-    #       llm_key: "...",          # raw LLM key string returned by the API (ABSK prefix = Bedrock)
-    #       model_name: "...",       # model to configure (provider default or our default)
-    #       base_url: "...",         # LLM proxy base URL (clean host, no path suffix)
-    #       anthropic_format: false  # ABSK keys use Bedrock Converse format, not Anthropic wire format
-    #     }
-    #   On failure:
-    #     { success: false, error: "..." }
-    def fetch_workspace_keys
-      validate_inputs!
-
-      response = connection.get(WORKSPACE_KEYS_PATH)
-
-      unless response.status == 200
-        error_msg = extract_error(response)
-        return { success: false, error: "HTTP #{response.status}: #{error_msg}" }
-      end
-
-      body = JSON.parse(response.body)
-
-      unless body["code"].to_i == 200
-        return { success: false, error: "API error: #{body["msg"] || body["message"]}" }
-      end
-
-      llm_key_data = body.dig("data", "llm_key")
-      if llm_key_data.nil?
-        return { success: false, error: "No LLM key available for this workspace" }
-      end
-
-      # Extract key value – the API returns a hash with fields:
-      #   raw_key  – plaintext secret (primary field since 2026-03-30)
-      #   key      – alias used by some gateway endpoints
-      #   key_id   – legacy identifier (kept for forward-compat)
-      # Priority: raw_key > key > key_id > value
-      # We also accept a plain string form for forward-compat.
-      llm_key = case llm_key_data
-                when String then llm_key_data
-                when Hash
-                  llm_key_data["raw_key"] || llm_key_data["key"] ||
-                    llm_key_data["key_id"] || llm_key_data["value"]
-                end
-
-      if llm_key.nil? || llm_key.to_s.strip.empty?
-        return { success: false, error: "LLM key value is empty or missing in response" }
-      end
-
-      # base_url comes from the `host` field in the API response (set per environment by backend config).
-      # Fallback to @base_url (the backend URL the user entered).
-      # No path suffix is appended — the LLM key has ABSK prefix (Bedrock), so client.rb will
-      # automatically build the correct endpoint: /model/{model}/converse
-      host = llm_key_data.is_a?(Hash) ? llm_key_data["host"].to_s.strip : ""
-      llm_base_url = if host.start_with?("http://", "https://")
-                       host
-                     else
-                       @base_url
-                     end
-
-      {
-        success:          true,
-        llm_key:          llm_key.to_s.strip,
-        model_name:       DEFAULT_MODEL,
-        base_url:         llm_base_url,
-        anthropic_format: false
-      }
-    rescue Faraday::ConnectionFailed => e
-      { success: false, error: "Connection failed: #{e.message}" }
-    rescue Faraday::TimeoutError
-      { success: false, error: "Request timed out (#{REQUEST_TIMEOUT}s)" }
-    rescue Faraday::Error => e
-      { success: false, error: "Network error: #{e.message}" }
-    rescue JSON::ParserError => e
-      { success: false, error: "Invalid JSON response: #{e.message}" }
-    rescue ArgumentError => e
-      { success: false, error: e.message }
-    rescue => e
-      { success: false, error: "Unexpected error: #{e.message}" }
-    end
-
-    # Validate that inputs look reasonable before making a network request.
-    private def validate_inputs!
-      if @workspace_api_key.empty?
-        raise ArgumentError, "Workspace API key is required"
-      end
-
-      unless @workspace_api_key.start_with?("clacky_ak_")
-        raise ArgumentError, "Invalid key format (expected prefix: clacky_ak_)"
-      end
-
-      if @base_url.empty?
-        raise ArgumentError, "Base URL is required"
-      end
-
-      unless @base_url.start_with?("http://", "https://")
-        raise ArgumentError, "Base URL must start with http:// or https://"
-      end
-    end
-
-    # Build a Faraday connection pointing at the Clacky backend.
-    private def connection
-      @connection ||= Faraday.new(url: @base_url) do |conn|
-        conn.headers["Content-Type"]  = "application/json"
-        conn.headers["Authorization"] = "Bearer #{@workspace_api_key}"
-        conn.options.timeout          = REQUEST_TIMEOUT
-        conn.options.open_timeout     = OPEN_TIMEOUT
-        conn.ssl.verify               = false
-        conn.adapter Faraday.default_adapter
-      end
-    end
-
-    # Extract a human-readable error from a failed response.
-    private def extract_error(response)
-      body = JSON.parse(response.body) rescue nil
-      return response.body.to_s[0..200] unless body.is_a?(Hash)
-
-      body["msg"] ||
-        body["message"] ||
-        body.dig("error", "message") ||
-        body["error"].to_s[0..200] ||
-        response.body.to_s[0..200]
-    end
-  end
-end

data/lib/clacky/clacky_cloud_config.rb

@@ -1,123 +0,0 @@
-# frozen_string_literal: true
-
-require "yaml"
-require "fileutils"
-
-module Clacky
-  # ClackyCloudConfig — stores the Clacky Cloud credentials used for workspace-key
-  # import (workspace_api_key + backend base_url) in a dedicated file so the user
-  # never has to re-enter them.
-  #
-  # File location: ~/.clacky/clacky_cloud.yml
-  # File format (YAML):
-  #   workspace_key: clacky_ak_xxxx
-  #   base_url: https://api.clacky.ai
-  #   dashboard_url: https://app.clacky.ai   # optional, inferred from base_url if absent
-  #
-  # Usage:
-  #   cfg = ClackyCloudConfig.load
-  #   cfg.workspace_key   # => "clacky_ak_xxxx" or nil
-  #   cfg.base_url        # => "https://api.clacky.ai"
-  #   cfg.dashboard_url   # => "https://app.clacky.ai"  (explicit or inferred)
-  #   cfg.configured?     # => true / false
-  #
-  #   cfg.workspace_key = "clacky_ak_newkey"
-  #   cfg.save
-  class ClackyCloudConfig
-    CONFIG_DIR  = File.join(Dir.home, ".clacky")
-    CONFIG_FILE = File.join(CONFIG_DIR, "clacky_cloud.yml")
-
-    DEFAULT_BASE_URL      = "https://api.clacky.ai"
-    DEFAULT_DASHBOARD_URL = "https://app.clacky.ai"
-
-    attr_accessor :workspace_key, :base_url, :dashboard_url
-
-    def initialize(workspace_key: nil, base_url: DEFAULT_BASE_URL, dashboard_url: nil)
-      @workspace_key = workspace_key.to_s.strip
-      @workspace_key = nil if @workspace_key.empty?
-      @base_url      = (base_url.to_s.strip.empty? ? DEFAULT_BASE_URL : base_url.to_s.strip)
-                         .sub(%r{/+$}, "")  # strip trailing slash
-
-      # dashboard_url: use explicit value if provided, otherwise infer from base_url
-      explicit = dashboard_url.to_s.strip.sub(%r{/+$}, "")
-      @dashboard_url = explicit.empty? ? infer_dashboard_url(@base_url) : explicit
-    end
-
-    # Load from ~/.clacky/clacky_cloud.yml (returns an empty config if the file is absent)
-    def self.load(config_file = CONFIG_FILE)
-      if File.exist?(config_file)
-        data = YAML.safe_load(File.read(config_file)) || {}
-        new(
-          workspace_key: data["workspace_key"],
-          base_url:      data["base_url"]      || DEFAULT_BASE_URL,
-          dashboard_url: data["dashboard_url"]
-        )
-      else
-        new
-      end
-    rescue => e
-      # Corrupt file — return empty config rather than crash
-      warn "[clacky_cloud_config] Failed to load #{config_file}: #{e.message}"
-      new
-    end
-
-    # Persist to ~/.clacky/clacky_cloud.yml
-    def save(config_file = CONFIG_FILE)
-      FileUtils.mkdir_p(File.dirname(config_file))
-      File.write(config_file, to_yaml)
-      FileUtils.chmod(0o600, config_file)
-      self
-    end
-
-    # Serialize to YAML string
-    def to_yaml
-      data = { "base_url" => @base_url }
-      data["workspace_key"]  = @workspace_key  if @workspace_key
-      # Only persist dashboard_url when it differs from the inferred default,
-      # so the file stays minimal for users who don't need to override it.
-      inferred = infer_dashboard_url(@base_url)
-      data["dashboard_url"]  = @dashboard_url  if @dashboard_url != inferred
-      YAML.dump(data)
-    end
-
-    # True when a non-empty workspace_key is stored
-    def configured?
-      !@workspace_key.nil? && !@workspace_key.empty?
-    end
-
-    # Remove the saved file (used for reset / tests)
-    def self.clear!(config_file = CONFIG_FILE)
-      FileUtils.rm_f(config_file)
-    end
-
-    # Derive the dashboard web-app URL from the API base_url.
-    #
-    # Mapping rules:
-    #   https://api.clacky.ai               -> https://app.clacky.ai
-    #   https://<env>.api.clackyai.com      -> https://<env>.app.clackyai.com
-    #   http://localhost:<port>             -> http://localhost:3001
-    #   (anything else)                     -> https://app.clacky.ai  (safe default)
-    private def infer_dashboard_url(api_url)
-      return DEFAULT_DASHBOARD_URL if api_url.nil? || api_url.strip.empty?
-
-      # Production: api.clacky.ai -> app.clacky.ai
-      return "https://app.clacky.ai" if api_url == "https://api.clacky.ai"
-
-      # Staging/dev on clackyai.com: <env>.api.clackyai.com -> <env>.app.clackyai.com
-      if api_url =~ %r{\Ahttps?://(.+)\.api\.clackyai\.com\z}
-        env_prefix = Regexp.last_match(1)
-        scheme     = api_url.start_with?("https") ? "https" : "http"
-        return "#{scheme}://#{env_prefix}.app.clackyai.com"
-      end
-
-      # Local development: localhost:<port> -> localhost:3001
-      if api_url =~ %r{\Ahttps?://localhost(:\d+)?\z}
-        scheme = api_url.start_with?("https") ? "https" : "http"
-        return "#{scheme}://localhost:3001"
-      end
-
-      # Fallback: return production dashboard
-      DEFAULT_DASHBOARD_URL
-    end
-  end
-end

data/lib/clacky/cloud_project_client.rb

@@ -1,169 +0,0 @@
-# frozen_string_literal: true
-
-require "faraday"
-require "json"
-
-module Clacky
-  # CloudProjectClient - Manages cloud project lifecycle via the OpenClacky API
-  #
-  # Handles creating projects, fetching project details (including subscription
-  # status and categorized_config), and listing projects in a workspace.
-  #
-  # All API calls use the Workspace API Key (clacky_ak_*) from ClackyCloudConfig.
-  #
-  # Usage:
-  #   client = CloudProjectClient.new("clacky_ak_xxx", base_url: "https://api.clacky.ai")
-  #
-  #   # Create a new cloud project
-  #   result = client.create_project(name: "my-app")
-  #   # => { success: true, project: { "id" => "...", "name" => "...", "workspace_id" => "...",
-  #   #        "categorized_config" => { "auth" => {...}, "email" => {...}, ... } } }
-  #
-  #   # Get project details (subscription + categorized_config)
-  #   result = client.get_project("019d41be-...")
-  #   # => { success: true, project: { "id" => "...", "subscription" => { "status" => "PAID" }, ... } }
-  #
-  #   # List all projects in workspace
-  #   result = client.list_projects
-  #   # => { success: true, projects: [ { "id" => "...", "name" => "..." }, ... ] }
-  #
-  # On failure, all methods return: { success: false, error: "..." }
-  class CloudProjectClient
-    PROJECTS_PATH       = "/openclacky/v1/projects"
-    REQUEST_TIMEOUT     = 15  # seconds
-    OPEN_TIMEOUT        = 5   # seconds
-
-    def initialize(workspace_api_key, base_url:)
-      @workspace_api_key = workspace_api_key.to_s.strip
-      @base_url          = base_url.to_s.strip.sub(%r{/+$}, "")
-    end
-
-    # Create a new cloud project with the given name.
-    #
-    # @param name [String] Project name (typically the local directory name)
-    # @return [Hash] { success: true, project: {...} } or { success: false, error: "..." }
-    def create_project(name:)
-      validate_inputs!
-
-      response = connection.post(PROJECTS_PATH) do |req|
-        req.headers["Content-Type"] = "application/json"
-        req.body = JSON.generate({ name: name.to_s.strip })
-      end
-
-      unless response.status == 200
-        error_msg = extract_error(response)
-        return { success: false, error: "HTTP #{response.status}: #{error_msg}" }
-      end
-
-      body = parse_body(response)
-      return body_error(body) unless success_code?(body)
-
-      { success: true, project: body["data"] }
-    rescue Faraday::Error => e
-      { success: false, error: "Network error: #{e.message}" }
-    rescue => e
-      { success: false, error: "Unexpected error: #{e.message}" }
-    end
-
-    # Get project details including subscription status and categorized_config.
-    #
-    # @param project_id [String] The cloud project UUID
-    # @return [Hash] { success: true, project: {...} } or { success: false, error: "..." }
-    def get_project(project_id)
-      validate_inputs!
-
-      response = connection.get("#{PROJECTS_PATH}/#{project_id}")
-
-      unless response.status == 200
-        error_msg = extract_error(response)
-        return { success: false, error: "HTTP #{response.status}: #{error_msg}" }
-      end
-
-      body = parse_body(response)
-      return body_error(body) unless success_code?(body)
-
-      { success: true, project: body["data"] }
-    rescue Faraday::Error => e
-      { success: false, error: "Network error: #{e.message}" }
-    rescue => e
-      { success: false, error: "Unexpected error: #{e.message}" }
-    end
-
-    # List all projects in the current workspace.
-    #
-    # @return [Hash] { success: true, projects: [...] } or { success: false, error: "..." }
-    def list_projects
-      validate_inputs!
-
-      response = connection.get(PROJECTS_PATH)
-
-      unless response.status == 200
-        error_msg = extract_error(response)
-        return { success: false, error: "HTTP #{response.status}: #{error_msg}" }
-      end
-
-      body = parse_body(response)
-      return body_error(body) unless success_code?(body)
-
-      projects = body["data"] || []
-      projects = projects["list"] if projects.is_a?(Hash) && projects["list"]
-
-      { success: true, projects: Array(projects) }
-    rescue Faraday::Error => e
-      { success: false, error: "Network error: #{e.message}" }
-    rescue => e
-      { success: false, error: "Unexpected error: #{e.message}" }
-    end
-
-    private def validate_inputs!
-      raise ArgumentError, "workspace_api_key is required" if @workspace_api_key.empty?
-      raise ArgumentError, "base_url is required"          if @base_url.empty?
-    end
-
-    private def connection
-      @connection ||= Faraday.new(url: @base_url) do |f|
-        f.options.timeout      = REQUEST_TIMEOUT
-        f.options.open_timeout = OPEN_TIMEOUT
-        f.headers["Authorization"] = "Bearer #{@workspace_api_key}"
-        f.headers["Accept"]        = "application/json"
-        # Disable SSL verification to avoid OpenSSL certificate path issues
-        # on some macOS environments with system Ruby
-        f.ssl.verify = false
-        f.adapter Faraday.default_adapter
-      end
-    end
-
-    # Parse JSON response body.
-    # Returns the parsed Hash on success, or nil if the body is not valid JSON.
-    private def parse_body(response)
-      JSON.parse(response.body)
-    rescue JSON::ParserError
-      nil
-    end
-
-    # The API returns code 0 or 200 to signal success.
-    # Returns false if body is nil (unparseable JSON).
-    private def success_code?(body)
-      return false if body.nil?
-
-      code = body["code"].to_i
-      code == 0 || code == 200
-    end
-
-    # Build a failure hash from a parsed response body (may be nil for non-JSON)
-    private def body_error(body)
-      return { success: false, error: "Invalid JSON response from API" } if body.nil?
-
-      msg = body["message"] || body["msg"] || "Unknown API error (code: #{body["code"]})"
-      { success: false, error: msg }
-    end
-
-    # Extract a human-readable error string from a raw Faraday response
-    private def extract_error(response)
-      parsed = JSON.parse(response.body)
-      parsed["message"] || parsed["msg"] || response.body.to_s[0, 200]
-    rescue
-      response.body.to_s[0, 200]
-    end
-  end
-end