npm - @cursor/july - Versions diffs - 0.1.84 → 0.1.86 - Mend

@cursor/july 0.1.84 → 0.1.86

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (116) hide show

package/dist/channels/deployments/deployments-channel.d.ts +2 -2
package/dist/channels/deployments/deployments-channel.d.ts.map +1 -1
package/dist/channels/deployments/deployments-channel.js +7 -6
package/dist/channels/deployments/index.d.ts +2 -3
package/dist/channels/deployments/index.d.ts.map +1 -1
package/dist/channels/deployments/index.js +2 -3
package/dist/channels/deployments/types.d.ts +14 -14
package/dist/channels/deployments/types.d.ts.map +1 -1
package/dist/channels/github/github-channel.d.ts +4 -0
package/dist/channels/github/github-channel.d.ts.map +1 -1
package/dist/channels/github/github-channel.js +18 -11
package/dist/channels/origin/origin-channel.d.ts +6 -0
package/dist/channels/origin/origin-channel.d.ts.map +1 -1
package/dist/channels/origin/origin-channel.js +24 -11
package/dist/channels/slack/dispatch.d.ts.map +1 -1
package/dist/channels/slack/dispatch.js +12 -2
package/dist/docs/404.html +2 -2
package/dist/docs/ab.html +3 -3
package/dist/docs/assets/{app.kqdC1N7p.js → app.DUOPbN18.js} +1 -1
package/dist/docs/assets/chunks/@localSearchIndexroot.CxCtxfDE.js +1 -0
package/dist/docs/assets/chunks/{VPLocalSearchBox.DXDE2WgG.js → VPLocalSearchBox.CmWbGcGk.js} +1 -1
package/dist/docs/assets/chunks/{theme.DFYqbyta.js → theme.S57OeOLA.js} +2 -2
package/dist/docs/assets/{reference_channels.md.G5GysZ7e.js → reference_channels.md.CboFd5IH.js} +1 -1
package/dist/docs/building-with-agents.html +3 -3
package/dist/docs/concepts.html +3 -3
package/dist/docs/deployment.html +3 -3
package/dist/docs/evals.html +3 -3
package/dist/docs/example-agents/approval-buddy.html +3 -3
package/dist/docs/example-agents/benny.html +3 -3
package/dist/docs/example-agents/bugbot.html +3 -3
package/dist/docs/example-agents/codebase-wiki.html +3 -3
package/dist/docs/example-agents/codeowners-review.html +3 -3
package/dist/docs/example-agents/concierge.html +3 -3
package/dist/docs/example-agents/fsd.html +3 -3
package/dist/docs/example-agents/index.html +3 -3
package/dist/docs/example-agents/knowledge-base.html +3 -3
package/dist/docs/example-agents/oncall.html +3 -3
package/dist/docs/example-agents/security-reviewer.html +3 -3
package/dist/docs/example-agents/slack-agent.html +3 -3
package/dist/docs/example-agents/weather-agent.html +3 -3
package/dist/docs/guides/agent-to-agent.html +3 -3
package/dist/docs/guides/cloud-runtime.html +3 -3
package/dist/docs/guides/convert-automation.html +3 -3
package/dist/docs/guides/github.html +3 -3
package/dist/docs/guides/human-in-the-loop.html +3 -3
package/dist/docs/guides/mcp-oauth.html +3 -3
package/dist/docs/guides/opentelemetry.html +3 -3
package/dist/docs/guides/slack.html +3 -3
package/dist/docs/guides/webhooks.html +3 -3
package/dist/docs/hashmap.json +1 -1
package/dist/docs/hillclimbing.html +3 -3
package/dist/docs/index.html +3 -3
package/dist/docs/quickstart.html +3 -3
package/dist/docs/reference/agent-config.html +3 -3
package/dist/docs/reference/artifacts.html +3 -3
package/dist/docs/reference/channels.html +5 -5
package/dist/docs/reference/cli.html +3 -3
package/dist/docs/reference/connections.html +3 -3
package/dist/docs/reference/hooks.html +3 -3
package/dist/docs/reference/http-api.html +3 -3
package/dist/docs/reference/instructions.html +3 -3
package/dist/docs/reference/playground.html +3 -3
package/dist/docs/reference/project-layout.html +3 -3
package/dist/docs/reference/prompt.html +3 -3
package/dist/docs/reference/schedules.html +3 -3
package/dist/docs/reference/sessions.html +3 -3
package/dist/docs/reference/skills.html +3 -3
package/dist/docs/reference/subagents.html +3 -3
package/dist/docs/reference/tools.html +3 -3
package/dist/docs/scaffolding-agents.html +3 -3
package/dist/docs/storage.html +3 -3
package/dist/docs/templates/agentic-owners.html +3 -3
package/dist/docs/templates/demo.html +3 -3
package/dist/docs/templates/pr-autofixer.html +3 -3
package/dist/docs/templates/security-reviewer.html +3 -3
package/dist/docs/templates/triage.html +3 -3
package/dist/docs/troubleshooting.html +3 -3
package/dist/internal/continuation-identity.d.ts +10 -0
package/dist/internal/continuation-identity.d.ts.map +1 -1
package/dist/internal/continuation-identity.js +10 -0
package/dist/internal/cursor-deployment-relay.d.ts +4 -4
package/dist/internal/cursor-deployment-relay.d.ts.map +1 -1
package/dist/internal/cursor-deployment-relay.js +33 -32
package/dist/internal/handleAgentServeTrigger.d.ts +5 -0
package/dist/internal/handleAgentServeTrigger.d.ts.map +1 -1
package/dist/internal/handleAgentServeTrigger.js +11 -3
package/dist/internal/local-control-plane.d.ts +19 -0
package/dist/internal/local-control-plane.d.ts.map +1 -1
package/dist/internal/local-control-plane.js +17 -0
package/dist/internal/local-ingress.d.ts +35 -0
package/dist/internal/local-ingress.d.ts.map +1 -0
package/dist/internal/local-ingress.js +44 -0
package/dist/internal/server.d.ts.map +1 -1
package/dist/internal/server.js +151 -75
package/dist/playground/assets/{index-Cspgk9jC.js → index-Bqn91tW4.js} +45 -45
package/dist/playground/assets/index-C0_5hOsf.css +1 -0
package/dist/playground/index.html +2 -2
package/dist/types.d.ts +2 -2
package/docs/reference/channels.md +13 -11
package/package.json +1 -1
package/src/channels/deployments/deployments-channel.ts +7 -6
package/src/channels/deployments/index.ts +2 -3
package/src/channels/deployments/types.ts +14 -14
package/src/channels/github/github-channel.ts +18 -21
package/src/channels/origin/origin-channel.ts +26 -15
package/src/channels/slack/dispatch.ts +11 -7
package/src/internal/continuation-identity.ts +10 -0
package/src/internal/cursor-deployment-relay.ts +38 -36
package/src/internal/handleAgentServeTrigger.ts +31 -2
package/src/internal/local-control-plane.ts +33 -0
package/src/internal/local-ingress.ts +90 -0
package/src/internal/server.ts +194 -40
package/src/types.ts +2 -2
package/dist/docs/assets/chunks/@localSearchIndexroot.BqhvUA76.js +0 -1
package/dist/playground/assets/index-ChETdG-_.css +0 -1
/package/dist/docs/assets/{reference_channels.md.G5GysZ7e.lean.js → reference_channels.md.CboFd5IH.lean.js} +0 -0

package/dist/playground/index.html CHANGED Viewed

@@ -8,8 +8,8 @@
     />
     <meta name="viewport" content="width=device-width, initial-scale=1" />
     <title>agent-serve playground</title>
-    <script type="module" crossorigin src="./assets/index-Cspgk9jC.js"></script>
-    <link rel="stylesheet" crossorigin href="./assets/index-ChETdG-_.css">
+    <script type="module" crossorigin src="./assets/index-Bqn91tW4.js"></script>
+    <link rel="stylesheet" crossorigin href="./assets/index-C0_5hOsf.css">
   </head>
   <body>
     <div id="root"></div>

package/dist/types.d.ts CHANGED Viewed

@@ -1463,8 +1463,8 @@ export interface SendMessageOptions {
      */
     continuationToken?: string;
     /**
-     * v2 mailbox stamp from the control plane (or the pack's builtin extract
-     * on local serve). Ignored on v1.
+     * v2 mailbox stamp from the control plane (hosted verified ingress or
+     * the local CP). Channel adapters do not extract. Ignored on v1.
      */
     mailboxContinuation?: MailboxContinuation;
     /**

package/docs/reference/channels.md CHANGED Viewed

@@ -218,19 +218,21 @@ converge a merge-box check and sticky PR comment from default stream
 events. Guide: [GitHub](../guides/github.md).
 **Deployments** (`@cursor/july/channels/deployments`): pull transport
-over `/v0/deployment-events`. Subscribe per repository with `repos`,
-narrow with `environments` / `events`, and handle each event in
-`onEvent`. `repos` must match `Deployment.repository` as your deployment
-writer records it; the field has no format, and matching is
-case-insensitive but otherwise literal.
+over `/v0/deployment-events`. Subscribe per deploy source with
+`deploySourceUris`, narrow with `environments` / `events`, and handle
+each event in `onEvent`. `deploySourceUris` must match
+`Deployment.deploy_source_uri` as your deployment writer records it; the
+field has no format, and matching is case-insensitive but otherwise
+literal. Each event carries `deploySourceUri` and `deployVersion`.
 Author `agent/channels/deployments.ts` with `deploymentsChannel()`. The
 serve host discovers every mounted deployments channel, runs one relay
-for the process against the union of their repositories, and routes each
-event to the channels that asked for it — the same ownership the Slack
-and SCM relays have. It authenticates with the host credential and keeps
-a durable offset, so a restart resumes rather than dropping events. An
-empty `repos` list mounts the channel but starts no relay for it, so an
-env-configured agent stays inert until its repositories are set.
+for the process against the union of their deploy sources, and routes
+each event to the channels that asked for it; the Slack and SCM relays
+use the same ownership. It authenticates with the host credential and
+keeps a durable offset, so a restart resumes rather than dropping
+events. An empty `deploySourceUris` list mounts the channel but starts
+no relay for it, so an env-configured agent stays inert until its
+deploy sources are set.
 For other platforms like Discord or Teams, use the authored
 `defineChannel` webhook form.

package/package.json CHANGED Viewed

@@ -1,6 +1,6 @@
 {
   "name": "@cursor/july",
-  "version": "0.1.84",
+  "version": "0.1.86",
   "description": "(early alpha) Filesystem-first framework for defining Cursor agents as markdown and TypeScript and serving them over channels with the Cursor SDK.",
   "license": "SEE LICENSE IN LICENSE.md",
   "repository": {

package/src/channels/deployments/deployments-channel.ts CHANGED Viewed

@@ -14,11 +14,11 @@ const deploymentEventSchema = z.object({
   eventType: z.enum(DEPLOYMENT_EVENT_TYPES),
   eventId: z.string().min(1),
   teamId: z.number(),
-  repo: z.string().min(1),
+  deploySourceUri: z.string().min(1),
   deploymentId: z.string().min(1),
   environment: z.string().min(1),
   service: z.string().min(1).optional(),
-  sha: z.string().min(1),
+  deployVersion: z.string().min(1),
   status: z.enum(["pending", "in_progress", "success", "failed"]),
   occurredAtMs: z.number(),
 });
@@ -60,10 +60,10 @@ export async function dispatchDeploymentEvent(input: {
  * import { deploymentsChannel } from "@cursor/july/channels/deployments";
  *
  * export default deploymentsChannel({
- *   repos: ["repos/anysphere/everysphere"], // as your writer records it
+ *   deploySourceUris: ["https://origin.cursor.com/repos/anysphere/everysphere"],
  *   environments: ["prod"],
  *   onEvent: async (event, { send }) => {
- *     await send(`${event.repo}@${event.sha} shipped to ${event.environment}`);
+ *     await send(`${event.deploySourceUri}@${event.deployVersion} shipped to ${event.environment}`);
  *   },
  * });
  * ```
@@ -81,8 +81,9 @@ export async function dispatchDeploymentEvent(input: {
 export function deploymentsChannel(
   options: DeploymentsChannelOptions
 ): ChannelDefinition {
-  // Throws here rather than at startup, so a malformed `repos` entry fails
-  // when the channel module is authored instead of when the host mounts it.
+  // Throws here rather than at startup, so a malformed `deploySourceUris`
+  // entry fails when the channel module is authored instead of when the host
+  // mounts it.
   resolveDeploymentSubscriptions(options);
   const routePath = options.path ?? "/";

package/src/channels/deployments/index.ts CHANGED Viewed

@@ -5,9 +5,8 @@
  * import { deploymentsChannel } from "@cursor/july/channels/deployments";
  *
  * export default deploymentsChannel({
- *   repos: ["repos/anysphere/everysphere"], // as your writer records it
- *   environments: ["prod"],
- *   onEvent: (event, { send }) => send(`${event.sha} shipped`),
+ *   deploySourceUris: ["https://origin.cursor.com/repos/anysphere/everysphere"],
+ *   onEvent: (event, { send }) => send(`${event.deployVersion} shipped`),
  * });
  * ```
  *

package/src/channels/deployments/types.ts CHANGED Viewed

@@ -18,25 +18,25 @@ export interface DeploymentEvent {
   eventId: string;
   /** Owning Cursor team. */
   teamId: number;
-  /** The Deployment's repository string, case-folded. */
-  repo: string;
+  /** The Deployment's deploy_source_uri string, case-folded. */
+  deploySourceUri: string;
   deploymentId: string;
   /** Environment slug, e.g. `prod`. */
   environment: string;
   /** Absent when the deployment records no service. */
   service?: string;
-  sha: string;
+  deployVersion: string;
   status: DeploymentStatus;
   occurredAtMs: number;
 }
-/** What a repository subscription asks for. */
+/** What a deploy-source subscription asks for. */
 export interface DeploymentSubscription {
   /**
-   * The repository string as the factory records it on a Deployment. Opaque:
+   * The deploy-source URI as the factory records it on a Deployment. Opaque:
    * whatever your deployment writer puts there, matched case-insensitively.
    */
-  repo: string;
+  deploySourceUri: string;
   /** Omit or leave empty for every environment. */
   environments?: readonly string[];
   /** Defaults to `deployment.succeeded`. */
@@ -45,18 +45,18 @@ export interface DeploymentSubscription {
 export interface DeploymentsChannelOptions {
   /**
-   * Repositories to watch, spelled exactly as your deployment writer records
-   * `Deployment.repository`. The field has no format — whatever the writer
-   * puts there is the key — and matching is case-insensitive but otherwise
-   * literal, so a value that does not match subscribes successfully and then
-   * receives nothing. A bare string takes the default environment and event
-   * filters.
+   * Deploy sources to watch, spelled exactly as your deployment writer records
+   * `Deployment.deploy_source_uri`. The field has no format — whatever the
+   * writer puts there is the key — and matching is case-insensitive but
+   * otherwise literal, so a value that does not match subscribes successfully
+   * and then receives nothing. A bare string takes the default environment and
+   * event filters.
    *
-   * There is no team-wide subscription: every repository is named. At least
+   * There is no team-wide subscription: every deploy source is named. At least
    * one is required — an empty list is how a consumer *deregisters*, so it
    * cannot also mean "everything".
    */
-  repos: readonly (string | DeploymentSubscription)[];
+  deploySourceUris: readonly (string | DeploymentSubscription)[];
   /**
    * Applied to every subscription that does not set its own. Omit or leave
    * empty for every environment.

package/src/channels/github/github-channel.ts CHANGED Viewed

@@ -8,12 +8,11 @@ import {
   POST,
 } from "../../channels.js";
 import {
-  bindMailboxContinuationSend,
   continuationSource,
   normalizeIdentity,
-  stampMailboxContinuation,
 } from "../../internal/continuation-identity.js";
 import { isDevMode } from "../../internal/dev-mode.js";
+import { bindLocalIngressSend } from "../../internal/local-ingress.js";
 import type {
   AgentCloudOptions,
   ArtifactsApi,
@@ -477,6 +476,10 @@ function verifyWebhookSha256Signature(args: {
  * {@link handleAgentServeTrigger} fan-out. Signature verification is the
  * caller's responsibility (HTTP route verifies; internal fan-out skips).
  */
+/**
+ * Run authored GitHub hooks and `send()`. Does not extract a v2 mailbox —
+ * the local CP (or hosted verified ingress) stamps before this runs.
+ */
 export async function dispatchGitHubWebhook(input: {
   options: GitHubChannelOptions;
   eventName: string | null;
@@ -484,23 +487,7 @@ export async function dispatchGitHubWebhook(input: {
   deliveryId?: string;
   args: ChannelHandlerArgs;
 }): Promise<Response> {
-  const identity = normalizeIdentity(input.options.continuation, "github");
-  let args = input.args;
-  if (
-    continuationSource(identity, "github") === "control-plane" &&
-    input.eventName !== null
-  ) {
-    const mailbox = stampMailboxContinuation(
-      identity,
-      input.eventName,
-      input.payload
-    );
-    args = {
-      ...input.args,
-      send: bindMailboxContinuationSend(input.args.send, mailbox),
-    };
-  }
-  return dispatchGitHubWebhookInner({ ...input, args });
+  return dispatchGitHubWebhookInner(input);
 }
 async function dispatchGitHubWebhookInner(input: {
@@ -644,12 +631,22 @@ export async function handleGitHubWebhookRequest(input: {
     return Response.json({ ok: false, error: "invalid_json" }, { status: 400 });
   }
+  const eventName = input.request.headers.get("x-github-event");
+  const args =
+    eventName === null
+      ? input.args
+      : bindLocalIngressSend(input.args, {
+          identity: input.options.continuation,
+          kind: "github",
+          eventType: eventName,
+          payload,
+        });
   return dispatchGitHubWebhook({
     options: input.options,
-    eventName: input.request.headers.get("x-github-event"),
+    eventName,
     payload,
     deliveryId: input.request.headers.get("x-github-delivery") ?? undefined,
-    args: input.args,
+    args,
   });
 }

package/src/channels/origin/origin-channel.ts CHANGED Viewed

@@ -7,12 +7,11 @@ import {
   POST,
 } from "../../channels.js";
 import {
-  bindMailboxContinuationSend,
   continuationSource,
   normalizeIdentity,
-  stampMailboxContinuation,
 } from "../../internal/continuation-identity.js";
 import { isDevMode } from "../../internal/dev-mode.js";
+import { bindLocalIngressSend } from "../../internal/local-ingress.js";
 import type {
   AgentCloudOptions,
   AuthContext,
@@ -364,6 +363,20 @@ export function originContinuationKey(
   return `origin-pr:${ctx.repository.fullName}#${ctx.pullRequestNumber}`;
 }
+/** Payload shape local/hosted CP extract expects (`fullName` + number). */
+export function originIngressExtractPayload(
+  envelope: OriginWebhookEnvelope
+): unknown {
+  const parsed = parseOriginPullRequestEvent({ envelope });
+  if (parsed === null) {
+    return envelope.event.payload;
+  }
+  return {
+    pullRequest: { number: parsed.ctx.pullRequestNumber },
+    repository: { fullName: parsed.ctx.repository.fullName },
+  };
+}
 export function defaultOriginTitle(
   ctx: Pick<OriginEventContext, "repository" | "pullRequestNumber">
 ): string {
@@ -532,6 +545,10 @@ async function applyDispatch(input: {
  * {@link handleAgentServeTrigger} fan-out. Signature verification is the
  * caller's responsibility (HTTP route verifies; internal fan-out skips).
  */
+/**
+ * Run authored Origin hooks and `send()`. Does not extract a v2 mailbox —
+ * the local CP (or hosted verified ingress) stamps before this runs.
+ */
 export async function dispatchOriginWebhook(input: {
   options: OriginChannelOptions;
   envelope: OriginWebhookEnvelope;
@@ -545,18 +562,7 @@ export async function dispatchOriginWebhook(input: {
       { status: 400 }
     );
   }
-  const identity = normalizeIdentity(input.options.continuation, "origin");
-  let args = input.args;
-  if (continuationSource(identity, "origin") === "control-plane") {
-    const mailbox = stampMailboxContinuation(identity, eventType, {
-      pullRequest: { number: parsed.ctx.pullRequestNumber },
-      repository: { fullName: parsed.ctx.repository.fullName },
-    });
-    args = {
-      ...input.args,
-      send: bindMailboxContinuationSend(input.args.send, mailbox),
-    };
-  }
+  const args = input.args;
   const ctx = enrichEventContext({
     ctx: parsed.ctx,
     args,
@@ -711,7 +717,12 @@ export async function handleOriginWebhookRequest(input: {
   return dispatchOriginWebhook({
     options: input.options,
     envelope,
-    args: input.args,
+    args: bindLocalIngressSend(input.args, {
+      identity: input.options.continuation,
+      kind: "origin",
+      eventType: envelope.event.type,
+      payload: originIngressExtractPayload(envelope),
+    }),
   });
 }

package/src/channels/slack/dispatch.ts CHANGED Viewed

@@ -7,8 +7,8 @@ import {
   continuationSource,
   type MailboxContinuation,
   normalizeIdentity,
-  stampMailboxContinuation,
 } from "../../internal/continuation-identity.js";
+import { routeLocalIngressContinuation } from "../../internal/local-ingress.js";
 import type {
   ArtifactsApi,
   HostContext,
@@ -208,12 +208,16 @@ function slackSessionContinuation(
     const key = slackContinuationKey(channelId, threadTs);
     return { probeKey: key, sendPatch: { continuationToken: key } };
   }
-  const mailbox = stampMailboxContinuation(
-    normalizeIdentity(identity, "slack"),
-    "message",
-    { channelId, threadTs },
-    "slack"
-  );
+  const routed = routeLocalIngressContinuation({
+    identity: normalizeIdentity(identity, "slack"),
+    kind: "slack",
+    eventType: "message",
+    payload: { channelId, threadTs },
+  });
+  const mailbox = routed.mailboxContinuation;
+  if (mailbox === undefined) {
+    throw new Error("v2 slack ingress did not stamp a mailbox");
+  }
   return { probeKey: mailbox.key, sendPatch: { mailboxContinuation: mailbox } };
 }

package/src/internal/continuation-identity.ts CHANGED Viewed

@@ -361,6 +361,16 @@ export function extractContinuation(
   }
 }
+/**
+ * Extract primitive used by the control plane (hosted
+ * `routeVerifiedIngressContinuation` and local
+ * `routeLocalIngressContinuation`). Channel adapters must not call this.
+ */
+/**
+ * Extract primitive used by the control plane (hosted
+ * `routeVerifiedIngressContinuation` and local
+ * `routeLocalIngressContinuation`). Channel adapters must not call this.
+ */
 export function stampMailboxContinuation(
   identity: ContinuationIdentity,
   eventName: string,

package/src/internal/cursor-deployment-relay.ts CHANGED Viewed

@@ -22,13 +22,13 @@ const DEFAULT_EVENTS: readonly DeploymentEventType[] = ["deployment.succeeded"];
 export type DeploymentRelayEvent = DeploymentEvent & { offset: string };
 export interface ResolvedSubscription {
-  repo: string;
+  deploySourceUri: string;
   environments: string[];
   events: Set<DeploymentEventType>;
 }
 interface SubscriptionStatus {
-  repo: string;
+  deploySourceUri: string;
   isSubscribed: boolean;
   detail?: string;
 }
@@ -44,22 +44,22 @@ export interface DeploymentEventRelayOptions {
   pollWaitMs?: number;
 }
-/** Normalize the channel's `repos` option into concrete subscriptions. */
+/** Normalize the channel's `deploySourceUris` option into concrete subscriptions. */
 export function resolveDeploymentSubscriptions(options: {
-  repos: readonly (string | DeploymentSubscription)[];
+  deploySourceUris: readonly (string | DeploymentSubscription)[];
   environments?: readonly string[];
   events?: readonly DeploymentEventType[];
 }): ResolvedSubscription[] {
-  const byRepo = new Map<string, ResolvedSubscription>();
-  for (const entry of options.repos) {
+  const bySource = new Map<string, ResolvedSubscription>();
+  for (const entry of options.deploySourceUris) {
     const subscription: DeploymentSubscription =
-      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 === "") {
+      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 repo "${subscription.repo}".`
+        `deploymentsChannel: invalid deploy source "${subscription.deploySourceUri}".`
       );
     }
     const environments = [
@@ -74,14 +74,14 @@ export function resolveDeploymentSubscriptions(options: {
     );
     if (events.size === 0) {
       throw new Error(
-        `deploymentsChannel: repo "${repo}" subscribes to no events.`
+        `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) existing.events.add(event);
@@ -91,9 +91,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. */
@@ -136,7 +137,7 @@ export async function fanOutDeploymentEvent(input: {
   const matched = input.targets.filter((target) =>
     target.subscriptions.some(
       (subscription) =>
-        subscription.repo === event.repo &&
+        subscription.deploySourceUri === event.deploySourceUri &&
         deploymentEventMatches(subscription, event)
     )
   );
@@ -154,7 +155,7 @@ export async function fanOutDeploymentEvent(input: {
     }
   }
   logger(
-    `[agent-sdk] deployment-events: ${event.eventType} ${event.repo}@${event.sha} (${event.environment}) → ${matched.length - failures.length}/${matched.length} channel(s)`
+    `[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(
@@ -166,7 +167,7 @@ export async function fanOutDeploymentEvent(input: {
 export class DeploymentEventRelay {
   private readonly core: CursorRelayCore<DeploymentRelayEvent>;
   private subscribed = new Map<string, ResolvedSubscription>();
-  private readonly loggedSkippedRepos = new Set<string>();
+  private readonly loggedSkippedSources = new Set<string>();
   constructor(private readonly options: DeploymentEventRelayOptions) {
     const adapter: RelayAdapter<DeploymentRelayEvent> = {
@@ -176,7 +177,7 @@ export class DeploymentEventRelay {
       buildRegistrationBody: (consumerId) => ({
         consumerId,
         subscriptions: options.subscriptions.map((subscription) => ({
-          repo: subscription.repo,
+          deploySourceUri: subscription.deploySourceUri,
           environments: subscription.environments,
           events: [...subscription.events],
         })),
@@ -188,23 +189,24 @@ export class DeploymentEventRelay {
         subscriptions: [],
       }),
       applyRegistrationResponse: (json) => {
-        const result = json as { repos?: SubscriptionStatus[] };
+        const result = json as { deploySourceUris?: SubscriptionStatus[] };
         this.subscribed = new Map();
-        this.loggedSkippedRepos.clear();
+        this.loggedSkippedSources.clear();
         const lines: string[] = [];
         const confirmed: string[] = [];
-        for (const status of result.repos ?? []) {
+        for (const status of result.deploySourceUris ?? []) {
           const wanted = options.subscriptions.find(
-            (subscription) => subscription.repo === status.repo
+            (subscription) =>
+              subscription.deploySourceUri === status.deploySourceUri
           );
           if (!status.isSubscribed || wanted === undefined) {
             lines.push(
-              `not subscribed to ${status.repo}: ${status.detail ?? "unknown reason"}`
+              `not subscribed to ${status.deploySourceUri}: ${status.detail ?? "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 = [
@@ -247,16 +249,16 @@ export class DeploymentEventRelay {
     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);
+      if (!this.loggedSkippedSources.has(envelope.deploySourceUri)) {
+        this.loggedSkippedSources.add(envelope.deploySourceUri);
         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)`
+          `[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/src/internal/handleAgentServeTrigger.ts CHANGED Viewed

@@ -19,10 +19,15 @@ import type { GitHubChannelOptions } from "../channels/github/types.js";
 import {
   dispatchOriginWebhook,
   getOriginChannelOptions,
+  originIngressExtractPayload,
   parseOriginWebhookEnvelope,
 } from "../channels/origin/origin-channel.js";
 import type { OriginChannelOptions } from "../channels/origin/types.js";
 import type { ChannelHandlerArgs } from "../types.js";
+import {
+  bindLocalIngressSend,
+  type RouteLocalIngressContinuation,
+} from "./local-ingress.js";
 export interface AgentServeGitHubTriggerTarget {
   /** Agent mount slug (empty string in single-agent mode). */
@@ -40,6 +45,8 @@ export interface AgentServeGitHubTriggerEvent {
   eventName: string | null;
   deliveryId?: string;
   targets: AgentServeGitHubTriggerTarget[];
+  /** Local CP ingest. Defaults to {@link routeLocalIngressContinuation}. */
+  routeContinuation?: RouteLocalIngressContinuation;
 }
 export interface AgentServeOriginTriggerTarget {
@@ -53,6 +60,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 =
@@ -177,12 +186,24 @@ async function handleAgentServeGitHubTrigger(
   const targets: AgentServeTriggerTargetResult[] = [];
   for (const target of event.targets) {
+    const args =
+      event.eventName === null
+        ? target.args
+        : bindLocalIngressSend(target.args, {
+            identity: target.options.continuation,
+            kind: "github",
+            eventType: event.eventName,
+            payload,
+            ...(event.routeContinuation === undefined
+              ? {}
+              : { routeContinuation: event.routeContinuation }),
+          });
     const response = await dispatchGitHubWebhook({
       options: target.options,
       eventName: event.eventName,
       payload,
       deliveryId: event.deliveryId,
-      args: target.args,
+      args,
     });
     targets.push(await triggerTargetResult(target.slug, response));
   }
@@ -234,7 +255,15 @@ async function handleAgentServeOriginTrigger(
     const response = await dispatchOriginWebhook({
       options: target.options,
       envelope,
-      args: target.args,
+      args: bindLocalIngressSend(target.args, {
+        identity: target.options.continuation,
+        kind: "origin",
+        eventType: envelope.event.type,
+        payload: originIngressExtractPayload(envelope),
+        ...(event.routeContinuation === undefined
+          ? {}
+          : { routeContinuation: event.routeContinuation }),
+      }),
     });
     targets.push(await triggerTargetResult(target.slug, response));
   }