@vercel/factory 0.0.13 → 0.0.15

package/dist/connectors/index.mjs

@@ -1,29 +1,7 @@
-import { a as repositoryIdsSchema, s as taskIdSchema, t as changeIdSchema, u as replyToSchema } from "../id-DwCihQr4.mjs";
-import { z } from "zod";
+import { communicationEventSchema, communicationOutcomeSchema, communicationOutcomes } from "../schema/communication.mjs";
+import { createOutboxCommunicationRouter, sweepCommunicationOutbox } from "./outbox.mjs";
 //#region src/connectors/index.ts
-const communicationOutcomes = [
-	"accepted",
-	"started",
-	"succeeded",
-	"failed",
-	"needs_human",
-	"question",
-	"digest",
-	"rolled_back",
-	"budget_warning",
-	"budget_exhausted",
-	"message"
-];
-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.")
-});
+/** Create a channel router that rejects duplicate registrations and unsupported destinations. */
 function createCommunicationRouter(adapters) {
 	const byChannel = /* @__PURE__ */ new Map();
 	for (const adapter of adapters) {
@@ -44,6 +22,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/index.ts"],"sourcesContent":["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\n/** An authenticated provider webhook envelope before connector-specific normalization. */\nexport interface WebhookEvent {\n  deliveryId: string;\n  event: string;\n  payload: unknown;\n}\n\n/** Connector-neutral signal data ready for admission into Factory. */\nexport interface NormalizedSignal<TSource extends SignalSource = SignalSource> {\n  source: TSource;\n  deliveryId: string;\n  replyTo: ReplyTo;\n  payload: unknown;\n}\n\n/** Converts a verified webhook into a Factory signal or deliberately ignores it. */\nexport type SignalNormalizer<TSignal extends NormalizedSignal = NormalizedSignal> = (\n  event: WebhookEvent,\n) => TSignal | null;\n\n/** Delivers communication events for one provider channel. */\nexport interface CommunicationAdapter {\n  readonly channel: string;\n  deliver(event: CommunicationEvent): Promise<void>;\n}\n\n/** Routes validated communication events to adapters by reply channel. */\nexport interface CommunicationRouter {\n  readonly channels: readonly string[];\n  deliver(event: CommunicationEvent): Promise<void>;\n}\n\n/** Create a channel router that rejects duplicate registrations and unsupported destinations. */\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 {\n  createOutboxCommunicationRouter,\n  sweepCommunicationOutbox,\n  type CommunicationOutboxStores,\n  type CreateOutboxCommunicationRouterOptions,\n  type OutboxDeliveryOptions,\n  type OutboxSweepResult,\n  type SweepCommunicationOutboxOptions,\n} from \"./outbox\";\n"],"mappings":";;;;AA6CA,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/outbox.d.mts

@@ -0,0 +1,34 @@
+import { FactoryStores } from "../store/engine.mjs";
+import { CommunicationRouter } from "./index.mjs";
+//#region src/connectors/outbox.d.ts
+/** Store capability required for durable communication delivery. */
+type CommunicationOutboxStores = Pick<FactoryStores, "outbox">;
+/** Counts delivered, rescheduled, and no-longer-claimable messages from an outbox sweep. */
+interface OutboxSweepResult {
+  delivered: number;
+  retried: number;
+  skipped: number;
+}
+/** Configures outbox claim duration, batch size, and retry scheduling. */
+interface OutboxDeliveryOptions {
+  readonly leaseMs?: number;
+  readonly limit?: number;
+  readonly retryDelayMs?: (attempt: number) => number;
+}
+/** Stores, router, and delivery bounds supplied to one outbox sweep. */
+interface SweepCommunicationOutboxOptions extends OutboxDeliveryOptions {
+  readonly stores: CommunicationOutboxStores;
+  readonly router: CommunicationRouter;
+}
+/** Stores, router, and delivery bounds used to construct a durable router. */
+interface CreateOutboxCommunicationRouterOptions extends OutboxDeliveryOptions {
+  readonly stores: CommunicationOutboxStores;
+  readonly router: CommunicationRouter;
+}
+/** Deliver one bounded batch of pending communication events with durable retry state. */
+declare function sweepCommunicationOutbox(options: SweepCommunicationOutboxOptions): Promise<OutboxSweepResult>;
+/** Wrap a communication router so every delivery is durably enqueued before it is attempted. */
+declare function createOutboxCommunicationRouter(options: CreateOutboxCommunicationRouterOptions): CommunicationRouter;
+//#endregion
+export { CommunicationOutboxStores, CreateOutboxCommunicationRouterOptions, OutboxDeliveryOptions, OutboxSweepResult, SweepCommunicationOutboxOptions, createOutboxCommunicationRouter, sweepCommunicationOutbox };
+//# sourceMappingURL=outbox.d.mts.map

package/dist/connectors/outbox.mjs

@@ -0,0 +1,50 @@
+import { redactedErrorMessage } from "../errors.mjs";
+//#region src/connectors/outbox.ts
+const defaultRetryDelayMs = (attempt) => Math.min(6e4 * 2 ** Math.max(0, attempt - 1), 36e5);
+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, {
+			attempt: claimed.attempt,
+			reason: redactedErrorMessage(error, [], "Unknown communication delivery error"),
+			delayMs: delay
+		}) === null ? "skipped" : "retried";
+	}
+}
+/** Deliver one bounded batch of pending communication events with durable retry state. */
+async function sweepCommunicationOutbox(options) {
+	const { 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;
+}
+/** Wrap a communication router so every delivery is durably enqueued before it is attempted. */
+function createOutboxCommunicationRouter(options) {
+	const { 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
+export { createOutboxCommunicationRouter, sweepCommunicationOutbox };
+
+//# sourceMappingURL=outbox.mjs.map

package/dist/connectors/outbox.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox.mjs","names":[],"sources":["../../src/connectors/outbox.ts"],"sourcesContent":["import type { OutboxId } from \"../schema/id\";\nimport type { FactoryStores } from \"../store/engine\";\nimport { redactedErrorMessage } from \"../errors\";\nimport type { CommunicationEvent, CommunicationRouter } from \"./index\";\n\n/** Store capability required for durable communication delivery. */\nexport type CommunicationOutboxStores = Pick<FactoryStores, \"outbox\">;\n\n/** Counts delivered, rescheduled, and no-longer-claimable messages from an outbox sweep. */\nexport interface OutboxSweepResult {\n  delivered: number;\n  retried: number;\n  skipped: number;\n}\n\n/** Configures outbox claim duration, batch size, and retry scheduling. */\nexport interface OutboxDeliveryOptions {\n  readonly leaseMs?: number;\n  readonly limit?: number;\n  readonly retryDelayMs?: (attempt: number) => number;\n}\n\n/** Stores, router, and delivery bounds supplied to one outbox sweep. */\nexport interface SweepCommunicationOutboxOptions extends OutboxDeliveryOptions {\n  readonly stores: CommunicationOutboxStores;\n  readonly router: CommunicationRouter;\n}\n\n/** Stores, router, and delivery bounds used to construct a durable router. */\nexport interface CreateOutboxCommunicationRouterOptions extends OutboxDeliveryOptions {\n  readonly stores: CommunicationOutboxStores;\n  readonly router: CommunicationRouter;\n}\n\nconst defaultRetryDelayMs = (attempt: number) =>\n  Math.min(60_000 * 2 ** Math.max(0, attempt - 1), 60 * 60_000);\n\nasync function deliverOne(\n  stores: CommunicationOutboxStores,\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(claimed.id, {\n      attempt: claimed.attempt,\n      reason: redactedErrorMessage(error, [], \"Unknown communication delivery error\"),\n      delayMs: delay,\n    });\n    return retried === null ? \"skipped\" : \"retried\";\n  }\n}\n\n/** Deliver one bounded batch of pending communication events with durable retry state. */\nexport async function sweepCommunicationOutbox(\n  options: SweepCommunicationOutboxOptions,\n): Promise<OutboxSweepResult> {\n  const { stores, router } = options;\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\n/** Wrap a communication router so every delivery is durably enqueued before it is attempted. */\nexport function createOutboxCommunicationRouter(\n  options: CreateOutboxCommunicationRouterOptions,\n): CommunicationRouter {\n  const { stores, router } = options;\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"],"mappings":";;AAkCA,MAAM,uBAAuB,YAC3B,KAAK,IAAI,MAAS,KAAK,KAAK,IAAI,GAAG,UAAU,CAAC,GAAG,IAAW;AAE9D,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;EAM3E,OAAO,MALe,OAAO,OAAO,MAAM,QAAQ,IAAI;GACpD,SAAS,QAAQ;GACjB,QAAQ,qBAAqB,OAAO,CAAC,GAAG,sCAAsC;GAC9E,SAAS;EACX,CAAC,MACkB,OAAO,YAAY;CACxC;AACF;;AAGA,eAAsB,yBACpB,SAC4B;CAC5B,MAAM,EAAE,QAAQ,WAAW;CAC3B,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;;AAGA,SAAgB,gCACd,SACqB;CACrB,MAAM,EAAE,QAAQ,WAAW;CAC3B,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"}

package/dist/connectors/slack-approval-blocks.mjs

@@ -0,0 +1,136 @@
+//#region src/connectors/slack-approval-blocks.ts
+const slackApprovalPrefix = "factory_approval:";
+const slackRejectionCallback = "factory_approval_reject";
+const slackReasonBlock = "reason";
+const slackReasonAction = "reason_text";
+function escape(text) {
+	return text.replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;");
+}
+function plain(text) {
+	return {
+		type: "plain_text",
+		text: text.slice(0, 2900)
+	};
+}
+function section(text) {
+	return {
+		type: "section",
+		text: {
+			type: "mrkdwn",
+			text: text.slice(0, 2900)
+		}
+	};
+}
+function context(text) {
+	return {
+		type: "context",
+		elements: [{
+			type: "mrkdwn",
+			text: text.slice(0, 2900)
+		}]
+	};
+}
+function button(action, text, id, style) {
+	return {
+		type: "button",
+		action_id: `${slackApprovalPrefix}${action}`,
+		text: plain(text),
+		value: id,
+		...style ? { style } : {}
+	};
+}
+function actor(value) {
+	const user = /^slack:T[A-Z0-9]+:([UW][A-Z0-9]+)$/u.exec(value ?? "")?.[1];
+	return user ? `<@${user}>` : escape(value ?? "an operator");
+}
+function title(view) {
+	return view.finding?.title ?? `${view.task.kind.replaceAll("_", " ")} proposal`;
+}
+function slackApprovalMessage(view) {
+	const { task, finding, decision } = view;
+	const pending = task.approval === "required" && task.state === "queued";
+	const blocks = [
+		context([finding?.priority, ...view.repositories].filter(Boolean).map((text) => escape(text)).join(" · ")),
+		section(`*${escape(title(view))}*`),
+		section(escape(finding?.body ?? "Inspect the task and its origin before deciding."))
+	];
+	if (finding) blocks.push(section(`*Evidence · ${escape(finding.verification.level)}*\n${escape(finding.verification.summary)}`));
+	if (pending && !decision) {
+		blocks.push(context("This task requires operator approval before work can start."));
+		blocks.push({
+			type: "actions",
+			elements: [
+				button("approve", "Approve work", task.id, "primary"),
+				button("reject", "Reject…", task.id),
+				button("evidence", "View evidence", task.id)
+			]
+		});
+		blocks.push(context("Grants permission to start. Budget and dependency checks still apply."));
+	} else if (pending && decision) {
+		blocks.push(context(`Decision saved by ${actor(decision.decidedBy)}. Its task update still needs to finish.`));
+		blocks.push({
+			type: "actions",
+			elements: [button("retry", "Finish recorded decision", task.id, "primary"), button("evidence", "View evidence", task.id)]
+		});
+	} else {
+		const state = decision?.state === "approved" ? `Approved by ${actor(decision.decidedBy)} · ${task.state === "queued" ? "queued for execution" : escape(task.state.replaceAll("_", " "))}` : decision?.state === "rejected" ? `Rejected by ${actor(decision.decidedBy)} · task cancelled` : `Task ${escape(task.state.replaceAll("_", " "))}`;
+		blocks.push(context(state));
+		if (decision?.reason) blocks.push(section(escape(decision.reason)));
+		blocks.push({
+			type: "actions",
+			elements: [button("evidence", "View evidence", task.id), ...decision ? [button("decision", "View decision", task.id)] : []]
+		});
+	}
+	return {
+		text: escape(`${title(view)} · ${decision?.state ?? (pending ? "Awaiting approval" : task.state)}`),
+		blocks
+	};
+}
+function slackApprovalModal(view, kind, metadata) {
+	const { finding, decision } = view;
+	const blocks = [section(`*${escape(title(view))}*`)];
+	if (kind === "reject") {
+		blocks.push(section("Factory will cancel this task. Your reason will be visible with the decision."));
+		blocks.push({
+			type: "input",
+			block_id: slackReasonBlock,
+			label: plain("Reason"),
+			element: {
+				type: "plain_text_input",
+				action_id: slackReasonAction,
+				multiline: true,
+				min_length: 1,
+				max_length: 2e3,
+				...decision?.state === "rejected" && decision.reason ? { initial_value: decision.reason } : {},
+				placeholder: plain("Why should this work not proceed?")
+			}
+		});
+	} else if (kind === "decision" && decision) {
+		blocks.push(section(`${decision.state === "approved" ? "Approved" : "Rejected"} by ${actor(decision.decidedBy)}`));
+		if (decision.reason) blocks.push(section(escape(decision.reason)));
+		blocks.push(context(`${escape(decision.recordedAt)} · ${escape(decision.receiptId)}`));
+	} else {
+		blocks.push(section(escape(finding?.body ?? "No finding is attached to this task.")));
+		if (finding) {
+			blocks.push(section(`*Evidence · ${escape(finding.verification.level)}*\n${escape(finding.verification.summary)}`));
+			if (finding.path) blocks.push(context(`Location: ${escape(finding.path)}${finding.line ? `:${finding.line}` : ""}`));
+			if (finding.verification.limitations) blocks.push(section(`*Limitations*\n${escape(finding.verification.limitations)}`));
+		}
+		blocks.push(context(`Task: ${escape(view.task.id)}`));
+	}
+	return {
+		type: "modal",
+		title: plain(kind === "reject" ? "Reject proposed work" : kind === "decision" ? "Recorded decision" : "Proposal evidence"),
+		close: plain(kind === "reject" ? "Cancel" : "Done"),
+		blocks,
+		...kind === "reject" ? {
+			callback_id: slackRejectionCallback,
+			private_metadata: metadata,
+			submit: plain("Reject work")
+		} : {}
+	};
+}
+//#endregion
+export { slackApprovalMessage, slackApprovalModal, slackApprovalPrefix, slackReasonAction, slackReasonBlock, slackRejectionCallback };
+
+//# sourceMappingURL=slack-approval-blocks.mjs.map

package/dist/connectors/slack-approval-blocks.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"slack-approval-blocks.mjs","names":[],"sources":["../../src/connectors/slack-approval-blocks.ts"],"sourcesContent":["import type { ApprovalView } from \"../approval-contracts\";\n\nexport const slackApprovalPrefix = \"factory_approval:\";\nexport const slackRejectionCallback = \"factory_approval_reject\";\nexport const slackReasonBlock = \"reason\";\nexport const slackReasonAction = \"reason_text\";\n\nfunction escape(text: string) {\n  return text.replaceAll(\"&\", \"&amp;\").replaceAll(\"<\", \"&lt;\").replaceAll(\">\", \"&gt;\");\n}\nfunction plain(text: string) {\n  return { type: \"plain_text\", text: text.slice(0, 2900) };\n}\nfunction section(text: string) {\n  return { type: \"section\", text: { type: \"mrkdwn\", text: text.slice(0, 2900) } };\n}\nfunction context(text: string) {\n  return { type: \"context\", elements: [{ type: \"mrkdwn\", text: text.slice(0, 2900) }] };\n}\nfunction button(action: string, text: string, id: string, style?: \"primary\" | \"danger\") {\n  return {\n    type: \"button\",\n    action_id: `${slackApprovalPrefix}${action}`,\n    text: plain(text),\n    value: id,\n    ...(style ? { style } : {}),\n  };\n}\nfunction actor(value: string | undefined) {\n  const user = /^slack:T[A-Z0-9]+:([UW][A-Z0-9]+)$/u.exec(value ?? \"\")?.[1];\n  return user ? `<@${user}>` : escape(value ?? \"an operator\");\n}\nfunction title(view: ApprovalView) {\n  return view.finding?.title ?? `${view.task.kind.replaceAll(\"_\", \" \")} proposal`;\n}\n\nexport function slackApprovalMessage(view: ApprovalView) {\n  const { task, finding, decision } = view;\n  const pending = task.approval === \"required\" && task.state === \"queued\";\n  const blocks: Record<string, unknown>[] = [\n    context(\n      [finding?.priority, ...view.repositories]\n        .filter(Boolean)\n        .map((text) => escape(text!))\n        .join(\" · \"),\n    ),\n    section(`*${escape(title(view))}*`),\n    section(escape(finding?.body ?? \"Inspect the task and its origin before deciding.\")),\n  ];\n  if (finding)\n    blocks.push(\n      section(\n        `*Evidence · ${escape(finding.verification.level)}*\\n${escape(finding.verification.summary)}`,\n      ),\n    );\n  if (pending && !decision) {\n    blocks.push(context(\"This task requires operator approval before work can start.\"));\n    blocks.push({\n      type: \"actions\",\n      elements: [\n        button(\"approve\", \"Approve work\", task.id, \"primary\"),\n        button(\"reject\", \"Reject…\", task.id),\n        button(\"evidence\", \"View evidence\", task.id),\n      ],\n    });\n    blocks.push(context(\"Grants permission to start. Budget and dependency checks still apply.\"));\n  } else if (pending && decision) {\n    blocks.push(\n      context(\n        `Decision saved by ${actor(decision.decidedBy)}. Its task update still needs to finish.`,\n      ),\n    );\n    blocks.push({\n      type: \"actions\",\n      elements: [\n        button(\"retry\", \"Finish recorded decision\", task.id, \"primary\"),\n        button(\"evidence\", \"View evidence\", task.id),\n      ],\n    });\n  } else {\n    const state =\n      decision?.state === \"approved\"\n        ? `Approved by ${actor(decision.decidedBy)} · ${task.state === \"queued\" ? \"queued for execution\" : escape(task.state.replaceAll(\"_\", \" \"))}`\n        : decision?.state === \"rejected\"\n          ? `Rejected by ${actor(decision.decidedBy)} · task cancelled`\n          : `Task ${escape(task.state.replaceAll(\"_\", \" \"))}`;\n    blocks.push(context(state));\n    if (decision?.reason) blocks.push(section(escape(decision.reason)));\n    blocks.push({\n      type: \"actions\",\n      elements: [\n        button(\"evidence\", \"View evidence\", task.id),\n        ...(decision ? [button(\"decision\", \"View decision\", task.id)] : []),\n      ],\n    });\n  }\n  return {\n    text: escape(\n      `${title(view)} · ${decision?.state ?? (pending ? \"Awaiting approval\" : task.state)}`,\n    ),\n    blocks,\n  };\n}\n\nexport function slackApprovalModal(\n  view: ApprovalView,\n  kind: \"reject\" | \"evidence\" | \"decision\",\n  metadata: string,\n) {\n  const { finding, decision } = view;\n  const blocks: Record<string, unknown>[] = [section(`*${escape(title(view))}*`)];\n  if (kind === \"reject\") {\n    blocks.push(\n      section(\"Factory will cancel this task. Your reason will be visible with the decision.\"),\n    );\n    blocks.push({\n      type: \"input\",\n      block_id: slackReasonBlock,\n      label: plain(\"Reason\"),\n      element: {\n        type: \"plain_text_input\",\n        action_id: slackReasonAction,\n        multiline: true,\n        min_length: 1,\n        max_length: 2000,\n        ...(decision?.state === \"rejected\" && decision.reason\n          ? { initial_value: decision.reason }\n          : {}),\n        placeholder: plain(\"Why should this work not proceed?\"),\n      },\n    });\n  } else if (kind === \"decision\" && decision) {\n    blocks.push(\n      section(\n        `${decision.state === \"approved\" ? \"Approved\" : \"Rejected\"} by ${actor(decision.decidedBy)}`,\n      ),\n    );\n    if (decision.reason) blocks.push(section(escape(decision.reason)));\n    blocks.push(context(`${escape(decision.recordedAt)} · ${escape(decision.receiptId)}`));\n  } else {\n    blocks.push(section(escape(finding?.body ?? \"No finding is attached to this task.\")));\n    if (finding) {\n      blocks.push(\n        section(\n          `*Evidence · ${escape(finding.verification.level)}*\\n${escape(finding.verification.summary)}`,\n        ),\n      );\n      if (finding.path)\n        blocks.push(\n          context(`Location: ${escape(finding.path)}${finding.line ? `:${finding.line}` : \"\"}`),\n        );\n      if (finding.verification.limitations)\n        blocks.push(section(`*Limitations*\\n${escape(finding.verification.limitations)}`));\n    }\n    blocks.push(context(`Task: ${escape(view.task.id)}`));\n  }\n  return {\n    type: \"modal\",\n    title: plain(\n      kind === \"reject\"\n        ? \"Reject proposed work\"\n        : kind === \"decision\"\n          ? \"Recorded decision\"\n          : \"Proposal evidence\",\n    ),\n    close: plain(kind === \"reject\" ? \"Cancel\" : \"Done\"),\n    blocks,\n    ...(kind === \"reject\"\n      ? {\n          callback_id: slackRejectionCallback,\n          private_metadata: metadata,\n          submit: plain(\"Reject work\"),\n        }\n      : {}),\n  };\n}\n"],"mappings":"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"}

package/dist/connectors/slack-approvals.d.mts

@@ -0,0 +1,29 @@
+import { Task } from "../schema/task.mjs";
+import { CommunicationEvent } from "../schema/communication.mjs";
+import { FactoryStores } from "../store/engine.mjs";
+import { ApprovalAccessOptions, ApprovalAccessStores } from "../approval-access.mjs";
+//#region src/connectors/slack-approvals.d.ts
+/** Store capabilities required to present and decide Slack approvals. */
+type SlackApprovalsStores = ApprovalAccessStores & Pick<FactoryStores, "outbox" | "receipts">;
+/** Configures authenticated Slack presentation and handling for durable Task approvals. */
+interface SlackApprovalsOptions extends Omit<ApprovalAccessOptions, "stores"> {
+  readonly stores: SlackApprovalsStores;
+  /** Explicit fallback destination for work with no Slack reply thread. */
+  approvalChannel?: string;
+  request(operation: string, body: unknown): Promise<unknown>;
+  /** Authenticate the original request and body before accepting any interaction. */
+  verify(request: Request, body: string): Promise<void>;
+  reportError?(error: unknown): void;
+}
+/** Slack approval projection, interaction handler, and reconciliation operations. */
+interface SlackApprovals {
+  handle(request: Request, waitUntil: (task: Promise<unknown>) => void): Promise<Response | null>;
+  reconcile(tasks: readonly Task[]): Promise<number>;
+  deliver(event: CommunicationEvent): Promise<void>;
+  updatePresented(taskId: Task["id"]): Promise<boolean>;
+}
+/** Slack is a projection of the same Task decision used by HTTP clients. */
+declare function createSlackApprovals(options: SlackApprovalsOptions): SlackApprovals;
+//#endregion
+export { SlackApprovals, SlackApprovalsOptions, SlackApprovalsStores, createSlackApprovals };
+//# sourceMappingURL=slack-approvals.d.mts.map