@cursor/july 0.1.73 → 0.1.75

package/dist/internal/cli-skills.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cli-skills.d.ts","sourceRoot":"","sources":["../../src/internal/cli-skills.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAWH,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gFAAgF;IAChF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,MAAM,CAAC,CA4CjB"}
+{"version":3,"file":"cli-skills.d.ts","sourceRoot":"","sources":["../../src/internal/cli-skills.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAYH,MAAM,WAAW,uBAAuB;IACtC,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,gFAAgF;IAChF,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,gCAAgC;IAChC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC7B,GAAG,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAC9B;AAED,wBAAsB,gBAAgB,CACpC,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,MAAM,CAAC,CA4CjB"}

package/dist/internal/cli-skills.js

@@ -1,9 +1,11 @@
 /**
  * `install-skills` — install the package's coding-agent skills into
- * `~/.cursor/skills/agentkit/` without running `init`.
+ * `~/.cursor/skills/agentsdk/` without running `init`.
  *
  * Never prompts: running the command is the confirmation. The interactive
- * offer lives in `init`.
+ * offer lives in `init`. Consumer `npm install` / `npx` copies the same
+ * skills in postinstall (with `alwaysApply: true` so Cursor injects them);
+ * this command refreshes them without reinstalling.
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -15,7 +17,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { CLI_COMMAND_NAME } from "./distribution.js";
-import { formatSkillInstall, installCursorSkills, planSkillInstall, } from "./install-cursor-skills.js";
+import { formatSkillInstall, installCursorSkills, LEGACY_CURSOR_SKILLS_NAMESPACE, planSkillInstall, } from "./install-cursor-skills.js";
 import { stdoutPalette } from "./terminal-style.js";
 export function cmdInstallSkills() {
     return __awaiter(this, arguments, void 0, function* (options = {}) {
@@ -67,6 +69,9 @@ function previewBlock(plan) {
     if (plan.orphans.length > 0) {
         lines.push(`  removes:  ${plan.orphans.join(", ")}`);
     }
+    if (plan.hasLegacyNamespace) {
+        lines.push(`  removes:  ${LEGACY_CURSOR_SKILLS_NAMESPACE}/ (legacy namespace)`);
+    }
     lines.push(`  location: ${plan.directory}`);
     return `${lines.join("\n")}\n`;
 }

package/dist/internal/cursor-deployment-relay.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Pull relay for `/v0/deployment-events`.
+ *
+ * A {@link RelayAdapter} over {@link CursorRelayCore} — the same engine the
+ * GitHub SCM and Slack relays use, so registration heartbeats, durable
+ * offsets, backoff, and bounded dispatch retry are inherited rather than
+ * reimplemented. Only the subscribe/poll paths, the registration body, and
+ * the per-event filter differ.
+ */
+import type { DeploymentEvent, DeploymentEventType, DeploymentSubscription } from "../channels/deployments/types.js";
+/** One page entry: the event fields plus its stream offset, as the sibling
+ * providers spell it. */
+export type DeploymentRelayEvent = DeploymentEvent & {
+    offset: string;
+};
+export interface ResolvedSubscription {
+    repo: string;
+    environments: string[];
+    events: Set<DeploymentEventType>;
+}
+export interface DeploymentEventRelayOptions {
+    baseUrl: string;
+    apiKey: string;
+    stateDir: string;
+    subscriptions: readonly ResolvedSubscription[];
+    dispatch: (event: DeploymentEvent) => Promise<void>;
+    logger: (line: string) => void;
+    fetchImpl?: typeof fetch;
+    pollWaitMs?: number;
+}
+/** Normalize the channel's `repos` option into concrete subscriptions. */
+export declare function resolveDeploymentSubscriptions(options: {
+    repos: readonly (string | DeploymentSubscription)[];
+    environments?: readonly string[];
+    events?: readonly DeploymentEventType[];
+}): ResolvedSubscription[];
+/** Whether one confirmed subscription wants this event. */
+export declare function deploymentEventMatches(subscription: ResolvedSubscription, envelope: DeploymentEvent): boolean;
+/** One channel the host can deliver a deployment event to. */
+export interface DeploymentDispatchTarget {
+    /** Display name for logs, e.g. `executor/deployments`. */
+    name: string;
+    subscriptions: readonly ResolvedSubscription[];
+    deliver: (event: DeploymentEvent) => Promise<unknown>;
+}
+/**
+ * Deliver one event to every channel subscribed to it.
+ *
+ * Each channel is delivered independently: one channel's handler throwing
+ * must not skip the channels after it, because the relay core retries the
+ * whole dispatch and the channels that already ran would see the event twice.
+ * Throws only when every subscribed channel failed, so a retry cannot
+ * re-deliver to a channel that succeeded.
+ */
+export declare function fanOutDeploymentEvent(input: {
+    targets: readonly DeploymentDispatchTarget[];
+    event: DeploymentEvent;
+    logger: (line: string) => void;
+}): Promise<void>;
+export declare class DeploymentEventRelay {
+    private readonly options;
+    private readonly core;
+    private subscribed;
+    private readonly loggedSkippedRepos;
+    constructor(options: DeploymentEventRelayOptions);
+    /**
+     * Whether an event from this principal's stream belongs to THIS relay.
+     * The stream is per-principal, and one API key can back several relays
+     * (other hosts, or an agent running its own alongside the host's), so each
+     * one re-checks the events against the subscriptions the server confirmed
+     * for it.
+     */
+    private shouldDispatch;
+    start(): void;
+    stop(): Promise<void>;
+}
+//# sourceMappingURL=cursor-deployment-relay.d.ts.map

package/dist/internal/cursor-deployment-relay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor-deployment-relay.d.ts","sourceRoot":"","sources":["../../src/internal/cursor-deployment-relay.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,kCAAkC,CAAC;AAK1C;yBACyB;AACzB,MAAM,MAAM,oBAAoB,GAAG,eAAe,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAExE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,MAAM,EAAE,GAAG,CAAC,mBAAmB,CAAC,CAAC;CAClC;AAQD,MAAM,WAAW,2BAA2B;IAC1C,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC/C,QAAQ,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpD,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/B,SAAS,CAAC,EAAE,OAAO,KAAK,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,0EAA0E;AAC1E,wBAAgB,8BAA8B,CAAC,OAAO,EAAE;IACtD,KAAK,EAAE,SAAS,CAAC,MAAM,GAAG,sBAAsB,CAAC,EAAE,CAAC;IACpD,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,MAAM,CAAC,EAAE,SAAS,mBAAmB,EAAE,CAAC;CACzC,GAAG,oBAAoB,EAAE,CA6CzB;AAED,2DAA2D;AAC3D,wBAAgB,sBAAsB,CACpC,YAAY,EAAE,oBAAoB,EAClC,QAAQ,EAAE,eAAe,GACxB,OAAO,CAQT;AAED,8DAA8D;AAC9D,MAAM,WAAW,wBAAwB;IACvC,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,SAAS,oBAAoB,EAAE,CAAC;IAC/C,OAAO,EAAE,CAAC,KAAK,EAAE,eAAe,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACvD;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CAAC,KAAK,EAAE;IACjD,OAAO,EAAE,SAAS,wBAAwB,EAAE,CAAC;IAC7C,KAAK,EAAE,eAAe,CAAC;IACvB,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CAChC,GAAG,OAAO,CAAC,IAAI,CAAC,CA8BhB;AAED,qBAAa,oBAAoB;IAKnB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAJpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAwC;IAC7D,OAAO,CAAC,UAAU,CAA2C;IAC7D,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAqB;IAExD,YAA6B,OAAO,EAAE,2BAA2B,EAiEhE;IAED;;;;;;OAMG;IACH,OAAO,CAAC,cAAc;IAsBtB,KAAK,IAAI,IAAI,CAEZ;IAEK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAE1B;CACF"}

package/dist/internal/cursor-deployment-relay.js

@@ -0,0 +1,201 @@
+/**
+ * Pull relay for `/v0/deployment-events`.
+ *
+ * A {@link RelayAdapter} over {@link CursorRelayCore} — the same engine the
+ * GitHub SCM and Slack relays use, so registration heartbeats, durable
+ * offsets, backoff, and bounded dispatch retry are inherited rather than
+ * reimplemented. Only the subscribe/poll paths, the registration body, and
+ * the per-event filter differ.
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __rest = (this && this.__rest) || function (s, e) {
+    var t = {};
+    for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
+        t[p] = s[p];
+    if (s != null && typeof Object.getOwnPropertySymbols === "function")
+        for (var i = 0, p = Object.getOwnPropertySymbols(s); i < p.length; i++) {
+            if (e.indexOf(p[i]) < 0 && Object.prototype.propertyIsEnumerable.call(s, p[i]))
+                t[p[i]] = s[p[i]];
+        }
+    return t;
+};
+import { CursorRelayCore } from "./cursor-relay-core.js";
+const DEFAULT_EVENTS = ["deployment.succeeded"];
+/** Normalize the channel's `repos` option into concrete subscriptions. */
+export function resolveDeploymentSubscriptions(options) {
+    var _a, _b, _c, _d;
+    const byRepo = new Map();
+    for (const entry of options.repos) {
+        const subscription = typeof entry === "string" ? { repo: entry } : entry;
+        // Case-folded only: `Deployment.repository` has no documented format, and
+        // the server keys subscriptions the same way.
+        const repo = subscription.repo.trim().toLowerCase();
+        if (repo === "") {
+            throw new Error(`deploymentsChannel: invalid repo "${subscription.repo}".`);
+        }
+        const environments = [
+            ...new Set(((_b = (_a = subscription.environments) !== null && _a !== void 0 ? _a : options.environments) !== null && _b !== void 0 ? _b : [])
+                .map((value) => value.trim())
+                .filter(Boolean)),
+        ];
+        const events = new Set((_d = (_c = subscription.events) !== null && _c !== void 0 ? _c : options.events) !== null && _d !== void 0 ? _d : DEFAULT_EVENTS);
+        if (events.size === 0) {
+            throw new Error(`deploymentsChannel: repo "${repo}" subscribes to no events.`);
+        }
+        // Later entries for the same repo widen the earlier one rather than
+        // silently replacing it.
+        const existing = byRepo.get(repo);
+        if (existing === undefined) {
+            byRepo.set(repo, { repo, environments, events });
+            continue;
+        }
+        for (const event of events)
+            existing.events.add(event);
+        existing.environments =
+            existing.environments.length === 0 || environments.length === 0
+                ? []
+                : [...new Set([...existing.environments, ...environments])];
+    }
+    // Empty is legal here and means "this channel wants nothing", which is how
+    // an env-configured channel stays inert without a repo list. The wire-level
+    // empty list means deregister, so the host simply never registers it.
+    return [...byRepo.values()];
+}
+/** Whether one confirmed subscription wants this event. */
+export function deploymentEventMatches(subscription, envelope) {
+    if (!subscription.events.has(envelope.eventType)) {
+        return false;
+    }
+    return (subscription.environments.length === 0 ||
+        subscription.environments.includes(envelope.environment));
+}
+/**
+ * Deliver one event to every channel subscribed to it.
+ *
+ * Each channel is delivered independently: one channel's handler throwing
+ * must not skip the channels after it, because the relay core retries the
+ * whole dispatch and the channels that already ran would see the event twice.
+ * Throws only when every subscribed channel failed, so a retry cannot
+ * re-deliver to a channel that succeeded.
+ */
+export function fanOutDeploymentEvent(input) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const { event, logger } = input;
+        const matched = input.targets.filter((target) => target.subscriptions.some((subscription) => subscription.repo === event.repo &&
+            deploymentEventMatches(subscription, event)));
+        const failures = [];
+        for (const target of matched) {
+            try {
+                yield target.deliver(event);
+            }
+            catch (error) {
+                failures.push(target.name);
+                logger(`[agent-sdk] deployment-events: ${target.name} failed on ${event.eventId}: ${error instanceof Error ? error.message : String(error)}`);
+            }
+        }
+        logger(`[agent-sdk] deployment-events: ${event.eventType} ${event.repo}@${event.sha} (${event.environment}) → ${matched.length - failures.length}/${matched.length} channel(s)`);
+        if (failures.length > 0 && failures.length === matched.length) {
+            throw new Error(`deployment-events: every subscribed channel failed on ${event.eventId} (${failures.join(", ")})`);
+        }
+    });
+}
+export class DeploymentEventRelay {
+    constructor(options) {
+        this.options = options;
+        this.subscribed = new Map();
+        this.loggedSkippedRepos = new Set();
+        const adapter = {
+            logPrefix: "deployment-events",
+            subscribePath: "/v0/deployment-events/subscriptions",
+            pollPath: "/v0/deployment-events",
+            buildRegistrationBody: (consumerId) => ({
+                consumerId,
+                subscriptions: options.subscriptions.map((subscription) => ({
+                    repo: subscription.repo,
+                    environments: subscription.environments,
+                    events: [...subscription.events],
+                })),
+            }),
+            // Empty subscriptions drop this consumer's registration on clean stop
+            // instead of leaving it to lapse by TTL.
+            buildDeregistrationBody: (consumerId) => ({
+                consumerId,
+                subscriptions: [],
+            }),
+            applyRegistrationResponse: (json) => {
+                var _a, _b;
+                const result = json;
+                this.subscribed = new Map();
+                this.loggedSkippedRepos.clear();
+                const lines = [];
+                const confirmed = [];
+                for (const status of (_a = result.repos) !== null && _a !== void 0 ? _a : []) {
+                    const wanted = options.subscriptions.find((subscription) => subscription.repo === status.repo);
+                    if (!status.isSubscribed || wanted === undefined) {
+                        lines.push(`not subscribed to ${status.repo}: ${(_b = status.detail) !== null && _b !== void 0 ? _b : "unknown reason"}`);
+                        continue;
+                    }
+                    this.subscribed.set(status.repo, wanted);
+                    confirmed.push(status.repo);
+                }
+                if (confirmed.length > 0) {
+                    const kinds = [
+                        ...new Set(options.subscriptions.flatMap((s) => [...s.events])),
+                    ];
+                    lines.push(`subscribed to ${confirmed.join(", ")} for events: ${kinds.join(", ")}`);
+                }
+                return lines;
+            },
+            shouldDispatch: (event) => this.shouldDispatch(event),
+            dispatch: (_a) => {
+                var { offset: _offset } = _a, envelope = __rest(_a, ["offset"]);
+                return options.dispatch(envelope);
+            },
+        };
+        this.core = new CursorRelayCore(Object.assign(Object.assign({ baseUrl: options.baseUrl, apiKey: options.apiKey, stateDir: options.stateDir, adapter, logger: options.logger }, (options.fetchImpl === undefined
+            ? {}
+            : { fetchImpl: options.fetchImpl })), (options.pollWaitMs === undefined
+            ? {}
+            : { pollWaitMs: options.pollWaitMs })));
+    }
+    /**
+     * Whether an event from this principal's stream belongs to THIS relay.
+     * The stream is per-principal, and one API key can back several relays
+     * (other hosts, or an agent running its own alongside the host's), so each
+     * one re-checks the events against the subscriptions the server confirmed
+     * for it.
+     */
+    shouldDispatch(event) {
+        const envelope = event;
+        if (envelope === null ||
+            typeof envelope !== "object" ||
+            typeof envelope.repo !== "string") {
+            return false;
+        }
+        const subscription = this.subscribed.get(envelope.repo);
+        if (subscription === undefined) {
+            if (!this.loggedSkippedRepos.has(envelope.repo)) {
+                this.loggedSkippedRepos.add(envelope.repo);
+                this.options.logger(`[agent-sdk] deployment-events: skipping events for ${envelope.repo}: not in this host's subscription (another consumer of this API key likely subscribed it)`);
+            }
+            return false;
+        }
+        return deploymentEventMatches(subscription, envelope);
+    }
+    start() {
+        this.core.start();
+    }
+    stop() {
+        return __awaiter(this, void 0, void 0, function* () {
+            yield this.core.stop();
+        });
+    }
+}

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

@@ -1 +1 @@
-{"version":3,"file":"distribution.d.ts","sourceRoot":"","sources":["../../src/internal/distribution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,sEAAsE;AACtE,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,2BAA2B,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,WAAW,cAAc,CAAC;AACvC,eAAO,MAAM,UAAU,EAAE,MAA2B,CAAC;AACrD,eAAO,MAAM,gBAAgB,EAAE,MAAiC,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAA+B,CAAC;AAc/D;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAGhD;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,kEAAkE;AAClE,wBAAgB,cAAc,IAAI,MAAM,CAOvC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAC/C,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CA2BzC,CAAC"}
+{"version":3,"file":"distribution.d.ts","sourceRoot":"","sources":["../../src/internal/distribution.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,sEAAsE;AACtE,eAAO,MAAM,YAAY,iBAAiB,CAAC;AAE3C,6EAA6E;AAC7E,eAAO,MAAM,mBAAmB,2BAA2B,CAAC;AAE5D;;;GAGG;AACH,eAAO,MAAM,qBAAqB,qBAAqB,CAAC;AAExD;;;GAGG;AACH,eAAO,MAAM,WAAW,cAAc,CAAC;AACvC,eAAO,MAAM,UAAU,EAAE,MAA2B,CAAC;AACrD,eAAO,MAAM,gBAAgB,EAAE,MAAiC,CAAC;AAEjE;;;GAGG;AACH,eAAO,MAAM,gBAAgB,EAAE,MAA+B,CAAC;AAc/D;;;;;GAKG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAGhD;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,kEAAkE;AAClE,wBAAgB,cAAc,IAAI,MAAM,CAOvC;AAED;;;;;;GAMG;AACH,eAAO,MAAM,qBAAqB,EAAE,aAAa,CAC/C,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CA4BzC,CAAC"}

package/dist/internal/distribution.js

@@ -81,6 +81,7 @@ export const AUTHORING_ENTRY_FILES = [
     ["channels/slack", "channels/slack/index.js"],
     ["channels/github", "channels/github/index.js"],
     ["channels/origin", "channels/origin/index.js"],
+    ["channels/deployments", "channels/deployments/index.js"],
     ["skills", "skills.js"],
     ["schedules", "schedules.js"],
     ["reminders", "reminders.js"],

package/dist/internal/install-cursor-skills.d.ts

@@ -1,35 +1,58 @@
 /**
  * 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`.
  */
 /** Category folder under ~/.cursor/skills (Cursor discovers nested skills). */
-export declare const CURSOR_SKILLS_NAMESPACE = "agentkit";
+export declare const CURSOR_SKILLS_NAMESPACE = "agentsdk";
+/** Pre-rename install folder. Install deletes this so `/agentkit-*` rows disappear. */
+export declare const LEGACY_CURSOR_SKILLS_NAMESPACE = "agentkit";
 /** How long the `init` offer waits for an answer before skipping the install. */
 export declare 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 declare const CURSOR_JULY_SKILLS_HOME_ENV = "CURSOR_JULY_SKILLS_HOME";
+/** Set to `1` to skip the postinstall skill copy. */
+export declare const CURSOR_JULY_SKIP_SKILL_INSTALL_ENV = "CURSOR_JULY_SKIP_SKILL_INSTALL";
 export interface PackageSkill {
-    /** Frontmatter `name` (e.g. agentkit-create-agent). */
+    /** Frontmatter `name` (e.g. agentsdk-create-agent). */
     name: string;
-    /** Leaf install directory under agentkit/ (e.g. create-agent). */
+    /** Leaf install directory under agentsdk/ (e.g. create-agent). */
     leafDir: string;
     /** Absolute path to the source skill directory in the package. */
     sourceDir: string;
 }
 export declare function cursorSkillsHome(home?: string): string;
-/** `~/.cursor/skills/agentkit` — where package skills are installed. */
-export declare function agentkitCursorSkillsDir(skillsHome?: string): string;
-/** Absolute install path for one skill: `…/agentkit/<leafDir>`. */
+/**
+ * True when this package root is an installed copy under `node_modules`
+ * (npm, pnpm, yarn, npx, global), not the everysphere source checkout.
+ */
+export declare function isConsumerPackageInstall(packageRoot: string): boolean;
+/** `~/.cursor/skills/agentsdk` — where package skills are installed. */
+export declare function agentsdkCursorSkillsDir(skillsHome?: string): string;
+/** Pre-rename `~/.cursor/skills/agentkit`. */
+export declare function legacyAgentkitCursorSkillsDir(skillsHome?: string): string;
+/** Absolute install path for one skill: `…/agentsdk/<leafDir>`. */
 export declare function skillInstallPath(skill: Pick<PackageSkill, "leafDir">, skillsHome?: string): string;
 /**
  * Skills shipped next to the running package. Uses the frontmatter `name`
- * when present, otherwise `agentkit-<dir>`.
+ * when present, otherwise `agentsdk-<dir>`.
  */
 export declare function listShippedPackageSkills(packageRoot?: string): Promise<PackageSkill[]>;
 /**
- * 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).
  */
@@ -42,20 +65,27 @@ export interface SkillInstallResult {
     installed: string[];
     /** Leaf dirs deleted because the package no longer ships them. */
     removed: string[];
+    /** True when leftover `~/.cursor/skills/agentkit` was deleted. */
+    removedLegacyNamespace: boolean;
 }
 /**
- * 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 declare function installCursorSkills(skills: readonly PackageSkill[], skillsHome?: string): Promise<SkillInstallResult>;
-/** Drop monorepo `paths` globs and fix package doc links for ~/.cursor installs. */
+/**
+ * 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 declare function prepareSkillMarkdownForCursorInstall(content: string): string;
 export interface SkillInstallPlan {
     shipped: PackageSkill[];
     /** Resolved `~/.cursor/skills`, to install into. */
     skillsHome: string;
-    /** Install target: `<skillsHome>/agentkit`. */
+    /** Install target: `<skillsHome>/agentsdk`. */
     directory: string;
     /** Leaf dirs the package ships. */
     leaves: string[];
@@ -63,6 +93,8 @@ export interface SkillInstallPlan {
     firstInstall: boolean;
     /** Installed leaf dirs the package dropped; installing deletes them. */
     orphans: string[];
+    /** True when leftover `skillsHome/agentkit` still exists. */
+    hasLegacyNamespace: boolean;
 }
 /** What an install would do, for the offer and for `install-skills`. */
 export declare function planSkillInstall(options?: {
@@ -71,6 +103,29 @@ export declare function planSkillInstall(options?: {
 }): Promise<SkillInstallPlan>;
 /** `Installed 9 Agent SDK skills`, what it dropped, and where it went. */
 export declare function formatSkillInstall(plan: SkillInstallPlan, result: SkillInstallResult): string;
+export type PackageInstallSkillSyncResult = {
+    status: "installed";
+    installed: string[];
+    removed: string[];
+} | {
+    status: "skipped";
+    reason: "opt-out" | "not-consumer" | "no-skills" | "error";
+};
+export interface SyncCursorSkillsOnPackageInstallOptions {
+    packageRoot?: string;
+    skillsHome?: string;
+    env?: NodeJS.ProcessEnv;
+    /** Override the node_modules consumer check. */
+    consumer?: boolean;
+    out?: (text: string) => void;
+}
+/**
+ * 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 declare function syncCursorSkillsOnPackageInstall(options?: SyncCursorSkillsOnPackageInstallOptions): Promise<PackageInstallSkillSyncResult>;
 export interface OfferInstallCursorSkillsOptions {
     /** Skip when false (non-TTY / `--json`). */
     interactive?: boolean;
@@ -82,7 +137,7 @@ export interface OfferInstallCursorSkillsOptions {
 }
 /**
  * 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`.
  */

package/dist/internal/install-cursor-skills.d.ts.map

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