@sema-agent/core 7.42.1 → 7.44.0

package/dist/orchestration/workflow.js

@@ -1056,9 +1056,10 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
         const parks = run.parks ?? (run.parks = []);
         const at = parks.findIndex((e) => e.callKey === rec.callKey);
         const held = at === -1 ? undefined : parks[at];
+        const holder = { parkedBy: runId, generation: held?.generation ?? 0 };
         const key = held !== undefined && held.token === paused.terminal.token && held.originUnconfirmed !== true
-            ? { callKey: rec.callKey, sessionId: paused.sessionId, token: paused.terminal.token, originRunId: held.originRunId }
-            : { callKey: rec.callKey, sessionId: paused.sessionId, token: paused.terminal.token, originRunId: runId, originUnconfirmed: true };
+            ? { callKey: rec.callKey, sessionId: paused.sessionId, token: paused.terminal.token, originRunId: held.originRunId, ...holder }
+            : { callKey: rec.callKey, sessionId: paused.sessionId, token: paused.terminal.token, originRunId: runId, originUnconfirmed: true, ...holder };
         if (at === -1)
             parks.push(key);
         else
@@ -2263,19 +2264,23 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
                         throw parksUnreadable("its journal yielded no entry to derive one from");
                     const candidates = new Map();
                     const keyed = (k) => k.token !== "" && k.sessionId !== "";
+                    const clash = (a, b) => a !== "" && b !== "" && a !== b;
                     const offerCandidate = (ord, key) => {
                         const recorded = candidates.get(ord);
-                        if (recorded !== undefined && (recorded.callKey !== key.callKey || (keyed(recorded) && keyed(key) && (recorded.token !== key.token || recorded.sessionId !== key.sessionId))))
+                        if (recorded !== undefined && (recorded.callKey !== key.callKey || clash(recorded.token, key.token) || clash(recorded.sessionId, key.sessionId)))
                             throw parkBindingBroken(ord, "the prior run's key caches name different tokens, sessions or calls for it");
-                        if (recorded === undefined || (!keyed(recorded) && keyed(key)))
+                        if (recorded === undefined)
                             candidates.set(ord, key);
+                        else if (!keyed(recorded) && keyed(key))
+                            candidates.set(ord, recorded.parkedBy === undefined ? key : { ...key, parkedBy: recorded.parkedBy, generation: recorded.generation });
                     };
                     for (const raw of recordParks ?? []) {
                         const e = raw;
-                        if (e === null || typeof e !== "object" || typeof e.callKey !== "string" || typeof e.sessionId !== "string" || typeof e.token !== "string" || typeof e.originRunId !== "string" || !/^\d+:/.test(e.callKey)) {
+                        const holder = e === null || typeof e !== "object" ? undefined : e.parkedBy === undefined && e.generation === undefined ? {} : typeof e.parkedBy === "string" && e.parkedBy !== "" && Number.isSafeInteger(e.generation) && e.generation >= 0 ? { parkedBy: e.parkedBy, generation: e.generation } : undefined;
+                        if (e === null || typeof e !== "object" || holder === undefined || typeof e.callKey !== "string" || typeof e.sessionId !== "string" || typeof e.token !== "string" || typeof e.originRunId !== "string" || !/^\d+:/.test(e.callKey)) {
                             throw parkBindingBroken(-1, "a recorded park entry is malformed or its call key has no ordinal");
                         }
-                        offerCandidate(callKeyOrdinal(e.callKey), { callKey: e.callKey, sessionId: e.sessionId, token: e.token, originRunId: e.originRunId, ...(e.originUnconfirmed === true ? { originUnconfirmed: true } : {}) });
+                        offerCandidate(callKeyOrdinal(e.callKey), { callKey: e.callKey, sessionId: e.sessionId, token: e.token, originRunId: e.originRunId, ...(e.originUnconfirmed === true ? { originUnconfirmed: true } : {}), ...holder });
                     }
                     for (const [ord, e] of replayByOrdinal.entries()) {
                         if (e?.parked === undefined)
@@ -2320,6 +2325,9 @@ export function startWorkflow(runner, fn, opts = {}, internals) {
                         }
                     }
                     if (!finalized) {
+                        for (const key of inherited)
+                            if (key.generation !== undefined)
+                                key.generation += 1;
                         run.parks = inherited;
                         delete run.resumeAdmissionIncomplete;
                     }

package/package.json

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

package/test/export-surface.snapshot.json

@@ -1,7 +1,7 @@
 {
   "_comment": "design/87 L3 — frozen public export surface of src/index.ts (name -> kind). DO NOT edit by hand to silence a red test. A removed/changed entry = a SemVer-BREAKING change; bump MAJOR and update this fixture in the SAME commit (design/87 §4.2 / §5.2). Regenerate via REGEN in test/export-surface.test.ts.",
   "_tierComment": "#435 v1 — machine-readable layering of the public surface: stable = demonstrated by README.md / src/examples; internal = an `Internal`-marked name or a runner/engine deep-subtree declaration (the model seam src/engine/llm is excluded — it is the BYOM contract, not an engine internal); advanced = a supported export the front door does not walk you through. THIS IS AN INITIAL HEURISTIC, derived mechanically and expected to be refined ticket by ticket: no human reviewed these 1700+ entries one by one, and nothing here claims otherwise. Known bias: a short or English-word export name (ok, err, Result, Usage) can match ordinary prose in README.md and land `stable` on a coincidence. Every export MUST carry a tier — a new export with no row fails the gate in export-surface.test.ts.",
-  "count": 2593,
+  "count": 2601,
   "exports": {
     "A2ATaskState": "type",
     "A2ATaskStateReversal": "type",
@@ -24,6 +24,7 @@
     "ALLOW_RULE_MEMBERS": "variable",
     "ANNOUNCEMENTS_FILE": "variable",
     "APPROVAL_CARD_REQUIRED_KEYS": "variable",
+    "APPROVAL_REACH": "variable",
     "APPROVER_ATTRIBUTION_MAX_CHARS": "variable",
     "ARTIFACT_ACTIONS": "variable",
     "ARTIFACT_ACTION_CONCURRENCY_SAFE": "variable",
@@ -100,6 +101,7 @@
     "AllowRuleShadow": "interface",
     "AnthropicBrainConfig": "interface",
     "AppendLog": "class",
+    "ApprovalReach": "type",
     "ApprovalSeatOutcome": "type",
     "Arbitration": "type",
     "ArtifactAction": "type",
@@ -210,6 +212,7 @@
     "BeforeWriteHook": "type",
     "BeforeWriteRequest": "interface",
     "BeforeWriteResult": "type",
+    "BoundSkillGrants": "interface",
     "Brain": "interface",
     "BrainError": "class",
     "BrainErrorCode": "type",
@@ -962,6 +965,7 @@
     "PROMPT_BLOCK_CAUSES": "variable",
     "PROTOCOL_TABLE": "variable",
     "PROVIDER_ECHO_SHAPE": "variable",
+    "PROXY_TUNNEL_REFUSED": "variable",
     "PackSectionDeclaration": "interface",
     "ParentSpecSeat": "interface",
     "ParentSpecSeatFields": "type",
@@ -1351,6 +1355,7 @@
     "STALE_RUNNING_REAP_ATTRIBUTION": "variable",
     "STARTER_RULES": "variable",
     "STATIC_VERIFICATION_PROMPT": "variable",
+    "STEER_REPLAY_FACETS": "variable",
     "STUB_ARCHIVED_LINE": "variable",
     "SUBAGENT_PROMPT": "variable",
     "SUBAGENT_SYSTEM_NOTE": "variable",
@@ -1477,6 +1482,7 @@
     "StaticWiringDeps": "type",
     "StaticWiringSpec": "type",
     "StdioLspTransport": "class",
+    "SteerReplayFacet": "type",
     "StopFailureContext": "interface",
     "StopReason": "type",
     "StopSource": "type",
@@ -1649,7 +1655,7 @@
     "UNCOVERED_SEGMENT_REASON_BASELINE": "variable",
     "URL_SAFETY": "variable",
     "USAGE_WINDOW_REAP_MARGIN_MS": "variable",
-    "USER_STEER_UNDRAINED_CAUSES": "variable",
+    "USER_INPUT_UNDRAINED_CAUSES": "variable",
     "UnarmedDenialLimitFallback": "interface",
     "UncoveredSegmentDetail": "interface",
     "UnifiedTaskOutput": "interface",
@@ -1662,10 +1668,10 @@
     "UsageWindowReading": "interface",
     "UsageWindowRecord": "interface",
     "UsageWindowStore": "interface",
+    "UserInputUndrainedCause": "type",
     "UserMessage": "interface",
     "UserPromptSubmitContext": "interface",
     "UserPromptSubmitResult": "interface",
-    "UserSteerUndrainedCause": "type",
     "UtilityGate": "type",
     "V2HeaderHints": "interface",
     "VERIFICATION_PROMPT": "variable",
@@ -1767,6 +1773,7 @@
     "WriteProtectionViewAbsence": "interface",
     "WriteReceipt": "interface",
     "XARGS_READ_ONLY_TARGETS": "variable",
+    "abortedSeatDeny": "function",
     "ackAdoptionConfig": "function",
     "acquireCcLock": "function",
     "addDotsOf": "function",
@@ -2123,6 +2130,7 @@
     "inspectDegenerate": "function",
     "isAbsoluteForFamily": "function",
     "isAliasModelId": "function",
+    "isApprovalReach": "function",
     "isAskClass": "function",
     "isAskOrigin": "function",
     "isAutoModeClassifierFallback": "function",
@@ -2619,6 +2627,7 @@
     "ALLOW_RULE_MEMBERS": "advanced",
     "ANNOUNCEMENTS_FILE": "advanced",
     "APPROVAL_CARD_REQUIRED_KEYS": "internal",
+    "APPROVAL_REACH": "advanced",
     "APPROVER_ATTRIBUTION_MAX_CHARS": "advanced",
     "ARTIFACT_ACTIONS": "advanced",
     "ARTIFACT_ACTION_CONCURRENCY_SAFE": "advanced",
@@ -2695,6 +2704,7 @@
     "AllowRuleShadow": "advanced",
     "AnthropicBrainConfig": "advanced",
     "AppendLog": "advanced",
+    "ApprovalReach": "advanced",
     "ApprovalSeatOutcome": "advanced",
     "Arbitration": "advanced",
     "ArtifactAction": "advanced",
@@ -2805,6 +2815,7 @@
     "BeforeWriteHook": "stable",
     "BeforeWriteRequest": "advanced",
     "BeforeWriteResult": "advanced",
+    "BoundSkillGrants": "advanced",
     "Brain": "stable",
     "BrainError": "advanced",
     "BrainErrorCode": "advanced",
@@ -3557,6 +3568,7 @@
     "PROMPT_BLOCK_CAUSES": "advanced",
     "PROTOCOL_TABLE": "advanced",
     "PROVIDER_ECHO_SHAPE": "advanced",
+    "PROXY_TUNNEL_REFUSED": "advanced",
     "PackSectionDeclaration": "advanced",
     "ParentSpecSeat": "advanced",
     "ParentSpecSeatFields": "advanced",
@@ -3946,6 +3958,7 @@
     "STALE_RUNNING_REAP_ATTRIBUTION": "advanced",
     "STARTER_RULES": "advanced",
     "STATIC_VERIFICATION_PROMPT": "advanced",
+    "STEER_REPLAY_FACETS": "advanced",
     "STUB_ARCHIVED_LINE": "advanced",
     "SUBAGENT_PROMPT": "advanced",
     "SUBAGENT_SYSTEM_NOTE": "advanced",
@@ -4072,6 +4085,7 @@
     "StaticWiringDeps": "advanced",
     "StaticWiringSpec": "advanced",
     "StdioLspTransport": "internal",
+    "SteerReplayFacet": "advanced",
     "StopFailureContext": "advanced",
     "StopReason": "advanced",
     "StopSource": "advanced",
@@ -4244,7 +4258,7 @@
     "UNCOVERED_SEGMENT_REASON_BASELINE": "advanced",
     "URL_SAFETY": "advanced",
     "USAGE_WINDOW_REAP_MARGIN_MS": "internal",
-    "USER_STEER_UNDRAINED_CAUSES": "advanced",
+    "USER_INPUT_UNDRAINED_CAUSES": "advanced",
     "UnarmedDenialLimitFallback": "advanced",
     "UncoveredSegmentDetail": "advanced",
     "UnifiedTaskOutput": "advanced",
@@ -4257,10 +4271,10 @@
     "UsageWindowReading": "advanced",
     "UsageWindowRecord": "advanced",
     "UsageWindowStore": "advanced",
+    "UserInputUndrainedCause": "advanced",
     "UserMessage": "advanced",
     "UserPromptSubmitContext": "advanced",
     "UserPromptSubmitResult": "advanced",
-    "UserSteerUndrainedCause": "advanced",
     "UtilityGate": "advanced",
     "V2HeaderHints": "advanced",
     "VERIFICATION_PROMPT": "advanced",
@@ -4362,6 +4376,7 @@
     "WriteProtectionViewAbsence": "advanced",
     "WriteReceipt": "internal",
     "XARGS_READ_ONLY_TARGETS": "advanced",
+    "abortedSeatDeny": "advanced",
     "ackAdoptionConfig": "advanced",
     "acquireCcLock": "advanced",
     "addDotsOf": "advanced",
@@ -4718,6 +4733,7 @@
     "inspectDegenerate": "advanced",
     "isAbsoluteForFamily": "advanced",
     "isAliasModelId": "advanced",
+    "isApprovalReach": "advanced",
     "isAskClass": "advanced",
     "isAskOrigin": "advanced",
     "isAutoModeClassifierFallback": "advanced",