@newbase-clawchat/openclaw-clawchat 2026.5.4 → 2026.5.12-13

package/src/streaming.test.ts

@@ -1,4 +1,4 @@
-import type { ClawlingChatClient } from "@newbase-clawchat/sdk";
+import type { ClawlingChatClient } from "./ws-client.ts";
 import { describe, expect, it, vi } from "vitest";
 import { sendStreamingText } from "./streaming.ts";
 
@@ -23,7 +23,7 @@ describe("openclaw-clawchat streaming", () => {
     await sendStreamingText({
       client,
       to: { id: "u1", type: "direct" },
-      sender: { sender_id: "a1", type: "direct", display_name: "Clawling" },
+      sender: { id: "a1", type: "direct", nick_name: "Clawling" },
       chunks: ["Hel", "lo ", "world"],
       messageId: "m1",
     });
@@ -47,7 +47,7 @@ describe("openclaw-clawchat streaming", () => {
     await sendStreamingText({
       client,
       to: { id: "u1", type: "direct" },
-      sender: { sender_id: "a1", type: "direct", display_name: "Clawling" },
+      sender: { id: "a1", type: "direct", nick_name: "Clawling" },
       chunks: ["a", "b", "c"],
       messageId: "m1",
     });
@@ -65,7 +65,7 @@ describe("openclaw-clawchat streaming", () => {
     await sendStreamingText({
       client,
       to: { id: "u1", type: "direct" },
-      sender: { sender_id: "a1", type: "direct", display_name: "Clawling" },
+      sender: { id: "a1", type: "direct", nick_name: "Clawling" },
       chunks: ["Hel", "lo ", "world"],
       messageId: "m1",
     });
@@ -88,7 +88,7 @@ describe("openclaw-clawchat streaming", () => {
     await sendStreamingText({
       client,
       to: { id: "u1", type: "direct" },
-      sender: { sender_id: "a1", type: "direct", display_name: "Clawling" },
+      sender: { id: "a1", type: "direct", nick_name: "Clawling" },
       chunks: [],
       messageId: "m1",
     });
@@ -96,7 +96,7 @@ describe("openclaw-clawchat streaming", () => {
     expect(events).toEqual(["message.created", "message.done"]);
   });
 
-  it("sendStreamingFailure emits failed with reason and typing(false)", async () => {
+  it("sendStreamingFailure emits failed with StreamDonePayload shape and typing(false)", async () => {
     const { client, sent } = mockClient();
     const { sendStreamingFailure } = await import("./streaming.ts");
     await sendStreamingFailure({
@@ -107,8 +107,9 @@ describe("openclaw-clawchat streaming", () => {
       reason: "boom",
     });
     expect(sent[0]!.event).toBe("message.failed");
-    expect(sent[0]!.payload.sequence).toBe(2);
-    expect(sent[0]!.payload.reason).toBe("boom");
+    expect(sent[0]!.payload).not.toHaveProperty("sequence");
+    expect(sent[0]!.payload).not.toHaveProperty("reason");
+    expect((sent[0]!.payload.streaming as { sequence: number }).sequence).toBe(2);
     expect(sent[0]!.payload).toHaveProperty("completed_at");
     expect(sent[0]!.payload).not.toHaveProperty("failed_at");
     expect(sent[0]!.payload.fragments).toEqual([{ kind: "text", text: "boom" }]);

package/src/streaming.ts

@@ -1,4 +1,4 @@
-import type { ClawlingChatClient } from "@newbase-clawchat/sdk";
+import type { ClawlingChatClient } from "./ws-client.ts";
 import {
   emitStreamAdd,
   emitStreamCreated,

package/src/tools-schema.ts

@@ -5,33 +5,168 @@ export type ClawchatGetAccountProfileParams = Static<typeof ClawchatGetAccountPr
 
 export const ClawchatGetUserProfileSchema = Type.Object({
   userId: Type.String({
-    description: "Target ClawChat user id (required). Do not infer this from a nickname.",
+    description:
+      "Explicit target ClawChat user id (required). Do not infer this from a nickname; use clawchat_get_account_profile for the agent's own connected ClawChat account unless an explicit userId is provided.",
   }),
 });
 export type ClawchatGetUserProfileParams = Static<typeof ClawchatGetUserProfileSchema>;
 
-export const ClawchatListAccountFriendsSchema = Type.Object({
-  page: Type.Optional(Type.Integer({ minimum: 1, description: "1-based page number (default 1)" })),
-  pageSize: Type.Optional(
+export const ClawchatListAccountFriendsSchema = Type.Object({});
+export type ClawchatListAccountFriendsParams = Static<typeof ClawchatListAccountFriendsSchema>;
+
+export const ClawchatSearchUsersSchema = Type.Object({
+  q: Type.Optional(
+    Type.String({
+      description: "Search query for ClawChat username or nickname",
+    }),
+  ),
+  limit: Type.Optional(
     Type.Integer({
       minimum: 1,
       maximum: 100,
-      description: "Page size 1..100 (default 20)",
+      description: "Max results (default 20)",
     }),
   ),
 });
-export type ClawchatListAccountFriendsParams = Static<typeof ClawchatListAccountFriendsSchema>;
+export type ClawchatSearchUsersParams = Static<typeof ClawchatSearchUsersSchema>;
+
+export const ClawchatListConversationsSchema = Type.Object({
+  before: Type.Optional(
+    Type.String({
+      description: "Cursor; return conversations before this value",
+    }),
+  ),
+  limit: Type.Optional(
+    Type.Integer({
+      minimum: 1,
+      maximum: 100,
+      description: "Max conversations to return",
+    }),
+  ),
+});
+export type ClawchatListConversationsParams = Static<typeof ClawchatListConversationsSchema>;
+
+export const ClawchatGetConversationSchema = Type.Object({
+  conversationId: Type.String({
+    description: "Concrete ClawChat conversation id to fetch",
+  }),
+});
+export type ClawchatGetConversationParams = Static<typeof ClawchatGetConversationSchema>;
+
+export const ClawchatListMomentsSchema = Type.Object({
+  before: Type.Optional(
+    Type.Integer({
+      minimum: 1,
+      description: "Cursor; return moments with id < before",
+    }),
+  ),
+  limit: Type.Optional(
+    Type.Integer({
+      minimum: 1,
+      maximum: 100,
+      description: "Max items (default 30)",
+    }),
+  ),
+});
+export type ClawchatListMomentsParams = Static<typeof ClawchatListMomentsSchema>;
+
+export const ClawchatCreateMomentSchema = Type.Object({
+  text: Type.Optional(
+    Type.String({
+      description: "Moment text. At least one of text or images is required.",
+    }),
+  ),
+  images: Type.Optional(
+    Type.Array(
+      Type.String({
+        description: "Image URL for the moment. Upload local files first; do not pass local paths.",
+      }),
+    ),
+  ),
+});
+export type ClawchatCreateMomentParams = Static<typeof ClawchatCreateMomentSchema>;
+
+export const ClawchatDeleteMomentSchema = Type.Object({
+  momentId: Type.Integer({
+    minimum: 1,
+    description: "Concrete ClawChat moment id to delete",
+  }),
+});
+export type ClawchatDeleteMomentParams = Static<typeof ClawchatDeleteMomentSchema>;
+
+export const ClawchatToggleMomentReactionSchema = Type.Object({
+  momentId: Type.Integer({
+    minimum: 1,
+    description: "Concrete ClawChat moment id to react to",
+  }),
+  emoji: Type.String({
+    description: "Emoji reaction to toggle",
+  }),
+});
+export type ClawchatToggleMomentReactionParams = Static<
+  typeof ClawchatToggleMomentReactionSchema
+>;
+
+export const ClawchatCreateMomentCommentSchema = Type.Object({
+  momentId: Type.Integer({
+    minimum: 1,
+    description: "Concrete ClawChat moment id to comment on",
+  }),
+  text: Type.String({
+    description: "Top-level comment text",
+  }),
+});
+export type ClawchatCreateMomentCommentParams = Static<
+  typeof ClawchatCreateMomentCommentSchema
+>;
+
+export const ClawchatReplyMomentCommentSchema = Type.Object({
+  momentId: Type.Integer({
+    minimum: 1,
+    description: "Concrete ClawChat moment id containing the comment",
+  }),
+  replyToCommentId: Type.Integer({
+    minimum: 1,
+    description: "Concrete comment id being replied to",
+  }),
+  text: Type.String({
+    description: "Reply text",
+  }),
+});
+export type ClawchatReplyMomentCommentParams = Static<typeof ClawchatReplyMomentCommentSchema>;
+
+export const ClawchatDeleteMomentCommentSchema = Type.Object({
+  momentId: Type.Integer({
+    minimum: 1,
+    description: "Concrete ClawChat moment id containing the comment",
+  }),
+  commentId: Type.Integer({
+    minimum: 1,
+    description: "Concrete comment id to delete",
+  }),
+});
+export type ClawchatDeleteMomentCommentParams = Static<
+  typeof ClawchatDeleteMomentCommentSchema
+>;
 
 export const ClawchatUpdateAccountProfileSchema = Type.Object({
-  nickname: Type.Optional(Type.String({ description: "New ClawChat account nickname" })),
+  nickname: Type.Optional(
+    Type.String({
+      description:
+        "New nickname/display name for the agent's connected ClawChat account, mirroring the local assistant identity",
+    }),
+  ),
   avatar_url: Type.Optional(
     Type.String({
       description:
-        "Avatar URL for the ClawChat account profile (use clawchat_upload_avatar_image first to obtain one from a local image)",
+        "Avatar URL for the agent's connected ClawChat account profile (use clawchat_upload_avatar_image first to obtain one from a local image)",
     }),
   ),
   bio: Type.Optional(
-    Type.String({ description: "New ClawChat account self-introduction / bio text" }),
+    Type.String({
+      description:
+        "New self-introduction / bio text for the agent's connected ClawChat account, mirroring the local assistant identity",
+    }),
   ),
 });
 export type ClawchatUpdateAccountProfileParams = Static<
@@ -40,23 +175,16 @@ export type ClawchatUpdateAccountProfileParams = Static<
 
 export const ClawchatUploadMediaFileSchema = Type.Object({
   filePath: Type.String({
-    description: "Absolute local path of the media/file to upload to ClawChat (max 20MB)",
+    description:
+      "Absolute local path of the non-avatar media/file to upload to ClawChat for a ClawChat-accessible URL (max 20MB)",
   }),
 });
 export type ClawchatUploadMediaFileParams = Static<typeof ClawchatUploadMediaFileSchema>;
 
 export const ClawchatUploadAvatarImageSchema = Type.Object({
   filePath: Type.String({
-    description: "Absolute local path of the avatar image to upload to ClawChat (max 20MB)",
-  }),
-});
-export type ClawchatUploadAvatarImageParams = Static<typeof ClawchatUploadAvatarImageSchema>;
-
-export const ClawchatActivateSchema = Type.Object({
-  code: Type.String({
     description:
-      "The invite code (six uppercase letters/digits, e.g. 'A1B2C3') extracted from the user's message. " +
-      "Whitespace is trimmed automatically.",
+      "Absolute local path of the avatar image to upload for the agent's connected ClawChat account (max 20MB)",
   }),
 });
-export type ClawchatActivateParams = Static<typeof ClawchatActivateSchema>;
+export type ClawchatUploadAvatarImageParams = Static<typeof ClawchatUploadAvatarImageSchema>;