@cursor/july 0.1.108 → 0.1.109

package/src/internal/discovery/extensions.ts

@@ -8,7 +8,6 @@ import { join, resolve } from "node:path";
 import type {
   ArtifactsDefinition,
   ConnectionDefinition,
-  DiscoveredAB,
   DiscoveredChannel,
   DiscoveredConnection,
   DiscoveredExtension,
@@ -22,7 +21,6 @@ import type {
   ToolDefinition,
 } from "../../types.js";
 import { buildIdentityPreamble, withIdentityPreamble } from "../workspace.js";
-import { loadABs } from "./ab.js";
 import { loadChannels } from "./channels.js";
 import {
   compileConnection,
@@ -33,7 +31,6 @@ import {
 import { type DiscoveryContext, displayPath } from "./context.js";
 import { type CursorPluginAgent, readCursorPlugin } from "./cursor-plugin.js";
 import {
-  overlayAbs,
   overlayArtifacts,
   overlayChannels,
   overlayHooks,
@@ -74,7 +71,6 @@ export interface ExtensionContributions {
   schedules: DiscoveredSchedule[];
   instructionParts: string[];
   seedFiles: SeedFile[];
-  abs: DiscoveredAB[];
   artifacts: ArtifactsDefinition | undefined;
 }
 
@@ -171,7 +167,6 @@ interface ExtensionTree {
   schedules: DiscoveredSchedule[];
   instructions?: string;
   seedFiles: SeedFile[];
-  abs: DiscoveredAB[];
   artifacts?: ArtifactsDefinition;
 }
 
@@ -192,7 +187,6 @@ function emptyDiscovered(
     schedules: [],
     instructions: false,
     seedFiles: [],
-    abs: [],
     artifactKinds: [],
   };
 }
@@ -242,7 +236,6 @@ async function mountExtension(
   const seedFiles = new Map(
     tree.seedFiles.map((seed) => [seed.relativePath, seed])
   );
-  const abs = byAbSource(tree.abs);
   let artifacts = tree.artifacts;
   let instructions = tree.instructions;
 
@@ -333,7 +326,6 @@ async function mountExtension(
     for (const seed of await loadSeedFiles(ctx, site.overlayDir)) {
       seedFiles.set(seed.relativePath, seed);
     }
-    await overlayAbs(ctx, site, abs, site.overlayDir);
     artifacts = await overlayArtifacts(ctx, site.overlayDir, artifacts);
   }
 
@@ -407,14 +399,6 @@ async function mountExtension(
     into.seedFiles.push(seed);
     mounted.seedFiles.push(seed.relativePath);
   }
-  for (const experiment of abs.values()) {
-    const composed = `${site.ns}__${experiment.name}`;
-    into.abs.push({
-      name: composed,
-      definition: experiment.definition,
-    });
-    mounted.abs.push(composed);
-  }
   if (artifacts !== undefined) {
     const kinds: NonNullable<ArtifactsDefinition["kinds"]> = {};
     for (const [kind, config] of Object.entries(artifacts.kinds ?? {})) {
@@ -464,7 +448,6 @@ async function readExtensionTree(
       channels: [],
       schedules: [],
       seedFiles: [],
-      abs: [],
     };
   }
   return readNativeTree(ctx, root);
@@ -490,7 +473,6 @@ async function readNativeTree(
     schedules: await loadSchedules(ctx, join(root, "schedules")),
     instructions: await loadInstructions(ctx, root, undefined, false),
     seedFiles: await loadSeedFiles(ctx, root),
-    abs: await loadABs(ctx, root),
     artifacts: await loadArtifacts(ctx, root),
   };
 }
@@ -519,19 +501,14 @@ function byName<T extends { name: string }>(items: T[]): Map<string, T> {
   return new Map(items.map((item) => [item.name, item]));
 }
 
-function byAbSource(items: DiscoveredAB[]): Map<string, DiscoveredAB> {
-  return new Map(items.map((item) => [item.source ?? item.name, item]));
-}
-
 function byId<T extends { id: string }>(items: T[]): Map<string, T> {
   return new Map(items.map((item) => [item.id, item]));
 }
 
 /**
  * Agent-singleton slots: one runtime (`agent.ts`), one storage backend,
- * one OTLP exporter, one A/B platform config. Playground chips are a
- * Vite glob of the agent tree, not a discovery walk. Nested
- * `extensions/` are not mounted.
+ * one OTLP exporter. Playground chips are a Vite glob of the agent tree,
+ * not a discovery walk. Nested `extensions/` are not mounted.
  */
 async function warnAgentRootOnlySlots(
   ctx: DiscoveryContext,
@@ -541,7 +518,6 @@ async function warnAgentRootOnlySlots(
     ["agent.ts", "agent.ts"],
     ["storage.ts", "storage"],
     ["otel.ts", "otel"],
-    ["ab.config.ts", "A/B config"],
   ] as const;
   for (const [file, label] of files) {
     const path = join(root, file);

package/src/internal/discovery/info.ts

@@ -2,7 +2,6 @@
  * The `info` / `GET /v1/info` projection of an {@link AgentProject}.
  */
 
-import { resolveABMaxPlaygroundSessions } from "../../ab.js";
 import { resolveArtifactsMax } from "../../artifacts.js";
 import {
   type AgentProject,
@@ -140,6 +139,9 @@ export function projectInfo(project: AgentProject): AgentProjectInfo {
         if (meta?.factoryEventTypes !== undefined) {
           info.factoryEventTypes = meta.factoryEventTypes;
         }
+        if (meta?.slackEventTypes !== undefined) {
+          info.slackEventTypes = meta.slackEventTypes;
+        }
         if (meta?.slackChannelPosts !== undefined) {
           info.slackChannelPosts = meta.slackChannelPosts;
         }
@@ -158,18 +160,6 @@ export function projectInfo(project: AgentProject): AgentProjectInfo {
             name: reminder.name,
           })),
     hooks: project.hooks.map((hook) => hook.name),
-    abs: project.abs.map((experiment) => experiment.name),
-    ...(project.abConfig === undefined && project.abs.length === 0
-      ? {}
-      : {
-          abConfig: {
-            maxPlaygroundSessions: resolveABMaxPlaygroundSessions(
-              project.abConfig?.maxPlaygroundSessions
-            ),
-            durableSamples: project.storage?.abs !== undefined,
-            durableSnapshots: project.storage?.abs?.putSnapshot !== undefined,
-          },
-        }),
     storage:
       project.storage === undefined
         ? undefined

package/src/internal/discovery/modules.ts

@@ -103,7 +103,6 @@ const DEFINE_HELPER_NAME: Record<ImportableKind, string> = {
   schedule: "defineSchedule",
   reminder: "defineReminder",
   hook: "defineHook",
-  ab: "defineAB",
   storage: "defineStorage",
   artifacts: "defineArtifacts",
   otel: "defineOtel",

package/src/internal/discovery/project.ts

@@ -14,7 +14,6 @@ import {
   applyAgentContinuationDefaults,
   warnOmittedContinuationDowngrades,
 } from "../continuation-channel.js";
-import { loadABConfig, loadABs } from "./ab.js";
 import { loadAgent, warnUnknownSlots } from "./agent.js";
 import { loadChannels } from "./channels.js";
 import {
@@ -240,19 +239,6 @@ export async function loadAgentProject(
   const reminders = await loadReminders(ctx, join(agentDir, "reminders"));
   const hooks = await loadHooks(ctx, join(agentDir, "hooks"));
   hooks.push(...projectSlots.hooks);
-  const abs = await loadABs(ctx, agentDir);
-  for (const experiment of projectSlots.abs) {
-    if (abs.some((existing) => existing.name === experiment.name)) {
-      ctx.diagnostics.push({
-        severity: "error",
-        path: displayPath(ctx, join(agentDir, "extensions")),
-        message: `Extension A/B experiment "${experiment.name}" collides with an agent experiment.`,
-      });
-      continue;
-    }
-    abs.push(experiment);
-  }
-  const abConfig = await loadABConfig(ctx, agentDir);
   const storage = await loadStorage(ctx, agentDir, agent.architecture);
   const artifacts = await mergeProjectArtifacts(
     ctx,
@@ -295,8 +281,6 @@ export async function loadAgentProject(
     schedules,
     reminders,
     hooks,
-    abs,
-    abConfig,
     storage,
     artifacts,
     result,

package/src/internal/eval-runner.ts

@@ -633,7 +633,6 @@ async function runOneEval(
         sessionId,
         continuationToken,
         startIndex: nextEventIndex,
-        // Keep defineEval traffic out of live defineAB enrollment/metrics.
         purpose: "eval",
         bearerToken: opts.bearerToken,
         headers: opts.headers,

package/src/internal/framework-file-storage.ts

@@ -21,9 +21,8 @@
  * `continuation` go to the framework file store (file-shaped; the store
  * accepts values up to 64 MiB per
  * object without chunking, versus the KV proxy's 1 MiB row cap), while
- * author `kv`, eval runs, A/B samples, and conditional writes stay on the
- * control-plane KV proxy (the dashboard reads them there, and CAS needs a
- * database).
+ * author `kv`, eval runs, and conditional writes stay on the control-plane
+ * KV proxy (the dashboard reads them there, and CAS needs a database).
  *
  * v2 only, by construction: the composite is selected in
  * framework-storage-selection.ts, which v1 never reaches with a
@@ -202,8 +201,8 @@ function decodeDocument(key: string, bytes: Uint8Array): JsonValue {
 /**
  * Split one storage core by key kind: framework session state to `files`,
  * everything else to `kv`. Spread over the KV backend when building the
- * full definition so its `evals` / `abs` groups (and the cursor-hosted
- * marker) ride along untouched; wrap the KV `cas` group with
+ * full definition so its `evals` group (and the cursor-hosted marker)
+ * rides along untouched; wrap the KV `cas` group with
  * {@link frameworkGuardedCas} rather than spreading it as-is.
  */
 export function composeFrameworkStorage(input: {

package/src/internal/framework-storage-selection.ts

@@ -24,8 +24,8 @@
  *   (`AGENT_SERVE_FRAMEWORK_STORE_SOURCE_ID`, bound at task time) holds
  *   session records, event transcripts, and the continuation index —
  *   file-shaped state on file storage, apart from the author-facing user
- *   store. Author `host.kv`, eval runs, A/B samples, and conditional writes
- *   ride the AgentSDK v2 KV proxy (cursor-hosted-v2.ts), which resolves the
+ *   store. Author `host.kv`, eval runs, and conditional writes ride the
+ *   AgentSDK v2 KV proxy (cursor-hosted-v2.ts), which resolves the
  *   pod service account to the factorydb deployment row (the v1 Bugbot
  *   proxy cannot resolve v2 pods at all). Framework session state never
  *   routes to the KV proxy — the composite splits by key kind — so

package/src/internal/init-scaffold.ts

@@ -20,7 +20,6 @@ const EMPTY_DIRS: readonly string[] = [
   "agent/subagents",
   "agent/channels",
   "agent/hooks",
-  "agent/ab",
   "agent/schedules",
   "agent/sandbox/workspace",
   "agent/lib",
@@ -101,7 +100,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/src/internal/install-cursor-skills.ts

@@ -57,6 +57,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 function cursorSkillsHome(home?: string): string {
@@ -116,6 +118,7 @@ export async function listShippedPackageSkills(
   } catch {
     return [];
   }
+  const packageVersion = await readPackageVersion(packageRoot);
 
   const skills: PackageSkill[] = [];
   for (const entry of entries) {
@@ -133,12 +136,23 @@ export async function listShippedPackageSkills(
     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__";
+
+async function readPackageVersion(packageRoot: string): Promise<string> {
+  const raw = await readFile(join(packageRoot, "package.json"), "utf8");
+  const manifest = JSON.parse(raw) as { version?: unknown };
+  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
@@ -200,7 +214,10 @@ export async function installCursorSkills(
     await makeTreeWritable(target);
     const skillMdPath = join(target, "SKILL.md");
     const raw = await readFile(skillMdPath, "utf8");
-    const adjusted = prepareSkillMarkdownForCursorInstall(raw);
+    const adjusted = prepareSkillMarkdownForCursorInstall(
+      raw,
+      skill.packageVersion
+    );
     if (adjusted !== raw) {
       await writeFile(skillMdPath, adjusted, "utf8");
     }
@@ -276,9 +293,13 @@ async function hasLegacyCursorSkillsNamespace(
 
 /**
  * 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: string): string {
+export function prepareSkillMarkdownForCursorInstall(
+  content: string,
+  packageVersion?: string
+): string {
   const match = /^---\r?\n([\s\S]*?)\r?\n---/.exec(content);
   if (match === null) {
     return content;
@@ -291,7 +312,19 @@ export function prepareSkillMarkdownForCursorInstall(content: string): string {
     /\[`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: string): string {

package/src/internal/run-client.ts

@@ -34,7 +34,7 @@ export interface RunClientOptions extends RequestAuth {
   onEvent?: (event: SessionEvent) => void;
   /**
    * Create-time session purpose. Pass `"eval"` from the eval harness so
-   * live `defineAB` enrollment is skipped. Default `"live"`.
+   * the session is marked as regression traffic. Default `"live"`.
    */
   purpose?: SessionPurpose;
 }

package/src/internal/sdk-runner.ts

@@ -355,7 +355,7 @@ export class CursorSdkRunner implements AgentRunner {
         ) {
           // Cloud `wait()` drops usage after stream reconnect / getRun replay,
           // or returns an all-zero stub. `getUsage` still has the run's tokens
-          // (eventually); without them traces/ABs never record an estimated cost.
+          // (eventually); without them traces never record an estimated cost.
           outcome = await fillMissingCloudUsage(agent, result.id, outcome);
         }
         return outcome;

package/src/internal/server.ts

@@ -1777,22 +1777,6 @@ function mountAgentRoutes(
     },
   });
 
-  // Playground A/Bs tab: fold durable event streams into per-session
-  // assignments and aggregate arm metrics (built-ins + derive).
-  router.add({
-    method: "GET",
-    pattern: `${base}/v1/abs`,
-    auth: httpAuth,
-    handler: async (_request, ctx) => {
-      const includeAll =
-        dev === true &&
-        (args.allowAnonymous === true ||
-          (typeof ctx.requestIp === "string" &&
-            isLoopbackAddress(ctx.requestIp)));
-      return jsonResponse(await engine.abSnapshot(ctx.auth, { includeAll }));
-    },
-  });
-
   // Durable artifacts (ctx.artifacts / tag_artifact), newest-updated first.
   router.add({
     method: "GET",