@vercel/factory 0.0.15 → 0.0.16

package/dist/github.d.mts

@@ -14,12 +14,16 @@ interface NormalizeFactoryCommentInput extends FactoryMentionOptions {
   event: string;
   payload: unknown;
 }
+/** Select addressed comments and optionally reply candidates whose ownership the caller must verify. */
+interface NormalizeFactoryReviewCommentInput extends NormalizeFactoryCommentInput {
+  includeReplies?: boolean;
+}
 /** Configured repositories and provider observations used to select one trusted repository. */
 interface ConfiguredEventRepositoryInput {
   configuredSlugs: readonly RepositorySlug[];
   eventSlugs: readonly (RepositorySlug | null)[];
 }
-/** Routing metadata extracted from an explicitly addressed pull-request review comment. */
+/** Routing metadata extracted from an addressed inline comment or an opt-in reply candidate. */
 interface FactoryReviewComment {
   repositorySlug: RepositorySlug;
   pullRequestNumber: number;
@@ -40,8 +44,8 @@ interface FactoryQuestionReply {
 }
 /** Select the one configured repository consistently identified by a provider delivery. */
 declare function configuredEventRepositorySlug(input: ConfiguredEventRepositoryInput): RepositorySlug | null;
-/** Normalize an explicitly addressed inline review comment into trusted routing fields. */
-declare function normalizeFactoryReviewComment(input: NormalizeFactoryCommentInput): FactoryReviewComment | null;
+/** Normalize addressed inline comments or opt-in reply candidates; callers must authenticate them. */
+declare function normalizeFactoryReviewComment(input: NormalizeFactoryReviewCommentInput): FactoryReviewComment | null;
 /**
  * Strip the Factory mention from an issue comment body, returning null when the
  * comment does not address Factory. Exported so a caller reconciling a delivery
@@ -90,14 +94,17 @@ interface ReviewCommentTrustInput {
 interface ReadReviewCommentInput extends GitHubPullRequestTarget, ReviewCommentTrustInput {
   commentId: number;
 }
-/** Normalized inline review comment returned by GitHub. */
+/** Normalized inline review comment, with a null author when GitHub no longer exposes it. */
 interface GitHubReviewComment {
   id: number;
   pullRequestNumber: number;
   body: string;
   url: string;
-  author: string;
+  author: string | null;
+  /** GitHub account type when available, used to distinguish human requests from bot activity. */
+  authorType: string | null;
   inReplyToId: number | null;
+  reviewId: number | null;
 }
 /** Trusted inline comment and reply content used to post a threaded answer. */
 interface AnswerReviewCommentInput extends GitHubPullRequestTarget, ReviewCommentTrustInput {
@@ -122,6 +129,7 @@ type PullRequestReviewEvent = "APPROVE" | "REQUEST_CHANGES" | "COMMENT";
 /** One inline finding attached to a submitted pull-request review. */
 interface PullRequestReviewComment {
   path: string;
+  startLine?: number;
   line: number;
   body: string;
 }
@@ -138,13 +146,35 @@ interface SubmittedPullRequestReview {
   url: string;
   state: string;
 }
-/** Normalized issue-style comment from a pull-request conversation. */
+/** Issue-style PR comment, with null author metadata when GitHub no longer exposes it. */
 interface GitHubIssueComment {
   id: number;
   body: string;
   url: string;
-  author: string;
-  authorType: "Bot" | "User" | "Organization";
+  author: string | null;
+  authorType: "Bot" | "User" | "Organization" | null;
+}
+/** Inline discussion entry with its review and source location, including replies. */
+interface GitHubPullRequestDiscussionComment extends GitHubReviewComment {
+  path: string;
+  line: number | null;
+}
+/** Existing PR verdict, retaining null author or commit metadata when unavailable on GitHub. */
+interface GitHubPullRequestDiscussionReview extends SubmittedPullRequestReview {
+  author: string | null;
+  body: string;
+  commitId: string | null;
+}
+/** One bounded page of untrusted PR conversation, inline comments, and prior verdicts. */
+interface GitHubPullRequestDiscussionPage {
+  comments: readonly GitHubIssueComment[];
+  reviewComments: readonly GitHubPullRequestDiscussionComment[];
+  reviews: readonly GitHubPullRequestDiscussionReview[];
+  nextPage: number | null;
+}
+/** Pull request and one-based discussion page to read; each collection returns up to 50 entries. */
+interface ListPullRequestDiscussionInput extends GitHubPullRequestTarget {
+  page?: number;
 }
 /** Repository and pull request whose issue-style comments should be listed. */
 type ListPullRequestCommentsInput = GitHubPullRequestTarget;
@@ -161,6 +191,12 @@ interface UpdatePullRequestCommentInput extends GitHubRepositoryRequest {
 interface PullRequestLabelInput extends GitHubPullRequestTarget {
   label: string;
 }
+/** Repository label to create when absent, retaining any existing color and description. */
+interface EnsureGitHubLabelInput extends GitHubRepositoryRequest {
+  name: string;
+  color: string;
+  description: string;
+}
 /** Open Factory-authored pull request GitHub currently reports as conflicted. */
 interface ConflictedGitHubPullRequest extends GitHubPullRequestReference {
   headBranch: string;
@@ -249,8 +285,8 @@ interface GitHubCheckRun {
 }
 /** Refusal raised when an inline review-comment author lacks repository write access. */
 declare class GitHubReviewCommentAuthorError extends Error {
-  readonly author: string;
-  constructor(author: string);
+  readonly author: string | null;
+  constructor(author: string | null);
 }
 /**
  * The pull request advanced past the commit a review or fix was prepared
@@ -276,6 +312,8 @@ declare function updateCheckRun(input: UpdateCheckRunInput): Promise<GitHubCheck
 declare function listCheckRunsForRef(input: ListCheckRunsForRefInput): Promise<readonly GitHubCheckRun[]>;
 /** List every issue-style comment in a pull request conversation. */
 declare function listPullRequestComments(input: ListPullRequestCommentsInput): Promise<readonly GitHubIssueComment[]>;
+/** Read a page of all PR discussion types without treating any author's text as authorization. */
+declare function listPullRequestDiscussion(input: ListPullRequestDiscussionInput): Promise<GitHubPullRequestDiscussionPage>;
 /** Add one issue-style comment to a pull request conversation. */
 declare function createPullRequestComment(input: CreatePullRequestCommentInput): Promise<GitHubIssueComment>;
 /** Edit one issue-style pull request comment. */
@@ -308,6 +346,8 @@ declare function closePullRequest(input: GitHubPullRequestTarget): Promise<GitHu
 declare function listConflictedPullRequests(input: ListConflictedPullRequestsInput): Promise<readonly ConflictedGitHubPullRequest[]>;
 /** List open pull requests in a repository, newest first, to check for existing work before triage. */
 declare function listOpenPullRequests(input: ListOpenPullRequestsInput): Promise<readonly OpenPullRequest[]>;
+/** Ensure a repository label exists, including when another publisher creates it concurrently. */
+declare function ensureGitHubLabel(input: EnsureGitHubLabelInput): Promise<void>;
 /** Add one label to a pull request. */
 declare function addLabel(input: PullRequestLabelInput): Promise<readonly string[]>;
 /** Remove one label from a pull request. */
@@ -402,5 +442,5 @@ declare function normalizeGitHubPullRequestClosed(options: WebhookEvent): GitHub
 /** Normalize a completed, unsuccessful GitHub Actions run into a CI failure signal. */
 declare function normalizeGitHubWorkflowRunFailure(options: WebhookEvent): GitHubCiFailureSignal | null;
 //#endregion
-export { AnswerReviewCommentInput, CheckRunAnnotation, CheckRunAnnotationLevel, CheckRunConclusion, CheckRunFields, CheckRunOutput, CheckRunProgressStatus, type CheckoutGitHubRepositoryInput, type CommittedGitChange, CompletedCheckRunFields, ConfiguredEventRepositoryInput, ConflictedGitHubPullRequest, CreateCheckRunInput, type CreateGitHubBranchInput, type CreateGitHubCommitInput, type CreateGitHubPublicationPullRequestInput, type CreateGitHubTreeInput, CreatePullRequestCommentInput, CreatePullRequestInput, type CreatedGitHubPublicationPullRequest, CreatedGitHubPullRequest, FactoryMentionOptions, FactoryQuestionReply, FactoryReviewComment, type FetchGitHubBundleInput, type FetchGitHubRefsInput, type GitHubAppFactoryInput, type GitHubAppInstallationToken, type GitHubAppLike, type GitHubAppPermissions, GitHubCheckRun, GitHubCheckoutConflictError, GitHubCiFailureSignal, type GitHubCommit, GitHubDefaultBranchPush, type GitHubGitTransport, GitHubIssueComment, GitHubIssueCommentRecord, GitHubIssueSignal, GitHubPublicationApiError, type GitHubPublicationClient, type GitHubPublicationClientOptions, type GitHubPublicationLimits, type GitHubPublicationPullRequest, GitHubPullRequest, GitHubPullRequestClosed, GitHubPullRequestHead, GitHubPullRequestReference, GitHubPullRequestSignal, GitHubPullRequestTarget, type GitHubRefMapping, GitHubRepositoryAuthorRequest, type GitHubRepositoryBundle, GitHubRepositoryRequest, GitHubReviewComment, GitHubReviewCommentAuthorError, type GitHubTreeDeletion, type GitHubTreeEntry, type GitHubTreeUpsert, type GitTransferSandbox, IncompleteCheckRunFields, ListCheckRunsForRefInput, ListConflictedPullRequestsInput, type ListGitHubPublicationPullRequestsInput, ListOpenPullRequestsInput, ListPullRequestCommentsInput, type MarkGitHubPullRequestReadyInput, type MintGitHubAppInstallationTokenInput, NormalizeFactoryCommentInput, ObservedCheckRunStatus, PullRequestLabelInput, PullRequestReviewComment, PullRequestReviewEvent, type PushGitHubBundleInput, type PushGitHubHeadInput, type ReadCommittedGitChangeInput, type ReadGitHubBranchHeadInput, type ReadGitHubCommitInput, type ReadGitHubPullRequestInput, type ReadGitTransferFileInput, ReadReviewCommentInput, ReviewCommentAuthorPolicy, type RunSandboxGitInput, type SandboxGit, type SandboxGitCommandInput, type SandboxGitCommandResult, StalePullRequestHeadError, SubmitPullRequestReviewInput, SubmittedPullRequestReview, UpdateCheckRunInput, type UpdateGitHubBranchInput, UpdatePullRequestCommentInput, VerifyGitHubSignatureInput, type WithSandboxGitBundleInput, type WriteGitTransferFileInput, addLabel, answerReviewComment, checkoutGitHubRepository, closePullRequest, configuredEventRepositorySlug, createCheckRun, createGitHubPublicationClient, createPullRequest, createPullRequestComment, factorySessionBranch, factoryTaskBranch, hasGitHubRepositoryWriteAccess, isSafeGitRef, listCheckRunsForRef, listConflictedPullRequests, listOpenPullRequests, listPullRequestComments, mintGitHubAppInstallationToken, normalizeFactoryQuestionReply, normalizeFactoryReviewComment, normalizeGitHubDefaultBranchPush, normalizeGitHubIssueOpened, normalizeGitHubPullRequest, normalizeGitHubPullRequestClosed, normalizeGitHubWorkflowRunFailure, readCommittedGitChange, readIssueComment, readPullRequest, readPullRequestHead, readReviewComment, removeLabel, runSandboxGit, stripFactoryQuestionMention, submitPullRequestReview, updateCheckRun, updatePullRequestComment, verifyGitHubSignature };
+export { AnswerReviewCommentInput, CheckRunAnnotation, CheckRunAnnotationLevel, CheckRunConclusion, CheckRunFields, CheckRunOutput, CheckRunProgressStatus, type CheckoutGitHubRepositoryInput, type CommittedGitChange, CompletedCheckRunFields, ConfiguredEventRepositoryInput, ConflictedGitHubPullRequest, CreateCheckRunInput, type CreateGitHubBranchInput, type CreateGitHubCommitInput, type CreateGitHubPublicationPullRequestInput, type CreateGitHubTreeInput, CreatePullRequestCommentInput, CreatePullRequestInput, type CreatedGitHubPublicationPullRequest, CreatedGitHubPullRequest, EnsureGitHubLabelInput, FactoryMentionOptions, FactoryQuestionReply, FactoryReviewComment, type FetchGitHubBundleInput, type FetchGitHubRefsInput, type GitHubAppFactoryInput, type GitHubAppInstallationToken, type GitHubAppLike, type GitHubAppPermissions, GitHubCheckRun, GitHubCheckoutConflictError, GitHubCiFailureSignal, type GitHubCommit, GitHubDefaultBranchPush, type GitHubGitTransport, GitHubIssueComment, GitHubIssueCommentRecord, GitHubIssueSignal, GitHubPublicationApiError, type GitHubPublicationClient, type GitHubPublicationClientOptions, type GitHubPublicationLimits, type GitHubPublicationPullRequest, GitHubPullRequest, GitHubPullRequestClosed, GitHubPullRequestDiscussionComment, GitHubPullRequestDiscussionPage, GitHubPullRequestDiscussionReview, GitHubPullRequestHead, GitHubPullRequestReference, GitHubPullRequestSignal, GitHubPullRequestTarget, type GitHubRefMapping, GitHubRepositoryAuthorRequest, type GitHubRepositoryBundle, GitHubRepositoryRequest, GitHubReviewComment, GitHubReviewCommentAuthorError, type GitHubTreeDeletion, type GitHubTreeEntry, type GitHubTreeUpsert, type GitTransferSandbox, IncompleteCheckRunFields, ListCheckRunsForRefInput, ListConflictedPullRequestsInput, type ListGitHubPublicationPullRequestsInput, ListOpenPullRequestsInput, ListPullRequestCommentsInput, ListPullRequestDiscussionInput, type MarkGitHubPullRequestReadyInput, type MintGitHubAppInstallationTokenInput, NormalizeFactoryCommentInput, NormalizeFactoryReviewCommentInput, ObservedCheckRunStatus, PullRequestLabelInput, PullRequestReviewComment, PullRequestReviewEvent, type PushGitHubBundleInput, type PushGitHubHeadInput, type ReadCommittedGitChangeInput, type ReadGitHubBranchHeadInput, type ReadGitHubCommitInput, type ReadGitHubPullRequestInput, type ReadGitTransferFileInput, ReadReviewCommentInput, ReviewCommentAuthorPolicy, type RunSandboxGitInput, type SandboxGit, type SandboxGitCommandInput, type SandboxGitCommandResult, StalePullRequestHeadError, SubmitPullRequestReviewInput, SubmittedPullRequestReview, UpdateCheckRunInput, type UpdateGitHubBranchInput, UpdatePullRequestCommentInput, VerifyGitHubSignatureInput, type WithSandboxGitBundleInput, type WriteGitTransferFileInput, addLabel, answerReviewComment, checkoutGitHubRepository, closePullRequest, configuredEventRepositorySlug, createCheckRun, createGitHubPublicationClient, createPullRequest, createPullRequestComment, ensureGitHubLabel, factorySessionBranch, factoryTaskBranch, hasGitHubRepositoryWriteAccess, isSafeGitRef, listCheckRunsForRef, listConflictedPullRequests, listOpenPullRequests, listPullRequestComments, listPullRequestDiscussion, mintGitHubAppInstallationToken, normalizeFactoryQuestionReply, normalizeFactoryReviewComment, normalizeGitHubDefaultBranchPush, normalizeGitHubIssueOpened, normalizeGitHubPullRequest, normalizeGitHubPullRequestClosed, normalizeGitHubWorkflowRunFailure, readCommittedGitChange, readIssueComment, readPullRequest, readPullRequestHead, readReviewComment, removeLabel, runSandboxGit, stripFactoryQuestionMention, submitPullRequestReview, updateCheckRun, updatePullRequestComment, verifyGitHubSignature };
 //# sourceMappingURL=github.d.mts.map

package/dist/github.mjs

@@ -11,7 +11,8 @@ const factoryReviewCommentEventSchema = z.looseObject({
 	comment: z.looseObject({
 		id: z.number().int().positive(),
 		body: z.string(),
-		html_url: z.url()
+		html_url: z.url(),
+		in_reply_to_id: z.number().int().positive().nullish()
 	}),
 	pull_request: z.looseObject({
 		number: z.number().int().positive(),
@@ -61,11 +62,11 @@ function configuredEventRepositorySlug(input) {
 	const eventSlug = distinctEventSlugs[0];
 	return distinctEventSlugs.length === 1 && eventSlug !== void 0 && configuredSlugs.includes(eventSlug) ? eventSlug : null;
 }
-/** Normalize an explicitly addressed inline review comment into trusted routing fields. */
+/** Normalize addressed inline comments or opt-in reply candidates; callers must authenticate them. */
 function normalizeFactoryReviewComment(input) {
 	if (input.event !== "pull_request_review_comment") return null;
 	const parsed = factoryReviewCommentEventSchema.safeParse(input.payload);
-	if (!parsed.success || stripMention(parsed.data.comment.body, input.mentions ?? defaultReviewMentions) === null) return null;
+	if (!parsed.success || stripMention(parsed.data.comment.body, input.mentions ?? defaultReviewMentions) === null && !(input.includeReplies && parsed.data.comment.in_reply_to_id != null)) return null;
 	return {
 		repositorySlug: parsed.data.repository.full_name,
 		pullRequestNumber: parsed.data.pull_request.number,
@@ -124,8 +125,12 @@ const reviewCommentSchema = z.object({
 	body: z.string(),
 	html_url: z.url(),
 	pull_request_url: z.url(),
-	user: z.object({ login: z.string().min(1) }),
-	in_reply_to_id: z.number().int().positive().nullish()
+	user: z.object({
+		login: z.string().min(1),
+		type: z.string().optional()
+	}).nullable(),
+	in_reply_to_id: z.number().int().positive().nullish(),
+	pull_request_review_id: z.number().int().positive().nullish()
 });
 const submittedReviewSchema = z.object({
 	id: z.number().int().positive(),
@@ -143,7 +148,7 @@ const issueCommentSchema = z.object({
 			"User",
 			"Organization"
 		])
-	})
+	}).nullable()
 });
 const checkRunSchema = z.object({
 	id: z.number().int().positive(),
@@ -220,7 +225,7 @@ const writePermissions = /* @__PURE__ */ new Set([
 var GitHubReviewCommentAuthorError = class extends Error {
 	author;
 	constructor(author) {
-		super(`GitHub user ${author} does not have write access to the repository`);
+		super(author === null ? "GitHub review comment has no author to verify for repository write access" : `GitHub user ${author} does not have write access to the repository`);
 		this.name = "GitHubReviewCommentAuthorError";
 		this.author = author;
 	}
@@ -302,6 +307,51 @@ async function listPullRequestComments(input) {
 		if (response.length < 100) return comments;
 	}
 }
+/** Read a page of all PR discussion types without treating any author's text as authorization. */
+async function listPullRequestDiscussion(input) {
+	const page = z.number().int().positive().parse(input.page ?? 1);
+	const number = positiveInteger(input.pullRequestNumber, "pullRequestNumber");
+	const query = `per_page=50&page=${page}`;
+	const [comments, reviewComments, reviews] = await Promise.all([
+		gitHubRequest(input, `/issues/${number}/comments?${query}`).then((value) => z.array(issueCommentSchema).max(50).parse(value).map(parseIssueComment)),
+		gitHubRequest(input, `/pulls/${number}/comments?${query}`).then((value) => z.array(reviewCommentSchema.extend({
+			pull_request_review_id: z.number().int().positive().nullable(),
+			path: z.string().min(1),
+			line: z.number().int().positive().nullish()
+		})).max(50).parse(value).map((entry) => {
+			const comment = parseReviewComment(entry);
+			assertReviewCommentPullRequest(input, comment);
+			return {
+				...comment,
+				reviewId: entry.pull_request_review_id,
+				path: entry.path,
+				line: entry.line ?? null
+			};
+		})),
+		gitHubRequest(input, `/pulls/${number}/reviews?${query}`).then((value) => z.array(submittedReviewSchema.extend({
+			user: z.object({ login: z.string().min(1) }).nullable(),
+			body: z.string(),
+			commit_id: z.string().regex(/^[0-9a-f]{40}$/).nullable()
+		})).max(50).parse(value).map((review) => ({
+			id: review.id,
+			url: review.html_url,
+			state: review.state,
+			author: review.user?.login ?? null,
+			body: review.body,
+			commitId: review.commit_id
+		})))
+	]);
+	return {
+		comments,
+		reviewComments,
+		reviews,
+		nextPage: [
+			comments,
+			reviewComments,
+			reviews
+		].some((entries) => entries.length === 50) ? page + 1 : null
+	};
+}
 /** Add one issue-style comment to a pull request conversation. */
 async function createPullRequestComment(input) {
 	return parseIssueComment(await gitHubRequest(input, `/issues/${positiveInteger(input.pullRequestNumber, "pullRequestNumber")}/comments`, {
@@ -329,8 +379,8 @@ async function readIssueComment(input) {
 	return {
 		id: comment.id,
 		url: comment.html_url,
-		author: comment.user.login,
-		authorType: comment.user.type,
+		author: comment.user?.login ?? null,
+		authorType: comment.user?.type ?? null,
 		body: comment.body,
 		issueNumber
 	};
@@ -344,8 +394,14 @@ async function readReviewComment(input) {
 }
 /** Reply to an inline review comment after applying the author policy, which requires write access by default. */
 async function answerReviewComment(input) {
-	await readReviewComment(input);
-	const reply = parseReviewComment(await gitHubRequest(input, `/pulls/${positiveInteger(input.pullRequestNumber, "pullRequestNumber")}/comments/${positiveInteger(input.commentId, "commentId")}/replies`, {
+	const comment = await readReviewComment(input);
+	const rootId = comment.inReplyToId ?? comment.id;
+	if (rootId !== comment.id) await readReviewComment({
+		...input,
+		commentId: rootId,
+		authorPolicy: "any"
+	});
+	const reply = parseReviewComment(await gitHubRequest(input, `/pulls/${positiveInteger(input.pullRequestNumber, "pullRequestNumber")}/comments/${positiveInteger(rootId, "commentId")}/replies`, {
 		method: "POST",
 		body: JSON.stringify({ body: input.body })
 	}));
@@ -355,6 +411,21 @@ async function answerReviewComment(input) {
 /** Submit a summary and optional inline comments against a reviewed pull request commit. */
 async function submitPullRequestReview(input) {
 	const commitId = z.string().regex(/^[0-9a-f]{40}$/).parse(input.commitId);
+	const comments = (input.comments ?? []).map((comment) => {
+		const line = positiveInteger(comment.line, "comment line");
+		const startLine = comment.startLine === void 0 ? void 0 : positiveInteger(comment.startLine, "comment startLine");
+		if (startLine !== void 0 && startLine >= line) throw new Error("comment startLine must precede line; omit it for a single-line finding");
+		return {
+			path: comment.path,
+			line,
+			side: "RIGHT",
+			...startLine === void 0 ? {} : {
+				start_line: startLine,
+				start_side: "RIGHT"
+			},
+			body: comment.body
+		};
+	});
 	const head = await readPullRequestHead(input);
 	if (head.sha !== commitId) throw new StalePullRequestHeadError(commitId, head.sha);
 	const review = submittedReviewSchema.parse(await gitHubRequest(input, `/pulls/${positiveInteger(input.pullRequestNumber, "pullRequestNumber")}/reviews`, {
@@ -363,12 +434,7 @@ async function submitPullRequestReview(input) {
 			commit_id: commitId,
 			event: input.event,
 			body: input.body,
-			comments: (input.comments ?? []).map((comment) => ({
-				path: comment.path,
-				line: positiveInteger(comment.line, "comment line"),
-				side: "RIGHT",
-				body: comment.body
-			}))
+			comments
 		})
 	}));
 	return {
@@ -439,6 +505,33 @@ async function listOpenPullRequests(input) {
 		draft: pull.draft
 	}));
 }
+/** Ensure a repository label exists, including when another publisher creates it concurrently. */
+async function ensureGitHubLabel(input) {
+	const label = z.object({
+		name: z.string().trim().min(1).max(50),
+		color: z.string().regex(/^[a-fA-F0-9]{6}$/u),
+		description: z.string().max(100)
+	}).parse(input);
+	const path = `/labels/${encodeURIComponent(label.name)}`;
+	const read = async () => {
+		if (z.object({ name: z.string() }).parse(await gitHubRequest(input, path)).name.toLowerCase() !== label.name.toLowerCase()) throw new Error("GitHub returned a different repository label");
+	};
+	try {
+		await read();
+		return;
+	} catch (error) {
+		if (!(error instanceof GitHubRequestError) || error.status !== 404) throw error;
+	}
+	try {
+		await gitHubRequest(input, "/labels", {
+			method: "POST",
+			body: JSON.stringify(label)
+		});
+	} catch (error) {
+		if (!(error instanceof GitHubRequestError) || error.status !== 422) throw error;
+		await read();
+	}
+}
 /** Add one label to a pull request. */
 async function addLabel(input) {
 	return parseLabels(await gitHubRequest(input, `/issues/${positiveInteger(input.pullRequestNumber, "pullRequestNumber")}/labels`, {
@@ -450,6 +543,13 @@ async function addLabel(input) {
 async function removeLabel(input) {
 	return parseLabels(await gitHubRequest(input, `/issues/${positiveInteger(input.pullRequestNumber, "pullRequestNumber")}/labels/${encodeURIComponent(input.label)}`, { method: "DELETE" }));
 }
+var GitHubRequestError = class extends Error {
+	status;
+	constructor(status, message) {
+		super(`GitHub API request failed (${status}): ${message}`);
+		this.status = status;
+	}
+};
 async function gitHubRequest(input, path, init = {}) {
 	const repository = repositorySlugSchema.parse(input.repository);
 	const response = await (input.fetch ?? globalThis.fetch)(`${gitHubApiUrl}/repos/${repository}${path}`, {
@@ -465,7 +565,7 @@ async function gitHubRequest(input, path, init = {}) {
 	const body = await response.json();
 	if (!response.ok) {
 		const message = z.object({ message: z.string() }).safeParse(body);
-		throw new Error(`GitHub API request failed (${response.status}): ${message.success ? message.data.message : response.statusText}`);
+		throw new GitHubRequestError(response.status, message.success ? message.data.message : response.statusText);
 	}
 	return body;
 }
@@ -478,8 +578,10 @@ function parseReviewComment(value) {
 		pullRequestNumber: positiveInteger(Number(pullRequestMatch[1]), "pullRequestNumber"),
 		body: comment.body,
 		url: comment.html_url,
-		author: comment.user.login,
-		inReplyToId: comment.in_reply_to_id ?? null
+		author: comment.user?.login ?? null,
+		authorType: comment.user?.type ?? null,
+		inReplyToId: comment.in_reply_to_id ?? null,
+		reviewId: comment.pull_request_review_id ?? null
 	};
 }
 function assertReviewCommentPullRequest(input, comment) {
@@ -492,8 +594,8 @@ function parseIssueComment(value) {
 		id: comment.id,
 		body: comment.body,
 		url: comment.html_url,
-		author: comment.user.login,
-		authorType: comment.user.type
+		author: comment.user?.login ?? null,
+		authorType: comment.user?.type ?? null
 	};
 }
 function parseLabels(value) {
@@ -553,7 +655,7 @@ function checkRunOutput(output) {
 }
 async function assertReviewCommentAuthor(input, author) {
 	if (input.authorPolicy === "any") return;
-	if (!await hasGitHubRepositoryWriteAccess({
+	if (author === null || !await hasGitHubRepositoryWriteAccess({
 		...input,
 		author
 	})) throw new GitHubReviewCommentAuthorError(author);
@@ -782,6 +884,6 @@ function normalizeGitHubWorkflowRunFailure(options) {
 	};
 }
 //#endregion
-export { GitHubCheckoutConflictError, GitHubPublicationApiError, GitHubReviewCommentAuthorError, StalePullRequestHeadError, addLabel, answerReviewComment, checkoutGitHubRepository, closePullRequest, configuredEventRepositorySlug, createCheckRun, createGitHubPublicationClient, createPullRequest, createPullRequestComment, factorySessionBranch, factoryTaskBranch, hasGitHubRepositoryWriteAccess, isSafeGitRef, listCheckRunsForRef, listConflictedPullRequests, listOpenPullRequests, listPullRequestComments, mintGitHubAppInstallationToken, normalizeFactoryQuestionReply, normalizeFactoryReviewComment, normalizeGitHubDefaultBranchPush, normalizeGitHubIssueOpened, normalizeGitHubPullRequest, normalizeGitHubPullRequestClosed, normalizeGitHubWorkflowRunFailure, readCommittedGitChange, readIssueComment, readPullRequest, readPullRequestHead, readReviewComment, removeLabel, runSandboxGit, stripFactoryQuestionMention, submitPullRequestReview, updateCheckRun, updatePullRequestComment, verifyGitHubSignature };
+export { GitHubCheckoutConflictError, GitHubPublicationApiError, GitHubReviewCommentAuthorError, StalePullRequestHeadError, addLabel, answerReviewComment, checkoutGitHubRepository, closePullRequest, configuredEventRepositorySlug, createCheckRun, createGitHubPublicationClient, createPullRequest, createPullRequestComment, ensureGitHubLabel, factorySessionBranch, factoryTaskBranch, hasGitHubRepositoryWriteAccess, isSafeGitRef, listCheckRunsForRef, listConflictedPullRequests, listOpenPullRequests, listPullRequestComments, listPullRequestDiscussion, mintGitHubAppInstallationToken, normalizeFactoryQuestionReply, normalizeFactoryReviewComment, normalizeGitHubDefaultBranchPush, normalizeGitHubIssueOpened, normalizeGitHubPullRequest, normalizeGitHubPullRequestClosed, normalizeGitHubWorkflowRunFailure, readCommittedGitChange, readIssueComment, readPullRequest, readPullRequestHead, readReviewComment, removeLabel, runSandboxGit, stripFactoryQuestionMention, submitPullRequestReview, updateCheckRun, updatePullRequestComment, verifyGitHubSignature };
 
 //# sourceMappingURL=github.mjs.map