@yeaft/webchat-agent 0.1.663 → 0.1.664

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.
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@yeaft/webchat-agent",
3
- "version": "0.1.663",
3
+ "version": "0.1.664",
4
4
  "description": "Remote agent for Yeaft WebChat — connects worker machines to the central server",
5
5
  "main": "index.js",
6
6
  "type": "module",
package/unify/index.js CHANGED
@@ -26,7 +26,6 @@ export { MemoryStore, parseEntry, serializeEntry, MEMORY_KINDS } from './memory/
26
26
 
27
27
  // Phase 5: Advanced features
28
28
  export { KINDS, KIND_PRIORITY, KIND_DESCRIPTIONS, IMPORTANCE_LEVELS, validateEntry, parseScopePath, getAncestorScopes, areScopesRelated } from './memory/types.js';
29
- export { scanEntries, scoreEntry, findStaleEntries, findDuplicateGroups, summarizeScan } from './memory/scan.js';
30
29
  export { runStopHooks } from './stop-hooks.js';
31
30
  export { MCPManager, createMCPManager } from './mcp.js';
32
31
  export { SkillManager, createSkillManager, parseSkill, serializeSkill } from './skills.js';
package/unify/init.js CHANGED
@@ -79,7 +79,6 @@ const SUBDIRS = [
79
79
  'conversation/blobs',
80
80
  'memory/entries',
81
81
  'tasks',
82
- 'dream',
83
82
  'skills',
84
83
  ];
85
84
 
@@ -1,273 +0,0 @@
1
- /**
2
- * scan.js — Memory header scanning and scope/tag matching
3
- *
4
- * Fast in-memory scanning of entry frontmatter for:
5
- * - Scope tree traversal
6
- * - Tag overlap scoring
7
- * - Kind-based filtering
8
- * - Stale entry detection (for Dream)
9
- *
10
- * Reference: yeaft-unify-core-systems.md §3.3, yeaft-unify-design.md §5.1
11
- */
12
-
13
- import { KINDS, KIND_PRIORITY, IMPORTANCE_WEIGHT, getAncestorScopes } from './types.js';
14
-
15
- // ─── Scan Results ──────────────────────────────────────────
16
-
17
- /**
18
- * @typedef {Object} ScanResult
19
- * @property {object[]} entries — all parsed entries
20
- * @property {Map<string, number>} scopeCount — scope → entry count
21
- * @property {Map<string, number>} kindCount — kind → entry count
22
- * @property {Map<string, Set<string>>} tagIndex — tag → set of entry names
23
- * @property {number} totalEntries — total count
24
- */
25
-
26
- /**
27
- * Scan all entries from a MemoryStore and build indexes.
28
- *
29
- * @param {import('./store.js').MemoryStore} memoryStore
30
- * @returns {ScanResult}
31
- */
32
- export function scanEntries(memoryStore) {
33
- const entries = memoryStore.listEntries();
34
-
35
- const scopeCount = new Map();
36
- const kindCount = new Map();
37
- const tagIndex = new Map();
38
-
39
- for (const entry of entries) {
40
- // Scope count
41
- const scope = entry.scope || 'global';
42
- scopeCount.set(scope, (scopeCount.get(scope) || 0) + 1);
43
-
44
- // Kind count
45
- const kind = entry.kind || 'fact';
46
- kindCount.set(kind, (kindCount.get(kind) || 0) + 1);
47
-
48
- // Tag index
49
- const tags = entry.tags || [];
50
- for (const tag of tags) {
51
- const lowerTag = tag.toLowerCase();
52
- if (!tagIndex.has(lowerTag)) tagIndex.set(lowerTag, new Set());
53
- tagIndex.get(lowerTag).add(entry.name);
54
- }
55
- }
56
-
57
- return {
58
- entries,
59
- scopeCount,
60
- kindCount,
61
- tagIndex,
62
- totalEntries: entries.length,
63
- };
64
- }
65
-
66
- // ─── Scoring Functions ─────────────────────────────────────
67
-
68
- /**
69
- * Score an entry for relevance to a query context.
70
- *
71
- * Scoring factors:
72
- * - Scope match: exact=5, parent/child=3, global=1
73
- * - Tag overlap: 2 per matching tag
74
- * - Kind priority: see KIND_PRIORITY
75
- * - Importance weight: see IMPORTANCE_WEIGHT
76
- * - Frequency bonus: log2(frequency)
77
- * - Recency bonus: entries updated in last 7 days get +2
78
- *
79
- * @param {object} entry — memory entry
80
- * @param {{ scope?: string, tags?: string[], preferKinds?: string[] }} context
81
- * @returns {number} — relevance score
82
- */
83
- export function scoreEntry(entry, context = {}) {
84
- let score = 0;
85
-
86
- // Scope match
87
- if (context.scope && entry.scope) {
88
- if (entry.scope === context.scope) {
89
- score += 5; // exact match
90
- } else {
91
- const ancestors = getAncestorScopes(context.scope);
92
- if (ancestors.includes(entry.scope)) {
93
- score += 3; // ancestor match
94
- } else if (entry.scope.startsWith(context.scope + '/')) {
95
- score += 3; // descendant match
96
- } else if (entry.scope === 'global') {
97
- score += 1; // global fallback
98
- }
99
- }
100
- }
101
-
102
- // Tag overlap
103
- if (context.tags && context.tags.length > 0 && entry.tags) {
104
- const entryTags = new Set(entry.tags.map(t => t.toLowerCase()));
105
- for (const tag of context.tags) {
106
- if (entryTags.has(tag.toLowerCase())) {
107
- score += 2;
108
- }
109
- }
110
- }
111
-
112
- // Kind priority
113
- const kindPriority = KIND_PRIORITY[entry.kind] || 0;
114
- score += kindPriority * 0.5;
115
-
116
- // Preferred kinds bonus
117
- if (context.preferKinds && context.preferKinds.includes(entry.kind)) {
118
- score += 2;
119
- }
120
-
121
- // Importance weight
122
- const impWeight = IMPORTANCE_WEIGHT[entry.importance] || IMPORTANCE_WEIGHT.normal;
123
- score += impWeight * 0.5;
124
-
125
- // Frequency bonus (logarithmic)
126
- const freq = entry.frequency || 1;
127
- score += Math.log2(Math.max(freq, 1));
128
-
129
- // Recency bonus
130
- if (entry.updated_at) {
131
- const daysSince = (Date.now() - new Date(entry.updated_at).getTime()) / (1000 * 60 * 60 * 24);
132
- if (daysSince <= 7) score += 2;
133
- else if (daysSince <= 30) score += 1;
134
- }
135
-
136
- return score;
137
- }
138
-
139
- // ─── Stale Detection (for Dream) ────────────────────────────
140
-
141
- /**
142
- * Find entries that are potentially stale.
143
- *
144
- * Stale criteria:
145
- * - context entries older than 30 days
146
- * - entries never recalled (frequency = 1) and older than 60 days
147
- * - relation entries older than 90 days
148
- *
149
- * @param {object[]} entries
150
- * @returns {object[]} — stale entries
151
- */
152
- export function findStaleEntries(entries) {
153
- const now = Date.now();
154
- const stale = [];
155
-
156
- for (const entry of entries) {
157
- const updatedAt = entry.updated_at ? new Date(entry.updated_at).getTime() : 0;
158
- const daysSince = (now - updatedAt) / (1000 * 60 * 60 * 24);
159
-
160
- let isStale = false;
161
-
162
- // Context entries become stale fast
163
- if (entry.kind === 'context' && daysSince > 30) {
164
- isStale = true;
165
- }
166
-
167
- // Entries never recalled and old
168
- if ((entry.frequency || 1) <= 1 && daysSince > 60) {
169
- isStale = true;
170
- }
171
-
172
- // Relations are volatile
173
- if (entry.kind === 'relation' && daysSince > 90) {
174
- isStale = true;
175
- }
176
-
177
- if (isStale) {
178
- stale.push({ ...entry, _daysSinceUpdate: Math.round(daysSince) });
179
- }
180
- }
181
-
182
- return stale;
183
- }
184
-
185
- // ─── Duplicate Detection (for Dream Merge) ──────────────────
186
-
187
- /**
188
- * Find groups of entries that are potentially duplicates.
189
- * Entries are grouped if they share ≥2 tags AND the same kind.
190
- *
191
- * @param {object[]} entries
192
- * @returns {object[][]} — groups of potentially duplicate entries
193
- */
194
- export function findDuplicateGroups(entries) {
195
- const groups = [];
196
- const visited = new Set();
197
-
198
- for (let i = 0; i < entries.length; i++) {
199
- if (visited.has(i)) continue;
200
-
201
- const group = [entries[i]];
202
- const eTags = new Set((entries[i].tags || []).map(t => t.toLowerCase()));
203
-
204
- for (let j = i + 1; j < entries.length; j++) {
205
- if (visited.has(j)) continue;
206
- if (entries[i].kind !== entries[j].kind) continue;
207
-
208
- const jTags = new Set((entries[j].tags || []).map(t => t.toLowerCase()));
209
- let overlap = 0;
210
- for (const tag of eTags) {
211
- if (jTags.has(tag)) overlap++;
212
- }
213
-
214
- if (overlap >= 2) {
215
- group.push(entries[j]);
216
- visited.add(j);
217
- }
218
- }
219
-
220
- if (group.length > 1) {
221
- visited.add(i);
222
- groups.push(group);
223
- }
224
- }
225
-
226
- return groups;
227
- }
228
-
229
- // ─── Stats Summary ──────────────────────────────────────────
230
-
231
- /**
232
- * Generate a text summary of memory state (for Dream prompts).
233
- *
234
- * @param {ScanResult} scan
235
- * @returns {string}
236
- */
237
- export function summarizeScan(scan) {
238
- const lines = [];
239
-
240
- lines.push(`Total entries: ${scan.totalEntries}`);
241
-
242
- // Kind breakdown
243
- const kindLines = [];
244
- for (const kind of KINDS) {
245
- const count = scan.kindCount.get(kind) || 0;
246
- if (count > 0) kindLines.push(`${kind}: ${count}`);
247
- }
248
- if (kindLines.length > 0) {
249
- lines.push(`Kinds: ${kindLines.join(', ')}`);
250
- }
251
-
252
- // Scope breakdown (top 10)
253
- const scopeEntries = [...scan.scopeCount.entries()]
254
- .sort((a, b) => b[1] - a[1])
255
- .slice(0, 10);
256
- if (scopeEntries.length > 0) {
257
- lines.push('Top scopes:');
258
- for (const [scope, count] of scopeEntries) {
259
- lines.push(` ${scope}: ${count}`);
260
- }
261
- }
262
-
263
- // Tag cloud (top 20)
264
- const tagEntries = [...scan.tagIndex.entries()]
265
- .map(([tag, names]) => [tag, names.size])
266
- .sort((a, b) => b[1] - a[1])
267
- .slice(0, 20);
268
- if (tagEntries.length > 0) {
269
- lines.push(`Top tags: ${tagEntries.map(([t, c]) => `${t}(${c})`).join(', ')}`);
270
- }
271
-
272
- return lines.join('\n');
273
- }