@vercel/factory 0.0.12 → 0.0.14

package/dist/connectors/index.d.mts

@@ -1,2 +1,3 @@
-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-Cy4jfXh5.mjs";
-export { CommunicationAdapter, CommunicationEvent, CommunicationOutcome, CommunicationRouter, NormalizedSignal, SignalNormalizer, WebhookEvent, communicationEventSchema, communicationOutcomeSchema, communicationOutcomes, createCommunicationRouter };
+import { ct as CommunicationOutcome, dt as communicationOutcomes, lt as communicationEventSchema, st as CommunicationEvent, ut as communicationOutcomeSchema } from "../engine-DFHU2Pe-.mjs";
+import { a as WebhookEvent, c as OutboxSweepResult, i as SignalNormalizer, l as createOutboxCommunicationRouter, n as CommunicationRouter, o as createCommunicationRouter, r as NormalizedSignal, s as OutboxDeliveryOptions, t as CommunicationAdapter, u as sweepCommunicationOutbox } from "../index-Bw6hggoH.mjs";
+export { CommunicationAdapter, type CommunicationEvent, type CommunicationOutcome, CommunicationRouter, NormalizedSignal, OutboxDeliveryOptions, OutboxSweepResult, SignalNormalizer, WebhookEvent, communicationEventSchema, communicationOutcomeSchema, communicationOutcomes, createCommunicationRouter, createOutboxCommunicationRouter, sweepCommunicationOutbox };

package/dist/connectors/index.mjs

@@ -1,29 +1,56 @@
-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 = [
-	"accepted",
-	"started",
-	"succeeded",
-	"failed",
-	"needs_human",
-	"question",
-	"digest",
-	"rolled_back",
-	"budget_warning",
-	"budget_exhausted",
-	"message"
+import { n as communicationOutcomeSchema, r as communicationOutcomes, t as communicationEventSchema } from "../communication-Kd9nU5RP.mjs";
+//#region src/connectors/outbox.ts
+const defaultRetryDelayMs = (attempt) => Math.min(6e4 * 2 ** Math.max(0, attempt - 1), 36e5);
+const credentialPatterns = [
+	/github_pat_[A-Za-z0-9_]+/gu,
+	/gh[psoru]_[A-Za-z0-9_]+/gu,
+	/xox[baprs]-[A-Za-z0-9-]+/gu,
+	/(?:Basic|Bearer) [A-Za-z0-9+/_=.:-]+/gu
 ];
-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."),
-	repositoryIds: repositoryIdsSchema,
-	taskId: taskIdSchema.optional(),
-	changeId: changeIdSchema.optional(),
-	replyTo: replyToSchema,
-	outcome: communicationOutcomeSchema,
-	data: z.record(z.string(), z.unknown()).describe("Outcome-specific data rendered by the selected connector.")
-});
+function errorMessage(error) {
+	let message = error instanceof Error ? error.message : "Unknown communication delivery error";
+	for (const pattern of credentialPatterns) message = message.replace(pattern, (match) => {
+		return `${match.startsWith("Basic ") ? "Basic " : match.startsWith("Bearer ") ? "Bearer " : ""}[REDACTED]`;
+	});
+	return message;
+}
+async function deliverOne(stores, router, id, options) {
+	const claimed = await stores.outbox.claim(id, options.leaseMs);
+	if (claimed === null) return "skipped";
+	try {
+		await router.deliver(claimed.event);
+		return await stores.outbox.complete(claimed.id, claimed.attempt) === null ? "skipped" : "delivered";
+	} catch (error) {
+		const delay = (options.retryDelayMs ?? defaultRetryDelayMs)(claimed.attempt);
+		return await stores.outbox.retry(claimed.id, claimed.attempt, errorMessage(error), delay) === null ? "skipped" : "retried";
+	}
+}
+async function sweepCommunicationOutbox(stores, router, options = {}) {
+	const limit = options.limit ?? 100;
+	const messages = await stores.outbox.pending(limit);
+	const result = {
+		delivered: 0,
+		retried: 0,
+		skipped: 0
+	};
+	for (const message of messages) {
+		const outcome = await deliverOne(stores, router, message.id, options);
+		result[outcome] += 1;
+	}
+	return result;
+}
+function createOutboxCommunicationRouter(stores, router, options = {}) {
+	return Object.freeze({
+		channels: router.channels,
+		async deliver(event) {
+			const message = await stores.outbox.enqueue(event);
+			if (message.state === "delivered") return;
+			await deliverOne(stores, router, message.id, options);
+		}
+	});
+}
+//#endregion
+//#region src/connectors/index.ts
 function createCommunicationRouter(adapters) {
 	const byChannel = /* @__PURE__ */ new Map();
 	for (const adapter of adapters) {
@@ -44,6 +71,6 @@ function createCommunicationRouter(adapters) {
 	});
 }
 //#endregion
-export { communicationEventSchema, communicationOutcomeSchema, communicationOutcomes, createCommunicationRouter };
+export { communicationEventSchema, communicationOutcomeSchema, communicationOutcomes, createCommunicationRouter, createOutboxCommunicationRouter, sweepCommunicationOutbox };
 
 //# sourceMappingURL=index.mjs.map

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, 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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../src/connectors/outbox.ts","../../src/connectors/index.ts"],"sourcesContent":["import type { OutboxId } from \"../schema/id\";\nimport type { FactoryStores } from \"../store/engine\";\nimport type { CommunicationEvent, CommunicationRouter } from \"./index\";\n\nexport interface OutboxSweepResult {\n  delivered: number;\n  retried: number;\n  skipped: number;\n}\n\nexport interface OutboxDeliveryOptions {\n  leaseMs?: number;\n  limit?: number;\n  retryDelayMs?: (attempt: number) => number;\n}\n\nconst defaultRetryDelayMs = (attempt: number) =>\n  Math.min(60_000 * 2 ** Math.max(0, attempt - 1), 60 * 60_000);\n\nconst credentialPatterns = [\n  /github_pat_[A-Za-z0-9_]+/gu,\n  /gh[psoru]_[A-Za-z0-9_]+/gu,\n  /xox[baprs]-[A-Za-z0-9-]+/gu,\n  /(?:Basic|Bearer) [A-Za-z0-9+/_=.:-]+/gu,\n] as const;\n\nfunction errorMessage(error: unknown): string {\n  let message = error instanceof Error ? error.message : \"Unknown communication delivery error\";\n  for (const pattern of credentialPatterns) {\n    message = message.replace(pattern, (match) => {\n      const scheme = match.startsWith(\"Basic \")\n        ? \"Basic \"\n        : match.startsWith(\"Bearer \")\n          ? \"Bearer \"\n          : \"\";\n      return `${scheme}[REDACTED]`;\n    });\n  }\n  return message;\n}\n\nasync function deliverOne(\n  stores: FactoryStores,\n  router: CommunicationRouter,\n  id: OutboxId,\n  options: OutboxDeliveryOptions,\n): Promise<\"delivered\" | \"retried\" | \"skipped\"> {\n  const claimed = await stores.outbox.claim(id, options.leaseMs);\n  if (claimed === null) return \"skipped\";\n  try {\n    await router.deliver(claimed.event);\n    const completed = await stores.outbox.complete(claimed.id, claimed.attempt);\n    return completed === null ? \"skipped\" : \"delivered\";\n  } catch (error) {\n    const delay = (options.retryDelayMs ?? defaultRetryDelayMs)(claimed.attempt);\n    const retried = await stores.outbox.retry(\n      claimed.id,\n      claimed.attempt,\n      errorMessage(error),\n      delay,\n    );\n    return retried === null ? \"skipped\" : \"retried\";\n  }\n}\n\nexport async function sweepCommunicationOutbox(\n  stores: FactoryStores,\n  router: CommunicationRouter,\n  options: OutboxDeliveryOptions = {},\n): Promise<OutboxSweepResult> {\n  const limit = options.limit ?? 100;\n  const messages = await stores.outbox.pending(limit);\n  const result: OutboxSweepResult = { delivered: 0, retried: 0, skipped: 0 };\n  for (const message of messages) {\n    const outcome = await deliverOne(stores, router, message.id, options);\n    result[outcome] += 1;\n  }\n  return result;\n}\n\nexport function createOutboxCommunicationRouter(\n  stores: FactoryStores,\n  router: CommunicationRouter,\n  options: OutboxDeliveryOptions = {},\n): CommunicationRouter {\n  return Object.freeze({\n    channels: router.channels,\n    async deliver(event: CommunicationEvent): Promise<void> {\n      const message = await stores.outbox.enqueue(event);\n      if (message.state === \"delivered\") return;\n      await deliverOne(stores, router, message.id, options);\n    },\n  });\n}\n","import { communicationEventSchema, type CommunicationEvent } from \"../schema/communication\";\nimport type { ReplyTo } from \"../schema/common\";\nimport type { SignalSource } from \"../schema/signal\";\n\nexport {\n  communicationEventSchema,\n  communicationOutcomeSchema,\n  communicationOutcomes,\n  type CommunicationEvent,\n  type CommunicationOutcome,\n} from \"../schema/communication\";\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 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\nexport * from \"./outbox\";\n"],"mappings":";;AAgBA,MAAM,uBAAuB,YAC3B,KAAK,IAAI,MAAS,KAAK,KAAK,IAAI,GAAG,UAAU,CAAC,GAAG,IAAW;AAE9D,MAAM,qBAAqB;CACzB;CACA;CACA;CACA;AACF;AAEA,SAAS,aAAa,OAAwB;CAC5C,IAAI,UAAU,iBAAiB,QAAQ,MAAM,UAAU;CACvD,KAAK,MAAM,WAAW,oBACpB,UAAU,QAAQ,QAAQ,UAAU,UAAU;EAM5C,OAAO,GALQ,MAAM,WAAW,QAAQ,IACpC,WACA,MAAM,WAAW,SAAS,IACxB,YACA,GACW;CACnB,CAAC;CAEH,OAAO;AACT;AAEA,eAAe,WACb,QACA,QACA,IACA,SAC8C;CAC9C,MAAM,UAAU,MAAM,OAAO,OAAO,MAAM,IAAI,QAAQ,OAAO;CAC7D,IAAI,YAAY,MAAM,OAAO;CAC7B,IAAI;EACF,MAAM,OAAO,QAAQ,QAAQ,KAAK;EAElC,OAAO,MADiB,OAAO,OAAO,SAAS,QAAQ,IAAI,QAAQ,OAAO,MACrD,OAAO,YAAY;CAC1C,SAAS,OAAO;EACd,MAAM,SAAS,QAAQ,gBAAgB,oBAAA,CAAqB,QAAQ,OAAO;EAO3E,OAAO,MANe,OAAO,OAAO,MAClC,QAAQ,IACR,QAAQ,SACR,aAAa,KAAK,GAClB,KACF,MACmB,OAAO,YAAY;CACxC;AACF;AAEA,eAAsB,yBACpB,QACA,QACA,UAAiC,CAAC,GACN;CAC5B,MAAM,QAAQ,QAAQ,SAAS;CAC/B,MAAM,WAAW,MAAM,OAAO,OAAO,QAAQ,KAAK;CAClD,MAAM,SAA4B;EAAE,WAAW;EAAG,SAAS;EAAG,SAAS;CAAE;CACzE,KAAK,MAAM,WAAW,UAAU;EAC9B,MAAM,UAAU,MAAM,WAAW,QAAQ,QAAQ,QAAQ,IAAI,OAAO;EACpE,OAAO,YAAY;CACrB;CACA,OAAO;AACT;AAEA,SAAgB,gCACd,QACA,QACA,UAAiC,CAAC,GACb;CACrB,OAAO,OAAO,OAAO;EACnB,UAAU,OAAO;EACjB,MAAM,QAAQ,OAA0C;GACtD,MAAM,UAAU,MAAM,OAAO,OAAO,QAAQ,KAAK;GACjD,IAAI,QAAQ,UAAU,aAAa;GACnC,MAAM,WAAW,QAAQ,QAAQ,QAAQ,IAAI,OAAO;EACtD;CACF,CAAC;AACH;;;ACtDA,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,4 +1,5 @@
-import { a as NormalizedSignal, n as CommunicationEvent, t as CommunicationAdapter } from "../index-Cy4jfXh5.mjs";
+import { st as CommunicationEvent } from "../engine-DFHU2Pe-.mjs";
+import { r as NormalizedSignal, t as CommunicationAdapter } from "../index-Bw6hggoH.mjs";
 //#region src/connectors/slack.d.ts
 interface SlackCommunicationDelivery {
   eventId: string;
@@ -24,9 +25,19 @@ interface SlackReplyTarget {
   channelId: string;
   threadTs: string;
 }
+type SlackPullRequestSelection = {
+  status: "none";
+} | {
+  status: "ambiguous";
+} | {
+  status: "selected";
+  pullRequestNumber: number;
+};
+/** Resolve an explicit pull-request reference after the repository has been selected. */
+declare function selectSlackPullRequest(text: string, repositorySlug: string): SlackPullRequestSelection;
 /** 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. */
+/** Render a provider-neutral communication event as Slack mrkdwn. */
 declare function renderSlackCommunicationEvent(input: CommunicationEvent): string;
 /** Bind Slack rendering and delivery to the channel-neutral communication contract. */
 declare function createSlackCommunicationAdapter(options: SlackCommunicationAdapterOptions): SlackCommunicationAdapter;
@@ -69,13 +80,13 @@ type SlackRepositoriesSelection = {
 } | {
   status: "required";
 };
-/** Select every explicitly named configured repository, preserving configuration order. */
+/** Select every named configured repository, preserving configuration order. */
 declare function selectSlackRepositories(text: string, repositories: readonly string[]): SlackRepositoriesSelection;
 /**
- * Select the only configured repository, or require an explicit owner/name
- * when a Slack surface fronts more than one repository.
+ * Select the only configured repository, or match a full slug, unique short
+ * name, or GitHub repository URL when a Slack surface fronts multiple repositories.
  */
 declare function selectSlackRepository(text: string, repositories: readonly string[]): SlackRepositorySelection;
 //#endregion
-export { SlackCommunicationAdapter, SlackCommunicationAdapterOptions, SlackCommunicationDelivery, SlackMessageEvent, SlackMessageSignal, SlackReplyTarget, SlackRepositoriesSelection, SlackRepositorySelection, createSlackCommunicationAdapter, normalizeSlackMessage, parseSlackReplyAddress, renderSlackCommunicationEvent, selectSlackRepositories, selectSlackRepository };
+export { SlackCommunicationAdapter, SlackCommunicationAdapterOptions, SlackCommunicationDelivery, SlackMessageEvent, SlackMessageSignal, SlackPullRequestSelection, SlackReplyTarget, SlackRepositoriesSelection, SlackRepositorySelection, createSlackCommunicationAdapter, normalizeSlackMessage, parseSlackReplyAddress, renderSlackCommunicationEvent, selectSlackPullRequest, selectSlackRepositories, selectSlackRepository };
 //# sourceMappingURL=slack.d.mts.map

package/dist/connectors/slack.mjs

@@ -1,4 +1,5 @@
-import { communicationEventSchema } from "./index.mjs";
+import { t as communicationEventSchema } from "../communication-Kd9nU5RP.mjs";
+import "./index.mjs";
 import { createHash } from "node:crypto";
 //#region src/connectors/slack.ts
 const slackOutcomeLabels = {
@@ -30,6 +31,33 @@ const slackOwnerOutcomes = /* @__PURE__ */ new Set([
 	"budget_warning",
 	"budget_exhausted"
 ]);
+function escapeSlackText(value) {
+	return value.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+function slackLink(url, label) {
+	try {
+		const parsed = new URL(url);
+		if (parsed.protocol !== "https:" && parsed.protocol !== "http:") return null;
+		return `<${escapeSlackText(parsed.toString())}|${escapeSlackText(label)}>`;
+	} catch {
+		return null;
+	}
+}
+/** Resolve an explicit pull-request reference after the repository has been selected. */
+function selectSlackPullRequest(text, repositorySlug) {
+	const escapedSlug = repositorySlug.replace(/[.*+?^${}()|[\]\\]/gu, "\\$&");
+	const references = [...text.matchAll(new RegExp(`https://github\\.com/${escapedSlug}/pull/(\\d+)`, "giu")), ...text.matchAll(/\b(?:pr|pull\s+request)\s*#?\s*(\d+)\b/giu)].flatMap((match) => {
+		const value = Number(match[1]);
+		return Number.isSafeInteger(value) && value > 0 ? [value] : [];
+	});
+	const distinct = [...new Set(references)];
+	if (distinct.length === 0) return { status: "none" };
+	if (distinct.length > 1) return { status: "ambiguous" };
+	return {
+		status: "selected",
+		pullRequestNumber: distinct[0]
+	};
+}
 /** Parse Eve's Slack continuation token into its channel and thread target. */
 function parseSlackReplyAddress(address) {
 	const separator = address.indexOf(":");
@@ -41,20 +69,35 @@ function parseSlackReplyAddress(address) {
 		threadTs
 	};
 }
-/** Render a provider-neutral communication event as plain Slack text. */
+/** Render a provider-neutral communication event as Slack mrkdwn. */
 function renderSlackCommunicationEvent(input) {
 	const event = communicationEventSchema.parse(input);
-	const headline = slackOutcomeLabels[event.outcome];
-	const details = slackDetailFields.flatMap((field) => {
+	const headline = `*${slackOutcomeLabels[event.outcome]}*`;
+	const details = new Map(slackDetailFields.flatMap((field) => {
 		const value = event.data[field];
-		return typeof value === "string" && value.trim() !== "" ? [value.trim()] : [];
-	});
+		return typeof value === "string" && value.trim() !== "" ? [[field, value.trim()]] : [];
+	}));
+	const primaryField = [
+		"title",
+		"question",
+		"requestedAction"
+	].find((field) => details.has(field));
+	const primary = primaryField === void 0 ? void 0 : details.get(primaryField);
+	const url = details.get("url");
+	const linkedPrimary = primary !== void 0 && url !== void 0 ? slackLink(url, primary) : null;
+	if (primaryField !== void 0) details.delete(primaryField);
+	if (linkedPrimary !== null) details.delete("url");
+	const detailLines = [.../* @__PURE__ */ new Set([...linkedPrimary !== null ? [linkedPrimary] : primary === void 0 ? [] : [escapeSlackText(primary)], ...[...details.values()].map(escapeSlackText)])];
 	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()}`] : []);
+		return value.flatMap((item) => typeof item === "string" && item.trim() !== "" ? [`• ${escapeSlackText(item.trim())}`] : []);
 	});
-	const text = [headline, .../* @__PURE__ */ new Set([...details, ...lists])].join("\n");
+	const text = [
+		headline,
+		...detailLines,
+		...lists.length === 0 ? [] : [lists.join("\n")]
+	].join("\n\n");
 	return text.length <= slackTextLimit ? text : `${text.slice(0, 11999)}…`;
 }
 function slackClientMessageId(eventId) {
@@ -110,47 +153,71 @@ function normalizeSlackMessage(event) {
 		payload: event.payload
 	};
 }
-/** Select every explicitly named configured repository, preserving configuration order. */
-function selectSlackRepositories(text, repositories) {
+function escapedPattern(value) {
+	return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+function isDelimitedTextMentioned(text, value) {
+	return new RegExp(`(^|[^a-z0-9._/-])${escapedPattern(value)}($|[^a-z0-9._/-])`, "i").test(text);
+}
+function isRepositoryReferenceMentioned(text, slug) {
+	if (isDelimitedTextMentioned(text, slug)) return true;
+	return new RegExp(`https?://github\\.com/${escapedPattern(slug)}(?:\\.git)?/?(?=$|[\\s?#|>)\\],.!])`, "i").test(text);
+}
+function repositoryName(slug) {
+	return slug.slice(slug.lastIndexOf("/") + 1);
+}
+function resolveSlackRepositoryMentions(text, repositories) {
 	const normalized = [...new Set(repositories.map((slug) => slug.toLowerCase()))];
-	if (normalized.length === 1) return {
+	const entries = normalized.map((slug) => ({
+		slug,
+		name: repositoryName(slug)
+	}));
+	const counts = /* @__PURE__ */ new Map();
+	for (const { name } of entries) counts.set(name, (counts.get(name) ?? 0) + 1);
+	const mentionedNames = new Set([...counts.keys()].filter((name) => isDelimitedTextMentioned(text, name)));
+	const matches = new Set(entries.flatMap(({ slug, name }) => isRepositoryReferenceMentioned(text, slug) || counts.get(name) === 1 && mentionedNames.has(name) ? [slug] : []));
+	const ambiguous = new Set(entries.flatMap(({ slug, name }) => counts.get(name) !== 1 && mentionedNames.has(name) ? [slug] : []));
+	return {
+		repositories: normalized,
+		matches: normalized.filter((slug) => matches.has(slug)),
+		ambiguous: normalized.filter((slug) => ambiguous.has(slug)),
+		candidates: normalized.filter((slug) => matches.has(slug) || ambiguous.has(slug))
+	};
+}
+/** Select every named configured repository, preserving configuration order. */
+function selectSlackRepositories(text, repositories) {
+	const mentions = resolveSlackRepositoryMentions(text, repositories);
+	if (mentions.repositories.length === 1) return {
 		status: "selected",
-		repositorySlugs: [normalized[0]]
+		repositorySlugs: [mentions.repositories[0]]
 	};
-	const matches = normalized.filter((slug) => {
-		const escaped = slug.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
-		return new RegExp(`(^|[^a-z0-9._/-])${escaped}($|[^a-z0-9._/-])`, "i").test(text);
-	});
-	return matches.length === 0 ? { status: "required" } : {
+	if (mentions.ambiguous.length > 0) return { status: "required" };
+	return mentions.matches.length === 0 ? { status: "required" } : {
 		status: "selected",
-		repositorySlugs: [matches[0], ...matches.slice(1)]
+		repositorySlugs: [mentions.matches[0], ...mentions.matches.slice(1)]
 	};
 }
 /**
-* Select the only configured repository, or require an explicit owner/name
-* when a Slack surface fronts more than one repository.
+* Select the only configured repository, or match a full slug, unique short
+* name, or GitHub repository URL when a Slack surface fronts multiple repositories.
 */
 function selectSlackRepository(text, repositories) {
-	const normalized = [...new Set(repositories.map((slug) => slug.toLowerCase()))];
-	if (normalized.length === 1) return {
+	const mentions = resolveSlackRepositoryMentions(text, repositories);
+	if (mentions.repositories.length === 1) return {
 		status: "selected",
-		repositorySlug: normalized[0]
+		repositorySlug: mentions.repositories[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 {
+	if (mentions.candidates.length === 1) return {
 		status: "selected",
-		repositorySlug: matches[0]
+		repositorySlug: mentions.candidates[0]
 	};
-	if (matches.length > 1) return {
+	if (mentions.candidates.length > 1) return {
 		status: "ambiguous",
-		repositorySlugs: matches
+		repositorySlugs: mentions.candidates
 	};
 	return { status: "required" };
 }
 //#endregion
-export { createSlackCommunicationAdapter, normalizeSlackMessage, parseSlackReplyAddress, renderSlackCommunicationEvent, selectSlackRepositories, selectSlackRepository };
+export { createSlackCommunicationAdapter, normalizeSlackMessage, parseSlackReplyAddress, renderSlackCommunicationEvent, selectSlackPullRequest, selectSlackRepositories, 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 { 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  repositorySlugs: readonly [string, ...string[]];\n  payload: unknown;\n}\n\nexport interface SlackMessageSignal extends NormalizedSignal<\"slack\"> {\n  repositorySlugs: readonly [string, ...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 repositories. */\nexport function normalizeSlackMessage(event: SlackMessageEvent): SlackMessageSignal {\n  return {\n    source: \"slack\",\n    deliveryId: `${event.teamId}:${event.channelId}:${event.messageTs}`,\n    repositorySlugs: [\n      event.repositorySlugs[0].toLowerCase(),\n      ...event.repositorySlugs.slice(1).map((slug) => slug.toLowerCase()),\n    ],\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\nexport type SlackRepositoriesSelection =\n  | { status: \"selected\"; repositorySlugs: readonly [string, ...string[]] }\n  | { status: \"required\" };\n\n/** Select every explicitly named configured repository, preserving configuration order. */\nexport function selectSlackRepositories(\n  text: string,\n  repositories: readonly string[],\n): SlackRepositoriesSelection {\n  const normalized = [...new Set(repositories.map((slug) => slug.toLowerCase()))];\n  if (normalized.length === 1) {\n    return { status: \"selected\", repositorySlugs: [normalized[0]!] };\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  return matches.length === 0\n    ? { status: \"required\" }\n    : { status: \"selected\", repositorySlugs: [matches[0]!, ...matches.slice(1)] };\n}\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":"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"}
+{"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\nfunction escapeSlackText(value: string): string {\n  return value.replaceAll(\"&\", \"&amp;\").replaceAll(\"<\", \"&lt;\").replaceAll(\">\", \"&gt;\");\n}\n\nfunction slackLink(url: string, label: string): string | null {\n  try {\n    const parsed = new URL(url);\n    if (parsed.protocol !== \"https:\" && parsed.protocol !== \"http:\") return null;\n    return `<${escapeSlackText(parsed.toString())}|${escapeSlackText(label)}>`;\n  } catch {\n    return null;\n  }\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\nexport type SlackPullRequestSelection =\n  | { status: \"none\" }\n  | { status: \"ambiguous\" }\n  | { status: \"selected\"; pullRequestNumber: number };\n\n/** Resolve an explicit pull-request reference after the repository has been selected. */\nexport function selectSlackPullRequest(\n  text: string,\n  repositorySlug: string,\n): SlackPullRequestSelection {\n  const escapedSlug = repositorySlug.replace(/[.*+?^${}()|[\\]\\\\]/gu, \"\\\\$&\");\n  const references = [\n    ...text.matchAll(new RegExp(`https://github\\\\.com/${escapedSlug}/pull/(\\\\d+)`, \"giu\")),\n    ...text.matchAll(/\\b(?:pr|pull\\s+request)\\s*#?\\s*(\\d+)\\b/giu),\n  ].flatMap((match) => {\n    const value = Number(match[1]);\n    return Number.isSafeInteger(value) && value > 0 ? [value] : [];\n  });\n  const distinct = [...new Set(references)];\n  if (distinct.length === 0) return { status: \"none\" };\n  if (distinct.length > 1) return { status: \"ambiguous\" };\n  return { status: \"selected\", pullRequestNumber: distinct[0]! };\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 Slack mrkdwn. */\nexport function renderSlackCommunicationEvent(input: CommunicationEvent): string {\n  const event = communicationEventSchema.parse(input);\n  const headline = `*${slackOutcomeLabels[event.outcome]}*`;\n  const details = new Map(slackDetailFields.flatMap((field) => {\n    const value = event.data[field];\n    return typeof value === \"string\" && value.trim() !== \"\" ? [[field, value.trim()] as const] : [];\n  }));\n  const primaryField = ([\"title\", \"question\", \"requestedAction\"] as const)\n    .find((field) => details.has(field));\n  const primary = primaryField === undefined ? undefined : details.get(primaryField);\n  const url = details.get(\"url\");\n  const linkedPrimary = primary !== undefined && url !== undefined ? slackLink(url, primary) : null;\n  if (primaryField !== undefined) details.delete(primaryField);\n  if (linkedPrimary !== null) details.delete(\"url\");\n\n  const detailLines = [...new Set([\n    ...(linkedPrimary !== null ? [linkedPrimary] : primary === undefined ? [] : [escapeSlackText(primary)]),\n    ...[...details.values()].map(escapeSlackText),\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() !== \"\" ? [`• ${escapeSlackText(item.trim())}`] : []\n    );\n  });\n  const text = [headline, ...detailLines, ...(lists.length === 0 ? [] : [lists.join(\"\\n\")])]\n    .join(\"\\n\\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  repositorySlugs: readonly [string, ...string[]];\n  payload: unknown;\n}\n\nexport interface SlackMessageSignal extends NormalizedSignal<\"slack\"> {\n  repositorySlugs: readonly [string, ...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 repositories. */\nexport function normalizeSlackMessage(event: SlackMessageEvent): SlackMessageSignal {\n  return {\n    source: \"slack\",\n    deliveryId: `${event.teamId}:${event.channelId}:${event.messageTs}`,\n    repositorySlugs: [\n      event.repositorySlugs[0].toLowerCase(),\n      ...event.repositorySlugs.slice(1).map((slug) => slug.toLowerCase()),\n    ],\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\nexport type SlackRepositoriesSelection =\n  | { status: \"selected\"; repositorySlugs: readonly [string, ...string[]] }\n  | { status: \"required\" };\n\nfunction escapedPattern(value: string): string {\n  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n}\n\nfunction isDelimitedTextMentioned(text: string, value: string): boolean {\n  return new RegExp(\n    `(^|[^a-z0-9._/-])${escapedPattern(value)}($|[^a-z0-9._/-])`,\n    \"i\",\n  ).test(text);\n}\n\nfunction isRepositoryReferenceMentioned(text: string, slug: string): boolean {\n  if (isDelimitedTextMentioned(text, slug)) return true;\n  return new RegExp(\n    `https?://github\\\\.com/${escapedPattern(slug)}(?:\\\\.git)?/?(?=$|[\\\\s?#|>)\\\\],.!])`,\n    \"i\",\n  ).test(text);\n}\n\nfunction repositoryName(slug: string): string {\n  return slug.slice(slug.lastIndexOf(\"/\") + 1);\n}\n\ninterface SlackRepositoryMentions {\n  repositories: readonly string[];\n  matches: readonly string[];\n  ambiguous: readonly string[];\n  candidates: readonly string[];\n}\n\nfunction resolveSlackRepositoryMentions(\n  text: string,\n  repositories: readonly string[],\n): SlackRepositoryMentions {\n  const normalized = [...new Set(repositories.map((slug) => slug.toLowerCase()))];\n  const entries = normalized.map((slug) => ({ slug, name: repositoryName(slug) }));\n  const counts = new Map<string, number>();\n  for (const { name } of entries) {\n    counts.set(name, (counts.get(name) ?? 0) + 1);\n  }\n  const mentionedNames = new Set(\n    [...counts.keys()].filter((name) => isDelimitedTextMentioned(text, name)),\n  );\n  const matches = new Set(entries.flatMap(({ slug, name }) =>\n    isRepositoryReferenceMentioned(text, slug) || (\n      counts.get(name) === 1 && mentionedNames.has(name)\n    )\n      ? [slug]\n      : []\n  ));\n  const ambiguous = new Set(entries.flatMap(({ slug, name }) =>\n    counts.get(name) !== 1 && mentionedNames.has(name) ? [slug] : []\n  ));\n\n  return {\n    repositories: normalized,\n    matches: normalized.filter((slug) => matches.has(slug)),\n    ambiguous: normalized.filter((slug) => ambiguous.has(slug)),\n    candidates: normalized.filter((slug) => matches.has(slug) || ambiguous.has(slug)),\n  };\n}\n\n/** Select every named configured repository, preserving configuration order. */\nexport function selectSlackRepositories(\n  text: string,\n  repositories: readonly string[],\n): SlackRepositoriesSelection {\n  const mentions = resolveSlackRepositoryMentions(text, repositories);\n  if (mentions.repositories.length === 1) {\n    return { status: \"selected\", repositorySlugs: [mentions.repositories[0]!] };\n  }\n  if (mentions.ambiguous.length > 0) return { status: \"required\" };\n  return mentions.matches.length === 0\n    ? { status: \"required\" }\n    : {\n        status: \"selected\",\n        repositorySlugs: [mentions.matches[0]!, ...mentions.matches.slice(1)],\n      };\n}\n\n/**\n * Select the only configured repository, or match a full slug, unique short\n * name, or GitHub repository URL when a Slack surface fronts multiple repositories.\n */\nexport function selectSlackRepository(\n  text: string,\n  repositories: readonly string[],\n): SlackRepositorySelection {\n  const mentions = resolveSlackRepositoryMentions(text, repositories);\n  if (mentions.repositories.length === 1) {\n    return { status: \"selected\", repositorySlug: mentions.repositories[0]! };\n  }\n  if (mentions.candidates.length === 1) {\n    return { status: \"selected\", repositorySlug: mentions.candidates[0]! };\n  }\n  if (mentions.candidates.length > 1) {\n    return { status: \"ambiguous\", repositorySlugs: mentions.candidates };\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;AAED,SAAS,gBAAgB,OAAuB;CAC9C,OAAO,MAAM,WAAW,KAAK,OAAO,CAAC,CAAC,WAAW,KAAK,MAAM,CAAC,CAAC,WAAW,KAAK,MAAM;AACtF;AAEA,SAAS,UAAU,KAAa,OAA8B;CAC5D,IAAI;EACF,MAAM,SAAS,IAAI,IAAI,GAAG;EAC1B,IAAI,OAAO,aAAa,YAAY,OAAO,aAAa,SAAS,OAAO;EACxE,OAAO,IAAI,gBAAgB,OAAO,SAAS,CAAC,EAAE,GAAG,gBAAgB,KAAK,EAAE;CAC1E,QAAQ;EACN,OAAO;CACT;AACF;;AAgCA,SAAgB,uBACd,MACA,gBAC2B;CAC3B,MAAM,cAAc,eAAe,QAAQ,wBAAwB,MAAM;CACzE,MAAM,aAAa,CACjB,GAAG,KAAK,SAAS,IAAI,OAAO,wBAAwB,YAAY,eAAe,KAAK,CAAC,GACrF,GAAG,KAAK,SAAS,2CAA2C,CAC9D,CAAC,CAAC,SAAS,UAAU;EACnB,MAAM,QAAQ,OAAO,MAAM,EAAE;EAC7B,OAAO,OAAO,cAAc,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,IAAI,CAAC;CAC/D,CAAC;CACD,MAAM,WAAW,CAAC,GAAG,IAAI,IAAI,UAAU,CAAC;CACxC,IAAI,SAAS,WAAW,GAAG,OAAO,EAAE,QAAQ,OAAO;CACnD,IAAI,SAAS,SAAS,GAAG,OAAO,EAAE,QAAQ,YAAY;CACtD,OAAO;EAAE,QAAQ;EAAY,mBAAmB,SAAS;CAAI;AAC/D;;AAGA,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,IAAI,mBAAmB,MAAM,SAAS;CACvD,MAAM,UAAU,IAAI,IAAI,kBAAkB,SAAS,UAAU;EAC3D,MAAM,QAAQ,MAAM,KAAK;EACzB,OAAO,OAAO,UAAU,YAAY,MAAM,KAAK,MAAM,KAAK,CAAC,CAAC,OAAO,MAAM,KAAK,CAAC,CAAU,IAAI,CAAC;CAChG,CAAC,CAAC;CACF,MAAM,eAAgB;EAAC;EAAS;EAAY;CAAiB,CAAC,CAC3D,MAAM,UAAU,QAAQ,IAAI,KAAK,CAAC;CACrC,MAAM,UAAU,iBAAiB,KAAA,IAAY,KAAA,IAAY,QAAQ,IAAI,YAAY;CACjF,MAAM,MAAM,QAAQ,IAAI,KAAK;CAC7B,MAAM,gBAAgB,YAAY,KAAA,KAAa,QAAQ,KAAA,IAAY,UAAU,KAAK,OAAO,IAAI;CAC7F,IAAI,iBAAiB,KAAA,GAAW,QAAQ,OAAO,YAAY;CAC3D,IAAI,kBAAkB,MAAM,QAAQ,OAAO,KAAK;CAEhD,MAAM,cAAc,CAAC,mBAAG,IAAI,IAAI,CAC9B,GAAI,kBAAkB,OAAO,CAAC,aAAa,IAAI,YAAY,KAAA,IAAY,CAAC,IAAI,CAAC,gBAAgB,OAAO,CAAC,GACrG,GAAG,CAAC,GAAG,QAAQ,OAAO,CAAC,CAAC,CAAC,IAAI,eAAe,CAC9C,CAAC,CAAC;CACF,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,gBAAgB,KAAK,KAAK,CAAC,GAAG,IAAI,CAAC,CAC5F;CACF,CAAC;CACD,MAAM,OAAO;EAAC;EAAU,GAAG;EAAa,GAAI,MAAM,WAAW,IAAI,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC;CAAE,CAAC,CACvF,KAAK,MAAM;CACd,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,iBAAiB,CACf,MAAM,gBAAgB,EAAE,CAAC,YAAY,GACrC,GAAG,MAAM,gBAAgB,MAAM,CAAC,CAAC,CAAC,KAAK,SAAS,KAAK,YAAY,CAAC,CACpE;EACA,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,SAAS,eAAe,OAAuB;CAC7C,OAAO,MAAM,QAAQ,uBAAuB,MAAM;AACpD;AAEA,SAAS,yBAAyB,MAAc,OAAwB;CACtE,OAAO,IAAI,OACT,oBAAoB,eAAe,KAAK,EAAE,oBAC1C,GACF,CAAC,CAAC,KAAK,IAAI;AACb;AAEA,SAAS,+BAA+B,MAAc,MAAuB;CAC3E,IAAI,yBAAyB,MAAM,IAAI,GAAG,OAAO;CACjD,OAAO,IAAI,OACT,yBAAyB,eAAe,IAAI,EAAE,sCAC9C,GACF,CAAC,CAAC,KAAK,IAAI;AACb;AAEA,SAAS,eAAe,MAAsB;CAC5C,OAAO,KAAK,MAAM,KAAK,YAAY,GAAG,IAAI,CAAC;AAC7C;AASA,SAAS,+BACP,MACA,cACyB;CACzB,MAAM,aAAa,CAAC,GAAG,IAAI,IAAI,aAAa,KAAK,SAAS,KAAK,YAAY,CAAC,CAAC,CAAC;CAC9E,MAAM,UAAU,WAAW,KAAK,UAAU;EAAE;EAAM,MAAM,eAAe,IAAI;CAAE,EAAE;CAC/E,MAAM,yBAAS,IAAI,IAAoB;CACvC,KAAK,MAAM,EAAE,UAAU,SACrB,OAAO,IAAI,OAAO,OAAO,IAAI,IAAI,KAAK,KAAK,CAAC;CAE9C,MAAM,iBAAiB,IAAI,IACzB,CAAC,GAAG,OAAO,KAAK,CAAC,CAAC,CAAC,QAAQ,SAAS,yBAAyB,MAAM,IAAI,CAAC,CAC1E;CACA,MAAM,UAAU,IAAI,IAAI,QAAQ,SAAS,EAAE,MAAM,WAC/C,+BAA+B,MAAM,IAAI,KACvC,OAAO,IAAI,IAAI,MAAM,KAAK,eAAe,IAAI,IAAI,IAE/C,CAAC,IAAI,IACL,CAAC,CACP,CAAC;CACD,MAAM,YAAY,IAAI,IAAI,QAAQ,SAAS,EAAE,MAAM,WACjD,OAAO,IAAI,IAAI,MAAM,KAAK,eAAe,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,CAAC,CACjE,CAAC;CAED,OAAO;EACL,cAAc;EACd,SAAS,WAAW,QAAQ,SAAS,QAAQ,IAAI,IAAI,CAAC;EACtD,WAAW,WAAW,QAAQ,SAAS,UAAU,IAAI,IAAI,CAAC;EAC1D,YAAY,WAAW,QAAQ,SAAS,QAAQ,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,CAAC;CAClF;AACF;;AAGA,SAAgB,wBACd,MACA,cAC4B;CAC5B,MAAM,WAAW,+BAA+B,MAAM,YAAY;CAClE,IAAI,SAAS,aAAa,WAAW,GACnC,OAAO;EAAE,QAAQ;EAAY,iBAAiB,CAAC,SAAS,aAAa,EAAG;CAAE;CAE5E,IAAI,SAAS,UAAU,SAAS,GAAG,OAAO,EAAE,QAAQ,WAAW;CAC/D,OAAO,SAAS,QAAQ,WAAW,IAC/B,EAAE,QAAQ,WAAW,IACrB;EACE,QAAQ;EACR,iBAAiB,CAAC,SAAS,QAAQ,IAAK,GAAG,SAAS,QAAQ,MAAM,CAAC,CAAC;CACtE;AACN;;;;;AAMA,SAAgB,sBACd,MACA,cAC0B;CAC1B,MAAM,WAAW,+BAA+B,MAAM,YAAY;CAClE,IAAI,SAAS,aAAa,WAAW,GACnC,OAAO;EAAE,QAAQ;EAAY,gBAAgB,SAAS,aAAa;CAAI;CAEzE,IAAI,SAAS,WAAW,WAAW,GACjC,OAAO;EAAE,QAAQ;EAAY,gBAAgB,SAAS,WAAW;CAAI;CAEvE,IAAI,SAAS,WAAW,SAAS,GAC/B,OAAO;EAAE,QAAQ;EAAa,iBAAiB,SAAS;CAAW;CAErE,OAAO,EAAE,QAAQ,WAAW;AAC9B"}

package/dist/coordination-Cq08hb1l.mjs

@@ -0,0 +1,76 @@
+import { n as RecordNotFoundError } from "./driver-Bbd25rNM.mjs";
+//#region src/coordination.ts
+/** Create one non-executable parent and one independently executable child per repository. */
+async function createCoordination(stores, input) {
+	const repositoryIds = [...new Set(input.repositoryIds)];
+	if (repositoryIds.length < 2) throw new Error("coordination requires at least two distinct repositories");
+	const parent = await stores.tasks.create({
+		repositoryIds,
+		kind: "coordination",
+		origin: input.signalId === void 0 ? { operator: input.operator } : { signalId: input.signalId },
+		replyTo: input.replyTo,
+		dedupeKey: input.dedupeKey
+	});
+	return {
+		parent: parent.state === "queued" ? await stores.tasks.transition(parent.id, "running", { reason: "repository-scoped child tasks created" }) : parent,
+		children: await Promise.all(repositoryIds.map((repositoryId) => stores.tasks.create({
+			repositoryIds: [repositoryId],
+			kind: "code_change",
+			origin: { parentTaskId: parent.id },
+			replyTo: input.replyTo,
+			dedupeKey: input.dedupeKey === void 0 ? void 0 : `${input.dedupeKey}:${repositoryId}`
+		})))
+	};
+}
+/** Reconcile a coordination parent from its direct children without ever dispatching the parent. */
+async function reconcileCoordination(stores, parentTaskId, options) {
+	const parent = await stores.tasks.get(parentTaskId);
+	if (parent === null) throw new RecordNotFoundError("tasks", parentTaskId);
+	if (parent.kind !== "coordination") throw new Error(`task ${parentTaskId} is ${parent.kind}, not coordination`);
+	const children = (await stores.tasks.list()).filter((task) => task.origin.parentTaskId === parentTaskId);
+	if (children.length !== parent.repositoryIds.length) return {
+		status: "pending",
+		parent,
+		children
+	};
+	if (parent.state === "succeeded" || parent.state === "failed") return {
+		status: parent.state,
+		transitioned: false,
+		parent,
+		children
+	};
+	if (children.some((child) => child.state === "failed" || child.state === "cancelled")) {
+		await options.present({
+			status: "failed",
+			parent,
+			children
+		});
+		return {
+			status: "failed",
+			transitioned: true,
+			parent: await stores.tasks.transition(parent.id, "failed", { reason: "one or more repository tasks failed" }),
+			children
+		};
+	}
+	if (!children.every((child) => child.state === "succeeded")) return {
+		status: "pending",
+		parent,
+		children
+	};
+	await options.present({
+		status: "succeeded",
+		parent,
+		children
+	});
+	await stores.tasks.transition(parent.id, "verifying", { reason: "all repository tasks succeeded" });
+	return {
+		status: "succeeded",
+		transitioned: true,
+		parent: await stores.tasks.transition(parent.id, "succeeded", { reason: "aggregate multi-repository handoff is ready" }),
+		children
+	};
+}
+//#endregion
+export { reconcileCoordination as n, createCoordination as t };
+
+//# sourceMappingURL=coordination-Cq08hb1l.mjs.map

package/dist/coordination-Cq08hb1l.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"coordination-Cq08hb1l.mjs","names":[],"sources":["../src/coordination.ts"],"sourcesContent":["import type { ReplyTo } from \"./schema/common\";\nimport type { RepositoryId, SignalId, TaskId } from \"./schema/id\";\nimport type { Task } from \"./schema/task\";\nimport { RecordNotFoundError } from \"./store/driver\";\nimport type { FactoryStores } from \"./store/engine\";\n\ninterface CreateCoordinationInputBase {\n  repositoryIds: readonly [RepositoryId, RepositoryId, ...RepositoryId[]];\n  replyTo: ReplyTo;\n  /** Same key recreates neither the parent nor its repository-scoped children. */\n  dedupeKey?: string;\n}\n\nexport type CreateCoordinationInput = CreateCoordinationInputBase &\n  ({ signalId: SignalId; operator?: never } | { operator: string; signalId?: never });\n\nexport interface CoordinationPlan {\n  parent: Task;\n  children: readonly Task[];\n}\n\nexport type CoordinationReconciliation =\n  | { status: \"pending\"; parent: Task; children: readonly Task[] }\n  | { status: \"succeeded\" | \"failed\"; transitioned: boolean; parent: Task; children: readonly Task[] };\n\nexport interface ReconcileCoordinationOptions {\n  present(input: {\n    status: \"succeeded\" | \"failed\";\n    parent: Task;\n    children: readonly Task[];\n  }): Promise<void>;\n}\n\n/** Create one non-executable parent and one independently executable child per repository. */\nexport async function createCoordination(\n  stores: FactoryStores,\n  input: CreateCoordinationInput,\n): Promise<CoordinationPlan> {\n  const repositoryIds = [...new Set(input.repositoryIds)];\n  if (repositoryIds.length < 2) {\n    throw new Error(\"coordination requires at least two distinct repositories\");\n  }\n  const parent = await stores.tasks.create({\n    repositoryIds,\n    kind: \"coordination\",\n    origin: input.signalId === undefined ? { operator: input.operator } : { signalId: input.signalId },\n    replyTo: input.replyTo,\n    dedupeKey: input.dedupeKey,\n  });\n  const running = parent.state === \"queued\"\n    ? await stores.tasks.transition(parent.id, \"running\", {\n        reason: \"repository-scoped child tasks created\",\n      })\n    : parent;\n  const children = await Promise.all(\n    repositoryIds.map((repositoryId) =>\n      stores.tasks.create({\n        repositoryIds: [repositoryId],\n        kind: \"code_change\",\n        origin: { parentTaskId: parent.id },\n        replyTo: input.replyTo,\n        dedupeKey: input.dedupeKey === undefined ? undefined : `${input.dedupeKey}:${repositoryId}`,\n      }),\n    ),\n  );\n  return { parent: running, children };\n}\n\n/** Reconcile a coordination parent from its direct children without ever dispatching the parent. */\nexport async function reconcileCoordination(\n  stores: FactoryStores,\n  parentTaskId: TaskId,\n  options: ReconcileCoordinationOptions,\n): Promise<CoordinationReconciliation> {\n  const parent = await stores.tasks.get(parentTaskId);\n  if (parent === null) throw new RecordNotFoundError(\"tasks\", parentTaskId);\n  if (parent.kind !== \"coordination\") {\n    throw new Error(`task ${parentTaskId} is ${parent.kind}, not coordination`);\n  }\n  const children = (await stores.tasks.list()).filter(\n    (task) => task.origin.parentTaskId === parentTaskId,\n  );\n  if (children.length !== parent.repositoryIds.length) {\n    return { status: \"pending\", parent, children };\n  }\n  if (parent.state === \"succeeded\" || parent.state === \"failed\") {\n    return { status: parent.state, transitioned: false, parent, children };\n  }\n  if (children.some((child) => child.state === \"failed\" || child.state === \"cancelled\")) {\n    await options.present({ status: \"failed\", parent, children });\n    const failed = await stores.tasks.transition(parent.id, \"failed\", {\n      reason: \"one or more repository tasks failed\",\n    });\n    return { status: \"failed\", transitioned: true, parent: failed, children };\n  }\n  if (!children.every((child) => child.state === \"succeeded\")) {\n    return { status: \"pending\", parent, children };\n  }\n  await options.present({ status: \"succeeded\", parent, children });\n  await stores.tasks.transition(parent.id, \"verifying\", {\n    reason: \"all repository tasks succeeded\",\n  });\n  const succeeded = await stores.tasks.transition(parent.id, \"succeeded\", {\n    reason: \"aggregate multi-repository handoff is ready\",\n  });\n  return { status: \"succeeded\", transitioned: true, parent: succeeded, children };\n}\n"],"mappings":";;;AAkCA,eAAsB,mBACpB,QACA,OAC2B;CAC3B,MAAM,gBAAgB,CAAC,GAAG,IAAI,IAAI,MAAM,aAAa,CAAC;CACtD,IAAI,cAAc,SAAS,GACzB,MAAM,IAAI,MAAM,0DAA0D;CAE5E,MAAM,SAAS,MAAM,OAAO,MAAM,OAAO;EACvC;EACA,MAAM;EACN,QAAQ,MAAM,aAAa,KAAA,IAAY,EAAE,UAAU,MAAM,SAAS,IAAI,EAAE,UAAU,MAAM,SAAS;EACjG,SAAS,MAAM;EACf,WAAW,MAAM;CACnB,CAAC;CAiBD,OAAO;EAAE,QAhBO,OAAO,UAAU,WAC7B,MAAM,OAAO,MAAM,WAAW,OAAO,IAAI,WAAW,EAClD,QAAQ,wCACV,CAAC,IACD;EAYsB,UAAA,MAXH,QAAQ,IAC7B,cAAc,KAAK,iBACjB,OAAO,MAAM,OAAO;GAClB,eAAe,CAAC,YAAY;GAC5B,MAAM;GACN,QAAQ,EAAE,cAAc,OAAO,GAAG;GAClC,SAAS,MAAM;GACf,WAAW,MAAM,cAAc,KAAA,IAAY,KAAA,IAAY,GAAG,MAAM,UAAU,GAAG;EAC/E,CAAC,CACH,CACF;CACmC;AACrC;;AAGA,eAAsB,sBACpB,QACA,cACA,SACqC;CACrC,MAAM,SAAS,MAAM,OAAO,MAAM,IAAI,YAAY;CAClD,IAAI,WAAW,MAAM,MAAM,IAAI,oBAAoB,SAAS,YAAY;CACxE,IAAI,OAAO,SAAS,gBAClB,MAAM,IAAI,MAAM,QAAQ,aAAa,MAAM,OAAO,KAAK,mBAAmB;CAE5E,MAAM,YAAY,MAAM,OAAO,MAAM,KAAK,EAAA,CAAG,QAC1C,SAAS,KAAK,OAAO,iBAAiB,YACzC;CACA,IAAI,SAAS,WAAW,OAAO,cAAc,QAC3C,OAAO;EAAE,QAAQ;EAAW;EAAQ;CAAS;CAE/C,IAAI,OAAO,UAAU,eAAe,OAAO,UAAU,UACnD,OAAO;EAAE,QAAQ,OAAO;EAAO,cAAc;EAAO;EAAQ;CAAS;CAEvE,IAAI,SAAS,MAAM,UAAU,MAAM,UAAU,YAAY,MAAM,UAAU,WAAW,GAAG;EACrF,MAAM,QAAQ,QAAQ;GAAE,QAAQ;GAAU;GAAQ;EAAS,CAAC;EAI5D,OAAO;GAAE,QAAQ;GAAU,cAAc;GAAM,QAAQ,MAHlC,OAAO,MAAM,WAAW,OAAO,IAAI,UAAU,EAChE,QAAQ,sCACV,CAAC;GAC8D;EAAS;CAC1E;CACA,IAAI,CAAC,SAAS,OAAO,UAAU,MAAM,UAAU,WAAW,GACxD,OAAO;EAAE,QAAQ;EAAW;EAAQ;CAAS;CAE/C,MAAM,QAAQ,QAAQ;EAAE,QAAQ;EAAa;EAAQ;CAAS,CAAC;CAC/D,MAAM,OAAO,MAAM,WAAW,OAAO,IAAI,aAAa,EACpD,QAAQ,iCACV,CAAC;CAID,OAAO;EAAE,QAAQ;EAAa,cAAc;EAAM,QAAQ,MAHlC,OAAO,MAAM,WAAW,OAAO,IAAI,aAAa,EACtE,QAAQ,8CACV,CAAC;EACoE;CAAS;AAChF"}

package/dist/dispatch-BaZS3PT8.d.mts

@@ -0,0 +1,76 @@
+import { Tt as Task, Yt as TaskId, h as FactoryStores, on as BudgetLimits, wt as ExecutionReference } from "./engine-DFHU2Pe-.mjs";
+import { z } from "zod";
+//#region src/agent-routes.d.ts
+declare const agentRouteSchema: z.ZodObject<{
+  id: z.ZodString;
+  agent: z.ZodString;
+  taskKind: z.ZodString;
+  description: z.ZodString;
+  permissions: z.ZodDefault<z.ZodArray<z.ZodString>>;
+}, z.core.$strict>;
+type AgentRoute = z.infer<typeof agentRouteSchema>;
+type AgentRouteInput = z.input<typeof agentRouteSchema>;
+interface AgentRouteRegistry {
+  readonly routes: readonly AgentRoute[];
+  get(id: string): AgentRoute | undefined;
+  forTaskKind(kind: string): AgentRoute | undefined;
+}
+/**
+ * Define the application-owned routes an agent or workflow may select. Route
+ * descriptions inform judgment; this validated registry remains the authority.
+ */
+declare function defineAgentRoutes(inputs: readonly AgentRouteInput[]): AgentRouteRegistry;
+//#endregion
+//#region src/dispatch.d.ts
+declare class DispatchRefusedError extends Error {
+  readonly taskId: TaskId;
+  readonly reason: string;
+  constructor(taskId: TaskId, reason: string);
+}
+/**
+ * An exhausted budget is definitive, not a retryable refusal: the task has
+ * already been failed and receipted when this throws, so it never re-enters
+ * the sweep. Operator retry recovers it once budget frees up.
+ */
+declare class BudgetExhaustedError extends Error {
+  readonly taskId: TaskId;
+  readonly month: string;
+  readonly spendUsd: number;
+  constructor(taskId: TaskId, month: string, spendUsd: number);
+}
+interface DispatchBudget {
+  limits: Pick<BudgetLimits, "totalUsd" | "perTaskReservationUsd">;
+  /** Defaults to the current UTC month. */
+  month?: string;
+  now?: () => Date;
+}
+interface DispatchOptions {
+  /**
+   * Starts the durable execution for the task (an Eve agent run). Runs after
+   * the task has won the queued -> running transition. Returning the
+   * provider's execution reference records it on the task so the reconciler
+   * can find the run; returning nothing leaves the task reachable only by the
+   * stall window.
+   */
+  launch: (task: Task) => Promise<ExecutionReference | void>;
+  /** How many launches to try before the task fails for good; a failure re-queues for the next sweep. */
+  maxLaunchAttempts?: number;
+  /**
+   * Reserve-before-execution. When set, dispatch refuses definitively once
+   * the month's derived spend cannot fit another reservation, and otherwise
+   * stamps the reservation in the same write that wins queued -> running.
+   */
+  budget?: DispatchBudget;
+}
+declare const DEFAULT_MAX_LAUNCH_ATTEMPTS = 45;
+/**
+ * The handshake between recorded work and execution: win the store-gated
+ * transition (at most one dispatcher can succeed), then start the run. A
+ * launch failure re-queues the task (bumping its attempt) until the attempt
+ * limit, then fails it; a crash between the transition and the launch leaves
+ * a running task with no execution, which the sweep reaps.
+ */
+declare function dispatchTask(stores: FactoryStores, taskId: TaskId, options: DispatchOptions): Promise<Task>;
+//#endregion
+export { DispatchRefusedError as a, AgentRouteInput as c, defineAgentRoutes as d, DispatchOptions as i, AgentRouteRegistry as l, DEFAULT_MAX_LAUNCH_ATTEMPTS as n, dispatchTask as o, DispatchBudget as r, AgentRoute as s, BudgetExhaustedError as t, agentRouteSchema as u };
+//# sourceMappingURL=dispatch-BaZS3PT8.d.mts.map

package/dist/{driver-CrZsy7sm.d.mts → driver-BC0Mt5KG.d.mts}

@@ -1,5 +1,5 @@
 //#region src/store/driver.d.ts
-type CollectionName = "repositories" | "signals" | "tasks" | "changes" | "receipts";
+type CollectionName = "repositories" | "signals" | "tasks" | "changes" | "receipts" | "budgets" | "answers" | "sessions" | "outboxQueues" | "outboxDeliveries";
 interface StoredRecord {
   readonly value: unknown;
   readonly version: number;
@@ -31,4 +31,4 @@ interface StoreDriver {
 }
 //#endregion
 export { StoredEntry as a, StoreDriver as i, RecordExistsError as n, StoredRecord as o, RecordNotFoundError as r, VersionConflictError as s, CollectionName as t };
-//# sourceMappingURL=driver-CrZsy7sm.d.mts.map
+//# sourceMappingURL=driver-BC0Mt5KG.d.mts.map