@openclaw-cloud/agent-controller 0.2.7 → 0.2.9

package/bin/agent-controller.js

@@ -19,6 +19,12 @@ if (command === '--version' || command === '-v') {
 } else if (command === 'self-update' || command === 'update') {
   const { selfUpdate } = await import('../dist/commands/self-update.js');
   await selfUpdate(pkg.version);
+} else if (command === 'backup') {
+  const { runBackup } = await import('../dist/commands/backup-cli.js');
+  await runBackup();
+} else if (command === 'knowledge_sync' || command === 'knowledge-sync') {
+  const { runKnowledgeSync } = await import('../dist/commands/knowledge-sync-cli.js');
+  await runKnowledgeSync();
 } else if (command === 'install') {
   const { install } = await import('../dist/commands/install.js');
   await install();

package/dist/commands/backup-cli.d.ts

@@ -0,0 +1 @@
+export declare function runBackup(): Promise<void>;

package/dist/commands/backup-cli.js

@@ -0,0 +1,66 @@
+import { exec } from 'node:child_process';
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+function getWorkspaceDir() {
+    const stateDir = process.env.OPENCLAW_STATE_DIR?.trim() ?? path.join(os.homedir(), '.openclaw');
+    return path.join(stateDir, 'workspace');
+}
+function requireEnv(name) {
+    const value = process.env[name];
+    if (!value) {
+        console.error(`Missing required env: ${name}`);
+        process.exit(1);
+    }
+    return value;
+}
+function createArchive(archivePath, workspaceDir) {
+    return new Promise((resolve, reject) => {
+        exec(`tar -czf ${archivePath} -C ${path.dirname(workspaceDir)} ${path.basename(workspaceDir)}`, { timeout: 120_000 }, (err, _stdout, stderr) => {
+            if (err)
+                reject(new Error(`tar failed: ${stderr || err.message}`));
+            else
+                resolve();
+        });
+    });
+}
+export async function runBackup() {
+    const backendUrl = requireEnv('BACKEND_INTERNAL_URL');
+    const agentToken = requireEnv('AGENT_TOKEN');
+    const agentId = requireEnv('AGENT_ID');
+    console.log('Initialising backup...');
+    // Step 1: Get upload URL from backend
+    const initRes = await fetch(`${backendUrl}/api/internal/agents/${agentId}/backup/init`, {
+        method: 'POST',
+        headers: { Authorization: `Bearer ${agentToken}` },
+    });
+    if (!initRes.ok) {
+        const text = await initRes.text().catch(() => '');
+        console.error(`Backup init failed: ${initRes.status} ${text}`);
+        process.exit(1);
+    }
+    const { snapshotId, token } = await initRes.json();
+    const uploadUrl = `${backendUrl}/api/internal/agents/${agentId}/knowledge/upload?snapshotId=${snapshotId}`;
+    // Step 2: Create archive
+    const archivePath = path.join('/tmp', `backup-${Date.now()}.tar.gz`);
+    console.log('Creating archive...');
+    await createArchive(archivePath, getWorkspaceDir());
+    // Step 3: Upload
+    console.log(`Uploading to ${uploadUrl}...`);
+    const fileBuffer = await fs.readFile(archivePath);
+    const stat = await fs.stat(archivePath);
+    const uploadRes = await fetch(uploadUrl, {
+        method: 'POST',
+        headers: { 'Content-Type': 'application/gzip', Authorization: `Bearer ${token}` },
+        body: fileBuffer,
+        signal: AbortSignal.timeout(120_000),
+    });
+    await fs.unlink(archivePath).catch(() => { });
+    if (!uploadRes.ok) {
+        const text = await uploadRes.text().catch(() => '');
+        console.error(`Upload failed: ${uploadRes.status} ${text}`);
+        process.exit(1);
+    }
+    console.log(`Backup complete — ${(stat.size / 1024 / 1024).toFixed(2)} MB uploaded.`);
+}
+//# sourceMappingURL=backup-cli.js.map

package/dist/commands/backup-cli.js.map

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

package/dist/commands/knowledge-sync-cli.d.ts

@@ -0,0 +1 @@
+export declare function runKnowledgeSync(): Promise<void>;

package/dist/commands/knowledge-sync-cli.js

@@ -0,0 +1,61 @@
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+const FIXED_FILES = ['SOUL.md', 'MEMORY.md', 'AGENTS.md', 'TOOLS.md', 'HEARTBEAT.md', 'USER.md'];
+function getWorkspaceDir() {
+    const stateDir = process.env.OPENCLAW_STATE_DIR?.trim() ?? path.join(os.homedir(), '.openclaw');
+    return path.join(stateDir, 'workspace');
+}
+function requireEnv(name) {
+    const value = process.env[name];
+    if (!value) {
+        console.error(`Missing required env: ${name}`);
+        process.exit(1);
+    }
+    return value;
+}
+export async function runKnowledgeSync() {
+    const backendUrl = requireEnv('BACKEND_INTERNAL_URL');
+    const agentToken = requireEnv('AGENT_TOKEN');
+    const agentId = requireEnv('AGENT_ID');
+    const workspaceDir = getWorkspaceDir();
+    const filePaths = [...FIXED_FILES];
+    // Scan memory/ directory for .md files
+    const memoryDir = path.join(workspaceDir, 'memory');
+    try {
+        const entries = await fs.readdir(memoryDir);
+        for (const entry of entries) {
+            if (entry.endsWith('.md'))
+                filePaths.push(`memory/${entry}`);
+        }
+    }
+    catch { /* memory/ may not exist */ }
+    // Read all files
+    console.log(`Reading ${filePaths.length} files from workspace...`);
+    const files = [];
+    for (const filePath of filePaths) {
+        try {
+            const content = await fs.readFile(path.join(workspaceDir, filePath), 'utf-8');
+            files.push({ path: filePath, content });
+        }
+        catch { /* skip missing */ }
+    }
+    console.log(`  Found ${files.length} files to sync.`);
+    // Push to backend
+    const res = await fetch(`${backendUrl}/api/internal/agents/${agentId}/knowledge/push`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${agentToken}`,
+        },
+        body: JSON.stringify({ files }),
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => '');
+        console.error(`Knowledge push failed: ${res.status} ${text}`);
+        process.exit(1);
+    }
+    const { filesUpdated } = await res.json();
+    console.log(`Knowledge sync complete — ${filesUpdated}/${files.length} files updated.`);
+}
+//# sourceMappingURL=knowledge-sync-cli.js.map

package/dist/commands/knowledge-sync-cli.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw-cloud/agent-controller",
-  "version": "0.2.7",
+  "version": "0.2.9",
   "type": "module",
   "main": "dist/index.js",
   "bin": {