@sentry/junior-github 0.120.0 → 0.121.0

package/SETUP.md

@@ -83,10 +83,13 @@ status, Issue comment, Pull request review, and Pull request review comment
 events.
 
 `github_getDeployment` reads the latest deployment and status for an exact
-repository, environment, and commit SHA. When webhooks are configured, its
-result can subscribe the current conversation to deployment creation, progress,
-success, failure, and error events. The subscription remains available when
-GitHub has not created the deployment yet.
+repository and commit SHA, optionally limited to one environment. When
+webhooks are configured, its result can subscribe the current conversation to
+deployment creation, progress, success, failure, and error events. Omitting the
+environment watches deployments for that commit across environments. The
+subscription remains available when GitHub has not created the deployment yet.
+Commit-wide watches remain active across terminal outcomes so later
+environments for the same commit can also notify the conversation.
 
 ```bash
 vercel env add GITHUB_WEBHOOK_SECRET production

package/dist/{chunk-EPYBKNXS.js → chunk-NNSOXVGR.js}

@@ -18,12 +18,12 @@ var SUGGESTED_EVENTS = [
 ];
 function gitHubDeploymentSourceResource(input) {
   const commitSha = input.commitSha.toLowerCase();
-  const environment = input.environment.trim();
+  const environment = input.environment?.trim();
   const repo = input.repo.toLowerCase();
   return {
     label: `GitHub deployment for ${repo} at ${commitSha.slice(0, 12)}`,
     provider: "github",
-    resourceRef: `github:deployment-source:${repo}:${encodeURIComponent(environment.toLowerCase())}:${commitSha}`
+    resourceRef: environment ? `github:deployment-source:${repo}:${encodeURIComponent(environment.toLowerCase())}:${commitSha}` : `github:deployment-source:${repo}:${commitSha}`
   };
 }
 function gitHubDeploymentSourceSubscribable(input) {
@@ -112,21 +112,16 @@ function parseDeploymentEvent(body) {
 }
 function normalizeDeploymentEvent(deliveryId, body) {
   const parsed = parseDeploymentEvent(body);
-  if (!parsed || parsed.action !== "created") return void 0;
-  const resource = gitHubDeploymentSourceResource({
-    commitSha: parsed.commitSha,
-    environment: parsed.environment,
-    repo: parsed.repo
-  });
+  if (!parsed || parsed.action !== "created") return [];
   const eventType = "deployment.created";
-  return {
+  return deploymentSourceTargets(parsed).map(({ resource }) => ({
     eventKey: gitHubEventKey(deliveryId, eventType),
     eventType,
     occurredAtMs: providerTime(parsed.createdAt) ?? Date.now(),
     provider: "github",
     resourceRef: resource.resourceRef,
     trustedSummary: `${resource.label} was created (deployment ${parsed.deploymentId}).`
-  };
+  }));
 }
 var deploymentStatusWebhookSchema = z.object({
   action: z.string(),
@@ -176,26 +171,38 @@ function deploymentStatusEventType(state) {
 }
 function normalizeDeploymentStatusEvent(deliveryId, body) {
   const parsed = parseDeploymentStatusEvent(body);
-  if (!parsed || parsed.action !== "created") return void 0;
+  if (!parsed || parsed.action !== "created") return [];
   const eventType = deploymentStatusEventType(parsed.state);
-  if (!eventType) return void 0;
-  const resource = gitHubDeploymentSourceResource({
-    commitSha: parsed.commitSha,
-    environment: parsed.environment,
-    repo: parsed.repo
-  });
+  if (!eventType) return [];
   const outcome = eventType === "deployment.succeeded" ? "succeeded" : eventType === "deployment.failed" ? "failed" : eventType === "deployment.error" ? "reported an error" : eventType === "deployment.in_progress" ? "started" : `is ${parsed.state}`;
   const terminal = eventType === "deployment.succeeded" || eventType === "deployment.failed" || eventType === "deployment.error";
-  return {
-    eventKey: gitHubEventKey(deliveryId, eventType),
-    eventType,
-    occurredAtMs: providerTime(parsed.statusCreatedAt) ?? Date.now(),
-    provider: "github",
-    resourceRef: resource.resourceRef,
-    ...terminal ? { terminal: true } : {},
-    trustedSummary: `${resource.label} ${outcome} (deployment ${parsed.deploymentId}).`,
-    untrustedText: parsed.description ?? void 0
-  };
+  return deploymentSourceTargets(parsed).map(
+    ({ completeOnTerminalEvent, resource }) => ({
+      eventKey: gitHubEventKey(deliveryId, eventType),
+      eventType,
+      occurredAtMs: providerTime(parsed.statusCreatedAt) ?? Date.now(),
+      provider: "github",
+      resourceRef: resource.resourceRef,
+      ...terminal && completeOnTerminalEvent ? { terminal: true } : {},
+      trustedSummary: `${resource.label} ${outcome} (deployment ${parsed.deploymentId}).`,
+      untrustedText: parsed.description ?? void 0
+    })
+  );
+}
+function deploymentSourceTargets(input) {
+  return [
+    {
+      completeOnTerminalEvent: true,
+      resource: gitHubDeploymentSourceResource(input)
+    },
+    {
+      completeOnTerminalEvent: false,
+      resource: gitHubDeploymentSourceResource({
+        commitSha: input.commitSha,
+        repo: input.repo
+      })
+    }
+  ];
 }
 var checkSuiteWebhookSchema = z.object({
   action: z.string(),
@@ -361,12 +368,10 @@ function normalizePullRequestEvent(deliveryId, body) {
 function normalizeGitHubResourceEvents(args) {
   switch (args.eventName) {
     case "deployment": {
-      const event = normalizeDeploymentEvent(args.deliveryId, args.body);
-      return event ? [event] : [];
+      return normalizeDeploymentEvent(args.deliveryId, args.body);
     }
     case "deployment_status": {
-      const event = normalizeDeploymentStatusEvent(args.deliveryId, args.body);
-      return event ? [event] : [];
+      return normalizeDeploymentStatusEvent(args.deliveryId, args.body);
     }
     case "pull_request": {
       const event = normalizePullRequestEvent(args.deliveryId, args.body);

package/dist/index.js

@@ -2,7 +2,7 @@ import {
   gitHubDeploymentSourceSubscribable,
   gitHubPullRequestSubscribable,
   normalizeGitHubResourceEvents
-} from "./chunk-EPYBKNXS.js";
+} from "./chunk-NNSOXVGR.js";
 
 // src/plugin.ts
 import {
@@ -537,7 +537,9 @@ var inputSchema = z2.object({
   commitSha: commitShaSchema.describe(
     "Full 40-character Git commit SHA recorded by the deployment."
   ),
-  environment: z2.string().trim().min(1).describe('GitHub deployment environment, such as "Production".')
+  environment: z2.string().trim().min(1).describe(
+    'Optional GitHub deployment environment, such as "Production". Omit to inspect and watch deployments for the commit across environments.'
+  ).optional()
 }).strict();
 var statusSchema = z2.object({
   createdAt: z2.string(),
@@ -563,7 +565,7 @@ var deploymentSchema = z2.object({
 var deploymentSourceSchema = z2.object({
   commitSha: commitShaSchema,
   deployment: deploymentSchema.nullable(),
-  environment: z2.string(),
+  environment: z2.string().nullable(),
   repo: z2.string(),
   subscribable: subscribableResourceSchema.optional()
 }).strict();
@@ -623,7 +625,7 @@ function repositoryUrl(repo, path) {
 }
 function createGitHubGetDeploymentTool(ctx) {
   return definePluginTool2({
-    description: "Get the latest GitHub deployment and status for an exact repository, environment, and full commit SHA. The result remains subscribable when no deployment exists yet, so use it before waiting for a deployment outcome.",
+    description: "Get the latest GitHub deployment and status for an exact repository and full commit SHA, optionally limited to one environment. The result remains subscribable when no deployment exists yet, so use it before waiting for a deployment outcome.",
     inputSchema,
     outputSchema,
     async execute(input) {
@@ -631,7 +633,9 @@ function createGitHubGetDeploymentTool(ctx) {
       const commitSha = input.commitSha.toLowerCase();
       const deploymentsUrl = new URL(repositoryUrl(repo, "deployments"));
       deploymentsUrl.searchParams.set("sha", commitSha);
-      deploymentsUrl.searchParams.set("environment", input.environment);
+      if (input.environment) {
+        deploymentsUrl.searchParams.set("environment", input.environment);
+      }
       deploymentsUrl.searchParams.set("per_page", "1");
       const deploymentsResponse = await ctx.egress.fetch({
         provider: "github",
@@ -705,7 +709,7 @@ function createGitHubGetDeploymentTool(ctx) {
       const data = {
         commitSha,
         deployment,
-        environment: input.environment,
+        environment: input.environment ?? null,
         repo: repo.ref,
         ...subscribable ? { subscribable } : {}
       };
@@ -1073,6 +1077,7 @@ import {
 } from "@sentry/junior-plugin-api";
 import { z as z4 } from "zod";
 import { subscribableResourceSchema as subscribableResourceSchema3 } from "@sentry/junior-plugin-api";
+var commitShaSchema2 = z4.string().regex(/^[0-9a-f]{40}$/i);
 var inputSchema2 = z4.object({
   repo: z4.string().describe('Repository in "owner/name" format.'),
   number: z4.number().int().positive().describe("Pull request number.")
@@ -1081,6 +1086,7 @@ var pullRequestSchema = z4.object({
   base: z4.string(),
   draft: z4.boolean(),
   head: z4.string(),
+  headSha: commitShaSchema2,
   merged: z4.boolean(),
   number: z4.number(),
   state: z4.string(),
@@ -1139,7 +1145,7 @@ function createGitHubGetPullRequestTool(ctx) {
       const providerResult = z4.object({
         base: z4.object({ ref: z4.string() }),
         draft: z4.boolean(),
-        head: z4.object({ ref: z4.string() }),
+        head: z4.object({ ref: z4.string(), sha: commitShaSchema2 }),
         html_url: z4.string(),
         merged: z4.boolean().optional().default(false),
         number: z4.number(),
@@ -1154,6 +1160,7 @@ function createGitHubGetPullRequestTool(ctx) {
         base: providerResult.base.ref,
         draft: providerResult.draft,
         head: providerResult.head.ref,
+        headSha: providerResult.head.sha.toLowerCase(),
         merged: providerResult.merged,
         number: providerResult.number,
         state: providerResult.state,

package/dist/resource-events/deployment.d.ts

@@ -3,12 +3,12 @@ export declare const GITHUB_DEPLOYMENT_EVENTS: readonly ["deployment.created", "
 /** Build the stable deployment-source identity shared by tools and webhooks. */
 export declare function gitHubDeploymentSourceResource(input: {
     commitSha: string;
-    environment: string;
+    environment?: string;
     repo: string;
 }): Pick<SubscribableResource, "label" | "provider" | "resourceRef">;
 /** Describe a deployment source when GitHub webhooks are enabled. */
 export declare function gitHubDeploymentSourceSubscribable(input: {
     commitSha: string;
-    environment: string;
+    environment?: string;
     repo: string;
 }): SubscribableResource | undefined;

package/dist/testing.js

@@ -1,6 +1,6 @@
 import {
   normalizeGitHubResourceEvents
-} from "./chunk-EPYBKNXS.js";
+} from "./chunk-NNSOXVGR.js";
 export {
   normalizeGitHubResourceEvents
 };

package/dist/tools/get-deployment.d.ts

@@ -3,7 +3,7 @@ import { type ToolRegistrationHookContext } from "@sentry/junior-plugin-api";
 export declare function createGitHubGetDeploymentTool(ctx: ToolRegistrationHookContext): import("@sentry/junior-plugin-api").PluginToolDefinition<{
     repo: string;
     commitSha: string;
-    environment: string;
+    environment?: string | undefined;
 }, {
     commitSha: string;
     deployment: {
@@ -26,7 +26,7 @@ export declare function createGitHubGetDeploymentTool(ctx: ToolRegistrationHookC
         updatedAt: string;
         url: string;
     } | null;
-    environment: string;
+    environment: string | null;
     repo: string;
     data: {
         commitSha: string;
@@ -50,7 +50,7 @@ export declare function createGitHubGetDeploymentTool(ctx: ToolRegistrationHookC
             updatedAt: string;
             url: string;
         } | null;
-        environment: string;
+        environment: string | null;
         repo: string;
         subscribable?: {
             label: string;

package/dist/tools/get-pull-request.d.ts

@@ -8,6 +8,7 @@ export declare function createGitHubGetPullRequestTool(ctx: ToolRegistrationHook
     base: string;
     draft: boolean;
     head: string;
+    headSha: string;
     merged: boolean;
     number: number;
     state: string;
@@ -20,6 +21,7 @@ export declare function createGitHubGetPullRequestTool(ctx: ToolRegistrationHook
         base: string;
         draft: boolean;
         head: string;
+        headSha: string;
         merged: boolean;
         number: number;
         state: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentry/junior-github",
-  "version": "0.120.0",
+  "version": "0.121.0",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -31,7 +31,7 @@
     "@sinclair/typebox": "^0.34.49",
     "drizzle-orm": "^0.45.2",
     "zod": "^4.4.3",
-    "@sentry/junior-plugin-api": "0.120.0"
+    "@sentry/junior-plugin-api": "0.121.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",