@parall/cli 1.24.0 → 1.25.0

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

@@ -1 +1 @@
-{"version":3,"file":"approvals.d.ts","sourceRoot":"","sources":["../../src/commands/approvals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,QAgExD"}
+{"version":3,"file":"approvals.d.ts","sourceRoot":"","sources":["../../src/commands/approvals.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,OAAO,QAkIxD"}

package/dist/commands/approvals.js

@@ -37,6 +37,20 @@ export function registerApprovalCommands(program) {
             printError(err);
         }
     });
+    approvals
+        .command('get')
+        .description('Get the status of a specific approval request')
+        .argument('<approvalId>', 'Approval request ID')
+        .action(async (approvalId) => {
+        try {
+            const { client } = resolveCredentials();
+            const result = await client.getApproval(stripPrllScheme(approvalId));
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
     approvals
         .command('cancel')
         .description('Cancel a pending approval request')
@@ -64,4 +78,55 @@ export function registerApprovalCommands(program) {
             printError(err);
         }
     });
+    approvals
+        .command('wait')
+        .description('Wait for an approval to reach a terminal state')
+        .argument('<approvalId>', 'Approval request ID')
+        .option('--timeout <seconds>', 'Max seconds to wait', '300')
+        .action(async (approvalId, opts) => {
+        try {
+            const { client } = resolveCredentials();
+            const id = stripPrllScheme(approvalId);
+            const timeoutSeconds = Number(opts.timeout);
+            if (!Number.isFinite(timeoutSeconds) || timeoutSeconds <= 0) {
+                printError(new Error('--timeout must be a positive number of seconds'));
+            }
+            const timeoutMs = timeoutSeconds * 1000;
+            const pollMs = 5000;
+            const deadline = Date.now() + timeoutMs;
+            while (true) {
+                const approval = await client.getApproval(id);
+                const isTerminal = approval.status !== 'pending'
+                    && !(approval.status === 'approved' && !approval.execution_status);
+                if (isTerminal) {
+                    printJson(approval);
+                    const ok = approval.status === 'approved' && approval.execution_status === 'succeeded';
+                    process.exit(ok ? 0 : 1);
+                }
+                const now = Date.now();
+                if (now >= deadline) {
+                    printJson(approval);
+                    console.error('Timed out waiting for approval decision');
+                    process.exit(2);
+                }
+                await new Promise(r => setTimeout(r, Math.min(pollMs, deadline - now)));
+            }
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    approvals
+        .command('actions')
+        .description('List available approval action types')
+        .action(async () => {
+        try {
+            const { client } = resolveCredentials();
+            const result = await client.getApprovableActions();
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
 }

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

@@ -1 +1 @@
-{"version":3,"file":"chats.d.ts","sourceRoot":"","sources":["../../src/commands/chats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAuGpD"}
+{"version":3,"file":"chats.d.ts","sourceRoot":"","sources":["../../src/commands/chats.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAyIpD"}

package/dist/commands/chats.js

@@ -34,6 +34,42 @@ export function registerChatCommands(program) {
             printError(err);
         }
     });
+    chats
+        .command('discoverable')
+        .description('List discoverable chats in the organization')
+        .option('--query <q>', 'Optional name substring filter')
+        .option('--limit <n>', 'Maximum number of results', '20')
+        .action(async (opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const params = {};
+            if (opts.query !== undefined)
+                params.q = opts.query;
+            const limit = Number(opts.limit);
+            if (Number.isFinite(limit))
+                params.limit = limit;
+            const result = await client.getDiscoverableChats(orgId, params);
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    chats
+        .command('join')
+        .description('Join a discoverable chat')
+        .argument('<chatId>', 'Chat ID')
+        .action(async (chatId) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const result = await client.joinChat(orgId, stripPrllScheme(chatId));
+            printJson(result);
+            printRefHint(stripPrllScheme(chatId), 'Joined');
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
     chats
         .command('create')
         .description('Create a new chat')

package/dist/lib/output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAE7C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAY,GAAG,IAAI,CAEvE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAW9C"}
+{"version":3,"file":"output.d.ts","sourceRoot":"","sources":["../../src/lib/output.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI,CAE7C;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,SAAY,GAAG,IAAI,CAEvE;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,GAAG,KAAK,CAyB9C"}

package/dist/lib/output.js

@@ -20,13 +20,27 @@ export function printError(err) {
     let msg;
     if (err instanceof ApiError) {
         msg = { error: err.message, status: err.status, ...(err.code ? { code: err.code } : {}) };
+        console.error(JSON.stringify(msg));
+        if (err.code === 'PERMISSION_DENIED' && err.extras) {
+            const { action, resource_uri } = err.extras;
+            // Subset of authz.Service.RegisteredActions() — only actions agents commonly encounter.
+            // Verify the full list via GET /approvals/actions.
+            const approvable = new Set([
+                'chat.delete', 'chat.archive', 'chat.restore',
+                'task.delete', 'task.archive', 'task.restore',
+            ]);
+            if (typeof action === 'string' && typeof resource_uri === 'string' && approvable.has(action)) {
+                console.error(`Tip: parall approvals request --action ${action} --resource ${resource_uri} --chat <chat_id> --title "..." --reason "..."`);
+            }
+        }
     }
     else if (err instanceof Error) {
         msg = { error: err.message };
+        console.error(JSON.stringify(msg));
     }
     else {
         msg = { error: String(err) };
+        console.error(JSON.stringify(msg));
     }
-    console.error(JSON.stringify(msg));
     return process.exit(1);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/cli",
-  "version": "1.24.0",
+  "version": "1.25.0",
   "description": "CLI client for Parall — universal agent & human access to Parall API",
   "license": "MIT",
   "repository": {
@@ -30,7 +30,7 @@
     "@modelcontextprotocol/sdk": "1.27.1",
     "commander": "^13.0.0",
     "zod": "^4.3.6",
-    "@parall/sdk": "1.24.0"
+    "@parall/sdk": "1.25.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",