@sema-agent/core 7.6.2 → 7.6.3

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 7.6.3 — 2026-09-08
+
+Maintenance patch on the 7.6.x line: one correction to 7.6.2's forwarding drain.
+
+### Fixed
+- **forwardSubagentEvents drain gate** — 7.6.2 gated the drain inside an `async` helper and awaited it unconditionally, so a run that did NOT opt in still yielded one extra microtask before its terminal push (the black-box round measured parent `done` at hop 356 vs 355 on 7.6.1). The gate is now a synchronous predicate at both terminal pushes and the helper is a plain Promise factory; the non-forwarding terminal depth is pinned (ratchet 58, the unconditional-await form reds it at 59). No change for opted-in runs.
+
 ## 7.6.2 — 2026-09-08
 
 Backport patch on the 7.6.x line (two field bugs the server 7.64.0 chain found; no store-contract change — that is 7.7.0).

package/dist/core/runner/prepare-run-refs.d.ts

@@ -97,5 +97,9 @@ export interface PrepareRunRefsResult {
  * the smallest boundary that strictly orders after all pending microtasks; it is taken only on the opted-in run,
  * only once, right before `done`.
  */
-export declare function drainForwardedFramesBeforeDone(spec: Pick<TaskSpec, "forwardSubagentEvents">): Promise<void>;
+export declare function forwardsSubagentEvents(spec: Pick<TaskSpec, "forwardSubagentEvents">): boolean;
+/** The drain itself — one macrotask turn. Callers gate it with {@link forwardsSubagentEvents} SYNCHRONOUSLY so a
+ *  non-forwarding run's terminal push is not one microtask later than it was (an `await` of an early-returning
+ *  async function still yields once; the black-box round measured that tick). */
+export declare function drainForwardedFramesBeforeDone(): Promise<void>;
 export declare function prepareRunRefs(input: PrepareRunRefsInput): PrepareRunRefsResult;

package/dist/core/runner/prepare-run-refs.js

@@ -2,10 +2,11 @@ import { createSubagentWorktreeHelper } from "../../agents/subagent.js";
 import { SubagentRetainLedger } from "../../agents/retain-ledger.js";
 import { ActiveSkillScope } from "./active-skill-scope.js";
 import { createEditedFilesLedger } from "./edited-files-ledger.js";
-export async function drainForwardedFramesBeforeDone(spec) {
-    if (spec.forwardSubagentEvents !== true)
-        return;
-    await new Promise((resolve) => setImmediate(resolve));
+export function forwardsSubagentEvents(spec) {
+    return spec.forwardSubagentEvents === true;
+}
+export function drainForwardedFramesBeforeDone() {
+    return new Promise((resolve) => setImmediate(resolve));
 }
 export function prepareRunRefs(input) {
     const { spec, internals, executionEnv, taskRootFinal } = input;

package/dist/core/runner/runtask.js

@@ -39,7 +39,7 @@ import { amendTerminal, terminalProjection } from "./terminal-projection.js";
 import { ATTACHMENT_BYTE_CAP, CHANGED_FILES_MAX, TOTAL_TOKENS_REMINDER_DEFAULT_MODE, AGENT_LISTING_REMOVED_HEADER, SKILLS_LISTING_DELTA_HEADER, SKILLS_LISTING_REMOVED_HEADER, advanceCadenceClock, agentListingDeltaHeader, attachmentEnvelopeTags, agentListingInitialHeader, replayAnnouncedListing, replayAnnouncedModels, clipToBytes, collectDateChange, collectDueAttachments, collectInstructionsChange, commitAgentListing, commitInstructionsChange, commitSkillsListing, createAttachmentState, rebaseCadenceWindows, reduceToolEnd, renderAgentListingDelta, renderMcpDroppedTools, renderMcpInstructionsDelta, renderOrphanedBackgroundTasks, selectMcpDroppedBatch, renderSkillsListingDelta, renderToolsDelta, stampWriteAnchor } from "./turn-attachments.js";
 import { buildWorkingFileAttachments, centerAdoptionOption, contextInstructionFilesOption, emitInputTruncated, forkContextOption } from "./compaction-call-options.js";
 import { effectiveDelegationFacts, prepareTask } from "./prepare-task.js";
-import { drainForwardedFramesBeforeDone } from "./prepare-run-refs.js";
+import { drainForwardedFramesBeforeDone, forwardsSubagentEvents } from "./prepare-run-refs.js";
 import { gatedCallIdOf } from "./park-commit.js";
 import { placementValueOrAbsent } from "./checkpoint-scope.js";
 import { SessionReadFileStates } from "./prepare-hands-readface.js";
@@ -1838,7 +1838,8 @@ export class Runner {
                     onError: (f) => console.warn(`[sema-core] ${f.site}: delegation-lifecycle observer threw (contained; further failures counted, not re-disclosed): ${f.error.message}`),
                 }), "runtask.onDelegationLifecycle");
             }
-            await drainForwardedFramesBeforeDone(spec);
+            if (forwardsSubagentEvents(spec))
+                await drainForwardedFramesBeforeDone();
             queue.push({ type: "done", result: resultValue });
             queue.close();
         });
@@ -4278,7 +4279,8 @@ export class Runner {
                 drainManualCompact("mooted");
             }
             manualCompactRef.emitMooted = undefined;
-            await drainForwardedFramesBeforeDone(spec);
+            if (forwardsSubagentEvents(spec))
+                await drainForwardedFramesBeforeDone();
             queue.push({ type: "done", result });
             queue.close();
             await prepared.fileHistoryBoundary?.settle();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sema-agent/core",
-  "version": "7.6.2",
+  "version": "7.6.3",
   "description": "Stateless, task-oriented AI agent core",
   "type": "module",
   "license": "BUSL-1.1",