@parall/parel-channel 1.51.0 → 1.52.0

package/dist/session.d.ts

@@ -16,7 +16,16 @@ import type { ConnectorContext, ConnectorEffect } from '@parel/plugin-sdk';
  * carry subject=chatId/chv_ — parel groups a turn's inputs by it (F2) and
  * mirrors it on agent events, so steps and turn signals stay chat-addressed.
  */
-export declare const REQUEST_TIMEOUT_MS = 10000;
+/**
+ * Single-fetch cap for every inline API call in hook bodies. 5s — the
+ * execution-model v2 hook budgets (onMessage/onTimer/deliver/onAgentEvent
+ * 60s, first timeout = epoch rotation) price the LONGEST legal serial chain,
+ * so per-fetch caps must keep any hook's worst case well inside 60s (target
+ * ≤30s, half the budget). Parall API latency is far below this; 10s was
+ * slow-path headroom stacked on worst cases, and it priced the 1.48.0 chains
+ * at ≈55-68s — over budget.
+ */
+export declare const REQUEST_TIMEOUT_MS = 5000;
 /** The agent-global runtime session identity under `main` channel routing. */
 export declare const MAIN_SESSION_KEY = "main";
 /** Reporting needs the agent id in the endpoint path; old configs lack it. */
@@ -81,12 +90,15 @@ export declare function ensureSession(ctx: ConnectorContext, opts?: {
 }): Promise<string | null>;
 /**
  * Resolve the CURRENT main ase_ from the server, bypassing the cache — the
- * onOpen generation check needs the authoritative id to compare against the
+ * catch-up generation check needs the authoritative id to compare against the
  * cached one (New Session rotates it). Updates the cache on success; returns
  * null on failure WITHOUT touching the cache (the caller must not lose its
- * only generation token to a transient error).
+ * only generation token to a transient error). The generation check runs
+ * inside a v1 5s onTimer budget, so it passes a tighter timeoutMs.
  */
-export declare function fetchMainSessionFresh(ctx: ConnectorContext): Promise<string | null>;
+export declare function fetchMainSessionFresh(ctx: ConnectorContext, opts?: {
+    timeoutMs?: number;
+}): Promise<string | null>;
 /**
  * Get-or-create the parall AgentSession mirroring one fork child session
  * (ase_ with parent_session_id → the main ase_, runtime_session_id = the
@@ -115,6 +127,7 @@ export declare function createInputStep(ctx: ConnectorContext, sessionId: string
     messageId: string;
     senderId?: string;
     text: string;
+    threadRootId?: string;
 }): Promise<ReportResult>;
 /**
  * Input step for a channel_message dispatch (external IM). Shaped exactly
@@ -254,10 +267,17 @@ export declare function claimDispatchSource(ctx: ConnectorContext, sourceType: s
  * retired turnwatch timer). Must comfortably exceed any legitimate turn.
  */
 export declare const EMIT_TTL_MS: number;
-/** The current emit attempt for a source: its envelope id + emit time. */
+/**
+ * The current emit attempt for a source: its envelope id + emit time, plus
+ * the session that owned the turn at emit time (attribution for the turn-end
+ * ledger close — bound per attempt so a close landing after a New Session
+ * rotation stamps the session that actually processed it, never the fresh
+ * post-reset one).
+ */
 export type ActiveEmit = {
     id: string;
     at: number;
+    sessionId?: string;
 };
 /**
  * Per-source attempt fence. Written before emit, cleared by the matching
@@ -267,7 +287,7 @@ export type ActiveEmit = {
  * close the in-flight retry's work (codex P2 attempt fence).
  */
 export declare function readActiveEmit(ctx: ConnectorContext, sourceType: string, sourceId: string): Promise<ActiveEmit | null>;
-export declare function writeActiveEmit(ctx: ConnectorContext, sourceType: string, sourceId: string, envelopeId: string): Promise<void>;
+export declare function writeActiveEmit(ctx: ConnectorContext, sourceType: string, sourceId: string, envelopeId: string, sessionId?: string): Promise<void>;
 export declare function clearActiveEmit(ctx: ConnectorContext, sourceType: string, sourceId: string): Promise<void>;
 /**
  * Burn the fence after an ERROR close: keep the attempt id (so the re-driven
@@ -314,13 +334,21 @@ export declare function completeFencedEnvelopes(ctx: ConnectorContext, envelopeI
  * broad-cover to the turn's reply Effect when one exists; otherwise a
  * no_action sweep on "ok", or a release back to pending on the redrive budget
  * on "error" (a failed turn must not silently consume work it never handled).
- * One immediate retry on failure; a still-failed call leaves the rows live
- * and the catch-up TTL re-emit self-heals.
+ *
+ * One immediate retry on a transient failure. This close never throws — it
+ * returns a bool the caller uses to decide whether to clear/burn the fence —
+ * so a failure is invisible to the v2 platform (no thrown hook error to
+ * replay). Whichever host we run on, the ONLY prompt recovery for a dropped
+ * close is this in-call retry; without it a single transient 5xx strands the
+ * fence live until the catch-up TTL re-emit (up to EMIT_TTL_MS = 30min),
+ * keeping the chat activity indicator lit that whole window. The retry is
+ * bounded (2 × REQUEST_TIMEOUT_MS) and the call is idempotent, so it stacks
+ * onto neither host's budget in the common (first-attempt-succeeds) case.
  */
 export declare function completeSources(ctx: ConnectorContext, sources: {
     source_type: string;
     source_id: string;
-}[], outcome?: TurnOutcome): Promise<boolean>;
+}[], sessionId?: string, outcome?: TurnOutcome): Promise<boolean>;
 /**
  * Turn-end plain text as a suppressed audit step — the runtime-standard
  * Layer 0 posture (agent-dm-loop-prevention.md): recorded on the session,

package/dist/session.d.ts.map

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

package/dist/session.js

@@ -16,7 +16,16 @@ import { parallAgentId, parallApiUrl, parallOrgId, requireAgk } from './connect.
  * carry subject=chatId/chv_ — parel groups a turn's inputs by it (F2) and
  * mirrors it on agent events, so steps and turn signals stay chat-addressed.
  */
-export const REQUEST_TIMEOUT_MS = 10_000;
+/**
+ * Single-fetch cap for every inline API call in hook bodies. 5s — the
+ * execution-model v2 hook budgets (onMessage/onTimer/deliver/onAgentEvent
+ * 60s, first timeout = epoch rotation) price the LONGEST legal serial chain,
+ * so per-fetch caps must keep any hook's worst case well inside 60s (target
+ * ≤30s, half the budget). Parall API latency is far below this; 10s was
+ * slow-path headroom stacked on worst cases, and it priced the 1.48.0 chains
+ * at ≈55-68s — over budget.
+ */
+export const REQUEST_TIMEOUT_MS = 5_000;
 /** The agent-global runtime session identity under `main` channel routing. */
 export const MAIN_SESSION_KEY = 'main';
 /** Reporting needs the agent id in the endpoint path; old configs lack it. */
@@ -136,12 +145,13 @@ export async function ensureSession(ctx, opts = {}) {
 }
 /**
  * Resolve the CURRENT main ase_ from the server, bypassing the cache — the
- * onOpen generation check needs the authoritative id to compare against the
+ * catch-up generation check needs the authoritative id to compare against the
  * cached one (New Session rotates it). Updates the cache on success; returns
  * null on failure WITHOUT touching the cache (the caller must not lose its
- * only generation token to a transient error).
+ * only generation token to a transient error). The generation check runs
+ * inside a v1 5s onTimer budget, so it passes a tighter timeoutMs.
  */
-export async function fetchMainSessionFresh(ctx) {
+export async function fetchMainSessionFresh(ctx, opts = {}) {
     if (!reportingEnabled(ctx))
         return null;
     try {
@@ -150,7 +160,7 @@ export async function fetchMainSessionFresh(ctx) {
             method: 'POST',
             headers: jsonHeaders(ctx),
             body: JSON.stringify({ runtime_type: 'parel', runtime_session_id: MAIN_SESSION_KEY }),
-            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
+            signal: AbortSignal.timeout(opts.timeoutMs ?? REQUEST_TIMEOUT_MS),
         });
         if (!res.ok)
             return null;
@@ -257,7 +267,12 @@ export async function createInputStep(ctx, sessionId, args) {
                 idempotency_key: `input:${args.messageId}`,
                 content: {
                     trigger_type: 'mention',
-                    trigger_ref: { message_id: args.messageId },
+                    trigger_ref: {
+                        message_id: args.messageId,
+                        // Thread context for the session→chat backlink (same contract as
+                        // agent-core's input steps).
+                        ...(args.threadRootId ? { thread_root_id: args.threadRootId } : {}),
+                    },
                     ...(args.senderId ? { sender_id: args.senderId } : {}),
                     summary: args.text.slice(0, 200),
                 },
@@ -630,9 +645,13 @@ export async function readActiveEmit(ctx, sourceType, sourceId) {
     }
     return null;
 }
-export async function writeActiveEmit(ctx, sourceType, sourceId, envelopeId) {
+export async function writeActiveEmit(ctx, sourceType, sourceId, envelopeId, sessionId) {
     await ctx.store
-        ?.set(activeEmitKey(sourceType, sourceId), { id: envelopeId, at: ctx.now() })
+        ?.set(activeEmitKey(sourceType, sourceId), {
+        id: envelopeId,
+        at: ctx.now(),
+        ...(sessionId ? { sessionId } : {}),
+    })
         .catch(() => { });
 }
 export async function clearActiveEmit(ctx, sourceType, sourceId) {
@@ -693,6 +712,7 @@ export function sourceFromEnvelopeId(envelopeId) {
  */
 export async function completeFencedEnvelopes(ctx, envelopeIds, outcome = 'ok') {
     const fenced = [];
+    const fenceSessions = new Set();
     for (const envId of envelopeIds) {
         const src = sourceFromEnvelopeId(envId);
         if (!src)
@@ -705,15 +725,27 @@ export async function completeFencedEnvelopes(ctx, envelopeIds, outcome = 'ok')
         // error close just released (the retry hole S3a closes).
         if (active?.id === envId && active.at > 0) {
             fenced.push({ source_type: src.sourceType, source_id: src.sourceId });
+            fenceSessions.add(active.sessionId);
         }
     }
-    if (fenced.length > 0 && (await completeSources(ctx, fenced, outcome))) {
-        for (const src of fenced) {
-            if (outcome === 'error') {
-                await burnActiveEmit(ctx, src.source_type, src.source_id);
-            }
-            else {
-                await clearActiveEmit(ctx, src.source_type, src.source_id);
+    if (fenced.length > 0) {
+        // Session attribution for the swept no_action rows (message ↔ session
+        // linking), read off the attempt fences themselves — the session that
+        // owned each envelope AT EMIT TIME. Never the mutable main-session cache:
+        // a close landing after a New Session rotation must not stamp the fresh
+        // session. Session-less fences (reporting disabled / legacy rows) are
+        // neutral — only fences DISAGREEING on a session drop the attribution
+        // (honest NULL); best-effort either way — never blocks the ledger close.
+        const known = [...fenceSessions].filter((s) => Boolean(s));
+        const sessionId = new Set(known).size === 1 ? known[0] : undefined;
+        if (await completeSources(ctx, fenced, sessionId, outcome)) {
+            for (const src of fenced) {
+                if (outcome === 'error') {
+                    await burnActiveEmit(ctx, src.source_type, src.source_id);
+                }
+                else {
+                    await clearActiveEmit(ctx, src.source_type, src.source_id);
+                }
             }
         }
     }
@@ -724,10 +756,18 @@ export async function completeFencedEnvelopes(ctx, envelopeIds, outcome = 'ok')
  * broad-cover to the turn's reply Effect when one exists; otherwise a
  * no_action sweep on "ok", or a release back to pending on the redrive budget
  * on "error" (a failed turn must not silently consume work it never handled).
- * One immediate retry on failure; a still-failed call leaves the rows live
- * and the catch-up TTL re-emit self-heals.
+ *
+ * One immediate retry on a transient failure. This close never throws — it
+ * returns a bool the caller uses to decide whether to clear/burn the fence —
+ * so a failure is invisible to the v2 platform (no thrown hook error to
+ * replay). Whichever host we run on, the ONLY prompt recovery for a dropped
+ * close is this in-call retry; without it a single transient 5xx strands the
+ * fence live until the catch-up TTL re-emit (up to EMIT_TTL_MS = 30min),
+ * keeping the chat activity indicator lit that whole window. The retry is
+ * bounded (2 × REQUEST_TIMEOUT_MS) and the call is idempotent, so it stacks
+ * onto neither host's budget in the common (first-attempt-succeeds) case.
  */
-export async function completeSources(ctx, sources, outcome = 'ok') {
+export async function completeSources(ctx, sources, sessionId, outcome = 'ok') {
     // Ledger surface — not gated on reportingEnabled (see claimDispatchSource).
     if (sources.length === 0)
         return true;
@@ -736,7 +776,11 @@ export async function completeSources(ctx, sources, outcome = 'ok') {
         const res = await fetch(url, {
             method: 'POST',
             headers: jsonHeaders(ctx),
-            body: JSON.stringify({ sources, turn_outcome: outcome }),
+            body: JSON.stringify({
+                sources,
+                turn_outcome: outcome,
+                ...(sessionId ? { session_id: sessionId } : {}),
+            }),
             signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
         });
         if (!res.ok)

package/dist/typed-dispatch.d.ts

@@ -13,8 +13,12 @@ import type { ConnectorContext } from '@parel/plugin-sdk';
  * Semantics carried over from the standard runtimes:
  * - Permanently-unusable sources (404/403, deleted comments, no_reply hints,
  *   stale task assignment) resolve to `stale` — the caller acks and drops.
- * - Transient fetch failures resolve to `pending` — the dispatch stays
- *   pending and the reconnect catch-up sweep retries it.
+ * - Transient fetch failures THROW (the pipeline's transient-vs-deliberate
+ *   contract, see inbound.ts): the dispatch stays pending, the live frame
+ *   path catches at its boundary, and the catch-up job counts the row as
+ *   starving and re-arms with backoff instead of ending around it.
+ * - Unknown FUTURE event types resolve to `pending` deliberately — real work
+ *   a newer connector will handle; the catch-up job ends cleanly over them.
  * - schedule.fire tolerates 404 by contract (post-fire PATCH on target_ids /
  *   attached_to_uri legitimately revokes access to a delivered run snapshot;
  *   docs/primitives/schedule.md § Snapshot 不变性) — warn + ack + drop.
@@ -69,14 +73,16 @@ export type TypedDispatchResult = TypedEventPlan
  | {
     outcome: 'stale';
 }
-/** Transient failure — leave pending for the catch-up sweep. */
+/** Deliberately pending (unknown future type) — left for a newer
+ * connector; transient failures THROW instead of returning this. */
  | {
     outcome: 'pending';
 };
 /**
- * Build the plan for one typed dispatch. Never throws: any unexpected error
- * degrades to `pending` (same posture as the message path — the sweep
- * retries, and a poisoned row eventually surfaces as a stuck pending count).
+ * Build the plan for one typed dispatch. Throws on transient failures
+ * (including unexpected handler errors — a poisoned row surfaces as catch-up
+ * backoff rescans instead of a silently stuck pending count); returns
+ * `pending` only for deliberately-left work (unknown future event types).
  */
 export declare function planTypedDispatch(data: TypedDispatchData, ctx: ConnectorContext): Promise<TypedDispatchResult>;
 //# sourceMappingURL=typed-dispatch.d.ts.map

package/dist/typed-dispatch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typed-dispatch.d.ts","sourceRoot":"","sources":["../src/typed-dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAI1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,kIAQpB,CAAC;AAEX,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAChD,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,mBAAmB,GAC3B,cAAc;AAChB,2CAA2C;GACzC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE;AACtB,gEAAgE;GAC9D;IAAE,OAAO,EAAE,SAAS,CAAA;CAAE,CAAC;AAY3B;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,iBAAiB,EACvB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,mBAAmB,CAAC,CAwC9B"}
+{"version":3,"file":"typed-dispatch.d.ts","sourceRoot":"","sources":["../src/typed-dispatch.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAI1D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,MAAM,WAAW,iBAAiB;IAChC,EAAE,CAAC,EAAE,OAAO,CAAC;IACb,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAED,mFAAmF;AACnF,eAAO,MAAM,iBAAiB,kIAQpB,CAAC;AAEX,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,6EAA6E;IAC7E,OAAO,EAAE,MAAM,CAAC;IAChB,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAChD,+BAA+B;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,mBAAmB,GAC3B,cAAc;AAChB,2CAA2C;GACzC;IAAE,OAAO,EAAE,OAAO,CAAA;CAAE;AACtB;oEACoE;GAClE;IAAE,OAAO,EAAE,SAAS,CAAA;CAAE,CAAC;AAiB3B;;;;;GAKG;AACH,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,iBAAiB,EACvB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,mBAAmB,CAAC,CAmC9B"}

package/dist/typed-dispatch.js

@@ -15,6 +15,10 @@ export function isTypedEventType(eventType) {
 }
 const STALE = { outcome: 'stale' };
 const PENDING = { outcome: 'pending' };
+/** Non-gone fetch failure on a source entity: transient by contract. */
+function transientFetchError(what, status) {
+    return new Error(`transient ${what} fetch failure (${status})`);
+}
 function sanitizeMeta(value) {
     return value
         .replace(/[\r\n]+/g, ' ')
@@ -22,56 +26,51 @@ function sanitizeMeta(value) {
         .trim();
 }
 /**
- * Build the plan for one typed dispatch. Never throws: any unexpected error
- * degrades to `pending` (same posture as the message path — the sweep
- * retries, and a poisoned row eventually surfaces as a stuck pending count).
+ * Build the plan for one typed dispatch. Throws on transient failures
+ * (including unexpected handler errors — a poisoned row surfaces as catch-up
+ * backoff rescans instead of a silently stuck pending count); returns
+ * `pending` only for deliberately-left work (unknown future event types).
  */
 export async function planTypedDispatch(data, ctx) {
     const eventType = String(data.event_type ?? '');
     const sourceId = data.source_id ? String(data.source_id) : '';
-    try {
-        switch (eventType) {
-            case 'task_assign':
-            case 'task_update': {
-                const taskId = data.task_id ? String(data.task_id) : sourceId;
-                if (!taskId)
-                    return STALE;
-                return await planTask(ctx, taskId, eventType, actorId(data));
-            }
-            case 'task_comment': {
-                const taskId = data.task_id ? String(data.task_id) : '';
-                if (!sourceId || !taskId)
-                    return STALE;
-                return await planTaskComment(ctx, sourceId, taskId, actorId(data), deliveryReason(data));
-            }
-            case 'wiki_comment': {
-                if (!sourceId)
-                    return STALE;
-                return await planWikiComment(ctx, sourceId, actorId(data), deliveryReason(data));
-            }
-            case 'schedule.fire': {
-                if (!sourceId)
-                    return STALE;
-                return await planScheduleFire(ctx, sourceId);
-            }
-            case 'external_trigger': {
-                if (!sourceId)
-                    return STALE;
-                return await planExternalTrigger(ctx, sourceId);
-            }
-            case 'approval_decided': {
-                if (!sourceId)
-                    return STALE;
-                const chatId = data.chat_id ? String(data.chat_id) : undefined;
-                return await planApprovalDecided(ctx, sourceId, chatId, actorId(data));
-            }
-            default:
-                return PENDING; // unknown typed event — future work, never ack-drop
+    switch (eventType) {
+        case 'task_assign':
+        case 'task_update': {
+            const taskId = data.task_id ? String(data.task_id) : sourceId;
+            if (!taskId)
+                return STALE;
+            return await planTask(ctx, taskId, eventType, actorId(data));
         }
-    }
-    catch (err) {
-        console.error(`[parel-channel] typed dispatch ${eventType} failed`, err);
-        return PENDING;
+        case 'task_comment': {
+            const taskId = data.task_id ? String(data.task_id) : '';
+            if (!sourceId || !taskId)
+                return STALE;
+            return await planTaskComment(ctx, sourceId, taskId, actorId(data), deliveryReason(data));
+        }
+        case 'wiki_comment': {
+            if (!sourceId)
+                return STALE;
+            return await planWikiComment(ctx, sourceId, actorId(data), deliveryReason(data));
+        }
+        case 'schedule.fire': {
+            if (!sourceId)
+                return STALE;
+            return await planScheduleFire(ctx, sourceId);
+        }
+        case 'external_trigger': {
+            if (!sourceId)
+                return STALE;
+            return await planExternalTrigger(ctx, sourceId);
+        }
+        case 'approval_decided': {
+            if (!sourceId)
+                return STALE;
+            const chatId = data.chat_id ? String(data.chat_id) : undefined;
+            return await planApprovalDecided(ctx, sourceId, chatId, actorId(data));
+        }
+        default:
+            return PENDING; // unknown typed event — future work, never ack-drop
     }
 }
 function actorId(data) {
@@ -92,8 +91,11 @@ function goneStatus(status) {
 }
 async function planTask(ctx, taskId, eventType, actor) {
     const res = await orgGet(ctx, `/tasks/${taskId}`);
-    if (!res.ok)
-        return goneStatus(res.status) ? STALE : PENDING;
+    if (!res.ok) {
+        if (goneStatus(res.status))
+            return STALE;
+        throw transientFetchError('task', res.status);
+    }
     const task = (await res.json().catch(() => null));
     if (!task?.id)
         return STALE;
@@ -153,8 +155,11 @@ function taskActionHint(taskId) {
 }
 async function fetchComment(ctx, commentId) {
     const res = await orgGet(ctx, `/comments/${commentId}`);
-    if (!res.ok)
-        return goneStatus(res.status) ? STALE : PENDING;
+    if (!res.ok) {
+        if (goneStatus(res.status))
+            return STALE;
+        throw transientFetchError('comment', res.status);
+    }
     const comment = (await res.json().catch(() => null));
     if (!comment?.id)
         return STALE;
@@ -243,7 +248,9 @@ async function planScheduleFire(ctx, runId) {
             console.warn(`[parel-channel] schedule run ${runId} not accessible (404), dropping`);
             return STALE;
         }
-        return goneStatus(res.status) ? STALE : PENDING;
+        if (goneStatus(res.status))
+            return STALE;
+        throw transientFetchError('schedule run', res.status);
     }
     const run = (await res.json().catch(() => null));
     if (!run?.id || !run.schedule_id)
@@ -273,7 +280,9 @@ async function planExternalTrigger(ctx, runId) {
             console.warn(`[parel-channel] external trigger run ${runId} not accessible (404), dropping`);
             return STALE;
         }
-        return goneStatus(res.status) ? STALE : PENDING;
+        if (goneStatus(res.status))
+            return STALE;
+        throw transientFetchError('external trigger run', res.status);
     }
     const run = (await res.json().catch(() => null));
     if (!run?.id || !run.trigger_id)
@@ -318,8 +327,11 @@ async function planApprovalDecided(ctx, approvalId, chatId, actor) {
         headers: { Authorization: `Bearer ${requireAgk(ctx)}` },
         signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
     });
-    if (!res.ok)
-        return goneStatus(res.status) ? STALE : PENDING;
+    if (!res.ok) {
+        if (goneStatus(res.status))
+            return STALE;
+        throw transientFetchError('approval', res.status);
+    }
     const approval = (await res.json().catch(() => null));
     if (!approval?.id)
         return STALE;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@parall/parel-channel",
-  "version": "1.51.0",
+  "version": "1.52.0",
   "description": "Parall channel plugin for the parel runtime — lets a parel agent treat Parall as a managed_ws channel (receive dispatches, reply via the Parall API)",
   "license": "MIT",
   "repository": {