@stigmer/runner 3.0.1

package/dist/activities/execute-cursor/session-lifecycle.js

@@ -0,0 +1,285 @@
+/**
+ * Maps Stigmer Session lifecycle to Cursor Agent lifecycle.
+ *
+ * SessionSpec.harness_state_id stores the Cursor agentId. This module handles
+ * creating new agents (first execution), resuming existing agents
+ * (subsequent executions), graceful fallback on resume failure, and
+ * cleaning up agents (session deletion).
+ *
+ * Two execution modes:
+ *
+ * - Local mode: Agent.create({ local: { cwd } }) with explicit
+ *   platform.workspaceRef/stateRoot for deterministic store keying.
+ *   Produces agent- prefixed IDs.
+ *
+ * - Cloud mode (feature-flagged): Agent.create({ cloud: { repos } })
+ *   for git-backed workspaces. Produces bc- prefixed IDs. No platform
+ *   options — cloud state lives on Cursor's servers, not local SQLite.
+ *
+ * Key SDK limitation: mcpServers are NOT persisted across Agent.resume().
+ * They must be passed again on every resume call.
+ *
+ * Platform store keying (local only): The Cursor SDK defaults to
+ * process.cwd() for its internal state root lookup. In cloud sandboxes,
+ * process.cwd() is the runner's app directory, not the workspace — causing
+ * Agent.resume() to fail with "Agent not found". We pass explicit
+ * platform.workspaceRef and platform.stateRoot derived from the Stigmer
+ * sessionId to ensure deterministic store lookup regardless of process.cwd().
+ *
+ * Durability model: the SDK's local SQLite store (agent records, runs,
+ * checkpoints) is the source of truth for conversation continuation. It is
+ * persisted under the durable workspace volume (see resolvePlatformOptions)
+ * so Agent.resume() survives pod restart, reschedule, and snapshot restore.
+ * When resume nonetheless fails (store lost, corrupted, or agent unknown),
+ * this module creates a fresh agent and the caller starts a new turn from
+ * the user message plus re-injected instructions — there is no separate
+ * continuation store.
+ */
+import { mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { Agent } from "@cursor/sdk";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const CURSOR_SDK_STATE_DIR = ".stigmer/cursor-sdk-state";
+/**
+ * Cursor SDK setting sources loaded for LOCAL agents.
+ *
+ * The Stigmer HITL approval gate is a `.cursor/hooks.json` preToolUse hook
+ * written into the workspace (see workspace-setup.ts). The Cursor SDK only
+ * loads workspace ("project") hooks when the "project" setting source is
+ * enabled — internally `includeProjectHooks = settingSources.includes("project")`
+ * (and the hooks subsystem itself is only constructed when a project/user
+ * source is present). The SDK default is `[]` ("inline config only"), which
+ * silently drops the hook and disables the entire approval gate. We must opt
+ * in to "project" so the hook loads and tool calls are actually gated.
+ *
+ * Side effect: this also loads other workspace `.cursor/*` config (rules,
+ * mcp.json, commands). For runner-provisioned workspaces that is inert; for
+ * sessions running on a user's own repo their project config is now honored.
+ *
+ * Cloud agents always load project settings server-side, so this is local-only.
+ */
+const LOCAL_SETTING_SOURCES = ["project"];
+// ---------------------------------------------------------------------------
+// Local agent functions
+// ---------------------------------------------------------------------------
+/**
+ * Compute deterministic platform options for a Stigmer session.
+ *
+ * workspaceRef is a synthetic identifier (not a filesystem path) that
+ * ensures the SDK's platform cache key is stable across activity
+ * invocations regardless of process.cwd().
+ *
+ * stateRoot is a session-isolated directory under the durable workspace
+ * volume ({workspaceRootDir}/.stigmer/cursor-sdk-state/{sessionId}) where
+ * the SDK persists its SQLite stores (agent records, runs, checkpoints).
+ * Placing it on the workspace volume (rather than $HOME) makes native
+ * Agent.resume() survive pod restart/reschedule and snapshot restore, and
+ * keys it by sessionId so sessions sharing one volume (e.g. the child agent
+ * executions of a workflow sandbox) never collide. Created eagerly to
+ * prevent ENOENT on first SDK write.
+ *
+ * Both inputs are required and must be non-empty: the stateRoot is keyed by
+ * sessionId, so an empty sessionId would collapse every session sharing the
+ * volume onto the same store and corrupt their conversation state.
+ */
+export function resolvePlatformOptions(sessionId, workspaceRootDir) {
+    if (!sessionId) {
+        throw new Error("resolvePlatformOptions: sessionId is required but was empty. The Cursor SDK " +
+            "state store is keyed by sessionId; an empty value would collide across sessions " +
+            "sharing a workspace volume (e.g. a workflow sandbox's child agent executions).");
+    }
+    if (!workspaceRootDir) {
+        throw new Error("resolvePlatformOptions: workspaceRootDir is required but was empty. The Cursor " +
+            "SDK state store must live on the durable workspace volume to survive restarts.");
+    }
+    const stateRoot = join(workspaceRootDir, CURSOR_SDK_STATE_DIR, sessionId);
+    mkdirSync(stateRoot, { recursive: true });
+    return {
+        workspaceRef: `stigmer-session:${sessionId}`,
+        stateRoot,
+    };
+}
+/**
+ * Create a new local Cursor Agent for the first execution in a session.
+ *
+ * Supports multi-workspace: passes string[] when multiple dirs, string when single.
+ */
+export async function createAgent(options) {
+    const cwd = options.workspaceDirs.length === 1
+        ? options.workspaceDirs[0]
+        : options.workspaceDirs;
+    const platform = resolvePlatformOptions(options.sessionId, options.workspaceRootDir);
+    console.log(`createAgent: sessionId=${options.sessionId}, workspaceRef=${platform.workspaceRef}, ` +
+        `stateRoot=${platform.stateRoot}, process.cwd=${process.cwd()}`);
+    return Agent.create({
+        apiKey: options.apiKey,
+        model: { id: options.model },
+        local: { cwd, settingSources: [...LOCAL_SETTING_SOURCES] },
+        mcpServers: options.mcpServers,
+        agents: options.agents,
+        platform,
+    });
+}
+/**
+ * Resume an existing local Cursor Agent for subsequent executions.
+ *
+ * Throws on failure — the caller (resolveAgent) decides whether to
+ * propagate or fall back to a fresh agent with continuation context.
+ */
+export async function resumeAgent(options) {
+    const platform = resolvePlatformOptions(options.sessionId, options.workspaceRootDir);
+    console.log(`resumeAgent: agentId=${options.agentId}, sessionId=${options.sessionId}, ` +
+        `workspaceRef=${platform.workspaceRef}, stateRoot=${platform.stateRoot}, ` +
+        `process.cwd=${process.cwd()}`);
+    return Agent.resume(options.agentId, {
+        apiKey: options.apiKey,
+        model: options.model ? { id: options.model } : undefined,
+        // settingSources are not persisted across resume, so the "project" source
+        // (which loads the HITL approval hook) must be re-supplied every turn.
+        local: { settingSources: [...LOCAL_SETTING_SOURCES] },
+        mcpServers: options.mcpServers,
+        agents: options.agents,
+        platform,
+    });
+}
+// ---------------------------------------------------------------------------
+// Cloud agent functions
+// ---------------------------------------------------------------------------
+/**
+ * Create a new cloud Cursor Agent for git-backed sessions.
+ *
+ * Cloud agents (bc- prefix) run on Cursor's servers with cloned repos.
+ * No platform options — cloud state lives server-side, not in local SQLite.
+ * Model is optional — Cursor resolves the caller's configured default
+ * when omitted.
+ */
+export async function createCloudAgent(options) {
+    console.log(`createCloudAgent: sessionId=${options.sessionId}, ` +
+        `repos=${options.repos.map((r) => r.url).join(", ")}`);
+    return Agent.create({
+        apiKey: options.apiKey,
+        model: options.model ? { id: options.model } : undefined,
+        cloud: { repos: options.repos },
+        mcpServers: options.mcpServers,
+        agents: options.agents,
+    });
+}
+/**
+ * Resume an existing cloud Cursor Agent for subsequent executions.
+ *
+ * Throws on failure — the caller (resolveAgent) decides whether to
+ * propagate or fall back to a fresh cloud agent with continuation context.
+ * No platform options — cloud state lives server-side.
+ */
+export async function resumeCloudAgent(options) {
+    console.log(`resumeCloudAgent: agentId=${options.agentId}`);
+    return Agent.resume(options.agentId, {
+        apiKey: options.apiKey,
+        model: options.model ? { id: options.model } : undefined,
+        mcpServers: options.mcpServers,
+        agents: options.agents,
+    });
+}
+// ---------------------------------------------------------------------------
+// Unified resolution
+// ---------------------------------------------------------------------------
+/**
+ * Resolve a Cursor Agent for execution: resume if possible, create with
+ * graceful fallback if resume fails.
+ *
+ * The mode parameter determines which create/resume functions are used:
+ * - "local": createAgent / resumeAgent (with platform options)
+ * - "cloud": createCloudAgent / resumeCloudAgent (no platform options)
+ *
+ * When harnessStateId is non-empty (subsequent execution):
+ *   1. Attempt Agent.resume with mode-appropriate options.
+ *   2. On success: return { resumed: true, reason: "resumed_successfully" }.
+ *   3. On failure: log warning, create a fresh agent, return
+ *      { resumed: false, reason: "created_after_resume_failure" }.
+ *      The fresh agent has no prior conversation context; the caller
+ *      starts a new turn from the user message and re-injected instructions.
+ *
+ * When harnessStateId is empty (first execution):
+ *   Create a new agent; return { reason: "created_first_execution" }.
+ *
+ * Agent creation failures always propagate — if we cannot create an agent
+ * at all, that is an unrecoverable infrastructure error.
+ */
+export async function resolveAgent(harnessStateId, options, mode = "local") {
+    if (harnessStateId) {
+        try {
+            const agent = mode === "cloud"
+                ? await resumeCloudAgent({
+                    apiKey: options.apiKey,
+                    agentId: harnessStateId,
+                    model: options.model,
+                    mcpServers: options.mcpServers,
+                    agents: options.agents,
+                })
+                : await resumeAgent({
+                    apiKey: options.apiKey,
+                    agentId: harnessStateId,
+                    sessionId: options.sessionId,
+                    workspaceRootDir: options.workspaceRootDir,
+                    model: options.model,
+                    mcpServers: options.mcpServers,
+                    agents: options.agents,
+                });
+            return {
+                agent,
+                agentId: agent.agentId,
+                isNew: false,
+                resumed: true,
+                mode,
+                reason: "resumed_successfully",
+            };
+        }
+        catch (err) {
+            const detail = err instanceof Error ? err.message : String(err);
+            console.warn(`resolveAgent: resume failed for ${mode} agent "${harnessStateId}", ` +
+                `creating fresh agent (no prior context). ` +
+                `sessionId=${options.sessionId}, error: ${detail}`);
+            const agent = mode === "cloud"
+                ? await createCloudAgent(options)
+                : await createAgent(options);
+            console.log(`resolveAgent: fallback ${mode} agent created. ` +
+                `oldAgentId=${harnessStateId}, newAgentId=${agent.agentId}, ` +
+                `sessionId=${options.sessionId}`);
+            return {
+                agent,
+                agentId: agent.agentId,
+                isNew: true,
+                resumed: false,
+                mode,
+                reason: "created_after_resume_failure",
+                resumeFailureDetail: detail,
+            };
+        }
+    }
+    const agent = mode === "cloud"
+        ? await createCloudAgent(options)
+        : await createAgent(options);
+    return {
+        agent,
+        agentId: agent.agentId,
+        isNew: true,
+        resumed: false,
+        mode,
+        reason: "created_first_execution",
+    };
+}
+/**
+ * Dispose a Cursor Agent when a session is deleted.
+ * Best-effort: logs and swallows errors.
+ */
+export async function disposeAgent(agentId, apiKey) {
+    try {
+        await Agent.archive(agentId, { apiKey });
+    }
+    catch (err) {
+        console.warn(`Failed to archive Cursor agent ${agentId}:`, err instanceof Error ? err.message : err);
+    }
+}
+//# sourceMappingURL=session-lifecycle.js.map

package/dist/activities/execute-cursor/session-lifecycle.js.map

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

package/dist/activities/execute-cursor/skill-resolver.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Resolves skill resources and writes them to the platform-managed directory.
+ *
+ * - Fetches skills via gRPC (by reference)
+ * - Writes SKILL.md to .stigmer/skills/{name}/SKILL.md
+ * - Downloads and extracts ZIP artifacts (references/, scripts/, etc.)
+ * - Uses a platform-managed directory outside the workspace
+ * - Creates a symlink from the workspace to the platform dir
+ * - Returns metadata for prompt injection
+ */
+import type { StigmerClient } from "../../client/stigmer-client.js";
+import type { ApiResourceReference } from "@stigmer/protos/ai/stigmer/commons/apiresource/io_pb";
+import type { SkillMetadata } from "./prompt-builder.js";
+export interface SkillResolverOptions {
+    sessionId: string;
+    primaryWorkspaceDir: string;
+}
+/**
+ * Resolve skill references into written SKILL.md files and prompt metadata.
+ *
+ * Platform mount pattern: skills are written to
+ * ~/.stigmer/sessions/{sessionId}/platform/skills/{name}/SKILL.md
+ * with a symlink from {workspace}/.stigmer -> the platform dir.
+ */
+export declare function resolveSkills(client: StigmerClient, skillRefs: ApiResourceReference[], options: SkillResolverOptions): Promise<SkillMetadata[]>;
+/**
+ * Clean up platform-managed skill directory for a session.
+ */
+export declare function cleanupSkills(sessionId: string): Promise<void>;

package/dist/activities/execute-cursor/skill-resolver.js

@@ -0,0 +1,134 @@
+/**
+ * Resolves skill resources and writes them to the platform-managed directory.
+ *
+ * - Fetches skills via gRPC (by reference)
+ * - Writes SKILL.md to .stigmer/skills/{name}/SKILL.md
+ * - Downloads and extracts ZIP artifacts (references/, scripts/, etc.)
+ * - Uses a platform-managed directory outside the workspace
+ * - Creates a symlink from the workspace to the platform dir
+ * - Returns metadata for prompt injection
+ */
+import { mkdir, writeFile, symlink, readlink, unlink, rm } from "node:fs/promises";
+import { join, dirname } from "node:path";
+import { getPlatformDir } from "../../shared/workspace/platform-dir.js";
+import { extractZipFileEntries } from "../../shared/zip-extract.js";
+const STIGMER_LOCAL_STATE_DIR = ".stigmer";
+const SKILLS_SUBDIR = "skills";
+/**
+ * Resolve skill references into written SKILL.md files and prompt metadata.
+ *
+ * Platform mount pattern: skills are written to
+ * ~/.stigmer/sessions/{sessionId}/platform/skills/{name}/SKILL.md
+ * with a symlink from {workspace}/.stigmer -> the platform dir.
+ */
+export async function resolveSkills(client, skillRefs, options) {
+    console.log(`[resolveSkills] sessionId=${options.sessionId}, ` +
+        `primaryWorkspaceDir=${options.primaryWorkspaceDir ?? "(undefined)"}, ` +
+        `skillRefCount=${skillRefs.length}, ` +
+        `refs=[${skillRefs.map(r => `${r.org || "(default)"}/${r.slug}`).join(", ")}]`);
+    if (skillRefs.length === 0)
+        return [];
+    const platformDir = getPlatformDir(options.sessionId);
+    const skillsDir = join(platformDir, SKILLS_SUBDIR);
+    await mkdir(skillsDir, { recursive: true });
+    await ensureStigmerSymlink(options.primaryWorkspaceDir, platformDir);
+    console.log(`[resolveSkills] symlink created: ${join(options.primaryWorkspaceDir, STIGMER_LOCAL_STATE_DIR)} -> ${platformDir}`);
+    const results = [];
+    for (const ref of skillRefs) {
+        try {
+            const skill = await client.getSkillByReference(ref);
+            let artifactBytes;
+            if (skill.status?.artifactStorageKey) {
+                try {
+                    const resp = await client.getSkillArtifact(skill.status.artifactStorageKey);
+                    if (resp.artifact && resp.artifact.length > 0) {
+                        artifactBytes = resp.artifact;
+                    }
+                }
+                catch (err) {
+                    console.warn(`[resolveSkills] artifact download failed for ${ref.slug}, ` +
+                        `falling back to SKILL.md only: ${err instanceof Error ? err.message : err}`);
+                }
+            }
+            const meta = await writeSkill(skill, skillsDir, options.primaryWorkspaceDir, artifactBytes);
+            if (meta) {
+                results.push(meta);
+                console.log(`[resolveSkills] wrote skill: ${meta.name} -> ${meta.path}`);
+            }
+            else {
+                console.warn(`[resolveSkills] skill ${ref.org}/${ref.slug} fetched but had no skillMd content`);
+            }
+        }
+        catch (err) {
+            console.warn(`[resolveSkills] failed to resolve skill ${ref.org}/${ref.slug}: ${err instanceof Error ? err.message : err}`);
+        }
+    }
+    console.log(`[resolveSkills] completed: ${results.length}/${skillRefs.length} skills resolved`);
+    return results;
+}
+async function writeSkill(skill, skillsDir, workspaceDir, artifactBytes) {
+    const spec = skill.spec;
+    if (!spec?.skillMd)
+        return null;
+    const name = spec.name || skill.metadata?.slug || "unknown";
+    const skillDir = join(skillsDir, name);
+    await mkdir(skillDir, { recursive: true });
+    const skillMdPath = join(skillDir, "SKILL.md");
+    await writeFile(skillMdPath, spec.skillMd, "utf-8");
+    if (artifactBytes && artifactBytes.length > 0) {
+        const entries = await extractZipFileEntries(artifactBytes, { exclude: ["SKILL.md"] });
+        for (const entry of entries) {
+            const filePath = join(skillDir, entry.path);
+            await mkdir(dirname(filePath), { recursive: true });
+            await writeFile(filePath, entry.content, "utf-8");
+        }
+    }
+    const relativePath = join(STIGMER_LOCAL_STATE_DIR, SKILLS_SUBDIR, name, "SKILL.md");
+    return {
+        name,
+        description: spec.description || `Skill: ${name}`,
+        path: relativePath,
+    };
+}
+/**
+ * Ensure .stigmer symlink in the workspace points to the platform dir.
+ *
+ * The Cursor SDK reads files from the workspace CWD, so we need the
+ * .stigmer directory to be accessible there. Unlike the Python runner
+ * which intercepts file paths, Cursor reads directly from the filesystem.
+ */
+async function ensureStigmerSymlink(workspaceDir, platformDir) {
+    const linkPath = join(workspaceDir, STIGMER_LOCAL_STATE_DIR);
+    try {
+        const existing = await readlink(linkPath);
+        if (existing === platformDir)
+            return;
+        await unlink(linkPath);
+    }
+    catch (err) {
+        if (err.code === "ENOENT") {
+            // No existing symlink
+        }
+        else if (err.code === "EINVAL") {
+            // Exists but is not a symlink — remove the directory
+            await rm(linkPath, { recursive: true, force: true });
+        }
+        else {
+            throw err;
+        }
+    }
+    await symlink(platformDir, linkPath, "dir");
+}
+/**
+ * Clean up platform-managed skill directory for a session.
+ */
+export async function cleanupSkills(sessionId) {
+    const platformDir = getPlatformDir(sessionId);
+    try {
+        await rm(platformDir, { recursive: true, force: true });
+    }
+    catch {
+        // best-effort
+    }
+}
+//# sourceMappingURL=skill-resolver.js.map

package/dist/activities/execute-cursor/skill-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-resolver.js","sourceRoot":"","sources":["../../../src/activities/execute-cursor/skill-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAK1C,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AACxE,OAAO,EAAE,qBAAqB,EAAE,MAAM,6BAA6B,CAAC;AAEpE,MAAM,uBAAuB,GAAG,UAAU,CAAC;AAC3C,MAAM,aAAa,GAAG,QAAQ,CAAC;AAO/B;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,MAAqB,EACrB,SAAiC,EACjC,OAA6B;IAE7B,OAAO,CAAC,GAAG,CACT,6BAA6B,OAAO,CAAC,SAAS,IAAI;QAClD,uBAAuB,OAAO,CAAC,mBAAmB,IAAI,aAAa,IAAI;QACvE,iBAAiB,SAAS,CAAC,MAAM,IAAI;QACrC,SAAS,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,WAAW,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC/E,CAAC;IAEF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAEtC,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IACtD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IACnD,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE5C,MAAM,oBAAoB,CAAC,OAAO,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAC;IACrE,OAAO,CAAC,GAAG,CACT,oCAAoC,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,uBAAuB,CAAC,OAAO,WAAW,EAAE,CACnH,CAAC;IAEF,MAAM,OAAO,GAAoB,EAAE,CAAC;IAEpC,KAAK,MAAM,GAAG,IAAI,SAAS,EAAE,CAAC;QAC5B,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;YAEpD,IAAI,aAAqC,CAAC;YAC1C,IAAI,KAAK,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC;gBACrC,IAAI,CAAC;oBACH,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,gBAAgB,CAAC,KAAK,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC;oBAC5E,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;wBAC9C,aAAa,GAAG,IAAI,CAAC,QAAQ,CAAC;oBAChC,CAAC;gBACH,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,OAAO,CAAC,IAAI,CACV,gDAAgD,GAAG,CAAC,IAAI,IAAI;wBAC5D,kCAAkC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAC7E,CAAC;gBACJ,CAAC;YACH,CAAC;YAED,MAAM,IAAI,GAAG,MAAM,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,mBAAmB,EAAE,aAAa,CAAC,CAAC;YAC5F,IAAI,IAAI,EAAE,CAAC;gBACT,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACnB,OAAO,CAAC,GAAG,CAAC,gCAAgC,IAAI,CAAC,IAAI,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YAC3E,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,IAAI,CAAC,yBAAyB,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,qCAAqC,CAAC,CAAC;YAClG,CAAC;QACH,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,CAAC,IAAI,CACV,2CAA2C,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,CAC9G,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,CAAC,GAAG,CACT,8BAA8B,OAAO,CAAC,MAAM,IAAI,SAAS,CAAC,MAAM,kBAAkB,CACnF,CAAC;IAEF,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,KAAK,UAAU,UAAU,CACvB,KAAY,EACZ,SAAiB,EACjB,YAAoB,EACpB,aAA0B;IAE1B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC;IACxB,IAAI,CAAC,IAAI,EAAE,OAAO;QAAE,OAAO,IAAI,CAAC;IAEhC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,IAAI,IAAI,SAAS,CAAC;IAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IACvC,MAAM,KAAK,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,EAAE,UAAU,CAAC,CAAC;IAC/C,MAAM,SAAS,CAAC,WAAW,EAAE,IAAI,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;IAEpD,IAAI,aAAa,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9C,MAAM,OAAO,GAAG,MAAM,qBAAqB,CAAC,aAAa,EAAE,EAAE,OAAO,EAAE,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QACtF,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;YAC5C,MAAM,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACpD,MAAM,SAAS,CAAC,QAAQ,EAAE,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,uBAAuB,EAAE,aAAa,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;IAEpF,OAAO;QACL,IAAI;QACJ,WAAW,EAAE,IAAI,CAAC,WAAW,IAAI,UAAU,IAAI,EAAE;QACjD,IAAI,EAAE,YAAY;KACnB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,KAAK,UAAU,oBAAoB,CACjC,YAAoB,EACpB,WAAmB;IAEnB,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,uBAAuB,CAAC,CAAC;IAE7D,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,QAAQ,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,QAAQ,KAAK,WAAW;YAAE,OAAO;QACrC,MAAM,MAAM,CAAC,QAAQ,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,GAAQ,EAAE,CAAC;QAClB,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC1B,sBAAsB;QACxB,CAAC;aAAM,IAAI,GAAG,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YACjC,qDAAqD;YACrD,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACvD,CAAC;aAAM,CAAC;YACN,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;IAED,MAAM,OAAO,CAAC,WAAW,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;AAC9C,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,SAAiB;IACnD,MAAM,WAAW,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;IAC9C,IAAI,CAAC;QACH,MAAM,EAAE,CAAC,WAAW,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IAAC,MAAM,CAAC;QACP,cAAc;IAChB,CAAC;AACH,CAAC"}

package/dist/activities/execute-cursor/subagent-config.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Maps Stigmer SubAgent blueprints to Cursor SDK custom sub-agent definitions.
+ *
+ * The Cursor SDK registers custom sub-agents via `AgentOptions.agents`
+ * (`Record<name, AgentDefinition>`). Once registered, the parent agent can
+ * delegate to them by name through the Task tool. This is the capability that
+ * makes blueprint sub-agents actually invokable on the Cursor harness — parity
+ * with the native deepagents harness, which compiles them into the graph.
+ *
+ * Known limitations (Cursor SDK, not Stigmer):
+ * - Per-sub-agent MCP tool filtering is NOT supported: custom sub-agents
+ *   inherit the parent agent's MCP config (`SDKCustomSubagentDefinition` has no
+ *   `mcpServers` field). A blueprint's `mcp_access` is therefore surfaced only
+ *   as advisory prompt context, not enforced as an isolation boundary.
+ * - Built-in kinds (`explore`, `shell`, `generalPurpose`) are provided by
+ *   Cursor's own runtime and must NOT be registered here — doing so would
+ *   shadow the native ones. They are encouraged via prompt guidance instead.
+ *
+ * Because the SDK does not persist agent configuration across `Agent.resume()`
+ * (the same constraint that applies to `mcpServers`), the result of this
+ * mapper must be supplied on every create AND resume call so the delegation
+ * capability survives across turns.
+ */
+import type { AgentDefinition } from "@cursor/sdk";
+import type { SubAgent } from "@stigmer/protos/ai/stigmer/agentic/agent/v1/spec_pb";
+/**
+ * Build the Cursor SDK `agents` map from blueprint sub-agents.
+ *
+ * Returns `undefined` (rather than an empty object) when there are no usable
+ * entries, so callers can omit the `agents` option entirely.
+ *
+ * @param subAgents Blueprint sub-agents from `Agent.spec.sub_agents`.
+ */
+export declare function buildCursorSubAgentDefinitions(subAgents: readonly SubAgent[]): Record<string, AgentDefinition> | undefined;

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

@@ -0,0 +1,55 @@
+/**
+ * Maps Stigmer SubAgent blueprints to Cursor SDK custom sub-agent definitions.
+ *
+ * The Cursor SDK registers custom sub-agents via `AgentOptions.agents`
+ * (`Record<name, AgentDefinition>`). Once registered, the parent agent can
+ * delegate to them by name through the Task tool. This is the capability that
+ * makes blueprint sub-agents actually invokable on the Cursor harness — parity
+ * with the native deepagents harness, which compiles them into the graph.
+ *
+ * Known limitations (Cursor SDK, not Stigmer):
+ * - Per-sub-agent MCP tool filtering is NOT supported: custom sub-agents
+ *   inherit the parent agent's MCP config (`SDKCustomSubagentDefinition` has no
+ *   `mcpServers` field). A blueprint's `mcp_access` is therefore surfaced only
+ *   as advisory prompt context, not enforced as an isolation boundary.
+ * - Built-in kinds (`explore`, `shell`, `generalPurpose`) are provided by
+ *   Cursor's own runtime and must NOT be registered here — doing so would
+ *   shadow the native ones. They are encouraged via prompt guidance instead.
+ *
+ * Because the SDK does not persist agent configuration across `Agent.resume()`
+ * (the same constraint that applies to `mcpServers`), the result of this
+ * mapper must be supplied on every create AND resume call so the delegation
+ * capability survives across turns.
+ */
+/**
+ * Build the Cursor SDK `agents` map from blueprint sub-agents.
+ *
+ * Returns `undefined` (rather than an empty object) when there are no usable
+ * entries, so callers can omit the `agents` option entirely.
+ *
+ * @param subAgents Blueprint sub-agents from `Agent.spec.sub_agents`.
+ */
+export function buildCursorSubAgentDefinitions(subAgents) {
+    if (subAgents.length === 0)
+        return undefined;
+    const agents = {};
+    for (const sa of subAgents) {
+        const name = sa.name?.trim();
+        // The name is the SDK registration key and the handle the model uses to
+        // delegate. Skip entries without one rather than register an unaddressable
+        // sub-agent.
+        if (!name)
+            continue;
+        // instructions is the sub-agent's system prompt. The proto requires it
+        // (min_len 10), but fall back defensively so a malformed blueprint still
+        // produces an invokable sub-agent instead of being silently dropped.
+        const prompt = sa.instructions?.trim() || sa.description?.trim() || name;
+        agents[name] = {
+            description: sa.description ?? "",
+            prompt,
+            model: sa.modelOverride ? { id: sa.modelOverride } : "inherit",
+        };
+    }
+    return Object.keys(agents).length > 0 ? agents : undefined;
+}
+//# sourceMappingURL=subagent-config.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"subagent-config.js","sourceRoot":"","sources":["../../../src/activities/execute-cursor/subagent-config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAKH;;;;;;;GAOG;AACH,MAAM,UAAU,8BAA8B,CAC5C,SAA8B;IAE9B,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IAE7C,MAAM,MAAM,GAAoC,EAAE,CAAC;IACnD,KAAK,MAAM,EAAE,IAAI,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC;QAC7B,wEAAwE;QACxE,2EAA2E;QAC3E,aAAa;QACb,IAAI,CAAC,IAAI;YAAE,SAAS;QAEpB,uEAAuE;QACvE,yEAAyE;QACzE,qEAAqE;QACrE,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC;QAEzE,MAAM,CAAC,IAAI,CAAC,GAAG;YACb,WAAW,EAAE,EAAE,CAAC,WAAW,IAAI,EAAE;YACjC,MAAM;YACN,KAAK,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,EAAE,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,SAAS;SAC/D,CAAC;IACJ,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;AAC7D,CAAC"}

package/dist/activities/execute-cursor/todo-tracker.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Tracks todo tool call events from the Cursor SDK stream and populates
+ * AgentExecutionStatus.todos with structured TodoItem protos.
+ *
+ * The Cursor SDK emits todo updates as tool_call events. Historically the
+ * tool was named "TodoWrite"; current SDK versions use "updateTodos" with
+ * a slightly different args schema (camelCase statuses, no per-item id).
+ * This tracker accepts both names for resilience across SDK versions.
+ *
+ * The MessageAccumulator captures the same event as a MESSAGE_TOOL
+ * (preserving visibility in the message thread). This tracker is a
+ * parallel extraction into the proto map that downstream consumers
+ * (React TodoList, CLI emitTodoEvents) already know how to render.
+ *
+ * Follows the same single-responsibility pattern as DeltaEnricher:
+ * the orchestrator (execute-cursor.ts) wires it into the event loop.
+ */
+import type { TodoItem } from "@stigmer/protos/ai/stigmer/agentic/agentexecution/v1/todo_pb";
+import type { SDKMessage } from "@cursor/sdk";
+export declare class TodoTracker {
+    private readonly todos;
+    private _isDirty;
+    constructor(todos: {
+        [key: string]: TodoItem;
+    });
+    /**
+     * Process a stream event. Only acts on completed todo tool calls
+     * (both legacy "TodoWrite" and current SDK "updateTodos").
+     */
+    processEvent(event: SDKMessage): void;
+    get isDirty(): boolean;
+    markPersisted(): void;
+    private parseArgs;
+    private clearMap;
+}