@openclaw-cloud/agent-controller 0.1.5 → 0.1.7

package/dist/index.js

@@ -3,6 +3,7 @@ import { startHeartbeat } from './heartbeat.js';
 import { createAgentApi } from './api.js';
 import { BoardHandler } from './handlers/board-handler.js';
 import { createChatProvider } from './openclaw/index.js';
+import { DEBUG } from './debug.js';
 function requireEnv(name) {
     const value = process.env[name];
     if (!value) {
@@ -17,14 +18,14 @@ export function main() {
     const url = rawUrl.replace(/^http:\/\//, 'ws://').replace(/^https:\/\//, 'wss://') + '/connection/websocket';
     const token = requireEnv('AGENT_TOKEN');
     const agentId = requireEnv('AGENT_ID');
-    const backendUrl = process.env.BACKEND_INTERNAL_URL || '';
+    const backendUrl = requireEnv('BACKEND_INTERNAL_URL');
     const centrifugoInternalUrl = process.env.CENTRIFUGO_INTERNAL_URL || '';
     const centrifugoApiKey = process.env.CENTRIFUGO_API_KEY || '';
+    if (DEBUG)
+        console.log('[debug] Debug mode enabled');
     console.log(`Starting agent-controller for agent: ${agentId}`);
-    if (backendUrl) {
-        console.log(`Backend URL: ${backendUrl} (JWT mode)`);
-    }
-    const { client } = createConnection({ url, token, agentId, backendUrl: backendUrl || undefined });
+    console.log(`Backend URL: ${backendUrl} (JWT mode)`);
+    const { client } = createConnection({ url, token, agentId, backendUrl });
     // Chat provider via OpenClaw Gateway WS
     const gatewayWsUrl = process.env.OPENCLAW_GATEWAY_WS || 'ws://localhost:18789';
     const gatewayToken = process.env.OPENCLAW_GATEWAY_TOKEN || '';

package/dist/index.js.map

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

package/dist/types.d.ts

@@ -3,7 +3,7 @@
  *   agent:<agentId>     — commands from backend, responses from agent
  *   heartbeat:<agentId> — heartbeat publications from agent
  */
-export type CommandType = 'exec' | 'restart' | 'deploy' | 'config' | 'pair' | 'stop' | 'backup' | 'chat_list_sessions' | 'chat_history' | 'chat_send' | 'package_install' | 'file_write' | 'onboarding_complete';
+export type CommandType = 'exec' | 'restart' | 'deploy' | 'config' | 'pair' | 'stop' | 'backup' | 'chat_list_sessions' | 'chat_history' | 'chat_send' | 'package_install' | 'file_write' | 'file_delete' | 'onboarding_complete';
 export interface AgentCommand {
     id: string;
     type: CommandType;

package/package.json

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

package/src/api.ts

@@ -1,3 +1,5 @@
+import { DEBUG, debugLog } from './debug.js';
+
 const TIMEOUT = 10_000;
 
 export interface AgentApi {
@@ -10,6 +12,7 @@ export function createAgentApi(backendUrl: string, agentToken: string): AgentApi
     const controller = new AbortController();
     const timeout = setTimeout(() => controller.abort(), TIMEOUT);
     try {
+      debugLog('api', '→', method, path, body ? JSON.stringify(body).slice(0, 500) : '');
       const res = await fetch(`${backendUrl}${path}`, {
         method,
         headers: {
@@ -19,6 +22,11 @@ export function createAgentApi(backendUrl: string, agentToken: string): AgentApi
         ...(body !== undefined ? { body: JSON.stringify(body) } : {}),
         signal: controller.signal,
       });
+      if (DEBUG) {
+        const clone = res.clone();
+        const bodyText = await clone.text().catch(() => '');
+        debugLog('api', '←', method, path, res.status, bodyText.slice(0, 1000));
+      }
       return res;
     } finally {
       clearTimeout(timeout);

package/src/connection.ts

@@ -1,3 +1,4 @@
+import { debugLog } from './debug.js';
 import { Centrifuge, Subscription } from 'centrifuge';
 import WebSocket from 'ws';
 import type { AgentCommand, AgentResponse } from './types.js';
@@ -11,13 +12,14 @@ import { handleBackup } from './handlers/backup.js';
 import { handleChatListSessions, handleChatHistory, handleChatSend } from './handlers/chat.js';
 import { handlePackageInstall } from './handlers/package-install.js';
 import { handleFileWrite } from './handlers/file-write.js';
+import { handleFileDelete } from './handlers/file-delete.js';
 import { handleOnboardingComplete } from './handlers/onboarding.js';
 
 export interface ConnectionOptions {
   url: string;
   token: string;
   agentId: string;
-  backendUrl?: string;
+  backendUrl: string;
 }
 
 const handlers: Record<string, (cmd: AgentCommand) => Promise<AgentResponse>> = {
@@ -30,6 +32,7 @@ const handlers: Record<string, (cmd: AgentCommand) => Promise<AgentResponse>> =
   backup: handleBackup,
   package_install: handlePackageInstall,
   file_write: handleFileWrite,
+  file_delete: handleFileDelete,
   onboarding_complete: handleOnboardingComplete,
 };
 
@@ -60,40 +63,35 @@ export function createConnection(opts: ConnectionOptions): {
   client: Centrifuge;
   commandSub: Subscription;
 } {
+  // Dynamic JWT: fetch fresh token on every connect/reconnect
+  const getToken = async (): Promise<string> => {
+    console.log('Fetching Centrifugo JWT from backend...');
+    try {
+      const token = await fetchCentrifugoToken(opts.backendUrl, opts.token, opts.agentId);
+      console.log('Got Centrifugo JWT');
+      return token;
+    } catch (err) {
+      console.error('Failed to fetch Centrifugo JWT:', err instanceof Error ? err.message : err);
+      // Retry once before giving up — centrifuge will handle reconnect backoff
+      try {
+        const token = await fetchCentrifugoToken(opts.backendUrl, opts.token, opts.agentId);
+        console.log('Got Centrifugo JWT (retry)');
+        return token;
+      } catch (retryErr) {
+        console.error('JWT fetch retry failed:', retryErr instanceof Error ? retryErr.message : retryErr);
+        throw retryErr;
+      }
+    }
+  };
+
   const centrifugeOpts: Record<string, unknown> = {
     websocket: WebSocket,
     name: 'agent-controller',
+    getToken,
     minReconnectDelay: 1000,
     maxReconnectDelay: 30000,
   };
 
-  if (opts.backendUrl) {
-    // Dynamic JWT: fetch fresh token on every connect/reconnect
-    centrifugeOpts.getToken = async () => {
-      console.log('Fetching Centrifugo JWT from backend...');
-      try {
-        const token = await fetchCentrifugoToken(opts.backendUrl!, opts.token, opts.agentId);
-        console.log('Got Centrifugo JWT');
-        return token;
-      } catch (err) {
-        console.error('Failed to fetch Centrifugo JWT:', err instanceof Error ? err.message : err);
-        // Retry once
-        try {
-          const token = await fetchCentrifugoToken(opts.backendUrl!, opts.token, opts.agentId);
-          console.log('Got Centrifugo JWT (retry)');
-          return token;
-        } catch (retryErr) {
-          console.error('JWT fetch retry failed:', retryErr instanceof Error ? retryErr.message : retryErr);
-          throw retryErr;
-        }
-      }
-    };
-  } else {
-    // Fallback: use raw token (backward compat, won't work with Centrifugo JWT validation)
-    console.warn('BACKEND_INTERNAL_URL not set, using AGENT_TOKEN directly (may not work)');
-    centrifugeOpts.token = opts.token;
-  }
-
   const client = new Centrifuge(opts.url, centrifugeOpts);
 
   const commandChannel = `agent:${opts.agentId}`;
@@ -101,6 +99,7 @@ export function createConnection(opts: ConnectionOptions): {
 
   commandSub.on('publication', async (ctx) => {
     console.log(`[WS] Received message on ${commandChannel}:`, JSON.stringify(ctx.data));
+    debugLog('connection', 'publication', commandChannel, JSON.stringify(ctx.data).slice(0, 500));
     const command = ctx.data as AgentCommand;
     if (!command || !command.type) {
       console.warn('[WS] Ignoring message without type:', JSON.stringify(ctx.data));
@@ -148,22 +147,27 @@ export function createConnection(opts: ConnectionOptions): {
 
   client.on('connected', (ctx) => {
     console.log(`Connected to Centrifugo via ${ctx.transport}`);
+    debugLog('connection', 'connected', ctx);
   });
 
   client.on('disconnected', (ctx) => {
     console.log(`Disconnected: ${ctx.reason} (code ${ctx.code})`);
+    debugLog('connection', 'disconnected', ctx);
   });
 
   client.on('connecting', (ctx) => {
     console.log(`Connecting: ${ctx.reason} (code ${ctx.code})`);
+    debugLog('connection', 'connecting', ctx);
   });
 
   commandSub.on('subscribed', (ctx) => {
     console.log(`[WS] Subscribed to ${commandChannel} (recovered=${ctx.wasRecovering})`);
+    debugLog('connection', 'subscribed', commandChannel, ctx);
   });
 
   commandSub.on('subscribing', (ctx) => {
     console.log(`[WS] Subscribing to ${commandChannel}: ${ctx.reason} (code ${ctx.code})`);
+    debugLog('connection', 'subscribing', commandChannel, ctx);
   });
 
   commandSub.on('error', (ctx) => {

package/src/debug.ts

@@ -0,0 +1,11 @@
+export const DEBUG = !!(process.env.AC_DEBUG || process.env.DEBUG);
+
+export function debugLog(prefix: string, ...args: unknown[]): void {
+  if (!DEBUG) return;
+  console.log(`[debug][${prefix}]`, ...args);
+}
+
+export function maskToken(token: string): string {
+  if (!token) return '';
+  return token.slice(0, 10) + '...';
+}

package/src/handlers/file-delete.ts

@@ -0,0 +1,46 @@
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import type { AgentCommand, AgentResponse } from '../types.js';
+
+const WORKSPACE_DIR = process.env.WORKSPACE_DIR ?? '/etc/openclaw/workspace';
+
+export async function handleFileDelete(command: AgentCommand): Promise<AgentResponse> {
+  const filePath = command.payload.path as string;
+
+  if (!filePath) {
+    return {
+      id: command.id,
+      type: 'file_delete',
+      success: false,
+      error: 'Missing "path" in payload',
+    };
+  }
+
+  if (filePath.includes('..') || filePath.startsWith('/')) {
+    return {
+      id: command.id,
+      type: 'file_delete',
+      success: false,
+      error: 'Invalid path: must not contain ".." or start with "/"',
+    };
+  }
+
+  const resolvedPath = path.join(WORKSPACE_DIR, filePath);
+
+  try {
+    await fs.unlink(resolvedPath);
+    return {
+      id: command.id,
+      type: 'file_delete',
+      success: true,
+      data: { path: resolvedPath },
+    };
+  } catch (err) {
+    return {
+      id: command.id,
+      type: 'file_delete',
+      success: false,
+      error: err instanceof Error ? err.message : String(err),
+    };
+  }
+}

package/src/heartbeat.ts

@@ -1,4 +1,5 @@
 import os from 'node:os';
+import { debugLog } from './debug.js';
 import type { BoardState, HeartbeatPayload } from './types.js';
 
 const HEARTBEAT_INTERVAL = 30_000;
@@ -41,6 +42,7 @@ async function publishHeartbeat(opts: HeartbeatOptions): Promise<void> {
   const timeout = setTimeout(() => controller.abort(), 5000);
 
   try {
+    debugLog('heartbeat', '→ sending', opts.agentId, JSON.stringify(payload).slice(0, 500));
     const res = await fetch(`${opts.centrifugoInternalUrl}/api/publish`, {
       method: 'POST',
       headers: {
@@ -54,6 +56,9 @@ async function publishHeartbeat(opts: HeartbeatOptions): Promise<void> {
     if (!res.ok) {
       const body = await res.text().catch(() => '');
       console.error(`Heartbeat publish failed (HTTP ${res.status}): ${body}`);
+      debugLog('heartbeat', '← error', res.status, body);
+    } else {
+      debugLog('heartbeat', '← ok', res.status);
     }
   } catch (err) {
     if ((err as Error).name === 'AbortError') {

package/src/index.ts

@@ -3,6 +3,7 @@ import { startHeartbeat } from './heartbeat.js';
 import { createAgentApi } from './api.js';
 import { BoardHandler } from './handlers/board-handler.js';
 import { createChatProvider } from './openclaw/index.js';
+import { DEBUG } from './debug.js';
 import type { BoardEvent } from './types.js';
 
 function requireEnv(name: string): string {
@@ -20,16 +21,15 @@ export function main(): void {
   const url = rawUrl.replace(/^http:\/\//, 'ws://').replace(/^https:\/\//, 'wss://') + '/connection/websocket';
   const token = requireEnv('AGENT_TOKEN');
   const agentId = requireEnv('AGENT_ID');
-  const backendUrl = process.env.BACKEND_INTERNAL_URL || '';
+  const backendUrl = requireEnv('BACKEND_INTERNAL_URL');
   const centrifugoInternalUrl = process.env.CENTRIFUGO_INTERNAL_URL || '';
   const centrifugoApiKey = process.env.CENTRIFUGO_API_KEY || '';
 
+  if (DEBUG) console.log('[debug] Debug mode enabled');
   console.log(`Starting agent-controller for agent: ${agentId}`);
-  if (backendUrl) {
-    console.log(`Backend URL: ${backendUrl} (JWT mode)`);
-  }
+  console.log(`Backend URL: ${backendUrl} (JWT mode)`);
 
-  const { client } = createConnection({ url, token, agentId, backendUrl: backendUrl || undefined });
+  const { client } = createConnection({ url, token, agentId, backendUrl });
 
   // Chat provider via OpenClaw Gateway WS
   const gatewayWsUrl = process.env.OPENCLAW_GATEWAY_WS || 'ws://localhost:18789';

package/src/types.ts

@@ -7,7 +7,7 @@
 export type CommandType =
   | 'exec' | 'restart' | 'deploy' | 'config' | 'pair' | 'stop' | 'backup'
   | 'chat_list_sessions' | 'chat_history' | 'chat_send'
-  | 'package_install' | 'file_write' | 'onboarding_complete';
+  | 'package_install' | 'file_write' | 'file_delete' | 'onboarding_complete';
 
 export interface AgentCommand {
   id: string;