@cursor/july 0.1.84 → 0.1.86

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

@@ -29,17 +29,17 @@ var __rest = (this && this.__rest) || function (s, e) {
 };
 import { CursorRelayCore } from "./cursor-relay-core.js";
 const DEFAULT_EVENTS = ["deployment.succeeded"];
-/** Normalize the channel's `repos` option into concrete subscriptions. */
+/** Normalize the channel's `deploySourceUris` option into concrete subscriptions. */
 export function resolveDeploymentSubscriptions(options) {
     var _a, _b, _c, _d;
-    const byRepo = new Map();
-    for (const entry of options.repos) {
-        const subscription = typeof entry === "string" ? { repo: entry } : entry;
-        // Case-folded only: `Deployment.repository` has no documented format, and
-        // the server keys subscriptions the same way.
-        const repo = subscription.repo.trim().toLowerCase();
-        if (repo === "") {
-            throw new Error(`deploymentsChannel: invalid repo "${subscription.repo}".`);
+    const bySource = new Map();
+    for (const entry of options.deploySourceUris) {
+        const subscription = typeof entry === "string" ? { deploySourceUri: entry } : entry;
+        // Case-folded only: `Deployment.deploy_source_uri` has no documented
+        // format, and the server keys subscriptions the same way.
+        const deploySourceUri = subscription.deploySourceUri.trim().toLowerCase();
+        if (deploySourceUri === "") {
+            throw new Error(`deploymentsChannel: invalid deploy source "${subscription.deploySourceUri}".`);
         }
         const environments = [
             ...new Set(((_b = (_a = subscription.environments) !== null && _a !== void 0 ? _a : options.environments) !== null && _b !== void 0 ? _b : [])
@@ -48,13 +48,13 @@ export function resolveDeploymentSubscriptions(options) {
         ];
         const events = new Set((_d = (_c = subscription.events) !== null && _c !== void 0 ? _c : options.events) !== null && _d !== void 0 ? _d : DEFAULT_EVENTS);
         if (events.size === 0) {
-            throw new Error(`deploymentsChannel: repo "${repo}" subscribes to no events.`);
+            throw new Error(`deploymentsChannel: deploy source "${deploySourceUri}" subscribes to no events.`);
         }
-        // Later entries for the same repo widen the earlier one rather than
-        // silently replacing it.
-        const existing = byRepo.get(repo);
+        // Later entries for the same deploy source widen the earlier one rather
+        // than silently replacing it.
+        const existing = bySource.get(deploySourceUri);
         if (existing === undefined) {
-            byRepo.set(repo, { repo, environments, events });
+            bySource.set(deploySourceUri, { deploySourceUri, environments, events });
             continue;
         }
         for (const event of events)
@@ -65,9 +65,10 @@ export function resolveDeploymentSubscriptions(options) {
                 : [...new Set([...existing.environments, ...environments])];
     }
     // Empty is legal here and means "this channel wants nothing", which is how
-    // an env-configured channel stays inert without a repo list. The wire-level
-    // empty list means deregister, so the host simply never registers it.
-    return [...byRepo.values()];
+    // an env-configured channel stays inert without a deploy-source list. The
+    // wire-level empty list means deregister, so the host simply never
+    // registers it.
+    return [...bySource.values()];
 }
 /** Whether one confirmed subscription wants this event. */
 export function deploymentEventMatches(subscription, envelope) {
@@ -89,7 +90,7 @@ export function deploymentEventMatches(subscription, envelope) {
 export function fanOutDeploymentEvent(input) {
     return __awaiter(this, void 0, void 0, function* () {
         const { event, logger } = input;
-        const matched = input.targets.filter((target) => target.subscriptions.some((subscription) => subscription.repo === event.repo &&
+        const matched = input.targets.filter((target) => target.subscriptions.some((subscription) => subscription.deploySourceUri === event.deploySourceUri &&
             deploymentEventMatches(subscription, event)));
         const failures = [];
         for (const target of matched) {
@@ -101,7 +102,7 @@ export function fanOutDeploymentEvent(input) {
                 logger(`[agent-sdk] deployment-events: ${target.name} failed on ${event.eventId}: ${error instanceof Error ? error.message : String(error)}`);
             }
         }
-        logger(`[agent-sdk] deployment-events: ${event.eventType} ${event.repo}@${event.sha} (${event.environment}) → ${matched.length - failures.length}/${matched.length} channel(s)`);
+        logger(`[agent-sdk] deployment-events: ${event.eventType} ${event.deploySourceUri}@${event.deployVersion} (${event.environment}) → ${matched.length - failures.length}/${matched.length} channel(s)`);
         if (failures.length > 0 && failures.length === matched.length) {
             throw new Error(`deployment-events: every subscribed channel failed on ${event.eventId} (${failures.join(", ")})`);
         }
@@ -111,7 +112,7 @@ export class DeploymentEventRelay {
     constructor(options) {
         this.options = options;
         this.subscribed = new Map();
-        this.loggedSkippedRepos = new Set();
+        this.loggedSkippedSources = new Set();
         const adapter = {
             logPrefix: "deployment-events",
             subscribePath: "/v0/deployment-events/subscriptions",
@@ -119,7 +120,7 @@ export class DeploymentEventRelay {
             buildRegistrationBody: (consumerId) => ({
                 consumerId,
                 subscriptions: options.subscriptions.map((subscription) => ({
-                    repo: subscription.repo,
+                    deploySourceUri: subscription.deploySourceUri,
                     environments: subscription.environments,
                     events: [...subscription.events],
                 })),
@@ -134,17 +135,17 @@ export class DeploymentEventRelay {
                 var _a, _b;
                 const result = json;
                 this.subscribed = new Map();
-                this.loggedSkippedRepos.clear();
+                this.loggedSkippedSources.clear();
                 const lines = [];
                 const confirmed = [];
-                for (const status of (_a = result.repos) !== null && _a !== void 0 ? _a : []) {
-                    const wanted = options.subscriptions.find((subscription) => subscription.repo === status.repo);
+                for (const status of (_a = result.deploySourceUris) !== null && _a !== void 0 ? _a : []) {
+                    const wanted = options.subscriptions.find((subscription) => subscription.deploySourceUri === status.deploySourceUri);
                     if (!status.isSubscribed || wanted === undefined) {
-                        lines.push(`not subscribed to ${status.repo}: ${(_b = status.detail) !== null && _b !== void 0 ? _b : "unknown reason"}`);
+                        lines.push(`not subscribed to ${status.deploySourceUri}: ${(_b = status.detail) !== null && _b !== void 0 ? _b : "unknown reason"}`);
                         continue;
                     }
-                    this.subscribed.set(status.repo, wanted);
-                    confirmed.push(status.repo);
+                    this.subscribed.set(status.deploySourceUri, wanted);
+                    confirmed.push(status.deploySourceUri);
                 }
                 if (confirmed.length > 0) {
                     const kinds = [
@@ -177,14 +178,14 @@ export class DeploymentEventRelay {
         const envelope = event;
         if (envelope === null ||
             typeof envelope !== "object" ||
-            typeof envelope.repo !== "string") {
+            typeof envelope.deploySourceUri !== "string") {
             return false;
         }
-        const subscription = this.subscribed.get(envelope.repo);
+        const subscription = this.subscribed.get(envelope.deploySourceUri);
         if (subscription === undefined) {
-            if (!this.loggedSkippedRepos.has(envelope.repo)) {
-                this.loggedSkippedRepos.add(envelope.repo);
-                this.options.logger(`[agent-sdk] deployment-events: skipping events for ${envelope.repo}: not in this host's subscription (another consumer of this API key likely subscribed it)`);
+            if (!this.loggedSkippedSources.has(envelope.deploySourceUri)) {
+                this.loggedSkippedSources.add(envelope.deploySourceUri);
+                this.options.logger(`[agent-sdk] deployment-events: skipping events for ${envelope.deploySourceUri}: not in this host's subscription (another consumer of this API key likely subscribed it)`);
             }
             return false;
         }

package/dist/internal/handleAgentServeTrigger.d.ts

@@ -13,6 +13,7 @@
 import type { GitHubChannelOptions } from "../channels/github/types.js";
 import type { OriginChannelOptions } from "../channels/origin/types.js";
 import type { ChannelHandlerArgs } from "../types.js";
+import { type RouteLocalIngressContinuation } from "./local-ingress.js";
 export interface AgentServeGitHubTriggerTarget {
     /** Agent mount slug (empty string in single-agent mode). */
     slug: string;
@@ -28,6 +29,8 @@ export interface AgentServeGitHubTriggerEvent {
     eventName: string | null;
     deliveryId?: string;
     targets: AgentServeGitHubTriggerTarget[];
+    /** Local CP ingest. Defaults to {@link routeLocalIngressContinuation}. */
+    routeContinuation?: RouteLocalIngressContinuation;
 }
 export interface AgentServeOriginTriggerTarget {
     slug: string;
@@ -39,6 +42,8 @@ export interface AgentServeOriginTriggerEvent {
     /** Origin envelope JSON (signature already verified by the caller). */
     bodyText: string;
     targets: AgentServeOriginTriggerTarget[];
+    /** Local CP ingest. Defaults to {@link routeLocalIngressContinuation}. */
+    routeContinuation?: RouteLocalIngressContinuation;
 }
 export type AgentServeTriggerEvent = AgentServeGitHubTriggerEvent | AgentServeOriginTriggerEvent;
 export interface AgentServeTriggerTargetResult {

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

@@ -1 +1 @@
-{"version":3,"file":"handleAgentServeTrigger.d.ts","sourceRoot":"","sources":["../../src/internal/handleAgentServeTrigger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAMxE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,6BAA6B;IAC5C,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,OAAO,EAAE,oBAAoB,CAAC;IAC9B,uEAAuE;IACvE,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,QAAQ,CAAC;IACf,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,6BAA6B,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,oBAAoB,CAAC;IAC9B,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,QAAQ,CAAC;IACf,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,6BAA6B,EAAE,CAAC;CAC1C;AAED,MAAM,MAAM,sBAAsB,GAC9B,4BAA4B,GAC5B,4BAA4B,CAAC;AAEjC,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,6BAA6B,EAAE,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACpD,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,kBAAkB,CAAC;KAC7D,CAAC,CAAC;CACJ,GAAG,6BAA6B,EAAE,CAgBlC;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACpD,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,kBAAkB,CAAC;KAC7D,CAAC,CAAC;CACJ,GAAG,6BAA6B,EAAE,CAgBlC;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CAalC"}
+{"version":3,"file":"handleAgentServeTrigger.d.ts","sourceRoot":"","sources":["../../src/internal/handleAgentServeTrigger.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AAOxE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAEL,KAAK,6BAA6B,EACnC,MAAM,oBAAoB,CAAC;AAE5B,MAAM,WAAW,6BAA6B;IAC5C,4DAA4D;IAC5D,IAAI,EAAE,MAAM,CAAC;IACb,oEAAoE;IACpE,OAAO,EAAE,oBAAoB,CAAC;IAC9B,uEAAuE;IACvE,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,QAAQ,CAAC;IACf,mEAAmE;IACnE,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,6BAA6B,EAAE,CAAC;IACzC,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,6BAA6B,CAAC;CACnD;AAED,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,oBAAoB,CAAC;IAC9B,IAAI,EAAE,kBAAkB,CAAC;CAC1B;AAED,MAAM,WAAW,4BAA4B;IAC3C,IAAI,EAAE,QAAQ,CAAC;IACf,uEAAuE;IACvE,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,6BAA6B,EAAE,CAAC;IACzC,0EAA0E;IAC1E,iBAAiB,CAAC,EAAE,6BAA6B,CAAC;CACnD;AAED,MAAM,MAAM,sBAAsB,GAC9B,4BAA4B,GAC5B,4BAA4B,CAAC;AAEjC,MAAM,WAAW,6BAA6B;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,OAAO,CAAC;IACZ,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,6BAA6B,EAAE,CAAC;CAC1C;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACpD,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,kBAAkB,CAAC;KAC7D,CAAC,CAAC;CACJ,GAAG,6BAA6B,EAAE,CAgBlC;AAED;;;GAGG;AACH,wBAAgB,2BAA2B,CAAC,KAAK,EAAE;IACjD,MAAM,EAAE,KAAK,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,KAAK,CAAC;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,UAAU,EAAE,MAAM,CAAA;SAAE,CAAC,CAAC;QACpD,gBAAgB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,kBAAkB,CAAC;KAC7D,CAAC,CAAC;CACJ,GAAG,6BAA6B,EAAE,CAgBlC;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,sBAAsB,GAC5B,OAAO,CAAC,uBAAuB,CAAC,CAalC"}

package/dist/internal/handleAgentServeTrigger.js

@@ -20,7 +20,8 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
     });
 };
 import { dispatchGitHubWebhook, getGitHubChannelOptions, } from "../channels/github/github-channel.js";
-import { dispatchOriginWebhook, getOriginChannelOptions, parseOriginWebhookEnvelope, } from "../channels/origin/origin-channel.js";
+import { dispatchOriginWebhook, getOriginChannelOptions, originIngressExtractPayload, parseOriginWebhookEnvelope, } from "../channels/origin/origin-channel.js";
+import { bindLocalIngressSend, } from "./local-ingress.js";
 /**
  * Build fan-out targets from mounted agent projects that export a github
  * channel created via {@link githubChannel}.
@@ -108,12 +109,17 @@ function handleAgentServeGitHubTrigger(event) {
         }
         const targets = [];
         for (const target of event.targets) {
+            const args = event.eventName === null
+                ? target.args
+                : bindLocalIngressSend(target.args, Object.assign({ identity: target.options.continuation, kind: "github", eventType: event.eventName, payload }, (event.routeContinuation === undefined
+                    ? {}
+                    : { routeContinuation: event.routeContinuation })));
             const response = yield dispatchGitHubWebhook({
                 options: target.options,
                 eventName: event.eventName,
                 payload,
                 deliveryId: event.deliveryId,
-                args: target.args,
+                args,
             });
             targets.push(yield triggerTargetResult(target.slug, response));
         }
@@ -162,7 +168,9 @@ function handleAgentServeOriginTrigger(event) {
             const response = yield dispatchOriginWebhook({
                 options: target.options,
                 envelope,
-                args: target.args,
+                args: bindLocalIngressSend(target.args, Object.assign({ identity: target.options.continuation, kind: "origin", eventType: envelope.event.type, payload: originIngressExtractPayload(envelope) }, (event.routeContinuation === undefined
+                    ? {}
+                    : { routeContinuation: event.routeContinuation }))),
             });
             targets.push(yield triggerTargetResult(target.slug, response));
         }

package/dist/internal/local-control-plane.d.ts

@@ -2,9 +2,28 @@
  * In-process control plane started with local `serve`. Owns schedule clocks
  * and reminder documents + clocks, then fires into the kit the same way the
  * Cursor backend does over HTTP when `--no-control-plane` is set.
+ *
+ * v2 ingest lives here: `routeContinuation` stamps the mailbox (July twin
+ * of hosted `routeVerifiedIngressContinuation`), and `attachScmEvents`
+ * owns the `/v0/scm-events` long poll. v1 keeps engine-side scm-events.
+ * Hosted `--no-control-plane` v2 skips that poll — the hosted CP delivers.
  */
+import { type LocalIngressContinuation, type RouteLocalIngressContinuationInput } from "./local-ingress.js";
 import type { PlatformTimers } from "./platform-timers.js";
 export interface LocalControlPlane extends PlatformTimers {
+    /**
+     * Stamp a v2 mailbox from the channel selector + live payload. Same
+     * contract as hosted verified ingress. `/v1` is a no-op.
+     */
+    routeContinuation(input: RouteLocalIngressContinuationInput): LocalIngressContinuation;
+    /**
+     * Take ownership of the v2 `/v0/scm-events` long poll. Starts the relay.
+     * v1 scm-events stay on the engine serve path.
+     */
+    attachScmEvents(relay: {
+        start(): void;
+        stop(): Promise<void>;
+    }): void;
     /** Arm persisted reminder clocks after the kit fire callback is live. */
     startClocks(): void;
     stop(): void;

package/dist/internal/local-control-plane.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"local-control-plane.d.ts","sourceRoot":"","sources":["../../src/internal/local-control-plane.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAI3D,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD,yEAAyE;IACzE,WAAW,IAAI,IAAI,CAAC;IACpB,IAAI,IAAI,IAAI,CAAC;CACd;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CA6J7B"}
+{"version":3,"file":"local-control-plane.d.ts","sourceRoot":"","sources":["../../src/internal/local-control-plane.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAIH,OAAO,EACL,KAAK,wBAAwB,EAC7B,KAAK,kCAAkC,EAExC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAI3D,MAAM,WAAW,iBAAkB,SAAQ,cAAc;IACvD;;;OAGG;IACH,iBAAiB,CACf,KAAK,EAAE,kCAAkC,GACxC,wBAAwB,CAAC;IAC5B;;;OAGG;IACH,eAAe,CAAC,KAAK,EAAE;QAAE,KAAK,IAAI,IAAI,CAAC;QAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IACvE,yEAAyE;IACzE,WAAW,IAAI,IAAI,CAAC;IACpB,IAAI,IAAI,IAAI,CAAC;CACd;AAED,wBAAsB,uBAAuB,CAAC,IAAI,EAAE;IAClD,YAAY,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IACjD,YAAY,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAClE;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;CACjC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAwK7B"}

package/dist/internal/local-control-plane.js

@@ -2,6 +2,11 @@
  * In-process control plane started with local `serve`. Owns schedule clocks
  * and reminder documents + clocks, then fires into the kit the same way the
  * Cursor backend does over HTTP when `--no-control-plane` is set.
+ *
+ * v2 ingest lives here: `routeContinuation` stamps the mailbox (July twin
+ * of hosted `routeVerifiedIngressContinuation`), and `attachScmEvents`
+ * owns the `/v0/scm-events` long poll. v1 keeps engine-side scm-events.
+ * Hosted `--no-control-plane` v2 skips that poll — the hosted CP delivers.
  */
 var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
     function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
@@ -14,6 +19,7 @@ var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, ge
 };
 import { dirname, join } from "node:path";
 import { parseCron } from "./cron.js";
+import { routeLocalIngressContinuation, } from "./local-ingress.js";
 import { MAX_TIMER_MS } from "./reminder-schedule.js";
 import { ReminderStore } from "./reminder-store.js";
 export function createLocalControlPlane(opts) {
@@ -29,6 +35,7 @@ export function createLocalControlPlane(opts) {
         const reminders = new Map();
         let scheduleTimer;
         let lastFiredMinute = -1;
+        let scmRelay;
         if (store !== undefined) {
             for (const record of yield store.list()) {
                 reminders.set(record.id, record);
@@ -109,6 +116,12 @@ export function createLocalControlPlane(opts) {
             reminderTimers.set(record.id, timer);
         }
         return {
+            routeContinuation: routeLocalIngressContinuation,
+            attachScmEvents(relay) {
+                scmRelay = relay;
+                relay.start();
+                logger("[agent-sdk] cursor-events: control-plane ingest started");
+            },
             upsertSchedule(input) {
                 return __awaiter(this, void 0, void 0, function* () {
                     schedules.set(input.name, parseCron(input.cron));
@@ -166,6 +179,10 @@ export function createLocalControlPlane(opts) {
                 for (const id of [...reminderTimers.keys()]) {
                     clearReminderTimer(id);
                 }
+                if (scmRelay !== undefined) {
+                    void scmRelay.stop();
+                    scmRelay = undefined;
+                }
             },
         };
     });

package/dist/internal/local-ingress.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Local control-plane ingest for v2 continuation.
+ *
+ * Twin of backend `routeVerifiedIngressContinuation`. Hosted Cursor runs
+ * that copy after the webhook is verified. Self-hosted / `july serve`
+ * runs this copy on the in-process local CP before the channel adapter
+ * `send()`s. Channel adapters do not extract.
+ */
+import type { ChannelHandlerArgs } from "../types.js";
+import { type ContinuationIdentity, type MailboxContinuation } from "./continuation-identity.js";
+export type LocalIngressContinuation = {
+    explicitContinuationKey?: string;
+    mailboxContinuation?: MailboxContinuation;
+};
+export type RouteLocalIngressContinuation = (input: RouteLocalIngressContinuationInput) => LocalIngressContinuation;
+export type RouteLocalIngressContinuationInput = {
+    identity?: ContinuationIdentity;
+    kind?: string;
+    eventType: string;
+    payload: unknown;
+    deterministicContinuationKey?: string;
+};
+/**
+ * Selector + live payload → mailbox stamp. `/v1` and omitted identity
+ * keep the caller-supplied deterministic key and do not stamp a mailbox.
+ */
+export declare function routeLocalIngressContinuation(input: RouteLocalIngressContinuationInput): LocalIngressContinuation;
+/**
+ * Bind a CP mailbox stamp onto `args.send` so the channel adapter only
+ * calls `send()` — it does not extract. No-op for `/v1`.
+ */
+export declare function bindLocalIngressSend(args: ChannelHandlerArgs, input: RouteLocalIngressContinuationInput & {
+    routeContinuation?: RouteLocalIngressContinuation;
+}): ChannelHandlerArgs;
+//# sourceMappingURL=local-ingress.d.ts.map

package/dist/internal/local-ingress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-ingress.d.ts","sourceRoot":"","sources":["../../src/internal/local-ingress.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAEL,KAAK,oBAAoB,EAEzB,KAAK,mBAAmB,EAGzB,MAAM,4BAA4B,CAAC;AAEpC,MAAM,MAAM,wBAAwB,GAAG;IACrC,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,mBAAmB,CAAC,EAAE,mBAAmB,CAAC;CAC3C,CAAC;AAEF,MAAM,MAAM,6BAA6B,GAAG,CAC1C,KAAK,EAAE,kCAAkC,KACtC,wBAAwB,CAAC;AAE9B,MAAM,MAAM,kCAAkC,GAAG;IAC/C,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,4BAA4B,CAAC,EAAE,MAAM,CAAC;CACvC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,kCAAkC,GACxC,wBAAwB,CA6B1B;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,kBAAkB,EACxB,KAAK,EAAE,kCAAkC,GAAG;IAC1C,iBAAiB,CAAC,EAAE,6BAA6B,CAAC;CACnD,GACA,kBAAkB,CAOpB"}

package/dist/internal/local-ingress.js

@@ -0,0 +1,44 @@
+/**
+ * Local control-plane ingest for v2 continuation.
+ *
+ * Twin of backend `routeVerifiedIngressContinuation`. Hosted Cursor runs
+ * that copy after the webhook is verified. Self-hosted / `july serve`
+ * runs this copy on the in-process local CP before the channel adapter
+ * `send()`s. Channel adapters do not extract.
+ */
+import { bindMailboxContinuationSend, continuationSource, normalizeIdentity, stampMailboxContinuation, } from "./continuation-identity.js";
+/**
+ * Selector + live payload → mailbox stamp. `/v1` and omitted identity
+ * keep the caller-supplied deterministic key and do not stamp a mailbox.
+ */
+export function routeLocalIngressContinuation(input) {
+    if (input.identity === undefined) {
+        return Object.assign({}, (input.deterministicContinuationKey === undefined
+            ? {}
+            : { explicitContinuationKey: input.deterministicContinuationKey }));
+    }
+    const identity = normalizeIdentity(input.identity, input.kind);
+    if (continuationSource(identity, input.kind) !== "control-plane") {
+        return Object.assign({}, (input.deterministicContinuationKey === undefined
+            ? {}
+            : { explicitContinuationKey: input.deterministicContinuationKey }));
+    }
+    const mailboxContinuation = stampMailboxContinuation(identity, input.eventType, input.payload, input.kind);
+    if (mailboxContinuation.key.startsWith("cont:")) {
+        return {
+            explicitContinuationKey: mailboxContinuation.key,
+            mailboxContinuation,
+        };
+    }
+    return { mailboxContinuation };
+}
+/**
+ * Bind a CP mailbox stamp onto `args.send` so the channel adapter only
+ * calls `send()` — it does not extract. No-op for `/v1`.
+ */
+export function bindLocalIngressSend(args, input) {
+    var _a;
+    const route = (_a = input.routeContinuation) !== null && _a !== void 0 ? _a : routeLocalIngressContinuation;
+    const routed = route(input);
+    return Object.assign(Object.assign({}, args), { send: bindMailboxContinuationSend(args.send, routed.mailboxContinuation) });
+}

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/internal/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0CH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAOhB,YAAY,EACb,MAAM,aAAa,CAAC;AAwHrB,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAwBpE,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;CACvB;AAaD,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,YAAY,GAAG,0BAA+B,GACtD,OAAO,CAAC,gBAAgB,CAAC,CAo0B3B"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/internal/server.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AA0CH,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAOhB,YAAY,EACb,MAAM,aAAa,CAAC;AAyHrB,OAAO,EAAE,KAAK,WAAW,EAAmB,MAAM,iBAAiB,CAAC;AAwBpE,8EAA8E;AAC9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,YAAY,CAAC;CACvB;AAmCD,6EAA6E;AAC7E,MAAM,WAAW,0BAA0B;IACzC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED;;;;GAIG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,UAAU,EAAE,EACpB,OAAO,GAAE,YAAY,GAAG,0BAA+B,GACtD,OAAO,CAAC,gBAAgB,CAAC,CAy3B3B"}