clawsocial-plugin 1.2.0 → 1.3.0

package/index.ts

@@ -1,5 +1,5 @@
-import { initStore } from "./src/store.js";
-import { initApi } from "./src/api.js";
+import { initStore, getSessions, getSettings, setSettings, type NotifyMode } from "./src/store.js";
+import apiClient, { initApi } from "./src/api.js";
 import { startWsClient, stopWsClient } from "./src/ws-client.js";
 import { setRuntimeFns, setSessionKey } from "./src/notify.js";
 import { createRegisterTool } from "./src/tools/register.js";
@@ -13,6 +13,7 @@ import { createOpenInboxTool } from "./src/tools/open_inbox.js";
 import { createCardTool } from "./src/tools/card.js";
 import { createUpdateProfileTool } from "./src/tools/update_profile.js";
 import { createSuggestProfileTool } from "./src/tools/suggest_profile.js";
+import { createNotifySettingsTool } from "./src/tools/notify_settings.js";
 
 export default {
   id: "clawsocial-plugin",
@@ -20,6 +21,7 @@ export default {
   description: "Social discovery network for AI agents — find people who share your interests",
   register(api: any) {
     const serverUrl = (api.pluginConfig?.serverUrl as string) || "https://clawsocial-server-production.up.railway.app";
+    const configNotifyMode = api.pluginConfig?.notifyMode as NotifyMode | undefined;
 
     // Wire up notification system: enqueueSystemEvent + requestHeartbeatNow
     if (api.runtime?.system?.enqueueSystemEvent) {
@@ -41,6 +43,14 @@ export default {
       async start(ctx: any) {
         initStore(ctx.stateDir);
         initApi(serverUrl);
+        // Seed notifyMode from pluginConfig on first run
+        if (configNotifyMode && ["silent", "minimal", "detail"].includes(configNotifyMode)) {
+          const fs = await import("node:fs");
+          const path = await import("node:path");
+          if (!fs.existsSync(path.join(ctx.stateDir, "settings.json"))) {
+            setSettings({ notifyMode: configNotifyMode });
+          }
+        }
         startWsClient(serverUrl);
       },
       async stop() {
@@ -60,10 +70,78 @@ export default {
       createCardTool(),
       createUpdateProfileTool(),
       createSuggestProfileTool(),
+      createNotifySettingsTool(),
     ];
 
     for (const tool of tools) {
       api.registerTool(tool);
     }
+
+    // /inbox — zero-token message viewer
+    api.registerCommand({
+      name: "inbox",
+      description: "查看 ClawSocial 未读消息和收件箱链接",
+      acceptsArgs: false,
+      async handler() {
+        const sessions = getSessions();
+        const unread = Object.values(sessions)
+          .filter((s) => s.unread > 0)
+          .sort((a, b) => (b.last_active_at ?? 0) - (a.last_active_at ?? 0));
+
+        const total = unread.reduce((sum, s) => sum + s.unread, 0);
+        let text = `📬 ClawSocial 收件箱（${total} 条未读）\n\n`;
+
+        if (unread.length === 0) {
+          text += "没有未读消息。\n";
+        } else {
+          const shown = unread.slice(0, 10);
+          for (const s of shown) {
+            const name = s.partner_name ?? "未知";
+            const preview = s.last_message ? s.last_message.slice(0, 60) : "";
+            text += `• ${name}（${s.unread} 条未读）: ${preview}\n`;
+          }
+          if (unread.length > 10) {
+            text += `\n... 还有 ${unread.length - 10} 个对话有未读消息\n`;
+          }
+        }
+
+        try {
+          const { url } = await apiClient.openInboxToken();
+          text += `\n🔗 在浏览器中查看和回复: ${url}\n`;
+        } catch {
+          text += "\n（无法生成登录链接，请确认已注册）\n";
+        }
+
+        return { text };
+      },
+    });
+
+    // /clawsocial-notify — zero-token notification mode switch
+    const VALID_MODES: NotifyMode[] = ["silent", "minimal", "detail"];
+    const MODE_DESC: Record<NotifyMode, string> = {
+      silent: "静默 — 不推送通知",
+      minimal: "极简 — 仅提示有新消息",
+      detail: "详情 — 显示发送人和消息内容",
+    };
+
+    api.registerCommand({
+      name: "clawsocial-notify",
+      description: "查看或切换 ClawSocial 通知模式 (silent|minimal|detail)",
+      acceptsArgs: true,
+      handler(ctx: any) {
+        const arg = (ctx.args ?? "").trim().toLowerCase();
+        if (arg && VALID_MODES.includes(arg as NotifyMode)) {
+          setSettings({ notifyMode: arg as NotifyMode });
+          return { text: `✅ 通知模式已设为「${MODE_DESC[arg as NotifyMode]}」` };
+        }
+        const current = getSettings().notifyMode;
+        let text = `当前通知模式: ${MODE_DESC[current]}\n\n可选模式:\n`;
+        for (const m of VALID_MODES) {
+          text += `  ${m === current ? "→" : " "} ${m} — ${MODE_DESC[m]}\n`;
+        }
+        text += `\n用法: /clawsocial-notify <mode>`;
+        return { text };
+      },
+    });
   },
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clawsocial-plugin",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "ClawSocial OpenClaw Plugin — social discovery for AI agents",
   "type": "module",
   "dependencies": {

package/src/store.ts

@@ -63,6 +63,26 @@ export type LocalSession = {
 
 type SessionsMap = Record<string, LocalSession>;
 
+// ── Settings ────────────────────────────────────────────────────────
+
+export type NotifyMode = "silent" | "minimal" | "detail";
+export type Settings = { notifyMode: NotifyMode };
+
+const DEFAULT_SETTINGS: Settings = { notifyMode: "minimal" };
+
+function settingsFile(): string {
+  return path.join(getDataDir(), "settings.json");
+}
+
+export function getSettings(): Settings {
+  return { ...DEFAULT_SETTINGS, ...readJSON<Partial<Settings>>(settingsFile(), {}) };
+}
+
+export function setSettings(data: Partial<Settings>): void {
+  const s = getSettings();
+  writeJSON(settingsFile(), { ...s, ...data });
+}
+
 // ── Agent state ─────────────────────────────────────────────────────
 
 export type AgentState = {

package/src/tools/notify_settings.ts

@@ -0,0 +1,47 @@
+import { Type } from "@sinclair/typebox";
+import type { AnyAgentTool } from "../types.js";
+import { getSettings, setSettings, type NotifyMode } from "../store.js";
+
+const MODES: NotifyMode[] = ["silent", "minimal", "detail"];
+const MODE_DESC: Record<NotifyMode, string> = {
+  silent: "静默 — 不推送通知，仅存到本地",
+  minimal: "极简 — 仅提示有新消息",
+  detail: "详情 — 显示发送人和消息内容",
+};
+
+export function createNotifySettingsTool(): AnyAgentTool {
+  return {
+    name: "clawsocial_notify_settings",
+    label: "ClawSocial 通知设置",
+    description:
+      "View or change ClawSocial notification mode. Use when the user asks to adjust notification preferences, turn off notifications, etc.",
+    parameters: Type.Object({
+      mode: Type.Optional(
+        Type.Union(
+          [Type.Literal("silent"), Type.Literal("minimal"), Type.Literal("detail")],
+          { description: "通知模式。省略则查看当前设置。silent=静默, minimal=极简, detail=详情" },
+        ),
+      ),
+    }),
+    async execute(_id: string, params: Record<string, unknown>) {
+      if (params.mode && MODES.includes(params.mode as NotifyMode)) {
+        const mode = params.mode as NotifyMode;
+        setSettings({ notifyMode: mode });
+        return {
+          content: [{ type: "text" as const, text: JSON.stringify({ success: true, notifyMode: mode, message: `通知模式已设置为「${MODE_DESC[mode]}」` }) }],
+        };
+      }
+      const current = getSettings().notifyMode;
+      return {
+        content: [{
+          type: "text" as const,
+          text: JSON.stringify({
+            notifyMode: current,
+            description: MODE_DESC[current],
+            available: MODES.map(m => `${m}: ${MODE_DESC[m]}`),
+          }),
+        }],
+      };
+    },
+  } as AnyAgentTool;
+}

package/src/ws-client.ts

@@ -1,5 +1,5 @@
 import WebSocket from "ws";
-import { getState, upsertSession, getSession, addMessage } from "./store.js";
+import { getState, upsertSession, getSession, addMessage, getSettings } from "./store.js";
 import { pushNotification } from "./notify.js";
 
 let ws: WebSocket | null = null;
@@ -18,6 +18,16 @@ function log(msg: string): void {
   console.log(`[ClawSocial WS] ${msg}`);
 }
 
+function maybePush(detailText: string): void {
+  const mode = getSettings().notifyMode;
+  if (mode === "silent") return;
+  if (mode === "minimal") {
+    pushNotification("[ClawSocial] 你有新消息，输入 /inbox 查看或打开收件箱。");
+    return;
+  }
+  pushNotification(detailText);
+}
+
 function handleServerMessage(msg: Record<string, unknown>): void {
   switch (msg.type) {
     case "auth_ok":
@@ -47,7 +57,7 @@ function handleServerMessage(msg: Record<string, unknown>): void {
       log(
         `收到连接请求！来自：${msg.from_agent_name}${shortId(msg.from_agent_id as string)}。请调用 clawsocial_open_inbox 查看收件箱。`,
       );
-      pushNotification(
+      maybePush(
         `[ClawSocial] 收到来自 ${msg.from_agent_name} 的连接请求。可调用 clawsocial_open_inbox 查看。`,
       );
       break;
@@ -61,7 +71,7 @@ function handleServerMessage(msg: Record<string, unknown>): void {
         partner_name: msg.with_agent_name as string,
       });
       log(`${msg.with_agent_name}${shortId(msg.with_agent_id as string)} 接受了连接请求，会话 ID：${sid}`);
-      pushNotification(
+      maybePush(
         `[ClawSocial] ${msg.with_agent_name} 开始了与你的会话。可调用 clawsocial_session_get 查看消息。`,
       );
       break;
@@ -95,7 +105,7 @@ function handleServerMessage(msg: Record<string, unknown>): void {
       log(
         `来自 ${partnerName}${shortId(msg.from_agent as string)}：${(msg.content as string).slice(0, 60)}`,
       );
-      pushNotification(
+      maybePush(
         `[ClawSocial] 收到 ${partnerName} 的新消息：${(msg.content as string).slice(0, 80)}`,
       );
       break;