clawsocial-plugin-push-cn-tim 0.1.0

package/src/tim-client.ts

@@ -0,0 +1,177 @@
+/**
+ * TIM Client — 腾讯云 IM 实时消息接收
+ *
+ * 替代 ws-client.ts，使用 @tencentcloud/chat Node.js SDK
+ * 接收来自对方 Agent 的消息，dispatch 到 OpenClaw 活跃会话
+ */
+
+import { getState, upsertSession, getSession, addMessage } from "./store.js";
+import api from "./api.js";
+
+// @tencentcloud/chat exports a default object with create() + EVENT + TYPES
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let TencentCloudChat: any = null;
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+let timSdk: any = null;
+
+let _ready = false;
+let _reconnectTimer: ReturnType<typeof setTimeout> | null = null;
+
+// Dispatch function injected by index.ts (subagent.run → real agent run)
+let _dispatch: ((text: string, conversationId: string, senderName: string) => Promise<void>) | null = null;
+
+export function setDispatch(fn: (text: string, conversationId: string, senderName: string) => Promise<void>): void {
+  _dispatch = fn;
+}
+
+function log(msg: string): void {
+  console.log(`[ClawSocial TIM] ${msg}`);
+}
+
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+async function handleMessage(msg: any): Promise<void> {
+  // Only handle C2C (one-to-one) messages
+  if (!TencentCloudChat || msg.conversationType !== TencentCloudChat.TYPES.CONV_C2C) return;
+
+  const fromUserId: string = msg.from as string;
+  const myId = getState().agent_id;
+  if (!fromUserId || fromUserId === myId) return; // ignore own messages (echo)
+
+  // Extract text payload
+  const elements: unknown[] = Array.isArray(msg.payload?.elems) ? msg.payload.elems : [];
+  let text = "";
+  for (const el of elements) {
+    const e = el as { type?: string; content?: { text?: string } };
+    if (e.type === "TIMTextElem" && e.content?.text) {
+      text += e.content.text;
+    }
+  }
+  // Fallback: tim-js-sdk shape (payload.text)
+  if (!text && (msg.payload as { text?: string })?.text) {
+    text = (msg.payload as { text: string }).text;
+  }
+  if (!text) return;
+
+  // Look up session & partner name from local store
+  // session id is stored as the sessionId key in sessions.json
+  // We search by partner_agent_id
+  const session = Object.values(
+    (await import("./store.js")).getSessions()
+  ).find((s) => s.partner_agent_id === fromUserId);
+
+  const sessionId = session?.id ?? fromUserId; // fallback to userId as conversationId
+  const partnerName = session?.partner_name ?? fromUserId;
+
+  addMessage(sessionId, {
+    id: `tim-${Date.now()}`,
+    from_self: false,
+    partner_name: partnerName,
+    content: text,
+    created_at: (msg.time as number) || Math.floor(Date.now() / 1000),
+  });
+
+  log(`来自 ${partnerName}：${text.slice(0, 60)}`);
+
+  if (_dispatch) {
+    await _dispatch(text, sessionId, partnerName);
+  }
+}
+
+async function initTIM(): Promise<void> {
+  if (!TencentCloudChat) {
+    // Dynamic import so the module resolves at runtime (ESM)
+    const mod = await import("@tencentcloud/chat");
+    TencentCloudChat = mod.default ?? mod;
+  }
+
+  const state = getState();
+  if (!state.agent_id) {
+    log("尚未注册，跳过 TIM 初始化");
+    return;
+  }
+
+  // Fetch UserSig from our server (server-cn-tim /auth/usersig endpoint)
+  let userSigResult: { user_id: string; user_sig: string; sdk_app_id: number };
+  try {
+    userSigResult = await api.getUserSig();
+  } catch (err) {
+    log(`获取 UserSig 失败：${(err as Error).message}，30s 后重试`);
+    _reconnectTimer = setTimeout(initTIM, 30_000);
+    return;
+  }
+
+  const { user_sig: userSig, sdk_app_id: sdkAppId } = userSigResult;
+
+  // Destroy previous instance if any
+  if (timSdk) {
+    try { timSdk.destroy(); } catch { /* ignore */ }
+    timSdk = null;
+    _ready = false;
+  }
+
+  timSdk = TencentCloudChat.create({ SDKAppID: sdkAppId });
+  timSdk.setLogLevel(2); // 0=debug, 1=log, 2=warn, 3=error
+
+  timSdk.on(TencentCloudChat.EVENT.SDK_READY, () => {
+    _ready = true;
+    log("TIM SDK 就绪，开始接收消息");
+  });
+
+  timSdk.on(TencentCloudChat.EVENT.SDK_NOT_READY, () => {
+    _ready = false;
+    log("TIM SDK 未就绪");
+  });
+
+  // eslint-disable-next-line @typescript-eslint/no-explicit-any
+  timSdk.on(TencentCloudChat.EVENT.MESSAGE_RECEIVED, (event: any) => {
+    const messages: unknown[] = Array.isArray(event?.data) ? event.data : [];
+    for (const msg of messages) {
+      handleMessage(msg).catch((err) =>
+        console.error("[ClawSocial TIM] dispatch error:", err)
+      );
+    }
+  });
+
+  timSdk.on(TencentCloudChat.EVENT.KICKED_OUT, () => {
+    log("账号被踢下线，30s 后重新登录");
+    _ready = false;
+    _reconnectTimer = setTimeout(initTIM, 30_000);
+  });
+
+  // Login
+  const loginRes = await timSdk.login({ userID: state.agent_id, userSig });
+  if (loginRes.code !== 0) {
+    log(`登录失败 code=${loginRes.code}，30s 后重试`);
+    _reconnectTimer = setTimeout(initTIM, 30_000);
+    return;
+  }
+
+  log(`已登录 TIM，用户 ID: ${state.agent_id}`);
+}
+
+export function startTimClient(): void {
+  initTIM().catch((err) => {
+    console.error("[ClawSocial TIM] 初始化错误:", err);
+    _reconnectTimer = setTimeout(startTimClient, 30_000);
+  });
+}
+
+export function reconnectTimClient(): void {
+  if (_reconnectTimer) clearTimeout(_reconnectTimer);
+  initTIM().catch((err) => {
+    console.error("[ClawSocial TIM] 重连错误:", err);
+    _reconnectTimer = setTimeout(startTimClient, 30_000);
+  });
+}
+
+export function stopTimClient(): void {
+  if (_reconnectTimer) {
+    clearTimeout(_reconnectTimer);
+    _reconnectTimer = null;
+  }
+  if (timSdk) {
+    try { timSdk.destroy(); } catch { /* ignore */ }
+    timSdk = null;
+    _ready = false;
+  }
+}

package/src/tools/card.ts

@@ -0,0 +1,19 @@
+import { Type } from "@sinclair/typebox";
+import type { AnyAgentTool } from "../types.js";
+import api from "../api.js";
+
+export function createCardTool(): AnyAgentTool {
+  return {
+    name: "clawsocial_get_card",
+    label: "ClawSocial 名片",
+    description:
+      "Generate and display the user's ClawSocial profile card. " +
+      "Call when user asks to see, generate, or share their ClawSocial card. " +
+      "Also automatically called after clawsocial_update_profile to show the updated card.",
+    parameters: Type.Object({}),
+    async execute(_id: string, _params: Record<string, unknown>) {
+      const res = await api.getCard();
+      return { content: [{ type: "text", text: res.card }] };
+    },
+  } as AnyAgentTool;
+}

package/src/tools/connect.ts

@@ -0,0 +1,46 @@
+import { Type } from "@sinclair/typebox";
+import type { AnyAgentTool } from "../types.js";
+import api from "../api.js";
+import { upsertSession } from "../store.js";
+
+export function createConnectTool(serverUrl: string): AnyAgentTool {
+  return {
+    name: "clawsocial_connect",
+    label: "ClawSocial 发起连接",
+    description:
+      "Send a connection request to a candidate. Call AFTER clawsocial_search, ONLY with explicit user approval. NEVER call without the user agreeing.",
+    parameters: Type.Object({
+      target_agent_id: Type.String({ description: "来自 clawsocial_search 结果的 agent_id" }),
+      intro_message: Type.String({
+        description:
+          "传入用户本次搜索意图原文。不要包含真实姓名、联系方式或位置。",
+      }),
+    }),
+    async execute(_id: string, params: Record<string, unknown>) {
+      const target_agent_id = params.target_agent_id as string;
+      const intro_message = params.intro_message as string;
+      if (!target_agent_id) throw new Error("target_agent_id 不能为空");
+      if (!intro_message) throw new Error("intro_message 不能为空，需要简短说明连接原因");
+
+      const res = await api.connect({ target_agent_id, intro_message });
+
+      upsertSession(res.session_id, {
+        status: "active",
+        is_receiver: false,
+        partner_agent_id: target_agent_id,
+        created_at: Math.floor(Date.now() / 1000),
+        messages: [],
+        unread: 0,
+      });
+
+      const sessionUrl = `${serverUrl}/inbox/session/${res.session_id}`;
+      const result = {
+        session_id: res.session_id,
+        status: "active",
+        message: `✅ Connected! You can start chatting now. Use clawsocial_open_inbox to open the inbox link.`,
+        session_url: sessionUrl,
+      };
+      return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    },
+  } as AnyAgentTool;
+}

package/src/tools/open_inbox.ts

@@ -0,0 +1,22 @@
+import { Type } from "@sinclair/typebox";
+import type { AnyAgentTool } from "../types.js";
+import api from "../api.js";
+
+export function createOpenInboxTool(): AnyAgentTool {
+  return {
+    name: "clawsocial_open_inbox",
+    label: "ClawSocial 打开收件箱",
+    description:
+      "Generate a one-time login link to open the ClawSocial inbox in a browser. The link is valid for 15 minutes and can only be used once. Call this when the user asks to open their inbox or check messages.",
+    parameters: Type.Object({}),
+    async execute(_id: string, _params: Record<string, unknown>) {
+      const data = await api.openInboxToken();
+      const result = {
+        url: data.url,
+        expires_in: data.expires_in,
+        message: `🦞 收件箱登录链接（${Math.floor(data.expires_in / 60)} 分钟有效，仅可使用一次）：\n${data.url}\n\n链接失效后可再次调用此工具重新生成。`,
+      };
+      return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    },
+  } as AnyAgentTool;
+}

package/src/tools/register.ts

@@ -0,0 +1,54 @@
+import { Type } from "@sinclair/typebox";
+import type { AnyAgentTool } from "../types.js";
+import api from "../api.js";
+import { getState, setState } from "../store.js";
+
+export function createRegisterTool(): AnyAgentTool {
+  return {
+    name: "clawsocial_register",
+    label: "ClawSocial 注册",
+    description:
+      "Register this lobster on ClawSocial. Call ONCE automatically on first use. Only asks the user for a public_name.",
+    parameters: Type.Object({
+      public_name: Type.String({ description: "用户选择的龙虾公开名称" }),
+      availability: Type.Optional(
+        Type.Unsafe<"open" | "by-request" | "closed">({
+          type: "string",
+          enum: ["open", "by-request", "closed"],
+          description: "可发现性，默认 open",
+        }),
+      ),
+    }),
+    async execute(_id: string, params: Record<string, unknown>) {
+      const state = getState();
+      if (state.agent_id && state.api_key) {
+        const result = {
+          already_registered: true,
+          agent_id: state.agent_id,
+          public_name: state.public_name,
+        };
+        return { content: [{ type: "text", text: JSON.stringify(result) }] };
+      }
+
+      const res = await api.register({
+        public_name: params.public_name as string,
+        availability: (params.availability as string) ?? "open",
+      });
+
+      setState({
+        agent_id: res.agent_id,
+        api_key: res.api_key,
+        token: res.token,
+        public_name: res.public_name,
+        registered_at: Date.now(),
+      });
+
+      const result = {
+        agent_id: res.agent_id,
+        public_name: res.public_name,
+        message: `✅ 已成功注册 ClawSocial。你的龙虾名：${res.public_name}`,
+      };
+      return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    },
+  } as AnyAgentTool;
+}

package/src/tools/search.ts

@@ -0,0 +1,51 @@
+import { Type } from "@sinclair/typebox";
+import type { AnyAgentTool } from "../types.js";
+import api from "../api.js";
+
+export function createSearchTool(): AnyAgentTool {
+  return {
+    name: "clawsocial_search",
+    label: "ClawSocial 搜索",
+    description:
+      "Search for agents matching a topic or interest. Call first when the user wants to find someone. Always show results to the user and get explicit approval before connecting.",
+    parameters: Type.Object({
+      intent: Type.String({ description: "用自然语言描述想找什么样的人或话题" }),
+      topic_tags: Type.Optional(Type.Array(Type.String(), { description: "额外标签，提高相关性" })),
+      top_k: Type.Optional(Type.Number({ description: "返回数量，默认 5", minimum: 1, maximum: 20 })),
+    }),
+    async execute(_id: string, params: Record<string, unknown>) {
+      const intent = params.intent as string;
+      if (!intent) throw new Error("intent 不能为空");
+
+      const res = await api.search({
+        intent,
+        topic_tags: (params.topic_tags as string[]) ?? [],
+        top_k: (params.top_k as number) ?? 5,
+      });
+
+      if (!res.candidates || res.candidates.length === 0) {
+        const result = {
+          candidates: [],
+          message: "暂时没有找到匹配的龙虾。可以稍后再试，或者换一个话题描述。",
+        };
+        return { content: [{ type: "text", text: JSON.stringify(result) }] };
+      }
+
+      const result = {
+        candidates: res.candidates.map((c) => ({
+          agent_id: c.agent_id,
+          public_name: c.public_name,
+          topic_tags: c.topic_tags,
+          match_score: Math.round(c.match_score * 100) + "%",
+          availability: c.availability,
+          ...(c.manual_intro ? { manual_intro: c.manual_intro } : {}),
+          ...(c.auto_bio ? { auto_bio: c.auto_bio } : {}),
+          ...(c.match_reason ? { match_reason: c.match_reason } : {}),
+        })),
+        total: res.candidates.length,
+        query_intent: intent,
+      };
+      return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    },
+  } as AnyAgentTool;
+}

package/src/tools/session_get.ts

@@ -0,0 +1,65 @@
+import { Type } from "@sinclair/typebox";
+import type { AnyAgentTool } from "../types.js";
+import { getSessions, markRead } from "../store.js";
+
+export function createSessionGetTool(serverUrl: string): AnyAgentTool {
+  return {
+    name: "clawsocial_session_get",
+    label: "ClawSocial 查看会话",
+    description:
+      "Get recent messages of a specific session. Supports exact session_id or fuzzy partner_name match.",
+    parameters: Type.Object({
+      session_id: Type.Optional(Type.String({ description: "精确 UUID（与 partner_name 二选一）" })),
+      partner_name: Type.Optional(
+        Type.String({ description: "按对方名称模糊匹配（与 session_id 二选一）" }),
+      ),
+    }),
+    async execute(_id: string, params: Record<string, unknown>) {
+      const sessions = getSessions();
+      let session = null;
+
+      if (params.session_id) {
+        session = sessions[params.session_id as string] ?? null;
+      } else if (params.partner_name) {
+        const keyword = (params.partner_name as string).toLowerCase();
+        session =
+          Object.values(sessions).find(
+            (s) =>
+              s.partner_name?.toLowerCase().includes(keyword) ||
+              s.partner_agent_id?.toLowerCase().includes(keyword),
+          ) ?? null;
+      }
+
+      if (!session) {
+        const result = {
+          found: false,
+          message: "未找到匹配的会话。使用 clawsocial_sessions_list 查看所有会话。",
+        };
+        return { content: [{ type: "text", text: JSON.stringify(result) }] };
+      }
+
+      markRead(session.id);
+
+      const shortId = session.partner_agent_id ? "#" + session.partner_agent_id.slice(0, 6) : "";
+      const partnerDisplay = session.partner_name
+        ? `${session.partner_name} ${shortId}`
+        : (session.partner_agent_id ?? "未知");
+      const messages = (session.messages ?? []).slice(-10);
+      const sessionUrl = `${serverUrl}/inbox/session/${session.id}`;
+
+      const result = {
+        session_id: session.id,
+        partner_name: partnerDisplay,
+        status: session.status,
+        recent_messages: messages.map((m) => ({
+          from: m.from_self ? "我的龙虾" : partnerDisplay,
+          content: m.content,
+          time: m.created_at ? new Date(m.created_at * 1000).toLocaleString("zh-CN") : "",
+        })),
+        session_url: sessionUrl,
+        tip: `在浏览器中查看：${sessionUrl}（需先通过 clawsocial_open_inbox 登录）`,
+      };
+      return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    },
+  } as AnyAgentTool;
+}

package/src/tools/session_send.ts

@@ -0,0 +1,40 @@
+import { Type } from "@sinclair/typebox";
+import type { AnyAgentTool } from "../types.js";
+import api from "../api.js";
+import { addMessage } from "../store.js";
+
+export function createSessionSendTool(): AnyAgentTool {
+  return {
+    name: "clawsocial_session_send",
+    label: "ClawSocial 发送消息",
+    description:
+      "Send a message in an active session on behalf of the user. Call when the user explicitly provides reply content. Pass the content verbatim — do not paraphrase.",
+    parameters: Type.Object({
+      session_id: Type.String({ description: "活跃会话 ID" }),
+      content: Type.String({ description: "用户的消息，原样转发" }),
+    }),
+    async execute(_id: string, params: Record<string, unknown>) {
+      const session_id = params.session_id as string;
+      const content = params.content as string;
+      if (!session_id) throw new Error("session_id 不能为空");
+      if (!content) throw new Error("content 不能为空");
+
+      const res = await api.sendMessage(session_id, { content, intent: "chat" });
+
+      addMessage(session_id, {
+        id: res.msg_id,
+        from_self: true,
+        content,
+        intent: "chat",
+        created_at: Math.floor(Date.now() / 1000),
+      });
+
+      const result = {
+        msg_id: res.msg_id,
+        delivered: res.delivered,
+        message: res.delivered ? "✅ 消息已送达" : "📬 消息已入队（对方龙虾当前离线）",
+      };
+      return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    },
+  } as AnyAgentTool;
+}

package/src/tools/sessions_list.ts

@@ -0,0 +1,49 @@
+import { Type } from "@sinclair/typebox";
+import type { AnyAgentTool } from "../types.js";
+import { getSessions } from "../store.js";
+
+export function createSessionsListTool(serverUrl: string): AnyAgentTool {
+  return {
+    name: "clawsocial_sessions_list",
+    label: "ClawSocial 会话列表",
+    description:
+      "List all active sessions. Call when the user asks about their conversations or checks /sessions.",
+    parameters: Type.Object({}),
+    async execute(_id: string, _params: Record<string, unknown>) {
+      const sessions = getSessions();
+      const list = Object.values(sessions).sort((a, b) => (b.updated_at ?? 0) - (a.updated_at ?? 0));
+
+      if (list.length === 0) {
+        const result = {
+          sessions: [],
+          message: "暂无会话。使用 clawsocial_search 找到匹配的龙虾，发起连接。",
+        };
+        return { content: [{ type: "text", text: JSON.stringify(result) }] };
+      }
+
+      const shortId = (id?: string) => (id ? "#" + id.slice(0, 6) : "");
+      const formatted = list.map((s) => ({
+        session_id: s.id,
+        partner_name: s.partner_name
+          ? `${s.partner_name} ${shortId(s.partner_agent_id)}`
+          : (s.partner_agent_id ?? "未知"),
+        status: s.status,
+        last_message: s.last_message
+          ? s.last_message.slice(0, 60) + (s.last_message.length > 60 ? "..." : "")
+          : "（无消息）",
+        unread: s.unread ?? 0,
+        last_active: s.last_active_at
+          ? new Date(s.last_active_at * 1000).toLocaleString("zh-CN")
+          : "未知",
+      }));
+
+      const result = {
+        sessions: formatted,
+        total: list.length,
+        unread_total: list.reduce((sum, s) => sum + (s.unread ?? 0), 0),
+        tip: `使用 clawsocial_open_inbox 获取收件箱登录链接（${serverUrl}/inbox）`,
+      };
+      return { content: [{ type: "text", text: JSON.stringify(result) }] };
+    },
+  } as AnyAgentTool;
+}

package/src/tools/suggest_profile.ts

@@ -0,0 +1,84 @@
+import { Type } from "@sinclair/typebox";
+import fs from "node:fs";
+import path from "node:path";
+import os from "node:os";
+import type { AnyAgentTool } from "../types.js";
+
+type LocalFiles = { soul: string; memory: string; user: string };
+
+function readLocalFiles(): LocalFiles {
+  const home = os.homedir();
+  const bases = [
+    path.join(home, ".openclaw", "workspace"),
+    path.join(home, ".clawdbot", "workspace"),
+  ];
+
+  function readFirst(relPath: string): string {
+    for (const base of bases) {
+      try {
+        const content = fs.readFileSync(path.join(base, relPath), "utf8");
+        if (content.trim()) return content;
+      } catch {}
+    }
+    return "";
+  }
+
+  return {
+    soul: readFirst("SOUL.md"),
+    memory: readFirst("memory/MEMORY.md"),
+    user: readFirst("USER.md"),
+  };
+}
+
+export function createSuggestProfileTool(): AnyAgentTool {
+  return {
+    name: "clawsocial_suggest_profile",
+    label: "ClawSocial 建议兴趣资料",
+    description:
+      "Read the user's OpenClaw memory to help draft a ClawSocial interest profile. " +
+      "Call this after registration or when the user wants to update their profile. " +
+      "After calling this tool, draft a 2-3 sentence interest description based on the memory content, " +
+      "show it to the user, and ONLY call clawsocial_update_profile after the user explicitly confirms or edits it. " +
+      "NEVER update the profile silently.",
+    parameters: Type.Object({}),
+    async execute(_id: string, _params: Record<string, unknown>) {
+      const files = readLocalFiles();
+      const found = [files.soul, files.memory, files.user].filter(Boolean);
+      const completeness = [0.1, 0.4, 0.7, 1.0][found.length];
+
+      if (found.length === 0) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: JSON.stringify({
+                files_found: 0,
+                message: "No local OpenClaw files found. Please ask the user to describe their interests directly.",
+              }),
+            },
+          ],
+        };
+      }
+
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify({
+              files_found: found.length,
+              completeness_score: completeness,
+              soul: files.soul || null,
+              memory: files.memory || null,
+              user: files.user || null,
+              instruction:
+                "Extract interest topics, personality traits, work style, and focus areas from these files. " +
+                "Strip all names, companies, locations, and credentials. " +
+                "Draft a 2-3 sentence description. Show it to the user and ask for confirmation. " +
+                "Only call clawsocial_update_profile with auto_bio (not interest_text) and completeness_score after explicit user approval.",
+            }),
+          },
+        ],
+      };
+    },
+  } as AnyAgentTool;
+}