@getaclaw/agent 0.1.1

package/dist/utils/exec.js

@@ -0,0 +1,99 @@
+import { execFile, spawn } from 'node:child_process';
+import { logger } from './logger.js';
+const ALLOWED_COMMANDS = new Set([
+    'apt',
+    'apt-get',
+    'npm',
+    'systemctl',
+    'tailscale',
+    'openclaw',
+    'ufw',
+    'curl',
+    'fallocate',
+    'mkswap',
+    'swapon',
+    'chmod',
+    'chown',
+    'mkdir',
+    'cat',
+    'tee',
+    'node',
+    'bash',
+    'sh',
+    'free',
+    'uptime',
+    'whoami',
+    'id',
+    'hostname',
+]);
+export class CommandNotAllowedError extends Error {
+    constructor(command) {
+        super(`Command not allowed: ${command}`);
+        this.name = 'CommandNotAllowedError';
+    }
+}
+export async function safeExec(command, args, options = {}) {
+    if (!ALLOWED_COMMANDS.has(command)) {
+        throw new CommandNotAllowedError(command);
+    }
+    const defaults = {
+        timeout: 300_000,
+        maxBuffer: 10 * 1024 * 1024,
+        ...options,
+    };
+    logger.debug(`Executing: ${command} ${args.join(' ')}`);
+    return new Promise((resolve, reject) => {
+        execFile(command, args, defaults, (error, stdout, stderr) => {
+            const result = {
+                stdout: typeof stdout === 'string' ? stdout : stdout?.toString() ?? '',
+                stderr: typeof stderr === 'string' ? stderr : stderr?.toString() ?? '',
+                exitCode: error && 'code' in error && typeof error.code === 'number' ? error.code : error ? 1 : 0,
+            };
+            if (error && !('code' in error && typeof error.code === 'number')) {
+                logger.error(`Command failed: ${command} ${args.join(' ')}`, {
+                    stderr: result.stderr,
+                    error: error.message,
+                });
+                reject(Object.assign(error, { result }));
+                return;
+            }
+            if (result.exitCode !== 0) {
+                logger.warn(`Command exited with code ${result.exitCode}: ${command} ${args.join(' ')}`);
+            }
+            resolve(result);
+        });
+    });
+}
+export async function safeExecPipe(command, args, options = {}, onStdout, onStderr) {
+    if (!ALLOWED_COMMANDS.has(command)) {
+        throw new CommandNotAllowedError(command);
+    }
+    const spawnOpts = {
+        timeout: 600_000,
+        stdio: ['ignore', 'pipe', 'pipe'],
+        ...options,
+    };
+    logger.debug(`Executing (piped): ${command} ${args.join(' ')}`);
+    return new Promise((resolve, reject) => {
+        const proc = spawn(command, args, spawnOpts);
+        let stdout = '';
+        let stderr = '';
+        proc.stdout?.on('data', (data) => {
+            const chunk = data.toString();
+            stdout += chunk;
+            onStdout?.(chunk);
+        });
+        proc.stderr?.on('data', (data) => {
+            const chunk = data.toString();
+            stderr += chunk;
+            onStderr?.(chunk);
+        });
+        proc.on('close', (code) => {
+            resolve({ stdout, stderr, exitCode: code ?? 0 });
+        });
+        proc.on('error', (error) => {
+            reject(Object.assign(error, { result: { stdout, stderr, exitCode: 1 } }));
+        });
+    });
+}
+//# sourceMappingURL=exec.js.map

package/dist/utils/exec.js.map

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

package/dist/utils/logger.d.ts

@@ -0,0 +1,4 @@
+import winston from 'winston';
+export declare const logger: winston.Logger;
+export declare function enableFileLogging(): void;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAK9B,eAAO,MAAM,MAAM,gBAmBjB,CAAC;AAEH,wBAAgB,iBAAiB,IAAI,IAAI,CAgBxC"}

package/dist/utils/logger.js

@@ -0,0 +1,30 @@
+import winston from 'winston';
+import path from 'node:path';
+const LOG_DIR = process.env.GETACLAW_LOG_DIR ?? '/var/log/getaclaw';
+export const logger = winston.createLogger({
+    level: process.env.LOG_LEVEL ?? 'info',
+    format: winston.format.combine(winston.format.timestamp(), winston.format.errors({ stack: true }), winston.format.json()),
+    defaultMeta: { service: 'getaclaw-agent' },
+    transports: [
+        new winston.transports.Console({
+            format: winston.format.combine(winston.format.colorize(), winston.format.printf(({ level, message, timestamp, ...meta }) => {
+                const metaStr = Object.keys(meta).length > 1 ? ` ${JSON.stringify(meta)}` : '';
+                return `${timestamp} [${level}]: ${message}${metaStr}`;
+            })),
+        }),
+    ],
+});
+export function enableFileLogging() {
+    logger.add(new winston.transports.File({
+        filename: path.join(LOG_DIR, 'error.log'),
+        level: 'error',
+        maxsize: 5 * 1024 * 1024,
+        maxFiles: 3,
+    }));
+    logger.add(new winston.transports.File({
+        filename: path.join(LOG_DIR, 'agent.log'),
+        maxsize: 10 * 1024 * 1024,
+        maxFiles: 5,
+    }));
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,mBAAmB,CAAC;AAEpE,MAAM,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IACzC,KAAK,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM;IACtC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAC5B,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,EAC1B,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,EACtC,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,CACtB;IACD,WAAW,EAAE,EAAE,OAAO,EAAE,gBAAgB,EAAE;IAC1C,UAAU,EAAE;QACV,IAAI,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC;YAC7B,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,CAC5B,OAAO,CAAC,MAAM,CAAC,QAAQ,EAAE,EACzB,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE;gBAC/D,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/E,OAAO,GAAG,SAAmB,KAAK,KAAK,MAAM,OAAiB,GAAG,OAAO,EAAE,CAAC;YAC7E,CAAC,CAAC,CACH;SACF,CAAC;KACH;CACF,CAAC,CAAC;AAEH,MAAM,UAAU,iBAAiB;IAC/B,MAAM,CAAC,GAAG,CACR,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;QAC1B,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC;QACzC,KAAK,EAAE,OAAO;QACd,OAAO,EAAE,CAAC,GAAG,IAAI,GAAG,IAAI;QACxB,QAAQ,EAAE,CAAC;KACZ,CAAC,CACH,CAAC;IACF,MAAM,CAAC,GAAG,CACR,IAAI,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;QAC1B,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,WAAW,CAAC;QACzC,OAAO,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI;QACzB,QAAQ,EAAE,CAAC;KACZ,CAAC,CACH,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@getaclaw/agent",
+  "version": "0.1.1",
+  "description": "Lightweight daemon for orchestrating OpenClaw setup and management on a VPS",
+  "type": "module",
+  "bin": {
+    "getaclaw-agent": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/cli.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "openclaw",
+    "agent",
+    "vps",
+    "setup"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "commander": "^13.1.0",
+    "selfsigned": "^2.4.1",
+    "winston": "^3.17.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.13.0",
+    "@types/ws": "^8.5.14",
+    "typescript": "^5.7.0"
+  },
+  "engines": {
+    "node": ">=22.0.0"
+  }
+}