@cursor/july 0.1.109 → 0.1.112

package/dist/internal/deploy-client.js

@@ -68,6 +68,17 @@ export function deploymentServiceAccountId(deployment) {
     return id === "" ? undefined : id;
 }
 export const TERMINAL_AGENTKIT_DEPLOY_STATUSES = new Set(["running", "failed", "stopped"]);
+const agentkitCancelRunsResultSchema = z.object({
+    batchesStarted: z.number().int().nonnegative(),
+    failed: z.number().int().nonnegative(),
+    sessionsMarkedFailed: z.number().int().nonnegative().optional(),
+});
+const agentkitEventRepositoriesSchema = z.object({
+    repositories: z.array(z.string()),
+});
+const agentkitInstallReleaseSchema = z.object({
+    releaseId: z.string(),
+});
 // All response schemas are `.passthrough()`: the backend keeps growing the
 // deployment payload (serviceAccountId, egressAllowedDomains, secret
 // metadata, ...) and unknown fields must flow through untouched — both so
@@ -115,11 +126,34 @@ const agentkitDeployStatusSchema = z
     secretNames: z.array(z.string()).optional(),
 })
     .passthrough();
+const agentkitDeploymentListItemSchema = z
+    .object({
+    architecture: z.literal("v2"),
+    applicationId: z.string().min(1),
+    releaseId: z.string().min(1),
+    slug: z.string().min(1),
+    teamId: z.number(),
+    status: agentkitDeployStatusSchema.shape.status,
+    deployments: z.array(z.object({ desiredUpdatedAt: z.string() }).passthrough()),
+})
+    .passthrough();
+const agentkitDeploymentListResponseSchema = z.object({
+    deployments: z.array(agentkitDeploymentListItemSchema),
+    nextPageToken: z.string().nullable(),
+});
 const agentkitStopAcceptedSchema = z
     .object({
     applicationId: z.string().min(1),
     releaseId: z.string().min(1),
     status: z.string(),
+    cancellation: agentkitCancelRunsResultSchema.optional(),
+})
+    .passthrough();
+const agentkitGlobalSuspensionAcceptedSchema = z
+    .object({
+    applicationId: z.string().min(1),
+    status: z.enum(["running", "stopped"]),
+    cancellation: agentkitCancelRunsResultSchema.optional(),
 })
     .passthrough();
 const agentkitStartSessionAcceptedSchema = z
@@ -132,6 +166,36 @@ const agentkitStartSessionAcceptedSchema = z
     asOf: z.string().min(1).optional(),
 })
     .passthrough();
+const agentkitSessionRunsSchema = z
+    .object({
+    executions: z.array(z
+        .object({
+        executionId: z.string().min(1),
+        writtenAt: z.string(),
+        turnStatus: z.string(),
+        durationMs: z.number().nonnegative(),
+        message: z.string().optional(),
+        error: z
+            .object({
+            name: z.string(),
+            message: z.string(),
+            stack: z.string().optional(),
+        })
+            .passthrough()
+            .optional(),
+        processDeath: z.boolean().optional(),
+        logs: z.array(z
+            .object({
+            index: z.number(),
+            at: z.string(),
+            line: z.string(),
+        })
+            .passthrough()),
+    })
+        .passthrough()),
+    startLog: z.string().nullable(),
+})
+    .passthrough();
 const deploymentSchema = z.object({
     id: z.number(),
     slug: z.string(),
@@ -215,11 +279,6 @@ const rotateResponseSchema = z
     aliasToken: z.string().min(1),
 })
     .passthrough();
-const rotatePodCredentialResponseSchema = z
-    .object({
-    podCredentialMaskedKey: z.string().min(1),
-})
-    .passthrough();
 const setSecretsResponseSchema = z
     .object({
     secretNames: z.array(z.string()),
@@ -335,9 +394,9 @@ export class AgentServeDeployClient {
             const raw = yield this.request({
                 method: "POST",
                 path: "/internal/agentsdk/deployments",
-                body: Object.assign({ teamId: args.teamId, slug: args.slug, gitRepoUrl: args.gitRepoUrl, gitRef: args.gitRef, agentPath: args.agentPath, components: args.components, repositories: args.repositories !== undefined && args.repositories.length > 0
+                body: Object.assign(Object.assign({ teamId: args.teamId, slug: args.slug, gitRepoUrl: args.gitRepoUrl, gitRef: args.gitRef, agentPath: args.agentPath, components: args.components, repositories: args.repositories !== undefined && args.repositories.length > 0
                         ? args.repositories
-                        : undefined }, (args.multiTenant === true ? { multiTenant: true } : {})),
+                        : undefined }, (args.multiTenant === true ? { multiTenant: true } : {})), { persistent: args.persistent }),
                 context: { verb: "deploy", slug: args.slug },
             });
             return agentkitDeployAcceptedSchema.parse(raw);
@@ -361,12 +420,73 @@ export class AgentServeDeployClient {
         return __awaiter(this, void 0, void 0, function* () {
             const raw = yield this.request({
                 method: "POST",
-                path: `/internal/agentsdk/deployments/${encodeURIComponent(args.slug)}/stop?teamId=${args.teamId}`,
+                path: `/internal/agentsdk/deployments/${encodeURIComponent(args.slug)}/stop?teamId=${args.teamId}` +
+                    (args.cancelRuns === true ? "&cancelRuns=true" : ""),
                 context: { verb: "stop", slug: args.slug },
             });
             return agentkitStopAcceptedSchema.parse(raw);
         });
     }
+    setAgentkitGlobalSuspension(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const action = args.suspended ? "global-stop" : "global-resume";
+            const cancelQuery = args.suspended === true && args.cancelRuns === true
+                ? "&cancelRuns=true"
+                : "";
+            const raw = yield this.request({
+                method: "POST",
+                path: `/internal/agentsdk/deployments/${encodeURIComponent(args.slug)}/${action}?teamId=${args.teamId}${cancelQuery}`,
+                context: {
+                    verb: args.suspended ? "globally stop" : "globally resume",
+                    slug: args.slug,
+                },
+            });
+            return agentkitGlobalSuspensionAcceptedSchema.parse(raw);
+        });
+    }
+    cancelAgentkitRuns(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const raw = yield this.request({
+                method: "POST",
+                path: `/internal/agentsdk/deployments/${encodeURIComponent(args.slug)}/cancel-runs?teamId=${args.teamId}`,
+                context: { verb: "cancel runs", slug: args.slug },
+            });
+            return agentkitCancelRunsResultSchema.parse(raw);
+        });
+    }
+    /**
+     * Repoint a v2 install's event repositories
+     * (`PUT /internal/agentsdk/deployments/:slug/event-repositories`). Deploy
+     * cannot carry these for a multi-tenant product.
+     */
+    setAgentkitEventRepositories(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const raw = yield this.request({
+                method: "PUT",
+                path: `/internal/agentsdk/deployments/${encodeURIComponent(args.slug)}/event-repositories?teamId=${args.teamId}`,
+                body: { repositories: args.repositories },
+                context: { verb: "set event repositories", slug: args.slug },
+            });
+            return agentkitEventRepositoriesSchema.parse(raw).repositories;
+        });
+    }
+    /**
+     * Pin a v2 install onto a release
+     * (`PUT /internal/agentsdk/deployments/:slug/release`), newest ready one
+     * when neither selector is given. A multi-tenant deploy leaves tenants
+     * on the release they were installed on.
+     */
+    upgradeAgentkitInstall(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const raw = yield this.request({
+                method: "PUT",
+                path: `/internal/agentsdk/deployments/${encodeURIComponent(args.slug)}/release?teamId=${args.teamId}`,
+                body: Object.assign(Object.assign({}, (args.releaseId === undefined ? {} : { releaseId: args.releaseId })), (args.version === undefined ? {} : { version: args.version })),
+                context: { verb: "upgrade", slug: args.slug },
+            });
+            return agentkitInstallReleaseSchema.parse(raw).releaseId;
+        });
+    }
     /**
      * Delete a v2 deployment (`DELETE /internal/agentsdk/deployments/:slug`).
      * 202 means accepted; poll {@link getAgentkitDeploy} until 404.
@@ -397,12 +517,24 @@ export class AgentServeDeployClient {
                     sessionId: args.sessionId,
                     dryRun: args.dryRun === true ? true : undefined,
                     asOf: args.asOf,
+                    componentKey: args.componentKey,
                 },
                 context: { verb: "start session", slug: args.slug },
             });
             return agentkitStartSessionAcceptedSchema.parse(raw);
         });
     }
+    /** Hosted executions and the start-log tee for one v2 session. */
+    getAgentkitSessionRuns(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const raw = yield this.request({
+                method: "GET",
+                path: `/internal/agentsdk/deployments/${encodeURIComponent(args.slug)}/sessions/${encodeURIComponent(args.sessionId)}/runs?teamId=${args.teamId}`,
+                context: { verb: "get session runs", slug: args.slug },
+            });
+            return agentkitSessionRunsSchema.parse(raw);
+        });
+    }
     listDeployments(args) {
         return __awaiter(this, void 0, void 0, function* () {
             const raw = yield this.request({
@@ -413,6 +545,26 @@ export class AgentServeDeployClient {
             return listResponseSchema.parse(raw).deployments;
         });
     }
+    listAgentkitDeployments(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const deployments = [];
+            let pageToken = null;
+            do {
+                const qs = `teamId=${args.teamId}&pageSize=100` +
+                    (pageToken === null
+                        ? ""
+                        : `&pageToken=${encodeURIComponent(pageToken)}`);
+                const page = agentkitDeploymentListResponseSchema.parse(yield this.request({
+                    method: "GET",
+                    path: `/internal/agentsdk/deployments?${qs}`,
+                    context: { verb: "list architecture v2 deployments" },
+                }));
+                deployments.push(...page.deployments);
+                pageToken = page.nextPageToken;
+            } while (pageToken !== null);
+            return deployments;
+        });
+    }
     getDeployment(args) {
         return __awaiter(this, void 0, void 0, function* () {
             const raw = yield this.request({
@@ -454,6 +606,17 @@ export class AgentServeDeployClient {
             return rotateResponseSchema.parse(raw).aliasToken;
         });
     }
+    /** Rotate the alias token on an AgentSDK v2 deployment. */
+    rotateAgentsdkAliasToken(args) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const raw = yield this.request({
+                method: "POST",
+                path: `/internal/agentsdk/deployments/${encodeURIComponent(args.slug)}/rotate-alias-token?teamId=${args.teamId}`,
+                context: { verb: "rotate alias token", slug: args.slug },
+            });
+            return rotateResponseSchema.parse(raw).aliasToken;
+        });
+    }
     /**
      * Upsert secrets by name (unlisted names stay untouched). Returns the
      * post-write union of secret names, sorted. Validates names and value
@@ -548,21 +711,6 @@ export class AgentServeDeployClient {
             throw new DeployApiError(`Too many secrets in one request (${secrets.length}); deployments hold at most ${MAX_SECRETS}.`, 400);
         }
     }
-    /**
-     * Rotate the deployment's pod credential. Returns the masked new key —
-     * the raw key is injected into the pod on the next deploy, never
-     * returned to clients.
-     */
-    rotatePodCredential(args) {
-        return __awaiter(this, void 0, void 0, function* () {
-            const raw = yield this.request({
-                method: "POST",
-                path: `/internal/agent-serve/deployments/${encodeURIComponent(args.slug)}/rotate-pod-credential?teamId=${args.teamId}`,
-                context: { verb: "rotate pod credential", slug: args.slug },
-            });
-            return rotatePodCredentialResponseSchema.parse(raw).podCredentialMaskedKey;
-        });
-    }
     /**
      * Read an Automation's exported workflow definition for
      * `convert-automation`. Missing, no-access, and gate-off all surface as

package/dist/internal/deploy-manifest.d.ts

@@ -43,6 +43,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.
@@ -56,6 +57,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`
@@ -72,6 +78,13 @@ 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. */

package/dist/internal/deploy-manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy-manifest.d.ts","sourceRoot":"","sources":["../../src/internal/deploy-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,EACL,KAAK,oBAAoB,EAG1B,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAOlE,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,4BAA4B,CAAC;AAOpC,eAAO,MAAM,uBAAuB,EAAE,CAAK,CAAC;AAwE5C,MAAM,WAAW,+BAA+B;IAC9C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,eAAe,GAAG,OAAO,GAAG,MAAM,CAAC;IACtD;;;;OAIG;IACH,YAAY,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B;;;;;;;OAOG;IACH,QAAQ,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,YAAY,EAAE,oBAAoB,CAAC;QACnC;;;;;WAKG;QACH,KAAK,CAAC,EAAE,mCAAmC,CAAC;KAC7C,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,mCAAmC;IAClD,MAAM,EAAE,KAAK,CAAC;QACZ,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;QACpD,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,IAAI,EAAE,oBAAoB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,CAAC,CAAC;IACnB,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,+BAA+B,CAAC;IAC9C;;;OAGG;IACH,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACpE,qBAAqB,CA0DvB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,GACzD,mCAAmC,GAAG,SAAS,CAgDjD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,OAAO,GACX,qBAAqB,GAAG,SAAS,CAOnC"}
+{"version":3,"file":"deploy-manifest.d.ts","sourceRoot":"","sources":["../../src/internal/deploy-manifest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAGH,OAAO,EACL,KAAK,oBAAoB,EAG1B,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EAAE,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAOlE,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,4BAA4B,CAAC;AAOpC,eAAO,MAAM,uBAAuB,EAAE,CAAK,CAAC;AAmF5C,MAAM,WAAW,+BAA+B;IAC9C,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,eAAe,GAAG,OAAO,GAAG,MAAM,CAAC;IACtD;;;;OAIG;IACH,YAAY,CAAC,EAAE,IAAI,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB;;;;;;;OAOG;IACH,QAAQ,EAAE,KAAK,CAAC;QACd,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;QACtB,YAAY,EAAE,oBAAoB,CAAC;QACnC;;;WAGG;QACH,UAAU,CAAC,EAAE,wCAAwC,CAAC;QACtD;;;;;WAKG;QACH,KAAK,CAAC,EAAE,mCAAmC,CAAC;KAC7C,CAAC,CAAC;CACJ;AAED,MAAM,WAAW,mCAAmC;IAClD,MAAM,EAAE,KAAK,CAAC;QACZ,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;QACpD,IAAI,EAAE,MAAM,CAAC;KACd,CAAC,CAAC;IACH,IAAI,EAAE,oBAAoB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,wCAAwC;IACvD,IAAI,EAAE,SAAS,CAAC;IAChB,kDAAkD;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,2CAA2C;IAC3C,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,eAAe,EAAE,CAAC,CAAC;IACnB,6BAA6B;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,yDAAyD;IACzD,UAAU,EAAE,MAAM,CAAC;IACnB,6EAA6E;IAC7E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,+BAA+B,CAAC;IAC9C;;;OAGG;IACH,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,YAAY,EACrB,OAAO,CAAC,EAAE;IAAE,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACpE,qBAAqB,CAuEvB;AAED;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,YAAY,CAAC,UAAU,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,GACzD,mCAAmC,GAAG,SAAS,CAgDjD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,GAAG,EAAE,OAAO,GACX,qBAAqB,GAAG,SAAS,CAOnC"}

package/dist/internal/deploy-manifest.js

@@ -70,6 +70,14 @@ const catchDeclarationSchema = z.object({
         .min(1)
         .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(),
@@ -83,6 +91,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({
             id: z.string().min(1).max(128),
@@ -90,6 +99,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),
     }),
@@ -108,29 +118,27 @@ export function buildAgentDeployManifest(project, options) {
         throw new Error(runtimeArchitectureError);
     }
     applyAgentContinuationDefaults(project);
-    const channels = project.channels.map((channel) => {
+    const channels = project.channels.map(channel => {
         var _a;
         const handshake = handshakeChannelContinuation(channel);
         if (!handshake.ok) {
             throw new Error(handshake.error);
         }
         const kind = (_a = channel.definition.meta) === null || _a === void 0 ? void 0 : _a.kind;
+        const meta = channel.definition.meta;
         const declaredEvents = channelDeclaredEventTypes(channel.definition.meta);
         const eventTypes = declaredEvents === undefined ? undefined : [...declaredEvents].sort();
-        return {
-            id: channel.id,
-            kind,
-            eventTypes,
-            continuation: channelContinuationIdentity(channel.definition),
-            catch: channelCatchDeclaration(channel.definition),
-        };
+        return Object.assign({ id: channel.id, kind,
+            eventTypes, continuation: channelContinuationIdentity(channel.definition), catch: channelCatchDeclaration(channel.definition) }, (kind === "slack" && (meta === null || meta === void 0 ? void 0 : 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) => { var _a; return ((_a = channel.definition.auth) !== null && _a !== void 0 ? _a : []).some(isPublicEndpointPolicy); })
-        .map((channel) => `/v1/channels/${channel.id}`);
-    return {
+        .filter(channel => { var _a; return ((_a = channel.definition.auth) !== null && _a !== void 0 ? _a : []).some(isPublicEndpointPolicy); })
+        .map(channel => `/v1/channels/${channel.id}`);
+    const manifest = {
         manifestVersion: DEPLOY_MANIFEST_VERSION,
         generatedAtMs: (_b = options === null || options === void 0 ? void 0 : options.nowMs) !== null && _b !== void 0 ? _b : Date.now(),
         cliVersion: (_c = options === null || options === void 0 ? void 0 : options.cliVersion) !== null && _c !== void 0 ? _c : packageVersion(),
@@ -145,9 +153,17 @@ export function buildAgentDeployManifest(project, options) {
                     ? "cursor-hosted"
                     : "other" }, (project.agent.architecture === undefined
             ? {}
-            : { architecture: project.agent.architecture })), { channels }),
+            : { 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;
 }
 /**
  * Catch declaration for one authored channel: its routes, gated by the
@@ -164,7 +180,7 @@ export function channelCatchDeclaration(definition) {
     }
     const declared = ((_b = definition.auth) !== null && _b !== void 0 ? _b : [])
         .map(catchAuthDeclaration)
-        .filter((declaration) => declaration !== undefined);
+        .filter(declaration => declaration !== undefined);
     if (declared.length === 0) {
         return undefined;
     }
@@ -176,11 +192,11 @@ export function channelCatchDeclaration(definition) {
     // 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" },
-            ...declared.filter((policy) => policy.kind === "header"),
+            ...declared.filter(policy => policy.kind === "header"),
         ]
         : declared;
     if (routes.length > CATCH_MAX_ROUTES) {
@@ -198,7 +214,7 @@ export function channelCatchDeclaration(definition) {
             : `Catch channels may declare at most ${CATCH_MAX_AUTH_POLICIES} secret policies (got ${auth.length}).`);
     }
     return {
-        routes: routes.map((route) => ({ method: route.method, path: route.path })),
+        routes: routes.map(route => ({ method: route.method, path: route.path })),
         auth,
     };
 }

package/dist/internal/discovery/agent-config.d.ts

@@ -8,6 +8,11 @@ export declare function runtimeArchitectureCompatibilityError(agent: {
     architecture?: AgentArchitecture;
 }): string | undefined;
 export declare function resolveArchitecture(ctx: DiscoveryContext, agentDir: string, architecture: AgentArchitecture | undefined): AgentArchitecture | 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 declare function resolvePersistent(ctx: DiscoveryContext, agentDir: string, persistent: boolean | undefined, architecture: AgentArchitecture | undefined): true | undefined;
 /** Absolute harness cwd parent, or undefined when unset / blank. */
 export declare function resolveAgentCwd(ctx: DiscoveryContext, authored: string | undefined): string | undefined;
 /**

package/dist/internal/discovery/agent-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-config.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/agent-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAEjB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AASxB,OAAO,EAAE,KAAK,gBAAgB,EAAwB,MAAM,cAAc,CAAC;AAI3E,wBAAgB,qCAAqC,CAAC,KAAK,EAAE;IAC3D,OAAO,EAAE,YAAY,CAAC;IACtB,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC,GAAG,MAAM,GAAG,SAAS,CAIrB;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,iBAAiB,GAAG,SAAS,GAC1C,iBAAiB,GAAG,SAAS,CAc/B;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAC7B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,GAAG,SAAS,CASpB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,gBAAgB,EACrB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,oBAAoB,EAAE,MAAM,GAAG,SAAS,GACvC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAY7B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,mBAAmB,GAAG,SAAS,GACvC,mBAAmB,GAAG,SAAS,CAyCjC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,uBAAuB,GAAG,SAAS,GAC/C,uBAAuB,GAAG,SAAS,CAmBrC;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CA4B5C;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAUzE"}
+{"version":3,"file":"agent-config.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/agent-config.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,KAAK,iBAAiB,EACtB,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,mBAAmB,EACxB,KAAK,YAAY,EAEjB,KAAK,YAAY,EAClB,MAAM,gBAAgB,CAAC;AASxB,OAAO,EAAE,KAAK,gBAAgB,EAAwB,MAAM,cAAc,CAAC;AAI3E,wBAAgB,qCAAqC,CAAC,KAAK,EAAE;IAC3D,OAAO,EAAE,YAAY,CAAC;IACtB,YAAY,CAAC,EAAE,iBAAiB,CAAC;CAClC,GAAG,MAAM,GAAG,SAAS,CAIrB;AAED,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,iBAAiB,GAAG,SAAS,GAC1C,iBAAiB,GAAG,SAAS,CAc/B;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,OAAO,GAAG,SAAS,EAC/B,YAAY,EAAE,iBAAiB,GAAG,SAAS,GAC1C,IAAI,GAAG,SAAS,CAuBlB;AAED,oEAAoE;AACpE,wBAAgB,eAAe,CAC7B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GAAG,SAAS,GAC3B,MAAM,GAAG,SAAS,CASpB;AAED;;;;GAIG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,gBAAgB,EACrB,WAAW,EAAE,MAAM,GAAG,SAAS,EAC/B,oBAAoB,EAAE,MAAM,GAAG,SAAS,GACvC,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAY7B;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,mBAAmB,GAAG,SAAS,GACvC,mBAAmB,GAAG,SAAS,CAyCjC;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,uBAAuB,GAAG,SAAS,GAC/C,uBAAuB,GAAG,SAAS,CAmBrC;AAED,wBAAsB,eAAe,CACnC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,OAAO,GACd,OAAO,CAAC,qBAAqB,GAAG,SAAS,CAAC,CA4B5C;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAUzE"}

package/dist/internal/discovery/agent-config.js

@@ -36,6 +36,33 @@ export function resolveArchitecture(ctx, agentDir, architecture) {
     });
     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, agentDir, persistent, architecture) {
+    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, authored) {
     if (authored === undefined) {

package/dist/internal/discovery/agent.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,EAML,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AAcxB,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAc9D,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,YAAY,EAAE,IAAI,CAChB,sBAAsB,EACtB,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CACjD,CAAC;CACH;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACzC,OAAO,CAAC,eAAe,CAAC,CAqS1B;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CA0Cf"}
+{"version":3,"file":"agent.d.ts","sourceRoot":"","sources":["../../../src/internal/discovery/agent.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,OAAO,EAML,KAAK,aAAa,EACnB,MAAM,gBAAgB,CAAC;AAexB,OAAO,EAAE,KAAK,gBAAgB,EAAe,MAAM,cAAc,CAAC;AAClE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAc9D,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,aAAa,CAAC;IACrB,YAAY,EAAE,IAAI,CAChB,sBAAsB,EACtB,OAAO,GAAG,UAAU,GAAG,WAAW,GAAG,WAAW,CACjD,CAAC;CACH;AAED,wBAAsB,SAAS,CAC7B,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GACzC,OAAO,CAAC,eAAe,CAAC,CA4S1B;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,gBAAgB,EACrB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,IAAI,CAAC,CA0Cf"}

package/dist/internal/discovery/agent.js

@@ -15,7 +15,7 @@ import { canonicalizeFileSystemToolName, FileSystemConfigError, resolveFileSyste
 import { DEFAULT_MODEL, } from "../../types.js";
 import { synthesizedFileSystemToolNames } from "../filesystem/tools.js";
 import { withIdentityPreamble } from "../workspace.js";
-import { isValidModelSetting, loadAgentConfig, resolveAgentCwd, resolveArchitecture, resolveConcurrency, resolveHosting, resolveLocalCwd, runtimeArchitectureCompatibilityError, } from "./agent-config.js";
+import { isValidModelSetting, loadAgentConfig, resolveAgentCwd, resolveArchitecture, resolveConcurrency, resolveHosting, resolveLocalCwd, resolvePersistent, runtimeArchitectureCompatibilityError, } from "./agent-config.js";
 import { loadConnections, loadHostConnections } from "./connections.js";
 import { displayPath } from "./context.js";
 import { appendExtensions } from "./extensions.js";
@@ -124,7 +124,7 @@ export function loadAgent(ctx, agentDir, options) {
             hasRoot,
             tools: authoredAllowlist,
         }));
-        const clash = tools.find((tool) => {
+        const clash = tools.find(tool => {
             if (reservedNames.has(tool.name)) {
                 return true;
             }
@@ -185,7 +185,7 @@ export function loadAgent(ctx, agentDir, options) {
         // non-local agent that declares them must fail at serve start — never
         // 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.advertiseTools === true || connection.auth !== undefined);
+        const perSessionConnection = connections.find(connection => connection.advertiseTools === true || connection.auth !== undefined);
         if (perSessionConnection !== undefined && runtime !== "local") {
             ctx.diagnostics.push({
                 severity: "error",
@@ -198,7 +198,7 @@ export function loadAgent(ctx, agentDir, options) {
         // strands authored scripts deserves a loud diagnostic, not silence.
         if (allowedTools !== undefined &&
             !allowedTools.includes("shell") &&
-            tools.some((tool) => tool.execution === "agent")) {
+            tools.some(tool => tool.execution === "agent")) {
             ctx.diagnostics.push({
                 severity: "warning",
                 path: displayPath(ctx, join(agentDir, "agent.ts")),
@@ -222,6 +222,7 @@ export function loadAgent(ctx, agentDir, options) {
         const hosting = resolveHosting(ctx, agentDir, config === null || config === void 0 ? void 0 : config.hosting);
         const concurrency = resolveConcurrency(ctx, agentDir, config === null || config === void 0 ? void 0 : config.concurrency);
         const architecture = resolveArchitecture(ctx, agentDir, config === null || config === void 0 ? void 0 : config.architecture);
+        const persistent = resolvePersistent(ctx, agentDir, config === null || config === void 0 ? void 0 : config.persistent, architecture);
         const runtimeArchitectureError = runtimeArchitectureCompatibilityError({
             runtime,
             architecture,
@@ -235,7 +236,7 @@ export function loadAgent(ctx, agentDir, options) {
         }
         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,
@@ -245,8 +246,8 @@ export function loadAgent(ctx, agentDir, options) {
         // 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,
@@ -261,7 +262,8 @@ export function loadAgent(ctx, agentDir, options) {
                 model: isValidModelSetting(config === null || config === void 0 ? void 0 : config.model) ? config.model : DEFAULT_MODEL, instructions,
                 runtime }, (root === undefined ? {} : { root })), { cloud,
                 local }), (allowedTools === undefined ? {} : { allowedTools })), { hosting,
-                concurrency }), (architecture === undefined ? {} : { architecture })), { tools,
+                concurrency }), (architecture === undefined ? {} : { architecture })), { persistent,
+                tools,
                 skills,
                 extensions,
                 connections,

package/dist/internal/discovery/channels.js

@@ -56,8 +56,8 @@ export function loadChannels(ctx_1, channelsDir_1) {
                         severity: "error",
                         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;
                 }
@@ -69,7 +69,7 @@ export function loadChannels(ctx_1, channelsDir_1) {
                     severity: "error",
                     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;
@@ -78,7 +78,7 @@ export function loadChannels(ctx_1, channelsDir_1) {
                 ctx.diagnostics.push({
                     severity: "error",
                     path: displayPath(ctx, entryPath),
-                    message: "The channel id `http` is reserved for the built-in HTTP channel; use httpChannel() to configure it.",
+                    message: "The channel id `http` is reserved for the built-in HTTP session channel.",
                 });
                 continue;
             }

package/dist/internal/discovery/connections.js

@@ -37,7 +37,7 @@ function hasAuthorizationHeader(headers) {
     if (headers === undefined) {
         return false;
     }
-    return Object.keys(headers).some((key) => key.toLowerCase() === "authorization");
+    return Object.keys(headers).some(key => key.toLowerCase() === "authorization");
 }
 function parseConnectionEffects(effects) {
     if (effects === undefined) {
@@ -63,7 +63,7 @@ function parseConnectionTools(tools) {
     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);
@@ -109,7 +109,7 @@ export function loadHostConnections(ctx, agentDir, modelConnections) {
     return __awaiter(this, void 0, void 0, function* () {
         const hostDir = join(agentDir, "host-connections");
         const loaded = yield loadConnections(ctx, hostDir, "host");
-        const modelNames = new Set(modelConnections.map((connection) => connection.name));
+        const modelNames = new Set(modelConnections.map(connection => connection.name));
         const hostConnections = [];
         for (const connection of loaded) {
             if (modelNames.has(connection.name)) {
@@ -330,7 +330,7 @@ export function compileConnection(ctx, entryPath, name, connection, role) {
         if ("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",
                 path: displayPath(ctx, entryPath),