@openclaw-cloud/agent-controller 0.13.0 → 0.14.0

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

@@ -0,0 +1,181 @@
+import { GatewayClient } from './gateway-client.js';
+import { toErrorMessage } from '../../utils/response.js';
+const STREAM_TTL = 300_000; // 5 min
+/**
+ * Extract plain text from gateway message payload.
+ * Supports:
+ *  - string: "hello"
+ *  - content array: [{type:"text", text:"hello"}]
+ *  - message object: {role, content: [{type:"text", text:"hello"}], timestamp}
+ */
+function extractText(msg) {
+    if (typeof msg === 'string')
+        return msg;
+    if (Array.isArray(msg)) {
+        return msg
+            .filter((c) => c.type === 'text')
+            .map((c) => c.text)
+            .join('');
+    }
+    if (typeof msg === 'object' && msg !== null) {
+        const obj = msg;
+        // {role, content: [...], timestamp} format
+        if (Array.isArray(obj['content'])) {
+            return obj['content']
+                .filter((c) => c.type === 'text')
+                .map((c) => c.text)
+                .join('');
+        }
+        // {text: "..."} shorthand
+        if (typeof obj['text'] === 'string')
+            return obj['text'];
+    }
+    return '';
+}
+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() {
+        // Notify all in-flight streams before closing
+        for (const [, cb] of this.streamCallbacks) {
+            clearTimeout(cb.timer);
+            cb.onError?.('Connection closed');
+        }
+        this.streamCallbacks.clear();
+        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',
+            label: s.key.split(':').pop() ?? s.key,
+            updatedAt: s.updatedAt ?? 0,
+            model: s.model,
+        }));
+    }
+    async getHistory(sessionKey, limit = 200) {
+        const result = await this.client.request('chat.history', { sessionKey, limit });
+        const messages = (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(),
+            };
+        });
+        // Deduplicate consecutive assistant messages with same content
+        return messages.filter((msg, i) => {
+            if (i === 0)
+                return true;
+            const prev = messages[i - 1];
+            return !(msg.role === 'assistant' && prev.role === 'assistant' && msg.content === prev.content);
+        });
+    }
+    async sendMessage(params) {
+        const key = params.idempotencyKey;
+        // TTL timer: if no final/error event arrives within 5 min, clean up and error
+        const timer = setTimeout(() => {
+            const cb = this.streamCallbacks.get(key);
+            if (cb) {
+                this.streamCallbacks.delete(key);
+                cb.onError?.('Stream timeout');
+            }
+        }, STREAM_TTL);
+        // Register stream callbacks BEFORE sending
+        this.streamCallbacks.set(key, {
+            onDelta: params.onDelta,
+            onDone: params.onDone,
+            onError: params.onError,
+            lastText: '',
+            timer,
+        });
+        const payload = {
+            sessionKey: params.sessionKey,
+            message: params.text,
+            deliver: false,
+            idempotencyKey: key,
+        };
+        if (params.attachments?.length) {
+            payload['attachments'] = params.attachments;
+        }
+        try {
+            await this.client.request('chat.send', payload);
+            // Request accepted — response comes via events
+        }
+        catch (err) {
+            const cb = this.streamCallbacks.get(key);
+            if (cb) {
+                clearTimeout(cb.timer);
+                this.streamCallbacks.delete(key);
+            }
+            params.onError?.(toErrorMessage(err));
+        }
+    }
+    async abort(sessionKey, runId) {
+        await this.client.request('chat.abort', { sessionKey, runId }).catch(() => { });
+    }
+    deleteStream(runId) {
+        const cb = this.streamCallbacks.get(runId);
+        if (cb) {
+            clearTimeout(cb.timer);
+            this.streamCallbacks.delete(runId);
+        }
+        return cb;
+    }
+    handleEvent(event) {
+        console.log('[chat] Gateway event:', event.event, JSON.stringify(event.payload).slice(0, 500));
+        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) {
+            const msg = data['message'];
+            const text = extractText(msg);
+            console.log('[chat] delta extracted:', text.slice(0, 100));
+            cb.lastText = text;
+            cb.onDelta?.(text);
+        }
+        else if (data['state'] === 'final') {
+            const finalMsg = data['message'];
+            const finalText = finalMsg ? extractText(finalMsg) : cb.lastText;
+            console.log('[chat] final text:', finalText.slice(0, 100), 'lastText:', cb.lastText.slice(0, 100));
+            this.deleteStream(runId);
+            cb.onDone?.(finalText || cb.lastText);
+        }
+        else if (data['state'] === 'aborted') {
+            this.deleteStream(runId);
+            cb.onDone?.(cb.lastText); // still send whatever we have
+        }
+        else if (data['state'] === 'error') {
+            this.deleteStream(runId);
+            const errData = data['error'];
+            const errMsg = typeof errData === 'string'
+                ? errData
+                : errData?.message ?? 'Unknown error';
+            cb.onError?.(errMsg);
+        }
+    }
+}
+//# sourceMappingURL=gateway-adapter.js.map

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

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

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

@@ -0,0 +1,21 @@
+export type EventHandler = (event: {
+    event: string;
+    payload: unknown;
+    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: unknown): Promise<unknown>;
+    private handleMessage;
+    private flushPending;
+}

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

@@ -0,0 +1,138 @@
+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() {
+        // RACE-5: guard against double-call before the first handshake completes
+        if (this.ws !== null) {
+            return Promise.reject(new Error('Already connecting or connected'));
+        }
+        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'));
+            });
+            // LEAK-3: store and clear the connect timeout after successful auth
+            const connectTimer = setTimeout(() => {
+                if (!this.connected)
+                    reject(new Error('Connect timeout'));
+            }, 10_000);
+            // 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: [],
+                            client: {
+                                id: 'gateway-client',
+                                displayName: 'Agent Controller',
+                                version: '1',
+                                platform: process.platform,
+                                mode: 'backend',
+                            },
+                            minProtocol: 3,
+                            maxProtocol: 3,
+                        });
+                        this.connected = true;
+                        clearTimeout(connectTimer);
+                        this.onEvent = origHandler;
+                        resolve();
+                    }
+                    catch (e) {
+                        clearTimeout(connectTimer);
+                        reject(e);
+                    }
+                }
+            };
+        });
+    }
+    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();
+            // LEAK-2: store the per-request timeout so it can be cleared when the request resolves
+            const timer = setTimeout(() => {
+                if (this.pending.has(id)) {
+                    this.pending.delete(id);
+                    reject(new Error(`Request timeout: ${method}`));
+                }
+            }, 120_000);
+            this.pending.set(id, {
+                resolve: (payload) => { clearTimeout(timer); resolve(payload); },
+                reject: (err) => { clearTimeout(timer); reject(err); },
+            });
+            this.ws.send(JSON.stringify({ type: 'req', id, method, params }));
+        });
+    }
+    handleMessage(msg) {
+        if (typeof msg !== 'object' || msg === null)
+            return;
+        const m = msg;
+        if (m['type'] === 'event') {
+            this.onEvent?.(m);
+            return;
+        }
+        if (m['type'] === 'res') {
+            const id = m['id'];
+            const req = this.pending.get(id);
+            if (!req)
+                return;
+            this.pending.delete(id);
+            if (m['ok']) {
+                req.resolve(m['payload']);
+            }
+            else {
+                const errPayload = m['error'];
+                req.reject(new Error(errPayload?.message ?? 'Request failed'));
+            }
+        }
+    }
+    flushPending(err) {
+        for (const [, req] of this.pending) {
+            req.reject(err);
+        }
+        this.pending.clear();
+    }
+}
+//# sourceMappingURL=gateway-client.js.map

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

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

package/dist/providers/openclaw/index.d.ts

@@ -0,0 +1,21 @@
+import type { IAgentProvider, AgentHealthStatus, SendMessageParams } from '../types.js';
+import type { ChatSession, ChatMessage } from '../chat-types.js';
+export { OpenclawGatewayAdapter } from './gateway-adapter.js';
+export declare class OpenclawProvider implements IAgentProvider {
+    readonly name = "openclaw";
+    private adapter;
+    private wsUrl;
+    private wsToken;
+    private _connecting;
+    constructor(wsUrl: string, wsToken: string);
+    connect(): Promise<void>;
+    disconnect(): void;
+    isConnected(): boolean;
+    sendMessage(params: SendMessageParams): Promise<void>;
+    listSessions(): Promise<ChatSession[]>;
+    getHistory(sessionKey: string, limit?: number): Promise<ChatMessage[]>;
+    abort(sessionKey: string, runId?: string): Promise<void>;
+    healthCheck(): Promise<AgentHealthStatus>;
+    restart(): Promise<void>;
+    install(currentVersion?: string): Promise<void>;
+}

package/dist/providers/openclaw/index.js

@@ -0,0 +1,120 @@
+import { OpenclawGatewayAdapter } from './gateway-adapter.js';
+import { execAsync } from '../../utils/exec.js';
+export { OpenclawGatewayAdapter } from './gateway-adapter.js';
+export class OpenclawProvider {
+    name = 'openclaw';
+    adapter = null;
+    wsUrl;
+    wsToken;
+    _connecting = null;
+    constructor(wsUrl, wsToken) {
+        this.wsUrl = wsUrl;
+        this.wsToken = wsToken;
+    }
+    async connect() {
+        if (this.adapter?.isConnected())
+            return;
+        // Guard against concurrent connect calls
+        if (this._connecting) {
+            await this._connecting;
+            return;
+        }
+        this._connecting = (async () => {
+            const maxRetries = 5;
+            const baseDelayMs = 2000;
+            for (let attempt = 1; attempt <= maxRetries; attempt++) {
+                try {
+                    this.adapter = new OpenclawGatewayAdapter(this.wsUrl, this.wsToken);
+                    await this.adapter.connect();
+                    console.log(`OpenClaw Gateway WS connected (attempt ${attempt})`);
+                    return;
+                }
+                catch (e) {
+                    const msg = e instanceof Error ? e.message : String(e);
+                    console.warn(`Chat provider connect failed (attempt ${attempt}/${maxRetries}): ${msg}`);
+                    this.adapter?.disconnect();
+                    this.adapter = null;
+                    if (attempt < maxRetries) {
+                        await new Promise((r) => setTimeout(r, baseDelayMs * Math.min(attempt, 5)));
+                    }
+                }
+            }
+            throw new Error('OpenclawProvider: connect exhausted');
+        })();
+        try {
+            await this._connecting;
+        }
+        finally {
+            this._connecting = null;
+        }
+    }
+    disconnect() {
+        this.adapter?.disconnect();
+        this.adapter = null;
+        this._connecting = null;
+    }
+    isConnected() {
+        return this.adapter?.isConnected() ?? false;
+    }
+    // === Chat — delegate to gateway adapter ===
+    async sendMessage(params) {
+        if (!this.adapter) {
+            // Lazy connect
+            await this.connect();
+        }
+        if (!this.adapter)
+            throw new Error('Provider not connected');
+        await this.adapter.sendMessage(params);
+    }
+    async listSessions() {
+        if (!this.adapter)
+            return [];
+        return this.adapter.listSessions();
+    }
+    async getHistory(sessionKey, limit) {
+        if (!this.adapter)
+            return [];
+        return this.adapter.getHistory(sessionKey, limit);
+    }
+    async abort(sessionKey, runId) {
+        await this.adapter?.abort(sessionKey, runId);
+    }
+    // === Infrastructure ===
+    async healthCheck() {
+        try {
+            const output = await execAsync('openclaw health --json', 5000);
+            const parsed = JSON.parse(output);
+            const running = parsed.ok === true;
+            return { ok: running, rpcOk: running };
+        }
+        catch {
+            return { ok: false, rpcOk: false };
+        }
+    }
+    async restart() {
+        const { exec } = await import('node:child_process');
+        return new Promise((resolve) => {
+            exec('openclaw gateway restart', { timeout: 30_000 }, (error) => {
+                if (error)
+                    console.error('Gateway restart failed:', error.message);
+                else
+                    console.log('Gateway restarted');
+                resolve(); // always resolve — caller decides how to handle
+            });
+        });
+    }
+    async install(currentVersion) {
+        const { exec } = await import('node:child_process');
+        return new Promise((resolve, reject) => {
+            exec('npm i -g openclaw', { timeout: 120_000 }, (error, stdout, stderr) => {
+                if (error) {
+                    reject(Object.assign(error, { stdout: stdout.toString(), stderr: stderr.toString() }));
+                }
+                else {
+                    resolve();
+                }
+            });
+        });
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/providers/openclaw/index.js.map

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

package/dist/providers/types.d.ts

@@ -0,0 +1,38 @@
+import type { ChatSession, ChatMessage, ChatAttachment } from './chat-types.js';
+export type { ChatSession, ChatMessage, ChatAttachment };
+export interface AgentHealthStatus {
+    ok: boolean;
+    rpcOk: boolean;
+}
+export interface SendMessageParams {
+    sessionKey: string;
+    text: string;
+    idempotencyKey: string;
+    attachments?: ChatAttachment[];
+    onDelta?: (accumulatedText: string) => void;
+    onDone?: (finalText: string) => void;
+    onError?: (error: string) => void;
+}
+export interface IAgentProvider {
+    readonly name: string;
+    /** Initialize/connect the provider */
+    connect(): Promise<void>;
+    /** Disconnect/cleanup */
+    disconnect(): void;
+    /** Is provider connected and ready? */
+    isConnected(): boolean;
+    /** Send a message to the agent (task prompt, chat message, etc.) */
+    sendMessage(params: SendMessageParams): Promise<void>;
+    /** List active chat sessions */
+    listSessions(): Promise<ChatSession[]>;
+    /** Get chat history for a session */
+    getHistory(sessionKey: string, limit?: number): Promise<ChatMessage[]>;
+    /** Abort an in-flight message */
+    abort(sessionKey: string, runId?: string): Promise<void>;
+    /** Check if the agent runtime is healthy */
+    healthCheck(): Promise<AgentHealthStatus>;
+    /** Restart the agent runtime */
+    restart(): Promise<void>;
+    /** Install/update the agent runtime */
+    install(currentVersion?: string): Promise<void>;
+}

package/dist/providers/types.js

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

package/dist/providers/types.js.map

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

package/dist/types.d.ts

@@ -88,8 +88,14 @@ export interface CardDetail {
         assignedAgentId?: string | null;
     };
 }
+export interface MockAction {
+    type: 'wait' | 'artifact' | 'comment' | 'result' | 'move';
+    ms?: number;
+    body?: Record<string, unknown>;
+}
 export interface TaskInfo {
     cardProcessingId: string;
     prompt: string;
     workflowSteps: Array<Record<string, unknown>>;
+    mockActions?: MockAction[];
 }

package/dist/utils/gateway-restart.d.ts

@@ -3,8 +3,11 @@ export interface GatewayRestartResult {
     stderr: string;
 }
 /**
- * Runs `openclaw gateway restart` with a 30s timeout.
- * Resolves with { stdout, stderr } on success.
- * Rejects with an Error that also has stdout/stderr properties on failure.
+ * Restart the gateway via the configured agent provider.
+ * Returns { stdout: '', stderr: '' } for interface compatibility.
  */
-export declare function execGatewayRestart(): Promise<GatewayRestartResult>;
+export declare function restartGateway(): Promise<GatewayRestartResult>;
+/**
+ * @deprecated Use restartGateway() instead.
+ */
+export declare const execGatewayRestart: typeof restartGateway;

package/dist/utils/gateway-restart.js

@@ -1,23 +1,19 @@
-import { exec } from 'node:child_process';
+import { getProvider } from '../providers/index.js';
 /**
- * Runs `openclaw gateway restart` with a 30s timeout.
- * Resolves with { stdout, stderr } on success.
- * Rejects with an Error that also has stdout/stderr properties on failure.
+ * Restart the gateway via the configured agent provider.
+ * Returns { stdout: '', stderr: '' } for interface compatibility.
  */
-export function execGatewayRestart() {
-    return new Promise((resolve, reject) => {
-        exec('openclaw gateway restart', { timeout: 30_000 }, (error, stdout, stderr) => {
-            const result = {
-                stdout: stdout.toString(),
-                stderr: stderr.toString(),
-            };
-            if (error) {
-                reject(Object.assign(error, result));
-            }
-            else {
-                resolve(result);
-            }
-        });
-    });
+export async function restartGateway() {
+    const provider = getProvider();
+    if (!provider) {
+        console.warn('No provider configured, cannot restart gateway');
+        return { stdout: '', stderr: '' };
+    }
+    await provider.restart();
+    return { stdout: '', stderr: '' };
 }
+/**
+ * @deprecated Use restartGateway() instead.
+ */
+export const execGatewayRestart = restartGateway;
 //# sourceMappingURL=gateway-restart.js.map

package/dist/utils/gateway-restart.js.map

@@ -1 +1 @@
-{"version":3,"file":"gateway-restart.js","sourceRoot":"","sources":["../../src/utils/gateway-restart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAO1C;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAChC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,IAAI,CAAC,0BAA0B,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;YAC9E,MAAM,MAAM,GAAyB;gBACnC,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;gBACzB,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;aAC1B,CAAC;YACF,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;YACvC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC"}
+{"version":3,"file":"gateway-restart.js","sourceRoot":"","sources":["../../src/utils/gateway-restart.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAOpD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,MAAM,QAAQ,GAAG,WAAW,EAAE,CAAC;IAC/B,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,CAAC,IAAI,CAAC,gDAAgD,CAAC,CAAC;QAC/D,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IACpC,CAAC;IACD,MAAM,QAAQ,CAAC,OAAO,EAAE,CAAC;IACzB,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;AACpC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG,cAAc,CAAC"}

package/package.json

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