@cursor/july 0.1.107 → 0.1.109

package/dist/internal/hosted-execution-diag.js

@@ -15,7 +15,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 import { createHash, randomBytes } from "node:crypto";
 import { mkdir, rename, unlink, writeFile } from "node:fs/promises";
 import { join } from "node:path";
-import { HOSTED_EXECUTION_DIAG_FILENAME } from "./hosted-delivery-protocol.js";
+import { HOSTED_EXECUTION_DIAG_FILENAME, parseHostedFailureClassification, } from "./hosted-delivery-protocol.js";
 export const HOSTED_EXECUTION_DIAG_VERSION = 1;
 /** Cap so a runaway message cannot fill the guest disk or the host log. */
 export const HOSTED_EXECUTION_DIAG_MAX_BYTES = 4096;
@@ -49,6 +49,8 @@ const DIAG_KEYS = new Set([
     "signalAborted",
     "requestId",
     "abortReason",
+    "failureCode",
+    "classification",
 ]);
 const ABORT_REASONS = new Set([
     "signal_abort",
@@ -101,12 +103,12 @@ export function hostedErrorStackSnippet(error) {
 export function hostedExecutionDiagPath(stateRoot) {
     return join(stateRoot, HOSTED_EXECUTION_DIAG_FILENAME);
 }
-export function abortReasonFromTurnStatus(status, message) {
+export function abortReasonFromTurnStatus(status, cancellationReason) {
     if (status === "finished") {
         return undefined;
     }
     if (status === "cancelled") {
-        return message !== undefined && /abort/i.test(message)
+        return cancellationReason === "signal"
             ? "signal_abort"
             : "runner_cancelled";
     }
@@ -153,6 +155,13 @@ export function parseHostedExecutionDiag(raw) {
     const message = boundedOptionalString(body.message, 1024);
     const stack = boundedOptionalString(body.stack, HOSTED_ERROR_SNIPPET_MAX_CHARS);
     const requestId = boundedOptionalString(body.requestId, 128);
+    const failureCode = boundedOptionalString(body.failureCode, 64);
+    const classification = body.classification === undefined
+        ? undefined
+        : parseHostedFailureClassification(body.classification);
+    if (body.classification !== undefined && classification === undefined) {
+        return undefined;
+    }
     const abortReason = body.abortReason === undefined
         ? undefined
         : typeof body.abortReason === "string" &&
@@ -166,7 +175,7 @@ export function parseHostedExecutionDiag(raw) {
         typeof body.signalAborted !== "boolean") {
         return undefined;
     }
-    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ v: HOSTED_EXECUTION_DIAG_VERSION, executionId: body.executionId, writtenAt: body.writtenAt, sessionPublicId: body.sessionPublicId, sessionId: body.sessionId, turnStatus: body.turnStatus, durationMs: body.durationMs }, (message === undefined ? {} : { message })), (stack === undefined ? {} : { stack })), (body.signalAborted === true ? { signalAborted: true } : {})), (requestId === undefined ? {} : { requestId })), (abortReason === undefined ? {} : { abortReason }));
+    return Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ v: HOSTED_EXECUTION_DIAG_VERSION, executionId: body.executionId, writtenAt: body.writtenAt, sessionPublicId: body.sessionPublicId, sessionId: body.sessionId, turnStatus: body.turnStatus, durationMs: body.durationMs }, (message === undefined ? {} : { message })), (stack === undefined ? {} : { stack })), (body.signalAborted === true ? { signalAborted: true } : {})), (requestId === undefined ? {} : { requestId })), (abortReason === undefined ? {} : { abortReason })), (failureCode === undefined ? {} : { failureCode })), (classification === undefined ? {} : { classification }));
 }
 /**
  * Overwrite the per-execution diag file. Soft-fail: a write error must not

package/dist/internal/hosted-execution-flush.d.ts

@@ -8,6 +8,7 @@
  * durable document and re-snapshots the tee; the local json stays `running`
  * so TAS does not treat a previous delivery's terminal record as this one.
  */
+import type { HostedFailureClassification } from "./hosted-delivery-protocol.js";
 import { type HostedExecutionDiagAbortReason } from "./hosted-execution-diag.js";
 import type { LogRingEntry } from "./log-ring.js";
 import { type SessionRunAbortReason, type SessionRunExecutionWrite } from "./session-run-log.js";
@@ -26,6 +27,8 @@ export type HostedExecutionFlushFields = {
     durationMs: number;
     message?: string;
     abortReason?: HostedExecutionDiagAbortReason;
+    failureCode?: string;
+    classification?: HostedFailureClassification;
     error?: unknown;
 };
 /**

package/dist/internal/hosted-execution-flush.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hosted-execution-flush.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-execution-flush.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EACL,KAAK,8BAA8B,EAGpC,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAG9B,MAAM,sBAAsB,CAAC;AAU9B,MAAM,MAAM,yBAAyB,GAAG;IACtC,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,aAAa,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,YAAY,CAAC,IAAI,YAAY,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,8BAA8B,CAAC;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,yBAAyB,EAChC,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,IAAI,CAAC,CA0Df;AAED;;GAEG;AACH,wBAAsB,gCAAgC,CAAC,IAAI,EAAE;IAC3D,iBAAiB,EAAE,CACjB,MAAM,EAAE,OAAO,CACb,qBAAqB,EACrB,cAAc,GAAG,oBAAoB,GAAG,qBAAqB,CAC9D,EACD,KAAK,CAAC,EAAE,OAAO,KACZ,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CACb,qBAAqB,EACrB,cAAc,GAAG,oBAAoB,GAAG,qBAAqB,CAC9D,CAAC;IACF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhB"}
+{"version":3,"file":"hosted-execution-flush.d.ts","sourceRoot":"","sources":["../../src/internal/hosted-execution-flush.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AACjF,OAAO,EACL,KAAK,8BAA8B,EAGpC,MAAM,4BAA4B,CAAC;AACpC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EACL,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAG9B,MAAM,sBAAsB,CAAC;AAU9B,MAAM,MAAM,yBAAyB,GAAG;IACtC,mEAAmE;IACnE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,CAAC,CAAC,KAAK,EAAE,wBAAwB,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnE,aAAa,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClD,YAAY,CAAC,IAAI,YAAY,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,0BAA0B,GAAG;IACvC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,8BAA8B,CAAC;IAC7C,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,2BAA2B,CAAC;IAC7C,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,yBAAyB,EAChC,MAAM,EAAE,0BAA0B,GACjC,OAAO,CAAC,IAAI,CAAC,CA0Df;AAED;;GAEG;AACH,wBAAsB,gCAAgC,CAAC,IAAI,EAAE;IAC3D,iBAAiB,EAAE,CACjB,MAAM,EAAE,OAAO,CACb,qBAAqB,EACrB,cAAc,GAAG,oBAAoB,GAAG,qBAAqB,CAC9D,EACD,KAAK,CAAC,EAAE,OAAO,KACZ,OAAO,CAAC,IAAI,CAAC,CAAC;IACnB,aAAa,CAAC,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,OAAO,CACb,qBAAqB,EACrB,cAAc,GAAG,oBAAoB,GAAG,qBAAqB,CAC9D,CAAC;IACF,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhB"}

package/dist/internal/hosted-execution-flush.js

@@ -39,11 +39,9 @@ export function flushHostedExecutionRecord(sinks, fields) {
             ? undefined
             : hostedErrorStackSnippet(fields.error);
         if (sinks.stateRoot !== undefined) {
-            yield writeHostedExecutionDiag(sinks.stateRoot, Object.assign(Object.assign(Object.assign(Object.assign({ v: 1, executionId: fields.executionId, writtenAt, sessionPublicId: fields.sessionPublicId, sessionId: fields.sessionId, turnStatus: fields.turnStatus, durationMs: fields.durationMs }, (message === undefined ? {} : { message })), (stack === undefined || stack.length === 0 ? {} : { stack })), (message !== undefined && /abort/i.test(message)
-                ? { signalAborted: true }
-                : {})), (fields.abortReason === undefined
+            yield writeHostedExecutionDiag(sinks.stateRoot, Object.assign(Object.assign(Object.assign(Object.assign(Object.assign({ v: 1, executionId: fields.executionId, writtenAt, sessionPublicId: fields.sessionPublicId, sessionId: fields.sessionId, turnStatus: fields.turnStatus, durationMs: fields.durationMs }, (message === undefined ? {} : { message })), (stack === undefined || stack.length === 0 ? {} : { stack })), { signalAborted: fields.abortReason === "signal_abort" ? true : undefined }), (fields.abortReason === undefined
                 ? {}
-                : { abortReason: fields.abortReason })));
+                : { abortReason: fields.abortReason })), { failureCode: fields.failureCode, classification: fields.classification }));
         }
         if (sinks.persistSessionRun !== undefined) {
             const error = fields.error === undefined

package/dist/internal/http-control-plane-session.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Built-in HTTP channel admission for control-plane session starts.
+ *
+ * `agent-sdk run --prod` reaches the authenticated CP start route, which
+ * delivers `agentsdk.session` to the built-in `http` channel of every v2
+ * agent. The wake is `send(message, { dryRun, asOf })`; the session id, when
+ * the caller resumed an explicit `ses_…`, arrives through the hosted
+ * execution (never through this payload), so authored code cannot pick one.
+ */
+import type { ChannelHandlerArgs, HttpChannelDefinition } from "../types.js";
+export type ControlPlaneSessionPayload = {
+    message: string;
+    dryRun?: boolean | undefined;
+    asOf?: string | undefined;
+};
+export declare function parseControlPlaneSessionPayload(payload: unknown): {
+    ok: true;
+    data: ControlPlaneSessionPayload;
+} | {
+    ok: false;
+    error: string;
+};
+export declare function dispatchHttpControlPlaneSession(input: {
+    eventType: string;
+    payload: unknown;
+    args: ChannelHandlerArgs;
+    onMessage?: HttpChannelDefinition["onMessage"];
+}): Promise<Response>;
+export declare function attachHttpControlPlaneAdmission(definition: HttpChannelDefinition): void;
+//# sourceMappingURL=http-control-plane-session.d.ts.map

package/dist/internal/http-control-plane-session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-control-plane-session.d.ts","sourceRoot":"","sources":["../../src/internal/http-control-plane-session.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAQ7E,MAAM,MAAM,0BAA0B,GAAG;IACvC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B,CAAC;AASF,wBAAgB,+BAA+B,CAC7C,OAAO,EAAE,OAAO,GAEd;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,0BAA0B,CAAA;CAAE,GAC9C;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CA6B/B;AAED,wBAAsB,+BAA+B,CAAC,KAAK,EAAE;IAC3D,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,kBAAkB,CAAC;IACzB,SAAS,CAAC,EAAE,qBAAqB,CAAC,WAAW,CAAC,CAAC;CAChD,GAAG,OAAO,CAAC,QAAQ,CAAC,CAiBpB;AAED,wBAAgB,+BAA+B,CAC7C,UAAU,EAAE,qBAAqB,GAChC,IAAI,CAWN"}

package/dist/internal/http-control-plane-session.js

@@ -0,0 +1,83 @@
+/**
+ * Built-in HTTP channel admission for control-plane session starts.
+ *
+ * `agent-sdk run --prod` reaches the authenticated CP start route, which
+ * delivers `agentsdk.session` to the built-in `http` channel of every v2
+ * agent. The wake is `send(message, { dryRun, asOf })`; the session id, when
+ * the caller resumed an explicit `ses_…`, arrives through the hosted
+ * execution (never through this payload), so authored code cannot pick one.
+ */
+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());
+    });
+};
+import { skipped, turnStarted } from "./channel-dispatch.js";
+import { attachHostedAdmissionAdapter } from "./hosted-admission-adapter.js";
+import { AGENT_SDK_HTTP_CHANNEL_KIND, AGENT_SDK_SESSION_EVENT_TYPE, } from "./hosted-catch-protocol.js";
+const PAYLOAD_KEYS = new Set(["message", "dryRun", "asOf"]);
+const MAX_MESSAGE_CHARS = 64 * 1024;
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+export function parseControlPlaneSessionPayload(payload) {
+    if (!isRecord(payload)) {
+        return { ok: false, error: "payload must be an object" };
+    }
+    if (Object.keys(payload).some((key) => !PAYLOAD_KEYS.has(key))) {
+        return { ok: false, error: "payload carries an unsupported field" };
+    }
+    const message = typeof payload.message === "string" ? payload.message.trim() : "";
+    if (message.length === 0 || message.length > MAX_MESSAGE_CHARS) {
+        return { ok: false, error: "payload.message is required" };
+    }
+    if (payload.dryRun !== undefined && typeof payload.dryRun !== "boolean") {
+        return { ok: false, error: "payload.dryRun must be a boolean" };
+    }
+    if (payload.asOf !== undefined &&
+        (typeof payload.asOf !== "string" || payload.asOf.trim().length === 0)) {
+        return { ok: false, error: "payload.asOf must be a non-empty string" };
+    }
+    return {
+        ok: true,
+        data: {
+            message,
+            dryRun: payload.dryRun === true ? true : undefined,
+            asOf: typeof payload.asOf === "string" ? payload.asOf.trim() : undefined,
+        },
+    };
+}
+export function dispatchHttpControlPlaneSession(input) {
+    return __awaiter(this, void 0, void 0, function* () {
+        if (input.eventType !== AGENT_SDK_SESSION_EVENT_TYPE) {
+            return skipped("not a control-plane session");
+        }
+        const parsed = parseControlPlaneSessionPayload(input.payload);
+        if (!parsed.ok) {
+            return Response.json({ ok: false, error: parsed.error }, { status: 400 });
+        }
+        const message = input.onMessage === undefined
+            ? parsed.data.message
+            : yield input.onMessage(parsed.data.message, { auth: null });
+        const session = yield input.args.send(message, {
+            dryRun: parsed.data.dryRun,
+            asOf: parsed.data.asOf,
+        });
+        return turnStarted(session);
+    });
+}
+export function attachHttpControlPlaneAdmission(definition) {
+    attachHostedAdmissionAdapter(definition, {
+        kind: AGENT_SDK_HTTP_CHANNEL_KIND,
+        dispatch: ({ eventType, payload, args }) => dispatchHttpControlPlaneSession({
+            eventType,
+            payload,
+            args,
+            onMessage: definition.onMessage,
+        }),
+    });
+}

package/dist/internal/init-scaffold.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init-scaffold.d.ts","sourceRoot":"","sources":["../../src/internal/init-scaffold.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,eAAO,MAAM,SAAS,EAAE,MAOZ,CAAC;AA4Cb,eAAO,MAAM,SAAS,EAAE,MAOvB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAyC7C;AAuDD,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,EACpE,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAUf"}
+{"version":3,"file":"init-scaffold.d.ts","sourceRoot":"","sources":["../../src/internal/init-scaffold.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,eAAO,MAAM,SAAS,EAAE,MAOZ,CAAC;AA2Cb,eAAO,MAAM,SAAS,EAAE,MAOvB,CAAC;AAEF,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAyC7C;AAuDD,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,EACpE,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,IAAI,CAAC,CAUf"}

package/dist/internal/init-scaffold.js

@@ -26,7 +26,6 @@ const EMPTY_DIRS = [
     "agent/subagents",
     "agent/channels",
     "agent/hooks",
-    "agent/ab",
     "agent/schedules",
     "agent/sandbox/workspace",
     "agent/lib",
@@ -103,7 +102,7 @@ Run the CLI under Node, never Bun.
 ## Pointers
 
 - Package loop: \`node_modules/${PACKAGE_NAME}/AGENTS.md\`
-- Skills: \`node_modules/${PACKAGE_NAME}/skills/\` (\`create-agent\`, \`evals\`, \`hillclimb\`, \`debug\`)
+- Skills: \`node_modules/${PACKAGE_NAME}/skills/\` (\`create-agent\`, \`deploy\`, \`evals\`, \`hillclimb\`, \`debug\`)
 - Docs: \`npx ${PACKAGE_NAME} docs\`
 - LLM docs index: \`node_modules/${PACKAGE_NAME}/dist/docs/llms.txt\`
 `;

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

@@ -33,6 +33,8 @@ export interface PackageSkill {
     leafDir: string;
     /** Absolute path to the source skill directory in the package. */
     sourceDir: string;
+    /** Exact package version that supplied this skill. */
+    packageVersion: string;
 }
 export declare function cursorSkillsHome(home?: string): string;
 /**
@@ -78,9 +80,10 @@ export interface SkillInstallResult {
 export declare function installCursorSkills(skills: readonly PackageSkill[], skillsHome?: string): Promise<SkillInstallResult>;
 /**
  * Drop monorepo `paths` globs, set `alwaysApply: true` so Cursor injects the
- * body as a global rule, and fix package doc links for ~/.cursor installs.
+ * body as a global rule, bind package commands to the installing version, and
+ * fix package doc links for ~/.cursor installs.
  */
-export declare function prepareSkillMarkdownForCursorInstall(content: string): string;
+export declare function prepareSkillMarkdownForCursorInstall(content: string, packageVersion?: string): string;
 export interface SkillInstallPlan {
     shipped: PackageSkill[];
     /** Resolved `~/.cursor/skills`, to install into. */

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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"}

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

@@ -87,6 +87,7 @@ export function listShippedPackageSkills() {
         catch (_a) {
             return [];
         }
+        const packageVersion = yield readPackageVersion(packageRoot);
         const skills = [];
         for (const entry of entries) {
             if (!entry.isDirectory()) {
@@ -103,12 +104,23 @@ export function listShippedPackageSkills() {
             const raw = yield readFile(skillMd, "utf8");
             const name = parseFrontmatter(raw).data.name ||
                 `${CURSOR_SKILLS_NAMESPACE}-${entry.name}`;
-            skills.push({ name, leafDir: entry.name, sourceDir });
+            skills.push({ name, leafDir: entry.name, sourceDir, packageVersion });
         }
         skills.sort((a, b) => a.leafDir.localeCompare(b.leafDir));
         return skills;
     });
 }
+const PACKAGE_VERSION_PLACEHOLDER = "__CURSOR_JULY_VERSION__";
+function readPackageVersion(packageRoot) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const raw = yield readFile(join(packageRoot, "package.json"), "utf8");
+        const manifest = JSON.parse(raw);
+        if (typeof manifest.version !== "string" || manifest.version.trim() === "") {
+            throw new Error("The @cursor/july package must declare a version.");
+        }
+        return manifest.version;
+    });
+}
 /**
  * Skills that do not yet have a SKILL.md under ~/.cursor/skills/agentsdk/.
  * Install still overwrites every shipped skill when the user confirms — this
@@ -157,7 +169,7 @@ export function installCursorSkills(skills_1) {
             yield makeTreeWritable(target);
             const skillMdPath = join(target, "SKILL.md");
             const raw = yield readFile(skillMdPath, "utf8");
-            const adjusted = prepareSkillMarkdownForCursorInstall(raw);
+            const adjusted = prepareSkillMarkdownForCursorInstall(raw, skill.packageVersion);
             if (adjusted !== raw) {
                 yield writeFile(skillMdPath, adjusted, "utf8");
             }
@@ -234,9 +246,10 @@ function hasLegacyCursorSkillsNamespace(skillsHome) {
 }
 /**
  * Drop monorepo `paths` globs, set `alwaysApply: true` so Cursor injects the
- * body as a global rule, and fix package doc links for ~/.cursor installs.
+ * body as a global rule, bind package commands to the installing version, and
+ * fix package doc links for ~/.cursor installs.
  */
-export function prepareSkillMarkdownForCursorInstall(content) {
+export function prepareSkillMarkdownForCursorInstall(content, packageVersion) {
     var _a;
     const match = /^---\r?\n([\s\S]*?)\r?\n---/.exec(content);
     if (match === null) {
@@ -245,7 +258,14 @@ export function prepareSkillMarkdownForCursorInstall(content) {
     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}`;
+    if (adjustedBody.includes(PACKAGE_VERSION_PLACEHOLDER) &&
+        (packageVersion === undefined || packageVersion.trim() === "")) {
+        throw new Error("Cannot install an Agent SDK skill without a package version.");
+    }
+    const versionBoundBody = packageVersion === undefined
+        ? adjustedBody
+        : adjustedBody.replaceAll(PACKAGE_VERSION_PLACEHOLDER, packageVersion);
+    return `---\n${frontmatter.trimEnd()}\n---${versionBoundBody}`;
 }
 function stripPathsFromFrontmatter(frontmatter) {
     var _a, _b;

package/dist/internal/legacy-command-guard.d.ts

@@ -0,0 +1,22 @@
+import { type AgentServeDeployClient, DeployApiError } from "./deploy-client.js";
+/**
+ * Classify a hosted slug by probing the v2 control plane.
+ *
+ * Only HTTP 404 means “not v2.” Auth, 5xx, and transport errors fail closed
+ * so a v2 slug cannot fall through to `/internal/agent-serve`. That probe
+ * shares the factory microlith path used by secrets; a factory outage will
+ * also block legacy `--prod` until it recovers.
+ */
+export declare function deploymentArchitecture(args: {
+    client: AgentServeDeployClient;
+    teamId: number;
+    slug: string;
+}): Promise<"v1" | "v2">;
+export declare function unsupportedV2LegacyCommandError(slug: string): DeployApiError;
+export declare function isUnsupportedV2LegacyCommandError(error: unknown): error is DeployApiError;
+export declare function rejectV2ForLegacyCommand(args: {
+    client: AgentServeDeployClient;
+    teamId: number;
+    slug: string;
+}): Promise<void>;
+//# sourceMappingURL=legacy-command-guard.d.ts.map

package/dist/internal/legacy-command-guard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-command-guard.d.ts","sourceRoot":"","sources":["../../src/internal/legacy-command-guard.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,sBAAsB,EAC3B,cAAc,EACf,MAAM,oBAAoB,CAAC;AAE5B;;;;;;;GAOG;AACH,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IACjD,MAAM,EAAE,sBAAsB,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,IAAI,GAAG,IAAI,CAAC,CAavB;AAED,wBAAgB,+BAA+B,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAK5E;AAED,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,cAAc,CAMzB;AAED,wBAAsB,wBAAwB,CAAC,IAAI,EAAE;IACnD,MAAM,EAAE,sBAAsB,CAAC;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhB"}

package/dist/internal/legacy-command-guard.js

@@ -0,0 +1,51 @@
+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());
+    });
+};
+import { DeployApiError, } from "./deploy-client.js";
+/**
+ * Classify a hosted slug by probing the v2 control plane.
+ *
+ * Only HTTP 404 means “not v2.” Auth, 5xx, and transport errors fail closed
+ * so a v2 slug cannot fall through to `/internal/agent-serve`. That probe
+ * shares the factory microlith path used by secrets; a factory outage will
+ * also block legacy `--prod` until it recovers.
+ */
+export function deploymentArchitecture(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            yield args.client.getAgentkitDeploy({
+                teamId: args.teamId,
+                slug: args.slug,
+            });
+            return "v2";
+        }
+        catch (error) {
+            if (error instanceof DeployApiError && error.status === 404) {
+                return "v1";
+            }
+            throw error;
+        }
+    });
+}
+export function unsupportedV2LegacyCommandError(slug) {
+    return new DeployApiError(`This command is not supported for architecture v2 deployment "${slug}". The command stopped before calling the legacy v1 deployment API.`, 409);
+}
+export function isUnsupportedV2LegacyCommandError(error) {
+    return (error instanceof DeployApiError &&
+        error.status === 409 &&
+        error.message.includes("not supported for architecture v2"));
+}
+export function rejectV2ForLegacyCommand(args) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const architecture = yield deploymentArchitecture(args);
+        if (architecture === "v2") {
+            throw unsupportedV2LegacyCommandError(args.slug);
+        }
+    });
+}

package/dist/internal/platform-timers.d.ts

@@ -7,6 +7,7 @@
  * The control plane owns reminder *documents* and clocks. The kit only
  * executes fires.
  */
+import { type ReminderControlPlane } from "./reminder-control-plane-protocol.js";
 import { type ReminderRecord } from "./reminder-store.js";
 export interface PlatformTimers {
     upsertSchedule(input: {
@@ -25,4 +26,10 @@ export interface CursorHostedPlatformTimersOptions {
     fetch?: typeof fetch;
 }
 export declare function createCursorHostedPlatformTimers(options?: CursorHostedPlatformTimersOptions): PlatformTimers;
+/**
+ * Cursor-hosted HTTP ReminderControlPlane for architecture v2.
+ * Speaks factory `/internal/agentsdk/reminders` (ELB → factory ECS).
+ * CP owns ids and time. v1 PUT/DELETE reminders stay on timed-work.
+ */
+export declare function createCursorHostedReminderControlPlane(options?: CursorHostedPlatformTimersOptions): ReminderControlPlane;
 //# sourceMappingURL=platform-timers.d.ts.map

package/dist/internal/platform-timers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"platform-timers.d.ts","sourceRoot":"","sources":["../../src/internal/platform-timers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI5E,MAAM,WAAW,cAAc;IAC7B,cAAc,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAC7D,aAAa,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC3C,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,iCAAiC;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAqED,wBAAgB,gCAAgC,CAC9C,OAAO,GAAE,iCAAsC,GAC9C,cAAc,CA0EhB"}
+{"version":3,"file":"platform-timers.d.ts","sourceRoot":"","sources":["../../src/internal/platform-timers.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAEL,KAAK,oBAAoB,EAK1B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAoB,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAI5E,MAAM,WAAW,cAAc;IAC7B,cAAc,CAAC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrE,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,WAAW,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACnD,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,SAAS,CAAC,CAAC;IAC7D,aAAa,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC,CAAC;IAC3C,cAAc,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,iCAAiC;IAChD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAqED,wBAAgB,gCAAgC,CAC9C,OAAO,GAAE,iCAAsC,GAC9C,cAAc,CA0EhB;AA0DD;;;;GAIG;AACH,wBAAgB,sCAAsC,CACpD,OAAO,GAAE,iCAAsC,GAC9C,oBAAoB,CAsHtB"}

package/dist/internal/platform-timers.js

@@ -16,6 +16,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
         step((generator = generator.apply(thisArg, _arguments || [])).next());
     });
 };
+import { REMINDER_CP_PROTOCOL_VERSION, } from "./reminder-control-plane-protocol.js";
 import { isReminderRecord } from "./reminder-store.js";
 const DEFAULT_CURSOR_EXTERNAL_API_URL = "https://api.cursor.com";
 function resolveApiKey(options) {
@@ -118,3 +119,141 @@ export function createCursorHostedPlatformTimers(options = {}) {
         },
     };
 }
+/** v2 reminder CP is factory ECS (`/internal/agentsdk/*`), not timed-work. */
+const AGENTSDK_REMINDERS_PREFIX = "/internal/agentsdk";
+/**
+ * Bounded retries for idempotent CP outcome writes after the guest handler
+ * has already run. Delivery is at-least-once: a transient apply failure may
+ * re-enter the handler on the next Temporal admission. Do not claim
+ * exactly-once handler execution.
+ */
+const APPLY_REMINDER_OUTCOME_MAX_ATTEMPTS = 3;
+const APPLY_REMINDER_OUTCOME_RETRY_DELAY_MS = 50;
+function sleepMs(ms) {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield new Promise((resolve) => setTimeout(resolve, ms));
+    });
+}
+function withBoundedApplyRetries(run) {
+    return __awaiter(this, void 0, void 0, function* () {
+        let lastError;
+        for (let attempt = 1; attempt <= APPLY_REMINDER_OUTCOME_MAX_ATTEMPTS; attempt++) {
+            try {
+                return yield run();
+            }
+            catch (error) {
+                lastError = error;
+                if (attempt >= APPLY_REMINDER_OUTCOME_MAX_ATTEMPTS) {
+                    break;
+                }
+                yield sleepMs(APPLY_REMINDER_OUTCOME_RETRY_DELAY_MS * attempt);
+            }
+        }
+        throw lastError;
+    });
+}
+function timedWorkJsonFetch(options, method, path, body) {
+    return __awaiter(this, void 0, void 0, function* () {
+        var _a;
+        const fetchImpl = (_a = options.fetch) !== null && _a !== void 0 ? _a : globalThis.fetch;
+        if (typeof fetchImpl !== "function") {
+            throw new Error("reminder control plane requires fetch");
+        }
+        return fetchImpl(`${resolveBaseUrl(options)}${path}`, Object.assign({ method, headers: Object.assign({ Authorization: `Bearer ${resolveApiKey(options)}` }, (body === undefined ? {} : { "Content-Type": "application/json" })) }, (body === undefined ? {} : { body: JSON.stringify(body) })));
+    });
+}
+/**
+ * Cursor-hosted HTTP ReminderControlPlane for architecture v2.
+ * Speaks factory `/internal/agentsdk/reminders` (ELB → factory ECS).
+ * CP owns ids and time. v1 PUT/DELETE reminders stay on timed-work.
+ */
+export function createCursorHostedReminderControlPlane(options = {}) {
+    return {
+        protocolVersion: REMINDER_CP_PROTOCOL_VERSION,
+        createReminder(intent) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const response = yield timedWorkJsonFetch(options, "POST", `${AGENTSDK_REMINDERS_PREFIX}/reminders`, intent);
+                if (!response.ok) {
+                    const text = yield response.text();
+                    throw new Error(`reminder CP create failed: HTTP ${response.status} ${text}`);
+                }
+                const parsed = yield response.json();
+                if (!isReminderRecord(parsed)) {
+                    throw new Error("reminder CP create returned invalid record");
+                }
+                return parsed;
+            });
+        },
+        getReminder(id) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const response = yield timedWorkJsonFetch(options, "GET", `${AGENTSDK_REMINDERS_PREFIX}/reminders/${encodeURIComponent(id)}`);
+                if (response.status === 404) {
+                    return undefined;
+                }
+                if (!response.ok) {
+                    throw new Error(`reminder CP get failed: HTTP ${response.status}`);
+                }
+                const parsed = yield response.json();
+                return isReminderRecord(parsed) ? parsed : undefined;
+            });
+        },
+        listReminders() {
+            return __awaiter(this, void 0, void 0, function* () {
+                const response = yield timedWorkJsonFetch(options, "GET", `${AGENTSDK_REMINDERS_PREFIX}/reminders`);
+                if (!response.ok) {
+                    throw new Error(`reminder CP list failed: HTTP ${response.status}`);
+                }
+                const parsed = yield response.json();
+                if (parsed === null ||
+                    typeof parsed !== "object" ||
+                    !("reminders" in parsed) ||
+                    !Array.isArray(parsed.reminders)) {
+                    return [];
+                }
+                return parsed.reminders.filter(isReminderRecord);
+            });
+        },
+        cancelReminder(id, reason) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const response = yield timedWorkJsonFetch(options, "POST", `${AGENTSDK_REMINDERS_PREFIX}/reminders/${encodeURIComponent(id)}/cancel`, reason === undefined ? {} : { reason });
+                if (response.status === 404) {
+                    return undefined;
+                }
+                if (!response.ok) {
+                    throw new Error(`reminder CP cancel failed: HTTP ${response.status}`);
+                }
+                const parsed = yield response.json();
+                return isReminderRecord(parsed) ? parsed : undefined;
+            });
+        },
+        rekeyReminders(channelId, oldToken, newToken) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const response = yield timedWorkJsonFetch(options, "POST", `${AGENTSDK_REMINDERS_PREFIX}/reminders/rekey`, { channelId, oldToken, newToken });
+                if (!response.ok) {
+                    throw new Error(`reminder CP rekey failed: HTTP ${response.status}`);
+                }
+                const parsed = yield response.json();
+                if (parsed === null ||
+                    typeof parsed !== "object" ||
+                    typeof parsed.count !== "number") {
+                    throw new Error("reminder CP rekey returned invalid body");
+                }
+                return parsed.count;
+            });
+        },
+        applyReminderOutcome(claim, outcome) {
+            return __awaiter(this, void 0, void 0, function* () {
+                // Handler side effects may already have run; retry only the idempotent
+                // CP write. Exhausted failures stay thrown so Temporal can re-admit
+                // (at-least-once — not exactly-once).
+                return yield withBoundedApplyRetries(() => __awaiter(this, void 0, void 0, function* () {
+                    const response = yield timedWorkJsonFetch(options, "POST", `${AGENTSDK_REMINDERS_PREFIX}/reminders/outcome`, { claim, outcome });
+                    if (!response.ok) {
+                        throw new Error(`reminder CP outcome apply failed: HTTP ${response.status}`);
+                    }
+                    return (yield response.json());
+                }));
+            });
+        },
+    };
+}

package/dist/internal/reminder-control-plane-protocol.d.ts

@@ -13,6 +13,8 @@ import type { JsonObject, ReminderBusyPolicy, ReminderScheduleKind } from "../ty
 import type { ReminderRecord } from "./reminder-store.js";
 /** Wire / persistence version for this control-plane protocol. */
 export declare const REMINDER_CP_PROTOCOL_VERSION: 1;
+/** Each recurring/retry fire can spend a model turn and create hosted work. */
+export declare const REMINDER_CP_MIN_RECURRING_INTERVAL_MS: 60000;
 export type ReminderCpProtocolVersion = typeof REMINDER_CP_PROTOCOL_VERSION;
 /**
  * Normalized raw schedule for create intents (JSON-safe).