@parall/agent-core 1.41.0 → 1.42.1

package/dist/gateway-base.d.ts

@@ -122,6 +122,8 @@ export declare class ParallAgentGateway {
     private laneFlowHost;
     private dispatchLaneGroup;
     private consumeTypedDispatch;
+    private ackDispatchEvent;
+    private clearTypedDispatchDedupe;
     private buildDispatchContext;
     private isSessionNotLiveError;
     private createInputStep;
@@ -144,6 +146,7 @@ export declare class ParallAgentGateway {
     private buildMessageDispatchDecision;
     private handleMessage;
     private handleMessageRedrive;
+    private handleTaskAssignmentRedrive;
     private consumeMessageWorkItem;
     private handleTaskAssignment;
     private handleTaskDispatch;

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

@@ -1 +1 @@
-{"version":3,"file":"gateway-base.d.ts","sourceRoot":"","sources":["../src/gateway-base.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"gateway-base.d.ts","sourceRoot":"","sources":["../src/gateway-base.ts"],"names":[],"mappings":"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"}

package/dist/gateway-base.js

@@ -255,17 +255,16 @@ export class ParallAgentGateway {
                     ? { dispatchEventId: data.dispatch_event_id }
                     : { sourceType: 'task_activity', sourceId: data.id }, (dispatchEventId) => this.handleTaskAssignment(data, data.id, dispatchEventId), (dispatchEventId) => {
                     if (dispatchEventId) {
-                        this.opts.client
-                            .ackDispatchByID(this.opts.config.org_id, dispatchEventId)
-                            .catch(() => { });
-                        return;
+                        return this.ackDispatchEvent(dispatchEventId, () => {
+                            this.dispatchedTasks.delete(`${data.id}:${data.updated_at}`);
+                        });
                     }
-                    this.opts.client
+                    return this.opts.client
                         .ackDispatch(this.opts.config.org_id, {
                         source_type: 'task_activity',
                         source_id: data.id,
                     })
-                        .catch(() => { });
+                        .then(() => undefined, () => undefined);
                 });
             }
             catch (err) {
@@ -273,13 +272,21 @@ export class ParallAgentGateway {
             }
         });
         ws.on('dispatch.new', async (data) => {
-            if (data.event_type === 'task_comment') {
+            if (data.event_type === 'task_assign') {
+                if (!data.task_id)
+                    return;
+                try {
+                    await this.handleTaskAssignmentRedrive(data);
+                }
+                catch (err) {
+                    this.opts.log?.error(`task assignment re-drive failed for ${data.task_id}: ${String(err)}`);
+                }
+            }
+            else if (data.event_type === 'task_comment') {
                 if (!data.source_id || !data.task_id)
                     return;
                 try {
-                    await this.consumeTypedDispatch({ dispatchEventId: data.id }, () => this.handleTaskComment(data.source_id, data.task_id ?? '', data.actor_id, data.delivery_reason), () => {
-                        this.opts.client.ackDispatchByID(this.opts.config.org_id, data.id).catch(() => { });
-                    });
+                    await this.consumeTypedDispatch({ dispatchEventId: data.id }, () => this.handleTaskComment(data.source_id, data.task_id ?? '', data.actor_id, data.delivery_reason), () => this.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)));
                 }
                 catch (err) {
                     this.opts.log?.error(`task comment dispatch failed for ${data.source_id}: ${String(err)}`);
@@ -289,9 +296,7 @@ export class ParallAgentGateway {
                 if (!data.source_id)
                     return;
                 try {
-                    await this.consumeTypedDispatch({ dispatchEventId: data.id }, () => this.handleWikiComment(data.source_id, data.actor_id, data.delivery_reason), () => {
-                        this.opts.client.ackDispatchByID(this.opts.config.org_id, data.id).catch(() => { });
-                    });
+                    await this.consumeTypedDispatch({ dispatchEventId: data.id }, () => this.handleWikiComment(data.source_id, data.actor_id, data.delivery_reason), () => this.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)));
                 }
                 catch (err) {
                     this.opts.log?.error(`wiki comment dispatch failed for ${data.source_id}: ${String(err)}`);
@@ -304,9 +309,7 @@ export class ParallAgentGateway {
                     await this.consumeTypedDispatch({ dispatchEventId: data.id }, (dispatchEventId) => this.handleTaskDispatch(data.task_id ?? '', data.source_id ?? data.task_id ?? '', {
                         allowCreator: true,
                         dispatchEventId,
-                    }), () => {
-                        this.opts.client.ackDispatchByID(this.opts.config.org_id, data.id).catch(() => { });
-                    });
+                    }), () => this.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)));
                 }
                 catch (err) {
                     this.opts.log?.error(`task update dispatch failed for ${data.task_id}: ${String(err)}`);
@@ -316,9 +319,7 @@ export class ParallAgentGateway {
                 if (!data.source_id)
                     return;
                 try {
-                    await this.consumeTypedDispatch({ dispatchEventId: data.id }, () => this.fetchAndHandleScheduleFire(data.source_id, data.actor_id), () => {
-                        this.opts.client.ackDispatchByID(this.opts.config.org_id, data.id).catch(() => { });
-                    });
+                    await this.consumeTypedDispatch({ dispatchEventId: data.id }, () => this.fetchAndHandleScheduleFire(data.source_id, data.actor_id), () => this.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)));
                 }
                 catch (err) {
                     this.opts.log?.error(`schedule fire dispatch failed for ${data.source_id}: ${String(err)}`);
@@ -328,9 +329,7 @@ export class ParallAgentGateway {
                 if (!data.source_id)
                     return;
                 try {
-                    await this.consumeTypedDispatch({ dispatchEventId: data.id }, () => this.fetchAndHandleExternalTriggerRun(data.source_id), () => {
-                        this.opts.client.ackDispatchByID(this.opts.config.org_id, data.id).catch(() => { });
-                    });
+                    await this.consumeTypedDispatch({ dispatchEventId: data.id }, () => this.fetchAndHandleExternalTriggerRun(data.source_id), () => this.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)));
                 }
                 catch (err) {
                     this.opts.log?.error(`external trigger dispatch failed for ${data.source_id}: ${String(err)}`);
@@ -340,9 +339,7 @@ export class ParallAgentGateway {
                 if (!data.source_id)
                     return;
                 try {
-                    await this.consumeTypedDispatch({ dispatchEventId: data.id }, () => this.fetchAndHandleChannelMessage(data.source_id), () => {
-                        this.opts.client.ackDispatchByID(this.opts.config.org_id, data.id).catch(() => { });
-                    });
+                    await this.consumeTypedDispatch({ dispatchEventId: data.id }, () => this.fetchAndHandleChannelMessage(data.source_id), () => this.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)));
                 }
                 catch (err) {
                     this.opts.log?.error(`channel message dispatch failed for ${data.source_id}: ${String(err)}`);
@@ -352,9 +349,7 @@ export class ParallAgentGateway {
                 if (!data.source_id)
                     return;
                 try {
-                    await this.consumeTypedDispatch({ dispatchEventId: data.id }, () => this.fetchAndHandleApprovalDecided(data.source_id, data.actor_id, data.chat_id ?? null), () => {
-                        this.opts.client.ackDispatchByID(this.opts.config.org_id, data.id).catch(() => { });
-                    });
+                    await this.consumeTypedDispatch({ dispatchEventId: data.id }, () => this.fetchAndHandleApprovalDecided(data.source_id, data.actor_id, data.chat_id ?? null), () => this.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)));
                 }
                 catch (err) {
                     this.opts.log?.error(`approval decided dispatch failed for ${data.source_id}: ${String(err)}`);
@@ -374,14 +369,11 @@ export class ParallAgentGateway {
                     this.opts.log?.error(`message re-drive failed for ${data.source_id}: ${String(err)}`);
                 }
             }
-            else if (data.event_type !== 'message' && data.event_type !== 'task_assign') {
+            else if (data.event_type !== 'message') {
                 // Truly unknown event_type — log so a newly-added dispatch type
-                // not yet wired here surfaces during runtime testing. "message"
-                // and "task_assign" are deliberately excluded: dispatch.new
-                // carries them too, but they are owned by dedicated WS handlers
-                // (message.new, task.assigned) above and would otherwise spam
-                // info-level logs for every inbound chat message / task
-                // assignment on a busy agent.
+                // not yet wired here surfaces during runtime testing. "message" is
+                // deliberately excluded because its first delivery is owned by the
+                // message.new handler; recovered task_assign rows are handled above.
                 this.opts.log?.info(`dispatch.new with unhandled event_type=${String(data.event_type)} (id=${data.id}) — no-op`);
             }
         });
@@ -453,6 +445,53 @@ export class ParallAgentGateway {
     consumeTypedDispatch(ref, run, ack) {
         return consumeTypedDispatch(this.laneFlowHost(), ref, run, ack);
     }
+    // Typed completion must wait until the administrative ack has either
+    // committed or failed. Errors stay best-effort: a failed ack leaves the row
+    // received, so Complete releases and re-drives it safely.
+    ackDispatchEvent(dispatchEventId, onFailure) {
+        return this.opts.client.ackDispatchByID(this.opts.config.org_id, dispatchEventId).then(() => undefined, (err) => {
+            // Complete will return the still-received item to pending and publish
+            // an immediate hint. Free its hot-path claim first, otherwise that
+            // same-process re-drive is rejected forever by the local dedupe set.
+            onFailure?.();
+            this.opts.log?.warn(`dispatch ack failed for ${dispatchEventId}, releasing for re-drive: ${String(err)}`);
+        });
+    }
+    clearTypedDispatchDedupe(item) {
+        switch (item.event_type) {
+            case 'task_assign':
+            case 'task_update':
+                if (item.task_id) {
+                    const prefix = `${item.task_id}:`;
+                    for (const key of this.dispatchedTasks) {
+                        if (key.startsWith(prefix))
+                            this.dispatchedTasks.delete(key);
+                    }
+                }
+                break;
+            case 'task_comment':
+            case 'wiki_comment':
+                if (item.source_id)
+                    this.dispatchedTasks.delete(`comment:${item.source_id}`);
+                break;
+            case 'schedule.fire':
+                if (item.source_id)
+                    this.dispatchedTasks.delete(`schedule_run:${item.source_id}`);
+                break;
+            case 'external_trigger':
+                if (item.source_id)
+                    this.dispatchedTasks.delete(`external_trigger_run:${item.source_id}`);
+                break;
+            case 'channel_message':
+                if (item.source_id)
+                    this.dispatchedMessages.delete(`channel_message:${item.source_id}`);
+                break;
+            case 'approval_decided':
+                if (item.source_id)
+                    this.dispatchedTasks.delete(`approval:${item.source_id}`);
+                break;
+        }
+    }
     buildDispatchContext(event, sessionKey) {
         const binding = this.sessionBindings.get(sessionKey);
         return {
@@ -1605,6 +1644,17 @@ export class ParallAgentGateway {
             chat_id: item.chat_id,
         });
     }
+    // A task assignment's first delivery rides task.assigned, but a typed lane
+    // released without an effect is re-driven as dispatch.new. Reuse the exact
+    // typed claim path used by catch-up so that recovery does not require a
+    // runtime reconnect.
+    async handleTaskAssignmentRedrive(item) {
+        if (!item.task_id)
+            return;
+        await this.consumeTypedDispatch({ dispatchEventId: item.id }, (dispatchEventId) => this.handleTaskDispatch(item.task_id ?? '', item.source_id ?? item.task_id ?? '', {
+            dispatchEventId,
+        }), (dispatchEventId) => this.ackDispatchEvent(dispatchEventId ?? item.id, () => this.clearTypedDispatchDedupe(item)));
+    }
     consumeMessageWorkItem(item) {
         return consumeMessageWorkItem(this.laneFlowHost(), item);
     }
@@ -2116,9 +2166,7 @@ export class ParallAgentGateway {
                 }
                 processed++;
                 try {
-                    const ackItem = () => {
-                        this.opts.client.ackDispatchByID(this.opts.config.org_id, item.id).catch(() => { });
-                    };
+                    const ackItem = () => this.ackDispatchEvent(item.id, () => this.clearTypedDispatchDedupe(item));
                     if (item.event_type === 'task_assign' && item.task_id) {
                         try {
                             await this.consumeTypedDispatch({ dispatchEventId: item.id }, (dispatchEventId) => this.handleTaskDispatch(item.task_id ?? '', item.source_id ?? item.task_id ?? '', {

package/dist/gateway-lane-flow.d.ts

@@ -57,7 +57,7 @@ export declare function consumeTypedDispatch(host: LaneFlowHost, ref: {
     dispatchEventId?: string;
     sourceType?: string;
     sourceId?: string;
-}, run: (dispatchEventId?: string) => Promise<boolean>, ack: (dispatchEventId?: string) => void): Promise<void>;
+}, run: (dispatchEventId?: string) => Promise<boolean>, ack: (dispatchEventId?: string) => void | Promise<void>): Promise<void>;
 /**
  * Shared consumption of a message WorkItem referenced by id — the ONE
  * protocol for dispatch catch-up pages and post-complete re-drive hints

package/dist/gateway-lane-flow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"gateway-lane-flow.d.ts","sourceRoot":"","sources":["../src/gateway-lane-flow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAEtF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;GAKG;AAEH,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE;QACJ,MAAM,EAAE,YAAY,CAAC;QACrB,GAAG,CAAC,EAAE,aAAa,CAAC;QACpB,MAAM,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3B,eAAe,EAAE,eAAe,CAAC;QACjC,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;IAC5C,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,WAAW,CACT,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,aAAa,CAAC,EAAE,WAAW,EAAE,EAC7B,WAAW,CAAC,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,4BAA4B,CAC1B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACpC,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1D;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE;IACJ,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,OAAO,CAAC;CAC7B,GACA,OAAO,CAAC,YAAY,GAAG,SAAS,GAAG,UAAU,CAAC,CA6DhD;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,YAAY,EAClB,GAAG,EAAE;IAAE,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EACzE,GAAG,EAAE,CAAC,eAAe,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,EACnD,GAAG,EAAE,CAAC,eAAe,CAAC,EAAE,MAAM,KAAK,IAAI,GACtC,OAAO,CAAC,IAAI,CAAC,CA8Bf;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvD,OAAO,CAAC,IAAI,CAAC,CAuDf"}
+{"version":3,"file":"gateway-lane-flow.d.ts","sourceRoot":"","sources":["../src/gateway-lane-flow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC5E,OAAO,KAAK,EAAE,mBAAmB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAEtF,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;GAKG;AAEH,0EAA0E;AAC1E,MAAM,WAAW,YAAY;IAC3B,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,kBAAkB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE;QACJ,MAAM,EAAE,YAAY,CAAC;QACrB,GAAG,CAAC,EAAE,aAAa,CAAC;QACpB,MAAM,EAAE;YAAE,MAAM,EAAE,MAAM,CAAA;SAAE,CAAC;QAC3B,eAAe,EAAE,eAAe,CAAC;QACjC,WAAW,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACpC,cAAc,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;IAC5C,oBAAoB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxD,WAAW,CACT,KAAK,EAAE,WAAW,EAClB,UAAU,EAAE,MAAM,EAClB,YAAY,EAAE,MAAM,EACpB,aAAa,CAAC,EAAE,WAAW,EAAE,EAC7B,WAAW,CAAC,EAAE,MAAM,EAAE,GACrB,OAAO,CAAC,OAAO,CAAC,CAAC;IACpB,eAAe,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IACrC,4BAA4B,CAC1B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,mBAAmB,GAC3B,OAAO,CAAC,uBAAuB,CAAC,CAAC;IACpC,kBAAkB,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1D;AAED;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE;IACJ,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,WAAW,EAAE,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,MAAM,OAAO,CAAC;CAC7B,GACA,OAAO,CAAC,YAAY,GAAG,SAAS,GAAG,UAAU,CAAC,CA6DhD;AAED;;;;;;GAMG;AACH,wBAAsB,oBAAoB,CACxC,IAAI,EAAE,YAAY,EAClB,GAAG,EAAE;IAAE,eAAe,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,EACzE,GAAG,EAAE,CAAC,eAAe,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,EACnD,GAAG,EAAE,CAAC,eAAe,CAAC,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,GACtD,OAAO,CAAC,IAAI,CAAC,CAiCf;AAED;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,YAAY,EAClB,IAAI,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACvD,OAAO,CAAC,IAAI,CAAC,CAuDf"}

package/dist/gateway-lane-flow.js

@@ -68,7 +68,7 @@ export async function dispatchLaneGroup(host, opts) {
 export async function consumeTypedDispatch(host, ref, run, ack) {
     if (!host.laneLedger || host.ledgerDisabled) {
         if (await run(ref.dispatchEventId))
-            ack(ref.dispatchEventId);
+            await ack(ref.dispatchEventId);
         return;
     }
     let lane;
@@ -79,7 +79,7 @@ export async function consumeTypedDispatch(host, ref, run, ack) {
         if (err instanceof LedgerUnsupportedError) {
             host.disableLedger('claim endpoint missing');
             if (await run(ref.dispatchEventId))
-                ack(ref.dispatchEventId);
+                await ack(ref.dispatchEventId);
             return;
         }
         throw err;
@@ -89,8 +89,11 @@ export async function consumeTypedDispatch(host, ref, run, ack) {
         return;
     }
     try {
+        // Ack must settle before Complete. A fire-and-forget ack races the lane
+        // release: Complete can return the still-received typed item to pending
+        // and publish a re-drive while its successful ack is still in flight.
         if (await run(lane.typedDispatchEventId))
-            ack(lane.typedDispatchEventId);
+            await ack(lane.typedDispatchEventId);
     }
     finally {
         // Release the occupancy row. A buffered dispatch may outlive this guard

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/agent-core",
-  "version": "1.41.0",
+  "version": "1.42.1",
   "description": "Shared agent runtime orchestration helpers for Parall",
   "license": "MIT",
   "repository": {
@@ -35,7 +35,7 @@
     "@opentelemetry/sdk-logs": "^0.57.0",
     "@opentelemetry/sdk-metrics": "^1.30.0",
     "@opentelemetry/sdk-trace-node": "^1.30.0",
-    "@parall/sdk": "1.41.0"
+    "@parall/sdk": "1.42.1"
   },
   "devDependencies": {
     "@types/node": "^22.0.0",

package/src/gateway-base.ts

@@ -438,17 +438,19 @@ export class ParallAgentGateway {
           (dispatchEventId) => this.handleTaskAssignment(data, data.id, dispatchEventId),
           (dispatchEventId) => {
             if (dispatchEventId) {
-              this.opts.client
-                .ackDispatchByID(this.opts.config.org_id, dispatchEventId)
-                .catch(() => {});
-              return;
+              return this.ackDispatchEvent(dispatchEventId, () => {
+                this.dispatchedTasks.delete(`${data.id}:${data.updated_at}`);
+              });
             }
-            this.opts.client
+            return this.opts.client
               .ackDispatch(this.opts.config.org_id, {
                 source_type: 'task_activity',
                 source_id: data.id,
               })
-              .catch(() => {});
+              .then(
+                () => undefined,
+                () => undefined,
+              );
           },
         );
       } catch (err) {
@@ -457,7 +459,16 @@ export class ParallAgentGateway {
     });
 
     ws.on('dispatch.new', async (data: DispatchNewData) => {
-      if (data.event_type === 'task_comment') {
+      if (data.event_type === 'task_assign') {
+        if (!data.task_id) return;
+        try {
+          await this.handleTaskAssignmentRedrive(data);
+        } catch (err) {
+          this.opts.log?.error(
+            `task assignment re-drive failed for ${data.task_id}: ${String(err)}`,
+          );
+        }
+      } else if (data.event_type === 'task_comment') {
         if (!data.source_id || !data.task_id) return;
         try {
           await this.consumeTypedDispatch(
@@ -469,9 +480,7 @@ export class ParallAgentGateway {
                 data.actor_id,
                 data.delivery_reason,
               ),
-            () => {
-              this.opts.client.ackDispatchByID(this.opts.config.org_id, data.id).catch(() => {});
-            },
+            () => this.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)),
           );
         } catch (err) {
           this.opts.log?.error(
@@ -484,9 +493,7 @@ export class ParallAgentGateway {
           await this.consumeTypedDispatch(
             { dispatchEventId: data.id },
             () => this.handleWikiComment(data.source_id, data.actor_id, data.delivery_reason),
-            () => {
-              this.opts.client.ackDispatchByID(this.opts.config.org_id, data.id).catch(() => {});
-            },
+            () => this.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)),
           );
         } catch (err) {
           this.opts.log?.error(
@@ -503,9 +510,7 @@ export class ParallAgentGateway {
                 allowCreator: true,
                 dispatchEventId,
               }),
-            () => {
-              this.opts.client.ackDispatchByID(this.opts.config.org_id, data.id).catch(() => {});
-            },
+            () => this.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)),
           );
         } catch (err) {
           this.opts.log?.error(`task update dispatch failed for ${data.task_id}: ${String(err)}`);
@@ -516,9 +521,7 @@ export class ParallAgentGateway {
           await this.consumeTypedDispatch(
             { dispatchEventId: data.id },
             () => this.fetchAndHandleScheduleFire(data.source_id, data.actor_id),
-            () => {
-              this.opts.client.ackDispatchByID(this.opts.config.org_id, data.id).catch(() => {});
-            },
+            () => this.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)),
           );
         } catch (err) {
           this.opts.log?.error(
@@ -531,9 +534,7 @@ export class ParallAgentGateway {
           await this.consumeTypedDispatch(
             { dispatchEventId: data.id },
             () => this.fetchAndHandleExternalTriggerRun(data.source_id),
-            () => {
-              this.opts.client.ackDispatchByID(this.opts.config.org_id, data.id).catch(() => {});
-            },
+            () => this.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)),
           );
         } catch (err) {
           this.opts.log?.error(
@@ -546,9 +547,7 @@ export class ParallAgentGateway {
           await this.consumeTypedDispatch(
             { dispatchEventId: data.id },
             () => this.fetchAndHandleChannelMessage(data.source_id),
-            () => {
-              this.opts.client.ackDispatchByID(this.opts.config.org_id, data.id).catch(() => {});
-            },
+            () => this.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)),
           );
         } catch (err) {
           this.opts.log?.error(
@@ -566,9 +565,7 @@ export class ParallAgentGateway {
                 data.actor_id,
                 data.chat_id ?? null,
               ),
-            () => {
-              this.opts.client.ackDispatchByID(this.opts.config.org_id, data.id).catch(() => {});
-            },
+            () => this.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)),
           );
         } catch (err) {
           this.opts.log?.error(
@@ -589,14 +586,11 @@ export class ParallAgentGateway {
         } catch (err) {
           this.opts.log?.error(`message re-drive failed for ${data.source_id}: ${String(err)}`);
         }
-      } else if (data.event_type !== 'message' && data.event_type !== 'task_assign') {
+      } else if (data.event_type !== 'message') {
         // Truly unknown event_type — log so a newly-added dispatch type
-        // not yet wired here surfaces during runtime testing. "message"
-        // and "task_assign" are deliberately excluded: dispatch.new
-        // carries them too, but they are owned by dedicated WS handlers
-        // (message.new, task.assigned) above and would otherwise spam
-        // info-level logs for every inbound chat message / task
-        // assignment on a busy agent.
+        // not yet wired here surfaces during runtime testing. "message" is
+        // deliberately excluded because its first delivery is owned by the
+        // message.new handler; recovered task_assign rows are handled above.
         this.opts.log?.info(
           `dispatch.new with unhandled event_type=${String(data.event_type)} (id=${data.id}) — no-op`,
         );
@@ -686,11 +680,59 @@ export class ParallAgentGateway {
   private consumeTypedDispatch(
     ref: { dispatchEventId?: string; sourceType?: string; sourceId?: string },
     run: (dispatchEventId?: string) => Promise<boolean>,
-    ack: (dispatchEventId?: string) => void,
+    ack: (dispatchEventId?: string) => void | Promise<void>,
   ): Promise<void> {
     return consumeTypedDispatch(this.laneFlowHost(), ref, run, ack);
   }
 
+  // Typed completion must wait until the administrative ack has either
+  // committed or failed. Errors stay best-effort: a failed ack leaves the row
+  // received, so Complete releases and re-drives it safely.
+  private ackDispatchEvent(dispatchEventId: string, onFailure?: () => void): Promise<void> {
+    return this.opts.client.ackDispatchByID(this.opts.config.org_id, dispatchEventId).then(
+      () => undefined,
+      (err) => {
+        // Complete will return the still-received item to pending and publish
+        // an immediate hint. Free its hot-path claim first, otherwise that
+        // same-process re-drive is rejected forever by the local dedupe set.
+        onFailure?.();
+        this.opts.log?.warn(
+          `dispatch ack failed for ${dispatchEventId}, releasing for re-drive: ${String(err)}`,
+        );
+      },
+    );
+  }
+
+  private clearTypedDispatchDedupe(item: DispatchNewData): void {
+    switch (item.event_type) {
+      case 'task_assign':
+      case 'task_update':
+        if (item.task_id) {
+          const prefix = `${item.task_id}:`;
+          for (const key of this.dispatchedTasks) {
+            if (key.startsWith(prefix)) this.dispatchedTasks.delete(key);
+          }
+        }
+        break;
+      case 'task_comment':
+      case 'wiki_comment':
+        if (item.source_id) this.dispatchedTasks.delete(`comment:${item.source_id}`);
+        break;
+      case 'schedule.fire':
+        if (item.source_id) this.dispatchedTasks.delete(`schedule_run:${item.source_id}`);
+        break;
+      case 'external_trigger':
+        if (item.source_id) this.dispatchedTasks.delete(`external_trigger_run:${item.source_id}`);
+        break;
+      case 'channel_message':
+        if (item.source_id) this.dispatchedMessages.delete(`channel_message:${item.source_id}`);
+        break;
+      case 'approval_decided':
+        if (item.source_id) this.dispatchedTasks.delete(`approval:${item.source_id}`);
+        break;
+    }
+  }
+
   private buildDispatchContext(event: ParallEvent, sessionKey: string): DispatchContext {
     const binding = this.sessionBindings.get(sessionKey);
     return {
@@ -2023,6 +2065,25 @@ export class ParallAgentGateway {
     });
   }
 
+  // A task assignment's first delivery rides task.assigned, but a typed lane
+  // released without an effect is re-driven as dispatch.new. Reuse the exact
+  // typed claim path used by catch-up so that recovery does not require a
+  // runtime reconnect.
+  private async handleTaskAssignmentRedrive(item: DispatchNewData): Promise<void> {
+    if (!item.task_id) return;
+    await this.consumeTypedDispatch(
+      { dispatchEventId: item.id },
+      (dispatchEventId) =>
+        this.handleTaskDispatch(item.task_id ?? '', item.source_id ?? item.task_id ?? '', {
+          dispatchEventId,
+        }),
+      (dispatchEventId) =>
+        this.ackDispatchEvent(dispatchEventId ?? item.id, () =>
+          this.clearTypedDispatchDedupe(item),
+        ),
+    );
+  }
+
   private consumeMessageWorkItem(item: {
     id: string;
     source_id: string;
@@ -2596,9 +2657,8 @@ export class ParallAgentGateway {
 
         processed++;
         try {
-          const ackItem = () => {
-            this.opts.client.ackDispatchByID(this.opts.config.org_id, item.id).catch(() => {});
-          };
+          const ackItem = () =>
+            this.ackDispatchEvent(item.id, () => this.clearTypedDispatchDedupe(item));
           if (item.event_type === 'task_assign' && item.task_id) {
             try {
               await this.consumeTypedDispatch(

package/src/gateway-lane-flow.ts

@@ -133,10 +133,10 @@ export async function consumeTypedDispatch(
   host: LaneFlowHost,
   ref: { dispatchEventId?: string; sourceType?: string; sourceId?: string },
   run: (dispatchEventId?: string) => Promise<boolean>,
-  ack: (dispatchEventId?: string) => void,
+  ack: (dispatchEventId?: string) => void | Promise<void>,
 ): Promise<void> {
   if (!host.laneLedger || host.ledgerDisabled) {
-    if (await run(ref.dispatchEventId)) ack(ref.dispatchEventId);
+    if (await run(ref.dispatchEventId)) await ack(ref.dispatchEventId);
     return;
   }
   let lane: Awaited<ReturnType<LaneLedger['claimTyped']>>;
@@ -145,7 +145,7 @@ export async function consumeTypedDispatch(
   } catch (err) {
     if (err instanceof LedgerUnsupportedError) {
       host.disableLedger('claim endpoint missing');
-      if (await run(ref.dispatchEventId)) ack(ref.dispatchEventId);
+      if (await run(ref.dispatchEventId)) await ack(ref.dispatchEventId);
       return;
     }
     throw err;
@@ -157,7 +157,10 @@ export async function consumeTypedDispatch(
     return;
   }
   try {
-    if (await run(lane.typedDispatchEventId)) ack(lane.typedDispatchEventId);
+    // Ack must settle before Complete. A fire-and-forget ack races the lane
+    // release: Complete can return the still-received typed item to pending
+    // and publish a re-drive while its successful ack is still in flight.
+    if (await run(lane.typedDispatchEventId)) await ack(lane.typedDispatchEventId);
   } finally {
     // Release the occupancy row. A buffered dispatch may outlive this guard
     // (lane TTL) — acceptable at-least-once; the ledger's resolution paths