@mastra/factory 0.0.0-aggregate-trace-20261015182851

package/dist/integrations/platform/github/integration.js

@@ -0,0 +1,1266 @@
+import { attachGithubReconciler, attachGithubRules } from "../../github/rules.js";
+import { createGithubSubscriptionTools, parseCreatedPullRequest, subscribeCurrentSessionToPullRequest } from "../../github/session-subscriptions.js";
+import { PlatformApiClient, PlatformApiError, logPlatformInfo, logPlatformWarn, platformApiClientConfigFromEnv } from "../api-client.js";
+import { GithubAppIdentity } from "../../github/app-identity.js";
+import { resolveGithubRules } from "../../github/default-rules.js";
+import { attachGithubIssueReconciler } from "../../github/issue-reconciler.js";
+import { reconcileInterval, reconciliationEnabled } from "../../github/reconciliation-config.js";
+import { parseAuthorizedBotsEnv } from "../../github/webhook.js";
+import { buildGithubRoutes } from "../../github/routes.js";
+import { settleOrAbort } from "../../github/settle-or-abort.js";
+import { PlatformGithubEventWorker } from "./event-worker.js";
+import { registerApiRoute } from "@mastra/core/server";
+import { Octokit } from "@octokit/rest";
+//#region src/integrations/platform/github/integration.ts
+const PAGE_SIZE = 30;
+const OPEN_ISSUE_DISCOVERY_MAX_PAGES = 5;
+const API_PREFIX = "/v1/server";
+/**
+* Slug of the GitHub App this integration posts as. Platform credentials do not
+* carry their own identity, so Factory cannot otherwise recognise its own
+* writes — and failing to recognise them makes Factory wake itself. Override
+* with `MASTRA_PLATFORM_GITHUB_APP_SLUG` when pointing at a non-production App.
+*/
+const PLATFORM_GITHUB_APP_SLUG = "mastra-platform";
+/**
+* How long an installation's repository listing may be reused. The repos
+* route and token minting both call it — often several times within one UI
+* interaction — and each call is a full Platform round trip.
+*/
+const INSTALLATION_REPOS_CACHE_TTL_MS = 3e4;
+/**
+* How long a minted repository-scoped token may be reused. GitHub
+* installation tokens live ~60 minutes; 5 minutes keeps a wide validity
+* margin while collapsing the per-session-materialization mint round trip.
+*/
+const REPOSITORY_ACCESS_CACHE_TTL_MS = 5 * 6e4;
+/**
+* How long a collaborator permission lookup may be reused. The reconcile
+* sweep re-stamps every open card's author and the event tail gates every
+* human-authored event on it, so one login can cost dozens of identical
+* requests per cycle against the installation's REST budget. Revoked access
+* reads as trusted for at most this long.
+*/
+const COLLABORATOR_PERMISSION_CACHE_TTL_MS = 30 * 6e4;
+/** Bound on the shared upstream lookup; callers race their own signal against it. */
+const COLLABORATOR_PERMISSION_LOOKUP_TIMEOUT_MS = 1e4;
+/**
+* Upper bound for both TTL caches. Entries expire lazily on re-access, so
+* without a hard cap keys that stop being queried would accumulate for the
+* integration's (long) lifetime. Insertion-order eviction — matches the
+* bounded verification cache in `@mastra/auth-studio`.
+*/
+const MAX_CACHE_ENTRIES = 1e3;
+function setBounded(cache, key, value) {
+	cache.delete(key);
+	cache.set(key, value);
+	if (cache.size > MAX_CACHE_ENTRIES) {
+		const oldest = cache.keys().next().value;
+		if (oldest !== void 0) cache.delete(oldest);
+	}
+}
+const REPOSITORY_TOKEN_PERMISSIONS = {
+	contents: "write",
+	issues: "write",
+	pull_requests: "write"
+};
+/** The Platform mints one installation token for at most this many named repositories. */
+const MAX_REPOSITORIES_PER_TOKEN = 10;
+function loose(c) {
+	return c;
+}
+function routeBaseUrl(ctx, requestUrl) {
+	return (ctx.baseUrl || new URL(requestUrl).origin).replace(/\/+$/, "");
+}
+var PlatformGithubIntegration = class {
+	id = "github";
+	#rules;
+	get rules() {
+		return this.#rules;
+	}
+	#client;
+	#endpointHost;
+	#slug;
+	/**
+	* Factory's own GitHub identity. Platform credentials do not carry the login
+	* they post as, so this starts from the configured slug (usually absent on a
+	* Platform deployment) and is corrected the first time Factory writes.
+	*/
+	identity;
+	/**
+	* Extra reviewer bot logins this deployment trusts for author-gated
+	* notifications, merged over the built-in defaults.
+	*/
+	authorizedBots;
+	#pollingEnabled;
+	#pollingIntervalMs;
+	#pullRequestReconcileEnabled;
+	#issueReconcileEnabled;
+	#pullRequestReconcileIntervalMs;
+	#issueReconcileIntervalMs;
+	#storage;
+	#integrationStorage;
+	/** installationId → cached repository listing (TTL-bounded). */
+	#installationReposCache = /* @__PURE__ */ new Map();
+	/** `orgId:repositoryId` → cached repository access (TTL-bounded). */
+	#repositoryAccessCache = /* @__PURE__ */ new Map();
+	/** `owner/repo:login` → cached collaborator permission (TTL-bounded). */
+	#collaboratorPermissionCache = /* @__PURE__ */ new Map();
+	/** Same key → lookup already in flight, so overlapping callers share one request. */
+	#collaboratorPermissionInFlight = /* @__PURE__ */ new Map();
+	intake = {
+		resolveIntakeDispatch: (input) => this.#resolveIntakeDispatch(input),
+		listSources: async ({ orgId, userId }) => {
+			const usable = (await this.#client.request("GET", `${API_PREFIX}/github-app/installations`)).installations.filter((installation) => installation.usable && !installation.suspendedAt);
+			return (await Promise.all(usable.map(async (installation) => {
+				const storedInstallation = await this.versionControl.registerInstallation({
+					orgId,
+					userId,
+					installation: {
+						externalId: String(installation.installationId),
+						accountName: installation.accountLogin,
+						accountType: installation.accountType
+					}
+				});
+				const result = await this.#client.request("GET", `${API_PREFIX}/github-app/installations/${installation.installationId}/repositories`);
+				await this.versionControl.registerRepositories({
+					orgId,
+					installationId: storedInstallation.id,
+					repositories: result.repositories.map((repository) => ({
+						externalId: String(repository.id),
+						slug: repository.fullName,
+						defaultBranch: repository.defaultBranch,
+						metadata: {
+							private: repository.private,
+							url: repository.htmlUrl
+						}
+					}))
+				});
+				return result.repositories.map((repository) => ({
+					repository,
+					installation
+				}));
+			}))).flat().map(({ repository, installation }) => ({
+				id: repository.fullName,
+				name: repository.fullName,
+				type: "repository",
+				metadata: {
+					installationId: installation.installationId,
+					accountLogin: installation.accountLogin,
+					accountType: installation.accountType,
+					repositoryId: repository.id,
+					defaultBranch: repository.defaultBranch,
+					private: repository.private,
+					url: repository.htmlUrl
+				}
+			}));
+		},
+		listItems: async ({ sourceIds, cursor }) => {
+			const page = parsePositiveCursor(cursor);
+			const pages = await Promise.all(sourceIds.map(async (sourceId) => {
+				const connection = {
+					type: "app-installation",
+					installationId: 1
+				};
+				const [issues, pullRequests] = await Promise.all([this.#listIssues(connection, sourceId, page), this.#listPullRequests({
+					connection,
+					sourceId,
+					includeDrafts: false,
+					cursor: String(page)
+				})]);
+				return {
+					items: [...issues.issues.map((issue) => ({
+						source: {
+							type: "issue",
+							externalId: `${sourceId}:${issue.id}`,
+							url: issue.url
+						},
+						sourceId,
+						title: issue.title,
+						status: issue.state ?? void 0,
+						labels: issue.labels,
+						assignee: issue.assignee,
+						createdAt: issue.createdAt,
+						updatedAt: issue.updatedAt,
+						metadata: {
+							repository: sourceId,
+							number: Number(issue.id),
+							author: issue.author
+						}
+					})), ...pullRequests.pullRequests.map((pullRequest) => ({
+						source: {
+							type: "pull-request",
+							externalId: `${sourceId}:${pullRequest.id}`,
+							url: pullRequest.url
+						},
+						sourceId,
+						title: pullRequest.title,
+						status: pullRequest.state,
+						createdAt: pullRequest.createdAt,
+						updatedAt: pullRequest.updatedAt,
+						metadata: {
+							repository: sourceId,
+							number: Number(pullRequest.id),
+							author: pullRequest.author,
+							baseBranch: pullRequest.baseBranch,
+							headBranch: pullRequest.headBranch
+						}
+					}))],
+					hasNextPage: issues.nextCursor !== null || pullRequests.nextCursor !== null
+				};
+			}));
+			return {
+				items: pages.flatMap((result) => result.items),
+				nextCursor: pages.some((result) => result.hasNextPage) ? String(page + 1) : null
+			};
+		},
+		listIssues: async (input) => {
+			requireGithubConnection(input.connection);
+			const sourceId = requireSingleSource(input.sourceIds, "GitHub Intake requires exactly one repository source.");
+			return this.#listIssues(input.connection, sourceId, parsePositiveCursor(input.cursor), input.labels);
+		},
+		getIssue: (input) => this.#getIssue(input.connection, input.sourceId, input.issueId),
+		createComment: (input) => this.#createIssueComment(input),
+		updateIssue: (input) => this.#updateIntakeIssue(input)
+	};
+	versionControl = {
+		initialize: ({ storage }) => {
+			this.#storage = storage;
+		},
+		registerInstallation: ({ orgId, userId, installation }) => this.storage.installations.upsert({
+			orgId,
+			connectedByUserId: userId,
+			externalId: installation.externalId,
+			accountName: installation.accountName,
+			accountType: installation.accountType,
+			providerMetadata: installation.metadata
+		}),
+		registerRepositories: ({ orgId, installationId, repositories }) => Promise.all(repositories.map((repository) => this.storage.repositories.upsert({
+			orgId,
+			input: {
+				installationId,
+				externalId: repository.externalId,
+				slug: repository.slug,
+				defaultBranch: repository.defaultBranch,
+				providerMetadata: repository.metadata
+			}
+		}))),
+		getRepositoryTarget: async ({ orgId, repositoryId }) => {
+			const repository = await this.storage.repositories.get({
+				orgId,
+				id: repositoryId
+			});
+			if (!repository) throw new Error("Version-control repository not found.");
+			const installation = await this.storage.installations.get({
+				orgId,
+				id: repository.installationId
+			});
+			if (!installation) throw new Error("Version-control installation not found.");
+			const installationId = parsePositiveInteger(installation.externalId);
+			if (installationId === null) throw new Error("GitHub installation id is invalid.");
+			return {
+				connection: {
+					type: "app-installation",
+					installationId
+				},
+				sourceId: repository.slug
+			};
+		},
+		getRepositoryAccess: async ({ orgId, repositoryId }) => {
+			const cacheKey = `${orgId}:${repositoryId}`;
+			const cached = this.#repositoryAccessCache.get(cacheKey);
+			if (cached && cached.expiresAt > Date.now()) return cached.access;
+			this.#repositoryAccessCache.delete(cacheKey);
+			const repository = await this.storage.repositories.get({
+				orgId,
+				id: repositoryId
+			});
+			if (!repository) throw new Error("Version-control repository not found.");
+			const cloneUrl = `https://github.com/${repository.slug}.git`;
+			const installation = await this.storage.installations.get({
+				orgId,
+				id: repository.installationId
+			});
+			if (!installation) throw new Error("Version-control installation not found.");
+			const installationId = parsePositiveInteger(installation.externalId);
+			if (installationId === null) throw new Error("GitHub installation id is invalid.");
+			const repositoryName = splitRepository(repository.slug).repo;
+			try {
+				const access = {
+					cloneUrl,
+					authorization: {
+						scheme: "bearer",
+						token: (await this.#client.request("POST", `${API_PREFIX}/github-app/installations/${installationId}/token`, {
+							repositories: [repositoryName],
+							permissions: REPOSITORY_TOKEN_PERMISSIONS
+						})).token
+					}
+				};
+				setBounded(this.#repositoryAccessCache, cacheKey, {
+					access,
+					expiresAt: Date.now() + REPOSITORY_ACCESS_CACHE_TTL_MS
+				});
+				return access;
+			} catch (err) {
+				if (!isDeadInstallation(err) || !installation.accountName) throw err;
+				const newInstallation = (await this.storage.installations.list({ orgId })).find((inst) => inst.accountName === installation.accountName && inst.id !== installation.id);
+				if (!newInstallation) throw err;
+				const newInstallationId = parsePositiveInteger(newInstallation.externalId);
+				if (newInstallationId === null) throw err;
+				await this.storage.repositories.migrateInstallation({
+					orgId,
+					id: repositoryId,
+					newInstallationId: newInstallation.id
+				});
+				const access = {
+					cloneUrl,
+					authorization: {
+						scheme: "bearer",
+						token: (await this.#client.request("POST", `${API_PREFIX}/github-app/installations/${newInstallationId}/token`, {
+							repositories: [repositoryName],
+							permissions: REPOSITORY_TOKEN_PERMISSIONS
+						})).token
+					}
+				};
+				setBounded(this.#repositoryAccessCache, cacheKey, {
+					access,
+					expiresAt: Date.now() + REPOSITORY_ACCESS_CACHE_TTL_MS
+				});
+				return access;
+			}
+		},
+		getRepositoriesAccess: async ({ orgId, repositoryIds }) => {
+			const ids = [...new Set(repositoryIds)];
+			if (ids.length === 0 || ids.length > MAX_REPOSITORIES_PER_TOKEN) return void 0;
+			const cacheKey = `${orgId}:${[...ids].sort().join(",")}`;
+			const cached = this.#repositoryAccessCache.get(cacheKey);
+			if (cached && cached.expiresAt > Date.now()) return cached.access;
+			this.#repositoryAccessCache.delete(cacheKey);
+			const repositories = await Promise.all(ids.map((id) => this.storage.repositories.get({
+				orgId,
+				id
+			})));
+			if (repositories.some((repository) => !repository)) throw new Error("Version-control repository not found.");
+			const found = repositories;
+			if (new Set(found.map((repository) => repository.installationId)).size !== 1) return void 0;
+			const installation = await this.storage.installations.get({
+				orgId,
+				id: found[0].installationId
+			});
+			if (!installation) throw new Error("Version-control installation not found.");
+			const installationId = parsePositiveInteger(installation.externalId);
+			if (installationId === null) throw new Error("GitHub installation id is invalid.");
+			const token = await this.#client.request("POST", `${API_PREFIX}/github-app/installations/${installationId}/token`, {
+				repositories: found.map((repository) => splitRepository(repository.slug).repo),
+				permissions: REPOSITORY_TOKEN_PERMISSIONS
+			});
+			const access = {
+				cloneUrl: `https://github.com/${found[0].slug}.git`,
+				authorization: {
+					scheme: "bearer",
+					token: token.token
+				}
+			};
+			setBounded(this.#repositoryAccessCache, cacheKey, {
+				access,
+				expiresAt: Date.now() + REPOSITORY_ACCESS_CACHE_TTL_MS
+			});
+			return access;
+		},
+		listPullRequests: (input) => this.#listPullRequests(input),
+		getPullRequest: (input) => this.#getPullRequest(input),
+		createPullRequest: (input) => this.#createPullRequest(input),
+		updatePullRequest: (input) => this.#updatePullRequest(input),
+		closePullRequest: (input) => this.#updatePullRequest({
+			...input,
+			state: "closed"
+		}),
+		mergePullRequest: (input) => this.#mergePullRequest(input),
+		listComments: (input) => this.#listComments(input),
+		createComment: (input) => this.#createComment(input),
+		updateComment: (input) => this.#updateComment(input),
+		deleteComment: (input) => this.#deleteComment(input),
+		listReviews: (input) => this.#listReviews(input),
+		getReview: (input) => this.#getReview(input),
+		createReview: (input) => this.#createReview(input),
+		updateReview: (input) => this.#updateReview(input),
+		submitReview: (input) => this.#submitReview(input),
+		dismissReview: (input) => this.#dismissReview(input),
+		deletePendingReview: (input) => this.#deletePendingReview(input),
+		listReviewComments: (input) => this.#listReviewComments(input),
+		createReviewComment: (input) => this.#createReviewComment(input),
+		updateReviewComment: (input) => this.#updateReviewComment(input),
+		deleteReviewComment: (input) => this.#deleteReviewComment(input),
+		listRequestedReviewers: (input) => this.#requestedReviewers("GET", input),
+		requestReviewers: (input) => this.#requestedReviewers("POST", input),
+		removeRequestedReviewers: (input) => this.#requestedReviewers("DELETE", input)
+	};
+	constructor(options = {}) {
+		this.#rules = resolveGithubRules(options.rules);
+		const config = platformApiClientConfigFromEnv();
+		this.#client = new PlatformApiClient(config);
+		this.#endpointHost = new URL(config.baseUrl).host;
+		this.#slug = options.slug;
+		this.identity = new GithubAppIdentity(process.env.MASTRA_PLATFORM_GITHUB_APP_SLUG?.trim() || PLATFORM_GITHUB_APP_SLUG);
+		this.authorizedBots = parseAuthorizedBotsEnv(process.env.MASTRACODE_GITHUB_AUTHORIZED_BOTS) ?? [];
+		this.#pollingEnabled = process.env.MASTRA_PLATFORM_GITHUB_POLLING_ENABLED?.trim().toLowerCase() !== "false";
+		this.#pollingIntervalMs = optionalPositiveIntegerEnv("MASTRA_PLATFORM_GITHUB_POLLING_INTERVAL_MS");
+		const legacyReconcileEnabled = process.env.MASTRA_PLATFORM_GITHUB_RECONCILE_ENABLED;
+		this.#pullRequestReconcileEnabled = reconciliationEnabled(process.env.MASTRACODE_PLATFORM_GITHUB_PR_RECONCILE_ENABLED, legacyReconcileEnabled);
+		this.#issueReconcileEnabled = reconciliationEnabled(process.env.MASTRACODE_PLATFORM_GITHUB_ISSUE_RECONCILE_ENABLED, legacyReconcileEnabled);
+		const legacyReconcileIntervalMs = reconcileInterval(process.env.MASTRACODE_PLATFORM_GITHUB_RECONCILE_INTERVAL_MS);
+		this.#pullRequestReconcileIntervalMs = reconcileInterval(process.env.MASTRACODE_PLATFORM_GITHUB_PR_RECONCILE_INTERVAL_MS) ?? legacyReconcileIntervalMs;
+		this.#issueReconcileIntervalMs = reconcileInterval(process.env.MASTRACODE_PLATFORM_GITHUB_ISSUE_RECONCILE_INTERVAL_MS) ?? legacyReconcileIntervalMs;
+	}
+	/** GitHub App slug when the deployment explicitly provides it. */
+	get slug() {
+		return this.#slug;
+	}
+	isFactoryCommentAuthor(login) {
+		return typeof login === "string" && this.identity.matches(login);
+	}
+	get storage() {
+		if (!this.#storage) throw new Error("PlatformGithubIntegration source-control storage has not been initialized.");
+		return this.#storage;
+	}
+	get sourceControlStorage() {
+		return this.storage;
+	}
+	get integrationStorage() {
+		if (!this.#integrationStorage) throw new Error("PlatformGithubIntegration generic storage has not been initialized.");
+		return this.#integrationStorage;
+	}
+	/** Resolve a stored GitHub locator without scanning installations or repositories. */
+	async #resolveIntakeDispatch({ orgId, externalSource }) {
+		const target = parseGithubExternalTarget(externalSource.externalId);
+		if (!target) return null;
+		const repository = target.repository.includes("/") ? target.repository : (await this.storage.repositories.findByExternalId({
+			orgId,
+			externalId: target.repository
+		}))?.slug;
+		if (!repository) return null;
+		return {
+			connection: {
+				type: "app-installation",
+				installationId: 1
+			},
+			sourceId: repository,
+			issueId: target.issueId
+		};
+	}
+	initialize({ storage }) {
+		this.#integrationStorage = storage;
+		logPlatformInfo("Platform GitHub integration initialized", {
+			endpointHost: this.#endpointHost,
+			pollingEnabled: this.#pollingEnabled,
+			pollingIntervalMs: this.#pollingIntervalMs,
+			pullRequestReconcileEnabled: this.#pullRequestReconcileEnabled,
+			issueReconcileEnabled: this.#issueReconcileEnabled
+		});
+	}
+	routes(ctx) {
+		const ingestFactoryEvent = attachGithubRules(this, ctx);
+		return [
+			this.#statusRoute(ctx),
+			this.#connectRoute(ctx),
+			this.#connectUserRoute(ctx),
+			...buildGithubRoutes({
+				auth: ctx.auth,
+				sandbox: ctx.sandbox,
+				storage: ctx.factoryStorage,
+				github: this,
+				stateSigner: ctx.stateSigner,
+				baseUrl: ctx.baseUrl,
+				controller: ctx.controller,
+				memorySettings: ctx.storage.memorySettings,
+				projects: ctx.storage.projects,
+				emitAudit: ctx.hooks?.emitAudit,
+				ingestFactoryEvent,
+				...ctx.workItems ? { workItems: ctx.workItems } : {}
+			}).filter((route) => route.path !== "/web/github/status" && route.path !== "/web/github/webhook" && !route.path.startsWith("/auth/github/"))
+		];
+	}
+	#statusRoute(ctx) {
+		return registerApiRoute("/web/github/status", {
+			method: "GET",
+			requiresAuth: false,
+			handler: async (c) => {
+				await ctx.auth.ensureUser(loose(c));
+				const tenant = ctx.auth.tenant(loose(c));
+				if (!tenant) return c.json({
+					error: "unauthorized",
+					reason: "auth_required"
+				}, 401);
+				if (!tenant.orgId) return c.json({
+					enabled: true,
+					sandboxEnabled: !!ctx.sandbox,
+					organizationRequired: true,
+					connected: false,
+					installations: [],
+					userConnected: false,
+					userGithubUsername: null,
+					reason: "organization_required",
+					diagnostics: this.diagnostics()
+				});
+				const [installations, userConnection] = await Promise.all([this.#syncInstallations(tenant.orgId, tenant.userId), this.#fetchUserConnection(tenant.userId)]);
+				return c.json({
+					enabled: true,
+					sandboxEnabled: !!ctx.sandbox,
+					connected: installations.length > 0,
+					installations: installations.map((installation) => ({
+						installationId: Number(installation.externalId),
+						accountLogin: installation.accountName,
+						accountType: installation.accountType
+					})),
+					userConnected: userConnection.connected,
+					userGithubUsername: userConnection.githubUsername,
+					reason: installations.length > 0 ? "ready" : "not_connected",
+					diagnostics: this.diagnostics()
+				});
+			}
+		});
+	}
+	#connectRoute(ctx) {
+		return registerApiRoute("/auth/github/connect", {
+			method: "GET",
+			requiresAuth: false,
+			handler: async (c) => {
+				await ctx.auth.ensureUser(loose(c));
+				const tenant = ctx.auth.tenant(loose(c));
+				if (!tenant?.orgId) return c.json({ error: "unauthorized" }, 401);
+				const redirectTo = c.req.query("redirectTo") || c.req.query("return_to") || "/";
+				const originator = routeBaseUrl(ctx, c.req.url);
+				logPlatformInfo("Starting Platform GitHub connect flow", {
+					orgId: tenant.orgId,
+					redirectTo,
+					originator
+				});
+				const query = new URLSearchParams({
+					action: "install",
+					redirectTo,
+					originator
+				});
+				const { url } = await this.#client.request("GET", `${API_PREFIX}/github-app/install-url?${query}`);
+				return c.redirect(url);
+			}
+		});
+	}
+	#connectUserRoute(ctx) {
+		return registerApiRoute("/auth/github/connect-user", {
+			method: "GET",
+			requiresAuth: false,
+			handler: async (c) => {
+				await ctx.auth.ensureUser(loose(c));
+				const tenant = ctx.auth.tenant(loose(c));
+				if (!tenant?.orgId) return c.json({ error: "unauthorized" }, 401);
+				const redirectTo = c.req.query("redirectTo") || c.req.query("return_to") || "/";
+				const originator = routeBaseUrl(ctx, c.req.url);
+				logPlatformInfo("Starting Platform GitHub user authorization flow", {
+					orgId: tenant.orgId,
+					redirectTo,
+					originator
+				});
+				const query = new URLSearchParams({
+					userId: tenant.userId,
+					redirectTo,
+					originator
+				});
+				const { url } = await this.#client.request("GET", `${API_PREFIX}/github-app/authenticate?${query}`);
+				return c.redirect(url);
+			}
+		});
+	}
+	/**
+	* Personal GitHub connection status for the acting user. Returns
+	* not-connected when the platform predates the user-connection endpoint.
+	*/
+	async #fetchUserConnection(userId) {
+		try {
+			const connection = await this.#client.request("GET", `${API_PREFIX}/github-app/user-connection?${new URLSearchParams({ userId })}`);
+			if (!connection.connected && connection.reason) logPlatformWarn("Platform GitHub user connection verification failed", {
+				userId,
+				reason: connection.reason
+			});
+			return connection;
+		} catch {
+			return {
+				connected: false,
+				githubUsername: null
+			};
+		}
+	}
+	async #syncInstallations(orgId, userId) {
+		const usableInstallations = (await this.#client.request("GET", `${API_PREFIX}/github-app/installations`)).installations.filter((installation) => installation.usable && !installation.suspendedAt);
+		return Promise.all(usableInstallations.map((installation) => this.versionControl.registerInstallation({
+			orgId,
+			userId,
+			installation: {
+				externalId: String(installation.installationId),
+				accountName: installation.accountLogin,
+				accountType: installation.accountType
+			}
+		})));
+	}
+	workers(ctx) {
+		if (!this.#pollingEnabled && !this.#pullRequestReconcileEnabled && !this.#issueReconcileEnabled) return [];
+		if (!ctx.controller) throw new Error("Platform GitHub event polling requires the mounted Mastra Code controller.");
+		return [new PlatformGithubEventWorker({
+			client: this.#client,
+			controller: ctx.controller,
+			github: this,
+			storage: ctx.storage.generic,
+			ingestFactoryEvent: attachGithubRules(this, ctx),
+			reconcileFactoryState: this.#pullRequestReconcileEnabled ? attachGithubReconciler(this, ctx, (input) => this.fetchPullRequestState(input)) : void 0,
+			reconcileIssuesFactoryState: this.#issueReconcileEnabled ? attachGithubIssueReconciler(this, ctx, (input) => this.fetchIssueState(input), (input) => this.listOpenIssueStates(input)) : void 0,
+			pollEventsEnabled: this.#pollingEnabled,
+			intervalMs: this.#pollingIntervalMs,
+			pullRequestReconcileIntervalMs: this.#pullRequestReconcileIntervalMs,
+			issueReconcileIntervalMs: this.#issueReconcileIntervalMs,
+			sourceControl: {
+				projectRepositories: {
+					listConfiguredExternalKeys: () => this.storage.projectRepositories.listConfiguredExternalKeys(),
+					listByExternalRepository: (args) => this.storage.projectRepositories.listByExternalRepository(args)
+				},
+				repositories: { findByExternalId: (args) => this.storage.repositories.findByExternalId(args) }
+			}
+		})];
+	}
+	/**
+	* Reads live PR state through the Platform GitHub proxy for the merge
+	* reconciler. Returns undefined when the PR cannot be resolved (missing,
+	* proxy error) so a sweep never fabricates a merge.
+	*/
+	async fetchPullRequestState(input) {
+		let repository;
+		try {
+			repository = splitRepository(input.repository);
+		} catch {
+			return;
+		}
+		try {
+			const result = await this.#client.request("GET", `${API_PREFIX}/github/repos/${encodeURIComponent(repository.owner)}/${encodeURIComponent(repository.repo)}/pulls/${input.number}`);
+			return {
+				title: result.title ?? `PR ${input.number}`,
+				url: result.html_url ?? `https://github.com/${input.repository}/pull/${input.number}`,
+				state: result.state === "closed" ? "closed" : "open",
+				draft: result.draft === true,
+				merged: result.merged === true,
+				assignees: (result.assignees ?? []).flatMap((assignee) => assignee.login ? [assignee.login] : []),
+				requestedReviewers: (result.requested_reviewers ?? []).flatMap((reviewer) => reviewer.login ? [reviewer.login] : []),
+				labels: (result.labels ?? []).flatMap((label) => typeof label === "string" ? [label] : label.name ? [label.name] : []),
+				headBranch: result.head?.ref ?? "",
+				baseBranch: result.base?.ref ?? "",
+				...result.user?.login ? { author: result.user.login } : {},
+				...result.created_at ? { createdAt: result.created_at } : {},
+				...result.merged_by?.login ? { mergedBy: result.merged_by.login } : {}
+			};
+		} catch {
+			return;
+		}
+	}
+	/**
+	* Reads live issue state through the Platform GitHub proxy for the
+	* reconciler. Returns undefined when the issue cannot be resolved (missing,
+	* is actually a PR, proxy error) so a sweep never fabricates a close.
+	*/
+	async fetchIssueState(input) {
+		let repository;
+		try {
+			repository = splitRepository(input.repository);
+		} catch {
+			return;
+		}
+		try {
+			const result = await this.#client.request("GET", `${API_PREFIX}/github/repos/${encodeURIComponent(repository.owner)}/${encodeURIComponent(repository.repo)}/issues/${input.number}`);
+			if (result.pull_request) return void 0;
+			return {
+				title: result.title ?? `Issue ${input.number}`,
+				url: result.html_url ?? `https://github.com/${input.repository}/issues/${input.number}`,
+				state: result.state === "closed" ? "closed" : "open",
+				...result.state_reason ? { stateReason: result.state_reason } : {},
+				assignees: (result.assignees ?? []).flatMap((assignee) => assignee.login ? [assignee.login] : []),
+				labels: (result.labels ?? []).map((label) => typeof label === "string" ? label : label.name).filter((name) => Boolean(name)),
+				...result.user?.login ? { author: result.user.login } : {},
+				...result.created_at ? { createdAt: result.created_at } : {},
+				...result.updated_at ? { updatedAt: result.updated_at } : {}
+			};
+		} catch {
+			return;
+		}
+	}
+	async listOpenIssueStates(input) {
+		const issues = [];
+		for (let page = 1; page <= OPEN_ISSUE_DISCOVERY_MAX_PAGES; page += 1) {
+			const query = new URLSearchParams({
+				state: "open",
+				page: String(page),
+				per_page: String(PAGE_SIZE)
+			});
+			const result = await this.#client.request("GET", `${repositoryPath(input.repository, "issues")}?${query}`);
+			for (const issue of result.issues) issues.push({
+				number: issue.number,
+				title: issue.title,
+				url: issue.htmlUrl,
+				state: "open",
+				assignees: issue.assignees,
+				labels: issue.labels,
+				...issue.user?.login ? { author: issue.user.login } : {},
+				createdAt: issue.createdAt,
+				updatedAt: issue.updatedAt
+			});
+			if (result.issues.length < PAGE_SIZE) break;
+		}
+		return issues;
+	}
+	async upsertFactoryTriageComment(input) {
+		const comments = [];
+		for (let page = 1;; page += 1) {
+			const query = new URLSearchParams({
+				page: String(page),
+				per_page: String(PAGE_SIZE)
+			});
+			const result = await this.#client.request("GET", `${repositoryPath(input.repository, `issues/${input.issueNumber}/comments`)}?${query}`);
+			comments.push(...result.comments);
+			if (result.comments.length < PAGE_SIZE) break;
+		}
+		const existing = comments.filter((comment) => comment.body.includes("<!-- mastra-factory-triage -->") && this.isFactoryCommentAuthor(comment.user?.login)).sort((left, right) => left.id - right.id)[0];
+		if (existing) {
+			const comment = await this.#client.request("PATCH", repositoryPath(input.repository, `issues/comments/${existing.id}`), { body: input.body });
+			this.#observeSelfAuthor(comment, void 0);
+			return {
+				action: "updated",
+				commentId: String(comment.id),
+				url: comment.htmlUrl
+			};
+		}
+		const comment = await this.#client.request("POST", repositoryPath(input.repository, `issues/${input.issueNumber}/comments`), { body: input.body });
+		this.#observeSelfAuthor(comment, void 0);
+		return {
+			action: "created",
+			commentId: String(comment.id),
+			url: comment.htmlUrl
+		};
+	}
+	sessionTools({ requestContext }) {
+		return createGithubSubscriptionTools(requestContext, this);
+	}
+	async postToolObserver({ toolContext, requestContext }) {
+		const pullRequestUrl = parseCreatedPullRequest(toolContext);
+		if (!pullRequestUrl || !requestContext) return;
+		await subscribeCurrentSessionToPullRequest(requestContext, pullRequestUrl, "auto-gh-pr-create", this);
+	}
+	diagnostics() {
+		return {
+			mode: "platform",
+			endpointHost: this.#endpointHost,
+			polling: {
+				enabled: this.#pollingEnabled,
+				...this.#pollingIntervalMs === void 0 ? {} : { intervalMs: this.#pollingIntervalMs }
+			},
+			reconcile: {
+				pullRequests: {
+					enabled: this.#pullRequestReconcileEnabled,
+					...this.#pullRequestReconcileIntervalMs === void 0 ? {} : { intervalMs: this.#pullRequestReconcileIntervalMs }
+				},
+				issues: {
+					enabled: this.#issueReconcileEnabled,
+					...this.#issueReconcileIntervalMs === void 0 ? {} : { intervalMs: this.#issueReconcileIntervalMs }
+				}
+			}
+		};
+	}
+	async getRepositoryCollaboratorPermission(_installationId, repoFullName, username, signal) {
+		let repository;
+		try {
+			repository = splitRepository(repoFullName);
+		} catch {
+			return;
+		}
+		const cacheKey = `${repository.owner}/${repository.repo}:${username.toLowerCase()}`;
+		const cached = this.#collaboratorPermissionCache.get(cacheKey);
+		if (cached && cached.expiresAt > Date.now()) return cached.permission;
+		this.#collaboratorPermissionCache.delete(cacheKey);
+		const inFlight = this.#collaboratorPermissionInFlight.get(cacheKey);
+		if (inFlight) return settleOrAbort(inFlight, signal, void 0);
+		const lookup = (async () => {
+			try {
+				const result = await this.#client.request("GET", `${API_PREFIX}/github/repos/${encodeURIComponent(repository.owner)}/${encodeURIComponent(repository.repo)}/collaborators/${encodeURIComponent(username)}/permission`, void 0, { signal: AbortSignal.timeout(COLLABORATOR_PERMISSION_LOOKUP_TIMEOUT_MS) });
+				setBounded(this.#collaboratorPermissionCache, cacheKey, {
+					permission: result.permission,
+					expiresAt: Date.now() + COLLABORATOR_PERMISSION_CACHE_TTL_MS
+				});
+				return result.permission;
+			} catch {
+				return;
+			} finally {
+				this.#collaboratorPermissionInFlight.delete(cacheKey);
+			}
+		})();
+		this.#collaboratorPermissionInFlight.set(cacheKey, lookup);
+		return settleOrAbort(lookup, signal, void 0);
+	}
+	async listInstallationRepos(installationId, options) {
+		const cached = this.#installationReposCache.get(installationId);
+		if (!options?.fresh && cached && cached.expiresAt > Date.now()) return cached.repos;
+		this.#installationReposCache.delete(installationId);
+		const repos = (await this.#client.request("GET", `${API_PREFIX}/github-app/installations/${installationId}/repositories`)).repositories.map((repository) => ({
+			...repository,
+			installationId
+		}));
+		setBounded(this.#installationReposCache, installationId, {
+			repos,
+			expiresAt: Date.now() + INSTALLATION_REPOS_CACHE_TTL_MS
+		});
+		return repos;
+	}
+	async mintInstallationToken(installationId) {
+		const repositories = await this.listInstallationRepos(installationId);
+		if (repositories.length === 0 || repositories.length > MAX_REPOSITORIES_PER_TOKEN) throw new Error("Platform GitHub token minting requires between one and ten installation repositories.");
+		return (await this.#client.request("POST", `${API_PREFIX}/github-app/installations/${installationId}/token`, {
+			repositories: repositories.map((repository) => repository.name),
+			permissions: REPOSITORY_TOKEN_PERMISSIONS
+		})).token;
+	}
+	async addIssueLabels(_installationId, sourceId, issueNumber, labels) {
+		return (await this.#client.request("POST", repositoryPath(sourceId, `issues/${issueNumber}/labels`), { labels })).labels;
+	}
+	async removeIssueLabel(_installationId, sourceId, issueNumber, label) {
+		const name = label.trim();
+		if (!name) return;
+		await this.#client.request("DELETE", repositoryPath(sourceId, `issues/${issueNumber}/labels/${encodeURIComponent(name)}`));
+	}
+	getInstallationOctokit(_installationId) {
+		return { pulls: { get: async ({ owner, repo, pull_number }) => {
+			const data = await this.#client.request("GET", repositoryPath(`${owner}/${repo}`, `pulls/${pull_number}`));
+			return { data: {
+				base: { repo: { id: data.base.repo.id } },
+				head: { ref: data.head.ref }
+			} };
+		} } };
+	}
+	async #listIssues(connection, sourceId, page, labels) {
+		requireGithubConnection(connection);
+		const path = repositoryPath(sourceId, "issues");
+		const query = new URLSearchParams({
+			state: "open",
+			page: String(page),
+			per_page: String(PAGE_SIZE)
+		});
+		const normalizedLabels = normalizeLabels(labels);
+		if (normalizedLabels.length > 0) query.set("label", normalizedLabels.join(","));
+		const result = await this.#client.request("GET", `${path}?${query}`);
+		return {
+			issues: result.issues.map((issue) => parseIntakeIssue(sourceId, issue)),
+			nextCursor: result.issues.length > 0 ? String(page + 1) : null
+		};
+	}
+	async #getIssue(connection, sourceId, issueId) {
+		requireGithubConnection(connection);
+		const repository = requireSource(sourceId, "GitHub Intake requires a repository source.");
+		const issueNumber = requirePositiveId(issueId, "issue");
+		try {
+			const [issue, comments] = await Promise.all([this.#client.request("GET", repositoryPath(repository, `issues/${issueNumber}`)), this.#client.request("GET", `${repositoryPath(repository, `issues/${issueNumber}/comments`)}?per_page=100`)]);
+			return parseIntakeIssueDetail(repository, issue, comments.comments);
+		} catch (error) {
+			if (isNotFound(error)) return null;
+			throw error;
+		}
+	}
+	async #updateIntakeIssue(input) {
+		requireGithubConnection(input.connection);
+		const repository = requireSource(input.sourceId, "GitHub Intake requires a repository source.");
+		const issueNumber = requirePositiveId(input.issueId, "issue");
+		if (input.state.kind === "byName") {
+			logPlatformWarn(`Platform GitHub: updateIssue byName is not supported (name=${input.state.name}); ignoring.`);
+			return null;
+		}
+		const targetState = input.state.stateType === "unstarted" || input.state.stateType === "started" ? "open" : "closed";
+		const stateReason = targetState === "closed" ? input.state.stateType === "canceled" ? "not_planned" : "completed" : null;
+		try {
+			await this.#client.request("GET", repositoryPath(repository, `pulls/${issueNumber}`));
+			logPlatformWarn(`Platform GitHub: updateIssue rejected — target ${repository}#${issueNumber} is a pull request.`);
+			return null;
+		} catch (error) {
+			if (!isNotFound(error)) throw error;
+		}
+		try {
+			return parseIntakeIssue(repository, await this.#client.request("PATCH", repositoryPath(repository, `issues/${issueNumber}`), {
+				state: targetState,
+				...stateReason ? { state_reason: stateReason } : {}
+			}, { actingUserId: input.actingUserId }));
+		} catch (error) {
+			if (isNotFound(error)) return null;
+			throw error;
+		}
+	}
+	/**
+	* Learn Factory's own login from a write it just made. Skipped when the write
+	* was made on behalf of a user — that comment is authored by the human, and
+	* recording it would teach Factory to mistake a person for itself.
+	*/
+	#observeSelfAuthor(comment, actingUserId) {
+		if (actingUserId) return;
+		this.identity.observeSelfAuthor(comment.user?.login);
+	}
+	async #createIssueComment(input) {
+		requireGithubConnection(input.connection);
+		const repository = requireSource(input.sourceId, "GitHub Intake requires a repository source.");
+		const issueNumber = requirePositiveId(input.issueId, "issue");
+		try {
+			const comment = await this.#client.request("POST", repositoryPath(repository, `issues/${issueNumber}/comments`), { body: input.body }, { actingUserId: input.actingUserId });
+			this.#observeSelfAuthor(comment, input.actingUserId);
+			return {
+				id: String(comment.id),
+				url: comment.htmlUrl
+			};
+		} catch (error) {
+			if (isNotFound(error)) return null;
+			throw error;
+		}
+	}
+	async #listPullRequests(input) {
+		requireGithubConnection(input.connection);
+		const page = parsePositiveCursor(input.cursor);
+		const query = new URLSearchParams({
+			state: input.state ?? "open",
+			page: String(page),
+			per_page: String(PAGE_SIZE)
+		});
+		const result = await this.#client.request("GET", `${repositoryPath(input.sourceId, "pulls")}?${query}`);
+		return {
+			pullRequests: result.pullRequests.filter((pullRequest) => input.includeDrafts !== false || !pullRequest.draft).map(parsePullRequest),
+			nextCursor: result.pullRequests.length === PAGE_SIZE ? String(page + 1) : null
+		};
+	}
+	async #getPullRequest(input) {
+		try {
+			return parsePullRequest(await this.#client.request("GET", pullRequestPath(input, input.pullRequestId)));
+		} catch (error) {
+			if (isNotFound(error)) return null;
+			throw error;
+		}
+	}
+	async #createPullRequest(input) {
+		requireGithubConnection(input.connection);
+		const result = await this.#client.request("POST", repositoryPath(input.sourceId, "pulls"), {
+			head: input.headBranch,
+			base: input.baseBranch,
+			title: input.title,
+			body: input.body,
+			draft: input.draft
+		}, { actingUserId: input.actingUserId });
+		const created = parsePullRequest(result);
+		if (input.actingUserId && input.connection.type === "app-installation") try {
+			const user = await this.#fetchUserConnection(input.actingUserId);
+			const login = user.githubUsername;
+			if (user.connected && login) {
+				const { owner, repo } = splitRepository(input.sourceId);
+				const { token } = await this.#client.request("POST", `${API_PREFIX}/github-app/installations/${input.connection.installationId}/token`, {
+					repositories: [repo],
+					permissions: REPOSITORY_TOKEN_PERMISSIONS
+				});
+				const { data } = await new Octokit({
+					auth: token,
+					request: { timeout: 15e3 }
+				}).issues.addAssignees({
+					owner,
+					repo,
+					issue_number: result.number,
+					assignees: [login]
+				});
+				if (!data.assignees?.some((assignee) => assignee.login?.toLowerCase() === login.toLowerCase())) logPlatformWarn("GitHub did not assign the PR opener", {
+					url: created.url,
+					login
+				});
+				else created.assignees = data.assignees.flatMap((assignee) => assignee.login ? [assignee.login] : []);
+			}
+		} catch (error) {
+			logPlatformWarn("Failed to assign the PR opener", {
+				url: created.url,
+				error: error instanceof Error ? error.message : String(error)
+			});
+		}
+		return created;
+	}
+	async #updatePullRequest(input) {
+		return parsePullRequest(await this.#client.request("PATCH", pullRequestPath(input, input.pullRequestId), {
+			title: input.title,
+			body: input.body === null ? "" : input.body,
+			base: input.baseBranch,
+			state: input.state
+		}, { actingUserId: input.actingUserId }));
+	}
+	#mergePullRequest(input) {
+		return this.#client.request("PUT", `${pullRequestPath(input, input.pullRequestId)}/merge`, {
+			commitTitle: input.commitTitle,
+			commitMessage: input.commitMessage,
+			method: input.method
+		}, { actingUserId: input.actingUserId });
+	}
+	async #listComments(input) {
+		const page = parsePositiveCursor(input.cursor);
+		const result = await this.#client.request("GET", `${repositoryPath(input.sourceId, `issues/${requirePositiveId(input.pullRequestId, "pull request")}/comments`)}?page=${page}&per_page=${PAGE_SIZE}`);
+		return {
+			comments: result.comments.map(parseComment),
+			nextCursor: result.comments.length === PAGE_SIZE ? String(page + 1) : null
+		};
+	}
+	async #createComment(input) {
+		const comment = await this.#client.request("POST", repositoryPath(input.sourceId, `issues/${requirePositiveId(input.pullRequestId, "pull request")}/comments`), { body: input.body }, { actingUserId: input.actingUserId });
+		this.#observeSelfAuthor(comment, input.actingUserId);
+		return parseComment(comment);
+	}
+	async #updateComment(input) {
+		requireGithubConnection(input.connection);
+		return parseComment(await this.#client.request("PATCH", repositoryPath(input.sourceId, `issues/comments/${requirePositiveId(input.commentId, "comment")}`), { body: input.body }, { actingUserId: input.actingUserId }));
+	}
+	async #deleteComment(input) {
+		requireGithubConnection(input.connection);
+		await this.#client.request("DELETE", repositoryPath(input.sourceId, `issues/comments/${requirePositiveId(input.commentId, "comment")}`), void 0, { actingUserId: input.actingUserId });
+	}
+	async #listReviews(input) {
+		const page = parsePositiveCursor(input.cursor);
+		const result = await this.#client.request("GET", `${pullRequestPath(input, input.pullRequestId)}/reviews?page=${page}&per_page=${PAGE_SIZE}`);
+		return {
+			reviews: result.reviews.map(parseReview),
+			nextCursor: result.reviews.length === PAGE_SIZE ? String(page + 1) : null
+		};
+	}
+	async #getReview(input) {
+		try {
+			return parseReview(await this.#client.request("GET", `${pullRequestPath(input, input.pullRequestId)}/reviews/${requirePositiveId(input.reviewId, "review")}`));
+		} catch (error) {
+			if (isNotFound(error)) return null;
+			throw error;
+		}
+	}
+	async #createReview(input) {
+		return parseReview(await this.#client.request("POST", `${pullRequestPath(input, input.pullRequestId)}/reviews`, {
+			body: input.body,
+			commitId: input.commitId,
+			event: input.event ? reviewEvent(input.event) : void 0
+		}, { actingUserId: input.actingUserId }));
+	}
+	async #updateReview(input) {
+		return parseReview(await this.#client.request("PUT", `${pullRequestPath(input, input.pullRequestId)}/reviews/${requirePositiveId(input.reviewId, "review")}`, { body: input.body }, { actingUserId: input.actingUserId }));
+	}
+	async #submitReview(input) {
+		return parseReview(await this.#client.request("POST", `${pullRequestPath(input, input.pullRequestId)}/reviews/${requirePositiveId(input.reviewId, "review")}/events`, {
+			body: input.body,
+			event: reviewEvent(input.event)
+		}, { actingUserId: input.actingUserId }));
+	}
+	async #dismissReview(input) {
+		return parseReview(await this.#client.request("PUT", `${pullRequestPath(input, input.pullRequestId)}/reviews/${requirePositiveId(input.reviewId, "review")}/dismissals`, { message: input.message }, { actingUserId: input.actingUserId }));
+	}
+	async #deletePendingReview(input) {
+		await this.#client.request("DELETE", `${pullRequestPath(input, input.pullRequestId)}/reviews/${requirePositiveId(input.reviewId, "review")}`, void 0, { actingUserId: input.actingUserId });
+	}
+	async #listReviewComments(input) {
+		const page = parsePositiveCursor(input.cursor);
+		const result = await this.#client.request("GET", `${pullRequestPath(input, input.pullRequestId)}/comments?page=${page}&per_page=${PAGE_SIZE}`);
+		return {
+			comments: result.comments.map(parseReviewComment),
+			nextCursor: result.comments.length === PAGE_SIZE ? String(page + 1) : null
+		};
+	}
+	async #createReviewComment(input) {
+		let body;
+		if (input.replyToId !== void 0) body = {
+			body: input.body,
+			replyToId: requirePositiveId(input.replyToId, "review comment")
+		};
+		else {
+			if (!input.commitId || !input.path || input.line === void 0 || !input.side) throw new Error("A review comment requires commitId, path, line, and side unless it is a reply.");
+			body = {
+				body: input.body,
+				commitId: input.commitId,
+				path: input.path,
+				line: input.line,
+				side: input.side.toUpperCase(),
+				startLine: input.startLine,
+				startSide: input.startSide?.toUpperCase()
+			};
+		}
+		return parseReviewComment(await this.#client.request("POST", `${pullRequestPath(input, input.pullRequestId)}/comments`, body, { actingUserId: input.actingUserId }));
+	}
+	async #updateReviewComment(input) {
+		requireGithubConnection(input.connection);
+		return parseReviewComment(await this.#client.request("PATCH", repositoryPath(input.sourceId, `pulls/comments/${requirePositiveId(input.commentId, "review comment")}`), { body: input.body }, { actingUserId: input.actingUserId }));
+	}
+	async #deleteReviewComment(input) {
+		requireGithubConnection(input.connection);
+		await this.#client.request("DELETE", repositoryPath(input.sourceId, `pulls/comments/${requirePositiveId(input.commentId, "review comment")}`), void 0, { actingUserId: input.actingUserId });
+	}
+	#requestedReviewers(method, input) {
+		requireGithubConnection(input.connection);
+		return this.#client.request(method, `${pullRequestPath(input, input.pullRequestId)}/requested-reviewers`, method === "GET" ? void 0 : {
+			users: input.users,
+			teams: input.teams
+		}, method === "GET" ? void 0 : { actingUserId: input.actingUserId });
+	}
+};
+function repositoryPath(sourceId, suffix) {
+	const { owner, repo } = splitRepository(sourceId);
+	return `${API_PREFIX}/github/repos/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}/${suffix}`;
+}
+function pullRequestPath(input, pullRequestId) {
+	requireGithubConnection(input.connection);
+	return repositoryPath(input.sourceId, `pulls/${requirePositiveId(pullRequestId, "pull request")}`);
+}
+function splitRepository(sourceId) {
+	const slash = sourceId.indexOf("/");
+	if (slash <= 0 || slash === sourceId.length - 1) throw new Error("GitHub capabilities require an owner/repository source.");
+	return {
+		owner: sourceId.slice(0, slash),
+		repo: sourceId.slice(slash + 1)
+	};
+}
+function parseIntakeIssue(sourceId, issue) {
+	return {
+		id: String(issue.number),
+		identifier: `#${issue.number}`,
+		title: issue.title,
+		url: issue.htmlUrl,
+		author: issue.user?.login ?? null,
+		state: issue.state,
+		stateType: issue.state,
+		priority: null,
+		assignee: issue.assignees[0] ?? null,
+		assignees: issue.assignees,
+		source: sourceId,
+		labels: issue.labels,
+		commentCount: issue.commentCount,
+		createdAt: issue.createdAt,
+		updatedAt: issue.updatedAt
+	};
+}
+function parseIntakeIssueDetail(sourceId, issue, comments) {
+	return {
+		...parseIntakeIssue(sourceId, issue),
+		description: issue.body?.trim() ? issue.body : null,
+		comments: comments.map((comment) => ({
+			author: comment.user?.login ?? null,
+			body: comment.body,
+			createdAt: comment.createdAt
+		}))
+	};
+}
+function parsePullRequest(pullRequest) {
+	return {
+		id: String(pullRequest.number),
+		title: pullRequest.title,
+		url: pullRequest.htmlUrl,
+		author: pullRequest.user?.login ?? null,
+		assignees: pullRequest.assignees ?? [],
+		requestedReviewers: pullRequest.requestedReviewers ?? [],
+		labels: pullRequest.labels ?? [],
+		body: pullRequest.body?.trim() ? pullRequest.body : null,
+		state: pullRequest.state,
+		draft: pullRequest.draft,
+		merged: pullRequest.merged,
+		mergeable: pullRequest.mergeable,
+		baseBranch: pullRequest.base.ref,
+		headBranch: pullRequest.head.ref,
+		headSha: pullRequest.head.sha,
+		createdAt: pullRequest.createdAt,
+		updatedAt: pullRequest.updatedAt
+	};
+}
+function parseComment(comment) {
+	return {
+		id: String(comment.id),
+		url: comment.htmlUrl,
+		author: comment.user?.login ?? null,
+		body: comment.body,
+		createdAt: comment.createdAt,
+		updatedAt: comment.updatedAt
+	};
+}
+function parseReview(review) {
+	return {
+		id: String(review.id),
+		url: review.htmlUrl,
+		author: review.user?.login ?? null,
+		body: review.body?.trim() ? review.body : null,
+		state: {
+			PENDING: "pending",
+			COMMENTED: "commented",
+			APPROVED: "approved",
+			CHANGES_REQUESTED: "changes-requested",
+			DISMISSED: "dismissed"
+		}[review.state],
+		commitId: review.commitId,
+		submittedAt: review.submittedAt
+	};
+}
+function parseReviewComment(comment) {
+	return {
+		...parseComment(comment),
+		path: comment.path,
+		line: comment.line,
+		side: comment.side?.toLowerCase(),
+		commitId: comment.commitId,
+		replyToId: comment.replyToId === null ? null : String(comment.replyToId)
+	};
+}
+function requireGithubConnection(connection) {
+	if (connection.type !== "app-installation" && connection.type !== "oauth") throw new Error("GitHub capabilities require a GitHub connection.");
+}
+function requireSingleSource(sourceIds, message) {
+	if (sourceIds.length !== 1) throw new Error(message);
+	return sourceIds[0];
+}
+function requireSource(sourceId, message) {
+	if (!sourceId) throw new Error(message);
+	return sourceId;
+}
+function normalizeLabels(labels) {
+	return [...new Set((labels ?? []).map((label) => label.trim()).filter(Boolean))];
+}
+function parsePositiveCursor(cursor) {
+	if (cursor === void 0) return 1;
+	const parsed = parsePositiveInteger(cursor);
+	if (parsed === null) throw new Error("GitHub cursor must be a positive page number.");
+	return parsed;
+}
+function parsePositiveInteger(value) {
+	if (!/^\d+$/.test(value)) return null;
+	const parsed = Number(value);
+	return Number.isSafeInteger(parsed) && parsed > 0 ? parsed : null;
+}
+function parseGithubExternalTarget(externalId) {
+	const match = externalId.match(/^(.+\/.+):(\d+)$/) ?? externalId.match(/^github:(\d+):(?:issue|pull-request):(\d+)$/) ?? externalId.match(/^(\d+):(\d+)$/);
+	if (!match?.[1] || !match[2] || parsePositiveInteger(match[2]) === null) return null;
+	return {
+		repository: match[1],
+		issueId: match[2]
+	};
+}
+function optionalPositiveIntegerEnv(name) {
+	const value = process.env[name]?.trim();
+	if (!value) return void 0;
+	const parsed = parsePositiveInteger(value);
+	if (parsed === null) throw new Error(`${name} must be a positive integer.`);
+	return parsed;
+}
+function requirePositiveId(value, resource) {
+	const parsed = parsePositiveInteger(value);
+	if (parsed === null) throw new Error(`GitHub ${resource} id must be a positive integer.`);
+	return parsed;
+}
+function reviewEvent(event) {
+	if (event === "approve") return "APPROVE";
+	if (event === "request-changes") return "REQUEST_CHANGES";
+	return "COMMENT";
+}
+function isNotFound(error) {
+	return error instanceof PlatformApiError && error.status === 404;
+}
+function isDeadInstallation(error) {
+	return error instanceof PlatformApiError && (error.status === 404 || error.status === 409);
+}
+//#endregion
+export { PlatformGithubIntegration };
+
+//# sourceMappingURL=integration.js.map