@parall/cli 1.43.0 → 1.45.0

package/dist/commands/tasks.d.ts

@@ -1,3 +1,48 @@
+import type { UpdateTaskRequest } from '@parall/sdk';
 import { Command } from 'commander';
+export declare function buildCreateTaskData(opts: {
+    title: string;
+    description?: string;
+    status?: string;
+    priority?: string;
+    assigneeId?: string;
+    projectId?: string;
+    parentId?: string;
+    sourceChatId?: string;
+    dueDate?: string;
+}): Partial<{
+    title: string;
+    description: string | undefined;
+    status: string | undefined;
+    priority: string | undefined;
+    assignee_id: string | undefined;
+    project_id: string | undefined;
+    parent_id: string | undefined;
+    source_chat_id: string | undefined;
+    due_date: string | undefined;
+}>;
+export declare function buildUpdateTaskData(opts: {
+    title?: string;
+    status?: string;
+    priority?: string;
+    assigneeId?: string;
+    description?: string;
+    projectId?: string;
+    parentId?: string;
+    sortOrder?: string;
+    placement?: string;
+    dueDate?: string;
+}): Partial<{
+    title: string | undefined;
+    status: UpdateTaskRequest["status"];
+    priority: UpdateTaskRequest["priority"];
+    assignee_id: string | undefined;
+    description: string | undefined;
+    project_id: string | undefined;
+    parent_id: string | undefined;
+    sort_order: number | undefined;
+    placement: "end" | undefined;
+    due_date: string | null | undefined;
+}>;
 export declare function registerTaskCommands(program: Command): void;
 //# sourceMappingURL=tasks.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/commands/tasks.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAQpC,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAsWpD"}
+{"version":3,"file":"tasks.d.ts","sourceRoot":"","sources":["../../src/commands/tasks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AA8DpC,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;;;;;;;;;;GAYA;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;;YAS0B,iBAAiB,CAAC,QAAQ,CAAC;cACvB,iBAAiB,CAAC,UAAU,CAAC;;;;;;;;GAS3D;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,OAAO,QAiWpD"}

package/dist/commands/tasks.js

@@ -4,6 +4,92 @@ import { printJson, printError, printRefHint, stripPrllScheme } from '../lib/out
 function stripUndefined(obj) {
     return Object.fromEntries(Object.entries(obj).filter(([, v]) => v !== undefined));
 }
+// The CLI is an agent semantic adapter (parall-cli-design.md § Design
+// Principles): it owns the agent-facing command grammar and rejects values
+// outside it before any request, so local coercion can never turn invalid
+// intent into a successful no-op. The server independently re-validates and
+// stays authoritative for domain semantics (calendar validity, placement
+// set, ordering conflicts, permissions).
+/** Strict command grammar for --due-date; calendar validity (e.g. 2026-02-30)
+ * stays the server's domain (400 INVALID_DUE_DATE). */
+const DUE_DATE_RE = /^\d{4}-\d{2}-\d{2}$/;
+function resolveCreateDueDate(value) {
+    if (value === undefined)
+        return undefined;
+    if (!DUE_DATE_RE.test(value)) {
+        throw new Error('--due-date must be a YYYY-MM-DD date');
+    }
+    return value;
+}
+/** Update grammar adds the lowercase "none" sentinel — the agent-facing
+ * clear intent, mapped to an explicit null on the wire. */
+function resolveUpdateDueDate(value) {
+    if (value === undefined)
+        return undefined;
+    if (value === 'none')
+        return null;
+    if (!DUE_DATE_RE.test(value)) {
+        throw new Error('--due-date must be a YYYY-MM-DD date, or "none" to clear it');
+    }
+    return value;
+}
+/** Only intents the CLI understands are accepted — a new placement value is a
+ * coordinated server + SDK + CLI + skill change, not a passthrough. The
+ * server's INVALID_PLACEMENT check remains the backstop for non-CLI callers. */
+function resolvePlacement(value) {
+    if (value === undefined)
+        return undefined;
+    if (value !== 'end') {
+        throw new Error('--placement must be "end"');
+    }
+    return value;
+}
+/** Number('abc') is NaN and JSON.stringify(NaN) is null — without this guard
+ * a malformed --sort-order becomes sort_order:null, which the server treats
+ * as "field absent" and answers 200 without moving the task. */
+function resolveSortOrder(value) {
+    if (value === undefined)
+        return undefined;
+    const trimmed = value.trim();
+    const parsed = trimmed === '' ? Number.NaN : Number(trimmed);
+    if (!Number.isFinite(parsed)) {
+        throw new Error('--sort-order must be a finite number');
+    }
+    return parsed;
+}
+export function buildCreateTaskData(opts) {
+    return stripUndefined({
+        title: opts.title,
+        description: opts.description,
+        status: opts.status,
+        priority: opts.priority,
+        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,
+        due_date: resolveCreateDueDate(opts.dueDate),
+    });
+}
+export function buildUpdateTaskData(opts) {
+    // Mutually exclusive (the server also rejects the pair with 400
+    // CONFLICTING_SORT); fail fast client-side so an agent doesn't spend a
+    // request round-trip to find out.
+    if (opts.placement !== undefined && opts.sortOrder !== undefined) {
+        throw new Error('--placement and --sort-order are mutually exclusive. Provide only one.');
+    }
+    return stripUndefined({
+        title: opts.title,
+        status: opts.status,
+        priority: opts.priority,
+        assignee_id: opts.assigneeId ? stripPrllScheme(opts.assigneeId) : undefined,
+        description: opts.description,
+        project_id: opts.projectId ? stripPrllScheme(opts.projectId) : undefined,
+        parent_id: opts.parentId ? stripPrllScheme(opts.parentId) : undefined,
+        sort_order: resolveSortOrder(opts.sortOrder),
+        placement: resolvePlacement(opts.placement),
+        due_date: resolveUpdateDueDate(opts.dueDate),
+    });
+}
 export function registerTaskCommands(program) {
     const tasks = program.command('tasks').description('Manage tasks');
     tasks
@@ -50,19 +136,13 @@ export function registerTaskCommands(program) {
         .option('--project-id <id>', 'Project ID')
         .option('--parent-id <id>', 'Parent task ID')
         .option('--source-chat-id <id>', 'Source chat ID')
+        .option('--due-date <date>', 'Planned completion date (YYYY-MM-DD)')
         .action(async (opts) => {
         try {
+            // Grammar first: an invalid option is a parameter error even when
+            // credentials are absent, and it must never reach the wire.
+            const data = buildCreateTaskData(opts);
             const { client, orgId } = resolveCredentials();
-            const data = stripUndefined({
-                title: opts.title,
-                description: opts.description,
-                status: opts.status,
-                priority: opts.priority,
-                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);
@@ -96,24 +176,19 @@ export function registerTaskCommands(program) {
         .option('--description <text>', 'Task description')
         .option('--project-id <id>', 'Project ID')
         .option('--parent-id <id>', 'Parent task ID')
-        .option('--sort-order <n>', 'Sort order')
+        .option('--sort-order <n>', 'Explicit sort_order value — only for pinpoint insertion relative to cards you can see; to append to a status column use --placement end')
+        .option('--placement <where>', 'Ordering intent — only "end" is accepted: appends the task to the end of its status column, position resolved by the server (mutually exclusive with --sort-order)')
+        .option('--due-date <date>', 'Planned completion date (YYYY-MM-DD), or "none" to clear it')
         .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 ? stripPrllScheme(opts.assigneeId) : undefined,
-                description: opts.description,
-                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,
-            });
+            // Grammar first: an invalid option is a parameter error even when
+            // credentials are absent, and it must never reach the wire.
+            const data = buildUpdateTaskData(opts);
             if (Object.keys(data).length === 0) {
                 printError(new Error('No fields to update. Provide at least one option.'));
             }
+            taskId = stripPrllScheme(taskId);
+            const { client, orgId } = resolveCredentials();
             // Typed dispatch binding: when this turn is a typed dispatch about
             // exactly this task, the update rides the claimed typed lane; the
             // first update also carries the canonical task_update:<dsp> effect

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/cli",
-  "version": "1.43.0",
+  "version": "1.45.0",
   "description": "CLI client for Parall — universal agent & human access to Parall API",
   "license": "MIT",
   "repository": {
@@ -36,14 +36,14 @@
     "diff": "^8.0.3",
     "js-yaml": "^4.1.0",
     "zod": "^4.3.6",
-    "@parall/agent-core": "1.43.0",
-    "@parall/sdk": "1.43.0"
+    "@parall/agent-core": "1.45.0",
+    "@parall/sdk": "1.45.0"
   },
   "devDependencies": {
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^22.0.0",
     "typescript": "^5.7.0",
-    "@parall/agent-core": "1.43.0"
+    "@parall/agent-core": "1.45.0"
   },
   "scripts": {
     "build": "tsc",