@openclawbrain/openclaw 0.1.11 → 0.1.12

package/dist/src/local-session-passive-learning.d.ts

@@ -0,0 +1,60 @@
+import { type FeedbackEventV1, type InteractionEventV1, type NormalizedEventExportV1 } from "@openclawbrain/contracts";
+import { type FeedbackEventExtractionResultV1 } from "@openclawbrain/event-export";
+import type { OpenClawSessionIndex, OpenClawSessionIndexEntry, OpenClawSessionRecord } from "./session-store.js";
+export interface OpenClawPassiveLearningPrivacySummaryV1 {
+    sanitized: true;
+    rules: string[];
+    strippedMetadataBlockCount: number;
+    strippedThinkingBlockCount: number;
+    droppedToolResultCount: number;
+}
+export interface OpenClawPassiveLearningSessionEvidenceV1 {
+    sessionKey: string;
+    sessionId: string;
+    updatedAt: string;
+    channel: string;
+    sourceStream: string;
+    sessionFileBasename: string | null;
+    model: string | null;
+    modelProvider: string | null;
+    chatType: string | null;
+    systemPromptFingerprint: {
+        available: boolean;
+        workspaceDirBasename: string | null;
+        injectedWorkspaceFileCount: number;
+        missingInjectedWorkspaceFileCount: number;
+        toolNames: string[];
+    };
+}
+export interface OpenClawPassiveLearningSessionExportV1 {
+    session: OpenClawPassiveLearningSessionEvidenceV1;
+    privacy: OpenClawPassiveLearningPrivacySummaryV1;
+    interactionEvents: InteractionEventV1[];
+    feedbackEvents: FeedbackEventV1[];
+    interactionContentsById: Record<string, string>;
+    feedbackExtraction: FeedbackEventExtractionResultV1;
+    normalizedEventExport: NormalizedEventExportV1;
+    warnings: string[];
+}
+export interface OpenClawPassiveLearningStoreExportV1 {
+    sessions: OpenClawPassiveLearningSessionExportV1[];
+    interactionEvents: InteractionEventV1[];
+    feedbackEvents: FeedbackEventV1[];
+    normalizedEventExport: NormalizedEventExportV1;
+    warnings: string[];
+}
+export declare function buildPassiveLearningSessionExportFromOpenClawSessionStore(input: {
+    sessionKey: string;
+    indexEntry: OpenClawSessionIndexEntry;
+    records: readonly OpenClawSessionRecord[];
+    agentId?: string;
+    sequenceStart?: number;
+}): OpenClawPassiveLearningSessionExportV1 & {
+    nextSequence: number;
+};
+export declare function buildPassiveLearningStoreExportFromOpenClawSessionIndex(input: {
+    sessionIndex: OpenClawSessionIndex;
+    readSessionRecords: (sessionKey: string, entry: OpenClawSessionIndexEntry) => readonly OpenClawSessionRecord[];
+    sessionKeys?: readonly string[];
+    agentId?: string;
+}): OpenClawPassiveLearningStoreExportV1;

package/dist/src/local-session-passive-learning.js

@@ -0,0 +1,359 @@
+import path from "node:path";
+import { buildNormalizedEventExport, createInteractionEvent } from "@openclawbrain/contracts";
+import { extractFeedbackEventsFromInteractionRecords } from "@openclawbrain/event-export";
+const DEFAULT_AGENT_ID = "openclaw-session-store";
+const KNOWN_PRINCIPALS = {
+    bihua: {
+        teacherIdentity: "bihua",
+        teacherRole: "principal",
+        teacherAuthority: "binding",
+        priorityClass: "critical"
+    },
+    "jonathan gu": {
+        teacherIdentity: "jonathan",
+        teacherRole: "admin",
+        teacherAuthority: "high",
+        priorityClass: "high"
+    },
+    jonathan: {
+        teacherIdentity: "jonathan",
+        teacherRole: "admin",
+        teacherAuthority: "high",
+        priorityClass: "high"
+    }
+};
+const DEFAULT_PRIVACY_RULES = [
+    "session-store fixtures stay sanitized and use fake ids, paths, and workspace roots",
+    "leading Conversation info / Sender untrusted metadata blocks are stripped before feedback extraction",
+    "assistant thinking blocks and raw tool-result payloads are excluded from passive-learning content",
+    "sender names are treated as hints for principal resolution, not source-of-truth identity proof"
+];
+function normalizeString(value) {
+    if (typeof value !== "string") {
+        return null;
+    }
+    const trimmed = value.trim();
+    return trimmed.length === 0 ? null : trimmed;
+}
+function sanitizeToken(value) {
+    const sanitized = value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+    return sanitized.length === 0 ? "unknown" : sanitized;
+}
+function slugifyIdentity(value) {
+    return value.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "");
+}
+function deriveChannel(sessionKey, entry) {
+    const deliveryChannel = normalizeString(entry.deliveryContext?.channel);
+    if (deliveryChannel !== null) {
+        return deliveryChannel;
+    }
+    const originSurface = normalizeString(entry.origin?.surface);
+    if (originSurface !== null) {
+        return originSurface;
+    }
+    const keyParts = sessionKey.split(":");
+    const transportPart = keyParts[2];
+    if (transportPart !== undefined && transportPart.length > 0) {
+        return transportPart;
+    }
+    return entry.chatType ?? "unknown";
+}
+function messageText(record) {
+    const parts = [];
+    let thinkingBlocks = 0;
+    let toolCalls = 0;
+    for (const part of record.message.content) {
+        if (part.type === "text") {
+            const normalized = normalizeString(part.text);
+            if (normalized !== null) {
+                parts.push(normalized);
+            }
+            continue;
+        }
+        if (part.type === "thinking") {
+            thinkingBlocks += 1;
+            continue;
+        }
+        if (part.type === "toolCall") {
+            toolCalls += 1;
+        }
+    }
+    return {
+        content: parts.join("\n").trim(),
+        thinkingBlocks,
+        toolCalls
+    };
+}
+function stripLeadingUntrustedMetadata(text) {
+    const blocks = text.replace(/\r\n/g, "\n").trim();
+    if (blocks.length === 0) {
+        return {
+            content: "",
+            senderName: null,
+            strippedMetadataBlockCount: 0
+        };
+    }
+    const sections = blocks
+        .split(/\n\s*\n/g)
+        .map((section) => section.trim())
+        .filter((section) => section.length > 0);
+    const remaining = [];
+    let senderName = null;
+    let strippedMetadataBlockCount = 0;
+    for (const section of sections) {
+        const lines = section.split("\n").map((line) => line.trim()).filter((line) => line.length > 0);
+        const header = lines[0] ?? "";
+        if (header === "Conversation info (untrusted metadata)" || header === "Sender (untrusted metadata)") {
+            strippedMetadataBlockCount += 1;
+            if (header === "Sender (untrusted metadata)") {
+                const senderLine = lines.find((line) => /^name:/iu.test(line) || /^display name:/iu.test(line));
+                const extracted = senderLine?.split(":").slice(1).join(":").trim() ?? null;
+                if (extracted !== null && extracted.length > 0) {
+                    senderName = extracted;
+                }
+            }
+            continue;
+        }
+        remaining.push(section);
+    }
+    return {
+        content: remaining.join("\n\n").trim(),
+        senderName,
+        strippedMetadataBlockCount
+    };
+}
+function buildPrincipalScope(sessionId, relatedInteractionId) {
+    const scopeKey = [
+        "profile:current_profile",
+        `session:${sessionId}`,
+        relatedInteractionId === null ? null : `interaction:${relatedInteractionId}`
+    ]
+        .filter((value) => value !== null)
+        .join("|");
+    if (relatedInteractionId !== null) {
+        return {
+            kind: "interaction",
+            profileSelector: "current_profile",
+            sessionId,
+            interactionId: relatedInteractionId,
+            scopeKey
+        };
+    }
+    return {
+        kind: "session",
+        profileSelector: "current_profile",
+        sessionId,
+        scopeKey
+    };
+}
+function resolveSenderIdentity(sessionId, senderName, relatedInteractionId) {
+    if (senderName === null) {
+        return {
+            actorRole: "user",
+            principal: undefined
+        };
+    }
+    const normalized = senderName.toLowerCase().replace(/\s+/g, " ").trim();
+    const known = KNOWN_PRINCIPALS[normalized];
+    if (known !== undefined) {
+        return {
+            actorRole: known.teacherRole,
+            principal: {
+                teacherIdentity: known.teacherIdentity,
+                teacherRole: known.teacherRole,
+                teacherAuthority: known.teacherAuthority,
+                priorityClass: known.priorityClass,
+                principalScope: buildPrincipalScope(sessionId, relatedInteractionId)
+            }
+        };
+    }
+    const actorIdentity = slugifyIdentity(normalized);
+    return {
+        actorRole: "user",
+        principal: actorIdentity.length === 0
+            ? undefined
+            : {
+                teacherIdentity: `scanner/actor/${actorIdentity}`,
+                teacherRole: "user",
+                teacherAuthority: "normal",
+                priorityClass: "normal",
+                principalScope: buildPrincipalScope(sessionId, relatedInteractionId)
+            }
+    };
+}
+export function buildPassiveLearningSessionExportFromOpenClawSessionStore(input) {
+    const agentId = input.agentId ?? DEFAULT_AGENT_ID;
+    const sequenceStart = input.sequenceStart ?? 1;
+    const channel = deriveChannel(input.sessionKey, input.indexEntry);
+    const sourceStream = `openclaw/runtime/${sanitizeToken(channel)}`;
+    const warnings = [];
+    const interactionEvents = [];
+    const interactionContentsById = {};
+    const feedbackRecords = [];
+    let strippedMetadataBlockCount = 0;
+    let strippedThinkingBlockCount = 0;
+    let droppedToolResultCount = 0;
+    let nextSequence = sequenceStart;
+    let latestAssistantInteractionId = null;
+    for (const record of input.records) {
+        if (record.type !== "message") {
+            continue;
+        }
+        if (record.message.role === "toolResult") {
+            droppedToolResultCount += 1;
+            continue;
+        }
+        const resolvedText = messageText(record);
+        strippedThinkingBlockCount += resolvedText.thinkingBlocks;
+        if (record.message.role === "assistant") {
+            if (resolvedText.content.length === 0) {
+                if (resolvedText.toolCalls > 0) {
+                    warnings.push(`assistant message ${record.id} only contained tool calls; skipped from passive-learning interactions`);
+                }
+                continue;
+            }
+            const eventId = `evt-session-store-assistant-${input.indexEntry.sessionId}-${record.id}`;
+            const interaction = createInteractionEvent({
+                eventId,
+                agentId,
+                sessionId: input.indexEntry.sessionId,
+                channel,
+                sequence: nextSequence,
+                kind: "message_delivered",
+                createdAt: record.timestamp,
+                source: {
+                    runtimeOwner: "openclaw",
+                    stream: sourceStream
+                },
+                messageId: record.id
+            });
+            nextSequence += 1;
+            latestAssistantInteractionId = interaction.eventId;
+            interactionEvents.push(interaction);
+            interactionContentsById[interaction.eventId] = resolvedText.content;
+            continue;
+        }
+        if (record.message.role !== "user") {
+            warnings.push(`unsupported session-store message role skipped: ${record.message.role}`);
+            continue;
+        }
+        const sanitized = stripLeadingUntrustedMetadata(resolvedText.content);
+        strippedMetadataBlockCount += sanitized.strippedMetadataBlockCount;
+        const { actorRole, principal } = resolveSenderIdentity(input.indexEntry.sessionId, sanitized.senderName, latestAssistantInteractionId);
+        if (sanitized.content.length === 0) {
+            warnings.push(`user message ${record.id} had no passive-learning content after metadata stripping`);
+            nextSequence += 1;
+            continue;
+        }
+        feedbackRecords.push({
+            recordId: record.id,
+            format: "raw",
+            createdAt: record.timestamp,
+            content: sanitized.content,
+            sequence: nextSequence,
+            messageId: record.id,
+            relatedInteractionId: latestAssistantInteractionId,
+            actorRole,
+            ...(principal === undefined ? {} : { principal })
+        });
+        nextSequence += 1;
+    }
+    const feedbackExtraction = extractFeedbackEventsFromInteractionRecords({
+        agentId,
+        sessionId: input.indexEntry.sessionId,
+        channel,
+        source: {
+            runtimeOwner: "openclaw",
+            stream: sourceStream
+        },
+        records: feedbackRecords
+    });
+    const feedbackEvents = feedbackExtraction.events.map((entry) => entry.feedbackEvent);
+    const normalizedEventExport = buildNormalizedEventExport({
+        interactionEvents,
+        feedbackEvents
+    });
+    return {
+        session: {
+            sessionKey: input.sessionKey,
+            sessionId: input.indexEntry.sessionId,
+            updatedAt: new Date(input.indexEntry.updatedAt).toISOString(),
+            channel,
+            sourceStream,
+            sessionFileBasename: input.indexEntry.sessionFile === undefined ? null : path.basename(input.indexEntry.sessionFile),
+            model: input.indexEntry.model ?? null,
+            modelProvider: input.indexEntry.modelProvider ?? null,
+            chatType: input.indexEntry.chatType ?? null,
+            systemPromptFingerprint: {
+                available: input.indexEntry.systemPromptReport !== undefined,
+                workspaceDirBasename: input.indexEntry.systemPromptReport?.workspaceDir === undefined
+                    ? null
+                    : path.basename(input.indexEntry.systemPromptReport.workspaceDir),
+                injectedWorkspaceFileCount: input.indexEntry.systemPromptReport?.injectedWorkspaceFiles?.length ?? 0,
+                missingInjectedWorkspaceFileCount: input.indexEntry.systemPromptReport?.injectedWorkspaceFiles?.filter((file) => file.missing).length ?? 0,
+                toolNames: (input.indexEntry.systemPromptReport?.tools?.entries ?? [])
+                    .map((entry) => entry.name)
+                    .filter((name) => typeof name === "string")
+            }
+        },
+        privacy: {
+            sanitized: true,
+            rules: [...DEFAULT_PRIVACY_RULES],
+            strippedMetadataBlockCount,
+            strippedThinkingBlockCount,
+            droppedToolResultCount
+        },
+        interactionEvents,
+        feedbackEvents,
+        interactionContentsById,
+        feedbackExtraction,
+        normalizedEventExport,
+        warnings,
+        nextSequence
+    };
+}
+export function buildPassiveLearningStoreExportFromOpenClawSessionIndex(input) {
+    const sessionKeys = input.sessionKeys ?? Object.keys(input.sessionIndex);
+    const orderedEntries = sessionKeys
+        .map((sessionKey) => {
+        const entry = input.sessionIndex[sessionKey];
+        if (entry === undefined) {
+            throw new Error(`missing session index entry for ${sessionKey}`);
+        }
+        return {
+            sessionKey,
+            entry
+        };
+    })
+        .sort((left, right) => {
+        if (left.entry.updatedAt !== right.entry.updatedAt) {
+            return left.entry.updatedAt - right.entry.updatedAt;
+        }
+        return left.sessionKey.localeCompare(right.sessionKey);
+    });
+    let nextSequence = 1;
+    const sessions = orderedEntries.map(({ sessionKey, entry }) => {
+        const built = buildPassiveLearningSessionExportFromOpenClawSessionStore({
+            sessionKey,
+            indexEntry: entry,
+            records: input.readSessionRecords(sessionKey, entry),
+            sequenceStart: nextSequence,
+            ...(input.agentId === undefined ? {} : { agentId: input.agentId })
+        });
+        nextSequence = built.nextSequence;
+        return built;
+    });
+    const interactionEvents = sessions.flatMap((session) => session.interactionEvents);
+    const feedbackEvents = sessions.flatMap((session) => session.feedbackEvents);
+    return {
+        sessions,
+        interactionEvents,
+        feedbackEvents,
+        normalizedEventExport: buildNormalizedEventExport({
+            interactionEvents,
+            feedbackEvents
+        }),
+        warnings: sessions.flatMap((session) => session.warnings)
+    };
+}
+//# sourceMappingURL=local-session-passive-learning.js.map

package/dist/src/local-session-passive-learning.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-session-passive-learning.js","sourceRoot":"","sources":["../../src/local-session-passive-learning.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EACL,0BAA0B,EAC1B,sBAAsB,EAQvB,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,2CAA2C,EAI5C,MAAM,6BAA6B,CAAC;AASrC,MAAM,gBAAgB,GAAG,wBAAwB,CAAC;AAClD,MAAM,gBAAgB,GAQlB;IACF,KAAK,EAAE;QACL,eAAe,EAAE,OAAO;QACxB,WAAW,EAAE,WAAW;QACxB,gBAAgB,EAAE,SAAS;QAC3B,aAAa,EAAE,UAAU;KAC1B;IACD,aAAa,EAAE;QACb,eAAe,EAAE,UAAU;QAC3B,WAAW,EAAE,OAAO;QACpB,gBAAgB,EAAE,MAAM;QACxB,aAAa,EAAE,MAAM;KACtB;IACD,QAAQ,EAAE;QACR,eAAe,EAAE,UAAU;QAC3B,WAAW,EAAE,OAAO;QACpB,gBAAgB,EAAE,MAAM;QACxB,aAAa,EAAE,MAAM;KACtB;CACF,CAAC;AAEF,MAAM,qBAAqB,GAAG;IAC5B,oFAAoF;IACpF,sGAAsG;IACtG,mGAAmG;IACnG,gGAAgG;CACxF,CAAC;AAsDX,SAAS,eAAe,CAAC,KAAc;IACrC,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,OAAO,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC;AAC/C,CAAC;AAED,SAAS,aAAa,CAAC,KAAa;IAClC,MAAM,SAAS,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IAC1F,OAAO,SAAS,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;AACxD,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;AACjF,CAAC;AAED,SAAS,aAAa,CAAC,UAAkB,EAAE,KAAgC;IACzE,MAAM,eAAe,GAAG,eAAe,CAAE,KAAK,CAAC,eAAuD,EAAE,OAAO,CAAC,CAAC;IACjH,IAAI,eAAe,KAAK,IAAI,EAAE,CAAC;QAC7B,OAAO,eAAe,CAAC;IACzB,CAAC;IAED,MAAM,aAAa,GAAG,eAAe,CAAE,KAAK,CAAC,MAA8C,EAAE,OAAO,CAAC,CAAC;IACtG,IAAI,aAAa,KAAK,IAAI,EAAE,CAAC;QAC3B,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,aAAa,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;IAClC,IAAI,aAAa,KAAK,SAAS,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5D,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO,KAAK,CAAC,QAAQ,IAAI,SAAS,CAAC;AACrC,CAAC;AAED,SAAS,WAAW,CAAC,MAAoC;IACvD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,cAAc,GAAG,CAAC,CAAC;IACvB,IAAI,SAAS,GAAG,CAAC,CAAC;IAElB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,CAAC;QAC1C,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACzB,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC9C,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;gBACxB,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;YACzB,CAAC;YACD,SAAS;QACX,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC7B,cAAc,IAAI,CAAC,CAAC;YACpB,SAAS;QACX,CAAC;QACD,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;YAC7B,SAAS,IAAI,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAED,OAAO;QACL,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;QAChC,cAAc;QACd,SAAS;KACV,CAAC;AACJ,CAAC;AAED,SAAS,6BAA6B,CAAC,IAAY;IACjD,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO;YACL,OAAO,EAAE,EAAE;YACX,UAAU,EAAE,IAAI;YAChB,0BAA0B,EAAE,CAAC;SAC9B,CAAC;IACJ,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM;SACpB,KAAK,CAAC,UAAU,CAAC;SACjB,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;SAChC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAa,EAAE,CAAC;IAC/B,IAAI,UAAU,GAAkB,IAAI,CAAC;IACrC,IAAI,0BAA0B,GAAG,CAAC,CAAC;IAEnC,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAC/F,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAE9B,IAAI,MAAM,KAAK,wCAAwC,IAAI,MAAM,KAAK,6BAA6B,EAAE,CAAC;YACpG,0BAA0B,IAAI,CAAC,CAAC;YAEhC,IAAI,MAAM,KAAK,6BAA6B,EAAE,CAAC;gBAC7C,MAAM,UAAU,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;gBAChG,MAAM,SAAS,GAAG,UAAU,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC;gBAC3E,IAAI,SAAS,KAAK,IAAI,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBAC/C,UAAU,GAAG,SAAS,CAAC;gBACzB,CAAC;YACH,CAAC;YACD,SAAS;QACX,CAAC;QAED,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IAC1B,CAAC;IAED,OAAO;QACL,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE;QACtC,UAAU;QACV,0BAA0B;KAC3B,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,SAAiB,EAAE,oBAAmC;IACjF,MAAM,QAAQ,GAAG;QACf,yBAAyB;QACzB,WAAW,SAAS,EAAE;QACtB,oBAAoB,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,oBAAoB,EAAE;KAC7E;SACE,MAAM,CAAC,CAAC,KAAK,EAAmB,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC;SAClD,IAAI,CAAC,GAAG,CAAC,CAAC;IAEb,IAAI,oBAAoB,KAAK,IAAI,EAAE,CAAC;QAClC,OAAO;YACL,IAAI,EAAE,aAAa;YACnB,eAAe,EAAE,iBAAiB;YAClC,SAAS;YACT,aAAa,EAAE,oBAAoB;YACnC,QAAQ;SACT,CAAC;IACJ,CAAC;IAED,OAAO;QACL,IAAI,EAAE,SAAS;QACf,eAAe,EAAE,iBAAiB;QAClC,SAAS;QACT,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,SAAS,qBAAqB,CAAC,SAAiB,EAAE,UAAyB,EAAE,oBAAmC;IAI9G,IAAI,UAAU,KAAK,IAAI,EAAE,CAAC;QACxB,OAAO;YACL,SAAS,EAAE,MAAM;YACjB,SAAS,EAAE,SAAS;SACrB,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACxE,MAAM,KAAK,GAAG,gBAAgB,CAAC,UAAU,CAAC,CAAC;IAC3C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO;YACL,SAAS,EAAE,KAAK,CAAC,WAAW;YAC5B,SAAS,EAAE;gBACT,eAAe,EAAE,KAAK,CAAC,eAAe;gBACtC,WAAW,EAAE,KAAK,CAAC,WAAW;gBAC9B,gBAAgB,EAAE,KAAK,CAAC,gBAAgB;gBACxC,aAAa,EAAE,KAAK,CAAC,aAAa;gBAClC,cAAc,EAAE,mBAAmB,CAAC,SAAS,EAAE,oBAAoB,CAAC;aACrE;SACF,CAAC;IACJ,CAAC;IAED,MAAM,aAAa,GAAG,eAAe,CAAC,UAAU,CAAC,CAAC;IAClD,OAAO;QACL,SAAS,EAAE,MAAM;QACjB,SAAS,EAAE,aAAa,CAAC,MAAM,KAAK,CAAC;YACnC,CAAC,CAAC,SAAS;YACX,CAAC,CAAC;gBACE,eAAe,EAAE,iBAAiB,aAAa,EAAE;gBACjD,WAAW,EAAE,MAAM;gBACnB,gBAAgB,EAAE,QAAQ;gBAC1B,aAAa,EAAE,QAAQ;gBACvB,cAAc,EAAE,mBAAmB,CAAC,SAAS,EAAE,oBAAoB,CAAC;aACrE;KACN,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yDAAyD,CAAC,KAMzE;IACC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,gBAAgB,CAAC;IAClD,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,IAAI,CAAC,CAAC;IAC/C,MAAM,OAAO,GAAG,aAAa,CAAC,KAAK,CAAC,UAAU,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;IAClE,MAAM,YAAY,GAAG,oBAAoB,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC;IAClE,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,MAAM,iBAAiB,GAAyB,EAAE,CAAC;IACnD,MAAM,uBAAuB,GAA2B,EAAE,CAAC;IAC3D,MAAM,eAAe,GAA4C,EAAE,CAAC;IACpE,IAAI,0BAA0B,GAAG,CAAC,CAAC;IACnC,IAAI,0BAA0B,GAAG,CAAC,CAAC;IACnC,IAAI,sBAAsB,GAAG,CAAC,CAAC;IAC/B,IAAI,YAAY,GAAG,aAAa,CAAC;IACjC,IAAI,4BAA4B,GAAkB,IAAI,CAAC;IAEvD,KAAK,MAAM,MAAM,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QACnC,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC9B,SAAS;QACX,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,KAAK,YAAY,EAAE,CAAC;YACzC,sBAAsB,IAAI,CAAC,CAAC;YAC5B,SAAS;QACX,CAAC;QAED,MAAM,YAAY,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QACzC,0BAA0B,IAAI,YAAY,CAAC,cAAc,CAAC;QAE1D,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;YACxC,IAAI,YAAY,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtC,IAAI,YAAY,CAAC,SAAS,GAAG,CAAC,EAAE,CAAC;oBAC/B,QAAQ,CAAC,IAAI,CAAC,qBAAqB,MAAM,CAAC,EAAE,wEAAwE,CAAC,CAAC;gBACxH,CAAC;gBACD,SAAS;YACX,CAAC;YAED,MAAM,OAAO,GAAG,+BAA+B,KAAK,CAAC,UAAU,CAAC,SAAS,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;YACzF,MAAM,WAAW,GAAG,sBAAsB,CAAC;gBACzC,OAAO;gBACP,OAAO;gBACP,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,SAAS;gBACrC,OAAO;gBACP,QAAQ,EAAE,YAAY;gBACtB,IAAI,EAAE,mBAAmB;gBACzB,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,MAAM,EAAE;oBACN,YAAY,EAAE,UAAU;oBACxB,MAAM,EAAE,YAAY;iBACrB;gBACD,SAAS,EAAE,MAAM,CAAC,EAAE;aACrB,CAAC,CAAC;YACH,YAAY,IAAI,CAAC,CAAC;YAClB,4BAA4B,GAAG,WAAW,CAAC,OAAO,CAAC;YACnD,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YACpC,uBAAuB,CAAC,WAAW,CAAC,OAAO,CAAC,GAAG,YAAY,CAAC,OAAO,CAAC;YACpE,SAAS;QACX,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YACnC,QAAQ,CAAC,IAAI,CAAC,mDAAmD,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;YACxF,SAAS;QACX,CAAC;QAED,MAAM,SAAS,GAAG,6BAA6B,CAAC,YAAY,CAAC,OAAO,CAAC,CAAC;QACtE,0BAA0B,IAAI,SAAS,CAAC,0BAA0B,CAAC;QACnE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,GAAG,qBAAqB,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,UAAU,EAAE,4BAA4B,CAAC,CAAC;QACvI,IAAI,SAAS,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACnC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,MAAM,CAAC,EAAE,2DAA2D,CAAC,CAAC;YACpG,YAAY,IAAI,CAAC,CAAC;YAClB,SAAS;QACX,CAAC;QAED,eAAe,CAAC,IAAI,CAAC;YACnB,QAAQ,EAAE,MAAM,CAAC,EAAE;YACnB,MAAM,EAAE,KAAK;YACb,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,QAAQ,EAAE,YAAY;YACtB,SAAS,EAAE,MAAM,CAAC,EAAE;YACpB,oBAAoB,EAAE,4BAA4B;YAClD,SAAS;YACT,GAAG,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC;SAClD,CAAC,CAAC;QACH,YAAY,IAAI,CAAC,CAAC;IACpB,CAAC;IAED,MAAM,kBAAkB,GAAG,2CAA2C,CAAC;QACrE,OAAO;QACP,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,SAAS;QACrC,OAAO;QACP,MAAM,EAAE;YACN,YAAY,EAAE,UAAU;YACxB,MAAM,EAAE,YAAY;SACrB;QACD,OAAO,EAAE,eAAe;KACzB,CAAC,CAAC;IACH,MAAM,cAAc,GAAG,kBAAkB,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACrF,MAAM,qBAAqB,GAAG,0BAA0B,CAAC;QACvD,iBAAiB;QACjB,cAAc;KACf,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE;YACP,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,SAAS;YACrC,SAAS,EAAE,IAAI,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE;YAC7D,OAAO;YACP,YAAY;YACZ,mBAAmB,EAAE,KAAK,CAAC,UAAU,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,WAAW,CAAC;YACpH,KAAK,EAAE,KAAK,CAAC,UAAU,CAAC,KAAK,IAAI,IAAI;YACrC,aAAa,EAAE,KAAK,CAAC,UAAU,CAAC,aAAa,IAAI,IAAI;YACrD,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,QAAQ,IAAI,IAAI;YAC3C,uBAAuB,EAAE;gBACvB,SAAS,EAAE,KAAK,CAAC,UAAU,CAAC,kBAAkB,KAAK,SAAS;gBAC5D,oBAAoB,EAClB,KAAK,CAAC,UAAU,CAAC,kBAAkB,EAAE,YAAY,KAAK,SAAS;oBAC7D,CAAC,CAAC,IAAI;oBACN,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,kBAAkB,CAAC,YAAY,CAAC;gBACrE,0BAA0B,EAAE,KAAK,CAAC,UAAU,CAAC,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,IAAI,CAAC;gBACpG,iCAAiC,EAC/B,KAAK,CAAC,UAAU,CAAC,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,IAAI,CAAC;gBACzG,SAAS,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,kBAAkB,EAAE,KAAK,EAAE,OAAO,IAAI,EAAE,CAAC;qBACnE,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;qBAC1B,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC;aAC9D;SACF;QACD,OAAO,EAAE;YACP,SAAS,EAAE,IAAI;YACf,KAAK,EAAE,CAAC,GAAG,qBAAqB,CAAC;YACjC,0BAA0B;YAC1B,0BAA0B;YAC1B,sBAAsB;SACvB;QACD,iBAAiB;QACjB,cAAc;QACd,uBAAuB;QACvB,kBAAkB;QAClB,qBAAqB;QACrB,QAAQ;QACR,YAAY;KACb,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uDAAuD,CAAC,KAKvE;IACC,MAAM,WAAW,GAAG,KAAK,CAAC,WAAW,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC;IACzE,MAAM,cAAc,GAAG,WAAW;SAC/B,GAAG,CAAC,CAAC,UAAU,EAAE,EAAE;QAClB,MAAM,KAAK,GAAG,KAAK,CAAC,YAAY,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACxB,MAAM,IAAI,KAAK,CAAC,mCAAmC,UAAU,EAAE,CAAC,CAAC;QACnE,CAAC;QACD,OAAO;YACL,UAAU;YACV,KAAK;SACN,CAAC;IACJ,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE;QACpB,IAAI,IAAI,CAAC,KAAK,CAAC,SAAS,KAAK,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC;YACnD,OAAO,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,SAAS,CAAC;QACtD,CAAC;QACD,OAAO,IAAI,CAAC,UAAU,CAAC,aAAa,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;IACzD,CAAC,CAAC,CAAC;IAEL,IAAI,YAAY,GAAG,CAAC,CAAC;IACrB,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,EAAE,EAAE;QAC5D,MAAM,KAAK,GAAG,yDAAyD,CAAC;YACtE,UAAU;YACV,UAAU,EAAE,KAAK;YACjB,OAAO,EAAE,KAAK,CAAC,kBAAkB,CAAC,UAAU,EAAE,KAAK,CAAC;YACpD,aAAa,EAAE,YAAY;YAC3B,GAAG,CAAC,KAAK,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;SACnE,CAAC,CAAC;QACH,YAAY,GAAG,KAAK,CAAC,YAAY,CAAC;QAClC,OAAO,KAAK,CAAC;IACf,CAAC,CAAC,CAAC;IAEH,MAAM,iBAAiB,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;IACnF,MAAM,cAAc,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;IAE7E,OAAO;QACL,QAAQ;QACR,iBAAiB;QACjB,cAAc;QACd,qBAAqB,EAAE,0BAA0B,CAAC;YAChD,iBAAiB;YACjB,cAAc;SACf,CAAC;QACF,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC;KAC1D,CAAC;AACJ,CAAC"}

package/dist/src/session-store.d.ts

@@ -0,0 +1,150 @@
+export interface OpenClawInjectedWorkspaceFile {
+    name: string;
+    path: string;
+    missing: boolean;
+    rawChars: number;
+    injectedChars: number;
+    truncated: boolean;
+}
+export interface OpenClawToolSurfaceEntry {
+    name: string;
+    summaryChars: number;
+    schemaChars: number;
+    propertiesCount: number;
+}
+export interface OpenClawSystemPromptReport {
+    source?: string;
+    generatedAt?: number;
+    sessionId?: string;
+    sessionKey?: string;
+    provider?: string;
+    model?: string;
+    workspaceDir?: string;
+    injectedWorkspaceFiles?: readonly OpenClawInjectedWorkspaceFile[];
+    tools?: {
+        listChars?: number;
+        schemaChars?: number;
+        entries?: readonly OpenClawToolSurfaceEntry[];
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export interface OpenClawSessionIndexEntry {
+    sessionId: string;
+    updatedAt: number;
+    sessionFile?: string;
+    model?: string;
+    modelProvider?: string;
+    chatType?: string;
+    origin?: Record<string, unknown>;
+    deliveryContext?: Record<string, unknown>;
+    systemPromptReport?: OpenClawSystemPromptReport;
+    [key: string]: unknown;
+}
+export type OpenClawSessionIndex = Record<string, OpenClawSessionIndexEntry>;
+export interface OpenClawSessionTextPart {
+    type: "text";
+    text: string;
+    textSignature?: string;
+    [key: string]: unknown;
+}
+export interface OpenClawSessionThinkingPart {
+    type: "thinking";
+    thinking: string;
+    thinkingSignature?: string;
+    [key: string]: unknown;
+}
+export interface OpenClawSessionToolCallPart {
+    type: "toolCall";
+    id: string;
+    name: string;
+    arguments: Record<string, unknown>;
+    partialJson?: string;
+    [key: string]: unknown;
+}
+export interface OpenClawSessionUnknownContentPart {
+    type: string;
+    [key: string]: unknown;
+}
+export type OpenClawSessionContentPart = OpenClawSessionTextPart | OpenClawSessionThinkingPart | OpenClawSessionToolCallPart | OpenClawSessionUnknownContentPart;
+export interface OpenClawSessionMessagePayload {
+    role: string;
+    content: readonly OpenClawSessionContentPart[];
+    timestamp: number;
+    toolCallId?: string;
+    toolName?: string;
+    details?: Record<string, unknown>;
+    isError?: boolean;
+    api?: string;
+    provider?: string;
+    model?: string;
+    usage?: Record<string, unknown>;
+    stopReason?: string;
+    [key: string]: unknown;
+}
+export interface OpenClawSessionHeaderRecord {
+    type: "session";
+    version: number;
+    id: string;
+    timestamp: string;
+    cwd: string;
+}
+export interface OpenClawSessionModelChangeRecord {
+    type: "model_change";
+    id: string;
+    parentId: string | null;
+    timestamp: string;
+    provider: string;
+    modelId: string;
+}
+export interface OpenClawSessionThinkingLevelChangeRecord {
+    type: "thinking_level_change";
+    id: string;
+    parentId: string | null;
+    timestamp: string;
+    thinkingLevel: string;
+}
+export interface OpenClawSessionCustomRecord {
+    type: "custom";
+    customType: string;
+    data: Record<string, unknown>;
+    id: string;
+    parentId: string | null;
+    timestamp: string;
+}
+export interface OpenClawSessionMessageRecord {
+    type: "message";
+    id: string;
+    parentId: string | null;
+    timestamp: string;
+    message: OpenClawSessionMessagePayload;
+}
+export type OpenClawSessionRecord = OpenClawSessionHeaderRecord | OpenClawSessionModelChangeRecord | OpenClawSessionThinkingLevelChangeRecord | OpenClawSessionCustomRecord | OpenClawSessionMessageRecord;
+export interface OpenClawAcpStreamRecord {
+    ts: string;
+    epochMs: number;
+    runId: string;
+    parentSessionKey: string;
+    childSessionKey: string;
+    agentId: string;
+    kind: string;
+    contextKey?: string;
+    text?: string;
+    delta?: string;
+    phase?: string;
+    data?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface OpenClawMainSessionStoreV1 {
+    profileRoot: string;
+    agentId: "main";
+    sessionsDir: string;
+    indexPath: string;
+}
+export declare function loadOpenClawSessionIndex(indexFilePath: string): OpenClawSessionIndex;
+export declare function readOpenClawSessionFile(sessionFilePath: string): OpenClawSessionRecord[];
+export declare function readOpenClawAcpStreamFile(streamFilePath: string): OpenClawAcpStreamRecord[];
+export declare function discoverOpenClawMainSessionStores(options?: {
+    homeDir?: string;
+    profileRoots?: readonly string[];
+}): OpenClawMainSessionStoreV1[];