@parall/parel-channel 1.41.0 → 1.42.0

package/dist/channel-prompt.d.ts

@@ -5,9 +5,10 @@
  * chat shares the agent's ONE parel session, so consecutive turns can come
  * from different conversations — each message is framed with its originating
  * chat so the model registers the context switch instead of answering chat B
- * with chat A's thread of thought. No reply hint: the turn-end reply is
- * auto-delivered to the right chat by replyRoute (deliver()), and sandbox CLI
- * calls get the right PRLL_CHAT_ID via per-turn invocation context.
+ * with chat A's thread of thought. No per-message reply hint: the system
+ * prompt teaches the CLI-only reply contract once (SSOT — plain text is
+ * never delivered; reply via `parall messages send`), and per-turn
+ * invocation context presets PRLL_CHAT_ID so the bare send hits this chat.
  *
  * External IM channel messages (buildChannelPrompt, channel_message
  * dispatches). Mirrors agent-core's event-format.ts channel branch, adapted

package/dist/channel-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"channel-prompt.d.ts","sourceRoot":"","sources":["../src/channel-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AASH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAClC;AAmBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAU5D;AAED,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAkBlE"}
+{"version":3,"file":"channel-prompt.d.ts","sourceRoot":"","sources":["../src/channel-prompt.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AASH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,qEAAqE;IACrE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,IAAI,EAAE,MAAM,CAAC;IACb,iFAAiF;IACjF,WAAW,CAAC,EAAE,gBAAgB,EAAE,CAAC;CAClC;AAmBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAU5D;AAED,MAAM,WAAW,iBAAiB;IAChC,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,UAAU,EAAE,MAAM,CAAC;IACnB,iDAAiD;IACjD,IAAI,EAAE,MAAM,CAAC;CACd;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,iBAAiB,GAAG,MAAM,CAkBlE"}

package/dist/channel-prompt.js

@@ -5,9 +5,10 @@
  * chat shares the agent's ONE parel session, so consecutive turns can come
  * from different conversations — each message is framed with its originating
  * chat so the model registers the context switch instead of answering chat B
- * with chat A's thread of thought. No reply hint: the turn-end reply is
- * auto-delivered to the right chat by replyRoute (deliver()), and sandbox CLI
- * calls get the right PRLL_CHAT_ID via per-turn invocation context.
+ * with chat A's thread of thought. No per-message reply hint: the system
+ * prompt teaches the CLI-only reply contract once (SSOT — plain text is
+ * never delivered; reply via `parall messages send`), and per-turn
+ * invocation context presets PRLL_CHAT_ID so the bare send hits this chat.
  *
  * External IM channel messages (buildChannelPrompt, channel_message
  * dispatches). Mirrors agent-core's event-format.ts channel branch, adapted

package/dist/delivery.d.ts

@@ -1,24 +1,31 @@
 import type { ChannelDelivery, ConnectorContext, ConnectorEffect } from '@parel/plugin-sdk';
 /**
- * Post the agent's reply back to the Parall chat. The chat id rides the
- * replyRoute.data set in inbound.ts.
+ * Turn-end delivery — which, under the platform reply contract, delivers
+ * NOTHING to the chat.
  *
- * Contract (confirmed against parel #104): provider_http reply routes are
- * auto-delivered at turn end via this hook; `payload` is the plain reply text
- * string and `replyRoute` is the one captured from the originating envelope.
+ * The runtime-standard output contract (agent-dm-loop-prevention.md Layer 0,
+ * parel-reply-contract-alignment.md): plain turn output is never projected as
+ * a chat message — the agent replies explicitly via `parall messages send`
+ * from its sandbox, and that send carries the dispatch_source ledger binding.
+ * This hook records the turn-end text as a suppressed audit step on the
+ * session (the same posture the claude-agent / openclaw bridges enforce),
+ * runs a fence-checked ledger close, and a redundant session idle; nothing
+ * else.
  *
- * The reply POST is awaited (not returned as a host fetch effect) so the
- * session link resolution and failure handling stay in one place; a
- * retryable failure falls back to the host effect (at-least-once, idempotent
- * by delivery id + message idempotency_key). The turn's PRIMARY done signal
- * lives in onAgentEvent (turn_completed); the idle here is a deliberate
- * redundant close for bindings without `observe: [turn]` — see the inline
- * comment at the bottom.
+ * parel still auto-invokes deliver() at turn end for provider_http reply
+ * routes (C4) — ignoring the payload here is the connector's half of the
+ * contract; no parel-side change is needed.
  *
- * External IM turns (channel_message dispatches) route here too but deliver
- * NOTHING: their replyRoute carries a conversationId and no chatId, and the
- * agent replies through the provider clip itself — this hook only runs the
- * same redundant session idle for them.
+ * A fork-owned turn (replyRoute carries childRef) records its audit step on
+ * the CHILD's ase_ and idles IT — its session panel owns the turn, not
+ * main's. A stale childRef (fork purged by New Session / given up on) drops
+ * the text entirely: blind-recreating a fork ase_ under the new conversation
+ * line would resurrect pre-reset state.
+ *
+ * External IM turns (channel_message dispatches) route here too with a
+ * conversationId and no chatId: their reply goes out through the provider
+ * clip, agent-invoked, and their turn-end text was already deliberately
+ * undelivered — only the ledger close + redundant idle run for them.
  */
 export declare function buildParallDelivery(delivery: ChannelDelivery, ctx: ConnectorContext): Promise<ConnectorEffect[]>;
 //# sourceMappingURL=delivery.d.ts.map

package/dist/delivery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../src/delivery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAa5F;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,eAAe,EACzB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC,CAqH5B"}
+{"version":3,"file":"delivery.d.ts","sourceRoot":"","sources":["../src/delivery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAa5F;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAsB,mBAAmB,CACvC,QAAQ,EAAE,eAAe,EACzB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC,CAgF5B"}

package/dist/delivery.js

@@ -1,134 +1,103 @@
-import { parallApiUrl, parallOrgId, requireAgk } from './connect.js';
 import { childRefKnown } from './fork.js';
-import { ensureChildSession, ensureSession, invalidateChildSession, invalidateSession, patchSession, REQUEST_TIMEOUT_MS, TURN_ENVELOPE_KEY, } from './session.js';
+import { completeFencedEnvelopes, createSuppressedTextStep, ensureChildSession, ensureSession, invalidateChildSession, invalidateSession, patchSession, TURN_ENVELOPE_KEY, } from './session.js';
 /**
- * Post the agent's reply back to the Parall chat. The chat id rides the
- * replyRoute.data set in inbound.ts.
+ * Turn-end delivery — which, under the platform reply contract, delivers
+ * NOTHING to the chat.
  *
- * Contract (confirmed against parel #104): provider_http reply routes are
- * auto-delivered at turn end via this hook; `payload` is the plain reply text
- * string and `replyRoute` is the one captured from the originating envelope.
+ * The runtime-standard output contract (agent-dm-loop-prevention.md Layer 0,
+ * parel-reply-contract-alignment.md): plain turn output is never projected as
+ * a chat message — the agent replies explicitly via `parall messages send`
+ * from its sandbox, and that send carries the dispatch_source ledger binding.
+ * This hook records the turn-end text as a suppressed audit step on the
+ * session (the same posture the claude-agent / openclaw bridges enforce),
+ * runs a fence-checked ledger close, and a redundant session idle; nothing
+ * else.
  *
- * The reply POST is awaited (not returned as a host fetch effect) so the
- * session link resolution and failure handling stay in one place; a
- * retryable failure falls back to the host effect (at-least-once, idempotent
- * by delivery id + message idempotency_key). The turn's PRIMARY done signal
- * lives in onAgentEvent (turn_completed); the idle here is a deliberate
- * redundant close for bindings without `observe: [turn]` — see the inline
- * comment at the bottom.
+ * parel still auto-invokes deliver() at turn end for provider_http reply
+ * routes (C4) — ignoring the payload here is the connector's half of the
+ * contract; no parel-side change is needed.
  *
- * External IM turns (channel_message dispatches) route here too but deliver
- * NOTHING: their replyRoute carries a conversationId and no chatId, and the
- * agent replies through the provider clip itself — this hook only runs the
- * same redundant session idle for them.
+ * A fork-owned turn (replyRoute carries childRef) records its audit step on
+ * the CHILD's ase_ and idles IT — its session panel owns the turn, not
+ * main's. A stale childRef (fork purged by New Session / given up on) drops
+ * the text entirely: blind-recreating a fork ase_ under the new conversation
+ * line would resurrect pre-reset state.
+ *
+ * External IM turns (channel_message dispatches) route here too with a
+ * conversationId and no chatId: their reply goes out through the provider
+ * clip, agent-invoked, and their turn-end text was already deliberately
+ * undelivered — only the ledger close + redundant idle run for them.
  */
 export async function buildParallDelivery(delivery, ctx) {
-    const apiUrl = parallApiUrl(ctx);
-    const agk = requireAgk(ctx);
-    const orgId = parallOrgId(ctx);
     const route = (delivery.replyRoute?.data ?? {});
-    const chatId = route.chatId;
-    if (!chatId) {
-        // No delivery target: external IM turns (channel_message — the reply
-        // already went out through the provider clip, agent-invoked) and typed
-        // dispatch turns (task/schedule/trigger/wiki — the agent acts via its
-        // sandbox CLI). The turn-end text is deliberately NOT delivered anywhere
-        // (same contract as agent-core: plain output is not the reply). Only run
-        // the redundant idle so a binding without `observe: [turn]` still closes
-        // the session.
-        if (route.envelopeId) {
-            const sessionId = await ensureSession(ctx, { timeoutMs: 3_000 });
-            if (sessionId) {
-                await idleUnlessSuperseded(ctx, route.envelopeId, sessionId);
-            }
-        }
-        return [];
-    }
-    const payload = delivery.payload;
-    const text = typeof payload === 'string' ? payload : (payload?.text ?? '');
-    if (!text)
-        return [];
-    // Short timeout: this sits in front of the user-visible reply POST. Cache
-    // hit (every dispatch after the agent's first) is a store read; on a slow
-    // miss we degrade to a reply without the session link rather than delay it.
-    // A fork-owned envelope (replyRoute carries childRef) links to the CHILD's
-    // ase_ — its session panel owns this turn, not main's. Same short timeout
-    // as the main path: this sits in front of the user-visible reply POST, so
-    // a slow resolve degrades to a reply without the session link, never a
-    // 10s-delayed message.
+    // A fork-owned envelope whose bookkeeping is gone is a late/stale delivery
+    // (post-reset or post-give-up) — drop it entirely, audit step included.
     const childLive = route.childRef ? await childRefKnown(ctx, route.childRef) : false;
     if (route.childRef && !childLive) {
-        // Terminal stale-child delivery: the fork was purged (New Session) or
-        // given up on (black hole → the opening already re-planned onto main).
-        // Posting would land pre-reset output in the fresh conversation line, or
-        // duplicate a reply main already produced — drop it entirely (no POST,
-        // no retry effect).
-        console.warn('[parel-channel] dropping reply from stale fork', route.childRef);
+        console.warn('[parel-channel] dropping turn-end text from stale fork', route.childRef);
         return [];
     }
-    const sessionId = route.childRef
-        ? await ensureChildSession(ctx, route.childRef, { timeoutMs: 3_000 })
-        : await ensureSession(ctx, { timeoutMs: 3_000 });
-    const request = {
-        url: `${apiUrl}/api/v1/orgs/${orgId}/chats/${chatId}/messages`,
-        method: 'POST',
-        headers: {
-            Authorization: `Bearer ${agk}`,
-            'Content-Type': 'application/json',
-        },
-        // message_type must be explicit: the server persists it verbatim, and
-        // a blank type skips text normalization (prll:// refs, mentions) and
-        // renders as an unknown-type fallback on clients. agent_session_id links
-        // the reply bubble to its session panel (server validates ownership).
-        // idempotency_key dedupes the ambiguous-failure case where the direct
-        // POST committed but its response was lost and the host retry re-sends —
-        // same body on both paths, so the server collapses them to one message.
-        body: JSON.stringify({
-            message_type: 'text',
-            content: { text },
-            idempotency_key: `parel-reply:${delivery.id}`,
-            // A reply to a thread message stays in that thread.
-            ...(route.threadRootId ? { thread_root_id: route.threadRootId } : {}),
-            ...(sessionId ? { agent_session_id: sessionId } : {}),
-        }),
-    };
-    try {
-        const res = await fetch(request.url, {
-            method: request.method,
-            headers: request.headers,
-            body: request.body,
-            signal: AbortSignal.timeout(REQUEST_TIMEOUT_MS),
-        });
-        if (!res.ok) {
-            // 4xx (bar 429) is permanent — retrying an unprocessable reply burns
-            // requests forever. Drop it (logged); turn_completed still closes the
-            // turn's indicator.
-            const permanent = res.status >= 400 && res.status < 500 && res.status !== 429;
-            if (!permanent)
-                throw new Error(`reply post failed (${res.status})`);
-            console.error(`[parel-channel] reply rejected (${res.status}) — dropping`);
+    if (route.chatId) {
+        const payload = delivery.payload;
+        const text = typeof payload === 'string' ? payload : (payload?.text ?? '');
+        if (text) {
+            // Audit-only: the session panel shows what the model produced, the
+            // chat never does. Short timeout — this hook sits at turn end, nothing
+            // user-visible waits on it. Fork turns land the step on the child ase_.
+            const sessionId = route.childRef
+                ? await ensureChildSession(ctx, route.childRef, { timeoutMs: 3_000 })
+                : await ensureSession(ctx, { timeoutMs: 3_000 });
+            if (sessionId) {
+                const result = await createSuppressedTextStep(ctx, sessionId, {
+                    subject: route.chatId,
+                    deliveryId: delivery.id,
+                    text,
+                });
+                if (result === 'stale') {
+                    if (route.childRef)
+                        await invalidateChildSession(ctx, route.childRef);
+                    else
+                        await invalidateSession(ctx);
+                }
+            }
         }
     }
-    catch (err) {
-        console.error('[parel-channel] direct reply failed; falling back to host retry', err);
-        return [{ type: 'fetch', request, idempotencyKey: `reply:${delivery.id}` }];
+    // Redundant turn-end ledger close, fence-checked — the deliver-side twin of
+    // onAgentEvent's complete. Exists for bindings WITHOUT `observe: [turn]`
+    // (the npm ^1 fallback path): there turn events never arrive and, with
+    // ack-on-emit gone, this hook is the only terminal ledger path — without it
+    // a delivered turn's row would stay live and re-emit on every TTL sweep.
+    // Under the normal artifact path both hooks run; the fence makes the
+    // overlap free (whichever completes first consumes it, the other skips).
+    // Fork-handled envelopes never wrote a fence, so this is a no-op for them
+    // (their ack machinery owns the ledger there).
+    // Known bound of this fallback: the replyRoute snapshot carries ONE
+    // envelope id, so a folded turn's OTHER sources heal only via the TTL
+    // re-emit here. Reaching that state needs a binding with injectInFlight
+    // ON and observe OFF — the platform template always sets both together,
+    // so it exists only on a hand-crafted binding.
+    if (route.envelopeId) {
+        await completeFencedEnvelopes(ctx, [route.envelopeId]);
     }
-    // Redundant done signal, kept deliberately: turn_completed (onAgentEvent)
-    // is the primary close for every turn — including no-reply turns this hook
-    // never sees — but a binding deployed without `observe: [turn]` that still
-    // resolves this connector (npm ^1 fallback path; the artifact path freezes
-    // connector+config atomically) would otherwise never idle. Both signals
-    // run the same turnEnvelope staleness guard and idle is idempotent, so the
-    // overlap is harmless. Child turns skip the guard entirely — the marker is
-    // main's; a child's own turn ending always idles the child ase_.
-    if (sessionId) {
-        if (route.childRef) {
-            const result = await patchSession(ctx, sessionId, { status: 'idle' });
-            if (result === 'stale')
-                await invalidateChildSession(ctx, route.childRef);
-        }
-        else {
-            await idleUnlessSuperseded(ctx, route.envelopeId, sessionId);
+    const subject = route.chatId ?? route.conversationId;
+    if (subject) {
+        // Redundant done signal, kept deliberately: turn_completed (onAgentEvent)
+        // is the primary close for every turn — including no-reply turns — but a
+        // binding deployed without `observe: [turn]` would otherwise never idle.
+        // Child turns skip the marker guard entirely — the marker is main's; a
+        // child's own turn ending always idles the child ase_.
+        const sessionId = route.childRef
+            ? await ensureChildSession(ctx, route.childRef, { timeoutMs: 3_000 })
+            : await ensureSession(ctx, { timeoutMs: 3_000 });
+        if (sessionId) {
+            if (route.childRef) {
+                const result = await patchSession(ctx, sessionId, { status: 'idle' });
+                if (result === 'stale')
+                    await invalidateChildSession(ctx, route.childRef);
+            }
+            else {
+                await idleUnlessSuperseded(ctx, route.envelopeId, sessionId);
+            }
         }
     }
     return [];

package/dist/fork.d.ts

@@ -135,11 +135,14 @@ export declare function handleChildSpawnFailed(ctx: ConnectorContext, event: Chi
  * equivalent; the platform already excludes in-flight output from the seed,
  * this line keeps the child from "finishing" main's visible work).
  *
- * The opening turn has no envelope (it starts from the spawn input), so its
- * turn-end text is NOT auto-delivered anywhere (parel §18.3: outward replies
- * from a child are the agent's own job) — the prefix therefore spells out
- * the CLI reply command for THIS message; follow-ups arrive as deliverTo
- * envelopes whose replies auto-deliver like any chat message.
+ * Replies are CLI-only on EVERY fork turn (the platform reply contract —
+ * nothing auto-delivers, parel-reply-contract-alignment.md). The opening
+ * turn additionally has no envelope (it starts from the spawn input), so it
+ * gets no per-turn invocation context either — the prefix therefore spells
+ * out the full CLI reply command with the explicit chat target; follow-ups
+ * arrive as deliverTo envelopes whose invocation context presets
+ * PRLL_CHAT_ID, so the system prompt's bare `parall messages send` teaching
+ * covers them.
  */
 export declare function buildForkScopePrefix(subject: string, threadRootId?: string): string;
 //# sourceMappingURL=fork.d.ts.map

package/dist/fork.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"fork.d.ts","sourceRoot":"","sources":["../src/fork.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"fork.d.ts","sourceRoot":"","sources":["../src/fork.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAC1D,OAAO,KAAK,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AA+CxF,4EAA4E;AAC5E,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAS1C,eAAO,MAAM,iBAAiB,eAAe,CAAC;AAW9C,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,MAAM,CAAC;IACX;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;;;;;OAQG;IACH,WAAW,CAAC,EAAE,UAAU,EAAE,CAAC;IAC3B,gFAAgF;IAChF,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;2CAEuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE;AAClB;oEACoE;GAClE;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GAC1D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAMxC;;;;;;;;;GASG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,YAAY,CAAC,CAwCvB;AAED;;sEAEsE;AACtE,wBAAsB,WAAW,CAC/B,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,UAAU,GAClB,OAAO,CAAC,IAAI,CAAC,CAQf;AAED;;;;;GAKG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,UAAU,GACd,OAAO,CAAC,OAAO,CAAC,CASlB;AAED;;;+EAG+E;AAC/E,wBAAsB,aAAa,CAAC,GAAG,EAAE,gBAAgB,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO7F;AAED,0EAA0E;AAC1E,wBAAsB,cAAc,CAClC,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,OAAO,CAAC,CAGlB;AAED,8EAA8E;AAC9E,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CAMf;AAED;;;GAGG;AACH,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED,iEAAiE;AACjE,eAAO,MAAM,yBAAyB,IAAI,CAAC;AAE3C;;;;;;;GAOG;AACH,wBAAsB,cAAc,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAoB7E;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC,IAAI,CAAC,CAcf;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,mBAAmB,GACzB,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,UAAU,EAAE,CAAA;CAAE,GAAG,IAAI,CAAC,CA+BhE;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,gBAAgB,EACrB,KAAK,EAAE,qBAAqB,GAC3B,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,UAAU,EAAE,CAAA;CAAE,CAAC,CA2B3E;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,MAAM,CAYnF"}

package/dist/fork.js

@@ -301,11 +301,14 @@ export async function handleChildSpawnFailed(ctx, event) {
  * equivalent; the platform already excludes in-flight output from the seed,
  * this line keeps the child from "finishing" main's visible work).
  *
- * The opening turn has no envelope (it starts from the spawn input), so its
- * turn-end text is NOT auto-delivered anywhere (parel §18.3: outward replies
- * from a child are the agent's own job) — the prefix therefore spells out
- * the CLI reply command for THIS message; follow-ups arrive as deliverTo
- * envelopes whose replies auto-deliver like any chat message.
+ * Replies are CLI-only on EVERY fork turn (the platform reply contract —
+ * nothing auto-delivers, parel-reply-contract-alignment.md). The opening
+ * turn additionally has no envelope (it starts from the spawn input), so it
+ * gets no per-turn invocation context either — the prefix therefore spells
+ * out the full CLI reply command with the explicit chat target; follow-ups
+ * arrive as deliverTo envelopes whose invocation context presets
+ * PRLL_CHAT_ID, so the system prompt's bare `parall messages send` teaching
+ * covers them.
  */
 export function buildForkScopePrefix(subject, threadRootId) {
     // Quoted-heredoc input form (mirrors agent-core's send hint): plain
@@ -316,5 +319,5 @@ export function buildForkScopePrefix(subject, threadRootId) {
         : `parall messages send ${subject} --text-file - <<'EOF'`;
     return (`[Fork scope: you are a parallel branch of your main session, handling ONE conversation (${subject}) only. ` +
         `Act only on this conversation's request. Do not continue, complete, or produce output for other work visible in your inherited history — the main session owns it.]\n` +
-        `<system-reminder>Reply to THIS message with your sandbox CLI: \`${send}\` … \`EOF\` — the quoted heredoc keeps \`$\`, backticks and apostrophes literal. For this opening message your plain text output is NOT auto-delivered; later messages in this conversation deliver replies automatically.</system-reminder>\n\n`);
+        `<system-reminder>Reply to THIS message with your sandbox CLI: \`${send}\` … \`EOF\` — the quoted heredoc keeps \`$\`, backticks and apostrophes literal. Your plain text output is NOT delivered anywhere — on this and every later message in this conversation, reply via \`parall messages send\`.</system-reminder>\n\n`);
 }

package/dist/inbound-channel.d.ts

@@ -25,5 +25,5 @@ export declare const PROVIDER_LOOKUP_TIMEOUT_MS = 3000;
  * permanently unusable → ack-and-drop; a transient failure keeps the
  * dispatch pending for the catch-up sweep.
  */
-export declare function effectsForChannelDispatch(sourceId: string, dispatchId: string, ctx: ConnectorContext): Promise<ConnectorEffect[]>;
+export declare function effectsForChannelDispatch(sourceId: string, ctx: ConnectorContext): Promise<ConnectorEffect[]>;
 //# sourceMappingURL=inbound-channel.d.ts.map

package/dist/inbound-channel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inbound-channel.d.ts","sourceRoot":"","sources":["../src/inbound-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAc3E;;;;GAIG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC,CAuJ5B"}
+{"version":3,"file":"inbound-channel.d.ts","sourceRoot":"","sources":["../src/inbound-channel.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAiB3E;;;;GAIG;AAEH;;;;;GAKG;AACH,eAAO,MAAM,0BAA0B,OAAQ,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC,CA6J5B"}

package/dist/inbound-channel.js

@@ -1,6 +1,6 @@
 import { buildChannelPrompt } from './channel-prompt.js';
 import { parallApiUrl, parallOrgId, requireAgk } from './connect.js';
-import { ackEffect, createChannelInputStep, ensureSession, invalidateSession, markDispatchReceived, patchSession, REQUEST_TIMEOUT_MS, TURN_ENVELOPE_KEY, } from './session.js';
+import { ackEffect, createChannelInputStep, ensureSession, invalidateSession, markDispatchReceived, nextEnvelopeId, patchSession, readActiveEmit, REQUEST_TIMEOUT_MS, TURN_ENVELOPE_KEY, writeActiveEmit, } from './session.js';
 /**
  * External IM inbound (channel_message dispatches — Feishu/Slack via the
  * platform-mediated channel, external-im-channel-design.md). Split from
@@ -27,7 +27,7 @@ export const PROVIDER_LOOKUP_TIMEOUT_MS = 3_000;
  * permanently unusable → ack-and-drop; a transient failure keeps the
  * dispatch pending for the catch-up sweep.
  */
-export async function effectsForChannelDispatch(sourceId, dispatchId, ctx) {
+export async function effectsForChannelDispatch(sourceId, ctx) {
     const apiUrl = parallApiUrl(ctx);
     const orgId = parallOrgId(ctx);
     const authHeaders = { Authorization: `Bearer ${requireAgk(ctx)}` };
@@ -75,10 +75,12 @@ export async function effectsForChannelDispatch(sourceId, dispatchId, ctx) {
         : undefined;
     const externalMessageId = msg?.external_message_id ? String(msg.external_message_id) : undefined;
     // Progress reporting — identical ordering contract to the message path
-    // (see the comments there): received settles before the ack effect is
-    // returned; the turnEnvelope marker goes down before any session write.
+    // (see the comments there): received settles before this function returns;
+    // the turnEnvelope marker goes down before any session write; the row
+    // stays 'received' until the turn event's complete-sources.
     const receivedSettled = markDispatchReceived(ctx, 'channel_message', sourceId);
-    const envelopeId = dispatchId || `channel_message:${sourceId}`;
+    const priorEmit = await readActiveEmit(ctx, 'channel_message', sourceId);
+    const envelopeId = nextEnvelopeId('channel_message', sourceId, priorEmit);
     let sessionId = await ensureSession(ctx);
     if (sessionId) {
         await ctx.store?.set(TURN_ENVELOPE_KEY, envelopeId).catch(() => { });
@@ -113,6 +115,7 @@ export async function effectsForChannelDispatch(sourceId, dispatchId, ctx) {
         void recordConversationSession(ctx, conversationId, sessionId).catch(() => { });
     }
     await receivedSettled;
+    await writeActiveEmit(ctx, 'channel_message', sourceId, envelopeId);
     return [
         {
             type: 'emitEvent',
@@ -154,10 +157,13 @@ export async function effectsForChannelDispatch(sourceId, dispatchId, ctx) {
                 },
                 // No invocation context: PRLL_CHAT_ID must not point CLI defaults at
                 // a chat that doesn't exist, and the reply targets (external ids)
-                // already ride the prompt verbatim.
+                // already ride the prompt verbatim. (So no PRLL_DISPATCH_SOURCE_*
+                // either — the external reply goes out through the provider clip,
+                // and this row's ledger close is the turn event's complete-sources.)
             },
         },
-        ackEffect(ctx, 'channel_message', sourceId),
+        // No ack effect — see the message path (inbound.ts): the row stays
+        // received until complete-sources closes it.
     ];
 }
 /**

package/dist/inbound.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inbound.d.ts","sourceRoot":"","sources":["../src/inbound.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACf,MAAM,mBAAmB,CAAC;AAwG3B;kDACkD;AAClD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CASjE;AACD,wBAAgB,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAO9D;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,cAAc,EACrB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC,CAG5B;AAwCD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,EACtB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC,CAE5B;AA8BD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAE/E;AAgmBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAE7B"}
+{"version":3,"file":"inbound.d.ts","sourceRoot":"","sources":["../src/inbound.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACf,MAAM,mBAAmB,CAAC;AAuH3B;kDACkD;AAClD,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,gBAAgB,GAAG,IAAI,CASjE;AACD,wBAAgB,UAAU,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAO9D;AAED,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,cAAc,EACrB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC,CAG5B;AAwCD;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE;IAAE,GAAG,EAAE,MAAM,CAAA;CAAE,EACtB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,eAAe,EAAE,CAAC,CAE5B;AA8BD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAE/E;AAwpBD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,UAAU,EACjB,GAAG,EAAE,gBAAgB,GACpB,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAE7B"}