@phuetz/code-buddy 0.3.0 → 1.0.0-rc.8

package/dist/openclaw/gateway-bridge.js

@@ -0,0 +1,1748 @@
+import { constants as fsConstants } from 'fs';
+import { access, appendFile, mkdir, readFile, writeFile } from 'fs/promises';
+import * as os from 'os';
+import * as path from 'path';
+import { randomUUID } from 'crypto';
+import { execFile as execFileCallback } from 'node:child_process';
+import { promisify } from 'node:util';
+import WebSocket from 'ws';
+const execFile = promisify(execFileCallback);
+const OPENCLAW_BRIDGE_SCHEMA_VERSION = 1;
+const DEFAULT_OPENCLAW_HOME = path.join(os.homedir(), '.openclaw');
+const EXECUTION_METHODS = [
+    'openclaw.message.ingest',
+    'openclaw.message.reply.preview',
+    'peer.describe',
+    'peer.chat',
+    'peer.chat-session.start',
+    'peer.chat-session.continue',
+    'peer.tool.invoke',
+];
+function resolveCwd(cwd) {
+    return cwd || process.cwd();
+}
+function resolveOpenClawHome(options = {}) {
+    return path.resolve(options.home || DEFAULT_OPENCLAW_HOME);
+}
+export function getOpenClawGatewayLockfilePath(options = {}) {
+    return path.resolve(options.lockfilePath || path.join(resolveOpenClawHome(options), 'gateway.json'));
+}
+export function getOpenClawNodeLockfilePath(options = {}) {
+    return path.resolve(options.nodeLockfilePath || path.join(resolveOpenClawHome(options), 'node.json'));
+}
+function getOpenClawBridgeDraftsDir(cwd) {
+    return path.join(cwd, '.codebuddy', 'openclaw', 'bridge');
+}
+export function getOpenClawGatewayAttachLogPath(cwd = process.cwd()) {
+    return path.join(cwd, '.codebuddy', 'openclaw', 'bridge', 'attach-log.jsonl');
+}
+export function getOpenClawResponseSendLogPath(cwd = process.cwd()) {
+    return path.join(cwd, '.codebuddy', 'openclaw', 'bridge', 'send-log.jsonl');
+}
+export function getOpenClawWebSocketProbeLogPath(cwd = process.cwd()) {
+    return path.join(cwd, '.codebuddy', 'openclaw', 'bridge', 'ws-probe-log.jsonl');
+}
+export function getOpenClawWebSocketCallLogPath(cwd = process.cwd()) {
+    return path.join(cwd, '.codebuddy', 'openclaw', 'bridge', 'ws-call-log.jsonl');
+}
+function compactRedactedText(text, max = 260) {
+    const redacted = text
+        .replace(/\s+/g, ' ')
+        .trim()
+        .replace(/\b(?:sk|pk|xox[baprs]|gh[pousr])-[A-Za-z0-9_-]{8,}\b/g, '[redacted-token]')
+        .replace(/\b(api[_-]?key|access[_-]?token|refresh[_-]?token|secret|password)\s*[:=]\s*\S+/gi, '$1=[redacted]');
+    if (redacted.length <= max)
+        return redacted;
+    return `${redacted.slice(0, max - 15)}... [truncated]`;
+}
+function safeFileId(value) {
+    return value.replace(/[^a-zA-Z0-9_.-]+/g, '_').slice(0, 80) || 'message';
+}
+function normalizeMethods(value) {
+    if (!Array.isArray(value))
+        return [];
+    return [...new Set(value.filter((item) => typeof item === 'string' && item.trim().length > 0))].sort();
+}
+async function openClawFileExists(filePath) {
+    try {
+        await access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function readOpenClawUnifiedConfig(home) {
+    try {
+        return JSON.parse(await readFile(path.join(home, 'openclaw.json'), 'utf8'));
+    }
+    catch {
+        return null;
+    }
+}
+function openClawHostFromGatewayConfig(gateway) {
+    if (typeof gateway?.host === 'string' && gateway.host.trim())
+        return gateway.host.trim();
+    // bind ∈ loopback|tailnet|lan|auto|custom — the Code Buddy bridge always runs
+    // on the same host as the gateway, so localhost is the safe attach target.
+    return '127.0.0.1';
+}
+/**
+ * Build a gateway lockfile from the unified `openclaw.json`. Returns null when
+ * the config has no usable gateway port. The token is carried for auth but, as
+ * with the legacy path, discovery only surfaces its presence — never its value.
+ */
+function synthesizeGatewayLockfileFromUnifiedConfig(config) {
+    const gateway = config?.gateway;
+    if (!gateway || typeof gateway.port !== 'number')
+        return null;
+    const host = openClawHostFromGatewayConfig(gateway);
+    const port = gateway.port;
+    const token = typeof gateway.auth?.token === 'string' ? gateway.auth.token : undefined;
+    const httpUrl = `http://${host}:${port}`;
+    return {
+        endpoint: httpUrl,
+        wsUrl: `ws://${host}:${port}`,
+        httpUrl,
+        rpcUrl: httpUrl,
+        methods: [],
+        ...(token ? { token } : {}),
+    };
+}
+/**
+ * Build a node-host lockfile from the real OpenClaw `devices/paired.json` map
+ * (keyed by deviceId) plus gateway host/port from the unified config. Prefers a
+ * paired operator device. Pairing tokens are carried for auth but never output.
+ */
+async function synthesizeNodeLockfileFromDevices(home) {
+    let paired;
+    try {
+        paired = JSON.parse(await readFile(path.join(home, 'devices', 'paired.json'), 'utf8'));
+    }
+    catch {
+        return null;
+    }
+    if (!paired || typeof paired !== 'object')
+        return null;
+    const entries = Object.values(paired)
+        .filter((entry) => Boolean(entry) && typeof entry === 'object');
+    if (entries.length === 0)
+        return null;
+    const entry = entries.find((candidate) => candidate.role === 'operator') ?? entries[0];
+    if (!entry)
+        return null;
+    const config = await readOpenClawUnifiedConfig(home);
+    const gateway = config?.gateway;
+    const host = gateway && typeof gateway.port === 'number' ? openClawHostFromGatewayConfig(gateway) : undefined;
+    const port = typeof gateway?.port === 'number' ? gateway.port : undefined;
+    const deviceId = typeof entry.deviceId === 'string' ? entry.deviceId : undefined;
+    const tokens = entry.tokens && typeof entry.tokens === 'object'
+        ? entry.tokens
+        : undefined;
+    const operatorToken = typeof tokens?.operator?.token === 'string' ? tokens.operator.token : undefined;
+    const token = operatorToken ?? (typeof entry.token === 'string' ? entry.token : undefined);
+    const capabilities = Array.isArray(entry.scopes)
+        ? entry.scopes.filter((scope) => typeof scope === 'string')
+        : [];
+    return {
+        ...(deviceId ? { nodeId: deviceId } : {}),
+        ...(typeof entry.clientId === 'string' ? { displayName: entry.clientId } : {}),
+        ...(host ? { gatewayHost: host } : {}),
+        ...(port !== undefined ? { gatewayPort: port } : {}),
+        ...(host && port !== undefined ? { wsUrl: `ws://${host}:${port}` } : {}),
+        tls: false,
+        ...(token ? { token } : {}),
+        capabilities,
+    };
+}
+async function readOpenClawLockfile(lockfilePath) {
+    try {
+        return JSON.parse(await readFile(lockfilePath, 'utf8'));
+    }
+    catch {
+        // Fallback for OpenClaw 2026.6.x, which has no standalone gateway.json:
+        // synthesize the lockfile from the unified openclaw.json in the same home.
+        if (path.basename(lockfilePath) === 'gateway.json') {
+            return synthesizeGatewayLockfileFromUnifiedConfig(await readOpenClawUnifiedConfig(path.dirname(lockfilePath)));
+        }
+        return null;
+    }
+}
+async function readOpenClawNodeLockfile(lockfilePath) {
+    try {
+        return JSON.parse(await readFile(lockfilePath, 'utf8'));
+    }
+    catch {
+        // Fallback for OpenClaw 2026.6.x: derive node-host metadata from the real
+        // devices/paired.json + openclaw.json instead of the legacy node.json.
+        if (path.basename(lockfilePath) === 'node.json') {
+            return synthesizeNodeLockfileFromDevices(path.dirname(lockfilePath));
+        }
+        return null;
+    }
+}
+function nodeIdFromLockfile(lockfile) {
+    if (typeof lockfile?.nodeId === 'string' && lockfile.nodeId.trim())
+        return lockfile.nodeId.trim();
+    if (typeof lockfile?.id === 'string' && lockfile.id.trim())
+        return lockfile.id.trim();
+    return undefined;
+}
+function nodeDisplayNameFromLockfile(lockfile) {
+    if (typeof lockfile?.displayName === 'string' && lockfile.displayName.trim())
+        return lockfile.displayName.trim();
+    if (typeof lockfile?.name === 'string' && lockfile.name.trim())
+        return lockfile.name.trim();
+    return undefined;
+}
+function nodeGatewayHostFromLockfile(lockfile) {
+    if (typeof lockfile?.gatewayHost === 'string' && lockfile.gatewayHost.trim())
+        return lockfile.gatewayHost.trim();
+    if (typeof lockfile?.host === 'string' && lockfile.host.trim())
+        return lockfile.host.trim();
+    return undefined;
+}
+function nodeGatewayPortFromLockfile(lockfile) {
+    if (typeof lockfile?.gatewayPort === 'number')
+        return lockfile.gatewayPort;
+    if (typeof lockfile?.port === 'number')
+        return lockfile.port;
+    return undefined;
+}
+function nodeTokenFromLockfile(lockfile) {
+    if (typeof lockfile?.token === 'string' && lockfile.token.trim())
+        return lockfile.token.trim();
+    if (typeof lockfile?.pairingToken === 'string' && lockfile.pairingToken.trim())
+        return lockfile.pairingToken.trim();
+    return undefined;
+}
+function resolveAttachEndpoint(lockfile, endpointPath) {
+    const base = typeof lockfile?.rpcUrl === 'string'
+        ? lockfile.rpcUrl
+        : typeof lockfile?.httpUrl === 'string'
+            ? lockfile.httpUrl
+            : typeof lockfile?.endpoint === 'string'
+                ? lockfile.endpoint
+                : undefined;
+    if (!base)
+        return undefined;
+    try {
+        return new URL(endpointPath, base.endsWith('/') ? base : `${base}/`).toString();
+    }
+    catch {
+        return undefined;
+    }
+}
+function resolveWebSocketEndpoint(lockfile) {
+    const candidate = typeof lockfile?.wsUrl === 'string'
+        ? lockfile.wsUrl
+        : typeof lockfile?.endpoint === 'string'
+            ? lockfile.endpoint
+            : typeof lockfile?.httpUrl === 'string'
+                ? lockfile.httpUrl
+                : undefined;
+    if (!candidate)
+        return undefined;
+    try {
+        const url = new URL(candidate);
+        if (url.protocol === 'ws:' || url.protocol === 'wss:')
+            return url.toString();
+        if (url.protocol === 'http:') {
+            url.protocol = 'ws:';
+            return url.toString();
+        }
+        if (url.protocol === 'https:') {
+            url.protocol = 'wss:';
+            return url.toString();
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function tokenFromLockfile(lockfile) {
+    if (typeof lockfile?.token === 'string' && lockfile.token.trim())
+        return lockfile.token.trim();
+    if (typeof lockfile?.apiKey === 'string' && lockfile.apiKey.trim())
+        return lockfile.apiKey.trim();
+    if (typeof lockfile?.secret === 'string' && lockfile.secret.trim())
+        return lockfile.secret.trim();
+    return undefined;
+}
+async function defaultAttachTransport(url, init) {
+    const res = await fetch(url, init);
+    const contentType = res.headers.get('content-type') || '';
+    if (contentType.includes('application/json')) {
+        return {
+            ok: res.ok,
+            status: res.status,
+            json: await res.json(),
+        };
+    }
+    return {
+        ok: res.ok,
+        status: res.status,
+        text: await res.text(),
+    };
+}
+function responseSummary(response) {
+    const body = response.json && typeof response.json === 'object'
+        ? response.json
+        : {};
+    const accepted = typeof body.accepted === 'boolean' ? body.accepted : undefined;
+    const nodeId = typeof body.nodeId === 'string' ? body.nodeId : undefined;
+    const error = typeof body.error === 'string'
+        ? body.error
+        : response.ok
+            ? undefined
+            : response.text || `OpenClaw attach failed with HTTP ${response.status}`;
+    return {
+        status: response.status,
+        ok: response.ok,
+        ...(accepted !== undefined ? { accepted } : {}),
+        ...(nodeId ? { nodeId } : {}),
+        ...(error ? { error } : {}),
+    };
+}
+async function appendAttachRecord(attachLogPath, record) {
+    await mkdir(path.dirname(attachLogPath), { recursive: true });
+    await appendFile(attachLogPath, `${JSON.stringify(record)}\n`, 'utf8');
+}
+function sendResponseSummary(response) {
+    const body = response.json && typeof response.json === 'object'
+        ? response.json
+        : {};
+    const accepted = typeof body.accepted === 'boolean' ? body.accepted : undefined;
+    const messageId = typeof body.messageId === 'string' ? body.messageId : undefined;
+    const error = typeof body.error === 'string'
+        ? body.error
+        : response.ok
+            ? undefined
+            : response.text || `OpenClaw response send failed with HTTP ${response.status}`;
+    return {
+        status: response.status,
+        ok: response.ok,
+        ...(accepted !== undefined ? { accepted } : {}),
+        ...(messageId ? { messageId } : {}),
+        ...(error ? { error } : {}),
+    };
+}
+async function appendSendRecord(sendLogPath, record) {
+    await mkdir(path.dirname(sendLogPath), { recursive: true });
+    await appendFile(sendLogPath, `${JSON.stringify(record)}\n`, 'utf8');
+}
+async function appendWebSocketProbeRecord(probeLogPath, record) {
+    await mkdir(path.dirname(probeLogPath), { recursive: true });
+    await appendFile(probeLogPath, `${JSON.stringify(record)}\n`, 'utf8');
+}
+async function appendWebSocketCallRecord(callLogPath, record) {
+    await mkdir(path.dirname(callLogPath), { recursive: true });
+    await appendFile(callLogPath, `${JSON.stringify(record)}\n`, 'utf8');
+}
+function parseOpenClawWebSocketFrame(data) {
+    const raw = Array.isArray(data)
+        ? Buffer.concat(data).toString('utf8')
+        : Buffer.isBuffer(data)
+            ? data.toString('utf8')
+            : data instanceof ArrayBuffer
+                ? Buffer.from(data).toString('utf8')
+                : String(data);
+    const parsed = JSON.parse(raw);
+    return parsed && typeof parsed === 'object' ? parsed : {};
+}
+function frameType(frame) {
+    return typeof frame.type === 'string'
+        ? frame.type
+        : typeof frame.event === 'string'
+            ? frame.event
+            : typeof frame.kind === 'string'
+                ? frame.kind
+                : 'unknown';
+}
+function responsePayloadFromFrame(frame) {
+    if ('payload' in frame)
+        return frame.payload;
+    if ('result' in frame)
+        return frame.result;
+    if ('data' in frame)
+        return frame.data;
+    return undefined;
+}
+async function executableExists(filePath) {
+    try {
+        await access(filePath, fsConstants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function findOpenClawBinary(explicitPath) {
+    const trimmed = explicitPath?.trim();
+    if (trimmed)
+        return await executableExists(trimmed) ? path.resolve(trimmed) : undefined;
+    const pathValue = process.env.PATH || '';
+    const extensions = process.platform === 'win32'
+        ? (process.env.PATHEXT || '.EXE;.CMD;.BAT;.COM').split(';').filter(Boolean)
+        : [''];
+    for (const directory of pathValue.split(path.delimiter).filter(Boolean)) {
+        for (const extension of extensions) {
+            const candidate = path.join(directory, `openclaw${extension.toLowerCase()}`);
+            if (await executableExists(candidate))
+                return candidate;
+            const originalCase = path.join(directory, `openclaw${extension}`);
+            if (originalCase !== candidate && await executableExists(originalCase))
+                return originalCase;
+        }
+    }
+    return undefined;
+}
+function summarizeOpenClawCliStatus(stdout, exitCode) {
+    let parsed = {};
+    let jsonParsed = false;
+    try {
+        const value = JSON.parse(stdout);
+        if (value && typeof value === 'object' && !Array.isArray(value)) {
+            parsed = value;
+            jsonParsed = true;
+        }
+    }
+    catch {
+        jsonParsed = false;
+    }
+    const status = typeof parsed.status === 'string'
+        ? parsed.status
+        : typeof parsed.state === 'string'
+            ? parsed.state
+            : undefined;
+    const running = typeof parsed.running === 'boolean'
+        ? parsed.running
+        : typeof parsed.active === 'boolean'
+            ? parsed.active
+            : undefined;
+    const healthy = typeof parsed.healthy === 'boolean'
+        ? parsed.healthy
+        : typeof parsed.ok === 'boolean'
+            ? parsed.ok
+            : undefined;
+    const version = typeof parsed.version === 'string'
+        ? parsed.version
+        : typeof parsed.openclawVersion === 'string'
+            ? parsed.openclawVersion
+            : undefined;
+    return {
+        command: 'openclaw gateway status --json',
+        exitCode,
+        jsonParsed,
+        ...(status ? { status } : {}),
+        ...(running !== undefined ? { running } : {}),
+        ...(healthy !== undefined ? { healthy } : {}),
+        ...(version ? { version } : {}),
+    };
+}
+async function runOpenClawCliGatewayStatus(binaryPath, timeoutMs) {
+    try {
+        const result = await execFile(binaryPath, ['gateway', 'status', '--json'], {
+            timeout: timeoutMs,
+            maxBuffer: 128 * 1024,
+        });
+        return summarizeOpenClawCliStatus(result.stdout, 0);
+    }
+    catch (error) {
+        const maybe = error;
+        const exitCode = typeof maybe.code === 'number' ? maybe.code : 1;
+        const stdout = typeof maybe.stdout === 'string' ? maybe.stdout : '';
+        return {
+            ...summarizeOpenClawCliStatus(stdout, exitCode),
+            ...(stdout.trim() ? {} : { error: 'OpenClaw CLI gateway status failed without JSON output' }),
+        };
+    }
+}
+function safeNodePairingSummary(payload) {
+    const body = payload && typeof payload === 'object' ? payload : {};
+    const rawNodes = Array.isArray(body.nodes)
+        ? body.nodes
+        : Array.isArray(body.pending)
+            ? body.pending
+            : Array.isArray(payload)
+                ? payload
+                : [];
+    const nodes = rawNodes
+        .filter((node) => Boolean(node) && typeof node === 'object')
+        .map((node) => {
+        const nodeId = typeof node.nodeId === 'string'
+            ? node.nodeId
+            : typeof node.id === 'string'
+                ? node.id
+                : undefined;
+        const displayName = typeof node.displayName === 'string'
+            ? node.displayName
+            : typeof node.name === 'string'
+                ? node.name
+                : undefined;
+        return {
+            ...(nodeId ? { nodeId } : {}),
+            ...(displayName ? { displayName } : {}),
+            pairingCodePresent: typeof node.code === 'string' || typeof node.pairingCode === 'string',
+        };
+    });
+    return {
+        pendingCount: nodes.length,
+        nodes,
+    };
+}
+function safeNodeApprovalSummary(payload) {
+    const body = payload && typeof payload === 'object' ? payload : {};
+    const approved = typeof body.approved === 'boolean'
+        ? body.approved
+        : typeof body.ok === 'boolean'
+            ? body.ok
+            : undefined;
+    const nodeId = typeof body.nodeId === 'string'
+        ? body.nodeId
+        : typeof body.id === 'string'
+            ? body.id
+            : undefined;
+    return {
+        ...(approved !== undefined ? { approved } : {}),
+        ...(nodeId ? { nodeId } : {}),
+    };
+}
+function safeNodeRejectionSummary(payload) {
+    const body = payload && typeof payload === 'object' ? payload : {};
+    const rejected = typeof body.rejected === 'boolean'
+        ? body.rejected
+        : typeof body.ok === 'boolean'
+            ? body.ok
+            : undefined;
+    const nodeId = typeof body.nodeId === 'string'
+        ? body.nodeId
+        : typeof body.id === 'string'
+            ? body.id
+            : undefined;
+    return {
+        ...(rejected !== undefined ? { rejected } : {}),
+        ...(nodeId ? { nodeId } : {}),
+    };
+}
+function methodSampleFromHello(frame) {
+    return methodsFromHello(frame).slice(0, 12);
+}
+function methodsFromHello(frame) {
+    const features = frame.features && typeof frame.features === 'object'
+        ? frame.features
+        : undefined;
+    return normalizeMethods(features?.methods);
+}
+function gatewayIdFromHello(frame) {
+    const presence = frame.presence && typeof frame.presence === 'object'
+        ? frame.presence
+        : undefined;
+    const gateway = frame.gateway && typeof frame.gateway === 'object'
+        ? frame.gateway
+        : undefined;
+    return typeof presence?.gatewayId === 'string'
+        ? presence.gatewayId
+        : typeof gateway?.id === 'string'
+            ? gateway.id
+            : typeof frame.gatewayId === 'string'
+                ? frame.gatewayId
+                : undefined;
+}
+function uptimeFromHello(frame) {
+    return typeof frame.uptimeMs === 'number'
+        ? frame.uptimeMs
+        : typeof frame.uptime === 'number'
+            ? frame.uptime
+            : undefined;
+}
+export async function discoverOpenClawGateway(options = {}) {
+    const cwd = resolveCwd(options.cwd);
+    const now = options.now || new Date();
+    const home = resolveOpenClawHome(options);
+    const lockfilePath = getOpenClawGatewayLockfilePath({ ...options, home });
+    const nodeLockfilePath = getOpenClawNodeLockfilePath({ ...options, home });
+    const parsed = await readOpenClawLockfile(lockfilePath);
+    const node = await readOpenClawNodeLockfile(nodeLockfilePath);
+    // Re-derive which file each came from so the audit trail names the real source
+    // (legacy gateway.json/node.json vs. the OpenClaw 2026.6.x unified layout).
+    const lockfileSource = parsed
+        ? (await openClawFileExists(lockfilePath) ? 'gateway.json' : 'openclaw.json')
+        : undefined;
+    const nodeSource = node
+        ? (await openClawFileExists(nodeLockfilePath) ? 'node.json' : 'devices/paired.json')
+        : undefined;
+    const tokenPresent = Boolean(parsed?.token || parsed?.apiKey || parsed?.secret);
+    const nodeTokenPresent = Boolean(nodeTokenFromLockfile(node));
+    const recommendations = [];
+    if (!parsed) {
+        recommendations.push('Start OpenClaw Gateway or provide --lockfile pointing at gateway.json.');
+    }
+    if (parsed && !parsed.wsUrl && !parsed.endpoint && !parsed.rpcUrl) {
+        recommendations.push('OpenClaw gateway lockfile has no endpoint/wsUrl/rpcUrl for bridge attachment.');
+    }
+    if (!node) {
+        recommendations.push('Run OpenClaw node host or provide --node-lockfile pointing at node.json for node-host pairing metadata.');
+    }
+    return {
+        kind: 'openclaw_gateway_discovery',
+        schemaVersion: OPENCLAW_BRIDGE_SCHEMA_VERSION,
+        generatedAt: now.toISOString(),
+        cwd,
+        home,
+        lockfilePath,
+        found: Boolean(parsed),
+        ...(lockfileSource ? { lockfileSource } : {}),
+        ...(nodeSource ? { nodeSource } : {}),
+        daemon: {
+            ...(typeof parsed?.nodeId === 'string' ? { nodeId: parsed.nodeId } : {}),
+            ...(typeof parsed?.pid === 'number' ? { pid: parsed.pid } : {}),
+            ...(typeof parsed?.endpoint === 'string' ? { endpoint: parsed.endpoint } : {}),
+            ...(typeof parsed?.wsUrl === 'string' ? { wsUrl: parsed.wsUrl } : {}),
+            ...(typeof parsed?.httpUrl === 'string' ? { httpUrl: parsed.httpUrl } : {}),
+            ...(typeof parsed?.rpcUrl === 'string' ? { rpcUrl: parsed.rpcUrl } : {}),
+            ...(typeof parsed?.workspace === 'string' ? { workspace: parsed.workspace } : {}),
+            methods: normalizeMethods(parsed?.methods),
+        },
+        nodeHost: {
+            found: Boolean(node),
+            ...(nodeIdFromLockfile(node) ? { nodeId: nodeIdFromLockfile(node) } : {}),
+            ...(nodeDisplayNameFromLockfile(node) ? { displayName: nodeDisplayNameFromLockfile(node) } : {}),
+            ...(nodeGatewayHostFromLockfile(node) ? { gatewayHost: nodeGatewayHostFromLockfile(node) } : {}),
+            ...(nodeGatewayPortFromLockfile(node) !== undefined ? { gatewayPort: nodeGatewayPortFromLockfile(node) } : {}),
+            ...(typeof node?.tls === 'boolean' ? { tls: node.tls } : {}),
+            ...(typeof node?.wsUrl === 'string' ? { wsUrl: node.wsUrl } : {}),
+            capabilities: normalizeMethods(node?.capabilities).length > 0
+                ? normalizeMethods(node?.capabilities)
+                : normalizeMethods(node?.methods),
+        },
+        safety: {
+            secretsIncluded: false,
+            tokenPresent,
+            nodeTokenPresent,
+            networkContacted: false,
+        },
+        recommendations,
+    };
+}
+export async function attachOpenClawGateway(input = {}, options = {}) {
+    const cwd = resolveCwd(options.cwd);
+    const now = options.now || new Date();
+    const discovery = await discoverOpenClawGateway({ ...options, cwd, now });
+    const lockfile = await readOpenClawLockfile(discovery.lockfilePath);
+    const descriptor = input.descriptor || buildOpenClawNodeDescriptor();
+    const endpointPath = input.endpointPath || 'nodes/register';
+    const endpoint = resolveAttachEndpoint(lockfile, endpointPath);
+    const token = tokenFromLockfile(lockfile);
+    const dryRun = input.dryRun !== false;
+    const liveAttachConfirmed = input.liveAttachConfirmed === true;
+    const attachLogPath = path.resolve(cwd, options.attachLogPath || getOpenClawGatewayAttachLogPath(cwd));
+    const baseRecord = {
+        id: options.createId?.() || `openclaw_attach_${now.getTime()}`,
+        kind: 'openclaw_gateway_attach',
+        schemaVersion: OPENCLAW_BRIDGE_SCHEMA_VERSION,
+        createdAt: now.toISOString(),
+        cwd,
+        lockfilePath: discovery.lockfilePath,
+        ...(endpoint ? { endpoint } : {}),
+        endpointPath,
+        dryRun,
+        ...(input.approvedBy?.trim() ? { approvedBy: input.approvedBy.trim() } : {}),
+        liveAttachConfirmed,
+        request: {
+            method: 'POST',
+            nodeId: descriptor.nodeId,
+            role: descriptor.role,
+            methods: descriptor.methods,
+        },
+    };
+    const safetyBase = {
+        secretsIncluded: false,
+        tokenPresent: Boolean(token),
+        tokenSent: false,
+        rawMessageContentIncluded: false,
+        networkContacted: false,
+        requiresLocalApproval: true,
+    };
+    const blockedReason = !discovery.found
+        ? 'OpenClaw gateway lockfile was not found'
+        : !endpoint
+            ? 'OpenClaw gateway endpoint is missing or invalid'
+            : !dryRun && !input.approvedBy?.trim()
+                ? 'approvedBy is required for live OpenClaw gateway attach'
+                : !dryRun && !liveAttachConfirmed
+                    ? 'liveAttachConfirmed is required for live OpenClaw gateway attach'
+                    : undefined;
+    if (blockedReason) {
+        const record = {
+            ...baseRecord,
+            status: 'blocked',
+            response: {
+                status: 0,
+                ok: false,
+                error: blockedReason,
+            },
+            safety: safetyBase,
+        };
+        await appendAttachRecord(attachLogPath, record);
+        return {
+            kind: 'openclaw_gateway_attach_result',
+            ok: false,
+            attachLogPath,
+            record,
+            discovery,
+            descriptor,
+            error: blockedReason,
+        };
+    }
+    if (dryRun) {
+        const record = {
+            ...baseRecord,
+            status: 'preview',
+            safety: safetyBase,
+        };
+        await appendAttachRecord(attachLogPath, record);
+        return {
+            kind: 'openclaw_gateway_attach_result',
+            ok: true,
+            attachLogPath,
+            record,
+            discovery,
+            descriptor,
+        };
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), input.timeoutMs ?? 5_000);
+    try {
+        const transport = options.transport || defaultAttachTransport;
+        const headers = {
+            'content-type': 'application/json',
+        };
+        if (token)
+            headers.authorization = `Bearer ${token}`;
+        const response = await transport(endpoint, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({
+                descriptor,
+                bridge: {
+                    implementation: 'codebuddy',
+                    schemaVersion: OPENCLAW_BRIDGE_SCHEMA_VERSION,
+                    safety: descriptor.safety,
+                },
+            }),
+            signal: controller.signal,
+        });
+        const summarized = responseSummary(response);
+        const record = {
+            ...baseRecord,
+            status: response.ok ? 'attached' : 'failed',
+            response: summarized,
+            safety: {
+                ...safetyBase,
+                tokenSent: Boolean(token),
+                networkContacted: true,
+            },
+        };
+        await appendAttachRecord(attachLogPath, record);
+        return {
+            kind: 'openclaw_gateway_attach_result',
+            ok: response.ok,
+            attachLogPath,
+            record,
+            discovery,
+            descriptor,
+            ...(summarized.error ? { error: summarized.error } : {}),
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const record = {
+            ...baseRecord,
+            status: 'failed',
+            response: {
+                status: 0,
+                ok: false,
+                error: message,
+            },
+            safety: {
+                ...safetyBase,
+                tokenSent: Boolean(token),
+                networkContacted: true,
+            },
+        };
+        await appendAttachRecord(attachLogPath, record);
+        return {
+            kind: 'openclaw_gateway_attach_result',
+            ok: false,
+            attachLogPath,
+            record,
+            discovery,
+            descriptor,
+            error: message,
+        };
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+export function buildOpenClawNodeDescriptor(input = {}) {
+    return {
+        kind: 'openclaw_node_descriptor',
+        schemaVersion: OPENCLAW_BRIDGE_SCHEMA_VERSION,
+        nodeId: input.nodeId || 'codebuddy-openclaw-node',
+        name: input.name || 'Code Buddy OpenClaw Bridge',
+        role: 'codebuddy-fleet-bridge',
+        methods: [...new Set([...EXECUTION_METHODS, ...(input.extraMethods || [])])].sort(),
+        capabilities: {
+            fleetDispatchDraft: true,
+            companionGatewayInbox: true,
+            outboundReplyPreview: true,
+            directGatewaySend: false,
+            rawTextStorage: false,
+        },
+        safety: {
+            localOnly: true,
+            requiresLocalApproval: true,
+            autoDispatch: false,
+            secretsIncluded: false,
+        },
+    };
+}
+export async function prepareOpenClawFleetHandoffDraft(message, options = {}) {
+    if (!message.id.trim())
+        throw new Error('OpenClaw message id is required');
+    if (!message.channel.trim())
+        throw new Error('OpenClaw message channel is required');
+    if (!message.senderId.trim())
+        throw new Error('OpenClaw senderId is required');
+    if (!message.text.trim())
+        throw new Error('OpenClaw message text is required');
+    const cwd = resolveCwd(options.cwd);
+    const now = options.now || new Date();
+    const id = options.createId?.() || `openclaw_handoff_${safeFileId(message.id)}_${randomUUID()}`;
+    const threadId = message.threadId || message.senderId;
+    const draftFile = path.join(getOpenClawBridgeDraftsDir(cwd), `${safeFileId(id)}.fleet.json`);
+    const preview = compactRedactedText(message.text);
+    const dispatchInput = {
+        goal: [
+            'OpenClaw gateway handoff for Code Buddy Fleet.',
+            `Channel: ${message.channel}`,
+            `Sender: ${message.senderName || message.senderId}`,
+            `Thread: ${threadId}`,
+            `Preview: ${preview || '[empty preview]'}`,
+            'Use the preview only; request local approval before any external reply.',
+        ].join('\n'),
+        parallelism: 1,
+        privacyTag: 'sensitive',
+        dispatchProfile: 'safe',
+        deliveryChannel: `openclaw:${message.channel}`,
+        sourceSessionId: `openclaw:${message.channel}:${threadId}`,
+    };
+    const draft = {
+        kind: 'openclaw_fleet_handoff_draft',
+        schemaVersion: OPENCLAW_BRIDGE_SCHEMA_VERSION,
+        id,
+        createdAt: now.toISOString(),
+        cwd,
+        draftFile,
+        source: {
+            openclawMessageId: message.id,
+            channel: message.channel,
+            senderId: message.senderId,
+            ...(message.senderName ? { senderName: message.senderName } : {}),
+            threadId,
+            ...(message.messageId ? { messageId: message.messageId } : {}),
+            contentType: message.contentType || 'text',
+            attachmentCount: message.attachmentCount || 0,
+        },
+        dispatchInput,
+        safety: {
+            rawTextStored: false,
+            previewOnly: true,
+            autoDispatch: false,
+            requiresLocalApproval: true,
+            directGatewaySend: false,
+        },
+    };
+    await mkdir(path.dirname(draftFile), { recursive: true });
+    await writeFile(draftFile, `${JSON.stringify(draft, null, 2)}\n`, 'utf8');
+    return draft;
+}
+export function buildOpenClawResponsePreview(input) {
+    if (!input.text.trim())
+        throw new Error('response text is required');
+    return {
+        kind: 'openclaw_bridge_response_preview',
+        schemaVersion: OPENCLAW_BRIDGE_SCHEMA_VERSION,
+        createdAt: (input.now || new Date()).toISOString(),
+        openclawMessageId: input.openclawMessageId,
+        channel: input.channel,
+        threadId: input.threadId,
+        textPreview: compactRedactedText(input.text),
+        dryRun: true,
+        requiresLocalApproval: true,
+        safety: {
+            rawTextStored: false,
+            directGatewaySend: false,
+            secretsIncluded: false,
+        },
+    };
+}
+export async function sendOpenClawResponse(input, options = {}) {
+    const cwd = resolveCwd(options.cwd);
+    const now = options.now || new Date();
+    const preview = buildOpenClawResponsePreview({
+        openclawMessageId: input.openclawMessageId,
+        channel: input.channel,
+        threadId: input.threadId,
+        text: input.text,
+        now,
+    });
+    const discovery = await discoverOpenClawGateway({ ...options, cwd, now });
+    const lockfile = await readOpenClawLockfile(discovery.lockfilePath);
+    const endpointPath = input.endpointPath || 'messages/reply';
+    const endpoint = resolveAttachEndpoint(lockfile, endpointPath);
+    const token = tokenFromLockfile(lockfile);
+    const dryRun = input.dryRun !== false;
+    const liveSendConfirmed = input.liveSendConfirmed === true;
+    const sendLogPath = path.resolve(cwd, options.sendLogPath || getOpenClawResponseSendLogPath(cwd));
+    const baseRecord = {
+        id: options.createId?.() || `openclaw_send_${safeFileId(input.openclawMessageId)}_${now.getTime()}`,
+        kind: 'openclaw_response_send',
+        schemaVersion: OPENCLAW_BRIDGE_SCHEMA_VERSION,
+        createdAt: now.toISOString(),
+        cwd,
+        lockfilePath: discovery.lockfilePath,
+        ...(endpoint ? { endpoint } : {}),
+        endpointPath,
+        openclawMessageId: input.openclawMessageId,
+        channel: input.channel,
+        threadId: input.threadId,
+        textPreview: preview.textPreview,
+        dryRun,
+        ...(input.approvedBy?.trim() ? { approvedBy: input.approvedBy.trim() } : {}),
+        liveSendConfirmed,
+    };
+    const safetyBase = {
+        secretsIncluded: false,
+        tokenPresent: Boolean(token),
+        tokenSent: false,
+        rawMessageContentIncluded: false,
+        networkContacted: false,
+        requiresLocalApproval: true,
+    };
+    const blockedReason = !discovery.found
+        ? 'OpenClaw gateway lockfile was not found'
+        : !endpoint
+            ? 'OpenClaw gateway response endpoint is missing or invalid'
+            : !dryRun && !input.approvedBy?.trim()
+                ? 'approvedBy is required for live OpenClaw response send'
+                : !dryRun && !liveSendConfirmed
+                    ? 'liveSendConfirmed is required for live OpenClaw response send'
+                    : undefined;
+    if (blockedReason) {
+        const record = {
+            ...baseRecord,
+            status: 'blocked',
+            response: {
+                status: 0,
+                ok: false,
+                error: blockedReason,
+            },
+            safety: safetyBase,
+        };
+        await appendSendRecord(sendLogPath, record);
+        return {
+            kind: 'openclaw_response_send_result',
+            ok: false,
+            sendLogPath,
+            record,
+            discovery,
+            preview,
+            error: blockedReason,
+        };
+    }
+    if (dryRun) {
+        const record = {
+            ...baseRecord,
+            status: 'preview',
+            safety: safetyBase,
+        };
+        await appendSendRecord(sendLogPath, record);
+        return {
+            kind: 'openclaw_response_send_result',
+            ok: true,
+            sendLogPath,
+            record,
+            discovery,
+            preview,
+        };
+    }
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), input.timeoutMs ?? 5_000);
+    try {
+        const transport = options.transport || defaultAttachTransport;
+        const headers = {
+            'content-type': 'application/json',
+        };
+        if (token)
+            headers.authorization = `Bearer ${token}`;
+        const response = await transport(endpoint, {
+            method: 'POST',
+            headers,
+            body: JSON.stringify({
+                openclawMessageId: input.openclawMessageId,
+                channel: input.channel,
+                threadId: input.threadId,
+                text: input.text,
+                approvedBy: input.approvedBy?.trim(),
+                safety: {
+                    requiresLocalApproval: true,
+                    source: 'codebuddy-openclaw-bridge',
+                },
+            }),
+            signal: controller.signal,
+        });
+        const summarized = sendResponseSummary(response);
+        const record = {
+            ...baseRecord,
+            status: response.ok ? 'sent' : 'failed',
+            response: summarized,
+            safety: {
+                ...safetyBase,
+                tokenSent: Boolean(token),
+                networkContacted: true,
+            },
+        };
+        await appendSendRecord(sendLogPath, record);
+        return {
+            kind: 'openclaw_response_send_result',
+            ok: response.ok,
+            sendLogPath,
+            record,
+            discovery,
+            preview,
+            ...(summarized.error ? { error: summarized.error } : {}),
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        const record = {
+            ...baseRecord,
+            status: 'failed',
+            response: {
+                status: 0,
+                ok: false,
+                error: message,
+            },
+            safety: {
+                ...safetyBase,
+                tokenSent: Boolean(token),
+                networkContacted: true,
+            },
+        };
+        await appendSendRecord(sendLogPath, record);
+        return {
+            kind: 'openclaw_response_send_result',
+            ok: false,
+            sendLogPath,
+            record,
+            discovery,
+            preview,
+            error: message,
+        };
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+export async function probeOpenClawGatewayWebSocket(input = {}, options = {}) {
+    const cwd = resolveCwd(options.cwd);
+    const now = options.now || new Date();
+    const discovery = await discoverOpenClawGateway({ ...options, cwd, now });
+    const lockfile = await readOpenClawLockfile(discovery.lockfilePath);
+    const token = tokenFromLockfile(lockfile);
+    const wsUrl = resolveWebSocketEndpoint(lockfile);
+    const dryRun = input.dryRun !== false;
+    const liveProbeConfirmed = input.liveProbeConfirmed === true;
+    const statusMethod = input.statusMethod || 'status';
+    const requestId = options.createId?.() || `openclaw_ws_probe_${now.getTime()}`;
+    const probeLogPath = path.resolve(cwd, options.probeLogPath || getOpenClawWebSocketProbeLogPath(cwd));
+    const baseRecord = {
+        id: requestId,
+        kind: 'openclaw_websocket_probe',
+        schemaVersion: OPENCLAW_BRIDGE_SCHEMA_VERSION,
+        createdAt: now.toISOString(),
+        cwd,
+        lockfilePath: discovery.lockfilePath,
+        ...(wsUrl ? { wsUrl } : {}),
+        dryRun,
+        ...(input.approvedBy?.trim() ? { approvedBy: input.approvedBy.trim() } : {}),
+        liveProbeConfirmed,
+        request: {
+            connectFrameType: 'connect',
+            statusMethod,
+            requestId,
+        },
+    };
+    const safetyBase = {
+        secretsIncluded: false,
+        tokenPresent: Boolean(token),
+        tokenSent: false,
+        rawPayloadsStored: false,
+        networkContacted: false,
+        requiresLocalApproval: true,
+    };
+    const blockedReason = !discovery.found
+        ? 'OpenClaw gateway lockfile was not found'
+        : !wsUrl
+            ? 'OpenClaw gateway WebSocket endpoint is missing or invalid'
+            : !dryRun && !input.approvedBy?.trim()
+                ? 'approvedBy is required for live OpenClaw WebSocket probe'
+                : !dryRun && !liveProbeConfirmed
+                    ? 'liveProbeConfirmed is required for live OpenClaw WebSocket probe'
+                    : undefined;
+    if (blockedReason) {
+        const record = {
+            ...baseRecord,
+            status: 'blocked',
+            response: {
+                helloOk: false,
+                frameTypes: [],
+                error: blockedReason,
+            },
+            safety: safetyBase,
+        };
+        await appendWebSocketProbeRecord(probeLogPath, record);
+        return {
+            kind: 'openclaw_websocket_probe_result',
+            ok: false,
+            probeLogPath,
+            record,
+            discovery,
+            error: blockedReason,
+        };
+    }
+    if (dryRun) {
+        const record = {
+            ...baseRecord,
+            status: 'preview',
+            safety: safetyBase,
+        };
+        await appendWebSocketProbeRecord(probeLogPath, record);
+        return {
+            kind: 'openclaw_websocket_probe_result',
+            ok: true,
+            probeLogPath,
+            record,
+            discovery,
+        };
+    }
+    return await new Promise((resolve) => {
+        const frameTypes = [];
+        let helloFrame = null;
+        let resolved = false;
+        let statusResponseOk;
+        const timeout = setTimeout(() => {
+            finish(false, 'OpenClaw WebSocket probe timed out');
+        }, input.timeoutMs ?? 5_000);
+        const socket = new WebSocket(wsUrl, {
+            handshakeTimeout: input.timeoutMs ?? 5_000,
+        });
+        const finish = (ok, error) => {
+            if (resolved)
+                return;
+            resolved = true;
+            clearTimeout(timeout);
+            try {
+                socket.close();
+            }
+            catch {
+                // Ignore close failures while finalizing a probe result.
+            }
+            const methods = helloFrame ? methodsFromHello(helloFrame) : [];
+            const record = {
+                ...baseRecord,
+                status: ok ? 'connected' : 'failed',
+                response: {
+                    helloOk: Boolean(helloFrame),
+                    ...(statusResponseOk !== undefined ? { statusResponseOk } : {}),
+                    ...(helloFrame ? { gatewayId: gatewayIdFromHello(helloFrame) } : {}),
+                    ...(helloFrame ? { uptimeMs: uptimeFromHello(helloFrame) } : {}),
+                    methodCount: methods.length,
+                    methodSample: methods.slice(0, 12),
+                    frameTypes,
+                    ...(error ? { error } : {}),
+                },
+                safety: {
+                    ...safetyBase,
+                    tokenSent: Boolean(token),
+                    networkContacted: true,
+                },
+            };
+            void appendWebSocketProbeRecord(probeLogPath, record).then(() => {
+                resolve({
+                    kind: 'openclaw_websocket_probe_result',
+                    ok,
+                    probeLogPath,
+                    record,
+                    discovery,
+                    ...(error ? { error } : {}),
+                });
+            }, (writeError) => {
+                const message = writeError instanceof Error ? writeError.message : String(writeError);
+                resolve({
+                    kind: 'openclaw_websocket_probe_result',
+                    ok: false,
+                    probeLogPath,
+                    record: {
+                        ...record,
+                        status: 'failed',
+                        response: {
+                            ...record.response,
+                            error: message,
+                        },
+                    },
+                    discovery,
+                    error: message,
+                });
+            });
+        };
+        socket.on('open', () => {
+            const connectFrame = {
+                type: 'connect',
+                client: {
+                    name: 'Code Buddy OpenClaw Bridge',
+                    role: 'codebuddy-fleet-bridge',
+                    schemaVersion: OPENCLAW_BRIDGE_SCHEMA_VERSION,
+                },
+                ...(token ? { auth: { token } } : {}),
+            };
+            socket.send(JSON.stringify(connectFrame));
+        });
+        socket.on('message', (data) => {
+            let frame;
+            try {
+                frame = parseOpenClawWebSocketFrame(data);
+            }
+            catch (error) {
+                finish(false, `OpenClaw WebSocket returned non-JSON frame: ${error instanceof Error ? error.message : String(error)}`);
+                return;
+            }
+            const type = frameType(frame);
+            frameTypes.push(type);
+            if ((type === 'hello-ok' || type === 'hello_ok') && !helloFrame) {
+                helloFrame = frame;
+                socket.send(JSON.stringify({
+                    type: 'req',
+                    id: requestId,
+                    method: statusMethod,
+                    params: {
+                        source: 'codebuddy-openclaw-bridge',
+                    },
+                }));
+                return;
+            }
+            if (type === 'res' || type === 'response') {
+                const ok = typeof frame.ok === 'boolean'
+                    ? frame.ok
+                    : !(frame.error || frame.err);
+                statusResponseOk = ok;
+                finish(ok, ok ? undefined : 'OpenClaw WebSocket status request failed');
+                return;
+            }
+            if (type === 'error') {
+                const message = typeof frame.message === 'string'
+                    ? frame.message
+                    : typeof frame.error === 'string'
+                        ? frame.error
+                        : 'OpenClaw WebSocket returned an error frame';
+                finish(false, message);
+            }
+        });
+        socket.on('error', (error) => {
+            finish(false, error instanceof Error ? error.message : String(error));
+        });
+        socket.on('close', (code, reason) => {
+            if (!resolved) {
+                const detail = reason.length > 0 ? `: ${reason.toString('utf8')}` : '';
+                finish(false, `OpenClaw WebSocket closed before probe completed (${code})${detail}`);
+            }
+        });
+    });
+}
+export async function callOpenClawGatewayWebSocket(input, options = {}) {
+    if (!input.method.trim())
+        throw new Error('OpenClaw WebSocket method is required');
+    const cwd = resolveCwd(options.cwd);
+    const now = options.now || new Date();
+    const discovery = await discoverOpenClawGateway({ ...options, cwd, now });
+    const lockfile = await readOpenClawLockfile(discovery.lockfilePath);
+    const token = tokenFromLockfile(lockfile);
+    const wsUrl = resolveWebSocketEndpoint(lockfile);
+    const dryRun = input.dryRun !== false;
+    const liveCallConfirmed = input.liveCallConfirmed === true;
+    const method = input.method.trim();
+    const requestId = options.createId?.() || `openclaw_ws_call_${now.getTime()}`;
+    const params = input.params && typeof input.params === 'object' ? input.params : {};
+    const paramKeys = Object.keys(params).sort();
+    const callLogPath = path.resolve(cwd, options.callLogPath || getOpenClawWebSocketCallLogPath(cwd));
+    const baseRecord = {
+        id: requestId,
+        kind: 'openclaw_websocket_call',
+        schemaVersion: OPENCLAW_BRIDGE_SCHEMA_VERSION,
+        createdAt: now.toISOString(),
+        cwd,
+        lockfilePath: discovery.lockfilePath,
+        ...(wsUrl ? { wsUrl } : {}),
+        dryRun,
+        ...(input.approvedBy?.trim() ? { approvedBy: input.approvedBy.trim() } : {}),
+        liveCallConfirmed,
+        request: {
+            method,
+            requestId,
+            paramKeys,
+        },
+    };
+    const safetyBase = {
+        secretsIncluded: false,
+        tokenPresent: Boolean(token),
+        tokenSent: false,
+        rawPayloadsStored: false,
+        networkContacted: false,
+        requiresLocalApproval: true,
+    };
+    const blockedReason = !discovery.found
+        ? 'OpenClaw gateway lockfile was not found'
+        : !wsUrl
+            ? 'OpenClaw gateway WebSocket endpoint is missing or invalid'
+            : !dryRun && !input.approvedBy?.trim()
+                ? 'approvedBy is required for live OpenClaw WebSocket call'
+                : !dryRun && !liveCallConfirmed
+                    ? 'liveCallConfirmed is required for live OpenClaw WebSocket call'
+                    : undefined;
+    if (blockedReason) {
+        const record = {
+            ...baseRecord,
+            status: 'blocked',
+            response: {
+                helloOk: false,
+                frameTypes: [],
+                error: blockedReason,
+            },
+            safety: safetyBase,
+        };
+        await appendWebSocketCallRecord(callLogPath, record);
+        return {
+            kind: 'openclaw_websocket_call_result',
+            ok: false,
+            callLogPath,
+            record,
+            discovery,
+            error: blockedReason,
+        };
+    }
+    if (dryRun) {
+        const record = {
+            ...baseRecord,
+            status: 'preview',
+            safety: safetyBase,
+        };
+        await appendWebSocketCallRecord(callLogPath, record);
+        return {
+            kind: 'openclaw_websocket_call_result',
+            ok: true,
+            callLogPath,
+            record,
+            discovery,
+        };
+    }
+    return await new Promise((resolve) => {
+        const frameTypes = [];
+        let helloOk = false;
+        let resolved = false;
+        let rpcOk;
+        let safePayloadSummary;
+        const timeout = setTimeout(() => {
+            finish(false, 'OpenClaw WebSocket call timed out');
+        }, input.timeoutMs ?? 5_000);
+        const socket = new WebSocket(wsUrl, {
+            handshakeTimeout: input.timeoutMs ?? 5_000,
+        });
+        const finish = (ok, error) => {
+            if (resolved)
+                return;
+            resolved = true;
+            clearTimeout(timeout);
+            try {
+                socket.close();
+            }
+            catch {
+                // Ignore close failures while finalizing a call result.
+            }
+            const record = {
+                ...baseRecord,
+                status: ok ? 'called' : 'failed',
+                response: {
+                    helloOk,
+                    ...(rpcOk !== undefined ? { rpcOk } : {}),
+                    frameTypes,
+                    ...(safePayloadSummary ? { summary: safePayloadSummary } : {}),
+                    ...(error ? { error } : {}),
+                },
+                safety: {
+                    ...safetyBase,
+                    tokenSent: Boolean(token),
+                    networkContacted: true,
+                },
+            };
+            void appendWebSocketCallRecord(callLogPath, record).then(() => {
+                resolve({
+                    kind: 'openclaw_websocket_call_result',
+                    ok,
+                    callLogPath,
+                    record,
+                    discovery,
+                    ...(error ? { error } : {}),
+                });
+            }, (writeError) => {
+                const message = writeError instanceof Error ? writeError.message : String(writeError);
+                resolve({
+                    kind: 'openclaw_websocket_call_result',
+                    ok: false,
+                    callLogPath,
+                    record: {
+                        ...record,
+                        status: 'failed',
+                        response: {
+                            ...record.response,
+                            error: message,
+                        },
+                    },
+                    discovery,
+                    error: message,
+                });
+            });
+        };
+        socket.on('open', () => {
+            socket.send(JSON.stringify({
+                type: 'connect',
+                client: {
+                    name: 'Code Buddy OpenClaw Bridge',
+                    role: 'codebuddy-fleet-bridge',
+                    schemaVersion: OPENCLAW_BRIDGE_SCHEMA_VERSION,
+                },
+                ...(token ? { auth: { token } } : {}),
+            }));
+        });
+        socket.on('message', (data) => {
+            let frame;
+            try {
+                frame = parseOpenClawWebSocketFrame(data);
+            }
+            catch (error) {
+                finish(false, `OpenClaw WebSocket returned non-JSON frame: ${error instanceof Error ? error.message : String(error)}`);
+                return;
+            }
+            const type = frameType(frame);
+            frameTypes.push(type);
+            if ((type === 'hello-ok' || type === 'hello_ok') && !helloOk) {
+                helloOk = true;
+                socket.send(JSON.stringify({
+                    type: 'req',
+                    id: requestId,
+                    method,
+                    params,
+                }));
+                return;
+            }
+            if (type === 'res' || type === 'response') {
+                const ok = typeof frame.ok === 'boolean'
+                    ? frame.ok
+                    : !(frame.error || frame.err);
+                rpcOk = ok;
+                safePayloadSummary = options.summarizePayload?.(responsePayloadFromFrame(frame));
+                finish(ok, ok ? undefined : `OpenClaw WebSocket call failed for ${method}`);
+                return;
+            }
+            if (type === 'error') {
+                const message = typeof frame.message === 'string'
+                    ? frame.message
+                    : typeof frame.error === 'string'
+                        ? frame.error
+                        : `OpenClaw WebSocket returned an error frame for ${method}`;
+                finish(false, message);
+            }
+        });
+        socket.on('error', (error) => {
+            finish(false, error instanceof Error ? error.message : String(error));
+        });
+        socket.on('close', (code, reason) => {
+            if (!resolved) {
+                const detail = reason.length > 0 ? `: ${reason.toString('utf8')}` : '';
+                finish(false, `OpenClaw WebSocket closed before call completed (${code})${detail}`);
+            }
+        });
+    });
+}
+export async function listOpenClawPendingNodes(input = {}, options = {}) {
+    return await callOpenClawGatewayWebSocket({
+        method: 'nodes.pending',
+        params: {},
+        approvedBy: input.approvedBy,
+        liveCallConfirmed: input.liveCallConfirmed,
+        dryRun: input.dryRun,
+        timeoutMs: input.timeoutMs,
+    }, {
+        ...options,
+        summarizePayload: safeNodePairingSummary,
+    });
+}
+export async function approveOpenClawPendingNode(input, options = {}) {
+    const nodeId = input.nodeId?.trim();
+    const code = input.code?.trim();
+    if (!nodeId && !code)
+        throw new Error('nodeId or code is required to approve an OpenClaw node');
+    return await callOpenClawGatewayWebSocket({
+        method: 'nodes.approve',
+        params: {
+            ...(nodeId ? { nodeId } : {}),
+            ...(code ? { code } : {}),
+        },
+        approvedBy: input.approvedBy,
+        liveCallConfirmed: input.liveCallConfirmed,
+        dryRun: input.dryRun,
+        timeoutMs: input.timeoutMs,
+    }, {
+        ...options,
+        summarizePayload: safeNodeApprovalSummary,
+    });
+}
+export async function rejectOpenClawPendingNode(input, options = {}) {
+    const nodeId = input.nodeId?.trim();
+    const code = input.code?.trim();
+    const reason = input.reason?.trim();
+    if (!nodeId && !code)
+        throw new Error('nodeId or code is required to reject an OpenClaw node');
+    return await callOpenClawGatewayWebSocket({
+        method: 'nodes.reject',
+        params: {
+            ...(nodeId ? { nodeId } : {}),
+            ...(code ? { code } : {}),
+            ...(reason ? { reason } : {}),
+        },
+        approvedBy: input.approvedBy,
+        liveCallConfirmed: input.liveCallConfirmed,
+        dryRun: input.dryRun,
+        timeoutMs: input.timeoutMs,
+    }, {
+        ...options,
+        summarizePayload: safeNodeRejectionSummary,
+    });
+}
+export async function validateOpenClawUpstreamCompatibility(input = {}, options = {}) {
+    const cwd = resolveCwd(options.cwd);
+    const now = options.now || new Date();
+    const discovery = await discoverOpenClawGateway({ ...options, cwd, now });
+    const nodeLockfilePath = getOpenClawNodeLockfilePath(options);
+    const openclawBinaryPath = await findOpenClawBinary(input.openclawBinaryPath);
+    const dryRun = input.dryRun !== false;
+    const shouldRunCliStatus = input.runCliStatus !== false;
+    const approvedBy = input.approvedBy?.trim();
+    const checks = [
+        {
+            name: 'openclaw-cli',
+            ok: Boolean(openclawBinaryPath),
+            status: openclawBinaryPath ? 'passed' : 'preview',
+            detail: openclawBinaryPath || 'OpenClaw CLI binary was not found on PATH; gateway validation can still run against an existing daemon',
+        },
+        {
+            name: 'gateway-lockfile',
+            ok: discovery.found,
+            status: discovery.found ? 'passed' : 'blocked',
+            detail: discovery.found ? discovery.lockfilePath : 'OpenClaw gateway lockfile was not found',
+        },
+        {
+            name: 'websocket-endpoint',
+            ok: Boolean(discovery.daemon.wsUrl),
+            status: discovery.daemon.wsUrl ? 'passed' : 'blocked',
+            detail: discovery.daemon.wsUrl || 'OpenClaw gateway WebSocket endpoint is missing',
+        },
+        {
+            name: 'node-lockfile',
+            ok: discovery.nodeHost.found,
+            status: discovery.nodeHost.found ? 'passed' : 'preview',
+            detail: discovery.nodeHost.found
+                ? nodeLockfilePath
+                : 'node.json was not found; validation can still test the gateway',
+        },
+        {
+            name: 'secret-redaction',
+            ok: discovery.safety.secretsIncluded === false,
+            status: discovery.safety.secretsIncluded === false ? 'passed' : 'failed',
+            detail: 'Discovery result must not include raw gateway or node tokens',
+        },
+    ];
+    const blockedReason = !discovery.found
+        ? 'OpenClaw gateway lockfile was not found'
+        : !discovery.daemon.wsUrl
+            ? 'OpenClaw gateway WebSocket endpoint is missing'
+            : !dryRun && !approvedBy
+                ? 'approvedBy is required for live OpenClaw upstream validation'
+                : !dryRun && input.liveValidationConfirmed !== true
+                    ? 'liveValidationConfirmed is required for live OpenClaw upstream validation'
+                    : undefined;
+    if (blockedReason) {
+        return {
+            kind: 'openclaw_upstream_validation_result',
+            ok: false,
+            status: 'blocked',
+            dryRun,
+            ...(approvedBy ? { approvedBy } : {}),
+            discovery,
+            checks: [
+                ...checks,
+                {
+                    name: 'live-approval',
+                    ok: false,
+                    status: 'blocked',
+                    detail: blockedReason,
+                },
+            ],
+            safety: {
+                readOnly: true,
+                secretsIncluded: false,
+                rawPayloadsStored: false,
+                networkContacted: false,
+                requiresLocalApproval: true,
+            },
+            error: blockedReason,
+        };
+    }
+    if (dryRun) {
+        return {
+            kind: 'openclaw_upstream_validation_result',
+            ok: true,
+            status: 'preview',
+            dryRun: true,
+            ...(approvedBy ? { approvedBy } : {}),
+            discovery,
+            checks: [
+                ...checks,
+                {
+                    name: 'openclaw-cli-status',
+                    ok: true,
+                    status: openclawBinaryPath && shouldRunCliStatus ? 'preview' : 'skipped',
+                    detail: openclawBinaryPath && shouldRunCliStatus
+                        ? 'Would run openclaw gateway status --json and store only an allowlisted summary'
+                        : 'Skipped because no OpenClaw CLI binary was found or runCliStatus=false',
+                },
+                {
+                    name: 'websocket-probe',
+                    ok: true,
+                    status: 'preview',
+                    detail: 'Would run connect -> hello-ok -> req(status) -> res',
+                },
+                {
+                    name: 'pending-node-list',
+                    ok: true,
+                    status: input.includePendingNodes === false ? 'skipped' : 'preview',
+                    detail: input.includePendingNodes === false
+                        ? 'Skipped by includePendingNodes=false'
+                        : 'Would run nodes.pending and store only a safe summary',
+                },
+            ],
+            safety: {
+                readOnly: true,
+                secretsIncluded: false,
+                rawPayloadsStored: false,
+                networkContacted: false,
+                requiresLocalApproval: true,
+            },
+        };
+    }
+    const cliStatus = openclawBinaryPath && shouldRunCliStatus
+        ? await runOpenClawCliGatewayStatus(openclawBinaryPath, input.timeoutMs ?? 5_000)
+        : undefined;
+    const probe = await probeOpenClawGatewayWebSocket({
+        approvedBy,
+        dryRun: false,
+        liveProbeConfirmed: true,
+        statusMethod: input.statusMethod,
+        timeoutMs: input.timeoutMs,
+    }, options);
+    const pendingNodes = input.includePendingNodes === false
+        ? undefined
+        : await listOpenClawPendingNodes({
+            approvedBy,
+            dryRun: false,
+            liveCallConfirmed: true,
+            timeoutMs: input.timeoutMs,
+        }, options);
+    const liveChecks = [
+        {
+            name: 'openclaw-cli-status',
+            ok: cliStatus ? cliStatus.exitCode === 0 : true,
+            status: cliStatus ? (cliStatus.exitCode === 0 ? 'passed' : 'failed') : 'skipped',
+            detail: cliStatus
+                ? cliStatus.status || (cliStatus.jsonParsed ? 'OpenClaw CLI status returned JSON' : cliStatus.error)
+                : 'Skipped because no OpenClaw CLI binary was found or runCliStatus=false',
+        },
+        {
+            name: 'websocket-probe',
+            ok: probe.ok,
+            status: probe.ok ? 'passed' : 'failed',
+            detail: probe.record.response?.error || probe.record.response?.gatewayId || probe.error,
+        },
+        {
+            name: 'pending-node-list',
+            ok: pendingNodes ? pendingNodes.ok : true,
+            status: pendingNodes ? (pendingNodes.ok ? 'passed' : 'failed') : 'skipped',
+            detail: pendingNodes
+                ? pendingNodes.record.response?.error || 'nodes.pending returned a redacted summary'
+                : 'Skipped by includePendingNodes=false',
+        },
+    ];
+    const ok = (cliStatus ? cliStatus.exitCode === 0 : true) && probe.ok && (pendingNodes ? pendingNodes.ok : true);
+    return {
+        kind: 'openclaw_upstream_validation_result',
+        ok,
+        status: ok ? 'validated' : 'failed',
+        dryRun: false,
+        ...(approvedBy ? { approvedBy } : {}),
+        discovery,
+        checks: [...checks, ...liveChecks],
+        ...(cliStatus ? { cliStatus } : {}),
+        probe,
+        ...(pendingNodes ? { pendingNodes } : {}),
+        safety: {
+            readOnly: true,
+            secretsIncluded: false,
+            rawPayloadsStored: false,
+            networkContacted: true,
+            requiresLocalApproval: true,
+        },
+        ...(ok ? {} : { error: 'OpenClaw upstream validation failed' }),
+    };
+}
+export function mapOpenClawChannelToCodeBuddy(value) {
+    const normalized = value.trim().toLowerCase();
+    const aliases = {
+        telegram: 'telegram',
+        discord: 'discord',
+        slack: 'slack',
+        whatsapp: 'whatsapp',
+        signal: 'signal',
+        matrix: 'matrix',
+        teams: 'teams',
+        gmail: 'gmail',
+        email: 'gmail',
+        imessage: 'imessage',
+        web: 'web',
+        webchat: 'webchat',
+    };
+    return aliases[normalized] || 'webchat';
+}
+//# sourceMappingURL=gateway-bridge.js.map