@openclawbrain/openclaw 0.1.10 → 0.1.12

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[];

package/dist/src/session-store.js

@@ -0,0 +1,199 @@
+import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { homedir } from "node:os";
+import path from "node:path";
+export function loadOpenClawSessionIndex(indexFilePath) {
+    return parseJsonFile(indexFilePath);
+}
+export function readOpenClawSessionFile(sessionFilePath) {
+    return readJsonlFile(sessionFilePath, parseOpenClawSessionRecord);
+}
+export function readOpenClawAcpStreamFile(streamFilePath) {
+    return readJsonlFile(streamFilePath, parseOpenClawAcpStreamRecord);
+}
+export function discoverOpenClawMainSessionStores(options = {}) {
+    const candidateRoots = options.profileRoots !== undefined
+        ? [...new Set(options.profileRoots.map((root) => path.resolve(root)))]
+        : discoverOpenClawProfileRoots(options.homeDir);
+    return candidateRoots
+        .map((profileRoot) => {
+        const sessionsDir = path.join(profileRoot, "agents", "main", "sessions");
+        const indexPath = path.join(sessionsDir, "sessions.json");
+        if (!existsSync(indexPath)) {
+            return null;
+        }
+        return {
+            profileRoot,
+            agentId: "main",
+            sessionsDir,
+            indexPath
+        };
+    })
+        .filter((store) => store !== null)
+        .sort((left, right) => left.indexPath.localeCompare(right.indexPath));
+}
+function discoverOpenClawProfileRoots(homeDir) {
+    const rootDir = path.resolve(homeDir ?? homedir());
+    if (!existsSync(rootDir)) {
+        return [];
+    }
+    return readdirSync(rootDir, { withFileTypes: true })
+        .filter((entry) => entry.isDirectory() && entry.name.startsWith(".openclaw-"))
+        .map((entry) => path.join(rootDir, entry.name))
+        .sort((left, right) => left.localeCompare(right));
+}
+function parseJsonFile(filePath) {
+    return JSON.parse(readFileSync(filePath, "utf8"));
+}
+function readJsonlFile(filePath, parseRecord) {
+    const text = readFileSync(filePath, "utf8");
+    if (text.trim() === "") {
+        return [];
+    }
+    return text
+        .split(/\r?\n/)
+        .filter((line) => line.trim().length > 0)
+        .map((line, index) => {
+        try {
+            return parseRecord(JSON.parse(line), index + 1);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            throw new Error(`Could not parse JSONL record at ${filePath}:${index + 1}: ${message}`);
+        }
+    });
+}
+function parseOpenClawSessionRecord(value, lineNumber) {
+    const record = expectRecord(value, lineNumber);
+    const type = expectString(record.type, `${lineNumber}.type`);
+    switch (type) {
+        case "session":
+            return {
+                type,
+                version: expectNumber(record.version, `${lineNumber}.version`),
+                id: expectString(record.id, `${lineNumber}.id`),
+                timestamp: expectString(record.timestamp, `${lineNumber}.timestamp`),
+                cwd: expectString(record.cwd, `${lineNumber}.cwd`)
+            };
+        case "model_change":
+            return {
+                type,
+                id: expectString(record.id, `${lineNumber}.id`),
+                parentId: expectNullableString(record.parentId, `${lineNumber}.parentId`),
+                timestamp: expectString(record.timestamp, `${lineNumber}.timestamp`),
+                provider: expectString(record.provider, `${lineNumber}.provider`),
+                modelId: expectString(record.modelId, `${lineNumber}.modelId`)
+            };
+        case "thinking_level_change":
+            return {
+                type,
+                id: expectString(record.id, `${lineNumber}.id`),
+                parentId: expectNullableString(record.parentId, `${lineNumber}.parentId`),
+                timestamp: expectString(record.timestamp, `${lineNumber}.timestamp`),
+                thinkingLevel: expectString(record.thinkingLevel, `${lineNumber}.thinkingLevel`)
+            };
+        case "custom":
+            return {
+                type,
+                customType: expectString(record.customType, `${lineNumber}.customType`),
+                data: expectRecord(record.data, `${lineNumber}.data`),
+                id: expectString(record.id, `${lineNumber}.id`),
+                parentId: expectNullableString(record.parentId, `${lineNumber}.parentId`),
+                timestamp: expectString(record.timestamp, `${lineNumber}.timestamp`)
+            };
+        case "message":
+            return {
+                type,
+                id: expectString(record.id, `${lineNumber}.id`),
+                parentId: expectNullableString(record.parentId, `${lineNumber}.parentId`),
+                timestamp: expectString(record.timestamp, `${lineNumber}.timestamp`),
+                message: parseMessagePayload(record.message, `${lineNumber}.message`)
+            };
+        default:
+            throw new Error(`Unknown OpenClaw session record type: ${type}`);
+    }
+}
+function parseMessagePayload(value, path) {
+    const payload = expectRecord(value, path);
+    const content = expectArray(payload.content, `${path}.content`).map((entry, index) => parseContentPart(entry, `${path}.content[${index}]`));
+    return {
+        ...payload,
+        role: expectString(payload.role, `${path}.role`),
+        content,
+        timestamp: expectNumber(payload.timestamp, `${path}.timestamp`)
+    };
+}
+function parseContentPart(value, path) {
+    const content = expectRecord(value, path);
+    const type = expectString(content.type, `${path}.type`);
+    if (type === "text") {
+        return {
+            ...content,
+            type,
+            text: expectString(content.text, `${path}.text`)
+        };
+    }
+    if (type === "thinking") {
+        return {
+            ...content,
+            type,
+            thinking: expectString(content.thinking, `${path}.thinking`)
+        };
+    }
+    if (type === "toolCall") {
+        return {
+            ...content,
+            type,
+            id: expectString(content.id, `${path}.id`),
+            name: expectString(content.name, `${path}.name`),
+            arguments: expectRecord(content.arguments, `${path}.arguments`)
+        };
+    }
+    return {
+        ...content,
+        type
+    };
+}
+function parseOpenClawAcpStreamRecord(value, lineNumber) {
+    const record = expectRecord(value, lineNumber);
+    return {
+        ...record,
+        ts: expectString(record.ts, `${lineNumber}.ts`),
+        epochMs: expectNumber(record.epochMs, `${lineNumber}.epochMs`),
+        runId: expectString(record.runId, `${lineNumber}.runId`),
+        parentSessionKey: expectString(record.parentSessionKey, `${lineNumber}.parentSessionKey`),
+        childSessionKey: expectString(record.childSessionKey, `${lineNumber}.childSessionKey`),
+        agentId: expectString(record.agentId, `${lineNumber}.agentId`),
+        kind: expectString(record.kind, `${lineNumber}.kind`)
+    };
+}
+function expectRecord(value, path) {
+    if (value === null || typeof value !== "object" || Array.isArray(value)) {
+        throw new Error(`${path} must be an object`);
+    }
+    return value;
+}
+function expectArray(value, path) {
+    if (!Array.isArray(value)) {
+        throw new Error(`${path} must be an array`);
+    }
+    return value;
+}
+function expectString(value, path) {
+    if (typeof value !== "string") {
+        throw new Error(`${path} must be a string`);
+    }
+    return value;
+}
+function expectNullableString(value, path) {
+    if (value === null) {
+        return null;
+    }
+    return expectString(value, path);
+}
+function expectNumber(value, path) {
+    if (typeof value !== "number" || !Number.isFinite(value)) {
+        throw new Error(`${path} must be a finite number`);
+    }
+    return value;
+}
+//# sourceMappingURL=session-store.js.map

package/dist/src/session-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-store.js","sourceRoot":"","sources":["../../src/session-store.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,68 @@
+import { type OpenClawMainSessionStoreV1 } from "./session-store.js";
+import type { ScannedEventExportInputV1 } from "./index.js";
+export type OpenClawLocalSessionTailNoopReasonV1 = "seeded_existing_sessions" | "no_local_session_stores" | "no_session_changes";
+export type OpenClawLocalSessionTailChangeKindV1 = "new_session" | "appended_records" | "metadata_only" | "session_reset" | "missing_session_path" | "missing_session_file";
+export interface OpenClawLocalSessionTailCursorV1 {
+    sourceIndexPath: string;
+    sessionKey: string;
+    sessionId: string;
+    sessionFile: string | null;
+    updatedAt: number;
+    rawRecordCount: number;
+    bridgedEventCount: number;
+}
+export interface OpenClawLocalSessionTailChangeV1 {
+    source: OpenClawMainSessionStoreV1;
+    sessionKey: string;
+    sessionId: string;
+    sessionFile: string | null;
+    changeKind: OpenClawLocalSessionTailChangeKindV1;
+    rawRecordCount: number;
+    bridgedEventCount: number;
+    emittedEventCount: number;
+    warnings: string[];
+    scannedEventExport: ScannedEventExportInputV1 | null;
+}
+export interface OpenClawLocalSessionTailPollResultV1 {
+    runtimeOwner: "openclaw";
+    lane: "local_session_tail";
+    polledAt: string;
+    sources: OpenClawMainSessionStoreV1[];
+    changes: OpenClawLocalSessionTailChangeV1[];
+    noopReason: OpenClawLocalSessionTailNoopReasonV1 | null;
+    warnings: string[];
+    cursor: OpenClawLocalSessionTailCursorV1[];
+}
+export interface OpenClawLocalSessionTailInput {
+    homeDir?: string;
+    profileRoots?: readonly string[];
+}
+export interface OpenClawLocalSessionTailLoopOptionsV1 {
+    pollIntervalMs?: number;
+    maxPasses?: number;
+    stopWhenIdle?: boolean;
+    signal?: AbortSignal;
+    onPass?: (result: OpenClawLocalSessionTailPollResultV1) => void | Promise<void>;
+}
+export interface OpenClawLocalSessionTailLoopResultV1 {
+    runtimeOwner: "openclaw";
+    passCount: number;
+    changedSessionCount: number;
+    emittedEventCount: number;
+    stoppedReason: "idle" | "max_passes" | "aborted";
+    lastPoll: OpenClawLocalSessionTailPollResultV1 | null;
+    cursor: OpenClawLocalSessionTailCursorV1[];
+}
+export declare class OpenClawLocalSessionTail {
+    readonly homeDir: string | undefined;
+    readonly profileRoots: readonly string[] | undefined;
+    private initialized;
+    private readonly cursorBySession;
+    constructor(input?: OpenClawLocalSessionTailInput);
+    snapshot(): OpenClawLocalSessionTailCursorV1[];
+    pollOnce(options?: {
+        observedAt?: string;
+    }): OpenClawLocalSessionTailPollResultV1;
+    runLoop(options?: OpenClawLocalSessionTailLoopOptionsV1): Promise<OpenClawLocalSessionTailLoopResultV1>;
+}
+export declare function createOpenClawLocalSessionTail(input?: OpenClawLocalSessionTailInput): OpenClawLocalSessionTail;