@parall/cli 1.54.0 → 1.55.0

package/dist/commands/wechat.d.ts

@@ -5,8 +5,14 @@ import { Command } from 'commander';
  * architecture). The agent sends as the connected WeChat account itself;
  * the vendor token + device id never reach the runtime — api-server
  * performs the vendor call in-process.
+ *
+ * Verb surface = the vendor's in-scope interface aggregated: postText
+ * (send), fetchContactsList + getBriefInfo + getChatroomInfo (contacts),
+ * getProfile (profile), checkOnline (status). Every verb renders
+ * agent-readable text by default and `--json` for machine output.
+ *
  * INTERNAL research preview: the capability is flag-gated to the internal
- * org. Design: docs/engineering-design/wechat-channel-design.md §3.
+ * org. Design: docs/engineering-design/wechat-channel-design.md §3, §4.
  */
 export declare function registerWechatCommands(program: Command): void;
 //# sourceMappingURL=wechat.d.ts.map

package/dist/commands/wechat.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wechat.d.ts","sourceRoot":"","sources":["../../src/commands/wechat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,QA6CtD"}
+{"version":3,"file":"wechat.d.ts","sourceRoot":"","sources":["../../src/commands/wechat.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,OAAO,QAwItD"}

package/dist/commands/wechat.js

@@ -1,13 +1,20 @@
 import { resolveCredentials } from '../lib/client.js';
 import { printError, printJson } from '../lib/output.js';
+import { resolveMessageText, TEXT_FILE_OPTION_DESC, TEXT_OPTION_DESC } from '../lib/text-input.js';
 /**
  * `parall wechat …` — the per-vendor platform verb for the personal-WeChat
  * protocol channel (wechatapi.net, tier B in the multi-channel
  * architecture). The agent sends as the connected WeChat account itself;
  * the vendor token + device id never reach the runtime — api-server
  * performs the vendor call in-process.
+ *
+ * Verb surface = the vendor's in-scope interface aggregated: postText
+ * (send), fetchContactsList + getBriefInfo + getChatroomInfo (contacts),
+ * getProfile (profile), checkOnline (status). Every verb renders
+ * agent-readable text by default and `--json` for machine output.
+ *
  * INTERNAL research preview: the capability is flag-gated to the internal
- * org. Design: docs/engineering-design/wechat-channel-design.md §3.
+ * org. Design: docs/engineering-design/wechat-channel-design.md §3, §4.
  */
 export function registerWechatCommands(program) {
     const wechat = program
@@ -17,18 +24,29 @@ export function registerWechatCommands(program) {
         .command('send')
         .description('Send a message to a WeChat conversation this connection has seen inbound')
         .requiredOption('--to <wxid>', 'Vendor-native conversation id from the inbound event (a friend wxid, or a room id ending in @chatroom)')
-        .requiredOption('--text <text>', 'Message text (plain text)')
+        .option('--text <text>', TEXT_OPTION_DESC)
+        .option('--text-file <path>', TEXT_FILE_OPTION_DESC)
         .option('--at <wxid>', 'In group replies: @-mention one member (wxid of the person you are answering)')
+        .option('--json', 'Emit the full machine-readable response instead of the readable summary')
         .action(async (opts) => {
         try {
+            const text = resolveMessageText(opts);
+            if (text === undefined || text === '') {
+                throw new Error('Provide --text or --text-file');
+            }
             const { client, orgId } = resolveCredentials();
             const sent = await client.sendChannelMessage(orgId, {
                 channel_type: 'wechat',
                 conversation_id: opts.to,
-                text: opts.text,
+                text,
                 ...(opts.at ? { at: opts.at } : {}),
             });
-            printJson(sent);
+            if (opts.json) {
+                printJson(sent);
+                return;
+            }
+            const where = opts.at ? ` @${opts.at}` : '';
+            console.log(`sent: ${sent.message_id} → ${sent.conversation_id}${where} (wechat)`);
         }
         catch (err) {
             printError(err);
@@ -36,11 +54,81 @@ export function registerWechatCommands(program) {
     });
     wechat
         .command('contacts')
-        .description('List the account address book: friend wxids, saved group room ids, followed official accounts (ids only — the vendor returns no names)')
-        .action(async () => {
+        .description('List the account address book with display names: friends, saved groups, followed official accounts')
+        .option('--json', 'Emit the full machine-readable response instead of the readable summary')
+        .action(async (opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const page = await client.listWechatContacts(orgId);
+            if (opts.json) {
+                printJson(page);
+                return;
+            }
+            const friendRows = page.friends.map((f) => `${f.wxid}\t${f.display}`.replace(/\t$/, ''));
+            const groupRows = page.chatrooms.map((c) => `${c.chatroom_id}\t${c.display}`.replace(/\t$/, ''));
+            console.log(`ADDRESS BOOK — friends: ${page.friends.length}, groups: ${page.chatrooms.length}, official accounts: ${page.ghs.length}`);
+            if (friendRows.length) {
+                console.log(`\nfriends (${page.friends.length}):\n  ${friendRows.join('\n  ')}`);
+            }
+            if (groupRows.length) {
+                console.log(`\ngroups (${page.chatrooms.length}):\n  ${groupRows.join('\n  ')}`);
+            }
+            if (page.ghs.length) {
+                console.log(`\nofficial accounts (${page.ghs.length}):\n  ${page.ghs.join('\n  ')}`);
+            }
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    wechat
+        .command('profile')
+        .description('Show the connected WeChat account identity (wxid / alias / nickName / app id)')
+        .option('--json', 'Emit the full machine-readable response instead of the readable summary')
+        .action(async (opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const view = await client.wechatProfile(orgId);
+            if (opts.json) {
+                printJson(view);
+                return;
+            }
+            console.log('ACCOUNT');
+            console.log(`  wxid:      ${view.wxid}`);
+            if (view.nick_name)
+                console.log(`  nickName:  ${view.nick_name}`);
+            if (view.alias)
+                console.log(`  alias:     ${view.alias}`);
+            console.log(`  app_id:    ${view.app_id}`);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    wechat
+        .command('status')
+        .description('Check the connection health: live online probe, identity, last offline time')
+        .option('--json', 'Emit the full machine-readable response instead of the readable summary')
+        .action(async (opts) => {
         try {
             const { client, orgId } = resolveCredentials();
-            printJson(await client.listWechatContacts(orgId));
+            const view = await client.wechatStatus(orgId);
+            if (opts.json) {
+                printJson(view);
+                return;
+            }
+            const label = view.online ? 'ONLINE' : 'OFFLINE';
+            console.log(`WeChat account: ${label}`);
+            console.log(`  wxid:      ${view.wxid}`);
+            if (view.nick_name)
+                console.log(`  nickName:  ${view.nick_name}`);
+            if (view.alias)
+                console.log(`  alias:     ${view.alias}`);
+            console.log(`  app_id:    ${view.app_id}`);
+            console.log(`  last_offline_at: ${view.last_offline_at ?? 'never'}`);
+            if (!view.online) {
+                console.log('  → the account is offline; a human must re-login on the vendor side. Stop and tell the user.');
+            }
         }
         catch (err) {
             printError(err);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/cli",
-  "version": "1.54.0",
+  "version": "1.55.0",
   "description": "CLI client for Parall — universal agent & human access to Parall API",
   "license": "MIT",
   "repository": {
@@ -36,14 +36,14 @@
     "diff": "^8.0.3",
     "js-yaml": "^4.1.0",
     "zod": "^4.3.6",
-    "@parall/sdk": "1.54.0",
-    "@parall/agent-core": "1.54.0"
+    "@parall/agent-core": "1.55.0",
+    "@parall/sdk": "1.55.0"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^22.0.0",
     "typescript": "^5.7.0",
-    "@parall/agent-core": "1.54.0"
+    "@parall/agent-core": "1.55.0"
   },
   "scripts": {
     "build": "tsc",