@cursor/july 0.1.73 → 0.1.75

package/dist/internal/install-cursor-skills.js

@@ -1,10 +1,17 @@
 /**
  * Offer to install the package's coding-agent skills into the user's
- * personal Cursor skills dir under `~/.cursor/skills/agentkit/<skill>/`.
+ * personal Cursor skills dir under `~/.cursor/skills/agentsdk/<skill>/`.
  *
- * Cursor walks `~/.cursor/skills` recursively, so the `agentkit/` folder is
+ * Cursor walks `~/.cursor/skills` recursively, so the `agentsdk/` folder is
  * only organizational — identity comes from the leaf folder that holds
- * SKILL.md. Skipped for `--json` / non-TTY hosts.
+ * SKILL.md. Installed copies get `alwaysApply: true` so Cursor injects the
+ * skill body as a global rule instead of leaving it as an on-demand catalog
+ * entry. Skipped for `--json` / non-TTY hosts.
+ *
+ * Consumer installs (`npm install` / `npx` of `@cursor/july`) also copy
+ * these skills from a postinstall hook. That path never prompts and never
+ * fails the package install. The monorepo source checkout is not a consumer
+ * install, so `pnpm install` in everysphere does not overwrite `~/.cursor`.
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -19,40 +26,67 @@ import { access, chmod, cp, mkdir, readdir, readFile, rm, stat, writeFile, } fro
 import { homedir } from "node:os";
 import { join } from "node:path";
 import { CLI_COMMAND_NAME, packageRootDir } from "./distribution.js";
+import { parseFrontmatter } from "./frontmatter.js";
 import { stdoutPalette } from "./terminal-style.js";
 /** Monorepo-only skill; excluded from the published package. */
 const SKIP_SKILL_DIRS = new Set(["operate"]);
 /** Category folder under ~/.cursor/skills (Cursor discovers nested skills). */
-export const CURSOR_SKILLS_NAMESPACE = "agentkit";
+export const CURSOR_SKILLS_NAMESPACE = "agentsdk";
+/** Pre-rename install folder. Install deletes this so `/agentkit-*` rows disappear. */
+export const LEGACY_CURSOR_SKILLS_NAMESPACE = "agentkit";
 /** How long the `init` offer waits for an answer before skipping the install. */
 export const SKILL_PROMPT_TIMEOUT_MS = 45000;
+/**
+ * Override the resolved `~/.cursor/skills` directory (not the user home).
+ * Used by the postinstall hook in tests and publish smoke.
+ */
+export const CURSOR_JULY_SKILLS_HOME_ENV = "CURSOR_JULY_SKILLS_HOME";
+/** Set to `1` to skip the postinstall skill copy. */
+export const CURSOR_JULY_SKIP_SKILL_INSTALL_ENV = "CURSOR_JULY_SKIP_SKILL_INSTALL";
 export function cursorSkillsHome(home) {
     var _a;
-    if (home === void 0) { home = (_a = process.env.HOME) !== null && _a !== void 0 ? _a : homedir(); }
-    const resolved = home.trim() === "" ? homedir() : home;
-    return join(resolved, ".cursor", "skills");
+    if (home !== undefined) {
+        return join(home.trim() === "" ? homedir() : home, ".cursor", "skills");
+    }
+    const override = (_a = process.env[CURSOR_JULY_SKILLS_HOME_ENV]) === null || _a === void 0 ? void 0 : _a.trim();
+    if (override !== undefined && override !== "") {
+        return override;
+    }
+    return join(homedir(), ".cursor", "skills");
+}
+/**
+ * True when this package root is an installed copy under `node_modules`
+ * (npm, pnpm, yarn, npx, global), not the everysphere source checkout.
+ */
+export function isConsumerPackageInstall(packageRoot) {
+    // Segment check only — split on both separators so a Windows path still
+    // matches when this runs (or is tested) on POSIX. Do not rewrite the path.
+    return packageRoot.split(/[\\/]/).includes("node_modules");
 }
-/** `~/.cursor/skills/agentkit` — where package skills are installed. */
-export function agentkitCursorSkillsDir(skillsHome = cursorSkillsHome()) {
+/** `~/.cursor/skills/agentsdk` — where package skills are installed. */
+export function agentsdkCursorSkillsDir(skillsHome = cursorSkillsHome()) {
     return join(skillsHome, CURSOR_SKILLS_NAMESPACE);
 }
-/** Absolute install path for one skill: `…/agentkit/<leafDir>`. */
+/** Pre-rename `~/.cursor/skills/agentkit`. */
+export function legacyAgentkitCursorSkillsDir(skillsHome = cursorSkillsHome()) {
+    return join(skillsHome, LEGACY_CURSOR_SKILLS_NAMESPACE);
+}
+/** Absolute install path for one skill: `…/agentsdk/<leafDir>`. */
 export function skillInstallPath(skill, skillsHome = cursorSkillsHome()) {
-    return join(agentkitCursorSkillsDir(skillsHome), skill.leafDir);
+    return join(agentsdkCursorSkillsDir(skillsHome), skill.leafDir);
 }
 /**
  * Skills shipped next to the running package. Uses the frontmatter `name`
- * when present, otherwise `agentkit-<dir>`.
+ * when present, otherwise `agentsdk-<dir>`.
  */
 export function listShippedPackageSkills() {
     return __awaiter(this, arguments, void 0, function* (packageRoot = packageRootDir()) {
-        var _a;
         const skillsRoot = join(packageRoot, "skills");
         let entries;
         try {
             entries = yield readdir(skillsRoot, { withFileTypes: true });
         }
-        catch (_b) {
+        catch (_a) {
             return [];
         }
         const skills = [];
@@ -65,11 +99,12 @@ export function listShippedPackageSkills() {
             try {
                 yield access(skillMd);
             }
-            catch (_c) {
+            catch (_b) {
                 continue;
             }
             const raw = yield readFile(skillMd, "utf8");
-            const name = (_a = parseSkillName(raw)) !== null && _a !== void 0 ? _a : `agentkit-${entry.name}`;
+            const name = parseFrontmatter(raw).data.name ||
+                `${CURSOR_SKILLS_NAMESPACE}-${entry.name}`;
             skills.push({ name, leafDir: entry.name, sourceDir });
         }
         skills.sort((a, b) => a.leafDir.localeCompare(b.leafDir));
@@ -77,7 +112,7 @@ export function listShippedPackageSkills() {
     });
 }
 /**
- * Skills that do not yet have a SKILL.md under ~/.cursor/skills/agentkit/.
+ * Skills that do not yet have a SKILL.md under ~/.cursor/skills/agentsdk/.
  * Install still overwrites every shipped skill when the user confirms — this
  * helper is for messaging (fresh install vs update).
  */
@@ -99,13 +134,15 @@ export function findMissingCursorSkills(options) {
     });
 }
 /**
- * Copy each skill directory into `skillsHome/agentkit/<leafDir>/`.
+ * Copy each skill directory into `skillsHome/agentsdk/<leafDir>/`.
  * Always overwrites so a package upgrade refreshes local Cursor skills.
- * Strips monorepo-only frontmatter and removes leaf dirs no longer shipped.
+ * Strips monorepo-only frontmatter, sets `alwaysApply: true` so Cursor
+ * loads the body into context, and removes leaf dirs no longer shipped.
+ * Also deletes leftover `skillsHome/agentkit/` from the previous namespace.
  */
 export function installCursorSkills(skills_1) {
     return __awaiter(this, arguments, void 0, function* (skills, skillsHome = cursorSkillsHome()) {
-        const namespaceDir = agentkitCursorSkillsDir(skillsHome);
+        const namespaceDir = agentsdkCursorSkillsDir(skillsHome);
         yield mkdir(namespaceDir, { recursive: true });
         const removed = yield orphanLeaves(namespaceDir, skills);
         for (const leaf of removed) {
@@ -128,7 +165,8 @@ export function installCursorSkills(skills_1) {
             }
             installed.push(skill.leafDir);
         }
-        return { installed, removed };
+        const removedLegacyNamespace = yield removeLegacyCursorSkillsNamespace(skillsHome);
+        return { installed, removed, removedLegacyNamespace };
     });
 }
 function makeTreeWritable(root) {
@@ -171,14 +209,42 @@ function orphanLeaves(namespaceDir, skills) {
             .map((entry) => entry.name);
     });
 }
-/** Drop monorepo `paths` globs and fix package doc links for ~/.cursor installs. */
+/** Drop leftover `skillsHome/agentkit` from the previous install namespace. */
+function removeLegacyCursorSkillsNamespace(skillsHome) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const legacyDir = legacyAgentkitCursorSkillsDir(skillsHome);
+        try {
+            yield stat(legacyDir);
+        }
+        catch (_a) {
+            return false;
+        }
+        yield rm(legacyDir, { recursive: true, force: true });
+        return true;
+    });
+}
+function hasLegacyCursorSkillsNamespace(skillsHome) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            yield stat(legacyAgentkitCursorSkillsDir(skillsHome));
+            return true;
+        }
+        catch (_a) {
+            return false;
+        }
+    });
+}
+/**
+ * Drop monorepo `paths` globs, set `alwaysApply: true` so Cursor injects the
+ * body as a global rule, and fix package doc links for ~/.cursor installs.
+ */
 export function prepareSkillMarkdownForCursorInstall(content) {
     var _a;
     const match = /^---\r?\n([\s\S]*?)\r?\n---/.exec(content);
     if (match === null) {
         return content;
     }
-    const frontmatter = stripPathsFromFrontmatter((_a = match[1]) !== null && _a !== void 0 ? _a : "");
+    const frontmatter = withAlwaysApply(stripPathsFromFrontmatter((_a = match[1]) !== null && _a !== void 0 ? _a : ""));
     const body = content.slice(match[0].length);
     const adjustedBody = body.replace(/\[`docs\/([^`]+)`\]\(\.\.\/\.\.\/docs\/[^)]+\)/g, "docs/$1 in the @cursor/july package");
     return `---\n${frontmatter.trimEnd()}\n---${adjustedBody}`;
@@ -201,24 +267,42 @@ function stripPathsFromFrontmatter(frontmatter) {
     }
     return out.join("\n");
 }
+/** Cursor loads `alwaysApply: true` skills as global rules, not catalog rows. */
+function withAlwaysApply(frontmatter) {
+    const without = frontmatter
+        .split(/\r?\n/)
+        .filter((line) => !/^\s*alwaysApply\s*:/.test(line))
+        .join("\n")
+        .replace(/\n+$/, "");
+    if (without === "") {
+        return "alwaysApply: true";
+    }
+    return `${without}\nalwaysApply: true`;
+}
 /** What an install would do, for the offer and for `install-skills`. */
 export function planSkillInstall(options) {
     return __awaiter(this, void 0, void 0, function* () {
         var _a;
         const skillsHome = (_a = options === null || options === void 0 ? void 0 : options.skillsHome) !== null && _a !== void 0 ? _a : cursorSkillsHome();
-        const directory = agentkitCursorSkillsDir(skillsHome);
+        const directory = agentsdkCursorSkillsDir(skillsHome);
         const shipped = yield listShippedPackageSkills(options === null || options === void 0 ? void 0 : options.packageRoot);
-        const missing = yield findMissingCursorSkills({
-            packageRoot: options === null || options === void 0 ? void 0 : options.packageRoot,
-            skillsHome,
-        });
+        const present = yield Promise.all(shipped.map((skill) => __awaiter(this, void 0, void 0, function* () {
+            try {
+                yield access(join(skillInstallPath(skill, skillsHome), "SKILL.md"));
+                return true;
+            }
+            catch (_a) {
+                return false;
+            }
+        })));
         return {
             shipped,
             skillsHome,
             directory,
             leaves: shipped.map((skill) => skill.leafDir),
-            firstInstall: missing.length === shipped.length,
+            firstInstall: present.every((isPresent) => !isPresent),
             orphans: yield orphanLeaves(directory, shipped),
+            hasLegacyNamespace: yield hasLegacyCursorSkillsNamespace(skillsHome),
         };
     });
 }
@@ -230,12 +314,55 @@ export function formatSkillInstall(plan, result) {
     if (result.removed.length > 0) {
         lines.push(`  removed:  ${result.removed.join(", ")}`);
     }
+    if (result.removedLegacyNamespace) {
+        lines.push(`  removed:  ${legacyAgentkitCursorSkillsDir(plan.skillsHome)} (legacy namespace)`);
+    }
     lines.push(`  location: ${plan.directory}`);
     return `${lines.join("\n")}\n`;
 }
+/**
+ * Copy shipped coding-agent skills into ~/.cursor/skills/agentsdk during a
+ * consumer `npm install` / `npx`. Never throws: a failed copy must not fail
+ * the package install. No-op in the monorepo source tree and when
+ * `CURSOR_JULY_SKIP_SKILL_INSTALL=1`.
+ */
+export function syncCursorSkillsOnPackageInstall() {
+    return __awaiter(this, arguments, void 0, function* (options = {}) {
+        var _a, _b, _c, _d;
+        try {
+            const env = (_a = options.env) !== null && _a !== void 0 ? _a : process.env;
+            if (env[CURSOR_JULY_SKIP_SKILL_INSTALL_ENV] === "1") {
+                return { status: "skipped", reason: "opt-out" };
+            }
+            const packageRoot = (_b = options.packageRoot) !== null && _b !== void 0 ? _b : packageRootDir();
+            const consumer = (_c = options.consumer) !== null && _c !== void 0 ? _c : isConsumerPackageInstall(packageRoot);
+            if (!consumer) {
+                return { status: "skipped", reason: "not-consumer" };
+            }
+            const plan = yield planSkillInstall({
+                packageRoot,
+                skillsHome: options.skillsHome,
+            });
+            if (plan.shipped.length === 0) {
+                return { status: "skipped", reason: "no-skills" };
+            }
+            const result = yield installCursorSkills(plan.shipped, plan.skillsHome);
+            const out = (_d = options.out) !== null && _d !== void 0 ? _d : ((text) => process.stderr.write(text));
+            out(formatSkillInstall(plan, result));
+            return {
+                status: "installed",
+                installed: result.installed,
+                removed: result.removed,
+            };
+        }
+        catch (_e) {
+            return { status: "skipped", reason: "error" };
+        }
+    });
+}
 /**
  * On a TTY, offer to install/update every shipped package skill into
- * ~/.cursor/skills/agentkit (always overwriting). No-op when non-interactive
+ * ~/.cursor/skills/agentsdk (always overwriting). No-op when non-interactive
  * or the package ships no skills. An unanswered prompt skips the install
  * rather than blocking the caller — see `SKILL_PROMPT_TIMEOUT_MS`.
  */
@@ -265,6 +392,9 @@ export function offerInstallCursorSkills() {
         if (plan.orphans.length > 0) {
             out(c.dim(`  (deletes ${plan.orphans.join(", ")})\n`));
         }
+        if (plan.hasLegacyNamespace) {
+            out(c.dim(`  (deletes leftover ${legacyAgentkitCursorSkillsDir(plan.skillsHome)})\n`));
+        }
         const confirm = (_c = options.confirm) !== null && _c !== void 0 ? _c : ((q) => promptYesNo(q, {
             defaultYes: true,
             out,
@@ -285,24 +415,6 @@ export function offerInstallCursorSkills() {
         return { installed: result.installed, skipped: false };
     });
 }
-function parseSkillName(skillMd) {
-    var _a;
-    var _b;
-    const match = /^---\r?\n([\s\S]*?)\r?\n---/.exec(skillMd);
-    if (match === null) {
-        return undefined;
-    }
-    const nameLine = /^name:\s*(.+)\s*$/m.exec((_b = match[1]) !== null && _b !== void 0 ? _b : "");
-    if (nameLine === null) {
-        return undefined;
-    }
-    const raw = (_a = nameLine[1]) === null || _a === void 0 ? void 0 : _a.trim();
-    if (raw === undefined || raw === "") {
-        return undefined;
-    }
-    // Strip optional quotes around the YAML scalar.
-    return raw.replace(/^["']|["']$/g, "");
-}
 /**
  * Ask a yes/no question. Resolves `undefined` when the answer never comes —
  * the prompt timed out, or stdin closed on an empty line.

package/dist/internal/sdk-runner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sdk-runner.d.ts","sourceRoot":"","sources":["../../src/internal/sdk-runner.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"sdk-runner.d.ts","sourceRoot":"","sources":["../../src/internal/sdk-runner.ts"],"names":[],"mappings":"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"}

package/dist/internal/sdk-runner.js

@@ -15,7 +15,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { mkdir } from "node:fs/promises";
-import { Agent, Cursor, createAgentPlatform, JsonlLocalAgentStore, } from "@cursor/sdk";
+import { Agent, Cursor, createAgentPlatform, } from "@cursor/sdk";
+import { SqliteLocalAgentStore } from "@cursor/sdk/sqlite";
 import { DEFAULT_MODEL, } from "../types.js";
 import { mapSdkTokenUsage, usageTokenSum } from "./cloud-turn-cost.js";
 /**
@@ -399,7 +400,10 @@ export class CursorSdkRunner {
     getStore(stateDir) {
         let storePromise = this.stores.get(stateDir);
         if (storePromise === undefined) {
-            storePromise = mkdir(stateDir, { recursive: true }).then(() => new JsonlLocalAgentStore(stateDir));
+            storePromise = mkdir(stateDir, { recursive: true }).then(() => SqliteLocalAgentStore.open({
+                stateRoot: stateDir,
+                workspaceRef: stateDir,
+            }));
             this.stores.set(stateDir, storePromise);
         }
         return storePromise;

package/dist/internal/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/internal/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAkCH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAOhB,YAAY,EACb,MAAM,aAAa,CAAC;AAkHrB,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAwBpE,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;CACvB;AAaD,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,YAAY,GAAG,0BAA+B,GACtD,OAAO,CAAC,gBAAgB,CAAC,CAywB3B"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/internal/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAuCH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAOhB,YAAY,EACb,MAAM,aAAa,CAAC;AAwHrB,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAwBpE,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;CACvB;AAaD,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,YAAY,GAAG,0BAA+B,GACtD,OAAO,CAAC,gBAAgB,CAAC,CAoxB3B"}

package/dist/internal/server.js

@@ -35,6 +35,7 @@ import { Buffer } from "node:buffer";
 import { once } from "node:events";
 import { createServer, } from "node:http";
 import { join } from "node:path";
+import { dispatchDeploymentEvent, getDeploymentsChannelOptions, } from "../channels/deployments/deployments-channel.js";
 import { createCursorAccountGithubTokenResolver, getGithubCursorAccountRuntime, parseCursorGithubRepoScope, resolveCursorGithubPermissions, resolveCursorGithubProxyUrl, } from "../channels/github/cursor-account.js";
 import { findGitHubChannelTargets } from "../channels/github/forward.js";
 import { getOriginCursorAccountRuntime, parseCursorOriginRepoScope, } from "../channels/origin/cursor-account.js";
@@ -46,6 +47,7 @@ import { CursorAccountMcpBridge, collectCursorAccountConnections, cursorAccountM
 import { CursorBackendClient } from "./cursor/backend-client.js";
 import { cursorExternalApiUrl, resolveApiKey, SIGN_IN_HINT, } from "./cursor/credentials.js";
 import { CursorGithubCredentialProvider } from "./cursor/github-credentials.js";
+import { DeploymentEventRelay, fanOutDeploymentEvent, resolveDeploymentSubscriptions, } from "./cursor-deployment-relay.js";
 import { CursorEventRelay, formatCursorScmDispatchOutcome, formatCursorScmEventLog, scmEventToGitHubPayload, scmMetadataToOriginPayload, } from "./cursor-event-relay.js";
 import { AGENT_SERVE_GENERATION_ENV_VAR } from "./cursor-relay-core.js";
 import { CursorSlackRelay, createCursorSlackApiCaller, formatCursorSlackEventLog, } from "./cursor-slack-relay.js";
@@ -536,6 +538,14 @@ export function startServer(mounts_1) {
             cursorAccountOnly: options.cursorEvents === undefined &&
                 (cursorGithubTargets.length > 0 || cursorOriginTargets.length > 0),
         });
+        // Cursor deployment-events relay: automatic when a mounted agent authored
+        // `deploymentsChannel({ ... })`.
+        const cursorDeploymentRelay = startCursorDeploymentRelay({
+            options,
+            runtimes,
+            accountKey,
+            logger,
+        });
         const server = createServer((req, res) => {
             void instrumentHttp(otelRuntime, req, res, () => handleRequest(router, req, res, logger));
         });
@@ -553,6 +563,7 @@ export function startServer(mounts_1) {
             });
         }
         catch (error) {
+            yield cursorDeploymentRelay === null || cursorDeploymentRelay === void 0 ? void 0 : cursorDeploymentRelay.stop();
             yield cursorEventRelay === null || cursorEventRelay === void 0 ? void 0 : cursorEventRelay.stop();
             yield cursorSlackRelay === null || cursorSlackRelay === void 0 ? void 0 : cursorSlackRelay.stop();
             cursorGithubCredentials === null || cursorGithubCredentials === void 0 ? void 0 : cursorGithubCredentials.stop();
@@ -703,6 +714,7 @@ export function startServer(mounts_1) {
                 var _a;
                 var _b;
                 playgroundDev === null || playgroundDev === void 0 ? void 0 : playgroundDev.stop();
+                yield cursorDeploymentRelay === null || cursorDeploymentRelay === void 0 ? void 0 : cursorDeploymentRelay.stop();
                 yield cursorEventRelay === null || cursorEventRelay === void 0 ? void 0 : cursorEventRelay.stop();
                 yield cursorSlackRelay === null || cursorSlackRelay === void 0 ? void 0 : cursorSlackRelay.stop();
                 for (const runtime of runtimes) {
@@ -1660,13 +1672,110 @@ function collectCursorSlackTargets(runtimes) {
     }
     return targets;
 }
+/** Every mounted `deploymentsChannel`, with its resolved subscriptions. */
+function collectCursorDeploymentTargets(runtimes, skipped) {
+    const targets = [];
+    for (const runtime of runtimes) {
+        for (const channel of runtime.project.channels) {
+            const options = getDeploymentsChannelOptions(channel.definition);
+            if (options === undefined) {
+                continue;
+            }
+            const subscriptions = resolveDeploymentSubscriptions(options);
+            if (subscriptions.length === 0) {
+                // Declared the channel but named no repositories — usually an unset
+                // env var. Say so rather than starting a relay that receives nothing.
+                skipped.push(`${runtime.slug || runtime.project.name}/${channel.id}`);
+                continue;
+            }
+            targets.push({ runtime, channelId: channel.id, options, subscriptions });
+        }
+    }
+    return targets;
+}
 /**
- * Automatic Cursor Slack relay for cursor-account Slack channels: registers
- * the mounted agents with `/v0/slack-events`, binds each channel's outbound
- * API transport to the backend proxy, and dispatches relayed envelopes into
- * the pack's normal inbound path. Requires a signed-in host — fail serve
- * fast rather than mounting channels that can never hear or speak.
+ * Cursor deployment-events relay: automatic when a mounted agent authored
+ * `deploymentsChannel({ ... })`. One relay per process reads
+ * `/v0/deployment-events` for the union of every channel's repositories, and
+ * each event is routed to the channels that asked for it — the same ownership
+ * `startCursorSlackRelay` and `startCursorEventRelay` have.
  */
+function startCursorDeploymentRelay(input) {
+    var _a;
+    const { options, runtimes, accountKey, logger } = input;
+    const skipped = [];
+    const targets = collectCursorDeploymentTargets(runtimes, skipped);
+    if (skipped.length > 0) {
+        logger(`[agent-sdk] deployment-events: no repositories declared on ${skipped.join(", ")}; those channels receive nothing`);
+    }
+    if (targets.length === 0) {
+        return undefined;
+    }
+    if (accountKey === undefined) {
+        throw new Error(`This project has channels subscribed to deployment events (deploymentsChannel({ repos })) but the host is not signed in to Cursor. ${SIGN_IN_HINT}`);
+    }
+    // Union across channels: one registration per repo for the whole process,
+    // however many channels named it. Per-channel environment and event-type
+    // filtering happens at dispatch.
+    const byRepo = new Map();
+    for (const target of targets) {
+        for (const subscription of target.subscriptions) {
+            const existing = byRepo.get(subscription.repo);
+            if (existing === undefined) {
+                byRepo.set(subscription.repo, {
+                    repo: subscription.repo,
+                    environments: [...subscription.environments],
+                    events: new Set(subscription.events),
+                });
+                continue;
+            }
+            for (const event of subscription.events)
+                existing.events.add(event);
+            // An empty environment list means "every environment", so it absorbs.
+            existing.environments =
+                existing.environments.length === 0 ||
+                    subscription.environments.length === 0
+                    ? []
+                    : [
+                        ...new Set([
+                            ...existing.environments,
+                            ...subscription.environments,
+                        ]),
+                    ];
+        }
+    }
+    // Same host split as scm-events and slack-events: `/v0/deployment-events/*`
+    // is on api.cursor.com, not api2.
+    const baseStateRoot = (_a = options.stateRoot) !== null && _a !== void 0 ? _a : join(targets[0].runtime.project.rootDir, ".agent-serve");
+    const relay = new DeploymentEventRelay({
+        baseUrl: cursorExternalApiUrl(),
+        apiKey: accountKey.apiKey,
+        stateDir: join(baseStateRoot, "deployment-events"),
+        subscriptions: [...byRepo.values()],
+        logger,
+        dispatch: (event) => __awaiter(this, void 0, void 0, function* () {
+            return fanOutDeploymentEvent({
+                event,
+                logger,
+                targets: targets.map((target) => ({
+                    name: `${target.runtime.slug || target.runtime.project.name}/${target.channelId}`,
+                    subscriptions: target.subscriptions,
+                    deliver: (delivered) => dispatchDeploymentEvent({
+                        options: target.options,
+                        event: delivered,
+                        args: buildChannelHandlerArgs({
+                            runtime: target.runtime,
+                            channelId: target.channelId,
+                        }),
+                    }),
+                })),
+            });
+        }),
+    });
+    relay.start();
+    logger(`[agent-sdk] deployment-events: relaying ${byRepo.size} repository subscription(s) to ${targets.length} channel(s)`);
+    return relay;
+}
 function startCursorSlackRelay(input) {
     return __awaiter(this, void 0, void 0, function* () {
         var _a;