@openclawbrain/openclaw 0.1.12 → 0.2.0

package/dist/src/import-export.js

@@ -0,0 +1,171 @@
+/**
+ * Brain import/export: backup and restore the activation root directory.
+ *
+ * export: tar + gzip the entire activation root → output.tar.gz
+ * import: extract tar.gz → activation root, with safety checks
+ */
+import { execSync } from "node:child_process";
+import { existsSync, mkdirSync, readdirSync, statSync } from "node:fs";
+import path from "node:path";
+/**
+ * Verify the activation root looks valid (has activation-pointers.json).
+ */
+function validateActivationRoot(activationRoot) {
+    if (!existsSync(activationRoot)) {
+        throw new Error(`Activation root does not exist: ${activationRoot}`);
+    }
+    const pointersPath = path.join(activationRoot, "activation-pointers.json");
+    if (!existsSync(pointersPath)) {
+        throw new Error(`activation-pointers.json not found in ${activationRoot}. ` +
+            `This doesn't look like a valid activation root.`);
+    }
+}
+/**
+ * Check if a tar.gz archive contains activation-pointers.json at the top level.
+ */
+function archiveContainsPointers(archivePath) {
+    try {
+        const listing = execSync(`tar tzf ${JSON.stringify(archivePath)}`, {
+            encoding: "utf8",
+            maxBuffer: 10 * 1024 * 1024,
+        });
+        const entries = listing.split("\n").map((e) => e.replace(/^\.\//, ""));
+        return entries.some((e) => e === "activation-pointers.json" || e.endsWith("/activation-pointers.json"));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Check if activation root already has meaningful data.
+ */
+function activationRootHasData(activationRoot) {
+    if (!existsSync(activationRoot))
+        return false;
+    try {
+        const entries = readdirSync(activationRoot);
+        return entries.length > 0;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Export (backup) the activation root to a tar.gz archive.
+ */
+export function exportBrain(options) {
+    const { activationRoot, outputPath } = options;
+    const resolvedRoot = path.resolve(activationRoot);
+    const resolvedOutput = path.resolve(outputPath);
+    try {
+        validateActivationRoot(resolvedRoot);
+        // Ensure output directory exists
+        const outputDir = path.dirname(resolvedOutput);
+        if (!existsSync(outputDir)) {
+            mkdirSync(outputDir, { recursive: true });
+        }
+        // Create tar.gz from the activation root contents
+        execSync(`tar czf ${JSON.stringify(resolvedOutput)} -C ${JSON.stringify(resolvedRoot)} .`, { stdio: "pipe" });
+        // Verify the archive was created
+        if (!existsSync(resolvedOutput)) {
+            return {
+                ok: false,
+                outputPath: resolvedOutput,
+                activationRoot: resolvedRoot,
+                error: "Archive was not created (tar returned success but file missing)",
+            };
+        }
+        const stats = statSync(resolvedOutput);
+        return {
+            ok: true,
+            outputPath: resolvedOutput,
+            activationRoot: resolvedRoot,
+        };
+    }
+    catch (err) {
+        return {
+            ok: false,
+            outputPath: resolvedOutput,
+            activationRoot: resolvedRoot,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+/**
+ * Import (restore) a tar.gz archive into the activation root.
+ */
+export function importBrain(options) {
+    const { archivePath, activationRoot, force } = options;
+    const resolvedArchive = path.resolve(archivePath);
+    const resolvedRoot = path.resolve(activationRoot);
+    try {
+        // Verify archive exists
+        if (!existsSync(resolvedArchive)) {
+            return {
+                ok: false,
+                activationRoot: resolvedRoot,
+                archivePath: resolvedArchive,
+                error: `Archive not found: ${resolvedArchive}`,
+            };
+        }
+        // Verify archive contains activation-pointers.json
+        if (!archiveContainsPointers(resolvedArchive)) {
+            return {
+                ok: false,
+                activationRoot: resolvedRoot,
+                archivePath: resolvedArchive,
+                error: "Archive does not contain activation-pointers.json. " +
+                    "This doesn't look like a valid brain backup.",
+            };
+        }
+        // Check if activation root already has data
+        let warning;
+        if (activationRootHasData(resolvedRoot)) {
+            if (!force) {
+                return {
+                    ok: false,
+                    activationRoot: resolvedRoot,
+                    archivePath: resolvedArchive,
+                    error: `Activation root ${resolvedRoot} already contains data. ` +
+                        `Use --force to overwrite.`,
+                };
+            }
+            warning = `Overwrote existing data in ${resolvedRoot}`;
+        }
+        // Create activation root if needed
+        if (!existsSync(resolvedRoot)) {
+            mkdirSync(resolvedRoot, { recursive: true });
+        }
+        // Extract archive
+        execSync(`tar xzf ${JSON.stringify(resolvedArchive)} -C ${JSON.stringify(resolvedRoot)}`, { stdio: "pipe" });
+        // Verify extraction produced activation-pointers.json
+        const pointersPath = path.join(resolvedRoot, "activation-pointers.json");
+        if (!existsSync(pointersPath)) {
+            return {
+                ok: false,
+                activationRoot: resolvedRoot,
+                archivePath: resolvedArchive,
+                error: "Extraction completed but activation-pointers.json not found. " +
+                    "The archive may have a nested directory structure.",
+            };
+        }
+        const result = {
+            ok: true,
+            activationRoot: resolvedRoot,
+            archivePath: resolvedArchive,
+        };
+        if (warning !== undefined) {
+            result.warning = warning;
+        }
+        return result;
+    }
+    catch (err) {
+        return {
+            ok: false,
+            activationRoot: resolvedRoot,
+            archivePath: resolvedArchive,
+            error: err instanceof Error ? err.message : String(err),
+        };
+    }
+}
+//# sourceMappingURL=import-export.js.map

package/dist/src/import-export.js.map

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

package/dist/src/index.d.ts

@@ -1422,3 +1422,5 @@ export { describeActivationObservability, inspectActivationState, rollbackActive
 export { createOpenClawLocalSessionTail, OpenClawLocalSessionTail, type OpenClawLocalSessionTailChangeKindV1, type OpenClawLocalSessionTailChangeV1, type OpenClawLocalSessionTailCursorV1, type OpenClawLocalSessionTailInput, type OpenClawLocalSessionTailLoopOptionsV1, type OpenClawLocalSessionTailLoopResultV1, type OpenClawLocalSessionTailNoopReasonV1, type OpenClawLocalSessionTailPollResultV1 } from "./session-tail.js";
 export { discoverOpenClawMainSessionStores, loadOpenClawSessionIndex, readOpenClawAcpStreamFile, readOpenClawSessionFile, type OpenClawMainSessionStoreV1, type OpenClawAcpStreamRecord, type OpenClawInjectedWorkspaceFile, type OpenClawSessionContentPart, type OpenClawSessionCustomRecord, type OpenClawSessionHeaderRecord, type OpenClawSessionIndex, type OpenClawSessionIndexEntry, type OpenClawSessionMessagePayload, type OpenClawSessionMessageRecord, type OpenClawSessionModelChangeRecord, type OpenClawSessionRecord, type OpenClawSessionTextPart, type OpenClawSessionThinkingLevelChangeRecord, type OpenClawSessionThinkingPart, type OpenClawSessionToolCallPart, type OpenClawSystemPromptReport, type OpenClawToolSurfaceEntry } from "./session-store.js";
 export { buildPassiveLearningSessionExportFromOpenClawSessionStore, buildPassiveLearningStoreExportFromOpenClawSessionIndex, type OpenClawPassiveLearningPrivacySummaryV1, type OpenClawPassiveLearningSessionEvidenceV1, type OpenClawPassiveLearningSessionExportV1, type OpenClawPassiveLearningStoreExportV1 } from "./local-session-passive-learning.js";
+export { resolveActivationRoot, type ResolveActivationRootOptions } from "./resolve-activation-root.js";
+export { runDaemonCommand, type DaemonCliArgs, type DaemonSubcommand, parseDaemonArgs } from "./daemon.js";

package/dist/src/index.js

@@ -5200,4 +5200,6 @@ export { describeActivationObservability, inspectActivationState, rollbackActive
 export { createOpenClawLocalSessionTail, OpenClawLocalSessionTail } from "./session-tail.js";
 export { discoverOpenClawMainSessionStores, loadOpenClawSessionIndex, readOpenClawAcpStreamFile, readOpenClawSessionFile } from "./session-store.js";
 export { buildPassiveLearningSessionExportFromOpenClawSessionStore, buildPassiveLearningStoreExportFromOpenClawSessionIndex } from "./local-session-passive-learning.js";
+export { resolveActivationRoot } from "./resolve-activation-root.js";
+export { runDaemonCommand, parseDaemonArgs } from "./daemon.js";
 //# sourceMappingURL=index.js.map