@vercel/factory 0.0.5 → 0.0.8

package/README.md

@@ -1,5 +1,12 @@
 # @vercel/factory
 
-The framework for building Agent Factories: schemas, state machines, store drivers, dispatch, agent tools, and connectors for auditable autonomous repository work.
+The Factory Development Kit: typed constructs, workflows, schemas, execution contracts,
+persistence, agent tools, and provider adapters for durable, auditable software factories.
 
-See the [repository README](../../README.md) for the project overview and development instructions.
+The FDK extends Eve incrementally. Durable workflows retain authority over policy, budgets,
+state transitions, retries, and external effects while agents and coding harnesses return bounded
+results. The V1 reference runtime uses Postgres, Blob, AI SDK `HarnessAgent`, and Vercel Sandbox,
+with independent verification and human-owned merges.
+
+See the [repository README](../../README.md) for development instructions and the
+[architecture](../../docs/factory-architecture.md) for the complete contract.

package/dist/{approval-h5aj8HYN.d.mts → approval-qkxww0wJ.d.mts}

@@ -23,12 +23,12 @@ declare const levelSchema: z.ZodEnum<{
   high: "high";
 }>;
 declare const changeStateSchema: z.ZodEnum<{
+  rolled_back: "rolled_back";
   verifying: "verifying";
   ready: "ready";
   merged: "merged";
   deployed: "deployed";
   rolled_out: "rolled_out";
-  rolled_back: "rolled_back";
   closed: "closed";
 }>;
 declare const changeEvidenceSchema: z.ZodObject<{
@@ -67,14 +67,15 @@ declare const changeSchema: z.ZodObject<{
     previewUrl: z.ZodOptional<z.ZodURL>;
   }, z.core.$strict>;
   state: z.ZodEnum<{
+    rolled_back: "rolled_back";
     verifying: "verifying";
     ready: "ready";
     merged: "merged";
     deployed: "deployed";
     rolled_out: "rolled_out";
-    rolled_back: "rolled_back";
     closed: "closed";
   }>;
+  mergeSha: z.ZodOptional<z.ZodString>;
   decidedBy: z.ZodOptional<z.ZodString>;
   createdAt: z.ZodISODateTime;
   updatedAt: z.ZodISODateTime;
@@ -147,12 +148,12 @@ type Repository = z.infer<typeof repositorySchema>;
 declare const standardTaskKinds: readonly ["code_change", "verification", "investigation", "question"];
 declare const taskKindSchema: z.ZodString;
 declare const taskStateSchema: z.ZodEnum<{
-  queued: "queued";
-  running: "running";
-  verifying: "verifying";
   succeeded: "succeeded";
   failed: "failed";
   needs_human: "needs_human";
+  queued: "queued";
+  running: "running";
+  verifying: "verifying";
   cancelled: "cancelled";
 }>;
 declare const taskApprovalSchema: z.ZodEnum<{
@@ -184,12 +185,12 @@ declare const taskSchema: z.ZodObject<{
   kind: z.ZodString;
   area: z.ZodOptional<z.ZodString>;
   state: z.ZodEnum<{
-    queued: "queued";
-    running: "running";
-    verifying: "verifying";
     succeeded: "succeeded";
     failed: "failed";
     needs_human: "needs_human";
+    queued: "queued";
+    running: "running";
+    verifying: "verifying";
     cancelled: "cancelled";
   }>;
   approval: z.ZodOptional<z.ZodEnum<{
@@ -281,7 +282,7 @@ interface CreateChangeInput {
   confidence: Level;
   evidence: Change["evidence"];
 }
-type ChangePatch = Partial<Pick<Change, "confidence" | "evidence" | "decidedBy">>;
+type ChangePatch = Partial<Pick<Change, "confidence" | "evidence" | "decidedBy" | "mergeSha">>;
 interface ChangeTransitionOptions {
   patch?: ChangePatch;
   reason?: string;
@@ -507,4 +508,4 @@ interface ApprovalSubject {
 declare function requiresApproval(policy: ApprovalPolicy, subject: ApprovalSubject): boolean;
 //#endregion
 export { ReceiptPhase as $, TaskPatch as A, taskDevboxSchema as B, ChangeTransitionOptions as C, changeIdSchema as Ct, CreateTaskInput as D, repositoryIdsSchema as Dt, CreateStoresOptions as E, repositoryIdSchema as Et, TaskKind as F, taskStateSchema as G, taskOriginSchema as H, TaskState as I, repositorySchema as J, Repository as K, harnessSchema as L, createStores as M, Task as N, DecideSignalOptions as O, signalIdSchema as Ot, TaskApproval as P, ReceiptKind as Q, standardTaskKinds as R, ChangePatch as S, TaskId as St, CreateSignalInput as T, receiptIdSchema as Tt, taskQuestionSchema as U, taskKindSchema as V, taskSchema as W, Cost as X, repositorySlugSchema as Y, Receipt as Z, findingVerificationMethodSchema as _, ChangeId as _t, approvalRuleSchema as a, receiptStateSchema as at, ApprovalDecision as b, RepositoryId as bt, Finding as c, standardReceiptStates as ct, FindingVerification as d, ChangeState as dt, ReceiptState as et, findingCategorySchema as f, Level as ft, findingVerificationLevelSchema as g, levelSchema as gt, findingSchema as h, changeStateSchema as ht, approvalPolicySchema as i, receiptSchema as it, TaskTransitionOptions as j, FactoryStores as k, taskIdSchema as kt, FindingCategory as l, Change as lt, findingPrioritySchema as m, changeSchema as mt, ApprovalRule as n, receiptKindSchema as nt, defaultApprovalPolicy as o, standardReceiptKinds as ot, findingFingerprint as p, changeEvidenceSchema as pt, RepositorySlug as q, ApprovalSubject as r, receiptPhaseSchema as rt, requiresApproval as s, standardReceiptPhases as st, ApprovalPolicy as t, costSchema as tt, FindingPriority as u, ChangeEvidence as ut, findingVerificationSchema as v, FactoryId as vt, CreateChangeInput as w, factoryIdSchema as wt, ApprovalError as x, SignalId as xt, AppendReceiptInput as y, ReceiptId as yt, taskApprovalSchema as z };
-//# sourceMappingURL=approval-h5aj8HYN.d.mts.map
+//# sourceMappingURL=approval-qkxww0wJ.d.mts.map

package/dist/connectors/index.d.mts

@@ -1,2 +1,2 @@
-import { a as NormalizedSignal, c as communicationEventSchema, d as createCommunicationRouter, i as CommunicationRouter, l as communicationOutcomeSchema, n as CommunicationEvent, o as SignalNormalizer, r as CommunicationOutcome, s as WebhookEvent, t as CommunicationAdapter, u as communicationOutcomes } from "../index-WNGZJRRH.mjs";
+import { a as NormalizedSignal, c as communicationEventSchema, d as createCommunicationRouter, i as CommunicationRouter, l as communicationOutcomeSchema, n as CommunicationEvent, o as SignalNormalizer, r as CommunicationOutcome, s as WebhookEvent, t as CommunicationAdapter, u as communicationOutcomes } from "../index-DUb-U5cy.mjs";
 export { CommunicationAdapter, CommunicationEvent, CommunicationOutcome, CommunicationRouter, NormalizedSignal, SignalNormalizer, WebhookEvent, communicationEventSchema, communicationOutcomeSchema, communicationOutcomes, createCommunicationRouter };

package/dist/connectors/index.mjs

@@ -1,4 +1,4 @@
-import { i as repositoryIdSchema, s as taskIdSchema, t as changeIdSchema, u as replyToSchema } from "../id-DwCihQr4.mjs";
+import { a as repositoryIdsSchema, s as taskIdSchema, t as changeIdSchema, u as replyToSchema } from "../id-DwCihQr4.mjs";
 import { z } from "zod";
 //#region src/connectors/index.ts
 const communicationOutcomes = [
@@ -17,7 +17,7 @@ const communicationOutcomes = [
 const communicationOutcomeSchema = z.enum(communicationOutcomes).describe("Lifecycle outcome a connector should render and deliver.");
 const communicationEventSchema = z.strictObject({
 	eventId: z.string().min(1).describe("Stable idempotency key for this delivery."),
-	repositoryId: repositoryIdSchema,
+	repositoryIds: repositoryIdsSchema,
 	taskId: taskIdSchema.optional(),
 	changeId: changeIdSchema.optional(),
 	replyTo: replyToSchema,

package/dist/connectors/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../src/connectors/index.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { changeIdSchema, repositoryIdSchema, taskIdSchema } from \"../schema/id\";\nimport { replyToSchema } from \"../schema/common\";\nimport type { ReplyTo } from \"../schema/common\";\nimport type { SignalSource } from \"../schema/signal\";\n\nexport interface WebhookEvent {\n  deliveryId: string;\n  event: string;\n  payload: unknown;\n}\n\nexport interface NormalizedSignal<TSource extends SignalSource = SignalSource> {\n  source: TSource;\n  deliveryId: string;\n  replyTo: ReplyTo;\n  payload: unknown;\n}\n\nexport type SignalNormalizer<TSignal extends NormalizedSignal = NormalizedSignal> = (\n  event: WebhookEvent,\n) => TSignal | null;\n\nexport const communicationOutcomes = [\n  \"accepted\",\n  \"started\",\n  \"succeeded\",\n  \"failed\",\n  \"needs_human\",\n  \"question\",\n  \"digest\",\n  \"rolled_back\",\n  \"budget_warning\",\n  \"budget_exhausted\",\n  \"message\",\n] as const;\n\nexport const communicationOutcomeSchema = z\n  .enum(communicationOutcomes)\n  .describe(\"Lifecycle outcome a connector should render and deliver.\");\n\nexport const communicationEventSchema = z.strictObject({\n  eventId: z.string().min(1).describe(\"Stable idempotency key for this delivery.\"),\n  repositoryId: repositoryIdSchema,\n  taskId: taskIdSchema.optional(),\n  changeId: changeIdSchema.optional(),\n  replyTo: replyToSchema,\n  outcome: communicationOutcomeSchema,\n  data: z\n    .record(z.string(), z.unknown())\n    .describe(\"Outcome-specific data rendered by the selected connector.\"),\n});\n\nexport type CommunicationOutcome = z.infer<typeof communicationOutcomeSchema>;\nexport type CommunicationEvent = z.infer<typeof communicationEventSchema>;\n\nexport interface CommunicationAdapter {\n  readonly channel: string;\n  deliver(event: CommunicationEvent): Promise<void>;\n}\n\nexport interface CommunicationRouter {\n  readonly channels: readonly string[];\n  deliver(event: CommunicationEvent): Promise<void>;\n}\n\nexport function createCommunicationRouter(\n  adapters: readonly CommunicationAdapter[],\n): CommunicationRouter {\n  const byChannel = new Map<string, CommunicationAdapter>();\n  for (const adapter of adapters) {\n    const channel = adapter.channel.trim();\n    if (channel.length === 0) {\n      throw new Error(\"Communication adapter channel is required.\");\n    }\n    if (byChannel.has(channel)) {\n      throw new Error(`Communication adapter ${channel} is registered more than once.`);\n    }\n    byChannel.set(channel, adapter);\n  }\n  const channels = Object.freeze([...byChannel.keys()]);\n\n  return Object.freeze({\n    channels,\n    async deliver(input: CommunicationEvent): Promise<void> {\n      const event = communicationEventSchema.parse(input);\n      const adapter = byChannel.get(event.replyTo.channel);\n      if (adapter === undefined) {\n        throw new Error(`No communication adapter is registered for ${event.replyTo.channel}.`);\n      }\n      await adapter.deliver(event);\n    },\n  });\n}\n"],"mappings":";;;AAuBA,MAAa,wBAAwB;CACnC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,MAAa,6BAA6B,EACvC,KAAK,qBAAqB,CAAC,CAC3B,SAAS,0DAA0D;AAEtE,MAAa,2BAA2B,EAAE,aAAa;CACrD,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,2CAA2C;CAC/E,cAAc;CACd,QAAQ,aAAa,SAAS;CAC9B,UAAU,eAAe,SAAS;CAClC,SAAS;CACT,SAAS;CACT,MAAM,EACH,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC,CAAC,CAC/B,SAAS,2DAA2D;AACzE,CAAC;AAeD,SAAgB,0BACd,UACqB;CACrB,MAAM,4BAAY,IAAI,IAAkC;CACxD,KAAK,MAAM,WAAW,UAAU;EAC9B,MAAM,UAAU,QAAQ,QAAQ,KAAK;EACrC,IAAI,QAAQ,WAAW,GACrB,MAAM,IAAI,MAAM,4CAA4C;EAE9D,IAAI,UAAU,IAAI,OAAO,GACvB,MAAM,IAAI,MAAM,yBAAyB,QAAQ,+BAA+B;EAElF,UAAU,IAAI,SAAS,OAAO;CAChC;CACA,MAAM,WAAW,OAAO,OAAO,CAAC,GAAG,UAAU,KAAK,CAAC,CAAC;CAEpD,OAAO,OAAO,OAAO;EACnB;EACA,MAAM,QAAQ,OAA0C;GACtD,MAAM,QAAQ,yBAAyB,MAAM,KAAK;GAClD,MAAM,UAAU,UAAU,IAAI,MAAM,QAAQ,OAAO;GACnD,IAAI,YAAY,KAAA,GACd,MAAM,IAAI,MAAM,8CAA8C,MAAM,QAAQ,QAAQ,EAAE;GAExF,MAAM,QAAQ,QAAQ,KAAK;EAC7B;CACF,CAAC;AACH"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/connectors/index.ts"],"sourcesContent":["import { z } from \"zod\";\nimport { changeIdSchema, repositoryIdsSchema, taskIdSchema } from \"../schema/id\";\nimport { replyToSchema } from \"../schema/common\";\nimport type { ReplyTo } from \"../schema/common\";\nimport type { SignalSource } from \"../schema/signal\";\n\nexport interface WebhookEvent {\n  deliveryId: string;\n  event: string;\n  payload: unknown;\n}\n\nexport interface NormalizedSignal<TSource extends SignalSource = SignalSource> {\n  source: TSource;\n  deliveryId: string;\n  replyTo: ReplyTo;\n  payload: unknown;\n}\n\nexport type SignalNormalizer<TSignal extends NormalizedSignal = NormalizedSignal> = (\n  event: WebhookEvent,\n) => TSignal | null;\n\nexport const communicationOutcomes = [\n  \"accepted\",\n  \"started\",\n  \"succeeded\",\n  \"failed\",\n  \"needs_human\",\n  \"question\",\n  \"digest\",\n  \"rolled_back\",\n  \"budget_warning\",\n  \"budget_exhausted\",\n  \"message\",\n] as const;\n\nexport const communicationOutcomeSchema = z\n  .enum(communicationOutcomes)\n  .describe(\"Lifecycle outcome a connector should render and deliver.\");\n\nexport const communicationEventSchema = z.strictObject({\n  eventId: z.string().min(1).describe(\"Stable idempotency key for this delivery.\"),\n  repositoryIds: repositoryIdsSchema,\n  taskId: taskIdSchema.optional(),\n  changeId: changeIdSchema.optional(),\n  replyTo: replyToSchema,\n  outcome: communicationOutcomeSchema,\n  data: z\n    .record(z.string(), z.unknown())\n    .describe(\"Outcome-specific data rendered by the selected connector.\"),\n});\n\nexport type CommunicationOutcome = z.infer<typeof communicationOutcomeSchema>;\nexport type CommunicationEvent = z.infer<typeof communicationEventSchema>;\n\nexport interface CommunicationAdapter {\n  readonly channel: string;\n  deliver(event: CommunicationEvent): Promise<void>;\n}\n\nexport interface CommunicationRouter {\n  readonly channels: readonly string[];\n  deliver(event: CommunicationEvent): Promise<void>;\n}\n\nexport function createCommunicationRouter(\n  adapters: readonly CommunicationAdapter[],\n): CommunicationRouter {\n  const byChannel = new Map<string, CommunicationAdapter>();\n  for (const adapter of adapters) {\n    const channel = adapter.channel.trim();\n    if (channel.length === 0) {\n      throw new Error(\"Communication adapter channel is required.\");\n    }\n    if (byChannel.has(channel)) {\n      throw new Error(`Communication adapter ${channel} is registered more than once.`);\n    }\n    byChannel.set(channel, adapter);\n  }\n  const channels = Object.freeze([...byChannel.keys()]);\n\n  return Object.freeze({\n    channels,\n    async deliver(input: CommunicationEvent): Promise<void> {\n      const event = communicationEventSchema.parse(input);\n      const adapter = byChannel.get(event.replyTo.channel);\n      if (adapter === undefined) {\n        throw new Error(`No communication adapter is registered for ${event.replyTo.channel}.`);\n      }\n      await adapter.deliver(event);\n    },\n  });\n}\n"],"mappings":";;;AAuBA,MAAa,wBAAwB;CACnC;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;CACA;AACF;AAEA,MAAa,6BAA6B,EACvC,KAAK,qBAAqB,CAAC,CAC3B,SAAS,0DAA0D;AAEtE,MAAa,2BAA2B,EAAE,aAAa;CACrD,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,2CAA2C;CAC/E,eAAe;CACf,QAAQ,aAAa,SAAS;CAC9B,UAAU,eAAe,SAAS;CAClC,SAAS;CACT,SAAS;CACT,MAAM,EACH,OAAO,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC,CAAC,CAC/B,SAAS,2DAA2D;AACzE,CAAC;AAeD,SAAgB,0BACd,UACqB;CACrB,MAAM,4BAAY,IAAI,IAAkC;CACxD,KAAK,MAAM,WAAW,UAAU;EAC9B,MAAM,UAAU,QAAQ,QAAQ,KAAK;EACrC,IAAI,QAAQ,WAAW,GACrB,MAAM,IAAI,MAAM,4CAA4C;EAE9D,IAAI,UAAU,IAAI,OAAO,GACvB,MAAM,IAAI,MAAM,yBAAyB,QAAQ,+BAA+B;EAElF,UAAU,IAAI,SAAS,OAAO;CAChC;CACA,MAAM,WAAW,OAAO,OAAO,CAAC,GAAG,UAAU,KAAK,CAAC,CAAC;CAEpD,OAAO,OAAO,OAAO;EACnB;EACA,MAAM,QAAQ,OAA0C;GACtD,MAAM,QAAQ,yBAAyB,MAAM,KAAK;GAClD,MAAM,UAAU,UAAU,IAAI,MAAM,QAAQ,OAAO;GACnD,IAAI,YAAY,KAAA,GACd,MAAM,IAAI,MAAM,8CAA8C,MAAM,QAAQ,QAAQ,EAAE;GAExF,MAAM,QAAQ,QAAQ,KAAK;EAC7B;CACF,CAAC;AACH"}

package/dist/connectors/slack.d.mts

@@ -1,5 +1,35 @@
-import { a as NormalizedSignal } from "../index-WNGZJRRH.mjs";
+import { a as NormalizedSignal, n as CommunicationEvent, t as CommunicationAdapter } from "../index-DUb-U5cy.mjs";
 //#region src/connectors/slack.d.ts
+interface SlackCommunicationDelivery {
+  eventId: string;
+  clientMessageId: string;
+  text: string;
+  target: {
+    type: "owner";
+  } | {
+    type: "thread";
+    channelId: string;
+    threadTs: string;
+  };
+}
+interface SlackCommunicationAdapter extends CommunicationAdapter {
+  readonly channel: "slack";
+  render(event: CommunicationEvent): string;
+}
+interface SlackCommunicationAdapterOptions {
+  send(delivery: SlackCommunicationDelivery): Promise<void>;
+  render?: (event: CommunicationEvent) => string;
+}
+interface SlackReplyTarget {
+  channelId: string;
+  threadTs: string;
+}
+/** Parse Eve's Slack continuation token into its channel and thread target. */
+declare function parseSlackReplyAddress(address: string): SlackReplyTarget;
+/** Render a provider-neutral communication event as plain Slack text. */
+declare function renderSlackCommunicationEvent(input: CommunicationEvent): string;
+/** Bind Slack rendering and delivery to the channel-neutral communication contract. */
+declare function createSlackCommunicationAdapter(options: SlackCommunicationAdapterOptions): SlackCommunicationAdapter;
 interface SlackMessageEvent {
   teamId: string;
   channelId: string;
@@ -39,5 +69,5 @@ type SlackRepositorySelection = {
  */
 declare function selectSlackRepository(text: string, repositories: readonly string[]): SlackRepositorySelection;
 //#endregion
-export { SlackMessageEvent, SlackMessageSignal, SlackRepositorySelection, normalizeSlackMessage, selectSlackRepository };
+export { SlackCommunicationAdapter, SlackCommunicationAdapterOptions, SlackCommunicationDelivery, SlackMessageEvent, SlackMessageSignal, SlackReplyTarget, SlackRepositorySelection, createSlackCommunicationAdapter, normalizeSlackMessage, parseSlackReplyAddress, renderSlackCommunicationEvent, selectSlackRepository };
 //# sourceMappingURL=slack.d.mts.map

package/dist/connectors/slack.mjs

@@ -1,4 +1,94 @@
+import { communicationEventSchema } from "./index.mjs";
+import { createHash } from "node:crypto";
 //#region src/connectors/slack.ts
+const slackOutcomeLabels = {
+	accepted: "Request accepted",
+	started: "Work started",
+	succeeded: "Work completed",
+	failed: "Work failed",
+	needs_human: "Human action required",
+	question: "Question requires an answer",
+	digest: "Factory digest",
+	rolled_back: "Change rolled back",
+	budget_warning: "Factory budget warning",
+	budget_exhausted: "Factory budget exhausted",
+	message: "Factory update"
+};
+const slackDetailFields = [
+	"title",
+	"message",
+	"summary",
+	"question",
+	"requestedAction",
+	"reason",
+	"url"
+];
+const slackListFields = ["items", "options"];
+const slackTextLimit = 12e3;
+const slackOwnerOutcomes = /* @__PURE__ */ new Set([
+	"digest",
+	"budget_warning",
+	"budget_exhausted"
+]);
+/** Parse Eve's Slack continuation token into its channel and thread target. */
+function parseSlackReplyAddress(address) {
+	const separator = address.indexOf(":");
+	const channelId = address.slice(0, separator);
+	const threadTs = address.slice(separator + 1);
+	if (separator <= 0 || !/^[A-Z][A-Z0-9]+$/.test(channelId) || !/^\d+\.\d+$/.test(threadTs)) throw new Error(`Invalid Slack reply address: ${address}.`);
+	return {
+		channelId,
+		threadTs
+	};
+}
+/** Render a provider-neutral communication event as plain Slack text. */
+function renderSlackCommunicationEvent(input) {
+	const event = communicationEventSchema.parse(input);
+	const headline = slackOutcomeLabels[event.outcome];
+	const details = slackDetailFields.flatMap((field) => {
+		const value = event.data[field];
+		return typeof value === "string" && value.trim() !== "" ? [value.trim()] : [];
+	});
+	const lists = slackListFields.flatMap((field) => {
+		const value = event.data[field];
+		if (!Array.isArray(value)) return [];
+		return value.flatMap((item) => typeof item === "string" && item.trim() !== "" ? [`- ${item.trim()}`] : []);
+	});
+	const text = [headline, .../* @__PURE__ */ new Set([...details, ...lists])].join("\n");
+	return text.length <= slackTextLimit ? text : `${text.slice(0, 11999)}…`;
+}
+function slackClientMessageId(eventId) {
+	const digest = createHash("sha256").update(eventId).digest("hex").slice(0, 32);
+	return [
+		digest.slice(0, 8),
+		digest.slice(8, 12),
+		digest.slice(12, 16),
+		digest.slice(16, 20),
+		digest.slice(20)
+	].join("-");
+}
+/** Bind Slack rendering and delivery to the channel-neutral communication contract. */
+function createSlackCommunicationAdapter(options) {
+	const render = options.render ?? renderSlackCommunicationEvent;
+	return Object.freeze({
+		channel: "slack",
+		render,
+		async deliver(input) {
+			const event = communicationEventSchema.parse(input);
+			if (event.replyTo.channel !== "slack") throw new Error(`Slack communication adapter cannot deliver to ${event.replyTo.channel}.`);
+			const target = slackOwnerOutcomes.has(event.outcome) ? { type: "owner" } : {
+				type: "thread",
+				...parseSlackReplyAddress(event.replyTo.address)
+			};
+			await options.send({
+				eventId: event.eventId,
+				clientMessageId: slackClientMessageId(event.eventId),
+				text: render(event),
+				target
+			});
+		}
+	});
+}
 /** Normalize an Eve-verified Slack message after the caller resolves its repository. */
 function normalizeSlackMessage(event) {
 	return {
@@ -45,6 +135,6 @@ function selectSlackRepository(text, repositories) {
 	return { status: "required" };
 }
 //#endregion
-export { normalizeSlackMessage, selectSlackRepository };
+export { createSlackCommunicationAdapter, normalizeSlackMessage, parseSlackReplyAddress, renderSlackCommunicationEvent, selectSlackRepository };
 
 //# sourceMappingURL=slack.mjs.map

package/dist/connectors/slack.mjs.map

@@ -1 +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"}
+{"version":3,"file":"slack.mjs","names":[],"sources":["../../src/connectors/slack.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport {\n  communicationEventSchema,\n  type CommunicationAdapter,\n  type CommunicationEvent,\n  type CommunicationOutcome,\n  type NormalizedSignal,\n} from \"./index\";\n\nconst slackOutcomeLabels: Record<CommunicationOutcome, string> = {\n  accepted: \"Request accepted\",\n  started: \"Work started\",\n  succeeded: \"Work completed\",\n  failed: \"Work failed\",\n  needs_human: \"Human action required\",\n  question: \"Question requires an answer\",\n  digest: \"Factory digest\",\n  rolled_back: \"Change rolled back\",\n  budget_warning: \"Factory budget warning\",\n  budget_exhausted: \"Factory budget exhausted\",\n  message: \"Factory update\",\n};\n\nconst slackDetailFields = [\"title\", \"message\", \"summary\", \"question\", \"requestedAction\", \"reason\", \"url\"] as const;\nconst slackListFields = [\"items\", \"options\"] as const;\nconst slackTextLimit = 12_000;\nconst slackOwnerOutcomes = new Set<CommunicationOutcome>([\n  \"digest\",\n  \"budget_warning\",\n  \"budget_exhausted\",\n]);\n\nexport interface SlackCommunicationDelivery {\n  eventId: string;\n  clientMessageId: string;\n  text: string;\n  target:\n    | { type: \"owner\" }\n    | { type: \"thread\"; channelId: string; threadTs: string };\n}\n\nexport interface SlackCommunicationAdapter extends CommunicationAdapter {\n  readonly channel: \"slack\";\n  render(event: CommunicationEvent): string;\n}\n\nexport interface SlackCommunicationAdapterOptions {\n  send(delivery: SlackCommunicationDelivery): Promise<void>;\n  render?: (event: CommunicationEvent) => string;\n}\n\nexport interface SlackReplyTarget {\n  channelId: string;\n  threadTs: string;\n}\n\n/** Parse Eve's Slack continuation token into its channel and thread target. */\nexport function parseSlackReplyAddress(address: string): SlackReplyTarget {\n  const separator = address.indexOf(\":\");\n  const channelId = address.slice(0, separator);\n  const threadTs = address.slice(separator + 1);\n  if (separator <= 0 || !/^[A-Z][A-Z0-9]+$/.test(channelId) || !/^\\d+\\.\\d+$/.test(threadTs)) {\n    throw new Error(`Invalid Slack reply address: ${address}.`);\n  }\n  return { channelId, threadTs };\n}\n\n/** Render a provider-neutral communication event as plain Slack text. */\nexport function renderSlackCommunicationEvent(input: CommunicationEvent): string {\n  const event = communicationEventSchema.parse(input);\n  const headline = slackOutcomeLabels[event.outcome];\n  const details = slackDetailFields.flatMap((field) => {\n    const value = event.data[field];\n    return typeof value === \"string\" && value.trim() !== \"\" ? [value.trim()] : [];\n  });\n  const lists = slackListFields.flatMap((field) => {\n    const value = event.data[field];\n    if (!Array.isArray(value)) return [];\n    return value.flatMap((item) =>\n      typeof item === \"string\" && item.trim() !== \"\" ? [`- ${item.trim()}`] : []\n    );\n  });\n  const text = [headline, ...new Set([...details, ...lists])].join(\"\\n\");\n  return text.length <= slackTextLimit ? text : `${text.slice(0, slackTextLimit - 1)}…`;\n}\n\nfunction slackClientMessageId(eventId: string): string {\n  const digest = createHash(\"sha256\").update(eventId).digest(\"hex\").slice(0, 32);\n  return [\n    digest.slice(0, 8),\n    digest.slice(8, 12),\n    digest.slice(12, 16),\n    digest.slice(16, 20),\n    digest.slice(20),\n  ].join(\"-\");\n}\n\n/** Bind Slack rendering and delivery to the channel-neutral communication contract. */\nexport function createSlackCommunicationAdapter(\n  options: SlackCommunicationAdapterOptions,\n): SlackCommunicationAdapter {\n  const render = options.render ?? renderSlackCommunicationEvent;\n  return Object.freeze({\n    channel: \"slack\" as const,\n    render,\n    async deliver(input: CommunicationEvent): Promise<void> {\n      const event = communicationEventSchema.parse(input);\n      if (event.replyTo.channel !== \"slack\") {\n        throw new Error(`Slack communication adapter cannot deliver to ${event.replyTo.channel}.`);\n      }\n      const target = slackOwnerOutcomes.has(event.outcome)\n        ? { type: \"owner\" as const }\n        : { type: \"thread\" as const, ...parseSlackReplyAddress(event.replyTo.address) };\n      await options.send({\n        eventId: event.eventId,\n        clientMessageId: slackClientMessageId(event.eventId),\n        text: render(event),\n        target,\n      });\n    },\n  });\n}\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":";;;AASA,MAAM,qBAA2D;CAC/D,UAAU;CACV,SAAS;CACT,WAAW;CACX,QAAQ;CACR,aAAa;CACb,UAAU;CACV,QAAQ;CACR,aAAa;CACb,gBAAgB;CAChB,kBAAkB;CAClB,SAAS;AACX;AAEA,MAAM,oBAAoB;CAAC;CAAS;CAAW;CAAW;CAAY;CAAmB;CAAU;AAAK;AACxG,MAAM,kBAAkB,CAAC,SAAS,SAAS;AAC3C,MAAM,iBAAiB;AACvB,MAAM,qCAAqB,IAAI,IAA0B;CACvD;CACA;CACA;AACF,CAAC;;AA2BD,SAAgB,uBAAuB,SAAmC;CACxE,MAAM,YAAY,QAAQ,QAAQ,GAAG;CACrC,MAAM,YAAY,QAAQ,MAAM,GAAG,SAAS;CAC5C,MAAM,WAAW,QAAQ,MAAM,YAAY,CAAC;CAC5C,IAAI,aAAa,KAAK,CAAC,mBAAmB,KAAK,SAAS,KAAK,CAAC,aAAa,KAAK,QAAQ,GACtF,MAAM,IAAI,MAAM,gCAAgC,QAAQ,EAAE;CAE5D,OAAO;EAAE;EAAW;CAAS;AAC/B;;AAGA,SAAgB,8BAA8B,OAAmC;CAC/E,MAAM,QAAQ,yBAAyB,MAAM,KAAK;CAClD,MAAM,WAAW,mBAAmB,MAAM;CAC1C,MAAM,UAAU,kBAAkB,SAAS,UAAU;EACnD,MAAM,QAAQ,MAAM,KAAK;EACzB,OAAO,OAAO,UAAU,YAAY,MAAM,KAAK,MAAM,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC;CAC9E,CAAC;CACD,MAAM,QAAQ,gBAAgB,SAAS,UAAU;EAC/C,MAAM,QAAQ,MAAM,KAAK;EACzB,IAAI,CAAC,MAAM,QAAQ,KAAK,GAAG,OAAO,CAAC;EACnC,OAAO,MAAM,SAAS,SACpB,OAAO,SAAS,YAAY,KAAK,KAAK,MAAM,KAAK,CAAC,KAAK,KAAK,KAAK,GAAG,IAAI,CAAC,CAC3E;CACF,CAAC;CACD,MAAM,OAAO,CAAC,UAAU,mBAAG,IAAI,IAAI,CAAC,GAAG,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;CACrE,OAAO,KAAK,UAAU,iBAAiB,OAAO,GAAG,KAAK,MAAM,GAAG,KAAkB,EAAE;AACrF;AAEA,SAAS,qBAAqB,SAAyB;CACrD,MAAM,SAAS,WAAW,QAAQ,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,GAAG,EAAE;CAC7E,OAAO;EACL,OAAO,MAAM,GAAG,CAAC;EACjB,OAAO,MAAM,GAAG,EAAE;EAClB,OAAO,MAAM,IAAI,EAAE;EACnB,OAAO,MAAM,IAAI,EAAE;EACnB,OAAO,MAAM,EAAE;CACjB,CAAC,CAAC,KAAK,GAAG;AACZ;;AAGA,SAAgB,gCACd,SAC2B;CAC3B,MAAM,SAAS,QAAQ,UAAU;CACjC,OAAO,OAAO,OAAO;EACnB,SAAS;EACT;EACA,MAAM,QAAQ,OAA0C;GACtD,MAAM,QAAQ,yBAAyB,MAAM,KAAK;GAClD,IAAI,MAAM,QAAQ,YAAY,SAC5B,MAAM,IAAI,MAAM,iDAAiD,MAAM,QAAQ,QAAQ,EAAE;GAE3F,MAAM,SAAS,mBAAmB,IAAI,MAAM,OAAO,IAC/C,EAAE,MAAM,QAAiB,IACzB;IAAE,MAAM;IAAmB,GAAG,uBAAuB,MAAM,QAAQ,OAAO;GAAE;GAChF,MAAM,QAAQ,KAAK;IACjB,SAAS,MAAM;IACf,iBAAiB,qBAAqB,MAAM,OAAO;IACnD,MAAM,OAAO,KAAK;IAClB;GACF,CAAC;EACH;CACF,CAAC;AACH;;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 { d as GitHubReviewComment } from "../github-3sbHe-fo.mjs";
+import { c as Finding, k as FactoryStores, t as ApprovalPolicy } from "../approval-qkxww0wJ.mjs";
+import { d as GitHubReviewComment } from "../github-BdWWueJP.mjs";
 import { z } from "zod";
 //#region src/eve/fetch.d.ts
 /** The subset of the eve sandbox handle a credentialed git operation needs. */
@@ -362,7 +362,7 @@ declare function invokeAgentTool(stores: FactoryStores, options: InvokeAgentOpti
 }, {
   taskId: string;
   kind: string;
-  state: "queued" | "running" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+  state: "succeeded" | "failed" | "needs_human" | "queued" | "running" | "verifying" | "cancelled";
 }> & {
   execute(input: {
     repositoryIds: string[];
@@ -374,7 +374,7 @@ declare function invokeAgentTool(stores: FactoryStores, options: InvokeAgentOpti
   }, ctx: import("eve/tools").ToolContext): Promise<{
     taskId: string;
     kind: string;
-    state: "queued" | "running" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+    state: "succeeded" | "failed" | "needs_human" | "queued" | "running" | "verifying" | "cancelled";
   }>;
 };
 //#endregion
@@ -484,8 +484,8 @@ declare function recordVerificationTool(stores: FactoryStores): import("eve/tool
 } | {
   recorded: true;
   verdict: "pass" | "fail";
-  changeState: "verifying" | "ready" | "merged" | "deployed" | "rolled_out" | "rolled_back" | "closed";
-  taskState: "queued" | "running" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+  changeState: "rolled_back" | "verifying" | "ready" | "merged" | "deployed" | "rolled_out" | "closed";
+  taskState: "succeeded" | "failed" | "needs_human" | "queued" | "running" | "verifying" | "cancelled";
   reason?: undefined;
 }> & {
   execute(input: {
@@ -511,8 +511,8 @@ declare function recordVerificationTool(stores: FactoryStores): import("eve/tool
   } | {
     recorded: true;
     verdict: "pass" | "fail";
-    changeState: "verifying" | "ready" | "merged" | "deployed" | "rolled_out" | "rolled_back" | "closed";
-    taskState: "queued" | "running" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+    changeState: "rolled_back" | "verifying" | "ready" | "merged" | "deployed" | "rolled_out" | "closed";
+    taskState: "succeeded" | "failed" | "needs_human" | "queued" | "running" | "verifying" | "cancelled";
     reason?: undefined;
   }>;
 };
@@ -563,7 +563,7 @@ declare function factoryTools(stores: FactoryStores, options?: FactoryToolsOptio
     schemaVersion: 1;
     id: string;
     kind: string;
-    state: "queued" | "running" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+    state: "succeeded" | "failed" | "needs_human" | "queued" | "running" | "verifying" | "cancelled";
     origin: {
       signalId?: string | undefined;
       parentTaskId?: string | undefined;
@@ -605,7 +605,7 @@ declare function factoryTools(stores: FactoryStores, options?: FactoryToolsOptio
       schemaVersion: 1;
       id: string;
       kind: string;
-      state: "queued" | "running" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+      state: "succeeded" | "failed" | "needs_human" | "queued" | "running" | "verifying" | "cancelled";
       origin: {
         signalId?: string | undefined;
         parentTaskId?: string | undefined;
@@ -713,18 +713,19 @@ declare function factoryTools(stores: FactoryStores, options?: FactoryToolsOptio
         scopeMatches: boolean;
         previewUrl?: string | undefined;
       };
-      state: "verifying" | "ready" | "merged" | "deployed" | "rolled_out" | "rolled_back" | "closed";
+      state: "rolled_back" | "verifying" | "ready" | "merged" | "deployed" | "rolled_out" | "closed";
       createdAt: string;
       updatedAt: string;
       taskId?: string | undefined;
       groupId?: string | undefined;
+      mergeSha?: string | undefined;
       decidedBy?: string | undefined;
     };
     task: {
       schemaVersion: 1;
       id: string;
       kind: string;
-      state: "queued" | "running" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+      state: "succeeded" | "failed" | "needs_human" | "queued" | "running" | "verifying" | "cancelled";
       origin: {
         signalId?: string | undefined;
         parentTaskId?: string | undefined;
@@ -784,18 +785,19 @@ declare function factoryTools(stores: FactoryStores, options?: FactoryToolsOptio
           scopeMatches: boolean;
           previewUrl?: string | undefined;
         };
-        state: "verifying" | "ready" | "merged" | "deployed" | "rolled_out" | "rolled_back" | "closed";
+        state: "rolled_back" | "verifying" | "ready" | "merged" | "deployed" | "rolled_out" | "closed";
         createdAt: string;
         updatedAt: string;
         taskId?: string | undefined;
         groupId?: string | undefined;
+        mergeSha?: string | undefined;
         decidedBy?: string | undefined;
       };
       task: {
         schemaVersion: 1;
         id: string;
         kind: string;
-        state: "queued" | "running" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+        state: "succeeded" | "failed" | "needs_human" | "queued" | "running" | "verifying" | "cancelled";
         origin: {
           signalId?: string | undefined;
           parentTaskId?: string | undefined;
@@ -839,7 +841,7 @@ declare function factoryTools(stores: FactoryStores, options?: FactoryToolsOptio
     taskState?: undefined;
   } | {
     finished: true;
-    taskState: "queued" | "running" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+    taskState: "succeeded" | "failed" | "needs_human" | "queued" | "running" | "verifying" | "cancelled";
     reason?: undefined;
   }> & {
     execute(input: {
@@ -851,7 +853,7 @@ declare function factoryTools(stores: FactoryStores, options?: FactoryToolsOptio
       taskState?: undefined;
     } | {
       finished: true;
-      taskState: "queued" | "running" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+      taskState: "succeeded" | "failed" | "needs_human" | "queued" | "running" | "verifying" | "cancelled";
       reason?: undefined;
     }>;
   };
@@ -862,7 +864,7 @@ declare function factoryTools(stores: FactoryStores, options?: FactoryToolsOptio
     schemaVersion: 1;
     id: string;
     kind: string;
-    state: "queued" | "running" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+    state: "succeeded" | "failed" | "needs_human" | "queued" | "running" | "verifying" | "cancelled";
     origin: {
       signalId?: string | undefined;
       parentTaskId?: string | undefined;
@@ -902,7 +904,7 @@ declare function factoryTools(stores: FactoryStores, options?: FactoryToolsOptio
       schemaVersion: 1;
       id: string;
       kind: string;
-      state: "queued" | "running" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+      state: "succeeded" | "failed" | "needs_human" | "queued" | "running" | "verifying" | "cancelled";
       origin: {
         signalId?: string | undefined;
         parentTaskId?: string | undefined;
@@ -949,7 +951,7 @@ declare function factoryTools(stores: FactoryStores, options?: FactoryToolsOptio
     schemaVersion: 1;
     id: string;
     kind: string;
-    state: "queued" | "running" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+    state: "succeeded" | "failed" | "needs_human" | "queued" | "running" | "verifying" | "cancelled";
     origin: {
       signalId?: string | undefined;
       parentTaskId?: string | undefined;
@@ -995,7 +997,7 @@ declare function factoryTools(stores: FactoryStores, options?: FactoryToolsOptio
       schemaVersion: 1;
       id: string;
       kind: string;
-      state: "queued" | "running" | "verifying" | "succeeded" | "failed" | "needs_human" | "cancelled";
+      state: "succeeded" | "failed" | "needs_human" | "queued" | "running" | "verifying" | "cancelled";
       origin: {
         signalId?: string | undefined;
         parentTaskId?: string | undefined;

package/dist/eve/index.mjs

@@ -1,5 +1,5 @@
 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 { 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-BxTU3MJb.mjs";
 import { answerReviewComment, readPullRequestHead, readReviewComment } from "../github.mjs";
 import { z } from "zod";
 import { defineHook } from "eve/hooks";

package/dist/{github-3sbHe-fo.d.mts → github-BdWWueJP.d.mts}

@@ -1,4 +1,4 @@
-import { a as NormalizedSignal, s as WebhookEvent } from "./index-WNGZJRRH.mjs";
+import { a as NormalizedSignal, s as WebhookEvent } from "./index-DUb-U5cy.mjs";
 //#region src/github.d.ts
 interface GitHubRepositoryRequest {
   repository: string;
@@ -133,6 +133,8 @@ interface GitHubPullRequestClosed {
   prNumber: number;
   prUrl: string;
   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;
 }
@@ -146,4 +148,4 @@ declare function normalizeGitHubPullRequestClosed(options: WebhookEvent): GitHub
 declare function normalizeGitHubWorkflowRunFailure(options: WebhookEvent): GitHubCIFailureSignal | null;
 //#endregion
 export { normalizeGitHubIssueOpened as C, readReviewComment as D, readPullRequestHead as E, removeLabel as O, normalizeGitHubDefaultBranchPush as S, normalizeGitHubWorkflowRunFailure as T, ReviewCommentAuthorPolicy as _, GitHubCIFailureSignal as a, createPullRequest as b, GitHubPullRequestClosed as c, GitHubReviewComment as d, GitHubReviewCommentAuthorError as f, ReadReviewCommentInput as g, ReadPullRequestHeadInput as h, CreatedPullRequest as i, verifyGitHubSignature as k, GitHubPullRequestHead as l, PullRequestLabelInput as m, ConflictedPullRequest as n, GitHubDefaultBranchPush as o, ListConflictedPullRequestsInput as p, CreatePullRequestInput as r, GitHubIssueSignal as s, AnswerReviewCommentInput as t, GitHubRepositoryRequest as u, addLabel as v, normalizeGitHubPullRequestClosed as w, listConflictedPullRequests as x, answerReviewComment as y };
-//# sourceMappingURL=github-3sbHe-fo.d.mts.map
+//# sourceMappingURL=github-BdWWueJP.d.mts.map

package/dist/github.d.mts

@@ -1,2 +1,2 @@
-import { C as normalizeGitHubIssueOpened, D as readReviewComment, E as readPullRequestHead, O as removeLabel, S as normalizeGitHubDefaultBranchPush, T as normalizeGitHubWorkflowRunFailure, _ as ReviewCommentAuthorPolicy, a as GitHubCIFailureSignal, b as createPullRequest, c as GitHubPullRequestClosed, d as GitHubReviewComment, f as GitHubReviewCommentAuthorError, g as ReadReviewCommentInput, h as ReadPullRequestHeadInput, i as CreatedPullRequest, k as verifyGitHubSignature, l as GitHubPullRequestHead, m as PullRequestLabelInput, n as ConflictedPullRequest, o as GitHubDefaultBranchPush, p as ListConflictedPullRequestsInput, r as CreatePullRequestInput, s as GitHubIssueSignal, t as AnswerReviewCommentInput, u as GitHubRepositoryRequest, v as addLabel, w as normalizeGitHubPullRequestClosed, x as listConflictedPullRequests, y as answerReviewComment } from "./github-3sbHe-fo.mjs";
+import { C as normalizeGitHubIssueOpened, D as readReviewComment, E as readPullRequestHead, O as removeLabel, S as normalizeGitHubDefaultBranchPush, T as normalizeGitHubWorkflowRunFailure, _ as ReviewCommentAuthorPolicy, a as GitHubCIFailureSignal, b as createPullRequest, c as GitHubPullRequestClosed, d as GitHubReviewComment, f as GitHubReviewCommentAuthorError, g as ReadReviewCommentInput, h as ReadPullRequestHeadInput, i as CreatedPullRequest, k as verifyGitHubSignature, l as GitHubPullRequestHead, m as PullRequestLabelInput, n as ConflictedPullRequest, o as GitHubDefaultBranchPush, p as ListConflictedPullRequestsInput, r as CreatePullRequestInput, s as GitHubIssueSignal, t as AnswerReviewCommentInput, u as GitHubRepositoryRequest, v as addLabel, w as normalizeGitHubPullRequestClosed, x as listConflictedPullRequests, y as answerReviewComment } from "./github-BdWWueJP.mjs";
 export { AnswerReviewCommentInput, ConflictedPullRequest, CreatePullRequestInput, CreatedPullRequest, GitHubCIFailureSignal, GitHubDefaultBranchPush, GitHubIssueSignal, GitHubPullRequestClosed, GitHubPullRequestHead, GitHubRepositoryRequest, GitHubReviewComment, GitHubReviewCommentAuthorError, ListConflictedPullRequestsInput, PullRequestLabelInput, ReadPullRequestHeadInput, ReadReviewCommentInput, ReviewCommentAuthorPolicy, addLabel, answerReviewComment, createPullRequest, listConflictedPullRequests, normalizeGitHubDefaultBranchPush, normalizeGitHubIssueOpened, normalizeGitHubPullRequestClosed, normalizeGitHubWorkflowRunFailure, readPullRequestHead, readReviewComment, removeLabel, verifyGitHubSignature };

package/dist/github.mjs

@@ -268,7 +268,8 @@ const pullRequestClosedSchema = z.looseObject({
 		number: z.number().int().min(1),
 		html_url: z.url(),
 		merged: z.boolean(),
-		merged_by: z.looseObject({ login: z.string().min(1) }).nullable().optional()
+		merged_by: z.looseObject({ login: z.string().min(1) }).nullable().optional(),
+		merge_commit_sha: z.string().regex(/^[0-9a-f]{40}$/).nullable().optional()
 	}),
 	repository: z.looseObject({ full_name: z.string().min(1) }),
 	sender: z.looseObject({ login: z.string().min(1) })
@@ -291,6 +292,7 @@ function normalizeGitHubPullRequestClosed(options) {
 		prNumber: pr.number,
 		prUrl: pr.html_url,
 		merged: pr.merged,
+		mergeCommitSha: pr.merged ? pr.merge_commit_sha ?? null : null,
 		decidedBy: pr.merged ? pr.merged_by?.login ?? sender : sender
 	};
 }