@parall/agent-core 1.16.0 → 1.18.0

package/dist/event-format.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event-format.d.ts","sourceRoot":"","sources":["../src/event-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM1D,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CA+BzD;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CASnE"}
+{"version":3,"file":"event-format.d.ts","sourceRoot":"","sources":["../src/event-format.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAM1D,wBAAgB,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAwCzD;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,MAAM,CASnE"}

package/dist/event-format.js

@@ -25,6 +25,16 @@ export function buildEventBody(event) {
         }
         lines.push("", event.body);
     }
+    else if (event.type === "task_comment") {
+        lines.push(`[Event: task.comment.created]`);
+        const taskLabel = event.targetName
+            ? `${event.targetName} (prll://${event.targetId})`
+            : `prll://${event.targetId}`;
+        lines.push(`[Task: ${taskLabel}]`);
+        lines.push(`[From: ${event.senderName} (prll://${event.senderId})]`);
+        lines.push(`[Comment ID: prll://${event.messageId}]`);
+        lines.push("", event.body);
+    }
     else {
         lines.push(`[Event: task.assigned]`);
         const taskLabel = event.targetName

package/dist/gateway-base.d.ts

@@ -62,6 +62,7 @@ export declare class ParallAgentGateway {
     private buildMessageDispatchDecision;
     private handleMessage;
     private handleTaskAssignment;
+    private handleTaskComment;
     private catchUpFromDispatch;
     private handleHello;
     private shutdown;

package/dist/gateway-base.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gateway-base.d.ts","sourceRoot":"","sources":["../src/gateway-base.ts"],"names":[],"mappings":"AAIA,OAAO,EAAuB,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,KAAK,EACV,qBAAqB,EAQtB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAEV,eAAe,EAGf,aAAa,EAEd,MAAM,uBAAuB,CAAC;AAmD/B,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;IACrB,EAAE,EAAE,QAAQ,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,eAAe,EAAE,eAAe,CAAC;IACjC,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACtE,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,QAAQ,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACjH,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACjD,CAAC;AAkCF,qBAAa,kBAAkB;IAuBjB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAtBjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;IAC3D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqC;IACtE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;IACjE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAK5B;IAEF,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,eAAe,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAQ;IAChD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;gBAEjB,IAAI,EAAE,oBAAoB;IAIjD,GAAG,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA8ElD,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,oBAAoB;YAmBd,eAAe;YAqBf,iBAAiB;IAsF/B,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,eAAe;YAQT,gCAAgC;YAMhC,WAAW;YAyDX,gBAAgB;YAmEhB,eAAe;YAmDf,kBAAkB;YAoElB,kBAAkB;YAkBlB,4BAA4B;YAoD5B,aAAa;YA8Bb,oBAAoB;YAmCpB,mBAAmB;YAoGnB,WAAW;YA0DX,QAAQ;CAsBvB"}
+{"version":3,"file":"gateway-base.d.ts","sourceRoot":"","sources":["../src/gateway-base.ts"],"names":[],"mappings":"AAIA,OAAO,EAAuB,YAAY,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC1E,OAAO,KAAK,EACV,qBAAqB,EAUtB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAEV,eAAe,EAGf,aAAa,EAEd,MAAM,uBAAuB,CAAC;AAoD/B,MAAM,MAAM,oBAAoB,GAAG;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,YAAY,CAAC;IACrB,EAAE,EAAE,QAAQ,CAAC;IACb,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,MAAM,EAAE;QACN,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,eAAe,EAAE,eAAe,CAAC;IACjC,GAAG,CAAC,EAAE,aAAa,CAAC;IACpB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,wBAAwB,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IACtE,cAAc,CAAC,EAAE,CAAC,IAAI,EAAE,qBAAqB,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACvE,cAAc,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,QAAQ,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACjH,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACjD,CAAC;AAkCF,qBAAa,kBAAkB;IAuBjB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAtBjC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA+B;IAC3D,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAqC;IACtE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAqB;IACrD,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IACxD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;IACjE,OAAO,CAAC,QAAQ,CAAC,aAAa,CAK5B;IAEF,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,eAAe,CAAqB;IAC5C,OAAO,CAAC,cAAc,CAA+C;IACrE,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,eAAe,CAAc;IACrC,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAQ;IAChD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAS;gBAEjB,IAAI,EAAE,oBAAoB;IAIjD,GAAG,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC;IA2FlD,OAAO,CAAC,eAAe;IAavB,OAAO,CAAC,WAAW;IAcnB,OAAO,CAAC,UAAU;IAWlB,OAAO,CAAC,oBAAoB;YAmBd,eAAe;YAqBf,iBAAiB;IAsF/B,OAAO,CAAC,eAAe;IASvB,OAAO,CAAC,eAAe;YAQT,gCAAgC;YAMhC,WAAW;YAyDX,gBAAgB;YAmEhB,eAAe;YAmDf,kBAAkB;YAoElB,kBAAkB;YAkBlB,4BAA4B;YAoD5B,aAAa;YA8Bb,oBAAoB;YAmCpB,iBAAiB;YAqEjB,mBAAmB;YAsGnB,WAAW;YA0DX,QAAQ;CAsBvB"}

package/dist/gateway-base.js

@@ -121,6 +121,21 @@ export class ParallAgentGateway {
                 this.opts.log?.error(`parall[${this.opts.accountId}]: task dispatch failed for ${data.id}: ${String(err)}`);
             }
         });
+        ws.on("dispatch.new", async (data) => {
+            if (data.event_type !== "task_comment")
+                return;
+            if (!data.source_id || !data.task_id)
+                return;
+            try {
+                const dispatched = await this.handleTaskComment(data.source_id, data.task_id, data.actor_id);
+                if (dispatched) {
+                    this.opts.client.ackDispatchByID(this.opts.config.org_id, data.id).catch(() => { });
+                }
+            }
+            catch (err) {
+                this.opts.log?.error(`parall[${this.opts.accountId}]: task comment dispatch failed for ${data.source_id}: ${String(err)}`);
+            }
+        });
         this.opts.log?.info(`parall[${this.opts.accountId}]: connecting to ${this.opts.connectionLabel ?? "Parall WS"}...`);
         await ws.connect();
         return new Promise((resolve) => {
@@ -198,8 +213,8 @@ export class ParallAgentGateway {
                 target_type: target.target_type,
                 target_id: target.target_id,
                 content: {
-                    trigger_type: event.type === "task" ? "task_assign" : "mention",
-                    trigger_ref: event.type === "task" ? { task_id: event.targetId } : { message_id: event.messageId },
+                    trigger_type: event.type === "task" ? "task_assign" : event.type === "task_comment" ? "task_comment" : "mention",
+                    trigger_ref: event.type === "task" ? { task_id: event.targetId } : event.type === "task_comment" ? { comment_id: event.messageId, task_id: event.targetId } : { message_id: event.messageId },
                     sender_id: event.senderId,
                     sender_name: event.senderName,
                     summary: event.body.substring(0, 200),
@@ -673,6 +688,73 @@ export class ParallAgentGateway {
         }
         return dispatched;
     }
+    async handleTaskComment(commentId, taskId, actorId) {
+        const dedupeKey = `comment:${commentId}`;
+        if (this.dispatchedTasks.has(dedupeKey))
+            return false;
+        this.dispatchedTasks.add(dedupeKey);
+        let comment = null;
+        try {
+            comment = await this.opts.client.getComment(this.opts.config.org_id, commentId);
+        }
+        catch (err) {
+            const status = err?.status;
+            if (status === 404) {
+                // Comment deleted — ack stale dispatch so it doesn't pile up.
+                this.opts.log?.info(`parall[${this.opts.accountId}]: skipping deleted comment ${commentId}, acking stale dispatch`);
+                this.dispatchedTasks.delete(dedupeKey);
+                return true; // caller will ack
+            }
+            this.dispatchedTasks.delete(dedupeKey);
+            return false; // transient error — leave pending for retry
+        }
+        if (!comment) {
+            this.dispatchedTasks.delete(dedupeKey);
+            return true; // null response = gone, ack stale dispatch
+        }
+        let task = null;
+        try {
+            task = await this.opts.client.getTask(this.opts.config.org_id, taskId);
+        }
+        catch { /* task context is optional */ }
+        const taskLabel = task ? `${task.identifier ?? task.id} "${task.title}"` : taskId;
+        this.opts.log?.info(`parall[${this.opts.accountId}]: task comment on ${taskLabel} by ${actorId ?? "unknown"}`);
+        const parts = [];
+        if (task) {
+            parts.push(`Task: ${task.title} (prll://${task.id})`);
+            parts.push(`Status: ${task.status}`, `Priority: ${task.priority}`);
+        }
+        else {
+            parts.push(`Task: prll://${taskId}`);
+        }
+        parts.push(`Comment by: ${comment.author?.display_name ?? actorId ?? "unknown"} (prll://${comment.author_id})`);
+        parts.push("", comment.body);
+        const event = {
+            type: "task_comment",
+            targetId: taskId,
+            targetName: task?.identifier ?? undefined,
+            targetType: "task",
+            senderId: comment.author_id,
+            senderName: comment.author?.display_name ?? actorId ?? "unknown",
+            messageId: commentId,
+            body: parts.join("\n"),
+            ackSourceType: "comment",
+            ackSourceId: commentId,
+        };
+        let dispatched;
+        try {
+            dispatched = await this.handleInboundEvent(event);
+        }
+        catch (err) {
+            // Clear dedupe key so the event remains retryable on next catch-up.
+            this.dispatchedTasks.delete(dedupeKey);
+            throw err;
+        }
+        if (!dispatched) {
+            this.dispatchedTasks.delete(dedupeKey);
+        }
+        return dispatched;
+    }
     async catchUpFromDispatch(coldStart = false) {
         const minAge = coldStart ? Date.now() - this.COLD_START_WINDOW_MS : 0;
         let cursor;
@@ -722,6 +804,9 @@ export class ParallAgentGateway {
                             dispatched = true;
                         }
                     }
+                    else if (item.event_type === "task_comment" && item.source_id && item.task_id) {
+                        dispatched = await this.handleTaskComment(item.source_id, item.task_id, item.actor_id);
+                    }
                     else if (item.event_type === "message" && item.source_id && item.chat_id) {
                         if (!this.tryClaimMessage(item.source_id))
                             continue;

package/dist/types.d.ts

@@ -18,7 +18,7 @@ export type DispatchState = {
 };
 /** Normalized inbound event from Parall. */
 export type ParallEvent = {
-    type: "message" | "task";
+    type: "message" | "task" | "task_comment";
     targetId: string;
     targetName?: string;
     targetType?: string;
@@ -34,7 +34,7 @@ export type ParallEvent = {
         fileSize: number;
         mimeType: string;
     }>;
-    ackSourceType?: "message" | "task_activity";
+    ackSourceType?: "message" | "task_activity" | "comment";
     ackSourceId?: string;
 };
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,MAAM,MAAM,UAAU,GAAG;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,2DAA2D;AAC3D,MAAM,MAAM,aAAa,GAAG;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,kBAAkB,EAAE,UAAU,EAAE,CAAC;IACjC,UAAU,EAAE,WAAW,EAAE,CAAC;CAC3B,CAAC;AAEF,4CAA4C;AAC5C,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,SAAS,GAAG,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,aAAa,CAAC,EAAE,SAAS,GAAG,eAAe,CAAC;IAC5C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,MAAM,MAAM,UAAU,GAAG;IACvB,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACjE,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEF,2DAA2D;AAC3D,MAAM,MAAM,aAAa,GAAG;IAC1B,eAAe,EAAE,OAAO,CAAC;IACzB,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,kBAAkB,EAAE,UAAU,EAAE,CAAC;IACjC,UAAU,EAAE,WAAW,EAAE,CAAC;CAC3B,CAAC;AAEF,4CAA4C;AAC5C,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAE,SAAS,GAAG,MAAM,GAAG,cAAc,CAAC;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW,CAAC,EAAE,KAAK,CAAC;QAClB,EAAE,EAAE,MAAM,CAAC;QACX,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC,CAAC;IACH,aAAa,CAAC,EAAE,SAAS,GAAG,eAAe,GAAG,SAAS,CAAC;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/agent-core",
-  "version": "1.16.0",
+  "version": "1.18.0",
   "description": "Shared agent runtime orchestration helpers for Parall",
   "license": "MIT",
   "repository": {
@@ -22,7 +22,7 @@
     "src"
   ],
   "dependencies": {
-    "@parall/sdk": "1.16.0"
+    "@parall/sdk": "1.18.0"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/src/event-format.ts

@@ -25,6 +25,15 @@ export function buildEventBody(event: ParallEvent): string {
       }
     }
     lines.push("", event.body);
+  } else if (event.type === "task_comment") {
+    lines.push(`[Event: task.comment.created]`);
+    const taskLabel = event.targetName
+      ? `${event.targetName} (prll://${event.targetId})`
+      : `prll://${event.targetId}`;
+    lines.push(`[Task: ${taskLabel}]`);
+    lines.push(`[From: ${event.senderName} (prll://${event.senderId})]`);
+    lines.push(`[Comment ID: prll://${event.messageId}]`);
+    lines.push("", event.body);
   } else {
     lines.push(`[Event: task.assigned]`);
     const taskLabel = event.targetName

package/src/gateway-base.ts

@@ -7,6 +7,8 @@ import type {
   AgentConfigUpdateData,
   Chat,
   ChatUpdateData,
+  Comment,
+  DispatchNewData,
   HelloData,
   MessageNewData,
   Task,
@@ -65,6 +67,7 @@ type DispatchableMessage = {
   content: unknown;
   thread_root_id?: string | null;
   hints?: { no_reply?: boolean } | null;
+  attachments?: Array<{ id: string; file_name: string; file_size: number; mime_type: string }>;
 };
 
 type MessageDispatchDecision =
@@ -221,6 +224,19 @@ export class ParallAgentGateway {
       }
     });
 
+    ws.on("dispatch.new", async (data: DispatchNewData) => {
+      if (data.event_type !== "task_comment") return;
+      if (!data.source_id || !data.task_id) return;
+      try {
+        const dispatched = await this.handleTaskComment(data.source_id, data.task_id, data.actor_id);
+        if (dispatched) {
+          this.opts.client.ackDispatchByID(this.opts.config.org_id, data.id).catch(() => {});
+        }
+      } catch (err) {
+        this.opts.log?.error(`parall[${this.opts.accountId}]: task comment dispatch failed for ${data.source_id}: ${String(err)}`);
+      }
+    });
+
     this.opts.log?.info(`parall[${this.opts.accountId}]: connecting to ${this.opts.connectionLabel ?? "Parall WS"}...`);
     await ws.connect();
 
@@ -298,8 +314,8 @@ export class ParallAgentGateway {
         target_type: target.target_type,
         target_id: target.target_id,
         content: {
-          trigger_type: event.type === "task" ? "task_assign" : "mention",
-          trigger_ref: event.type === "task" ? { task_id: event.targetId } : { message_id: event.messageId },
+          trigger_type: event.type === "task" ? "task_assign" : event.type === "task_comment" ? "task_comment" : "mention",
+          trigger_ref: event.type === "task" ? { task_id: event.targetId } : event.type === "task_comment" ? { comment_id: event.messageId, task_id: event.targetId } : { message_id: event.messageId },
           sender_id: event.senderId,
           sender_name: event.senderName,
           summary: event.body.substring(0, 200),
@@ -693,7 +709,7 @@ export class ParallAgentGateway {
 
     const content = message.content as TextContent;
     const body = content.text?.trim() ?? "";
-    const hasAttachments = (message as { attachments?: unknown[] }).attachments?.length;
+    const hasAttachments = message.attachments?.length;
 
     if (!body && !hasAttachments) return { action: "skip" };
 
@@ -705,7 +721,7 @@ export class ParallAgentGateway {
       if (!isMentioned) return { action: "skip" };
     }
 
-    const attachments = ((message as { attachments?: Array<{ id: string; file_name: string; file_size: number; mime_type: string }> }).attachments ?? []).map((a) => ({
+    const attachments = (message.attachments ?? []).map((a) => ({
       id: a.id,
       fileName: a.file_name,
       fileSize: a.file_size,
@@ -797,6 +813,75 @@ export class ParallAgentGateway {
     return dispatched;
   }
 
+  private async handleTaskComment(commentId: string, taskId: string, actorId: string | null): Promise<boolean> {
+    const dedupeKey = `comment:${commentId}`;
+    if (this.dispatchedTasks.has(dedupeKey)) return false;
+    this.dispatchedTasks.add(dedupeKey);
+
+    let comment: Comment | null = null;
+    try {
+      comment = await this.opts.client.getComment(this.opts.config.org_id, commentId);
+    } catch (err: unknown) {
+      const status = (err as { status?: number })?.status;
+      if (status === 404) {
+        // Comment deleted — ack stale dispatch so it doesn't pile up.
+        this.opts.log?.info(`parall[${this.opts.accountId}]: skipping deleted comment ${commentId}, acking stale dispatch`);
+        this.dispatchedTasks.delete(dedupeKey);
+        return true; // caller will ack
+      }
+      this.dispatchedTasks.delete(dedupeKey);
+      return false; // transient error — leave pending for retry
+    }
+    if (!comment) {
+      this.dispatchedTasks.delete(dedupeKey);
+      return true; // null response = gone, ack stale dispatch
+    }
+
+    let task: Task | null = null;
+    try {
+      task = await this.opts.client.getTask(this.opts.config.org_id, taskId);
+    } catch { /* task context is optional */ }
+
+    const taskLabel = task ? `${task.identifier ?? task.id} "${task.title}"` : taskId;
+    this.opts.log?.info(`parall[${this.opts.accountId}]: task comment on ${taskLabel} by ${actorId ?? "unknown"}`);
+
+    const parts: string[] = [];
+    if (task) {
+      parts.push(`Task: ${task.title} (prll://${task.id})`);
+      parts.push(`Status: ${task.status}`, `Priority: ${task.priority}`);
+    } else {
+      parts.push(`Task: prll://${taskId}`);
+    }
+    parts.push(`Comment by: ${comment.author?.display_name ?? actorId ?? "unknown"} (prll://${comment.author_id})`);
+    parts.push("", comment.body);
+
+    const event: ParallEvent = {
+      type: "task_comment",
+      targetId: taskId,
+      targetName: task?.identifier ?? undefined,
+      targetType: "task",
+      senderId: comment.author_id,
+      senderName: comment.author?.display_name ?? actorId ?? "unknown",
+      messageId: commentId,
+      body: parts.join("\n"),
+      ackSourceType: "comment",
+      ackSourceId: commentId,
+    };
+
+    let dispatched: boolean;
+    try {
+      dispatched = await this.handleInboundEvent(event);
+    } catch (err) {
+      // Clear dedupe key so the event remains retryable on next catch-up.
+      this.dispatchedTasks.delete(dedupeKey);
+      throw err;
+    }
+    if (!dispatched) {
+      this.dispatchedTasks.delete(dedupeKey);
+    }
+    return dispatched;
+  }
+
   private async catchUpFromDispatch(coldStart = false) {
     const minAge = coldStart ? Date.now() - this.COLD_START_WINDOW_MS : 0;
     let cursor: string | undefined;
@@ -844,6 +929,8 @@ export class ParallAgentGateway {
             } else {
               dispatched = true;
             }
+          } else if (item.event_type === "task_comment" && item.source_id && item.task_id) {
+            dispatched = await this.handleTaskComment(item.source_id, item.task_id, item.actor_id);
           } else if (item.event_type === "message" && item.source_id && item.chat_id) {
             if (!this.tryClaimMessage(item.source_id)) continue;
             let msg: Awaited<ReturnType<typeof this.opts.client.getMessage>> | null = null;

package/src/types.ts

@@ -16,7 +16,7 @@ export type DispatchState = {
 
 /** Normalized inbound event from Parall. */
 export type ParallEvent = {
-  type: "message" | "task";
+  type: "message" | "task" | "task_comment";
   targetId: string;
   targetName?: string;
   targetType?: string;
@@ -32,6 +32,6 @@ export type ParallEvent = {
     fileSize: number;
     mimeType: string;
   }>;
-  ackSourceType?: "message" | "task_activity";
+  ackSourceType?: "message" | "task_activity" | "comment";
   ackSourceId?: string;
 };