@parall/cli 1.31.0 → 1.32.1

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

@@ -1 +1 @@
-{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/commands/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,KAAK,EAAE,aAAa,EAAsB,mBAAmB,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAgCjH,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,QAgBA;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,QAWA;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IAAE,IAAI,CAAC,EAAE,OAAO,CAAC;IAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,QAIvG;AAuBD,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,mBAAmB,EAAE,IAAI,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE;;;;;;GAQ5H;AAMD,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,cAAc,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;gBAEZ,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,cAAc,EAAE,KAAK,CAAC,EAAE,MAAM;CAM/E;AAQD,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAc9C;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,aAAa,CAAC,CASxB;AA4CD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,QAoIrD"}
+{"version":3,"file":"agents.d.ts","sourceRoot":"","sources":["../../src/commands/agents.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,KAAK,EACV,aAAa,EAEb,mBAAmB,EACnB,OAAO,EACP,YAAY,EACb,MAAM,aAAa,CAAC;AAmCrB,wBAAgB,sBAAsB,CAAC,IAAI,EAAE;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,QAqBA;AAED,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,QAmBA;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,QAIA;AAuBD,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,mBAAmB,EAC3B,IAAI,EAAE;IAAE,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,aAAa,CAAC,EAAE,OAAO,CAAA;CAAE;;;;;;GASvD;AAMD,qBAAa,qBAAsB,SAAQ,KAAK;IAC9C,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,cAAc,CAAC;IAC3C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;gBAEZ,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,GAAG,cAAc,EAAE,KAAK,CAAC,EAAE,MAAM;CAM/E;AAaD,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAuB9C;AAED,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,IAAI,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC7C,OAAO,CAAC,aAAa,CAAC,CASxB;AA6CD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,QAiJrD"}

package/dist/commands/agents.js

@@ -16,7 +16,10 @@ function parseOptionalInt(value, field) {
 function parsePermissions(value) {
     if (!value)
         return undefined;
-    const permissions = value.split(',').map((v) => v.trim()).filter(Boolean);
+    const permissions = value
+        .split(',')
+        .map((v) => v.trim())
+        .filter(Boolean);
     return permissions.length > 0 ? permissions : undefined;
 }
 function parseOptionalSeconds(value, field, fallback) {
@@ -40,13 +43,19 @@ export function validateMachineOptions(opts) {
         throw new Error('cpu-cores/memory-mb/storage-gb require --machine-label custom');
     }
     if (opts.machineType === 'cloud' && opts.machineLabel === 'custom') {
-        if (opts.cpuCores === undefined || opts.memoryMB === undefined || opts.storageGB === undefined) {
+        if (opts.cpuCores === undefined ||
+            opts.memoryMB === undefined ||
+            opts.storageGB === undefined) {
             throw new Error('custom machine requires --cpu-cores --memory-mb --storage-gb');
         }
     }
 }
 export function validateApiKeyOutputOptions(opts) {
-    const selected = [opts.apiKeyFile !== undefined, opts.showApiKey === true, opts.discardApiKey === true].filter(Boolean).length;
+    const selected = [
+        opts.apiKeyFile !== undefined,
+        opts.showApiKey === true,
+        opts.discardApiKey === true,
+    ].filter(Boolean).length;
     if (selected > 1) {
         throw new Error('--api-key-file, --show-api-key, and --discard-api-key are mutually exclusive');
     }

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,QAkIxD"}
+{"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,QAmIxD"}

package/dist/commands/approvals.js

@@ -96,8 +96,8 @@ export function registerApprovalCommands(program) {
             const deadline = Date.now() + timeoutMs;
             while (true) {
                 const approval = await client.getApproval(id);
-                const isTerminal = approval.status !== 'pending'
-                    && !(approval.status === 'approved' && !approval.execution_status);
+                const isTerminal = approval.status !== 'pending' &&
+                    !(approval.status === 'approved' && !approval.execution_status);
                 if (isTerminal) {
                     printJson(approval);
                     const ok = approval.status === 'approved' && approval.execution_status === 'succeeded';
@@ -109,7 +109,7 @@ export function registerApprovalCommands(program) {
                     console.error('Timed out waiting for approval decision');
                     process.exit(2);
                 }
-                await new Promise(r => setTimeout(r, Math.min(pollMs, deadline - now)));
+                await new Promise((r) => setTimeout(r, Math.min(pollMs, deadline - now)));
             }
         }
         catch (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,QAyIpD"}
+{"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,QAiJpD"}

package/dist/commands/chats.js

@@ -82,7 +82,10 @@ export function registerChatCommands(program) {
             const { client, orgId } = resolveCredentials();
             const result = await client.createChat(orgId, {
                 type: opts.type,
-                member_ids: opts.memberIds.split(',').map((s) => stripPrllScheme(s.trim())).filter(Boolean),
+                member_ids: opts.memberIds
+                    .split(',')
+                    .map((s) => stripPrllScheme(s.trim()))
+                    .filter(Boolean),
                 name: opts.name,
                 description: opts.description,
             });

package/dist/commands/clip.d.ts

@@ -0,0 +1,3 @@
+import { Command } from 'commander';
+export declare function registerClipCommands(program: Command): void;
+//# sourceMappingURL=clip.d.ts.map

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

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

package/dist/commands/clip.js

@@ -0,0 +1,178 @@
+import { resolveCredentials } from '../lib/client.js';
+import { printJson, printError } from '../lib/output.js';
+/**
+ * Derive a CLI-friendly alias from a registry source string.
+ * Handles scoped packages ("@scope/name@1.0.0" → "name") and
+ * plain packages ("name@1.0.0" → "name").
+ */
+function deriveAlias(source) {
+    let s = source.trim();
+    if (s.startsWith('@')) {
+        const slashIdx = s.indexOf('/');
+        if (slashIdx > 0) {
+            const rest = s.slice(slashIdx + 1);
+            const atIdx = rest.indexOf('@');
+            s = atIdx > 0 ? rest.slice(0, atIdx) : rest;
+        }
+    }
+    else {
+        const atIdx = s.indexOf('@');
+        if (atIdx > 0)
+            s = s.slice(0, atIdx);
+    }
+    // Normalize to server's allowed alias charset: ^[a-z0-9][a-z0-9-_]*$
+    return s
+        .toLowerCase()
+        .replace(/[^a-z0-9-_]/g, '-')
+        .replace(/^[^a-z0-9]+/, '');
+}
+export function registerClipCommands(program) {
+    const clip = program.command('clip').description('Manage clips');
+    clip
+        .command('list')
+        .description('List clips in the organization')
+        .action(async () => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const clips = await client.listClips(orgId);
+            // Table display: alias, name, version, status, source_type
+            if (clips.length === 0) {
+                printJson({ data: [], message: 'No clips found' });
+                return;
+            }
+            const rows = clips.map((c) => ({
+                alias: c.alias,
+                name: c.name,
+                version: c.version ?? '-',
+                status: c.status,
+                source_type: c.source_type,
+            }));
+            printJson(rows);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    clip
+        .command('install')
+        .description('Install a clip from a registry source')
+        .argument('<source>', 'Registry source identifier (used as name and alias)')
+        .option('--alias <alias>', 'Override the alias (default: derived from source)')
+        .action(async (source, opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            // Derive alias: take the last segment, replace non-alphanumeric with dash, lowercase.
+            const alias = opts.alias ?? deriveAlias(source);
+            const req = {
+                alias,
+                name: source,
+                manifest: {},
+                source_type: 'registry',
+                source_ref: source,
+            };
+            const clip = await client.createClip(orgId, req);
+            printJson(clip);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    clip
+        .command('info')
+        .description('Show detailed information about a clip by alias')
+        .argument('<alias>', 'Clip alias')
+        .action(async (alias) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const clips = await client.listClips(orgId);
+            const found = clips.find((c) => c.alias === alias);
+            if (!found) {
+                printError(new Error(`Clip with alias "${alias}" not found`));
+            }
+            // Display full details including manifest commands
+            const info = {
+                id: found.id,
+                alias: found.alias,
+                name: found.name,
+                version: found.version,
+                description: found.description,
+                status: found.status,
+                source_type: found.source_type,
+                source_ref: found.source_ref,
+                manifest: found.manifest,
+                created_at: found.created_at,
+                updated_at: found.updated_at,
+            };
+            printJson(info);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    clip
+        .command('invoke')
+        .description('Invoke a clip command')
+        .argument('<alias>', 'Clip alias')
+        .argument('<command>', 'Command name to invoke')
+        .argument('[input]', 'Input data (JSON string or plain text)')
+        .option('--timeout <ms>', 'Timeout in milliseconds', '30000')
+        .action(async (alias, command, input, opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            // Parse input: try JSON first, fall back to plain text wrapping.
+            let parsedInput = undefined;
+            if (input !== undefined) {
+                try {
+                    parsedInput = JSON.parse(input);
+                }
+                catch {
+                    // Not valid JSON — send as a plain string.
+                    parsedInput = input;
+                }
+            }
+            let timeoutMs;
+            if (opts?.timeout) {
+                timeoutMs = parseInt(opts.timeout, 10);
+                if (isNaN(timeoutMs) || timeoutMs <= 0) {
+                    printError(new Error('--timeout must be a positive integer (milliseconds)'));
+                }
+            }
+            const req = {
+                alias,
+                command,
+                input: parsedInput,
+                timeout_ms: timeoutMs,
+            };
+            const result = await client.invokeClip(orgId, req);
+            if (result.error) {
+                printError(new Error(result.error));
+            }
+            else {
+                printJson(result.output);
+            }
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    clip
+        .command('remove')
+        .description('Remove a clip by alias')
+        .argument('<alias>', 'Clip alias')
+        .action(async (alias) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            // Resolve alias to clip ID
+            const clips = await client.listClips(orgId);
+            const found = clips.find((c) => c.alias === alias);
+            if (!found) {
+                printError(new Error(`Clip with alias "${alias}" not found`));
+            }
+            await client.deleteClip(orgId, found.id);
+            printJson({ ok: true, removed: alias });
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+}

package/dist/commands/comments.d.ts

@@ -0,0 +1,10 @@
+import { Command } from 'commander';
+/**
+ * Generic, target-agnostic comment commands over `POST/GET/PATCH/DELETE
+ * /comments`. Unlike `parall tasks comments` (task-only) and `parall wiki
+ * comment` (wiki page/changeset, builds the URI for you), this group takes a
+ * raw `prll://` target URI, so an agent dispatched on a wiki comment can reply
+ * by echoing the exact `target_uri` it received.
+ */
+export declare function registerCommentCommands(program: Command): void;
+//# sourceMappingURL=comments.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"comments.d.ts","sourceRoot":"","sources":["../../src/commands/comments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAgBpC;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,QAoGvD"}

package/dist/commands/comments.js

@@ -0,0 +1,115 @@
+import { resolveCredentials } from '../lib/client.js';
+import { printError, printJson, printRefHint, stripPrllScheme } from '../lib/output.js';
+function stripUndefined(obj) {
+    return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== undefined));
+}
+// The unified comment API addresses targets by full `prll://` URI (task,
+// wiki page, wiki changeset, or wiki inline anchor). Accept the URI with or
+// without the scheme so `--target prll://wik_x/Foo.md` and `--target
+// wik_x/Foo.md` both work.
+function normalizeTarget(target) {
+    return target.startsWith('prll://') ? target : `prll://${target}`;
+}
+/**
+ * Generic, target-agnostic comment commands over `POST/GET/PATCH/DELETE
+ * /comments`. Unlike `parall tasks comments` (task-only) and `parall wiki
+ * comment` (wiki page/changeset, builds the URI for you), this group takes a
+ * raw `prll://` target URI, so an agent dispatched on a wiki comment can reply
+ * by echoing the exact `target_uri` it received.
+ */
+export function registerCommentCommands(program) {
+    const comments = program
+        .command('comments')
+        .description('Manage comments on any prll:// target (task / wiki page / changeset / inline anchor)');
+    comments
+        .command('add')
+        .description('Add a comment to a prll:// target')
+        .requiredOption('--target <uri>', 'Target prll:// URI (task / wiki page / changeset / inline anchor)')
+        .requiredOption('--body <text>', 'Comment body')
+        .option('--parent <id>', 'Parent comment ID (task comments only — threaded reply)')
+        .action(async (opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const result = await client.createComment(orgId, {
+                target_uri: normalizeTarget(opts.target),
+                body: opts.body,
+                parent_id: opts.parent ? stripPrllScheme(opts.parent) : undefined,
+            });
+            printJson(result);
+            printRefHint(result.id);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    comments
+        .command('list')
+        .description('List comments on a prll:// target')
+        .requiredOption('--target <uri>', 'Target prll:// URI')
+        .option('--limit <n>', 'Maximum number of comments to return', '50')
+        .option('--cursor <cursor>', 'Pagination cursor')
+        .option('--order <order>', 'Sort order (asc or desc)')
+        .action(async (opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const params = stripUndefined({
+                limit: Number(opts.limit),
+                cursor: opts.cursor,
+                order: opts.order,
+            });
+            const result = await client.getComments(orgId, {
+                target_uri: normalizeTarget(opts.target),
+                ...params,
+            });
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    comments
+        .command('get')
+        .description('Get a single comment by ID')
+        .argument('<commentId>', 'Comment ID')
+        .action(async (commentId) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const result = await client.getComment(orgId, stripPrllScheme(commentId));
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    comments
+        .command('update')
+        .description('Update a comment (author only)')
+        .argument('<commentId>', 'Comment ID')
+        .requiredOption('--body <text>', 'New comment body')
+        .action(async (commentId, opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const result = await client.updateComment(orgId, stripPrllScheme(commentId), {
+                body: opts.body,
+            });
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    comments
+        .command('delete')
+        .description('Delete a comment (author only)')
+        .argument('<commentId>', 'Comment ID')
+        .action(async (commentId) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            await client.deleteComment(orgId, stripPrllScheme(commentId));
+            printJson({ ok: true });
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+}

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

@@ -1 +1 @@
-{"version":3,"file":"dm.d.ts","sourceRoot":"","sources":["../../src/commands/dm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA6BpC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,QAmDlD"}
+{"version":3,"file":"dm.d.ts","sourceRoot":"","sources":["../../src/commands/dm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAiCpC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,QAwDlD"}

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

@@ -1 +1 @@
-{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/commands/files.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAoEpD"}
+{"version":3,"file":"files.d.ts","sourceRoot":"","sources":["../../src/commands/files.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAkEpD"}

package/dist/commands/files.js

@@ -43,9 +43,7 @@ export function registerFileCommands(program) {
             // Sanitize server-provided filename to prevent path traversal
             const safeName = path.basename(fileInfo.file_name || id);
             // Determine output path
-            const outputPath = opts.output
-                ? path.resolve(opts.output)
-                : path.resolve(safeName);
+            const outputPath = opts.output ? path.resolve(opts.output) : path.resolve(safeName);
             // If output is a directory, write file inside it
             let finalPath = outputPath;
             if (fs.existsSync(outputPath) && fs.statSync(outputPath).isDirectory()) {

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

@@ -1 +1 @@
-{"version":3,"file":"machines.d.ts","sourceRoot":"","sources":["../../src/commands/machines.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,QAoFvD"}
+{"version":3,"file":"machines.d.ts","sourceRoot":"","sources":["../../src/commands/machines.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAapC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,QAwFvD"}

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

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmBpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,QAycnD"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/commands/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAmBpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,QAulBnD"}

package/dist/commands/mcp.js

@@ -168,7 +168,9 @@ export function registerMcpCommands(program) {
                 size: result.size,
             };
             return {
-                content: [{ type: 'text', text: result.content || JSON.stringify(structuredContent, null, 2) }],
+                content: [
+                    { type: 'text', text: result.content || JSON.stringify(structuredContent, null, 2) },
+                ],
                 structuredContent,
             };
         });
@@ -182,9 +184,21 @@ export function registerMcpCommands(program) {
                 wiki: z.string().describe('Wiki slug or ID'),
                 query: z.string().describe('Search query'),
                 ref: z.string().optional().describe('Optional git ref for API-backed search'),
-                path_prefix: z.string().optional().describe('Restrict search to a file or directory path prefix'),
-                limit: z.number().int().positive().max(20).optional().describe('Maximum number of results; default 5'),
-                include_content: z.boolean().optional().describe('Include full matched section content in each result'),
+                path_prefix: z
+                    .string()
+                    .optional()
+                    .describe('Restrict search to a file or directory path prefix'),
+                limit: z
+                    .number()
+                    .int()
+                    .positive()
+                    .max(20)
+                    .optional()
+                    .describe('Maximum number of results; default 5'),
+                include_content: z
+                    .boolean()
+                    .optional()
+                    .describe('Include full matched section content in each result'),
             },
             outputSchema: {
                 results: z.array(z.object({
@@ -205,7 +219,7 @@ export function registerMcpCommands(program) {
                     source: z.enum(['local_mount', 'api']),
                 })),
             },
-        }, async ({ wiki, query, ref, path_prefix: pathPrefix, limit, include_content: includeContent }) => {
+        }, async ({ wiki, query, ref, path_prefix: pathPrefix, limit, include_content: includeContent, }) => {
             const results = await searchWiki(ctx, wiki, query, {
                 ref,
                 pathPrefix,
@@ -228,9 +242,21 @@ export function registerMcpCommands(program) {
                 wiki: z.string().describe('Wiki slug or ID'),
                 query: z.string().describe('Natural-language query'),
                 ref: z.string().optional().describe('Optional git ref for API-backed queries'),
-                path_prefix: z.string().optional().describe('Restrict the query to a file or directory path prefix'),
-                limit: z.number().int().positive().max(20).optional().describe('Maximum number of section results; default 5'),
-                include_content: z.boolean().optional().describe('Include full matched section content in each result'),
+                path_prefix: z
+                    .string()
+                    .optional()
+                    .describe('Restrict the query to a file or directory path prefix'),
+                limit: z
+                    .number()
+                    .int()
+                    .positive()
+                    .max(20)
+                    .optional()
+                    .describe('Maximum number of section results; default 5'),
+                include_content: z
+                    .boolean()
+                    .optional()
+                    .describe('Include full matched section content in each result'),
             },
             outputSchema: {
                 wiki_id: z.string(),
@@ -269,7 +295,7 @@ export function registerMcpCommands(program) {
                     reasoning: z.array(z.string()),
                 })),
             },
-        }, async ({ wiki, query, ref, path_prefix: pathPrefix, limit, include_content: includeContent }) => {
+        }, async ({ wiki, query, ref, path_prefix: pathPrefix, limit, include_content: includeContent, }) => {
             const result = await queryWiki(ctx, wiki, query, {
                 ref,
                 pathPrefix,
@@ -290,7 +316,10 @@ export function registerMcpCommands(program) {
             inputSchema: {
                 wiki: z.string().describe('Wiki slug or ID'),
                 ref: z.string().optional().describe('Optional git ref for API-backed outline'),
-                path_prefix: z.string().optional().describe('Restrict outline to a file or directory path prefix'),
+                path_prefix: z
+                    .string()
+                    .optional()
+                    .describe('Restrict outline to a file or directory path prefix'),
             },
             outputSchema: {
                 wiki_id: z.string(),
@@ -331,7 +360,10 @@ export function registerMcpCommands(program) {
             inputSchema: {
                 wiki: z.string().describe('Wiki slug or ID'),
                 node_id: z.string().describe('Section node ID returned by wiki_search'),
-                ref: z.string().optional().describe('Optional git ref; when set, reads from the Parall API instead of a local mount'),
+                ref: z
+                    .string()
+                    .optional()
+                    .describe('Optional git ref; when set, reads from the Parall API instead of a local mount'),
             },
             outputSchema: {
                 wiki_id: z.string(),
@@ -392,11 +424,23 @@ export function registerMcpCommands(program) {
             inputSchema: {
                 wiki: z.string().describe('Wiki slug or ID'),
                 title: z.string().min(1).describe('Changeset title'),
-                message: z.string().optional().describe('Changeset commit message (supports prll:// refs)'),
+                message: z
+                    .string()
+                    .optional()
+                    .describe('Changeset commit message (supports prll:// refs)'),
                 changeset_id: z.string().optional().describe('Existing changeset ID to update'),
-                source_chat_id: z.string().optional().describe('Optional source chat ID for approval workflow linkage'),
-                source_message_id: z.string().optional().describe('Optional source message ID for approval workflow linkage'),
-                source_run_id: z.string().optional().describe('Optional source run ID for approval workflow linkage'),
+                source_chat_id: z
+                    .string()
+                    .optional()
+                    .describe('Optional source chat ID for approval workflow linkage'),
+                source_message_id: z
+                    .string()
+                    .optional()
+                    .describe('Optional source message ID for approval workflow linkage'),
+                source_run_id: z
+                    .string()
+                    .optional()
+                    .describe('Optional source run ID for approval workflow linkage'),
             },
             outputSchema: {
                 wiki_id: z.string(),
@@ -408,12 +452,14 @@ export function registerMcpCommands(program) {
                 auto_merged: z.boolean(),
                 requires_review: z.boolean(),
                 next_action: z.string(),
-                post_merge_sync: z.object({
+                post_merge_sync: z
+                    .object({
                     applied: z.number(),
                     fastForwarded: z.number(),
                     conflicts: z.array(z.unknown()),
                     failed: z.array(z.unknown()),
-                }).nullable(),
+                })
+                    .nullable(),
                 post_merge_sync_error: z.string().nullable(),
                 diff_files: z.array(z.object({
                     path: z.string(),
@@ -421,15 +467,17 @@ export function registerMcpCommands(program) {
                     deletions: z.number(),
                 })),
                 source: z.literal('local_mount'),
-                changeset: z.object({
+                changeset: z
+                    .object({
                     id: z.string(),
                     wiki_id: z.string(),
                     title: z.string(),
                     status: z.string(),
                     changed_paths: z.array(z.string()).optional(),
-                }).passthrough(),
+                })
+                    .passthrough(),
             },
-        }, async ({ wiki, title, message, changeset_id: changesetId, source_chat_id: sourceChatId, source_message_id: sourceMessageId, source_run_id: sourceRunId }) => {
+        }, async ({ wiki, title, message, changeset_id: changesetId, source_chat_id: sourceChatId, source_message_id: sourceMessageId, source_run_id: sourceRunId, }) => {
             const runtime = resolveRuntimeContext();
             const result = await proposeWikiChangeset(ctx, wiki, {
                 title,

package/dist/commands/messages.d.ts

@@ -1,3 +1,3 @@
-import { Command } from 'commander';
+import type { Command } from 'commander';
 export declare function registerMessageCommands(program: Command): void;
 //# sourceMappingURL=messages.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/commands/messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAMpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,QA0HvD"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/commands/messages.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKzC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,QAqJvD"}

package/dist/commands/messages.js

@@ -1,5 +1,6 @@
+import { ApiError } from '@parall/sdk';
 import { resolveCredentials, resolveRuntimeContext } from '../lib/client.js';
-import { printJson, printError, printRefHint, stripPrllScheme } from '../lib/output.js';
+import { printError, printJson, printRefHint, stripPrllScheme } from '../lib/output.js';
 import { uploadFile } from '../lib/upload.js';
 export function registerMessageCommands(program) {
     const messages = program.command('messages').description('Manage messages');
@@ -63,6 +64,12 @@ export function registerMessageCommands(program) {
                 printError(new Error('Chat ID required — provide as argument or set PRLL_CHAT_ID'));
                 return;
             }
+            // `messages send` targets a chat. A user id here is an addressing
+            // mistake — point at `dm` instead of letting the server reject it.
+            if (chatId.startsWith('usr_')) {
+                printError(new ApiError(400, `prll://${chatId} is a user, not a chat. To message a user use: parall dm prll://${chatId} --text "..."`, 'INVALID_TARGET'));
+                return;
+            }
             if (opts.file && opts.attachment) {
                 printError(new Error('--file and --attachment are mutually exclusive'));
                 return;
@@ -112,7 +119,9 @@ export function registerMessageCommands(program) {
         .action(async (messageId, opts) => {
         try {
             const { client } = resolveCredentials();
-            const params = { limit: Number(opts.limit) };
+            const params = {
+                limit: Number(opts.limit),
+            };
             if (opts.before !== undefined)
                 params.before = stripPrllScheme(opts.before);
             if (opts.after !== undefined)

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

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