Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -47,7 +47,7 @@ apps/macos/.build-local/
apps/macos/.swiftpm/
apps/shared/MoltbotKit/.swiftpm/
apps/shared/OpenClawKit/.swiftpm/
Core/
/Core/
apps/ios/*.xcodeproj/
apps/ios/*.xcworkspace/
apps/ios/.swiftpm/
Expand Down
14 changes: 14 additions & 0 deletions extensions/openbmb-clawxmemory/src/core/index.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,14 @@
export * from "./types.js";
export * from "./utils/id.js";
export * from "./utils/text.js";
export * from "./skills/types.js";
export * from "./skills/defaults.js";
export * from "./skills/loader.js";
export * from "./skills/llm-extraction.js";
export * from "./skills/intent-skill.js";
export * from "./indexers/l1-extractor.js";
export * from "./indexers/l2-builder.js";
export * from "./review/dream-review.js";
export * from "./pipeline/heartbeat.js";
export * from "./retrieval/reasoning-loop.js";
export * from "./storage/sqlite.js";
110 changes: 110 additions & 0 deletions extensions/openbmb-clawxmemory/src/core/indexers/l1-extractor.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,110 @@
import { LlmMemoryExtractor } from "../skills/llm-extraction.js";
import type { L0SessionRecord, L1WindowRecord, MemoryMessage } from "../types.js";
import { buildL1IndexId, nowIso } from "../utils/id.js";

function sameMessage(left: MemoryMessage | undefined, right: MemoryMessage | undefined): boolean {
if (!left || !right) return false;
return left.role === right.role && left.content === right.content;
}

function startsWithMessages(list: MemoryMessage[], prefix: MemoryMessage[]): boolean {
if (prefix.length > list.length) return false;
for (let index = 0; index < prefix.length; index += 1) {
if (!sameMessage(list[index], prefix[index])) return false;
}
return true;
}

function findOverlap(existing: MemoryMessage[], incoming: MemoryMessage[]): number {
const max = Math.min(existing.length, incoming.length);
for (let size = max; size > 0; size -= 1) {
let matched = true;
for (let index = 0; index < size; index += 1) {
if (!sameMessage(existing[existing.length - size + index], incoming[index])) {
matched = false;
break;
}
}
if (matched) return size;
}
return 0;
}

function dedupeAdjacentMessages(messages: MemoryMessage[]): MemoryMessage[] {
const merged: MemoryMessage[] = [];
for (const message of messages) {
const previous = merged[merged.length - 1];
if (sameMessage(previous, message)) continue;
merged.push(message);
}
return merged;
}

function mergeMessageStream(existing: MemoryMessage[], incoming: MemoryMessage[]): MemoryMessage[] {
if (incoming.length === 0) return existing;
if (existing.length === 0) return dedupeAdjacentMessages(incoming);
if (startsWithMessages(incoming, existing)) return dedupeAdjacentMessages(incoming);
if (startsWithMessages(existing, incoming)) return dedupeAdjacentMessages(existing);
const overlap = findOverlap(existing, incoming);
return dedupeAdjacentMessages([...existing, ...incoming.slice(overlap)]);
}

function mergeWindowMessages(records: L0SessionRecord[]): MemoryMessage[] {
return records.reduce<MemoryMessage[]>(
(combined, record) => mergeMessageStream(combined, record.messages),
[],
);
}

function buildTimePeriod(startedAt: string, endedAt: string): string {
const start = new Date(startedAt);
const end = new Date(endedAt);
if (Number.isNaN(start.getTime()) || Number.isNaN(end.getTime())) return "unknown";
const yyyyMmDd = (date: Date): string => date.toISOString().slice(0, 10);
const hhMm = (date: Date): string =>
`${String(date.getHours()).padStart(2, "0")}:${String(date.getMinutes()).padStart(2, "0")}`;
if (yyyyMmDd(start) === yyyyMmDd(end)) {
return `${yyyyMmDd(start)} ${hhMm(start)}-${hhMm(end)}`;
}
return `${yyyyMmDd(start)} ${hhMm(start)} -> ${yyyyMmDd(end)} ${hhMm(end)}`;
}

export async function extractL1FromWindow(
records: L0SessionRecord[],
extractor: LlmMemoryExtractor,
): Promise<L1WindowRecord> {
if (records.length === 0) {
throw new Error("Cannot build L1 window from empty L0 records");
}
const ordered = [...records].sort((left, right) => left.timestamp.localeCompare(right.timestamp));
const startedAt = ordered[0]!.timestamp;
const endedAt = ordered[ordered.length - 1]!.timestamp;
const mergedMessages = mergeWindowMessages(ordered);
const extracted = await extractor.extract({
timestamp: endedAt,
messages: mergedMessages,
});
const l0Source = ordered.map((record) => record.l0IndexId);
const l1IndexId = buildL1IndexId(startedAt, l0Source);
return {
l1IndexId,
sessionKey: ordered[0]!.sessionKey,
timePeriod: buildTimePeriod(startedAt, endedAt),
startedAt,
endedAt,
summary: extracted.summary,
facts: extracted.facts,
situationTimeInfo: extracted.situationTimeInfo,
projectTags: extracted.projectDetails.map((item) => item.name),
projectDetails: extracted.projectDetails,
l0Source,
createdAt: nowIso(),
};
}

export async function extractL1FromL0(
record: L0SessionRecord,
extractor: LlmMemoryExtractor,
): Promise<L1WindowRecord> {
return extractL1FromWindow([record], extractor);
}
51 changes: 51 additions & 0 deletions extensions/openbmb-clawxmemory/src/core/indexers/l2-builder.ts
Original file line number Diff line number Diff line change
@@ -0,0 +1,51 @@
import type {
L1WindowRecord,
L2ProjectIndexRecord,
L2TimeIndexRecord,
ProjectDetail,
} from "../types.js";
import { buildL2ProjectIndexId, buildL2TimeIndexId, nowIso } from "../utils/id.js";

function formatLocalDayKey(value: string): string {
const date = new Date(value);
if (Number.isNaN(date.getTime())) return value.slice(0, 10) || "unknown-day";
const year = String(date.getFullYear());
const month = String(date.getMonth() + 1).padStart(2, "0");
const day = String(date.getDate()).padStart(2, "0");
return `${year}-${month}-${day}`;
}

export function buildL2TimeFromL1(l1: L1WindowRecord, summary: string): L2TimeIndexRecord {
const dateKey = formatLocalDayKey(l1.startedAt || l1.endedAt || l1.createdAt);
const now = nowIso();
return {
l2IndexId: buildL2TimeIndexId(dateKey),
dateKey,
summary,
l1Source: [l1.l1IndexId],
createdAt: now,
updatedAt: now,
};
}

export function buildL2ProjectFromDetail(
project: ProjectDetail,
l1IndexId: string,
): L2ProjectIndexRecord {
const now = nowIso();
return {
l2IndexId: buildL2ProjectIndexId(project.key),
projectKey: project.key,
projectName: project.name,
summary: project.summary,
currentStatus: project.status,
latestProgress: project.latestProgress,
l1Source: [l1IndexId],
createdAt: now,
updatedAt: now,
};
}

export function buildL2ProjectsFromL1(l1: L1WindowRecord): L2ProjectIndexRecord[] {
return l1.projectDetails.map((project) => buildL2ProjectFromDetail(project, l1.l1IndexId));
}
Loading
Loading