@parall/cli 1.54.0 → 1.55.1

package/dist/commands/projects.js

@@ -35,7 +35,7 @@ export function registerProjectCommands(program) {
         .requiredOption('--name <name>', 'Project name')
         .requiredOption('--key <key>', 'Project key')
         .option('--description <text>', 'Project description')
-        .option('--lead-id <id>', 'Lead user ID')
+        .option('--visibility <visibility>', 'public (whole org) or private (roster only)')
         .option('--color <hex>', 'Project color (hex)')
         .action(async (opts) => {
         try {
@@ -43,8 +43,8 @@ export function registerProjectCommands(program) {
             const data = { name: opts.name, key: opts.key };
             if (opts.description !== undefined)
                 data.description = opts.description;
-            if (opts.leadId !== undefined)
-                data.lead_id = opts.leadId;
+            if (opts.visibility !== undefined)
+                data.visibility = opts.visibility;
             if (opts.color !== undefined)
                 data.color = opts.color;
             const result = await client.createProject(orgId, data);
@@ -60,7 +60,7 @@ export function registerProjectCommands(program) {
         .argument('<projectId>', 'Project ID')
         .option('--name <name>', 'Project name')
         .option('--description <text>', 'Project description')
-        .option('--lead-id <id>', 'Lead user ID')
+        .option('--visibility <visibility>', 'public (whole org) or private (roster only)')
         .option('--color <hex>', 'Project color (hex)')
         .option('--status <status>', 'Project status')
         .action(async (projectId, opts) => {
@@ -71,8 +71,8 @@ export function registerProjectCommands(program) {
                 data.name = opts.name;
             if (opts.description !== undefined)
                 data.description = opts.description;
-            if (opts.leadId !== undefined)
-                data.lead_id = opts.leadId;
+            if (opts.visibility !== undefined)
+                data.visibility = opts.visibility;
             if (opts.color !== undefined)
                 data.color = opts.color;
             if (opts.status !== undefined)

package/dist/commands/tasks.d.ts

@@ -6,7 +6,7 @@ export declare function buildCreateTaskData(opts: {
     status?: string;
     priority?: string;
     assigneeId?: string;
-    projectId?: string;
+    projectId: string;
     parentId?: string;
     sourceChatId?: string;
     dueDate?: string;
@@ -17,7 +17,7 @@ export declare function buildCreateTaskData(opts: {
     status: string | undefined;
     priority: string | undefined;
     assignee_id: string | undefined;
-    project_id: string | undefined;
+    project_id: string;
     parent_id: string | undefined;
     source_chat_id: string | undefined;
     planned_start_date: string | undefined;
@@ -29,7 +29,6 @@ export declare function buildUpdateTaskData(opts: {
     priority?: string;
     assigneeId?: string;
     description?: string;
-    projectId?: string;
     parentId?: string;
     sortOrder?: string;
     placement?: string;
@@ -41,7 +40,6 @@ export declare function buildUpdateTaskData(opts: {
     priority: UpdateTaskRequest["priority"];
     assignee_id: string | undefined;
     description: string | undefined;
-    project_id: string | undefined;
     parent_id: string | undefined;
     sort_order: number | undefined;
     placement: "end" | undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/commands/tasks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgEpC,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;;;;;;;;;;;GAaA;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;;YAS0B,iBAAiB,CAAC,QAAQ,CAAC;cACvB,iBAAiB,CAAC,UAAU,CAAC;;;;;;;;;GAU3D;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAyWpD"}
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/commands/tasks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAqB,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgEpC,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;;;;;;;;;;;GAaA;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;;YAS0B,iBAAiB,CAAC,QAAQ,CAAC;cACvB,iBAAiB,CAAC,UAAU,CAAC;;;;;;;;GAS3D;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QA2WpD"}

package/dist/commands/tasks.js

@@ -66,7 +66,7 @@ export function buildCreateTaskData(opts) {
         status: opts.status,
         priority: opts.priority,
         assignee_id: opts.assigneeId ? stripPrllScheme(opts.assigneeId) : undefined,
-        project_id: opts.projectId ? stripPrllScheme(opts.projectId) : undefined,
+        project_id: stripPrllScheme(opts.projectId),
         parent_id: opts.parentId ? stripPrllScheme(opts.parentId) : undefined,
         source_chat_id: opts.sourceChatId ? stripPrllScheme(opts.sourceChatId) : undefined,
         planned_start_date: resolveCreateDateFlag('--planned-start', opts.plannedStart),
@@ -86,7 +86,6 @@ export function buildUpdateTaskData(opts) {
         priority: opts.priority,
         assignee_id: opts.assigneeId ? stripPrllScheme(opts.assigneeId) : undefined,
         description: opts.description,
-        project_id: opts.projectId ? stripPrllScheme(opts.projectId) : undefined,
         parent_id: opts.parentId ? stripPrllScheme(opts.parentId) : undefined,
         sort_order: resolveSortOrder(opts.sortOrder),
         placement: resolvePlacement(opts.placement),
@@ -137,7 +136,7 @@ export function registerTaskCommands(program) {
         .option('--status <status>', 'Task status')
         .option('--priority <priority>', 'Task priority')
         .option('--assignee-id <id>', 'Assignee user ID')
-        .option('--project-id <id>', 'Project ID')
+        .requiredOption('--project-id <id>', 'Project ID the task is created in (required; run "parall projects list" to see available projects)')
         .option('--parent-id <id>', 'Parent task ID')
         .option('--source-chat-id <id>', 'Source chat ID')
         .option('--planned-start <date>', 'Planned start date (YYYY-MM-DD) — must be on or before --due-date when both are set')
@@ -179,7 +178,6 @@ export function registerTaskCommands(program) {
         .option('--priority <priority>', 'Task priority')
         .option('--assignee-id <id>', 'Assignee user ID')
         .option('--description <text>', 'Task description')
-        .option('--project-id <id>', 'Project ID')
         .option('--parent-id <id>', 'Parent task ID')
         .option('--sort-order <n>', 'Explicit sort_order value — only for pinpoint insertion relative to cards you can see; to append to a status column use --placement end')
         .option('--placement <where>', 'Ordering intent — only "end" is accepted: appends the task to the end of its status column, position resolved by the server (mutually exclusive with --sort-order)')

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.1",
   "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.1",
+    "@parall/sdk": "1.55.1"
   },
   "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.1"
   },
   "scripts": {
     "build": "tsc",