@openclaw-cloud/agent-controller 0.1.4 → 0.1.6

package/dist/openclaw/gateway-adapter.d.ts

@@ -0,0 +1,22 @@
+import type { IChatProvider, ChatSession, ChatMessage, ChatAttachment } from './types.js';
+export declare class OpenclawGatewayAdapter implements IChatProvider {
+    private client;
+    private streamCallbacks;
+    constructor(url: string, token: string);
+    connect(): Promise<void>;
+    disconnect(): void;
+    isConnected(): boolean;
+    listSessions(): Promise<ChatSession[]>;
+    getHistory(sessionKey: string, limit?: number): Promise<ChatMessage[]>;
+    sendMessage(params: {
+        sessionKey: string;
+        text: string;
+        idempotencyKey: string;
+        attachments?: ChatAttachment[];
+        onDelta?: (text: string) => void;
+        onDone?: (text: string) => void;
+        onError?: (error: string) => void;
+    }): Promise<void>;
+    abort(sessionKey: string, runId?: string): Promise<void>;
+    private handleEvent;
+}

package/dist/openclaw/gateway-adapter.js

@@ -0,0 +1,108 @@
+import { GatewayClient } from './gateway-client.js';
+export class OpenclawGatewayAdapter {
+    client;
+    streamCallbacks = new Map();
+    constructor(url, token) {
+        this.client = new GatewayClient(url, token);
+        this.client.setEventHandler(this.handleEvent.bind(this));
+    }
+    async connect() {
+        await this.client.connect();
+    }
+    disconnect() {
+        this.client.disconnect();
+    }
+    isConnected() {
+        return this.client.isConnected();
+    }
+    async listSessions() {
+        const result = await this.client.request('sessions.list', {});
+        return (result?.sessions ?? []).map((s) => ({
+            key: s.key,
+            sessionId: s.sessionId ?? '',
+            kind: s.kind ?? 'direct',
+            updatedAt: s.updatedAt ?? 0,
+            model: s.model,
+        }));
+    }
+    async getHistory(sessionKey, limit = 200) {
+        const result = await this.client.request('chat.history', { sessionKey, limit });
+        return (result?.messages ?? [])
+            .filter((m) => m.role === 'user' || m.role === 'assistant')
+            .map((m) => {
+            const content = Array.isArray(m.content)
+                ? m.content.filter((c) => c.type === 'text').map((c) => c.text).join('')
+                : String(m.content ?? '');
+            return {
+                role: m.role,
+                content,
+                timestamp: typeof m.timestamp === 'number'
+                    ? new Date(m.timestamp).toISOString()
+                    : m.timestamp ?? new Date().toISOString(),
+            };
+        });
+    }
+    async sendMessage(params) {
+        // Register stream callbacks BEFORE sending
+        this.streamCallbacks.set(params.idempotencyKey, {
+            onDelta: params.onDelta,
+            onDone: params.onDone,
+            onError: params.onError,
+            lastText: '',
+        });
+        const payload = {
+            sessionKey: params.sessionKey,
+            message: params.text,
+            deliver: false,
+            idempotencyKey: params.idempotencyKey,
+        };
+        if (params.attachments?.length) {
+            payload.attachments = params.attachments;
+        }
+        try {
+            await this.client.request('chat.send', payload);
+            // Request accepted — response comes via events
+        }
+        catch (err) {
+            this.streamCallbacks.delete(params.idempotencyKey);
+            params.onError?.(err instanceof Error ? err.message : String(err));
+        }
+    }
+    async abort(sessionKey, runId) {
+        await this.client.request('chat.abort', { sessionKey, runId }).catch(() => { });
+    }
+    handleEvent(event) {
+        const data = event.payload;
+        if (!data || !data.sessionKey)
+            return;
+        // Stream events have runId matching idempotencyKey
+        const runId = data.runId;
+        const cb = runId ? this.streamCallbacks.get(runId) : null;
+        if (!cb)
+            return;
+        if (data.state === 'delta' && data.message != null) {
+            // message is accumulated text
+            const text = typeof data.message === 'string'
+                ? data.message
+                : Array.isArray(data.message)
+                    ? data.message.filter((c) => c.type === 'text').map((c) => c.text).join('')
+                    : '';
+            cb.lastText = text;
+            cb.onDelta?.(text);
+        }
+        else if (data.state === 'final') {
+            this.streamCallbacks.delete(runId);
+            cb.onDone?.(cb.lastText);
+        }
+        else if (data.state === 'aborted') {
+            this.streamCallbacks.delete(runId);
+            cb.onDone?.(cb.lastText); // still send whatever we have
+        }
+        else if (data.state === 'error') {
+            this.streamCallbacks.delete(runId);
+            const errMsg = typeof data.error === 'string' ? data.error : data.error?.message ?? 'Unknown error';
+            cb.onError?.(errMsg);
+        }
+    }
+}
+//# sourceMappingURL=gateway-adapter.js.map

package/dist/openclaw/gateway-adapter.js.map

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

package/dist/openclaw/gateway-client.d.ts

@@ -0,0 +1,21 @@
+export type EventHandler = (event: {
+    event: string;
+    payload: any;
+    seq?: number;
+}) => void;
+export declare class GatewayClient {
+    private ws;
+    private pending;
+    private onEvent;
+    private connected;
+    private token;
+    private url;
+    constructor(url: string, token: string);
+    setEventHandler(handler: EventHandler): void;
+    connect(): Promise<void>;
+    disconnect(): void;
+    isConnected(): boolean;
+    request(method: string, params: any): Promise<any>;
+    private handleMessage;
+    private flushPending;
+}

package/dist/openclaw/gateway-client.js

@@ -0,0 +1,114 @@
+import WebSocket from 'ws';
+import { randomUUID } from 'crypto';
+export class GatewayClient {
+    ws = null;
+    pending = new Map();
+    onEvent = null;
+    connected = false;
+    token;
+    url;
+    constructor(url, token) {
+        this.url = url;
+        this.token = token;
+    }
+    setEventHandler(handler) {
+        this.onEvent = handler;
+    }
+    connect() {
+        return new Promise((resolve, reject) => {
+            this.ws = new WebSocket(this.url);
+            this.ws.on('open', () => {
+                // Wait for connect.challenge event, then authenticate
+            });
+            this.ws.on('message', (raw) => {
+                try {
+                    const msg = JSON.parse(raw.toString());
+                    this.handleMessage(msg);
+                }
+                catch { }
+            });
+            this.ws.on('error', (e) => {
+                if (!this.connected)
+                    reject(e);
+            });
+            this.ws.on('close', () => {
+                this.connected = false;
+                this.flushPending(new Error('Connection closed'));
+            });
+            // Wait for connect.challenge → authenticate → resolve
+            const origHandler = this.onEvent;
+            this.onEvent = async (ev) => {
+                if (ev.event === 'connect.challenge') {
+                    try {
+                        await this.request('connect', {
+                            auth: { token: this.token },
+                            scopes: ['operator.admin'],
+                            caps: [],
+                        });
+                        this.connected = true;
+                        this.onEvent = origHandler;
+                        resolve();
+                    }
+                    catch (e) {
+                        reject(e);
+                    }
+                }
+            };
+            setTimeout(() => {
+                if (!this.connected)
+                    reject(new Error('Connect timeout'));
+            }, 10_000);
+        });
+    }
+    disconnect() {
+        this.ws?.close();
+        this.ws = null;
+        this.connected = false;
+        this.flushPending(new Error('Disconnected'));
+    }
+    isConnected() {
+        return this.connected && this.ws?.readyState === WebSocket.OPEN;
+    }
+    request(method, params) {
+        return new Promise((resolve, reject) => {
+            if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
+                return reject(new Error('Not connected'));
+            }
+            const id = randomUUID();
+            this.pending.set(id, { resolve, reject });
+            this.ws.send(JSON.stringify({ type: 'req', id, method, params }));
+            // Timeout per request
+            setTimeout(() => {
+                if (this.pending.has(id)) {
+                    this.pending.delete(id);
+                    reject(new Error(`Request timeout: ${method}`));
+                }
+            }, 120_000);
+        });
+    }
+    handleMessage(msg) {
+        if (msg.type === 'event') {
+            this.onEvent?.(msg);
+            return;
+        }
+        if (msg.type === 'res') {
+            const req = this.pending.get(msg.id);
+            if (!req)
+                return;
+            this.pending.delete(msg.id);
+            if (msg.ok) {
+                req.resolve(msg.payload);
+            }
+            else {
+                req.reject(new Error(msg.error?.message ?? 'Request failed'));
+            }
+        }
+    }
+    flushPending(err) {
+        for (const [, req] of this.pending) {
+            req.reject(err);
+        }
+        this.pending.clear();
+    }
+}
+//# sourceMappingURL=gateway-client.js.map

package/dist/openclaw/gateway-client.js.map

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

package/dist/openclaw/index.d.ts

@@ -0,0 +1,8 @@
+export { OpenclawGatewayAdapter } from './gateway-adapter.js';
+export type { IChatProvider, ChatSession, ChatMessage, ChatAttachment } from './types.js';
+import type { IChatProvider } from './types.js';
+export declare function createChatProvider(url: string, token: string): IChatProvider & {
+    connect(): Promise<void>;
+    disconnect(): void;
+};
+export declare function getChatProvider(): IChatProvider | null;

package/dist/openclaw/index.js

@@ -0,0 +1,12 @@
+export { OpenclawGatewayAdapter } from './gateway-adapter.js';
+import { OpenclawGatewayAdapter } from './gateway-adapter.js';
+let _provider = null;
+export function createChatProvider(url, token) {
+    const adapter = new OpenclawGatewayAdapter(url, token);
+    _provider = adapter;
+    return adapter;
+}
+export function getChatProvider() {
+    return _provider;
+}
+//# sourceMappingURL=index.js.map

package/dist/openclaw/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/openclaw/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,OAAO,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AAG9D,IAAI,SAAS,GAAyB,IAAI,CAAC;AAE3C,MAAM,UAAU,kBAAkB,CAAC,GAAW,EAAE,KAAa;IAC3D,MAAM,OAAO,GAAG,IAAI,sBAAsB,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACvD,SAAS,GAAG,OAAO,CAAC;IACpB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,eAAe;IAC7B,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/openclaw/types.d.ts

@@ -0,0 +1,36 @@
+export interface ChatSession {
+    key: string;
+    sessionId: string;
+    kind: string;
+    updatedAt: number;
+    model?: string;
+}
+export interface ChatMessage {
+    role: 'user' | 'assistant';
+    content: string;
+    timestamp: string;
+}
+export interface ChatAttachment {
+    type: 'image';
+    mimeType: string;
+    content: string;
+}
+export interface IChatProvider {
+    listSessions(): Promise<ChatSession[]>;
+    getHistory(sessionKey: string, limit?: number): Promise<ChatMessage[]>;
+    /**
+     * Send message. Returns after the agent finishes (full response).
+     * Calls onDelta with accumulated text during streaming.
+     * Calls onDone when agent response is complete.
+     */
+    sendMessage(params: {
+        sessionKey: string;
+        text: string;
+        idempotencyKey: string;
+        attachments?: ChatAttachment[];
+        onDelta?: (accumulatedText: string) => void;
+        onDone?: (finalText: string) => void;
+        onError?: (error: string) => void;
+    }): Promise<void>;
+    abort(sessionKey: string, runId?: string): Promise<void>;
+}

package/dist/openclaw/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/openclaw/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/openclaw/types.ts"],"names":[],"mappings":""}

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';
+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;
@@ -49,6 +49,7 @@ export interface BoardEvent {
 export interface BoardInfo {
     board: {
         id: string;
+        workspaceId: string;
         columns: Array<{
             id: string;
             name: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw-cloud/agent-controller",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -9,7 +9,8 @@
   "scripts": {
     "build": "tsc",
     "test": "node --experimental-vm-modules node_modules/.bin/jest",
-    "start": "node bin/agent-controller.js"
+    "start": "node bin/agent-controller.js",
+    "prepare": "[ -d .git ] && husky || true"
   },
   "dependencies": {
     "centrifuge": "^5.5.3",
@@ -19,6 +20,7 @@
     "@types/jest": "^30.0.0",
     "@types/node": "^25.2.3",
     "@types/ws": "^8.18.1",
+    "husky": "^9.1.7",
     "jest": "^30.2.0",
     "ts-jest": "^29.4.6",
     "typescript": "^5.9.3"

package/src/commands/self-update.ts

@@ -0,0 +1,43 @@
+import { exec } from 'node:child_process';
+
+const PACKAGE_NAME = '@openclaw-cloud/agent-controller';
+
+function execAsync(cmd: string, timeout: number): Promise<string> {
+  return new Promise((resolve, reject) => {
+    exec(cmd, { timeout }, (err, stdout) => {
+      if (err) reject(err);
+      else resolve(stdout.toString().trim());
+    });
+  });
+}
+
+export async function selfUpdate(currentVersion: string): Promise<void> {
+  console.log(`Current version: ${currentVersion}`);
+
+  let latestVersion: string;
+  try {
+    latestVersion = await execAsync(`npm view ${PACKAGE_NAME} version`, 10_000);
+  } catch (err) {
+    console.error('Failed to fetch latest version:', err instanceof Error ? err.message : err);
+    process.exit(1);
+    return; // unreachable in production; guards test flow when process.exit is mocked
+  }
+
+  console.log(`Latest version: ${latestVersion}`);
+
+  if (currentVersion === latestVersion) {
+    console.log('Already up to date.');
+    return;
+  }
+
+  console.log(`Updating from ${currentVersion} to ${latestVersion}...`);
+  try {
+    await execAsync(`npm install -g ${PACKAGE_NAME}@latest`, 120_000);
+    console.log(`Successfully updated to ${latestVersion}. Restarting...`);
+    process.exit(0);
+    return; // unreachable in production; guards test flow when process.exit is mocked
+  } catch (err) {
+    console.error('Update failed:', err instanceof Error ? err.message : err);
+    process.exit(1);
+  }
+}

package/src/connection.ts

@@ -9,12 +9,16 @@ import { handlePair } from './handlers/pair.js';
 import { handleStop } from './handlers/stop.js';
 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>> = {
@@ -25,6 +29,10 @@ const handlers: Record<string, (cmd: AgentCommand) => Promise<AgentResponse>> =
   pair: handlePair,
   stop: handleStop,
   backup: handleBackup,
+  package_install: handlePackageInstall,
+  file_write: handleFileWrite,
+  file_delete: handleFileDelete,
+  onboarding_complete: handleOnboardingComplete,
 };
 
 async function fetchCentrifugoToken(backendUrl: string, agentToken: string, agentId: string): Promise<string> {
@@ -54,40 +62,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}`;

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/handlers/file-write.ts

@@ -0,0 +1,65 @@
+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 handleFileWrite(command: AgentCommand): Promise<AgentResponse> {
+  const filePath = command.payload.path as string;
+  const content = command.payload.content;
+  const overwrite = (command.payload.overwrite as boolean | undefined) ?? true;
+
+  if (!filePath || content === undefined) {
+    return {
+      id: command.id,
+      type: 'file_write',
+      success: false,
+      error: 'Missing "path" or "content" in payload',
+    };
+  }
+
+  if (filePath.includes('..') || filePath.startsWith('/')) {
+    return {
+      id: command.id,
+      type: 'file_write',
+      success: false,
+      error: 'Invalid path: must not contain ".." or start with "/"',
+    };
+  }
+
+  const resolvedPath = path.join(WORKSPACE_DIR, filePath);
+
+  try {
+    if (!overwrite) {
+      try {
+        await fs.access(resolvedPath);
+        // File exists — skip
+        return {
+          id: command.id,
+          type: 'file_write',
+          success: true,
+          data: { path: resolvedPath, written: false, skipped: true },
+        };
+      } catch {
+        // File does not exist — proceed with write
+      }
+    }
+
+    await fs.mkdir(path.dirname(resolvedPath), { recursive: true });
+    await fs.writeFile(resolvedPath, content as string, 'utf-8');
+
+    return {
+      id: command.id,
+      type: 'file_write',
+      success: true,
+      data: { path: resolvedPath, written: true },
+    };
+  } catch (err) {
+    return {
+      id: command.id,
+      type: 'file_write',
+      success: false,
+      error: err instanceof Error ? err.message : String(err),
+    };
+  }
+}

package/src/handlers/onboarding.ts

@@ -0,0 +1,19 @@
+import { exec } from 'node:child_process';
+import type { AgentCommand, AgentResponse } from '../types.js';
+
+export function handleOnboardingComplete(command: AgentCommand): Promise<AgentResponse> {
+  return new Promise((resolve) => {
+    exec('openclaw gateway restart', { timeout: 30_000 }, (error, stdout, stderr) => {
+      resolve({
+        id: command.id,
+        type: 'onboarding_complete',
+        success: !error,
+        data: {
+          stdout: stdout.toString(),
+          stderr: stderr.toString(),
+        },
+        ...(error ? { error: error.message } : {}),
+      });
+    });
+  });
+}