chatccc 0.2.252 → 0.2.253

package/dist/src/agent-stop-stuck.js

@@ -0,0 +1,110 @@
+import { readUtf8JsonBody } from "./agent-rpc-body.js";
+import { activePrompts, getChatsForSession } from "./session-chat-binding.js";
+import { getPlatformForChat } from "./session.js";
+import { readStreamState, writeStreamState } from "./stream-state.js";
+import { ts } from "./config.js";
+export const AGENT_STOP_STUCK_PATH = "/api/agent/stop-stuck-loop";
+const MAX_REQUEST_BYTES = 8 * 1024;
+function jsonReply(res, status, data) {
+    res.writeHead(status, { "Content-Type": "application/json; charset=utf-8" });
+    res.end(JSON.stringify(data));
+}
+/**
+ * 从原始 body 字节中用正则尽力提取 session_id。
+ * 兼容 JSON 编码异常（如 GBK 中文导致 JSON.parse 失败）的场景。
+ */
+function extractSessionIdFromRaw(buf) {
+    // 匹配 "session_id":"<uuid>" 或 "session_id": "<uuid>"
+    const match = buf.toString("latin1").match(/"session_id"\s*:\s*"([^"]+)"/);
+    return match?.[1] ?? null;
+}
+export async function handleAgentStopStuckRequest(req, res) {
+    const url = new URL(req.url ?? "/", "http://127.0.0.1");
+    if (url.pathname !== AGENT_STOP_STUCK_PATH)
+        return false;
+    if (req.method !== "POST") {
+        jsonReply(res, 405, { error: "Method not allowed, use POST" });
+        return true;
+    }
+    let body;
+    let rawBody = null;
+    try {
+        body = await readUtf8JsonBody(req, MAX_REQUEST_BYTES);
+    }
+    catch (err) {
+        // JSON 解析失败时仍尝试从原始字节中提取 session_id 并强行停止
+        // 宁可输出乱码，也不能让 agent 持续循环
+        rawBody = err.rawBody ?? null;
+        if (!rawBody) {
+            jsonReply(res, 400, { error: `Invalid request body: ${err.message}` });
+            return true;
+        }
+        const fallbackId = extractSessionIdFromRaw(rawBody);
+        if (!fallbackId) {
+            jsonReply(res, 400, { error: `Invalid request body: ${err.message}` });
+            return true;
+        }
+        body = { session_id: fallbackId };
+    }
+    const sessionId = typeof body?.session_id === "string" ? body.session_id.trim() : "";
+    if (!sessionId) {
+        jsonReply(res, 400, { error: "session_id is required" });
+        return true;
+    }
+    const prompt = activePrompts.get(sessionId);
+    if (!prompt) {
+        jsonReply(res, 404, { error: "Session not found or not running" });
+        return true;
+    }
+    // 先发"卡住"提示消息给所有绑定的群聊
+    const chats = getChatsForSession(sessionId);
+    for (const chatId of chats) {
+        const platform = getPlatformForChat(chatId);
+        if (platform) {
+            await platform.sendText(chatId, "⚠️ Agent 检测到自己陷入了循环，正在结束生成…").catch(() => { });
+        }
+    }
+    // 不丢弃缓存队列中的消息，让 runAgentSession 的 finally 块正常消费，
+    // 确保 stop-stuck-loop 结束后排队的消息仍能被正常处理。
+    const finalReply = typeof body?.final_reply === "string" ? body.final_reply.trim() : "";
+    // fire-and-forget：立即把 stream-state 标为 done（而非 stopped），
+    // 让 display loop 以"正常完成"而非"已停止"来渲染卡片和最终回复。
+    // 不设 prompt.stopped = true，这样 runAgentSession 的 finally 也会写 "done"。
+    void (async () => {
+        try {
+            const current = await readStreamState(sessionId);
+            if (!current)
+                return;
+            if (current.status !== "running")
+                return;
+            await writeStreamState({
+                ...current,
+                status: "done",
+                stuckAt: Date.now(),
+                finalReply: finalReply ? current.finalReply + "\n\n" + finalReply : current.finalReply,
+                updatedAt: Date.now(),
+            });
+        }
+        catch (err) {
+            console.warn(`[${ts()}] [STUCK-LOOP] writeStreamState(done) failed for ${sessionId}: ${err.message}`);
+        }
+    })();
+    // 先关闭底层 SDK session，终止 CLI 子进程，然后再 abort 清理 adapter 层
+    prompt.closeSession?.();
+    // 强制杀死 CLI 子进程。controller.abort() 只在 for-await 收到下一条
+    // stream 消息时才被检测到——如果 agent 陷入无输出的计算循环，abort 信号
+    // 永远不会生效；SDK 的 session.close() 也不保证立即终止子进程。
+    if (prompt.processPid !== undefined) {
+        try {
+            process.kill(prompt.processPid);
+        }
+        catch {
+            // 进程可能已退出，忽略错误
+        }
+    }
+    // 不设 stopped 标记 → finally block 写 "done" → 卡片正常结束
+    prompt.controller.abort();
+    console.log(`[${ts()}] [STUCK-LOOP] Session ${sessionId} aborted as done (agent detected stuck loop, final_reply=${finalReply ? "yes" : "no"})`);
+    jsonReply(res, 200, { ok: true });
+    return true;
+}

package/dist/src/card-action-routing.js

@@ -0,0 +1,7 @@
+/**
+ * Feishu card action callbacks do not include the chat type. Recover it from
+ * the persisted binding so buttons clicked in a private chat stay in p2p.
+ */
+export function resolveFeishuCardActionChatType(chatId, registry) {
+    return registry[chatId]?.chatType === "p2p" ? "p2p" : "group";
+}

package/dist/src/card-plain-text.js

@@ -0,0 +1,101 @@
+function isObject(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function stringValue(value) {
+    return typeof value === "string" && value.trim() ? value.trim() : null;
+}
+function textContent(value) {
+    if (typeof value === "string")
+        return stringValue(value);
+    if (!isObject(value))
+        return null;
+    return stringValue(value.content);
+}
+function parseButtonValue(value) {
+    if (typeof value !== "string")
+        return value;
+    try {
+        return JSON.parse(value);
+    }
+    catch {
+        return value;
+    }
+}
+function commandFromValue(value) {
+    const parsed = parseButtonValue(value);
+    if (typeof parsed === "string") {
+        const trimmed = parsed.trim();
+        return trimmed.startsWith("/") ? trimmed : null;
+    }
+    if (!isObject(parsed))
+        return null;
+    const cmd = stringValue(parsed.cmd);
+    if (cmd)
+        return cmd.startsWith("/") ? cmd : `/${cmd}`;
+    const action = stringValue(parsed.action);
+    if (!action)
+        return null;
+    if (action === "cd") {
+        const path = stringValue(parsed.path);
+        return path ? `/cd ${path}` : "/cd";
+    }
+    return action.startsWith("/") ? action : `/${action}`;
+}
+function buttonText(element) {
+    const label = textContent(element.text);
+    const command = commandFromValue(element.value);
+    if (label && command)
+        return `${label}: ${command}`;
+    return label ?? command;
+}
+function elementToText(element) {
+    if (!isObject(element))
+        return [];
+    const tag = stringValue(element.tag);
+    if (tag === "div") {
+        const content = textContent(element.text);
+        return content ? [content] : [];
+    }
+    if (tag === "markdown") {
+        const content = stringValue(element.content);
+        return content ? [content] : [];
+    }
+    if (tag === "button") {
+        const content = buttonText(element);
+        return content ? [content] : [];
+    }
+    if (tag === "action" && Array.isArray(element.actions)) {
+        return element.actions.flatMap(elementToText);
+    }
+    return [];
+}
+function rootElements(card) {
+    if (Array.isArray(card.elements))
+        return card.elements;
+    if (isObject(card.body) && Array.isArray(card.body.elements)) {
+        return card.body.elements;
+    }
+    return [];
+}
+export function cardJsonToPlainText(cardJson) {
+    let card;
+    try {
+        card = JSON.parse(cardJson);
+    }
+    catch {
+        return null;
+    }
+    if (!isObject(card))
+        return null;
+    const title = isObject(card.header) && isObject(card.header.title)
+        ? textContent(card.header.title)
+        : null;
+    const lines = rootElements(card).flatMap(elementToText);
+    const parts = title ? [`# ${title}`, ...lines] : lines;
+    const text = parts
+        .map((part) => part.trim())
+        .filter(Boolean)
+        .join("\n\n")
+        .trim();
+    return text || null;
+}

package/dist/src/cardkit.js

@@ -0,0 +1,158 @@
+import { BASE_URL, fileLog, ts } from "./config.js";
+// CardKit 是飞书的卡片流式更新 API，通过 cardElement.content 端点
+// 对卡片上指定 element_id 的元素进行增量内容更新，实现打字机效果。
+// 与普通卡片 PATCH 的区别：PATCH 是全量替换卡片 JSON，CardKit 是
+// 由飞书客户端自行渲染增量文本，用户看到的是逐字出现的效果。
+// 参考: https://open.feishu.cn/document/uYjLw4iNukDO6YDN4ITM4MjM
+const CARDKIT_REQUEST_TIMEOUT_MS = 15_000;
+async function fetchCardKit(url, init, operation) {
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), CARDKIT_REQUEST_TIMEOUT_MS);
+    try {
+        const resp = await fetch(url, { ...init, signal: controller.signal });
+        const respText = await resp.text();
+        return { resp, respText };
+    }
+    catch (err) {
+        if (err.name === "AbortError") {
+            console.error(`[${ts()}] [CARDIKT] ${operation} TIMEOUT after ${CARDKIT_REQUEST_TIMEOUT_MS}ms`);
+            fileLog.flush();
+            throw new Error(`${operation} timeout after ${CARDKIT_REQUEST_TIMEOUT_MS}ms`);
+        }
+        throw err;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export async function createCardKitCard(token, cardJson) {
+    const body = JSON.stringify({ type: "card_json", data: cardJson });
+    const { resp, respText } = await fetchCardKit(`${BASE_URL}/cardkit/v1/cards`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json",
+        },
+        body,
+    }, "createCard");
+    let data;
+    try {
+        data = JSON.parse(respText);
+    }
+    catch {
+        console.error(`[${ts()}] [CARDIKT] createCard: invalid JSON response (status=${resp.status}) body=${respText.slice(0, 500)}`);
+        fileLog.flush();
+        throw new Error(`CardKit create: invalid JSON response (status=${resp.status})`);
+    }
+    if (data.code !== 0) {
+        console.error(`[${ts()}] [CARDIKT] createCard FAIL: status=${resp.status} code=${data.code} msg="${data.msg}" body=${respText.slice(0, 500)}`);
+        fileLog.flush();
+        throw new Error(`CardKit create: [${data.code}] ${data.msg}`);
+    }
+    console.log(`[${ts()}] [CARDIKT] createCard OK cardId=${data.data?.card_id ?? "(none)"}`);
+    return data.data?.card_id ?? "";
+}
+export async function setCardKitSettings(token, cardId, settings, sequence) {
+    const { resp, respText } = await fetchCardKit(`${BASE_URL}/cardkit/v1/cards/${cardId}/settings`, {
+        method: "PATCH",
+        headers: {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ settings: JSON.stringify(settings), sequence }),
+    }, `settings cardId=${cardId} seq=${sequence}`);
+    let data;
+    try {
+        data = JSON.parse(respText);
+    }
+    catch {
+        console.error(`[${ts()}] [CARDIKT] settings FAIL: invalid JSON cardId=${cardId} seq=${sequence} status=${resp.status}`);
+        fileLog.flush();
+        throw new Error(`CardKit settings: invalid JSON (status=${resp.status})`);
+    }
+    if (data.code !== 0) {
+        console.error(`[${ts()}] [CARDIKT] settings FAIL: cardId=${cardId} seq=${sequence} status=${resp.status} code=${data.code} msg="${data.msg}"`);
+        fileLog.flush();
+        throw new Error(`CardKit settings: [${data.code}] ${data.msg}`);
+    }
+    console.log(`[${ts()}] [CARDIKT] settings OK cardId=${cardId} seq=${sequence}`);
+}
+export async function streamCardKitElement(token, cardId, elementId, content, sequence) {
+    const { resp, respText } = await fetchCardKit(`${BASE_URL}/cardkit/v1/cards/${cardId}/elements/${elementId}/content`, {
+        method: "PUT",
+        headers: {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ content, sequence }),
+    }, `streamElement cardId=${cardId} element=${elementId} seq=${sequence}`);
+    let data;
+    try {
+        data = JSON.parse(respText);
+    }
+    catch {
+        console.error(`[${ts()}] [CARDIKT] streamElement FAIL: invalid JSON cardId=${cardId} element=${elementId} seq=${sequence} status=${resp.status}`);
+        fileLog.flush();
+        throw new Error(`CardKit stream: invalid JSON (status=${resp.status})`);
+    }
+    if (data.code !== 0) {
+        console.error(`[${ts()}] [CARDIKT] streamElement FAIL: cardId=${cardId} element=${elementId} seq=${sequence} status=${resp.status} code=${data.code} msg="${data.msg}"`);
+        fileLog.flush();
+        throw new Error(`CardKit stream: [${data.code}] ${data.msg}`);
+    }
+    // success log is intentionally sparse — uncomment to debug streaming throughput
+    // console.log(`[${ts()}] [CARDIKT] streamElement OK cardId=${cardId} seq=${sequence}`);
+}
+export async function updateCardKitCard(token, cardId, cardJson, sequence) {
+    const { resp, respText } = await fetchCardKit(`${BASE_URL}/cardkit/v1/cards/${cardId}`, {
+        method: "PUT",
+        headers: {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify({ card: { type: "card_json", data: cardJson }, sequence }),
+    }, `updateCard cardId=${cardId} seq=${sequence}`);
+    let data;
+    try {
+        data = JSON.parse(respText);
+    }
+    catch {
+        console.error(`[${ts()}] [CARDIKT] updateCard FAIL: invalid JSON cardId=${cardId} seq=${sequence} status=${resp.status}`);
+        fileLog.flush();
+        throw new Error(`CardKit update: invalid JSON (status=${resp.status})`);
+    }
+    if (data.code !== 0) {
+        console.error(`[${ts()}] [CARDIKT] updateCard FAIL: cardId=${cardId} seq=${sequence} status=${resp.status} code=${data.code} msg="${data.msg}"`);
+        fileLog.flush();
+        throw new Error(`CardKit update: [${data.code}] ${data.msg}`);
+    }
+    console.log(`[${ts()}] [CARDIKT] updateCard OK cardId=${cardId} seq=${sequence}`);
+}
+export async function sendCardKitMessage(token, chatId, cardId) {
+    const payload = { receive_id: chatId, msg_type: "interactive", content: JSON.stringify({ type: "card", data: { card_id: cardId } }) };
+    const url = `${BASE_URL}/im/v1/messages?receive_id_type=chat_id`;
+    const { resp, respText } = await fetchCardKit(url, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${token}`,
+            "Content-Type": "application/json",
+        },
+        body: JSON.stringify(payload),
+    }, `sendMessage cardId=${cardId} chatId=${chatId}`);
+    let data;
+    try {
+        data = JSON.parse(respText);
+    }
+    catch {
+        console.error(`[${ts()}] [CARDIKT] sendMessage FAIL: invalid JSON cardId=${cardId} chatId=${chatId} status=${resp.status}`);
+        fileLog.flush();
+        throw new Error(`sendCardKitMessage: invalid JSON (status=${resp.status})`);
+    }
+    if (data.code !== 0) {
+        console.error(`[${ts()}] [CARDIKT] sendMessage FAIL: status=${resp.status} code=${data.code} msg="${data.msg}" cardId=${cardId} chatId=${chatId}`);
+        fileLog.flush();
+        throw new Error(`[${data.code}] ${data.msg}`);
+    }
+    console.log(`[${ts()}] [CARDIKT] sendMessage OK cardId=${cardId} chatId=${chatId} msgId=${data.data?.message_id ?? "(none)"}`);
+    return data.data?.message_id ?? "";
+}