openclacky 1.3.2 → 1.3.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: ed703cddac3ffa9887b5c500c5dfbe57c895eb5aab0e9dc3338592c9317555ec
-  data.tar.gz: 67d21c3c857e72bb729cfcecbdb3749eaaac1c76b21e1d0600081d1e4d79e880
+  metadata.gz: 6b9b4de98a5b98c110e4ee71bc8039c1b6445fda13f4479c42d466d80bb307bd
+  data.tar.gz: b47e189d857b86955eb95253e0b873d1cad16f9dfcb5040e29e638134151b9a8
 SHA512:
-  metadata.gz: 4fe46c92c67e5937bf24e325be47046a9ebf555afb722aaaaf108a17b2c13403c7e42c08d4b1a7abafad5c5ffb5d79d2749264c051572d157d0094dcb067ac78
-  data.tar.gz: 5fa8e909159560aa13944c0435716e7a98265504c6f61e8cfc298bc09553aa218ac404423d4e9b45f5a8d17563f0ae8a7a50547460fb497e06a98bc46b55aa53
+  metadata.gz: 1ab60195873b54c48d72a4d6ebe5f79c9e5daeaa826f867c50cb79e5f6d367dd809b53ebe50aecd42af397cdd03962c0f0a5517ac2e94112b7399778d52c22ec
+  data.tar.gz: c11638e5355fde8fc2ade76d7868f8b68f47722dada241abafd34adf5a61fc88d5b734292ded5cb97cbdb4bc6360c9fd7b84a77ebd9fe95ec156a8eb02828556

data/CHANGELOG.md

@@ -5,6 +5,34 @@ 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.3] - 2026-06-23
+
+### Added
+- Profile editor with CodeMirror for editing agent SOUL/USER files
+- Inline editing for memory cards
+- Workspace file preview, plus "copy path" in the context menu and a close button in the code editor
+- Time Machine: browse and restore previous workspace states via git
+- Image editing support in media generation
+- Copy and edit actions on user/assistant message bubbles
+- Media output directory configuration in settings
+- Web UI extension support
+- Health check endpoint and signal logging
+
+### Improved
+- Differentiated icons and reordered buttons in the context menu and memory card
+- Removed the standalone preview panel for a cleaner workspace layout
+- Throttle duplicate inbound channel messages
+- Session bar labels no longer wrap
+- Added Japanese README (README_JA.md)
+
+### Fixed
+- Lock the default-model checkbox when only one model exists (C-5677)
+- Jump to a session that is not yet loaded in the sidebar (C-5679)
+- Workspace panel now uses overlay mode on mobile
+- Clarified that `include_sessions` applies to auto-backup only (UI)
+- Removed extra padding from model cards in the grid
+- Moved profile fetch into the store and fixed the architecture spec
+
 ## [1.3.2] - 2026-06-18
 
 ### Added

data/Dockerfile

@@ -24,5 +24,8 @@ VOLUME ["/root/.clacky"]
 
 EXPOSE 7070
 
+HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
+  CMD curl -f http://localhost:7070/health || exit 1
+
 ENTRYPOINT ["openclacky"]
 CMD ["server", "--host", "0.0.0.0"]

data/README.md

@@ -7,7 +7,7 @@
 [![License](https://img.shields.io/badge/license-MIT-lightgrey?style=flat-square)](LICENSE.txt)
 
 <p align="center">
-  <a href="README.md">English</a> · <a href="README_CN.md">简体中文</a>
+  <a href="README.md">English</a> · <a href="README_CN.md">简体中文</a> · <a href="README_JA.md">日本語</a>
 </p>
 
 > Contributing? Read **[CONTRIBUTING.md](./CONTRIBUTING.md)** before opening a PR.

data/README_JA.md

@@ -0,0 +1,237 @@
+# OpenClacky
+
+[![Build](https://img.shields.io/github/actions/workflow/status/clacky-ai/openclacky/main.yml?label=build&style=flat-square)](https://github.com/clacky-ai/openclacky/actions)
+[![Release](https://img.shields.io/gem/v/openclacky?label=release&style=flat-square&color=blue)](https://rubygems.org/gems/openclacky)
+[![Ruby](https://img.shields.io/badge/ruby-%3E%3D%203.1.0-red?style=flat-square)](https://www.ruby-lang.org)
+[![Downloads](https://img.shields.io/gem/dt/openclacky?label=downloads&style=flat-square&color=brightgreen)](https://rubygems.org/gems/openclacky)
+[![License](https://img.shields.io/badge/license-MIT-lightgrey?style=flat-square)](LICENSE.txt)
+
+<p align="center">
+  <a href="README.md">English</a> · <a href="README_CN.md">简体中文</a> · <a href="README_JA.md">日本語</a>
+</p>
+
+> コントリビュートする場合は、PR を作成する前に **[CONTRIBUTING.md](./CONTRIBUTING.md)** をお読みください。
+
+**最もトークン効率の高いオープンソース AI エージェント。**
+
+OpenClacky は Claude Code と同等の性能を同等のコストで実現しつつ、他のオープンソースエージェントと比べて大幅にコストを削減します（OpenClaw 比で約 50%、Hermes 比で約 3 倍安価）。100% オープンソース（MIT）、任意の OpenAI 互換モデルで BYOK が可能で、2 年にわたるエージェント開発（Agentic R&D）とハーネスエンジニアリングの上に構築されています。
+
+> Web サイト: https://www.openclacky.com/ · 出資元 **MiraclePlus · ZhenFund · Sequoia China · Hillhouse Capital**
+
+## なぜ OpenClacky なのか？
+
+同じタスクで、どれだけ支払いますか？ 同等のエージェントワークロードにおいて、OpenClacky は主流の代替手段と比べて大量のトークン消費を節約します。
+
+| エージェント | 相対コスト | 備考 |
+|---|---|---|
+| **OpenClacky** | **約 0.8** | 16 ツール · キャッシュヒット率約 100% · サブエージェントルーティング |
+| Claude Code | 1.0×（基準） | 世界クラスのハーネス、クローズドソースのサブスクリプション |
+| OpenClaw | 約 1.5× | 同等のハーネスエージェント |
+| Hermes | 約 3× | 52 個の組み込みツール — スキーマの肥大化が約 3〜4 倍 |
+
+*数値は社内の一般的なエージェントタスクで計測した平均値であり、Claude Code を基準としています。詳細なベンチマークレポートは GitHub で公開予定です。*
+
+## 機能比較
+
+エージェントのコア性能はこの分野でおおむね横並びであり、本当の差別化要因は **コスト、オープン性、Skill の進化、そして統合機能** です。
+
+| 機能 | Claude Code | OpenClaw | Hermes | **OpenClacky** |
+|---|:---:|:---:|:---:|:---:|
+| トークンコスト | 1.0× | 約 1.5× | 約 3× | **約 0.8** |
+| オープンソース | ❌ クローズド | ✅ オープン | ✅ オープン | ✅ MIT |
+| BYOK / モデルの自由度 | ❌ Anthropic のみ | ✅ | ✅ | ✅ |
+| Skill の自己進化 | ❌ | ❌ | ✅ | ✅ |
+| IM 統合（Feishu/WeCom/WeChat/Discord/Telegram） | ❌ | ✅ | ✅ | ✅ |
+
+## どうやってコストを下げているのか
+
+機能を削るのではなく、すべてのレイヤーで正しい選択を積み重ねることで実現しています。
+
+### 1. 超高水準のキャッシュヒット率
+セッションを再起動しない、ダブルキャッシュマーカー、**Insert-then-Compress（挿入してから圧縮）** — システムプロンプトは決して書き換えられないため、圧縮後もキャッシュを再利用できます。**計測されたキャッシュヒット率: ほぼ 100%。**
+
+### 2. 最小限のツールセット
+**コアツールはわずか 16 個** です。機能は単一の `invoke_skill` メタツールを介して Skill エコシステムにオフロードされます。指標はツールの数ではなく、タスクの完了率です。
+
+| OpenClacky | Claude Code | OpenClaw | Hermes |
+|:--:|:--:|:--:|:--:|
+| **16** | 40+ | 23 | 52 |
+
+### 3. アイドル時の自動圧縮
+会議に行く、コーヒーを淹れる — その間にエージェントは長いコンテキストをバックグラウンドで圧縮し、キャッシュを事前にウォームアップします。戻ってきて最初に送るメッセージは直接キャッシュにヒットします。**コールドスタート時の初回トークンコストを 50% 以上削減。**
+
+### 4. BYOK — モデルを自分で選び、コストを自分で決める
+任意の OpenAI 互換 API をプラグアンドプレイで利用できます。公式の直接接続、集約ルーティング、互換リレー — 選択は 100% あなた次第です。コードには Claude を使い、サブタスクは自動的に DeepSeek にルーティングして、さらにトークンを節約しましょう。
+
+**2 年 · 3 世代のエージェントアーキテクチャ · 6 つのコアハーネスエンジニアリングの意思決定** の上に構築されています。
+
+## Skill — エージェントの魂
+
+- **`/` で呼び出す** — 瞬時の閲覧、あいまい検索、ダイレクトコール。何百もの Skill を指先で操作できます。
+- **自然言語で Skill を作成** — やりたいことを説明するだけで、エージェントが `SKILL.md` を起草し、手順を分解し、検証を実行します。コードは不要です。
+- **自己進化** — 各実行のあと、エージェントは実行コンテキストと結果に基づいて Skill を更新します。次回の呼び出しはより安定し、より正確になります。
+- **オープンで互換性が高い** — Claude Skills / Markdown Pack / カスタム形式をサポートします。
+- **収益化が可能** — 洗練された Skill はパッケージ化して販売でき、暗号化配布、License 管理、作者が設定する価格設定に対応します。
+
+## インストール
+
+### デスクトップインストーラー（推奨）
+
+ダブルクリックでインストール — 環境、依存関係、Skill のすべてが自動的にセットアップされます。
+
+- **macOS** — [`.dmg` をダウンロード](https://oss.1024code.com/openclacky-installer/official/openclacky-installer.dmg)（Apple Silicon / Intel）
+- **Windows** — [`.exe` をダウンロード](https://oss.1024code.com/openclacky-installer/official/openclacky-installer.exe)（Windows 10 2004+ / Windows 11）
+
+その他のオプション: https://www.openclacky.com/
+
+### コマンドライン
+
+ワンラインインストール（Mac/Ubuntu）:
+
+```bash
+/bin/bash -c "$(curl -sSL https://raw.githubusercontent.com/clacky-ai/openclacky/main/scripts/install.sh)"
+```
+
+Windows:
+
+```bash
+powershell -c "& ([scriptblock]::Create((irm 'https://raw.githubusercontent.com/clacky-ai/openclacky/main/scripts/install.ps1')))"
+```
+
+または Ruby（3.x/4.x）を使う場合:
+
+**要件:** Ruby >= 3.1.0
+
+```bash
+gem install openclacky
+```
+
+詳細はこちら: https://www.openclacky.com/docs/installation
+
+### Docker
+
+ビルド:
+
+```bash
+git clone https://github.com/clacky-ai/openclacky.git
+cd openclacky
+docker build -t openclacky .
+```
+
+**Linux:**
+
+```bash
+docker run -d --network=host -e CLACKY_ACCESS_KEY="" openclacky
+```
+
+`--network=host` は、コンテナ内のエージェントがホスト上で動作する Chrome のリモートデバッグポートに到達するために必要です。
+
+**macOS / Windows:**
+
+```bash
+docker run -d -p 7070:7070 -e CLACKY_ACCESS_KEY="" openclacky
+```
+
+> **注意:** macOS/Windows では `--network=host` がサポートされていないため、ブラウザの自動化が制限される場合があります。
+
+起動後、**http://localhost:7070** を開いてください。
+
+環境変数:
+
+| 変数 | 説明 |
+|---|---|
+| `CLACKY_ACCESS_KEY` | アクセスキーで Web UI を保護します（空の場合はパブリックモード） |
+
+
+## クイックスタート
+
+### ターミナル（CLI）
+
+```bash
+openclacky            # カレントディレクトリで対話型エージェントを起動
+```
+
+### Web UI
+
+```bash
+openclacky server     # デフォルト: http://localhost:7070
+```
+
+**http://localhost:7070** を開くと、マルチセッション対応の本格的なチャットインターフェースが利用できます — コーディング、コピーライティング、リサーチのセッションを並行して実行できます。
+
+オプション:
+
+```bash
+openclacky server --port 8080        # カスタムポート
+openclacky server --host 0.0.0.0     # すべてのインターフェースでリッスン（リモートアクセス）
+```
+
+## 設定
+
+```bash
+$ openclacky
+> /config
+```
+
+**API Key**、**Model**、**Base URL**（任意の OpenAI 互換プロバイダー）を設定します。
+
+標準でサポート: **Claude (Anthropic) · GPT (OpenAI) · DeepSeek · Kimi (Moonshot) · MiniMax · OpenRouter** — または任意のカスタムエンドポイント。
+
+## コーディングのユースケース
+
+OpenClacky は汎用 AI コーディングアシスタントとして機能します — フルスタックアプリの雛形作成、機能追加、あるいは未知のコードベースの探索が可能です:
+
+```bash
+$ openclacky
+> /new my-app        # 新しいプロジェクトの雛形を作成
+> メールとパスワードによるユーザー認証を追加して
+> 決済モジュールはどのように動作しますか？
+```
+
+## Star History
+
+<a href="https://www.star-history.com/?repos=clacky-ai%2Fopenclacky&type=date&legend=top-left">
+ <picture>
+   <source media="(prefers-color-scheme: dark)" srcset="https://api.star-history.com/chart?repos=clacky-ai/openclacky&type=date&theme=dark&legend=top-left" />
+   <source media="(prefers-color-scheme: light)" srcset="https://api.star-history.com/chart?repos=clacky-ai/openclacky&type=date&legend=top-left" />
+   <img alt="Star History Chart" src="https://api.star-history.com/chart?repos=clacky-ai/openclacky&type=date&legend=top-left" />
+ </picture>
+</a>
+
+## 上級者向け — クリエイタープログラム
+
+すでにパワーユーザーたちは、自身のワークフローを OpenClacky 上の垂直特化型 AI エキスパートへと変えています — 暗号化配布、License 管理、自分で設定する価格。法務、医療、ファイナンシャルプランニングなど、さまざまな分野で展開されています。
+
+詳細はこちら: https://www.openclacky.com/ → Creators
+
+## ソースからのインストール
+
+```bash
+git clone https://github.com/clacky-ai/openclacky.git
+cd openclacky
+bundle install
+bin/clacky
+```
+
+## 信頼性と信用
+
+- **100% オープンソース** — MIT ライセンス、すべてのコードが公開され、すべての意思決定が追跡可能
+- **2 年にわたるエージェント開発（Agentic R&D）** — 3 世代のアーキテクチャ
+- **16 個のコアツール** — 設計思想としての最小主義
+- **出資元** MiraclePlus · ZhenFund · Sequoia China · Hillhouse Capital
+
+## コントリビューター
+
+すべてのコード、バグ報告、そして丁寧なレビューが大切です。OpenClacky をより良くしてくださり、ありがとうございます。
+
+<a href="https://github.com/clacky-ai/openclacky/graphs/contributors">
+  <img src="https://contrib.rocks/image?repo=clacky-ai/openclacky" />
+</a>
+
+## コントリビュート
+
+バグ報告とプルリクエストは GitHub（ https://github.com/clacky-ai/openclacky ）で歓迎しています。コントリビューターは[行動規範](https://github.com/clacky-ai/openclacky/blob/main/CODE_OF_CONDUCT.md)を遵守することが求められます。
+
+## ライセンス
+
+[MIT ライセンス](https://opensource.org/licenses/MIT)のもとでオープンソースとして利用可能です。

data/lib/clacky/agent/session_serializer.rb

@@ -48,10 +48,25 @@ module Clacky
         end
         @latest_latency = last_assistant_with_latency&.dig(:latency)
 
-        # Restore Time Machine state
-        @task_parents = session_data.dig(:time_machine, :task_parents) || {}
-        @current_task_id = session_data.dig(:time_machine, :current_task_id) || 0
-        @active_task_id = session_data.dig(:time_machine, :active_task_id) || 0
+        # Restore Time Machine state. JSON.parse(symbolize_names:) turns the
+        # task_parents hash keys into symbols like :"1"; the runtime expects
+        # Integer keys/values, so coerce both ends back here.
+        raw_parents = session_data.dig(:time_machine, :task_parents) || {}
+        @task_parents = raw_parents.each_with_object({}) { |(k, v), h| h[k.to_s.to_i] = v.to_i }
+        @current_task_id = (session_data.dig(:time_machine, :current_task_id) || 0).to_i
+        @active_task_id = (session_data.dig(:time_machine, :active_task_id) || 0).to_i
+
+        raw_meta = session_data.dig(:time_machine, :task_meta) || {}
+        @task_meta = raw_meta.each_with_object({}) do |(k, v), h|
+          tid = k.to_s.to_i
+          attrs = v.is_a?(Hash) ? v : {}
+          h[tid] = {
+            title:      attrs[:title] || attrs["title"],
+            started_at: (attrs[:started_at] || attrs["started_at"])&.to_f,
+            ended_at:   (attrs[:ended_at]   || attrs["ended_at"])&.to_f,
+          }
+        end
+        backfill_task_meta_from_history!
 
         # Check if the session ended with an error.
         # We record the rollback intent here but do NOT truncate history immediately —
@@ -99,6 +114,34 @@ module Clacky
         refresh_system_prompt
       end
 
+      # Fill missing entries in @task_meta from @history (for sessions saved
+      # before task_meta existed, or for tasks whose meta was lost). The first
+      # real user message of each task supplies the title; created_at becomes
+      # started_at; the latest message in the task supplies ended_at. Tasks
+      # whose user turn has already been archived stay without a title and
+      # the UI falls back to "Task N".
+      private def backfill_task_meta_from_history!
+        @task_meta ||= {}
+        return if @current_task_id.to_i <= 0
+
+        @history.to_a.each do |m|
+          tid = m[:task_id]
+          next unless tid.is_a?(Integer) && tid > 0
+          next if m[:system_injected]
+
+          entry = (@task_meta[tid] ||= {})
+          if m[:role].to_s == "user" && (entry[:title].nil? || entry[:title].to_s.empty?)
+            text = extract_text_from_content(m[:content]).to_s.gsub(/\s+/, " ").strip
+            entry[:title] = text.length > 60 ? "#{text[0...57]}..." : text unless text.empty?
+          end
+          ts = m[:created_at]
+          next unless ts
+          entry[:started_at] ||= ts.to_f
+          cur_end = entry[:ended_at]
+          entry[:ended_at] = ts.to_f if cur_end.nil? || ts.to_f > cur_end
+        end
+      end
+
       private def persisted_card_field(key)
         card_id = @config.current_model_id
         return nil unless card_id
@@ -138,7 +181,8 @@ module Clacky
           time_machine: {  # Include Time Machine state
             task_parents: @task_parents || {},
             current_task_id: @current_task_id || 0,
-            active_task_id: @active_task_id || 0
+            active_task_id: @active_task_id || 0,
+            task_meta: @task_meta || {}
           },
           config: {
             # NOTE: api_key and other sensitive credentials are intentionally excluded