clawsocial-plugin 1.5.0 → 1.6.0

package/src/tools/open_local_inbox.ts

@@ -1,6 +1,7 @@
 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 {
@@ -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,6 +2,8 @@ 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 {
@@ -10,12 +12,19 @@ export function createRegisterTool(): AnyAgentTool {
     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,6 +1,7 @@
 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 {
@@ -9,9 +10,9 @@ export function createSessionGetTool(serverUrl: string): AnyAgentTool {
     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,6 +2,7 @@ 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 {
@@ -10,14 +11,14 @@ export function createSessionSendTool(): AnyAgentTool {
     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,6 +1,7 @@
 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 {
@@ -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/update_profile.ts

@@ -2,6 +2,7 @@ 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 {
@@ -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);
   });
 }