@stigmer/runner 3.12.3 → 3.12.5

package/dist/.build-fingerprint

@@ -1 +1 @@
-{"hash":"8dbf5c2309c2f6b5","builtAt":"2026-08-13T18:40:23.429Z","fileCount":294}
+{"hash":"e77d58b2bc3277e6","builtAt":"2026-08-15T12:57:42.305Z","fileCount":298}

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/cursor-mcp-config.d.ts

@@ -0,0 +1,45 @@
+/**
+ * The Cursor harness's MCP output adapter: maps the shared resolver's
+ * {@link ResolvedMcpServer} servers into the Cursor SDK's mcpServers config
+ * for Agent.create(), plus the harness's env pre-flight check.
+ *
+ * Resolution itself lives in shared/mcp-resolver.ts (oss#387 consolidated the
+ * near-duplicate resolver this file used to carry) — this module is the
+ * symmetric twin of the deep-agent harness's toMcpClientConfig in
+ * shared/mcp-manager.ts: both consume the identical intermediate, only the
+ * final SDK serialization differs.
+ */
+import type { McpServerUsage } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/spec_pb";
+import type { ResolvedMcpServer } from "../../shared/mcp-resolver.js";
+/**
+ * Cursor SDK MCP server config shape (matches @cursor/sdk McpServerConfig).
+ * Defined here to avoid tight coupling to the SDK's internal types.
+ */
+export type CursorMcpServerConfig = {
+    type?: "stdio";
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+} | {
+    type?: "http" | "sse";
+    url: string;
+    headers?: Record<string, string>;
+};
+/**
+ * Transform resolved MCP servers into the Cursor SDK's mcpServers config
+ * for Agent.create().
+ *
+ * Call it ONCE, after the last mutation of the resolved-server list (backfill,
+ * synthesized-attachment injection): the config is a projection of that list,
+ * and building it early just creates a stale copy someone must remember to
+ * rebuild. The Cursor SDK config cannot hide tools, so enabledTools is NOT
+ * expressed here — the HITL hook enforces it (see ResolvedMcpServer.enabledTools).
+ */
+export declare function toCursorMcpConfig(servers: ResolvedMcpServer[]): Record<string, CursorMcpServerConfig>;
+/**
+ * Validate that resolved MCP servers have their required env vars populated.
+ * Returns a list of warnings for servers with empty/missing env.
+ * Used as a pre-flight check before agent.send() to surface config issues early.
+ */
+export declare function validateMcpServerEnv(servers: ResolvedMcpServer[], usages: McpServerUsage[]): string[];

package/dist/activities/execute-cursor/cursor-mcp-config.js

@@ -0,0 +1,76 @@
+/**
+ * The Cursor harness's MCP output adapter: maps the shared resolver's
+ * {@link ResolvedMcpServer} servers into the Cursor SDK's mcpServers config
+ * for Agent.create(), plus the harness's env pre-flight check.
+ *
+ * Resolution itself lives in shared/mcp-resolver.ts (oss#387 consolidated the
+ * near-duplicate resolver this file used to carry) — this module is the
+ * symmetric twin of the deep-agent harness's toMcpClientConfig in
+ * shared/mcp-manager.ts: both consume the identical intermediate, only the
+ * final SDK serialization differs.
+ */
+/**
+ * Transform resolved MCP servers into the Cursor SDK's mcpServers config
+ * for Agent.create().
+ *
+ * Call it ONCE, after the last mutation of the resolved-server list (backfill,
+ * synthesized-attachment injection): the config is a projection of that list,
+ * and building it early just creates a stale copy someone must remember to
+ * rebuild. The Cursor SDK config cannot hide tools, so enabledTools is NOT
+ * expressed here — the HITL hook enforces it (see ResolvedMcpServer.enabledTools).
+ */
+export function toCursorMcpConfig(servers) {
+    const result = {};
+    for (const server of servers) {
+        if (server.connectionType === "stdio") {
+            if (!server.command)
+                continue;
+            result[server.slug] = {
+                type: "stdio",
+                command: server.command,
+                args: server.args,
+                env: server.env,
+                cwd: server.cwd,
+            };
+        }
+        else {
+            if (!server.url)
+                continue;
+            result[server.slug] = {
+                type: server.connectionType,
+                url: server.url,
+                headers: server.headers,
+            };
+        }
+    }
+    return result;
+}
+/**
+ * Validate that resolved MCP servers have their required env vars populated.
+ * Returns a list of warnings for servers with empty/missing env.
+ * Used as a pre-flight check before agent.send() to surface config issues early.
+ */
+export function validateMcpServerEnv(servers, usages) {
+    const warnings = [];
+    for (const usage of usages) {
+        const slug = usage.mcpServerRef?.slug;
+        if (!slug)
+            continue;
+        const resolved = servers.find((s) => s.slug === slug);
+        if (!resolved) {
+            warnings.push(`MCP server '${slug}': failed to resolve (server may not exist or is inaccessible)`);
+            continue;
+        }
+        if (resolved.connectionType === "stdio" && resolved.env) {
+            const emptyKeys = Object.entries(resolved.env)
+                .filter(([, v]) => !v)
+                .map(([k]) => k);
+            if (emptyKeys.length > 0) {
+                warnings.push(`MCP server '${slug}': env vars [${emptyKeys.join(", ")}] are empty — ` +
+                    `server subprocess will likely fail to connect`);
+            }
+        }
+    }
+    return warnings;
+}
+//# sourceMappingURL=cursor-mcp-config.js.map

package/dist/activities/execute-cursor/cursor-mcp-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-mcp-config.js","sourceRoot":"","sources":["../../../src/activities/execute-cursor/cursor-mcp-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAuBH;;;;;;;;;GASG;AACH,MAAM,UAAU,iBAAiB,CAC/B,OAA4B;IAE5B,MAAM,MAAM,GAA0C,EAAE,CAAC;IAEzD,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC7B,IAAI,MAAM,CAAC,cAAc,KAAK,OAAO,EAAE,CAAC;YACtC,IAAI,CAAC,MAAM,CAAC,OAAO;gBAAE,SAAS;YAC9B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG;gBACpB,IAAI,EAAE,OAAO;gBACb,OAAO,EAAE,MAAM,CAAC,OAAO;gBACvB,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,GAAG,EAAE,MAAM,CAAC,GAAG;aAChB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,CAAC,MAAM,CAAC,GAAG;gBAAE,SAAS;YAC1B,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG;gBACpB,IAAI,EAAE,MAAM,CAAC,cAAc;gBAC3B,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,OAAO,EAAE,MAAM,CAAC,OAAO;aACxB,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAA4B,EAC5B,MAAwB;IAExB,MAAM,QAAQ,GAAa,EAAE,CAAC;IAE9B,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,KAAK,CAAC,YAAY,EAAE,IAAI,CAAC;QACtC,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QACtD,IAAI,CAAC,QAAQ,EAAE,CAAC;YACd,QAAQ,CAAC,IAAI,CAAC,eAAe,IAAI,gEAAgE,CAAC,CAAC;YACnG,SAAS;QACX,CAAC;QAED,IAAI,QAAQ,CAAC,cAAc,KAAK,OAAO,IAAI,QAAQ,CAAC,GAAG,EAAE,CAAC;YACxD,MAAM,SAAS,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC;iBAC3C,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;iBACrB,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC;YACnB,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACzB,QAAQ,CAAC,IAAI,CACX,eAAe,IAAI,gBAAgB,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB;oBACvE,+CAA+C,CAChD,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/activities/execute-cursor/index.d.ts

@@ -99,10 +99,19 @@ export interface BuildPromptInput {
      * turn.
      */
     sessionContext?: string;
+    /**
+     * Platform-declared standing preferences from the execution spec's
+     * `declared_preferences` (stigmer/stigmer#293). Like the bridge, only
+     * the enhanced-prompt path consumes it — deliberately frozen per Cursor
+     * session (DD-002 D3): the first turn delivers it into the agent's own
+     * conversation store, and repeating it on resumed turns would bloat the
+     * store with identical content.
+     */
+    declaredPreferences?: import("../../shared/declared-preferences.js").DeclaredPreferencesContent;
     /**
      * Conversation catchup from the execution spec's `conversation_catchup`
      * (cloud DD-006): what happened on the channel conversation that the
-     * agent has not seen. PER-TURN, so unlike the three standing values
+     * agent has not seen. PER-TURN, so unlike the standing values
      * above it rides BOTH prompt paths — the enhanced prompt and a resumed
      * turn's prefix (the `interaction_mode` shape). Handback lands
      * mid-session on a resumed agent: the resumed path is the one that