@rethinkingstudio/clawpilot 2.1.6 → 2.1.7-beta.0

package/dist/relay/ccconnect-relay-manager.js

@@ -0,0 +1,1105 @@
+import { randomUUID } from "crypto";
+import { WebSocket } from "ws";
+import { getServicePlatform } from "../platform/service-manager.js";
+import { CCConnectManagementClient, decodeCCConnectSessionKey, encodeCCConnectSessionKey, timestampMs, } from "../ccconnect/api-client.js";
+import { createCCConnectProject, discoverCCConnectProjects, restartCCConnect } from "../ccconnect/project-config.js";
+import { uploadMediaBlocks } from "../media/assistant-attachments.js";
+import { installRelayWatchdog } from "./relay-watchdog.js";
+import { dispatchCommonRelayCommand } from "./relay-command-dispatcher.js";
+import { relayMethodSupport } from "./relay-method-registry.js";
+const DEFAULT_CONTEXT_TOKENS = 200_000;
+export async function runCCConnectRelayManager(opts) {
+    const wsUrl = buildRelayUrl(opts.relayServerUrl, opts.gatewayId, opts.relaySecret);
+    const client = new CCConnectManagementClient({
+        managementUrl: opts.managementUrl,
+        managementToken: opts.managementToken,
+    });
+    return new Promise((resolve) => {
+        let relayWs;
+        let bridgeWs = null;
+        let bridgeReady = false;
+        let bridgeReconnectTimer = null;
+        let bridgePingTimer = null;
+        let bridgeReconnectAttempts = 0;
+        const rawToEncoded = new Map();
+        const rawToProject = new Map();
+        const activeRunByEncoded = new Map();
+        const previewHandleToRun = new Map();
+        const pendingInteractiveReplyByEncoded = new Set();
+        try {
+            relayWs = new WebSocket(wsUrl);
+        }
+        catch (err) {
+            console.error("Failed to create cc-connect relay WebSocket:", err);
+            resolve(true);
+            return;
+        }
+        const uninstallWatchdog = installRelayWatchdog(relayWs, `ccconnect:${opts.gatewayId}`);
+        function send(msg) {
+            if (relayWs.readyState === WebSocket.OPEN) {
+                relayWs.send(JSON.stringify(msg));
+            }
+        }
+        function sendResponse(id, payload) {
+            if (id)
+                send({ type: "res", id, ok: true, payload });
+        }
+        function sendError(id, error) {
+            if (id) {
+                send({
+                    type: "res",
+                    id,
+                    ok: false,
+                    error: { message: error instanceof Error ? error.message : String(error) },
+                });
+            }
+        }
+        function bridgeUrlWithToken() {
+            if (!opts.bridgeToken)
+                return opts.bridgeUrl;
+            const sep = opts.bridgeUrl.includes("?") ? "&" : "?";
+            return `${opts.bridgeUrl}${sep}token=${encodeURIComponent(opts.bridgeToken)}`;
+        }
+        function clearBridgeTimers() {
+            if (bridgeReconnectTimer) {
+                clearTimeout(bridgeReconnectTimer);
+                bridgeReconnectTimer = null;
+            }
+            if (bridgePingTimer) {
+                clearInterval(bridgePingTimer);
+                bridgePingTimer = null;
+            }
+        }
+        function startBridgePing() {
+            if (bridgePingTimer)
+                clearInterval(bridgePingTimer);
+            bridgePingTimer = setInterval(() => {
+                if (bridgeWs?.readyState === WebSocket.OPEN) {
+                    bridgeWs.send(JSON.stringify({ type: "ping", ts: Date.now() }));
+                }
+            }, 30_000);
+            bridgePingTimer.unref();
+        }
+        function scheduleBridgeReconnect(reason) {
+            if (relayWs.readyState !== WebSocket.OPEN || bridgeReconnectTimer)
+                return;
+            const delay = Math.min(30_000, 1_000 * 2 ** Math.min(bridgeReconnectAttempts, 5));
+            bridgeReconnectAttempts += 1;
+            console.log(`[runtime:ccconnect] bridge reconnect in ${delay}ms: ${reason}`);
+            bridgeReconnectTimer = setTimeout(() => {
+                bridgeReconnectTimer = null;
+                connectBridge();
+            }, delay);
+            bridgeReconnectTimer.unref();
+        }
+        function connectBridge() {
+            clearBridgeTimers();
+            bridgeReady = false;
+            if (bridgeWs && bridgeWs.readyState !== WebSocket.CLOSED) {
+                bridgeWs.close();
+            }
+            try {
+                bridgeWs = new WebSocket(bridgeUrlWithToken());
+            }
+            catch (error) {
+                const detail = error instanceof Error ? error.message : String(error);
+                console.error(`[runtime:ccconnect] bridge create failed: ${detail}`);
+                send({ type: "gateway_disconnected", reason: detail });
+                scheduleBridgeReconnect(detail);
+                return;
+            }
+            const ws = bridgeWs;
+            ws.on("open", () => {
+                ws.send(JSON.stringify({
+                    type: "register",
+                    platform: "pocketclaw",
+                    capabilities: [
+                        "text",
+                        "typing",
+                        "preview",
+                        "update_message",
+                        "delete_message",
+                        "reconstruct_reply",
+                        "buttons",
+                        "card",
+                        "image",
+                        "file",
+                        "audio",
+                    ],
+                    metadata: {
+                        version: "1.0.0",
+                        description: "PocketClaw relay adapter",
+                        progress_style: "card",
+                        supports_progress_card_payload: true,
+                    },
+                }));
+            });
+            ws.on("message", (raw) => {
+                if (bridgeWs !== ws)
+                    return;
+                try {
+                    handleBridgeMessage(JSON.parse(raw.toString()));
+                }
+                catch (error) {
+                    console.warn(`[runtime:ccconnect] ignored invalid bridge message: ${String(error)}`);
+                }
+            });
+            ws.on("close", (code, reason) => {
+                if (bridgeWs !== ws)
+                    return;
+                bridgeReady = false;
+                if (bridgePingTimer) {
+                    clearInterval(bridgePingTimer);
+                    bridgePingTimer = null;
+                }
+                console.log(`[runtime:ccconnect] bridge disconnected: ${code} ${reason.toString()}`);
+                send({ type: "gateway_disconnected", reason: "cc-connect bridge disconnected" });
+                scheduleBridgeReconnect(`close ${code}`);
+            });
+            ws.on("error", (error) => {
+                if (bridgeWs !== ws)
+                    return;
+                bridgeReady = false;
+                console.error(`[runtime:ccconnect] bridge error: ${error.message}`);
+                send({ type: "gateway_disconnected", reason: error.message });
+                scheduleBridgeReconnect(error.message);
+            });
+        }
+        function handleBridgeMessage(msg) {
+            void handleBridgeMessageAsync(msg);
+        }
+        async function handleBridgeMessageAsync(msg) {
+            const record = msg;
+            if (msg.type === "register_ack") {
+                bridgeReady = Boolean(msg.ok);
+                if (bridgeReady) {
+                    bridgeReconnectAttempts = 0;
+                    console.log("[runtime:ccconnect] bridge connected");
+                    startBridgePing();
+                    send({ type: "gateway_connected" });
+                }
+                else {
+                    send({ type: "gateway_disconnected", reason: stringValue(record.error) ?? "cc-connect bridge registration failed" });
+                    scheduleBridgeReconnect(stringValue(record.error) ?? "registration failed");
+                }
+                return;
+            }
+            if (msg.type === "pong")
+                return;
+            const rawSessionKey = stringValue(record.session_key) ?? "";
+            const encodedSessionKey = await resolveEncodedBridgeSession(record);
+            if (!encodedSessionKey)
+                return;
+            const previewHandle = stringValue(record.preview_handle);
+            const runInfo = resolveRunForBridgeMessage(encodedSessionKey, previewHandle);
+            let runId = runInfo.runId;
+            if (msg.type === "typing_start") {
+                emitChat(runId, encodedSessionKey, "delta", undefined, true);
+                return;
+            }
+            if (msg.type === "typing_stop") {
+                return;
+            }
+            if (msg.type === "preview_start") {
+                const content = stringValue(record.content) ?? "";
+                const sideChannel = isProgressContent(content);
+                if (sideChannel) {
+                    runId = randomUUID();
+                }
+                emitContentChat(runId, encodedSessionKey, "delta", normalizeBridgeContent(content), false, sideChannel);
+                const refId = stringValue(record.ref_id);
+                const handle = `pocketclaw-${runId}`;
+                previewHandleToRun.set(handle, { encodedSessionKey, runId, sideChannel });
+                if (refId) {
+                    bridgeWs?.send(JSON.stringify({
+                        type: "preview_ack",
+                        ref_id: refId,
+                        preview_handle: handle,
+                    }));
+                }
+                return;
+            }
+            if (msg.type === "update_message") {
+                const content = stringValue(record.content) ?? "";
+                const normalized = normalizeBridgeContent(content);
+                const state = runInfo.sideChannel && progressContentIsCompleted(content) ? "final" : "delta";
+                emitContentChat(runId, encodedSessionKey, state, normalized, false, runInfo.sideChannel);
+                if (state === "final" && previewHandle)
+                    previewHandleToRun.delete(previewHandle);
+                return;
+            }
+            if (msg.type === "delete_message") {
+                if (previewHandle)
+                    previewHandleToRun.delete(previewHandle);
+                send({
+                    type: "event",
+                    event: "message.delete",
+                    payload: {
+                        runId,
+                        sessionKey: encodedSessionKey,
+                        previewHandle,
+                        keepTurn: true,
+                        sideChannel: runInfo.sideChannel,
+                    },
+                });
+                return;
+            }
+            if (msg.type === "reply_stream") {
+                const text = stringValue(record.full_text) ?? stringValue(record.delta) ?? "";
+                const done = Boolean(record.done);
+                const hasProgressPreview = hasActiveSideChannelPreview(encodedSessionKey);
+                const state = done && !isIntermediateReply(text) && !hasProgressPreview ? "final" : "delta";
+                emitChat(runId, encodedSessionKey, state, text, false);
+                if (state === "final")
+                    clearActiveBridgeRun(encodedSessionKey, runId);
+                return;
+            }
+            if (msg.type === "reply") {
+                const content = stringValue(record.content) ?? "";
+                const permissionFallback = permissionHintActions(content, rawSessionKey, stringValue(record.reply_ctx) ?? rawSessionKey);
+                const keepTurnOpen = consumeInteractiveReply(encodedSessionKey) ||
+                    isIntermediateReply(content) ||
+                    hasActiveSideChannelPreview(encodedSessionKey);
+                const state = keepTurnOpen ? "delta" : "final";
+                if (permissionFallback) {
+                    emitStructuredChat(runId, encodedSessionKey, state, {
+                        text: content,
+                        blocks: [textBlock(content), permissionFallback].filter(Boolean),
+                    });
+                }
+                else {
+                    emitChat(runId, encodedSessionKey, state, content, false);
+                }
+                if (state === "final")
+                    clearActiveBridgeRun(encodedSessionKey, runId);
+                return;
+            }
+            if (msg.type === "buttons") {
+                const actions = normalizeBridgeButtons(record.buttons);
+                console.log(`[runtime:ccconnect] bridge buttons session=${rawSessionKey} actions=${actions.length}`);
+                emitStructuredChat(runId, encodedSessionKey, "delta", {
+                    text: stringValue(record.content) ?? "",
+                    blocks: [
+                        textBlock(stringValue(record.content) ?? ""),
+                        actionsBlock(actions, rawSessionKey, stringValue(record.reply_ctx) ?? rawSessionKey),
+                    ].filter(Boolean),
+                });
+                return;
+            }
+            if (msg.type === "card") {
+                console.log(`[runtime:ccconnect] bridge card session=${rawSessionKey}`);
+                emitStructuredChat(runId, encodedSessionKey, "delta", normalizeBridgeCard(record.card, rawSessionKey, stringValue(record.reply_ctx) ?? rawSessionKey));
+                return;
+            }
+            if (msg.type === "image" || msg.type === "file" || msg.type === "audio") {
+                const attachment = await uploadBridgeMedia(msg);
+                emitStructuredChat(runId, encodedSessionKey, "final", {
+                    text: attachment.text,
+                    attachments: attachment.attachments,
+                    blocks: attachment.text ? [textBlock(attachment.text)] : [],
+                });
+                clearActiveBridgeRun(encodedSessionKey, runId);
+                return;
+            }
+            if (msg.type === "error") {
+                emitChat(runId, encodedSessionKey, "error", stringValue(record.message) ?? "cc-connect bridge error", false);
+                clearActiveBridgeRun(encodedSessionKey, runId);
+            }
+        }
+        async function resolveEncodedBridgeSession(record) {
+            const rawSessionKey = stringValue(record.session_key);
+            if (!rawSessionKey) {
+                if (activeRunByEncoded.size === 1) {
+                    return activeRunByEncoded.keys().next().value;
+                }
+                console.warn(`[runtime:ccconnect] dropped bridge ${String(record.type)} without session_key`);
+                return undefined;
+            }
+            const existing = rawToEncoded.get(rawSessionKey);
+            if (existing)
+                return existing;
+            const explicitProject = stringValue(record.project) ?? rawToProject.get(rawSessionKey);
+            if (explicitProject) {
+                const encoded = encodeCCConnectSessionKey(explicitProject, rawSessionKey, rawSessionKey);
+                rawToEncoded.set(rawSessionKey, encoded);
+                rawToProject.set(rawSessionKey, explicitProject);
+                console.warn(`[runtime:ccconnect] recovered bridge session mapping project=${explicitProject} rawSessionKey=${rawSessionKey}`);
+                return encoded;
+            }
+            if (activeRunByEncoded.size === 1) {
+                const encoded = activeRunByEncoded.keys().next().value;
+                if (encoded) {
+                    rawToEncoded.set(rawSessionKey, encoded);
+                    console.warn(`[runtime:ccconnect] inferred bridge session mapping rawSessionKey=${rawSessionKey}`);
+                    return encoded;
+                }
+            }
+            console.warn(`[runtime:ccconnect] dropped bridge ${String(record.type)} for unmapped session_key=${rawSessionKey}`);
+            return undefined;
+        }
+        function ensureRunId(encodedSessionKey, preferred) {
+            const existing = activeRunByEncoded.get(encodedSessionKey);
+            if (existing)
+                return existing;
+            const runId = preferred || randomUUID();
+            activeRunByEncoded.set(encodedSessionKey, runId);
+            return runId;
+        }
+        function resolveRunForBridgeMessage(encodedSessionKey, previewHandle) {
+            if (previewHandle) {
+                const preview = previewHandleToRun.get(previewHandle);
+                if (preview) {
+                    return { runId: preview.runId, sideChannel: preview.sideChannel };
+                }
+            }
+            return { runId: ensureRunId(encodedSessionKey) };
+        }
+        function clearActiveBridgeRun(encodedSessionKey, runId) {
+            if (activeRunByEncoded.get(encodedSessionKey) === runId) {
+                activeRunByEncoded.delete(encodedSessionKey);
+            }
+            pendingInteractiveReplyByEncoded.delete(encodedSessionKey);
+            for (const [handle, preview] of previewHandleToRun) {
+                if (preview.runId === runId)
+                    previewHandleToRun.delete(handle);
+            }
+        }
+        function hasActiveSideChannelPreview(encodedSessionKey) {
+            for (const preview of previewHandleToRun.values()) {
+                if (preview.encodedSessionKey === encodedSessionKey && preview.sideChannel) {
+                    return true;
+                }
+            }
+            return false;
+        }
+        function consumeInteractiveReply(encodedSessionKey) {
+            if (!pendingInteractiveReplyByEncoded.has(encodedSessionKey))
+                return false;
+            pendingInteractiveReplyByEncoded.delete(encodedSessionKey);
+            return true;
+        }
+        function emitChat(runId, sessionKey, state, text, loading) {
+            const payload = { runId, sessionKey, state };
+            if (loading)
+                payload.loading = true;
+            if (text !== undefined) {
+                payload.message = { content: [{ type: "text", text }] };
+            }
+            if (state === "error")
+                payload.errorMessage = text ?? "cc-connect error";
+            send({ type: "event", event: "chat", payload });
+        }
+        function emitContentChat(runId, sessionKey, state, content, loading, sideChannel) {
+            const payload = { runId, sessionKey, state };
+            if (loading)
+                payload.loading = true;
+            if (sideChannel)
+                payload.sideChannel = true;
+            payload.message = { content: content.blocks?.length ? content.blocks : [{ type: "text", text: content.text }] };
+            if (state === "error")
+                payload.errorMessage = content.text || "cc-connect error";
+            send({ type: "event", event: "chat", payload });
+        }
+        function emitStructuredChat(runId, sessionKey, state, data) {
+            const blocks = data.blocks?.length ? data.blocks : data.text !== undefined ? [textBlock(data.text)] : undefined;
+            const payload = { runId, sessionKey, state };
+            if (blocks)
+                payload.message = { content: blocks };
+            if (data.attachments)
+                payload.attachments = data.attachments;
+            if (state === "error")
+                payload.errorMessage = data.text ?? "cc-connect error";
+            send({ type: "event", event: "chat", payload });
+        }
+        async function uploadBridgeMedia(msg) {
+            const data = stringValue(msg.data);
+            const fileName = stringValue(msg.file_name);
+            const mimeType = bridgeMediaMimeType(msg);
+            const label = fileName || (msg.type === "audio" ? "Audio message" : msg.type === "image" ? "Image" : "File");
+            if (!data) {
+                return { text: `[${label} missing data]`, attachments: [] };
+            }
+            const block = {
+                mimeType,
+                fileName,
+                data: Buffer.from(data.replace(/^data:[^;]+;base64,/, ""), "base64"),
+            };
+            const uploaded = await uploadMediaBlocks([block], opts.relayServerUrl, opts.gatewayId, opts.relaySecret);
+            const attachments = uploaded.map((att) => ({
+                ...att,
+                fileName: fileName ?? undefined,
+            }));
+            return { text: label, attachments };
+        }
+        async function respondSessionsList(requestId) {
+            const projects = await client.listProjects();
+            const sessions = [];
+            for (const project of projects) {
+                const projectSessions = await client.listSessions(project.name);
+                for (const session of projectSessions) {
+                    const encoded = rememberSession(project.name, session);
+                    sessions.push(toRuntimeSession(project.name, session, encoded));
+                }
+            }
+            sendResponse(requestId, {
+                defaults: { contextTokens: DEFAULT_CONTEXT_TOKENS, model: "cc-connect", modelProvider: "cc-connect" },
+                sessions,
+                count: sessions.length,
+            });
+        }
+        async function respondProjectsList(requestId) {
+            const projects = await client.listProjects();
+            const detailed = await Promise.all(projects.map(async (project) => {
+                try {
+                    const detail = await client.getProject(project.name);
+                    return {
+                        name: detail.name,
+                        agentType: detail.agent_type,
+                        workDir: detail.work_dir,
+                        mode: detail.agent_mode || detail.mode,
+                        sessionsCount: detail.sessions_count ?? project.sessions_count ?? 0,
+                        platforms: detail.platforms ?? project.platforms ?? [],
+                        heartbeatEnabled: detail.heartbeat_enabled ?? project.heartbeat_enabled ?? false,
+                        activeSessionKeys: detail.active_session_keys ?? [],
+                    };
+                }
+                catch {
+                    return {
+                        name: project.name,
+                        agentType: project.agent_type,
+                        sessionsCount: project.sessions_count ?? 0,
+                        platforms: project.platforms ?? [],
+                        heartbeatEnabled: project.heartbeat_enabled ?? false,
+                        activeSessionKeys: [],
+                    };
+                }
+            }));
+            sendResponse(requestId, { projects: detailed, count: detailed.length });
+        }
+        async function respondProjectsDiscover(requestId) {
+            const projects = await client.listProjects();
+            const detailed = await Promise.all(projects.map(async (project) => {
+                try {
+                    const detail = await client.getProject(project.name);
+                    return { name: detail.name, workDir: detail.work_dir };
+                }
+                catch {
+                    return { name: project.name, workDir: undefined };
+                }
+            }));
+            const directories = discoverCCConnectProjects(detailed);
+            sendResponse(requestId, { directories, count: directories.length });
+        }
+        async function respondProjectCreate(requestId, params) {
+            const p = params;
+            const created = createCCConnectProject(p);
+            restartCCConnect(created.configPath);
+            sendResponse(requestId, {
+                project: {
+                    name: created.name,
+                    agentType: created.agentType,
+                    workDir: created.workDir,
+                    mode: created.mode,
+                    sessionsCount: 0,
+                    platforms: ["line", "bridge"],
+                    heartbeatEnabled: false,
+                    activeSessionKeys: [],
+                },
+                restarted: true,
+            });
+        }
+        async function respondMessagesHistory(requestId, params) {
+            const p = params;
+            if (!p.sessionKey)
+                throw new Error("sessionKey required");
+            const decoded = decodeCCConnectSessionKey(p.sessionKey);
+            const sessionId = await resolveCCConnectSessionId(decoded.project, decoded.sessionKey, decoded.sessionId);
+            const detail = await client.getSession(decoded.project, sessionId, Math.min(p.limit ?? 50, 200));
+            const history = detail.history ?? [];
+            const messages = history.map((entry, index) => ({
+                id: index + 1,
+                role: entry.role === "user" ? "user" : "assistant",
+                content: entry.content ?? "",
+                runId: entry.role === "user" ? undefined : `${sessionId}-${index + 1}`,
+                state: "final",
+                createdAt: timestampMs(entry.timestamp),
+                updatedAt: timestampMs(entry.timestamp),
+            }));
+            sendResponse(requestId, { messages, hasMore: false });
+        }
+        async function respondSessionCreate(requestId, params) {
+            const p = params;
+            const projects = await client.listProjects();
+            const project = p.project?.trim() || projects[0]?.name;
+            if (!project)
+                throw new Error("cc-connect has no configured projects");
+            const title = p.title?.trim() || "New Session";
+            const rawSessionKey = `pocketclaw:${opts.gatewayId}:default`;
+            const created = await client.createSession(project, rawSessionKey, title);
+            const session = {
+                ...created,
+                id: created.id || rawSessionKey,
+                session_key: created.session_key || rawSessionKey,
+                name: created.name || title,
+                platform: created.platform || "pocketclaw",
+                live: created.live ?? false,
+            };
+            const encoded = rememberSession(project, session);
+            sendResponse(requestId, { session: toRuntimeSession(project, session, encoded) });
+        }
+        async function handleChatSend(params) {
+            const p = params;
+            if (!p.sessionKey)
+                throw new Error("sessionKey required");
+            if (!p.message)
+                throw new Error("message required");
+            const decoded = await resolveCCConnectSendTarget(p.sessionKey);
+            rawToEncoded.set(decoded.sessionKey, p.sessionKey);
+            rawToProject.set(decoded.sessionKey, decoded.project);
+            activeRunByEncoded.delete(p.sessionKey);
+            pendingInteractiveReplyByEncoded.delete(p.sessionKey);
+            const runId = ensureRunId(p.sessionKey, p.idempotencyKey);
+            emitChat(runId, p.sessionKey, "delta", undefined, true);
+            if (bridgeReady && bridgeWs?.readyState === WebSocket.OPEN) {
+                console.log(`[runtime:ccconnect] chat.send via bridge project=${decoded.project} rawSessionKey=${decoded.sessionKey}`);
+                bridgeWs.send(JSON.stringify({
+                    type: "message",
+                    msg_id: `pocketclaw-${Date.now()}`,
+                    session_key: decoded.sessionKey,
+                    user_id: "pocketclaw",
+                    user_name: "PocketClaw",
+                    content: p.message,
+                    reply_ctx: decoded.sessionKey,
+                    project: decoded.project,
+                    ...bridgeAttachments(params),
+                }));
+                return;
+            }
+            scheduleBridgeReconnect("bridge not ready during chat.send");
+            console.log(`[runtime:ccconnect] chat.send via management fallback project=${decoded.project} rawSessionKey=${decoded.sessionKey}`);
+            await client.send(decoded.project, decoded.sessionKey, p.message);
+        }
+        async function handleChatAction(params) {
+            const p = params;
+            if (!p.sessionKey)
+                throw new Error("sessionKey required");
+            if (!p.action)
+                throw new Error("action required");
+            if (!bridgeReady || bridgeWs?.readyState !== WebSocket.OPEN) {
+                throw new Error("cc-connect bridge not ready");
+            }
+            const decoded = await resolveCCConnectSendTarget(p.sessionKey);
+            if (isInteractiveAction(p.action)) {
+                pendingInteractiveReplyByEncoded.add(p.sessionKey);
+            }
+            bridgeWs.send(JSON.stringify({
+                type: "card_action",
+                session_key: decoded.sessionKey,
+                action: p.action,
+                reply_ctx: p.replyCtx || decoded.sessionKey,
+                project: decoded.project,
+            }));
+        }
+        async function resolveCCConnectSendTarget(sessionKey) {
+            try {
+                return decodeCCConnectSessionKey(sessionKey);
+            }
+            catch {
+                const projects = await client.listProjects();
+                for (const project of projects) {
+                    const sessions = await client.listSessions(project.name);
+                    const preferred = sessions.find((session) => session.active || session.live) ?? sessions[0];
+                    if (preferred?.session_key) {
+                        console.warn(`[runtime:ccconnect] non-ccconnect sessionKey received (${sessionKey}); using ${project.name}/${preferred.session_key}`);
+                        return {
+                            project: project.name,
+                            sessionKey: preferred.session_key,
+                            sessionId: preferred.id || preferred.session_key,
+                        };
+                    }
+                }
+                throw new Error(`invalid cc-connect session key: ${sessionKey}`);
+            }
+        }
+        function rememberSession(project, session) {
+            const encoded = encodeCCConnectSessionKey(project, session.session_key, session.session_key);
+            if (!rawToEncoded.has(session.session_key)) {
+                rawToEncoded.set(session.session_key, encoded);
+                rawToProject.set(session.session_key, project);
+            }
+            return encoded;
+        }
+        async function resolveCCConnectSessionId(project, sessionKey, sessionId) {
+            if (sessionId && sessionId !== sessionKey)
+                return sessionId;
+            const sessions = await client.listSessions(project);
+            const matched = sessions.find((session) => session.session_key === sessionKey);
+            return matched?.id || sessionId || sessionKey;
+        }
+        function toRuntimeSession(project, session, encoded) {
+            const platform = session.platform || session.session_key.split(":")[0] || "cc-connect";
+            const title = session.name || session.chat_name || session.user_name || session.session_key || session.id;
+            return {
+                key: encoded,
+                label: `${project} / ${platform} / ${title}`,
+                displayName: title,
+                agentId: project,
+                kind: platform,
+                state: session.live ? "running" : "idle",
+                model: session.agent_type || "cc-connect",
+                contextTokens: DEFAULT_CONTEXT_TOKENS,
+                totalTokens: 0,
+                inputTokens: 0,
+                outputTokens: 0,
+                updatedAt: timestampMs(session.updated_at),
+                runtimeType: "ccconnect",
+            };
+        }
+        relayWs.on("open", async () => {
+            console.log(`Connected to relay server (gatewayId=${opts.gatewayId})`);
+            send({ type: "relay_hello", platform: getServicePlatform() });
+            opts.onConnected?.();
+            try {
+                await client.status();
+                connectBridge();
+            }
+            catch (error) {
+                const reason = error instanceof Error ? error.message : String(error);
+                console.error(`[runtime:ccconnect] management API unavailable: ${reason}`);
+                send({ type: "gateway_disconnected", reason });
+            }
+        });
+        relayWs.on("message", async (raw) => {
+            let msg;
+            try {
+                msg = JSON.parse(raw.toString());
+            }
+            catch {
+                return;
+            }
+            if (msg.type !== "cmd" || !msg.method)
+                return;
+            const requestId = msg.id;
+            const support = relayMethodSupport(msg.method, "ccconnect") ?? "unsupported";
+            console.log(`[relay:ccconnect] cmd received method=${msg.method} support=${support} id=${requestId ?? "(no-id)"}`);
+            if (await dispatchCommonRelayCommand(msg.method, msg.params, requestId, send)) {
+                return;
+            }
+            try {
+                switch (msg.method) {
+                    case "projects.list":
+                        if (requestId)
+                            await respondProjectsList(requestId);
+                        return;
+                    case "projects.discover":
+                        if (requestId)
+                            await respondProjectsDiscover(requestId);
+                        return;
+                    case "projects.create":
+                        if (requestId)
+                            await respondProjectCreate(requestId, msg.params ?? {});
+                        return;
+                    case "sessions.list":
+                        if (requestId)
+                            await respondSessionsList(requestId);
+                        return;
+                    case "messages.history":
+                        if (requestId)
+                            await respondMessagesHistory(requestId, msg.params ?? {});
+                        return;
+                    case "sessions.create":
+                        if (requestId)
+                            await respondSessionCreate(requestId, msg.params ?? {});
+                        return;
+                    case "chat.send":
+                        await handleChatSend(msg.params ?? {});
+                        if (requestId)
+                            sendResponse(requestId, { ok: true });
+                        return;
+                    case "chat.action":
+                        await handleChatAction(msg.params ?? {});
+                        if (requestId)
+                            sendResponse(requestId, { ok: true });
+                        return;
+                    case "chat.abort":
+                        if (requestId)
+                            sendResponse(requestId, { ok: true });
+                        return;
+                    case "models.list":
+                        if (requestId)
+                            sendResponse(requestId, { models: [] });
+                        return;
+                    case "skills.status":
+                        if (requestId)
+                            sendResponse(requestId, { skills: [] });
+                        return;
+                    case "agents.list":
+                        if (requestId)
+                            sendResponse(requestId, { defaultId: "cc-connect", mainKey: "cc-connect", agents: [] });
+                        return;
+                    default:
+                        if (requestId)
+                            send({ type: "res", id: requestId, ok: false, error: { message: `unknown method ${msg.method}` } });
+                }
+            }
+            catch (error) {
+                sendError(requestId, error);
+            }
+        });
+        relayWs.on("close", (code, reason) => {
+            uninstallWatchdog();
+            console.log(`cc-connect relay connection closed: ${code} ${reason.toString()}`);
+            opts.onDisconnected?.();
+            clearBridgeTimers();
+            bridgeWs?.close();
+            bridgeWs = null;
+            resolve(code !== 4000);
+        });
+        relayWs.on("error", (err) => {
+            console.error("cc-connect relay WebSocket error:", err.message);
+        });
+    });
+}
+function buildRelayUrl(base, gatewayId, relaySecret) {
+    const normalized = base.replace(/^http/i, "ws").replace(/\/+$/, "");
+    return `${normalized}/relay/${gatewayId}?secret=${encodeURIComponent(relaySecret)}`;
+}
+function stringValue(value) {
+    return typeof value === "string" ? value : undefined;
+}
+function textBlock(text) {
+    return text ? { type: "text", text } : undefined;
+}
+const PROGRESS_CARD_PREFIX = "__cc_connect_progress_card_v1__:";
+function isProgressContent(content) {
+    return content.startsWith(PROGRESS_CARD_PREFIX) || content.trimStart().startsWith("⏳ **Progress**");
+}
+function progressContentIsCompleted(content) {
+    const payload = parseProgressPayload(content);
+    return payload?.state === "completed" || payload?.state === "failed";
+}
+function normalizeBridgeContent(content) {
+    const progress = parseProgressPayload(content);
+    if (!progress)
+        return { text: content };
+    const text = renderProgressPayload(progress);
+    return {
+        text,
+        blocks: [
+            {
+                type: "markdown",
+                text,
+            },
+        ],
+    };
+}
+function parseProgressPayload(content) {
+    if (!content.startsWith(PROGRESS_CARD_PREFIX))
+        return undefined;
+    try {
+        const parsed = JSON.parse(content.slice(PROGRESS_CARD_PREFIX.length));
+        const items = Array.isArray(parsed.items)
+            ? parsed.items.map((item) => ({
+                kind: stringValue(item.kind),
+                text: stringValue(item.text)?.trim() ?? "",
+                tool: stringValue(item.tool),
+                status: stringValue(item.status),
+            })).filter((item) => item.text)
+            : [];
+        const entries = items.length > 0
+            ? items
+            : (Array.isArray(parsed.entries) ? parsed.entries.map((entry) => ({
+                kind: undefined,
+                text: typeof entry === "string" ? entry.trim() : "",
+            })).filter((entry) => entry.text) : []);
+        if (entries.length === 0)
+            return undefined;
+        return {
+            state: stringValue(parsed.state),
+            truncated: Boolean(parsed.truncated),
+            entries,
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+function renderProgressPayload(payload) {
+    const icon = payload.state === "completed" ? "✅" : payload.state === "failed" ? "❌" : "⏳";
+    const lines = [`${icon} **Progress**`];
+    if (payload.truncated)
+        lines.push("_Showing latest updates only._");
+    for (const [index, entry] of payload.entries.entries()) {
+        const prefix = progressEntryPrefix(entry.kind, entry.tool);
+        const text = entry.text.replace(/\n/g, "\n   ");
+        lines.push(`\n${index + 1}. ${prefix}${text}`);
+    }
+    return lines.join("\n");
+}
+function progressEntryPrefix(kind, tool) {
+    if (kind === "thinking")
+        return "💭 ";
+    if (kind === "tool_use")
+        return tool ? `🔧 **工具: ${tool}**\n   ` : "🔧 ";
+    if (kind === "tool_result")
+        return tool ? `🧾 **结果: ${tool}**\n   ` : "🧾 ";
+    if (kind === "error")
+        return "❌ ";
+    return "";
+}
+function actionsBlock(buttons, sessionKey, replyCtx) {
+    if (buttons.length === 0)
+        return undefined;
+    return {
+        type: "actions",
+        actions: buttons,
+        sessionKey,
+        replyCtx,
+    };
+}
+function normalizeBridgeButtons(buttons) {
+    if (!Array.isArray(buttons))
+        return [];
+    const actions = [];
+    const rows = buttons.some(Array.isArray) ? buttons : [buttons];
+    for (const row of rows) {
+        const buttonRow = Array.isArray(row) ? row : [row];
+        for (const button of buttonRow) {
+            const action = normalizeBridgeAction(button);
+            if (action)
+                actions.push(action);
+        }
+    }
+    return actions;
+}
+function normalizeBridgeCard(card, sessionKey, replyCtx) {
+    if (!isRecord(card)) {
+        return { text: "[card message]", blocks: [textBlock("[card message]")].filter(Boolean) };
+    }
+    const blocks = [];
+    const textParts = [];
+    const header = isRecord(card.header) ? stringValue(card.header.title) : undefined;
+    if (header) {
+        blocks.push({ type: "text", text: `**${header}**` });
+        textParts.push(header);
+    }
+    const elements = Array.isArray(card.elements) ? card.elements : [];
+    for (const element of elements) {
+        if (!isRecord(element))
+            continue;
+        const type = stringValue(element.type);
+        if (type === "markdown") {
+            const text = stringValue(element.content) ?? "";
+            if (text) {
+                blocks.push({ type: "markdown", text });
+                textParts.push(text);
+            }
+            continue;
+        }
+        if (type === "note") {
+            const text = stringValue(element.text) ?? "";
+            if (text) {
+                blocks.push({ type: "text", text });
+                textParts.push(text);
+            }
+            continue;
+        }
+        if (type === "divider") {
+            blocks.push({ type: "divider" });
+            continue;
+        }
+        if (type === "actions") {
+            const actions = normalizeCardActionButtons(element.buttons);
+            const block = actionsBlock(actions, sessionKey, replyCtx);
+            if (block)
+                blocks.push(block);
+            continue;
+        }
+        if (type === "list_item") {
+            const text = stringValue(element.text) ?? "";
+            if (text)
+                textParts.push(text);
+            const btnText = stringValue(element.btn_text);
+            const btnValue = stringValue(element.btn_value);
+            blocks.push({
+                type: "list_item",
+                text,
+                action: btnText && btnValue ? {
+                    id: btnValue,
+                    label: btnText,
+                    value: btnValue,
+                    style: actionStyle(btnValue, stringValue(element.btn_type)),
+                } : undefined,
+                sessionKey,
+                replyCtx,
+            });
+            continue;
+        }
+        if (type === "select") {
+            const options = Array.isArray(element.options) ? element.options.filter(isRecord).map((option) => ({
+                id: stringValue(option.value) ?? "",
+                label: stringValue(option.text) ?? "",
+                value: stringValue(option.value) ?? "",
+                style: "default",
+            })).filter((option) => option.label && option.value) : [];
+            blocks.push({
+                type: "select",
+                placeholder: stringValue(element.placeholder) ?? "Select",
+                initValue: stringValue(element.init_value),
+                actions: options,
+                sessionKey,
+                replyCtx,
+            });
+        }
+    }
+    return { text: textParts.join("\n\n"), blocks };
+}
+function isInteractiveAction(action) {
+    const normalized = action.toLowerCase();
+    return (normalized.startsWith("perm:")
+        || normalized.startsWith("askq:")
+        || normalized === "allow"
+        || normalized === "deny"
+        || normalized === "allow all");
+}
+function normalizeCardActionButtons(buttons) {
+    if (!Array.isArray(buttons))
+        return [];
+    const actions = [];
+    for (const button of buttons) {
+        const action = normalizeBridgeAction(button);
+        if (action)
+            actions.push(action);
+    }
+    return actions;
+}
+function normalizeBridgeAction(button) {
+    if (!isRecord(button))
+        return undefined;
+    const label = stringValue(button.text)
+        ?? stringValue(button.label)
+        ?? stringValue(button.title);
+    const value = stringValue(button.data)
+        ?? stringValue(button.value)
+        ?? stringValue(button.id)
+        ?? inferActionValue(label);
+    if (!label || !value)
+        return undefined;
+    return {
+        id: value,
+        label,
+        value,
+        style: actionStyle(value, stringValue(button.btn_type) ?? stringValue(button.style)),
+    };
+}
+function permissionHintActions(content, sessionKey, replyCtx) {
+    if (!isPermissionHint(content))
+        return undefined;
+    return actionsBlock([
+        { id: "perm:allow", label: "允许", value: "perm:allow", style: "primary" },
+        { id: "perm:deny", label: "拒绝", value: "perm:deny", style: "danger" },
+        { id: "perm:allow_all", label: "允许所有", value: "perm:allow_all", style: "default" },
+    ], sessionKey, replyCtx);
+}
+function isPermissionHint(content) {
+    const normalized = content.toLowerCase();
+    return (normalized.includes("等待权限响应") || normalized.includes("permission"))
+        && (normalized.includes("允许所有") || normalized.includes("allow all"))
+        && (normalized.includes("拒绝") || normalized.includes("deny"));
+}
+function isIntermediateReply(content) {
+    const normalized = content.toLowerCase().trim();
+    if (!normalized)
+        return false;
+    if (isPermissionHint(content))
+        return true;
+    return (normalized.includes("继续执行")
+        || normalized.includes("继续处理中")
+        || normalized.includes("continuing")
+        || normalized.includes("continue execution")
+        || normalized.includes("permission granted")
+        || normalized.includes("已允许")
+        || normalized.includes("已开启自动批准")
+        || normalized.includes("自动批准")
+        || normalized.includes("权限请求将自动允许"));
+}
+function inferActionValue(label) {
+    if (!label)
+        return undefined;
+    const normalized = label.toLowerCase().replace(/\s+/g, "");
+    if (normalized.includes("允许所有") || normalized.includes("全部允许") || normalized.includes("allowall")) {
+        return "perm:allow_all";
+    }
+    if (normalized.includes("拒绝") || normalized.includes("deny") || normalized.includes("reject")) {
+        return "perm:deny";
+    }
+    if (normalized.includes("允许") || normalized.includes("同意") || normalized.includes("allow") || normalized.includes("approve")) {
+        return "perm:allow";
+    }
+    return undefined;
+}
+function actionStyle(value, explicit) {
+    if (explicit === "primary" || explicit === "danger")
+        return explicit;
+    if (value.includes("deny") || value.includes("reject") || value.includes("cancel"))
+        return "danger";
+    if (value.includes("allow"))
+        return "primary";
+    return "default";
+}
+function bridgeMediaMimeType(msg) {
+    const record = msg;
+    const explicit = stringValue(record.mime_type);
+    if (explicit)
+        return explicit;
+    if (msg.type === "audio") {
+        const format = stringValue(record.format) ?? "mpeg";
+        return format.includes("/") ? format : `audio/${format}`;
+    }
+    if (msg.type === "image")
+        return "image/png";
+    return "application/octet-stream";
+}
+function bridgeAttachments(params) {
+    const attachments = isRecord(params) && Array.isArray(params.attachments) ? params.attachments : [];
+    const images = [];
+    const files = [];
+    let audio;
+    for (const attachment of attachments) {
+        if (!isRecord(attachment))
+            continue;
+        const content = stringValue(attachment.content);
+        const mimeType = stringValue(attachment.mimeType) ?? "application/octet-stream";
+        const fileName = stringValue(attachment.fileName);
+        if (!content)
+            continue;
+        const payload = {
+            mime_type: mimeType,
+            data: content.replace(/^data:[^;]+;base64,/, ""),
+            file_name: fileName,
+        };
+        if (mimeType.startsWith("image/")) {
+            images.push(payload);
+        }
+        else if (mimeType.startsWith("audio/") && !audio) {
+            audio = {
+                mime_type: mimeType,
+                data: payload.data,
+                format: mimeType.replace(/^audio\//, ""),
+                file_name: fileName,
+            };
+        }
+        else {
+            files.push(payload);
+        }
+    }
+    return {
+        ...(images.length > 0 ? { images } : {}),
+        ...(files.length > 0 ? { files } : {}),
+        ...(audio ? { audio } : {}),
+    };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null;
+}
+//# sourceMappingURL=ccconnect-relay-manager.js.map