openclacky 1.5.21 → 1.5.23

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (110) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +119 -0
  3. data/docs/secretary-prototype.md +286 -0
  4. data/lib/clacky/agent/session_serializer.rb +15 -11
  5. data/lib/clacky/agent.rb +58 -15
  6. data/lib/clacky/agent_config.rb +3 -1
  7. data/lib/clacky/agent_profile.rb +33 -6
  8. data/lib/clacky/billing/platform_billing.rb +9 -0
  9. data/lib/clacky/default_extensions/advisor/README.md +25 -0
  10. data/lib/clacky/default_extensions/advisor/README.zh.md +25 -0
  11. data/lib/clacky/default_extensions/advisor/ext.yml +1 -1
  12. data/lib/clacky/default_extensions/advisor/icon.svg +14 -0
  13. data/lib/clacky/default_extensions/coding/ext.yml +0 -1
  14. data/lib/clacky/default_extensions/computer-use/README.md +48 -0
  15. data/lib/clacky/default_extensions/computer-use/README.zh.md +48 -0
  16. data/lib/clacky/default_extensions/computer-use/ext.yml +1 -1
  17. data/lib/clacky/default_extensions/computer-use/icon.svg +16 -0
  18. data/lib/clacky/default_extensions/ext-studio/ext.yml +0 -1
  19. data/lib/clacky/default_extensions/general/ext.yml +0 -1
  20. data/lib/clacky/default_extensions/git/README.md +41 -0
  21. data/lib/clacky/default_extensions/git/README.zh.md +41 -0
  22. data/lib/clacky/default_extensions/git/ext.yml +1 -1
  23. data/lib/clacky/default_extensions/git/icon.svg +15 -0
  24. data/lib/clacky/default_extensions/git/panels/git/view.js +1960 -399
  25. data/lib/clacky/default_extensions/meeting/README.md +46 -0
  26. data/lib/clacky/default_extensions/meeting/README.zh.md +47 -0
  27. data/lib/clacky/default_extensions/meeting/ext.yml +1 -1
  28. data/lib/clacky/default_extensions/meeting/icon.svg +13 -0
  29. data/lib/clacky/default_extensions/preview/README.md +29 -0
  30. data/lib/clacky/default_extensions/preview/README.zh.md +29 -0
  31. data/lib/clacky/default_extensions/preview/ext.yml +1 -1
  32. data/lib/clacky/default_extensions/preview/icon.svg +13 -0
  33. data/lib/clacky/default_extensions/preview/panels/preview/view.js +199 -34
  34. data/lib/clacky/default_extensions/secretary/agents/secretary.md +41 -0
  35. data/lib/clacky/default_extensions/secretary/agents/worker.md +35 -0
  36. data/lib/clacky/default_extensions/secretary/api/handler.rb +8 -0
  37. data/lib/clacky/default_extensions/secretary/ext.yml +39 -0
  38. data/lib/clacky/default_extensions/secretary/panels/work/view.js +344 -0
  39. data/lib/clacky/default_extensions/secretary/tools/delegate_work.rb +37 -0
  40. data/lib/clacky/default_extensions/secretary/tools/manage_work.rb +22 -0
  41. data/lib/clacky/default_extensions/secretary/tools/yield_work.rb +35 -0
  42. data/lib/clacky/default_extensions/time_machine/README.md +32 -0
  43. data/lib/clacky/default_extensions/time_machine/README.zh.md +32 -0
  44. data/lib/clacky/default_extensions/time_machine/ext.yml +1 -1
  45. data/lib/clacky/default_extensions/time_machine/icon.svg +14 -0
  46. data/lib/clacky/default_skills/channel-manager/SKILL.md +79 -8
  47. data/lib/clacky/default_skills/channel-manager/discord_setup.rb +5 -1
  48. data/lib/clacky/default_skills/channel-manager/weixin_setup.rb +8 -1
  49. data/lib/clacky/default_skills/cron-task-creator/SKILL.md +183 -206
  50. data/lib/clacky/default_skills/cron-task-creator/evals/evals.json +45 -0
  51. data/lib/clacky/default_skills/media-gen/SKILL.md +17 -8
  52. data/lib/clacky/extension/api_extension.rb +10 -2
  53. data/lib/clacky/extension/loader.rb +2 -0
  54. data/lib/clacky/extension/verifier.rb +2 -2
  55. data/lib/clacky/locales/en.rb +14 -0
  56. data/lib/clacky/locales/zh.rb +14 -0
  57. data/lib/clacky/prompts/base.md +1 -1
  58. data/lib/clacky/providers.rb +68 -31
  59. data/lib/clacky/search_config.rb +33 -11
  60. data/lib/clacky/server/channel/adapters/base.rb +18 -0
  61. data/lib/clacky/server/channel/adapters/feishu/message_parser.rb +1 -0
  62. data/lib/clacky/server/channel/adapters/telegram/adapter.rb +1 -0
  63. data/lib/clacky/server/channel/channel_config.rb +185 -48
  64. data/lib/clacky/server/channel/channel_manager.rb +179 -66
  65. data/lib/clacky/server/git_panel.rb +362 -35
  66. data/lib/clacky/server/http_server.rb +530 -181
  67. data/lib/clacky/server/preview.rb +118 -17
  68. data/lib/clacky/server/scheduler.rb +211 -51
  69. data/lib/clacky/server/web_ui_controller.rb +35 -27
  70. data/lib/clacky/session_manager.rb +56 -6
  71. data/lib/clacky/tools/base.rb +7 -1
  72. data/lib/clacky/utils/file_processor.rb +20 -10
  73. data/lib/clacky/utils/mac_app_detector.rb +8 -7
  74. data/lib/clacky/utils/model_pricing.rb +60 -2
  75. data/lib/clacky/utils/windows_app_detector.rb +3 -1
  76. data/lib/clacky/version.rb +1 -1
  77. data/lib/clacky/web/app.css +1114 -205
  78. data/lib/clacky/web/app.js +143 -8
  79. data/lib/clacky/web/auth.js +1 -1
  80. data/lib/clacky/web/components/code-editor.js +73 -4
  81. data/lib/clacky/web/components/composer.js +107 -8
  82. data/lib/clacky/web/components/image-zoom.js +165 -0
  83. data/lib/clacky/web/components/model-picker.js +7 -5
  84. data/lib/clacky/web/components/notify.js +39 -12
  85. data/lib/clacky/web/components/onboard.js +1 -1
  86. data/lib/clacky/web/core/aside.js +60 -3
  87. data/lib/clacky/web/features/billing/view.js +2 -2
  88. data/lib/clacky/web/features/channels/store.js +19 -4
  89. data/lib/clacky/web/features/channels/view.js +92 -28
  90. data/lib/clacky/web/features/extensions/view.js +17 -10
  91. data/lib/clacky/web/features/new-session/store.js +79 -2
  92. data/lib/clacky/web/features/new-session/view.js +516 -75
  93. data/lib/clacky/web/features/skills/store.js +1 -1
  94. data/lib/clacky/web/features/tasks/store.js +5 -3
  95. data/lib/clacky/web/features/tasks/view.js +249 -66
  96. data/lib/clacky/web/features/workspace/store.js +13 -6
  97. data/lib/clacky/web/features/workspace/view.js +340 -214
  98. data/lib/clacky/web/i18n.js +366 -68
  99. data/lib/clacky/web/index.html +196 -165
  100. data/lib/clacky/web/projects.js +37 -4
  101. data/lib/clacky/web/sessions.js +263 -146
  102. data/lib/clacky/web/settings.js +241 -53
  103. data/lib/clacky/web/skills.js +2 -2
  104. data/lib/clacky/web/theme.js +17 -2
  105. data/lib/clacky/web/utils.js +234 -2
  106. data/lib/clacky/web/weixin-qr.html +2 -1
  107. data/lib/clacky/web/ws-dispatcher.js +14 -31
  108. data/lib/clacky/work/service.rb +542 -0
  109. data/lib/clacky/work/store.rb +57 -0
  110. metadata +31 -1
@@ -7,20 +7,30 @@ require "json"
7
7
  module Clacky
8
8
  # ChannelConfig manages IM platform credentials (Feishu, WeCom, etc.).
9
9
  #
10
- # Config is stored in ~/.clacky/channels.yml:
10
+ # Config is stored in ~/.clacky/channels.yml. Every platform holds a list of
11
+ # instances, so one platform can be connected more than once (e.g. a personal
12
+ # and a work Feishu app):
11
13
  #
12
14
  # channels:
13
15
  # feishu:
14
- # enabled: true
15
- # app_id: cli_xxx
16
- # app_secret: xxx
17
- # domain: https://open.feishu.cn
18
- # allowed_users:
19
- # - ou_xxx
16
+ # - id: default
17
+ # name: Personal
18
+ # enabled: true
19
+ # app_id: cli_xxx
20
+ # app_secret: xxx
21
+ # - id: work
22
+ # name: Company
23
+ # enabled: true
24
+ # app_id: cli_yyy
25
+ # app_secret: yyy
20
26
  # wecom:
21
- # enabled: false
22
- # bot_id: xxx
23
- # secret: xxx
27
+ # - id: default
28
+ # enabled: false
29
+ # bot_id: xxx
30
+ # secret: xxx
31
+ #
32
+ # The legacy single-hash form (`feishu: { enabled: true, ... }`) is migrated
33
+ # in memory on load: it becomes one instance with id "default".
24
34
  #
25
35
  # This class is only responsible for platform credentials.
26
36
  # working_dir and permission_mode live in AgentConfig.
@@ -28,7 +38,12 @@ module Clacky
28
38
  CONFIG_DIR = File.join(Dir.home, ".clacky")
29
39
  CONFIG_FILE = File.join(CONFIG_DIR, "channels.yml")
30
40
 
31
- # @param channels [Hash<String, Hash>] string-keyed platform configs (raw from YAML)
41
+ DEFAULT_INSTANCE_ID = "default"
42
+
43
+ META_KEYS = %w[id name enabled].freeze
44
+
45
+ # @param channels [Hash<String, Array<Hash>|Hash>] platform configs (raw from
46
+ # YAML; a Hash value is treated as a legacy single-instance config)
32
47
  # @param status_messages [Boolean] global toggle for process-status messages
33
48
  # ("Thinking...", "Done" summary) sent to IM chats
34
49
  # @param process_messages [Boolean] global toggle for tool-process messages
@@ -36,7 +51,7 @@ module Clacky
36
51
  # @param progress_cards [Boolean] global toggle for live-updating progress
37
52
  # cards on platforms that support them
38
53
  def initialize(channels: {}, status_messages: false, process_messages: false, progress_cards: true)
39
- @channels = channels || {}
54
+ @channels = normalize_channels(channels || {})
40
55
  @status_messages = status_messages == true ? true : false
41
56
  @process_messages = process_messages == true ? true : false
42
57
  # Opt-out (unlike the toggles above): missing key keeps cards on for existing users.
@@ -70,34 +85,78 @@ module Clacky
70
85
  YAML.dump({ "status_messages" => @status_messages, "process_messages" => @process_messages, "progress_cards" => @progress_cards, "channels" => @channels })
71
86
  end
72
87
 
73
- # Returns true if at least one channel is enabled.
88
+ # Returns true if at least one instance of any platform is enabled.
74
89
  def any_enabled?
75
- @channels.any? { |_, cfg| cfg["enabled"] }
90
+ @channels.any? { |_, list| list.any? { |inst| inst["enabled"] } }
76
91
  end
77
92
 
78
- # Returns the list of enabled platform symbols.
93
+ # Returns the list of platform symbols that have at least one enabled instance.
79
94
  # @return [Array<Symbol>]
80
95
  def enabled_platforms
81
- @channels
82
- .select { |_, cfg| cfg["enabled"] }
83
- .keys
84
- .map(&:to_sym)
96
+ enabled_instances.map { |platform, _| platform }.uniq
97
+ end
98
+
99
+ # All enabled instances as [platform_symbol, instance_hash] pairs.
100
+ # @return [Array<Array(Symbol, Hash)>]
101
+ def enabled_instances
102
+ result = []
103
+ @channels.each do |platform, list|
104
+ list.each do |inst|
105
+ result << [platform.to_sym, inst] if inst["enabled"]
106
+ end
107
+ end
108
+ result
85
109
  end
86
110
 
87
- # Returns true if the given platform is configured and enabled.
111
+ # Returns true if the platform (or one specific instance) is configured and
112
+ # enabled.
88
113
  # @param platform [Symbol, String]
89
- def enabled?(platform)
90
- cfg = @channels[platform.to_s]
91
- cfg && cfg["enabled"]
114
+ # @param instance_id [String, nil] nil means "any instance of this platform"
115
+ def enabled?(platform, instance_id = nil)
116
+ list = instances(platform)
117
+ return false if list.empty?
118
+
119
+ if instance_id.nil? || instance_id.to_s.empty?
120
+ list.any? { |inst| inst["enabled"] }
121
+ else
122
+ inst = instance(platform, instance_id)
123
+ !!(inst && inst["enabled"])
124
+ end
125
+ end
126
+
127
+ # Configured instances for a platform.
128
+ # @param platform [Symbol, String]
129
+ # @return [Array<Hash>] string-keyed instance hashes
130
+ def instances(platform)
131
+ @channels[platform.to_s] || []
132
+ end
133
+
134
+ # Look up one instance. A nil/blank id resolves to the first instance,
135
+ # which keeps legacy single-instance callers working unchanged.
136
+ # @param platform [Symbol, String]
137
+ # @param instance_id [String, nil]
138
+ # @return [Hash, nil]
139
+ def instance(platform, instance_id = nil)
140
+ list = instances(platform)
141
+ return nil if list.empty?
142
+ return list.first if instance_id.nil? || instance_id.to_s.empty?
143
+
144
+ list.find { |inst| inst["id"] == instance_id.to_s }
145
+ end
146
+
147
+ # @return [Array<String>] instance ids for a platform
148
+ def instance_ids(platform)
149
+ instances(platform).map { |inst| inst["id"] }
92
150
  end
93
151
 
94
152
  # Return the symbol-keyed config hash expected by each adapter's initializer.
95
- # Returns nil if the platform is not configured.
153
+ # Returns nil if the platform/instance is not configured.
96
154
  #
97
155
  # @param platform [Symbol, String]
156
+ # @param instance_id [String, nil] nil resolves to the first instance
98
157
  # @return [Hash, nil]
99
- def platform_config(platform)
100
- raw = @channels[platform.to_s]
158
+ def platform_config(platform, instance_id = nil)
159
+ raw = instance(platform, instance_id)
101
160
  return nil unless raw
102
161
 
103
162
  case platform.to_sym
@@ -147,22 +206,42 @@ module Clacky
147
206
  }.compact
148
207
  else
149
208
  # Unknown platform — pass all non-meta keys as symbol-keyed hash
150
- raw.reject { |k, _| k == "enabled" }
209
+ raw.reject { |k, _| META_KEYS.include?(k) }
151
210
  .transform_keys(&:to_sym)
152
211
  end
153
212
  end
154
213
 
155
- # Set or update a platform's credentials.
156
- # Merges provided fields into the existing entry.
214
+ # Set or update an instance's credentials.
215
+ # Merges provided fields into the existing entry; creates a new instance
216
+ # when the id does not exist yet.
157
217
  # Automatically sets enabled: true unless explicitly provided.
158
218
  #
159
219
  # @param platform [Symbol, String]
220
+ # @param instance_id [String, nil] nil updates the first instance (creating
221
+ # the default one when the platform has none)
222
+ # @param name [String, nil] display name for this instance
223
+ # @param enabled [Boolean, nil] leave untouched when nil
160
224
  # @param fields [Hash] symbol-keyed credential fields
161
- def set_platform(platform, **fields)
162
- key = platform.to_s
163
- @channels[key] ||= {}
164
- fields.each { |k, v| @channels[key][k.to_s] = v }
165
- @channels[key]["enabled"] = true unless @channels[key].key?("enabled")
225
+ # @return [String] the instance id that was written
226
+ def set_platform(platform, instance_id: nil, name: nil, enabled: nil, **fields)
227
+ key = platform.to_s
228
+ inst = instance(key, instance_id)
229
+
230
+ if inst.nil?
231
+ inst = { "id" => instance_id.to_s.empty? ? next_instance_id(key) : instance_id.to_s }
232
+ @channels[key] ||= []
233
+ @channels[key] << inst
234
+ end
235
+
236
+ fields.each do |k, v|
237
+ k = k.to_s
238
+ next if META_KEYS.include?(k)
239
+ inst[k] = v
240
+ end
241
+ inst["name"] = name unless name.nil?
242
+ inst["enabled"] = enabled unless enabled.nil?
243
+ inst["enabled"] = true if enabled.nil? && !inst.key?("enabled")
244
+ inst["id"]
166
245
  end
167
246
 
168
247
  # Global toggle: whether process-status messages ("Thinking...", "Done"
@@ -202,27 +281,47 @@ module Clacky
202
281
  @progress_cards = enabled ? true : false
203
282
  end
204
283
 
205
- # Enable a platform (requires it to already be configured).
284
+ # Enable an instance (requires it to already be configured).
206
285
  # @param platform [Symbol, String]
207
- # @raise [ArgumentError] if the platform has no stored credentials yet.
208
- def enable_platform(platform)
209
- key = platform.to_s
210
- raise ArgumentError, "Platform #{platform} is not configured" unless @channels.key?(key)
211
- @channels[key]["enabled"] = true
286
+ # @param instance_id [String, nil] nil enables the first instance
287
+ # @raise [ArgumentError] if the instance has no stored credentials yet.
288
+ def enable_platform(platform, instance_id = nil)
289
+ inst = instance(platform, instance_id)
290
+ raise ArgumentError, "Platform #{platform} is not configured" unless inst
291
+ inst["enabled"] = true
212
292
  end
213
293
 
214
- # Disable a platform (keeps credentials, just sets enabled: false).
294
+ # Disable an instance (keeps credentials, just sets enabled: false).
295
+ # Without an id, every instance of the platform is disabled.
215
296
  # @param platform [Symbol, String]
216
- def disable_platform(platform)
217
- key = platform.to_s
218
- return unless @channels.key?(key)
219
- @channels[key]["enabled"] = false
297
+ # @param instance_id [String, nil]
298
+ def disable_platform(platform, instance_id = nil)
299
+ targets = if instance_id.nil? || instance_id.to_s.empty?
300
+ instances(platform)
301
+ else
302
+ [instance(platform, instance_id)].compact
303
+ end
304
+ targets.each { |inst| inst["enabled"] = false }
220
305
  end
221
306
 
222
- # Remove a platform entry entirely.
307
+ # Remove an instance entirely. Without an id, the whole platform entry is
308
+ # removed.
223
309
  # @param platform [Symbol, String]
224
- def remove_platform(platform)
225
- @channels.delete(platform.to_s)
310
+ # @param instance_id [String, nil]
311
+ # @return [Boolean] true when something was removed
312
+ def remove_platform(platform, instance_id = nil)
313
+ key = platform.to_s
314
+ return false unless @channels.key?(key)
315
+
316
+ if instance_id.nil? || instance_id.to_s.empty?
317
+ @channels.delete(key)
318
+ return true
319
+ end
320
+
321
+ list = @channels[key]
322
+ removed = list.reject! { |inst| inst["id"] == instance_id.to_s }
323
+ @channels.delete(key) if list.empty?
324
+ !removed.nil?
226
325
  end
227
326
 
228
327
  # Deep copy - prevents callers from mutating shared config state.
@@ -230,5 +329,43 @@ module Clacky
230
329
  def deep_copy
231
330
  self.class.new(channels: JSON.parse(JSON.generate(@channels)), status_messages: @status_messages, process_messages: @process_messages, progress_cards: @progress_cards)
232
331
  end
332
+
333
+ private def normalize_channels(raw)
334
+ result = {}
335
+ raw.each do |platform, value|
336
+ result[platform.to_s] = normalize_instances(platform.to_s, value)
337
+ end
338
+ result
339
+ end
340
+
341
+ private def normalize_instances(platform, value)
342
+ list = case value
343
+ when Array then value
344
+ when Hash then [value]
345
+ else []
346
+ end
347
+
348
+ used_ids = []
349
+ list.each_with_index.map do |item, index|
350
+ inst = (item || {}).each_with_object({}) { |(k, v), out| out[k.to_s] = v }
351
+ id = inst["id"].to_s
352
+ id = index.zero? ? DEFAULT_INSTANCE_ID : "#{platform}-#{index + 1}" if id.empty?
353
+ id = "#{id}-#{index + 1}" while used_ids.include?(id)
354
+ used_ids << id
355
+ inst["id"] = id
356
+ inst["enabled"] = false unless inst.key?("enabled")
357
+ inst
358
+ end
359
+ end
360
+
361
+ private def next_instance_id(platform)
362
+ list = instances(platform)
363
+ return DEFAULT_INSTANCE_ID if list.empty?
364
+
365
+ used = list.map { |inst| inst["id"] }
366
+ index = list.length + 1
367
+ index += 1 while used.include?("#{platform}-#{index}")
368
+ "#{platform}-#{index}"
369
+ end
233
370
  end
234
371
  end