@parall/cli 1.24.0 → 1.26.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/client.d.ts

@@ -13,11 +13,12 @@ export type RuntimeContext = {
     noReply: boolean;
 };
 /**
- * Read per-dispatch context from ENV.
+ * Read per-dispatch context from ENV + sideband files.
  *
- * Step ID resolution order:
- * 1. PRLL_STEP_ID env var (set by openclaw-channel before_tool_call hook)
- * 2. PRLL_STEP_ID_FILE file contents (written by bridge for subprocess runtimes)
+ * Resolution order (first non-empty value wins per field):
+ * 1. PRLL_* env vars (set by OpenClaw/Hermes hooks per tool call)
+ * 2. PRLL_CONTEXT_FILE JSON (written by CC/Codex bridge gateway per dispatch)
+ * 3. PRLL_STEP_ID_FILE plain text (legacy step-id-only backward compat)
  */
 export declare function resolveRuntimeContext(): RuntimeContext;
 export declare function resolveCredentials(): ResolvedCredentials;

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

@@ -1 +1 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,6DAA6D;AAC7D,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oGAAoG;IACpG,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,qBAAqB,IAAI,cAAc,CAmBtD;AAED,wBAAgB,kBAAkB,IAAI,mBAAmB,CAoBxD"}
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/lib/client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,YAAY,CAAC;IACrB,KAAK,EAAE,MAAM,CAAC;CACf,CAAC;AAEF,6DAA6D;AAC7D,MAAM,MAAM,cAAc,GAAG;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oGAAoG;IACpG,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,IAAI,cAAc,CAiCtD;AAED,wBAAgB,kBAAkB,IAAI,mBAAmB,CAoBxD"}

package/dist/lib/client.js

@@ -1,14 +1,36 @@
 import * as fs from 'node:fs';
 import { ParallClient } from '@parall/sdk';
 /**
- * Read per-dispatch context from ENV.
+ * Read per-dispatch context from ENV + sideband files.
  *
- * Step ID resolution order:
- * 1. PRLL_STEP_ID env var (set by openclaw-channel before_tool_call hook)
- * 2. PRLL_STEP_ID_FILE file contents (written by bridge for subprocess runtimes)
+ * Resolution order (first non-empty value wins per field):
+ * 1. PRLL_* env vars (set by OpenClaw/Hermes hooks per tool call)
+ * 2. PRLL_CONTEXT_FILE JSON (written by CC/Codex bridge gateway per dispatch)
+ * 3. PRLL_STEP_ID_FILE plain text (legacy step-id-only backward compat)
  */
 export function resolveRuntimeContext() {
+    let sessionId = process.env.PRLL_SESSION_ID?.trim() || undefined;
     let stepId = process.env.PRLL_STEP_ID?.trim() || undefined;
+    let chatId = process.env.PRLL_CHAT_ID?.trim() || undefined;
+    let triggerMessageId = process.env.PRLL_TRIGGER_MESSAGE_ID?.trim() || undefined;
+    let noReply = process.env.PRLL_NO_REPLY === '1';
+    if (process.env.PRLL_CONTEXT_FILE) {
+        try {
+            const raw = fs.readFileSync(process.env.PRLL_CONTEXT_FILE, 'utf-8').trim();
+            if (raw) {
+                const ctx = JSON.parse(raw);
+                sessionId ??= ctx.session_id || undefined;
+                chatId ??= ctx.chat_id || undefined;
+                triggerMessageId ??= ctx.trigger_message_id || undefined;
+                stepId ??= ctx.step_id || undefined;
+                if (ctx.no_reply === true)
+                    noReply = true;
+            }
+        }
+        catch {
+            // File not yet written or malformed — no context
+        }
+    }
     if (!stepId && process.env.PRLL_STEP_ID_FILE) {
         try {
             const content = fs.readFileSync(process.env.PRLL_STEP_ID_FILE, 'utf-8').trim();
@@ -19,13 +41,7 @@ export function resolveRuntimeContext() {
             // File not yet written or unreadable — no step context
         }
     }
-    return {
-        sessionId: process.env.PRLL_SESSION_ID?.trim() || undefined,
-        stepId,
-        chatId: process.env.PRLL_CHAT_ID?.trim() || undefined,
-        triggerMessageId: process.env.PRLL_TRIGGER_MESSAGE_ID?.trim() || undefined,
-        noReply: process.env.PRLL_NO_REPLY === '1',
-    };
+    return { sessionId, stepId, chatId, triggerMessageId, noReply };
 }
 export function resolveCredentials() {
     const url = process.env.PRLL_API_URL;

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.26.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.26.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",