@cursor/july 0.1.108 → 0.1.111

package/src/internal/deploy-manifest.ts

@@ -96,6 +96,15 @@ const catchDeclarationSchema = z.object({
     .max(CATCH_MAX_AUTH_POLICIES),
 });
 
+const slackReplyDeclarationSchema = z.object({
+  mode: z.literal("agentic"),
+  ack: z.string().regex(/^[a-z0-9_+-]{1,50}$/),
+  placeholder: z
+    .string()
+    .regex(/^(?!.*(?:<!|<@))[^\r\n]{2,80}$/)
+    .optional(),
+});
+
 const agentDeployManifestV1Schema = z.object({
   manifestVersion: z.literal(DEPLOY_MANIFEST_VERSION),
   generatedAtMs: z.number().int().nonnegative(),
@@ -109,6 +118,7 @@ const agentDeployManifestV1Schema = z.object({
     publicRoutePaths: z.array(z.string().min(1)).max(64),
     frameworkStorage: z.enum(["cursor-hosted", "other", "none"]).optional(),
     architecture: z.enum(["v1", "v2"]).optional(),
+    persistent: z.boolean().optional(),
     channels: z
       .array(
         z.object({
@@ -117,6 +127,7 @@ const agentDeployManifestV1Schema = z.object({
           eventTypes: z.array(z.string().min(1).max(64)).max(64).optional(),
           continuation: continuationIdentitySchema,
           catch: catchDeclarationSchema.optional(),
+          slackReply: slackReplyDeclarationSchema.optional(),
         })
       )
       .max(64),
@@ -136,6 +147,7 @@ export interface AgentDeployManifestDeclarations {
    * continuation defaults. Omit or `"v1"` keeps engine minting.
    */
   architecture?: "v1" | "v2";
+  persistent?: boolean;
   /**
    * Mounted channels with their kinds and per-channel event capability.
    * Scope keys are installation config and are never extracted here.
@@ -149,6 +161,11 @@ export interface AgentDeployManifestDeclarations {
     kind?: string;
     eventTypes?: string[];
     continuation: ContinuationIdentity;
+    /**
+     * Static Slack response settings the control plane may apply before the
+     * hosted runtime starts. Present only for `slack` channels in agentic mode.
+     */
+    slackReply?: AgentDeployManifestSlackReplyDeclaration;
     /**
      * Control-plane catch routes: present only for an authored channel
      * whose auth chain carries a `sharedSecretAuth` / `hmacSignatureAuth`
@@ -167,6 +184,14 @@ export interface AgentDeployManifestCatchDeclaration {
   auth: CatchAuthDeclaration[];
 }
 
+export interface AgentDeployManifestSlackReplyDeclaration {
+  mode: "agentic";
+  /** Normalized Slack emoji name without colons. */
+  ack: string;
+  /** Exact static replaceable first line. */
+  placeholder?: string;
+}
+
 export interface AgentDeployManifestV1 {
   manifestVersion: 1;
   /** Unix ms at extraction. */
@@ -198,12 +223,13 @@ export function buildAgentDeployManifest(
     throw new Error(runtimeArchitectureError);
   }
   applyAgentContinuationDefaults(project);
-  const channels = project.channels.map((channel) => {
+  const channels = project.channels.map(channel => {
     const handshake = handshakeChannelContinuation(channel);
     if (!handshake.ok) {
       throw new Error(handshake.error);
     }
     const kind = channel.definition.meta?.kind;
+    const meta = channel.definition.meta;
     const declaredEvents = channelDeclaredEventTypes(channel.definition.meta);
     const eventTypes =
       declaredEvents === undefined ? undefined : [...declaredEvents].sort();
@@ -213,18 +239,21 @@ export function buildAgentDeployManifest(
       eventTypes,
       continuation: channelContinuationIdentity(channel.definition),
       catch: channelCatchDeclaration(channel.definition),
+      ...(kind === "slack" && meta?.slackReply !== undefined
+        ? { slackReply: meta.slackReply }
+        : {}),
     };
   });
 
   // Same mapping as `july deploy` (cli-deploy.ts): channels declared public
   // via `publicEndpoint()` become alias-token-free route prefixes.
   const publicRoutePaths = project.channels
-    .filter((channel) =>
+    .filter(channel =>
       (channel.definition.auth ?? []).some(isPublicEndpointPolicy)
     )
-    .map((channel) => `/v1/channels/${channel.id}`);
+    .map(channel => `/v1/channels/${channel.id}`);
 
-  return {
+  const manifest: AgentDeployManifestV1 = {
     manifestVersion: DEPLOY_MANIFEST_VERSION,
     generatedAtMs: options?.nowMs ?? Date.now(),
     cliVersion: options?.cliVersion ?? packageVersion(),
@@ -244,10 +273,19 @@ export function buildAgentDeployManifest(
       ...(project.agent.architecture === undefined
         ? {}
         : { architecture: project.agent.architecture }),
+      persistent: project.agent.persistent,
       channels,
     },
     info: projectInfo(project),
   };
+  const validation = agentDeployManifestV1Schema.safeParse(manifest);
+  if (!validation.success) {
+    const issues = validation.error.issues
+      .map(issue => `${issue.path.join(".")}: ${issue.message}`)
+      .join("; ");
+    throw new Error(`Invalid Agent SDK deploy manifest: ${issues}`);
+  }
+  return manifest;
 }
 
 /**
@@ -266,7 +304,7 @@ export function channelCatchDeclaration(
   }
   const declared = (definition.auth ?? [])
     .map(catchAuthDeclaration)
-    .filter((declaration) => declaration !== undefined);
+    .filter(declaration => declaration !== undefined);
   if (declared.length === 0) {
     return undefined;
   }
@@ -278,11 +316,11 @@ export function channelCatchDeclaration(
   // claim-checked, and senders keep sending the secret regardless of
   // whether anything still checks it. HMAC policies carry body digests,
   // not secrets, so nothing is lost by dropping them.
-  const isPublic = declared.some((policy) => policy.kind === "public");
+  const isPublic = declared.some(policy => policy.kind === "public");
   const auth = isPublic
     ? [
         { kind: "public" as const },
-        ...declared.filter((policy) => policy.kind === "header"),
+        ...declared.filter(policy => policy.kind === "header"),
       ]
     : declared;
   if (routes.length > CATCH_MAX_ROUTES) {
@@ -304,7 +342,7 @@ export function channelCatchDeclaration(
     );
   }
   return {
-    routes: routes.map((route) => ({ method: route.method, path: route.path })),
+    routes: routes.map(route => ({ method: route.method, path: route.path })),
     auth,
   };
 }

package/src/internal/discovery/agent-config.ts

@@ -53,6 +53,40 @@ export function resolveArchitecture(
   return undefined;
 }
 
+/**
+ * `persistent: true` selects the long-lived-pod hosting mode of v2. It has
+ * no meaning on v1 (resident engine) or when the architecture is unset.
+ */
+export function resolvePersistent(
+  ctx: DiscoveryContext,
+  agentDir: string,
+  persistent: boolean | undefined,
+  architecture: AgentArchitecture | undefined
+): true | undefined {
+  if (persistent === undefined || persistent === false) {
+    return undefined;
+  }
+  const path = displayPath(ctx, join(agentDir, "agent.ts"));
+  if (persistent !== true) {
+    ctx.diagnostics.push({
+      severity: "error",
+      path,
+      message: `persistent must be true or false; got ${JSON.stringify(persistent)}.`,
+    });
+    return undefined;
+  }
+  if (architecture !== "v2") {
+    ctx.diagnostics.push({
+      severity: "error",
+      path,
+      message:
+        'persistent: true requires architecture: "v2"; persistent hosting is a v2 hosting mode.',
+    });
+    return undefined;
+  }
+  return true;
+}
+
 /** Absolute harness cwd parent, or undefined when unset / blank. */
 export function resolveAgentCwd(
   ctx: DiscoveryContext,

package/src/internal/discovery/agent.ts

@@ -12,7 +12,6 @@ import {
 import {
   type ArtifactsDefinition,
   DEFAULT_MODEL,
-  type DiscoveredAB,
   type DiscoveredChannel,
   type DiscoveredHook,
   type DiscoveredSchedule,
@@ -28,6 +27,7 @@ import {
   resolveConcurrency,
   resolveHosting,
   resolveLocalCwd,
+  resolvePersistent,
   runtimeArchitectureCompatibilityError,
 } from "./agent-config.js";
 import { loadConnections, loadHostConnections } from "./connections.js";
@@ -50,7 +50,7 @@ export interface LoadedRootAgent {
   agent: ResolvedAgent;
   projectSlots: Pick<
     ExtensionContributions,
-    "hooks" | "channels" | "schedules" | "abs" | "artifacts"
+    "hooks" | "channels" | "schedules" | "artifacts"
   >;
 }
 
@@ -66,7 +66,6 @@ export async function loadAgent(
         hooks: [],
         channels: [],
         schedules: [],
-        abs: [],
         artifacts: undefined,
       },
     };
@@ -92,7 +91,6 @@ export async function loadAgent(
   const hooks: DiscoveredHook[] = [];
   const channels: DiscoveredChannel[] = [];
   const schedules: DiscoveredSchedule[] = [];
-  const abs: DiscoveredAB[] = [];
   const instructionParts: string[] = [];
   const contributions = {
     tools,
@@ -105,7 +103,6 @@ export async function loadAgent(
     schedules,
     instructionParts,
     seedFiles,
-    abs,
     artifacts: undefined as ArtifactsDefinition | undefined,
   };
   const extensions = await appendExtensions(
@@ -182,7 +179,7 @@ export async function loadAgent(
       tools: authoredAllowlist,
     })
   );
-  const clash = tools.find((tool) => {
+  const clash = tools.find(tool => {
     if (reservedNames.has(tool.name)) {
       return true;
     }
@@ -244,7 +241,7 @@ export async function loadAgent(
   // run without the connection's tools or identity. (Hybrid per-send
   // cloud sessions fail closed in the session engine.)
   const perSessionConnection = connections.find(
-    (connection) =>
+    connection =>
       connection.advertiseTools === true || connection.auth !== undefined
   );
   if (perSessionConnection !== undefined && runtime !== "local") {
@@ -260,7 +257,7 @@ export async function loadAgent(
   if (
     allowedTools !== undefined &&
     !allowedTools.includes("shell") &&
-    tools.some((tool) => tool.execution === "agent")
+    tools.some(tool => tool.execution === "agent")
   ) {
     ctx.diagnostics.push({
       severity: "warning",
@@ -288,6 +285,12 @@ export async function loadAgent(
   const hosting = resolveHosting(ctx, agentDir, config?.hosting);
   const concurrency = resolveConcurrency(ctx, agentDir, config?.concurrency);
   const architecture = resolveArchitecture(ctx, agentDir, config?.architecture);
+  const persistent = resolvePersistent(
+    ctx,
+    agentDir,
+    config?.persistent,
+    architecture
+  );
   const runtimeArchitectureError = runtimeArchitectureCompatibilityError({
     runtime,
     architecture,
@@ -302,7 +305,7 @@ export async function loadAgent(
 
   if (runtime === "cloud") {
     warnCloudRuntimeLimitations(ctx, agentDir, {
-      agentTools: tools.filter((tool) => tool.execution === "agent").length,
+      agentTools: tools.filter(tool => tool.execution === "agent").length,
       skills: skills.length,
       seedFiles: seedFiles.length,
       hasCloudOptions: cloud !== undefined,
@@ -313,8 +316,8 @@ export async function loadAgent(
   // After appendBuiltinTools so opted-in built-ins (server-executed) count.
   if (runtime === "grokbot") {
     checkGrokBotRuntimeLimitations(ctx, agentDir, {
-      serverTools: tools.filter((tool) => tool.execution === "server").length,
-      agentTools: tools.filter((tool) => tool.execution === "agent").length,
+      serverTools: tools.filter(tool => tool.execution === "server").length,
+      agentTools: tools.filter(tool => tool.execution === "agent").length,
       skills: skills.length,
       seedFiles: seedFiles.length,
       connections: connections.length + hostConnections.length,
@@ -339,6 +342,7 @@ export async function loadAgent(
       hosting,
       concurrency,
       ...(architecture === undefined ? {} : { architecture }),
+      persistent,
       tools,
       skills,
       extensions,
@@ -351,7 +355,6 @@ export async function loadAgent(
       hooks,
       channels,
       schedules,
-      abs,
       artifacts: contributions.artifacts,
     },
   };
@@ -374,7 +377,6 @@ export async function warnUnknownSlots(
     "schedules",
     "reminders",
     "hooks",
-    "ab",
     "sandbox",
     "lib",
     // Vite playground custom tool chips (agent/playground/tools).

package/src/internal/discovery/channels.ts

@@ -62,8 +62,8 @@ export async function loadChannels(
           path: displayPath(ctx, entryPath),
           message:
             mode === "extension"
-              ? "httpChannel() configures the agent's built-in HTTP channel; an extension cannot contribute it."
-              : "httpChannel() configures the built-in HTTP channel and must be authored at channels/http.ts.",
+              ? "The built-in HTTP session channel belongs to the agent; an extension cannot contribute it."
+              : "The built-in HTTP session channel is reserved for the `http` channel id.",
         });
         continue;
       }
@@ -77,7 +77,7 @@ export async function loadChannels(
         path: displayPath(ctx, entryPath),
         message:
           id === "http" && mode === "agent"
-            ? "channels/http.ts must default-export httpChannel({ ... })."
+            ? "The channel id `http` is reserved for the built-in HTTP session channel."
             : "Channel modules must default-export defineChannel({ ... }).",
       });
       continue;
@@ -87,7 +87,7 @@ export async function loadChannels(
         severity: "error",
         path: displayPath(ctx, entryPath),
         message:
-          "The channel id `http` is reserved for the built-in HTTP channel; use httpChannel() to configure it.",
+          "The channel id `http` is reserved for the built-in HTTP session channel.",
       });
       continue;
     }

package/src/internal/discovery/connections.ts

@@ -53,7 +53,7 @@ function hasAuthorizationHeader(
     return false;
   }
   return Object.keys(headers).some(
-    (key) => key.toLowerCase() === "authorization"
+    key => key.toLowerCase() === "authorization"
   );
 }
 
@@ -86,7 +86,7 @@ function parseConnectionTools(
   if (!Array.isArray(tools) || tools.length === 0) {
     return { ok: false };
   }
-  if (tools.some((name) => typeof name !== "string")) {
+  if (tools.some(name => typeof name !== "string")) {
     return { ok: false };
   }
   const normalized = normalizeConnectionTools(tools);
@@ -150,7 +150,7 @@ export async function loadHostConnections(
   const hostDir = join(agentDir, "host-connections");
   const loaded = await loadConnections(ctx, hostDir, "host");
   const modelNames = new Set(
-    modelConnections.map((connection) => connection.name)
+    modelConnections.map(connection => connection.name)
   );
   const hostConnections: DiscoveredConnection[] = [];
   for (const connection of loaded) {
@@ -447,7 +447,7 @@ export async function compileConnection(
     "cursorAccount" in transport &&
     transport.servers !== undefined &&
     (transport.servers.length === 0 ||
-      transport.servers.some((server) => isBlank(server)))
+      transport.servers.some(server => isBlank(server)))
   ) {
     ctx.diagnostics.push({
       severity: "error",

package/src/internal/discovery/cursor-plugin.ts

@@ -72,13 +72,13 @@ const PLUGIN_ROOT_VARIABLES = new Set([
 /** A component slot's declaration: one directory or a list of paths. */
 const pathsSchema = z
   .union([z.string(), z.array(z.string())])
-  .transform((value) => (typeof value === "string" ? [value] : value));
+  .transform(value => (typeof value === "string" ? [value] : value));
 
 /** A blank or null value reads as absent, as a missing key would. */
 const text = z
   .string()
   .nullish()
-  .transform((value) =>
+  .transform(value =>
     value === undefined || value === null || value.trim() === ""
       ? undefined
       : value
@@ -98,12 +98,12 @@ const manifestSchema = z.object({
       z.array(z.union([z.string(), z.record(z.unknown())])),
     ])
     .optional()
-    .transform((value) => {
+    .transform(value => {
       const items =
         value === undefined || Array.isArray(value) ? (value ?? []) : [value];
       return {
-        paths: items.filter((item) => typeof item === "string"),
-        inline: items.filter((item) => typeof item !== "string"),
+        paths: items.filter(item => typeof item === "string"),
+        inline: items.filter(item => typeof item !== "string"),
       };
     }),
 });
@@ -161,7 +161,7 @@ export async function readCursorPlugin(
     plugin,
     manifest.data.commands
   )) {
-    if (skills.some((skill) => skill.name === command.name)) {
+    if (skills.some(skill => skill.name === command.name)) {
       ctx.diagnostics.push({
         severity: "warning",
         path: displayPath(ctx, root),
@@ -268,7 +268,7 @@ async function loadPluginSkills(
   const skills: DiscoveredSkill[] = [];
   for (const dir of dirs) {
     const skill = await readSkillDir(plugin, dir);
-    if (skill !== undefined && !skills.some((s) => s.name === skill.name)) {
+    if (skill !== undefined && !skills.some(s => s.name === skill.name)) {
       skills.push(skill);
     }
   }
@@ -347,7 +347,7 @@ async function loadPluginAgents(
   )) {
     const { data, body } = await readMarkdown(plugin, path);
     const name = componentName(plugin, data.name ?? fileStem(path), path);
-    if (name === undefined || agents.some((agent) => agent.name === name)) {
+    if (name === undefined || agents.some(agent => agent.name === name)) {
       continue;
     }
     if (isBlank(body)) {
@@ -450,7 +450,7 @@ function serverConnection(
   const unresolved = new Set<string>();
   const expanded = expandPlaceholders(
     raw,
-    (key) => {
+    key => {
       if (PLUGIN_ROOT_VARIABLES.has(key)) {
         return plugin.root;
       }
@@ -462,7 +462,7 @@ function serverConnection(
     plugin.ctx.diagnostics.push({
       severity: "error",
       path: displayPath(plugin.ctx, path),
-      message: `MCP server "${name}" needs ${[...unresolved].map((v) => `\${${v}}`).join(", ")}. Pass it in cursorPlugin({ variables }) or set it in the environment.`,
+      message: `MCP server "${name}" needs ${[...unresolved].map(v => `\${${v}}`).join(", ")}. Pass it in cursorPlugin({ variables }) or set it in the environment.`,
     });
     return undefined;
   }
@@ -558,7 +558,7 @@ function expandPlaceholders(
     );
   }
   if (Array.isArray(value)) {
-    return value.map((item) => expandPlaceholders(item, lookup, unresolved));
+    return value.map(item => expandPlaceholders(item, lookup, unresolved));
   }
   if (isRecord(value)) {
     const out: JsonRecord = {};
@@ -610,7 +610,7 @@ async function componentFiles(
       files.push(path);
     }
   }
-  return files.filter((file) => extensions.has(extname(file)));
+  return files.filter(file => extensions.has(extname(file)));
 }
 
 /** Manifest paths resolve against the plugin root; escaping ones are refused, as in Cursor. */

package/src/internal/discovery/extension-overlay.ts

@@ -6,7 +6,6 @@
 import { join } from "node:path";
 import type {
   ArtifactsDefinition,
-  DiscoveredAB,
   DiscoveredChannel,
   DiscoveredHook,
   DiscoveredSchedule,
@@ -14,7 +13,6 @@ import type {
   ResolvedAgent,
 } from "../../types.js";
 import { getDefinitionKind } from "../brand.js";
-import { loadABs } from "./ab.js";
 import { loadChannels } from "./channels.js";
 import { type DiscoveryContext, displayPath, errorMessage } from "./context.js";
 import {
@@ -86,7 +84,7 @@ export async function overlaySkills(
   contributed: Map<string, DiscoveredSkill>,
   dir: string
 ): Promise<void> {
-  await overlayNamed(ctx, site, contributed, dir, "disableSkill", (onDisable) =>
+  await overlayNamed(ctx, site, contributed, dir, "disableSkill", onDisable =>
     loadSkills(ctx, dir, onDisable)
   );
 }
@@ -97,7 +95,7 @@ export async function overlayHooks(
   contributed: Map<string, DiscoveredHook>,
   dir: string
 ): Promise<void> {
-  await overlayNamed(ctx, site, contributed, dir, "disableHook", (onDisable) =>
+  await overlayNamed(ctx, site, contributed, dir, "disableHook", onDisable =>
     loadHooks(ctx, dir, onDisable)
   );
 }
@@ -114,7 +112,7 @@ export async function overlaySchedules(
     contributed,
     dir,
     "disableSchedule",
-    (onDisable) => loadSchedules(ctx, dir, onDisable)
+    onDisable => loadSchedules(ctx, dir, onDisable)
   );
 }
 
@@ -202,22 +200,6 @@ export async function overlayInstructionsFragment(
   return loadInstructions(ctx, overlayDir, undefined, false);
 }
 
-export async function overlayAbs(
-  ctx: DiscoveryContext,
-  site: OverlaySite,
-  contributed: Map<string, DiscoveredAB>,
-  overlayDir: string
-): Promise<void> {
-  const loaded = await loadABs(ctx, overlayDir, (source, path) => {
-    if (!contributed.delete(source)) {
-      unknownContribution(ctx, path, "disableAB", source, site.ns);
-    }
-  });
-  for (const experiment of loaded) {
-    contributed.set(experiment.source ?? experiment.name, experiment);
-  }
-}
-
 export async function overlayArtifacts(
   ctx: DiscoveryContext,
   overlayDir: string,