@vercel/factory 0.0.6 → 0.0.9

package/README.md

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

package/dist/approval-DdvEKLiE.mjs

@@ -0,0 +1,132 @@
+import { p as vocabularySchema } from "./id-DwCihQr4.mjs";
+import { z } from "zod";
+import { createHash } from "node:crypto";
+//#region src/schema/finding.ts
+const findingPrioritySchema = z.enum([
+	"P0",
+	"P1",
+	"P2",
+	"P3"
+]).describe("Urgency of a finding: P0 is drop-everything, P3 is nice-to-have.");
+const findingCategorySchema = z.enum([
+	"security",
+	"correctness",
+	"reliability",
+	"performance",
+	"compatibility",
+	"accessibility",
+	"documentation",
+	"maintainability",
+	"testing",
+	"usability"
+]);
+const findingVerificationLevelSchema = z.enum([
+	"unverified",
+	"supported",
+	"confirmed"
+]).describe("How sure the reporter is: unverified = suspected from reading; supported = evidence points to it; confirmed = demonstrated.");
+const findingVerificationMethodSchema = z.enum([
+	"code_inspection",
+	"static_analysis",
+	"manual_reproduction",
+	"unit_test",
+	"integration_test",
+	"e2e_test",
+	"runtime_observation",
+	"documentation"
+]);
+/**
+* What was done to check the finding. Forces a reporter to distinguish "I
+* think this is a problem" from "I demonstrated it", which is the axis a human
+* approving fixes cares about most.
+*/
+const findingVerificationSchema = z.strictObject({
+	level: findingVerificationLevelSchema,
+	method: findingVerificationMethodSchema,
+	summary: z.string().min(1).max(2e3).describe("What was checked and what it showed."),
+	limitations: z.string().min(1).max(2e3).optional().describe("What could not be checked.")
+});
+/** A single problem found in a repository, as a scanner or agent reports it. */
+const findingSchema = z.strictObject({
+	title: z.string().min(1).max(200),
+	body: z.string().min(1).max(8e3).describe("The problem, its impact, and how to fix it. Markdown."),
+	path: z.string().min(1).max(500).optional().describe("Repository-relative file path."),
+	line: z.number().int().min(1).optional(),
+	endLine: z.number().int().min(1).optional(),
+	priority: findingPrioritySchema,
+	category: findingCategorySchema,
+	verification: findingVerificationSchema,
+	tool: z.string().min(1).max(100).optional().describe("Scanner that produced it, e.g. deepsec."),
+	ruleId: z.string().min(1).max(200).optional().describe("Scanner rule or check id, when there is one.")
+});
+/**
+* Stable identity of a finding across scans, used as the signal's delivery id
+* so re-reporting is a no-op instead of a second task. A scanner finding is
+* the same problem when the same tool reports the same rule on the same file;
+* its title is model-written prose and changes between runs, so it is left
+* out. Without a rule id the title is all there is, normalised.
+*/
+function findingFingerprint(repositoryId, finding) {
+	const parts = finding.tool !== void 0 && finding.ruleId !== void 0 && finding.path !== void 0 ? [
+		repositoryId,
+		finding.tool,
+		finding.ruleId,
+		finding.path
+	] : [
+		repositoryId,
+		finding.tool ?? "",
+		finding.ruleId ?? "",
+		finding.path ?? "",
+		finding.title.trim().toLowerCase().replaceAll(/\s+/gu, " ")
+	];
+	return createHash("sha256").update(parts.join(" ")).digest("hex").slice(0, 32);
+}
+//#endregion
+//#region src/approval.ts
+/**
+* One approval rule. Every listed field must match for the rule to apply;
+* absent fields match anything. Rules are evaluated first-match.
+*/
+const approvalRuleSchema = z.strictObject({
+	source: vocabularySchema.optional().describe("Signal source, e.g. security_scan or github_issue."),
+	kind: vocabularySchema.optional().describe("Task kind, e.g. code_change."),
+	priority: z.array(findingPrioritySchema).min(1).optional().describe("Finding priorities the rule applies to."),
+	require: z.boolean().describe("Whether matching tasks wait for a human before dispatch.")
+});
+const approvalPolicySchema = z.array(approvalRuleSchema).describe("First-match rules deciding which tasks need a human before they run.");
+/**
+* The default: fixes for security findings wait for a human; everything else
+* runs as it always has. Handoffs between agents (verification) never wait,
+* because a human already approved the work they continue.
+*/
+const defaultApprovalPolicy = [
+	{
+		kind: "verification",
+		require: false
+	},
+	{
+		source: "security_scan",
+		require: true
+	},
+	{ require: false }
+];
+/**
+* Decide at task-creation time whether a task needs approval. Pure: the answer
+* is stamped on the task and never re-evaluated, so a later policy change
+* cannot silently release work a human was expecting to see.
+*/
+function requiresApproval(policy, subject) {
+	for (const rule of policy) {
+		if (rule.source !== void 0 && rule.source !== subject.source) continue;
+		if (rule.kind !== void 0 && rule.kind !== subject.kind) continue;
+		if (rule.priority !== void 0) {
+			if (subject.priority === void 0 || !rule.priority.includes(subject.priority)) continue;
+		}
+		return rule.require;
+	}
+	return false;
+}
+//#endregion
+export { findingCategorySchema as a, findingSchema as c, findingVerificationSchema as d, requiresApproval as i, findingVerificationLevelSchema as l, approvalRuleSchema as n, findingFingerprint as o, defaultApprovalPolicy as r, findingPrioritySchema as s, approvalPolicySchema as t, findingVerificationMethodSchema as u };
+
+//# sourceMappingURL=approval-DdvEKLiE.mjs.map

package/dist/approval-DdvEKLiE.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"approval-DdvEKLiE.mjs","names":[],"sources":["../src/schema/finding.ts","../src/approval.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport { z } from \"zod\";\n\nexport const findingPrioritySchema = z\n  .enum([\"P0\", \"P1\", \"P2\", \"P3\"])\n  .describe(\"Urgency of a finding: P0 is drop-everything, P3 is nice-to-have.\");\n\nexport const findingCategorySchema = z.enum([\n  \"security\",\n  \"correctness\",\n  \"reliability\",\n  \"performance\",\n  \"compatibility\",\n  \"accessibility\",\n  \"documentation\",\n  \"maintainability\",\n  \"testing\",\n  \"usability\",\n]);\n\nexport const findingVerificationLevelSchema = z\n  .enum([\"unverified\", \"supported\", \"confirmed\"])\n  .describe(\n    \"How sure the reporter is: unverified = suspected from reading; supported = evidence points to it; confirmed = demonstrated.\",\n  );\n\nexport const findingVerificationMethodSchema = z.enum([\n  \"code_inspection\",\n  \"static_analysis\",\n  \"manual_reproduction\",\n  \"unit_test\",\n  \"integration_test\",\n  \"e2e_test\",\n  \"runtime_observation\",\n  \"documentation\",\n]);\n\n/**\n * What was done to check the finding. Forces a reporter to distinguish \"I\n * think this is a problem\" from \"I demonstrated it\", which is the axis a human\n * approving fixes cares about most.\n */\nexport const findingVerificationSchema = z.strictObject({\n  level: findingVerificationLevelSchema,\n  method: findingVerificationMethodSchema,\n  summary: z.string().min(1).max(2000).describe(\"What was checked and what it showed.\"),\n  limitations: z.string().min(1).max(2000).optional().describe(\"What could not be checked.\"),\n});\n\n/** A single problem found in a repository, as a scanner or agent reports it. */\nexport const findingSchema = z.strictObject({\n  title: z.string().min(1).max(200),\n  body: z.string().min(1).max(8000).describe(\"The problem, its impact, and how to fix it. Markdown.\"),\n  path: z.string().min(1).max(500).optional().describe(\"Repository-relative file path.\"),\n  line: z.number().int().min(1).optional(),\n  endLine: z.number().int().min(1).optional(),\n  priority: findingPrioritySchema,\n  category: findingCategorySchema,\n  verification: findingVerificationSchema,\n  tool: z.string().min(1).max(100).optional().describe(\"Scanner that produced it, e.g. deepsec.\"),\n  ruleId: z.string().min(1).max(200).optional().describe(\"Scanner rule or check id, when there is one.\"),\n});\n\nexport type FindingPriority = z.infer<typeof findingPrioritySchema>;\nexport type FindingCategory = z.infer<typeof findingCategorySchema>;\nexport type FindingVerification = z.infer<typeof findingVerificationSchema>;\nexport type Finding = z.infer<typeof findingSchema>;\n\n/**\n * Stable identity of a finding across scans, used as the signal's delivery id\n * so re-reporting is a no-op instead of a second task. A scanner finding is\n * the same problem when the same tool reports the same rule on the same file;\n * its title is model-written prose and changes between runs, so it is left\n * out. Without a rule id the title is all there is, normalised.\n */\nexport function findingFingerprint(repositoryId: string, finding: Finding): string {\n  const parts =\n    finding.tool !== undefined && finding.ruleId !== undefined && finding.path !== undefined\n      ? [repositoryId, finding.tool, finding.ruleId, finding.path]\n      : [\n          repositoryId,\n          finding.tool ?? \"\",\n          finding.ruleId ?? \"\",\n          finding.path ?? \"\",\n          finding.title.trim().toLowerCase().replaceAll(/\\s+/gu, \" \"),\n        ];\n  return createHash(\"sha256\").update(parts.join(\" \")).digest(\"hex\").slice(0, 32);\n}\n","import { z } from \"zod\";\nimport { vocabularySchema } from \"./schema/common\";\nimport { findingPrioritySchema, type FindingPriority } from \"./schema/finding\";\n\n/**\n * One approval rule. Every listed field must match for the rule to apply;\n * absent fields match anything. Rules are evaluated first-match.\n */\nexport const approvalRuleSchema = z.strictObject({\n  source: vocabularySchema.optional().describe(\"Signal source, e.g. security_scan or github_issue.\"),\n  kind: vocabularySchema.optional().describe(\"Task kind, e.g. code_change.\"),\n  priority: z\n    .array(findingPrioritySchema)\n    .min(1)\n    .optional()\n    .describe(\"Finding priorities the rule applies to.\"),\n  require: z.boolean().describe(\"Whether matching tasks wait for a human before dispatch.\"),\n});\n\nexport const approvalPolicySchema = z\n  .array(approvalRuleSchema)\n  .describe(\"First-match rules deciding which tasks need a human before they run.\");\n\nexport type ApprovalRule = z.infer<typeof approvalRuleSchema>;\nexport type ApprovalPolicy = z.infer<typeof approvalPolicySchema>;\n\n/**\n * The default: fixes for security findings wait for a human; everything else\n * runs as it always has. Handoffs between agents (verification) never wait,\n * because a human already approved the work they continue.\n */\nexport const defaultApprovalPolicy: ApprovalPolicy = [\n  { kind: \"verification\", require: false },\n  { source: \"security_scan\", require: true },\n  { require: false },\n];\n\nexport interface ApprovalSubject {\n  source?: string;\n  kind: string;\n  priority?: FindingPriority;\n}\n\n/**\n * Decide at task-creation time whether a task needs approval. Pure: the answer\n * is stamped on the task and never re-evaluated, so a later policy change\n * cannot silently release work a human was expecting to see.\n */\nexport function requiresApproval(policy: ApprovalPolicy, subject: ApprovalSubject): boolean {\n  for (const rule of policy) {\n    if (rule.source !== undefined && rule.source !== subject.source) continue;\n    if (rule.kind !== undefined && rule.kind !== subject.kind) continue;\n    if (rule.priority !== undefined) {\n      if (subject.priority === undefined || !rule.priority.includes(subject.priority)) continue;\n    }\n    return rule.require;\n  }\n  return false;\n}\n"],"mappings":"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"}

package/dist/build-factory.d.mts

@@ -0,0 +1,12 @@
+import { n as FactoryConfigInput } from "./factory-config-Bu4mklm9.mjs";
+import { EveNextConfig, EveNextConfigFunction, EveNextConfigInput } from "eve/next";
+//#region src/build-factory.d.ts
+interface FactoryArgs<TConfig extends EveNextConfig = EveNextConfig> {
+  factoryConfig: FactoryConfigInput;
+  nextConfig: EveNextConfigInput<TConfig>;
+  root?: string;
+}
+declare function buildFactory<TConfig extends EveNextConfig>({ factoryConfig, nextConfig, root }: FactoryArgs<TConfig>): EveNextConfigFunction<TConfig>;
+//#endregion
+export { FactoryArgs, buildFactory };
+//# sourceMappingURL=build-factory.d.mts.map

package/dist/build-factory.mjs

@@ -0,0 +1,16 @@
+import { t as defineFactory } from "./factory-config-ifd3JxiU.mjs";
+import { readdirSync } from "node:fs";
+import path from "node:path";
+//#region src/build-factory.ts
+function buildFactory({ factoryConfig, nextConfig, root = process.cwd() }) {
+	defineFactory(factoryConfig);
+	const agentDefinitions = Object.fromEntries(readdirSync(path.join(root, "agents"), { withFileTypes: true }).filter((entry) => entry.isDirectory()).map((entry) => [entry.name, path.join(root, "agents", entry.name)]));
+	return async (phase, context) => {
+		const { withEve } = await import("eve/next");
+		return withEve(nextConfig, { agents: agentDefinitions })(phase, context);
+	};
+}
+//#endregion
+export { buildFactory };
+
+//# sourceMappingURL=build-factory.mjs.map

package/dist/build-factory.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"build-factory.mjs","names":[],"sources":["../src/build-factory.ts"],"sourcesContent":["import { readdirSync } from \"node:fs\";\nimport path from \"node:path\";\nimport {\n  type EveNextConfig,\n  type EveNextConfigFunction,\n  type EveNextConfigInput,\n  type WithEveAgentsConfig,\n} from \"eve/next\";\nimport { defineFactory, type FactoryConfigInput } from \"./schema/factory-config\";\n\nexport interface FactoryArgs<TConfig extends EveNextConfig = EveNextConfig> {\n  factoryConfig: FactoryConfigInput;\n  nextConfig: EveNextConfigInput<TConfig>;\n  root?: string;\n}\n\nexport function buildFactory<TConfig extends EveNextConfig>({\n  factoryConfig,\n  nextConfig,\n  root = process.cwd(),\n}: FactoryArgs<TConfig>): EveNextConfigFunction<TConfig> {\n  defineFactory(factoryConfig);\n  const agentDefinitions: WithEveAgentsConfig = Object.fromEntries(\n    readdirSync(path.join(root, \"agents\"), { withFileTypes: true })\n      .filter((entry) => entry.isDirectory())\n      .map((entry) => [entry.name, path.join(root, \"agents\", entry.name)]),\n  );\n  return async (phase, context) => {\n    const { withEve } = await import(\"eve/next\");\n    return withEve(nextConfig, { agents: agentDefinitions })(phase, context);\n  };\n}\n"],"mappings":";;;;AAgBA,SAAgB,aAA4C,EAC1D,eACA,YACA,OAAO,QAAQ,IAAI,KACoC;CACvD,cAAc,aAAa;CAC3B,MAAM,mBAAwC,OAAO,YACnD,YAAY,KAAK,KAAK,MAAM,QAAQ,GAAG,EAAE,eAAe,KAAK,CAAC,CAAC,CAC5D,QAAQ,UAAU,MAAM,YAAY,CAAC,CAAC,CACtC,KAAK,UAAU,CAAC,MAAM,MAAM,KAAK,KAAK,MAAM,UAAU,MAAM,IAAI,CAAC,CAAC,CACvE;CACA,OAAO,OAAO,OAAO,YAAY;EAC/B,MAAM,EAAE,YAAY,MAAM,OAAO;EACjC,OAAO,QAAQ,YAAY,EAAE,QAAQ,iBAAiB,CAAC,CAAC,CAAC,OAAO,OAAO;CACzE;AACF"}

package/dist/connectors/index.d.mts

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

package/dist/connectors/index.mjs

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

package/dist/connectors/index.mjs.map

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

package/dist/connectors/slack.d.mts

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

package/dist/connectors/slack.mjs

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

package/dist/connectors/slack.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"slack.mjs","names":[],"sources":["../../src/connectors/slack.ts"],"sourcesContent":["import type { NormalizedSignal } from \"./index\";\n\nexport interface SlackMessageEvent {\n  teamId: string;\n  channelId: string;\n  messageTs: string;\n  threadTs: string;\n  actorId: string;\n  text: string;\n  replyAddress: string;\n  repositorySlug: string;\n  payload: unknown;\n}\n\nexport interface SlackMessageSignal extends NormalizedSignal<\"slack\"> {\n  repositorySlug: string;\n  message: {\n    teamId: string;\n    channelId: string;\n    messageTs: string;\n    threadTs: string;\n    actorId: string;\n    text: string;\n  };\n}\n\n/** Normalize an Eve-verified Slack message after the caller resolves its repository. */\nexport function normalizeSlackMessage(event: SlackMessageEvent): SlackMessageSignal {\n  return {\n    source: \"slack\",\n    deliveryId: `${event.teamId}:${event.channelId}:${event.messageTs}`,\n    repositorySlug: event.repositorySlug.toLowerCase(),\n    replyTo: { channel: \"slack\", address: event.replyAddress },\n    message: {\n      teamId: event.teamId,\n      channelId: event.channelId,\n      messageTs: event.messageTs,\n      threadTs: event.threadTs,\n      actorId: event.actorId,\n      text: event.text,\n    },\n    payload: event.payload,\n  };\n}\n\nexport type SlackRepositorySelection =\n  | { status: \"selected\"; repositorySlug: string }\n  | { status: \"required\" }\n  | { status: \"ambiguous\"; repositorySlugs: readonly string[] };\n\n/**\n * Select the only configured repository, or require an explicit owner/name\n * when a Slack surface fronts more than one repository.\n */\nexport function selectSlackRepository(\n  text: string,\n  repositories: readonly string[],\n): SlackRepositorySelection {\n  const normalized = [...new Set(repositories.map((slug) => slug.toLowerCase()))];\n  if (normalized.length === 1) {\n    return { status: \"selected\", repositorySlug: normalized[0]! };\n  }\n\n  const matches = normalized.filter((slug) => {\n    const escaped = slug.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n    return new RegExp(`(^|[^a-z0-9._/-])${escaped}($|[^a-z0-9._/-])`, \"i\").test(text);\n  });\n  if (matches.length === 1) {\n    return { status: \"selected\", repositorySlug: matches[0]! };\n  }\n  if (matches.length > 1) {\n    return { status: \"ambiguous\", repositorySlugs: matches };\n  }\n  return { status: \"required\" };\n}\n"],"mappings":";;AA2BA,SAAgB,sBAAsB,OAA8C;CAClF,OAAO;EACL,QAAQ;EACR,YAAY,GAAG,MAAM,OAAO,GAAG,MAAM,UAAU,GAAG,MAAM;EACxD,gBAAgB,MAAM,eAAe,YAAY;EACjD,SAAS;GAAE,SAAS;GAAS,SAAS,MAAM;EAAa;EACzD,SAAS;GACP,QAAQ,MAAM;GACd,WAAW,MAAM;GACjB,WAAW,MAAM;GACjB,UAAU,MAAM;GAChB,SAAS,MAAM;GACf,MAAM,MAAM;EACd;EACA,SAAS,MAAM;CACjB;AACF;;;;;AAWA,SAAgB,sBACd,MACA,cAC0B;CAC1B,MAAM,aAAa,CAAC,GAAG,IAAI,IAAI,aAAa,KAAK,SAAS,KAAK,YAAY,CAAC,CAAC,CAAC;CAC9E,IAAI,WAAW,WAAW,GACxB,OAAO;EAAE,QAAQ;EAAY,gBAAgB,WAAW;CAAI;CAG9D,MAAM,UAAU,WAAW,QAAQ,SAAS;EAC1C,MAAM,UAAU,KAAK,QAAQ,uBAAuB,MAAM;EAC1D,OAAO,IAAI,OAAO,oBAAoB,QAAQ,oBAAoB,GAAG,CAAC,CAAC,KAAK,IAAI;CAClF,CAAC;CACD,IAAI,QAAQ,WAAW,GACrB,OAAO;EAAE,QAAQ;EAAY,gBAAgB,QAAQ;CAAI;CAE3D,IAAI,QAAQ,SAAS,GACnB,OAAO;EAAE,QAAQ;EAAa,iBAAiB;CAAQ;CAEzD,OAAO,EAAE,QAAQ,WAAW;AAC9B"}
+{"version":3,"file":"slack.mjs","names":[],"sources":["../../src/connectors/slack.ts"],"sourcesContent":["import { createHash } from \"node:crypto\";\nimport {\n  communicationEventSchema,\n  type CommunicationAdapter,\n  type CommunicationEvent,\n  type CommunicationOutcome,\n  type NormalizedSignal,\n} from \"./index\";\n\nconst slackOutcomeLabels: Record<CommunicationOutcome, string> = {\n  accepted: \"Request accepted\",\n  started: \"Work started\",\n  succeeded: \"Work completed\",\n  failed: \"Work failed\",\n  needs_human: \"Human action required\",\n  question: \"Question requires an answer\",\n  digest: \"Factory digest\",\n  rolled_back: \"Change rolled back\",\n  budget_warning: \"Factory budget warning\",\n  budget_exhausted: \"Factory budget exhausted\",\n  message: \"Factory update\",\n};\n\nconst slackDetailFields = [\"title\", \"message\", \"summary\", \"question\", \"requestedAction\", \"reason\", \"url\"] as const;\nconst slackListFields = [\"items\", \"options\"] as const;\nconst slackTextLimit = 12_000;\nconst slackOwnerOutcomes = new Set<CommunicationOutcome>([\n  \"digest\",\n  \"budget_warning\",\n  \"budget_exhausted\",\n]);\n\nexport interface SlackCommunicationDelivery {\n  eventId: string;\n  clientMessageId: string;\n  text: string;\n  target:\n    | { type: \"owner\" }\n    | { type: \"thread\"; channelId: string; threadTs: string };\n}\n\nexport interface SlackCommunicationAdapter extends CommunicationAdapter {\n  readonly channel: \"slack\";\n  render(event: CommunicationEvent): string;\n}\n\nexport interface SlackCommunicationAdapterOptions {\n  send(delivery: SlackCommunicationDelivery): Promise<void>;\n  render?: (event: CommunicationEvent) => string;\n}\n\nexport interface SlackReplyTarget {\n  channelId: string;\n  threadTs: string;\n}\n\n/** Parse Eve's Slack continuation token into its channel and thread target. */\nexport function parseSlackReplyAddress(address: string): SlackReplyTarget {\n  const separator = address.indexOf(\":\");\n  const channelId = address.slice(0, separator);\n  const threadTs = address.slice(separator + 1);\n  if (separator <= 0 || !/^[A-Z][A-Z0-9]+$/.test(channelId) || !/^\\d+\\.\\d+$/.test(threadTs)) {\n    throw new Error(`Invalid Slack reply address: ${address}.`);\n  }\n  return { channelId, threadTs };\n}\n\n/** Render a provider-neutral communication event as plain Slack text. */\nexport function renderSlackCommunicationEvent(input: CommunicationEvent): string {\n  const event = communicationEventSchema.parse(input);\n  const headline = slackOutcomeLabels[event.outcome];\n  const details = slackDetailFields.flatMap((field) => {\n    const value = event.data[field];\n    return typeof value === \"string\" && value.trim() !== \"\" ? [value.trim()] : [];\n  });\n  const lists = slackListFields.flatMap((field) => {\n    const value = event.data[field];\n    if (!Array.isArray(value)) return [];\n    return value.flatMap((item) =>\n      typeof item === \"string\" && item.trim() !== \"\" ? [`- ${item.trim()}`] : []\n    );\n  });\n  const text = [headline, ...new Set([...details, ...lists])].join(\"\\n\");\n  return text.length <= slackTextLimit ? text : `${text.slice(0, slackTextLimit - 1)}…`;\n}\n\nfunction slackClientMessageId(eventId: string): string {\n  const digest = createHash(\"sha256\").update(eventId).digest(\"hex\").slice(0, 32);\n  return [\n    digest.slice(0, 8),\n    digest.slice(8, 12),\n    digest.slice(12, 16),\n    digest.slice(16, 20),\n    digest.slice(20),\n  ].join(\"-\");\n}\n\n/** Bind Slack rendering and delivery to the channel-neutral communication contract. */\nexport function createSlackCommunicationAdapter(\n  options: SlackCommunicationAdapterOptions,\n): SlackCommunicationAdapter {\n  const render = options.render ?? renderSlackCommunicationEvent;\n  return Object.freeze({\n    channel: \"slack\" as const,\n    render,\n    async deliver(input: CommunicationEvent): Promise<void> {\n      const event = communicationEventSchema.parse(input);\n      if (event.replyTo.channel !== \"slack\") {\n        throw new Error(`Slack communication adapter cannot deliver to ${event.replyTo.channel}.`);\n      }\n      const target = slackOwnerOutcomes.has(event.outcome)\n        ? { type: \"owner\" as const }\n        : { type: \"thread\" as const, ...parseSlackReplyAddress(event.replyTo.address) };\n      await options.send({\n        eventId: event.eventId,\n        clientMessageId: slackClientMessageId(event.eventId),\n        text: render(event),\n        target,\n      });\n    },\n  });\n}\n\nexport interface SlackMessageEvent {\n  teamId: string;\n  channelId: string;\n  messageTs: string;\n  threadTs: string;\n  actorId: string;\n  text: string;\n  replyAddress: string;\n  repositorySlug: string;\n  payload: unknown;\n}\n\nexport interface SlackMessageSignal extends NormalizedSignal<\"slack\"> {\n  repositorySlug: string;\n  message: {\n    teamId: string;\n    channelId: string;\n    messageTs: string;\n    threadTs: string;\n    actorId: string;\n    text: string;\n  };\n}\n\n/** Normalize an Eve-verified Slack message after the caller resolves its repository. */\nexport function normalizeSlackMessage(event: SlackMessageEvent): SlackMessageSignal {\n  return {\n    source: \"slack\",\n    deliveryId: `${event.teamId}:${event.channelId}:${event.messageTs}`,\n    repositorySlug: event.repositorySlug.toLowerCase(),\n    replyTo: { channel: \"slack\", address: event.replyAddress },\n    message: {\n      teamId: event.teamId,\n      channelId: event.channelId,\n      messageTs: event.messageTs,\n      threadTs: event.threadTs,\n      actorId: event.actorId,\n      text: event.text,\n    },\n    payload: event.payload,\n  };\n}\n\nexport type SlackRepositorySelection =\n  | { status: \"selected\"; repositorySlug: string }\n  | { status: \"required\" }\n  | { status: \"ambiguous\"; repositorySlugs: readonly string[] };\n\n/**\n * Select the only configured repository, or require an explicit owner/name\n * when a Slack surface fronts more than one repository.\n */\nexport function selectSlackRepository(\n  text: string,\n  repositories: readonly string[],\n): SlackRepositorySelection {\n  const normalized = [...new Set(repositories.map((slug) => slug.toLowerCase()))];\n  if (normalized.length === 1) {\n    return { status: \"selected\", repositorySlug: normalized[0]! };\n  }\n\n  const matches = normalized.filter((slug) => {\n    const escaped = slug.replace(/[.*+?^${}()|[\\]\\\\]/g, \"\\\\$&\");\n    return new RegExp(`(^|[^a-z0-9._/-])${escaped}($|[^a-z0-9._/-])`, \"i\").test(text);\n  });\n  if (matches.length === 1) {\n    return { status: \"selected\", repositorySlug: matches[0]! };\n  }\n  if (matches.length > 1) {\n    return { status: \"ambiguous\", repositorySlugs: matches };\n  }\n  return { status: \"required\" };\n}\n"],"mappings":";;;AASA,MAAM,qBAA2D;CAC/D,UAAU;CACV,SAAS;CACT,WAAW;CACX,QAAQ;CACR,aAAa;CACb,UAAU;CACV,QAAQ;CACR,aAAa;CACb,gBAAgB;CAChB,kBAAkB;CAClB,SAAS;AACX;AAEA,MAAM,oBAAoB;CAAC;CAAS;CAAW;CAAW;CAAY;CAAmB;CAAU;AAAK;AACxG,MAAM,kBAAkB,CAAC,SAAS,SAAS;AAC3C,MAAM,iBAAiB;AACvB,MAAM,qCAAqB,IAAI,IAA0B;CACvD;CACA;CACA;AACF,CAAC;;AA2BD,SAAgB,uBAAuB,SAAmC;CACxE,MAAM,YAAY,QAAQ,QAAQ,GAAG;CACrC,MAAM,YAAY,QAAQ,MAAM,GAAG,SAAS;CAC5C,MAAM,WAAW,QAAQ,MAAM,YAAY,CAAC;CAC5C,IAAI,aAAa,KAAK,CAAC,mBAAmB,KAAK,SAAS,KAAK,CAAC,aAAa,KAAK,QAAQ,GACtF,MAAM,IAAI,MAAM,gCAAgC,QAAQ,EAAE;CAE5D,OAAO;EAAE;EAAW;CAAS;AAC/B;;AAGA,SAAgB,8BAA8B,OAAmC;CAC/E,MAAM,QAAQ,yBAAyB,MAAM,KAAK;CAClD,MAAM,WAAW,mBAAmB,MAAM;CAC1C,MAAM,UAAU,kBAAkB,SAAS,UAAU;EACnD,MAAM,QAAQ,MAAM,KAAK;EACzB,OAAO,OAAO,UAAU,YAAY,MAAM,KAAK,MAAM,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,CAAC;CAC9E,CAAC;CACD,MAAM,QAAQ,gBAAgB,SAAS,UAAU;EAC/C,MAAM,QAAQ,MAAM,KAAK;EACzB,IAAI,CAAC,MAAM,QAAQ,KAAK,GAAG,OAAO,CAAC;EACnC,OAAO,MAAM,SAAS,SACpB,OAAO,SAAS,YAAY,KAAK,KAAK,MAAM,KAAK,CAAC,KAAK,KAAK,KAAK,GAAG,IAAI,CAAC,CAC3E;CACF,CAAC;CACD,MAAM,OAAO,CAAC,UAAU,mBAAG,IAAI,IAAI,CAAC,GAAG,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI;CACrE,OAAO,KAAK,UAAU,iBAAiB,OAAO,GAAG,KAAK,MAAM,GAAG,KAAkB,EAAE;AACrF;AAEA,SAAS,qBAAqB,SAAyB;CACrD,MAAM,SAAS,WAAW,QAAQ,CAAC,CAAC,OAAO,OAAO,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,MAAM,GAAG,EAAE;CAC7E,OAAO;EACL,OAAO,MAAM,GAAG,CAAC;EACjB,OAAO,MAAM,GAAG,EAAE;EAClB,OAAO,MAAM,IAAI,EAAE;EACnB,OAAO,MAAM,IAAI,EAAE;EACnB,OAAO,MAAM,EAAE;CACjB,CAAC,CAAC,KAAK,GAAG;AACZ;;AAGA,SAAgB,gCACd,SAC2B;CAC3B,MAAM,SAAS,QAAQ,UAAU;CACjC,OAAO,OAAO,OAAO;EACnB,SAAS;EACT;EACA,MAAM,QAAQ,OAA0C;GACtD,MAAM,QAAQ,yBAAyB,MAAM,KAAK;GAClD,IAAI,MAAM,QAAQ,YAAY,SAC5B,MAAM,IAAI,MAAM,iDAAiD,MAAM,QAAQ,QAAQ,EAAE;GAE3F,MAAM,SAAS,mBAAmB,IAAI,MAAM,OAAO,IAC/C,EAAE,MAAM,QAAiB,IACzB;IAAE,MAAM;IAAmB,GAAG,uBAAuB,MAAM,QAAQ,OAAO;GAAE;GAChF,MAAM,QAAQ,KAAK;IACjB,SAAS,MAAM;IACf,iBAAiB,qBAAqB,MAAM,OAAO;IACnD,MAAM,OAAO,KAAK;IAClB;GACF,CAAC;EACH;CACF,CAAC;AACH;;AA2BA,SAAgB,sBAAsB,OAA8C;CAClF,OAAO;EACL,QAAQ;EACR,YAAY,GAAG,MAAM,OAAO,GAAG,MAAM,UAAU,GAAG,MAAM;EACxD,gBAAgB,MAAM,eAAe,YAAY;EACjD,SAAS;GAAE,SAAS;GAAS,SAAS,MAAM;EAAa;EACzD,SAAS;GACP,QAAQ,MAAM;GACd,WAAW,MAAM;GACjB,WAAW,MAAM;GACjB,UAAU,MAAM;GAChB,SAAS,MAAM;GACf,MAAM,MAAM;EACd;EACA,SAAS,MAAM;CACjB;AACF;;;;;AAWA,SAAgB,sBACd,MACA,cAC0B;CAC1B,MAAM,aAAa,CAAC,GAAG,IAAI,IAAI,aAAa,KAAK,SAAS,KAAK,YAAY,CAAC,CAAC,CAAC;CAC9E,IAAI,WAAW,WAAW,GACxB,OAAO;EAAE,QAAQ;EAAY,gBAAgB,WAAW;CAAI;CAG9D,MAAM,UAAU,WAAW,QAAQ,SAAS;EAC1C,MAAM,UAAU,KAAK,QAAQ,uBAAuB,MAAM;EAC1D,OAAO,IAAI,OAAO,oBAAoB,QAAQ,oBAAoB,GAAG,CAAC,CAAC,KAAK,IAAI;CAClF,CAAC;CACD,IAAI,QAAQ,WAAW,GACrB,OAAO;EAAE,QAAQ;EAAY,gBAAgB,QAAQ;CAAI;CAE3D,IAAI,QAAQ,SAAS,GACnB,OAAO;EAAE,QAAQ;EAAa,iBAAiB;CAAQ;CAEzD,OAAO,EAAE,QAAQ,WAAW;AAC9B"}

package/dist/eve/index.d.mts

@@ -1,5 +1,5 @@
 import { c as Finding, k as FactoryStores, t as ApprovalPolicy } from "../approval-MoiwGpkh.mjs";
-import { d as GitHubReviewComment } from "../github-lprHgbx7.mjs";
+import { d as GitHubReviewComment } from "../github-DMOypeIu.mjs";
 import { z } from "zod";
 //#region src/eve/fetch.d.ts
 /** The subset of the eve sandbox handle a credentialed git operation needs. */

package/dist/eve/index.mjs

@@ -1,5 +1,6 @@
 import { i as repositoryIdSchema, o as signalIdSchema, p as vocabularySchema, s as taskIdSchema, t as changeIdSchema } from "../id-DwCihQr4.mjs";
-import { S as findingFingerprint, b as requiresApproval, g as dispatchTask, p as levelSchema, s as taskQuestionSchema, u as changeEvidenceSchema, w as findingSchema, y as defaultApprovalPolicy } from "../task-BxTU3MJb.mjs";
+import { c as findingSchema, i as requiresApproval, o as findingFingerprint, r as defaultApprovalPolicy } from "../approval-DdvEKLiE.mjs";
+import { g as dispatchTask, p as levelSchema, s as taskQuestionSchema, u as changeEvidenceSchema } from "../task-DMHuvBI0.mjs";
 import { answerReviewComment, readPullRequestHead, readReviewComment } from "../github.mjs";
 import { z } from "zod";
 import { defineHook } from "eve/hooks";