@parall/cli 1.12.0

package/dist/commands/messages.js

@@ -0,0 +1,102 @@
+import { resolveCredentials, resolveRuntimeContext } from '../lib/client.js';
+import { printJson, printError } from '../lib/output.js';
+export function registerMessageCommands(program) {
+    const messages = program.command('messages').description('Manage messages');
+    messages
+        .command('list')
+        .description('List messages in a chat')
+        .argument('<chatId>', 'Chat ID')
+        .option('--limit <n>', 'Maximum number of messages to return', '20')
+        .option('--before <cursor>', 'Cursor for messages before')
+        .option('--after <cursor>', 'Cursor for messages after')
+        .option('--thread-root-id <id>', 'Filter by thread root message ID')
+        .option('--top-level', 'Only return top-level messages')
+        .action(async (chatId, opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const params = { limit: Number(opts.limit) };
+            if (opts.before !== undefined)
+                params.before = opts.before;
+            if (opts.after !== undefined)
+                params.after = opts.after;
+            if (opts.threadRootId !== undefined)
+                params.thread_root_id = opts.threadRootId;
+            if (opts.topLevel)
+                params.top_level = true;
+            const result = await client.getMessages(orgId, chatId, params);
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    messages
+        .command('get')
+        .description('Get a message by ID')
+        .argument('<messageId>', 'Message ID')
+        .action(async (messageId) => {
+        try {
+            const { client } = resolveCredentials();
+            const result = await client.getMessage(messageId);
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    messages
+        .command('send')
+        .description('Send a text message to a chat')
+        .argument('[chatId]', 'Chat ID (defaults to PRLL_CHAT_ID if set)')
+        .requiredOption('--text <text>', 'Message text')
+        .option('--thread-root-id <id>', 'Reply to a thread')
+        .option('--no-reply', 'Hint that the recipient should not reply')
+        .action(async (chatIdArg, opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const ctx = resolveRuntimeContext();
+            const chatId = chatIdArg?.trim() || ctx.chatId;
+            if (!chatId) {
+                printError(new Error('Chat ID required — provide as argument or set PRLL_CHAT_ID'));
+                return;
+            }
+            const req = {
+                message_type: 'text',
+                content: { text: opts.text },
+            };
+            if (opts.threadRootId !== undefined)
+                req.thread_root_id = 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);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    messages
+        .command('replies')
+        .description('Get replies to a message')
+        .argument('<messageId>', 'Message ID')
+        .option('--limit <n>', 'Maximum number of replies to return', '20')
+        .option('--before <cursor>', 'Cursor for replies before')
+        .option('--after <cursor>', 'Cursor for replies after')
+        .action(async (messageId, opts) => {
+        try {
+            const { client } = resolveCredentials();
+            const params = { limit: Number(opts.limit) };
+            if (opts.before !== undefined)
+                params.before = opts.before;
+            if (opts.after !== undefined)
+                params.after = opts.after;
+            const result = await client.getMessageReplies(messageId, params);
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+}

package/dist/commands/projects.d.ts

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

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

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

package/dist/commands/projects.js

@@ -0,0 +1,104 @@
+import { resolveCredentials } from '../lib/client.js';
+import { printJson, printError } from '../lib/output.js';
+export function registerProjectCommands(program) {
+    const projects = program.command('projects').description('Manage projects');
+    projects
+        .command('list')
+        .description('List projects in the organization')
+        .action(async () => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const result = await client.getProjects(orgId);
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    projects
+        .command('get')
+        .description('Get a project by ID')
+        .argument('<projectId>', 'Project ID')
+        .action(async (projectId) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const result = await client.getProject(orgId, projectId);
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    projects
+        .command('create')
+        .description('Create a new project')
+        .requiredOption('--name <name>', 'Project name')
+        .requiredOption('--key <key>', 'Project key')
+        .option('--description <text>', 'Project description')
+        .option('--lead-id <id>', 'Lead user ID')
+        .option('--color <hex>', 'Project color (hex)')
+        .action(async (opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            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.color !== undefined)
+                data.color = opts.color;
+            const result = await client.createProject(orgId, data);
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    projects
+        .command('update')
+        .description('Update a project')
+        .argument('<projectId>', 'Project ID')
+        .option('--name <name>', 'Project name')
+        .option('--description <text>', 'Project description')
+        .option('--lead-id <id>', 'Lead user ID')
+        .option('--color <hex>', 'Project color (hex)')
+        .option('--status <status>', 'Project status')
+        .action(async (projectId, opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const data = {};
+            if (opts.name !== undefined)
+                data.name = opts.name;
+            if (opts.description !== undefined)
+                data.description = opts.description;
+            if (opts.leadId !== undefined)
+                data.lead_id = opts.leadId;
+            if (opts.color !== undefined)
+                data.color = opts.color;
+            if (opts.status !== undefined)
+                data.status = opts.status;
+            if (Object.keys(data).length === 0) {
+                printError(new Error('No fields to update. Provide at least one option.'));
+            }
+            const result = await client.updateProject(orgId, projectId, data);
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    projects
+        .command('delete')
+        .description('Delete a project')
+        .argument('<projectId>', 'Project ID')
+        .action(async (projectId) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            await client.deleteProject(orgId, projectId);
+            printJson({ deleted: projectId });
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+}

package/dist/commands/refs.d.ts

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/commands/refs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAIpC,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,OAAO,QA+CnD"}

package/dist/commands/refs.js

@@ -0,0 +1,50 @@
+import { resolveCredentials } from '../lib/client.js';
+import { printJson, printError } from '../lib/output.js';
+export function registerRefCommands(program) {
+    const refs = program.command('refs').description('Reference resolution and backlinks');
+    refs
+        .command('resolve <uris...>')
+        .description('Batch resolve prll:// URIs to entity metadata')
+        .action(async (uris) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const result = await client.resolveRefs(orgId, uris);
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    refs
+        .command('backlinks <uri>')
+        .description('List backlinks pointing to a prll:// URI')
+        .option('--limit <n>', 'Maximum number of backlinks', '20')
+        .option('--cursor <cursor>', 'Pagination cursor')
+        .action(async (uri, opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const result = await client.getBacklinks(orgId, {
+                uri,
+                limit: Number(opts.limit),
+                cursor: opts.cursor,
+            });
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    refs
+        .command('check')
+        .description('Check for broken references in the organization (admin only)')
+        .action(async () => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const result = await client.checkBrokenRefs(orgId);
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+}

package/dist/commands/tasks.d.ts

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

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

@@ -0,0 +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"}

package/dist/commands/tasks.js

@@ -0,0 +1,240 @@
+import { resolveCredentials } from '../lib/client.js';
+import { printJson, printError } from '../lib/output.js';
+function stripUndefined(obj) {
+    return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== undefined));
+}
+export function registerTaskCommands(program) {
+    const tasks = program.command('tasks').description('Manage tasks');
+    tasks
+        .command('list')
+        .description('List tasks in the organization')
+        .option('--status <status>', 'Filter by status')
+        .option('--priority <priority>', 'Filter by priority')
+        .option('--assignee-id <id>', 'Filter by assignee ID')
+        .option('--project-id <id>', 'Filter by project ID')
+        .option('--parent-id <id>', 'Filter by parent task ID')
+        .option('--limit <n>', 'Maximum number of tasks to return', '20')
+        .option('--cursor <cursor>', 'Pagination cursor')
+        .option('--sort <field>', 'Sort field')
+        .option('--order <order>', 'Sort order (asc or desc)')
+        .action(async (opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const params = stripUndefined({
+                status: opts.status,
+                priority: opts.priority,
+                assignee_id: opts.assigneeId,
+                project_id: opts.projectId,
+                parent_id: opts.parentId,
+                limit: Number(opts.limit),
+                cursor: opts.cursor,
+                sort: opts.sort,
+                order: opts.order,
+            });
+            const result = await client.getTasks(orgId, params);
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    tasks
+        .command('create')
+        .description('Create a new task')
+        .requiredOption('--title <title>', 'Task title')
+        .option('--description <text>', 'Task description')
+        .option('--status <status>', 'Task status')
+        .option('--priority <priority>', 'Task priority')
+        .option('--assignee-id <id>', 'Assignee user ID')
+        .option('--project-id <id>', 'Project ID')
+        .option('--parent-id <id>', 'Parent task ID')
+        .option('--source-chat-id <id>', 'Source chat ID')
+        .action(async (opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const data = stripUndefined({
+                title: opts.title,
+                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,
+            });
+            const result = await client.createTask(orgId, data);
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    tasks
+        .command('get')
+        .description('Get a task by ID')
+        .argument('<taskId>', 'Task ID')
+        .action(async (taskId) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const result = await client.getTask(orgId, taskId);
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    tasks
+        .command('update')
+        .description('Update a task')
+        .argument('<taskId>', 'Task ID')
+        .option('--title <title>', 'Task title')
+        .option('--status <status>', 'Task status')
+        .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>', 'Sort order')
+        .action(async (taskId, opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const data = stripUndefined({
+                title: opts.title,
+                status: opts.status,
+                priority: opts.priority,
+                assignee_id: opts.assigneeId,
+                description: opts.description,
+                project_id: opts.projectId,
+                parent_id: opts.parentId,
+                sort_order: opts.sortOrder !== undefined ? Number(opts.sortOrder) : undefined,
+            });
+            if (Object.keys(data).length === 0) {
+                printError(new Error('No fields to update. Provide at least one option.'));
+            }
+            const result = await client.updateTask(orgId, taskId, data);
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    tasks
+        .command('delete')
+        .description('Delete a task')
+        .argument('<taskId>', 'Task ID')
+        .action(async (taskId) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            await client.deleteTask(orgId, taskId);
+            printJson({ ok: true });
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    tasks
+        .command('subtasks')
+        .description('List subtasks of a task')
+        .argument('<taskId>', 'Task ID')
+        .action(async (taskId) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const result = await client.getSubtasks(orgId, taskId);
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    // ---- Comments subgroup ----
+    const comments = tasks.command('comments').description('Manage task comments');
+    comments
+        .command('list')
+        .description('List comments on a task')
+        .argument('<taskId>', 'Task ID')
+        .option('--limit <n>', 'Maximum number of comments to return', '20')
+        .option('--cursor <cursor>', 'Pagination cursor')
+        .option('--order <order>', 'Sort order (asc or desc)')
+        .action(async (taskId, opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const params = stripUndefined({
+                limit: Number(opts.limit),
+                cursor: opts.cursor,
+                order: opts.order,
+            });
+            const result = await client.getTaskComments(orgId, taskId, params);
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    comments
+        .command('add')
+        .description('Add a comment to a task')
+        .argument('<taskId>', 'Task ID')
+        .requiredOption('--body <text>', 'Comment body')
+        .action(async (taskId, opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const result = await client.createTaskComment(orgId, taskId, { body: opts.body });
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    comments
+        .command('update')
+        .description('Update a task comment')
+        .argument('<taskId>', 'Task ID')
+        .argument('<commentId>', 'Comment ID')
+        .requiredOption('--body <text>', 'New comment body')
+        .action(async (taskId, commentId, opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const result = await client.updateTaskComment(orgId, taskId, commentId, { body: opts.body });
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    comments
+        .command('delete')
+        .description('Delete a task comment')
+        .argument('<taskId>', 'Task ID')
+        .argument('<commentId>', 'Comment ID')
+        .action(async (taskId, commentId) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            await client.deleteTaskComment(orgId, taskId, commentId);
+            printJson({ ok: true });
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    // ---- Activities ----
+    tasks
+        .command('activities')
+        .description('List activities for a task')
+        .argument('<taskId>', 'Task ID')
+        .option('--limit <n>', 'Maximum number of activities to return', '20')
+        .option('--cursor <cursor>', 'Pagination cursor')
+        .action(async (taskId, opts) => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const params = stripUndefined({
+                limit: Number(opts.limit),
+                cursor: opts.cursor,
+            });
+            const result = await client.getTaskActivities(orgId, taskId, params);
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+}

package/dist/commands/users.d.ts

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

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

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

package/dist/commands/users.js

@@ -0,0 +1,49 @@
+import { resolveCredentials } from '../lib/client.js';
+import { printJson, printError } from '../lib/output.js';
+export function registerUserCommands(program) {
+    // whoami — registered directly on program
+    program
+        .command('whoami')
+        .description('Show the authenticated user')
+        .action(async () => {
+        try {
+            const { client } = resolveCredentials();
+            const result = await client.getMe();
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    // users subcommand group
+    const users = program.command('users').description('Manage users');
+    users
+        .command('get')
+        .description('Get a user by ID')
+        .argument('<userId>', 'User ID')
+        .action(async (userId) => {
+        try {
+            const { client } = resolveCredentials();
+            const result = await client.getUser(userId);
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+    // members subcommand group
+    const members = program.command('members').description('Manage organization members');
+    members
+        .command('list')
+        .description('List organization members')
+        .action(async () => {
+        try {
+            const { client, orgId } = resolveCredentials();
+            const result = await client.getOrgMembers(orgId);
+            printJson(result);
+        }
+        catch (err) {
+            printError(err);
+        }
+    });
+}

package/dist/commands/wiki.d.ts

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

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

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