@stigmer/runner 3.12.2 → 3.12.4

package/dist/.build-fingerprint

@@ -1 +1 @@
-{"hash":"c5b58ddebabf1fc9","builtAt":"2026-08-13T18:01:33.891Z","fileCount":293}
+{"hash":"30fa0c9a11a788e3","builtAt":"2026-08-14T07:34:03.879Z","fileCount":297}

package/dist/activities/call-http.js

@@ -72,11 +72,23 @@ export async function callHttpAction(config, runtimeEnv) {
     if (resolved.redirect === "false" || resolved.redirect === false) {
         fetchOptions.redirect = "manual";
     }
+    // Honor the author's timeout_seconds (#686). Non-retryable by design:
+    // the workflow author declared the budget, so a breach is a task failure
+    // they can catch with try/catch — Temporal re-running the same slow call
+    // up to 5 times would multiply the wait without changing the outcome.
+    const timeoutMs = resolved.timeout_seconds ? resolved.timeout_seconds * 1000 : undefined;
+    if (timeoutMs !== undefined) {
+        fetchOptions.signal = AbortSignal.timeout(timeoutMs);
+    }
     let response;
     try {
         response = await fetch(uri, fetchOptions);
     }
     catch (err) {
+        if (timeoutMs !== undefined && err instanceof Error &&
+            (err.name === "TimeoutError" || err.name === "AbortError")) {
+            throw ApplicationFailure.nonRetryable(`HTTP ${method} ${uri} timed out after ${resolved.timeout_seconds}s (task timeout_seconds)`, "HTTP_CALL_TIMEOUT", { timeoutSeconds: resolved.timeout_seconds });
+        }
         throw new Error(`HTTP ${method} ${uri} failed: ${err instanceof Error ? err.message : String(err)}`);
     }
     const statusCode = response.status;

package/dist/activities/call-http.js.map

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

package/dist/activities/call-llm.d.ts

@@ -23,7 +23,25 @@ export interface LlmCallConfig {
     readonly response_schema?: Record<string, unknown>;
     readonly temperature?: number;
     readonly max_tokens?: number;
+    /**
+     * Author-declared call budget in seconds (proto: LlmCallTaskConfig.timeout,
+     * 1-600). Bounds the provider request via buildChatModel's timeout seam;
+     * a breach fails non-retryably with LLM_TIMEOUT (#686). The engine widens
+     * the activity's startToClose to fit values above the default 5m.
+     */
     readonly timeout?: number;
+    /**
+     * Schema-validation policy (proto: LlmCallTaskConfig.on_invalid). The
+     * retry/fallback ORCHESTRATION lives in the workflow engine
+     * (call-function.ts, mirroring call-agent.ts); this activity only reads
+     * it to pick the failure channel: soft policies get a `parse_error`
+     * result the engine can act on, the default throws LLM_SCHEMA_VALIDATION.
+     */
+    readonly on_invalid?: string;
+    /** Engine-owned (see on_invalid); accepted here so config passes through. */
+    readonly max_retries?: number;
+    /** Engine-owned (see on_invalid); accepted here so config passes through. */
+    readonly fallback_task?: string;
 }
 export interface LlmCallResult {
     readonly input_tokens: number;

package/dist/activities/call-llm.js

@@ -23,6 +23,7 @@ import { inferProvider, stripProviderPrefix, } from "../shared/llm-proxy.js";
 import { computeLlmCostMicros, ensureLoaded as ensurePricingLoaded } from "../shared/model-pricing.js";
 import { resolveToApiModelId } from "../shared/model-registry.js";
 import { buildChatModel } from "../shared/model-client.js";
+import { getRunnerSecret } from "../shared/runner-credential-store.js";
 import { checkDirectCredentials } from "../shared/llm-backend.js";
 import { classifyModelCallError } from "../shared/model-error.js";
 /**
@@ -92,6 +93,18 @@ function classifyAndThrowLlmError(err, modelId, provider, proxyMode) {
     const providerLabel = provider === "anthropic" ? "Anthropic" : "OpenAI";
     throw ApplicationFailure.nonRetryable(`LLM call failed for model "${modelId}" (${providerLabel}): ${rawMessage}`, "LLM_UNKNOWN_ERROR");
 }
+/**
+ * Matches the request-timeout errors the provider SDKs raise when
+ * buildChatModel's timeout bound fires (OpenAI: APIConnectionTimeoutError
+ * "Request timed out."; Anthropic mirrors the shape). Only consulted when
+ * the task declared an explicit `timeout`, so the loose message match
+ * cannot reclassify errors on unbudgeted calls.
+ */
+function isRequestTimeoutError(err) {
+    if (!(err instanceof Error))
+        return false;
+    return err.name === "APIConnectionTimeoutError" || /timed?\s*out/i.test(err.message);
+}
 export async function callLlmAction(config, runtimeEnv, executionId) {
     if (!config.model) {
         throw new Error("LLM call requires 'model' in config");
@@ -105,7 +118,10 @@ export async function callLlmAction(config, runtimeEnv, executionId) {
     const callStart = Date.now();
     await ensurePricingLoaded().catch(() => { });
     const proxyEndpoint = process.env.STIGMER_PROXY_ENDPOINT;
-    const stigmerToken = process.env.STIGMER_TOKEN;
+    // Per-call store read: rotation (manager updateToken / static renewal)
+    // must be visible to in-flight workers, exactly like the env read it
+    // replaced (#508).
+    const stigmerToken = getRunnerSecret("STIGMER_TOKEN");
     const proxyActive = !!(proxyEndpoint && stigmerToken);
     console.log(`[call-llm] model=${modelId} provider=${provider} proxy=${proxyActive} ` +
         `structured=${!!config.response_schema} execution=${executionId}`);
@@ -123,6 +139,12 @@ export async function callLlmAction(config, runtimeEnv, executionId) {
     // Anthropic requires an explicit maxTokens; preserve the 4096 default here
     // (buildChatModel intentionally imposes none). resolvedModel is already an
     // API id, so buildChatModel's resolve step is a no-op for it.
+    //
+    // maxRetries: 0 — Temporal owns retries for this activity (callProxy
+    // retries up to 5x). LangChain's default retry loop underneath would
+    // multiply that, and it also blind-retries schema-validation failures:
+    // before this was pinned to 0, one non-conforming structured response
+    // burned ~7 identical model calls before surfacing (#686).
     const { model } = await buildChatModel({
         modelName: resolvedModel,
         proxyEndpoint: proxyActive ? proxyEndpoint : undefined,
@@ -130,12 +152,22 @@ export async function callLlmAction(config, runtimeEnv, executionId) {
         headerScope: { workflowExecutionId: executionId },
         temperature: config.temperature,
         maxTokens: provider === "anthropic" ? (config.max_tokens ?? 4096) : config.max_tokens,
+        // The author's per-call budget rides the same seam as the operator's
+        // STIGMER_LLM_REQUEST_TIMEOUT_MS (#468); an explicit value wins there.
+        timeoutMs: config.timeout ? config.timeout * 1000 : undefined,
+        maxRetries: 0,
     });
     const messages = [];
     if (config.system_prompt) {
         messages.push(new SystemMessage(config.system_prompt));
     }
     messages.push(new HumanMessage(config.prompt));
+    // Soft schema-failure channel: when the engine will orchestrate
+    // ON_INVALID_RETRY / ON_INVALID_FALLBACK, a validation miss is a signal
+    // (parse_error result), not a failure — the engine re-prompts or
+    // branches. ON_INVALID_FAIL (and unset) keeps the throwing contract.
+    const softSchemaFailure = config.on_invalid === "ON_INVALID_RETRY" ||
+        config.on_invalid === "ON_INVALID_FALLBACK";
     let result;
     try {
         if (config.response_schema) {
@@ -163,7 +195,29 @@ export async function callLlmAction(config, runtimeEnv, executionId) {
         }
     }
     catch (err) {
-        classifyAndThrowLlmError(err, modelId, provider, proxyActive);
+        if (softSchemaFailure && err instanceof z.ZodError) {
+            // Usage is unrecoverable here — the structured runnable throws
+            // before exposing the raw response (same loss as the throwing path).
+            result = {
+                input_tokens: 0,
+                output_tokens: 0,
+                result: undefined,
+                model: modelId,
+                provider,
+                parse_error: err.errors
+                    .map((e) => `${e.path.join(".")}: ${e.message}`)
+                    .join("; "),
+            };
+        }
+        else if (config.timeout && isRequestTimeoutError(err)) {
+            // The author declared this budget in the task config; breaching it is
+            // a task failure they can catch, not a transient to retry — Temporal
+            // re-running the same over-budget call 5x would multiply the wait.
+            throw ApplicationFailure.nonRetryable(`LLM call for model "${modelId}" timed out after ${config.timeout}s (task timeout)`, "LLM_TIMEOUT", { timeoutSeconds: config.timeout });
+        }
+        else {
+            classifyAndThrowLlmError(err, modelId, provider, proxyActive);
+        }
     }
     const costMicros = computeLlmCostMicros(config.model, result.input_tokens, result.output_tokens);
     const enrichedResult = costMicros > 0

package/dist/activities/call-llm.js.map

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

package/dist/activities/execute-cursor/agent-session-cache.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Session-keyed Cursor agent cache — keeps the SDK executor (and its stdio
+ * MCP server processes) alive across turns of the SAME session (#215).
+ *
+ * Why this exists: the SDK's local executor cache is refcounted and keyed
+ * by the full acquisition config (workingDirectory, hashed apiKey,
+ * settingSources, mcpServers, customSubagents). `agent.close()` releases
+ * the agent's lease; at refcount zero the executor is DISPOSED and every
+ * stdio MCP server is killed. The activity used to close on every terminal
+ * path, so each turn re-acquired the executor and re-spawned every MCP
+ * server inside `agent.send()` — a measured 2.2–3.2s per-turn tax
+ * (`turn_first_event`'s `send_returned` segment).
+ *
+ * Ownership model — exclusive checkout, explicit lifetime:
+ * - A finishing turn PARKS its healthy agent here (`cacheSessionAgent`);
+ *   the next activity for the session CHECKS IT OUT (`takeCachedAgent`),
+ *   removing it from the cache, so two concurrent activities can never
+ *   share one Agent handle — the loser of the race resolves its own.
+ * - The cached agent is reused only when the acquisition FINGERPRINT
+ *   matches. Any config drift (rotated credential, edited MCP servers,
+ *   model change, different workspace) closes the parked agent and forces
+ *   a fresh resolve — correctness by construction: a reused executor would
+ *   otherwise keep serving the OLD config.
+ * - Failure paths never park: a suspect agent is closed where it failed
+ *   (the pre-existing close sites), and `evictSessionAgent` clears any
+ *   parked entry when a session's state is replaced out from under it.
+ * - Idle TTL + LRU cap bound memory on multi-session hosts (the desktop
+ *   runner-manager hosts many sessions per process; a cloud sandbox is
+ *   session-pinned and holds at most one entry). Worker shutdown closes
+ *   everything (`closeAllCachedAgents`).
+ */
+/** The slice of SDKAgent this cache needs — close() releases the executor lease. */
+export interface CacheableAgent {
+    readonly agentId: string;
+    close(): void;
+}
+/**
+ * Fingerprint of everything that determines whether a parked agent can
+ * serve the next turn as-is: the SDK executor cache key inputs PLUS the
+ * per-agent options resume() re-supplies (model selection, sub-agents).
+ * The API key contributes only as a hash — the fingerprint must never be
+ * a secret-bearing value (it appears in no logs, but defense in depth).
+ */
+export declare function computeAgentFingerprint(createOptions: Record<string, unknown>): string;
+/**
+ * Exclusive checkout: returns the parked agent for the session and removes
+ * it from the cache, or undefined when there is nothing reusable.
+ *
+ * A parked agent is reusable only when BOTH hold:
+ * - `fingerprint` matches (config identical to what the agent was built with);
+ * - `expectedAgentId`, when non-empty, matches the parked agent (the
+ *   session's harnessStateId is the source of truth — a recovery in another
+ *   activity may have replaced the agent since this one was parked).
+ *
+ * A mismatch on either closes the parked agent: it can never serve this
+ * session again, and holding it would only pin dead MCP processes.
+ */
+export declare function takeCachedAgent(sessionId: string, fingerprint: string, expectedAgentId: string): CacheableAgent | undefined;
+/**
+ * Parks a healthy agent for the session's next turn. Replaces (and closes)
+ * any agent already parked for the session; evicts the oldest entry when
+ * the cap is reached.
+ */
+export declare function cacheSessionAgent(sessionId: string, agent: CacheableAgent, fingerprint: string): void;
+/** Closes and forgets the parked agent for a session, if any. */
+export declare function evictSessionAgent(sessionId: string): void;
+/** Worker shutdown: release every parked lease so executors dispose cleanly. */
+export declare function closeAllCachedAgents(): void;
+/** Test seam. */
+export declare function _resetAgentSessionCacheForTests(): void;
+/** Test seam. */
+export declare function _parkedAgentCountForTests(): number;

package/dist/activities/execute-cursor/agent-session-cache.js

@@ -0,0 +1,186 @@
+/**
+ * Session-keyed Cursor agent cache — keeps the SDK executor (and its stdio
+ * MCP server processes) alive across turns of the SAME session (#215).
+ *
+ * Why this exists: the SDK's local executor cache is refcounted and keyed
+ * by the full acquisition config (workingDirectory, hashed apiKey,
+ * settingSources, mcpServers, customSubagents). `agent.close()` releases
+ * the agent's lease; at refcount zero the executor is DISPOSED and every
+ * stdio MCP server is killed. The activity used to close on every terminal
+ * path, so each turn re-acquired the executor and re-spawned every MCP
+ * server inside `agent.send()` — a measured 2.2–3.2s per-turn tax
+ * (`turn_first_event`'s `send_returned` segment).
+ *
+ * Ownership model — exclusive checkout, explicit lifetime:
+ * - A finishing turn PARKS its healthy agent here (`cacheSessionAgent`);
+ *   the next activity for the session CHECKS IT OUT (`takeCachedAgent`),
+ *   removing it from the cache, so two concurrent activities can never
+ *   share one Agent handle — the loser of the race resolves its own.
+ * - The cached agent is reused only when the acquisition FINGERPRINT
+ *   matches. Any config drift (rotated credential, edited MCP servers,
+ *   model change, different workspace) closes the parked agent and forces
+ *   a fresh resolve — correctness by construction: a reused executor would
+ *   otherwise keep serving the OLD config.
+ * - Failure paths never park: a suspect agent is closed where it failed
+ *   (the pre-existing close sites), and `evictSessionAgent` clears any
+ *   parked entry when a session's state is replaced out from under it.
+ * - Idle TTL + LRU cap bound memory on multi-session hosts (the desktop
+ *   runner-manager hosts many sessions per process; a cloud sandbox is
+ *   session-pinned and holds at most one entry). Worker shutdown closes
+ *   everything (`closeAllCachedAgents`).
+ */
+import { createHash } from "node:crypto";
+/**
+ * Default idle lifetime for a parked agent. Long enough to cover human
+ * think-time between turns and approval round-trips; short enough that an
+ * abandoned session does not pin MCP subprocesses for hours.
+ */
+const DEFAULT_IDLE_TTL_MS = 30 * 60 * 1000;
+/**
+ * Ceiling on concurrently parked agents (each holds an executor + its MCP
+ * subprocesses). Cloud sandboxes never approach it (one session per pod);
+ * it protects long-lived desktop runner-managers.
+ */
+const MAX_PARKED_AGENTS = 32;
+function resolveIdleTtlMs() {
+    const parsed = Number.parseInt(process.env.STIGMER_CURSOR_AGENT_CACHE_TTL_MS ?? "", 10);
+    return parsed > 0 ? parsed : DEFAULT_IDLE_TTL_MS;
+}
+const parkedAgents = new Map();
+function closeQuietly(agent) {
+    try {
+        agent.close();
+    }
+    catch {
+        /* best effort — the lease release is advisory on an already-dead agent */
+    }
+}
+/**
+ * Fingerprint of everything that determines whether a parked agent can
+ * serve the next turn as-is: the SDK executor cache key inputs PLUS the
+ * per-agent options resume() re-supplies (model selection, sub-agents).
+ * The API key contributes only as a hash — the fingerprint must never be
+ * a secret-bearing value (it appears in no logs, but defense in depth).
+ */
+export function computeAgentFingerprint(createOptions) {
+    const { apiKey, ...rest } = createOptions;
+    const material = {
+        ...rest,
+        apiKeyHash: typeof apiKey === "string" && apiKey.length > 0
+            ? createHash("sha256").update(apiKey).digest("hex")
+            : undefined,
+    };
+    return createHash("sha256").update(stableStringify(material)).digest("hex");
+}
+/** Deterministic JSON: object keys sorted recursively (the SDK's own idiom). */
+function stableStringify(value) {
+    return JSON.stringify(sortKeys(value));
+}
+function sortKeys(value) {
+    if (Array.isArray(value))
+        return value.map(sortKeys);
+    if (value !== null && typeof value === "object" && value.constructor === Object) {
+        return Object.fromEntries(Object.keys(value)
+            .sort()
+            .map((k) => [k, sortKeys(value[k])]));
+    }
+    return value;
+}
+/**
+ * Exclusive checkout: returns the parked agent for the session and removes
+ * it from the cache, or undefined when there is nothing reusable.
+ *
+ * A parked agent is reusable only when BOTH hold:
+ * - `fingerprint` matches (config identical to what the agent was built with);
+ * - `expectedAgentId`, when non-empty, matches the parked agent (the
+ *   session's harnessStateId is the source of truth — a recovery in another
+ *   activity may have replaced the agent since this one was parked).
+ *
+ * A mismatch on either closes the parked agent: it can never serve this
+ * session again, and holding it would only pin dead MCP processes.
+ */
+export function takeCachedAgent(sessionId, fingerprint, expectedAgentId) {
+    const entry = parkedAgents.get(sessionId);
+    if (!entry)
+        return undefined;
+    parkedAgents.delete(sessionId);
+    clearTimeout(entry.evictTimer);
+    const agentMatches = expectedAgentId === "" || entry.agent.agentId === expectedAgentId;
+    if (entry.fingerprint !== fingerprint || !agentMatches) {
+        console.log(`agent-session-cache: parked agent for session=${sessionId} not reusable ` +
+            `(fingerprintMatch=${entry.fingerprint === fingerprint}, agentIdMatch=${agentMatches}) — closing`);
+        closeQuietly(entry.agent);
+        return undefined;
+    }
+    return entry.agent;
+}
+/**
+ * Parks a healthy agent for the session's next turn. Replaces (and closes)
+ * any agent already parked for the session; evicts the oldest entry when
+ * the cap is reached.
+ */
+export function cacheSessionAgent(sessionId, agent, fingerprint) {
+    if (!sessionId) {
+        // No stable key to reuse by — release the lease as before the cache.
+        closeQuietly(agent);
+        return;
+    }
+    const displaced = parkedAgents.get(sessionId);
+    if (displaced) {
+        clearTimeout(displaced.evictTimer);
+        closeQuietly(displaced.agent);
+    }
+    if (parkedAgents.size >= MAX_PARKED_AGENTS) {
+        let oldestKey;
+        let oldestAt = Infinity;
+        for (const [key, entry] of parkedAgents) {
+            if (entry.parkedAt < oldestAt) {
+                oldestAt = entry.parkedAt;
+                oldestKey = key;
+            }
+        }
+        if (oldestKey !== undefined)
+            evictSessionAgent(oldestKey);
+    }
+    const ttlMs = resolveIdleTtlMs();
+    const evictTimer = setTimeout(() => evictSessionAgent(sessionId), ttlMs);
+    // Never keep the process alive just to evict an idle agent.
+    evictTimer.unref?.();
+    parkedAgents.set(sessionId, {
+        agent,
+        fingerprint,
+        evictTimer,
+        parkedAt: Date.now(),
+    });
+}
+/** Closes and forgets the parked agent for a session, if any. */
+export function evictSessionAgent(sessionId) {
+    const entry = parkedAgents.get(sessionId);
+    if (!entry)
+        return;
+    parkedAgents.delete(sessionId);
+    clearTimeout(entry.evictTimer);
+    closeQuietly(entry.agent);
+    console.log(`agent-session-cache: evicted parked agent for session=${sessionId}`);
+}
+/** Worker shutdown: release every parked lease so executors dispose cleanly. */
+export function closeAllCachedAgents() {
+    for (const [sessionId, entry] of parkedAgents) {
+        clearTimeout(entry.evictTimer);
+        closeQuietly(entry.agent);
+        console.log(`agent-session-cache: closed parked agent for session=${sessionId} (shutdown)`);
+    }
+    parkedAgents.clear();
+}
+/** Test seam. */
+export function _resetAgentSessionCacheForTests() {
+    for (const entry of parkedAgents.values()) {
+        clearTimeout(entry.evictTimer);
+    }
+    parkedAgents.clear();
+}
+/** Test seam. */
+export function _parkedAgentCountForTests() {
+    return parkedAgents.size;
+}
+//# sourceMappingURL=agent-session-cache.js.map

package/dist/activities/execute-cursor/agent-session-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-session-cache.js","sourceRoot":"","sources":["../../../src/activities/execute-cursor/agent-session-cache.ts"],"names":[],"mappings":"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"}

package/dist/activities/execute-cursor/index.js

@@ -34,6 +34,7 @@ import { ExecutionPhase, FileChangeSetStatus, InteractionMode, MessageType, Appr
 import { StigmerClient } from "../../client/stigmer-client.js";
 import { describeExecutionError } from "../../shared/model-error.js";
 import { resolveAgentWithTransportRecovery } from "./session-lifecycle.js";
+import { cacheSessionAgent, computeAgentFingerprint, takeCachedAgent } from "./agent-session-cache.js";
 import { CursorMode } from "@stigmer/protos/ai/stigmer/agentic/session/v1/enum_pb";
 import { determineCursorMode, isCloudMode } from "./cursor-mode.js";
 import { MessageAccumulator, cancelInProgressSubAgentProtos, collapseRedundantToolCallTwins } from "./message-translator.js";
@@ -91,7 +92,8 @@ import { statusProtoWriter } from "../../shared/execution-status-writer.js";
 import { setInterceptorExecutionId, runWithExecutionContext } from "./fetch-interceptor.js";
 import { closeProxySessions } from "./http2-interceptor.js";
 import { resolveModelId, ensureLoaded as ensurePricingLoaded } from "./model-pricing.js";
-import { resolveEffectiveServiceTier, resolveServiceTierParams } from "./service-tier.js";
+import { resolveEffectiveServiceTier } from "../../shared/service-tier.js";
+import { resolveServiceTierParams } from "./service-tier.js";
 import { UsageAccumulator } from "./usage-accumulator.js";
 import { StreamingUsageSummarySchema } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/usage_pb";
 import { activityStarted, activityFinished } from "../../idle-watchdog.js";
@@ -882,20 +884,47 @@ turnSeq) {
         // is the largest user-visible setup segment; this split keeps its
         // historical meaning — the SDK call was already 98%+ of it).
         setupTiming.mark("prepare_agent");
-        let resolution = await resolveAgentWithTransportRecovery({
-            harnessStateId: threadId,
-            createOptions,
-            mode: agentMode,
-            timeoutMs: config.agentResolveTimeoutMs,
-            buildTimeoutMessage: (finalAttempt) => `Cursor agent ${threadId ? "resume" : "create"} timed out after ${resolveTimeoutSeconds}s ` +
-                `(${config.proxyEndpoint ? `via proxy ${config.proxyEndpoint}` : "direct Cursor API connection"}). ` +
-                `The transport connection is likely dead. ` +
-                (finalAttempt
-                    ? `An automatic retry on a fresh transport connection also timed out. ` +
-                        `Retry the message later; if this persists, check proxy and network health.`
-                    : `Resetting the transport and retrying automatically.`),
-            resetTransport: closeProxySessions,
-        });
+        // Phase 8a: Reuse the previous turn's agent when this session parked one
+        // (#215). A checkout hit skips Agent.resume() AND — the real win — keeps
+        // the SDK executor lease alive, so agent.send() below re-acquires the
+        // warm executor instead of re-spawning every stdio MCP server (the
+        // measured 2.2–3.2s `send_returned` tax). The fingerprint covers the
+        // full acquisition config, so any drift (rotated credential, edited MCP
+        // servers, model change) falls through to a fresh resolve.
+        const agentFingerprint = computeAgentFingerprint(createOptions);
+        const parkedAgent = takeCachedAgent(sessionId, agentFingerprint, threadId ?? "");
+        let resolution;
+        if (parkedAgent) {
+            console.log(`ExecuteCursor reusing parked session agent: execution=${executionId}, ` +
+                `session=${sessionId}, agentId=${parkedAgent.agentId}`);
+            resolution = {
+                agent: parkedAgent,
+                agentId: parkedAgent.agentId,
+                isNew: false,
+                resumed: true,
+                mode: agentMode,
+                // The parked handle IS the live conversation — every consumer of
+                // "resumed_successfully" (prompt selection, poisoned-handle
+                // recovery eligibility) wants exactly those semantics.
+                reason: "resumed_successfully",
+            };
+        }
+        else {
+            resolution = await resolveAgentWithTransportRecovery({
+                harnessStateId: threadId,
+                createOptions,
+                mode: agentMode,
+                timeoutMs: config.agentResolveTimeoutMs,
+                buildTimeoutMessage: (finalAttempt) => `Cursor agent ${threadId ? "resume" : "create"} timed out after ${resolveTimeoutSeconds}s ` +
+                    `(${config.proxyEndpoint ? `via proxy ${config.proxyEndpoint}` : "direct Cursor API connection"}). ` +
+                    `The transport connection is likely dead. ` +
+                    (finalAttempt
+                        ? `An automatic retry on a fresh transport connection also timed out. ` +
+                            `Retry the message later; if this persists, check proxy and network health.`
+                        : `Resetting the transport and retrying automatically.`),
+                resetTransport: closeProxySessions,
+            });
+        }
         console.log(`ExecuteCursor agent resolved: execution=${executionId}, ` +
             `reason=${resolution.reason}, mode=${resolution.mode}, ` +
             `agentId=${resolution.agentId}, resumed=${resolution.resumed}` +
@@ -1234,10 +1263,9 @@ turnSeq) {
                     timestamp: utcTimestamp(),
                 }));
                 await persist(status);
-                try {
-                    resolution.agent.close();
-                }
-                catch { /* best effort */ }
+                // Clean terminal: the conversation continues on the next message,
+                // so park the healthy agent for that turn (#215).
+                cacheSessionAgent(sessionId ?? "", resolution.agent, agentFingerprint);
                 console.warn(`ExecuteCursor terminated (cost cap): execution=${executionId}, ` +
                     `estimatedCostUsd=${estimated.toFixed(4)}, maxCostUsd=${maxCostUsd.toFixed(2)}`);
                 return { kind: "return" };
@@ -1296,10 +1324,8 @@ turnSeq) {
                     timestamp: utcTimestamp(),
                 }));
                 await persist(status);
-                try {
-                    resolution.agent.close();
-                }
-                catch { /* best effort */ }
+                // Clean terminal — park for the session's next turn (#215).
+                cacheSessionAgent(sessionId ?? "", resolution.agent, agentFingerprint);
                 console.log(`ExecuteCursor completed (platform stop): execution=${executionId}`);
                 return { kind: "return" };
             }
@@ -1343,6 +1369,12 @@ turnSeq) {
         const enterApprovalPause = async (boundary) => {
             status.phase = ExecutionPhase.EXECUTION_WAITING_FOR_APPROVAL;
             await persist(status);
+            // The approval-resume reinvocation is the cache's best case: park the
+            // agent so the resumed turn skips the full executor rebuild (#215).
+            // (This path previously dropped the handle without close() — the
+            // lease leaked; parking makes the lifetime explicit.) An absent
+            // sessionId falls back to "" — the cache closes the lease immediately.
+            cacheSessionAgent(sessionId ?? "", resolution.agent, agentFingerprint);
             console.log(`ExecuteCursor returning WAITING_FOR_APPROVAL: ${boundary.deniedToolCallCount} gated tool(s), ` +
                 `${boundary.capturedChangeCount} file card(s) pending`);
             return slimStatus(status);
@@ -1755,11 +1787,12 @@ turnSeq) {
         console.log(`ExecuteCursor completed: execution=${executionId}, phase=${ExecutionPhase[status.phase]}, ` +
             `hasStructuredOutput=${structuredOutput !== undefined}` +
             (status.error ? `, error=${status.error}` : ""));
-        // Release SDK executor lease to prevent cache buildup across workflow tasks
-        try {
-            resolution.agent.close();
-        }
-        catch { /* best effort */ }
+        // Park the agent (with its executor lease) for the session's next turn
+        // instead of closing it — the idle TTL / shutdown hooks in
+        // agent-session-cache own the eventual release, so cache buildup across
+        // sessions stays bounded while turns of ONE session stop paying the
+        // executor + MCP re-spawn tax (#215).
+        cacheSessionAgent(sessionId ?? "", resolution.agent, agentFingerprint);
         const slim = slimStatus(status);
         if (finalText !== undefined) {
             slim.final_text = finalText;