@agent-wechat/cli 0.7.10 → 0.8.0

package/dist/cli.js

@@ -3565,6 +3565,13 @@ var WeChatClient = class {
   async openChat(chatId, clearUnreads) {
     return this.post(`/api/chats/${encodeURIComponent(chatId)}/open${qs({ clearUnreads })}`);
   }
+  // ---- Contacts ----
+  async listContacts(limit, offset) {
+    return this.get(`/api/contacts${qs({ limit, offset })}`);
+  }
+  async findContacts(name) {
+    return this.get(`/api/contacts/find${qs({ name })}`);
+  }
   // ---- Messages ----
   async listMessages(chatId, limit, offset) {
     return this.get(`/api/messages/${encodeURIComponent(chatId)}${qs({ limit, offset })}`);
@@ -7904,7 +7911,7 @@ import qrTerminal from "qrcode-terminal";
 import os from "os";
 import path from "path";
 import { fileURLToPath } from "url";
-var VERSION = "0.7.10";
+var VERSION = "0.8.0";
 var CONTAINER_NAME = "agent-wechat";
 var GHCR_IMAGE = "ghcr.io/thisnick/agent-wechat";
 var DEFAULT_PORT = 6174;
@@ -8032,6 +8039,13 @@ chatsCmd.command("find <name>").description("Find chat by name").action(async (n
 chatsCmd.command("open <chatId>").description("Open a chat in WeChat UI (triggers media downloads + clears unread)").option("--clear-unreads", "Clear unread count after opening").action(async (chatId, opts) => {
   await cmdChatOpen(getClient(), chatId, opts.clearUnreads);
 });
+var contactsCmd = program2.command("contacts").description("Contact management commands");
+contactsCmd.command("list").description("List all contacts from WeChat address book").option("-l, --limit <number>", "Maximum number of contacts", "200").option("-o, --offset <number>", "Skip first N contacts", "0").option("-j, --json", "Output as JSON").action(async (opts) => {
+  await cmdContacts(getClient(), parseInt(opts.limit, 10), parseInt(opts.offset, 10), opts.json ?? false);
+});
+contactsCmd.command("find <name>").description("Search contacts by name").option("-j, --json", "Output as JSON").action(async (name, opts) => {
+  await cmdContactsFind(getClient(), name, opts.json ?? false);
+});
 var messagesCmd = program2.command("messages").description("Message commands");
 messagesCmd.command("list <chatId>").description("List messages for a chat").option("-l, --limit <number>", "Maximum number of messages", "50").option("-o, --offset <number>", "Skip first N messages", "0").option("-j, --json", "Output as JSON").action(async (chatId, opts) => {
   await cmdMessages(getClient(), chatId, parseInt(opts.limit, 10), parseInt(opts.offset, 10), opts.json ?? false);
@@ -8315,6 +8329,46 @@ async function cmdChatOpen(client, chatId, clearUnreads) {
     process.exit(1);
   }
 }
+async function cmdContacts(client, limit = 200, offset = 0, json = false) {
+  const contacts = await client.listContacts(limit, offset);
+  if (json) {
+    console.log(JSON.stringify(contacts, null, 2));
+    return;
+  }
+  if (contacts.length === 0) {
+    console.log("No contacts found. Make sure you're logged in.");
+    return;
+  }
+  console.log(`Found ${contacts.length} contact(s):
+`);
+  const maxIdLen = Math.max(10, ...contacts.map((c) => c.username.length));
+  const idHeader = "Username".padEnd(maxIdLen);
+  console.log(`${idHeader}  Type        Name`);
+  console.log("-".repeat(maxIdLen + 30));
+  for (const c of contacts) {
+    const id = c.username.padEnd(maxIdLen);
+    const type = c.contactType.padEnd(10);
+    const name = c.remark ? `${c.nickName} (${c.remark})` : c.nickName;
+    console.log(`${id}  ${type}  ${name}`);
+  }
+}
+async function cmdContactsFind(client, name, json = false) {
+  const contacts = await client.findContacts(name);
+  if (json) {
+    console.log(JSON.stringify(contacts, null, 2));
+    return;
+  }
+  if (contacts.length === 0) {
+    console.log(`No contacts found matching "${name}"`);
+    return;
+  }
+  console.log(`Found ${contacts.length} matching contact(s):
+`);
+  for (const c of contacts) {
+    const name2 = c.remark ? `${c.nickName} (${c.remark})` : c.nickName;
+    console.log(`  ${c.username}: ${name2} [${c.contactType}]`);
+  }
+}
 async function cmdSend(client, chatId, text, image, file) {
   const what = file ? `file "${file.filename}"` : image ? "image" : "message";
   console.log(`Sending ${what} to ${chatId}...`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-wechat/cli",
-  "version": "0.7.10",
+  "version": "0.8.0",
   "type": "module",
   "bin": {
     "wx": "./dist/cli.js"