@parall/agent-core 1.44.0 → 1.45.0

package/dist/gateway-base.d.ts

@@ -146,6 +146,14 @@ export declare class ParallAgentGateway {
      */
     consumeTurnError(sessionKey: string): boolean;
     private emitDispatchReceived;
+    /**
+     * Sticky: the server answered a by-id complete with 400 (predates the
+     * form). Typed resolution falls back to the legacy ack for the rest of
+     * the process lifetime.
+     */
+    typedByIdCompleteUnsupported: boolean;
+    private typedLedgerEventIds;
+    private resolveDispatchByID;
     /** True when this event's lifecycle is owned by the dispatch lane ledger. */
     private usesLaneLedger;
     private disableLedger;

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

@@ -4,7 +4,7 @@ import * as path from 'node:path';
 import { ApiError, MENTION_ALL_USER_ID } from '@parall/sdk';
 import { buildEventBody, buildEventBodyForForkResult, buildForkResultPrefix, buildForkScopePrefix, } from './event-format.js';
 import { buildErrorStepContent, } from './dispatch-adapter.js';
-import { consumeMessageWorkItem, consumeTypedDispatch, dispatchLaneGroup, } from './gateway-lane-flow.js';
+import { consumeMessageWorkItem, consumeTypedDispatch, dispatchLaneGroup, resolveDispatchByID, settleDrainedTypedGroup, typedLedgerEventIds, } from './gateway-lane-flow.js';
 import { LaneLedger } from './lane-ledger.js';
 import { routeTrigger } from './routing.js';
 import { clearDispatchMessageId, clearDispatchMetrics, clearDispatchNoReply, clearSessionMessageId, getDispatchMetrics, recordDeliverText, recordMessageSend, recordNoReply, recordToolCall, resetDispatchMetrics, setDispatchMessageId, setDispatchNoReply, setSessionChatId, setSessionMessageId, } from './session-state.js';
@@ -256,25 +256,28 @@ export class ParallAgentGateway {
                 // level claim/ack would consume or clear the wrong sibling.
                 await this.consumeTypedDispatch(data.dispatch_event_id
                     ? { dispatchEventId: data.dispatch_event_id }
-                    : { sourceType: 'task_activity', sourceId: data.id }, (dispatchEventId) => this.handleTaskAssignment(data, data.id, dispatchEventId), (dispatchEventId) => {
-                    if (dispatchEventId) {
-                        return this.ackDispatchEvent(dispatchEventId, () => {
+                    : { sourceType: 'task_activity', sourceId: data.id }, (dispatchEventId) => this.handleTaskAssignment(data, data.id, dispatchEventId), {
+                    legacyAck: (dispatchEventId) => {
+                        if (dispatchEventId) {
+                            return this.ackDispatchEvent(dispatchEventId, () => {
+                                this.dispatchedTasks.delete(`${data.id}:${data.updated_at}`);
+                            });
+                        }
+                        return this.opts.client
+                            .ackDispatch(this.opts.config.org_id, {
+                            source_type: 'task_activity',
+                            source_id: data.id,
+                        })
+                            .then(() => true, (err) => {
+                            // Same contract as ackDispatchEvent: a failed ack is a
+                            // failed consume (arms backoff) and must free the hot-path
+                            // dedupe so the re-drive isn't rejected by this pod forever.
                             this.dispatchedTasks.delete(`${data.id}:${data.updated_at}`);
+                            this.opts.log?.warn(`dispatch ack failed for task ${data.id}, releasing for re-drive: ${String(err)}`);
+                            return false;
                         });
-                    }
-                    return this.opts.client
-                        .ackDispatch(this.opts.config.org_id, {
-                        source_type: 'task_activity',
-                        source_id: data.id,
-                    })
-                        .then(() => true, (err) => {
-                        // Same contract as ackDispatchEvent: a failed ack is a
-                        // failed consume (arms backoff) and must free the hot-path
-                        // dedupe so the re-drive isn't rejected by this pod forever.
-                        this.dispatchedTasks.delete(`${data.id}:${data.updated_at}`);
-                        this.opts.log?.warn(`dispatch ack failed for task ${data.id}, releasing for re-drive: ${String(err)}`);
-                        return false;
-                    });
+                    },
+                    clearDedupe: () => this.dispatchedTasks.delete(`${data.id}:${data.updated_at}`),
                 });
             }
             catch (err) {
@@ -296,7 +299,10 @@ export class ParallAgentGateway {
                 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.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)));
+                    await this.consumeTypedDispatch({ dispatchEventId: data.id }, (dispatchEventId) => this.handleTaskComment(data.source_id, data.task_id ?? '', data.actor_id, data.delivery_reason, dispatchEventId), {
+                        legacyAck: () => this.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)),
+                        clearDedupe: () => this.clearTypedDispatchDedupe(data),
+                    });
                 }
                 catch (err) {
                     this.opts.log?.error(`task comment dispatch failed for ${data.source_id}: ${String(err)}`);
@@ -306,7 +312,10 @@ 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.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)));
+                    await this.consumeTypedDispatch({ dispatchEventId: data.id }, (dispatchEventId) => this.handleWikiComment(data.source_id, data.actor_id, data.delivery_reason, dispatchEventId), {
+                        legacyAck: () => this.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)),
+                        clearDedupe: () => this.clearTypedDispatchDedupe(data),
+                    });
                 }
                 catch (err) {
                     this.opts.log?.error(`wiki comment dispatch failed for ${data.source_id}: ${String(err)}`);
@@ -319,7 +328,10 @@ 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.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)));
+                    }), {
+                        legacyAck: () => this.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)),
+                        clearDedupe: () => this.clearTypedDispatchDedupe(data),
+                    });
                 }
                 catch (err) {
                     this.opts.log?.error(`task update dispatch failed for ${data.task_id}: ${String(err)}`);
@@ -329,7 +341,10 @@ export class ParallAgentGateway {
                 if (!data.source_id)
                     return;
                 try {
-                    await this.consumeTypedDispatch({ dispatchEventId: data.id }, () => this.fetchAndHandleScheduleFire(data.source_id, data.actor_id), () => this.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)));
+                    await this.consumeTypedDispatch({ dispatchEventId: data.id }, (dispatchEventId) => this.fetchAndHandleScheduleFire(data.source_id, data.actor_id, dispatchEventId), {
+                        legacyAck: () => this.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)),
+                        clearDedupe: () => this.clearTypedDispatchDedupe(data),
+                    });
                 }
                 catch (err) {
                     this.opts.log?.error(`schedule fire dispatch failed for ${data.source_id}: ${String(err)}`);
@@ -339,7 +354,10 @@ export class ParallAgentGateway {
                 if (!data.source_id)
                     return;
                 try {
-                    await this.consumeTypedDispatch({ dispatchEventId: data.id }, () => this.fetchAndHandleExternalTriggerRun(data.source_id), () => this.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)));
+                    await this.consumeTypedDispatch({ dispatchEventId: data.id }, (dispatchEventId) => this.fetchAndHandleExternalTriggerRun(data.source_id, dispatchEventId), {
+                        legacyAck: () => this.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)),
+                        clearDedupe: () => this.clearTypedDispatchDedupe(data),
+                    });
                 }
                 catch (err) {
                     this.opts.log?.error(`external trigger dispatch failed for ${data.source_id}: ${String(err)}`);
@@ -349,7 +367,10 @@ export class ParallAgentGateway {
                 if (!data.source_id)
                     return;
                 try {
-                    await this.consumeTypedDispatch({ dispatchEventId: data.id }, () => this.fetchAndHandleChannelMessage(data.source_id), () => this.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)));
+                    await this.consumeTypedDispatch({ dispatchEventId: data.id }, (dispatchEventId) => this.fetchAndHandleChannelMessage(data.source_id, dispatchEventId), {
+                        legacyAck: () => this.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)),
+                        clearDedupe: () => this.clearTypedDispatchDedupe(data),
+                    });
                 }
                 catch (err) {
                     this.opts.log?.error(`channel message dispatch failed for ${data.source_id}: ${String(err)}`);
@@ -359,7 +380,10 @@ 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.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)));
+                    await this.consumeTypedDispatch({ dispatchEventId: data.id }, (dispatchEventId) => this.fetchAndHandleApprovalDecided(data.source_id, data.actor_id, data.chat_id ?? null, dispatchEventId), {
+                        legacyAck: () => this.ackDispatchEvent(data.id, () => this.clearTypedDispatchDedupe(data)),
+                        clearDedupe: () => this.clearTypedDispatchDedupe(data),
+                    });
                 }
                 catch (err) {
                     this.opts.log?.error(`approval decided dispatch failed for ${data.source_id}: ${String(err)}`);
@@ -456,6 +480,20 @@ export class ParallAgentGateway {
             source_id: sourceId,
         });
     }
+    /**
+     * Sticky: the server answered a by-id complete with 400 (predates the
+     * form). Typed resolution falls back to the legacy ack for the rest of
+     * the process lifetime.
+     */
+    typedByIdCompleteUnsupported = false;
+    // Typed-face ledger helpers live in gateway-lane-flow.ts; thin delegates
+    // keep the site code and tests on the class surface.
+    typedLedgerEventIds(events) {
+        return typedLedgerEventIds(this.laneFlowHost(), events);
+    }
+    resolveDispatchByID(dispatchEventId, lane) {
+        return resolveDispatchByID(this.laneFlowHost(), dispatchEventId, lane);
+    }
     /** True when this event's lifecycle is owned by the dispatch lane ledger. */
     usesLaneLedger(event) {
         return this.laneLedger != null && !this.ledgerDisabled && this.laneLedger.handles(event);
@@ -490,15 +528,16 @@ export class ParallAgentGateway {
     dispatchLaneGroup(opts) {
         return dispatchLaneGroup(this.laneFlowHost(), opts);
     }
-    consumeTypedDispatch(ref, run, ack) {
-        return consumeTypedDispatch(this.laneFlowHost(), ref, run, ack);
+    consumeTypedDispatch(ref, run, hooks) {
+        return consumeTypedDispatch(this.laneFlowHost(), ref, run, hooks);
     }
-    // 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. The boolean
-    // outcome feeds the typed-consume backoff — an ack that failed must count
-    // as a failed consume, or an ack outage would clear the backoff entry and
-    // let the release re-drive spin at wire speed.
+    // Legacy administrative ack (ledger-disabled fallback only). Typed
+    // completion must wait until the 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. The boolean outcome feeds the
+    // typed-consume backoff — an ack that failed must count as a failed
+    // consume, or an ack outage would clear the backoff entry and let the
+    // release re-drive spin at wire speed.
     ackDispatchEvent(dispatchEventId, onFailure) {
         return this.opts.client.ackDispatchByID(this.opts.config.org_id, dispatchEventId).then(() => true, (err) => {
             // Complete will return the still-received item to pending and publish
@@ -509,6 +548,9 @@ export class ParallAgentGateway {
             return false;
         });
     }
+    // PARITY: this switch and gateway-lane-flow's clearTypedDedupeForEvent must
+    // handle the same typed source families — extend BOTH when adding a typed
+    // event type (same dedupe entries, keyed from different event shapes).
     clearTypedDispatchDedupe(item) {
         switch (item.event_type) {
             case 'task_assign':
@@ -1190,6 +1232,19 @@ export class ParallAgentGateway {
                     }
                     else {
                         dispatched = await this.runDispatch(last, fork.fork.sessionKey, buildForkScopePrefix(last) + buildEventBody(last), earlier, batchText);
+                        if (dispatched &&
+                            this.typedLedgerEventIds(events) &&
+                            this.consumeTurnError(fork.fork.sessionKey)) {
+                            // Typed error turn in a fork: report failure to the awaiting
+                            // typed consumes so the members release for a budgeted retry,
+                            // and do NOT record the events as handled — the redrive must
+                            // not arrive wearing an "already handled" prefix. Keep draining
+                            // (an error turn is not a shutdown).
+                            this.opts.log?.info(`typed fork turn for ${last.messageId} surfaced a runtime error — releasing for retry`);
+                            for (const item of items)
+                                item.resolve(false);
+                            continue;
+                        }
                     }
                     if (!dispatched) {
                         // Shutdown short-circuit — resolve un-acked so the server requeues
@@ -1366,14 +1421,21 @@ export class ParallAgentGateway {
                     // no_action sweep); no legacy acks.
                     continue;
                 }
-                try {
-                    await this.emitDispatchReceived(event);
-                }
-                catch (err) {
-                    this.opts.log?.warn?.(`mark-received failed for buffered dispatch, leaving unacked for retry: ${String(err)}`);
-                    this.dispatchState.mainBuffer.unshift(...events);
-                    this.dispatchState.pendingForkResults.unshift(...pendingFork);
-                    break;
+                // Buffered typed events are the one wrapper-less dispatch path: their
+                // consumeTypedDispatch guard returned long ago (buffer-main resolves
+                // false) and released the claims, so THIS site owns their resolution.
+                // Message groups here are the ledger-disabled legacy flow.
+                const typedRefs = this.typedLedgerEventIds(events);
+                if (!typedRefs) {
+                    try {
+                        await this.emitDispatchReceived(event);
+                    }
+                    catch (err) {
+                        this.opts.log?.warn?.(`mark-received failed for buffered dispatch, leaving unacked for retry: ${String(err)}`);
+                        this.dispatchState.mainBuffer.unshift(...events);
+                        this.dispatchState.pendingForkResults.unshift(...pendingFork);
+                        break;
+                    }
                 }
                 const dispatched = await this.runDispatch(event, this.opts.runtimeKey, forkPrefix + buildEventBody(event), earlier);
                 if (!dispatched) {
@@ -1384,6 +1446,13 @@ export class ParallAgentGateway {
                     this.dispatchState.pendingForkResults.unshift(...pendingFork);
                     break;
                 }
+                if (typedRefs) {
+                    // Wrapper-less resolution of the buffered typed group — protocol
+                    // lives in gateway-lane-flow.ts. The turn-error marker is consumed
+                    // HERE, before this loop can start another turn on the session.
+                    await settleDrainedTypedGroup(this.laneFlowHost(), events, typedRefs, this.consumeTurnError(this.opts.runtimeKey));
+                    continue;
+                }
                 for (const bufferedEvent of events) {
                     const sourceType = bufferedEvent.ackSourceType ??
                         (bufferedEvent.type === 'task' ? 'task_activity' : 'message');
@@ -1464,21 +1533,36 @@ export class ParallAgentGateway {
                     }
                     return outcome === 'dispatched';
                 }
-                try {
-                    await this.emitDispatchReceived(event);
-                }
-                catch (err) {
-                    this.opts.log?.warn?.(`mark-received failed, leaving unacked for retry: ${String(err)}`);
-                    this.dispatchState.mainDispatching = false;
-                    this.dispatchState.mainCurrentTargetId = undefined;
-                    this.mainCurrentGroupKey = undefined;
-                    this.dispatchState.mainPreDispatchBranchPoint = undefined;
-                    this.dispatchState.pendingForkResults.unshift(...pendingFork);
-                    return false;
+                // Ledger-claimed typed events skip the legacy received write — the
+                // claim already marked the row received, and a second mark here would
+                // wipe its lease owner (the 0713 black-hole shape on the typed face).
+                const typedRefs = this.typedLedgerEventIds([event]);
+                if (!typedRefs) {
+                    try {
+                        await this.emitDispatchReceived(event);
+                    }
+                    catch (err) {
+                        this.opts.log?.warn?.(`mark-received failed, leaving unacked for retry: ${String(err)}`);
+                        this.dispatchState.mainDispatching = false;
+                        this.dispatchState.mainCurrentTargetId = undefined;
+                        this.mainCurrentGroupKey = undefined;
+                        this.dispatchState.mainPreDispatchBranchPoint = undefined;
+                        this.dispatchState.pendingForkResults.unshift(...pendingFork);
+                        return false;
+                    }
                 }
                 let dispatched = false;
                 try {
                     dispatched = await this.runDispatch(event, this.opts.runtimeKey, forkPrefix + buildEventBody(event));
+                    if (dispatched && typedRefs && this.consumeTurnError(this.opts.runtimeKey)) {
+                        // Typed error turn: report failure to the enclosing typed consume
+                        // so the member releases for a budgeted retry instead of being
+                        // terminally resolved (tech-debt: typed-dispatch-error-outcome).
+                        // Consumed HERE, before the finally's drain can start another
+                        // turn on this session and clear the marker.
+                        this.opts.log?.info(`typed dispatch turn for ${event.messageId} surfaced a runtime error — releasing for retry`);
+                        dispatched = false;
+                    }
                     if (!dispatched) {
                         // Shutdown short-circuit — restore the fork results so a future
                         // pod can replay them, and return false so handleMessage skips ack.
@@ -1552,8 +1636,9 @@ export class ParallAgentGateway {
                 // — the fork's lane claim marks them received. A mark-received here
                 // outruns the claim, strands the row ownerless, and the chat goes
                 // silent (the 0713 black hole; dispatch-convergence-design.md §6).
-                // This was the only unguarded call site of the three.
-                if (!this.usesLaneLedger(event)) {
+                // Same rule for ledger-claimed typed events: their dsp-lane claim
+                // owns received-ness, and a re-mark would wipe the lease owner.
+                if (!this.usesLaneLedger(event) && !this.typedLedgerEventIds([event])) {
                     try {
                         await this.emitDispatchReceived(event);
                     }
@@ -1748,7 +1833,10 @@ export class ParallAgentGateway {
             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)));
+        }), {
+            legacyAck: (dispatchEventId) => this.ackDispatchEvent(dispatchEventId ?? item.id, () => this.clearTypedDispatchDedupe(item)),
+            clearDedupe: () => this.clearTypedDispatchDedupe(item),
+        });
     }
     consumeMessageWorkItem(item) {
         return consumeMessageWorkItem(this.laneFlowHost(), item);
@@ -1810,7 +1898,7 @@ export class ParallAgentGateway {
         }
         return this.handleTaskAssignment(task, ackSourceId, opts.dispatchEventId);
     }
-    async handleTaskComment(commentId, taskId, actorId, deliveryReason) {
+    async handleTaskComment(commentId, taskId, actorId, deliveryReason, dispatchEventId) {
         if (this.shuttingDown)
             return false; // drain window — let server requeue via catch-up
         const dedupeKey = `comment:${commentId}`;
@@ -1872,6 +1960,7 @@ export class ParallAgentGateway {
             deliveryReason: deliveryReason ?? undefined,
             ackSourceType: 'comment',
             ackSourceId: commentId,
+            dispatchEventId,
         };
         let dispatched;
         try {
@@ -1887,7 +1976,7 @@ export class ParallAgentGateway {
         }
         return dispatched;
     }
-    async handleWikiComment(commentId, actorId, deliveryReason) {
+    async handleWikiComment(commentId, actorId, deliveryReason, dispatchEventId) {
         if (this.shuttingDown)
             return false; // drain window — let server requeue via catch-up
         // Shares the comment dedupe namespace with handleTaskComment; comment IDs
@@ -1940,6 +2029,7 @@ export class ParallAgentGateway {
             replyTargetUri: comment.target_uri,
             ackSourceType: 'comment',
             ackSourceId: commentId,
+            dispatchEventId,
         };
         let dispatched;
         try {
@@ -1963,7 +2053,7 @@ export class ParallAgentGateway {
      * access to already-delivered run snapshots, and the runtime must not crash
      * or retry forever in that case.
      */
-    async fetchAndHandleScheduleFire(runId, actorId) {
+    async fetchAndHandleScheduleFire(runId, actorId, dispatchEventId) {
         let run = null;
         try {
             run = await this.opts.client.getScheduleRun(this.opts.config.org_id, runId);
@@ -1984,9 +2074,9 @@ export class ParallAgentGateway {
         }
         if (!run)
             return true;
-        return this.handleScheduleFire(run, actorId);
+        return this.handleScheduleFire(run, actorId, dispatchEventId);
     }
-    async handleScheduleFire(run, actorId) {
+    async handleScheduleFire(run, actorId, dispatchEventId) {
         if (this.shuttingDown)
             return false; // drain window — let server requeue via catch-up
         const dedupeKey = `schedule_run:${run.id}`;
@@ -2010,6 +2100,7 @@ export class ParallAgentGateway {
             attachedUri: run.fired_attached_uri ?? undefined,
             ackSourceType: 'schedule_run',
             ackSourceId: run.id,
+            dispatchEventId,
         };
         let dispatched;
         try {
@@ -2024,7 +2115,7 @@ export class ParallAgentGateway {
         }
         return dispatched;
     }
-    async fetchAndHandleExternalTriggerRun(runId) {
+    async fetchAndHandleExternalTriggerRun(runId, dispatchEventId) {
         let run = null;
         try {
             run = await this.opts.client.getExternalTriggerRun(this.opts.config.org_id, runId);
@@ -2040,14 +2131,14 @@ export class ParallAgentGateway {
         }
         if (!run)
             return true;
-        return this.handleExternalTriggerRun(run);
+        return this.handleExternalTriggerRun(run, dispatchEventId);
     }
     // fetchAndHandleChannelMessage resolves a channel_message dispatch to its
     // durable ChannelMessage + conversation and hands it to the inbound
     // pipeline. targetId = the ChannelConversation id, so per-conversation
     // multi-turn continuity rides the same per-target session mechanics as
     // chats. Design: docs/engineering-design/external-im-channel-design.md.
-    async fetchAndHandleChannelMessage(messageId) {
+    async fetchAndHandleChannelMessage(messageId, dispatchEventId) {
         if (this.shuttingDown)
             return false;
         // Capped dedupe (the chat-message path, not the unbounded task set): a busy
@@ -2121,6 +2212,7 @@ export class ParallAgentGateway {
             channelCliCapable: cliCapable,
             ackSourceType: 'channel_message',
             ackSourceId: msg.id,
+            dispatchEventId,
         };
         // Release the claim if the event isn't actually dispatched (or throws) so
         // a retry can re-attempt — same contract as the chat-message path.
@@ -2137,7 +2229,7 @@ export class ParallAgentGateway {
         }
         return dispatched;
     }
-    async handleExternalTriggerRun(run) {
+    async handleExternalTriggerRun(run, dispatchEventId) {
         if (this.shuttingDown)
             return false;
         const dedupeKey = `external_trigger_run:${run.id}`;
@@ -2165,6 +2257,7 @@ export class ParallAgentGateway {
             attachedUri,
             ackSourceType: 'external_trigger_run',
             ackSourceId: run.id,
+            dispatchEventId,
         };
         let dispatched;
         try {
@@ -2179,7 +2272,7 @@ export class ParallAgentGateway {
         }
         return dispatched;
     }
-    async fetchAndHandleApprovalDecided(approvalId, actorId, chatId) {
+    async fetchAndHandleApprovalDecided(approvalId, actorId, chatId, dispatchEventId) {
         let approval = null;
         try {
             approval = await this.opts.client.getApproval(approvalId);
@@ -2212,6 +2305,11 @@ export class ParallAgentGateway {
             senderName: 'approver',
             messageId: approval.id,
             body,
+            // The WorkItem's real source pair. Without it the legacy fallback
+            // guessed ('message', approval_id) — a pair no row matches.
+            ackSourceType: 'approval',
+            ackSourceId: approval.id,
+            dispatchEventId,
         };
         let dispatched;
         try {
@@ -2262,7 +2360,26 @@ export class ParallAgentGateway {
                     break;
                 if (overflowMode && processed >= CATCHUP_MAX) {
                     try {
-                        await this.opts.client.ackDispatchByID(this.opts.config.org_id, item.id);
+                        // Administrative drop of the overflow backlog (summarized to the
+                        // agent instead of dispatched). Ledger path: by-id complete —
+                        // closes the pending row and refuses (stale) one a live lane
+                        // owns; the legacy ack stays as the ledger-disabled / pre-by-id
+                        // fallback.
+                        if (this.laneLedger && !this.ledgerDisabled && !this.typedByIdCompleteUnsupported) {
+                            const outcome = await this.resolveDispatchByID(item.id);
+                            if (outcome === 'unsupported') {
+                                this.typedByIdCompleteUnsupported = true;
+                                await this.opts.client.ackDispatchByID(this.opts.config.org_id, item.id);
+                            }
+                            else if (outcome === 'failed') {
+                                throw new Error('by-id complete failed');
+                            }
+                            // 'stale' counts as skipped: a live lane owns the row and its
+                            // turn will resolve it — nothing left for catch-up to do.
+                        }
+                        else {
+                            await this.opts.client.ackDispatchByID(this.opts.config.org_id, item.id);
+                        }
                         skipped++;
                         const key = item.event_type;
                         skippedByType.set(key, (skippedByType.get(key) ?? 0) + 1);
@@ -2274,12 +2391,15 @@ export class ParallAgentGateway {
                 }
                 processed++;
                 try {
-                    const ackItem = () => this.ackDispatchEvent(item.id, () => this.clearTypedDispatchDedupe(item));
+                    const typedHooks = {
+                        legacyAck: () => this.ackDispatchEvent(item.id, () => this.clearTypedDispatchDedupe(item)),
+                        clearDedupe: () => 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 ?? '', {
                                 dispatchEventId,
-                            }), ackItem);
+                            }), typedHooks);
                         }
                         catch (err) {
                             this.opts.log?.warn(`catch-up task fetch failed for ${item.task_id}, leaving pending: ${String(err)}`);
@@ -2291,7 +2411,7 @@ export class ParallAgentGateway {
                             await this.consumeTypedDispatch({ dispatchEventId: item.id }, (dispatchEventId) => this.handleTaskDispatch(item.task_id ?? '', item.source_id ?? item.task_id ?? '', {
                                 allowCreator: true,
                                 dispatchEventId,
-                            }), ackItem);
+                            }), typedHooks);
                         }
                         catch (err) {
                             this.opts.log?.warn(`catch-up task fetch failed for ${item.task_id}, leaving pending: ${String(err)}`);
@@ -2299,22 +2419,22 @@ export class ParallAgentGateway {
                         }
                     }
                     else if (item.event_type === 'task_comment' && item.source_id && item.task_id) {
-                        await this.consumeTypedDispatch({ dispatchEventId: item.id }, () => this.handleTaskComment(item.source_id, item.task_id ?? '', item.actor_id, item.delivery_reason), ackItem);
+                        await this.consumeTypedDispatch({ dispatchEventId: item.id }, (dispatchEventId) => this.handleTaskComment(item.source_id, item.task_id ?? '', item.actor_id, item.delivery_reason, dispatchEventId), typedHooks);
                     }
                     else if (item.event_type === 'wiki_comment' && item.source_id) {
-                        await this.consumeTypedDispatch({ dispatchEventId: item.id }, () => this.handleWikiComment(item.source_id, item.actor_id, item.delivery_reason), ackItem);
+                        await this.consumeTypedDispatch({ dispatchEventId: item.id }, (dispatchEventId) => this.handleWikiComment(item.source_id, item.actor_id, item.delivery_reason, dispatchEventId), typedHooks);
                     }
                     else if (item.event_type === 'schedule.fire' && item.source_id) {
-                        await this.consumeTypedDispatch({ dispatchEventId: item.id }, () => this.fetchAndHandleScheduleFire(item.source_id, item.actor_id), ackItem);
+                        await this.consumeTypedDispatch({ dispatchEventId: item.id }, (dispatchEventId) => this.fetchAndHandleScheduleFire(item.source_id, item.actor_id, dispatchEventId), typedHooks);
                     }
                     else if (item.event_type === 'external_trigger' && item.source_id) {
-                        await this.consumeTypedDispatch({ dispatchEventId: item.id }, () => this.fetchAndHandleExternalTriggerRun(item.source_id), ackItem);
+                        await this.consumeTypedDispatch({ dispatchEventId: item.id }, (dispatchEventId) => this.fetchAndHandleExternalTriggerRun(item.source_id, dispatchEventId), typedHooks);
                     }
                     else if (item.event_type === 'channel_message' && item.source_id) {
-                        await this.consumeTypedDispatch({ dispatchEventId: item.id }, () => this.fetchAndHandleChannelMessage(item.source_id), ackItem);
+                        await this.consumeTypedDispatch({ dispatchEventId: item.id }, (dispatchEventId) => this.fetchAndHandleChannelMessage(item.source_id, dispatchEventId), typedHooks);
                     }
                     else if (item.event_type === 'approval_decided' && item.source_id) {
-                        await this.consumeTypedDispatch({ dispatchEventId: item.id }, () => this.fetchAndHandleApprovalDecided(item.source_id, item.actor_id, item.chat_id ?? null), ackItem);
+                        await this.consumeTypedDispatch({ dispatchEventId: item.id }, (dispatchEventId) => this.fetchAndHandleApprovalDecided(item.source_id, item.actor_id, item.chat_id ?? null, dispatchEventId), typedHooks);
                     }
                     else if (item.event_type === 'message' && item.source_id && item.chat_id) {
                         await this.consumeMessageWorkItem({