@sentry/junior-github 0.105.0 → 0.106.0

package/dist/index.js

@@ -472,6 +472,42 @@ import {
 import { Type as Type2 } from "@sinclair/typebox";
 import { Value as Value2 } from "@sinclair/typebox/value";
 import { z as z2 } from "zod";
+import { subscribableResourceSchema } from "@sentry/junior-plugin-api";
+
+// src/resource-events/pull-request.ts
+var SUPPORTED_EVENTS = [
+  "checks.failed",
+  "checks.recovered",
+  "comment.created",
+  "review.approved",
+  "review.changes_requested",
+  "review.commented",
+  "review_comment.created",
+  "state.merged",
+  "state.closed_unmerged"
+];
+var SUGGESTED_EVENTS = [
+  "checks.failed",
+  "comment.created",
+  "review.changes_requested",
+  "review.commented",
+  "review_comment.created",
+  "state.merged",
+  "state.closed_unmerged"
+];
+function gitHubPullRequestSubscribable(input) {
+  if (!process.env.GITHUB_WEBHOOK_SECRET?.trim()) return void 0;
+  return {
+    label: `GitHub PR ${input.repo}#${input.number}`,
+    provider: "github",
+    resourceRef: `github:pull_request:${input.repo}#${input.number}`,
+    suggestedEvents: SUGGESTED_EVENTS,
+    supportedEvents: SUPPORTED_EVENTS,
+    type: "pull_request"
+  };
+}
+
+// src/tools/create-pull-request.ts
 var GITHUB_PULL_REQUEST_CREATE_IDEMPOTENCY_TTL_MS = 30 * 24 * 60 * 60 * 1e3;
 var GITHUB_PULL_REQUEST_CREATE_LOCK_TTL_MS = 6e4;
 var GitHubPullRequestCreateRejectedError = class extends Error {
@@ -537,14 +573,6 @@ var createPullRequestStateSchema = Type2.Union([
     { additionalProperties: false }
   )
 ]);
-var subscribableResourceSchema = z2.object({
-  provider: z2.string(),
-  type: z2.string(),
-  resourceRef: z2.string(),
-  label: z2.string(),
-  supportedEvents: z2.array(z2.string()),
-  suggestedEvents: z2.array(z2.string()).optional()
-}).strict();
 var gitHubPullRequestDataSchema = z2.object({
   number: z2.number(),
   url: z2.string(),
@@ -706,45 +734,13 @@ async function createGitHubPullRequest(ctx, request) {
     url: pullRequest.html_url
   };
 }
-function gitHubPullRequestSubscribable(input, result) {
-  const repo = parseRepo2(input.repo);
-  const repoRef = `${repo.owner}/${repo.name}`;
-  const supportedEvents = [
-    "checks.failed",
-    "checks.recovered",
-    "comment.created",
-    "review.approved",
-    "review.changes_requested",
-    "review.commented",
-    "review_comment.created",
-    "state.merged",
-    "state.closed_unmerged"
-  ];
-  return {
-    label: `GitHub PR ${repoRef}#${result.number}`,
-    provider: "github",
-    resourceRef: `github:pull_request:${repoRef}#${result.number}`,
-    suggestedEvents: [
-      "checks.failed",
-      "comment.created",
-      "review.changes_requested",
-      "review.commented",
-      "review_comment.created",
-      "state.merged",
-      "state.closed_unmerged"
-    ],
-    supportedEvents,
-    type: "pull_request"
-  };
-}
 function gitHubPullRequestToolResult(input, result) {
-  if (!process.env.GITHUB_WEBHOOK_SECRET?.trim()) {
-    return result;
-  }
-  return {
-    ...result,
-    subscribable: gitHubPullRequestSubscribable(input, result)
-  };
+  const repo = parseRepo2(input.repo);
+  const subscribable = gitHubPullRequestSubscribable({
+    number: result.number,
+    repo: `${repo.owner}/${repo.name}`
+  });
+  return { ...result, ...subscribable ? { subscribable } : {} };
 }
 function gitHubPullRequestStructuredResult(input, result) {
   const data = gitHubPullRequestToolResult(input, result);
@@ -832,11 +828,119 @@ function createGitHubPullRequestTool(ctx) {
   });
 }
 
+// src/tools/get-pull-request.ts
+import {
+  definePluginTool as definePluginTool3,
+  PluginToolInputError as PluginToolInputError4,
+  pluginToolResultSchema as pluginToolResultSchema3
+} from "@sentry/junior-plugin-api";
+import { z as z3 } from "zod";
+import { subscribableResourceSchema as subscribableResourceSchema2 } from "@sentry/junior-plugin-api";
+var inputSchema = z3.object({
+  repo: z3.string().describe('Repository in "owner/name" format.'),
+  number: z3.number().int().positive().describe("Pull request number.")
+}).strict();
+var pullRequestSchema = z3.object({
+  base: z3.string(),
+  draft: z3.boolean(),
+  head: z3.string(),
+  merged: z3.boolean(),
+  number: z3.number(),
+  state: z3.string(),
+  subscribable: subscribableResourceSchema2.optional(),
+  title: z3.string(),
+  url: z3.string()
+});
+var outputSchema = pluginToolResultSchema3.extend({
+  ok: z3.literal(true),
+  status: z3.literal("success"),
+  target: z3.literal("getPullRequest"),
+  data: pullRequestSchema,
+  ...pullRequestSchema.shape
+});
+function parseRepo3(value) {
+  const parts = value.split("/").map((part) => part.trim());
+  if (parts.length !== 2 || !parts[0] || !parts[1]) {
+    throw new PluginToolInputError4('repo must use "owner/name" format');
+  }
+  return { owner: parts[0], name: parts[1], ref: `${parts[0]}/${parts[1]}` };
+}
+async function readJson(response) {
+  const text = await response.text();
+  if (!text) return void 0;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+function createGitHubGetPullRequestTool(ctx) {
+  return definePluginTool3({
+    description: "Get a GitHub pull request. Use this when an existing PR may need resource-event monitoring; the result includes a subscribable hint when GitHub webhooks are configured.",
+    inputSchema,
+    outputSchema,
+    async execute(input) {
+      const repo = parseRepo3(input.repo);
+      const response = await ctx.egress.fetch({
+        provider: "github",
+        operation: "github.pull.get",
+        request: new Request(
+          `https://api.github.com/repos/${encodeURIComponent(repo.owner)}/${encodeURIComponent(repo.name)}/pulls/${input.number}`,
+          {
+            headers: {
+              Accept: "application/vnd.github+json",
+              "X-GitHub-Api-Version": "2022-11-28"
+            }
+          }
+        )
+      });
+      const parsed = await readJson(response);
+      if (!response.ok)
+        throw new Error(
+          `GitHub pull request lookup failed with HTTP ${response.status}`
+        );
+      const providerResult = z3.object({
+        base: z3.object({ ref: z3.string() }),
+        draft: z3.boolean(),
+        head: z3.object({ ref: z3.string() }),
+        html_url: z3.string(),
+        merged: z3.boolean().optional().default(false),
+        number: z3.number(),
+        state: z3.string(),
+        title: z3.string()
+      }).parse(parsed);
+      const subscribable = gitHubPullRequestSubscribable({
+        number: providerResult.number,
+        repo: repo.ref
+      });
+      const data = {
+        base: providerResult.base.ref,
+        draft: providerResult.draft,
+        head: providerResult.head.ref,
+        merged: providerResult.merged,
+        number: providerResult.number,
+        state: providerResult.state,
+        ...subscribable ? { subscribable } : {},
+        title: providerResult.title,
+        url: providerResult.html_url
+      };
+      return {
+        ok: true,
+        status: "success",
+        target: "getPullRequest",
+        data,
+        ...data
+      };
+    }
+  });
+}
+
 // src/tools.ts
 function createGitHubTools(ctx) {
   return {
     createIssue: createGitHubIssueTool(ctx),
-    createPullRequest: createGitHubPullRequestTool(ctx)
+    createPullRequest: createGitHubPullRequestTool(ctx),
+    getPullRequest: createGitHubGetPullRequestTool(ctx)
   };
 }
 

package/dist/resource-events/pull-request.d.ts

@@ -0,0 +1,6 @@
+import type { SubscribableResource } from "@sentry/junior-plugin-api";
+/** Build the stable resource identity shared by GitHub PR tool results and webhooks. */
+export declare function gitHubPullRequestSubscribable(input: {
+    number: number;
+    repo: string;
+}): SubscribableResource | undefined;

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

@@ -16,11 +16,11 @@ export declare function createGitHubPullRequestTool(ctx: ToolRegistrationHookCon
         number: number;
         url: string;
         subscribable?: {
+            label: string;
             provider: string;
-            type: string;
             resourceRef: string;
-            label: string;
             supportedEvents: string[];
+            type: string;
             suggestedEvents?: string[] | undefined;
         } | undefined;
     };
@@ -37,11 +37,11 @@ export declare function createGitHubPullRequestTool(ctx: ToolRegistrationHookCon
         retryable?: boolean | undefined;
     } | undefined;
     subscribable?: {
+        label: string;
         provider: string;
-        type: string;
         resourceRef: string;
-        label: string;
         supportedEvents: string[];
+        type: string;
         suggestedEvents?: string[] | undefined;
     } | undefined;
 }>;

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

@@ -0,0 +1,55 @@
+import { type ToolRegistrationHookContext } from "@sentry/junior-plugin-api";
+/** Read one PR and expose its stable subscription identity when webhooks are enabled. */
+export declare function createGitHubGetPullRequestTool(ctx: ToolRegistrationHookContext): import("@sentry/junior-plugin-api").PluginToolDefinition<{
+    repo: string;
+    number: number;
+}, {
+    [x: string]: unknown;
+    base: string;
+    draft: boolean;
+    head: string;
+    merged: boolean;
+    number: number;
+    state: string;
+    title: string;
+    url: string;
+    ok: true;
+    status: "success";
+    target: "getPullRequest";
+    data: {
+        base: string;
+        draft: boolean;
+        head: string;
+        merged: boolean;
+        number: number;
+        state: string;
+        title: string;
+        url: string;
+        subscribable?: {
+            label: string;
+            provider: string;
+            resourceRef: string;
+            supportedEvents: string[];
+            type: string;
+            suggestedEvents?: string[] | undefined;
+        } | undefined;
+    };
+    truncated?: boolean | undefined;
+    continuation?: {
+        arguments: Record<string, unknown>;
+        reason?: string | undefined;
+    } | undefined;
+    error?: string | {
+        kind: string;
+        message: string;
+        retryable?: boolean | undefined;
+    } | undefined;
+    subscribable?: {
+        label: string;
+        provider: string;
+        resourceRef: string;
+        supportedEvents: string[];
+        type: string;
+        suggestedEvents?: string[] | undefined;
+    } | undefined;
+}>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sentry/junior-github",
-  "version": "0.105.0",
+  "version": "0.106.0",
   "private": false,
   "publishConfig": {
     "access": "public"
@@ -25,7 +25,7 @@
   "dependencies": {
     "@sinclair/typebox": "^0.34.49",
     "zod": "^4.4.3",
-    "@sentry/junior-plugin-api": "0.105.0"
+    "@sentry/junior-plugin-api": "0.106.0"
   },
   "devDependencies": {
     "@types/node": "^25.9.1",