@agentdeck/bridge 0.1.0 → 0.2.1

package/dist/adapters/openclaw.d.ts

@@ -12,6 +12,11 @@ import type { AgentAdapter, AgentCapabilities, AdapterStartOptions, PluginComman
  * - Has no terminal (PTY), mode switching, or diff review
  * - Handles select_option/navigate_option/send_prompt directly via RPC
  */
+export interface OpenClawAdapterOptions {
+    gatewayUrl?: string;
+    /** Set false to disable automatic reconnect (daemon manages lifecycle externally) */
+    autoReconnect?: boolean;
+}
 export declare class OpenClawAdapter extends EventEmitter implements AgentAdapter {
     readonly capabilities: AgentCapabilities;
     private gatewayUrl;
@@ -23,19 +28,31 @@ export declare class OpenClawAdapter extends EventEmitter implements AgentAdapte
     private projectName;
     private alive;
     private shutdownRequested;
+    private externalHttpServer;
     private diagHandler;
     private rawDataCallback;
+    private autoReconnect;
     private currentSessionKey;
     private currentRunId;
     private pendingApprovalId;
+    private chatStarted;
+    private chatStartTime;
+    private chatToolCount;
+    private chatToolNames;
+    private lastPrompt;
+    private accumulatedResponse;
+    private topicExtracted;
+    private chatIsAutomated;
     private deviceIdentity;
     private deviceAuthToken;
     /** Reconnect delay (doubles on each failure, max 30s) */
     private reconnectDelay;
     private static readonly MAX_RECONNECT_DELAY;
     private static readonly RPC_TIMEOUT;
-    constructor(gatewayUrl?: string);
-    start(options: AdapterStartOptions): Promise<void>;
+    constructor(options?: string | OpenClawAdapterOptions);
+    start(options: AdapterStartOptions & {
+        externalServer?: Server;
+    }): Promise<void>;
     handleCommand(cmd: PluginCommand): boolean;
     writeInput(data: string): void;
     isAlive(): boolean;
@@ -53,6 +70,12 @@ export declare class OpenClawAdapter extends EventEmitter implements AgentAdapte
     private buildDeviceAuth;
     private connectGateway;
     private scheduleReconnect;
+    /**
+     * Typed RPC dispatch. `GatewayMethodMap` correlates the method name with
+     * its param shape and result shape (declared in `shared/gateway-protocol.ts`),
+     * so misuse — wrong params for a method, or calling an unknown method — is
+     * a compile error here rather than a runtime surprise.
+     */
     private rpcCall;
     private handleGatewayMessage;
     private handleGatewayEvent;
@@ -65,6 +88,17 @@ export declare class OpenClawAdapter extends EventEmitter implements AgentAdapte
     private fetchSessions;
     /** Fetch model catalog via CLI and emit events. Retries once on failure. */
     private emitModelCatalog;
+    /**
+     * Extract text from Gateway chat message structure.
+     * Format: payload.message = { role, content: [{ type: "text", text: "..." }], timestamp }
+     */
+    private extractMessageText;
+    /** Build tool count summary like "Read(3), Bash(2)" */
+    private buildToolSummary;
+    /** Emit a timeline event through the adapter event system */
+    private emitTimelineEntry;
+    /** Emit a timeline upsert (update existing entry with same ts+type, or add new) */
+    private emitTimelineUpsert;
     private emitAdapterEvent;
 }
 //# sourceMappingURL=openclaw.d.ts.map

package/dist/adapters/openclaw.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"openclaw.d.ts","sourceRoot":"","sources":["../../src/adapters/openclaw.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,MAAM,CAAC;AAOjD,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,mBAAmB,EAEnB,aAAa,EACd,MAAM,aAAa,CAAC;AA8DrB;;;;;;;;;;GAUG;AACH,qBAAa,eAAgB,SAAQ,YAAa,YAAW,YAAY;IACvE,QAAQ,CAAC,YAAY,EAAE,iBAAiB,CAAyB;IAEjE,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,EAAE,CAA0B;IACpC,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAK;IAClB,OAAO,CAAC,UAAU,CAIb;IACL,OAAO,CAAC,cAAc,CAA8C;IACpE,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,WAAW,CAA6C;IAChE,OAAO,CAAC,eAAe,CAAyC;IAGhE,OAAO,CAAC,iBAAiB,CAAuB;IAChD,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,iBAAiB,CAAuB;IAGhD,OAAO,CAAC,cAAc,CAA+B;IACrD,OAAO,CAAC,eAAe,CAAgC;IAEvD,yDAAyD;IACzD,OAAO,CAAC,cAAc,CAAQ;IAC9B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,mBAAmB,CAAU;IACrD,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAU;gBAEjC,UAAU,CAAC,EAAE,MAAM;IA0CzB,KAAK,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BxD,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,OAAO;IA4F1C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAc9B,OAAO,IAAI,OAAO;IAIlB,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,EAAE,OAAO,EAAE,MAAM,CAAC,cAAc,GAAG,IAAI;IAInF,UAAU,IAAI,MAAM,GAAG,SAAS;IAIhC,cAAc,IAAI,MAAM,GAAG,IAAI;IAI/B,aAAa,IAAI,MAAM;IAIvB,MAAM,CAAC,OAAO,EAAE,CAAC,IAAI,CAAC,EAAE,MAAM,KAAK,OAAO,GAAG,IAAI;IAIjD,SAAS,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI;IAI3C,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IA2B/B,OAAO,CAAC,kBAAkB;IA8B1B,kEAAkE;IAClE,OAAO,CAAC,qBAAqB;IAQ7B,mDAAmD;IACnD,OAAO,CAAC,eAAe;IAyCvB,OAAO,CAAC,cAAc;IAwDtB,OAAO,CAAC,iBAAiB;IAiBzB,OAAO,CAAC,OAAO;IA+Bf,OAAO,CAAC,oBAAoB;IA2B5B,OAAO,CAAC,kBAAkB;IAkG1B;;;OAGG;IACH,OAAO,CAAC,kBAAkB;IAuF1B,sEAAsE;YACxD,aAAa;IAoC3B,4EAA4E;IAC5E,OAAO,CAAC,gBAAgB;IAuCxB,OAAO,CAAC,gBAAgB;CAGzB"}
+{"version":3,"file":"openclaw.d.ts","sourceRoot":"","sources":["../../src/adapters/openclaw.ts"],"names":[],"mappings":"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"}

package/dist/adapters/openclaw.js

@@ -6,23 +6,10 @@ import { homedir } from 'os';
 import { createPublicKey, createPrivateKey, sign as cryptoSign, randomUUID } from 'crypto';
 import WebSocket from 'ws';
 import { debug } from '../logger.js';
+import { summarizeResponse, extractTopicHint } from '../timeline-summarizer.js';
+import { cleanDetailText, cleanRawText, cleanNopMarkers, ED25519_SPKI_PREFIX_LEN, GATEWAY_PROTOCOL_VERSION, } from '@agentdeck/shared';
 import { OPENCLAW_CAPABILITIES, OPENCLAW_GATEWAY_PORT } from '../types.js';
 import { fetchModelCatalog, getDefaultModelName, invalidateModelCache } from '../model-catalog.js';
-/** Ed25519 SPKI DER prefix length (bytes before the raw 32-byte key) */
-const ED25519_SPKI_PREFIX_LEN = 12;
-/** Protocol version supported by this adapter */
-const PROTOCOL_VERSION = 3;
-/**
- * OpenClaw adapter — connects to OpenClaw Gateway via WebSocket.
- *
- * Protocol: Custom framing (req/res/event), Ed25519 device auth handshake,
- * v3 protocol. Unlike ClaudeCodeAdapter (PTY-based), this adapter:
- * - Connects to an already-running Gateway process
- * - Authenticates via Ed25519 device signature (~/.openclaw/identity/)
- * - Uses req/res framing over WebSocket for all commands
- * - Has no terminal (PTY), mode switching, or diff review
- * - Handles select_option/navigate_option/send_prompt directly via RPC
- */
 export class OpenClawAdapter extends EventEmitter {
     capabilities = OPENCLAW_CAPABILITIES;
     gatewayUrl;
@@ -34,12 +21,23 @@ export class OpenClawAdapter extends EventEmitter {
     projectName = null;
     alive = false;
     shutdownRequested = false;
+    externalHttpServer = false;
     diagHandler = null;
     rawDataCallback = null;
+    autoReconnect;
     // Session tracking
     currentSessionKey = null;
     currentRunId = null;
     pendingApprovalId = null;
+    // Chat tracking for timeline events
+    chatStarted = false;
+    chatStartTime = 0;
+    chatToolCount = 0;
+    chatToolNames = [];
+    lastPrompt = null;
+    accumulatedResponse = '';
+    topicExtracted = false;
+    chatIsAutomated = false;
     // Device identity (loaded once on start)
     deviceIdentity = null;
     deviceAuthToken = null;
@@ -47,9 +45,17 @@ export class OpenClawAdapter extends EventEmitter {
     reconnectDelay = 1000;
     static MAX_RECONNECT_DELAY = 30_000;
     static RPC_TIMEOUT = 10_000;
-    constructor(gatewayUrl) {
+    constructor(options) {
         super();
-        this.gatewayUrl = gatewayUrl || `ws://127.0.0.1:${OPENCLAW_GATEWAY_PORT}`;
+        if (typeof options === 'string') {
+            // Legacy: constructor(gatewayUrl?: string)
+            this.gatewayUrl = options || `ws://127.0.0.1:${OPENCLAW_GATEWAY_PORT}`;
+            this.autoReconnect = true;
+        }
+        else {
+            this.gatewayUrl = options?.gatewayUrl || `ws://127.0.0.1:${OPENCLAW_GATEWAY_PORT}`;
+            this.autoReconnect = options?.autoReconnect ?? true;
+        }
         // Create bare HTTP server for WsServer (plugin) attachment.
         this.httpServer = createServer((req, res) => {
             if (req.method === 'GET' && req.url === '/health') {
@@ -92,21 +98,29 @@ export class OpenClawAdapter extends EventEmitter {
         }
         // Load device identity for Ed25519 auth (non-fatal if missing)
         this.loadDeviceIdentity();
-        // Start HTTP server for plugin WebSocket attachment
-        await new Promise((resolve, reject) => {
-            this.httpServer.on('error', (err) => {
-                if (err.code === 'EADDRINUSE') {
-                    reject(new Error(`Port ${options.port} is already in use.`));
-                }
-                else {
-                    reject(err);
-                }
-            });
-            this.httpServer.listen(options.port, '0.0.0.0', () => {
-                debug('adapter:openclaw', `HTTP server listening on 0.0.0.0:${options.port}`);
-                resolve();
+        if (options.externalServer) {
+            // Use externally provided HTTP server (daemon mode)
+            this.httpServer = options.externalServer;
+            this.externalHttpServer = true;
+            debug('adapter:openclaw', 'Using external HTTP server');
+        }
+        else {
+            // Start own HTTP server for plugin WebSocket attachment
+            await new Promise((resolve, reject) => {
+                this.httpServer.on('error', (err) => {
+                    if (err.code === 'EADDRINUSE') {
+                        reject(new Error(`Port ${options.port} is already in use.`));
+                    }
+                    else {
+                        reject(err);
+                    }
+                });
+                this.httpServer.listen(options.port, '127.0.0.1', () => {
+                    debug('adapter:openclaw', `HTTP server listening on 127.0.0.1:${options.port}`);
+                    resolve();
+                });
             });
-        });
+        }
         // Connect to OpenClaw Gateway
         this.connectGateway();
     }
@@ -146,6 +160,23 @@ export class OpenClawAdapter extends EventEmitter {
                 return true;
             case 'send_prompt': {
                 debug('adapter:openclaw', `send_prompt: "${cmd.text.slice(0, 60)}"`);
+                this.lastPrompt = cmd.text;
+                // Optimistic: immediate timeline + PROCESSING state (no waiting for delta)
+                if (!this.chatStarted) {
+                    this.chatStarted = true;
+                    this.chatIsAutomated = false;
+                    this.chatStartTime = Date.now();
+                    this.chatToolCount = 0;
+                    this.chatToolNames = [];
+                    const prompt = cmd.text;
+                    const promptRaw = prompt.length > 500 ? prompt.slice(0, 497) + '...' : prompt;
+                    const promptDetail = prompt.length > 100 ? (prompt.length > 1000 ? prompt.slice(0, 997) + '...' : prompt) : undefined;
+                    this.emitTimelineEntry({
+                        ts: Date.now(), type: 'chat_start', raw: promptRaw,
+                        ...(promptDetail ? { detail: promptDetail } : {}),
+                    });
+                    this.emitAdapterEvent({ source: 'parser', event: 'spinner_start' });
+                }
                 if (this.currentSessionKey) {
                     this.rpcCall('chat.send', {
                         sessionKey: this.currentSessionKey,
@@ -153,10 +184,24 @@ export class OpenClawAdapter extends EventEmitter {
                         idempotencyKey: randomUUID(),
                     }).catch((err) => {
                         debug('adapter:openclaw', `chat.send failed: ${err}`);
+                        this.emitTimelineEntry({
+                            ts: Date.now(), type: 'error', raw: `Send failed: ${err instanceof Error ? err.message : String(err)}`,
+                        });
+                        this.chatStarted = false;
+                        this.lastPrompt = null;
+                        this.accumulatedResponse = '';
+                        this.currentRunId = null;
+                        this.emitAdapterEvent({ source: 'parser', event: 'idle' });
                     });
                 }
                 else {
                     debug('adapter:openclaw', 'send_prompt: no active session');
+                    this.emitTimelineEntry({
+                        ts: Date.now(), type: 'error', raw: 'No active session',
+                    });
+                    this.chatStarted = false;
+                    this.emitAdapterEvent({ source: 'parser', event: 'idle' });
+                    return false;
                 }
                 return true;
             }
@@ -243,9 +288,11 @@ export class OpenClawAdapter extends EventEmitter {
             this.ws = null;
         }
         this.alive = false;
-        await new Promise((resolve) => {
-            this.httpServer.close(() => resolve());
-        });
+        if (!this.externalHttpServer) {
+            await new Promise((resolve) => {
+                this.httpServer.close(() => resolve());
+            });
+        }
     }
     // ===== Private: Device Identity =====
     loadDeviceIdentity() {
@@ -359,7 +406,7 @@ export class OpenClawAdapter extends EventEmitter {
         });
     }
     scheduleReconnect() {
-        if (this.shutdownRequested || this.reconnectTimer)
+        if (this.shutdownRequested || this.reconnectTimer || !this.autoReconnect)
             return;
         debug('adapter:openclaw', `Reconnecting in ${this.reconnectDelay}ms...`);
         this.reconnectTimer = setTimeout(() => {
@@ -369,6 +416,12 @@ export class OpenClawAdapter extends EventEmitter {
         this.reconnectDelay = Math.min(this.reconnectDelay * 2, OpenClawAdapter.MAX_RECONNECT_DELAY);
     }
     // ===== Private: Request/Response =====
+    /**
+     * Typed RPC dispatch. `GatewayMethodMap` correlates the method name with
+     * its param shape and result shape (declared in `shared/gateway-protocol.ts`),
+     * so misuse — wrong params for a method, or calling an unknown method — is
+     * a compile error here rather than a runtime surprise.
+     */
     rpcCall(method, params) {
         return new Promise((resolve, reject) => {
             if (!this.ws || this.ws.readyState !== WebSocket.OPEN) {
@@ -377,7 +430,11 @@ export class OpenClawAdapter extends EventEmitter {
             }
             const id = `r${++this.reqId}`;
             const message = { type: 'req', id, method, params };
-            this.pendingRpc.set(id, { resolve, reject, method });
+            this.pendingRpc.set(id, {
+                resolve: resolve,
+                reject,
+                method,
+            });
             setTimeout(() => {
                 if (this.pendingRpc.has(id)) {
                     this.pendingRpc.delete(id);
@@ -418,7 +475,7 @@ export class OpenClawAdapter extends EventEmitter {
             if (this.alive) {
                 this.emitAdapterEvent({ source: 'activity' });
             }
-            this.handleGatewayEvent(msg.event, msg.payload || {});
+            this.handleGatewayEvent(msg.event, (msg.payload ?? {}));
         }
     }
     handleGatewayEvent(event, payload) {
@@ -440,29 +497,177 @@ export class OpenClawAdapter extends EventEmitter {
                 const state = payload.state;
                 const runId = payload.runId;
                 const sessionKey = payload.sessionKey;
+                // Debug: log payload structure for diagnostic (delta/final only)
+                if (state === 'delta' || state === 'final') {
+                    const keys = Object.keys(payload).join(',');
+                    debug('adapter:openclaw', `Chat ${state} keys=[${keys}]`);
+                    if (state === 'delta') {
+                        // Log first delta fully for prompt discovery, then just keys
+                        if (!this.chatStarted) {
+                            debug('adapter:openclaw', `First delta payload: ${JSON.stringify(payload).slice(0, 800)}`);
+                        }
+                    }
+                    else {
+                        debug('adapter:openclaw', `Final payload: ${JSON.stringify(payload).slice(0, 800)}`);
+                    }
+                }
                 // Track active run and session
                 if (runId)
                     this.currentRunId = runId;
                 if (sessionKey)
                     this.currentSessionKey = sessionKey;
                 switch (state) {
-                    case 'delta':
+                    case 'delta': {
+                        // Extract text from Gateway message structure:
+                        // payload.message = { role: "assistant", content: [{ type: "text", text: "..." }] }
+                        const deltaText = this.extractMessageText(payload);
+                        if (!this.chatStarted) {
+                            // Non-optimistic path: gateway-initiated chat (cron, web, etc.)
+                            this.chatStarted = true;
+                            this.chatIsAutomated = !this.lastPrompt;
+                            this.chatStartTime = Date.now();
+                            this.chatToolCount = 0;
+                            this.chatToolNames = [];
+                            this.topicExtracted = false;
+                            this.accumulatedResponse = deltaText || '';
+                            const prompt = this.lastPrompt || '자동 작업';
+                            const promptRaw = prompt.length > 500 ? prompt.slice(0, 497) + '...' : prompt;
+                            const promptDetail = prompt.length > 100 ? (prompt.length > 1000 ? prompt.slice(0, 997) + '...' : prompt) : undefined;
+                            this.emitTimelineEntry({
+                                ts: Date.now(), type: 'chat_start', raw: promptRaw,
+                                ...(promptDetail ? { detail: promptDetail } : {}),
+                                ...(this.chatIsAutomated ? { automated: true } : {}),
+                            });
+                        }
+                        else {
+                            // Gateway always sends cumulative content — replace, never append
+                            if (deltaText) {
+                                this.accumulatedResponse = deltaText;
+                            }
+                            // Early topic extraction — upsert chat_start with topic hint
+                            if (!this.topicExtracted && this.accumulatedResponse.length > 20) {
+                                const topicHint = extractTopicHint(this.accumulatedResponse);
+                                if (topicHint && (!this.lastPrompt || this.lastPrompt === '자동 작업')) {
+                                    this.topicExtracted = true;
+                                    this.emitTimelineUpsert({
+                                        ts: this.chatStartTime, type: 'chat_start',
+                                        raw: cleanRawText(topicHint),
+                                    });
+                                }
+                            }
+                        }
                         this.emitAdapterEvent({
                             source: 'parser',
                             event: 'spinner_start',
                             data: { runId, sessionKey },
                         });
                         break;
-                    case 'final':
-                    case 'aborted':
+                    }
+                    case 'final': {
+                        // Extract modelId from payload if present (fallback when catalog probe fails)
+                        const modelId = payload.model ?? payload.modelId;
+                        if (typeof modelId === 'string' && modelId) {
+                            this.emitAdapterEvent({
+                                source: 'parser', event: 'model_info',
+                                data: { model: modelId, plan: null },
+                            });
+                        }
+                        const duration = this.chatStarted ? Math.round((Date.now() - this.chatStartTime) / 1000) : 0;
+                        const toolSummary = this.buildToolSummary();
+                        // Extract response content for detail + LLM summarization
+                        const finalText = this.extractMessageText(payload);
+                        const responseContent = (finalText || undefined)
+                            || (this.accumulatedResponse || undefined);
+                        // Emit chat_response for APME turn response capture
+                        if (responseContent) {
+                            const respRaw = responseContent.length > 500 ? responseContent.slice(0, 497) + '...' : responseContent;
+                            this.emitTimelineEntry({
+                                ts: Date.now(), type: 'chat_response',
+                                raw: cleanRawText(respRaw),
+                                detail: cleanDetailText(responseContent.slice(0, 3000)),
+                            });
+                        }
+                        const cleanedResponse = responseContent ? cleanNopMarkers(cleanDetailText(responseContent)) : undefined;
+                        const responseDetail = cleanedResponse
+                            ? (cleanedResponse.length > 1000 ? cleanedResponse.slice(0, 997) + '...' : cleanedResponse)
+                            : undefined;
+                        // Emit chat_end with heuristic summary, then async LLM enrichment
+                        const heuristicLabel = (responseContent && extractTopicHint(responseContent)) || 'Completed';
+                        const parts = [heuristicLabel];
+                        if (duration > 0)
+                            parts.push(`${duration}s`);
+                        if (toolSummary)
+                            parts.push(toolSummary);
+                        const chatEndTs = Date.now();
+                        this.emitTimelineEntry({
+                            ts: chatEndTs, type: 'chat_end', raw: parts.join(' \u00b7 '),
+                            ...(responseDetail ? { detail: responseDetail } : {}),
+                            ...(this.chatIsAutomated ? { automated: true } : {}),
+                        });
+                        // Async LLM summarization — fire-and-forget, upsert chat_end when ready
+                        if (responseContent && responseContent.length > 30) {
+                            const savedToolSummary = toolSummary;
+                            const savedDuration = duration;
+                            const savedAutomated = this.chatIsAutomated;
+                            summarizeResponse(responseContent).then((summary) => {
+                                if (summary) {
+                                    const enrichedParts = [summary];
+                                    if (savedDuration > 0)
+                                        enrichedParts.push(`${savedDuration}s`);
+                                    if (savedToolSummary)
+                                        enrichedParts.push(savedToolSummary);
+                                    debug('adapter:openclaw', `LLM summary: ${summary}`);
+                                    // Upsert chat_end with LLM summary replacing "Completed"
+                                    this.emitTimelineUpsert({
+                                        ts: chatEndTs, type: 'chat_end',
+                                        raw: enrichedParts.join(' \u00b7 '),
+                                        ...(responseDetail ? { detail: responseDetail } : {}),
+                                        ...(savedAutomated ? { automated: true } : {}),
+                                    });
+                                }
+                            }).catch(() => { });
+                        }
+                        this.chatStarted = false;
+                        this.lastPrompt = null;
+                        this.accumulatedResponse = '';
                         this.currentRunId = null;
                         this.emitAdapterEvent({ source: 'parser', event: 'idle' });
                         break;
-                    case 'error':
+                    }
+                    case 'aborted': {
+                        const abortDuration = this.chatStarted ? Math.round((Date.now() - this.chatStartTime) / 1000) : 0;
+                        const abortToolSummary = this.buildToolSummary();
+                        const abortParts = ['Aborted'];
+                        if (abortDuration > 0)
+                            abortParts.push(`after ${abortDuration}s`);
+                        if (abortToolSummary)
+                            abortParts.push(abortToolSummary);
+                        const abortDetail = this.accumulatedResponse || undefined;
+                        this.emitTimelineEntry({
+                            ts: Date.now(), type: 'chat_end', raw: abortParts.join(' \u00b7 '),
+                            ...(abortDetail ? { detail: abortDetail } : {}),
+                            ...(this.chatIsAutomated ? { automated: true } : {}),
+                        });
+                        this.chatStarted = false;
+                        this.lastPrompt = null;
+                        this.accumulatedResponse = '';
+                        this.currentRunId = null;
+                        this.emitAdapterEvent({ source: 'parser', event: 'idle' });
+                        break;
+                    }
+                    case 'error': {
+                        const errMsg = payload.errorMessage || 'unknown';
+                        this.emitTimelineEntry({
+                            ts: Date.now(), type: 'error', raw: errMsg,
+                        });
+                        this.chatStarted = false;
+                        this.lastPrompt = null;
+                        this.accumulatedResponse = '';
                         this.currentRunId = null;
-                        debug('adapter:openclaw', `Chat error: ${payload.errorMessage || 'unknown'}`);
+                        debug('adapter:openclaw', `Chat error: ${errMsg}`);
                         this.emitAdapterEvent({ source: 'parser', event: 'idle' });
                         break;
+                    }
                 }
                 break;
             }
@@ -472,6 +677,20 @@ export class OpenClawAdapter extends EventEmitter {
                 const command = payload.command;
                 const ask = payload.ask;
                 this.pendingApprovalId = approvalId;
+                // Track tool for chat summary
+                const toolName = command?.split(' ')[0] || 'tool';
+                this.chatToolCount++;
+                if (!this.chatToolNames.includes(toolName)) {
+                    this.chatToolNames.push(toolName);
+                }
+                const toolRaw = ask ? `${command}: ${ask}` : (command || 'Approve tool execution?');
+                const toolRequestRaw = toolRaw.length > 500 ? toolRaw.slice(0, 497) + '...' : toolRaw;
+                const toolRequestDetail = ask && ask.length > 100 ? (ask.length > 1000 ? ask.slice(0, 997) + '...' : ask) : undefined;
+                this.emitTimelineEntry({
+                    ts: Date.now(), type: 'tool_request', raw: toolRequestRaw,
+                    ...(toolRequestDetail ? { detail: toolRequestDetail } : {}),
+                    approvalId, status: 'pending',
+                });
                 this.emitAdapterEvent({
                     source: 'parser',
                     event: 'permission_prompt',
@@ -487,11 +706,32 @@ export class OpenClawAdapter extends EventEmitter {
                 });
                 break;
             }
-            case 'exec.approval.resolved':
+            case 'exec.approval.resolved': {
                 // Approval resolved (by us or another client) → processing continues
+                const resolvedId = this.pendingApprovalId;
+                const decision = payload.decision || 'allow';
                 this.pendingApprovalId = null;
+                if (resolvedId) {
+                    this.emitTimelineEntry({
+                        ts: Date.now(), type: 'tool_resolved',
+                        raw: decision === 'allow' ? 'Approved' : 'Denied',
+                        approvalId: resolvedId,
+                        status: decision === 'allow' ? 'approved' : 'denied',
+                    });
+                }
                 this.emitAdapterEvent({ source: 'parser', event: 'spinner_start' });
                 break;
+            }
+            // ===== Gateway health =====
+            case 'health': {
+                const ok = payload.ok;
+                this.emitAdapterEvent({
+                    source: 'metadata',
+                    event: 'gateway_health',
+                    data: { ok, payload },
+                });
+                break;
+            }
             // ===== Presence / keepalive =====
             case 'presence':
             case 'tick':
@@ -520,8 +760,8 @@ export class OpenClawAdapter extends EventEmitter {
             ?? ['operator.admin', 'operator.approvals', 'operator.read'];
         const authToken = this.deviceAuthToken?.token ?? '';
         const params = {
-            minProtocol: PROTOCOL_VERSION,
-            maxProtocol: PROTOCOL_VERSION,
+            minProtocol: GATEWAY_PROTOCOL_VERSION,
+            maxProtocol: GATEWAY_PROTOCOL_VERSION,
             client: {
                 id: 'gateway-client',
                 displayName: 'AgentDeck',
@@ -563,9 +803,9 @@ export class OpenClawAdapter extends EventEmitter {
                     }
                 }
                 // Fetch sessions (async, non-blocking)
-                this.fetchSessions();
+                this.fetchSessions().catch(err => debug('adapter:openclaw', `fetchSessions error: ${err}`));
                 // Fetch model catalog (async, non-blocking)
-                this.emitModelCatalog();
+                this.emitModelCatalog().catch(err => debug('adapter:openclaw', `emitModelCatalog error: ${err}`));
             },
             reject: (err) => {
                 debug('adapter:openclaw', `Handshake failed: ${err.message}`);
@@ -605,15 +845,14 @@ export class OpenClawAdapter extends EventEmitter {
             // Pick the most recently updated session
             const sorted = [...sessions].sort((a, b) => (b.updatedAt || 0) - (a.updatedAt || 0));
             this.currentSessionKey = sorted[0].key;
-            const label = sorted[0].label || sorted[0].displayName;
-            if (label) {
-                this.projectName = label;
-                this.emitAdapterEvent({
-                    source: 'parser',
-                    event: 'project_name',
-                    data: { name: label },
-                });
-            }
+            // Use fixed name — Gateway session labels can be user identifiers
+            // (e.g. phone numbers) which are unsuitable as project names
+            this.projectName = 'OpenClaw';
+            this.emitAdapterEvent({
+                source: 'parser',
+                event: 'project_name',
+                data: { name: 'OpenClaw' },
+            });
             debug('adapter:openclaw', `Active session: ${this.currentSessionKey}`);
         }
         catch (err) {
@@ -621,11 +860,11 @@ export class OpenClawAdapter extends EventEmitter {
         }
     }
     /** Fetch model catalog via CLI and emit events. Retries once on failure. */
-    emitModelCatalog(retry = true) {
+    async emitModelCatalog(retry = true) {
         // Invalidate cache on reconnect to get fresh data
         invalidateModelCache();
         try {
-            const catalog = fetchModelCatalog();
+            const catalog = await fetchModelCatalog();
             if (!catalog) {
                 if (retry && this.alive) {
                     debug('adapter:openclaw', 'Model catalog empty — retrying in 10s');
@@ -634,7 +873,7 @@ export class OpenClawAdapter extends EventEmitter {
                 return;
             }
             // Emit model_info for default model name (StateMachine uses this)
-            const defaultModel = getDefaultModelName();
+            const defaultModel = await getDefaultModelName();
             if (defaultModel) {
                 this.emitAdapterEvent({
                     source: 'parser',
@@ -657,6 +896,37 @@ export class OpenClawAdapter extends EventEmitter {
             }
         }
     }
+    /**
+     * Extract text from Gateway chat message structure.
+     * Format: payload.message = { role, content: [{ type: "text", text: "..." }], timestamp }
+     */
+    extractMessageText(payload) {
+        const msg = payload.message;
+        if (!msg)
+            return undefined;
+        const content = msg.content;
+        if (!content || !Array.isArray(content))
+            return undefined;
+        const texts = content
+            .filter(c => c.type === 'text' && c.text)
+            .map(c => c.text);
+        return texts.length > 0 ? texts.join('') : undefined;
+    }
+    /** Build tool count summary like "Read(3), Bash(2)" */
+    buildToolSummary() {
+        if (this.chatToolNames.length === 0)
+            return '';
+        // Count occurrences (simplified — uses total count distributed)
+        return this.chatToolNames.join(', ');
+    }
+    /** Emit a timeline event through the adapter event system */
+    emitTimelineEntry(entry) {
+        this.emitAdapterEvent({ source: 'timeline', entry });
+    }
+    /** Emit a timeline upsert (update existing entry with same ts+type, or add new) */
+    emitTimelineUpsert(entry) {
+        this.emitAdapterEvent({ source: 'timeline', entry, upsert: true });
+    }
     emitAdapterEvent(evt) {
         this.emit('event', evt);
     }