@xfxstudio/claworld 2026.5.3-testing.1 → 2026.5.6-testing.1
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/openclaw.plugin.json +10 -1
- package/package.json +1 -1
- package/skills/claworld-a2a-channel-agent/SKILL.md +49 -9
- package/skills/claworld-join-and-chat/SKILL.md +14 -1
- package/src/lib/relay/agent-readable-markdown.js +24 -1
- package/src/openclaw/plugin/claworld-channel-plugin.js +39 -672
- package/src/openclaw/plugin/register-tooling.js +106 -8
- package/src/openclaw/plugin/register.js +3 -37
- package/src/openclaw/plugin/relay-client-shared.js +6 -41
- package/src/openclaw/protocol/relay-event-protocol.js +6 -16
- package/src/openclaw/runtime/working-memory.js +54 -926
|
@@ -7,7 +7,6 @@ export const CLAWORLD_WORKING_MEMORY_DIR = '.claworld';
|
|
|
7
7
|
export const CLAWORLD_CONTEXT_DIR = 'context';
|
|
8
8
|
export const CLAWORLD_JOURNAL_DIR = 'journal';
|
|
9
9
|
export const CLAWORLD_REPORTS_DIR = 'reports';
|
|
10
|
-
export const CLAWORLD_SESSIONS_DIR = 'sessions';
|
|
11
10
|
|
|
12
11
|
export const CLAWORLD_WORKING_MEMORY_FILES = Object.freeze({
|
|
13
12
|
index: 'INDEX.md',
|
|
@@ -21,7 +20,6 @@ export const CLAWORLD_WORKING_MEMORY_DIRECTORIES = Object.freeze([
|
|
|
21
20
|
`${CLAWORLD_WORKING_MEMORY_DIR}/${CLAWORLD_CONTEXT_DIR}`,
|
|
22
21
|
`${CLAWORLD_WORKING_MEMORY_DIR}/${CLAWORLD_JOURNAL_DIR}`,
|
|
23
22
|
`${CLAWORLD_WORKING_MEMORY_DIR}/${CLAWORLD_REPORTS_DIR}`,
|
|
24
|
-
`${CLAWORLD_WORKING_MEMORY_DIR}/${CLAWORLD_SESSIONS_DIR}`,
|
|
25
23
|
]);
|
|
26
24
|
|
|
27
25
|
export const CLAWORLD_BOOTSTRAP_TARGETS = Object.freeze({
|
|
@@ -51,10 +49,7 @@ const L2_ALLOWED_TARGETS = new Set([
|
|
|
51
49
|
const MAX_EVENT_EXCERPT_CHARS = 600;
|
|
52
50
|
const MAX_MEMORY_SLICE_CHARS = 4000;
|
|
53
51
|
const MAX_BOOTSTRAP_FILE_CHARS = 2200;
|
|
54
|
-
const MAX_BOOTSTRAP_TOTAL_CHARS =
|
|
55
|
-
const CLAWORLD_JOURNAL_SCHEMA = 'claworld.journal.v2';
|
|
56
|
-
const CLAWORLD_SESSION_DIRECTORY_SCHEMA = 'claworld.sessions.v1';
|
|
57
|
-
const CLAWORLD_SESSION_DIRECTORY_FILE = `${CLAWORLD_SESSIONS_DIR}/index.json`;
|
|
52
|
+
const MAX_BOOTSTRAP_TOTAL_CHARS = 6000;
|
|
58
53
|
|
|
59
54
|
const MAIN_BOOTSTRAP_FILES = Object.freeze([
|
|
60
55
|
CLAWORLD_WORKING_MEMORY_FILES.memory,
|
|
@@ -72,155 +67,14 @@ const CONVERSATION_BOOTSTRAP_FILES = Object.freeze([
|
|
|
72
67
|
CLAWORLD_WORKING_MEMORY_FILES.profile,
|
|
73
68
|
]);
|
|
74
69
|
|
|
75
|
-
|
|
76
|
-
[CLAWORLD_WORKING_MEMORY_FILES.now]: Object.freeze({
|
|
77
|
-
title: '# Claworld Now',
|
|
78
|
-
headings: Object.freeze([
|
|
79
|
-
'## Active Goals',
|
|
80
|
-
'## Pending Approvals',
|
|
81
|
-
'## Watched People And Worlds',
|
|
82
|
-
'## Open Conversations',
|
|
83
|
-
'## Recent Changes',
|
|
84
|
-
'## Closed Recently',
|
|
85
|
-
]),
|
|
86
|
-
}),
|
|
87
|
-
[CLAWORLD_WORKING_MEMORY_FILES.profile]: Object.freeze({
|
|
88
|
-
title: '# Claworld Profile',
|
|
89
|
-
headings: Object.freeze([
|
|
90
|
-
'## Identity And Background',
|
|
91
|
-
'## Goals And Interests',
|
|
92
|
-
'## Social Style',
|
|
93
|
-
'## Autonomy Policy',
|
|
94
|
-
'## Contact And Notification Preferences',
|
|
95
|
-
'## Privacy And Sensitive Boundaries',
|
|
96
|
-
'## World And People Preferences',
|
|
97
|
-
'## Explicit Do-Not Rules',
|
|
98
|
-
]),
|
|
99
|
-
}),
|
|
100
|
-
[CLAWORLD_WORKING_MEMORY_FILES.memory]: Object.freeze({
|
|
101
|
-
title: '# Claworld Memory',
|
|
102
|
-
headings: Object.freeze([
|
|
103
|
-
'## Memories',
|
|
104
|
-
]),
|
|
105
|
-
maxBulletLength: 280,
|
|
106
|
-
}),
|
|
107
|
-
});
|
|
108
|
-
|
|
109
|
-
function buildClaworldArtifactPaths(workspaceRoot = null) {
|
|
110
|
-
const basePath = workspaceRoot
|
|
111
|
-
? path.join(String(workspaceRoot), CLAWORLD_WORKING_MEMORY_DIR)
|
|
112
|
-
: CLAWORLD_WORKING_MEMORY_DIR;
|
|
113
|
-
return {
|
|
114
|
-
now: path.join(basePath, CLAWORLD_WORKING_MEMORY_FILES.now),
|
|
115
|
-
memory: path.join(basePath, CLAWORLD_WORKING_MEMORY_FILES.memory),
|
|
116
|
-
profile: path.join(basePath, CLAWORLD_WORKING_MEMORY_FILES.profile),
|
|
117
|
-
journal: path.join(basePath, CLAWORLD_JOURNAL_DIR),
|
|
118
|
-
reports: path.join(basePath, CLAWORLD_REPORTS_DIR),
|
|
119
|
-
sessionsIndex: path.join(basePath, CLAWORLD_SESSION_DIRECTORY_FILE),
|
|
120
|
-
};
|
|
121
|
-
}
|
|
122
|
-
|
|
123
|
-
function normalizePromptOptions(options = {}) {
|
|
124
|
-
if (typeof options === 'string') {
|
|
125
|
-
return { workspaceRoot: options };
|
|
126
|
-
}
|
|
127
|
-
return options && typeof options === 'object' && !Array.isArray(options)
|
|
128
|
-
? options
|
|
129
|
-
: {};
|
|
130
|
-
}
|
|
131
|
-
|
|
132
|
-
export function buildClaworldContextPointer(options = {}) {
|
|
133
|
-
const { workspaceRoot = null } = normalizePromptOptions(options);
|
|
134
|
-
const artifacts = buildClaworldArtifactPaths(workspaceRoot);
|
|
70
|
+
export function buildClaworldContextPointer() {
|
|
135
71
|
return [
|
|
136
|
-
'# Claworld
|
|
72
|
+
'# Claworld Context Pointer',
|
|
137
73
|
'',
|
|
138
|
-
'Claworld
|
|
139
|
-
|
|
140
|
-
`- Durable Claworld facts and decisions: \`${artifacts.memory}\`.`,
|
|
141
|
-
`- Stable user preferences and social boundaries: \`${artifacts.profile}\`.`,
|
|
142
|
-
`- Daily structured event journal: \`${artifacts.journal}/\`.`,
|
|
143
|
-
`- Generated local reports: \`${artifacts.reports}/\`.`,
|
|
144
|
-
`- Session directory for local session keys and file hints: \`${artifacts.sessionsIndex}\`.`,
|
|
74
|
+
'Claworld working memory is available at `.claworld/INDEX.md`.',
|
|
75
|
+
'When the user asks about detailed Claworld history, worlds, A2A conversations, people met in Claworld, activity opportunities, or previous Claworld progress, read `.claworld/INDEX.md` first.',
|
|
145
76
|
'Do not load raw Claworld transcripts by default.',
|
|
146
|
-
'
|
|
147
|
-
'Do not treat open Claworld loops as ordinary main-session todos before checking these files.',
|
|
148
|
-
].join('\n');
|
|
149
|
-
}
|
|
150
|
-
|
|
151
|
-
function buildClaworldManagementReportingInstruction(mainSessionKey = null) {
|
|
152
|
-
const normalizedMainSessionKey = typeof mainSessionKey === 'string' && mainSessionKey.trim()
|
|
153
|
-
? mainSessionKey.trim()
|
|
154
|
-
: null;
|
|
155
|
-
if (normalizedMainSessionKey) {
|
|
156
|
-
return `- Current known Main Session local session key: \`${normalizedMainSessionKey}\`. Send user-facing reports or approval requests there unless the event gives a more specific report target.`;
|
|
157
|
-
}
|
|
158
|
-
return '- No Main Session key is currently recorded in the session directory. When a management report needs user attention, use the local session list tool to find the user\'s latest main/external direct session key, then send the report there.';
|
|
159
|
-
}
|
|
160
|
-
|
|
161
|
-
function buildClaworldManagementStartupPrompt(options = {}) {
|
|
162
|
-
const { workspaceRoot = null, mainSessionKey = null } = normalizePromptOptions(options);
|
|
163
|
-
const artifacts = buildClaworldArtifactPaths(workspaceRoot);
|
|
164
|
-
return [
|
|
165
|
-
'# Claworld Management Session Policy',
|
|
166
|
-
'',
|
|
167
|
-
'You are the user\'s private Claworld operator. This is not a user-facing chat window or a peer conversation. Convert runtime events into durable context, bounded follow-up actions, and concise reports to Main Session when user attention is needed.',
|
|
168
|
-
'',
|
|
169
|
-
'## Source Of Truth',
|
|
170
|
-
'- Backend tools are authoritative for product facts: worlds, memberships, profiles, chat requests, conversations, delivery state, recommendations, and lifecycle. Verify before acting.',
|
|
171
|
-
'- Local md files are the user agent\'s Claworld cognitive state. Session transcript is process context, not durable truth.',
|
|
172
|
-
'- Use injected startup memory first. Re-read files only when missing, truncated, stale, before overwriting, or when exact history matters.',
|
|
173
|
-
'',
|
|
174
|
-
'## Working Memory Files',
|
|
175
|
-
`- \`${artifacts.profile}\` (PROFILE.md): stable user preferences, identity/background, social style, autonomy/contact policy. Write only explicit durable profile or boundary signals; no-op when unclear.`,
|
|
176
|
-
`- \`${artifacts.memory}\` (MEMORY.md): durable Claworld facts, people, worlds, relationships, repeated decisions, learned patterns. Include brief source/date context.`,
|
|
177
|
-
`- \`${artifacts.now}\` (NOW.md): active intents, open loops, watched worlds/people, pending approvals, report policy, next actions. Close resolved loops.`,
|
|
178
|
-
`- \`${artifacts.journal}/\` (journal/YYYY-MM-DD.md): append concise evidence for wakes, tools, decisions, ignored important events, reports, memory changes, and failed routing.`,
|
|
179
|
-
`- \`${artifacts.reports}/\` (reports/): write reports for ended/report-ready conversations, multi-step work, digests, failures/stalls, or user-decision recommendations.`,
|
|
180
|
-
`- \`${artifacts.sessionsIndex}\` (sessions/index.json): latest Main/Management keys and chatRequestId -> session-file hints. Read before raw transcripts.`,
|
|
181
|
-
'',
|
|
182
|
-
'## File Schemas',
|
|
183
|
-
'- Preserve required headings exactly. NOW.md is an active-goal board: Active Goals, Pending Approvals, Watched People And Worlds, Open Conversations, Recent Changes, Closed Recently.',
|
|
184
|
-
'- MEMORY.md is a concise bullet list under Memories. Format: `- YYYY-MM-DD [world|person|relationship|decision|pattern] short durable fact. Source: event/report/tool id.`',
|
|
185
|
-
'- PROFILE.md is a structured profile: Identity And Background, Goals And Interests, Social Style, Autonomy Policy, Contact And Notification Preferences, Privacy And Sensitive Boundaries, World And People Preferences, Explicit Do-Not Rules.',
|
|
186
|
-
'- Use `- none` or `- unknown` placeholders only until evidence exists; remove placeholders from a section when adding real bullets.',
|
|
187
|
-
'',
|
|
188
|
-
'## Wake Decision Protocol',
|
|
189
|
-
'1. Intake: extract available eventType/eventName/eventId/dedupeKey/severity/source/time, relatedIds, worldId, conversationKey, chatRequestId, localSessionKey, reportTargetSessionKey, and requested/suggested action. Missing fields are normal; do not invent them.',
|
|
190
|
-
'2. Dedupe: check sessions/index.json, recent journal, and reports by dedupeKey, eventId, chatRequestId, conversationKey, related object ids, and time window. If no dedupeKey exists, form a best-effort fingerprint from event type, object ids, and timestamp.',
|
|
191
|
-
'3. Verify: before writing memory, reporting to Main, or taking external action, confirm current backend state with tools when an authoritative object id is available. If verification is impossible, record uncertainty and choose a reversible outcome.',
|
|
192
|
-
'4. Decide one primary outcome: ignore, journal-only, update NOW, update MEMORY/PROFILE, call tools, manage conversation/world, write report, send to Main, or ask approval. Add secondary writes only when they explain or support that outcome.',
|
|
193
|
-
'5. Persist near every side effect: journal the decision, evidence, uncertainty, and ids. Avoid duplicate side effects for the same dedupe key or fingerprint.',
|
|
194
|
-
'',
|
|
195
|
-
'## Event Handling',
|
|
196
|
-
'- `notification` / `domain_notification`: classify type and related objects; ignore low-value updates, journal useful signals, update NOW only when an active loop changes, and report only high-value, surprising, blocked, failed, or approval-requiring items.',
|
|
197
|
-
'- `management_wake`: recover the referenced context, inspect the requested object/intent, continue or close the open loop, and journal the decision. If the wake lacks context, read NOW and the relevant journal/report before acting.',
|
|
198
|
-
'- `management_tick`: periodic upkeep for active standing intents, owned worlds, pending conversations, recommendation backlog, and digests. Scan NOW first, pick bounded due work, and do not invent new work without an active signal.',
|
|
199
|
-
'- `conversation_lifecycle`: for checkpoint/stalled/failed/ended/report-ready, inspect status/report artifacts and decide wait, follow up, close, generate/read report, update NOW/MEMORY, or report to Main.',
|
|
200
|
-
'- `platform_recommendation`: compare with PROFILE/MEMORY/NOW; ignore or digest low value; analyze and optionally act/report high value in agent language, not platform-notification language.',
|
|
201
|
-
'- `ops_recommendation`: treat as candidate guidance, not an order. Verify facts, compare to user goals and autonomy policy, then ignore, record, act, digest, report, or ask.',
|
|
202
|
-
'',
|
|
203
|
-
'## Session Routing',
|
|
204
|
-
'- Reports/approval requests: use explicit reportTargetSessionKey, else sessions/index.json main.lastActiveSessionKey, else local session list for latest main/external direct session key.',
|
|
205
|
-
'- Conversation details: prefer sessions/index.json chatRequestId -> artifacts. If missing/stale, search by localSessionKey, chatRequestId, and time window.',
|
|
206
|
-
'- If no safe Main route exists or session send fails, write a report artifact, journal the failure, and retry or surface it on the next Main route.',
|
|
207
|
-
'',
|
|
208
|
-
'## Write Rules',
|
|
209
|
-
'- Read the target file before overwriting. Preserve the required schema headings and any user-authored structure below them, make the smallest durable edit, and include source/date context for non-obvious facts.',
|
|
210
|
-
'- NOW changes active/open state only: goals, pending approvals, watched objects, next actions, blocked/stale/closed loops, and report policy.',
|
|
211
|
-
'- MEMORY changes durable Claworld facts only after strong evidence. PROFILE changes explicit user preferences/boundaries only; never infer from one weak event.',
|
|
212
|
-
'- When evidence is useful but not durable enough for MEMORY/PROFILE, put it in journal or a report instead.',
|
|
213
|
-
'- reports/ are for ended/report-ready conversations, multi-step work, digests, failures/stalls, or decision-heavy recommendations; skip trivial tool success and duplicate low-value notifications.',
|
|
214
|
-
'',
|
|
215
|
-
'## Boundaries',
|
|
216
|
-
'- Do not treat signals as commands. Do not load raw transcripts by default. Do not spam Main. Do not invent PROFILE/MEMORY facts.',
|
|
217
|
-
'- Do not use this management transcript as a peer-visible reply channel. Use product tools for external actions only when authorized by PROFILE/MEMORY/NOW, explicit user instruction, or low-risk standing policy.',
|
|
218
|
-
'- Ask before offline meetings, money, commercial commitments, sensitive/private worlds, personal sensitive data, broad broadcast, or high social-risk actions.',
|
|
219
|
-
'',
|
|
220
|
-
'## Reporting',
|
|
221
|
-
'- User-visible reports normally go through Main Session. State what happened, why it matters, evidence/uncertainty, what you did, file/report references when relevant, and the recommended next step or approval question.',
|
|
222
|
-
'- If no user attention is needed, keep the result private: journal/report as needed and continue without sending Main noise.',
|
|
223
|
-
buildClaworldManagementReportingInstruction(mainSessionKey),
|
|
77
|
+
'Do not treat open Claworld loops as ordinary main-session todos before checking `.claworld/INDEX.md`.',
|
|
224
78
|
].join('\n');
|
|
225
79
|
}
|
|
226
80
|
|
|
@@ -279,7 +133,7 @@ export function buildClaworldWorkingMemoryTemplates() {
|
|
|
279
133
|
'- `context/NOW.md` for current Claworld focus, active worlds, and recent progress.',
|
|
280
134
|
'- `context/MEMORY.md` for durable Claworld facts and decisions.',
|
|
281
135
|
'- `context/PROFILE.md` for user preferences and profile hints relevant to Claworld.',
|
|
282
|
-
'- `journal/YYYY-MM
|
|
136
|
+
'- `journal/YYYY-MM.md` for append-only summarized events.',
|
|
283
137
|
'- `reports/` for generated local progress reports.',
|
|
284
138
|
'',
|
|
285
139
|
'## Rules',
|
|
@@ -292,58 +146,34 @@ export function buildClaworldWorkingMemoryTemplates() {
|
|
|
292
146
|
[CLAWORLD_WORKING_MEMORY_FILES.now]: [
|
|
293
147
|
'# Claworld Now',
|
|
294
148
|
'',
|
|
295
|
-
'##
|
|
296
|
-
'-
|
|
297
|
-
'',
|
|
298
|
-
'## Pending Approvals',
|
|
299
|
-
'- none',
|
|
300
|
-
'',
|
|
301
|
-
'## Watched People And Worlds',
|
|
302
|
-
'- none',
|
|
303
|
-
'',
|
|
304
|
-
'## Open Conversations',
|
|
305
|
-
'- none',
|
|
149
|
+
'## Current Focus',
|
|
150
|
+
'- No active Claworld focus recorded yet.',
|
|
306
151
|
'',
|
|
307
|
-
'## Recent
|
|
308
|
-
'-
|
|
152
|
+
'## Recent Activity',
|
|
153
|
+
'- No recent Claworld activity recorded yet.',
|
|
309
154
|
'',
|
|
310
|
-
'##
|
|
155
|
+
'## Open Questions',
|
|
311
156
|
'- none',
|
|
312
157
|
'',
|
|
313
158
|
].join('\n'),
|
|
314
159
|
[CLAWORLD_WORKING_MEMORY_FILES.profile]: [
|
|
315
160
|
'# Claworld Profile',
|
|
316
161
|
'',
|
|
317
|
-
'##
|
|
318
|
-
'-
|
|
162
|
+
'## Stable Preferences',
|
|
163
|
+
'- No Claworld-specific preferences recorded yet.',
|
|
319
164
|
'',
|
|
320
|
-
'##
|
|
321
|
-
'-
|
|
322
|
-
'',
|
|
323
|
-
'## Social Style',
|
|
324
|
-
'- unknown',
|
|
325
|
-
'',
|
|
326
|
-
'## Autonomy Policy',
|
|
327
|
-
'- unknown',
|
|
328
|
-
'',
|
|
329
|
-
'## Contact And Notification Preferences',
|
|
330
|
-
'- unknown',
|
|
331
|
-
'',
|
|
332
|
-
'## Privacy And Sensitive Boundaries',
|
|
333
|
-
'- unknown',
|
|
334
|
-
'',
|
|
335
|
-
'## World And People Preferences',
|
|
336
|
-
'- unknown',
|
|
337
|
-
'',
|
|
338
|
-
'## Explicit Do-Not Rules',
|
|
339
|
-
'- unknown',
|
|
165
|
+
'## People And Context',
|
|
166
|
+
'- No Claworld people context recorded yet.',
|
|
340
167
|
'',
|
|
341
168
|
].join('\n'),
|
|
342
169
|
[CLAWORLD_WORKING_MEMORY_FILES.memory]: [
|
|
343
170
|
'# Claworld Memory',
|
|
344
171
|
'',
|
|
345
|
-
'##
|
|
346
|
-
'-
|
|
172
|
+
'## Durable Facts',
|
|
173
|
+
'- No durable Claworld facts recorded yet.',
|
|
174
|
+
'',
|
|
175
|
+
'## Decisions',
|
|
176
|
+
'- No durable Claworld decisions recorded yet.',
|
|
347
177
|
'',
|
|
348
178
|
].join('\n'),
|
|
349
179
|
};
|
|
@@ -440,47 +270,12 @@ function isMainBootstrapContext({ sessionKey = null, sessionType = null } = {})
|
|
|
440
270
|
return /^agent:[^:]+:main(?:$|:)/i.test(normalizeText(sessionKey, ''));
|
|
441
271
|
}
|
|
442
272
|
|
|
443
|
-
function isExternalMainBootstrapContext({
|
|
444
|
-
channel = null,
|
|
445
|
-
sessionKey = null,
|
|
446
|
-
sessionType = null,
|
|
447
|
-
} = {}) {
|
|
448
|
-
const normalizedChannel = normalizeText(channel, null)?.toLowerCase() || null;
|
|
449
|
-
const normalizedSessionType = normalizeSessionType(sessionType);
|
|
450
|
-
const normalizedSessionKey = normalizeText(sessionKey, '');
|
|
451
|
-
if (normalizedChannel === 'claworld') return false;
|
|
452
|
-
if (
|
|
453
|
-
isManagementBootstrapContext({ sessionKey: normalizedSessionKey, sessionType: normalizedSessionType })
|
|
454
|
-
|| isClaworldConversationBootstrapContext({ channel: normalizedChannel, sessionKey: normalizedSessionKey, sessionType: normalizedSessionType })
|
|
455
|
-
) {
|
|
456
|
-
return false;
|
|
457
|
-
}
|
|
458
|
-
if (
|
|
459
|
-
normalizedSessionType === 'direct'
|
|
460
|
-
|| normalizedSessionType === 'dm'
|
|
461
|
-
|| normalizedSessionType === 'direct_message'
|
|
462
|
-
) {
|
|
463
|
-
return true;
|
|
464
|
-
}
|
|
465
|
-
return /^agent:[^:]+:[^:]+:direct:/i.test(normalizedSessionKey);
|
|
466
|
-
}
|
|
467
|
-
|
|
468
273
|
function isManagementBootstrapContext({ sessionKey = null, sessionType = null } = {}) {
|
|
469
274
|
const normalizedSessionType = normalizeSessionType(sessionType);
|
|
470
|
-
if (
|
|
471
|
-
normalizedSessionType === 'management'
|
|
472
|
-
|| normalizedSessionType === 'management_session'
|
|
473
|
-
|| normalizedSessionType === 'orchestration'
|
|
474
|
-
|| normalizedSessionType === 'orchestration_session'
|
|
475
|
-
|| normalizedSessionType === 'operator'
|
|
476
|
-
|| normalizedSessionType === 'operator_session'
|
|
477
|
-
) {
|
|
275
|
+
if (normalizedSessionType === 'management' || normalizedSessionType === 'management_session') {
|
|
478
276
|
return true;
|
|
479
277
|
}
|
|
480
|
-
|
|
481
|
-
return /^management:[^:]+/i.test(normalizedSessionKey)
|
|
482
|
-
|| /^agent:[^:]+:management:[^:]+/i.test(normalizedSessionKey)
|
|
483
|
-
|| /^agent:[^:]+:claworld:(orchestration|operator|management)(?::|$)/i.test(normalizedSessionKey);
|
|
278
|
+
return /^management:[^:]+/i.test(normalizeText(sessionKey, ''));
|
|
484
279
|
}
|
|
485
280
|
|
|
486
281
|
function isClaworldConversationBootstrapContext({
|
|
@@ -491,13 +286,8 @@ function isClaworldConversationBootstrapContext({
|
|
|
491
286
|
const normalizedChannel = normalizeText(channel, null)?.toLowerCase() || null;
|
|
492
287
|
const normalizedSessionType = normalizeSessionType(sessionType);
|
|
493
288
|
const normalizedSessionKey = normalizeText(sessionKey, null);
|
|
494
|
-
const hasClaworldConversationSessionKey = (
|
|
495
|
-
/^agent:[^:]+:conversation:.*:(direct|world)(:|$)/i.test(normalizedSessionKey || '')
|
|
496
|
-
|| /^conversation:.*:(direct|world)(:|$)/i.test(normalizedSessionKey || '')
|
|
497
|
-
);
|
|
498
289
|
const hasClaworldChannel = normalizedChannel === 'claworld'
|
|
499
|
-
|| /:claworld:/i.test(normalizedSessionKey || '')
|
|
500
|
-
|| hasClaworldConversationSessionKey;
|
|
290
|
+
|| /:claworld:/i.test(normalizedSessionKey || '');
|
|
501
291
|
if (!hasClaworldChannel) return false;
|
|
502
292
|
if (
|
|
503
293
|
normalizedSessionType === 'conversation'
|
|
@@ -510,7 +300,6 @@ function isClaworldConversationBootstrapContext({
|
|
|
510
300
|
}
|
|
511
301
|
return (
|
|
512
302
|
/^agent:[^:]+:claworld:(direct|world):/i.test(normalizedSessionKey || '')
|
|
513
|
-
|| /^agent:[^:]+:conversation:.*:(direct|world)(:|$)/i.test(normalizedSessionKey || '')
|
|
514
303
|
|| /^conversation:.*:(direct|world)(:|$)/i.test(normalizedSessionKey || '')
|
|
515
304
|
);
|
|
516
305
|
}
|
|
@@ -618,9 +407,9 @@ export function resolveClaworldBootstrapContext(...sources) {
|
|
|
618
407
|
collectBootstrapRecords(source, records);
|
|
619
408
|
}
|
|
620
409
|
return {
|
|
621
|
-
channel: firstBootstrapField(records, ['channel', 'channelId'
|
|
622
|
-
sessionKey: firstBootstrapField(records, ['sessionKey', 'localSessionKey'
|
|
623
|
-
sessionType: firstBootstrapField(records, ['sessionType', 'sessionKind', 'sessionMode', 'mode'
|
|
410
|
+
channel: firstBootstrapField(records, ['channel', 'channelId']),
|
|
411
|
+
sessionKey: firstBootstrapField(records, ['sessionKey', 'localSessionKey']),
|
|
412
|
+
sessionType: firstBootstrapField(records, ['sessionType', 'sessionKind', 'sessionMode', 'mode']),
|
|
624
413
|
};
|
|
625
414
|
}
|
|
626
415
|
|
|
@@ -635,43 +424,9 @@ export function resolveClaworldBootstrapTarget(context = {}) {
|
|
|
635
424
|
if (isClaworldConversationBootstrapContext(normalizedContext)) {
|
|
636
425
|
return CLAWORLD_BOOTSTRAP_TARGETS.CLAWORLD_CONVERSATION;
|
|
637
426
|
}
|
|
638
|
-
if (isExternalMainBootstrapContext(normalizedContext)) {
|
|
639
|
-
return CLAWORLD_BOOTSTRAP_TARGETS.MAIN;
|
|
640
|
-
}
|
|
641
427
|
return CLAWORLD_BOOTSTRAP_TARGETS.NONE;
|
|
642
428
|
}
|
|
643
429
|
|
|
644
|
-
function resolveClaworldSessionDirectoryKind(input = {}, relations = {}) {
|
|
645
|
-
const explicitScope = normalizeText(input.scope, null);
|
|
646
|
-
if (explicitScope === 'main') return 'main';
|
|
647
|
-
if (explicitScope === 'management') return 'management';
|
|
648
|
-
if (explicitScope === 'conversation') return 'conversation';
|
|
649
|
-
const context = isPlainObject(input.context) ? input.context : {};
|
|
650
|
-
const target = resolveClaworldBootstrapTarget({
|
|
651
|
-
sessionKey: firstText(
|
|
652
|
-
relations.localSessionKey,
|
|
653
|
-
relations.sessionKey,
|
|
654
|
-
input.localSessionKey,
|
|
655
|
-
input.sessionKey,
|
|
656
|
-
context.SessionKey,
|
|
657
|
-
context.sessionKey,
|
|
658
|
-
),
|
|
659
|
-
sessionType: firstText(
|
|
660
|
-
input.sessionType,
|
|
661
|
-
input.sessionKind,
|
|
662
|
-
context.SessionType,
|
|
663
|
-
context.ChatType,
|
|
664
|
-
context.sessionType,
|
|
665
|
-
context.sessionKind,
|
|
666
|
-
),
|
|
667
|
-
channel: firstText(context.OriginatingChannel, context.channel),
|
|
668
|
-
});
|
|
669
|
-
if (target === CLAWORLD_BOOTSTRAP_TARGETS.MAIN) return 'main';
|
|
670
|
-
if (target === CLAWORLD_BOOTSTRAP_TARGETS.MANAGEMENT) return 'management';
|
|
671
|
-
if (target === CLAWORLD_BOOTSTRAP_TARGETS.CLAWORLD_CONVERSATION) return 'conversation';
|
|
672
|
-
return null;
|
|
673
|
-
}
|
|
674
|
-
|
|
675
430
|
async function readTextIfPresent(filePath) {
|
|
676
431
|
try {
|
|
677
432
|
return await fs.readFile(filePath, 'utf8');
|
|
@@ -681,17 +436,6 @@ async function readTextIfPresent(filePath) {
|
|
|
681
436
|
}
|
|
682
437
|
}
|
|
683
438
|
|
|
684
|
-
async function readJsonIfPresent(filePath) {
|
|
685
|
-
const text = await readTextIfPresent(filePath);
|
|
686
|
-
if (text == null) return null;
|
|
687
|
-
try {
|
|
688
|
-
const parsed = JSON.parse(text);
|
|
689
|
-
return isPlainObject(parsed) ? parsed : null;
|
|
690
|
-
} catch {
|
|
691
|
-
return null;
|
|
692
|
-
}
|
|
693
|
-
}
|
|
694
|
-
|
|
695
439
|
async function atomicWriteText(filePath, content, {
|
|
696
440
|
backup = true,
|
|
697
441
|
rejectEmptyOverwrite = true,
|
|
@@ -786,8 +530,8 @@ function toIsoTimestamp(value = null) {
|
|
|
786
530
|
return date.toISOString();
|
|
787
531
|
}
|
|
788
532
|
|
|
789
|
-
function
|
|
790
|
-
return toIsoTimestamp(timestamp).slice(0,
|
|
533
|
+
function toMonthKey(timestamp) {
|
|
534
|
+
return toIsoTimestamp(timestamp).slice(0, 7);
|
|
791
535
|
}
|
|
792
536
|
|
|
793
537
|
function truncateText(value, maxChars = MAX_EVENT_EXCERPT_CHARS) {
|
|
@@ -796,436 +540,10 @@ function truncateText(value, maxChars = MAX_EVENT_EXCERPT_CHARS) {
|
|
|
796
540
|
return `${text.slice(0, Math.max(0, maxChars - 3))}...`;
|
|
797
541
|
}
|
|
798
542
|
|
|
799
|
-
function resolveClaworldSessionDirectoryPath(workspaceRoot) {
|
|
800
|
-
return path.join(
|
|
801
|
-
workspaceRoot,
|
|
802
|
-
CLAWORLD_WORKING_MEMORY_DIR,
|
|
803
|
-
CLAWORLD_SESSION_DIRECTORY_FILE,
|
|
804
|
-
);
|
|
805
|
-
}
|
|
806
|
-
|
|
807
|
-
function createEmptyClaworldSessionDirectory(timestamp = null) {
|
|
808
|
-
return {
|
|
809
|
-
schema: CLAWORLD_SESSION_DIRECTORY_SCHEMA,
|
|
810
|
-
version: 1,
|
|
811
|
-
updatedAt: toIsoTimestamp(timestamp),
|
|
812
|
-
main: {},
|
|
813
|
-
management: {},
|
|
814
|
-
conversationSessions: {},
|
|
815
|
-
};
|
|
816
|
-
}
|
|
817
|
-
|
|
818
|
-
function normalizeClaworldSessionDirectory(value = null) {
|
|
819
|
-
const source = isPlainObject(value) ? value : {};
|
|
820
|
-
const directory = {
|
|
821
|
-
...source,
|
|
822
|
-
schema: CLAWORLD_SESSION_DIRECTORY_SCHEMA,
|
|
823
|
-
version: 1,
|
|
824
|
-
updatedAt: normalizeText(source.updatedAt, toIsoTimestamp()),
|
|
825
|
-
main: isPlainObject(source.main) ? { ...source.main } : {},
|
|
826
|
-
management: isPlainObject(source.management) ? { ...source.management } : {},
|
|
827
|
-
conversationSessions: isPlainObject(source.conversationSessions)
|
|
828
|
-
? { ...source.conversationSessions }
|
|
829
|
-
: {},
|
|
830
|
-
};
|
|
831
|
-
return directory;
|
|
832
|
-
}
|
|
833
|
-
|
|
834
|
-
function normalizeChatRequestId(input = {}, relations = {}) {
|
|
835
|
-
return firstText(
|
|
836
|
-
relations.chatRequestId,
|
|
837
|
-
relations.requestId,
|
|
838
|
-
input.chatRequestId,
|
|
839
|
-
input.requestId,
|
|
840
|
-
input.refs?.chatRequestId,
|
|
841
|
-
input.refs?.requestId,
|
|
842
|
-
);
|
|
843
|
-
}
|
|
844
|
-
|
|
845
|
-
function compactDirectoryObject(value = {}) {
|
|
846
|
-
return cleanJournalObject(value);
|
|
847
|
-
}
|
|
848
|
-
|
|
849
|
-
function compactSessionArtifact(artifact = {}) {
|
|
850
|
-
const sessionFile = firstText(artifact.sessionFile, artifact.transcriptPath);
|
|
851
|
-
const transcriptPath = firstText(
|
|
852
|
-
artifact.transcriptPath && artifact.transcriptPath !== sessionFile ? artifact.transcriptPath : null,
|
|
853
|
-
);
|
|
854
|
-
const deliveryId = firstText(artifact.deliveryId);
|
|
855
|
-
return compactDirectoryObject({
|
|
856
|
-
sessionId: firstText(artifact.sessionId),
|
|
857
|
-
sessionFile,
|
|
858
|
-
transcriptPath,
|
|
859
|
-
deliveryId,
|
|
860
|
-
sourceEventId: deliveryId ? null : firstText(artifact.sourceEventId, artifact.eventId),
|
|
861
|
-
seenAt: firstText(artifact.seenAt, artifact.lastSeenAt, artifact.firstSeenAt),
|
|
862
|
-
});
|
|
863
|
-
}
|
|
864
|
-
|
|
865
|
-
function normalizeSessionArtifacts(artifacts = []) {
|
|
866
|
-
if (!Array.isArray(artifacts)) return [];
|
|
867
|
-
return artifacts.reduce((nextArtifacts, artifact) => (
|
|
868
|
-
upsertSessionArtifact(nextArtifacts, artifact)
|
|
869
|
-
), []);
|
|
870
|
-
}
|
|
871
|
-
|
|
872
|
-
function upsertSessionArtifact(artifacts = [], artifact = {}) {
|
|
873
|
-
const normalizedArtifact = compactSessionArtifact(artifact);
|
|
874
|
-
if (
|
|
875
|
-
!normalizedArtifact.sessionId
|
|
876
|
-
&& !normalizedArtifact.sessionFile
|
|
877
|
-
&& !normalizedArtifact.transcriptPath
|
|
878
|
-
) {
|
|
879
|
-
return artifacts;
|
|
880
|
-
}
|
|
881
|
-
const key = [
|
|
882
|
-
normalizedArtifact.sessionId || '',
|
|
883
|
-
normalizedArtifact.sessionFile || '',
|
|
884
|
-
normalizedArtifact.transcriptPath || '',
|
|
885
|
-
].join('\u0000');
|
|
886
|
-
const nextArtifacts = Array.isArray(artifacts) ? [...artifacts] : [];
|
|
887
|
-
const index = nextArtifacts.findIndex((entry) => [
|
|
888
|
-
entry?.sessionId || '',
|
|
889
|
-
entry?.sessionFile || '',
|
|
890
|
-
entry?.transcriptPath || '',
|
|
891
|
-
].join('\u0000') === key);
|
|
892
|
-
if (index >= 0) {
|
|
893
|
-
nextArtifacts[index] = compactDirectoryObject({
|
|
894
|
-
...nextArtifacts[index],
|
|
895
|
-
...normalizedArtifact,
|
|
896
|
-
seenAt: normalizedArtifact.seenAt || nextArtifacts[index].seenAt,
|
|
897
|
-
});
|
|
898
|
-
return nextArtifacts;
|
|
899
|
-
}
|
|
900
|
-
nextArtifacts.push(normalizedArtifact);
|
|
901
|
-
return nextArtifacts;
|
|
902
|
-
}
|
|
903
|
-
|
|
904
|
-
function buildLatestSessionHint(source = {}, timestamp = null) {
|
|
905
|
-
const artifact = compactSessionArtifact({
|
|
906
|
-
sessionId: source.sessionId || source.latestSessionId,
|
|
907
|
-
sessionFile: source.sessionFile || source.latestSessionFile,
|
|
908
|
-
transcriptPath: source.transcriptPath || source.latestTranscriptPath,
|
|
909
|
-
seenAt: timestamp || source.seenAt || source.lastSeenAt || source.firstSeenAt,
|
|
910
|
-
});
|
|
911
|
-
if (!artifact.sessionId && !artifact.sessionFile && !artifact.transcriptPath) return null;
|
|
912
|
-
const latest = { ...artifact };
|
|
913
|
-
delete latest.deliveryId;
|
|
914
|
-
delete latest.sourceEventId;
|
|
915
|
-
return compactDirectoryObject(latest);
|
|
916
|
-
}
|
|
917
|
-
|
|
918
|
-
function normalizeChatRequestDirectoryEntry(entry = {}) {
|
|
919
|
-
const current = isPlainObject(entry) ? entry : {};
|
|
920
|
-
const artifacts = normalizeSessionArtifacts(
|
|
921
|
-
Array.isArray(current.artifacts) ? current.artifacts : current.sessionArtifacts,
|
|
922
|
-
);
|
|
923
|
-
return compactDirectoryObject({
|
|
924
|
-
firstSeenAt: current.firstSeenAt,
|
|
925
|
-
lastSeenAt: current.lastSeenAt,
|
|
926
|
-
artifacts,
|
|
927
|
-
});
|
|
928
|
-
}
|
|
929
|
-
|
|
930
|
-
function normalizeChatRequestsDirectory(chatRequests = {}) {
|
|
931
|
-
if (!isPlainObject(chatRequests)) return {};
|
|
932
|
-
const normalized = {};
|
|
933
|
-
for (const [chatRequestId, entry] of Object.entries(chatRequests)) {
|
|
934
|
-
const normalizedEntry = normalizeChatRequestDirectoryEntry(entry);
|
|
935
|
-
if (Object.keys(normalizedEntry).length > 0) {
|
|
936
|
-
normalized[chatRequestId] = normalizedEntry;
|
|
937
|
-
}
|
|
938
|
-
}
|
|
939
|
-
return normalized;
|
|
940
|
-
}
|
|
941
|
-
|
|
942
|
-
function buildSessionArtifact({ relations = {}, timestamp = null } = {}) {
|
|
943
|
-
return compactSessionArtifact({
|
|
944
|
-
sessionId: relations.sessionId,
|
|
945
|
-
sessionFile: relations.sessionFile,
|
|
946
|
-
transcriptPath: relations.transcriptPath,
|
|
947
|
-
deliveryId: relations.deliveryId,
|
|
948
|
-
eventId: relations.eventId,
|
|
949
|
-
seenAt: timestamp,
|
|
950
|
-
});
|
|
951
|
-
}
|
|
952
|
-
|
|
953
|
-
function applyClaworldSessionDirectoryUpdate(directory = {}, input = {}) {
|
|
954
|
-
const refs = isPlainObject(input.refs) ? input.refs : {};
|
|
955
|
-
const relations = resolveJournalRelations(input, refs);
|
|
956
|
-
const kind = resolveClaworldSessionDirectoryKind(input, relations);
|
|
957
|
-
const timestamp = toIsoTimestamp(input.timestamp || Date.now());
|
|
958
|
-
const localSessionKey = firstText(relations.localSessionKey, relations.sessionKey, input.localSessionKey, input.sessionKey);
|
|
959
|
-
const relaySessionKey = firstText(relations.relaySessionKey, input.relaySessionKey);
|
|
960
|
-
if (!kind || !localSessionKey) {
|
|
961
|
-
return { updated: false, reason: 'missing_session_reference', directory };
|
|
962
|
-
}
|
|
963
|
-
|
|
964
|
-
const nextDirectory = normalizeClaworldSessionDirectory(directory);
|
|
965
|
-
nextDirectory.updatedAt = timestamp;
|
|
966
|
-
|
|
967
|
-
if (kind === 'main') {
|
|
968
|
-
nextDirectory.main = compactDirectoryObject({
|
|
969
|
-
...nextDirectory.main,
|
|
970
|
-
lastActiveSessionKey: localSessionKey,
|
|
971
|
-
lastUpdatedAt: timestamp,
|
|
972
|
-
localAgentId: relations.localAgentId,
|
|
973
|
-
source: input.source,
|
|
974
|
-
});
|
|
975
|
-
return { updated: true, kind, directory: nextDirectory };
|
|
976
|
-
}
|
|
977
|
-
|
|
978
|
-
if (kind === 'management') {
|
|
979
|
-
nextDirectory.management = compactDirectoryObject({
|
|
980
|
-
...nextDirectory.management,
|
|
981
|
-
lastActiveLocalSessionKey: localSessionKey,
|
|
982
|
-
relaySessionKey,
|
|
983
|
-
localAgentId: relations.localAgentId,
|
|
984
|
-
targetAgentId: relations.targetAgentId,
|
|
985
|
-
lastUpdatedAt: timestamp,
|
|
986
|
-
});
|
|
987
|
-
return { updated: true, kind, directory: nextDirectory };
|
|
988
|
-
}
|
|
989
|
-
|
|
990
|
-
const conversationSessions = isPlainObject(nextDirectory.conversationSessions)
|
|
991
|
-
? { ...nextDirectory.conversationSessions }
|
|
992
|
-
: {};
|
|
993
|
-
const currentSession = isPlainObject(conversationSessions[localSessionKey])
|
|
994
|
-
? conversationSessions[localSessionKey]
|
|
995
|
-
: {};
|
|
996
|
-
const currentLatest = isPlainObject(currentSession.latest)
|
|
997
|
-
? buildLatestSessionHint(currentSession.latest)
|
|
998
|
-
: buildLatestSessionHint(currentSession);
|
|
999
|
-
const nextLatest = buildLatestSessionHint(relations, timestamp) || currentLatest;
|
|
1000
|
-
let nextSession = compactDirectoryObject({
|
|
1001
|
-
relaySessionKey: firstText(relaySessionKey, currentSession.relaySessionKey),
|
|
1002
|
-
conversationKey: firstText(currentSession.conversationKey, relations.conversationKey),
|
|
1003
|
-
worldId: firstText(currentSession.worldId, relations.worldId),
|
|
1004
|
-
localAgentId: firstText(currentSession.localAgentId, relations.localAgentId),
|
|
1005
|
-
firstSeenAt: currentSession.firstSeenAt || timestamp,
|
|
1006
|
-
lastSeenAt: timestamp,
|
|
1007
|
-
latest: nextLatest,
|
|
1008
|
-
chatRequests: normalizeChatRequestsDirectory(currentSession.chatRequests),
|
|
1009
|
-
});
|
|
1010
|
-
|
|
1011
|
-
const chatRequestId = normalizeChatRequestId(input, relations);
|
|
1012
|
-
if (chatRequestId) {
|
|
1013
|
-
const chatRequests = isPlainObject(nextSession.chatRequests)
|
|
1014
|
-
? { ...nextSession.chatRequests }
|
|
1015
|
-
: {};
|
|
1016
|
-
const currentRequest = isPlainObject(chatRequests[chatRequestId])
|
|
1017
|
-
? chatRequests[chatRequestId]
|
|
1018
|
-
: {};
|
|
1019
|
-
const artifact = buildSessionArtifact({ relations, timestamp });
|
|
1020
|
-
const currentArtifacts = Array.isArray(currentRequest.artifacts)
|
|
1021
|
-
? currentRequest.artifacts
|
|
1022
|
-
: currentRequest.sessionArtifacts;
|
|
1023
|
-
const nextRequest = compactDirectoryObject({
|
|
1024
|
-
firstSeenAt: currentRequest.firstSeenAt || timestamp,
|
|
1025
|
-
lastSeenAt: timestamp,
|
|
1026
|
-
artifacts: upsertSessionArtifact(currentArtifacts, artifact),
|
|
1027
|
-
});
|
|
1028
|
-
chatRequests[chatRequestId] = nextRequest;
|
|
1029
|
-
nextSession = compactDirectoryObject({
|
|
1030
|
-
...nextSession,
|
|
1031
|
-
chatRequests,
|
|
1032
|
-
});
|
|
1033
|
-
}
|
|
1034
|
-
|
|
1035
|
-
conversationSessions[localSessionKey] = nextSession;
|
|
1036
|
-
nextDirectory.conversationSessions = conversationSessions;
|
|
1037
|
-
return { updated: true, kind, directory: nextDirectory };
|
|
1038
|
-
}
|
|
1039
|
-
|
|
1040
|
-
export async function readClaworldSessionDirectory(options = {}, readOptions = {}) {
|
|
1041
|
-
const workspaceRoot = resolveClaworldWorkspaceRoot(options, readOptions.homeDir || os.homedir());
|
|
1042
|
-
const sessionDirectoryPath = resolveClaworldSessionDirectoryPath(workspaceRoot);
|
|
1043
|
-
const current = await readJsonIfPresent(sessionDirectoryPath);
|
|
1044
|
-
return {
|
|
1045
|
-
workspaceRoot,
|
|
1046
|
-
sessionDirectoryPath,
|
|
1047
|
-
directory: normalizeClaworldSessionDirectory(current || createEmptyClaworldSessionDirectory()),
|
|
1048
|
-
exists: current != null,
|
|
1049
|
-
};
|
|
1050
|
-
}
|
|
1051
|
-
|
|
1052
|
-
export async function updateClaworldSessionDirectory(options = {}, input = {}, updateOptions = {}) {
|
|
1053
|
-
const workspaceRoot = resolveClaworldWorkspaceRoot(options, updateOptions.homeDir || os.homedir());
|
|
1054
|
-
await ensureClaworldWorkingMemory(workspaceRoot, updateOptions);
|
|
1055
|
-
const sessionDirectoryPath = resolveClaworldSessionDirectoryPath(workspaceRoot);
|
|
1056
|
-
const current = await readJsonIfPresent(sessionDirectoryPath);
|
|
1057
|
-
const baseDirectory = current || createEmptyClaworldSessionDirectory(input.timestamp || updateOptions.timestamp);
|
|
1058
|
-
const result = applyClaworldSessionDirectoryUpdate(baseDirectory, input);
|
|
1059
|
-
if (!result.updated) {
|
|
1060
|
-
return {
|
|
1061
|
-
ok: true,
|
|
1062
|
-
updated: false,
|
|
1063
|
-
reason: result.reason,
|
|
1064
|
-
workspaceRoot,
|
|
1065
|
-
sessionDirectoryPath,
|
|
1066
|
-
directory: normalizeClaworldSessionDirectory(baseDirectory),
|
|
1067
|
-
};
|
|
1068
|
-
}
|
|
1069
|
-
await atomicWriteText(
|
|
1070
|
-
sessionDirectoryPath,
|
|
1071
|
-
`${JSON.stringify(result.directory, null, 2)}\n`,
|
|
1072
|
-
{
|
|
1073
|
-
backup: false,
|
|
1074
|
-
rejectEmptyOverwrite: false,
|
|
1075
|
-
},
|
|
1076
|
-
);
|
|
1077
|
-
return {
|
|
1078
|
-
ok: true,
|
|
1079
|
-
updated: true,
|
|
1080
|
-
kind: result.kind,
|
|
1081
|
-
workspaceRoot,
|
|
1082
|
-
sessionDirectoryPath,
|
|
1083
|
-
directory: result.directory,
|
|
1084
|
-
};
|
|
1085
|
-
}
|
|
1086
|
-
|
|
1087
543
|
function flattenInline(value) {
|
|
1088
544
|
return truncateText(String(value ?? '').replace(/\s+/g, ' ').trim());
|
|
1089
545
|
}
|
|
1090
546
|
|
|
1091
|
-
function firstText(...values) {
|
|
1092
|
-
for (const value of values) {
|
|
1093
|
-
const normalized = normalizeText(value, null);
|
|
1094
|
-
if (normalized) return normalized;
|
|
1095
|
-
}
|
|
1096
|
-
return null;
|
|
1097
|
-
}
|
|
1098
|
-
|
|
1099
|
-
function hasStructuredValue(value) {
|
|
1100
|
-
if (value == null) return false;
|
|
1101
|
-
if (typeof value === 'string') return normalizeText(value, null) != null;
|
|
1102
|
-
if (Array.isArray(value)) return value.length > 0;
|
|
1103
|
-
if (isPlainObject(value)) return Object.keys(value).length > 0;
|
|
1104
|
-
return true;
|
|
1105
|
-
}
|
|
1106
|
-
|
|
1107
|
-
function cleanJournalValue(value) {
|
|
1108
|
-
if (value == null) return null;
|
|
1109
|
-
if (value instanceof Date) return toIsoTimestamp(value);
|
|
1110
|
-
if (typeof value === 'string') return normalizeText(value, null);
|
|
1111
|
-
if (typeof value === 'number' || typeof value === 'boolean') return value;
|
|
1112
|
-
if (Array.isArray(value)) {
|
|
1113
|
-
const cleanedArray = value
|
|
1114
|
-
.map((entry) => cleanJournalValue(entry))
|
|
1115
|
-
.filter(hasStructuredValue);
|
|
1116
|
-
return cleanedArray.length > 0 ? cleanedArray : null;
|
|
1117
|
-
}
|
|
1118
|
-
if (isPlainObject(value)) {
|
|
1119
|
-
const cleanedObject = {};
|
|
1120
|
-
for (const [key, entry] of Object.entries(value)) {
|
|
1121
|
-
const cleaned = cleanJournalValue(entry);
|
|
1122
|
-
if (hasStructuredValue(cleaned)) {
|
|
1123
|
-
cleanedObject[key] = cleaned;
|
|
1124
|
-
}
|
|
1125
|
-
}
|
|
1126
|
-
return Object.keys(cleanedObject).length > 0 ? cleanedObject : null;
|
|
1127
|
-
}
|
|
1128
|
-
return normalizeText(value, null);
|
|
1129
|
-
}
|
|
1130
|
-
|
|
1131
|
-
function cleanJournalObject(value = {}) {
|
|
1132
|
-
return cleanJournalValue(value) || {};
|
|
1133
|
-
}
|
|
1134
|
-
|
|
1135
|
-
function resolveJournalScope(input = {}, relations = {}) {
|
|
1136
|
-
const directScope = normalizeText(input.scope, null);
|
|
1137
|
-
if (directScope) return directScope;
|
|
1138
|
-
const context = isPlainObject(input.context) ? input.context : {};
|
|
1139
|
-
const normalizedTarget = resolveClaworldBootstrapTarget({
|
|
1140
|
-
sessionKey: firstText(
|
|
1141
|
-
input.localSessionKey,
|
|
1142
|
-
input.sessionKey,
|
|
1143
|
-
relations.localSessionKey,
|
|
1144
|
-
relations.sessionKey,
|
|
1145
|
-
context.SessionKey,
|
|
1146
|
-
context.sessionKey,
|
|
1147
|
-
),
|
|
1148
|
-
sessionType: firstText(
|
|
1149
|
-
input.sessionType,
|
|
1150
|
-
input.sessionKind,
|
|
1151
|
-
context.SessionType,
|
|
1152
|
-
context.ChatType,
|
|
1153
|
-
context.sessionType,
|
|
1154
|
-
context.sessionKind,
|
|
1155
|
-
),
|
|
1156
|
-
channel: firstText(context.OriginatingChannel, context.channel),
|
|
1157
|
-
});
|
|
1158
|
-
if (normalizedTarget === CLAWORLD_BOOTSTRAP_TARGETS.CLAWORLD_CONVERSATION) return 'conversation';
|
|
1159
|
-
if (normalizedTarget === CLAWORLD_BOOTSTRAP_TARGETS.MANAGEMENT) return 'management';
|
|
1160
|
-
if (normalizedTarget === CLAWORLD_BOOTSTRAP_TARGETS.MAIN) return 'main';
|
|
1161
|
-
return firstText(input.sessionKind, input.sessionType, context.sessionKind, context.SessionType, 'runtime');
|
|
1162
|
-
}
|
|
1163
|
-
|
|
1164
|
-
function resolveJournalRelations(input = {}, refs = {}) {
|
|
1165
|
-
const relations = isPlainObject(input.relations)
|
|
1166
|
-
? input.relations
|
|
1167
|
-
: isPlainObject(input.correlation)
|
|
1168
|
-
? input.correlation
|
|
1169
|
-
: {};
|
|
1170
|
-
const context = isPlainObject(input.context) ? input.context : {};
|
|
1171
|
-
const artifacts = isPlainObject(input.artifacts) ? input.artifacts : {};
|
|
1172
|
-
const requestId = firstText(
|
|
1173
|
-
relations.requestId,
|
|
1174
|
-
relations.chatRequestId,
|
|
1175
|
-
input.requestId,
|
|
1176
|
-
input.chatRequestId,
|
|
1177
|
-
refs.requestId,
|
|
1178
|
-
refs.chatRequestId,
|
|
1179
|
-
refs.friendRequestId,
|
|
1180
|
-
);
|
|
1181
|
-
return cleanJournalObject({
|
|
1182
|
-
requestId,
|
|
1183
|
-
chatRequestId: firstText(relations.chatRequestId, input.chatRequestId, refs.chatRequestId, requestId),
|
|
1184
|
-
deliveryId: firstText(relations.deliveryId, input.deliveryId, refs.deliveryId, context.RelayDeliveryId),
|
|
1185
|
-
eventId: firstText(relations.eventId, input.eventId, input.id, refs.eventId, context.RelayEventId),
|
|
1186
|
-
notificationId: firstText(relations.notificationId, refs.notificationId),
|
|
1187
|
-
inboxItemId: firstText(relations.inboxItemId, refs.inboxItemId),
|
|
1188
|
-
conversationKey: firstText(relations.conversationKey, input.conversationKey, refs.conversationKey),
|
|
1189
|
-
worldId: firstText(relations.worldId, input.worldId, refs.worldId),
|
|
1190
|
-
accountId: firstText(relations.accountId, input.accountId, refs.accountId, context.AccountId),
|
|
1191
|
-
agentCode: firstText(relations.agentCode, refs.agentCode),
|
|
1192
|
-
localAgentId: firstText(relations.localAgentId, input.localAgentId, context.AgentId, context.agentId),
|
|
1193
|
-
targetAgentId: firstText(relations.targetAgentId, input.targetAgentId, refs.targetAgentId, context.RelayTargetAgentId),
|
|
1194
|
-
fromAgentId: firstText(relations.fromAgentId, input.fromAgentId, refs.fromAgentId, context.RelayFromAgentId),
|
|
1195
|
-
sessionKey: firstText(relations.sessionKey, input.sessionKey, context.SessionKey, context.sessionKey),
|
|
1196
|
-
localSessionKey: firstText(relations.localSessionKey, input.localSessionKey, context.LocalSessionKey, context.SessionKey),
|
|
1197
|
-
relaySessionKey: firstText(relations.relaySessionKey, input.relaySessionKey, context.RelaySessionKey),
|
|
1198
|
-
sessionId: firstText(relations.sessionId, input.sessionId, artifacts.sessionId, context.SessionId),
|
|
1199
|
-
sessionFile: firstText(relations.sessionFile, input.sessionFile, artifacts.sessionFile, artifacts.sessionPath, context.SessionFile),
|
|
1200
|
-
sessionStorePath: firstText(relations.sessionStorePath, input.sessionStorePath, artifacts.sessionStorePath),
|
|
1201
|
-
transcriptPath: firstText(relations.transcriptPath, input.transcriptPath, artifacts.transcriptPath),
|
|
1202
|
-
reportPath: firstText(relations.reportPath, input.reportPath, artifacts.reportPath),
|
|
1203
|
-
});
|
|
1204
|
-
}
|
|
1205
|
-
|
|
1206
|
-
function buildJournalKey(relations = {}, fallbackEventId = null) {
|
|
1207
|
-
const event = firstText(relations.eventId, fallbackEventId);
|
|
1208
|
-
const request = firstText(relations.requestId, relations.chatRequestId);
|
|
1209
|
-
const session = firstText(relations.localSessionKey, relations.relaySessionKey, relations.sessionKey);
|
|
1210
|
-
const continuity = request
|
|
1211
|
-
? `request:${request}`
|
|
1212
|
-
: firstText(
|
|
1213
|
-
relations.conversationKey ? `conversation:${relations.conversationKey}` : null,
|
|
1214
|
-
session ? `session:${session}` : null,
|
|
1215
|
-
relations.worldId ? `world:${relations.worldId}` : null,
|
|
1216
|
-
event ? `event:${event}` : null,
|
|
1217
|
-
);
|
|
1218
|
-
return cleanJournalObject({
|
|
1219
|
-
event,
|
|
1220
|
-
continuity,
|
|
1221
|
-
request,
|
|
1222
|
-
session,
|
|
1223
|
-
sessionId: relations.sessionId,
|
|
1224
|
-
world: relations.worldId,
|
|
1225
|
-
conversation: relations.conversationKey,
|
|
1226
|
-
});
|
|
1227
|
-
}
|
|
1228
|
-
|
|
1229
547
|
export function buildClaworldMaintenanceEvent(input = {}) {
|
|
1230
548
|
const toolName = normalizeText(input.toolName, null);
|
|
1231
549
|
const source = normalizeText(input.source, toolName ? 'claworld_tool' : 'claworld_runtime');
|
|
@@ -1239,26 +557,14 @@ export function buildClaworldMaintenanceEvent(input = {}) {
|
|
|
1239
557
|
.filter(([, value]) => value != null),
|
|
1240
558
|
)
|
|
1241
559
|
: {};
|
|
1242
|
-
const id = normalizeText(input.id, `${source}:${kind}:${timestamp}`);
|
|
1243
|
-
const relations = resolveJournalRelations({ ...input, eventId: input.eventId || id }, refs);
|
|
1244
|
-
const scope = resolveJournalScope(input, relations);
|
|
1245
560
|
return {
|
|
1246
|
-
|
|
1247
|
-
id,
|
|
561
|
+
id: normalizeText(input.id, `${source}:${kind}:${timestamp}`),
|
|
1248
562
|
timestamp,
|
|
1249
563
|
source,
|
|
1250
564
|
kind,
|
|
1251
|
-
eventType: normalizeText(input.eventType, kind),
|
|
1252
|
-
scope,
|
|
1253
565
|
summary,
|
|
1254
566
|
excerpt: truncateText(input.excerpt || ''),
|
|
1255
567
|
refs,
|
|
1256
|
-
key: buildJournalKey(relations, id),
|
|
1257
|
-
relations,
|
|
1258
|
-
actor: cleanJournalObject(input.actor || {}),
|
|
1259
|
-
tool: cleanJournalObject(input.tool || {}),
|
|
1260
|
-
artifacts: cleanJournalObject(input.artifacts || {}),
|
|
1261
|
-
maintenance: cleanJournalObject(input.maintenance || {}),
|
|
1262
568
|
};
|
|
1263
569
|
}
|
|
1264
570
|
|
|
@@ -1291,11 +597,9 @@ function compactResultPayload(payload = {}) {
|
|
|
1291
597
|
const keys = [
|
|
1292
598
|
'status',
|
|
1293
599
|
'tool',
|
|
1294
|
-
'action',
|
|
1295
600
|
'accountId',
|
|
1296
601
|
'worldId',
|
|
1297
602
|
'displayName',
|
|
1298
|
-
'requestId',
|
|
1299
603
|
'chatRequestId',
|
|
1300
604
|
'conversationKey',
|
|
1301
605
|
'feedbackId',
|
|
@@ -1312,96 +616,29 @@ function compactResultPayload(payload = {}) {
|
|
|
1312
616
|
return compact;
|
|
1313
617
|
}
|
|
1314
618
|
|
|
1315
|
-
function readNestedObject(value, key) {
|
|
1316
|
-
const nested = value?.[key];
|
|
1317
|
-
return nested && typeof nested === 'object' && !Array.isArray(nested) ? nested : {};
|
|
1318
|
-
}
|
|
1319
|
-
|
|
1320
619
|
export function buildClaworldToolMaintenanceEvent({
|
|
1321
620
|
toolName,
|
|
1322
621
|
params = {},
|
|
1323
622
|
result = null,
|
|
1324
623
|
timestamp = null,
|
|
1325
|
-
context = {},
|
|
1326
624
|
} = {}) {
|
|
1327
625
|
const normalizedToolName = normalizeText(toolName, null);
|
|
1328
626
|
if (!normalizedToolName || !normalizedToolName.startsWith('claworld_')) return null;
|
|
1329
627
|
const payload = parseToolResultPayload(result) || {};
|
|
1330
|
-
const chatRequest = readNestedObject(payload, 'chatRequest');
|
|
1331
|
-
const request = readNestedObject(payload, 'request');
|
|
1332
|
-
const kickoff = readNestedObject(payload, 'kickoff');
|
|
1333
|
-
const conversation = readNestedObject(payload, 'conversation');
|
|
1334
628
|
const compactPayload = compactResultPayload(payload);
|
|
1335
|
-
const requestId = firstText(
|
|
1336
|
-
params.requestId,
|
|
1337
|
-
params.chatRequestId,
|
|
1338
|
-
payload.requestId,
|
|
1339
|
-
payload.chatRequestId,
|
|
1340
|
-
chatRequest.chatRequestId,
|
|
1341
|
-
chatRequest.requestId,
|
|
1342
|
-
request.requestId,
|
|
1343
|
-
);
|
|
1344
|
-
const localSessionKey = firstText(
|
|
1345
|
-
context.sessionKey,
|
|
1346
|
-
context.SessionKey,
|
|
1347
|
-
context.localSessionKey,
|
|
1348
|
-
payload.localSessionKey,
|
|
1349
|
-
kickoff.localSessionKey,
|
|
1350
|
-
);
|
|
1351
|
-
const relaySessionKey = firstText(
|
|
1352
|
-
context.RelaySessionKey,
|
|
1353
|
-
payload.sessionKey,
|
|
1354
|
-
kickoff.sessionKey,
|
|
1355
|
-
conversation.sessionKey,
|
|
1356
|
-
);
|
|
1357
|
-
const sessionKind = resolveJournalScope({
|
|
1358
|
-
sessionKey: localSessionKey || relaySessionKey,
|
|
1359
|
-
sessionType: firstText(context.sessionType, context.SessionType, context.ChatType, context.sessionKind),
|
|
1360
|
-
context,
|
|
1361
|
-
});
|
|
1362
629
|
const refs = {
|
|
1363
630
|
accountId: params.accountId || payload.accountId,
|
|
1364
631
|
worldId: params.worldId || payload.worldId,
|
|
1365
|
-
|
|
1366
|
-
|
|
1367
|
-
conversationKey: params.conversationKey || payload.conversationKey || conversation.conversationKey,
|
|
632
|
+
chatRequestId: params.chatRequestId || payload.chatRequestId,
|
|
633
|
+
conversationKey: params.conversationKey || payload.conversationKey,
|
|
1368
634
|
agentCode: params.agentCode || payload.agentCode,
|
|
1369
|
-
sessionKey: localSessionKey || relaySessionKey,
|
|
1370
|
-
relaySessionKey,
|
|
1371
635
|
};
|
|
1372
636
|
return buildClaworldMaintenanceEvent({
|
|
1373
637
|
source: 'claworld_tool',
|
|
1374
638
|
kind: normalizedToolName,
|
|
1375
|
-
eventType: 'tool_call',
|
|
1376
|
-
scope: sessionKind,
|
|
1377
639
|
toolName: normalizedToolName,
|
|
1378
640
|
timestamp,
|
|
1379
641
|
refs,
|
|
1380
|
-
relations: {
|
|
1381
|
-
requestId,
|
|
1382
|
-
chatRequestId: refs.chatRequestId,
|
|
1383
|
-
conversationKey: refs.conversationKey,
|
|
1384
|
-
worldId: refs.worldId,
|
|
1385
|
-
accountId: refs.accountId,
|
|
1386
|
-
agentCode: refs.agentCode,
|
|
1387
|
-
localSessionKey,
|
|
1388
|
-
relaySessionKey,
|
|
1389
|
-
sessionKey: localSessionKey || relaySessionKey,
|
|
1390
|
-
localAgentId: firstText(context.agentId, context.AgentId),
|
|
1391
|
-
sessionId: firstText(context.sessionId, context.SessionId),
|
|
1392
|
-
sessionFile: firstText(context.sessionFile, context.SessionFile, context.sessionPath),
|
|
1393
|
-
transcriptPath: firstText(context.transcriptPath),
|
|
1394
|
-
},
|
|
1395
|
-
actor: {
|
|
1396
|
-
sessionKind,
|
|
1397
|
-
agentId: firstText(context.agentId, context.AgentId),
|
|
1398
|
-
sessionKey: localSessionKey || relaySessionKey,
|
|
1399
|
-
},
|
|
1400
|
-
tool: {
|
|
1401
|
-
name: normalizedToolName,
|
|
1402
|
-
action: firstText(params.action, payload.action),
|
|
1403
|
-
status: firstText(payload.status, 'succeeded'),
|
|
1404
|
-
},
|
|
1405
642
|
summary: `${normalizedToolName} succeeded.`,
|
|
1406
643
|
excerpt: Object.keys(compactPayload).length > 0
|
|
1407
644
|
? JSON.stringify(compactPayload)
|
|
@@ -1409,84 +646,45 @@ export function buildClaworldToolMaintenanceEvent({
|
|
|
1409
646
|
});
|
|
1410
647
|
}
|
|
1411
648
|
|
|
1412
|
-
function
|
|
1413
|
-
return
|
|
1414
|
-
|
|
1415
|
-
|
|
1416
|
-
|
|
1417
|
-
timestamp: event.timestamp,
|
|
1418
|
-
source: event.source,
|
|
1419
|
-
scope: event.scope,
|
|
1420
|
-
eventType: event.eventType,
|
|
1421
|
-
kind: event.kind,
|
|
1422
|
-
summary: event.summary,
|
|
1423
|
-
refs: event.refs,
|
|
1424
|
-
relations: event.relations,
|
|
1425
|
-
actor: event.actor,
|
|
1426
|
-
tool: event.tool,
|
|
1427
|
-
artifacts: event.artifacts,
|
|
1428
|
-
maintenance: event.maintenance,
|
|
1429
|
-
excerpt: event.excerpt || null,
|
|
1430
|
-
});
|
|
1431
|
-
}
|
|
1432
|
-
|
|
1433
|
-
function buildJournalEntry(event = {}) {
|
|
1434
|
-
const title = flattenInline(event.summary || event.kind || 'Claworld event recorded.');
|
|
1435
|
-
const heading = [
|
|
1436
|
-
event.timestamp,
|
|
1437
|
-
event.scope || event.source,
|
|
1438
|
-
event.kind,
|
|
1439
|
-
title,
|
|
1440
|
-
].filter(Boolean).join(' · ');
|
|
1441
|
-
return [
|
|
1442
|
-
`## ${heading}`,
|
|
1443
|
-
'',
|
|
1444
|
-
'```json',
|
|
1445
|
-
JSON.stringify(buildJournalEntryPayload(event), null, 2),
|
|
1446
|
-
'```',
|
|
1447
|
-
'',
|
|
1448
|
-
].join('\n');
|
|
649
|
+
function formatRefs(refs = {}) {
|
|
650
|
+
return Object.entries(refs)
|
|
651
|
+
.filter(([, value]) => value != null)
|
|
652
|
+
.map(([key, value]) => `${key}=${flattenInline(value)}`)
|
|
653
|
+
.join(', ');
|
|
1449
654
|
}
|
|
1450
655
|
|
|
1451
656
|
export async function appendClaworldJournalEvent(options = {}, event = {}, appendOptions = {}) {
|
|
1452
657
|
const workspaceRoot = resolveClaworldWorkspaceRoot(options, appendOptions.homeDir || os.homedir());
|
|
1453
658
|
await ensureClaworldWorkingMemory(workspaceRoot, appendOptions);
|
|
1454
659
|
const normalizedEvent = buildClaworldMaintenanceEvent(event);
|
|
1455
|
-
const
|
|
660
|
+
const monthKey = toMonthKey(normalizedEvent.timestamp);
|
|
1456
661
|
const journalPath = path.join(
|
|
1457
662
|
workspaceRoot,
|
|
1458
663
|
CLAWORLD_WORKING_MEMORY_DIR,
|
|
1459
664
|
CLAWORLD_JOURNAL_DIR,
|
|
1460
|
-
`${
|
|
665
|
+
`${monthKey}.md`,
|
|
1461
666
|
);
|
|
1462
667
|
const currentContent = await readTextIfPresent(journalPath);
|
|
1463
|
-
const
|
|
668
|
+
const refsLine = formatRefs(normalizedEvent.refs);
|
|
669
|
+
const entry = [
|
|
670
|
+
`## ${normalizedEvent.timestamp} - ${normalizedEvent.kind}`,
|
|
671
|
+
`- Source: ${normalizedEvent.source}`,
|
|
672
|
+
`- Summary: ${flattenInline(normalizedEvent.summary)}`,
|
|
673
|
+
normalizedEvent.excerpt ? `- Excerpt: ${flattenInline(normalizedEvent.excerpt)}` : null,
|
|
674
|
+
refsLine ? `- Refs: ${refsLine}` : null,
|
|
675
|
+
'',
|
|
676
|
+
].filter((line) => line != null).join('\n');
|
|
1464
677
|
if (currentContent == null) {
|
|
1465
|
-
await atomicWriteText(journalPath, `# Claworld Journal ${
|
|
678
|
+
await atomicWriteText(journalPath, `# Claworld Journal ${monthKey}\n\n${entry}`, {
|
|
1466
679
|
backup: false,
|
|
1467
680
|
rejectEmptyOverwrite: false,
|
|
1468
681
|
});
|
|
1469
682
|
} else {
|
|
1470
683
|
await fs.appendFile(journalPath, `${currentContent.endsWith('\n') ? '' : '\n'}${entry}`, 'utf8');
|
|
1471
684
|
}
|
|
1472
|
-
let sessionDirectory = null;
|
|
1473
|
-
if (appendOptions.updateSessionDirectory !== false) {
|
|
1474
|
-
try {
|
|
1475
|
-
sessionDirectory = await updateClaworldSessionDirectory(workspaceRoot, normalizedEvent, {
|
|
1476
|
-
...appendOptions,
|
|
1477
|
-
timestamp: normalizedEvent.timestamp,
|
|
1478
|
-
});
|
|
1479
|
-
} catch (error) {
|
|
1480
|
-
sessionDirectory = {
|
|
1481
|
-
ok: false,
|
|
1482
|
-
error: error?.message || String(error),
|
|
1483
|
-
};
|
|
1484
|
-
}
|
|
1485
|
-
}
|
|
1486
685
|
return {
|
|
1487
686
|
ok: true,
|
|
1488
687
|
journalPath,
|
|
1489
|
-
sessionDirectory,
|
|
1490
688
|
event: normalizedEvent,
|
|
1491
689
|
};
|
|
1492
690
|
}
|
|
@@ -1533,27 +731,11 @@ export async function buildClaworldBootstrapPromptContext(context = {}, options
|
|
|
1533
731
|
})
|
|
1534
732
|
: { slices: {} };
|
|
1535
733
|
const pointerInjected = target === CLAWORLD_BOOTSTRAP_TARGETS.MAIN;
|
|
1536
|
-
const managementPolicyInjected = target === CLAWORLD_BOOTSTRAP_TARGETS.MANAGEMENT;
|
|
1537
|
-
let managementMainSessionKey = null;
|
|
1538
|
-
if (managementPolicyInjected && resolvedWorkspaceRoot) {
|
|
1539
|
-
try {
|
|
1540
|
-
const sessionDirectory = await readClaworldSessionDirectory(resolvedWorkspaceRoot);
|
|
1541
|
-
managementMainSessionKey = normalizeText(
|
|
1542
|
-
sessionDirectory.directory?.main?.lastActiveSessionKey,
|
|
1543
|
-
null,
|
|
1544
|
-
);
|
|
1545
|
-
} catch {
|
|
1546
|
-
managementMainSessionKey = null;
|
|
1547
|
-
}
|
|
1548
|
-
}
|
|
1549
734
|
const parts = [];
|
|
1550
735
|
let truncated = false;
|
|
1551
736
|
if (pointerInjected) {
|
|
1552
737
|
const pointerBudget = maxTotalChars - measureBootstrapParts(parts) - (parts.length > 0 ? 2 : 0);
|
|
1553
|
-
const fittedPointer = truncateBootstrapText(
|
|
1554
|
-
buildClaworldContextPointer({ workspaceRoot: resolvedWorkspaceRoot }),
|
|
1555
|
-
pointerBudget,
|
|
1556
|
-
);
|
|
738
|
+
const fittedPointer = truncateBootstrapText(buildClaworldContextPointer(), pointerBudget);
|
|
1557
739
|
if (fittedPointer.text) {
|
|
1558
740
|
parts.push(fittedPointer.text);
|
|
1559
741
|
}
|
|
@@ -1561,22 +743,6 @@ export async function buildClaworldBootstrapPromptContext(context = {}, options
|
|
|
1561
743
|
truncated = true;
|
|
1562
744
|
}
|
|
1563
745
|
}
|
|
1564
|
-
if (managementPolicyInjected) {
|
|
1565
|
-
const policyBudget = maxTotalChars - measureBootstrapParts(parts) - (parts.length > 0 ? 2 : 0);
|
|
1566
|
-
const fittedPolicy = truncateBootstrapText(
|
|
1567
|
-
buildClaworldManagementStartupPrompt({
|
|
1568
|
-
workspaceRoot: resolvedWorkspaceRoot,
|
|
1569
|
-
mainSessionKey: managementMainSessionKey,
|
|
1570
|
-
}),
|
|
1571
|
-
policyBudget,
|
|
1572
|
-
);
|
|
1573
|
-
if (fittedPolicy.text) {
|
|
1574
|
-
parts.push(fittedPolicy.text);
|
|
1575
|
-
}
|
|
1576
|
-
if (fittedPolicy.truncated) {
|
|
1577
|
-
truncated = true;
|
|
1578
|
-
}
|
|
1579
|
-
}
|
|
1580
746
|
const sectionTitle = target === CLAWORLD_BOOTSTRAP_TARGETS.MAIN
|
|
1581
747
|
? '# Claworld Startup Memory'
|
|
1582
748
|
: target === CLAWORLD_BOOTSTRAP_TARGETS.MANAGEMENT
|
|
@@ -1607,7 +773,6 @@ export async function buildClaworldBootstrapPromptContext(context = {}, options
|
|
|
1607
773
|
workspaceRoot: resolvedWorkspaceRoot,
|
|
1608
774
|
files: selectedFiles.map((relativePath) => buildBootstrapFileLabel(relativePath)),
|
|
1609
775
|
pointerInjected,
|
|
1610
|
-
managementPolicyInjected,
|
|
1611
776
|
fallbackFiles: fileSections.fallbackFiles,
|
|
1612
777
|
omittedFiles: fileSections.omittedFiles,
|
|
1613
778
|
truncated,
|
|
@@ -1669,40 +834,6 @@ function assertAllowedTarget(runType, target) {
|
|
|
1669
834
|
}
|
|
1670
835
|
}
|
|
1671
836
|
|
|
1672
|
-
function normalizeMarkdownNewlines(content) {
|
|
1673
|
-
return String(content ?? '').replace(/\r\n/g, '\n');
|
|
1674
|
-
}
|
|
1675
|
-
|
|
1676
|
-
function assertContextMarkdownUsesBullets(target, normalizedContent, schema) {
|
|
1677
|
-
const maxBulletLength = schema.maxBulletLength || null;
|
|
1678
|
-
const lines = normalizedContent.split('\n');
|
|
1679
|
-
for (const line of lines) {
|
|
1680
|
-
const trimmed = line.trim();
|
|
1681
|
-
if (!trimmed || trimmed.startsWith('#')) continue;
|
|
1682
|
-
if (!trimmed.startsWith('- ')) {
|
|
1683
|
-
throw new Error(`Claworld maintenance patch for ${target} must use bullet lines under schema sections.`);
|
|
1684
|
-
}
|
|
1685
|
-
if (maxBulletLength && trimmed.length > maxBulletLength) {
|
|
1686
|
-
throw new Error(`Claworld maintenance patch for ${target} has a bullet longer than ${maxBulletLength} characters.`);
|
|
1687
|
-
}
|
|
1688
|
-
}
|
|
1689
|
-
}
|
|
1690
|
-
|
|
1691
|
-
function assertContextFileSchema(target, content) {
|
|
1692
|
-
const schema = CLAWORLD_CONTEXT_FILE_SCHEMAS[target];
|
|
1693
|
-
if (!schema) return;
|
|
1694
|
-
const normalizedContent = normalizeMarkdownNewlines(content);
|
|
1695
|
-
if (!normalizedContent.startsWith(`${schema.title}\n`)) {
|
|
1696
|
-
throw new Error(`Claworld maintenance patch for ${target} must start with ${schema.title}.`);
|
|
1697
|
-
}
|
|
1698
|
-
for (const heading of schema.headings) {
|
|
1699
|
-
if (!normalizedContent.includes(`\n${heading}\n`)) {
|
|
1700
|
-
throw new Error(`Claworld maintenance patch for ${target} is missing required section ${heading}.`);
|
|
1701
|
-
}
|
|
1702
|
-
}
|
|
1703
|
-
assertContextMarkdownUsesBullets(target, normalizedContent, schema);
|
|
1704
|
-
}
|
|
1705
|
-
|
|
1706
837
|
function normalizeReportPatch(report, index) {
|
|
1707
838
|
const filename = normalizeText(report?.filename ?? report?.name, `report-${index + 1}.md`);
|
|
1708
839
|
const normalizedFilename = path.posix.basename(filename.endsWith('.md') ? filename : `${filename}.md`);
|
|
@@ -1759,10 +890,10 @@ export function normalizeClaworldMaintenanceOutput(runType, output = {}, options
|
|
|
1759
890
|
patches.push(normalizeFilePatchValue(output.memoryMd, CLAWORLD_WORKING_MEMORY_FILES.memory, 'memoryMd'));
|
|
1760
891
|
}
|
|
1761
892
|
if (Object.prototype.hasOwnProperty.call(output, 'journalAppendMd')) {
|
|
1762
|
-
const
|
|
893
|
+
const monthKey = toMonthKey(options.timestamp || output.timestamp || Date.now());
|
|
1763
894
|
patches.push({
|
|
1764
895
|
operation: 'append_section',
|
|
1765
|
-
target: `${CLAWORLD_JOURNAL_DIR}/${
|
|
896
|
+
target: `${CLAWORLD_JOURNAL_DIR}/${monthKey}.md`,
|
|
1766
897
|
content: String(output.journalAppendMd ?? ''),
|
|
1767
898
|
});
|
|
1768
899
|
}
|
|
@@ -1795,9 +926,6 @@ export function normalizeClaworldMaintenanceOutput(runType, output = {}, options
|
|
|
1795
926
|
target,
|
|
1796
927
|
content: String(patch.content ?? ''),
|
|
1797
928
|
};
|
|
1798
|
-
if (operation === 'replace') {
|
|
1799
|
-
assertContextFileSchema(target, normalizedPatch.content);
|
|
1800
|
-
}
|
|
1801
929
|
const rationale = normalizeText(patch.rationale, null);
|
|
1802
930
|
if (rationale) normalizedPatch.rationale = rationale;
|
|
1803
931
|
return normalizedPatch;
|
|
@@ -1827,8 +955,8 @@ async function applyMaintenancePatch(workspaceRoot, patch) {
|
|
|
1827
955
|
await fs.mkdir(path.dirname(absolutePath), { recursive: true });
|
|
1828
956
|
const currentContent = await readTextIfPresent(absolutePath);
|
|
1829
957
|
if (currentContent == null) {
|
|
1830
|
-
const
|
|
1831
|
-
await atomicWriteText(absolutePath, `# Claworld Journal ${
|
|
958
|
+
const monthKey = path.basename(patch.target, '.md');
|
|
959
|
+
await atomicWriteText(absolutePath, `# Claworld Journal ${monthKey}\n\n${patch.content}`, {
|
|
1832
960
|
backup: false,
|
|
1833
961
|
rejectEmptyOverwrite: false,
|
|
1834
962
|
});
|