@aight-cool/aight-utils 0.1.5 → 0.1.7

package/index.ts

@@ -13,6 +13,7 @@ import { registerBootstrap } from "./src/bootstrap.js";
 import { registerPushHook } from "./src/push-hook.js";
 import { registerHealth } from "./src/health.js";
 import { registerVersion } from "./src/version.js";
+import { registerGroupRpc } from "./src/groups.js";
 
 const aightPlugin = {
   id: "aight-utils",
@@ -66,6 +67,7 @@ const aightPlugin = {
     registerPushHook(api);
     registerHealth(api);
     registerVersion(api);
+    registerGroupRpc(api);
 
     api.logger.info("[aight-utils] Plugin loaded");
   },

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "aight-utils",
   "name": "Aight App Utils",
   "description": "Aight App: Push notifications, Today items, config RPC, and agent bootstrap",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aight-cool/aight-utils",
-  "version": "0.1.5",
+  "version": "0.1.7",
   "description": "OpenClaw gateway plugin for Aight App: push notifications, Today items, config RPC, and agent bootstrap",
   "type": "module",
   "files": [

package/src/groups.ts

@@ -0,0 +1,69 @@
+/**
+ * Group name store — simple mapping of groupId → display name.
+ * The app registers group names via RPC so push notifications
+ * can show friendly titles instead of raw IDs.
+ */
+
+import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
+import { readFileSync, writeFileSync, mkdirSync } from "fs";
+import { join } from "path";
+
+const FILENAME = "group-names.json";
+
+function filePath(api: OpenClawPluginApi): string {
+  const dir = (api as any).dataDir ?? join(process.env.HOME ?? "/tmp", ".openclaw", "plugin-data", "aight-utils");
+  mkdirSync(dir, { recursive: true });
+  return join(dir, FILENAME);
+}
+
+function loadAll(api: OpenClawPluginApi): Record<string, string> {
+  try {
+    return JSON.parse(readFileSync(filePath(api), "utf-8"));
+  } catch {
+    return {};
+  }
+}
+
+function saveAll(api: OpenClawPluginApi, data: Record<string, string>): void {
+  writeFileSync(filePath(api), JSON.stringify(data), "utf-8");
+}
+
+export function loadGroupName(api: OpenClawPluginApi, groupId: string): string | undefined {
+  return loadAll(api)[groupId];
+}
+
+export function registerGroupName(api: OpenClawPluginApi, groupId: string, name: string): void {
+  const data = loadAll(api);
+  data[groupId] = name;
+  saveAll(api, data);
+}
+
+export function removeGroupName(api: OpenClawPluginApi, groupId: string): void {
+  const data = loadAll(api);
+  delete data[groupId];
+  saveAll(api, data);
+}
+
+export function registerGroupRpc(api: OpenClawPluginApi): void {
+  api.registerGatewayMethod("aight.groups.setName", ({ params, respond }: any) => {
+    const { groupId, name } = (params ?? {}) as { groupId?: string; name?: string };
+    if (!groupId || !name) {
+      respond(false, { error: "groupId and name are required" });
+      return;
+    }
+    registerGroupName(api, groupId, name);
+    respond(true, { ok: true });
+  });
+
+  api.registerGatewayMethod("aight.groups.removeName", ({ params, respond }: any) => {
+    const { groupId } = (params ?? {}) as { groupId?: string };
+    if (!groupId) {
+      respond(false, { error: "groupId is required" });
+      return;
+    }
+    removeGroupName(api, groupId);
+    respond(true, { ok: true });
+  });
+
+  api.logger.info("[aight-utils] Group name RPC registered");
+}

package/src/push-hook.ts

@@ -5,6 +5,7 @@
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
 import { getPluginConfig } from "./config.js";
 import { sendPush, loadTokens } from "./push.js";
+import { loadGroupName } from "./groups.js";
 
 export function registerPushHook(api: OpenClawPluginApi) {
   try {
@@ -61,14 +62,31 @@ export function registerPushHook(api: OpenClawPluginApi) {
       const agent = agents.find((a: any) => a.id === agentId);
       const displayName = agent?.name ?? agent?.identity?.name ?? agentId;
 
+      // Resolve group chat name for push subtitle (WhatsApp-style layout)
+      let pushTitle = displayName;
+      let pushSubtitle: string | undefined;
+      const sessionKey = ctx.sessionKey ?? "";
+      if (sessionKey.includes(":group-chat:")) {
+        const groupId = sessionKey.split(":group-chat:")[1];
+        if (groupId) {
+          const groupName = loadGroupName(api, groupId);
+          if (groupName) {
+            pushSubtitle = groupName;
+          }
+        }
+      }
+
+      const cleanBody = preview.trim().replace(/\n+/g, " ").trim();
+
       for (const device of tokens) {
         if (!device.sendKey) continue;
         try {
           await sendPush(
             device.deviceId,
             {
-              title: displayName,
-              body: preview,
+              title: pushTitle.trim(),
+              subtitle: pushSubtitle,
+              body: cleanBody,
               data: { sessionKey: ctx.sessionKey, agentId },
             },
             freshConfig,

package/src/push.ts

@@ -87,6 +87,7 @@ async function obtainSendKey(relayUrl: string, pushToken: string): Promise<strin
 
 export interface PushPayload {
   title?: string;
+  subtitle?: string;
   body?: string;
   data?: Record<string, unknown>;
   silent?: boolean;
@@ -118,6 +119,7 @@ export async function sendPush(
 
   if (mode === "rich" && !payload.silent) {
     pushBody.title = payload.title;
+    if (payload.subtitle) pushBody.subtitle = payload.subtitle;
     pushBody.body = payload.body;
   }