openclacky 1.3.6 → 1.3.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 45a64960de249e34ee18e67f0ce38888b510a886988d545c58aca558d942bbdb
-  data.tar.gz: '008d7b7bec8fd7edf43cb9848949637d23783d2ad3a8a2b6199010f9b8ed660d'
+  metadata.gz: 589d52edb2af8ec7ebea8d596a4b342791230009666a8757f4391b95df22d667
+  data.tar.gz: 07c80f79e8a9df57b4232a1317b1a6f8b4557cf136289f7ea1b7a9e93caba5aa
 SHA512:
-  metadata.gz: 2f0e9c3fb21691cf9bbfdd6820faaaed86086bebb820278b6104356f92fec4c0e53584a8c3ca40bfd42fb7f82e1f3a484ed404c2b693a47467e9c43d517ed9e8
-  data.tar.gz: 83cb1fa9ac5a3ae4834bf5c02c344da9db09a5863a4970857f2d233656c66d9b20fde131f0af4b04d23e204a09a978968ae7d2310ae1c3c3ceb8bcb6d721e3c2
+  metadata.gz: e474dff0d682c03bbd9756a37e9c64a29d13f51c35b73a76440e62eeac4b92d5ce6251e7357493531ce0669a770607a37a17ceb8715eadf5f849a7b04a6f373a
+  data.tar.gz: 8863d9a310224162b3fc0dad4513c933ebafcc74be5d2157d890d7a4f2dd667f66c9f658e61d289c078fdf39c5961bb5c0895317553c0f25b5054142f2c127b9

data/CHANGELOG.md

@@ -5,6 +5,60 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.3.8] - 2026-07-07
+
+### Added
+- Shell hook `type:rewrite` protocol with `updatedInput` support — hooks can now rewrite the command before execution
+- Support for `AGENTS.md` workspace rules — agent reads project-level rules from AGENTS.md automatically
+- Avatar support in Web UI
+- Open first tab automatically on session start
+
+### Improved
+- New-session page UI humanized with improved layout and discoverability
+- Session bar slot support for extension customization
+- Extension description metadata in ext-studio
+
+### Fixed
+- Mobile new-session page layout uses fixed positioning correctly
+- Weekly stats period now starts from Monday instead of a rolling 7-day window
+- i18n translations updated and UI refreshes immediately on language change
+- Extension market toolbar layout and back button styling
+- Skeleton screen rendering in ext-studio and extension market
+- Trash skeleton screen restored on loading state
+- Media usage logging now passes session_id correctly for image/video generation
+- Billing writes in tests isolated via `CLACKY_BILLING_DIR` env var
+- Meeting panel no longer overrides aside-panel container class
+
+## [1.3.7] - 2026-07-06
+
+### Added
+- Extension ecosystem: install, manage, and publish extensions with Creator Studio
+- Brand extension and brand badge support for extension agents
+- Hook/profile extension type for intercepting and customizing agent behavior
+- Extension upload CLI for publishing extensions from the command line
+- New session page with improved layout and discoverability
+- Session auto-cleanup hint, skeleton loading, and type filter in trash panel
+- Renew button on brand warning bar for expiring subscriptions
+- i18n tooltips for header theme toggle and trash toolbar buttons
+- Refresh button in header to reload sessions
+- xhigh reasoning effort level for supported models
+- i18n file upload error messages
+
+### Improved
+- Merge Creator Center into ext-studio as a unified extension hub
+- Extension developer experience: scaffold template improvements, badge and author metadata support
+- Share modal UI polish — theme dots on hover, close button hover effect, layout refinement
+- Unify Clacky.* JS namespace and single-segment extension architecture
+- Migrate default agents to default extensions with unified panel visibility
+
+### Fixed
+- Ctrl+C now works properly in TUI auto-answer mode
+- Show-system-skills toggle persists correctly and uses theme accent color
+- Cron display handles every-N-hours with weekdays pattern correctly
+- New-session dropdown arrow button responds to both click and keyboard
+- New cron virtual entry inserts at the correct position relative to pinned sessions
+- File upload error messages use i18n consistently
+
 ## [1.3.6] - 2026-06-30
 
 ### Added

data/lib/clacky/agent/hook_manager.rb

@@ -28,7 +28,16 @@ module Clacky
       @hooks[event].each do |hook|
         begin
           hook_result = hook.call(*args)
-          result.merge!(hook_result) if hook_result.is_a?(Hash)
+          next unless hook_result.is_a?(Hash)
+          # First deny wins and stops the chain: a weaker later verdict must
+          # never clobber a stronger earlier one, and the first deny's reason
+          # is the one that reaches the agent. Rewrite hooks mutate `call` in
+          # place (chained rewrite), so for non-deny results there's nothing to
+          # merge — we just keep going.
+          if hook_result[:action] == :deny
+            result = hook_result
+            break
+          end
         rescue StandardError => e
           # Log error but don't fail
           Clacky::Logger.error("Hook error", event: event, error: e)

data/lib/clacky/agent/system_prompt_builder.rb

@@ -8,7 +8,7 @@ module Clacky
     # Builds system prompt by composing layers:
     #   1. Agent-specific system_prompt.md  (role & responsibilities)
     #   2. base_prompt.md                   (universal rules: todo manager, tool usage, etc.)
-    #   3. Project rules                    (.clackyrules / .cursorrules / CLAUDE.md)
+    #   3. Project rules                    (.clackyrules / AGENTS.md / .cursorrules / CLAUDE.md)
     #   4. SOUL.md                          (agent personality — user override or built-in default)
     #   5. USER.md                          (user profile — user override or built-in default)
     #   6. Skills context                   (available skills list)

data/lib/clacky/agent.rb

@@ -51,7 +51,7 @@ module Clacky
     attr_accessor :pinned
     attr_accessor :channel_info
 
-    REASONING_EFFORTS = %w[low medium high].freeze
+    REASONING_EFFORTS = %w[low medium high xhigh].freeze
 
     def permission_mode
       @config&.permission_mode&.to_s || ""
@@ -136,6 +136,8 @@ module Clacky
       # Free-mode counterpart: branded but not activated → fetch unencrypted skills
       # via the public endpoint so users get a working install with no serial number.
       @brand_config.sync_free_skills_async!
+      # Brand extensions bundled into the activated license's distribution.
+      @brand_config.sync_brand_extensions_async!
 
       # Initialize Time Machine
       init_time_machine
@@ -143,8 +145,20 @@ module Clacky
       # Register built-in tools
       register_builtin_tools
 
-      # Load declarative shell hooks from ~/.clacky/hooks.yml
-      ShellHookLoader.load_into(@hooks)
+      # Load declarative shell hooks from ~/.clacky/hooks.yml. Entries with
+      # `type: rewrite` use the rich JSON protocol (updatedInput rewrite);
+      # entries without `type` use the simple exit-code protocol.
+      ShellHookLoader.load_into(
+        @hooks,
+        session_id_fn:      -> { @session_id },
+        cwd_fn:             -> { @working_dir },
+        permission_mode_fn: -> { @config.permission_mode.to_s }
+      )
+
+      # Copy ext.yml-contributed hook callbacks (contributes.hooks) onto this
+      # agent's hook manager. The callbacks were registered process-wide at
+      # boot via ExtensionHookLoader.
+      ExtensionHookRegistry.apply_to(@hooks)
 
       # Ensure user-space parsers are in place (~/.clacky/parsers/)
       Utils::ParserManager.setup!

data/lib/clacky/agent_profile.rb

@@ -6,107 +6,178 @@ module Clacky
   # Loads and represents an agent profile (system prompt + skill whitelist).
   #
   # Lookup order for a profile named "coding":
-  #   1. ~/.clacky/agents/coding/          (user override)
-  #   2. <gem>/lib/clacky/default_agents/coding/  (built-in default)
+  #   1. ~/.clacky/agents/coding/                (user override, physical dir)
+  #   2. extension agent unit with id == "coding" (ext.yml contributes.agents)
   #
-  # Each profile directory must contain:
+  # Each user profile directory (opt-in override) contains:
   #   - profile.yml       — name, description, skills whitelist
   #   - system_prompt.md  — agent-specific system prompt content
   #
-  # Global files (shared across all agents), also with user-override support:
-  #   - SOUL.md   — agent personality/values
-  #   - USER.md   — user profile information
-  #   - base_prompt.md — universal behavioral rules (todo manager, tool usage, etc.)
+  # Global files (shared across all agents) are user-only overrides:
+  #   - ~/.clacky/agents/SOUL.md   — agent personality/values (else DEFAULT_SOUL)
+  #   - ~/.clacky/agents/USER.md   — user profile info        (else DEFAULT_USER)
+  # The universal behavioural rules (todo manager, tool usage, response style,
+  # etc.) live in a bundled resource file at lib/clacky/prompts/base.md.
   class AgentProfile
-    DEFAULT_AGENTS_DIR = File.expand_path("../default_agents", __FILE__).freeze
     USER_AGENTS_DIR = File.expand_path("~/.clacky/agents").freeze
+    BASE_PROMPT_PATH = File.expand_path("../prompts/base.md", __FILE__).freeze
+
+    DEFAULT_SOUL = <<~MD.freeze
+      You are calm, precise, and helpful. You communicate clearly and concisely.
+      You are honest about uncertainty and ask for clarification when needed.
+      You take initiative but respect the user's preferences and decisions.
+    MD
+
+    DEFAULT_USER = "(No user profile configured yet. To personalize, create ~/.clacky/agents/USER.md)"
 
     attr_reader :name, :description
 
     def initialize(name)
       @name = name.to_s
+      result = ExtensionLoader.last_result
+      @ext_unit = result&.agents&.find { |u| u.id == @name }
+      if @ext_unit.nil?
+        result = ExtensionLoader.load_all(force: true)
+        @ext_unit = result&.agents&.find { |u| u.id == @name }
+      end
       profile_data = load_profile_yml
       @description = profile_data["description"] || ""
       @system_prompt_content = load_agent_file("system_prompt.md")
     end
 
-    # Load a named profile. Raises ArgumentError if profile directory not found.
     # @param name [String, Symbol] profile name (e.g. "coding", "general")
     # @return [AgentProfile]
     def self.load(name)
       new(name)
     end
 
+    # List all available agent profiles across user + extension layers.
+    # Precedence on id collision: user override → extension unit.
+    # @return [Array<Hash>] each: { id:, title:, title_zh:, description:, description_zh:, source:, order:, layer:, author:, avatar: }
+    def self.all
+      out = {}
+
+      add = lambda do |id, title, title_zh, description, description_zh, source, order, layer, author, avatar|
+        next if id.nil? || id.empty?
+        out[id] = {
+          id: id,
+          title: title,
+          title_zh: title_zh,
+          description: description,
+          description_zh: description_zh,
+          source: source,
+          order: order,
+          layer: layer,
+          author: author,
+          avatar: avatar,
+        }
+      end
+
+      ext_result = ExtensionLoader.last_result || ExtensionLoader.load_all
+      ext_result&.agents&.each do |unit|
+        spec = unit.spec || {}
+        title = spec["title"].to_s
+        title = unit.id if title.empty?
+        avatar = spec["avatar_abs"].to_s.empty? ? nil : "/agent_avatar/#{unit.id}"
+        add.call(
+          unit.id, title, spec["title_zh"].to_s,
+          spec["description"].to_s, spec["description_zh"].to_s,
+          "extension", spec["order"], unit.layer.to_s,
+          spec["author"].to_s, avatar
+        )
+      end
+
+      Dir.glob(File.join(USER_AGENTS_DIR, "*")).sort.each do |path|
+        next unless File.directory?(path)
+        id = File.basename(path)
+        next if id.start_with?("_")
+        next unless File.file?(File.join(path, "profile.yml"))
+        meta = read_profile_yml(File.join(path, "profile.yml"))
+        user_avatar = File.file?(File.join(path, "avatar.png")) ? "/agent_avatar/#{id}" : nil
+        add.call(
+          id, meta["title"] || meta["name"] || id, meta["title_zh"].to_s,
+          meta["description"].to_s, meta["description_zh"].to_s,
+          "user", meta["order"], "user",
+          meta["author"].to_s.empty? ? "You" : meta["author"].to_s, user_avatar
+        )
+      end
+
+      source_rank = { "user" => 0, "extension" => 1 }
+      out.values.sort_by { |a| [source_rank[a[:source]] || 9, a[:order] || 999, a[:id]] }
+    end
+
+    private_class_method def self.read_profile_yml(path)
+      return {} unless File.file?(path)
+      YAML.safe_load(File.read(path)) || {}
+    rescue StandardError
+      {}
+    end
+
     # @return [String] agent-specific system prompt content
     def system_prompt
       @system_prompt_content
     end
 
-    # @return [String] base prompt shared by all agents
+    # @return [String] base prompt shared by all agents (bundled resource)
     def base_prompt
-      load_global_file("base_prompt.md")
+      return "" unless File.file?(BASE_PROMPT_PATH)
+      File.read(BASE_PROMPT_PATH).strip
     end
 
-    # @return [String] soul content (user override → built-in default)
+    # @return [String] soul content (user override, else default)
     def soul
-      load_global_file("SOUL.md")
+      user_path = File.join(USER_AGENTS_DIR, "SOUL.md")
+      if File.exist?(user_path) && !File.zero?(user_path)
+        File.read(user_path).strip
+      else
+        DEFAULT_SOUL.strip
+      end
     end
 
-    # @return [String] user profile content (user override → built-in default)
+    # @return [String] user profile content (user override, else default)
     def user_profile
-      load_global_file("USER.md")
+      user_path = File.join(USER_AGENTS_DIR, "USER.md")
+      if File.exist?(user_path) && !File.zero?(user_path)
+        File.read(user_path).strip
+      else
+        DEFAULT_USER
+      end
     end
 
     private def load_profile_yml
-      path = find_agent_file("profile.yml")
-      raise ArgumentError, "Agent profile '#{@name}' not found. " \
-        "Looked in #{user_agent_dir} and #{default_agent_dir}" unless path
-
-      YAML.safe_load(File.read(path)) || {}
-    end
-
-    # Load a file from the agent-specific directory (user override → built-in)
-    private def load_agent_file(filename)
-      path = find_agent_file(filename)
-      return "" unless path
-
-      File.read(path).strip
-    end
-
-    # Load a global file shared across all agents (user override → built-in)
-    private def load_global_file(filename)
-      user_path = File.join(USER_AGENTS_DIR, filename)
-      default_path = File.join(DEFAULT_AGENTS_DIR, filename)
-
-      path = if File.exist?(user_path) && !File.zero?(user_path)
-               user_path
-             elsif File.exist?(default_path)
-               default_path
-             end
+      user_yml = File.join(user_agent_dir, "profile.yml")
+      if File.file?(user_yml)
+        return YAML.safe_load(File.read(user_yml)) || {}
+      end
 
-      return "" unless path
+      if @ext_unit
+        return {
+          "name"        => @name,
+          "description" => @ext_unit.spec["description"],
+          "panels"      => @ext_unit.spec["panels"],
+          "skills"      => @ext_unit.spec["skills"],
+        }
+      end
 
-      File.read(path).strip
+      raise ArgumentError, "Agent profile '#{@name}' not found. " \
+        "Looked in #{user_agent_dir} and extension registry."
     end
 
-    # Find a file in user override dir first, then built-in default dir
-    private def find_agent_file(filename)
+    # Agent-specific file lookup: user override → extension prompt (system_prompt.md only).
+    private def load_agent_file(filename)
       user_path = File.join(user_agent_dir, filename)
-      default_path = File.join(default_agent_dir, filename)
+      return File.read(user_path).strip if File.exist?(user_path) && !File.zero?(user_path)
 
-      if File.exist?(user_path) && !File.zero?(user_path)
-        user_path
-      elsif File.exist?(default_path)
-        default_path
+      if @ext_unit && filename == "system_prompt.md"
+        prompt_abs = @ext_unit.spec["prompt_abs"]
+        return File.read(prompt_abs).strip if prompt_abs && File.file?(prompt_abs)
       end
+
+      ""
     end
 
     private def user_agent_dir
       File.join(USER_AGENTS_DIR, @name)
     end
-
-    private def default_agent_dir
-      File.join(DEFAULT_AGENTS_DIR, @name)
-    end
   end
 end

data/lib/clacky/billing/billing_store.rb

@@ -13,7 +13,7 @@ module Clacky
       BILLING_DIR = File.join(Dir.home, ".clacky", "billing")
 
       def initialize(billing_dir: nil)
-        @billing_dir = billing_dir || BILLING_DIR
+        @billing_dir = billing_dir || ENV["CLACKY_BILLING_DIR"] || BILLING_DIR
         ensure_billing_dir
       end
 
@@ -339,7 +339,8 @@ module Clacky
         when :day
           Time.new(now.year, now.month, now.day)
         when :week
-          now - (7 * 24 * 60 * 60)
+          days_since_monday = now.wday == 0 ? 6 : now.wday - 1
+          Time.new(now.year, now.month, now.day) - (days_since_monday * 24 * 60 * 60)
         when :month
           Time.new(now.year, now.month, 1)
         when :year