@parall/cli 1.14.4 → 1.15.0

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

package/dist/commands/chats.js

@@ -1,5 +1,5 @@
 import { resolveCredentials } from '../lib/client.js';
-import { printJson, printError } from '../lib/output.js';
+import { printJson, printError, printRefHint, stripPrllScheme } from '../lib/output.js';
 export function registerChatCommands(program) {
     const chats = program.command('chats').description('Manage chats');
     chats
@@ -27,7 +27,7 @@ export function registerChatCommands(program) {
         .action(async (chatId) => {
         try {
             const { client, orgId } = resolveCredentials();
-            const result = await client.getChat(orgId, chatId);
+            const result = await client.getChat(orgId, stripPrllScheme(chatId));
             printJson(result);
         }
         catch (err) {
@@ -46,11 +46,12 @@ export function registerChatCommands(program) {
             const { client, orgId } = resolveCredentials();
             const result = await client.createChat(orgId, {
                 type: opts.type,
-                member_ids: opts.memberIds.split(',').map((s) => s.trim()).filter(Boolean),
+                member_ids: opts.memberIds.split(',').map((s) => stripPrllScheme(s.trim())).filter(Boolean),
                 name: opts.name,
                 description: opts.description,
             });
             printJson(result);
+            printRefHint(result.id);
         }
         catch (err) {
             printError(err);
@@ -64,7 +65,7 @@ export function registerChatCommands(program) {
         .action(async (chatId) => {
         try {
             const { client, orgId } = resolveCredentials();
-            const result = await client.getChatMembers(orgId, chatId);
+            const result = await client.getChatMembers(orgId, stripPrllScheme(chatId));
             printJson(result);
         }
         catch (err) {
@@ -80,7 +81,7 @@ export function registerChatCommands(program) {
         .action(async (chatId, opts) => {
         try {
             const { client, orgId } = resolveCredentials();
-            await client.addChatMember(orgId, chatId, opts.userId, opts.role);
+            await client.addChatMember(orgId, stripPrllScheme(chatId), stripPrllScheme(opts.userId), opts.role);
             printJson({ ok: true });
         }
         catch (err) {
@@ -95,7 +96,7 @@ export function registerChatCommands(program) {
         .action(async (chatId, opts) => {
         try {
             const { client, orgId } = resolveCredentials();
-            await client.removeChatMember(orgId, chatId, opts.userId);
+            await client.removeChatMember(orgId, stripPrllScheme(chatId), stripPrllScheme(opts.userId));
             printJson({ ok: true });
         }
         catch (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;AA2BpC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,QA4BlD"}
+{"version":3,"file":"dm.d.ts","sourceRoot":"","sources":["../../src/commands/dm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA4BpC,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,OAAO,QA6BlD"}

package/dist/commands/dm.js

@@ -1,10 +1,11 @@
 import { resolveCredentials, resolveRuntimeContext } from '../lib/client.js';
-import { printJson, printError } from '../lib/output.js';
+import { printJson, printError, printRefHint, stripPrllScheme } from '../lib/output.js';
 /**
  * Resolve a name-or-id argument to a user ID.
  * If it starts with "usr_", treat as ID. Otherwise, search org members by display_name.
  */
 async function resolveUserId(client, orgId, nameOrId) {
+    nameOrId = stripPrllScheme(nameOrId);
     if (nameOrId.startsWith('usr_'))
         return nameOrId;
     const members = await client.getOrgMembers(orgId);
@@ -43,6 +44,7 @@ export function registerDMCommands(program) {
                 req.agent_step_id = ctx.stepId;
             const result = await client.sendDirectMessage(orgId, req);
             printJson(result);
+            printRefHint(result.message.id, 'Sent');
         }
         catch (err) {
             printError(err);

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;AAKpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,QAiGvD"}
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../../src/commands/messages.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAKpC,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,QAkGvD"}

package/dist/commands/messages.js

@@ -1,5 +1,5 @@
 import { resolveCredentials, resolveRuntimeContext } from '../lib/client.js';
-import { printJson, printError } from '../lib/output.js';
+import { printJson, printError, printRefHint, stripPrllScheme } from '../lib/output.js';
 export function registerMessageCommands(program) {
     const messages = program.command('messages').description('Manage messages');
     messages
@@ -20,10 +20,10 @@ export function registerMessageCommands(program) {
             if (opts.after !== undefined)
                 params.after = opts.after;
             if (opts.threadRootId !== undefined)
-                params.thread_root_id = opts.threadRootId;
+                params.thread_root_id = stripPrllScheme(opts.threadRootId);
             if (opts.topLevel)
                 params.top_level = true;
-            const result = await client.getMessages(orgId, chatId, params);
+            const result = await client.getMessages(orgId, stripPrllScheme(chatId), params);
             printJson(result);
         }
         catch (err) {
@@ -37,7 +37,7 @@ export function registerMessageCommands(program) {
         .action(async (messageId) => {
         try {
             const { client } = resolveCredentials();
-            const result = await client.getMessage(messageId);
+            const result = await client.getMessage(stripPrllScheme(messageId));
             printJson(result);
         }
         catch (err) {
@@ -55,7 +55,7 @@ export function registerMessageCommands(program) {
         try {
             const { client, orgId } = resolveCredentials();
             const ctx = resolveRuntimeContext();
-            const chatId = chatIdArg?.trim() || ctx.chatId;
+            const chatId = stripPrllScheme(chatIdArg?.trim() || ctx.chatId || '');
             if (!chatId) {
                 printError(new Error('Chat ID required — provide as argument or set PRLL_CHAT_ID'));
                 return;
@@ -65,13 +65,14 @@ export function registerMessageCommands(program) {
                 content: { text: opts.text },
             };
             if (opts.threadRootId !== undefined)
-                req.thread_root_id = opts.threadRootId;
+                req.thread_root_id = stripPrllScheme(opts.threadRootId);
             if (opts.reply === false)
                 req.hints = { no_reply: true };
             if (ctx.stepId)
                 req.agent_step_id = ctx.stepId;
             const result = await client.sendMessage(orgId, chatId, req);
             printJson(result);
+            printRefHint(result.id, 'Sent');
         }
         catch (err) {
             printError(err);
@@ -92,7 +93,7 @@ export function registerMessageCommands(program) {
                 params.before = opts.before;
             if (opts.after !== undefined)
                 params.after = opts.after;
-            const result = await client.getMessageReplies(messageId, params);
+            const result = await client.getMessageReplies(stripPrllScheme(messageId), params);
             printJson(result);
         }
         catch (err) {

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

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

package/dist/commands/tasks.js

@@ -1,5 +1,5 @@
 import { resolveCredentials } from '../lib/client.js';
-import { printJson, printError } from '../lib/output.js';
+import { printJson, printError, printRefHint, stripPrllScheme } from '../lib/output.js';
 function stripUndefined(obj) {
     return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== undefined));
 }
@@ -23,9 +23,9 @@ export function registerTaskCommands(program) {
             const params = stripUndefined({
                 status: opts.status,
                 priority: opts.priority,
-                assignee_id: opts.assigneeId,
-                project_id: opts.projectId,
-                parent_id: opts.parentId,
+                assignee_id: opts.assigneeId ? stripPrllScheme(opts.assigneeId) : undefined,
+                project_id: opts.projectId ? stripPrllScheme(opts.projectId) : undefined,
+                parent_id: opts.parentId ? stripPrllScheme(opts.parentId) : undefined,
                 limit: Number(opts.limit),
                 cursor: opts.cursor,
                 sort: opts.sort,
@@ -57,13 +57,14 @@ export function registerTaskCommands(program) {
                 description: opts.description,
                 status: opts.status,
                 priority: opts.priority,
-                assignee_id: opts.assigneeId,
-                project_id: opts.projectId,
-                parent_id: opts.parentId,
-                source_chat_id: opts.sourceChatId,
+                assignee_id: opts.assigneeId ? stripPrllScheme(opts.assigneeId) : undefined,
+                project_id: opts.projectId ? stripPrllScheme(opts.projectId) : undefined,
+                parent_id: opts.parentId ? stripPrllScheme(opts.parentId) : undefined,
+                source_chat_id: opts.sourceChatId ? stripPrllScheme(opts.sourceChatId) : undefined,
             });
             const result = await client.createTask(orgId, data);
             printJson(result);
+            printRefHint(result.id);
         }
         catch (err) {
             printError(err);
@@ -76,7 +77,7 @@ export function registerTaskCommands(program) {
         .action(async (taskId) => {
         try {
             const { client, orgId } = resolveCredentials();
-            const result = await client.getTask(orgId, taskId);
+            const result = await client.getTask(orgId, stripPrllScheme(taskId));
             printJson(result);
         }
         catch (err) {
@@ -97,15 +98,16 @@ export function registerTaskCommands(program) {
         .option('--sort-order <n>', 'Sort order')
         .action(async (taskId, opts) => {
         try {
+            taskId = stripPrllScheme(taskId);
             const { client, orgId } = resolveCredentials();
             const data = stripUndefined({
                 title: opts.title,
                 status: opts.status,
                 priority: opts.priority,
-                assignee_id: opts.assigneeId,
+                assignee_id: opts.assigneeId ? stripPrllScheme(opts.assigneeId) : undefined,
                 description: opts.description,
-                project_id: opts.projectId,
-                parent_id: opts.parentId,
+                project_id: opts.projectId ? stripPrllScheme(opts.projectId) : undefined,
+                parent_id: opts.parentId ? stripPrllScheme(opts.parentId) : undefined,
                 sort_order: opts.sortOrder !== undefined ? Number(opts.sortOrder) : undefined,
             });
             if (Object.keys(data).length === 0) {
@@ -125,7 +127,7 @@ export function registerTaskCommands(program) {
         .action(async (taskId) => {
         try {
             const { client, orgId } = resolveCredentials();
-            await client.deleteTask(orgId, taskId);
+            await client.deleteTask(orgId, stripPrllScheme(taskId));
             printJson({ ok: true });
         }
         catch (err) {
@@ -139,7 +141,7 @@ export function registerTaskCommands(program) {
         .action(async (taskId) => {
         try {
             const { client, orgId } = resolveCredentials();
-            const result = await client.getSubtasks(orgId, taskId);
+            const result = await client.getSubtasks(orgId, stripPrllScheme(taskId));
             printJson(result);
         }
         catch (err) {
@@ -163,7 +165,7 @@ export function registerTaskCommands(program) {
                 cursor: opts.cursor,
                 order: opts.order,
             });
-            const result = await client.getTaskComments(orgId, taskId, params);
+            const result = await client.getTaskComments(orgId, stripPrllScheme(taskId), params);
             printJson(result);
         }
         catch (err) {
@@ -178,8 +180,9 @@ export function registerTaskCommands(program) {
         .action(async (taskId, opts) => {
         try {
             const { client, orgId } = resolveCredentials();
-            const result = await client.createTaskComment(orgId, taskId, { body: opts.body });
+            const result = await client.createTaskComment(orgId, stripPrllScheme(taskId), { body: opts.body });
             printJson(result);
+            printRefHint(result.id);
         }
         catch (err) {
             printError(err);
@@ -194,7 +197,7 @@ export function registerTaskCommands(program) {
         .action(async (taskId, commentId, opts) => {
         try {
             const { client, orgId } = resolveCredentials();
-            const result = await client.updateTaskComment(orgId, taskId, commentId, { body: opts.body });
+            const result = await client.updateTaskComment(orgId, stripPrllScheme(taskId), stripPrllScheme(commentId), { body: opts.body });
             printJson(result);
         }
         catch (err) {
@@ -209,7 +212,7 @@ export function registerTaskCommands(program) {
         .action(async (taskId, commentId) => {
         try {
             const { client, orgId } = resolveCredentials();
-            await client.deleteTaskComment(orgId, taskId, commentId);
+            await client.deleteTaskComment(orgId, stripPrllScheme(taskId), stripPrllScheme(commentId));
             printJson({ ok: true });
         }
         catch (err) {
@@ -230,7 +233,7 @@ export function registerTaskCommands(program) {
                 limit: Number(opts.limit),
                 cursor: opts.cursor,
             });
-            const result = await client.getTaskActivities(orgId, taskId, params);
+            const result = await client.getTaskActivities(orgId, stripPrllScheme(taskId), params);
             printJson(result);
         }
         catch (err) {

package/dist/lib/output.d.ts

@@ -1,3 +1,13 @@
 export declare function printJson(data: unknown): void;
+/**
+ * Print a prll:// URI hint to stderr after a mutation command.
+ * Does not affect stdout JSON, but LLMs see it and can copy-paste the URI.
+ */
+export declare function printRefHint(entityId: string, action?: string): void;
+/**
+ * Strip the `prll://` scheme prefix from an entity ID if present.
+ * Allows CLI commands to accept both raw IDs (`tsk_abc`) and URIs (`prll://tsk_abc`).
+ */
+export declare function stripPrllScheme(idOrUri: string): string;
 export declare function printError(err: unknown): never;
 //# sourceMappingURL=output.d.ts.map

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,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,CAW9C"}

package/dist/lib/output.js

@@ -2,6 +2,20 @@ import { ApiError } from '@parall/sdk';
 export function printJson(data) {
     console.log(JSON.stringify(data, null, 2));
 }
+/**
+ * Print a prll:// URI hint to stderr after a mutation command.
+ * Does not affect stdout JSON, but LLMs see it and can copy-paste the URI.
+ */
+export function printRefHint(entityId, action = 'Created') {
+    console.error(`${action}: prll://${entityId}`);
+}
+/**
+ * Strip the `prll://` scheme prefix from an entity ID if present.
+ * Allows CLI commands to accept both raw IDs (`tsk_abc`) and URIs (`prll://tsk_abc`).
+ */
+export function stripPrllScheme(idOrUri) {
+    return idOrUri.startsWith('prll://') ? idOrUri.slice(7) : idOrUri;
+}
 export function printError(err) {
     let msg;
     if (err instanceof ApiError) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/cli",
-  "version": "1.14.4",
+  "version": "1.15.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.14.4"
+    "@parall/sdk": "1.15.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",