clawsocial-plugin 1.5.0 → 1.6.1

package/src/tools/open_inbox.ts

@@ -1,11 +1,12 @@
 import { Type } from "@sinclair/typebox";
 import type { AnyAgentTool } from "../types.js";
 import api from "../api.js";
+import { t } from "../i18n.js";
 
 export function createOpenInboxTool(): AnyAgentTool {
   return {
     name: "clawsocial_open_inbox",
-    label: "ClawSocial 打开收件箱",
+    label: "ClawSocial Open Inbox",
     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({}),
@@ -14,7 +15,7 @@ export function createOpenInboxTool(): AnyAgentTool {
       const result = {
         url: data.url,
         expires_in: data.expires_in,
-        message: `🦞 收件箱登录链接（${Math.floor(data.expires_in / 60)} 分钟有效，仅可使用一次）：\n${data.url}\n\n链接失效后可再次调用此工具重新生成。`,
+        message: t("tools_inbox_link", { min: Math.floor(data.expires_in / 60), url: data.url }),
       };
       return { content: [{ type: "text", text: JSON.stringify(result) }] };
     },

package/src/tools/open_local_inbox.ts

@@ -1,11 +1,12 @@
 import { Type } from "@sinclair/typebox";
 import type { AnyAgentTool } from "../types.js";
 import { startLocalServer } from "../local-server.js";
+import { t } from "../i18n.js";
 
 export function createOpenLocalInboxTool(): AnyAgentTool {
   return {
     name: "clawsocial_open_local_inbox",
-    label: "ClawSocial 打开本地收件箱",
+    label: "ClawSocial Open Local Inbox",
     description:
       "Start the local inbox web UI and return its URL. The local inbox shows complete message history (no time limit) and supports replying. Only accessible from this machine. Call when the user wants to view full message history or open the local inbox.",
     parameters: Type.Object({}),
@@ -16,7 +17,7 @@ export function createOpenLocalInboxTool(): AnyAgentTool {
           type: "text",
           text: JSON.stringify({
             url,
-            message: `🦞 本地收件箱已启动（完整历史，仅限本机访问）：\n${url}\n\n浏览器打开即可查看全部消息记录并回复。`,
+            message: t("tools_local_inbox", { url }),
           }),
         }],
       };

package/src/tools/register.ts

@@ -2,20 +2,29 @@ import { Type } from "@sinclair/typebox";
 import type { AnyAgentTool } from "../types.js";
 import api from "../api.js";
 import { getState, setState } from "../store.js";
+import { reconnectWsClient } from "../ws-client.js";
+import { t } from "../i18n.js";
 
 export function createRegisterTool(): AnyAgentTool {
   return {
     name: "clawsocial_register",
-    label: "ClawSocial 注册",
+    label: "ClawSocial Register",
     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: "用户选择的龙虾公开名称" }),
+      public_name: Type.String({ description: "Public name for this lobster" }),
+      language_pref: Type.Optional(
+        Type.Unsafe<"zh" | "en">({
+          type: "string",
+          enum: ["zh", "en"],
+          description: "Language preference: zh (Chinese) or en (English). Default: en",
+        }),
+      ),
       availability: Type.Optional(
         Type.Unsafe<"open" | "by-request" | "closed">({
           type: "string",
           enum: ["open", "by-request", "closed"],
-          description: "可发现性，默认 open",
+          description: "Discoverability, default open",
         }),
       ),
     }),
@@ -30,9 +39,11 @@ export function createRegisterTool(): AnyAgentTool {
         return { content: [{ type: "text", text: JSON.stringify(result) }] };
       }
 
+      const langPref = (params.language_pref as string) ?? "en";
       const res = await api.register({
         public_name: params.public_name as string,
         availability: (params.availability as string) ?? "open",
+        language_pref: langPref,
       });
 
       setState({
@@ -40,13 +51,17 @@ export function createRegisterTool(): AnyAgentTool {
         api_key: res.api_key,
         token: res.token,
         public_name: res.public_name,
-        registered_at: Date.now(),
+        registered_at: Math.floor(Date.now() / 1000),
+        lang: langPref,
       });
 
+      // Start WebSocket connection now that credentials are available
+      reconnectWsClient();
+
       const result = {
         agent_id: res.agent_id,
         public_name: res.public_name,
-        message: `✅ 已成功注册 ClawSocial。你的龙虾名：${res.public_name}`,
+        message: t("tools_registered", { name: res.public_name }),
       };
       return { content: [{ type: "text", text: JSON.stringify(result) }] };
     },

package/src/tools/session_get.ts

@@ -1,17 +1,18 @@
 import { Type } from "@sinclair/typebox";
 import type { AnyAgentTool } from "../types.js";
 import { getSessions, markRead } from "../store.js";
+import { t, formatDateTime } from "../i18n.js";
 
 export function createSessionGetTool(serverUrl: string): AnyAgentTool {
   return {
     name: "clawsocial_session_get",
-    label: "ClawSocial 查看会话",
+    label: "ClawSocial View Session",
     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 二选一）" })),
+      session_id: Type.Optional(Type.String({ description: "Exact UUID (provide either this or partner_name)" })),
       partner_name: Type.Optional(
-        Type.String({ description: "按对方名称模糊匹配（与 session_id 二选一）" }),
+        Type.String({ description: "Fuzzy match by partner name (provide either this or session_id)" }),
       ),
     }),
     async execute(_id: string, params: Record<string, unknown>) {
@@ -33,7 +34,7 @@ export function createSessionGetTool(serverUrl: string): AnyAgentTool {
       if (!session) {
         const result = {
           found: false,
-          message: "未找到匹配的会话。使用 clawsocial_sessions_list 查看所有会话。",
+          message: t("tools_session_404"),
         };
         return { content: [{ type: "text", text: JSON.stringify(result) }] };
       }
@@ -43,7 +44,7 @@ export function createSessionGetTool(serverUrl: string): AnyAgentTool {
       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 ?? "未知");
+        : (session.partner_agent_id ?? t("unknown"));
       const messages = (session.messages ?? []).slice(-10);
       const sessionUrl = `${serverUrl}/inbox/session/${session.id}`;
 
@@ -52,12 +53,12 @@ export function createSessionGetTool(serverUrl: string): AnyAgentTool {
         partner_name: partnerDisplay,
         status: session.status,
         recent_messages: messages.map((m) => ({
-          from: m.from_self ? "我的龙虾" : partnerDisplay,
+          from: m.from_self ? t("tools_my_lobster") : partnerDisplay,
           content: m.content,
-          time: m.created_at ? new Date(m.created_at * 1000).toLocaleString("zh-CN") : "",
+          time: m.created_at ? formatDateTime(m.created_at) : "",
         })),
         session_url: sessionUrl,
-        tip: `在浏览器中查看：${sessionUrl}（需先通过 clawsocial_open_inbox 登录）`,
+        tip: `View in browser: ${sessionUrl} (login via clawsocial_open_inbox first)`,
       };
       return { content: [{ type: "text", text: JSON.stringify(result) }] };
     },

package/src/tools/session_send.ts

@@ -2,22 +2,23 @@ import { Type } from "@sinclair/typebox";
 import type { AnyAgentTool } from "../types.js";
 import api from "../api.js";
 import { addMessage } from "../store.js";
+import { t } from "../i18n.js";
 
 export function createSessionSendTool(): AnyAgentTool {
   return {
     name: "clawsocial_session_send",
-    label: "ClawSocial 发送消息",
+    label: "ClawSocial Send Message",
     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: "用户的消息，原样转发" }),
+      session_id: Type.String({ description: "Active session ID" }),
+      content: Type.String({ description: "User's message, forwarded verbatim" }),
     }),
     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 不能为空");
+      if (!session_id) throw new Error("session_id is required");
+      if (!content) throw new Error("content is required");
 
       const res = await api.sendMessage(session_id, { content, intent: "chat" });
 
@@ -32,7 +33,7 @@ export function createSessionSendTool(): AnyAgentTool {
       const result = {
         msg_id: res.msg_id,
         delivered: res.delivered,
-        message: res.delivered ? "✅ 消息已送达" : "📬 消息已入队（对方龙虾当前离线）",
+        message: res.delivered ? t("tools_msg_delivered") : t("tools_msg_queued"),
       };
       return { content: [{ type: "text", text: JSON.stringify(result) }] };
     },

package/src/tools/sessions_list.ts

@@ -1,11 +1,12 @@
 import { Type } from "@sinclair/typebox";
 import type { AnyAgentTool } from "../types.js";
 import { getSessions } from "../store.js";
+import { t, formatDateTime } from "../i18n.js";
 
 export function createSessionsListTool(serverUrl: string): AnyAgentTool {
   return {
     name: "clawsocial_sessions_list",
-    label: "ClawSocial 会话列表",
+    label: "ClawSocial Sessions List",
     description:
       "List all active sessions. Call when the user asks about their conversations or checks /sessions.",
     parameters: Type.Object({}),
@@ -16,7 +17,7 @@ export function createSessionsListTool(serverUrl: string): AnyAgentTool {
       if (list.length === 0) {
         const result = {
           sessions: [],
-          message: "暂无会话。使用 clawsocial_search 找到匹配的龙虾，发起连接。",
+          message: "No sessions yet. Use clawsocial_match to discover people by interest, or clawsocial_find to locate someone by name, then clawsocial_connect to start a conversation.",
         };
         return { content: [{ type: "text", text: JSON.stringify(result) }] };
       }
@@ -26,22 +27,22 @@ export function createSessionsListTool(serverUrl: string): AnyAgentTool {
         session_id: s.id,
         partner_name: s.partner_name
           ? `${s.partner_name} ${shortId(s.partner_agent_id)}`
-          : (s.partner_agent_id ?? "未知"),
+          : (s.partner_agent_id ?? t("unknown")),
         status: s.status,
         last_message: s.last_message
           ? s.last_message.slice(0, 60) + (s.last_message.length > 60 ? "..." : "")
-          : "（无消息）",
+          : t("inbox_no_preview"),
         unread: s.unread ?? 0,
         last_active: s.last_active_at
-          ? new Date(s.last_active_at * 1000).toLocaleString("zh-CN")
-          : "未知",
+          ? formatDateTime(s.last_active_at)
+          : t("unknown"),
       }));
 
       const result = {
         sessions: formatted,
         total: list.length,
         unread_total: list.reduce((sum, s) => sum + (s.unread ?? 0), 0),
-        tip: `使用 clawsocial_open_inbox 获取收件箱登录链接（${serverUrl}/inbox）`,
+        tip: `Use clawsocial_open_inbox to get an inbox login link (${serverUrl}/inbox)`,
       };
       return { content: [{ type: "text", text: JSON.stringify(result) }] };
     },

package/src/tools/suggest_profile.ts

@@ -33,7 +33,7 @@ function readLocalFiles(): LocalFiles {
 export function createSuggestProfileTool(): AnyAgentTool {
   return {
     name: "clawsocial_suggest_profile",
-    label: "ClawSocial 建议兴趣资料",
+    label: "ClawSocial Suggest Profile",
     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. " +

package/src/tools/update_profile.ts

@@ -2,11 +2,12 @@ import { Type } from "@sinclair/typebox";
 import type { AnyAgentTool } from "../types.js";
 import api from "../api.js";
 import { getState } from "../store.js";
+import { t } from "../i18n.js";
 
 export function createUpdateProfileTool(): AnyAgentTool {
   return {
     name: "clawsocial_update_profile",
-    label: "ClawSocial 更新资料",
+    label: "ClawSocial Update Profile",
     description:
       "Update your ClawSocial profile — interests, topic tags, availability, or public name. " +
       "Use when the user describes who they are, what they are interested in, or wants to change their profile.",
@@ -50,7 +51,7 @@ export function createUpdateProfileTool(): AnyAgentTool {
             {
               type: "text",
               text: JSON.stringify({
-                error: "尚未注册 ClawSocial，请先使用 clawsocial_register 注册。",
+                error: t("tools_not_registered"),
               }),
             },
           ],
@@ -69,7 +70,7 @@ export function createUpdateProfileTool(): AnyAgentTool {
           content: [
             {
               type: "text",
-              text: JSON.stringify({ error: "没有提供任何要更新的内容。" }),
+              text: JSON.stringify({ error: t("tools_no_update") }),
             },
           ],
         };
@@ -83,7 +84,7 @@ export function createUpdateProfileTool(): AnyAgentTool {
             type: "text",
             text: JSON.stringify({
               ok: true,
-              message: "✅ 资料已更新！其他人现在可以根据你的兴趣找到你了。",
+              message: t("tools_profile_updated"),
               updated: Object.keys(body),
             }),
           },

package/src/ws-client.ts

@@ -1,6 +1,7 @@
 import WebSocket from "ws";
 import { getState, upsertSession, getSession, addMessage, markRead, getSettings } from "./store.js";
 import { pushNotification } from "./notify.js";
+import { t } from "./i18n.js";
 
 let ws: WebSocket | null = null;
 let reconnectTimer: ReturnType<typeof setTimeout> | null = null;
@@ -22,7 +23,7 @@ function maybePush(detailText: string): void {
   const mode = getSettings().notifyMode;
   if (mode === "silent") return;
   if (mode === "minimal") {
-    pushNotification("[ClawSocial] 你有新消息，输入 /inbox 查看或打开收件箱。");
+    pushNotification(t("ws_new_msg_notify"));
     return;
   }
   pushNotification(detailText);
@@ -31,11 +32,11 @@ function maybePush(detailText: string): void {
 function handleServerMessage(msg: Record<string, unknown>): void {
   switch (msg.type) {
     case "auth_ok":
-      log(`认证成功: ${msg.agent_id}`);
+      log(`${t("ws_auth_ok")}: ${msg.agent_id}`);
       break;
 
     case "auth_error":
-      console.error(`[ClawSocial WS] 认证失败: ${msg.error}`);
+      console.error(`[ClawSocial WS] ${t("ws_auth_fail")}: ${msg.error}`);
       break;
 
     case "ping":
@@ -44,36 +45,32 @@ function handleServerMessage(msg: Record<string, unknown>): void {
 
     case "connect_request": {
       const sid = msg.session_id as string;
+      const name = msg.from_agent_name as string;
       upsertSession(sid, {
         status: "pending",
         is_receiver: true,
         partner_agent_id: msg.from_agent_id as string,
-        partner_name: msg.from_agent_name as string,
+        partner_name: name,
         intro_message: (msg.intro_message as string) || "",
         messages: [],
         unread: 0,
         created_at: Math.floor(Date.now() / 1000),
       });
-      log(
-        `收到连接请求！来自：${msg.from_agent_name}${shortId(msg.from_agent_id as string)}。请调用 clawsocial_open_inbox 查看收件箱。`,
-      );
-      maybePush(
-        `[ClawSocial] 收到来自 ${msg.from_agent_name} 的连接请求。可调用 clawsocial_open_inbox 查看。`,
-      );
+      log(t("ws_connect_req", { name: `${name}${shortId(msg.from_agent_id as string)}` }));
+      maybePush(t("ws_connect_req_notify", { name }));
       break;
     }
 
     case "session_started": {
       const sid = msg.session_id as string;
+      const name = msg.with_agent_name as string;
       upsertSession(sid, {
         status: "active",
         partner_agent_id: msg.with_agent_id as string,
-        partner_name: msg.with_agent_name as string,
+        partner_name: name,
       });
-      log(`${msg.with_agent_name}${shortId(msg.with_agent_id as string)} 接受了连接请求，会话 ID：${sid}`);
-      maybePush(
-        `[ClawSocial] ${msg.with_agent_name} 开始了与你的会话。可调用 clawsocial_session_get 查看消息。`,
-      );
+      log(t("ws_session_accepted", { name: `${name}${shortId(msg.with_agent_id as string)}`, id: sid }));
+      maybePush(t("ws_session_notify", { name }));
       break;
     }
 
@@ -102,12 +99,8 @@ function handleServerMessage(msg: Record<string, unknown>): void {
         intent: msg.intent as string | undefined,
         created_at: (msg.created_at as number) || Math.floor(Date.now() / 1000),
       });
-      log(
-        `来自 ${partnerName}${shortId(msg.from_agent as string)}：${(msg.content as string).slice(0, 60)}`,
-      );
-      maybePush(
-        `[ClawSocial] 收到 ${partnerName} 的新消息：${(msg.content as string).slice(0, 80)}`,
-      );
+      log(t("ws_msg_log", { name: `${partnerName}${shortId(msg.from_agent as string)}`, preview: (msg.content as string).slice(0, 60) }));
+      maybePush(t("ws_msg_notify", { name: partnerName, preview: (msg.content as string).slice(0, 80) }));
       break;
     }
 
@@ -130,7 +123,7 @@ export function startWsClient(serverUrl: string): void {
 function connect(): void {
   const state = getState();
   if (!state.agent_id || !state.api_key) {
-    log("尚未注册，跳过 WS 连接");
+    log(t("ws_not_registered"));
     return;
   }
 
@@ -140,7 +133,7 @@ function connect(): void {
 
   ws.on("open", () => {
     const s = getState();
-    log("已连接服务器");
+    log(t("ws_connected"));
     ws!.send(JSON.stringify({ type: "auth", agent_id: s.agent_id, api_key: s.api_key }));
   });
 
@@ -155,13 +148,13 @@ function connect(): void {
   });
 
   ws.on("close", (code: number) => {
-    log(`连接断开 (${code})，5s 后重连`);
+    log(`${t("ws_disconnected")} (${code}), ${t("ws_reconnect")}`);
     ws = null;
     reconnectTimer = setTimeout(connect, 5000);
   });
 
   ws.on("error", (err: Error) => {
-    console.error("[ClawSocial WS] 错误:", err.message);
+    console.error("[ClawSocial WS] Error:", err.message);
   });
 }
 

package/tsconfig.json

@@ -1,13 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "NodeNext",
-    "moduleResolution": "NodeNext",
-    "strict": true,
-    "noEmit": true,
-    "esModuleInterop": true,
-    "skipLibCheck": true
-  },
-  "include": ["**/*.ts"],
-  "exclude": ["node_modules"]
-}