openclacky 0.7.6 → 0.7.8

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 001070cf8c2d2587620da0669c4cc014bff55930033beafd038ae86ae7374276
-  data.tar.gz: 6c08cf048ab754c8e3be4841496b19b14cf081bdc62cadb313070226cb4e8679
+  metadata.gz: 9b2a72212b8b9e8072acb09a055df1afdd8225ee81de41f11dce460a68ff1781
+  data.tar.gz: e8048bb38dc4a8ae8c85937165e10a855f8642d6759c8a2a94aa336b084e4188
 SHA512:
-  metadata.gz: 1bd44e7efcb16f9d9a15bb49c8d253183697107dcbb25f9ad8edc624d1a357d67c7f54f974cc06ae2140f66c0dec4bd2c2d8b50fae93ad3a8cf2453a0ee5f808
-  data.tar.gz: 4328e4ff99db8731e5ed0a1c298c281261da097d214b600e8d6d1b544073055cc35145d76f53853ea30f6f4827f831cd3444129559ff66e10b4d5a23b30e71e0
+  metadata.gz: '095710e060b7c29882eb128be1a4008281435c13af07e7da01ec9ad1af27c30e252eb19e77f557882628409058d504f29024ea0dbb396ed20d326b26cfe1925c'
+  data.tar.gz: 2875ac5911322341be5fe396ad44a98e4cbcea51c95ed7d832e3978d5790542ca94ae0f065f6170484d9900be2f1ca190f6db0d25c14a33366f924f9d13a147d

data/.clacky/skills/commit/SKILL.md

@@ -1,7 +1,7 @@
 ---
+---
 name: commit
 description: Smart Git commit helper that analyzes changes and creates semantic commits
-disable-model-invocation: false
 user-invocable: true
 ---
 
@@ -472,4 +472,4 @@ This skill works best:
 
 - Created: 2025-02-01
 - Purpose: Improve commit quality and development workflow
-- Compatible with: Any git repository
+- Compatible with: Any git repository

data/.clackyrules

@@ -49,7 +49,11 @@ It provides chat functionality and autonomous AI agent capabilities with tool us
 - **IMPORTANT**: When testing clacky commands or debugging, always use `bundle exec ruby bin/clacky` instead of the global `clacky` command. The global command loads the system-installed gem version (e.g., `openclacky-0.7.0`), not your local development code
 
 ### Tool Development
-When adding new tools:
+**IMPORTANT**: Do NOT add new Ruby Tool classes without careful consideration. Tools are low-level primitives (file I/O, shell, web search, etc.). Before creating a new Tool, always ask: can this capability be achieved with an existing Tool + a Skill (SKILL.md) instead? If yes, use a Skill.
+
+Only add a new Tool when it requires capabilities that no existing tool can provide (e.g., a new API integration, a new system-level operation).
+
+When a new Tool is truly necessary:
 1. Create class in `lib/clacky/tools/`
 2. Inherit from `Clacky::Tools::Base`
 3. Define required class attributes
@@ -57,6 +61,14 @@ When adding new tools:
 5. Add optional `format_call` and `format_result` methods
 6. Require in `lib/clacky.rb`
 
+### Skill Development
+Skills are the preferred way to add new high-level capabilities. A skill is a Markdown instruction file (SKILL.md) that guides the Agent to accomplish a goal using existing Tools.
+
+- Built-in default skills live in `lib/clacky/default_skills/<skill-name>/SKILL.md` (shipped with the gem)
+- Project-level skills live in `.clacky/skills/<skill-name>/SKILL.md`
+- User-level skills live in `~/.clacky/skills/<skill-name>/SKILL.md`
+- **Prefer Skills over new Tools** whenever the task can be composed from existing primitives (write, shell, read, etc.)
+
 ### Agent Behavior
 - TODO manager is for planning only - must execute tasks after planning
 - Always use tools to create/modify files, don't just return code

data/CHANGELOG.md

@@ -7,6 +7,54 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.7.8] - 2026-03-06
+
+### Added
+- Skills panel in web UI: list all skills, enable/disable with toggle, view skill details
+- Hash-based routing (`#session/:id`, `#tasks`, `#skills`, `#settings`) with deep-link and refresh support
+- REST API endpoints for skills management (`GET /api/skills`, `PATCH /api/skills/:name/toggle`)
+- `disabled?` helper on `Skill` model for quick enabled/disabled state checks
+
+### Improved
+- Centralized `Router` object in web UI — single source of truth for all panel switching and sidebar highlight state
+- Web UI frontend split further: `skills.js` extracted as standalone module
+- Ctrl-C in web server now exits immediately via `StartCallback` trap override
+- Skill enable/disable now writes `disable-model-invocation: false` (retains field) instead of deleting it
+
+### Fixed
+- Sidebar highlight for Tasks and Skills stuck active after navigating away
+- Router correctly restores last view on page refresh via hash URL
+
+### Changed
+- Removed `plan_only` permission mode from agent, CLI, and web UI
+
+## [0.7.7] - 2026-03-04
+
+### Added
+- Web UI server with WebSocket support for real-time agent interaction in the browser (`clacky serve`)
+- Task scheduler with cron-based automation, REST API, and scheduled task execution
+- Settings panel in web UI for viewing and editing AI model configurations (API keys, base URL, provider presets)
+- Image upload support in web UI with attach button for multimodal prompts
+- Create Task button in the task list panel for quick task creation from the web UI
+- `create-task` default skill for guided automated task creation
+
+### Improved
+- Web UI frontend split into modular files (`ws.js`, `sessions.js`, `tasks.js`, `settings.js`) for maintainability
+- Web session agents now run in `auto_approve` mode for unattended execution
+- Session management moved to client-side for faster, round-trip-free navigation
+- User message rendering moved to the UI layer for cleaner architecture
+- No-cache headers for static file serving to ensure fresh asset delivery
+
+### Fixed
+- `DELETE`/`PUT`/`PATCH` HTTP methods now supported via custom WEBrick servlet
+- Task run broadcasts correctly after WebSocket subscription; table button visibility fixed
+- Mutex deadlock in scheduler `stop` method when called from a signal trap context
+- `split` used instead of `shellsplit` for skill arguments to avoid parsing errors
+
+### More
+- Add HTTP server spec and scheduler spec with full test coverage
+- Minor web UI style improvements and reduced mouse dependency
+
 ## [0.7.6] - 2026-03-02
 
 ### Added

data/lib/clacky/agent/tool_executor.rb

@@ -16,8 +16,6 @@ module Clacky
         when :confirm_safes
           # Use SafeShell integration for safety check
           is_safe_operation?(tool_name, tool_params)
-        when :plan_only
-          false
         else
           false
         end
@@ -217,16 +215,6 @@ module Clacky
         }
       end
 
-      # Build planned result for plan-only mode
-      # @param call [Hash] Tool call
-      # @return [Hash] Formatted planned result
-      def build_planned_result(call)
-        {
-          id: call[:id],
-          content: JSON.generate({ planned: true, message: "Tool execution skipped (plan mode)" })
-        }
-      end
-
       # Check if a tool is potentially slow and should show progress
       # @param tool_name [String] Name of the tool
       # @param args [Hash] Tool arguments

data/lib/clacky/agent.rb

@@ -389,12 +389,6 @@ module Clacky
           end
         else
           # Permission check (if not in auto-approve mode)
-          if @config.is_plan_only?
-            @ui&.show_info("Planned: #{call[:name]}")
-            results << build_planned_result(call)
-            next
-          end
-
           confirmation = confirm_tool_use?(call)
           unless confirmation[:approved]
             # Show denial warning only for user-initiated denials (not system-injected preview errors)
@@ -774,7 +768,7 @@ module Clacky
 
     # Format user content with optional images
     # @param text [String] User's text input
-    # @param images [Array<String>] Array of image file paths
+    # @param images [Array<String>] Array of image file paths or data: URLs
     # @return [String|Array] String if no images, Array with text and image_url objects if images present
     private def format_user_content(text, images)
       return text if images.nil? || images.empty?
@@ -782,8 +776,13 @@ module Clacky
       content = []
       content << { type: "text", text: text } unless text.nil? || text.empty?
 
-      images.each do |image_path|
-        image_url = Utils::FileProcessor.image_path_to_data_url(image_path)
+      images.each do |image|
+        # Accept both file paths and pre-encoded data: URLs (e.g. from Web UI)
+        image_url = if image.start_with?("data:")
+                      image
+                    else
+                      Utils::FileProcessor.image_path_to_data_url(image)
+                    end
         content << { type: "image_url", image_url: { url: image_url } }
       end
 

data/lib/clacky/agent_config.rb

@@ -148,7 +148,7 @@ module Clacky
     # Default model for ClaudeCode environment
     CLAUDE_DEFAULT_MODEL = "claude-sonnet-4-5"
 
-    PERMISSION_MODES = [:auto_approve, :confirm_safes, :plan_only].freeze
+    PERMISSION_MODES = [:auto_approve, :confirm_safes].freeze
 
     attr_accessor :permission_mode, :max_tokens, :verbose,
                   :enable_compression, :enable_prompt_caching,
@@ -397,10 +397,6 @@ module Clacky
       true
     end
 
-    def is_plan_only?
-      @permission_mode == :plan_only
-    end
-
     private def validate_permission_mode(mode)
       mode ||= :confirm_safes
       mode = mode.to_sym

data/lib/clacky/cli.rb

@@ -27,7 +27,6 @@ module Clacky
       Permission modes:
         auto_approve    - Automatically execute all tools (use with caution)
         confirm_safes   - Auto-approve safe operations, confirm risky ones (default)
-        plan_only       - Generate plan without executing
 
       UI themes:
         hacker          - Matrix/hacker-style with bracket symbols (default)
@@ -42,7 +41,7 @@ module Clacky
         $ clacky agent --mode=auto_approve --path /path/to/project
     LONGDESC
     option :mode, type: :string, default: "confirm_safes",
-           desc: "Permission mode: auto_approve, confirm_safes, plan_only"
+           desc: "Permission mode: auto_approve, confirm_safes"
     option :theme, type: :string, default: "hacker",
            desc: "UI theme: hacker, minimal (default: hacker)"
     option :verbose, type: :boolean, aliases: "-v", default: false, desc: "Show detailed output"
@@ -690,5 +689,41 @@ module Clacky
 
 
     end
+
+    # ── server command ─────────────────────────────────────────────────────────
+    desc "server", "Start the Clacky web UI server"
+    long_desc <<-LONGDESC
+      Start a long-running HTTP + WebSocket server that serves the Clacky web UI.
+
+      Open http://localhost:7070 in your browser to access the multi-session interface.
+      Multiple sessions (e.g. "coding", "copywriting") can run simultaneously.
+
+      Examples:
+        $ clacky server
+        $ clacky server --port 8080
+    LONGDESC
+    option :host, type: :string, default: "127.0.0.1", desc: "Bind host (default: 127.0.0.1)"
+    option :port, type: :numeric, default: 7070, desc: "Listen port (default: 7070)"
+    def server
+      require_relative "server/http_server"
+
+      agent_config = Clacky::AgentConfig.load
+
+      # Factory so each new session gets a fresh Client instance
+      client_factory = lambda do
+        Clacky::Client.new(
+          agent_config.api_key,
+          base_url: agent_config.base_url,
+          anthropic_format: agent_config.anthropic_format?
+        )
+      end
+
+      Clacky::Server::HttpServer.new(
+        host:           options[:host],
+        port:           options[:port],
+        agent_config:   agent_config,
+        client_factory: client_factory
+      ).start
+    end
   end
 end

data/lib/clacky/default_skills/create-task/SKILL.md

@@ -0,0 +1,102 @@
+---
+name: create-task
+description: Create a scheduled automated task. User describes what they want to automate, agent creates the task prompt file and optional cron schedule.
+disable-model-invocation: false
+user-invocable: true
+---
+
+# Create Task Skill
+
+## When to Use
+Invoke this skill when a user wants to:
+- Automate something on a schedule (e.g. "send a daily report", "remind me every Monday", "check prices every hour")
+- Create a task that runs automatically ("set up a scheduled task for me")
+- Use the command `/create-task`
+
+## Task & Schedule Storage Format
+
+### Task file: `~/.clacky/tasks/<name>.md`
+Plain text prompt file. When the task fires, the Agent reads this file as its input prompt and executes it autonomously.
+
+Example content of `~/.clacky/tasks/daily_report.md`:
+```
+Check today's GitHub PR list, summarize the status of each PR, and save a daily report to ~/reports/daily_<date>.md
+```
+
+### Schedule file: `~/.clacky/schedules.yml`
+YAML list. Each entry has:
+```yaml
+- name: daily_report         # unique name, matches task name
+  task: daily_report         # references ~/.clacky/tasks/daily_report.md
+  cron: "0 9 * * 1-5"       # 5-field cron: minute hour day month weekday
+  enabled: true
+```
+
+Cron field order: `minute hour day-of-month month day-of-week`
+- `0 9 * * 1-5`  → 09:00 every weekday
+- `0 9 * * *`    → 09:00 every day
+- `0 */2 * * *`  → every 2 hours
+- `*/30 * * * *` → every 30 minutes
+
+## Process
+
+### Step 1: Understand the user's intent
+Ask clarifying questions if needed:
+- What should the task DO? (what action, what goal)
+- How often / when should it run? (if scheduling is needed)
+- Any specific working directory or context?
+
+### Step 2: Generate a task name
+- Lowercase, alphanumeric + underscores only
+- Short and descriptive, e.g. `daily_standup`, `price_monitor`, `weekly_report`
+
+### Step 3: Write the task prompt file
+Use the `write` tool to create `~/.clacky/tasks/<name>.md`.
+
+The prompt content should be:
+- Clear and self-contained (the agent running it has no prior context)
+- Written as a direct instruction to an AI agent
+- Include any relevant details the user provided (URLs, file paths, output format, etc.)
+
+Example:
+```
+write(
+  path: "~/.clacky/tasks/daily_standup.md",
+  content: "Check today's work progress:\n1. Review recent git commits\n2. List open TODOs\n3. Generate a standup summary and print it to the terminal"
+)
+```
+
+### Step 4: Write the schedule (if user wants it automated)
+Read the existing `~/.clacky/schedules.yml` first (if it exists), then append the new entry and write the whole file back.
+
+Use the `write` tool. Example full file:
+```yaml
+- name: daily_standup
+  task: daily_standup
+  cron: "0 9 * * 1-5"
+  enabled: true
+```
+
+If `schedules.yml` already has entries, preserve them and append the new one.
+
+### Step 5: Confirm to the user
+Reply with a clear summary:
+```
+✅ Task created successfully!
+
+📋 Name: daily_standup
+📄 File: ~/.clacky/tasks/daily_standup.md
+⏰ Schedule: Every weekday at 09:00 (cron: 0 9 * * 1-5)
+
+Task prompt:
+> Check today's work progress...
+
+The task will run automatically at the next scheduled time.
+You can also click ▶ in the sidebar to run it immediately.
+```
+
+## Notes
+- If the user only wants a task without a schedule (run manually), skip Step 4
+- Always expand `~` to the actual home path when writing files
+- Task name must be sanitized: only `[a-z0-9_-]`, no spaces
+- The cron scheduler checks every minute; `clacky server` must be running for auto-execution

data/lib/clacky/json_ui_controller.rb

@@ -28,10 +28,6 @@ module Clacky
 
     # === Output display ===
 
-    def show_user_message(content, images: [])
-      emit("user_message", content: content, images: images)
-    end
-
     def show_assistant_message(content)
       return if content.nil? || content.strip.empty?
 
@@ -117,7 +113,7 @@ module Clacky
 
     # === Progress ===
 
-    def show_progress(message = nil, prefix_newline: true)
+    def show_progress(message = nil, prefix_newline: true, output_buffer: nil)
       @progress_start_time = Time.now
       emit("progress", message: message, status: "start")
     end

data/lib/clacky/plain_ui_controller.rb

@@ -107,7 +107,7 @@ module Clacky
 
     # === Progress (no-ops — no spinner in plain mode) ===
 
-    def show_progress(message = nil, prefix_newline: true); end
+    def show_progress(message = nil, prefix_newline: true, output_buffer: nil); end
     def clear_progress; end
 
     # === State updates (no-ops) ===