@vercel/factory 0.0.4 → 0.0.5

package/dist/connectors/slack.d.mts

@@ -0,0 +1,43 @@
+import { a as NormalizedSignal } from "../index-WNGZJRRH.mjs";
+//#region src/connectors/slack.d.ts
+interface SlackMessageEvent {
+  teamId: string;
+  channelId: string;
+  messageTs: string;
+  threadTs: string;
+  actorId: string;
+  text: string;
+  replyAddress: string;
+  repositorySlug: string;
+  payload: unknown;
+}
+interface SlackMessageSignal extends NormalizedSignal<"slack"> {
+  repositorySlug: string;
+  message: {
+    teamId: string;
+    channelId: string;
+    messageTs: string;
+    threadTs: string;
+    actorId: string;
+    text: string;
+  };
+}
+/** Normalize an Eve-verified Slack message after the caller resolves its repository. */
+declare function normalizeSlackMessage(event: SlackMessageEvent): SlackMessageSignal;
+type SlackRepositorySelection = {
+  status: "selected";
+  repositorySlug: string;
+} | {
+  status: "required";
+} | {
+  status: "ambiguous";
+  repositorySlugs: readonly string[];
+};
+/**
+ * Select the only configured repository, or require an explicit owner/name
+ * when a Slack surface fronts more than one repository.
+ */
+declare function selectSlackRepository(text: string, repositories: readonly string[]): SlackRepositorySelection;
+//#endregion
+export { SlackMessageEvent, SlackMessageSignal, SlackRepositorySelection, normalizeSlackMessage, selectSlackRepository };
+//# sourceMappingURL=slack.d.mts.map

package/dist/connectors/slack.mjs

@@ -0,0 +1,50 @@
+//#region src/connectors/slack.ts
+/** Normalize an Eve-verified Slack message after the caller resolves its repository. */
+function normalizeSlackMessage(event) {
+	return {
+		source: "slack",
+		deliveryId: `${event.teamId}:${event.channelId}:${event.messageTs}`,
+		repositorySlug: event.repositorySlug.toLowerCase(),
+		replyTo: {
+			channel: "slack",
+			address: event.replyAddress
+		},
+		message: {
+			teamId: event.teamId,
+			channelId: event.channelId,
+			messageTs: event.messageTs,
+			threadTs: event.threadTs,
+			actorId: event.actorId,
+			text: event.text
+		},
+		payload: event.payload
+	};
+}
+/**
+* Select the only configured repository, or require an explicit owner/name
+* when a Slack surface fronts more than one repository.
+*/
+function selectSlackRepository(text, repositories) {
+	const normalized = [...new Set(repositories.map((slug) => slug.toLowerCase()))];
+	if (normalized.length === 1) return {
+		status: "selected",
+		repositorySlug: normalized[0]
+	};
+	const matches = normalized.filter((slug) => {
+		const escaped = slug.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+		return new RegExp(`(^|[^a-z0-9._/-])${escaped}($|[^a-z0-9._/-])`, "i").test(text);
+	});
+	if (matches.length === 1) return {
+		status: "selected",
+		repositorySlug: matches[0]
+	};
+	if (matches.length > 1) return {
+		status: "ambiguous",
+		repositorySlugs: matches
+	};
+	return { status: "required" };
+}
+//#endregion
+export { normalizeSlackMessage, selectSlackRepository };
+
+//# sourceMappingURL=slack.mjs.map

package/dist/connectors/slack.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack.mjs","names":[],"sources":["../../src/connectors/slack.ts"],"sourcesContent":["import type { NormalizedSignal } from \"./index\";\n\nexport interface SlackMessageEvent {\n  teamId: string;\n  channelId: string;\n  messageTs: string;\n  threadTs: string;\n  actorId: string;\n  text: string;\n  replyAddress: string;\n  repositorySlug: string;\n  payload: unknown;\n}\n\nexport interface SlackMessageSignal extends NormalizedSignal<\"slack\"> {\n  repositorySlug: string;\n  message: {\n    teamId: string;\n    channelId: string;\n    messageTs: string;\n    threadTs: string;\n    actorId: string;\n    text: string;\n  };\n}\n\n/** Normalize an Eve-verified Slack message after the caller resolves its repository. */\nexport function normalizeSlackMessage(event: SlackMessageEvent): SlackMessageSignal {\n  return {\n    source: \"slack\",\n    deliveryId: `${event.teamId}:${event.channelId}:${event.messageTs}`,\n    repositorySlug: event.repositorySlug.toLowerCase(),\n    replyTo: { channel: \"slack\", address: event.replyAddress },\n    message: {\n      teamId: event.teamId,\n      channelId: event.channelId,\n      messageTs: event.messageTs,\n      threadTs: event.threadTs,\n      actorId: event.actorId,\n      text: event.text,\n    },\n    payload: event.payload,\n  };\n}\n\nexport type SlackRepositorySelection =\n  | { status: \"selected\"; repositorySlug: string }\n  | { status: \"required\" }\n  | { status: \"ambiguous\"; repositorySlugs: readonly string[] };\n\n/**\n * Select the only configured repository, or require an explicit owner/name\n * when a Slack surface fronts more than one repository.\n */\nexport function selectSlackRepository(\n  text: string,\n  repositories: readonly string[],\n): SlackRepositorySelection {\n  const normalized = [...new Set(repositories.map((slug) => slug.toLowerCase()))];\n  if (normalized.length === 1) {\n    return { status: \"selected\", repositorySlug: normalized[0]! };\n  }\n\n  const matches = normalized.filter((slug) => {\n    const escaped = slug.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n    return new RegExp(`(^|[^a-z0-9._/-])${escaped}($|[^a-z0-9._/-])`, \"i\").test(text);\n  });\n  if (matches.length === 1) {\n    return { status: \"selected\", repositorySlug: matches[0]! };\n  }\n  if (matches.length > 1) {\n    return { status: \"ambiguous\", repositorySlugs: matches };\n  }\n  return { status: \"required\" };\n}\n"],"mappings":";;AA2BA,SAAgB,sBAAsB,OAA8C;CAClF,OAAO;EACL,QAAQ;EACR,YAAY,GAAG,MAAM,OAAO,GAAG,MAAM,UAAU,GAAG,MAAM;EACxD,gBAAgB,MAAM,eAAe,YAAY;EACjD,SAAS;GAAE,SAAS;GAAS,SAAS,MAAM;EAAa;EACzD,SAAS;GACP,QAAQ,MAAM;GACd,WAAW,MAAM;GACjB,WAAW,MAAM;GACjB,UAAU,MAAM;GAChB,SAAS,MAAM;GACf,MAAM,MAAM;EACd;EACA,SAAS,MAAM;CACjB;AACF;;;;;AAWA,SAAgB,sBACd,MACA,cAC0B;CAC1B,MAAM,aAAa,CAAC,GAAG,IAAI,IAAI,aAAa,KAAK,SAAS,KAAK,YAAY,CAAC,CAAC,CAAC;CAC9E,IAAI,WAAW,WAAW,GACxB,OAAO;EAAE,QAAQ;EAAY,gBAAgB,WAAW;CAAI;CAG9D,MAAM,UAAU,WAAW,QAAQ,SAAS;EAC1C,MAAM,UAAU,KAAK,QAAQ,uBAAuB,MAAM;EAC1D,OAAO,IAAI,OAAO,oBAAoB,QAAQ,oBAAoB,GAAG,CAAC,CAAC,KAAK,IAAI;CAClF,CAAC;CACD,IAAI,QAAQ,WAAW,GACrB,OAAO;EAAE,QAAQ;EAAY,gBAAgB,QAAQ;CAAI;CAE3D,IAAI,QAAQ,SAAS,GACnB,OAAO;EAAE,QAAQ;EAAa,iBAAiB;CAAQ;CAEzD,OAAO,EAAE,QAAQ,WAAW;AAC9B"}

package/dist/eve/index.d.mts

@@ -1,5 +1,5 @@
 import { c as Finding, k as FactoryStores, t as ApprovalPolicy } from "../approval-h5aj8HYN.mjs";
-import { l as GitHubReviewComment } from "../github-5qQPCaXj.mjs";
+import { d as GitHubReviewComment } from "../github-3sbHe-fo.mjs";
 import { z } from "zod";
 //#region src/eve/fetch.d.ts
 /** The subset of the eve sandbox handle a credentialed git operation needs. */
@@ -379,11 +379,17 @@ declare function invokeAgentTool(stores: FactoryStores, options: InvokeAgentOpti
 };
 //#endregion
 //#region src/eve/review.d.ts
-interface ReviewCommentToolOptions {
+interface ReviewCommentToolOptions<S extends CommandSandbox = CommandSandbox> {
   tokenForRepository: (repository: string) => Promise<string>;
+  withCredential?: (sandbox: S, repository: string, command: string) => Promise<{
+    stdout: string;
+    stderr?: string;
+    exitCode?: number;
+  }>;
   fetch?: typeof globalThis.fetch;
+  repoPath?: string;
 }
-declare function reviewCommentTools(stores: FactoryStores, options: ReviewCommentToolOptions): {
+declare function reviewCommentTools<S extends CommandSandbox>(stores: FactoryStores, options: ReviewCommentToolOptions<S>): {
   read_review_comment: import("eve/tools").ToolDefinition<{
     changeId: string;
     commentId: number;
@@ -404,6 +410,44 @@ declare function reviewCommentTools(stores: FactoryStores, options: ReviewCommen
       body: string;
     }, ctx: import("eve/tools").ToolContext): Promise<GitHubReviewComment>;
   };
+  suggest_review_fix: import("eve/tools").ToolDefinition<{
+    changeId: string;
+    commentId: number;
+    confidence: "medium";
+    replacement: string;
+    summary: string;
+  }, GitHubReviewComment> & {
+    execute(input: {
+      changeId: string;
+      commentId: number;
+      confidence: "medium";
+      replacement: string;
+      summary: string;
+    }, ctx: import("eve/tools").ToolContext): Promise<GitHubReviewComment>;
+  };
+  apply_review_fix: import("eve/tools").ToolDefinition<{
+    changeId: string;
+    commentId: number;
+    confidence: "high";
+    summary: string;
+  }, {
+    updated: true;
+    prNumber: number;
+    prUrl: string;
+    reply: GitHubReviewComment;
+  }> & {
+    execute(input: {
+      changeId: string;
+      commentId: number;
+      confidence: "high";
+      summary: string;
+    }, ctx: import("eve/tools").ToolContext): Promise<{
+      updated: true;
+      prNumber: number;
+      prUrl: string;
+      reply: GitHubReviewComment;
+    }>;
+  };
 };
 //#endregion
 //#region src/eve/verification.d.ts

package/dist/eve/index.mjs

@@ -1,6 +1,6 @@
 import { i as repositoryIdSchema, o as signalIdSchema, p as vocabularySchema, s as taskIdSchema, t as changeIdSchema } from "../id-DwCihQr4.mjs";
 import { S as findingFingerprint, b as requiresApproval, g as dispatchTask, p as levelSchema, s as taskQuestionSchema, u as changeEvidenceSchema, w as findingSchema, y as defaultApprovalPolicy } from "../task-Cj7Ei9Nh.mjs";
-import { answerReviewComment, readReviewComment } from "../github.mjs";
+import { answerReviewComment, readPullRequestHead, readReviewComment } from "../github.mjs";
 import { z } from "zod";
 import { defineHook } from "eve/hooks";
 import { defineTool } from "eve/tools";
@@ -476,44 +476,120 @@ function invokeAgentTool(stores, options) {
 //#endregion
 //#region src/eve/review.ts
 function reviewCommentTools(stores, options) {
+	const repoPath = options.repoPath ?? "repo";
 	const commentInputSchema = z.object({
 		changeId: changeIdSchema.describe("The change under review, from your starting message."),
 		commentId: z.number().int().positive().describe("The GitHub review comment id.")
 	});
-	async function context(changeId) {
-		const change = await stores.changes.get(changeId);
-		if (change === null) throw new Error(`change ${changeId} does not exist`);
-		if (change.state !== "verifying" && change.state !== "ready") throw new Error(`change is ${change.state}, not open for review`);
-		const repository = await stores.repositories.get(change.repositoryId);
-		if (repository === null) throw new Error(`repository ${change.repositoryId} does not exist`);
-		return {
-			repository: repository.slug,
-			token: await options.tokenForRepository(repository.slug),
-			fetch: options.fetch,
-			pullRequestNumber: change.prNumber
-		};
-	}
 	return {
 		read_review_comment: defineTool({
 			description: "Read an inline review comment on a change under verification or ready for human review. By default this refuses to return comments from people without write access to the repository.",
 			inputSchema: commentInputSchema,
 			async execute({ changeId, commentId }) {
+				const change = await stores.changes.get(changeId);
+				if (change === null) throw new Error(`change ${changeId} does not exist`);
+				if (change.state !== "verifying" && change.state !== "ready") throw new Error(`change is ${change.state}, not open for review`);
+				const repository = await stores.repositories.get(change.repositoryId);
+				if (repository === null) throw new Error(`repository ${change.repositoryId} does not exist`);
 				return readReviewComment({
-					...await context(changeId),
+					repository: repository.slug,
+					token: await options.tokenForRepository(repository.slug),
+					fetch: options.fetch,
 					commentId
 				});
 			}
 		}),
 		answer_review_comment: defineTool({
-			description: "Reply to an inline review comment on a change under verification or ready for human review. The repository and pull request come from the ledger, and the comment author must have write access.",
+			description: "Reply to an inline review comment on a change under verification or ready for human review. Use for findings and low-confidence responses, not for a concrete medium- or high-confidence fix.",
 			inputSchema: commentInputSchema.extend({ body: z.string().min(1).max(5e3).describe("The Markdown reply to post.") }),
 			async execute({ changeId, commentId, body }) {
+				const change = await stores.changes.get(changeId);
+				if (change === null) throw new Error(`change ${changeId} does not exist`);
+				if (change.state !== "verifying" && change.state !== "ready") throw new Error(`change is ${change.state}, not open for review`);
+				const repository = await stores.repositories.get(change.repositoryId);
+				if (repository === null) throw new Error(`repository ${change.repositoryId} does not exist`);
 				return answerReviewComment({
-					...await context(changeId),
+					repository: repository.slug,
+					token: await options.tokenForRepository(repository.slug),
+					fetch: options.fetch,
+					pullRequestNumber: change.prNumber,
 					commentId,
 					body
 				});
 			}
+		}),
+		suggest_review_fix: defineTool({
+			description: "Post a concrete, apply-able GitHub suggested change for a medium-confidence fix. The replacement must cover exactly the lines attached to the inline review comment.",
+			inputSchema: commentInputSchema.extend({
+				confidence: z.literal("medium"),
+				replacement: z.string().min(1).max(5e3).describe("Exact replacement text for the commented lines."),
+				summary: z.string().min(1).max(1e3).describe("A brief explanation of the suggested fix.")
+			}),
+			async execute({ changeId, commentId, replacement, summary }) {
+				const change = await stores.changes.get(changeId);
+				if (change === null) throw new Error(`change ${changeId} does not exist`);
+				if (change.state !== "verifying" && change.state !== "ready") throw new Error(`change is ${change.state}, not open for review`);
+				const repository = await stores.repositories.get(change.repositoryId);
+				if (repository === null) throw new Error(`repository ${change.repositoryId} does not exist`);
+				return answerReviewComment({
+					repository: repository.slug,
+					token: await options.tokenForRepository(repository.slug),
+					fetch: options.fetch,
+					pullRequestNumber: change.prNumber,
+					commentId,
+					body: `${summary}\n\n\`\`\`suggestion\n${replacement}\n\`\`\``
+				});
+			}
+		}),
+		apply_review_fix: defineTool({
+			description: "Publish a tested, committed high-confidence fix to the existing same-repository pull request branch. Fails if the checkout is dirty, the PR changed, or the PR comes from a fork.",
+			inputSchema: commentInputSchema.extend({
+				confidence: z.literal("high"),
+				summary: z.string().min(1).max(1e3).describe("What was fixed and verified.")
+			}),
+			async execute({ changeId, commentId, summary }, ctx) {
+				const change = await stores.changes.get(changeId);
+				if (change === null) throw new Error(`change ${changeId} does not exist`);
+				if (change.state !== "verifying" && change.state !== "ready") throw new Error(`change is ${change.state}, not open for review`);
+				const repository = await stores.repositories.get(change.repositoryId);
+				if (repository === null) throw new Error(`repository ${change.repositoryId} does not exist`);
+				if (options.withCredential === void 0) throw new Error("applying review fixes is not configured");
+				const token = await options.tokenForRepository(repository.slug);
+				await readReviewComment({
+					repository: repository.slug,
+					token,
+					fetch: options.fetch,
+					commentId
+				});
+				const head = await readPullRequestHead({
+					repository: repository.slug,
+					token,
+					fetch: options.fetch,
+					pullRequestNumber: change.prNumber
+				});
+				if (head.repository !== repository.slug.toLowerCase()) throw new Error("cannot apply a fix to a pull request from a fork");
+				const sandbox = await ctx.getSandbox();
+				const git = `git -C ${repoPath}`;
+				if ((await sandbox.run({ command: `${git} status --porcelain` })).stdout.trim() !== "") throw new Error("commit the review fix before publishing");
+				if ((await sandbox.run({ command: `${git} merge-base --is-ancestor ${head.sha} HEAD` })).exitCode !== 0) throw new Error("pull request changed after it was fetched; fetch it again before applying the fix");
+				if ((await sandbox.run({ command: `${git} rev-parse HEAD` })).stdout.trim() === head.sha) throw new Error("no committed review fix to publish");
+				const push = await options.withCredential(sandbox, repository.slug, `${git} push --force-with-lease=refs/heads/${head.branch}:${head.sha} origin HEAD:refs/heads/${head.branch}`);
+				if (typeof push.exitCode === "number" && push.exitCode !== 0) throw new Error(`could not update pull request branch: ${(push.stderr ?? "").trim()}`);
+				const reply = await answerReviewComment({
+					repository: repository.slug,
+					token,
+					fetch: options.fetch,
+					pullRequestNumber: change.prNumber,
+					commentId,
+					body: summary
+				});
+				return {
+					updated: true,
+					prNumber: change.prNumber,
+					prUrl: change.prUrl,
+					reply
+				};
+			}
 		})
 	};
 }