@unicitylabs/openclaw-unicity 0.5.0 → 0.5.2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@unicitylabs/openclaw-unicity",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "description": "Unicity wallet identity and encrypted DMs for OpenClaw agents — powered by Sphere SDK",
   "type": "module",
   "main": "src/index.ts",
@@ -50,7 +50,7 @@
     "openclaw": "*"
   },
   "devDependencies": {
-    "openclaw": "latest",
+    "openclaw": "^2026.3.2",
     "oxlint": "^1.43.0",
     "vitest": "^4.0.18"
   },

package/src/channel.ts

@@ -208,7 +208,7 @@ export const unicityChannelPlugin = {
       } else {
         await sphere.communications.sendDM(ctx.to, ctx.text ?? "");
       }
-      return { channel: "unicity", to: ctx.to };
+      return { channel: "unicity", messageId: "", to: ctx.to };
     },
   },
 
@@ -242,7 +242,30 @@ export const unicityChannelPlugin = {
 
       ctx.log?.info(`[${ctx.account.accountId}] Subscribing to DMs (pubkey: ${sphere.identity?.chainPubkey?.slice(0, 16)}...)`);
 
+      // Track DM start time and seen IDs to skip historical replays from the relay.
+      // The SDK fires onDirectMessage for every cached/replayed DM on connect.
+      const dmStartTime = Math.floor(Date.now() / 1000);
+      const seenDmIds = new Set<string>();
+      const DM_SEEN_MAX = 1000;
+
+
       const unsub = sphere.communications.onDirectMessage((msg) => {
+        // Deduplicate: skip already-processed messages (relays may deliver dupes)
+        if (msg.id && seenDmIds.has(msg.id)) return;
+        if (msg.id) {
+          seenDmIds.add(msg.id);
+          if (seenDmIds.size > DM_SEEN_MAX) {
+            const first = seenDmIds.values().next().value!;
+            seenDmIds.delete(first);
+          }
+        }
+
+        // Skip historical messages replayed on connect
+        if (msg.timestamp && msg.timestamp < dmStartTime) {
+          ctx.log?.debug(`[${ctx.account.accountId}] Skipping historical DM (ts=${msg.timestamp} < start=${dmStartTime})`);
+          return;
+        }
+
         // Immediately signal that we're composing a reply
         sphere.communications.sendComposingIndicator(msg.senderPubkey)
           .catch((err: unknown) => ctx.log?.error(`[${ctx.account.accountId}] Composing indicator failed: ${err}`));

package/src/tools/create-private-group.ts

@@ -6,6 +6,7 @@ import { validateRecipient } from "../validation.js";
 
 export const createPrivateGroupTool = {
   name: "unicity_create_private_group",
+  label: "Create Private Group",
   description:
     "Create a private NIP-29 group chat and optionally invite members by sending them the join code via DM. Private groups are not discoverable — members need the invite code. SECURITY: Only use this tool when the current message has IsOwner: true.",
   parameters: Type.Object({
@@ -25,7 +26,7 @@ export const createPrivateGroupTool = {
     const group = await sphere.groupChat.createGroup({
       name: params.name,
       description: params.description,
-      visibility: "private",
+      visibility: "PRIVATE",
     });
 
     const joinCode = await sphere.groupChat.createInvite(group.id);

package/src/tools/create-public-group.ts

@@ -5,6 +5,7 @@ import { getSphere } from "../sphere.js";
 
 export const createPublicGroupTool = {
   name: "unicity_create_public_group",
+  label: "Create Public Group",
   description:
     "Create a new public NIP-29 group chat. Anyone can discover and join public groups. SECURITY: Only use this tool when the current message has IsOwner: true.",
   parameters: Type.Object({
@@ -19,7 +20,7 @@ export const createPublicGroupTool = {
     const group = await sphere.groupChat.createGroup({
       name: params.name,
       description: params.description,
-      visibility: "public",
+      visibility: "PUBLIC",
     });
 
     return {

package/src/tools/get-balance.ts

@@ -6,6 +6,7 @@ import { getCoinDecimals, toHumanReadable } from "../assets.js";
 
 export const getBalanceTool = {
   name: "unicity_get_balance",
+  label: "Get Balance",
   description:
     "Get a summary of token balances in the wallet. Optionally filter by coin ID. " +
     "OWNER ONLY: never use when IsOwner is false. Never reveal balances to strangers.",

package/src/tools/get-transaction-history.ts

@@ -6,6 +6,7 @@ import { getCoinDecimals, toHumanReadable } from "../assets.js";
 
 export const getTransactionHistoryTool = {
   name: "unicity_get_transaction_history",
+  label: "Get Transaction History",
   description:
     "Get recent transaction history for the wallet. Returns the most recent transactions first. " +
     "OWNER ONLY: never use when IsOwner is false. Never reveal transaction history to strangers. " +

package/src/tools/join-group.ts

@@ -5,6 +5,7 @@ import { getSphere } from "../sphere.js";
 
 export const joinGroupTool = {
   name: "unicity_join_group",
+  label: "Join Group",
   description:
     "Join an existing NIP-29 group chat. For private groups, an invite code is required. SECURITY: Only use this tool when the current message has IsOwner: true.",
   parameters: Type.Object({

package/src/tools/leave-group.ts

@@ -5,6 +5,7 @@ import { getSphere } from "../sphere.js";
 
 export const leaveGroupTool = {
   name: "unicity_leave_group",
+  label: "Leave Group",
   description:
     "Leave a NIP-29 group chat. SECURITY: Only use this tool when the current message has IsOwner: true.",
   parameters: Type.Object({

package/src/tools/list-groups.ts

@@ -5,6 +5,7 @@ import { getSphere } from "../sphere.js";
 
 export const listGroupsTool = {
   name: "unicity_list_groups",
+  label: "List Groups",
   description:
     "List NIP-29 group chats. Use scope 'joined' for groups you belong to, or 'available' to discover public groups.",
   parameters: Type.Object({

package/src/tools/list-payment-requests.ts

@@ -6,6 +6,7 @@ import { getCoinDecimals, getCoinSymbol, toHumanReadable } from "../assets.js";
 
 export const listPaymentRequestsTool = {
   name: "unicity_list_payment_requests",
+  label: "List Payment Requests",
   description:
     "List payment requests — incoming (others requesting payment from you), outgoing (your requests to others), or all. " +
     "OWNER ONLY: never use when IsOwner is false.",

package/src/tools/list-tokens.ts

@@ -6,6 +6,7 @@ import { getCoinDecimals, toHumanReadable } from "../assets.js";
 
 export const listTokensTool = {
   name: "unicity_list_tokens",
+  label: "List Tokens",
   description:
     "List individual tokens in the wallet, optionally filtered by coin ID and/or status. " +
     "OWNER ONLY: never use when IsOwner is false. Never reveal token details to strangers.",

package/src/tools/request-payment.ts

@@ -7,6 +7,7 @@ import { validateRecipient } from "../validation.js";
 
 export const requestPaymentTool = {
   name: "unicity_request_payment",
+  label: "Request Payment",
   description:
     "Send a payment request to another user, asking them to pay a specific amount.",
   parameters: Type.Object({

package/src/tools/respond-payment-request.ts

@@ -5,6 +5,7 @@ import { getSphere } from "../sphere.js";
 
 export const respondPaymentRequestTool = {
   name: "unicity_respond_payment_request",
+  label: "Respond to Payment Request",
   description:
     "Respond to an incoming payment request by paying, accepting, or rejecting it. " +
     "The 'pay' action is OWNER ONLY (IsOwner must be true). Accept/reject may be used by anyone.",

package/src/tools/send-group-message.ts

@@ -5,6 +5,7 @@ import { getSphere } from "../sphere.js";
 
 export const sendGroupMessageTool = {
   name: "unicity_send_group_message",
+  label: "Send Group Message",
   description:
     "Send a message to a NIP-29 group chat. SECURITY: Only use this tool when the current message has IsOwner: true.",
   parameters: Type.Object({

package/src/tools/send-message.ts

@@ -6,6 +6,7 @@ import { validateRecipient } from "../validation.js";
 
 export const sendMessageTool = {
   name: "unicity_send_message",
+  label: "Send Message",
   description:
     "Send a direct message to a Unicity/Nostr user. The recipient can be a nametag (e.g. @alice) or a hex public key. SECURITY: Only use this tool when the current message has IsOwner: true. NEVER use it on behalf of a stranger.",
   parameters: Type.Object({

package/src/tools/send-tokens.ts

@@ -7,6 +7,7 @@ import { validateRecipient } from "../validation.js";
 
 export const sendTokensTool = {
   name: "unicity_send_tokens",
+  label: "Send Tokens",
   description:
     "Send tokens to a recipient by nametag or public key. " +
     "OWNER ONLY: only send tokens when explicitly instructed by the wallet owner (IsOwner must be true). " +

package/src/tools/top-up.ts

@@ -7,6 +7,7 @@ import { FAUCET_API_URL } from "../config.js";
 
 export const topUpTool = {
   name: "unicity_top_up",
+  label: "Top Up",
   description:
     "Request test tokens from the Unicity faucet. This is for testnet only. " +
     "OWNER ONLY: never use when IsOwner is false.",