@openclaw/buzz 2026.8.1-beta.2 → 2026.9.1-beta.1

package/node_modules/nostr-tools/lib/types/core.d.ts

@@ -24,6 +24,11 @@ export interface VerifiedEvent extends Event {
     [verifiedSymbol]: true;
 }
 export declare function validateEvent<T>(event: T): event is T & UnsignedEvent;
+/**
+ * Compare events in reverse-chronological order by the `created_at` timestamp,
+ * and then by the event `id` (lexicographically) in case of ties.
+ */
+export declare function compareEvents(a: Event, b: Event): number;
 /**
  * Sort events in reverse-chronological order by the `created_at` timestamp,
  * and then by the event `id` (lexicographically) in case of ties.

package/node_modules/nostr-tools/lib/types/nip29.d.ts

@@ -19,9 +19,16 @@ export type GroupMetadata = {
     pubkey: string;
     name?: string;
     picture?: string;
+    banner?: string;
     about?: string;
-    isPublic?: boolean;
-    isOpen?: boolean;
+    isPrivate?: boolean;
+    isRestricted?: boolean;
+    isHidden?: boolean;
+    isClosed?: boolean;
+    hasLiveKit?: boolean;
+    supportedKinds?: string[];
+    parent?: string;
+    children?: string[];
 };
 /**
  * Represents a NIP29 group reference.
@@ -63,7 +70,8 @@ export declare enum GroupAdminPermission {
     PutUser = "put-user",
     CreateGroup = "create-group",
     DeleteGroup = "delete-group",
-    CreateInvite = "create-invite"
+    CreateInvite = "create-invite",
+    UpdatePinList = "update-pin-list"
 }
 /**
  * Generates a group metadata event template.
@@ -196,6 +204,57 @@ export declare function fetchGroupMembersEvent({ pool, groupReference, relayInfo
     normalizedRelayURL?: string;
     relayInformation?: RelayInformation;
 }): Promise<Event>;
+/**
+ * Fetches the group roles event from the specified pool.
+ *
+ * @param {Object} options - The options object.
+ * @param {AbstractSimplePool} options.pool - The pool object.
+ * @param {GroupReference} options.groupReference - The group reference object.
+ * @param {string} [options.normalizedRelayURL] - The normalized relay URL.
+ * @param {RelayInformation} [options.relayInformation] - The relay information object.
+ * @returns {Promise<Event>} The group roles event that can be parsed later to get the group roles object.
+ * @throws {Error} If the group roles event is not found.
+ */
+export declare function fetchGroupRolesEvent({ pool, groupReference, relayInformation, normalizedRelayURL, }: {
+    pool: AbstractSimplePool;
+    groupReference: GroupReference;
+    normalizedRelayURL?: string;
+    relayInformation?: RelayInformation;
+}): Promise<Event>;
+/**
+ * Fetches the group livekit participants event from the specified pool.
+ *
+ * @param {Object} options - The options object.
+ * @param {AbstractSimplePool} options.pool - The pool object.
+ * @param {GroupReference} options.groupReference - The group reference object.
+ * @param {string} [options.normalizedRelayURL] - The normalized relay URL.
+ * @param {RelayInformation} [options.relayInformation] - The relay information object.
+ * @returns {Promise<Event>} The group livekit participants event that can be parsed later to get the participants.
+ * @throws {Error} If the group livekit participants event is not found.
+ */
+export declare function fetchGroupLivekitParticipantsEvent({ pool, groupReference, relayInformation, normalizedRelayURL, }: {
+    pool: AbstractSimplePool;
+    groupReference: GroupReference;
+    normalizedRelayURL?: string;
+    relayInformation?: RelayInformation;
+}): Promise<Event>;
+/**
+ * Fetches the group pinned events event from the specified pool.
+ *
+ * @param {Object} options - The options object.
+ * @param {AbstractSimplePool} options.pool - The pool object.
+ * @param {GroupReference} options.groupReference - The group reference object.
+ * @param {string} [options.normalizedRelayURL] - The normalized relay URL.
+ * @param {RelayInformation} [options.relayInformation] - The relay information object.
+ * @returns {Promise<Event>} The group pinned events event that can be parsed later to get the pinned events.
+ * @throws {Error} If the group pinned events event is not found.
+ */
+export declare function fetchGroupPinnedEventsEvent({ pool, groupReference, relayInformation, normalizedRelayURL, }: {
+    pool: AbstractSimplePool;
+    groupReference: GroupReference;
+    normalizedRelayURL?: string;
+    relayInformation?: RelayInformation;
+}): Promise<Event>;
 /**
  * Parses a group members event and returns an array of GroupMember objects.
  * @param event - The event to parse.
@@ -203,6 +262,187 @@ export declare function fetchGroupMembersEvent({ pool, groupReference, relayInfo
  * @throws Throws an error if the group members event is invalid.
  */
 export declare function parseGroupMembersEvent(event: Event): GroupMember[];
+/**
+ * Represents a NIP29 group role.
+ */
+export type GroupRole = {
+    name: string;
+    description?: string;
+};
+/**
+ * Generates an event template for the roles supported by a group.
+ *
+ * @param group - The group object.
+ * @param roles - An array of group roles.
+ * @returns The generated event template with the group roles that can be signed later.
+ */
+export declare function generateGroupRolesEventTemplate(group: Group, roles: GroupRole[]): EventTemplate;
+/**
+ * Validates a group roles event.
+ *
+ * @param event - The event to validate.
+ * @returns True if the event is a valid group roles event, false otherwise.
+ */
+export declare function validateGroupRolesEvent(event: Event): boolean;
+/**
+ * Parses a group roles event and returns an array of GroupRole objects.
+ *
+ * @param event - The event to parse.
+ * @returns An array of GroupRole objects.
+ * @throws Throws an error if the group roles event is invalid.
+ */
+export declare function parseGroupRolesEvent(event: Event): GroupRole[];
+/**
+ * Generates an event template for the livekit participants of a group.
+ *
+ * @param group - The group object.
+ * @param participants - An array of pubkeys currently live in the group's AV rooms.
+ * @returns The generated event template with the livekit participants that can be signed later.
+ */
+export declare function generateGroupLivekitParticipantsEventTemplate(group: Group, participants: string[]): EventTemplate;
+/**
+ * Validates a group livekit participants event.
+ *
+ * @param event - The event to validate.
+ * @returns True if the event is a valid group livekit participants event, false otherwise.
+ */
+export declare function validateGroupLivekitParticipantsEvent(event: Event): boolean;
+/**
+ * Parses a group livekit participants event and returns an array of participant pubkeys.
+ *
+ * @param event - The event to parse.
+ * @returns An array of participant pubkeys.
+ * @throws Throws an error if the group livekit participants event is invalid.
+ */
+export declare function parseGroupLivekitParticipantsEvent(event: Event): string[];
+/**
+ * Represents a reference to a pinned event in a NIP29 group.
+ */
+export type GroupPinnedEvent = {
+    type: 'e' | 'a';
+    value: string;
+};
+/**
+ * Generates an event template for the events pinned in a group.
+ *
+ * @param group - The group object.
+ * @param pinnedEvents - An array of references to pinned events, in display order.
+ * @returns The generated event template with the pinned events that can be signed later.
+ */
+export declare function generateGroupPinnedEventsEventTemplate(group: Group, pinnedEvents: GroupPinnedEvent[]): EventTemplate;
+/**
+ * Validates a group pinned events event.
+ *
+ * @param event - The event to validate.
+ * @returns True if the event is a valid group pinned events event, false otherwise.
+ */
+export declare function validateGroupPinnedEventsEvent(event: Event): boolean;
+/**
+ * Parses a group pinned events event and returns an array of GroupPinnedEvent objects.
+ *
+ * @param event - The event to parse.
+ * @returns An array of GroupPinnedEvent objects.
+ * @throws Throws an error if the group pinned events event is invalid.
+ */
+export declare function parseGroupPinnedEventsEvent(event: Event): GroupPinnedEvent[];
+/**
+ * Generates a `put-user` (kind:9000) moderation event template.
+ *
+ * @param groupId - The id of the group.
+ * @param pubkey - The pubkey of the user to add or update.
+ * @param roles - Optional roles to assign to the user.
+ * @param reason - Optional reason for the action.
+ * @param previous - Optional timeline references.
+ * @returns The generated event template that can be signed later.
+ */
+export declare function generatePutUserEventTemplate(groupId: string, pubkey: string, roles?: string[], reason?: string, previous?: string[]): EventTemplate;
+/**
+ * Generates a `remove-user` (kind:9001) moderation event template.
+ *
+ * @param groupId - The id of the group.
+ * @param pubkey - The pubkey of the user to remove.
+ * @param reason - Optional reason for the action.
+ * @param previous - Optional timeline references.
+ * @returns The generated event template that can be signed later.
+ */
+export declare function generateRemoveUserEventTemplate(groupId: string, pubkey: string, reason?: string, previous?: string[]): EventTemplate;
+/**
+ * Generates an `edit-metadata` (kind:9002) moderation event template carrying
+ * all the metadata fields of the group.
+ *
+ * @param group - The group object with the updated metadata.
+ * @param reason - Optional reason for the action.
+ * @param previous - Optional timeline references.
+ * @returns The generated event template that can be signed later.
+ */
+export declare function generateEditGroupMetadataEventTemplate(group: Group, reason?: string, previous?: string[]): EventTemplate;
+/**
+ * Generates a `delete-event` (kind:9005) moderation event template.
+ *
+ * @param groupId - The id of the group.
+ * @param eventId - The id of the event to delete.
+ * @param reason - Optional reason for the action.
+ * @param previous - Optional timeline references.
+ * @returns The generated event template that can be signed later.
+ */
+export declare function generateDeleteEventEventTemplate(groupId: string, eventId: string, reason?: string, previous?: string[]): EventTemplate;
+/**
+ * Generates a `create-group` (kind:9007) moderation event template.
+ *
+ * @param groupId - The id of the group to create.
+ * @param reason - Optional reason for the action.
+ * @param previous - Optional timeline references.
+ * @returns The generated event template that can be signed later.
+ */
+export declare function generateCreateGroupEventTemplate(groupId: string, reason?: string, previous?: string[]): EventTemplate;
+/**
+ * Generates a `delete-group` (kind:9008) moderation event template.
+ *
+ * @param groupId - The id of the group to delete.
+ * @param reason - Optional reason for the action.
+ * @param previous - Optional timeline references.
+ * @returns The generated event template that can be signed later.
+ */
+export declare function generateDeleteGroupEventTemplate(groupId: string, reason?: string, previous?: string[]): EventTemplate;
+/**
+ * Generates a `create-invite` (kind:9009) moderation event template.
+ *
+ * @param groupId - The id of the group.
+ * @param code - An arbitrary invite code.
+ * @param reason - Optional reason for the action.
+ * @param previous - Optional timeline references.
+ * @returns The generated event template that can be signed later.
+ */
+export declare function generateCreateInviteEventTemplate(groupId: string, code: string, reason?: string, previous?: string[]): EventTemplate;
+/**
+ * Generates an `update-pin-list` (kind:9010) moderation event template.
+ *
+ * @param groupId - The id of the group.
+ * @param pinnedEvents - The full ordered list of pinned events.
+ * @param reason - Optional reason for the action.
+ * @param previous - Optional timeline references.
+ * @returns The generated event template that can be signed later.
+ */
+export declare function generateUpdatePinListEventTemplate(groupId: string, pinnedEvents: GroupPinnedEvent[], reason?: string, previous?: string[]): EventTemplate;
+/**
+ * Generates a group join request (kind:9021) event template.
+ *
+ * @param groupId - The id of the group.
+ * @param inviteCode - Optional invite code to be preauthorized by the relay.
+ * @param reason - Optional reason for the request.
+ * @param previous - Optional timeline references.
+ * @returns The generated event template that can be signed later.
+ */
+export declare function generateGroupJoinRequestEventTemplate(groupId: string, inviteCode?: string, reason?: string, previous?: string[]): EventTemplate;
+/**
+ * Generates a group leave request (kind:9022) event template.
+ *
+ * @param groupId - The id of the group.
+ * @param reason - Optional reason for the request.
+ * @param previous - Optional timeline references.
+ * @returns The generated event template that can be signed later.
+ */
+export declare function generateGroupLeaveRequestEventTemplate(groupId: string, reason?: string, previous?: string[]): EventTemplate;
 /**
  * Fetches and parses the group metadata event, group admins event, and group members event from the specified pool.
  * If the normalized relay URL is not provided, it will be obtained using the group reference.

package/node_modules/nostr-tools/lib/types/nip29.test.d.ts

@@ -0,0 +1 @@
+export {};

package/node_modules/nostr-tools/package.json

@@ -1,7 +1,7 @@
 {
   "type": "module",
   "name": "nostr-tools",
-  "version": "2.24.1",
+  "version": "2.24.2",
   "description": "Tools for making a Nostr client.",
   "repository": {
     "type": "git",

package/openclaw.plugin.json

@@ -29,6 +29,9 @@
           "configWrites": {
             "type": "boolean"
           },
+          "responsePrefix": {
+            "type": "string"
+          },
           "markdown": {
             "type": "object",
             "properties": {
@@ -294,6 +297,27 @@
                 },
                 "requireMention": {
                   "type": "boolean"
+                },
+                "groupPolicy": {
+                  "type": "string",
+                  "enum": [
+                    "open",
+                    "disabled",
+                    "allowlist"
+                  ]
+                },
+                "groupAllowFrom": {
+                  "type": "array",
+                  "items": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "number"
+                      }
+                    ]
+                  }
                 }
               },
               "additionalProperties": false

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openclaw/buzz",
-  "version": "2026.8.1-beta.2",
+  "version": "2026.9.1-beta.1",
   "description": "Connect OpenClaw agents to Buzz rooms",
   "repository": {
     "type": "git",
@@ -8,11 +8,11 @@
   },
   "type": "module",
   "dependencies": {
-    "nostr-tools": "2.24.1",
+    "nostr-tools": "2.24.2",
     "zod": "4.4.3"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.8.1-beta.2"
+    "openclaw": ">=2026.9.1-beta.1"
   },
   "peerDependenciesMeta": {
     "openclaw": {
@@ -81,10 +81,10 @@
       "minHostVersion": ">=2026.7.2"
     },
     "compat": {
-      "pluginApi": ">=2026.8.1-beta.2"
+      "pluginApi": ">=2026.9.1-beta.1"
     },
     "build": {
-      "openclawVersion": "2026.8.1-beta.2"
+      "openclawVersion": "2026.9.1-beta.1"
     },
     "release": {
       "publishToClawHub": true,