@vercel/factory 0.0.14 → 0.0.16

package/dist/github.d.mts

@@ -1,2 +1,446 @@
-import { $ as readReviewComment, A as PullRequestReviewEvent, B as createCheckRun, C as GitHubReviewComment, D as ListPullRequestCommentsInput, E as ListConflictedPullRequestsInput, F as SubmittedPullRequestReview, G as listPullRequestComments, H as createPullRequestComment, I as UpdateCheckRunInput, J as normalizeGitHubPullRequest, K as normalizeGitHubDefaultBranchPush, L as UpdatePullRequestCommentInput, M as ReadReviewCommentInput, N as ReviewCommentAuthorPolicy, O as PullRequestLabelInput, P as SubmitPullRequestReviewInput, Q as readPullRequestHead, R as addLabel, S as GitHubRepositoryRequest, T as ListCheckRunsForRefInput, U as listCheckRunsForRef, V as createPullRequest, W as listConflictedPullRequests, X as normalizeGitHubWorkflowRunFailure, Y as normalizeGitHubPullRequestClosed, Z as readPullRequest, _ as GitHubIssueSignal, a as CheckRunOutput, b as GitHubPullRequestHead, c as CreateCheckRunInput, d as CreatedPullRequest, et as removeLabel, f as GitHubCIFailureSignal, g as GitHubIssueComment, h as GitHubDefaultBranchPush, i as CheckRunConclusion, it as verifyGitHubSignature, j as ReadPullRequestHeadInput, k as PullRequestReviewComment, l as CreatePullRequestCommentInput, m as GitHubCheckRunStatus, n as CheckRunAnnotation, nt as updateCheckRun, o as CheckRunStatus, p as GitHubCheckRun, q as normalizeGitHubIssueOpened, r as CheckRunAnnotationLevel, rt as updatePullRequestComment, s as ConflictedPullRequest, t as AnswerReviewCommentInput, tt as submitPullRequestReview, u as CreatePullRequestInput, v as GitHubPullRequest, w as GitHubReviewCommentAuthorError, x as GitHubPullRequestSignal, y as GitHubPullRequestClosed, z as answerReviewComment } from "./github-C5HNBN6p.mjs";
-export { AnswerReviewCommentInput, CheckRunAnnotation, CheckRunAnnotationLevel, CheckRunConclusion, CheckRunOutput, CheckRunStatus, ConflictedPullRequest, CreateCheckRunInput, CreatePullRequestCommentInput, CreatePullRequestInput, CreatedPullRequest, GitHubCIFailureSignal, GitHubCheckRun, GitHubCheckRunStatus, GitHubDefaultBranchPush, GitHubIssueComment, GitHubIssueSignal, GitHubPullRequest, GitHubPullRequestClosed, GitHubPullRequestHead, GitHubPullRequestSignal, GitHubRepositoryRequest, GitHubReviewComment, GitHubReviewCommentAuthorError, ListCheckRunsForRefInput, ListConflictedPullRequestsInput, ListPullRequestCommentsInput, PullRequestLabelInput, PullRequestReviewComment, PullRequestReviewEvent, ReadPullRequestHeadInput, ReadReviewCommentInput, ReviewCommentAuthorPolicy, SubmitPullRequestReviewInput, SubmittedPullRequestReview, UpdateCheckRunInput, UpdatePullRequestCommentInput, addLabel, answerReviewComment, createCheckRun, createPullRequest, createPullRequestComment, listCheckRunsForRef, listConflictedPullRequests, listPullRequestComments, normalizeGitHubDefaultBranchPush, normalizeGitHubIssueOpened, normalizeGitHubPullRequest, normalizeGitHubPullRequestClosed, normalizeGitHubWorkflowRunFailure, readPullRequest, readPullRequestHead, readReviewComment, removeLabel, submitPullRequestReview, updateCheckRun, updatePullRequestComment, verifyGitHubSignature };
+import { RepositorySlug } from "./schema/repository.mjs";
+import { OpenPullRequest } from "./pull-requests/contracts.mjs";
+import { NormalizedSignal, WebhookEvent } from "./connectors/index.mjs";
+import { GitHubAppFactoryInput, GitHubAppInstallationToken, GitHubAppLike, GitHubAppPermissions, MintGitHubAppInstallationTokenInput, mintGitHubAppInstallationToken } from "./github-app.mjs";
+import { FetchGitHubBundleInput, FetchGitHubRefsInput, GitHubGitTransport, GitHubRefMapping, GitHubRepositoryBundle, GitTransferSandbox, PushGitHubBundleInput, PushGitHubHeadInput, ReadGitTransferFileInput, WithSandboxGitBundleInput, WriteGitTransferFileInput } from "./github-transfer.mjs";
+import { CheckoutGitHubRepositoryInput, CommittedGitChange, CreateGitHubBranchInput, CreateGitHubCommitInput, CreateGitHubPublicationPullRequestInput, CreateGitHubTreeInput, CreatedGitHubPublicationPullRequest, GitHubCheckoutConflictError, GitHubCommit, GitHubPublicationApiError, GitHubPublicationClient, GitHubPublicationClientOptions, GitHubPublicationLimits, GitHubPublicationPullRequest, GitHubTreeDeletion, GitHubTreeEntry, GitHubTreeUpsert, ListGitHubPublicationPullRequestsInput, MarkGitHubPullRequestReadyInput, ReadCommittedGitChangeInput, ReadGitHubBranchHeadInput, ReadGitHubCommitInput, ReadGitHubPullRequestInput, RunSandboxGitInput, SandboxGit, SandboxGitCommandInput, SandboxGitCommandResult, UpdateGitHubBranchInput, checkoutGitHubRepository, createGitHubPublicationClient, factorySessionBranch, factoryTaskBranch, isSafeGitRef, readCommittedGitChange, runSandboxGit } from "./github-publication.mjs";
+//#region src/github.d.ts
+/** Custom mention names accepted by Factory's GitHub comment normalizers. */
+interface FactoryMentionOptions {
+  mentions?: readonly string[];
+}
+/** Provider event and optional mentions accepted by Factory comment normalizers. */
+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 addressed inline comment or an opt-in reply candidate. */
+interface FactoryReviewComment {
+  repositorySlug: RepositorySlug;
+  pullRequestNumber: number;
+  pullRequestUrl: string;
+  pullRequestAuthor: string;
+  commentId: number;
+  commentUrl: string;
+}
+/** Human answer extracted from a mentioned GitHub issue comment. */
+interface FactoryQuestionReply {
+  repositorySlug: RepositorySlug;
+  replyAddress: string;
+  author: string;
+  answer: string;
+  commentId: number;
+  issueNumber: number;
+  commentUrl: string;
+}
+/** Select the one configured repository consistently identified by a provider delivery. */
+declare function configuredEventRepositorySlug(input: ConfiguredEventRepositoryInput): RepositorySlug | 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
+ * against GitHub's own copy of the comment applies the same rule the normalizer
+ * applied to the payload.
+ */
+declare function stripFactoryQuestionMention(body: string, options?: FactoryMentionOptions): string | null;
+/** Normalize a mentioned issue comment that can answer a persisted Factory QuestionTask. */
+declare function normalizeFactoryQuestionReply(input: NormalizeFactoryCommentInput): FactoryQuestionReply | null;
+/** Credentials and transport for a repository-scoped GitHub REST request. */
+interface GitHubRepositoryRequest {
+  repository: RepositorySlug;
+  token: string;
+  fetch?: typeof globalThis.fetch;
+}
+/** Repository-scoped identity of one pull request accepted by GitHub operations. */
+interface GitHubPullRequestTarget extends GitHubRepositoryRequest {
+  pullRequestNumber: number;
+}
+/** Provider-owned number and URL that identify one GitHub pull request. */
+interface GitHubPullRequestReference {
+  pullRequestNumber: number;
+  pullRequestUrl: string;
+}
+/** Repository request that identifies the GitHub actor whose access must be checked. */
+interface GitHubRepositoryAuthorRequest extends GitHubRepositoryRequest {
+  author: string;
+}
+/** Repository-scoped fields required to open a pull request from an existing branch. */
+interface CreatePullRequestInput extends GitHubRepositoryRequest {
+  title: string;
+  head: string;
+  base: string;
+  body?: string;
+  draft?: boolean;
+}
+/** Provider identity returned after GitHub creates a pull request. */
+type CreatedGitHubPullRequest = GitHubPullRequestReference;
+/** Trust threshold applied before Factory consumes an inline review comment. */
+type ReviewCommentAuthorPolicy = "write" | "any";
+interface ReviewCommentTrustInput {
+  /** Defaults to `write`. Use `any` only when untrusted review text is handled as data. */
+  authorPolicy?: ReviewCommentAuthorPolicy;
+}
+/** Pull request, comment identity, and author policy used to read an inline review comment. */
+interface ReadReviewCommentInput extends GitHubPullRequestTarget, ReviewCommentTrustInput {
+  commentId: number;
+}
+/** 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 | 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 {
+  commentId: number;
+  body: string;
+}
+/** Current branch, commit, and source repository of a pull request head. */
+interface GitHubPullRequestHead {
+  branch: string;
+  sha: string;
+  repository: RepositorySlug;
+}
+/** Provider-owned identity, author, and lifecycle state of a pull request. */
+interface GitHubPullRequest extends GitHubPullRequestReference {
+  author: string;
+  /** GitHub account type of the author, e.g. "User" or "Bot", when reported. */
+  authorType?: string;
+  state: "open" | "closed";
+}
+/** GitHub review action submitted with a pull-request review. */
+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;
+}
+/** Commit-fenced summary and inline findings submitted as one review. */
+interface SubmitPullRequestReviewInput extends GitHubPullRequestTarget {
+  commitId: string;
+  event: PullRequestReviewEvent;
+  body: string;
+  comments?: readonly PullRequestReviewComment[];
+}
+/** Provider identity and state returned for a submitted pull-request review. */
+interface SubmittedPullRequestReview {
+  id: number;
+  url: string;
+  state: string;
+}
+/** Issue-style PR comment, with null author metadata when GitHub no longer exposes it. */
+interface GitHubIssueComment {
+  id: number;
+  body: string;
+  url: string;
+  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;
+/** Pull-request conversation and body for a new issue-style comment. */
+interface CreatePullRequestCommentInput extends ListPullRequestCommentsInput {
+  body: string;
+}
+/** Existing issue-style comment and replacement body to persist. */
+interface UpdatePullRequestCommentInput extends GitHubRepositoryRequest {
+  commentId: number;
+  body: string;
+}
+/** Pull request and label targeted by a metadata-only label operation. */
+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;
+  headSha: string;
+  baseBranch: string;
+  baseSha: string;
+}
+/** Repository scope used to discover conflicted Factory-authored pull requests. */
+type ListConflictedPullRequestsInput = GitHubRepositoryRequest;
+/** Repository scope used to enumerate open pull requests. */
+type ListOpenPullRequestsInput = GitHubRepositoryRequest;
+/** Nonterminal lifecycle states Factory may write to a GitHub check run. */
+type CheckRunProgressStatus = "queued" | "in_progress";
+/** Lifecycle states GitHub may report when observing a check run. */
+type ObservedCheckRunStatus = CheckRunProgressStatus | "completed" | "waiting" | "requested" | "pending";
+/** Terminal result GitHub records for a completed check run. */
+type CheckRunConclusion = "action_required" | "cancelled" | "failure" | "neutral" | "skipped" | "success" | "timed_out";
+/** Severity GitHub displays for a check-run annotation. */
+type CheckRunAnnotationLevel = "notice" | "warning" | "failure";
+/** One source location and message rendered in a check run. */
+interface CheckRunAnnotation {
+  path: string;
+  startLine: number;
+  endLine?: number;
+  startColumn?: number;
+  endColumn?: number;
+  annotationLevel: CheckRunAnnotationLevel;
+  message: string;
+  title?: string;
+  rawDetails?: string;
+}
+/** Human-readable summary and optional annotations attached to a check run. */
+interface CheckRunOutput {
+  title: string;
+  summary: string;
+  text?: string;
+  annotations?: readonly CheckRunAnnotation[];
+}
+interface CheckRunPresentationFields {
+  detailsUrl?: string;
+  externalId?: string;
+  startedAt?: string;
+  output?: CheckRunOutput;
+}
+/** Writable fields for a queued, running, or presentation-only check-run update. */
+interface IncompleteCheckRunFields extends CheckRunPresentationFields {
+  status?: CheckRunProgressStatus;
+  conclusion?: never;
+  completedAt?: never;
+}
+/** Writable fields for a terminal check run, which always requires its conclusion. */
+interface CompletedCheckRunFields extends CheckRunPresentationFields {
+  status: "completed";
+  conclusion: CheckRunConclusion;
+  completedAt?: string;
+}
+/** Lifecycle-correlated fields accepted when creating or updating a check run. */
+type CheckRunFields = IncompleteCheckRunFields | CompletedCheckRunFields;
+/** Commit identity and presentation fields for a new check run. */
+type CreateCheckRunInput = GitHubRepositoryRequest & CheckRunFields & {
+  name: string;
+  headSha: string;
+};
+/** Check-run identity and fields to update on GitHub. */
+type UpdateCheckRunInput = GitHubRepositoryRequest & CheckRunFields & {
+  checkRunId: number;
+  name?: string;
+};
+/** Git reference and optional name filter used to discover existing check runs. */
+interface ListCheckRunsForRefInput extends GitHubRepositoryRequest {
+  ref: string;
+  checkName?: string;
+}
+/** Normalized identity, lifecycle, and links for a GitHub check run. */
+interface GitHubCheckRun {
+  id: number;
+  name: string;
+  headSha: string;
+  status: ObservedCheckRunStatus;
+  conclusion: CheckRunConclusion | "stale" | "startup_failure" | null;
+  url: string | null;
+  detailsUrl: string | null;
+  externalId: string | null;
+  startedAt: string | null;
+  completedAt: string | null;
+}
+/** Refusal raised when an inline review-comment author lacks repository write access. */
+declare class GitHubReviewCommentAuthorError extends Error {
+  readonly author: string | null;
+  constructor(author: string | null);
+}
+/**
+ * The pull request advanced past the commit a review or fix was prepared
+ * against. Callers that reviewed a task keyed to a specific commit (for
+ * example `record_post_review`) can use `expectedSha`/`actualSha` to resolve
+ * the task as superseded instead of leaving it running for the stall
+ * watchdog to eventually -- and misleadingly -- report as "stalled".
+ */
+declare class StalePullRequestHeadError extends Error {
+  readonly expectedSha: string;
+  readonly actualSha: string;
+  constructor(expectedSha: string, actualSha: string);
+}
+/** Whether a GitHub user may make repository-scoped Factory decisions. */
+declare function hasGitHubRepositoryWriteAccess(input: GitHubRepositoryAuthorRequest): Promise<boolean>;
+/** Create a pull request from an existing head branch. */
+declare function createPullRequest(input: CreatePullRequestInput): Promise<CreatedGitHubPullRequest>;
+/** Create a check run for one commit. Requires a GitHub App token with checks:write. */
+declare function createCheckRun(input: CreateCheckRunInput): Promise<GitHubCheckRun>;
+/** Update a check run previously created by the authenticated GitHub App. */
+declare function updateCheckRun(input: UpdateCheckRunInput): Promise<GitHubCheckRun>;
+/** List check runs reported for a commit, branch, or tag. */
+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. */
+declare function updatePullRequestComment(input: UpdatePullRequestCommentInput): Promise<GitHubIssueComment>;
+/** One issue comment as GitHub reports it, with the issue it belongs to. */
+interface GitHubIssueCommentRecord extends GitHubIssueComment {
+  issueNumber: number;
+}
+/**
+ * Read one issue comment from GitHub. A delivery authenticated as a workload
+ * rather than by body signature can name any author and any text, so the
+ * comment it refers to has to be read back before either is believed.
+ */
+declare function readIssueComment(input: GitHubRepositoryRequest & {
+  commentId: number;
+}): Promise<GitHubIssueCommentRecord>;
+/** Read one inline review comment after applying the author policy, which requires write access by default. */
+declare function readReviewComment(input: ReadReviewCommentInput): Promise<GitHubReviewComment>;
+/** Reply to an inline review comment after applying the author policy, which requires write access by default. */
+declare function answerReviewComment(input: AnswerReviewCommentInput): Promise<GitHubReviewComment>;
+/** Submit a summary and optional inline comments against a reviewed pull request commit. */
+declare function submitPullRequestReview(input: SubmitPullRequestReviewInput): Promise<SubmittedPullRequestReview>;
+/** Read the current head branch and commit of a pull request. */
+declare function readPullRequestHead(input: GitHubPullRequestTarget): Promise<GitHubPullRequestHead>;
+/** Read the provider-owned identity and lifecycle of one pull request. */
+declare function readPullRequest(input: GitHubPullRequestTarget): Promise<GitHubPullRequest>;
+/** Close an open pull request without merging it. */
+declare function closePullRequest(input: GitHubPullRequestTarget): Promise<GitHubPullRequest>;
+/** List open, same-repository pull requests by one author that GitHub reports as conflicting. */
+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. */
+declare function removeLabel(input: PullRequestLabelInput): Promise<readonly string[]>;
+/** Raw payload, shared secret, and provider signature used for webhook verification. */
+interface VerifyGitHubSignatureInput {
+  secret: string;
+  payload: string;
+  signature: string | null;
+}
+/**
+ * Verify a GitHub webhook HMAC signature (the x-hub-signature-256 header)
+ * against the raw request body. Returns false for missing or malformed
+ * signatures instead of throwing.
+ */
+declare function verifyGitHubSignature(options: VerifyGitHubSignatureInput): boolean;
+/** Normalized observation that a repository's configured default branch advanced. */
+interface GitHubDefaultBranchPush {
+  source: "github_default_branch_push";
+  deliveryId: string;
+  repositorySlug: RepositorySlug;
+  defaultBranch: string;
+}
+/** Normalize a push to a repository's default branch for deterministic reconciliation. */
+declare function normalizeGitHubDefaultBranchPush(options: WebhookEvent): GitHubDefaultBranchPush | null;
+/** Reviewable pull-request webhook normalized for Factory intake. */
+interface GitHubPullRequestSignal extends NormalizedSignal<"github_pr"> {
+  repositorySlug: RepositorySlug;
+  pullRequest: {
+    pullRequestNumber: number;
+    pullRequestUrl: string;
+    author: string;
+    draft: boolean;
+    headSha: string;
+    headBranch: string;
+    headRepositorySlug: RepositorySlug;
+    baseSha: string;
+    baseBranch: string;
+    sender: string;
+  };
+}
+/** Normalize a newly reviewable or updated pull request into a factory signal. */
+declare function normalizeGitHubPullRequest(options: WebhookEvent): GitHubPullRequestSignal | null;
+/** Opened GitHub issue normalized for Factory intake. */
+interface GitHubIssueSignal extends NormalizedSignal<"github_issue"> {
+  repositorySlug: RepositorySlug;
+  issue: {
+    number: number;
+    title: string;
+    body: string | null;
+  };
+}
+/** Unsuccessful GitHub Actions run normalized for Factory intake. */
+interface GitHubCiFailureSignal extends NormalizedSignal<"github_ci_failure"> {
+  repositoryDefaultBranch: string;
+  repositorySlug: RepositorySlug;
+  workflowRun: {
+    id: number;
+    name: string;
+    trigger: string;
+    branch: string | null;
+    headRepositorySlug: RepositorySlug | null;
+    headSha: string;
+    url: string;
+    conclusion: string;
+    attempt: number;
+  };
+}
+/**
+ * Normalize a GitHub issues webhook into the factory's signal shape. Returns
+ * null for payloads that are not an opened issue. The caller supplies the
+ * repository id; the payload stays untrusted data.
+ */
+declare function normalizeGitHubIssueOpened(options: WebhookEvent): GitHubIssueSignal | null;
+/** Normalized provider observation that a pull request was merged or closed. */
+interface GitHubPullRequestClosed extends GitHubPullRequestReference {
+  source: "github_pull_request_closed";
+  deliveryId: string;
+  repositorySlug: RepositorySlug;
+  merged: boolean;
+  /** The merge commit on the base branch; null when closed without merging. */
+  mergeCommitSha: string | null;
+  /** The GitHub login that merged the pull request, or closed it without merging. */
+  decidedBy: string;
+}
+/**
+ * Normalize a closed pull_request webhook so the factory can observe what
+ * happened to its change: merged records merged_by (the sender when GitHub
+ * omits it), a close without merge records the sender.
+ */
+declare function normalizeGitHubPullRequestClosed(options: WebhookEvent): GitHubPullRequestClosed | null;
+/** 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, 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