openclacky 1.5.22 → 1.5.24
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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +104 -0
- data/docs/secretary-prototype.md +286 -0
- data/lib/clacky/agent/cost_tracker.rb +55 -36
- data/lib/clacky/agent/hook_manager.rb +4 -1
- data/lib/clacky/agent/llm_caller.rb +46 -12
- data/lib/clacky/agent/memory_injector.rb +209 -0
- data/lib/clacky/agent/memory_updater.rb +16 -0
- data/lib/clacky/agent/session_serializer.rb +15 -11
- data/lib/clacky/agent/skill_manager.rb +30 -8
- data/lib/clacky/agent.rb +124 -17
- data/lib/clacky/agent_config.rb +7 -3
- data/lib/clacky/agent_profile.rb +33 -6
- data/lib/clacky/anthropic_stream_aggregator.rb +11 -1
- data/lib/clacky/bedrock_stream_aggregator.rb +11 -1
- data/lib/clacky/billing/platform_billing.rb +7 -0
- data/lib/clacky/cli.rb +4 -3
- data/lib/clacky/client.rb +30 -25
- data/lib/clacky/default_extensions/advisor/README.md +25 -0
- data/lib/clacky/default_extensions/advisor/README.zh.md +25 -0
- data/lib/clacky/default_extensions/advisor/ext.yml +1 -1
- data/lib/clacky/default_extensions/advisor/icon.svg +14 -0
- data/lib/clacky/default_extensions/advisor/panels/advisor/view.js +7 -1
- data/lib/clacky/default_extensions/coding/ext.yml +0 -1
- data/lib/clacky/default_extensions/computer-use/README.md +48 -0
- data/lib/clacky/default_extensions/computer-use/README.zh.md +48 -0
- data/lib/clacky/default_extensions/computer-use/ext.yml +1 -1
- data/lib/clacky/default_extensions/computer-use/icon.svg +16 -0
- data/lib/clacky/default_extensions/ext-studio/ext.yml +0 -1
- data/lib/clacky/default_extensions/general/ext.yml +0 -1
- data/lib/clacky/default_extensions/git/README.md +41 -0
- data/lib/clacky/default_extensions/git/README.zh.md +41 -0
- data/lib/clacky/default_extensions/git/ext.yml +1 -1
- data/lib/clacky/default_extensions/git/icon.svg +15 -0
- data/lib/clacky/default_extensions/git/panels/git/view.js +106 -27
- data/lib/clacky/default_extensions/meeting/README.md +46 -0
- data/lib/clacky/default_extensions/meeting/README.zh.md +47 -0
- data/lib/clacky/default_extensions/meeting/ext.yml +1 -1
- data/lib/clacky/default_extensions/meeting/icon.svg +13 -0
- data/lib/clacky/default_extensions/preview/README.md +29 -0
- data/lib/clacky/default_extensions/preview/README.zh.md +29 -0
- data/lib/clacky/default_extensions/preview/ext.yml +1 -1
- data/lib/clacky/default_extensions/preview/icon.svg +13 -0
- data/lib/clacky/default_extensions/secretary/README.md +69 -0
- data/lib/clacky/default_extensions/secretary/README.zh.md +69 -0
- data/lib/clacky/default_extensions/secretary/agents/secretary.md +41 -0
- data/lib/clacky/default_extensions/secretary/agents/worker.md +35 -0
- data/lib/clacky/default_extensions/secretary/api/handler.rb +8 -0
- data/lib/clacky/default_extensions/secretary/ext.yml +42 -0
- data/lib/clacky/default_extensions/secretary/icon.svg +17 -0
- data/lib/clacky/default_extensions/secretary/panels/work/view.js +344 -0
- data/lib/clacky/default_extensions/secretary/tools/delegate_work.rb +37 -0
- data/lib/clacky/default_extensions/secretary/tools/manage_work.rb +22 -0
- data/lib/clacky/default_extensions/secretary/tools/yield_work.rb +35 -0
- data/lib/clacky/default_extensions/time_machine/README.md +32 -0
- data/lib/clacky/default_extensions/time_machine/README.zh.md +32 -0
- data/lib/clacky/default_extensions/time_machine/ext.yml +1 -1
- data/lib/clacky/default_extensions/time_machine/icon.svg +14 -0
- data/lib/clacky/default_skills/channel-manager/SKILL.md +103 -13
- data/lib/clacky/default_skills/channel-manager/dingtalk_setup.rb +4 -2
- data/lib/clacky/default_skills/channel-manager/discord_setup.rb +9 -2
- data/lib/clacky/default_skills/channel-manager/weixin_setup.rb +10 -1
- data/lib/clacky/default_skills/cron-task-creator/SKILL.md +183 -206
- data/lib/clacky/default_skills/cron-task-creator/evals/evals.json +45 -0
- data/lib/clacky/default_skills/media-gen/SKILL.md +31 -14
- data/lib/clacky/default_skills/onboard/SKILL.md +5 -7
- data/lib/clacky/default_skills/persist-memory/SKILL.md +15 -1
- data/lib/clacky/extension/api_extension.rb +23 -2
- data/lib/clacky/extension/loader.rb +2 -0
- data/lib/clacky/extension/verifier.rb +2 -2
- data/lib/clacky/json_ui_controller.rb +14 -1
- data/lib/clacky/locales/en.rb +14 -0
- data/lib/clacky/locales/i18n.rb +25 -3
- data/lib/clacky/locales/zh.rb +14 -0
- data/lib/clacky/message_history.rb +15 -2
- data/lib/clacky/openai_responses_stream_aggregator.rb +11 -1
- data/lib/clacky/openai_stream_aggregator.rb +11 -1
- data/lib/clacky/prompts/base.md +1 -1
- data/lib/clacky/providers.rb +32 -17
- data/lib/clacky/server/backup_manager.rb +98 -2
- data/lib/clacky/server/browser_manager.rb +10 -5
- data/lib/clacky/server/channel/adapters/base.rb +18 -0
- data/lib/clacky/server/channel/adapters/feishu/message_parser.rb +1 -0
- data/lib/clacky/server/channel/adapters/telegram/adapter.rb +1 -0
- data/lib/clacky/server/channel/channel_config.rb +185 -48
- data/lib/clacky/server/channel/channel_manager.rb +247 -110
- data/lib/clacky/server/git_panel.rb +2 -1
- data/lib/clacky/server/http_server.rb +517 -175
- data/lib/clacky/server/preview.rb +26 -5
- data/lib/clacky/server/scheduler.rb +166 -85
- data/lib/clacky/server/web_ui_controller.rb +12 -0
- data/lib/clacky/session_manager.rb +4 -1
- data/lib/clacky/skill.rb +1 -1
- data/lib/clacky/tools/base.rb +7 -1
- data/lib/clacky/ui_interface.rb +5 -0
- data/lib/clacky/utils/file_processor.rb +23 -11
- data/lib/clacky/utils/model_pricing.rb +19 -0
- data/lib/clacky/version.rb +1 -1
- data/lib/clacky/web/app.css +621 -52
- data/lib/clacky/web/app.js +103 -9
- data/lib/clacky/web/components/code-editor.js +73 -4
- data/lib/clacky/web/components/custom-select.js +7 -18
- data/lib/clacky/web/components/hint-tip.js +172 -0
- data/lib/clacky/web/components/model-picker.js +1 -1
- data/lib/clacky/web/components/notify.js +37 -10
- data/lib/clacky/web/components/onboard.js +1 -1
- data/lib/clacky/web/components/sidebar.js +70 -0
- data/lib/clacky/web/features/backup/store.js +64 -27
- data/lib/clacky/web/features/backup/view.js +42 -11
- data/lib/clacky/web/features/channels/store.js +19 -4
- data/lib/clacky/web/features/channels/view.js +94 -33
- data/lib/clacky/web/features/extensions/view.js +15 -8
- data/lib/clacky/web/features/new-session/view.js +33 -22
- data/lib/clacky/web/features/profile/view.js +4 -4
- data/lib/clacky/web/features/tasks/store.js +5 -3
- data/lib/clacky/web/features/tasks/view.js +99 -26
- data/lib/clacky/web/features/trash/view.js +4 -4
- data/lib/clacky/web/features/workspace/view.js +193 -57
- data/lib/clacky/web/i18n.js +189 -17
- data/lib/clacky/web/index.html +165 -53
- data/lib/clacky/web/projects.js +15 -2
- data/lib/clacky/web/sessions.js +316 -86
- data/lib/clacky/web/settings.js +304 -75
- data/lib/clacky/web/utils.js +261 -0
- data/lib/clacky/web/ws-dispatcher.js +24 -3
- data/lib/clacky/web/ws.js +16 -4
- data/lib/clacky/work/service.rb +544 -0
- data/lib/clacky/work/store.rb +57 -0
- data/lib/clacky.rb +1 -0
- metadata +35 -1
|
@@ -0,0 +1,209 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
3
|
+
require "json"
|
|
4
|
+
|
|
5
|
+
module Clacky
|
|
6
|
+
class Agent
|
|
7
|
+
# Automatic long-term memory injection (opt-in: memory_inject_enabled).
|
|
8
|
+
#
|
|
9
|
+
# Before each user message a picker model (the provider's lite model, else
|
|
10
|
+
# the primary) selects relevant files from a wide memories listing
|
|
11
|
+
# (+load_memories_meta+); their bodies are appended as a system_injected
|
|
12
|
+
# user message. Append-only keeps the prompt-cache prefix intact. Files
|
|
13
|
+
# already injected on the active task chain are skipped; compression drops
|
|
14
|
+
# those messages, which naturally allows re-injection later.
|
|
15
|
+
#
|
|
16
|
+
# Best-effort: any failure is logged and the turn proceeds without memories.
|
|
17
|
+
module MemoryInjector
|
|
18
|
+
MEMORY_INJECT_MAX_FILES = 3
|
|
19
|
+
MEMORY_INJECT_FILE_BYTES = 4096
|
|
20
|
+
MEMORY_INJECT_STALE_DAYS = 30
|
|
21
|
+
MEMORY_PICKER_PREV_REPLY_CHARS = 600
|
|
22
|
+
MEMORY_PICKER_USER_CHARS = 2000
|
|
23
|
+
# Thinking models spend part of this budget on reasoning; 200 truncated the JSON.
|
|
24
|
+
MEMORY_PICKER_MAX_TOKENS = 1024
|
|
25
|
+
MEMORY_PICKER_READ_TIMEOUT = 20
|
|
26
|
+
# The picker can't grep, so it needs a far wider view than the
|
|
27
|
+
# 20-file LRU shortlist the recall/persist skills get.
|
|
28
|
+
MEMORY_PICKER_LISTING_LIMIT = 200
|
|
29
|
+
|
|
30
|
+
MEMORY_PICKER_SYSTEM_PROMPT = <<~PROMPT
|
|
31
|
+
You select long-term memory files relevant to the user's latest message.
|
|
32
|
+
A memory is relevant only if it would change how the assistant handles this message
|
|
33
|
+
(preferences, conventions, project facts, prior decisions). Skip loosely related ones.
|
|
34
|
+
Reply with JSON only: {"files": ["<filename>.md"]} using at most #{MEMORY_INJECT_MAX_FILES} filenames from the list.
|
|
35
|
+
Reply {"files": []} when nothing is relevant (greetings, acknowledgements, small talk).
|
|
36
|
+
PROMPT
|
|
37
|
+
|
|
38
|
+
private def inject_relevant_memories(user_input, task_id:)
|
|
39
|
+
return unless @config.memory_inject_enabled
|
|
40
|
+
return if @is_subagent
|
|
41
|
+
|
|
42
|
+
message = user_input.to_s.strip
|
|
43
|
+
return if message.empty?
|
|
44
|
+
return if Dir.glob(File.join(memories_base_dir, "*.md")).empty?
|
|
45
|
+
|
|
46
|
+
visible = memory_visible_messages
|
|
47
|
+
picked = pick_relevant_memories(message, visible) - injected_memory_files(visible)
|
|
48
|
+
return if picked.empty?
|
|
49
|
+
|
|
50
|
+
@history.append({
|
|
51
|
+
role: "user",
|
|
52
|
+
content: build_memory_reminder(picked),
|
|
53
|
+
system_injected: true,
|
|
54
|
+
memory_recall: true,
|
|
55
|
+
memory_files: picked,
|
|
56
|
+
task_id: task_id
|
|
57
|
+
})
|
|
58
|
+
rescue StandardError => e
|
|
59
|
+
Clacky::Logger.warn("memory_inject.failed", error: e)
|
|
60
|
+
end
|
|
61
|
+
|
|
62
|
+
# Messages on the active task chain, so undone branches neither count as
|
|
63
|
+
# injected nor feed the picker.
|
|
64
|
+
private def memory_visible_messages
|
|
65
|
+
chain = active_task_chain
|
|
66
|
+
@history.to_a.select { |m| !m[:task_id] || chain.include?(m[:task_id]) }
|
|
67
|
+
end
|
|
68
|
+
|
|
69
|
+
private def injected_memory_files(messages)
|
|
70
|
+
messages.select { |m| m[:memory_recall] }.flat_map { |m| Array(m[:memory_files]) }.uniq
|
|
71
|
+
end
|
|
72
|
+
|
|
73
|
+
private def pick_relevant_memories(message, visible)
|
|
74
|
+
model = memory_picker_model
|
|
75
|
+
# send_messages_with_tools rather than send_messages: only it returns usage.
|
|
76
|
+
response = memory_picker_client(model).send_messages_with_tools(
|
|
77
|
+
[
|
|
78
|
+
{ role: "system", content: MEMORY_PICKER_SYSTEM_PROMPT },
|
|
79
|
+
{ role: "user", content: memory_picker_prompt(message, visible) }
|
|
80
|
+
],
|
|
81
|
+
model: model,
|
|
82
|
+
tools: [],
|
|
83
|
+
max_tokens: MEMORY_PICKER_MAX_TOKENS
|
|
84
|
+
)
|
|
85
|
+
track_auxiliary_cost(response[:usage], model: response[:routed_model] || model) if response[:usage]
|
|
86
|
+
if response[:finish_reason] == "length"
|
|
87
|
+
Clacky::Logger.warn("memory_inject.picker_truncated", model: model, max_tokens: MEMORY_PICKER_MAX_TOKENS)
|
|
88
|
+
end
|
|
89
|
+
parse_memory_picker_reply(response[:content].to_s)
|
|
90
|
+
.select { |name| memory_file_name?(name) }
|
|
91
|
+
.uniq
|
|
92
|
+
.first(MEMORY_INJECT_MAX_FILES)
|
|
93
|
+
end
|
|
94
|
+
|
|
95
|
+
private def memory_picker_model
|
|
96
|
+
lite = @config.lite_model_config_for_current
|
|
97
|
+
(lite && lite["model"]) || current_model
|
|
98
|
+
end
|
|
99
|
+
|
|
100
|
+
# A dedicated client so a slow picker gives up quickly instead of holding
|
|
101
|
+
# the turn for the main client's 300s read timeout.
|
|
102
|
+
private def memory_picker_client(model)
|
|
103
|
+
lite = @config.lite_model_config_for_current
|
|
104
|
+
if lite
|
|
105
|
+
Clacky::Client.new(
|
|
106
|
+
lite["api_key"],
|
|
107
|
+
base_url: lite["base_url"],
|
|
108
|
+
model: model,
|
|
109
|
+
anthropic_format: lite["anthropic_format"] == true,
|
|
110
|
+
read_timeout: MEMORY_PICKER_READ_TIMEOUT
|
|
111
|
+
)
|
|
112
|
+
else
|
|
113
|
+
Clacky::Client.new(
|
|
114
|
+
@config.api_key,
|
|
115
|
+
base_url: @config.base_url,
|
|
116
|
+
model: model,
|
|
117
|
+
anthropic_format: @config.anthropic_format?,
|
|
118
|
+
api_format: @config.api_format,
|
|
119
|
+
read_timeout: MEMORY_PICKER_READ_TIMEOUT
|
|
120
|
+
)
|
|
121
|
+
end
|
|
122
|
+
end
|
|
123
|
+
|
|
124
|
+
private def memory_picker_prompt(message, visible)
|
|
125
|
+
<<~PROMPT
|
|
126
|
+
#{load_memories_meta(limit: MEMORY_PICKER_LISTING_LIMIT)}
|
|
127
|
+
|
|
128
|
+
Previous assistant reply (excerpt):
|
|
129
|
+
#{previous_reply_excerpt(last_assistant_reply_text(visible))}
|
|
130
|
+
|
|
131
|
+
User message:
|
|
132
|
+
#{message[0, MEMORY_PICKER_USER_CHARS]}
|
|
133
|
+
PROMPT
|
|
134
|
+
end
|
|
135
|
+
|
|
136
|
+
# Long replies open with the conclusion but close with the question the
|
|
137
|
+
# user is answering, so keep both ends.
|
|
138
|
+
private def previous_reply_excerpt(text)
|
|
139
|
+
return "(none)" if text.empty?
|
|
140
|
+
|
|
141
|
+
limit = MEMORY_PICKER_PREV_REPLY_CHARS
|
|
142
|
+
return text if text.length <= limit
|
|
143
|
+
|
|
144
|
+
half = limit / 2
|
|
145
|
+
"#{text[0, half]}\n...\n#{text[-half, half]}"
|
|
146
|
+
end
|
|
147
|
+
|
|
148
|
+
private def parse_memory_picker_reply(text)
|
|
149
|
+
json = begin
|
|
150
|
+
JSON.parse(text)
|
|
151
|
+
rescue JSON::ParserError
|
|
152
|
+
match = text.match(/\{.*\}/m)
|
|
153
|
+
match ? (JSON.parse(match[0]) rescue nil) : nil
|
|
154
|
+
end
|
|
155
|
+
files = json.is_a?(Hash) ? json["files"] : nil
|
|
156
|
+
files.is_a?(Array) ? files.map(&:to_s) : []
|
|
157
|
+
end
|
|
158
|
+
|
|
159
|
+
# Bare filename that exists in the memories dir; rejects hallucinated
|
|
160
|
+
# names and any path components.
|
|
161
|
+
private def memory_file_name?(name)
|
|
162
|
+
name.end_with?(".md") && File.basename(name) == name &&
|
|
163
|
+
File.file?(File.join(memories_base_dir, name))
|
|
164
|
+
end
|
|
165
|
+
|
|
166
|
+
private def last_assistant_reply_text(visible)
|
|
167
|
+
msg = visible.reverse.find { |m| m[:role] == "assistant" && !m[:content].to_s.strip.empty? }
|
|
168
|
+
return "" unless msg
|
|
169
|
+
|
|
170
|
+
content = msg[:content]
|
|
171
|
+
text = if content.is_a?(Array)
|
|
172
|
+
content.map { |b| b.is_a?(Hash) ? (b[:text] || b["text"]).to_s : "" }.join("\n")
|
|
173
|
+
else
|
|
174
|
+
content.to_s
|
|
175
|
+
end
|
|
176
|
+
text.strip
|
|
177
|
+
end
|
|
178
|
+
|
|
179
|
+
private def build_memory_reminder(names)
|
|
180
|
+
parts = [
|
|
181
|
+
"<system-reminder>",
|
|
182
|
+
"Relevant long-term memories (auto-selected from ~/.clacky/memories/). " \
|
|
183
|
+
"Apply them where they fit; the user's current instructions take precedence.",
|
|
184
|
+
""
|
|
185
|
+
]
|
|
186
|
+
names.each do |name|
|
|
187
|
+
path = File.join(memories_base_dir, name)
|
|
188
|
+
mtime = File.mtime(path)
|
|
189
|
+
parts << "## #{name} (last updated #{mtime.strftime("%Y-%m-%d")})"
|
|
190
|
+
parts << memory_inject_body(path)
|
|
191
|
+
age_days = ((Time.now - mtime) / 86_400).floor
|
|
192
|
+
if age_days > MEMORY_INJECT_STALE_DAYS
|
|
193
|
+
parts << "(This memory is #{age_days} days old; verify it against the current state before relying on it.)"
|
|
194
|
+
end
|
|
195
|
+
parts << ""
|
|
196
|
+
end
|
|
197
|
+
parts << "</system-reminder>"
|
|
198
|
+
parts.join("\n")
|
|
199
|
+
end
|
|
200
|
+
|
|
201
|
+
private def memory_inject_body(path)
|
|
202
|
+
body = File.read(path, encoding: "UTF-8").sub(/\A---\n.*?\n---\n*/m, "").strip
|
|
203
|
+
return body if body.bytesize <= MEMORY_INJECT_FILE_BYTES
|
|
204
|
+
|
|
205
|
+
"#{body.byteslice(0, MEMORY_INJECT_FILE_BYTES).scrub("")}\n...(truncated; read #{path} for the rest)"
|
|
206
|
+
end
|
|
207
|
+
end
|
|
208
|
+
end
|
|
209
|
+
end
|
|
@@ -188,6 +188,22 @@ module Clacky
|
|
|
188
188
|
- Any task that produced no lasting decisions or preferences
|
|
189
189
|
- Repeating or slightly rephrasing what is already in memory
|
|
190
190
|
|
|
191
|
+
## Never persist what can be re-derived
|
|
192
|
+
|
|
193
|
+
Code and git are the source of truth; a memory that copies them goes stale
|
|
194
|
+
silently and later misleads. Do NOT persist:
|
|
195
|
+
|
|
196
|
+
- Code structure, architecture, file paths, class/method names, line numbers
|
|
197
|
+
- Implementation details of a feature that was just built or changed
|
|
198
|
+
- Git history, change logs, PR contents, or "what was modified"
|
|
199
|
+
- Debugging steps, root-cause narratives, or how a bug was fixed
|
|
200
|
+
- Content already in project rules or docs (.clackyrules, README, AGENTS.md, etc.)
|
|
201
|
+
- Temporary task state, progress, or TODOs of the current conversation
|
|
202
|
+
|
|
203
|
+
If a session's only takeaways fall into this list, write nothing. When a
|
|
204
|
+
whitelisted item involves code, persist only the decision and its reason,
|
|
205
|
+
not the implementation.
|
|
206
|
+
|
|
191
207
|
═══════════════════════════════════════════════════════════════
|
|
192
208
|
EXECUTOR MANUAL (from persist-memory skill)
|
|
193
209
|
═══════════════════════════════════════════════════════════════
|
|
@@ -20,7 +20,13 @@ module Clacky
|
|
|
20
20
|
@archived_at = session_data[:archived_at]
|
|
21
21
|
@history = MessageHistory.new(session_data[:messages] || [])
|
|
22
22
|
@input_queue = (session_data[:pending_inputs] || []).map do |entry|
|
|
23
|
-
|
|
23
|
+
options = (entry[:options] || {}).dup
|
|
24
|
+
# Old queued inputs stored both the references and their generated text.
|
|
25
|
+
legacy_references = options.delete(:references_display)
|
|
26
|
+
unless Array(legacy_references).empty?
|
|
27
|
+
options[:reference_contexts] = Array(legacy_references) + Array(options[:reference_contexts])
|
|
28
|
+
end
|
|
29
|
+
entry.reject { |key, _| key == :steer_target }.merge(delivery: "queue", options: options)
|
|
24
30
|
end
|
|
25
31
|
@accepting_steering = false
|
|
26
32
|
@todos = session_data[:todos] || [] # Restore todos from session
|
|
@@ -136,17 +142,15 @@ module Clacky
|
|
|
136
142
|
model_entry = @config.find_model_by_name_and_url(saved_model_name, saved_base_url)
|
|
137
143
|
if model_entry && model_entry["id"]
|
|
138
144
|
switch_model_by_id(model_entry["id"])
|
|
139
|
-
end
|
|
140
|
-
end
|
|
141
145
|
|
|
142
|
-
|
|
143
|
-
|
|
144
|
-
|
|
145
|
-
|
|
146
|
-
|
|
147
|
-
|
|
148
|
-
|
|
149
|
-
|
|
146
|
+
# The sub-model pin belongs to the saved card's provider, so it is
|
|
147
|
+
# only re-applied when that card was found; on the fallback card it
|
|
148
|
+
# would pair a foreign model name with the wrong credentials.
|
|
149
|
+
saved_sub_model = session_data.dig(:config, :sub_model)
|
|
150
|
+
if saved_sub_model && !saved_sub_model.to_s.empty?
|
|
151
|
+
set_session_sub_model(saved_sub_model)
|
|
152
|
+
end
|
|
153
|
+
end
|
|
150
154
|
end
|
|
151
155
|
|
|
152
156
|
# Rebuild and refresh the system prompt so any newly installed skills
|
|
@@ -98,6 +98,14 @@ module Clacky
|
|
|
98
98
|
# so excessive mcp.json entries don't quietly bloat the system prompt.
|
|
99
99
|
MAX_CONTEXT_MCP_SERVERS = 10
|
|
100
100
|
|
|
101
|
+
# Bounds on the memories listing injected into recall/persist-memory skills.
|
|
102
|
+
# The file cap is an LRU shortlist, not a hard limit: older files stay
|
|
103
|
+
# reachable via grep. Per-field caps stop one oversized frontmatter from
|
|
104
|
+
# bloating the whole list.
|
|
105
|
+
MAX_MEMORIES_META_FILES = 20
|
|
106
|
+
MAX_MEMORY_TOPIC_CHARS = 100
|
|
107
|
+
MAX_MEMORY_DESCRIPTION_CHARS = 150
|
|
108
|
+
|
|
101
109
|
# Process-wide deduper for the "skill context limit" warning so that
|
|
102
110
|
# every newly constructed Agent (sub-agents, retries, web turns…) doesn't
|
|
103
111
|
# re-emit the same line.
|
|
@@ -489,16 +497,18 @@ module Clacky
|
|
|
489
497
|
|
|
490
498
|
# Scan ~/.clacky/memories/ and return a formatted summary of all memory files.
|
|
491
499
|
# Parses YAML frontmatter (same pattern as Skill#parse_frontmatter) for each file.
|
|
500
|
+
# @param limit [Integer] max files listed, newest first
|
|
492
501
|
# @return [String] Formatted list of memory topics and descriptions
|
|
493
|
-
def load_memories_meta
|
|
502
|
+
def load_memories_meta(limit: MAX_MEMORIES_META_FILES)
|
|
494
503
|
memories_dir = memories_base_dir
|
|
495
504
|
return "(No long-term memories found.)" unless Dir.exist?(memories_dir)
|
|
496
505
|
|
|
497
|
-
|
|
498
|
-
|
|
499
|
-
|
|
500
|
-
|
|
501
|
-
|
|
506
|
+
all_files = Dir.glob(File.join(memories_dir, "*.md"))
|
|
507
|
+
.sort_by { |f| File.mtime(f) }
|
|
508
|
+
.reverse
|
|
509
|
+
return "(No long-term memories found.)" if all_files.empty?
|
|
510
|
+
|
|
511
|
+
files = all_files.first(limit)
|
|
502
512
|
|
|
503
513
|
lines = ["Available memory files in ~/.clacky/memories/:"]
|
|
504
514
|
lines << ""
|
|
@@ -506,8 +516,8 @@ module Clacky
|
|
|
506
516
|
files.each do |path|
|
|
507
517
|
filename = File.basename(path)
|
|
508
518
|
fm = parse_memory_frontmatter(path)
|
|
509
|
-
topic = fm["topic"]
|
|
510
|
-
description = fm["description"] || "(no description)"
|
|
519
|
+
topic = truncate_memory_field(fm["topic"] || filename.sub(/\.md$/, ""), MAX_MEMORY_TOPIC_CHARS)
|
|
520
|
+
description = truncate_memory_field(fm["description"] || "(no description)", MAX_MEMORY_DESCRIPTION_CHARS)
|
|
511
521
|
# Use file mtime as the "last seen" signal (covers both writes and
|
|
512
522
|
# touch-on-recall LRU bumps). Authoritative — no longer relies on
|
|
513
523
|
# an LLM-maintained `updated_at` frontmatter field.
|
|
@@ -518,9 +528,21 @@ module Clacky
|
|
|
518
528
|
lines << entry
|
|
519
529
|
end
|
|
520
530
|
|
|
531
|
+
omitted = all_files.size - files.size
|
|
532
|
+
if omitted > 0
|
|
533
|
+
lines << ""
|
|
534
|
+
lines << "(#{omitted} older memories not listed — search ~/.clacky/memories/ with grep if needed)"
|
|
535
|
+
end
|
|
536
|
+
|
|
521
537
|
lines.join("\n")
|
|
522
538
|
end
|
|
523
539
|
|
|
540
|
+
# Collapse to a single line so each memory occupies exactly one entry in the listing.
|
|
541
|
+
private def truncate_memory_field(value, max_chars)
|
|
542
|
+
text = value.to_s.gsub(/\s+/, " ").strip
|
|
543
|
+
text.length > max_chars ? "#{text[0, max_chars]}…" : text
|
|
544
|
+
end
|
|
545
|
+
|
|
524
546
|
# Base directory for long-term memories. Override in tests for isolation.
|
|
525
547
|
# @return [String]
|
|
526
548
|
def memories_base_dir
|